@principled/cairn 1.0.0-beta

package/dist/exporters/json-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-exporter.js","sourceRoot":"","sources":["../../src/exporters/json-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAsB,MAAM,WAAW,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAC/B,GAAG,GAAG,MAAM,CAAC;IACb,IAAI,GAAG,MAAM,CAAC;IACd,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEjD,MAAM,CAAC,OAAgB,EAAE,OAAuB;QAC9C,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,KAAK,CAAC;QAE9D,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE;oBACJ,GAAG,GAAG,CAAC,IAAI;oBACX,uDAAuD;oBACvD,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI;oBACnC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI;oBACnC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI;oBACzC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI;iBAC9B;gBACD,QAAQ,EAAE,GAAG,CAAC,cAAc,EAAE;qBAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC;qBAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACT,GAAG,CAAC,CAAC,IAAI;oBACT,SAAS,EAAE,CAAC,CAAC,YAAY;oBACzB,UAAU,EAAE,CAAC,CAAC,WAAW,EAAE;oBAC3B,YAAY,EAAE,CAAC,CAAC,aAAa,EAAE;iBAChC,CAAC,CAAC;aACN,CAAC,CAAC;YACH,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;YACvC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;SACxB,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/exporters/markdown-exporter.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { Catalog } from '../catalog/catalog.js';
+import { Exporter, type ExportOptions } from './base.js';
+/**
+ * Per-document Markdown exporter.
+ * Groups elements by document and category, rendering human-readable markdown.
+ */
+export declare class MarkdownExporter extends Exporter {
+    readonly key = "markdown";
+    readonly name = "Markdown";
+    readonly optionsSchema: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+    export(catalog: Catalog, options?: ExportOptions): string;
+}
+//# sourceMappingURL=markdown-exporter.d.ts.map

package/dist/exporters/markdown-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-exporter.d.ts","sourceRoot":"","sources":["../../src/exporters/markdown-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAEzD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,GAAG,cAAc;IAC1B,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,aAAa,gDAA2B;IAEjD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;CAgE1D"}

package/dist/exporters/markdown-exporter.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { Exporter } from './base.js';
+/**
+ * Per-document Markdown exporter.
+ * Groups elements by document and category, rendering human-readable markdown.
+ */
+export class MarkdownExporter extends Exporter {
+    key = 'markdown';
+    name = 'Markdown';
+    optionsSchema = z.object({}).optional();
+    export(catalog, options) {
+        const includeDeprecated = options?.includeDeprecated ?? false;
+        const sections = [];
+        for (const doc of catalog.documents) {
+            sections.push(`# ${doc.name}\n`);
+            for (const catName of catalog.registry.categoryNames) {
+                const catDef = catalog.registry.getByName(catName);
+                if (!catDef)
+                    continue;
+                const elements = doc.getElementsByCategory(catName)
+                    .filter(e => includeDeprecated || e.status !== 'deprecated');
+                if (elements.length === 0)
+                    continue;
+                const displayLabel = catDef.display_label ??
+                    catName.charAt(0).toUpperCase() + catName.slice(1) + 's';
+                sections.push(`## ${displayLabel}\n`);
+                for (const el of elements) {
+                    sections.push(`### ${el.id}: ${el.name}\n`);
+                    if (el.status !== 'active') {
+                        sections.push(`**Status:** ${el.status}\n`);
+                    }
+                    // Primary field
+                    const primaryField = catDef.primary_field ?? 'statement';
+                    const primaryValue = el.get(primaryField);
+                    if (primaryValue) {
+                        sections.push(`${String(primaryValue).trim()}\n`);
+                    }
+                    // Tags
+                    if (el.tags.length > 0) {
+                        sections.push(`**Tags:** ${el.tags.join(', ')}\n`);
+                    }
+                    // Maps to
+                    if (el.maps_to.length > 0) {
+                        sections.push(`**Maps to:** ${el.maps_to.join(', ')}\n`);
+                    }
+                    // Considered alternatives (for decisions)
+                    const considered = el.get('considered');
+                    if (considered && typeof considered === 'object') {
+                        sections.push(`**Considered alternatives:**\n`);
+                        for (const [altName, altDef] of Object.entries(considered)) {
+                            const displayName = altName
+                                .replace(/_/g, ' ')
+                                .replace(/\b\w/g, c => c.toUpperCase());
+                            const rationale = altDef?.rationale ?? '';
+                            sections.push(`- **${displayName}** — *${rationale}*`);
+                        }
+                        sections.push('');
+                    }
+                }
+            }
+        }
+        return sections.join('\n');
+    }
+}
+//# sourceMappingURL=markdown-exporter.js.map

