fraxel 0.1.0-alpha.1

package/dist/hooks/deriveds/by-nodes/use-animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-animation.d.ts","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAKtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,eAAe,CAAC;;;;;;;;EA0B7E"}

package/dist/hooks/deriveds/by-nodes/use-animation.js

@@ -0,0 +1,61 @@
+import { PrimaryNode } from '../../../nodes/index.js';
+import { declareDerivedHook } from '../../context.js';
+import { useEvent } from '../../use-event.js';
+import { useSignal } from '../../use-signal.js';
+import { usePartialNode } from '../use-partial-node.js';
+import { useCondition } from '../use-condition.js';
+/**
+ * The **`useAnimation`** derived hook provides a declarative API for the `AnimationPlayer` node.
+ * Returns the node reference, reactive `animName` and `frameIndex` signals,
+ * a reactive `ended` boolean, and control methods.
+ *
+ * @param anim An optional existing `NodeReference` to the AnimationPlayer node
+ * @returns An object with `ref`, `animName`, `frameIndex`, `ended`, `play`, `stop`, `setNext`
+ *
+ * @example
+ * ```tsx
+ * import { useAnimation } from 'dinix/hooks'
+ *
+ * function Character() {
+ *   const sprite = useNode(PrimaryNode.Sprite)
+ *   const { ref, animName, ended, play, setNext } = useAnimation()
+ *
+ *   useEffect(() => {
+ *     play(isWalking() ? 'walk' : 'idle')
+ *   })
+ *
+ *   useEvent(ref, 'animationEnded', () => {
+ *     setNext('idle')
+ *   })
+ *
+ *   return (
+ *     <sprite ref={sprite} textureId={CHAR}>
+ *       <animation-player ref={ref} animations={() => anims} currentAnim={animName} />
+ *     </sprite>
+ *   )
+ * }
+ * ```
+ */
+export function useAnimation(anim) {
+    declareDerivedHook('useAnimation');
+    const ref = usePartialNode(PrimaryNode.AnimationPlayer, anim);
+    const [animName, setAnimName] = useSignal(null);
+    useEvent(ref, 'animationChanged', (name) => setAnimName(name));
+    useEvent(ref, 'animationStopped', () => setAnimName(null));
+    const [frameIndex, setFrameIndex] = useSignal(0);
+    useEvent(ref, 'animationIndexChanged', setFrameIndex);
+    const ended = useCondition(ref, 'animationEnded', 'animationChanged');
+    const play = (...args) => ref.node.play(...args);
+    const stop = (...args) => ref.node.stop(...args);
+    const setNext = (...args) => ref.node.setNext(...args);
+    return {
+        ref,
+        animName,
+        frameIndex,
+        ended,
+        play,
+        stop,
+        setNext,
+    };
+}
+//# sourceMappingURL=use-animation.js.map

package/dist/hooks/deriveds/by-nodes/use-animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-animation.js","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,YAAY,CAAC,IAAiD;IAC5E,kBAAkB,CAAC,cAAc,CAAC,CAAA;IAClC,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;IAE7D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,SAAS,CAAgB,IAAI,CAAC,CAAA;IAC9D,QAAQ,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9D,QAAQ,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IAE1D,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IAChD,QAAQ,CAAC,GAAG,EAAE,uBAAuB,EAAE,aAAa,CAAC,CAAA;IAErD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAA;IAErE,MAAM,IAAI,GAAyB,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IACtE,MAAM,IAAI,GAAyB,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IACtE,MAAM,OAAO,GAA4B,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IAE/E,OAAO;QACL,GAAG;QACH,QAAQ;QACR,UAAU;QACV,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,OAAO;KACR,CAAA;AACH,CAAC"}

package/dist/hooks/deriveds/by-nodes/use-audio.d.ts

