flint-reactivity 4.0.0

package/README.md

@@ -0,0 +1,107 @@
+# @flint/reactivity
+
+> Fine-grained signals system for Flint — the fastest reactive primitives
+
+## Install
+
+```bash
+npm install @flint/reactivity
+```
+
+## Quick Start
+
+```typescript
+import { state, computed, effect } from '@flint/reactivity'
+
+const count = state(0)
+const doubled = computed(() => count() * 2)
+
+effect(() => {
+  console.log(`Count: ${count()}, Doubled: ${doubled()}`)
+})
+
+count.set(5) // Logs: Count: 5, Doubled: 10
+```
+
+## API
+
+### `state(initial)`
+
+Create a reactive signal.
+
+```typescript
+const count = state(0)
+count()       // read: 0
+count.set(5)  // write: 5
+count.set(c => c + 1)  // write: 6
+count.peek()  // read without tracking
+```
+
+### `computed(fn)`
+
+Create a derived value (lazy, cached).
+
+```typescript
+const doubled = computed(() => count() * 2)
+doubled() // recomputes only when count() changes
+```
+
+### `computedSet({ get, set })`
+
+Create a writable computed value.
+
+```typescript
+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
+```
+
+### `effect(fn)`
+
+Run side effects when dependencies change.
+
+```typescript
+effect(() => {
+  console.log(count())
+})
+```
+
+### `batch(fn)`
+
+Group multiple updates into one.
+
+```typescript
+batch(() => {
+  count.set(1)
+  name.set('hello')
+}) // Only one re-render
+```
+
+### `reactive(obj)`
+
+Proxy-based reactivity (like Vue).
+
+```typescript
+const user = reactive({ name: 'John', age: 30 })
+user.age++ // triggers updates
+```
+
+### `model(config)`
+
+State + computed + actions in one object.
+
+```typescript
+const counter = model({
+  state: { count: 0 },
+  computed: { doubled: (s) => s.count * 2 },
+  actions: { increment(s) { s.count++ } }
+})
+```
+
+## License
+
+MIT

package/dist/compat.d.ts

