fraxel 0.1.0-alpha.1

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

@@ -0,0 +1,26 @@
+import { type Reactive, type SignalGetterLike } from '../../reactivity/index.js';
+/**
+ * The **`useMatch`** derived hook creates a computed value based on a signal's current value,
+ * similar to a `switch` or `match` expression. Maps a signal value to a corresponding value
+ * from a record.
+ *
+ * @param signal A `SignalGetterLike` that returns the key to match against
+ * @param record A record mapping signal values to computed values
+ * @param defaultValue The value to return if the signal value is not found in the record
+ * @returns A `SignalGetter<K>` that reflects the matched value
+ *
+ * @example
+ * ```tsx
+ * const [state, setState] = useSignal<'idle' | 'walking' | 'jumping'>('idle')
+ *
+ * const animation = useMatch(state, {
+ *   idle: 'idle-anim',
+ *   walking: 'walk-anim',
+ *   jumping: 'jump-anim',
+ * })
+ *
+ * return <animation-player currentAnim={animation} />
+ * ```
+ */
+export declare function useMatch<T extends number | string | symbol, K>(signal: SignalGetterLike<T>, record: Reactive<Record<T, K>>, defaultValue?: Reactive<K>): import("../../index.js").SignalGetter<K | undefined>;
+//# sourceMappingURL=use-match.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-match.d.ts","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAI1F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EAC5D,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC9B,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,wDAY3B"}

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

@@ -0,0 +1,38 @@
+import { reactive } from '../../reactivity/index.js';
+import { declareDerivedHook } from '../context';
+import { useComputed } from '../use-computed.js';
+/**
+ * The **`useMatch`** derived hook creates a computed value based on a signal's current value,
+ * similar to a `switch` or `match` expression. Maps a signal value to a corresponding value
+ * from a record.
+ *
+ * @param signal A `SignalGetterLike` that returns the key to match against
+ * @param record A record mapping signal values to computed values
+ * @param defaultValue The value to return if the signal value is not found in the record
+ * @returns A `SignalGetter<K>` that reflects the matched value
+ *
+ * @example
+ * ```tsx
+ * const [state, setState] = useSignal<'idle' | 'walking' | 'jumping'>('idle')
+ *
+ * const animation = useMatch(state, {
+ *   idle: 'idle-anim',
+ *   walking: 'walk-anim',
+ *   jumping: 'jump-anim',
+ * })
+ *
+ * return <animation-player currentAnim={animation} />
+ * ```
+ */
+export function useMatch(signal, record, defaultValue) {
+    declareDerivedHook('useMatch');
+    const recordValue = reactive(record);
+    const defaultVal = reactive(defaultValue);
+    return useComputed(() => {
+        const key = signal();
+        if (key in recordValue())
+            return recordValue()[key];
+        return defaultVal();
+    });
+}
+//# sourceMappingURL=use-match.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-match.js","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAwC,MAAM,2BAA2B,CAAA;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CACtB,MAA2B,EAC3B,MAA8B,EAC9B,YAA0B;IAE1B,kBAAkB,CAAC,UAAU,CAAC,CAAA;IAE9B,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;IAEzC,OAAO,WAAW,CAAC,GAAG,EAAE;QACtB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;QACpB,IAAI,GAAG,IAAI,WAAW,EAAE;YAAE,OAAO,WAAW,EAAE,CAAC,GAAG,CAAC,CAAA;QACnD,OAAO,UAAU,EAAE,CAAA;IACrB,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { PrimaryNode } from '../../nodes/index.js';
+import { NodeReference } from '../use-node.js';
+/**
+ * The **`usePartialNode`** helper accepts an optional `NodeReference`. If provided, returns it;
+ * otherwise creates a new one via `useNode`. Useful for derived hooks that can optionally
+ * accept an existing node reference.
+ *
+ * @param type The type of node to reference
+ * @param node An optional existing `NodeReference` to reuse
+ * @returns The provided `NodeReference` or a new one
+ *
+ * @example
+ * ```tsx
+ * // With existing ref
+ * const ref = usePartialNode(PrimaryNode.Clickable, existingRef)
+ *
+ * // Without existing ref (creates new)
+ * const ref = usePartialNode(PrimaryNode.Clickable)
+ * ```
+ */
+export declare function usePartialNode<T extends PrimaryNode>(type: T, node?: NodeReference<T>): NodeReference<T>;
+//# sourceMappingURL=use-partial-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-partial-node.d.ts","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-partial-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAW,MAAM,gBAAgB,CAAA;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,EAClD,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GACtB,aAAa,CAAC,CAAC,CAAC,CAGlB"}

