flint-reactivity 4.0.0

package/dist/debug.js

@@ -0,0 +1,257 @@
+// Flint Reactivity v2 — Debug Mode & Signal Tracking
+// Enhanced debugging capabilities for signals and computed values
+// ─── Debug Manager ──────────────────────────────────────────────
+let debugManager = null;
+export class DebugManager {
+    options;
+    signalRegistry = new Map();
+    computedRegistry = new Map();
+    effectRegistry = new Map();
+    idCounter = 0;
+    enabled = false;
+    constructor(options = {}) {
+        this.options = {
+            enabled: false,
+            logChanges: true,
+            logComputed: true,
+            logEffects: true,
+            logBatch: true,
+            maxHistory: 100,
+            trackPerformance: true,
+            ...options,
+        };
+        this.enabled = this.options.enabled;
+    }
+    /**
+     * Enable debug mode
+     */
+    enable() {
+        this.enabled = true;
+        this.options.enabled = true;
+        console.log('[Flint Debug] Debug mode enabled');
+    }
+    /**
+     * Disable debug mode
+     */
+    disable() {
+        this.enabled = false;
+        this.options.enabled = false;
+        console.log('[Flint Debug] Debug mode disabled');
+    }
+    /**
+     * Track a signal
+     */
+    trackSignal(name, signal) {
+        if (!this.enabled)
+            return signal;
+        const id = `signal_${this.idCounter++}`;
+        const debugInfo = {
+            id,
+            name,
+            value: signal(),
+            previousValue: undefined,
+            changeCount: 0,
+            lastChange: Date.now(),
+            history: [],
+            subscribers: [],
+            computedFrom: [],
+        };
+        this.signalRegistry.set(id, debugInfo);
+        // Wrap signal with tracking - create a proper Signal wrapper
+        const tracked = (() => {
+            // Read
+            return signal();
+        });
+        // Copy the set method with tracking
+        tracked.set = (value) => {
+            const oldValue = signal();
+            signal.set(value);
+            const newValue = signal();
+            debugInfo.previousValue = oldValue;
+            debugInfo.value = newValue;
+            debugInfo.changeCount++;
+            debugInfo.lastChange = Date.now();
+            debugInfo.history.push({
+                value: newValue,
+                timestamp: Date.now(),
+            });
+            // Trim history
+            if (debugInfo.history.length > this.options.maxHistory) {
+                debugInfo.history.shift();
+            }
+            if (this.options.logChanges) {
+                console.log(`[Flint Debug] Signal "${name}" changed:`, oldValue, '->', newValue);
+            }
+        };
+        // Copy the peek method
+        tracked.peek = () => signal.peek();
+        return tracked;
+    }
+    /**
+     * Track a computed value
+     */
+    trackComputed(name, computed$) {
+        if (!this.enabled)
+            return computed$;
+        const id = `computed_${this.idCounter++}`;
+        const debugInfo = {
+            id,
+            name,
+            value: computed$(),
+            recalculationCount: 0,
+            lastRecalculation: Date.now(),
+            dependencies: [],
+            isDirty: false,
+            computationTime: 0,
+        };
+        this.computedRegistry.set(id, debugInfo);
+        // Wrap computed with tracking
+        const original = computed$;
+        const tracked = (() => {
+            const startTime = performance.now();
+            const value = original();
+            const endTime = performance.now();
+            debugInfo.value = value;
+            debugInfo.recalculationCount++;
+            debugInfo.lastRecalculation = Date.now();
+            debugInfo.computationTime = endTime - startTime;
+            if (this.options.logComputed) {
+                console.log(`[Flint Debug] Computed "${name}" recalculated:`, value, `(${(endTime - startTime).toFixed(2)}ms)`);
+            }
+            return value;
+        });
+        return tracked;
+    }
+    /**
+     * Get debug info for a signal
+     */
+    getSignalDebugInfo(id) {
+        return this.signalRegistry.get(id);
+    }
+    /**
+     * Get debug info for a computed
+     */
+    getComputedDebugInfo(id) {
+        return this.computedRegistry.get(id);
+    }
+    /**
+     * Get all tracked signals
+     */
+    getAllSignals() {
+        return Array.from(this.signalRegistry.values());
+    }
+    /**
+     * Get all tracked computed values
+     */
+    getAllComputed() {
+        return Array.from(this.computedRegistry.values());
+    }
+    /**
+     * Clear all tracking data
+     */
+    clear() {
+        this.signalRegistry.clear();
+        this.computedRegistry.clear();
+        this.effectRegistry.clear();
+        this.idCounter = 0;
+    }
+    /**
+     * Get performance summary
+     */
+    getPerformanceSummary() {
+        const signals = this.getAllSignals();
+        const computed = this.getAllComputed();
+        const avgTime = computed.length > 0
+            ? computed.reduce((sum, c) => sum + c.computationTime, 0) / computed.length
+            : 0;
+        return {
+            totalSignals: signals.length,
+            totalComputed: computed.length,
+            totalEffects: this.effectRegistry.size,
+            averageComputationTime: avgTime,
+        };
+    }
+}
+// ─── Singleton Functions ────────────────────────────────────────
+export function createDebugManager(options) {
+    if (!debugManager) {
+        debugManager = new DebugManager(options);
+    }
+    return debugManager;
+}
+export function getDebugManager() {
+    return debugManager;
+}
+export function enableDebug() {
+    if (!debugManager) {
+        debugManager = new DebugManager({ enabled: true });
+    }
+    else {
+        debugManager.enable();
+    }
+    return debugManager;
+}
+export function disableDebug() {
+    debugManager?.disable();
+}
+/**
+ * Track a signal in debug mode
+ */
+export function trackSignal(name, signal) {
+    if (!debugManager) {
+        debugManager = new DebugManager({ enabled: true });
+    }
+    return debugManager.trackSignal(name, signal);
+}
+/**
+ * Track a computed in debug mode
+ */
+export function trackComputed(name, computed$) {
+    if (!debugManager) {
+        debugManager = new DebugManager({ enabled: true });
+    }
+    return debugManager.trackComputed(name, computed$);
+}
+/**
+ * Print signal history
+ */
+export function printSignalHistory(signalId) {
+    const info = debugManager?.getSignalDebugInfo(signalId);
+    if (!info) {
+        console.log('[Flint Debug] Signal not found:', signalId);
+        return;
+    }
+    console.log(`[Flint Debug] Signal "${info.name}" history:`);
+    console.table(info.history);
+}
+/**
+ * Print computed stats
+ */
+export function printComputedStats(computedId) {
+    const info = debugManager?.getComputedDebugInfo(computedId);
+    if (!info) {
+        console.log('[Flint Debug] Computed not found:', computedId);
+        return;
+    }
+    console.log(`[Flint Debug] Computed "${info.name}" stats:`);
+    console.log('  Value:', info.value);
+    console.log('  Recalculations:', info.recalculationCount);
+    console.log('  Last Recalculation:', new Date(info.lastRecalculation).toISOString());
+    console.log('  Computation Time:', info.computationTime.toFixed(2), 'ms');
+}
+/**
+ * Print performance summary
+ */
+export function printPerformanceSummary() {
+    if (!debugManager) {
+        console.log('[Flint Debug] Debug manager not initialized');
+        return;
+    }
+    const summary = debugManager.getPerformanceSummary();
+    console.log('[Flint Debug] Performance Summary:');
+    console.log('  Total Signals:', summary.totalSignals);
+    console.log('  Total Computed:', summary.totalComputed);
+    console.log('  Total Effects:', summary.totalEffects);
+    console.log('  Average Computation Time:', summary.averageComputationTime.toFixed(2), 'ms');
+}
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { state, computed, effect, watch, flushSync, untrack, captureScope, createSelector, createRoot, onCleanup, reactive, model, bind, createRef, shallowRef, derive, signals, poll, watchDebounced, watchThrottled, computedSet, } from './signals.js';
+export type { Signal, Computed, Effect, CleanupFn, Selector, Scope, ReactiveProxy, Ref, Writable, Readable, WatchHandle, } from './types.js';
+export { DebugManager, createDebugManager, getDebugManager, enableDebug, disableDebug, trackSignal, trackComputed, printSignalHistory, printComputedStats, printPerformanceSummary, } from './debug.js';
+export type { DebugOptions, SignalDebugInfo, ComputedDebugInfo, EffectDebugInfo, SignalHistoryEntry, } from './debug.js';
+export type { InferSignal, InferComputed, InferWritable, InferReadable, ComponentProps, ComponentReturn, PartialExcept, RequiredExcept, InferFormValues, InferFormErrors, Validator, Validators, InferStoreState, InferStoreActions, Nullable, Optional, Maybe, DeepReadonly, DeepMutable, FunctionKeys, NonFunctionKeys, PickFunctions, PickState, MethodParams, MethodReturns, EventHandler, EventHandlers, UnwrapPromise, Async, Await, ArrayElement, Tuple, TupleOf, CamelCase, KebabCase, If, And, Or, Not, Equals, IsNever, IsAny, IsUnknown, } from './types-helpers.js';
+export { createSignal, createEffect, createMemo, createStore, batch, createResource, from, produce, } from './compat.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,OAAO,EACP,YAAY,EACZ,cAAc,EACd,UAAU,EACV,SAAS,EAET,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,SAAS,EACT,UAAU,EACV,MAAM,EACN,OAAO,EACP,IAAI,EACJ,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,MAAM,EACN,QAAQ,EACR,MAAM,EACN,SAAS,EACT,QAAQ,EACR,KAAK,EACL,aAAa,EACb,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,KAAK,EACL,KAAK,EACL,YAAY,EACZ,KAAK,EACL,OAAO,EACP,SAAS,EACT,SAAS,EACT,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,MAAM,EACN,OAAO,EACP,KAAK,EACL,SAAS,GACV,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,EACL,cAAc,EACd,IAAI,EACJ,OAAO,GACR,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Flint Reactivity — Fine-grained signals system v4
+export { state, computed, effect, watch, flushSync, untrack, captureScope, createSelector, createRoot, onCleanup, 
+// NEW v4 simplified APIs
+reactive, model, bind, createRef, shallowRef, derive, signals, poll, watchDebounced, watchThrottled, computedSet, } from './signals.js';
+// Debug mode v2
+export { DebugManager, createDebugManager, getDebugManager, enableDebug, disableDebug, trackSignal, trackComputed, printSignalHistory, printComputedStats, printPerformanceSummary, } from './debug.js';
+// Solid/React Compatibility Aliases (v4.2)
+export { createSignal, createEffect, createMemo, createStore, batch, createResource, from, produce, } from './compat.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,OAAO,EACP,YAAY,EACZ,cAAc,EACd,UAAU,EACV,SAAS;AACT,yBAAyB;AACzB,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,SAAS,EACT,UAAU,EACV,MAAM,EACN,OAAO,EACP,IAAI,EACJ,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAA;AAerB,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAwDnB,2CAA2C;AAC3C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,EACL,cAAc,EACd,IAAI,EACJ,OAAO,GACR,MAAM,aAAa,CAAA"}

