@astrale-os/kernel-dsl 0.1.5 → 0.2.0-beta.10

package/dist/v1/language/value/evaluate/preparation.js

@@ -0,0 +1,135 @@
+import { isValueObject as isJsonObject } from '../model/object.js';
+import { collectResourceClosure, locationKey, } from '../reference/closure.js';
+import { indexRegistry } from '../reference/registry.index.js';
+import { compilePattern } from '../regexp/compile.js';
+import { loadPattern } from '../regexp/matcher.js';
+import { appendPointer } from '../syntax/pointer.js';
+import { walkSchema } from '../syntax/walk.js';
+/** Prepare reference and linear-regexp state without generating executable source. */
+export function prepareValueSchema(schema, registry, pointer) {
+    const indexed = indexRegistry(registry, pointer);
+    if (indexed.diagnostics.length > 0)
+        return failed(indexed.diagnostics);
+    const closure = collectResourceClosure(schema, 'callable-input', indexed.index, pointer);
+    if (closure.diagnostics.length > 0)
+        return failed(closure.diagnostics);
+    const locations = new Map();
+    const matchers = new Map();
+    for (const resource of closure.resources.values()) {
+        walkSchema(resource.schema, (location) => {
+            const key = locationKey(resource.key, location.pointer);
+            locations.set(key, {
+                key,
+                pointer: location.pointer,
+                resource,
+                schema: location.schema,
+            });
+            if (!isJsonObject(location.schema))
+                return;
+            rememberMatcher(matchers, location.schema.pattern);
+            rememberMatcher(matchers, location.schema.fullMatch);
+            if (isJsonObject(location.schema.patternProperties)) {
+                for (const pattern of Object.keys(location.schema.patternProperties)) {
+                    rememberMatcher(matchers, pattern);
+                }
+            }
+        });
+    }
+    const initial = closure.resources.values().next().value;
+    const root = initial === undefined ? undefined : locations.get(locationKey(initial.key, ''));
+    if (root === undefined) {
+        return { compiled: false, message: 'The root value schema is absent from its closure.' };
+    }
+    return {
+        compiled: true,
+        value: {
+            root,
+            locations,
+            resolutions: closure.resolutions,
+            program: () => portableProgram(root, locations, closure.resolutions),
+            child(location, keyword, member) {
+                const keywordPointer = appendPointer(location.pointer, keyword);
+                const pointer = member === undefined ? keywordPointer : appendPointer(keywordPointer, member);
+                const child = locations.get(locationKey(location.resource.key, pointer));
+                if (child === undefined) {
+                    throw new TypeError(`Admitted value schema child ${pointer} is absent from its closure.`);
+                }
+                return child;
+            },
+            reference(location) {
+                const resolved = closure.resolutions.get(location.key);
+                return resolved === undefined
+                    ? undefined
+                    : locations.get(locationKey(resolved.resource.key, resolved.pointer));
+            },
+            matcher(source) {
+                const matcher = matchers.get(source);
+                if (matcher === undefined) {
+                    throw new TypeError('Value schema uses an unprepared I-Regexp source.');
+                }
+                return matcher;
+            },
+        },
+    };
+}
+function portableProgram(root, locations, resolutions) {
+    const ordered = [...locations.values()];
+    const indices = new Map(ordered.map((location, index) => [location.key, index]));
+    const patterns = new Map();
+    const nodes = ordered.map((location) => {
+        const children = {};
+        walkSchema(location.schema, (child) => {
+            if (child.depth !== 1)
+                return;
+            const target = indices.get(locationKey(location.resource.key, `${location.pointer}${child.pointer}`));
+            if (target !== undefined)
+                children[childKey(child.pointer)] = target;
+        });
+        rememberPattern(patterns, location.schema);
+        const resolved = resolutions.get(location.key);
+        const reference = resolved === undefined
+            ? undefined
+            : indices.get(locationKey(resolved.resource.key, resolved.pointer));
+        if (resolved !== undefined && reference === undefined) {
+            throw new TypeError('Prepared value schema reference target is absent.');
+        }
+        return Object.freeze({
+            schema: location.schema,
+            children: Object.freeze(children),
+            ...(reference === undefined ? {} : { reference }),
+        });
+    });
+    return Object.freeze({
+        root: indices.get(root.key),
+        nodes: Object.freeze(nodes),
+        patterns: Object.freeze([...patterns.values()]),
+    });
+}
+function rememberPattern(patterns, schema) {
+    if (!isJsonObject(schema))
+        return;
+    for (const source of [schema.pattern, schema.fullMatch]) {
+        if (typeof source === 'string' && !patterns.has(source))
+            patterns.set(source, compilePattern(source));
+    }
+    if (isJsonObject(schema.patternProperties)) {
+        for (const source of Object.keys(schema.patternProperties)) {
+            if (!patterns.has(source))
+                patterns.set(source, compilePattern(source));
+        }
+    }
+}
+export function childKey(pointer) {
+    return pointer.slice(1);
+}
+function rememberMatcher(matchers, input) {
+    if (typeof input === 'string' && !matchers.has(input)) {
+        matchers.set(input, loadPattern(compilePattern(input)));
+    }
+}
+function failed(diagnostics) {
+    return {
+        compiled: false,
+        message: diagnostics.map(({ code, message }) => `${code}: ${message}`).join('; '),
+    };
+}

