@kurot/ui-document 0.1.0

package/dist/kurot/schema/UIComponentRegistry.d.ts

@@ -0,0 +1,33 @@
+import type { UIComponentDefinition, UIResolvedComponentDefinition } from './UIComponentDefinition.js';
+/**
+ * Isolated component catalog used by validators, editors, and Agent adapters.
+ */
+export declare class UIComponentRegistry {
+    private readonly _definitions;
+    private readonly _resolvedDefinitions;
+    /**
+     * Adds a definition and rejects accidental replacement of an existing type.
+     */
+    register(definition: UIComponentDefinition): void;
+    /**
+     * Returns the registered definition for an exact component type key.
+     */
+    get(type: string): UIComponentDefinition | undefined;
+    /**
+     * Returns whether an exact component type key is registered.
+     */
+    has(type: string): boolean;
+    /**
+     * Returns all definitions sorted by type for deterministic tools and prompts.
+     */
+    list(): readonly UIComponentDefinition[];
+    /**
+     * Resolves inherited properties and policies for one exact component type.
+     */
+    resolve(type: string): UIResolvedComponentDefinition | undefined;
+    /**
+     * Resolves every definition in deterministic type order, including abstract bases.
+     */
+    resolveAll(): readonly UIResolvedComponentDefinition[];
+}
+//# sourceMappingURL=UIComponentRegistry.d.ts.map

package/dist/kurot/schema/UIComponentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIComponentRegistry.d.ts","sourceRoot":"","sources":["../../../src/kurot/schema/UIComponentRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EAErB,6BAA6B,EAC7B,MAAM,4BAA4B,CAAC;AAIpC;;GAEG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;IACzE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAoD;IAEzF;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IASxD;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI3D;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACI,IAAI,IAAI,SAAS,qBAAqB,EAAE;IAM/C;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS;IASvE;;OAEG;IACI,UAAU,IAAI,SAAS,6BAA6B,EAAE;CAQ7D"}

package/dist/kurot/schema/UIComponentRegistry.js

