@principled/cairn 1.0.0-beta

package/dist/model/element.js

@@ -0,0 +1,78 @@
+/**
+ * A single GVP element (DEC-6.2, DEC-6.3, DEC-6.4).
+ *
+ * Identity: (source, documentPath, id)
+ * Equality: equals() compares identity tuple
+ * String reps: toString(), toLibraryId(), toCanonicalId()
+ */
+export class Element {
+    id;
+    name;
+    status;
+    tags;
+    maps_to;
+    priority;
+    categoryName;
+    source;
+    documentPath;
+    /** All data including reserved + dynamic fields */
+    _data;
+    constructor(data, categoryName, source, documentPath) {
+        this.id = data.id;
+        this.name = data.name;
+        this.status = data.status ?? 'active';
+        this.tags = data.tags ?? [];
+        this.maps_to = data.maps_to ?? [];
+        this.priority = data.priority;
+        this.categoryName = categoryName;
+        this.source = source;
+        this.documentPath = documentPath;
+        this._data = data;
+    }
+    /** Get a dynamic field value by name */
+    get(fieldName) {
+        return this._data[fieldName];
+    }
+    /** Get all data as a plain record */
+    get data() {
+        return { ...this._data };
+    }
+    /**
+     * Human-readable display form (DEC-6.4).
+     * E.g., 'V1: "Alignment"'
+     */
+    toString() {
+        return `${this.id}: "${this.name}"`;
+    }
+    /**
+     * Within-library qualified reference (DEC-6.4, DEC-1.1c 2-segment).
+     * E.g., 'values:V1'
+     */
+    toLibraryId() {
+        return `${this.documentPath}:${this.id}`;
+    }
+    /**
+     * Fully qualified canonical ID (DEC-6.4, DEC-1.1b).
+     * E.g., '@github:company/org-gvp:values:V1'
+     */
+    toCanonicalId() {
+        return `${this.source}:${this.documentPath}:${this.id}`;
+    }
+    /**
+     * Stable hash key for use as Map key (DEC-6.2).
+     * Based on (source, documentPath, id) tuple.
+     */
+    hashKey() {
+        return `${this.source}:${this.documentPath}:${this.id}`;
+    }
+    /**
+     * Identity equality (DEC-6.2, DEC-6.3).
+     * Based on (source, documentPath, id). Priority does NOT affect equality.
+     */
+    equals(other) {
+        return (this.source === other.source &&
+            this.documentPath === other.documentPath &&
+            this.id === other.id);
+    }
+}
+//# sourceMappingURL=element.js.map

package/dist/model/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../../src/model/element.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,OAAO;IACT,EAAE,CAAS;IACX,IAAI,CAAS;IACb,MAAM,CAAS;IACf,IAAI,CAAW;IACf,OAAO,CAAW;IAClB,QAAQ,CAAqB;IAC7B,YAAY,CAAS;IACrB,MAAM,CAAS;IACf,YAAY,CAAS;IAE9B,mDAAmD;IAClC,KAAK,CAA0B;IAEhD,YACE,IAA6B,EAC7B,YAAoB,EACpB,MAAc,EACd,YAAoB;QAEpB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAY,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;QAChC,IAAI,CAAC,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,QAAQ,CAAC;QAClD,IAAI,CAAC,IAAI,GAAI,IAAI,CAAC,IAAiB,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAI,IAAI,CAAC,OAAoB,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAA8B,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,wCAAwC;IACxC,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAc;QACnB,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAC5B,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY;YACxC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CACrB,CAAC;IACJ,CAAC;CACF"}

package/dist/model/graph.d.ts

