@kurot/ui-document 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kelvin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# @kurot/ui-document
+
+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.1.0).** The first document model, validation, query,
+> and deterministic JSON APIs are implemented. The schema is not stable yet.
+
+## Installation
+
+```bash
+pnpm add @kurot/ui-document
+```
+
+The package has no runtime dependency on `@kurot/core` or `@kurot/ui`. It
+models UI documents but does not instantiate or render runtime components.
+
+## Quick Start
+
+```ts
+import {
+  createUIDocument,
+  createUINode,
+  serializeUIDocument,
+  validateUIDocument,
+} from '@kurot/ui-document';
+
+const document = createUIDocument({
+  id: 'main-screen',
+  root: createUINode({
+    id: 'root',
+    type: 'kui.Group',
+    properties: { width: 1280, height: 720 },
+    children: [
+      createUINode({
+        id: 'title',
+        type: 'kui.Label',
+        properties: { text: 'Kurot' },
+      }),
+    ],
+  }),
+});
+
+const diagnostics = validateUIDocument(document);
+const source = serializeUIDocument(document);
+```
+
+`UIDocument` and `UINode` are runtime-independent semantic data. A component
+`type` is an external registry key; this package does not import or instantiate
+the corresponding `@kurot/ui` class.
+
+## Current capabilities
+
+- explicit `UIDocument`, `UINode`, and recursive `UIPropertyValue` types;
+- constructors that assign the current format discriminator and version;
+- deterministic pre-order traversal and node lookup;
+- 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;
+- runtime-independent component definitions and an isolated component registry;
+- abstract base definitions, single-parent inheritance, deterministic schema
+  resolution, and derived property overrides;
+- optional validation of registered component types, known property categories,
+  required properties, child policies, and abstract types.
+- union-valued properties, enum values, numeric ranges, integer constraints,
+  serializable defaults, and editor-facing semantic formats.
+
+Component definitions can remain intentionally incomplete while their runtime
+properties are reviewed:
+
+```ts
+import { UIComponentRegistry } from '@kurot/ui-document';
+
+const registry = new UIComponentRegistry();
+registry.register({
+  type: 'schema.UIComponent',
+  abstract: true,
+  allowUnknownProperties: true,
+});
+
+registry.register({
+  type: 'game.ProfileCard',
+  extends: 'schema.UIComponent',
+});
+
+const resolved = registry.resolve('game.ProfileCard');
+```
+
+Base definitions can be registered after their derived definitions. Resolution
+does not depend on registration order and reports missing bases or inheritance
+cycles explicitly. A complete `@kurot/ui` component catalog is not included yet.
+
+## Kurot UI foundation catalog
+
+The first audited catalog subset is available through an explicit registry
+factory:
+
+```ts
+import { createKurotUIFoundationRegistry } from '@kurot/ui-document';
+
+const registry = createKurotUIFoundationRegistry();
+```
+
+It defines the abstract semantic bases `kurot.DisplayObject`,
+`kui.UIComponent`, and `kui.Component`, plus the concrete `kui.Group`,
+`kui.Label`, `kui.Image`, `kui.Rect`, and `kui.Button` nodes. `Group` accepts
+ordered children; the other four 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.
+
+The foundation catalog declares the serializable authoring properties inherited
+from Kurot display objects and UI layout elements, then adds the audited direct
+properties of all five concrete components. Unknown properties are rejected.
+
+Runtime-owned values are deliberately excluded. For example, `Image.source`
+stores an asset key or URL rather than a `Texture`, and readonly objects such as
+`Image.bitmap` are not document properties. `Group.layout` and
+`Image.scale9Grid` currently accept semantic objects; their nested shapes will
+be tightened when the layout and structured-value catalogs are introduced.
+State declarations and bindings are also reserved for their own semantic
+layers rather than being accepted as untyped component properties.
+
+See [Architecture](./docs/architecture.md) for the current contracts and
+package boundaries.
+
+## Intended boundary
+
+The package owns the serializable UI document model and its deterministic
+operations. Planned layers include:
+
+- the remaining component catalog, nested structured-value constraints, states,
+  bindings, and resource-reference schemas;
+- commands, transactions, undo, and redo;
+- document migrations;
+- adapters for formats such as EXML.
+
+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.
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+```

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './kurot/model/index.js';
+export * from './kurot/document/index.js';
+export * from './kurot/validation/index.js';
+export * from './kurot/serialization/index.js';
+export * from './kurot/schema/index.js';
+export * from './kurot/catalog/index.js';
+export { UI_DOCUMENT_FORMAT_VERSION } from './kurot/version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './kurot/model/index.js';
+export * from './kurot/document/index.js';
+export * from './kurot/validation/index.js';
+export * from './kurot/serialization/index.js';
+export * from './kurot/schema/index.js';
+export * from './kurot/catalog/index.js';
+export { UI_DOCUMENT_FORMAT_VERSION } from './kurot/version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { createKurotUIFoundationRegistry, registerKurotUIFoundation, } from './kurot-ui-foundation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,yBAAyB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/kurot/catalog/index.js

@@ -0,0 +1,2 @@
+export { createKurotUIFoundationRegistry, registerKurotUIFoundation, } from './kurot-ui-foundation.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,yBAAyB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/kurot/catalog/kurot-ui-foundation.d.ts

@@ -0,0 +1,10 @@
+import { UIComponentRegistry } from '../schema/UIComponentRegistry.js';
+/**
+ * Registers the audited foundation subset of the Kurot UI component catalog.
+ */
+export declare function registerKurotUIFoundation(registry: UIComponentRegistry): void;
+/**
+ * Creates an isolated registry containing the audited Kurot UI foundation subset.
+ */
+export declare function createKurotUIFoundationRegistry(): UIComponentRegistry;
+//# sourceMappingURL=kurot-ui-foundation.d.ts.map

package/dist/kurot/catalog/kurot-ui-foundation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kurot-ui-foundation.d.ts","sourceRoot":"","sources":["../../../src/kurot/catalog/kurot-ui-foundation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAiFvE;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAS7E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,mBAAmB,CAIrE"}

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

@@ -0,0 +1,91 @@
+import { UIComponentRegistry } from '../schema/UIComponentRegistry.js';
+import { COMPONENT_PROPERTIES, DISPLAY_OBJECT_PROPERTIES, UI_COMPONENT_PROPERTIES, } from './properties/foundation-properties.js';
+import { BUTTON_PROPERTIES, GROUP_PROPERTIES, IMAGE_PROPERTIES, LABEL_PROPERTIES, RECT_PROPERTIES, } from './properties/basic-component-properties.js';
+const DEFINITIONS = [
+    {
+        type: 'kurot.DisplayObject',
+        abstract: true,
+        displayName: 'Display Object',
+        description: 'Shared semantic base for visual objects in Kurot UI documents.',
+        properties: DISPLAY_OBJECT_PROPERTIES,
+        allowUnknownProperties: false,
+    },
+    {
+        type: 'kui.UIComponent',
+        extends: 'kurot.DisplayObject',
+        abstract: true,
+        displayName: 'UI Component',
+        description: 'Shared semantic base for objects participating in Kurot UI layout.',
+        properties: UI_COMPONENT_PROPERTIES,
+    },
+    {
+        type: 'kui.Component',
+        extends: 'kui.UIComponent',
+        abstract: true,
+        displayName: 'Component',
+        description: 'Semantic base for skinnable Kurot UI controls.',
+        properties: COMPONENT_PROPERTIES,
+    },
+    {
+        type: 'kui.Group',
+        extends: 'kui.UIComponent',
+        displayName: 'Group',
+        description: 'Layout-aware container for ordered visual children.',
+        children: 'multiple',
+        properties: GROUP_PROPERTIES,
+    },
+    {
+        type: 'kui.Label',
+        extends: 'kui.Component',
+        displayName: 'Label',
+        description: 'Non-interactive text display component.',
+        children: 'none',
+        properties: LABEL_PROPERTIES,
+    },
+    {
+        type: 'kui.Image',
+        extends: 'kui.Component',
+        displayName: 'Image',
+        description: 'Bitmap display component backed by a texture or asset source.',
+        children: 'none',
+        properties: IMAGE_PROPERTIES,
+    },
+    {
+        type: 'kui.Rect',
+        extends: 'kui.Component',
+        displayName: 'Rect',
+        description: 'Rectangular vector shape with fill and stroke support.',
+        children: 'none',
+        properties: RECT_PROPERTIES,
+    },
+    {
+        type: 'kui.Button',
+        extends: 'kui.Component',
+        displayName: 'Button',
+        description: 'Interactive skinnable button with label, icon, and view states.',
+        children: 'none',
+        properties: BUTTON_PROPERTIES,
+    },
+];
+/**
+ * Registers the audited foundation subset of the Kurot UI component catalog.
+ */
+export function registerKurotUIFoundation(registry) {
+    for (const definition of DEFINITIONS) {
+        if (registry.has(definition.type)) {
+            throw new Error(`Component type "${definition.type}" is already registered.`);
+        }
+    }
+    for (const definition of DEFINITIONS) {
+        registry.register(definition);
+    }
+}
+/**
+ * Creates an isolated registry containing the audited Kurot UI foundation subset.
+ */
+export function createKurotUIFoundationRegistry() {
+    const registry = new UIComponentRegistry();
+    registerKurotUIFoundation(registry);
+    return registry;
+}
+//# sourceMappingURL=kurot-ui-foundation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kurot-ui-foundation.js","sourceRoot":"","sources":["../../../src/kurot/catalog/kurot-ui-foundation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,GACvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACN,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GACf,MAAM,4CAA4C,CAAC;AAEpD,MAAM,WAAW,GAAqC;IACrD;QACC,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE,yBAAyB;QACrC,sBAAsB,EAAE,KAAK;KAC7B;IACD;QACC,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,qBAAqB;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,cAAc;QAC3B,WAAW,EAAE,oEAAoE;QACjF,UAAU,EAAE,uBAAuB;KACnC;IACD;QACC,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,iBAAiB;QAC1B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,gDAAgD;QAC7D,UAAU,EAAE,oBAAoB;KAChC;IACD;QACC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,gBAAgB;KAC5B;IACD;QACC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,gBAAgB;KAC5B;IACD;QACC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,+DAA+D;QAC5E,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,gBAAgB;KAC5B;IACD;QACC,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,eAAe;KAC3B;IACD;QACC,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,iBAAiB;KAC7B;CACD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAA6B;IACtE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACtC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,CAAC,IAAI,0BAA0B,CAAC,CAAC;QAC/E,CAAC;IACF,CAAC;IACD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B;IAC9C,MAAM,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC3C,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/kurot/catalog/properties/basic-component-properties.d.ts

@@ -0,0 +1,22 @@
+import type { UIPropertyDefinition } from '../../schema/UIComponentDefinition.js';
+/**
+ * Authoring properties declared directly by Group.
+ */
+export declare const GROUP_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+/**
+ * Authoring properties declared directly by Label.
+ */
+export declare const LABEL_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+/**
+ * Authoring properties declared directly by Image.
+ */
+export declare const IMAGE_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+/**
+ * Authoring properties declared directly by Rect.
+ */
+export declare const RECT_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+/**
+ * Authoring properties declared directly by Button.
+ */
+export declare const BUTTON_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+//# sourceMappingURL=basic-component-properties.d.ts.map

package/dist/kurot/catalog/properties/basic-component-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-component-properties.d.ts","sourceRoot":"","sources":["../../../../src/kurot/catalog/properties/basic-component-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CA+B3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAsD3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAkB3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAQ1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAa5E,CAAC"}

package/dist/kurot/catalog/properties/basic-component-properties.js

@@ -0,0 +1,171 @@
+/**
+ * Authoring properties declared directly by Group.
+ */
+export const GROUP_PROPERTIES = {
+    currentState: {
+        valueType: 'string',
+        defaultValue: '',
+        description: 'Explicit group state used when applying state overrides.',
+    },
+    layout: {
+        valueType: 'object',
+        format: 'layout',
+        description: 'Serializable layout descriptor; omission uses BasicLayout at runtime.',
+    },
+    scrollEnabled: {
+        valueType: 'boolean',
+        defaultValue: false,
+        description: 'Whether the group clips and offsets content using its scroll position.',
+    },
+    scrollH: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Horizontal content scroll offset in pixels.',
+    },
+    scrollV: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Vertical content scroll offset in pixels.',
+    },
+    touchThrough: {
+        valueType: 'boolean',
+        defaultValue: false,
+        description: 'Whether empty group regions allow hit testing to continue behind the group.',
+    },
+};
+/**
+ * Authoring properties declared directly by Label.
+ */
+export const LABEL_PROPERTIES = {
+    bold: booleanProperty(false, 'Whether the text uses a bold font weight.'),
+    displayAsPassword: booleanProperty(false, 'Whether text is rendered as password glyphs.'),
+    fontFamily: {
+        valueType: 'string',
+        defaultValue: 'Arial',
+        description: 'CSS font-family name used to render the label.',
+    },
+    italic: booleanProperty(false, 'Whether the text uses an italic font style.'),
+    lineSpacing: {
+        valueType: 'number',
+        defaultValue: 0,
+        description: 'Additional spacing in pixels between text lines.',
+    },
+    maxChars: {
+        valueType: 'number',
+        minimum: 0,
+        integer: true,
+        defaultValue: 0,
+        description: 'Maximum character count; zero means no limit.',
+    },
+    multiline: booleanProperty(false, 'Whether the label permits multiple rendered lines.'),
+    size: {
+        valueType: 'number',
+        minimum: 0,
+        defaultValue: 30,
+        description: 'Font size in pixels.',
+    },
+    stroke: {
+        valueType: 'number',
+        minimum: 0,
+        defaultValue: 0,
+        description: 'Text outline thickness in pixels.',
+    },
+    strokeColor: colorProperty(0x000000, 'Text outline RGB color.'),
+    text: {
+        valueType: 'string',
+        defaultValue: '',
+        description: 'Plain text displayed by the label; newline characters create hard line breaks.',
+    },
+    textAlign: {
+        valueType: 'string',
+        enumValues: ['left', 'right', 'center', 'justify', 'contentJustify'],
+        defaultValue: 'left',
+        description: 'Horizontal alignment within the label bounds.',
+    },
+    textColor: colorProperty(0xffffff, 'Text fill RGB color.'),
+    verticalAlign: {
+        valueType: 'string',
+        enumValues: ['top', 'bottom', 'middle', 'justify', 'contentJustify'],
+        defaultValue: 'top',
+        description: 'Vertical alignment within the label bounds.',
+    },
+    wordWrap: booleanProperty(false, 'Whether text wraps at the available width.'),
+};
+/**
+ * Authoring properties declared directly by Image.
+ */
+export const IMAGE_PROPERTIES = {
+    fillMode: {
+        valueType: 'string',
+        enumValues: ['scale', 'repeat', 'clip'],
+        defaultValue: 'scale',
+        description: 'How the source bitmap fills the assigned image bounds.',
+    },
+    scale9Grid: {
+        valueType: 'object',
+        format: 'rectangle',
+        description: 'Nine-slice center rectangle with x, y, width, and height numbers.',
+    },
+    smoothing: booleanProperty(true, 'Whether scaled bitmap sampling uses interpolation.'),
+    source: {
+        valueType: 'string',
+        format: 'resource',
+        description: 'Serializable asset key or URL resolved by the UI asset adapter.',
+    },
+};
+/**
+ * Authoring properties declared directly by Rect.
+ */
+export const RECT_PROPERTIES = {
+    ellipseHeight: numberProperty(0, 0, 'Vertical corner ellipse diameter.'),
+    ellipseWidth: numberProperty(0, 0, 'Horizontal corner ellipse diameter.'),
+    fillAlpha: alphaProperty(1, 'Fill opacity.'),
+    fillColor: colorProperty(0x000000, 'Fill RGB color.'),
+    strokeAlpha: alphaProperty(1, 'Stroke opacity.'),
+    strokeColor: colorProperty(0x444444, 'Stroke RGB color.'),
+    strokeWeight: numberProperty(0, 0, 'Stroke thickness in pixels.'),
+};
+/**
+ * Authoring properties declared directly by Button.
+ */
+export const BUTTON_PROPERTIES = {
+    icon: {
+        valueType: 'string',
+        format: 'resource',
+        description: 'Serializable icon asset key or URL passed to the skin icon part.',
+    },
+    label: {
+        valueType: 'string',
+        defaultValue: '',
+        description: 'Text passed to the skin label part.',
+    },
+    selected: booleanProperty(false, 'Whether the button uses its selected view state.'),
+    toggle: booleanProperty(false, 'Whether activation automatically toggles selected.'),
+};
+function alphaProperty(defaultValue, description) {
+    return {
+        valueType: 'number',
+        minimum: 0,
+        maximum: 1,
+        defaultValue,
+        description,
+    };
+}
+function booleanProperty(defaultValue, description) {
+    return { valueType: 'boolean', defaultValue, description };
+}
+function colorProperty(defaultValue, description) {
+    return {
+        valueType: 'number',
+        format: 'color',
+        minimum: 0,
+        maximum: 0xffffff,
+        integer: true,
+        defaultValue,
+        description,
+    };
+}
+function numberProperty(defaultValue, minimum, description) {
+    return { valueType: 'number', minimum, defaultValue, description };
+}
+//# sourceMappingURL=basic-component-properties.js.map

package/dist/kurot/catalog/properties/basic-component-properties.js.map

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

package/dist/kurot/catalog/properties/foundation-properties.d.ts

@@ -0,0 +1,14 @@
+import type { UIPropertyDefinition } from '../../schema/UIComponentDefinition.js';
+/**
+ * Serializable authoring properties inherited by every Kurot display node.
+ */
+export declare const DISPLAY_OBJECT_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+/**
+ * Layout and container properties inherited by every Kurot UI component.
+ */
+export declare const UI_COMPONENT_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+/**
+ * Authoring properties inherited by skinnable Kurot controls.
+ */
+export declare const COMPONENT_PROPERTIES: Readonly<Record<string, UIPropertyDefinition>>;
+//# sourceMappingURL=foundation-properties.d.ts.map

package/dist/kurot/catalog/properties/foundation-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-properties.d.ts","sourceRoot":"","sources":["../../../../src/kurot/catalog/properties/foundation-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CA+HpF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAiClF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAoB/E,CAAC"}