package/dist/v1/language/value/evaluate/program.d.ts

@@ -0,0 +1,3 @@
+import type { Diagnostic } from '../../validation/diagnostic.js';
+import type { ValueProgram } from '../compile/model.js';
+export declare function validateValueProgram(program: ValueProgram, input: unknown, roots?: readonly number[]): readonly Diagnostic[];

package/dist/v1/language/value/evaluate/program.js

@@ -0,0 +1,16 @@
+import { loadValueProgram } from '../compile/load.js';
+import { validateCanonicalJsonDomain } from '../profile/json.validate.js';
+import { evaluateInstance } from './evaluator.js';
+export function validateValueProgram(program, input, roots = [program.root]) {
+    const canonical = validateCanonicalJsonDomain(input, '');
+    if (canonical.length > 0)
+        return canonical;
+    return roots.flatMap((root) => {
+        const result = evaluateInstance(loadValueProgram({ ...program, root }), input);
+        return result.failures.map((failure) => ({
+            code: 'VALUE_SCHEMA_INSTANCE_INVALID',
+            pointer: failure.instancePointer,
+            message: `Value does not satisfy its complete V1 schema at ${failure.keyword}: ${failure.message}`,
+        }));
+    });
+}

package/dist/v1/language/value/evaluate/types.d.ts

@@ -0,0 +1,36 @@
+import type { Value as JsonValue } from '@astrale-os/kernel-dsl/value';
+import type { ValueProgram } from '../compile/model.js';
+import type { JsonSchema } from '../model/schema.js';
+import type { ResolvedAddressReference, SchemaResource } from '../reference/references.js';
+import type { IRegexpMatcher } from '../regexp/matcher.js';
+export interface InstanceFailure {
+    readonly instancePointer: string;
+    readonly keyword: string;
+    readonly message: string;
+}
+export interface SchemaLocation {
+    readonly key: string;
+    readonly pointer: string;
+    readonly resource: SchemaResource;
+    readonly schema: JsonSchema;
+}
+export interface CompiledInstanceSchema {
+    readonly root: SchemaLocation;
+    readonly locations: ReadonlyMap<string, SchemaLocation>;
+    readonly resolutions: ReadonlyMap<string, ResolvedAddressReference>;
+    program(): ValueProgram;
+    child(location: SchemaLocation, keyword: string, member?: string | number): SchemaLocation;
+    reference(location: SchemaLocation): SchemaLocation | undefined;
+    matcher(source: string): IRegexpMatcher;
+}
+export interface Evaluation {
+    readonly valid: boolean;
+    readonly failures: readonly InstanceFailure[];
+    /** Properties evaluated at this exact instance location. */
+    readonly properties: ReadonlySet<string>;
+    /** Items evaluated at this exact instance location. */
+    readonly items: ReadonlySet<number>;
+}
+export type Instance = JsonValue;
+export declare function evaluation(failures?: readonly InstanceFailure[], properties?: ReadonlySet<string>, items?: ReadonlySet<number>): Evaluation;
+export declare function mergeAnnotations(targetProperties: Set<string>, targetItems: Set<number>, source: Pick<Evaluation, 'properties' | 'items'>): void;

package/dist/v1/language/value/evaluate/types.js

