@kurot/ui 1.1.7 → 1.1.8

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

@@ -245,6 +245,50 @@ class MyButtonSkin extends Skin {
 | `UIEvent.CLOSING`                   | `Panel`                         | Close button tapped (cancelable)                     |
 | `UIEvent.CREATION_COMPLETE`         | Any `Component`                 | First `createChildren` completed                     |
 
+## UI Benchmark
+
+The UI package includes three deterministic browser workloads: a 400-node
+static skin, transform/alpha animation across 240 UI nodes, and a 10,000-record
+virtual list. They measure frame/render time, draw calls, validation-phase
+activity, and ItemRenderer creation/reuse.
+
+Validation counters cover measured frames. Renderer creation/reuse and maximum
+live-renderer counts cover the complete scenario, including warmup, so the
+report can distinguish a stable pool from per-frame renderer churn.
+
+The first complete Chromium run used 60 warmup frames and 300 measured frames:
+
+| Workload | Setup | Frame P95 | Render P95 | Draw calls | UI lifecycle result |
+| -------- | ----: | --------: | ---------: | ---------: | ------------------- |
+| 400-node static image UI | 8.50 ms | 10.20 ms | 0.20 ms | 1 | No repeated validation after stabilization |
+| 240-node transform/alpha animation | 3.90 ms | 10.00 ms | 0.30 ms | 1 | No measure or display-list validation |
+| 10,000-record virtual list | 6.90 ms | 9.90 ms | 0.50 ms | 5 | 19 renderers created and at most 19 live |
+
+The transform workload recorded 72,000 `commitProperties` calls: 240 moving UI
+nodes × 300 measured frames. Multiple property changes on the same component
+were coalesced to one property commit per frame. Under the current UI contract,
+position changes participate in parent layout/content-bound invalidation, so
+this is expected bookkeeping rather than 72,000 measurements, layouts, texture
+uploads, or draw calls. The workload still remained one draw call and triggered
+zero `measure` and zero `updateDisplayList` calls during measurement.
+
+These results show that the core batching path reaches the UI layer, stable UI
+does not continue validating, and virtual layout bounds renderer population by
+the visible window. They are scoped results from one Chromium environment, not
+a cross-device performance guarantee or a comparison with another UI framework.
+
+```sh
+pnpm benchmark
+pnpm benchmark:smoke
+pnpm benchmark:compare
+```
+
+`benchmark` starts the visual page at `/benchmark/`. `benchmark:smoke` verifies
+all scenarios quickly, while `benchmark:compare` runs 60 warmup and 300 measured
+frames per scenario and writes local JSON/Markdown results under
+`examples/benchmark/results/`. This is a Kurot UI self-baseline, not a
+cross-framework ranking.
+
 ## Differences from Egret EUI
 
 |                | Egret EUI                   | @kurot/ui                          |

package/dist/kurot/binding/Binding.d.ts

@@ -1,10 +1,7 @@
 import { Watcher } from './Watcher.js';
 /**
- * Binding — static utility class for data binding.
- *
- * - `bindProperty(host, chain, target, prop)` — binds `host.chain` → `target.prop`
- * - `bindHandler(host, chain, handler, thisObject)` — calls `handler(value)` on change
- * - `bindProperties(host, templates, chainIndex, target, prop)` — template-string binding
+ * Creates reactive property-chain bindings.
+ * Binding hosts must dispatch property-change events for observed properties.
  */
 export declare class Binding {
     /**
@@ -12,7 +9,6 @@ export declare class Binding {
      *
      * ```ts
      * Binding.bindProperty(user, ['name'], label, 'text');
-     * // label.text === user.name; auto-updates when user dispatches PropertyChange
      * ```
      */
     static bindProperty(host: unknown, chain: string[], target: unknown, prop: string): Watcher | undefined;
@@ -20,18 +16,14 @@ export declare class Binding {
      * Binds a property chain on `host` to a handler function.
      *
      * ```ts
-     * Binding.bindHandler(user, ['name'], (v) => console.log(v), null);
+     * Binding.bindHandler(user, ['name'], value => console.log(value), undefined);
      * ```
      */
     static bindHandler(host: unknown, chain: string[], handler: (value: unknown) => void, thisObject: unknown): Watcher | undefined;
     /**
-     * Template-string binding used by EXML compiler.
+     * Binds a mixture of literal values and property chains to a string property.
      *
-     * `templates` is a mixed array of literal strings and `Watcher` instances.
-     * `chainIndex` marks which entries are dynamic (property chains).
-     *
-     * The result is the string concatenation of all template values, written
-     * to `target[prop]`.
+     * `chainIndex` identifies entries in `templates` that contain property chains.
      */
     static bindProperties(host: unknown, templates: unknown[], chainIndex: number[], target: unknown, prop: string): Watcher | undefined;
 }

package/dist/kurot/binding/Binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Binding.d.ts","sourceRoot":"","sources":["../../../src/kurot/binding/Binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;;;;GAMG;AACH,qBAAa,OAAO;IACnB;;;;;;;OAOG;WACW,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAY9G;;;;;;OAMG;WACW,WAAW,CACxB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACjC,UAAU,EAAE,OAAO,GACjB,OAAO,GAAG,SAAS;IAQtB;;;;;;;;OAQG;WACW,cAAc,CAC3B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,OAAO,EAAE,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,GACV,OAAO,GAAG,SAAS;CAgCtB"}
+{"version":3,"file":"Binding.d.ts","sourceRoot":"","sources":["../../../src/kurot/binding/Binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;GAGG;AACH,qBAAa,OAAO;IACnB;;;;;;OAMG;WACW,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAY9G;;;;;;OAMG;WACW,WAAW,CACxB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACjC,UAAU,EAAE,OAAO,GACjB,OAAO,GAAG,SAAS;IAQtB;;;;OAIG;WACW,cAAc,CAC3B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,OAAO,EAAE,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,GACV,OAAO,GAAG,SAAS;CAgCtB"}

package/dist/kurot/binding/Binding.js

@@ -1,10 +1,7 @@
 import { Watcher } from './Watcher.js';
 /**
- * Binding — static utility class for data binding.
- *
- * - `bindProperty(host, chain, target, prop)` — binds `host.chain` → `target.prop`
- * - `bindHandler(host, chain, handler, thisObject)` — calls `handler(value)` on change
- * - `bindProperties(host, templates, chainIndex, target, prop)` — template-string binding
+ * Creates reactive property-chain bindings.
+ * Binding hosts must dispatch property-change events for observed properties.
  */
 export class Binding {
     /**
@@ -12,11 +9,10 @@ export class Binding {
      *
      * ```ts
      * Binding.bindProperty(user, ['name'], label, 'text');
-     * // label.text === user.name; auto-updates when user dispatches PropertyChange
      * ```
      */
     static bindProperty(host, chain, target, prop) {
-        const watcher = Watcher.watch(host, chain, undefined, undefined);
+        const watcher = Watcher.watch(host, chain);
         if (watcher) {
             const assign = (value) => {
                 target[prop] = value;
@@ -30,7 +26,7 @@ export class Binding {
      * Binds a property chain on `host` to a handler function.
      *
      * ```ts
-     * Binding.bindHandler(user, ['name'], (v) => console.log(v), null);
+     * Binding.bindHandler(user, ['name'], value => console.log(value), undefined);
      * ```
      */
     static bindHandler(host, chain, handler, thisObject) {
@@ -41,13 +37,9 @@ export class Binding {
         return watcher;
     }
     /**
-     * Template-string binding used by EXML compiler.
+     * Binds a mixture of literal values and property chains to a string property.
      *
-     * `templates` is a mixed array of literal strings and `Watcher` instances.
-     * `chainIndex` marks which entries are dynamic (property chains).
-     *
-     * The result is the string concatenation of all template values, written
-     * to `target[prop]`.
+     * `chainIndex` identifies entries in `templates` that contain property chains.
      */
     static bindProperties(host, templates, chainIndex, target, prop) {
         if (templates.length === 1 && chainIndex.length === 1) {
@@ -61,7 +53,7 @@ export class Binding {
             const element = templates[index];
             let watcher;
             if (typeof element === 'string') {
-                watcher = Watcher.watch(host, element.split('.'), undefined, undefined);
+                watcher = Watcher.watch(host, element.split('.'));
             }
             else if (element instanceof Watcher) {
                 watcher = element;

package/dist/kurot/binding/Binding.js.map

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

package/dist/kurot/binding/Watcher.d.ts

@@ -1,48 +1,32 @@
 import type { IEventDispatcher } from '@kurot/core';
 /**
- * An object that can both dispatch {@link PropertyEvent.PROPERTY_CHANGE} and be
- * read by arbitrary property name (i.e. it is a record of named bindable values).
- *
- * This is the minimal contract a binding host must satisfy. In practice every
- * host is an {@link EventDispatcher} subclass (Skin, Component, Group, …) whose
- * own properties are mutated and then announced via
- * {@link PropertyEvent.dispatchPropertyEvent}. The index signature models that
- * dynamic access without forcing every host through `as unknown as Record<…>`.
+ * Event dispatcher whose properties can be observed by name.
  */
 export type Bindable = IEventDispatcher & Record<string, unknown>;
 /**
- * Watcher monitors a property (or property chain) on a host object.
- * When the property changes (via {@link PropertyEvent}), the registered
- * handler is invoked with the new value.
+ * Observes a property chain and reports changes to its leaf value.
  *
- * Create instances via the static {@link Watcher.watch} method — do not use the
- * constructor directly.
+ * Each object in the chain must dispatch
+ * {@link PropertyEvent.PROPERTY_CHANGE} when an observed property changes.
  */
 export declare class Watcher {
-    private _host?;
     private readonly _property;
+    private readonly _next?;
+    private _host?;
     private _handler?;
     private _thisObject;
-    private readonly _next?;
     private _isExecuting;
-    constructor(property: string, handler: ((value: unknown) => void) | undefined, thisObject: unknown, next: Watcher | undefined);
+    private _onPropertyChange;
+    constructor(property: string, handler?: (value: unknown) => void, thisObject?: unknown, next?: Watcher);
     /**
      * Creates and starts a Watcher for a property chain.
+     * Returns `undefined` when the chain is empty.
      *
      * ```ts
-     * // watches host.a.b.c
-     * Watcher.watch(host, ['a', 'b', 'c'], (value) => { ... }, this);
+     * Watcher.watch(host, ['profile', 'name'], value => updateName(value));
      * ```
-     *
-     * @param host   Root object hosting the chain.  Must dispatch
-     *               `PropertyEvent.PROPERTY_CHANGE` when its bindable
-     *               properties change (i.e. implement `IEventDispatcher`).
-     * @param chain  Property names forming the chain, e.g. `['a','b','c']`.
-     * @param handler Called with the new leaf value whenever the chain changes.
-     * @param thisObject  `this` context for the handler.
-     * @returns The head Watcher, or `undefined` if `chain` is empty.
      */
-    static watch(host: IEventDispatcher | undefined, chain: string[], handler: ((value: unknown) => void) | undefined, thisObject: unknown): Watcher | undefined;
+    static watch(host: IEventDispatcher | undefined, chain: string[], handler?: (value: unknown) => void, thisObject?: unknown): Watcher | undefined;
     getValue(): unknown;
     setHandler(handler: (value: unknown) => void, thisObject: unknown): void;
     /**
@@ -52,6 +36,5 @@ export declare class Watcher {
     reset(newHost: IEventDispatcher | undefined): void;
     unwatch(): void;
     private _getHostPropertyValue;
-    private _onPropertyChange;
 }
 //# sourceMappingURL=Watcher.d.ts.map

package/dist/kurot/binding/Watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../src/kurot/binding/Watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG3D;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,qBAAa,OAAO;IAGnB,OAAO,CAAC,KAAK,CAAC,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAU;IACjC,OAAO,CAAC,YAAY,CAAS;gBAK5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,EAC/C,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,OAAO,GAAG,SAAS;IAU1B;;;;;;;;;;;;;;;OAeG;WACW,KAAK,CAClB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,EAC/C,UAAU,EAAE,OAAO,GACjB,OAAO,GAAG,SAAS;IAUf,QAAQ,IAAI,OAAO;IAKnB,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAM/E;;;OAGG;IACI,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI;IAsBlD,OAAO,IAAI,IAAI;IAQtB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,iBAAiB,CAmBvB;CACF"}
+{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../src/kurot/binding/Watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG3D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,OAAO;IAGnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAU;IAEpC,OAAO,CAAC,KAAK,CAAC,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAC,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAAU;IAC1B,OAAO,CAAC,YAAY,CAAS;IAEhC,OAAO,CAAC,iBAAiB,CAcvB;gBAKD,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,UAAU,CAAC,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE,OAAO;IAUf;;;;;;;OAOG;WACW,KAAK,CAClB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,UAAU,CAAC,EAAE,OAAO,GAClB,OAAO,GAAG,SAAS;IAUf,QAAQ,IAAI,OAAO;IAKnB,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAM/E;;;OAGG;IACI,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI;IAgBlD,OAAO,IAAI,IAAI;IAQtB,OAAO,CAAC,qBAAqB;CAG7B"}

package/dist/kurot/binding/Watcher.js

@@ -1,20 +1,36 @@
 import { PropertyEvent } from '../events/PropertyEvent.js';
 /**
- * Watcher monitors a property (or property chain) on a host object.
- * When the property changes (via {@link PropertyEvent}), the registered
- * handler is invoked with the new value.
+ * Observes a property chain and reports changes to its leaf value.
  *
- * Create instances via the static {@link Watcher.watch} method — do not use the
- * constructor directly.
+ * Each object in the chain must dispatch
+ * {@link PropertyEvent.PROPERTY_CHANGE} when an observed property changes.
  */
 export class Watcher {
     // ── Instance fields ───────────────────────────────────────────────────
-    _host;
     _property;
+    _next;
+    _host;
     _handler;
     _thisObject;
-    _next;
     _isExecuting = false;
+    _onPropertyChange = (event) => {
+        if (!(event instanceof PropertyEvent))
+            return;
+        if (event.property !== this._property || this._isExecuting)
+            return;
+        try {
+            this._isExecuting = true;
+            if (this._next) {
+                this._next.reset(this._getHostPropertyValue());
+            }
+            if (this._handler) {
+                this._handler.call(this._thisObject, this.getValue());
+            }
+        }
+        finally {
+            this._isExecuting = false;
+        }
+    };
     // ── Constructor ───────────────────────────────────────────────────────
     constructor(property, handler, thisObject, next) {
         this._property = property;
@@ -25,19 +41,11 @@ export class Watcher {
     // ── Public methods ────────────────────────────────────────────────────
     /**
      * Creates and starts a Watcher for a property chain.
+     * Returns `undefined` when the chain is empty.
      *
      * ```ts
-     * // watches host.a.b.c
-     * Watcher.watch(host, ['a', 'b', 'c'], (value) => { ... }, this);
+     * Watcher.watch(host, ['profile', 'name'], value => updateName(value));
      * ```
-     *
-     * @param host   Root object hosting the chain.  Must dispatch
-     *               `PropertyEvent.PROPERTY_CHANGE` when its bindable
-     *               properties change (i.e. implement `IEventDispatcher`).
-     * @param chain  Property names forming the chain, e.g. `['a','b','c']`.
-     * @param handler Called with the new leaf value whenever the chain changes.
-     * @param thisObject  `this` context for the handler.
-     * @returns The head Watcher, or `undefined` if `chain` is empty.
      */
     static watch(host, chain, handler, thisObject) {
         if (chain.length === 0)
@@ -68,12 +76,6 @@ export class Watcher {
         if (this._host) {
             this._host.removeEventListener(PropertyEvent.PROPERTY_CHANGE, this._onPropertyChange);
         }
-        // The cast is unavoidable: `IEventDispatcher` (core) is not generic over
-        // a property map, so TS cannot know the host also exposes bindable own
-        // properties by name. `Bindable` only adds an index signature on top of
-        // `IEventDispatcher` — it models what every real host (Skin, Component,
-        // Group) already does at runtime. This is the single place the engine
-        // bridges the event-dispatcher contract and dynamic property access.
         this._host = newHost;
         if (this._host) {
             this._host.addEventListener(PropertyEvent.PROPERTY_CHANGE, this._onPropertyChange);
@@ -92,28 +94,5 @@ export class Watcher {
     _getHostPropertyValue() {
         return this._host ? this._host[this._property] : undefined;
     }
-    _onPropertyChange = (e) => {
-        // `e` arrives as `Event` because the listener is registered through the
-        // `IEventDispatcher` interface, whose signature is not generic over an
-        // EventMap (core 1.0 limitation). The dispatcher always uses
-        // `PropertyEvent.dispatchPropertyEvent`, which constructs a
-        // `PropertyEvent`, so the runtime type is guaranteed.
-        if (!(e instanceof PropertyEvent))
-            return;
-        if (e.property !== this._property || this._isExecuting)
-            return;
-        try {
-            this._isExecuting = true;
-            if (this._next) {
-                this._next.reset(this._getHostPropertyValue());
-            }
-            if (this._handler) {
-                this._handler.call(this._thisObject, this.getValue());
-            }
-        }
-        finally {
-            this._isExecuting = false;
-        }
-    };
 }
 //# sourceMappingURL=Watcher.js.map

package/dist/kurot/binding/Watcher.js.map

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

package/dist/kurot/components/Skin.d.ts

@@ -49,6 +49,12 @@ export declare class Skin extends EventDispatcher<SkinEvents> {
      * Get a skin part by name. Used by Component to bind parts.
      */
     getPart(name: string): unknown;
+    /**
+     * Set a skin part by name. Write-side counterpart to {@link getPart},
+     * used by programmatic materializers to install parts whose names come
+     * from authored data and therefore cannot be declared as class fields.
+     */
+    setPart(name: string, value: DisplayObject): void;
     /**
      * Unwatch every binding created from this skin.
      * Called by the host component when the skin is detached or replaced

package/dist/kurot/components/Skin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Skin.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Skin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAS,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC3C,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,IAAK,SAAQ,eAAe,CAAC,UAAU,CAAC;IAG7C,SAAS,EAAE,MAAM,EAAE,CAAM;IACzB,KAAK,EAAE,MAAM,CAAO;IACpB,MAAM,EAAE,MAAM,CAAO;IACrB,QAAQ,EAAE,MAAM,CAAK;IACrB,QAAQ,EAAE,MAAM,CAAU;IAC1B,SAAS,EAAE,MAAM,CAAK;IACtB,SAAS,EAAE,MAAM,CAAU;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAM;IAE5B;;;;OAIG;IACI,SAAS,EAAE,OAAO,EAAE,CAAM;IAEjC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAY;IACnC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,iBAAiB,CAAS;IAIlC,IAAW,eAAe,IAAI,aAAa,EAAE,CAE5C;IAED,IAAW,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,EAEhD;IAED,IAAW,aAAa,IAAI,SAAS,GAAG,SAAS,CAEhD;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAuBpD;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,YAAY,CAAC,KAAK,EAAE,MAAM,EAOpC;IAID;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;OAIG;IACI,UAAU,IAAI,IAAI;IASlB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAM3C,OAAO,CAAC,mBAAmB,CAEzB;IAEF,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,YAAY;CAOpB"}
+{"version":3,"file":"Skin.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Skin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAS,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC3C,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,IAAK,SAAQ,eAAe,CAAC,UAAU,CAAC;IAG7C,SAAS,EAAE,MAAM,EAAE,CAAM;IACzB,KAAK,EAAE,MAAM,CAAO;IACpB,MAAM,EAAE,MAAM,CAAO;IACrB,QAAQ,EAAE,MAAM,CAAK;IACrB,QAAQ,EAAE,MAAM,CAAU;IAC1B,SAAS,EAAE,MAAM,CAAK;IACtB,SAAS,EAAE,MAAM,CAAU;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAM;IAE5B;;;;OAIG;IACI,SAAS,EAAE,OAAO,EAAE,CAAM;IAEjC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAY;IACnC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,iBAAiB,CAAS;IAIlC,IAAW,eAAe,IAAI,aAAa,EAAE,CAE5C;IAED,IAAW,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,EAEhD;IAED,IAAW,aAAa,IAAI,SAAS,GAAG,SAAS,CAEhD;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAuBpD;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,YAAY,CAAC,KAAK,EAAE,MAAM,EAOpC;IAID;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;OAIG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAIxD;;;;OAIG;IACI,UAAU,IAAI,IAAI;IASlB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAM3C,OAAO,CAAC,mBAAmB,CAEzB;IAEF,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,YAAY;CAOpB"}

package/dist/kurot/components/Skin.js

@@ -82,6 +82,14 @@ export class Skin extends EventDispatcher {
     getPart(name) {
         return this[name];
     }
+    /**
+     * Set a skin part by name. Write-side counterpart to {@link getPart},
+     * used by programmatic materializers to install parts whose names come
+     * from authored data and therefore cannot be declared as class fields.
+     */
+    setPart(name, value) {
+        this[name] = value;
+    }
     /**
      * Unwatch every binding created from this skin.
      * Called by the host component when the skin is detached or replaced

package/dist/kurot/components/Skin.js.map

@@ -1 +1 @@
-{"version":3,"file":"Skin.js","sourceRoot":"","sources":["../../../src/kurot/components/Skin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAiB,KAAK,EAAiB,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAY3D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,IAAK,SAAQ,eAA2B;IACpD,yEAAyE;IAElE,SAAS,GAAa,EAAE,CAAC;IACzB,KAAK,GAAW,GAAG,CAAC;IACpB,MAAM,GAAW,GAAG,CAAC;IACrB,QAAQ,GAAW,CAAC,CAAC;IACrB,QAAQ,GAAW,MAAM,CAAC;IAC1B,SAAS,GAAW,CAAC,CAAC;IACtB,SAAS,GAAW,MAAM,CAAC;IAC3B,MAAM,GAAY,EAAE,CAAC;IAE5B;;;;OAIG;IACI,SAAS,GAAc,EAAE,CAAC;IAEzB,gBAAgB,GAAoB,EAAE,CAAC;IACvC,cAAc,CAAa;IAC3B,aAAa,GAAG,EAAE,CAAC;IACnB,iBAAiB,GAAG,KAAK,CAAC;IAElC,yEAAyE;IAEzE,IAAW,eAAe;QACzB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC9B,CAAC;IAED,IAAW,eAAe,CAAC,KAAsB;QAChD,IAAI,CAAC,gBAAgB,GAAG,KAAK,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,IAAW,aAAa;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC5B,CAAC;IAED,IAAW,aAAa,CAAC,KAA4B;QACpD,IAAI,IAAI,CAAC,cAAc,KAAK,KAAK;YAAE,OAAO;QAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC;QACpC,IAAI,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC5E,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBAC/C,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;YAChC,CAAC;QACF,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAE5B,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC5D,CAAC;QACF,CAAC;QAED,aAAa,CAAC,qBAAqB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,IAAW,YAAY;QACtB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED,IAAW,YAAY,CAAC,KAAa;QACpC,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK;YAAE,OAAO;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACnD,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC;IAED,yEAAyE;IAEzE;;OAEG;IACI,OAAO,CAAC,IAAY;QAC1B,OAAQ,IAAgC,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACI,UAAU;QAChB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtC,OAAO,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,CAAC;IACF,CAAC;IAEM,QAAQ,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,yEAAyE;IAEjE,mBAAmB,GAAG,GAAS,EAAE;QACxC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEM,iBAAiB;QACxB,IAAI,IAAI,CAAC,iBAAiB;YAAE,OAAO;QACnC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAEO,WAAW,CAAC,SAAiB,EAAE,OAAe;QACrD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACd,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC3C,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,cAAe,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;QACF,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAC3D,IAAI,QAAQ,EAAE,CAAC;YACd,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC3C,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,cAAe,EAAE,IAAI,CAAC,CAAC;YAC5C,CAAC;QACF,CAAC;IACF,CAAC;IAEO,YAAY,CAAC,SAAiB,EAAE,IAAe;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACxC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"Skin.js","sourceRoot":"","sources":["../../../src/kurot/components/Skin.ts"],"names":[],"mappings":"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"}

package/dist/kurot/core/DefaultAssetAdapter.d.ts

@@ -1,8 +1,7 @@
 import { Texture } from '@kurot/core';
 import type { IAssetAdapter } from './IAssetAdapter.js';
 /**
- * Default asset adapter that loads images via ImageLoader and
- * resolves them to Texture instances.
+ * Loads image assets as textures with {@link ImageLoader}.
  */
 export declare class DefaultAssetAdapter implements IAssetAdapter {
     getAsset(source: string, callback: (content: Texture | undefined, source: string) => void): void;

package/dist/kurot/core/DefaultAssetAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultAssetAdapter.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/DefaultAssetAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAGjD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAavG"}
+{"version":3,"file":"DefaultAssetAdapter.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/DefaultAssetAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAGjD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAavG"}

package/dist/kurot/core/DefaultAssetAdapter.js

@@ -1,7 +1,6 @@
 import { Texture, ImageLoader, Event } from '@kurot/core';
 /**
- * Default asset adapter that loads images via ImageLoader and
- * resolves them to Texture instances.
+ * Loads image assets as textures with {@link ImageLoader}.
  */
 export class DefaultAssetAdapter {
     // ── Public methods ────────────────────────────────────────────────────

package/dist/kurot/core/DefaultAssetAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultAssetAdapter.js","sourceRoot":"","sources":["../../../src/kurot/core/DefaultAssetAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAG1D;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC/B,yEAAyE;IAElE,QAAQ,CAAC,MAAc,EAAE,QAAgE;QAC/F,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAS,EAAE;YAClD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC5B,OAAO;YACR,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;CACD"}
+{"version":3,"file":"DefaultAssetAdapter.js","sourceRoot":"","sources":["../../../src/kurot/core/DefaultAssetAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAG1D;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC/B,yEAAyE;IAElE,QAAQ,CAAC,MAAc,EAAE,QAAgE;QAC/F,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAS,EAAE;YAClD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC5B,OAAO;YACR,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;CACD"}

package/dist/kurot/core/DefaultThemeAdapter.d.ts

@@ -1,6 +1,6 @@
 import type { IThemeAdapter } from './IThemeAdapter.js';
 /**
- * Default theme adapter that loads theme configuration files via fetch().
+ * Loads theme configuration files with `fetch`.
  */
 export declare class DefaultThemeAdapter implements IThemeAdapter {
     getTheme(url: string, onSuccess: (data: unknown) => void, onError: (err: unknown) => void): void;

package/dist/kurot/core/DefaultThemeAdapter.js

@@ -1,5 +1,5 @@
 /**
- * Default theme adapter that loads theme configuration files via fetch().
+ * Loads theme configuration files with `fetch`.
  */
 export class DefaultThemeAdapter {
     // ── Public methods ────────────────────────────────────────────────────

package/dist/kurot/core/IAssetAdapter.d.ts

@@ -1,14 +1,11 @@
 import type { Texture } from '@kurot/core';
 /**
- * Adapter interface for resolving asset sources (e.g. image URLs) to Texture instances.
- * Implement this interface and pass it to `setAssetAdapter()` to customize asset loading.
+ * Resolves asset identifiers to textures.
  */
 export interface IAssetAdapter {
     /**
-     * Resolve an asset source string to a content value (typically a Texture).
-     * @param source  The asset identifier (URL, resource key, etc.)
-     * @param callback  Called with the resolved content and original source when done.
-     *                  `content` is `undefined` when the asset could not be loaded.
+     * Resolves an asset and reports `undefined` when it cannot be loaded.
+     * The callback receives the original source so callers can correlate requests.
      */
     getAsset(source: string, callback: (content: Texture | undefined, source: string) => void): void;
 }

package/dist/kurot/core/IAssetAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IAssetAdapter.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IAssetAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CACjG"}
+{"version":3,"file":"IAssetAdapter.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IAssetAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CACjG"}

package/dist/kurot/core/IDisplayText.d.ts

@@ -1,7 +1,5 @@
 /**
- * Interface for components that display a simple text string.
- * Implemented by Label, EditableText, and by composite components that
- * expose a `text` property (Button, TextInput, ComboBox).
+ * UI component that exposes displayed text.
  */
 export interface IDisplayText {
     /**

package/dist/kurot/core/IDisplayText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IDisplayText.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IDisplayText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"IDisplayText.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IDisplayText.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACb"}

package/dist/kurot/core/IItemRenderer.d.ts

@@ -1,6 +1,6 @@
 import type { IUIComponent } from './IUIComponent.js';
 /**
- * Interface for list item renderers.
+ * UI component that renders one item from a data provider.
  */
 export interface IItemRenderer extends IUIComponent {
     /**

package/dist/kurot/core/IThemeAdapter.d.ts

@@ -1,13 +1,9 @@
 /**
- * Adapter interface for loading theme configuration files.
- * Implement this and pass it to `Theme` constructor to customize how .thm.js files are fetched.
+ * Loads theme configuration data for {@link Theme}.
  */
 export interface IThemeAdapter {
     /**
-     * Fetch and return the theme config data.
-     * @param url       Path to the theme file (e.g. "resource/default.thm.js")
-     * @param onSuccess Called with the parsed theme data on success.
-     * @param onError   Called on failure.
+     * Loads a theme URL and reports either its data or the loading error.
      */
     getTheme(url: string, onSuccess: (data: unknown) => void, onError: (err: unknown) => void): void;
 }

package/dist/kurot/core/IThemeAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IThemeAdapter.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IThemeAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACjG"}
+{"version":3,"file":"IThemeAdapter.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IThemeAdapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACjG"}

package/dist/kurot/core/IUIComponent.d.ts

@@ -1,16 +1,14 @@
 import type { IEventDispatcher, Rectangle } from '@kurot/core';
 /**
- * Interface implemented by all UI components.
- * Defines the layout contract: constraint properties, invalidation cycle,
- * and bounds query methods used by layout classes.
+ * Layout, measurement, and validation contract implemented by UI components.
  */
 export interface IUIComponent extends IEventDispatcher {
     /**
-     * Whether this component participates in parent layout. Default true.
+     * Whether this component participates in its parent's layout.
      */
     includeInLayout: boolean;
     /**
-     * Distance from the left edge of the parent container
+     * Distance from the left edge of the parent container.
      */
     left: number | string;
     /**

package/dist/kurot/core/IUIComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IUIComponent.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IUIComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAGzB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAGhC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,oBAAoB,IAAI,IAAI,CAAC;IAC7B,kBAAkB,IAAI,IAAI,CAAC;IAC3B,cAAc,IAAI,IAAI,CAAC;IACvB,YAAY,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,qBAAqB,IAAI,IAAI,CAAC;IAC9B,mBAAmB,IAAI,IAAI,CAAC;IAC5B,WAAW,IAAI,IAAI,CAAC;IAGpB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrE,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzC,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;CAC5C"}
+{"version":3,"file":"IUIComponent.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IUIComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAGzB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAGhC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,oBAAoB,IAAI,IAAI,CAAC;IAC7B,kBAAkB,IAAI,IAAI,CAAC;IAC3B,cAAc,IAAI,IAAI,CAAC;IACvB,YAAY,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,qBAAqB,IAAI,IAAI,CAAC;IAC9B,mBAAmB,IAAI,IAAI,CAAC;IAC5B,WAAW,IAAI,IAAI,CAAC;IAGpB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrE,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzC,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;CAC5C"}

package/dist/kurot/core/IViewport.d.ts

@@ -1,6 +1,6 @@
 import type { IUIComponent } from './IUIComponent.js';
 /**
- * Interface for scrollable container components.
+ * Scrollable UI component with measurable content bounds.
  */
 export interface IViewport extends IUIComponent {
     readonly contentWidth: number;