@@ -0,0 +1,120 @@
+import { batch, createRoot } from './signals.js';
+/**
+ * Create a reactive signal (Solid.js-compatible alias for `state()`).
+ *
+ * @example
+ * // Solid style:
+ * const [count, setCount] = createSignal(0)
+ * count()  // read
+ * setCount(1)  // set
+ * setCount(prev => prev + 1)  // update from previous
+ *
+ * // Flint style (equivalent):
+ * const count = state(0)
+ * count()  // read
+ * count.set(1)  // set
+ */
+export declare function createSignal<T>(initialValue: T): [() => T, (value: T | ((prev: T) => T)) => void];
+/**
+ * Create a side effect (Solid.js-compatible alias for `effect()`).
+ *
+ * @example
+ * createEffect(() => {
+ *   console.log('Count changed:', count())
+ * })
+ */
+export declare function createEffect(fn: () => void): void;
+/**
+ * Create a memoized derived value (Solid.js-compatible alias for `computed()`).
+ *
+ * @example
+ * const doubled = createMemo(() => count() * 2)
+ */
+export declare function createMemo<T>(fn: () => T): () => T;
+/**
+ * Create a reactive store (Solid.js-compatible).
+ *
+ * @example
+ * const [store, setStore] = createStore({
+ *   user: { name: 'John', age: 30 },
+ *   todos: []
+ * })
+ *
+ * // Read
+ * store.user.name  // 'John'
+ *
+ * // Shallow set (replaces property)
+ * setStore('user', 'name', 'Jane')
+ *
+ * // Functional update
+ * setStore('todos', todos => [...todos, { text: 'New', done: false }])
+ */
+export declare function createStore<T extends Record<string, any>>(initialValue: T): [T, (path: string, value: any) => void];
+/**
+ * Create a reactive root (Solid.js-compatible alias for `createRoot()`).
+ *
+ * @example
+ * createRoot((dispose) => {
+ *   effect(() => console.log(count()))
+ *   // cleanup when disposed
+ *   return () => cleanup()
+ * })
+ */
+export { createRoot };
+/**
+ * Batch multiple updates into a single re-render (Solid.js-compatible).
+ *
+ * @example
+ * batch(() => {
+ *   setCount(1)
+ *   setName('John')
+ *   // Only one re-render happens
+ * })
+ */
+export { batch };
+/**
+ * Create an async resource (Solid.js-compatible).
+ *
+ * @example
+ * const [data, { mutate, refetch }] = createResource(
+ *   () => userId(),
+ *   async (id) => {
+ *     const res = await fetch(`/api/users/${id}`)
+ *     return res.json()
+ *   }
+ * )
+ *
+ * // In JSX:
+ * <Suspense fallback={<Loading />}>
+ *   <div>{data()?.name}</div>
+ * </Suspense>
+ */
+export declare function createResource<T, S = void>(source: (() => S) | S, fetcher: (source: S) => Promise<T>): [
+    () => T | undefined,
+    {
+        mutate: (fn: T | ((prev: T | undefined) => T)) => void;
+        refetch: () => void;
+        state: () => 'unresolved' | 'pending' | 'ready' | 'error' | 'refreshing';
+        error: () => any | undefined;
+    }
+];
+/**
+ * Create a reactive value from a non-reactive source.
+ *
+ * @example
+ * const mouseX = from(document, 'mousemove', (e) => e.clientX)
+ */
+export declare function from<T>(source: EventTarget | {
+    subscribe: (fn: (value: T) => void) => () => void;
+}, eventOrSelector: string | ((event: any) => T)): () => T | undefined;
+/**
+ * Create an immutable update helper.
+ *
+ * @example
+ * produce(store, draft => {
+ *   draft.user.name = 'Jane'
+ *   draft.todos.push({ text: 'New', done: false })
+ * })
+ */
+export declare function produce<T>(store: T, recipe: (draft: T) => void): void;
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../src/compat.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,EACL,UAAU,EAEX,MAAM,cAAc,CAAA;AAIrB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,YAAY,EAAE,CAAC,GACd,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAWlD;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,IAAI,GACb,IAAI,CAEN;AAID;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,EAAE,EAAE,MAAM,CAAC,GACV,MAAM,CAAC,CAET;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvD,YAAY,EAAE,CAAC,GACd,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,CAgBzC;AAID;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,CAAA;AAQrB;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,EAAE,CAAA;AAIhB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EACxC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EACrB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACjC;IACD,MAAM,CAAC,GAAG,SAAS;IACnB;QACE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC,KAAK,IAAI,CAAA;QACtD,OAAO,EAAE,MAAM,IAAI,CAAA;QACnB,KAAK,EAAE,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAA;QACxE,KAAK,EAAE,MAAM,GAAG,GAAG,SAAS,CAAA;KAC7B;CACF,CAqDA;AAID;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,EACpB,MAAM,EAAE,WAAW,GAAG;IAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAAE,EAC3E,eAAe,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,GAC5C,MAAM,CAAC,GAAG,SAAS,CAgBrB;AAID;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAKrE"}

package/dist/compat.js

