@kurot/ui 3.6.0 → 3.6.2

package/CHANGELOG.md

@@ -4,9 +4,64 @@ All notable changes to `@kurot/ui` are documented here.
 
 ---
 
+## [3.6.2] — 2026-10-18
+
+Prepared locally; not published. Documentation-only patch over 3.6.1.
+
+### Documentation
+
+- Add standard game UI authoring and project-directory conventions, plus a
+  complete ScoreHUD TS/Skin pair with lifecycle and controller cleanup. These
+  guides ship under docs/ in this version; published 3.6.1 lacks them.
+- Record published package verification and correct the architecture baseline.
+- Document CLI 3.6.1's skinParts declaration fix and full declaration checks.
+
+### Compatibility
+
+- Runtime implementations, types, exports and KUI/resource formats are unchanged.
+  Core peer/dev requirements remain ^2.5.2 with registry 2.5.3 in the existing lock.
+- ui-runtime's UI ^3.4.0 already accepts 3.6.2. No dependent SDK release,
+  dependency-range update or application migration is required. Installing this
+  patch for bundled guides is optional after publication.
+
+### Verification
+
+- Build and all 371 unit tests pass with the unchanged registry Core 2.5.3 lock.
+- API coverage/version checks pass with zero missing declarations; 19 extracted
+  Core/Game/UI examples compile against built and packed SDK declarations.
+- The packed UI 3.6.2 guides and CLI 3.6.1 template compile the exact ScoreHUD
+  recipe against published Core 2.5.5 in development/release modes, with strict
+  TypeScript and skipLibCheck=false, without engine source. Browser acceptance
+  remains a host-game check. No Core/UI implementation or dependency lock changes.
+
+## [3.6.1] — 2026-10-18
+
+Published; verified on npm on 2026-10-18, including latest, tarball integrity
+and bundled API references matching the tested commit. Documentation-only patch
+over 3.6.0.
+
+### Documentation
+
+- Expand layout, skin, text, image, button, collection, renderer and scroller
+  JSDoc with defaults, units, errors and cleanup responsibilities. Document
+  manual binding teardown and the multiple-Watcher bindProperties cleanup case.
+  Preserve runtime code, signatures, exports and dependency locks.
+- Add generated public API references, capability/symbol/member indexes,
+  explicit coverage reports and strict-compiled JSDoc examples. Fill in
+  theme JSON loading, skin ownership and detachable binding examples without changing
+  executable code, public signatures or SDK dependencies.
+
+### Compatibility
+
+- The Core peer/dev range remains ^2.5.2, with the existing registry Core 2.5.3
+  development installation/lock. This patch does not require Core 2.5.5.
+- ui-runtime's existing UI ^3.4.0 peer accepts 3.6.1; it needs no release or
+  raised minimum. Adoption in SDK development locks or application/example locks
+  is optional after publication; no KUI, skin or resource migration is required.
+
 ## [3.6.0] — 2026-10-11
 
