@kurot/ui 1.1.7

package/dist/kurot/components/Panel.js

@@ -0,0 +1,145 @@
+import { DisplayObject, TouchEvent } from '@kurot/core';
+import { Component } from './Component.js';
+import { Button } from './Button.js';
+import { UIEvent } from '../events/UIEvent.js';
+/**
+ * Panel — a skinnable container with an optional title bar, close button, and drag area.
+ *
+ * Skin parts:
+ * - `titleDisplay`  — Label for the panel title
+ * - `closeButton`   — Button that dispatches UIEvent.CLOSING when tapped
+ * - `moveArea`      — DisplayObject used as the drag handle
+ *
+ * Events:
+ * - `UIEvent.CLOSING` — dispatched (bubbles, cancelable) when closeButton is tapped
+ *
+ * @defaultProperty elementsContent
+ */
+export class Panel extends Component {
+    // ── Instance fields ───────────────────────────────────────────────────
+    closeButton;
+    moveArea;
+    _title = '';
+    _titleChanged = false;
+    _titleDisplay;
+    _dragStartX = 0;
+    _dragStartY = 0;
+    _panelStartX = 0;
+    _panelStartY = 0;
+    _dragStage;
+    // ── Default property (EXML children) ───────────────────────────────
+    /**
+     * Write-only: adds EXML-declared children to the panel.
+     * Mirrors Egret's `registerProperty(Panel, "elementsContent", "Array", true)`.
+     */
+    set elementsContent(value) {
+        if (!value)
+            return;
+        for (const child of value) {
+            this.addChild(child);
+        }
+    }
+    // ── Getters / Setters ─────────────────────────────────────────────────
+    get title() {
+        return this._title;
+    }
+    set title(value) {
+        if (this._title === value)
+            return;
+        this._title = value;
+        this._titleChanged = true;
+        this.invalidateProperties();
+    }
+    get titleDisplay() {
+        return this._titleDisplay;
+    }
+    set titleDisplay(value) {
+        if (this._titleDisplay === value)
+            return;
+        this._titleDisplay = value;
+        if (value && this._title)
+            value.text = this._title;
+    }
+    // ── Override methods ──────────────────────────────────────────────────
+    commitProperties() {
+        super.commitProperties();
+        if (this._titleChanged) {
+            this._titleChanged = false;
+            if (this._titleDisplay)
+                this._titleDisplay.text = this._title;
+        }
+    }
+    partAdded(partName, instance) {
+        super.partAdded(partName, instance);
+        if (instance instanceof Button && partName === 'closeButton') {
+            this.closeButton = instance;
+            instance.addEventListener(TouchEvent.TOUCH_TAP, this._onCloseButtonTap);
+        }
+        else if (instance instanceof DisplayObject && partName === 'moveArea') {
+            this.moveArea = instance;
+            instance.addEventListener(TouchEvent.TOUCH_BEGIN, this._onMoveAreaTouchBegin);
+        }
+    }
+    partRemoved(partName, instance) {
+        super.partRemoved(partName, instance);
+        if (instance instanceof Button && partName === 'closeButton') {
+            instance.removeEventListener(TouchEvent.TOUCH_TAP, this._onCloseButtonTap);
+            this.closeButton = undefined;
+        }
+        else if (instance instanceof DisplayObject && partName === 'moveArea') {
+            this._removeDragListeners();
+            instance.removeEventListener(TouchEvent.TOUCH_BEGIN, this._onMoveAreaTouchBegin);
+            this.moveArea = undefined;
+        }
+    }
+    $onRemoveFromStage() {
+        this._removeDragListeners();
+        super.$onRemoveFromStage();
+    }
+    // ── Public methods ────────────────────────────────────────────────────
+    /**
+     * Close the panel by removing it from its parent.
+     * Called automatically after UIEvent.CLOSING if not cancelled.
+     */
+    close() {
+        if (this.parent)
+            this.parent.removeChild(this);
+    }
+    // ── Private methods ───────────────────────────────────────────────────
+    _onCloseButtonTap = () => {
+        if (UIEvent.dispatchUIEvent(this, UIEvent.CLOSING, true, true)) {
+            this.close();
+        }
+    };
+    _onMoveAreaTouchBegin = (e) => {
+        this.includeInLayout = false;
+        this._dragStartX = e.stageX;
+        this._dragStartY = e.stageY;
+        this._panelStartX = this.x;
+        this._panelStartY = this.y;
+        const stage = this.stage;
+        if (stage) {
+            this._dragStage = stage;
+            stage.addEventListener(TouchEvent.TOUCH_MOVE, this._onMoveAreaTouchMove);
+            stage.addEventListener(TouchEvent.TOUCH_END, this._onMoveAreaTouchEnd);
+            stage.addEventListener(TouchEvent.TOUCH_CANCEL, this._onMoveAreaTouchEnd);
+        }
+    };
+    _onMoveAreaTouchMove = (e) => {
+        this.x = this._panelStartX + (e.stageX - this._dragStartX);
+        this.y = this._panelStartY + (e.stageY - this._dragStartY);
+    };
+    _onMoveAreaTouchEnd = () => {
+        this._removeDragListeners();
+    };
+    _removeDragListeners() {
+        const stage = this._dragStage;
+        if (!stage)
+            return;
+        stage.removeEventListener(TouchEvent.TOUCH_MOVE, this._onMoveAreaTouchMove);
+        stage.removeEventListener(TouchEvent.TOUCH_END, this._onMoveAreaTouchEnd);
+        stage.removeEventListener(TouchEvent.TOUCH_CANCEL, this._onMoveAreaTouchEnd);
+        this._dragStage = undefined;
+    }
+}
+//# sourceMappingURL=Panel.js.map

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

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

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

