@kurot/ui-document 0.1.0

package/dist/kurot/catalog/properties/foundation-properties.js

@@ -0,0 +1,215 @@
+/**
+ * Serializable authoring properties inherited by every Kurot display node.
+ */
+export const DISPLAY_OBJECT_PROPERTIES = {
+    alpha: {
+        valueType: 'number',
+        minimum: 0,
+        maximum: 1,
+        defaultValue: 1,
+        description: 'Opacity applied to this node and its descendants.',
+    },
+    anchorOffsetX: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Horizontal transform origin offset in local pixels.',
+    },
+    anchorOffsetY: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Vertical transform origin offset in local pixels.',
+    },
+    blendMode: {
+        valueType: 'string',
+        enumValues: [
+            'source-over',
+            'lighter',
+            'destination-out',
+            'multiply',
+            'screen',
+            'lighten',
+            'darken',
+            'difference',
+            'overlay',
+            'hard-light',
+            'soft-light',
+            'color-dodge',
+            'color-burn',
+            'exclusion',
+            'hue',
+            'saturation',
+            'color',
+            'luminosity',
+        ],
+        defaultValue: 'source-over',
+        description: 'Compositing mode used when rendering this node.',
+    },
+    cacheAsBitmap: {
+        valueType: 'boolean',
+        defaultValue: false,
+        description: 'Whether to cache this display subtree as a reusable texture.',
+    },
+    height: {
+        valueType: 'number',
+        minimum: 0,
+        description: 'Explicit height in pixels; omit it to use measured height.',
+    },
+    name: {
+        valueType: 'string',
+        defaultValue: '',
+        description: 'Optional runtime name used for display-tree lookup and diagnostics.',
+    },
+    rotation: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Clockwise rotation in degrees.',
+    },
+    scaleX: {
+        valueType: 'number',
+        defaultValue: 1,
+        description: 'Horizontal scale relative to the local transform origin.',
+    },
+    scaleY: {
+        valueType: 'number',
+        defaultValue: 1,
+        description: 'Vertical scale relative to the local transform origin.',
+    },
+    skewX: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Horizontal skew in degrees.',
+    },
+    skewY: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Vertical skew in degrees.',
+    },
+    sortableChildren: {
+        valueType: 'boolean',
+        defaultValue: false,
+        description: 'Whether descendants are ordered by zIndex before rendering.',
+    },
+    tint: {
+        valueType: 'number',
+        format: 'color',
+        minimum: 0,
+        maximum: 0xffffff,
+        integer: true,
+        defaultValue: 0xffffff,
+        description: 'Multiplicative RGB tint encoded as a 24-bit integer.',
+    },
+    touchEnabled: {
+        valueType: 'boolean',
+        defaultValue: false,
+        description: 'Whether this node can be the target of pointer events.',
+    },
+    visible: {
+        valueType: 'boolean',
+        defaultValue: true,
+        description: 'Whether this node participates in rendering and hit testing.',
+    },
+    width: {
+        valueType: 'number',
+        minimum: 0,
+        description: 'Explicit width in pixels; omit it to use measured width.',
+    },
+    x: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Horizontal position in the parent coordinate space.',
+    },
+    y: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Vertical position in the parent coordinate space.',
+    },
+    zIndex: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Relative render order when the parent enables sortable children.',
+    },
+};
+/**
+ * Layout and container properties inherited by every Kurot UI component.
+ */
+export const UI_COMPONENT_PROPERTIES = {
+    bottom: anchorConstraint('Distance from the parent bottom edge.'),
+    horizontalCenter: anchorConstraint('Offset from the parent horizontal center.'),
+    includeInLayout: {
+        valueType: 'boolean',
+        defaultValue: true,
+        description: 'Whether the parent layout measures and positions this node.',
+    },
+    isRenderGroup: {
+        valueType: 'boolean',
+        defaultValue: false,
+        description: 'Whether this container owns an independent render instruction set.',
+    },
+    left: anchorConstraint('Distance from the parent left edge.'),
+    maxHeight: sizeConstraint('Maximum layout height.', 100000),
+    maxWidth: sizeConstraint('Maximum layout width.', 100000),
+    minHeight: sizeConstraint('Minimum layout height.', 0),
+    minWidth: sizeConstraint('Minimum layout width.', 0),
+    percentHeight: percentageConstraint('Height as a percentage of the parent height.'),
+    percentWidth: percentageConstraint('Width as a percentage of the parent width.'),
+    right: anchorConstraint('Distance from the parent right edge.'),
+    top: anchorConstraint('Distance from the parent top edge.'),
+    touchChildren: {
+        valueType: 'boolean',
+        defaultValue: true,
+        description: 'Whether descendants can be pointer-event targets.',
+    },
+    touchEnabled: {
+        valueType: 'boolean',
+        defaultValue: true,
+        description: 'Whether this UI component can be a pointer-event target.',
+    },
+    verticalCenter: anchorConstraint('Offset from the parent vertical center.'),
+};
+/**
+ * Authoring properties inherited by skinnable Kurot controls.
+ */
+export const COMPONENT_PROPERTIES = {
+    currentState: {
+        valueType: 'string',
+        defaultValue: '',
+        description: 'Explicit skin view state; an empty string uses the computed state.',
+    },
+    enabled: {
+        valueType: 'boolean',
+        defaultValue: true,
+        description: 'Whether the control accepts interaction and uses enabled states.',
+    },
+    hostComponentKey: {
+        valueType: 'string',
+        description: 'Theme lookup key; omit it to use the runtime class name.',
+    },
+    skinName: {
+        valueType: 'string',
+        format: 'skin',
+        description: 'Serializable skin identifier resolved by the runtime or adapter.',
+    },
+};
+function anchorConstraint(description) {
+    return {
+        valueType: ['number', 'string'],
+        description: `${description} Strings may use percentage syntax such as "50%".`,
+    };
+}
+function percentageConstraint(description) {
+    return {
+        valueType: 'number',
+        minimum: 0,
+        maximum: 100,
+        description,
+    };
+}
+function sizeConstraint(description, defaultValue) {
+    return {
+        valueType: 'number',
+        minimum: 0,
+        defaultValue,
+        description,
+    };
+}
+//# sourceMappingURL=foundation-properties.js.map

