fraxel 0.1.0-alpha.1

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

@@ -0,0 +1,29 @@
+import { Event } from '../events/event.js';
+import type { Fun } from '../events/types.js';
+import type { PrimaryNode } from '../nodes/lib/enum.js';
+import type { NodeInstances } from '../nodes/lib/types.js';
+import type { NodeReference } from './use-node.js';
+/**
+ * The **`useEvent`** hook subscribes to an event on a node reference.
+ *
+ * @param node A `NodeReference` to the node that emits the event
+ * @param eventName The name of the event to subscribe to
+ * @param listener The callback function to call when the event is emitted
+ *
+ * @example
+ * ```tsx
+ * const sprite = useNode(PrimaryNode.Sprite)
+ *
+ * useEvent(sprite, 'started', () => {
+ *   console.log('Sprite started!')
+ * })
+ *
+ * return <sprite ref={sprite} />
+ * ```
+ */
+export declare function useEvent<N extends PrimaryNode, K extends keyof Events<N>>(node: NodeReference<N>, eventName: K, listener: Events<N>[K]): void;
+export type GetEvent<T> = T extends Event<infer P, string> ? Fun<P> : Fun<[]>;
+export type Events<T extends PrimaryNode> = {
+    [P in keyof NodeInstances[T] as NodeInstances[T][P] extends Event<any[], string> ? P : never]: GetEvent<NodeInstances[T][P]>;
+};
+//# sourceMappingURL=use-event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.d.ts","sourceRoot":"","sources":["../../src/hooks/use-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM,MAAM,CAAC,CAAC,CAAC,EACvE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EACtB,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAOvB;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAA;AAE7E,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,WAAW,IAAI;KAExC,CAAC,IAAI,MAAM,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,GAC1F,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjC,CAAA"}

package/dist/hooks/use-event.js

@@ -0,0 +1,30 @@
+import { InvalidEventInHookError } from '../errors/hook.js';
+import { Event } from '../events/event.js';
+import { pushEffect } from './context.js';
+/**
+ * The **`useEvent`** hook subscribes to an event on a node reference.
+ *
+ * @param node A `NodeReference` to the node that emits the event
+ * @param eventName The name of the event to subscribe to
+ * @param listener The callback function to call when the event is emitted
+ *
+ * @example
+ * ```tsx
+ * const sprite = useNode(PrimaryNode.Sprite)
+ *
+ * useEvent(sprite, 'started', () => {
+ *   console.log('Sprite started!')
+ * })
+ *
+ * return <sprite ref={sprite} />
+ * ```
+ */
+export function useEvent(node, eventName, listener) {
+    pushEffect('useEvent', () => {
+        const ev = node.node[eventName];
+        if (!(ev instanceof Event))
+            throw new InvalidEventInHookError('useEvent', eventName);
+        ev.on(listener);
+    });
+}
+//# sourceMappingURL=use-event.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.js","sourceRoot":"","sources":["../../src/hooks/use-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAI1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAsB,EACtB,SAAY,EACZ,QAAsB;IAEtB,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE;QAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC/B,IAAI,CAAC,CAAC,EAAE,YAAY,KAAK,CAAC;YAAE,MAAM,IAAI,uBAAuB,CAAC,UAAU,EAAE,SAAmB,CAAC,CAAA;QAC9F,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { GameControls } from '../jsx/render/game.js';
+/**
+ * The **`useGame`** hooks gets the game controls.
+ *
+ * @example
+ * ```tsx
+ * const game = useGame()
+ *
+ * const handleStart = () => {
+ *   game.pause()
+ * }
+ *
+ * return <transform onStart={handleStart} />
+ * ```
+ */
+export declare function useGame(): GameControls;
+//# sourceMappingURL=use-game.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-game.d.ts","sourceRoot":"","sources":["../../src/hooks/use-game.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAIzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,IAAI,YAAY,CAgBtC"}

package/dist/hooks/use-game.js

