@vforsh/phaser-dev-ui 0.1.0

package/dist/DebugPanel.d.ts

@@ -0,0 +1,67 @@
+import type { HexColor, Position, Size } from "./types.js";
+export interface CreateDebugPanelOptions {
+    /** Panel width (default: 400) */
+    width?: number;
+    /** Panel height (default: 400) */
+    height?: number;
+    /** Corner radius (default: 10) */
+    cornerRadius?: number;
+    /** Background fill color (default: "#000000") */
+    fillColor?: HexColor;
+    /** Stroke/border color (default: "#a3a3a3") */
+    strokeColor?: HexColor;
+    /** Stroke thickness (default: 4) */
+    strokeThickness?: number;
+    /** Shadow color (default: "#00000032") */
+    shadowColor?: HexColor;
+    /** Shadow Y offset in pixels (default: 4) */
+    shadowOffsetY?: number;
+    /** Position (optional) */
+    position?: Position;
+    /** Block pointer events from passing through (default: false) */
+    blockInputEvents?: boolean;
+}
+/**
+ * A rectangular debug panel rendered with Phaser Graphics.
+ *
+ * All rendering is code-only — no sprites or assets required.
+ * Supports background fill, stroke border, drop shadow, and rounded corners.
+ * Chainable API for styling.
+ */
+export declare class DebugPanel extends Phaser.GameObjects.Container {
+    private _bg;
+    private _shadow;
+    private _width;
+    private _height;
+    private _cornerRadius;
+    private _fillColor;
+    private _strokeColor;
+    private _strokeThickness;
+    private _shadowColor;
+    private _shadowOffsetY;
+    private _shadowVisible;
+    private _hitArea;
+    constructor(scene: Phaser.Scene, options?: CreateDebugPanelOptions);
+    setBgColor(color: HexColor): this;
+    setStrokeColor(color: HexColor): this;
+    setStrokeThickness(thickness: number): this;
+    setShadowColor(color: HexColor): this;
+    setShadowVisible(visible: boolean): this;
+    setCornerRadius(radius: number): this;
+    setPanelSize(width: number, height: number): this;
+    setStyle(options: {
+        size?: Size;
+        bgColor?: HexColor;
+        strokeColor?: HexColor;
+        strokeThickness?: number;
+        shadowColor?: HexColor;
+        shadowVisible?: boolean;
+        cornerRadius?: number;
+    }): this;
+    getPanelWidth(): number;
+    getPanelHeight(): number;
+    private redraw;
+}
+/** Factory function — mirrors the Cocos `createDebugPanel()` API. */
+export declare function createDebugPanel(scene: Phaser.Scene, options?: CreateDebugPanelOptions): DebugPanel;
+//# sourceMappingURL=DebugPanel.d.ts.map

package/dist/DebugPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugPanel.d.ts","sourceRoot":"","sources":["../src/DebugPanel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAG1D,MAAM,WAAW,uBAAuB;IACvC,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,SAAS,CAAC,EAAE,QAAQ,CAAA;IACpB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,QAAQ,CAAA;IACtB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,QAAQ,CAAA;IACtB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,MAAM,CAAC,WAAW,CAAC,SAAS;IAC3D,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAA4C;gBAEhD,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,uBAA4B;IA4CtE,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMjC,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMrC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM3C,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMrC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMxC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMrC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAWjD,QAAQ,CAAC,OAAO,EAAE;QACjB,IAAI,CAAC,EAAE,IAAI,CAAA;QACX,OAAO,CAAC,EAAE,QAAQ,CAAA;QAClB,WAAW,CAAC,EAAE,QAAQ,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,WAAW,CAAC,EAAE,QAAQ,CAAA;QACtB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,YAAY,CAAC,EAAE,MAAM,CAAA;KACrB,GAAG,IAAI;IAYR,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAMxB,OAAO,CAAC,MAAM;CAwBd;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAEvG"}

package/dist/DebugPanel.js