@@ -0,0 +1,33 @@
+import { PrimaryNode } from '../../../nodes/index.js';
+import type { NodeReference } from '../../use-node.js';
+/**
+ * The **`useAudio`** derived hook provides a declarative API for the `AudioPlayer` node.
+ * Returns the node reference, a reactive `playing` boolean, and control methods.
+ *
+ * @param audio An optional existing `NodeReference` to the AudioPlayer node
+ * @returns An object with `ref`, `playing`, `play`, `pause`, `stop`
+ *
+ * @example
+ * ```tsx
+ * import { useAudio } from 'dinix/hooks'
+ *
+ * function MusicPlayer() {
+ *   const { ref, playing, play, stop } = useAudio()
+ *
+ *   return (
+ *     <transform>
+ *       <audio-player ref={ref} soundId={MUSIC} loop />
+ *       <clickable onClick={() => playing() ? stop() : play()} />
+ *     </transform>
+ *   )
+ * }
+ * ```
+ */
+export declare function useAudio(audio?: NodeReference<PrimaryNode.AudioPlayer>): {
+    ref: NodeReference<PrimaryNode.AudioPlayer>;
+    playing: import("../../../index.js").SignalGetter<boolean>;
+    play: (offset?: number) => void;
+    pause: () => void;
+    stop: () => void;
+};
+//# sourceMappingURL=use-audio.d.ts.map

package/dist/hooks/deriveds/by-nodes/use-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-audio.d.ts","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC;;;;;;EAiBtE"}

package/dist/hooks/deriveds/by-nodes/use-audio.js

@@ -0,0 +1,43 @@
+import { PrimaryNode } from '../../../nodes/index.js';
+import { declareDerivedHook } from '../../context.js';
+import { usePartialNode } from '../use-partial-node.js';
+import { useCondition } from '../use-condition.js';
+/**
+ * The **`useAudio`** derived hook provides a declarative API for the `AudioPlayer` node.
+ * Returns the node reference, a reactive `playing` boolean, and control methods.
+ *
+ * @param audio An optional existing `NodeReference` to the AudioPlayer node
+ * @returns An object with `ref`, `playing`, `play`, `pause`, `stop`
+ *
+ * @example
+ * ```tsx
+ * import { useAudio } from 'dinix/hooks'
+ *
+ * function MusicPlayer() {
+ *   const { ref, playing, play, stop } = useAudio()
+ *
+ *   return (
+ *     <transform>
+ *       <audio-player ref={ref} soundId={MUSIC} loop />
+ *       <clickable onClick={() => playing() ? stop() : play()} />
+ *     </transform>
+ *   )
+ * }
+ * ```
+ */
+export function useAudio(audio) {
+    declareDerivedHook('useAudio');
+    const ref = usePartialNode(PrimaryNode.AudioPlayer, audio);
+    const playing = useCondition(ref, 'started', 'ended');
+    const play = (...args) => ref.node.play(...args);
+    const pause = (...args) => ref.node.pause(...args);
+    const stop = (...args) => ref.node.stop(...args);
+    return {
+        ref,
+        playing,
+        play,
+        pause,
+        stop,
+    };
+}
+//# sourceMappingURL=use-audio.js.map

package/dist/hooks/deriveds/by-nodes/use-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-audio.js","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAA8C;IACrE,kBAAkB,CAAC,UAAU,CAAC,CAAA;IAC9B,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IAE1D,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IAErD,MAAM,IAAI,GAAyB,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IACtE,MAAM,KAAK,GAA0B,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;IACzE,MAAM,IAAI,GAAyB,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IAEtE,OAAO;QACL,GAAG;QACH,OAAO;QACP,IAAI;QACJ,KAAK;QACL,IAAI;KACL,CAAA;AACH,CAAC"}

package/dist/hooks/deriveds/by-nodes/use-clickable.d.ts

@@ -0,0 +1,32 @@
+import { Vector2 } from '../../../math/vector2.js';
+import { PrimaryNode } from '../../../nodes/index.js';
+import type { NodeReference } from '../../use-node.js';
+/**
+ * The **`useClickable`** derived hook provides a declarative API for the `Clickable` node.
+ * Returns the node reference and a reactive `hovered` boolean that tracks pointer hover state.
+ *
+ * @param clickable An optional existing `NodeReference` to the Clickable node
+ * @returns An object with `ref` (NodeReference) and `hovered` (SignalGetter<boolean>)
+ *
+ * @example
+ * ```tsx
+ * import { useClickable } from 'dinix/hooks'
+ *
+ * function Button() {
+ *   const clickable = useClickable()
+ *   const brightness = useComputed(() => (clickable.hovered() ? 1.1 : 1))
+ *
+ *   return (
+ *     <sprite ref={clickable.ref} textureId={BTN} brightness={brightness}>
+ *       <clickable size={[64, 32]} onClick={handleClick} />
+ *     </sprite>
+ *   )
+ * }
+ * ```
+ */
+export declare function useClickable(clickable?: NodeReference<PrimaryNode.Clickable>): {
+    ref: NodeReference<PrimaryNode.Clickable>;
+    hovered: import("../../../index.js").SignalGetter<boolean>;
+    position: import("../../../index.js").SignalGetter<Vector2>;
+};
+//# sourceMappingURL=use-clickable.d.ts.map

