@lapidist/dtif-parser 0.2.0

package/dist/graph/builder/references.js

@@ -0,0 +1,93 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { JSON_POINTER_ROOT, normalizeJsonPointer, isJsonPointer } from '../../utils/json-pointer.js';
+export const NON_COLLECTION_NODE_KINDS = Object.freeze([
+    'token',
+    'alias'
+]);
+export function createReferenceField(context, field, label, allowedKinds) {
+    if (!field) {
+        return undefined;
+    }
+    const target = resolveReferenceTarget(context, field, label);
+    if (!target) {
+        return undefined;
+    }
+    if (!target.external) {
+        context.pendingReferences.push({
+            fieldPointer: field.pointer,
+            span: field.span,
+            target: target.pointer,
+            allowedKinds,
+            label
+        });
+    }
+    return Object.freeze({
+        value: target,
+        pointer: field.pointer,
+        span: field.span
+    });
+}
+export function validatePendingReferences(context) {
+    for (const reference of context.pendingReferences) {
+        const target = context.nodes.get(reference.target);
+        if (!target) {
+            context.diagnostics.push({
+                code: DiagnosticCodes.graph.MISSING_TARGET,
+                message: `${reference.label} target "${reference.target}" does not exist in the document.`,
+                severity: 'error',
+                pointer: reference.fieldPointer,
+                span: reference.span
+            });
+            continue;
+        }
+        if (!reference.allowedKinds.includes(target.kind)) {
+            const expected = reference.allowedKinds.join(' or ');
+            context.diagnostics.push({
+                code: DiagnosticCodes.graph.INVALID_TARGET_KIND,
+                message: `${reference.label} target "${reference.target}" is a ${target.kind} node but expected ${expected}.`,
+                severity: 'error',
+                pointer: reference.fieldPointer,
+                span: reference.span
+            });
+        }
+    }
+}
+function resolveReferenceTarget(context, field, label) {
+    const raw = field.value;
+    let resolved;
+    try {
+        resolved = new URL(raw, context.ast.uri);
+    }
+    catch (error) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.graph.INVALID_REFERENCE,
+            message: `${label} "${raw}" is not a valid URL or JSON Pointer.`,
+            severity: 'error',
+            pointer: field.pointer,
+            span: field.span
+        });
+        return undefined;
+    }
+    const fragment = resolved.hash ?? '';
+    const pointerValue = fragment.length === 0 ? JSON_POINTER_ROOT : fragment;
+    if (!isJsonPointer(pointerValue)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.graph.INVALID_REFERENCE,
+            message: `${label} "${raw}" does not resolve to a valid JSON Pointer.`,
+            severity: 'error',
+            pointer: field.pointer,
+            span: field.span
+        });
+        return undefined;
+    }
+    const pointer = normalizeJsonPointer(pointerValue);
+    const targetUri = new URL(resolved.href);
+    targetUri.hash = '';
+    const external = targetUri.href !== context.ast.uri.href;
+    return Object.freeze({
+        uri: targetUri,
+        pointer,
+        external
+    });
+}
+//# sourceMappingURL=references.js.map

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

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

package/dist/graph/builder.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentAst } from './nodes.js';
+import { type GraphBuilderResult } from './builder/context.js';
+export type { GraphBuilderResult } from './builder/context.js';
+export declare function buildDocumentGraph(ast: DocumentAst): GraphBuilderResult;
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/graph/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAoC,MAAM,YAAY,CAAC;AAEhF,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAK9B,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,kBAAkB,CAavE"}

package/dist/graph/builder.js

@@ -0,0 +1,30 @@
+import { createGraphBuilderContext, finalizeResult, recordFailure } from './builder/context.js';
+import { buildNodes } from './builder/nodes.js';
+import { buildOverrides } from './builder/overrides.js';
+import { validatePendingReferences } from './builder/references.js';
+export function buildDocumentGraph(ast) {
+    const context = createGraphBuilderContext(ast);
+    try {
+        const rootPointers = buildNodes(context, ast.children, ast.pointer);
+        const overrides = buildOverrides(context, ast.overrides);
+        validatePendingReferences(context);
+        const graph = createDocumentGraph(context, rootPointers, overrides);
+        return finalizeResult(context, graph);
+    }
+    catch (error) {
+        recordFailure(context, error);
+        return finalizeResult(context, undefined);
+    }
+}
+function createDocumentGraph(context, rootPointers, overrides) {
+    const nodes = new Map(context.nodes);
+    return Object.freeze({
+        kind: 'document-graph',
+        uri: context.ast.uri,
+        ast: context.ast,
+        nodes,
+        rootPointers,
+        overrides
+    });
+}
+//# sourceMappingURL=builder.js.map

