fraxel 0.1.0-alpha.1

package/dist/nodes/node2d/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/nodes/node2d/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAGzD;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC;CAAG;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAU,SAAQ,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC;gBAC9C,OAAO,EAAE,gBAAgB;CAGtC"}

package/dist/nodes/node2d/transform.js

@@ -0,0 +1,30 @@
+import { PrimaryNode } from '../lib/enum.js';
+import { Node2D } from './_node2d.js';
+import { Nodes } from '../lib/registry.js';
+/**
+ * The **`Transform`** node is a container for positioning and organizing child nodes.
+ * It has no visual representation but provides a coordinate system for its children.
+ *
+ * @example
+ * ```tsx
+ * import { useNode } from 'dinix/hooks'
+ * import { PrimaryNode } from 'dinix/nodes/enum'
+ *
+ * function Player() {
+ *   const body = useNode(PrimaryNode.Transform)
+ *
+ *   return (
+ *     <transform ref={body} position={new Vector2(100, 200)}>
+ *       <sprite textureId={PLAYER} />
+ *     </transform>
+ *   )
+ * }
+ * ```
+ */
+export class Transform extends Node2D {
+    constructor(options) {
+        super(PrimaryNode.Transform, options);
+    }
+}
+Nodes.transform = Transform;
+//# sourceMappingURL=transform.js.map

package/dist/nodes/node2d/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/nodes/node2d/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAsB,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAQ1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAU,SAAQ,MAA6B;IAC1D,YAAY,OAAyB;QACnC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;CACF;AAED,KAAK,CAAC,SAAS,GAAG,SAAS,CAAA"}

package/dist/nodes/timer.d.ts

@@ -0,0 +1,107 @@
+import { Event } from '../events/event.js';
+import { PrimaryNode } from './lib/enum.js';
+import { Node, type NodeOptions } from './_node.js';
+import type { Reactive } from '../reactivity/types.js';
+/**
+ * The **`TimerOptions`** interface defines the options for a `Timer` node.
+ */
+export interface TimerOptions extends NodeOptions<PrimaryNode.Timer> {
+    /**
+     * The **`duration`** property defines the total duration of the timer in seconds.
+     *
+     * @example
+     * ```tsx
+     * // 5 second timer
+     * <timer duration={5} />
+     * ```
+     */
+    duration: Reactive<number>;
+    /**
+     * The **`autoPlay`** property determines whether the timer starts automatically.
+     *
+     * @default false
+     *
+     * @example
+     * ```tsx
+     * // Auto-starts when the node is added to the scene
+     * <timer duration={3} autoPlay />
+     * ```
+     */
+    autoPlay?: boolean;
+}
+/**
+ * The **`Timer`** node counts up to a duration and emits events when time changes or the timer completes.
+ * It has no visual representation but can contain child nodes.
+ *
+ * @example
+ * ```tsx
+ * import { useNode, useEvent } from 'dinix/hooks'
+ * import { PrimaryNode } from 'dinix/nodes/enum'
+ *
+ * function CooldownTimer() {
+ *   const timer = useNode(PrimaryNode.Timer)
+ *
+ *   useEvent(timer, 'timeout', () => {
+ *     console.log('Cooldown finished!')
+ *   })
+ *
+ *   useEvent(timer, 'timeChanged', (time) => {
+ *     console.log('Time:', time)
+ *   })
+ *
+ *   return (
+ *     <timer ref={timer} duration={5} autoPlay />
+ *   )
+ * }
+ * ```
+ */
+export declare class Timer extends Node<PrimaryNode.Timer> {
+    #private;
+    /**
+     * The **`duration`** property defines the total duration of the timer in seconds.
+     */
+    duration: number;
+    constructor(options: TimerOptions);
+    /**
+     * The **`timeout`** event fires when the timer reaches its duration.
+     */
+    timeout: Event<[], "timeout">;
+    /**
+     * The **`timeChanged`** event fires every frame while the timer is playing.
+     * The callback receives the current elapsed time in seconds.
+     */
+    timeChanged: Event<[_time: number], "timeChange">;
+    /**
+     * The **`play`** method starts or resumes the timer.
+     * @param from Optional time in seconds to start from. Clamped to `[0, duration]`.
+     *
+     * @example
+     * ```tsx
+     * timer.node.play()      // Resume from current position
+     * timer.node.play(0)     // Start from the beginning
+     * timer.node.play(2.5)   // Start from 2.5 seconds
+     * ```
+     */
+    play(from?: number): void;
+    /**
+     * The **`pause`** method pauses the timer without resetting its position.
+     *
+     * @example
+     * ```tsx
+     * timer.node.pause()
+     * ```
+     */
+    pause(): void;
+    /**
+     * The **`stop`** method stops the timer and resets the elapsed time to zero.
+     *
+     * @example
+     * ```tsx
+     * timer.node.stop()
+     * ```
+     */
+    stop(): void;
+    /** @internal Updates the timer each frame. */
+    update(delta: number): void;
+}
+//# sourceMappingURL=timer.d.ts.map