package/dist/hooks/deriveds/by-nodes/use-clickable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-clickable.d.ts","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-clickable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAKtD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC;;;;EAa5E"}

package/dist/hooks/deriveds/by-nodes/use-clickable.js

@@ -0,0 +1,43 @@
+import { Vector2 } from '../../../math/vector2.js';
+import { PrimaryNode } from '../../../nodes/index.js';
+import { declareDerivedHook } from '../../context.js';
+import { useEvent } from '../../use-event.js';
+import { useSignal } from '../../use-signal.js';
+import { useCondition } from '../use-condition.js';
+import { usePartialNode } from '../use-partial-node.js';
+/**
+ * The **`useClickable`** derived hook provides a declarative API for the `Clickable` node.
+ * Returns the node reference and a reactive `hovered` boolean that tracks pointer hover state.
+ *
+ * @param clickable An optional existing `NodeReference` to the Clickable node
+ * @returns An object with `ref` (NodeReference) and `hovered` (SignalGetter<boolean>)
+ *
+ * @example
+ * ```tsx
+ * import { useClickable } from 'dinix/hooks'
+ *
+ * function Button() {
+ *   const clickable = useClickable()
+ *   const brightness = useComputed(() => (clickable.hovered() ? 1.1 : 1))
+ *
+ *   return (
+ *     <sprite ref={clickable.ref} textureId={BTN} brightness={brightness}>
+ *       <clickable size={[64, 32]} onClick={handleClick} />
+ *     </sprite>
+ *   )
+ * }
+ * ```
+ */
+export function useClickable(clickable) {
+    declareDerivedHook('useClickable');
+    const ref = usePartialNode(PrimaryNode.Clickable, clickable);
+    const hovered = useCondition(ref, 'mouseEntered', 'mouseExited');
+    const [position, setPos] = useSignal(Vector2.ZERO);
+    useEvent(ref, 'mouseOver', setPos);
+    return {
+        ref,
+        hovered,
+        position,
+    };
+}
+//# sourceMappingURL=use-clickable.js.map

package/dist/hooks/deriveds/by-nodes/use-clickable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-clickable.js","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-clickable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAAC,SAAgD;IAC3E,kBAAkB,CAAC,cAAc,CAAC,CAAA;IAClC,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAE5D,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,CAAC,CAAA;IAChE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IAElC,OAAO;QACL,GAAG;QACH,OAAO;QACP,QAAQ;KACT,CAAA;AACH,CAAC"}

package/dist/hooks/deriveds/by-nodes/use-collider.d.ts

@@ -0,0 +1,35 @@
+import { Collider, PrimaryNode } from '../../../nodes/index.js';
+import type { NodeReference } from '../../use-node.js';
+/**
+ * The **`useCollider`** derived hook provides a declarative API for the `Collider` node.
+ * Returns the node reference, a reactive `colliding` boolean, and a signal tracking
+ * the currently colliding collider.
+ *
+ * @param collider An optional existing `NodeReference` to the Collider node
+ * @returns An object with `ref`, `colliding`, and `other`
+ *
+ * @example
+ * ```tsx
+ * import { useCollider } from 'dinix/hooks'
+ *
+ * function DamageZone() {
+ *   const { ref, colliding, other } = useCollider()
+ *
+ *   useEffect(() => {
+ *     if (colliding()) {
+ *       console.log('Touching:', other())
+ *     }
+ *   })
+ *
+ *   return (
+ *     <collider ref={ref} shape={shapes.circle(16)} group={['zone']} collidesWith={['player']} />
+ *   )
+ * }
+ * ```
+ */
+export declare function useCollider(collider?: NodeReference<PrimaryNode.Collider>): {
+    ref: NodeReference<PrimaryNode.Collider>;
+    colliding: import("../../../index.js").SignalGetter<boolean>;
+    detectedColliders: import("../../../index.js").SignalGetter<Set<Collider>>;
+};
+//# sourceMappingURL=use-collider.d.ts.map

