automatick 0.0.1

package/dist/react/SimulationControls.js

@@ -0,0 +1,80 @@
+import {
+  ParamRangeField,
+  ParamToggleField,
+  PlayPauseButton,
+  ResetButton,
+  StepButton,
+  StopButton,
+  TickReadout,
+  TickSeekSlider
+} from "../chunk-HTH6FQ7C.js";
+import "../chunk-AIKB2FNR.js";
+import "../chunk-66FUVAAG.js";
+
+// src/react/SimulationControls.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function asArray(maybeArray) {
+  if (!maybeArray) return [];
+  return Array.isArray(maybeArray) ? maybeArray : [maybeArray];
+}
+var panelStyle = {
+  display: "flex",
+  flexDirection: "column",
+  gap: 10,
+  padding: 12,
+  border: "1px solid rgba(0,0,0,0.15)",
+  borderRadius: 8
+};
+function StandardControls(props) {
+  const controls = asArray(props.controls);
+  const maxTime = props.maxTime;
+  const canSeek = maxTime !== void 0 && Number.isFinite(maxTime);
+  return /* @__PURE__ */ jsxs("div", { style: panelStyle, children: [
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        style: {
+          display: "flex",
+          gap: 8,
+          alignItems: "center",
+          flexWrap: "wrap"
+        },
+        children: [
+          /* @__PURE__ */ jsx(PlayPauseButton, {}),
+          props.showStopButton ? /* @__PURE__ */ jsx(StopButton, {}) : null,
+          props.showStepButton ? /* @__PURE__ */ jsx(StepButton, {}) : null,
+          props.showResetButton !== false ? /* @__PURE__ */ jsx(ResetButton, {}) : null,
+          /* @__PURE__ */ jsx(TickReadout, {})
+        ]
+      }
+    ),
+    canSeek ? /* @__PURE__ */ jsx(TickSeekSlider, { min: props.minTime, max: maxTime }) : null,
+    controls.length ? /* @__PURE__ */ jsx("div", { style: { display: "flex", flexDirection: "column", gap: 10 }, children: controls.map((c) => {
+      const key = `${c.type ?? "range"}-${c.param}`;
+      if (c.type === "toggle") {
+        return /* @__PURE__ */ jsx(
+          ParamToggleField,
+          {
+            param: c.param,
+            label: c.label
+          },
+          key
+        );
+      }
+      return /* @__PURE__ */ jsx(
+        ParamRangeField,
+        {
+          param: c.param,
+          label: c.label,
+          min: c.min,
+          max: c.max,
+          step: c.step
+        },
+        key
+      );
+    }) }) : null
+  ] });
+}
+export {
+  StandardControls
+};

package/dist/react/controlPrimitives.cjs