@@ -0,0 +1,138 @@
+import { hexToColorAlpha } from "./utils.js";
+/**
+ * A rectangular debug panel rendered with Phaser Graphics.
+ *
+ * All rendering is code-only — no sprites or assets required.
+ * Supports background fill, stroke border, drop shadow, and rounded corners.
+ * Chainable API for styling.
+ */
+export class DebugPanel extends Phaser.GameObjects.Container {
+    _bg;
+    _shadow;
+    _width;
+    _height;
+    _cornerRadius;
+    _fillColor;
+    _strokeColor;
+    _strokeThickness;
+    _shadowColor;
+    _shadowOffsetY;
+    _shadowVisible = true;
+    _hitArea = null;
+    constructor(scene, options = {}) {
+        const { width = 400, height = 400, cornerRadius = 10, fillColor = "#000000", strokeColor = "#a3a3a3", strokeThickness = 4, shadowColor = "#00000032", shadowOffsetY = 4, position, blockInputEvents = false, } = options;
+        super(scene, position?.x ?? 0, position?.y ?? 0);
+        this._width = width;
+        this._height = height;
+        this._cornerRadius = cornerRadius;
+        this._fillColor = fillColor;
+        this._strokeColor = strokeColor;
+        this._strokeThickness = strokeThickness;
+        this._shadowColor = shadowColor;
+        this._shadowOffsetY = shadowOffsetY;
+        this.setSize(width, height);
+        this._shadow = scene.add.graphics();
+        this._bg = scene.add.graphics();
+        this.add([this._shadow, this._bg]);
+        if (blockInputEvents) {
+            this._hitArea = scene.add.rectangle(0, 0, width, height, 0x000000, 0);
+            this._hitArea.setInteractive();
+            this.add(this._hitArea);
+            this.sendToBack(this._hitArea);
+        }
+        this.redraw();
+        scene.add.existing(this);
+    }
+    // -- Chainable setters --
+    setBgColor(color) {
+        this._fillColor = color;
+        this.redraw();
+        return this;
+    }
+    setStrokeColor(color) {
+        this._strokeColor = color;
+        this.redraw();
+        return this;
+    }
+    setStrokeThickness(thickness) {
+        this._strokeThickness = thickness;
+        this.redraw();
+        return this;
+    }
+    setShadowColor(color) {
+        this._shadowColor = color;
+        this.redraw();
+        return this;
+    }
+    setShadowVisible(visible) {
+        this._shadowVisible = visible;
+        this._shadow.setVisible(visible);
+        return this;
+    }
+    setCornerRadius(radius) {
+        this._cornerRadius = radius;
+        this.redraw();
+        return this;
+    }
+    setPanelSize(width, height) {
+        this._width = width;
+        this._height = height;
+        this.setSize(width, height);
+        if (this._hitArea) {
+            this._hitArea.setSize(width, height);
+        }
+        this.redraw();
+        return this;
+    }
+    setStyle(options) {
+        if (options.size)
+            this.setPanelSize(options.size.width, options.size.height);
+        if (options.bgColor)
+            this._fillColor = options.bgColor;
+        if (options.strokeColor)
+            this._strokeColor = options.strokeColor;
+        if (options.strokeThickness !== undefined)
+            this._strokeThickness = options.strokeThickness;
+        if (options.shadowColor)
+            this._shadowColor = options.shadowColor;
+        if (options.shadowVisible !== undefined)
+            this.setShadowVisible(options.shadowVisible);
+        if (options.cornerRadius !== undefined)
+            this._cornerRadius = options.cornerRadius;
+        this.redraw();
+        return this;
+    }
+    getPanelWidth() {
+        return this._width;
+    }
+    getPanelHeight() {
+        return this._height;
+    }
+    // -- Internal --
+    redraw() {
+        const halfW = this._width / 2;
+        const halfH = this._height / 2;
+        // Shadow
+        this._shadow.clear();
+        if (this._shadowVisible) {
+            const sc = hexToColorAlpha(this._shadowColor);
+            this._shadow.fillStyle(sc.color, sc.alpha);
+            this._shadow.fillRoundedRect(-halfW, -halfH + this._shadowOffsetY, this._width, this._height, this._cornerRadius);
+        }
+        // Background
+        this._bg.clear();
+        const fc = hexToColorAlpha(this._fillColor);
+        this._bg.fillStyle(fc.color, fc.alpha);
+        this._bg.fillRoundedRect(-halfW, -halfH, this._width, this._height, this._cornerRadius);
+        if (this._strokeThickness > 0) {
+            const sc = hexToColorAlpha(this._strokeColor);
+            this._bg.lineStyle(this._strokeThickness, sc.color, sc.alpha);
+            this._bg.strokeRoundedRect(-halfW, -halfH, this._width, this._height, this._cornerRadius);
+        }
+    }
+}
+/** Factory function — mirrors the Cocos `createDebugPanel()` API. */
+export function createDebugPanel(scene, options = {}) {
+    return new DebugPanel(scene, options);
+}
+//# sourceMappingURL=DebugPanel.js.map

package/dist/DebugPanel.js.map

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