package/dist/hooks/deriveds/by-nodes/use-collider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collider.d.ts","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-collider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAKtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC;;;;EAuBzE"}

package/dist/hooks/deriveds/by-nodes/use-collider.js

@@ -0,0 +1,55 @@
+import { Collider, PrimaryNode } from '../../../nodes/index.js';
+import { declareDerivedHook } from '../../context.js';
+import { useEvent } from '../../use-event.js';
+import { useSignal } from '../../use-signal.js';
+import { usePartialNode } from '../use-partial-node.js';
+import { useComputed } from '../../use-computed.js';
+/**
+ * The **`useCollider`** derived hook provides a declarative API for the `Collider` node.
+ * Returns the node reference, a reactive `colliding` boolean, and a signal tracking
+ * the currently colliding collider.
+ *
+ * @param collider An optional existing `NodeReference` to the Collider node
+ * @returns An object with `ref`, `colliding`, and `other`
+ *
+ * @example
+ * ```tsx
+ * import { useCollider } from 'dinix/hooks'
+ *
+ * function DamageZone() {
+ *   const { ref, colliding, other } = useCollider()
+ *
+ *   useEffect(() => {
+ *     if (colliding()) {
+ *       console.log('Touching:', other())
+ *     }
+ *   })
+ *
+ *   return (
+ *     <collider ref={ref} shape={shapes.circle(16)} group={['zone']} collidesWith={['player']} />
+ *   )
+ * }
+ * ```
+ */
+export function useCollider(collider) {
+    declareDerivedHook('useCollider');
+    const ref = usePartialNode(PrimaryNode.Collider, collider);
+    const [detectedColliders, setDC] = useSignal(new Set());
+    useEvent(ref, 'colliderEntered', (c) => {
+        const set = new Set(detectedColliders());
+        set.add(c);
+        setDC(set);
+    });
+    useEvent(ref, 'colliderExited', (c) => {
+        const set = new Set(detectedColliders());
+        set.delete(c);
+        setDC(set);
+    });
+    const colliding = useComputed(() => detectedColliders() != null);
+    return {
+        ref,
+        colliding,
+        detectedColliders,
+    };
+}
+//# sourceMappingURL=use-collider.js.map

package/dist/hooks/deriveds/by-nodes/use-collider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collider.js","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-collider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,WAAW,CAAC,QAA8C;IACxE,kBAAkB,CAAC,aAAa,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAE1D,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG,SAAS,CAAgB,IAAI,GAAG,EAAE,CAAC,CAAA;IACtE,QAAQ,CAAC,GAAG,EAAE,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAA;QACxC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACV,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC,CAAC,CAAA;IACF,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAA;QACxC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACb,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC,CAAC,CAAA;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,IAAI,IAAI,CAAC,CAAA;IAEhE,OAAO;QACL,GAAG;QACH,SAAS;QACT,iBAAiB;KAClB,CAAA;AACH,CAAC"}

package/dist/hooks/deriveds/by-nodes/use-ray-cast.d.ts

@@ -0,0 +1,35 @@
+import { Collider, PrimaryNode } from '../../../nodes/index.js';
+import type { NodeReference } from '../../use-node.js';
+/**
+ * The **`useRayCast`** derived hook provides a declarative API for the `RayCast` node.
+ * Returns the node reference, a reactive `detected` boolean, the current collider signal,
+ * and a reactive `length` computed value.
+ *
+ * @param raycast An optional existing `NodeReference` to the RayCast node
+ * @returns An object with `ref`, `detected`, `collider`, and `length`
+ *
+ * @example
+ * ```tsx
+ * import { useRayCast } from 'dinix/hooks'
+ *
+ * function Peashooter() {
+ *   const { ref, detected, collider } = useRayCast()
+ *
+ *   useEffect(() => {
+ *     if (detected()) {
+ *       console.log('Hit:', collider())
+ *     }
+ *   })
+ *
+ *   return (
+ *     <ray-cast ref={ref} direction={[100, 0]} collidesWith={['zombie']} />
+ *   )
+ * }
+ * ```
+ */
+export declare function useRayCast(raycast?: NodeReference<PrimaryNode.RayCast>): {
+    ref: NodeReference<PrimaryNode.RayCast>;
+    detected: import("../../../index.js").SignalGetter<boolean>;
+    collider: import("../../../index.js").SignalGetter<Collider | null>;
+};
+//# sourceMappingURL=use-ray-cast.d.ts.map