@@ -0,0 +1,35 @@
+import { GameConfig } from '../core/game-config.js';
+import { Game } from '../core/game.js';
+import { Vector2 } from '../math/vector2.js';
+import { pushEffect } from './context.js';
+/**
+ * The **`useGame`** hooks gets the game controls.
+ *
+ * @example
+ * ```tsx
+ * const game = useGame()
+ *
+ * const handleStart = () => {
+ *   game.pause()
+ * }
+ *
+ * return <transform onStart={handleStart} />
+ * ```
+ */
+export function useGame() {
+    pushEffect('useGame', () => { });
+    return {
+        play: () => Game.play(),
+        pause: () => Game.pause(),
+        changeScene: (name) => {
+            return Game.sceneManager.setScene(name);
+        },
+        preloadScene: (name) => {
+            return Game.sceneManager.preloadScene(name);
+        },
+        getSize() {
+            return new Vector2(GameConfig.width, GameConfig.height);
+        },
+    };
+}
+//# sourceMappingURL=use-game.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-game.js","sourceRoot":"","sources":["../../src/hooks/use-game.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO;IACrB,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAE/B,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE;QACzB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;YACpB,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACzC,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,OAAO,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAC7C,CAAC;QACD,OAAO;YACL,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;QACzD,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * The **`useMount`** hook runs a function when the node starts.
+ * If the function returns a cleanup function, it runs when the node is destroyed.
+ * Does not re-run on signal changes — only on mount and unmount.
+ *
+ * @param fn The function to run on mount. Can return a cleanup function that runs on destroy.
+ *
+ * @example
+ * ```tsx
+ * useMount(() => {
+ *   console.log('Node mounted')
+ *   return () => {
+ *     console.log('Node destroyed')
+ *   }
+ * })
+ *
+ * return <transform />
+ * ```
+ */
+export declare function useMount(fn: () => void | (() => void)): void;
+//# sourceMappingURL=use-mount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-mount.d.ts","sourceRoot":"","sources":["../../src/hooks/use-mount.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAU5D"}

package/dist/hooks/use-mount.js

@@ -0,0 +1,33 @@
+import { pushEffect } from './context.js';
+/**
+ * The **`useMount`** hook runs a function when the node starts.
+ * If the function returns a cleanup function, it runs when the node is destroyed.
+ * Does not re-run on signal changes — only on mount and unmount.
+ *
+ * @param fn The function to run on mount. Can return a cleanup function that runs on destroy.
+ *
+ * @example
+ * ```tsx
+ * useMount(() => {
+ *   console.log('Node mounted')
+ *   return () => {
+ *     console.log('Node destroyed')
+ *   }
+ * })
+ *
+ * return <transform />
+ * ```
+ */
+export function useMount(fn) {
+    pushEffect('useMount', (nodes) => {
+        if (nodes.length < 0)
+            return;
+        const node = nodes[0];
+        node.started.on(() => {
+            const unmount = fn();
+            if (unmount)
+                node.destroyed.on(() => unmount());
+        });
+    });
+}
+//# sourceMappingURL=use-mount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-mount.js","sourceRoot":"","sources":["../../src/hooks/use-mount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,QAAQ,CAAC,EAA6B;IACpD,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAM;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QAEtB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE;YACnB,MAAM,OAAO,GAAG,EAAE,EAAE,CAAA;YACpB,IAAI,OAAO;gBAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QACjD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,42 @@
+import { PrimaryNode } from '../nodes/lib/enum.js';
+import { type NodeInstances } from '../nodes/lib/types.js';
+import type { SignalGetter } from '../reactivity/types.js';
+/**
+ * The **`useNode`** hook creates a reference to a node of the specified type.
+ * The reference can be passed to a node's `ref` prop to get a reference to it.
+ *
+ * @param type The type of node to reference
+ * @returns A `NodeReference` that will be populated when the node is mounted
+ *
+ * @example
+ * ```tsx
+ * const sprite = useNode(PrimaryNode.Sprite)
+ *
+ * return (
+ *   <transform>
+ *     <sprite ref={sprite} />
+ *   </transform>
+ * )
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const transform = useNode(PrimaryNode.Transform)
+ * const spawn = useSpawn(transform)
+ *
+ * return (
+ *   <transform ref={transform}>
+ *     <clickable onClick={() => spawn(<sprite />)} />
+ *   </transform>
+ * )
+ * ```
+ */
+export declare function useNode<T extends PrimaryNode>(type: T): NodeReference<T>;
+export declare class NodeReference<T extends PrimaryNode> {
+    #private;
+    set node(node: NodeInstances[T]);
+    get node(): NodeInstances[T];
+    signal: SignalGetter<NodeInstances[T] | null>;
+    constructor(type: T);
+}
+//# sourceMappingURL=use-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-node.d.ts","sourceRoot":"","sources":["../../src/hooks/use-node.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAKxE;AAED,qBAAa,aAAa,CAAC,CAAC,SAAS,WAAW;;IAI9C,IAAI,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAK9B;IACD,IAAI,IAAI,IANO,aAAa,CAAC,CAAC,CAAC,CAW9B;IACD,MAAM,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;gBAEjC,IAAI,EAAE,CAAC;CAIpB"}

