@intentius/chant 0.6.0 → 0.8.0

package/dist/codegen/topo-sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-sort.d.ts","sourceRoot":"","sources":["../../src/codegen/topo-sort.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAAE,GAC9B,CAAC,EAAE,CA6BL"}

package/dist/codegen/typecheck.d.ts

@@ -0,0 +1,10 @@
+export interface TypeCheckResult {
+    ok: boolean;
+    diagnostics: string[];
+    fileCount: number;
+}
+/**
+ * Type-check a .d.ts content string by writing to a temp file and running tsc.
+ */
+export declare function typecheckDTS(content: string): Promise<TypeCheckResult>;
+//# sourceMappingURL=typecheck.d.ts.map

package/dist/codegen/typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.d.ts","sourceRoot":"","sources":["../../src/codegen/typecheck.ts"],"names":[],"mappings":"AAqDA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0E5E"}

package/dist/codegen/validate.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Generic validation framework for lexicon artifacts.
+ *
+ * Provides configurable validation checks that any lexicon can use
+ * by passing lexicon-specific configuration.
+ */
+import { type CoverageThresholds } from "./coverage.js";
+export interface ValidateCheck {
+    name: string;
+    ok: boolean;
+    error?: string;
+}
+export interface ValidateResult {
+    success: boolean;
+    checks: ValidateCheck[];
+}
+export interface LexiconValidationConfig {
+    /** Filename of the lexicon JSON (e.g. "lexicon-mydom.json") */
+    lexiconJsonFilename: string;
+    /** Required backward-compatible export names to check in lexicon JSON */
+    requiredNames: string[];
+    /**
+     * When true, a required name is satisfied if it appears as a substring of any
+     * lexicon JSON key (not only as an exact key). Lexicons that bound their
+     * generated type expansion (e.g. azure, #438) emit shared types under
+     * resource-prefixed/variant names, so the bare curated name is present only
+     * as a substring. Defaults to false (exact-key match).
+     */
+    requiredNamesMatchSubstring?: boolean;
+    /** Base path of the lexicon package */
+    basePath: string;
+    /** Path to the generated directory (defaults to basePath/src/generated) */
+    generatedDir?: string;
+    /** Coverage thresholds (optional) */
+    coverageThresholds?: CoverageThresholds;
+}
+/**
+ * Validate generated lexicon artifacts using the provided configuration.
+ */
+export declare function validateLexiconArtifacts(config: LexiconValidationConfig): Promise<ValidateResult>;
+/**
+ * Print validation results to stderr and throw on failure.
+ */
+export declare function printValidationResult(result: ValidateResult): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/codegen/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/codegen/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAoC,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;OAMG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4GvG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAWlE"}

package/dist/composite.d.ts