package/dist/hooks/deriveds/by-nodes/use-ray-cast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-ray-cast.d.ts","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-ray-cast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAI/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC;;;;EAetE"}

package/dist/hooks/deriveds/by-nodes/use-ray-cast.js

@@ -0,0 +1,47 @@
+import { Collider, PrimaryNode } from '../../../nodes/index.js';
+import { declareDerivedHook } from '../../context.js';
+import { useComputed } from '../../use-computed.js';
+import { useEvent } from '../../use-event.js';
+import { useSignal } from '../../use-signal.js';
+import { usePartialNode } from '../use-partial-node.js';
+/**
+ * The **`useRayCast`** derived hook provides a declarative API for the `RayCast` node.
+ * Returns the node reference, a reactive `detected` boolean, the current collider signal,
+ * and a reactive `length` computed value.
+ *
+ * @param raycast An optional existing `NodeReference` to the RayCast node
+ * @returns An object with `ref`, `detected`, `collider`, and `length`
+ *
+ * @example
+ * ```tsx
+ * import { useRayCast } from 'dinix/hooks'
+ *
+ * function Peashooter() {
+ *   const { ref, detected, collider } = useRayCast()
+ *
+ *   useEffect(() => {
+ *     if (detected()) {
+ *       console.log('Hit:', collider())
+ *     }
+ *   })
+ *
+ *   return (
+ *     <ray-cast ref={ref} direction={[100, 0]} collidesWith={['zombie']} />
+ *   )
+ * }
+ * ```
+ */
+export function useRayCast(raycast) {
+    declareDerivedHook('useRayCast');
+    const ref = usePartialNode(PrimaryNode.RayCast, raycast);
+    const [collider, setCollider] = useSignal(null);
+    useEvent(ref, 'colliderEntered', (c) => setCollider(c));
+    useEvent(ref, 'colliderExited', () => setCollider(null));
+    const detected = useComputed(() => collider() != null);
+    return {
+        ref,
+        detected,
+        collider,
+    };
+}
+//# sourceMappingURL=use-ray-cast.js.map

package/dist/hooks/deriveds/by-nodes/use-ray-cast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-ray-cast.js","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-ray-cast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,UAAU,CAAC,OAA4C;IACrE,kBAAkB,CAAC,YAAY,CAAC,CAAA;IAChC,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAExD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,SAAS,CAAkB,IAAI,CAAC,CAAA;IAChE,QAAQ,CAAC,GAAG,EAAE,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IAExD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAA;IAEtD,OAAO;QACL,GAAG;QACH,QAAQ;QACR,QAAQ;KACT,CAAA;AACH,CAAC"}

package/dist/hooks/deriveds/by-nodes/use-timer.d.ts

@@ -0,0 +1,34 @@
+import { PrimaryNode } from '../../../nodes/index.js';
+import type { NodeReference } from '../../use-node.js';
+/**
+ * The **`useTimer`** derived hook provides a declarative API for the `Timer` node.
+ * Returns the node reference, reactive time/progress values, and control methods.
+ *
+ * @param timer An optional existing `NodeReference` to the Timer node
+ * @returns An object with `ref`, `time`, `progress`, `play`, `pause`, `stop`
+ *
+ * @example
+ * ```tsx
+ * import { useTimer } from 'dinix/hooks'
+ *
+ * function Cooldown() {
+ *   const { ref, time, progress, play, pause, stop } = useTimer()
+ *
+ *   return (
+ *     <transform>
+ *       <timer ref={ref} duration={3} autoPlay />
+ *       <rectangle size={[100, 10]} fillColor={[1 - progress(), progress(), 0, 1]} />
+ *     </transform>
+ *   )
+ * }
+ * ```
+ */
+export declare function useTimer(timer?: NodeReference<PrimaryNode.Timer>): {
+    ref: NodeReference<PrimaryNode.Timer>;
+    time: import("../../../index.js").SignalGetter<number>;
+    progress: import("../../../index.js").SignalGetter<number>;
+    play: (from?: number) => void;
+    pause: () => void;
+    stop: () => void;
+};
+//# sourceMappingURL=use-timer.d.ts.map

