@lapidist/dtif-parser 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @lapidist/dtif-parser changelog
+
+## 0.2.0
+
+### Minor Changes
+
+- [#55](https://github.com/bylapidist/dtif/pull/55) [`df44ed8`](https://github.com/bylapidist/dtif/commit/df44ed8cc76d22e6780b6b4b4e6965ff42c76130) Thanks [@brettdorrans](https://github.com/brettdorrans)! - Introduce the canonical DTIF parser package with the full pipeline from loading
+  and decoding through schema validation, normalisation, graph construction, and
+  resolution. Ship the `dtif-parse` CLI, document and cache integrations,
+  configurable resolver depth limits, and plugin hooks that surface extension
+  results and resolved-token transforms alongside structured diagnostics.
+
+All notable changes to this project will be documented in this file.
+
+Release notes are generated from Changesets during publishing.

package/README.md

@@ -0,0 +1,50 @@
+# @lapidist/dtif-parser
+
+Canonical parser and runtime for the Design Token Interchange Format (DTIF). The
+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/)
+
+## Installation
+
+```bash
+npm install @lapidist/dtif-parser
+```
+
+The package targets modern Node runtimes (v18+) and is published as a native ESM
+module.
+
+## Usage
+
+```ts
+import { parseDocument } from '@lapidist/dtif-parser';
+
+const result = await parseDocument('tokens.json');
+
+for (const diagnostic of result.diagnostics) {
+  console.error(`${diagnostic.severity}: ${diagnostic.message}`);
+}
+
+const resolved = result.resolver?.resolve('#/color/brand/primary');
+console.log(resolved?.value);
+```
+
+Create a session with `createSession` to reuse caches, install custom document
+loaders, register plugins, or parse multiple collections with shared state.
+
+## Command line interface
+
+The workspace publishes a `dtif-parse` binary for quick inspection and CI
+pipelines:
+
+```bash
+dtif-parse tokens/base.tokens.json --resolve "#/color/brand/primary"
+```
+
+Use `dtif-parse --help` for the full list of options and output formats.
+
+## License
+
+MIT © Lapidist

package/dist/ast/nodes.d.ts

@@ -0,0 +1,73 @@
+import type { JsonPointer, SourceSpan } from '../types.js';
+export interface AstField<T> {
+    readonly value: T;
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+}
+export interface DeprecatedMetadata {
+    readonly active: boolean;
+    readonly replacement?: AstField<string>;
+}
+export interface NodeMetadata {
+    readonly description?: AstField<string>;
+    readonly extensions?: AstField<Readonly<Record<string, unknown>>>;
+    readonly deprecated?: AstField<DeprecatedMetadata>;
+    readonly lastModified?: AstField<string>;
+    readonly lastUsed?: AstField<string>;
+    readonly usageCount?: AstField<number>;
+    readonly author?: AstField<string>;
+    readonly tags?: AstField<readonly string[]>;
+    readonly hash?: AstField<string>;
+}
+export interface BaseNode {
+    readonly kind: 'collection' | 'token' | 'alias';
+    readonly name: string;
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly metadata: NodeMetadata;
+}
+export interface CollectionNode extends BaseNode {
+    readonly kind: 'collection';
+    readonly children: readonly DocumentChildNode[];
+}
+export interface TokenNode extends BaseNode {
+    readonly kind: 'token';
+    readonly type?: AstField<string>;
+    readonly value?: AstField<unknown>;
+}
+export interface AliasNode extends BaseNode {
+    readonly kind: 'alias';
+    readonly type: AstField<string>;
+    readonly ref: AstField<string>;
+}
+export type DocumentChildNode = CollectionNode | TokenNode | AliasNode;
+export interface OverrideFallbackNode {
+    readonly kind: 'fallback';
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly ref?: AstField<string>;
+    readonly value?: AstField<unknown>;
+    readonly fallback?: readonly OverrideFallbackNode[];
+}
+export interface OverrideNode {
+    readonly kind: 'override';
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly token: AstField<string>;
+    readonly when: AstField<Readonly<Record<string, unknown>>>;
+    readonly ref?: AstField<string>;
+    readonly value?: AstField<unknown>;
+    readonly fallback?: readonly OverrideFallbackNode[];
+}
+export interface DocumentAst {
+    readonly kind: 'document';
+    readonly uri: URL;
+    readonly pointer: JsonPointer;
+    readonly span?: SourceSpan;
+    readonly schema?: AstField<string>;
+    readonly version?: AstField<string>;
+    readonly metadata: NodeMetadata;
+    readonly children: readonly DocumentChildNode[];
+    readonly overrides: readonly OverrideNode[];
+}
+//# sourceMappingURL=nodes.d.ts.map

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

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