@@ -0,0 +1,247 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/controlPrimitives.tsx
+var controlPrimitives_exports = {};
+__export(controlPrimitives_exports, {
+  ParamRangeField: () => ParamRangeField,
+  ParamToggleField: () => ParamToggleField,
+  PlayPauseButton: () => PlayPauseButton,
+  ResetButton: () => ResetButton,
+  StepButton: () => StepButton,
+  StopButton: () => StopButton,
+  TickReadout: () => TickReadout,
+  TickSeekSlider: () => TickSeekSlider
+});
+module.exports = __toCommonJS(controlPrimitives_exports);
+
+// src/react/hooks.ts
+var import_react2 = __toESM(require("react"), 1);
+
+// src/react/SimulationContext.tsx
+var import_react = __toESM(require("react"), 1);
+var SimulationContext = import_react.default.createContext(null);
+
+// src/react/hooks.ts
+function useSimulation() {
+  const ctx = import_react2.default.useContext(SimulationContext);
+  if (!ctx) {
+    throw new Error("useSimulation must be used within a <Simulation>");
+  }
+  return ctx;
+}
+
+// src/react/controlPrimitives.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var btnStyle = {
+  padding: "6px 12px",
+  borderRadius: 6,
+  border: "1px solid rgba(0,0,0,0.2)",
+  background: "#fff",
+  cursor: "pointer"
+};
+function PlayPauseButton(props) {
+  const { status, play, pause } = useSimulation();
+  const { playingLabel = "Pause", pausedLabel = "Play", disabled } = props;
+  const isPlaying = status === "playing";
+  const canPlay = status === "idle" || status === "paused";
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "button",
+    {
+      type: "button",
+      style: btnStyle,
+      onClick: isPlaying ? pause : play,
+      disabled: disabled ?? (!canPlay && !isPlaying),
+      children: isPlaying ? playingLabel : pausedLabel
+    }
+  );
+}
+function StopButton(props) {
+  const { status, stop } = useSimulation();
+  const canStop = status === "playing" || status === "paused";
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "button",
+    {
+      type: "button",
+      style: btnStyle,
+      onClick: stop,
+      disabled: props.disabled ?? !canStop,
+      children: props.label ?? "Stop"
+    }
+  );
+}
+function StepButton(props) {
+  const { status, advance } = useSimulation();
+  const ticks = props.ticks ?? 1;
+  const canStep = status === "idle" || status === "paused";
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "button",
+    {
+      type: "button",
+      style: btnStyle,
+      onClick: () => advance(ticks),
+      disabled: props.disabled ?? !canStep,
+      title: "Advance one or more ticks while paused",
+      children: props.label ?? `Step${ticks > 1 ? ` (${ticks})` : ""}`
+    }
+  );
+}
+function ResetButton(props) {
+  const { resetWith } = useSimulation();
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", style: btnStyle, onClick: () => resetWith(), children: props.label ?? "Reset" });
+}
+function TickSeekSlider(props) {
+  const { tick, status, seek } = useSimulation();
+  const min = props.min ?? 0;
+  const max = props.max;
+  const disabled = status === "stopped";
+  if (!Number.isFinite(max)) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    "div",
+    {
+      style: {
+        display: "flex",
+        gap: 10,
+        alignItems: "center",
+        width: "100%"
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "input",
+          {
+            type: "range",
+            min,
+            max,
+            step: 1,
+            value: tick,
+            onChange: (e) => seek(Number(e.target.value)),
+            disabled,
+            style: { flex: 1 }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "span",
+          {
+            style: {
+              fontFamily: "monospace",
+              opacity: 0.8,
+              minWidth: 48,
+              textAlign: "right"
+            },
+            children: tick
+          }
+        )
+      ]
+    }
+  );
+}
+function ParamRangeField(props) {
+  const { params, setParams } = useSimulation();
+  const label = props.label ?? props.param;
+  const raw = params[props.param];
+  const numericValue = Number(raw);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    "label",
+    {
+      style: {
+        display: "flex",
+        gap: 10,
+        alignItems: "center",
+        width: "100%"
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: { minWidth: 120, opacity: 0.9 }, children: label }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "input",
+          {
+            type: "range",
+            min: props.min,
+            max: props.max,
+            step: props.step ?? 1,
+            value: Number.isFinite(numericValue) ? numericValue : props.min,
+            onChange: (e) => {
+              const v = Number(e.target.value);
+              setParams({ [props.param]: v });
+            },
+            style: { flex: 1 }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "span",
+          {
+            style: {
+              width: 72,
+              textAlign: "right",
+              fontFamily: "monospace",
+              opacity: 0.8
+            },
+            children: numericValue
+          }
+        )
+      ]
+    }
+  );
+}
+function ParamToggleField(props) {
+  const { params, setParams } = useSimulation();
+  const label = props.label ?? props.param;
+  const checked = Boolean(params[props.param]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("label", { style: { display: "flex", gap: 10, alignItems: "center" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: { minWidth: 120, opacity: 0.9 }, children: label }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "input",
+      {
+        type: "checkbox",
+        checked,
+        onChange: (e) => {
+          setParams({ [props.param]: e.target.checked });
+        }
+      }
+    )
+  ] });
+}
+function TickReadout(props) {
+  const { tick } = useSimulation();
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: { fontFamily: "monospace", opacity: 0.85 }, children: [
+    props.prefix ?? "",
+    "tick: ",
+    tick
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ParamRangeField,
+  ParamToggleField,
+  PlayPauseButton,
+  ResetButton,
+  StepButton,
+  StopButton,
+  TickReadout,
+  TickSeekSlider
+});

package/dist/react/controlPrimitives.d.cts

