@pibbl/core 0.0.1

package/dist/features/sprites/model.js

@@ -0,0 +1,64 @@
+import { defineAnimation } from "../../lib/animation/definition.js";
+const records = /* @__PURE__ */ new WeakMap();
+class SpriteFrame {
+  identity = true;
+  /** Original logical frame width, before transparent borders were trimmed.
+   * @returns Width in logical pixels.
+   */
+  get width() {
+    return frameRecord(this).sourceSize?.width ?? frameRecord(this).rect.width;
+  }
+  /** Original logical frame height, before transparent borders were trimmed.
+   * @returns Height in logical pixels.
+   */
+  get height() {
+    return frameRecord(this).sourceSize?.height ?? frameRecord(this).rect.height;
+  }
+  /** Stable name supplied by the atlas or numeric grid index.
+   * @returns The frame name.
+   */
+  get name() {
+    void this.identity;
+    return frameRecord(this).name;
+  }
+}
+function makeFrame(record) {
+  const frame = new SpriteFrame();
+  records.set(frame, record);
+  Object.freeze(frame);
+  return frame;
+}
+function frameRecord(frame) {
+  const record = records.get(frame);
+  if (!record) throw new TypeError("Expected a SpriteFrame from loadSpriteSheet.");
+  if (record.owner.disposed) throw new Error("Sprite sheet has been disposed.");
+  return record;
+}
+function defineSpriteAnimation(options) {
+  if (!options.frames.length) throw new RangeError("Sprite animation requires at least one frame.");
+  if ("fps" in options && (!Number.isFinite(options.fps) || options.fps <= 0)) throw new RangeError("Sprite FPS must be finite and positive.");
+  const entries = options.frames.map((item) => {
+    const entry = "fps" in options ? { frame: item, duration: 1e3 / options.fps } : item;
+    frameRecord(entry.frame);
+    if (!Number.isFinite(entry.duration) || entry.duration <= 0) throw new RangeError("Sprite duration must be finite and positive.");
+    return { ...entry };
+  });
+  let duration = 0;
+  const ends = entries.map((entry) => duration += entry.duration);
+  return defineAnimation({ duration, sample: ({ localTime }) => {
+    let low = 0, high = ends.length - 1;
+    while (low < high) {
+      const mid = low + high >>> 1;
+      if (localTime < ends[mid]) high = mid;
+      else low = mid + 1;
+    }
+    return entries[low].frame;
+  } });
+}
+export {
+  SpriteFrame,
+  defineSpriteAnimation,
+  frameRecord,
+  makeFrame
+};
+//# sourceMappingURL=model.js.map