package/dist/DebugProgressBar.d.ts

@@ -0,0 +1,47 @@
+import type { HexColor, Position } from "./types.js";
+export interface DebugProgressBarStyleOptions {
+    width?: number;
+    height?: number;
+    trackColor?: HexColor;
+    fillColor?: HexColor;
+    cornerRadius?: number;
+}
+export interface CreateDebugProgressBarOptions extends DebugProgressBarStyleOptions {
+    /** Progress value, 0–1 (default: 0). */
+    value?: number;
+    /** Position (optional). */
+    position?: Position;
+}
+/**
+ * A horizontal progress bar for debug HUD.
+ *
+ * Displays a normalized 0–1 value as a filled track.
+ * Supports rounded corners and configurable track/fill colors.
+ * Chainable API.
+ */
+export declare class DebugProgressBar extends Phaser.GameObjects.Container {
+    private _track;
+    private _fill;
+    private _fillMaskGraphics;
+    private _fillMask;
+    private _width;
+    private _height;
+    private _trackColor;
+    private _fillColor;
+    private _cornerRadius;
+    private _value;
+    constructor(scene: Phaser.Scene, options?: CreateDebugProgressBarOptions);
+    setValue(value: number): this;
+    getValue(): number;
+    setFillColor(color: HexColor): this;
+    setTrackColor(color: HexColor): this;
+    setCornerRadius(radius: number): this;
+    setBarSize(width: number, height: number): this;
+    destroy(fromScene?: boolean): void;
+    setStyle(options: DebugProgressBarStyleOptions): this;
+    private redraw;
+    private redrawTrack;
+    private redrawFill;
+}
+export declare function createDebugProgressBar(scene: Phaser.Scene, options?: CreateDebugProgressBarOptions): DebugProgressBar;
+//# sourceMappingURL=DebugProgressBar.d.ts.map

package/dist/DebugProgressBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugProgressBar.d.ts","sourceRoot":"","sources":["../src/DebugProgressBar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGpD,MAAM,WAAW,4BAA4B;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,QAAQ,CAAA;IACrB,SAAS,CAAC,EAAE,QAAQ,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,6BAA8B,SAAQ,4BAA4B;IAClF,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,MAAM,CAAC,WAAW,CAAC,SAAS;IACjE,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,MAAM,CAAQ;gBAEV,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,6BAAkC;IAqC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,QAAQ,IAAI,MAAM;IAIlB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMnC,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMpC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMrC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQtC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI;IAM3C,QAAQ,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;IAYrD,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,UAAU;CAuBlB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,6BAAkC,GAAG,gBAAgB,CAEzH"}

package/dist/DebugProgressBar.js