package/dist/hooks/deriveds/by-nodes/use-timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-timer.d.ts","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAIrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC;;;;;;;EAqBhE"}

package/dist/hooks/deriveds/by-nodes/use-timer.js

@@ -0,0 +1,48 @@
+import { PrimaryNode } from '../../../nodes/index.js';
+import { declareDerivedHook } from '../../context.js';
+import { useComputed } from '../../use-computed.js';
+import { useEvent } from '../../use-event.js';
+import { useSignal } from '../../use-signal.js';
+import { usePartialNode } from '../use-partial-node.js';
+/**
+ * The **`useTimer`** derived hook provides a declarative API for the `Timer` node.
+ * Returns the node reference, reactive time/progress values, and control methods.
+ *
+ * @param timer An optional existing `NodeReference` to the Timer node
+ * @returns An object with `ref`, `time`, `progress`, `play`, `pause`, `stop`
+ *
+ * @example
+ * ```tsx
+ * import { useTimer } from 'dinix/hooks'
+ *
+ * function Cooldown() {
+ *   const { ref, time, progress, play, pause, stop } = useTimer()
+ *
+ *   return (
+ *     <transform>
+ *       <timer ref={ref} duration={3} autoPlay />
+ *       <rectangle size={[100, 10]} fillColor={[1 - progress(), progress(), 0, 1]} />
+ *     </transform>
+ *   )
+ * }
+ * ```
+ */
+export function useTimer(timer) {
+    declareDerivedHook('useTimer');
+    const ref = usePartialNode(PrimaryNode.Timer, timer);
+    const [time, setTime] = useSignal(0);
+    useEvent(ref, 'timeChanged', setTime);
+    const progress = useComputed(() => time() / (ref.signal()?.duration ?? time()));
+    const play = (...args) => ref.node.play(...args);
+    const pause = (...args) => ref.node.pause(...args);
+    const stop = (...args) => ref.node.stop(...args);
+    return {
+        ref,
+        time,
+        progress,
+        play,
+        pause,
+        stop,
+    };
+}
+//# sourceMappingURL=use-timer.js.map

package/dist/hooks/deriveds/by-nodes/use-timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-timer.js","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/use-timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAwC;IAC/D,kBAAkB,CAAC,UAAU,CAAC,CAAA;IAC9B,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAEpD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IACpC,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;IAErC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;IAE/E,MAAM,IAAI,GAAyB,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IACtE,MAAM,KAAK,GAA0B,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;IACzE,MAAM,IAAI,GAAyB,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IAEtE,OAAO;QACL,GAAG;QACH,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,KAAK;QACL,IAAI;KACL,CAAA;AACH,CAAC"}

package/dist/hooks/deriveds/index.d.ts

@@ -0,0 +1,5 @@
+export * from './by-nodes/index.js';
+export { useCondition } from './use-condition.js';
+export { useMatch } from './use-match.js';
+export { useWhen } from './use-when.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/deriveds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/deriveds/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/hooks/deriveds/index.js

@@ -0,0 +1,5 @@
+export * from './by-nodes/index.js';
+export { useCondition } from './use-condition.js';
+export { useMatch } from './use-match.js';
+export { useWhen } from './use-when.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/deriveds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/deriveds/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/hooks/deriveds/use-condition.d.ts

