@principled/cairn 1.0.0-beta

package/dist/data/data/defaults.yaml

@@ -0,0 +1,101 @@
+# GVP v1 Built-in Category Definitions
+# Per DEC-9.4: loaded through same pipeline as user files (dogfooding)
+
+_all:
+  field_schemas:
+    priority:
+      type: number
+      required: false
+    refs:
+      type: list
+      required: false
+      items:
+        type: model
+        fields:
+          file:
+            type: string
+            required: true
+          identifier:
+            type: string
+            required: true
+          role:
+            type: enum
+            values: ["defines", "implements", "uses", "extends"]
+            required: true
+
+categories:
+  goal:
+    yaml_key: goals
+    id_prefix: G
+    primary_field: statement
+    is_root: true
+    color: "#4CAF50"
+
+  value:
+    yaml_key: values
+    id_prefix: V
+    primary_field: statement
+    is_root: true
+    color: "#2196F3"
+
+  constraint:
+    yaml_key: constraints
+    id_prefix: C
+    primary_field: impact
+    is_root: true
+    color: "#FF9800"
+
+  principle:
+    yaml_key: principles
+    id_prefix: P
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+    color: "#9C27B0"
+
+  rule:
+    yaml_key: rules
+    id_prefix: R
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+    color: "#F44336"
+
+  heuristic:
+    yaml_key: heuristics
+    id_prefix: H
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+      - [principle]
+      - [rule]
+    color: "#00BCD4"
+
+  decision:
+    yaml_key: decisions
+    id_prefix: D
+    primary_field: rationale
+    mapping_rules:
+      - [goal, value]
+    field_schemas:
+      considered:
+        type: dict
+        required: false
+        values:
+          type: model
+          fields:
+            rationale:
+              type: string
+              required: true
+            description:
+              type: string
+              required: false
+    color: "#795548"
+
+  milestone:
+    yaml_key: milestones
+    id_prefix: M
+    primary_field: description
+    mapping_rules:
+      - [goal, value]
+    color: "#607D8B"

package/dist/data/defaults.yaml

@@ -0,0 +1,101 @@
+# GVP v1 Built-in Category Definitions
+# Per DEC-9.4: loaded through same pipeline as user files (dogfooding)
+
+_all:
+  field_schemas:
+    priority:
+      type: number
+      required: false
+    refs:
+      type: list
+      required: false
+      items:
+        type: model
+        fields:
+          file:
+            type: string
+            required: true
+          identifier:
+            type: string
+            required: true
+          role:
+            type: enum
+            values: ["defines", "implements", "uses", "extends"]
+            required: true
+
+categories:
+  goal:
+    yaml_key: goals
+    id_prefix: G
+    primary_field: statement
+    is_root: true
+    color: "#4CAF50"
+
+  value:
+    yaml_key: values
+    id_prefix: V
+    primary_field: statement
+    is_root: true
+    color: "#2196F3"
+
+  constraint:
+    yaml_key: constraints
+    id_prefix: C
+    primary_field: impact
+    is_root: true
+    color: "#FF9800"
+
+  principle:
+    yaml_key: principles
+    id_prefix: P
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+    color: "#9C27B0"
+
+  rule:
+    yaml_key: rules
+    id_prefix: R
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+    color: "#F44336"
+
+  heuristic:
+    yaml_key: heuristics
+    id_prefix: H
+    primary_field: statement
+    mapping_rules:
+      - [goal, value]
+      - [principle]
+      - [rule]
+    color: "#00BCD4"
+
+  decision:
+    yaml_key: decisions
+    id_prefix: D
+    primary_field: rationale
+    mapping_rules:
+      - [goal, value]
+    field_schemas:
+      considered:
+        type: dict
+        required: false
+        values:
+          type: model
+          fields:
+            rationale:
+              type: string
+              required: true
+            description:
+              type: string
+              required: false
+    color: "#795548"
+
+  milestone:
+    yaml_key: milestones
+    id_prefix: M
+    primary_field: description
+    mapping_rules:
+      - [goal, value]
+    color: "#607D8B"