@@ -0,0 +1,127 @@
+import { UIComponentResolutionError } from './UIComponentResolutionError.js';
+import { validateComponentDefinition } from './validateComponentDefinition.js';
+/**
+ * Isolated component catalog used by validators, editors, and Agent adapters.
+ */
+export class UIComponentRegistry {
+    _definitions = new Map();
+    _resolvedDefinitions = new Map();
+    /**
+     * Adds a definition and rejects accidental replacement of an existing type.
+     */
+    register(definition) {
+        validateComponentDefinition(definition);
+        if (this._definitions.has(definition.type)) {
+            throw new Error(`Component type "${definition.type}" is already registered.`);
+        }
+        this._definitions.set(definition.type, normalizeDefinition(definition));
+        this._resolvedDefinitions.clear();
+    }
+    /**
+     * Returns the registered definition for an exact component type key.
+     */
+    get(type) {
+        return this._definitions.get(type);
+    }
+    /**
+     * Returns whether an exact component type key is registered.
+     */
+    has(type) {
+        return this._definitions.has(type);
+    }
+    /**
+     * Returns all definitions sorted by type for deterministic tools and prompts.
+     */
+    list() {
+        return Object.freeze([...this._definitions.values()].sort(compareDefinitions));
+    }
+    /**
+     * Resolves inherited properties and policies for one exact component type.
+     */
+    resolve(type) {
+        return resolveDefinition(type, this._definitions, this._resolvedDefinitions, []);
+    }
+    /**
+     * Resolves every definition in deterministic type order, including abstract bases.
+     */
+    resolveAll() {
+        const resolved = [];
+        for (const definition of this.list()) {
+            const result = this.resolve(definition.type);
+            if (result)
+                resolved.push(result);
+        }
+        return Object.freeze(resolved);
+    }
+}
+function resolveDefinition(type, definitions, cache, chain) {
+    const cached = cache.get(type);
+    if (cached)
+        return cached;
+    const definition = definitions.get(type);
+    if (!definition)
+        return undefined;
+    const cycleStart = chain.indexOf(type);
+    if (cycleStart >= 0) {
+        const cycle = [...chain.slice(cycleStart), type];
+        throw new UIComponentResolutionError('circular-component-inheritance', `Circular component inheritance detected: ${cycle.join(' -> ')}.`, cycle);
+    }
+    const nextChain = [...chain, type];
+    let base;
+    if (definition.extends) {
+        base = resolveDefinition(definition.extends, definitions, cache, nextChain);
+        if (!base) {
+            throw new UIComponentResolutionError('missing-component-base', `Base component type "${definition.extends}" required by "${type}" is not registered.`, [...nextChain, definition.extends]);
+        }
+    }
+    const resolved = Object.freeze({
+        type: definition.type,
+        baseTypes: Object.freeze(base ? [...base.baseTypes, base.type] : []),
+        abstract: definition.abstract ?? false,
+        displayName: definition.displayName,
+        description: definition.description,
+        children: definition.children ?? base?.children,
+        properties: mergeProperties(base?.properties, definition.properties),
+        allowUnknownProperties: definition.allowUnknownProperties ?? base?.allowUnknownProperties ?? false,
+    });
+    cache.set(type, resolved);
+    return resolved;
+}
+function compareDefinitions(a, b) {
+    return compareStrings(a.type, b.type);
+}
+function normalizeDefinition(definition) {
+    const properties = normalizeProperties(definition.properties ?? {});
+    return Object.freeze({ ...definition, properties });
+}
+function mergeProperties(base, derived) {
+    const merged = new Map(Object.entries(base ?? {}));
+    for (const [name, property] of Object.entries(derived ?? {})) {
+        merged.set(name, property);
+    }
+    const entries = [...merged.entries()].sort(([a], [b]) => compareStrings(a, b));
+    return Object.freeze(Object.fromEntries(entries));
+}
+function compareStrings(a, b) {
+    if (a < b)
+        return -1;
+    if (a > b)
+        return 1;
+    return 0;
+}
+function normalizeProperties(properties) {
+    const entries = Object.entries(properties).map(([name, property]) => [
+        name,
+        Object.freeze({
+            ...property,
+            valueType: Array.isArray(property.valueType)
+                ? Object.freeze([...property.valueType])
+                : property.valueType,
+            ...(property.enumValues
+                ? { enumValues: Object.freeze([...property.enumValues]) }
+                : {}),
+        }),
+    ]);
+    return Object.freeze(Object.fromEntries(entries));
+}
+//# sourceMappingURL=UIComponentRegistry.js.map

package/dist/kurot/schema/UIComponentRegistry.js.map

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

package/dist/kurot/schema/UIComponentResolutionError.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Stable failure categories produced while resolving component inheritance.
+ */
+export type UIComponentResolutionErrorCode = 'circular-component-inheritance' | 'missing-component-base';
+/**
+ * Error raised when registered component definitions cannot be resolved.
+ */
+export declare class UIComponentResolutionError extends Error {
+    /**
+     * Stable category suitable for diagnostics and Agent feedback.
+     */
+    readonly code: UIComponentResolutionErrorCode;
+    /**
+     * Resolution chain ending at the failing or repeated type.
+     */
+    readonly chain: readonly string[];
+    constructor(code: UIComponentResolutionErrorCode, message: string, chain: readonly string[]);
+}
+//# sourceMappingURL=UIComponentResolutionError.d.ts.map

package/dist/kurot/schema/UIComponentResolutionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIComponentResolutionError.d.ts","sourceRoot":"","sources":["../../../src/kurot/schema/UIComponentResolutionError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,8BAA8B,GACvC,gCAAgC,GAChC,wBAAwB,CAAC;AAE5B;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACpD;;OAEG;IACH,SAAgB,IAAI,EAAE,8BAA8B,CAAC;IAErD;;OAEG;IACH,SAAgB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;gBAGxC,IAAI,EAAE,8BAA8B,EACpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,EAAE;CAOzB"}

package/dist/kurot/schema/UIComponentResolutionError.js

@@ -0,0 +1,20 @@
+/**
+ * Error raised when registered component definitions cannot be resolved.
+ */
+export class UIComponentResolutionError extends Error {
+    /**
+     * Stable category suitable for diagnostics and Agent feedback.
+     */
+    code;
+    /**
+     * Resolution chain ending at the failing or repeated type.
+     */
+    chain;
+    constructor(code, message, chain) {
+        super(message);
+        this.name = 'UIComponentResolutionError';
+        this.code = code;
+        this.chain = Object.freeze([...chain]);
+    }
+}
+//# sourceMappingURL=UIComponentResolutionError.js.map

