logic-runtime-react-z 3.1.1 → 3.1.3

package/README.md

@@ -4,13 +4,12 @@
 
 <a href="https://codesandbox.io/p/sandbox/jnd992" target="_blank">LIVE EXAMPLE</a>
 
-**Intent-first business logic runtime**: React is a **view** — logic lives **elsewhere**.
+**Intent-First Business Logic Runtime.**. React is a view layer. Business logic lives elsewhere.  
 
-A headless, deterministic, intent-driven runtime for frontend & backend logic.
-React components stay pure. Business logic is fully testable, replayable, and framework-agnostic.
+A headless, deterministic, intent-driven runtime for frontend and backend systems.  
 
-> **Intent is the only entry point.**
-> **React is optional. createLogic is the product. Everything else is an adapter.**
+> **Intent is the only entry point. Logic is deterministic.**
+> **React is optional** — `createLogic` is the product; everything else is an adapter.
 
 ---
 
@@ -59,7 +58,7 @@ npm install logic-runtime-react-z
 import { createLogic } from "logic-runtime-react-z"
 
 const counterLogic = createLogic({
-  state: { count: 0 },
+  state: { count: 0, loading: false },
 
   intents: bus => {
     bus.on("inc", ({ setState }) => {
@@ -73,6 +72,23 @@ const counterLogic = createLogic({
         s.count += payload
       })
     })
+
+    bus.on("dec", ({ setState }) => {
+      setState(s => {
+        s.count--
+      })
+    })
+
+    bus.on("asyncInc", async ({ setState }) => {
+      setState(s => { s.loading = true })
+
+      await new Promise(r => setTimeout(r, 1000))
+
+      setState(s => {
+        s.count++
+        s.loading = false
+      })
+    })
   },
 })
 
@@ -111,124 +127,111 @@ computed: {
 - Reading `state.count` automatically tracks dependencies.
 - Computed values are cached and only re-evaluated when tracked dependencies change.
 
+
 ---
 
-## ⚛️ React Integration (No Hooks Required)
+## ⚛️ React Integration
 
-### Define Logic (Framework-Agnostic)
+React is a thin adapter.
 
-```ts
-// counter.logic.ts
-import { createLogic, effect } from "logic-runtime-react-z"
+You have **2 integration styles**:
 
-export const counterLogic = createLogic({
-  name: "counter",
+- `withLogic` → Recommended
+- `useLogic` → Direct hook usage
 
-  state: {
-    count: 1,
-    loading: false,
-  },
+#### 🧩 Option 1 — withLogic (Recommended)
 
-  computed: {
-    double: ({ state }) => state.count * 2,
-    triple: ({ state }) => state.count * 3,
-  },
-
-  intents: bus => {
-    bus.on("inc", ({ setState }) => {
-      setState(s => {
-        s.count++
-      })
-    })
-
-    bus.on<number>("add", ({ payload, setState }) => {
-      setState(s => {
-        s.count += payload
-      })
-    })
-
-    bus.on<number>("inc-async", async ({ payload, setState }) => {
-      setState(s => {
-        s.loading = true
-      })
-
-      await new Promise(r => setTimeout(r, 1000))
+Keeps view pure and declarative.
 
-      setState(s => {
-        s.count += payload
-        s.loading = false
-      })
-    })
+```tsx
+import { withLogic, LogicViewProps } from "logic-runtime-react-z"
+import { counterLogic } from "./counter.logic"
 
-    // effects = side-effects only (no state mutation)
-    bus.effect(
-      "inc-async",
-      effect(async ({ payload }) => {
-        console.log("effect run:", payload)
-      }).takeLatest()
-    )
-  },
+type CounterInjected =
+  LogicViewProps<typeof counterLogic>
 
