@kurot/ui 1.1.7

package/dist/kurot/components/ScrollBarBase.js

@@ -0,0 +1,50 @@
+import { Component } from './Component.js';
+import { PropertyEvent } from '../events/PropertyEvent.js';
+import { Event } from '@kurot/core';
+/**
+ * Base class for scroll bars.
+ *
+ * Connects to an IViewport and positions a `thumb` skin part based on the
+ * viewport's scroll position relative to its content size.
+ *
+ * @skinPart thumb — the draggable thumb indicator.
+ */
+export class ScrollBarBase extends Component {
+    // ── Instance fields ───────────────────────────────────────────────────
+    thumb;
+    autoVisibility = true;
+    _viewport;
+    // ── Getters / Setters ─────────────────────────────────────────────────
+    get viewport() {
+        return this._viewport;
+    }
+    set viewport(value) {
+        if (value === this._viewport)
+            return;
+        const vp = this._viewport;
+        if (vp) {
+            vp.removeEventListener(PropertyEvent.PROPERTY_CHANGE, this._onPropChange);
+            vp.removeEventListener(Event.RESIZE, this._onResize);
+        }
+        this._viewport = value;
+        if (value) {
+            value.addEventListener(PropertyEvent.PROPERTY_CHANGE, this._onPropChange);
+            value.addEventListener(Event.RESIZE, this._onResize);
+        }
+        this.invalidateDisplayList();
+    }
+    // ── Protected methods ─────────────────────────────────────────────────
+    /**
+     * Called when viewport properties (scrollH, scrollV, contentWidth, etc.) change.
+     * Override in subclasses to react.
+     */
+    onPropertyChanged(_event) { }
+    // ── Private methods ───────────────────────────────────────────────────
+    _onPropChange = (e) => {
+        this.onPropertyChanged(e);
+    };
+    _onResize = (_e) => {
+        this.invalidateDisplayList();
+    };
+}
+//# sourceMappingURL=ScrollBarBase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollBarBase.js","sourceRoot":"","sources":["../../../src/kurot/components/ScrollBarBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC3C,yEAAyE;IAElE,KAAK,CAAgB;IACrB,cAAc,GAAG,IAAI,CAAC;IAErB,SAAS,CAAa;IAE9B,yEAAyE;IAEzE,IAAW,QAAQ;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,IAAW,QAAQ,CAAC,KAA4B;QAC/C,IAAI,KAAK,KAAK,IAAI,CAAC,SAAS;YAAE,OAAO;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,IAAI,EAAE,EAAE,CAAC;YACR,EAAE,CAAC,mBAAmB,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1E,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,KAAK,EAAE,CAAC;YACX,KAAK,CAAC,gBAAgB,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1E,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IAED,yEAAyE;IAEzE;;;OAGG;IACO,iBAAiB,CAAC,MAAqB,IAAS,CAAC;IAE3D,yEAAyE;IAEjE,aAAa,GAAG,CAAC,CAAQ,EAAQ,EAAE;QAC1C,IAAI,CAAC,iBAAiB,CAAC,CAAkB,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEM,SAAS,GAAG,CAAC,EAAS,EAAQ,EAAE;QACvC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC,CAAC;CACF"}

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