package/dist/features/sprites/model.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/features/sprites/model.ts"],
+  "sourcesContent": ["import { defineAnimation } from '../../lib/animation/definition.js';\nimport type { PibblAnimationDefinition } from '../../lib/animation/types.js';\n\n/** Pixel rectangle within an atlas page or original frame. See {@link SpriteFrame}. */\nexport interface SpriteRectangle { /** Horizontal pixel offset. */ readonly x: number; /** Vertical pixel offset. */ readonly y: number; /** Width in pixels. */ readonly width: number; /** Height in pixels. */ readonly height: number }\n/** Normalized frame information returned by a format adapter. See {@link SpriteFrame}. */\nexport interface SpriteFrameData {\n  /** Unique frame name in this sheet. */ readonly name: string;\n  /** Zero-based atlas page index; defaults to zero. */ readonly page?: number;\n  /** Packed rectangle within the atlas page. */ readonly rect: SpriteRectangle;\n  /** Original frame dimensions before trimming. */ readonly sourceSize?: Readonly<{ /** Width in pixels. */ width: number; /** Height in pixels. */ height: number }>;\n  /** Trimmed content offset within the original frame. */ readonly trim?: Readonly<{ /** Horizontal pixel offset. */ x: number; /** Vertical pixel offset. */ y: number }>;\n  /** Whether the packed rectangle is rotated clockwise. */ readonly rotated?: boolean;\n}\n/** One normalized timed frame reference. Durations are milliseconds. See {@link SpriteFrame}. */\nexport interface SpriteAnimationFrameData { /** Name of the frame used by this animation step. */ readonly frame: string; /** Positive duration of the animation step in milliseconds. */ readonly duration: number }\n/** Adapter result. Image paths resolve relative to the metadata URL. See {@link SpriteFrame}. */\nexport interface SpriteSheetData {\n  /** Atlas image URLs, relative to the metadata URL. */ readonly images: readonly string[];\n  /** Normalized frame records for this sheet. */ readonly frames: readonly SpriteFrameData[];\n  /** Named sequences of timed frame references. */ readonly animations?: Readonly<Record<string, readonly SpriteAnimationFrameData[]>>;\n}\n/** Import adapter; loaders invoke this directly without a format registry. See {@link SpriteFrame}. */\nexport interface SpriteSheetFormat { /** Convert decoded metadata to normalized sheet data.\n * @param data - Parsed atlas JSON.\n * @returns Validated adapter data for loading the sheet.\n */ readonly parse: (data: unknown) => SpriteSheetData }\n\nexport interface FrameRecord extends SpriteFrameData { readonly image: HTMLImageElement; readonly owner: { disposed: boolean } }\nconst records = new WeakMap<SpriteFrame, FrameRecord>();\n/** Immutable atlas frame. Obtain frames from loadSpriteSheet; images belong to the sheet. See {@link SpriteFrame}. */\nexport class SpriteFrame {\n  private readonly identity = true;\n  /** Original logical frame width, before transparent borders were trimmed.\n   * @returns Width in logical pixels.\n   */\n  get width(): number { return frameRecord(this).sourceSize?.width ?? frameRecord(this).rect.width; }\n  /** Original logical frame height, before transparent borders were trimmed.\n   * @returns Height in logical pixels.\n   */\n  get height(): number { return frameRecord(this).sourceSize?.height ?? frameRecord(this).rect.height; }\n  /** Stable name supplied by the atlas or numeric grid index.\n   * @returns The frame name.\n   */\n  get name(): string { void this.identity; return frameRecord(this).name; }\n}\nexport function makeFrame(record: FrameRecord): SpriteFrame {\n  const frame = new SpriteFrame(); records.set(frame, record); Object.freeze(frame); return frame;\n}\nexport function frameRecord(frame: SpriteFrame): FrameRecord {\n  const record = records.get(frame);\n  if (!record) throw new TypeError('Expected a SpriteFrame from loadSpriteSheet.');\n  if (record.owner.disposed) throw new Error('Sprite sheet has been disposed.');\n  return record;\n}\n/** Author a finite discrete animation using FPS or explicit positive millisecond durations. See {@link SpriteFrame}.\n * @param options - Frames with a shared FPS or individual millisecond durations.\n * @returns A seekable discrete animation definition.\n */\nexport function defineSpriteAnimation(options: {\n  readonly frames: readonly SpriteFrame[];\n  readonly fps: number;\n} | {\n  readonly frames: readonly Readonly<{ frame: SpriteFrame; duration: number }>[];\n}): PibblAnimationDefinition<SpriteFrame> {\n  if (!options.frames.length) throw new RangeError('Sprite animation requires at least one frame.');\n  if ('fps' in options && (!Number.isFinite(options.fps) || options.fps <= 0)) throw new RangeError('Sprite FPS must be finite and positive.');\n  const entries = options.frames.map(item => {\n    const entry = 'fps' in options ? { frame: item as SpriteFrame, duration: 1000 / options.fps } : item as { frame: SpriteFrame; duration: number };\n    frameRecord(entry.frame);\n    if (!Number.isFinite(entry.duration) || entry.duration <= 0) throw new RangeError('Sprite duration must be finite and positive.');\n    return { ...entry };\n  });\n  let duration = 0;\n  const ends = entries.map(entry => duration += entry.duration);\n  return defineAnimation({ duration, sample: ({ localTime }) => {\n    let low = 0, high = ends.length - 1;\n    while (low < high) { const mid = (low + high) >>> 1; if (localTime < ends[mid]) high = mid; else low = mid + 1; }\n    return entries[low].frame;\n  } });\n}\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AA6BhC,MAAM,UAAU,oBAAI,QAAkC;AAE/C,MAAM,YAAY;AAAA,EACN,WAAW;AAAA;AAAA;AAAA;AAAA,EAI5B,IAAI,QAAgB;AAAE,WAAO,YAAY,IAAI,EAAE,YAAY,SAAS,YAAY,IAAI,EAAE,KAAK;AAAA,EAAO;AAAA;AAAA;AAAA;AAAA,EAIlG,IAAI,SAAiB;AAAE,WAAO,YAAY,IAAI,EAAE,YAAY,UAAU,YAAY,IAAI,EAAE,KAAK;AAAA,EAAQ;AAAA;AAAA;AAAA;AAAA,EAIrG,IAAI,OAAe;AAAE,SAAK,KAAK;AAAU,WAAO,YAAY,IAAI,EAAE;AAAA,EAAM;AAC1E;AACO,SAAS,UAAU,QAAkC;AAC1D,QAAM,QAAQ,IAAI,YAAY;AAAG,UAAQ,IAAI,OAAO,MAAM;AAAG,SAAO,OAAO,KAAK;AAAG,SAAO;AAC5F;AACO,SAAS,YAAY,OAAiC;AAC3D,QAAM,SAAS,QAAQ,IAAI,KAAK;AAChC,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,8CAA8C;AAC/E,MAAI,OAAO,MAAM,SAAU,OAAM,IAAI,MAAM,iCAAiC;AAC5E,SAAO;AACT;AAKO,SAAS,sBAAsB,SAKI;AACxC,MAAI,CAAC,QAAQ,OAAO,OAAQ,OAAM,IAAI,WAAW,+CAA+C;AAChG,MAAI,SAAS,YAAY,CAAC,OAAO,SAAS,QAAQ,GAAG,KAAK,QAAQ,OAAO,GAAI,OAAM,IAAI,WAAW,yCAAyC;AAC3I,QAAM,UAAU,QAAQ,OAAO,IAAI,UAAQ;AACzC,UAAM,QAAQ,SAAS,UAAU,EAAE,OAAO,MAAqB,UAAU,MAAO,QAAQ,IAAI,IAAI;AAChG,gBAAY,MAAM,KAAK;AACvB,QAAI,CAAC,OAAO,SAAS,MAAM,QAAQ,KAAK,MAAM,YAAY,EAAG,OAAM,IAAI,WAAW,8CAA8C;AAChI,WAAO,EAAE,GAAG,MAAM;AAAA,EACpB,CAAC;AACD,MAAI,WAAW;AACf,QAAM,OAAO,QAAQ,IAAI,WAAS,YAAY,MAAM,QAAQ;AAC5D,SAAO,gBAAgB,EAAE,UAAU,QAAQ,CAAC,EAAE,UAAU,MAAM;AAC5D,QAAI,MAAM,GAAG,OAAO,KAAK,SAAS;AAClC,WAAO,MAAM,MAAM;AAAE,YAAM,MAAO,MAAM,SAAU;AAAG,UAAI,YAAY,KAAK,GAAG,EAAG,QAAO;AAAA,UAAU,OAAM,MAAM;AAAA,IAAG;AAChH,WAAO,QAAQ,GAAG,EAAE;AAAA,EACtB,EAAE,CAAC;AACL;",
+  "names": []
+}

package/dist/features/sprites/sprite.js