package/dist/kurot/schema/UIComponentResolutionError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIComponentResolutionError.js","sourceRoot":"","sources":["../../../src/kurot/schema/UIComponentResolutionError.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACpD;;OAEG;IACa,IAAI,CAAiC;IAErD;;OAEG;IACa,KAAK,CAAoB;IAEzC,YACC,IAAoC,EACpC,OAAe,EACf,KAAwB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;CACD"}

package/dist/kurot/schema/index.d.ts

@@ -0,0 +1,6 @@
+export type { UIChildrenPolicy, UIComponentDefinition, UIPropertyFormat, UIPropertyDefinition, UIPropertyValueType, UIResolvedComponentDefinition, } from './UIComponentDefinition.js';
+export { UIComponentRegistry } from './UIComponentRegistry.js';
+export { UIComponentResolutionError } from './UIComponentResolutionError.js';
+export type { UIComponentResolutionErrorCode } from './UIComponentResolutionError.js';
+export { validateUIDocumentComponents } from './validateUIDocumentComponents.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/kurot/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/schema/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,6BAA6B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/kurot/schema/index.js

@@ -0,0 +1,4 @@
+export { UIComponentRegistry } from './UIComponentRegistry.js';
+export { UIComponentResolutionError } from './UIComponentResolutionError.js';
+export { validateUIDocumentComponents } from './validateUIDocumentComponents.js';
+//# sourceMappingURL=index.js.map

package/dist/kurot/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/schema/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/kurot/schema/validateComponentDefinition.d.ts

@@ -0,0 +1,6 @@
+import type { UIComponentDefinition } from './UIComponentDefinition.js';
+/**
+ * Rejects malformed component metadata before it enters a registry.
+ */
+export declare function validateComponentDefinition(definition: UIComponentDefinition): void;
+//# sourceMappingURL=validateComponentDefinition.d.ts.map

package/dist/kurot/schema/validateComponentDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateComponentDefinition.d.ts","sourceRoot":"","sources":["../../../src/kurot/schema/validateComponentDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,qBAAqB,EAIrB,MAAM,4BAA4B,CAAC;AAmBpC;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CA4BnF"}

package/dist/kurot/schema/validateComponentDefinition.js