package/dist/exporters/markdown-exporter.js.map

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

package/dist/exporters/registry.d.ts

@@ -0,0 +1,4 @@
+import type { Exporter } from './base.js';
+/** Built-in exporter registry */
+export declare function createExporterRegistry(): Map<string, Exporter>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/exporters/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAO1C,iCAAiC;AACjC,wBAAgB,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAc9D"}

package/dist/exporters/registry.js

@@ -0,0 +1,20 @@
+import { JsonExporter } from './json-exporter.js';
+import { CsvExporter } from './csv-exporter.js';
+import { MarkdownExporter } from './markdown-exporter.js';
+import { DotExporter } from './dot-exporter.js';
+import { SqliteExporter } from './sqlite-exporter.js';
+/** Built-in exporter registry */
+export function createExporterRegistry() {
+    const registry = new Map();
+    const exporters = [new JsonExporter(), new CsvExporter(), new MarkdownExporter()];
+    for (const exp of exporters) {
+        registry.set(exp.key, exp);
+    }
+    // Optional exporters (may require external dependencies)
+    const optionalExporters = [new DotExporter(), new SqliteExporter()];
+    for (const exp of optionalExporters) {
+        registry.set(exp.key, exp);
+    }
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/exporters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/exporters/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,iCAAiC;AACjC,MAAM,UAAU,sBAAsB;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,MAAM,SAAS,GAAG,CAAC,IAAI,YAAY,EAAE,EAAE,IAAI,WAAW,EAAE,EAAE,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAClF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,yDAAyD;IACzD,MAAM,iBAAiB,GAAG,CAAC,IAAI,WAAW,EAAE,EAAE,IAAI,cAAc,EAAE,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/exporters/sqlite-exporter.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { Catalog } from '../catalog/catalog.js';
+import { Exporter, type ExportOptions } from './base.js';
+export declare class SqliteExporter extends Exporter {
+    readonly key = "sqlite";
+    readonly name = "SQLite";
+    readonly optionsSchema: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+    export(_catalog: Catalog, _options?: ExportOptions): string;
+}
+//# sourceMappingURL=sqlite-exporter.d.ts.map

package/dist/exporters/sqlite-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-exporter.d.ts","sourceRoot":"","sources":["../../src/exporters/sqlite-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAEzD,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,GAAG,YAAY;IACxB,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,aAAa,gDAA2B;IAEjD,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM;CAa5D"}

package/dist/exporters/sqlite-exporter.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { Exporter } from './base.js';
+export class SqliteExporter extends Exporter {
+    key = 'sqlite';
+    name = 'SQLite';
+    optionsSchema = z.object({}).optional();
+    export(_catalog, _options) {
+        // Check for dependency
+        try {
+            require('better-sqlite3');
+        }
+        catch {
+            throw new Error('SQLite export requires the "better-sqlite3" package. ' +
+                'Install with: npm install better-sqlite3');
+        }
+        // Full implementation deferred — dependency not bundled by default (DEC-7.4)
+        throw new Error('SQLite export not yet fully implemented');
+    }
+}
+//# sourceMappingURL=sqlite-exporter.js.map

package/dist/exporters/sqlite-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-exporter.js","sourceRoot":"","sources":["../../src/exporters/sqlite-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAsB,MAAM,WAAW,CAAC;AAEzD,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACjC,GAAG,GAAG,QAAQ,CAAC;IACf,IAAI,GAAG,QAAQ,CAAC;IAChB,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEjD,MAAM,CAAC,QAAiB,EAAE,QAAwB;QAChD,uBAAuB;QACvB,IAAI,CAAC;YACH,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,uDAAuD;gBACrD,0CAA0C,CAC7C,CAAC;QACJ,CAAC;QACD,6EAA6E;QAC7E,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export declare const VERSION = "1.0.0";
+export { GVPError, SchemaError, InheritanceError, ConfigError, ValidationError, ProvenanceError, SourceResolutionError, CatalogError, DuplicateIdPrefixError, DuplicateYamlKeyError, InvalidMappingRuleRefError, CircularInheritanceError, MissingMappingRulesError } from './errors.js';
+export * from './schema/index.js';
+export * from './config/index.js';
+export * from './model/index.js';
+export * from './inheritance/index.js';
+export * from './catalog/index.js';
+export * from './validation/index.js';
+export * from './provenance/index.js';
+export * from './exporters/index.js';
+export * from './parsers/index.js';
+export * from './analysis/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACzR,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// GVP v1 - Goals, Values, and Principles framework
+export const VERSION = '1.0.0';
+export { GVPError, SchemaError, InheritanceError, ConfigError, ValidationError, ProvenanceError, SourceResolutionError, CatalogError, DuplicateIdPrefixError, DuplicateYamlKeyError, InvalidMappingRuleRefError, CircularInheritanceError, MissingMappingRulesError } from './errors.js';
+export * from './schema/index.js';
+export * from './config/index.js';
+export * from './model/index.js';
+export * from './inheritance/index.js';
+export * from './catalog/index.js';
+export * from './validation/index.js';
+export * from './provenance/index.js';
+export * from './exporters/index.js';
+export * from './parsers/index.js';
+export * from './analysis/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACzR,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/inheritance/alias-resolver.d.ts

@@ -0,0 +1,21 @@
+import type { DocumentMeta } from '../model/document-meta.js';
+/**
+ * Alias map: alias name -> canonical source path.
+ * Per DEC-1.1a: document-scoped, inherited by children, descendant wins.
+ */
+export type AliasMap = Map<string, string>;
+/**
+ * Build an alias map for a document by combining parent aliases with the document's own aliases.
+ * Descendant wins on conflict (DEC-1.1a).
+ *
+ * @param docMeta - The document's meta block
+ * @param parentAliases - Aliases inherited from parent documents
+ * @returns Combined alias map where the document's aliases override parents'
+ */
+export declare function buildAliasMap(docMeta: DocumentMeta, parentAliases?: AliasMap): AliasMap;
+/**
+ * Resolve a source alias to its canonical source path.
+ * If the source is an alias, replace it. Otherwise, return as-is.
+ */
+export declare function resolveAlias(source: string, aliases: AliasMap): string;
+//# sourceMappingURL=alias-resolver.d.ts.map

package/dist/inheritance/alias-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-resolver.d.ts","sourceRoot":"","sources":["../../src/inheritance/alias-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAkB3C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,aAAa,GAAE,QAAoB,GAClC,QAAQ,CASV;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,MAAM,CAEtE"}

package/dist/inheritance/alias-resolver.js

@@ -0,0 +1,40 @@
+/**
+ * Extract alias entries from a document's meta.inherits.
+ * Only object-form entries with an `as` field create aliases.
+ */
+function extractAliases(inherits) {
+    const aliases = new Map();
+    if (!inherits || !Array.isArray(inherits))
+        return aliases;
+    for (const entry of inherits) {
+        if (typeof entry === 'object' && entry !== null && 'source' in entry && 'as' in entry && entry.as) {
+            aliases.set(entry.as, entry.source);
+        }
+    }
+    return aliases;
+}
+/**
+ * Build an alias map for a document by combining parent aliases with the document's own aliases.
+ * Descendant wins on conflict (DEC-1.1a).
+ *
+ * @param docMeta - The document's meta block
+ * @param parentAliases - Aliases inherited from parent documents
+ * @returns Combined alias map where the document's aliases override parents'
+ */
+export function buildAliasMap(docMeta, parentAliases = new Map()) {
+    const ownAliases = extractAliases(docMeta.inherits);
+    // Start with parent aliases, overlay with own (descendant wins)
+    const combined = new Map(parentAliases);
+    for (const [alias, source] of ownAliases) {
+        combined.set(alias, source);
+    }
+    return combined;
+}
+/**
+ * Resolve a source alias to its canonical source path.
+ * If the source is an alias, replace it. Otherwise, return as-is.
+ */
+export function resolveAlias(source, aliases) {
+    return aliases.get(source) ?? source;
+}
+//# sourceMappingURL=alias-resolver.js.map

package/dist/inheritance/alias-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-resolver.js","sourceRoot":"","sources":["../../src/inheritance/alias-resolver.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,SAAS,cAAc,CAAC,QAAkC;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAE1D,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YAClG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAqB,EACrB,gBAA0B,IAAI,GAAG,EAAE;IAEnC,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpD,gEAAgE;IAChE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACzC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAiB;IAC5D,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AACvC,CAAC"}

package/dist/inheritance/index.d.ts

@@ -0,0 +1,9 @@
+export type { ElementReference } from './reference-parser.js';
+export { parseReference } from './reference-parser.js';
+export type { SourceResolver } from './source-resolver.js';
+export { LocalSourceResolver, GitSourceResolver, createSourceResolver } from './source-resolver.js';
+export type { AliasMap } from './alias-resolver.js';
+export { buildAliasMap, resolveAlias } from './alias-resolver.js';
+export type { DocumentLoader, ResolvedInheritance } from './inheritance-resolver.js';
+export { resolveInheritance } from './inheritance-resolver.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inheritance/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpG,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/inheritance/index.js

@@ -0,0 +1,5 @@
+export { parseReference } from './reference-parser.js';
+export { LocalSourceResolver, GitSourceResolver, createSourceResolver } from './source-resolver.js';
+export { buildAliasMap, resolveAlias } from './alias-resolver.js';
+export { resolveInheritance } from './inheritance-resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/inheritance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inheritance/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEpG,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/inheritance/inheritance-resolver.d.ts

@@ -0,0 +1,37 @@
+import type { Document } from '../model/document.js';
+import type { AliasMap } from './alias-resolver.js';
+/**
+ * Callback type for loading documents during inheritance resolution.
+ * The resolver doesn't know how to load documents — the caller provides this.
+ */
+export type DocumentLoader = (source: string, documentPath: string) => Document;
+/**
+ * Result of resolving a document's inheritance tree.
+ */
+export interface ResolvedInheritance {
+    /** Documents in DFS order, ancestors first (DEC-1.3: ancestors have highest priority) */
+    orderedDocuments: Document[];
+    /** Accumulated alias map for the entry document */
+    aliasMap: AliasMap;
+    /** Strongly connected components with >1 member (DEC-1.8) */
+    sccs: Document[][];
+}
+/**
+ * Resolve a document's full inheritance tree via DFS (DEC-1.0, DEC-1.3, DEC-1.8).
+ *
+ * DFS Algorithm (DEC-1.3):
+ * For document D with inherits: [A, E] where A inherits [B, C]:
+ * 1. Recurse into A → recurse into B (leaf, add B), recurse into C (leaf, add C), add A
+ * 2. Recurse into E (leaf, add E)
+ * 3. Add D
+ * Result: [B, C, A, E, D] — ancestors first, entry document last
+ *
+ * Cycle Detection (DEC-1.8):
+ * Track visiting set during DFS. On back-edge, skip the node (cycle-breaking).
+ *
+ * Tarjan's SCC (DEC-1.8):
+ * After DFS, find strongly connected components. SCCs with >1 member
+ * grant mutual element access.
+ */
+export declare function resolveInheritance(entryDoc: Document, loader: DocumentLoader): ResolvedInheritance;
+//# sourceMappingURL=inheritance-resolver.d.ts.map

package/dist/inheritance/inheritance-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance-resolver.d.ts","sourceRoot":"","sources":["../../src/inheritance/inheritance-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,QAAQ,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,QAAQ,CAAC;IACnB,6DAA6D;IAC7D,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,cAAc,GACrB,mBAAmB,CAmFrB"}

package/dist/inheritance/inheritance-resolver.js

@@ -0,0 +1,164 @@
+import { buildAliasMap } from './alias-resolver.js';
+import { InheritanceError } from '../errors.js';
+/**
+ * Resolve a document's full inheritance tree via DFS (DEC-1.0, DEC-1.3, DEC-1.8).
+ *
+ * DFS Algorithm (DEC-1.3):
+ * For document D with inherits: [A, E] where A inherits [B, C]:
+ * 1. Recurse into A → recurse into B (leaf, add B), recurse into C (leaf, add C), add A
+ * 2. Recurse into E (leaf, add E)
+ * 3. Add D
+ * Result: [B, C, A, E, D] — ancestors first, entry document last
+ *
+ * Cycle Detection (DEC-1.8):
+ * Track visiting set during DFS. On back-edge, skip the node (cycle-breaking).
+ *
+ * Tarjan's SCC (DEC-1.8):
+ * After DFS, find strongly connected components. SCCs with >1 member
+ * grant mutual element access.
+ */
+export function resolveInheritance(entryDoc, loader) {
+    const ordered = [];
+    const visited = new Set(); // fully-processed keys
+    const visiting = new Set(); // cycle detection (in-progress DFS path)
+    const docMap = new Map(); // cache loaded docs by key
+    // Register the entry document
+    const entryKey = docKey(entryDoc);
+    docMap.set(entryKey, entryDoc);
+    function dfs(doc, parentAliases) {
+        const key = docKey(doc);
+        if (visiting.has(key)) {
+            // Cycle detected — skip (DEC-1.8 cycle-breaking)
+            return parentAliases;
+        }
+        if (visited.has(key)) {
+            // Already processed — skip but don't error
+            return parentAliases;
+        }
+        visiting.add(key);
+        // Build alias map for this document (DEC-1.1a)
+        const aliases = buildAliasMap(doc.meta, parentAliases);
+        // Process inherits entries
+        const inherits = doc.meta.inherits;
+        if (inherits && Array.isArray(inherits)) {
+            for (const entry of inherits) {
+                let source;
+                let docPath;
+                if (typeof entry === 'string') {
+                    // Local document reference (same source)
+                    source = doc.source;
+                    docPath = entry;
+                }
+                else if (typeof entry === 'object' && entry !== null && 'source' in entry) {
+                    // External source reference
+                    source = entry.source;
+                    docPath = '';
+                }
+                else {
+                    continue;
+                }
+                // Try to load the parent document
+                const parentKey = `${source}:${docPath}`;
+                let parent = docMap.get(parentKey);
+                if (!parent) {
+                    try {
+                        parent = loader(source, docPath);
+                        docMap.set(parentKey, parent);
+                    }
+                    catch (e) {
+                        throw new InheritanceError(`Failed to load inherited document '${docPath}' from source '${source}': ${e.message}`);
+                    }
+                }
+                // Recurse into parent (DFS — process parents before self)
+                dfs(parent, aliases);
+            }
+        }
+        visiting.delete(key);
+        visited.add(key);
+        ordered.push(doc);
+        return aliases;
+    }
+    const finalAliases = dfs(entryDoc, new Map());
+    // Tarjan's SCC post-pass (DEC-1.8)
+    const sccs = findSCCs(ordered, docMap);
+    return {
+        orderedDocuments: ordered,
+        aliasMap: finalAliases,
+        sccs,
+    };
+}
+/** Stable key for a document: source:documentPath */
+function docKey(doc) {
+    return `${doc.source}:${doc.documentPath}`;
+}
+/**
+ * Tarjan's SCC algorithm (DEC-1.8).
+ * Returns SCCs with >1 member (mutual access groups).
+ */
+function findSCCs(documents, docMap) {
+    let index = 0;
+    const stack = [];
+    const onStack = new Set();
+    const indices = new Map();
+    const lowlinks = new Map();
+    const sccs = [];
+    function strongconnect(doc) {
+        const k = docKey(doc);
+        indices.set(k, index);
+        lowlinks.set(k, index);
+        index++;
+        stack.push(k);
+        onStack.add(k);
+        // Process successors (documents this doc inherits from)
+        const inherits = doc.meta.inherits;
+        if (inherits && Array.isArray(inherits)) {
+            for (const entry of inherits) {
+                let successorKey;
+                if (typeof entry === 'string') {
+                    successorKey = `${doc.source}:${entry}`;
+                }
+                else if (typeof entry === 'object' &&
+                    entry !== null &&
+                    'source' in entry) {
+                    successorKey = `${entry.source}:`;
+                }
+                else {
+                    continue;
+                }
+                if (!indices.has(successorKey)) {
+                    const successor = docMap.get(successorKey);
+                    if (successor) {
+                        strongconnect(successor);
+                        lowlinks.set(k, Math.min(lowlinks.get(k), lowlinks.get(successorKey)));
+                    }
+                }
+                else if (onStack.has(successorKey)) {
+                    lowlinks.set(k, Math.min(lowlinks.get(k), indices.get(successorKey)));
+                }
+            }
+        }
+        // If this is a root node of an SCC
+        if (lowlinks.get(k) === indices.get(k)) {
+            const scc = [];
+            let w;
+            do {
+                w = stack.pop();
+                onStack.delete(w);
+                const sccDoc = docMap.get(w);
+                if (sccDoc)
+                    scc.push(sccDoc);
+            } while (w !== k);
+            // Only include SCCs with >1 member (mutual access groups)
+            if (scc.length > 1) {
+                sccs.push(scc);
+            }
+        }
+    }
+    for (const doc of documents) {
+        if (!indices.has(docKey(doc))) {
+            strongconnect(doc);
+        }
+    }
+    return sccs;
+}
+//# sourceMappingURL=inheritance-resolver.js.map

package/dist/inheritance/inheritance-resolver.js.map

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

package/dist/inheritance/reference-parser.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Parsed element reference (DEC-1.1c).
+ * Segment count determines scope:
+ * - 1 segment: element only (same document)
+ * - 2 segments: document:element (same library)
+ * - 3 segments: source:document:element (cross-library)
+ */
+export interface ElementReference {
+    source?: string;
+    document?: string;
+    element: string;
+    segmentCount: 1 | 2 | 3;
+}
+/**
+ * Parse an element reference string.
+ *
+ * The colon `:` is the delimiter. Split into at most 3 parts.
+ * A segment containing `/` is a document path, not a source+document split.
+ *
+ * Examples:
+ *   "V1"              -> { element: "V1", segmentCount: 1 }
+ *   "values:V1"       -> { document: "values", element: "V1", segmentCount: 2 }
+ *   "org:values:V1"   -> { source: "org", document: "values", element: "V1", segmentCount: 3 }
+ *   "@github:foo/bar:values:V1" -> { source: "@github:foo/bar", document: "values", element: "V1", segmentCount: 3 }
+ */
+export declare function parseReference(ref: string): ElementReference;
+//# sourceMappingURL=reference-parser.d.ts.map

package/dist/inheritance/reference-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-parser.d.ts","sourceRoot":"","sources":["../../src/inheritance/reference-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAiE5D"}

package/dist/inheritance/reference-parser.js

@@ -0,0 +1,74 @@
+/**
+ * Parse an element reference string.
+ *
+ * The colon `:` is the delimiter. Split into at most 3 parts.
+ * A segment containing `/` is a document path, not a source+document split.
+ *
+ * Examples:
+ *   "V1"              -> { element: "V1", segmentCount: 1 }
+ *   "values:V1"       -> { document: "values", element: "V1", segmentCount: 2 }
+ *   "org:values:V1"   -> { source: "org", document: "values", element: "V1", segmentCount: 3 }
+ *   "@github:foo/bar:values:V1" -> { source: "@github:foo/bar", document: "values", element: "V1", segmentCount: 3 }
+ */
+export function parseReference(ref) {
+    // Handle @source: prefixes that contain colons (e.g., @github:foo/bar)
+    // Pattern: @provider:path is always a source prefix
+    let source;
+    let remainder = ref;
+    if (ref.startsWith('@')) {
+        // Find the source boundary: @provider:path is the source
+        // The source ends at the colon that separates it from the document
+        // @github:foo/bar:values:V1 -> source=@github:foo/bar, rest=values:V1
+        // Strategy: @provider:path where path contains / — everything up to the colon
+        // after which the next segment does NOT contain /
+        const parts = ref.split(':');
+        // Build source from the front, stopping when we hit a segment that looks like a document:element
+        let sourceEnd = 1; // At least @provider
+        for (let i = 1; i < parts.length; i++) {
+            if (parts[i].includes('/')) {
+                sourceEnd = i + 1; // This segment is part of the source path
+            }
+            else {
+                break;
+            }
+        }
+        if (sourceEnd < parts.length) {
+            source = parts.slice(0, sourceEnd).join(':');
+            remainder = parts.slice(sourceEnd).join(':');
+        }
+        else {
+            // Entire string is a source with no document:element
+            return { element: ref, segmentCount: 1 };
+        }
+    }
+    // Split remainder into segments
+    // For non-@ references, we can have up to 3 colon-separated segments:
+    //   element | document:element | source:document:element
+    // For @ references, source is already extracted, so remainder is:
+    //   element | document:element
+    const parts = remainder.split(':');
+    if (source) {
+        // Source already extracted from @ prefix
+        if (parts.length === 1) {
+            // source:element (unusual but valid)
+            return { source, element: parts[0], segmentCount: 3 };
+        }
+        // source:document:element — document may contain colons (unlikely but safe)
+        const element = parts[parts.length - 1];
+        const document = parts.slice(0, -1).join(':');
+        return { source, document, element, segmentCount: 3 };
+    }
+    // No @ prefix: split into 1, 2, or 3 segments
+    if (parts.length === 1) {
+        return { element: parts[0], segmentCount: 1 };
+    }
+    if (parts.length === 2) {
+        return { document: parts[0], element: parts[1], segmentCount: 2 };
+    }
+    // 3+ segments: first is source, last is element, middle is document
+    const element = parts[parts.length - 1];
+    const src = parts[0];
+    const document = parts.slice(1, -1).join(':');
+    return { source: src, document, element, segmentCount: 3 };
+}
+//# sourceMappingURL=reference-parser.js.map