package/dist/hooks/use-node.js

@@ -0,0 +1,63 @@
+import { NodeNotInitializedError } from '../errors/lifecycle.js';
+import { NodeTypeMismatchError } from '../errors/node.js';
+import { PrimaryNode } from '../nodes/lib/enum.js';
+import {} from '../nodes/lib/types.js';
+import { Signal } from '../reactivity/signal.js';
+import { pushEffect } from './context.js';
+/**
+ * The **`useNode`** hook creates a reference to a node of the specified type.
+ * The reference can be passed to a node's `ref` prop to get a reference to it.
+ *
+ * @param type The type of node to reference
+ * @returns A `NodeReference` that will be populated when the node is mounted
+ *
+ * @example
+ * ```tsx
+ * const sprite = useNode(PrimaryNode.Sprite)
+ *
+ * return (
+ *   <transform>
+ *     <sprite ref={sprite} />
+ *   </transform>
+ * )
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const transform = useNode(PrimaryNode.Transform)
+ * const spawn = useSpawn(transform)
+ *
+ * return (
+ *   <transform ref={transform}>
+ *     <clickable onClick={() => spawn(<sprite />)} />
+ *   </transform>
+ * )
+ * ```
+ */
+export function useNode(type) {
+    pushEffect('useNode', () => { });
+    const nodeRef = new NodeReference(type);
+    return nodeRef;
+}
+export class NodeReference {
+    #type;
+    #node = new Signal(null);
+    set node(node) {
+        if (node.type !== this.#type) {
+            throw new NodeTypeMismatchError(this.#type, node.type);
+        }
+        this.#node.value = node;
+    }
+    get node() {
+        if (this.#node.value == null) {
+            throw new NodeNotInitializedError(this.#type);
+        }
+        return this.#node.value;
+    }
+    signal;
+    constructor(type) {
+        this.#type = type;
+        this.signal = this.#node.getter;
+    }
+}
+//# sourceMappingURL=use-node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-node.js","sourceRoot":"","sources":["../../src/hooks/use-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAsB,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,OAAO,CAAwB,IAAO;IACpD,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC/B,MAAM,OAAO,GAAG,IAAI,aAAa,CAAI,IAAI,CAAC,CAAA;IAE1C,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,OAAO,aAAa;IACxB,KAAK,CAAG;IACR,KAAK,GAAG,IAAI,MAAM,CAA0B,IAAI,CAAC,CAAA;IAEjD,IAAI,IAAI,CAAC,IAAsB;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;IACzB,CAAC;IACD,IAAI,IAAI;QACN,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAA;IACzB,CAAC;IACD,MAAM,CAAuC;IAE7C,YAAY,IAAO;QACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,27 @@
+/**
+ * The **`Reference`** class holds a mutable value that persists across renders.
+ */
+export declare class Reference<T> {
+    constructor(value: T);
+    current: T;
+}
+/**
+ * The **`useRef`** hook creates a mutable reference that persists across renders.
+ *
+ * @param value The initial value
+ * @returns A `Reference` object with a mutable `current` property
+ *
+ * @example
+ * ```tsx
+ * const count = useRef(0)
+ *
+ * const handleClick = () => {
+ *   count.current++
+ *   console.log(count.current)
+ * }
+ *
+ * return <clickable onClick={handleClick} />
+ * ```
+ */
+export declare function useRef<T>(value: T): Reference<T>;
+//# sourceMappingURL=use-ref.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-ref.d.ts","sourceRoot":"","sources":["../../src/hooks/use-ref.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC;gBACV,KAAK,EAAE,CAAC;IAIpB,OAAO,EAAE,CAAC,CAAA;CACX;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,gBAGjC"}

package/dist/hooks/use-ref.js

@@ -0,0 +1,33 @@
+import { pushEffect } from './context';
+/**
+ * The **`Reference`** class holds a mutable value that persists across renders.
+ */
+export class Reference {
+    constructor(value) {
+        this.current = value;
+    }
+    current;
+}
+/**
+ * The **`useRef`** hook creates a mutable reference that persists across renders.
+ *
+ * @param value The initial value
+ * @returns A `Reference` object with a mutable `current` property
+ *
+ * @example
+ * ```tsx
+ * const count = useRef(0)
+ *
+ * const handleClick = () => {
+ *   count.current++
+ *   console.log(count.current)
+ * }
+ *
+ * return <clickable onClick={handleClick} />
+ * ```
+ */
+export function useRef(value) {
+    pushEffect('useRef', () => { });
+    return new Reference(value);
+}
+//# sourceMappingURL=use-ref.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-ref.js","sourceRoot":"","sources":["../../src/hooks/use-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB,YAAY,KAAQ;QAClB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;IACtB,CAAC;IAED,OAAO,CAAG;CACX;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,MAAM,CAAI,KAAQ;IAChC,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC9B,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC"}

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

@@ -0,0 +1,33 @@
+import type { PrimaryNode } from '../nodes';
+import type { DinixScript } from '../scripts';
+import type { NodeReference } from './use-node';
+/**
+ * The **`useScript`** hook retrieves the script attached to a node reference.
+ *
+ * @param node A `NodeReference` to the node that has the script
+ * @returns A `SignalGetter` containing the script instance
+ *
+ * @example
+ * ```tsx
+ * function Player() {
+ *   const sprite = useNode(PrimaryNode.Sprite)
+ *   const script = useScript<PlayerScript>(sprite)
+ *
+ *   const handleStart = () => {
+ *     console.log(script()) // The script instance
+ *   }
+ *
+ *   return <sprite ref={sprite} onStart={handleStart} script={new PlayerScript()} />
+ * }
+ *
+ * class PlayerScript extends DinixScript<PrimaryNode.Sprite> {
+ *   health = 100
+ *
+ *   setup() {
+ *     // Do something...
+ *   }
+ * }
+ * ```
+ */
+export declare function useScript<T extends DinixScript<PrimaryNode>>(node: NodeReference<PrimaryNode>): import("..").SignalGetter<T | undefined>;
+//# sourceMappingURL=use-script.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-script.d.ts","sourceRoot":"","sources":["../../src/hooks/use-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,4CAU7F"}

package/dist/hooks/use-script.js

@@ -0,0 +1,40 @@
+import { pushEffect } from './context';
+import { useEffect } from './use-effect';
+import { Signal } from '../reactivity';
+/**
+ * The **`useScript`** hook retrieves the script attached to a node reference.
+ *
+ * @param node A `NodeReference` to the node that has the script
+ * @returns A `SignalGetter` containing the script instance
+ *
+ * @example
+ * ```tsx
+ * function Player() {
+ *   const sprite = useNode(PrimaryNode.Sprite)
+ *   const script = useScript<PlayerScript>(sprite)
+ *
+ *   const handleStart = () => {
+ *     console.log(script()) // The script instance
+ *   }
+ *
+ *   return <sprite ref={sprite} onStart={handleStart} script={new PlayerScript()} />
+ * }
+ *
+ * class PlayerScript extends DinixScript<PrimaryNode.Sprite> {
+ *   health = 100
+ *
+ *   setup() {
+ *     // Do something...
+ *   }
+ * }
+ * ```
+ */
+export function useScript(node) {
+    pushEffect('useScript', () => { });
+    const script = new Signal(undefined);
+    useEffect(() => {
+        script.value = node.signal()?.script;
+    });
+    return script.getter;
+}
+//# sourceMappingURL=use-script.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-script.js","sourceRoot":"","sources":["../../src/hooks/use-script.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,SAAS,CAAqC,IAAgC;IAC5F,UAAU,CAAC,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAEjC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAgB,SAAS,CAAC,CAAA;IAEnD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,MAAW,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { SignalGetter, SignalSetter } from '../reactivity/types.js';
+/**
+ * The **`useSignal`** hook creates a reactive signal with an initial value.
+ * The signal will notify subscribers when its value changes.
+ *
+ * @param initialValue The initial value of the signal
+ * @returns A tuple to [get, set] the value.
+ *
+ * @example
+ * ```tsx
+ * const [count, setCount] = useSignal(0)
+ *
+ * const handleClick = () => {
+ *   setCount(count() + 1)
+ * }
+ *
+ * useEffect(() => {
+ *   console.log('Count:', count())
+ * })
+ *
+ * return <clickable onClick={handleClick} />
+ * ```
+ */
+export declare function useSignal<T>(initialValue: T): [SignalGetter<T>, SignalSetter<T>];
+//# sourceMappingURL=use-signal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-signal.d.ts","sourceRoot":"","sources":["../../src/hooks/use-signal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAGxE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAYhF"}

package/dist/hooks/use-signal.js

@@ -0,0 +1,36 @@
+import { Signal } from '../reactivity/signal.js';
+import { pushEffect } from './context.js';
+/**
+ * The **`useSignal`** hook creates a reactive signal with an initial value.
+ * The signal will notify subscribers when its value changes.
+ *
+ * @param initialValue The initial value of the signal
+ * @returns A tuple to [get, set] the value.
+ *
+ * @example
+ * ```tsx
+ * const [count, setCount] = useSignal(0)
+ *
+ * const handleClick = () => {
+ *   setCount(count() + 1)
+ * }
+ *
+ * useEffect(() => {
+ *   console.log('Count:', count())
+ * })
+ *
+ * return <clickable onClick={handleClick} />
+ * ```
+ */
+export function useSignal(initialValue) {
+    pushEffect('useSignal', ([node]) => {
+        if (node == null)
+            return;
+        node.destroyed.on(() => signal.clearSubs());
+    });
+    const signal = new Signal(initialValue);
+    const getter = signal.getter;
+    const setter = signal.setter;
+    return [getter, setter];
+}
+//# sourceMappingURL=use-signal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-signal.js","sourceRoot":"","sources":["../../src/hooks/use-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,SAAS,CAAI,YAAe;IAC1C,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;QACjC,IAAI,IAAI,IAAI,IAAI;YAAE,OAAM;QACxB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAA;IAEvC,MAAM,MAAM,GAAoB,MAAM,CAAC,MAAM,CAAA;IAC7C,MAAM,MAAM,GAAoB,MAAM,CAAC,MAAM,CAAA;IAE7C,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACzB,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { Dinix } from '../jsx/types.js';
+import type { PrimaryNode } from '../nodes/lib/enum.js';
+import type { NodeReference } from './use-node.js';
+/**
+ * The **`useSpawn`** hook returns a function that can spawn nodes as children of the specified node.
+ *
+ * @param node A `NodeReference` to the node that will be the parent of spawned nodes
+ * @returns A function that accepts JSX nodes and adds them as children
+ *
+ * @example
+ * ```tsx
+ * const container = useNode(PrimaryNode.Transform)
+ * const spawn = useSpawn(container)
+ *
+ * const handleClick = () => {
+ *   spawn(<sprite />)
+ * }
+ *
+ * return (
+ *   <transform ref={container}>
+ *     <clickable onClick={handleClick} />
+ *   </transform>
+ * )
+ * ```
+ */
+export declare function useSpawn<T extends PrimaryNode>(node: NodeReference<T>): (jsx: Dinix.Node) => void;
+//# sourceMappingURL=use-spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-spawn.d.ts","sourceRoot":"","sources":["../../src/hooks/use-spawn.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,SAGhD,KAAK,CAAC,IAAI,UAgB/B"}

package/dist/hooks/use-spawn.js

@@ -0,0 +1,39 @@
+import { renderToNodes } from '../jsx/index.js';
+import { currentContext, pushEffect } from './context.js';
+/**
+ * The **`useSpawn`** hook returns a function that can spawn nodes as children of the specified node.
+ *
+ * @param node A `NodeReference` to the node that will be the parent of spawned nodes
+ * @returns A function that accepts JSX nodes and adds them as children
+ *
+ * @example
+ * ```tsx
+ * const container = useNode(PrimaryNode.Transform)
+ * const spawn = useSpawn(container)
+ *
+ * const handleClick = () => {
+ *   spawn(<sprite />)
+ * }
+ *
+ * return (
+ *   <transform ref={container}>
+ *     <clickable onClick={handleClick} />
+ *   </transform>
+ * )
+ * ```
+ */
+export function useSpawn(node) {
+    const oldCtx = currentContext.slice();
+    const spawn = (jsx) => {
+        const currentCtx = currentContext.slice();
+        currentContext.length = 0;
+        currentContext.push(...oldCtx);
+        const nodes = renderToNodes(jsx);
+        node.node.addChild(...nodes);
+        currentContext.length = 0;
+        currentContext.push(...currentCtx);
+    };
+    pushEffect('useSpawn', () => { });
+    return spawn;
+}
+//# sourceMappingURL=use-spawn.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-spawn.js","sourceRoot":"","sources":["../../src/hooks/use-spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,QAAQ,CAAwB,IAAsB;IACpE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,CAAA;IAErC,MAAM,KAAK,GAAG,CAAC,GAAe,EAAE,EAAE;QAChC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,EAAE,CAAA;QAEzC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAA;QACzB,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QAE9B,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAA;QAE5B,cAAc,CAAC,MAAM,GAAG,CAAC,CAAA;QACzB,cAAc,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAA;IACpC,CAAC,CAAA;IAED,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAEhC,OAAO,KAAK,CAAA;AACd,CAAC"}