@kurot/ui 1.1.12 → 2.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 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.
 
-> **Stable (1.1.9).** Requires `@kurot/core@^1.0.12`. Targets ES2022 + evergreen browsers, same as core.
+> **Current release: 2.1.0.** Requires `@kurot/core@^1.0.12`. Targets ES2022 + evergreen browsers, same as core.
 
 For the full list of changes in this release, see [CHANGELOG.md](./CHANGELOG.md).
 
@@ -77,24 +77,94 @@ invalidateProperties / invalidateSize / invalidateDisplayList
 ### Skin system
 
 ```ts
-import { Skin, State, SetProperty } from '@kurot/ui';
+import { Rect, Skin, State, SetProperty } from '@kurot/ui';
 
 class MyButtonSkin extends Skin {
+	public bg: Rect;
+
 	constructor() {
 		super();
-		this.skinParts = ['labelDisplay'];
+
+		this.bg = new Rect(120, 36, 0x6c5ce7);
+		this.skinParts = ['bg'];
+		this.elementsContent = [this.bg];
 		this.states = [
 			new State('up'),
 			new State('down', [new SetProperty('bg', 'fillColor', 0x5a4bd1)]),
 			new State('disabled', [new SetProperty('bg', 'fillColor', 0x636e72)]),
 		];
-		// build visual children...
 	}
 }
 
 btn.skinName = MyButtonSkin;
 ```
 
+### Typed skin parts and lifecycle
+
+UI 2.0 attaches a skin atomically. The complete part set is available in
+`onSkinReady()` and remains available through `onSkinRemoved()`. Accessing
+`skinParts` outside that interval throws, which prevents code from silently
+using a partial or stale skin.
+
+The Kurot CLI generates `SkinPartsMap` entries and narrows the public
+`skinParts` accessor on project classes. It resolves explicit string-literal
+`skinName` assignments, configured reusable-component pairs, and unambiguous
+`<ClassName>Skin` naming conventions. The runtime skin name remains the source
+of truth whenever it is assigned explicitly:
+
+```ts
+import { TouchEvent } from '@kurot/core';
+import { Component } from '@kurot/ui';
+
+export class ConfirmPanel extends Component {
+	public constructor() {
+		super();
+		this.skinName = 'game.ui.ConfirmPanelSkin';
+	}
+
+	protected override onSkinReady(): void {
+		super.onSkinReady();
+		this.skinParts.btnConfirm.addEventListener(
+			TouchEvent.TOUCH_TAP,
+			this.onConfirm,
+		);
+		this.skinParts.lblMessage.text = 'Continue?';
+	}
+
+	protected override onSkinRemoved(): void {
+		this.skinParts.btnConfirm.removeEventListener(
+			TouchEvent.TOUCH_TAP,
+			this.onConfirm,
+		);
+		super.onSkinRemoved();
+	}
+
+	private onConfirm = (): void => {
+		// Handle confirmation.
+	};
+}
+```
+
+Library code without CLI-generated host declarations can still select a shape
+explicitly with `Component<'game.ui.ConfirmPanelSkin'>` or
+`ItemRenderer<'game.ui.ConfirmItemSkin'>`. `skinParts` is the only public,
+read-only part view, so component subclasses, mediators, and composition code
+use the same API.
+
+When a CLI project has exactly one compiled `<ClassName>Skin` candidate, the
+generated host declaration also covers skins supplied externally by a Theme or
+List. An `ItemRenderer` named `MultiplierIR` can therefore use
+`this.skinParts` without repeating `ui.MultiplierIRSkin` in its base type.
+
+Use `onSkinReady()` only for work that requires skin parts. Keep ordinary
+one-time component initialization in `createChildren()`. Remove listeners and
+other bindings created for a skin in `onSkinRemoved()` so replacing a skin
+cannot retain stale objects.
+
+The old incremental APIs `setSkinPart()`, `partAdded()`, and `partRemoved()`
+were removed in 2.0. Skin part names are no longer copied onto the component as
+dynamic properties; use `this.skinParts.<name>` during the ready lifecycle.
+
 ## Components
 
 ### Basic Controls
@@ -297,6 +367,8 @@ cross-framework ranking.
 | Component base | `namespace` + `mixin`       | Standard class inheritance           |
 | Layout state   | Prototype-injected          | `UIState` delegation                 |
 | EXML runtime   | Built-in parser             | Compile-time only (`@kurot/cli`)   |