@@ -0,0 +1,9 @@
+export function evaluation(failures = [], properties = new Set(), items = new Set()) {
+    return { valid: failures.length === 0, failures, properties, items };
+}
+export function mergeAnnotations(targetProperties, targetItems, source) {
+    for (const property of source.properties)
+        targetProperties.add(property);
+    for (const item of source.items)
+        targetItems.add(item);
+}

package/dist/v1/language/value/evaluate/validate.d.ts

@@ -0,0 +1,12 @@
+import type { Value as JsonValue } from '@astrale-os/kernel-dsl/value';
+import type { Diagnostic } from '../../validation/diagnostic.js';
+import type { JsonSchema } from '../model/schema.js';
+import type { ValueSchemaRegistry } from '../reference/registry.js';
+/**
+ * Validate one complete portable value with the admitted V1 Draft 2020-12 profile.
+ *
+ * Evaluation is an interpreter over the exact local resource closure. It never performs network
+ * resolution or dynamic source generation, and every admitted I-Regexp executes through RE2JS.
+ * `format` remains annotation-only; the graph NodePath codec performs its separate locator check.
+ */
+export declare function validateJsonInstance(schema: JsonSchema, value: JsonValue, registry: ValueSchemaRegistry, pointer?: string): Diagnostic[];

package/dist/v1/language/value/evaluate/validate.js

@@ -0,0 +1,43 @@
+import { diagnostic } from '../../validation/diagnostic.js';
+import { validateCanonicalJsonDomain } from '../profile/json.validate.js';
+import { evaluateInstance } from './evaluator.js';
+import { prepareValueSchema } from './preparation.js';
+const validatorCache = new WeakMap();
+/**
+ * Validate one complete portable value with the admitted V1 Draft 2020-12 profile.
+ *
+ * Evaluation is an interpreter over the exact local resource closure. It never performs network
+ * resolution or dynamic source generation, and every admitted I-Regexp executes through RE2JS.
+ * `format` remains annotation-only; the graph NodePath codec performs its separate locator check.
+ */
+export function validateJsonInstance(schema, value, registry, pointer = '') {
+    const diagnostics = [...validateCanonicalJsonDomain(value, pointer)];
+    if (diagnostics.length > 0)
+        return diagnostics;
+    const prepared = preparedInstanceValidator(schema, registry, pointer);
+    if (prepared.kind === 'error') {
+        return [
+            diagnostic('VS_REFERENCE_RESOLUTION', pointer, `Value validation failed closed while preparing exact schema resources: ${prepared.message}.`),
+        ];
+    }
+    const result = evaluateInstance(prepared.compiled, value);
+    if (result.valid)
+        return [];
+    return result.failures.map((failure) => diagnostic('VALUE_SCHEMA_INSTANCE_INVALID', `${pointer}${failure.instancePointer}`, `Value does not satisfy its complete V1 schema at ${failure.keyword}: ${failure.message}`));
+}
+function preparedInstanceValidator(schema, registry, pointer) {
+    let bySchema = validatorCache.get(registry);
+    if (bySchema === undefined) {
+        bySchema = new Map();
+        validatorCache.set(registry, bySchema);
+    }
+    const cached = bySchema.get(schema);
+    if (cached !== undefined)
+        return cached;
+    const compilation = prepareValueSchema(schema, registry, pointer);
+    const prepared = compilation.compiled
+        ? { kind: 'validator', compiled: compilation.value }
+        : { kind: 'error', message: compilation.message };
+    bySchema.set(schema, prepared);
+    return prepared;
+}

package/dist/v1/language/value/index.d.ts

@@ -0,0 +1,11 @@
+/** Complete V1 inline value language. Named Type Definitions do not exist. */
+export type { JsonSchema as ValueSchema, JsonSchemaObject as ValueSchemaObject, PathAnnotation, PropertyObjectSchema, ValueSchemaContext, } from './model/schema.js';
+export { JSON_SCHEMA_DIALECT, VALUE_SCHEMA_DIALECT, VALUE_SCHEMA_VOCABULARY, } from './model/schema.js';
+export { instant, isInstantValue } from './model/instant.js';
+export { classifyOrdering, type OrderingKind } from './ordering.js';
+export { canonicalizeValueSchema } from './profile/canonicalize.js';
+export { validateValueSchema } from './profile/validate.js';
+export { validateJsonInstance } from './evaluate/validate.js';
+export { prepareValueSchema, type InstanceSchemaCompilation } from './evaluate/preparation.js';
+export type { ValueProgram } from './compile/model.js';
+export type { ValueSchemaRegistry, ValueSchemaDomainRegistry } from './reference/registry.js';