@@ -0,0 +1,82 @@
+import { Component } from './Component.js';
+import type { Skin } from './Skin.js';
+import type { IViewport } from '../core/IViewport.js';
+import { HScrollBar } from './HScrollBar.js';
+import { VScrollBar } from './VScrollBar.js';
+/**
+ * Scroller wraps an {@link IViewport} (typically a Group) and provides
+ * touch-scrolling, scroll bars, and scroll-policy management.
+ *
+ * @skinPart horizontalScrollBar — the HScrollBar skin part.
+ * @skinPart verticalScrollBar   — the VScrollBar skin part.
+ */
+export declare class Scroller extends Component {
+    static readonly DEFAULT_THRESHOLD = 8;
+    horizontalScrollBar?: HScrollBar;
+    verticalScrollBar?: VScrollBar;
+    scrollFactor: number;
+    bounces: boolean;
+    private _viewport?;
+    private _horizontalScrollPolicy;
+    private _verticalScrollPolicy;
+    private _hScroll;
+    private _vScroll;
+    private _touchPointID;
+    private _touchStage?;
+    private _startTouchPointX;
+    private _startTouchPointY;
+    private _touchMoved;
+    private _touchCancelled;
+    /**
+     * Whether a CHANGE_START event has been dispatched for the current
+     * scroll gesture (egret parity). Cleared when CHANGE_END fires.
+     */
+    private _changeStartDispatched;
+    /**
+     * Timer ID for the 200 ms auto-hide timeout on the scroll bars.
+     * Matches egret's {@code autoHideTimer} (a {@code egret.Timer(200, 1)}).
+     */
+    private _autoHideTimer;
+    constructor();
+    get viewport(): IViewport | undefined;
+    set viewport(value: IViewport | undefined);
+    get horizontalScrollPolicy(): string;
+    set horizontalScrollPolicy(value: string);
+    get verticalScrollPolicy(): string;
+    set verticalScrollPolicy(value: string);
+    /**
+     * Speed multiplier for scroll throw animation (egret parity).
+     * Delegates to the underlying {@link TouchScroll} instances.
+     * @default 1.0
+     */
+    get throwSpeed(): number;
+    set throwSpeed(val: number);
+    protected partAdded(partName: string, instance: unknown): void;
+    protected partRemoved(partName: string, instance: unknown): void;
+    updateDisplayList(unscaledWidth: number, unscaledHeight: number): void;
+    protected setSkin(skin: Skin | undefined): void;
+    $onRemoveFromStage(): void;
+    private _updateScrollBarVisibility;
+    private _onViewportPropChange;
+    private _onTouchBeginCapture;
+    private _onTouchEndCapture;
+    private _onTouchTapCapture;
+    private _canScroll;
+    private _onTouchBegin;
+    private _removeStageTouchListeners;
+    private _onTouchMove;
+    private _onTouchEnd;
+    private onHScrollUpdate;
+    private onVScrollUpdate;
+    /**
+     * Called when a scroll throw animation ends (egret parity).
+     * Dispatches CHANGE_END when both horizontal and vertical animations
+     * have stopped, and starts the auto-hide timer for the scroll bars.
+     */
+    private onHScrollEnd;
+    private onVScrollEnd;
+    private _onChangeEnd;
+    private _scheduleAutoHide;
+    private _clearAutoHideTimer;
+}
+//# sourceMappingURL=Scroller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Scroller.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Scroller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgB7C;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,SAAS;IAGtC,gBAAuB,iBAAiB,KAAK;IAItC,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,YAAY,SAAO;IACnB,OAAO,UAAQ;IAEtB,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,uBAAuB,CAAqB;IACpD,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAEhC;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAAS;IAEvC;;;OAGG;IACH,OAAO,CAAC,cAAc,CAA4C;;IAalE,IAAW,QAAQ,IAAI,SAAS,GAAG,SAAS,CAE3C;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EA8B/C;IAED,IAAW,sBAAsB,IAAI,MAAM,CAE1C;IAED,IAAW,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAI9C;IAED,IAAW,oBAAoB,IAAI,MAAM,CAExC;IAED,IAAW,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAI5C;IAED;;;;OAIG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,UAAU,CAAC,GAAG,EAAE,MAAM,EAMhC;cAIkB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;cAiBpD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAWzD,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;cAWnE,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI;IAWxC,kBAAkB,IAAI,IAAI;IAW1C,OAAO,CAAC,0BAA0B;IAsClC,OAAO,CAAC,qBAAqB,CAQ3B;IAEF,OAAO,CAAC,oBAAoB,CAK1B;IAEF,OAAO,CAAC,kBAAkB,CAIxB;IAEF,OAAO,CAAC,kBAAkB,CAIxB;IAEF,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,aAAa,CAuBnB;IAEF,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,YAAY,CAmDlB;IAEF,OAAO,CAAC,WAAW,CAkBjB;IAEF,OAAO,CAAC,eAAe,CAGrB;IAEF,OAAO,CAAC,eAAe,CAGrB;IAEF;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,mBAAmB;CAM3B"}