package/dist/graph/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/graph/builder.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,aAAa,EAGd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAIpE,MAAM,UAAU,kBAAkB,CAAC,GAAgB;IACjD,MAAM,OAAO,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACzD,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QACpE,OAAO,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAA4B,EAC5B,YAAoC,EACpC,SAAuC;IAEvC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK;QACL,YAAY;QACZ,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/graph/nodes.d.ts

@@ -0,0 +1,60 @@
+import type { AliasNode, AstField, CollectionNode, DocumentAst, DocumentChildNode, NodeMetadata, OverrideFallbackNode, OverrideNode, TokenNode } from '../ast/nodes.js';
+import type { JsonPointer, SourceSpan } from '../types.js';
+export type GraphNode = GraphCollectionNode | GraphTokenNode | GraphAliasNode;
+export interface GraphNodeBase {
+    readonly kind: DocumentChildNode['kind'];
+    readonly name: string;
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly path: readonly string[];
+    readonly parent?: JsonPointer;
+    readonly metadata: NodeMetadata;
+}
+export interface GraphCollectionNode extends GraphNodeBase {
+    readonly kind: CollectionNode['kind'];
+    readonly children: readonly JsonPointer[];
+}
+export interface GraphTokenNode extends GraphNodeBase {
+    readonly kind: TokenNode['kind'];
+    readonly type?: AstField<string>;
+    readonly value?: AstField<unknown>;
+}
+export interface GraphAliasNode extends GraphNodeBase {
+    readonly kind: AliasNode['kind'];
+    readonly type: AstField<string>;
+    readonly ref: GraphReferenceField;
+}
+export interface GraphReferenceTarget {
+    readonly uri: URL;
+    readonly pointer: JsonPointer;
+    readonly external: boolean;
+}
+export type GraphReferenceField = AstField<GraphReferenceTarget>;
+export interface GraphOverrideNode {
+    readonly kind: OverrideNode['kind'];
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly token: GraphReferenceField;
+    readonly when: AstField<Readonly<Record<string, unknown>>>;
+    readonly ref?: GraphReferenceField;
+    readonly value?: AstField<unknown>;
+    readonly fallback?: readonly GraphOverrideFallbackNode[];
+}
+export interface GraphOverrideFallbackNode {
+    readonly kind: OverrideFallbackNode['kind'];
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly ref?: GraphReferenceField;
+    readonly value?: AstField<unknown>;
+    readonly fallback?: readonly GraphOverrideFallbackNode[];
+}
+export interface DocumentGraph {
+    readonly kind: 'document-graph';
+    readonly uri: URL;
+    readonly ast: DocumentAst;
+    readonly nodes: ReadonlyMap<JsonPointer, GraphNode>;
+    readonly rootPointers: readonly JsonPointer[];
+    readonly overrides: readonly GraphOverrideNode[];
+}
+export type { AliasNode, CollectionNode, DocumentAst, DocumentChildNode, NodeMetadata, OverrideFallbackNode, OverrideNode, TokenNode };
+//# sourceMappingURL=nodes.d.ts.map

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

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

package/dist/graph/nodes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nodes.js.map

