includeDet

includeDet is a directive in template engines and build systems used to embed the contents of another file or resource into the current document or artifact, with deterministic resolution. It emphasizes reproducible output by incorporating a content-based identifier, typically a hash, that tracks the included resource. It ensures that changes in the included content trigger rebuilds and updates.

The primary purpose is to enable modular composition while preserving deterministic builds. Unlike a simple include, includeDet may attach metadata such as the source path, version, and a checksum. It supports options to control formatting, header wrapping, or whether to emit only the content body or also the surrounding details.

How it works: during rendering, the system locates the target file, reads its content, computes a hash, and injects the content into the current artifact. The included block can carry optional metadata and can participate in a dependency graph to detect cycles and ensure reproducibility. Some implementations support deterministic line endings and locale-insensitive processing.

Examples: includeDet("docs/overview.det"); includeDet("modules/util.det", { hash: true, detailLevel: 2 }); These examples show including a document with or without extra metadata; the second can enforce a content hash to aid caching.

Limitations: security risks from including untrusted paths, potential performance costs, and the need for consistent environments to guarantee reproducibility. In practice, includeDet is used alongside standard include or import mechanisms, with careful project conventions. See also include, import, and dependency-driven build practices.