@quazardous/quarkernel 1.0.12 → 2.2.3

package/dist/xstate.d.cts

@@ -0,0 +1,152 @@
+import { G as GuardFunction, A as ActionFunction, M as MachineConfig, C as CreateMachineConfig } from './create-machine-CYsscHPX.cjs';
+
+/**
+ * XState Import Helper
+ *
+ * Converts XState machine definitions to quarkernel FSM format.
+ * Supports basic XState v4/v5 machine structures.
+ */
+
+/**
+ * XState-like state node (simplified)
+ */
+interface XStateNode {
+    on?: Record<string, string | XStateTransition>;
+    entry?: string | string[] | XStateAction | XStateAction[];
+    exit?: string | string[] | XStateAction | XStateAction[];
+    always?: XStateTransition | XStateTransition[];
+    after?: Record<string, string | XStateTransition>;
+    meta?: Record<string, any>;
+}
+/**
+ * XState-like transition
+ */
+interface XStateTransition {
+    target?: string;
+    cond?: string | XStateGuard;
+    guard?: string | XStateGuard;
+    actions?: string | string[] | XStateAction | XStateAction[];
+}
+/**
+ * XState guard definition
+ */
+interface XStateGuard {
+    type: string;
+    [key: string]: any;
+}
+/**
+ * XState action definition
+ */
+interface XStateAction {
+    type: string;
+    [key: string]: any;
+}
+/**
+ * XState-like machine config
+ */
+interface XStateMachineConfig {
+    id?: string;
+    initial: string;
+    context?: Record<string, any>;
+    states: Record<string, XStateNode>;
+}
+/**
+ * Import options
+ */
+interface ImportOptions<TContext = any> {
+    /** Machine prefix (required for quarkernel) */
+    prefix: string;
+    /** Guard implementations (keyed by guard name/type) */
+    guards?: Record<string, GuardFunction<TContext>>;
+    /** Action implementations (keyed by action name/type) */
+    actions?: Record<string, ActionFunction<TContext>>;
+    /** Allow force transitions */
+    allowForce?: boolean;
+    /** Track history */
+    trackHistory?: boolean;
+}
+/**
+ * Convert XState machine config to quarkernel format
+ *
+ * @param xstateConfig - XState machine configuration
+ * @param options - Import options with implementations
+ * @returns quarkernel MachineConfig
+ *
+ * @example
+ * ```ts
+ * // XState format
+ * const xstateMachine = {
+ *   id: 'order',
+ *   initial: 'draft',
+ *   context: { retries: 0 },
+ *   states: {
+ *     draft: { on: { SUBMIT: 'pending' } },
+ *     pending: {
+ *       on: {
+ *         APPROVE: { target: 'confirmed', cond: 'canApprove' },
+ *         REJECT: 'draft'
+ *       }
+ *     },
+ *     confirmed: {}
+ *   }
+ * };
+ *
+ * // Convert to quarkernel
+ * const config = fromXState(xstateMachine, {
+ *   prefix: 'order',
+ *   guards: {
+ *     canApprove: (ctx) => ctx.retries < 3
+ *   }
+ * });
+ *
+ * const machine = useMachine(kernel, config);
+ * ```
+ */
+declare function fromXState<TContext = Record<string, any>>(xstateConfig: XStateMachineConfig, options: ImportOptions<TContext>): MachineConfig<TContext>;
+/**
+ * Export quarkernel machine config to XState-compatible format
+ * Useful for visualization tools that understand XState format
+ *
+ * @param config - quarkernel MachineConfig
+ * @returns XState-compatible config (without function implementations)
+ */
+declare function toXStateFormat<TContext = any>(config: MachineConfig<TContext>): XStateMachineConfig;
+
+/**
+ * XState <-> FSM Behaviors Conversion
+ *
+ * Converts between QuarKernel FSM (state-centric) and XState format.
+ */
+
+/**
+ * XState config with actions
+ */
+interface XStateConfigWithActions {
+    id: string;
+    initial: string;
+    context?: Record<string, unknown>;
+    states: Record<string, {
+        entry?: string | string[];
+        exit?: string | string[];
+        on?: Record<string, string | {
+            target: string;
+            actions?: string | string[];
+        }>;
+        after?: Record<number, {
+            target?: string;
+            actions?: string | string[];
+        }>;
+    }>;
+}
+/**
+ * Format state-centric FSM config as JavaScript code string
+ *
+ * @example
+ * ```ts
+ * const code = formatStateCentricCode(config);
+ * // Returns formatted JS code string with entry/exit/after inline in states
+ * ```
+ */
+declare function formatStateCentricCode<TContext = Record<string, unknown>>(config: CreateMachineConfig<TContext>): string;
+
+export { type ImportOptions, type XStateConfigWithActions, type XStateMachineConfig, formatStateCentricCode, fromXState, toXStateFormat };

package/dist/xstate.d.ts

