@akashjs/runtime 0.1.31 → 0.1.32

package/dist/machine.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkOPXWBGJL_cjs=require('./chunk-OPXWBGJL.cjs');require('./chunk-RTJ6UDGV.cjs');Object.defineProperty(exports,"createMachine",{enumerable:true,get:function(){return chunkOPXWBGJL_cjs.a}});//# sourceMappingURL=machine.cjs.map
+'use strict';var chunkYSVREYEH_cjs=require('./chunk-YSVREYEH.cjs');require('./chunk-RTJ6UDGV.cjs');Object.defineProperty(exports,"createMachine",{enumerable:true,get:function(){return chunkYSVREYEH_cjs.a}});//# sourceMappingURL=machine.cjs.map
 //# sourceMappingURL=machine.cjs.map

package/dist/machine.js

@@ -1,2 +1,2 @@
-export{a as createMachine}from'./chunk-JDJQW4YE.js';import'./chunk-TWA4T6PX.js';//# sourceMappingURL=machine.js.map
+export{a as createMachine}from'./chunk-42ZHET2G.js';import'./chunk-TWA4T6PX.js';//# sourceMappingURL=machine.js.map
 //# sourceMappingURL=machine.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akashjs/runtime",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "AkashJS core runtime — signals, components, DOM rendering",
   "type": "module",
   "main": "dist/index.cjs",

package/dist/chunk-JDJQW4YE.js

@@ -1,2 +0,0 @@
-import {l,m}from'./chunk-TWA4T6PX.js';function M(t){let n=l(t.initial),a=l(t.context??{}),d=l([t.initial]),u=m(()=>t.states[n()]?.type==="final"),y=m(()=>{let e=t.states[n()];return e?.on?Object.keys(e.on):[]}),S=t.states[t.initial];S?.entry&&S.entry({data:a(),event:""});function E(e,T){if(u())return;let i=n(),o=t.states[i];if(!o?.on)return;let x=o.on[e];if(!x)return;let s,l,f;if(typeof x=="string")s=x;else {let r=x;s=r.target,l=r.guard,f=r.action;}let c={data:a(),event:e,payload:T};if(l&&!l(c))return;o.exit&&o.exit(c),f&&f(c),a.set(c.data),n.set(s),d.update(r=>[...r,s]);let v=t.states[s];v?.entry&&v.entry({data:a(),event:e});}function h(e){let T=t.states[n()];if(!T?.on)return  false;let i=T.on[e];if(!i)return  false;if(typeof i!="string"){let o=i;if(o.guard)return o.guard({data:a(),event:e})}return  true}return {state:()=>n(),context:()=>a(),send:E,matches:e=>n()===e,done:u,reset(){n.set(t.initial),a.set(t.context??{}),d.set([t.initial]);},history:()=>d(),can:h,nextEvents:y}}export{M as a};//# sourceMappingURL=chunk-JDJQW4YE.js.map
-//# sourceMappingURL=chunk-JDJQW4YE.js.map