package/dist/signals.d.ts

@@ -0,0 +1,163 @@
+import type { Signal, Computed, Effect, Readable, Writable, WatchHandle, SignalState, ComputedState, CleanupFn, Selector, Scope, ReactiveProxy, Ref } from './types.js';
+/**
+ * Create a reactive state signal.
+ *
+ * @example
+ * const count = state(0)
+ * count()      // read: 0
+ * count.set(5) // write: 5
+ * count.set(c => c + 1) // write: 6
+ */
+export declare function state<T>(initial: T): Writable<T> & Signal<T>;
+/**
+ * Create a computed (derived) value.
+ * Lazily evaluated and cached. Only recomputes when dependencies change.
+ */
+export declare function computed<T>(fn: () => T, options?: {
+    equals?: (prev: T, next: T) => boolean;
+}): Computed<T>;
+/**
+ * Create a writable computed value.
+ * Like computed, but can be set directly.
+ *
+ * @example
+ * const count = state(0)
+ * const doubled = computedSet({
+ *   get: () => count() * 2,
+ *   set: (value) => count.set(value / 2)
+ * })
+ *
+ * doubled()      // read: 0
+ * doubled.set(10) // write: sets count to 5
+ */
+export declare function computedSet<T>(options: {
+    get: () => T;
+    set: (value: T) => void;
+    equals?: (prev: T, next: T) => boolean;
+}): Writable<T> & Computed<T>;
+/**
+ * Create a side effect that auto-tracks dependencies.
+ */
+export declare function effect(fn: () => void | CleanupFn): Effect;
+/**
+ * Watch a source function and call callback when value changes.
+ */
+export declare function watch<T>(source: () => T, callback: (value: T, oldValue: T | undefined) => void): WatchHandle;
+/**
+ * Batch multiple signal updates into a single flush.
+ */
+export declare function batch(fn: () => void): void;
+/**
+ * Run queued effects/computeds immediately.
+ */
+export declare function flushSync(): void;
+export declare function captureScope<T>(fn: () => T): {
+    value: T;
+    dependencies: Set<SignalState<any> | ComputedState<any>>;
+};
+export declare function untrack<T>(fn: () => T): T;
+export declare function createRoot<T>(fn: (dispose: () => void) => T): T & Scope;
+export declare function onCleanup(fn: CleanupFn): void;
+export declare function createSelector<T>(source: Signal<T> | Readable<T> | (() => T)): Selector<T>;
+export { onCleanup as onDispose };
+/**
+ * Create a reactive object with Proxy. Reads auto-track, writes auto-trigger.
+ *
+ * @example
+ * const user = reactive({ name: 'John', age: 30 })
+ * user.name  // tracked
+ * user.age = 31  // triggers effects
+ */
+export declare function reactive<T extends object>(obj: T): ReactiveProxy<T>;
+/**
+ * Create a model — a reactive container with actions.
+ * Combines state + computed + actions in one clean API.
+ *
+ * @example
+ * const counter = model({
+ *   state: { count: 0, step: 1 },
+ *   computed: {
+ *     doubled: (s) => s.count * 2,
+ *     isPositive: (s) => s.count > 0,
+ *   },
+ *   actions: {
+ *     increment(s) { s.count += s.step },
+ *     decrement(s) { s.count -= s.step },
+ *     reset(s) { s.count = 0 },
+ *   },
+ * })
+ *
+ * counter.count()       // 0
+ * counter.doubled()     // 0
+ * counter.increment()   // s.count = 1
+ */
+export declare function model<T extends Record<string, any>, C extends Record<string, (state: T) => any>, A extends Record<string, (state: T, ...args: any[]) => void>>(config: {
+    state: T;
+    computed?: C;
+    actions?: A;
+}): {
+    [K in keyof T]: T[K] extends object ? Writable<T[K]> : Signal<T[K]>;
+} & {
+    [K in keyof C]: C[K] extends (s: T) => infer R ? Readable<R> : never;
+} & {
+    [K in keyof A]: A[K] extends (s: T, ...args: infer P) => void ? (...args: P) => void : never;
+};
+/**
+ * Create a two-way binding between a signal and a DOM element property.
+ * Simplifies form handling dramatically.
+ *
+ * @example
+ * const name = state('')
+ * <input {...bind(name, 'value')} onInput={(e) => name.set(e.target.value)} />
+ */
+export declare function bind<T>(signal: Writable<T>, prop: string): Record<string, () => T>;
+/**
+ * Create a mutable ref (like React's useRef).
+ */
+export declare function createRef<T>(initial: T): Ref<T>;
+/**
+ * Create a shallow ref — only triggers on reference change, not deep mutation.
+ */
+export declare function shallowRef<T>(value: T): Writable<T> & {
+    readonly current: T;
+};
+/**
+ * Group multiple signals into a single derived signal.
+ *
+ * @example
+ * const [doubled, tripled] = derive(
+ *   [count],
+ *   (c) => [c * 2, c * 3]
+ * )
+ */
+export declare function derive<T extends Readable<any>[], R>(sources: T, fn: (...values: {
+    [K in keyof T]: T[K] extends Readable<infer V> ? V : never;
+}) => R): Readable<R>;
+/**
+ * Batch create multiple signals from an object.
+ *
+ * @example
+ * const [count, name, items] = signals(0, 'hello', [])
+ */
+export declare function signals<T extends any[]>(...initials: T): {
+    [K in keyof T]: Signal<T[K]>;
+};
+/**
+ * Create an effect that runs on a specific interval.
+ *
+ * @example
+ * poll(() => fetchData(), 5000) // poll every 5 seconds
+ */
+export declare function poll(fn: () => void | CleanupFn, ms: number): Effect;
+/**
+ * Create an effect that runs when a signal changes (debounced).
+ *
+ * @example
+ * watchDebounced(searchQuery, (q) => fetchResults(q), 300)
+ */
+export declare function watchDebounced<T>(source: () => T, callback: (value: T, oldValue: T | undefined) => void, ms: number): WatchHandle;
+/**
+ * Create an effect that runs when a signal changes (throttled).
+ */
+export declare function watchThrottled<T>(source: () => T, callback: (value: T, oldValue: T | undefined) => void, ms: number): WatchHandle;
+//# sourceMappingURL=signals.d.ts.map

package/dist/signals.d.ts.map

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