-  actions: {
-    inc({ emit }) {
-      return () => emit("inc")
-    },
+const CounterView = ({ state, computed, intent }: LogicViewProps) => {
+  return (
+    <div>
+      <h2>Count: {state.count}</h2>
+      <p>Double: {computed.double}</p>
+      <p>Triple: {computed.triple}</p>
+
+      <button onClick={() => intent("inc")}>+</button>
+      <button onClick={() => intent("dec")}>-</button>
+      <button onClick={() => intent("asyncInc")}>
+        {state.loading ? "Loading..." : "Async +"}
+      </button>
+    </div>
+  )
+}
 
-    add({ emit }) {
-      return (n: number) => emit("add", n)
-    },
+// export default withLogic(counterLogic)(CounterView)
+export const CounterPage = withLogic(counterLogic, CounterView)
+```
 
-    incAsync({ emit }) {
-      return (n: number) => emit("inc-async", n)
-    },
-  },
-})
+<b> Why this is recommended?</b>
 
-```
+- View is fully testable
+- No hooks inside view
+- Logic can be reused outside React
+- Clear separation of concerns
 
 ---
 
-### Pure React View (Dumb View)
+#### 🪝 Option 2 — useLogic
+
+Use directly inside a component.
 
 ```tsx
-import React from "react"
-import { withLogic } from "logic-runtime-react-z"
+import { useLogic } from "logic-runtime-react-z"
 import { counterLogic } from "./counter.logic"
 
-function CounterView(props) {
-  const { state, actions, emit } = props
+export function Counter() {
+  const { state, computed, intent } = useLogic(counterLogic)
 
   return (
-    <div style={{ padding: 12 }}>
-      <div>Triple Count: {state.triple}</div>
-
-      <button onClick={actions.inc}>+1</button>
-      <button onClick={() => actions.add(10)}>+10</button>
-
-      <button
-        disabled={state.loading}
-        onClick={() => actions.incAsync(5)}
-      >
-        Async +5
-      </button>
-
-      <hr />
-
-      <button onClick={() => emit("inc")}>
-        emit("inc")
+    <div>
+      <h2>Count: {state.count}</h2>
+      <p>Double: {computed.double}</p>
+      <p>Triple: {computed.triple}</p>
+
+      <button onClick={() => intent("inc")}>+</button>
+      <button onClick={() => intent("dec")}>-</button>
+      <button onClick={() => intent("asyncInc")}>
+        {state.loading ? "Loading..." : "Async +"}
       </button>
     </div>
   )
 }
+```
 
-export const CounterPage = withLogic(counterLogic, CounterView)
+✔ Props are inferred when using useLogic, no manual generics required.
+
+---
+
+## 🌊 Async Support
+
+Async logic is just another intent.
 
+```ts
+bus.on("fetchUser", async ({ setState }) => {
+  setState(s => { s.loading = true })
+
+  const data = await api.getUser()
+
+  setState(s => {
+    s.user = data
+    s.loading = false
+  })
+})
 ```
 
-✔ Props are inferred when using withLogic, no manual generics required.
+No special async API needed.
 
 ---
 
+
 ## 🧪 Backend Usage (Same Runtime)
 
 ```ts
@@ -274,197 +277,164 @@ async function run() {
 run()
 ```
 
-✔ Same runtime, same behavior, no React involved.
-✔ No React  
-✔ Replayable  
+✔ Same runtime, same behavior.  
+✔ No React dependency   
+✔ Replayable execution   
 
 ---
 
-## 🪝 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.
+## 🧪 Unit Test Example
 
-#### 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>
-}
-```
+const logic = createLogic({
+  state: { value: 0 },
 
-✔ Subscribes to full snapshot
-✔ Includes state + computed
-✔ Read-only
+  computed: {
+    squared: ({ state }) => state.value * state.value,
+  },
 
-#### useActions – actions only (no re-render)
-```ts
-import { useActions } from "logic-runtime-react-z"
+  intents: bus => {
+    bus.on("set", ({ payload, setState }) => {
+      setState(s => {
+        s.value = payload
+      })
+    })
+  },
+})
 
