@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/features/sprites/loader.ts"],
-  "sourcesContent": ["import { defineSpriteAnimation, makeFrame, type SpriteFrame, type SpriteFrameData, type SpriteSheetFormat } from './model.js';\nimport type { PibblAnimationDefinition } from '../../lib/animation/types.js';\n/** Shared decoded atlas and immutable frames/clips. Dispose after all consumers unmount. See {@link SpriteFrame}. */\nexport interface SpriteSheet {\n  /** Frames indexed by atlas name or numeric grid index. */ readonly frames: Readonly<Record<string | number, SpriteFrame>>;\n  /** Named, seekable animation definitions from the atlas. */ readonly animations: Readonly<Record<string, PibblAnimationDefinition<SpriteFrame>>>;\n  /** Release decoded images; unmount every consumer before calling. */ readonly dispose: () => void;\n}\n/** Dimensions of a regular grid, in image pixels. See {@link SpriteFrame}. */\nexport interface SpriteGrid { /** Positive cell width in pixels. */ readonly frameWidth: number; /** Positive cell height in pixels. */ readonly frameHeight: number; /** Outer border width in pixels; defaults to zero. */ readonly margin?: number; /** Gap between cells in pixels; defaults to zero. */ readonly spacing?: number }\n/** Load a grid image or metadata through an explicitly supplied import adapter. See {@link SpriteFrame}. \n * @param url - Grid image URL or atlas metadata URL.\n * @param options - Grid dimensions or an explicit metadata format adapter.\n * @returns A decoded sprite sheet with explicit disposal ownership.\n */\nexport async function loadSpriteSheet(url: string, options: { readonly grid: SpriteGrid } | { readonly format: SpriteSheetFormat }): Promise<SpriteSheet> {\n  const owner = { disposed: false };\n  const images: HTMLImageElement[] = [];\n  const dispose = () => { if (owner.disposed) return; owner.disposed = true; for (const image of images) image.removeAttribute('src'); };\n  const load = async (source: string) => {\n    const image = new globalThis.Image(); images.push(image); image.src = source; await image.decode(); return image;\n  };\n  try {\n    let specs: readonly SpriteFrameData[];\n    let clips: Readonly<Record<string, readonly { frame: string; duration: number }[]>> = {};\n    if ('grid' in options) {\n      const { frameWidth: w, frameHeight: h, margin = 0, spacing = 0 } = options.grid;\n      if (![w, h, margin, spacing].every(Number.isInteger) || w <= 0 || h <= 0 || margin < 0 || spacing < 0) throw new RangeError('Invalid sprite grid dimensions.');\n      const image = await load(url); const frames: SpriteFrameData[] = [];\n      for (let y = margin; y + h <= image.naturalHeight - margin; y += h + spacing)\n        for (let x = margin; x + w <= image.naturalWidth - margin; x += w + spacing)\n          frames.push({ name: String(frames.length), rect: { x, y, width: w, height: h } });\n      if (!frames.length) throw new RangeError('Sprite grid contains no complete frames.');\n      specs = frames;\n    } else {\n      const response = await fetch(url); if (!response.ok) throw new Error(`Sprite metadata failed: ${response.status}`);\n      const data = options.format.parse(await response.json());\n      for (const path of data.images) await load(new URL(path, new URL(url, document.baseURI)).href);\n      specs = data.frames; clips = data.animations ?? {};\n    }\n    const frames: Record<string, SpriteFrame> = Object.create(null);\n    for (const spec of specs) {\n      const image = images[spec.page ?? 0], r = spec.rect;\n      if (!image || ![r.x, r.y, r.width, r.height].every(Number.isFinite) || r.x < 0 || r.y < 0 || r.width <= 0 || r.height <= 0 || r.x + r.width > image.naturalWidth || r.y + r.height > image.naturalHeight) throw new RangeError(`Invalid sprite rectangle: ${spec.name}`);\n      if (frames[spec.name]) throw new Error(`Duplicate sprite frame: ${spec.name}`);\n      const width = spec.sourceSize?.width ?? (spec.rotated ? r.height : r.width);\n      const height = spec.sourceSize?.height ?? (spec.rotated ? r.width : r.height);\n      const trim = { x: spec.trim?.x ?? 0, y: spec.trim?.y ?? 0 };\n      if (![width, height, trim.x, trim.y].every(Number.isFinite) || width <= 0 || height <= 0 || trim.x < 0 || trim.y < 0 || trim.x + (spec.rotated ? r.height : r.width) > width || trim.y + (spec.rotated ? r.width : r.height) > height) throw new RangeError(`Invalid sprite logical bounds: ${spec.name}`);\n      frames[spec.name] = makeFrame({ ...spec, rect: Object.freeze({ ...r }), sourceSize: Object.freeze({ width, height }), trim: Object.freeze(trim), image, owner });\n    }\n    const animations: Record<string, PibblAnimationDefinition<SpriteFrame>> = Object.create(null);\n    for (const [name, entries] of Object.entries(clips)) animations[name] = defineSpriteAnimation({ frames: entries.map(entry => {\n      if (!frames[entry.frame]) throw new Error(`Unknown sprite frame: ${entry.frame}`);\n      return { frame: frames[entry.frame], duration: entry.duration };\n    }) });\n    return Object.freeze({ frames: Object.freeze(frames), animations: Object.freeze(animations), dispose });\n  } catch (error) { dispose(); throw error; }\n}\n"],
-  "mappings": "AAAA,SAAS,uBAAuB,iBAAiF;AAejH,eAAsB,gBAAgB,KAAa,SAAuG;AACxJ,QAAM,QAAQ,EAAE,UAAU,MAAM;AAChC,QAAM,SAA6B,CAAC;AACpC,QAAM,UAAU,MAAM;AAAE,QAAI,MAAM,SAAU;AAAQ,UAAM,WAAW;AAAM,eAAW,SAAS,OAAQ,OAAM,gBAAgB,KAAK;AAAA,EAAG;AACrI,QAAM,OAAO,OAAO,WAAmB;AACrC,UAAM,QAAQ,IAAI,WAAW,MAAM;AAAG,WAAO,KAAK,KAAK;AAAG,UAAM,MAAM;AAAQ,UAAM,MAAM,OAAO;AAAG,WAAO;AAAA,EAC7G;AACA,MAAI;AACF,QAAI;AACJ,QAAI,QAAkF,CAAC;AACvF,QAAI,UAAU,SAAS;AACrB,YAAM,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,EAAE,IAAI,QAAQ;AAC3E,UAAI,CAAC,CAAC,GAAG,GAAG,QAAQ,OAAO,EAAE,MAAM,OAAO,SAAS,KAAK,KAAK,KAAK,KAAK,KAAK,SAAS,KAAK,UAAU,EAAG,OAAM,IAAI,WAAW,iCAAiC;AAC7J,YAAM,QAAQ,MAAM,KAAK,GAAG;AAAG,YAAMA,UAA4B,CAAC;AAClE,eAAS,IAAI,QAAQ,IAAI,KAAK,MAAM,gBAAgB,QAAQ,KAAK,IAAI;AACnE,iBAAS,IAAI,QAAQ,IAAI,KAAK,MAAM,eAAe,QAAQ,KAAK,IAAI;AAClE,UAAAA,QAAO,KAAK,EAAE,MAAM,OAAOA,QAAO,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,GAAG,QAAQ,EAAE,EAAE,CAAC;AACpF,UAAI,CAACA,QAAO,OAAQ,OAAM,IAAI,WAAW,0CAA0C;AACnF,cAAQA;AAAA,IACV,OAAO;AACL,YAAM,WAAW,MAAM,MAAM,GAAG;AAAG,UAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,2BAA2B,SAAS,MAAM,EAAE;AACjH,YAAM,OAAO,QAAQ,OAAO,MAAM,MAAM,SAAS,KAAK,CAAC;AACvD,iBAAW,QAAQ,KAAK,OAAQ,OAAM,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,KAAK,SAAS,OAAO,CAAC,EAAE,IAAI;AAC7F,cAAQ,KAAK;AAAQ,cAAQ,KAAK,cAAc,CAAC;AAAA,IACnD;AACA,UAAM,SAAsC,uBAAO,OAAO,IAAI;AAC9D,eAAW,QAAQ,OAAO;AACxB,YAAM,QAAQ,OAAO,KAAK,QAAQ,CAAC,GAAG,IAAI,KAAK;AAC/C,UAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,QAAQ,KAAK,EAAE,IAAI,KAAK,EAAE,IAAI,KAAK,EAAE,SAAS,KAAK,EAAE,UAAU,KAAK,EAAE,IAAI,EAAE,QAAQ,MAAM,gBAAgB,EAAE,IAAI,EAAE,SAAS,MAAM,cAAe,OAAM,IAAI,WAAW,6BAA6B,KAAK,IAAI,EAAE;AACvQ,UAAI,OAAO,KAAK,IAAI,EAAG,OAAM,IAAI,MAAM,2BAA2B,KAAK,IAAI,EAAE;AAC7E,YAAM,QAAQ,KAAK,YAAY,UAAU,KAAK,UAAU,EAAE,SAAS,EAAE;AACrE,YAAM,SAAS,KAAK,YAAY,WAAW,KAAK,UAAU,EAAE,QAAQ,EAAE;AACtE,YAAM,OAAO,EAAE,GAAG,KAAK,MAAM,KAAK,GAAG,GAAG,KAAK,MAAM,KAAK,EAAE;AAC1D,UAAI,CAAC,CAAC,OAAO,QAAQ,KAAK,GAAG,KAAK,CAAC,EAAE,MAAM,OAAO,QAAQ,KAAK,SAAS,KAAK,UAAU,KAAK,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,KAAK,UAAU,EAAE,SAAS,EAAE,SAAS,SAAS,KAAK,KAAK,KAAK,UAAU,EAAE,QAAQ,EAAE,UAAU,OAAQ,OAAM,IAAI,WAAW,kCAAkC,KAAK,IAAI,EAAE;AACzS,aAAO,KAAK,IAAI,IAAI,UAAU,EAAE,GAAG,MAAM,MAAM,OAAO,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,YAAY,OAAO,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,MAAM,OAAO,OAAO,IAAI,GAAG,OAAO,MAAM,CAAC;AAAA,IACjK;AACA,UAAM,aAAoE,uBAAO,OAAO,IAAI;AAC5F,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,EAAG,YAAW,IAAI,IAAI,sBAAsB,EAAE,QAAQ,QAAQ,IAAI,WAAS;AAC3H,UAAI,CAAC,OAAO,MAAM,KAAK,EAAG,OAAM,IAAI,MAAM,yBAAyB,MAAM,KAAK,EAAE;AAChF,aAAO,EAAE,OAAO,OAAO,MAAM,KAAK,GAAG,UAAU,MAAM,SAAS;AAAA,IAChE,CAAC,EAAE,CAAC;AACJ,WAAO,OAAO,OAAO,EAAE,QAAQ,OAAO,OAAO,MAAM,GAAG,YAAY,OAAO,OAAO,UAAU,GAAG,QAAQ,CAAC;AAAA,EACxG,SAAS,OAAO;AAAE,YAAQ;AAAG,UAAM;AAAA,EAAO;AAC5C;",
+  "sourcesContent": ["import { defineSpriteAnimation, makeFrame, type SpriteFrame, type SpriteFrameData, type SpriteSheetFormat } from './model.js';\nimport type { PibblAnimationDefinition } from '../../lib/animation/types.js';\n/** Shared decoded atlas and immutable frames/clips. Dispose after all consumers unmount. See {@link SpriteFrame}. */\nexport interface SpriteSheet {\n  /** Frames indexed by atlas name or numeric grid index. */ readonly frames: Readonly<Record<string | number, SpriteFrame>>;\n  /** Named, seekable animation definitions from the atlas. */ readonly animations: Readonly<Record<string, PibblAnimationDefinition<SpriteFrame>>>;\n  /** Release decoded images; unmount every consumer before calling. */ readonly dispose: () => void;\n}\n/** Dimensions of a regular grid, in image pixels. See {@link SpriteFrame}. */\nexport interface SpriteGrid { /** Positive cell width in pixels. */ readonly frameWidth: number; /** Positive cell height in pixels. */ readonly frameHeight: number; /** Outer border width in pixels; defaults to zero. */ readonly margin?: number; /** Gap between cells in pixels; defaults to zero. */ readonly spacing?: number }\n/** Load a grid image or metadata through an explicitly supplied import adapter. See {@link SpriteFrame}. \n * @param url - Grid image URL or atlas metadata URL.\n * @param options - Grid dimensions or an explicit metadata format adapter.\n * @returns A decoded sprite sheet with explicit disposal ownership.\n */\nexport async function loadSpriteSheet(\n  url: string,\n  options: { readonly grid: SpriteGrid } | { readonly format: SpriteSheetFormat },\n): Promise<SpriteSheet> {\n  const owner = { disposed: false };\n  const images: HTMLImageElement[] = [];\n  const dispose = () => { if (owner.disposed) return; owner.disposed = true; for (const image of images) image.removeAttribute('src'); };\n  const load = async (source: string) => {\n    const image = new globalThis.Image(); images.push(image); image.src = source; await image.decode(); return image;\n  };\n  try {\n    let specs: readonly SpriteFrameData[];\n    let clips: Readonly<Record<string, readonly { frame: string; duration: number }[]>> = {};\n    if ('grid' in options) {\n      const { frameWidth: w, frameHeight: h, margin = 0, spacing = 0 } = options.grid;\n      if (\n        !(\n          Number.isInteger(w) &&\n          Number.isInteger(h) &&\n          Number.isInteger(margin) &&\n          Number.isInteger(spacing)\n        ) ||\n        w <= 0 ||\n        h <= 0 ||\n        margin < 0 ||\n        spacing < 0\n      )\n        throw new RangeError('Invalid sprite grid dimensions.');\n      const image = await load(url);\n      const frames: SpriteFrameData[] = [];\n      for (let y = margin; y + h <= image.naturalHeight - margin; y += h + spacing)\n        for (let x = margin; x + w <= image.naturalWidth - margin; x += w + spacing)\n          frames.push({ name: String(frames.length), rect: { x, y, width: w, height: h } });\n      if (!frames.length) throw new RangeError('Sprite grid contains no complete frames.');\n      specs = frames;\n    } else {\n      const response = await fetch(url); if (!response.ok) throw new Error(`Sprite metadata failed: ${response.status}`);\n      const data = options.format.parse(await response.json());\n      for (const path of data.images) await load(new URL(path, new URL(url, document.baseURI)).href);\n      specs = data.frames; clips = data.animations ?? {};\n    }\n    const frames: Record<string, SpriteFrame> = Object.create(null);\n    for (const spec of specs) {\n      const image = images[spec.page ?? 0], r = spec.rect;\n      if (\n        !image ||\n        !(\n          Number.isFinite(r.x) &&\n          Number.isFinite(r.y) &&\n          Number.isFinite(r.width) &&\n          Number.isFinite(r.height)\n        ) ||\n        r.x < 0 ||\n        r.y < 0 ||\n        r.width <= 0 ||\n        r.height <= 0 ||\n        r.x + r.width > image.naturalWidth ||\n        r.y + r.height > image.naturalHeight\n      )\n        throw new RangeError(`Invalid sprite rectangle: ${spec.name}`);\n      if (frames[spec.name]) throw new Error(`Duplicate sprite frame: ${spec.name}`);\n      const width = spec.sourceSize?.width ?? (spec.rotated ? r.height : r.width);\n      const height = spec.sourceSize?.height ?? (spec.rotated ? r.width : r.height);\n      const trim = { x: spec.trim?.x ?? 0, y: spec.trim?.y ?? 0 };\n      if (\n        !(\n          Number.isFinite(width) &&\n          Number.isFinite(height) &&\n          Number.isFinite(trim.x) &&\n          Number.isFinite(trim.y)\n        ) ||\n        width <= 0 ||\n        height <= 0 ||\n        trim.x < 0 ||\n        trim.y < 0 ||\n        trim.x + (spec.rotated ? r.height : r.width) > width ||\n        trim.y + (spec.rotated ? r.width : r.height) > height\n      )\n        throw new RangeError(`Invalid sprite logical bounds: ${spec.name}`);\n      frames[spec.name] = makeFrame({ ...spec, rect: Object.freeze({ ...r }), sourceSize: Object.freeze({ width, height }), trim: Object.freeze(trim), image, owner });\n    }\n    const animations: Record<string, PibblAnimationDefinition<SpriteFrame>> = Object.create(null);\n    for (const [name, entries] of Object.entries(clips)) animations[name] = defineSpriteAnimation({ frames: entries.map(entry => {\n      if (!frames[entry.frame]) throw new Error(`Unknown sprite frame: ${entry.frame}`);\n      return { frame: frames[entry.frame], duration: entry.duration };\n    }) });\n    return Object.freeze({ frames: Object.freeze(frames), animations: Object.freeze(animations), dispose });\n  } catch (error) { dispose(); throw error; }\n}\n"],
+  "mappings": "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",
   "names": ["frames"]
 }

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