package/dist/kurot/catalog/properties/foundation-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-properties.js","sourceRoot":"","sources":["../../../../src/kurot/catalog/properties/foundation-properties.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAmD;IACxF,KAAK,EAAE;QACN,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,mDAAmD;KAChE;IACD,aAAa,EAAE;QACd,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,qDAAqD;KAClE;IACD,aAAa,EAAE;QACd,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,mDAAmD;KAChE;IACD,SAAS,EAAE;QACV,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE;YACX,aAAa;YACb,SAAS;YACT,iBAAiB;YACjB,UAAU;YACV,QAAQ;YACR,SAAS;YACT,QAAQ;YACR,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,aAAa;YACb,YAAY;YACZ,WAAW;YACX,KAAK;YACL,YAAY;YACZ,OAAO;YACP,YAAY;SACZ;QACD,YAAY,EAAE,aAAa;QAC3B,WAAW,EAAE,iDAAiD;KAC9D;IACD,aAAa,EAAE;QACd,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,8DAA8D;KAC3E;IACD,MAAM,EAAE;QACP,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,4DAA4D;KACzE;IACD,IAAI,EAAE;QACL,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,qEAAqE;KAClF;IACD,QAAQ,EAAE;QACT,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,gCAAgC;KAC7C;IACD,MAAM,EAAE;QACP,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,0DAA0D;KACvE;IACD,MAAM,EAAE;QACP,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,wDAAwD;KACrE;IACD,KAAK,EAAE;QACN,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,6BAA6B;KAC1C;IACD,KAAK,EAAE;QACN,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,2BAA2B;KACxC;IACD,gBAAgB,EAAE;QACjB,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,6DAA6D;KAC1E;IACD,IAAI,EAAE;QACL,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,sDAAsD;KACnE;IACD,YAAY,EAAE;QACb,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,wDAAwD;KACrE;IACD,OAAO,EAAE;QACR,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,8DAA8D;KAC3E;IACD,KAAK,EAAE;QACN,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,0DAA0D;KACvE;IACD,CAAC,EAAE;QACF,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,qDAAqD;KAClE;IACD,CAAC,EAAE;QACF,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,mDAAmD;KAChE;IACD,MAAM,EAAE;QACP,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,kEAAkE;KAC/E;CACD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmD;IACtF,MAAM,EAAE,gBAAgB,CAAC,uCAAuC,CAAC;IACjE,gBAAgB,EAAE,gBAAgB,CAAC,2CAA2C,CAAC;IAC/E,eAAe,EAAE;QAChB,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,6DAA6D;KAC1E;IACD,aAAa,EAAE;QACd,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,oEAAoE;KACjF;IACD,IAAI,EAAE,gBAAgB,CAAC,qCAAqC,CAAC;IAC7D,SAAS,EAAE,cAAc,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC3D,QAAQ,EAAE,cAAc,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzD,SAAS,EAAE,cAAc,CAAC,wBAAwB,EAAE,CAAC,CAAC;IACtD,QAAQ,EAAE,cAAc,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACpD,aAAa,EAAE,oBAAoB,CAAC,8CAA8C,CAAC;IACnF,YAAY,EAAE,oBAAoB,CAAC,4CAA4C,CAAC;IAChF,KAAK,EAAE,gBAAgB,CAAC,sCAAsC,CAAC;IAC/D,GAAG,EAAE,gBAAgB,CAAC,oCAAoC,CAAC;IAC3D,aAAa,EAAE;QACd,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,mDAAmD;KAChE;IACD,YAAY,EAAE;QACb,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,0DAA0D;KACvE;IACD,cAAc,EAAE,gBAAgB,CAAC,yCAAyC,CAAC;CAC3E,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmD;IACnF,YAAY,EAAE;QACb,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,oEAAoE;KACjF;IACD,OAAO,EAAE;QACR,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,kEAAkE;KAC/E;IACD,gBAAgB,EAAE;QACjB,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,0DAA0D;KACvE;IACD,QAAQ,EAAE;QACT,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,kEAAkE;KAC/E;CACD,CAAC;AAEF,SAAS,gBAAgB,CAAC,WAAmB;IAC5C,OAAO;QACN,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC/B,WAAW,EAAE,GAAG,WAAW,mDAAmD;KAC9E,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB;IAChD,OAAO;QACN,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,GAAG;QACZ,WAAW;KACX,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB,EAAE,YAAoB;IAChE,OAAO;QACN,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC;QACV,YAAY;QACZ,WAAW;KACX,CAAC;AACH,CAAC"}

