@intentius/chant 0.7.0 → 0.8.0

package/dist/cli/mcp/tools/lint.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Lint tool definition for MCP
+ */
+export declare const lintTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            fix: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Handle lint tool invocation
+ */
+export declare function handleLint(params: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=lint.d.ts.map

package/dist/cli/mcp/tools/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/lint.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;CAiBpB,CAAC;AAEF;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBlF"}

package/dist/cli/mcp/tools/scaffold.d.ts

@@ -0,0 +1,31 @@
+import type { LexiconPlugin } from "../../../lexicon.js";
+/**
+ * Scaffold tool definition for MCP
+ */
+export declare const scaffoldTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            pattern: {
+                type: string;
+                description: string;
+            };
+            lexicon: {
+                type: string;
+                description: string;
+            };
+            template: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Create a scaffold handler with access to loaded plugins
+ */
+export declare function createScaffoldHandler(plugins: LexiconPlugin[]): (params: Record<string, unknown>) => Promise<unknown>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/cli/mcp/tools/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CAqBxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EAAE,GACvB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAoFvD"}

package/dist/cli/mcp/tools/search.d.ts

@@ -0,0 +1,31 @@
+import type { LexiconPlugin } from "../../../lexicon.js";
+/**
+ * Search tool definition for MCP
+ */
+export declare const searchTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            lexicon: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Create a search handler with access to loaded plugins
+ */
+export declare function createSearchHandler(plugins: LexiconPlugin[]): (params: Record<string, unknown>) => Promise<unknown>;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/mcp/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAqBtB,CAAC;AAQF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EAAE,GACvB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CA+DvD"}

package/dist/cli/mcp/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * MCP message types
+ */
+export interface McpRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface McpResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Tool definition for MCP
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * Resource definition for MCP
+ */
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType?: string;
+}
+export type ToolHandler = (params: Record<string, unknown>) => Promise<unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/cli/plugins.d.ts

@@ -0,0 +1,21 @@
+import { type LexiconPlugin } from "../lexicon.js";
+/**
+ * Load a single lexicon plugin by lexicon name.
+ *
+ * Dynamically imports `@intentius/chant-lexicon-{name}` and looks for a
+ * LexiconPlugin export. Falls back to wrapping a raw Serializer export.
+ */
+export declare function loadPlugin(lexiconName: string): Promise<LexiconPlugin>;
+/**
+ * Load plugins for all detected lexicon names.
+ * Calls `init()` on each plugin if present.
+ */
+export declare function loadPlugins(lexiconNames: string[]): Promise<LexiconPlugin[]>;
+/**
+ * Resolve lexicon names for a project directory.
+ *
+ * Reads `lexicons` from `chant.config.ts` / `chant.config.json` if present.
+ * Falls back to source-file detection via `detectLexicons()`.
+ */
+export declare function resolveProjectLexicons(projectPath: string): Promise<string[]>;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/cli/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/cli/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAKjE;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6B5E;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA6BlF;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnF"}

package/dist/cli/registry.d.ts