package/dist/kurot/components/Scroller.js

@@ -0,0 +1,416 @@
+import { TouchEvent, Rectangle } from '@kurot/core';
+import { Component } from './Component.js';
+import { ScrollPolicy } from '../core/ScrollPolicy.js';
+import { TouchScroll } from './TouchScroll.js';
+import { HScrollBar } from './HScrollBar.js';
+import { VScrollBar } from './VScrollBar.js';
+import { PropertyEvent } from '../events/PropertyEvent.js';
+import { UIEvent } from '../events/UIEvent.js';
+import { isUIComponent } from '../core/UIComponent.js';
+/**
+ * Scratch rectangle for viewport layout-bounds queries.
+ *
+ * Kept at module scope (rather than as a `static`/instance field on the class)
+ * because a `static readonly` *object* field triggers the Rollup class-rename
+ * that corrupts `constructor.name` (the HSlider/VSlider bug from 1.0.3), and an
+ * instance field with an object initialiser also provokes the rename. The
+ * methods that use it are non-reentrant, so sharing one rectangle is safe.
+ */
+const vpBounds = new Rectangle();
+/**
+ * Scroller wraps an {@link IViewport} (typically a Group) and provides
+ * touch-scrolling, scroll bars, and scroll-policy management.
+ *
+ * @skinPart horizontalScrollBar — the HScrollBar skin part.
+ * @skinPart verticalScrollBar   — the VScrollBar skin part.
+ */
+export class Scroller extends Component {
+    // ── Static fields ─────────────────────────────────────────────────────
+    static DEFAULT_THRESHOLD = 8;
+    // ── Instance fields ───────────────────────────────────────────────────
+    horizontalScrollBar;
+    verticalScrollBar;
+    scrollFactor = 1.0;
+    bounces = true;
+    _viewport;
+    _horizontalScrollPolicy = ScrollPolicy.AUTO;
+    _verticalScrollPolicy = ScrollPolicy.AUTO;
+    _hScroll;
+    _vScroll;
+    _touchPointID = -1;
+    _touchStage;
+    _startTouchPointX = 0;
+    _startTouchPointY = 0;
+    _touchMoved = false;
+    _touchCancelled = false;
+    /**
+     * Whether a CHANGE_START event has been dispatched for the current
+     * scroll gesture (egret parity). Cleared when CHANGE_END fires.
+     */
+    _changeStartDispatched = false;
+    /**
+     * Timer ID for the 200 ms auto-hide timeout on the scroll bars.
+     * Matches egret's {@code autoHideTimer} (a {@code egret.Timer(200, 1)}).
+     */
+    _autoHideTimer;
+    // ── Constructor ───────────────────────────────────────────────────────
+    constructor() {
+        super();
+        this._hScroll = new TouchScroll(this.onHScrollUpdate, this.onHScrollEnd);
+        this._vScroll = new TouchScroll(this.onVScrollUpdate, this.onVScrollEnd);
+        this.touchChildren = true;
+    }
+    // ── Getters / Setters ─────────────────────────────────────────────────
+    get viewport() {
+        return this._viewport;
+    }
+    set viewport(value) {
+        if (value === this._viewport)
+            return;
+        const old = this._viewport;
+        if (old) {
+            this._removeStageTouchListeners();
+            this._hScroll.stop();
+            this._vScroll.stop();
+            this._touchPointID = -1;
+            if (this.horizontalScrollBar)
+                this.horizontalScrollBar.viewport = undefined;
+            if (this.verticalScrollBar)
+                this.verticalScrollBar.viewport = undefined;
+            old.removeEventListener(PropertyEvent.PROPERTY_CHANGE, this._onViewportPropChange);
+            old.removeEventListener(TouchEvent.TOUCH_BEGIN, this._onTouchBeginCapture, true);
+            old.removeEventListener(TouchEvent.TOUCH_END, this._onTouchEndCapture, true);
+            old.removeEventListener(TouchEvent.TOUCH_TAP, this._onTouchTapCapture, true);
+            old.scrollEnabled = false;
+            const oldDisplay = old;
+            if (oldDisplay.parent === this)
+                this.removeChild(oldDisplay);
+        }
+        this._viewport = value;
+        if (value) {
+            this.addChildAt(value, 0);
+            value.addEventListener(PropertyEvent.PROPERTY_CHANGE, this._onViewportPropChange);
+            value.addEventListener(TouchEvent.TOUCH_BEGIN, this._onTouchBeginCapture, true);
+            value.addEventListener(TouchEvent.TOUCH_END, this._onTouchEndCapture, true);
+            value.addEventListener(TouchEvent.TOUCH_TAP, this._onTouchTapCapture, true);
+            value.scrollEnabled = true;
+        }
+        if (this.horizontalScrollBar)
+            this.horizontalScrollBar.viewport = value;
+        if (this.verticalScrollBar)
+            this.verticalScrollBar.viewport = value;
+        this.invalidateDisplayList();
+    }
+    get horizontalScrollPolicy() {
+        return this._horizontalScrollPolicy;
+    }
+    set horizontalScrollPolicy(value) {
+        if (this._horizontalScrollPolicy === value)
+            return;
+        this._horizontalScrollPolicy = value;
+        this.invalidateDisplayList();
+    }
+    get verticalScrollPolicy() {
+        return this._verticalScrollPolicy;
+    }
+    set verticalScrollPolicy(value) {
+        if (this._verticalScrollPolicy === value)
+            return;
+        this._verticalScrollPolicy = value;
+        this.invalidateDisplayList();
+    }
+    /**
+     * Speed multiplier for scroll throw animation (egret parity).
+     * Delegates to the underlying {@link TouchScroll} instances.
+     * @default 1.0
+     */
+    get throwSpeed() {
+        return this._hScroll.scrollFactor;
+    }
+    set throwSpeed(val) {
+        val = +val;
+        if (val < 0)
+            val = 0;
+        this._hScroll.scrollFactor = val;
+        this._vScroll.scrollFactor = val;
+        this.scrollFactor = val;
+    }
+    // ── Override methods ──────────────────────────────────────────────────
+    partAdded(partName, instance) {
+        super.partAdded(partName, instance);
+        if (instance instanceof HScrollBar && partName === 'horizontalScrollBar') {
+            this.horizontalScrollBar = instance;
+            instance.touchChildren = false;
+            instance.touchEnabled = false;
+            instance.viewport = this._viewport;
+            if (instance.autoVisibility)
+                instance.visible = false;
+        }
+        else if (instance instanceof VScrollBar && partName === 'verticalScrollBar') {
+            this.verticalScrollBar = instance;
+            instance.touchChildren = false;
+            instance.touchEnabled = false;
+            instance.viewport = this._viewport;
+            if (instance.autoVisibility)
+                instance.visible = false;
+        }
+    }
+    partRemoved(partName, instance) {
+        super.partRemoved(partName, instance);
+        if (partName === 'horizontalScrollBar') {
+            if (instance instanceof HScrollBar)
+                instance.viewport = undefined;
+            this.horizontalScrollBar = undefined;
+        }
+        else if (partName === 'verticalScrollBar') {
+            if (instance instanceof VScrollBar)
+                instance.viewport = undefined;
+            this.verticalScrollBar = undefined;
+        }
+    }
+    updateDisplayList(unscaledWidth, unscaledHeight) {
+        super.updateDisplayList(unscaledWidth, unscaledHeight);
+        const vp = this._viewport;
+        if (vp && isUIComponent(vp)) {
+            // Match egret: size the viewport to fill the Scroller and anchor it at (0,0).
+            vp.setLayoutBoundsSize(unscaledWidth, unscaledHeight);
+            vp.setLayoutBoundsPosition(0, 0);
+        }
+        this._updateScrollBarVisibility();
+    }
+    setSkin(skin) {
+        super.setSkin(skin);
+        // Match egret: after the skin (scroll bars) is applied, re-add the viewport
+        // at index 0 so it sits beneath the scroll bars and is never orphaned by
+        // the skin application.
+        const vp = this._viewport;
+        if (vp) {
+            this.addChildAt(vp, 0);
+        }
+    }
+    $onRemoveFromStage() {
+        this._removeStageTouchListeners();
+        this._hScroll.stop();
+        this._vScroll.stop();
+        this._touchPointID = -1;
+        this._clearAutoHideTimer();
+        super.$onRemoveFromStage();
+    }
+    // ── Private methods ───────────────────────────────────────────────────
+    _updateScrollBarVisibility() {
+        const vp = this._viewport;
+        if (!vp)
+            return;
+        const b = vpBounds;
+        vp.getLayoutBounds(b);
+        const vpWidth = b.width;
+        const vpHeight = b.height;
+        const hsb = this.horizontalScrollBar;
+        if (hsb) {
+            const maxScrollH = Math.max(0, vp.contentWidth - vpWidth);
+            const canScrollH = maxScrollH > 0;
+            const policy = this._horizontalScrollPolicy;
+            if (policy === ScrollPolicy.ON) {
+                hsb.visible = true;
+            }
+            else if (policy === ScrollPolicy.OFF) {
+                hsb.visible = false;
+            }
+            else {
+                hsb.visible = canScrollH;
+            }
+        }
+        const vsb = this.verticalScrollBar;
+        if (vsb) {
+            const maxScrollV = Math.max(0, vp.contentHeight - vpHeight);
+            const canScrollV = maxScrollV > 0;
+            const policy = this._verticalScrollPolicy;
+            if (policy === ScrollPolicy.ON) {
+                vsb.visible = true;
+            }
+            else if (policy === ScrollPolicy.OFF) {
+                vsb.visible = false;
+            }
+            else {
+                vsb.visible = canScrollV;
+            }
+        }
+    }
+    _onViewportPropChange = (e) => {
+        const pe = e;
+        switch (pe.property) {
+            case 'contentWidth':
+            case 'contentHeight':
+                this._updateScrollBarVisibility();
+                break;
+        }
+    };
+    _onTouchBeginCapture = (e) => {
+        if (!this._canScroll())
+            return;
+        this._touchCancelled = false;
+        this._touchMoved = false;
+        this._onTouchBegin(e);
+    };
+    _onTouchEndCapture = (e) => {
+        if (this._touchCancelled) {
+            e.stopPropagation();
+        }
+    };
+    _onTouchTapCapture = (e) => {
+        if (this._touchCancelled) {
+            e.stopPropagation();
+        }
+    };
+    _canScroll() {
+        const vp = this._viewport;
+        if (!vp)
+            return false;
+        const b = vpBounds;
+        vp.getLayoutBounds(b);
+        return vp.contentWidth > b.width || vp.contentHeight > b.height;
+    }
+    _onTouchBegin = (e) => {
+        const te = e;
+        if (this._touchPointID !== -1)
+            return;
+        const vp = this._viewport;
+        if (!vp)
+            return;
+        this._touchPointID = te.touchPointID;
+        this._startTouchPointX = te.stageX;
+        this._startTouchPointY = te.stageY;
+        this._hScroll.stop();
+        this._vScroll.stop();
+        this._clearAutoHideTimer();
+        this._updateScrollBarVisibility();
+        const stage = this.stage;
+        if (stage) {
+            this._touchStage = stage;
+            stage.addEventListener(TouchEvent.TOUCH_MOVE, this._onTouchMove);
+            stage.addEventListener(TouchEvent.TOUCH_END, this._onTouchEnd);
+            stage.addEventListener(TouchEvent.TOUCH_CANCEL, this._onTouchEnd);
+        }
+    };
+    _removeStageTouchListeners() {
+        const stage = this._touchStage;
+        if (stage) {
+            stage.removeEventListener(TouchEvent.TOUCH_MOVE, this._onTouchMove);
+            stage.removeEventListener(TouchEvent.TOUCH_END, this._onTouchEnd);
+            stage.removeEventListener(TouchEvent.TOUCH_CANCEL, this._onTouchEnd);
+        }
+        this._touchStage = undefined;
+    }
+    _onTouchMove = (e) => {
+        if (e.touchPointID !== this._touchPointID)
+            return;
+        const vp = this._viewport;
+        if (!vp)
+            return;
+        const moveX = this._startTouchPointX - e.stageX;
+        const moveY = this._startTouchPointY - e.stageY;
+        if (!this._hScroll.isStarted() && !this._vScroll.isStarted()) {
+            if (Math.abs(moveX) < Scroller.DEFAULT_THRESHOLD && Math.abs(moveY) < Scroller.DEFAULT_THRESHOLD) {
+                return;
+            }
+            // Scroll gesture confirmed — swallow the upcoming tap so child
+            // components (e.g. List items) don't receive a false "click".
+            this._touchCancelled = true;
+            this._touchMoved = true;
+            // Dispatch CHANGE_START once per gesture (egret parity).
+            if (!this._changeStartDispatched) {
+                this._changeStartDispatched = true;
+                UIEvent.dispatchUIEvent(this, UIEvent.CHANGE_START);
+            }
+            const tb = vpBounds;
+            vp.getLayoutBounds(tb);
+            const maxH = Math.max(0, vp.contentWidth - tb.width);
+            const maxV = Math.max(0, vp.contentHeight - tb.height);
+            if (maxH > 0 && Math.abs(moveX) >= Math.abs(moveY)) {
+                this._hScroll.scrollFactor = this.scrollFactor;
+                this._hScroll.bounces = this.bounces;
+                this._hScroll.start(e.stageX);
+            }
+            if (maxV > 0 && Math.abs(moveY) >= Math.abs(moveX)) {
+                this._vScroll.scrollFactor = this.scrollFactor;
+                this._vScroll.bounces = this.bounces;
+                this._vScroll.start(e.stageY);
+            }
+        }
+        if (this._hScroll.isStarted()) {
+            const b = vpBounds;
+            vp.getLayoutBounds(b);
+            this._hScroll.update(e.stageX, Math.max(0, vp.contentWidth - b.width), vp.scrollH);
+        }
+        if (this._vScroll.isStarted()) {
+            const b = vpBounds;
+            vp.getLayoutBounds(b);
+            this._vScroll.update(e.stageY, Math.max(0, vp.contentHeight - b.height), vp.scrollV);
+        }
+    };
+    _onTouchEnd = (e) => {
+        if (e.touchPointID !== this._touchPointID)
+            return;
+        this._touchPointID = -1;
+        this._removeStageTouchListeners();
+        const vp = this._viewport;
+        if (!vp)
+            return;
+        if (this._hScroll.isStarted()) {
+            const b = vpBounds;
+            vp.getLayoutBounds(b);
+            this._hScroll.finish(vp.scrollH, Math.max(0, vp.contentWidth - b.width));
+        }
+        if (this._vScroll.isStarted()) {
+            const b = vpBounds;
+            vp.getLayoutBounds(b);
+            this._vScroll.finish(vp.scrollV, Math.max(0, vp.contentHeight - b.height));
+        }
+    };
+    onHScrollUpdate = (scrollPos) => {
+        const vp = this._viewport;
+        if (vp)
+            vp.scrollH = scrollPos;
+    };
+    onVScrollUpdate = (scrollPos) => {
+        const vp = this._viewport;
+        if (vp)
+            vp.scrollV = scrollPos;
+    };
+    /**
+     * Called when a scroll throw animation ends (egret parity).
+     * Dispatches CHANGE_END when both horizontal and vertical animations
+     * have stopped, and starts the auto-hide timer for the scroll bars.
+     */
+    onHScrollEnd = () => {
+        if (!this._vScroll.isStarted())
+            this._onChangeEnd();
+    };
+    onVScrollEnd = () => {
+        if (!this._hScroll.isStarted())
+            this._onChangeEnd();
+    };
+    _onChangeEnd() {
+        this._changeStartDispatched = false;
+        this._scheduleAutoHide();
+        UIEvent.dispatchUIEvent(this, UIEvent.CHANGE_END);
+    }
+    // ── Auto-hide scroll bars (egret parity) ─────────────────────────
+    _scheduleAutoHide() {
+        this._clearAutoHideTimer();
+        this._autoHideTimer = setTimeout(() => {
+            this._autoHideTimer = undefined;
+            if (this.horizontalScrollBar?.autoVisibility)
+                this.horizontalScrollBar.visible = false;
+            if (this.verticalScrollBar?.autoVisibility)
+                this.verticalScrollBar.visible = false;
+        }, 200);
+    }
+    _clearAutoHideTimer() {
+        if (this._autoHideTimer !== undefined) {
+            clearTimeout(this._autoHideTimer);
+            this._autoHideTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=Scroller.js.map

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

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

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

@@ -0,0 +1,64 @@
+import { EventDispatcher, DisplayObject, type EventMap } from '@kurot/core';
+import { PropertyEvent } from '../events/PropertyEvent.js';
+import type { State } from '../states/State.js';
+import type { Component } from './Component.js';
+import type { Watcher } from '../binding/Watcher.js';
+/**
+ * EventMap for Skin. Skins dispatch PropertyEvent when hostComponent changes.
+ */
+export interface SkinEvents extends EventMap {
+    [PropertyEvent.PROPERTY_CHANGE]: PropertyEvent;
+}
+/**
+ * Base class for all UI skins.
+ *
+ * Skins are typically generated by the EXML compiler (`@kurot/cli`).
+ * A skin holds the visual $children of a Component and exposes named
+ * "skin parts" (e.g. `labelDisplay`, `iconDisplay`) that the host
+ * component binds to via `partAdded()` / `partRemoved()`.
+ *
+ * The skin also owns the view-state list (`states`) and applies state
+ * changes to its $children when `currentState` changes.
+ */
+export declare class Skin extends EventDispatcher<SkinEvents> {
+    skinParts: string[];
+    width: number;
+    height: number;
+    minWidth: number;
+    maxWidth: number;
+    minHeight: number;
+    maxHeight: number;
+    states: State[];
+    /**
+     * Watchers created by EXML bindings (e.g. `{data}`). The runtime appends
+     * every {@link Watcher} instance created by the skin factory so they can
+     * be unwound together via {@link unwatchAll} when the skin is replaced.
+     */
+    $watchers: Watcher[];
+    private _elementsContent;
+    private _hostComponent?;
+    private _currentState;
+    private _stateInitialized;
+    get elementsContent(): DisplayObject[];
+    set elementsContent(value: DisplayObject[]);
+    get hostComponent(): Component | undefined;
+    set hostComponent(value: Component | undefined);
+    get currentState(): string;
+    set currentState(value: string);
+    /**
+     * Get a skin part by name. Used by Component to bind parts.
+     */
+    getPart(name: string): unknown;
+    /**
+     * Unwatch every binding created from this skin.
+     * Called by the host component when the skin is detached or replaced
+     * so stale watchers don't leak or fire on the wrong host.
+     */
+    unwatchAll(): void;
+    hasState(stateName: string): boolean;
+    private _onHostAddedToStage;
+    private _initializeStates;
+    private _applyState;
+    private _removeState;
+}
+//# sourceMappingURL=Skin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Skin.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/Skin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAS,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC3C,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,IAAK,SAAQ,eAAe,CAAC,UAAU,CAAC;IAG7C,SAAS,EAAE,MAAM,EAAE,CAAM;IACzB,KAAK,EAAE,MAAM,CAAO;IACpB,MAAM,EAAE,MAAM,CAAO;IACrB,QAAQ,EAAE,MAAM,CAAK;IACrB,QAAQ,EAAE,MAAM,CAAU;IAC1B,SAAS,EAAE,MAAM,CAAK;IACtB,SAAS,EAAE,MAAM,CAAU;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAM;IAE5B;;;;OAIG;IACI,SAAS,EAAE,OAAO,EAAE,CAAM;IAEjC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAY;IACnC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,iBAAiB,CAAS;IAIlC,IAAW,eAAe,IAAI,aAAa,EAAE,CAE5C;IAED,IAAW,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,EAEhD;IAED,IAAW,aAAa,IAAI,SAAS,GAAG,SAAS,CAEhD;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAuBpD;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,YAAY,CAAC,KAAK,EAAE,MAAM,EAOpC;IAID;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;OAIG;IACI,UAAU,IAAI,IAAI;IASlB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAM3C,OAAO,CAAC,mBAAmB,CAEzB;IAEF,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,YAAY;CAOpB"}