-function Buttons() {
-  const actions = useActions(counterLogic)
+const runtime = logic.create()
 
-  return (
-    <>
-      <button onClick={actions.inc}>+1</button>
-      <button onClick={() => actions.add(5)}>+5</button>
-    </>
-  )
-}
+await runtime.emit("set", 4)
+expect(runtime.computed.squared).toBe(16)
 ```
 
+---
 
-✔ 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"
+## 🔍 Comparison
 
-function Stats() {
-  const { double, triple } = useComputed(counterLogic)
+This is not about “better” — it's about architectural intent.
 
-  return (
-    <>
-      <div>Double: {double}</div>
-      <div>Triple: {triple}</div>
-    </>
-  )
-}
+| Criteria                        | logic-runtime-react-z        | Redux Toolkit        | Zustand        | Recoil        | MobX           |
+|---------------------------------|------------------------------|----------------------|----------------|---------------|----------------|
+| **Primary abstraction**         | Intent runtime               | Reducer store        | Store          | Atom graph    | Observable     |
+| **Mental model**                | Intent → Behavior → State    | Action → Reducer     | Mutate store   | Atom graph    | Reactive graph |
+| **Single mutation entry**       | ✅                           | ✅                   | ❌             | ❌             | ❌             |
+| **Business logic isolation**    | ✅                           | ✅                   | ⚠️             | ⚠️             | ⚠️             |
+| **Built-in async orchestration**| ✅                           | ⚠️                   | ❌             | ❌             | ❌             |
+| **Deterministic execution**     | ✅                           | ✅                   | ⚠️             | ⚠️             | ⚠️             |
+| **Derived state built-in**      | ✅                           | ❌                   | ⚠️             | ✅             | ✅             |
+| **Headless runtime**            | ✅                           | ⚠️                   | ⚠️             | ❌             | ⚠️             |
+| **Backend / worker ready**      | ✅                           | ⚠️                   | ⚠️             | ❌             | ❌             |
+| **Side-effect centralization**  | ✅                           | ⚠️                   | ❌             | ❌             | ⚠️             |
+| **Devtools maturity**           | ⚠️                           | ✅                   | ⚠️             | ⚠️             | ⚠️             |
 
-function DoubleOnly() {
-  const double = useComputed(counterLogic, c => c.double)
-  return <div>{double}</div>
-}
-```
 
-✔ Only derived data
-✔ Cached & reactive
-✔ No state mutation possible
+<br />
 
-#### useComputed with selector (recommended)
-```ts
-function DoubleOnly() {
-  const double = useComputed(
-    counterLogic,
-    c => c.double
-  )
+✅ Built-in / first-class  
+⚠️ Possible / usage-dependent  
+❌ Not built-in
 
-  return <div>Double: {double}</div>
-}
-```
+---
 
-✔ Component re-renders only when double changes
-✔ No extra dependencies
-✔ Type-safe selector
+### 🧠 Architectural Difference
 
-#### useLogicSelector – State selector (Redux-like)
-```ts
-import { useLogicSelector } from "logic-runtime-react-z"
+Most state libraries focus on:
 
-function CountLabel() {
-  const count = useLogicSelector(
-    counterLogic.create(),
-    state => state.count
-  )
+> **How state is stored and updated**
 
-  return <span>{count}</span>
-}
-```
-
-✔ Memoized selector
-✔ Fine-grained subscriptions
-✔ Familiar mental model
-
----
+`logic-runtime-react-z` focuses on:
 
-## 🧱 Composing Multiple Logic Modules
+> **How behavior is orchestrated through intents**
 
-```ts
-import { composeLogic } from "logic-runtime-react-z"
-import { userLogic } from "./user.logic"
-import { cartLogic } from "./cart.logic"
+Redux/Zustand answer:
+> "Where is my state and how do I change it?"
 
-const app = composeLogic({
-  user: userLogic,
-  cart: cartLogic,
-})
+This runtime answers:
+> "What behavior is triggered by this event, and how should it execute?"
 
-await app.emit("login")
+---
 
-const state = app.getState()
-state.user
-state.cart
+### 🧭 Positioning Summary
 
-```
+- Redux → Structured state container
+- Zustand → Lightweight mutable store
+- Recoil → Declarative dependency graph
+- MobX → Reactive observable system
+- **logic-runtime-react-z → Intent-first behavior runtime**
 
 ---
 
-## 🧪 Unit Test Example
+### 🎯 When This Makes Sense
 