package/dist/hooks/deriveds/use-partial-node.js

@@ -0,0 +1,25 @@
+import { NodeReference, useNode } from '../use-node.js';
+/**
+ * The **`usePartialNode`** helper accepts an optional `NodeReference`. If provided, returns it;
+ * otherwise creates a new one via `useNode`. Useful for derived hooks that can optionally
+ * accept an existing node reference.
+ *
+ * @param type The type of node to reference
+ * @param node An optional existing `NodeReference` to reuse
+ * @returns The provided `NodeReference` or a new one
+ *
+ * @example
+ * ```tsx
+ * // With existing ref
+ * const ref = usePartialNode(PrimaryNode.Clickable, existingRef)
+ *
+ * // Without existing ref (creates new)
+ * const ref = usePartialNode(PrimaryNode.Clickable)
+ * ```
+ */
+export function usePartialNode(type, node) {
+    if (node instanceof NodeReference)
+        return node;
+    return useNode(type);
+}
+//# sourceMappingURL=use-partial-node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-partial-node.js","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-partial-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAO,EACP,IAAuB;IAEvB,IAAI,IAAI,YAAY,aAAa;QAAE,OAAO,IAAI,CAAA;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC"}

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

@@ -0,0 +1,28 @@
+import { type Reactive, type SignalGetter, type SignalGetterLike } from '../../reactivity/index.js';
+/**
+ * The **`useWhen`** derived hook creates a computed value that toggles between two values
+ * based on a boolean signal. Similar to a ternary expression but reactive.
+ *
+ * @param signal A `SignalGetterLike` that determines which value to return
+ * @param whenTrue The value to return when the signal is `true`
+ * @param whenFalse The value to return when the signal is `false`
+ * @returns A `SignalGetter<T>` that reflects the current value
+ *
+ * @example
+ * ```tsx
+ * const isHovered = useCondition(clickable, 'mouseEntered', 'mouseExited')
+ * const brightness = useWhen(isHovered, 1.2, 1.0)
+ *
+ * return <sprite brightness={brightness} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const isZombieDetected = useCondition(raycast, 'colliderEntered', 'colliderExited')
+ * const animName = useWhen(isZombieDetected, 'shoot', 'idle')
+ *
+ * return <animation-player currentAnim={animName} />
+ * ```
+ */
+export declare function useWhen<T>(signal: SignalGetterLike<boolean>, whenTrue: Reactive<T>, whenFalse: Reactive<T>): SignalGetter<T>;
+//# sourceMappingURL=use-when.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-when.d.ts","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-when.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAA;AAIlC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACjC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,GACrB,YAAY,CAAC,CAAC,CAAC,CAOjB"}

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

@@ -0,0 +1,35 @@
+import { reactive, } from '../../reactivity/index.js';
+import { declareDerivedHook } from '../context';
+import { useComputed } from '../use-computed.js';
+/**
+ * The **`useWhen`** derived hook creates a computed value that toggles between two values
+ * based on a boolean signal. Similar to a ternary expression but reactive.
+ *
+ * @param signal A `SignalGetterLike` that determines which value to return
+ * @param whenTrue The value to return when the signal is `true`
+ * @param whenFalse The value to return when the signal is `false`
+ * @returns A `SignalGetter<T>` that reflects the current value
+ *
+ * @example
+ * ```tsx
+ * const isHovered = useCondition(clickable, 'mouseEntered', 'mouseExited')
+ * const brightness = useWhen(isHovered, 1.2, 1.0)
+ *
+ * return <sprite brightness={brightness} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const isZombieDetected = useCondition(raycast, 'colliderEntered', 'colliderExited')
+ * const animName = useWhen(isZombieDetected, 'shoot', 'idle')
+ *
+ * return <animation-player currentAnim={animName} />
+ * ```
+ */
+export function useWhen(signal, whenTrue, whenFalse) {
+    declareDerivedHook('useWhen');
+    const trueValue = reactive(whenTrue);
+    const falseValue = reactive(whenFalse);
+    return useComputed(() => (signal() ? trueValue() : falseValue()));
+}
+//# sourceMappingURL=use-when.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-when.js","sourceRoot":"","sources":["../../../src/hooks/deriveds/use-when.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,GAIT,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAiC,EACjC,QAAqB,EACrB,SAAsB;IAEtB,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAE7B,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;IAEtC,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;AACnE,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,16 @@
+import '../nodes/index.js';
+export { useChild } from './use-child.js';
+export { useEffect } from './use-effect.js';
+export { useEvent } from './use-event.js';
+export { useGame } from './use-game.js';
+export { useMount } from './use-mount.js';
+export { useNode, NodeReference } from './use-node.js';
+export { useRef } from './use-ref.js';
+export { useScript } from './use-script.js';
+export { useSignal } from './use-signal.js';
+export { useComputed } from './use-computed.js';
+export { useSpawn } from './use-spawn.js';
+export { createTrigger, useTrigger, type Trigger } from './use-trigger.js';
+export { createContext, useContext } from './use-context.js';
+export * from './deriveds/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE1E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE5D,cAAc,qBAAqB,CAAA"}