@@ -0,0 +1,42 @@
+import type { Element } from './element.js';
+/**
+ * Immutable directed graph of elements (DEC-6.1).
+ * Returned by ancestors()/descendants(). Start element always included (DEC-6.5).
+ * Handles cycles via seen-set (DEC-6.7: maps_to cycles are allowed).
+ */
+export declare class Graph {
+    private readonly _nodes;
+    private readonly _edges;
+    constructor(nodes: Map<string, Element>, edges: Map<string, Set<string>>);
+    /** All nodes in the graph */
+    get nodes(): Element[];
+    /** Number of nodes */
+    get size(): number;
+    /** All edges as [from, to] pairs */
+    get edges(): [Element, Element][];
+    /** Check if graph contains an element */
+    has(element: Element): boolean;
+    /** Get direct successors of an element */
+    successors(element: Element): Element[];
+    /** Nodes with no incoming edges */
+    roots(): Element[];
+    /** Nodes with no outgoing edges */
+    leaves(): Element[];
+    /** Find all paths from source to target */
+    pathsTo(source: Element, target: Element): Element[][];
+    /** Filter graph by predicate, returning a new immutable Graph */
+    filter(predicate: (element: Element) => boolean): Graph;
+}
+/**
+ * Build an ancestors graph for an element (DEC-6.1, DEC-6.5).
+ * Walks maps_to upward. Start element always included.
+ * Cycles handled via seen-set (DEC-6.7).
+ */
+export declare function buildAncestorsGraph(element: Element, elementLookup: (ref: string) => Element | undefined): Graph;
+/**
+ * Build a descendants graph for an element (DEC-6.1, DEC-6.5).
+ * Finds all elements that map TO this element, recursively.
+ * Start element always included.
+ */
+export declare function buildDescendantsGraph(element: Element, allElements: Element[]): Graph;
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/model/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IASxE,6BAA6B;IAC7B,IAAI,KAAK,IAAI,OAAO,EAAE,CAErB;IAED,sBAAsB;IACtB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oCAAoC;IACpC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAWhC;IAED,yCAAyC;IACzC,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAI9B,0CAA0C;IAC1C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE;IAQvC,mCAAmC;IACnC,KAAK,IAAI,OAAO,EAAE;IAUlB,mCAAmC;IACnC,MAAM,IAAI,OAAO,EAAE;IASnB,2CAA2C;IAC3C,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,EAAE;IAsBtD,iEAAiE;IACjE,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,KAAK;CAexD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,GAClD,KAAK,CAuBP;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,OAAO,EAAE,GACrB,KAAK,CAoCP"}

package/dist/model/graph.js

