@pibbl/core 0.0.1

package/dist/features/textures/lib/reaction-diffusion.js

@@ -0,0 +1,210 @@
+import { defineRenderLayer } from "@pibbl/core";
+import { TextureRaster } from "./presentation.js";
+import { InkSimulation } from "./simulation.js";
+import {
+  paletteLut,
+  texturePalettes,
+  validateResolution,
+  validateSeed
+} from "./palette.js";
+function options(props) {
+  const preset = props.preset ?? "spots";
+  if (preset !== "spots" && preset !== "stripes")
+    throw new TypeError("Unknown reaction-diffusion preset.");
+  const brush = props.brush ?? { radius: 6, strength: 0.8 };
+  if (brush && (!Number.isFinite(brush.radius) || brush.radius <= 0 || brush.radius > 128 || !Number.isFinite(brush.strength) || brush.strength < 0 || brush.strength > 1))
+    throw new RangeError(
+      "Brush radius must be in (0,128] and strength in [0,1]."
+    );
+  if (!Number.isSafeInteger(props.resetRevision ?? 0))
+    throw new RangeError("resetRevision must be a safe integer.");
+  return {
+    resolution: validateResolution(props.resolution),
+    seed: validateSeed(props.seed),
+    preset,
+    palette: [...props.palette ?? texturePalettes.lagoon],
+    paused: props.paused ?? false,
+    resetRevision: props.resetRevision ?? 0,
+    brush: brush && { ...brush }
+  };
+}
+function reset(r, config) {
+  const { width, height } = config.resolution;
+  const simulation = new InkSimulation(
+    width,
+    height,
+    config.seed,
+    config.preset
+  );
+  let raster;
+  try {
+    raster = new TextureRaster(width, height);
+  } catch (error) {
+    simulation.dispose();
+    throw error;
+  }
+  r.simulation.dispose();
+  r.simulation = simulation;
+  r.raster.dispose();
+  r.raster = raster;
+  r.strokes.length = 0;
+  r.pointer?.release();
+  r.pointer = void 0;
+  r.elapsed = 0;
+  r.fresh = true;
+  r.dirty = true;
+}
+function input(r, event, width, height) {
+  if (r.disposed) return;
+  const original = event.originalEvent;
+  if (event.type === "pointerup" || event.type === "pointercancel") {
+    if (r.pointer?.id === original.pointerId) {
+      r.pointer.release();
+      r.pointer = void 0;
+    }
+    return;
+  }
+  const brush = r.config.brush;
+  if (!brush || width <= 0 || height <= 0) return;
+  const x = event.point.x / width * r.simulation.width;
+  const y = event.point.y / height * r.simulation.height;
+  if (event.type === "pointerdown") {
+    if (r.pointer || original.button !== 0 || original.isPrimary === false)
+      return;
+    event.setPointerCapture(original.pointerId);
+    r.pointer = {
+      id: original.pointerId,
+      x,
+      y,
+      release: () => event.releasePointerCapture(original.pointerId)
+    };
+  } else if (event.type !== "pointermove" || r.pointer?.id !== original.pointerId)
+    return;
+  const previous = r.pointer;
+  const distance = Math.hypot(x - previous.x, y - previous.y);
+  const count = Math.min(
+    4096,
+    Math.max(1, Math.ceil(distance / Math.max(0.5, brush.radius * 0.3)))
+  );
+  for (let i = 1; i <= count; i++) {
+    const px = previous.x + (x - previous.x) * i / count, py = previous.y + (y - previous.y) * i / count;
+    if (px >= 0 && py >= 0 && px < r.simulation.width && py < r.simulation.height && r.strokes.length < 8192)
+      r.strokes.push({ x: px, y: py, ...brush });
+  }
+  previous.x = x;
+  previous.y = y;
+  r.invalidate();
+}
+const ReactionDiffusion = /* @__PURE__ */ defineRenderLayer({
+  create(context, props) {
+    const config = options(props), lut = paletteLut(config.palette);
+    const output = context.canvas.getContext("2d");
+    if (!output) throw new Error("ReactionDiffusion requires Canvas 2D.");
+    const { width, height } = config.resolution;
+    const raster = new TextureRaster(width, height);
+    try {
+      return {
+        config,
+        lut,
+        raster,
+        output,
+        render: props.render,
+        simulation: new InkSimulation(
+          width,
+          height,
+          config.seed,
+          config.preset
+        ),
+        elapsed: 0,
+        fresh: true,
+        dirty: true,
+        disposed: false,
+        target: {},
+        strokes: [],
+        invalidate: context.invalidate
+      };
+    } catch (error) {
+      raster.dispose();
+      throw error;
+    }
+  },
+  update(r, props) {
+    const next = options(props), old = r.config;
+    if (next.palette.join() !== old.palette.join()) {
+      r.lut = paletteLut(next.palette);
+      r.dirty = true;
+    }
+    if (next.seed !== old.seed || next.preset !== old.preset || next.resetRevision !== old.resetRevision || next.resolution.width !== old.resolution.width || next.resolution.height !== old.resolution.height)
+      reset(r, next);
+    if (next.paused !== old.paused) {
+      r.elapsed = 0;
+      r.fresh = true;
+    }
+    if (!next.brush) {
+      r.pointer?.release();
+      r.pointer = void 0;
+    }
+    r.config = next;
+    r.render = props.render;
+  },
+  render(r, frame, context) {
+    r.invalidate = frame.invalidate;
+    for (const stroke of r.strokes)
+      r.simulation.paint(stroke.x, stroke.y, stroke.radius, stroke.strength);
+    if (r.strokes.length) r.dirty = true;
+    r.strokes.length = 0;
+    if (!r.config.paused && !r.fresh) {
+      r.elapsed += Math.max(0, Math.min(50, frame.delta));
+      const steps = Math.min(24, Math.floor(r.elapsed * 0.48 + 1e-9));
+      r.elapsed -= steps / 0.48;
+      if (steps) {
+        r.simulation.advance(steps);
+        r.dirty = true;
+      }
+    }
+    r.fresh = false;
+    if (r.dirty) {
+      r.raster.update(r.simulation.b, r.lut, 650 / 255);
+      r.dirty = false;
+    }
+    r.raster.draw(
+      r.output,
+      context.size.width,
+      context.size.height,
+      context.size.backingWidth,
+      context.size.backingHeight,
+      r.render
+    );
+    if (!r.config.paused) frame.invalidate();
+  },
+  interaction: {
+    settle(r, _props, size) {
+      return {
+        targets: [
+          {
+            target: r.target,
+            cursor: r.config.brush ? "crosshair" : "default"
+          }
+        ],
+        hitTest: () => ({ kind: "target", target: r.target }),
+        onInput: (event) => input(r, event, size.width, size.height)
+      };
+    }
+  },
+  dispose(r) {
+    if (r.disposed) return;
+    r.disposed = true;
+    r.pointer?.release();
+    r.pointer = void 0;
+    r.strokes.length = 0;
+    r.invalidate = () => {
+    };
+    r.simulation.dispose();
+    r.raster.dispose();
+    r.render = void 0;
+  }
+});
+export {
+  ReactionDiffusion
+};
+//# sourceMappingURL=reaction-diffusion.js.map

