@lapidist/dtif-parser 0.2.0

package/dist/io/document-cache.js

@@ -0,0 +1,101 @@
+const DEFAULT_MAX_ENTRIES = 32;
+const DEFAULT_MAX_AGE_MS = 5 * 60 * 1000; // 5 minutes
+export class InMemoryDocumentCache {
+    #entries = new Map();
+    #maxEntries;
+    #maxAgeMs;
+    #clock;
+    constructor(options = {}) {
+        this.#maxEntries = normalizeMaxEntries(options.maxEntries);
+        this.#maxAgeMs = normalizeMaxAge(options.maxAgeMs);
+        this.#clock = options.clock ?? Date.now;
+    }
+    get(uri) {
+        const key = uri.href;
+        const entry = this.#entries.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (this.#isExpired(entry)) {
+            this.#entries.delete(key);
+            return undefined;
+        }
+        this.#touch(key, entry);
+        return entry.document;
+    }
+    set(document) {
+        if (this.#maxEntries === 0) {
+            return;
+        }
+        this.#pruneExpired();
+        const key = document.uri.href;
+        const entry = {
+            document,
+            timestamp: this.#clock()
+        };
+        this.#entries.set(key, entry);
+        this.#enforceSize();
+    }
+    delete(uri) {
+        this.#entries.delete(uri.href);
+    }
+    clear() {
+        this.#entries.clear();
+    }
+    #pruneExpired() {
+        if (this.#maxAgeMs === undefined) {
+            return;
+        }
+        for (const [key, entry] of this.#entries) {
+            if (this.#isExpired(entry)) {
+                this.#entries.delete(key);
+            }
+        }
+    }
+    #enforceSize() {
+        if (this.#maxEntries < 0) {
+            return;
+        }
+        while (this.#entries.size > this.#maxEntries) {
+            const oldestKey = this.#entries.keys().next().value;
+            if (oldestKey === undefined) {
+                break;
+            }
+            this.#entries.delete(oldestKey);
+        }
+    }
+    #isExpired(entry) {
+        if (this.#maxAgeMs === undefined) {
+            return false;
+        }
+        const age = this.#clock() - entry.timestamp;
+        return age > this.#maxAgeMs;
+    }
+    #touch(key, entry) {
+        this.#entries.delete(key);
+        this.#entries.set(key, entry);
+    }
+}
+function normalizeMaxAge(input) {
+    if (input === undefined) {
+        return DEFAULT_MAX_AGE_MS;
+    }
+    if (!Number.isFinite(input)) {
+        return undefined;
+    }
+    const normalized = Math.trunc(input);
+    if (normalized <= 0) {
+        return undefined;
+    }
+    return normalized;
+}
+function normalizeMaxEntries(input) {
+    if (input === undefined) {
+        return DEFAULT_MAX_ENTRIES;
+    }
+    if (!Number.isFinite(input)) {
+        return -1;
+    }
+    return Math.max(0, Math.trunc(input));
+}
+//# sourceMappingURL=document-cache.js.map

package/dist/io/document-cache.js.map

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

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

