@pibbl/core 0.0.2 → 0.0.3-alpha.90.1

package/dist/features/textures/lib/chemical-recipes.js

@@ -0,0 +1,275 @@
+import {
+  defineTexture
+} from "@pibbl/core";
+import { paletteLut, texturePalettes, validateSeed } from "./palette.js";
+import {
+  ChemicalField,
+  schnakenbergModel,
+  barkleyModel,
+  brusselatorModel
+} from "./chemical-field.js";
+const schnakenbergPresets = Object.freeze({
+  /** Separated activator spots. See {@link schnakenberg}. */
+  spots: Object.freeze({ a: 0.1, b: 0.9, diffusionU: 1, diffusionV: 20 }),
+  /** Connected activator bands. See {@link schnakenberg}. */
+  labyrinths: Object.freeze({
+    a: 0.01,
+    b: 1.7,
+    diffusionU: 1,
+    diffusionV: 20,
+    warmupSteps: 1e4
+  })
+});
+const barkleyPresets = Object.freeze({
+  /** Broken excitation fronts form rotating spirals. See {@link barkley}. */
+  spirals: Object.freeze({
+    a: 0.75,
+    b: 0.02,
+    epsilon: 0.02,
+    diffusionU: 1,
+    diffusionV: 0
+  }),
+  /** Broader propagating excitation fronts. See {@link barkley}. */
+  waves: Object.freeze({
+    a: 0.9,
+    b: 0.01,
+    epsilon: 0.04,
+    diffusionU: 1,
+    diffusionV: 0
+  })
+});
+const brusselatorPresets = Object.freeze({
+  /** Differential diffusion supports stationary spots. See {@link brusselator}. */
+  spots: Object.freeze({
+    a: 1,
+    b: 1.9,
+    diffusionU: 0.2,
+    diffusionV: 2,
+    warmupSteps: 1e4
+  }),
+  /** Equal diffusion above the oscillation threshold. See {@link brusselator}. */
+  oscillations: Object.freeze({ a: 1, b: 3, diffusionU: 0.3, diffusionV: 0.3 })
+});
+function bounded(name, value, min, max, integer = false) {
+  if (!Number.isFinite(value) || value < min || value > max || integer && !Number.isInteger(value))
+    throw new RangeError(
+      `${name} must be ${integer ? "an integer " : ""}within ${min}..${max}.`
+    );
+  return value;
+}
+function common(options) {
+  if (options.paused !== void 0 && typeof options.paused !== "boolean")
+    throw new TypeError("Chemical paused must be boolean.");
+  return {
+    seed: validateSeed(options.seed),
+    initialNoise: bounded(
+      "Chemical initialNoise",
+      options.initialNoise ?? 0.1,
+      0,
+      1
+    ),
+    warmupSteps: bounded(
+      "Chemical warmupSteps",
+      options.warmupSteps ?? 4096,
+      0,
+      12e3,
+      true
+    ),
+    speed: bounded("Chemical speed", options.speed ?? 1, 0, 4),
+    paused: options.paused ?? false
+  };
+}
+function diffusion(options, defaults) {
+  return {
+    diffusionU: bounded(
+      "Chemical diffusionU",
+      options.diffusionU ?? defaults.diffusionU,
+      0,
+      32
+    ),
+    diffusionV: bounded(
+      "Chemical diffusionV",
+      options.diffusionV ?? defaults.diffusionV,
+      0,
+      32
+    )
+  };
+}
+function schnakenbergConfig(options) {
+  return {
+    ...common(options),
+    ...diffusion(options, schnakenbergPresets.spots),
+    a: bounded("Schnakenberg a", options.a ?? 0.1, 0.01, 2),
+    b: bounded("Schnakenberg b", options.b ?? 0.9, 0.01, 2),
+    epsilon: 0.02
+  };
+}
+function barkleyConfig(options) {
+  return {
+    ...common(options),
+    ...diffusion(options, barkleyPresets.spirals),
+    a: bounded("Barkley a", options.a ?? 0.75, 0.3, 1.2),
+    b: bounded("Barkley b", options.b ?? 0.02, 0, 0.2),
+    epsilon: bounded("Barkley epsilon", options.epsilon ?? 0.02, 5e-3, 0.1)
+  };
+}
+function brusselatorConfig(options) {
+  return {
+    ...common(options),
+    ...diffusion(options, brusselatorPresets.spots),
+    a: bounded("Brusselator a", options.a ?? 1, 0.1, 3),
+    b: bounded("Brusselator b", options.b ?? 1.8, 0.1, 5),
+    epsilon: 0.02
+  };
+}
+function chemicalRecipe(model) {
+  const makeField = (context, config) => {
+    if (context.canvas.width < 3 || context.canvas.height < 3)
+      throw new RangeError(
+        "Chemical textures require at least 3\xD73 raster samples."
+      );
+    return new ChemicalField({
+      width: context.canvas.width - 1,
+      height: context.canvas.height - 1,
+      config,
+      model
+    });
+  };
+  const active = (state) => !state.paused && state.config.speed > 0;
+  const reset = (state, context) => {
+    const next = makeField(context, state.config);
+    state.field.dispose();
+    state.field = next;
+    state.elapsed = 0;
+    state.fresh = true;
+    context.invalidate();
+    if (active(state)) context.requestFrame();
+  };
+  return defineTexture({
+    defaultPlacement: { mode: "repeat" },
+    create(context, config) {
+      const state = {
+        config,
+        field: makeField(context, config),
+        paused: config.paused,
+        elapsed: 0,
+        fresh: true,
+        image: new ImageData(context.canvas.width, context.canvas.height),
+        lut: void 0,
+        paletteKey: ""
+      };
+      if (active(state)) context.requestFrame();
+      return state;
+    },
+    update(state, config, context) {
+      if (JSON.stringify(config) === JSON.stringify(state.config)) return;
+      const { speed: _speed, paused: _paused, ...previous } = state.config;
+      const { speed, paused, ...next } = config;
+      const changed = JSON.stringify(previous) !== JSON.stringify(next);
+      if (paused !== state.config.paused) state.paused = paused;
+      state.config = config;
+      state.elapsed = 0;
+      state.fresh = true;
+      if (changed) reset(state, context);
+      if (!state.paused && speed > 0) context.requestFrame();
+    },
+    receive(state, message, context) {
+      if (message.type === "pause") {
+        if (typeof message.paused !== "boolean")
+          throw new TypeError("Chemical pause requires a boolean.");
+        state.paused = message.paused;
+        state.elapsed = 0;
+        state.fresh = true;
+        if (active(state)) context.requestFrame();
+      } else if (message.type === "reset") reset(state, context);
+      else if (message.type === "paint" || message.type === "stir") {
+        const radius = bounded(
+          "Chemical brush radius",
+          message.radius ?? (message.type === "paint" ? 6 : 16),
+          0.01,
+          128
+        );
+        if (!Number.isFinite(message.u) || !Number.isFinite(message.v))
+          throw new RangeError("Chemical brush coordinates must be finite.");
+        if (message.type === "paint") {
+          const strength = bounded(
+            "Chemical brush strength",
+            message.strength ?? 0.8,
+            0,
+            1
+          );
+          if (message.u < 0 || message.u > 1 || message.v < 0 || message.v > 1)
+            return;
+          if (strength === 0) return;
+          state.field.paint({ ...message, radius, strength });
+        } else {
+          const du = bounded("Chemical stir du", message.du, -1, 1), dv = bounded("Chemical stir dv", message.dv, -1, 1);
+          if (message.u < 0 || message.u > 1 || message.v < 0 || message.v > 1)
+            return;
+          state.field.stir({ ...message, radius, du, dv });
+        }
+        context.invalidate();
+      } else throw new TypeError("Unknown chemical texture message.");
+    },
+    advance(state, frame, context) {
+      if (!active(state)) return;
+      if (!state.fresh) {
+        state.elapsed += Math.min(50, frame.delta) * state.config.speed * 0.48;
+        const count = Math.min(96, Math.floor(state.elapsed));
+        state.elapsed -= count;
+        if (count > 0) {
+          state.field.advance(count);
+          context.invalidate();
+        }
+      }
+      state.fresh = false;
+      context.requestFrame();
+    },
+    rasterize(state, context) {
+      const key = (context.palette ?? texturePalettes.lagoon).join();
+      if (key !== state.paletteKey) {
+        state.lut = paletteLut(context.palette ?? texturePalettes.lagoon);
+        state.paletteKey = key;
+      }
+      const { width, height } = context.canvas, data = state.image.data, lut = state.lut;
+      for (let y = 0; y < height; y++)
+        for (let x = 0; x < width; x++) {
+          const index = y % state.field.height * state.field.width + x % state.field.width;
+          const color = Math.round(
+            Math.max(0, Math.min(1, state.field.intensity(index))) * 255
+          ) * 4, i = (y * width + x) * 4;
+          data[i] = lut[color];
+          data[i + 1] = lut[color + 1];
+          data[i + 2] = lut[color + 2];
+          data[i + 3] = 255;
+        }
+      context.canvas.getContext("2d").putImageData(state.image, 0, 0);
+    },
+    dispose(state) {
+      state.field.dispose();
+      state.image = void 0;
+      state.lut = void 0;
+    }
+  });
+}
+const schnakenbergRecipe = /* @__PURE__ */ chemicalRecipe(schnakenbergModel);
+const barkleyRecipe = /* @__PURE__ */ chemicalRecipe(barkleyModel);
+const brusselatorRecipe = /* @__PURE__ */ chemicalRecipe(brusselatorModel);
+function schnakenberg(options = {}) {
+  return schnakenbergRecipe(schnakenbergConfig(options));
+}
+function barkley(options = {}) {
+  return barkleyRecipe(barkleyConfig(options));
+}
+function brusselator(options = {}) {
+  return brusselatorRecipe(brusselatorConfig(options));
+}
+export {
+  barkley,
+  barkleyPresets,
+  brusselator,
+  brusselatorPresets,
+  schnakenberg,
+  schnakenbergPresets
+};
+//# sourceMappingURL=chemical-recipes.js.map

