@pyreon/machine 0.11.5 → 0.11.6

package/README.md

@@ -23,13 +23,17 @@ const machine = createMachine({
   },
 })
 
-machine()              // 'idle' — reads like a signal
-machine.send('FETCH')  // transition to 'loading'
+machine() // 'idle' — reads like a signal
+machine.send('FETCH') // transition to 'loading'
 machine.matches('loading') // true — reactive in effects/JSX
 
 // Reactive in JSX
-{() => machine.matches('loading') && <Spinner />}
-{() => machine.matches('done') && <Results />}
+{
+  ;() => machine.matches('loading') && <Spinner />
+}
+{
+  ;() => machine.matches('done') && <Results />
+}
 ```
 
 ## Guards
@@ -57,16 +61,16 @@ Create a reactive state machine. Config: `initial` (starting state) and `states`
 
 **Returns `Machine`:**
 
-| Property | Description |
-| --- | --- |
-| `machine()` | Read current state (reactive) |
-| `send(event, payload?)` | Trigger a transition |
-| `matches(...states)` | Check if in one of the given states (reactive) |
-| `can(event)` | Check if event would trigger a valid transition |
-| `nextEvents()` | Available events from current state |
-| `reset()` | Return to initial state |
-| `onEnter(state, callback)` | Fire callback when entering a state |
-| `onTransition(callback)` | Fire on any transition |
+| Property                   | Description                                     |
+| -------------------------- | ----------------------------------------------- |
+| `machine()`                | Read current state (reactive)                   |
+| `send(event, payload?)`    | Trigger a transition                            |
+| `matches(...states)`       | Check if in one of the given states (reactive)  |
+| `can(event)`               | Check if event would trigger a valid transition |
+| `nextEvents()`             | Available events from current state             |
+| `reset()`                  | Return to initial state                         |
+| `onEnter(state, callback)` | Fire callback when entering a state             |
+| `onTransition(callback)`   | Fire on any transition                          |
 
 Use signals alongside machines for data. The machine manages transitions, signals manage data.
 

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/machine.ts"],"sourcesContent":["import { signal } from \"@pyreon/reactivity\"\nimport type {\n  EnterCallback,\n  InferEvents,\n  InferStates,\n  Machine,\n  MachineConfig,\n  MachineEvent,\n  TransitionCallback,\n  TransitionConfig,\n} from \"./types\"\n\n/**\n * Create a reactive state machine — a constrained signal with type-safe transitions.\n *\n * The returned instance is callable (reads like a signal) and exposes\n * `send()`, `matches()`, `can()`, and listeners for state changes.\n *\n * @param config - Machine definition with initial state and state configs\n * @returns A reactive machine instance\n *\n * @example\n * ```tsx\n * const machine = createMachine({\n *   initial: 'idle',\n *   states: {\n *     idle: { on: { FETCH: 'loading' } },\n *     loading: { on: { SUCCESS: 'done', ERROR: 'error' } },\n *     done: {},\n *     error: { on: { RETRY: 'loading' } },\n *   },\n * })\n *\n * machine()              // 'idle'\n * machine.send('FETCH')\n * machine()              // 'loading'\n *\n * // Reactive in JSX\n * {() => machine.matches('loading') && <Spinner />}\n * ```\n */\nexport function createMachine<const TConfig extends MachineConfig<string, string>>(\n  config: TConfig,\n): Machine<InferStates<TConfig>, InferEvents<TConfig>> {\n  type TState = InferStates<TConfig>\n  type TEvent = InferEvents<TConfig>\n\n  const { initial, states } = config as unknown as MachineConfig<TState, TEvent>\n\n  // Validate initial state\n  if (!(initial in states)) {\n    throw new Error(`[@pyreon/machine] Initial state '${initial}' is not defined in states`)\n  }\n\n  const current = signal<TState>(initial)\n  const enterListeners = new Map<TState, Set<EnterCallback<TEvent>>>()\n  const transitionListeners = new Set<TransitionCallback<TState, TEvent>>()\n\n  function resolveTransition(event: TEvent, payload?: unknown): TState | null {\n    const stateConfig = states[current.peek()]\n    if (!stateConfig?.on) return null\n\n    const transition = stateConfig.on[event] as TransitionConfig<TState> | undefined\n    if (!transition) return null\n\n    if (typeof transition === \"string\") {\n      return transition\n    }\n\n    // Guarded transition\n    if (transition.guard && !transition.guard(payload)) {\n      return null\n    }\n\n    return transition.target\n  }\n\n  // The machine instance — callable like a signal\n  function machine(): TState {\n    return current()\n  }\n\n  machine.send = (event: TEvent, payload?: unknown): void => {\n    const target = resolveTransition(event, payload)\n    if (target === null) return\n\n    const from = current.peek()\n    const machineEvent: MachineEvent<TEvent> = { type: event, payload }\n\n    current.set(target)\n\n    // Fire transition listeners\n    for (const cb of transitionListeners) {\n      cb(from, target, machineEvent)\n    }\n\n    // Fire enter listeners for the target state\n    const listeners = enterListeners.get(target)\n    if (listeners) {\n      for (const cb of listeners) {\n        cb(machineEvent)\n      }\n    }\n  }\n\n  machine.matches = (...matchStates: TState[]): boolean => {\n    const state = current()\n    return matchStates.includes(state)\n  }\n\n  machine.can = (event: TEvent): boolean => {\n    const stateConfig = states[current()]\n    if (!stateConfig?.on) return false\n\n    const transition = stateConfig.on[event]\n    if (!transition) return false\n\n    // For guarded transitions, we can't know without payload\n    // Return true if the event exists (guard may still reject)\n    return true\n  }\n\n  machine.nextEvents = (): TEvent[] => {\n    const stateConfig = states[current()]\n    if (!stateConfig?.on) return []\n    return Object.keys(stateConfig.on) as TEvent[]\n  }\n\n  machine.reset = (): void => {\n    current.set(initial)\n  }\n\n  machine.onEnter = (state: TState, callback: EnterCallback<TEvent>): (() => void) => {\n    if (!enterListeners.has(state)) {\n      enterListeners.set(state, new Set())\n    }\n    enterListeners.get(state)!.add(callback)\n\n    return () => {\n      enterListeners.get(state)?.delete(callback)\n    }\n  }\n\n  machine.onTransition = (callback: TransitionCallback<TState, TEvent>): (() => void) => {\n    transitionListeners.add(callback)\n    return () => {\n      transitionListeners.delete(callback)\n    }\n  }\n\n  machine.dispose = (): void => {\n    enterListeners.clear()\n    transitionListeners.clear()\n  }\n\n  return machine as Machine<TState, TEvent>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,cACd,QACqD;CAIrD,MAAM,EAAE,SAAS,WAAW;AAG5B,KAAI,EAAE,WAAW,QACf,OAAM,IAAI,MAAM,oCAAoC,QAAQ,4BAA4B;CAG1F,MAAM,UAAU,OAAe,QAAQ;CACvC,MAAM,iCAAiB,IAAI,KAAyC;CACpE,MAAM,sCAAsB,IAAI,KAAyC;CAEzE,SAAS,kBAAkB,OAAe,SAAkC;EAC1E,MAAM,cAAc,OAAO,QAAQ,MAAM;AACzC,MAAI,CAAC,aAAa,GAAI,QAAO;EAE7B,MAAM,aAAa,YAAY,GAAG;AAClC,MAAI,CAAC,WAAY,QAAO;AAExB,MAAI,OAAO,eAAe,SACxB,QAAO;AAIT,MAAI,WAAW,SAAS,CAAC,WAAW,MAAM,QAAQ,CAChD,QAAO;AAGT,SAAO,WAAW;;CAIpB,SAAS,UAAkB;AACzB,SAAO,SAAS;;AAGlB,SAAQ,QAAQ,OAAe,YAA4B;EACzD,MAAM,SAAS,kBAAkB,OAAO,QAAQ;AAChD,MAAI,WAAW,KAAM;EAErB,MAAM,OAAO,QAAQ,MAAM;EAC3B,MAAM,eAAqC;GAAE,MAAM;GAAO;GAAS;AAEnE,UAAQ,IAAI,OAAO;AAGnB,OAAK,MAAM,MAAM,oBACf,IAAG,MAAM,QAAQ,aAAa;EAIhC,MAAM,YAAY,eAAe,IAAI,OAAO;AAC5C,MAAI,UACF,MAAK,MAAM,MAAM,UACf,IAAG,aAAa;;AAKtB,SAAQ,WAAW,GAAG,gBAAmC;EACvD,MAAM,QAAQ,SAAS;AACvB,SAAO,YAAY,SAAS,MAAM;;AAGpC,SAAQ,OAAO,UAA2B;EACxC,MAAM,cAAc,OAAO,SAAS;AACpC,MAAI,CAAC,aAAa,GAAI,QAAO;AAG7B,MAAI,CADe,YAAY,GAAG,OACjB,QAAO;AAIxB,SAAO;;AAGT,SAAQ,mBAA6B;EACnC,MAAM,cAAc,OAAO,SAAS;AACpC,MAAI,CAAC,aAAa,GAAI,QAAO,EAAE;AAC/B,SAAO,OAAO,KAAK,YAAY,GAAG;;AAGpC,SAAQ,cAAoB;AAC1B,UAAQ,IAAI,QAAQ;;AAGtB,SAAQ,WAAW,OAAe,aAAkD;AAClF,MAAI,CAAC,eAAe,IAAI,MAAM,CAC5B,gBAAe,IAAI,uBAAO,IAAI,KAAK,CAAC;AAEtC,iBAAe,IAAI,MAAM,CAAE,IAAI,SAAS;AAExC,eAAa;AACX,kBAAe,IAAI,MAAM,EAAE,OAAO,SAAS;;;AAI/C,SAAQ,gBAAgB,aAA+D;AACrF,sBAAoB,IAAI,SAAS;AACjC,eAAa;AACX,uBAAoB,OAAO,SAAS;;;AAIxC,SAAQ,gBAAsB;AAC5B,iBAAe,OAAO;AACtB,sBAAoB,OAAO;;AAG7B,QAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/machine.ts"],"sourcesContent":["import { signal } from '@pyreon/reactivity'\nimport type {\n  EnterCallback,\n  InferEvents,\n  InferStates,\n  Machine,\n  MachineConfig,\n  MachineEvent,\n  TransitionCallback,\n  TransitionConfig,\n} from './types'\n\n/**\n * Create a reactive state machine — a constrained signal with type-safe transitions.\n *\n * The returned instance is callable (reads like a signal) and exposes\n * `send()`, `matches()`, `can()`, and listeners for state changes.\n *\n * @param config - Machine definition with initial state and state configs\n * @returns A reactive machine instance\n *\n * @example\n * ```tsx\n * const machine = createMachine({\n *   initial: 'idle',\n *   states: {\n *     idle: { on: { FETCH: 'loading' } },\n *     loading: { on: { SUCCESS: 'done', ERROR: 'error' } },\n *     done: {},\n *     error: { on: { RETRY: 'loading' } },\n *   },\n * })\n *\n * machine()              // 'idle'\n * machine.send('FETCH')\n * machine()              // 'loading'\n *\n * // Reactive in JSX\n * {() => machine.matches('loading') && <Spinner />}\n * ```\n */\nexport function createMachine<const TConfig extends MachineConfig<string, string>>(\n  config: TConfig,\n): Machine<InferStates<TConfig>, InferEvents<TConfig>> {\n  type TState = InferStates<TConfig>\n  type TEvent = InferEvents<TConfig>\n\n  const { initial, states } = config as unknown as MachineConfig<TState, TEvent>\n\n  // Validate initial state\n  if (!(initial in states)) {\n    throw new Error(`[@pyreon/machine] Initial state '${initial}' is not defined in states`)\n  }\n\n  const current = signal<TState>(initial)\n  const enterListeners = new Map<TState, Set<EnterCallback<TEvent>>>()\n  const transitionListeners = new Set<TransitionCallback<TState, TEvent>>()\n\n  function resolveTransition(event: TEvent, payload?: unknown): TState | null {\n    const stateConfig = states[current.peek()]\n    if (!stateConfig?.on) return null\n\n    const transition = stateConfig.on[event] as TransitionConfig<TState> | undefined\n    if (!transition) return null\n\n    if (typeof transition === 'string') {\n      return transition\n    }\n\n    // Guarded transition\n    if (transition.guard && !transition.guard(payload)) {\n      return null\n    }\n\n    return transition.target\n  }\n\n  // The machine instance — callable like a signal\n  function machine(): TState {\n    return current()\n  }\n\n  machine.send = (event: TEvent, payload?: unknown): void => {\n    const target = resolveTransition(event, payload)\n    if (target === null) return\n\n    const from = current.peek()\n    const machineEvent: MachineEvent<TEvent> = { type: event, payload }\n\n    current.set(target)\n\n    // Fire transition listeners\n    for (const cb of transitionListeners) {\n      cb(from, target, machineEvent)\n    }\n\n    // Fire enter listeners for the target state\n    const listeners = enterListeners.get(target)\n    if (listeners) {\n      for (const cb of listeners) {\n        cb(machineEvent)\n      }\n    }\n  }\n\n  machine.matches = (...matchStates: TState[]): boolean => {\n    const state = current()\n    return matchStates.includes(state)\n  }\n\n  machine.can = (event: TEvent): boolean => {\n    const stateConfig = states[current()]\n    if (!stateConfig?.on) return false\n\n    const transition = stateConfig.on[event]\n    if (!transition) return false\n\n    // For guarded transitions, we can't know without payload\n    // Return true if the event exists (guard may still reject)\n    return true\n  }\n\n  machine.nextEvents = (): TEvent[] => {\n    const stateConfig = states[current()]\n    if (!stateConfig?.on) return []\n    return Object.keys(stateConfig.on) as TEvent[]\n  }\n\n  machine.reset = (): void => {\n    current.set(initial)\n  }\n\n  machine.onEnter = (state: TState, callback: EnterCallback<TEvent>): (() => void) => {\n    if (!enterListeners.has(state)) {\n      enterListeners.set(state, new Set())\n    }\n    enterListeners.get(state)!.add(callback)\n\n    return () => {\n      enterListeners.get(state)?.delete(callback)\n    }\n  }\n\n  machine.onTransition = (callback: TransitionCallback<TState, TEvent>): (() => void) => {\n    transitionListeners.add(callback)\n    return () => {\n      transitionListeners.delete(callback)\n    }\n  }\n\n  machine.dispose = (): void => {\n    enterListeners.clear()\n    transitionListeners.clear()\n  }\n\n  return machine as Machine<TState, TEvent>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,cACd,QACqD;CAIrD,MAAM,EAAE,SAAS,WAAW;AAG5B,KAAI,EAAE,WAAW,QACf,OAAM,IAAI,MAAM,oCAAoC,QAAQ,4BAA4B;CAG1F,MAAM,UAAU,OAAe,QAAQ;CACvC,MAAM,iCAAiB,IAAI,KAAyC;CACpE,MAAM,sCAAsB,IAAI,KAAyC;CAEzE,SAAS,kBAAkB,OAAe,SAAkC;EAC1E,MAAM,cAAc,OAAO,QAAQ,MAAM;AACzC,MAAI,CAAC,aAAa,GAAI,QAAO;EAE7B,MAAM,aAAa,YAAY,GAAG;AAClC,MAAI,CAAC,WAAY,QAAO;AAExB,MAAI,OAAO,eAAe,SACxB,QAAO;AAIT,MAAI,WAAW,SAAS,CAAC,WAAW,MAAM,QAAQ,CAChD,QAAO;AAGT,SAAO,WAAW;;CAIpB,SAAS,UAAkB;AACzB,SAAO,SAAS;;AAGlB,SAAQ,QAAQ,OAAe,YAA4B;EACzD,MAAM,SAAS,kBAAkB,OAAO,QAAQ;AAChD,MAAI,WAAW,KAAM;EAErB,MAAM,OAAO,QAAQ,MAAM;EAC3B,MAAM,eAAqC;GAAE,MAAM;GAAO;GAAS;AAEnE,UAAQ,IAAI,OAAO;AAGnB,OAAK,MAAM,MAAM,oBACf,IAAG,MAAM,QAAQ,aAAa;EAIhC,MAAM,YAAY,eAAe,IAAI,OAAO;AAC5C,MAAI,UACF,MAAK,MAAM,MAAM,UACf,IAAG,aAAa;;AAKtB,SAAQ,WAAW,GAAG,gBAAmC;EACvD,MAAM,QAAQ,SAAS;AACvB,SAAO,YAAY,SAAS,MAAM;;AAGpC,SAAQ,OAAO,UAA2B;EACxC,MAAM,cAAc,OAAO,SAAS;AACpC,MAAI,CAAC,aAAa,GAAI,QAAO;AAG7B,MAAI,CADe,YAAY,GAAG,OACjB,QAAO;AAIxB,SAAO;;AAGT,SAAQ,mBAA6B;EACnC,MAAM,cAAc,OAAO,SAAS;AACpC,MAAI,CAAC,aAAa,GAAI,QAAO,EAAE;AAC/B,SAAO,OAAO,KAAK,YAAY,GAAG;;AAGpC,SAAQ,cAAoB;AAC1B,UAAQ,IAAI,QAAQ;;AAGtB,SAAQ,WAAW,OAAe,aAAkD;AAClF,MAAI,CAAC,eAAe,IAAI,MAAM,CAC5B,gBAAe,IAAI,uBAAO,IAAI,KAAK,CAAC;AAEtC,iBAAe,IAAI,MAAM,CAAE,IAAI,SAAS;AAExC,eAAa;AACX,kBAAe,IAAI,MAAM,EAAE,OAAO,SAAS;;;AAI/C,SAAQ,gBAAgB,aAA+D;AACrF,sBAAoB,IAAI,SAAS;AACjC,eAAa;AACX,uBAAoB,OAAO,SAAS;;;AAIxC,SAAQ,gBAAsB;AAC5B,iBAAe,OAAO;AACtB,sBAAoB,OAAO;;AAG7B,QAAO"}

