react-intent-engine-z 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Delpi.Kye
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,200 @@
+## 📘 react-intent-engine-z
+
+- Intent-first orchestration engine for React
+- Decouple UI from async flows, side effects, and business logic.
+
+---
+
+#### ✨ Why react-intent-engine-z?
+
+- Modern React apps often suffer from:
+
+- Business logic leaking into components
+
+- Complex async flows spread across hooks
+
+- Hard-to-test side effects
+
+- Overloaded global stores
+
+- react-intent-engine solves this by introducing an intent-driven architecture:
+
+  - Components declare what they want to do — the engine decides how it happens.
+
+- Works great with:
+
+  - react-scoped-store
+
+  - React Query / TanStack Query
+
+  - Hexagonal / DDD architectures
+
+---
+
+#### 📦 Installation
+```ts
+npm install react-intent-engine-z use-sync-external-store
+```
+
+- use-sync-external-store is required for React 17 compatibility.
+
+---
+
+#### 🧠 Mental Model
+```ts
+UI
+ └─ emit intent
+        ↓
+Intent Engine
+ ├─ async orchestration
+ ├─ business rules
+ └─ side effects
+ ```
+
+---
+
+#### 🚀 Basic Usage
+##### 1️⃣ Create engine
+
+```ts
+import { createIntentEngine } from "react-intent-engine-z"
+
+export const engine = createIntentEngine({
+  initialState: {
+    auth: {
+      user: null,
+      loading: false,
+    },
+  },
+  effects: {
+    auth: {
+      login: async ({ email, password }) => {
+        await new Promise(r => setTimeout(r, 500))
+        return { id: 1, email }
+      },
+    },
+  },
+})
+```
+
+##### 2️⃣ Register intent handlers
+```ts
+engine.on("auth.login.submit", async (intent, ctx) => {
+  ctx.set("auth.loading", true)
+
+  const user = await ctx.effects.auth.login(intent.payload)
+
+  ctx.set("auth.user", user)
+  ctx.set("auth.loading", false)
+})
+```
+
+##### 3️⃣ Provide engine to React
+```ts
+import { IntentProvider } from "react-intent-engine-z"
+
+<IntentProvider engine={engine}>
+  <App />
+</IntentProvider>
+```
+
+##### 4️⃣ Emit intent from UI
+```ts
+import { useIntent, useIntentState } from "react-intent-engine-z"
+
+function LoginButton() {
+  const emit = useIntent()
+  const loading = useIntentState(s => s.auth.loading)
+
+  return (
+    <button
+      disabled={loading}
+      onClick={() =>
+        emit({
+          type: "auth.login.submit",
+          payload: { email: "a@b.com", password: "123" },
+        })
+      }
+    >
+      Login
+    </button>
+  )
+}
+```
+
+- UI components never call APIs or use cases directly.
+
+##### 🔄 Intent Status
+- Track lifecycle state of an intent:
+```ts
+import { useIntentStatus } from "react-intent-engine-z"
+
+const status = useIntentStatus("auth.login.submit")
+// idle | pending | success
+```
+
+---
+
+#### 🧩 Combine with react-scoped-store
+```ts
+const useLoginStore = createScopedStore(() => ({
+  email: "",
+  password: "",
+}))
+
+function LoginForm() {
+  const { email, password } = useLoginStore()
+  const emit = useIntent()
+
+  return (
+    <form
+      onSubmit={() =>
+        emit({
+          type: "auth.login.submit",
+          payload: { email, password },
+        })
+      }
+    />
+  )
+}
+```
+
+- react-scoped-store → local UI state
+
+- react-intent-engine → async flow & orchestration
+
+---
+
+#### 🧪 Testing (headless)
+- Intent logic can be tested without React:
+```ts
+await engine.emit({
+  type: "auth.login.submit",
+  payload: { email: "a@b.com", password: "123" },
+})
+
+expect(engine.store.getState().auth.user).toBeDefined()
+```
+
+---
+
+#### 🧠 When to use?
+
+- Use react-intent-engine when your app has:
+
+  - Complex async workflows
+
+  - Business logic outside UI
+
+  - Multiple side effects per action
+
+  - Large or growing teams
+
+  - Hexagonal / DDD-inspired architecture
+  
+  - This library focuses on behavior and flow, not data fetching or UI state.
+---
+
+#### 📜 License
+
+MIT

