@kurot/ui 4.0.0 → 4.2.0

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

@@ -2,11 +2,11 @@ import type { IUIComponent } from './IUIComponent.js';
 /**
  * UI component that renders one item from a data provider.
  */
-export interface IItemRenderer extends IUIComponent {
+export interface IItemRenderer<T = unknown> extends IUIComponent {
     /**
      * The data object to render.
      */
-    data: unknown;
+    data: T | undefined;
     /**
      * Whether this item is currently selected.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"IItemRenderer.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IItemRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,YAAY;IAClD;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"IItemRenderer.d.ts","sourceRoot":"","sources":["../../../src/kurot/core/IItemRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,YAAY;IAC/D;;OAEG;IACH,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CAClB"}

package/dist/kurot/events/CollectionEvent.d.ts

@@ -15,7 +15,7 @@ export type CollectionEventKind = (typeof CollectionEventKind)[keyof typeof Coll
 /**
  * Describes a change to an observable collection.
  */
-export declare class CollectionEvent extends Event {
+export declare class CollectionEvent<T = unknown> extends Event {
     static readonly COLLECTION_CHANGE = "collectionChange";
     /**
      * Operation that changed the collection.
@@ -24,11 +24,11 @@ export declare class CollectionEvent extends Event {
     /**
      * Items added, updated, or moved by the operation.
      */
-    items: unknown[];
+    items: (T | undefined)[];
     /**
      * Items removed or replaced by the operation.
      */
-    oldItems: unknown[];
+    oldItems: (T | undefined)[];
     /**
      * Resulting collection index, or `-1` when the operation has no index.
      */
@@ -42,6 +42,6 @@ export declare class CollectionEvent extends Event {
      * Dispatches a collection-change event when the target has a listener.
      * Returns `true` without allocating an event when no listener is registered.
      */
-    static dispatchCollectionEvent(target: IEventDispatcher, kind: CollectionEventKind, location?: number, oldLocation?: number, items?: unknown[], oldItems?: unknown[]): boolean;
+    static dispatchCollectionEvent<T = unknown>(target: IEventDispatcher, kind: CollectionEventKind, location?: number, oldLocation?: number, items?: (T | undefined)[], oldItems?: (T | undefined)[]): boolean;
 }
 //# sourceMappingURL=CollectionEvent.d.ts.map

package/dist/kurot/events/CollectionEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollectionEvent.d.ts","sourceRoot":"","sources":["../../../src/kurot/events/CollectionEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjG;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAGzC,gBAAuB,iBAAiB,sBAAsB;IAI9D;;OAEG;IACI,IAAI,EAAE,mBAAmB,CAA2B;IAC3D;;OAEG;IACI,KAAK,EAAE,OAAO,EAAE,CAAM;IAC7B;;OAEG;IACI,QAAQ,EAAE,OAAO,EAAE,CAAM;IAChC;;OAEG;IACI,QAAQ,SAAM;IACrB;;OAEG;IACI,WAAW,SAAM;gBAIL,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,UAAU,UAAQ;IAMpE;;;OAGG;WACW,uBAAuB,CACpC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,mBAAmB,EACzB,QAAQ,SAAK,EACb,WAAW,SAAK,EAChB,KAAK,GAAE,OAAO,EAAO,EACrB,QAAQ,GAAE,OAAO,EAAO,GACtB,OAAO;CAUV"}
+{"version":3,"file":"CollectionEvent.d.ts","sourceRoot":"","sources":["../../../src/kurot/events/CollectionEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjG;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,KAAK;IAGtD,gBAAuB,iBAAiB,sBAAsB;IAI9D;;OAEG;IACI,IAAI,EAAE,mBAAmB,CAA2B;IAC3D;;OAEG;IACI,KAAK,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAAM;IACrC;;OAEG;IACI,QAAQ,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAAM;IACxC;;OAEG;IACI,QAAQ,SAAM;IACrB;;OAEG;IACI,WAAW,SAAM;gBAIL,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,UAAU,UAAQ;IAMpE;;;OAGG;WACW,uBAAuB,CAAC,CAAC,GAAG,OAAO,EAChD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,mBAAmB,EACzB,QAAQ,SAAK,EACb,WAAW,SAAK,EAChB,KAAK,GAAE,CAAC,CAAC,GAAG,SAAS,CAAC,EAAO,EAC7B,QAAQ,GAAE,CAAC,CAAC,GAAG,SAAS,CAAC,EAAO,GAC9B,OAAO;CAUV"}

package/dist/kurot/events/CollectionEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"CollectionEvent.js","sourceRoot":"","sources":["../../../src/kurot/events/CollectionEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAyB,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACH,CAAC;AAIX;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACzC,yEAAyE;IAElE,MAAM,CAAU,iBAAiB,GAAG,kBAAkB,CAAC;IAE9D,yEAAyE;IAEzE;;OAEG;IACI,IAAI,GAAwB,mBAAmB,CAAC,GAAG,CAAC;IAC3D;;OAEG;IACI,KAAK,GAAc,EAAE,CAAC;IAC7B;;OAEG;IACI,QAAQ,GAAc,EAAE,CAAC;IAChC;;OAEG;IACI,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrB;;OAEG;IACI,WAAW,GAAG,CAAC,CAAC,CAAC;IAExB,yEAAyE;IAEzE,YAAmB,IAAY,EAAE,OAAO,GAAG,KAAK,EAAE,UAAU,GAAG,KAAK;QACnE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,yEAAyE;IAEzE;;;OAGG;IACI,MAAM,CAAC,uBAAuB,CACpC,MAAwB,EACxB,IAAyB,EACzB,QAAQ,GAAG,CAAC,CAAC,EACb,WAAW,GAAG,CAAC,CAAC,EAChB,QAAmB,EAAE,EACrB,WAAsB,EAAE;QAExB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,iBAAiB,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7E,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QACjE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACtB,CAAC,CAAC,WAAW,GAAG,WAAW,CAAC;QAC5B,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QAChB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACtB,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC"}
+{"version":3,"file":"CollectionEvent.js","sourceRoot":"","sources":["../../../src/kurot/events/CollectionEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAyB,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACH,CAAC;AAIX;;GAEG;AACH,MAAM,OAAO,eAA6B,SAAQ,KAAK;IACtD,yEAAyE;IAElE,MAAM,CAAU,iBAAiB,GAAG,kBAAkB,CAAC;IAE9D,yEAAyE;IAEzE;;OAEG;IACI,IAAI,GAAwB,mBAAmB,CAAC,GAAG,CAAC;IAC3D;;OAEG;IACI,KAAK,GAAsB,EAAE,CAAC;IACrC;;OAEG;IACI,QAAQ,GAAsB,EAAE,CAAC;IACxC;;OAEG;IACI,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrB;;OAEG;IACI,WAAW,GAAG,CAAC,CAAC,CAAC;IAExB,yEAAyE;IAEzE,YAAmB,IAAY,EAAE,OAAO,GAAG,KAAK,EAAE,UAAU,GAAG,KAAK;QACnE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,yEAAyE;IAEzE;;;OAGG;IACI,MAAM,CAAC,uBAAuB,CACpC,MAAwB,EACxB,IAAyB,EACzB,QAAQ,GAAG,CAAC,CAAC,EACb,WAAW,GAAG,CAAC,CAAC,EAChB,QAA2B,EAAE,EAC7B,WAA8B,EAAE;QAEhC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,iBAAiB,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7E,MAAM,CAAC,GAAG,IAAI,eAAe,CAAI,eAAe,CAAC,iBAAiB,CAAC,CAAC;QACpE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACtB,CAAC,CAAC,WAAW,GAAG,WAAW,CAAC;QAC5B,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QAChB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACtB,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC"}

package/dist/kurot/events/ItemTapEvent.d.ts

@@ -3,12 +3,12 @@ import type { ItemRenderer } from '../components/ItemRenderer.js';
 /**
  * Reports activation of an item in an item-rendering component.
  */
-export declare class ItemTapEvent extends Event {
+export declare class ItemTapEvent<T = unknown> extends Event {
     static readonly ITEM_TAP = "itemTap";
     /**
      * Data item that was activated.
      */
-    item: unknown;
+    item: T | undefined;
     /**
      * Index of the activated item in the data provider.
      */
@@ -16,12 +16,12 @@ export declare class ItemTapEvent extends Event {
     /**
      * Renderer that received the interaction, when one is available.
      */
-    itemRenderer?: ItemRenderer;
+    itemRenderer?: ItemRenderer<string, T>;
     constructor(type: string, bubbles?: boolean, cancelable?: boolean);
     /**
      * Dispatches an item-tap event when the target has a listener.
      * Returns `true` without allocating an event when no listener is registered.
      */
-    static dispatchItemTapEvent(target: IEventDispatcher, item: unknown, itemIndex: number, itemRenderer?: ItemRenderer): boolean;
+    static dispatchItemTapEvent<T = unknown>(target: IEventDispatcher, item: T | undefined, itemIndex: number, itemRenderer?: ItemRenderer<string, T>): boolean;
 }
 //# sourceMappingURL=ItemTapEvent.d.ts.map

package/dist/kurot/events/ItemTapEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ItemTapEvent.d.ts","sourceRoot":"","sources":["../../../src/kurot/events/ItemTapEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAGtC,gBAAuB,QAAQ,aAAa;IAI5C;;OAEG;IACI,IAAI,EAAE,OAAO,CAAC;IACrB;;OAEG;IACI,SAAS,SAAM;IACtB;;OAEG;IACI,YAAY,CAAC,EAAE,YAAY,CAAC;gBAIhB,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,UAAU,UAAQ;IAMpE;;;OAGG;WACW,oBAAoB,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,YAAY,GACzB,OAAO;CAQV"}
+{"version":3,"file":"ItemTapEvent.d.ts","sourceRoot":"","sources":["../../../src/kurot/events/ItemTapEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,KAAK;IAGnD,gBAAuB,QAAQ,aAAa;IAI5C;;OAEG;IACI,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACI,SAAS,SAAM;IACtB;;OAEG;IACI,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAI3B,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,UAAU,UAAQ;IAMpE;;;OAGG;WACW,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAC7C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,GAAG,SAAS,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,GACpC,OAAO;CAQV"}

package/dist/kurot/events/ItemTapEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ItemTapEvent.js","sourceRoot":"","sources":["../../../src/kurot/events/ItemTapEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAyB,MAAM,aAAa,CAAC;AAG3D;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACtC,yEAAyE;IAElE,MAAM,CAAU,QAAQ,GAAG,SAAS,CAAC;IAE5C,yEAAyE;IAEzE;;OAEG;IACI,IAAI,CAAU;IACrB;;OAEG;IACI,SAAS,GAAG,CAAC,CAAC,CAAC;IACtB;;OAEG;IACI,YAAY,CAAgB;IAEnC,yEAAyE;IAEzE,YAAmB,IAAY,EAAE,OAAO,GAAG,KAAK,EAAE,UAAU,GAAG,KAAK;QACnE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,yEAAyE;IAEzE;;;OAGG;IACI,MAAM,CAAC,oBAAoB,CACjC,MAAwB,EACxB,IAAa,EACb,SAAiB,EACjB,YAA2B;QAE3B,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACjE,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAChE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC,CAAC,YAAY,GAAG,YAAY,CAAC;QAC9B,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC"}
+{"version":3,"file":"ItemTapEvent.js","sourceRoot":"","sources":["../../../src/kurot/events/ItemTapEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAyB,MAAM,aAAa,CAAC;AAG3D;;GAEG;AACH,MAAM,OAAO,YAA0B,SAAQ,KAAK;IACnD,yEAAyE;IAElE,MAAM,CAAU,QAAQ,GAAG,SAAS,CAAC;IAE5C,yEAAyE;IAEzE;;OAEG;IACI,IAAI,CAAgB;IAC3B;;OAEG;IACI,SAAS,GAAG,CAAC,CAAC,CAAC;IACtB;;OAEG;IACI,YAAY,CAA2B;IAE9C,yEAAyE;IAEzE,YAAmB,IAAY,EAAE,OAAO,GAAG,KAAK,EAAE,UAAU,GAAG,KAAK;QACnE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,yEAAyE;IAEzE;;;OAGG;IACI,MAAM,CAAC,oBAAoB,CACjC,MAAwB,EACxB,IAAmB,EACnB,SAAiB,EACjB,YAAsC;QAEtC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACjE,MAAM,CAAC,GAAG,IAAI,YAAY,CAAI,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC,CAAC,YAAY,GAAG,YAAY,CAAC;QAC9B,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC"}

package/dist/kurot/events/TypedEventListeners.d.ts

@@ -0,0 +1,14 @@
+import type { Event, EventMap } from '@kurot/core';
+/**
+ * Type-only listener signatures for native UI objects. Declaring these on a
+ * subclass refines event payloads without replacing Core's listener machinery.
+ */
+export interface TypedEventListeners<TEvents extends EventMap> {
+    addEventListener<K extends keyof TEvents & string>(type: K, listener: (event: TEvents[K]) => void, useCapture?: boolean, priority?: number): void;
+    addEventListener(type: string, listener: (event: Event) => void, useCapture?: boolean, priority?: number): void;
+    once<K extends keyof TEvents & string>(type: K, listener: (event: TEvents[K]) => void, useCapture?: boolean, priority?: number): void;
+    once(type: string, listener: (event: Event) => void, useCapture?: boolean, priority?: number): void;
+    removeEventListener<K extends keyof TEvents & string>(type: K, listener: (event: TEvents[K]) => void, useCapture?: boolean): void;
+    removeEventListener(type: string, listener: (event: Event) => void, useCapture?: boolean): void;
+}
+//# sourceMappingURL=TypedEventListeners.d.ts.map

package/dist/kurot/events/TypedEventListeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedEventListeners.d.ts","sourceRoot":"","sources":["../../../src/kurot/events/TypedEventListeners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,QAAQ;IAC5D,gBAAgB,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAChD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACrC,UAAU,CAAC,EAAE,OAAO,EACpB,QAAQ,CAAC,EAAE,MAAM,GACf,IAAI,CAAC;IACR,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EACpC,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACrC,UAAU,CAAC,EAAE,OAAO,EACpB,QAAQ,CAAC,EAAE,MAAM,GACf,IAAI,CAAC;IACR,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpG,mBAAmB,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EACnD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACrC,UAAU,CAAC,EAAE,OAAO,GAClB,IAAI,CAAC;IACR,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAChG"}

package/dist/kurot/events/TypedEventListeners.js

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

package/dist/kurot/events/TypedEventListeners.js.map

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

package/docs/ai-context.md

@@ -6,7 +6,7 @@ For local Skin/asset/font resolution or automatic radio-group isolation, read
 For game UI, read [standard authoring](ui-authoring.md) and the
 [ScoreHUD pair](recipes/score-hud.md). For API lookup, use
 [topics](api/topics.md) and the [symbol/member index](api/index.md).
-This maintainer map covers `@kurot/ui@4.0.0` (prepared for publication), with Core peer **^2.5.2**.
+This maintainer map covers `@kurot/ui@4.2.0` (prepared for publication), with Core peer **^2.5.2**.
 Inherited defaults follow the installed Core; set important alignment explicitly.
 Source and its public barrel define the current API.
 
@@ -122,6 +122,11 @@ skin)` signature, but `Group._commitCurrentState()` passes `this` cast
   Also: `source =` setter dispatches `RESET` (resets scroll position
   downstream in `DataGroup`); `replaceAll()` deliberately avoids that to
   preserve scroll position — called out in its own doc comment.
+- UI 4.2 adds item-data generics (default unknown) through collections,
+  lists and events. ItemRenderer keeps `TSkin` first, data second. Empty/sparse
+  values retain their native null/undefined behavior. Read
+  [typed list data](list-data-types.md) for null/undefined behavior. Declared typed
+  list fields in KUI hosts require CLI >= 4.1.1 within 4.x.
 - `Watcher`/`Binding` are **not automatically reactive**. They depend on the
   host manually dispatching `PropertyEvent.PROPERTY_CHANGE` in its setters
   (`PropertyEvent.dispatchPropertyEvent(this, 'propName')`). A property whose
@@ -224,6 +229,6 @@ BitmapLabel uses Core BitmapText and borrows a configured BitmapFont/resource.
 Superseded loads cannot overwrite a new font; asynchronous failures dispatch
 IO_ERROR. [BitmapLabel](bitmap-label.md) documents ownership and constraints.
 
-RichLabel is an independent Component with `textFlow`, not Label text/fitting
-properties. It owns copies of runs/styles, uses continuous wrapping and restores
+RichLabel is an independent Component with `textFlow` plus seven component
+typography defaults. It does not expose Label plain text, presets or fitting. It owns copies of runs/styles, uses continuous wrapping and restores
 whole-flow states. [RichLabel](rich-label.md) documents measurement and cleanup.

package/docs/api/AddItems-class/apply-method.md

@@ -1,6 +1,6 @@
 # apply
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 apply(host: Component, skin: Skin): void;

package/docs/api/AddItems-class/constructor-constructor.md

@@ -1,6 +1,6 @@
 # constructor
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 constructor(target: string, destination: string, position: number, propertyName: string);

package/docs/api/AddItems-class/destination-property.md

@@ -1,6 +1,6 @@
 # destination
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 destination: string;

package/docs/api/AddItems-class/position-property.md

@@ -1,6 +1,6 @@
 # position
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 position: number;

package/docs/api/AddItems-class/propertyName-property.md

@@ -1,6 +1,6 @@
 # propertyName
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 propertyName: string;

package/docs/api/AddItems-class/remove-method.md

@@ -1,6 +1,6 @@
 # remove
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 remove(host: Component, skin: Skin): void;

package/docs/api/AddItems-class/target-property.md

@@ -1,6 +1,6 @@
 # target
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 target: string;

package/docs/api/AddItems-class.md

@@ -1,6 +1,6 @@
 # AddItems
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 class AddItems implements IOverride

package/docs/api/Animation-class/constructor-constructor.md

@@ -1,6 +1,6 @@
 # constructor
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 constructor(updateFunction: (animation: Animation) => void, thisObject: unknown);

package/docs/api/Animation-class/currentValue-accessor.md

@@ -1,6 +1,6 @@
 # currentValue
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get currentValue(): number;

package/docs/api/Animation-class/duration-accessor.md

@@ -1,6 +1,6 @@
 # duration
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get duration(): number;

package/docs/api/Animation-class/easerFunction-accessor.md

@@ -1,6 +1,6 @@
 # easerFunction
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get easerFunction(): ((fraction: number) => number) | undefined;

package/docs/api/Animation-class/endFunction-accessor.md

@@ -1,6 +1,6 @@
 # endFunction
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get endFunction(): ((animation: Animation) => void) | undefined;

package/docs/api/Animation-class/from-accessor.md

@@ -1,6 +1,6 @@
 # from
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get from(): number;

package/docs/api/Animation-class/isPlaying-accessor.md

@@ -1,6 +1,6 @@
 # isPlaying
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get isPlaying(): boolean;

package/docs/api/Animation-class/play-method.md

@@ -1,6 +1,6 @@
 # play
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 play(): void;

package/docs/api/Animation-class/stop-method.md

@@ -1,6 +1,6 @@
 # stop
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 stop(): void;

package/docs/api/Animation-class/to-accessor.md

@@ -1,6 +1,6 @@
 # to
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get to(): number;

package/docs/api/Animation-class.md

@@ -1,6 +1,6 @@
 # Animation
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 class Animation

package/docs/api/ArrayCollection-class/addEventListener-method.md

@@ -1,14 +1,16 @@
 # addEventListener
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-addEventListener<K extends string>(type: K, listener: (event: ArrayCollectionEvents[K]) => void, useCapture?: boolean, priority?: number): void;
+addEventListener<K extends string>(type: K, listener: (event: ArrayCollectionEvents<T>[K]) => void, useCapture?: boolean, priority?: number): void;
 addEventListener(type: string, listener: (event: Event) => void, useCapture?: boolean, priority?: number): void;
 ```
 
 Inherited from `EventDispatcher.addEventListener`; shown with this receiver's substituted types.
 
+Observes typed collection mutations; other event names retain Core semantics.
+
 Adds a listener with this dispatcher as its event source. The same
 function/capture pair is registered once; larger priorities run first.
 Preserve the function identity to remove it when its owner is disposed.

package/docs/api/ArrayCollection-class/addItem-method.md

@@ -1,9 +1,9 @@
 # addItem
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-addItem(item: unknown): void;
+addItem(item: T): void;
 ```
 
 Append a borrowed item and synchronously dispatch ADD. Does not clone the item.

package/docs/api/ArrayCollection-class/addItemAt-method.md

@@ -1,9 +1,9 @@
 # addItemAt
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-addItemAt(item: unknown, index: number): void;
+addItemAt(item: T, index: number): void;
 ```
 
 Insert a borrowed item and dispatch ADD. Pass an integer index from 0 through

package/docs/api/ArrayCollection-class/constructor-constructor.md

@@ -1,9 +1,10 @@
 # constructor
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-constructor(source?: unknown[]);
+constructor(source: never[]);
+constructor(source?: T[]);
 ```
 
 Wrap an existing array without copying; omitted source creates an empty array.

package/docs/api/ArrayCollection-class/dispatchEvent-method.md

@@ -1,6 +1,6 @@
 # dispatchEvent
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 dispatchEvent(event: Event): boolean;

package/docs/api/ArrayCollection-class/dispatchEventWith-method.md

@@ -1,6 +1,6 @@
 # dispatchEventWith
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 dispatchEventWith(type: string, bubbles?: boolean, data?: unknown, cancelable?: boolean): boolean;

package/docs/api/ArrayCollection-class/filterFunction-method.md

@@ -1,9 +1,9 @@
 # filterFunction
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-filterFunction(testFn: (item: unknown) => boolean): void;
+filterFunction(testFn: (item: T) => boolean): void;
 ```
 
 Filter the collection in place, keeping only items that pass the test.

package/docs/api/ArrayCollection-class/getItemAt-method.md

@@ -1,9 +1,9 @@
 # getItemAt
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-getItemAt(index: number): unknown;
+getItemAt(index: number): T | undefined;
 ```
 
 Read a 0-based item index; absent indices return undefined rather than throwing.

package/docs/api/ArrayCollection-class/getItemIndex-method.md

@@ -1,9 +1,9 @@
 # getItemIndex
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-getItemIndex(item: unknown): number;
+getItemIndex(item: T | undefined): number;
 ```
 
 Return the first identity/equality match index, or -1 when the item is absent.

package/docs/api/ArrayCollection-class/hasEventListener-method.md

@@ -1,6 +1,6 @@
 # hasEventListener
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 hasEventListener(type: string): boolean;

package/docs/api/ArrayCollection-class/itemUpdated-method.md

@@ -1,9 +1,9 @@
 # itemUpdated
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-itemUpdated(item: unknown): void;
+itemUpdated(item: T): void;
 ```
 
 Dispatch UPDATE for an existing item's first matching index. Missing items are

package/docs/api/ArrayCollection-class/length-accessor.md

@@ -1,6 +1,6 @@
 # length
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get length(): number;

package/docs/api/ArrayCollection-class/notifyListener-method.md

@@ -1,6 +1,6 @@
 # notifyListener
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 protected notifyListener(event: Event, capturePhase: boolean): boolean;

package/docs/api/ArrayCollection-class/once-method.md

@@ -1,14 +1,16 @@
 # once
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-once<K extends string>(type: K, listener: (event: ArrayCollectionEvents[K]) => void, useCapture?: boolean, priority?: number): void;
+once<K extends string>(type: K, listener: (event: ArrayCollectionEvents<T>[K]) => void, useCapture?: boolean, priority?: number): void;
 once(type: string, listener: (event: Event) => void, useCapture?: boolean, priority?: number): void;
 ```
 
 Inherited from `EventDispatcher.once`; shown with this receiver's substituted types.
 
+Observes one mutation using Core's existing once-listener behavior.
+
 Registers a listener that removes itself after notification. If its owner
 closes before the event occurs, remove it explicitly using the same
 callback and capture phase.

package/docs/api/ArrayCollection-class/refresh-method.md

@@ -1,6 +1,6 @@
 # refresh
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 refresh(): void;

package/docs/api/ArrayCollection-class/removeAll-method.md

@@ -1,6 +1,6 @@
 # removeAll
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
 removeAll(): void;

package/docs/api/ArrayCollection-class/removeEventListener-method.md

@@ -1,14 +1,16 @@
 # removeEventListener
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-removeEventListener<K extends string>(type: K, listener: (event: ArrayCollectionEvents[K]) => void, useCapture?: boolean): void;
+removeEventListener<K extends string>(type: K, listener: (event: ArrayCollectionEvents<T>[K]) => void, useCapture?: boolean): void;
 removeEventListener(type: string, listener: (event: Event) => void, useCapture?: boolean): void;
 ```
 
 Inherited from `EventDispatcher.removeEventListener`; shown with this receiver's substituted types.
 
+Removes the matching listener and capture phase without dispatching events.
+
 Removes the matching event type, function identity and capture phase.
 Missing listeners are harmless; a newly created bound function does not
 match the original callback.

package/docs/api/ArrayCollection-class/removeItemAt-method.md

@@ -1,9 +1,9 @@
 # removeItemAt
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-removeItemAt(index: number): unknown;
+removeItemAt(index: number): T | undefined;
 ```
 
 Remove and return an item, dispatching REMOVE without disposing it. Pass an

package/docs/api/ArrayCollection-class/replaceAll-method.md

@@ -1,9 +1,9 @@
 # replaceAll
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-replaceAll(newSource: unknown[]): void;
+replaceAll(newSource: T[]): void;
 ```
 
 Replace all items with a new source. Unlike setting `source`, this does

package/docs/api/ArrayCollection-class/replaceItemAt-method.md

@@ -1,9 +1,9 @@
 # replaceItemAt
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-replaceItemAt(item: unknown, index: number): unknown;
+replaceItemAt(item: T, index: number): T | undefined;
 ```
 
 Replace an item, return the previous item and dispatch REPLACE. Neither item

package/docs/api/ArrayCollection-class/sort-method.md

@@ -1,9 +1,9 @@
 # sort
 
-Package: `@kurot/ui@4.0.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
 
 ```ts
-sort(compareFunction: (a: unknown, b: unknown) => number): void;
+sort(compareFunction: (a: T, b: T) => number): void;
 ```
 
 Sort the collection in place using a comparator function.