@@ -0,0 +1,37 @@
+import type { ContentType, DocumentHandle, ParseInput } from '../types.js';
+type ReadFileFn = (path: string | URL) => Promise<Uint8Array>;
+export interface DefaultDocumentLoaderOptions {
+    readonly allowHttp?: boolean;
+    readonly fetch?: typeof fetch;
+    readonly readFile?: ReadFileFn;
+    readonly cwd?: string | URL;
+    readonly defaultContentType?: ContentType;
+    readonly maxBytes?: number;
+}
+export interface DocumentLoaderContext {
+    readonly baseUri?: URL;
+    readonly signal?: AbortSignal;
+}
+export interface DocumentLoader {
+    load(input: ParseInput, context?: DocumentLoaderContext): Promise<DocumentHandle>;
+}
+export type DocumentLoaderErrorReason = 'MAX_BYTES_EXCEEDED';
+export declare class DocumentLoaderError extends Error {
+    readonly reason: DocumentLoaderErrorReason;
+    readonly uri: URL;
+    readonly limit?: number;
+    readonly size: number;
+    constructor(reason: DocumentLoaderErrorReason, message: string, options: {
+        uri: URL;
+        limit?: number;
+        size: number;
+        cause?: unknown;
+    });
+}
+export declare class DefaultDocumentLoader implements DocumentLoader {
+    #private;
+    constructor(options?: DefaultDocumentLoaderOptions);
+    load(input: ParseInput, context?: DocumentLoaderContext): Promise<DocumentHandle>;
+}
+export {};
+//# sourceMappingURL=document-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-loader.d.ts","sourceRoot":"","sources":["../../src/io/document-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAI7F,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACnF;AAED,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAC;AAE7D,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CASvE;AAED,qBAAa,qBAAsB,YAAW,cAAc;;gBAS9C,OAAO,GAAE,4BAAiC;IAShD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,cAAc,CAAC;CAiJ5F"}

package/dist/io/document-loader.js