package/dist/hooks/index.js

@@ -0,0 +1,16 @@
+import '../nodes/index.js';
+export { useChild } from './use-child.js';
+export { useEffect } from './use-effect.js';
+export { useEvent } from './use-event.js';
+export { useGame } from './use-game.js';
+export { useMount } from './use-mount.js';
+export { useNode, NodeReference } from './use-node.js';
+export { useRef } from './use-ref.js';
+export { useScript } from './use-script.js';
+export { useSignal } from './use-signal.js';
+export { useComputed } from './use-computed.js';
+export { useSpawn } from './use-spawn.js';
+export { createTrigger, useTrigger } from './use-trigger.js';
+export { createContext, useContext } from './use-context.js';
+export * from './deriveds/index.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAA;AAE1E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE5D,cAAc,qBAAqB,CAAA"}

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

@@ -0,0 +1,24 @@
+import type { PrimaryNode } from '../nodes/lib/enum.js';
+import { NodeReference } from './use-node.js';
+/**
+ * The **`useChild`** hook gets a reference to a child node by path and type.
+ *
+ * @param path The path to the child node (array of strings or symbols)
+ * @param type The type of the child node to retrieve
+ * @returns A `NodeReference` to the child node
+ *
+ * @example
+ * ```tsx
+ * const sprite = useChild(['child1', 'child2'], PrimaryNode.Sprite)
+ *
+ * return (
+ *   <transform>
+ *     <transform id='child1'>
+ *       <sprite id='child2' />
+ *     </transform>
+ *   </transform>
+ * )
+ * ```
+ */
+export declare function useChild<T extends PrimaryNode>(path: (string | symbol)[], type: T): NodeReference<T>;
+//# sourceMappingURL=use-child.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-child.d.ts","sourceRoot":"","sources":["../../src/hooks/use-child.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACzB,IAAI,EAAE,CAAC,GACN,aAAa,CAAC,CAAC,CAAC,CAgBlB"}

package/dist/hooks/use-child.js

@@ -0,0 +1,37 @@
+import { HookRequiresNodeRootError } from '../errors/hook.js';
+import { pushEffect } from './context.js';
+import { NodeReference } from './use-node.js';
+/**
+ * The **`useChild`** hook gets a reference to a child node by path and type.
+ *
+ * @param path The path to the child node (array of strings or symbols)
+ * @param type The type of the child node to retrieve
+ * @returns A `NodeReference` to the child node
+ *
+ * @example
+ * ```tsx
+ * const sprite = useChild(['child1', 'child2'], PrimaryNode.Sprite)
+ *
+ * return (
+ *   <transform>
+ *     <transform id='child1'>
+ *       <sprite id='child2' />
+ *     </transform>
+ *   </transform>
+ * )
+ * ```
+ */
+export function useChild(path, type) {
+    const nodeRef = new NodeReference(type);
+    pushEffect('useChild', (nodes) => {
+        if (nodes.length > 1 || nodes.length === 0) {
+            throw new HookRequiresNodeRootError('useChild');
+        }
+        const node = nodes[0];
+        node.started.onFirst(() => {
+            nodeRef.node = node.child({ path, type });
+        });
+    });
+    return nodeRef;
+}
+//# sourceMappingURL=use-child.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-child.js","sourceRoot":"","sources":["../../src/hooks/use-child.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAyB,EACzB,IAAO;IAEP,MAAM,OAAO,GAAG,IAAI,aAAa,CAAI,IAAI,CAAC,CAAA;IAE1C,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,yBAAyB,CAAC,UAAU,CAAC,CAAA;QACjD,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QAEtB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;YACxB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

