logic-runtime-react-z 3.1.0 → 3.1.2

package/README.md

@@ -10,15 +10,16 @@ A headless, deterministic, intent-driven runtime for frontend & backend logic.
 React components stay pure. Business logic is fully testable, replayable, and framework-agnostic.
 
 > **Intent is the only entry point.**
+> **React is optional. `createLogic` is the product. Everything else is an adapter.**
 
 ---
 
 ## ✨ Why logic-runtime-react-z?
 
-- No React hooks in views
+- No business logic in React components
 - Intent is the *only* entry point
 - Predictable async flows
-- Computed graph with caching
+- Reactive computed graph with caching
 - Headless & backend-friendly
 - Deterministic testing & devtools replay
 
@@ -37,7 +38,7 @@ UI / HTTP / Queue / Cron
         ↓
      mutate state
         ↓
- computed / subscribers
+ computed (derived state) / subscribers
 ```
 
 Think **events → behavior → state → derived state**.
@@ -75,23 +76,46 @@ const counterLogic = createLogic({
   },
 })
 
-const runtime = counterLogic.create()
+async function main() {
+  const runtime = counterLogic.create()
+
+  await runtime.emit("inc")
+  await runtime.emit("add", 5)
 
-await runtime.emit("inc")
-await runtime.emit("add", 5)
+  console.log(runtime.state.count)
+}
 
-console.log(runtime.state.count) // 6
+main()
 ```
 
-✔ No UI  
-✔ Fully testable  
+✔ No UI
+✔ Fully testable
 ✔ Deterministic
 
+> 💡 This is the core usage.
+> createLogic() + runtime.emit() already gives you state, computed and effects.
+> React integration is just a convenience layer on top of this runtime.
+
 ---
 
-## ⚛️ React Integration (No Hooks)
+## 🧠 Computed State
 
-### Define Logic
+```ts
+computed: {
+  double: ({ state }) => state.count * 2,
+  triple: ({ state }) => state.count * 3,
+}
+```
+
+- `state` inside `computed` is **reactive**.
+- Reading `state.count` automatically tracks dependencies.
+- Computed values are cached and only re-evaluated when tracked dependencies change.
+
+---
+
+## ⚛️ React Integration (No Hooks Required)
+
+### Define Logic (Framework-Agnostic)
 
 ```ts
 // counter.logic.ts
@@ -136,10 +160,11 @@ export const counterLogic = createLogic({
       })
     })
 
+    // effects = side-effects only (no state mutation)
     bus.effect(
       "inc-async",
       effect(async ({ payload }) => {
-        console.log("effect run, payload =", payload)
+        console.log("effect run:", payload)
       }).takeLatest()
     )
   },
@@ -158,26 +183,27 @@ export const counterLogic = createLogic({
     },
   },
 })
+
 ```
 
 ---
 
-### Pure React View (No Types Needed)
+### Pure React View (Dumb View)
 
 ```tsx
 import React from "react"
 import { withLogic } from "logic-runtime-react-z"
 import { counterLogic } from "./counter.logic"
 
-function CounterView(props: any) {
+function CounterView(props) {
   const { state, actions, emit } = props
 
   return (
     <div style={{ padding: 12 }}>
-      <div>Count: {state.triple}</div>
+      <div>Triple Count: {state.triple}</div>
 
-      <button onClick={actions.inc}>+1 (action)</button>
-      <button onClick={() => actions.add(10)}>+10 (action)</button>
+      <button onClick={actions.inc}>+1</button>
+      <button onClick={() => actions.add(10)}>+10</button>
 
       <button
         disabled={state.loading}
@@ -189,74 +215,93 @@ function CounterView(props: any) {
       <hr />
 
       <button onClick={() => emit("inc")}>
-        +1 (emit directly)
+        emit("inc")
       </button>
     </div>
   )
 }
 
-export const CounterPage =
-  withLogic(counterLogic, CounterView)
+export const CounterPage = withLogic(counterLogic, CounterView)
+
 ```
 
-✔ Props inferred automatically  
-✔ No generics  
-✔ No interfaces  
-✔ View stays dumb
+✔ Props are inferred when using withLogic, no manual generics required.
 
 ---
 
-## 🧪 Backend Runtime Example
+## 🧪 Backend Usage (Same Runtime)
 
 ```ts
-import { createBackendRuntime } from "logic-runtime-react-z"
+import { createLogic } from "logic-runtime-react-z"
 
-const runtime = createBackendRuntime({
-  user: null,
-  loading: false,
-})
+const authLogic = createLogic({
+  state: {
+    user: null,
+    loading: false,
+  },
+
+  intents: bus => {
+    bus.on("login", async ({ setState }) => {
+      setState(s => {
+        s.loading = true
+      })
 
-runtime.registerIntents({
-  async login({ set }) {
-    set({ loading: true })
-    await new Promise(r => setTimeout(r, 500))
-    set({
-      user: { name: "Alice" },
-      loading: false,
+      await new Promise(r => setTimeout(r, 500))
+
+      setState(s => {
+        s.user = { name: "Alice" }
+        s.loading = false
+      })
     })
-  },
 
-  logout({ set }) {
-    set({ user: null })
+    bus.on("logout", ({ setState }) => {
+      setState(s => {
+        s.user = null
+      })
+    })
   },
 })
 
-await runtime.emit("login")
-await runtime.emit("logout")
+async function run() {
+  const runtime = authLogic.create()
 
-// 👇 backend devtools
-const devtools = runtime.devtools
-console.log(devtools.timeline.records)
+  await runtime.emit("login")
+  await runtime.emit("logout")
 
-// relay
-// await devtools.timeline.replay(runtime.emit, {
-//   scope: "backend"
-})
+  console.log(runtime.getSnapshot())
+}
+
+run()
 ```
 
-✔ Same intent model  
+✔ Same runtime, same behavior, no React involved.  
 ✔ No React  
 ✔ Replayable  
-✔ Devtools is backend-first.
 
 ---
 
-## 🪝 Hooks API (Optional)
+## 🪝 Hooks Examples (Optional, Thin Adapters)
+
+Hooks are optional convenience layers on top of the same logic runtime.
+They do not own state, they only subscribe to it.
 
+#### useRuntime – full snapshot
+```ts
+import { useRuntime } from "logic-runtime-react-z"
+
+function Debug() {
+  const snapshot = useRuntime(counterLogic)
+  return <pre>{JSON.stringify(snapshot, null, 2)}</pre>
+}
+```
+
+✔ Subscribes to full snapshot
+✔ Includes state + computed
+✔ Read-only
+
+#### useActions – actions only (no re-render)
 ```ts
-// useActions
 import { useActions } from "logic-runtime-react-z"
-import { counterLogic } from "./counter.logic"
 
 function Buttons() {
   const actions = useActions(counterLogic)
@@ -268,36 +313,72 @@ function Buttons() {
     </>
   )
 }
+```
 
-// useLogicSelector
-import { useLogicSelector } from "logic-runtime-react-z"
-import { counterLogic } from "./counter.logic"
 