package/dist/features/textures/lib/reaction-diffusion.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/reaction-diffusion.ts"],
+  "sourcesContent": ["import { defineRenderLayer, type PibblRenderLayerInput } from \"@pibbl/core\";\nimport { TextureRaster, type TextureRenderer } from \"./presentation.js\";\nimport { InkSimulation } from \"./simulation.js\";\nimport {\n  paletteLut,\n  texturePalettes,\n  validateResolution,\n  validateSeed,\n  type TexturePalette,\n  type TextureResolution,\n} from \"./palette.js\";\n\n/**\n * Radius and strength of a reaction-diffusion brush stroke.\n *\n * @see {@link ReactionDiffusionProps}\n */\nexport interface TextureBrush {\n  /** Radius in the coordinate system of this geometry or effect. See {@link TextureBrush}. */\n  readonly radius: number;\n  /** Magnitude of the displacement or brush effect. See {@link TextureBrush}. */\n  readonly strength: number;\n}\n/**\n * Authored inputs for ReactionDiffusion, including the declared data and presentation options.\n *\n * @see {@link TextureRenderer}\n * @see {@link TextureResolution}\n * @see {@link TexturePalette}\n * @see {@link TextureBrush}\n * @see {@link ReactionDiffusion}\n */\nexport interface ReactionDiffusionProps {\n  /**\n   * Renders the current data or resources using the supplied context. See {@link TextureRenderer}\n   * .\n   */\n  readonly render?: TextureRenderer;\n  /** Dimensions of the simulation or raster grid. See {@link TextureResolution}. */\n  readonly resolution?: TextureResolution;\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly seed?: number;\n  /**\n   * Named pattern configuration used to initialize the simulation. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly preset?: \"spots\" | \"stripes\";\n  /** Ordered colors used to present texture intensity. See {@link TexturePalette}. */\n  readonly palette?: TexturePalette;\n  /**\n   * Whether simulation or playback advancement is suspended. See {@link ReactionDiffusionProps}.\n   */\n  readonly paused?: boolean;\n  /**\n   * Changing this revision requests a fresh simulation initialization. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly resetRevision?: number;\n  /**\n   * Brush configuration for interactive reaction-diffusion input, or false to disable it. See\n   * {@link TextureBrush}.\n   */\n  readonly brush?: TextureBrush | false;\n}\ninterface Options {\n  resolution: TextureResolution;\n  seed: number;\n  preset: \"spots\" | \"stripes\";\n  palette: TexturePalette;\n  paused: boolean;\n  resetRevision: number;\n  brush: TextureBrush | false;\n}\nfunction options(props: ReactionDiffusionProps): Options {\n  const preset = props.preset ?? \"spots\";\n  if (preset !== \"spots\" && preset !== \"stripes\")\n    throw new TypeError(\"Unknown reaction-diffusion preset.\");\n  const brush = props.brush ?? { radius: 6, strength: 0.8 };\n  if (\n    brush &&\n    (!Number.isFinite(brush.radius) ||\n      brush.radius <= 0 ||\n      brush.radius > 128 ||\n      !Number.isFinite(brush.strength) ||\n      brush.strength < 0 ||\n      brush.strength > 1)\n  )\n    throw new RangeError(\n      \"Brush radius must be in (0,128] and strength in [0,1].\",\n    );\n  if (!Number.isSafeInteger(props.resetRevision ?? 0))\n    throw new RangeError(\"resetRevision must be a safe integer.\");\n  return {\n    resolution: validateResolution(props.resolution),\n    seed: validateSeed(props.seed),\n    preset,\n    palette: [...(props.palette ?? texturePalettes.lagoon)],\n    paused: props.paused ?? false,\n    resetRevision: props.resetRevision ?? 0,\n    brush: brush && { ...brush },\n  };\n}\ninterface Stroke {\n  x: number;\n  y: number;\n  radius: number;\n  strength: number;\n}\ninterface Resources {\n  render?: TextureRenderer;\n  config: Options;\n  simulation: InkSimulation;\n  raster: TextureRaster;\n  output: OffscreenCanvasRenderingContext2D;\n  lut: Uint8ClampedArray;\n  elapsed: number;\n  fresh: boolean;\n  dirty: boolean;\n  disposed: boolean;\n  target: object;\n  strokes: Stroke[];\n  pointer?: { id: number; x: number; y: number; release: () => void };\n  invalidate: () => void;\n}\nfunction reset(r: Resources, config: Options) {\n  const { width, height } = config.resolution;\n  const simulation = new InkSimulation(\n    width,\n    height,\n    config.seed,\n    config.preset,\n  );\n  let raster: TextureRaster;\n  try {\n    raster = new TextureRaster(width, height);\n  } catch (error) {\n    simulation.dispose();\n    throw error;\n  }\n  r.simulation.dispose();\n  r.simulation = simulation;\n  r.raster.dispose();\n  r.raster = raster;\n  r.strokes.length = 0;\n  r.pointer?.release();\n  r.pointer = undefined;\n  r.elapsed = 0;\n  r.fresh = true;\n  r.dirty = true;\n}\nfunction input(\n  r: Resources,\n  event: Readonly<PibblRenderLayerInput<object>>,\n  width: number,\n  height: number,\n) {\n  if (r.disposed) return;\n  const original = event.originalEvent as PointerEvent;\n  if (event.type === \"pointerup\" || event.type === \"pointercancel\") {\n    if (r.pointer?.id === original.pointerId) {\n      r.pointer.release();\n      r.pointer = undefined;\n    }\n    return;\n  }\n  const brush = r.config.brush;\n  if (!brush || width <= 0 || height <= 0) return;\n  const x = (event.point.x / width) * r.simulation.width;\n  const y = (event.point.y / height) * r.simulation.height;\n  if (event.type === \"pointerdown\") {\n    if (r.pointer || original.button !== 0 || original.isPrimary === false)\n      return;\n    event.setPointerCapture(original.pointerId);\n    r.pointer = {\n      id: original.pointerId,\n      x,\n      y,\n      release: () => event.releasePointerCapture(original.pointerId),\n    };\n  } else if (\n    event.type !== \"pointermove\" ||\n    r.pointer?.id !== original.pointerId\n  )\n    return;\n  const previous = r.pointer!;\n  const distance = Math.hypot(x - previous.x, y - previous.y);\n  // Bound work for off-surface capture. Stamps outside the field are ignored, never clamped to its edge.\n  const count = Math.min(\n    4096,\n    Math.max(1, Math.ceil(distance / Math.max(0.5, brush.radius * 0.3))),\n  );\n  for (let i = 1; i <= count; i++) {\n    const px = previous.x + ((x - previous.x) * i) / count,\n      py = previous.y + ((y - previous.y) * i) / count;\n    if (\n      px >= 0 &&\n      py >= 0 &&\n      px < r.simulation.width &&\n      py < r.simulation.height &&\n      r.strokes.length < 8192\n    )\n      r.strokes.push({ x: px, y: py, ...brush });\n  }\n  previous.x = x;\n  previous.y = y;\n  r.invalidate();\n}\n\n/**\n * An independently sized, persistent Gray\u2013Scott surface, advanced by Pibbl's scheduler.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link ReactionDiffusionProps}\n */\nexport const ReactionDiffusion = /* @__PURE__ */ defineRenderLayer<\n  ReactionDiffusionProps,\n  Resources\n>({\n  create(context, props) {\n    const config = options(props),\n      lut = paletteLut(config.palette);\n    const output = context.canvas.getContext(\"2d\");\n    if (!output) throw new Error(\"ReactionDiffusion requires Canvas 2D.\");\n    const { width, height } = config.resolution;\n    const raster = new TextureRaster(width, height);\n    try {\n      return {\n        config,\n        lut,\n        raster,\n        output,\n        render: props.render,\n        simulation: new InkSimulation(\n          width,\n          height,\n          config.seed,\n          config.preset,\n        ),\n        elapsed: 0,\n        fresh: true,\n        dirty: true,\n        disposed: false,\n        target: {},\n        strokes: [],\n        invalidate: context.invalidate,\n      };\n    } catch (error) {\n      raster.dispose();\n      throw error;\n    }\n  },\n  update(r, props) {\n    const next = options(props),\n      old = r.config;\n    if (next.palette.join() !== old.palette.join()) {\n      r.lut = paletteLut(next.palette);\n      r.dirty = true;\n    }\n    if (\n      next.seed !== old.seed ||\n      next.preset !== old.preset ||\n      next.resetRevision !== old.resetRevision ||\n      next.resolution.width !== old.resolution.width ||\n      next.resolution.height !== old.resolution.height\n    )\n      reset(r, next);\n    if (next.paused !== old.paused) {\n      r.elapsed = 0;\n      r.fresh = true;\n    }\n    if (!next.brush) {\n      r.pointer?.release();\n      r.pointer = undefined;\n    }\n    r.config = next;\n    r.render = props.render;\n  },\n  render(r, frame, context) {\n    // The frame invalidator does not gate the committed input snapshot between brush samples.\n    r.invalidate = frame.invalidate;\n    for (const stroke of r.strokes)\n      r.simulation.paint(stroke.x, stroke.y, stroke.radius, stroke.strength);\n    if (r.strokes.length) r.dirty = true;\n    r.strokes.length = 0;\n    if (!r.config.paused && !r.fresh) {\n      r.elapsed += Math.max(0, Math.min(50, frame.delta));\n      const steps = Math.min(24, Math.floor(r.elapsed * 0.48 + 1e-9));\n      r.elapsed -= steps / 0.48;\n      if (steps) {\n        r.simulation.advance(steps);\n        r.dirty = true;\n      }\n    }\n    r.fresh = false;\n    if (r.dirty) {\n      r.raster.update(r.simulation.b, r.lut, 650 / 255);\n      r.dirty = false;\n    }\n    r.raster.draw(\n      r.output,\n      context.size.width,\n      context.size.height,\n      context.size.backingWidth,\n      context.size.backingHeight,\n      r.render,\n    );\n    if (!r.config.paused) frame.invalidate();\n  },\n  interaction: {\n    settle(r, _props, size) {\n      return {\n        targets: [\n          {\n            target: r.target,\n            cursor: r.config.brush ? \"crosshair\" : \"default\",\n          },\n        ],\n        hitTest: () => ({ kind: \"target\", target: r.target }),\n        onInput: (event) => input(r, event, size.width, size.height),\n      };\n    },\n  },\n  dispose(r) {\n    if (r.disposed) return;\n    r.disposed = true;\n    r.pointer?.release();\n    r.pointer = undefined;\n    r.strokes.length = 0;\n    r.invalidate = () => {};\n    r.simulation.dispose();\n    r.raster.dispose();\n    r.render = undefined;\n  },\n});\n"],
+  "mappings": "AAAA,SAAS,yBAAqD;AAC9D,SAAS,qBAA2C;AACpD,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAkEP,SAAS,QAAQ,OAAwC;AACvD,QAAM,SAAS,MAAM,UAAU;AAC/B,MAAI,WAAW,WAAW,WAAW;AACnC,UAAM,IAAI,UAAU,oCAAoC;AAC1D,QAAM,QAAQ,MAAM,SAAS,EAAE,QAAQ,GAAG,UAAU,IAAI;AACxD,MACE,UACC,CAAC,OAAO,SAAS,MAAM,MAAM,KAC5B,MAAM,UAAU,KAChB,MAAM,SAAS,OACf,CAAC,OAAO,SAAS,MAAM,QAAQ,KAC/B,MAAM,WAAW,KACjB,MAAM,WAAW;AAEnB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,MAAI,CAAC,OAAO,cAAc,MAAM,iBAAiB,CAAC;AAChD,UAAM,IAAI,WAAW,uCAAuC;AAC9D,SAAO;AAAA,IACL,YAAY,mBAAmB,MAAM,UAAU;AAAA,IAC/C,MAAM,aAAa,MAAM,IAAI;AAAA,IAC7B;AAAA,IACA,SAAS,CAAC,GAAI,MAAM,WAAW,gBAAgB,MAAO;AAAA,IACtD,QAAQ,MAAM,UAAU;AAAA,IACxB,eAAe,MAAM,iBAAiB;AAAA,IACtC,OAAO,SAAS,EAAE,GAAG,MAAM;AAAA,EAC7B;AACF;AAuBA,SAAS,MAAM,GAAc,QAAiB;AAC5C,QAAM,EAAE,OAAO,OAAO,IAAI,OAAO;AACjC,QAAM,aAAa,IAAI;AAAA,IACrB;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP,OAAO;AAAA,EACT;AACA,MAAI;AACJ,MAAI;AACF,aAAS,IAAI,cAAc,OAAO,MAAM;AAAA,EAC1C,SAAS,OAAO;AACd,eAAW,QAAQ;AACnB,UAAM;AAAA,EACR;AACA,IAAE,WAAW,QAAQ;AACrB,IAAE,aAAa;AACf,IAAE,OAAO,QAAQ;AACjB,IAAE,SAAS;AACX,IAAE,QAAQ,SAAS;AACnB,IAAE,SAAS,QAAQ;AACnB,IAAE,UAAU;AACZ,IAAE,UAAU;AACZ,IAAE,QAAQ;AACV,IAAE,QAAQ;AACZ;AACA,SAAS,MACP,GACA,OACA,OACA,QACA;AACA,MAAI,EAAE,SAAU;AAChB,QAAM,WAAW,MAAM;AACvB,MAAI,MAAM,SAAS,eAAe,MAAM,SAAS,iBAAiB;AAChE,QAAI,EAAE,SAAS,OAAO,SAAS,WAAW;AACxC,QAAE,QAAQ,QAAQ;AAClB,QAAE,UAAU;AAAA,IACd;AACA;AAAA,EACF;AACA,QAAM,QAAQ,EAAE,OAAO;AACvB,MAAI,CAAC,SAAS,SAAS,KAAK,UAAU,EAAG;AACzC,QAAM,IAAK,MAAM,MAAM,IAAI,QAAS,EAAE,WAAW;AACjD,QAAM,IAAK,MAAM,MAAM,IAAI,SAAU,EAAE,WAAW;AAClD,MAAI,MAAM,SAAS,eAAe;AAChC,QAAI,EAAE,WAAW,SAAS,WAAW,KAAK,SAAS,cAAc;AAC/D;AACF,UAAM,kBAAkB,SAAS,SAAS;AAC1C,MAAE,UAAU;AAAA,MACV,IAAI,SAAS;AAAA,MACb;AAAA,MACA;AAAA,MACA,SAAS,MAAM,MAAM,sBAAsB,SAAS,SAAS;AAAA,IAC/D;AAAA,EACF,WACE,MAAM,SAAS,iBACf,EAAE,SAAS,OAAO,SAAS;AAE3B;AACF,QAAM,WAAW,EAAE;AACnB,QAAM,WAAW,KAAK,MAAM,IAAI,SAAS,GAAG,IAAI,SAAS,CAAC;AAE1D,QAAM,QAAQ,KAAK;AAAA,IACjB;AAAA,IACA,KAAK,IAAI,GAAG,KAAK,KAAK,WAAW,KAAK,IAAI,KAAK,MAAM,SAAS,GAAG,CAAC,CAAC;AAAA,EACrE;AACA,WAAS,IAAI,GAAG,KAAK,OAAO,KAAK;AAC/B,UAAM,KAAK,SAAS,KAAM,IAAI,SAAS,KAAK,IAAK,OAC/C,KAAK,SAAS,KAAM,IAAI,SAAS,KAAK,IAAK;AAC7C,QACE,MAAM,KACN,MAAM,KACN,KAAK,EAAE,WAAW,SAClB,KAAK,EAAE,WAAW,UAClB,EAAE,QAAQ,SAAS;AAEnB,QAAE,QAAQ,KAAK,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAAA,EAC7C;AACA,WAAS,IAAI;AACb,WAAS,IAAI;AACb,IAAE,WAAW;AACf;AAWO,MAAM,oBAAoC,kCAG/C;AAAA,EACA,OAAO,SAAS,OAAO;AACrB,UAAM,SAAS,QAAQ,KAAK,GAC1B,MAAM,WAAW,OAAO,OAAO;AACjC,UAAM,SAAS,QAAQ,OAAO,WAAW,IAAI;AAC7C,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,uCAAuC;AACpE,UAAM,EAAE,OAAO,OAAO,IAAI,OAAO;AACjC,UAAM,SAAS,IAAI,cAAc,OAAO,MAAM;AAC9C,QAAI;AACF,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,QAAQ,MAAM;AAAA,QACd,YAAY,IAAI;AAAA,UACd;AAAA,UACA;AAAA,UACA,OAAO;AAAA,UACP,OAAO;AAAA,QACT;AAAA,QACA,SAAS;AAAA,QACT,OAAO;AAAA,QACP,OAAO;AAAA,QACP,UAAU;AAAA,QACV,QAAQ,CAAC;AAAA,QACT,SAAS,CAAC;AAAA,QACV,YAAY,QAAQ;AAAA,MACtB;AAAA,IACF,SAAS,OAAO;AACd,aAAO,QAAQ;AACf,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,OAAO,GAAG,OAAO;AACf,UAAM,OAAO,QAAQ,KAAK,GACxB,MAAM,EAAE;AACV,QAAI,KAAK,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,GAAG;AAC9C,QAAE,MAAM,WAAW,KAAK,OAAO;AAC/B,QAAE,QAAQ;AAAA,IACZ;AACA,QACE,KAAK,SAAS,IAAI,QAClB,KAAK,WAAW,IAAI,UACpB,KAAK,kBAAkB,IAAI,iBAC3B,KAAK,WAAW,UAAU,IAAI,WAAW,SACzC,KAAK,WAAW,WAAW,IAAI,WAAW;AAE1C,YAAM,GAAG,IAAI;AACf,QAAI,KAAK,WAAW,IAAI,QAAQ;AAC9B,QAAE,UAAU;AACZ,QAAE,QAAQ;AAAA,IACZ;AACA,QAAI,CAAC,KAAK,OAAO;AACf,QAAE,SAAS,QAAQ;AACnB,QAAE,UAAU;AAAA,IACd;AACA,MAAE,SAAS;AACX,MAAE,SAAS,MAAM;AAAA,EACnB;AAAA,EACA,OAAO,GAAG,OAAO,SAAS;AAExB,MAAE,aAAa,MAAM;AACrB,eAAW,UAAU,EAAE;AACrB,QAAE,WAAW,MAAM,OAAO,GAAG,OAAO,GAAG,OAAO,QAAQ,OAAO,QAAQ;AACvE,QAAI,EAAE,QAAQ,OAAQ,GAAE,QAAQ;AAChC,MAAE,QAAQ,SAAS;AACnB,QAAI,CAAC,EAAE,OAAO,UAAU,CAAC,EAAE,OAAO;AAChC,QAAE,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,KAAK,CAAC;AAClD,YAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,EAAE,UAAU,OAAO,IAAI,CAAC;AAC9D,QAAE,WAAW,QAAQ;AACrB,UAAI,OAAO;AACT,UAAE,WAAW,QAAQ,KAAK;AAC1B,UAAE,QAAQ;AAAA,MACZ;AAAA,IACF;AACA,MAAE,QAAQ;AACV,QAAI,EAAE,OAAO;AACX,QAAE,OAAO,OAAO,EAAE,WAAW,GAAG,EAAE,KAAK,MAAM,GAAG;AAChD,QAAE,QAAQ;AAAA,IACZ;AACA,MAAE,OAAO;AAAA,MACP,EAAE;AAAA,MACF,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,EAAE;AAAA,IACJ;AACA,QAAI,CAAC,EAAE,OAAO,OAAQ,OAAM,WAAW;AAAA,EACzC;AAAA,EACA,aAAa;AAAA,IACX,OAAO,GAAG,QAAQ,MAAM;AACtB,aAAO;AAAA,QACL,SAAS;AAAA,UACP;AAAA,YACE,QAAQ,EAAE;AAAA,YACV,QAAQ,EAAE,OAAO,QAAQ,cAAc;AAAA,UACzC;AAAA,QACF;AAAA,QACA,SAAS,OAAO,EAAE,MAAM,UAAU,QAAQ,EAAE,OAAO;AAAA,QACnD,SAAS,CAAC,UAAU,MAAM,GAAG,OAAO,KAAK,OAAO,KAAK,MAAM;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAAA,EACA,QAAQ,GAAG;AACT,QAAI,EAAE,SAAU;AAChB,MAAE,WAAW;AACb,MAAE,SAAS,QAAQ;AACnB,MAAE,UAAU;AACZ,MAAE,QAAQ,SAAS;AACnB,MAAE,aAAa,MAAM;AAAA,IAAC;AACtB,MAAE,WAAW,QAAQ;AACrB,MAAE,OAAO,QAAQ;AACjB,MAAE,SAAS;AAAA,EACb;AACF,CAAC;",
+  "names": []
+}

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