-```ts
-const logic = createLogic({
-  state: { value: 0 },
+Choose this if you need:
 
-  computed: {
-    squared: ({ state }) => state.value * state.value,
-  },
+- Complex async flows
+- Deterministic replayable behavior
+- Logic shared between frontend & backend
+- Strong separation between UI and domain behavior
+- An explicit event-driven boundary
 
-  intents: bus => {
-    bus.on("set", ({ payload, setState }) => {
-      setState(s => {
-        s.value = payload
-      })
-    })
-  },
-})
+Choose simpler state tools if:
 
-const runtime = counterLogic.create()
+- You mostly manage UI state
+- You don’t need orchestration
+- Your async flows are trivial
+- Your team prefers mutable patterns
 
-await runtime.emit("set", 4)
-expect(runtime.computed.squared).toBe(16)
-```
+---
 
-✔ Computed values are tested like plain data
+## 🧠 One-liner Takeaway
 
----
+- Redux & Zustand manage **state**
+- logic-runtime-react-z orchestrates **logic**
 
-## 🔍 Comparison: Redux vs Zustand
+---
 
-| Capability / Library     | logic-runtime-react-z | Redux | Zustand |
-|--------------------------|:---------------------:|:-----:|:-------:|
-| Intent-first model       | ✅                    | ❌    | ❌       |
-| State-first model        | ❌                    | ✅    | ✅       |
-| First-class effects      | ✅                    | ❌    | ❌       |
-| Computed graph           | ✅                    | ❌    | ⚠️       |
-| Deterministic execution  | ✅                    | ❌    | ❌       |
-| Logic outside React      | ✅                    | ❌    | ❌       |
-| Backend-safe             | ✅                    | ❌    | ❌       |
+## 🧬 Deterministic Execution Model
 
+- Intents are processed sequentially
+- State mutations are isolated
+- Async effects can follow declared execution strategies.
+- Execution order is predictable
 
-##### ⚠️ via selectors, not a true dependency graph
+Given the same intent sequence, the resulting state is reproducible.
 
 ---
 
-## 🧠 One-liner Takeaway
+## 📐 Architecture Diagram (High-level)
 
-- Redux & Zustand manage **state**
-- logic-runtime-react-z orchestrates **logic**
+```bash
+┌─────────────┐
+│   React UI  │
+└──────┬──────┘
+       │ adapter
+┌──────▼──────┐
+│   Runtime   │
+│  (create)   │
+├─────────────┤
+│  Intent Bus │
+│  Effects    │
+│  Handlers   │
+│  State      │
+│  Computed   │
+└─────────────┘
+```
+
+<b>Runtime is the product. React is an adapter.</b>
 
 ---
 
-## 🧬 Determinism Guarantee
+## ⚠️ When Not to Use
 
-- Intents are processed sequentially
-- State mutations are isolated
-- Async flows are predictable
-- Same inputs → same outputs
+- 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/index.cjs.js