package/build/core/context.d.ts

@@ -0,0 +1,2 @@
+import { Intent, IntentContext } from "./types";
+export declare function createContext(store: any, emit: (intent: Intent) => Promise<void>, effects: any): IntentContext;

package/build/core/engine.d.ts

@@ -0,0 +1,16 @@
+import { Intent, IntentHandler, Guard, Middleware } from "./types";
+export declare function createIntentEngine<TState extends object>(opts: {
+    initialState: TState;
+    effects?: any;
+    middleware?: Middleware[];
+}): {
+    emit: (intent: Intent) => Promise<void>;
+    on: (type: string, handler: IntentHandler) => void;
+    guard: (type: string, g: Guard) => void;
+    store: {
+        getState: () => TState;
+        setState: (updater: (prev: TState) => TState) => void;
+        subscribe: (listener: () => void) => () => boolean;
+    };
+    getStatus: (type: string) => string;
+};

package/build/core/index.d.ts

@@ -0,0 +1,2 @@
+export { createIntentEngine } from "./engine";
+export type { Intent, IntentStatus, IntentHandler, } from "./types";

package/build/core/middleware.d.ts

@@ -0,0 +1 @@
+export declare function composeMiddleware(mw: any[]): (intent: any, handler: () => Promise<void>) => Promise<void>;

package/build/core/store.d.ts

@@ -0,0 +1,7 @@
+type Listener = () => void;
+export declare function createStore<T>(initial: T): {
+    getState: () => T;
+    setState: (updater: (prev: T) => T) => void;
+    subscribe: (listener: Listener) => () => boolean;
+};
+export {};

package/build/core/types.d.ts

@@ -0,0 +1,15 @@
+export type Intent<T = any> = {
+    type: string;
+    payload?: T;
+};
+export type IntentStatus = "idle" | "pending" | "success" | "error";
+export type IntentHandler<T extends Intent = Intent> = (intent: T, ctx: IntentContext) => Promise<void> | void;
+export type Guard = (ctx: IntentContext) => boolean;
+export type Middleware = (intent: Intent, next: () => Promise<void>) => Promise<void>;
+export type EffectMap = Record<string, any>;
+export type IntentContext = {
+    get<T = any>(path: string): T;
+    set(path: string, value: any): void;
+    emit(intent: Intent): Promise<void>;
+    effects: EffectMap;
+};