@@ -0,0 +1,129 @@
+import { hexToColorAlpha } from "./utils.js";
+/**
+ * A horizontal progress bar for debug HUD.
+ *
+ * Displays a normalized 0–1 value as a filled track.
+ * Supports rounded corners and configurable track/fill colors.
+ * Chainable API.
+ */
+export class DebugProgressBar extends Phaser.GameObjects.Container {
+    _track;
+    _fill;
+    _fillMaskGraphics;
+    _fillMask;
+    _width;
+    _height;
+    _trackColor;
+    _fillColor;
+    _cornerRadius;
+    _value;
+    constructor(scene, options = {}) {
+        const { width = 200, height = 8, trackColor = "#333333", fillColor = "#4caf50", cornerRadius, value = 0, position, } = options;
+        super(scene, position?.x ?? 0, position?.y ?? 0);
+        this._width = width;
+        this._height = height;
+        this._trackColor = trackColor;
+        this._fillColor = fillColor;
+        this._cornerRadius = cornerRadius ?? height / 2;
+        this._value = Math.max(0, Math.min(1, value));
+        this.setSize(width, height);
+        this._track = scene.add.graphics();
+        this._fill = scene.add.graphics();
+        // Mask graphics lives outside the container so GeometryMask
+        // coordinates match the fill's world position.
+        this._fillMaskGraphics = scene.add.graphics();
+        this._fillMaskGraphics.setVisible(false);
+        this._fillMask = this._fillMaskGraphics.createGeometryMask();
+        this._fill.setMask(this._fillMask);
+        this.add([this._track, this._fill]);
+        this.redraw();
+        scene.add.existing(this);
+    }
+    setValue(value) {
+        this._value = Math.max(0, Math.min(1, value));
+        this.redrawFill();
+        return this;
+    }
+    getValue() {
+        return this._value;
+    }
+    setFillColor(color) {
+        this._fillColor = color;
+        this.redrawFill();
+        return this;
+    }
+    setTrackColor(color) {
+        this._trackColor = color;
+        this.redrawTrack();
+        return this;
+    }
+    setCornerRadius(radius) {
+        this._cornerRadius = Math.max(0, radius);
+        this.redraw();
+        return this;
+    }
+    setBarSize(width, height) {
+        this._width = width;
+        this._height = height;
+        this.setSize(width, height);
+        this.redraw();
+        return this;
+    }
+    destroy(fromScene) {
+        this._fill.clearMask(true);
+        this._fillMaskGraphics.destroy();
+        super.destroy(fromScene);
+    }
+    setStyle(options) {
+        if (options.trackColor)
+            this._trackColor = options.trackColor;
+        if (options.fillColor)
+            this._fillColor = options.fillColor;
+        if (options.cornerRadius !== undefined)
+            this._cornerRadius = Math.max(0, options.cornerRadius);
+        if (options.width !== undefined || options.height !== undefined) {
+            this._width = options.width ?? this._width;
+            this._height = options.height ?? this._height;
+        }
+        this.redraw();
+        return this;
+    }
+    redraw() {
+        this.setSize(this._width, this._height);
+        this.redrawTrack();
+        this.redrawFill();
+    }
+    redrawTrack() {
+        const halfW = this._width / 2;
+        const halfH = this._height / 2;
+        const radius = Math.min(this._cornerRadius, halfH);
+        const c = hexToColorAlpha(this._trackColor);
+        this._track.clear();
+        this._track.fillStyle(c.color, c.alpha);
+        this._track.fillRoundedRect(-halfW, -halfH, this._width, this._height, radius);
+    }
+    redrawFill() {
+        const halfW = this._width / 2;
+        const halfH = this._height / 2;
+        const fillWidth = this._width * this._value;
+        const radius = Math.min(this._cornerRadius, halfH);
+        const c = hexToColorAlpha(this._fillColor);
+        this._fill.clear();
+        this._fillMaskGraphics.clear();
+        if (fillWidth <= 0)
+            return;
+        // Draw full-width rounded rect for correct corner shapes
+        this._fill.fillStyle(c.color, c.alpha);
+        this._fill.fillRoundedRect(-halfW, -halfH, this._width, this._height, radius);
+        // Mask lives outside the container — draw in world coordinates
+        const wt = this.getWorldTransformMatrix();
+        const worldX = wt.tx;
+        const worldY = wt.ty;
+        this._fillMaskGraphics.fillStyle(0xffffff, 1);
+        this._fillMaskGraphics.fillRect(worldX - halfW, worldY - halfH, fillWidth, this._height);
+    }
+}
+export function createDebugProgressBar(scene, options = {}) {
+    return new DebugProgressBar(scene, options);
+}
+//# sourceMappingURL=DebugProgressBar.js.map

package/dist/DebugProgressBar.js.map

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

package/dist/DebugRowContainer.d.ts

@@ -0,0 +1,40 @@
+import type { Position } from "./types.js";
+export interface CreateRowContainerOptions {
+    /** Horizontal spacing between children (default: 0). */
+    spacingX?: number;
+    /** Padding (default: 0 all sides). */
+    paddingLeft?: number;
+    paddingRight?: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    /** Direction (default: "left-to-right"). */
+    direction?: "left-to-right" | "right-to-left";
+    /** Position (optional). */
+    position?: Position;
+}
+/**
+ * A horizontal layout container that arranges children in a row.
+ *
+ * After adding children via `addItem()`, call `layout()` to position them.
+ * Items are spaced by `spacingX` with configurable padding.
+ * Children must have a measurable width (use `getBounds().width` or `displayWidth`).
+ */
+export declare class DebugRowContainer extends Phaser.GameObjects.Container {
+    private _spacingX;
+    private _paddingLeft;
+    private _paddingRight;
+    private _paddingTop;
+    private _paddingBottom;
+    private _direction;
+    constructor(scene: Phaser.Scene, options?: CreateRowContainerOptions);
+    addItem(child: Phaser.GameObjects.GameObject): this;
+    addItems(children: Phaser.GameObjects.GameObject[]): this;
+    setSpacingX(spacing: number): this;
+    /** Reposition children according to current spacing/padding. */
+    layout(): this;
+    /** Total width of laid-out children + padding. */
+    getContentWidth(): number;
+    private getItemSize;
+}
+export declare function createRowContainer(scene: Phaser.Scene, options?: CreateRowContainerOptions): DebugRowContainer;
+//# sourceMappingURL=DebugRowContainer.d.ts.map