@@ -0,0 +1,31 @@
+import { definePrimitive } from "../../lib/define-primitive.js";
+import { useRectPath } from "../../lib/hooks/use-rect-path.js";
+import { wireCommonEvents } from "../../lib/util/wire-common-events.js";
+import { frameRecord } from "./model.js";
+const Sprite = definePrimitive((props, style, ctx) => {
+  const record = frameRecord(props.frame);
+  const width = style.width ?? props.frame.width, height = style.height ?? props.frame.height;
+  const x = -(props.anchor?.x ?? 0) * width, y = -(props.anchor?.y ?? 0) * height;
+  const path = useRectPath(x, y, width, height);
+  const r = record.rect;
+  ctx.save();
+  try {
+    ctx.globalAlpha *= style.opacity ?? 1;
+    ctx.imageSmoothingEnabled = props.sampling !== "nearest";
+    ctx.translate(x + (props.flipX ? width : 0), y + (props.flipY ? height : 0));
+    ctx.scale((props.flipX ? -1 : 1) * width / props.frame.width, (props.flipY ? -1 : 1) * height / props.frame.height);
+    ctx.translate(record.trim?.x ?? 0, record.trim?.y ?? 0);
+    if (record.rotated) {
+      ctx.translate(0, r.width);
+      ctx.rotate(-Math.PI / 2);
+    }
+    ctx.drawImage(record.image, r.x, r.y, r.width, r.height, 0, 0, r.width, r.height);
+  } finally {
+    ctx.restore();
+  }
+  wireCommonEvents(props, path, true, 0, void 0, { x, y, width, height });
+});
+export {
+  Sprite
+};
+//# sourceMappingURL=sprite.js.map

package/dist/features/sprites/sprite.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/features/sprites/sprite.ts"],
+  "sourcesContent": ["import { definePrimitive } from '../../lib/define-primitive.js';\nimport { useRectPath } from '../../lib/hooks/use-rect-path.js';\nimport { wireCommonEvents } from '../../lib/util/wire-common-events.js';\nimport type { ImageProps } from '../../lib/components/img.js';\nimport type { SystemStyle } from '../../lib/types.js';\nimport { frameRecord, type SpriteFrame } from './model.js';\n/** Drawing inputs; frame also accepts a signal through Pibbl's declared primitive inputs. See {@link SpriteFrame}. */\nexport interface SpriteProps extends ImageProps {\n  /** Atlas frame to draw; its sheet must remain undisposed. */ readonly frame: SpriteFrame;\n  /** Image interpolation; defaults to linear. */ readonly sampling?: 'nearest' | 'linear';\n  /** Normalized origin within the original frame, defaulting to the top-left. */ readonly anchor?: Readonly<{ /** Horizontal anchor fraction. */ x: number; /** Vertical anchor fraction. */ y: number }>;\n  /** Mirror the frame horizontally. */ readonly flipX?: boolean;\n  /** Mirror the frame vertically. */ readonly flipY?: boolean;\n}\n/** Logical size overrides; omitted dimensions use the original untrimmed frame size. See {@link SpriteFrame}. */\nexport interface SpriteStyle extends SystemStyle { /** Logical width; defaults to the original frame width. */ readonly width?: number; /** Logical height; defaults to the original frame height. */ readonly height?: number; /** Opacity multiplier applied to the frame. */ readonly opacity?: number }\n/** Draw a shared atlas frame, preserving its logical geometry across frame changes. See {@link SpriteFrame}. */\nexport const Sprite = definePrimitive<SpriteProps, SpriteStyle>((props, style, ctx) => {\n  const record = frameRecord(props.frame);\n  const width = style.width ?? props.frame.width, height = style.height ?? props.frame.height;\n  const x = -(props.anchor?.x ?? 0) * width, y = -(props.anchor?.y ?? 0) * height;\n  const path = useRectPath(x, y, width, height);\n  const r = record.rect;\n  ctx.save();\n  try {\n    ctx.globalAlpha *= style.opacity ?? 1;\n    ctx.imageSmoothingEnabled = props.sampling !== 'nearest';\n    ctx.translate(x + (props.flipX ? width : 0), y + (props.flipY ? height : 0));\n    ctx.scale((props.flipX ? -1 : 1) * width / props.frame.width, (props.flipY ? -1 : 1) * height / props.frame.height);\n    ctx.translate(record.trim?.x ?? 0, record.trim?.y ?? 0);\n    if (record.rotated) { ctx.translate(0, r.width); ctx.rotate(-Math.PI / 2); }\n    ctx.drawImage(record.image, r.x, r.y, r.width, r.height, 0, 0, r.width, r.height);\n  } finally { ctx.restore(); }\n  wireCommonEvents(props, path, true, 0, undefined, { x, y, width, height });\n});\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AAGjC,SAAS,mBAAqC;AAYvC,MAAM,SAAS,gBAA0C,CAAC,OAAO,OAAO,QAAQ;AACrF,QAAM,SAAS,YAAY,MAAM,KAAK;AACtC,QAAM,QAAQ,MAAM,SAAS,MAAM,MAAM,OAAO,SAAS,MAAM,UAAU,MAAM,MAAM;AACrF,QAAM,IAAI,EAAE,MAAM,QAAQ,KAAK,KAAK,OAAO,IAAI,EAAE,MAAM,QAAQ,KAAK,KAAK;AACzE,QAAM,OAAO,YAAY,GAAG,GAAG,OAAO,MAAM;AAC5C,QAAM,IAAI,OAAO;AACjB,MAAI,KAAK;AACT,MAAI;AACF,QAAI,eAAe,MAAM,WAAW;AACpC,QAAI,wBAAwB,MAAM,aAAa;AAC/C,QAAI,UAAU,KAAK,MAAM,QAAQ,QAAQ,IAAI,KAAK,MAAM,QAAQ,SAAS,EAAE;AAC3E,QAAI,OAAO,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,MAAM,QAAQ,MAAM,QAAQ,KAAK,KAAK,SAAS,MAAM,MAAM,MAAM;AAClH,QAAI,UAAU,OAAO,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,CAAC;AACtD,QAAI,OAAO,SAAS;AAAE,UAAI,UAAU,GAAG,EAAE,KAAK;AAAG,UAAI,OAAO,CAAC,KAAK,KAAK,CAAC;AAAA,IAAG;AAC3E,QAAI,UAAU,OAAO,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM;AAAA,EAClF,UAAE;AAAU,QAAI,QAAQ;AAAA,EAAG;AAC3B,mBAAiB,OAAO,MAAM,MAAM,GAAG,QAAW,EAAE,GAAG,GAAG,OAAO,OAAO,CAAC;AAC3E,CAAC;",
+  "names": []
+}