@@ -0,0 +1,152 @@
+import { G as GuardFunction, A as ActionFunction, M as MachineConfig, C as CreateMachineConfig } from './create-machine-CYsscHPX.js';
+
+/**
+ * XState Import Helper
+ *
+ * Converts XState machine definitions to quarkernel FSM format.
+ * Supports basic XState v4/v5 machine structures.
+ */
+
+/**
+ * XState-like state node (simplified)
+ */
+interface XStateNode {
+    on?: Record<string, string | XStateTransition>;
+    entry?: string | string[] | XStateAction | XStateAction[];
+    exit?: string | string[] | XStateAction | XStateAction[];
+    always?: XStateTransition | XStateTransition[];
+    after?: Record<string, string | XStateTransition>;
+    meta?: Record<string, any>;
+}
+/**
+ * XState-like transition
+ */
+interface XStateTransition {
+    target?: string;
+    cond?: string | XStateGuard;
+    guard?: string | XStateGuard;
+    actions?: string | string[] | XStateAction | XStateAction[];
+}
+/**
+ * XState guard definition
+ */
+interface XStateGuard {
+    type: string;
+    [key: string]: any;
+}
+/**
+ * XState action definition
+ */
+interface XStateAction {
+    type: string;
+    [key: string]: any;
+}
+/**
+ * XState-like machine config
+ */
+interface XStateMachineConfig {
+    id?: string;
+    initial: string;
+    context?: Record<string, any>;
+    states: Record<string, XStateNode>;
+}
+/**
+ * Import options
+ */
+interface ImportOptions<TContext = any> {
+    /** Machine prefix (required for quarkernel) */
+    prefix: string;
+    /** Guard implementations (keyed by guard name/type) */
+    guards?: Record<string, GuardFunction<TContext>>;
+    /** Action implementations (keyed by action name/type) */
+    actions?: Record<string, ActionFunction<TContext>>;
+    /** Allow force transitions */
+    allowForce?: boolean;
+    /** Track history */
+    trackHistory?: boolean;
+}
+/**
+ * Convert XState machine config to quarkernel format
+ *
+ * @param xstateConfig - XState machine configuration
+ * @param options - Import options with implementations
+ * @returns quarkernel MachineConfig
+ *
+ * @example
+ * ```ts
+ * // XState format
+ * const xstateMachine = {
+ *   id: 'order',
+ *   initial: 'draft',
+ *   context: { retries: 0 },
+ *   states: {
+ *     draft: { on: { SUBMIT: 'pending' } },
+ *     pending: {
+ *       on: {
+ *         APPROVE: { target: 'confirmed', cond: 'canApprove' },
+ *         REJECT: 'draft'
+ *       }
+ *     },
+ *     confirmed: {}
+ *   }
+ * };
+ *
+ * // Convert to quarkernel
+ * const config = fromXState(xstateMachine, {
+ *   prefix: 'order',
+ *   guards: {
+ *     canApprove: (ctx) => ctx.retries < 3
+ *   }
+ * });
+ *
+ * const machine = useMachine(kernel, config);
+ * ```
+ */
+declare function fromXState<TContext = Record<string, any>>(xstateConfig: XStateMachineConfig, options: ImportOptions<TContext>): MachineConfig<TContext>;
+/**
+ * Export quarkernel machine config to XState-compatible format
+ * Useful for visualization tools that understand XState format
+ *
+ * @param config - quarkernel MachineConfig
+ * @returns XState-compatible config (without function implementations)
+ */
+declare function toXStateFormat<TContext = any>(config: MachineConfig<TContext>): XStateMachineConfig;
+
+/**
+ * XState <-> FSM Behaviors Conversion
+ *
+ * Converts between QuarKernel FSM (state-centric) and XState format.
+ */
+
+/**
+ * XState config with actions
+ */
+interface XStateConfigWithActions {
+    id: string;
+    initial: string;
+    context?: Record<string, unknown>;
+    states: Record<string, {
+        entry?: string | string[];
+        exit?: string | string[];
+        on?: Record<string, string | {
+            target: string;
+            actions?: string | string[];
+        }>;
+        after?: Record<number, {
+            target?: string;
+            actions?: string | string[];
+        }>;
+    }>;
+}
+/**
+ * Format state-centric FSM config as JavaScript code string
+ *
+ * @example
+ * ```ts
+ * const code = formatStateCentricCode(config);
+ * // Returns formatted JS code string with entry/exit/after inline in states
+ * ```
+ */
+declare function formatStateCentricCode<TContext = Record<string, unknown>>(config: CreateMachineConfig<TContext>): string;
+
+export { type ImportOptions, type XStateConfigWithActions, type XStateMachineConfig, formatStateCentricCode, fromXState, toXStateFormat };

package/dist/xstate.js