@@ -0,0 +1,100 @@
+import type { LexiconPlugin } from "../lexicon.js";
+import type { Serializer } from "../serializer.js";
+/**
+ * Parsed CLI arguments (output of parseArgs).
+ */
+export interface ParsedArgs {
+    command: string;
+    path: string;
+    extraPositional?: string;
+    extraPositional2?: string;
+    output?: string;
+    format: string;
+    force?: boolean;
+    fix: boolean;
+    lexicon?: string;
+    template?: string;
+    watch: boolean;
+    verbose: boolean;
+    help: boolean;
+    profile?: string;
+    report?: boolean;
+    /** `chant run` — force the local in-process executor (the default). */
+    local?: boolean;
+    /** `chant run` — run via a Temporal cluster instead of the local executor. */
+    temporal?: boolean;
+    /** `chant run` — emit the structured OpRunResult as JSON on stdout. */
+    json?: boolean;
+    live: boolean;
+    /** `chant migrate --from <name>` (default "github") */
+    migrateFrom?: string;
+    /** `chant migrate --to <name>` (default "gitlab") */
+    migrateTo?: string;
+    /** `chant migrate --emit yaml|ts` */
+    emit?: string;
+    /** Escalate needs-review diagnostics to errors (migrate command) */
+    strict?: boolean;
+    /** Run glci/glab after emit (migrate command) */
+    validate?: boolean;
+    /** Recognise composite patterns in output (migrate command) */
+    useComposites?: boolean;
+    /** Write SARIF report to this path (migrate command); distinct from boolean --report */
+    reportFile?: string;
+    /** `chant init --skill <name>` filter (added in #95 commit) */
+    skill?: string;
+    /** `chant import --type <ResourceType>` selector */
+    selectType?: string;
+    /** `chant import --name <name>` selector */
+    selectName?: string;
+    /** `chant import --owned` — restrict live import to chant-owned resources */
+    owned?: boolean;
+    /** `chant import --verbatim` — keep server-defaulted fields in live import */
+    verbatim?: boolean;
+    /** `chant lifecycle … --src <dir>` — build root override for lifecycle commands */
+    src?: string;
+    /** `chant build --env <name>` — environment for organizational policy evaluation */
+    env?: string;
+    /** `chant graph --stacks` — render the cross-stack apply-ordering graph */
+    stacks?: boolean;
+    /** `chant lifecycle affected --base <ref>` — base git ref to diff against */
+    base?: string;
+    /** `chant lifecycle affected --head <ref>` — head git ref (default: working tree) */
+    head?: string;
+    /** `chant lifecycle affected --include-dependents` — add downstream consumers */
+    includeDependents?: boolean;
+    /** `chant audit --tier merge-worthy|all` */
+    tier?: string;
+    /** `chant audit --fail-on merge-worthy|warning|none` */
+    failOn?: string;
+    /** `chant audit --theme <file>` — JSON theme knobs for the HTML report */
+    theme?: string;
+}
+/**
+ * Declarative command definition for the CLI registry.
+ */
+export interface CommandDef {
+    /** Primary command name, e.g. "build", "dev generate", "serve lsp" */
+    name: string;
+    /** If true, load lexicon plugins before calling handler */
+    requiresPlugins?: boolean;
+    /** Command handler — returns exit code */
+    handler: (ctx: CommandContext) => Promise<number>;
+}
+/**
+ * Context passed to each command handler.
+ */
+export interface CommandContext {
+    args: ParsedArgs;
+    plugins: LexiconPlugin[];
+    serializers: Serializer[];
+}
+/**
+ * Result of resolving a command from CLI args against the registry.
+ */
+export interface ResolvedCommand {
+    def: CommandDef;
+    /** True if this was matched as a compound command (args.path was consumed as subcommand) */
+    compound: boolean;
+}
+export declare function resolveCommand(args: ParsedArgs, registry: CommandDef[]): ResolvedCommand | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/registry.d.ts.map

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

package/dist/cli/reporters/stylish.d.ts

@@ -0,0 +1,26 @@
+import type { LintDiagnostic, LintRule } from "../../lint/rule.js";
+/**
+ * Format diagnostics in stylish format (similar to ESLint)
+ * Groups by file, shows severity, message, and rule ID
+ */
+export declare function formatStylish(diagnostics: LintDiagnostic[]): string;
+/**
+ * Format the summary line
+ */
+export declare function formatSummary(errorCount: number, warningCount: number): string;
+/**
+ * Format diagnostics as JSON
+ */
+export declare function formatJson(diagnostics: LintDiagnostic[]): string;
+/**
+ * Format diagnostics as SARIF (Static Analysis Results Interchange Format)
+ *
+ * @param diagnostics - Active (non-suppressed) diagnostics
+ * @param rules - Full list of loaded LintRules for rich metadata (optional)
+ * @param suppressed - Suppressed diagnostics with optional reason (optional)
+ * @param version - Tool version string (optional, defaults to "0.1.0")
+ */
+export declare function formatSarif(diagnostics: LintDiagnostic[], rules?: LintRule[], suppressed?: Array<LintDiagnostic & {
+    reason?: string;
+}>, version?: string): string;
+//# sourceMappingURL=stylish.d.ts.map

package/dist/cli/reporters/stylish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylish.d.ts","sourceRoot":"","sources":["../../../src/cli/reporters/stylish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAY,MAAM,iBAAiB,CAAC;AAgC1E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,CAyDnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAiB9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,CAEhE;AAkDD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,cAAc,EAAE,EAC7B,KAAK,CAAC,EAAE,QAAQ,EAAE,EAClB,UAAU,CAAC,EAAE,KAAK,CAAC,cAAc,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CA0CR"}