package/dist/features/textures/index.d.ts

@@ -0,0 +1,22 @@
+export { ReactionDiffusion } from "./lib/reaction-diffusion.js";
+export type { ReactionDiffusionProps, TextureBrush, } from "./lib/reaction-diffusion.js";
+export { texturePalettes } from "./lib/palette.js";
+export type { TexturePalette, TextureResolution } from "./lib/palette.js";
+export { ProceduralTexture } from "./lib/procedural-texture.js";
+export type { ProceduralTextureProps } from "./lib/procedural-texture.js";
+export type { TextureKind } from "./lib/material-field.js";
+export type { TextureRenderer, TextureRenderFrame, } from "./lib/presentation.js";
+export { useTexture, marble, paper, cellular, reactionDiffusion, } from "./lib/definitions.js";
+export type { MaterialOptions, ReactionDiffusionOptions, InkMessage, } from "./lib/definitions.js";
+export { waterWaves } from "./lib/water-waves.js";
+export type { WaterWavesOptions, WaterWavesMessage, } from "./lib/water-waves.js";
+export { waterSurface } from "./lib/water-surface.js";
+export type { WaterSurfaceMessage, WaterSurfaceObstacle, WaterSurfaceOptions, } from "./lib/water-surface.js";
+export { tendrils } from "./lib/tendrils.js";
+export type { TendrilsOptions, TendrilsMessage } from "./lib/tendrils.js";
+export { lightning } from "./lib/lightning.js";
+export type { LightningOptions, LightningMessage } from "./lib/lightning.js";
+export type { ElectricPoint, ElectricOptions, ElectricControl } from "./lib/electric-shared.js";
+export type { ElectricSource, ElectricSourceMessage } from "./lib/electric-sources.js";
+export { rainDrops } from "./lib/rain-drops.js";
+export type { RainDropsOptions, RainDropsMessage } from "./lib/rain-drops.js";

package/dist/features/textures/index.js

@@ -0,0 +1,31 @@
+import { ReactionDiffusion } from "./lib/reaction-diffusion.js";
+import { texturePalettes } from "./lib/palette.js";
+import { ProceduralTexture } from "./lib/procedural-texture.js";
+import {
+  useTexture,
+  marble,
+  paper,
+  cellular,
+  reactionDiffusion
+} from "./lib/definitions.js";
+import { waterWaves } from "./lib/water-waves.js";
+import { waterSurface } from "./lib/water-surface.js";
+import { tendrils } from "./lib/tendrils.js";
+import { lightning } from "./lib/lightning.js";
+import { rainDrops } from "./lib/rain-drops.js";
+export {
+  ProceduralTexture,
+  ReactionDiffusion,
+  cellular,
+  lightning,
+  marble,
+  paper,
+  rainDrops,
+  reactionDiffusion,
+  tendrils,
+  texturePalettes,
+  useTexture,
+  waterSurface,
+  waterWaves
+};
+//# sourceMappingURL=index.js.map

package/dist/features/textures/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/features/textures/index.ts"],
+  "sourcesContent": ["export { ReactionDiffusion } from \"./lib/reaction-diffusion.js\";\nexport type {\n  ReactionDiffusionProps,\n  TextureBrush,\n} from \"./lib/reaction-diffusion.js\";\nexport { texturePalettes } from \"./lib/palette.js\";\nexport type { TexturePalette, TextureResolution } from \"./lib/palette.js\";\nexport { ProceduralTexture } from \"./lib/procedural-texture.js\";\nexport type { ProceduralTextureProps } from \"./lib/procedural-texture.js\";\nexport type { TextureKind } from \"./lib/material-field.js\";\nexport type {\n  TextureRenderer,\n  TextureRenderFrame,\n} from \"./lib/presentation.js\";\nexport {\n  useTexture,\n  marble,\n  paper,\n  cellular,\n  reactionDiffusion,\n} from \"./lib/definitions.js\";\nexport type {\n  MaterialOptions,\n  ReactionDiffusionOptions,\n  InkMessage,\n} from \"./lib/definitions.js\";\nexport { waterWaves } from \"./lib/water-waves.js\";\nexport type {\n  WaterWavesOptions,\n  WaterWavesMessage,\n} from \"./lib/water-waves.js\";\nexport { waterSurface } from \"./lib/water-surface.js\";\nexport type {\n  WaterSurfaceMessage,\n  WaterSurfaceObstacle,\n  WaterSurfaceOptions,\n} from \"./lib/water-surface.js\";\nexport { tendrils } from \"./lib/tendrils.js\";\nexport type { TendrilsOptions, TendrilsMessage } from \"./lib/tendrils.js\";\nexport { lightning } from \"./lib/lightning.js\";\nexport type { LightningOptions, LightningMessage } from \"./lib/lightning.js\";\nexport type { ElectricPoint, ElectricOptions, ElectricControl } from \"./lib/electric-shared.js\";\nexport type { ElectricSource, ElectricSourceMessage } from \"./lib/electric-sources.js\";\n\nexport { rainDrops } from \"./lib/rain-drops.js\";\nexport type { RainDropsOptions, RainDropsMessage } from \"./lib/rain-drops.js\";\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAKlC,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAOlC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP,SAAS,kBAAkB;AAK3B,SAAS,oBAAoB;AAM7B,SAAS,gBAAgB;AAEzB,SAAS,iBAAiB;AAK1B,SAAS,iBAAiB;",
+  "names": []
+}

