@kurot/ui 1.1.7

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

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

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

@@ -0,0 +1,11 @@
+import { ToggleButton } from './ToggleButton.js';
+/**
+ * CheckBox component — a toggle button typically rendered with a checkmark.
+ * Functionally identical to ToggleButton; the visual difference comes from the skin/theme.
+ *
+ * States: same as Button (`up`, `down`, `disabled`, `upAndSelected`, `downAndSelected`, `disabledAndSelected`).
+ */
+export declare class CheckBox extends ToggleButton {
+    constructor();
+}
+//# sourceMappingURL=CheckBox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CheckBox.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/CheckBox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,YAAY;;CAIzC"}

package/dist/kurot/components/CheckBox.js

@@ -0,0 +1,13 @@
+import { ToggleButton } from './ToggleButton.js';
+/**
+ * CheckBox component — a toggle button typically rendered with a checkmark.
+ * Functionally identical to ToggleButton; the visual difference comes from the skin/theme.
+ *
+ * States: same as Button (`up`, `down`, `disabled`, `upAndSelected`, `downAndSelected`, `disabledAndSelected`).
+ */
+export class CheckBox extends ToggleButton {
+    constructor() {
+        super();
+    }
+}
+//# sourceMappingURL=CheckBox.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CheckBox.js","sourceRoot":"","sources":["../../../src/kurot/components/CheckBox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IACzC;QACC,KAAK,EAAE,CAAC;IACT,CAAC;CACD"}

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