package/dist/ast/nodes.js

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

package/dist/ast/nodes.js.map

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

package/dist/ast/normaliser/context.d.ts

@@ -0,0 +1,22 @@
+import type { ExtensionCollector, ExtensionEvaluation } from '../../plugins/index.js';
+import type { Diagnostic, JsonPointer, RawDocument, SourceSpan } from '../../types.js';
+import type { DocumentAst } from '../nodes.js';
+export interface NormaliserOptions {
+    readonly extensions?: {
+        createExtensionCollector(document: RawDocument, diagnostics: Diagnostic[]): ExtensionCollector | undefined;
+    };
+}
+export interface NormaliserContext {
+    readonly document: RawDocument;
+    readonly diagnostics: Diagnostic[];
+    readonly extensions?: ExtensionCollector;
+}
+export interface NormaliserResult {
+    readonly ast?: DocumentAst;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly extensions: readonly ExtensionEvaluation[];
+}
+export declare function createNormaliserContext(document: RawDocument, options: NormaliserOptions): NormaliserContext;
+export declare function finalizeNormalisation(context: NormaliserContext, ast?: DocumentAst): NormaliserResult;
+export declare function getSourceSpan(context: NormaliserContext, pointer: JsonPointer): SourceSpan | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/ast/normaliser/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/ast/normaliser/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,wBAAwB,CACtB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,UAAU,EAAE,GACxB,kBAAkB,GAAG,SAAS,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACrD;AAKD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,iBAAiB,GACzB,iBAAiB,CASnB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,CAAC,EAAE,WAAW,GAChB,gBAAgB,CAYlB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,WAAW,GACnB,UAAU,GAAG,SAAS,CAExB"}

package/dist/ast/normaliser/context.js

@@ -0,0 +1,26 @@
+const EMPTY_DIAGNOSTICS = Object.freeze([]);
+const EMPTY_EXTENSION_RESULTS = Object.freeze([]);
+export function createNormaliserContext(document, options) {
+    const diagnostics = [];
+    const extensions = options.extensions?.createExtensionCollector?.(document, diagnostics);
+    return {
+        document,
+        diagnostics,
+        extensions
+    };
+}
+export function finalizeNormalisation(context, ast) {
+    const diagnostics = context.diagnostics.length === 0
+        ? EMPTY_DIAGNOSTICS
+        : Object.freeze(context.diagnostics.map((diagnostic) => Object.freeze(diagnostic)));
+    const extensions = context.extensions?.results() ?? EMPTY_EXTENSION_RESULTS;
+    return {
+        ast,
+        diagnostics,
+        extensions
+    };
+}
+export function getSourceSpan(context, pointer) {
+    return context.document.sourceMap.pointers.get(pointer);
+}
+//# sourceMappingURL=context.js.map

package/dist/ast/normaliser/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/ast/normaliser/context.ts"],"names":[],"mappings":"AAyBA,MAAM,iBAAiB,GAA0B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACnE,MAAM,uBAAuB,GAAmC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAElF,MAAM,UAAU,uBAAuB,CACrC,QAAqB,EACrB,OAA0B;IAE1B,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,wBAAwB,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEzF,OAAO;QACL,QAAQ;QACR,WAAW;QACX,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA0B,EAC1B,GAAiB;IAEjB,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAC9B,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,uBAAuB,CAAC;IAE5E,OAAO;QACL,GAAG;QACH,WAAW;QACX,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAA0B,EAC1B,OAAoB;IAEpB,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC1D,CAAC"}

package/dist/ast/normaliser/document.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentAst } from '../nodes.js';
+import type { NormaliserContext } from './context.js';
+export declare function buildDocumentAst(context: NormaliserContext): DocumentAst | undefined;
+//# sourceMappingURL=document.d.ts.map

package/dist/ast/normaliser/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/ast/normaliser/document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAOtD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,GAAG,SAAS,CA4CpF"}

package/dist/ast/normaliser/document.js