package/build/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var t=require("react");function e(t){return t&&"object"==typeof t&&"default"in t?t:{default:t}}var n=e(t);function r(t,e,n,r){return new(n||(n=Promise))(function(o,u){function i(t){try{c(r.next(t))}catch(t){u(t)}}function a(t){try{c(r.throw(t))}catch(t){u(t)}}function c(t){var e;t.done?o(t.value):(e=t.value,e instanceof n?e:new n(function(t){t(e)})).then(i,a)}c((r=r.apply(t,e||[])).next())})}function o(t,e){var n,r,o,u={label:0,sent:function(){if(1&o[0])throw o[1];return o[1]},trys:[],ops:[]},i=Object.create(("function"==typeof Iterator?Iterator:Object).prototype);return i.next=a(0),i.throw=a(1),i.return=a(2),"function"==typeof Symbol&&(i[Symbol.iterator]=function(){return this}),i;function a(a){return function(c){return function(a){if(n)throw new TypeError("Generator is already executing.");for(;i&&(i=0,a[0]&&(u=0)),u;)try{if(n=1,r&&(o=2&a[0]?r.return:a[0]?r.throw||((o=r.return)&&o.call(r),0):r.next)&&!(o=o.call(r,a[1])).done)return o;switch(r=0,o&&(a=[2&a[0],o.value]),a[0]){case 0:case 1:o=a;break;case 4:return u.label++,{value:a[1],done:!1};case 5:u.label++,r=a[1],a=[0];continue;case 7:a=u.ops.pop(),u.trys.pop();continue;default:if(!(o=u.trys,(o=o.length>0&&o[o.length-1])||6!==a[0]&&2!==a[0])){u=0;continue}if(3===a[0]&&(!o||a[1]>o[0]&&a[1]<o[3])){u.label=a[1];break}if(6===a[0]&&u.label<o[1]){u.label=o[1],o=a;break}if(o&&u.label<o[2]){u.label=o[2],u.ops.push(a);break}o[2]&&u.ops.pop(),u.trys.pop();continue}a=e.call(t,u)}catch(t){a=[6,t],r=0}finally{n=o=0}if(5&a[0])throw a[1];return{value:a[0]?a[1]:void 0,done:!0}}([a,c])}}}function u(t,e,n){if(n||2===arguments.length)for(var r,o=0,u=e.length;o<u;o++)!r&&o in e||(r||(r=Array.prototype.slice.call(e,0,o)),r[o]=e[o]);return t.concat(r||Array.prototype.slice.call(e))}"function"==typeof SuppressedError&&SuppressedError;var i=t.createContext(null),a=i.Provider;function c(){var e=t.useContext(i);if(!e)throw new Error("Missing IntentProvider");return e}function s(t){var e={exports:{}};return t(e,e.exports),e.exports}var f="function"==typeof Object.is?Object.is:function(t,e){return t===e&&(0!==t||1/t==1/e)||t!=t&&e!=e},l=n.default.useState,d=n.default.useEffect,p=n.default.useLayoutEffect,v=n.default.useDebugValue;function S(t){var e=t.getSnapshot;t=t.value;try{var n=e();return!f(t,n)}catch(t){return!0}}var y="undefined"==typeof window||void 0===window.document||void 0===window.document.createElement?function(t,e){return e()}:function(t,e){var n=e(),r=l({inst:{value:n,getSnapshot:e}}),o=r[0].inst,u=r[1];return p(function(){o.value=n,o.getSnapshot=e,S(o)&&u({inst:o})},[t,n,e]),d(function(){return S(o)&&u({inst:o}),t(function(){S(o)&&u({inst:o})})},[t]),v(n),n},h={useSyncExternalStore:void 0!==n.default.useSyncExternalStore?n.default.useSyncExternalStore:y},_=s(function(t,e){"production"!==process.env.NODE_ENV&&function(){function t(t){var e=t.getSnapshot;t=t.value;try{var n=e();return!o(t,n)}catch(t){return!0}}"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(Error());var r=n.default,o="function"==typeof Object.is?Object.is:function(t,e){return t===e&&(0!==t||1/t==1/e)||t!=t&&e!=e},u=r.useState,i=r.useEffect,a=r.useLayoutEffect,c=r.useDebugValue,s=!1,f=!1,l="undefined"==typeof window||void 0===window.document||void 0===window.document.createElement?function(t,e){return e()}:function(e,n){s||void 0===r.startTransition||(s=!0,console.error("You are using an outdated, pre-release alpha of React 18 that does not support useSyncExternalStore. The use-sync-external-store shim will not work correctly. Upgrade to a newer pre-release."));var l=n();if(!f){var d=n();o(l,d)||(console.error("The result of getSnapshot should be cached to avoid an infinite loop"),f=!0)}var p=(d=u({inst:{value:l,getSnapshot:n}}))[0].inst,v=d[1];return a(function(){p.value=l,p.getSnapshot=n,t(p)&&v({inst:p})},[e,l,n]),i(function(){return t(p)&&v({inst:p}),e(function(){t(p)&&v({inst:p})})},[e]),c(l),l};e.useSyncExternalStore=void 0!==r.useSyncExternalStore?r.useSyncExternalStore:l,"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop(Error())}()}),E=s(function(t){"production"===process.env.NODE_ENV?t.exports=h:t.exports=_});exports.IntentProvider=a,exports.createIntentEngine=function(t){var e,n,i,a,c,s,f=(i=t.initialState,a=structuredClone(i),c=new Set,{getState:function(){return a},setState:function(t){a=t(a),c.forEach(function(t){return t()})},subscribe:function(t){return c.add(t),function(){return c.delete(t)}}}),l=null!==(e=t.effects)&&void 0!==e?e:{},d=new Map,p=new Map,v=new Map,S=(s=null!==(n=t.middleware)&&void 0!==n?n:[],function(t,e){var n=-1;return function u(i){return r(this,void 0,void 0,function(){var r;return o(this,function(o){if(i<=n)throw new Error("next() called twice");return n=i,(r=s[i])?[2,r(t,function(){return u(i+1)})]:[2,e()]})})}(0)});return{emit:function t(e){var n;return r(this,void 0,void 0,function(){var u,i=this;return o(this,function(a){switch(a.label){case 0:return u=function(t,e,n){return{get:function(e){return e.split(".").reduce(function(t,e){return null==t?void 0:t[e]},t.getState())},set:function(e,n){t.setState(function(t){for(var r,o=structuredClone(t),u=e.split("."),i=o,a=0;a<u.length-1;a++)i=i[r=u[a]]||(i[r]={});return i[u.at(-1)]=n,o})},emit:e,effects:n}}(f,t,l),(null===(n=p.get(e.type))||void 0===n?void 0:n.some(function(t){return!t(u)}))?[2]:(v.set(e.type,"pending"),[4,S(e,function(){return r(i,void 0,void 0,function(){var t,n,r;return o(this,function(o){switch(o.label){case 0:t=0,n=null!==(r=d.get(e.type))&&void 0!==r?r:[],o.label=1;case 1:return t<n.length?[4,(0,n[t])(e,u)]:[3,4];case 2:o.sent(),o.label=3;case 3:return t++,[3,1];case 4:return[2]}})})})]);case 1:return a.sent(),v.set(e.type,"success"),[2]}})})},on:function(t,e){var n;d.set(t,u(u([],null!==(n=d.get(t))&&void 0!==n?n:[],!0),[e],!1))},guard:function(t,e){var n;p.set(t,u(u([],null!==(n=p.get(t))&&void 0!==n?n:[],!0),[e],!1))},store:f,getStatus:function(t){var e;return null!==(e=v.get(t))&&void 0!==e?e:"idle"}}},exports.useEngine=c,exports.useIntent=function(){var t=c();return function(e){return t.emit(e)}},exports.useIntentState=function(t){var e=c();return E.useSyncExternalStore(e.store.subscribe,function(){return t(e.store.getState())})},exports.useIntentStatus=function(t){return c().getStatus(t)};

