@lapidist/dtif-parser 0.2.0

package/dist/ast/normaliser/nodes.js

@@ -0,0 +1,108 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { appendJsonPointer } from '../../utils/json-pointer.js';
+import { getSourceSpan } from './context.js';
+import { readOptionalStringField } from './fields.js';
+import { extractMetadata } from './metadata.js';
+import { createField, EMPTY_CHILDREN, isPlainObject } from './utils.js';
+export function normalizeNode(context, name, value, pointer) {
+    if (!isPlainObject(value)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_NODE,
+            message: `Node "${name}" must be a JSON object.`,
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    const metadata = extractMetadata(context, value, pointer);
+    if (isTokenLike(value)) {
+        if ('$ref' in value) {
+            return normalizeAliasNode(context, name, value, pointer, metadata);
+        }
+        return normalizeTokenNode(context, name, value, pointer, metadata);
+    }
+    return normalizeCollectionNode(context, name, value, pointer, metadata);
+}
+function normalizeCollectionNode(context, name, value, pointer, metadata) {
+    const children = [];
+    for (const [childName, childValue] of Object.entries(value)) {
+        if (childName.startsWith('$')) {
+            continue;
+        }
+        const childPointer = appendJsonPointer(pointer, childName);
+        const childNode = normalizeNode(context, childName, childValue, childPointer);
+        if (childNode) {
+            children.push(childNode);
+        }
+    }
+    return Object.freeze({
+        kind: 'collection',
+        name,
+        pointer,
+        span: getSourceSpan(context, pointer),
+        metadata,
+        children: children.length === 0 ? EMPTY_CHILDREN : Object.freeze(children)
+    });
+}
+function normalizeTokenNode(context, name, value, pointer, metadata) {
+    const typeField = readOptionalStringField(context, value, '$type', pointer);
+    const valueField = '$value' in value
+        ? createField(context, value['$value'], appendJsonPointer(pointer, '$value'))
+        : undefined;
+    if (!valueField) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.MISSING_VALUE,
+            message: `Token "${name}" must declare a $value when it does not alias another token.`,
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+    }
+    return Object.freeze({
+        kind: 'token',
+        name,
+        pointer,
+        span: getSourceSpan(context, pointer),
+        metadata,
+        type: typeField,
+        value: valueField
+    });
+}
+function normalizeAliasNode(context, name, value, pointer, metadata) {
+    const refField = readOptionalStringField(context, value, '$ref', pointer);
+    const typeField = readOptionalStringField(context, value, '$type', pointer);
+    if (!refField) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.MISSING_ALIAS_TARGET,
+            message: `Alias token "${name}" must declare a $ref pointer.`,
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    if (!typeField) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.ALIAS_MISSING_TYPE,
+            message: `Alias token "${name}" must declare a $type alongside $ref.`,
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    return Object.freeze({
+        kind: 'alias',
+        name,
+        pointer,
+        span: getSourceSpan(context, pointer),
+        metadata,
+        type: typeField,
+        ref: refField
+    });
+}
+function isTokenLike(value) {
+    return '$value' in value || '$ref' in value || '$type' in value;
+}
+//# sourceMappingURL=nodes.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { JsonPointer } from '../../types.js';
+import type { OverrideFallbackNode, OverrideNode } from '../nodes.js';
+import type { NormaliserContext } from './context.js';
+export declare function normalizeOverrides(context: NormaliserContext, value: Record<string, unknown>, pointer: JsonPointer): readonly OverrideNode[];
+export declare function normalizeOverrideNode(context: NormaliserContext, value: unknown, pointer: JsonPointer): OverrideNode | undefined;
+export declare function normalizeFallbackChain(context: NormaliserContext, value: unknown, pointer: JsonPointer): readonly OverrideFallbackNode[] | undefined;
+//# sourceMappingURL=overrides.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../src/ast/normaliser/overrides.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAStD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,WAAW,GACnB,SAAS,YAAY,EAAE,CA8BzB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,YAAY,GAAG,SAAS,CA0D1B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,SAAS,oBAAoB,EAAE,GAAG,SAAS,CA0B7C"}

package/dist/ast/normaliser/overrides.js