@@ -0,0 +1,49 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { JSON_POINTER_ROOT, appendJsonPointer } from '../../utils/json-pointer.js';
+import { readOptionalStringField } from './fields.js';
+import { getSourceSpan } from './context.js';
+import { extractMetadata } from './metadata.js';
+import { normalizeNode } from './nodes.js';
+import { normalizeOverrides } from './overrides.js';
+import { freezeDocumentAst, isPlainObject } from './utils.js';
+export function buildDocumentAst(context) {
+    const { document } = context;
+    const data = document.data;
+    if (!isPlainObject(data)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_ROOT,
+            message: 'DTIF document root must be a JSON object.',
+            severity: 'error',
+            pointer: JSON_POINTER_ROOT,
+            span: getSourceSpan(context, JSON_POINTER_ROOT)
+        });
+        return undefined;
+    }
+    const metadata = extractMetadata(context, data, JSON_POINTER_ROOT);
+    const schemaField = readOptionalStringField(context, data, '$schema', JSON_POINTER_ROOT);
+    const versionField = readOptionalStringField(context, data, '$version', JSON_POINTER_ROOT);
+    const overrides = normalizeOverrides(context, data, JSON_POINTER_ROOT);
+    const children = [];
+    for (const [name, value] of Object.entries(data)) {
+        if (name.startsWith('$')) {
+            continue;
+        }
+        const pointer = appendJsonPointer(JSON_POINTER_ROOT, name);
+        const node = normalizeNode(context, name, value, pointer);
+        if (node) {
+            children.push(node);
+        }
+    }
+    return freezeDocumentAst({
+        kind: 'document',
+        uri: document.uri,
+        pointer: JSON_POINTER_ROOT,
+        span: getSourceSpan(context, JSON_POINTER_ROOT),
+        schema: schemaField,
+        version: versionField,
+        metadata,
+        children,
+        overrides
+    });
+}
+//# sourceMappingURL=document.js.map

package/dist/ast/normaliser/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/ast/normaliser/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAE3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;YACvB,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,YAAY;YAC7C,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,iBAAiB;YAC1B,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC;SAChD,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACzF,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,IAAI,EAAE,CAAC;YACT,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,iBAAiB,CAAC;QACvB,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,OAAO,EAAE,iBAAiB;QAC1B,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC;QAC/C,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,YAAY;QACrB,QAAQ;QACR,QAAQ;QACR,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/ast/normaliser/fields.d.ts

@@ -0,0 +1,7 @@
+import type { JsonPointer } from '../../types.js';
+import type { AstField } from '../nodes.js';
+import type { NormaliserContext } from './context.js';
+export declare function readOptionalStringField(context: NormaliserContext, value: Record<string, unknown>, key: string, pointer: JsonPointer): AstField<string> | undefined;
+export declare function readRequiredStringField(context: NormaliserContext, value: Record<string, unknown>, key: string, pointer: JsonPointer): AstField<string> | undefined;
+export declare function readOverrideConditions(context: NormaliserContext, value: Record<string, unknown>, pointer: JsonPointer): AstField<Readonly<Record<string, unknown>>> | undefined;
+//# sourceMappingURL=fields.d.ts.map

package/dist/ast/normaliser/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/ast/normaliser/fields.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,GACnB,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAoB9B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,GACnB,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAY9B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,WAAW,GACnB,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAsCzD"}

package/dist/ast/normaliser/fields.js

@@ -0,0 +1,71 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { appendJsonPointer } from '../../utils/json-pointer.js';
+import { getSourceSpan } from './context.js';
+import { createField, freezeRecord, isPlainObject } from './utils.js';
+export function readOptionalStringField(context, value, key, pointer) {
+    if (!(key in value)) {
+        return undefined;
+    }
+    const fieldPointer = appendJsonPointer(pointer, key);
+    const raw = value[key];
+    if (typeof raw !== 'string') {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+            message: `${key} must be a string.`,
+            severity: 'error',
+            pointer: fieldPointer,
+            span: getSourceSpan(context, fieldPointer)
+        });
+        return undefined;
+    }
+    return createField(context, raw, fieldPointer);
+}
+export function readRequiredStringField(context, value, key, pointer) {
+    const field = readOptionalStringField(context, value, key, pointer);
+    if (!field) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.MISSING_REQUIRED_MEMBER,
+            message: `Override entries must declare ${key}.`,
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+    }
+    return field;
+}
+export function readOverrideConditions(context, value, pointer) {
+    if (!('$when' in value)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.MISSING_REQUIRED_MEMBER,
+            message: 'Override entries must declare $when conditions.',
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    const fieldPointer = appendJsonPointer(pointer, '$when');
+    const raw = value['$when'];
+    if (!isPlainObject(raw)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+            message: '$when must be an object containing at least one condition.',
+            severity: 'error',
+            pointer: fieldPointer,
+            span: getSourceSpan(context, fieldPointer)
+        });
+        return undefined;
+    }
+    if (Object.keys(raw).length === 0) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_OVERRIDE,
+            message: '$when must declare at least one condition.',
+            severity: 'error',
+            pointer: fieldPointer,
+            span: getSourceSpan(context, fieldPointer)
+        });
+    }
+    const frozen = freezeRecord(raw);
+    return createField(context, frozen, fieldPointer);
+}
+//# sourceMappingURL=fields.js.map