@@ -0,0 +1,186 @@
+// src/xstate/xstate-import.ts
+function fromXState(xstateConfig, options) {
+  const { prefix, guards = {}, actions = {}, allowForce, trackHistory } = options;
+  const states = {};
+  for (const [stateName, xstateNode] of Object.entries(xstateConfig.states)) {
+    const stateNode = {};
+    if (xstateNode.on) {
+      stateNode.on = {};
+      for (const [event, transition] of Object.entries(xstateNode.on)) {
+        if (typeof transition === "string") {
+          stateNode.on[event] = transition;
+        } else {
+          const transitionDef = {
+            target: transition.target || stateName
+            // Self-transition if no target
+          };
+          const guardRef = transition.cond || transition.guard;
+          if (guardRef) {
+            const guardName = typeof guardRef === "string" ? guardRef : guardRef.type;
+            const guardFn = guards[guardName];
+            if (guardFn) {
+              transitionDef.guard = guardFn;
+            } else {
+              console.warn(`Guard "${guardName}" not provided in options.guards`);
+            }
+          }
+          if (transition.actions) {
+            const actionRefs = Array.isArray(transition.actions) ? transition.actions : [transition.actions];
+            const actionFns = [];
+            for (const actionRef of actionRefs) {
+              const actionName = typeof actionRef === "string" ? actionRef : actionRef.type;
+              const actionFn = actions[actionName];
+              if (actionFn) {
+                actionFns.push(actionFn);
+              } else {
+                console.warn(`Action "${actionName}" not provided in options.actions`);
+              }
+            }
+            if (actionFns.length > 0) {
+              transitionDef.actions = actionFns.length === 1 ? actionFns[0] : actionFns;
+            }
+          }
+          stateNode.on[event] = transitionDef;
+        }
+      }
+    }
+    if (xstateNode.entry) {
+      const entryRefs = Array.isArray(xstateNode.entry) ? xstateNode.entry : [xstateNode.entry];
+      const entryFns = [];
+      for (const actionRef of entryRefs) {
+        const actionName = typeof actionRef === "string" ? actionRef : actionRef.type;
+        const actionFn = actions[actionName];
+        if (actionFn) {
+          entryFns.push(actionFn);
+        }
+      }
+      if (entryFns.length > 0) {
+        stateNode.entry = async (ctx, event, payload) => {
+          for (const fn of entryFns) {
+            await fn(ctx, event, payload);
+          }
+        };
+      }
+    }
+    if (xstateNode.exit) {
+      const exitRefs = Array.isArray(xstateNode.exit) ? xstateNode.exit : [xstateNode.exit];
+      const exitFns = [];
+      for (const actionRef of exitRefs) {
+        const actionName = typeof actionRef === "string" ? actionRef : actionRef.type;
+        const actionFn = actions[actionName];
+        if (actionFn) {
+          exitFns.push(actionFn);
+        }
+      }
+      if (exitFns.length > 0) {
+        stateNode.exit = async (ctx, event, payload) => {
+          for (const fn of exitFns) {
+            await fn(ctx, event, payload);
+          }
+        };
+      }
+    }
+    states[stateName] = stateNode;
+  }
+  return {
+    prefix,
+    initial: xstateConfig.initial,
+    context: xstateConfig.context,
+    states,
+    allowForce,
+    trackHistory
+  };
+}
+function toXStateFormat(config) {
+  const states = {};
+  for (const [stateName, stateNode] of Object.entries(config.states)) {
+    const xstateNode = {};
+    if (stateNode.on) {
+      xstateNode.on = {};
+      for (const [event, transition] of Object.entries(stateNode.on)) {
+        if (typeof transition === "string") {
+          xstateNode.on[event] = transition;
+        } else {
+          const xstateTransition = {
+            target: transition.target
+          };
+          if (transition.guard) {
+            xstateTransition.guard = { type: "guard" };
+          }
+          if (transition.actions) {
+            xstateTransition.actions = { type: "action" };
+          }
+          xstateNode.on[event] = xstateTransition;
+        }
+      }
+    }
+    if (stateNode.entry) {
+      xstateNode.entry = { type: "entry" };
+    }
+    if (stateNode.exit) {
+      xstateNode.exit = { type: "exit" };
+    }
+    states[stateName] = xstateNode;
+  }
+  return {
+    id: config.prefix,
+    initial: config.initial,
+    context: config.context,
+    states
+  };
+}
+
+// src/xstate/xstate-behaviors.ts
+function formatStateCentricCode(config) {
+  const { id, initial, context, states, on: globalHandlers } = config;
+  const lines = [
+    `// FSM Definition for "${id}"`,
+    `// Helpers: ctx, set(obj), send(event), log(msg)`,
+    "",
+    `export default {`,
+    `  id: '${id}',`,
+    `  initial: '${initial}',`
+  ];
+  if (context && Object.keys(context).length > 0) {
+    lines.push(`  context: ${JSON.stringify(context)},`);
+  }
+  lines.push("  states: {");
+  for (const [stateName, stateConfig] of Object.entries(states)) {
+    lines.push(`    ${stateName}: {`);
+    if (stateConfig.entry) {
+      lines.push(`      entry: ${stateConfig.entry.toString()},`);
+    }
+    if (stateConfig.exit) {
+      lines.push(`      exit: ${stateConfig.exit.toString()},`);
+    }
+    if (stateConfig.after) {
+      lines.push(`      after: { delay: ${stateConfig.after.delay}, send: '${stateConfig.after.send}' },`);
+    }
+    if (stateConfig.on && Object.keys(stateConfig.on).length > 0) {
+      lines.push("      on: {");
+      for (const [event, target] of Object.entries(stateConfig.on)) {
+        if (typeof target === "string") {
+          lines.push(`        ${event}: '${target}',`);
+        } else {
+          lines.push(`        ${event}: { target: '${target.target}'${target.cond ? `, cond: '${target.cond}'` : ""} },`);
+        }
+      }
+      lines.push("      },");
+    }
+    lines.push("    },");
+  }
+  lines.push("  },");
+  if (globalHandlers && Object.keys(globalHandlers).length > 0) {
+    lines.push("  on: {");
+    for (const [event, fn] of Object.entries(globalHandlers)) {
+      lines.push(`    ${event}: ${fn.toString()},`);
+    }
+    lines.push("  },");
+  }
+  lines.push("};");
+  return lines.join("\n");
+}
+
+export { formatStateCentricCode, fromXState, toXStateFormat };
+//# sourceMappingURL=xstate.js.map
+//# sourceMappingURL=xstate.js.map

