@lapidist/dtif-parser 0.5.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # @lapidist/dtif-parser changelog
 
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`632f48e`](https://github.com/bylapidist/dtif/commit/632f48ed3fa2683e3d4e4808c52d9deaabd38af3)]:
+  - @lapidist/dtif-schema@1.0.1
+  - @lapidist/dtif-validator@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Remove the legacy `DiagnosticBag` helper in favour of working directly with domain `DiagnosticEvent` arrays and update the CLI
+  summary utilities accordingly.
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Replace the legacy document cache interface with the domain-level cache port so session options and helpers consume
+  `RawDocumentIdentity` aware caches directly.
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - - Replace token parsing diagnostics with domain-level `DiagnosticEvent` objects so `parseTokens` and `parseTokensSync` surface the same structured events as `parseDocument`.
+  - Remove the token diagnostic helpers in favour of a shared `formatDiagnostic` utility and update the Node adapter to emit domain diagnostics.
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Rename the session `cache` option to `documentCache` and update token helpers to
+  forward document caches through the base session options. Update your
+  integrations to pass `documentCache` when supplying custom document caches.
+
+### Minor Changes
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Promote the domain token cache primitives by removing the legacy `ParseCache` adapter, renaming the public API to `TokenCache`,
+  and updating the parser documentation to describe the new `tokenCache` option alongside the domain-first plugin infrastructure.
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Introduce application-layer use cases that orchestrate the new domain services and adapters so synchronous and asynchronous
+  pipelines can share the same flow, adopt the document/token orchestration inside the async parseTokens entrypoint, and port
+  parseTokensSync onto the same use case with dedicated inline ingestion/decoding adapters to eliminate duplicated parsing
+  logic while reshaping token cache key derivation to depend on domain-level configuration instead of resolved session
+  options.
+
+  Centralize token cache variant derivation inside the shared ParseTokens use case so cache keys always reflect the same
+  flatten/include configuration regardless of entrypoint.
+
+  Expose the application-level parse result shape directly from `parseDocument`, `parseCollection`, and the CLI so
+  consumers receive domain diagnostics alongside graph/resolution snapshots without the legacy compatibility wrapper.
+
+  Remove the legacy document compatibility layer so parse sessions and token helpers operate on the domain raw document
+  model directly, simplifying caching, diagnostics, and downstream adapters.
+
+  Retire the CLI diagnostic shim by teaching the command to consume domain diagnostic events directly, allowing the shared
+  bag/serialization utilities to operate without converting back to the legacy diagnostic shape.
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Refine override evaluation to route diagnostics through the shared collector so resolver internals no longer manage ad-hoc arrays.
+
+### Patch Changes
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Fix token flattening generics and inline ingestion utilities so the parser build
+  and lint suites succeed under the new domain-first pipeline.
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - - Preserve token flattener diagnostics in cached snapshots so warm parses continue reporting them.
+
+- [#92](https://github.com/bylapidist/dtif/pull/92) [`3bbe4e6`](https://github.com/bylapidist/dtif/commit/3bbe4e65974380b36a90834e79273c815f1f04e8) Thanks [@brettdorrans](https://github.com/brettdorrans)! - - Consolidate document-request normalization behind a shared factory and reuse it across session and token entry points.
+  - Move inline document handle and decoder helpers into the application layer so ingestion adapters no longer depend on token utilities.
+  - Route the CLI through the shared parse-document use case so it no longer depends on the legacy session orchestration.
+- Updated dependencies []:
+  - @lapidist/dtif-schema@1.0.0
+  - @lapidist/dtif-validator@1.0.0
+
 ## 0.5.0
 
 ### Patch Changes

package/README.md

@@ -5,7 +5,7 @@ package provides the reference pipeline for loading, validating, normalising,
 and resolving DTIF documents while emitting structured diagnostics for tooling
 and automation workflows.
 
-> Documentation: [Using the DTIF parser](https://dtif.lapidist.net/guides/dtif-parser/)
+> Documentation: [Using the DTIF parser](https://dtif.lapidist.net/guides/dtif-parser)
 
 ## Installation
 
@@ -46,7 +46,7 @@ for (const token of flattened) {
 ```
 
 Pass `onDiagnostic` to observe parser diagnostics as they are produced and `warn`
-to intercept non-fatal issues. Both callbacks receive `TokenDiagnostic`
+to intercept non-fatal issues. Both callbacks receive domain `DiagnosticEvent`
 objects, allowing you to format or surface them immediately without waiting for
 the promise to resolve.
 
@@ -61,14 +61,19 @@ await parseTokens('tokens.json', {
 });
 ```
 
-Provide a `ParseCache` implementation, such as the built-in
-`InMemoryParseCache`, to reuse flattening and resolution results across runs or
+Provide a `TokenCache` implementation, such as the built-in
+`InMemoryTokenCache`, to reuse flattening and resolution results across runs or
 for synchronous parsing with `parseTokensSync` when your inputs are already
 available in memory.
 
 Create a session with `createSession` to reuse caches, install custom document
 loaders, register plugins, or parse multiple collections with shared state.
 
+Each pipeline stage emits domain `DiagnosticEvent` objects instead of throwing.
+Results aggregate every diagnostic (including cache hits) so tooling can stream
+warnings via `onDiagnostic`/`warn` hooks, persist them for later inspection, or
+format them with `formatDiagnostic`.
+
 ### Node adapter
 
 For Node-based tooling, import the bundled adapter to read DTIF token files from
@@ -90,11 +95,24 @@ try {
 const document = await readTokensFile('tokens/base.tokens.json');
 ```
 
+## Architecture overview
+
+- `createSession` coordinates the loader, schema guard, normaliser, graph
+  builder, and resolver for each request. Sessions keep caches and plugins in
+  sync across parses.
+- Domain caches receive `RawDocumentIdentity` keys and ensure decoded bytes, AST
+  snapshots, and flattened token artefacts can be reused safely between runs.
+- Diagnostic events surface from every stage and persist in token cache entries
+  so warm parses provide the same visibility as cold runs.
+- Helper APIs (`parseTokens`, `parseTokensSync`, `createMetadataSnapshot`, and
+  `createResolutionSnapshot`) layer on snapshot builders without bypassing the
+  session lifecycle.
+
 ## Development
 
-- [Parser package structure](../docs/tooling/dtif-parser-package-structure.md) documents the current
-  module layout, session lifecycle, and testing conventions that future
-  roadmap work will build upon.
+- [Parser guide architecture section](../docs/guides/dtif-parser.md#package-architecture)
+  documents the current module layout, session lifecycle, and testing
+  conventions that future roadmap work will build upon.
 
 ## Command line interface
 

package/dist/adapters/domain/diagnostics.d.ts

@@ -0,0 +1,7 @@
+import type { DiagnosticEvent, PipelineDiagnostics } from '../../domain/models.js';
+export declare const EMPTY_PIPELINE_DIAGNOSTICS: PipelineDiagnostics;
+export declare function toPipelineDiagnostics(diagnostics: readonly DiagnosticEvent[]): PipelineDiagnostics;
+export declare const toDomainDiagnostic: typeof freezeDiagnosticEvent;
+declare function freezeDiagnosticEvent(diagnostic: DiagnosticEvent): DiagnosticEvent;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/adapters/domain/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/adapters/domain/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,0BAA0B,EAAE,mBAEvC,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,SAAS,eAAe,EAAE,GACtC,mBAAmB,CAQrB;AAED,eAAO,MAAM,kBAAkB,8BAAwB,CAAC;AAoBxD,iBAAS,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe,CAO3E"}

package/dist/adapters/domain/diagnostics.js

@@ -0,0 +1,30 @@
+export const EMPTY_PIPELINE_DIAGNOSTICS = Object.freeze({
+    events: Object.freeze([])
+});
+export function toPipelineDiagnostics(diagnostics) {
+    if (diagnostics.length === 0) {
+        return EMPTY_PIPELINE_DIAGNOSTICS;
+    }
+    return {
+        events: Object.freeze(diagnostics.map(freezeDiagnosticEvent))
+    };
+}
+export const toDomainDiagnostic = freezeDiagnosticEvent;
+function freezeRelated(related) {
+    if (related.length === 0) {
+        return Object.freeze([]);
+    }
+    return Object.freeze(related.map((info) => Object.freeze({
+        message: info.message,
+        pointer: info.pointer,
+        span: info.span
+    })));
+}
+function freezeDiagnosticEvent(diagnostic) {
+    const related = diagnostic.related ? freezeRelated(diagnostic.related) : undefined;
+    return Object.freeze({
+        ...diagnostic,
+        related
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/adapters/domain/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/adapters/domain/diagnostics.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,0BAA0B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,WAAuC;IAEvC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;KAChC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAExD,SAAS,aAAa,CACpB,OAAqD;IAErD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAClB,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,MAAM,CAAC,MAAM,CAAC;QACZ,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CACH,CACF,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,UAA2B;IACxD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,UAAU;QACb,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/domain/document-source.d.ts

@@ -0,0 +1,12 @@
+import type { RawDocument } from '../../domain/models.js';
+import type { DocumentRequest, DocumentSourcePort } from '../../domain/ports.js';
+import type { DocumentLoader, DocumentLoaderContext } from '../../io/document-loader.js';
+export interface DocumentLoaderSourceOptions {
+    readonly context?: DocumentLoaderContext;
+}
+export declare class DocumentLoaderSource implements DocumentSourcePort {
+    #private;
+    constructor(loader: DocumentLoader, options?: DocumentLoaderSourceOptions);
+    load(request: DocumentRequest): Promise<RawDocument>;
+}
+//# sourceMappingURL=document-source.d.ts.map

package/dist/adapters/domain/document-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-source.d.ts","sourceRoot":"","sources":["../../../src/adapters/domain/document-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAQzF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED,qBAAa,oBAAqB,YAAW,kBAAkB;;gBAIjD,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,2BAAgC;IAKvE,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;CAkC3D"}

package/dist/adapters/domain/document-source.js

@@ -0,0 +1,96 @@
+export class DocumentLoaderSource {
+    #loader;
+    #context;
+    constructor(loader, options = {}) {
+        this.#loader = loader;
+        this.#context = options.context;
+    }
+    async load(request) {
+        const input = toParseInput(request);
+        const context = this.#mergeContext(request);
+        const handle = await this.#loader.load(input, context);
+        return {
+            identity: {
+                uri: handle.uri,
+                contentType: handle.contentType,
+                description: request.description
+            },
+            bytes: handle.bytes,
+            text: handle.text,
+            data: handle.data
+        };
+    }
+    #mergeContext(request) {
+        if (!request.baseUri && !request.signal) {
+            return this.#context;
+        }
+        if (!this.#context) {
+            return {
+                baseUri: request.baseUri,
+                signal: request.signal
+            };
+        }
+        return {
+            baseUri: request.baseUri ?? this.#context.baseUri,
+            signal: request.signal ?? this.#context.signal
+        };
+    }
+}
+function toParseInput(request) {
+    if (request.inlineData !== undefined) {
+        return toDataRecord(request);
+    }
+    if (request.inlineContent !== undefined) {
+        return toContentRecord(request);
+    }
+    if (request.uri !== undefined) {
+        return request.uri;
+    }
+    throw new Error('Document request must provide a URI, inline content, or inline data.');
+}
+function toDataRecord(request) {
+    const { inlineData } = request;
+    assertDesignTokenDocument(inlineData);
+    return {
+        uri: request.uri,
+        data: inlineData,
+        contentType: normalizeContentType(request.contentTypeHint)
+    };
+}
+function toContentRecord(request) {
+    const { inlineContent } = request;
+    if (inlineContent === undefined) {
+        throw new TypeError('Inline content must be provided when no URI is supplied.');
+    }
+    return {
+        uri: request.uri,
+        content: inlineContent,
+        contentType: normalizeContentType(request.contentTypeHint)
+    };
+}
+function normalizeContentType(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.toLowerCase();
+    return isContentType(normalized) ? normalized : undefined;
+}
+function isContentType(value) {
+    return value === 'application/json' || value === 'application/yaml';
+}
+function assertDesignTokenDocument(value) {
+    if (!isDesignTokenDocument(value)) {
+        throw new TypeError('Inline data must be a design token document.');
+    }
+}
+function isDesignTokenDocument(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    if (value instanceof URL || value instanceof Uint8Array) {
+        return false;
+    }
+    const prototype = Reflect.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=document-source.js.map

package/dist/adapters/domain/document-source.js.map

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

package/dist/adapters/domain/index.d.ts

@@ -0,0 +1,8 @@
+export { DocumentLoaderSource } from './document-source.js';
+export type { DocumentLoaderSourceOptions } from './document-source.js';
+export { PluginExtensionCollectorAdapter, PluginTransformExecutorAdapter } from './plugins.js';
+export type { PluginExtensionCollectorContext, PluginExtensionCollectorResult, PluginTransformExecutionContext, PluginTransformExecutionResult } from './plugins.js';
+export { DocumentIngestionAdapter, DocumentDecodingAdapter, InlineDocumentIngestionAdapter, InlineDocumentDecodingAdapter, SchemaValidationAdapter, DocumentNormalizationAdapter, GraphConstructionAdapter, ResolutionAdapter, TokenFlatteningAdapter } from './services.js';
+export type { DocumentDecodingAdapterOptions, DocumentNormalizationAdapterOptions, ResolutionAdapterOptions, TokenFlatteningAdapterOptions } from './services.js';
+export { EMPTY_PIPELINE_DIAGNOSTICS, toDomainDiagnostic, toPipelineDiagnostics } from './diagnostics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/domain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC/F,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,8BAA8B,EAC9B,mCAAmC,EACnC,wBAAwB,EACxB,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC"}

package/dist/adapters/domain/index.js

@@ -0,0 +1,5 @@
+export { DocumentLoaderSource } from './document-source.js';
+export { PluginExtensionCollectorAdapter, PluginTransformExecutorAdapter } from './plugins.js';
+export { DocumentIngestionAdapter, DocumentDecodingAdapter, InlineDocumentIngestionAdapter, InlineDocumentDecodingAdapter, SchemaValidationAdapter, DocumentNormalizationAdapter, GraphConstructionAdapter, ResolutionAdapter, TokenFlatteningAdapter } from './services.js';
+export { EMPTY_PIPELINE_DIAGNOSTICS, toDomainDiagnostic, toPipelineDiagnostics } from './diagnostics.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/domain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAO/F,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAOvB,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC"}

package/dist/adapters/domain/plugins.d.ts

@@ -0,0 +1,20 @@
+import type { ExtensionCollectionContext, ExtensionEvaluationSnapshot, PipelineResult, TokenTransformEvaluationSnapshot, TransformExecutionContext } from '../../domain/models.js';
+import type { ExtensionCollectorPort, TransformExecutorPort } from '../../domain/ports.js';
+import type { PluginRegistry } from '../../plugins/index.js';
+import type { ResolvedTokenTransformEntry } from '../../plugins/registry.js';
+import type { ResolvedToken } from '../../resolver/types.js';
+export type PluginExtensionCollectorContext = ExtensionCollectionContext;
+export type PluginExtensionCollectorResult = PipelineResult<readonly ExtensionEvaluationSnapshot[]>;
+export type PluginTransformExecutionContext = TransformExecutionContext<ResolvedToken>;
+export type PluginTransformExecutionResult = PipelineResult<readonly TokenTransformEvaluationSnapshot[]>;
+export declare class PluginExtensionCollectorAdapter implements ExtensionCollectorPort<PluginExtensionCollectorContext, PluginExtensionCollectorResult> {
+    #private;
+    constructor(registry: PluginRegistry);
+    collect(context: PluginExtensionCollectorContext): PluginExtensionCollectorResult;
+}
+export declare class PluginTransformExecutorAdapter implements TransformExecutorPort<PluginTransformExecutionContext, PluginTransformExecutionResult> {
+    #private;
+    constructor(transforms: readonly ResolvedTokenTransformEntry[]);
+    execute(context: PluginTransformExecutionContext): PluginTransformExecutionResult;
+}
+//# sourceMappingURL=plugins.d.ts.map

package/dist/adapters/domain/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/adapters/domain/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,gCAAgC,EAChC,yBAAyB,EAE1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAsB,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAKjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAO7D,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,CAAC;AAEzE,MAAM,MAAM,8BAA8B,GAAG,cAAc,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAAC;AAEpG,MAAM,MAAM,+BAA+B,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC;AAEvF,MAAM,MAAM,8BAA8B,GAAG,cAAc,CACzD,SAAS,gCAAgC,EAAE,CAC5C,CAAC;AAKF,qBAAa,+BACX,YAAW,sBAAsB,CAAC,+BAA+B,EAAE,8BAA8B,CAAC;;gBAItF,QAAQ,EAAE,cAAc;IAIpC,OAAO,CAAC,OAAO,EAAE,+BAA+B,GAAG,8BAA8B;CA8DlF;AAED,qBAAa,8BACX,YAAW,qBAAqB,CAAC,+BAA+B,EAAE,8BAA8B,CAAC;;gBAIrF,UAAU,EAAE,SAAS,2BAA2B,EAAE;IAI9D,OAAO,CAAC,OAAO,EAAE,+BAA+B,GAAG,8BAA8B;CAgDlF"}

package/dist/adapters/domain/plugins.js

@@ -0,0 +1,99 @@
+import { createTransformFailureDiagnostic, freezeResultDiagnostics } from '../../resolver/internal/helpers.js';
+import { EMPTY_PIPELINE_DIAGNOSTICS, toDomainDiagnostic, toPipelineDiagnostics } from './diagnostics.js';
+const EMPTY_EXTENSION_RESULTS = Object.freeze([]);
+const EMPTY_TRANSFORM_RESULTS = Object.freeze([]);
+export class PluginExtensionCollectorAdapter {
+    #registry;
+    constructor(registry) {
+        this.#registry = registry;
+    }
+    collect(context) {
+        const diagnostics = [];
+        const collector = this.#createCollector(context.document, diagnostics);
+        if (!collector || context.invocations.length === 0) {
+            return {
+                outcome: EMPTY_EXTENSION_RESULTS,
+                diagnostics: diagnostics.length === 0 ? EMPTY_PIPELINE_DIAGNOSTICS : toPipelineDiagnostics(diagnostics)
+            };
+        }
+        for (const invocation of context.invocations) {
+            collector.handle({
+                namespace: invocation.namespace,
+                pointer: invocation.pointer,
+                span: invocation.span,
+                value: invocation.value
+            });
+        }
+        const evaluations = collector.results();
+        if (evaluations.length === 0) {
+            return {
+                outcome: EMPTY_EXTENSION_RESULTS,
+                diagnostics: diagnostics.length === 0 ? EMPTY_PIPELINE_DIAGNOSTICS : toPipelineDiagnostics(diagnostics)
+            };
+        }
+        const snapshots = evaluations.map((evaluation) => {
+            const diagnosticsSnapshot = evaluation.diagnostics.length === 0
+                ? Object.freeze([])
+                : Object.freeze(evaluation.diagnostics.map(toDomainDiagnostic));
+            const snapshot = Object.freeze({
+                plugin: evaluation.plugin,
+                namespace: evaluation.namespace,
+                pointer: evaluation.pointer,
+                span: evaluation.span,
+                value: evaluation.value,
+                normalized: evaluation.normalized,
+                diagnostics: diagnosticsSnapshot
+            });
+            return snapshot;
+        });
+        return {
+            outcome: Object.freeze(snapshots),
+            diagnostics: diagnostics.length === 0 ? EMPTY_PIPELINE_DIAGNOSTICS : toPipelineDiagnostics(diagnostics)
+        };
+    }
+    #createCollector(document, diagnostics) {
+        return this.#registry.createExtensionCollector(document, diagnostics);
+    }
+}
+export class PluginTransformExecutorAdapter {
+    #transforms;
+    constructor(transforms) {
+        this.#transforms = transforms;
+    }
+    execute(context) {
+        if (this.#transforms.length === 0) {
+            return { outcome: EMPTY_TRANSFORM_RESULTS, diagnostics: EMPTY_PIPELINE_DIAGNOSTICS };
+        }
+        const diagnostics = [];
+        const snapshots = [];
+        for (const entry of this.#transforms) {
+            try {
+                const result = entry.transform(context.token, { document: context.document });
+                const transformDiagnostics = freezeResultDiagnostics(result?.diagnostics);
+                if (transformDiagnostics.length > 0) {
+                    diagnostics.push(...transformDiagnostics);
+                }
+                const evaluationDiagnostics = transformDiagnostics.length === 0
+                    ? Object.freeze([])
+                    : Object.freeze(transformDiagnostics.map(toDomainDiagnostic));
+                const evaluation = Object.freeze({
+                    plugin: entry.plugin,
+                    pointer: context.token.pointer,
+                    data: result?.data,
+                    diagnostics: evaluationDiagnostics
+                });
+                snapshots.push(evaluation);
+            }
+            catch (error) {
+                const diagnostic = createTransformFailureDiagnostic(entry.plugin, context.token.pointer, error);
+                diagnostics.push(diagnostic);
+            }
+        }
+        const outcome = snapshots.length === 0 ? EMPTY_TRANSFORM_RESULTS : Object.freeze(snapshots.slice());
+        return {
+            outcome,
+            diagnostics: diagnostics.length === 0 ? EMPTY_PIPELINE_DIAGNOSTICS : toPipelineDiagnostics(diagnostics)
+        };
+    }
+}
+//# sourceMappingURL=plugins.js.map

package/dist/adapters/domain/plugins.js.map

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

package/dist/adapters/domain/services.d.ts

@@ -0,0 +1,82 @@
+import { createDocumentResolver } from '../../resolver/index.js';
+import { decodeDocument } from '../../io/decoder.js';
+import type { SchemaGuard } from '../../validation/schema-guard.js';
+import type { ResolvedTokenTransformEntry } from '../../plugins/registry.js';
+import type { PluginRegistry } from '../../plugins/index.js';
+import { flattenTokens } from '../../tokens/flatten.js';
+import { createMetadataSnapshot, createResolutionSnapshot } from '../../tokens/snapshots.js';
+import type { TokenCacheSnapshot } from '../../tokens/cache.js';
+import type { InlineDocumentRequestInput } from '../../application/requests.js';
+import type { DecodedDocument, GraphSnapshot, NormalizedDocument, PipelineResult, RawDocument, ResolutionOutcome, TokenSnapshot } from '../../domain/models.js';
+import type { DocumentDecodingService, DocumentIngestionService, DocumentNormalizationService, GraphConstructionService, ResolutionContext, ResolutionService, SchemaValidationService, TokenFlatteningService } from '../../domain/services.js';
+import type { DocumentRequest, DocumentSourcePort, GraphBuilderPort, NormalizationPort, ResolutionPort, SchemaValidationPort, TokenFlatteningPort, TokenFlatteningRequest } from '../../domain/ports.js';
+import type { DocumentAst } from '../../ast/nodes.js';
+import type { DocumentGraph } from '../../graph/nodes.js';
+export declare class DocumentIngestionAdapter implements DocumentIngestionService {
+    readonly source: DocumentSourcePort;
+    constructor(source: DocumentSourcePort);
+    ingest(request: DocumentRequest): Promise<PipelineResult<RawDocument | undefined>>;
+}
+export declare class InlineDocumentIngestionAdapter implements DocumentIngestionService {
+    #private;
+    readonly source: DocumentSourcePort;
+    constructor(input: InlineDocumentRequestInput);
+    ingest(request: DocumentRequest): PipelineResult<RawDocument | undefined>;
+}
+export interface DocumentDecodingAdapterOptions {
+    readonly decode?: typeof decodeDocument;
+}
+export declare class DocumentDecodingAdapter implements DocumentDecodingService {
+    #private;
+    constructor(options?: DocumentDecodingAdapterOptions);
+    decode(document: RawDocument): Promise<PipelineResult<DecodedDocument | undefined>>;
+}
+export declare class InlineDocumentDecodingAdapter implements DocumentDecodingService {
+    decode(document: RawDocument): PipelineResult<DecodedDocument | undefined>;
+}
+export declare class SchemaValidationAdapter implements SchemaValidationService {
+    #private;
+    readonly validator: SchemaValidationPort;
+    constructor(guard: SchemaGuard);
+    validate(document: DecodedDocument): PipelineResult<boolean>;
+}
+export interface DocumentNormalizationAdapterOptions {
+    readonly normalizer?: NormalizationPort<DocumentAst>;
+    readonly extensions?: PluginRegistry;
+}
+export declare class DocumentNormalizationAdapter implements DocumentNormalizationService<DocumentAst> {
+    readonly normalizer: NormalizationPort<DocumentAst>;
+    constructor(options?: DocumentNormalizationAdapterOptions);
+    normalize(document: DecodedDocument): Promise<PipelineResult<NormalizedDocument<DocumentAst> | undefined>> | PipelineResult<NormalizedDocument<DocumentAst> | undefined>;
+}
+export declare class GraphConstructionAdapter implements GraphConstructionService<DocumentGraph, DocumentAst> {
+    readonly builder: GraphBuilderPort<DocumentGraph, DocumentAst>;
+    constructor(builder?: GraphBuilderPort<DocumentGraph, DocumentAst>);
+    build(document: NormalizedDocument<DocumentAst>): Promise<PipelineResult<GraphSnapshot<DocumentGraph> | undefined>> | PipelineResult<GraphSnapshot<DocumentGraph> | undefined>;
+}
+export interface ResolutionAdapterOptions {
+    readonly overrideContext?: ReadonlyMap<string, unknown>;
+    readonly maxDepth?: number;
+    readonly transforms?: readonly ResolvedTokenTransformEntry[];
+}
+type ResolverInstance = ReturnType<typeof createDocumentResolver>;
+export declare class ResolutionAdapter implements ResolutionService<DocumentGraph, ResolverInstance, DocumentAst> {
+    #private;
+    readonly resolver: ResolutionPort<DocumentGraph, ResolverInstance, DocumentAst>;
+    constructor(options?: ResolutionAdapterOptions);
+    resolve(graph: GraphSnapshot<DocumentGraph>, context: ResolutionContext<DocumentAst>): PipelineResult<ResolutionOutcome<ResolverInstance> | undefined>;
+}
+export interface TokenFlatteningAdapterOptions {
+    readonly metadataSnapshot?: typeof createMetadataSnapshot;
+    readonly resolutionSnapshot?: typeof createResolutionSnapshot;
+    readonly flattenTokens?: typeof flattenTokens;
+    readonly clock?: () => number;
+}
+export declare class TokenFlatteningAdapter implements TokenFlatteningService<ResolverInstance, DocumentGraph, TokenCacheSnapshot> {
+    #private;
+    readonly flattener: TokenFlatteningPort<ResolverInstance, DocumentGraph, TokenCacheSnapshot>;
+    constructor(options?: TokenFlatteningAdapterOptions);
+    flatten(request: TokenFlatteningRequest<DocumentGraph, ResolverInstance>): PipelineResult<TokenSnapshot<TokenCacheSnapshot> | undefined>;
+}
+export {};
+//# sourceMappingURL=services.d.ts.map

package/dist/adapters/domain/services.d.ts.map

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