+| Skin parts     | Incremental dynamic fields  | Atomic typed `skinParts`             |
+| Skin lifecycle | `partAdded` / `partRemoved` | `onSkinReady` / `onSkinRemoved`      |
 | `thisObject`   | Required in event listeners | Not needed — use arrow functions     |
 | Virtual layout | Default on                  | Opt-in via `useVirtualLayout = true` |
 | i18n           | Built-in                    | Not supported                        |

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

@@ -1,8 +1,8 @@
 import { Component } from './Component.js';
 import type { Texture } from '@kurot/core';
 import type { IDisplayText } from '../core/IDisplayText.js';
-import type { Image } from './Image.js';
-import type { Label } from './Label.js';
+import { Image } from './Image.js';
+import { Label } from './Label.js';
 /**
  * Button component with label, icon, and state management.
  *
@@ -34,8 +34,9 @@ export declare class Button extends Component implements IDisplayText {
     get touchCaptured(): boolean;
     get enabled(): boolean;
     set enabled(value: boolean);
-    partAdded(partName: string, instance: unknown): void;
     $onRemoveFromStage(): void;
+    protected onSkinReady(): void;
+    protected onSkinRemoved(): void;
     /**
      * Return the current view state, layering the selected state on top of
      * the base up/down/disabled states.

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

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC;;;;;;;GAOG;AACH,qBAAa,MAAO,SAAQ,SAAU,YAAW,YAAY;IAGrD,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC;IAE3B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,mBAAmB,CAAS;;IAYpC,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAK7B;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,IAAI,MAAM,GAAG,OAAO,GAAG,SAAS,CAE9C;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EAKlD;IAED,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAKjC;IAED,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,EAE/B;IAED,IAAW,aAAa,IAAI,OAAO,CAElC;IAED,IAAoB,OAAO,IAAI,OAAO,CAErC;IAED,IAAoB,OAAO,CAAC,KAAK,EAAE,OAAO,EAIzC;IAIe,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IASpD,kBAAkB,IAAI,IAAI;IAK1C;;;;;;;;OAQG;cACgB,eAAe,IAAI,MAAM;IAoB5C;;;;OAIG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAYhC,OAAO,CAAC,aAAa,CAUnB;IAEF,OAAO,CAAC,gBAAgB,CAQtB;IAEF,OAAO,CAAC,cAAc,CAEpB;IAEF,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,mBAAmB;CAK3B"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC;;;;;;;GAOG;AACH,qBAAa,MAAO,SAAQ,SAAU,YAAW,YAAY;IAGrD,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC;IAE3B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,mBAAmB,CAAS;;IAYpC,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAK7B;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,IAAI,MAAM,GAAG,OAAO,GAAG,SAAS,CAE9C;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EAKlD;IAED,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAKjC;IAED,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,EAE/B;IAED,IAAW,aAAa,IAAI,OAAO,CAElC;IAED,IAAoB,OAAO,IAAI,OAAO,CAErC;IAED,IAAoB,OAAO,CAAC,KAAK,EAAE,OAAO,EAIzC;IAIe,kBAAkB,IAAI,IAAI;cAOvB,WAAW,IAAI,IAAI;cAanB,aAAa,IAAI,IAAI;IAMxC;;;;;;;;OAQG;cACgB,eAAe,IAAI,MAAM;IAkB5C;;;;OAIG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAYhC,OAAO,CAAC,aAAa,CAUnB;IAEF,OAAO,CAAC,gBAAgB,CAQtB;IAEF,OAAO,CAAC,cAAc,CAEpB;IAEF,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,mBAAmB;CAK3B"}

package/dist/kurot/components/Button.js

@@ -1,5 +1,7 @@
 import { Component } from './Component.js';
 import { Event, TouchEvent, DisplayObject } from '@kurot/core';
+import { Image } from './Image.js';
+import { Label } from './Label.js';
 import { PropertyEvent } from '../events/PropertyEvent.js';
 /**
  * Button component with label, icon, and state management.
@@ -77,19 +79,28 @@ export class Button extends Component {
         this.invalidateState();
     }
     // ── Override methods ──────────────────────────────────────────────────
-    partAdded(partName, instance) {
-        super.partAdded(partName, instance);
-        if (partName === 'labelDisplay' && this.labelDisplay) {
-            this.labelDisplay.text = this._label;
-        }
-        else if (partName === 'iconDisplay' && this.iconDisplay) {
-            this.iconDisplay.source = this._icon;
-        }
-    }
     $onRemoveFromStage() {
         this._cancelTouchCapture();
         super.$onRemoveFromStage();
     }
+    // ── Protected methods ─────────────────────────────────────────────────
+    onSkinReady() {
+        super.onSkinReady();
+        const { labelDisplay, iconDisplay } = this.skinParts;
+        if (labelDisplay instanceof Label) {
+            this.labelDisplay = labelDisplay;
+            labelDisplay.text = this._label;
+        }
+        if (iconDisplay instanceof Image) {
+            this.iconDisplay = iconDisplay;
+            iconDisplay.source = this._icon;
+        }
+    }
+    onSkinRemoved() {
+        this.labelDisplay = undefined;
+        this.iconDisplay = undefined;
+        super.onSkinRemoved();
+    }
     /**
      * Return the current view state, layering the selected state on top of
      * the base up/down/disabled states.
@@ -118,7 +129,6 @@ export class Button extends Component {
             return selectedState;
         return state === 'disabled' ? 'disabled' : 'down';
     }
-    // ── Protected methods ─────────────────────────────────────────────────
     /**
      * Called when the user taps the button (touch ends within the button bounds).
      * Subclasses should override this to perform the button action.

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

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

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

@@ -3,8 +3,8 @@ import { List } from './List.js';
 import { Scroller } from './Scroller.js';
 import type { ArrayCollection } from '../collections/ArrayCollection.js';
 import type { IDisplayText } from '../core/IDisplayText.js';
-import type { Button } from './Button.js';
-import type { Label } from './Label.js';
+import { Button } from './Button.js';
+import { Label } from './Label.js';
 /**
  * ComboBox — a drop-down selection component.
  *
@@ -37,16 +37,24 @@ export declare class ComboBox extends Component implements IDisplayText {
     private _dropDownParentIndex;
     private _dropDownLocalMatrix?;
     constructor();
-    /** The data provider for the drop-down list items. */
+    /**
+     * The data provider for the drop-down list items.
+     */
     get dataProvider(): ArrayCollection | undefined;
     set dataProvider(value: ArrayCollection | undefined);