package/dist/cli/watch.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Watch options
+ */
+export interface WatchOptions {
+    /** Debounce delay in milliseconds (default: 300) */
+    debounceMs?: number;
+    /** File extensions to include (default: [".ts"]) */
+    extensions?: string[];
+    /** Directory names to ignore */
+    ignoreDirs?: string[];
+}
+/**
+ * Check if a file path should be watched
+ */
+export declare function shouldWatch(filePath: string, options: Required<WatchOptions>): boolean;
+/**
+ * Format a timestamp as HH:MM:SS
+ */
+export declare function formatTimestamp(date?: Date): string;
+/**
+ * Format changed files for display (relative paths, truncated if many)
+ */
+export declare function formatChangedFiles(files: string[], basePath: string, maxShow?: number): string;
+/**
+ * Watch a directory for file changes with debouncing.
+ * Returns a cleanup function to stop watching.
+ */
+export declare function watchDirectory(path: string, callback: (changedFiles: string[]) => void, options?: WatchOptions): () => void;
+//# sourceMappingURL=watch.d.ts.map

package/dist/cli/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAQD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAatF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAK/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,CASzF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,EAC1C,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,IAAI,CA6BZ"}

package/dist/codegen/bound-property-types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Bound the set of generated property-type interfaces a lexicon emits.
+ *
+ * Cloud provider schemas (ARM, CloudFormation, …) embed a named definition for
+ * every nested object. Fully expanding all of them per-resource produces huge
+ * `.d.ts` declarations (azure was ~273MB — see #438). This helper keeps only
+ * the property types reachable from a resource's top-level properties within a
+ * depth bound, plus a curated force-keep set; references that fall outside the
+ * kept set are rewritten to `Record<string, unknown>`. Enum references are
+ * preserved. The input property refs are mutated in place. (#438, #440)
+ */
+/** A reference carrying a TypeScript type string, mutated in place when loosened. */
+export interface BoundablePropertyRef {
+    tsType: string;
+}
+/** A generated property type (named interface) and its properties. */
+export interface BoundablePropertyType {
+    name: string;
+    specType: string;
+    properties: BoundablePropertyRef[];
+}
+export interface BoundPropertyTypeOptions {
+    /** Maximum nesting depth of emitted property-type interfaces. */
+    maxDepth: number;
+    /**
+     * Definition-name substrings to always keep regardless of reachability/depth
+     * (e.g. common nested shapes worth typing for authoring ergonomics). Matched
+     * by substring against each property type's `specType`.
+     */
+    curatedDefs?: Iterable<string>;
+}
+/**
+ * Filter `propertyTypes` to the bounded set and loosen out-of-set references.
+ * Mutates the `tsType` of `resourceProps` and retained property types; returns
+ * the retained property types.
+ */
+export declare function boundPropertyTypes<PT extends BoundablePropertyType>(shortName: string, resourceProps: BoundablePropertyRef[], propertyTypes: PT[], enumNames: Set<string>, options: BoundPropertyTypeOptions): PT[];
+//# sourceMappingURL=bound-property-types.d.ts.map

package/dist/codegen/bound-property-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound-property-types.d.ts","sourceRoot":"","sources":["../../src/codegen/bound-property-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAChC;AAYD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,qBAAqB,EACjE,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,oBAAoB,EAAE,EACrC,aAAa,EAAE,EAAE,EAAE,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,OAAO,EAAE,wBAAwB,GAChC,EAAE,EAAE,CAqDN"}

package/dist/codegen/coverage.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Coverage analysis for lexicon artifacts.
+ *
+ * Analyzes a generated lexicon JSON to measure coverage across dimensions:
+ * property constraints, lifecycle attributes, return attributes, and extension constraints.
+ */
+export interface ResourceCoverage {
+    name: string;
+    resourceType: string;
+    hasPropertyConstraints: boolean;
+    hasLifecycle: boolean;
+    hasAttrs: boolean;
+    hasConstraints: boolean;
+}
+export interface CoverageReport {
+    resourceCount: number;
+    propertyPct: number;
+    lifecyclePct: number;
+    attrPct: number;
+    constraintPct: number;
+    resources: ResourceCoverage[];
+}
+/**
+ * Compute coverage from lexicon JSON content.
+ */
+export declare function computeCoverage(lexiconJSON: string): CoverageReport;
+/**
+ * Overall coverage percentage (average of all dimensions).
+ */
+export declare function overallPct(report: CoverageReport): number;
+/**
+ * Format a human-readable coverage summary.
+ */
+export declare function formatSummary(report: CoverageReport): string;
+/**
+ * Threshold configuration for coverage enforcement.
+ */
+export interface CoverageThresholds {
+    minPropertyPct?: number;
+    minLifecyclePct?: number;
+    minAttrPct?: number;
+    minConstraintPct?: number;
+    minOverallPct?: number;
+}
+export interface ThresholdResult {
+    ok: boolean;
+    violations: string[];
+}
+/**
+ * Check coverage report against thresholds.
+ */
+export declare function checkThresholds(report: CoverageReport, thresholds: CoverageThresholds): ThresholdResult;
+/**
+ * Format verbose per-resource coverage details.
+ */
+export declare function formatVerbose(report: CoverageReport): string;
+//# sourceMappingURL=coverage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/codegen/coverage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CA+CnE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAS5D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,GAAG,eAAe,CAoBvG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAoB5D"}

package/dist/codegen/docs-file-markers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * File marker interpolation and MDX escaping utilities.
+ */
+/** Escape curly braces so MDX doesn't treat them as JSX expressions. */
+export declare function escapeMdx(text: string): string;
+/**
+ * Expand `{{file:path.ts}}` markers in content with fenced code blocks.
+ *
+ * Supported forms:
+ * - `{{file:path.ts}}` — full file
+ * - `{{file:path.ts:5-12}}` — lines 5–12 (1-based, inclusive)
+ * - `{{file:path.ts|title=custom.ts}}` — override the code block title
+ * - `{{file:path.ts:5-12|title=custom.ts}}` — both
+ */
+export declare function expandFileMarkers(content: string, examplesDir: string): string;
+//# sourceMappingURL=docs-file-markers.d.ts.map

package/dist/codegen/docs-file-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-file-markers.d.ts","sourceRoot":"","sources":["../../src/codegen/docs-file-markers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA+C9E"}

package/dist/codegen/docs-rule-scanning.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Rule scanning and rule page generation for lexicon documentation.
+ *
+ * Scans lint rule and post-synth check source files to extract metadata,
+ * and generates an MDX page listing them.
+ */
+import type { DocsConfig, RuleMeta } from "./docs-types.js";
+/**
+ * Scan lint rule and post-synth check source files to extract metadata.
+ * Uses regex to find id, severity, category, and description from source.
+ */
+export declare function scanRules(srcDir: string): RuleMeta[];
+export declare function generateRules(config: DocsConfig, rules: RuleMeta[]): string;
+//# sourceMappingURL=docs-rule-scanning.d.ts.map

package/dist/codegen/docs-rule-scanning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-rule-scanning.d.ts","sourceRoot":"","sources":["../../src/codegen/docs-rule-scanning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAUpD;AAoFD,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CA+C3E"}

package/dist/codegen/docs-rules.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Rule documentation auto-generation.
+ *
+ * Generates MDX pages from a RuleEntry registry:
+ * - A catalog page with all rules grouped by category
+ * - Per-rule detail pages with configuration examples and disable syntax
+ */
+import type { RuleEntry } from "../lint/rule-registry.js";
+/**
+ * Generate a rule catalog MDX page with all rules grouped by category.
+ */
+export declare function generateRuleCatalog(entries: RuleEntry[], displayName?: string): string;
+/**
+ * Generate a per-rule detail MDX page.
+ */
+export declare function generateRuleDetailPage(entry: RuleEntry): string;
+//# sourceMappingURL=docs-rules.d.ts.map

package/dist/codegen/docs-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-rules.d.ts","sourceRoot":"","sources":["../../src/codegen/docs-rules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,EAAE,EACpB,WAAW,SAAU,GACpB,MAAM,CAmDR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAwD/D"}

package/dist/codegen/docs-sections.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Section content generators for lexicon documentation pages.
+ *
+ * Each function produces a complete MDX page string with frontmatter.
+ */
+import type { DocsConfig, ManifestJSON, MetaEntry, RuleMeta } from "./docs-types.js";
+export declare function generateOverview(config: DocsConfig, manifest: ManifestJSON, resources: Map<string, MetaEntry>, properties: Map<string, MetaEntry>, serviceGroups: Map<string, Map<string, MetaEntry>>, rules: RuleMeta[]): string;
+export declare function generateIntrinsics(config: DocsConfig, manifest: ManifestJSON): string;
+export declare function generatePseudoParameters(config: DocsConfig, manifest: ManifestJSON): string;
+export declare function generateSerialization(config: DocsConfig): string;
+//# sourceMappingURL=docs-sections.d.ts.map

package/dist/codegen/docs-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-sections.d.ts","sourceRoot":"","sources":["../../src/codegen/docs-sections.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAElF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAClC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAClD,KAAK,EAAE,QAAQ,EAAE,GAChB,MAAM,CAiER;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,GACrB,MAAM,CAuBR;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,GACrB,MAAM,CAqBR;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAqBhE"}

package/dist/codegen/docs-sidebar.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Sidebar generation for Starlight docs sites.
+ */
+import type { DocsConfig, DocsResult } from "./docs-types.js";
+export declare function buildSidebar(config: DocsConfig, result: DocsResult): Array<Record<string, unknown>>;
+//# sourceMappingURL=docs-sidebar.d.ts.map

package/dist/codegen/docs-sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-sidebar.d.ts","sourceRoot":"","sources":["../../src/codegen/docs-sidebar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3D,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,GACjB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8ChC"}

package/dist/codegen/docs-types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Type definitions for the documentation pipeline.
+ */
+export interface DocsConfig {
+    /** Lexicon name (used for page titles and paths) */
+    name: string;
+    /** Display name (e.g. "AWS CloudFormation") */
+    displayName: string;
+    /** Short description of what this lexicon targets */
+    description: string;
+    /** Path to dist/ directory containing manifest.json and meta.json */
+    distDir: string;
+    /** Output directory for generated .mdx files */
+    outDir: string;
+    /** Lexicon-specific overview content (markdown) */
+    overview?: string;
+    /** Output format description (e.g. "CloudFormation JSON template") */
+    outputFormat?: string;
+    /** Custom service grouping from resource type (e.g. "AWS::S3::Bucket" → "S3") */
+    serviceFromType?: (resourceType: string) => string;
+    /** Custom sections to append to overview page */
+    extraSections?: Array<{
+        title: string;
+        content: string;
+    }>;
+    /** Standalone pages added to the sidebar after Overview */
+    extraPages?: Array<{
+        slug: string;
+        title: string;
+        description?: string;
+        content: string;
+        sidebar?: boolean;
+    }>;
+    /** Slugs of auto-generated pages to suppress (e.g. "pseudo-parameters") */
+    suppressPages?: string[];
+    /** Source directory for scanning rule files (defaults to srcDir sibling of distDir) */
+    srcDir?: string;
+    /** Base path for the generated Astro site (e.g. '/lexicons/aws/') */
+    basePath?: string;
+    /** Root directory for resolving {{file:...}} markers in extra page content */
+    examplesDir?: string;
+    /** Extra sidebar entries appended after extraPages (supports Starlight groups) */
+    sidebarExtra?: Array<Record<string, unknown>>;
+}
+export interface DocsResult {
+    pages: Map<string, string>;
+    stats: {
+        resources: number;
+        properties: number;
+        services: number;
+        rules: number;
+        intrinsics: number;
+    };
+}
+export interface ManifestJSON {
+    name: string;
+    version: string;
+    namespace?: string;
+    intrinsics?: Array<{
+        name: string;
+        description?: string;
+        outputKey?: string;
+        isTag?: boolean;
+    }>;
+    pseudoParameters?: Record<string, string>;
+}
+export interface MetaEntry {
+    resourceType: string;
+    kind: "resource" | "property";
+    lexicon: string;
+    attrs?: Record<string, string>;
+    propertyConstraints?: Record<string, unknown>;
+    createOnly?: string[];
+    writeOnly?: string[];
+    primaryIdentifier?: string[];
+}
+export interface RuleMeta {
+    id: string;
+    severity: string;
+    category: string;
+    description: string;
+    type: "lint" | "post-synth";
+}
+//# sourceMappingURL=docs-types.d.ts.map

package/dist/codegen/docs-types.d.ts.map

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