-function DoubleValue() {
-  const double = useLogicSelector(
+✔ No re-render on state change
+✔ Fully inferred action types
+✔ Ideal for buttons / handlers
+
+#### useComputed – Subscribe to computed values
+```ts
+import { useComputed } from "logic-runtime-react-z"
+
+function Stats() {
+  const { double, triple } = useComputed(counterLogic)
+
+  return (
+    <>
+      <div>Double: {double}</div>
+      <div>Triple: {triple}</div>
+    </>
+  )
+}
+
+function DoubleOnly() {
+  const double = useComputed(counterLogic, c => c.double)
+  return <div>{double}</div>
+}
+```
+
+✔ Only derived data
+✔ Cached & reactive
+✔ No state mutation possible
+
+#### useComputed with selector (recommended)
+```ts
+function DoubleOnly() {
+  const double = useComputed(
     counterLogic,
-    s => s.double
+    c => c.double
   )
 
   return <div>Double: {double}</div>
 }
+```
 
-// useRuntime
-import { useRuntime } from "logic-runtime-react-z"
-import { counterLogic } from "./counter.logic"
+✔ Component re-renders only when double changes
+✔ No extra dependencies
+✔ Type-safe selector
 
-function DebugPanel() {
-  const runtime = useRuntime(counterLogic)
+#### useLogicSelector – State selector (Redux-like)
+```ts
+import { useLogicSelector } from "logic-runtime-react-z"
 
-  return (
-    <button onClick={() => runtime.emit("inc")}>
-      Emit directly
-    </button>
+function CountLabel() {
+  const count = useLogicSelector(
+    counterLogic,
+    state => state.count
   )
-}
 
+  return <span>{count}</span>
+}
 ```
 
+✔ Memoized selector
+✔ Fine-grained subscriptions
+✔ Familiar mental model
+
 ---
 
 ## 🧱 Composing Multiple Logic Modules
@@ -307,20 +388,16 @@ import { composeLogic } from "logic-runtime-react-z"
 import { userLogic } from "./user.logic"
 import { cartLogic } from "./cart.logic"
 
-export const appLogic = composeLogic({
+const app = composeLogic({
   user: userLogic,
   cart: cartLogic,
 })
 
+await app.emit("login")
 
-// usage
-const runtime = appLogic.create()
-
-await runtime.emit("user:login", credentials)
-
-const snapshot = runtime.getSnapshot()
-snapshot.user   // user state
-snapshot.cart   // cart state
+const state = app.getState()
+state.user
+state.cart
 
 ```
 
@@ -345,108 +422,108 @@ const logic = createLogic({
   },
 })
 
-const runtime = logic.create()
+const runtime = counterLogic.create()
 
 await runtime.emit("set", 4)
-
-expect(runtime.state.squared).toBe(16)
+expect(runtime.computed.squared).toBe(16)
 ```
 
+✔ Computed values are tested like plain data
+
 ---
 
-## 🚫 Anti-patterns (What NOT to do)
+## 🔍 Comparison
 
-### ❌ Business logic in React
+| Criteria                                  |  logic-runtime-react-z  |         Redux        |        Zustand        |             Recoil             |             MobX            |
+| ----------------------------------------- | :---------------------: | :------------------: | :-------------------: | :----------------------------: | :-------------------------: |
+| **Intent-first model**                    |            ✅            |           ❌          |           ❌           |               ⚠️               |              ⚠️             |
+| **State-first model**                     |            ❌            |           ✅          |           ✅           |                ✅               |              ✅              |
+| **First-class effect orchestration**      |       ✅ (built-in)      |  ⚠️ (via middleware) |  ⚠️ (via middleware)  | ⚠️ (selectors + async helpers) |   ⚠️ (actions + reactions)  |
+| **Fine-grained derived state (computed)** |  ✅ (reactive & cached)  |           ❌          | ⚠️ (simple selectors) |      ✅ (dependency graph)      | ⚠️ (observable derivations) |
+| **Predictable execution semantics**       |  🔁 intent queue/rules   | 👍 sync + middleware |        👍 sync        |             👍 sync            |           👍 sync           |
+| **Async control strategies built-in**     | ✅ takeLatest / debounce |           ❌          |           ❌           |                ❌               |              ❌              |
+| **Logic outside React**                   |            ✅            |          ⚠️          |           ⚠️          |               ⚠️               |              ⚠️             |
+| **Framework-agnostic**                   |            ✅            |           ⚫          |           ⚫           |                ⚫               |              ⚫              |
+| **Backend-ready usage**                   |            ✅            |          ⚠️          |           ⚠️          |               ⚠️               |              ⚠️             |
+| **Type-inferred actions**                 |            ✅            |          ⚠️          |           ⚠️          |               ⚠️               |              ⚠️             |
+| **Minimal re-render strategies**          |    ✓ selectors/hooks     |      ✓ selectors     |      ✓ selectors      |        ✓ atoms/selectors       |     ✗ global observables    |
+| **Devtools ecosystem**                    |       ⚠️ (nascent)       |           ✅          |           ⚠️          |               ⚠️               |              ⚠️             |
 
-```tsx
-useEffect(() => {
-  fetchData()
-}, [])
-```
 
-✅ Correct
 
-```ts
-emit("data:fetch")
-```
+<b>⚠️ via selectors, not a true dependency graph. </b>
 
 ---
 
-### ❌ Mutating state directly
+## ❓ Why not Redux + RTK?
 
-```ts
-runtime.state.user.name = "admin"
-```
+Redux focuses on state transitions.
 
-✅ Correct
+logic-runtime-react-z models system behavior.
 
-```ts
-emit("update:user:name", "admin")
-```
+In Redux:
+- async flow is external (thunk/saga)
+- effects are not first-class
+- execution model depends on middleware setup
 
----
+In logic-runtime-react-z:
+- async orchestration is built-in
+- intent is the only entry point
+- execution order is guaranteed
 
-### ❌ Generic Redux-style intents
 
-```ts
-emit("SET_STATE", { loading: true })
-```
+---
 
-✅ Correct
+## 🧠 One-liner Takeaway
 
-```ts
-emit("login:start")
-emit("login:success", user)
-emit("login:failed", error)
-```
+- Redux & Zustand manage **state**
+- logic-runtime-react-z orchestrates **logic**
 
 ---
 
-## 🧩 When to Use This
-
-- Complex async flows
-- Shared logic across UI / backend
-- Need deterministic tests
-- Want to remove logic from React
+## 🧬 Deterministic Execution Model
 
-## 🚫 When NOT to Use
+- Intents are processed sequentially
+- State mutations are isolated
+- Async effects follow declared strategies (takeLatest, debounce, etc.)
+- Execution order is predictable
 
-- Simple local UI state
-- Throwaway components
+Given the same intent sequence, the resulting state is reproducible.
 
 ---
 
-## 🔍 Comparison with: Redux vs Zustand 
-
-| Capability / Library     | logic-runtime-react-z | Redux | Zustand |
-|--------------------------|:---------------------:|:-----:|:-------:|
-| Intent-first model       | ✅                    | ❌    | ❌       |
-| State-first model        | ❌                    | ✅    | ✅       |
-| First-class effects      | ✅                    | ❌    | ❌       |
-| Built-in async handling  | ✅                    | ❌    | ❌       |
-| Computed state graph     | ✅                    | ❌    | ⚠️       |
-| Deterministic execution  | ✅                    | ❌    | ❌       |
-| Logic outside React      | ✅                    | ❌    | ❌       |
-| Backend-safe             | ✅                    | ❌    | ❌       |
-| Intent / effect tracing  | ✅                    | ❌    | ❌       |
-| Centralized state store  | ❌                    | ✅    | ✅       |
-| Easy global state        | ⚠️                    | ✅    | ✅       |
-| Minimal boilerplate      | ✅                    | ❌    | ✅       |
+## 📐 Architecture Diagram (High-level)
 
 ```bash
-Redux / Zustand:
-UI → setState → store → re-render
-
-logic-runtime-react-z:
-UI → intent → logic → effect → state
+┌─────────────┐
+│   React UI  │
+└──────┬──────┘
+       │ adapter
+┌──────▼──────┐
+│   Runtime   │
+│  (create)   │
+├─────────────┤
+│  Intent Bus │
+│  Effects    │
+│  Handlers   │
+│  State      │
+│  Computed   │
+└─────────────┘
 ```
 
-### One-liner takeaway
-- Redux and Zustand manage **state**.
-- logic-runtime-react-z orchestrates **logic**.
+<b>Runtime is the product. React is an adapter.</b>
+
+---
+
+## ⚠️ When Not to Use
+
+- Simple local component state
+- Small apps without async complexity
+- Teams unfamiliar with event-driven models
 
 ---
 
+
 ## License
 
 MIT

package/build/core/effect.d.ts

@@ -2,6 +2,7 @@ export type EffectStrategy = "default" | "takeLatest" | "debounce";
 export type EffectHandler<S = any> = (context: S) => void | Promise<void>;
 export type EffectDef<S = any> = {
     _kind: "effect";
+    id: symbol;
     handler: EffectHandler<S>;
     strategy: EffectStrategy;
     wait: number;
@@ -11,6 +12,7 @@ export declare function effect<S = any>(fn: EffectHandler<S>): {
         takeLatest(): any;
         debounce(ms: number): any;
         _kind: "effect";
+        id: symbol;
         handler: EffectHandler<S>;
         strategy: EffectStrategy;
         wait: number;
@@ -19,11 +21,13 @@ export declare function effect<S = any>(fn: EffectHandler<S>): {
         takeLatest(): any;
         debounce(ms: number): any;
         _kind: "effect";
+        id: symbol;
         handler: EffectHandler<S>;
         strategy: EffectStrategy;
         wait: number;
     };
     _kind: "effect";
+    id: symbol;
     handler: EffectHandler<S>;
     strategy: EffectStrategy;
     wait: number;

package/build/core/runtime.d.ts

@@ -1,26 +1,39 @@
-import { Atom } from "chrono-state-z/build/core/atom";
+import type { Atom } from "chrono-state-z/build/core/atom";
 import { Scope } from "intentx-core-z";
 import { EffectDef } from "./effect";
 export type AtomAccessor<T> = Atom<T>;
-export declare class LogicRuntime<S extends object, A extends Record<string, any> = {}> {
+export type ComputedDef<S> = Record<string, (context: {
+    state: Readonly<S>;
+}) => any>;
+export type InferComputed<C> = {
+    [K in keyof C]: C[K] extends (...args: any[]) => infer R ? R : never;
+};
+export declare class LogicRuntime<S extends object, C extends ComputedDef<S>, A extends Record<string, any>> {
     readonly scope: Scope;
-    private atoms;
+    private stateAtoms;
+    private computedAtoms;
     private subs;
     private bus;
     private snapshotCache;
     private dirty;
     private isComputing;
+    private computedKeys;
     actions: A;
     constructor(initial: S, scope?: Scope);
-    private createAtoms;
+    private createStateAtoms;
     private buildSnapshot;
     private markDirty;
-    getSnapshot: () => Readonly<S>;
+    private createReactiveState;
+    getSnapshot: () => Readonly<S & InferComputed<C>>;
     subscribe: (fn: () => void) => () => boolean;
+    get state(): Readonly<S & InferComputed<C>>;
+    get computed(): Readonly<InferComputed<C>>;
+    getComputedKey<K extends keyof InferComputed<C>>(key: K): InferComputed<C>[K];
+    getComputed(snapshot: Readonly<S & InferComputed<C>>): Readonly<InferComputed<C>>;
     private setStateInternal;
     onIntent: <P = any>(type: string, handler: (context: {
         payload: P;
-        state: () => Readonly<S>;
+        state: () => Readonly<S & InferComputed<C>>;
         scope: Scope;
         signal: AbortSignal;
         setState(fn: (draft: S) => void): void;
@@ -28,5 +41,5 @@ export declare class LogicRuntime<S extends object, A extends Record<string, any
     }) => any) => void;
     useEffect(type: string, eff: EffectDef): void;
     emit: <P = any>(type: string, payload?: P) => Promise<void>;
-    attachComputed<K extends string, T>(key: K, compute: () => T): void;
+    attachComputed<K extends keyof C & string>(key: K, compute: C[K]): void;
 }

package/build/index.cjs.js

@@ -1 +1 @@
-"use strict";var t=require("chrono-state-z"),e=require("intentx-core-z"),n=require("react/jsx-runtime"),s=require("react");function o(t){var e=Object.create(null);return t&&Object.keys(t).forEach(function(n){if("default"!==n){var s=Object.getOwnPropertyDescriptor(t,n);Object.defineProperty(e,n,s.get?s:{enumerable:!0,get:function(){return t[n]}})}}),e.default=t,Object.freeze(e)}var r=o(s);class i{constructor(){this.handlers={},this.effects={},this.middlewares=[]}use(t){this.middlewares.push(t)}effect(t,e){var n,s;(null!==(n=(s=this.effects)[t])&&void 0!==n?n:s[t]=[]).push(e)}on(t,e){var n,s;const o=this.handlers[t];o&&o.length>0?console.warn(`[IntentBus] Duplicate intent handler "${t}" detected. Only the first handler will be used.`):(null!==(n=(s=this.handlers)[t])&&void 0!==n?n:s[t]=[]).push(e)}async emit(t,e){var n,s;const o=null!==(n=this.handlers[t])&&void 0!==n?n:[],r=null!==(s=this.effects[t])&&void 0!==s?s:[],i=(a=this.middlewares,c=async t=>{t.effects=r;for(const e of o)await e(t)},a.reduceRight((t,e)=>e(t),c));var a,c;await i(e)}}class a{constructor(t,n=e.createScope("logic")){this.subs=new Set,this.bus=new i,this.dirty=!0,this.isComputing=!1,this.markDirty=()=>{this.dirty=!0,this.subs.forEach(t=>t())},this.getSnapshot=()=>(this.dirty&&(this.snapshotCache=this.buildSnapshot(),this.dirty=!1),this.snapshotCache),this.subscribe=t=>(this.subs.add(t),()=>this.subs.delete(t)),this.onIntent=(t,e)=>{this.bus.on(t,e)},this.emit=async(t,e)=>{const n=new AbortController;await this.bus.emit(t,{payload:e,scope:this.scope,signal:n.signal,state:this.getSnapshot,setState:t=>this.setStateInternal(t),emit:this.emit})},this.scope=n,this.atoms=this.createAtoms(t);for(const t in this.atoms)this.atoms[t].subscribe(this.markDirty);this.bus.use(function(){const t=new Map,e=new Map;return n=>async s=>{var o;const r=s.effects;if(!(null==r?void 0:r.length))return n(s);for(const n of r){const r=n.handler.toString();if("takeLatest"===n.strategy){null===(o=t.get(r))||void 0===o||o.abort();const e=new AbortController;t.set(r,e),await n.handler({...s,signal:e.signal})}else"debounce"===n.strategy?(clearTimeout(e.get(r)),e.set(r,setTimeout(()=>n.handler(s),n.wait))):await n.handler(s)}await n(s)}}())}createAtoms(e){const n={};for(const s in e)n[s]=t.atom(e[s]);return n}buildSnapshot(){const t={};for(const e in this.atoms)t[e]=this.atoms[e]();return t}setStateInternal(t){this.isComputing&&console.warn("[logic-runtime] Side-effect detected: setState() called inside computed()");const e=this.buildSnapshot();t(e);for(const t in e)e[t]!==this.atoms[t]()&&this.atoms[t].set(e[t])}useEffect(t,e){this.bus.effect(t,e)}attachComputed(e,n){const s=t.atom(void 0);t.effect(()=>{this.isComputing=!0;const t=n();s.set(t),this.isComputing=!1}),this.atoms[e]=s,s.subscribe(this.markDirty)}}function c(t){const e=function(){let t=0,e=[];return{get records(){return e.slice()},record:function(n){e.push({...n,id:++t,state:structuredClone(n.state)})},replay:async function(t,n){const{from:s=0,to:o=1/0,scope:r}=null!=n?n:{},i=e.filter(t=>"emit"===t.type&&t.id>=s&&t.id<=o&&(!r||t.scope===r));for(const e of i){const n=t(e.intent,e.payload);n instanceof Promise&&await n}},clear:function(){e=[],t=0}}}();function n(){return"string"==typeof t.scope?t.scope:t.scope.name}return{timeline:e,wrap:function(){const s=t.emit.bind(t);t.emit=async(o,r)=>{e.record({type:"emit:start",intent:o,payload:r,scope:n(),state:t.getSnapshot(),timestamp:Date.now()});try{const t=s(o,r);t instanceof Promise&&await t}finally{e.record({type:"emit:end",intent:o,payload:r,scope:n(),state:t.getSnapshot(),timestamp:Date.now()})}}}}}function u(t){var n;const o=s.useRef(null),r=null!=t&&"function"==typeof t.subscribe&&"function"==typeof t.getSnapshot?t:null!==(n=o.current)&&void 0!==n?n:o.current=t.create(e.createScope("react"));return s.useSyncExternalStore(r.subscribe,r.getSnapshot,r.getSnapshot)}Object.defineProperty(exports,"createSelector",{enumerable:!0,get:function(){return t.createSelector}}),exports.LogicRuntime=a,exports.attachDevtools=c,exports.composeLogic=function(t){return{create(e){const n={};for(const s in t){const o=s;n[o]=t[o].create(e)}return{async emit(t,e){for(const s of Object.values(n))await s.emit(t,e)},subscribe(t){const e=Object.values(n).map(e=>e.subscribe(t));return()=>e.forEach(t=>t())},getSnapshot(){const t={};for(const e in n)t[e]=n[e].getSnapshot();return t},runtimes:n}}}},exports.createBackendRuntime=function(t){var n,s;let o=structuredClone(t);const r=()=>o,i=t=>{o={...o,...t}},a=e.createScope("backend");async function u(t,e){await l.emit(t,e,a)}const l=e.createIntentBus(t=>{const e=new AbortController;return{scope:a,payload:t,signal:e.signal,get state(){return r()},setState(){throw new Error("setState is not allowed in backend runtime")},emit:u}}),h={state:r,reset:()=>{o=structuredClone(t)},emit:u,registerIntents:function(t){for(const e in t){const n=t[e];l.on(e,async(t,e)=>{var s;const o={get state(){return r()},signal:null!==(s=t.signal)&&void 0!==s?s:(new AbortController).signal,set:i,emit:u};await n(o)},a)}},onIntent:l.on,effect:l.effect};if("production"!==(null===(s=null===(n=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===n?void 0:n.env)||void 0===s?void 0:s.NODE_ENV)){const t=c(h);t.wrap(h),h.devtools=t}return h},exports.createLogic=function(t){return{name:t.name,create(e){var n;const s=new a(structuredClone(t.state),e);if(t.computed)for(const e in t.computed)s.attachComputed(e,()=>t.computed[e]({state:s.getSnapshot()}));null===(n=t.intents)||void 0===n||n.call(t,{on:s.onIntent,effect:s.useEffect.bind(s)});const o={};if(t.actions)for(const e in t.actions)o[e]=t.actions[e]({emit:s.emit,getState:s.getSnapshot});return s.actions=o,s}}},exports.effect=function(t){const e={_kind:"effect",handler:t,strategy:"default",wait:0};return{...e,takeLatest(){return e.strategy="takeLatest",this},debounce(t){return e.strategy="debounce",e.wait=t,this}}},exports.useActions=function(t){return(null!=t&&"actions"in t?t:u(t)).actions},exports.useLogicSelector=function(e,n){const o=s.useMemo(()=>t.createSelector(n),[n]);return s.useSyncExternalStore(e.subscribe,()=>o(e.getSnapshot()),()=>o(e.getSnapshot()))},exports.useRuntime=u,exports.withLogic=function(t,s,o){var i,a;const c=i=>{const a=r.useRef(null);a.current||(a.current=t.create("string"==typeof o?e.createScope(o):o));const c=a.current,u=r.useSyncExternalStore(c.subscribe,c.getSnapshot,c.getSnapshot),l=r.useCallback((t,e)=>c.emit(t,e),[c]),h=r.useMemo(()=>({state:u,actions:c.actions,emit:l}),[u,l,c]);return n.jsx(s,{...i,...h})};return c.displayName=`withLogic(${null!==(a=null!==(i=s.displayName)&&void 0!==i?i:s.name)&&void 0!==a?a:"View"})`,c};
+"use strict";var t=require("chrono-state-z"),e=require("intentx-core-z"),s=require("react/jsx-runtime"),n=require("react");function o(t){var e=Object.create(null);return t&&Object.keys(t).forEach(function(s){if("default"!==s){var n=Object.getOwnPropertyDescriptor(t,s);Object.defineProperty(e,s,n.get?n:{enumerable:!0,get:function(){return t[s]}})}}),e.default=t,Object.freeze(e)}var r=o(n);class i{constructor(){this.handlers={},this.effects={},this.middlewares=[]}use(t){this.middlewares.push(t)}effect(t,e){var s,n;(null!==(s=(n=this.effects)[t])&&void 0!==s?s:n[t]=[]).push(e)}on(t,e){var s,n;const o=this.handlers[t];o&&o.length>0?console.warn(`[IntentBus] Duplicate intent handler "${t}" detected. Only the first handler will be used.`):(null!==(s=(n=this.handlers)[t])&&void 0!==s?s:n[t]=[]).push(e)}async emit(t,e){var s,n;const o=null!==(s=this.handlers[t])&&void 0!==s?s:[],r=null!==(n=this.effects[t])&&void 0!==n?n:[],i=(c=this.middlewares,a=async t=>{t.effects=r;for(const e of o)await e(t)},c.reduceRight((t,e)=>e(t),a));var c,a;await i(e)}}class c{constructor(t,s=e.createScope("logic")){this.computedAtoms={},this.subs=new Set,this.bus=new i,this.dirty=!0,this.isComputing=!1,this.computedKeys=new Set,this.markDirty=()=>{this.dirty=!0,this.subs.forEach(t=>t())},this.getSnapshot=()=>(this.dirty&&(this.snapshotCache=this.buildSnapshot(),this.dirty=!1),this.snapshotCache),this.subscribe=t=>(this.subs.add(t),()=>this.subs.delete(t)),this.onIntent=(t,e)=>{this.bus.on(t,e)},this.emit=async(t,e)=>{const s=new AbortController;await this.bus.emit(t,{payload:e,scope:this.scope,signal:s.signal,state:this.getSnapshot,setState:t=>this.setStateInternal(t),emit:this.emit})},this.scope=s,this.stateAtoms=this.createStateAtoms(t);for(const t in this.stateAtoms)this.stateAtoms[t].subscribe(this.markDirty);this.bus.use(function(){const t=new Map,e=new Map;return s=>async n=>{var o;const r=n.effects;if(!(null==r?void 0:r.length))return s(n);for(const s of r){const r=s.id;if("takeLatest"===s.strategy){null===(o=t.get(r))||void 0===o||o.abort();const e=new AbortController;t.set(r,e),await s.handler({...n,signal:e.signal})}else"debounce"===s.strategy?(clearTimeout(e.get(r)),e.set(r,setTimeout(()=>s.handler(n),s.wait))):await s.handler(n)}await s(n)}}())}createStateAtoms(e){const s={};for(const n in e)s[n]=t.atom(e[n]);return s}buildSnapshot(){const t={};for(const e in this.stateAtoms)t[e]=this.stateAtoms[e]();for(const e in this.computedAtoms)t[e]=this.computedAtoms[e]();return t}createReactiveState(){return new Proxy({},{get:(t,e)=>{const s=this.stateAtoms[e];return s?s():void 0}})}get state(){return this.getSnapshot()}get computed(){const t={};return this.computedKeys.forEach(e=>{t[e]=this.computedAtoms[e]()}),t}getComputedKey(t){return this.computedAtoms[t]()}getComputed(t){const e={};return this.computedKeys.forEach(s=>{e[s]=t[s]}),e}setStateInternal(t){this.isComputing&&console.warn("[logic-runtime] setState() called inside computed()");const e={};for(const t in this.stateAtoms)e[t]=this.stateAtoms[t]();t(e);for(const t in this.stateAtoms)e[t]!==this.stateAtoms[t]()&&this.stateAtoms[t].set(e[t])}useEffect(t,e){this.bus.effect(t,e)}attachComputed(e,s){const n=t.atom(void 0),o=this.createReactiveState();this.computedAtoms[e]=n,this.computedKeys.add(e),t.effect(()=>{this.isComputing=!0,n.set(s({state:o})),this.isComputing=!1}),n.subscribe(this.markDirty)}}function a(t){const e=function(){let t=0,e=[];return{get records(){return e.slice()},record:function(s){e.push({...s,id:++t,state:structuredClone(s.state)})},replay:async function(t,s){const{from:n=0,to:o=1/0,scope:r}=null!=s?s:{},i=e.filter(t=>"emit"===t.type&&t.id>=n&&t.id<=o&&(!r||t.scope===r));for(const e of i){const s=t(e.intent,e.payload);s instanceof Promise&&await s}},clear:function(){e=[],t=0}}}();function s(){return"string"==typeof t.scope?t.scope:t.scope.name}return{timeline:e,wrap:function(){const n=t.emit.bind(t);t.emit=async(o,r)=>{e.record({type:"emit:start",intent:o,payload:r,scope:s(),state:t.getSnapshot(),timestamp:Date.now()});try{const t=n(o,r);t instanceof Promise&&await t}finally{e.record({type:"emit:end",intent:o,payload:r,scope:s(),state:t.getSnapshot(),timestamp:Date.now()})}}}}}function u(t){var s;const o=n.useRef(null),r=t&&"function"==typeof t.subscribe&&"function"==typeof t.getSnapshot?t:null!==(s=o.current)&&void 0!==s?s:o.current=t.create(e.createScope("react"));return n.useSyncExternalStore(r.subscribe,r.getSnapshot,r.getSnapshot)}Object.defineProperty(exports,"createSelector",{enumerable:!0,get:function(){return t.createSelector}}),exports.LogicRuntime=c,exports.attachDevtools=a,exports.composeLogic=function(t){const s=e.createScope("logic"),n={};for(const e in t)n[e]=t[e].create(s);const o={};for(const t in n)o[t]=n[t].actions;return{scope:s,runtimes:n,emit:async(t,e)=>{await Promise.all(Object.values(n).map(s=>s.emit(t,e)))},actions:o,getState:()=>{const t={};for(const e in n)t[e]=n[e].state;return t}}},exports.createBackendRuntime=function(t){var s,n;let o=structuredClone(t);const r=()=>o,i=t=>{o={...o,...t}},c=e.createScope("backend");async function u(t,e){await l.emit(t,e,c)}const l=e.createIntentBus(t=>{const e=new AbortController;return{scope:c,payload:t,signal:e.signal,get state(){return r()},setState(){throw new Error("setState is not allowed in backend runtime")},emit:u}}),h={state:r,reset:()=>{o=structuredClone(t)},emit:u,registerIntents:function(t){for(const e in t){const s=t[e];l.on(e,async(t,e)=>{var n;const o={get state(){return r()},signal:null!==(n=t.signal)&&void 0!==n?n:(new AbortController).signal,set:i,emit:u};await s(o)},c)}},onIntent:l.on,effect:l.effect};if("production"!==(null===(n=null===(s=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===s?void 0:s.env)||void 0===n?void 0:n.NODE_ENV)){const t=a(h);t.wrap(h),h.devtools=t}return h},exports.createLogic=function(t){return{name:t.name,create(e){var s;const n=new c(structuredClone(t.state),e);if(t.computed)for(const e in t.computed)n.attachComputed(e,t.computed[e]);null===(s=t.intents)||void 0===s||s.call(t,{on:n.onIntent,effect:n.useEffect.bind(n)});const o={};if(t.actions)for(const e in t.actions)o[e]=t.actions[e]({emit:n.emit,getState:n.getSnapshot});return n.actions=o,n}}},exports.effect=function(t){const e={_kind:"effect",id:Symbol("effect"),handler:t,strategy:"default",wait:0};return{...e,takeLatest(){return e.strategy="takeLatest",this},debounce(t){return e.strategy="debounce",e.wait=t,this}}},exports.useActions=function(t){return(t instanceof c?t:u(t).__runtime).actions},exports.useComputed=function(e,s){const o=e instanceof c?e:u(e).__runtime;if(!s)return n.useSyncExternalStore(o.subscribe,()=>o.getComputed(o.getSnapshot()),()=>o.getComputed(o.getSnapshot()));const r=n.useMemo(()=>t.createSelector(s),[s]);return n.useSyncExternalStore(o.subscribe,()=>r(o.getComputed(o.getSnapshot())),()=>r(o.getComputed(o.getSnapshot())))},exports.useLogic=function(t){const e=n.useSyncExternalStore(t.subscribe,t.getSnapshot,t.getSnapshot);return{state:e,computed:t.getComputed(e),actions:t.actions}},exports.useLogicSelector=function(e,s){const o=n.useMemo(()=>t.createSelector(s),[s]);return n.useSyncExternalStore(e.subscribe,()=>o(e.getSnapshot()),()=>o(e.getSnapshot()))},exports.useRuntime=u,exports.withLogic=function(t,n,o){var i,c;const a=i=>{const c=r.useRef(null);c.current||(c.current=t.create("string"==typeof o?e.createScope(o):o));const a=c.current,u=r.useSyncExternalStore(a.subscribe,a.getSnapshot,a.getSnapshot),l=r.useCallback((t,e)=>a.emit(t,e),[a]),h=r.useMemo(()=>({state:u,actions:a.actions,emit:l}),[u,l,a]);return s.jsx(n,{...i,...h})};return a.displayName=`withLogic(${null!==(c=null!==(i=n.displayName)&&void 0!==i?i:n.name)&&void 0!==c?c:"View"})`,a};

package/build/index.d.ts

@@ -8,7 +8,9 @@ export type { LogicFactory, LogicActions, } from "./logic/createLogic";
 export { composeLogic } from "./logic/composeLogic";
 export { createBackendRuntime } from "./logic/createBackendRuntime";
 export { withLogic } from "./react/withLogic";
-export { useRuntime } from "./react/useRuntime";
 export { useActions } from "./react/useActions";
+export { useComputed } from "./react/useComputed";
+export { useLogic } from "./react/useLogic";
 export { useLogicSelector } from "./react/useLogicSelector";
+export { useRuntime } from "./react/useRuntime";
 export * from "./devtools";

package/build/index.esm.js

@@ -1 +1 @@
-import{atom as t,effect as e,createSelector as s}from"chrono-state-z";export{createSelector}from"chrono-state-z";import{createScope as n,createIntentBus as o}from"intentx-core-z";import{jsx as i}from"react/jsx-runtime";import*as r from"react";import{useRef as a,useSyncExternalStore as c,useMemo as u}from"react";class l{constructor(){this.handlers={},this.effects={},this.middlewares=[]}use(t){this.middlewares.push(t)}effect(t,e){var s,n;(null!==(s=(n=this.effects)[t])&&void 0!==s?s:n[t]=[]).push(e)}on(t,e){var s,n;const o=this.handlers[t];o&&o.length>0?console.warn(`[IntentBus] Duplicate intent handler "${t}" detected. Only the first handler will be used.`):(null!==(s=(n=this.handlers)[t])&&void 0!==s?s:n[t]=[]).push(e)}async emit(t,e){var s,n;const o=null!==(s=this.handlers[t])&&void 0!==s?s:[],i=null!==(n=this.effects[t])&&void 0!==n?n:[],r=(a=this.middlewares,c=async t=>{t.effects=i;for(const e of o)await e(t)},a.reduceRight((t,e)=>e(t),c));var a,c;await r(e)}}class h{constructor(t,e=n("logic")){this.subs=new Set,this.bus=new l,this.dirty=!0,this.isComputing=!1,this.markDirty=()=>{this.dirty=!0,this.subs.forEach(t=>t())},this.getSnapshot=()=>(this.dirty&&(this.snapshotCache=this.buildSnapshot(),this.dirty=!1),this.snapshotCache),this.subscribe=t=>(this.subs.add(t),()=>this.subs.delete(t)),this.onIntent=(t,e)=>{this.bus.on(t,e)},this.emit=async(t,e)=>{const s=new AbortController;await this.bus.emit(t,{payload:e,scope:this.scope,signal:s.signal,state:this.getSnapshot,setState:t=>this.setStateInternal(t),emit:this.emit})},this.scope=e,this.atoms=this.createAtoms(t);for(const t in this.atoms)this.atoms[t].subscribe(this.markDirty);this.bus.use(function(){const t=new Map,e=new Map;return s=>async n=>{var o;const i=n.effects;if(!(null==i?void 0:i.length))return s(n);for(const s of i){const i=s.handler.toString();if("takeLatest"===s.strategy){null===(o=t.get(i))||void 0===o||o.abort();const e=new AbortController;t.set(i,e),await s.handler({...n,signal:e.signal})}else"debounce"===s.strategy?(clearTimeout(e.get(i)),e.set(i,setTimeout(()=>s.handler(n),s.wait))):await s.handler(n)}await s(n)}}())}createAtoms(e){const s={};for(const n in e)s[n]=t(e[n]);return s}buildSnapshot(){const t={};for(const e in this.atoms)t[e]=this.atoms[e]();return t}setStateInternal(t){this.isComputing&&console.warn("[logic-runtime] Side-effect detected: setState() called inside computed()");const e=this.buildSnapshot();t(e);for(const t in e)e[t]!==this.atoms[t]()&&this.atoms[t].set(e[t])}useEffect(t,e){this.bus.effect(t,e)}attachComputed(s,n){const o=t(void 0);e(()=>{this.isComputing=!0;const t=n();o.set(t),this.isComputing=!1}),this.atoms[s]=o,o.subscribe(this.markDirty)}}function f(t){const e={_kind:"effect",handler:t,strategy:"default",wait:0};return{...e,takeLatest(){return e.strategy="takeLatest",this},debounce(t){return e.strategy="debounce",e.wait=t,this}}}function d(t){return{name:t.name,create(e){var s;const n=new h(structuredClone(t.state),e);if(t.computed)for(const e in t.computed)n.attachComputed(e,()=>t.computed[e]({state:n.getSnapshot()}));null===(s=t.intents)||void 0===s||s.call(t,{on:n.onIntent,effect:n.useEffect.bind(n)});const o={};if(t.actions)for(const e in t.actions)o[e]=t.actions[e]({emit:n.emit,getState:n.getSnapshot});return n.actions=o,n}}}function m(t){return{create(e){const s={};for(const n in t){const o=n;s[o]=t[o].create(e)}return{async emit(t,e){for(const n of Object.values(s))await n.emit(t,e)},subscribe(t){const e=Object.values(s).map(e=>e.subscribe(t));return()=>e.forEach(t=>t())},getSnapshot(){const t={};for(const e in s)t[e]=s[e].getSnapshot();return t},runtimes:s}}}}function p(t){const e=function(){let t=0,e=[];return{get records(){return e.slice()},record:function(s){e.push({...s,id:++t,state:structuredClone(s.state)})},replay:async function(t,s){const{from:n=0,to:o=1/0,scope:i}=null!=s?s:{},r=e.filter(t=>"emit"===t.type&&t.id>=n&&t.id<=o&&(!i||t.scope===i));for(const e of r){const s=t(e.intent,e.payload);s instanceof Promise&&await s}},clear:function(){e=[],t=0}}}();function s(){return"string"==typeof t.scope?t.scope:t.scope.name}return{timeline:e,wrap:function(){const n=t.emit.bind(t);t.emit=async(o,i)=>{e.record({type:"emit:start",intent:o,payload:i,scope:s(),state:t.getSnapshot(),timestamp:Date.now()});try{const t=n(o,i);t instanceof Promise&&await t}finally{e.record({type:"emit:end",intent:o,payload:i,scope:s(),state:t.getSnapshot(),timestamp:Date.now()})}}}}}function g(t){var e,s;let i=structuredClone(t);const r=()=>i,a=t=>{i={...i,...t}},c=n("backend");async function u(t,e){await l.emit(t,e,c)}const l=o(t=>{const e=new AbortController;return{scope:c,payload:t,signal:e.signal,get state(){return r()},setState(){throw new Error("setState is not allowed in backend runtime")},emit:u}});const h={state:r,reset:()=>{i=structuredClone(t)},emit:u,registerIntents:function(t){for(const e in t){const s=t[e];l.on(e,async(t,e)=>{var n;const o={get state(){return r()},signal:null!==(n=t.signal)&&void 0!==n?n:(new AbortController).signal,set:a,emit:u};await s(o)},c)}},onIntent:l.on,effect:l.effect};if("production"!==(null===(s=null===(e=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===e?void 0:e.env)||void 0===s?void 0:s.NODE_ENV)){const t=p(h);t.wrap(h),h.devtools=t}return h}function b(t,e,s){var o,a;const c=o=>{const a=r.useRef(null);a.current||(a.current=t.create("string"==typeof s?n(s):s));const c=a.current,u=r.useSyncExternalStore(c.subscribe,c.getSnapshot,c.getSnapshot),l=r.useCallback((t,e)=>c.emit(t,e),[c]),h=r.useMemo(()=>({state:u,actions:c.actions,emit:l}),[u,l,c]);return i(e,{...o,...h})};return c.displayName=`withLogic(${null!==(a=null!==(o=e.displayName)&&void 0!==o?o:e.name)&&void 0!==a?a:"View"})`,c}function y(t){var e;const s=a(null),o=null!=t&&"function"==typeof t.subscribe&&"function"==typeof t.getSnapshot?t:null!==(e=s.current)&&void 0!==e?e:s.current=t.create(n("react"));return c(o.subscribe,o.getSnapshot,o.getSnapshot)}function w(t){return(null!=t&&"actions"in t?t:y(t)).actions}function v(t,e){const n=u(()=>s(e),[e]);return c(t.subscribe,()=>n(t.getSnapshot()),()=>n(t.getSnapshot()))}export{h as LogicRuntime,p as attachDevtools,m as composeLogic,g as createBackendRuntime,d as createLogic,f as effect,w as useActions,v as useLogicSelector,y as useRuntime,b as withLogic};
+import{atom as t,effect as e,createSelector as s}from"chrono-state-z";export{createSelector}from"chrono-state-z";import{createScope as n,createIntentBus as o}from"intentx-core-z";import{jsx as i}from"react/jsx-runtime";import*as r from"react";import{useRef as a,useSyncExternalStore as c,useMemo as u}from"react";class l{constructor(){this.handlers={},this.effects={},this.middlewares=[]}use(t){this.middlewares.push(t)}effect(t,e){var s,n;(null!==(s=(n=this.effects)[t])&&void 0!==s?s:n[t]=[]).push(e)}on(t,e){var s,n;const o=this.handlers[t];o&&o.length>0?console.warn(`[IntentBus] Duplicate intent handler "${t}" detected. Only the first handler will be used.`):(null!==(s=(n=this.handlers)[t])&&void 0!==s?s:n[t]=[]).push(e)}async emit(t,e){var s,n;const o=null!==(s=this.handlers[t])&&void 0!==s?s:[],i=null!==(n=this.effects[t])&&void 0!==n?n:[],r=(a=this.middlewares,c=async t=>{t.effects=i;for(const e of o)await e(t)},a.reduceRight((t,e)=>e(t),c));var a,c;await r(e)}}class h{constructor(t,e=n("logic")){this.computedAtoms={},this.subs=new Set,this.bus=new l,this.dirty=!0,this.isComputing=!1,this.computedKeys=new Set,this.markDirty=()=>{this.dirty=!0,this.subs.forEach(t=>t())},this.getSnapshot=()=>(this.dirty&&(this.snapshotCache=this.buildSnapshot(),this.dirty=!1),this.snapshotCache),this.subscribe=t=>(this.subs.add(t),()=>this.subs.delete(t)),this.onIntent=(t,e)=>{this.bus.on(t,e)},this.emit=async(t,e)=>{const s=new AbortController;await this.bus.emit(t,{payload:e,scope:this.scope,signal:s.signal,state:this.getSnapshot,setState:t=>this.setStateInternal(t),emit:this.emit})},this.scope=e,this.stateAtoms=this.createStateAtoms(t);for(const t in this.stateAtoms)this.stateAtoms[t].subscribe(this.markDirty);this.bus.use(function(){const t=new Map,e=new Map;return s=>async n=>{var o;const i=n.effects;if(!(null==i?void 0:i.length))return s(n);for(const s of i){const i=s.id;if("takeLatest"===s.strategy){null===(o=t.get(i))||void 0===o||o.abort();const e=new AbortController;t.set(i,e),await s.handler({...n,signal:e.signal})}else"debounce"===s.strategy?(clearTimeout(e.get(i)),e.set(i,setTimeout(()=>s.handler(n),s.wait))):await s.handler(n)}await s(n)}}())}createStateAtoms(e){const s={};for(const n in e)s[n]=t(e[n]);return s}buildSnapshot(){const t={};for(const e in this.stateAtoms)t[e]=this.stateAtoms[e]();for(const e in this.computedAtoms)t[e]=this.computedAtoms[e]();return t}createReactiveState(){return new Proxy({},{get:(t,e)=>{const s=this.stateAtoms[e];return s?s():void 0}})}get state(){return this.getSnapshot()}get computed(){const t={};return this.computedKeys.forEach(e=>{t[e]=this.computedAtoms[e]()}),t}getComputedKey(t){return this.computedAtoms[t]()}getComputed(t){const e={};return this.computedKeys.forEach(s=>{e[s]=t[s]}),e}setStateInternal(t){this.isComputing&&console.warn("[logic-runtime] setState() called inside computed()");const e={};for(const t in this.stateAtoms)e[t]=this.stateAtoms[t]();t(e);for(const t in this.stateAtoms)e[t]!==this.stateAtoms[t]()&&this.stateAtoms[t].set(e[t])}useEffect(t,e){this.bus.effect(t,e)}attachComputed(s,n){const o=t(void 0),i=this.createReactiveState();this.computedAtoms[s]=o,this.computedKeys.add(s),e(()=>{this.isComputing=!0,o.set(n({state:i})),this.isComputing=!1}),o.subscribe(this.markDirty)}}function m(t){const e={_kind:"effect",id:Symbol("effect"),handler:t,strategy:"default",wait:0};return{...e,takeLatest(){return e.strategy="takeLatest",this},debounce(t){return e.strategy="debounce",e.wait=t,this}}}function d(t){return{name:t.name,create(e){var s;const n=new h(structuredClone(t.state),e);if(t.computed)for(const e in t.computed)n.attachComputed(e,t.computed[e]);null===(s=t.intents)||void 0===s||s.call(t,{on:n.onIntent,effect:n.useEffect.bind(n)});const o={};if(t.actions)for(const e in t.actions)o[e]=t.actions[e]({emit:n.emit,getState:n.getSnapshot});return n.actions=o,n}}}function p(t){const e=n("logic"),s={};for(const n in t)s[n]=t[n].create(e);const o={};for(const t in s)o[t]=s[t].actions;return{scope:e,runtimes:s,emit:async(t,e)=>{await Promise.all(Object.values(s).map(s=>s.emit(t,e)))},actions:o,getState:()=>{const t={};for(const e in s)t[e]=s[e].state;return t}}}function f(t){const e=function(){let t=0,e=[];return{get records(){return e.slice()},record:function(s){e.push({...s,id:++t,state:structuredClone(s.state)})},replay:async function(t,s){const{from:n=0,to:o=1/0,scope:i}=null!=s?s:{},r=e.filter(t=>"emit"===t.type&&t.id>=n&&t.id<=o&&(!i||t.scope===i));for(const e of r){const s=t(e.intent,e.payload);s instanceof Promise&&await s}},clear:function(){e=[],t=0}}}();function s(){return"string"==typeof t.scope?t.scope:t.scope.name}return{timeline:e,wrap:function(){const n=t.emit.bind(t);t.emit=async(o,i)=>{e.record({type:"emit:start",intent:o,payload:i,scope:s(),state:t.getSnapshot(),timestamp:Date.now()});try{const t=n(o,i);t instanceof Promise&&await t}finally{e.record({type:"emit:end",intent:o,payload:i,scope:s(),state:t.getSnapshot(),timestamp:Date.now()})}}}}}function g(t){var e,s;let i=structuredClone(t);const r=()=>i,a=t=>{i={...i,...t}},c=n("backend");async function u(t,e){await l.emit(t,e,c)}const l=o(t=>{const e=new AbortController;return{scope:c,payload:t,signal:e.signal,get state(){return r()},setState(){throw new Error("setState is not allowed in backend runtime")},emit:u}});const h={state:r,reset:()=>{i=structuredClone(t)},emit:u,registerIntents:function(t){for(const e in t){const s=t[e];l.on(e,async(t,e)=>{var n;const o={get state(){return r()},signal:null!==(n=t.signal)&&void 0!==n?n:(new AbortController).signal,set:a,emit:u};await s(o)},c)}},onIntent:l.on,effect:l.effect};if("production"!==(null===(s=null===(e=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===e?void 0:e.env)||void 0===s?void 0:s.NODE_ENV)){const t=f(h);t.wrap(h),h.devtools=t}return h}function b(t,e,s){var o,a;const c=o=>{const a=r.useRef(null);a.current||(a.current=t.create("string"==typeof s?n(s):s));const c=a.current,u=r.useSyncExternalStore(c.subscribe,c.getSnapshot,c.getSnapshot),l=r.useCallback((t,e)=>c.emit(t,e),[c]),h=r.useMemo(()=>({state:u,actions:c.actions,emit:l}),[u,l,c]);return i(e,{...o,...h})};return c.displayName=`withLogic(${null!==(a=null!==(o=e.displayName)&&void 0!==o?o:e.name)&&void 0!==a?a:"View"})`,c}function y(t){var e;const s=a(null),o=t&&"function"==typeof t.subscribe&&"function"==typeof t.getSnapshot?t:null!==(e=s.current)&&void 0!==e?e:s.current=t.create(n("react"));return c(o.subscribe,o.getSnapshot,o.getSnapshot)}function w(t){return(t instanceof h?t:y(t).__runtime).actions}function S(t,e){const n=t instanceof h?t:y(t).__runtime;if(!e)return c(n.subscribe,()=>n.getComputed(n.getSnapshot()),()=>n.getComputed(n.getSnapshot()));const o=u(()=>s(e),[e]);return c(n.subscribe,()=>o(n.getComputed(n.getSnapshot())),()=>o(n.getComputed(n.getSnapshot())))}function v(t){const e=c(t.subscribe,t.getSnapshot,t.getSnapshot);return{state:e,computed:t.getComputed(e),actions:t.actions}}function C(t,e){const n=u(()=>s(e),[e]);return c(t.subscribe,()=>n(t.getSnapshot()),()=>n(t.getSnapshot()))}export{h as LogicRuntime,f as attachDevtools,p as composeLogic,g as createBackendRuntime,d as createLogic,m as effect,w as useActions,S as useComputed,v as useLogic,C as useLogicSelector,y as useRuntime,b as withLogic};

package/build/logic/composeLogic.d.ts

@@ -1,18 +1,21 @@
+import { Scope } from "intentx-core-z";
+import type { ComputedDef, InferComputed } from "../core/runtime";
 import { LogicRuntime } from "../core/runtime";
 import type { LogicFactory } from "../logic/createLogic";
-type LogicMap = Record<string, LogicFactory<any, any>>;
-type RuntimeMap<M extends LogicMap> = {
-    [K in keyof M]: ReturnType<M[K]["create"]>;
+type AnyLogicFactory = LogicFactory<any, ComputedDef<any>, any>;
+type LogicMap = Record<string, AnyLogicFactory>;
+type InferRuntime<L> = L extends LogicFactory<infer S, infer C, infer A> ? LogicRuntime<S, C, A> : never;
+type InferState<M extends LogicMap> = {
+    [K in keyof M]: InferRuntime<M[K]> extends LogicRuntime<infer S, infer C, any> ? Readonly<S & InferComputed<C>> : never;
 };
-type SnapshotOf<M extends LogicMap> = {
-    [K in keyof M]: ReturnType<M[K]["create"]> extends LogicRuntime<infer S extends object, any> ? Readonly<S> : never;
+type InferActions<M extends LogicMap> = {
+    [K in keyof M]: InferRuntime<M[K]> extends LogicRuntime<any, any, infer A> ? A : never;
 };
-export declare function composeLogic<M extends LogicMap>(logics: M): {
-    create(scope?: any): {
-        emit(intent: string, payload?: any): Promise<void>;
-        subscribe(fn: () => void): () => void;
-        getSnapshot(): SnapshotOf<M>;
-        runtimes: RuntimeMap<M>;
-    };
+export declare function composeLogic<M extends LogicMap>(map: M): {
+    scope: Scope;
+    runtimes: { [K in keyof M]: InferRuntime<M[K]>; };
+    emit: <P = any>(type: string, payload?: P) => Promise<void>;
+    actions: InferActions<M>;
+    getState: () => InferState<M>;
 };
 export {};

package/build/logic/createLogic.d.ts

@@ -1,28 +1,23 @@
 import { Scope } from "intentx-core-z";
-import { LogicRuntime } from "../core/runtime";
+import { LogicRuntime, ComputedDef, InferComputed } from "../core/runtime";
 import { EffectDef } from "../core/effect";
-type ComputedFactory<S> = (context: {
-    state: Readonly<S>;
-}) => any;
-type ActionFactory<S extends object, Fn extends (...args: any[]) => any> = (context: {
-    emit: LogicRuntime<S, any>["emit"];
-    getState: () => Readonly<S>;
-}) => Fn;
 export type LogicActions = Record<string, (...args: any[]) => any>;
-export type LogicFactory<S extends object, A extends LogicActions> = {
+export type LogicFactory<S extends object, C extends ComputedDef<S>, A extends LogicActions> = {
     name?: string;
-    create(scope?: Scope): LogicRuntime<S, A>;
+    create(scope?: Scope): LogicRuntime<S, C, A>;
 };
-export declare function createLogic<S extends object, A extends LogicActions>(config: {
+export declare function createLogic<S extends object, C extends ComputedDef<S> = {}, A extends LogicActions = {}>(config: {
     name?: string;
     state: S;
-    computed?: Record<string, ComputedFactory<S>>;
+    computed?: C;
     intents?: (bus: {
-        on: LogicRuntime<S>["onIntent"];
+        on: LogicRuntime<S, C, A>["onIntent"];
         effect: (type: string, eff: EffectDef) => void;
     }) => void;
     actions?: {
-        [K in keyof A]: ActionFactory<S, A[K]>;
+        [K in keyof A]: (context: {
+            emit: LogicRuntime<S, C, A>["emit"];
+            getState: () => Readonly<S & InferComputed<C>>;
+        }) => A[K];
     };
-}): LogicFactory<S, A>;
-export {};
+}): LogicFactory<S, C, A>;

package/build/react/useActions.d.ts

@@ -1,6 +1,4 @@
-import { LogicActions, LogicFactory } from "../logic/createLogic";
-import { LogicRuntime } from "../core/runtime";
-export declare function useActions<A extends object>(runtime: LogicRuntime<any> & {
-    actions: A;
-}): A;
-export declare function useActions<S extends object, A extends LogicActions>(logic: LogicFactory<S, A>): A;
+import { LogicFactory, LogicActions } from "../logic/createLogic";
+import { LogicRuntime, ComputedDef } from "../core/runtime";
+export declare function useActions<A extends LogicActions>(runtime: LogicRuntime<any, any, A>): A;
+export declare function useActions<S extends object, C extends ComputedDef<S>, A extends LogicActions>(logic: LogicFactory<S, C, A>): A;

package/build/react/useComputed.d.ts

@@ -0,0 +1,6 @@
+import { LogicFactory } from "../logic/createLogic";
+import { LogicRuntime, ComputedDef, InferComputed } from "../core/runtime";
+export declare function useComputed<S extends object, C extends ComputedDef<S>>(runtime: LogicRuntime<S, C, any>): Readonly<InferComputed<C>>;
+export declare function useComputed<S extends object, C extends ComputedDef<S>, R>(runtime: LogicRuntime<S, C, any>, selector: (computed: Readonly<InferComputed<C>>) => R): R;
+export declare function useComputed<S extends object, C extends ComputedDef<S>, A extends Record<string, any>>(logic: LogicFactory<S, C, A>): Readonly<InferComputed<C>>;
+export declare function useComputed<S extends object, C extends ComputedDef<S>, A extends Record<string, any>, R>(logic: LogicFactory<S, C, A>, selector: (computed: Readonly<InferComputed<C>>) => R): R;

package/build/react/useLogic.d.ts

@@ -0,0 +1,6 @@
+import { LogicRuntime, InferComputed } from "../core/runtime";
+export declare function useLogic<S extends object, C extends Record<string, any>, A extends Record<string, any>>(runtime: LogicRuntime<S, C, A>): {
+    state: Readonly<S & InferComputed<C>>;
+    computed: Readonly<InferComputed<C>>;
+    actions: A;
+};

package/build/react/useLogicSelector.d.ts

@@ -1,2 +1,2 @@
-import { LogicRuntime } from "../core/runtime";
-export declare function useLogicSelector<S extends object, R>(runtime: LogicRuntime<S>, selector: (state: Readonly<S>) => R): R;
+import { LogicRuntime, InferComputed } from "../core/runtime";
+export declare function useLogicSelector<S extends object, C extends Record<string, any>, R>(runtime: LogicRuntime<S, C, any>, selector: (state: Readonly<S & InferComputed<C>>) => R): R;

package/build/react/useRuntime.d.ts

@@ -1,4 +1,5 @@
+import type { ComputedDef, InferComputed } from "../core/runtime";
 import { LogicRuntime } from "../core/runtime";
-import { LogicFactory } from "../logic/createLogic";
-export declare function useRuntime<S extends object>(runtime: LogicRuntime<S>): Readonly<S>;
-export declare function useRuntime<S extends object, A extends Record<string, any>>(logic: LogicFactory<S, A>): Readonly<S>;
+import type { LogicFactory } from "../logic/createLogic";
+export declare function useRuntime<S extends object, C extends ComputedDef<S>, A extends Record<string, any>>(runtime: LogicRuntime<S, C, A>): Readonly<S & InferComputed<C>>;
+export declare function useRuntime<S extends object, C extends ComputedDef<S>, A extends Record<string, any>>(logic: LogicFactory<S, C, A>): Readonly<S & InferComputed<C>>;

package/build/react/withLogic.d.ts

@@ -1,10 +1,11 @@
 import * as React from "react";
 import { Scope } from "intentx-core-z";
-import { LogicActions, LogicFactory } from "../logic/createLogic";
-type InjectedProps<S extends object, A extends LogicActions> = {
-    state: Readonly<S>;
+import type { LogicActions, LogicFactory } from "../logic/createLogic";
+import type { ComputedDef, InferComputed } from "../core/runtime";
+type InjectedProps<S extends object, C extends ComputedDef<S>, A extends LogicActions> = {
+    state: Readonly<S & InferComputed<C>>;
     actions: A;
     emit: (intent: string, payload?: any) => Promise<void>;
 };
-export declare function withLogic<S extends object, A extends LogicActions, P extends object>(logic: LogicFactory<S, A>, View: React.ComponentType<P & InjectedProps<S, A>>, scope?: Scope | string): React.FC<Omit<P, keyof InjectedProps<S, A>>>;
+export declare function withLogic<S extends object, C extends ComputedDef<S>, A extends LogicActions, P extends object>(logic: LogicFactory<S, C, A>, View: React.ComponentType<P & InjectedProps<S, C, A>>, scope?: Scope | string): React.FC<Omit<P, keyof InjectedProps<S, C, A>>>;
 export {};

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "logic-runtime-react-z",
-  "version": "3.1.0",
-  "description": "Intent-first business logic runtime. Headless and backend-friendly. Deterministic state, computed graph, and orchestrated async effects. React is just a view layer.",
+  "version": "3.1.2",
+  "description": "Intent-first business logic runtime. Deterministic, headless, and framework-agnostic.",
   "license": "MIT",
   "author": "Delpi.Kye",
   "sideEffects": false,
+
   "main": "build/index.cjs.js",
   "module": "build/index.esm.js",
   "types": "build/index.d.ts",
@@ -28,12 +29,14 @@
   "files": [
     "build"
   ],
+
   "scripts": {
     "clean": "rimraf build",
     "build": "rollup -c",
     "cb": "npm run clean && npm run build",
     "prepublishOnly": "npm run cb"
   },
+
   "repository": {
     "type": "git",
     "url": "https://github.com/delpikye-v/logic-runtime-react.git"
@@ -42,6 +45,7 @@
   "bugs": {
     "url": "https://github.com/delpikye-v/logic-runtime-react/issues"
   },
+
   "keywords": [
     "intent-first",
     "intent-runtime",
@@ -60,6 +64,7 @@
     "takeLatest",
     "state-management"
   ],
+
   "peerDependencies": {
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"