fraxel 0.1.0-alpha.1

package/dist/hooks/use-trigger.d.ts

@@ -0,0 +1,51 @@
+import type { Fun } from '../events/types.js';
+/**
+ * The **`createTrigger`** function creates a new `Trigger` instance for pub/sub communication
+ * between components without node events.
+ *
+ * @typeParam T The argument types for the trigger callbacks
+ * @returns A new `Trigger` instance
+ *
+ * @example
+ * ```ts
+ * const planted = createTrigger<[Plant]>()
+ * ```
+ */
+export declare function createTrigger<T extends any[] = any[]>(): Trigger<T>;
+/**
+ * The **`useTrigger`** hook subscribes to a `Trigger` with auto-cleanup on node destroy.
+ *
+ * @param trigger The `Trigger` instance to subscribe to
+ * @param fn The callback function to invoke when the trigger emits
+ *
+ * @example
+ * ```tsx
+ * const planted = createTrigger<[Plant]>()
+ *
+ * useTrigger(planted, (plant) => {
+ *   console.log('Planted:', plant)
+ * })
+ * ```
+ */
+export declare function useTrigger<T extends any[]>(trigger: Trigger<T>, fn: Fun<T>): void;
+/**
+ * The **`Trigger`** class provides a pub/sub pattern for cross-component communication.
+ * Use `createTrigger()` to create instances.
+ *
+ * @typeParam T The argument types for the trigger callbacks
+ *
+ * @example
+ * ```ts
+ * const trigger = createTrigger<[number]>()
+ *
+ * trigger.connect((value) => console.log(value))
+ * trigger.emit(42) // logs: 42
+ * ```
+ */
+export declare class Trigger<T extends any[]> {
+    #private;
+    connect(cb: Fun<T>): void;
+    disconnect(cb: Fun<T>): void;
+    emit(...args: T): void;
+}
+//# sourceMappingURL=use-trigger.d.ts.map

package/dist/hooks/use-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trigger.d.ts","sourceRoot":"","sources":["../../src/hooks/use-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAG7C;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,gBAEpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,QAO1E;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,GAAG,EAAE;;IAGlC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAGlB,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAIrB,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;CAKhB"}

package/dist/hooks/use-trigger.js

