@lapidist/dtif-parser 0.2.0

package/dist/diagnostics/bag.js

@@ -0,0 +1,101 @@
+import { compareDiagnosticSeverity } from './severity.js';
+export class DiagnosticBag {
+    diagnostics = [];
+    counts = {
+        error: 0,
+        warning: 0,
+        info: 0
+    };
+    constructor(initial) {
+        if (initial) {
+            this.addMany(initial);
+        }
+    }
+    get size() {
+        return this.diagnostics.length;
+    }
+    get isEmpty() {
+        return this.size === 0;
+    }
+    hasSeverity(severity) {
+        return this.counts[severity] > 0;
+    }
+    hasErrors() {
+        return this.counts.error > 0;
+    }
+    get errorCount() {
+        return this.counts.error;
+    }
+    get warningCount() {
+        return this.counts.warning;
+    }
+    get infoCount() {
+        return this.counts.info;
+    }
+    count(severity) {
+        if (!severity) {
+            return this.size;
+        }
+        return this.counts[severity];
+    }
+    highestSeverity() {
+        let highest;
+        for (const diagnostic of this.diagnostics) {
+            if (!highest || compareDiagnosticSeverity(diagnostic.severity, highest) < 0) {
+                highest = diagnostic.severity;
+                if (highest === 'error') {
+                    break;
+                }
+            }
+        }
+        return highest;
+    }
+    add(diagnostic) {
+        const normalized = freezeDiagnostic(diagnostic);
+        this.diagnostics.push(normalized);
+        this.counts[normalized.severity]++;
+        return this;
+    }
+    addMany(diagnostics) {
+        for (const diagnostic of diagnostics) {
+            this.add(diagnostic);
+        }
+        return this;
+    }
+    extend(other) {
+        if (other instanceof DiagnosticBag) {
+            return this.addMany(other.diagnostics);
+        }
+        return this.addMany(other);
+    }
+    clear() {
+        this.diagnostics.length = 0;
+        this.counts.error = 0;
+        this.counts.warning = 0;
+        this.counts.info = 0;
+    }
+    toArray() {
+        return this.diagnostics.slice();
+    }
+    [Symbol.iterator]() {
+        return this.diagnostics[Symbol.iterator]();
+    }
+    forEach(callback) {
+        this.diagnostics.forEach(callback);
+    }
+    filter(predicate) {
+        return this.diagnostics.filter(predicate);
+    }
+    toJSON() {
+        return this.toArray();
+    }
+}
+function freezeDiagnostic(diagnostic) {
+    const related = diagnostic.related?.map((info) => Object.freeze({ ...info }));
+    const normalized = {
+        ...diagnostic,
+        related: related ? Object.freeze(related) : undefined
+    };
+    return Object.freeze(normalized);
+}
+//# sourceMappingURL=bag.js.map

package/dist/diagnostics/bag.js.map

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

package/dist/diagnostics/codes.d.ts

