logic-runtime-react-z 1.0.0 → 2.0.0

package/README.md

@@ -1,215 +1,323 @@
-## 🔀 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)
 
-<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**.
+**logic-runtime-react-z** is an **intent-first business logic runtime**  
+designed to run **outside React**, with React acting purely as a view layer.
 
-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.”**
+> **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
+
+Use this library when:
+
+- You want **zero hooks inside UI components**
+- Business logic must not depend on React lifecycle
+- UI should **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
+- You want **headless testing** without rendering
+- You prefer **architecture-driven** design
 
 ---
 
 ## 🧠 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
-```
+![Architecture Diagram](https://github.com/delpikye-v/logic-runtime-react/raw/main/architect.png)
 
-- React is just an adapter.
-- The runtime owns behavior.
+- React is only an adapter
+- Runtime owns all behavior
 
 ---
 
 ## 📦 Installation
-```ts
+
+```bash
 npm install logic-runtime-react-z
 ```
+
 ---
 
-## Basic
+## Examples
+#### 1. Headless (No React)
+
 ```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++ })
+      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)
+#### ⚛️ 2. With React (No Hooks in View)
 
 ```ts
-import { createLogic, withLogic, createSelector } from "logic-runtime-react-z"
+import {
+  createLogic,
+  withLogic,
+} from "logic-runtime-react-z"
 
 interface State {
-  count: number;
-
-  // computed
+  count: number
   double: number
 }
 
 const counterLogic = createLogic({
   name: "counter",
+
   state: { count: 1 },
 
   computed: {
-    double({ state }): number {
+    double({ state }) {
       return state.count * 2
-    }
+    },
   },
 
   intents: bus => {
-    bus.on("inc", ({ state, setState }) => {
-      // if (!selectIsAdult(state)) {
-      //   throw new Error("Not allowed")
-      // }
-
+    bus.on("inc", ({ setState }) => {
       setState(s => {
         s.count++
       })
     })
+
+    bus.on("inc-payload", ({ payload, setState }) => {
+      setState(s => {
+        s.count += payload
+      })
+    })
   },
 })
 
-// Pure View (No Hooks)
+// Pure View (no hooks)
 function CounterView({
   state,
   emit,
 }: {
   state: State
-  emit: (intent: string) => void
+  emit: (intent: string, payload?: any) => void
 }) {
   return (
     <div>
       <div>Count: {state.count}</div>
-      // <button
-      //   onClick={async () => {
-      //     try {
-      //       await emit("inc")
-      //       console.log("done")
-      //     } catch (e) {
-      //       console.error(e)
-      //     }
-      //   }}
-      // >
-      //   +
-      // </button>
       <div>Double: {state.double}</div>
+
       <button onClick={() => emit("inc")}>+</button>
+      <button onClick={() => emit("inc-payload", 5)}>+5</button>
     </div>
   )
 }
 
-// Bind Logic to React
+// Bind logic to React
 export const Counter = withLogic(counterLogic, CounterView)
+
 ```
+---
 
-## 🧪 No React
-```ts
+#### 🧪 3. Testing (No React)
 
-// import { createLogic } from "logic-runtime-react-z"
-const counterLogic = createLogic({
-  state: {
-    count: 0
-  },
+```ts
+// no render, no React
+const logic = createLogic({
+  state: { value: 0 },
 
   computed: {
-    double({ state }) {
-      return state.count * 2
-    }
+    squared({ state }) {
+      return state.value * state.value
+    },
   },
 
   intents: bus => {
-    bus.on("inc", ({ state, setState }) => {
-      // state is READONLY snapshot (read-only)
-      // ❌ state.count++
+    bus.on("set", ({ payload, setState }) => {
       setState(s => {
-        s.count += 1
-      })
-    })
-
-    // Intent handlers can be sync or async
-    bus.on("add", ({ payload, setState }) => {
-      setState(s => {
-        s.count += payload
-      })
-    })
-
-    bus.on("reset", ({ setState }) => {
-      setState(s => {
-        s.count = 0
+        s.value = payload
       })
     })
   },
 })
 
-// initial
-// const runtime = counterLogic.create()
-const runtime = counterLogic.create("counter:main")
+const runtime = logic.create()
+
+await runtime.emit("set", 4)
 
-runtime.emit("inc")
-// await runtime.emit("inc") // if async
-runtime.emit("add", 5)
+expect(runtime.state.squared).toBe(16)
 
-// console.log
-console.log(runtime.state.count)   // 7
-console.log(runtime.state.double)   // 14
 ```
 
 ---
 
-## 🧩 Plugins – Runtime extensions (cross-cutting concerns)
+## Backend Runtime
+
+```perl
+HTTP / Queue / Cron
+        ↓
+     emit(intent)
+        ↓
+   middleware / effects
+        ↓
+     intent handlers
+        ↓
+     mutate state
+        ↓
+   emit next intent
+```
 
-#### Plugins extend the runtime behavior **without touching business logic**.
 
+#### 🚀 1. Backend Runtime 
 ```ts
-export const authPlugin: LogicPlugin = {
-  name: "auth",
+1️⃣ // create backend
+import { createBackendRuntime } from "logic-runtime-react-z"
 
-  setup(runtime) {
-    runtime.onIntent("delete", ctx => {
-      if (!ctx.state.user?.isAdmin) {
-        throw new Error("Forbidden")
-      }
-    })
+type BackendState = {
+  user: null | {
+    id: string
+    name: string
+  }
+  token: string | null
+  loading: boolean
+}
+
+const runtime = createBackendRuntime<BackendState>({
+  user: null,
+  token: null,
+  loading: false,
+})
+
+// middleware
+runtime.use(async (ctx, next) => {
+  console.log("➡️ intent:", ctx.intent, ctx.payload)
+  console.log("   state before:", ctx.state)
+
+  const start = Date.now()
+  await next()
+
+  console.log("⬅️ intent:", ctx.intent)
+  console.log("   state after:", ctx.state)
+  console.log("   took:", Date.now() - start, "ms")
+})
+
+2️⃣ // register handler
+runtime.onIntent("login", async ({
+  payload,
+  setState,
+  emit,
+}) => {
+  setState(s => {
+    s.loading = true
+  })
+
+  // fake API
+  const result = await fakeLoginApi(payload)
+
+  setState(s => {
+    s.user = result.user
+    s.token = result.token
+    s.loading = false
+  })
+
+  // chain intent
+  await emit("login:success", result.user)
+})
+
+runtime.onIntent("login:success", ({ payload }) => {
+  console.log("✅ login success:", payload.name)
+})
+
+// 3️⃣ Add side-effects (effects)
+runtime.effect("login", next => async ctx => {
+  console.log("→ login start")
+  await next(ctx)
+  console.log("← login end")
+})
+
+// 4️⃣ Emit intent (entry point)
+await runtime.emit("login", {
+  username: "admin",
+  password: "123456",
+})
+
+console.log(runtime.state().user)
+/*
+{
+  id: "u1",
+  name: "Admin"
+}
+*/
+
+// 5️⃣ Subscribe state changes (optional)
+runtime.subscribe(() => {
+  console.log("🔄 state changed:", runtime.state())
+})
+
+// 6️⃣ Fake API (for demo)
+async function fakeLoginApi(payload: {
+  username: string
+  password: string
+}) {
+  await new Promise(r => setTimeout(r, 500))
+
+  return {
+    user: {
+      id: "u1",
+      name: payload.username,
+    },
+    token: "jwt-token",
   }
 }
+```
+
+---
+
+#### 🧪 2. Testing Example
+```ts
+await runtime.emit("login", {
+  username: "admin",
+  password: "123456",
+})
+
+expect(runtime.state().user?.name).toBe("admin")
+expect(runtime.state().loading).toBe(false)
+
+```
+
+---
+
+## Utility
+
+#### 🧩 Plugins (Cross-cutting Concerns)
+
+Plugins extend runtime behavior **without touching business logic**.
+
+```ts
+import type { LogicPlugin } from "logic-runtime-react-z"
 
 export const persistPlugin: LogicPlugin = {
   name: "persist",
@@ -221,128 +329,281 @@ export const persistPlugin: LogicPlugin = {
         JSON.stringify(runtime.state)
       )
     })
-  }
+  },
+}
+
+```
+
+---
+
+#### ⚡ Effects (Async / Side-effects)
+
+Effects are **middleware-style intent interceptors**, not React effects.
+
+##### Built-in effects
+- `takeLatest`
+- `debounce`
+- `retry`
+
+```ts
+import { effect } from "logic-runtime-react-z"
+
+const logEffect = effect(next => async ctx => {
+  console.log("→", ctx.intent)
+  await next(ctx)
+  console.log("←", ctx.intent)
+})
+
+intents: bus => {
+  bus.effect("save", logEffect)
+
+  bus.on("save", async ({ state }) => {
+    await api.save(state.form)
+  })
 }
+
+```
+##### Built-in helpers
+- takeLatest()
+- debounce(ms)
+- retry(times)
+
+```ts
+bus.effect(
+  "search",
+  logEffect.debounce(300).takeLatest()
+)
 ```
 
 ---
 
-## ⚡ Async Effects + Selectors (Advanced Usage)
+#### 🧮 Selectors
 
-#### createSelector
-Selectors are pure functions that derive data from state.  
-They are read-only, memoized, and safe to reuse anywhere (runtime, effects, intents).  
+Selectors are pure, memoized, reusable functions.
 
 ```ts
 import { createSelector } from "logic-runtime-react-z"
 
 const selectIsAdult = createSelector(
-  (state: { age: number }) => state.age,
-  age => age >= 18
+  (state: { age: number }) => state.age >= 18
 )
+
 ```
 
-#### 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
+#### 🧭 Devtools & Timeline
+
+- Records every intent
+- Replayable
+- Deterministic async flow
 
 ```ts
-import { effect, debounce, retry, takeLatest } from "logic-runtime-react-z"
+runtime.devtools?.timeline.replay(runtime.emit)
+```
+
+###### You can:
+
+- time-travel intents
+- replay async flows deterministically
+- debug without UI
+
+---
 
-const withLogging = effect(next => {
-  return async ctx => {
-    console.log("saving...")
-    await next(ctx)
+## 🔍 Comparison
+
+| Feature             | logic-runtime-react-z | Redux | Zustand   |
+| ------------------- | --------------------- | ----- | -------   |
+| No-hook UI          | ✅                     | ❌     | ❌       |
+| Intent-first        | ✅                     | ❌     | ❌       |
+| Async orchestration | ✅                     | ⚠️    | ⚠️        |
+| Computed graph      | ✅                     | ❌     | ❌       |
+| Headless testing    | ✅                     | ⚠️    | ⚠️        |
+| Devtools replay     | ✅                     | ⚠️    | ❌        |
+
+---
+
+## 🚫 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
+
+✅ Correct
+
+```ts
+runtime.emit("login")
+```
+
+```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
-    })
-  })
+```ts
+runtime.emit("login", payload)
+```
+Intent is the only entry point. Always.
 
-  // bus.effect("save", debounce(300))
-  // bus.effect("save", retry(2))
-  // bus.effect("save", takeLatest())
+#### ❌ 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
+
+✅ Correct
+
+```ts
+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
 
-## 🧭 Devtools & Timeline
-- Every intent is recorded
-- Replayable
-- Deterministic async flows
+- Intent should describe user or system intention
+- Not raw state mutation
+
+✅ Correct
 
 ```ts
-// devtool process.env.NODE_ENV !== "production"
-runtime.devtools?.timeline.replay(runtime.emit)
+emit("login:start")
+emit("login:success", user)
+emit("login:failed", error)
 ```
+Intents are verbs, not patches.
 
----
+#### ❌ 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
 
-## Props
+✅ Correct
 
-| 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.).              |
+```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
 
-## 🔍 Comparison
+✅ Correct
 
-| Feature         | logic-runtime-react-z  | Redux | Zustand  |
-| --------------- | ----------------------  | ----- | -------- |
-| No-hook UI      | ✅                      | ❌     | ❌       |
-| Intent-first    | ✅                      | ❌     | ❌       |
-| Async built-in  | ✅                      | ⚠️     | ⚠️       |
-| Computed graph  | ✅                      | ❌     | ❌       |
-| Headless test   | ✅                      | ⚠️     | ⚠️       |
-| Devtools replay | ✅                      | ⚠️     | ❌       |
+```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
 
-> This comparison focuses on **architecture and mental model**, not ecosystem size.
+✅ Correct
 
----
+```ts
+composeLogic(
+  userLogic,
+  cartLogic,
+  productLogic
+)
+```
 
-## 🚫 What this library is NOT
+---
 
-- ❌ Not a React state manager
-- ❌ Not a replacement for Redux Toolkit
-- ❌ Not a UI framework
-- ❌ Not tied to React (runtime is headless)
+## 🧠 Philosophy
 
-It is a **behavior runtime**.
+- If it can’t be tested without React, it doesn’t belong in React.
+- If it bypasses emit, it doesn’t belong in the system.
 
 ---
 
 ## 📜 License
 
-MIT
+MIT / Delpi

package/build/core/backend-runtime.d.ts

@@ -0,0 +1,9 @@
+export declare function createBackendRuntime<S extends object>(initial: S): {
+    state(): S;
+    setState(fn: (s: S) => void): void;
+    emit(intent: string, payload?: any): Promise<void>;
+    onIntent: (intent: string, handler: import("./types").IntentHandler<S, S, any>) => void;
+    effect: (intent: string, fx: import("./types").Effect<S, S, any>) => void;
+    use: (mw: import("./types").IntentMiddleware<S, S, any>) => void;
+    reset(): void;
+};

package/build/core/compose.d.ts

@@ -1,5 +1,5 @@
-type LogicInstance = {
-    state(): any;
+type LogicInstance<S = any> = {
+    readonly state: S;
     emit?: (intent: string, payload?: any) => any | Promise<any>;
     subscribe(fn: () => void): () => void;
 };
@@ -13,17 +13,8 @@ type ComposedLogic = {
 };
 export declare function composeLogic(...entries: ComposedLogic[]): {
     create(scope?: string): {
-        /**
-         * merged state
-         */
         readonly state: any;
-        /**
-         * ASYNC emit
-         */
         emit(intent: string, payload?: any): Promise<any[]>;
-        /**
-         * subscription fan-out
-         */
         subscribe(fn: () => void): () => void;
     };
 };

package/build/core/devtools.d.ts

@@ -1,18 +1,12 @@
 import { Timeline } from "./timeline";
-/**
- * Devtools public API
- */
 export type Devtools = {
     timeline: Timeline;
     wrap(runtime: RuntimeLike): void;
 };
-/**
- * Minimal runtime surface for devtools
- */
 type RuntimeLike = {
     scope: string;
+    get state(): any;
     emit(intent: string, payload?: any): Promise<void>;
-    state(): any;
 };
 export declare function attachDevtools(target: RuntimeLike): Devtools;
 export {};

package/build/core/effect.d.ts

@@ -1,16 +1,7 @@
 import type { Effect } from "./types";
 export declare function composeEffects<W, R>(effects: Effect<W, R>[]): Effect<W, R>;
-/**
- * takeLatest
- */
 export declare function takeLatest<W, R>(): Effect<W, R>;
-/**
- * debounce
- */
 export declare function debounce<W, R>(ms: number): Effect<W, R>;
-/**
- * retry
- */
 export declare function retry<W, R>(count?: number): Effect<W, R>;
 export type EffectBuilder<W, R> = Effect<W, R> & {
     takeLatest(): EffectBuilder<W, R>;

package/build/core/intent.d.ts

@@ -1,11 +1,11 @@
-import type { IntentHandler, Effect } from "./types";
-export declare function createIntentBus<W extends object, // Writable State
-R extends object = W, // Read State (snapshot / derived)
-P = any>(scope: string): {
+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>;
     }) => 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/timeline.d.ts

@@ -8,25 +8,10 @@ export type IntentRecord<S = any> = {
     readonly state: Readonly<S>;
     readonly timestamp: number;
 };
-/**
- * Unified emit function:
- * - sync emit → void
- * - async emit → Promise<void>
- */
 export type EmitFn = (intent: string, payload?: any) => void | Promise<void>;
 export type Timeline<S = any> = {
-    /** immutable snapshot */
     readonly records: readonly IntentRecord<S>[];
-    /** record one event */
     record(entry: Omit<IntentRecord<S>, "id">): void;
-    /**
-     * Replay intent records.
-     *
-     * ⚠️ Notes:
-     * - only replays `type === "emit"`
-     * - replay is sequential
-     * - replay does NOT record new timeline entries
-     */
     replay(emit: EmitFn, options?: {
         from?: number;
         to?: number;

package/build/core/types.d.ts

@@ -1,25 +1,24 @@
 import type { Timeline } from "./timeline";
 export type Listener = () => void;
 export type EffectCtx<W = any, R = W, P = any> = {
-    /** full snapshot: base + computed */
     state: Readonly<R>;
     payload: P;
     signal: AbortSignal;
     scope: string;
-    /** only base state is mutable */
+    emit(intent: string, payload?: any): Promise<void>;
     setState: (fn: (s: W) => void) => void;
 };
 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;
-    /** full snapshot */
-    state(): Readonly<S & C>;
-    /** base state only */
+    get state(): Readonly<S & C>;
     setState(mutator: (s: S) => void): void;
     reset(): void;
-    /** await full intent pipeline */
+    batch(fn: () => void): void;
     emit(intent: string, payload?: any): Promise<void>;
+    use(mw: IntentMiddleware<S, S & C>): void;
     subscribe(fn: Listener): () => void;
     onIntent(intent: string, handler: IntentHandler<S, S & C>): void;
     devtools?: {

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,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})}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 a(t){const e=new Map,n=new Map,r=[],o=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(a,c,s){const i=(e=>`${t}:${e}`)(a),u=o.get(i);null==u||u.abort();const l=new AbortController;o.set(i,l);const f=(d=r,async(t,e)=>{let n=-1;await async function r(o){if(o<=n)throw new Error("next() called multiple times");n=o;const a=d[o];if(!a)return e();await a(t,()=>r(o+1))}(0)});var d;const p=Array.from(e.entries()).filter(([t])=>function(t,e){return t.endsWith("/*")?e.startsWith(t.slice(0,-2)):t===e}(t,a)).flatMap(([,t])=>t),m=n.get(a)||[];for(const e of p){let n=e;for(let t=m.length-1;t>=0;t--)n=m[t](n);const r={state:s.getState(),payload:c,signal:l.signal,scope:t,emit:s.emit,setState:s.setState};await f(r,async()=>{await n(r)})}},use:function(t){r.push(t)}}}function c(t){const e=function(){let t=0,e=[];return{get records(){return e.slice()},record:function(n){e.push({...n,id:++t,state:structuredClone(n.state)})},replay:async function(t,n){const{from:r=0,to:o=1/0,scope:a}=null!=n?n:{},c=e.filter(t=>"emit"===t.type&&t.id>=r&&t.id<=o&&(!a||t.scope===a));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(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 s=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);function u(){let t=null;return e=>async n=>{null==t||t.abort(),t=new AbortController;const r=t.signal;if(!r.aborted)try{return await e({...n,signal:r})}catch(t){if(r.aborted)return;throw t}}}function l(t){let e;return n=>r=>new Promise((o,a)=>{clearTimeout(e),e=setTimeout(()=>{Promise.resolve(n(r)).then(o,a)},t)})}function f(t=3){return e=>async n=>{var r;let o;for(let a=0;a<t;a++)try{return await e(n)}catch(t){if(null===(r=n.signal)||void 0===r?void 0:r.aborted)return;o=t}throw o}}exports.attachDevtools=c,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).map(t=>t.catch(t=>console.error(t))))},subscribe(t){const e=n.map(e=>e.inst.subscribe(t));return()=>{e.forEach(t=>t())}}}}}},exports.createBackendRuntime=function(t){let e=structuredClone(t);const n=a("backend"),r={state:()=>e,setState(t){t(e)},async emit(t,o){await n.emit(t,o,{getState:()=>e,setState:t=>t(e),emit:r.emit})},onIntent:n.on,effect:n.effect,use:n.use,reset(){e=structuredClone(t)}};return r},exports.createLogic=function(t){var e;const n=null!==(e=t.name)&&void 0!==e?e:"logic";return{create(e){var r,o;const u=null!=e?e:`${n}:${++s}`,l=structuredClone(t.state),f=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)),d=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 a=new Set,c=r({state:new Proxy(o,{get:(t,e,n)=>("string"==typeof e&&e in t&&a.add(e),Reflect.get(t,e,n))})});return t.set(n,c),e.set(n,a),c},invalidate:function(r){e.forEach((e,o)=>{var a;e.has(r)&&(t.delete(o),null===(a=n.get(o))||void 0===a||a.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())})}}}(),p=a(u);null===(r=t.intents)||void 0===r||r.call(t,p);const m=[],b=[];let h=null,g=null,y=!1,w=new Set;function v(){const e=f.getState();if(e===h&&g)return g;const n={};var r;return t.computed&&(r=t.computed,Object.keys(r)).forEach(r=>{n[r]=d.compute(r,t.computed[r],e)}),h=e,g=Object.assign({},e,n),g}function E(t){const e=f.getState();f.setState(n=>{t(n);for(const t in n)e[t]!==n[t]&&(y?w.add(t):d.invalidate(t))})}const S={scope:u,get state(){return v()},setState:E,reset:function(){var t;f.setState(()=>structuredClone(l)),null===(t=d.reset)||void 0===t||t.call(d),h=null,g=null},batch:function(t){y=!0;try{t()}finally{y=!1,w.forEach(t=>d.invalidate(t)),w.clear()}},async emit(t,e){const n=v();m.forEach(r=>r({intent:t,payload:e,state:n,scope:u}));try{await p.emit(t,e,{getState:v,setState:E,emit:S.emit})}finally{b.forEach(n=>n({intent:t,payload:e,state:v(),scope:u}))}},subscribe:f.subscribe,onIntent(t,e){p.on(t,e)},use:p.use,__internal:{onEmitStart(t){m.push(t)},onEmitEnd(t){b.push(t)}}};let x;return null===(o=t.plugins)||void 0===o||o.forEach(t=>t.setup(S)),i&&(x=c(S),x.wrap(S)),{...S,devtools:x}}}},exports.createSelector=function(t,e=Object.is){let n,r=null;return o=>{if(null!==r){const a=t(o);return e(n,a)?n:(n=a,r=o,a)}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=l,exports.effect=function(t){const e=[t];let n=!1;const r=t=>{return(n=!0,r=e,t=>r.reduceRight((t,e)=>e(t),t))(t);var r};return r.takeLatest=()=>{if(n)throw new Error("Effect already built");return e.push(u()),r},r.debounce=t=>{if(n)throw new Error("Effect already built");return e.push(l(t)),r},r.retry=(t=3)=>{if(n)throw new Error("Effect already built");return e.push(f(t)),r},r},exports.retry=f,exports.takeLatest=u,exports.withLogic=function(e,n){var r,a;const c=r=>{const a=o.useRef(null);a.current||(a.current=e.create());const c=a.current,s=o.useSyncExternalStore(c.subscribe,()=>c.state,()=>c.state),i=o.useCallback((t,e)=>c.emit(t,e),[c]);return t.jsx(n,{...r,state:s,emit:i})};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

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

package/build/react/withLogic.d.ts

@@ -1,10 +1,6 @@
 import * as React from "react";
-/**
- * Logic instance surface for React adapter
- * (matches LogicRuntime)
- */
 type LogicInstance<S> = {
-    state(): Readonly<S>;
+    readonly state: Readonly<S>;
     emit(intent: string, payload?: any): Promise<void>;
     subscribe(fn: () => void): () => void;
 };

package/package.json

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