package/dist/features/textures/index.mjs

@@ -0,0 +1 @@
+export * from './index.js';

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

@@ -0,0 +1,117 @@
+import type { TextureRecipe } from '../../../lib/textures/texture.js';
+export { useTexture } from "@pibbl/core";
+/**
+ * Seed, feature scale, and detail controls shared by static material recipes.
+ *
+ * @see {@link marble}
+ * @see {@link paper}
+ * @see {@link cellular}
+ */
+export interface MaterialOptions {
+    /**
+     * Seed used for deterministic sampling or simulation initialization. See {@link MaterialOptions}
+     * .
+     */
+    readonly seed?: number;
+    /** Feature frequency across the generated material. See {@link MaterialOptions}. */
+    readonly scale?: number;
+    /** 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";
+}
+/**
+ * Paint, stir, pause, or reset commands accepted by a reaction-diffusion texture.
+ *
+ * @see {@link reactionDiffusion}
+ */
+export type InkMessage = {
+    /** The literal "paint" identifying this variant. See {@link InkMessage}. */
+    readonly type: "paint";
+    /** Normalized horizontal texture coordinate. See {@link InkMessage}. */
+    readonly u: number;
+    /** Normalized vertical texture coordinate. See {@link InkMessage}. */
+    readonly v: number;
+    /** Radius in the coordinate system of this geometry or effect. See {@link InkMessage}. */
+    readonly radius?: number;
+    /** Magnitude of the displacement or brush effect. See {@link InkMessage}. */
+    readonly strength?: number;
+} | {
+    /** The literal "stir" identifying this variant. See {@link InkMessage}. */
+    readonly type: "stir";
+    /** Normalized horizontal texture coordinate. See {@link InkMessage}. */
+    readonly u: number;
+    /** Normalized vertical texture coordinate. See {@link InkMessage}. */
+    readonly v: number;
+    /** Normalized displacement of the existing field, not a paint dose. */
+    readonly du: number;
+    /** Normalized vertical displacement of the texture field. See {@link InkMessage}. */
+    readonly dv: number;
+    /** Influence radius in texture cells. */
+    readonly radius?: number;
+} | {
+    /** The literal "pause" identifying this variant. See {@link InkMessage}. */
+    readonly type: "pause";
+    /** Whether simulation or playback advancement is suspended. See {@link InkMessage}. */
+    readonly paused: boolean;
+} | {
+    /** The literal "reset" identifying this variant. See {@link InkMessage}. */
+    readonly type: "reset";
+};
+/**
+ * Creates a seeded marble texture recipe with configurable feature scale and distortion.
+ *
+ * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.
+ * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.
+ *
+ * @see {@link MaterialOptions}
+ * @see {@link TextureRecipe}
+ */
+export declare const marble: (options?: MaterialOptions) => TextureRecipe<never>;
+/**
+ * Creates a seeded paper texture recipe with configurable feature scale and grain.
+ *
+ * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.
+ * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.
+ *
+ * @see {@link MaterialOptions}
+ * @see {@link TextureRecipe}
+ */
+export declare const paper: (options?: MaterialOptions) => TextureRecipe<never>;
+/**
+ * Creates a seeded cellular texture recipe with configurable feature scale and jitter.
+ *
+ * @param options - Seed, feature scale, and detail settings. See {@link MaterialOptions}.
+ * @returns A procedural material recipe for useTexture. See {@link TextureRecipe}.
+ *
+ * @see {@link MaterialOptions}
+ * @see {@link TextureRecipe}
+ */
+export declare const cellular: (options?: MaterialOptions) => TextureRecipe<never>;
+/**
+ * Creates a stateful reaction-diffusion texture recipe supporting paint, stirring, pause, and
+ * reset
+ * messages.
+ *
+ * @param options - Reaction and diffusion parameters, initialization, and rendering options. See
+ * {@link ReactionDiffusionOptions} .
+ * @returns A reaction-diffusion texture recipe for useTexture.
+ *
+ * @see {@link ReactionDiffusionOptions}
+ */
+export declare function reactionDiffusion(options?: ReactionDiffusionOptions): TextureRecipe<InkMessage>;

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

@@ -0,0 +1,179 @@
+import { rasterizeField, releaseField } from "./wasm/memory.js";
+import { defineTexture } from "@pibbl/core";
+import {
+  marbleField,
+  paperField,
+  cellularField
+} from "./material-field.js";
+import { InkSimulation } from "./simulation.js";
+import { paletteLut, texturePalettes, validateSeed } from "./palette.js";
+import { useTexture } from "@pibbl/core";
+function colorize(field, context, gain = 1) {
+  const ctx = context.canvas.getContext("2d");
+  const lut = paletteLut(context.palette ?? texturePalettes.porcelain);
+  const raster = rasterizeField(field, lut, gain);
+  if (!raster) throw new Error("Texture field has no WASM owner.");
+  ctx.putImageData(raster.image, 0, 0);
+}
+function materialConfig(config) {
+  const seed = validateSeed(config.seed), scale = config.scale ?? 6, detail = config.detail ?? 0.65;
+  if (!Number.isFinite(scale) || scale < 1 || scale > 32 || !Number.isFinite(detail) || detail < 0 || detail > 1)
+    throw new RangeError("Material scale must be 1..32 and detail 0..1.");
+  return { seed, scale, detail };
+}
+function material(generate) {
+  const recipe = defineTexture({
+    create(context, input) {
+      const config = materialConfig(input);
+      return {
+        config,
+        field: generate(
+          context.canvas.width,
+          context.canvas.height,
+          config.seed,
+          config.scale,
+          config.detail
+        )
+      };
+    },
+    update(state, input, context) {
+      const config = materialConfig(input);
+      if (JSON.stringify(config) === JSON.stringify(state.config)) return;
+      state.field = generate(
+        context.canvas.width,
+        context.canvas.height,
+        config.seed,
+        config.scale,
+        config.detail,
+        state.field
+      );
+      state.config = config;
+      context.invalidate();
+    },
+    rasterize(state, context) {
+      colorize(state.field, context);
+    },
+    dispose(state) {
+      releaseField(state.field);
+      state.field = new Float32Array(0);
+    }
+  });
+  return (options = {}) => recipe(options);
+}
+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 };
+}
+function reset(state, context) {
+  const next = new InkSimulation(
+    context.canvas.width,
+    context.canvas.height,
+    state.config.seed,
+    state.config.preset
+  );
+  state.simulation.dispose();
+  state.simulation = next;
+  state.elapsed = 0;
+  state.fresh = true;
+  context.invalidate();
+}
+const inkRecipe = /* @__PURE__ */ defineTexture({
+  defaultPlacement: { mode: "stretch" },
+  create(context, input) {
+    const config = inkConfig(input);
+    context.requestFrame();
+    return {
+      simulation: new InkSimulation(
+        context.canvas.width,
+        context.canvas.height,
+        config.seed,
+        config.preset
+      ),
+      config,
+      paused: false,
+      elapsed: 0,
+      fresh: true
+    };
+  },
+  update(state, input, context) {
+    const config = inkConfig(input);
+    if (config.seed === state.config.seed && config.preset === state.config.preset)
+      return;
+    state.config = config;
+    reset(state, context);
+  },
+  receive(state, message, context) {
+    if (message.type === "pause") {
+      state.paused = message.paused;
+      state.elapsed = 0;
+      state.fresh = true;
+      if (!state.paused) context.requestFrame();
+    } else if (message.type === "reset") reset(state, context);
+    else if (message.type === "stir") {
+      const radius = message.radius ?? 16;
+      if (![message.u, message.v, message.du, message.dv, radius].every(
+        Number.isFinite
+      ) || radius <= 0 || radius > 128 || Math.abs(message.du) > 1 || Math.abs(message.dv) > 1)
+        throw new RangeError("Invalid ink stir message.");
+      if (message.u < 0 || message.u > 1 || message.v < 0 || message.v > 1)
+        return;
+      state.simulation.stir(
+        message.u * context.canvas.width,
+        message.v * context.canvas.height,
+        message.du * context.canvas.width,
+        message.dv * context.canvas.height,
+        radius
+      );
+      context.invalidate();
+    } else if (message.type === "paint") {
+      const radius = message.radius ?? 6, strength = message.strength ?? 0.8;
+      if (![message.u, message.v, radius, strength].every(Number.isFinite) || radius <= 0 || radius > 128 || strength < 0 || strength > 1)
+        throw new RangeError("Invalid ink paint message.");
+      if (message.u < 0 || message.v < 0 || message.u > 1 || message.v > 1)
+        return;
+      state.simulation.paint(
+        message.u * context.canvas.width,
+        message.v * context.canvas.height,
+        radius,
+        strength
+      );
+      context.invalidate();
+    } else throw new TypeError("Unknown ink message.");
+  },
+  advance(state, frame, context) {
+    if (state.paused) return;
+    if (!state.fresh) {
+      state.elapsed += Math.min(50, frame.delta);
+      const steps = Math.min(24, Math.floor(state.elapsed * 0.48 + 1e-9));
+      state.elapsed -= steps / 0.48;
+      if (steps) {
+        state.simulation.advance(steps);
+        context.invalidate();
+      }
+    }
+    state.fresh = false;
+    context.requestFrame();
+  },
+  rasterize(state, context) {
+    colorize(state.simulation.b, context, 650 / 255);
+  },
+  dispose(state) {
+    state.simulation.dispose();
+  }
+});
+function reactionDiffusion(options = {}) {
+  return inkRecipe(options);
+}
+export {
+  cellular,
+  marble,
+  paper,
+  reactionDiffusion,
+  useTexture
+};
+//# sourceMappingURL=definitions.js.map

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