package/dist/v1/language/value/index.js

@@ -0,0 +1,8 @@
+/** Complete V1 inline value language. Named Type Definitions do not exist. */
+export { JSON_SCHEMA_DIALECT, VALUE_SCHEMA_DIALECT, VALUE_SCHEMA_VOCABULARY, } from './model/schema.js';
+export { instant, isInstantValue } from './model/instant.js';
+export { classifyOrdering } from './ordering.js';
+export { canonicalizeValueSchema } from './profile/canonicalize.js';
+export { validateValueSchema } from './profile/validate.js';
+export { validateJsonInstance } from './evaluate/validate.js';
+export { prepareValueSchema } from './evaluate/preparation.js';

package/dist/v1/language/value/model/instant.d.ts

@@ -0,0 +1,9 @@
+/** Exact portable UTC millisecond Instant used by the V1 value-schema dialect. */
+/** Canonical value-language annotation for an Instant string. */
+export declare const INSTANT_VALUE_KIND: 'instant';
+export declare const instant: Readonly<{
+    readonly type: 'string';
+    readonly 'x-astrale-value-kind': 'instant';
+}>;
+/** Test the exact proleptic-Gregorian V1 Instant lexical and calendar domain. */
+export declare function isInstantValue(input: unknown): input is string;

package/dist/v1/language/value/model/instant.js

@@ -0,0 +1,37 @@
+/** Exact portable UTC millisecond Instant used by the V1 value-schema dialect. */
+/** Canonical value-language annotation for an Instant string. */
+export const INSTANT_VALUE_KIND = 'instant';
+export const instant = Object.freeze({
+    type: 'string',
+    'x-astrale-value-kind': INSTANT_VALUE_KIND,
+});
+const INSTANT_PATTERN = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})\.(\d{3})Z$/u;
+/** Test the exact proleptic-Gregorian V1 Instant lexical and calendar domain. */
+export function isInstantValue(input) {
+    if (typeof input !== 'string')
+        return false;
+    const match = INSTANT_PATTERN.exec(input);
+    if (match === null)
+        return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const hour = Number(match[4]);
+    const minute = Number(match[5]);
+    const second = Number(match[6]);
+    return (month >= 1 &&
+        month <= 12 &&
+        day >= 1 &&
+        day <= daysInMonth(year, month) &&
+        hour <= 23 &&
+        minute <= 59 &&
+        second <= 59);
+}
+function daysInMonth(year, month) {
+    if (month === 2)
+        return isLeapYear(year) ? 29 : 28;
+    return month === 4 || month === 6 || month === 9 || month === 11 ? 30 : 31;
+}
+function isLeapYear(year) {
+    return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+}

package/dist/v1/language/value/model/object.d.ts

@@ -0,0 +1,5 @@
+import type { Object as ValueObject, Value } from '@astrale-os/kernel-dsl/value';
+/** Internal shape refinement for values that have already crossed portable-value admission. */
+/** Return whether an unknown value is a portable JSON object. */
+export declare function isValueObject(value: unknown): value is ValueObject;
+export declare function isValueObject(value: Value): value is ValueObject;

package/dist/v1/language/value/model/object.js

@@ -0,0 +1,3 @@
+export function isValueObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}

package/dist/v1/language/value/model/schema.d.ts