@@ -0,0 +1,156 @@
+import { DiagnosticCodes } from '../../diagnostics/codes.js';
+import { appendJsonPointer } from '../../utils/json-pointer.js';
+import { getSourceSpan } from './context.js';
+import { readOptionalStringField, readOverrideConditions, readRequiredStringField } from './fields.js';
+import { createField, EMPTY_OVERRIDES, isPlainObject } from './utils.js';
+export function normalizeOverrides(context, value, pointer) {
+    if (!('$overrides' in value)) {
+        return EMPTY_OVERRIDES;
+    }
+    const overridesValue = value['$overrides'];
+    const overridesPointer = appendJsonPointer(pointer, '$overrides');
+    if (!Array.isArray(overridesValue)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+            message: '$overrides must be an array of override objects.',
+            severity: 'error',
+            pointer: overridesPointer,
+            span: getSourceSpan(context, overridesPointer)
+        });
+        return EMPTY_OVERRIDES;
+    }
+    const overrides = [];
+    overridesValue.forEach((entry, index) => {
+        const entryPointer = appendJsonPointer(overridesPointer, String(index));
+        const override = normalizeOverrideNode(context, entry, entryPointer);
+        if (override) {
+            overrides.push(override);
+        }
+    });
+    return overrides.length === 0 ? EMPTY_OVERRIDES : Object.freeze(overrides);
+}
+export function normalizeOverrideNode(context, value, pointer) {
+    if (!isPlainObject(value)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+            message: 'Override entries must be JSON objects.',
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    const token = readRequiredStringField(context, value, '$token', pointer);
+    const when = readOverrideConditions(context, value, pointer);
+    const refField = readOptionalStringField(context, value, '$ref', pointer);
+    const valueField = '$value' in value
+        ? createField(context, value['$value'], appendJsonPointer(pointer, '$value'))
+        : undefined;
+    const fallback = '$fallback' in value
+        ? normalizeFallbackChain(context, value['$fallback'], appendJsonPointer(pointer, '$fallback'))
+        : undefined;
+    if (!token || !when) {
+        return undefined;
+    }
+    if (!refField && !valueField && !fallback) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_OVERRIDE,
+            message: 'Override entries must provide $ref, $value, or $fallback.',
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+    }
+    if (refField && valueField) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_OVERRIDE,
+            message: 'Override entries must not declare both $ref and $value.',
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+    }
+    return Object.freeze({
+        kind: 'override',
+        pointer,
+        span: getSourceSpan(context, pointer),
+        token,
+        when,
+        ref: refField,
+        value: valueField,
+        fallback
+    });
+}
+export function normalizeFallbackChain(context, value, pointer) {
+    if (Array.isArray(value)) {
+        const entries = [];
+        value.forEach((entry, index) => {
+            const entryPointer = appendJsonPointer(pointer, String(index));
+            const node = normalizeFallbackEntry(context, entry, entryPointer);
+            if (node) {
+                entries.push(node);
+            }
+        });
+        return entries.length === 0 ? undefined : Object.freeze(entries);
+    }
+    if (isPlainObject(value)) {
+        const entry = normalizeFallbackEntry(context, value, pointer);
+        return entry ? Object.freeze([entry]) : undefined;
+    }
+    context.diagnostics.push({
+        code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+        message: '$fallback must be an override object or an array of override objects.',
+        severity: 'error',
+        pointer,
+        span: getSourceSpan(context, pointer)
+    });
+    return undefined;
+}
+function normalizeFallbackEntry(context, value, pointer) {
+    if (!isPlainObject(value)) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_MEMBER_TYPE,
+            message: 'Fallback entries must be JSON objects.',
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    const refField = readOptionalStringField(context, value, '$ref', pointer);
+    const valueField = '$value' in value
+        ? createField(context, value['$value'], appendJsonPointer(pointer, '$value'))
+        : undefined;
+    const fallback = '$fallback' in value
+        ? normalizeFallbackChain(context, value['$fallback'], appendJsonPointer(pointer, '$fallback'))
+        : undefined;
+    if (!refField && !valueField) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_OVERRIDE,
+            message: 'Fallback entries must provide $ref or $value.',
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    if (refField && valueField) {
+        context.diagnostics.push({
+            code: DiagnosticCodes.normaliser.INVALID_OVERRIDE,
+            message: 'Fallback entries must not declare both $ref and $value.',
+            severity: 'error',
+            pointer,
+            span: getSourceSpan(context, pointer)
+        });
+        return undefined;
+    }
+    return Object.freeze({
+        kind: 'fallback',
+        pointer,
+        span: getSourceSpan(context, pointer),
+        ref: refField,
+        value: valueField,
+        fallback
+    });
+}
+//# sourceMappingURL=overrides.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { AstField, DocumentAst, DocumentChildNode, NodeMetadata, OverrideNode } from '../nodes.js';
+import type { JsonPointer } from '../../types.js';
+import type { NormaliserContext } from './context.js';
+export declare const EMPTY_METADATA: NodeMetadata;
+export declare const EMPTY_CHILDREN: readonly DocumentChildNode[];
+export declare const EMPTY_OVERRIDES: readonly OverrideNode[];
+export declare function freezeDocumentAst(ast: DocumentAst): DocumentAst;
+export declare function createField<T>(context: NormaliserContext, value: T, pointer: JsonPointer): AstField<T>;
+export declare function freezeRecord(value: Record<string, unknown>): Readonly<Record<string, unknown>>;
+export declare function freezeValue<T>(value: T): T;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ast/normaliser/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,eAAO,MAAM,cAAc,EAAE,YAAgC,CAAC;AAC9D,eAAO,MAAM,cAAc,EAAE,SAAS,iBAAiB,EAAsB,CAAC;AAC9E,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAsB,CAAC;AAE1E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAQ/D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,WAAW,GACnB,QAAQ,CAAC,CAAC,CAAC,CAMb;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAG9F;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAa1C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW9E"}