@@ -0,0 +1,37 @@
+import type { PrimaryNode } from '../../nodes/index.js';
+import { type SignalGetter } from '../../reactivity/index.js';
+import { type Events } from '../use-event.js';
+import type { NodeReference } from '../use-node.js';
+/**
+ * The **`useCondition`** derived hook creates a reactive boolean that toggles between `true` and `false`
+ * based on two opposing events on a node. Returns a `SignalGetter<boolean>` that can be used
+ * with `useComputed`, reactive props, or `useEffect`.
+ *
+ * @param node A `NodeReference` to the node that emits the events
+ * @param agreeEvent The event name that sets the condition to `true`
+ * @param disagreeEvent The event name that sets the condition to `false`
+ * @param defaultValue The initial value of the condition (defaults to `false`)
+ * @returns A `SignalGetter<boolean>` that reflects the current state
+ *
+ * @example
+ * ```tsx
+ * const clickable = useNode(PrimaryNode.Clickable)
+ * const hover = useCondition(clickable, 'mouseEntered', 'mouseExited')
+ *
+ * const brightness = useComputed(() => (hover() ? 1.1 : 1))
+ *
+ * return <sprite brightness={brightness} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const raycast = useNode(PrimaryNode.RayCast)
+ * const isZombieDetected = useCondition(raycast, 'colliderEntered', 'colliderExited')
+ *
+ * useEffect(() => {
+ *   anim.node.setNext(isZombieDetected() ? 'shoot' : 'idle')
+ * })
+ * ```
+ */
+export declare function useCondition<N extends PrimaryNode, A extends keyof Events<N>, D extends keyof Events<N>>(node: NodeReference<N>, agreeEvent: A, disagreeEvent: D, defaultValue?: boolean): SignalGetter<boolean>;
+//# sourceMappingURL=use-condition.d.ts.map

package/dist/hooks/deriveds/use-condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-condition.d.ts","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,OAAO,EAAY,KAAK,MAAM,EAAiB,MAAM,iBAAiB,CAAA;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAC1B,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,MAAM,MAAM,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,MAAM,MAAM,CAAC,CAAC,CAAC,EAEzB,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EACtB,UAAU,EAAE,CAAC,EACb,aAAa,EAAE,CAAC,EAChB,YAAY,UAAQ,GACnB,YAAY,CAAC,OAAO,CAAC,CAavB"}

package/dist/hooks/deriveds/use-condition.js

@@ -0,0 +1,47 @@
+import {} from '../../reactivity/index.js';
+import { declareDerivedHook } from '../context.js';
+import { useEvent } from '../use-event.js';
+import { useSignal } from '../use-signal.js';
+/**
+ * The **`useCondition`** derived hook creates a reactive boolean that toggles between `true` and `false`
+ * based on two opposing events on a node. Returns a `SignalGetter<boolean>` that can be used
+ * with `useComputed`, reactive props, or `useEffect`.
+ *
+ * @param node A `NodeReference` to the node that emits the events
+ * @param agreeEvent The event name that sets the condition to `true`
+ * @param disagreeEvent The event name that sets the condition to `false`
+ * @param defaultValue The initial value of the condition (defaults to `false`)
+ * @returns A `SignalGetter<boolean>` that reflects the current state
+ *
+ * @example
+ * ```tsx
+ * const clickable = useNode(PrimaryNode.Clickable)
+ * const hover = useCondition(clickable, 'mouseEntered', 'mouseExited')
+ *
+ * const brightness = useComputed(() => (hover() ? 1.1 : 1))
+ *
+ * return <sprite brightness={brightness} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const raycast = useNode(PrimaryNode.RayCast)
+ * const isZombieDetected = useCondition(raycast, 'colliderEntered', 'colliderExited')
+ *
+ * useEffect(() => {
+ *   anim.node.setNext(isZombieDetected() ? 'shoot' : 'idle')
+ * })
+ * ```
+ */
+export function useCondition(node, agreeEvent, disagreeEvent, defaultValue = false) {
+    declareDerivedHook('useCondition');
+    const [condition, setCondition] = useSignal(defaultValue);
+    useEvent(node, agreeEvent, (() => {
+        setCondition(true);
+    }));
+    useEvent(node, disagreeEvent, (() => {
+        setCondition(false);
+    }));
+    return condition;
+}
+//# sourceMappingURL=use-condition.js.map

package/dist/hooks/deriveds/use-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-condition.js","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-condition.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,QAAQ,EAA8B,MAAM,iBAAiB,CAAA;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,YAAY,CAK1B,IAAsB,EACtB,UAAa,EACb,aAAgB,EAChB,YAAY,GAAG,KAAK;IAEpB,kBAAkB,CAAC,cAAc,CAAC,CAAA;IAElC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,CAAA;IAEzD,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE;QAC/B,YAAY,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAkC,CAAC,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,GAAG,EAAE;QAClC,YAAY,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC,CAAkC,CAAC,CAAA;IAEpC,OAAO,SAAS,CAAA;AAClB,CAAC"}