package/dist/chunk-JDJQW4YE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/machine.ts"],"names":["createMachine","config","currentState","signal","contextData","stateHistory","done","computed","nextEvents","stateCfg","initialStateCfg","send","event","payload","state","transition","target","guard","action","t","ctx","h","targetCfg","can"],"mappings":"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","file":"chunk-JDJQW4YE.js","sourcesContent":["/**\n * State machines for complex UI flows.\n *\n * Finite state machines with typed states, events, guards,\n * actions, and reactive current state signal.\n *\n * ```ts\n * const checkout = createMachine({\n *   initial: 'cart',\n *   states: {\n *     cart: { on: { CHECKOUT: 'shipping' } },\n *     shipping: { on: { NEXT: 'payment', BACK: 'cart' } },\n *     payment: { on: { PAY: 'processing', BACK: 'shipping' } },\n *     processing: { on: { SUCCESS: 'complete', FAIL: 'payment' } },\n *     complete: { type: 'final' },\n *   },\n * });\n *\n * checkout.state();  // 'cart'\n * checkout.send('CHECKOUT');\n * checkout.state();  // 'shipping'\n * checkout.matches('shipping'); // true\n * ```\n */\n\nimport { signal, computed } from './signals.js';\nimport type { ReadonlySignal } from './signals.js';\n\n// =========================================================================\n// Types\n// =========================================================================\n\nexport interface MachineConfig<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Initial state */\n  initial: TState;\n  /** Initial context data */\n  context?: TContext;\n  /** State definitions */\n  states: Record<TState, StateConfig<TState, TEvent, TContext>>;\n}\n\nexport interface StateConfig<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Transitions: event → target state */\n  on?: Partial<Record<TEvent, TState | TransitionConfig<TState, TEvent, TContext>>>;\n  /** Entry action — runs when entering this state */\n  entry?: (ctx: MachineContext<TContext>) => void;\n  /** Exit action — runs when leaving this state */\n  exit?: (ctx: MachineContext<TContext>) => void;\n  /** Final state — machine stops accepting events */\n  type?: 'final';\n}\n\nexport interface TransitionConfig<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Target state */\n  target: TState;\n  /** Guard — transition only if this returns true */\n  guard?: (ctx: MachineContext<TContext>) => boolean;\n  /** Action — runs during the transition */\n  action?: (ctx: MachineContext<TContext>) => void;\n}\n\nexport interface MachineContext<TContext> {\n  /** The context data (mutable) */\n  data: TContext;\n  /** The current event that triggered the transition */\n  event: string;\n  /** Optional payload passed with the event via send(event, payload) */\n  payload?: unknown;\n}\n\nexport interface Machine<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Current state (reactive signal) */\n  state: ReadonlySignal<TState>;\n  /** Context data (reactive signal) */\n  context: ReadonlySignal<TContext>;\n  /** Send an event to the machine */\n  send(event: TEvent, payload?: Record<string, unknown>): void;\n  /** Check if currently in a specific state */\n  matches(state: TState): boolean;\n  /** Whether the machine is in a final state */\n  done: ReadonlySignal<boolean>;\n  /** Reset to initial state */\n  reset(): void;\n  /** State history */\n  history: ReadonlySignal<TState[]>;\n  /** Can a specific event be sent in the current state? */\n  can(event: TEvent): boolean;\n  /** Get all possible events from current state */\n  nextEvents: ReadonlySignal<TEvent[]>;\n}\n\n// =========================================================================\n// createMachine\n// =========================================================================\n\n/**\n * Create a finite state machine.\n */\nexport function createMachine<\n  TState extends string,\n  TEvent extends string,\n  TContext = unknown,\n>(config: MachineConfig<TState, TEvent, TContext>): Machine<TState, TEvent, TContext> {\n  const currentState = signal<TState>(config.initial);\n  const contextData = signal<TContext>((config.context ?? {}) as TContext);\n  const stateHistory = signal<TState[]>([config.initial]);\n\n  const done = computed(() => {\n    const stateCfg = config.states[currentState()];\n    return stateCfg?.type === 'final';\n  });\n\n  const nextEvents = computed((): TEvent[] => {\n    const stateCfg = config.states[currentState()];\n    if (!stateCfg?.on) return [];\n    return Object.keys(stateCfg.on) as TEvent[];\n  });\n\n  // Run entry action for initial state\n  const initialStateCfg = config.states[config.initial];\n  if (initialStateCfg?.entry) {\n    initialStateCfg.entry({ data: contextData() as TContext, event: '' });\n  }\n\n  function send(event: TEvent, payload?: unknown): void {\n    if (done()) return; // Final state — no more transitions\n\n    const state = currentState();\n    const stateCfg = config.states[state];\n    if (!stateCfg?.on) return;\n\n    const transition = stateCfg.on[event];\n    if (!transition) return;\n\n    let target: TState;\n    let guard: ((ctx: MachineContext<TContext>) => boolean) | undefined;\n    let action: ((ctx: MachineContext<TContext>) => void) | undefined;\n\n    if (typeof transition === 'string') {\n      target = transition;\n    } else {\n      const t = transition as TransitionConfig<TState, TEvent, TContext>;\n      target = t.target;\n      guard = t.guard;\n      action = t.action;\n    }\n\n    const ctx: MachineContext<TContext> = {\n      data: contextData() as TContext,\n      event,\n      payload,\n    };\n\n    // Check guard\n    if (guard && !guard(ctx)) return;\n\n    // Exit action\n    if (stateCfg.exit) {\n      stateCfg.exit(ctx);\n    }\n\n    // Transition action\n    if (action) {\n      action(ctx);\n    }\n\n    // Update context if modified\n    contextData.set(ctx.data);\n\n    // Enter new state\n    currentState.set(target);\n    stateHistory.update((h) => [...h, target]);\n\n    // Entry action for new state\n    const targetCfg = config.states[target];\n    if (targetCfg?.entry) {\n      targetCfg.entry({ data: contextData() as TContext, event });\n    }\n  }\n\n  function can(event: TEvent): boolean {\n    const stateCfg = config.states[currentState()];\n    if (!stateCfg?.on) return false;\n    const transition = stateCfg.on[event];\n    if (!transition) return false;\n\n    if (typeof transition !== 'string') {\n      const t = transition as TransitionConfig<TState, TEvent, TContext>;\n      if (t.guard) {\n        return t.guard({ data: contextData() as TContext, event });\n      }\n    }\n    return true;\n  }\n\n  return {\n    state: () => currentState(),\n    context: () => contextData(),\n    send,\n    matches: (state: TState) => currentState() === state,\n    done,\n    reset() {\n      currentState.set(config.initial);\n      contextData.set((config.context ?? {}) as TContext);\n      stateHistory.set([config.initial]);\n    },\n    history: () => stateHistory(),\n    can,\n    nextEvents,\n  };\n}\n"]}

