@automatajs/core 0.2.0

package/dist/engine.js

@@ -0,0 +1,255 @@
+import { Grid } from "./grid";
+import { Renderer } from "./renderer";
+import { Interaction } from "./interaction";
+import { gameOfLife } from "./presets";
+/**
+ * Main Automata engine class.
+ * Orchestrates grid, renderer, simulation loop, and interaction.
+ *
+ * Usage:
+ * ```ts
+ * const ca = new Automata(canvasElement, {
+ *   cols: 80,
+ *   rows: 60,
+ *   fps: 10,
+ *   rule: gameOfLife,
+ * });
+ * ca.randomize(0.3);
+ * ca.play();
+ * ```
+ */
+export class Automata {
+    constructor(canvas, options = {}) {
+        this._generation = 0;
+        this._playing = false;
+        this.animFrameId = null;
+        this.lastFrameTime = 0;
+        // Callbacks
+        this.onStepCallbacks = [];
+        const cols = options.cols ?? 80;
+        const rows = options.rows ?? 60;
+        this.grid = new Grid(cols, rows, {
+            wrap: options.wrap ?? true,
+            neighborhood: options.neighborhood ?? "moore",
+        });
+        this.renderer = new Renderer(canvas, {
+            aliveColor: options.aliveColor,
+            deadColor: options.deadColor,
+            backgroundColor: options.backgroundColor,
+            gridLineColor: options.gridLineColor,
+            showGridLines: options.showGridLines,
+            cellSize: options.cellSize,
+        });
+        this.interaction = new Interaction(canvas, this.renderer, this.grid);
+        this.rule = options.rule ?? gameOfLife;
+        this._fps = options.fps ?? 10;
+        // Set style function if provided
+        if (options.style) {
+            this.renderer.styleFunction = options.style;
+        }
+        // Save initial state
+        this.initialGrid = new Uint8Array(cols * rows);
+        // Auto-resize canvas
+        this.renderer.resizeToContainer();
+        // Initial render
+        this.render();
+    }
+    // ─── Grid Management ───
+    /** Get the underlying grid. */
+    getGrid() {
+        return this.grid;
+    }
+    /** Create a new grid, replacing the current one. */
+    createGrid(cols, rows) {
+        this.grid = new Grid(cols, rows, {
+            wrap: this.grid.wrap,
+            neighborhood: this.grid.neighborhood,
+        });
+        this.initialGrid = new Uint8Array(cols * rows);
+        this.interaction.setGrid(this.grid);
+        this._generation = 0;
+        this.render();
+    }
+    /** Clear the grid. */
+    clearGrid() {
+        this.grid.clear();
+        this._generation = 0;
+        this.render();
+    }
+    /** Randomize the grid. */
+    randomize(density = 0.3) {
+        this.grid.randomize(density);
+        this.initialGrid.set(this.grid.current);
+        this._generation = 0;
+        this.render();
+    }
+    /** Get cell state. */
+    getCell(x, y) {
+        return this.grid.get(x, y);
+    }
+    /** Set cell state. */
+    setCell(x, y, state) {
+        this.grid.set(x, y, state);
+        this.render();
+    }
+    /** Toggle cell state. */
+    toggleCell(x, y) {
+        this.grid.toggle(x, y);
+        this.render();
+    }
+    /** Stamp a pattern onto the grid. */
+    stamp(pattern, offsetX, offsetY) {
+        this.grid.stamp(pattern, offsetX, offsetY);
+        this.render();
+    }
+    // ─── Simulation ───
+    /** Set the rule function. */
+    setRule(rule) {
+        this.rule = rule;
+    }
+    /** Set the style function for per-cell coloring. Pass null to reset to default. */
+    setStyle(style) {
+        this.renderer.styleFunction = style;
+        this.render();
+    }
+    /** Advance one generation. */
+    step() {
+        this.grid.step(this.rule);
+        this._generation++;
+        this.render();
+        for (const cb of this.onStepCallbacks) {
+            cb(this._generation);
+        }
+    }
+    /** Start the simulation loop. */
+    play() {
+        if (this._playing)
+            return;
+        this._playing = true;
+        this.lastFrameTime = performance.now();
+        this.loop();
+    }
+    /** Pause the simulation. */
+    pause() {
+        this._playing = false;
+        if (this.animFrameId !== null) {
+            cancelAnimationFrame(this.animFrameId);
+            this.animFrameId = null;
+        }
+    }
+    /** Reset to initial state (from last randomize or manual setup). */
+    reset() {
+        this.pause();
+        this.grid.current.set(this.initialGrid);
+        this.grid.next.fill(0);
+        this._generation = 0;
+        this.render();
+    }
+    /** Save the current grid state as the initial state. */
+    saveState() {
+        this.initialGrid.set(this.grid.current);
+    }
+    /** Is the simulation running? */
+    get playing() {
+        return this._playing;
+    }
+    /** Current generation count. */
+    get generation() {
+        return this._generation;
+    }
+    /** Get the current FPS setting. */
+    get fps() {
+        return this._fps;
+    }
+    /** Set the target frames per second. */
+    setFrameRate(fps) {
+        this._fps = Math.max(1, Math.min(120, fps));
+    }
+    /** Population count. */
+    get population() {
+        return this.grid.population();
+    }
+    /** Grid dimensions. */
+    get cols() {
+        return this.grid.cols;
+    }
+    get rows() {
+        return this.grid.rows;
+    }
+    /** Register a callback after each step. */
+    onStep(fn) {
+        this.onStepCallbacks.push(fn);
+    }
+    // ─── Rendering ───
+    /** Force a re-render. */
+    render() {
+        this.renderer.render(this.grid);
+    }
+    /** Resize the canvas to fit its container. */
+    resize() {
+        this.renderer.resizeToContainer();
+        this.render();
+    }
+    /** Set alive cell color. */
+    setAliveColor(color) {
+        this.renderer.aliveColor = color;
+        this.render();
+    }
+    /** Set dead cell color. */
+    setDeadColor(color) {
+        this.renderer.deadColor = color;
+        this.render();
+    }
+    /** Set background color. */
+    setBackground(color) {
+        this.renderer.backgroundColor = color;
+        this.render();
+    }
+    /** Toggle grid lines on/off. */
+    toggleGridLines(show) {
+        this.renderer.showGridLines = show ?? !this.renderer.showGridLines;
+        this.render();
+    }
+    /** Export canvas as data URL. */
+    toDataURL(format) {
+        return this.renderer.toDataURL(format);
+    }
+    // ─── Interaction ───
+    /** Set custom cell click handler. */
+    onCellClick(fn) {
+        this.interaction.onCellClick(fn);
+    }
+    /** Set custom cell drag handler. */
+    onCellDrag(fn) {
+        this.interaction.onCellDrag(fn);
+    }
+    /** Enable mouse/touch interaction. */
+    enableInteraction() {
+        this.interaction.enable();
+    }
+    /** Disable mouse/touch interaction. */
+    disableInteraction() {
+        this.interaction.disable();
+    }
+    // ─── Lifecycle ───
+    /** Clean up all resources. */
+    destroy() {
+        this.pause();
+        this.interaction.destroy();
+    }
+    // ─── Private ───
+    loop() {
+        if (!this._playing)
+            return;
+        this.animFrameId = requestAnimationFrame((now) => {
+            const interval = 1000 / this._fps;
+            const elapsed = now - this.lastFrameTime;
+            if (elapsed >= interval) {
+                this.lastFrameTime = now - (elapsed % interval);
+                this.step();
+            }
+            this.loop();
+        });
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,QAAQ;IAenB,YAAY,MAAyB,EAAE,UAA2B,EAAE;QAR5D,gBAAW,GAAW,CAAC,CAAC;QACxB,aAAQ,GAAY,KAAK,CAAC;QAC1B,gBAAW,GAAkB,IAAI,CAAC;QAClC,kBAAa,GAAW,CAAC,CAAC;QAElC,YAAY;QACJ,oBAAe,GAAiC,EAAE,CAAC;QAGzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAEhC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,OAAO;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE;YACnC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;QAE9B,iCAAiC;QACjC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9C,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAE/C,qBAAqB;QACrB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAElC,iBAAiB;QACjB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,0BAA0B;IAE1B,+BAA+B;IAC/B,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,oDAAoD;IACpD,UAAU,CAAC,IAAY,EAAE,IAAY;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;SACrC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,sBAAsB;IACtB,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,0BAA0B;IAC1B,SAAS,CAAC,UAAkB,GAAG;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,CAAS,EAAE,CAAS;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,CAAS,EAAE,CAAS,EAAE,KAAa;QACzC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,yBAAyB;IACzB,UAAU,CAAC,CAAS,EAAE,CAAS;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,OAAmB,EAAE,OAAgB,EAAE,OAAgB;QAC3D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,qBAAqB;IAErB,6BAA6B;IAC7B,OAAO,CAAC,IAAkB;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,KAA2B;QAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,GAAG,KAAK,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,8BAA8B;IAC9B,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACtC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI;QACF,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9B,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,wDAAwD;IACxD,SAAS;QACP,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,iCAAiC;IACjC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,gCAAgC;IAChC,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,mCAAmC;IACnC,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,wCAAwC;IACxC,YAAY,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,wBAAwB;IACxB,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,2CAA2C;IAC3C,MAAM,CAAC,EAAyB;QAC9B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,oBAAoB;IAEpB,yBAAyB;IACzB,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,8CAA8C;IAC9C,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,4BAA4B;IAC5B,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,2BAA2B;IAC3B,YAAY,CAAC,KAAa;QACxB,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,4BAA4B;IAC5B,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,gCAAgC;IAChC,eAAe,CAAC,IAAc;QAC5B,IAAI,CAAC,QAAQ,CAAC,aAAa,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QACnE,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,iCAAiC;IACjC,SAAS,CAAC,MAAuB;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,sBAAsB;IAEtB,qCAAqC;IACrC,WAAW,CAAC,EAAgB;QAC1B,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,oCAAoC;IACpC,UAAU,CAAC,EAAgB;QACzB,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,sCAAsC;IACtC,iBAAiB;QACf,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,uCAAuC;IACvC,kBAAkB;QAChB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,oBAAoB;IAEpB,8BAA8B;IAC9B,OAAO;QACL,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,kBAAkB;IAEV,IAAI;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,IAAI,CAAC,WAAW,GAAG,qBAAqB,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YAClC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;YAEzC,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;gBACxB,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;gBAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC;YAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/grid.d.ts

@@ -0,0 +1,55 @@
+import type { GridOptions, NeighborhoodType, RuleFunction, CellContext } from "./types";
+/**
+ * Double-buffered grid backed by Uint8Array.
+ * Supports toroidal wrapping and Moore/Von Neumann neighborhoods.
+ */
+export declare class Grid {
+    readonly cols: number;
+    readonly rows: number;
+    readonly wrap: boolean;
+    readonly neighborhood: NeighborhoodType;
+    /** Current generation buffer */
+    current: Uint8Array;
+    /** Next generation buffer (written to during step, then swapped) */
+    next: Uint8Array;
+    private mooreOffsets;
+    private vonNeumannOffsets;
+    constructor(cols: number, rows: number, options?: GridOptions);
+    /** Get cell state at (x, y). Returns 0 for out-of-bounds when wrap=false. */
+    get(x: number, y: number): number;
+    /** Set cell state at (x, y) in the current buffer. */
+    set(x: number, y: number, state: number): void;
+    /** Toggle cell at (x, y) between 0 and 1. */
+    toggle(x: number, y: number): void;
+    /** Get individual neighbor state values for the cell at (x, y). */
+    getNeighborValues(x: number, y: number): number[];
+    /** Count alive neighbors for the cell at (x, y). */
+    countNeighbors(x: number, y: number): number;
+    /** Build a CellContext for the cell at (x, y). */
+    buildContext(x: number, y: number): CellContext;
+    /**
+     * Detect whether a rule function uses the new CellContext signature
+     * or the legacy positional signature.
+     *
+     * New-style: function(ctx) — 1 parameter
+     * Legacy:    function(neighbors, currentState, x, y, grid) — 5 parameters
+     */
+    private static isLegacyRule;
+    /** Apply rule to all cells: write to next buffer, then swap. */
+    step(rule: RuleFunction): void;
+    /** Swap current and next buffers. */
+    private swap;
+    /** Clear both buffers. */
+    clear(): void;
+    /** Randomize the grid with a given density (0–1, default 0.3). */
+    randomize(density?: number): void;
+    /** Return total number of alive cells. */
+    population(): number;
+    /** Create a deep copy of this grid. */
+    clone(): Grid;
+    /** Load a 2D pattern array at the given offset. */
+    stamp(pattern: number[][], offsetX?: number, offsetY?: number): void;
+    /** Export current state as a 2D array. */
+    toArray(): number[][];
+}
+//# sourceMappingURL=grid.d.ts.map

package/dist/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../src/grid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExF;;;GAGG;AACH,qBAAa,IAAI;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAExC,gCAAgC;IAChC,OAAO,EAAE,UAAU,CAAC;IACpB,oEAAoE;IACpE,IAAI,EAAE,UAAU,CAAC;IAGjB,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,iBAAiB,CAKvB;gBAEU,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB;IASjE,6EAA6E;IAC7E,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAUjC,sDAAsD;IACtD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9C,6CAA6C;IAC7C,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMlC,mEAAmE;IACnE,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAajD,oDAAoD;IACpD,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAa5C,kDAAkD;IAClD,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW;IAmB/C;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B,gEAAgE;IAChE,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA0B9B,qCAAqC;IACrC,OAAO,CAAC,IAAI;IAMZ,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAKb,kEAAkE;IAClE,SAAS,CAAC,OAAO,GAAE,MAAY,GAAG,IAAI;IAMtC,0CAA0C;IAC1C,UAAU,IAAI,MAAM;IAQpB,uCAAuC;IACvC,KAAK,IAAI,IAAI;IAUb,mDAAmD;IACnD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAE,MAAU,EAAE,OAAO,GAAE,MAAU,GAAG,IAAI;IAY1E,0CAA0C;IAC1C,OAAO,IAAI,MAAM,EAAE,EAAE;CAWtB"}

package/dist/grid.js

@@ -0,0 +1,186 @@
+/**
+ * Double-buffered grid backed by Uint8Array.
+ * Supports toroidal wrapping and Moore/Von Neumann neighborhoods.
+ */
+export class Grid {
+    constructor(cols, rows, options = {}) {
+        // Precomputed neighbor offset tables
+        this.mooreOffsets = [
+            [-1, -1],
+            [0, -1],
+            [1, -1],
+            [-1, 0],
+            [1, 0],
+            [-1, 1],
+            [0, 1],
+            [1, 1],
+        ];
+        this.vonNeumannOffsets = [
+            [0, -1],
+            [-1, 0],
+            [1, 0],
+            [0, 1],
+        ];
+        this.cols = cols;
+        this.rows = rows;
+        this.wrap = options.wrap ?? true;
+        this.neighborhood = options.neighborhood ?? "moore";
+        this.current = new Uint8Array(cols * rows);
+        this.next = new Uint8Array(cols * rows);
+    }
+    /** Get cell state at (x, y). Returns 0 for out-of-bounds when wrap=false. */
+    get(x, y) {
+        if (this.wrap) {
+            x = ((x % this.cols) + this.cols) % this.cols;
+            y = ((y % this.rows) + this.rows) % this.rows;
+        }
+        else if (x < 0 || x >= this.cols || y < 0 || y >= this.rows) {
+            return 0;
+        }
+        return this.current[y * this.cols + x];
+    }
+    /** Set cell state at (x, y) in the current buffer. */
+    set(x, y, state) {
+        if (x < 0 || x >= this.cols || y < 0 || y >= this.rows)
+            return;
+        this.current[y * this.cols + x] = state;
+    }
+    /** Toggle cell at (x, y) between 0 and 1. */
+    toggle(x, y) {
+        if (x < 0 || x >= this.cols || y < 0 || y >= this.rows)
+            return;
+        const idx = y * this.cols + x;
+        this.current[idx] = this.current[idx] ? 0 : 1;
+    }
+    /** Get individual neighbor state values for the cell at (x, y). */
+    getNeighborValues(x, y) {
+        const offsets = this.neighborhood === "moore"
+            ? this.mooreOffsets
+            : this.vonNeumannOffsets;
+        const values = [];
+        for (const [dx, dy] of offsets) {
+            values.push(this.get(x + dx, y + dy));
+        }
+        return values;
+    }
+    /** Count alive neighbors for the cell at (x, y). */
+    countNeighbors(x, y) {
+        const offsets = this.neighborhood === "moore"
+            ? this.mooreOffsets
+            : this.vonNeumannOffsets;
+        let count = 0;
+        for (const [dx, dy] of offsets) {
+            count += this.get(x + dx, y + dy) > 0 ? 1 : 0;
+        }
+        return count;
+    }
+    /** Build a CellContext for the cell at (x, y). */
+    buildContext(x, y) {
+        const neighborValues = this.getNeighborValues(x, y);
+        let neighborCount = 0;
+        for (const v of neighborValues) {
+            if (v > 0)
+                neighborCount++;
+        }
+        return {
+            self: this.current[y * this.cols + x],
+            x,
+            y,
+            neighborCount,
+            neighbors: neighborValues,
+            get: (gx, gy) => this.get(gx, gy),
+            cols: this.cols,
+            rows: this.rows,
+        };
+    }
+    /**
+     * Detect whether a rule function uses the new CellContext signature
+     * or the legacy positional signature.
+     *
+     * New-style: function(ctx) — 1 parameter
+     * Legacy:    function(neighbors, currentState, x, y, grid) — 5 parameters
+     */
+    static isLegacyRule(rule) {
+        return rule.length > 1;
+    }
+    /** Apply rule to all cells: write to next buffer, then swap. */
+    step(rule) {
+        const legacy = Grid.isLegacyRule(rule);
+        for (let y = 0; y < this.rows; y++) {
+            for (let x = 0; x < this.cols; x++) {
+                if (legacy) {
+                    // Legacy signature: (neighbors, currentState, x, y, grid)
+                    const neighbors = this.countNeighbors(x, y);
+                    const currentState = this.current[y * this.cols + x];
+                    this.next[y * this.cols + x] = rule(neighbors, currentState, x, y, this.current);
+                }
+                else {
+                    // New CellContext signature
+                    const ctx = this.buildContext(x, y);
+                    this.next[y * this.cols + x] = rule(ctx);
+                }
+            }
+        }
+        this.swap();
+    }
+    /** Swap current and next buffers. */
+    swap() {
+        const temp = this.current;
+        this.current = this.next;
+        this.next = temp;
+    }
+    /** Clear both buffers. */
+    clear() {
+        this.current.fill(0);
+        this.next.fill(0);
+    }
+    /** Randomize the grid with a given density (0–1, default 0.3). */
+    randomize(density = 0.3) {
+        for (let i = 0; i < this.current.length; i++) {
+            this.current[i] = Math.random() < density ? 1 : 0;
+        }
+    }
+    /** Return total number of alive cells. */
+    population() {
+        let count = 0;
+        for (let i = 0; i < this.current.length; i++) {
+            count += this.current[i];
+        }
+        return count;
+    }
+    /** Create a deep copy of this grid. */
+    clone() {
+        const g = new Grid(this.cols, this.rows, {
+            wrap: this.wrap,
+            neighborhood: this.neighborhood,
+        });
+        g.current.set(this.current);
+        g.next.set(this.next);
+        return g;
+    }
+    /** Load a 2D pattern array at the given offset. */
+    stamp(pattern, offsetX = 0, offsetY = 0) {
+        for (let py = 0; py < pattern.length; py++) {
+            for (let px = 0; px < pattern[py].length; px++) {
+                const x = offsetX + px;
+                const y = offsetY + py;
+                if (x >= 0 && x < this.cols && y >= 0 && y < this.rows) {
+                    this.current[y * this.cols + x] = pattern[py][px];
+                }
+            }
+        }
+    }
+    /** Export current state as a 2D array. */
+    toArray() {
+        const arr = [];
+        for (let y = 0; y < this.rows; y++) {
+            const row = [];
+            for (let x = 0; x < this.cols; x++) {
+                row.push(this.current[y * this.cols + x]);
+            }
+            arr.push(row);
+        }
+        return arr;
+    }
+}
+//# sourceMappingURL=grid.js.map

package/dist/grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.js","sourceRoot":"","sources":["../src/grid.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * automata.js v0.2.0
+ *
+ * A focused cellular automata engine for the browser.
+ * Inspired by p5.js. Minimal API, instant feedback, decoupled rules and style.
+ *
+ * @example
+ * ```ts
+ * import { Automata, gameOfLife, patterns } from "@automatajs/core";
+ *
+ * const ca = new Automata(canvas, {
+ *   cols: 80,
+ *   rows: 60,
+ *   fps: 10,
+ *   rule: gameOfLife,
+ * });
+ * ca.randomize(0.3);
+ * ca.play();
+ * ```
+ */
+export { Automata } from "./engine";
+export { Grid } from "./grid";
+export { Renderer } from "./renderer";
+export { Interaction } from "./interaction";
+export { gameOfLife, highLife, seeds, dayAndNight, diamoeba, createRule, patterns, presets, } from "./presets";
+export type { AutomataOptions, GridOptions, NeighborhoodType, RuleFunction, StyleFunction, CellContext, CellCallback, ExportOptions, RGBA, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,OAAO,GACR,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,IAAI,GACL,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * automata.js v0.2.0
+ *
+ * A focused cellular automata engine for the browser.
+ * Inspired by p5.js. Minimal API, instant feedback, decoupled rules and style.
+ *
+ * @example
+ * ```ts
+ * import { Automata, gameOfLife, patterns } from "@automatajs/core";
+ *
+ * const ca = new Automata(canvas, {
+ *   cols: 80,
+ *   rows: 60,
+ *   fps: 10,
+ *   rule: gameOfLife,
+ * });
+ * ca.randomize(0.3);
+ * ca.play();
+ * ```
+ */
+// Core
+export { Automata } from "./engine";
+export { Grid } from "./grid";
+export { Renderer } from "./renderer";
+export { Interaction } from "./interaction";
+// Presets & Patterns
+export { gameOfLife, highLife, seeds, dayAndNight, diamoeba, createRule, patterns, presets, } from "./presets";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO;AACP,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,OAAO,GACR,MAAM,WAAW,CAAC"}

package/dist/interaction.d.ts

@@ -0,0 +1,44 @@
+import { Grid } from "./grid";
+import { Renderer } from "./renderer";
+import type { CellCallback } from "./types";
+/**
+ * Handles mouse/touch interaction on the canvas.
+ * - Click toggles a cell
+ * - Drag paints alive cells
+ */
+export declare class Interaction {
+    private canvas;
+    private renderer;
+    private grid;
+    private enabled;
+    private isDragging;
+    private lastCell;
+    private onClickCb;
+    private onDragCb;
+    private handleMouseDown;
+    private handleMouseMove;
+    private handleMouseUp;
+    private handleTouchStart;
+    private handleTouchMove;
+    private handleTouchEnd;
+    constructor(canvas: HTMLCanvasElement, renderer: Renderer, grid: Grid);
+    private attach;
+    /** Update grid reference (e.g., after reset). */
+    setGrid(grid: Grid): void;
+    /** Set custom click callback. */
+    onCellClick(fn: CellCallback): void;
+    /** Set custom drag callback. */
+    onCellDrag(fn: CellCallback): void;
+    enable(): void;
+    disable(): void;
+    private getCanvasCoords;
+    private _onMouseDown;
+    private _onMouseMove;
+    private _onMouseUp;
+    private _onTouchStart;
+    private _onTouchMove;
+    private _onTouchEnd;
+    /** Remove all event listeners. */
+    destroy(): void;
+}
+//# sourceMappingURL=interaction.d.ts.map

package/dist/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../src/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,QAAQ,CAAyC;IAEzD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAA6B;IAG7C,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,cAAc,CAAa;gBAEvB,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI;IAerE,OAAO,CAAC,MAAM;IAad,iDAAiD;IACjD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB,iCAAiC;IACjC,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAInC,gCAAgC;IAChC,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAIlC,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,WAAW;IAKnB,kCAAkC;IAClC,OAAO,IAAI,IAAI;CAQhB"}