@@ -1 +1 @@
-"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.handler.toString();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",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};
+"use strict";var t=require("chrono-state-z"),e=require("intentx-core-z"),s=require("react/jsx-runtime");function n(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 o=n(require("react"));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:[],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 r{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 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.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);const i=()=>{this.isComputing=!0,n.set(s({state:o})),this.isComputing=!1};t.effect(i),i(),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: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()})}}}}}Object.defineProperty(exports,"createSelector",{enumerable:!0,get:function(){return t.createSelector}}),exports.LogicRuntime=r,exports.attachDevtools=a,exports.createBackendRuntime=function(t){var s,n;let o=structuredClone(t);const i=()=>o,r=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 i()},setState(){throw new Error("setState is not allowed in backend runtime")},emit:u}}),h={state:i,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 i()},signal:null!==(n=t.signal)&&void 0!==n?n:(new AbortController).signal,set:r,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 r(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){const e=Object.keys(t.actions);for(const s of e){const e=t.actions[s];o[s]=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.useLogic=function(t,s){const n=o.useRef(null);n.current||(n.current=t.create("string"==typeof s?e.createScope(s):s));const i=n.current,r=o.useSyncExternalStore(i.subscribe,i.getSnapshot,i.getSnapshot),a=o.useCallback((t,e)=>i.emit(t,e),[i]),c=i.actions;return o.useMemo(()=>({state:r,actions:c,emit:a}),[r,c,a])},exports.withLogic=function(t,n,i){var r,a;const c=r=>{const a=o.useRef(null);a.current||(a.current=t.create("string"==typeof i?e.createScope(i):i));const c=a.current,u=o.useSyncExternalStore(c.subscribe,c.getSnapshot,c.getSnapshot),l=o.useCallback((t,e)=>c.emit(t,e),[c]),h=o.useMemo(()=>({state:u,actions:c.actions,emit:l}),[u,l,c]);return s.jsx(n,{...r,...h})};return c.displayName=`withLogic(${null!==(a=null!==(r=n.displayName)&&void 0!==r?r:n.name)&&void 0!==a?a:"View"})`,c};

package/build/index.d.ts

@@ -5,12 +5,8 @@ export { effect } from "./core/effect";
 export type { IntentMiddleware, IntentNext, } from "./core/middleware";
 export { createLogic } from "./logic/createLogic";
 export type { LogicFactory, LogicActions, } from "./logic/createLogic";
-export { composeLogic } from "./logic/composeLogic";
 export { createBackendRuntime } from "./logic/createBackendRuntime";
 export { withLogic } from "./react/withLogic";
-export { useActions } from "./react/useActions";
-export { useComputed } from "./react/useComputed";
+export type { LogicViewProps } from "./react/withLogic";
 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.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.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)}}())}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",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};
