Struct IncludesConfig 

pub struct IncludesConfig {
    pub root: Option<String>,
    pub max_depth: usize,
    pub max_total_includes: usize,
    pub max_file_size: u64,
}

Include-resolution options consumed by lexd convert, lexd inspect, and the LSP. lexd format never expands includes regardless.

Fields

root: Option<String>

Resolution root for include path resolution.

All include paths — relative or root-absolute (/...) — must lexically normalize inside this directory. Outside-the-root paths fail with a RootEscape error. (The resolver does not call std::fs::canonicalize; symlink-aware canonicalization is the loader’s responsibility, not the resolver’s.)

When None (default), the CLI discovers the root by walking up from the entry-point document to find the nearest .lex.toml, falling back to the entry-point’s own directory.

max_depth: usize

Maximum include depth. Default 8. Hitting the limit is an error, not a silent truncation.

max_total_includes: usize

Maximum total include count across the document (DoS bound). Default 1000. Caps fan-out — max_depth alone bounds chain length but a doc with thousands of includes at depth 1 still blows past it.

max_file_size: u64

Maximum size of any single included file in bytes (DoS bound). Default 10 MiB (10485760). Files larger than this are rejected before any bytes hit memory. Used by FsLoader; the in-memory MemoryLoader doesn’t enforce a size limit.

Trait Implementations

impl Clone for IncludesConfig

fn clone(&self) -> IncludesConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IncludesConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IncludesConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Schema for IncludesConfig

const STATIC: &'static SchemaStatic

The macro-emitted const schema tree. Const so it composes inside nested static SchemaStatic = ... initializers.

fn schema() -> &'static Schema

Cached runtime view. The macro emits this method explicitly with a per-impl OnceLock; the helper cached_runtime_schema keeps the generated body small.

fn schema_arc() -> Arc<Schema>

Arc-flavored access to the same cached runtime view. Used by the macro-driven builder (crate::SchemaConfigBuilder) to avoid cloning the schema tree per builder construction — the runtime spec stores an Arc<Schema> and the cache hands out cheap reference-counted handles to it. Cost: one Arc::clone per call (atomic increment, no allocation).

fn schema_static() -> &'static SchemaStatic

Convenience accessor; equivalent to Self::STATIC.

fn field_paths() -> Vec<String>

Flat list of every dotted path the schema knows about: leaf addressable keys plus every nested-section and array-of-objects node. Lets consumer code (extension registries, doc generators, --list-keys flags) replace hand-maintained “known paths” constants — the macro recomputes the list every time a field is added or removed.

impl Serialize for IncludesConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.