@@ -0,0 +1,177 @@
+/**
+ * Immutable directed graph of elements (DEC-6.1).
+ * Returned by ancestors()/descendants(). Start element always included (DEC-6.5).
+ * Handles cycles via seen-set (DEC-6.7: maps_to cycles are allowed).
+ */
+export class Graph {
+    _nodes; // hashKey -> Element
+    _edges; // from hashKey -> Set<to hashKey>
+    constructor(nodes, edges) {
+        this._nodes = new Map(nodes);
+        this._edges = new Map();
+        for (const [from, tos] of edges) {
+            this._edges.set(from, new Set(tos));
+        }
+        Object.freeze(this);
+    }
+    /** All nodes in the graph */
+    get nodes() {
+        return [...this._nodes.values()];
+    }
+    /** Number of nodes */
+    get size() {
+        return this._nodes.size;
+    }
+    /** All edges as [from, to] pairs */
+    get edges() {
+        const result = [];
+        for (const [fromKey, toKeys] of this._edges) {
+            const from = this._nodes.get(fromKey);
+            if (!from)
+                continue;
+            for (const toKey of toKeys) {
+                const to = this._nodes.get(toKey);
+                if (to)
+                    result.push([from, to]);
+            }
+        }
+        return result;
+    }
+    /** Check if graph contains an element */
+    has(element) {
+        return this._nodes.has(element.hashKey());
+    }
+    /** Get direct successors of an element */
+    successors(element) {
+        const toKeys = this._edges.get(element.hashKey());
+        if (!toKeys)
+            return [];
+        return [...toKeys]
+            .map((k) => this._nodes.get(k))
+            .filter((e) => !!e);
+    }
+    /** Nodes with no incoming edges */
+    roots() {
+        const hasIncoming = new Set();
+        for (const toKeys of this._edges.values()) {
+            for (const k of toKeys)
+                hasIncoming.add(k);
+        }
+        return [...this._nodes.entries()]
+            .filter(([key]) => !hasIncoming.has(key))
+            .map(([, el]) => el);
+    }
+    /** Nodes with no outgoing edges */
+    leaves() {
+        return [...this._nodes.entries()]
+            .filter(([key]) => {
+            const tos = this._edges.get(key);
+            return !tos || tos.size === 0;
+        })
+            .map(([, el]) => el);
+    }
+    /** Find all paths from source to target */
+    pathsTo(source, target) {
+        const paths = [];
+        const dfs = (current, path, visited) => {
+            if (current.hashKey() === target.hashKey()) {
+                paths.push([...path, current]);
+                return;
+            }
+            visited.add(current.hashKey());
+            for (const next of this.successors(current)) {
+                if (!visited.has(next.hashKey())) {
+                    dfs(next, [...path, current], visited);
+                }
+            }
+        };
+        dfs(source, [], new Set());
+        return paths;
+    }
+    /** Filter graph by predicate, returning a new immutable Graph */
+    filter(predicate) {
+        const nodes = new Map();
+        const edges = new Map();
+        for (const [key, el] of this._nodes) {
+            if (predicate(el)) {
+                nodes.set(key, el);
+            }
+        }
+        for (const [from, tos] of this._edges) {
+            if (!nodes.has(from))
+                continue;
+            const filtered = new Set([...tos].filter((k) => nodes.has(k)));
+            if (filtered.size > 0)
+                edges.set(from, filtered);
+        }
+        return new Graph(nodes, edges);
+    }
+}
+/**
+ * Build an ancestors graph for an element (DEC-6.1, DEC-6.5).
+ * Walks maps_to upward. Start element always included.
+ * Cycles handled via seen-set (DEC-6.7).
+ */
+export function buildAncestorsGraph(element, elementLookup) {
+    const nodes = new Map();
+    const edges = new Map();
+    function walk(el, visited) {
+        const key = el.hashKey();
+        if (visited.has(key))
+            return; // Cycle handling (DEC-6.7)
+        visited.add(key);
+        nodes.set(key, el);
+        for (const ref of el.maps_to) {
+            const target = elementLookup(ref);
+            if (target) {
+                // Edge: el -> target (el maps to target)
+                if (!edges.has(key))
+                    edges.set(key, new Set());
+                edges.get(key).add(target.hashKey());
+                walk(target, visited);
+            }
+        }
+    }
+    walk(element, new Set());
+    return new Graph(nodes, edges);
+}
+/**
+ * Build a descendants graph for an element (DEC-6.1, DEC-6.5).
+ * Finds all elements that map TO this element, recursively.
+ * Start element always included.
+ */
+export function buildDescendantsGraph(element, allElements) {
+    const nodes = new Map();
+    const edges = new Map();
+    // Build reverse index: element hashKey -> elements that map to it
+    const reverseIndex = new Map();
+    for (const el of allElements) {
+        for (const ref of el.maps_to) {
+            // Try matching by libraryId or hashKey
+            const targets = allElements.filter((e) => e.toLibraryId() === ref || e.hashKey() === ref);
+            for (const target of targets) {
+                const targetKey = target.hashKey();
+                if (!reverseIndex.has(targetKey))
+                    reverseIndex.set(targetKey, []);
+                reverseIndex.get(targetKey).push(el);
+            }
+        }
+    }
+    function walk(el, visited) {
+        const key = el.hashKey();
+        if (visited.has(key))
+            return;
+        visited.add(key);
+        nodes.set(key, el);
+        const children = reverseIndex.get(key) ?? [];
+        for (const child of children) {
+            if (!edges.has(child.hashKey()))
+                edges.set(child.hashKey(), new Set());
+            edges.get(child.hashKey()).add(key);
+            walk(child, visited);
+        }
+    }
+    walk(element, new Set());
+    return new Graph(nodes, edges);
+}
+//# sourceMappingURL=graph.js.map