@@ -0,0 +1,229 @@
+// Flint Reactivity — Solid/React-compatible Aliases
+// For developers coming from React/Solid.js backgrounds
+import { state, computed, effect, batch, createRoot, reactive, } from './signals.js';
+// ─── createSignal ───────────────────────────────────────────────
+/**
+ * Create a reactive signal (Solid.js-compatible alias for `state()`).
+ *
+ * @example
+ * // Solid style:
+ * const [count, setCount] = createSignal(0)
+ * count()  // read
+ * setCount(1)  // set
+ * setCount(prev => prev + 1)  // update from previous
+ *
+ * // Flint style (equivalent):
+ * const count = state(0)
+ * count()  // read
+ * count.set(1)  // set
+ */
+export function createSignal(initialValue) {
+    const s = state(initialValue);
+    const getter = () => s();
+    const setter = (value) => {
+        if (typeof value === 'function') {
+            s.set(value(s()));
+        }
+        else {
+            s.set(value);
+        }
+    };
+    return [getter, setter];
+}
+// ─── createEffect ───────────────────────────────────────────────
+/**
+ * Create a side effect (Solid.js-compatible alias for `effect()`).
+ *
+ * @example
+ * createEffect(() => {
+ *   console.log('Count changed:', count())
+ * })
+ */
+export function createEffect(fn) {
+    effect(fn);
+}
+// ─── createMemo ─────────────────────────────────────────────────
+/**
+ * Create a memoized derived value (Solid.js-compatible alias for `computed()`).
+ *
+ * @example
+ * const doubled = createMemo(() => count() * 2)
+ */
+export function createMemo(fn) {
+    return computed(fn);
+}
+// ─── createStore ────────────────────────────────────────────────
+/**
+ * Create a reactive store (Solid.js-compatible).
+ *
+ * @example
+ * const [store, setStore] = createStore({
+ *   user: { name: 'John', age: 30 },
+ *   todos: []
+ * })
+ *
+ * // Read
+ * store.user.name  // 'John'
+ *
+ * // Shallow set (replaces property)
+ * setStore('user', 'name', 'Jane')
+ *
+ * // Functional update
+ * setStore('todos', todos => [...todos, { text: 'New', done: false }])
+ */
+export function createStore(initialValue) {
+    const store = reactive(initialValue);
+    const setStore = (path, value) => {
+        const keys = path.split('.');
+        let current = store;
+        for (let i = 0; i < keys.length - 1; i++) {
+            current = current[keys[i]];
+        }
+        const lastKey = keys[keys.length - 1];
+        if (typeof value === 'function') {
+            current[lastKey] = value(current[lastKey]);
+        }
+        else {
+            current[lastKey] = value;
+        }
+    };
+    return [store, setStore];
+}
+// ─── createRoot (Solid-compatible) ──────────────────────────────
+/**
+ * Create a reactive root (Solid.js-compatible alias for `createRoot()`).
+ *
+ * @example
+ * createRoot((dispose) => {
+ *   effect(() => console.log(count()))
+ *   // cleanup when disposed
+ *   return () => cleanup()
+ * })
+ */
+export { createRoot };
+// ─── createSelector ─────────────────────────────────────────────
+// Note: createSelector is already exported from signals.ts with the full API
+// (setSelected, getSelected, dispose). We re-export it here for compatibility.
+// ─── batch (Solid-compatible) ───────────────────────────────────
+/**
+ * Batch multiple updates into a single re-render (Solid.js-compatible).
+ *
+ * @example
+ * batch(() => {
+ *   setCount(1)
+ *   setName('John')
+ *   // Only one re-render happens
+ * })
+ */
+export { batch };
+// ─── createResource ─────────────────────────────────────────────
+/**
+ * Create an async resource (Solid.js-compatible).
+ *
+ * @example
+ * const [data, { mutate, refetch }] = createResource(
+ *   () => userId(),
+ *   async (id) => {
+ *     const res = await fetch(`/api/users/${id}`)
+ *     return res.json()
+ *   }
+ * )
+ *
+ * // In JSX:
+ * <Suspense fallback={<Loading />}>
+ *   <div>{data()?.name}</div>
+ * </Suspense>
+ */
+export function createResource(source, fetcher) {
+    const dataSignal = state(undefined);
+    const errorSignal = state(undefined);
+    const stateSignal = state('unresolved');
+    let fetchCount = 0;
+    const refetch = () => {
+        fetchCount++;
+        const currentFetch = fetchCount;
+        const src = typeof source === 'function' ? source() : source;
+        stateSignal.set('pending');
+        fetcher(src)
+            .then((result) => {
+            if (currentFetch === fetchCount) {
+                dataSignal.set(result);
+                stateSignal.set('ready');
+            }
+        })
+            .catch((err) => {
+            if (currentFetch === fetchCount) {
+                errorSignal.set(err);
+                stateSignal.set('error');
+            }
+        });
+    };
+    // Start fetching immediately if source is available
+    if (typeof source === 'function') {
+        effect(() => {
+            const src = source();
+            if (src !== undefined && src !== null) {
+                refetch();
+            }
+        });
+    }
+    else {
+        refetch();
+    }
+    return [
+        () => dataSignal(),
+        {
+            mutate: (fn) => {
+                if (typeof fn === 'function') {
+                    dataSignal.set(fn);
+                }
+                else {
+                    dataSignal.set(fn);
+                }
+            },
+            refetch,
+            state: () => stateSignal(),
+            error: () => errorSignal(),
+        },
+    ];
+}
+// ─── from (reactive from) ───────────────────────────────────────
+/**
+ * Create a reactive value from a non-reactive source.
+ *
+ * @example
+ * const mouseX = from(document, 'mousemove', (e) => e.clientX)
+ */
+export function from(source, eventOrSelector) {
+    const signal = state(undefined);
+    if ('addEventListener' in source) {
+        const eventName = eventOrSelector;
+        const selector = typeof eventOrSelector === 'function' ? eventOrSelector : (e) => e;
+        source.addEventListener(eventName, (e) => {
+            signal.set(selector(e));
+        });
+    }
+    else {
+        source.subscribe((value) => {
+            signal.set(value);
+        });
+    }
+    return () => signal();
+}
+// ─── produce (immutable helper) ─────────────────────────────────
+/**
+ * Create an immutable update helper.
+ *
+ * @example
+ * produce(store, draft => {
+ *   draft.user.name = 'Jane'
+ *   draft.todos.push({ text: 'New', done: false })
+ * })
+ */
+export function produce(store, recipe) {
+    // Simple immutable update pattern
+    if (typeof store === 'object' && store !== null) {
+        recipe(store);
+    }
+}
+//# sourceMappingURL=compat.js.map

