automatick 0.0.1

package/dist/worker/protocol.d.cts

@@ -0,0 +1,59 @@
+import { EngineSnapshot } from '../engine.cjs';
+import '../sim.cjs';
+
+/**
+ * Wire protocol types for main ↔ worker communication.
+ *
+ * These types define the message shapes exchanged via postMessage.
+ * The actual serialization boundary (where `unknown` and `as` casts live)
+ * is in serialize.ts — not here.
+ */
+
+/** Messages sent from the main thread to the worker. */
+type MainToWorkerMessage<Params> = {
+    kind: 'init';
+    params: Params;
+    config: WorkerConfig;
+} | {
+    kind: 'play';
+} | {
+    kind: 'pause';
+} | {
+    kind: 'stop';
+} | {
+    kind: 'seek';
+    tick: number;
+} | {
+    kind: 'advance';
+    count: number;
+} | {
+    kind: 'setParams';
+    patch: Partial<Params>;
+} | {
+    kind: 'resetWith';
+    patch?: Partial<Params>;
+} | {
+    kind: 'destroy';
+};
+/** Messages sent from the worker to the main thread. */
+type WorkerToMainMessage<Data, Params> = {
+    kind: 'snapshot';
+    snapshot: EngineSnapshot<Data, Params>;
+} | {
+    kind: 'error';
+    error: {
+        message: string;
+        stack?: string;
+    };
+} | {
+    kind: 'ready';
+};
+/** Worker-specific configuration passed at init time. */
+type WorkerConfig = {
+    maxTime?: number;
+    delayMs?: number;
+    ticksPerFrame?: number;
+    snapshotIntervalMs?: number;
+};
+
+export type { MainToWorkerMessage, WorkerConfig, WorkerToMainMessage };

package/dist/worker/protocol.d.ts

@@ -0,0 +1,59 @@
+import { EngineSnapshot } from '../engine.js';
+import '../sim.js';
+
+/**
+ * Wire protocol types for main ↔ worker communication.
+ *
+ * These types define the message shapes exchanged via postMessage.
+ * The actual serialization boundary (where `unknown` and `as` casts live)
+ * is in serialize.ts — not here.
+ */
+
+/** Messages sent from the main thread to the worker. */
+type MainToWorkerMessage<Params> = {
+    kind: 'init';
+    params: Params;
+    config: WorkerConfig;
+} | {
+    kind: 'play';
+} | {
+    kind: 'pause';
+} | {
+    kind: 'stop';
+} | {
+    kind: 'seek';
+    tick: number;
+} | {
+    kind: 'advance';
+    count: number;
+} | {
+    kind: 'setParams';
+    patch: Partial<Params>;
+} | {
+    kind: 'resetWith';
+    patch?: Partial<Params>;
+} | {
+    kind: 'destroy';
+};
+/** Messages sent from the worker to the main thread. */
+type WorkerToMainMessage<Data, Params> = {
+    kind: 'snapshot';
+    snapshot: EngineSnapshot<Data, Params>;
+} | {
+    kind: 'error';
+    error: {
+        message: string;
+        stack?: string;
+    };
+} | {
+    kind: 'ready';
+};
+/** Worker-specific configuration passed at init time. */
+type WorkerConfig = {
+    maxTime?: number;
+    delayMs?: number;
+    ticksPerFrame?: number;
+    snapshotIntervalMs?: number;
+};
+
+export type { MainToWorkerMessage, WorkerConfig, WorkerToMainMessage };

package/dist/worker/workerRunner.cjs