@@ -0,0 +1,25 @@
+import type { Object as JsonObject, Value as JsonValue } from '@astrale-os/kernel-dsl/value';
+import type { ClassRef } from '../../../addressing/index.js';
+/** Standard dialect on which the Astrale value-schema dialect is based. */
+export declare const JSON_SCHEMA_DIALECT: 'https://json-schema.org/draft/2020-12/schema';
+/** Required V1 dialect for every embedded Astrale value schema. */
+export declare const VALUE_SCHEMA_DIALECT: 'https://schemas.astrale.ai/dsl/v1/value-schema';
+/** Required vocabulary carried by the V1 value-schema dialect. */
+export declare const VALUE_SCHEMA_VOCABULARY: 'https://schemas.astrale.ai/dsl/v1/value-schema/vocabulary';
+export type JsonSchema = boolean | JsonSchemaObject;
+export type JsonSchemaObject = JsonObject & {
+    readonly [keyword: string]: JsonValue;
+};
+export interface PropertyObjectSchema extends JsonSchemaObject {
+    readonly type: 'object';
+    readonly properties: Readonly<Record<string, JsonSchema>>;
+    readonly required: readonly string[];
+    readonly additionalProperties: false;
+}
+export interface PathAnnotation {
+    readonly target: 'node';
+    readonly cardinality: 'one';
+    readonly accepts: readonly ClassRef[];
+}
+export declare const VALUE_SCHEMA_CONTEXTS: readonly ['property-facet', 'callable-input', 'callable-output'];
+export type ValueSchemaContext = (typeof VALUE_SCHEMA_CONTEXTS)[number];

package/dist/v1/language/value/model/schema.js

@@ -0,0 +1,11 @@
+/** Standard dialect on which the Astrale value-schema dialect is based. */
+export const JSON_SCHEMA_DIALECT = 'https://json-schema.org/draft/2020-12/schema';
+/** Required V1 dialect for every embedded Astrale value schema. */
+export const VALUE_SCHEMA_DIALECT = 'https://schemas.astrale.ai/dsl/v1/value-schema';
+/** Required vocabulary carried by the V1 value-schema dialect. */
+export const VALUE_SCHEMA_VOCABULARY = 'https://schemas.astrale.ai/dsl/v1/value-schema/vocabulary';
+export const VALUE_SCHEMA_CONTEXTS = [
+    'property-facet',
+    'callable-input',
+    'callable-output',
+];

package/dist/v1/language/value/ordering.d.ts

@@ -0,0 +1,13 @@
+import type { ValueProgram } from './compile/model.js';
+import type { JsonSchema } from './model/schema.js';
+import type { ValueSchemaRegistry } from './reference/registry.js';
+export type OrderingKind = 'boolean' | 'number' | 'string' | 'instant';
+/**
+ * Classify a schema only when every value it can admit belongs to one sortable scalar domain.
+ *
+ * The analysis is intentionally conservative: unsupported or ambiguous schemas return undefined
+ * instead of guessing from annotations, examples, formats, or current data.
+ */
+export declare function classifyOrdering(contract: JsonSchema, registry: ValueSchemaRegistry): OrderingKind | undefined;
+/** Recompute the scalar ordering classification from one admitted portable value program. */
+export declare function classifyValueProgramOrdering(program: ValueProgram): OrderingKind | undefined;

package/dist/v1/language/value/ordering.js

