@doeixd/machine 0.0.5 → 0.0.7

package/dist/cjs/production/index.js

@@ -1,5 +1,5 @@
-"use strict";var b=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var J=Object.getOwnPropertyNames;var Y=Object.prototype.hasOwnProperty;var H=(t,e)=>{for(var r in e)b(t,r,{get:e[r],enumerable:!0})},Q=(t,e,r,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of J(e))!Y.call(t,n)&&n!==r&&b(t,n,{get:()=>e[n],enumerable:!(o=q(e,n))||o.enumerable});return t};var X=t=>Q(b({},"__esModule",{value:!0}),t);var pe={};H(pe,{META_KEY:()=>K,MachineBase:()=>j,MultiMachineBase:()=>S,RUNTIME_META:()=>M,action:()=>_,createAsyncMachine:()=>se,createEnsemble:()=>ne,createFlow:()=>v,createMachine:()=>y,createMachineBuilder:()=>de,createMachineFactory:()=>ce,createMultiMachine:()=>ie,createMutableMachine:()=>ae,createRunner:()=>U,describe:()=>D,extendTransitions:()=>xe,extractFromInstance:()=>B,extractFunctionMetadata:()=>k,extractMachine:()=>C,extractMachines:()=>V,extractStateNode:()=>m,generateChart:()=>A,generateStatechart:()=>z,guarded:()=>L,hasState:()=>ye,invoke:()=>I,matchMachine:()=>fe,metadata:()=>W,next:()=>ge,overrideTransitions:()=>le,run:()=>E,runAsync:()=>O,runMachine:()=>Me,runSequence:()=>N,runWithDebug:()=>R,runWithEnsemble:()=>oe,runWithRunner:()=>re,setContext:()=>ue,step:()=>F,stepAsync:()=>P,transitionTo:()=>$,yieldMachine:()=>w});module.exports=X(pe);function E(t,e){let r=t(e),o=e;for(;;){let{value:n,done:i}=r.next(o);if(i)return n;o=n}}function F(t){return function*(){return yield t}()}function w(t){return t}function N(t,e){return e.reduce((r,o)=>E(o,r),t)}function v(t){return t}function R(t,e,r=(o,n)=>{console.log(`Step ${o}:`,n.context)}){let o=t(e),n=e,i=0;for(r(i,n);;){let{value:a,done:s}=o.next(n);if(s)return console.log("Final:",a),a;n=a,i++,r(i,n)}}async function O(t,e){let r=t(e),o=e;for(;;){let{value:n,done:i}=await r.next(o);if(i)return n;o=n}}async function*P(t){return yield t}var K=Symbol("MachineMeta"),M=Symbol("__machine_runtime_meta__");function g(t,e){let r=t[M]||{},o={...r,...e};e.guards&&r.guards?o.guards=[...r.guards,...e.guards]:e.guards&&(o.guards=[...e.guards]),e.actions&&r.actions?o.actions=[...r.actions,...e.actions]:e.actions&&(o.actions=[...e.actions]),Object.defineProperty(t,M,{value:o,enumerable:!1,writable:!1,configurable:!0})}function $(t,e){return g(e,{target:t.name||t.toString()}),e}function D(t,e){return g(e,{description:t}),e}function L(t,e){return g(e,{guards:[t]}),e}function I(t,e){return g(e,{invoke:{src:t.src,onDone:t.onDone.name||t.onDone.toString(),onError:t.onError.name||t.onError.toString(),description:t.description}}),e}function _(t,e){return g(e,{actions:[t]}),e}function W(t,e){return e}var c=require("ts-morph");function G(t){return c.Node.isIdentifier(t)?t.getText():c.Node.isTypeOfExpression(t)?t.getExpression().getText():"unknown"}function h(t){if(!c.Node.isObjectLiteralExpression(t))return{};let e={};for(let r of t.getProperties())if(c.Node.isPropertyAssignment(r)){let o=r.getName(),n=r.getInitializer();n&&(c.Node.isStringLiteral(n)||c.Node.isNumericLiteral(n)?e[o]=n.getLiteralValue():n.getText()==="true"||n.getText()==="false"?e[o]=n.getText()==="true":c.Node.isIdentifier(n)?e[o]=n.getText():c.Node.isObjectLiteralExpression(n)?e[o]=h(n):c.Node.isArrayLiteralExpression(n)&&(e[o]=n.getElements().map(i=>c.Node.isObjectLiteralExpression(i)?h(i):i.getText())))}return e}function Z(t){if(!c.Node.isObjectLiteralExpression(t))return{};let e={};for(let r of t.getProperties())if(c.Node.isPropertyAssignment(r)){let o=r.getName(),n=r.getInitializer();if(!n)continue;o==="onDone"||o==="onError"?e[o]=G(n):c.Node.isStringLiteral(n)?e[o]=n.getLiteralValue():c.Node.isIdentifier(n)&&(e[o]=n.getText())}return e}function p(t,e=!1){if(!c.Node.isCallExpression(t))return null;let r=t.getExpression(),o=c.Node.isIdentifier(r)?r.getText():null;if(!o)return null;let n={},i=t.getArguments();switch(o){case"transitionTo":i[0]&&(n.target=G(i[0]));break;case"describe":if(i[0]&&c.Node.isStringLiteral(i[0])&&(n.description=i[0].getLiteralValue()),i[1]&&c.Node.isCallExpression(i[1])){let a=p(i[1],e);a&&Object.assign(n,a)}break;case"guarded":if(i[0]){let a=h(i[0]);Object.keys(a).length>0&&(n.guards=[a])}if(i[1]&&c.Node.isCallExpression(i[1])){let a=p(i[1],e);a&&Object.assign(n,a)}break;case"invoke":if(i[0]){let a=Z(i[0]);Object.keys(a).length>0&&(n.invoke=a)}break;case"action":if(i[0]){let a=h(i[0]);Object.keys(a).length>0&&(n.actions=[a])}if(i[1]&&c.Node.isCallExpression(i[1])){let a=p(i[1],e);a&&Object.assign(n,a)}break;default:return null}return Object.keys(n).length>0?n:null}function ee(t,e=!1){if(!c.Node.isPropertyDeclaration(t))return e&&console.error("      ⚠️ Not a property declaration"),null;let r=t.getInitializer();if(!r)return e&&console.error("      ⚠️ No initializer"),null;if(!c.Node.isCallExpression(r))return e&&console.error("      ⚠️ Initializer is not a call expression"),null;let o=p(r,e);return o&&e&&console.error("      ✅ Extracted metadata:",JSON.stringify(o,null,2)),o}function te(t,e=!1){let r={on:{}},o=t.getDeclarations()[0];if(!o||!c.Node.isClassDeclaration(o))return e&&console.error(`⚠️ Warning: Could not get class declaration for ${t.getName()}`),r;let n=t.getName();e&&console.error(`  Analyzing state: ${n}`);for(let i of o.getInstanceMembers()){let a=i.getName();e&&console.error(`    Checking member: ${a}`);let s=ee(i,e);if(!s)continue;e&&console.error(`    Found transition: ${a}`);let{invoke:u,actions:l,guards:f,...x}=s;if(u&&(r.invoke||(r.invoke=[]),r.invoke.push({src:u.src,onDone:{target:u.onDone},onError:{target:u.onError},description:u.description}),e&&console.error(`      → Invoke: ${u.src}`)),x.target){let d={target:x.target};x.description&&(d.description=x.description),f&&(d.cond=f.map(T=>T.name).join(" && "),e&&console.error(`      → Guard: ${d.cond}`)),l&&l.length>0&&(d.actions=l.map(T=>T.name),e&&console.error(`      → Actions: ${d.actions.join(", ")}`)),r.on[a]=d,e&&console.error(`      → Target: ${x.target}`)}}return r}function C(t,e,r=!1){r&&(console.error(`
-🔍 Analyzing machine: ${t.id}`),console.error(`  Source: ${t.input}`));let o=e.getSourceFile(t.input);if(!o)throw new Error(`Source file not found: ${t.input}`);let n={id:t.id,initial:t.initialState,states:{}};t.description&&(n.description=t.description);for(let i of t.classes){let a=o.getClass(i);if(!a){console.warn(`⚠️ Warning: Class '${i}' not found in '${t.input}'. Skipping.`);continue}let s=a.getSymbolOrThrow(),u=te(s,r);n.states[i]=u}return r&&console.error(`  ✅ Extracted ${t.classes.length} states`),n}function V(t){var n;let e=(n=t.verbose)!=null?n:!1;e&&(console.error(`
-📊 Starting statechart extraction`),console.error(`  Machines to extract: ${t.machines.length}`));let r=new c.Project;r.addSourceFilesAtPaths("src/**/*.ts"),r.addSourceFilesAtPaths("examples/**/*.ts");let o=[];for(let i of t.machines)try{let a=C(i,r,e);o.push(a)}catch(a){console.error(`❌ Error extracting machine '${i.id}':`,a),e||console.error("   Run with --verbose for more details")}return e&&console.error(`
-✅ Extraction complete: ${o.length}/${t.machines.length} machines extracted`),o}function A(){let t={input:"examples/authMachine.ts",classes:["LoggedOutMachine","LoggingInMachine","LoggedInMachine","SessionExpiredMachine","ErrorMachine"],id:"auth",initialState:"LoggedOutMachine",description:"Authentication state machine"};console.error("🔍 Using legacy generateChart function"),console.error(`⚠️ Consider using extractMachines() with a config file instead
-`);let e=new c.Project;e.addSourceFilesAtPaths("src/**/*.ts"),e.addSourceFilesAtPaths("examples/**/*.ts");try{let r=C(t,e,!0);console.log(JSON.stringify(r,null,2))}catch(r){console.error("❌ Error:",r),process.exit(1)}}require.main===module&&A();function k(t){return typeof t!="function"?null:t[M]||null}function m(t){let e={on:{}},r=[];for(let o in t){let n=t[o];if(typeof n!="function")continue;let i=k(n);if(i&&(i.invoke&&r.push({src:i.invoke.src,onDone:{target:i.invoke.onDone},onError:{target:i.invoke.onError},description:i.invoke.description}),i.target)){let a={target:i.target};i.description&&(a.description=i.description),i.guards&&i.guards.length>0&&(a.cond=i.guards.map(s=>s.name).join(" && ")),i.actions&&i.actions.length>0&&(a.actions=i.actions.map(s=>s.name)),e.on[o]=a}}return r.length>0&&(e.invoke=r),e}function z(t,e){let r={id:e.id,initial:e.initial,states:{}};e.description&&(r.description=e.description);for(let[o,n]of Object.entries(t))r.states[o]=m(n);return r}function B(t,e){let r=e.stateName||t.constructor.name||"State";return{id:e.id,initial:r,states:{[r]:m(t)}}}function U(t,e){let r=t,o=s=>{r=s,e==null||e(s)},{context:n,...i}=t,a=new Proxy({},{get(s,u){let l=r[u];if(typeof l=="function")return(...f)=>{let x=l.apply(r.context,f),d=Object.assign({context:x.context},i);return o(d),d}}});return{get state(){return r},get context(){return r.context},actions:a,setState:o}}function ne(t,e,r){let o=()=>{let i=t.getContext(),a=r(i),s=e[a];if(!s)throw new Error(`[Ensemble] Invalid state: No factory found for state "${String(a)}".`);return s(i)},n=new Proxy({},{get(i,a){let s=o(),u=s[a];if(typeof u!="function")throw new Error(`[Ensemble] Transition "${a}" is not valid in the current state.`);return(...l)=>u.apply(s.context,l)}});return{get context(){return t.getContext()},get state(){return o()},actions:n}}function re(t,e){let r=U(e),o=t(r),n=o.next();for(;!n.done;)n=o.next();return n.value}function oe(t,e){let r=t(e),o=r.next();for(;!o.done;)o=r.next();return o.value}var S=class{constructor(e){this.store=e}get context(){return this.store.getContext()}setContext(e){this.store.setContext(e)}};function ie(t,e){let r=new t(e);return new Proxy({},{get(o,n){let i=e.getContext();if(n in i)return i[n];let a=r[n];if(typeof a=="function")return(...s)=>a.apply(r,s)},set(o,n,i){let a=e.getContext();if(n in a){let s={...a,[n]:i};return e.setContext(s),!0}return!1},has(o,n){let i=e.getContext();return n in i||typeof r[n]=="function"},ownKeys(o){let n=e.getContext(),i=Object.keys(n),a=Object.getOwnPropertyNames(Object.getPrototypeOf(r)).filter(s=>s!=="constructor"&&typeof r[s]=="function");return Array.from(new Set([...i,...a]))},getOwnPropertyDescriptor(o,n){let i=e.getContext();if(n in i||typeof r[n]=="function")return{value:void 0,writable:!0,enumerable:!0,configurable:!0}}})}function ae(t,e,r){let o=()=>{let n=r(t),i=e[n];if(!i)throw new Error(`[MutableMachine] Invalid state: No factory for state "${String(n)}".`);return i(t)};return new Proxy(t,{get(n,i,a){if(i in n)return n[i];let s=o(),u=s[i];if(typeof u=="function")return(...l)=>{let f=u.apply(s.context,l);if(typeof f!="object"||f===null){console.warn(`[MutableMachine] Transition "${String(i)}" did not return a valid context object. State may be inconsistent.`);return}Object.keys(n).forEach(x=>delete n[x]),Object.assign(n,f)}},set(n,i,a,s){return n[i]=a,!0},has(n,i){let a=o();return i in n||typeof a[i]=="function"}})}function y(t,e){return Object.assign({context:t},e)}function se(t,e){return Object.assign({context:t},e)}function ce(){return t=>{let e=Object.fromEntries(Object.entries(t).map(([r,o])=>[r,function(...n){let i=o(this,...n);return y(i,e)}]));return r=>y(r,e)}}function ue(t,e){let{context:r,...o}=t,n=typeof e=="function"?e(r):e;return y(n,o)}function le(t,e){let{context:r,...o}=t,n={...o,...e};return y(r,n)}function xe(t,e){let{context:r,...o}=t,n={...o,...e};return y(r,n)}function de(t){let{context:e,...r}=t;return o=>y(o,r)}function fe(t,e,r){let o=t.context[e],n=r[o];if(!n)throw new Error(`No handler found for state: ${String(o)}`);return n(t.context)}function ye(t,e,r){return t.context[e]===r}function Me(t,e){let r=t;async function o(n){let i=r[n.type];if(typeof i!="function")throw new Error(`[Machine] Unknown event type '${String(n.type)}' on current state.`);return r=await i.apply(r.context,n.args),e==null||e(r),r}return{get state(){return r.context},dispatch:o}}var j=class{constructor(e){this.context=e}};function ge(t,e){let{context:r,...o}=t;return y(e(r),o)}
+"use strict";var w=Object.defineProperty;var ue=Object.getOwnPropertyDescriptor;var xe=Object.getOwnPropertyNames;var ye=Object.prototype.hasOwnProperty;var de=(t,e)=>{for(var n in e)w(t,n,{get:e[n],enumerable:!0})},Me=(t,e,n,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of xe(e))!ye.call(t,r)&&r!==n&&w(t,r,{get:()=>e[r],enumerable:!(i=ue(e,r))||i.enumerable});return t};var fe=t=>Me(w({},"__esModule",{value:!0}),t);var De={};de(De,{BoundMachine:()=>S,META_KEY:()=>U,MachineBase:()=>y,MultiMachineBase:()=>v,RUNTIME_META:()=>h,action:()=>H,bindTransitions:()=>L,call:()=>le,createAsyncMachine:()=>ke,createEnsemble:()=>Ce,createEvent:()=>oe,createFetchMachine:()=>we,createFlow:()=>G,createMachine:()=>f,createMachineBuilder:()=>ve,createMachineFactory:()=>Fe,createMultiMachine:()=>Ee,createMutableMachine:()=>be,createParallelMachine:()=>$,createRunner:()=>re,delegateToChild:()=>Se,describe:()=>J,extendTransitions:()=>Re,extractFromInstance:()=>ne,extractFunctionMetadata:()=>R,extractMachine:()=>E,extractMachines:()=>ee,extractStateNode:()=>b,generateChart:()=>P,generateStatechart:()=>te,guarded:()=>Y,hasState:()=>je,invoke:()=>X,isState:()=>ie,logState:()=>ce,matchMachine:()=>Ne,mergeContext:()=>ae,metadata:()=>Q,next:()=>Ke,overrideTransitions:()=>Pe,pipeTransitions:()=>se,run:()=>k,runAsync:()=>V,runMachine:()=>Oe,runSequence:()=>W,runWithDebug:()=>B,runWithEnsemble:()=>me,runWithRunner:()=>Te,setContext:()=>p,step:()=>I,stepAsync:()=>z,toggle:()=>Ae,transitionTo:()=>q,yieldMachine:()=>_});module.exports=fe(De);function k(t,e){let n=t(e),i=e;for(;;){let{value:r,done:o}=n.next(i);if(o)return r;i=r}}function I(t){return function*(){return yield t}()}function _(t){return t}function W(t,e){return e.reduce((n,i)=>k(i,n),t)}function G(t){return t}function B(t,e,n=(i,r)=>{console.log(`Step ${i}:`,r.context)}){let i=t(e),r=e,o=0;for(n(o,r);;){let{value:a,done:s}=i.next(r);if(s)return console.log("Final:",a),a;r=a,o++,n(o,r)}}async function V(t,e){let n=t(e),i=e;for(;;){let{value:r,done:o}=await n.next(i);if(o)return r;i=r}}async function*z(t){return yield t}var U=Symbol("MachineMeta"),h=Symbol("__machine_runtime_meta__");function C(t,e){let n=t[h]||{},i={...n,...e};e.guards&&n.guards?i.guards=[...e.guards,...n.guards]:e.guards&&(i.guards=[...e.guards]),e.actions&&n.actions?i.actions=[...e.actions,...n.actions]:e.actions&&(i.actions=[...e.actions]),Object.defineProperty(t,h,{value:i,enumerable:!1,writable:!1,configurable:!0})}function q(t,e){return C(e,{target:t.name||t.toString()}),e}function J(t,e){return C(e,{description:t}),e}function Y(t,e){return C(e,{guards:[t]}),e}function X(t,e){return C(e,{invoke:{src:t.src,onDone:t.onDone.name||t.onDone.toString(),onError:t.onError.name||t.onError.toString(),description:t.description}}),e}function H(t,e){return C(e,{actions:[t]}),e}function Q(t,e){return e}var c=require("ts-morph");function Z(t){return c.Node.isIdentifier(t)?t.getText():c.Node.isTypeOfExpression(t)?t.getExpression().getText():"unknown"}function m(t){if(!c.Node.isObjectLiteralExpression(t))return{};let e={};for(let n of t.getProperties())if(c.Node.isPropertyAssignment(n)){let i=n.getName(),r=n.getInitializer();r&&(c.Node.isStringLiteral(r)||c.Node.isNumericLiteral(r)?e[i]=r.getLiteralValue():r.getText()==="true"||r.getText()==="false"?e[i]=r.getText()==="true":c.Node.isIdentifier(r)?e[i]=r.getText():c.Node.isObjectLiteralExpression(r)?e[i]=m(r):c.Node.isArrayLiteralExpression(r)&&(e[i]=r.getElements().map(o=>c.Node.isObjectLiteralExpression(o)?m(o):o.getText())))}return e}function ge(t){if(!c.Node.isObjectLiteralExpression(t))return{};let e={};for(let n of t.getProperties())if(c.Node.isPropertyAssignment(n)){let i=n.getName(),r=n.getInitializer();if(!r)continue;i==="onDone"||i==="onError"?e[i]=Z(r):c.Node.isStringLiteral(r)?e[i]=r.getLiteralValue():c.Node.isIdentifier(r)&&(e[i]=r.getText())}return e}function T(t,e=!1){if(!c.Node.isCallExpression(t))return null;let n=t.getExpression(),i=c.Node.isIdentifier(n)?n.getText():null;if(!i)return null;let r={},o=t.getArguments();switch(i){case"transitionTo":o[0]&&(r.target=Z(o[0]));break;case"describe":if(o[0]&&c.Node.isStringLiteral(o[0])&&(r.description=o[0].getLiteralValue()),o[1]&&c.Node.isCallExpression(o[1])){let a=T(o[1],e);a&&Object.assign(r,a)}break;case"guarded":if(o[0]){let a=m(o[0]);Object.keys(a).length>0&&(r.guards=[a])}if(o[1]&&c.Node.isCallExpression(o[1])){let a=T(o[1],e);a&&Object.assign(r,a)}break;case"invoke":if(o[0]){let a=ge(o[0]);Object.keys(a).length>0&&(r.invoke=a)}break;case"action":if(o[0]){let a=m(o[0]);Object.keys(a).length>0&&(r.actions=[a])}if(o[1]&&c.Node.isCallExpression(o[1])){let a=T(o[1],e);a&&Object.assign(r,a)}break;default:return null}return Object.keys(r).length>0?r:null}function he(t,e=!1){if(!c.Node.isPropertyDeclaration(t))return e&&console.error("      ⚠️ Not a property declaration"),null;let n=t.getInitializer();if(!n)return e&&console.error("      ⚠️ No initializer"),null;if(!c.Node.isCallExpression(n))return e&&console.error("      ⚠️ Initializer is not a call expression"),null;let i=T(n,e);return i&&e&&console.error("      ✅ Extracted metadata:",JSON.stringify(i,null,2)),i}function F(t,e=!1){let n={on:{}},i=t.getDeclarations()[0];if(!i||!c.Node.isClassDeclaration(i))return e&&console.error(`⚠️ Warning: Could not get class declaration for ${t.getName()}`),n;let r=t.getName();e&&console.error(`  Analyzing state: ${r}`);for(let o of i.getInstanceMembers()){let a=o.getName();e&&console.error(`    Checking member: ${a}`);let s=he(o,e);if(!s)continue;e&&console.error(`    Found transition: ${a}`);let{invoke:l,actions:u,guards:x,...d}=s;if(l&&(n.invoke||(n.invoke=[]),n.invoke.push({src:l.src,onDone:{target:l.onDone},onError:{target:l.onError},description:l.description}),e&&console.error(`      → Invoke: ${l.src}`)),d.target){let M={target:d.target};d.description&&(M.description=d.description),x&&(M.cond=x.map(A=>A.name).join(" && "),e&&console.error(`      → Guard: ${M.cond}`)),u&&u.length>0&&(M.actions=u.map(A=>A.name),e&&console.error(`      → Actions: ${M.actions.join(", ")}`)),n.on[a]=M,e&&console.error(`      → Target: ${d.target}`)}}return n}function pe(t,e,n,i,r=!1){let o=F(e,r);if(i){r&&console.error(`  👪 Analyzing children for state: ${t}`),o.initial=i.initialState,o.states={};for(let a of i.classes){let s=n.getClass(a);if(s){let l=s.getSymbolOrThrow();o.states[a]=F(l,r)}else console.warn(`⚠️ Warning: Child class '${a}' not found.`)}}return o}function E(t,e,n=!1){n&&(console.error(`
+🔍 Analyzing machine: ${t.id}`),console.error(`  Source: ${t.input}`));let i=e.getSourceFile(t.input);if(!i)throw new Error(`Source file not found: ${t.input}`);if(t.parallel){n&&console.error("  ⏹️ Parallel machine detected. Analyzing regions.");let o={id:t.id,type:"parallel",states:{}};t.description&&(o.description=t.description);for(let a of t.parallel.regions){n&&console.error(`    📍 Analyzing region: ${a.name}`);let s={};for(let l of a.classes){let u=i.getClass(l);if(u){let x=u.getSymbolOrThrow();s[l]=F(x,n)}else console.warn(`⚠️ Warning: Class '${l}' not found for region '${a.name}'.`)}o.states[a.name]={initial:a.initialState,states:s}}return n&&console.error(`  ✅ Extracted ${t.parallel.regions.length} parallel regions`),o}if(!t.initialState||!t.classes)throw new Error(`Machine config for '${t.id}' must have either 'parallel' or 'initialState'/'classes'.`);let r={id:t.id,initial:t.initialState,states:{}};t.description&&(r.description=t.description);for(let o of t.classes){let a=i.getClass(o);if(!a){console.warn(`⚠️ Warning: Class '${o}' not found in '${t.input}'. Skipping.`);continue}let s=a.getSymbolOrThrow(),l=o===t.initialState&&t.children,u=pe(o,s,i,l?t.children:void 0,n);r.states[o]=u}return n&&console.error(`  ✅ Extracted ${t.classes.length} states`),r}function ee(t){var r;let e=(r=t.verbose)!=null?r:!1;e&&(console.error(`
+📊 Starting statechart extraction`),console.error(`  Machines to extract: ${t.machines.length}`));let n=new c.Project;n.addSourceFilesAtPaths("src/**/*.ts"),n.addSourceFilesAtPaths("examples/**/*.ts");let i=[];for(let o of t.machines)try{let a=E(o,n,e);i.push(a)}catch(a){console.error(`❌ Error extracting machine '${o.id}':`,a),e||console.error("   Run with --verbose for more details")}return e&&console.error(`
+✅ Extraction complete: ${i.length}/${t.machines.length} machines extracted`),i}function P(){let t={input:"examples/authMachine.ts",classes:["LoggedOutMachine","LoggingInMachine","LoggedInMachine","SessionExpiredMachine","ErrorMachine"],id:"auth",initialState:"LoggedOutMachine",description:"Authentication state machine"};console.error("🔍 Using legacy generateChart function"),console.error(`⚠️ Consider using extractMachines() with a config file instead
+`);let e=new c.Project;e.addSourceFilesAtPaths("src/**/*.ts"),e.addSourceFilesAtPaths("examples/**/*.ts");try{let n=E(t,e,!0);console.log(JSON.stringify(n,null,2))}catch(n){console.error("❌ Error:",n),process.exit(1)}}require.main===module&&P();function R(t){return typeof t!="function"?null:t[h]||null}function b(t){let e={on:{}},n=[];for(let i in t){let r=t[i];if(typeof r!="function")continue;let o=R(r);if(o&&(o.invoke&&n.push({src:o.invoke.src,onDone:{target:o.invoke.onDone},onError:{target:o.invoke.onError},description:o.invoke.description}),o.target)){let a={target:o.target};o.description&&(a.description=o.description),o.guards&&o.guards.length>0&&(a.cond=o.guards.map(s=>s.name).join(" && ")),o.actions&&o.actions.length>0&&(a.actions=o.actions.map(s=>s.name)),e.on[i]=a}}return n.length>0&&(e.invoke=n),e}function te(t,e){let n={id:e.id,initial:e.initial,states:{}};e.description&&(n.description=e.description);for(let[i,r]of Object.entries(t))n.states[i]=b(r);return n}function ne(t,e){let n=e.stateName||t.constructor.name||"State";return{id:e.id,initial:n,states:{[n]:b(t)}}}function re(t,e){let n=t,i=s=>{n=s,e==null||e(s)},{context:r,...o}=t,a=new Proxy({},{get(s,l){let u=n[l];if(typeof u=="function")return(...x)=>{let d=u.apply(n.context,x),M=Object.assign({context:d.context},o);return i(M),M}}});return{get state(){return n},get context(){return n.context},actions:a,setState:i}}function Ce(t,e,n){let i=()=>{let o=t.getContext(),a=n(o),s=e[a];if(!s)throw new Error(`[Ensemble] Invalid state: No factory found for state "${String(a)}".`);return s(o)},r=new Proxy({},{get(o,a){let s=i(),l=s[a];if(typeof l!="function")throw new Error(`[Ensemble] Transition "${a}" is not valid in the current state.`);return(...u)=>l.apply(s.context,u)}});return{get context(){return t.getContext()},get state(){return i()},actions:r}}function Te(t,e){let n=re(e),i=t(n),r=i.next();for(;!r.done;)r=i.next();return r.value}function me(t,e){let n=t(e),i=n.next();for(;!i.done;)i=n.next();return i.value}var v=class{constructor(e){this.store=e}get context(){return this.store.getContext()}setContext(e){this.store.setContext(e)}};function Ee(t,e){let n=new t(e);return new Proxy({},{get(i,r){let o=e.getContext();if(r in o)return o[r];let a=n[r];if(typeof a=="function")return(...s)=>a.apply(n,s)},set(i,r,o){let a=e.getContext();if(r in a){let s={...a,[r]:o};return e.setContext(s),!0}return!1},has(i,r){let o=e.getContext();return r in o||typeof n[r]=="function"},ownKeys(i){let r=e.getContext(),o=Object.keys(r),a=Object.getOwnPropertyNames(Object.getPrototypeOf(n)).filter(s=>s!=="constructor"&&typeof n[s]=="function");return Array.from(new Set([...o,...a]))},getOwnPropertyDescriptor(i,r){let o=e.getContext();if(r in o||typeof n[r]=="function")return{value:void 0,writable:!0,enumerable:!0,configurable:!0}}})}function be(t,e,n){let i=()=>{let r=n(t),o=e[r];if(!o)throw new Error(`[MutableMachine] Invalid state: No factory for state "${String(r)}".`);return o(t)};return new Proxy(t,{get(r,o,a){if(o in r)return r[o];let s=i(),l=s[o];if(typeof l=="function")return(...u)=>{let x=l.apply(s.context,u);if(typeof x!="object"||x===null){console.warn(`[MutableMachine] Transition "${String(o)}" did not return a valid context object. State may be inconsistent.`);return}Object.keys(r).forEach(d=>delete r[d]),Object.assign(r,x)}},set(r,o,a,s){return r[o]=a,!0},has(r,o){let a=i();return o in r||typeof a[o]=="function"}})}function Se(t){return function(...e){let n=this.context.child;if(typeof n[t]=="function"){let i=n[t](...e);return p(this,{...this.context,child:i})}return this}}function Ae(t){return function(){return typeof this.context[t]!="boolean"&&console.warn(`[toggle primitive] Property '${String(t)}' is not a boolean. Toggling may have unexpected results.`),p(this,{...this.context,[t]:!this.context[t]})}}var N=class extends y{constructor(n){super({status:"idle"});this.config=n;this.fetch=n=>new g(this.config,n!=null?n:this.config.initialParams,1)}},g=class extends y{constructor(n,i,r){super({status:"loading",abortController:new AbortController,attempts:r});this.config=n;this.params=i;this.succeed=n=>{var i,r;return(r=(i=this.config).onSuccess)==null||r.call(i,n),new O(this.config,{status:"success",data:n})};this.fail=n=>{var r,o,a;let i=(r=this.config.maxRetries)!=null?r:3;return this.context.attempts<i?new j(this.config,this.params,n,this.context.attempts):((a=(o=this.config).onError)==null||a.call(o,n),new K(this.config,{status:"error",error:n}))};this.cancel=()=>(this.context.abortController.abort(),new D(this.config));this.execute()}async execute(){}},j=class extends y{constructor(n,i,r,o){super({status:"retrying",error:r,attempts:o});this.config=n;this.params=i;this.retry=n=>new g(this.config,n!=null?n:this.params,this.context.attempts+1)}},O=class extends y{constructor(n,i){super(i);this.config=n;this.refetch=n=>new g(this.config,n!=null?n:this.config.initialParams,1)}},K=class extends y{constructor(n,i){super(i);this.config=n;this.retry=n=>new g(this.config,n!=null?n:this.config.initialParams,1)}},D=class extends y{constructor(n){super({status:"canceled"});this.config=n;this.refetch=n=>new g(this.config,n!=null?n:this.config.initialParams,1)}};function we(t){return new N(t)}function $(t,e){let n={...t.context,...e.context},i={...t},r={...e};delete i.context,delete r.context;let o={};for(let a in i){let s=i[a];o[a]=(...l)=>{let u=s.apply(t.context,l);return $(u,e)}}for(let a in r){let s=r[a];o[a]=(...l)=>{let u=s.apply(e.context,l);return $(t,u)}}return{context:n,...o}}function ie(t,e){return t instanceof e}function oe(t,...e){return{type:t,args:e}}function ae(t,e){return p(t,n=>({...n,...e}))}async function se(t,...e){let n=t;for(let i of e)n=await i(n);return n}function ce(t,e){return e?console.log(e,t.context):console.log(t.context),t}function le(t,e,...n){return t.apply(e,n)}function L(t){return new Proxy(t,{get(e,n){let i=e[n];return typeof i=="function"?function(...r){let o=i.apply(e.context,r);return o&&typeof o=="object"&&"context"in o?L(o):o}:i}})}var S=class t{constructor(e){return this.wrappedMachine=e,new Proxy(this,{get:(n,i)=>{if(i==="wrappedMachine"||i==="context")return Reflect.get(n,i);let r=this.wrappedMachine[i];return typeof r=="function"?(...o)=>{let a=r.apply(this.wrappedMachine.context,o);return a&&typeof a=="object"&&"context"in a?new t(a):a}:r}})}get context(){return this.wrappedMachine.context}};function f(t,e){return Object.assign({context:t},e)}function ke(t,e){return Object.assign({context:t},e)}function Fe(){return t=>{let e=Object.fromEntries(Object.entries(t).map(([n,i])=>[n,function(...r){let o=i(this,...r);return f(o,e)}]));return n=>f(n,e)}}function p(t,e){let{context:n,...i}=t,r=typeof e=="function"?e(n):e;return f(r,i)}function Pe(t,e){let{context:n,...i}=t,r={...i,...e};return f(n,r)}function Re(t,e){let{context:n,...i}=t,r={...i,...e};return f(n,r)}function ve(t){let{context:e,...n}=t;return i=>f(i,n)}function Ne(t,e,n){let i=t.context[e],r=n[i];if(!r)throw new Error(`No handler found for state: ${String(i)}`);return r(t.context)}function je(t,e,n){return t.context[e]===n}function Oe(t,e){let n=t;async function i(r){let o=n[r.type];if(typeof o!="function")throw new Error(`[Machine] Unknown event type '${String(r.type)}' on current state.`);return n=await o.apply(n.context,r.args),e==null||e(n),n}return{get state(){return n.context},dispatch:i}}var y=class{constructor(e){this.context=e}};function Ke(t,e){let{context:n,...i}=t;return f(e(n),i)}