@@ -16,7 +16,17 @@ 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 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";
+export { stripes, checkers, woodGrain, plainWeave, twill, herringbone, } from "./lib/patterns.js";
+export type { FabricOptions, PatternMotionOptions, StripesOptions, CheckersOptions, WoodGrainOptions, } from "./lib/patterns.js";
+export { grayScottPresets } from "./lib/gray-scott.js";
+export type { ReactionDiffusionPreset } from "./lib/gray-scott.js";
+export { softNoise, ridgedNoise } from "./lib/patterns.js";
+export type { NoiseOptions } from "./lib/patterns.js";
+export { schnakenberg, barkley, brusselator, schnakenbergPresets, barkleyPresets, brusselatorPresets } from './lib/chemical-recipes.js';
+export type { SchnakenbergOptions, BarkleyOptions, BrusselatorOptions } from './lib/chemical-recipes.js';
+export { polkaDots, halftone, plaid, truchet, plaidPresets } from './lib/geometric-patterns.js';
+export type { PolkaDotsOptions, HalftoneOptions, PlaidBand, PlaidOptions, TruchetOptions } from './lib/geometric-patterns.js';

package/dist/features/textures/index.js

@@ -13,19 +13,51 @@ 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";
+import {
+  stripes,
+  checkers,
+  woodGrain,
+  plainWeave,
+  twill,
+  herringbone
+} from "./lib/patterns.js";
+import { grayScottPresets } from "./lib/gray-scott.js";
+import { softNoise, ridgedNoise } from "./lib/patterns.js";
+import { schnakenberg, barkley, brusselator, schnakenbergPresets, barkleyPresets, brusselatorPresets } from "./lib/chemical-recipes.js";
+import { polkaDots, halftone, plaid, truchet, plaidPresets } from "./lib/geometric-patterns.js";
 export {
   ProceduralTexture,
   ReactionDiffusion,
+  barkley,
+  barkleyPresets,
+  brusselator,
+  brusselatorPresets,
   cellular,
+  checkers,
+  grayScottPresets,
+  halftone,
+  herringbone,
   lightning,
   marble,
   paper,
+  plaid,
+  plaidPresets,
+  plainWeave,
+  polkaDots,
   rainDrops,
   reactionDiffusion,
+  ridgedNoise,
+  schnakenberg,
+  schnakenbergPresets,
+  softNoise,
+  stripes,
   tendrils,
   texturePalettes,
+  truchet,
+  twill,
   useTexture,
   waterSurface,
-  waterWaves
+  waterWaves,
+  woodGrain
 };
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +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;",
+  "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 {\n  ElectricPoint,\n  ElectricOptions,\n  ElectricControl,\n} from \"./lib/electric-shared.js\";\nexport type {\n  ElectricSource,\n  ElectricSourceMessage,\n} from \"./lib/electric-sources.js\";\n\nexport { rainDrops } from \"./lib/rain-drops.js\";\nexport type { RainDropsOptions, RainDropsMessage } from \"./lib/rain-drops.js\";\n\nexport {\n  stripes,\n  checkers,\n  woodGrain,\n  plainWeave,\n  twill,\n  herringbone,\n} from \"./lib/patterns.js\";\nexport type {\n  FabricOptions,\n  PatternMotionOptions,\n  StripesOptions,\n  CheckersOptions,\n  WoodGrainOptions,\n} from \"./lib/patterns.js\";\nexport { grayScottPresets } from \"./lib/gray-scott.js\";\nexport type { ReactionDiffusionPreset } from \"./lib/gray-scott.js\";\n\nexport { softNoise, ridgedNoise } from \"./lib/patterns.js\";\nexport type { NoiseOptions } from \"./lib/patterns.js\";\n\nexport { schnakenberg, barkley, brusselator, schnakenbergPresets, barkleyPresets, brusselatorPresets } from './lib/chemical-recipes.js';\nexport type { SchnakenbergOptions, BarkleyOptions, BrusselatorOptions } from './lib/chemical-recipes.js';\n\nexport { polkaDots, halftone, plaid, truchet, plaidPresets } from './lib/geometric-patterns.js';\nexport type { PolkaDotsOptions, HalftoneOptions, PlaidBand, PlaidOptions, TruchetOptions } from './lib/geometric-patterns.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;AAY1B,SAAS,iBAAiB;AAG1B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,wBAAwB;AAGjC,SAAS,WAAW,mBAAmB;AAGvC,SAAS,cAAc,SAAS,aAAa,qBAAqB,gBAAgB,0BAA0B;AAG5G,SAAS,WAAW,UAAU,OAAO,SAAS,oBAAoB;",
   "names": []
 }

