hudini 0.2.1 → 0.3.0

package/README.md

@@ -1,4 +1,4 @@
-<img src="data/hudini.png" alt="hudini" />
+<img src="data/hudini.png" style="max-width: 500px" alt="hudini" />
 
 # 🎩 Hudini
 
@@ -6,11 +6,12 @@
 
 **Hudini** is a collection of reusable, themeable UI components for Phaser games. Named after the famous magician Houdini and HUD (Head-Up Display), it provides a magical toolkit for building consistent game interfaces.
 
+> Important: Hudini is fully type‑safe. The entire library is written in TypeScript and uses strict, explicit types for all public APIs (components, layout options, and plugin configuration). You get compile‑time validation and rich IntelliSense everywhere—no runtime guessing.
+
 ## ✨ Features
 
 - 🎨 **Themeable** - Dark/light themes with full customization
-- 🔊 **Sound Integration** - Built-in sound effects for interactions
-- 📦 **Zero Dependencies** - Only requires Phaser as peer dependency
+- 📦 **Phaser-wind Dependency** - Only requires [Phaser-wind](https://github.com/renatocassino/phaser-toolkit/tree/main/packages/phaser-wind)
 - 🎯 **TypeScript First** - Full type safety and IntelliSense
 - 🧪 **Tested** - Comprehensive test coverage
 
@@ -23,3 +24,186 @@ yarn add hudini
 # or
 pnpm add hudini
 ```
+
+## 🔌 Installation (Plugin Setup)
+
+Hudini is built on top of `phaser-wind` for theming and UI primitives. The Hudini plugin will automatically install the `phaser-wind` plugin if it is not already registered. You only need to add Hudini to your Phaser game configuration.
+
+Basic setup with the default light theme:
+
+```ts
+import Phaser from 'phaser';
+import {
+  HudiniPlugin,
+  HUDINI_KEY,
+  HudiniPluginData,
+  createTheme,
+} from 'hudini';
+
+const theme = createTheme({
+  colors: {
+    primary: 'red-300',
+    secondary: 'blue-300',
+  },
+  // This theme is a phaser-wind theme conf. You can read more in https://github.com/renatocassino/phaser-toolkit/tree/main/packages/phaser-wind
+});
+
+type Theme = typeof theme;
+
+new Phaser.Game({
+  type: Phaser.AUTO,
+  width: 800,
+  height: 600,
+  backgroundColor: '#1a1a1a',
+  plugins: {
+    global: [
+      {
+        key: HUDINI_KEY,
+        plugin: HudiniPlugin,
+        mapping: HUDINI_KEY,
+        data: {
+          theme,
+        } as HudiniPluginData<Theme>,
+        /**
+         * If you want to use a default theme, you can import "defaultLightTheme" from hudini
+         * data: {
+         *   theme: defaultLightTheme,
+         * } as HudiniPluginData<Theme>
+         */
+      },
+    ],
+  },
+});
+```
+
+Notes:
+
+- Hudini will ensure `phaser-wind` is available internally. If you prefer, you can also register `phaser-wind` explicitly before Hudini and pass a custom theme.
+- You can pass `darkMode: true` (when no custom theme is provided) to use the default dark theme.
+
+### Requirements
+
+- Phaser (peer dependency)
+
+```bash
+pnpm add phaser
+```
+
+### Import
+
+```ts
+import { Column, Row, IconButton } from 'hudini';
+```
+
+### Live examples
+
+Check the Storybook for live, interactive examples: [Hudini on Storybook](https://renatocassino.github.io/phaser-toolkit/?path=/story/hudini--index)
+
+## 🧩 Components
+
+### Column
+
+Stacks children vertically with spacing, horizontal alignment, and configurable vertical origin.
+
+```ts
+// inside a Phaser.Scene (e.g., in create())
+const spriteA = this.add.sprite(0, 0, 'player');
+const spriteB = this.add.sprite(0, 0, 'enemy');
+
+const column = new Column({
+  scene: this,
+  x: 400,
+  y: 300,
+  gap: 12, // default: 8
+  align: 'center', // 'left' | 'center' | 'right'
+  verticalOrigin: 'top', // 'top' | 'center' | 'bottom'
+  children: [spriteA, spriteB],
+});
+
+// Update layout options later
+column.setGap(20);
+column.setAlign('left');
+
+// Add items dynamically
+const spriteC = this.add.sprite(0, 0, 'coin');
+column.addChild(spriteC); // triggers relayout by default
+```
+
+Key points:
+
+- Horizontal alignment aligns each child's left/center/right edge correctly, respecting per-child origin.
+- `verticalOrigin` controls where the content starts from within the container.
+- The container's position `(x, y)` is the center of the overall content area.
+
+### Row
+
+Arranges children horizontally with spacing, vertical alignment, and configurable horizontal origin.
+
+```ts
+// inside a Phaser.Scene (e.g., in create())
+const heart = this.add.sprite(0, 0, 'heart');
+const gem = this.add.sprite(0, 0, 'gem');
+
+const row = new Row({
+  scene: this,
+  x: 400,
+  y: 80,
+  gap: 10, // default: 8
+  align: 'center', // 'top' | 'center' | 'bottom'
+  horizontalOrigin: 'center', // 'left' | 'center' | 'right'
+  children: [heart, gem],
+});
+
+row.setGap(16);
+row.setAlign('top');
+
+const star = this.add.sprite(0, 0, 'star');
+row.addChild(star);
+```
+
+Key points:
+
+- Vertical alignment aligns each child's top/center/bottom edge correctly, respecting per-child origin.
+- `horizontalOrigin` controls where the content starts from within the container.
+- The container's position `(x, y)` is the center of the overall content area.
+
+### IconButton
+
+An interactive circular icon button with hover and click animations, built on top of `phaser-wind` and `font-awesome-for-phaser`.
+
+```ts
+import { IconButton } from 'hudini';
+// inside a Phaser.Scene (e.g., in create())
+
+const btn = new IconButton({
+  scene: this,
+  x: 100,
+  y: 100,
+  icon: 'solid/heart', // any IconKey from font-awesome-for-phaser
+  size: 'lg', // FontSizeKey or a number (px)
+  color: 'red', // any base color from phaser-wind (except black/white)
+  onClick: () => {
+    // your click handler
+  },
+});
+
+this.add.existing(btn);
+```
+
+Notes:
+
+- Hover scales the icon subtly, click animates press/release.
+- Colors and sizes integrate with `phaser-wind` theme tokens.
+
+## 📦 API Surfaces
+
+- `Column` and `Row` are `Phaser.GameObjects.Container` subclasses. Useful methods:
+  - `setGap(gap: number): void`
+  - `setAlign(...)`: Column → `'left'|'center'|'right'`, Row → `'top'|'center'|'bottom'`
+  - `addChild(child, relayout = true): this`
+  - `addChildren(children, relayout = true): this`
+- `IconButton` constructor accepts `{ scene, x, y, icon, size?, color?, onClick? }`.
+
+## 🔗 Storybook
+
+Explore all components and props in Storybook: [Hudini on Storybook](https://renatocassino.github.io/phaser-toolkit/?path=/story/hudini--index)

package/dist/components/column/column.d.ts

@@ -0,0 +1,88 @@
+import { GameObjects, Scene } from 'phaser';
+/** Horizontal alignment options for column items */
+export type HorizontalAlign = 'left' | 'center' | 'right';
+/** Parameters for creating a Column container */
+export type ColumnParams = {
+    /** The scene this column belongs to */
+    scene: Scene;
+    /** X coordinate of the column */
+    x: number;
+    /** Y coordinate of the column */
+    y: number;
+    /** Gap between elements in pixels */
+    gap?: number;
+    /** Horizontal alignment of elements */
+    align?: HorizontalAlign;
+    /** Initial child elements */
+    children?: GameObjects.GameObject[];
+    /** Vertical origin point of the column */
+    verticalOrigin?: 'top' | 'center' | 'bottom';
+};
+/**
+ * Column is a layout container that stacks children vertically with a gap.
+ * The container position (x, y) represents the center of the whole column.
+ */
+export declare class Column extends GameObjects.Container {
+    /** Gap between elements in pixels */
+    private gap;
+    /** Horizontal alignment of elements */
+    private align;
+    /** Vertical origin point of the column */
+    private verticalOrigin;
+    /**
+     * Creates a new Column container
+     * @param params Configuration parameters for the column
+     */
+    constructor({ scene, x, y, gap, align, children, verticalOrigin, }: ColumnParams);
+    /**
+     * Sets the spacing between children and relayouts
+     * @param gap Gap in pixels between elements
+     */
+    setGap(gap: number): void;
+    /**
+     * Sets the horizontal alignment and relayouts
+     * @param align New horizontal alignment
+     */
+    setAlign(align: HorizontalAlign): void;
+    /**
+     * Adds a child game object to the column
+     * @param child Game object to add
+     * @param relayout Whether to relayout after adding (default: true)
+     * @returns This column instance for chaining
+     */
+    addChild(child: GameObjects.GameObject, relayout?: boolean): this;
+    /**
+     * Adds multiple children to the column
+     * @param children Array of game objects to add
+     * @param relayout Whether to relayout after adding (default: true)
+     * @returns This column instance for chaining
+     */
+    addChildren(children: GameObjects.GameObject[], relayout?: boolean): this;
+    /**
+     * Recomputes children's positions and updates this container size
+     * Positions are calculated based on alignment, origins and gaps
+     */
+    layout(): void;
+    /**
+     * Gets the display width of a game object
+     * @param child GameObject to measure
+     * @returns Display width in pixels
+     */
+    getDisplayWidth(child: GameObjects.GameObject): number;
+    /**
+     * Gets the display height of a game object
+     * @param child GameObject to measure
+     * @returns Display height in pixels
+     */
+    getDisplayHeight(child: GameObjects.GameObject): number;
+    /**
+     * Gets the normalized origin point of a game object
+     * @param child GameObject to get origin from
+     * @returns Object with normalized x,y coordinates of the origin point
+     */
+    getNormalizedOrigin(child: GameObjects.GameObject): {
+        x: number;
+        y: number;
+    };
+}
+//# sourceMappingURL=column.d.ts.map

package/dist/components/column/column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.d.ts","sourceRoot":"","sources":["../../../src/components/column/column.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAS5C,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG;IACzB,uCAAuC;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,iCAAiC;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,iCAAiC;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;IACpC,0CAA0C;IAC1C,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,qBAAa,MAAO,SAAQ,WAAW,CAAC,SAAS;IAC/C,qCAAqC;IACrC,OAAO,CAAC,GAAG,CAAS;IACpB,uCAAuC;IACvC,OAAO,CAAC,KAAK,CAAkB;IAC/B,0CAA0C;IAC1C,OAAO,CAAC,cAAc,CAA8B;IAEpD;;;OAGG;gBACS,EACV,KAAK,EACL,CAAC,EACD,CAAC,EACD,GAAiB,EACjB,KAAgB,EAChB,QAAa,EACb,cAAsB,GACvB,EAAE,YAAY;IAaf;;;OAGG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAK7C;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,GAAE,OAAc,GAAG,IAAI;IAM9E;;;;;OAKG;IACI,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,EAAE,EAAE,QAAQ,GAAE,OAAc,GAAG,IAAI;IAMtF;;;OAGG;IACI,MAAM,IAAI,IAAI;IAkDrB;;;;OAIG;IACI,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,GAAG,MAAM;IAI7D;;;;OAIG;IACI,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,GAAG,MAAM;IAI9D;;;;OAIG;IACI,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;CAGpF"}

package/dist/components/column/column.js

@@ -0,0 +1,142 @@
+/* eslint-disable complexity */
+import { GameObjects } from 'phaser';
+import { DEFAULT_GAP, getDisplayHeightOf, getDisplayWidthOf, getNormalizedOriginOf, } from '../layout/layout-utils';
+/**
+ * Column is a layout container that stacks children vertically with a gap.
+ * The container position (x, y) represents the center of the whole column.
+ */
+export class Column extends GameObjects.Container {
+    /** Gap between elements in pixels */
+    gap;
+    /** Horizontal alignment of elements */
+    align;
+    /** Vertical origin point of the column */
+    verticalOrigin;
+    /**
+     * Creates a new Column container
+     * @param params Configuration parameters for the column
+     */
+    constructor({ scene, x, y, gap = DEFAULT_GAP, align = 'center', children = [], verticalOrigin = 'top', }) {
+        super(scene, x, y);
+        this.gap = gap;
+        this.align = align;
+        this.verticalOrigin = verticalOrigin;
+        if (children.length > 0) {
+            this.add(children);
+        }
+        this.layout();
+    }
+    /**
+     * Sets the spacing between children and relayouts
+     * @param gap Gap in pixels between elements
+     */
+    setGap(gap) {
+        this.gap = gap;
+        this.layout();
+    }
+    /**
+     * Sets the horizontal alignment and relayouts
+     * @param align New horizontal alignment
+     */
+    setAlign(align) {
+        this.align = align;
+        this.layout();
+    }
+    /**
+     * Adds a child game object to the column
+     * @param child Game object to add
+     * @param relayout Whether to relayout after adding (default: true)
+     * @returns This column instance for chaining
+     */
+    addChild(child, relayout = true) {
+        this.add(child);
+        if (relayout)
+            this.layout();
+        return this;
+    }
+    /**
+     * Adds multiple children to the column
+     * @param children Array of game objects to add
+     * @param relayout Whether to relayout after adding (default: true)
+     * @returns This column instance for chaining
+     */
+    addChildren(children, relayout = true) {
+        if (children.length > 0)
+            this.add(children);
+        if (relayout)
+            this.layout();
+        return this;
+    }
+    /**
+     * Recomputes children's positions and updates this container size
+     * Positions are calculated based on alignment, origins and gaps
+     */
+    layout() {
+        const children = this.list;
+        if (children.length === 0) {
+            // Reset size when empty
+            this.setSize(0, 0);
+            return;
+        }
+        // Measure sizes and origins
+        const entries = children.map((child) => ({
+            child,
+            width: this.getDisplayWidth(child),
+            height: this.getDisplayHeight(child),
+            origin: this.getNormalizedOrigin(child),
+        }));
+        const maxWidth = entries.reduce((m, s) => Math.max(m, s.width), 0);
+        const totalHeight = entries.reduce((sum, s) => sum + s.height, 0) + this.gap * (entries.length - 1);
+        // Determine top of content based on verticalOrigin
+        const contentTopY = this.verticalOrigin === 'top' ? 0 : this.verticalOrigin === 'center' ? -totalHeight / 2 : -totalHeight;
+        // Walk from top to bottom, aligning considering each child's origin
+        let cursorTopY = contentTopY;
+        for (const { child, width, height, origin } of entries) {
+            // Horizontal alignment: align left/right edges or centers correctly using origin
+            let x = 0;
+            if (this.align === 'left') {
+                // place child's left edge at content left
+                x = -maxWidth / 2 + origin.x * width;
+            }
+            else if (this.align === 'right') {
+                // place child's right edge at content right
+                x = maxWidth / 2 - (1 - origin.x) * width;
+            }
+            else {
+                // center alignment: center of child at 0 accounting for origin
+                x = (origin.x - 0.5) * width;
+            }
+            // Vertical position so that child's top is at cursorTopY
+            const y = cursorTopY + origin.y * height;
+            child.setPosition(x, y);
+            cursorTopY += height + this.gap;
+        }
+        // Update this container size to match content bounds
+        this.setSize(maxWidth, totalHeight);
+    }
+    /**
+     * Gets the display width of a game object
+     * @param child GameObject to measure
+     * @returns Display width in pixels
+     */
+    getDisplayWidth(child) {
+        return getDisplayWidthOf(child);
+    }
+    /**
+     * Gets the display height of a game object
+     * @param child GameObject to measure
+     * @returns Display height in pixels
+     */
+    getDisplayHeight(child) {
+        return getDisplayHeightOf(child);
+    }
+    /**
+     * Gets the normalized origin point of a game object
+     * @param child GameObject to get origin from
+     * @returns Object with normalized x,y coordinates of the origin point
+     */
+    getNormalizedOrigin(child) {
+        return getNormalizedOriginOf(child);
+    }
+}
+//# sourceMappingURL=column.js.map

package/dist/components/column/column.js.map

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

package/dist/components/column/column.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=column.spec.d.ts.map

package/dist/components/column/column.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.spec.d.ts","sourceRoot":"","sources":["../../../src/components/column/column.spec.ts"],"names":[],"mappings":""}

package/dist/components/column/column.spec.js

@@ -0,0 +1,147 @@
+/* eslint-disable no-magic-numbers */
+/* eslint-disable max-lines-per-function */
+import { Scene } from 'phaser';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// Mock to phaser with type to avoid canvas dependency in runtime
+vi.mock('phaser', () => {
+    class Scene {
+    }
+    class Container {
+        list = [];
+        x;
+        y;
+        width = 0;
+        height = 0;
+        // scene is accepted but not used in the mock
+        constructor(_scene, x, y) {
+            this.x = x;
+            this.y = y;
+        }
+        add(child) {
+            if (Array.isArray(child)) {
+                this.list.push(...child);
+            }
+            else {
+                this.list.push(child);
+            }
+            return this;
+        }
+        setSize(width, height) {
+            this.width = width;
+            this.height = height;
+            return this;
+        }
+    }
+    const GameObjects = { Container };
+    return { GameObjects, Scene };
+});
+import { Column } from './column';
+class TestChild {
+    displayWidth;
+    width;
+    displayHeight;
+    height;
+    originX;
+    originY;
+    displayOriginX;
+    displayOriginY;
+    lastPosition = null;
+    constructor(params = {}) {
+        Object.assign(this, params);
+    }
+    setPosition(x, y) {
+        this.lastPosition = { x, y };
+    }
+    getBounds() {
+        return {
+            width: this.width ?? this.displayWidth ?? 0,
+            height: this.height ?? this.displayHeight ?? 0,
+        };
+    }
+}
+let scene;
+beforeEach(() => {
+    scene = new Scene();
+});
+describe('Column layout', () => {
+    it('centers children by default with verticalOrigin top', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const col = new Column({ scene, x: 0, y: 0, gap: 10, align: 'center', verticalOrigin: 'top', children: [] });
+        col.addChildren([a, b]);
+        // After construction or addition, layout is applied
+        expect(a.lastPosition).toEqual({ x: 0, y: 25 }); // 0 + 0.5*50
+        expect(b.lastPosition).toEqual({ x: 0, y: 110 }); // (50 + 10) + 0.5*100
+        // width = max child width; height = sum + gaps
+        // maxWidth = 200; totalHeight = 50 + 100 + 10 = 160
+        expect(col.width).toBe(200);
+        expect(col.height).toBe(160);
+    });
+    it('align left positions children at content left edge', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const col = new Column({ scene, x: 0, y: 0, gap: 10, align: 'left', verticalOrigin: 'top', children: [a, b] });
+        // maxWidth = 200
+        expect(a.lastPosition?.x).toBe(-50); // -maxWidth/2 + 0.5*100 = -100 + 50
+        expect(b.lastPosition?.x).toBe(0); // -100 + 0.5*200 = 0
+        expect(col.width).toBe(200);
+        expect(col.height).toBe(160);
+    });
+    it('align right positions children at content right edge', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        new Column({ scene, x: 0, y: 0, gap: 10, align: 'right', verticalOrigin: 'top', children: [a, b] });
+        expect(a.lastPosition?.x).toBe(50); // +maxWidth/2 - (1-0.5)*100 = 100 - 50
+        expect(b.lastPosition?.x).toBe(0); // 100 - (1-0.5)*200 = 0
+    });
+    it('verticalOrigin center shifts content up by half height', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        // totalHeight = 50 + 100 + 10 = 160; top starts at -80
+        new Column({ scene, x: 0, y: 0, gap: 10, align: 'center', verticalOrigin: 'center', children: [a, b] });
+        expect(a.lastPosition?.y).toBe(-80 + 0.5 * 50); // -55
+        expect(b.lastPosition?.y).toBe(-80 + 50 + 10 + 0.5 * 100); // -80 + 60 + 50 = 30
+    });
+    it('respects per-child origin when computing alignment and positions', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50, originX: 0.0, originY: 0.0 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100, originX: 1.0, originY: 1.0 });
+        // maxWidth = 200; totalHeight = 160; top = 0 (verticalOrigin top)
+        new Column({ scene, x: 0, y: 0, gap: 10, align: 'left', verticalOrigin: 'top', children: [a, b] });
+        // a: x = -100 + 0*100 = -100; y = 0 + 0*50 = 0
+        expect(a.lastPosition).toEqual({ x: -100, y: 0 });
+        // cursor = 50 + 10 = 60; b: x = -100 + 1*200 = 100; y = 60 + 1*100 = 160
+        expect(b.lastPosition).toEqual({ x: 100, y: 160 });
+    });
+    it('setGap and setAlign trigger relayout', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const col = new Column({ scene, x: 0, y: 0, children: [a, b] }); // default gap=8, align=center, verticalOrigin=top
+        // Initial state with gap=8
+        expect(b.lastPosition?.y).toBe(50 + 8 + 50); // 108
+        col.setGap(20); // changes layout
+        expect(b.lastPosition?.y).toBe(50 + 20 + 50); // 120
+        col.setAlign('left');
+        // maxWidth=200 => a.x = -100 + 0.5*100 = -50; b.x = -100 + 0.5*200 = 0
+        expect(a.lastPosition?.x).toBe(-50);
+        expect(b.lastPosition?.x).toBe(0);
+    });
+    it('addChild/addChildren optionally avoid relayout when requested', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const col = new Column({ scene, x: 0, y: 0, children: [a] });
+        // b added without relayout
+        col.addChild(b, false);
+        const before = b.lastPosition;
+        expect(before).toBeNull();
+        // When calling layout, positions are calculated
+        col.layout();
+        expect(b.lastPosition).not.toBeNull();
+    });
+    it('empty column has size 0,0', () => {
+        const col = new Column({ scene, x: 0, y: 0, children: [] });
+        // After constructor, layout runs and sizes to 0,0
+        expect(col.width).toBe(0);
+        expect(col.height).toBe(0);
+    });
+});
+//# sourceMappingURL=column.spec.js.map

package/dist/components/column/column.spec.js.map

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

package/dist/components/column/index.d.ts

@@ -0,0 +1,2 @@
+export * from './column';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/column/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/column/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/components/column/index.js

@@ -0,0 +1,2 @@
+export * from './column';
+//# sourceMappingURL=index.js.map

package/dist/components/column/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/column/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/components/index.d.ts

@@ -1,2 +1,4 @@
+export * from './column';
 export * from './icon-button';
+export * from './row';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC"}

package/dist/components/index.js

@@ -1,2 +1,4 @@
+export * from './column';
 export * from './icon-button';
+export * from './row';
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC"}

package/dist/components/layout/layout-utils.d.ts

@@ -0,0 +1,13 @@
+import { GameObjects } from 'phaser';
+/** Default gap between elements in pixels */
+export declare const DEFAULT_GAP = 8;
+/** Measures the display width of a game object, with fallbacks */
+export declare const getDisplayWidthOf: (child: GameObjects.GameObject) => number;
+/** Measures the display height of a game object, with fallbacks */
+export declare const getDisplayHeightOf: (child: GameObjects.GameObject) => number;
+/** Returns normalized origin (0..1) for a game object */
+export declare const getNormalizedOriginOf: (child: GameObjects.GameObject) => {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=layout-utils.d.ts.map

package/dist/components/layout/layout-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-utils.d.ts","sourceRoot":"","sources":["../../../src/components/layout/layout-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,6CAA6C;AAC7C,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,GAAI,OAAO,WAAW,CAAC,UAAU,KAAG,MAUjE,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,GAAI,OAAO,WAAW,CAAC,UAAU,KAAG,MAUlE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,GAAI,OAAO,WAAW,CAAC,UAAU,KAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAwB3F,CAAC"}

package/dist/components/layout/layout-utils.js

@@ -0,0 +1,38 @@
+/** Default gap between elements in pixels */
+export const DEFAULT_GAP = 8;
+/** Measures the display width of a game object, with fallbacks */
+export const getDisplayWidthOf = (child) => {
+    const childTyped = child;
+    if (typeof childTyped.displayWidth === 'number')
+        return childTyped.displayWidth;
+    if (typeof childTyped.width === 'number')
+        return childTyped.width;
+    const bounds = childTyped.getBounds?.();
+    return bounds ? bounds.width : 0;
+};
+/** Measures the display height of a game object, with fallbacks */
+export const getDisplayHeightOf = (child) => {
+    const childTyped = child;
+    if (typeof childTyped.displayHeight === 'number')
+        return childTyped.displayHeight;
+    if (typeof childTyped.height === 'number')
+        return childTyped.height;
+    const bounds = childTyped.getBounds?.();
+    return bounds ? bounds.height : 0;
+};
+/** Returns normalized origin (0..1) for a game object */
+export const getNormalizedOriginOf = (child) => {
+    const width = getDisplayWidthOf(child);
+    const height = getDisplayHeightOf(child);
+    const childTyped = child;
+    let ox = typeof childTyped.originX === 'number' ? childTyped.originX : undefined;
+    let oy = typeof childTyped.originY === 'number' ? childTyped.originY : undefined;
+    if (ox === undefined && typeof childTyped.displayOriginX === 'number' && width > 0) {
+        ox = childTyped.displayOriginX / width;
+    }
+    if (oy === undefined && typeof childTyped.displayOriginY === 'number' && height > 0) {
+        oy = childTyped.displayOriginY / height;
+    }
+    return { x: ox ?? 0.5, y: oy ?? 0.5 };
+};
+//# sourceMappingURL=layout-utils.js.map

package/dist/components/layout/layout-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-utils.js","sourceRoot":"","sources":["../../../src/components/layout/layout-utils.ts"],"names":[],"mappings":"AAGA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAE7B,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAA6B,EAAU,EAAE;IACzE,MAAM,UAAU,GAAG,KAIlB,CAAC;IACF,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,YAAY,CAAC;IAChF,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,KAAe,CAAC;IAC5E,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAA6B,EAAU,EAAE;IAC1E,MAAM,UAAU,GAAG,KAIlB,CAAC;IACF,IAAI,OAAO,UAAU,CAAC,aAAa,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,aAAa,CAAC;IAClF,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,MAAgB,CAAC;IAC9E,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAA6B,EAA4B,EAAE;IAC/F,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAEzC,MAAM,UAAU,GAAG,KAKlB,CAAC;IAEF,IAAI,EAAE,GACJ,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,IAAI,EAAE,GACJ,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1E,IAAI,EAAE,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,cAAc,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACnF,EAAE,GAAG,UAAU,CAAC,cAAc,GAAG,KAAK,CAAC;IACzC,CAAC;IACD,IAAI,EAAE,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACpF,EAAE,GAAG,UAAU,CAAC,cAAc,GAAG,MAAM,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC;AACxC,CAAC,CAAC"}

package/dist/components/layout/layout-utils.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=layout-utils.spec.d.ts.map

package/dist/components/layout/layout-utils.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-utils.spec.d.ts","sourceRoot":"","sources":["../../../src/components/layout/layout-utils.spec.ts"],"names":[],"mappings":""}

package/dist/components/layout/layout-utils.spec.js

@@ -0,0 +1,70 @@
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_GAP, getDisplayHeightOf, getDisplayWidthOf, getNormalizedOriginOf, } from './layout-utils';
+// Helper to satisfy typing without importing Phaser types in tests
+const asGO = (o) => o;
+describe('layout-utils', () => {
+    it('DEFAULT_GAP should be 8', () => {
+        expect(DEFAULT_GAP).toBe(8);
+    });
+    describe('getDisplayWidthOf', () => {
+        it('prefers displayWidth when present', () => {
+            const obj = asGO({ displayWidth: 120, width: 200, getBounds: () => ({ width: 300 }) });
+            expect(getDisplayWidthOf(obj)).toBe(120);
+        });
+        it('falls back to width when displayWidth is absent', () => {
+            const obj = asGO({ width: 200, getBounds: () => ({ width: 300 }) });
+            expect(getDisplayWidthOf(obj)).toBe(200);
+        });
+        it('falls back to getBounds().width when both displayWidth and width are absent', () => {
+            const obj = asGO({ getBounds: () => ({ width: 300 }) });
+            expect(getDisplayWidthOf(obj)).toBe(300);
+        });
+        it('returns 0 when nothing is available', () => {
+            const obj = asGO({});
+            expect(getDisplayWidthOf(obj)).toBe(0);
+        });
+    });
+    describe('getDisplayHeightOf', () => {
+        it('prefers displayHeight when present', () => {
+            const obj = asGO({ displayHeight: 110, height: 210, getBounds: () => ({ height: 310 }) });
+            expect(getDisplayHeightOf(obj)).toBe(110);
+        });
+        it('falls back to height when displayHeight is absent', () => {
+            const obj = asGO({ height: 210, getBounds: () => ({ height: 310 }) });
+            expect(getDisplayHeightOf(obj)).toBe(210);
+        });
+        it('falls back to getBounds().height when both displayHeight and height are absent', () => {
+            const obj = asGO({ getBounds: () => ({ height: 310 }) });
+            expect(getDisplayHeightOf(obj)).toBe(310);
+        });
+        it('returns 0 when nothing is available', () => {
+            const obj = asGO({});
+            expect(getDisplayHeightOf(obj)).toBe(0);
+        });
+    });
+    describe('getNormalizedOriginOf', () => {
+        it('returns originX/Y when provided', () => {
+            const obj = asGO({ originX: 0.2, originY: 0.8, displayWidth: 100, displayHeight: 100 });
+            expect(getNormalizedOriginOf(obj)).toEqual({ x: 0.2, y: 0.8 });
+        });
+        it('computes from displayOriginX/Y over displayWidth/Height when originX/Y absent', () => {
+            const obj = asGO({ displayOriginX: 25, displayOriginY: 50, displayWidth: 100, displayHeight: 200 });
+            // x = 25/100 = 0.25, y = 50/200 = 0.25
+            expect(getNormalizedOriginOf(obj)).toEqual({ x: 0.25, y: 0.25 });
+        });
+        it('defaults to 0.5 when origins are missing and size is zero', () => {
+            const obj = asGO({ displayOriginX: 10, displayOriginY: 10, displayWidth: 0, displayHeight: 0 });
+            expect(getNormalizedOriginOf(obj)).toEqual({ x: 0.5, y: 0.5 });
+        });
+        it('uses mixed fallbacks per axis independently', () => {
+            const obj = asGO({
+                originX: 0.1, // should take precedence on X
+                displayOriginY: 30,
+                displayHeight: 120, // Y should be 30/120 = 0.25
+                displayWidth: 400,
+            });
+            expect(getNormalizedOriginOf(obj)).toEqual({ x: 0.1, y: 0.25 });
+        });
+    });
+});
+//# sourceMappingURL=layout-utils.spec.js.map

package/dist/components/layout/layout-utils.spec.js.map

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

package/dist/components/row/index.d.ts

@@ -0,0 +1,2 @@
+export * from './row';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/row/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/row/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/components/row/index.js

@@ -0,0 +1,2 @@
+export * from './row';
+//# sourceMappingURL=index.js.map

package/dist/components/row/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/row/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/components/row/row.d.ts

@@ -0,0 +1,87 @@
+import { GameObjects, Scene } from 'phaser';
+/** Vertical alignment options for row items */
+export type VerticalAlign = 'top' | 'center' | 'bottom';
+/** Parameters for creating a Row container */
+export type RowParams = {
+    /** The scene this row belongs to */
+    scene: Scene;
+    /** X coordinate of the row */
+    x: number;
+    /** Y coordinate of the row */
+    y: number;
+    /** Gap between elements in pixels */
+    gap?: number;
+    /** Vertical alignment of elements */
+    align?: VerticalAlign;
+    /** Initial child elements */
+    children?: GameObjects.GameObject[];
+    /** Horizontal origin point of the row */
+    horizontalOrigin?: 'left' | 'center' | 'right';
+};
+/**
+ * Row is a layout container that arranges children horizontally with a gap.
+ * The container position (x, y) represents the center of the whole row.
+ */
+export declare class Row extends GameObjects.Container {
+    /** Gap between elements in pixels */
+    private gap;
+    /** Vertical alignment of elements */
+    private align;
+    /** Horizontal origin point of the row */
+    private horizontalOrigin;
+    /**
+     * Creates a new Row container
+     * @param params Configuration parameters for the row
+     */
+    constructor({ scene, x, y, gap, align, children, horizontalOrigin, }: RowParams);
+    /**
+     * Sets the gap between elements and updates layout
+     * @param gap Gap size in pixels
+     */
+    setGap(gap: number): void;
+    /**
+     * Sets the vertical alignment and updates layout
+     * @param align New vertical alignment
+     */
+    setAlign(align: VerticalAlign): void;
+    /**
+     * Adds a single child to the row
+     * @param child GameObject to add
+     * @param relayout Whether to update layout after adding
+     * @returns This row instance for chaining
+     */
+    addChild(child: GameObjects.GameObject, relayout?: boolean): this;
+    /**
+     * Adds multiple children to the row
+     * @param children Array of GameObjects to add
+     * @param relayout Whether to update layout after adding
+     * @returns This row instance for chaining
+     */
+    addChildren(children: GameObjects.GameObject[], relayout?: boolean): this;
+    /**
+     * Recomputes children's positions and updates this container size
+     */
+    layout(): void;
+    /**
+     * Gets the display width of a game object
+     * @param child GameObject to measure
+     * @returns Display width in pixels
+     */
+    getDisplayWidth(child: GameObjects.GameObject): number;
+    /**
+     * Gets the display height of a game object
+     * @param child GameObject to measure
+     * @returns Display height in pixels
+     */
+    getDisplayHeight(child: GameObjects.GameObject): number;
+    /**
+     * Gets the normalized origin point of a game object
+     * @param child GameObject to get origin from
+     * @returns Object with normalized x,y coordinates of the origin point
+     */
+    getNormalizedOrigin(child: GameObjects.GameObject): {
+        x: number;
+        y: number;
+    };
+}
+//# sourceMappingURL=row.d.ts.map

package/dist/components/row/row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.d.ts","sourceRoot":"","sources":["../../../src/components/row/row.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAS5C,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG;IACtB,oCAAoC;IACpC,KAAK,EAAE,KAAK,CAAC;IACb,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;IACpC,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CAChD,CAAC;AAEF;;;GAGG;AACH,qBAAa,GAAI,SAAQ,WAAW,CAAC,SAAS;IAC5C,qCAAqC;IACrC,OAAO,CAAC,GAAG,CAAS;IACpB,qCAAqC;IACrC,OAAO,CAAC,KAAK,CAAgB;IAC7B,yCAAyC;IACzC,OAAO,CAAC,gBAAgB,CAA8B;IAEtD;;;OAGG;gBACS,EACV,KAAK,EACL,CAAC,EACD,CAAC,EACD,GAAiB,EACjB,KAAgB,EAChB,QAAa,EACb,gBAA2B,GAC5B,EAAE,SAAS;IAcZ;;;OAGG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAK3C;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,GAAE,OAAc,GAAG,IAAI;IAM9E;;;;;OAKG;IACI,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,EAAE,EAAE,QAAQ,GAAE,OAAc,GAAG,IAAI;IAMtF;;OAEG;IACI,MAAM,IAAI,IAAI;IAgDrB;;;;OAIG;IACI,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,GAAG,MAAM;IAI7D;;;;OAIG;IACI,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,GAAG,MAAM;IAI9D;;;;OAIG;IACI,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;CAGpF"}

package/dist/components/row/row.js

@@ -0,0 +1,139 @@
+/* eslint-disable complexity */
+import { GameObjects } from 'phaser';
+import { DEFAULT_GAP, getDisplayHeightOf, getDisplayWidthOf, getNormalizedOriginOf, } from '../layout/layout-utils';
+/**
+ * Row is a layout container that arranges children horizontally with a gap.
+ * The container position (x, y) represents the center of the whole row.
+ */
+export class Row extends GameObjects.Container {
+    /** Gap between elements in pixels */
+    gap;
+    /** Vertical alignment of elements */
+    align;
+    /** Horizontal origin point of the row */
+    horizontalOrigin;
+    /**
+     * Creates a new Row container
+     * @param params Configuration parameters for the row
+     */
+    constructor({ scene, x, y, gap = DEFAULT_GAP, align = 'center', children = [], horizontalOrigin = 'center', }) {
+        super(scene, x, y);
+        this.gap = gap;
+        this.align = align;
+        this.horizontalOrigin = horizontalOrigin;
+        if (children.length > 0) {
+            this.add(children);
+        }
+        this.layout();
+    }
+    /**
+     * Sets the gap between elements and updates layout
+     * @param gap Gap size in pixels
+     */
+    setGap(gap) {
+        this.gap = gap;
+        this.layout();
+    }
+    /**
+     * Sets the vertical alignment and updates layout
+     * @param align New vertical alignment
+     */
+    setAlign(align) {
+        this.align = align;
+        this.layout();
+    }
+    /**
+     * Adds a single child to the row
+     * @param child GameObject to add
+     * @param relayout Whether to update layout after adding
+     * @returns This row instance for chaining
+     */
+    addChild(child, relayout = true) {
+        this.add(child);
+        if (relayout)
+            this.layout();
+        return this;
+    }
+    /**
+     * Adds multiple children to the row
+     * @param children Array of GameObjects to add
+     * @param relayout Whether to update layout after adding
+     * @returns This row instance for chaining
+     */
+    addChildren(children, relayout = true) {
+        if (children.length > 0)
+            this.add(children);
+        if (relayout)
+            this.layout();
+        return this;
+    }
+    /**
+     * Recomputes children's positions and updates this container size
+     */
+    layout() {
+        const children = this.list;
+        if (children.length === 0) {
+            this.setSize(0, 0);
+            return;
+        }
+        // Measure sizes and origins
+        const entries = children.map((child) => ({
+            child,
+            width: this.getDisplayWidth(child),
+            height: this.getDisplayHeight(child),
+            origin: this.getNormalizedOrigin(child),
+        }));
+        const maxHeight = entries.reduce((m, s) => Math.max(m, s.height), 0);
+        const totalWidth = entries.reduce((sum, s) => sum + s.width, 0) + this.gap * (entries.length - 1);
+        // Determine left of content based on horizontalOrigin
+        const contentLeftX = this.horizontalOrigin === 'left' ? 0 : this.horizontalOrigin === 'center' ? -totalWidth / 2 : -totalWidth;
+        // Walk left to right, aligning considering each child's origin
+        let cursorLeftX = contentLeftX;
+        for (const { child, width, height, origin } of entries) {
+            // Vertical alignment: align top/bottom edges or centers correctly using origin
+            let y = 0;
+            if (this.align === 'top') {
+                // place child's top edge at content top
+                y = -maxHeight / 2 + origin.y * height;
+            }
+            else if (this.align === 'bottom') {
+                // place child's bottom edge at content bottom
+                y = maxHeight / 2 - (1 - origin.y) * height;
+            }
+            else {
+                // center alignment
+                y = (origin.y - 0.5) * height;
+            }
+            // Horizontal position so that child's left is at cursorLeftX
+            const x = cursorLeftX + origin.x * width;
+            child.setPosition(x, y);
+            cursorLeftX += width + this.gap;
+        }
+        this.setSize(totalWidth, maxHeight);
+    }
+    /**
+     * Gets the display width of a game object
+     * @param child GameObject to measure
+     * @returns Display width in pixels
+     */
+    getDisplayWidth(child) {
+        return getDisplayWidthOf(child);
+    }
+    /**
+     * Gets the display height of a game object
+     * @param child GameObject to measure
+     * @returns Display height in pixels
+     */
+    getDisplayHeight(child) {
+        return getDisplayHeightOf(child);
+    }
+    /**
+     * Gets the normalized origin point of a game object
+     * @param child GameObject to get origin from
+     * @returns Object with normalized x,y coordinates of the origin point
+     */
+    getNormalizedOrigin(child) {
+        return getNormalizedOriginOf(child);
+    }
+}
+//# sourceMappingURL=row.js.map

package/dist/components/row/row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.js","sourceRoot":"","sources":["../../../src/components/row/row.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EAAE,WAAW,EAAS,MAAM,QAAQ,CAAC;AAE5C,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAuBhC;;;GAGG;AACH,MAAM,OAAO,GAAI,SAAQ,WAAW,CAAC,SAAS;IAC5C,qCAAqC;IAC7B,GAAG,CAAS;IACpB,qCAAqC;IAC7B,KAAK,CAAgB;IAC7B,yCAAyC;IACjC,gBAAgB,CAA8B;IAEtD;;;OAGG;IACH,YAAY,EACV,KAAK,EACL,CAAC,EACD,CAAC,EACD,GAAG,GAAG,WAAW,EACjB,KAAK,GAAG,QAAQ,EAChB,QAAQ,GAAG,EAAE,EACb,gBAAgB,GAAG,QAAQ,GACjB;QACV,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAEzC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,GAAW;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,KAAoB;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,KAA6B,EAAE,WAAoB,IAAI;QACrE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,IAAI,QAAQ;YAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,QAAkC,EAAE,WAAoB,IAAI;QAC7E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,QAAQ;YAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,MAAM;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAgC,CAAC;QACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QAED,4BAA4B;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAClC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACpC,MAAM,EAAE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;SACxC,CAAC,CAAC,CAAC;QAEJ,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAElG,sDAAsD;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAE/H,+DAA+D;QAC/D,IAAI,WAAW,GAAG,YAAY,CAAC;QAC/B,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACvD,+EAA+E;YAC/E,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBACzB,wCAAwC;gBACxC,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC;YACzC,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnC,8CAA8C;gBAC9C,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC;YAChC,CAAC;YAED,6DAA6D;YAC7D,MAAM,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;YAExC,KAAoE,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAExF,WAAW,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,KAA6B;QAClD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACI,gBAAgB,CAAC,KAA6B;QACnD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACI,mBAAmB,CAAC,KAA6B;QACtD,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/components/row/row.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=row.spec.d.ts.map

package/dist/components/row/row.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.spec.d.ts","sourceRoot":"","sources":["../../../src/components/row/row.spec.ts"],"names":[],"mappings":""}

package/dist/components/row/row.spec.js

@@ -0,0 +1,146 @@
+/* eslint-disable no-magic-numbers */
+/* eslint-disable max-lines-per-function */
+import { Scene } from 'phaser';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// Typed mock of 'phaser' to avoid canvas dependency
+vi.mock('phaser', () => {
+    class Scene {
+    }
+    class Container {
+        list = [];
+        x;
+        y;
+        width = 0;
+        height = 0;
+        constructor(_scene, x, y) {
+            this.x = x;
+            this.y = y;
+        }
+        add(child) {
+            if (Array.isArray(child)) {
+                this.list.push(...child);
+            }
+            else {
+                this.list.push(child);
+            }
+            return this;
+        }
+        setSize(width, height) {
+            this.width = width;
+            this.height = height;
+            return this;
+        }
+    }
+    const GameObjects = { Container };
+    return { GameObjects, Scene };
+});
+import { Row } from './row';
+class TestChild {
+    displayWidth;
+    width;
+    displayHeight;
+    height;
+    originX;
+    originY;
+    displayOriginX;
+    displayOriginY;
+    lastPosition = null;
+    constructor(params = {}) {
+        Object.assign(this, params);
+    }
+    setPosition(x, y) {
+        this.lastPosition = { x, y };
+    }
+    getBounds() {
+        return {
+            width: this.width ?? this.displayWidth ?? 0,
+            height: this.height ?? this.displayHeight ?? 0,
+        };
+    }
+}
+let scene;
+beforeEach(() => {
+    scene = new Scene();
+});
+describe('Row layout', () => {
+    it('centers children by default with horizontalOrigin center', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const row = new Row({ scene, x: 0, y: 0, gap: 10, align: 'center', horizontalOrigin: 'center', children: [] });
+        row.addChildren([a, b]);
+        // totalWidth = 100 + 200 + 10 = 310; contentLeft = -155
+        expect(a.lastPosition).toEqual({ x: -155 + 0.5 * 100, y: 0 }); // -105, 0
+        expect(b.lastPosition).toEqual({ x: -45 + 0.5 * 200, y: 0 }); // 55, 0
+        // width = totalWidth; height = max child height
+        expect(row.width).toBe(310);
+        expect(row.height).toBe(100);
+    });
+    it('align top positions children at content top edge', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const row = new Row({ scene, x: 0, y: 0, gap: 10, align: 'top', horizontalOrigin: 'center', children: [a, b] });
+        // maxHeight = 100
+        expect(a.lastPosition?.y).toBe(-50 + 0.5 * 50); // -25
+        expect(b.lastPosition?.y).toBe(-50 + 0.5 * 100); // 0
+        expect(row.width).toBe(310);
+        expect(row.height).toBe(100);
+    });
+    it('align bottom positions children at content bottom edge', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        new Row({ scene, x: 0, y: 0, gap: 10, align: 'bottom', horizontalOrigin: 'center', children: [a, b] });
+        expect(a.lastPosition?.y).toBe(50 - (1 - 0.5) * 50); // 25
+        expect(b.lastPosition?.y).toBe(50 - (1 - 0.5) * 100); // 0
+    });
+    it('horizontalOrigin left places content starting at x=0', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const row = new Row({ scene, x: 0, y: 0, gap: 10, align: 'center', horizontalOrigin: 'left', children: [a, b] });
+        expect(a.lastPosition?.x).toBe(0 + 0.5 * 100); // 50
+        expect(b.lastPosition?.x).toBe(110 + 0.5 * 200); // 210
+        expect(row.width).toBe(310);
+        expect(row.height).toBe(100);
+    });
+    it('respects per-child origin when computing alignment and positions', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50, originX: 0.0, originY: 0.0 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100, originX: 1.0, originY: 1.0 });
+        // totalWidth = 310; left = 0 (horizontalOrigin left); maxHeight = 100
+        new Row({ scene, x: 0, y: 0, gap: 10, align: 'top', horizontalOrigin: 'left', children: [a, b] });
+        // a: x = 0 + 0*100 = 0; y = -50 + 0*50 = -50
+        expect(a.lastPosition).toEqual({ x: 0, y: -50 });
+        // cursor = 0 + 100 + 10 = 110; b: x = 110 + 1*200 = 310; y = -50 + 1*100 = 50
+        expect(b.lastPosition).toEqual({ x: 310, y: 50 });
+    });
+    it('setGap and setAlign trigger relayout', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const row = new Row({ scene, x: 0, y: 0, children: [a, b] }); // default gap=8, align=center, horizontalOrigin=center
+        // Initial container width with gap=8
+        const initialWidth = row.width;
+        row.setGap(20); // triggers layout
+        const afterWidth = row.width;
+        expect(afterWidth).toBe(initialWidth + (20 - 8));
+        row.setAlign('top');
+        // For align top, y positions as computed earlier with maxHeight=100
+        expect(a.lastPosition?.y).toBe(-50 + 0.5 * 50); // -25
+        expect(b.lastPosition?.y).toBe(-50 + 0.5 * 100); // 0
+    });
+    it('addChild/addChildren optionally avoid relayout when requested', () => {
+        const a = new TestChild({ displayWidth: 100, displayHeight: 50 });
+        const b = new TestChild({ displayWidth: 200, displayHeight: 100 });
+        const row = new Row({ scene, x: 0, y: 0, children: [a] });
+        // b added without relayout
+        row.addChild(b, false);
+        const before = b.lastPosition;
+        expect(before).toBeNull();
+        // layout computes positions
+        row.layout();
+        expect(b.lastPosition).not.toBeNull();
+    });
+    it('empty row has size 0,0', () => {
+        const row = new Row({ scene, x: 0, y: 0, children: [] });
+        expect(row.width).toBe(0);
+        expect(row.height).toBe(0);
+    });
+});
+//# sourceMappingURL=row.spec.js.map

package/dist/components/row/row.spec.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hudini",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "🎩 Magical Phaser UI components - Reusable HUD elements for game development. Is magic, like a wizard",
   "type": "module",
   "main": "./dist/index.js",