package/dist/xstate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/xstate/xstate-import.ts","../src/xstate/xstate-behaviors.ts"],"names":[],"mappings":";AAkHO,SAAS,UAAA,CACd,cACA,OAAA,EACyB;AACzB,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,GAAS,EAAC,EAAG,UAAU,EAAC,EAAG,UAAA,EAAY,YAAA,EAAa,GAAI,OAAA;AAExE,EAAA,MAAM,SAA8C,EAAC;AAErD,EAAA,KAAA,MAAW,CAAC,WAAW,UAAU,CAAA,IAAK,OAAO,OAAA,CAAQ,YAAA,CAAa,MAAM,CAAA,EAAG;AACzE,IAAA,MAAM,YAAiC,EAAC;AAGxC,IAAA,IAAI,WAAW,EAAA,EAAI;AACjB,MAAA,SAAA,CAAU,KAAK,EAAC;AAEhB,MAAA,KAAA,MAAW,CAAC,OAAO,UAAU,CAAA,IAAK,OAAO,OAAA,CAAQ,UAAA,CAAW,EAAE,CAAA,EAAG;AAC/D,QAAA,IAAI,OAAO,eAAe,QAAA,EAAU;AAElC,UAAA,SAAA,CAAU,EAAA,CAAG,KAAK,CAAA,GAAI,UAAA;AAAA,QACxB,CAAA,MAAO;AAEL,UAAA,MAAM,aAAA,GAAyC;AAAA,YAC7C,MAAA,EAAQ,WAAW,MAAA,IAAU;AAAA;AAAA,WAC/B;AAGA,UAAA,MAAM,QAAA,GAAW,UAAA,CAAW,IAAA,IAAQ,UAAA,CAAW,KAAA;AAC/C,UAAA,IAAI,QAAA,EAAU;AACZ,YAAA,MAAM,SAAA,GAAY,OAAO,QAAA,KAAa,QAAA,GAAW,WAAW,QAAA,CAAS,IAAA;AACrE,YAAA,MAAM,OAAA,GAAU,OAAO,SAAS,CAAA;AAChC,YAAA,IAAI,OAAA,EAAS;AACX,cAAA,aAAA,CAAc,KAAA,GAAQ,OAAA;AAAA,YACxB,CAAA,MAAO;AACL,cAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,OAAA,EAAU,SAAS,CAAA,gCAAA,CAAkC,CAAA;AAAA,YACpE;AAAA,UACF;AAGA,UAAA,IAAI,WAAW,OAAA,EAAS;AACtB,YAAA,MAAM,UAAA,GAAa,KAAA,CAAM,OAAA,CAAQ,UAAA,CAAW,OAAO,IAC/C,UAAA,CAAW,OAAA,GACX,CAAC,UAAA,CAAW,OAAO,CAAA;AAEvB,YAAA,MAAM,YAAwC,EAAC;AAC/C,YAAA,KAAA,MAAW,aAAa,UAAA,EAAY;AAClC,cAAA,MAAM,UAAA,GAAa,OAAO,SAAA,KAAc,QAAA,GAAW,YAAY,SAAA,CAAU,IAAA;AACzE,cAAA,MAAM,QAAA,GAAW,QAAQ,UAAU,CAAA;AACnC,cAAA,IAAI,QAAA,EAAU;AACZ,gBAAA,SAAA,CAAU,KAAK,QAAQ,CAAA;AAAA,cACzB,CAAA,MAAO;AACL,gBAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,QAAA,EAAW,UAAU,CAAA,iCAAA,CAAmC,CAAA;AAAA,cACvE;AAAA,YACF;AAEA,YAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG;AACxB,cAAA,aAAA,CAAc,UAAU,SAAA,CAAU,MAAA,KAAW,CAAA,GAAI,SAAA,CAAU,CAAC,CAAA,GAAI,SAAA;AAAA,YAClE;AAAA,UACF;AAEA,UAAA,SAAA,CAAU,EAAA,CAAG,KAAK,CAAA,GAAI,aAAA;AAAA,QACxB;AAAA,MACF;AAAA,IACF;AAGA,IAAA,IAAI,WAAW,KAAA,EAAO;AACpB,MAAA,MAAM,SAAA,GAAY,KAAA,CAAM,OAAA,CAAQ,UAAA,CAAW,KAAK,IAC5C,UAAA,CAAW,KAAA,GACX,CAAC,UAAA,CAAW,KAAK,CAAA;AAErB,MAAA,MAAM,WAAuC,EAAC;AAC9C,MAAA,KAAA,MAAW,aAAa,SAAA,EAAW;AACjC,QAAA,MAAM,UAAA,GAAa,OAAO,SAAA,KAAc,QAAA,GAAW,YAAY,SAAA,CAAU,IAAA;AACzE,QAAA,MAAM,QAAA,GAAW,QAAQ,UAAU,CAAA;AACnC,QAAA,IAAI,QAAA,EAAU;AACZ,UAAA,QAAA,CAAS,KAAK,QAAQ,CAAA;AAAA,QACxB;AAAA,MACF;AAEA,MAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,QAAA,SAAA,CAAU,KAAA,GAAQ,OAAO,GAAA,EAAK,KAAA,EAAO,OAAA,KAAY;AAC/C,UAAA,KAAA,MAAW,MAAM,QAAA,EAAU;AACzB,YAAA,MAAM,EAAA,CAAG,GAAA,EAAK,KAAA,EAAO,OAAO,CAAA;AAAA,UAC9B;AAAA,QACF,CAAA;AAAA,MACF;AAAA,IACF;AAGA,IAAA,IAAI,WAAW,IAAA,EAAM;AACnB,MAAA,MAAM,QAAA,GAAW,KAAA,CAAM,OAAA,CAAQ,UAAA,CAAW,IAAI,IAC1C,UAAA,CAAW,IAAA,GACX,CAAC,UAAA,CAAW,IAAI,CAAA;AAEpB,MAAA,MAAM,UAAsC,EAAC;AAC7C,MAAA,KAAA,MAAW,aAAa,QAAA,EAAU;AAChC,QAAA,MAAM,UAAA,GAAa,OAAO,SAAA,KAAc,QAAA,GAAW,YAAY,SAAA,CAAU,IAAA;AACzE,QAAA,MAAM,QAAA,GAAW,QAAQ,UAAU,CAAA;AACnC,QAAA,IAAI,QAAA,EAAU;AACZ,UAAA,OAAA,CAAQ,KAAK,QAAQ,CAAA;AAAA,QACvB;AAAA,MACF;AAEA,MAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACtB,QAAA,SAAA,CAAU,IAAA,GAAO,OAAO,GAAA,EAAK,KAAA,EAAO,OAAA,KAAY;AAC9C,UAAA,KAAA,MAAW,MAAM,OAAA,EAAS;AACxB,YAAA,MAAM,EAAA,CAAG,GAAA,EAAK,KAAA,EAAO,OAAO,CAAA;AAAA,UAC9B;AAAA,QACF,CAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAA,CAAO,SAAS,CAAA,GAAI,SAAA;AAAA,EACtB;AAEA,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,SAAS,YAAA,CAAa,OAAA;AAAA,IACtB,SAAS,YAAA,CAAa,OAAA;AAAA,IACtB,MAAA;AAAA,IACA,UAAA;AAAA,IACA;AAAA,GACF;AACF;AASO,SAAS,eACd,MAAA,EACqB;AACrB,EAAA,MAAM,SAAqC,EAAC;AAE5C,EAAA,KAAA,MAAW,CAAC,WAAW,SAAS,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA,EAAG;AAClE,IAAA,MAAM,aAAyB,EAAC;AAEhC,IAAA,IAAI,UAAU,EAAA,EAAI;AAChB,MAAA,UAAA,CAAW,KAAK,EAAC;AAEjB,MAAA,KAAA,MAAW,CAAC,OAAO,UAAU,CAAA,IAAK,OAAO,OAAA,CAAQ,SAAA,CAAU,EAAE,CAAA,EAAG;AAC9D,QAAA,IAAI,OAAO,eAAe,QAAA,EAAU;AAClC,UAAA,UAAA,CAAW,EAAA,CAAG,KAAK,CAAA,GAAI,UAAA;AAAA,QACzB,CAAA,MAAO;AACL,UAAA,MAAM,gBAAA,GAAqC;AAAA,YACzC,QAAQ,UAAA,CAAW;AAAA,WACrB;AAIA,UAAA,IAAI,WAAW,KAAA,EAAO;AACpB,YAAA,gBAAA,CAAiB,KAAA,GAAQ,EAAE,IAAA,EAAM,OAAA,EAAQ;AAAA,UAC3C;AACA,UAAA,IAAI,WAAW,OAAA,EAAS;AACtB,YAAA,gBAAA,CAAiB,OAAA,GAAU,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,UAC9C;AAEA,UAAA,UAAA,CAAW,EAAA,CAAG,KAAK,CAAA,GAAI,gBAAA;AAAA,QACzB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,UAAU,KAAA,EAAO;AACnB,MAAA,UAAA,CAAW,KAAA,GAAQ,EAAE,IAAA,EAAM,OAAA,EAAQ;AAAA,IACrC;AAEA,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,UAAA,CAAW,IAAA,GAAO,EAAE,IAAA,EAAM,MAAA,EAAO;AAAA,IACnC;AAEA,IAAA,MAAA,CAAO,SAAS,CAAA,GAAI,UAAA;AAAA,EACtB;AAEA,EAAA,OAAO;AAAA,IACL,IAAI,MAAA,CAAO,MAAA;AAAA,IACX,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB;AAAA,GACF;AACF;;;ACxQO,SAAS,uBACd,MAAA,EACQ;AACR,EAAA,MAAM,EAAE,EAAA,EAAI,OAAA,EAAS,SAAS,MAAA,EAAQ,EAAA,EAAI,gBAAe,GAAI,MAAA;AAE7D,EAAA,MAAM,KAAA,GAAkB;AAAA,IACtB,0BAA0B,EAAE,CAAA,CAAA,CAAA;AAAA,IAC5B,CAAA,gDAAA,CAAA;AAAA,IACA,EAAA;AAAA,IACA,CAAA,gBAAA,CAAA;AAAA,IACA,UAAU,EAAE,CAAA,EAAA,CAAA;AAAA,IACZ,eAAe,OAAO,CAAA,EAAA;AAAA,GACxB;AAGA,EAAA,IAAI,WAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,CAAE,SAAS,CAAA,EAAG;AAC9C,IAAA,KAAA,CAAM,KAAK,CAAA,WAAA,EAAc,IAAA,CAAK,SAAA,CAAU,OAAO,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,EACrD;AAGA,EAAA,KAAA,CAAM,KAAK,aAAa,CAAA;AACxB,EAAA,KAAA,MAAW,CAAC,SAAA,EAAW,WAAW,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC7D,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,IAAA,EAAO,SAAS,CAAA,GAAA,CAAK,CAAA;AAGhC,IAAA,IAAI,YAAY,KAAA,EAAO;AACrB,MAAA,KAAA,CAAM,KAAK,CAAA,aAAA,EAAgB,WAAA,CAAY,KAAA,CAAM,QAAA,EAAU,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5D;AAGA,IAAA,IAAI,YAAY,IAAA,EAAM;AACpB,MAAA,KAAA,CAAM,KAAK,CAAA,YAAA,EAAe,WAAA,CAAY,IAAA,CAAK,QAAA,EAAU,CAAA,CAAA,CAAG,CAAA;AAAA,IAC1D;AAGA,IAAA,IAAI,YAAY,KAAA,EAAO;AACrB,MAAA,KAAA,CAAM,IAAA,CAAK,yBAAyB,WAAA,CAAY,KAAA,CAAM,KAAK,CAAA,SAAA,EAAY,WAAA,CAAY,KAAA,CAAM,IAAI,CAAA,IAAA,CAAM,CAAA;AAAA,IACrG;AAGA,IAAA,IAAI,WAAA,CAAY,MAAM,MAAA,CAAO,IAAA,CAAK,YAAY,EAAE,CAAA,CAAE,SAAS,CAAA,EAAG;AAC5D,MAAA,KAAA,CAAM,KAAK,aAAa,CAAA;AACxB,MAAA,KAAA,MAAW,CAAC,OAAO,MAAM,CAAA,IAAK,OAAO,OAAA,CAAQ,WAAA,CAAY,EAAE,CAAA,EAAG;AAC5D,QAAA,IAAI,OAAO,WAAW,QAAA,EAAU;AAC9B,UAAA,KAAA,CAAM,IAAA,CAAK,CAAA,QAAA,EAAW,KAAK,CAAA,GAAA,EAAM,MAAM,CAAA,EAAA,CAAI,CAAA;AAAA,QAC7C,CAAA,MAAO;AACL,UAAA,KAAA,CAAM,IAAA,CAAK,CAAA,QAAA,EAAW,KAAK,CAAA,aAAA,EAAgB,OAAO,MAAM,CAAA,CAAA,EAAI,MAAA,CAAO,IAAA,GAAO,CAAA,SAAA,EAAY,MAAA,CAAO,IAAI,CAAA,CAAA,CAAA,GAAM,EAAE,CAAA,GAAA,CAAK,CAAA;AAAA,QAChH;AAAA,MACF;AACA,MAAA,KAAA,CAAM,KAAK,UAAU,CAAA;AAAA,IACvB;AAEA,IAAA,KAAA,CAAM,KAAK,QAAQ,CAAA;AAAA,EACrB;AACA,EAAA,KAAA,CAAM,KAAK,MAAM,CAAA;AAGjB,EAAA,IAAI,kBAAkB,MAAA,CAAO,IAAA,CAAK,cAAc,CAAA,CAAE,SAAS,CAAA,EAAG;AAC5D,IAAA,KAAA,CAAM,KAAK,SAAS,CAAA;AACpB,IAAA,KAAA,MAAW,CAAC,KAAA,EAAO,EAAE,KAAK,MAAA,CAAO,OAAA,CAAQ,cAAc,CAAA,EAAG;AACxD,MAAA,KAAA,CAAM,KAAK,CAAA,IAAA,EAAO,KAAK,KAAK,EAAA,CAAG,QAAA,EAAU,CAAA,CAAA,CAAG,CAAA;AAAA,IAC9C;AACA,IAAA,KAAA,CAAM,KAAK,MAAM,CAAA;AAAA,EACnB;AAEA,EAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AACf,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB","file":"xstate.js","sourcesContent":["/**\n * XState Import Helper\n *\n * Converts XState machine definitions to quarkernel FSM format.\n * Supports basic XState v4/v5 machine structures.\n */\n\nimport type { MachineConfig, StateNode, TransitionDef, GuardFunction, ActionFunction } from '../fsm/types.js';\n\n/**\n * XState-like state node (simplified)\n */\ninterface XStateNode {\n  on?: Record<string, string | XStateTransition>;\n  entry?: string | string[] | XStateAction | XStateAction[];\n  exit?: string | string[] | XStateAction | XStateAction[];\n  always?: XStateTransition | XStateTransition[];\n  after?: Record<string, string | XStateTransition>;\n  meta?: Record<string, any>;\n}\n\n/**\n * XState-like transition\n */\ninterface XStateTransition {\n  target?: string;\n  cond?: string | XStateGuard;\n  guard?: string | XStateGuard;  // v5 uses guard instead of cond\n  actions?: string | string[] | XStateAction | XStateAction[];\n}\n\n/**\n * XState guard definition\n */\ninterface XStateGuard {\n  type: string;\n  [key: string]: any;\n}\n\n/**\n * XState action definition\n */\ninterface XStateAction {\n  type: string;\n  [key: string]: any;\n}\n\n/**\n * XState-like machine config\n */\nexport interface XStateMachineConfig {\n  id?: string;\n  initial: string;\n  context?: Record<string, any>;\n  states: Record<string, XStateNode>;\n}\n\n/**\n * Import options\n */\nexport interface ImportOptions<TContext = any> {\n  /** Machine prefix (required for quarkernel) */\n  prefix: string;\n\n  /** Guard implementations (keyed by guard name/type) */\n  guards?: Record<string, GuardFunction<TContext>>;\n\n  /** Action implementations (keyed by action name/type) */\n  actions?: Record<string, ActionFunction<TContext>>;\n\n  /** Allow force transitions */\n  allowForce?: boolean;\n\n  /** Track history */\n  trackHistory?: boolean;\n}\n\n/**\n * Convert XState machine config to quarkernel format\n *\n * @param xstateConfig - XState machine configuration\n * @param options - Import options with implementations\n * @returns quarkernel MachineConfig\n *\n * @example\n * ```ts\n * // XState format\n * const xstateMachine = {\n *   id: 'order',\n *   initial: 'draft',\n *   context: { retries: 0 },\n *   states: {\n *     draft: { on: { SUBMIT: 'pending' } },\n *     pending: {\n *       on: {\n *         APPROVE: { target: 'confirmed', cond: 'canApprove' },\n *         REJECT: 'draft'\n *       }\n *     },\n *     confirmed: {}\n *   }\n * };\n *\n * // Convert to quarkernel\n * const config = fromXState(xstateMachine, {\n *   prefix: 'order',\n *   guards: {\n *     canApprove: (ctx) => ctx.retries < 3\n *   }\n * });\n *\n * const machine = useMachine(kernel, config);\n * ```\n */\nexport function fromXState<TContext = Record<string, any>>(\n  xstateConfig: XStateMachineConfig,\n  options: ImportOptions<TContext>\n): MachineConfig<TContext> {\n  const { prefix, guards = {}, actions = {}, allowForce, trackHistory } = options;\n\n  const states: Record<string, StateNode<TContext>> = {};\n\n  for (const [stateName, xstateNode] of Object.entries(xstateConfig.states)) {\n    const stateNode: StateNode<TContext> = {};\n\n    // Convert transitions\n    if (xstateNode.on) {\n      stateNode.on = {};\n\n      for (const [event, transition] of Object.entries(xstateNode.on)) {\n        if (typeof transition === 'string') {\n          // Simple string target\n          stateNode.on[event] = transition;\n        } else {\n          // Object transition with target, guard, actions\n          const transitionDef: TransitionDef<TContext> = {\n            target: transition.target || stateName, // Self-transition if no target\n          };\n\n          // Convert guard (cond in v4, guard in v5)\n          const guardRef = transition.cond || transition.guard;\n          if (guardRef) {\n            const guardName = typeof guardRef === 'string' ? guardRef : guardRef.type;\n            const guardFn = guards[guardName];\n            if (guardFn) {\n              transitionDef.guard = guardFn;\n            } else {\n              console.warn(`Guard \"${guardName}\" not provided in options.guards`);\n            }\n          }\n\n          // Convert actions\n          if (transition.actions) {\n            const actionRefs = Array.isArray(transition.actions)\n              ? transition.actions\n              : [transition.actions];\n\n            const actionFns: ActionFunction<TContext>[] = [];\n            for (const actionRef of actionRefs) {\n              const actionName = typeof actionRef === 'string' ? actionRef : actionRef.type;\n              const actionFn = actions[actionName];\n              if (actionFn) {\n                actionFns.push(actionFn);\n              } else {\n                console.warn(`Action \"${actionName}\" not provided in options.actions`);\n              }\n            }\n\n            if (actionFns.length > 0) {\n              transitionDef.actions = actionFns.length === 1 ? actionFns[0] : actionFns;\n            }\n          }\n\n          stateNode.on[event] = transitionDef;\n        }\n      }\n    }\n\n    // Convert entry actions\n    if (xstateNode.entry) {\n      const entryRefs = Array.isArray(xstateNode.entry)\n        ? xstateNode.entry\n        : [xstateNode.entry];\n\n      const entryFns: ActionFunction<TContext>[] = [];\n      for (const actionRef of entryRefs) {\n        const actionName = typeof actionRef === 'string' ? actionRef : actionRef.type;\n        const actionFn = actions[actionName];\n        if (actionFn) {\n          entryFns.push(actionFn);\n        }\n      }\n\n      if (entryFns.length > 0) {\n        stateNode.entry = async (ctx, event, payload) => {\n          for (const fn of entryFns) {\n            await fn(ctx, event, payload);\n          }\n        };\n      }\n    }\n\n    // Convert exit actions\n    if (xstateNode.exit) {\n      const exitRefs = Array.isArray(xstateNode.exit)\n        ? xstateNode.exit\n        : [xstateNode.exit];\n\n      const exitFns: ActionFunction<TContext>[] = [];\n      for (const actionRef of exitRefs) {\n        const actionName = typeof actionRef === 'string' ? actionRef : actionRef.type;\n        const actionFn = actions[actionName];\n        if (actionFn) {\n          exitFns.push(actionFn);\n        }\n      }\n\n      if (exitFns.length > 0) {\n        stateNode.exit = async (ctx, event, payload) => {\n          for (const fn of exitFns) {\n            await fn(ctx, event, payload);\n          }\n        };\n      }\n    }\n\n    states[stateName] = stateNode;\n  }\n\n  return {\n    prefix,\n    initial: xstateConfig.initial,\n    context: xstateConfig.context as TContext,\n    states,\n    allowForce,\n    trackHistory,\n  };\n}\n\n/**\n * Export quarkernel machine config to XState-compatible format\n * Useful for visualization tools that understand XState format\n *\n * @param config - quarkernel MachineConfig\n * @returns XState-compatible config (without function implementations)\n */\nexport function toXStateFormat<TContext = any>(\n  config: MachineConfig<TContext>\n): XStateMachineConfig {\n  const states: Record<string, XStateNode> = {};\n\n  for (const [stateName, stateNode] of Object.entries(config.states)) {\n    const xstateNode: XStateNode = {};\n\n    if (stateNode.on) {\n      xstateNode.on = {};\n\n      for (const [event, transition] of Object.entries(stateNode.on)) {\n        if (typeof transition === 'string') {\n          xstateNode.on[event] = transition;\n        } else {\n          const xstateTransition: XStateTransition = {\n            target: transition.target,\n          };\n\n          // Note: guard and action functions can't be serialized\n          // We just mark that they exist\n          if (transition.guard) {\n            xstateTransition.guard = { type: 'guard' };\n          }\n          if (transition.actions) {\n            xstateTransition.actions = { type: 'action' };\n          }\n\n          xstateNode.on[event] = xstateTransition;\n        }\n      }\n    }\n\n    if (stateNode.entry) {\n      xstateNode.entry = { type: 'entry' };\n    }\n\n    if (stateNode.exit) {\n      xstateNode.exit = { type: 'exit' };\n    }\n\n    states[stateName] = xstateNode;\n  }\n\n  return {\n    id: config.prefix,\n    initial: config.initial,\n    context: config.context as Record<string, any>,\n    states,\n  };\n}\n","/**\n * XState <-> FSM Behaviors Conversion\n *\n * Converts between QuarKernel FSM (state-centric) and XState format.\n */\n\nimport type { CreateMachineConfig } from '../fsm/create-machine.js';\n\n/**\n * XState config with actions\n */\nexport interface XStateConfigWithActions {\n  id: string;\n  initial: string;\n  context?: Record<string, unknown>;\n  states: Record<string, {\n    entry?: string | string[];\n    exit?: string | string[];\n    on?: Record<string, string | { target: string; actions?: string | string[] }>;\n    after?: Record<number, { target?: string; actions?: string | string[] }>;\n  }>;\n}\n\n/**\n * Format state-centric FSM config as JavaScript code string\n *\n * @example\n * ```ts\n * const code = formatStateCentricCode(config);\n * // Returns formatted JS code string with entry/exit/after inline in states\n * ```\n */\nexport function formatStateCentricCode<TContext = Record<string, unknown>>(\n  config: CreateMachineConfig<TContext>\n): string {\n  const { id, initial, context, states, on: globalHandlers } = config;\n\n  const lines: string[] = [\n    `// FSM Definition for \"${id}\"`,\n    `// Helpers: ctx, set(obj), send(event), log(msg)`,\n    '',\n    `export default {`,\n    `  id: '${id}',`,\n    `  initial: '${initial}',`,\n  ];\n\n  // Context\n  if (context && Object.keys(context).length > 0) {\n    lines.push(`  context: ${JSON.stringify(context)},`);\n  }\n\n  // States\n  lines.push('  states: {');\n  for (const [stateName, stateConfig] of Object.entries(states)) {\n    lines.push(`    ${stateName}: {`);\n\n    // entry\n    if (stateConfig.entry) {\n      lines.push(`      entry: ${stateConfig.entry.toString()},`);\n    }\n\n    // exit\n    if (stateConfig.exit) {\n      lines.push(`      exit: ${stateConfig.exit.toString()},`);\n    }\n\n    // after\n    if (stateConfig.after) {\n      lines.push(`      after: { delay: ${stateConfig.after.delay}, send: '${stateConfig.after.send}' },`);\n    }\n\n    // on (transitions)\n    if (stateConfig.on && Object.keys(stateConfig.on).length > 0) {\n      lines.push('      on: {');\n      for (const [event, target] of Object.entries(stateConfig.on)) {\n        if (typeof target === 'string') {\n          lines.push(`        ${event}: '${target}',`);\n        } else {\n          lines.push(`        ${event}: { target: '${target.target}'${target.cond ? `, cond: '${target.cond}'` : ''} },`);\n        }\n      }\n      lines.push('      },');\n    }\n\n    lines.push('    },');\n  }\n  lines.push('  },');\n\n  // Global event handlers\n  if (globalHandlers && Object.keys(globalHandlers).length > 0) {\n    lines.push('  on: {');\n    for (const [event, fn] of Object.entries(globalHandlers)) {\n      lines.push(`    ${event}: ${fn.toString()},`);\n    }\n    lines.push('  },');\n  }\n\n  lines.push('};');\n  return lines.join('\\n');\n}\n"]}

package/package.json

@@ -1,38 +1,77 @@
 {
   "name": "@quazardous/quarkernel",
-  "version": "1.0.12",
+  "version": "2.2.3",
   "type": "module",
-  "description": "Micro Custom Events Kernel",
+  "description": "Micro Custom Events Kernel with dependency ordering, shared context, and composite events",
+  "author": "quazardous <berliozdavid@gmail.com>",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/quazardous/quarkernel.git"
+    "url": "https://github.com/quazardous/quarkernel.git",
+    "directory": "packages/quarkernel"
   },
-  "module": "src/index.js",
-  "main": "src/index.js",
-  "files": [
-    "src/",
-    "types/"
-  ],
-  "typings": "./types/QuarKernel.d.ts",
-  "scripts": {
-    "prepare": "npm run gen-typings",
-    "test": "mocha tests/",
-    "gen-typings": "npx -p typescript tsc src/lib/*.js --declaration --allowJs --emitDeclarationOnly --outDir types"
+  "bugs": {
+    "url": "https://github.com/quazardous/quarkernel/issues"
   },
+  "homepage": "https://github.com/quazardous/quarkernel#readme",
   "keywords": [
     "event",
+    "events",
     "kernel",
-    "promise"
+    "promise",
+    "typescript",
+    "async",
+    "emitter",
+    "eventemitter",
+    "event-emitter",
+    "pubsub",
+    "publish-subscribe",
+    "dependency-ordering",
+    "shared-context",
+    "composite-events",
+    "wildcards",
+    "isomorphic"
   ],
-  "author": "quazardous <berliozdavid@gmail.com>",
-  "license": "MIT",
-  "devDependencies": {
-    "@babel/register": "^7.22.5",
-    "chai": "^4.3.7",
-    "core-js": "^3.29.1",
-    "mocha": "^9.2.0"
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./fsm": {
+      "types": "./dist/fsm.d.ts",
+      "import": "./dist/fsm.js",
+      "require": "./dist/fsm.cjs"
+    },
+    "./xstate": {
+      "types": "./dist/xstate.d.ts",
+      "import": "./dist/xstate.js",
+      "require": "./dist/xstate.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
   },
-  "dependencies": {
-    "toposort": "^2.0.2"
+  "scripts": {
+    "prebuild": "cp ../../README.md ./README.md && sed -i 's|(\\./docs/|(https://github.com/quazardous/quarkernel/blob/main/docs/|g; s|(\\./packages/|(https://github.com/quazardous/quarkernel/blob/main/packages/|g; s|(\\./benchmarks/|(https://github.com/quazardous/quarkernel/blob/main/benchmarks/|g; s|(\\./demos/|(https://github.com/quazardous/quarkernel/blob/main/demos/|g; s|(\\./LICENSE)|(https://github.com/quazardous/quarkernel/blob/main/LICENSE)|g' ./README.md",
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
   }
 }

package/LICENSE

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

package/src/index.js

@@ -1,3 +0,0 @@
-import { QuarKernel, QuarKernelEvent, QuarKernelLegacyAsyncFunctionWrapper } from './lib/QuarKernel.js';
-
-export { QuarKernel, QuarKernelEvent, QuarKernelLegacyAsyncFunctionWrapper };