@kurot/ui 4.1.0 → 5.0.0

package/CHANGELOG.md

@@ -4,9 +4,59 @@ All notable changes to `@kurot/ui` are documented here.
 
 ---
 
+## 5.0.0 — 2026-11-06
+
+Prepared for publication; not yet published.
+
+### Breaking
+
+- Remove callback receiver arguments from Animation, Watcher construction/watch/
+  setHandler and Binding.bindHandler. Watcher's optional next link is now its
+  third constructor argument. Initial and later notifications run unbound.
+- Follow Core's callback-only ticker API. Keep TouchScroll's update callback as
+  a stable arrow member so throw/bounce animations retain their owning instance.
+- Add runtime and strict compiler coverage for unbound callbacks, downstream
+  Watchers, handler replacement, unwatch, animation completion/stop and bounce.
+  Existing Skin factory and EventDispatcher receiver contracts are unchanged.
+- Require Core ^3.0.0 for its callback-only ticker contract. Keep existing
+  list generics, Skin part binding and KUI semantics unchanged.
+
+- Verification: package build and all 472 unit tests pass against matching
+  prepared dependencies. Source/packed declaration and browser integration are
+  recorded in the repository CHANGELOG.
+
+## 4.2.0 — 2026-11-06
+
+Published; exact version and npm latest verified on 2026-11-06. Downloaded
+archive SHA-512 integrity passes; all 5,587 files and the compressed archive
+are byte-identical to the tested release artifact.
+
+### Added
+
+- Add unknown-defaulted item generics across collections, data groups, lists,
+  TabBar/ComboBox and collection/item-tap event payloads. Infer ArrayCollection
+  elements from supplied arrays while preserving unknown for an untyped empty
+  collection. Keep ItemRenderer's existing TSkin argument first, data second.
+- Preserve null data and type sparse/missing reads, mutation results, empty
+  selection and uninitialized renderer/event data with undefined. Refine native
+  listener declarations without replacing runtime event methods.
+- Add strict positive/negative compiler fixtures and runtime regressions for
+  nullable data, mutations, virtual reuse, selection, cancellation and events.
+  No Core/resource/KUI-format change or application migration is included.
+
+### Compatibility and verification
+
+- Generic arguments default to unknown; ItemRenderer retains TSkin first.
+  Typed list Skin fields require CLI >= 4.1.1 within 4.x. Core peer remains
+  ^2.5.2; no other SDK release or consumer dependency update is required.
+- UI build and all 465 tests pass. Strict source and packed-declaration consumers
+  cover inference, nullable values, legacy Skin arguments and invalid data.
+  Existing runtime JS ASTs match all 88 published modules after comment removal.
+
 ## 4.1.0 — 2026-11-05
 
-Release prepared; not yet published.
+Published; exact version and npm latest verified on 2026-11-05. Downloaded
+archive SHA-512 and package manifest match the tested release artifact.
 
 ### Added
 

package/README.md

@@ -1,14 +1,29 @@
 # @kurot/ui
 
 Native skinnable components, layout, collections, binding and view states for
-Kurot games. Package version: **4.1.0** (release prepared; not yet published).
-Requires Core **^2.5.2**.
+Kurot games. Package version: **5.0.0** (prepared for publication).
+Requires Core **^3.0.0**.
 
 For game UI, read [standard authoring and directories](docs/ui-authoring.md) and
 the [complete ScoreHUD component/Skin pair](docs/recipes/score-hud.md). Use
 [API topics](docs/api/topics.md) and the [symbol index](docs/api/index.md) for
 exact member contracts. Build-time KUI skins run through UI without ui-runtime.
 
+## Callback ownership
+
+UI 5 removes receiver parameters from Animation, Watcher and Binding.bindHandler
+and uses Core 3's callback-only ticker. Use stable arrow members or callbacks
+bound once when they access instance state. See [callback ownership](docs/callbacks.md).
+
+## Typed list data
+
+UI 4.2 adds `List<T>`, inferred `ArrayCollection<T>`, nullable selection and typed
+item-tap listeners. Defaults remain unknown; ItemRenderer retains `TSkin` first
+and adds data second. Sparse/missing reads and empty selection include undefined.
+Declared typed list fields in KUI hosts require CLI **>= 4.1.1 within 4.x**;
+ordinary TypeScript use does not require CLI. See
+[list data types](docs/list-data-types.md) for examples and null/undefined behavior.
+
 ## RichLabel component typography
 
 RichLabel supports component fontFamily, size, textColor, stroke, strokeColor,