package/dist/features/textures/lib/chemical-recipes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/chemical-recipes.ts"],
+  "sourcesContent": ["import {\n  defineTexture,\n  type TextureContext,\n  type TextureRecipe,\n} from \"@pibbl/core\";\nimport type { InkMessage } from \"./definitions.js\";\nimport { paletteLut, texturePalettes, validateSeed } from \"./palette.js\";\nimport {\n  ChemicalField,\n  schnakenbergModel,\n  barkleyModel,\n  brusselatorModel,\n  type ChemicalConfig,\n} from \"./chemical-field.js\";\n\n/** Shared simulation timing, diffusion and initialization controls. See {@link SchnakenbergOptions}. */\ninterface ChemicalOptions {\n  /** Unsigned 32-bit initialization seed; default 42. See {@link schnakenberg}. */\n  readonly seed?: number;\n  /** Activator diffusion per grid cell, finite 0\u201332. See {@link schnakenberg}. */\n  readonly diffusionU?: number;\n  /** Inhibitor diffusion per grid cell, finite 0\u201332. See {@link schnakenberg}. */\n  readonly diffusionV?: number;\n  /** Initial seeded disturbance amplitude, finite 0\u20131; default 0.1. See {@link schnakenberg}. */\n  readonly initialNoise?: number;\n  /** Initialization steps, integer 0\u201312000; default 4096. See {@link schnakenberg}. */\n  readonly warmupSteps?: number;\n  /** Multiplier of 480 numerical steps/second, finite 0\u20134; default 1. Zero idles. See {@link schnakenberg}. */\n  readonly speed?: number;\n  /** Initially suspend stepping; default false. See {@link InkMessage}. */\n  readonly paused?: boolean;\n}\n/** Schnakenberg production rates, diffusion and initialization. See {@link schnakenberg}. */\nexport interface SchnakenbergOptions extends ChemicalOptions {\n  /** Activator source, finite 0.01\u20132; default 0.1. See {@link schnakenberg}. */\n  readonly a?: number;\n  /** Inhibitor source, finite 0.01\u20132; default 0.9. See {@link schnakenberg}. */\n  readonly b?: number;\n}\n/** Excitability, recovery, diffusion and initialization. See {@link barkley}. */\nexport interface BarkleyOptions extends ChemicalOptions {\n  /** Excitability scale, finite 0.3\u20131.2; default 0.75. See {@link barkley}. */\n  readonly a?: number;\n  /** Excitation threshold offset, finite 0\u20130.2; default 0.02. See {@link barkley}. */\n  readonly b?: number;\n  /** Fast/slow time separation, finite 0.005\u20130.1; default 0.02. See {@link barkley}. */\n  readonly epsilon?: number;\n}\n/** Brusselator feed rates, diffusion and initialization. See {@link brusselator}. */\nexport interface BrusselatorOptions extends ChemicalOptions {\n  /** Activator feed, finite 0.1\u20133; default 1. See {@link brusselator}. */\n  readonly a?: number;\n  /** Conversion rate, finite 0.1\u20135; default 1.8. See {@link brusselator}. */\n  readonly b?: number;\n}\n/** Immutable Schnakenberg starting configurations. See {@link SchnakenbergOptions}. */\nexport const schnakenbergPresets = Object.freeze({\n  /** Separated activator spots. See {@link schnakenberg}. */\n  spots: Object.freeze({ a: 0.1, b: 0.9, diffusionU: 1, diffusionV: 20 }),\n  /** Connected activator bands. See {@link schnakenberg}. */\n  labyrinths: Object.freeze({\n    a: 0.01,\n    b: 1.7,\n    diffusionU: 1,\n    diffusionV: 20,\n    warmupSteps: 10000,\n  }),\n});\n/** Immutable Barkley starting configurations. See {@link BarkleyOptions}. */\nexport const barkleyPresets = Object.freeze({\n  /** Broken excitation fronts form rotating spirals. See {@link barkley}. */\n  spirals: Object.freeze({\n    a: 0.75,\n    b: 0.02,\n    epsilon: 0.02,\n    diffusionU: 1,\n    diffusionV: 0,\n  }),\n  /** Broader propagating excitation fronts. See {@link barkley}. */\n  waves: Object.freeze({\n    a: 0.9,\n    b: 0.01,\n    epsilon: 0.04,\n    diffusionU: 1,\n    diffusionV: 0,\n  }),\n});\n/** Immutable Brusselator starting configurations. See {@link BrusselatorOptions}. */\nexport const brusselatorPresets = Object.freeze({\n  /** Differential diffusion supports stationary spots. See {@link brusselator}. */\n  spots: Object.freeze({\n    a: 1,\n    b: 1.9,\n    diffusionU: 0.2,\n    diffusionV: 2,\n    warmupSteps: 10000,\n  }),\n  /** Equal diffusion above the oscillation threshold. See {@link brusselator}. */\n  oscillations: Object.freeze({ a: 1, b: 3, diffusionU: 0.3, diffusionV: 0.3 }),\n});\nfunction bounded(\n  name: string,\n  value: number,\n  min: number,\n  max: number,\n  integer = false,\n) {\n  if (\n    !Number.isFinite(value) ||\n    value < min ||\n    value > max ||\n    (integer && !Number.isInteger(value))\n  )\n    throw new RangeError(\n      `${name} must be ${integer ? \"an integer \" : \"\"}within ${min}..${max}.`,\n    );\n  return value;\n}\nfunction common(\n  options: ChemicalOptions,\n): Omit<ChemicalConfig, \"a\" | \"b\" | \"epsilon\" | \"diffusionU\" | \"diffusionV\"> {\n  if (options.paused !== undefined && typeof options.paused !== \"boolean\")\n    throw new TypeError(\"Chemical paused must be boolean.\");\n  return {\n    seed: validateSeed(options.seed),\n    initialNoise: bounded(\n      \"Chemical initialNoise\",\n      options.initialNoise ?? 0.1,\n      0,\n      1,\n    ),\n    warmupSteps: bounded(\n      \"Chemical warmupSteps\",\n      options.warmupSteps ?? 4096,\n      0,\n      12000,\n      true,\n    ),\n    speed: bounded(\"Chemical speed\", options.speed ?? 1, 0, 4),\n    paused: options.paused ?? false,\n  };\n}\nfunction diffusion(\n  options: ChemicalOptions,\n  defaults: { diffusionU: number; diffusionV: number },\n) {\n  return {\n    diffusionU: bounded(\n      \"Chemical diffusionU\",\n      options.diffusionU ?? defaults.diffusionU,\n      0,\n      32,\n    ),\n    diffusionV: bounded(\n      \"Chemical diffusionV\",\n      options.diffusionV ?? defaults.diffusionV,\n      0,\n      32,\n    ),\n  };\n}\nfunction schnakenbergConfig(options: SchnakenbergOptions): ChemicalConfig {\n  return {\n    ...common(options),\n    ...diffusion(options, schnakenbergPresets.spots),\n    a: bounded(\"Schnakenberg a\", options.a ?? 0.1, 0.01, 2),\n    b: bounded(\"Schnakenberg b\", options.b ?? 0.9, 0.01, 2),\n    epsilon: 0.02,\n  };\n}\nfunction barkleyConfig(options: BarkleyOptions): ChemicalConfig {\n  return {\n    ...common(options),\n    ...diffusion(options, barkleyPresets.spirals),\n    a: bounded(\"Barkley a\", options.a ?? 0.75, 0.3, 1.2),\n    b: bounded(\"Barkley b\", options.b ?? 0.02, 0, 0.2),\n    epsilon: bounded(\"Barkley epsilon\", options.epsilon ?? 0.02, 0.005, 0.1),\n  };\n}\nfunction brusselatorConfig(options: BrusselatorOptions): ChemicalConfig {\n  return {\n    ...common(options),\n    ...diffusion(options, brusselatorPresets.spots),\n    a: bounded(\"Brusselator a\", options.a ?? 1, 0.1, 3),\n    b: bounded(\"Brusselator b\", options.b ?? 1.8, 0.1, 5),\n    epsilon: 0.02,\n  };\n}\ninterface State {\n  config: ChemicalConfig;\n  field: ChemicalField;\n  paused: boolean;\n  elapsed: number;\n  fresh: boolean;\n  image: ImageData | undefined;\n  lut: Uint8ClampedArray | undefined;\n  paletteKey: string;\n}\nfunction chemicalRecipe(model: typeof schnakenbergModel) {\n  const makeField = (context: TextureContext, config: ChemicalConfig) => {\n    if (context.canvas.width < 3 || context.canvas.height < 3)\n      throw new RangeError(\n        \"Chemical textures require at least 3\u00D73 raster samples.\",\n      );\n    return new ChemicalField({\n      width: context.canvas.width - 1,\n      height: context.canvas.height - 1,\n      config,\n      model,\n    });\n  };\n  const active = (state: State) => !state.paused && state.config.speed > 0;\n  const reset = (state: State, context: TextureContext) => {\n    const next = makeField(context, state.config);\n    state.field.dispose();\n    state.field = next;\n    state.elapsed = 0;\n    state.fresh = true;\n    context.invalidate();\n    if (active(state)) context.requestFrame();\n  };\n  return defineTexture<ChemicalConfig, State, InkMessage>({\n    defaultPlacement: { mode: \"repeat\" },\n    create(context, config) {\n      const state: State = {\n        config,\n        field: makeField(context, config),\n        paused: config.paused,\n        elapsed: 0,\n        fresh: true,\n        image: new ImageData(context.canvas.width, context.canvas.height),\n        lut: undefined,\n        paletteKey: \"\",\n      };\n      if (active(state)) context.requestFrame();\n      return state;\n    },\n    update(state, config, context) {\n      if (JSON.stringify(config) === JSON.stringify(state.config)) return;\n      const { speed: _speed, paused: _paused, ...previous } = state.config;\n      const { speed, paused, ...next } = config;\n      const changed = JSON.stringify(previous) !== JSON.stringify(next);\n      if (paused !== state.config.paused) state.paused = paused;\n      state.config = config;\n      state.elapsed = 0;\n      state.fresh = true;\n      if (changed) reset(state, context);\n      if (!state.paused && speed > 0) context.requestFrame();\n    },\n    receive(state, message, context) {\n      if (message.type === \"pause\") {\n        if (typeof message.paused !== \"boolean\")\n          throw new TypeError(\"Chemical pause requires a boolean.\");\n        state.paused = message.paused;\n        state.elapsed = 0;\n        state.fresh = true;\n        if (active(state)) context.requestFrame();\n      } else if (message.type === \"reset\") reset(state, context);\n      else if (message.type === \"paint\" || message.type === \"stir\") {\n        const radius = bounded(\n          \"Chemical brush radius\",\n          message.radius ?? (message.type === \"paint\" ? 6 : 16),\n          0.01,\n          128,\n        );\n        if (!Number.isFinite(message.u) || !Number.isFinite(message.v))\n          throw new RangeError(\"Chemical brush coordinates must be finite.\");\n        if (message.type === \"paint\") {\n          const strength = bounded(\n            \"Chemical brush strength\",\n            message.strength ?? 0.8,\n            0,\n            1,\n          );\n          if (message.u < 0 || message.u > 1 || message.v < 0 || message.v > 1)\n            return;\n          if (strength === 0) return;\n          state.field.paint({ ...message, radius, strength });\n        } else {\n          const du = bounded(\"Chemical stir du\", message.du, -1, 1),\n            dv = bounded(\"Chemical stir dv\", message.dv, -1, 1);\n          if (message.u < 0 || message.u > 1 || message.v < 0 || message.v > 1)\n            return;\n          state.field.stir({ ...message, radius, du, dv });\n        }\n        context.invalidate();\n      } else throw new TypeError(\"Unknown chemical texture message.\");\n    },\n    advance(state, frame, context) {\n      if (!active(state)) return;\n      if (!state.fresh) {\n        state.elapsed += Math.min(50, frame.delta) * state.config.speed * 0.48;\n        const count = Math.min(96, Math.floor(state.elapsed));\n        state.elapsed -= count;\n        if (count > 0) {\n          state.field.advance(count);\n          context.invalidate();\n        }\n      }\n      state.fresh = false;\n      context.requestFrame();\n    },\n    rasterize(state, context) {\n      const key = (context.palette ?? texturePalettes.lagoon).join();\n      if (key !== state.paletteKey) {\n        state.lut = paletteLut(context.palette ?? texturePalettes.lagoon);\n        state.paletteKey = key;\n      }\n      const { width, height } = context.canvas,\n        data = state.image!.data,\n        lut = state.lut!;\n      for (let y = 0; y < height; y++)\n        for (let x = 0; x < width; x++) {\n          const index =\n            (y % state.field.height) * state.field.width +\n            (x % state.field.width);\n          const color =\n              Math.round(\n                Math.max(0, Math.min(1, state.field.intensity(index))) * 255,\n              ) * 4,\n            i = (y * width + x) * 4;\n          data[i] = lut[color]!;\n          data[i + 1] = lut[color + 1]!;\n          data[i + 2] = lut[color + 2]!;\n          data[i + 3] = 255;\n        }\n      context.canvas.getContext(\"2d\")!.putImageData(state.image!, 0, 0);\n    },\n    dispose(state) {\n      state.field.dispose();\n      state.image = undefined;\n      state.lut = undefined;\n    },\n  });\n}\nconst schnakenbergRecipe = /* @__PURE__ */ chemicalRecipe(schnakenbergModel);\nconst barkleyRecipe = /* @__PURE__ */ chemicalRecipe(barkleyModel);\nconst brusselatorRecipe = /* @__PURE__ */ chemicalRecipe(brusselatorModel);\n/**\n * Creates a periodic Schnakenberg activator/inhibitor texture with paint, stir, pause and reset.\n * @param options - Reaction rates, diffusion and initialization. See {@link SchnakenbergOptions}.\n * @returns A mountable simulation recipe. See {@link TextureRecipe}, {@link InkMessage}.\n * @see {@link schnakenbergPresets}\n */\nexport function schnakenberg(\n  options: SchnakenbergOptions = {},\n): TextureRecipe<InkMessage> {\n  return schnakenbergRecipe(schnakenbergConfig(options));\n}\n/**\n * Creates a periodic Barkley excitable texture initialized with a broken excitation front.\n * @param options - Excitability, recovery, diffusion and initialization. See {@link BarkleyOptions}.\n * @returns A mountable simulation recipe. See {@link TextureRecipe}, {@link InkMessage}.\n * @see {@link barkleyPresets}\n */\nexport function barkley(\n  options: BarkleyOptions = {},\n): TextureRecipe<InkMessage> {\n  return barkleyRecipe(barkleyConfig(options));\n}\n/**\n * Creates a periodic Brusselator texture with paint, stir, pause and reset.\n * @param options - Feed rates, diffusion and initialization. See {@link BrusselatorOptions}.\n * @returns A mountable simulation recipe. See {@link TextureRecipe}, {@link InkMessage}.\n * @see {@link brusselatorPresets}\n */\nexport function brusselator(\n  options: BrusselatorOptions = {},\n): TextureRecipe<InkMessage> {\n  return brusselatorRecipe(brusselatorConfig(options));\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/textures/lib/definitions.d.ts

@@ -1,4 +1,4 @@
-import type { TextureRecipe } from '../../../lib/textures/texture.js';
+import type { TextureRecipe } from "../../../lib/textures/texture.js";
 export { useTexture } from "@pibbl/core";
 /**
  * Seed, feature scale, and detail controls shared by static material recipes.
@@ -18,23 +18,8 @@ export interface MaterialOptions {
     /** Material-specific distortion, grain strength, or cellular jitter. See {@link MaterialOptions}. */
     readonly detail?: number;
 }