-    /** Index of the currently selected item, or -1 if nothing is selected. */
+    /**
+     * Index of the currently selected item, or `-1` if nothing is selected.
+     */
     get selectedIndex(): number;
     set selectedIndex(value: number);
-    /** The currently selected data item. */
+    /**
+     * The currently selected data item.
+     */
     get selectedItem(): unknown;
     set selectedItem(value: unknown);
-    /** Whether the drop-down list is currently visible. */
+    /**
+     * Whether the drop-down list is currently visible.
+     */
     get isOpen(): boolean;
     set isOpen(value: boolean);
     /**
@@ -61,30 +69,40 @@ export declare class ComboBox extends Component implements IDisplayText {
      */
     get labelFunction(): ((item: unknown) => string) | undefined;
     set labelFunction(value: ((item: unknown) => string) | undefined);
-    /** Placeholder text shown when no item is selected. */
+    /**
+     * Placeholder text shown when no item is selected.
+     */
     get prompt(): string;
     set prompt(value: string);
-    /** The displayed text (selected item label or prompt). */
+    /**
+     * The displayed text, either the selected item label or the prompt.
+     */
     get text(): string;
     get textColor(): number;
     set textColor(value: number);
-    protected getCurrentState(): string;
-    partAdded(partName: string, instance: unknown): void;
-    partRemoved(partName: string, instance: unknown): void;
     $onRemoveFromStage(): void;
     commitProperties(): void;
-    /** Open the drop-down list. */
+    /**
+     * Open the drop-down list.
+     */
     open(): void;
-    /** Close the drop-down list. */
+    /**
+     * Close the drop-down list.
+     */
     close(): void;
     /**
      * Convert a data item to a label string using `labelFunction` or `labelField`.
      */
     itemToLabel(item: unknown): string;
+    protected onSkinReady(): void;
+    protected onSkinRemoved(): void;
+    protected getCurrentState(): string;
     private _updateSelectedItem;
     private _updateLabel;
     private _updateDisplayOrder;
-    /** Move only the popup to the stage so layout siblings cannot cover it. */
+    /**
+     * Move only the popup to the stage so layout siblings cannot cover it.
+     */
     private _moveDropDownToStage;
     private _restoreDropDownParent;
     private _onTriggerTap;

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

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

package/dist/kurot/components/ComboBox.js

@@ -2,6 +2,8 @@ import { TouchEvent, Event, DisplayObject } from '@kurot/core';
 import { Component } from './Component.js';
 import { List } from './List.js';
 import { Scroller } from './Scroller.js';