package/dist/graph/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/graph/nodes.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { normalizeDocument } from './ast/normaliser.js';
+export type { NormaliserResult, NormaliserOptions } from './ast/normaliser.js';
+export type { AliasNode, AstField, CollectionNode, DocumentAst, DocumentChildNode, NodeMetadata, OverrideFallbackNode, OverrideNode, TokenNode } from './ast/nodes.js';
+export { ParseSession, createSession, parseCollection, parseDocument } from './session.js';
+export type { OverrideContext, ParseSessionOptions } from './session.js';
+export { createDocumentResolver, DocumentResolver } from './resolver/index.js';
+export type { DocumentResolverOptions, ResolutionResult, ResolvedToken, ResolutionSource, AppliedOverride, AppliedOverrideKind, ResolutionTraceStep, ResolutionTraceStepKind } from './resolver/index.js';
+export { buildDocumentGraph } from './graph/builder.js';
+export type { GraphBuilderResult } from './graph/builder.js';
+export type { GraphNode, GraphNodeBase, GraphCollectionNode, GraphTokenNode, GraphAliasNode, GraphReferenceField, GraphReferenceTarget, GraphOverrideNode, GraphOverrideFallbackNode } from './graph/nodes.js';
+export { DiagnosticBag } from './diagnostics/bag.js';
+export { DiagnosticCodes, DiagnosticDomain, type DiagnosticDomainKey, type DiagnosticDomainValue, formatDiagnosticCode, isDiagnosticCode } from './diagnostics/codes.js';
+export { DIAGNOSTIC_SEVERITIES, compareDiagnosticSeverity, isDiagnosticSeverity, maxDiagnosticSeverity, minDiagnosticSeverity, severityWeight } from './diagnostics/severity.js';
+export { DefaultDocumentLoader, DocumentLoaderError } from './io/document-loader.js';
+export type { DocumentLoader, DocumentLoaderContext, DefaultDocumentLoaderOptions, DocumentLoaderErrorReason } from './io/document-loader.js';
+export { InMemoryDocumentCache } from './io/document-cache.js';
+export type { InMemoryDocumentCacheOptions } from './io/document-cache.js';
+export { SchemaGuard } from './validation/schema-guard.js';
+export type { SchemaGuardOptions, SchemaGuardResult } from './validation/schema-guard.js';
+export type { ContentType, Diagnostic, DocumentCache, DocumentGraph, DocumentHandle, JsonPointer, ParseCollectionResult, ParseInput, ParseInputRecord, ParseResult, RawDocument, RelatedInformation, SourceMap, SourcePosition, SourceSpan } from './types.js';
+export type { DiagnosticSeverity, DiagnosticCode } from './types.js';
+export { JSON_POINTER_ROOT, appendJsonPointer, decodeJsonPointerSegment, encodeJsonPointerSegment, isJsonPointer, joinJsonPointer, jsonPointerStartsWith, normalizeJsonPointer, parentJsonPointer, splitJsonPointer, tailJsonPointer } from './utils/json-pointer.js';
+export { ZERO_SOURCE_POSITION, cloneSourcePosition, cloneSourceSpan, compareSourcePositions, createSourcePosition, createSourceSpan, isSourcePosition, isSourceSpan, maxSourcePosition, minSourcePosition, spanContainsPosition, spanLength, spansOverlap, translateSourceSpan, unionSourceSpans } from './utils/source.js';
+export { PluginRegistry, createPluginRegistry } from './plugins/index.js';
+export type { ParserPlugin, ExtensionHandler, ExtensionHandlerResult, ExtensionHandlerInput, ExtensionEvaluation, ResolvedTokenTransform, ResolvedTokenTransformContext, ResolvedTokenTransformResult, ResolvedTokenTransformEvaluation } from './plugins/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":"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"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { normalizeDocument } from './ast/normaliser.js';
+export { ParseSession, createSession, parseCollection, parseDocument } from './session.js';
+export { createDocumentResolver, DocumentResolver } from './resolver/index.js';
+export { buildDocumentGraph } from './graph/builder.js';
+export { DiagnosticBag } from './diagnostics/bag.js';
+export { DiagnosticCodes, DiagnosticDomain, formatDiagnosticCode, isDiagnosticCode } from './diagnostics/codes.js';
+export { DIAGNOSTIC_SEVERITIES, compareDiagnosticSeverity, isDiagnosticSeverity, maxDiagnosticSeverity, minDiagnosticSeverity, severityWeight } from './diagnostics/severity.js';
+export { DefaultDocumentLoader, DocumentLoaderError } from './io/document-loader.js';
+export { InMemoryDocumentCache } from './io/document-cache.js';
+export { SchemaGuard } from './validation/schema-guard.js';
+export { JSON_POINTER_ROOT, appendJsonPointer, decodeJsonPointerSegment, encodeJsonPointerSegment, isJsonPointer, joinJsonPointer, jsonPointerStartsWith, normalizeJsonPointer, parentJsonPointer, splitJsonPointer, tailJsonPointer } from './utils/json-pointer.js';
+export { ZERO_SOURCE_POSITION, cloneSourcePosition, cloneSourceSpan, compareSourcePositions, createSourcePosition, createSourceSpan, isSourcePosition, isSourceSpan, maxSourcePosition, minSourcePosition, spanContainsPosition, spanLength, spansOverlap, translateSourceSpan, unionSourceSpans } from './utils/source.js';
+export { PluginRegistry, createPluginRegistry } from './plugins/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,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAcxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAY/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAcxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,gBAAgB,EAGhB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAQrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAsB3D,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/io/decoder/encoding.d.ts