@@ -0,0 +1,28 @@
+import { type SignalGetter } from '../reactivity/index.js';
+/**
+ * The **`useComputed`** hook creates a derived signal that automatically updates
+ * when any of the dependent signals change. The callback function is re-evaluated
+ * whenever a dependency signal's value changes.
+ *
+ * @param fn The computation function that derives a value from the signal values
+ * @returns A getter of the current value of the Signal
+ *
+ * @example
+ * ```tsx
+ * const [x, setX] = useSignal(10)
+ * const [y, setY] = useSignal(20)
+ *
+ * // Automatically recomputes when x or y changes
+ * const sum = useComputed(() => x() + y())
+ *
+ * useEffect(() => {
+ *   console.log('Sum:', sum()) // 30
+ * })
+ *
+ * // Updating a dependency automatically updates the derived signal
+ * setX(15)
+ * // sum() is now 35
+ * ```
+ */
+export declare function useComputed<T>(fn: () => T): SignalGetter<T>;
+//# sourceMappingURL=use-computed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-computed.d.ts","sourceRoot":"","sources":["../../src/hooks/use-computed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAoB3D"}

package/dist/hooks/use-computed.js

@@ -0,0 +1,41 @@
+import { Signal, subReactive } from '../reactivity/index.js';
+import { pushEffect } from './context.js';
+/**
+ * The **`useComputed`** hook creates a derived signal that automatically updates
+ * when any of the dependent signals change. The callback function is re-evaluated
+ * whenever a dependency signal's value changes.
+ *
+ * @param fn The computation function that derives a value from the signal values
+ * @returns A getter of the current value of the Signal
+ *
+ * @example
+ * ```tsx
+ * const [x, setX] = useSignal(10)
+ * const [y, setY] = useSignal(20)
+ *
+ * // Automatically recomputes when x or y changes
+ * const sum = useComputed(() => x() + y())
+ *
+ * useEffect(() => {
+ *   console.log('Sum:', sum()) // 30
+ * })
+ *
+ * // Updating a dependency automatically updates the derived signal
+ * setX(15)
+ * // sum() is now 35
+ * ```
+ */
+export function useComputed(fn) {
+    let unsub;
+    pushEffect('useComputed', ([nd]) => {
+        if (nd == null)
+            return;
+        nd.destroyed.on(() => {
+            signalComputed.clearSubs();
+            unsub();
+        });
+    });
+    const signalComputed = new Signal(subReactive(fn, (val) => (signalComputed.value = val), (fn) => (unsub = fn)));
+    return signalComputed.getter;
+}
+//# sourceMappingURL=use-computed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-computed.js","sourceRoot":"","sources":["../../src/hooks/use-computed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAqB,MAAM,wBAAwB,CAAA;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,WAAW,CAAI,EAAW;IACxC,IAAI,KAAiB,CAAA;IAErB,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,IAAI,EAAE,IAAI,IAAI;YAAE,OAAM;QACtB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE;YACnB,cAAc,CAAC,SAAS,EAAE,CAAA;YAC1B,KAAK,EAAE,CAAA;QACT,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,MAAM,cAAc,GAAG,IAAI,MAAM,CAC/B,WAAW,CACT,EAAE,EACF,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,GAAG,GAAG,CAAC,EACrC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CACrB,CACF,CAAA;IAED,OAAO,cAAc,CAAC,MAAM,CAAA;AAC9B,CAAC"}

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

@@ -0,0 +1,58 @@
+import type { Dinix } from '../jsx/types.js';
+/**
+ * The **`createContext`** hook creates a context with a default value.
+ * Use the returned context's `Provider` to provide values to descendant nodes.
+ *
+ * @param defaultValue The default value for the context
+ * @returns A `ContextCreated` object with a `Provider` component
+ *
+ * @example
+ * ```tsx
+ * const ThemeCtx = createContext('light')
+ *
+ * function App() {
+ *   return (
+ *     <ThemeCtx.Provider value='dark'>
+ *       <Child />
+ *     </ThemeCtx.Provider>
+ *   )
+ * }
+ *
+ * function Child() {
+ *   const theme = useContext(ThemeCtx)
+ *   return <text text={theme} />
+ * }
+ * ```
+ */
+export declare function createContext<T>(defaultValue: T): ContextCreated<T>;
+/**
+ * The **`useContext`** hook retrieves the value of a context.
+ *
+ * @param contextCreated The context created with `createContext`
+ * @returns The current value of the context, or the default value if no Provider is found
+ *
+ * @example
+ * ```tsx
+ * const ThemeCtx = createContext('light')
+ *
+ * function Child() {
+ *   const theme = useContext(ThemeCtx)
+ *   return <text text={theme} />
+ * }
+ * ```
+ */
+export declare function useContext<T>(contextCreated: ContextCreated<T>): T;
+declare class ContextCreated<T> {
+    __id: number;
+    defaultValue: T;
+    constructor(defaultValue: T);
+    Provider: (props: Dinix.WithChildren<{
+        value: T;
+    }>) => Dinix.Element<any>;
+}
+export interface Context<T> {
+    id: number;
+    value: T;
+}
+export {};
+//# sourceMappingURL=use-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-context.d.ts","sourceRoot":"","sources":["../../src/hooks/use-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,qBAE/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAalE;AAED,cAAM,cAAc,CAAC,CAAC;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,CAAC,CAAA;gBAEH,YAAY,EAAE,CAAC;IAK3B,QAAQ,GAAI,OAAO,KAAK,CAAC,YAAY,CAAC;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,wBAMlD;CACF;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,CAAC,CAAA;CACT"}