+import { Button } from './Button.js';
+import { Label } from './Label.js';
 /**
  * ComboBox — a drop-down selection component.
  *
@@ -41,7 +43,9 @@ export class ComboBox extends Component {
         this.addEventListener(TouchEvent.TOUCH_TAP, this._onTriggerTap);
     }
     // ── Getters / Setters ─────────────────────────────────────────────────
-    /** The data provider for the drop-down list items. */
+    /**
+     * The data provider for the drop-down list items.
+     */
     get dataProvider() {
         return this._dataProvider;
     }
@@ -54,7 +58,9 @@ export class ComboBox extends Component {
         }
         this.invalidateProperties();
     }
-    /** Index of the currently selected item, or -1 if nothing is selected. */
+    /**
+     * Index of the currently selected item, or `-1` if nothing is selected.
+     */
     get selectedIndex() {
         return this._selectedIndex;
     }
@@ -65,7 +71,9 @@ export class ComboBox extends Component {
         this._updateSelectedItem();
         this.invalidateState();
     }
-    /** The currently selected data item. */
+    /**
+     * The currently selected data item.
+     */
     get selectedItem() {
         return this._selectedItem;
     }
@@ -81,7 +89,9 @@ export class ComboBox extends Component {
             this.invalidateState();
         }
     }
-    /** Whether the drop-down list is currently visible. */
+    /**
+     * Whether the drop-down list is currently visible.
+     */
     get isOpen() {
         return this._isOpen;
     }
@@ -121,7 +131,9 @@ export class ComboBox extends Component {
         this._labelFunction = value;
         this._updateLabel();
     }
-    /** Placeholder text shown when no item is selected. */
+    /**
+     * Placeholder text shown when no item is selected.
+     */
     get prompt() {
         return this._prompt;
     }
@@ -131,7 +143,9 @@ export class ComboBox extends Component {
             this.labelDisplay.text = value;
         }
     }
-    /** The displayed text (selected item label or prompt). */
+    /**
+     * The displayed text, either the selected item label or the prompt.
+     */
     get text() {
         if (this.labelDisplay)
             return this.labelDisplay.text;
@@ -146,35 +160,6 @@ export class ComboBox extends Component {
         }
     }
     // ── Override methods ──────────────────────────────────────────────────
-    getCurrentState() {
-        if (!this.enabled)
-            return 'disabled';
-        if (this._isOpen)
-            return 'open';
-        return 'normal';
-    }
-    partAdded(partName, instance) {
-        super.partAdded(partName, instance);
-        if (partName === 'labelDisplay' && instance === this.labelDisplay) {
-            this._updateLabel();
-        }
-        if (partName === 'list' && instance instanceof List) {
-            instance.dataProvider = this._dataProvider;
-            instance.addEventListener(Event.CHANGE, this._onListChange);
-        }
-        if (partName === 'dropDown' && instance instanceof Scroller) {
-            instance.visible = this._isOpen;
-        }
-    }
-    partRemoved(partName, instance) {
-        if (partName === 'dropDown' && instance === this.dropDown) {
-            this.close();
-        }
-        super.partRemoved(partName, instance);
-        if (partName === 'list' && instance instanceof List) {
-            instance.removeEventListener(Event.CHANGE, this._onListChange);
-        }
-    }
     $onRemoveFromStage() {
         this.close();
         super.$onRemoveFromStage();
@@ -187,11 +172,15 @@ export class ComboBox extends Component {
         }
     }
     // ── Public methods ────────────────────────────────────────────────────
-    /** Open the drop-down list. */
+    /**
+     * Open the drop-down list.
+     */
     open() {
         this.isOpen = true;
     }
-    /** Close the drop-down list. */
+    /**
+     * Close the drop-down list.
+     */
     close() {
         this.isOpen = false;
     }
@@ -213,6 +202,45 @@ export class ComboBox extends Component {
         }
         return String(item);
     }