@@ -0,0 +1,255 @@
+import { readFile as defaultReadFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+const MEMORY_SCHEME = 'memory://dtif-document/';
+export class DocumentLoaderError extends Error {
+    reason;
+    uri;
+    limit;
+    size;
+    constructor(reason, message, options) {
+        super(message, { cause: options.cause });
+        this.name = 'DocumentLoaderError';
+        this.reason = reason;
+        this.uri = options.uri;
+        this.limit = options.limit;
+        this.size = options.size;
+    }
+}
+export class DefaultDocumentLoader {
+    #allowHttp;
+    #fetch;
+    #readFile;
+    #cwd;
+    #defaultContentType;
+    #maxBytes;
+    #memoryCounter = 0;
+    constructor(options = {}) {
+        this.#allowHttp = options.allowHttp ?? false;
+        this.#fetch = options.fetch ?? globalThis.fetch;
+        this.#readFile = options.readFile ?? defaultReadFile;
+        this.#cwd = normalizeWorkingDirectory(options.cwd);
+        this.#defaultContentType = options.defaultContentType ?? 'application/json';
+        this.#maxBytes = resolveMaxBytes(options.maxBytes);
+    }
+    async load(input, context = {}) {
+        if (isParseInputRecord(input)) {
+            return this.#loadFromRecord(input, context.baseUri);
+        }
+        if (input instanceof URL) {
+            return this.#loadFromUrl(input, context);
+        }
+        if (input instanceof Uint8Array) {
+            const uri = this.#createMemoryUri();
+            this.#assertSizeWithinLimit(uri, input.byteLength);
+            return this.#createHandle(uri, input, this.#defaultContentType);
+        }
+        if (typeof input === 'string') {
+            if (looksLikeInlineDocument(input)) {
+                const uri = this.#createMemoryUri();
+                const bytes = encodeText(input);
+                this.#assertSizeWithinLimit(uri, bytes.byteLength);
+                return this.#createHandle(uri, bytes, detectContentType({ content: input, fallback: this.#defaultContentType }));
+            }
+            const uri = this.#resolveUriFromString(input, context.baseUri);
+            return this.#loadFromUrl(uri, context);
+        }
+        throw new TypeError(`Unsupported DTIF parse input: ${String(input)}`);
+    }
+    async #loadFromRecord(record, baseUri) {
+        const uri = record.uri ? this.#normalizeUri(record.uri, baseUri) : this.#createMemoryUri();
+        const contentType = record.contentType ?? detectContentType({ uri, content: record.content });
+        if (typeof record.content === 'string') {
+            const bytes = encodeText(record.content);
+            this.#assertSizeWithinLimit(uri, bytes.byteLength);
+            return this.#createHandle(uri, bytes, contentType);
+        }
+        this.#assertSizeWithinLimit(uri, record.content.byteLength);
+        return this.#createHandle(uri, record.content, contentType);
+    }
+    async #loadFromUrl(uri, context) {
+        switch (uri.protocol) {
+            case 'file:': {
+                const filePath = fileURLToPath(uri);
+                const data = await this.#readFile(filePath);
+                const bytes = data instanceof Uint8Array ? new Uint8Array(data) : encodeText(String(data));
+                this.#assertSizeWithinLimit(uri, bytes.byteLength);
+                const contentType = detectContentType({ uri, fallback: this.#defaultContentType });
+                return this.#createHandle(uri, bytes, contentType);
+            }
+            case 'http:':
+            case 'https:': {
+                if (!this.#allowHttp) {
+                    throw new Error(`HTTP(S) loading is disabled for DTIF documents: ${uri.href}`);
+                }
+                if (!this.#fetch) {
+                    throw new Error('No fetch implementation available for HTTP(S) loading.');
+                }
+                const response = await this.#fetch(uri, { signal: context.signal });
+                if (!response.ok) {
+                    throw new Error(`Failed to fetch DTIF document. HTTP status: ${response.status}`);
+                }
+                const arrayBuffer = await response.arrayBuffer();
+                const bytes = new Uint8Array(arrayBuffer);
+                this.#assertSizeWithinLimit(uri, bytes.byteLength);
+                const contentType = detectContentType({
+                    uri,
+                    header: response.headers?.get?.('content-type') ?? undefined,
+                    fallback: this.#defaultContentType
+                });
+                return this.#createHandle(uri, bytes, contentType);
+            }
+            default:
+                throw new Error(`Unsupported URI scheme for DTIF documents: ${uri.protocol}`);
+        }
+    }
+    #createHandle(uri, bytes, contentType) {
+        const copy = bytes instanceof Uint8Array ? new Uint8Array(bytes) : encodeText(String(bytes));
+        return Object.freeze({
+            uri,
+            contentType,
+            bytes: copy
+        });
+    }
+    #assertSizeWithinLimit(uri, size) {
+        if (size <= this.#maxBytes) {
+            return;
+        }
+        throw new DocumentLoaderError('MAX_BYTES_EXCEEDED', `DTIF document ${uri.href} is ${size} bytes, exceeding the configured maximum of ${this.#maxBytes} bytes.`, { uri, limit: this.#maxBytes, size });
+    }
+    #normalizeUri(value, baseUri) {
+        if (value instanceof URL) {
+            return value;
+        }
+        const trimmed = value.trim();
+        try {
+            return new URL(trimmed);
+        }
+        catch {
+            return this.#resolveUriFromString(trimmed, baseUri);
+        }
+    }
+    #resolveUriFromString(reference, baseUri) {
+        try {
+            return new URL(reference);
+        }
+        catch {
+            // fall through
+        }
+        if (baseUri) {
+            if (baseUri.protocol === 'file:') {
+                return pathToFileURL(resolveFilePath(reference, baseUri, this.#cwd));
+            }
+            try {
+                return new URL(reference, baseUri);
+            }
+            catch {
+                // fall through to cwd resolution
+            }
+        }
+        return pathToFileURL(resolveFilePath(reference, undefined, this.#cwd));
+    }
+    #createMemoryUri() {
+        const id = this.#memoryCounter++;
+        return new URL(`${MEMORY_SCHEME}${id}`);
+    }
+}
+function normalizeWorkingDirectory(input) {
+    if (!input) {
+        return process.cwd();
+    }
+    if (input instanceof URL) {
+        return fileURLToPath(input);
+    }
+    return path.resolve(input);
+}
+const DEFAULT_MAX_BYTES = 5 * 1024 * 1024;
+function resolveMaxBytes(input) {
+    if (input === undefined) {
+        return DEFAULT_MAX_BYTES;
+    }
+    if (!Number.isFinite(input) || input <= 0) {
+        return Number.POSITIVE_INFINITY;
+    }
+    return input;
+}
+function resolveFilePath(reference, baseUri, cwd) {
+    if (path.isAbsolute(reference)) {
+        return reference;
+    }
+    if (baseUri && baseUri.protocol === 'file:') {
+        const basePath = fileURLToPath(baseUri.href.endsWith('/') ? baseUri : new URL('.', baseUri));
+        return path.resolve(basePath, reference);
+    }
+    return path.resolve(cwd, reference);
+}
+function isParseInputRecord(value) {
+    return Boolean(value && typeof value === 'object' && 'content' in value);
+}
+function encodeText(content) {
+    return new TextEncoder().encode(content);
+}
+function detectContentType(params) {
+    if (params.uri) {
+        const fromUri = detectContentTypeFromUri(params.uri);
+        if (fromUri) {
+            return fromUri;
+        }
+    }
+    if (params.header) {
+        const lowered = params.header.toLowerCase();
+        if (lowered.includes('yaml')) {
+            return 'application/yaml';
+        }
+        if (lowered.includes('json')) {
+            return 'application/json';
+        }
+    }
+    if (typeof params.content === 'string') {
+        const fromContent = detectContentTypeFromContent(params.content);
+        if (fromContent) {
+            return fromContent;
+        }
+    }
+    return params.fallback ?? 'application/json';
+}
+function detectContentTypeFromUri(uri) {
+    const pathname = uri.pathname.toLowerCase();
+    if (pathname.endsWith('.yaml') || pathname.endsWith('.yml')) {
+        return 'application/yaml';
+    }
+    if (pathname.endsWith('.json')) {
+        return 'application/json';
+    }
+    return undefined;
+}
+function detectContentTypeFromContent(content) {
+    const trimmed = content.trimStart();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        return 'application/json';
+    }
+    if (trimmed.startsWith('---') || trimmed.startsWith('%')) {
+        return 'application/yaml';
+    }
+    if (trimmed.includes('\n')) {
+        return 'application/yaml';
+    }
+    return undefined;
+}
+function looksLikeInlineDocument(value) {
+    const trimmed = value.trimStart();
+    if (trimmed.length === 0) {
+        return true;
+    }
+    if (trimmed.startsWith('{') || trimmed.startsWith('[') || trimmed.startsWith('---')) {
+        return true;
+    }
+    if (trimmed.startsWith('%YAML') || trimmed.includes('\n')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=document-loader.js.map

package/dist/io/document-loader.js.map

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

package/dist/plugins/index.d.ts

@@ -0,0 +1,7 @@
+import { PluginRegistry } from './registry.js';
+import type { ParserPlugin } from './types.js';
+export { PluginRegistry };
+export declare function createPluginRegistry(plugins?: readonly ParserPlugin[]): PluginRegistry;
+export type { ExtensionCollector } from './registry.js';
+export type { ExtensionEvaluation, ExtensionHandler, ExtensionHandlerInput, ExtensionHandlerResult, ParserPlugin, ResolvedTokenTransform, ResolvedTokenTransformContext, ResolvedTokenTransformEvaluation, ResolvedTokenTransformResult, ResolvedTokenTransformEntry } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,SAAS,YAAY,EAAO,GAAG,cAAc,CAE1F;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,EAChC,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,YAAY,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,6 @@
+import { PluginRegistry } from './registry.js';
+export { PluginRegistry };
+export function createPluginRegistry(plugins = []) {
+    return new PluginRegistry(plugins);
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,UAAU,oBAAoB,CAAC,UAAmC,EAAE;IACxE,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,20 @@
+import type { Diagnostic, JsonPointer, RawDocument, SourceSpan } from '../types.js';
+import type { ExtensionEvaluation, ParserPlugin, ResolvedTokenTransformEntry } from './types.js';
+interface ExtensionInvocation {
+    readonly namespace: string;
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly value: unknown;
+}
+export interface ExtensionCollector {
+    handle(invocation: ExtensionInvocation): void;
+    results(): readonly ExtensionEvaluation[];
+}
+export declare class PluginRegistry {
+    #private;
+    constructor(plugins?: readonly ParserPlugin[]);
+    createExtensionCollector(document: RawDocument, diagnostics: Diagnostic[]): ExtensionCollector | undefined;
+    get transforms(): readonly ResolvedTokenTransformEntry[];
+}
+export type { ResolvedTokenTransformEntry };
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EACV,mBAAmB,EAGnB,YAAY,EAEZ,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAapB,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC9C,OAAO,IAAI,SAAS,mBAAmB,EAAE,CAAC;CAC3C;AAqGD,qBAAa,cAAc;;gBAIb,OAAO,GAAE,SAAS,YAAY,EAAO;IA0CjD,wBAAwB,CACtB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,UAAU,EAAE,GACxB,kBAAkB,GAAG,SAAS;IAOjC,IAAI,UAAU,IAAI,SAAS,2BAA2B,EAAE,CAEvD;CACF;AAED,YAAY,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/plugins/registry.js

@@ -0,0 +1,136 @@
+import { DiagnosticCodes } from '../diagnostics/codes.js';
+const EMPTY_DIAGNOSTICS = Object.freeze([]);
+const EMPTY_EXTENSION_EVALUATIONS = Object.freeze([]);
+const EMPTY_TRANSFORM_ENTRIES = Object.freeze([]);
+class ExtensionCollectorImpl {
+    handlers;
+    document;
+    diagnostics;
+    #results = [];
+    #finalized;
+    constructor(handlers, document, diagnostics) {
+        this.handlers = handlers;
+        this.document = document;
+        this.diagnostics = diagnostics;
+    }
+    handle(invocation) {
+        const entries = this.handlers.get(invocation.namespace);
+        if (!entries || entries.length === 0) {
+            return;
+        }
+        for (const entry of entries) {
+            try {
+                const result = entry.handler(createExtensionHandlerInput(invocation, this.document));
+                const diagnostics = freezeDiagnostics(result?.diagnostics);
+                if (diagnostics.length > 0) {
+                    for (const diagnostic of diagnostics) {
+                        this.diagnostics.push(diagnostic);
+                    }
+                }
+                this.#results.push(Object.freeze({
+                    plugin: entry.plugin,
+                    namespace: invocation.namespace,
+                    pointer: invocation.pointer,
+                    span: invocation.span,
+                    value: invocation.value,
+                    normalized: result?.normalized,
+                    diagnostics
+                }));
+            }
+            catch (error) {
+                this.diagnostics.push(createExtensionFailureDiagnostic(invocation, entry.plugin, error));
+            }
+        }
+    }
+    results() {
+        if (this.#finalized) {
+            return this.#finalized;
+        }
+        if (this.#results.length === 0) {
+            this.#finalized = EMPTY_EXTENSION_EVALUATIONS;
+            return this.#finalized;
+        }
+        this.#finalized = Object.freeze(this.#results.slice());
+        return this.#finalized;
+    }
+}
+function createExtensionHandlerInput(invocation, document) {
+    return {
+        namespace: invocation.namespace,
+        pointer: invocation.pointer,
+        span: invocation.span,
+        value: invocation.value,
+        document
+    };
+}
+function createExtensionFailureDiagnostic(invocation, plugin, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        code: DiagnosticCodes.plugins.EXTENSION_FAILED,
+        message: `Plugin "${plugin}" failed to process extension "${invocation.namespace}": ${message}`,
+        severity: 'error',
+        pointer: invocation.pointer,
+        span: invocation.span
+    };
+}
+function freezeDiagnostics(list) {
+    if (!list || list.length === 0) {
+        return EMPTY_DIAGNOSTICS;
+    }
+    return Object.freeze(Array.from(list));
+}
+function normalizeHandlers(input) {
+    if (input instanceof Map) {
+        return input.entries();
+    }
+    return Object.entries(input);
+}
+export class PluginRegistry {
+    #handlers;
+    #transforms;
+    constructor(plugins = []) {
+        const handlerMap = new Map();
+        const transforms = [];
+        for (const plugin of plugins) {
+            if (!plugin || typeof plugin.name !== 'string' || plugin.name.trim() === '') {
+                throw new TypeError('Parser plugins must declare a non-empty name.');
+            }
+            const name = plugin.name;
+            if (plugin.extensions) {
+                for (const [namespace, handler] of normalizeHandlers(plugin.extensions)) {
+                    if (typeof handler !== 'function') {
+                        throw new TypeError(`Extension handler for namespace "${namespace}" in plugin "${name}" must be a function.`);
+                    }
+                    const list = handlerMap.get(namespace);
+                    const entry = Object.freeze({ plugin: name, handler });
+                    if (list) {
+                        list.push(entry);
+                    }
+                    else {
+                        handlerMap.set(namespace, [entry]);
+                    }
+                }
+            }
+            if (plugin.transformResolvedToken) {
+                transforms.push(Object.freeze({ plugin: name, transform: plugin.transformResolvedToken }));
+            }
+        }
+        const frozenHandlers = new Map();
+        for (const [namespace, entries] of handlerMap.entries()) {
+            frozenHandlers.set(namespace, Object.freeze(entries.slice()));
+        }
+        this.#handlers = frozenHandlers;
+        this.#transforms =
+            transforms.length === 0 ? EMPTY_TRANSFORM_ENTRIES : Object.freeze(transforms.slice());
+    }
+    createExtensionCollector(document, diagnostics) {
+        if (this.#handlers.size === 0) {
+            return undefined;
+        }
+        return new ExtensionCollectorImpl(this.#handlers, document, diagnostics);
+    }
+    get transforms() {
+        return this.#transforms;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW1D,MAAM,iBAAiB,GAA0B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACnE,MAAM,2BAA2B,GAAmC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACtF,MAAM,uBAAuB,GAA2C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAqB1F,MAAM,sBAAsB;IAKP;IACA;IACA;IANnB,QAAQ,GAA0B,EAAE,CAAC;IACrC,UAAU,CAAkC;IAE5C,YACmB,QAA6B,EAC7B,QAAqB,EACrB,WAAyB;QAFzB,aAAQ,GAAR,QAAQ,CAAqB;QAC7B,aAAQ,GAAR,QAAQ,CAAa;QACrB,gBAAW,GAAX,WAAW,CAAc;IACzC,CAAC;IAEJ,MAAM,CAAC,UAA+B;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,2BAA2B,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACrF,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBAC3D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;wBACrC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,MAAM,CAAC,MAAM,CAAC;oBACZ,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,SAAS,EAAE,UAAU,CAAC,SAAS;oBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,UAAU,EAAE,MAAM,EAAE,UAAU;oBAC9B,WAAW;iBACZ,CAAC,CACH,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,gCAAgC,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,2BAA2B,CAAC;YAC9C,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF;AAED,SAAS,2BAA2B,CAClC,UAA+B,EAC/B,QAAqB;IAErB,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,gCAAgC,CACvC,UAA+B,EAC/B,MAAc,EACd,KAAc;IAEd,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO;QACL,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,gBAAgB;QAC9C,OAAO,EAAE,WAAW,MAAM,kCAAkC,UAAU,CAAC,SAAS,MAAM,OAAO,EAAE;QAC/F,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAA4B;IACrD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAyF;IAEzF,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,SAAS,CAAsB;IAC/B,WAAW,CAAyC;IAE7D,YAAY,UAAmC,EAAE;QAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;QAC9D,MAAM,UAAU,GAAkC,EAAE,CAAC;QAErD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC5E,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YAEzB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACxE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;wBAClC,MAAM,IAAI,SAAS,CACjB,oCAAoC,SAAS,gBAAgB,IAAI,uBAAuB,CACzF,CAAC;oBACJ,CAAC;oBACD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACvC,MAAM,KAAK,GAA0B,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC9E,IAAI,IAAI,EAAE,CAAC;wBACT,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;gBAClC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAA4C,CAAC;QAC3E,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,cAAc,CAAC;QAChC,IAAI,CAAC,WAAW;YACd,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,wBAAwB,CACtB,QAAqB,EACrB,WAAyB;QAEzB,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,sBAAsB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF"}