package/dist/kurot/document/create.d.ts

@@ -0,0 +1,46 @@
+import type { UIDocument } from '../model/UIDocument.js';
+import type { UINode } from '../model/UINode.js';
+import type { UIPropertyValue } from '../model/UIPropertyValue.js';
+/**
+ * Input accepted by createUINode.
+ */
+export interface CreateUINodeOptions {
+    /**
+     * Stable identifier, unique within the eventual document.
+     */
+    readonly id: string;
+    /**
+     * Component type key resolved outside this package.
+     */
+    readonly type: string;
+    /**
+     * Initial explicit properties. The top-level record is copied.
+     */
+    readonly properties?: Readonly<Record<string, UIPropertyValue>>;
+    /**
+     * Initial ordered children. The array is copied.
+     */
+    readonly children?: readonly UINode[];
+}
+/**
+ * Input accepted by createUIDocument.
+ */
+export interface CreateUIDocumentOptions {
+    /**
+     * Stable document identifier assigned by the owning project.
+     */
+    readonly id: string;
+    /**
+     * Root component instance.
+     */
+    readonly root: UINode;
+}
+/**
+ * Creates a node with explicit empty property and child collections.
+ */
+export declare function createUINode(options: CreateUINodeOptions): UINode;
+/**
+ * Creates a document using the latest semantic format version.
+ */
+export declare function createUIDocument(options: CreateUIDocumentOptions): UIDocument;
+//# sourceMappingURL=create.d.ts.map

