Struct ResolveConfig 

pub struct ResolveConfig {
    pub root: PathBuf,
    pub max_depth: usize,
    pub max_total_includes: usize,
}

Configuration for the include resolution pass.

Fields

root: PathBuf

Directory all include paths resolve under. Any include that canonicalizes outside this root is a IncludeError::RootEscape.

Must be an absolute path. Lexical normalization treats . and .. against an empty buffer as no-ops; passing a relative or unnormalized root weakens the root-escape prefix check. Callers (CLI, LSP) should canonicalize the root before constructing ResolveConfig.

max_depth: usize

Maximum include depth. Default 8 (see ResolveConfig::DEFAULT_MAX_DEPTH). Hitting the limit is an error, not a silent truncation.

max_total_includes: usize

Maximum total number of lex.include annotations resolved across the whole tree (depth × breadth). Default 1000 (see ResolveConfig::DEFAULT_MAX_TOTAL_INCLUDES).

Caps fan-out: max_depth alone bounds chain length but not breadth. A document with 100 thousand top-level includes at depth 1 sits inside max_depth but can still OOM the resolver / LSP / CI. Hitting this limit is an error, not a silent truncation.

Implementations

impl ResolveConfig

pub const DEFAULT_MAX_DEPTH: usize = 8

Default maximum include depth — enough for any reasonable atomization strategy (aggregator → per-chapter → per-section), bounded enough to keep the resolver’s worst-case work predictable.

pub const DEFAULT_MAX_TOTAL_INCLUDES: usize = 1000

Default maximum total include count (DoS bound). Generous enough for a book-length document with thousands of small fragments, tight enough to contain adversarial fan-out within a few seconds of resolver work.

pub fn with_root(root: PathBuf) -> Self

Construct a config with the given root and default limits.

Trait Implementations

impl Clone for ResolveConfig

fn clone(&self) -> ResolveConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolveConfig

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

Formats the value using the given formatter.