@@ -0,0 +1,48 @@
+import { Component } from './Component.js';
+import type { Label } from './Label.js';
+/**
+ * ProgressBar component that visualizes the progress of a task over time.
+ *
+ * The progress bar fills from `minimum` to `maximum` based on the current `value`.
+ * The direction of fill is controlled by the `direction` property.
+ *
+ * States: none (non-interactive visual element).
+ */
+export declare class ProgressBar extends Component {
+    thumb?: Component;
+    labelDisplay?: Label;
+    private _minimum;
+    private _maximum;
+    private _value;
+    private _direction;
+    private _labelFunction?;
+    private _slideDuration;
+    private _animationValue;
+    private readonly _animation;
+    constructor();
+    get minimum(): number;
+    set minimum(value: number);
+    get maximum(): number;
+    set maximum(value: number);
+    get value(): number;
+    set value(val: number);
+    private _applyValue;
+    private _startSlide;
+    private _onAnimationUpdate;
+    get direction(): string;
+    set direction(value: string);
+    get labelFunction(): ((value: number, maximum: number) => string) | undefined;
+    set labelFunction(fn: ((value: number, maximum: number) => string) | undefined);
+    /** Duration (ms) of the value-change slide animation. 0 = instant. @default 500 */
+    get slideDuration(): number;
+    set slideDuration(value: number);
+    get ratio(): number;
+    updateDisplayList(unscaledWidth: number, unscaledHeight: number): void;
+    /**
+     * Converts the current value to display text.
+     * Override this method to customize the label format.
+     * The default format is `"value / maximum"`.
+     */
+    protected _valueToLabel(value: number, maximum: number): string;
+}
+//# sourceMappingURL=ProgressBar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/ProgressBar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,SAAS;IAGlC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAO;IACvB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,cAAc,CAAC,CAA6C;IACpE,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;;IAWvC,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,KAAK,EAAE,MAAM,EAK/B;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,KAAK,EAAE,MAAM,EAK/B;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,GAAG,EAAE,MAAM,EAS3B;IAED,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB,CAIxB;IAEF,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAIjC;IAED,IAAW,aAAa,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAEnF;IAED,IAAW,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,EAIpF;IAED,mFAAmF;IACnF,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,MAAM,EAQrC;IAED,IAAW,KAAK,IAAI,MAAM,CAKzB;IAIe,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAyCtF;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAM/D"}

package/dist/kurot/components/ProgressBar.js