@@ -0,0 +1,72 @@
+export type DiagnosticCode = `DTIF${number}${number}${number}${number}`;
+export declare const DiagnosticDomain: {
+    readonly Core: 0;
+    readonly Resolver: 1;
+    readonly Loader: 2;
+    readonly Decoder: 3;
+    readonly SchemaGuard: 4;
+    readonly Normaliser: 5;
+    readonly Graph: 6;
+    readonly Outputs: 7;
+    readonly Plugins: 8;
+};
+export type DiagnosticDomainKey = keyof typeof DiagnosticDomain;
+export type DiagnosticDomainValue = (typeof DiagnosticDomain)[DiagnosticDomainKey];
+export type DiagnosticDomainInput = DiagnosticDomainKey | DiagnosticDomainValue;
+export declare function isDiagnosticCode(value: unknown): value is DiagnosticCode;
+export declare function formatDiagnosticCode(domain: DiagnosticDomainInput, major: number, minor?: number): DiagnosticCode;
+export declare const DiagnosticCodes: {
+    readonly core: {
+        readonly INTERNAL_ERROR: `DTIF${number}${number}${number}${number}`;
+        readonly NOT_IMPLEMENTED: `DTIF${number}${number}${number}${number}`;
+        readonly CACHE_FAILED: `DTIF${number}${number}${number}${number}`;
+    };
+    readonly loader: {
+        readonly FAILED: `DTIF${number}${number}${number}${number}`;
+        readonly TOO_LARGE: `DTIF${number}${number}${number}${number}`;
+    };
+    readonly decoder: {
+        readonly FAILED: `DTIF${number}${number}${number}${number}`;
+    };
+    readonly schemaGuard: {
+        readonly FAILED: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_DOCUMENT: `DTIF${number}${number}${number}${number}`;
+    };
+    readonly normaliser: {
+        readonly FAILED: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_ROOT: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_NODE: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_MEMBER_TYPE: `DTIF${number}${number}${number}${number}`;
+        readonly MISSING_VALUE: `DTIF${number}${number}${number}${number}`;
+        readonly MISSING_ALIAS_TARGET: `DTIF${number}${number}${number}${number}`;
+        readonly ALIAS_MISSING_TYPE: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_OVERRIDE: `DTIF${number}${number}${number}${number}`;
+        readonly MISSING_REQUIRED_MEMBER: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_EXTENSIONS: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_METADATA_COMBINATION: `DTIF${number}${number}${number}${number}`;
+    };
+    readonly graph: {
+        readonly FAILED: `DTIF${number}${number}${number}${number}`;
+        readonly DUPLICATE_POINTER: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_REFERENCE: `DTIF${number}${number}${number}${number}`;
+        readonly MISSING_TARGET: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_TARGET_KIND: `DTIF${number}${number}${number}${number}`;
+    };
+    readonly resolver: {
+        readonly FAILED: `DTIF${number}${number}${number}${number}`;
+        readonly UNKNOWN_POINTER: `DTIF${number}${number}${number}${number}`;
+        readonly INVALID_NODE_KIND: `DTIF${number}${number}${number}${number}`;
+        readonly CYCLE_DETECTED: `DTIF${number}${number}${number}${number}`;
+        readonly EXTERNAL_REFERENCE: `DTIF${number}${number}${number}${number}`;
+        readonly MISSING_BASE_VALUE: `DTIF${number}${number}${number}${number}`;
+        readonly TARGET_TYPE_MISMATCH: `DTIF${number}${number}${number}${number}`;
+        readonly FALLBACK_EXHAUSTED: `DTIF${number}${number}${number}${number}`;
+        readonly OVERRIDE_FAILED: `DTIF${number}${number}${number}${number}`;
+        readonly MAX_DEPTH_EXCEEDED: `DTIF${number}${number}${number}${number}`;
+    };
+    readonly plugins: {
+        readonly EXTENSION_FAILED: `DTIF${number}${number}${number}${number}`;
+        readonly RESOLUTION_FAILED: `DTIF${number}${number}${number}${number}`;
+    };
+};
+//# sourceMappingURL=codes.d.ts.map

package/dist/diagnostics/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/diagnostics/codes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,OAAO,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAIxE,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC;AACnF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAEhF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,SAAI,GACR,cAAc,CAYhB;AAoBD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDuC,CAAC"}

package/dist/diagnostics/codes.js