package/dist/DebugRowContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugRowContainer.d.ts","sourceRoot":"","sources":["../src/DebugRowContainer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,WAAW,yBAAyB;IACzC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,eAAe,GAAG,eAAe,CAAA;IAC7C,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,MAAM,CAAC,WAAW,CAAC,SAAS;IAClE,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,UAAU,CAAmC;gBAEzC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,yBAA8B;IAuBxE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG,IAAI;IAKnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,IAAI;IAKzD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC,gEAAgE;IAChE,MAAM,IAAI,IAAI;IAkBd,kDAAkD;IAClD,eAAe,IAAI,MAAM;IAYzB,OAAO,CAAC,WAAW;CAsBnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,yBAA8B,GAAG,iBAAiB,CAElH"}

package/dist/DebugRowContainer.js

@@ -0,0 +1,91 @@
+/**
+ * A horizontal layout container that arranges children in a row.
+ *
+ * After adding children via `addItem()`, call `layout()` to position them.
+ * Items are spaced by `spacingX` with configurable padding.
+ * Children must have a measurable width (use `getBounds().width` or `displayWidth`).
+ */
+export class DebugRowContainer extends Phaser.GameObjects.Container {
+    _spacingX;
+    _paddingLeft;
+    _paddingRight;
+    _paddingTop;
+    _paddingBottom;
+    _direction;
+    constructor(scene, options = {}) {
+        const { spacingX = 0, paddingLeft = 0, paddingRight = 0, paddingTop = 0, paddingBottom = 0, direction = "left-to-right", position, } = options;
+        super(scene, position?.x ?? 0, position?.y ?? 0);
+        this._spacingX = spacingX;
+        this._paddingLeft = paddingLeft;
+        this._paddingRight = paddingRight;
+        this._paddingTop = paddingTop;
+        this._paddingBottom = paddingBottom;
+        this._direction = direction;
+        scene.add.existing(this);
+    }
+    addItem(child) {
+        this.add(child);
+        return this;
+    }
+    addItems(children) {
+        for (const child of children)
+            this.add(child);
+        return this;
+    }
+    setSpacingX(spacing) {
+        this._spacingX = spacing;
+        return this;
+    }
+    /** Reposition children according to current spacing/padding. */
+    layout() {
+        const items = this.list;
+        let cursor = this._paddingLeft;
+        const ordered = this._direction === "right-to-left" ? [...items].reverse() : items;
+        for (const item of ordered) {
+            const go = item;
+            if (!go.setPosition)
+                continue;
+            const size = this.getItemSize(item);
+            go.setPosition(cursor + size.width / 2, this._paddingTop + size.height / 2);
+            cursor += size.width + this._spacingX;
+        }
+        return this;
+    }
+    /** Total width of laid-out children + padding. */
+    getContentWidth() {
+        const items = this.list;
+        let total = this._paddingLeft + this._paddingRight;
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            if (!item)
+                continue;
+            total += this.getItemSize(item).width;
+            if (i < items.length - 1)
+                total += this._spacingX;
+        }
+        return total;
+    }
+    getItemSize(item) {
+        const withDisplay = item;
+        const widthFromDisplay = typeof withDisplay.displayWidth === "number" ? withDisplay.displayWidth : 0;
+        const heightFromDisplay = typeof withDisplay.displayHeight === "number" ? withDisplay.displayHeight : 0;
+        if (widthFromDisplay > 0 || heightFromDisplay > 0) {
+            return { width: Math.max(0, widthFromDisplay), height: Math.max(0, heightFromDisplay) };
+        }
+        const withSize = item;
+        const widthFromSize = typeof withSize.width === "number" ? withSize.width : 0;
+        const heightFromSize = typeof withSize.height === "number" ? withSize.height : 0;
+        if (widthFromSize > 0 || heightFromSize > 0) {
+            return { width: Math.max(0, widthFromSize), height: Math.max(0, heightFromSize) };
+        }
+        if ("getBounds" in item && typeof item.getBounds === "function") {
+            const bounds = item.getBounds();
+            return { width: Math.max(0, bounds.width), height: Math.max(0, bounds.height) };
+        }
+        return { width: 0, height: 0 };
+    }
+}
+export function createRowContainer(scene, options = {}) {
+    return new DebugRowContainer(scene, options);
+}
+//# sourceMappingURL=DebugRowContainer.js.map

package/dist/DebugRowContainer.js.map

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