-/**
- * Seed and pattern preset for a reaction-diffusion recipe.
- *
- * @see {@link reactionDiffusion}
- */
-export interface ReactionDiffusionOptions {
-    /**
-     * Seed used for deterministic sampling or simulation initialization. See
-     * {@link ReactionDiffusionOptions}.
-     */
-    readonly seed?: number;
-    /**
-     * Named pattern configuration used to initialize the simulation. See
-     * {@link ReactionDiffusionOptions}.
-     */
-    readonly preset?: "spots" | "stripes";
-}
+export type { ReactionDiffusionOptions } from "./gray-scott.js";
+import { type ReactionDiffusionOptions } from "./gray-scott.js";
 /**
  * Paint, stir, pause, or reset commands accepted by a reaction-diffusion texture.
  *

package/dist/features/textures/lib/definitions.js

@@ -8,6 +8,9 @@ import {
 import { InkSimulation } from "./simulation.js";
 import { paletteLut, texturePalettes, validateSeed } from "./palette.js";
 import { useTexture } from "@pibbl/core";
+import {
+  grayScottConfig
+} from "./gray-scott.js";
 function colorize(field, context, gain = 1) {
   const ctx = context.canvas.getContext("2d");
   const lut = paletteLut(context.palette ?? texturePalettes.porcelain);
@@ -63,19 +66,13 @@ function material(generate) {
 const marble = /* @__PURE__ */ material(marbleField);
 const paper = /* @__PURE__ */ material(paperField);
 const cellular = /* @__PURE__ */ material(cellularField);