package/dist/esm/development/index.js

@@ -75,12 +75,12 @@ function attachRuntimeMeta(fn, metadata2) {
   const existing = fn[RUNTIME_META] || {};
   const merged = { ...existing, ...metadata2 };
   if (metadata2.guards && existing.guards) {
-    merged.guards = [...existing.guards, ...metadata2.guards];
+    merged.guards = [...metadata2.guards, ...existing.guards];
   } else if (metadata2.guards) {
     merged.guards = [...metadata2.guards];
   }
   if (metadata2.actions && existing.actions) {
-    merged.actions = [...existing.actions, ...metadata2.actions];
+    merged.actions = [...metadata2.actions, ...existing.actions];
   } else if (metadata2.actions) {
     merged.actions = [...metadata2.actions];
   }
@@ -196,17 +196,17 @@ function parseInvokeService(obj) {
   }
   return service;
 }
-function extractFromCallExpression(call, verbose = false) {
-  if (!Node.isCallExpression(call)) {
+function extractFromCallExpression(call2, verbose = false) {
+  if (!Node.isCallExpression(call2)) {
     return null;
   }
-  const expression = call.getExpression();
+  const expression = call2.getExpression();
   const fnName = Node.isIdentifier(expression) ? expression.getText() : null;
   if (!fnName) {
     return null;
   }
   const metadata2 = {};
-  const args = call.getArguments();
+  const args = call2.getArguments();
   switch (fnName) {
     case "transitionTo":
       if (args[0]) {
@@ -346,6 +346,26 @@ function analyzeStateNode(classSymbol, verbose = false) {
   }
   return chartNode;
 }
+function analyzeStateNodeWithNesting(className, classSymbol, sourceFile, childConfig, verbose = false) {
+  const stateNode = analyzeStateNode(classSymbol, verbose);
+  if (childConfig) {
+    if (verbose) {
+      console.error(`  👪 Analyzing children for state: ${className}`);
+    }
+    stateNode.initial = childConfig.initialState;
+    stateNode.states = {};
+    for (const childClassName of childConfig.classes) {
+      const childClassDeclaration = sourceFile.getClass(childClassName);
+      if (childClassDeclaration) {
+        const childSymbol = childClassDeclaration.getSymbolOrThrow();
+        stateNode.states[childClassName] = analyzeStateNode(childSymbol, verbose);
+      } else {
+        console.warn(`⚠️ Warning: Child class '${childClassName}' not found.`);
+      }
+    }
+  }
+  return stateNode;
+}
 function extractMachine(config, project, verbose = false) {
   if (verbose) {
     console.error(`
@@ -356,6 +376,45 @@ function extractMachine(config, project, verbose = false) {
   if (!sourceFile) {
     throw new Error(`Source file not found: ${config.input}`);
   }
+  if (config.parallel) {
+    if (verbose) {
+      console.error(`  ⏹️ Parallel machine detected. Analyzing regions.`);
+    }
+    const parallelChart = {
+      id: config.id,
+      type: "parallel",
+      states: {}
+    };
+    if (config.description) {
+      parallelChart.description = config.description;
+    }
+    for (const region of config.parallel.regions) {
+      if (verbose) {
+        console.error(`    📍 Analyzing region: ${region.name}`);
+      }
+      const regionStates = {};
+      for (const className of region.classes) {
+        const classDeclaration = sourceFile.getClass(className);
+        if (classDeclaration) {
+          const classSymbol = classDeclaration.getSymbolOrThrow();
+          regionStates[className] = analyzeStateNode(classSymbol, verbose);
+        } else {
+          console.warn(`⚠️ Warning: Class '${className}' not found for region '${region.name}'.`);
+        }
+      }
+      parallelChart.states[region.name] = {
+        initial: region.initialState,
+        states: regionStates
+      };
+    }
+    if (verbose) {
+      console.error(`  ✅ Extracted ${config.parallel.regions.length} parallel regions`);
+    }
+    return parallelChart;
+  }
+  if (!config.initialState || !config.classes) {
+    throw new Error(`Machine config for '${config.id}' must have either 'parallel' or 'initialState'/'classes'.`);
+  }
   const fullChart = {
     id: config.id,
     initial: config.initialState,
@@ -371,7 +430,14 @@ function extractMachine(config, project, verbose = false) {
       continue;
     }
     const classSymbol = classDeclaration.getSymbolOrThrow();
-    const stateNode = analyzeStateNode(classSymbol, verbose);
+    const hasChildren = className === config.initialState && config.children;
+    const stateNode = analyzeStateNodeWithNesting(
+      className,
+      classSymbol,
+      sourceFile,
+      hasChildren ? config.children : void 0,
+      verbose
+    );
     fullChart.states[className] = stateNode;
   }
   if (verbose) {
@@ -737,6 +803,198 @@ function createMutableMachine(sharedContext, factories, getDiscriminant) {
   });
 }
 
+// src/higher-order.ts
+function delegateToChild(actionName) {
+  return function(...args) {
+    const child = this.context.child;
+    if (typeof child[actionName] === "function") {
+      const newChildState = child[actionName](...args);
+      return setContext(this, { ...this.context, child: newChildState });
+    }
+    return this;
+  };
+}
+function toggle(prop) {
+  return function() {
+    if (typeof this.context[prop] !== "boolean") {
+      console.warn(`[toggle primitive] Property '${String(prop)}' is not a boolean. Toggling may have unexpected results.`);
+    }
+    return setContext(this, {
+      ...this.context,
+      [prop]: !this.context[prop]
+    });
+  };
+}
+var IdleMachine = class extends MachineBase {
+  constructor(config) {
+    super({ status: "idle" });
+    this.config = config;
+    this.fetch = (params) => new LoadingMachine(this.config, params != null ? params : this.config.initialParams, 1);
+  }
+};
+var LoadingMachine = class extends MachineBase {
+  constructor(config, params, attempts) {
+    super({ status: "loading", abortController: new AbortController(), attempts });
+    this.config = config;
+    this.params = params;
+    this.succeed = (data) => {
+      var _a, _b;
+      (_b = (_a = this.config).onSuccess) == null ? void 0 : _b.call(_a, data);
+      return new SuccessMachine(this.config, { status: "success", data });
+    };
+    this.fail = (error) => {
+      var _a, _b, _c;
+      const maxRetries = (_a = this.config.maxRetries) != null ? _a : 3;
+      if (this.context.attempts < maxRetries) {
+        return new RetryingMachine(this.config, this.params, error, this.context.attempts);
+      }
+      (_c = (_b = this.config).onError) == null ? void 0 : _c.call(_b, error);
+      return new ErrorMachine(this.config, { status: "error", error });
+    };
+    this.cancel = () => {
+      this.context.abortController.abort();
+      return new CanceledMachine(this.config);
+    };
+    this.execute();
+  }
+  async execute() {
+  }
+};
+var RetryingMachine = class extends MachineBase {
+  constructor(config, params, error, attempts) {
+    super({ status: "retrying", error, attempts });
+    this.config = config;
+    this.params = params;
+    // This would be called after a delay.
+    this.retry = (params) => new LoadingMachine(this.config, params != null ? params : this.params, this.context.attempts + 1);
+  }
+};
+var SuccessMachine = class extends MachineBase {
+  constructor(config, context) {
+    super(context);
+    this.config = config;
+    this.refetch = (params) => new LoadingMachine(this.config, params != null ? params : this.config.initialParams, 1);
+  }
+};
+var ErrorMachine = class extends MachineBase {
+  constructor(config, context) {
+    super(context);
+    this.config = config;
+    this.retry = (params) => new LoadingMachine(this.config, params != null ? params : this.config.initialParams, 1);
+  }
+};
+var CanceledMachine = class extends MachineBase {
+  constructor(config) {
+    super({ status: "canceled" });
+    this.config = config;
+    this.refetch = (params) => new LoadingMachine(this.config, params != null ? params : this.config.initialParams, 1);
+  }
+};
+function createFetchMachine(config) {
+  return new IdleMachine(config);
+}
+function createParallelMachine(m1, m2) {
+  const combinedContext = { ...m1.context, ...m2.context };
+  const transitions1 = { ...m1 };
+  const transitions2 = { ...m2 };
+  delete transitions1.context;
+  delete transitions2.context;
+  const combinedTransitions = {};
+  for (const key in transitions1) {
+    const transitionFn = transitions1[key];
+    combinedTransitions[key] = (...args) => {
+      const nextM1 = transitionFn.apply(m1.context, args);
+      return createParallelMachine(nextM1, m2);
+    };
+  }
+  for (const key in transitions2) {
+    const transitionFn = transitions2[key];
+    combinedTransitions[key] = (...args) => {
+      const nextM2 = transitionFn.apply(m2.context, args);
+      return createParallelMachine(m1, nextM2);
+    };
+  }
+  return {
+    context: combinedContext,
+    ...combinedTransitions
+  };
+}
+
+// src/utils.ts
+function isState(machine, machineClass) {
+  return machine instanceof machineClass;
+}
+function createEvent(type, ...args) {
+  return { type, args };
+}
+function mergeContext(machine, partialContext) {
+  return setContext(machine, (ctx) => ({ ...ctx, ...partialContext }));
+}
+async function pipeTransitions(initialMachine, ...transitions) {
+  let current = initialMachine;
+  for (const transitionFn of transitions) {
+    current = await transitionFn(current);
+  }
+  return current;
+}
+function logState(machine, label) {
+  if (label) {
+    console.log(label, machine.context);
+  } else {
+    console.log(machine.context);
+  }
+  return machine;
+}
+function call(fn, context, ...args) {
+  return fn.apply(context, args);
+}
+function bindTransitions(machine) {
+  return new Proxy(machine, {
+    get(target, prop) {
+      const value = target[prop];
+      if (typeof value === "function") {
+        return function(...args) {
+          const result = value.apply(target.context, args);
+          if (result && typeof result === "object" && "context" in result) {
+            return bindTransitions(result);
+          }
+          return result;
+        };
+      }
+      return value;
+    }
+  });
+}
+var BoundMachine = class _BoundMachine {
+  constructor(machine) {
+    this.wrappedMachine = machine;
+    return new Proxy(this, {
+      get: (target, prop) => {
+        if (prop === "wrappedMachine" || prop === "context") {
+          return Reflect.get(target, prop);
+        }
+        const value = this.wrappedMachine[prop];
+        if (typeof value === "function") {
+          return (...args) => {
+            const result = value.apply(this.wrappedMachine.context, args);
+            if (result && typeof result === "object" && "context" in result) {
+              return new _BoundMachine(result);
+            }
+            return result;
+          };
+        }
+        return value;
+      }
+    });
+  }
+  /**
+   * Access the underlying machine's context directly.
+   */
+  get context() {
+    return this.wrappedMachine.context;
+  }
+};
+
 // src/index.ts
 function createMachine(context, fns) {
   return Object.assign({ context }, fns);
@@ -827,20 +1085,27 @@ function next(m, update) {
   return createMachine(update(context), transitions);
 }
 export {
+  BoundMachine,
   META_KEY,
   MachineBase,
   MultiMachineBase,
   RUNTIME_META,
   action,
+  bindTransitions,
+  call,
   createAsyncMachine,
   createEnsemble,
+  createEvent,
+  createFetchMachine,
   createFlow,
   createMachine,
   createMachineBuilder,
   createMachineFactory,
   createMultiMachine,
   createMutableMachine,
+  createParallelMachine,
   createRunner,
+  delegateToChild,
   describe,
   extendTransitions,
   extractFromInstance,
@@ -853,10 +1118,14 @@ export {
   guarded,
   hasState,
   invoke,
+  isState,
+  logState,
   matchMachine,
+  mergeContext,
   metadata,
   next,
   overrideTransitions,
+  pipeTransitions,
   run,
   runAsync,
   runMachine,
@@ -867,6 +1136,7 @@ export {
   setContext,
   step,
   stepAsync,
+  toggle,
   transitionTo,
   yieldMachine
 };