+import{atom as t,effect as e}from"chrono-state-z";export{createSelector}from"chrono-state-z";import{createScope as s,createIntentBus as n}from"intentx-core-z";import{jsx as o}from"react/jsx-runtime";import*as i from"react";class a{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:[],a=(r=this.middlewares,c=async t=>{t.effects=i;for(const e of o)await e(t)},r.reduceRight((t,e)=>e(t),c));var r,c;await a(e)}}class r{constructor(t,e=s("logic")){this.computedAtoms={},this.subs=new Set,this.bus=new a,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);const a=()=>{this.isComputing=!0,o.set(n({state:i})),this.isComputing=!1};e(a),a(),o.subscribe(this.markDirty)}}function c(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 u(t){return{name:t.name,create(e){var s;const n=new r(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){const e=Object.keys(t.actions);for(const s of e){const e=t.actions[s];o[s]=e({emit:n.emit,getState:n.getSnapshot})}}return n.actions=o,n}}}function l(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:{},a=e.filter(t=>"emit"===t.type&&t.id>=n&&t.id<=o&&(!i||t.scope===i));for(const e of a){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 h(t){var e,o;let i=structuredClone(t);const a=()=>i,r=t=>{i={...i,...t}},c=s("backend");async function u(t,e){await h.emit(t,e,c)}const h=n(t=>{const e=new AbortController;return{scope:c,payload:t,signal:e.signal,get state(){return a()},setState(){throw new Error("setState is not allowed in backend runtime")},emit:u}});const d={state:a,reset:()=>{i=structuredClone(t)},emit:u,registerIntents:function(t){for(const e in t){const s=t[e];h.on(e,async(t,e)=>{var n;const o={get state(){return a()},signal:null!==(n=t.signal)&&void 0!==n?n:(new AbortController).signal,set:r,emit:u};await s(o)},c)}},onIntent:h.on,effect:h.effect};if("production"!==(null===(o=null===(e=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===e?void 0:e.env)||void 0===o?void 0:o.NODE_ENV)){const t=l(d);t.wrap(d),d.devtools=t}return d}function d(t,e,n){var a,r;const c=a=>{const r=i.useRef(null);r.current||(r.current=t.create("string"==typeof n?s(n):n));const c=r.current,u=i.useSyncExternalStore(c.subscribe,c.getSnapshot,c.getSnapshot),l=i.useCallback((t,e)=>c.emit(t,e),[c]),h=i.useMemo(()=>({state:u,actions:c.actions,emit:l}),[u,l,c]);return o(e,{...a,...h})};return c.displayName=`withLogic(${null!==(r=null!==(a=e.displayName)&&void 0!==a?a:e.name)&&void 0!==r?r:"View"})`,c}function m(t,e){const n=i.useRef(null);n.current||(n.current=t.create("string"==typeof e?s(e):e));const o=n.current,a=i.useSyncExternalStore(o.subscribe,o.getSnapshot,o.getSnapshot),r=i.useCallback((t,e)=>o.emit(t,e),[o]),c=o.actions;return i.useMemo(()=>({state:a,actions:c,emit:r}),[a,c,r])}export{r as LogicRuntime,l as attachDevtools,h as createBackendRuntime,u as createLogic,c as effect,m as useLogic,d as withLogic};

package/build/logic/createLogic.d.ts

@@ -6,18 +6,23 @@ export type LogicFactory<S extends object, C extends ComputedDef<S>, A extends L
     name?: string;
     create(scope?: Scope): LogicRuntime<S, C, A>;
 };
-export declare function createLogic<S extends object, C extends ComputedDef<S> = {}, A extends LogicActions = {}>(config: {
+export type ExtractLogicTypes<T> = T extends LogicFactory<infer S, infer C, infer A> ? {
+    state: Readonly<S & InferComputed<C>>;
+    actions: A;
+    emit: (intent: string, payload?: any) => Promise<void>;
+} : never;
+export declare function createLogic<S extends object, C extends ComputedDef<S>, ActionsDef extends Record<string, (context: {
+    emit: LogicRuntime<S, C, any>["emit"];
+    getState: () => Readonly<S & InferComputed<C>>;
+}) => (...args: any[]) => any>>(config: {
     name?: string;
     state: S;
-    computed?: C;
+    computed: C;
     intents?: (bus: {
-        on: LogicRuntime<S, C, A>["onIntent"];
+        on: LogicRuntime<S, C, any>["onIntent"];
         effect: (type: string, eff: EffectDef) => void;
     }) => void;
-    actions?: {
-        [K in keyof A]: (context: {
-            emit: LogicRuntime<S, C, A>["emit"];
-            getState: () => Readonly<S & InferComputed<C>>;
-        }) => A[K];
-    };
-}): LogicFactory<S, C, A>;
+    actions: ActionsDef;
+}): LogicFactory<S, C, {
+    [K in keyof ActionsDef]: ReturnType<ActionsDef[K]>;
+}>;

package/build/react/useLogic.d.ts

@@ -1,6 +1,8 @@
-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>>;
+import { Scope } from "intentx-core-z";
+import type { LogicActions, LogicFactory } from "../logic/createLogic";
+import type { ComputedDef } from "../core/runtime";
+export declare function useLogic<S extends object, C extends ComputedDef<S>, A extends LogicActions>(logic: LogicFactory<S, C, A>, scope?: Scope | string): {
+    state: Readonly<S & import("../core/runtime").InferComputed<C>>;
     actions: A;
+    emit: (intent: string, payload?: any) => Promise<void>;
 };

package/build/react/withLogic.d.ts

@@ -1,11 +1,12 @@
 import * as React from "react";
 import { Scope } from "intentx-core-z";
-import type { LogicActions, LogicFactory } from "../logic/createLogic";
+import type { ExtractLogicTypes, 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 type LogicViewProps<T extends LogicFactory<any, any, any>> = ExtractLogicTypes<T>;
 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.1",
-  "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.3",
+  "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",
@@ -13,27 +14,19 @@
       "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"
   ],
+
   "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 +35,7 @@
   "bugs": {
     "url": "https://github.com/delpikye-v/logic-runtime-react/issues"
   },
+
   "keywords": [
     "intent-first",
     "intent-runtime",
@@ -60,6 +54,7 @@
     "takeLatest",
     "state-management"
   ],
+
   "peerDependencies": {
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"

package/build/logic/composeLogic.d.ts

@@ -1,21 +0,0 @@
-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 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 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>(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/react/useActions.d.ts

@@ -1,4 +0,0 @@
-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

@@ -1,6 +0,0 @@
-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/useLogicSelector.d.ts

@@ -1,2 +0,0 @@
-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,5 +0,0 @@
-import type { ComputedDef, InferComputed } from "../core/runtime";
-import { LogicRuntime } from "../core/runtime";
-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>>;