@@ -0,0 +1,174 @@
+import { loadValueProgram } from './compile/load.js';
+import { prepareValueSchema } from './evaluate/preparation.js';
+const ALL_JSON_KINDS = new Set([
+    'null',
+    'boolean',
+    'number',
+    'string',
+    'array',
+    'object',
+]);
+/**
+ * Classify a schema only when every value it can admit belongs to one sortable scalar domain.
+ *
+ * The analysis is intentionally conservative: unsupported or ambiguous schemas return undefined
+ * instead of guessing from annotations, examples, formats, or current data.
+ */
+export function classifyOrdering(contract, registry) {
+    const prepared = prepareValueSchema(contract, registry, '');
+    if (!prepared.compiled)
+        return undefined;
+    const candidates = new OrderingClassifier(prepared.value).classify(prepared.value.root);
+    if (candidates.size !== 1)
+        return undefined;
+    const [kind] = candidates;
+    return kind === 'boolean' || kind === 'number' || kind === 'string' || kind === 'instant'
+        ? kind
+        : undefined;
+}
+/** Recompute the scalar ordering classification from one admitted portable value program. */
+export function classifyValueProgramOrdering(program) {
+    const compiled = loadValueProgram(program);
+    const candidates = new OrderingClassifier(compiled).classify(compiled.root);
+    if (candidates.size !== 1)
+        return undefined;
+    const [kind] = candidates;
+    return kind === 'boolean' || kind === 'number' || kind === 'string' || kind === 'instant'
+        ? kind
+        : undefined;
+}
+class OrderingClassifier {
+    compiled;
+    active = new Set();
+    cache = new Map();
+    constructor(compiled) {
+        this.compiled = compiled;
+    }
+    classify(location) {
+        const cached = this.cache.get(location.key);
+        if (cached !== undefined)
+            return cached;
+        if (this.active.has(location.key))
+            return ALL_JSON_KINDS;
+        this.active.add(location.key);
+        try {
+            const result = this.classifySchema(location);
+            this.cache.set(location.key, result);
+            return result;
+        }
+        finally {
+            this.active.delete(location.key);
+        }
+    }
+    classifySchema(location) {
+        if (location.schema === false)
+            return new Set();
+        if (location.schema === true)
+            return ALL_JSON_KINDS;
+        const schema = location.schema;
+        let candidates = ALL_JSON_KINDS;
+        if (Object.hasOwn(schema, 'x-astrale-value-kind')) {
+            if (schema['x-astrale-value-kind'] !== 'instant' || schema.type !== 'string') {
+                return new Set();
+            }
+            candidates = intersect(candidates, new Set(['instant']));
+        }
+        const declaredTypes = typesOf(schema.type);
+        if (declaredTypes !== undefined)
+            candidates = intersect(candidates, declaredTypes);
+        if (Object.hasOwn(schema, 'const')) {
+            candidates = intersect(candidates, new Set([kindOfValue(schema.const)]));
+        }
+        if (Array.isArray(schema.enum)) {
+            candidates = intersect(candidates, normalize(new Set(schema.enum.map(kindOfValue))));
+        }
+        if (Object.hasOwn(schema, '$ref')) {
+            const target = this.compiled.reference(location);
+            if (target === undefined)
+                return new Set();
+            candidates = intersect(candidates, this.classify(target));
+        }
+        const allOf = schemaList(schema.allOf);
+        if (allOf !== undefined) {
+            for (let index = 0; index < allOf.length; index += 1) {
+                candidates = intersect(candidates, this.classify(this.child(location, 'allOf', index)));
+            }
+        }
+        for (const keyword of ['anyOf', 'oneOf']) {
+            const branches = schemaList(schema[keyword]);
+            if (branches === undefined)
+                continue;
+            let admitted = new Set();
+            for (let index = 0; index < branches.length; index += 1) {
+                admitted = union(admitted, this.classify(this.child(location, keyword, index)));
+            }
+            candidates = intersect(candidates, admitted);
+        }
+        return candidates;
+    }
+    child(location, keyword, index) {
+        return this.compiled.child(location, keyword, index);
+    }
+}
+function typesOf(input) {
+    if (typeof input === 'string')
+        return typeSet([input]);
+    if (Array.isArray(input)) {
+        const types = input.filter((value) => typeof value === 'string');
+        return typeSet(types);
+    }
+    return undefined;
+}
+function typeSet(types) {
+    const result = new Set();
+    for (const type of types) {
+        if (type === 'integer' || type === 'number')
+            result.add('number');
+        else if (type === 'null' ||
+            type === 'boolean' ||
+            type === 'string' ||
+            type === 'array' ||
+            type === 'object') {
+            result.add(type);
+        }
+    }
+    return result;
+}
+function kindOfValue(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'object')
+        return 'object';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    if (typeof value === 'number')
+        return 'number';
+    return 'string';
+}
+function intersect(left, right) {
+    const result = new Set();
+    for (const leftKind of left) {
+        for (const rightKind of right) {
+            if (leftKind === rightKind)
+                result.add(leftKind);
+            else if ((leftKind === 'string' && rightKind === 'instant') ||
+                (leftKind === 'instant' && rightKind === 'string')) {
+                result.add('instant');
+            }
+        }
+    }
+    return normalize(result);
+}
+function union(left, right) {
+    return normalize(new Set([...left, ...right]));
+}
+function normalize(input) {
+    if (input.has('string'))
+        input.delete('instant');
+    return input;
+}
+function schemaList(input) {
+    return Array.isArray(input) ? input : undefined;
+}

package/dist/v1/language/value/profile/canonicalize.d.ts

@@ -0,0 +1,4 @@
+import type { JsonSchema, ValueSchemaContext } from '../model/schema.js';
+import type { ValueSchemaRegistry } from '../reference/registry.js';
+/** Canonicalizes syntax without rewriting the schema's algebra. Validate first. */
+export declare function canonicalizeValueSchema(schema: JsonSchema, context?: ValueSchemaContext, registry?: ValueSchemaRegistry): JsonSchema;