package/dist/hooks/use-context.js

@@ -0,0 +1,77 @@
+import { Fragment } from '../jsx/components/fragment.js';
+import { currentContext, pushEffect } from './context.js';
+/**
+ * The **`createContext`** hook creates a context with a default value.
+ * Use the returned context's `Provider` to provide values to descendant nodes.
+ *
+ * @param defaultValue The default value for the context
+ * @returns A `ContextCreated` object with a `Provider` component
+ *
+ * @example
+ * ```tsx
+ * const ThemeCtx = createContext('light')
+ *
+ * function App() {
+ *   return (
+ *     <ThemeCtx.Provider value='dark'>
+ *       <Child />
+ *     </ThemeCtx.Provider>
+ *   )
+ * }
+ *
+ * function Child() {
+ *   const theme = useContext(ThemeCtx)
+ *   return <text text={theme} />
+ * }
+ * ```
+ */
+export function createContext(defaultValue) {
+    return new ContextCreated(defaultValue);
+}
+/**
+ * The **`useContext`** hook retrieves the value of a context.
+ *
+ * @param contextCreated The context created with `createContext`
+ * @returns The current value of the context, or the default value if no Provider is found
+ *
+ * @example
+ * ```tsx
+ * const ThemeCtx = createContext('light')
+ *
+ * function Child() {
+ *   const theme = useContext(ThemeCtx)
+ *   return <text text={theme} />
+ * }
+ * ```
+ */
+export function useContext(contextCreated) {
+    pushEffect('useContext', () => { });
+    let context;
+    for (let i = currentContext.length - 1; i >= 0; i--) {
+        const ctx = currentContext[i];
+        if (ctx.context?.id !== contextCreated.__id)
+            continue;
+        context = ctx.context.value;
+    }
+    return context ?? contextCreated.defaultValue;
+}
+class ContextCreated {
+    __id;
+    defaultValue;
+    constructor(defaultValue) {
+        this.defaultValue = defaultValue;
+        this.__id = genContextId();
+    }
+    Provider = (props) => {
+        const ctx = currentContext.at(-1);
+        if (ctx) {
+            ctx.context = { id: this.__id, value: props.value };
+        }
+        return Fragment(props);
+    };
+}
+let counter = 0;
+function genContextId() {
+    return ++counter;
+}
+//# sourceMappingURL=use-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-context.js","sourceRoot":"","sources":["../../src/hooks/use-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAExD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAAI,YAAe;IAC9C,OAAO,IAAI,cAAc,CAAI,YAAY,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAI,cAAiC;IAC7D,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAElC,IAAI,OAAsB,CAAA;IAE1B,KAAK,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAE,CAAA;QAE9B,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,cAAc,CAAC,IAAI;YAAE,SAAQ;QACrD,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED,OAAO,OAAO,IAAI,cAAc,CAAC,YAAY,CAAA;AAC/C,CAAC;AAED,MAAM,cAAc;IAClB,IAAI,CAAQ;IACZ,YAAY,CAAG;IAEf,YAAY,YAAe;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,YAAY,EAAE,CAAA;IAC5B,CAAC;IAED,QAAQ,GAAG,CAAC,KAAuC,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACjC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAA;QACrD,CAAC;QACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC,CAAA;CACF;AAOD,IAAI,OAAO,GAAG,CAAC,CAAA;AACf,SAAS,YAAY;IACnB,OAAO,EAAE,OAAO,CAAA;AAClB,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * The **`useEffect`** hook runs an effect function when the node starts and whenever any of the specified signals change.
+ * Effect re-executions are batched — if multiple signals change synchronously,
+ * the effect only runs once before the next frame.
+ * It also runs cleanup when the node is destroyed.
+ *
+ * @param fn The effect function. Can return a cleanup function.
+ *
+ * @example
+ * ```tsx
+ * const [count, setCount] = useSignal(0)
+ *
+ * useEffect(() => {
+ *   console.log('Count changed:', count())
+ *   return () => {
+ *     console.log('Cleanup')
+ *   }
+ * })
+ *
+ * return <transform />
+ * ```
+ */
+export declare function useEffect(fn: () => void | (() => void)): void;
+//# sourceMappingURL=use-effect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect.d.ts","sourceRoot":"","sources":["../../src/hooks/use-effect.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CA2C7D"}