package/dist/nodes/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/nodes/timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAGtD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC;IAClE;;;;;;;;OAQG;IACH,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC1B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,KAAM,SAAQ,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;;IAEhD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;gBAGJ,OAAO,EAAE,YAAY;IAMjC;;OAEG;IACH,OAAO,uBAAiC;IAExC;;;OAGG;IACH,WAAW,uCAAiD;IAE5D;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM;IAKlB;;;;;;;OAOG;IACH,KAAK;IAIL;;;;;;;OAOG;IACH,IAAI;IAKJ,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAa5B"}

package/dist/nodes/timer.js

@@ -0,0 +1,108 @@
+import { Event } from '../events/event.js';
+import { PrimaryNode } from './lib/enum.js';
+import { Node } from './_node.js';
+import { Nodes } from './lib/registry.js';
+import { propSignal } from '../utils/ternaries.js';
+/**
+ * The **`Timer`** node counts up to a duration and emits events when time changes or the timer completes.
+ * It has no visual representation but can contain child nodes.
+ *
+ * @example
+ * ```tsx
+ * import { useNode, useEvent } from 'dinix/hooks'
+ * import { PrimaryNode } from 'dinix/nodes/enum'
+ *
+ * function CooldownTimer() {
+ *   const timer = useNode(PrimaryNode.Timer)
+ *
+ *   useEvent(timer, 'timeout', () => {
+ *     console.log('Cooldown finished!')
+ *   })
+ *
+ *   useEvent(timer, 'timeChanged', (time) => {
+ *     console.log('Time:', time)
+ *   })
+ *
+ *   return (
+ *     <timer ref={timer} duration={5} autoPlay />
+ *   )
+ * }
+ * ```
+ */
+export class Timer extends Node {
+    #counter = 0;
+    /**
+     * The **`duration`** property defines the total duration of the timer in seconds.
+     */
+    duration;
+    #isPlaying = false;
+    constructor(options) {
+        super(PrimaryNode.Timer, options);
+        this.duration = propSignal(this, 'duration', options.duration);
+        if (options.autoPlay)
+            this.play();
+    }
+    /**
+     * The **`timeout`** event fires when the timer reaches its duration.
+     */
+    timeout = new Event('timeout', () => { });
+    /**
+     * The **`timeChanged`** event fires every frame while the timer is playing.
+     * The callback receives the current elapsed time in seconds.
+     */
+    timeChanged = new Event('timeChange', (_time) => { });
+    /**
+     * The **`play`** method starts or resumes the timer.
+     * @param from Optional time in seconds to start from. Clamped to `[0, duration]`.
+     *
+     * @example
+     * ```tsx
+     * timer.node.play()      // Resume from current position
+     * timer.node.play(0)     // Start from the beginning
+     * timer.node.play(2.5)   // Start from 2.5 seconds
+     * ```
+     */
+    play(from) {
+        this.#counter = Math.min(from ?? this.#counter, this.duration);
+        this.#isPlaying = true;
+    }
+    /**
+     * The **`pause`** method pauses the timer without resetting its position.
+     *
+     * @example
+     * ```tsx
+     * timer.node.pause()
+     * ```
+     */
+    pause() {
+        this.#isPlaying = false;
+    }
+    /**
+     * The **`stop`** method stops the timer and resets the elapsed time to zero.
+     *
+     * @example
+     * ```tsx
+     * timer.node.stop()
+     * ```
+     */
+    stop() {
+        this.#isPlaying = false;
+        this.#counter = 0;
+    }
+    /** @internal Updates the timer each frame. */
+    update(delta) {
+        if (this.#isPlaying) {
+            if (this.#counter >= this.duration) {
+                this.stop();
+                this.timeout.emit();
+            }
+            else {
+                this.timeChanged.emit(this.#counter);
+                this.#counter += delta;
+            }
+        }
+        super.update(delta);
+    }
+}
+Nodes.timer = Timer;
+//# sourceMappingURL=timer.js.map

package/dist/nodes/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/nodes/timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAoB,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AA8BlD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,KAAM,SAAQ,IAAuB;IAChD,QAAQ,GAAG,CAAC,CAAA;IACZ;;OAEG;IACH,QAAQ,CAAQ;IAChB,UAAU,GAAG,KAAK,CAAA;IAElB,YAAY,OAAqB;QAC/B,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACjC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC9D,IAAI,OAAO,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,EAAE,CAAA;IACnC,CAAC;IAED;;OAEG;IACH,OAAO,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAExC;;;OAGG;IACH,WAAW,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC,KAAa,EAAE,EAAE,GAAE,CAAC,CAAC,CAAA;IAE5D;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAa;QAChB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;IACxB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,IAAI;QACF,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QACvB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;IACnB,CAAC;IAED,8CAA8C;IAC9C,MAAM,CAAC,KAAa;QAClB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI,EAAE,CAAA;gBACX,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YACrB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBACpC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAA;YACxB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;CACF;AAED,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA"}

package/dist/reactivity/index.d.ts

@@ -0,0 +1,5 @@
+export * from './signal.js';
+export * from './reactive.js';
+export * from './register.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/reactivity/index.js

@@ -0,0 +1,5 @@
+export * from './signal.js';
+export * from './reactive.js';
+export * from './register.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/reactivity/index.js.map

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

package/dist/reactivity/reactive.d.ts

@@ -0,0 +1,4 @@
+import type { Reactive, SignalGetterLike } from './types.js';
+export declare function subReactive<T>(value: Reactive<T>, onUse: (value: T) => void, onSet?: (unsub: () => void) => void): T;
+export declare function reactive<T>(value: Reactive<T>): SignalGetterLike<T>;
+//# sourceMappingURL=reactive.d.ts.map

package/dist/reactivity/reactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../../src/reactivity/reactive.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE5D,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EACzB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,GAClC,CAAC,CA0BH;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CA4BnE"}

package/dist/reactivity/reactive.js

@@ -0,0 +1,50 @@
+import { SignalRegister } from './register.js';
+export function subReactive(value, onUse, onSet) {
+    if (typeof value !== 'function')
+        return value;
+    const signal = value;
+    const currentSignals = [];
+    let currentValue = null;
+    let first = true;
+    const refresh = () => {
+        currentSignals.forEach((s) => s.unsub(refresh));
+        currentValue = SignalRegister.watch(signal, (signals) => {
+            currentSignals.length = 0;
+            currentSignals.push(...signals);
+        });
+        if (!first) {
+            onUse(currentValue);
+        }
+        else {
+            first = false;
+        }
+        currentSignals.forEach((s) => s.sub(refresh));
+    };
+    refresh();
+    onSet?.(() => currentSignals.forEach((s) => s.unsub(refresh)));
+    return currentValue;
+}
+export function reactive(value) {
+    if (typeof value !== 'function')
+        return () => value;
+    const signal = value;
+    let currentSignals = [];
+    let currentValue = null;
+    const refresh = () => {
+        currentSignals.forEach((s) => s.unsub(refresh));
+        evaluateAndTrack();
+        currentSignals.forEach((s) => s.sub(refresh));
+    };
+    const evaluateAndTrack = () => {
+        currentValue = SignalRegister.watch(signal, (signals) => {
+            currentSignals = signals;
+        });
+    };
+    refresh();
+    const getter = () => {
+        currentSignals.forEach((signal) => SignalRegister.register(signal));
+        return currentValue;
+    };
+    return getter;
+}
+//# sourceMappingURL=reactive.js.map

package/dist/reactivity/reactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.js","sourceRoot":"","sources":["../../src/reactivity/reactive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAI9C,MAAM,UAAU,WAAW,CACzB,KAAkB,EAClB,KAAyB,EACzB,KAAmC;IAEnC,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7C,MAAM,MAAM,GAAG,KAA4B,CAAA;IAE3C,MAAM,cAAc,GAAkB,EAAE,CAAA;IACxC,IAAI,YAAY,GAAa,IAAI,CAAA;IACjC,IAAI,KAAK,GAAG,IAAI,CAAA;IAEhB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QAC/C,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;YACtD,cAAc,CAAC,MAAM,GAAG,CAAC,CAAA;YACzB,cAAc,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;QACjC,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,CAAC,YAAY,CAAC,CAAA;QACrB,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,KAAK,CAAA;QACf,CAAC;QACD,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAA;IAED,OAAO,EAAE,CAAA;IACT,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAE9D,OAAO,YAAa,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,KAAkB;IAC5C,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,GAAG,EAAE,CAAC,KAAK,CAAA;IACnD,MAAM,MAAM,GAAG,KAA4B,CAAA;IAE3C,IAAI,cAAc,GAAkB,EAAE,CAAA;IAEtC,IAAI,YAAY,GAAM,IAAK,CAAA;IAE3B,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QAC/C,gBAAgB,EAAE,CAAA;QAClB,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAA;IAED,MAAM,gBAAgB,GAAG,GAAG,EAAE;QAC5B,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;YACtD,cAAc,GAAG,OAAO,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO,EAAE,CAAA;IAET,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QACnE,OAAO,YAAY,CAAA;IACrB,CAAC,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/reactivity/register.d.ts

@@ -0,0 +1,7 @@
+import { Signal } from './signal';
+export declare class SignalRegister {
+    #private;
+    static watch<T>(fn: () => T, deps: (signals: Signal<any>[]) => void): T;
+    static register(signal: Signal<any>): void;
+}
+//# sourceMappingURL=register.d.ts.map

package/dist/reactivity/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/reactivity/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,qBAAa,cAAc;;IAGzB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI;IAQnE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;CAKpC"}

package/dist/reactivity/register.js

@@ -0,0 +1,18 @@
+import { Signal } from './signal';
+export class SignalRegister {
+    static #signals = [];
+    static watch(fn, deps) {
+        this.#signals.push(new Set());
+        const val = fn();
+        deps(Array.from(this.#signals.at(-1) ?? []));
+        this.#signals.pop();
+        return val;
+    }
+    static register(signal) {
+        const s = this.#signals.at(-1);
+        if (s == null)
+            return;
+        s.add(signal);
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/reactivity/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/reactivity/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,QAAQ,GAAuB,EAAE,CAAA;IAExC,MAAM,CAAC,KAAK,CAAI,EAAW,EAAE,IAAsC;QACjE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;QAC7B,MAAM,GAAG,GAAG,EAAE,EAAE,CAAA;QAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAA;QACnB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,MAAmB;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9B,IAAI,CAAC,IAAI,IAAI;YAAE,OAAM;QACrB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACf,CAAC"}

package/dist/reactivity/signal.d.ts

@@ -0,0 +1,126 @@
+import type { SignalGetter, SignalSetter } from './types';
+/**
+ * The **`Signal`** class is a reactive primitive that holds a value and notifies subscribers when it changes.
+ *
+ * @typeParam T The type of the value held by the signal.
+ *
+ * @example
+ * ```ts
+ * const health = new Signal(100)
+ *
+ * health.sub((value) => {
+ *   console.log('Health changed to:', value)
+ * })
+ *
+ * health.value = 50 // logs: "Health changed to: 50"
+ * ```
+ */
+export declare class Signal<T> {
+    #private;
+    /**
+     * Creates a new `Signal` with an initial value.
+     * Automatically creates bound `getter` and `setter` functions that integrate
+     * with the reactivity system (`SignalRegister`).
+     *
+     * @param initialValue The initial value of the signal.
+     */
+    constructor(initialValue: T);
+    /**
+     * Sets the signal value and notifies all subscribers.
+     * @example
+     * ```ts
+     * const score = new Signal(0)
+     * score.value = 10
+     * console.log(score.value) // 10
+     * ```
+     */
+    set value(val: T);
+    /**
+     * Gets the current signal value.
+     * @example
+     * ```ts
+     * const speed = new Signal(5)
+     * console.log(speed.value) // 5
+     * ```
+     */
+    get value(): T;
+    /**
+     * A bound getter function that returns the current value.
+     * Calling it as a function (`getter()`) automatically registers the signal
+     * as a dependency of the current `SignalRegister.watch` context.
+     * Calling `.value()` bypasses dependency tracking.
+     *
+     * @example
+     * ```ts
+     * const health = new Signal(100)
+     *
+     * // Call as function — tracks dependency
+     * const val = health.getter() // 100
+     *
+     * // Use .value() — no dependency tracking
+     * const val2 = health.getter.value() // 100
+     * ```
+     */
+    getter: SignalGetter<T>;
+    /**
+     * A bound setter function that updates the value and notifies subscribers.
+     * Equivalent to setting `signal.value = val`.
+     *
+     * @example
+     * ```ts
+     * const health = new Signal(100)
+     * health.setter(50) // equivalent to health.value = 50
+     * ```
+     */
+    setter: SignalSetter<T>;
+    /**
+     * The **`sub`** method subscribes a listener that is called whenever the signal value changes.
+     * @param fn The callback function to invoke when the value changes.
+     *
+     * @example
+     * ```ts
+     * const damage = new Signal(0)
+     *
+     * damage.sub((val) => {
+     *   console.log('Damage taken:', val)
+     * })
+     *
+     * damage.value = 25 // logs: "Damage taken: 25"
+     * ```
+     */
+    sub(fn: (value: T) => void): void;
+    /**
+     * The **`unsub`** method removes a previously subscribed listener.
+     * @param fn The callback function to remove.
+     *
+     * @example
+     * ```ts
+     * const mana = new Signal(100)
+     *
+     * const onManaChange = (val: number) => {
+     *   console.log('Mana:', val)
+     * }
+     *
+     * mana.sub(onManaChange)
+     * mana.unsub(onManaChange)
+     * ```
+     */
+    unsub(fn: (value: T) => void): void;
+    /**
+     * The **`clearSubs`** method removes all subscribers of this signal.
+     *
+     * @example
+     * ```ts
+     * const damage = new Signal(0)
+     * const log = (val: number) => console.log('Damage:', val)
+     *
+     * damage.sub(log)
+     * damage.value = 25 // logs: "Damage: 25"
+     *
+     * damage.clearSubs()
+     * damage.value = 50 // nothing logged — listener removed
+     * ```
+     */
+    clearSubs(): void;
+}
+//# sourceMappingURL=signal.d.ts.map

package/dist/reactivity/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/reactivity/signal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,MAAM,CAAC,CAAC;;IAInB;;;;;;OAMG;gBACS,YAAY,EAAE,CAAC;IAe3B;;;;;;;;OAQG;IACH,IAAI,KAAK,CAAC,GAAG,EAeA,CAAC,AAfD,EAKZ;IAED;;;;;;;OAOG;IACH,IAAI,KAAK,IAAI,CAAC,CAEb;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IACvB;;;;;;;;;OASG;IACH,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IAEvB;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI;IAI1B;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI;IAI5B;;;;;;;;;;;;;;OAcG;IACH,SAAS;CAGV"}

package/dist/reactivity/signal.js

@@ -0,0 +1,152 @@
+import { SignalRegister } from './register';
+/**
+ * The **`Signal`** class is a reactive primitive that holds a value and notifies subscribers when it changes.
+ *
+ * @typeParam T The type of the value held by the signal.
+ *
+ * @example
+ * ```ts
+ * const health = new Signal(100)
+ *
+ * health.sub((value) => {
+ *   console.log('Health changed to:', value)
+ * })
+ *
+ * health.value = 50 // logs: "Health changed to: 50"
+ * ```
+ */
+export class Signal {
+    #value;
+    #listeners = new Set();
+    /**
+     * Creates a new `Signal` with an initial value.
+     * Automatically creates bound `getter` and `setter` functions that integrate
+     * with the reactivity system (`SignalRegister`).
+     *
+     * @param initialValue The initial value of the signal.
+     */
+    constructor(initialValue) {
+        this.#value = initialValue;
+        // setter & getter
+        this.getter = (() => {
+            SignalRegister.register(this);
+            return this.value;
+        });
+        this.getter.value = () => this.value;
+        this.setter = ((value) => {
+            this.value = value;
+        });
+    }
+    /**
+     * Sets the signal value and notifies all subscribers.
+     * @example
+     * ```ts
+     * const score = new Signal(0)
+     * score.value = 10
+     * console.log(score.value) // 10
+     * ```
+     */
+    set value(val) {
+        if (val === this.#value)
+            return;
+        this.#value = val;
+        const currentListeners = Array.from(this.#listeners);
+        currentListeners.forEach((fn) => fn(val));
+    }
+    /**
+     * Gets the current signal value.
+     * @example
+     * ```ts
+     * const speed = new Signal(5)
+     * console.log(speed.value) // 5
+     * ```
+     */
+    get value() {
+        return this.#value;
+    }
+    /**
+     * A bound getter function that returns the current value.
+     * Calling it as a function (`getter()`) automatically registers the signal
+     * as a dependency of the current `SignalRegister.watch` context.
+     * Calling `.value()` bypasses dependency tracking.
+     *
+     * @example
+     * ```ts
+     * const health = new Signal(100)
+     *
+     * // Call as function — tracks dependency
+     * const val = health.getter() // 100
+     *
+     * // Use .value() — no dependency tracking
+     * const val2 = health.getter.value() // 100
+     * ```
+     */
+    getter;
+    /**
+     * A bound setter function that updates the value and notifies subscribers.
+     * Equivalent to setting `signal.value = val`.
+     *
+     * @example
+     * ```ts
+     * const health = new Signal(100)
+     * health.setter(50) // equivalent to health.value = 50
+     * ```
+     */
+    setter;
+    /**
+     * The **`sub`** method subscribes a listener that is called whenever the signal value changes.
+     * @param fn The callback function to invoke when the value changes.
+     *
+     * @example
+     * ```ts
+     * const damage = new Signal(0)
+     *
+     * damage.sub((val) => {
+     *   console.log('Damage taken:', val)
+     * })
+     *
+     * damage.value = 25 // logs: "Damage taken: 25"
+     * ```
+     */
+    sub(fn) {
+        this.#listeners.add(fn);
+    }
+    /**
+     * The **`unsub`** method removes a previously subscribed listener.
+     * @param fn The callback function to remove.
+     *
+     * @example
+     * ```ts
+     * const mana = new Signal(100)
+     *
+     * const onManaChange = (val: number) => {
+     *   console.log('Mana:', val)
+     * }
+     *
+     * mana.sub(onManaChange)
+     * mana.unsub(onManaChange)
+     * ```
+     */
+    unsub(fn) {
+        this.#listeners.delete(fn);
+    }
+    /**
+     * The **`clearSubs`** method removes all subscribers of this signal.
+     *
+     * @example
+     * ```ts
+     * const damage = new Signal(0)
+     * const log = (val: number) => console.log('Damage:', val)
+     *
+     * damage.sub(log)
+     * damage.value = 25 // logs: "Damage: 25"
+     *
+     * damage.clearSubs()
+     * damage.value = 50 // nothing logged — listener removed
+     * ```
+     */
+    clearSubs() {
+        this.#listeners.clear();
+    }
+}
+//# sourceMappingURL=signal.js.map

package/dist/reactivity/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/reactivity/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,MAAM;IACjB,MAAM,CAAG;IACT,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAA;IAE1C;;;;;;OAMG;IACH,YAAY,YAAe;QACzB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAA;QAE1B,kBAAkB;QAClB,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE;YAClB,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC7B,OAAO,IAAI,CAAC,KAAK,CAAA;QACnB,CAAC,CAAoB,CAAA;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAA;QAEpC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,CAAC,CAAoB,CAAA;IACvB,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK,CAAC,GAAG;QACX,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM;YAAE,OAAM;QAC/B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAA;QACjB,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACpD,gBAAgB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAiB;IACvB;;;;;;;;;OASG;IACH,MAAM,CAAiB;IAEvB;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,EAAsB;QACxB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,EAAsB;QAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,SAAS;QACP,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACzB,CAAC;CACF"}