@@ -0,0 +1,94 @@
+const DIAGNOSTIC_CODE_PATTERN = /^DTIF\d{4}$/u;
+export const DiagnosticDomain = {
+    Core: 0,
+    Resolver: 1,
+    Loader: 2,
+    Decoder: 3,
+    SchemaGuard: 4,
+    Normaliser: 5,
+    Graph: 6,
+    Outputs: 7,
+    Plugins: 8
+};
+export function isDiagnosticCode(value) {
+    return typeof value === 'string' && DIAGNOSTIC_CODE_PATTERN.test(value);
+}
+export function formatDiagnosticCode(domain, major, minor = 0) {
+    const domainValue = resolveDiagnosticDomain(domain);
+    assertIntegerInRange(domainValue, 0, 9, 'domain');
+    assertIntegerInRange(major, 0, 99, 'major');
+    assertIntegerInRange(minor, 0, 9, 'minor');
+    const domainPart = String(domainValue);
+    const majorPart = major.toString().padStart(2, '0');
+    const minorPart = String(minor);
+    return `DTIF${domainPart}${majorPart}${minorPart}`;
+}
+function resolveDiagnosticDomain(domain) {
+    if (typeof domain === 'number') {
+        return domain;
+    }
+    if (domain in DiagnosticDomain) {
+        return DiagnosticDomain[domain];
+    }
+    throw new RangeError(`Unknown diagnostic domain: ${String(domain)}`);
+}
+function assertIntegerInRange(value, min, max, label) {
+    if (!Number.isInteger(value) || value < min || value > max) {
+        throw new RangeError(`${label} must be an integer in the range [${min}, ${max}]`);
+    }
+}
+export const DiagnosticCodes = {
+    core: {
+        INTERNAL_ERROR: formatDiagnosticCode('Core', 0, 0),
+        NOT_IMPLEMENTED: formatDiagnosticCode('Core', 0, 1),
+        CACHE_FAILED: formatDiagnosticCode('Core', 0, 2)
+    },
+    loader: {
+        FAILED: formatDiagnosticCode('Loader', 0, 0),
+        TOO_LARGE: formatDiagnosticCode('Loader', 0, 1)
+    },
+    decoder: {
+        FAILED: formatDiagnosticCode('Decoder', 0, 0)
+    },
+    schemaGuard: {
+        FAILED: formatDiagnosticCode('SchemaGuard', 0, 0),
+        INVALID_DOCUMENT: formatDiagnosticCode('SchemaGuard', 1, 0)
+    },
+    normaliser: {
+        FAILED: formatDiagnosticCode('Normaliser', 0, 0),
+        INVALID_ROOT: formatDiagnosticCode('Normaliser', 1, 0),
+        INVALID_NODE: formatDiagnosticCode('Normaliser', 1, 1),
+        INVALID_MEMBER_TYPE: formatDiagnosticCode('Normaliser', 1, 2),
+        MISSING_VALUE: formatDiagnosticCode('Normaliser', 2, 0),
+        MISSING_ALIAS_TARGET: formatDiagnosticCode('Normaliser', 2, 1),
+        ALIAS_MISSING_TYPE: formatDiagnosticCode('Normaliser', 2, 2),
+        INVALID_OVERRIDE: formatDiagnosticCode('Normaliser', 3, 0),
+        MISSING_REQUIRED_MEMBER: formatDiagnosticCode('Normaliser', 3, 1),
+        INVALID_EXTENSIONS: formatDiagnosticCode('Normaliser', 4, 0),
+        INVALID_METADATA_COMBINATION: formatDiagnosticCode('Normaliser', 4, 1)
+    },
+    graph: {
+        FAILED: formatDiagnosticCode('Graph', 0, 0),
+        DUPLICATE_POINTER: formatDiagnosticCode('Graph', 1, 0),
+        INVALID_REFERENCE: formatDiagnosticCode('Graph', 1, 1),
+        MISSING_TARGET: formatDiagnosticCode('Graph', 1, 2),
+        INVALID_TARGET_KIND: formatDiagnosticCode('Graph', 1, 3)
+    },
+    resolver: {
+        FAILED: formatDiagnosticCode('Resolver', 0, 0),
+        UNKNOWN_POINTER: formatDiagnosticCode('Resolver', 1, 0),
+        INVALID_NODE_KIND: formatDiagnosticCode('Resolver', 1, 1),
+        CYCLE_DETECTED: formatDiagnosticCode('Resolver', 1, 2),
+        EXTERNAL_REFERENCE: formatDiagnosticCode('Resolver', 1, 3),
+        MISSING_BASE_VALUE: formatDiagnosticCode('Resolver', 2, 0),
+        TARGET_TYPE_MISMATCH: formatDiagnosticCode('Resolver', 2, 1),
+        FALLBACK_EXHAUSTED: formatDiagnosticCode('Resolver', 3, 0),
+        OVERRIDE_FAILED: formatDiagnosticCode('Resolver', 3, 1),
+        MAX_DEPTH_EXCEEDED: formatDiagnosticCode('Resolver', 4, 0)
+    },
+    plugins: {
+        EXTENSION_FAILED: formatDiagnosticCode('Plugins', 0, 0),
+        RESOLUTION_FAILED: formatDiagnosticCode('Plugins', 0, 1)
+    }
+};
+//# sourceMappingURL=codes.js.map

package/dist/diagnostics/codes.js.map

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

package/dist/diagnostics/severity.d.ts

@@ -0,0 +1,8 @@
+export declare const DIAGNOSTIC_SEVERITIES: readonly ["error", "warning", "info"];
+export type DiagnosticSeverity = (typeof DIAGNOSTIC_SEVERITIES)[number];
+export declare function isDiagnosticSeverity(value: unknown): value is DiagnosticSeverity;
+export declare function compareDiagnosticSeverity(a: DiagnosticSeverity, b: DiagnosticSeverity): number;
+export declare function maxDiagnosticSeverity(...severities: readonly DiagnosticSeverity[]): DiagnosticSeverity | undefined;
+export declare function minDiagnosticSeverity(...severities: readonly DiagnosticSeverity[]): DiagnosticSeverity | undefined;
+export declare function severityWeight(severity: DiagnosticSeverity): number;
+//# sourceMappingURL=severity.d.ts.map