package/dist/kurot/document/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/kurot/document/create.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAEhE;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAUjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CAS7E"}

package/dist/kurot/document/create.js

@@ -0,0 +1,33 @@
+import { UI_DOCUMENT_FORMAT_VERSION } from '../version.js';
+import { UI_DOCUMENT_KIND } from '../model/UIDocument.js';
+/**
+ * Creates a node with explicit empty property and child collections.
+ */
+export function createUINode(options) {
+    assertNonEmpty(options.id, 'Node id');
+    assertNonEmpty(options.type, 'Node type');
+    return {
+        id: options.id,
+        type: options.type,
+        properties: { ...options.properties },
+        children: [...(options.children ?? [])],
+    };
+}
+/**
+ * Creates a document using the latest semantic format version.
+ */
+export function createUIDocument(options) {
+    assertNonEmpty(options.id, 'Document id');
+    return {
+        kind: UI_DOCUMENT_KIND,
+        formatVersion: UI_DOCUMENT_FORMAT_VERSION,
+        id: options.id,
+        root: options.root,
+    };
+}
+function assertNonEmpty(value, label) {
+    if (value.trim().length === 0) {
+        throw new Error(`${label} must not be empty.`);
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/kurot/document/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/kurot/document/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AA6C1D;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACxD,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACtC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAE1C,OAAO;QACN,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE;QACrC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;KACvC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAChE,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAE1C,OAAO;QACN,IAAI,EAAE,gBAAgB;QACtB,aAAa,EAAE,0BAA0B;QACzC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;KAClB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IACnD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IAChD,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,4 @@
+export { createUIDocument, createUINode } from './create.js';
+export type { CreateUIDocumentOptions, CreateUINodeOptions } from './create.js';
+export { findUINode, visitUINodes } from './query.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/kurot/document/index.js

@@ -0,0 +1,3 @@
+export { createUIDocument, createUINode } from './create.js';
+export { findUINode, visitUINodes } from './query.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/kurot/document/query.d.ts

@@ -0,0 +1,10 @@
+import type { UINode } from '../model/UINode.js';
+/**
+ * Visits a node tree in deterministic parent-before-children order.
+ */
+export declare function visitUINodes(root: UINode, visitor: (node: UINode) => void): void;
+/**
+ * Finds the first node with the requested identifier in pre-order.
+ */
+export declare function findUINode(root: UINode, id: string): UINode | undefined;
+//# sourceMappingURL=query.d.ts.map

package/dist/kurot/document/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/kurot/document/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAKhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQvE"}

package/dist/kurot/document/query.js

@@ -0,0 +1,23 @@
+/**
+ * Visits a node tree in deterministic parent-before-children order.
+ */
+export function visitUINodes(root, visitor) {
+    visitor(root);
+    for (const child of root.children) {
+        visitUINodes(child, visitor);
+    }
+}
+/**
+ * Finds the first node with the requested identifier in pre-order.
+ */
+export function findUINode(root, id) {
+    if (root.id === id)
+        return root;
+    for (const child of root.children) {
+        const match = findUINode(child, id);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+//# sourceMappingURL=query.js.map

package/dist/kurot/document/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/kurot/document/query.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAA+B;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,EAAU;IAClD,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { UINode } from './UINode.js';
+/**
+ * Discriminator written into every Kurot UI document.
+ */
+export declare const UI_DOCUMENT_KIND = "kurot-ui-document";
+/**
+ * Root serializable unit consumed by UI editing tools and adapters.
+ */
+export interface UIDocument {
+    /**
+     * Stable discriminator used to reject unrelated JSON documents.
+     */
+    readonly kind: typeof UI_DOCUMENT_KIND;
+    /**
+     * Semantic format version, independent of the npm package version.
+     */
+    readonly formatVersion: number;
+    /**
+     * Stable document identifier assigned by the owning project.
+     */
+    readonly id: string;
+    /**
+     * Root component instance of the document.
+     */
+    readonly root: UINode;
+}
+//# sourceMappingURL=UIDocument.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UIDocument.d.ts","sourceRoot":"","sources":["../../../src/kurot/model/UIDocument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB"}

package/dist/kurot/model/UIDocument.js

@@ -0,0 +1,5 @@
+/**
+ * Discriminator written into every Kurot UI document.
+ */
+export const UI_DOCUMENT_KIND = 'kurot-ui-document';
+//# sourceMappingURL=UIDocument.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UIDocument.js","sourceRoot":"","sources":["../../../src/kurot/model/UIDocument.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { UIPropertyValue } from './UIPropertyValue.js';
+/**
+ * A component instance in a semantic UI document.
+ */
+export interface UINode {
+    /**
+     * Stable identifier, unique within the containing document.
+     */
+    readonly id: string;
+    /**
+     * Component type key resolved by a renderer or format adapter.
+     */
+    readonly type: string;
+    /**
+     * Explicit component properties keyed by public property name.
+     */
+    readonly properties: Readonly<Record<string, UIPropertyValue>>;
+    /**
+     * Ordered visual children of this component instance.
+     */
+    readonly children: readonly UINode[];
+}
+//# sourceMappingURL=UINode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UINode.d.ts","sourceRoot":"","sources":["../../../src/kurot/model/UINode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,MAAM;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC"}

package/dist/kurot/model/UINode.js

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

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Scalar value accepted by a UI property.
+ */
+export type UIPropertyPrimitive = boolean | number | string;
+/**
+ * String-keyed structured value accepted by a UI property.
+ */
+export interface UIPropertyObject {
+    readonly [key: string]: UIPropertyValue;
+}
+/**
+ * Serializable value stored in a node property.
+ * Undefined, null, functions, and non-finite numbers are not valid values.
+ */
+export type UIPropertyValue = UIPropertyPrimitive | readonly UIPropertyValue[] | UIPropertyObject;
+//# sourceMappingURL=UIPropertyValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UIPropertyValue.d.ts","sourceRoot":"","sources":["../../../src/kurot/model/UIPropertyValue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACxB,mBAAmB,GACnB,SAAS,eAAe,EAAE,GAC1B,gBAAgB,CAAC"}

package/dist/kurot/model/UIPropertyValue.js

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

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

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

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

@@ -0,0 +1,5 @@
+export { UI_DOCUMENT_KIND } from './UIDocument.js';
+export type { UIDocument } from './UIDocument.js';
+export type { UINode } from './UINode.js';
+export type { UIPropertyObject, UIPropertyPrimitive, UIPropertyValue, } from './UIPropertyValue.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/kurot/model/index.js

@@ -0,0 +1,2 @@
+export { UI_DOCUMENT_KIND } from './UIDocument.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,130 @@
+/**
+ * Broad serializable value category accepted by a component property.
+ */
+export type UIPropertyValueType = 'array' | 'boolean' | 'number' | 'object' | 'string' | 'value';
+/**
+ * Semantic presentation used by editors for otherwise generic values.
+ */
+export type UIPropertyFormat = 'color' | 'layout' | 'rectangle' | 'resource' | 'skin';
+/**
+ * Structural child policy for a component type.
+ */
+export type UIChildrenPolicy = 'multiple' | 'none' | 'single';
+/**
+ * Semantic description of one public component property.
+ */
+export interface UIPropertyDefinition {
+    /**
+     * Accepted value category, or categories for a union-valued property.
+     */
+    readonly valueType: UIPropertyValueType | readonly UIPropertyValueType[];
+    /**
+     * Optional semantic presentation used by editors and Agent tools.
+     */
+    readonly format?: UIPropertyFormat;
+    /**
+     * Exact primitive values accepted by this property.
+     */
+    readonly enumValues?: readonly UIPropertyPrimitive[];
+    /**
+     * Inclusive lower bound for numeric values.
+     */
+    readonly minimum?: number;
+    /**
+     * Inclusive upper bound for numeric values.
+     */
+    readonly maximum?: number;
+    /**
+     * Whether numeric values must be integers.
+     */
+    readonly integer?: boolean;
+    /**
+     * Runtime value used when the property is omitted, when it is serializable.
+     */
+    readonly defaultValue?: UIPropertyPrimitive;
+    /**
+     * Whether every node of this component type must provide the property.
+     */
+    readonly required?: boolean;
+    /**
+     * Human-readable semantic guidance not expressible by the value category.
+     */
+    readonly description?: string;
+}
+/**
+ * Runtime-independent description of a component type available to documents.
+ */
+export interface UIComponentDefinition {
+    /**
+     * Exact key stored in UINode.type, such as kui.Label.
+     */
+    readonly type: string;
+    /**
+     * Base component type whose semantic properties and policies are inherited.
+     */
+    readonly extends?: string;
+    /**
+     * Whether the definition is reusable metadata rather than an instantiable node type.
+     */
+    readonly abstract?: boolean;
+    /**
+     * Human-readable name shown by editors and Agent tools.
+     */
+    readonly displayName?: string;
+    /**
+     * Semantic purpose and usage guidance for the component.
+     */
+    readonly description?: string;
+    /**
+     * Child constraint. Omit while the component's child behavior is unspecified.
+     */
+    readonly children?: UIChildrenPolicy;
+    /**
+     * Known public properties keyed by their exact document names.
+     */
+    readonly properties?: Readonly<Record<string, UIPropertyDefinition>>;
+    /**
+     * Whether properties missing from this incomplete definition remain valid.
+     * Defaults to false so completed definitions reject misspellings.
+     */
+    readonly allowUnknownProperties?: boolean;
+}
+/**
+ * Fully inherited component definition returned by registry resolution.
+ */
+export interface UIResolvedComponentDefinition {
+    /**
+     * Exact component type requested from the registry.
+     */
+    readonly type: string;
+    /**
+     * Ancestor types ordered from the root base to the direct base.
+     */
+    readonly baseTypes: readonly string[];
+    /**
+     * Whether this exact type is metadata-only and cannot appear in a document.
+     */
+    readonly abstract: boolean;
+    /**
+     * Human-readable name declared directly by this type.
+     */
+    readonly displayName?: string;
+    /**
+     * Semantic guidance declared directly by this type.
+     */
+    readonly description?: string;
+    /**
+     * Effective child policy inherited from the nearest defining ancestor.
+     */
+    readonly children?: UIChildrenPolicy;
+    /**
+     * Effective properties after applying base-to-derived overrides.
+     */
+    readonly properties: Readonly<Record<string, UIPropertyDefinition>>;
+    /**
+     * Effective unknown-property policy inherited from the nearest explicit value.
+     */
+    readonly allowUnknownProperties: boolean;
+}
+import type { UIPropertyPrimitive } from '../model/UIPropertyValue.js';
+//# sourceMappingURL=UIComponentDefinition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UIComponentDefinition.d.ts","sourceRoot":"","sources":["../../../src/kurot/schema/UIComponentDefinition.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC5B,OAAO,GACP,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACzB,OAAO,GACP,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,CAAC;IAEzE;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC7C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAEpE;;OAEG;IACH,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;CACzC;AACD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/kurot/schema/UIComponentDefinition.js

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

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

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