package/package.json

@@ -1,20 +1,17 @@
 {
   "name": "@pyreon/machine",
-  "version": "0.11.5",
+  "version": "0.11.6",
   "description": "Reactive state machines for Pyreon — constrained signals with type-safe transitions",
+  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/machine#readme",
+  "bugs": {
+    "url": "https://github.com/pyreon/pyreon/issues"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/pyreon/pyreon.git",
     "directory": "packages/fundamentals/machine"
   },
-  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/machine#readme",
-  "bugs": {
-    "url": "https://github.com/pyreon/pyreon/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "files": [
     "lib",
     "src",
@@ -22,6 +19,7 @@
     "LICENSE"
   ],
   "type": "module",
+  "sideEffects": false,
   "main": "./lib/index.js",
   "module": "./lib/index.js",
   "types": "./lib/types/index.d.ts",
@@ -32,20 +30,22 @@
       "types": "./lib/types/index.d.ts"
     }
   },
-  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "vl_rolldown_build",
     "dev": "vl_rolldown_build-watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "lint": "biome check ."
-  },
-  "peerDependencies": {
-    "@pyreon/reactivity": "^0.11.5"
+    "lint": "oxlint ."
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.3",
-    "@pyreon/reactivity": "^0.11.5",
+    "@pyreon/reactivity": "^0.11.6",
     "@vitus-labs/tools-lint": "^1.11.0"
+  },
+  "peerDependencies": {
+    "@pyreon/reactivity": "^0.11.6"
   }
 }

package/src/index.ts

@@ -25,7 +25,7 @@
  * ```
  */
 
-export { createMachine } from "./machine"
+export { createMachine } from './machine'
 
 // Types
 export type {
@@ -38,4 +38,4 @@ export type {
   StateConfig,
   TransitionCallback,
   TransitionConfig,
-} from "./types"
+} from './types'

package/src/machine.ts

@@ -1,4 +1,4 @@
-import { signal } from "@pyreon/reactivity"
+import { signal } from '@pyreon/reactivity'
 import type {
   EnterCallback,
   InferEvents,
@@ -8,7 +8,7 @@ import type {
   MachineEvent,
   TransitionCallback,
   TransitionConfig,
-} from "./types"
+} from './types'
 
 /**
  * Create a reactive state machine — a constrained signal with type-safe transitions.
@@ -63,7 +63,7 @@ export function createMachine<const TConfig extends MachineConfig<string, string
     const transition = stateConfig.on[event] as TransitionConfig<TState> | undefined
     if (!transition) return null
 
-    if (typeof transition === "string") {
+    if (typeof transition === 'string') {
       return transition
     }