package/dist/ast/normaliser/utils.js

@@ -0,0 +1,45 @@
+import { getSourceSpan } from './context.js';
+export const EMPTY_METADATA = Object.freeze({});
+export const EMPTY_CHILDREN = Object.freeze([]);
+export const EMPTY_OVERRIDES = Object.freeze([]);
+export function freezeDocumentAst(ast) {
+    const children = ast.children.length === 0 ? EMPTY_CHILDREN : ast.children;
+    const overrides = ast.overrides.length === 0 ? EMPTY_OVERRIDES : ast.overrides;
+    return Object.freeze({
+        ...ast,
+        children,
+        overrides
+    });
+}
+export function createField(context, value, pointer) {
+    return Object.freeze({
+        value: freezeValue(value),
+        pointer,
+        span: getSourceSpan(context, pointer)
+    });
+}
+export function freezeRecord(value) {
+    const entries = Object.entries(value).map(([key, entry]) => [key, freezeValue(entry)]);
+    return Object.freeze(Object.fromEntries(entries));
+}
+export function freezeValue(value) {
+    if (Array.isArray(value)) {
+        return Object.freeze(value.map((entry) => freezeValue(entry)));
+    }
+    if (isPlainObject(value)) {
+        const entries = Object.entries(value).map(([key, entry]) => [key, freezeValue(entry)]);
+        return Object.freeze(Object.fromEntries(entries));
+    }
+    return value;
+}
+export function isPlainObject(value) {
+    if (value === null || typeof value !== 'object') {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/ast/normaliser/utils.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,cAAc,GAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAiC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,eAAe,GAA4B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE1E,MAAM,UAAU,iBAAiB,CAAC,GAAgB;IAChD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC3E,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,GAAG;QACN,QAAQ;QACR,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAA0B,EAC1B,KAAQ,EACR,OAAoB;IAEpB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;QACzB,OAAO;QACP,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC;KACtC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA8B;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAU,CAAC,CAAC;IAChG,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAAQ;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAiB,CAAC;IACjF,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,GAAG,CAClE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAU,CACrD,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAiB,CAAC;IACpE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC"}

package/dist/ast/normaliser.d.ts

@@ -0,0 +1,5 @@
+import type { RawDocument } from '../types.js';
+import type { NormaliserOptions, NormaliserResult } from './normaliser/context.js';
+export type { NormaliserOptions, NormaliserResult } from './normaliser/context.js';
+export declare function normalizeDocument(document: RawDocument, options?: NormaliserOptions): NormaliserResult;
+//# sourceMappingURL=normaliser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normaliser.d.ts","sourceRoot":"","sources":["../../src/ast/normaliser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,OAAO,KAAK,EAEV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAUlB"}

package/dist/ast/normaliser.js

@@ -0,0 +1,25 @@
+import { DiagnosticCodes } from '../diagnostics/codes.js';
+import { JSON_POINTER_ROOT } from '../utils/json-pointer.js';
+import { buildDocumentAst } from './normaliser/document.js';
+import { createNormaliserContext, finalizeNormalisation, getSourceSpan } from './normaliser/context.js';
+export function normalizeDocument(document, options = {}) {
+    const context = createNormaliserContext(document, options);
+    try {
+        const ast = buildDocumentAst(context);
+        return finalizeNormalisation(context, ast);
+    }
+    catch (error) {
+        recordUnexpectedFailure(context, error);
+        return finalizeNormalisation(context, undefined);
+    }
+}
+function recordUnexpectedFailure(context, error) {
+    context.diagnostics.push({
+        code: DiagnosticCodes.normaliser.FAILED,
+        message: error instanceof Error ? error.message : 'Failed to normalise DTIF document.',
+        severity: 'error',
+        pointer: JSON_POINTER_ROOT,
+        span: getSourceSpan(context, JSON_POINTER_ROOT)
+    });
+}
+//# sourceMappingURL=normaliser.js.map

package/dist/ast/normaliser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normaliser.js","sourceRoot":"","sources":["../../src/ast/normaliser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACd,MAAM,yBAAyB,CAAC;AASjC,MAAM,UAAU,iBAAiB,CAC/B,QAAqB,EACrB,UAA6B,EAAE;IAE/B,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,OAA0B,EAAE,KAAc;IACzE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QACvB,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,MAAM;QACvC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oCAAoC;QACtF,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,iBAAiB;QAC1B,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/args.d.ts

@@ -0,0 +1,3 @@
+import type { CliArguments } from './types.js';
+export declare function parseArguments(args: readonly string[]): CliArguments;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAW3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAsLpE"}

package/dist/cli/args.js

@@ -0,0 +1,202 @@
+import { normalizeJsonPointer } from '../utils/json-pointer.js';
+const DEFAULT_CLI_OPTIONS = {
+    inputs: [],
+    allowHttp: false,
+    format: 'pretty',
+    pointers: [],
+    context: new Map()
+};
+export function parseArguments(args) {
+    const options = {
+        inputs: [...DEFAULT_CLI_OPTIONS.inputs],
+        allowHttp: DEFAULT_CLI_OPTIONS.allowHttp,
+        maxDepth: DEFAULT_CLI_OPTIONS.maxDepth,
+        format: DEFAULT_CLI_OPTIONS.format,
+        context: new Map(DEFAULT_CLI_OPTIONS.context)
+    };
+    const pointerStrings = [];
+    let index = 0;
+    let parsingOptions = true;
+    while (index < args.length) {
+        const raw = args[index];
+        if (parsingOptions && raw === '--') {
+            parsingOptions = false;
+            index++;
+            continue;
+        }
+        if (parsingOptions && (raw === '--help' || raw === '-h')) {
+            return { kind: 'help' };
+        }
+        if (parsingOptions && (raw === '--version' || raw === '-v')) {
+            return { kind: 'version' };
+        }
+        if (parsingOptions && (raw === '--json' || raw === '--format=json')) {
+            options.format = 'json';
+            index++;
+            continue;
+        }
+        if (parsingOptions && raw.startsWith('--format=')) {
+            const value = raw.slice('--format='.length);
+            const normalized = value.toLowerCase();
+            if (normalized !== 'pretty' && normalized !== 'json') {
+                return { kind: 'error', message: `Unsupported format "${value}".` };
+            }
+            options.format = normalized;
+            index++;
+            continue;
+        }
+        if (parsingOptions && raw === '--format') {
+            const value = args[index + 1];
+            if (!value) {
+                return { kind: 'error', message: '--format requires a value of "pretty" or "json".' };
+            }
+            const normalized = value.toLowerCase();
+            if (normalized !== 'pretty' && normalized !== 'json') {
+                return { kind: 'error', message: `Unsupported format "${value}".` };
+            }
+            options.format = normalized;
+            index += 2;
+            continue;
+        }
+        if (parsingOptions && (raw === '--allow-http' || raw === '--allow-http=true')) {
+            options.allowHttp = true;
+            index++;
+            continue;
+        }
+        if (parsingOptions && raw.startsWith('--allow-http=')) {
+            const value = raw.slice('--allow-http='.length);
+            const normalized = value.toLowerCase();
+            if (normalized === 'true') {
+                options.allowHttp = true;
+                index++;
+                continue;
+            }
+            if (normalized === 'false') {
+                options.allowHttp = false;
+                index++;
+                continue;
+            }
+            return { kind: 'error', message: `Invalid value for --allow-http: "${value}".` };
+        }
+        if (parsingOptions && raw === '--max-depth') {
+            const value = args[index + 1];
+            if (!value) {
+                return { kind: 'error', message: '--max-depth requires a numeric value.' };
+            }
+            const parsed = Number.parseInt(value, 10);
+            if (!Number.isFinite(parsed) || parsed <= 0) {
+                return { kind: 'error', message: `Invalid --max-depth value "${value}".` };
+            }
+            options.maxDepth = parsed;
+            index += 2;
+            continue;
+        }
+        if (parsingOptions && raw.startsWith('--max-depth=')) {
+            const value = raw.slice('--max-depth='.length);
+            const parsed = Number.parseInt(value, 10);
+            if (!Number.isFinite(parsed) || parsed <= 0) {
+                return { kind: 'error', message: `Invalid --max-depth value "${value}".` };
+            }
+            options.maxDepth = parsed;
+            index++;
+            continue;
+        }
+        if (parsingOptions && raw === '--resolve') {
+            const value = args[index + 1];
+            if (!value) {
+                return { kind: 'error', message: '--resolve requires a JSON Pointer argument.' };
+            }
+            pointerStrings.push(value);
+            index += 2;
+            continue;
+        }
+        if (parsingOptions && raw.startsWith('--resolve=')) {
+            const value = raw.slice('--resolve='.length);
+            if (!value) {
+                return { kind: 'error', message: '--resolve requires a JSON Pointer argument.' };
+            }
+            pointerStrings.push(value);
+            index++;
+            continue;
+        }
+        if (parsingOptions && raw === '--context') {
+            const value = args[index + 1];
+            if (!value) {
+                return { kind: 'error', message: '--context requires entries in the form key=value.' };
+            }
+            const parsedEntry = parseContextEntry(value);
+            if ('error' in parsedEntry) {
+                return { kind: 'error', message: parsedEntry.error };
+            }
+            options.context.set(parsedEntry.key, parsedEntry.value);
+            index += 2;
+            continue;
+        }
+        if (parsingOptions && raw.startsWith('--context=')) {
+            const value = raw.slice('--context='.length);
+            const parsedEntry = parseContextEntry(value);
+            if ('error' in parsedEntry) {
+                return { kind: 'error', message: parsedEntry.error };
+            }
+            options.context.set(parsedEntry.key, parsedEntry.value);
+            index++;
+            continue;
+        }
+        if (parsingOptions && raw.startsWith('-') && raw !== '-') {
+            return { kind: 'error', message: `Unknown option "${raw}".` };
+        }
+        options.inputs.push(raw);
+        index++;
+    }
+    const normalizedPointers = Array.from(new Set(pointerStrings.map((pointer) => normalizeJsonPointer(pointer))));
+    return {
+        kind: 'run',
+        options: {
+            inputs: options.inputs,
+            allowHttp: options.allowHttp,
+            maxDepth: options.maxDepth,
+            format: options.format,
+            pointers: normalizedPointers,
+            context: options.context
+        }
+    };
+}
+function parseContextEntry(input) {
+    const separator = input.indexOf('=');
+    if (separator <= 0) {
+        return { error: `Invalid context entry "${input}". Expected key=value.` };
+    }
+    const key = input.slice(0, separator).trim();
+    const rawValue = input.slice(separator + 1);
+    if (!key) {
+        return { error: 'Context keys must be non-empty.' };
+    }
+    return { key, value: parseContextValue(rawValue) };
+}
+function parseContextValue(value) {
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        return '';
+    }
+    const lowered = trimmed.toLowerCase();
+    if (lowered === 'true') {
+        return true;
+    }
+    if (lowered === 'false') {
+        return false;
+    }
+    if (lowered === 'null') {
+        return null;
+    }
+    const numeric = Number(trimmed);
+    if (!Number.isNaN(numeric)) {
+        return numeric;
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return value;
+    }
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/cli/io.d.ts

@@ -0,0 +1,3 @@
+import type { CliIo, GatherInputsResult } from './types.js';
+export declare function gatherInputs(inputs: readonly string[], io: CliIo): Promise<GatherInputsResult>;
+//# sourceMappingURL=io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/cli/io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5D,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,EAAE,EAAE,KAAK,GACR,OAAO,CAAC,kBAAkB,CAAC,CAwC7B"}