@@ -0,0 +1,100 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/worker/workerRunner.ts
+var workerRunner_exports = {};
+__export(workerRunner_exports, {
+  createWorkerRunner: () => createWorkerRunner
+});
+module.exports = __toCommonJS(workerRunner_exports);
+
+// src/worker/serialize.ts
+function deserializeWorkerMessage(raw) {
+  return raw;
+}
+function serializeMainMessage(msg) {
+  return msg;
+}
+
+// src/worker/workerRunner.ts
+function createWorkerRunner(worker, config) {
+  const listeners = /* @__PURE__ */ new Set();
+  let currentSnapshot = {
+    data: void 0,
+    params: config.initialParams,
+    tick: 0,
+    status: "idle",
+    stepDurationMs: 0
+  };
+  let errorMessage = null;
+  function send(msg) {
+    worker.postMessage(serializeMainMessage(msg));
+  }
+  function emit() {
+    for (const l of listeners) {
+      l(currentSnapshot);
+    }
+  }
+  worker.onmessage = (event) => {
+    const msg = deserializeWorkerMessage(event.data);
+    switch (msg.kind) {
+      case "snapshot":
+        currentSnapshot = msg.snapshot;
+        emit();
+        break;
+      case "error":
+        errorMessage = msg.error.message;
+        currentSnapshot = { ...currentSnapshot, status: "stopped" };
+        emit();
+        break;
+      case "ready":
+        break;
+    }
+  };
+  worker.onerror = (event) => {
+    errorMessage = event.message ?? "Unknown worker error";
+    currentSnapshot = { ...currentSnapshot, status: "stopped" };
+    emit();
+  };
+  return {
+    getSnapshot: () => currentSnapshot,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    play: () => send({ kind: "play" }),
+    pause: () => send({ kind: "pause" }),
+    stop: () => send({ kind: "stop" }),
+    seek: (tick) => send({ kind: "seek", tick }),
+    advance: (count = 1) => send({ kind: "advance", count }),
+    setParams: (patch) => send({ kind: "setParams", patch }),
+    resetWith: (patch) => send({ kind: "resetWith", patch }),
+    destroy() {
+      listeners.clear();
+      send({ kind: "destroy" });
+      worker.terminate();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createWorkerRunner
+});

package/dist/worker/workerRunner.d.cts

@@ -0,0 +1,30 @@
+import { EngineSnapshot } from '../engine.cjs';
+import { WorkerConfig } from './protocol.cjs';
+import '../sim.cjs';
+
+/**
+ * Main-thread side of the worker runner.
+ *
+ * Creates a Web Worker, sends commands, and subscribes to snapshot updates.
+ * The worker owns the tick loop; this side is a passive subscriber.
+ */
+
+type WorkerRunnerConfig<Params> = {
+    initialParams: Params;
+    config: WorkerConfig;
+};
+type WorkerRunner<Data, Params> = {
+    getSnapshot: () => EngineSnapshot<Data, Params>;
+    subscribe: (listener: (snapshot: EngineSnapshot<Data, Params>) => void) => () => void;
+    play: () => void;
+    pause: () => void;
+    stop: () => void;
+    seek: (tick: number) => void;
+    advance: (count?: number) => void;
+    setParams: (patch: Partial<Params>) => void;
+    resetWith: (patch?: Partial<Params>) => void;
+    destroy: () => void;
+};
+declare function createWorkerRunner<Data, Params>(worker: Worker, config: WorkerRunnerConfig<Params>): WorkerRunner<Data, Params>;
+
+export { type WorkerRunner, type WorkerRunnerConfig, createWorkerRunner };

package/dist/worker/workerRunner.d.ts

@@ -0,0 +1,30 @@
+import { EngineSnapshot } from '../engine.js';
+import { WorkerConfig } from './protocol.js';
+import '../sim.js';
+
+/**
+ * Main-thread side of the worker runner.
+ *
+ * Creates a Web Worker, sends commands, and subscribes to snapshot updates.
+ * The worker owns the tick loop; this side is a passive subscriber.
+ */
+
+type WorkerRunnerConfig<Params> = {
+    initialParams: Params;
+    config: WorkerConfig;
+};
+type WorkerRunner<Data, Params> = {
+    getSnapshot: () => EngineSnapshot<Data, Params>;
+    subscribe: (listener: (snapshot: EngineSnapshot<Data, Params>) => void) => () => void;
+    play: () => void;
+    pause: () => void;
+    stop: () => void;
+    seek: (tick: number) => void;
+    advance: (count?: number) => void;
+    setParams: (patch: Partial<Params>) => void;
+    resetWith: (patch?: Partial<Params>) => void;
+    destroy: () => void;
+};
+declare function createWorkerRunner<Data, Params>(worker: Worker, config: WorkerRunnerConfig<Params>): WorkerRunner<Data, Params>;
+
+export { type WorkerRunner, type WorkerRunnerConfig, createWorkerRunner };

package/dist/worker/workerRunner.js

@@ -0,0 +1,73 @@
+// src/worker/serialize.ts
+function deserializeWorkerMessage(raw) {
+  return raw;
+}
+function serializeMainMessage(msg) {
+  return msg;
+}
+
+// src/worker/workerRunner.ts
+function createWorkerRunner(worker, config) {
+  const listeners = /* @__PURE__ */ new Set();
+  let currentSnapshot = {
+    data: void 0,
+    params: config.initialParams,
+    tick: 0,
+    status: "idle",
+    stepDurationMs: 0
+  };
+  let errorMessage = null;
+  function send(msg) {
+    worker.postMessage(serializeMainMessage(msg));
+  }
+  function emit() {
+    for (const l of listeners) {
+      l(currentSnapshot);
+    }
+  }
+  worker.onmessage = (event) => {
+    const msg = deserializeWorkerMessage(event.data);
+    switch (msg.kind) {
+      case "snapshot":
+        currentSnapshot = msg.snapshot;
+        emit();
+        break;
+      case "error":
+        errorMessage = msg.error.message;
+        currentSnapshot = { ...currentSnapshot, status: "stopped" };
+        emit();
+        break;
+      case "ready":
+        break;
+    }
+  };
+  worker.onerror = (event) => {
+    errorMessage = event.message ?? "Unknown worker error";
+    currentSnapshot = { ...currentSnapshot, status: "stopped" };
+    emit();
+  };
+  return {
+    getSnapshot: () => currentSnapshot,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    play: () => send({ kind: "play" }),
+    pause: () => send({ kind: "pause" }),
+    stop: () => send({ kind: "stop" }),
+    seek: (tick) => send({ kind: "seek", tick }),
+    advance: (count = 1) => send({ kind: "advance", count }),
+    setParams: (patch) => send({ kind: "setParams", patch }),
+    resetWith: (patch) => send({ kind: "resetWith", patch }),
+    destroy() {
+      listeners.clear();
+      send({ kind: "destroy" });
+      worker.terminate();
+    }
+  };
+}
+export {
+  createWorkerRunner
+};

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "automatick",
+  "version": "0.0.1",
+  "description": "State-machine engine for tick-based simulations in React",
+  "author": "jckr",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jckr/automatick.git"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup src/engine.ts src/sim.ts src/worker/workerRunner.ts src/worker/createSimWorker.ts src/worker/protocol.ts src/react/Simulation.tsx src/react/hooks.ts src/react/useSimulationCanvas.ts src/react/PerformanceOverlay.tsx src/react/SimulationContext.tsx src/react/EngineContext.tsx src/react/SimulationControls.tsx src/react/controlPrimitives.tsx src/react/stableCallback.ts --format esm,cjs --dts --clean --external react --external react-dom --external react/jsx-runtime",
+    "test": "vitest run"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/engine.d.ts",
+      "import": "./dist/engine.js",
+      "require": "./dist/engine.cjs"
+    },
+    "./sim": {
+      "types": "./dist/sim.d.ts",
+      "import": "./dist/sim.js",
+      "require": "./dist/sim.cjs"
+    },
+    "./worker/runner": {
+      "types": "./dist/worker/workerRunner.d.ts",
+      "import": "./dist/worker/workerRunner.js",
+      "require": "./dist/worker/workerRunner.cjs"
+    },
+    "./worker/create": {
+      "types": "./dist/worker/createSimWorker.d.ts",
+      "import": "./dist/worker/createSimWorker.js",
+      "require": "./dist/worker/createSimWorker.cjs"
+    },
+    "./worker/protocol": {
+      "types": "./dist/worker/protocol.d.ts",
+      "import": "./dist/worker/protocol.js",
+      "require": "./dist/worker/protocol.cjs"
+    },
+    "./react/simulation": {
+      "types": "./dist/react/Simulation.d.ts",
+      "import": "./dist/react/Simulation.js",
+      "require": "./dist/react/Simulation.cjs"
+    },
+    "./react/hooks": {
+      "types": "./dist/react/hooks.d.ts",
+      "import": "./dist/react/hooks.js",
+      "require": "./dist/react/hooks.cjs"
+    },
+    "./react/controls": {
+      "types": "./dist/react/SimulationControls.d.ts",
+      "import": "./dist/react/SimulationControls.js",
+      "require": "./dist/react/SimulationControls.cjs"
+    },
+    "./react/control-primitives": {
+      "types": "./dist/react/controlPrimitives.d.ts",
+      "import": "./dist/react/controlPrimitives.js",
+      "require": "./dist/react/controlPrimitives.cjs"
+    },
+    "./react/context": {
+      "types": "./dist/react/SimulationContext.d.ts",
+      "import": "./dist/react/SimulationContext.js",
+      "require": "./dist/react/SimulationContext.cjs"
+    },
+    "./react/performance": {
+      "types": "./dist/react/PerformanceOverlay.d.ts",
+      "import": "./dist/react/PerformanceOverlay.js",
+      "require": "./dist/react/PerformanceOverlay.cjs"
+    },
+    "./react/canvas": {
+      "types": "./dist/react/useSimulationCanvas.d.ts",
+      "import": "./dist/react/useSimulationCanvas.js",
+      "require": "./dist/react/useSimulationCanvas.cjs"
+    },
+    "./react/stable-callback": {
+      "types": "./dist/react/stableCallback.d.ts",
+      "import": "./dist/react/stableCallback.js",
+      "require": "./dist/react/stableCallback.cjs"
+    }
+  }
+}