package/dist/compat.js.map

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

package/dist/debug.d.ts

@@ -0,0 +1,130 @@
+import type { Signal, Computed } from './types.js';
+export interface DebugOptions {
+    /** Enable debug mode */
+    enabled: boolean;
+    /** Log signal changes */
+    logChanges: boolean;
+    /** Log computed recalculations */
+    logComputed: boolean;
+    /** Log effect executions */
+    logEffects: boolean;
+    /** Log batch operations */
+    logBatch: boolean;
+    /** Maximum history entries per signal */
+    maxHistory: number;
+    /** Enable performance tracking */
+    trackPerformance: boolean;
+}
+export interface SignalDebugInfo {
+    id: string;
+    name: string;
+    value: any;
+    previousValue: any;
+    changeCount: number;
+    lastChange: number;
+    history: SignalHistoryEntry[];
+    subscribers: string[];
+    computedFrom: string[];
+}
+export interface SignalHistoryEntry {
+    value: any;
+    timestamp: number;
+    stackTrace?: string;
+}
+export interface ComputedDebugInfo {
+    id: string;
+    name: string;
+    value: any;
+    recalculationCount: number;
+    lastRecalculation: number;
+    dependencies: string[];
+    isDirty: boolean;
+    computationTime: number;
+}
+export interface EffectDebugInfo {
+    id: string;
+    name: string;
+    executionCount: number;
+    lastExecution: number;
+    dependencies: string[];
+    executionTime: number;
+}
+export declare class DebugManager {
+    private options;
+    private signalRegistry;
+    private computedRegistry;
+    private effectRegistry;
+    private idCounter;
+    private enabled;
+    constructor(options?: Partial<DebugOptions>);
+    /**
+     * Enable debug mode
+     */
+    enable(): void;
+    /**
+     * Disable debug mode
+     */
+    disable(): void;
+    /**
+     * Track a signal
+     */
+    trackSignal<T>(name: string, signal: Signal<T>): Signal<T>;
+    /**
+     * Track a computed value
+     */
+    trackComputed<T>(name: string, computed$: Computed<T>): Computed<T>;
+    /**
+     * Get debug info for a signal
+     */
+    getSignalDebugInfo(id: string): SignalDebugInfo | undefined;
+    /**
+     * Get debug info for a computed
+     */
+    getComputedDebugInfo(id: string): ComputedDebugInfo | undefined;
+    /**
+     * Get all tracked signals
+     */
+    getAllSignals(): SignalDebugInfo[];
+    /**
+     * Get all tracked computed values
+     */
+    getAllComputed(): ComputedDebugInfo[];
+    /**
+     * Clear all tracking data
+     */
+    clear(): void;
+    /**
+     * Get performance summary
+     */
+    getPerformanceSummary(): {
+        totalSignals: number;
+        totalComputed: number;
+        totalEffects: number;
+        averageComputationTime: number;
+    };
+}
+export declare function createDebugManager(options?: Partial<DebugOptions>): DebugManager;
+export declare function getDebugManager(): DebugManager | null;
+export declare function enableDebug(): DebugManager;
+export declare function disableDebug(): void;
+/**
+ * Track a signal in debug mode
+ */
+export declare function trackSignal<T>(name: string, signal: Signal<T>): Signal<T>;
+/**
+ * Track a computed in debug mode
+ */
+export declare function trackComputed<T>(name: string, computed$: Computed<T>): Computed<T>;
+/**
+ * Print signal history
+ */
+export declare function printSignalHistory(signalId: string): void;
+/**
+ * Print computed stats
+ */
+export declare function printComputedStats(computedId: string): void;
+/**
+ * Print performance summary
+ */
+export declare function printPerformanceSummary(): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

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