package/dist/diagnostics/severity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.d.ts","sourceRoot":"","sources":["../../src/diagnostics/severity.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,uCAAwC,CAAC;AAE3E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAUxE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAE9F;AAED,wBAAgB,qBAAqB,CACnC,GAAG,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAC3C,kBAAkB,GAAG,SAAS,CAUhC;AAED,wBAAgB,qBAAqB,CACnC,GAAG,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAC3C,kBAAkB,GAAG,SAAS,CAUhC;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAEnE"}

package/dist/diagnostics/severity.js

@@ -0,0 +1,35 @@
+export const DIAGNOSTIC_SEVERITIES = ['error', 'warning', 'info'];
+const SEVERITY_TO_WEIGHT = {
+    error: 0,
+    warning: 1,
+    info: 2
+};
+const SEVERITY_SET = new Set(DIAGNOSTIC_SEVERITIES);
+export function isDiagnosticSeverity(value) {
+    return typeof value === 'string' && SEVERITY_SET.has(value);
+}
+export function compareDiagnosticSeverity(a, b) {
+    return SEVERITY_TO_WEIGHT[a] - SEVERITY_TO_WEIGHT[b];
+}
+export function maxDiagnosticSeverity(...severities) {
+    let max;
+    for (const severity of severities) {
+        if (!max || compareDiagnosticSeverity(severity, max) < 0) {
+            max = severity;
+        }
+    }
+    return max;
+}
+export function minDiagnosticSeverity(...severities) {
+    let min;
+    for (const severity of severities) {
+        if (!min || compareDiagnosticSeverity(severity, min) > 0) {
+            min = severity;
+        }
+    }
+    return min;
+}
+export function severityWeight(severity) {
+    return SEVERITY_TO_WEIGHT[severity];
+}
+//# sourceMappingURL=severity.js.map

package/dist/diagnostics/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../src/diagnostics/severity.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAI3E,MAAM,kBAAkB,GAAuC;IAC7D,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAqB,qBAAqB,CAAC,CAAC;AAExE,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,KAA2B,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,CAAqB,EAAE,CAAqB;IACpF,OAAO,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,GAAG,UAAyC;IAE5C,IAAI,GAAmC,CAAC;IAExC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,IAAI,yBAAyB,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzD,GAAG,GAAG,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,GAAG,UAAyC;IAE5C,IAAI,GAAmC,CAAC;IAExC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,IAAI,yBAAyB,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzD,GAAG,GAAG,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAA4B;IACzD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/graph/builder/context.d.ts

@@ -0,0 +1,23 @@
+import type { Diagnostic, JsonPointer, SourceSpan } from '../../types.js';
+import type { DocumentAst, DocumentGraph, GraphNode } from '../nodes.js';
+export interface GraphBuilderResult {
+    readonly graph?: DocumentGraph;
+    readonly diagnostics: readonly Diagnostic[];
+}
+export interface GraphBuilderContext {
+    readonly ast: DocumentAst;
+    readonly diagnostics: Diagnostic[];
+    readonly nodes: Map<JsonPointer, GraphNode>;
+    readonly pendingReferences: PendingInternalReference[];
+}
+export interface PendingInternalReference {
+    readonly fieldPointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly target: JsonPointer;
+    readonly allowedKinds: readonly GraphNode['kind'][];
+    readonly label: string;
+}
+export declare function createGraphBuilderContext(ast: DocumentAst): GraphBuilderContext;
+export declare function finalizeResult(context: GraphBuilderContext, graph: DocumentGraph | undefined): GraphBuilderResult;
+export declare function recordFailure(context: GraphBuilderContext, error: unknown): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/graph/builder/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/graph/builder/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,mBAAmB,CAO/E;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,kBAAkB,CAUpB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAOhF"}

package/dist/graph/builder/context.js