package/dist/chunk-OPXWBGJL.cjs

@@ -1,2 +0,0 @@
-'use strict';var chunkRTJ6UDGV_cjs=require('./chunk-RTJ6UDGV.cjs');function M(t){let n=chunkRTJ6UDGV_cjs.l(t.initial),a=chunkRTJ6UDGV_cjs.l(t.context??{}),d=chunkRTJ6UDGV_cjs.l([t.initial]),u=chunkRTJ6UDGV_cjs.m(()=>t.states[n()]?.type==="final"),y=chunkRTJ6UDGV_cjs.m(()=>{let e=t.states[n()];return e?.on?Object.keys(e.on):[]}),S=t.states[t.initial];S?.entry&&S.entry({data:a(),event:""});function E(e,T){if(u())return;let i=n(),o=t.states[i];if(!o?.on)return;let x=o.on[e];if(!x)return;let s,l,f;if(typeof x=="string")s=x;else {let r=x;s=r.target,l=r.guard,f=r.action;}let c={data:a(),event:e,payload:T};if(l&&!l(c))return;o.exit&&o.exit(c),f&&f(c),a.set(c.data),n.set(s),d.update(r=>[...r,s]);let v=t.states[s];v?.entry&&v.entry({data:a(),event:e});}function h(e){let T=t.states[n()];if(!T?.on)return  false;let i=T.on[e];if(!i)return  false;if(typeof i!="string"){let o=i;if(o.guard)return o.guard({data:a(),event:e})}return  true}return {state:()=>n(),context:()=>a(),send:E,matches:e=>n()===e,done:u,reset(){n.set(t.initial),a.set(t.context??{}),d.set([t.initial]);},history:()=>d(),can:h,nextEvents:y}}exports.a=M;//# sourceMappingURL=chunk-OPXWBGJL.cjs.map
-//# sourceMappingURL=chunk-OPXWBGJL.cjs.map