@@ -0,0 +1,45 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type PlayPauseButtonProps = {
+    playingLabel?: string;
+    pausedLabel?: string;
+    disabled?: boolean;
+};
+declare function PlayPauseButton(props: PlayPauseButtonProps): react_jsx_runtime.JSX.Element;
+declare function StopButton(props: {
+    label?: string;
+    disabled?: boolean;
+}): react_jsx_runtime.JSX.Element;
+type StepButtonProps = {
+    ticks?: number;
+    label?: string;
+    disabled?: boolean;
+};
+declare function StepButton(props: StepButtonProps): react_jsx_runtime.JSX.Element;
+declare function ResetButton(props: {
+    label?: string;
+}): react_jsx_runtime.JSX.Element;
+type TickSeekSliderProps = {
+    min?: number;
+    max: number;
+};
+declare function TickSeekSlider(props: TickSeekSliderProps): react_jsx_runtime.JSX.Element | null;
+type ParamRangeFieldProps<Params extends Record<string, unknown>> = {
+    param: Extract<keyof Params, string>;
+    label?: string;
+    min: number;
+    max: number;
+    step?: number;
+};
+declare function ParamRangeField<Params extends Record<string, unknown> = Record<string, unknown>>(props: ParamRangeFieldProps<Params>): react_jsx_runtime.JSX.Element;
+type ParamToggleFieldProps<Params extends Record<string, unknown>> = {
+    param: Extract<keyof Params, string>;
+    label?: string;
+};
+declare function ParamToggleField<Params extends Record<string, unknown> = Record<string, unknown>>(props: ParamToggleFieldProps<Params>): react_jsx_runtime.JSX.Element;
+type TickReadoutProps = {
+    prefix?: string;
+};
+declare function TickReadout(props: TickReadoutProps): react_jsx_runtime.JSX.Element;
+
+export { ParamRangeField, type ParamRangeFieldProps, ParamToggleField, type ParamToggleFieldProps, PlayPauseButton, type PlayPauseButtonProps, ResetButton, StepButton, type StepButtonProps, StopButton, TickReadout, type TickReadoutProps, TickSeekSlider, type TickSeekSliderProps };

package/dist/react/controlPrimitives.d.ts

@@ -0,0 +1,45 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type PlayPauseButtonProps = {
+    playingLabel?: string;
+    pausedLabel?: string;
+    disabled?: boolean;
+};
+declare function PlayPauseButton(props: PlayPauseButtonProps): react_jsx_runtime.JSX.Element;
+declare function StopButton(props: {
+    label?: string;
+    disabled?: boolean;
+}): react_jsx_runtime.JSX.Element;
+type StepButtonProps = {
+    ticks?: number;
+    label?: string;
+    disabled?: boolean;
+};
+declare function StepButton(props: StepButtonProps): react_jsx_runtime.JSX.Element;
+declare function ResetButton(props: {
+    label?: string;
+}): react_jsx_runtime.JSX.Element;
+type TickSeekSliderProps = {
+    min?: number;
+    max: number;
+};
+declare function TickSeekSlider(props: TickSeekSliderProps): react_jsx_runtime.JSX.Element | null;
+type ParamRangeFieldProps<Params extends Record<string, unknown>> = {
+    param: Extract<keyof Params, string>;
+    label?: string;
+    min: number;
+    max: number;
+    step?: number;
+};
+declare function ParamRangeField<Params extends Record<string, unknown> = Record<string, unknown>>(props: ParamRangeFieldProps<Params>): react_jsx_runtime.JSX.Element;
+type ParamToggleFieldProps<Params extends Record<string, unknown>> = {
+    param: Extract<keyof Params, string>;
+    label?: string;
+};
+declare function ParamToggleField<Params extends Record<string, unknown> = Record<string, unknown>>(props: ParamToggleFieldProps<Params>): react_jsx_runtime.JSX.Element;
+type TickReadoutProps = {
+    prefix?: string;
+};
+declare function TickReadout(props: TickReadoutProps): react_jsx_runtime.JSX.Element;
+
+export { ParamRangeField, type ParamRangeFieldProps, ParamToggleField, type ParamToggleFieldProps, PlayPauseButton, type PlayPauseButtonProps, ResetButton, StepButton, type StepButtonProps, StopButton, TickReadout, type TickReadoutProps, TickSeekSlider, type TickSeekSliderProps };

package/dist/react/controlPrimitives.js

@@ -0,0 +1,22 @@
+import {
+  ParamRangeField,
+  ParamToggleField,
+  PlayPauseButton,
+  ResetButton,
+  StepButton,
+  StopButton,
+  TickReadout,
+  TickSeekSlider
+} from "../chunk-HTH6FQ7C.js";
+import "../chunk-AIKB2FNR.js";
+import "../chunk-66FUVAAG.js";
+export {
+  ParamRangeField,
+  ParamToggleField,
+  PlayPauseButton,
+  ResetButton,
+  StepButton,
+  StopButton,
+  TickReadout,
+  TickSeekSlider
+};