-function inkConfig(input) {
-  const seed = validateSeed(input.seed), preset = input.preset ?? "spots";
-  if (preset !== "spots" && preset !== "stripes")
-    throw new TypeError("Unknown ink preset.");
-  return { seed, preset };
-}
+const inkConfig = grayScottConfig;
 function reset(state, context) {
-  const next = new InkSimulation(
-    context.canvas.width,
-    context.canvas.height,
-    state.config.seed,
-    state.config.preset
-  );
+  const next = new InkSimulation({
+    width: context.canvas.width,
+    height: context.canvas.height,
+    ...state.config
+  });
   state.simulation.dispose();
   state.simulation = next;
   state.elapsed = 0;
@@ -88,12 +85,11 @@ const inkRecipe = /* @__PURE__ */ defineTexture({
     const config = inkConfig(input);
     context.requestFrame();
     return {
-      simulation: new InkSimulation(
-        context.canvas.width,
-        context.canvas.height,
-        config.seed,
-        config.preset
-      ),
+      simulation: new InkSimulation({
+        width: context.canvas.width,
+        height: context.canvas.height,
+        ...config
+      }),
       config,
       paused: false,
       elapsed: 0,
@@ -102,8 +98,7 @@ const inkRecipe = /* @__PURE__ */ defineTexture({
   },
   update(state, input, context) {
     const config = inkConfig(input);
-    if (config.seed === state.config.seed && config.preset === state.config.preset)
-      return;
+    if (JSON.stringify(config) === JSON.stringify(state.config)) return;
     state.config = config;
     reset(state, context);
   },

package/dist/features/textures/lib/definitions.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/textures/lib/definitions.ts"],
-  "sourcesContent": ["import type { TextureRecipe } from '../../../lib/textures/texture.js';\nimport { rasterizeField, releaseField } from \"./wasm/memory.js\";\nimport { defineTexture, type TextureContext } from \"@pibbl/core\";\nimport {\n  marbleField,\n  paperField,\n  cellularField,\n  type MaterialGenerator,\n} from \"./material-field.js\";\nimport { InkSimulation } from \"./simulation.js\";\nimport { paletteLut, texturePalettes, validateSeed } from \"./palette.js\";\nexport { useTexture } from \"@pibbl/core\";\n/**\n * Seed, feature scale, and detail controls shared by static material recipes.\n *\n * @see {@link marble}\n * @see {@link paper}\n * @see {@link cellular}\n */\nexport interface MaterialOptions {\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See {@link MaterialOptions}\n   * .\n   */\n  readonly seed?: number;\n  /** Feature frequency across the generated material. See {@link MaterialOptions}. */\n  readonly scale?: number;\n  /** Material-specific distortion, grain strength, or cellular jitter. See {@link MaterialOptions}. */\n  readonly detail?: number;\n}\n/**\n * Seed and pattern preset for a reaction-diffusion recipe.\n *\n * @see {@link reactionDiffusion}\n */\nexport interface ReactionDiffusionOptions {\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See\n   * {@link ReactionDiffusionOptions}.\n   */\n  readonly seed?: number;\n  /**\n   * Named pattern configuration used to initialize the simulation. See\n   * {@link ReactionDiffusionOptions}.\n   */\n  readonly preset?: \"spots\" | \"stripes\";\n}\n/**\n * Paint, stir, pause, or reset commands accepted by a reaction-diffusion texture.\n *\n * @see {@link reactionDiffusion}\n */\nexport type InkMessage =\n  | {\n      /** The literal \"paint\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"paint\";\n      /** Normalized horizontal texture coordinate. See {@link InkMessage}. */\n      readonly u: number;\n      /** Normalized vertical texture coordinate. See {@link InkMessage}. */\n      readonly v: number;\n      /** Radius in the coordinate system of this geometry or effect. See {@link InkMessage}. */\n      readonly radius?: number;\n      /** Magnitude of the displacement or brush effect. See {@link InkMessage}. */\n      readonly strength?: number;\n    }\n  | {\n      /** The literal \"stir\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"stir\";\n      /** Normalized horizontal texture coordinate. See {@link InkMessage}. */\n      readonly u: number;\n      /** Normalized vertical texture coordinate. See {@link InkMessage}. */\n      readonly v: number;\n      /** Normalized displacement of the existing field, not a paint dose. */\n      readonly du: number;\n      /** Normalized vertical displacement of the texture field. See {@link InkMessage}. */\n      readonly dv: number;\n      /** Influence radius in texture cells. */\n      readonly radius?: number;\n    }\n  | {\n      /** The literal \"pause\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"pause\";\n      /** Whether simulation or playback advancement is suspended. See {@link InkMessage}. */\n      readonly paused: boolean;\n    }\n  | {\n      /** The literal \"reset\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"reset\";\n    };\nfunction colorize(field: Float32Array, context: TextureContext, gain = 1) {\n  const ctx = context.canvas.getContext(\"2d\")!;\n  const lut = paletteLut(context.palette ?? texturePalettes.porcelain);\n  const raster = rasterizeField(field, lut, gain);\n  if (!raster) throw new Error(\"Texture field has no WASM owner.\");\n  ctx.putImageData(raster.image, 0, 0);\n}\nfunction materialConfig(config: MaterialOptions) {\n  const seed = validateSeed(config.seed),\n    scale = config.scale ?? 6,\n    detail = config.detail ?? 0.65;\n  if (\n    !Number.isFinite(scale) ||\n    scale < 1 ||\n    scale > 32 ||\n    !Number.isFinite(detail) ||\n    detail < 0 ||\n    detail > 1\n  )\n    throw new RangeError(\"Material scale must be 1..32 and detail 0..1.\");\n  return { seed, scale, detail };\n}\nfunction material(generate: MaterialGenerator) {\n  const recipe = defineTexture<\n    MaterialOptions,\n    { config: ReturnType<typeof materialConfig>; field: Float32Array }\n  >({\n    create(context, input) {\n      const config = materialConfig(input);\n      return {\n        config,\n        field: generate(\n          context.canvas.width,\n          context.canvas.height,\n          config.seed,\n          config.scale,\n          config.detail,\n        ),\n      };\n    },\n    update(state, input, context) {\n      const config = materialConfig(input);\n      if (JSON.stringify(config) === JSON.stringify(state.config)) return;\n      state.field = generate(\n        context.canvas.width,\n        context.canvas.height,\n        config.seed,\n        config.scale,\n        config.detail,\n        state.field,\n      );\n      state.config = config;\n      context.invalidate();\n    },\n    rasterize(state, context) {\n      colorize(state.field, context);\n    },\n    dispose(state) {\n      releaseField(state.field);\n      state.field = new Float32Array(0);\n    },\n  });\n  return (options: MaterialOptions = {}) => recipe(options);\n}\n/**\n * Creates a seeded marble texture recipe with configurable feature scale and distortion.\n *\n * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.\n * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.\n *\n * @see {@link MaterialOptions}\n * @see {@link TextureRecipe}\n */\nexport const marble = /* @__PURE__ */ material(marbleField);\n/**\n * Creates a seeded paper texture recipe with configurable feature scale and grain.\n *\n * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.\n * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.\n *\n * @see {@link MaterialOptions}\n * @see {@link TextureRecipe}\n */\nexport const paper = /* @__PURE__ */ material(paperField);\n/**\n * Creates a seeded cellular texture recipe with configurable feature scale and jitter.\n *\n * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.\n * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.\n *\n * @see {@link MaterialOptions}\n * @see {@link TextureRecipe}\n */\nexport const cellular = /* @__PURE__ */ material(cellularField);\nfunction inkConfig(input: ReactionDiffusionOptions) {\n  const seed = validateSeed(input.seed),\n    preset = input.preset ?? \"spots\";\n  if (preset !== \"spots\" && preset !== \"stripes\")\n    throw new TypeError(\"Unknown ink preset.\");\n  return { seed, preset };\n}\ninterface InkState {\n  simulation: InkSimulation;\n  config: ReturnType<typeof inkConfig>;\n  paused: boolean;\n  elapsed: number;\n  fresh: boolean;\n}\nfunction reset(state: InkState, context: TextureContext) {\n  const next = new InkSimulation(\n    context.canvas.width,\n    context.canvas.height,\n    state.config.seed,\n    state.config.preset,\n  );\n  state.simulation.dispose();\n  state.simulation = next;\n  state.elapsed = 0;\n  state.fresh = true;\n  context.invalidate();\n}\nconst inkRecipe = /* @__PURE__ */ defineTexture<\n  ReactionDiffusionOptions,\n  InkState,\n  InkMessage\n>({\n  defaultPlacement: { mode: \"stretch\" },\n  create(context, input) {\n    const config = inkConfig(input);\n    context.requestFrame();\n    return {\n      simulation: new InkSimulation(\n        context.canvas.width,\n        context.canvas.height,\n        config.seed,\n        config.preset,\n      ),\n      config,\n      paused: false,\n      elapsed: 0,\n      fresh: true,\n    };\n  },\n  update(state, input, context) {\n    const config = inkConfig(input);\n    if (\n      config.seed === state.config.seed &&\n      config.preset === state.config.preset\n    )\n      return;\n    state.config = config;\n    reset(state, context);\n  },\n  receive(state, message, context) {\n    if (message.type === \"pause\") {\n      state.paused = message.paused;\n      state.elapsed = 0;\n      state.fresh = true;\n      if (!state.paused) context.requestFrame();\n    } else if (message.type === \"reset\") reset(state, context);\n    else if (message.type === \"stir\") {\n      const radius = message.radius ?? 16;\n      if (\n        ![message.u, message.v, message.du, message.dv, radius].every(\n          Number.isFinite,\n        ) ||\n        radius <= 0 ||\n        radius > 128 ||\n        Math.abs(message.du) > 1 ||\n        Math.abs(message.dv) > 1\n      )\n        throw new RangeError(\"Invalid ink stir message.\");\n      if (message.u < 0 || message.u > 1 || message.v < 0 || message.v > 1)\n        return;\n      state.simulation.stir(\n        message.u * context.canvas.width,\n        message.v * context.canvas.height,\n        message.du * context.canvas.width,\n        message.dv * context.canvas.height,\n        radius,\n      );\n      context.invalidate();\n    } else if (message.type === \"paint\") {\n      const radius = message.radius ?? 6,\n        strength = message.strength ?? 0.8;\n      if (\n        ![message.u, message.v, radius, strength].every(Number.isFinite) ||\n        radius <= 0 ||\n        radius > 128 ||\n        strength < 0 ||\n        strength > 1\n      )\n        throw new RangeError(\"Invalid ink paint message.\");\n      if (message.u < 0 || message.v < 0 || message.u > 1 || message.v > 1)\n        return;\n      state.simulation.paint(\n        message.u * context.canvas.width,\n        message.v * context.canvas.height,\n        radius,\n        strength,\n      );\n      context.invalidate();\n    } else throw new TypeError(\"Unknown ink message.\");\n  },\n  advance(state, frame, context) {\n    if (state.paused) return;\n    if (!state.fresh) {\n      state.elapsed += Math.min(50, frame.delta);\n      const steps = Math.min(24, Math.floor(state.elapsed * 0.48 + 1e-9));\n      state.elapsed -= steps / 0.48;\n      if (steps) {\n        state.simulation.advance(steps);\n        context.invalidate();\n      }\n    }\n    state.fresh = false;\n    context.requestFrame();\n  },\n  rasterize(state, context) {\n    colorize(state.simulation.b, context, 650 / 255);\n  },\n  dispose(state) {\n    state.simulation.dispose();\n  },\n});\n/**\n * Creates a stateful reaction-diffusion texture recipe supporting paint, stirring, pause, and\n * reset\n * messages.\n *\n * @param options - Reaction and diffusion parameters, initialization, and rendering options. See\n * {@link ReactionDiffusionOptions} .\n * @returns A reaction-diffusion texture recipe for useTexture.\n *\n * @see {@link ReactionDiffusionOptions}\n */\nexport function reactionDiffusion(options: ReactionDiffusionOptions = {}) {\n  return inkRecipe(options);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { TextureRecipe } from \"../../../lib/textures/texture.js\";\nimport { rasterizeField, releaseField } from \"./wasm/memory.js\";\nimport { defineTexture, type TextureContext } from \"@pibbl/core\";\nimport {\n  marbleField,\n  paperField,\n  cellularField,\n  type MaterialGenerator,\n} from \"./material-field.js\";\nimport { InkSimulation } from \"./simulation.js\";\nimport { paletteLut, texturePalettes, validateSeed } from \"./palette.js\";\nexport { useTexture } from \"@pibbl/core\";\n/**\n * Seed, feature scale, and detail controls shared by static material recipes.\n *\n * @see {@link marble}\n * @see {@link paper}\n * @see {@link cellular}\n */\nexport interface MaterialOptions {\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See {@link MaterialOptions}\n   * .\n   */\n  readonly seed?: number;\n  /** Feature frequency across the generated material. See {@link MaterialOptions}. */\n  readonly scale?: number;\n  /** Material-specific distortion, grain strength, or cellular jitter. See {@link MaterialOptions}. */\n  readonly detail?: number;\n}\nexport type { ReactionDiffusionOptions } from \"./gray-scott.js\";\nimport {\n  grayScottConfig,\n  type ReactionDiffusionOptions,\n} from \"./gray-scott.js\";\n/**\n * Paint, stir, pause, or reset commands accepted by a reaction-diffusion texture.\n *\n * @see {@link reactionDiffusion}\n */\nexport type InkMessage =\n  | {\n      /** The literal \"paint\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"paint\";\n      /** Normalized horizontal texture coordinate. See {@link InkMessage}. */\n      readonly u: number;\n      /** Normalized vertical texture coordinate. See {@link InkMessage}. */\n      readonly v: number;\n      /** Radius in the coordinate system of this geometry or effect. See {@link InkMessage}. */\n      readonly radius?: number;\n      /** Magnitude of the displacement or brush effect. See {@link InkMessage}. */\n      readonly strength?: number;\n    }\n  | {\n      /** The literal \"stir\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"stir\";\n      /** Normalized horizontal texture coordinate. See {@link InkMessage}. */\n      readonly u: number;\n      /** Normalized vertical texture coordinate. See {@link InkMessage}. */\n      readonly v: number;\n      /** Normalized displacement of the existing field, not a paint dose. */\n      readonly du: number;\n      /** Normalized vertical displacement of the texture field. See {@link InkMessage}. */\n      readonly dv: number;\n      /** Influence radius in texture cells. */\n      readonly radius?: number;\n    }\n  | {\n      /** The literal \"pause\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"pause\";\n      /** Whether simulation or playback advancement is suspended. See {@link InkMessage}. */\n      readonly paused: boolean;\n    }\n  | {\n      /** The literal \"reset\" identifying this variant. See {@link InkMessage}. */\n      readonly type: \"reset\";\n    };\nfunction colorize(field: Float32Array, context: TextureContext, gain = 1) {\n  const ctx = context.canvas.getContext(\"2d\")!;\n  const lut = paletteLut(context.palette ?? texturePalettes.porcelain);\n  const raster = rasterizeField(field, lut, gain);\n  if (!raster) throw new Error(\"Texture field has no WASM owner.\");\n  ctx.putImageData(raster.image, 0, 0);\n}\nfunction materialConfig(config: MaterialOptions) {\n  const seed = validateSeed(config.seed),\n    scale = config.scale ?? 6,\n    detail = config.detail ?? 0.65;\n  if (\n    !Number.isFinite(scale) ||\n    scale < 1 ||\n    scale > 32 ||\n    !Number.isFinite(detail) ||\n    detail < 0 ||\n    detail > 1\n  )\n    throw new RangeError(\"Material scale must be 1..32 and detail 0..1.\");\n  return { seed, scale, detail };\n}\nfunction material(generate: MaterialGenerator) {\n  const recipe = defineTexture<\n    MaterialOptions,\n    { config: ReturnType<typeof materialConfig>; field: Float32Array }\n  >({\n    create(context, input) {\n      const config = materialConfig(input);\n      return {\n        config,\n        field: generate(\n          context.canvas.width,\n          context.canvas.height,\n          config.seed,\n          config.scale,\n          config.detail,\n        ),\n      };\n    },\n    update(state, input, context) {\n      const config = materialConfig(input);\n      if (JSON.stringify(config) === JSON.stringify(state.config)) return;\n      state.field = generate(\n        context.canvas.width,\n        context.canvas.height,\n        config.seed,\n        config.scale,\n        config.detail,\n        state.field,\n      );\n      state.config = config;\n      context.invalidate();\n    },\n    rasterize(state, context) {\n      colorize(state.field, context);\n    },\n    dispose(state) {\n      releaseField(state.field);\n      state.field = new Float32Array(0);\n    },\n  });\n  return (options: MaterialOptions = {}) => recipe(options);\n}\n/**\n * Creates a seeded marble texture recipe with configurable feature scale and distortion.\n *\n * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.\n * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.\n *\n * @see {@link MaterialOptions}\n * @see {@link TextureRecipe}\n */\nexport const marble = /* @__PURE__ */ material(marbleField);\n/**\n * Creates a seeded paper texture recipe with configurable feature scale and grain.\n *\n * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.\n * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.\n *\n * @see {@link MaterialOptions}\n * @see {@link TextureRecipe}\n */\nexport const paper = /* @__PURE__ */ material(paperField);\n/**\n * Creates a seeded cellular texture recipe with configurable feature scale and jitter.\n *\n * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.\n * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.\n *\n * @see {@link MaterialOptions}\n * @see {@link TextureRecipe}\n */\nexport const cellular = /* @__PURE__ */ material(cellularField);\nconst inkConfig = grayScottConfig;\ninterface InkState {\n  simulation: InkSimulation;\n  config: ReturnType<typeof inkConfig>;\n  paused: boolean;\n  elapsed: number;\n  fresh: boolean;\n}\nfunction reset(state: InkState, context: TextureContext) {\n  const next = new InkSimulation({\n    width: context.canvas.width,\n    height: context.canvas.height,\n    ...state.config,\n  });\n  state.simulation.dispose();\n  state.simulation = next;\n  state.elapsed = 0;\n  state.fresh = true;\n  context.invalidate();\n}\nconst inkRecipe = /* @__PURE__ */ defineTexture<\n  ReactionDiffusionOptions,\n  InkState,\n  InkMessage\n>({\n  defaultPlacement: { mode: \"stretch\" },\n  create(context, input) {\n    const config = inkConfig(input);\n    context.requestFrame();\n    return {\n      simulation: new InkSimulation({\n        width: context.canvas.width,\n        height: context.canvas.height,\n        ...config,\n      }),\n      config,\n      paused: false,\n      elapsed: 0,\n      fresh: true,\n    };\n  },\n  update(state, input, context) {\n    const config = inkConfig(input);\n    if (JSON.stringify(config) === JSON.stringify(state.config)) return;\n    state.config = config;\n    reset(state, context);\n  },\n  receive(state, message, context) {\n    if (message.type === \"pause\") {\n      state.paused = message.paused;\n      state.elapsed = 0;\n      state.fresh = true;\n      if (!state.paused) context.requestFrame();\n    } else if (message.type === \"reset\") reset(state, context);\n    else if (message.type === \"stir\") {\n      const radius = message.radius ?? 16;\n      if (\n        ![message.u, message.v, message.du, message.dv, radius].every(\n          Number.isFinite,\n        ) ||\n        radius <= 0 ||\n        radius > 128 ||\n        Math.abs(message.du) > 1 ||\n        Math.abs(message.dv) > 1\n      )\n        throw new RangeError(\"Invalid ink stir message.\");\n      if (message.u < 0 || message.u > 1 || message.v < 0 || message.v > 1)\n        return;\n      state.simulation.stir(\n        message.u * context.canvas.width,\n        message.v * context.canvas.height,\n        message.du * context.canvas.width,\n        message.dv * context.canvas.height,\n        radius,\n      );\n      context.invalidate();\n    } else if (message.type === \"paint\") {\n      const radius = message.radius ?? 6,\n        strength = message.strength ?? 0.8;\n      if (\n        ![message.u, message.v, radius, strength].every(Number.isFinite) ||\n        radius <= 0 ||\n        radius > 128 ||\n        strength < 0 ||\n        strength > 1\n      )\n        throw new RangeError(\"Invalid ink paint message.\");\n      if (message.u < 0 || message.v < 0 || message.u > 1 || message.v > 1)\n        return;\n      state.simulation.paint(\n        message.u * context.canvas.width,\n        message.v * context.canvas.height,\n        radius,\n        strength,\n      );\n      context.invalidate();\n    } else throw new TypeError(\"Unknown ink message.\");\n  },\n  advance(state, frame, context) {\n    if (state.paused) return;\n    if (!state.fresh) {\n      state.elapsed += Math.min(50, frame.delta);\n      const steps = Math.min(24, Math.floor(state.elapsed * 0.48 + 1e-9));\n      state.elapsed -= steps / 0.48;\n      if (steps) {\n        state.simulation.advance(steps);\n        context.invalidate();\n      }\n    }\n    state.fresh = false;\n    context.requestFrame();\n  },\n  rasterize(state, context) {\n    colorize(state.simulation.b, context, 650 / 255);\n  },\n  dispose(state) {\n    state.simulation.dispose();\n  },\n});\n/**\n * Creates a stateful reaction-diffusion texture recipe supporting paint, stirring, pause, and\n * reset\n * messages.\n *\n * @param options - Reaction and diffusion parameters, initialization, and rendering options. See\n * {@link ReactionDiffusionOptions} .\n * @returns A reaction-diffusion texture recipe for useTexture.\n *\n * @see {@link ReactionDiffusionOptions}\n */\nexport function reactionDiffusion(options: ReactionDiffusionOptions = {}) {\n  return inkRecipe(options);\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/features/textures/lib/geometric-patterns.d.ts

@@ -0,0 +1,149 @@
+import { type TextureRecipe } from "@pibbl/core";
+import type { PatternMotionOptions } from "./patterns.js";
+/** Seamless circular dots with optional stagger and seeded displacement. @see {@link polkaDots} */
+export interface PolkaDotsOptions extends PatternMotionOptions {
+    /** Integer columns, 1–64; default 12. See {@link PolkaDotsOptions}. */
+    readonly columns?: number;
+    /** Even integer rows, 2–64; default 12, preserving stagger across the seam. See {@link PolkaDotsOptions}. */
+    readonly rows?: number;
+    /** Radius in cell fractions, 0–0.5; default 0.3. See {@link PolkaDotsOptions}. */
+    readonly radius?: number;
+    /** Alternate-row horizontal offset in cell fractions, 0–1; default 0. See {@link PolkaDotsOptions}. */
+    readonly stagger?: number;
+    /** Seeded center displacement per axis in cell fractions, 0–0.5; default 0. See {@link PolkaDotsOptions}. */
+    readonly jitter?: number;
+    /** Unsigned 32-bit variation seed; default 42. See {@link PolkaDotsOptions}. */
+    readonly seed?: number;
+}
+/** A periodic tonal field expressed as varying dot sizes. @see {@link halftone} */
+export interface HalftoneOptions extends PatternMotionOptions {
+    /** Integer columns, 1–64; default 24. See {@link HalftoneOptions}. */
+    readonly columns?: number;
+    /** Even integer rows, 2–64; default 24. See {@link HalftoneOptions}. */
+    readonly rows?: number;
+    /** Smallest dot radius in cell fractions, 0–0.5; default 0.05. See {@link HalftoneOptions}. */
+    readonly minRadius?: number;
+    /** Largest dot radius in cell fractions, minRadius–0.5; default 0.45. See {@link HalftoneOptions}. */
+    readonly maxRadius?: number;
+    /** Integer horizontal tonal periods, 0–16; default 1. See {@link HalftoneOptions}. */
+    readonly cyclesX?: number;
+    /** Integer vertical tonal periods, 0–16; default 1. See {@link HalftoneOptions}. */
+    readonly cyclesY?: number;
+    /** Tonal wave amplitude, 0–1; default 0.7. See {@link HalftoneOptions}. */
+    readonly contrast?: number;
+    /** Alternate-row offset in cell fractions, 0–1; default 0.5. See {@link HalftoneOptions}. */
+    readonly stagger?: number;
+}
+/** Seeded connecting quarter-circle tiles. @see {@link truchet} */
+export interface TruchetOptions extends PatternMotionOptions {
+    /** Integer columns, 1–64; default 8. See {@link TruchetOptions}. */
+    readonly columns?: number;
+    /** Integer rows, 1–64; default 8. See {@link TruchetOptions}. */
+    readonly rows?: number;
+    /** Stroke width in cell fractions, 0–0.5; default 0.12. See {@link TruchetOptions}. */
+    readonly lineWidth?: number;
+    /** Fraction of tiles with the first orientation, 0–1; default 0.5. See {@link TruchetOptions}. */
+    readonly orientationBias?: number;
+    /** Unsigned 32-bit orientation seed; default 42. See {@link TruchetOptions}. */
+    readonly seed?: number;
+}
+/** One band in an ordered plaid repeat; colors are named keys. @see {@link PlaidOptions} */
+export interface PlaidBand<Key extends string = string> {
+    /** Positive relative width; all widths on an axis are normalized together. See {@link PlaidBand}. */
+    readonly width: number;
+    /** A key from the plaid's colors dictionary. See {@link PlaidBand}. */
+    readonly color: Key;
+}
+/** A plaid's named colors, ordered bands, and crossing balance. @see {@link plaid} */
+export interface PlaidOptions<Colors extends Readonly<Record<string, string>> = Readonly<Record<string, string>>> extends PatternMotionOptions {
+    /** Dictionary of 1–16 opaque #RRGGBB colors. See {@link PlaidOptions}. */
+    readonly colors: Colors;
+    /** Ordered horizontal bands, 1–32, referencing existing color keys. See {@link PlaidOptions}. */
+    readonly horizontal: readonly PlaidBand<NoInfer<Extract<keyof Colors, string>>>[];
+    /** Ordered vertical bands, 1–32, referencing existing color keys. See {@link PlaidOptions}. */
+    readonly vertical: readonly PlaidBand<NoInfer<Extract<keyof Colors, string>>>[];
+    /** Horizontal contribution at crossings, 0–1; default 0.5. See {@link PlaidOptions}. */
+    readonly crossing?: number;
+}
+/**
+ * Creates a seamless dot lattice using palette endpoints.
+ * @param options - Dot geometry and motion.
+ * @returns A mountable texture recipe.
+ * @see {@link PolkaDotsOptions}
+ */
+export declare function polkaDots(options?: PolkaDotsOptions): TextureRecipe;
+/**
+ * Creates seamless varying-size dots from a periodic tonal field.
+ * @param options - Dot sizes, tonal periods, and motion.
+ * @returns A mountable texture recipe.
+ * @see {@link HalftoneOptions}
+ */
+export declare function halftone(options?: HalftoneOptions): TextureRecipe;
+/**
+ * Creates seeded quarter-circle tiles that connect across every edge.
+ * @param options - Tile counts, stroke width, seed, and motion.
+ * @returns A mountable texture recipe.
+ * @see {@link TruchetOptions}
+ */
+export declare function truchet(options?: TruchetOptions): TextureRecipe;
+/**
+ * Creates plaid using checked color keys and ordered relative-width bands.
+ * @param options - Named colors, bands, crossing balance, and motion.
+ * @returns A mountable texture recipe.
+ * @see {@link PlaidOptions}
+ */
+export declare function plaid<const Colors extends Readonly<Record<string, string>>>(options: PlaidOptions<Colors>): TextureRecipe;
+/** Named-color band configurations for gingham, tartan, and windowpane patterns. @see {@link plaid} */
+export declare const plaidPresets: Readonly<{
+    /** Equal-width alternating bands. See {@link plaidPresets}. */
+    gingham: Readonly<{
+        colors: Readonly<{
+            background: "#f5e9d3";
+            primary: "#304c48";
+            accent: "#c56948";
+        }>;
+        horizontal: readonly Readonly<{
+            width: number;
+            color: "accent" | "background" | "primary";
+        }>[];
+        vertical: readonly Readonly<{
+            width: number;
+            color: "accent" | "background" | "primary";
+        }>[];
+        crossing: 0.5;
+    }>;
+    /** Symmetric bands with narrow accent lines. See {@link plaidPresets}. */
+    tartan: Readonly<{
+        colors: Readonly<{
+            background: "#f5e9d3";
+            primary: "#304c48";
+            accent: "#c56948";
+        }>;
+        horizontal: readonly Readonly<{
+            width: number;
+            color: "accent" | "background" | "primary";
+        }>[];
+        vertical: readonly Readonly<{
+            width: number;
+            color: "accent" | "background" | "primary";
+        }>[];
+        crossing: 0.5;
+    }>;
+    /** Narrow crossing lines on a broad background. See {@link plaidPresets}. */
+    windowpane: Readonly<{
+        colors: Readonly<{
+            background: "#f5e9d3";
+            primary: "#304c48";
+            accent: "#c56948";
+        }>;
+        horizontal: readonly Readonly<{
+            width: number;
+            color: "accent" | "background" | "primary";
+        }>[];
+        vertical: readonly Readonly<{
+            width: number;
+            color: "accent" | "background" | "primary";
+        }>[];
+        crossing: 0.5;
+    }>;
+}>;