package/dist/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base error for all GVP errors.
+ * Hierarchy: GVPError -> domain errors -> specific errors
+ * Per DEC-5.3: catch at any granularity.
+ */
+export declare class GVPError extends Error {
+    constructor(message: string);
+}
+export declare class SchemaError extends GVPError {
+    constructor(message: string);
+}
+export declare class InheritanceError extends GVPError {
+    constructor(message: string);
+}
+export declare class ConfigError extends GVPError {
+    constructor(message: string);
+}
+export declare class ValidationError extends GVPError {
+    constructor(message: string);
+}
+export declare class ProvenanceError extends GVPError {
+    constructor(message: string);
+}
+export declare class SourceResolutionError extends InheritanceError {
+    constructor(message: string);
+}
+export declare class CatalogError extends GVPError {
+    constructor(message: string);
+}
+export declare class DuplicateIdPrefixError extends CatalogError {
+    constructor(message: string);
+}
+export declare class DuplicateYamlKeyError extends CatalogError {
+    constructor(message: string);
+}
+export declare class InvalidMappingRuleRefError extends CatalogError {
+    constructor(message: string);
+}
+export declare class CircularInheritanceError extends InheritanceError {
+    constructor(message: string);
+}
+export declare class MissingMappingRulesError extends CatalogError {
+    constructor(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;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,0BAA2B,SAAQ,YAAY;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;gBAChD,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,wBAAyB,SAAQ,YAAY;gBAC5C,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,84 @@
+/**
+ * Base error for all GVP errors.
+ * Hierarchy: GVPError -> domain errors -> specific errors
+ * Per DEC-5.3: catch at any granularity.
+ */
+export class GVPError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GVPError';
+    }
+}
+export class SchemaError extends GVPError {
+    constructor(message) {
+        super(message);
+        this.name = 'SchemaError';
+    }
+}
+export class InheritanceError extends GVPError {
+    constructor(message) {
+        super(message);
+        this.name = 'InheritanceError';
+    }
+}
+export class ConfigError extends GVPError {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+    }
+}
+export class ValidationError extends GVPError {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+export class ProvenanceError extends GVPError {
+    constructor(message) {
+        super(message);
+        this.name = 'ProvenanceError';
+    }
+}
+export class SourceResolutionError extends InheritanceError {
+    constructor(message) {
+        super(message);
+        this.name = 'SourceResolutionError';
+    }
+}
+export class CatalogError extends GVPError {
+    constructor(message) {
+        super(message);
+        this.name = 'CatalogError';
+    }
+}
+export class DuplicateIdPrefixError extends CatalogError {
+    constructor(message) {
+        super(message);
+        this.name = 'DuplicateIdPrefixError';
+    }
+}
+export class DuplicateYamlKeyError extends CatalogError {
+    constructor(message) {
+        super(message);
+        this.name = 'DuplicateYamlKeyError';
+    }
+}
+export class InvalidMappingRuleRefError extends CatalogError {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidMappingRuleRefError';
+    }
+}
+export class CircularInheritanceError extends InheritanceError {
+    constructor(message) {
+        super(message);
+        this.name = 'CircularInheritanceError';
+    }
+}
+export class MissingMappingRulesError extends CatalogError {
+    constructor(message) {
+        super(message);
+        this.name = 'MissingMappingRulesError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IACzD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAC1D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,gBAAgB;IAC5D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,YAAY;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/exporters/base.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { Catalog } from '../catalog/catalog.js';
+export interface ExportOptions {
+    outputDir?: string;
+    includeDeprecated?: boolean;
+}
+/**
+ * Abstract base class for exporters (DEC-7.8).
+ * Each exporter declares key, name, optionsSchema, and export().
+ */
+export declare abstract class Exporter {
+    abstract readonly key: string;
+    abstract readonly name: string;
+    abstract readonly optionsSchema: z.ZodType;
+    abstract export(catalog: Catalog, options?: ExportOptions): string;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/exporters/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,8BAAsB,QAAQ;IAC5B,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC;IAE3C,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;CACnE"}

package/dist/exporters/base.js

@@ -0,0 +1,7 @@
+/**
+ * Abstract base class for exporters (DEC-7.8).
+ * Each exporter declares key, name, optionsSchema, and export().
+ */
+export class Exporter {
+}
+//# sourceMappingURL=base.js.map

package/dist/exporters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/exporters/base.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAgB,QAAQ;CAM7B"}

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

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import type { Catalog } from '../catalog/catalog.js';
+import { Exporter, type ExportOptions } from './base.js';
+/**
+ * CSV exporter with reserved fields fixed + dynamic fields appended (DEC-7.3).
+ */
+export declare class CsvExporter extends Exporter {
+    readonly key = "csv";
+    readonly name = "CSV";
+    readonly optionsSchema: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+    export(catalog: Catalog, options?: ExportOptions): string;
+}
+//# sourceMappingURL=csv-exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"csv-exporter.d.ts","sourceRoot":"","sources":["../../src/exporters/csv-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;AAGzD;;GAEG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,QAAQ,CAAC,GAAG,SAAS;IACrB,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,aAAa,gDAA2B;IAEjD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;CA+C1D"}

package/dist/exporters/csv-exporter.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { Exporter } from './base.js';
+import { RESERVED_FIELD_NAMES } from '../schema/reserved-fields.js';
+/**
+ * CSV exporter with reserved fields fixed + dynamic fields appended (DEC-7.3).
+ */
+export class CsvExporter extends Exporter {
+    key = 'csv';
+    name = 'CSV';
+    optionsSchema = z.object({}).optional();
+    export(catalog, options) {
+        const includeDeprecated = options?.includeDeprecated ?? false;
+        const elements = catalog.getAllElements()
+            .filter(e => includeDeprecated || e.status !== 'deprecated');
+        if (elements.length === 0)
+            return '';
+        // Fixed columns: reserved fields in stable order
+        const fixedColumns = [
+            'qualified_id', 'id', 'document', 'category',
+            'name', 'status', 'tags', 'maps_to', 'priority',
+        ];
+        // Dynamic columns: collect all unique dynamic field names across all elements
+        const dynamicColumns = new Set();
+        for (const el of elements) {
+            for (const key of Object.keys(el.data)) {
+                if (!RESERVED_FIELD_NAMES.has(key) && !fixedColumns.includes(key)) {
+                    dynamicColumns.add(key);
+                }
+            }
+        }
+        const sortedDynamic = [...dynamicColumns].sort();
+        const allColumns = [...fixedColumns, ...sortedDynamic];
+        // Header row
+        const rows = [allColumns.join(',')];
+        // Data rows
+        for (const el of elements) {
+            const values = allColumns.map(col => {
+                let val;
+                switch (col) {
+                    case 'qualified_id':
+                        val = el.toLibraryId();
+                        break;
+                    case 'document':
+                        val = el.documentPath;
+                        break;
+                    case 'category':
+                        val = el.categoryName;
+                        break;
+                    case 'tags':
+                        val = el.tags.join(';');
+                        break;
+                    case 'maps_to':
+                        val = el.maps_to.join(';');
+                        break;
+                    default: val = el.data[col] ?? el.get(col) ?? '';
+                }
+                return csvEscape(val);
+            });
+            rows.push(values.join(','));
+        }
+        return rows.join('\n');
+    }
+}
+function csvEscape(value) {
+    if (value === undefined || value === null)
+        return '';
+    const str = typeof value === 'object' ? JSON.stringify(value) : String(value);
+    if (str.includes(',') || str.includes('"') || str.includes('\n')) {
+        return `"${str.replace(/"/g, '""')}"`;
+    }
+    return str;
+}
+//# sourceMappingURL=csv-exporter.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { Catalog } from '../catalog/catalog.js';
+import { Exporter, type ExportOptions } from './base.js';
+export declare class DotExporter extends Exporter {
+    readonly key = "dot";
+    readonly name = "Graphviz DOT";
+    readonly optionsSchema: z.ZodOptional<z.ZodObject<{
+        tier: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    export(catalog: Catalog, options?: ExportOptions): string;
+}
+//# sourceMappingURL=dot-exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dot-exporter.d.ts","sourceRoot":"","sources":["../../src/exporters/dot-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,WAAY,SAAQ,QAAQ;IACvC,QAAQ,CAAC,GAAG,SAAS;IACrB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,aAAa;;uBAIR;IAEd,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;CAqE1D"}

package/dist/exporters/dot-exporter.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import { Exporter } from './base.js';
+export class DotExporter extends Exporter {
+    key = 'dot';
+    name = 'Graphviz DOT';
+    optionsSchema = z
+        .object({
+        tier: z.number().optional(),
+    })
+        .optional();
+    export(catalog, options) {
+        const includeDeprecated = options?.includeDeprecated ?? false;
+        const elements = catalog
+            .getAllElements()
+            .filter((e) => includeDeprecated || e.status === 'active');
+        // Generate DOT format (basic implementation — PNG rendering deferred until WASM dep available)
+        const lines = ['digraph gvp {', '  rankdir=BT;'];
+        // Nodes
+        for (const el of elements) {
+            const nodeId = el.toLibraryId().replace(/:/g, '__').replace(/-/g, '_');
+            const catDef = catalog.registry.getByName(el.categoryName);
+            const color = catDef?.color ?? '#CCCCCC';
+            lines.push(`  ${nodeId} [label="${el.id}: ${el.name}" style=filled fillcolor="${color}"];`);
+        }
+        // Edges
+        for (const el of elements) {
+            const fromId = el.toLibraryId().replace(/:/g, '__').replace(/-/g, '_');
+            for (const ref of el.maps_to) {
+                const target = elements.find((e) => e.toLibraryId() === ref || e.hashKey() === ref);
+                if (target) {
+                    const toId = target
+                        .toLibraryId()
+                        .replace(/:/g, '__')
+                        .replace(/-/g, '_');
+                    lines.push(`  ${fromId} -> ${toId};`);
+                }
+            }
+        }
+        // Tier-based rank=same grouping (R8)
+        const tiers = new Map();
+        for (const el of elements) {
+            const catDef = catalog.registry.getByName(el.categoryName);
+            const exportOpts = catDef?.export_options?.dot;
+            if (exportOpts?.tier !== undefined) {
+                const nodeId = el.toLibraryId().replace(/:/g, '__').replace(/-/g, '_');
+                if (!tiers.has(exportOpts.tier))
+                    tiers.set(exportOpts.tier, []);
+                tiers.get(exportOpts.tier).push(nodeId);
+            }
+        }
+        for (const [, nodes] of [...tiers.entries()].sort((a, b) => a[0] - b[0])) {
+            lines.push(`  {rank=same; ${nodes.join('; ')};}`);
+        }
+        // Subgraph grouping per document
+        for (const doc of catalog.documents) {
+            const docElements = elements.filter(e => e.documentPath === doc.documentPath);
+            if (docElements.length > 0) {
+                const clusterId = doc.documentPath.replace(/[^a-zA-Z0-9]/g, '_');
+                lines.push(`  subgraph cluster_${clusterId} {`);
+                lines.push(`    label="${doc.name}";`);
+                for (const el of docElements) {
+                    const nodeId = el.toLibraryId().replace(/:/g, '__').replace(/-/g, '_');
+                    lines.push(`    ${nodeId};`);
+                }
+                lines.push('  }');
+            }
+        }
+        lines.push('}');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=dot-exporter.js.map

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

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

package/dist/exporters/index.d.ts

@@ -0,0 +1,8 @@
+export { Exporter, type ExportOptions } from './base.js';
+export { JsonExporter } from './json-exporter.js';
+export { CsvExporter } from './csv-exporter.js';
+export { MarkdownExporter } from './markdown-exporter.js';
+export { DotExporter } from './dot-exporter.js';
+export { SqliteExporter } from './sqlite-exporter.js';
+export { createExporterRegistry } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exporters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACzD,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;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/exporters/index.js

@@ -0,0 +1,8 @@
+export { Exporter } from './base.js';
+export { JsonExporter } from './json-exporter.js';
+export { CsvExporter } from './csv-exporter.js';
+export { MarkdownExporter } from './markdown-exporter.js';
+export { DotExporter } from './dot-exporter.js';
+export { SqliteExporter } from './sqlite-exporter.js';
+export { createExporterRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/exporters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exporters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,WAAW,CAAC;AACzD,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;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/exporters/json-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';
+/**
+ * Lossless JSON exporter (DEC-7.7, DEC-7.10).
+ * Includes all documents, elements, categories, and tags.
+ */
+export declare class JsonExporter extends Exporter {
+    readonly key = "json";
+    readonly name = "JSON";
+    readonly optionsSchema: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+    export(catalog: Catalog, options?: ExportOptions): string;
+}
+//# sourceMappingURL=json-exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-exporter.d.ts","sourceRoot":"","sources":["../../src/exporters/json-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,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,GAAG,UAAU;IACtB,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,aAAa,gDAA2B;IAEjD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;CA+B1D"}

package/dist/exporters/json-exporter.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { Exporter } from './base.js';
+/**
+ * Lossless JSON exporter (DEC-7.7, DEC-7.10).
+ * Includes all documents, elements, categories, and tags.
+ */
+export class JsonExporter extends Exporter {
+    key = 'json';
+    name = 'JSON';
+    optionsSchema = z.object({}).optional();
+    export(catalog, options) {
+        const includeDeprecated = options?.includeDeprecated ?? false;
+        const output = {
+            documents: catalog.documents.map(doc => ({
+                name: doc.name,
+                documentPath: doc.documentPath,
+                source: doc.source,
+                meta: {
+                    ...doc.meta,
+                    // Ensure lossless fields are always present (DEC-7.10)
+                    inherits: doc.meta.inherits ?? null,
+                    defaults: doc.meta.defaults ?? null,
+                    definitions: doc.meta.definitions ?? null,
+                    scope: doc.meta.scope ?? null,
+                },
+                elements: doc.getAllElements()
+                    .filter(e => includeDeprecated || e.status !== 'deprecated')
+                    .map(e => ({
+                    ...e.data,
+                    _category: e.categoryName,
+                    _libraryId: e.toLibraryId(),
+                    _canonicalId: e.toCanonicalId(),
+                })),
+            })),
+            categories: catalog.registry.categories,
+            tags: catalog.getTags(),
+        };
+        return JSON.stringify(output, null, 2);
+    }
+}
+//# sourceMappingURL=json-exporter.js.map