package/dist/ast/normaliser/fields.js.map

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

package/dist/ast/normaliser/metadata.d.ts

@@ -0,0 +1,5 @@
+import type { JsonPointer } from '../../types.js';
+import type { NodeMetadata } from '../nodes.js';
+import type { NormaliserContext } from './context.js';
+export declare function extractMetadata(context: NormaliserContext, value: Record<string, unknown>, pointer: JsonPointer): NodeMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/ast/normaliser/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/ast/normaliser/metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAmBtD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,WAAW,GACnB,YAAY,CAiNd"}

package/dist/ast/normaliser/metadata.js

@@ -0,0 +1,201 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { appendJsonPointer } from '../../utils/json-pointer.js';
+import { getSourceSpan } from './context.js';
+import { createField, EMPTY_METADATA, freezeRecord, isPlainObject } from './utils.js';
+import { readOptionalStringField } from './fields.js';
+const EXTENSION_KEY_PATTERN = /^[a-z0-9]+(?:\.[a-z0-9]+)+$/u;
+export function extractMetadata(context, value, pointer) {
+    const metadata = {};
+    if ('$description' in value) {
+        const description = readOptionalStringField(context, value, '$description', pointer);
+        if (description) {
+            metadata.description = description;
+        }
+    }
+    if ('$extensions' in value) {
+        const fieldPointer = appendJsonPointer(pointer, '$extensions');
+        const raw = value['$extensions'];
+        if (!isPlainObject(raw)) {
+            context.diagnostics.push({
+                code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+                message: '$extensions must be an object keyed by reverse-DNS identifiers.',
+                severity: 'error',
+                pointer: fieldPointer,
+                span: getSourceSpan(context, fieldPointer)
+            });
+        }
+        else {
+            const invalidKey = Object.keys(raw).find((key) => !EXTENSION_KEY_PATTERN.test(key));
+            if (invalidKey) {
+                context.diagnostics.push({
+                    code: DiagnosticCodes.normaliser.INVALID_EXTENSIONS,
+                    message: `Extension namespace "${invalidKey}" must use lower-case reverse-DNS format.`,
+                    severity: 'error',
+                    pointer: appendJsonPointer(fieldPointer, invalidKey),
+                    span: getSourceSpan(context, appendJsonPointer(fieldPointer, invalidKey))
+                });
+            }
+            const frozen = freezeRecord(raw);
+            metadata.extensions = createField(context, frozen, fieldPointer);
+            if (context.extensions) {
+                for (const [namespace, extensionValue] of Object.entries(frozen)) {
+                    const entryPointer = appendJsonPointer(fieldPointer, namespace);
+                    context.extensions.handle({
+                        namespace,
+                        pointer: entryPointer,
+                        span: getSourceSpan(context, entryPointer),
+                        value: extensionValue
+                    });
+                }
+            }
+        }
+    }
+    if ('$deprecated' in value) {
+        const fieldPointer = appendJsonPointer(pointer, '$deprecated');
+        const raw = value['$deprecated'];
+        if (typeof raw === 'boolean') {
+            metadata.deprecated = createField(context, { active: raw }, fieldPointer);
+        }
+        else if (isPlainObject(raw) && '$replacement' in raw) {
+            const replacementField = readOptionalStringField(context, raw, '$replacement', fieldPointer);
+            if (replacementField) {
+                metadata.deprecated = createField(context, { active: true, replacement: replacementField }, fieldPointer);
+            }
+        }
+        else {
+            context.diagnostics.push({
+                code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+                message: '$deprecated must be a boolean or an object containing $replacement.',
+                severity: 'error',
+                pointer: fieldPointer,
+                span: getSourceSpan(context, fieldPointer)
+            });
+        }
+    }
+    if ('$lastModified' in value) {
+        const lastModified = readOptionalStringField(context, value, '$lastModified', pointer);
+        if (lastModified) {
+            metadata.lastModified = lastModified;
+        }
+    }
+    if ('$lastUsed' in value) {
+        const lastUsed = readOptionalStringField(context, value, '$lastUsed', pointer);
+        if (lastUsed) {
+            metadata.lastUsed = lastUsed;
+        }
+    }
+    if ('$usageCount' in value) {
+        const fieldPointer = appendJsonPointer(pointer, '$usageCount');
+        const raw = value['$usageCount'];
+        if (typeof raw !== 'number' || !Number.isInteger(raw) || raw < 0) {
+            context.diagnostics.push({
+                code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+                message: '$usageCount must be a non-negative integer.',
+                severity: 'error',
+                pointer: fieldPointer,
+                span: getSourceSpan(context, fieldPointer)
+            });
+        }
+        else {
+            metadata.usageCount = createField(context, raw, fieldPointer);
+        }
+    }
+    if ('$author' in value) {
+        const author = readOptionalStringField(context, value, '$author', pointer);
+        if (author) {
+            metadata.author = author;
+        }
+    }
+    if ('$tags' in value) {
+        const fieldPointer = appendJsonPointer(pointer, '$tags');
+        const raw = value['$tags'];
+        if (!Array.isArray(raw)) {
+            context.diagnostics.push({
+                code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+                message: '$tags must be an array of unique strings.',
+                severity: 'error',
+                pointer: fieldPointer,
+                span: getSourceSpan(context, fieldPointer)
+            });
+        }
+        else {
+            const tags = [];
+            const seen = new Set();
+            raw.forEach((entry, index) => {
+                if (typeof entry !== 'string') {
+                    const tagPointer = appendJsonPointer(fieldPointer, String(index));
+                    context.diagnostics.push({
+                        code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+                        message: '$tags entries must be strings.',
+                        severity: 'error',
+                        pointer: tagPointer,
+                        span: getSourceSpan(context, tagPointer)
+                    });
+                    return;
+                }
+                const trimmed = entry.trim();
+                if (trimmed.length === 0) {
+                    const tagPointer = appendJsonPointer(fieldPointer, String(index));
+                    context.diagnostics.push({
+                        code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+                        message: '$tags entries must not be empty.',
+                        severity: 'error',
+                        pointer: tagPointer,
+                        span: getSourceSpan(context, tagPointer)
+                    });
+                    return;
+                }
+                if (seen.has(trimmed)) {
+                    const tagPointer = appendJsonPointer(fieldPointer, String(index));
+                    context.diagnostics.push({
+                        code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+                        message: `Duplicate tag "${trimmed}" detected.`,
+                        severity: 'error',
+                        pointer: tagPointer,
+                        span: getSourceSpan(context, tagPointer)
+                    });
+                    return;
+                }
+                seen.add(trimmed);
+                tags.push(trimmed);
+            });
+            metadata.tags = createField(context, Object.freeze(tags), fieldPointer);
+        }
+    }
+    if ('$hash' in value) {
+        const hash = readOptionalStringField(context, value, '$hash', pointer);
+        if (hash) {
+            metadata.hash = hash;
+        }
+    }
+    if (metadata.lastUsed && metadata.usageCount && metadata.usageCount.value <= 0) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_METADATA_COMBINATION,
+            message: '$lastUsed requires a positive $usageCount.',
+            severity: 'error',
+            pointer: metadata.lastUsed.pointer,
+            span: metadata.lastUsed.span
+        });
+    }
+    if (metadata.lastUsed && !metadata.usageCount) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_METADATA_COMBINATION,
+            message: '$lastUsed must be accompanied by $usageCount.',
+            severity: 'error',
+            pointer: metadata.lastUsed.pointer,
+            span: metadata.lastUsed.span
+        });
+    }
+    if (metadata.usageCount && metadata.usageCount.value > 0 && !metadata.lastUsed) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_METADATA_COMBINATION,
+            message: '$usageCount greater than zero must be accompanied by $lastUsed.',
+            severity: 'error',
+            pointer: metadata.usageCount.pointer,
+            span: metadata.usageCount.span
+        });
+    }
+    const hasMetadata = Object.keys(metadata).length > 0;
+    return hasMetadata ? Object.freeze(metadata) : EMPTY_METADATA;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/ast/normaliser/metadata.js.map

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

package/dist/ast/normaliser/nodes.d.ts

@@ -0,0 +1,5 @@
+import type { JsonPointer } from '../../types.js';
+import type { DocumentChildNode } from '../nodes.js';
+import type { NormaliserContext } from './context.js';
+export declare function normalizeNode(context: NormaliserContext, name: string, value: unknown, pointer: JsonPointer): DocumentChildNode | undefined;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/ast/normaliser/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/ast/normaliser/nodes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAGV,iBAAiB,EAGlB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMtD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,iBAAiB,GAAG,SAAS,CAsB/B"}