@@ -0,0 +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": "AACA,SAAS,gBAAgB,oBAAoB;AAC7C,SAAS,qBAA0C;AACnD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,qBAAqB;AAC9B,SAAS,YAAY,iBAAiB,oBAAoB;AAC1D,SAAS,kBAAkB;AA8E3B,SAAS,SAAS,OAAqB,SAAyB,OAAO,GAAG;AACxE,QAAM,MAAM,QAAQ,OAAO,WAAW,IAAI;AAC1C,QAAM,MAAM,WAAW,QAAQ,WAAW,gBAAgB,SAAS;AACnE,QAAM,SAAS,eAAe,OAAO,KAAK,IAAI;AAC9C,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,kCAAkC;AAC/D,MAAI,aAAa,OAAO,OAAO,GAAG,CAAC;AACrC;AACA,SAAS,eAAe,QAAyB;AAC/C,QAAM,OAAO,aAAa,OAAO,IAAI,GACnC,QAAQ,OAAO,SAAS,GACxB,SAAS,OAAO,UAAU;AAC5B,MACE,CAAC,OAAO,SAAS,KAAK,KACtB,QAAQ,KACR,QAAQ,MACR,CAAC,OAAO,SAAS,MAAM,KACvB,SAAS,KACT,SAAS;AAET,UAAM,IAAI,WAAW,+CAA+C;AACtE,SAAO,EAAE,MAAM,OAAO,OAAO;AAC/B;AACA,SAAS,SAAS,UAA6B;AAC7C,QAAM,SAAS,cAGb;AAAA,IACA,OAAO,SAAS,OAAO;AACrB,YAAM,SAAS,eAAe,KAAK;AACnC,aAAO;AAAA,QACL;AAAA,QACA,OAAO;AAAA,UACL,QAAQ,OAAO;AAAA,UACf,QAAQ,OAAO;AAAA,UACf,OAAO;AAAA,UACP,OAAO;AAAA,UACP,OAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,IACA,OAAO,OAAO,OAAO,SAAS;AAC5B,YAAM,SAAS,eAAe,KAAK;AACnC,UAAI,KAAK,UAAU,MAAM,MAAM,KAAK,UAAU,MAAM,MAAM,EAAG;AAC7D,YAAM,QAAQ;AAAA,QACZ,QAAQ,OAAO;AAAA,QACf,QAAQ,OAAO;AAAA,QACf,OAAO;AAAA,QACP,OAAO;AAAA,QACP,OAAO;AAAA,QACP,MAAM;AAAA,MACR;AACA,YAAM,SAAS;AACf,cAAQ,WAAW;AAAA,IACrB;AAAA,IACA,UAAU,OAAO,SAAS;AACxB,eAAS,MAAM,OAAO,OAAO;AAAA,IAC/B;AAAA,IACA,QAAQ,OAAO;AACb,mBAAa,MAAM,KAAK;AACxB,YAAM,QAAQ,IAAI,aAAa,CAAC;AAAA,IAClC;AAAA,EACF,CAAC;AACD,SAAO,CAAC,UAA2B,CAAC,MAAM,OAAO,OAAO;AAC1D;AAUO,MAAM,SAAyB,yBAAS,WAAW;AAUnD,MAAM,QAAwB,yBAAS,UAAU;AAUjD,MAAM,WAA2B,yBAAS,aAAa;AAC9D,SAAS,UAAU,OAAiC;AAClD,QAAM,OAAO,aAAa,MAAM,IAAI,GAClC,SAAS,MAAM,UAAU;AAC3B,MAAI,WAAW,WAAW,WAAW;AACnC,UAAM,IAAI,UAAU,qBAAqB;AAC3C,SAAO,EAAE,MAAM,OAAO;AACxB;AAQA,SAAS,MAAM,OAAiB,SAAyB;AACvD,QAAM,OAAO,IAAI;AAAA,IACf,QAAQ,OAAO;AAAA,IACf,QAAQ,OAAO;AAAA,IACf,MAAM,OAAO;AAAA,IACb,MAAM,OAAO;AAAA,EACf;AACA,QAAM,WAAW,QAAQ;AACzB,QAAM,aAAa;AACnB,QAAM,UAAU;AAChB,QAAM,QAAQ;AACd,UAAQ,WAAW;AACrB;AACA,MAAM,YAA4B,8BAIhC;AAAA,EACA,kBAAkB,EAAE,MAAM,UAAU;AAAA,EACpC,OAAO,SAAS,OAAO;AACrB,UAAM,SAAS,UAAU,KAAK;AAC9B,YAAQ,aAAa;AACrB,WAAO;AAAA,MACL,YAAY,IAAI;AAAA,QACd,QAAQ,OAAO;AAAA,QACf,QAAQ,OAAO;AAAA,QACf,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EACA,OAAO,OAAO,OAAO,SAAS;AAC5B,UAAM,SAAS,UAAU,KAAK;AAC9B,QACE,OAAO,SAAS,MAAM,OAAO,QAC7B,OAAO,WAAW,MAAM,OAAO;AAE/B;AACF,UAAM,SAAS;AACf,UAAM,OAAO,OAAO;AAAA,EACtB;AAAA,EACA,QAAQ,OAAO,SAAS,SAAS;AAC/B,QAAI,QAAQ,SAAS,SAAS;AAC5B,YAAM,SAAS,QAAQ;AACvB,YAAM,UAAU;AAChB,YAAM,QAAQ;AACd,UAAI,CAAC,MAAM,OAAQ,SAAQ,aAAa;AAAA,IAC1C,WAAW,QAAQ,SAAS,QAAS,OAAM,OAAO,OAAO;AAAA,aAChD,QAAQ,SAAS,QAAQ;AAChC,YAAM,SAAS,QAAQ,UAAU;AACjC,UACE,CAAC,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IAAI,QAAQ,IAAI,MAAM,EAAE;AAAA,QACtD,OAAO;AAAA,MACT,KACA,UAAU,KACV,SAAS,OACT,KAAK,IAAI,QAAQ,EAAE,IAAI,KACvB,KAAK,IAAI,QAAQ,EAAE,IAAI;AAEvB,cAAM,IAAI,WAAW,2BAA2B;AAClD,UAAI,QAAQ,IAAI,KAAK,QAAQ,IAAI,KAAK,QAAQ,IAAI,KAAK,QAAQ,IAAI;AACjE;AACF,YAAM,WAAW;AAAA,QACf,QAAQ,IAAI,QAAQ,OAAO;AAAA,QAC3B,QAAQ,IAAI,QAAQ,OAAO;AAAA,QAC3B,QAAQ,KAAK,QAAQ,OAAO;AAAA,QAC5B,QAAQ,KAAK,QAAQ,OAAO;AAAA,QAC5B;AAAA,MACF;AACA,cAAQ,WAAW;AAAA,IACrB,WAAW,QAAQ,SAAS,SAAS;AACnC,YAAM,SAAS,QAAQ,UAAU,GAC/B,WAAW,QAAQ,YAAY;AACjC,UACE,CAAC,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,QAAQ,EAAE,MAAM,OAAO,QAAQ,KAC/D,UAAU,KACV,SAAS,OACT,WAAW,KACX,WAAW;AAEX,cAAM,IAAI,WAAW,4BAA4B;AACnD,UAAI,QAAQ,IAAI,KAAK,QAAQ,IAAI,KAAK,QAAQ,IAAI,KAAK,QAAQ,IAAI;AACjE;AACF,YAAM,WAAW;AAAA,QACf,QAAQ,IAAI,QAAQ,OAAO;AAAA,QAC3B,QAAQ,IAAI,QAAQ,OAAO;AAAA,QAC3B;AAAA,QACA;AAAA,MACF;AACA,cAAQ,WAAW;AAAA,IACrB,MAAO,OAAM,IAAI,UAAU,sBAAsB;AAAA,EACnD;AAAA,EACA,QAAQ,OAAO,OAAO,SAAS;AAC7B,QAAI,MAAM,OAAQ;AAClB,QAAI,CAAC,MAAM,OAAO;AAChB,YAAM,WAAW,KAAK,IAAI,IAAI,MAAM,KAAK;AACzC,YAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,MAAM,UAAU,OAAO,IAAI,CAAC;AAClE,YAAM,WAAW,QAAQ;AACzB,UAAI,OAAO;AACT,cAAM,WAAW,QAAQ,KAAK;AAC9B,gBAAQ,WAAW;AAAA,MACrB;AAAA,IACF;AACA,UAAM,QAAQ;AACd,YAAQ,aAAa;AAAA,EACvB;AAAA,EACA,UAAU,OAAO,SAAS;AACxB,aAAS,MAAM,WAAW,GAAG,SAAS,MAAM,GAAG;AAAA,EACjD;AAAA,EACA,QAAQ,OAAO;AACb,UAAM,WAAW,QAAQ;AAAA,EAC3B;AACF,CAAC;AAYM,SAAS,kBAAkB,UAAoC,CAAC,GAAG;AACxE,SAAO,UAAU,OAAO;AAC1B;",
+  "names": []
+}