@@ -0,0 +1,93 @@
+import { Component } from './Component.js';
+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';
+/**
+ * ComboBox — a drop-down selection component.
+ *
+ * Displays a trigger button showing the currently selected item's label,
+ * and a drop-down list that appears when the trigger is tapped.
+ *
+ * @skinPart labelDisplay — Label showing the selected item label
+ * @skinPart button        — the trigger Button that toggles the drop-down
+ * @skinPart dropDown      — the drop-down container (typically a Scroller or Group)
+ * @skinPart list          — the List inside the drop-down for item selection
+ *
+ * States: `normal`, `open`, `disabled`.
+ *
+ * @defaultProperty dataProvider
+ */
+export declare class ComboBox extends Component implements IDisplayText {
+    labelDisplay?: Label;
+    button?: Button;
+    dropDown?: Scroller;
+    list?: List;
+    private _dataProvider?;
+    private _selectedIndex;
+    private _selectedItem;
+    private _labelField;
+    private _labelFunction?;
+    private _isOpen;
+    private _prompt;
+    private _openParentIndex;
+    private _dropDownParent?;
+    private _dropDownParentIndex;
+    private _dropDownLocalMatrix?;
+    constructor();
+    /** 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. */
+    get selectedIndex(): number;
+    set selectedIndex(value: number);
+    /** The currently selected data item. */
+    get selectedItem(): unknown;
+    set selectedItem(value: unknown);
+    /** Whether the drop-down list is currently visible. */
+    get isOpen(): boolean;
+    set isOpen(value: boolean);
+    /**
+     * The property name on data items to use as the label.
+     * Defaults to `'label'`. Used when `labelFunction` is not set.
+     */
+    get labelField(): string;
+    set labelField(value: string);
+    /**
+     * A function that converts a data item to a display string.
+     * When set, this takes priority over `labelField`.
+     */
+    get labelFunction(): ((item: unknown) => string) | undefined;
+    set labelFunction(value: ((item: unknown) => string) | undefined);
+    /** Placeholder text shown when no item is selected. */
+    get prompt(): string;
+    set prompt(value: string);
+    /** The displayed text (selected item label or 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(): void;
+    /** Close the drop-down list. */
+    close(): void;
+    /**
+     * Convert a data item to a label string using `labelFunction` or `labelField`.
+     */
+    itemToLabel(item: unknown): string;
+    private _updateSelectedItem;
+    private _updateLabel;
+    private _updateDisplayOrder;
+    /** Move only the popup to the stage so layout siblings cannot cover it. */
+    private _moveDropDownToStage;
+    private _restoreDropDownParent;
+    private _onTriggerTap;
+    private _onListChange;
+}
+//# sourceMappingURL=ComboBox.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,307 @@
+import { TouchEvent, Event, DisplayObject } from '@kurot/core';
+import { Component } from './Component.js';
+import { List } from './List.js';
+import { Scroller } from './Scroller.js';
+/**
+ * ComboBox — a drop-down selection component.
+ *
+ * Displays a trigger button showing the currently selected item's label,
+ * and a drop-down list that appears when the trigger is tapped.
+ *
+ * @skinPart labelDisplay — Label showing the selected item label
+ * @skinPart button        — the trigger Button that toggles the drop-down
+ * @skinPart dropDown      — the drop-down container (typically a Scroller or Group)
+ * @skinPart list          — the List inside the drop-down for item selection
+ *
+ * States: `normal`, `open`, `disabled`.
+ *
+ * @defaultProperty dataProvider
+ */
+export class ComboBox extends Component {
+    // ── Instance fields ───────────────────────────────────────────────────
+    labelDisplay;
+    button;
+    dropDown;
+    list;
+    _dataProvider;
+    _selectedIndex = -1;
+    _selectedItem;
+    _labelField = 'label';
+    _labelFunction;
+    _isOpen = false;
+    _prompt = '';
+    _openParentIndex = -1;
+    _dropDownParent;
+    _dropDownParentIndex = -1;
+    _dropDownLocalMatrix;
+    // ── Constructor ───────────────────────────────────────────────────────
+    constructor() {
+        super();
+        this.touchChildren = true;
+        this.addEventListener(TouchEvent.TOUCH_TAP, this._onTriggerTap);
+    }
+    // ── Getters / Setters ─────────────────────────────────────────────────
+    /** The data provider for the drop-down list items. */
+    get dataProvider() {
+        return this._dataProvider;
+    }
+    set dataProvider(value) {
+        if (this._dataProvider === value)
+            return;
+        this._dataProvider = value;
+        if (this.list) {
+            this.list.dataProvider = value;
+        }
+        this.invalidateProperties();
+    }
+    /** Index of the currently selected item, or -1 if nothing is selected. */
+    get selectedIndex() {
+        return this._selectedIndex;
+    }
+    set selectedIndex(value) {
+        if (this._selectedIndex === value)
+            return;
+        this._selectedIndex = value;
+        this._updateSelectedItem();
+        this.invalidateState();
+    }
+    /** The currently selected data item. */
+    get selectedItem() {
+        return this._selectedItem;
+    }
+    set selectedItem(value) {
+        if (this._selectedItem === value)
+            return;
+        if (this._dataProvider) {
+            this.selectedIndex = this._dataProvider.getItemIndex(value);
+        }
+        else {
+            this._selectedItem = value;
+            this._updateLabel();
+            this.invalidateState();
+        }
+    }
+    /** Whether the drop-down list is currently visible. */
+    get isOpen() {
+        return this._isOpen;
+    }
+    set isOpen(value) {
+        if (this._isOpen === value)
+            return;
+        this._isOpen = value;
+        this._updateDisplayOrder(value);
+        this.invalidateState();
+        if (this.dropDown) {
+            this.dropDown.visible = value;
+        }
+    }
+    /**
+     * The property name on data items to use as the label.
+     * Defaults to `'label'`. Used when `labelFunction` is not set.
+     */
+    get labelField() {
+        return this._labelField;
+    }
+    set labelField(value) {
+        if (this._labelField === value)
+            return;
+        this._labelField = value;
+        this._updateLabel();
+    }
+    /**
+     * A function that converts a data item to a display string.
+     * When set, this takes priority over `labelField`.
+     */
+    get labelFunction() {
+        return this._labelFunction;
+    }
+    set labelFunction(value) {
+        if (this._labelFunction === value)
+            return;
+        this._labelFunction = value;
+        this._updateLabel();
+    }
+    /** Placeholder text shown when no item is selected. */
+    get prompt() {
+        return this._prompt;
+    }
+    set prompt(value) {
+        this._prompt = value;
+        if (!this._selectedItem && this.labelDisplay) {
+            this.labelDisplay.text = value;
+        }
+    }
+    /** The displayed text (selected item label or prompt). */
+    get text() {
+        if (this.labelDisplay)
+            return this.labelDisplay.text;
+        return this.itemToLabel(this._selectedItem);
+    }
+    get textColor() {
+        return this.labelDisplay?.textColor ?? 0;
+    }
+    set textColor(value) {
+        if (this.labelDisplay) {
+            this.labelDisplay.textColor = value;
+        }
+    }
+    // ── 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();
+    }
+    commitProperties() {
+        super.commitProperties();
+        // Sync selectedIndex → list
+        if (this.list && this.list.selectedIndex !== this._selectedIndex) {
+            this.list.selectedIndex = this._selectedIndex;
+        }
+    }
+    // ── Public methods ────────────────────────────────────────────────────
+    /** Open the drop-down list. */
+    open() {
+        this.isOpen = true;
+    }
+    /** Close the drop-down list. */
+    close() {
+        this.isOpen = false;
+    }
+    /**
+     * Convert a data item to a label string using `labelFunction` or `labelField`.
+     */
+    itemToLabel(item) {
+        if (item == null)
+            return '';
+        if (this._labelFunction)
+            return this._labelFunction(item);
+        if (typeof item === 'string')
+            return item;
+        if (typeof item === 'number' || typeof item === 'boolean')
+            return String(item);
+        const obj = item;
+        if (this._labelField && this._labelField in obj) {
+            return String(obj[this._labelField]);
+        }
+        return String(item);
+    }
+    // ── Private methods ───────────────────────────────────────────────────
+    _updateSelectedItem() {
+        if (this._dataProvider && this._selectedIndex >= 0 && this._selectedIndex < this._dataProvider.length) {
+            this._selectedItem = this._dataProvider.getItemAt(this._selectedIndex);
+        }
+        else {
+            this._selectedItem = undefined;
+        }
+        this._updateLabel();
+        this.dispatchEventWith(Event.CHANGE);
+    }
+    _updateLabel() {
+        if (!this.labelDisplay)
+            return;
+        if (this._selectedItem != null) {
+            this.labelDisplay.text = this.itemToLabel(this._selectedItem);
+        }
+        else {
+            this.labelDisplay.text = this._prompt;
+        }
+    }
+    _updateDisplayOrder(isOpen) {
+        if (isOpen && this._moveDropDownToStage())
+            return;
+        if (!isOpen && this._restoreDropDownParent())
+            return;
+        const parent = this.parent;
+        if (!parent)
+            return;
+        // A Group layout uses child index as layout order. Moving the ComboBox to
+        // the end would therefore move the control itself instead of only raising
+        // its drop-down above siblings. Layout users should place the ComboBox in
+        // a lightweight wrapper when overlay elevation is required.
+        if (parent.layout)
+            return;
+        if (isOpen) {
+            this._openParentIndex = parent.getChildIndex(this);
+            parent.setChildIndex(this, parent.numChildren - 1);
+        }
+        else if (this._openParentIndex >= 0) {
+            parent.setChildIndex(this, this._openParentIndex);
+            this._openParentIndex = -1;
+        }
+    }
+    /** Move only the popup to the stage so layout siblings cannot cover it. */
+    _moveDropDownToStage() {
+        const dropDown = this.dropDown;
+        const stage = this.stage;
+        const parent = dropDown?.parent;
+        if (!dropDown || !stage || !parent || parent === stage)
+            return false;
+        this._dropDownParent = parent;
+        this._dropDownParentIndex = parent.getChildIndex(dropDown);
+        this._dropDownLocalMatrix = dropDown.$getMatrix().clone();
+        const stageMatrix = dropDown.$getConcatenatedMatrix().clone();
+        parent.removeChild(dropDown);
+        stage.addChild(dropDown);
+        dropDown.$setMatrix(stageMatrix);
+        return true;
+    }
+    _restoreDropDownParent() {
+        const dropDown = this.dropDown;
+        const parent = this._dropDownParent;
+        const matrix = this._dropDownLocalMatrix;
+        if (!dropDown || !parent || !matrix)
+            return false;
+        dropDown.parent?.removeChild(dropDown);
+        parent.addChildAt(dropDown, Math.min(this._dropDownParentIndex, parent.numChildren));
+        dropDown.$setMatrix(matrix);
+        this._dropDownParent = undefined;
+        this._dropDownParentIndex = -1;
+        this._dropDownLocalMatrix = undefined;
+        return true;
+    }
+    _onTriggerTap = (e) => {
+        // If the tap lands inside the open drop-down (e.g. on the list),
+        // let the list's selection handler deal with it instead of toggling.
+        if (this._isOpen && this.dropDown && e.target instanceof DisplayObject && this.dropDown.contains(e.target)) {
+            return;
+        }
+        this.isOpen = !this._isOpen;
+    };
+    _onListChange = (_e) => {
+        if (this.list) {
+            this._selectedIndex = this.list.selectedIndex;
+            this._updateSelectedItem();
+        }
+        // Close after selection
+        this.close();
+    };
+}
+//# sourceMappingURL=ComboBox.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,203 @@
+import { Sprite, Rectangle, Event, type DisplayObject, type DisplayObjectEvents, type Matrix } from '@kurot/core';
+import { UIState, isUIComponent } from '../core/UIState.js';
+import type { IUIOwner } from '../core/UIState.js';
+import type { IUIComponent } from '../core/IUIComponent.js';
+import type { ILayoutTarget } from '../layouts/ILayoutTarget.js';
+import type { Skin } from './Skin.js';
+import { PropertyEvent } from '../events/PropertyEvent.js';
+import { UIEvent } from '../events/UIEvent.js';
+/**
+ * EventMap for Component and all its subclasses.
+ * Extends DisplayObjectEvents with the UI-layer event types that
+ * skinnable components dispatch.
+ */
+export interface ComponentEvents extends DisplayObjectEvents {
+    [PropertyEvent.PROPERTY_CHANGE]: PropertyEvent;
+    [UIEvent.CREATION_COMPLETE]: UIEvent;
+    [UIEvent.CHANGE_START]: UIEvent;
+    [UIEvent.CHANGE_END]: UIEvent;
+    [UIEvent.CLOSING]: UIEvent;
+    [UIEvent.MOVE]: UIEvent;
+}
+/**
+ * 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.
+ * 4. Override `createChildren()` to perform one-time initialization.
+ */
+export declare class Component extends Sprite implements IUIComponent, ILayoutTarget, IUIOwner {
+    readonly ui: UIState;
+    skinNameExplicitlySet: boolean;
+    private _hostComponentKey?;
+    private _skinName?;
+    private _skin?;
+    private _enabled;
+    private _explicitTouchEnabled;
+    private _explicitTouchChildren;
+    private _explicitState;
+    private _stateIsDirty;
+    constructor();
+    /**
+     * Key used to look up the default skin in the active Theme.
+     * Defaults to the component's class name if not set.
+     */
+    get hostComponentKey(): string;
+    set hostComponentKey(value: string);
+    /**
+     * Skin identifier. Can be:
+     * - A Skin subclass constructor
+     * - A Skin instance
+     * - A class name string (resolved via global scope)
+     */
+    get skinName(): string | (new () => Skin) | Skin | undefined;
+    set skinName(value: string | (new () => Skin) | Skin | undefined);
+    get skin(): Skin | undefined;
+    get enabled(): boolean;
+    /**
+     * Enable or disable this component (and its children).
+     *
+     * Mirrors egret's `$setEnabled`: writes `touchEnabled` / `touchChildren`
+     * directly at the display-object level (via `super`) so that:
+     *
+     * 1. The display-layer values change immediately (disabled components are
+     *    skipped in hit-testing, just like egret).
+     * 2. `_explicitTouchEnabled` / `_explicitTouchChildren` survive the
+     *    disable→enable cycle so the original intent is restored on re-enable.
+     */
+    set enabled(value: boolean);
+    /**
+     * The current view state. Setting this explicitly overrides `getCurrentState()`.
+     * Set to `''` to revert to the computed state.
+     */
+    get currentState(): string;
+    set currentState(value: string);
+    get includeInLayout(): boolean;
+    set includeInLayout(v: boolean);
+    get left(): number | string;
+    set left(v: number | string);
+    get right(): number | string;
+    set right(v: number | string);
+    get top(): number | string;
+    set top(v: number | string);
+    get bottom(): number | string;
+    set bottom(v: number | string);
+    get horizontalCenter(): number | string;
+    set horizontalCenter(v: number | string);
+    get verticalCenter(): number | string;
+    set verticalCenter(v: number | string);
+    get percentWidth(): number;
+    set percentWidth(v: number);
+    get percentHeight(): number;
+    set percentHeight(v: number);
+    $updateUseTransform(): void;
+    $setMatrix(matrix: Matrix, needUpdateProperties?: boolean): void;
+    $setAnchorOffsetX(value: number): void;
+    $setAnchorOffsetY(value: number): void;
+    $setX(value: number): boolean;
+    $setY(value: number): boolean;
+    get width(): number;
+    set width(v: number);
+    get height(): number;
+    set height(v: number);
+    get minWidth(): number;
+    set minWidth(v: number);
+    get maxWidth(): number;
+    set maxWidth(v: number);
+    get minHeight(): number;
+    set minHeight(v: number);
+    get maxHeight(): number;
+    set maxHeight(v: number);
+    get numElements(): number;
+    get contentWidth(): number;
+    get contentHeight(): number;
+    get scrollH(): number;
+    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.
+     */
+    setSkinPart(partName: string, instance: unknown): void;
+    /**
+     * Whether the display object receives touch events.
+     *
+     * Unlike the setter, reading this property always returns the *actual*
+     * display-level value — even when the component is disabled (the setter
+     * deliberately preserves `_explicitTouchEnabled` for the next `enabled`
+     * restore, so the getter must bypass that layer).
+     */
+    get touchEnabled(): boolean;
+    set touchEnabled(value: boolean);
+    get touchChildren(): boolean;
+    set touchChildren(value: boolean);
+    /**
+     * Mark the view state as dirty so it will be re-applied on next commit.
+     */
+    invalidateState(): void;
+    getElementAt(index: number): DisplayObject | undefined;
+    getVirtualElementAt(index: number): DisplayObject | undefined;
+    setVirtualElementIndicesInView(_startIndex: number, _endIndex: number): void;
+    setContentSize(_w: number, _h: number): void;
+    setMeasuredSize(w: number, h: number): void;
+    invalidateProperties(): void;
+    validateProperties(): void;
+    invalidateSize(): void;
+    validateSize(recursive?: boolean): void;
+    invalidateDisplayList(): void;
+    validateDisplayList(): void;
+    validateNow(): void;
+    setLayoutBoundsSize(lw: number, lh: number): void;
+    setLayoutBoundsPosition(x: number, y: number): void;
+    getLayoutBounds(bounds: Rectangle): void;
+    getPreferredBounds(bounds: Rectangle): void;
+    $onAddToStage(stage: unknown, $nestLevel: number): void;
+    childAdded(_child: unknown, _index: number): void;
+    childRemoved(_child: unknown, _index: number): void;
+    addEventListener<K extends keyof ComponentEvents & string>(type: K, listener: (event: ComponentEvents[K]) => void, useCapture?: boolean, priority?: number): void;
+    addEventListener(type: string, listener: (event: Event) => void, useCapture?: boolean, priority?: number): void;
+    removeEventListener<K extends keyof ComponentEvents & string>(type: K, listener: (event: ComponentEvents[K]) => void, useCapture?: boolean): void;
+    removeEventListener(type: string, listener: (event: Event) => void, useCapture?: boolean): void;
+    createChildren(): void;
+    childrenCreated(): void;
+    commitProperties(): void;
+    measure(): void;
+    updateDisplayList(w: number, h: number): void;
+    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.
+     */
+    protected partAdded(_partName: string, _instance: unknown): void;
+    /**
+     * Called when a skin part is removed. Override to clean up listeners
+     * and cached references.
+     */
+    protected partRemoved(_partName: string, _instance: unknown): void;
+    /**
+     * Return the current view-state name. Override in subclasses.
+     */
+    protected getCurrentState(): string;
+    private _parseSkinName;
+    /**
+     * Invoke a skin factory function with `this` (the host component) as context.
+     *
+     * EXML-compiled skins are factory functions (not class constructors) that use
+     * `this` for `Binding.bindProperty(this, ...)`. Calling with `.call(this)` ensures
+     * the bindings watch the host component, not a `new`-target blank object.
+     *
+     * For genuine ES class constructors (e.g. a user-written `class MySkin extends Skin`),
+     * `.call(this)` would throw `TypeError: Class constructor cannot be invoked without
+     * 'new'`, so we detect class constructors by their string representation and use `new`
+     * instead. This secondary path never has correct binding-`this`, so user skins should
+     * always be factory functions when they contain EXML `{…}` bindings.
+     */
+    private _invokeSkinFactory;
+    private _setSkin;
+}
+export { isUIComponent };
+//# sourceMappingURL=Component.d.ts.map