@@ -0,0 +1,145 @@
+const CHILDREN_POLICIES = new Set(['multiple', 'none', 'single']);
+const PROPERTY_VALUE_TYPES = new Set([
+    'array',
+    'boolean',
+    'number',
+    'object',
+    'string',
+    'value',
+]);
+const PROPERTY_FORMATS = new Set([
+    'color',
+    'layout',
+    'rectangle',
+    'resource',
+    'skin',
+]);
+/**
+ * Rejects malformed component metadata before it enters a registry.
+ */
+export function validateComponentDefinition(definition) {
+    assertNonEmpty(definition.type, 'Component type');
+    if (definition.extends !== undefined) {
+        assertNonEmpty(definition.extends, 'Base component type');
+    }
+    if (definition.abstract !== undefined && typeof definition.abstract !== 'boolean') {
+        throw new Error('Component abstract flag must be a boolean.');
+    }
+    if (definition.displayName !== undefined) {
+        assertNonEmpty(definition.displayName, 'Component display name');
+    }
+    if (definition.description !== undefined) {
+        assertNonEmpty(definition.description, 'Component description');
+    }
+    if (definition.children !== undefined && !CHILDREN_POLICIES.has(definition.children)) {
+        throw new Error(`Unsupported child policy "${String(definition.children)}".`);
+    }
+    if (definition.allowUnknownProperties !== undefined &&
+        typeof definition.allowUnknownProperties !== 'boolean') {
+        throw new Error('allowUnknownProperties must be a boolean.');
+    }
+    for (const [name, property] of Object.entries(definition.properties ?? {})) {
+        assertNonEmpty(name, 'Component property name');
+        validatePropertyDefinition(name, property);
+    }
+}
+function validatePropertyDefinition(name, definition) {
+    const valueTypes = Array.isArray(definition.valueType)
+        ? definition.valueType
+        : [definition.valueType];
+    if (valueTypes.length === 0) {
+        throw new Error(`Property "${name}" must accept at least one value type.`);
+    }
+    const uniqueValueTypes = new Set();
+    for (const valueType of valueTypes) {
+        if (!PROPERTY_VALUE_TYPES.has(valueType)) {
+            throw new Error(`Unsupported value type "${String(valueType)}" for property "${name}".`);
+        }
+        if (uniqueValueTypes.has(valueType)) {
+            throw new Error(`Property "${name}" contains duplicate value type "${valueType}".`);
+        }
+        uniqueValueTypes.add(valueType);
+    }
+    if (definition.format !== undefined && !PROPERTY_FORMATS.has(definition.format)) {
+        throw new Error(`Unsupported format "${String(definition.format)}" for property "${name}".`);
+    }
+    if (definition.required !== undefined && typeof definition.required !== 'boolean') {
+        throw new Error(`Property "${name}" required flag must be a boolean.`);
+    }
+    if (definition.description !== undefined) {
+        assertNonEmpty(definition.description, `Property "${name}" description`);
+    }
+    if (definition.integer !== undefined && typeof definition.integer !== 'boolean') {
+        throw new Error(`Property "${name}" integer flag must be a boolean.`);
+    }
+    if (definition.integer &&
+        !uniqueValueTypes.has('number') &&
+        !uniqueValueTypes.has('value')) {
+        throw new Error(`Property "${name}" integer flag requires a numeric value type.`);
+    }
+    validateNumericConstraint(name, 'minimum', definition.minimum, uniqueValueTypes);
+    validateNumericConstraint(name, 'maximum', definition.maximum, uniqueValueTypes);
+    if (definition.minimum !== undefined &&
+        definition.maximum !== undefined &&
+        definition.minimum > definition.maximum) {
+        throw new Error(`Property "${name}" minimum cannot exceed its maximum.`);
+    }
+    validateEnumValues(name, definition, uniqueValueTypes);
+    if (definition.defaultValue !== undefined &&
+        !matchesPropertyConstraints(definition.defaultValue, definition, uniqueValueTypes)) {
+        throw new Error(`Property "${name}" default value does not satisfy its schema.`);
+    }
+}
+function validateEnumValues(name, definition, valueTypes) {
+    const enumValues = definition.enumValues;
+    if (enumValues === undefined)
+        return;
+    if (!Array.isArray(enumValues) || enumValues.length === 0) {
+        throw new Error(`Property "${name}" enumValues must be a non-empty array.`);
+    }
+    for (const value of enumValues) {
+        if (!matchesPrimitiveType(value, valueTypes)) {
+            throw new Error(`Property "${name}" has an enum value outside its accepted types.`);
+        }
+    }
+    for (let index = 0; index < enumValues.length; index++) {
+        if (enumValues.slice(0, index).some(value => Object.is(value, enumValues[index]))) {
+            throw new Error(`Property "${name}" contains duplicate enum values.`);
+        }
+    }
+}
+function validateNumericConstraint(name, label, value, valueTypes) {
+    if (value === undefined)
+        return;
+    if (!Number.isFinite(value)) {
+        throw new Error(`Property "${name}" ${label} must be a finite number.`);
+    }
+    if (!valueTypes.has('number') && !valueTypes.has('value')) {
+        throw new Error(`Property "${name}" ${label} requires a numeric value type.`);
+    }
+}
+function matchesPropertyConstraints(value, definition, valueTypes) {
+    if (!matchesPrimitiveType(value, valueTypes))
+        return false;
+    if (definition.enumValues && !definition.enumValues.some(item => Object.is(item, value))) {
+        return false;
+    }
+    if (typeof value !== 'number')
+        return true;
+    if (definition.minimum !== undefined && value < definition.minimum)
+        return false;
+    if (definition.maximum !== undefined && value > definition.maximum)
+        return false;
+    return !definition.integer || Number.isInteger(value);
+}
+function matchesPrimitiveType(value, valueTypes) {
+    if (typeof value === 'number' && !Number.isFinite(value))
+        return false;
+    return valueTypes.has('value') || valueTypes.has(typeof value);
+}
+function assertNonEmpty(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string.`);
+    }
+}
+//# sourceMappingURL=validateComponentDefinition.js.map

package/dist/kurot/schema/validateComponentDefinition.js.map

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

package/dist/kurot/schema/validateUIDocumentComponents.d.ts

@@ -0,0 +1,9 @@
+import type { UIDocument } from '../model/UIDocument.js';
+import type { UIDiagnostic } from '../validation/UIDiagnostic.js';
+import type { UIComponentRegistry } from './UIComponentRegistry.js';
+/**
+ * Validates component types, known properties, and child policies against a registry.
+ * The document must first pass validateUIDocument.
+ */
+export declare function validateUIDocumentComponents(document: UIDocument, registry: UIComponentRegistry): UIDiagnostic[];
+//# sourceMappingURL=validateUIDocumentComponents.d.ts.map

package/dist/kurot/schema/validateUIDocumentComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateUIDocumentComponents.d.ts","sourceRoot":"","sources":["../../../src/kurot/schema/validateUIDocumentComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAMlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE;;;GAGG;AACH,wBAAgB,4BAA4B,CAC3C,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,mBAAmB,GAC3B,YAAY,EAAE,CAIhB"}

package/dist/kurot/schema/validateUIDocumentComponents.js

@@ -0,0 +1,135 @@
+import { UIComponentResolutionError } from './UIComponentResolutionError.js';
+/**
+ * Validates component types, known properties, and child policies against a registry.
+ * The document must first pass validateUIDocument.
+ */
+export function validateUIDocumentComponents(document, registry) {
+    const diagnostics = [];
+    validateNode(document.root, '$.root', registry, diagnostics);
+    return diagnostics;
+}
+function validateNode(node, path, registry, diagnostics) {
+    let definition;
+    try {
+        definition = registry.resolve(node.type);
+    }
+    catch (error) {
+        if (!(error instanceof UIComponentResolutionError))
+            throw error;
+        diagnostics.push({
+            code: error.code,
+            severity: 'error',
+            path: `${path}.type`,
+            message: error.message,
+        });
+    }
+    if (!definition) {
+        if (!registry.has(node.type)) {
+            diagnostics.push({
+                code: 'unknown-component-type',
+                severity: 'error',
+                path: `${path}.type`,
+                message: `Component type "${node.type}" is not registered.`,
+            });
+        }
+    }
+    else {
+        if (definition.abstract) {
+            diagnostics.push({
+                code: 'abstract-component-type',
+                severity: 'error',
+                path: `${path}.type`,
+                message: `Abstract component type "${node.type}" cannot be instantiated.`,
+            });
+        }
+        const properties = definition.properties;
+        for (const [name, property] of Object.entries(properties)) {
+            if (property.required && !Object.hasOwn(node.properties, name)) {
+                diagnostics.push({
+                    code: 'missing-component-property',
+                    severity: 'error',
+                    path: `${path}.properties.${name}`,
+                    message: `Required property "${name}" is missing from ${node.type}.`,
+                });
+            }
+        }
+        for (const [name, value] of Object.entries(node.properties)) {
+            const property = properties[name];
+            if (!property) {
+                if (!definition.allowUnknownProperties) {
+                    diagnostics.push({
+                        code: 'unknown-component-property',
+                        severity: 'error',
+                        path: `${path}.properties.${name}`,
+                        message: `Property "${name}" is not defined for ${node.type}.`,
+                    });
+                }
+                continue;
+            }
+            if (!matchesProperty(value, property)) {
+                diagnostics.push({
+                    code: 'invalid-component-property',
+                    severity: 'error',
+                    path: `${path}.properties.${name}`,
+                    message: `Property "${name}" on ${node.type} does not satisfy its schema.`,
+                });
+            }
+        }
+        validateChildren(node, path, diagnostics, definition.children);
+    }
+    for (let index = 0; index < node.children.length; index++) {
+        validateNode(node.children[index], `${path}.children[${index}]`, registry, diagnostics);
+    }
+}
+function validateChildren(node, path, diagnostics, policy) {
+    const invalid = (policy === 'none' && node.children.length !== 0) ||
+        (policy === 'single' && node.children.length > 1);
+    if (!invalid)
+        return;
+    diagnostics.push({
+        code: 'invalid-component-children',
+        severity: 'error',
+        path: `${path}.children`,
+        message: policy === 'none'
+            ? `Component ${node.type} does not accept children.`
+            : `Component ${node.type} accepts at most one child.`,
+    });
+}
+function matchesProperty(value, property) {
+    const valueTypes = Array.isArray(property.valueType)
+        ? property.valueType
+        : [property.valueType];
+    if (!valueTypes.some(valueType => matchesValueType(value, valueType)))
+        return false;
+    if (property.enumValues && !property.enumValues.some(item => Object.is(item, value))) {
+        return false;
+    }
+    if (typeof value === 'number') {
+        if (property.minimum !== undefined && value < property.minimum)
+            return false;
+        if (property.maximum !== undefined && value > property.maximum)
+            return false;
+        if (property.integer && !Number.isInteger(value))
+            return false;
+    }
+    return true;
+}
+function matchesValueType(value, valueType) {
+    switch (valueType) {
+        case 'array':
+            return Array.isArray(value);
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'number':
+            return typeof value === 'number';
+        case 'object':
+            return typeof value === 'object' && !Array.isArray(value);
+        case 'string':
+            return typeof value === 'string';
+        case 'value':
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=validateUIDocumentComponents.js.map

package/dist/kurot/schema/validateUIDocumentComponents.js.map

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

package/dist/kurot/serialization/UIDocumentParseError.d.ts

@@ -0,0 +1,12 @@
+import type { UIDiagnostic } from '../validation/UIDiagnostic.js';
+/**
+ * Error raised when JSON cannot be decoded as a current-format UI document.
+ */
+export declare class UIDocumentParseError extends Error {
+    /**
+     * Structured failures suitable for editor and Agent feedback.
+     */
+    readonly diagnostics: readonly UIDiagnostic[];
+    constructor(diagnostics: readonly UIDiagnostic[], cause?: Error);
+}
+//# sourceMappingURL=UIDocumentParseError.d.ts.map

package/dist/kurot/serialization/UIDocumentParseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIDocumentParseError.d.ts","sourceRoot":"","sources":["../../../src/kurot/serialization/UIDocumentParseError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C;;OAEG;IACH,SAAgB,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC;gBAElC,WAAW,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK;CAMtE"}

package/dist/kurot/serialization/UIDocumentParseError.js

@@ -0,0 +1,16 @@
+/**
+ * Error raised when JSON cannot be decoded as a current-format UI document.
+ */
+export class UIDocumentParseError extends Error {
+    /**
+     * Structured failures suitable for editor and Agent feedback.
+     */
+    diagnostics;
+    constructor(diagnostics, cause) {
+        const detail = diagnostics[0]?.message ?? 'Unknown document error.';
+        super(`Unable to parse UI document: ${detail}`, { cause });
+        this.name = 'UIDocumentParseError';
+        this.diagnostics = diagnostics;
+    }
+}
+//# sourceMappingURL=UIDocumentParseError.js.map

package/dist/kurot/serialization/UIDocumentParseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIDocumentParseError.js","sourceRoot":"","sources":["../../../src/kurot/serialization/UIDocumentParseError.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC9C;;OAEG;IACa,WAAW,CAA0B;IAErD,YAAmB,WAAoC,EAAE,KAAa;QACrE,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,yBAAyB,CAAC;QACpE,KAAK,CAAC,gCAAgC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;CACD"}

package/dist/kurot/serialization/UIDocumentValidationError.d.ts

@@ -0,0 +1,12 @@
+import type { UIDiagnostic } from '../validation/UIDiagnostic.js';
+/**
+ * Error raised when an in-memory document cannot be safely serialized.
+ */
+export declare class UIDocumentValidationError extends Error {
+    /**
+     * Structured failures suitable for editor and Agent feedback.
+     */
+    readonly diagnostics: readonly UIDiagnostic[];
+    constructor(diagnostics: readonly UIDiagnostic[]);
+}
+//# sourceMappingURL=UIDocumentValidationError.d.ts.map

package/dist/kurot/serialization/UIDocumentValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIDocumentValidationError.d.ts","sourceRoot":"","sources":["../../../src/kurot/serialization/UIDocumentValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IACnD;;OAEG;IACH,SAAgB,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC;gBAElC,WAAW,EAAE,SAAS,YAAY,EAAE;CAMvD"}