@@ -0,0 +1,4 @@
+export declare function decodeBytes(bytes: Uint8Array): {
+    text: string;
+};
+//# sourceMappingURL=encoding.d.ts.map

package/dist/io/decoder/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../../src/io/decoder/encoding.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAiB/D"}

package/dist/io/decoder/encoding.js

@@ -0,0 +1,36 @@
+import { DecoderError } from './errors.js';
+const TEXT_DECODER_OPTIONS = { fatal: true };
+export function decodeBytes(bytes) {
+    if (bytes.length === 0) {
+        return { text: '' };
+    }
+    const { encoding, offset } = detectEncoding(bytes);
+    try {
+        const decoder = new TextDecoder(encoding, TEXT_DECODER_OPTIONS);
+        const view = offset > 0 ? bytes.subarray(offset) : bytes;
+        const text = decoder.decode(view);
+        return { text };
+    }
+    catch (error) {
+        throw new DecoderError(`Failed to decode DTIF document as ${encoding.toUpperCase()}.`, {
+            cause: error
+        });
+    }
+}
+function detectEncoding(bytes) {
+    if (bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {
+        return { encoding: 'utf-8', offset: 3 };
+    }
+    if (bytes.length >= 2) {
+        const lead = bytes[0];
+        const trail = bytes[1];
+        if (lead === 0xfe && trail === 0xff) {
+            return { encoding: 'utf-16be', offset: 2 };
+        }
+        if (lead === 0xff && trail === 0xfe) {
+            return { encoding: 'utf-16le', offset: 2 };
+        }
+    }
+    return { encoding: 'utf-8', offset: 0 };
+}
+//# sourceMappingURL=encoding.js.map

package/dist/io/decoder/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../../src/io/decoder/encoding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,oBAAoB,GAAyC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAEnF,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,qCAAqC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;YACrF,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAiB;IACvC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC7C,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC1C,CAAC"}

package/dist/io/decoder/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class DecoderError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/io/decoder/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/io/decoder/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD"}

package/dist/io/decoder/errors.js

@@ -0,0 +1,7 @@
+export class DecoderError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'DecoderError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/io/decoder/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/io/decoder/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/io/decoder/source-map.d.ts

@@ -0,0 +1,4 @@
+import { type LineCounter, type Node as YamlNode } from 'yaml';
+import type { DocumentHandle, SourceMap } from '../../types.js';
+export declare function buildSourceMap(handle: DocumentHandle, text: string, contents: YamlNode | null | undefined, lineCounter: LineCounter): SourceMap;
+//# sourceMappingURL=source-map.d.ts.map

package/dist/io/decoder/source-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-map.d.ts","sourceRoot":"","sources":["../../../src/io/decoder/source-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,IAAI,IAAI,QAAQ,EAEtB,MAAM,MAAM,CAAC;AAId,OAAO,KAAK,EAAE,cAAc,EAAe,SAAS,EAAc,MAAM,gBAAgB,CAAC;AAEzF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACrC,WAAW,EAAE,WAAW,GACvB,SAAS,CAmBX"}

package/dist/io/decoder/source-map.js

@@ -0,0 +1,106 @@
+import { isAlias, isMap, isScalar, isSeq } from 'yaml';
+import { JSON_POINTER_ROOT, appendJsonPointer } from '../../utils/json-pointer.js';
+import { createSourcePosition, createSourceSpan } from '../../utils/source.js';
+export function buildSourceMap(handle, text, contents, lineCounter) {
+    const pointers = new Map();
+    const textLength = text.length;
+    const rootSpan = createSourceSpan(handle.uri, toSourcePosition(lineCounter, 0), toSourcePosition(lineCounter, textLength));
+    pointers.set(JSON_POINTER_ROOT, rootSpan);
+    if (contents) {
+        visitNode(contents, JSON_POINTER_ROOT, pointers, handle.uri, lineCounter, textLength);
+    }
+    return Object.freeze({
+        uri: handle.uri,
+        pointers
+    });
+}
+function visitNode(node, pointer, pointers, uri, lineCounter, textLength) {
+    const span = rangeToSpan(node.range, uri, lineCounter, textLength);
+    if (span) {
+        pointers.set(pointer, span);
+    }
+    if (node == null || isAlias(node) || isScalar(node)) {
+        return;
+    }
+    if (isMap(node)) {
+        for (const pair of node.items) {
+            const valueNode = pair?.value;
+            if (!valueNode) {
+                continue;
+            }
+            const key = pair?.key ?? (isAlias(valueNode) ? '<<' : undefined);
+            const segment = formatPointerSegment(key);
+            const childPointer = appendJsonPointer(pointer, segment);
+            visitNode(valueNode, childPointer, pointers, uri, lineCounter, textLength);
+        }
+        return;
+    }
+    if (isSeq(node)) {
+        node.items.forEach((item, index) => {
+            const valueNode = item;
+            if (!valueNode) {
+                return;
+            }
+            const childPointer = appendJsonPointer(pointer, String(index));
+            visitNode(valueNode, childPointer, pointers, uri, lineCounter, textLength);
+        });
+    }
+}
+function rangeToSpan(range, uri, lineCounter, textLength) {
+    if (!range) {
+        return undefined;
+    }
+    const [start, valueEnd, nodeEnd] = range;
+    const startOffset = clampOffset(start, textLength);
+    const rawEnd = valueEnd ?? nodeEnd ?? start;
+    const endOffset = clampOffset(Math.max(start, rawEnd), textLength);
+    const startPosition = toSourcePosition(lineCounter, startOffset);
+    const endPosition = toSourcePosition(lineCounter, endOffset);
+    return createSourceSpan(uri, startPosition, endPosition);
+}
+function toSourcePosition(lineCounter, offset) {
+    const result = lineCounter.linePos(offset);
+    const line = result.line > 0 ? result.line : 1;
+    const column = result.col > 0 ? result.col : offset + 1;
+    return createSourcePosition(offset, line, column);
+}
+function clampOffset(offset, textLength) {
+    if (!Number.isFinite(offset)) {
+        return 0;
+    }
+    return Math.min(Math.max(0, Math.trunc(offset)), textLength);
+}
+function formatPointerSegment(key) {
+    if (key === null || key === undefined) {
+        return '';
+    }
+    if (typeof key === 'string' || typeof key === 'number' || typeof key === 'boolean') {
+        return String(key);
+    }
+    if (typeof key.toJSON === 'function') {
+        const value = key.toJSON();
+        if (value === undefined || value === null) {
+            return '';
+        }
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            return String(value);
+        }
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    if (typeof key.value !== 'undefined') {
+        const value = key.value;
+        if (value !== undefined) {
+            return String(value);
+        }
+    }
+    if (typeof key.source === 'string') {
+        return String(key.source);
+    }
+    return String(key);
+}
+//# sourceMappingURL=source-map.js.map

package/dist/io/decoder/source-map.js.map

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

package/dist/io/decoder/yaml.d.ts

@@ -0,0 +1,8 @@
+import { LineCounter, type Document as YamlDocument } from 'yaml';
+export interface ParsedYamlDocument {
+    readonly document: YamlDocument;
+    readonly lineCounter: LineCounter;
+}
+export declare function parseYaml(text: string): ParsedYamlDocument;
+export declare function toJavaScript(document: YamlDocument): unknown;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/io/decoder/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../../src/io/decoder/yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,KAAK,QAAQ,IAAI,YAAY,EAAkB,MAAM,MAAM,CAAC;AAMjG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAU1D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAM5D"}

package/dist/io/decoder/yaml.js

@@ -0,0 +1,28 @@
+import { LineCounter, parseDocument } from 'yaml';
+import { DecoderError } from './errors.js';
+const MAX_ALIAS_COUNT = 1000;
+export function parseYaml(text) {
+    const lineCounter = new LineCounter();
+    const document = parseDocument(text, { lineCounter, merge: true });
+    if (document.errors.length > 0) {
+        const [error] = document.errors;
+        throw new DecoderError(formatYamlError(error));
+    }
+    return { document, lineCounter };
+}
+export function toJavaScript(document) {
+    try {
+        return document.toJS({ maxAliasCount: MAX_ALIAS_COUNT });
+    }
+    catch (error) {
+        throw new DecoderError('Failed to convert DTIF document to JavaScript.', { cause: error });
+    }
+}
+function formatYamlError(error) {
+    if (error.linePos && error.linePos.length > 0) {
+        const [{ line, col }] = error.linePos;
+        return `${error.message} (line ${line}, column ${col})`;
+    }
+    return error.message;
+}
+//# sourceMappingURL=yaml.js.map

package/dist/io/decoder/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../src/io/decoder/yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAiD,MAAM,MAAM,CAAC;AAEjG,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,eAAe,GAAG,IAAI,CAAC;AAO7B,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnE,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;QAChC,MAAM,IAAI,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAsB;IACjD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,gDAAgD,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAgB;IACvC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QACtC,OAAO,GAAG,KAAK,CAAC,OAAO,UAAU,IAAI,YAAY,GAAG,GAAG,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC"}

package/dist/io/decoder.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentHandle, RawDocument } from '../types.js';
+export { DecoderError } from './decoder/errors.js';
+export declare function decodeDocument(handle: DocumentHandle): Promise<RawDocument>;
+//# sourceMappingURL=decoder.d.ts.map