@@ -0,0 +1,116 @@
+import { type Declarable } from "./declarable.js";
+/**
+ * Marker symbol for Composite type identification.
+ */
+export declare const COMPOSITE_MARKER: unique symbol;
+/**
+ * A record of named Declarable members produced by a composite factory.
+ */
+export type CompositeMembers = Record<string, Declarable>;
+/**
+ * The result of instantiating a composite — contains the marker and expanded members.
+ */
+export interface CompositeInstance<M extends CompositeMembers = CompositeMembers> {
+    readonly [COMPOSITE_MARKER]: true;
+    readonly members: M;
+    readonly _definition: CompositeDefinition<any, M>;
+}
+/**
+ * A composite definition: a callable that produces a CompositeInstance.
+ */
+export interface CompositeDefinition<P, M extends CompositeMembers = CompositeMembers> {
+    (props: P): CompositeInstance<M> & M;
+    readonly compositeName: string;
+    readonly _id: symbol;
+}
+/**
+ * Type guard: is this value a CompositeInstance?
+ */
+export declare function isCompositeInstance(value: unknown): value is CompositeInstance;
+/**
+ * Global registry of composite definitions.
+ */
+export declare class CompositeRegistry {
+    private static definitions;
+    static register(definition: CompositeDefinition<unknown>): void;
+    static getAll(): CompositeDefinition<unknown>[];
+    static clear(): void;
+    static get size(): number;
+}
+/**
+ * Creates a composite definition from a factory closure.
+ *
+ * Usage:
+ * ```ts
+ * const SecureStorage = Composite<{ name: string }>((props) => {
+ *   const bucket = new Bucket({ bucketName: props.name });
+ *   const role = new Role({ policies: [{ resource: bucket.arn }] });
+ *   return { bucket, role };
+ * });
+ * export const storage = SecureStorage({ name: "data" });
+ * ```
+ */
+export declare function Composite<P, M extends CompositeMembers = CompositeMembers>(factory: (props: P) => M, name?: string): CompositeDefinition<P, M>;
+/**
+ * Expands a CompositeInstance into a flat Map of prefixed entity names to Declarables.
+ * Handles nested composites recursively.
+ */
+export declare function expandComposite(prefix: string, instance: CompositeInstance): Map<string, Declarable>;
+/**
+ * Type helpers for withDefaults.
+ */
+type PartialByDefault<P, D extends Partial<P>> = Omit<P, keyof D> & Partial<Pick<P, keyof D & keyof P>>;
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+};
+/**
+ * Wraps a CompositeDefinition with pre-applied default values.
+ * Props that have defaults become optional in the returned type.
+ *
+ * ```ts
+ * const SecureApi = withDefaults(LambdaApi, { runtime: "nodejs20.x", timeout: 10 });
+ * const api = SecureApi({ name: "myApi", code: "./dist" }); // runtime and timeout are optional
+ * ```
+ */
+export declare function withDefaults<P, M extends CompositeMembers, D extends Partial<P>>(definition: CompositeDefinition<P, M>, defaults: D | ((props: Partial<P>) => D)): CompositeDefinition<Simplify<PartialByDefault<P, D>>, M>;
+/**
+ * Symbol key for shared props attached by propagate().
+ */
+export declare const SHARED_PROPS: unique symbol;
+/**
+ * Attaches shared properties to a composite instance.
+ * During expandComposite(), shared props are merged into every member's props.
+ *
+ * Merge semantics:
+ * - Scalars: member-specific value wins
+ * - Arrays (e.g. tags): concatenate shared + member-specific
+ * - undefined values in shared props are stripped
+ *
+ * ```ts
+ * export const storage = propagate(
+ *   SecureStorage({ name: "data" }),
+ *   { tags: [{ key: "env", value: "prod" }] },
+ * );
+ * ```
+ */
+export declare function propagate<M extends CompositeMembers>(instance: CompositeInstance<M> & M, sharedProps: Record<string, unknown>): CompositeInstance<M> & M;
+/**
+ * Marker function for resource declarations within composites.
+ * At runtime, simply calls `new Type(props)` and returns the result.
+ * Exists so lint tooling can validate composite member construction (EVL005).
+ */
+export declare function resource<T extends Declarable, P>(Type: new (props: P, attributes?: Record<string, unknown>) => T, props: P, attributes?: Record<string, unknown>): T;
+/**
+ * Shallow-merges override values into a base props object.
+ *
+ * Merge semantics:
+ * - `undefined` values in overrides are skipped
+ * - Arrays: concatenated (base + overrides), matching `propagate()` semantics
+ * - Scalars / objects: override wins
+ *
+ * No deep merge — too dangerous with IaC props where nested objects
+ * (e.g. policy documents) should be replaced wholesale.
+ */
+export declare function mergeDefaults<T extends Record<string, unknown>>(base: T, overrides?: Partial<T>): T;
+export {};
+//# sourceMappingURL=composite.d.ts.map