package/build/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core";
+export * from "./react";

package/build/index.esm.js

@@ -0,0 +1 @@
+import t,{createContext as e,useContext as n}from"react";function r(t,e,n,r){return new(n||(n=Promise))(function(o,u){function i(t){try{a(r.next(t))}catch(t){u(t)}}function c(t){try{a(r.throw(t))}catch(t){u(t)}}function a(t){var e;t.done?o(t.value):(e=t.value,e instanceof n?e:new n(function(t){t(e)})).then(i,c)}a((r=r.apply(t,e||[])).next())})}function o(t,e){var n,r,o,u={label:0,sent:function(){if(1&o[0])throw o[1];return o[1]},trys:[],ops:[]},i=Object.create(("function"==typeof Iterator?Iterator:Object).prototype);return i.next=c(0),i.throw=c(1),i.return=c(2),"function"==typeof Symbol&&(i[Symbol.iterator]=function(){return this}),i;function c(c){return function(a){return function(c){if(n)throw new TypeError("Generator is already executing.");for(;i&&(i=0,c[0]&&(u=0)),u;)try{if(n=1,r&&(o=2&c[0]?r.return:c[0]?r.throw||((o=r.return)&&o.call(r),0):r.next)&&!(o=o.call(r,c[1])).done)return o;switch(r=0,o&&(c=[2&c[0],o.value]),c[0]){case 0:case 1:o=c;break;case 4:return u.label++,{value:c[1],done:!1};case 5:u.label++,r=c[1],c=[0];continue;case 7:c=u.ops.pop(),u.trys.pop();continue;default:if(!(o=u.trys,(o=o.length>0&&o[o.length-1])||6!==c[0]&&2!==c[0])){u=0;continue}if(3===c[0]&&(!o||c[1]>o[0]&&c[1]<o[3])){u.label=c[1];break}if(6===c[0]&&u.label<o[1]){u.label=o[1],o=c;break}if(o&&u.label<o[2]){u.label=o[2],u.ops.push(c);break}o[2]&&u.ops.pop(),u.trys.pop();continue}c=e.call(t,u)}catch(t){c=[6,t],r=0}finally{n=o=0}if(5&c[0])throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}([c,a])}}}function u(t,e,n){if(n||2===arguments.length)for(var r,o=0,u=e.length;o<u;o++)!r&&o in e||(r||(r=Array.prototype.slice.call(e,0,o)),r[o]=e[o]);return t.concat(r||Array.prototype.slice.call(e))}function i(t){var e,n,i,c,a,s,f=(i=t.initialState,c=structuredClone(i),a=new Set,{getState:function(){return c},setState:function(t){c=t(c),a.forEach(function(t){return t()})},subscribe:function(t){return a.add(t),function(){return a.delete(t)}}}),l=null!==(e=t.effects)&&void 0!==e?e:{},d=new Map,p=new Map,v=new Map,S=(s=null!==(n=t.middleware)&&void 0!==n?n:[],function(t,e){var n=-1;return function u(i){return r(this,void 0,void 0,function(){var r;return o(this,function(o){if(i<=n)throw new Error("next() called twice");return n=i,(r=s[i])?[2,r(t,function(){return u(i+1)})]:[2,e()]})})}(0)});return{emit:function t(e){var n;return r(this,void 0,void 0,function(){var u,i=this;return o(this,function(c){switch(c.label){case 0:return u=function(t,e,n){return{get:function(e){return e.split(".").reduce(function(t,e){return null==t?void 0:t[e]},t.getState())},set:function(e,n){t.setState(function(t){for(var r,o=structuredClone(t),u=e.split("."),i=o,c=0;c<u.length-1;c++)i=i[r=u[c]]||(i[r]={});return i[u.at(-1)]=n,o})},emit:e,effects:n}}(f,t,l),(null===(n=p.get(e.type))||void 0===n?void 0:n.some(function(t){return!t(u)}))?[2]:(v.set(e.type,"pending"),[4,S(e,function(){return r(i,void 0,void 0,function(){var t,n,r;return o(this,function(o){switch(o.label){case 0:t=0,n=null!==(r=d.get(e.type))&&void 0!==r?r:[],o.label=1;case 1:return t<n.length?[4,(0,n[t])(e,u)]:[3,4];case 2:o.sent(),o.label=3;case 3:return t++,[3,1];case 4:return[2]}})})})]);case 1:return c.sent(),v.set(e.type,"success"),[2]}})})},on:function(t,e){var n;d.set(t,u(u([],null!==(n=d.get(t))&&void 0!==n?n:[],!0),[e],!1))},guard:function(t,e){var n;p.set(t,u(u([],null!==(n=p.get(t))&&void 0!==n?n:[],!0),[e],!1))},store:f,getStatus:function(t){var e;return null!==(e=v.get(t))&&void 0!==e?e:"idle"}}}"function"==typeof SuppressedError&&SuppressedError;var c=e(null),a=c.Provider;function s(){var t=n(c);if(!t)throw new Error("Missing IntentProvider");return t}function f(){var t=s();return function(e){return t.emit(e)}}function l(t){var e={exports:{}};return t(e,e.exports),e.exports}var d="function"==typeof Object.is?Object.is:function(t,e){return t===e&&(0!==t||1/t==1/e)||t!=t&&e!=e},p=t.useState,v=t.useEffect,S=t.useLayoutEffect,y=t.useDebugValue;function h(t){var e=t.getSnapshot;t=t.value;try{var n=e();return!d(t,n)}catch(t){return!0}}var _="undefined"==typeof window||void 0===window.document||void 0===window.document.createElement?function(t,e){return e()}:function(t,e){var n=e(),r=p({inst:{value:n,getSnapshot:e}}),o=r[0].inst,u=r[1];return S(function(){o.value=n,o.getSnapshot=e,h(o)&&u({inst:o})},[t,n,e]),v(function(){return h(o)&&u({inst:o}),t(function(){h(o)&&u({inst:o})})},[t]),y(n),n},E={useSyncExternalStore:void 0!==t.useSyncExternalStore?t.useSyncExternalStore:_},O=l(function(e,n){"production"!==process.env.NODE_ENV&&function(){function e(t){var e=t.getSnapshot;t=t.value;try{var n=e();return!o(t,n)}catch(t){return!0}}"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(Error());var r=t,o="function"==typeof Object.is?Object.is:function(t,e){return t===e&&(0!==t||1/t==1/e)||t!=t&&e!=e},u=r.useState,i=r.useEffect,c=r.useLayoutEffect,a=r.useDebugValue,s=!1,f=!1,l="undefined"==typeof window||void 0===window.document||void 0===window.document.createElement?function(t,e){return e()}:function(t,n){s||void 0===r.startTransition||(s=!0,console.error("You are using an outdated, pre-release alpha of React 18 that does not support useSyncExternalStore. The use-sync-external-store shim will not work correctly. Upgrade to a newer pre-release."));var l=n();if(!f){var d=n();o(l,d)||(console.error("The result of getSnapshot should be cached to avoid an infinite loop"),f=!0)}var p=(d=u({inst:{value:l,getSnapshot:n}}))[0].inst,v=d[1];return c(function(){p.value=l,p.getSnapshot=n,e(p)&&v({inst:p})},[t,l,n]),i(function(){return e(p)&&v({inst:p}),t(function(){e(p)&&v({inst:p})})},[t]),a(l),l};n.useSyncExternalStore=void 0!==r.useSyncExternalStore?r.useSyncExternalStore:l,"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop(Error())}()}),w=l(function(t){"production"===process.env.NODE_ENV?t.exports=E:t.exports=O});function g(t){var e=s();return w.useSyncExternalStore(e.store.subscribe,function(){return t(e.store.getState())})}function b(t){return s().getStatus(t)}export{a as IntentProvider,i as createIntentEngine,s as useEngine,f as useIntent,g as useIntentState,b as useIntentStatus};