@@ -0,0 +1,180 @@
+import { Component } from './Component.js';
+import { Event, Rectangle } from '@kurot/core';
+import { Direction } from '../core/Direction.js';
+import { Animation } from './Animation.js';
+/**
+ * ProgressBar component that visualizes the progress of a task over time.
+ *
+ * The progress bar fills from `minimum` to `maximum` based on the current `value`.
+ * The direction of fill is controlled by the `direction` property.
+ *
+ * States: none (non-interactive visual element).
+ */
+export class ProgressBar extends Component {
+    // ── Instance fields ───────────────────────────────────────────────────
+    thumb;
+    labelDisplay;
+    _minimum = 0;
+    _maximum = 100;
+    _value = 0;
+    _direction = Direction.LTR;
+    _labelFunction;
+    _slideDuration = 500;
+    _animationValue = 0;
+    _animation;
+    // ── Constructor ───────────────────────────────────────────────────────
+    constructor() {
+        super();
+        this._animation = new Animation(this._onAnimationUpdate, this);
+    }
+    // ── Getters / Setters ─────────────────────────────────────────────────
+    get minimum() {
+        return this._minimum;
+    }
+    set minimum(value) {
+        if (this._minimum === value)
+            return;
+        this._minimum = value;
+        if (this._value < value)
+            this._value = value;
+        this.invalidateDisplayList();
+    }
+    get maximum() {
+        return this._maximum;
+    }
+    set maximum(value) {
+        if (this._maximum === value)
+            return;
+        this._maximum = value;
+        if (this._value > value)
+            this._value = value;
+        this.invalidateDisplayList();
+    }
+    get value() {
+        return this._value;
+    }
+    set value(val) {
+        val = Math.max(this._minimum, Math.min(this._maximum, val));
+        if (this._value === val)
+            return;
+        if (this._slideDuration > 0 && this.stage) {
+            this._startSlide(val);
+        }
+        else {
+            this._applyValue(val);
+            this.dispatchEventWith(Event.CHANGE);
+        }
+    }
+    _applyValue(val) {
+        this._value = val;
+        this._animationValue = val;
+        this.invalidateDisplayList();
+    }
+    _startSlide(targetValue) {
+        if (this._animation.isPlaying) {
+            this._animation.stop();
+        }
+        const range = this._maximum - this._minimum;
+        const distance = Math.abs(targetValue - this._animationValue);
+        const duration = range > 0 ? this._slideDuration * (distance / range) : 0;
+        this._animation.duration = duration === Infinity ? 0 : duration;
+        this._animation.from = this._animationValue;
+        this._animation.to = targetValue;
+        this._animation.play();
+    }
+    _onAnimationUpdate = (_anim) => {
+        this._animationValue = _anim.currentValue;
+        this._value = _anim.currentValue;
+        this.invalidateDisplayList();
+    };
+    get direction() {
+        return this._direction;
+    }
+    set direction(value) {
+        if (this._direction === value)
+            return;
+        this._direction = value;
+        this.invalidateDisplayList();
+    }
+    get labelFunction() {
+        return this._labelFunction;
+    }
+    set labelFunction(fn) {
+        if (this._labelFunction === fn)
+            return;
+        this._labelFunction = fn;
+        this.invalidateDisplayList();
+    }
+    /** Duration (ms) of the value-change slide animation. 0 = instant. @default 500 */
+    get slideDuration() {
+        return this._slideDuration;
+    }
+    set slideDuration(value) {
+        value = +value || 0;
+        if (this._slideDuration === value)
+            return;
+        this._slideDuration = value;
+        if (this._animation.isPlaying) {
+            this._animation.stop();
+            this._applyValue(this._animation.to);
+        }
+    }
+    get ratio() {
+        const v = this._animation.isPlaying ? this._animationValue : this._value;
+        const range = this._maximum - this._minimum;
+        if (range <= 0)
+            return 0;
+        return (v - this._minimum) / range;
+    }
+    // ── Override methods ──────────────────────────────────────────────────
+    updateDisplayList(unscaledWidth, unscaledHeight) {
+        super.updateDisplayList(unscaledWidth, unscaledHeight);
+        const thumb = this.thumb;
+        if (thumb) {
+            const thumbWidth = thumb.width;
+            const thumbHeight = thumb.height;
+            const r = this.ratio;
+            let clipW = Math.round(r * thumbWidth);
+            if (clipW < 0 || clipW === Infinity)
+                clipW = 0;
+            let clipH = Math.round(r * thumbHeight);
+            if (clipH < 0 || clipH === Infinity)
+                clipH = 0;
+            const rect = thumb.scrollRect ?? new Rectangle();
+            switch (this._direction) {
+                case Direction.RTL:
+                    rect.setTo(thumbWidth - clipW, 0, clipW, thumbHeight);
+                    thumb.x = thumbWidth - clipW;
+                    break;
+                case Direction.TTB:
+                    rect.setTo(0, 0, thumbWidth, clipH);
+                    break;
+                case Direction.BTT:
+                    rect.setTo(0, thumbHeight - clipH, thumbWidth, clipH);
+                    thumb.y = thumbHeight - clipH;
+                    break;
+                default: // LTR
+                    rect.setTo(0, 0, clipW, thumbHeight);
+                    break;
+            }
+            thumb.scrollRect = rect;
+        }
+        if (this.labelDisplay) {
+            const v = this._animation.isPlaying ? this._animationValue : this._value;
+            this.labelDisplay.text = this._valueToLabel(v, this._maximum);
+        }
+    }
+    // ── Protected methods ─────────────────────────────────────────────────
+    /**
+     * Converts the current value to display text.
+     * Override this method to customize the label format.
+     * The default format is `"value / maximum"`.
+     */
+    _valueToLabel(value, maximum) {
+        if (this._labelFunction) {
+            return this._labelFunction(value, maximum);
+        }
+        return value + ' / ' + maximum;
+    }
+}
+//# sourceMappingURL=ProgressBar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBar.js","sourceRoot":"","sources":["../../../src/kurot/components/ProgressBar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;GAOG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACzC,yEAAyE;IAElE,KAAK,CAAa;IAClB,YAAY,CAAS;IAEpB,QAAQ,GAAG,CAAC,CAAC;IACb,QAAQ,GAAG,GAAG,CAAC;IACf,MAAM,GAAG,CAAC,CAAC;IACX,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC;IAC3B,cAAc,CAA8C;IAC5D,cAAc,GAAG,GAAG,CAAC;IACrB,eAAe,GAAG,CAAC,CAAC;IACX,UAAU,CAAY;IAEvC,yEAAyE;IAEzE;QACC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,yEAAyE;IAEzE,IAAW,OAAO;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,IAAW,OAAO,CAAC,KAAa;QAC/B,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;YAAE,OAAO;QACpC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK;YAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAC7C,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IAED,IAAW,OAAO;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,IAAW,OAAO,CAAC,KAAa;QAC/B,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;YAAE,OAAO;QACpC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK;YAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAC7C,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IAED,IAAW,KAAK;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAW,KAAK,CAAC,GAAW;QAC3B,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO;QAChC,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAEO,WAAW,CAAC,GAAW;QAC9B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC;QAC3B,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IAEO,WAAW,CAAC,WAAmB;QACtC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAEO,kBAAkB,GAAG,CAAC,KAAgB,EAAQ,EAAE;QACvD,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC;QACjC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC,CAAC;IAEF,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,IAAW,SAAS,CAAC,KAAa;QACjC,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK;YAAE,OAAO;QACtC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IAED,IAAW,aAAa;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC5B,CAAC;IAED,IAAW,aAAa,CAAC,EAA4D;QACpF,IAAI,IAAI,CAAC,cAAc,KAAK,EAAE;YAAE,OAAO;QACvC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IAED,mFAAmF;IACnF,IAAW,aAAa;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC5B,CAAC;IAED,IAAW,aAAa,CAAC,KAAa;QACrC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,cAAc,KAAK,KAAK;YAAE,OAAO;QAC1C,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAED,IAAW,KAAK;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACzB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IACpC,CAAC;IAED,yEAAyE;IAEzD,iBAAiB,CAAC,aAAqB,EAAE,cAAsB;QAC9E,KAAK,CAAC,iBAAiB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;YAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;YACjC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YACrB,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;YACvC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,KAAK,QAAQ;gBAAE,KAAK,GAAG,CAAC,CAAC;YAC/C,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC;YACxC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,KAAK,QAAQ;gBAAE,KAAK,GAAG,CAAC,CAAC;YAE/C,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,SAAS,EAAE,CAAC;YACjD,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;gBACzB,KAAK,SAAS,CAAC,GAAG;oBACjB,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;oBACtD,KAAK,CAAC,CAAC,GAAG,UAAU,GAAG,KAAK,CAAC;oBAC7B,MAAM;gBACP,KAAK,SAAS,CAAC,GAAG;oBACjB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;oBACpC,MAAM;gBACP,KAAK,SAAS,CAAC,GAAG;oBACjB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;oBACtD,KAAK,CAAC,CAAC,GAAG,WAAW,GAAG,KAAK,CAAC;oBAC9B,MAAM;gBACP,SAAS,MAAM;oBACd,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;oBACrC,MAAM;YACR,CAAC;YACD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACzE,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/D,CAAC;IACF,CAAC;IAED,yEAAyE;IAEzE;;;;OAIG;IACO,aAAa,CAAC,KAAa,EAAE,OAAe;QACrD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IAChC,CAAC;CACD"}

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