package/dist/features/textures/lib/electric-boundary.d.ts

@@ -0,0 +1,3 @@
+import { type ElectricPoint } from "./electric-shared.js";
+/** One simple closed polygon, supplied in texture coordinates. */
+export declare function boundary(input?: readonly ElectricPoint[]): ElectricPoint[] | undefined;

package/dist/features/textures/lib/electric-boundary.js

@@ -0,0 +1,11 @@
+import { point } from "./electric-shared.js";
+function boundary(input) {
+  if (input === void 0) return void 0;
+  if (!Array.isArray(input) || input.length < 3 || input.length > 256)
+    throw new RangeError("Tendril boundary requires 3..256 points.");
+  return input.map(point);
+}
+export {
+  boundary
+};
+//# sourceMappingURL=electric-boundary.js.map

package/dist/features/textures/lib/electric-boundary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/electric-boundary.ts"],
+  "sourcesContent": ["import { point, type ElectricPoint } from \"./electric-shared.js\";\n\n/** One simple closed polygon, supplied in texture coordinates. */\nexport function boundary(\n  input?: readonly ElectricPoint[],\n): ElectricPoint[] | undefined {\n  if (input === undefined) return undefined;\n  if (!Array.isArray(input) || input.length < 3 || input.length > 256)\n    throw new RangeError(\"Tendril boundary requires 3..256 points.\");\n  return input.map(point);\n}\n"],
+  "mappings": "AAAA,SAAS,aAAiC;AAGnC,SAAS,SACd,OAC6B;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,KAAK,MAAM,SAAS;AAC9D,UAAM,IAAI,WAAW,0CAA0C;AACjE,SAAO,MAAM,IAAI,KAAK;AACxB;",
+  "names": []
+}