package/dist/io/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/io/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAcjF"}

package/dist/io/decoder.js

@@ -0,0 +1,19 @@
+import { decodeBytes } from './decoder/encoding.js';
+import { buildSourceMap } from './decoder/source-map.js';
+import { parseYaml, toJavaScript } from './decoder/yaml.js';
+export { DecoderError } from './decoder/errors.js';
+export async function decodeDocument(handle) {
+    const { text } = decodeBytes(handle.bytes);
+    const { document: yamlDocument, lineCounter } = parseYaml(text);
+    const data = toJavaScript(yamlDocument);
+    const sourceMap = buildSourceMap(handle, text, yamlDocument.contents, lineCounter);
+    return Object.freeze({
+        uri: handle.uri,
+        contentType: handle.contentType,
+        bytes: handle.bytes,
+        text,
+        data,
+        sourceMap
+    });
+}
+//# sourceMappingURL=decoder.js.map

package/dist/io/decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.js","sourceRoot":"","sources":["../../src/io/decoder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAsB;IACzD,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEnF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI;QACJ,IAAI;QACJ,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/io/document-cache.d.ts

@@ -0,0 +1,15 @@
+import type { DocumentCache, RawDocument } from '../types.js';
+export interface InMemoryDocumentCacheOptions {
+    readonly maxEntries?: number;
+    readonly maxAgeMs?: number;
+    readonly clock?: () => number;
+}
+export declare class InMemoryDocumentCache implements DocumentCache {
+    #private;
+    constructor(options?: InMemoryDocumentCacheOptions);
+    get(uri: URL): RawDocument | undefined;
+    set(document: RawDocument): void;
+    delete(uri: URL): void;
+    clear(): void;
+}
+//# sourceMappingURL=document-cache.d.ts.map

package/dist/io/document-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-cache.d.ts","sourceRoot":"","sources":["../../src/io/document-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAUD,qBAAa,qBAAsB,YAAW,aAAa;;gBAM7C,OAAO,GAAE,4BAAiC;IAMtD,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,GAAG,SAAS;IAgBtC,GAAG,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAgBhC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAItB,KAAK,IAAI,IAAI;CA2Cd"}