-Prepared for publication; not yet published. Requires published Core ^2.5.2.
+Published; verified on npm on 2026-10-11. Requires published Core ^2.5.2.
 See [Label outline layout](docs/label-text-layout.md#outline-safe-layout-in-360).
 
 ### Fixed
@@ -35,10 +90,11 @@ the 2.5.2 minimum is tested separately. Core itself needs no new release.
 ui-runtime 0.10.0 already accepts UI 3.6.0 through ^3.4.0; its host must also
 satisfy the new UI Core peer. CLI and ui-document need no changes or releases.
 
-After publication, applications adopt UI 3.6.0 and rebuild explicitly. Editor's
-exact UI 3.5.0 pin must change; compatible example/template ranges can update
-their installations and locks without changing their ranges. Existing application
-and SDK development locks are unchanged by this release preparation.
+Applications adopt UI 3.6.0 and rebuild explicitly. Editor 0.28.3 adopts an exact
+registry dependency with a matching Bun lock and ordinary local App build. The
+selected Tentax and MilfMaster templates adopt ^3.6.0 with matching pnpm locks
+and rebuilt outputs. Other applications, the game example and SDK development
+locks remain unchanged.
 
 ### Verification
 
@@ -51,7 +107,9 @@ The 3.6.0 tarball contains all 344 matching compiled/declaration/map files and
 public documentation, excluding tests, node_modules and internal drafts;
 frozen registry installation and `git diff --check` pass. The MilfMaster trial
 harness verifies the actual compiled Drama skin and completed render frames
-without replacing its registry dependencies.
+without replacing its registry dependencies. Registry latest, package download
+and SHA-512 integrity are verified; all 344 published generated files match the
+tested build.
 
 ## [3.5.0] — 2026-10-10
 

package/README.md

@@ -1,20 +1,39 @@
 # @kurot/ui
 
-**3.6.0 is prepared for publication; it is not yet published.** Dynamic Label
+**3.6.0 is published, verified on npm on 2026-10-11.** Dynamic Label
 outlines now fit inside their layout bounds, including Scroller viewports,
 automatic dimensions, wrapping and text fitting. The release requires Core
 ^2.5.2 and develops against registry Core 2.5.3 without local overrides.
-The latest verified published UI release is 3.5.0 (2026-10-10).
+Registry latest, package download and integrity are verified; all 344 compiled,
+declaration and map files match the tested build.
 See [Label layout](docs/label-text-layout.md) for behavior and adoption.
 
 UI component framework for [@kurot/core](https://github.com/kurot-engine/kurot/tree/main/packages/core). Migrated from Egret EUI, rewritten in modern TypeScript with clean class inheritance — no namespace hacks, no prototype manipulation.
 
-> **Package version: 3.6.0 (prepared, unpublished).** Requires `@kurot/core@^2.5.2`. Targets ES2022 + evergreen browsers, same as core.
+> **Package version: 3.6.2 (prepared; not published).** Documentation-only patch over 3.6.1. Requires `@kurot/core@^2.5.2`. Targets ES2022 + evergreen browsers, same as core.
+
+## API reference in 3.6.1
+
+Start with [API topics](docs/api/topics.md) or the [symbol index](docs/api/index.md),
+then open only the relevant widget/member pages. Public and protected extension
+contracts are labeled separately; [coverage](docs/api/coverage.md) records
+remaining behavioral-comment gaps. These generated docs and strict-compiled
+examples are included in published UI 3.6.1; the 3.6.0 artifact remains unchanged.
+Runtime code, signatures and exports are unchanged. The Core
+peer/dev range remains ^2.5.2; ui-runtime's UI ^3.4.0 peer already accepts 3.6.2.
+No dependent release, raised minimum or application migration is required.
+
+For building game UI, start with [standard authoring](docs/ui-authoring.md) and
+the [complete ScoreHUD pair](docs/recipes/score-hud.md). They define project
+directories, editable XML versus component/controller ownership, typed parts
+and cleanup. These guides are bundled in prepared UI 3.6.2; published 3.6.1
+contains API references but lacks these additions. CLI 3.6.1 fixes generated
+host declarations for `tsc --noEmit --skipLibCheck false`; the UI runtime is unchanged.
 
 Outlined Label sizes and line breaks can change, including without `textFit`;
 Scroller viewports need no extra configuration. Keep explicit top alignment for
 progressively typed dialogue. No new KUI field, Core release or unrelated SDK
-bump is required. After publication, applications must adopt UI 3.6.0 and rebuild
+bump is required. Applications must adopt UI 3.6.0 and rebuild
 to receive the correction.
 
 For the full list of changes in this release, see [CHANGELOG.md](./CHANGELOG.md).
@@ -133,19 +152,23 @@ metrics even if the family name is unchanged.
 
 See the [text layout and fitting contract](docs/label-text-layout.md). Fitting
 metadata was introduced in document 0.9.0 and remains supported in 0.13.0.
-Current CLI 3.6.0 and runtime 0.10.0 use document `^0.13.0`.
+CLI 3.6.0/3.6.1 and runtime 0.10.0 use document `^0.13.0`.
 Runtime 0.10.0 also requires UI `^3.4.0` and Core `^2.4.0`. Programmatic UI depends
 only on Core.
 
 ## Installation
 
+UI 3.6.1 is published with the API reference. UI 3.6.2 is prepared for the new
+authoring guides and is not yet available from npm. After publication, optionally
+install it as below; the Core minimum and existing dependency locks are unchanged.
+
 ```bash
-pnpm add @kurot/ui@^3.6.0 @kurot/core@^2.5.2
+pnpm add @kurot/ui@^3.6.2 @kurot/core@^2.5.2
 ```
 
 `@kurot/ui` declares `@kurot/core` as a peer dependency. Install both packages explicitly so the application controls the resolved core version.
 
-Run this command after UI 3.6.0 is published. Its Core ^2.5.2 minimum supplies
+UI 3.6.0 is available from npm. Its Core ^2.5.2 minimum supplies
 the public glyph metrics and unified alignment used by outline-safe Label layout,
 in addition to centered flips and the native text APIs from earlier releases.
 Core installs its published bitmap-font dependency automatically. Update Core
@@ -158,11 +181,11 @@ Adopting 3.6.0 requires a UI installation/lock update and rebuild, plus an accep
 Core installation. Review outlined captions for the larger automatic dimensions
 or earlier wraps. ui-runtime 0.10.0 accepts it through ^3.4.0; its development lock
 may adopt it separately and its host must satisfy UI's Core peer. CLI/ui-document
-need no release or XML migration. Editor currently pins registry UI 3.5.0 and
-requires an explicit dependency update after publication. The selected Tentax
-and MilfMaster templates' ^3.5.0 ranges and the game example's ^3.1.0 range accept
-3.6.0; their installations/locks and rebuilds are separate adoption steps.
-This release preparation does not upgrade applications or other SDK locks.
+need no release or XML migration. Editor 0.28.3 adopts exact registry UI 3.6.0 with a matching Bun lock and local
+App build. The explicitly selected Tentax and MilfMaster templates adopt ^3.6.0
+with matching pnpm locks and rebuilt outputs. The game example's ^3.1.0 range
+already accepts 3.6.0; its lock adoption is optional and unchanged. Other
+applications and SDK development locks retain their own installations.
 
 ## Project style colors
 

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

@@ -6,17 +6,38 @@ import { Watcher } from './Watcher.js';
 export declare class Binding {
     /**
      * Binds a property chain on `host` to a target property.
+     * Assigns the initial value synchronously. An empty chain returns undefined.
+     * Hosts along the chain must dispatch PROPERTY_CHANGE; ordinary assignment
+     * alone is not observed. Retain the returned Watcher and unwatch it when the
+     * owning view closes. Assignment/handler errors propagate synchronously.
      *
      * ```ts
-     * Binding.bindProperty(user, ['name'], label, 'text');
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Binding, Label, PropertyEvent } from '@kurot/ui';
+     *
+     * const user = Object.assign(new EventDispatcher(), { name: 'Player' });
+     * const label = new Label();
+     * const watcher = Binding.bindProperty(user, ['name'], label, 'text');
+     * user.name = 'Ada';
+     * PropertyEvent.dispatchPropertyEvent(user, 'name');
+     * watcher?.unwatch();
      * ```
      */
     static bindProperty(host: unknown, chain: string[], target: unknown, prop: string): Watcher | undefined;
     /**
      * Binds a property chain on `host` to a handler function.
+     * Calls the handler synchronously with the initial value before returning.
+     * An empty chain returns undefined without calling the handler. Changes need
+     * PROPERTY_CHANGE notifications; exceptions propagate. The caller must unwatch
+     * the returned Watcher on disposal, independently of stage removal.
      *
      * ```ts
-     * Binding.bindHandler(user, ['name'], value => console.log(value), undefined);
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Binding } from '@kurot/ui';
+     *
+     * const user = Object.assign(new EventDispatcher(), { name: 'Player' });
+     * const watcher = Binding.bindHandler(user, ['name'], value => console.log(value), undefined);
+     * watcher?.unwatch();
      * ```
      */
     static bindHandler(host: unknown, chain: string[], handler: (value: unknown) => void, thisObject: unknown): Watcher | undefined;
@@ -24,6 +45,29 @@ export declare class Binding {
      * Binds a mixture of literal values and property chains to a string property.
      *
      * `chainIndex` identifies entries in `templates` that contain property chains.
+     * With multiple template entries, replaces watched entries with Watchers and
+     * returns only the last one. Keep/unwatch every Watcher in templates on disposal;
+     * the returned Watcher alone does not clean up all bindings. The single-chain,
+     * single-entry fast path instead returns bindProperty's Watcher without changing
+     * templates. Assignment is immediate and errors propagate synchronously.
+     *
+     * ```ts
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Binding, Label, Watcher } from '@kurot/ui';
+     *
+     * const score = Object.assign(new EventDispatcher(), { hits: 0, total: 10 });
+     * const label = new Label();
+     * const templates: unknown[] = ['hits', ' / ', 'total'];
+     * Binding.bindProperties(score, templates, [0, 2], label, 'text');
+     * function disposeScoreBinding(): void {
+     *   for (const entry of templates) {
+     *     if (entry instanceof Watcher) {
+     *       entry.unwatch();
+     *     }
+     *   }
+     * }
+     * disposeScoreBinding();
+     * ```
      */
     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;;;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"}
+{"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;;;;;;;;;;;;;;;;;;OAkBG;WACW,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAY9G;;;;;;;;;;;;;;;OAeG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;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

@@ -6,9 +6,21 @@ import { Watcher } from './Watcher.js';
 export class Binding {
     /**
      * Binds a property chain on `host` to a target property.
+     * Assigns the initial value synchronously. An empty chain returns undefined.
+     * Hosts along the chain must dispatch PROPERTY_CHANGE; ordinary assignment
+     * alone is not observed. Retain the returned Watcher and unwatch it when the
+     * owning view closes. Assignment/handler errors propagate synchronously.
      *
      * ```ts
-     * Binding.bindProperty(user, ['name'], label, 'text');
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Binding, Label, PropertyEvent } from '@kurot/ui';
+     *
+     * const user = Object.assign(new EventDispatcher(), { name: 'Player' });
+     * const label = new Label();
+     * const watcher = Binding.bindProperty(user, ['name'], label, 'text');
+     * user.name = 'Ada';
+     * PropertyEvent.dispatchPropertyEvent(user, 'name');
+     * watcher?.unwatch();
      * ```
      */
     static bindProperty(host, chain, target, prop) {
@@ -24,9 +36,18 @@ export class Binding {
     }
     /**
      * Binds a property chain on `host` to a handler function.
+     * Calls the handler synchronously with the initial value before returning.
+     * An empty chain returns undefined without calling the handler. Changes need
+     * PROPERTY_CHANGE notifications; exceptions propagate. The caller must unwatch
+     * the returned Watcher on disposal, independently of stage removal.
      *
      * ```ts
-     * Binding.bindHandler(user, ['name'], value => console.log(value), undefined);
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Binding } from '@kurot/ui';
+     *
+     * const user = Object.assign(new EventDispatcher(), { name: 'Player' });
+     * const watcher = Binding.bindHandler(user, ['name'], value => console.log(value), undefined);
+     * watcher?.unwatch();
      * ```
      */
     static bindHandler(host, chain, handler, thisObject) {
@@ -40,6 +61,29 @@ export class Binding {
      * Binds a mixture of literal values and property chains to a string property.
      *
      * `chainIndex` identifies entries in `templates` that contain property chains.
+     * With multiple template entries, replaces watched entries with Watchers and
+     * returns only the last one. Keep/unwatch every Watcher in templates on disposal;
+     * the returned Watcher alone does not clean up all bindings. The single-chain,
+     * single-entry fast path instead returns bindProperty's Watcher without changing
+     * templates. Assignment is immediate and errors propagate synchronously.
+     *
+     * ```ts
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Binding, Label, Watcher } from '@kurot/ui';
+     *
+     * const score = Object.assign(new EventDispatcher(), { hits: 0, total: 10 });
+     * const label = new Label();
+     * const templates: unknown[] = ['hits', ' / ', 'total'];
+     * Binding.bindProperties(score, templates, [0, 2], label, 'text');
+     * function disposeScoreBinding(): void {
+     *   for (const entry of templates) {
+     *     if (entry instanceof Watcher) {
+     *       entry.unwatch();
+     *     }
+     *   }
+     * }
+     * disposeScoreBinding();
+     * ```
      */
     static bindProperties(host, templates, chainIndex, target, prop) {
         if (templates.length === 1 && chainIndex.length === 1) {

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

@@ -21,19 +21,44 @@ export declare class Watcher {
     /**
      * Creates and starts a Watcher for a property chain.
      * Returns `undefined` when the chain is empty.
+     * Does not emit an initial callback; read getValue() or use Binding.bindHandler
+     * for that behavior. Each defined chain host must implement IEventDispatcher
+     * and notify PROPERTY_CHANGE. Call unwatch() when its owner closes; errors from
+     * property access or handlers propagate rather than becoming an error event.
      *
      * ```ts
-     * Watcher.watch(host, ['profile', 'name'], value => updateName(value));
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Watcher, PropertyEvent } from '@kurot/ui';
+     *
+     * const host = Object.assign(new EventDispatcher(), { name: 'Player' });
+     * const watcher = Watcher.watch(host, ['name'], value => console.log(value));
+     * host.name = 'Ada';
+     * PropertyEvent.dispatchPropertyEvent(host, 'name');
+     * watcher?.unwatch();
      * ```
      */
     static watch(host: IEventDispatcher | undefined, chain: string[], handler?: (value: unknown) => void, thisObject?: unknown): Watcher | undefined;
+    /**
+     * Return the current chain's leaf value, or undefined when a host/leaf is absent.
+     * Reading does not dispatch a change or validate the value's runtime type.
+     */
     getValue(): unknown;
+    /**
+     * Replace the chain's handler and callback receiver. Does not immediately emit
+     * the current value; call getValue() for an initial read. Handler errors propagate.
+     */
     setHandler(handler: (value: unknown) => void, thisObject: unknown): void;
     /**
-     * Re-points this watcher at a new host.
-     * Pass `undefined` to detach from the current host.
+     * Detach old property-change subscriptions and point the chain at a new host.
+     * Undefined detaches it. Does not immediately invoke the handler; unlike a plain
+     * object, each defined host must implement the property-change dispatcher contract.
      */
     reset(newHost: IEventDispatcher | undefined): void;
+    /**
+     * Detach property-change listeners throughout the chain and clear this watcher's
+     * handler. Call on round/view disposal; removing a display object does not unwatch
+     * manual bindings. Does not dispose the observed data or target.
+     */
     unwatch(): void;
     private _getHostPropertyValue;
 }

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;;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"}
+{"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;;;;;;;;;;;;;;;;;;OAkBG;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;IAUtB;;;OAGG;IACI,QAAQ,IAAI,OAAO;IAK1B;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAM/E;;;;OAIG;IACI,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI;IAgBzD;;;;OAIG;IACI,OAAO,IAAI,IAAI;IAQtB,OAAO,CAAC,qBAAqB;CAG7B"}

package/dist/kurot/binding/Watcher.js

@@ -42,9 +42,20 @@ export class Watcher {
     /**
      * Creates and starts a Watcher for a property chain.
      * Returns `undefined` when the chain is empty.
+     * Does not emit an initial callback; read getValue() or use Binding.bindHandler
+     * for that behavior. Each defined chain host must implement IEventDispatcher
+     * and notify PROPERTY_CHANGE. Call unwatch() when its owner closes; errors from
+     * property access or handlers propagate rather than becoming an error event.
      *
      * ```ts
-     * Watcher.watch(host, ['profile', 'name'], value => updateName(value));
+     * import { EventDispatcher } from '@kurot/core';
+     * import { Watcher, PropertyEvent } from '@kurot/ui';
+     *
+     * const host = Object.assign(new EventDispatcher(), { name: 'Player' });
+     * const watcher = Watcher.watch(host, ['name'], value => console.log(value));
+     * host.name = 'Ada';
+     * PropertyEvent.dispatchPropertyEvent(host, 'name');
+     * watcher?.unwatch();
      * ```
      */
     static watch(host, chain, handler, thisObject) {
@@ -57,11 +68,19 @@ export class Watcher {
         watcher.reset(host);
         return watcher;
     }
+    /**
+     * Return the current chain's leaf value, or undefined when a host/leaf is absent.
+     * Reading does not dispatch a change or validate the value's runtime type.
+     */
     getValue() {
         if (this._next)
             return this._next.getValue();
         return this._getHostPropertyValue();
     }
+    /**
+     * Replace the chain's handler and callback receiver. Does not immediately emit
+     * the current value; call getValue() for an initial read. Handler errors propagate.
+     */
     setHandler(handler, thisObject) {
         this._handler = handler;
         this._thisObject = thisObject;
@@ -69,8 +88,9 @@ export class Watcher {
             this._next.setHandler(handler, thisObject);
     }
     /**
-     * Re-points this watcher at a new host.
-     * Pass `undefined` to detach from the current host.
+     * Detach old property-change subscriptions and point the chain at a new host.
+     * Undefined detaches it. Does not immediately invoke the handler; unlike a plain
+     * object, each defined host must implement the property-change dispatcher contract.
      */
     reset(newHost) {
         if (this._host) {
@@ -84,6 +104,11 @@ export class Watcher {
             this._next.reset(this._getHostPropertyValue());
         }
     }
+    /**
+     * Detach property-change listeners throughout the chain and clear this watcher's
+     * handler. Call on round/view disposal; removing a display object does not unwatch
+     * manual bindings. Does not dispose the observed data or target.
+     */
     unwatch() {
         this.reset(undefined);
         this._handler = undefined;

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/collections/ArrayCollection.d.ts

@@ -15,17 +15,61 @@ export interface ArrayCollectionEvents extends EventMap {
  */
 export declare class ArrayCollection extends EventDispatcher<ArrayCollectionEvents> implements ICollection {
     private _source;
+    /**
+     * Wrap an existing array without copying; omitted source creates an empty array.
+     * Items are borrowed data and are never disposed by collection mutations.
+     */
     constructor(source?: unknown[]);
+    /**
+     * Live backing array, initially the supplied array or an empty array. Assignment
+     * retains the array and dispatches RESET. Direct array mutation sends no events;
+     * use collection methods or refresh() to notify views.
+     */
     get source(): unknown[];
     set source(value: unknown[]);
+    /**
+     * Number of backing-array items, initially 0 for an empty collection.
+     */
     get length(): number;
+    /**
+     * Read a 0-based item index; absent indices return undefined rather than throwing.
+     */
     getItemAt(index: number): unknown;
+    /**
+     * Return the first identity/equality match index, or -1 when the item is absent.
+     */
     getItemIndex(item: unknown): number;
+    /**
+     * Append a borrowed item and synchronously dispatch ADD. Does not clone the item.
+     */
     addItem(item: unknown): void;
+    /**
+     * Insert a borrowed item and dispatch ADD. Pass an integer index from 0 through
+     * length (inclusive). Bounds below 0 or above length throw RangeError; there is
+     * no separate integer validation.
+     */
     addItemAt(item: unknown, index: number): void;
+    /**
+     * Remove and return an item, dispatching REMOVE without disposing it. Pass an
+     * integer index from 0 through length-1. Out-of-bounds values throw RangeError;
+     * there is no separate integer validation.
+     */
     removeItemAt(index: number): unknown;
+    /**
+     * Replace an item, return the previous item and dispatch REPLACE. Neither item
+     * is disposed. Pass an integer index within 0..length-1; bounds violations throw
+     * RangeError, without separate integer validation.
+     */
     replaceItemAt(item: unknown, index: number): unknown;
+    /**
+     * Dispatch UPDATE for an existing item's first matching index. Missing items are
+     * ignored; changing an object's fields alone does not notify collection views.
+     */
     itemUpdated(item: unknown): void;
+    /**
+     * Empty the live backing array and dispatch REMOVE. The same array remains in
+     * use; removed data objects and their external resources are not disposed.
+     */
     removeAll(): void;
     /**
      * Replace all items with a new source. Unlike setting `source`, this does
@@ -33,6 +77,10 @@ export declare class ArrayCollection extends EventDispatcher<ArrayCollectionEven
      * are dispatched instead.
      */
     replaceAll(newSource: unknown[]): void;
+    /**
+     * Dispatch REFRESH so views reread current data. Does not sort, copy or load
+     * items; useful after direct backing-array changes.
+     */
     refresh(): void;
     /**
      * Sort the collection in place using a comparator function.

package/dist/kurot/collections/ArrayCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayCollection.d.ts","sourceRoot":"","sources":["../../../src/kurot/collections/ArrayCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAuB,MAAM,8BAA8B,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,qBAAsB,SAAQ,QAAQ;IACtD,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,eAAe,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,eAAe,CAAC,qBAAqB,CAAE,YAAW,WAAW;IAGjG,OAAO,CAAC,OAAO,CAAY;gBAIR,MAAM,CAAC,EAAE,OAAO,EAAE;IAOrC,IAAW,MAAM,IAAI,OAAO,EAAE,CAE7B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAGjC;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAIM,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAInC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK5B,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IASpD,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAOhC,SAAS,IAAI,IAAI;IAMxB;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI;IActC,OAAO,IAAI,IAAI;IAItB;;;OAGG;IACI,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI;IAKtE;;;;OAIG;IACI,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,IAAI;IAiBnD;;;;OAIG;IACI,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI;IAO/D,OAAO,CAAC,gBAAgB;CASxB"}
+{"version":3,"file":"ArrayCollection.d.ts","sourceRoot":"","sources":["../../../src/kurot/collections/ArrayCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAuB,MAAM,8BAA8B,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,qBAAsB,SAAQ,QAAQ;IACtD,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,eAAe,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,eAAe,CAAC,qBAAqB,CAAE,YAAW,WAAW;IAGjG,OAAO,CAAC,OAAO,CAAY;IAI3B;;;OAGG;gBACgB,MAAM,CAAC,EAAE,OAAO,EAAE;IAOrC;;;;OAIG;IACH,IAAW,MAAM,IAAI,OAAO,EAAE,CAE7B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAGjC;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAID;;OAEG;IACI,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAI1C;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKnC;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQpD;;;;OAIG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAS3C;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAS3D;;;OAGG;IACI,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAOvC;;;OAGG;IACI,SAAS,IAAI,IAAI;IAMxB;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI;IAc7C;;;OAGG;IACI,OAAO,IAAI,IAAI;IAItB;;;OAGG;IACI,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI;IAKtE;;;;OAIG;IACI,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,IAAI;IAiBnD;;;;OAIG;IACI,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI;IAO/D,OAAO,CAAC,gBAAgB;CASxB"}