@@ -0,0 +1,29 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { JSON_POINTER_ROOT } from '../../utils/json-pointer.js';
+const EMPTY_DIAGNOSTICS = Object.freeze([]);
+export function createGraphBuilderContext(ast) {
+    return {
+        ast,
+        diagnostics: [],
+        nodes: new Map(),
+        pendingReferences: []
+    };
+}
+export function finalizeResult(context, graph) {
+    const diagnostics = context.diagnostics.length === 0
+        ? EMPTY_DIAGNOSTICS
+        : Object.freeze(context.diagnostics.map((diagnostic) => Object.freeze(diagnostic)));
+    return {
+        graph,
+        diagnostics
+    };
+}
+export function recordFailure(context, error) {
+    context.diagnostics.push({
+        code: DiagnosticCodes.graph.FAILED,
+        message: error instanceof Error ? error.message : 'Failed to build document graph.',
+        severity: 'error',
+        pointer: JSON_POINTER_ROOT
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/graph/builder/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/graph/builder/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAsBhE,MAAM,iBAAiB,GAA0B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEnE,MAAM,UAAU,yBAAyB,CAAC,GAAgB;IACxD,OAAO;QACL,GAAG;QACH,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,iBAAiB,EAAE,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAA4B,EAC5B,KAAgC;IAEhC,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAC9B,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAExF,OAAO;QACL,KAAK;QACL,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA4B,EAAE,KAAc;IACxE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QACvB,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM;QAClC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC;QACnF,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,iBAAiB;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/graph/builder/nodes.d.ts

@@ -0,0 +1,6 @@
+import type { JsonPointer } from '../../types.js';
+import type { DocumentChildNode, GraphNode } from '../nodes.js';
+import type { GraphBuilderContext } from './context.js';
+export declare function buildNodes(context: GraphBuilderContext, children: readonly DocumentChildNode[], parentPointer: JsonPointer): readonly JsonPointer[];
+export declare function createGraphNode(context: GraphBuilderContext, child: DocumentChildNode, parentPointer: JsonPointer): GraphNode | undefined;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/graph/builder/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/graph/builder/nodes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,iBAAiB,EAEjB,SAAS,EAGV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMxD,wBAAgB,UAAU,CACxB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,aAAa,EAAE,WAAW,GACzB,SAAS,WAAW,EAAE,CAexB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,iBAAiB,EACxB,aAAa,EAAE,WAAW,GACzB,SAAS,GAAG,SAAS,CAqCvB"}

package/dist/graph/builder/nodes.js

@@ -0,0 +1,85 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { splitJsonPointer } from '../../utils/json-pointer.js';
+import { createReferenceField, NON_COLLECTION_NODE_KINDS } from './references.js';
+const EMPTY_POINTERS = Object.freeze([]);
+export function buildNodes(context, children, parentPointer) {
+    if (children.length === 0) {
+        return EMPTY_POINTERS;
+    }
+    const childPointers = [];
+    for (const child of children) {
+        const node = createGraphNode(context, child, parentPointer);
+        if (node) {
+            childPointers.push(node.pointer);
+        }
+    }
+    return childPointers.length === 0 ? EMPTY_POINTERS : Object.freeze(childPointers);
+}
+export function createGraphNode(context, child, parentPointer) {
+    if (context.nodes.has(child.pointer)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.graph.DUPLICATE_POINTER,
+            message: `Duplicate node pointer "${child.pointer}" detected.`,
+            severity: 'error',
+            pointer: child.pointer,
+            span: child.span
+        });
+        return undefined;
+    }
+    let node;
+    switch (child.kind) {
+        case 'collection': {
+            const base = createBaseNode(child, parentPointer);
+            node = createCollectionNode(context, child, base);
+            break;
+        }
+        case 'token': {
+            const base = createBaseNode(child, parentPointer);
+            node = createTokenNode(child, base);
+            break;
+        }
+        case 'alias': {
+            const base = createBaseNode(child, parentPointer);
+            node = createAliasNode(context, child, base);
+            break;
+        }
+    }
+    if (node) {
+        context.nodes.set(node.pointer, node);
+    }
+    return node;
+}
+function createBaseNode(child, parentPointer) {
+    return Object.freeze({
+        kind: child.kind,
+        name: child.name,
+        pointer: child.pointer,
+        span: child.span,
+        path: Object.freeze(splitJsonPointer(child.pointer)),
+        parent: parentPointer,
+        metadata: child.metadata
+    });
+}
+function createCollectionNode(context, collection, base) {
+    const children = buildNodes(context, collection.children, collection.pointer);
+    return Object.freeze({ ...base, children });
+}
+function createTokenNode(token, base) {
+    return Object.freeze({
+        ...base,
+        type: token.type,
+        value: token.value
+    });
+}
+function createAliasNode(context, alias, base) {
+    const ref = createReferenceField(context, alias.ref, 'alias $ref', NON_COLLECTION_NODE_KINDS);
+    if (!ref) {
+        return undefined;
+    }
+    return Object.freeze({
+        ...base,
+        type: alias.type,
+        ref
+    });
+}
+//# sourceMappingURL=nodes.js.map

package/dist/graph/builder/nodes.js.map

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

package/dist/graph/builder/overrides.d.ts

@@ -0,0 +1,5 @@
+import type { OverrideNode } from '../../ast/nodes.js';
+import type { GraphOverrideNode } from '../nodes.js';
+import type { GraphBuilderContext } from './context.js';
+export declare function buildOverrides(context: GraphBuilderContext, overrides: readonly OverrideNode[]): readonly GraphOverrideNode[];
+//# sourceMappingURL=overrides.d.ts.map

package/dist/graph/builder/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../src/graph/builder/overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAA6B,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAKxD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,SAAS,YAAY,EAAE,GACjC,SAAS,iBAAiB,EAAE,CAe9B"}

package/dist/graph/builder/overrides.js

@@ -0,0 +1,62 @@
+import { createReferenceField, NON_COLLECTION_NODE_KINDS } from './references.js';
+const EMPTY_OVERRIDES = Object.freeze([]);
+export function buildOverrides(context, overrides) {
+    if (overrides.length === 0) {
+        return EMPTY_OVERRIDES;
+    }
+    const result = [];
+    for (const override of overrides) {
+        const node = createOverrideNode(context, override);
+        if (node) {
+            result.push(node);
+        }
+    }
+    return result.length === 0 ? EMPTY_OVERRIDES : Object.freeze(result);
+}
+function createOverrideNode(context, override) {
+    const tokenRef = createReferenceField(context, override.token, 'override $token', NON_COLLECTION_NODE_KINDS);
+    if (!tokenRef) {
+        return undefined;
+    }
+    const ref = createReferenceField(context, override.ref, 'override $ref', NON_COLLECTION_NODE_KINDS);
+    const fallback = buildFallbackChain(context, override.fallback);
+    return Object.freeze({
+        kind: 'override',
+        pointer: override.pointer,
+        span: override.span,
+        token: tokenRef,
+        when: override.when,
+        ref,
+        value: override.value,
+        fallback
+    });
+}
+function buildFallbackChain(context, fallback) {
+    if (!fallback || fallback.length === 0) {
+        return undefined;
+    }
+    const nodes = [];
+    for (const entry of fallback) {
+        const node = createFallbackNode(context, entry);
+        if (node) {
+            nodes.push(node);
+        }
+    }
+    return nodes.length === 0 ? undefined : Object.freeze(nodes);
+}
+function createFallbackNode(context, fallback) {
+    const ref = createReferenceField(context, fallback.ref, 'fallback $ref', NON_COLLECTION_NODE_KINDS);
+    const nested = buildFallbackChain(context, fallback.fallback);
+    if (!ref && !fallback.value) {
+        return undefined;
+    }
+    return Object.freeze({
+        kind: 'fallback',
+        pointer: fallback.pointer,
+        span: fallback.span,
+        ref,
+        value: fallback.value,
+        fallback: nested
+    });
+}
+//# sourceMappingURL=overrides.js.map

package/dist/graph/builder/overrides.js.map

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

package/dist/graph/builder/references.d.ts

@@ -0,0 +1,7 @@
+import type { AstField } from '../../ast/nodes.js';
+import type { GraphReferenceField, GraphNode } from '../nodes.js';
+import type { GraphBuilderContext } from './context.js';
+export declare const NON_COLLECTION_NODE_KINDS: readonly GraphNode['kind'][];
+export declare function createReferenceField(context: GraphBuilderContext, field: AstField<string> | undefined, label: string, allowedKinds: readonly GraphNode['kind'][]): GraphReferenceField | undefined;
+export declare function validatePendingReferences(context: GraphBuilderContext): void;
+//# sourceMappingURL=references.d.ts.map

package/dist/graph/builder/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../src/graph/builder/references.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAwB,SAAS,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,yBAAyB,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAGhE,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,EACnC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,GACzC,mBAAmB,GAAG,SAAS,CAyBjC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAyB5E"}