package/dist/react/hooks.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/hooks.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useSimulation: () => useSimulation
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_react2 = __toESM(require("react"), 1);
+
+// src/react/SimulationContext.tsx
+var import_react = __toESM(require("react"), 1);
+var SimulationContext = import_react.default.createContext(null);
+
+// src/react/hooks.ts
+function useSimulation() {
+  const ctx = import_react2.default.useContext(SimulationContext);
+  if (!ctx) {
+    throw new Error("useSimulation must be used within a <Simulation>");
+  }
+  return ctx;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useSimulation
+});

package/dist/react/hooks.d.cts

@@ -0,0 +1,26 @@
+import { SimulationContextValue } from './SimulationContext.cjs';
+import { SimModule } from '../sim.cjs';
+import 'react';
+import '../engine.cjs';
+
+/**
+ * Helper type: extract Data and Params from a SimModule type, or use them directly.
+ *
+ * Supports two usage patterns:
+ *   useSimulation<typeof mySim>()          — infers Data & Params from the module
+ *   useSimulation<MyData, MyParams>()      — explicit type parameters
+ */
+type InferSimTypes<T, FallbackParams = unknown> = T extends SimModule<infer D, infer P> ? SimulationContextValue<D, P> : SimulationContextValue<T, FallbackParams>;
+/**
+ * Read simulation state and actions from the nearest `<Simulation>` provider.
+ *
+ * @example
+ * // Infer types from the sim module:
+ * const { data, tick, play } = useSimulation<typeof counterSim>();
+ *
+ * // Or provide types explicitly:
+ * const { data } = useSimulation<{ count: number }, { increment: number }>();
+ */
+declare function useSimulation<T = unknown, FallbackParams = unknown>(): InferSimTypes<T, FallbackParams>;
+
+export { useSimulation };

package/dist/react/hooks.d.ts

@@ -0,0 +1,26 @@
+import { SimulationContextValue } from './SimulationContext.js';
+import { SimModule } from '../sim.js';
+import 'react';
+import '../engine.js';
+
+/**
+ * Helper type: extract Data and Params from a SimModule type, or use them directly.
+ *
+ * Supports two usage patterns:
+ *   useSimulation<typeof mySim>()          — infers Data & Params from the module
+ *   useSimulation<MyData, MyParams>()      — explicit type parameters
+ */
+type InferSimTypes<T, FallbackParams = unknown> = T extends SimModule<infer D, infer P> ? SimulationContextValue<D, P> : SimulationContextValue<T, FallbackParams>;
+/**
+ * Read simulation state and actions from the nearest `<Simulation>` provider.
+ *
+ * @example
+ * // Infer types from the sim module:
+ * const { data, tick, play } = useSimulation<typeof counterSim>();
+ *
+ * // Or provide types explicitly:
+ * const { data } = useSimulation<{ count: number }, { increment: number }>();
+ */
+declare function useSimulation<T = unknown, FallbackParams = unknown>(): InferSimTypes<T, FallbackParams>;
+
+export { useSimulation };

package/dist/react/hooks.js

@@ -0,0 +1,7 @@
+import {
+  useSimulation
+} from "../chunk-AIKB2FNR.js";
+import "../chunk-66FUVAAG.js";
+export {
+  useSimulation
+};

package/dist/react/stableCallback.cjs

@@ -0,0 +1,47 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/stableCallback.ts
+var stableCallback_exports = {};
+__export(stableCallback_exports, {
+  useStableCallback: () => useStableCallback
+});
+module.exports = __toCommonJS(stableCallback_exports);
+var import_react = __toESM(require("react"), 1);
+function useStableCallback(fn) {
+  const fnRef = import_react.default.useRef(fn);
+  import_react.default.useEffect(() => {
+    fnRef.current = fn;
+  });
+  return import_react.default.useCallback((...args) => fnRef.current(...args), []);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useStableCallback
+});

package/dist/react/stableCallback.d.cts

@@ -0,0 +1,3 @@
+declare function useStableCallback<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult;
+
+export { useStableCallback };

package/dist/react/stableCallback.d.ts

@@ -0,0 +1,3 @@
+declare function useStableCallback<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult;
+
+export { useStableCallback };

package/dist/react/stableCallback.js

@@ -0,0 +1,6 @@
+import {
+  useStableCallback
+} from "../chunk-SK5SHIWY.js";
+export {
+  useStableCallback
+};