@@ -0,0 +1,68 @@
+import { pushEffect } from './context.js';
+/**
+ * The **`createTrigger`** function creates a new `Trigger` instance for pub/sub communication
+ * between components without node events.
+ *
+ * @typeParam T The argument types for the trigger callbacks
+ * @returns A new `Trigger` instance
+ *
+ * @example
+ * ```ts
+ * const planted = createTrigger<[Plant]>()
+ * ```
+ */
+export function createTrigger() {
+    return new Trigger();
+}
+/**
+ * The **`useTrigger`** hook subscribes to a `Trigger` with auto-cleanup on node destroy.
+ *
+ * @param trigger The `Trigger` instance to subscribe to
+ * @param fn The callback function to invoke when the trigger emits
+ *
+ * @example
+ * ```tsx
+ * const planted = createTrigger<[Plant]>()
+ *
+ * useTrigger(planted, (plant) => {
+ *   console.log('Planted:', plant)
+ * })
+ * ```
+ */
+export function useTrigger(trigger, fn) {
+    pushEffect('useTrigger', ([node]) => {
+        if (node == null)
+            return;
+        trigger.connect(fn);
+        node.destroyed.on(() => trigger.disconnect(fn));
+    });
+}
+/**
+ * The **`Trigger`** class provides a pub/sub pattern for cross-component communication.
+ * Use `createTrigger()` to create instances.
+ *
+ * @typeParam T The argument types for the trigger callbacks
+ *
+ * @example
+ * ```ts
+ * const trigger = createTrigger<[number]>()
+ *
+ * trigger.connect((value) => console.log(value))
+ * trigger.emit(42) // logs: 42
+ * ```
+ */
+export class Trigger {
+    #listeners = new Set();
+    connect(cb) {
+        this.#listeners.add(cb);
+    }
+    disconnect(cb) {
+        this.#listeners.delete(cb);
+    }
+    emit(...args) {
+        for (const cb of Array.from(this.#listeners)) {
+            cb(...args);
+        }
+    }
+}
+//# sourceMappingURL=use-trigger.js.map

package/dist/hooks/use-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trigger.js","sourceRoot":"","sources":["../../src/hooks/use-trigger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,OAAO,EAAK,CAAA;AACzB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAkB,OAAmB,EAAE,EAAU;IACzE,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;QAClC,IAAI,IAAI,IAAI,IAAI;YAAE,OAAM;QAExB,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACnB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,OAAO;IAClB,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;IAE9B,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC;IACD,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC;IAED,IAAI,CAAC,GAAG,IAAO;QACb,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7C,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './nodes/index.js';
+export * from './animation/index.js';
+export * from './assets/index.js';
+export * from './audio/index.js';
+export * from './collision/index.js';
+export * from './core/index.js';
+export * from './events/index.js';
+export * from './math/index.js';
+export * from './errors/index.js';
+export * from './reactivity/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from './nodes/index.js';
+export * from './animation/index.js';
+export * from './assets/index.js';
+export * from './audio/index.js';
+export * from './collision/index.js';
+export * from './core/index.js';
+export * from './events/index.js';
+export * from './math/index.js';
+export * from './errors/index.js';
+export * from './reactivity/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA"}

package/dist/input/input.d.ts

@@ -0,0 +1,46 @@
+import { Event } from '../events/event.js';
+import { Vector2 } from '../math/vector2.js';
+export interface InputOptions {
+    /**
+     * Whether to call `preventDefault()` on keyboard events.
+     * Set to `false` to allow browser shortcuts and default behavior.
+     * @default true
+     */
+    preventKeyDefaults?: boolean;
+}
+export declare class Input {
+    #private;
+    constructor(canvas: HTMLCanvasElement, size: Vector2, options?: InputOptions);
+    isJustKeyPressed(key: string, ctrlKey?: boolean, shiftKey?: boolean, altKey?: boolean): boolean;
+    isKeyPressed(key: string, ctrlKey?: boolean, shiftKey?: boolean, altKey?: boolean): boolean;
+    isJustKeyUnpressed(key: string, ctrlKey?: boolean, shiftKey?: boolean, altKey?: boolean): boolean;
+    getKeyAxis(positiveKey: string, negativeKey: string): number;
+    /**
+     * The read-only **`pointerPosition`** property returns the current pointer position.
+     */
+    get pointerPosition(): Readonly<Vector2>;
+    /**
+     * The read-only **`isPointerPressed`** property returns whether the pointer is currently pressed.
+     */
+    get isPointerPressed(): boolean;
+    /**
+     * The **`pointerMoved`** event fires when the pointer moves.
+     */
+    pointerMoved: Event<[_position: Vector2], "pointerMove">;
+    /**
+     * The **`pointerPressed`** event fires when the pointer is pressed.
+     * The callback receives the pointer position.
+     */
+    pointerPressed: Event<[_position: Vector2], "pointerPress">;
+    /**
+     * The **`pointerUnpressed`** event fires when the pointer is released.
+     * The callback receives the pointer position.
+     */
+    pointerUnpressed: Event<[_position: Vector2], "pointerUnpress">;
+    update(): void;
+    /**
+     * The **`destroy`** method removes all event listeners.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/input/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/input/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,qBAAa,KAAK;;gBAqBJ,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY;IA0E5E,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,QAAQ,UAAQ,EAAE,MAAM,UAAQ;IAU/E,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,QAAQ,UAAQ,EAAE,MAAM,UAAQ;IAU3E,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,QAAQ,UAAQ,EAAE,MAAM,UAAQ;IAWjF,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAOnD;;OAEG;IACH,IAAI,eAAe,IAAI,QAAQ,CAAC,OAAO,CAAC,CAEvC;IAED;;OAEG;IACH,IAAI,gBAAgB,YAEnB;IAED;;OAEG;IACH,YAAY,6CAAuD;IAEnE;;;OAGG;IACH,cAAc,8CAAwD;IAEtE;;;OAGG;IACH,gBAAgB,gDAA0D;IAE1E,MAAM;IAKN;;OAEG;IACH,OAAO;CAQR"}

package/dist/input/input.js

@@ -0,0 +1,159 @@
+import { Event } from '../events/event.js';
+import { Vector2 } from '../math/vector2.js';
+export class Input {
+    #currentKeys = new Set();
+    #justKeys = new Set();
+    #justKeysUnpressed = new Set();
+    #pointer = {
+        position: new Vector2(0, 0),
+        isPressed: false,
+    };
+    #canvasPos;
+    #canvasSize;
+    #canvasResSize;
+    #handleKeyDown;
+    #handleKeyUp;
+    #handlePointerMove;
+    #handlePointerDown;
+    #handlePointerUp;
+    #handleResize;
+    constructor(canvas, size, options) {
+        const { preventKeyDefaults = true } = options ?? {};
+        const canvasBounding = canvas.getBoundingClientRect();
+        this.#canvasPos = new Vector2(canvasBounding.x, canvasBounding.y);
+        this.#canvasSize = new Vector2(canvasBounding.width, canvasBounding.height);
+        this.#canvasResSize = size.clone();
+        this.#handleResize = () => {
+            const newCanvasBounding = canvas.getBoundingClientRect();
+            this.#canvasSize.x = newCanvasBounding.width;
+            this.#canvasSize.y = newCanvasBounding.height;
+            this.#canvasPos.x = newCanvasBounding.x;
+            this.#canvasPos.y = newCanvasBounding.y;
+        };
+        this.#handleKeyDown = (ev) => {
+            if (preventKeyDefaults)
+                ev.preventDefault();
+            const keyString = this.#getKeyString(ev);
+            this.#currentKeys.add(keyString);
+            this.#justKeys.add(keyString);
+        };
+        this.#handleKeyUp = (ev) => {
+            if (preventKeyDefaults)
+                ev.preventDefault();
+            const keyString = this.#getKeyString(ev);
+            this.#justKeysUnpressed.add(keyString);
+            this.#currentKeys.delete(keyString);
+        };
+        this.#handlePointerMove = (ev) => {
+            const position = this.#getPointerPosition(ev);
+            this.#pointer.position.x = position.x;
+            this.#pointer.position.y = position.y;
+            this.pointerMoved.emit(position);
+        };
+        this.#handlePointerDown = (ev) => {
+            const position = this.#getPointerPosition(ev);
+            this.#pointer.position.x = position.x;
+            this.#pointer.position.y = position.y;
+            this.#pointer.isPressed = true;
+            this.pointerPressed.emit(position);
+        };
+        this.#handlePointerUp = (ev) => {
+            const position = this.#getPointerPosition(ev);
+            this.#pointer.position.x = position.x;
+            this.#pointer.position.y = position.y;
+            this.#pointer.isPressed = false;
+            this.pointerUnpressed.emit(position);
+        };
+        window.addEventListener('resize', this.#handleResize);
+        window.addEventListener('keydown', this.#handleKeyDown);
+        window.addEventListener('keyup', this.#handleKeyUp);
+        window.addEventListener('pointermove', this.#handlePointerMove);
+        window.addEventListener('pointerdown', this.#handlePointerDown);
+        window.addEventListener('pointerup', this.#handlePointerUp);
+    }
+    #getPointerPosition(ev) {
+        return new Vector2((clamp(0, ev.x - this.#canvasPos.x, this.#canvasSize.x) * this.#canvasResSize.x) /
+            this.#canvasSize.x, (clamp(0, ev.y - this.#canvasPos.y, this.#canvasSize.y) * this.#canvasResSize.y) /
+            this.#canvasSize.y);
+    }
+    #getKeyString(ev) {
+        return `${ev.key.toLowerCase()}|${ev.ctrlKey}|${ev.altKey}|${ev.shiftKey}`;
+    }
+    isJustKeyPressed(key, ctrlKey = false, shiftKey = false, altKey = false) {
+        return this.#justKeys.has(this.#getKeyString({
+            key,
+            ctrlKey,
+            altKey,
+            shiftKey,
+        }));
+    }
+    isKeyPressed(key, ctrlKey = false, shiftKey = false, altKey = false) {
+        return this.#currentKeys.has(this.#getKeyString({
+            key,
+            ctrlKey,
+            altKey,
+            shiftKey,
+        }));
+    }
+    isJustKeyUnpressed(key, ctrlKey = false, shiftKey = false, altKey = false) {
+        return this.#justKeysUnpressed.has(this.#getKeyString({
+            key,
+            ctrlKey,
+            altKey,
+            shiftKey,
+        }));
+    }
+    getKeyAxis(positiveKey, negativeKey) {
+        let axis = 0;
+        if (this.isKeyPressed(positiveKey))
+            axis += 1;
+        if (this.isKeyPressed(negativeKey))
+            axis -= 1;
+        return axis;
+    }
+    /**
+     * The read-only **`pointerPosition`** property returns the current pointer position.
+     */
+    get pointerPosition() {
+        return this.#pointer.position;
+    }
+    /**
+     * The read-only **`isPointerPressed`** property returns whether the pointer is currently pressed.
+     */
+    get isPointerPressed() {
+        return this.#pointer.isPressed;
+    }
+    /**
+     * The **`pointerMoved`** event fires when the pointer moves.
+     */
+    pointerMoved = new Event('pointerMove', (_position) => { });
+    /**
+     * The **`pointerPressed`** event fires when the pointer is pressed.
+     * The callback receives the pointer position.
+     */
+    pointerPressed = new Event('pointerPress', (_position) => { });
+    /**
+     * The **`pointerUnpressed`** event fires when the pointer is released.
+     * The callback receives the pointer position.
+     */
+    pointerUnpressed = new Event('pointerUnpress', (_position) => { });
+    update() {
+        this.#justKeys.clear();
+        this.#justKeysUnpressed.clear();
+    }
+    /**
+     * The **`destroy`** method removes all event listeners.
+     */
+    destroy() {
+        window.removeEventListener('resize', this.#handleResize);
+        window.removeEventListener('keydown', this.#handleKeyDown);
+        window.removeEventListener('keyup', this.#handleKeyUp);
+        window.removeEventListener('pointermove', this.#handlePointerMove);
+        window.removeEventListener('pointerdown', this.#handlePointerDown);
+        window.removeEventListener('pointerup', this.#handlePointerUp);
+    }
+}
+function clamp(min, val, max) {
+    return Math.min(Math.max(min, val), max);
+}
+//# sourceMappingURL=input.js.map

package/dist/input/input.js.map

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

package/dist/jsx/components/fragment.d.ts

@@ -0,0 +1,3 @@
+import type { Dinix } from '../types';
+export declare function Fragment(props: Dinix.WithChildren): Dinix.Element;
+//# sourceMappingURL=fragment.d.ts.map

package/dist/jsx/components/fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/fragment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CAKjE"}

package/dist/jsx/components/fragment.js

@@ -0,0 +1,7 @@
+export function Fragment(props) {
+    return {
+        type: '',
+        props,
+    };
+}
+//# sourceMappingURL=fragment.js.map

package/dist/jsx/components/fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.js","sourceRoot":"","sources":["../../../src/jsx/components/fragment.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,KAAyB;IAChD,OAAO;QACL,IAAI,EAAE,EAAE;QACR,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/jsx/components/game.d.ts

@@ -0,0 +1,21 @@
+import type { Game as GameP } from '../../core/game.js';
+import type { Dinix } from '../types.js';
+export type GameOptions = Dinix.WithChildren<Omit<Parameters<(typeof GameP)['setup']>[0], 'root'>> & {
+    /** The **`defaultScene`** of the Game */
+    defaultScene: string;
+};
+/**
+ * The **`Game`** component is the root component of the game. It is used to set up the game with its properties and its children, which are the scenes of the game.
+ *
+ * @example
+ * ```jsx
+ * <Game width={150} height={75} defaultScene='main'>
+ *   <Scene name='main' component={() => import('./scenes/main.js')} />
+ * </Game>
+ * ```
+ *
+ * @param options - The options for the Game component, which include the properties of the game and its children (the scenes).
+ * @returns A JSX element representing the Game component with its properties and children.
+ */
+export declare function Game(_options: GameOptions): null;
+//# sourceMappingURL=game.d.ts.map

package/dist/jsx/components/game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/game.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,CAC1C,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CACrD,GAAG;IACF,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAEhD"}

package/dist/jsx/components/game.js

@@ -0,0 +1,17 @@
+/**
+ * The **`Game`** component is the root component of the game. It is used to set up the game with its properties and its children, which are the scenes of the game.
+ *
+ * @example
+ * ```jsx
+ * <Game width={150} height={75} defaultScene='main'>
+ *   <Scene name='main' component={() => import('./scenes/main.js')} />
+ * </Game>
+ * ```
+ *
+ * @param options - The options for the Game component, which include the properties of the game and its children (the scenes).
+ * @returns A JSX element representing the Game component with its properties and children.
+ */
+export function Game(_options) {
+    return null;
+}
+//# sourceMappingURL=game.js.map

package/dist/jsx/components/game.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.js","sourceRoot":"","sources":["../../../src/jsx/components/game.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,IAAI,CAAC,QAAqB;IACxC,OAAO,IAAI,CAAA;AACb,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './fragment.js';
+export * from './game.js';
+export * from './scene.js';
+export * from './list.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}

package/dist/jsx/components/index.js

@@ -0,0 +1,5 @@
+export * from './fragment.js';
+export * from './game.js';
+export * from './scene.js';
+export * from './list.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jsx/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}

package/dist/jsx/components/list.d.ts

@@ -0,0 +1,88 @@
+import '../../nodes/index.js';
+import { type Reactive } from '../../reactivity/index.js';
+import type { Dinix } from '../types.js';
+/**
+ * The **`ListOptions`** interface defines the options for a `List` component.
+ */
+export interface ListOptions<T> {
+    /**
+     * The **`array`** property is a signal getter that returns the array to render.
+     *
+     * @example
+     * ```tsx
+     * const [items, setItems] = useSignal([{ id: 1 }, { id: 2 }])
+     *
+     * <List array={items} itemKey={(item) => item.id}>
+     *   {(item) => <sprite textureId={ITEM} />}
+     * </List>
+     * ```
+     */
+    array: Reactive<T[]>;
+    /**
+     * The **`key`** property extracts a unique identifier for each item.
+     * Used for keyed reconciliation when the array changes.
+     *
+     * @example
+     * ```tsx
+     * <List array={items} itemKey={(item) => item.id}>
+     *   {(item) => <sprite textureId={ITEM} />}
+     * </List>
+     * ```
+     */
+    itemKey: (value: T, index: number, arr: T[]) => string | symbol;
+    /**
+     * The **`empty`** property is rendered when the array is empty.
+     *
+     * @example
+     * ```tsx
+     * <List array={items} itemKey={(item) => item.id} empty={<sprite textureId={EMPTY} />}>
+     *   {(item) => <sprite textureId={ITEM} />}
+     * </List>
+     * ```
+     */
+    empty?: Dinix.Node;
+    /**
+     * The **`children`** property is a render function called for each item in the array.
+     *
+     * @example
+     * ```tsx
+     * <List array={items} itemKey={(item) => item.id}>
+     *   {(item, index) => <transform position={[0, index * 16]}>
+     *     <sprite textureId={item.texture} />
+     *   </transform>}
+     * </List>
+     * ```
+     */
+    children: (value: T, index: number, arr: T[]) => Dinix.Node;
+}
+/**
+ * The **`List`** component renders dynamic nodes from a reactive array with keyed reconciliation.
+ * It returns a Fragment — no wrapper node is created.
+ * A hidden `<transform>` is used as an anchor for reconciliation.
+ *
+ * @param options The list options including the reactive array, key extractor, and render function.
+ * @returns A Fragment containing the anchor node.
+ *
+ * @example
+ * ```tsx
+ * import { List } from 'dinix/jsx'
+ * import { useSignal } from 'dinix/hooks'
+ *
+ * function EnemyList() {
+ *   const [enemies] = useSignal([
+ *     { id: 1, x: 0 },
+ *     { id: 2, x: 50 },
+ *   ])
+ *
+ *   return (
+ *     <List array={enemies} itemKey={(e) => e.id}>
+ *       {(enemy) => <transform position={[enemy.x, 0]}>
+ *         <sprite textureId={ENEMY} />
+ *       </transform>}
+ *     </List>
+ *   )
+ * }
+ * ```
+ */
+export declare function List<T>({ array, itemKey, empty, children }: ListOptions<T>): Dinix.Element;
+//# sourceMappingURL=list.d.ts.map

package/dist/jsx/components/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/list.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAA;AAC7B,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAMtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAMxC;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B;;;;;;;;;;;OAWG;IACH,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAA;IACpB;;;;;;;;;;OAUG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,MAAM,GAAG,MAAM,CAAA;IAC/D;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,CAAA;IAClB;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAA;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CA8D1F"}

package/dist/jsx/components/list.js

@@ -0,0 +1,93 @@
+import '../../nodes/index.js';
+import { subReactive } from '../../reactivity/index.js';
+import { PrimaryNode } from '../../nodes/lib/enum.js';
+import { renderToNodes } from '../render/to-nodes.js';
+import { useNode } from '../../hooks/use-node.js';
+import { currentContext } from '../../hooks/context.js';
+import { jsx } from '../jsx.js';
+import { useMount } from '../../hooks/use-mount.js';
+import { useRef } from '../../hooks/use-ref.js';
+import { HookRequiresNodeRootError } from '../../errors/hook.js';
+/**
+ * The **`List`** component renders dynamic nodes from a reactive array with keyed reconciliation.
+ * It returns a Fragment — no wrapper node is created.
+ * A hidden `<transform>` is used as an anchor for reconciliation.
+ *
+ * @param options The list options including the reactive array, key extractor, and render function.
+ * @returns A Fragment containing the anchor node.
+ *
+ * @example
+ * ```tsx
+ * import { List } from 'dinix/jsx'
+ * import { useSignal } from 'dinix/hooks'
+ *
+ * function EnemyList() {
+ *   const [enemies] = useSignal([
+ *     { id: 1, x: 0 },
+ *     { id: 2, x: 50 },
+ *   ])
+ *
+ *   return (
+ *     <List array={enemies} itemKey={(e) => e.id}>
+ *       {(enemy) => <transform position={[enemy.x, 0]}>
+ *         <sprite textureId={ENEMY} />
+ *       </transform>}
+ *     </List>
+ *   )
+ * }
+ * ```
+ */
+export function List({ array, itemKey, empty, children }) {
+    const savedCtx = currentContext.slice();
+    const anchor = useNode(PrimaryNode.Transform);
+    const map = useRef(new Map());
+    const emptyNode = useRef(null);
+    const handleRegen = (arr) => {
+        const prevCtx = currentContext.slice();
+        currentContext.length = 0;
+        currentContext.push(...savedCtx);
+        if (emptyNode.current != null) {
+            emptyNode.current.destroy();
+            emptyNode.current = null;
+        }
+        const nodes = [];
+        const oldIds = new Set(map.current.keys());
+        for (let i = 0; i < arr.length; i++) {
+            const props = arr[i];
+            const id = itemKey(props, i, arr);
+            if (oldIds.has(id)) {
+                oldIds.delete(id);
+                continue;
+            }
+            const node = renderToNodes(children(props, i, arr));
+            if (node.length !== 1)
+                throw new HookRequiresNodeRootError('internal-hook-List');
+            map.current.set(id, node[0]);
+            nodes.push(node[0]);
+        }
+        for (const [id, node] of map.current) {
+            if (!oldIds.has(id))
+                continue;
+            map.current.delete(id);
+            node.destroy();
+        }
+        anchor.node.addChild(...nodes);
+        if (anchor.node.children.length === 0) {
+            const node = renderToNodes(empty);
+            if (node.length !== 1)
+                throw new HookRequiresNodeRootError('internal-hook-List');
+            emptyNode.current = node[0];
+            anchor.node.addChild(emptyNode.current);
+        }
+        currentContext.length = 0;
+        currentContext.push(...prevCtx);
+    };
+    useMount(() => {
+        const generator = subReactive(array, handleRegen, (unsub) => {
+            anchor.node.destroyed.on(unsub);
+        });
+        handleRegen(generator);
+    });
+    return jsx(PrimaryNode.Transform, { ref: anchor });
+}
+//# sourceMappingURL=list.js.map