package/dist/model/graph.js.map

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

package/dist/model/index.d.ts

@@ -0,0 +1,8 @@
+export { Element } from './element.js';
+export { Document } from './document.js';
+export { CategoryRegistry } from './category-registry.js';
+export { documentMetaSchema } from './document-meta.js';
+export type { DocumentMeta } from './document-meta.js';
+export { parseDocument, loadDocumentFromFile } from './document-parser.js';
+export { Graph, buildAncestorsGraph, buildDescendantsGraph } from './graph.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/model/index.js

@@ -0,0 +1,7 @@
+export { Element } from './element.js';
+export { Document } from './document.js';
+export { CategoryRegistry } from './category-registry.js';
+export { documentMetaSchema } from './document-meta.js';
+export { parseDocument, loadDocumentFromFile } from './document-parser.js';
+export { Graph, buildAncestorsGraph, buildDescendantsGraph } from './graph.js';
+//# sourceMappingURL=index.js.map

package/dist/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/parsers/base.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Abstract base class for reference parsers (DEC-10.3).
+ * One core method: extractIdentifiers. extractBlock is a convenience wrapper.
+ */
+export declare abstract class RefParser {
+    abstract readonly extensions: string[];
+    /**
+     * Core method: extract identifiers from file content.
+     * Each result has an identifier name and its content block.
+     *
+     * @param content - File content to parse
+     * @param matching - Optional filter string. When provided, only return
+     *   identifiers that match (exact match). When omitted, return ALL
+     *   identifiers found in the file.
+     */
+    abstract extractIdentifiers(content: string, matching?: string): Array<{
+        identifier: string;
+        block: string;
+    }>;
+    /**
+     * Convenience: extract a single content block by exact identifier name.
+     * Returns null if not found or if multiple matches (ambiguous).
+     */
+    extractBlock(content: string, identifier: string): string | null;
+    /** Check if this parser handles a given file extension. */
+    handles(extension: string): boolean;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/parsers/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAEvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QACrE,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKhE,2DAA2D;IAC3D,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAGpC"}

package/dist/parsers/base.js

@@ -0,0 +1,19 @@
+/**
+ * Abstract base class for reference parsers (DEC-10.3).
+ * One core method: extractIdentifiers. extractBlock is a convenience wrapper.
+ */
+export class RefParser {
+    /**
+     * Convenience: extract a single content block by exact identifier name.
+     * Returns null if not found or if multiple matches (ambiguous).
+     */
+    extractBlock(content, identifier) {
+        const results = this.extractIdentifiers(content, identifier);
+        return results.length === 1 ? results[0].block : null;
+    }
+    /** Check if this parser handles a given file extension. */
+    handles(extension) {
+        return this.extensions.includes(extension.toLowerCase());
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/parsers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/parsers/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAgB,SAAS;IAiB7B;;;OAGG;IACH,YAAY,CAAC,OAAe,EAAE,UAAkB;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC7D,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,2DAA2D;IAC3D,OAAO,CAAC,SAAiB;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,6 @@
+export { RefParser } from './base.js';
+export { MarkdownRefParser } from './markdown-parser.js';
+export { TypeScriptRefParser } from './typescript-parser.js';
+export { YamlRefParser } from './yaml-parser.js';
+export { createRefParserRegistry, findParser } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/parsers/index.js

@@ -0,0 +1,6 @@
+export { RefParser } from './base.js';
+export { MarkdownRefParser } from './markdown-parser.js';
+export { TypeScriptRefParser } from './typescript-parser.js';
+export { YamlRefParser } from './yaml-parser.js';
+export { createRefParserRegistry, findParser } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/parsers/markdown-parser.d.ts

@@ -0,0 +1,12 @@
+import { RefParser } from './base.js';
+/**
+ * Parser for Markdown files. Identifier = heading text (any level).
+ */
+export declare class MarkdownRefParser extends RefParser {
+    readonly extensions: string[];
+    extractIdentifiers(content: string, matching?: string): Array<{
+        identifier: string;
+        block: string;
+    }>;
+}
+//# sourceMappingURL=markdown-parser.d.ts.map

package/dist/parsers/markdown-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/markdown-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,UAAU,WAAwB;IAE3C,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAkCrG"}

package/dist/parsers/markdown-parser.js

@@ -0,0 +1,37 @@
+import { RefParser } from './base.js';
+/**
+ * Parser for Markdown files. Identifier = heading text (any level).
+ */
+export class MarkdownRefParser extends RefParser {
+    extensions = ['.md', '.markdown'];
+    extractIdentifiers(content, matching) {
+        const results = [];
+        const lines = content.split('\n');
+        // Find all headings with their positions and levels
+        const headings = [];
+        for (let i = 0; i < lines.length; i++) {
+            const m = lines[i].match(/^(#{1,6})\s+(.+)$/);
+            if (m) {
+                headings.push({ text: m[2].trim(), level: m[1].length, lineIndex: i });
+            }
+        }
+        for (let h = 0; h < headings.length; h++) {
+            const heading = headings[h];
+            // Skip if filtering and doesn't match
+            if (matching && heading.text !== matching)
+                continue;
+            // Find end: next heading at same or higher (lower number) level
+            let endLine = lines.length;
+            for (let j = h + 1; j < headings.length; j++) {
+                if (headings[j].level <= heading.level) {
+                    endLine = headings[j].lineIndex;
+                    break;
+                }
+            }
+            const block = lines.slice(heading.lineIndex, endLine).join('\n');
+            results.push({ identifier: heading.text, block });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=markdown-parser.js.map

package/dist/parsers/markdown-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.js","sourceRoot":"","sources":["../../src/parsers/markdown-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IACrC,UAAU,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAE3C,kBAAkB,CAAC,OAAe,EAAE,QAAiB;QACnD,MAAM,OAAO,GAAiD,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,oDAAoD;QACpD,MAAM,QAAQ,GAA8D,EAAE,CAAC;QAC/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC/C,IAAI,CAAC,EAAE,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YAE7B,sCAAsC;YACtC,IAAI,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAEpD,gEAAgE;YAChE,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBACxC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;oBACjC,MAAM;gBACR,CAAC;YACH,CAAC;YAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/parsers/registry.d.ts

@@ -0,0 +1,11 @@
+import type { RefParser } from './base.js';
+/**
+ * Create the built-in ref parser registry (DEC-10.3).
+ */
+export declare function createRefParserRegistry(): RefParser[];
+/**
+ * Find a parser that handles the given file extension.
+ * Returns undefined for unknown extensions (graceful degradation, DEC-10.15).
+ */
+export declare function findParser(extension: string, parsers: RefParser[]): RefParser | undefined;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/parsers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK3C;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,EAAE,CAMrD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,CAEzF"}

package/dist/parsers/registry.js

@@ -0,0 +1,21 @@
+import { MarkdownRefParser } from './markdown-parser.js';
+import { TypeScriptRefParser } from './typescript-parser.js';
+import { YamlRefParser } from './yaml-parser.js';
+/**
+ * Create the built-in ref parser registry (DEC-10.3).
+ */
+export function createRefParserRegistry() {
+    return [
+        new MarkdownRefParser(),
+        new TypeScriptRefParser(),
+        new YamlRefParser(),
+    ];
+}
+/**
+ * Find a parser that handles the given file extension.
+ * Returns undefined for unknown extensions (graceful degradation, DEC-10.15).
+ */
+export function findParser(extension, parsers) {
+    return parsers.find(p => p.handles(extension));
+}
+//# sourceMappingURL=registry.js.map

package/dist/parsers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/parsers/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,IAAI,iBAAiB,EAAE;QACvB,IAAI,mBAAmB,EAAE;QACzB,IAAI,aAAa,EAAE;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,OAAoB;IAChE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/parsers/typescript-parser.d.ts

@@ -0,0 +1,12 @@
+import { RefParser } from './base.js';
+/**
+ * Parser for TypeScript/JavaScript files. Identifier = class/function name.
+ */
+export declare class TypeScriptRefParser extends RefParser {
+    readonly extensions: string[];
+    extractIdentifiers(content: string, matching?: string): Array<{
+        identifier: string;
+        block: string;
+    }>;
+}
+//# sourceMappingURL=typescript-parser.d.ts.map

package/dist/parsers/typescript-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/typescript-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,QAAQ,CAAC,UAAU,WAAkC;IAErD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAkDrG"}

package/dist/parsers/typescript-parser.js

@@ -0,0 +1,74 @@
+import { RefParser } from './base.js';
+/**
+ * Parser for TypeScript/JavaScript files. Identifier = class/function name.
+ */
+export class TypeScriptRefParser extends RefParser {
+    extensions = ['.ts', '.tsx', '.js', '.jsx'];
+    extractIdentifiers(content, matching) {
+        const results = [];
+        // Patterns that capture the identifier name
+        const patterns = [
+            /(?:export\s+)?(?:abstract\s+)?class\s+(\w+)/gm,
+            /(?:export\s+)?interface\s+(\w+)/gm,
+            /(?:export\s+)?type\s+(\w+)/gm,
+            /(?:export\s+)?(?:async\s+)?function\s+(\w+)/gm,
+            /(?:export\s+)?(?:const|let|var)\s+(\w+)\s*[=:]/gm,
+        ];
+        // Destructured imports/requires (T4)
+        const destructuredPattern = /(?:const|let|var)\s*\{([^}]+)\}\s*=\s*require/gm;
+        const seen = new Set(); // Avoid duplicates
+        for (const pattern of patterns) {
+            let match;
+            while ((match = pattern.exec(content)) !== null) {
+                const name = match[1];
+                if (seen.has(name))
+                    continue;
+                if (matching && name !== matching)
+                    continue;
+                seen.add(name);
+                const block = extractBraceBlock(content, match.index);
+                results.push({ identifier: name, block });
+            }
+        }
+        // Extract destructured names from require statements
+        {
+            let match;
+            while ((match = destructuredPattern.exec(content)) !== null) {
+                const names = match[1].split(',').map(s => s.trim().split(/\s+as\s+/).pop().trim()).filter(Boolean);
+                for (const name of names) {
+                    if (seen.has(name))
+                        continue;
+                    if (matching && name !== matching)
+                        continue;
+                    seen.add(name);
+                    // Use the full require statement as the block
+                    const lineStart = content.lastIndexOf('\n', match.index) + 1;
+                    const lineEnd = content.indexOf('\n', match.index + match[0].length);
+                    const block = content.substring(lineStart, lineEnd === -1 ? content.length : lineEnd);
+                    results.push({ identifier: name, block });
+                }
+            }
+        }
+        return results;
+    }
+}
+function extractBraceBlock(content, startIndex) {
+    let depth = 0;
+    let started = false;
+    let end = content.length;
+    for (let i = startIndex; i < content.length; i++) {
+        if (content[i] === '{') {
+            depth++;
+            started = true;
+        }
+        else if (content[i] === '}') {
+            depth--;
+            if (started && depth === 0) {
+                end = i + 1;
+                break;
+            }
+        }
+    }
+    return content.substring(startIndex, end);
+}
+//# sourceMappingURL=typescript-parser.js.map

package/dist/parsers/typescript-parser.js.map

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

package/dist/parsers/yaml-parser.d.ts

@@ -0,0 +1,12 @@
+import { RefParser } from './base.js';
+/**
+ * Parser for YAML files. Identifier = top-level key.
+ */
+export declare class YamlRefParser extends RefParser {
+    readonly extensions: string[];
+    extractIdentifiers(content: string, matching?: string): Array<{
+        identifier: string;
+        block: string;
+    }>;
+}
+//# sourceMappingURL=yaml-parser.d.ts.map