package/dist/features/textures/lib/chemical-field.d.ts

@@ -0,0 +1,56 @@
+/** Private periodic finite-difference state; presentation adds a duplicate seam row/column. */
+export interface ChemicalConfig {
+    readonly a: number;
+    readonly b: number;
+    readonly epsilon: number;
+    readonly diffusionU: number;
+    readonly diffusionV: number;
+    readonly seed: number;
+    readonly initialNoise: number;
+    readonly warmupSteps: number;
+    readonly speed: number;
+    readonly paused: boolean;
+}
+interface Model {
+    readonly equilibrium: (c: ChemicalConfig) => readonly [number, number];
+    readonly reaction: (u: number, v: number, c: ChemicalConfig) => readonly [number, number];
+    readonly excite: boolean;
+}
+export declare const schnakenbergModel: Model;
+export declare const brusselatorModel: Model;
+export declare const barkleyModel: Model;
+export declare class ChemicalField {
+    private readonly options;
+    u: Float32Array;
+    v: Float32Array;
+    private nextU;
+    private nextV;
+    private maxU;
+    private maxV;
+    readonly width: number;
+    readonly height: number;
+    readonly baseline: number;
+    constructor(options: {
+        width: number;
+        height: number;
+        config: ChemicalConfig;
+        model: Model;
+    });
+    advance(count: number): void;
+    paint(options: {
+        u: number;
+        v: number;
+        radius: number;
+        strength: number;
+    }): void;
+    stir(options: {
+        u: number;
+        v: number;
+        du: number;
+        dv: number;
+        radius: number;
+    }): void;
+    intensity(index: number): number;
+    dispose(): void;
+}
+export {};

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