+    // ── Protected methods ─────────────────────────────────────────────────
+    onSkinReady() {
+        super.onSkinReady();
+        const { labelDisplay, button, list, dropDown } = this.skinParts;
+        if (labelDisplay instanceof Label) {
+            this.labelDisplay = labelDisplay;
+            this._updateLabel();
+        }
+        if (button instanceof Button) {
+            this.button = button;
+        }
+        if (list instanceof List) {
+            this.list = list;
+            list.dataProvider = this._dataProvider;
+            list.addEventListener(Event.CHANGE, this._onListChange);
+        }
+        if (dropDown instanceof Scroller) {
+            this.dropDown = dropDown;
+            dropDown.visible = this._isOpen;
+        }
+    }
+    onSkinRemoved() {
+        if (this.dropDown) {
+            this.close();
+        }
+        this.list?.removeEventListener(Event.CHANGE, this._onListChange);
+        this.labelDisplay = undefined;
+        this.button = undefined;
+        this.list = undefined;
+        this.dropDown = undefined;
+        super.onSkinRemoved();
+    }
+    getCurrentState() {
+        if (!this.enabled)
+            return 'disabled';
+        if (this._isOpen)
+            return 'open';
+        return 'normal';
+    }
     // ── Private methods ───────────────────────────────────────────────────
     _updateSelectedItem() {
         if (this._dataProvider && this._selectedIndex >= 0 && this._selectedIndex < this._dataProvider.length) {
@@ -257,7 +285,9 @@ export class ComboBox extends Component {
             this._openParentIndex = -1;
         }
     }
-    /** Move only the popup to the stage so layout siblings cannot cover it. */
+    /**
+     * Move only the popup to the stage so layout siblings cannot cover it.
+     */
     _moveDropDownToStage() {
         const dropDown = this.dropDown;
         const stage = this.stage;

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

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

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

@@ -19,16 +19,28 @@ export interface ComponentEvents extends DisplayObjectEvents {
     [UIEvent.CLOSING]: UIEvent;
     [UIEvent.MOVE]: UIEvent;
 }
+/**
+ * Project-generated skin part declarations augment this interface.
+ *
+ * Each key is a skin class name and each value is the exact set of parts
+ * exported by that skin.
+ */
+export interface SkinPartsMap {
+}
+/**
+ * Resolve the generated skin parts for a skin class name.
+ */
+export type SkinPartsOf<TSkin extends string> = TSkin extends keyof SkinPartsMap ? SkinPartsMap[TSkin] : Readonly<Record<string, unknown>>;
 /**
  * Base class for all skinnable UI components.
  *
  * Subclasses should:
  * 1. Override `getCurrentState()` to return the current view-state name.
- * 2. Override `partAdded()` to bind skin parts to component logic.
- * 3. Override `partRemoved()` to clean up skin part bindings.
+ * 2. Override `onSkinReady()` for setup that needs the complete skin.
+ * 3. Override `onSkinRemoved()` to clean up complete-skin bindings.
  * 4. Override `createChildren()` to perform one-time initialization.
  */
-export declare class Component extends Sprite implements IUIComponent, ILayoutTarget, IUIOwner {
+export declare class Component<TSkin extends string = string> extends Sprite implements IUIComponent, ILayoutTarget, IUIOwner {
     readonly ui: UIState;
     skinNameExplicitlySet: boolean;
     private _hostComponentKey?;
@@ -39,6 +51,8 @@ export declare class Component extends Sprite implements IUIComponent, ILayoutTa
     private _explicitTouchChildren;
     private _explicitState;
     private _stateIsDirty;
+    private _skinReady;
+    private _skinParts;
     constructor();
     /**
      * Key used to look up the default skin in the active Theme.
@@ -117,12 +131,14 @@ export declare class Component extends Sprite implements IUIComponent, ILayoutTa
     set scrollH(_v: number);
     get scrollV(): number;
     set scrollV(_v: number);
-    _applySkinName(skinName: string): void;
     /**
-     * Bind a skin part instance to this component.
-     * Called automatically when a skin is attached.
+     * Parts exported by the attached skin.
+     *
+     * Access is only valid after the skin has completed attachment. Generated
+     * declarations provide the exact part names and types for known skins.
      */
-    setSkinPart(partName: string, instance: unknown): void;
+    get skinParts(): Readonly<SkinPartsOf<TSkin>>;
+    _applySkinName(skinName: string): void;
     /**
      * Whether the display object receives touch events.
      *
@@ -167,17 +183,19 @@ export declare class Component extends Sprite implements IUIComponent, ILayoutTa
     commitProperties(): void;
     measure(): void;
     updateDisplayList(w: number, h: number): void;
+    /**
+     * Whether all parts for the current skin have been attached.
+     */
+    protected get skinReady(): boolean;
     protected setSkin(skin: Skin | undefined): void;
     /**
-     * Called when a skin part is added. Override to bind event listeners
-     * or apply cached property values to the part.
+     * Called after the complete skin and all of its parts have been attached.
      */
-    protected partAdded(_partName: string, _instance: unknown): void;
+    protected onSkinReady(): void;
     /**
-     * Called when a skin part is removed. Override to clean up listeners
-     * and cached references.
+     * Called before the current skin and its complete part set are detached.
      */
-    protected partRemoved(_partName: string, _instance: unknown): void;
+    protected onSkinRemoved(): void;
     /**
      * Return the current view-state name. Override in subclasses.
      */