@kurot/ui-document 0.5.2 → 0.6.1

package/README.md

@@ -4,9 +4,8 @@ Headless semantic document foundation for Kurot UI tooling. It is intended to
 provide one format and one mutation model shared by the future visual UI
 builder, `@kurot/cli`, and Agent-driven UI generation.
 
-> **Early development (0.5.x).** The reusable authoring model and headless
-> editing kernel are implemented, but the schema remains pre-1.0 and is not yet
-> a production file format.
+> **Current release: 0.6.1.** KUI XML is the canonical authored format. The
+> schema remains pre-1.0, so later minor releases may still refine its contract.
 
 ## Installation
 
@@ -28,8 +27,8 @@ import {
 } from '@kurot/ui-document';
 
 const document = createUIDocument({
-  id: 'main-screen',
-  assetKind: 'screen',
+  id: 'game.MainSkin',
+  assetKind: 'appearance',
   root: createUINode({
     id: 'root',
     type: 'kui.Group',
@@ -52,6 +51,10 @@ const source = serializeUIDocument(document);
 `type` is an external registry key; this package does not import or instantiate
 the corresponding `@kurot/ui` class.
 
+KUI XML serializes Skin documents only. Screen and reusable-component
+documents are programmatic semantic models and do not share the authored Skin
+file pipeline.
+
 ## Current capabilities
 
 - explicit screen, reusable-component, and appearance assets;
@@ -72,8 +75,7 @@ the corresponding `@kurot/ui` class.
 - strict validation of schema keys, versions, identifiers, unique node IDs,
   plain property values, finite numbers, and acyclic trees;
 - structured diagnostics with stable codes and JSON-style paths;
-- validated JSON parsing and deterministic serialization with sorted property
-  keys;
+- validated KUI XML parsing and deterministic canonical serialization;
 - runtime-independent component definitions and an isolated component registry;
 - inherited appearance-state, native-part, and emitted-event capabilities;
 - abstract base definitions, single-parent inheritance, deterministic schema
@@ -209,8 +211,9 @@ It defines the abstract semantic bases `kurot.DisplayObject`,
 `kui.ToggleButton`, `kui.ProgressBar`, and `kui.TextInput` nodes. `Group`
 accepts ordered children; the other concrete nodes are leaves.
 
-`kui.*` is the canonical Kurot UI namespace. EUI names belong only to legacy
-EXML adapters and are not stored in the semantic document.
+`kui.*` is the canonical Kurot UI namespace. Authored Skin files use the
+[`KUI XML format`](./docs/kui-xml.md); EUI names and EXML are not stored in the
+semantic document.
 
 The foundation catalog declares the serializable authoring properties inherited
 from Kurot display objects and UI layout elements, then adds the audited direct
@@ -242,19 +245,17 @@ package boundaries.
 
 ## Intended boundary
 
-The package owns the serializable UI asset model and its deterministic
-operations. Planned layers include:
+The package owns the serializable UI asset model, KUI XML syntax, and its
+deterministic operations. Planned work includes:
 
-- the remaining component catalog and nested structured-value constraints;
-- document migrations;
-- adapters for formats such as EXML.
+- the remaining component catalog and nested structured-value constraints.
 
 It will not own rendering, runtime UI components, editor panels, filesystem
 or network I/O, or model-provider integration. Those concerns belong to
 `@kurot/ui`, the visual builder, CLI orchestration, and Agent adapters
 respectively.
 
-`@kurot/ui-runtime@0.4.x` validates and materializes format-version-2 assets,
+`@kurot/ui-runtime@0.5.x` validates and materializes format-version-2 assets,
 including reusable instances, parameter bindings, Slots, component variants,
 part overrides, design tokens, resource hooks, and native appearance
 skins/states. It also executes the bounded data, action, and transition

package/dist/kurot/model/UIDocument.d.ts

@@ -10,7 +10,7 @@ export declare const UI_DOCUMENT_KIND = "kurot-ui-document";
  */
 export interface UIDocument {
     /**
-     * Stable discriminator used to reject unrelated JSON documents.
+     * Stable discriminator used to reject unrelated semantic values.
      */
     readonly kind: typeof UI_DOCUMENT_KIND;
     /**

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

@@ -2,8 +2,10 @@ export type { UIAssetKind } from './UIAssetKind.js';
 export type { UIAssetContract, UIDataBindingDefinition, UIParameterBinding, UIParameterDefinition, UIPartDefinition, UIPropertyOverride, UIPropertyTransition, UISemanticActionDefinition, UISemanticActionTrigger, UISlotDefinition, UIStateDefinition, UITransitionEasing, UIVariantDefinition, } from './UIAssetContract.js';
 export type { UIComponentInstance, UIInstanceOverride, } from './UIComponentInstance.js';
 export type { UIAssetReference, UIAppearanceReference, UIDesignTokenReference, UIDesignTokenType, UIResourceReference, UIResourceType, } from './UIReference.js';
+export { isUIAssetReference, isUIDesignTokenReference, isUIResourceReference, UI_DESIGN_TOKEN_TYPES, UI_RESOURCE_TYPES, } from './UIReference.js';
 export { UI_DOCUMENT_KIND } from './UIDocument.js';
 export type { UIDocument } from './UIDocument.js';
 export type { UINode } from './UINode.js';
+export { isSyntheticNodeId } from './synthetic-node-id.js';
 export type { UIPropertyObject, UIPropertyPrimitive, UIPropertyValue, } from './UIPropertyValue.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/model/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EACX,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACX,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACX,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EACX,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GACf,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/model/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EACX,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACX,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACX,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACX,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GACf,MAAM,sBAAsB,CAAC"}

package/dist/kurot/model/index.js

@@ -1,2 +1,4 @@
+export { isUIAssetReference, isUIDesignTokenReference, isUIResourceReference, UI_DESIGN_TOKEN_TYPES, UI_RESOURCE_TYPES, } from './UIReference.js';
 export { UI_DOCUMENT_KIND } from './UIDocument.js';
+export { isSyntheticNodeId } from './synthetic-node-id.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/model/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/model/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EACN,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/kurot/model/synthetic-node-id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Creates a deterministic semantic id for an unnamed authored node.
+ */
+export declare function createSyntheticNodeId(path: string): string;
+/**
+ * Returns whether an id exists only to connect the semantic model internally.
+ */
+export declare function isSyntheticNodeId(id: string): boolean;
+//# sourceMappingURL=synthetic-node-id.d.ts.map

package/dist/kurot/model/synthetic-node-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-node-id.d.ts","sourceRoot":"","sources":["../../../src/kurot/model/synthetic-node-id.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/kurot/model/synthetic-node-id.js

@@ -0,0 +1,14 @@
+const SYNTHETIC_NODE_ID_PREFIX = '__kui_node_';
+/**
+ * Creates a deterministic semantic id for an unnamed authored node.
+ */
+export function createSyntheticNodeId(path) {
+    return `${SYNTHETIC_NODE_ID_PREFIX}${path.replaceAll('.', '_')}`;
+}
+/**
+ * Returns whether an id exists only to connect the semantic model internally.
+ */
+export function isSyntheticNodeId(id) {
+    return id.startsWith(SYNTHETIC_NODE_ID_PREFIX);
+}
+//# sourceMappingURL=synthetic-node-id.js.map

package/dist/kurot/model/synthetic-node-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-node-id.js","sourceRoot":"","sources":["../../../src/kurot/model/synthetic-node-id.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IACjD,OAAO,GAAG,wBAAwB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC3C,OAAO,EAAE,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;AAChD,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { UIDiagnostic } from '../validation/UIDiagnostic.js';
 /**
- * Error raised when JSON cannot be decoded as a current-format UI document.
+ * Error raised when KUI XML cannot be decoded as a current-format UI document.
  */
 export declare class UIDocumentParseError extends Error {
     /**

package/dist/kurot/serialization/UIDocumentParseError.js

@@ -1,6 +1,6 @@
 import { firstDiagnosticMessage } from './first-diagnostic-message.js';
 /**
- * Error raised when JSON cannot be decoded as a current-format UI document.
+ * Error raised when KUI XML cannot be decoded as a current-format UI document.
  */
 export class UIDocumentParseError extends Error {
     /**

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

@@ -1,4 +1,4 @@
 export { UIDocumentParseError } from './UIDocumentParseError.js';
 export { UIDocumentValidationError } from './UIDocumentValidationError.js';
-export { parseUIDocument, serializeUIDocument } from './json.js';
+export { KUI_XML_NAMESPACE, parseUIDocument, serializeUIDocument } from './xml.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/serialization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/serialization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/kurot/serialization/index.js

@@ -1,4 +1,4 @@
 export { UIDocumentParseError } from './UIDocumentParseError.js';
 export { UIDocumentValidationError } from './UIDocumentValidationError.js';
-export { parseUIDocument, serializeUIDocument } from './json.js';
+export { KUI_XML_NAMESPACE, parseUIDocument, serializeUIDocument } from './xml.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/serialization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/serialization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/kurot/serialization/xml/xml-node.d.ts

@@ -0,0 +1,23 @@
+import type { UIPropertyOverride, UIStateDefinition } from '../../model/UIAssetContract.js';
+import type { UINode } from '../../model/UINode.js';
+import type { XMLElement } from './xml-parser.js';
+export interface XMLNamespaces {
+    readonly prefixes: Readonly<Record<string, string>>;
+}
+export interface XMLNodeParseContext extends XMLNamespaces {
+    readonly states: ReadonlySet<string>;
+    readonly stateOverrides: Map<string, UIPropertyOverride[]>;
+}
+/**
+ * Collects custom component namespace prefixes used by a node tree.
+ */
+export declare function collectNodePrefixes(node: UINode, prefixes: Set<string>): void;
+/**
+ * Serializes one semantic node using component tags.
+ */
+export declare function serializeNode(node: UINode, depth: number, states?: Readonly<Record<string, UIStateDefinition>>): string[];
+/**
+ * Parses one component element into a semantic node.
+ */
+export declare function parseNode(element: XMLElement, context: XMLNodeParseContext, path?: string): UINode;
+//# sourceMappingURL=xml-node.d.ts.map

package/dist/kurot/serialization/xml/xml-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-node.d.ts","sourceRoot":"","sources":["../../../../src/kurot/serialization/xml/xml-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAKpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACzD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAO7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAM,GACtD,MAAM,EAAE,CAiEV;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,SAAM,GAAG,MAAM,CAyD/F"}

package/dist/kurot/serialization/xml/xml-node.js

@@ -0,0 +1,224 @@
+import { createSyntheticNodeId, isSyntheticNodeId } from '../../model/synthetic-node-id.js';
+import { createKurotUIFoundationRegistry } from '../../catalog/kurot-ui-foundation.js';
+import { compareStrings } from '../../shared/strings.js';
+import { decodeXMLValue, encodeXMLValue, escapeXML } from './xml-values.js';
+const RESERVED_ATTRIBUTES = new Set(['id', 'xmlns']);
+const FOUNDATION_COMPONENTS = createKurotUIFoundationRegistry();
+const LAYOUT_TYPES = new Set(['BasicLayout', 'HorizontalLayout', 'TileLayout', 'VerticalLayout']);
+/**
+ * Collects custom component namespace prefixes used by a node tree.
+ */
+export function collectNodePrefixes(node, prefixes) {
+    const separator = node.type.indexOf('.');
+    const prefix = separator === -1 ? 'kui' : node.type.slice(0, separator);
+    if (prefix !== 'kui')
+        prefixes.add(prefix);
+    for (const child of node.children) {
+        collectNodePrefixes(child, prefixes);
+    }
+}
+/**
+ * Serializes one semantic node using component tags.
+ */
+export function serializeNode(node, depth, states = {}) {
+    const indent = '    '.repeat(depth);
+    const tag = componentTag(node.type);
+    const attributes = isSyntheticNodeId(node.id) ? [] : [`id="${escapeXML(node.id)}"`];
+    const stateProperties = new Set();
+    let layout;
+    if (node.appearance !== undefined || node.instance !== undefined) {
+        throw new Error('Skin XML nodes do not serialize semantic asset composition metadata.');
+    }
+    for (const [name, value] of sortedEntries(node.properties)) {
+        if (name === 'layout') {
+            layout = value;
+            continue;
+        }
+        if (name.includes('.')) {
+            throw new Error(`Skin property name "${name}" must not contain a dot.`);
+        }
+        const encoded = encodeXMLValue(value, propertyDefinition(node.type, name));
+        if (encoded === undefined || RESERVED_ATTRIBUTES.has(name) || name.startsWith('xmlns')) {
+            throw new Error(`Skin property "${name}" must be a scalar value.`);
+        }
+        attributes.push(`${name}="${escapeXML(encoded)}"`);
+    }
+    for (const [stateName, state] of Object.entries(states)) {
+        for (const override of state.overrides) {
+            if (override.targetId !== node.id)
+                continue;
+            if (override.property.includes('.')) {
+                throw new Error(`Skin state property name "${override.property}" must not contain a dot.`);
+            }
+            const stateProperty = `${override.property}.${stateName}`;
+            if (stateProperties.has(stateProperty)) {
+                throw new Error(`Skin XML cannot serialize duplicate state property "${stateProperty}".`);
+            }
+            stateProperties.add(stateProperty);
+            if (override.transition !== undefined) {
+                throw new Error(`Skin XML does not serialize transitions for state "${stateName}".`);
+            }
+            const encoded = encodeXMLValue(override.value, propertyDefinition(node.type, override.property));
+            if (encoded === undefined) {
+                throw new Error(`State property "${override.property}.${stateName}" must be a scalar value.`);
+            }
+            attributes.push(`${stateProperty}="${escapeXML(encoded)}"`);
+        }
+    }
+    const attributeSuffix = attributes.length === 0 ? '' : ` ${attributes.join(' ')}`;
+    if (layout === undefined && node.children.length === 0) {
+        return [`${indent}<${tag}${attributeSuffix} />`];
+    }
+    const lines = [`${indent}<${tag}${attributeSuffix}>`];
+    if (layout !== undefined) {
+        lines.push(...serializeLayout(layout, depth + 1));
+    }
+    for (const child of node.children) {
+        lines.push(...serializeNode(child, depth + 1, states));
+    }
+    lines.push(`${indent}</${tag}>`);
+    return lines;
+}
+/**
+ * Parses one component element into a semantic node.
+ */
+export function parseNode(element, context, path = '0') {
+    const authoredId = element.attributes.id;
+    if (authoredId !== undefined && isSyntheticNodeId(authoredId)) {
+        throw new Error(`Skin component id "${authoredId}" uses a reserved internal prefix.`);
+    }
+    const id = authoredId ?? createSyntheticNodeId(path);
+    const type = componentType(element.name, context);
+    const properties = {};
+    const children = [];
+    for (const [name, value] of Object.entries(element.attributes)) {
+        if (RESERVED_ATTRIBUTES.has(name) || name.startsWith('xmlns:'))
+            continue;
+        if (name === 'appearance' || name === 'appearanceVariant') {
+            throw new Error(`Skin component <${element.name}> does not support ${name}.`);
+        }
+        const stateSeparator = name.lastIndexOf('.');
+        if (stateSeparator !== -1) {
+            const property = name.slice(0, stateSeparator);
+            const stateName = name.slice(stateSeparator + 1);
+            if (property.length === 0 || !context.states.has(stateName)) {
+                throw new Error(`State property "${name}" references an undeclared state.`);
+            }
+            const overrides = context.stateOverrides.get(stateName);
+            if (overrides === undefined) {
+                throw new Error(`State "${stateName}" has no override collection.`);
+            }
+            overrides.push({
+                targetId: id,
+                property,
+                value: decodeXMLValue(value, propertyDefinition(type, property)),
+            });
+            continue;
+        }
+        properties[name] = decodeXMLValue(value, propertyDefinition(type, name));
+    }
+    let childIndex = 0;
+    for (const child of element.children) {
+        if (child.name === 'layout') {
+            if (properties.layout !== undefined) {
+                throw new Error(`<${element.name}> contains duplicate layout metadata.`);
+            }
+            properties.layout = parseLayout(child);
+        }
+        else if (child.name === 'properties' || child.name === 'instance') {
+            throw new Error(`<${child.name}> is not Skin XML syntax.`);
+        }
+        else {
+            children.push(parseNode(child, context, `${path}.${childIndex}`));
+            childIndex++;
+        }
+    }
+    return {
+        id,
+        type,
+        properties,
+        children,
+    };
+}
+function serializeLayout(value, depth) {
+    const descriptor = requirePropertyObject(value, 'Layout descriptor');
+    const type = descriptor.type;
+    if (typeof type !== 'string' || !type.startsWith('kui.')) {
+        throw new Error('Layout descriptor requires a kui.* type.');
+    }
+    const name = type.slice('kui.'.length);
+    if (!LAYOUT_TYPES.has(name)) {
+        throw new Error(`Unsupported layout type "${type}".`);
+    }
+    const properties = descriptor.properties === undefined
+        ? {}
+        : requirePropertyObject(descriptor.properties, 'Layout properties');
+    const attributes = [];
+    for (const [property, propertyValue] of sortedEntries(properties)) {
+        const encoded = encodeXMLValue(propertyValue);
+        if (encoded === undefined) {
+            throw new Error(`Layout property "${property}" must be a scalar value.`);
+        }
+        attributes.push(`${property}="${escapeXML(encoded)}"`);
+    }
+    const indent = '    '.repeat(depth);
+    const suffix = attributes.length === 0 ? '' : ` ${attributes.join(' ')}`;
+    return [
+        `${indent}<layout>`,
+        `${indent}    <${name}${suffix} />`,
+        `${indent}</layout>`,
+    ];
+}
+function parseLayout(element) {
+    if (Object.keys(element.attributes).length > 0) {
+        throw new Error('<layout> does not accept attributes.');
+    }
+    if (element.children.length !== 1 || element.children[0] === undefined) {
+        throw new Error('<layout> requires exactly one layout component.');
+    }
+    const layout = element.children[0];
+    if (!LAYOUT_TYPES.has(layout.name)) {
+        throw new Error(`Unsupported layout component <${layout.name}>.`);
+    }
+    if (layout.children.length > 0) {
+        throw new Error(`<${layout.name}> cannot contain child elements.`);
+    }
+    const properties = {};
+    for (const [name, value] of Object.entries(layout.attributes)) {
+        properties[name] = decodeXMLValue(value);
+    }
+    return {
+        type: `kui.${layout.name}`,
+        properties,
+    };
+}
+function requirePropertyObject(value, label) {
+    if (typeof value !== 'object' || Array.isArray(value) || 'kind' in value) {
+        throw new Error(`${label} must be an object.`);
+    }
+    return value;
+}
+function componentTag(type) {
+    const separator = type.indexOf('.');
+    if (separator === -1)
+        return type;
+    const prefix = type.slice(0, separator);
+    const name = type.slice(separator + 1);
+    return prefix === 'kui' ? name : `${prefix}:${name}`;
+}
+function componentType(tag, namespaces) {
+    const separator = tag.indexOf(':');
+    if (separator === -1)
+        return `kui.${tag}`;
+    const prefix = tag.slice(0, separator);
+    if (!Object.hasOwn(namespaces.prefixes, prefix))
+        throw new Error(`Undeclared component namespace prefix "${prefix}".`);
+    return `${prefix}.${tag.slice(separator + 1)}`;
+}
+function sortedEntries(record) {
+    return Object.entries(record).sort(([left], [right]) => compareStrings(left, right));
+}
+function propertyDefinition(type, property) {
+    return FOUNDATION_COMPONENTS.resolve(type)?.properties[property];
+}
+//# sourceMappingURL=xml-node.js.map

package/dist/kurot/serialization/xml/xml-node.js.map

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

package/dist/kurot/serialization/xml/xml-parser.d.ts

@@ -0,0 +1,10 @@
+export interface XMLElement {
+    readonly name: string;
+    readonly attributes: Readonly<Record<string, string>>;
+    readonly children: readonly XMLElement[];
+}
+/**
+ * Parses the XML subset used by canonical KUI documents.
+ */
+export declare function parseXML(source: string): XMLElement;
+//# sourceMappingURL=xml-parser.d.ts.map

package/dist/kurot/serialization/xml/xml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-parser.d.ts","sourceRoot":"","sources":["../../../../src/kurot/serialization/xml/xml-parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC;AAOD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAGnD"}

package/dist/kurot/serialization/xml/xml-parser.js

@@ -0,0 +1,134 @@
+const NAME = '[A-Za-z_][\\w:.-]*';
+const OPEN_PATTERN = new RegExp(`^<(${NAME})`);
+const CLOSE_PATTERN = new RegExp(`^<\\/(${NAME})\\s*>`);
+const ATTRIBUTE_PATTERN = new RegExp(`^(${NAME})\\s*=\\s*(?:"([^"]*)"|'([^']*)')`);
+/**
+ * Parses the XML subset used by canonical KUI documents.
+ */
+export function parseXML(source) {
+    const parser = new XMLParser(source);
+    return parser.parse();
+}
+class XMLParser {
+    _source;
+    _position = 0;
+    constructor(_source) {
+        this._source = _source;
+    }
+    parse() {
+        this._skipMiscellaneous();
+        const root = this._parseElement();
+        this._skipMiscellaneous();
+        if (this._position !== this._source.length) {
+            throw this._error('Unexpected content after the root element.');
+        }
+        return root;
+    }
+    _parseElement() {
+        const opening = this._source.slice(this._position).match(OPEN_PATTERN);
+        if (!opening || opening[1] === undefined) {
+            throw this._error('Expected an XML element.');
+        }
+        const name = opening[1];
+        this._position += opening[0].length;
+        const attributes = {};
+        for (;;) {
+            this._skipWhitespace();
+            if (this._source.startsWith('/>', this._position)) {
+                this._position += 2;
+                return { name, attributes, children: [] };
+            }
+            if (this._source[this._position] === '>') {
+                this._position++;
+                break;
+            }
+            const attribute = this._source.slice(this._position).match(ATTRIBUTE_PATTERN);
+            if (!attribute || attribute[1] === undefined) {
+                throw this._error(`Invalid attribute in <${name}>.`);
+            }
+            if (Object.hasOwn(attributes, attribute[1])) {
+                throw this._error(`Duplicate attribute "${attribute[1]}" in <${name}>.`);
+            }
+            attributes[attribute[1]] = decodeXML(attribute[2] ?? attribute[3] ?? '');
+            this._position += attribute[0].length;
+        }
+        const children = [];
+        for (;;) {
+            this._skipMiscellaneous();
+            const closing = this._source.slice(this._position).match(CLOSE_PATTERN);
+            if (closing) {
+                if (closing[1] !== name) {
+                    throw this._error(`Expected </${name}>, received </${String(closing[1])}>.`);
+                }
+                this._position += closing[0].length;
+                return { name, attributes, children };
+            }
+            if (this._position >= this._source.length) {
+                throw this._error(`Missing closing tag </${name}>.`);
+            }
+            if (this._source[this._position] !== '<') {
+                const text = this._readText();
+                if (text.trim().length > 0) {
+                    throw this._error(`Text content is not allowed inside <${name}>.`);
+                }
+                continue;
+            }
+            children.push(this._parseElement());
+        }
+    }
+    _readText() {
+        const start = this._position;
+        while (this._position < this._source.length && this._source[this._position] !== '<') {
+            this._position++;
+        }
+        return decodeXML(this._source.slice(start, this._position));
+    }
+    _skipMiscellaneous() {
+        for (;;) {
+            this._skipWhitespace();
+            if (this._source.startsWith('<!--', this._position)) {
+                this._skipThrough('-->', 'Unterminated XML comment.');
+                continue;
+            }
+            if (this._source.startsWith('<?', this._position)) {
+                this._skipThrough('?>', 'Unterminated processing instruction.');
+                continue;
+            }
+            return;
+        }
+    }
+    _skipThrough(terminator, message) {
+        const end = this._source.indexOf(terminator, this._position + 2);
+        if (end === -1) {
+            throw this._error(message);
+        }
+        this._position = end + terminator.length;
+    }
+    _skipWhitespace() {
+        while (/\s/.test(this._source[this._position] ?? '')) {
+            this._position++;
+        }
+    }
+    _error(message) {
+        return new Error(`${message} (offset ${this._position})`);
+    }
+}
+function decodeXML(value) {
+    const named = {
+        amp: '&',
+        apos: "'",
+        gt: '>',
+        lt: '<',
+        quot: '"',
+    };
+    return value.replace(/&(#x[0-9a-f]+|#\d+|amp|apos|gt|lt|quot);/gi, (match, entity) => {
+        if (entity.startsWith('#x')) {
+            return String.fromCodePoint(Number.parseInt(entity.slice(2), 16));
+        }
+        if (entity.startsWith('#')) {
+            return String.fromCodePoint(Number.parseInt(entity.slice(1), 10));
+        }
+        return named[entity] ?? match;
+    });
+}
+//# sourceMappingURL=xml-parser.js.map

package/dist/kurot/serialization/xml/xml-parser.js.map

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