package/dist/chunk-OPXWBGJL.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/machine.ts"],"names":["createMachine","config","currentState","signal","contextData","stateHistory","done","computed","nextEvents","stateCfg","initialStateCfg","send","event","payload","state","transition","target","guard","action","t","ctx","h","targetCfg","can"],"mappings":"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","file":"chunk-OPXWBGJL.cjs","sourcesContent":["/**\n * State machines for complex UI flows.\n *\n * Finite state machines with typed states, events, guards,\n * actions, and reactive current state signal.\n *\n * ```ts\n * const checkout = createMachine({\n *   initial: 'cart',\n *   states: {\n *     cart: { on: { CHECKOUT: 'shipping' } },\n *     shipping: { on: { NEXT: 'payment', BACK: 'cart' } },\n *     payment: { on: { PAY: 'processing', BACK: 'shipping' } },\n *     processing: { on: { SUCCESS: 'complete', FAIL: 'payment' } },\n *     complete: { type: 'final' },\n *   },\n * });\n *\n * checkout.state();  // 'cart'\n * checkout.send('CHECKOUT');\n * checkout.state();  // 'shipping'\n * checkout.matches('shipping'); // true\n * ```\n */\n\nimport { signal, computed } from './signals.js';\nimport type { ReadonlySignal } from './signals.js';\n\n// =========================================================================\n// Types\n// =========================================================================\n\nexport interface MachineConfig<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Initial state */\n  initial: TState;\n  /** Initial context data */\n  context?: TContext;\n  /** State definitions */\n  states: Record<TState, StateConfig<TState, TEvent, TContext>>;\n}\n\nexport interface StateConfig<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Transitions: event → target state */\n  on?: Partial<Record<TEvent, TState | TransitionConfig<TState, TEvent, TContext>>>;\n  /** Entry action — runs when entering this state */\n  entry?: (ctx: MachineContext<TContext>) => void;\n  /** Exit action — runs when leaving this state */\n  exit?: (ctx: MachineContext<TContext>) => void;\n  /** Final state — machine stops accepting events */\n  type?: 'final';\n}\n\nexport interface TransitionConfig<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Target state */\n  target: TState;\n  /** Guard — transition only if this returns true */\n  guard?: (ctx: MachineContext<TContext>) => boolean;\n  /** Action — runs during the transition */\n  action?: (ctx: MachineContext<TContext>) => void;\n}\n\nexport interface MachineContext<TContext> {\n  /** The context data (mutable) */\n  data: TContext;\n  /** The current event that triggered the transition */\n  event: string;\n  /** Optional payload passed with the event via send(event, payload) */\n  payload?: unknown;\n}\n\nexport interface Machine<TState extends string, TEvent extends string, TContext = unknown> {\n  /** Current state (reactive signal) */\n  state: ReadonlySignal<TState>;\n  /** Context data (reactive signal) */\n  context: ReadonlySignal<TContext>;\n  /** Send an event to the machine */\n  send(event: TEvent, payload?: Record<string, unknown>): void;\n  /** Check if currently in a specific state */\n  matches(state: TState): boolean;\n  /** Whether the machine is in a final state */\n  done: ReadonlySignal<boolean>;\n  /** Reset to initial state */\n  reset(): void;\n  /** State history */\n  history: ReadonlySignal<TState[]>;\n  /** Can a specific event be sent in the current state? */\n  can(event: TEvent): boolean;\n  /** Get all possible events from current state */\n  nextEvents: ReadonlySignal<TEvent[]>;\n}\n\n// =========================================================================\n// createMachine\n// =========================================================================\n\n/**\n * Create a finite state machine.\n */\nexport function createMachine<\n  TState extends string,\n  TEvent extends string,\n  TContext = unknown,\n>(config: MachineConfig<TState, TEvent, TContext>): Machine<TState, TEvent, TContext> {\n  const currentState = signal<TState>(config.initial);\n  const contextData = signal<TContext>((config.context ?? {}) as TContext);\n  const stateHistory = signal<TState[]>([config.initial]);\n\n  const done = computed(() => {\n    const stateCfg = config.states[currentState()];\n    return stateCfg?.type === 'final';\n  });\n\n  const nextEvents = computed((): TEvent[] => {\n    const stateCfg = config.states[currentState()];\n    if (!stateCfg?.on) return [];\n    return Object.keys(stateCfg.on) as TEvent[];\n  });\n\n  // Run entry action for initial state\n  const initialStateCfg = config.states[config.initial];\n  if (initialStateCfg?.entry) {\n    initialStateCfg.entry({ data: contextData() as TContext, event: '' });\n  }\n\n  function send(event: TEvent, payload?: unknown): void {\n    if (done()) return; // Final state — no more transitions\n\n    const state = currentState();\n    const stateCfg = config.states[state];\n    if (!stateCfg?.on) return;\n\n    const transition = stateCfg.on[event];\n    if (!transition) return;\n\n    let target: TState;\n    let guard: ((ctx: MachineContext<TContext>) => boolean) | undefined;\n    let action: ((ctx: MachineContext<TContext>) => void) | undefined;\n\n    if (typeof transition === 'string') {\n      target = transition;\n    } else {\n      const t = transition as TransitionConfig<TState, TEvent, TContext>;\n      target = t.target;\n      guard = t.guard;\n      action = t.action;\n    }\n\n    const ctx: MachineContext<TContext> = {\n      data: contextData() as TContext,\n      event,\n      payload,\n    };\n\n    // Check guard\n    if (guard && !guard(ctx)) return;\n\n    // Exit action\n    if (stateCfg.exit) {\n      stateCfg.exit(ctx);\n    }\n\n    // Transition action\n    if (action) {\n      action(ctx);\n    }\n\n    // Update context if modified\n    contextData.set(ctx.data);\n\n    // Enter new state\n    currentState.set(target);\n    stateHistory.update((h) => [...h, target]);\n\n    // Entry action for new state\n    const targetCfg = config.states[target];\n    if (targetCfg?.entry) {\n      targetCfg.entry({ data: contextData() as TContext, event });\n    }\n  }\n\n  function can(event: TEvent): boolean {\n    const stateCfg = config.states[currentState()];\n    if (!stateCfg?.on) return false;\n    const transition = stateCfg.on[event];\n    if (!transition) return false;\n\n    if (typeof transition !== 'string') {\n      const t = transition as TransitionConfig<TState, TEvent, TContext>;\n      if (t.guard) {\n        return t.guard({ data: contextData() as TContext, event });\n      }\n    }\n    return true;\n  }\n\n  return {\n    state: () => currentState(),\n    context: () => contextData(),\n    send,\n    matches: (state: TState) => currentState() === state,\n    done,\n    reset() {\n      currentState.set(config.initial);\n      contextData.set((config.context ?? {}) as TContext);\n      stateHistory.set([config.initial]);\n    },\n    history: () => stateHistory(),\n    can,\n    nextEvents,\n  };\n}\n"]}