@lapidist/dtif-parser 0.2.0

package/dist/session.js

@@ -0,0 +1,210 @@
+import { normalizeDocument } from './ast/normaliser.js';
+import { DiagnosticBag } from './diagnostics/bag.js';
+import { DiagnosticCodes } from './diagnostics/codes.js';
+import { buildDocumentGraph } from './graph/builder.js';
+import { DefaultDocumentLoader, DocumentLoaderError } from './io/document-loader.js';
+import { decodeDocument } from './io/decoder.js';
+import { createDocumentResolver } from './resolver/index.js';
+import { resolveOptions } from './session/internal/options.js';
+async function* toAsyncIterable(inputs) {
+    if (typeof inputs[Symbol.asyncIterator] === 'function') {
+        for await (const value of inputs) {
+            yield value;
+        }
+        return;
+    }
+    for (const value of inputs) {
+        yield value;
+    }
+}
+export class ParseSession {
+    options;
+    constructor(options = {}) {
+        this.options = resolveOptions(options);
+    }
+    async parseDocument(input) {
+        const diagnostics = new DiagnosticBag();
+        const handle = await this.loadDocumentHandle(input, diagnostics);
+        if (!handle) {
+            return { diagnostics };
+        }
+        const cachedDocument = await this.getCachedDocument(handle, diagnostics);
+        const document = cachedDocument ?? (await this.decodeDocumentHandle(handle, diagnostics));
+        if (!document) {
+            return { diagnostics };
+        }
+        if (!cachedDocument) {
+            await this.storeDocumentInCache(document, diagnostics);
+        }
+        const schemaValid = this.validateDocumentSchema(document, diagnostics);
+        if (!schemaValid) {
+            return {
+                document,
+                diagnostics
+            };
+        }
+        const normalised = normalizeDocument(document, {
+            extensions: this.options.plugins
+        });
+        diagnostics.addMany(normalised.diagnostics);
+        if (!normalised.ast) {
+            return {
+                document,
+                extensions: normalised.extensions,
+                diagnostics
+            };
+        }
+        const graphResult = buildDocumentGraph(normalised.ast);
+        diagnostics.addMany(graphResult.diagnostics);
+        const graph = graphResult.graph;
+        const resolver = graph &&
+            createDocumentResolver(graph, {
+                context: this.options.overrideContext,
+                maxDepth: this.options.maxDepth,
+                document,
+                transforms: this.options.plugins?.transforms
+            });
+        return {
+            document,
+            ast: normalised.ast,
+            graph,
+            resolver,
+            extensions: normalised.extensions,
+            diagnostics
+        };
+    }
+    async parseCollection(inputs) {
+        const results = [];
+        const diagnostics = new DiagnosticBag();
+        for await (const input of toAsyncIterable(inputs)) {
+            const result = await this.parseDocument(input);
+            results.push(result);
+            diagnostics.extend(result.diagnostics);
+        }
+        return {
+            results,
+            diagnostics
+        };
+    }
+    async loadDocumentHandle(input, diagnostics) {
+        try {
+            return await this.options.loader.load(input);
+        }
+        catch (error) {
+            if (error instanceof DocumentLoaderError) {
+                diagnostics.add({
+                    code: DiagnosticCodes.loader.TOO_LARGE,
+                    message: error.message,
+                    severity: 'error'
+                });
+            }
+            else {
+                diagnostics.add({
+                    code: DiagnosticCodes.loader.FAILED,
+                    message: error instanceof Error ? error.message : 'Failed to load DTIF document.',
+                    severity: 'error'
+                });
+            }
+            return undefined;
+        }
+    }
+    async decodeDocumentHandle(handle, diagnostics) {
+        try {
+            return await decodeDocument(handle);
+        }
+        catch (error) {
+            diagnostics.add({
+                code: DiagnosticCodes.decoder.FAILED,
+                message: error instanceof Error ? error.message : 'Failed to decode DTIF document.',
+                severity: 'error'
+            });
+            return undefined;
+        }
+    }
+    validateDocumentSchema(document, diagnostics) {
+        try {
+            const result = this.options.schemaGuard.validate(document);
+            if (!result.valid) {
+                diagnostics.addMany(result.diagnostics);
+            }
+            return result.valid;
+        }
+        catch (error) {
+            diagnostics.add({
+                code: DiagnosticCodes.schemaGuard.FAILED,
+                message: error instanceof Error
+                    ? error.message
+                    : 'Failed to validate DTIF document against the schema.',
+                severity: 'error'
+            });
+            return false;
+        }
+    }
+    async getCachedDocument(handle, diagnostics) {
+        const cache = this.options.cache;
+        if (!cache) {
+            return undefined;
+        }
+        try {
+            const cached = await cache.get(handle.uri);
+            if (!cached) {
+                return undefined;
+            }
+            return areByteArraysEqual(cached.bytes, handle.bytes) ? cached : undefined;
+        }
+        catch (error) {
+            diagnostics.add({
+                code: DiagnosticCodes.core.CACHE_FAILED,
+                message: error instanceof Error
+                    ? `Failed to read DTIF document from cache: ${error.message}`
+                    : 'Failed to read DTIF document from cache.',
+                severity: 'warning'
+            });
+            return undefined;
+        }
+    }
+    async storeDocumentInCache(document, diagnostics) {
+        const cache = this.options.cache;
+        if (!cache) {
+            return;
+        }
+        try {
+            await cache.set(document);
+        }
+        catch (error) {
+            diagnostics.add({
+                code: DiagnosticCodes.core.CACHE_FAILED,
+                message: error instanceof Error
+                    ? `Failed to update DTIF document cache: ${error.message}`
+                    : 'Failed to update DTIF document cache.',
+                severity: 'warning'
+            });
+        }
+    }
+}
+function areByteArraysEqual(left, right) {
+    if (left === right) {
+        return true;
+    }
+    if (left.byteLength !== right.byteLength) {
+        return false;
+    }
+    for (let index = 0; index < left.byteLength; index++) {
+        if (left[index] !== right[index]) {
+            return false;
+        }
+    }
+    return true;
+}
+export function createSession(options = {}) {
+    return new ParseSession(options);
+}
+export async function parseDocument(input, options) {
+    const session = createSession(options);
+    return session.parseDocument(input);
+}
+export async function parseCollection(inputs, options) {
+    const session = createSession(options);
+    return session.parseCollection(inputs);
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+import type { DiagnosticBag } from './diagnostics/bag.js';
+import type { DiagnosticCode } from './diagnostics/codes.js';
+import type { DiagnosticSeverity } from './diagnostics/severity.js';
+import type { DocumentAst } from './ast/nodes.js';
+import type { DocumentGraph } from './graph/nodes.js';
+import type { DocumentResolver } from './resolver/index.js';
+import type { ExtensionEvaluation } from './plugins/index.js';
+export type JsonPointer = `#${string}`;
+export type ParseInput = string | Uint8Array | URL | ParseInputRecord;
+export interface ParseInputRecord {
+    readonly uri?: string | URL;
+    readonly content: string | Uint8Array;
+    readonly contentType?: ContentType;
+}
+export type ContentType = 'application/json' | 'application/yaml';
+export interface SourcePosition {
+    readonly offset: number;
+    readonly line: number;
+    readonly column: number;
+}
+export interface SourceSpan {
+    readonly uri: URL;
+    readonly start: SourcePosition;
+    readonly end: SourcePosition;
+}
+export interface SourceMap {
+    readonly uri: URL;
+    readonly pointers: ReadonlyMap<JsonPointer, SourceSpan>;
+}
+export interface RelatedInformation {
+    readonly message: string;
+    readonly pointer?: JsonPointer;
+    readonly span?: SourceSpan;
+}
+export interface Diagnostic {
+    readonly code: DiagnosticCode;
+    readonly message: string;
+    readonly severity: DiagnosticSeverity;
+    readonly pointer?: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly related?: readonly RelatedInformation[];
+}
+export interface DocumentHandle {
+    readonly uri: URL;
+    readonly contentType: ContentType;
+    readonly bytes: Uint8Array;
+}
+export interface RawDocument extends DocumentHandle {
+    readonly text: string;
+    readonly data: unknown;
+    readonly sourceMap: SourceMap;
+}
+export interface DocumentCache {
+    get(uri: URL): Promise<RawDocument | undefined> | RawDocument | undefined;
+    set(document: RawDocument): Promise<void> | void;
+    delete?(uri: URL): Promise<void> | void;
+    clear?(): Promise<void> | void;
+}
+export interface ParseResult {
+    readonly document?: RawDocument;
+    readonly ast?: DocumentAst;
+    readonly graph?: DocumentGraph;
+    readonly resolver?: DocumentResolver;
+    readonly diagnostics: DiagnosticBag;
+    readonly extensions?: readonly ExtensionEvaluation[];
+}
+export interface ParseCollectionResult {
+    readonly results: readonly ParseResult[];
+    readonly diagnostics: DiagnosticBag;
+}
+export type { DiagnosticSeverity } from './diagnostics/severity.js';
+export type { DiagnosticCode } from './diagnostics/codes.js';
+export type { AstField, CollectionNode, DocumentAst, DocumentChildNode, NodeMetadata, OverrideFallbackNode, OverrideNode, TokenNode, AliasNode } from './ast/nodes.js';
+export type { DocumentGraph, GraphNode, GraphNodeBase, GraphCollectionNode, GraphTokenNode, GraphAliasNode, GraphReferenceField, GraphReferenceTarget, GraphOverrideNode, GraphOverrideFallbackNode } from './graph/nodes.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils/json-pointer.d.ts

@@ -0,0 +1,13 @@
+import type { JsonPointer } from '../types.js';
+export declare const JSON_POINTER_ROOT: JsonPointer;
+export declare function normalizeJsonPointer(pointer: string): JsonPointer;
+export declare function isJsonPointer(value: unknown): value is JsonPointer;
+export declare function encodeJsonPointerSegment(segment: string): string;
+export declare function decodeJsonPointerSegment(segment: string): string;
+export declare function splitJsonPointer(pointer: JsonPointer): string[];
+export declare function joinJsonPointer(segments: Iterable<string>): JsonPointer;
+export declare function appendJsonPointer(base: JsonPointer, ...segments: string[]): JsonPointer;
+export declare function parentJsonPointer(pointer: JsonPointer): JsonPointer | undefined;
+export declare function jsonPointerStartsWith(pointer: JsonPointer, prefix: JsonPointer): boolean;
+export declare function tailJsonPointer(pointer: JsonPointer): string | undefined;
+//# sourceMappingURL=json-pointer.d.ts.map

package/dist/utils/json-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-pointer.d.ts","sourceRoot":"","sources":["../../src/utils/json-pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,WAAiB,CAAC;AAIlD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAyBjE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAOlE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAc/D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAEvE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CAOvF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAO/E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CASxF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAGxE"}

package/dist/utils/json-pointer.js

@@ -0,0 +1,89 @@
+export const JSON_POINTER_ROOT = '#';
+const ABSOLUTE_POINTER_PATTERN = /^#(?:$|(?:\/(?:[^~]|~0|~1)*)*)$/u;
+export function normalizeJsonPointer(pointer) {
+    if (pointer === '' || pointer === JSON_POINTER_ROOT) {
+        return JSON_POINTER_ROOT;
+    }
+    if (pointer.startsWith('#/')) {
+        return `#${pointer.slice(1)}`;
+    }
+    if (pointer.startsWith('#')) {
+        const remainder = pointer.slice(1);
+        if (remainder.length === 0) {
+            return JSON_POINTER_ROOT;
+        }
+        if (remainder.startsWith('/')) {
+            return `#${remainder}`;
+        }
+        return `#/${remainder}`;
+    }
+    if (pointer.startsWith('/')) {
+        return `#${pointer}`;
+    }
+    return `#/${pointer}`;
+}
+export function isJsonPointer(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    const normalized = normalizeJsonPointer(value);
+    return ABSOLUTE_POINTER_PATTERN.test(normalized);
+}
+export function encodeJsonPointerSegment(segment) {
+    return segment.replaceAll('~', '~0').replaceAll('/', '~1');
+}
+export function decodeJsonPointerSegment(segment) {
+    return segment.replaceAll('~1', '/').replaceAll('~0', '~');
+}
+export function splitJsonPointer(pointer) {
+    const normalized = normalizeJsonPointer(pointer);
+    if (normalized === JSON_POINTER_ROOT) {
+        return [];
+    }
+    const withoutPrefix = normalized.startsWith('#/') ? normalized.slice(2) : normalized.slice(1);
+    if (withoutPrefix === '') {
+        return [''];
+    }
+    return withoutPrefix.split('/').map(decodeJsonPointerSegment);
+}
+export function joinJsonPointer(segments) {
+    return buildPointerFromSegments(segments);
+}
+export function appendJsonPointer(base, ...segments) {
+    if (segments.length === 0) {
+        return normalizeJsonPointer(base);
+    }
+    const baseSegments = splitJsonPointer(base);
+    return buildPointerFromSegments([...baseSegments, ...segments]);
+}
+export function parentJsonPointer(pointer) {
+    const segments = splitJsonPointer(pointer);
+    if (segments.length === 0) {
+        return undefined;
+    }
+    segments.pop();
+    return buildPointerFromSegments(segments);
+}
+export function jsonPointerStartsWith(pointer, prefix) {
+    const pointerSegments = splitJsonPointer(pointer);
+    const prefixSegments = splitJsonPointer(prefix);
+    if (prefixSegments.length > pointerSegments.length) {
+        return false;
+    }
+    return prefixSegments.every((segment, index) => segment === pointerSegments[index]);
+}
+export function tailJsonPointer(pointer) {
+    const segments = splitJsonPointer(pointer);
+    return segments.at(-1);
+}
+function buildPointerFromSegments(segments) {
+    const encoded = [];
+    for (const segment of segments) {
+        encoded.push(encodeJsonPointerSegment(String(segment)));
+    }
+    if (encoded.length === 0) {
+        return JSON_POINTER_ROOT;
+    }
+    return `#/${encoded.join('/')}`;
+}
+//# sourceMappingURL=json-pointer.js.map

package/dist/utils/json-pointer.js.map

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

package/dist/utils/source.d.ts

@@ -0,0 +1,21 @@
+import type { SourcePosition, SourceSpan } from '../types.js';
+export declare const ZERO_SOURCE_POSITION: SourcePosition;
+export declare function createSourcePosition(offset: number, line: number, column: number): SourcePosition;
+export declare function cloneSourcePosition(position: SourcePosition): SourcePosition;
+export declare function compareSourcePositions(a: SourcePosition, b: SourcePosition): number;
+export declare function minSourcePosition(...positions: readonly SourcePosition[]): SourcePosition | undefined;
+export declare function maxSourcePosition(...positions: readonly SourcePosition[]): SourcePosition | undefined;
+export declare function createSourceSpan(uri: URL, start: SourcePosition, end: SourcePosition): SourceSpan;
+export declare function cloneSourceSpan(span: SourceSpan): SourceSpan;
+export declare function spanLength(span: SourceSpan): number;
+export declare function spanContainsPosition(span: SourceSpan, position: SourcePosition): boolean;
+export declare function spansOverlap(a: SourceSpan, b: SourceSpan): boolean;
+export declare function unionSourceSpans(spans: Iterable<SourceSpan>): SourceSpan | undefined;
+export declare function translateSourceSpan(span: SourceSpan, delta: {
+    offset?: number;
+    line?: number;
+    column?: number;
+}): SourceSpan;
+export declare function isSourceSpan(value: unknown): value is SourceSpan;
+export declare function isSourcePosition(value: unknown): value is SourcePosition;
+//# sourceMappingURL=source.d.ts.map

package/dist/utils/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/utils/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D,eAAO,MAAM,oBAAoB,EAAE,cAIjC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAMjG;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAE5E;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAWnF;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,SAAS,EAAE,SAAS,cAAc,EAAE,GACtC,cAAc,GAAG,SAAS,CAO5B;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,SAAS,EAAE,SAAS,cAAc,EAAE,GACtC,cAAc,GAAG,SAAS,CAO5B;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,GAAG,UAAU,CAOjG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAE5D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEnD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAKxF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAKlE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,SAAS,CAepF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,UAAU,CAkBZ;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAOhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAUxE"}

package/dist/utils/source.js

@@ -0,0 +1,125 @@
+export const ZERO_SOURCE_POSITION = Object.freeze({
+    offset: 0,
+    line: 1,
+    column: 1
+});
+export function createSourcePosition(offset, line, column) {
+    return Object.freeze({
+        offset: normalizeOffset(offset),
+        line: normalizeLine(line),
+        column: normalizeColumn(column)
+    });
+}
+export function cloneSourcePosition(position) {
+    return createSourcePosition(position.offset, position.line, position.column);
+}
+export function compareSourcePositions(a, b) {
+    if (a.offset !== b.offset) {
+        return a.offset - b.offset;
+    }
+    if (a.line !== b.line) {
+        return a.line - b.line;
+    }
+    if (a.column !== b.column) {
+        return a.column - b.column;
+    }
+    return 0;
+}
+export function minSourcePosition(...positions) {
+    if (positions.length === 0) {
+        return undefined;
+    }
+    return positions.reduce((min, current) => compareSourcePositions(current, min) < 0 ? current : min);
+}
+export function maxSourcePosition(...positions) {
+    if (positions.length === 0) {
+        return undefined;
+    }
+    return positions.reduce((max, current) => compareSourcePositions(current, max) > 0 ? current : max);
+}
+export function createSourceSpan(uri, start, end) {
+    const [normalizedStart, normalizedEnd] = orderSpanEndpoints(start, end);
+    return Object.freeze({
+        uri,
+        start: normalizedStart,
+        end: normalizedEnd
+    });
+}
+export function cloneSourceSpan(span) {
+    return createSourceSpan(span.uri, span.start, span.end);
+}
+export function spanLength(span) {
+    return Math.max(0, span.end.offset - span.start.offset);
+}
+export function spanContainsPosition(span, position) {
+    return (compareSourcePositions(position, span.start) >= 0 &&
+        compareSourcePositions(position, span.end) <= 0);
+}
+export function spansOverlap(a, b) {
+    if (a.uri.href !== b.uri.href) {
+        return false;
+    }
+    return compareSourcePositions(a.start, b.end) <= 0 && compareSourcePositions(a.end, b.start) >= 0;
+}
+export function unionSourceSpans(spans) {
+    let result;
+    for (const span of spans) {
+        if (!result) {
+            result = span;
+            continue;
+        }
+        if (span.uri.href !== result.uri.href) {
+            throw new Error('Cannot union spans from different documents.');
+        }
+        const start = compareSourcePositions(span.start, result.start) < 0 ? span.start : result.start;
+        const end = compareSourcePositions(span.end, result.end) > 0 ? span.end : result.end;
+        result = createSourceSpan(result.uri, start, end);
+    }
+    return result;
+}
+export function translateSourceSpan(span, delta) {
+    const offsetDelta = toInteger(delta.offset ?? 0);
+    const lineDelta = toInteger(delta.line ?? 0);
+    const columnDelta = toInteger(delta.column ?? 0);
+    const newStart = createSourcePosition(span.start.offset + offsetDelta, Math.max(1, span.start.line + lineDelta), Math.max(1, span.start.column + columnDelta));
+    const newEnd = createSourcePosition(span.end.offset + offsetDelta, Math.max(1, span.end.line + lineDelta), Math.max(1, span.end.column + columnDelta));
+    return createSourceSpan(span.uri, newStart, newEnd);
+}
+export function isSourceSpan(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const span = value;
+    return span.uri instanceof URL && isSourcePosition(span.start) && isSourcePosition(span.end);
+}
+export function isSourcePosition(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const position = value;
+    return (typeof position.offset === 'number' &&
+        typeof position.line === 'number' &&
+        typeof position.column === 'number');
+}
+function orderSpanEndpoints(start, end) {
+    if (compareSourcePositions(start, end) <= 0) {
+        return [start, end];
+    }
+    return [end, start];
+}
+function normalizeOffset(offset) {
+    return Math.max(0, toInteger(offset));
+}
+function normalizeLine(line) {
+    return Math.max(1, toInteger(line));
+}
+function normalizeColumn(column) {
+    return Math.max(1, toInteger(column));
+}
+function toInteger(value) {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.trunc(value);
+}
+//# sourceMappingURL=source.js.map

package/dist/utils/source.js.map

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

package/dist/validation/schema-guard.d.ts

@@ -0,0 +1,20 @@
+import type { CreateDtifValidatorOptions, DtifValidator } from '@lapidist/dtif-validator';
+import type { Diagnostic, RawDocument } from '../types.js';
+export interface SchemaGuardOptions extends CreateDtifValidatorOptions {
+    readonly validator?: DtifValidator;
+}
+export interface SchemaGuardResult {
+    readonly valid: boolean;
+    readonly diagnostics: readonly Diagnostic[];
+}
+export declare class SchemaGuardError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class SchemaGuard {
+    private readonly validator;
+    constructor(options?: SchemaGuardOptions);
+    validate(document: RawDocument): SchemaGuardResult;
+    private createDiagnostic;
+    private resolveSpan;
+}
+//# sourceMappingURL=schema-guard.d.ts.map

package/dist/validation/schema-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-guard.d.ts","sourceRoot":"","sources":["../../src/validation/schema-guard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI1F,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAkC,MAAM,aAAa,CAAC;AAkB3F,MAAM,WAAW,kBAAmB,SAAQ,0BAA0B;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAwCD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,OAAO,GAAE,kBAAuB;IAK5C,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,iBAAiB;IAsBlD,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,WAAW;CAIpB"}