@@ -0,0 +1,16 @@
+/** Private WASM Gray–Scott state. Pibbl owns the clock and resource lifetime. */
+export declare class InkSimulation {
+    readonly width: number;
+    readonly height: number;
+    readonly preset: "spots" | "stripes";
+    a: Float32Array;
+    b: Float32Array;
+    private owner?;
+    private parity;
+    steps: number;
+    constructor(width: number, height: number, seed: number, preset: "spots" | "stripes");
+    paint(x: number, y: number, radius: number, strength: number): void;
+    stir(x: number, y: number, dx: number, dy: number, radius: number): void;
+    advance(count: number): void;
+    dispose(): void;
+}

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

@@ -0,0 +1,85 @@
+import { FieldMemory, lazyKernel } from "./wasm/memory.js";
+import { bytes } from "./wasm/ink-bytes.js";
+const module = /* @__PURE__ */ lazyKernel(bytes);
+class InkSimulation {
+  constructor(width, height, seed, preset) {
+    this.width = width;
+    this.height = height;
+    this.preset = preset;
+    const owner = this.owner = new FieldMemory(module(), width, height, 4);
+    [this.a, this.b] = owner.fields;
+    owner.kernel.initialize(
+      this.a.byteOffset,
+      this.b.byteOffset,
+      width,
+      height,
+      seed
+    );
+  }
+  width;
+  height;
+  preset;
+  a;
+  b;
+  owner;
+  parity = 0;
+  steps = 0;
+  paint(x, y, radius, strength) {
+    const owner = this.owner;
+    owner.stamps[0] = x;
+    owner.stamps[1] = y;
+    owner.stamps[2] = radius;
+    owner.stamps[3] = strength;
+    owner.kernel.paintBatch(
+      this.a.byteOffset,
+      this.b.byteOffset,
+      this.width,
+      this.height,
+      owner.stamps.byteOffset,
+      1
+    );
+  }
+  stir(x, y, dx, dy, radius) {
+    const owner = this.owner, next = 2 - this.parity;
+    owner.kernel.stir(
+      this.a.byteOffset,
+      this.b.byteOffset,
+      owner.fields[next].byteOffset,
+      owner.fields[next + 1].byteOffset,
+      this.width,
+      this.height,
+      x,
+      y,
+      dx,
+      dy,
+      radius
+    );
+  }
+  advance(count) {
+    const owner = this.owner, next = 2 - this.parity;
+    owner.kernel.advance(
+      this.a.byteOffset,
+      this.b.byteOffset,
+      owner.fields[next].byteOffset,
+      owner.fields[next + 1].byteOffset,
+      this.width,
+      this.height,
+      count,
+      this.preset === "spots" ? 0.0367 : 0.029,
+      this.preset === "spots" ? 0.0649 : 0.057
+    );
+    if (count % 2) this.parity = next;
+    this.a = owner.fields[this.parity];
+    this.b = owner.fields[this.parity + 1];
+    this.steps += count;
+  }
+  dispose() {
+    this.owner?.dispose();
+    this.owner = void 0;
+    this.a = this.b = new Float32Array(0);
+  }
+}
+export {
+  InkSimulation
+};
+//# sourceMappingURL=simulation.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/simulation.ts"],
+  "sourcesContent": ["import { FieldMemory, lazyKernel } from \"./wasm/memory.js\";\nimport { bytes } from \"./wasm/ink-bytes.js\";\nconst module = /* @__PURE__ */ lazyKernel(bytes);\n/** Private WASM Gray\u2013Scott state. Pibbl owns the clock and resource lifetime. */\nexport class InkSimulation {\n  a: Float32Array;\n  b: Float32Array;\n  private owner?: FieldMemory;\n  private parity = 0;\n  steps = 0;\n  constructor(\n    readonly width: number,\n    readonly height: number,\n    seed: number,\n    readonly preset: \"spots\" | \"stripes\",\n  ) {\n    const owner = (this.owner = new FieldMemory(module(), width, height, 4));\n    [this.a, this.b] = owner.fields;\n    owner.kernel.initialize(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      width,\n      height,\n      seed,\n    );\n  }\n  paint(x: number, y: number, radius: number, strength: number) {\n    const owner = this.owner!;\n    owner.stamps[0] = x;\n    owner.stamps[1] = y;\n    owner.stamps[2] = radius;\n    owner.stamps[3] = strength;\n    owner.kernel.paintBatch(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      this.width,\n      this.height,\n      owner.stamps.byteOffset,\n      1,\n    );\n  }\n  stir(x: number, y: number, dx: number, dy: number, radius: number) {\n    const owner = this.owner!,\n      next = 2 - this.parity;\n    owner.kernel.stir(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      owner.fields[next].byteOffset,\n      owner.fields[next + 1].byteOffset,\n      this.width,\n      this.height,\n      x,\n      y,\n      dx,\n      dy,\n      radius,\n    );\n  }\n  advance(count: number) {\n    const owner = this.owner!,\n      next = 2 - this.parity;\n    owner.kernel.advance(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      owner.fields[next].byteOffset,\n      owner.fields[next + 1].byteOffset,\n      this.width,\n      this.height,\n      count,\n      this.preset === \"spots\" ? 0.0367 : 0.029,\n      this.preset === \"spots\" ? 0.0649 : 0.057,\n    );\n    if (count % 2) this.parity = next;\n    this.a = owner.fields[this.parity];\n    this.b = owner.fields[this.parity + 1];\n    this.steps += count;\n  }\n  dispose() {\n    this.owner?.dispose();\n    this.owner = undefined;\n    this.a = this.b = new Float32Array(0);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa,kBAAkB;AACxC,SAAS,aAAa;AACtB,MAAM,SAAyB,2BAAW,KAAK;AAExC,MAAM,cAAc;AAAA,EAMzB,YACW,OACA,QACT,MACS,QACT;AAJS;AACA;AAEA;AAET,UAAM,QAAS,KAAK,QAAQ,IAAI,YAAY,OAAO,GAAG,OAAO,QAAQ,CAAC;AACtE,KAAC,KAAK,GAAG,KAAK,CAAC,IAAI,MAAM;AACzB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAdW;AAAA,EACA;AAAA,EAEA;AAAA,EATX;AAAA,EACA;AAAA,EACQ;AAAA,EACA,SAAS;AAAA,EACjB,QAAQ;AAAA,EAiBR,MAAM,GAAW,GAAW,QAAgB,UAAkB;AAC5D,UAAM,QAAQ,KAAK;AACnB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,MAAM,OAAO;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK,GAAW,GAAW,IAAY,IAAY,QAAgB;AACjE,UAAM,QAAQ,KAAK,OACjB,OAAO,IAAI,KAAK;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,MAAM,OAAO,IAAI,EAAE;AAAA,MACnB,MAAM,OAAO,OAAO,CAAC,EAAE;AAAA,MACvB,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA,QAAQ,OAAe;AACrB,UAAM,QAAQ,KAAK,OACjB,OAAO,IAAI,KAAK;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,MAAM,OAAO,IAAI,EAAE;AAAA,MACnB,MAAM,OAAO,OAAO,CAAC,EAAE;AAAA,MACvB,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA,KAAK,WAAW,UAAU,SAAS;AAAA,MACnC,KAAK,WAAW,UAAU,SAAS;AAAA,IACrC;AACA,QAAI,QAAQ,EAAG,MAAK,SAAS;AAC7B,SAAK,IAAI,MAAM,OAAO,KAAK,MAAM;AACjC,SAAK,IAAI,MAAM,OAAO,KAAK,SAAS,CAAC;AACrC,SAAK,SAAS;AAAA,EAChB;AAAA,EACA,UAAU;AACR,SAAK,OAAO,QAAQ;AACpB,SAAK,QAAQ;AACb,SAAK,IAAI,KAAK,IAAI,IAAI,aAAa,CAAC;AAAA,EACtC;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,57 @@
+import { type ElectricControl, type ElectricOptions, type ElectricPoint } from "./electric-shared.js";
+import { type ElectricSource, type ElectricSourceMessage } from "./electric-sources.js";
+/**
+ * Electrical appearance, source electrodes, boundary, rise, and discharge controls for tendrils.
+ *
+ * @see {@link ElectricOptions}
+ * @see {@link ElectricPoint}
+ * @see {@link ElectricSource}
+ * @see {@link tendrils}
+ */
+export interface TendrilsOptions extends ElectricOptions {
+    /** Common electrode. Sources seed the outer endpoints. */
+    readonly center?: ElectricPoint;
+    /** Named electrical source electrodes. See {@link ElectricSource}. */
+    readonly sources?: readonly ElectricSource[];
+    /** Optional simple closed vessel outline in normalized texture coordinates. */
+    readonly boundary?: readonly ElectricPoint[];
+    /**
+     * Number of particles or sources requested by this configuration. See {@link TendrilsOptions}.
+     */
+    readonly count?: number;
+    /** Continuous upward drift speed, 0..1. No circular boundary is assumed. */
+    readonly rise?: number;
+    /** Terminal discharge size, 0..1. Source weight also scales the discharge. */
+    readonly crackle?: number;
+    /** Rate at which the pattern or motion repeats. See {@link TendrilsOptions}. */
+    readonly frequency?: number;
+}
+/**
+ * Control, source-editing, and live appearance commands for a tendrils texture.
+ *
+ * @see {@link ElectricControl}
+ * @see {@link ElectricSourceMessage}
+ */
+export type TendrilsMessage = ElectricControl | ElectricSourceMessage | {
+    /** The literal "configure" identifying this variant. See {@link TendrilsMessage}. */
+    readonly type: "configure";
+    /** Amount of secondary electrical branching. See {@link TendrilsMessage}. */
+    readonly branching?: number;
+    /** Intensity of the electrical halo around the core. See {@link TendrilsMessage}. */
+    readonly glow?: number;
+    /** Upward drift strength of the tendrils. See {@link TendrilsMessage}. */
+    readonly rise?: number;
+    /** Intensity of terminal discharges. See {@link TendrilsMessage}. */
+    readonly crackle?: number;
+    /** Rate at which the pattern or motion repeats. See {@link TendrilsMessage}. */
+    readonly frequency?: number;
+};
+/**
+ * Weighted attachment sites and persistent filaments, independent of vessel geometry.
+ *
+ * @param config - Tendril motion and appearance settings. See {@link TendrilsOptions}.
+ * @returns A tendril texture recipe for useTexture.
+ *
+ * @see {@link TendrilsOptions}
+ */
+export declare function tendrils(config?: TendrilsOptions): import("@pibbl/core").TextureRecipe<TendrilsMessage>;

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

@@ -0,0 +1,216 @@
+import { ElectricMemory } from "./wasm/electric.js";
+import { lazyKernel } from "./wasm/memory.js";
+import { bytes } from "./wasm/tendrils-bytes.js";
+const wasmModule = /* @__PURE__ */ lazyKernel(bytes);
+import { boundary } from "./electric-boundary.js";
+import { defineTexture } from "@pibbl/core";
+import { validateSeed } from "./palette.js";
+import {
+  electricOptions,
+  point,
+  range
+} from "./electric-shared.js";
+import {
+  MAX_ELECTRIC_SOURCES,
+  site,
+  source,
+  sourceId,
+  sources
+} from "./electric-sources.js";
+function options(o) {
+  const count = range(o.count ?? 15, 1, 32, "Tendril count");
+  if (!Number.isInteger(count))
+    throw new RangeError("Tendril count must be an integer.");
+  return {
+    ...electricOptions(o),
+    center: point(o.center ?? { x: 0.5, y: 0.5 }),
+    sources: sources(o.sources ?? []),
+    boundary: boundary(o.boundary),
+    count,
+    rise: range(o.rise ?? 0, 0, 1, "Rise"),
+    crackle: range(o.crackle ?? 0, 0, 1, "Crackle"),
+    frequency: range(o.frequency ?? 18, 1, 30, "Frequency")
+  };
+}
+function strength(weight) {
+  return weight / (1 + weight);
+}
+function rebuild(s) {
+  s.ordered = [...s.sites.values()].sort(
+    (a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0
+  );
+  s.kernel.setSources(s.ordered);
+}
+function bind(t, next, snap = false) {
+  if (t.sourceId !== next.id || snap) {
+    t.trajectory = { ...next.point };
+    t.sourcePoint = { ...next.point };
+  }
+  t.sourceId = next.id;
+  t.releasedAge = void 0;
+  t.visible = true;
+  if (snap) {
+    t.point = { ...next.point };
+    t.strength = strength(next.weight);
+  }
+}
+function detach(t) {
+  t.sourceId = void 0;
+  t.releasedAge ??= 0;
+}
+function replaceSites(s, values, reconsider2) {
+  s.sites = new Map(values.map((v) => [v.id, site(v)]));
+  rebuild(s);
+  s.threads.forEach((t, i) => {
+    const current = t.sourceId && s.sites.get(t.sourceId);
+    if (!current || current.weight === 0) detach(t);
+    if (reconsider2) {
+      const next = s.kernel.choose(s.config.seed, i + t.generation * 37);
+      if (next) bind(t, next, s.paused || !t.visible);
+    }
+  });
+}
+function reset(s) {
+  s.time = 0;
+  s.sites = new Map(s.config.sources.map((v) => [v.id, site(v)]));
+  rebuild(s);
+  s.threads = Array.from({ length: s.config.count }, (_, i) => {
+    const next = s.kernel.choose(s.config.seed, i);
+    return Object.assign(s.kernel.thread(i), {
+      releasedAge: void 0,
+      sourceId: next?.id,
+      point: { ...next?.point ?? s.config.center },
+      strength: next ? strength(next.weight) : 0,
+      age: i / s.config.count * 5,
+      generation: 0,
+      trajectory: { ...next?.point ?? s.config.center },
+      sourcePoint: { ...next?.point ?? s.config.center },
+      visible: !!next,
+      born: false
+    });
+  });
+}
+function reconsider(s) {
+  s.threads.forEach((t, i) => {
+    const next = s.kernel.choose(s.config.seed, i + t.generation * 37);
+    if (next) bind(t, next, s.paused || !t.visible);
+    else detach(t);
+  });
+}
+const recipe = /* @__PURE__ */ defineTexture({
+  defaultPlacement: { mode: "stretch" },
+  create(context, input) {
+    const config = options(input);
+    const s = {
+      kernel: new ElectricMemory(wasmModule()),
+      config,
+      inputKey: JSON.stringify(input),
+      sites: /* @__PURE__ */ new Map(),
+      ordered: [],
+      threads: [],
+      time: 0,
+      paused: false
+    };
+    reset(s);
+    if (s.ordered.some((v) => v.weight > 0)) context.requestFrame();
+    return s;
+  },
+  update(s, input, context) {
+    const key = JSON.stringify(input);
+    if (key === s.inputKey) return;
+    const next = options(input), previous = s.config;
+    s.config = next;
+    s.inputKey = key;
+    if (next.seed !== previous.seed || next.count !== previous.count) reset(s);
+    else if (JSON.stringify(next.sources) !== JSON.stringify(previous.sources))
+      replaceSites(s, next.sources, true);
+    context.invalidate();
+    if (!s.paused && s.threads.some((t) => t.visible)) context.requestFrame();
+  },
+  receive(s, m, context) {
+    switch (m.type) {
+      case "pause":
+        s.paused = m.paused;
+        break;
+      case "reset":
+        s.config.seed = m.seed === void 0 ? s.config.seed : validateSeed(m.seed);
+        reset(s);
+        break;
+      case "configure":
+        s.config = options({ ...s.config, ...m });
+        break;
+      case "set-sources": {
+        const next = sources(m.sources);
+        s.config.sources = next;
+        replaceSites(s, next, true);
+        break;
+      }
+      case "upsert-source": {
+        const next = source(m.source), previous = s.sites.get(next.id);
+        if (!previous && s.sites.size >= MAX_ELECTRIC_SOURCES)
+          throw new RangeError("At most 512 electric sources may be active.");
+        const changedWeight = !previous || previous.weight !== next.weight;
+        if (previous) {
+          previous.point = next.point;
+          previous.weight = next.weight;
+        } else {
+          s.sites.set(next.id, site(next));
+          rebuild(s);
+        }
+        s.kernel.setSources(s.ordered);
+        if (next.weight === 0) {
+          for (const t of s.threads) if (t.sourceId === next.id) detach(t);
+        } else if (changedWeight) reconsider(s);
+        if (s.paused)
+          for (const t of s.threads) {
+            const target = t.sourceId && s.sites.get(t.sourceId);
+            if (target) bind(t, target, true);
+          }
+        break;
+      }
+      case "remove-source": {
+        const id = sourceId(m.id);
+        if (!s.sites.delete(id)) return;
+        rebuild(s);
+        for (const t of s.threads) if (t.sourceId === id) detach(t);
+        break;
+      }
+      default:
+        throw new TypeError("Unknown tendrils message.");
+    }
+    context.invalidate();
+    if (!s.paused && s.threads.some((t) => t.visible)) context.requestFrame();
+  },
+  advance(s, frame, context) {
+    if (s.paused) return;
+    const dt = Math.min(50, frame.delta) / 1e3;
+    s.time += dt;
+    s.kernel.boundary(s.config.boundary);
+    s.kernel.advanceTendrils(
+      s.threads.length,
+      s.config.seed,
+      dt,
+      s.config.rise
+    );
+    context.invalidate();
+    if (s.threads.some((t) => t.visible)) context.requestFrame();
+  },
+  rasterize(s, context) {
+    s.kernel.tendrils(s.config, s.time, s.threads.length);
+    s.kernel.draw(context, s.config.glow);
+  },
+  dispose(s) {
+    s.kernel.dispose();
+    s.sites.clear();
+    s.ordered.length = 0;
+    s.threads.length = 0;
+    s.config.sources.length = 0;
+  }
+});
+function tendrils(config = {}) {
+  return recipe(config);
+}
+export {
+  tendrils
+};
+//# sourceMappingURL=tendrils.js.map