statecharts.sh 0.0.1

package/dist/index.d.mts

@@ -0,0 +1,133 @@
+//#region src/types.d.ts
+type StringKeys<T> = Extract<keyof T, string>;
+type AtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & { [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>> }[Keys];
+type AnyContext = Record<string, unknown>;
+interface BaseEvent {
+  type: string;
+}
+type EventPayload<E extends BaseEvent, T extends E["type"]> = Extract<E, {
+  type: T;
+}>;
+type Action<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> = (context: TContext, event: TEvent) => Partial<TContext> | void;
+type Actions<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> = Action<TContext, TEvent> | Action<TContext, TEvent>[];
+type Guard<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> = (context: TContext, event: TEvent) => boolean;
+interface TransitionObject<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> {
+  target?: string;
+  guard?: Guard<TContext, TEvent>;
+  action?: Action<TContext, TEvent>;
+}
+type TransitionConfig<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> = string | TransitionObject<TContext, TEvent> | TransitionObject<TContext, TEvent>[];
+interface Subscription {
+  unsubscribe: () => void;
+}
+interface SubscriptionSource<T> {
+  subscribe: (observer: {
+    next: (value: T) => void;
+    error?: (err: unknown) => void;
+  }) => Subscription;
+}
+type InvokeFn<TContext extends AnyContext> = (context: TContext) => Promise<unknown> | SubscriptionSource<unknown>;
+interface InvokeHandlers<TContext extends AnyContext> {
+  onDone?: TransitionConfig<TContext, BaseEvent & {
+    data: unknown;
+  }>;
+  onError?: TransitionConfig<TContext, BaseEvent & {
+    error: unknown;
+  }>;
+}
+interface StateNode<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> {
+  entry?: Actions<TContext, TEvent>;
+  exit?: Actions<TContext, TEvent>;
+  on?: Record<string, TransitionConfig<TContext, TEvent>>;
+  after?: Record<number, TransitionConfig<TContext, TEvent>>;
+  invoke?: InvokeFn<TContext>;
+  onDone?: TransitionConfig<TContext, BaseEvent & {
+    data: unknown;
+  }>;
+  onError?: TransitionConfig<TContext, BaseEvent & {
+    error: unknown;
+  }>;
+  initial?: string;
+  states?: Record<string, StateNode<TContext, TEvent>>;
+  parallel?: Record<string, {
+    initial: string;
+    states: Record<string, StateNode<TContext, TEvent>>;
+  }>;
+  final?: boolean;
+}
+interface ChartDefinition<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> {
+  id?: string;
+  context: TContext;
+  initial: string;
+  states: Record<string, StateNode<TContext, TEvent>>;
+  events?: TEvent;
+}
+type StateValue = string | {
+  [key: string]: StateValue;
+};
+interface IStateSnapshot<TContext extends AnyContext> {
+  readonly value: StateValue;
+  readonly context: Readonly<TContext>;
+  readonly done: boolean;
+  readonly path: readonly string[];
+  readonly timestamp: number;
+  matches(stateValue: string): boolean;
+}
+interface ChartInstance<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> {
+  readonly state: IStateSnapshot<TContext>;
+  send(event: TEvent | TEvent["type"]): void;
+  subscribe(listener: (state: IStateSnapshot<TContext>) => void): () => void;
+  onTransition(listener: (event: TEvent) => void): () => void;
+  stop(): void;
+}
+interface Chart<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent> {
+  readonly definition: ChartDefinition<TContext, TEvent>;
+  start(initialContext?: Partial<TContext>): ChartInstance<TContext, TEvent>;
+  export(): ExportedChart;
+}
+interface ExportedTransition {
+  target?: string;
+  guard: string | null;
+  actions: string[];
+}
+interface ExportedStateNode {
+  entry: string[];
+  exit: string[];
+  on: Record<string, ExportedTransition | ExportedTransition[]>;
+  after?: Record<number, ExportedTransition | ExportedTransition[]>;
+  invoke?: string | null;
+  onDone?: ExportedTransition | ExportedTransition[];
+  onError?: ExportedTransition | ExportedTransition[];
+  initial?: string;
+  states?: Record<string, ExportedStateNode>;
+  parallel?: Record<string, {
+    initial: string;
+    states: Record<string, ExportedStateNode>;
+  }>;
+  final?: boolean;
+}
+interface ExportedChart {
+  version: 1;
+  id: string;
+  initial: string;
+  context: unknown;
+  states: Record<string, ExportedStateNode>;
+}
+//#endregion
+//#region src/chart.d.ts
+declare function chart<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent>(definition: ChartDefinition<TContext, TEvent>): Chart<TContext, TEvent>;
+//#endregion
+//#region src/snapshot.d.ts
+declare class StateSnapshot<TContext extends AnyContext> implements IStateSnapshot<TContext> {
+  readonly value: StateValue;
+  readonly context: Readonly<TContext>;
+  readonly done: boolean;
+  readonly path: readonly string[];
+  readonly timestamp: number;
+  constructor(value: StateValue, context: TContext, done: boolean, path: readonly string[], timestamp?: number);
+  matches(stateValue: string): boolean;
+  private matchesPath;
+}
+//#endregion
+export { type Action, type Actions, type AnyContext, type AtLeastOne, type BaseEvent, type Chart, type ChartDefinition, type ChartInstance, type EventPayload, type ExportedChart, type ExportedStateNode, type ExportedTransition, type Guard, type IStateSnapshot, type InvokeFn, type InvokeHandlers, type StateNode, StateSnapshot, type StateValue, type StringKeys, type Subscription, type SubscriptionSource, type TransitionConfig, type TransitionObject, chart };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/chart.ts","../src/snapshot.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,390 @@
+//#region src/snapshot.ts
+var StateSnapshot = class {
+	value;
+	context;
+	done;
+	path;
+	timestamp;
+	constructor(value, context, done, path, timestamp) {
+		this.value = value;
+		this.context = Object.freeze({ ...context });
+		this.done = done;
+		this.path = Object.freeze([...path]);
+		this.timestamp = timestamp ?? Date.now();
+	}
+	matches(stateValue) {
+		const parts = stateValue.split(".");
+		if (typeof this.value === "string") return parts.length === 1 && this.value === parts[0];
+		return this.matchesPath(parts, 0);
+	}
+	matchesPath(parts, index) {
+		if (index >= parts.length) return true;
+		const part = parts[index];
+		if (part === void 0) return true;
+		return this.path.includes(part) && this.matchesPath(parts, index + 1);
+	}
+};
+
+//#endregion
+//#region src/transition.ts
+function resolveTransition(config, context, event) {
+	if (typeof config === "string") return {
+		target: config,
+		actions: []
+	};
+	if (Array.isArray(config)) {
+		for (const item of config) {
+			const result = resolveTransitionObject(item, context, event);
+			if (result !== null) return result;
+		}
+		return null;
+	}
+	return resolveTransitionObject(config, context, event);
+}
+function resolveTransitionObject(config, context, event) {
+	if (config.guard && !config.guard(context, event)) return null;
+	return {
+		target: config.target,
+		actions: config.action ? [config.action] : []
+	};
+}
+
+//#endregion
+//#region src/invoke.ts
+function isSubscriptionSource(value) {
+	return typeof value === "object" && value !== null && "subscribe" in value && typeof value.subscribe === "function";
+}
+function startInvoke(invokeFn, context, onDone, onError) {
+	let cancelled = false;
+	let subscription = null;
+	try {
+		const result = invokeFn(context);
+		if (isSubscriptionSource(result)) subscription = result.subscribe({
+			next: (value) => {
+				if (!cancelled) onDone(value);
+			},
+			error: (err) => {
+				if (!cancelled) onError(err);
+			}
+		});
+		else result.then((data) => {
+			if (!cancelled) onDone(data);
+		}).catch((error) => {
+			if (!cancelled) onError(error);
+		});
+	} catch (error) {
+		if (!cancelled) onError(error);
+	}
+	return { cancel() {
+		cancelled = true;
+		if (subscription) subscription.unsubscribe();
+	} };
+}
+
+//#endregion
+//#region src/instance.ts
+function createInstance(definition, initialContextOverride) {
+	let context = initialContextOverride ? {
+		...definition.context,
+		...initialContextOverride
+	} : { ...definition.context };
+	let stopped = false;
+	const subscribers = /* @__PURE__ */ new Set();
+	const transitionListeners = /* @__PURE__ */ new Set();
+	const activeStates = [];
+	const initialPath = buildInitialPath(definition.states, definition.initial);
+	let currentSnapshot = createSnapshot(initialPath);
+	enterStates(initialPath);
+	function createSnapshot(path) {
+		const value = pathToValue(path);
+		const done = isPathFinal(path);
+		return new StateSnapshot(value, context, done, path);
+	}
+	function pathToValue(path) {
+		if (path.length === 0) return "";
+		if (path.length === 1) return path[0];
+		let result = path[path.length - 1];
+		for (let i = path.length - 2; i >= 0; i--) result = { [path[i]]: result };
+		return result;
+	}
+	function buildInitialPath(states, initial) {
+		const path = [initial];
+		let current = states[initial];
+		while (current) if (current.initial && current.states) {
+			path.push(current.initial);
+			current = current.states[current.initial];
+		} else if (current.parallel) break;
+		else break;
+		return path;
+	}
+	function getStateNodeAtPath(path) {
+		if (path.length === 0) return void 0;
+		let current = definition.states[path[0]];
+		for (let i = 1; i < path.length && current; i++) current = current.states?.[path[i]];
+		return current;
+	}
+	function isPathFinal(path) {
+		return getStateNodeAtPath(path)?.final === true;
+	}
+	function executeActions(actions, event) {
+		if (!actions) return;
+		const actionList = Array.isArray(actions) ? actions : [actions];
+		for (const action of actionList) {
+			const result = action(context, event);
+			if (result) context = {
+				...context,
+				...result
+			};
+		}
+	}
+	function enterStates(path) {
+		const activeState = {
+			path: [...path],
+			timers: [],
+			invokes: []
+		};
+		activeStates.push(activeState);
+		for (let i = 0; i < path.length; i++) {
+			const currentPath = path.slice(0, i + 1);
+			const node = getStateNodeAtPath(currentPath);
+			if (!node) continue;
+			executeActions(node.entry, { type: "__entry__" });
+			if (node.after) for (const [delayStr, transitionConfig] of Object.entries(node.after)) {
+				const delay = Number(delayStr);
+				const timer = setTimeout(() => {
+					if (stopped) return;
+					handleDelayedTransition(currentPath, transitionConfig);
+				}, delay);
+				activeState.timers.push(timer);
+			}
+			if (node.invoke) {
+				const controller = startInvoke(node.invoke, context, (data) => {
+					if (stopped) return;
+					if (node.onDone) {
+						const doneEvent = {
+							type: "__invoke_done__",
+							data
+						};
+						handleInvokeResult(currentPath, node.onDone, doneEvent);
+					}
+				}, (error) => {
+					if (stopped) return;
+					if (node.onError) {
+						const errorEvent = {
+							type: "__invoke_error__",
+							error
+						};
+						handleInvokeResult(currentPath, node.onError, errorEvent);
+					}
+				});
+				activeState.invokes.push(controller);
+			}
+		}
+	}
+	function exitStates(path) {
+		const activeIndex = activeStates.findIndex((a) => a.path.join(".") === path.join("."));
+		if (activeIndex === -1) return;
+		const activeState = activeStates[activeIndex];
+		for (const timer of activeState.timers) clearTimeout(timer);
+		for (const invoke of activeState.invokes) invoke.cancel();
+		for (let i = path.length - 1; i >= 0; i--) {
+			const node = getStateNodeAtPath(path.slice(0, i + 1));
+			if (node?.exit) executeActions(node.exit, { type: "__exit__" });
+		}
+		activeStates.splice(activeIndex, 1);
+	}
+	function handleDelayedTransition(fromPath, config) {
+		const syntheticEvent = { type: "__after__" };
+		const resolved = resolveTransition(config, context, syntheticEvent);
+		if (resolved) performTransition(fromPath, resolved.target, resolved.actions, syntheticEvent);
+	}
+	function handleInvokeResult(fromPath, config, event) {
+		const resolved = resolveTransition(config, context, event);
+		if (resolved) performTransition(fromPath, resolved.target, resolved.actions, event);
+	}
+	function performTransition(fromPath, target, actions, event) {
+		if (stopped) return;
+		const targetPath = resolveTargetPath(fromPath, target);
+		findCommonAncestorLength(fromPath, targetPath);
+		const exitPath = fromPath;
+		const enterPath = targetPath;
+		exitStates(exitPath);
+		for (const action of actions) {
+			const result = action(context, event);
+			if (result) context = {
+				...context,
+				...result
+			};
+		}
+		enterStates(enterPath);
+		currentSnapshot = createSnapshot(enterPath);
+		notifySubscribers();
+	}
+	function resolveTargetPath(fromPath, target) {
+		if (!target) return [...fromPath];
+		if (target.startsWith("#")) {
+			const parts = target.slice(1).split(".");
+			if (parts[0] === definition.id) return parts.slice(1);
+			return parts;
+		}
+		return buildFullPath([...fromPath.slice(0, -1), target]);
+	}
+	function buildFullPath(basePath) {
+		const path = [...basePath];
+		let node = getStateNodeAtPath(path);
+		while (node) if (node.initial && node.states) {
+			path.push(node.initial);
+			node = node.states[node.initial];
+		} else break;
+		return path;
+	}
+	function findCommonAncestorLength(path1, path2) {
+		let i = 0;
+		while (i < path1.length && i < path2.length && path1[i] === path2[i]) i++;
+		return i;
+	}
+	function findTransitionHandler(path, eventType) {
+		for (let i = path.length; i > 0; i--) {
+			const currentPath = path.slice(0, i);
+			const node = getStateNodeAtPath(currentPath);
+			if (node?.on?.[eventType]) return {
+				path: currentPath,
+				config: node.on[eventType]
+			};
+		}
+		return null;
+	}
+	function notifySubscribers() {
+		for (const subscriber of subscribers) subscriber(currentSnapshot);
+	}
+	function send(event) {
+		if (stopped) return;
+		const normalizedEvent = typeof event === "string" ? { type: event } : event;
+		for (const listener of transitionListeners) listener(normalizedEvent);
+		const handler = findTransitionHandler(currentSnapshot.path, normalizedEvent.type);
+		if (!handler) return;
+		const resolved = resolveTransition(handler.config, context, normalizedEvent);
+		if (!resolved) return;
+		performTransition(handler.path, resolved.target, resolved.actions, normalizedEvent);
+	}
+	function subscribe(listener) {
+		subscribers.add(listener);
+		return () => {
+			subscribers.delete(listener);
+		};
+	}
+	function onTransition(listener) {
+		transitionListeners.add(listener);
+		return () => {
+			transitionListeners.delete(listener);
+		};
+	}
+	function stop() {
+		stopped = true;
+		for (const activeState of [...activeStates]) {
+			for (const timer of activeState.timers) clearTimeout(timer);
+			for (const invoke of activeState.invokes) invoke.cancel();
+		}
+		activeStates.length = 0;
+		notifySubscribers();
+	}
+	return {
+		get state() {
+			return currentSnapshot;
+		},
+		send,
+		subscribe,
+		onTransition,
+		stop
+	};
+}
+
+//#endregion
+//#region src/export.ts
+function getFunctionName(fn) {
+	return fn.name || "anonymous";
+}
+function exportActions(actions) {
+	if (!actions) return [];
+	return (Array.isArray(actions) ? actions : [actions]).map(getFunctionName);
+}
+function exportTransition(config) {
+	if (typeof config === "string") return {
+		target: config,
+		guard: null,
+		actions: []
+	};
+	if (Array.isArray(config)) return config.map((item) => ({
+		target: item.target,
+		guard: item.guard ? getFunctionName(item.guard) : null,
+		actions: item.action ? [getFunctionName(item.action)] : []
+	}));
+	return {
+		target: config.target,
+		guard: config.guard ? getFunctionName(config.guard) : null,
+		actions: config.action ? [getFunctionName(config.action)] : []
+	};
+}
+function exportStateNode(node) {
+	const exported = {
+		entry: exportActions(node.entry),
+		exit: exportActions(node.exit),
+		on: {}
+	};
+	if (node.on) for (const [eventType, transition] of Object.entries(node.on)) exported.on[eventType] = exportTransition(transition);
+	if (node.after) {
+		exported.after = {};
+		for (const [delay, transition] of Object.entries(node.after)) exported.after[Number(delay)] = exportTransition(transition);
+	}
+	if (node.invoke) exported.invoke = getFunctionName(node.invoke);
+	if (node.onDone) exported.onDone = exportTransition(node.onDone);
+	if (node.onError) exported.onError = exportTransition(node.onError);
+	if (node.initial) exported.initial = node.initial;
+	if (node.states) {
+		exported.states = {};
+		for (const [name, childNode] of Object.entries(node.states)) exported.states[name] = exportStateNode(childNode);
+	}
+	if (node.parallel) {
+		exported.parallel = {};
+		for (const [regionName, region] of Object.entries(node.parallel)) {
+			exported.parallel[regionName] = {
+				initial: region.initial,
+				states: {}
+			};
+			for (const [stateName, stateNode] of Object.entries(region.states)) exported.parallel[regionName].states[stateName] = exportStateNode(stateNode);
+		}
+	}
+	if (node.final) exported.final = true;
+	return exported;
+}
+function exportChart(definition) {
+	const states = {};
+	for (const [name, node] of Object.entries(definition.states)) states[name] = exportStateNode(node);
+	return {
+		version: 1,
+		id: definition.id ?? "chart",
+		initial: definition.initial,
+		context: definition.context,
+		states
+	};
+}
+
+//#endregion
+//#region src/chart.ts
+function chart(definition) {
+	return {
+		get definition() {
+			return definition;
+		},
+		start(initialContext) {
+			return createInstance(definition, initialContext);
+		},
+		export() {
+			return exportChart(definition);
+		}
+	};
+}
+
+//#endregion
+export { StateSnapshot, chart };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/snapshot.ts","../src/transition.ts","../src/invoke.ts","../src/instance.ts","../src/export.ts","../src/chart.ts"],"sourcesContent":["import type { AnyContext, IStateSnapshot, StateValue } from './types.js';\n\nexport class StateSnapshot<TContext extends AnyContext> implements IStateSnapshot<TContext> {\n  readonly value: StateValue;\n  readonly context: Readonly<TContext>;\n  readonly done: boolean;\n  readonly path: readonly string[];\n  readonly timestamp: number;\n\n  constructor(\n    value: StateValue,\n    context: TContext,\n    done: boolean,\n    path: readonly string[],\n    timestamp?: number\n  ) {\n    this.value = value;\n    this.context = Object.freeze({ ...context }) as Readonly<TContext>;\n    this.done = done;\n    this.path = Object.freeze([...path]) as readonly string[];\n    this.timestamp = timestamp ?? Date.now();\n  }\n\n  matches(stateValue: string): boolean {\n    const parts = stateValue.split('.');\n\n    // For flat states\n    if (typeof this.value === 'string') {\n      return parts.length === 1 && this.value === parts[0];\n    }\n\n    // For nested/parallel states - check if path includes all parts\n    return this.matchesPath(parts, 0);\n  }\n\n  private matchesPath(parts: string[], index: number): boolean {\n    if (index >= parts.length) return true;\n\n    const part = parts[index];\n    if (part === undefined) return true;\n\n    // Check if this part exists in our path\n    return this.path.includes(part) && this.matchesPath(parts, index + 1);\n  }\n}\n","import type {\n  AnyContext,\n  BaseEvent,\n  TransitionConfig,\n  TransitionObject,\n} from './types.js';\n\nexport interface ResolvedTransition<TContext extends AnyContext, TEvent extends BaseEvent> {\n  target: string | undefined;\n  actions: ((context: TContext, event: TEvent) => Partial<TContext> | void)[];\n}\n\nexport function resolveTransition<TContext extends AnyContext, TEvent extends BaseEvent>(\n  config: TransitionConfig<TContext, TEvent>,\n  context: TContext,\n  event: TEvent\n): ResolvedTransition<TContext, TEvent> | null {\n  // String shorthand\n  if (typeof config === 'string') {\n    return { target: config, actions: [] };\n  }\n\n  // Array - first match wins\n  if (Array.isArray(config)) {\n    for (const item of config) {\n      const result = resolveTransitionObject(item, context, event);\n      if (result !== null) {\n        return result;\n      }\n    }\n    return null;\n  }\n\n  // Object form\n  return resolveTransitionObject(config, context, event);\n}\n\nfunction resolveTransitionObject<TContext extends AnyContext, TEvent extends BaseEvent>(\n  config: TransitionObject<TContext, TEvent>,\n  context: TContext,\n  event: TEvent\n): ResolvedTransition<TContext, TEvent> | null {\n  // Check guard\n  if (config.guard && !config.guard(context, event)) {\n    return null;\n  }\n\n  return {\n    target: config.target,\n    actions: config.action ? [config.action] : [],\n  };\n}\n","import type { AnyContext, InvokeFn, Subscription, SubscriptionSource } from './types.js';\n\nexport interface InvokeController {\n  cancel(): void;\n}\n\nfunction isSubscriptionSource(value: unknown): value is SubscriptionSource<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'subscribe' in value &&\n    typeof (value as SubscriptionSource<unknown>).subscribe === 'function'\n  );\n}\n\nexport function startInvoke<TContext extends AnyContext>(\n  invokeFn: InvokeFn<TContext>,\n  context: TContext,\n  onDone: (data: unknown) => void,\n  onError: (error: unknown) => void\n): InvokeController {\n  let cancelled = false;\n  let subscription: Subscription | null = null;\n\n  try {\n    const result = invokeFn(context);\n\n    if (isSubscriptionSource(result)) {\n      // Subscription-based invoke\n      subscription = result.subscribe({\n        next: (value) => {\n          if (!cancelled) {\n            onDone(value);\n          }\n        },\n        error: (err) => {\n          if (!cancelled) {\n            onError(err);\n          }\n        },\n      });\n    } else {\n      // Promise-based invoke\n      result\n        .then((data) => {\n          if (!cancelled) {\n            onDone(data);\n          }\n        })\n        .catch((error: unknown) => {\n          if (!cancelled) {\n            onError(error);\n          }\n        });\n    }\n  } catch (error) {\n    if (!cancelled) {\n      onError(error);\n    }\n  }\n\n  return {\n    cancel() {\n      cancelled = true;\n      if (subscription) {\n        subscription.unsubscribe();\n      }\n    },\n  };\n}\n","import type {\n  Actions,\n  AnyContext,\n  BaseEvent,\n  ChartDefinition,\n  ChartInstance,\n  IStateSnapshot,\n  StateNode,\n  StateValue,\n  TransitionConfig,\n} from './types.js';\nimport { StateSnapshot } from './snapshot.js';\nimport { resolveTransition } from './transition.js';\nimport { startInvoke, type InvokeController } from './invoke.js';\n\ninterface ActiveState {\n  path: string[];\n  timers: ReturnType<typeof setTimeout>[];\n  invokes: InvokeController[];\n}\n\nexport function createInstance<TContext extends AnyContext, TEvent extends BaseEvent>(\n  definition: ChartDefinition<TContext, TEvent>,\n  initialContextOverride?: Partial<TContext>\n): ChartInstance<TContext, TEvent> {\n  let context: TContext = initialContextOverride\n    ? { ...definition.context, ...initialContextOverride }\n    : { ...definition.context };\n\n  let stopped = false;\n  const subscribers: Set<(state: IStateSnapshot<TContext>) => void> = new Set();\n  const transitionListeners: Set<(event: TEvent) => void> = new Set();\n  const activeStates: ActiveState[] = [];\n\n  // Build initial state\n  const initialPath = buildInitialPath(definition.states, definition.initial);\n  let currentSnapshot = createSnapshot(initialPath);\n\n  // Enter initial states\n  enterStates(initialPath);\n\n  function createSnapshot(path: string[]): StateSnapshot<TContext> {\n    const value = pathToValue(path);\n    const done = isPathFinal(path);\n    return new StateSnapshot(value, context, done, path);\n  }\n\n  function pathToValue(path: string[]): StateValue {\n    if (path.length === 0) return '';\n    if (path.length === 1) return path[0]!;\n\n    // Build nested object\n    let result: StateValue = path[path.length - 1]!;\n    for (let i = path.length - 2; i >= 0; i--) {\n      result = { [path[i]!]: result };\n    }\n    return result;\n  }\n\n  function buildInitialPath(\n    states: Record<string, StateNode<TContext, TEvent>>,\n    initial: string\n  ): string[] {\n    const path: string[] = [initial];\n    let current = states[initial];\n\n    while (current) {\n      if (current.initial && current.states) {\n        path.push(current.initial);\n        current = current.states[current.initial];\n      } else if (current.parallel) {\n        // For parallel states, we handle differently\n        break;\n      } else {\n        break;\n      }\n    }\n\n    return path;\n  }\n\n  function getStateNodeAtPath(path: string[]): StateNode<TContext, TEvent> | undefined {\n    if (path.length === 0) return undefined;\n\n    let current: StateNode<TContext, TEvent> | undefined = definition.states[path[0]!];\n    for (let i = 1; i < path.length && current; i++) {\n      current = current.states?.[path[i]!];\n    }\n    return current;\n  }\n\n  function isPathFinal(path: string[]): boolean {\n    const node = getStateNodeAtPath(path);\n    return node?.final === true;\n  }\n\n  function executeActions(\n    actions: Actions<TContext, TEvent> | undefined,\n    event: TEvent\n  ): void {\n    if (!actions) return;\n\n    const actionList = Array.isArray(actions) ? actions : [actions];\n    for (const action of actionList) {\n      const result = action(context, event);\n      if (result) {\n        context = { ...context, ...result };\n      }\n    }\n  }\n\n  function enterStates(path: string[]): void {\n    const activeState: ActiveState = {\n      path: [...path],\n      timers: [],\n      invokes: [],\n    };\n    activeStates.push(activeState);\n\n    // Enter each state in path\n    for (let i = 0; i < path.length; i++) {\n      const currentPath = path.slice(0, i + 1);\n      const node = getStateNodeAtPath(currentPath);\n      if (!node) continue;\n\n      // Execute entry actions\n      executeActions(node.entry, { type: '__entry__' } as TEvent);\n\n      // Setup delayed transitions\n      if (node.after) {\n        for (const [delayStr, transitionConfig] of Object.entries(node.after)) {\n          const delay = Number(delayStr);\n          const timer = setTimeout(() => {\n            if (stopped) return;\n            handleDelayedTransition(currentPath, transitionConfig as TransitionConfig<TContext, TEvent>);\n          }, delay);\n          activeState.timers.push(timer);\n        }\n      }\n\n      // Start invocations\n      if (node.invoke) {\n        const controller = startInvoke(\n          node.invoke,\n          context,\n          (data) => {\n            if (stopped) return;\n            if (node.onDone) {\n              const doneEvent = { type: '__invoke_done__', data } as TEvent & { data: unknown };\n              handleInvokeResult(currentPath, node.onDone as TransitionConfig<TContext, TEvent>, doneEvent);\n            }\n          },\n          (error) => {\n            if (stopped) return;\n            if (node.onError) {\n              const errorEvent = { type: '__invoke_error__', error } as TEvent & { error: unknown };\n              handleInvokeResult(currentPath, node.onError as TransitionConfig<TContext, TEvent>, errorEvent);\n            }\n          }\n        );\n        activeState.invokes.push(controller);\n      }\n    }\n  }\n\n  function exitStates(path: string[]): void {\n    const activeIndex = activeStates.findIndex(\n      (a) => a.path.join('.') === path.join('.')\n    );\n    if (activeIndex === -1) return;\n\n    const activeState = activeStates[activeIndex]!;\n\n    // Clear timers\n    for (const timer of activeState.timers) {\n      clearTimeout(timer);\n    }\n\n    // Cancel invokes\n    for (const invoke of activeState.invokes) {\n      invoke.cancel();\n    }\n\n    // Execute exit actions (in reverse order)\n    for (let i = path.length - 1; i >= 0; i--) {\n      const currentPath = path.slice(0, i + 1);\n      const node = getStateNodeAtPath(currentPath);\n      if (node?.exit) {\n        executeActions(node.exit, { type: '__exit__' } as TEvent);\n      }\n    }\n\n    activeStates.splice(activeIndex, 1);\n  }\n\n  function handleDelayedTransition(\n    fromPath: string[],\n    config: TransitionConfig<TContext, TEvent>\n  ): void {\n    const syntheticEvent = { type: '__after__' } as TEvent;\n    const resolved = resolveTransition(config, context, syntheticEvent);\n\n    if (resolved) {\n      performTransition(fromPath, resolved.target, resolved.actions, syntheticEvent);\n    }\n  }\n\n  function handleInvokeResult(\n    fromPath: string[],\n    config: TransitionConfig<TContext, TEvent>,\n    event: TEvent\n  ): void {\n    const resolved = resolveTransition(config, context, event);\n\n    if (resolved) {\n      performTransition(fromPath, resolved.target, resolved.actions, event);\n    }\n  }\n\n  function performTransition(\n    fromPath: string[],\n    target: string | undefined,\n    actions: ((ctx: TContext, ev: TEvent) => Partial<TContext> | void)[],\n    event: TEvent\n  ): void {\n    if (stopped) return;\n\n    // Calculate the paths to exit and enter\n    const targetPath = resolveTargetPath(fromPath, target);\n\n    // Find common ancestor\n    const commonLength = findCommonAncestorLength(fromPath, targetPath);\n    const exitPath = fromPath;\n    const enterPath = targetPath;\n\n    // Exit current states (from leaf to common ancestor)\n    exitStates(exitPath);\n\n    // Execute transition actions\n    for (const action of actions) {\n      const result = action(context, event);\n      if (result) {\n        context = { ...context, ...result };\n      }\n    }\n\n    // Enter new states\n    enterStates(enterPath);\n\n    // Update snapshot and notify\n    currentSnapshot = createSnapshot(enterPath);\n    notifySubscribers();\n  }\n\n  function resolveTargetPath(fromPath: string[], target: string | undefined): string[] {\n    if (!target) {\n      // Self-transition - re-enter current state\n      return [...fromPath];\n    }\n\n    // Handle absolute reference (#id.state)\n    if (target.startsWith('#')) {\n      const parts = target.slice(1).split('.');\n      // First part should be chart id, rest is path\n      if (parts[0] === definition.id) {\n        return parts.slice(1);\n      }\n      // Just use the path after #\n      return parts;\n    }\n\n    // Handle relative target - find sibling state\n    // The target should be a sibling of the deepest state that has that transition\n    const parentPath = fromPath.slice(0, -1);\n    const targetPath = [...parentPath, target];\n\n    // Build full path including nested initial states\n    return buildFullPath(targetPath);\n  }\n\n  function buildFullPath(basePath: string[]): string[] {\n    const path = [...basePath];\n    let node = getStateNodeAtPath(path);\n\n    while (node) {\n      if (node.initial && node.states) {\n        path.push(node.initial);\n        node = node.states[node.initial];\n      } else {\n        break;\n      }\n    }\n\n    return path;\n  }\n\n  function findCommonAncestorLength(path1: string[], path2: string[]): number {\n    let i = 0;\n    while (i < path1.length && i < path2.length && path1[i] === path2[i]) {\n      i++;\n    }\n    return i;\n  }\n\n  function findTransitionHandler(\n    path: string[],\n    eventType: string\n  ): { path: string[]; config: TransitionConfig<TContext, TEvent> } | null {\n    // Search from leaf to root (event bubbling)\n    for (let i = path.length; i > 0; i--) {\n      const currentPath = path.slice(0, i);\n      const node = getStateNodeAtPath(currentPath);\n\n      if (node?.on?.[eventType]) {\n        return { path: currentPath, config: node.on[eventType] as TransitionConfig<TContext, TEvent> };\n      }\n    }\n\n    return null;\n  }\n\n  function notifySubscribers(): void {\n    for (const subscriber of subscribers) {\n      subscriber(currentSnapshot);\n    }\n  }\n\n  function send(event: TEvent | TEvent['type']): void {\n    if (stopped) return;\n\n    const normalizedEvent: TEvent =\n      typeof event === 'string' ? ({ type: event } as TEvent) : event;\n\n    // Notify transition listeners\n    for (const listener of transitionListeners) {\n      listener(normalizedEvent);\n    }\n\n    // Find handler\n    const handler = findTransitionHandler(currentSnapshot.path as string[], normalizedEvent.type);\n    if (!handler) return;\n\n    const resolved = resolveTransition(handler.config, context, normalizedEvent);\n    if (!resolved) return;\n\n    performTransition(\n      handler.path,\n      resolved.target,\n      resolved.actions,\n      normalizedEvent\n    );\n  }\n\n  function subscribe(\n    listener: (state: IStateSnapshot<TContext>) => void\n  ): () => void {\n    subscribers.add(listener);\n    return () => {\n      subscribers.delete(listener);\n    };\n  }\n\n  function onTransition(listener: (event: TEvent) => void): () => void {\n    transitionListeners.add(listener);\n    return () => {\n      transitionListeners.delete(listener);\n    };\n  }\n\n  function stop(): void {\n    stopped = true;\n\n    // Clean up all active states\n    for (const activeState of [...activeStates]) {\n      for (const timer of activeState.timers) {\n        clearTimeout(timer);\n      }\n      for (const invoke of activeState.invokes) {\n        invoke.cancel();\n      }\n    }\n    activeStates.length = 0;\n\n    // Notify subscribers one final time\n    notifySubscribers();\n  }\n\n  return {\n    get state() {\n      return currentSnapshot;\n    },\n    send,\n    subscribe,\n    onTransition,\n    stop,\n  };\n}\n","import type {\n  AnyContext,\n  BaseEvent,\n  ChartDefinition,\n  ExportedChart,\n  ExportedStateNode,\n  ExportedTransition,\n  StateNode,\n  TransitionConfig,\n  Actions,\n} from './types.js';\n\nfunction getFunctionName(fn: Function): string {\n  return fn.name || 'anonymous';\n}\n\nfunction exportActions<TContext extends AnyContext, TEvent extends BaseEvent>(\n  actions: Actions<TContext, TEvent> | undefined\n): string[] {\n  if (!actions) return [];\n  const list = Array.isArray(actions) ? actions : [actions];\n  return list.map(getFunctionName);\n}\n\nfunction exportTransition<TContext extends AnyContext, TEvent extends BaseEvent>(\n  config: TransitionConfig<TContext, TEvent>\n): ExportedTransition | ExportedTransition[] {\n  if (typeof config === 'string') {\n    return { target: config, guard: null, actions: [] };\n  }\n\n  if (Array.isArray(config)) {\n    return config.map((item) => ({\n      target: item.target,\n      guard: item.guard ? getFunctionName(item.guard) : null,\n      actions: item.action ? [getFunctionName(item.action)] : [],\n    }));\n  }\n\n  return {\n    target: config.target,\n    guard: config.guard ? getFunctionName(config.guard) : null,\n    actions: config.action ? [getFunctionName(config.action)] : [],\n  };\n}\n\nfunction exportStateNode<TContext extends AnyContext, TEvent extends BaseEvent>(\n  node: StateNode<TContext, TEvent>\n): ExportedStateNode {\n  const exported: ExportedStateNode = {\n    entry: exportActions(node.entry),\n    exit: exportActions(node.exit),\n    on: {},\n  };\n\n  if (node.on) {\n    for (const [eventType, transition] of Object.entries(node.on)) {\n      exported.on[eventType] = exportTransition(transition as TransitionConfig<TContext, TEvent>);\n    }\n  }\n\n  if (node.after) {\n    exported.after = {};\n    for (const [delay, transition] of Object.entries(node.after)) {\n      exported.after[Number(delay)] = exportTransition(transition as TransitionConfig<TContext, TEvent>);\n    }\n  }\n\n  if (node.invoke) {\n    exported.invoke = getFunctionName(node.invoke);\n  }\n\n  if (node.onDone) {\n    exported.onDone = exportTransition(node.onDone as TransitionConfig<TContext, TEvent>);\n  }\n\n  if (node.onError) {\n    exported.onError = exportTransition(node.onError as TransitionConfig<TContext, TEvent>);\n  }\n\n  if (node.initial) {\n    exported.initial = node.initial;\n  }\n\n  if (node.states) {\n    exported.states = {};\n    for (const [name, childNode] of Object.entries(node.states)) {\n      exported.states[name] = exportStateNode(childNode);\n    }\n  }\n\n  if (node.parallel) {\n    exported.parallel = {};\n    for (const [regionName, region] of Object.entries(node.parallel)) {\n      exported.parallel[regionName] = {\n        initial: region.initial,\n        states: {},\n      };\n      for (const [stateName, stateNode] of Object.entries(region.states)) {\n        exported.parallel[regionName]!.states[stateName] = exportStateNode(stateNode);\n      }\n    }\n  }\n\n  if (node.final) {\n    exported.final = true;\n  }\n\n  return exported;\n}\n\nexport function exportChart<TContext extends AnyContext, TEvent extends BaseEvent>(\n  definition: ChartDefinition<TContext, TEvent>\n): ExportedChart {\n  const states: Record<string, ExportedStateNode> = {};\n\n  for (const [name, node] of Object.entries(definition.states)) {\n    states[name] = exportStateNode(node);\n  }\n\n  return {\n    version: 1,\n    id: definition.id ?? 'chart',\n    initial: definition.initial,\n    context: definition.context,\n    states,\n  };\n}\n","import type {\n  AnyContext,\n  BaseEvent,\n  Chart,\n  ChartDefinition,\n  ChartInstance,\n  ExportedChart,\n} from './types.js';\nimport { createInstance } from './instance.js';\nimport { exportChart } from './export.js';\n\nexport function chart<TContext extends AnyContext, TEvent extends BaseEvent = BaseEvent>(\n  definition: ChartDefinition<TContext, TEvent>\n): Chart<TContext, TEvent> {\n  return {\n    get definition(): ChartDefinition<TContext, TEvent> {\n      return definition;\n    },\n\n    start(initialContext?: Partial<TContext>): ChartInstance<TContext, TEvent> {\n      return createInstance(definition, initialContext);\n    },\n\n    export(): ExportedChart {\n      return exportChart(definition);\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "statecharts.sh",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema.json": "./schema.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "schema.json"],
+  "scripts": {
+    "build": "tsdown",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@statecharts/typescript-config": "*",
+    "tsdown": "^0.20.1",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4"
+  }
+}

package/schema.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://statecharts.sh/schema.json",
+  "title": "ExportedChart",
+  "description": "JSON Schema for statechart export format",
+  "type": "object",
+  "required": ["version", "id", "initial", "context", "states"],
+  "properties": {
+    "version": {
+      "const": 1,
+      "description": "Schema version for forward compatibility"
+    },
+    "id": {
+      "type": "string",
+      "description": "Chart identifier"
+    },
+    "initial": {
+      "type": "string",
+      "description": "Initial state name"
+    },
+    "context": {
+      "description": "Initial context value"
+    },
+    "states": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/ExportedStateNode"
+      },
+      "description": "State tree structure"
+    }
+  },
+  "$defs": {
+    "ExportedTransition": {
+      "type": "object",
+      "required": ["guard", "actions"],
+      "properties": {
+        "target": {
+          "type": "string",
+          "description": "Target state name"
+        },
+        "guard": {
+          "type": ["string", "null"],
+          "description": "Guard function name or null"
+        },
+        "actions": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Action function names"
+        }
+      }
+    },
+    "TransitionOrArray": {
+      "oneOf": [
+        { "$ref": "#/$defs/ExportedTransition" },
+        {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ExportedTransition" }
+        }
+      ]
+    },
+    "ParallelRegion": {
+      "type": "object",
+      "required": ["initial", "states"],
+      "properties": {
+        "initial": {
+          "type": "string"
+        },
+        "states": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/ExportedStateNode"
+          }
+        }
+      }
+    },
+    "ExportedStateNode": {
+      "type": "object",
+      "required": ["entry", "exit", "on"],
+      "properties": {
+        "entry": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Entry action names"
+        },
+        "exit": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Exit action names"
+        },
+        "on": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/TransitionOrArray"
+          },
+          "description": "Event transitions"
+        },
+        "after": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/TransitionOrArray"
+          },
+          "description": "Delayed transitions keyed by milliseconds"
+        },
+        "invoke": {
+          "type": ["string", "null"],
+          "description": "Invoked service function name"
+        },
+        "onDone": {
+          "$ref": "#/$defs/TransitionOrArray",
+          "description": "Transition on invoke completion"
+        },
+        "onError": {
+          "$ref": "#/$defs/TransitionOrArray",
+          "description": "Transition on invoke error"
+        },
+        "initial": {
+          "type": "string",
+          "description": "Initial child state for compound states"
+        },
+        "states": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/ExportedStateNode"
+          },
+          "description": "Nested state nodes"
+        },
+        "parallel": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/ParallelRegion"
+          },
+          "description": "Parallel state regions"
+        },
+        "final": {
+          "type": "boolean",
+          "description": "Whether this is a final state"
+        }
+      }
+    }
+  }
+}