package/build/index.umd.min.js

@@ -0,0 +1 @@
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("react")):"function"==typeof define&&define.amd?define(["exports","react"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).ReactIntentEngine={},t.React)}(this,function(t,e){"use strict";function n(t){return t&&"object"==typeof t&&"default"in t?t:{default:t}}var r=n(e);function o(t,e,n,r){return new(n||(n=Promise))(function(o,u){function i(t){try{c(r.next(t))}catch(t){u(t)}}function a(t){try{c(r.throw(t))}catch(t){u(t)}}function c(t){var e;t.done?o(t.value):(e=t.value,e instanceof n?e:new n(function(t){t(e)})).then(i,a)}c((r=r.apply(t,e||[])).next())})}function u(t,e){var n,r,o,u={label:0,sent:function(){if(1&o[0])throw o[1];return o[1]},trys:[],ops:[]},i=Object.create(("function"==typeof Iterator?Iterator:Object).prototype);return i.next=a(0),i.throw=a(1),i.return=a(2),"function"==typeof Symbol&&(i[Symbol.iterator]=function(){return this}),i;function a(a){return function(c){return function(a){if(n)throw new TypeError("Generator is already executing.");for(;i&&(i=0,a[0]&&(u=0)),u;)try{if(n=1,r&&(o=2&a[0]?r.return:a[0]?r.throw||((o=r.return)&&o.call(r),0):r.next)&&!(o=o.call(r,a[1])).done)return o;switch(r=0,o&&(a=[2&a[0],o.value]),a[0]){case 0:case 1:o=a;break;case 4:return u.label++,{value:a[1],done:!1};case 5:u.label++,r=a[1],a=[0];continue;case 7:a=u.ops.pop(),u.trys.pop();continue;default:if(!(o=u.trys,(o=o.length>0&&o[o.length-1])||6!==a[0]&&2!==a[0])){u=0;continue}if(3===a[0]&&(!o||a[1]>o[0]&&a[1]<o[3])){u.label=a[1];break}if(6===a[0]&&u.label<o[1]){u.label=o[1],o=a;break}if(o&&u.label<o[2]){u.label=o[2],u.ops.push(a);break}o[2]&&u.ops.pop(),u.trys.pop();continue}a=e.call(t,u)}catch(t){a=[6,t],r=0}finally{n=o=0}if(5&a[0])throw a[1];return{value:a[0]?a[1]:void 0,done:!0}}([a,c])}}}function i(t,e,n){if(n||2===arguments.length)for(var r,o=0,u=e.length;o<u;o++)!r&&o in e||(r||(r=Array.prototype.slice.call(e,0,o)),r[o]=e[o]);return t.concat(r||Array.prototype.slice.call(e))}"function"==typeof SuppressedError&&SuppressedError;var a=e.createContext(null),c=a.Provider;function s(){var t=e.useContext(a);if(!t)throw new Error("Missing IntentProvider");return t}function f(t){var e={exports:{}};return t(e,e.exports),e.exports}var l="function"==typeof Object.is?Object.is:function(t,e){return t===e&&(0!==t||1/t==1/e)||t!=t&&e!=e},d=r.default.useState,p=r.default.useEffect,v=r.default.useLayoutEffect,y=r.default.useDebugValue;function S(t){var e=t.getSnapshot;t=t.value;try{var n=e();return!l(t,n)}catch(t){return!0}}var h="undefined"==typeof window||void 0===window.document||void 0===window.document.createElement?function(t,e){return e()}:function(t,e){var n=e(),r=d({inst:{value:n,getSnapshot:e}}),o=r[0].inst,u=r[1];return v(function(){o.value=n,o.getSnapshot=e,S(o)&&u({inst:o})},[t,n,e]),p(function(){return S(o)&&u({inst:o}),t(function(){S(o)&&u({inst:o})})},[t]),y(n),n},_={useSyncExternalStore:void 0!==r.default.useSyncExternalStore?r.default.useSyncExternalStore:h},g=f(function(t,e){"production"!==process.env.NODE_ENV&&function(){function t(t){var e=t.getSnapshot;t=t.value;try{var n=e();return!o(t,n)}catch(t){return!0}}"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(Error());var n=r.default,o="function"==typeof Object.is?Object.is:function(t,e){return t===e&&(0!==t||1/t==1/e)||t!=t&&e!=e},u=n.useState,i=n.useEffect,a=n.useLayoutEffect,c=n.useDebugValue,s=!1,f=!1,l="undefined"==typeof window||void 0===window.document||void 0===window.document.createElement?function(t,e){return e()}:function(e,r){s||void 0===n.startTransition||(s=!0,console.error("You are using an outdated, pre-release alpha of React 18 that does not support useSyncExternalStore. The use-sync-external-store shim will not work correctly. Upgrade to a newer pre-release."));var l=r();if(!f){var d=r();o(l,d)||(console.error("The result of getSnapshot should be cached to avoid an infinite loop"),f=!0)}var p=(d=u({inst:{value:l,getSnapshot:r}}))[0].inst,v=d[1];return a(function(){p.value=l,p.getSnapshot=r,t(p)&&v({inst:p})},[e,l,r]),i(function(){return t(p)&&v({inst:p}),e(function(){t(p)&&v({inst:p})})},[e]),c(l),l};e.useSyncExternalStore=void 0!==n.useSyncExternalStore?n.useSyncExternalStore:l,"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop(Error())}()}),E=f(function(t){"production"===process.env.NODE_ENV?t.exports=_:t.exports=g});t.IntentProvider=c,t.createIntentEngine=function(t){var e,n,r,a,c,s,f=(r=t.initialState,a=structuredClone(r),c=new Set,{getState:function(){return a},setState:function(t){a=t(a),c.forEach(function(t){return t()})},subscribe:function(t){return c.add(t),function(){return c.delete(t)}}}),l=null!==(e=t.effects)&&void 0!==e?e:{},d=new Map,p=new Map,v=new Map,y=(s=null!==(n=t.middleware)&&void 0!==n?n:[],function(t,e){var n=-1;return function r(i){return o(this,void 0,void 0,function(){var o;return u(this,function(u){if(i<=n)throw new Error("next() called twice");return n=i,(o=s[i])?[2,o(t,function(){return r(i+1)})]:[2,e()]})})}(0)});return{emit:function t(e){var n;return o(this,void 0,void 0,function(){var r,i=this;return u(this,function(a){switch(a.label){case 0:return r=function(t,e,n){return{get:function(e){return e.split(".").reduce(function(t,e){return null==t?void 0:t[e]},t.getState())},set:function(e,n){t.setState(function(t){for(var r,o=structuredClone(t),u=e.split("."),i=o,a=0;a<u.length-1;a++)i=i[r=u[a]]||(i[r]={});return i[u.at(-1)]=n,o})},emit:e,effects:n}}(f,t,l),(null===(n=p.get(e.type))||void 0===n?void 0:n.some(function(t){return!t(r)}))?[2]:(v.set(e.type,"pending"),[4,y(e,function(){return o(i,void 0,void 0,function(){var t,n,o;return u(this,function(u){switch(u.label){case 0:t=0,n=null!==(o=d.get(e.type))&&void 0!==o?o:[],u.label=1;case 1:return t<n.length?[4,(0,n[t])(e,r)]:[3,4];case 2:u.sent(),u.label=3;case 3:return t++,[3,1];case 4:return[2]}})})})]);case 1:return a.sent(),v.set(e.type,"success"),[2]}})})},on:function(t,e){var n;d.set(t,i(i([],null!==(n=d.get(t))&&void 0!==n?n:[],!0),[e],!1))},guard:function(t,e){var n;p.set(t,i(i([],null!==(n=p.get(t))&&void 0!==n?n:[],!0),[e],!1))},store:f,getStatus:function(t){var e;return null!==(e=v.get(t))&&void 0!==e?e:"idle"}}},t.useEngine=s,t.useIntent=function(){var t=s();return function(e){return t.emit(e)}},t.useIntentState=function(t){var e=s();return E.useSyncExternalStore(e.store.subscribe,function(){return t(e.store.getState())})},t.useIntentStatus=function(t){return s().getStatus(t)},Object.defineProperty(t,"__esModule",{value:!0})});