@@ -0,0 +1,86 @@
+import { EventDispatcher } from '@kurot/core';
+import { ToggleButton } from './ToggleButton.js';
+/**
+ * Manages a group of mutually exclusive RadioButtons.
+ * Only one radio button in a group can be selected at a time.
+ *
+ * Dispatches `Event.CHANGE` on interactive selection (via `buttonReleased`),
+ * and `PropertyEvent` for `selectedValue` on every selection change.
+ */
+export declare class RadioButtonGroup extends EventDispatcher {
+    private _radioButtons;
+    private _selectedValue?;
+    private _selection?;
+    private _name;
+    private _enabled;
+    constructor(name?: string);
+    get name(): string;
+    get numRadioButtons(): number;
+    /**
+     * Whether the group (and therefore all its members) is enabled.
+     * Toggling invalidates every member's state so skins re-render.
+     */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    /**
+     * The value of the selected radio. Falls back to the radio's `label`
+     * when `value` is empty.
+     */
+    get selectedValue(): string | number | undefined;
+    set selectedValue(value: string | number | undefined);
+    get selection(): RadioButton | undefined;
+    set selection(value: RadioButton | undefined);
+    addInstance(radioButton: RadioButton): void;
+    removeInstance(radioButton: RadioButton): void;
+    /**
+     * The single source of truth for changing the selection.
+     *
+     * @param value     The radio to select, or `undefined` to clear.
+     * @param fireChange If `true`, dispatches `Event.CHANGE` — use `true` for
+     *                   interactive changes (tap), `false` for programmatic ones.
+     */
+    $setSelection(value: RadioButton | undefined, fireChange: boolean): boolean;
+}
+/**
+ * RadioButton — a toggle button belonging to a mutually exclusive group.
+ * Only one radio per group can be selected at a time.
+ *
+ * Defaults to `groupName = "radioGroup"` so that radios with no explicit
+ * group still get mutual exclusion.
+ *
+ * States: same as Button (`up`, `down`, `disabled`, `upAndSelected`, `downAndSelected`, `disabledAndSelected`).
+ */
+export declare class RadioButton extends ToggleButton {
+    private _groupName;
+    private _group?;
+    private _value;
+    constructor();
+    /** Enabled only if both the radio itself and its group are enabled. */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    get group(): RadioButtonGroup | undefined;
+    set group(value: RadioButtonGroup | undefined);
+    get groupName(): string;
+    set groupName(value: string);
+    get value(): string | number;
+    set value(val: string | number);
+    get selected(): boolean;
+    /**
+     * Keeps the group's selection in sync. Programmatic changes use
+     * `fireChange=false` (no `Event.CHANGE`); interactive changes go through
+     * `buttonReleased`, which dispatches `CHANGE` separately.
+     */
+    set selected(value: boolean);
+    /**
+     * @internal Sets `selected` without triggering group sync.
+     * Used by `RadioButtonGroup.$setSelection` to avoid recursion.
+     */
+    $setSelected(value: boolean): void;
+    /**
+     * Interactive tap: toggle `selected` (syncs the group with no Change via
+     * the setter), then dispatch `Event.CHANGE` on the group — reserved for
+     * interaction, not programmatic selection.
+     */
+    protected buttonReleased(): void;
+}
+//# sourceMappingURL=RadioButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RadioButton.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/RadioButton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAS,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IAGpD,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAAC,CAAkB;IACzC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAQ;gBAIL,IAAI,SAAK;IAO5B,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED;;;OAGG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAOhC;IAED;;;OAGG;IACH,IAAW,aAAa,IAAI,MAAM,GAAG,MAAM,GAAG,SAAS,CAKtD;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAc1D;IAED,IAAW,SAAS,IAAI,WAAW,GAAG,SAAS,CAE9C;IAED,IAAW,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAGlD;IAIM,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAY3C,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IASrD;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO;CAiBlF;AAeD;;;;;;;;GAQG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAG5C,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,MAAM,CAAC,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAuB;;IAWrC,uEAAuE;IACvE,IAAoB,OAAO,IAAI,OAAO,CAGrC;IAED,IAAoB,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzC;IAED,IAAW,KAAK,IAAI,gBAAgB,GAAG,SAAS,CAE/C;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAKnD;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAIjC;IAED,IAAW,KAAK,IAAI,MAAM,GAAG,MAAM,CAElC;IAED,IAAW,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAQpC;IAED,IAAoB,QAAQ,IAAI,OAAO,CAEtC;IAED;;;;OAIG;IACH,IAAoB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAS1C;IAED;;;OAGG;IACI,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIzC;;;;OAIG;cACgB,cAAc,IAAI,IAAI;CASzC"}