logic-runtime-react-z 1.0.1 → 2.0.1

package/README.md

@@ -1,349 +1,399 @@
-## ⚙️ logic-runtime-react-z
+# ⚙️ logic-runtime-react-z
 
-[![NPM](https://img.shields.io/npm/v/logic-runtime-react-z.svg)](https://www.npmjs.com/package/logic-runtime-react-z)
-![Downloads](https://img.shields.io/npm/dt/logic-runtime-react-z.svg)
+[![NPM](https://img.shields.io/npm/v/logic-runtime-react-z.svg)](https://www.npmjs.com/package/logic-runtime-react-z) ![Downloads](https://img.shields.io/npm/dt/logic-runtime-react-z.svg)
 
 <a href="https://codesandbox.io/p/sandbox/x3jf32" target="_blank">LIVE EXAMPLE</a>
 
----
-
-**logic-runtime-react-z** is an intent-first external runtime,
-designed to run business logic **outside React**.
+**Intent-first business logic runtime**
+React is a view. Logic lives elsewhere.
 
-React 18+ is required **only for the React bindings**.
-It provides a headless runtime layer that lives outside React, responsible for:
+---
 
-> Think of it as:
-> **“Business logic runtime outside React — React is just the view.”**
+## ✨ Core Idea
 
----
+> **Business logic lives outside React. React only renders state and emits intent.**
 
-## ✨ Why / When to Use
-- You want zero hooks in UI components
-- Business logic should not live in React
-- UI should only emit intent, not orchestrate behavior
-- Async flows are complex (login → fetch → redirect)
-- Side effects must be predictable & testable
-- You want headless tests without rendering
-- You prefer architecture-driven design over component-driven logic
+* No React hooks in views
+* Intent is the only entry point
+* Predictable async flows
+* Headless & backend-friendly
+* Fully testable without rendering
 
 ---
 
 ## 🧠 Mental Model
 
-```txt
-UI (Pure View)
- └─ emits intent (no logic)
-      ↓
-External Runtime (logic-runtime-react-z)
- ├─ state store
- ├─ intent handlers
- ├─ effect pipeline
- ├─ computed graph
- ├─ selectors
- └─ devtools timeline
 ```
-
-- React is just an adapter.
-- The runtime owns behavior.
+UI / HTTP / Queue / Cron
+        ↓
+emit(intent)
+        ↓
+middleware / effects
+        ↓
+ intent handlers
+        ↓
+ mutate state
+        ↓
+computed / subscribers
+```
 
 ---
 
 ## 📦 Installation
-```ts
+
+```bash
 npm install logic-runtime-react-z
 ```
+
 ---
 
-## Basic
+## 🚀 Quick Start (Headless)
+
 ```ts
-const logic = createLogic({
+import { createLogic } from "logic-runtime-react-z"
+
+const counterLogic = createLogic({
   state: { count: 0 },
   intents: bus => {
-    bus.on("inc", ({ setState }) => {
-      setState(s => { s.count++ })
-    })
-  }
+    bus.on("inc", ({ setState }) => setState(s => { s.count++ }))
+    bus.on("add", ({ payload, setState }) => setState(s => { s.count += payload }))
+  },
 })
 
-const runtime = logic.create()
-runtime.emit("inc")
+const runtime = counterLogic.create()
+await runtime.emit("inc")
+await runtime.emit("add", 5)
+console.log(runtime.state.count) // 6
+
 ```
 
 ---
 
-## ⚛️ React Usage (No Hooks in View)
+## ⚛️ React Integration (No Hooks in View)
 
 ```ts
-import { createLogic, withLogic, createSelector } from "logic-runtime-react-z"
+import { createLogic, effect, withLogic } from "logic-runtime-react-z"
 
 interface State {
   count: number;
-
-  // computed
-  double: number
+  loading: boolean;
+  double: number;
 }
 
+// Async effect for takeLatest behavior
+const asyncEffect = effect(async ({ payload, setState }) => {
+  console.log("Effect fired for payload:", payload);
+}).takeLatest()
+
 const counterLogic = createLogic({
   name: "counter",
-  state: { count: 1 },
-
-  computed: {
-    double({ state }): number {
-      return state.count * 2
-    }
-  },
-
+  state: { count: 1, loading: false },
+  computed: { double: ({ state }) => state.count * 2 },
   intents: bus => {
-    bus.on("inc", ({ state, setState }) => {
-      // if (!selectIsAdult(state)) {
-      //   throw new Error("Not allowed")
-      // }
-
-      setState(s => {
-        s.count++
-      })
+    bus.on("inc", ({ setState }) => setState(s => { s.count++ }))
+    bus.on("inc-async", async ({ payload, setState }) => {
+      setState(s => { s.loading = true })
+      await new Promise(r => setTimeout(r, 5000))
+      setState(s => { s.count += payload; s.loading = false })
     })
+    bus.effect("inc-async", asyncEffect)
   },
 })
 
-// Pure View (No Hooks)
-function CounterView({
-  state,
-  emit,
-}: {
-  state: State
-  emit: (intent: string) => void
-}) {
+// React view (pure, no hooks)
+function CounterView({ state, emit }: { state: State; emit: (intent: string, payload?: any) => void | Promise<void> }) {
   return (
     <div>
       <div>Count: {state.count}</div>
-      // <button
-      //   onClick={async () => {
-      //     try {
-      //       await emit("inc")
-      //       console.log("done")
-      //     } catch (e) {
-      //       console.error(e)
-      //     }
-      //   }}
-      // >
-      //   +
-      // </button>
+      <button disabled={state.loading} onClick={() => emit("inc")}>Plus</button>
+      <button disabled={state.loading} onClick={() => emit("inc-async", 100)}>Async +100</button>
       <div>Double: {state.double}</div>
-      <button onClick={() => emit("inc")}>+</button>
     </div>
   )
 }
 
-// Bind Logic to React
 export const Counter = withLogic(counterLogic, CounterView)
+
 ```
 
-## 🧪 No React
-```ts
+---
 
-// import { createLogic } from "logic-runtime-react-z"
-const counterLogic = createLogic({
-  state: {
-    count: 0
-  },
+## 🧪 Middleware Example (Backend)
 
-  computed: {
-    double({ state }) {
-      return state.count * 2
-    }
-  },
+```ts
+import { createBackendRuntime } from "logic-runtime-react-z"
 
-  intents: bus => {
-    bus.on("inc", ({ state, setState, emit }) => {
-      // state is READONLY snapshot (read-only)
-      // ❌ state.count++
-      setState(s => {
-        s.count += 1
-      })
-
-      // emit("inc") ❌ no nested
-    })
+// Create runtime with initial state
+const runtime = createBackendRuntime({
+  user: null,
+  loading: false,
+})
 
-    // Intent handlers can be sync or async
-    bus.on("add", ({ payload, setState }) => {
-      setState(s => {
-        s.count += payload
-      })
-    })
+// Optional: attach devtools in dev mode
+const devtools = runtime.devtools
+
+// Register some intents
+runtime.onIntent("login", async ({ payload, setState }) => {
+  setState(s => { s.loading = true })
+  // simulate async login
+  const user = await fakeLoginApi(payload)
+  setState(s => {
+    s.user = user
+    s.loading = false
+  })
+})
 
-    bus.on("reset", ({ setState }) => {
-      setState(s => {
-        s.count = 0
-      })
-    })
-  },
+runtime.onIntent("logout", ({ setState }) => {
+  setState(s => { s.user = null })
 })
 
-// initial
-// const runtime = counterLogic.create()
-const runtime = counterLogic.create("counter:main")
+// Emit some intents
+await runtime.emit("login", { username: "alice", password: "123" })
+await runtime.emit("logout")
+
+// ----------------- Using devtools -----------------
 
-runtime.emit("inc")
-// await runtime.emit("inc") // if async
-runtime.emit("add", 5)
+// 1️⃣ Access timeline records
+console.log("Timeline records:", devtools.timeline.records)
+
+// 2️⃣ Replay intents
+await devtools.timeline.replay(runtime.emit, { scope: "backend" })
+
+// 3️⃣ Clear timeline
+devtools.timeline.clear()
+console.log("Timeline cleared:", devtools.timeline.records)
 
-// console.log
-console.log(runtime.state.count)   // 7
-console.log(runtime.state.double)   // 14
 ```
 
 ---
 
-## 🧩 Plugins – Runtime extensions (cross-cutting concerns)
-
-#### Plugins extend the runtime behavior **without touching business logic**.
+## 🧪 Unit Test Example (Headless)
 
 ```ts
-export const authPlugin: LogicPlugin = {
-  name: "auth",
-
-  setup(runtime) {
-    runtime.onIntent("delete", ctx => {
-      if (!ctx.state.user?.isAdmin) {
-        throw new Error("Forbidden")
-      }
-    })
+const logic = createLogic({
+  state: { value: 0 },
+  computed: { squared: ({ state }) => state.value * state.value },
+  intents: bus => {
+    bus.on("set", ({ payload, setState }) => setState(s => { s.value = payload }))
   }
-}
+})
 
-export const persistPlugin: LogicPlugin = {
-  name: "persist",
+const runtime = logic.create()
+await runtime.emit("set", 4)
+expect(runtime.state.squared).toBe(16)
 
-  setup(runtime) {
-    runtime.subscribe(() => {
-      localStorage.setItem(
-        runtime.scope,
-        JSON.stringify(runtime.state)
-      )
-    })
-  }
-}
 ```
 
 ---
 
-## ⚡ Async Effects + Selectors (Advanced Usage)
+## 🔍 Comparison
 
-#### createSelector
-Selectors are pure functions that derive data from state.  
-They are read-only, memoized, and safe to reuse anywhere (runtime, effects, intents).  
+| Feature                     | logic-runtime-react-z     | Redux                | Zustand  | Recoil/Jotai   |
+| --------------------------- | ------------------------  | -------------------- | -------- | -------------- |
+| Intent-first                | ✅                        | ❌                    | ❌       | ❌             |
+| Headless / backend-friendly | ✅                        | ⚠️                    | ⚠️       | ❌             |
+| Async orchestration         | ✅ (takeLatest, debounce) | ⚠️ (middleware add )  | ⚠️       | ⚠️             |
+| Computed graph              | ✅                        | ❌                    | ❌       | ✅ (atom deps) |
+| Devtools replay async       | ✅                        | ⚠️                    | ❌       | ⚠️             |
+| UI-agnostic                 | ✅                        | ⚠️                    | ⚠️       | ❌             |
+| Deterministic testability   | ✅                        | ⚠️                    | ⚠️       | ⚠️             |
 
-```ts
-import { createSelector } from "logic-runtime-react-z"
 
-const selectIsAdult = createSelector(
-  (state: { age: number }) => state.age,
-  age => age >= 18
-)
+---
+
+## ⚖️ Comparison with Vue2
+
+While logic-runtime-react-z uses a **reactive + computed pattern** similar to Vue2, the behavior is quite different:
+
+| Feature                   | Vue2                   | logic-runtime-react-z                               |
+|---------------------------|----------------------- |---------------------------------------------------- |
+| Reactive base state       | ✅ proxy               | ✅ store + computed tracking.                        |
+| Computed                  | ✅                     | ✅ dependency tracking + invalidation.               |
+| Intent-driven flow        | ❌                     | ✅ all actions go through `emit(intent)`.            |
+| Async orchestration       | ❌                     | ✅ effects + middleware (takeLatest, debounce, etc.) |
+| Headless / backend-ready  | ❌                     | ✅ can run without React/UI                          |
+| Deterministic testing     | ❌                     | ✅ full headless tests possible                      |
+| Devtools replay           | ❌                     | ✅ timeline tracking & replay                        |
+
+> **Takeaway:** It feels familiar if you know Vue2 reactivity, but under the hood it's **intent-first, headless, and fully testable**, unlike Vue2.
+
+---
+
+## 🚫 Anti-patterns (What NOT to do)
+
+This library enforces a **clear separation between intent, behavior, and view**.  
+If you find yourself doing the following, you are probably fighting the architecture.
+
+
+#### ❌ 1. Putting business logic inside React components
+
+```tsx
+// ❌ Don't do this
+function Login() {
+  const [loading, setLoading] = useState(false)
+
+  async function handleLogin() {
+    setLoading(true)
+    const user = await api.login()
+    setLoading(false)
+    navigate("/home")
+  }
+}
 ```
+Why this is wrong
+- Logic tied to React lifecycle
+- Hard to test without rendering
+- Side-effects scattered in UI
 
-#### effect – Async / side-effect layer
-Effects here are middleware-style intent interceptors, not React effects. They are used for:
-- logging
-- permission checks
-- retries / debounce
-- cancellation
-- async orchestration
+✅ Correct
 
 ```ts
-import { effect, debounce, retry, takeLatest } from "logic-runtime-react-z"
+runtime.emit("login")
+```
 
-const withLogging = effect(next => {
-  return async ctx => {
-    console.log("saving...")
-    await next(ctx)
-  }
+```ts
+bus.on("login", async ({ setState, emit }) => {
+  setState(s => { s.loading = true })
+  const user = await api.login()
+  setState(s => { s.loading = false })
+  emit("login:success", user)
 })
 ```
 
-#### Combining Effects + Selectors in Intents
+#### ❌ 2. Calling handlers directly instead of emitting intent
 ```ts
-intents: bus => {
-  // attach effect to intent
-  bus.effect("save", withLogging)
+// ❌ Don't call handlers manually
+loginHandler(payload)
+```
+Why this is wrong
 
-  // intent handler (business rule)
-  bus.on("save", ({ state }) => {
-    if (!selectIsAdult(state)) {
-      throw new Error("Not allowed")
-    }
+- Skips middleware & effects
+- Breaks devtools timeline
+- Makes behavior non-deterministic
 
-    // perform save logic...
-  })
+✅ Correct
 
-  bus.on("save-user", async ({ state, setState }) => {
-    await api.save(state.form)
-    setState(s => {
-      s.saved = true
-    })
-  })
-
-  // bus.effect("save", debounce(300))
-  // bus.effect("save", retry(2))
-  // bus.effect("save", takeLatest())
+```ts
+runtime.emit("login", payload)
+```
+Intent is the only entry point. Always.
 
-}
+#### ❌ 3. Using effects to mutate state directly
+```ts
+// ❌ Effect mutating state
+bus.effect("save", next => async ctx => {
+  ctx.setState(s => { s.saving = true })
+  await next(ctx)
+})
 ```
 
----
+Why this is wrong
+
+- Effects are orchestration, not business logic
+- Hard to reason about ordering
+- Blurs responsibility
 
-## 🧭 Devtools & Timeline
-- Every intent is recorded
-- Replayable
-- Deterministic async flows
+✅ Correct
 
 ```ts
-// devtool process.env.NODE_ENV !== "production"
-runtime.devtools?.timeline.replay(runtime.emit)
+bus.on("save", ({ setState }) => {
+  setState(s => { s.saving = true })
+})
+```
+Effects should only:
+- debounce
+- retry
+- cancel
+- log
+- trace
+
+#### ❌ 4. Treating intent like Redux actions
+```ts
+// ❌ Generic, meaningless intent
+emit("SET_STATE", { loading: true })
 ```
 
----
+Why this is wrong
 
-## Props
+- Intent should describe user or system intention
+- Not raw state mutation
 
-| API field  | Type                   | Description                                                                        |
-| ---------- | ---------------------- | ---------------------------------------------------------------------------------- |
-| `name`     | `string?`              | Optional logic name. Used for debugging, devtools, and default runtime scope.      |
-| `state`    | `S`                    | **Base mutable state** (source of truth). Can only be changed via `setState`.      |
-| `computed` | `ComputedDef<S, C>?`   | **Derived read-only state**, automatically recomputed when base state changes.     |
-| `intents`  | `(bus) => void`        | Defines **business actions** (intent handlers). Intents describe behavior, not UI. |
-| `plugins`  | `LogicPlugin<S, C>[]?` | Runtime extensions (devtools, logging, persistence, analytics, etc.).              |
+✅ Correct
 
----
+```ts
+emit("login:start")
+emit("login:success", user)
+emit("login:failed", error)
+```
+Intents are verbs, not patches.
 
-## 🔍 Comparison
+#### ❌ 5. Reading or mutating state outside the runtime
+```ts
+// ❌ External mutation
+runtime.state.user.name = "admin"
+```
+Why this is wrong
+- Breaks computed cache
+- Bypasses subscriptions
+- Devtools become unreliable
 
-| Feature         | logic-runtime-react-z   | Redux | Zustand  |
-| --------------- | ----------------------- | ----- | -------- |
-| No-hook UI      | ✅                      | ❌     | ❌       |
-| Intent-first    | ✅                      | ❌     | ❌       |
-| Async built-in  | ✅                      | ⚠️     | ⚠️       |
-| Computed graph  | ✅                      | ❌     | ❌       |
-| Headless test   | ✅                      | ⚠️     | ⚠️       |
-| Devtools replay | ✅                      | ⚠️     | ❌       |
+✅ Correct
 
-> This comparison focuses on **architecture and mental model**, not ecosystem size.
+```ts
+emit("update:user:name", "admin")
+```
 
----
+#### ❌ 6. Using React hooks to replace runtime behavior
+```ts
+// ❌ useEffect as orchestration
+useEffect(() => {
+  if (state.loggedIn) {
+    fetchProfile()
+  }
+}, [state.loggedIn])
+```
+Why this is wrong
+
+- Behavior split across layers
+- Impossible to replay or test headlessly
 
-## 🚫 What this library is NOT
+✅ Correct
+
+```ts
+bus.on("login:success", async ({ emit }) => {
+  await emit("profile:fetch")
+})
+```
+#### ❌ 7. One logic runtime doing everything
+```ts
+// ❌ God runtime
+createLogic({
+  state: {
+    user: {},
+    cart: {},
+    products: {},
+    settings: {},
+    ui: {},
+  }
+})
+```
+Why this is wrong
+- No ownership boundaries
+- Hard to compose
+- Does not scale
 
-- ❌ Not a React state manager
-- ❌ Not a replacement for Redux Toolkit
-- ❌ Not a UI framework
-- ❌ Not tied to React (runtime is headless)
+✅ Correct
 
-It is a **behavior runtime**.
+```ts
+composeLogic(
+  userLogic,
+  cartLogic,
+  productLogic
+)
+```
 
 ---
 
 ## 📜 License
 
-MIT
+MIT / Delpi

package/build/core/effect.d.ts

@@ -1,11 +1,6 @@
-import type { Effect } from "./types";
+import type { Effect, EffectCtx } from "./types";
 export declare function composeEffects<W, R>(effects: Effect<W, R>[]): Effect<W, R>;
 export declare function takeLatest<W, R>(): Effect<W, R>;
 export declare function debounce<W, R>(ms: number): Effect<W, R>;
 export declare function retry<W, R>(count?: number): Effect<W, R>;
-export type EffectBuilder<W, R> = Effect<W, R> & {
-    takeLatest(): EffectBuilder<W, R>;
-    debounce(ms: number): EffectBuilder<W, R>;
-    retry(count?: number): EffectBuilder<W, R>;
-};
-export declare function effect<W extends object = any, R extends object = W>(fx: Effect<W, R>): EffectBuilder<W, R>;
+export declare function effect<W extends object, R extends object = W, P = any>(body: (ctx: EffectCtx<W, R, P>) => void | Promise<void>): any;

package/build/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./intent";
+export * from "./effect";

package/build/core/intent.d.ts

@@ -1,10 +1,11 @@
-import type { IntentHandler, Effect } from "./types";
+import type { IntentHandler, Effect, IntentMiddleware } from "./types";
 export declare function createIntentBus<W extends object, R extends object = W, P = any>(scope: string): {
     on: (intent: string, handler: IntentHandler<W, R, P>) => void;
     effect: (intent: string, fx: Effect<W, R, P>) => void;
     emit: (intent: string, payload: P, ctx: {
-        getState: () => R;
-        setState: (fn: (s: W) => void) => void;
-        emit: (intent: string, payload?: any) => Promise<void>;
+        getState(): R;
+        setState(fn: (s: W) => void): void;
+        emit(intent: string, payload?: any): Promise<void>;
     }) => Promise<void>;
+    use: (mw: IntentMiddleware<W, R, P>) => void;
 };

package/build/core/middleware.d.ts

@@ -0,0 +1,2 @@
+export type IntentMiddleware<Ctx = any> = (ctx: Ctx, next: () => Promise<void>) => Promise<void>;
+export declare function compose(middlewares: IntentMiddleware[]): (ctx: any, next: () => Promise<void>) => Promise<void>;

package/build/core/types.d.ts

@@ -1,4 +1,4 @@
-import type { Timeline } from "./timeline";
+import type { Timeline } from "../devtools/timeline";
 export type Listener = () => void;
 export type EffectCtx<W = any, R = W, P = any> = {
     state: Readonly<R>;
@@ -10,12 +10,16 @@ export type EffectCtx<W = any, R = W, P = any> = {
 };
 export type IntentHandler<W = any, R = W, P = any> = (ctx: EffectCtx<W, R, P>) => void | Promise<void>;
 export type Effect<W = any, R = W, P = any> = (next: IntentHandler<W, R, P>) => IntentHandler<W, R, P>;
+export type IntentMiddleware<W = any, R = W, P = any> = (ctx: EffectCtx<W, R, P>, next: () => Promise<void>) => Promise<void>;
 export type LogicRuntime<S extends object, C extends object = {}> = {
     scope: string;
     state(): Readonly<S & C>;
     setState(mutator: (s: S) => void): void;
     reset(): void;
+    batch(fn: () => void): void;
     emit(intent: string, payload?: any): Promise<void>;
+    effect(intent: string, fx: Effect<S, S & C>): void;
+    use(mw: IntentMiddleware<S, S & C>): void;
     subscribe(fn: Listener): () => void;
     onIntent(intent: string, handler: IntentHandler<S, S & C>): void;
     devtools?: {

package/build/devtools/index.d.ts

@@ -0,0 +1,2 @@
+export { attachDevtools } from "./devtools";
+export * from "./timeline";

package/build/index.cjs.js

@@ -1 +1 @@
-"use strict";var t=require("react/jsx-runtime");function e(t){var e=Object.create(null);return t&&Object.keys(t).forEach(function(n){if("default"!==n){var r=Object.getOwnPropertyDescriptor(t,n);Object.defineProperty(e,n,r.get?r:{enumerable:!0,get:function(){return t[n]}})}}),e.default=t,Object.freeze(e)}var n,r,o=e(require("react"));function c(t){const e=new Map,n=new Map,r=new Map;return{on:function(t,n){const r=e.get(t)||[];r.push(n),e.set(t,r)},effect:function(t,e){const r=n.get(t)||[];r.push(e),n.set(t,r)},emit:async function(o,c,s){const a=(e=>`${t}:${e}`)(o),i=r.get(a);null==i||i.abort();const u=new AbortController;r.set(a,u);const l=e.get(o)||[],f=n.get(o)||[];for(const e of l){let n=e;for(let t=f.length-1;t>=0;t--)n=f[t](n);await n({state:s.getState(),payload:c,signal:u.signal,scope:t,emit:s.emit,setState:s.setState})}}}}function s(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:r=0,to:o=1/0,scope:c}=null!=n?n:{},s=e.filter(t=>"emit"===t.type&&t.id>=r&&t.id<=o&&(!c||t.scope===c));for(const e of s){const n=t(e.intent,e.payload);n instanceof Promise&&await n}},clear:function(){e=[],t=0}}}();return{timeline:e,wrap:function(){const n=t.emit.bind(t);t.emit=async(r,o)=>{e.record({type:"emit:start",intent:r,payload:o,scope:t.scope,state:t.state(),timestamp:Date.now()});try{await n(r,o)}finally{e.record({type:"emit:end",intent:r,payload:o,scope:t.scope,state:t.state(),timestamp:Date.now()})}}}}}let a=0;const i="production"!==(null===(r=null===(n=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===n?void 0:n.env)||void 0===r?void 0:r.NODE_ENV);const u=[],l=[];function f(){let t=null;return e=>async n=>(null==t||t.abort(),t=new AbortController,e({...n,signal:t.signal}))}function p(t){let e;return n=>r=>{clearTimeout(e),e=setTimeout(()=>n(r),t)}}function d(t=3){return e=>async n=>{let r;for(let o=0;o<t;o++)try{return await e(n)}catch(t){r=t}throw r}}exports.composeLogic=function(...t){return{create(e){const n=t.map(t=>{var n;if("logic"in t){const r=t.logic.create(null!==(n=t.namespace)&&void 0!==n?n:e);return{namespace:t.namespace,inst:r}}return{namespace:null,inst:t.create(e)}});return{get state(){const t={};for(const{namespace:e,inst:r}of n){const n=r.state();e?t[e]=n:Object.assign(t,n)}return t},async emit(t,e){const r=n.map(({inst:n})=>{var r;return null===(r=n.emit)||void 0===r?void 0:r.call(n,t,e)});return Promise.all(r.filter(Boolean))},subscribe(t){const e=n.map(e=>e.inst.subscribe(t));return()=>{e.forEach(t=>t())}}}}}},exports.createLogic=function(t){var e;const n=null!==(e=t.name)&&void 0!==e?e:"logic";return{create(e){var r,o;const f=null!=e?e:`${n}:${++a}`,p=structuredClone(t.state),d=function(t){let e=t;const n=new Set;return{getState:function(){return e},setState:function(t){const r=e,o=structuredClone(r);t(o),Object.is(r,o)||(e=o,n.forEach(t=>t()))},subscribe:function(t){return n.add(t),()=>n.delete(t)}}}(structuredClone(t.state)),m=function(){const t=new Map,e=new Map,n=new Map;return{compute:function(n,r,o){if(t.has(n))return t.get(n);const c=new Set,s=r({state:new Proxy(o,{get:(t,e,n)=>("string"==typeof e&&e in t&&c.add(e),Reflect.get(t,e,n))})});return t.set(n,s),e.set(n,c),s},invalidate:function(r){e.forEach((e,o)=>{var c;e.has(r)&&(t.delete(o),null===(c=n.get(o))||void 0===c||c.forEach(t=>t()))})},subscribe:function(t,e){var r;const o=null!==(r=n.get(t))&&void 0!==r?r:new Set;return o.add(e),n.set(t,o),()=>o.delete(e)},reset:function(){t.clear(),e.clear(),n.forEach(t=>{t.forEach(t=>t())})}}}(),g=c(f);null===(r=t.intents)||void 0===r||r.call(t,g);let b=null,v=null;function y(){const e=d.getState();if(e===b&&v)return v;const n={};var r;return t.computed&&(r=t.computed,Object.keys(r)).forEach(r=>{n[r]=m.compute(r,t.computed[r],e)}),b=e,v=Object.assign({},e,n),v}function h(t){const e=d.getState();d.setState(n=>{t(n);for(const t in n)e[t]!==n[t]&&m.invalidate(t)})}const w={scope:f,state:()=>y(),setState:h,reset(){!function(){var t;d.setState(()=>structuredClone(p)),null===(t=m.reset)||void 0===t||t.call(m),b=null,v=null}()},async emit(t,e){const n=y();u.forEach(r=>r({intent:t,payload:e,state:n,scope:f}));try{await g.emit(t,e,{getState:y,setState:h,emit:w.emit})}finally{l.forEach(n=>n({intent:t,payload:e,state:y(),scope:f}))}},subscribe:d.subscribe,onIntent(t,e){g.on(t,e)},__internal:{onEmitStart(t){u.push(t)},onEmitEnd(t){l.push(t)}}};let S;return null===(o=t.plugins)||void 0===o||o.forEach(t=>t.setup(w)),i&&(S=s(w),S.wrap(w)),{...w,devtools:S}}}},exports.createSelector=function(t,e=Object.is){let n,r=null;return o=>{if(null!==r){const c=t(o);return e(n,c)?n:(n=c,r=o,c)}return r=o,n=t(o),n}},exports.createSignal=function(t){let e=t;const n=new Set;return{get:()=>e,set(t){Object.is(e,t)||(e=t,n.forEach(t=>t()))},subscribe:t=>(n.add(t),()=>n.delete(t))}},exports.debounce=p,exports.effect=function(t){const e=[t],n=t=>{return(n=e,t=>n.reduceRight((t,e)=>e(t),t))(t);var n};return n.takeLatest=()=>(e.push(f()),n),n.debounce=t=>(e.push(p(t)),n),n.retry=(t=3)=>(e.push(d(t)),n),n},exports.retry=d,exports.takeLatest=f,exports.withLogic=function(e,n){var r,c;const s=r=>{const c=o.useRef(null);c.current||(c.current=e.create());const s=c.current,a=o.useSyncExternalStore(s.subscribe,s.state,s.state),i=o.useCallback((t,e)=>s.emit(t,e),[s]);return t.jsx(n,{...r,state:a,emit:i})};return s.displayName=`withLogic(${null!==(c=null!==(r=n.displayName)&&void 0!==r?r:n.name)&&void 0!==c?c:"View"})`,s};
+"use strict";var t=require("react/jsx-runtime");function e(t){var e=Object.create(null);return t&&Object.keys(t).forEach(function(n){if("default"!==n){var r=Object.getOwnPropertyDescriptor(t,n);Object.defineProperty(e,n,r.get?r:{enumerable:!0,get:function(){return t[n]}})}}),e.default=t,Object.freeze(e)}var n,r,o=e(require("react"));function s(t){let e=t;const n=new Set;return{getState:function(){return e},setState:function(t){const r=e,o=structuredClone(r);t(o),Object.is(r,o)||(e=o,n.forEach(t=>t()))},subscribe:function(t){return n.add(t),()=>n.delete(t)}}}function a(){const t=new Map,e=new Map,n=new Map;return{compute:function(n,r,o){if(t.has(n))return t.get(n);const s=new Set,a=r({state:new Proxy(o,{get:(t,e,n)=>("string"==typeof e&&e in t&&s.add(e),Reflect.get(t,e,n))})});return t.set(n,a),e.set(n,s),a},invalidate:function(r){e.forEach((e,o)=>{var s;e.has(r)&&(t.delete(o),null===(s=n.get(o))||void 0===s||s.forEach(t=>t()))})},subscribe:function(t,e){var r;const o=null!==(r=n.get(t))&&void 0!==r?r:new Set;return o.add(e),n.set(t,o),()=>o.delete(e)},reset:function(){t.clear(),e.clear(),n.forEach(t=>t.forEach(t=>t()))}}}function c(t){const e=new Map,n=new Map,r=[],o=new Map;return{on:function(t,n){var r;const o=null!==(r=e.get(t))&&void 0!==r?r:[];o.push(n),e.set(t,o)},effect:function(t,e){var r;const o=null!==(r=n.get(t))&&void 0!==r?r:[];o.push(e),n.set(t,o)},emit:async function(s,a,c){var i,l;const u=`${t}:${s}`;null===(i=o.get(u))||void 0===i||i.abort();const f=new AbortController;o.set(u,f);const d=Array.from(e.entries()).filter(([t])=>function(t,e){return t.endsWith("/*")?e.startsWith(t.slice(0,-2)):t===e}(t,s)).flatMap(([,t])=>t),p=null!==(l=n.get(s))&&void 0!==l?l:[];for(const e of d){let n=e;for(let t=p.length-1;t>=0;t--)n=p[t](n);const o={state:c.getState(),payload:a,signal:f.signal,scope:t,emit:c.emit,setState:c.setState};let s=-1;const i=async t=>{if(t<=s)throw new Error("next() called multiple times");s=t;const e=r[t];if(!e)return n(o);await e(o,()=>i(t+1))};await i(0)}},use:function(t){r.push(t)}}}function i(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:r=0,to:o=1/0,scope:s}=null!=n?n:{},a=e.filter(t=>"emit"===t.type&&t.id>=r&&t.id<=o&&(!s||t.scope===s));for(const e of a){const n=t(e.intent,e.payload);n instanceof Promise&&await n}},clear:function(){e=[],t=0}}}();return{timeline:e,wrap:function(){const n=t.emit.bind(t);t.emit=async(r,o)=>{e.record({type:"emit:start",intent:r,payload:o,scope:t.scope,state:t.state(),timestamp:Date.now()});try{await n(r,o)}finally{e.record({type:"emit:end",intent:r,payload:o,scope:t.scope,state:t.state(),timestamp:Date.now()})}}}}}let l=0;const u="production"!==(null===(r=null===(n=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===n?void 0:n.env)||void 0===r?void 0:r.NODE_ENV);function f(t){return e=>t.reduceRight((t,e)=>e(t),e)}function d(){let t=null;return e=>async n=>{if(null==t||t.abort(),t=new AbortController,!t.signal.aborted)return e({...n,signal:t.signal})}}function p(t){let e;return n=>r=>new Promise(o=>{clearTimeout(e),e=setTimeout(()=>o(n(r)),t)})}function m(t=3){return e=>async n=>{let r;for(let o=0;o<t;o++)try{return await e(n)}catch(t){if(n.signal.aborted)return;r=t}throw r}}exports.attachDevtools=i,exports.composeEffects=f,exports.composeLogic=function(...t){return{create(e){const n=t.map(t=>{var n,r;if("logic"in t){const o=t.logic.create(null!==(n=t.namespace)&&void 0!==n?n:e);return{namespace:null!==(r=t.namespace)&&void 0!==r?r:null,inst:o}}return{namespace:null,inst:t.create(e)}});return{get state(){const t={};for(const{namespace:e,inst:r}of n){const n=r.state();e?t[e]=n:Object.assign(t,n)}return t},async emit(t,e){const r=n.map(n=>{var r,o;return null===(o=(r=n.inst).emit)||void 0===o?void 0:o.call(r,t,e)}).filter(Boolean);await Promise.all(r)},subscribe(t){const e=n.map(e=>e.inst.subscribe(t));return()=>e.forEach(t=>t())}}}}},exports.composeMiddleware=function(t){return function(e,n){let r=-1;return function o(s){if(s<=r)return Promise.reject(new Error("next() called multiple times"));r=s;const a=t[s]||n;return a?Promise.resolve(a(e,()=>o(s+1))):Promise.resolve()}(0)}},exports.createBackendRuntime=function(t){var e,n;let r=structuredClone(t);const o=a(),s=c("backend"),l=[],u=[];let f=!1,d=new Set;function p(t){const e=structuredClone(r);if(t(r),f)for(const t in r)e[t]!==r[t]&&d.add(t);else for(const t in r)e[t]!==r[t]&&o.invalidate(t)}function m(t){return{...t,set(t){p(e=>Object.assign(e,t))},emit:v.emit}}const v={state:()=>r,setState:p,batch:function(t){f=!0;try{t()}finally{f=!1,d.forEach(t=>o.invalidate(t)),d.clear()}},async emit(t,e){l.forEach(n=>n({intent:t,payload:e,state:structuredClone(r)}));try{await s.emit(t,e,{getState:()=>r,setState:p,emit:v.emit})}finally{u.forEach(n=>n({intent:t,payload:e,state:structuredClone(r)}))}},onIntent:s.on,effect:s.effect,use:s.use,registerIntents:function(t){for(const e in t){const n=t[e];s.on(e,async t=>{await n(m({state:r,signal:t.signal}))})}},__internal:{onEmitStart(t){l.push(t)},onEmitEnd(t){u.push(t)}},reset:function(){r=structuredClone(t),o.reset()}};if("production"!==(null===(n=null===(e=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===e?void 0:e.env)||void 0===n?void 0:n.NODE_ENV)){const t=i(v);t.wrap(v),v.devtools=t}return v},exports.createComputed=a,exports.createIntentBus=c,exports.createLogic=function(t){var e;const n=null!==(e=t.name)&&void 0!==e?e:"logic";return{create(e){var r,o;const f=null!=e?e:`${n}:${++l}`,d=structuredClone(t.state),p=s(structuredClone(t.state)),m=a(),v=c(f);null===(r=t.intents)||void 0===r||r.call(t,v);let b=null,g=null,h=!1,y=new Set;const w=[],E=[];function S(){const e=p.getState();if(e===b&&g)return g;const n={};var r;return t.computed&&(r=t.computed,Object.keys(r)).forEach(r=>{n[r]=m.compute(r,t.computed[r],e)}),b=e,g=Object.assign({},e,n),g}function x(t){const e=p.getState();p.setState(n=>{t(n);for(const t in n)e[t]!==n[t]&&(h?y.add(t):m.invalidate(t))})}const j={scope:f,state:()=>S(),setState:x,reset(){!function(){var t;p.setState(()=>structuredClone(d)),null===(t=m.reset)||void 0===t||t.call(m),b=null,g=null}()},use:v.use,effect:v.effect,batch:function(t){h=!0;try{t()}finally{h=!1,y.forEach(t=>m.invalidate(t)),y.clear()}},async emit(t,e){const n=S();w.forEach(r=>r({intent:t,payload:e,state:n,scope:f}));try{await v.emit(t,e,{getState:S,setState:x,emit:j.emit})}finally{E.forEach(n=>n({intent:t,payload:e,state:S(),scope:f}))}},subscribe:p.subscribe,onIntent(t,e){v.on(t,e)},__internal:{onEmitStart(t){w.push(t)},onEmitEnd(t){E.push(t)}}};let O;return null===(o=t.plugins)||void 0===o||o.forEach(t=>t.setup(j)),u&&(O=i(j),O.wrap(j)),{...j,devtools:O}}}},exports.createSelector=function(t,e=Object.is){let n,r=null;return o=>{if(null!==r){const s=t(o);return e(n,s)?n:(n=s,r=o,s)}return r=o,n=t(o),n}},exports.createSignal=function(t){let e=t;const n=new Set;return{get:()=>e,set(t){Object.is(e,t)||(e=t,n.forEach(t=>t()))},subscribe:t=>(n.add(t),()=>n.delete(t))}},exports.createStore=s,exports.debounce=p,exports.effect=function(t){const e=[e=>async n=>{if(!n.signal.aborted)return await t(n),e(n)}];let n=!1;const r=t=>(n=!0,f(e))(t);return r.takeLatest=()=>{if(n)throw new Error("Effect already built");return e.push(d()),r},r.debounce=t=>{if(n)throw new Error("Effect already built");return e.push(p(t)),r},r.retry=(t=3)=>{if(n)throw new Error("Effect already built");return e.push(m(t)),r},r},exports.retry=m,exports.takeLatest=d,exports.withLogic=function(e,n,r){var s,a;const c=s=>{const a=o.useRef(null);a.current||(a.current=e.create(r));const c=a.current,i=o.useSyncExternalStore(c.subscribe,c.state,c.state),l=o.useCallback((t,e)=>c.emit(t,e),[c]);return t.jsx(n,{...s,state:i,emit:l})};return c.displayName=`withLogic(${null!==(a=null!==(s=n.displayName)&&void 0!==s?s:n.name)&&void 0!==a?a:"View"})`,c};

package/build/index.d.ts

@@ -1,9 +1,16 @@
-export { createSignal } from "./core/signal";
-export { createLogic } from "./core/logic";
-export { composeLogic } from "./core/compose";
-export { effect, takeLatest, debounce, retry } from "./core/effect";
-export { createSelector } from "./core/selector";
-export type { LogicPlugin } from "./core/plugin";
-export type { LogicRuntime } from "./core/types";
-export type { Timeline, IntentRecord } from "./core/timeline";
+export { createLogic } from "./runtime/logic";
+export { composeLogic } from "./runtime/compose";
+export { createBackendRuntime } from "./runtime/backend";
+export type { SimpleBackendCtx } from "./runtime/backend";
+export { createSignal } from "./state/signal";
+export { createStore } from "./state/store";
+export { createComputed } from "./state/computed";
+export { createSelector } from "./state/selector";
+export type { Subscriber } from "./state/signal";
+export { effect, takeLatest, debounce, retry, composeEffects } from "./core/effect";
+export { createIntentBus } from "./core/intent";
+export { compose as composeMiddleware } from "./core/middleware";
+export type { LogicRuntime, IntentHandler, Effect, EffectCtx, IntentMiddleware, Listener, } from "./core/types";
+export { attachDevtools } from "./devtools/devtools";
+export type { Timeline, IntentRecord, } from "./devtools/timeline";
 export { withLogic } from "./react/withLogic";

package/build/index.esm.js

@@ -1 +1 @@
-import{jsx as t}from"react/jsx-runtime";import*as e from"react";function n(t){let e=t;const n=new Set;return{get:()=>e,set(t){Object.is(e,t)||(e=t,n.forEach(t=>t()))},subscribe:t=>(n.add(t),()=>n.delete(t))}}function o(t){const e=new Map,n=new Map,o=new Map;return{on:function(t,n){const o=e.get(t)||[];o.push(n),e.set(t,o)},effect:function(t,e){const o=n.get(t)||[];o.push(e),n.set(t,o)},emit:async function(r,s,c){const a=(e=>`${t}:${e}`)(r),i=o.get(a);null==i||i.abort();const u=new AbortController;o.set(a,u);const l=e.get(r)||[],f=n.get(r)||[];for(const e of l){let n=e;for(let t=f.length-1;t>=0;t--)n=f[t](n);await n({state:c.getState(),payload:s,signal:u.signal,scope:t,emit:c.emit,setState:c.setState})}}}}function r(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:o=0,to:r=1/0,scope:s}=null!=n?n:{},c=e.filter(t=>"emit"===t.type&&t.id>=o&&t.id<=r&&(!s||t.scope===s));for(const e of c){const n=t(e.intent,e.payload);n instanceof Promise&&await n}},clear:function(){e=[],t=0}}}();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:t.scope,state:t.state(),timestamp:Date.now()});try{await n(o,r)}finally{e.record({type:"emit:end",intent:o,payload:r,scope:t.scope,state:t.state(),timestamp:Date.now()})}}}}}var s,c;let a=0;const i="production"!==(null===(c=null===(s=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===s?void 0:s.env)||void 0===c?void 0:c.NODE_ENV);const u=[],l=[];function f(t){var e;const n=null!==(e=t.name)&&void 0!==e?e:"logic";return{create(e){var s,c;const f=null!=e?e:`${n}:${++a}`,d=structuredClone(t.state),p=function(t){let e=t;const n=new Set;return{getState:function(){return e},setState:function(t){const o=e,r=structuredClone(o);t(r),Object.is(o,r)||(e=r,n.forEach(t=>t()))},subscribe:function(t){return n.add(t),()=>n.delete(t)}}}(structuredClone(t.state)),m=function(){const t=new Map,e=new Map,n=new Map;return{compute:function(n,o,r){if(t.has(n))return t.get(n);const s=new Set,c=o({state:new Proxy(r,{get:(t,e,n)=>("string"==typeof e&&e in t&&s.add(e),Reflect.get(t,e,n))})});return t.set(n,c),e.set(n,s),c},invalidate:function(o){e.forEach((e,r)=>{var s;e.has(o)&&(t.delete(r),null===(s=n.get(r))||void 0===s||s.forEach(t=>t()))})},subscribe:function(t,e){var o;const r=null!==(o=n.get(t))&&void 0!==o?o:new Set;return r.add(e),n.set(t,r),()=>r.delete(e)},reset:function(){t.clear(),e.clear(),n.forEach(t=>{t.forEach(t=>t())})}}}(),g=o(f);null===(s=t.intents)||void 0===s||s.call(t,g);let b=null,v=null;function h(){const e=p.getState();if(e===b&&v)return v;const n={};var o;return t.computed&&(o=t.computed,Object.keys(o)).forEach(o=>{n[o]=m.compute(o,t.computed[o],e)}),b=e,v=Object.assign({},e,n),v}function y(t){const e=p.getState();p.setState(n=>{t(n);for(const t in n)e[t]!==n[t]&&m.invalidate(t)})}const w={scope:f,state:()=>h(),setState:y,reset(){!function(){var t;p.setState(()=>structuredClone(d)),null===(t=m.reset)||void 0===t||t.call(m),b=null,v=null}()},async emit(t,e){const n=h();u.forEach(o=>o({intent:t,payload:e,state:n,scope:f}));try{await g.emit(t,e,{getState:h,setState:y,emit:w.emit})}finally{l.forEach(n=>n({intent:t,payload:e,state:h(),scope:f}))}},subscribe:p.subscribe,onIntent(t,e){g.on(t,e)},__internal:{onEmitStart(t){u.push(t)},onEmitEnd(t){l.push(t)}}};let S;return null===(c=t.plugins)||void 0===c||c.forEach(t=>t.setup(w)),i&&(S=r(w),S.wrap(w)),{...w,devtools:S}}}}function d(...t){return{create(e){const n=t.map(t=>{var n;if("logic"in t){const o=t.logic.create(null!==(n=t.namespace)&&void 0!==n?n:e);return{namespace:t.namespace,inst:o}}return{namespace:null,inst:t.create(e)}});return{get state(){const t={};for(const{namespace:e,inst:o}of n){const n=o.state();e?t[e]=n:Object.assign(t,n)}return t},async emit(t,e){const o=n.map(({inst:n})=>{var o;return null===(o=n.emit)||void 0===o?void 0:o.call(n,t,e)});return Promise.all(o.filter(Boolean))},subscribe(t){const e=n.map(e=>e.inst.subscribe(t));return()=>{e.forEach(t=>t())}}}}}}function p(){let t=null;return e=>async n=>(null==t||t.abort(),t=new AbortController,e({...n,signal:t.signal}))}function m(t){let e;return n=>o=>{clearTimeout(e),e=setTimeout(()=>n(o),t)}}function g(t=3){return e=>async n=>{let o;for(let r=0;r<t;r++)try{return await e(n)}catch(t){o=t}throw o}}function b(t){const e=[t],n=t=>{return(n=e,t=>n.reduceRight((t,e)=>e(t),t))(t);var n};return n.takeLatest=()=>(e.push(p()),n),n.debounce=t=>(e.push(m(t)),n),n.retry=(t=3)=>(e.push(g(t)),n),n}function v(t,e=Object.is){let n,o=null;return r=>{if(null!==o){const s=t(r);return e(n,s)?n:(n=s,o=r,s)}return o=r,n=t(r),n}}function h(n,o){var r,s;const c=r=>{const s=e.useRef(null);s.current||(s.current=n.create());const c=s.current,a=e.useSyncExternalStore(c.subscribe,c.state,c.state),i=e.useCallback((t,e)=>c.emit(t,e),[c]);return t(o,{...r,state:a,emit:i})};return c.displayName=`withLogic(${null!==(s=null!==(r=o.displayName)&&void 0!==r?r:o.name)&&void 0!==s?s:"View"})`,c}export{d as composeLogic,f as createLogic,v as createSelector,n as createSignal,m as debounce,b as effect,g as retry,p as takeLatest,h as withLogic};
+import{jsx as t}from"react/jsx-runtime";import*as e from"react";function n(t){let e=t;const n=new Set;return{getState:function(){return e},setState:function(t){const r=e,o=structuredClone(r);t(o),Object.is(r,o)||(e=o,n.forEach(t=>t()))},subscribe:function(t){return n.add(t),()=>n.delete(t)}}}function r(){const t=new Map,e=new Map,n=new Map;return{compute:function(n,r,o){if(t.has(n))return t.get(n);const s=new Set,a=r({state:new Proxy(o,{get:(t,e,n)=>("string"==typeof e&&e in t&&s.add(e),Reflect.get(t,e,n))})});return t.set(n,a),e.set(n,s),a},invalidate:function(r){e.forEach((e,o)=>{var s;e.has(r)&&(t.delete(o),null===(s=n.get(o))||void 0===s||s.forEach(t=>t()))})},subscribe:function(t,e){var r;const o=null!==(r=n.get(t))&&void 0!==r?r:new Set;return o.add(e),n.set(t,o),()=>o.delete(e)},reset:function(){t.clear(),e.clear(),n.forEach(t=>t.forEach(t=>t()))}}}function o(t,e=Object.is){let n,r=null;return o=>{if(null!==r){const s=t(o);return e(n,s)?n:(n=s,r=o,s)}return r=o,n=t(o),n}}function s(t){let e=t;const n=new Set;return{get:()=>e,set(t){Object.is(e,t)||(e=t,n.forEach(t=>t()))},subscribe:t=>(n.add(t),()=>n.delete(t))}}function a(t){const e=new Map,n=new Map,r=[],o=new Map;return{on:function(t,n){var r;const o=null!==(r=e.get(t))&&void 0!==r?r:[];o.push(n),e.set(t,o)},effect:function(t,e){var r;const o=null!==(r=n.get(t))&&void 0!==r?r:[];o.push(e),n.set(t,o)},emit:async function(s,a,i){var c,l;const u=`${t}:${s}`;null===(c=o.get(u))||void 0===c||c.abort();const f=new AbortController;o.set(u,f);const d=Array.from(e.entries()).filter(([t])=>function(t,e){return t.endsWith("/*")?e.startsWith(t.slice(0,-2)):t===e}(t,s)).flatMap(([,t])=>t),p=null!==(l=n.get(s))&&void 0!==l?l:[];for(const e of d){let n=e;for(let t=p.length-1;t>=0;t--)n=p[t](n);const o={state:i.getState(),payload:a,signal:f.signal,scope:t,emit:i.emit,setState:i.setState};let s=-1;const c=async t=>{if(t<=s)throw new Error("next() called multiple times");s=t;const e=r[t];if(!e)return n(o);await e(o,()=>c(t+1))};await c(0)}},use:function(t){r.push(t)}}}function i(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:r=0,to:o=1/0,scope:s}=null!=n?n:{},a=e.filter(t=>"emit"===t.type&&t.id>=r&&t.id<=o&&(!s||t.scope===s));for(const e of a){const n=t(e.intent,e.payload);n instanceof Promise&&await n}},clear:function(){e=[],t=0}}}();return{timeline:e,wrap:function(){const n=t.emit.bind(t);t.emit=async(r,o)=>{e.record({type:"emit:start",intent:r,payload:o,scope:t.scope,state:t.state(),timestamp:Date.now()});try{await n(r,o)}finally{e.record({type:"emit:end",intent:r,payload:o,scope:t.scope,state:t.state(),timestamp:Date.now()})}}}}}var c,l;let u=0;const f="production"!==(null===(l=null===(c=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===c?void 0:c.env)||void 0===l?void 0:l.NODE_ENV);function d(t){var e;const o=null!==(e=t.name)&&void 0!==e?e:"logic";return{create(e){var s,c;const l=null!=e?e:`${o}:${++u}`,d=structuredClone(t.state),p=n(structuredClone(t.state)),m=r(),v=a(l);null===(s=t.intents)||void 0===s||s.call(t,v);let h=null,b=null,g=!1,y=new Set;const w=[],E=[];function S(){const e=p.getState();if(e===h&&b)return b;const n={};var r;return t.computed&&(r=t.computed,Object.keys(r)).forEach(r=>{n[r]=m.compute(r,t.computed[r],e)}),h=e,b=Object.assign({},e,n),b}function C(t){const e=p.getState();p.setState(n=>{t(n);for(const t in n)e[t]!==n[t]&&(g?y.add(t):m.invalidate(t))})}const j={scope:l,state:()=>S(),setState:C,reset(){!function(){var t;p.setState(()=>structuredClone(d)),null===(t=m.reset)||void 0===t||t.call(m),h=null,b=null}()},use:v.use,effect:v.effect,batch:function(t){g=!0;try{t()}finally{g=!1,y.forEach(t=>m.invalidate(t)),y.clear()}},async emit(t,e){const n=S();w.forEach(r=>r({intent:t,payload:e,state:n,scope:l}));try{await v.emit(t,e,{getState:S,setState:C,emit:j.emit})}finally{E.forEach(n=>n({intent:t,payload:e,state:S(),scope:l}))}},subscribe:p.subscribe,onIntent(t,e){v.on(t,e)},__internal:{onEmitStart(t){w.push(t)},onEmitEnd(t){E.push(t)}}};let O;return null===(c=t.plugins)||void 0===c||c.forEach(t=>t.setup(j)),f&&(O=i(j),O.wrap(j)),{...j,devtools:O}}}}function p(...t){return{create(e){const n=t.map(t=>{var n,r;if("logic"in t){const o=t.logic.create(null!==(n=t.namespace)&&void 0!==n?n:e);return{namespace:null!==(r=t.namespace)&&void 0!==r?r:null,inst:o}}return{namespace:null,inst:t.create(e)}});return{get state(){const t={};for(const{namespace:e,inst:r}of n){const n=r.state();e?t[e]=n:Object.assign(t,n)}return t},async emit(t,e){const r=n.map(n=>{var r,o;return null===(o=(r=n.inst).emit)||void 0===o?void 0:o.call(r,t,e)}).filter(Boolean);await Promise.all(r)},subscribe(t){const e=n.map(e=>e.inst.subscribe(t));return()=>e.forEach(t=>t())}}}}}function m(t){return e=>t.reduceRight((t,e)=>e(t),e)}function v(){let t=null;return e=>async n=>{if(null==t||t.abort(),t=new AbortController,!t.signal.aborted)return e({...n,signal:t.signal})}}function h(t){let e;return n=>r=>new Promise(o=>{clearTimeout(e),e=setTimeout(()=>o(n(r)),t)})}function b(t=3){return e=>async n=>{let r;for(let o=0;o<t;o++)try{return await e(n)}catch(t){if(n.signal.aborted)return;r=t}throw r}}function g(t){const e=[e=>async n=>{if(!n.signal.aborted)return await t(n),e(n)}];let n=!1;const r=t=>(n=!0,m(e))(t);return r.takeLatest=()=>{if(n)throw new Error("Effect already built");return e.push(v()),r},r.debounce=t=>{if(n)throw new Error("Effect already built");return e.push(h(t)),r},r.retry=(t=3)=>{if(n)throw new Error("Effect already built");return e.push(b(t)),r},r}function y(t){var e,n;let o=structuredClone(t);const s=r(),c=a("backend"),l=[],u=[];let f=!1,d=new Set;function p(t){const e=structuredClone(o);if(t(o),f)for(const t in o)e[t]!==o[t]&&d.add(t);else for(const t in o)e[t]!==o[t]&&s.invalidate(t)}function m(t){return{...t,set(t){p(e=>Object.assign(e,t))},emit:v.emit}}const v={state:()=>o,setState:p,batch:function(t){f=!0;try{t()}finally{f=!1,d.forEach(t=>s.invalidate(t)),d.clear()}},async emit(t,e){l.forEach(n=>n({intent:t,payload:e,state:structuredClone(o)}));try{await c.emit(t,e,{getState:()=>o,setState:p,emit:v.emit})}finally{u.forEach(n=>n({intent:t,payload:e,state:structuredClone(o)}))}},onIntent:c.on,effect:c.effect,use:c.use,registerIntents:function(t){for(const e in t){const n=t[e];c.on(e,async t=>{await n(m({state:o,signal:t.signal}))})}},__internal:{onEmitStart(t){l.push(t)},onEmitEnd(t){u.push(t)}},reset:function(){o=structuredClone(t),s.reset()}};if("production"!==(null===(n=null===(e=null===globalThis||void 0===globalThis?void 0:globalThis.process)||void 0===e?void 0:e.env)||void 0===n?void 0:n.NODE_ENV)){const t=i(v);t.wrap(v),v.devtools=t}return v}function w(t){return function(e,n){let r=-1;return function o(s){if(s<=r)return Promise.reject(new Error("next() called multiple times"));r=s;const a=t[s]||n;return a?Promise.resolve(a(e,()=>o(s+1))):Promise.resolve()}(0)}}function E(n,r,o){var s,a;const i=s=>{const a=e.useRef(null);a.current||(a.current=n.create(o));const i=a.current,c=e.useSyncExternalStore(i.subscribe,i.state,i.state),l=e.useCallback((t,e)=>i.emit(t,e),[i]);return t(r,{...s,state:c,emit:l})};return i.displayName=`withLogic(${null!==(a=null!==(s=r.displayName)&&void 0!==s?s:r.name)&&void 0!==a?a:"View"})`,i}export{i as attachDevtools,m as composeEffects,p as composeLogic,w as composeMiddleware,y as createBackendRuntime,r as createComputed,a as createIntentBus,d as createLogic,o as createSelector,s as createSignal,n as createStore,h as debounce,g as effect,b as retry,v as takeLatest,E as withLogic};

package/build/{core/plugin.d.ts → plugins/index.d.ts}

@@ -1,4 +1,4 @@
-import type { LogicRuntime } from "./types";
+import type { LogicRuntime } from "../core";
 export type LogicPlugin<S extends object, C extends object = {}> = {
     name: string;
     setup(runtime: LogicRuntime<S, C>): void;

package/build/react/withLogic.d.ts

@@ -10,5 +10,5 @@ type LogicFactory<S> = {
 export declare function withLogic<S, P extends object>(logic: LogicFactory<S>, View: React.ComponentType<P & {
     state: Readonly<S>;
     emit: (intent: string, payload?: any) => Promise<void>;
-}>): React.FC<Omit<P, "state" | "emit">>;
+}>, scope?: string): React.FC<Omit<P, "state" | "emit">>;
 export {};

package/build/runtime/backend.d.ts

@@ -0,0 +1,29 @@
+export type SimpleBackendCtx<S> = {
+    state: Readonly<S>;
+    set: (patch: Partial<S>) => void;
+    emit: (intent: string, payload?: any) => Promise<void>;
+    signal: AbortSignal;
+};
+export declare function createBackendRuntime<S extends object>(initial: S): {
+    state(): S;
+    setState: (mutator: (s: S) => void) => void;
+    batch: (fn: () => void) => void;
+    emit(intent: string, payload?: any): Promise<void>;
+    onIntent: (intent: string, handler: import("../core").IntentHandler<S, S, any>) => void;
+    effect: (intent: string, fx: import("../core").Effect<S, S, any>) => void;
+    use: (mw: import("../core").IntentMiddleware<S, S, any>) => void;
+    registerIntents: (intentsObj: Record<string, (ctx: SimpleBackendCtx<S>) => void | Promise<void>>) => void;
+    __internal: {
+        onEmitStart(fn: (ctx: {
+            intent: string;
+            payload: any;
+            state: S;
+        }) => void): void;
+        onEmitEnd(fn: (ctx: {
+            intent: string;
+            payload: any;
+            state: S;
+        }) => void): void;
+    };
+    reset: () => void;
+};

package/build/{core → runtime}/compose.d.ts

@@ -1,6 +1,6 @@
 type LogicInstance = {
     state(): any;
-    emit?: (intent: string, payload?: any) => any | Promise<any>;
+    emit?: (intent: string, payload?: any) => Promise<any> | any;
     subscribe(fn: () => void): () => void;
 };
 type ComposedLogic = {
@@ -14,7 +14,7 @@ type ComposedLogic = {
 export declare function composeLogic(...entries: ComposedLogic[]): {
     create(scope?: string): {
         readonly state: any;
-        emit(intent: string, payload?: any): Promise<any[]>;
+        emit(intent: string, payload?: any): Promise<void>;
         subscribe(fn: () => void): () => void;
     };
 };

package/build/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export { createLogic } from "./logic";
+export { createBackendRuntime } from "./backend";
+export { composeLogic } from "./compose";

package/build/{core → runtime}/logic.d.ts

@@ -1,5 +1,5 @@
-import type { LogicRuntime, IntentHandler, Effect } from "./types";
-import type { LogicPlugin } from "./plugin";
+import type { LogicRuntime, IntentHandler, Effect } from "../core/types";
+import { LogicPlugin } from "../plugins";
 type ComputedDef<S, C> = {
     [K in keyof C]: (ctx: {
         state: S;

package/build/state/index.d.ts

@@ -0,0 +1,4 @@
+export { createStore } from "./store";
+export { createComputed } from "./computed";
+export { createSelector } from "./selector";
+export { createSignal } from "./signal";

package/build/{core → state}/store.d.ts

@@ -1,4 +1,4 @@
-import { Listener } from "./types";
+import { Listener } from "../core/types";
 export declare function createStore<S extends object>(initial: S): {
     getState: () => S;
     setState: (mutator: (s: S) => void) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logic-runtime-react-z",
-  "version": "1.0.1",
+  "version": "2.0.1",
   "description": "Intent-first runtime for React. No hooks. Deterministic state. Orchestrated effects.",
   "license": "MIT",
   "author": "Delpi.Kye",

package/build/{core → devtools}/devtools.d.ts

@@ -5,8 +5,8 @@ export type Devtools = {
 };
 type RuntimeLike = {
     scope: string;
-    emit(intent: string, payload?: any): Promise<void>;
     state(): any;
+    emit(intent: string, payload?: any): Promise<void>;
 };
 export declare function attachDevtools(target: RuntimeLike): Devtools;
 export {};