package/dist/composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../src/composite.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import type { LintConfig } from "./lint/config.js";
+import type { OwnershipMarker } from "./ownership.js";
+/**
+ * Zod schema for ChantConfig validation.
+ */
+export declare const ChantConfigSchema: z.ZodObject<{
+    lexicons: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    environments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceDir: z.ZodOptional<z.ZodString>;
+    lint: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    ownership: z.ZodOptional<z.ZodObject<{
+        stack: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+/**
+ * Top-level chant project configuration.
+ *
+ * Loaded from `chant.config.ts` (preferred) or `chant.config.json`.
+ */
+export interface ChantConfig {
+    /** Lexicon package names to load (e.g. ["aws"]) */
+    lexicons?: string[];
+    /** Environment names (e.g. ["staging", "prod"]) */
+    environments?: string[];
+    /**
+     * Directory (relative to the project root) that holds the chant infrastructure
+     * source. Lifecycle commands (`snapshot`/`diff`/`plan`) build from here instead
+     * of the project root, so a mixed-layout project — chant `src/` alongside app
+     * code that has import side effects — can scope the build to just the infra.
+     * Defaults to "." (the project root). The `--src` flag overrides it.
+     */
+    sourceDir?: string;
+    /** Lint configuration (rules, extends, overrides, plugins) */
+    lint?: LintConfig;
+    /**
+     * Opt-in cloud-side ownership marking. When `stack` is set (and `enabled`
+     * is not false), the serializer stamps a chant ownership marker carrying
+     * this stack/env identity onto every supported resource. See {@link
+     * resolveOwnershipMarker}.
+     */
+    ownership?: {
+        /** Stack identity stamped onto resources (required to enable stamping). */
+        stack?: string;
+        /** Optional environment identity. */
+        env?: string;
+        /** Set false to disable stamping even when `stack` is present. */
+        enabled?: boolean;
+    };
+}
+/**
+ * Resolved project configuration with metadata about how it was loaded.
+ */
+export interface ResolvedConfig {
+    /** The loaded configuration */
+    config: ChantConfig;
+    /** Path to the config file that was loaded, or undefined if defaults */
+    configPath?: string;
+}
+/**
+ * Default configuration when no config file exists.
+ */
+export declare const DEFAULT_CHANT_CONFIG: ChantConfig;
+/**
+ * Load project configuration from a directory.
+ *
+ * Tries `chant.config.ts` first (via dynamic import), then `chant.config.json`.
+ * Returns default config if neither exists.
+ */
+export declare function loadChantConfig(dir: string): Promise<ResolvedConfig>;
+/**
+ * Resolve the ownership marker to stamp from project config, or undefined when
+ * ownership marking is off (no `stack`, or `enabled: false`).
+ */
+export declare function resolveOwnershipMarker(config: ChantConfig): OwnershipMarker | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;iBAUd,CAAC;AAEjB;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QACV,2EAA2E;QAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,qCAAqC;QACrC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,kEAAkE;QAClE,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,WAAW,CAAC;IAEpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAgB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS,CAIvF"}

package/dist/declarable.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Marker symbol for Declarable type identification
+ */
+export declare const DECLARABLE_MARKER: unique symbol;
+/**
+ * Base interface for all declarable entities
+ */
+export interface Declarable {
+    readonly lexicon: string;
+    readonly entityType: string;
+    readonly kind?: "resource" | "property" | "output";
+    readonly [DECLARABLE_MARKER]: true;
+}
+/**
+ * Core parameter type for lexicon-agnostic parameters
+ */
+export interface CoreParameter extends Declarable {
+    readonly parameterType: string;
+}
+/**
+ * Core output type for lexicon-agnostic outputs
+ */
+export interface CoreOutput extends Declarable {
+    readonly value: unknown;
+}
+/**
+ * Type guard to check if a value is a Declarable
+ */
+export declare function isDeclarable(value: unknown): value is Declarable;
+/**
+ * Type guard to check if a Declarable is a property-level type
+ */
+export declare function isPropertyDeclarable(value: Declarable): boolean;
+//# sourceMappingURL=declarable.d.ts.map

package/dist/declarable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarable.d.ts","sourceRoot":"","sources":["../src/declarable.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAAiC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IACnD,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAOhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE/D"}

package/dist/detectLexicon.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Detects which lexicons are being used by analyzing import statements
+ * in the provided infrastructure files. Matches any `@intentius/chant-lexicon-*` package.
+ *
+ * @param files - Array of file paths to analyze
+ * @returns Array of detected lexicon names
+ * @throws Error if no lexicon is detected
+ */
+export declare function detectLexicons(files: string[]): Promise<string[]>;
+//# sourceMappingURL=detectLexicon.d.ts.map

package/dist/detectLexicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectLexicon.d.ts","sourceRoot":"","sources":["../src/detectLexicon.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BvE"}

package/dist/discovery/cache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Discovery cache for incremental rebuilds.
+ *
+ * Tracks file mtimes and file→entity mappings so that only changed files
+ * need to be re-imported during watch-mode rebuilds.
+ */
+export declare class DiscoveryCache {
+    private files;
+    /**
+     * Check if a file has changed since it was last tracked.
+     * Returns true if the file is new or its mtime has changed.
+     */
+    hasFileChanged(filePath: string): boolean;
+    /**
+     * Record a successful import, storing the file's mtime and entity names.
+     */
+    trackFileImport(filePath: string, mtime: number, entityNames: string[]): void;
+    /**
+     * Invalidate cache entries for the given files.
+     * Returns the set of entity names that were invalidated.
+     */
+    invalidate(changedFiles: string[]): Set<string>;
+    /**
+     * Get all tracked file paths.
+     */
+    trackedFiles(): string[];
+    /**
+     * Get entity names for a tracked file.
+     */
+    getFileEntities(filePath: string): string[] | undefined;
+    /**
+     * Clear all cached data.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/discovery/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/discovery/cache.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAqC;IAElD;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAazC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IAI7E;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAgB/C;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAIvD;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/discovery/collect.d.ts

@@ -0,0 +1,17 @@
+import { type Declarable } from "../declarable.js";
+/**
+ * Collects all declarable entities from imported modules.
+ * CompositeInstance exports are expanded into individual entities
+ * with `{exportName}_{memberName}` naming.
+ * LexiconOutput exports are also collected so that build() can
+ * extract them and pass them to the serializer.
+ *
+ * @param modules - Array of module records with their exports
+ * @returns Map of export name to Declarable entity
+ * @throws {DiscoveryError} with type "resolution" if duplicate export names are found
+ */
+export declare function collectEntities(modules: Array<{
+    file: string;
+    exports: Record<string, unknown>;
+}>): Map<string, Declarable>;
+//# sourceMappingURL=collect.d.ts.map

package/dist/discovery/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/discovery/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAM9D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GACjE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAoEzB"}

package/dist/discovery/cycles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Cycle detection using DFS with three-color marking (white/gray/black).
+ *
+ * Accepts either `Map<string, Set<string>>` or `Record<string, string[]>` as input.
+ * Returns deduplicated cycles, each represented as an array of node IDs.
+ */
+type GraphInput = Map<string, Set<string>> | Record<string, string[]>;
+/**
+ * Detects cycles in a directed graph using DFS with three-color marking.
+ *
+ * @param graph - Adjacency list: node → neighbors. Accepts Map<string, Set<string>>
+ *   or Record<string, string[]>.
+ * @returns Array of deduplicated cycles. Each cycle is a node ID array
+ *   (e.g. ["A", "B", "C"]). Self-loops return ["A"].
+ */
+export declare function detectCycles(graph: GraphInput): string[][];
+/**
+ * Normalize a cycle for deduplication.
+ * Rotate to start with the lexicographically smallest node.
+ */
+export declare function normalizeCycleKey(cycle: string[]): string;
+export {};
+//# sourceMappingURL=cycles.d.ts.map

package/dist/discovery/cycles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycles.d.ts","sourceRoot":"","sources":["../../src/discovery/cycles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AActE;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,EAAE,CA4D1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAWzD"}

package/dist/discovery/files.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Recursively find all TypeScript infrastructure files in a directory
+ * @param path - The directory path to search
+ * @returns Array of file paths to .ts files (excluding test files)
+ */
+export declare function findInfraFiles(path: string): Promise<string[]>;
+//# sourceMappingURL=files.d.ts.map

package/dist/discovery/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/discovery/files.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmDpE"}

package/dist/discovery/graph.d.ts

@@ -0,0 +1,8 @@
+import type { Declarable } from "../declarable.js";
+/**
+ * Builds a dependency graph from a collection of entities
+ * @param entities - Map of export name to Declarable entity
+ * @returns Map of entity name to set of entity names it depends on
+ */
+export declare function buildDependencyGraph(entities: Map<string, Declarable>): Map<string, Set<string>>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/discovery/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/discovery/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAChC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAuB1B"}

package/dist/discovery/import.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dynamically import a module and return its exports.
+ *
+ * @param path - The file path to import
+ * @returns The module exports
+ * @throws {DiscoveryError} with type "import" if the import fails
+ */
+export declare function importModule(path: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=import.d.ts.map

package/dist/discovery/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/discovery/import.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAQlC"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,25 @@
+import type { Declarable } from "../declarable.js";
+import type { DiscoveryError } from "../errors.js";
+/**
+ * Result of the discovery process
+ */
+export interface DiscoveryResult {
+    /** Map of entity name to Declarable entity */
+    entities: Map<string, Declarable>;
+    /** Map of entity name to set of entity names it depends on */
+    dependencies: Map<string, Set<string>>;
+    /** Array of source file paths that were processed */
+    sourceFiles: string[];
+    /** Array of errors encountered during discovery */
+    errors: DiscoveryError[];
+}
+/**
+ * Discovers all declarable entities in a directory by scanning files,
+ * importing modules, collecting entities, resolving references, and building
+ * a dependency graph.
+ *
+ * @param path - The directory path to discover entities in
+ * @returns DiscoveryResult with entities, dependencies, sourceFiles, and errors
+ */
+export declare function discover(path: string): Promise<DiscoveryResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,8DAA8D;IAC9D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mDAAmD;IACnD,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqGrE"}

package/dist/discovery/resolve.d.ts

@@ -0,0 +1,10 @@
+import type { Declarable } from "../declarable.js";
+/**
+ * Resolves all AttrRef instances in a collection of entities
+ * Sets logical names on entities and resolves parent references in AttrRefs
+ *
+ * @param entities - Map of export name to Declarable entity
+ * @throws {Error} If an AttrRef parent cannot be found in the entities collection
+ */
+export declare function resolveAttrRefs(entities: Map<string, Declarable>): void;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/discovery/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/discovery/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI,CA0CvE"}

package/dist/errors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Error types for chant discovery, build, and lint failures
+ */
+export type DiscoveryErrorType = "import" | "resolution" | "circular";
+/**
+ * Error during file discovery or module import
+ */
+export declare class DiscoveryError extends Error {
+    readonly file: string;
+    readonly type: DiscoveryErrorType;
+    constructor(file: string, message: string, type: DiscoveryErrorType);
+    toJSON(): {
+        name: string;
+        file: string;
+        message: string;
+        type: DiscoveryErrorType;
+    };
+}
+/**
+ * Error during build/serialization
+ */
+export declare class BuildError extends Error {
+    readonly entityName: string;
+    constructor(entityName: string, message: string);
+    toJSON(): {
+        name: string;
+        entityName: string;
+        message: string;
+    };
+}
+/**
+ * Error from lint rule violation
+ */
+export declare class LintError extends Error {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+    readonly ruleId: string;
+    constructor(file: string, line: number, column: number, ruleId: string, message: string);
+    toJSON(): {
+        name: string;
+        file: string;
+        line: number;
+        column: number;
+        ruleId: string;
+        message: string;
+    };
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAEtE;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;gBAEtB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB;IAOnE,MAAM;;;;;;CAQP;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAM/C,MAAM;;;;;CAOP;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM;IAUjB,MAAM;;;;;;;;CAUP"}

package/dist/import/base-parser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Base class for template value parsers.
+ *
+ * Implements the generic recursive walk: null → array → single-key
+ * intrinsic dispatch → plain object → primitive. Subclasses provide
+ * format-specific intrinsic dispatch.
+ */
+export declare abstract class BaseValueParser {
+    /**
+     * Try to interpret a single-key object as an intrinsic function.
+     * Return the parsed intrinsic value, or null if this key isn't an intrinsic.
+     */
+    protected abstract dispatchIntrinsic(key: string, value: unknown, obj: Record<string, unknown>): unknown | null;
+    /**
+     * Parse a value recursively: null → array → single-key intrinsic → object → primitive.
+     */
+    parseValue(value: unknown): unknown;
+}
+//# sourceMappingURL=base-parser.d.ts.map

package/dist/import/base-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-parser.d.ts","sourceRoot":"","sources":["../../src/import/base-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8BAAsB,eAAe;IACnC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,GAAG,IAAI;IAEjB;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAyBpC"}

package/dist/import/generator.d.ts

@@ -0,0 +1,20 @@
+import type { TemplateIR } from "./parser.js";
+/**
+ * Represents a generated TypeScript file
+ */
+export interface GeneratedFile {
+    readonly path: string;
+    readonly content: string;
+}
+/**
+ * Interface for TypeScript code generators that convert IR to TypeScript
+ */
+export interface TypeScriptGenerator {
+    /**
+     * Generate TypeScript files from intermediate representation
+     * @param ir - Intermediate representation of the template
+     * @returns Array of generated TypeScript files
+     */
+    generate(ir: TemplateIR): GeneratedFile[];
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/import/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/import/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,aAAa,EAAE,CAAC;CAC3C"}

package/dist/import/ir-utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * IR intrinsic scanning utilities.
+ *
+ * Generic recursive walkers that scan the import IR value trees for
+ * intrinsic markers and dependency references.
+ */
+import type { TemplateIR } from "./parser.js";
+/**
+ * Check if a value tree contains an intrinsic with the given name.
+ * Looks for `{ __intrinsic: name }` objects recursively.
+ */
+export declare function hasIntrinsicInValue(value: unknown, name: string): boolean;
+/**
+ * Check if any resource in the IR uses a given intrinsic.
+ */
+export declare function irUsesIntrinsic(ir: TemplateIR, name: string): boolean;
+/**
+ * Collect dependency references from a value tree.
+ *
+ * @param value - The value tree to scan
+ * @param isDependency - Given an object, returns a logical ID if it represents
+ *   a dependency, or null otherwise. Each lexicon provides its own predicate.
+ */
+export declare function collectDependencies(value: unknown, isDependency: (obj: Record<string, unknown>) => string | null): Set<string>;
+//# sourceMappingURL=ir-utils.d.ts.map

package/dist/import/ir-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir-utils.d.ts","sourceRoot":"","sources":["../../src/import/ir-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,GAC5D,GAAG,CAAC,MAAM,CAAC,CAIb"}