@vforsh/phaser-dev-ui 0.1.0 → 0.2.0

package/README.md

@@ -70,6 +70,15 @@ The system is designed with a fluent, chainable API and dark-theme defaults matc
 - **`createGridContainer`**: Arranges children in a grid with configurable columns, cell size, and spacing.
 - **Usage**: Group related UI elements. After adding items via `addItem()` or `addItems()`, call `.layout()` to reposition children. Containers are invisible positioning helpers and can be nested.
 
+### Utility Helpers
+
+- **`bindDebugControl`**: Two-way model binding helper for debug controls.
+  - Supports model access via object path (`target` + `path`) or custom getter/setter.
+  - Polls model on `preupdate` and pushes control changes back through control events.
+- **`anchorToViewport`**: Anchors any game object to viewport edges/corners/center with optional safe-area insets and resize updates.
+- **`getSafeAreaInsets`**: Resolves safe-area insets in game units (CSS env insets + optional extra insets).
+- **`layoutAuto`**: Dirty layout scheduler; batches `.layout()` calls and flushes once per frame.
+
 ## Example: Creating a Settings Popup
 
 ```typescript

package/dist/anchorToViewport.d.ts

@@ -0,0 +1,51 @@
+export type ViewportAnchor = "top-left" | "top-center" | "top-right" | "center-left" | "center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right";
+export interface SafeAreaInsets {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+export interface SafeAreaOptions {
+    /** Merge extra insets in game units. */
+    extraInsets?: Partial<SafeAreaInsets>;
+    /** Read CSS env(safe-area-inset-*) values from the browser (default: true). */
+    useCssEnvInsets?: boolean;
+}
+export interface AnchorToViewportOptions {
+    /** Scene object for scale/resize events (auto-detected from target.scene when omitted). */
+    scene?: Phaser.Scene;
+    /** Target object to place in viewport coordinates. */
+    target: Phaser.GameObjects.GameObject;
+    /** Anchor point in viewport (default: "top-left"). */
+    anchor?: ViewportAnchor;
+    /** Offset from anchor in game units (default: 0). */
+    offsetX?: number;
+    offsetY?: number;
+    /** Apply safe-area insets (default: true). */
+    useSafeArea?: boolean;
+    /** Safe-area options (extra insets + css env toggle). */
+    safeArea?: SafeAreaOptions;
+    /** Update automatically on scale resize (default: true). */
+    autoResize?: boolean;
+}
+export interface ViewportAnchorHandle {
+    update(): void;
+    destroy(): void;
+    isDestroyed(): boolean;
+    getSafeAreaInsets(): SafeAreaInsets;
+}
+/**
+ * Anchor a game object to a viewport corner/edge/center.
+ *
+ * Position is computed in game coordinates and updated on resize.
+ * Assumes centered origin for best results (0.5, 0.5).
+ */
+export declare function anchorToViewport(options: AnchorToViewportOptions): ViewportAnchorHandle;
+/**
+ * Resolve safe-area insets in game units.
+ *
+ * Uses browser CSS env(safe-area-inset-*) values when available,
+ * then applies optional caller-provided extra insets.
+ */
+export declare function getSafeAreaInsets(scene: Phaser.Scene, options?: SafeAreaOptions): SafeAreaInsets;
+//# sourceMappingURL=anchorToViewport.d.ts.map

package/dist/anchorToViewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchorToViewport.d.ts","sourceRoot":"","sources":["../src/anchorToViewport.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACvB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,QAAQ,GACR,cAAc,GACd,aAAa,GACb,eAAe,GACf,cAAc,CAAA;AAEjB,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACrC,+EAA+E;IAC/E,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACvC,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAA;IACpB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,CAAA;IACrC,sDAAsD;IACtD,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,IAAI,IAAI,CAAA;IACd,OAAO,IAAI,IAAI,CAAA;IACf,WAAW,IAAI,OAAO,CAAA;IACtB,iBAAiB,IAAI,cAAc,CAAA;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,oBAAoB,CAwEvF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAWpG"}

package/dist/anchorToViewport.js

@@ -0,0 +1,200 @@
+/**
+ * Anchor a game object to a viewport corner/edge/center.
+ *
+ * Position is computed in game coordinates and updated on resize.
+ * Assumes centered origin for best results (0.5, 0.5).
+ */
+export function anchorToViewport(options) {
+    const { target, scene: sceneFromOptions, anchor = "top-left", offsetX = 0, offsetY = 0, useSafeArea = true, safeArea, autoResize = true, } = options;
+    const scene = sceneFromOptions ?? target.scene;
+    if (!scene) {
+        throw new Error("anchorToViewport: scene not found. Pass options.scene or use a scene-owned target.");
+    }
+    let destroyed = false;
+    const placeTarget = () => {
+        if (destroyed)
+            return;
+        const viewport = getViewportRect(scene);
+        const insets = useSafeArea ? getSafeAreaInsets(scene, safeArea) : zeroInsets();
+        const left = viewport.x + insets.left;
+        const right = viewport.x + viewport.width - insets.right;
+        const top = viewport.y + insets.top;
+        const bottom = viewport.y + viewport.height - insets.bottom;
+        const availableWidth = Math.max(0, right - left);
+        const availableHeight = Math.max(0, bottom - top);
+        const size = getDisplaySize(target);
+        const halfW = size.width / 2;
+        const halfH = size.height / 2;
+        const x = computeAnchoredX(anchor, left, availableWidth, right, halfW) + offsetX;
+        const y = computeAnchoredY(anchor, top, availableHeight, bottom, halfH) + offsetY;
+        setTargetPosition(target, x, y);
+    };
+    const onResize = () => {
+        placeTarget();
+    };
+    if (autoResize) {
+        scene.scale.on("resize", onResize);
+    }
+    scene.events.once("shutdown", destroyHandle);
+    attachAutoDestroy(target, () => {
+        destroyHandle();
+    });
+    placeTarget();
+    function destroyHandle() {
+        if (destroyed)
+            return;
+        destroyed = true;
+        if (autoResize) {
+            scene.scale.off("resize", onResize);
+        }
+        scene.events.off("shutdown", destroyHandle);
+    }
+    return {
+        update: placeTarget,
+        destroy: destroyHandle,
+        isDestroyed: () => destroyed,
+        getSafeAreaInsets: () => (useSafeArea ? getSafeAreaInsets(scene, safeArea) : zeroInsets()),
+    };
+}
+/**
+ * Resolve safe-area insets in game units.
+ *
+ * Uses browser CSS env(safe-area-inset-*) values when available,
+ * then applies optional caller-provided extra insets.
+ */
+export function getSafeAreaInsets(scene, options = {}) {
+    const { extraInsets, useCssEnvInsets = true } = options;
+    const cssInsetsPx = useCssEnvInsets ? getCssSafeAreaInsetsPx() : zeroInsets();
+    const scale = getCanvasToGameScale(scene);
+    return {
+        left: Math.max(0, cssInsetsPx.left * scale.x + (extraInsets?.left ?? 0)),
+        right: Math.max(0, cssInsetsPx.right * scale.x + (extraInsets?.right ?? 0)),
+        top: Math.max(0, cssInsetsPx.top * scale.y + (extraInsets?.top ?? 0)),
+        bottom: Math.max(0, cssInsetsPx.bottom * scale.y + (extraInsets?.bottom ?? 0)),
+    };
+}
+let safeAreaProbe = null;
+function getCssSafeAreaInsetsPx() {
+    if (typeof document === "undefined")
+        return zeroInsets();
+    if (!safeAreaProbe) {
+        safeAreaProbe = document.createElement("div");
+        safeAreaProbe.style.position = "fixed";
+        safeAreaProbe.style.left = "0";
+        safeAreaProbe.style.top = "0";
+        safeAreaProbe.style.width = "0";
+        safeAreaProbe.style.height = "0";
+        safeAreaProbe.style.paddingLeft = "env(safe-area-inset-left)";
+        safeAreaProbe.style.paddingRight = "env(safe-area-inset-right)";
+        safeAreaProbe.style.paddingTop = "env(safe-area-inset-top)";
+        safeAreaProbe.style.paddingBottom = "env(safe-area-inset-bottom)";
+        safeAreaProbe.style.pointerEvents = "none";
+        safeAreaProbe.style.visibility = "hidden";
+        document.body.appendChild(safeAreaProbe);
+    }
+    const styles = getComputedStyle(safeAreaProbe);
+    return {
+        left: toFiniteNumber(styles.paddingLeft),
+        right: toFiniteNumber(styles.paddingRight),
+        top: toFiniteNumber(styles.paddingTop),
+        bottom: toFiniteNumber(styles.paddingBottom),
+    };
+}
+function getCanvasToGameScale(scene) {
+    const canvas = scene.game.canvas;
+    if (!canvas || typeof canvas.getBoundingClientRect !== "function")
+        return { x: 1, y: 1 };
+    const rect = canvas.getBoundingClientRect();
+    if (rect.width <= 0 || rect.height <= 0)
+        return { x: 1, y: 1 };
+    return {
+        x: scene.scale.width / rect.width,
+        y: scene.scale.height / rect.height,
+    };
+}
+function getViewportRect(scene) {
+    if (typeof scene.scale.getViewPort === "function") {
+        const out = scene.scale.getViewPort(scene.cameras.main);
+        if (out)
+            return out;
+    }
+    return new Phaser.Geom.Rectangle(0, 0, scene.scale.width, scene.scale.height);
+}
+function getDisplaySize(target) {
+    const withDisplay = target;
+    if (typeof withDisplay.displayWidth === "number" || typeof withDisplay.displayHeight === "number") {
+        return {
+            width: Math.max(0, withDisplay.displayWidth ?? 0),
+            height: Math.max(0, withDisplay.displayHeight ?? 0),
+        };
+    }
+    const withSize = target;
+    if (typeof withSize.width === "number" || typeof withSize.height === "number") {
+        return {
+            width: Math.max(0, withSize.width ?? 0),
+            height: Math.max(0, withSize.height ?? 0),
+        };
+    }
+    if (typeof target.getBounds === "function") {
+        const bounds = target.getBounds();
+        return { width: Math.max(0, bounds.width), height: Math.max(0, bounds.height) };
+    }
+    return { width: 0, height: 0 };
+}
+function setTargetPosition(target, x, y) {
+    const transform = target;
+    if (typeof transform.setPosition !== "function") {
+        throw new Error("anchorToViewport: target does not support setPosition(x, y)");
+    }
+    transform.setPosition(x, y);
+}
+function attachAutoDestroy(target, onDestroy) {
+    const emitter = target;
+    if (typeof emitter.once !== "function")
+        return;
+    emitter.once("destroy", onDestroy);
+}
+function computeAnchoredX(anchor, left, availableWidth, right, halfWidth) {
+    switch (anchor) {
+        case "top-left":
+        case "center-left":
+        case "bottom-left":
+            return left + halfWidth;
+        case "top-center":
+        case "center":
+        case "bottom-center":
+            return left + availableWidth / 2;
+        case "top-right":
+        case "center-right":
+        case "bottom-right":
+            return right - halfWidth;
+        default:
+            return left + halfWidth;
+    }
+}
+function computeAnchoredY(anchor, top, availableHeight, bottom, halfHeight) {
+    switch (anchor) {
+        case "top-left":
+        case "top-center":
+        case "top-right":
+            return top + halfHeight;
+        case "center-left":
+        case "center":
+        case "center-right":
+            return top + availableHeight / 2;
+        case "bottom-left":
+        case "bottom-center":
+        case "bottom-right":
+            return bottom - halfHeight;
+        default:
+            return top + halfHeight;
+    }
+}
+function toFiniteNumber(value) {
+    const parsed = Number.parseFloat(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function zeroInsets() {
+    return { left: 0, right: 0, top: 0, bottom: 0 };
+}
+//# sourceMappingURL=anchorToViewport.js.map

package/dist/anchorToViewport.js.map

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

package/dist/bindDebugControl.d.ts

@@ -0,0 +1,42 @@
+export interface DebugControlAdapter<TControl, TValue> {
+    read(control: TControl): TValue;
+    write(control: TControl, value: TValue): void;
+    subscribe?(control: TControl, onValue: (value: TValue) => void): (() => void) | void;
+}
+export interface BindDebugControlOptions<TControl, TValue> {
+    /** UI control instance to bind. */
+    control: TControl;
+    /** Optional explicit scene (auto-detected from control.scene when omitted). */
+    scene?: Phaser.Scene;
+    /** Model object used with `path` for get/set. */
+    target?: Record<string, unknown>;
+    /** Dot/bracket path (e.g. "player.speed" / "items[0].enabled"). */
+    path?: string;
+    /** Custom model getter (alternative to `target` + `path`). */
+    getValue?: () => TValue;
+    /** Custom model setter (alternative to `target` + `path`). */
+    setValue?: (value: TValue) => void;
+    /** Optional control adapter; inferred for known controls when omitted. */
+    adapter?: Partial<DebugControlAdapter<TControl, TValue>>;
+    /** Compare model/control values (default: Object.is). */
+    equals?: (a: TValue, b: TValue) => boolean;
+    /** Sync model -> control once at bind time (default: true). */
+    syncFromModelOnBind?: boolean;
+    /** Poll model each frame and push updates to control (default: true). */
+    syncFromModelEachFrame?: boolean;
+}
+export interface DebugControlBinding<TValue> {
+    syncFromModel(): void;
+    syncFromControl(): void;
+    getModelValue(): TValue;
+    destroy(): void;
+    isDestroyed(): boolean;
+}
+/**
+ * Two-way data binding between a debug control and a model source.
+ *
+ * Control -> model updates happen via control events.
+ * Model -> control updates happen on preupdate polling (or manual sync).
+ */
+export declare function bindDebugControl<TControl, TValue>(options: BindDebugControlOptions<TControl, TValue>): DebugControlBinding<TValue>;
+//# sourceMappingURL=bindDebugControl.d.ts.map

package/dist/bindDebugControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindDebugControl.d.ts","sourceRoot":"","sources":["../src/bindDebugControl.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB,CAAC,QAAQ,EAAE,MAAM;IACpD,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC/B,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;CACpF;AAED,MAAM,WAAW,uBAAuB,CAAC,QAAQ,EAAE,MAAM;IACxD,mCAAmC;IACnC,OAAO,EAAE,QAAQ,CAAA;IACjB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAA;IACpB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;IACxD,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1C,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,yEAAyE;IACzE,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,mBAAmB,CAAC,MAAM;IAC1C,aAAa,IAAI,IAAI,CAAA;IACrB,eAAe,IAAI,IAAI,CAAA;IACvB,aAAa,IAAI,MAAM,CAAA;IACvB,OAAO,IAAI,IAAI,CAAA;IACf,WAAW,IAAI,OAAO,CAAA;CACtB;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAChD,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAChD,mBAAmB,CAAC,MAAM,CAAC,CAuG7B"}

package/dist/bindDebugControl.js

@@ -0,0 +1,254 @@
+/**
+ * Two-way data binding between a debug control and a model source.
+ *
+ * Control -> model updates happen via control events.
+ * Model -> control updates happen on preupdate polling (or manual sync).
+ */
+export function bindDebugControl(options) {
+    const { control, scene: sceneFromOptions, equals = Object.is, syncFromModelOnBind = true, syncFromModelEachFrame = true, } = options;
+    const scene = sceneFromOptions ?? getSceneFromControl(control);
+    const model = resolveModelAccess(options);
+    const adapter = resolveControlAdapter(control, options.adapter);
+    let destroyed = false;
+    let pushingModelToControl = false;
+    let pushingControlToModel = false;
+    let hasLastModelValue = false;
+    let lastModelValue = null;
+    let unsubscribeControl = null;
+    const syncModelIntoControl = () => {
+        if (destroyed || pushingControlToModel)
+            return;
+        const modelValue = model.get();
+        if (hasLastModelValue && equals(modelValue, lastModelValue))
+            return;
+        pushingModelToControl = true;
+        adapter.write(control, modelValue);
+        pushingModelToControl = false;
+        lastModelValue = modelValue;
+        hasLastModelValue = true;
+    };
+    const syncControlIntoModel = () => {
+        if (destroyed || pushingModelToControl)
+            return;
+        const controlValue = adapter.read(control);
+        if (hasLastModelValue && equals(controlValue, lastModelValue))
+            return;
+        pushingControlToModel = true;
+        model.set(controlValue);
+        pushingControlToModel = false;
+        lastModelValue = controlValue;
+        hasLastModelValue = true;
+    };
+    if (adapter.subscribe) {
+        const maybeUnsub = adapter.subscribe(control, (value) => {
+            if (destroyed || pushingModelToControl)
+                return;
+            if (hasLastModelValue && equals(value, lastModelValue))
+                return;
+            pushingControlToModel = true;
+            model.set(value);
+            pushingControlToModel = false;
+            lastModelValue = value;
+            hasLastModelValue = true;
+        });
+        if (typeof maybeUnsub === "function") {
+            unsubscribeControl = maybeUnsub;
+        }
+    }
+    const preupdate = () => {
+        if (!syncFromModelEachFrame)
+            return;
+        syncModelIntoControl();
+    };
+    if (scene) {
+        scene.events.on("preupdate", preupdate);
+        scene.events.once("shutdown", destroyBinding);
+    }
+    attachAutoDestroy(control, () => {
+        destroyBinding();
+    });
+    if (syncFromModelOnBind) {
+        syncModelIntoControl();
+    }
+    function destroyBinding() {
+        if (destroyed)
+            return;
+        destroyed = true;
+        if (scene) {
+            scene.events.off("preupdate", preupdate);
+            scene.events.off("shutdown", destroyBinding);
+        }
+        if (unsubscribeControl) {
+            unsubscribeControl();
+            unsubscribeControl = null;
+        }
+    }
+    return {
+        syncFromModel: syncModelIntoControl,
+        syncFromControl: syncControlIntoModel,
+        getModelValue: model.get,
+        destroy: destroyBinding,
+        isDestroyed: () => destroyed,
+    };
+}
+function resolveModelAccess(options) {
+    if (options.getValue && options.setValue) {
+        return {
+            get: options.getValue,
+            set: options.setValue,
+        };
+    }
+    const { target, path } = options;
+    if (!target || !path) {
+        throw new Error('bindDebugControl: provide either `getValue`+`setValue` or `target`+`path`');
+    }
+    const tokens = parsePath(path);
+    if (tokens.length === 0) {
+        throw new Error("bindDebugControl: path cannot be empty");
+    }
+    return {
+        get: () => getValueAtPath(target, tokens),
+        set: (value) => {
+            setValueAtPath(target, tokens, value);
+        },
+    };
+}
+function resolveControlAdapter(control, partial) {
+    const inferred = inferAdapter(control);
+    const read = (partial?.read ?? inferred?.read);
+    const write = (partial?.write ?? inferred?.write);
+    const subscribe = (partial?.subscribe ?? inferred?.subscribe);
+    if (!read || !write) {
+        throw new Error("bindDebugControl: could not infer control adapter. Provide adapter.read + adapter.write (and adapter.subscribe for two-way).");
+    }
+    return {
+        read,
+        write,
+        subscribe,
+    };
+}
+function inferAdapter(control) {
+    const anyControl = control;
+    const hasSwitchApi = typeof anyControl.getCurrentOption === "function" &&
+        typeof anyControl.setOptionByKey === "function" &&
+        typeof anyControl.on === "function" &&
+        typeof anyControl.off === "function";
+    if (hasSwitchApi) {
+        return {
+            read: (ctrl) => {
+                const c = ctrl;
+                return (c.getCurrentOption()?.key ?? null);
+            },
+            write: (ctrl, value) => {
+                const c = ctrl;
+                if (typeof c.setOptionByKey === "function") {
+                    c.setOptionByKey(value);
+                    return;
+                }
+                if (typeof c.setOptionIndex === "function" && typeof value === "number") {
+                    c.setOptionIndex(value);
+                }
+            },
+            subscribe: (ctrl, onValue) => {
+                const c = ctrl;
+                const handler = (option) => onValue(option.key);
+                c.on("option-changed", handler);
+                return () => c.off("option-changed", handler);
+            },
+        };
+    }
+    const hasValueApi = typeof anyControl.getValue === "function" && typeof anyControl.setValue === "function";
+    if (hasValueApi) {
+        return {
+            read: (ctrl) => {
+                const c = ctrl;
+                return c.getValue();
+            },
+            write: (ctrl, value) => {
+                const c = ctrl;
+                c.setValue(value);
+            },
+        };
+    }
+    return null;
+}
+function attachAutoDestroy(control, onDestroy) {
+    const maybeEmitter = control;
+    if (typeof maybeEmitter.once !== "function")
+        return;
+    maybeEmitter.once("destroy", onDestroy);
+}
+function getSceneFromControl(control) {
+    const maybeScene = control.scene;
+    return maybeScene ?? null;
+}
+function parsePath(path) {
+    const tokens = [];
+    const re = /[^.[\]]+|\[(\d+)\]/g;
+    let match;
+    while ((match = re.exec(path)) !== null) {
+        const indexValue = match[1];
+        if (indexValue !== undefined) {
+            tokens.push(Number(indexValue));
+            continue;
+        }
+        const key = match[0];
+        if (key)
+            tokens.push(key);
+    }
+    return tokens;
+}
+function getValueAtPath(obj, tokens) {
+    let cursor = obj;
+    for (const token of tokens) {
+        if (cursor === null || cursor === undefined)
+            return undefined;
+        if (typeof token === "number") {
+            if (!Array.isArray(cursor))
+                return undefined;
+            cursor = cursor[token];
+            continue;
+        }
+        cursor = cursor[token];
+    }
+    return cursor;
+}
+function setValueAtPath(obj, tokens, value) {
+    if (tokens.length === 0)
+        return;
+    let cursor = obj;
+    for (let i = 0; i < tokens.length - 1; i++) {
+        const token = tokens[i];
+        const nextToken = tokens[i + 1];
+        if (token === undefined || nextToken === undefined)
+            return;
+        if (typeof token === "number") {
+            if (!Array.isArray(cursor))
+                return;
+            const nextValue = cursor[token];
+            if (nextValue === null || nextValue === undefined) {
+                cursor[token] = typeof nextToken === "number" ? [] : {};
+            }
+            cursor = cursor[token];
+            continue;
+        }
+        const record = cursor;
+        const nextValue = record[token];
+        if (nextValue === null || nextValue === undefined) {
+            record[token] = typeof nextToken === "number" ? [] : {};
+        }
+        cursor = record[token];
+    }
+    const lastToken = tokens[tokens.length - 1];
+    if (lastToken === undefined)
+        return;
+    if (typeof lastToken === "number") {
+        if (!Array.isArray(cursor))
+            return;
+        cursor[lastToken] = value;
+        return;
+    }
+    ;
+    cursor[lastToken] = value;
+}
+//# sourceMappingURL=bindDebugControl.js.map

package/dist/bindDebugControl.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,11 @@
 export type { HexColor, Position, Size, ClickHandler, DebugImageIconOptions, IconSide } from "./types.js";
 export { parseHex, toColorInt, dimHex, hexToColorAlpha, estimateTextWidth, getDevicePixelRatio } from "./utils.js";
+export { bindDebugControl } from "./bindDebugControl.js";
+export type { BindDebugControlOptions, DebugControlAdapter, DebugControlBinding } from "./bindDebugControl.js";
+export { anchorToViewport, getSafeAreaInsets } from "./anchorToViewport.js";
+export type { AnchorToViewportOptions, SafeAreaInsets, SafeAreaOptions, ViewportAnchor, ViewportAnchorHandle } from "./anchorToViewport.js";
+export { layoutAuto } from "./layoutAuto.js";
+export type { LayoutAutoOptions, LayoutAutoScheduler, LayoutAutoTarget } from "./layoutAuto.js";
 export { DebugPanel, createDebugPanel } from "./DebugPanel.js";
 export type { CreateDebugPanelOptions } from "./DebugPanel.js";
 export { DebugLabel, createDebugLabel } from "./DebugLabel.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGzG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGlH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACjE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAGhE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAGtF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAChF,YAAY,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAGxG,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACnF,YAAY,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAG/G,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC9E,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAEvE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACvF,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAA;AAE7E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AACjF,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AAEzE,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAC5F,YAAY,EAAE,iCAAiC,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGzG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAClH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC9G,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC3E,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC3I,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG/F,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACjE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAGhE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAGtF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAChF,YAAY,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAGxG,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACnF,YAAY,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAG/G,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC9E,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAEvE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACvF,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAA;AAE7E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AACjF,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AAEzE,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAC5F,YAAY,EAAE,iCAAiC,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/index.js

@@ -1,5 +1,8 @@
 // Utilities
 export { parseHex, toColorInt, dimHex, hexToColorAlpha, estimateTextWidth, getDevicePixelRatio } from "./utils.js";
+export { bindDebugControl } from "./bindDebugControl.js";
+export { anchorToViewport, getSafeAreaInsets } from "./anchorToViewport.js";
+export { layoutAuto } from "./layoutAuto.js";
 // Panel
 export { DebugPanel, createDebugPanel } from "./DebugPanel.js";
 // Label

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAElH,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGjE,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGhF,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAGnF,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAG9E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAGvF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAGjF,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAClH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG5C,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGjE,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG9D,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGhF,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAGnF,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAG9E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAGvF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAGjF,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/layoutAuto.d.ts

@@ -0,0 +1,25 @@
+export interface LayoutAutoTarget {
+    layout(): unknown;
+}
+export interface LayoutAutoOptions {
+    /** Scene event used for flushing dirty targets (default: "preupdate"). */
+    flushEvent?: "preupdate" | "postupdate";
+}
+export interface LayoutAutoScheduler {
+    markDirty(target: LayoutAutoTarget): this;
+    markDirtyMany(targets: LayoutAutoTarget[]): this;
+    remove(target: LayoutAutoTarget): this;
+    clear(): this;
+    flush(): this;
+    destroy(): void;
+    isDestroyed(): boolean;
+    getDirtyCount(): number;
+}
+/**
+ * Frame-batched layout scheduler for row/column/grid/scroll containers.
+ *
+ * Call `markDirty(...)` after mutating children/options.
+ * Pending targets are laid out once per frame.
+ */
+export declare function layoutAuto(scene: Phaser.Scene, options?: LayoutAutoOptions): LayoutAutoScheduler;
+//# sourceMappingURL=layoutAuto.d.ts.map

package/dist/layoutAuto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutAuto.d.ts","sourceRoot":"","sources":["../src/layoutAuto.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,MAAM,IAAI,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,WAAW,GAAG,YAAY,CAAA;CACvC;AAED,MAAM,WAAW,mBAAmB;IACnC,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACzC,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAA;IAChD,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACtC,KAAK,IAAI,IAAI,CAAA;IACb,KAAK,IAAI,IAAI,CAAA;IACb,OAAO,IAAI,IAAI,CAAA;IACf,WAAW,IAAI,OAAO,CAAA;IACtB,aAAa,IAAI,MAAM,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,iBAAsB,GAAG,mBAAmB,CAmEpG"}

package/dist/layoutAuto.js

@@ -0,0 +1,76 @@
+/**
+ * Frame-batched layout scheduler for row/column/grid/scroll containers.
+ *
+ * Call `markDirty(...)` after mutating children/options.
+ * Pending targets are laid out once per frame.
+ */
+export function layoutAuto(scene, options = {}) {
+    const { flushEvent = "preupdate" } = options;
+    const dirty = new Set();
+    let destroyed = false;
+    let isFlushing = false;
+    const onFlushEvent = () => {
+        if (destroyed || dirty.size === 0)
+            return;
+        flushNow();
+    };
+    scene.events.on(flushEvent, onFlushEvent);
+    scene.events.once("shutdown", () => {
+        destroyScheduler();
+    });
+    const flushNow = () => {
+        if (destroyed || dirty.size === 0 || isFlushing)
+            return;
+        isFlushing = true;
+        const queue = Array.from(dirty);
+        dirty.clear();
+        for (const target of queue) {
+            if (destroyed)
+                break;
+            target.layout();
+        }
+        isFlushing = false;
+    };
+    const destroyScheduler = () => {
+        if (destroyed)
+            return;
+        destroyed = true;
+        dirty.clear();
+        scene.events.off(flushEvent, onFlushEvent);
+    };
+    return {
+        markDirty(target) {
+            if (destroyed)
+                return this;
+            dirty.add(target);
+            return this;
+        },
+        markDirtyMany(targets) {
+            if (destroyed || targets.length === 0)
+                return this;
+            for (const target of targets)
+                dirty.add(target);
+            return this;
+        },
+        remove(target) {
+            if (destroyed)
+                return this;
+            dirty.delete(target);
+            return this;
+        },
+        clear() {
+            if (destroyed)
+                return this;
+            dirty.clear();
+            return this;
+        },
+        flush() {
+            flushNow();
+            return this;
+        },
+        destroy: destroyScheduler,
+        isDestroyed: () => destroyed,
+        getDirtyCount: () => dirty.size,
+    };
+}
+//# sourceMappingURL=layoutAuto.js.map

package/dist/layoutAuto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutAuto.js","sourceRoot":"","sources":["../src/layoutAuto.ts"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAmB,EAAE,UAA6B,EAAE;IAC9E,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,GAAG,OAAO,CAAA;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IACzC,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,IAAI,UAAU,GAAG,KAAK,CAAA;IAEtB,MAAM,YAAY,GAAG,GAAS,EAAE;QAC/B,IAAI,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,OAAM;QACzC,QAAQ,EAAE,CAAA;IACX,CAAC,CAAA;IAED,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IACzC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;QAClC,gBAAgB,EAAE,CAAA;IACnB,CAAC,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC3B,IAAI,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU;YAAE,OAAM;QACvD,UAAU,GAAG,IAAI,CAAA;QAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,KAAK,CAAC,KAAK,EAAE,CAAA;QAEb,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC5B,IAAI,SAAS;gBAAE,MAAK;YACpB,MAAM,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC;QAED,UAAU,GAAG,KAAK,CAAA;IACnB,CAAC,CAAA;IAED,MAAM,gBAAgB,GAAG,GAAS,EAAE;QACnC,IAAI,SAAS;YAAE,OAAM;QACrB,SAAS,GAAG,IAAI,CAAA;QAChB,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IAC3C,CAAC,CAAA;IAED,OAAO;QACN,SAAS,CAAC,MAAwB;YACjC,IAAI,SAAS;gBAAE,OAAO,IAAI,CAAA;YAC1B,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACjB,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,aAAa,CAAC,OAA2B;YACxC,IAAI,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YAClD,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAC/C,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,MAAM,CAAC,MAAwB;YAC9B,IAAI,SAAS;gBAAE,OAAO,IAAI,CAAA;YAC1B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACpB,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,KAAK;YACJ,IAAI,SAAS;gBAAE,OAAO,IAAI,CAAA;YAC1B,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,KAAK;YACJ,QAAQ,EAAE,CAAA;YACV,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,OAAO,EAAE,gBAAgB;QACzB,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;QAC5B,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI;KAC/B,CAAA;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/phaser-dev-ui",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "Pure-code debug UI primitives for Phaser 3 games — panels, buttons, labels, badges, progress bars, switch buttons, and layout containers. No assets required.",
 	"type": "module",
 	"main": "dist/index.js",