@@ -21,7 +36,7 @@ semantic materialization uses runtime 0.11. See the
 ## Installation
 
 ```sh
-pnpm add @kurot/ui@^4.1.0 @kurot/core@^2.5.2
+pnpm add @kurot/ui@^5.0.0 @kurot/core@^3.0.0
 ```
 
 Install Core explicitly so the application controls its shared engine instance.
@@ -53,9 +68,8 @@ CLI 4 exports local Skin factories with
 path, then pass the factories and default mappings to UIContext. See the
 [context contract](docs/ui-context.md) and [complete module loader](../cli/docs/module-skins.md).
 
-Existing global applications keep their Theme/asset behavior. UIContext needs
-no new Core API beyond the existing ^2.5.2 peer; Core 2.8.0 is required only when
-adopting its new ImageBitmap support. Dispose views and their activity before
+Existing global applications keep their Theme/asset behavior. This UI release
+requires Core ^3.0.0, including ImageBitmap support. Dispose views and their activity before
 the context, then release borrowed resources/fonts through their owners.
 
 ## Stage-sized UI roots

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

@@ -30,17 +30,18 @@ export declare class Binding {
      * 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.
+     * The handler runs without a receiver for both its initial and later calls.
      *
      * ```ts
      * 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);
+     * const watcher = Binding.bindHandler(user, ['name'], value => console.log(value));
      * watcher?.unwatch();
      * ```
      */
-    static bindHandler(host: unknown, chain: string[], handler: (value: unknown) => void, thisObject: unknown): Watcher | undefined;
+    static bindHandler(host: unknown, chain: string[], handler: (value: unknown) => void): Watcher | undefined;
     /**
      * Binds a mixture of literal values and property chains to a string property.
      *

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;;;;;;;;;;;;;;;;;;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"}
+{"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;;;;;;;;;;;;;;;;OAgBG;WACW,WAAW,CACxB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC/B,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

@@ -29,7 +29,7 @@ export class Binding {
             const assign = (value) => {
                 target[prop] = value;
             };
-            watcher.setHandler(assign, undefined);
+            watcher.setHandler(assign);
             assign(watcher.getValue());
         }
         return watcher;
@@ -40,20 +40,21 @@ export class Binding {
      * 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.
+     * The handler runs without a receiver for both its initial and later calls.
      *
      * ```ts
      * 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);
+     * const watcher = Binding.bindHandler(user, ['name'], value => console.log(value));
      * watcher?.unwatch();
      * ```
      */
-    static bindHandler(host, chain, handler, thisObject) {
-        const watcher = Watcher.watch(host, chain, handler, thisObject);
+    static bindHandler(host, chain, handler) {
+        const watcher = Watcher.watch(host, chain, handler);
         if (watcher) {
-            handler.call(thisObject, watcher.getValue());
+            handler(watcher.getValue());
         }
         return watcher;
     }
@@ -105,7 +106,7 @@ export class Binding {
             }
             if (watcher) {
                 templates[index] = watcher;
-                watcher.setHandler(assign, undefined);
+                watcher.setHandler(assign);
                 lastWatcher = watcher;
             }
         }

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

@@ -14,10 +14,9 @@ export declare class Watcher {
     private readonly _next?;
     private _host?;
     private _handler?;
-    private _thisObject;
     private _isExecuting;
     private _onPropertyChange;
-    constructor(property: string, handler?: (value: unknown) => void, thisObject?: unknown, next?: Watcher);
+    constructor(property: string, handler?: (value: unknown) => void, next?: Watcher);
     /**
      * Creates and starts a Watcher for a property chain.
      * Returns `undefined` when the chain is empty.
@@ -25,6 +24,8 @@ export declare class Watcher {
      * 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.
+     * Handlers run without a receiver; retain instance state with a stable arrow
+     * member or a function bound once by its owner.
      *
      * ```ts
      * import { EventDispatcher } from '@kurot/core';
@@ -37,17 +38,17 @@ export declare class Watcher {
      * watcher?.unwatch();
      * ```
      */
-    static watch(host: IEventDispatcher | undefined, chain: string[], handler?: (value: unknown) => void, thisObject?: unknown): Watcher | undefined;
+    static watch(host: IEventDispatcher | undefined, chain: string[], handler?: (value: unknown) => void): 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
+     * Replace the chain's unbound handler. Does not immediately emit
      * the current value; call getValue() for an initial read. Handler errors propagate.
      */
-    setHandler(handler: (value: unknown) => void, thisObject: unknown): void;
+    setHandler(handler: (value: unknown) => void): void;
     /**
      * 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

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;;;;;;;;;;;;;;;;;;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"}
+{"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;IACzC,OAAO,CAAC,YAAY,CAAS;IAEhC,OAAO,CAAC,iBAAiB,CAevB;gBAKD,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,IAAI,CAAC,EAAE,OAAO;IASf;;;;;;;;;;;;;;;;;;;;OAoBG;WACW,KAAK,CAClB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,GAAG,SAAS;IAUtB;;;OAGG;IACI,QAAQ,IAAI,OAAO;IAK1B;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAO1D;;;;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

@@ -11,7 +11,6 @@ export class Watcher {
     _next;
     _host;
     _handler;
-    _thisObject;
     _isExecuting = false;
     _onPropertyChange = (event) => {
         if (!(event instanceof PropertyEvent))
@@ -23,8 +22,9 @@ export class Watcher {
             if (this._next) {
                 this._next.reset(this._getHostPropertyValue());
             }
-            if (this._handler) {
-                this._handler.call(this._thisObject, this.getValue());
+            const handler = this._handler;
+            if (handler) {
+                handler(this.getValue());
             }
         }
         finally {
@@ -32,10 +32,9 @@ export class Watcher {
         }
     };
     // ── Constructor ───────────────────────────────────────────────────────
-    constructor(property, handler, thisObject, next) {
+    constructor(property, handler, next) {
         this._property = property;
         this._handler = handler;
-        this._thisObject = thisObject;
         this._next = next;
     }
     // ── Public methods ────────────────────────────────────────────────────
@@ -46,6 +45,8 @@ export class Watcher {
      * 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.
+     * Handlers run without a receiver; retain instance state with a stable arrow
+     * member or a function bound once by its owner.
      *
      * ```ts
      * import { EventDispatcher } from '@kurot/core';
@@ -58,13 +59,13 @@ export class Watcher {
      * watcher?.unwatch();
      * ```
      */
-    static watch(host, chain, handler, thisObject) {
+    static watch(host, chain, handler) {
         if (chain.length === 0)
             return undefined;
         const property = chain[0];
         const remaining = chain.slice(1);
-        const next = remaining.length > 0 ? Watcher.watch(undefined, remaining, handler, thisObject) : undefined;
-        const watcher = new Watcher(property, handler, thisObject, next);
+        const next = remaining.length > 0 ? Watcher.watch(undefined, remaining, handler) : undefined;
+        const watcher = new Watcher(property, handler, next);
         watcher.reset(host);
         return watcher;
     }
@@ -78,14 +79,14 @@ export class Watcher {
         return this._getHostPropertyValue();
     }
     /**
-     * Replace the chain's handler and callback receiver. Does not immediately emit
+     * Replace the chain's unbound handler. Does not immediately emit
      * the current value; call getValue() for an initial read. Handler errors propagate.
      */
-    setHandler(handler, thisObject) {
+    setHandler(handler) {
         this._handler = handler;
-        this._thisObject = thisObject;
-        if (this._next)
-            this._next.setHandler(handler, thisObject);
+        if (this._next) {
+            this._next.setHandler(handler);
+        }
     }
     /**
      * Detach old property-change subscriptions and point the chain at a new host.

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":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAO3D;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IACnB,yEAAyE;IAExD,SAAS,CAAS;IACf,KAAK,CAAW;IAE5B,KAAK,CAAY;IACjB,QAAQ,CAA4B;IACjC,YAAY,GAAG,KAAK,CAAC;IAExB,iBAAiB,GAAG,CAAC,KAAY,EAAQ,EAAE;QAClD,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC;YAAE,OAAO;QAC9C,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QACnE,IAAI,CAAC;YACJ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAkC,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1B,CAAC;QACF,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC3B,CAAC;IACF,CAAC,CAAC;IAEF,yEAAyE;IAEzE,YACC,QAAgB,EAChB,OAAkC,EAClC,IAAc;QAEd,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,yEAAyE;IAEzE;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,MAAM,CAAC,KAAK,CAClB,IAAkC,EAClC,KAAe,EACf,OAAkC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;;OAGG;IACI,QAAQ;QACd,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,OAAiC;QAClD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAqC;QACjD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,OAA+B,CAAC;QAE7C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAkC,CAAC,CAAC;QAChF,CAAC;IACF,CAAC;IAED;;;;OAIG;IACI,OAAO;QACb,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC;IACjD,CAAC;IAED,yEAAyE;IAEjE,qBAAqB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC;CACD"}

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

@@ -1,11 +1,17 @@
-import { EventDispatcher, type EventMap } from '@kurot/core';
+import { EventDispatcher } from '@kurot/core';
 import { CollectionEvent } from '../events/CollectionEvent.js';
-import type { ICollection } from './ICollection.js';
-export interface ArrayCollectionEvents extends EventMap {
-    [CollectionEvent.COLLECTION_CHANGE]: CollectionEvent;
+import type { ICollection, ICollectionEvents } from './ICollection.js';
+/**
+ * Typed mutation payloads dispatched by an ArrayCollection.
+ */
+export interface ArrayCollectionEvents<T = unknown> extends ICollectionEvents<T> {
+    /**
+     * Synchronous notification after a collection mutation or explicit refresh.
+     */
+    [CollectionEvent.COLLECTION_CHANGE]: CollectionEvent<T>;
 }
 /**
- * A wrapper around a plain `unknown[]` that implements {@link ICollection}.
+ * A wrapper around a plain `T[]` that implements {@link ICollection}.
  *
  * Dispatches {@link CollectionEvent.COLLECTION_CHANGE} whenever items are
  * added, removed, replaced, or the entire source is reset — allowing
@@ -13,20 +19,21 @@ export interface ArrayCollectionEvents extends EventMap {
  *
  * @defaultProperty source
  */
-export declare class ArrayCollection extends EventDispatcher<ArrayCollectionEvents> implements ICollection {
+export declare class ArrayCollection<T = unknown> extends EventDispatcher<ArrayCollectionEvents<T>> implements ICollection<T> {
     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[]);
+    constructor(source: never[]);
+    constructor(source?: T[]);
     /**
      * 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[]);
+    get source(): T[];
+    set source(value: T[]);
     /**
      * Number of backing-array items, initially 0 for an empty collection.
      */
@@ -34,38 +41,38 @@ export declare class ArrayCollection extends EventDispatcher<ArrayCollectionEven
     /**
      * Read a 0-based item index; absent indices return undefined rather than throwing.
      */
-    getItemAt(index: number): unknown;
+    getItemAt(index: number): T | undefined;
     /**
      * Return the first identity/equality match index, or -1 when the item is absent.
      */
-    getItemIndex(item: unknown): number;
+    getItemIndex(item: T | undefined): number;
     /**
      * Append a borrowed item and synchronously dispatch ADD. Does not clone the item.
      */
-    addItem(item: unknown): void;
+    addItem(item: T): 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;
+    addItemAt(item: T, 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;
+    removeItemAt(index: number): T | undefined;
     /**
      * 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;
+    replaceItemAt(item: T, index: number): T | undefined;
     /**
      * 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;
+    itemUpdated(item: T): 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.
@@ -76,7 +83,7 @@ export declare class ArrayCollection extends EventDispatcher<ArrayCollectionEven
      * **not** reset scroll position in the view — individual add/remove events
      * are dispatched instead.
      */
-    replaceAll(newSource: unknown[]): void;
+    replaceAll(newSource: T[]): void;
     /**
      * Dispatch REFRESH so views reread current data. Does not sort, copy or load
      * items; useful after direct backing-array changes.
@@ -86,7 +93,7 @@ export declare class ArrayCollection extends EventDispatcher<ArrayCollectionEven
      * Sort the collection in place using a comparator function.
      * Dispatches REFRESH after sorting.
      */
-    sort(compareFunction: (a: unknown, b: unknown) => number): void;
+    sort(compareFunction: (a: T, b: T) => number): void;
     /**
      * Sort the collection by a field name (Egret-compatible sortOn).
      * @param fieldName Property name to sort by.
@@ -98,7 +105,7 @@ export declare class ArrayCollection extends EventDispatcher<ArrayCollectionEven
      * Dispatches REFRESH after filtering.
      * Note: items that are filtered out are removed from the source array.
      */
-    filterFunction(testFn: (item: unknown) => boolean): void;
+    filterFunction(testFn: (item: T) => boolean): void;
     private _dispatchCoEvent;
 }
 //# sourceMappingURL=ArrayCollection.d.ts.map

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;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"}
+{"version":3,"file":"ArrayCollection.d.ts","sourceRoot":"","sources":["../../../src/kurot/collections/ArrayCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAuB,MAAM,8BAA8B,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IAC/E;;OAEG;IACH,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CACxD;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IAGpH,OAAO,CAAC,OAAO,CAAM;IAIrB;;;OAGG;gBACgB,MAAM,EAAE,KAAK,EAAE;gBACf,MAAM,CAAC,EAAE,CAAC,EAAE;IAQ/B;;;;OAIG;IACH,IAAW,MAAM,IAAI,CAAC,EAAE,CAEvB;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAG3B;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAID;;OAEG;IACI,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI9C;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,GAAG,MAAM;IAIhD;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAK7B;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ9C;;;;OAIG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IASjD;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAS3D;;;OAGG;IACI,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAOjC;;;OAGG;IACI,SAAS,IAAI,IAAI;IAMxB;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,IAAI;IAcvC;;;OAGG;IACI,OAAO,IAAI,IAAI;IAItB;;;OAGG;IACI,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI;IAK1D;;;;OAIG;IACI,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,IAAI;IAiBnD;;;;OAIG;IACI,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI;IAOzD,OAAO,CAAC,gBAAgB;CASxB"}

package/dist/kurot/collections/ArrayCollection.js

@@ -1,7 +1,7 @@
 import { EventDispatcher } from '@kurot/core';
 import { CollectionEvent, CollectionEventKind } from '../events/CollectionEvent.js';
 /**
- * A wrapper around a plain `unknown[]` that implements {@link ICollection}.
+ * A wrapper around a plain `T[]` that implements {@link ICollection}.
  *
  * Dispatches {@link CollectionEvent.COLLECTION_CHANGE} whenever items are
  * added, removed, replaced, or the entire source is reset — allowing
@@ -12,11 +12,6 @@ import { CollectionEvent, CollectionEventKind } from '../events/CollectionEvent.
 export class ArrayCollection extends EventDispatcher {
     // ── Instance fields ───────────────────────────────────────────────────
     _source;
-    // ── Constructor ───────────────────────────────────────────────────────
-    /**
-     * 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) {
         super();
         this._source = source ?? [];

package/dist/kurot/collections/ArrayCollection.js.map

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

package/dist/kurot/collections/ICollection.d.ts

@@ -1,4 +1,15 @@
-import type { IEventDispatcher } from '@kurot/core';
+import type { IEventDispatcher, EventMap } from '@kurot/core';
+import type { CollectionEvent } from '../events/CollectionEvent.js';
+import type { TypedEventListeners } from '../events/TypedEventListeners.js';
+/**
+ * Data-bearing changes emitted by an observable collection.
+ */
+export interface ICollectionEvents<T = unknown> extends EventMap {
+    /**
+     * Mutation notification preserving provider item values and identities.
+     */
+    [CollectionEvent.COLLECTION_CHANGE]: CollectionEvent<T>;
+}
 /**
  * Interface for collection data sources used by data-driven components
  * (DataGroup, List, TabBar, etc.).
@@ -6,7 +17,19 @@ import type { IEventDispatcher } from '@kurot/core';
  * Implementations dispatch {@link CollectionEvent.COLLECTION_CHANGE} when
  * the underlying data changes so that views can update accordingly.
  */
-export interface ICollection extends IEventDispatcher {
+export interface ICollection<T = unknown> extends IEventDispatcher {
+    /**
+     * Observes typed collection mutations; other event names retain Core semantics.
+     */
+    addEventListener: TypedEventListeners<ICollectionEvents<T>>['addEventListener'];
+    /**
+     * Observes one mutation using Core's existing once-listener behavior.
+     */
+    once: TypedEventListeners<ICollectionEvents<T>>['once'];
+    /**
+     * Removes the matching listener and capture phase without dispatching events.
+     */
+    removeEventListener: TypedEventListeners<ICollectionEvents<T>>['removeEventListener'];
     /**
      * The number of items in this collection.
      * `0` means empty, `-1` means length is unknown.
@@ -15,10 +38,10 @@ export interface ICollection extends IEventDispatcher {
     /**
      * Returns the item at the specified index, or `undefined` if none.
      */
-    getItemAt(index: number): unknown;
+    getItemAt(index: number): T | undefined;
     /**
      * Returns the index of the given item, or `-1` if not found.
      */
-    getItemIndex(item: unknown): number;
+    getItemIndex(item: T | undefined): number;
 }
 //# sourceMappingURL=ICollection.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ICollection.d.ts","sourceRoot":"","sources":["../../../src/kurot/collections/ICollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACpD;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CACpC"}
+{"version":3,"file":"ICollection.d.ts","sourceRoot":"","sources":["../../../src/kurot/collections/ICollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,QAAQ;IAC/D;;OAEG;IACH,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CACxD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB;IACjE;;OAEG;IACH,gBAAgB,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAChF;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxD;;OAEG;IACH,mBAAmB,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAEtF;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAExC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC;CAC1C"}

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

@@ -1,3 +1,3 @@
-export type { ICollection } from './ICollection.js';
-export { ArrayCollection } from './ArrayCollection.js';
+export type { ICollection, ICollectionEvents } from './ICollection.js';
+export { ArrayCollection, type ArrayCollectionEvents } from './ArrayCollection.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/collections/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/collections/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/collections/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/collections/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAA8B,MAAM,sBAAsB,CAAC"}

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

@@ -4,7 +4,6 @@
  */
 export declare class Animation {
     private _updateFunction;
-    private _thisObject;
     private _easerFunction;
     private _isPlaying;
     private _duration;
@@ -13,7 +12,11 @@ export declare class Animation {
     private _to;
     private _startTime;
     private _endFunction?;
-    constructor(updateFunction: (animation: Animation) => void, thisObject: unknown);
+    /**
+     * Update and end callbacks receive this Animation as their argument and run
+     * without a receiver. Use a stable arrow member or bind once for instance state.
+     */
+    constructor(updateFunction: (animation: Animation) => void);
     get isPlaying(): boolean;
     get duration(): number;
     set duration(value: number);

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

@@ -1 +1 @@
-{"version":3,"file":"Animation.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Animation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,SAAS;IAGrB,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,cAAc,CAAuF;IAC7G,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAInC,cAAc,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,EAAE,UAAU,EAAE,OAAO;IAOtF,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAEhC;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAE5B;IAED,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,IAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAE1B;IAED,IAAW,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAErE;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,EAEzE;IAED,IAAW,aAAa,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAErE;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,EAEzE;IAIM,IAAI,IAAI,IAAI;IAKZ,IAAI,IAAI,IAAI;IAQnB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,WAAW,CAoBjB;CACF"}
+{"version":3,"file":"Animation.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Animation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,SAAS;IAGrB,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,cAAc,CAAuF;IAC7G,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAC,CAAiC;IAItD;;;OAGG;gBACgB,cAAc,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI;IAMjE,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAEhC;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAE5B;IAED,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,IAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAE1B;IAED,IAAW,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAErE;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,EAEzE;IAED,IAAW,aAAa,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAErE;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,EAEzE;IAIM,IAAI,IAAI,IAAI;IAKZ,IAAI,IAAI,IAAI;IAQnB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,WAAW,CAsBjB;CACF"}