chrono-state-z 2.0.1 → 2.2.0

package/README.md

@@ -1,4 +1,4 @@
-# ⚙️ chrono-state-z
+# ⏱️ chrono-state-z
 
 [![NPM](https://img.shields.io/npm/v/chrono-state-z.svg)](https://www.npmjs.com/package/chrono-state-z) ![Downloads](https://img.shields.io/npm/dt/chrono-state-z.svg)  
 
@@ -6,20 +6,15 @@
 
 ---
 
-**chrono-state-z** is a **reactive, intent-first state runtime**  
-designed to keep **business logic outside React**.
+**chrono-state-z** is a reactive state runtime that keeps business logic outside React.   
+It provides **atoms, computed values, async state, effects, scheduling**, with a **headless core** and **thin React bindings**.   
 
-It provides **atoms, computed values, async state, effects, scheduling**,  
-with a **headless core** and **thin React bindings**.
-
-> **React renders state. Logic lives elsewhere.**
+> **React renders. Logic lives elsewhere.**
 
 ---
 
 ## ✨ Why chrono-state-z?
 
-Use chrono-state-z when you need:
-
 - Predictable state & side-effects
 - Complex async flows (fetch → invalidate → retry)
 - Logic reusable outside React (tests, workers, backend)
@@ -43,12 +38,50 @@ Use chrono-state-z when you need:
 ## 📦 Installation
 
 ```bash
-npm install react ## for react
-npm install intentx-core-z chrono-state-z
+npm install chrono-state-z
+# If using React:
+npm install react
 ```
 
 ---
 
+## ⚡ Quick Start
+
+```ts
+import { atom, computed, asyncAtom } from "chrono-state-z";
+
+const count = atom(0);
+const double = computed(() => count() * 2);
+
+const user = asyncAtom(async () =>
+  fetch("https://jsonplaceholder.typicode.com/todos/1")
+    .then(r => r.json())
+);
+```
+
+```ts
+import { useAtom, useComputed } from "chrono-state-z";
+
+function App() {
+  const value = useAtom(count);
+  const doubled = useComputed(double);
+  const username = useComputed(() => user()?.title);
+
+  return (
+    <button onClick={() => count.set(c => c + 1)}>
+      {value}
+    </button>
+  );
+}
+
+```
+
+✨ Fine-grained updates.  
+✨ Suspense-ready async.  
+✨ No reducers. No boilerplate.   
+
+---
+
 ## 🔹 Core Usage
 
 ### Atom & Computed
@@ -208,7 +241,7 @@ import { computed, useComputed } from 'chrono-state-z'
 const total = computed(() => price() * qty())
 
 function TotalView() {
-  const value = useComputed(() => total())
+  const value = useComputed(total)
   return <div>Total: {value}</div>
 }
 ```
@@ -218,8 +251,7 @@ function TotalView() {
 ### useAtomSelector
 
 ```tsx
-import { atom, useAtomSelector } from 'chrono-state-z'
-
+// atom() returns a callable reactive value
 const user = atom({ id: 1, name: 'Alice', age: 20 })
 
 function Username() {
@@ -234,11 +266,13 @@ function Username() {
 
 ```tsx
 import { useStore } from 'chrono-state-z'
+import type { Store } from 'chrono-state-z'
 
-function StoreView({ store }) {
+function StoreView({ store }: { store: Store<any> }) {
   const state = useStore(store)
-  return <pre>{JSON.stringify(state)}</pre>
+  return <pre>{JSON.stringify(state, null, 2)}</pre>
 }
+
 ```
 
 ---
@@ -246,13 +280,22 @@ function StoreView({ store }) {
 ### useStoreSelector
 
 ```tsx
+// Only re-renders when saving changes, not the whole store.
 import { useStoreSelector } from 'chrono-state-z'
 
 function SavingBadge({ store }) {
   const saving = useStoreSelector(store, s => s.saving)
+  // const saving = useStoreSelector(
+  //   store,
+  //   s => s.meta,
+  //   shallowEqual
+  // )
   return saving ? 'Saving...' : 'Idle'
 }
+
 ```
+- `selector` should be pure and stable.
+- If you need dynamic selection, memoize the selector.
 
 ---
 
@@ -261,28 +304,48 @@ function SavingBadge({ store }) {
 ```ts
 import { useWatch } from 'chrono-state-z'
 
-useWatch(
-  () => user(),
-  (u) => {
-    if (u?.role === 'admin') redirect('/admin')
-  }
-)
+const user = atom<{ role?: string } | null>(null)
+
+function AuthGuard() {
+  useWatch(
+    () => user(),
+    (u) => {
+      if (u?.role === 'admin') {
+        redirect('/admin')
+      }
+    }
+  )
+
+  return null
+}
+
+```
+
+### AsyncAtom
+```ts
+const user = asyncAtom(fetchUser)
+
+// load explicitly
+await user.load()
+
+// read value (throws / suspends if not ready)
+const u = user()
 ```
 
 ---
 
-## 🧩 Architecture Example
+## 🧩 Architecture Pattern
 
 ```ts
 import { asyncAtom, computed } from 'chrono-state-z'
 
 export function createUserLogic() {
   const user = asyncAtom(fetchUser)
-  const username = computed(() => user()?.name ?? 'Guest')
+  const name = computed(() => user()?.name ?? 'Guest')
 
   return {
     user,
-    username,
+    name,
     reload: () => user.invalidate()
   }
 }
@@ -291,29 +354,88 @@ export function createUserLogic() {
 ```tsx
 function UserView({ logic }) {
   const user = useAtom(logic.user)
-  const name = useComputed(() => logic.username())
+  const name = useComputed(logic.name)
 
   return (
-    <div>
-      <h3>Hello {name}</h3>
+    <>
+      <div>Hello {name}</div>
       <button onClick={logic.reload}>Reload</button>
-    </div>
+    </>
   )
 }
+
 ```
 
 ---
 
-## 📊 Comparison with Other Libraries
+## 🔍 Comparison
+
+<b>This is not about “better” — it's about architectural.</b>
+
+| Feature                     | chrono-state-z | Redux Toolkit | Zustand  | Jotai | MobX |
+| --------------------------- | -------------- | ------------- | -------- | ----- | ---- |
+| Fine-grained reactivity     | ✅              | ❌            | ⚠️       | ✅     | ✅   |
+| Built-in async primitives   | ✅              | ⚠️            | ❌       | ⚠️     | ❌   |
+| Scheduler / priority system | ✅              | ❌            | ❌       | ❌     | ❌   |
+| Headless (non-React) core   | ✅              | ✅            | ⚠️       | ⚠️     | ✅   |
+| Boilerplate level           | ✅              | ❌            | ✅       | ✅     | ⚠️   |
+| Devtools maturity           | ⚠️              | ✅            | ✅       | ⚠️     | ✅   |
+| Learning curve              | ⚠️              | ⚠️            | ✅       | ✅     | ⚠️   |
+
+
+<br />
+
+<b>📝 Notes</b>
+
+⚠️ Fine-grained in Zustand: achieved via selectors, but not dependency-tracked graph-level.
+
+⚠️ Async in Redux / Jotai / Recoil: supported via patterns (thunks, query libs, async selectors), not core-first primitives.
+
+⚠️ Headless in Zustand/Jotai: possible, but primarily designed for React usage.
+
+⚠️ Devtools: Redux and MobX have mature ecosystems; newer libs are still evolving.
+
+---
+
+## ⚖️ Strengths Compared to Others
+
+<b>vs Redux Toolkit</b>
+
+- More fine-grained updates
+- Less reducer boilerplate
+- Built-in reactive primitives
+- Redux has stronger ecosystem & devtools
+
+<b>vs Zustand</b>
+
+- More structured async handling
+- Explicit intent layer
+- Built-in scheduler support
+- Zustand is simpler & lighter for small apps
+
+<b>vs Jotai</b>
+
+- More explicit effect + scheduler control
+- Async-first primitives
+- Jotai is more minimal and React-native
+
+<b>vs MobX</b>
+
+- More explicit dependency graph (no proxy magic)
+- Better control over update priority
+- MobX is more ergonomic for mutable patterns
+
+<b>vs Recoil</b>
+
+- Headless core (not React-bound)
+- Explicit effect system
+- Recoil has better React DevTools integration
+
+<b>vs Solid signals</b>
 
-| Feature                   | chrono-state-z  | Redux | Zustand  | Jotai  |
-|---------------------------|---------------- |-------|--------- |------- |
-| Fine-grained reactivity   | ✅              | ❌     | ⚠️       | ✅     |
-| Async primitives          | ✅              | ⚠️     | ❌       | ⚠️     |
-| Intent / effect layer     | ✅              | ⚠️     | ❌       | ❌     |
-| Scheduler / priority      | ✅              | ❌     | ❌       | ❌     |
-| Headless (non-React) core | ✅              | ❌     | ⚠️       | ❌     |
-| Testability               | ✅              | ⚠️     | ⚠️       | ❌     |
+- Similar fine-grained reactive model
+- Designed for React ecosystem
+- Solid is framework-native and extremely optimized
 
 ---
 
@@ -337,4 +459,4 @@ function UserView({ logic }) {
 
 ## 📜 License
 
-MIT / Delpi
+MIT

package/build/core/asyncAtom.d.ts

@@ -1,9 +1,10 @@
-import { Priority } from "intentx-core-z";
+import { CommonResource } from "./asyncResource";
 export type AsyncAtom<T> = {
-    (): T;
-    set(v: T, p?: Priority): void;
-    load(): Promise<T>;
-    cancel(): void;
-    invalidate(p?: Priority): void;
-};
-export declare function asyncAtom<T>(fetcher: () => Promise<T>): AsyncAtom<T>;
+    (): T | undefined;
+} & CommonResource<T>;
+export declare function asyncAtom<T>(fetcher: (signal?: AbortSignal) => Promise<T>, options?: {
+    suspense?: boolean;
+}): AsyncAtom<T>;
+export declare function asyncAtomFamily<K, T>(factory: (key: K) => (signal?: AbortSignal) => Promise<T>, options?: {
+    suspense?: boolean;
+}): (key: K) => AsyncAtom<T>;

package/build/core/asyncComputed.d.ts

@@ -1,6 +1,8 @@
 import type { Priority } from "intentx-core-z";
 export type AsyncComputed<T> = {
-    (): T;
-    invalidate(p?: Priority): void;
+    (): T | undefined;
+    invalidate(priority?: Priority): void;
+    status(): string;
+    error(): any;
 };
-export declare function asyncComputed<T>(getter: () => Promise<T>, priority?: Priority): AsyncComputed<T>;
+export declare function asyncComputed<T>(getter: (signal?: AbortSignal) => Promise<T>, priority?: Priority): AsyncComputed<T>;

package/build/core/asyncResource.d.ts

@@ -0,0 +1,28 @@
+import { Priority } from "intentx-core-z";
+export type CommonResource<T> = {
+    load(): Promise<T>;
+    cancel(): void;
+    invalidate(priority?: Priority): void;
+    status(): AsyncState<T>["status"];
+    error(): any;
+    setSuccess(value: T, priority?: Priority): void;
+};
+export type AsyncState<T> = {
+    status: "idle";
+} | {
+    status: "loading";
+    promise: Promise<T>;
+} | {
+    status: "success";
+    data: T;
+} | {
+    status: "error";
+    error: any;
+};
+export type AsyncResource<T> = {
+    read(): T | undefined;
+} & CommonResource<T>;
+export declare function createAsyncResource<T>(fetcher: (signal?: AbortSignal) => Promise<T>, options?: {
+    suspense?: boolean;
+    priority?: Priority;
+}): AsyncResource<T>;

package/build/core/atom.d.ts

@@ -1,6 +1,6 @@
-import { Priority } from "intentx-core-z";
-export type Atom<T> = (() => T) & {
-    set(v: T, p?: Priority): void;
-    subscribe(fn: () => void): () => void;
-};
-export declare function atom<T>(initial: T): Atom<T>;
+export type ReadonlyAtom<T> = () => T;
+export declare const atom: <T>(initial: T, options?: import("./createAtomFactory").AtomOptions<T>) => import("./createBaseAtom").Atom<T>;
+export declare const atomMiddleware: <T>(initial: T, middleware?: import("./createAtomFactory").AtomMiddleware<T>) => import("./createBaseAtom").Atom<T>;
+export declare function readonlyAtom<T>(atom: {
+    (): T;
+}): ReadonlyAtom<T>;

package/build/core/createAtomFactory.d.ts

@@ -0,0 +1,7 @@
+import type { Signal } from "intentx-core-z";
+export type AtomOptions<T> = {
+    equals?: (a: T, b: T) => boolean;
+};
+export type AtomMiddleware<T> = (next: T, prev: T) => T;
+export declare function createAtomFactory(signal: <T>(v: T) => Signal<T>): <T>(initial: T, options?: AtomOptions<T>) => import("./createBaseAtom").Atom<T>;
+export declare function createAtomWithMiddlewareFactory(signal: <T>(v: T) => Signal<T>): <T>(initial: T, middleware?: AtomMiddleware<T>) => import("./createBaseAtom").Atom<T>;

package/build/core/createBaseAtom.d.ts

@@ -0,0 +1,6 @@
+import type { Priority, Signal } from "intentx-core-z";
+export type Atom<T> = Signal<T> & {
+    update(fn: (prev: T) => T, priority?: Priority): void;
+};
+export type AtomTransform<T> = (next: T, prev: T) => T;
+export declare function createBaseAtomFactory(signal: <T>(v: T) => Signal<T>): <T>(initial: T, transform?: AtomTransform<T>) => Atom<T>;

package/build/core/createStore.d.ts

@@ -1,11 +1,3 @@
-import type { IntentHandler, Scope } from "intentx-core-z";
-export type Subscriber = () => void;
-export type Store<S extends object> = {
-    scope: Scope;
-    state(): S;
-    setState(fn: (s: S) => void): void;
-    subscribe(fn: Subscriber): () => void;
-    emit(type: string, payload?: any): Promise<void>;
-    on(type: string, handler: IntentHandler<S>): () => void;
-};
+import type { Scope } from "intentx-core-z";
+import { Store } from "./types";
 export declare function createStore<S extends object>(initial: S, scope?: Scope): Store<S>;

package/build/core/factoryAtom.d.ts

@@ -1 +1,7 @@
-export declare function factoryAtom<K, A>(factory: (key: K) => A): (key: K) => A;
+export declare function factoryAtom<K, A>(factory: (key: K) => A, options?: {
+    weak?: boolean;
+}): {
+    (key: K): A;
+    delete(key: K): void;
+    clear(): void;
+};

package/build/core/index.d.ts

@@ -1,14 +1,12 @@
-export { atom } from "./atom";
-export { computed } from "./computed";
+export * from "./atom";
+export * from "./asyncComputed";
+export * from "./createAtomFactory";
 export { asyncAtom } from "./asyncAtom";
-export { asyncComputed } from "./asyncComputed";
-export { effect } from "./effect";
-export { watch } from "./watch";
+export { computed } from "intentx-core-z";
+export { effect } from "intentx-core-z";
+export * from "./watch";
 export { createStore } from "./createStore";
-export type { Store } from "./createStore";
-export { createScope, defaultScope } from "./scope";
-export type { Scope } from "./scope";
-export { transaction } from "./transaction";
-export { createSelector } from "./selector";
+export * from "./selector";
+export type { Store, Subscriber } from "./types";
 export { factoryAtom } from "./factoryAtom";
-export { createTestRuntime } from "./testRuntime";
+export { transaction } from "./transaction";

package/build/core/selector.d.ts

@@ -1 +1,7 @@
-export declare function createSelector<T, R>(select: (state: T) => R, isEqual?: (a: R, b: R) => boolean): (state: T) => R;
+export type EqualityFn<T> = (a: T, b: T) => boolean;
+export declare function createSelector<S, R>(select: (state: S) => R, isEqual?: EqualityFn<R>): (state: S) => R;
+export declare function selectAtom<T, R>(atom: () => T, selector: (value: T) => R, onChange: (value: R) => void, options?: {
+    isEqual?: (a: R, b: R) => boolean;
+    immediate?: boolean;
+}): () => void;
+export declare function watchSelector<S, R>(getState: () => S, subscribe: (fn: () => void) => () => void, selector: (state: S) => R, onChange: (value: R) => void, isEqual?: EqualityFn<R>): () => void;

package/build/core/types.d.ts

@@ -0,0 +1,12 @@
+import type { IntentHandler, Scope } from "intentx-core-z";
+import { EqualityFn } from "./selector";
+export type Subscriber = () => void;
+export type Store<S extends object> = {
+    scope: Scope;
+    state(): S;
+    setState(fn: (s: S) => void): void;
+    subscribe(fn: Subscriber): () => void;
+    emit(type: string, payload?: any): Promise<void>;
+    on(type: string, handler: IntentHandler<S>): () => void;
+    watch<R>(selector: (state: S) => R, onChange: (value: R) => void, isEqual?: EqualityFn<R>): () => void;
+};

package/build/core/watch.d.ts

@@ -1,2 +1,7 @@
 import type { Priority } from "intentx-core-z";
-export declare function watch<T>(getter: () => T, fn: (value: T) => void, priority?: Priority): () => void;
+export type WatchOptions<T> = {
+    immediate?: boolean;
+    equals?: (a: T, b: T) => boolean;
+    priority?: Priority;
+};
+export declare function watch<T>(getter: () => T, fn: (value: T, prev: T | undefined, onCleanup: (callback: () => void) => void) => void, options?: WatchOptions<T>): () => void;

package/build/index.cjs.js

@@ -1 +1 @@
-"use strict";var e=require("intentx-core-z"),t=require("react");function n(e){var t=Object.create(null);return e&&Object.keys(e).forEach(function(n){if("default"!==n){var r=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,r.get?r:{enumerable:!0,get:function(){return e[n]}})}}),t.default=e,Object.freeze(t)}var r=n(t);const c={activeEffect:null};function o(t){let n=t;const r=new Set,o=new Set,u=()=>(c.activeEffect&&o.add(c.activeEffect),n);return u.set=(t,c="normal")=>{Object.is(t,n)||(n=t,o.forEach(t=>e.schedule(t,c)),r.forEach(e=>e()))},u.subscribe=e=>(r.add(e),()=>r.delete(e)),u}function u(t){let n,r=!0;const o=new Set,u=()=>{r||(r=!0,o.forEach(t=>e.schedule(t)))};return()=>{if(c.activeEffect&&o.add(c.activeEffect),r){const e=c.activeEffect;c.activeEffect=u,n=t(),r=!1,c.activeEffect=e}return n}}function s(t,n="normal"){let r=null,o=!1;const u=()=>{if(!o){null==r||r();try{c.activeEffect=u;const e=t();"function"==typeof e&&(r=e)}finally{c.activeEffect=null}}};return e.schedule(u,n),()=>{o=!0,null==r||r(),r=null}}function l(e,t,n="normal"){return s(()=>{t(e())},n)}const a=e.createScope("default");function f(e){return r.useSyncExternalStore(t=>{let n=e();return s(()=>{const r=e();Object.is(n,r)||(n=r,t())})},e,e)}Object.defineProperty(exports,"createScope",{enumerable:!0,get:function(){return e.createScope}}),Object.defineProperty(exports,"transaction",{enumerable:!0,get:function(){return e.batch}}),exports.asyncAtom=function(t){const n=o(null);let r=null,c=!1;const u=()=>(r||(c=!1,r=t().then(e=>(c||n.set(e),e)).finally(()=>{r=null})),r),s=()=>{c=!0,r=null},l=()=>{const e=n();if(null===e)throw u();return e};return l.set=n.set,l.load=u,l.cancel=s,l.invalidate=(t="normal")=>{s(),e.schedule(()=>{try{u()}catch{}},t)},l},exports.asyncComputed=function(t,n="normal"){const r=o(void 0);let c=null,u=!1,s=null;const l=()=>(c||(u=!1,s=null,c=t().then(e=>(u||r.set(e,n),e)).catch(e=>{throw u||(s=e),e}).finally(()=>{c=null})),c),a=()=>{const e=r();if(s)throw s;if(void 0===e)throw l();return e};return a.invalidate=(t=n)=>{u=!0,c=null,e.schedule(()=>{try{l()}catch{}},t)},a},exports.atom=o,exports.computed=u,exports.createSelector=function(e,t=Object.is){let n,r=!1;return c=>{const o=e(c);return r&&t(n,o)?n:(r=!0,n=o,o)}},exports.createStore=function(t,n=a){let r=t;const c=new Set,o=e.createIntentBus((e,t)=>{const n=new AbortController;return{payload:e,scope:t,state:r,signal:n.signal,setState(e){e(r),c.forEach(e=>e())},emit:(e,n)=>o.emit(e,n,t)}});return{scope:n,state:()=>r,setState(e){e(r),c.forEach(e=>e())},subscribe:e=>(c.add(e),()=>c.delete(e)),emit:(e,t)=>o.emit(e,t,n),on:(e,t)=>o.on(e,t,n)}},exports.createTestRuntime=function(){let e=[];return{schedule(t){e.push(t)},flushEffects(){for(;e.length;)e.shift()()}}},exports.defaultScope=a,exports.effect=s,exports.factoryAtom=function(e){const t=new Map;return n=>{let r=t.get(n);return r||(r=e(n),t.set(n,r)),r}},exports.scheduleReactJob=function(e,n="normal"){"low"===n?t.startTransition(e):e()},exports.useAtom=f,exports.useBatch=function(){return e.batch},exports.useComputed=function(e){return f(r.useMemo(()=>u(e),[e]))},exports.useEffectReact=function(e,t="normal"){r.useEffect(()=>{const n=s(e,t);return()=>n()},[e,t])},exports.useFactoryAtom=function(e,t){return f(e(t))},exports.useStore=function(e){return t.useSyncExternalStore(e.subscribe,e.state,e.state)},exports.useStoreSelector=function(e,n,r=Object.is){const c=t.useRef(null),o=()=>{const t=n(e.state()),o=c.current;return null!==o&&r(o,t)?o:(c.current=t,t)};return t.useSyncExternalStore(e.subscribe,o,o)},exports.useWatch=function(e,t){r.useEffect(()=>{const n=l(e,t);return()=>null==n?void 0:n()},[e,t])},exports.watch=l;
+"use strict";var e=require("intentx-core-z"),t=require("react");function r(e){var t=Object.create(null);return e&&Object.keys(e).forEach(function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}}),t.default=e,Object.freeze(t)}var n=r(t);function o(e){return function(t,r){const n=e(t),o=n.set;return n.set=(e,t="normal")=>{const s=n(),c=r?r(e,s):e;o(c,t)},n.update=(e,t="normal")=>{n.set(e(n()),t)},n}}function s(e){const t=o(e);return function(e,r){var n;const o=null!==(n=null==r?void 0:r.equals)&&void 0!==n?n:Object.is;return t(e,(e,t)=>o(e,t)?t:e)}}function c(e){const t=o(e);return function(e,r){return t(e,r)}}const u=s(e.signal),a=c(e.signal);function i(t,r){var n,o;const s=null!==(n=null==r?void 0:r.suspense)&&void 0!==n&&n,c=null!==(o=null==r?void 0:r.priority)&&void 0!==o?o:"normal",a=u({status:"idle"});let i=null;const l=()=>{const e=a();if("loading"===e.status)return e.promise;null==i||i.abort(),i=new AbortController;const r=t(i.signal).then(e=>(a.set({status:"success",data:e},c),e)).catch(e=>{if("AbortError"===(null==e?void 0:e.name))return Promise.resolve(void 0);throw a.set({status:"error",error:e}),e});return a.set({status:"loading",promise:r},c),r},f=()=>{null==i||i.abort()};return{read:()=>{const e=a();switch(e.status){case"success":return e.data;case"error":if(s)throw e.error;return;case"loading":if(s)throw e.promise;return;case"idle":const t=l();if(s)throw t;return}},load:l,cancel:f,invalidate:(t=c)=>{f(),a.set({status:"idle"},t),e.schedule(l,t)},status:()=>a().status,error:()=>"error"===a().status?a().error:void 0,setSuccess:(e,t=c)=>{a.set({status:"success",data:e},t)}}}function l(t,r,n){const{immediate:o=!1,equals:s=Object.is,priority:c="normal"}=null!=n?n:{};let u,a,i=!1;const l=e.effect(()=>{const e=t();if(!i)return i=!0,o&&f(e,u),void(u=e);s(e,u)||(f(e,u),u=e)},c);function f(e,t){const n=a;a=void 0,null==n||n(),r(e,t,e=>{a=e})}return()=>{null==a||a(),l()}}function f(e,t=Object.is){let r,n=!1;return o=>{const s=e(o);return n&&t(r,s)?r:(n=!0,r=s,s)}}function d(e,t,r,n,o=Object.is){const s=f(r,o);let c=!1;const u=()=>{c||n(s(e()))};u();const a=t(u);return()=>{c=!0,a()}}const p=e.createScope("default");function m(t){return n.useSyncExternalStore(r=>e.effect(()=>{t(),r()}),t,t)}Object.defineProperty(exports,"computed",{enumerable:!0,get:function(){return e.computed}}),Object.defineProperty(exports,"createScope",{enumerable:!0,get:function(){return e.createScope}}),Object.defineProperty(exports,"effect",{enumerable:!0,get:function(){return e.effect}}),Object.defineProperty(exports,"transaction",{enumerable:!0,get:function(){return e.batch}}),exports.asyncAtom=function(e,t){const r=i(e,t),n=()=>r.read();return n.load=r.load,n.cancel=r.cancel,n.invalidate=r.invalidate,n.status=r.status,n.error=r.error,n.setSuccess=e=>r.setSuccess(e),n},exports.asyncComputed=function(e,t="normal"){const r=i(e,{suspense:!0,priority:t}),n=()=>r.read();return n.invalidate=r.invalidate,n.status=r.status,n.error=r.error,n},exports.atom=u,exports.atomMiddleware=a,exports.createAtomFactory=s,exports.createAtomWithMiddlewareFactory=c,exports.createSelector=f,exports.createStore=function(t,r=p){let n=t;const o=new Set,s=e.createIntentBus((e,t)=>{const r=new AbortController;return{payload:e,scope:t,state:n,signal:r.signal,setState(e){e(n),o.forEach(e=>e())},emit:(e,r)=>s.emit(e,r,t)}});return{scope:r,state:()=>n,setState(e){e(n),o.forEach(e=>e())},subscribe:e=>(o.add(e),()=>o.delete(e)),emit:(e,t)=>s.emit(e,t,r),on:(e,t)=>s.on(e,t,r),watch:(e,t,r)=>d(()=>n,e=>(o.add(e),()=>o.delete(e)),e,t,r)}},exports.factoryAtom=function(e,t){var r;const n=null!==(r=null==t?void 0:t.weak)&&void 0!==r&&r,o=n?new WeakMap:new Map,s=t=>{const r=o.get(t);if(void 0!==r)return r;const n=e(t);return o.set(t,n),n};return s.delete=e=>{n||o.delete(e)},s.clear=()=>{n||o.clear()},s},exports.readonlyAtom=function(e){return()=>e()},exports.scheduleReactJob=function(e,r="normal"){"low"===r?t.startTransition(e):e()},exports.selectAtom=function(t,r,n,o){var s;const c=null!==(s=null==o?void 0:o.isEqual)&&void 0!==s?s:Object.is;let u;return e.effect(()=>{const e=r(t());void 0!==u&&c(u,e)||(u=e,((null==o?void 0:o.immediate)||void 0!==u)&&n(e))})},exports.useAtom=m,exports.useAtomSelector=function(r,n,o=Object.is){const s=t.useRef(f(n,o)),c=()=>s.current(r());return t.useSyncExternalStore(t=>e.effect(()=>{r(),t()}),c,c)},exports.useBatch=function(){return e.batch},exports.useComputed=function(t,r=[]){return m(n.useMemo(()=>e.computed(t),r))},exports.useEffectReact=function(t,r="normal"){const o=n.useRef(t);o.current=t,n.useEffect(()=>{const t=e.effect(()=>{o.current()},r);return()=>t()},[r])},exports.useFactoryAtom=function(e,t){const r=n.useRef(e);r.current=e;const o=n.useRef(null),s=n.useRef(null);return null!==o.current&&s.current===t||(o.current=r.current(t),s.current=t),m(o.current)},exports.useStore=function(e){return t.useSyncExternalStore(e.subscribe,e.state,e.state)},exports.useStoreSelector=function(e,t,r=Object.is){const o=n.useRef(t);o.current=t;const s=n.useRef(f(e=>o.current(e),r)),c=n.useCallback(()=>s.current(e.state()),[e]);return n.useSyncExternalStore(e.subscribe,c,c)},exports.useWatch=function(e,t,r){const o=n.useRef(t);o.current=t;const s=n.useRef(r);s.current=r,n.useEffect(()=>{const t=l(e,e=>{o.current(e)},s.current);return()=>null==t?void 0:t()},[e])},exports.watch=l,exports.watchSelector=d;

package/build/index.d.ts

@@ -1,2 +1,4 @@
+export { createScope } from "intentx-core-z";
+export type { Scope } from "intentx-core-z";
 export * from './core';
 export * from './react';

package/build/index.esm.js

@@ -1 +1 @@
-import{schedule as t,createScope as n,createIntentBus as e,batch as r}from"intentx-core-z";export{createScope,batch as transaction}from"intentx-core-z";import*as c from"react";import o,{startTransition as u}from"react";const l={activeEffect:null};function f(n){let e=n;const r=new Set,c=new Set,o=()=>(l.activeEffect&&c.add(l.activeEffect),e);return o.set=(n,o="normal")=>{Object.is(n,e)||(e=n,c.forEach(n=>t(n,o)),r.forEach(t=>t()))},o.subscribe=t=>(r.add(t),()=>r.delete(t)),o}function i(n){let e,r=!0;const c=new Set,o=()=>{r||(r=!0,c.forEach(n=>t(n)))};return()=>{if(l.activeEffect&&c.add(l.activeEffect),r){const t=l.activeEffect;l.activeEffect=o,e=n(),r=!1,l.activeEffect=t}return e}}function s(n){const e=f(null);let r=null,c=!1;const o=()=>(r||(c=!1,r=n().then(t=>(c||e.set(t),t)).finally(()=>{r=null})),r),u=()=>{c=!0,r=null},l=()=>{const t=e();if(null===t)throw o();return t};return l.set=e.set,l.load=o,l.cancel=u,l.invalidate=(n="normal")=>{u(),t(()=>{try{o()}catch{}},n)},l}function a(n,e="normal"){const r=f(void 0);let c=null,o=!1,u=null;const l=()=>(c||(o=!1,u=null,c=n().then(t=>(o||r.set(t,e),t)).catch(t=>{throw o||(u=t),t}).finally(()=>{c=null})),c),i=()=>{const t=r();if(u)throw u;if(void 0===t)throw l();return t};return i.invalidate=(n=e)=>{o=!0,c=null,t(()=>{try{l()}catch{}},n)},i}function E(n,e="normal"){let r=null,c=!1;const o=()=>{if(!c){null==r||r();try{l.activeEffect=o;const t=n();"function"==typeof t&&(r=t)}finally{l.activeEffect=null}}};return t(o,e),()=>{c=!0,null==r||r(),r=null}}function h(t,n,e="normal"){return E(()=>{n(t())},e)}const d=n("default");function m(t,n=d){let r=t;const c=new Set,o=e((t,n)=>{const e=new AbortController;return{payload:t,scope:n,state:r,signal:e.signal,setState(t){t(r),c.forEach(t=>t())},emit:(t,e)=>o.emit(t,e,n)}});return{scope:n,state:()=>r,setState(t){t(r),c.forEach(t=>t())},subscribe:t=>(c.add(t),()=>c.delete(t)),emit:(t,e)=>o.emit(t,e,n),on:(t,e)=>o.on(t,e,n)}}function v(t,n=Object.is){let e,r=!1;return c=>{const o=t(c);return r&&n(e,o)?e:(r=!0,e=o,o)}}function b(t){const n=new Map;return e=>{let r=n.get(e);return r||(r=t(e),n.set(e,r)),r}}function S(){let t=[];return{schedule(n){t.push(n)},flushEffects(){for(;t.length;)t.shift()()}}}function p(t){return c.useSyncExternalStore(n=>{let e=t();return E(()=>{const r=t();Object.is(e,r)||(e=r,n())})},t,t)}function w(t){return p(c.useMemo(()=>i(t),[t]))}function y(t,n){return p(t(n))}function x(t){return o.useSyncExternalStore(t.subscribe,t.state,t.state)}function g(t,n,e=Object.is){const r=o.useRef(null),c=()=>{const c=n(t.state()),o=r.current;return null!==o&&e(o,c)?o:(r.current=c,c)};return o.useSyncExternalStore(t.subscribe,c,c)}function j(t,n){c.useEffect(()=>{const e=h(t,n);return()=>null==e?void 0:e()},[t,n])}function O(t,n="normal"){c.useEffect(()=>{const e=E(t,n);return()=>e()},[t,n])}function z(){return r}function M(t,n="normal"){"low"===n?u(t):t()}export{s as asyncAtom,a as asyncComputed,f as atom,i as computed,v as createSelector,m as createStore,S as createTestRuntime,d as defaultScope,E as effect,b as factoryAtom,M as scheduleReactJob,p as useAtom,z as useBatch,w as useComputed,O as useEffectReact,y as useFactoryAtom,x as useStore,g as useStoreSelector,j as useWatch,h as watch};
+import{signal as t,schedule as e,effect as n,createScope as r,createIntentBus as s,batch as o,computed as u}from"intentx-core-z";export{computed,createScope,effect,batch as transaction}from"intentx-core-z";import*as c from"react";import i,{startTransition as a}from"react";function l(t){return function(e,n){const r=t(e),s=r.set;return r.set=(t,e="normal")=>{const o=r(),u=n?n(t,o):t;s(u,e)},r.update=(t,e="normal")=>{r.set(t(r()),e)},r}}function f(t){const e=l(t);return function(t,n){var r;const s=null!==(r=null==n?void 0:n.equals)&&void 0!==r?r:Object.is;return e(t,(t,e)=>s(t,e)?e:t)}}function d(t){const e=l(t);return function(t,n){return e(t,n)}}const v=f(t),m=d(t);function p(t){return()=>t()}function b(t,n){var r,s;const o=null!==(r=null==n?void 0:n.suspense)&&void 0!==r&&r,u=null!==(s=null==n?void 0:n.priority)&&void 0!==s?s:"normal",c=v({status:"idle"});let i=null;const a=()=>{const e=c();if("loading"===e.status)return e.promise;null==i||i.abort(),i=new AbortController;const n=t(i.signal).then(t=>(c.set({status:"success",data:t},u),t)).catch(t=>{if("AbortError"===(null==t?void 0:t.name))return Promise.resolve(void 0);throw c.set({status:"error",error:t}),t});return c.set({status:"loading",promise:n},u),n},l=()=>{null==i||i.abort()};return{read:()=>{const t=c();switch(t.status){case"success":return t.data;case"error":if(o)throw t.error;return;case"loading":if(o)throw t.promise;return;case"idle":const e=a();if(o)throw e;return}},load:a,cancel:l,invalidate:(t=u)=>{l(),c.set({status:"idle"},t),e(a,t)},status:()=>c().status,error:()=>"error"===c().status?c().error:void 0,setSuccess:(t,e=u)=>{c.set({status:"success",data:t},e)}}}function S(t,e="normal"){const n=b(t,{suspense:!0,priority:e}),r=()=>n.read();return r.invalidate=n.invalidate,r.status=n.status,r.error=n.error,r}function w(t,e){const n=b(t,e),r=()=>n.read();return r.load=n.load,r.cancel=n.cancel,r.invalidate=n.invalidate,r.status=n.status,r.error=n.error,r.setSuccess=t=>n.setSuccess(t),r}function h(t,e,r){const{immediate:s=!1,equals:o=Object.is,priority:u="normal"}=null!=r?r:{};let c,i,a=!1;const l=n(()=>{const e=t();if(!a)return a=!0,s&&f(e,c),void(c=e);o(e,c)||(f(e,c),c=e)},u);function f(t,n){const r=i;i=void 0,null==r||r(),e(t,n,t=>{i=t})}return()=>{null==i||i(),l()}}function E(t,e=Object.is){let n,r=!1;return s=>{const o=t(s);return r&&e(n,o)?n:(r=!0,n=o,o)}}function R(t,e,r,s){var o;const u=null!==(o=null==s?void 0:s.isEqual)&&void 0!==o?o:Object.is;let c;return n(()=>{const n=e(t());void 0!==c&&u(c,n)||(c=n,((null==s?void 0:s.immediate)||void 0!==c)&&r(n))})}function x(t,e,n,r,s=Object.is){const o=E(n,s);let u=!1;const c=()=>{u||r(o(t()))};c();const i=e(c);return()=>{u=!0,i()}}const y=r("default");function g(t,e=y){let n=t;const r=new Set,o=s((t,e)=>{const s=new AbortController;return{payload:t,scope:e,state:n,signal:s.signal,setState(t){t(n),r.forEach(t=>t())},emit:(t,n)=>o.emit(t,n,e)}});return{scope:e,state:()=>n,setState(t){t(n),r.forEach(t=>t())},subscribe:t=>(r.add(t),()=>r.delete(t)),emit:(t,n)=>o.emit(t,n,e),on:(t,n)=>o.on(t,n,e),watch:(t,e,s)=>x(()=>n,t=>(r.add(t),()=>r.delete(t)),t,e,s)}}function j(t,e){var n;const r=null!==(n=null==e?void 0:e.weak)&&void 0!==n&&n,s=r?new WeakMap:new Map,o=e=>{const n=s.get(e);if(void 0!==n)return n;const r=t(e);return s.set(e,r),r};return o.delete=t=>{r||s.delete(t)},o.clear=()=>{r||s.clear()},o}function O(t){return c.useSyncExternalStore(e=>n(()=>{t(),e()}),t,t)}function k(t,e,r=Object.is){const s=i.useRef(E(e,r)),o=()=>s.current(t());return i.useSyncExternalStore(e=>n(()=>{t(),e()}),o,o)}function q(){return o}function A(t,e=[]){return O(c.useMemo(()=>u(t),e))}function C(t,e="normal"){const r=c.useRef(t);r.current=t,c.useEffect(()=>{const t=n(()=>{r.current()},e);return()=>t()},[e])}function M(t,e){const n=c.useRef(t);n.current=t;const r=c.useRef(null),s=c.useRef(null);return null!==r.current&&s.current===e||(r.current=n.current(e),s.current=e),O(r.current)}function z(t){return i.useSyncExternalStore(t.subscribe,t.state,t.state)}function P(t,e,n=Object.is){const r=c.useRef(e);r.current=e;const s=c.useRef(E(t=>r.current(t),n)),o=c.useCallback(()=>s.current(t.state()),[t]);return c.useSyncExternalStore(t.subscribe,o,o)}function W(t,e,n){const r=c.useRef(e);r.current=e;const s=c.useRef(n);s.current=n,c.useEffect(()=>{const e=h(t,t=>{r.current(t)},s.current);return()=>null==e?void 0:e()},[t])}function B(t,e="normal"){"low"===e?a(t):t()}export{w as asyncAtom,S as asyncComputed,v as atom,m as atomMiddleware,f as createAtomFactory,d as createAtomWithMiddlewareFactory,E as createSelector,g as createStore,j as factoryAtom,p as readonlyAtom,B as scheduleReactJob,R as selectAtom,O as useAtom,k as useAtomSelector,q as useBatch,A as useComputed,C as useEffectReact,M as useFactoryAtom,z as useStore,P as useStoreSelector,W as useWatch,h as watch,x as watchSelector};

package/build/react/index.d.ts

@@ -1,9 +1,10 @@
 export { useAtom } from './useAtom';
+export { useAtomSelector } from './useAtomSelector';
+export { useBatch } from './useBatch';
 export { useComputed } from './useComputed';
+export { useEffectReact } from './useEffectReact';
 export { useFactoryAtom } from './useFactoryAtom';
 export { useStore } from './useStore';
 export { useStoreSelector } from './useStoreSelector';
 export { useWatch } from './useWatch';
-export { useEffectReact } from './useEffectReact';
-export { useBatch } from './useBatch';
 export { scheduleReactJob } from './schedule';

package/build/react/useComputed.d.ts

@@ -1 +1,2 @@
-export declare function useComputed<T>(fn: () => T): T;
+import * as React from 'react';
+export declare function useComputed<T>(fn: () => T, deps?: React.DependencyList): T;

package/build/react/useStoreSelector.d.ts

@@ -1,4 +1,4 @@
-export declare function useStoreSelector<S, T>(store: {
+export declare function useStoreSelector<S, R>(store: {
     state(): S;
     subscribe(fn: () => void): () => void;
-}, selector: (state: S) => T, isEqual?: (a: T, b: T) => boolean): T;
+}, selector: (state: S) => R, isEqual?: (a: R, b: R) => boolean): R;

package/build/react/useWatch.d.ts

@@ -1 +1,2 @@
-export declare function useWatch<T>(getter: () => T, fn: (val: T) => void): void;
+import type { WatchOptions } from "../core/watch";
+export declare function useWatch<T>(getter: () => T, fn: (val: T) => void, options?: WatchOptions<T>): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chrono-state-z",
-  "version": "2.0.1",
-  "description": "Reactive, intent-first state runtime with atoms, computed, async state, effects, and FSM. Logic-first, React-agnostic.",
+  "version": "2.2.0",
+  "description": "A fine-grained, intent-driven reactive state runtime for building complex React logic outside components.",
   "license": "MIT",
   "author": "Delpi.Kye",
   "sideEffects": false,
@@ -9,25 +9,13 @@
   "main": "build/index.cjs.js",
   "module": "build/index.esm.js",
   "types": "build/index.d.ts",
-
   "exports": {
     ".": {
       "types": "./build/index.d.ts",
       "import": "./build/index.esm.js",
       "require": "./build/index.cjs.js"
-    },
-    "./react": {
-      "types": "./build/react/index.d.ts",
-      "import": "./build/react/index.esm.js",
-      "require": "./build/react/index.cjs.js"
-    },
-    "./devtools": {
-      "types": "./build/devtools/index.d.ts",
-      "import": "./build/devtools/index.esm.js",
-      "require": "./build/devtools/index.cjs.js"
     }
   },
-
   "files": [
     "build"
   ],
@@ -43,35 +31,33 @@
     "type": "git",
     "url": "https://github.com/delpikye-v/chrono-state.git"
   },
-
   "homepage": "https://github.com/delpikye-v/chrono-state",
-
   "bugs": {
     "url": "https://github.com/delpikye-v/chrono-state/issues"
   },
-
   "keywords": [
-    "react",
     "state-management",
+    "react-state",
     "reactive",
+    "fine-grained",
+    "signals",
     "atom",
     "computed",
     "async-state",
-    "external-store",
+    "scheduler",
+    "deterministic",
     "intent",
-    "intent-first",
     "logic-first",
     "headless",
-    "fsm",
-    "effects",
-    "scheduler"
+    "react-hooks",
+    "react-18"
   ],
-
   "peerDependencies": {
-    "react": "^18.0.0",
-    "intentx-core-z": "^1.0.0"
+    "react": ">=18"
+  },
+  "dependencies": {
+    "intentx-core-z": "^2.2.1"
   },
-
   "devDependencies": {
     "@rollup/plugin-commonjs": "^25.0.0",
     "@rollup/plugin-node-resolve": "^15.2.3",

package/build/core/computed.d.ts

@@ -1 +0,0 @@
-export declare function computed<T>(getter: () => T): () => T;

package/build/core/effect.d.ts

@@ -1,2 +0,0 @@
-import { Priority } from "intentx-core-z";
-export declare function effect(fn: () => void | (() => void), priority?: Priority): () => void;

package/build/core/effectContext.d.ts

@@ -1,3 +0,0 @@
-export declare const effectContext: {
-    activeEffect: (() => void) | null;
-};

package/build/core/graph.d.ts

@@ -1,22 +0,0 @@
-export type NodeType = 'atom' | 'computed' | 'effect';
-export type GraphNode = {
-    id: number;
-    name?: string;
-    type: NodeType;
-    value?: any;
-    deps: Set<number>;
-    highlighted?: boolean;
-};
-export type GraphSnapshotNode = {
-    id: number;
-    name?: string;
-    type: NodeType;
-    value?: any;
-    deps: number[];
-    highlighted?: boolean;
-};
-export declare function trackNode(type: NodeType, name?: string, value?: any): GraphNode;
-export declare function linkNodes(from: GraphNode, to: GraphNode): void;
-export declare function getGraphSnapshot(): GraphSnapshotNode[];
-export declare function highlightNode(id: number): void;
-export declare function clearHighlights(): void;

package/build/core/scope.d.ts

@@ -1,4 +0,0 @@
-import { Scope } from "intentx-core-z";
-export { createScope } from "intentx-core-z";
-export type { Scope } from "intentx-core-z";
-export declare const defaultScope: Scope;

package/build/core/store.d.ts

@@ -1,9 +0,0 @@
-import type { IntentHandler } from "intentx-core-z";
-export type Subscriber = () => void;
-export type Store<S extends object> = {
-    state(): S;
-    setState(fn: (s: S) => void): void;
-    subscribe(fn: Subscriber): () => void;
-    emit(intent: string, payload?: any): Promise<void>;
-    on(intent: string, handler: IntentHandler<S>): () => void;
-};

package/build/core/testRuntime.d.ts

@@ -1,6 +0,0 @@
-type Job = () => void;
-export declare function createTestRuntime(): {
-    schedule(job: Job): void;
-    flushEffects(): void;
-};
-export {};

package/build/react/useScopedStore.d.ts

@@ -1,4 +0,0 @@
-export declare function useScopedStore<S>(store: {
-    state(): S;
-    subscribe(fn: () => void): () => void;
-}): S;