package/build/react/IntentProvider.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+export declare const IntentProvider: import("react").Provider<any>;
+export declare function useEngine(): any;

package/build/react/index.d.ts

@@ -0,0 +1,4 @@
+export { IntentProvider, useEngine } from "./IntentProvider";
+export { useIntent } from "./useIntent";
+export { useIntentState } from "./useIntentState";
+export { useIntentStatus } from "./useIntentStatus";

package/build/react/useIntent.d.ts

@@ -0,0 +1,2 @@
+import { Intent } from "../core/types";
+export declare function useIntent(): (intent: Intent) => any;

package/build/react/useIntentState.d.ts

@@ -0,0 +1 @@
+export declare function useIntentState<T>(selector: (s: any) => T): T;

package/build/react/useIntentStatus.d.ts

@@ -0,0 +1 @@
+export declare function useIntentStatus(type: string): any;

package/build/react/useSyncExternalStore.d.ts

@@ -0,0 +1 @@
+export { useSyncExternalStore } from "use-sync-external-store/shim";

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "react-intent-engine-z",
+  "version": "1.0.0",
+  "description": "Intent-first orchestration engine for React applications",
+  "license": "MIT",
+  "author": "Delpi.Kye",
+
+  "sideEffects": false,
+
+  "main": "build/index.cjs",
+  "module": "build/index.esm.js",
+  "types": "build/index.d.ts",
+
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "import": "./build/index.esm.js",
+      "require": "./build/index.cjs"
+    }
+  },
+
+  "files": [
+    "build"
+  ],
+
+  "scripts": {
+    "clean": "rimraf build",
+    "build": "rollup -c",
+    "cb": "npm run clean && npm run build",
+    "prepublishOnly": "npm run build"
+  },
+
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/delpikye-v/react-intent-engine.git"
+  },
+  "homepage": "https://github.com/delpikye-v/react-intent-engine#readme",
+  "bugs": {
+    "url": "https://github.com/delpikye-v/react-intent-engine/issues"
+  },
+
+  "keywords": [
+    "react",
+    "intent",
+    "intent-engine",
+    "orchestration",
+    "state-management",
+    "architecture",
+    "ddd",
+    "hexagonal",
+    "side-effects",
+    "async-flow",
+    "react-hooks",
+    "react-library"
+  ],
+
+  "peerDependencies": {
+    "react": ">=17"
+  },
+
+  "dependencies": {
+    "use-sync-external-store": "^1.6.0"
+  },
+
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^17.1.0",
+    "@rollup/plugin-node-resolve": "^11.2.1",
+    "@types/react": "^17.0.90",
+
+    "rimraf": "^3.0.2",
+    "rollup": "^2.56.3",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-terser": "^7.0.2",
+    "rollup-plugin-typescript2": "^0.29.0",
+
+    "typescript": "^4.4.2",
+    "tslib": "^2.3.1"
+  }
+}