package/dist/hooks/use-effect.js

@@ -0,0 +1,63 @@
+import { SignalRegister } from '../reactivity/register.js';
+import { pushEffect } from './context.js';
+/**
+ * The **`useEffect`** hook runs an effect function when the node starts and whenever any of the specified signals change.
+ * Effect re-executions are batched — if multiple signals change synchronously,
+ * the effect only runs once before the next frame.
+ * It also runs cleanup when the node is destroyed.
+ *
+ * @param fn The effect function. Can return a cleanup function.
+ *
+ * @example
+ * ```tsx
+ * const [count, setCount] = useSignal(0)
+ *
+ * useEffect(() => {
+ *   console.log('Count changed:', count())
+ *   return () => {
+ *     console.log('Cleanup')
+ *   }
+ * })
+ *
+ * return <transform />
+ * ```
+ */
+export function useEffect(fn) {
+    pushEffect('useEffect', (nodes) => {
+        if (nodes.length < 0)
+            return;
+        const node = nodes[0];
+        node.started.on(() => {
+            let unmountCurrentEffect = () => { };
+            let scheduled = false;
+            let cancelled = false;
+            const refresh = () => {
+                scheduled = false;
+                if (cancelled)
+                    return;
+                unmountCurrentEffect();
+                let currentSignals = [];
+                const unmountWatch = SignalRegister.watch(fn, (signals) => {
+                    currentSignals = signals;
+                    currentSignals.forEach((signal) => signal.sub(scheduleRefresh));
+                });
+                unmountCurrentEffect = () => {
+                    unmountWatch?.();
+                    currentSignals.forEach((signal) => signal.unsub(scheduleRefresh));
+                };
+            };
+            const scheduleRefresh = () => {
+                if (scheduled)
+                    return;
+                scheduled = true;
+                queueMicrotask(refresh);
+            };
+            node.destroyed.on(() => {
+                cancelled = true;
+                unmountCurrentEffect();
+            });
+            refresh();
+        });
+    });
+}
+//# sourceMappingURL=use-effect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect.js","sourceRoot":"","sources":["../../src/hooks/use-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,SAAS,CAAC,EAA6B;IACrD,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;QAChC,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,IAAI,oBAAoB,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;YACnC,IAAI,SAAS,GAAG,KAAK,CAAA;YACrB,IAAI,SAAS,GAAG,KAAK,CAAA;YAErB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,SAAS,GAAG,KAAK,CAAA;gBACjB,IAAI,SAAS;oBAAE,OAAM;gBAErB,oBAAoB,EAAE,CAAA;gBAEtB,IAAI,cAAc,GAAkB,EAAE,CAAA;gBAEtC,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE;oBACxD,cAAc,GAAG,OAAO,CAAA;oBACxB,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAA;gBACjE,CAAC,CAAC,CAAA;gBAEF,oBAAoB,GAAG,GAAG,EAAE;oBAC1B,YAAY,EAAE,EAAE,CAAA;oBAChB,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAA;gBACnE,CAAC,CAAA;YACH,CAAC,CAAA;YAED,MAAM,eAAe,GAAG,GAAG,EAAE;gBAC3B,IAAI,SAAS;oBAAE,OAAM;gBACrB,SAAS,GAAG,IAAI,CAAA;gBAChB,cAAc,CAAC,OAAO,CAAC,CAAA;YACzB,CAAC,CAAA;YAED,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE;gBACrB,SAAS,GAAG,IAAI,CAAA;gBAChB,oBAAoB,EAAE,CAAA;YACxB,CAAC,CAAC,CAAA;YAEF,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}