package/dist/features/textures/lib/electric-shared.d.ts

@@ -0,0 +1,69 @@
+import type { ElectricSource } from "./electric-sources.js";
+import type { LightningMessage, LightningOptions } from "./lightning.js";
+import type { TendrilsMessage, TendrilsOptions } from "./tendrils.js";
+import type { TextureContext } from "@pibbl/core";
+/**
+ * Coordinates are normalized to the complete texture, including its halo padding.
+ *
+ * @see {@link ElectricSource}
+ * @see {@link LightningOptions}
+ * @see {@link TendrilsOptions}
+ * @see {@link LightningMessage}
+ */
+export interface ElectricPoint {
+    /**
+     * Horizontal coordinate or displacement in the containing coordinate system. See
+     * {@link ElectricPoint}.
+     */
+    readonly x: number;
+    /**
+     * Vertical coordinate or displacement in the containing coordinate system. See
+     * {@link ElectricPoint}.
+     */
+    readonly y: number;
+}
+/**
+ * Deterministic seed, branching, and glow shared by electrical texture recipes.
+ *
+ * @see {@link TendrilsOptions}
+ * @see {@link LightningOptions}
+ */
+export interface ElectricOptions {
+    /**
+     * Seed used for deterministic sampling or simulation initialization. See {@link ElectricOptions}
+     * .
+     */
+    readonly seed?: number;
+    /** 0..1, controls the number of secondary branches. */
+    readonly branching?: number;
+    /** 0..2, scales the soft halo without widening the white core. */
+    readonly glow?: number;
+}
+/**
+ * Pause or reseed/reset commands shared by electrical textures.
+ *
+ * @see {@link TendrilsMessage}
+ * @see {@link LightningMessage}
+ */
+export type ElectricControl = {
+    /** The literal "pause" identifying this variant. See {@link ElectricControl}. */
+    readonly type: "pause";
+    /** Whether simulation or playback advancement is suspended. See {@link ElectricControl}. */
+    readonly paused: boolean;
+} | {
+    /** The literal "reset" identifying this variant. See {@link ElectricControl}. */
+    readonly type: "reset";
+    /**
+     * Seed used for deterministic sampling or simulation initialization. See
+     * {@link ElectricControl}.
+     */
+    readonly seed?: number;
+};
+export declare function range(value: number, min: number, max: number, name: string): number;
+export declare function point(p: ElectricPoint): ElectricPoint;
+export declare function electricOptions(o: ElectricOptions): {
+    seed: number;
+    branching: number;
+    glow: number;
+};
+export declare function drawCore(context: TextureContext, p: ElectricPoint, strength: number, glow: number, radius?: number): void;