@@ -0,0 +1,154 @@
+const schnakenbergModel = {
+  equilibrium: (c) => [c.a + c.b, c.b / (c.a + c.b) ** 2],
+  reaction: (u, v, c) => {
+    const q = u * u * v;
+    return [c.a - u + q, c.b - q];
+  },
+  excite: false
+};
+const brusselatorModel = {
+  equilibrium: (c) => [c.a, c.b / c.a],
+  reaction: (u, v, c) => {
+    const q = u * u * v;
+    return [c.a - (c.b + 1) * u + q, c.b * u - q];
+  },
+  excite: false
+};
+const barkleyModel = {
+  equilibrium: () => [0, 0],
+  reaction: (u, v, c) => [
+    u * (1 - u) * (u - (v + c.b) / c.a) / c.epsilon,
+    u - v
+  ],
+  excite: true
+};
+function hash(i, seed) {
+  let n = Math.imul(i ^ seed, 73244475);
+  n = Math.imul(n ^ n >>> 16, 73244475);
+  return ((n ^ n >>> 16) >>> 0) / 4294967295;
+}
+const wrap = (value, size) => (value % size + size) % size;
+class ChemicalField {
+  constructor(options) {
+    this.options = options;
+    this.width = options.width;
+    this.height = options.height;
+    const n = this.width * this.height;
+    this.u = new Float32Array(n);
+    this.v = new Float32Array(n);
+    this.nextU = new Float32Array(n);
+    this.nextV = new Float32Array(n);
+    const c = options.config, [u, v] = options.model.equilibrium(c);
+    this.baseline = options.model.excite ? 1 : u;
+    for (let y = 0; y < this.height; y++)
+      for (let x = 0; x < this.width; x++) {
+        const i = y * this.width + x, noise = hash(i, c.seed) - 0.5;
+        if (options.model.excite) {
+          const split = 0.5 + (hash(0, c.seed) - 0.5) * 0.08;
+          this.u[i] = (x > this.width * 0.22 && x < this.width * 0.5 && y < this.height * split ? 1 : 0) * (1 - c.initialNoise * 0.5) + c.initialNoise * Math.max(0, noise);
+          this.v[i] = y >= this.height * split ? 0.5 : 0;
+        } else {
+          this.u[i] = u * (1 + c.initialNoise * noise);
+          this.v[i] = v * (1 + c.initialNoise * (hash(i, c.seed ^ 1367130551) - 0.5));
+        }
+      }
+    this.maxU = Math.max(1, u * 1.5);
+    this.maxV = Math.max(1, v * 1.5);
+    this.advance(c.warmupSteps);
+  }
+  options;
+  u;
+  v;
+  nextU;
+  nextV;
+  maxU = 1;
+  maxV = 1;
+  width;
+  height;
+  baseline;
+  advance(count) {
+    const { config: c, model } = this.options, w = this.width, h = this.height;
+    for (let step = 0; step < count; step++) {
+      const stiffness = model.excite ? 1 / c.epsilon : 1 + this.maxU * this.maxU + 2 * this.maxU * this.maxV + c.b;
+      const dt = Math.min(
+        0.05,
+        0.2 / Math.max(1e-3, c.diffusionU, c.diffusionV),
+        0.1 / stiffness
+      );
+      let maxU = 0, maxV = 0;
+      for (let y = 0; y < h; y++) {
+        const row = y * w, above = (y === 0 ? h - 1 : y - 1) * w, below = (y === h - 1 ? 0 : y + 1) * w;
+        for (let x = 0; x < w; x++) {
+          const i = row + x, left = row + (x === 0 ? w - 1 : x - 1), right = row + (x === w - 1 ? 0 : x + 1);
+          const u = this.u[i], v = this.v[i];
+          const lapU = this.u[left] + this.u[right] + this.u[above + x] + this.u[below + x] - 4 * u;
+          const lapV = this.v[left] + this.v[right] + this.v[above + x] + this.v[below + x] - 4 * v;
+          const [ru, rv] = model.reaction(u, v, c);
+          const nu = Math.max(0, u + dt * (c.diffusionU * lapU + ru));
+          const nv = Math.max(0, v + dt * (c.diffusionV * lapV + rv));
+          if (!Number.isFinite(nu) || !Number.isFinite(nv))
+            throw new RangeError(
+              "Reaction-diffusion parameters produced a nonfinite field."
+            );
+          this.nextU[i] = nu;
+          this.nextV[i] = nv;
+          maxU = Math.max(maxU, nu);
+          maxV = Math.max(maxV, nv);
+        }
+      }
+      [this.u, this.nextU] = [this.nextU, this.u];
+      [this.v, this.nextV] = [this.nextV, this.v];
+      this.maxU = maxU;
+      this.maxV = maxV;
+    }
+  }
+  paint(options) {
+    const { width: w, height: h } = this;
+    for (let y = 0; y < h; y++)
+      for (let x = 0; x < w; x++) {
+        const dx = wrap(x - options.u * w + w / 2, w) - w / 2, dy = wrap(y - options.v * h + h / 2, h) - h / 2;
+        const distance = Math.hypot(dx, dy) / options.radius;
+        if (distance >= 1) continue;
+        const dose = options.strength * (1 - distance * distance) ** 2;
+        const i = y * w + x;
+        this.u[i] = Math.max(
+          this.u[i],
+          this.options.model.excite ? dose : this.baseline * (1 + 2 * dose)
+        );
+      }
+    this.maxU = Math.max(this.maxU, this.baseline * 3);
+  }
+  stir(options) {
+    const w = this.width, h = this.height;
+    const sample = (field, x, y) => {
+      x = wrap(x, w);
+      y = wrap(y, h);
+      const ix = Math.floor(x), iy = Math.floor(y), fx = x - ix, fy = y - iy;
+      const x1 = (ix + 1) % w, y1 = (iy + 1) % h;
+      return (field[iy * w + ix] * (1 - fx) + field[iy * w + x1] * fx) * (1 - fy) + (field[y1 * w + ix] * (1 - fx) + field[y1 * w + x1] * fx) * fy;
+    };
+    for (let y = 0; y < h; y++)
+      for (let x = 0; x < w; x++) {
+        const dx = wrap(x - options.u * w + w / 2, w) - w / 2, dy = wrap(y - options.v * h + h / 2, h) - h / 2;
+        const t = Math.max(0, 1 - Math.hypot(dx, dy) / options.radius), weight = t * t * (3 - 2 * t);
+        const px = x - options.du * w * weight, py = y - options.dv * h * weight, i = y * w + x;
+        this.nextU[i] = sample(this.u, px, py);
+        this.nextV[i] = sample(this.v, px, py);
+      }
+    [this.u, this.nextU] = [this.nextU, this.u];
+    [this.v, this.nextV] = [this.nextV, this.v];
+  }
+  intensity(index) {
+    return this.options.model.excite ? this.u[index] : this.u[index] / (2 * this.baseline);
+  }
+  dispose() {
+    this.u = this.v = this.nextU = this.nextV = new Float32Array(0);
+  }
+}
+export {
+  ChemicalField,
+  barkleyModel,
+  brusselatorModel,
+  schnakenbergModel
+};
+//# sourceMappingURL=chemical-field.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/chemical-field.ts"],
+  "sourcesContent": ["/** Private periodic finite-difference state; presentation adds a duplicate seam row/column. */\nexport interface ChemicalConfig {\n  readonly a: number;\n  readonly b: number;\n  readonly epsilon: number;\n  readonly diffusionU: number;\n  readonly diffusionV: number;\n  readonly seed: number;\n  readonly initialNoise: number;\n  readonly warmupSteps: number;\n  readonly speed: number;\n  readonly paused: boolean;\n}\ninterface Model {\n  readonly equilibrium: (c: ChemicalConfig) => readonly [number, number];\n  readonly reaction: (\n    u: number,\n    v: number,\n    c: ChemicalConfig,\n  ) => readonly [number, number];\n  readonly excite: boolean;\n}\nexport const schnakenbergModel: Model = {\n  equilibrium: (c) => [c.a + c.b, c.b / (c.a + c.b) ** 2],\n  reaction: (u, v, c) => {\n    const q = u * u * v;\n    return [c.a - u + q, c.b - q];\n  },\n  excite: false,\n};\nexport const brusselatorModel: Model = {\n  equilibrium: (c) => [c.a, c.b / c.a],\n  reaction: (u, v, c) => {\n    const q = u * u * v;\n    return [c.a - (c.b + 1) * u + q, c.b * u - q];\n  },\n  excite: false,\n};\nexport const barkleyModel: Model = {\n  equilibrium: () => [0, 0],\n  reaction: (u, v, c) => [\n    (u * (1 - u) * (u - (v + c.b) / c.a)) / c.epsilon,\n    u - v,\n  ],\n  excite: true,\n};\nfunction hash(i: number, seed: number) {\n  let n = Math.imul(i ^ seed, 0x45d9f3b);\n  n = Math.imul(n ^ (n >>> 16), 0x45d9f3b);\n  return ((n ^ (n >>> 16)) >>> 0) / 0xffffffff;\n}\nconst wrap = (value: number, size: number) => ((value % size) + size) % size;\nexport class ChemicalField {\n  u: Float32Array;\n  v: Float32Array;\n  private nextU: Float32Array;\n  private nextV: Float32Array;\n  private maxU = 1;\n  private maxV = 1;\n  readonly width: number;\n  readonly height: number;\n  readonly baseline: number;\n  constructor(\n    private readonly options: {\n      width: number;\n      height: number;\n      config: ChemicalConfig;\n      model: Model;\n    },\n  ) {\n    this.width = options.width;\n    this.height = options.height;\n    const n = this.width * this.height;\n    this.u = new Float32Array(n);\n    this.v = new Float32Array(n);\n    this.nextU = new Float32Array(n);\n    this.nextV = new Float32Array(n);\n    const c = options.config,\n      [u, v] = options.model.equilibrium(c);\n    this.baseline = options.model.excite ? 1 : u;\n    for (let y = 0; y < this.height; y++)\n      for (let x = 0; x < this.width; x++) {\n        const i = y * this.width + x,\n          noise = hash(i, c.seed) - 0.5;\n        if (options.model.excite) {\n          const split = 0.5 + (hash(0, c.seed) - 0.5) * 0.08;\n          this.u[i] =\n            (x > this.width * 0.22 &&\n            x < this.width * 0.5 &&\n            y < this.height * split\n              ? 1\n              : 0) *\n              (1 - c.initialNoise * 0.5) +\n            c.initialNoise * Math.max(0, noise);\n          this.v[i] = y >= this.height * split ? 0.5 : 0;\n        } else {\n          this.u[i] = u * (1 + c.initialNoise * noise);\n          this.v[i] =\n            v * (1 + c.initialNoise * (hash(i, c.seed ^ 0x517cc1b7) - 0.5));\n        }\n      }\n    this.maxU = Math.max(1, u * 1.5);\n    this.maxV = Math.max(1, v * 1.5);\n    this.advance(c.warmupSteps);\n  }\n  advance(count: number) {\n    const { config: c, model } = this.options,\n      w = this.width,\n      h = this.height;\n    for (let step = 0; step < count; step++) {\n      // Euler diffusion CFL and reaction stiffness limits. No user-facing time-step knob.\n      const stiffness = model.excite\n        ? 1 / c.epsilon\n        : 1 + this.maxU * this.maxU + 2 * this.maxU * this.maxV + c.b;\n      const dt = Math.min(\n        0.05,\n        0.2 / Math.max(0.001, c.diffusionU, c.diffusionV),\n        0.1 / stiffness,\n      );\n      let maxU = 0,\n        maxV = 0;\n      for (let y = 0; y < h; y++) {\n        const row = y * w,\n          above = (y === 0 ? h - 1 : y - 1) * w,\n          below = (y === h - 1 ? 0 : y + 1) * w;\n        for (let x = 0; x < w; x++) {\n          const i = row + x,\n            left = row + (x === 0 ? w - 1 : x - 1),\n            right = row + (x === w - 1 ? 0 : x + 1);\n          const u = this.u[i]!,\n            v = this.v[i]!;\n          const lapU =\n            this.u[left]! +\n            this.u[right]! +\n            this.u[above + x]! +\n            this.u[below + x]! -\n            4 * u;\n          const lapV =\n            this.v[left]! +\n            this.v[right]! +\n            this.v[above + x]! +\n            this.v[below + x]! -\n            4 * v;\n          const [ru, rv] = model.reaction(u, v, c);\n          const nu = Math.max(0, u + dt * (c.diffusionU * lapU + ru));\n          const nv = Math.max(0, v + dt * (c.diffusionV * lapV + rv));\n          if (!Number.isFinite(nu) || !Number.isFinite(nv))\n            throw new RangeError(\n              \"Reaction-diffusion parameters produced a nonfinite field.\",\n            );\n          this.nextU[i] = nu;\n          this.nextV[i] = nv;\n          maxU = Math.max(maxU, nu);\n          maxV = Math.max(maxV, nv);\n        }\n      }\n      [this.u, this.nextU] = [this.nextU, this.u];\n      [this.v, this.nextV] = [this.nextV, this.v];\n      this.maxU = maxU;\n      this.maxV = maxV;\n    }\n  }\n  paint(options: { u: number; v: number; radius: number; strength: number }) {\n    const { width: w, height: h } = this;\n    for (let y = 0; y < h; y++)\n      for (let x = 0; x < w; x++) {\n        const dx = wrap(x - options.u * w + w / 2, w) - w / 2,\n          dy = wrap(y - options.v * h + h / 2, h) - h / 2;\n        const distance = Math.hypot(dx, dy) / options.radius;\n        if (distance >= 1) continue;\n        const dose = options.strength * (1 - distance * distance) ** 2;\n        const i = y * w + x;\n        this.u[i] = Math.max(\n          this.u[i]!,\n          this.options.model.excite ? dose : this.baseline * (1 + 2 * dose),\n        );\n      }\n    this.maxU = Math.max(this.maxU, this.baseline * 3);\n  }\n  stir(options: {\n    u: number;\n    v: number;\n    du: number;\n    dv: number;\n    radius: number;\n  }) {\n    const w = this.width,\n      h = this.height;\n    const sample = (field: Float32Array, x: number, y: number) => {\n      x = wrap(x, w);\n      y = wrap(y, h);\n      const ix = Math.floor(x),\n        iy = Math.floor(y),\n        fx = x - ix,\n        fy = y - iy;\n      const x1 = (ix + 1) % w,\n        y1 = (iy + 1) % h;\n      return (\n        (field[iy * w + ix]! * (1 - fx) + field[iy * w + x1]! * fx) * (1 - fy) +\n        (field[y1 * w + ix]! * (1 - fx) + field[y1 * w + x1]! * fx) * fy\n      );\n    };\n    for (let y = 0; y < h; y++)\n      for (let x = 0; x < w; x++) {\n        const dx = wrap(x - options.u * w + w / 2, w) - w / 2,\n          dy = wrap(y - options.v * h + h / 2, h) - h / 2;\n        const t = Math.max(0, 1 - Math.hypot(dx, dy) / options.radius),\n          weight = t * t * (3 - 2 * t);\n        const px = x - options.du * w * weight,\n          py = y - options.dv * h * weight,\n          i = y * w + x;\n        this.nextU[i] = sample(this.u, px, py);\n        this.nextV[i] = sample(this.v, px, py);\n      }\n    [this.u, this.nextU] = [this.nextU, this.u];\n    [this.v, this.nextV] = [this.nextV, this.v];\n  }\n  intensity(index: number) {\n    return this.options.model.excite\n      ? this.u[index]!\n      : this.u[index]! / (2 * this.baseline);\n  }\n  dispose() {\n    this.u = this.v = this.nextU = this.nextV = new Float32Array(0);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/textures/lib/chemical-recipes.d.ts

@@ -0,0 +1,119 @@
+import { type TextureRecipe } from "@pibbl/core";
+import type { InkMessage } from "./definitions.js";
+/** Shared simulation timing, diffusion and initialization controls. See {@link SchnakenbergOptions}. */
+interface ChemicalOptions {
+    /** Unsigned 32-bit initialization seed; default 42. See {@link schnakenberg}. */
+    readonly seed?: number;
+    /** Activator diffusion per grid cell, finite 0–32. See {@link schnakenberg}. */
+    readonly diffusionU?: number;
+    /** Inhibitor diffusion per grid cell, finite 0–32. See {@link schnakenberg}. */
+    readonly diffusionV?: number;
+    /** Initial seeded disturbance amplitude, finite 0–1; default 0.1. See {@link schnakenberg}. */
+    readonly initialNoise?: number;
+    /** Initialization steps, integer 0–12000; default 4096. See {@link schnakenberg}. */
+    readonly warmupSteps?: number;
+    /** Multiplier of 480 numerical steps/second, finite 0–4; default 1. Zero idles. See {@link schnakenberg}. */
+    readonly speed?: number;
+    /** Initially suspend stepping; default false. See {@link InkMessage}. */
+    readonly paused?: boolean;
+}
+/** Schnakenberg production rates, diffusion and initialization. See {@link schnakenberg}. */
+export interface SchnakenbergOptions extends ChemicalOptions {
+    /** Activator source, finite 0.01–2; default 0.1. See {@link schnakenberg}. */
+    readonly a?: number;
+    /** Inhibitor source, finite 0.01–2; default 0.9. See {@link schnakenberg}. */
+    readonly b?: number;
+}
+/** Excitability, recovery, diffusion and initialization. See {@link barkley}. */
+export interface BarkleyOptions extends ChemicalOptions {
+    /** Excitability scale, finite 0.3–1.2; default 0.75. See {@link barkley}. */
+    readonly a?: number;
+    /** Excitation threshold offset, finite 0–0.2; default 0.02. See {@link barkley}. */
+    readonly b?: number;
+    /** Fast/slow time separation, finite 0.005–0.1; default 0.02. See {@link barkley}. */
+    readonly epsilon?: number;
+}
+/** Brusselator feed rates, diffusion and initialization. See {@link brusselator}. */
+export interface BrusselatorOptions extends ChemicalOptions {
+    /** Activator feed, finite 0.1–3; default 1. See {@link brusselator}. */
+    readonly a?: number;
+    /** Conversion rate, finite 0.1–5; default 1.8. See {@link brusselator}. */
+    readonly b?: number;
+}
+/** Immutable Schnakenberg starting configurations. See {@link SchnakenbergOptions}. */
+export declare const schnakenbergPresets: Readonly<{
+    /** Separated activator spots. See {@link schnakenberg}. */
+    spots: Readonly<{
+        a: 0.1;
+        b: 0.9;
+        diffusionU: 1;
+        diffusionV: 20;
+    }>;
+    /** Connected activator bands. See {@link schnakenberg}. */
+    labyrinths: Readonly<{
+        a: 0.01;
+        b: 1.7;
+        diffusionU: 1;
+        diffusionV: 20;
+        warmupSteps: 10000;
+    }>;
+}>;
+/** Immutable Barkley starting configurations. See {@link BarkleyOptions}. */
+export declare const barkleyPresets: Readonly<{
+    /** Broken excitation fronts form rotating spirals. See {@link barkley}. */
+    spirals: Readonly<{
+        a: 0.75;
+        b: 0.02;
+        epsilon: 0.02;
+        diffusionU: 1;
+        diffusionV: 0;
+    }>;
+    /** Broader propagating excitation fronts. See {@link barkley}. */
+    waves: Readonly<{
+        a: 0.9;
+        b: 0.01;
+        epsilon: 0.04;
+        diffusionU: 1;
+        diffusionV: 0;
+    }>;
+}>;
+/** Immutable Brusselator starting configurations. See {@link BrusselatorOptions}. */
+export declare const brusselatorPresets: Readonly<{
+    /** Differential diffusion supports stationary spots. See {@link brusselator}. */
+    spots: Readonly<{
+        a: 1;
+        b: 1.9;
+        diffusionU: 0.2;
+        diffusionV: 2;
+        warmupSteps: 10000;
+    }>;
+    /** Equal diffusion above the oscillation threshold. See {@link brusselator}. */
+    oscillations: Readonly<{
+        a: 1;
+        b: 3;
+        diffusionU: 0.3;
+        diffusionV: 0.3;
+    }>;
+}>;
+/**
+ * Creates a periodic Schnakenberg activator/inhibitor texture with paint, stir, pause and reset.
+ * @param options - Reaction rates, diffusion and initialization. See {@link SchnakenbergOptions}.
+ * @returns A mountable simulation recipe. See {@link TextureRecipe}, {@link InkMessage}.
+ * @see {@link schnakenbergPresets}
+ */
+export declare function schnakenberg(options?: SchnakenbergOptions): TextureRecipe<InkMessage>;
+/**
+ * Creates a periodic Barkley excitable texture initialized with a broken excitation front.
+ * @param options - Excitability, recovery, diffusion and initialization. See {@link BarkleyOptions}.
+ * @returns A mountable simulation recipe. See {@link TextureRecipe}, {@link InkMessage}.
+ * @see {@link barkleyPresets}
+ */
+export declare function barkley(options?: BarkleyOptions): TextureRecipe<InkMessage>;
+/**
+ * Creates a periodic Brusselator texture with paint, stir, pause and reset.
+ * @param options - Feed rates, diffusion and initialization. See {@link BrusselatorOptions}.
+ * @returns A mountable simulation recipe. See {@link TextureRecipe}, {@link InkMessage}.
+ * @see {@link brusselatorPresets}
+ */
+export declare function brusselator(options?: BrusselatorOptions): TextureRecipe<InkMessage>;
+export {};