@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/textures/lib/palette.ts"],
-  "sourcesContent": ["import type { ProceduralTextureProps } from './procedural-texture.js';\nimport type { ReactionDiffusionProps } from './reaction-diffusion.js';\n/**\n * Ordered colors forming a texture's presentation ramp.\n *\n * @see {@link texturePalettes}\n * @see {@link ProceduralTextureProps}\n * @see {@link ReactionDiffusionProps}\n */\nexport type TexturePalette = readonly string[];\n/**\n * Built-in immutable color ramps for procedural texture presentation.\n *\n * @see {@link TexturePalette}\n */\nexport const texturePalettes = Object.freeze({\n  /** Dark blue through teal to pale yellow. See {@link texturePalettes}. */\n  lagoon: Object.freeze([\"#081e2c\", \"#125568\", \"#50b8ad\", \"#e5efb3\"]),\n  /** Warm ivory through lavender to deep blue. See {@link texturePalettes}. */\n  porcelain: Object.freeze([\"#f2e7d4\", \"#b7a9c0\", \"#536194\", \"#172955\"]),\n  /** Dark violet through coral to pale yellow. See {@link texturePalettes}. */\n  ember: Object.freeze([\"#241526\", \"#893955\", \"#e88470\", \"#ffe3aa\"]),\n});\n\nexport function paletteLut(palette: TexturePalette): Uint8ClampedArray {\n  if (palette.length < 2 || palette.length > 16)\n    throw new RangeError(\"Texture palette requires 2\u201316 #RRGGBB colors.\");\n  const colors = palette.map((color) => {\n    if (!/^#[0-9a-f]{6}$/i.test(color))\n      throw new TypeError(\"Texture palette colors must use #RRGGBB.\");\n    return [\n      parseInt(color.slice(1, 3), 16),\n      parseInt(color.slice(3, 5), 16),\n      parseInt(color.slice(5, 7), 16),\n    ];\n  });\n  const lut = new Uint8ClampedArray(256 * 4);\n  for (let i = 0; i < 256; i++) {\n    const position = (i / 255) * (colors.length - 1);\n    const lo = Math.min(colors.length - 2, Math.floor(position)),\n      mix = position - lo;\n    for (let c = 0; c < 3; c++)\n      lut[i * 4 + c] = colors[lo][c] * (1 - mix) + colors[lo + 1][c] * mix;\n    lut[i * 4 + 3] = 255;\n  }\n  return lut;\n}\n\n/**\n * The width and height of a texture's raster grid.\n *\n * @see {@link TexturePalette}\n * @see {@link ReactionDiffusionProps}\n * @see {@link ProceduralTextureProps}\n */\nexport interface TextureResolution {\n  /**\n   * Horizontal extent in the units of the containing geometry or surface. See\n   * {@link TextureResolution}.\n   */\n  readonly width: number;\n  /**\n   * Vertical extent in the units of the containing geometry or surface. See\n   * {@link TextureResolution}.\n   */\n  readonly height: number;\n}\nexport function validateResolution(\n  value: TextureResolution = { width: 256, height: 160 },\n): TextureResolution {\n  if (\n    ![value.width, value.height].every(\n      (n) => Number.isInteger(n) && n >= 8 && n <= 1024,\n    ) ||\n    value.width * value.height > 262144\n  ) {\n    throw new RangeError(\n      \"Texture resolution must contain integer dimensions from 8 to 1024 and at most 262144 cells.\",\n    );\n  }\n  return { width: value.width, height: value.height };\n}\nexport function validateSeed(seed = 42): number {\n  if (!Number.isInteger(seed) || seed < 0 || seed > 0xffffffff)\n    throw new RangeError(\"Texture seed must be an unsigned 32-bit integer.\");\n  return seed;\n}\n"],
-  "mappings": "AAeO,MAAM,kBAAkB,OAAO,OAAO;AAAA;AAAA,EAE3C,QAAQ,OAAO,OAAO,CAAC,WAAW,WAAW,WAAW,SAAS,CAAC;AAAA;AAAA,EAElE,WAAW,OAAO,OAAO,CAAC,WAAW,WAAW,WAAW,SAAS,CAAC;AAAA;AAAA,EAErE,OAAO,OAAO,OAAO,CAAC,WAAW,WAAW,WAAW,SAAS,CAAC;AACnE,CAAC;AAEM,SAAS,WAAW,SAA4C;AACrE,MAAI,QAAQ,SAAS,KAAK,QAAQ,SAAS;AACzC,UAAM,IAAI,WAAW,oDAA+C;AACtE,QAAM,SAAS,QAAQ,IAAI,CAAC,UAAU;AACpC,QAAI,CAAC,kBAAkB,KAAK,KAAK;AAC/B,YAAM,IAAI,UAAU,0CAA0C;AAChE,WAAO;AAAA,MACL,SAAS,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,MAC9B,SAAS,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,MAC9B,SAAS,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,IAChC;AAAA,EACF,CAAC;AACD,QAAM,MAAM,IAAI,kBAAkB,MAAM,CAAC;AACzC,WAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,UAAM,WAAY,IAAI,OAAQ,OAAO,SAAS;AAC9C,UAAM,KAAK,KAAK,IAAI,OAAO,SAAS,GAAG,KAAK,MAAM,QAAQ,CAAC,GACzD,MAAM,WAAW;AACnB,aAAS,IAAI,GAAG,IAAI,GAAG;AACrB,UAAI,IAAI,IAAI,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,OAAO,KAAK,CAAC,EAAE,CAAC,IAAI;AACnE,QAAI,IAAI,IAAI,CAAC,IAAI;AAAA,EACnB;AACA,SAAO;AACT;AAqBO,SAAS,mBACd,QAA2B,EAAE,OAAO,KAAK,QAAQ,IAAI,GAClC;AACnB,MACE,CAAC,CAAC,MAAM,OAAO,MAAM,MAAM,EAAE;AAAA,IAC3B,CAAC,MAAM,OAAO,UAAU,CAAC,KAAK,KAAK,KAAK,KAAK;AAAA,EAC/C,KACA,MAAM,QAAQ,MAAM,SAAS,QAC7B;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO;AACpD;AACO,SAAS,aAAa,OAAO,IAAY;AAC9C,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO;AAChD,UAAM,IAAI,WAAW,kDAAkD;AACzE,SAAO;AACT;",
+  "sourcesContent": ["import type { ProceduralTextureProps } from './procedural-texture.js';\nimport type { ReactionDiffusionProps } from './reaction-diffusion.js';\n/**\n * Ordered colors forming a texture's presentation ramp.\n *\n * @see {@link texturePalettes}\n * @see {@link ProceduralTextureProps}\n * @see {@link ReactionDiffusionProps}\n */\nexport type TexturePalette = readonly string[];\n/**\n * Built-in immutable color ramps for procedural texture presentation.\n *\n * @see {@link TexturePalette}\n */\nexport const texturePalettes = Object.freeze({\n  /** Dark blue through teal to pale yellow. See {@link texturePalettes}. */\n  lagoon: Object.freeze([\"#081e2c\", \"#125568\", \"#50b8ad\", \"#e5efb3\"]),\n  /** Warm ivory through lavender to deep blue. See {@link texturePalettes}. */\n  porcelain: Object.freeze([\"#f2e7d4\", \"#b7a9c0\", \"#536194\", \"#172955\"]),\n  /** Dark violet through coral to pale yellow. See {@link texturePalettes}. */\n  ember: Object.freeze([\"#241526\", \"#893955\", \"#e88470\", \"#ffe3aa\"]),\n});\n\nexport function paletteLut(palette: TexturePalette): Uint8ClampedArray {\n  if (palette.length < 2 || palette.length > 16)\n    throw new RangeError(\"Texture palette requires 2\u201316 #RRGGBB colors.\");\n  const colors = palette.map((color) => {\n    if (!/^#[0-9a-f]{6}$/i.test(color))\n      throw new TypeError(\"Texture palette colors must use #RRGGBB.\");\n    return [\n      parseInt(color.slice(1, 3), 16),\n      parseInt(color.slice(3, 5), 16),\n      parseInt(color.slice(5, 7), 16),\n    ];\n  });\n  const lut = new Uint8ClampedArray(256 * 4);\n  for (let i = 0; i < 256; i++) {\n    const position = (i / 255) * (colors.length - 1);\n    const lo = Math.min(colors.length - 2, Math.floor(position)),\n      mix = position - lo;\n    for (let c = 0; c < 3; c++)\n      lut[i * 4 + c] = colors[lo][c] * (1 - mix) + colors[lo + 1][c] * mix;\n    lut[i * 4 + 3] = 255;\n  }\n  return lut;\n}\n\n/**\n * The width and height of a texture's raster grid.\n *\n * @see {@link TexturePalette}\n * @see {@link ReactionDiffusionProps}\n * @see {@link ProceduralTextureProps}\n */\nexport interface TextureResolution {\n  /**\n   * Horizontal extent in the units of the containing geometry or surface. See\n   * {@link TextureResolution}.\n   */\n  readonly width: number;\n  /**\n   * Vertical extent in the units of the containing geometry or surface. See\n   * {@link TextureResolution}.\n   */\n  readonly height: number;\n}\nexport function validateResolution(\n  value: TextureResolution = { width: 256, height: 160 },\n): TextureResolution {\n  if (\n    !(\n      Number.isInteger(value.width) &&\n      value.width >= 8 &&\n      value.width <= 1024 &&\n      Number.isInteger(value.height) &&\n      value.height >= 8 &&\n      value.height <= 1024\n    ) ||\n    value.width * value.height > 262144\n  ) {\n    throw new RangeError(\n      \"Texture resolution must contain integer dimensions from 8 to 1024 and at most 262144 cells.\",\n    );\n  }\n  return { width: value.width, height: value.height };\n}\nexport function validateSeed(seed = 42): number {\n  if (!Number.isInteger(seed) || seed < 0 || seed > 0xffffffff)\n    throw new RangeError(\"Texture seed must be an unsigned 32-bit integer.\");\n  return seed;\n}\n"],
+  "mappings": "AAeO,MAAM,kBAAkB,OAAO,OAAO;AAAA;AAAA,EAE3C,QAAQ,OAAO,OAAO,CAAC,WAAW,WAAW,WAAW,SAAS,CAAC;AAAA;AAAA,EAElE,WAAW,OAAO,OAAO,CAAC,WAAW,WAAW,WAAW,SAAS,CAAC;AAAA;AAAA,EAErE,OAAO,OAAO,OAAO,CAAC,WAAW,WAAW,WAAW,SAAS,CAAC;AACnE,CAAC;AAEM,SAAS,WAAW,SAA4C;AACrE,MAAI,QAAQ,SAAS,KAAK,QAAQ,SAAS;AACzC,UAAM,IAAI,WAAW,oDAA+C;AACtE,QAAM,SAAS,QAAQ,IAAI,CAAC,UAAU;AACpC,QAAI,CAAC,kBAAkB,KAAK,KAAK;AAC/B,YAAM,IAAI,UAAU,0CAA0C;AAChE,WAAO;AAAA,MACL,SAAS,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,MAC9B,SAAS,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,MAC9B,SAAS,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,IAChC;AAAA,EACF,CAAC;AACD,QAAM,MAAM,IAAI,kBAAkB,MAAM,CAAC;AACzC,WAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,UAAM,WAAY,IAAI,OAAQ,OAAO,SAAS;AAC9C,UAAM,KAAK,KAAK,IAAI,OAAO,SAAS,GAAG,KAAK,MAAM,QAAQ,CAAC,GACzD,MAAM,WAAW;AACnB,aAAS,IAAI,GAAG,IAAI,GAAG;AACrB,UAAI,IAAI,IAAI,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,OAAO,KAAK,CAAC,EAAE,CAAC,IAAI;AACnE,QAAI,IAAI,IAAI,CAAC,IAAI;AAAA,EACnB;AACA,SAAO;AACT;AAqBO,SAAS,mBACd,QAA2B,EAAE,OAAO,KAAK,QAAQ,IAAI,GAClC;AACnB,MACE,EACE,OAAO,UAAU,MAAM,KAAK,KAC5B,MAAM,SAAS,KACf,MAAM,SAAS,QACf,OAAO,UAAU,MAAM,MAAM,KAC7B,MAAM,UAAU,KAChB,MAAM,UAAU,SAElB,MAAM,QAAQ,MAAM,SAAS,QAC7B;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO;AACpD;AACO,SAAS,aAAa,OAAO,IAAY;AAC9C,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO;AAChD,UAAM,IAAI,WAAW,kDAAkD;AACzE,SAAO;AACT;",
   "names": []
 }

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

@@ -0,0 +1,123 @@
+import { type TextureRecipe } from "@pibbl/core";
+/** Shared periodic motion controls for geometric and fiber recipes. @see {@link stripes} */
+export interface PatternMotionOptions {
+    /** Initial phase in cycles; any finite value wraps. See {@link PatternMotionOptions}. */
+    readonly phase?: number;
+    /** Nonnegative cycles per second, up to 20; zero idles. See {@link PatternMotionOptions}. */
+    readonly speed?: number;
+}
+/** Controls for periodic stripes; rotate the repeat lattice through paint placement. @see {@link stripes} */
+export interface StripesOptions extends PatternMotionOptions {
+    /** Integer stripe periods across the tile, 1–64; default 8. See {@link StripesOptions}. */
+    readonly bands?: number;
+    /** Foreground fraction of each period, 0–1; default 0.5. See {@link StripesOptions}. */
+    readonly dutyCycle?: number;
+    /** Horizontal wave amplitude in tile fractions, 0–1; default 0. See {@link StripesOptions}. */
+    readonly wave?: number;
+    /** Integer wave periods down the tile, 1–16; default 1. See {@link StripesOptions}. */
+    readonly waveCycles?: number;
+}
+/** Controls for a two-color checkerboard. @see {@link checkers} */
+export interface CheckersOptions extends PatternMotionOptions {
+    /** Even integer columns, 2–64; default 8. See {@link CheckersOptions}. */
+    readonly columns?: number;
+    /** Even integer rows, 2–64; default 8. See {@link CheckersOptions}. */
+    readonly rows?: number;
+}
+/** Controls for seeded seamless wood grain with optional knots. @see {@link woodGrain} */
+export interface WoodGrainOptions extends PatternMotionOptions {
+    /** Unsigned 32-bit variation seed; default 42. See {@link WoodGrainOptions}. */
+    readonly seed?: number;
+    /** Integer grain periods across the tile, 4–128; default 32. See {@link WoodGrainOptions}. */
+    readonly grain?: number;
+    /** Irregular grain bending, 0–1; default 0.5. See {@link WoodGrainOptions}. */
+    readonly distortion?: number;
+    /** Fine fiber and pore variation, 0–1; default 0.4. See {@link WoodGrainOptions}. */
+    readonly roughness?: number;
+    /** Integer knot count, 0–12; default 0 for clear grain. See {@link WoodGrainOptions}. */
+    readonly knots?: number;
+    /** Knot radius in tile fractions, 0.02–0.18; default 0.09. See {@link WoodGrainOptions}. */
+    readonly knotSize?: number;
+}
+/**
+ * Creates seamless straight or wavy stripes using the palette endpoints.
+ * @param options - Stripe geometry and periodic motion. See {@link StripesOptions}.
+ * @returns A mountable texture recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link StripesOptions}
+ */
+export declare function stripes(options?: StripesOptions): TextureRecipe;
+/**
+ * Creates a seamless checkerboard using the palette endpoints.
+ * @param options - Even row/column counts and periodic motion. See {@link CheckersOptions}.
+ * @returns A mountable texture recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link CheckersOptions}
+ */
+export declare function checkers(options?: CheckersOptions): TextureRecipe;
+/**
+ * Creates seamless seeded wood with irregular grain, fine fibers, and optional knots.
+ * @param options - Grain frequency, distortion, roughness, knots, seed, and motion. See {@link WoodGrainOptions}.
+ * @returns A mountable texture recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link WoodGrainOptions}
+ */
+export declare function woodGrain(options?: WoodGrainOptions): TextureRecipe;
+/** Shared thread geometry and shading for seamless woven fabrics. @see {@link plainWeave} */
+export interface FabricOptions extends PatternMotionOptions {
+    /** Unsigned 32-bit fiber variation seed; default 42. See {@link FabricOptions}. */
+    readonly seed?: number;
+    /** Thread count on each axis, a multiple of 8 in 8–128; default 16. See {@link FabricOptions}. */
+    readonly threads?: number;
+    /** Thread width as a fraction of cell spacing, 0.2–1; default 0.8. See {@link FabricOptions}. */
+    readonly threadWidth?: number;
+    /** Rounded thread lighting strength, 0–1; default 0.65. See {@link FabricOptions}. */
+    readonly relief?: number;
+    /** Seeded directional fibers and soft, uneven yarn edges, 0–1; default 0.2. See {@link FabricOptions}. */
+    readonly fuzz?: number;
+}
+/**
+ * Creates an alternating over-under plain weave with rounded threads and seeded fibers.
+ * @param options - Thread geometry, shading, seed, and motion. See {@link FabricOptions}.
+ * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link FabricOptions}
+ */
+export declare function plainWeave(options?: FabricOptions): TextureRecipe;
+/**
+ * Creates a two-over, two-under diagonal twill fabric.
+ * @param options - Thread geometry, shading, seed, and motion. See {@link FabricOptions}.
+ * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link FabricOptions}
+ */
+export declare function twill(options?: FabricOptions): TextureRecipe;
+/**
+ * Creates a reversing twill fabric with repeating herringbone chevrons.
+ * @param options - Thread geometry, shading, seed, and motion. See {@link FabricOptions}.
+ * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link FabricOptions}
+ */
+export declare function herringbone(options?: FabricOptions): TextureRecipe;
+/** Seeded seamless noise layers and their tonal response. @see {@link softNoise} */
+export interface NoiseOptions extends PatternMotionOptions {
+    /** Unsigned 32-bit noise seed; default 42. See {@link NoiseOptions}. */
+    readonly seed?: number;
+    /** Integer base lattice periods per axis, 1–16; default 4. See {@link NoiseOptions}. */
+    readonly frequency?: number;
+    /** Number of doubled-frequency layers, integer 1–6; default 4. See {@link NoiseOptions}. */
+    readonly octaves?: number;
+    /** Relative amplitude of each successive layer, 0–1; default 0.5. See {@link NoiseOptions}. */
+    readonly persistence?: number;
+    /** Tonal contrast about the midpoint, 0–4; default 1. See {@link NoiseOptions}. */
+    readonly contrast?: number;
+}
+/**
+ * Creates smooth seamless multiscale lattice noise for clouds, pigment, and material variation.
+ * @param options - Seed, lattice frequencies, amplitudes, contrast, and motion. See {@link NoiseOptions}.
+ * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link NoiseOptions}
+ */
+export declare function softNoise(options?: NoiseOptions): TextureRecipe;
+/**
+ * Creates seamless multiscale ridges by folding each noise layer around its midpoint.
+ * @param options - Seed, lattice frequencies, amplitudes, contrast, and motion. See {@link NoiseOptions}.
+ * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.
+ * @see {@link NoiseOptions}
+ */
+export declare function ridgedNoise(options?: NoiseOptions): TextureRecipe;

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

@@ -0,0 +1,344 @@
+import {
+  defineTexture
+} from "@pibbl/core";
+import { paletteLut, texturePalettes, validateSeed } from "./palette.js";
+const tau = Math.PI * 2;
+function wrap(value) {
+  return (value % 1 + 1) % 1;
+}
+function bounded(name, value, min, max, integer = false) {
+  if (!Number.isFinite(value) || value < min || value > max || integer && !Number.isInteger(value))
+    throw new RangeError(
+      `${name} must be ${integer ? "an integer " : ""}in [${min}, ${max}].`
+    );
+  return value;
+}
+function motion(options) {
+  const phase = options.phase ?? 0;
+  if (!Number.isFinite(phase))
+    throw new RangeError("Texture phase must be finite.");
+  return {
+    phase: wrap(phase),
+    speed: bounded("Texture speed", options.speed ?? 0, 0, 20)
+  };
+}
+function pattern(validate, sample) {
+  const definition = defineTexture({
+    create(context, config) {
+      const { width, height } = context.canvas;
+      if (config.speed > 0) context.requestFrame();
+      return {
+        config,
+        phase: config.phase,
+        fresh: true,
+        fieldDirty: true,
+        field: new Float32Array(width * height),
+        image: new ImageData(width, height)
+      };
+    },
+    update(state, config, context) {
+      if (JSON.stringify(config) === JSON.stringify(state.config)) return;
+      if (config.phase !== state.config.phase) state.phase = config.phase;
+      if (config.speed !== state.config.speed) state.fresh = true;
+      state.config = config;
+      state.fieldDirty = true;
+      context.invalidate();
+      if (config.speed > 0) context.requestFrame();
+    },
+    advance(state, frame, context) {
+      if (state.config.speed === 0) return;
+      if (!state.fresh && frame.delta > 0) {
+        state.phase = wrap(
+          state.phase + frame.delta * state.config.speed / 1e3
+        );
+        state.fieldDirty = true;
+        context.invalidate();
+      }
+      state.fresh = false;
+      context.requestFrame();
+    },
+    rasterize(state, context) {
+      const { width, height } = context.canvas;
+      if (state.fieldDirty) {
+        for (let y = 0; y < height; y++)
+          for (let x = 0; x < width; x++)
+            state.field[y * width + x] = sample(
+              state.config,
+              x === width - 1 ? 0 : x / (width - 1),
+              y === height - 1 ? 0 : y / (height - 1),
+              state.phase
+            );
+        state.fieldDirty = false;
+      }
+      const palette = context.palette ?? texturePalettes.porcelain;
+      const key = palette.join();
+      if (key !== state.paletteKey) {
+        state.lut = paletteLut(palette);
+        state.paletteKey = key;
+      }
+      const image = state.image;
+      const data = image.data, lut = state.lut;
+      for (let i = 0; i < state.field.length; i++) {
+        const index = Math.round(Math.max(0, Math.min(1, state.field[i])) * 255) * 4;
+        data[i * 4] = lut[index];
+        data[i * 4 + 1] = lut[index + 1];
+        data[i * 4 + 2] = lut[index + 2];
+        data[i * 4 + 3] = 255;
+      }
+      context.canvas.getContext("2d").putImageData(image, 0, 0);
+    },
+    dispose(state) {
+      state.field = new Float32Array(0);
+      state.image = void 0;
+      state.lut = void 0;
+    }
+  });
+  return (options) => definition(validate(options));
+}
+const stripeRecipe = /* @__PURE__ */ pattern(
+  (options) => ({
+    ...motion(options),
+    bands: bounded("Stripe bands", options.bands ?? 8, 1, 64, true),
+    dutyCycle: bounded("Stripe dutyCycle", options.dutyCycle ?? 0.5, 0, 1),
+    wave: bounded("Stripe wave", options.wave ?? 0, 0, 1),
+    waveCycles: bounded(
+      "Stripe waveCycles",
+      options.waveCycles ?? 1,
+      1,
+      16,
+      true
+    )
+  }),
+  (c, u, v, phase) => wrap(
+    (u + c.wave * Math.sin(tau * (v * c.waveCycles + phase))) * c.bands + phase
+  ) < c.dutyCycle ? 1 : 0
+);
+function stripes(options = {}) {
+  return stripeRecipe(options);
+}
+const checkerRecipe = /* @__PURE__ */ pattern(
+  (options) => {
+    const columns = bounded(
+      "Checker columns",
+      options.columns ?? 8,
+      2,
+      64,
+      true
+    );
+    const rows = bounded("Checker rows", options.rows ?? 8, 2, 64, true);
+    if (columns % 2 || rows % 2)
+      throw new RangeError(
+        "Checker rows and columns must be even for seamless alternation."
+      );
+    return { ...motion(options), columns, rows };
+  },
+  (c, u, v, phase) => (Math.floor(wrap(u + phase) * c.columns) + Math.floor(v * c.rows)) % 2
+);
+function checkers(options = {}) {
+  return checkerRecipe(options);
+}
+function hash(index, seed) {
+  let value = Math.imul(index ^ seed, 73244475);
+  value = Math.imul(value ^ value >>> 16, 73244475);
+  return ((value ^ value >>> 16) >>> 0) / 4294967295;
+}
+function noise(u, v, columns, rows, seed) {
+  const x = wrap(u) * columns, y = wrap(v) * rows;
+  const ix = Math.floor(x), iy = Math.floor(y);
+  const fx = x - ix, fy = y - iy;
+  const sx = fx * fx * fx * (fx * (fx * 6 - 15) + 10);
+  const sy = fy * fy * fy * (fy * (fy * 6 - 15) + 10);
+  const a = hash(iy * columns + ix, seed);
+  const b = hash(iy * columns + (ix + 1) % columns, seed);
+  const c = hash((iy + 1) % rows * columns + ix, seed);
+  const d = hash((iy + 1) % rows * columns + (ix + 1) % columns, seed);
+  return ((a + (b - a) * sx) * (1 - sy) + (c + (d - c) * sx) * sy) * 2 - 1;
+}
+const woodRecipe = /* @__PURE__ */ pattern(
+  (options) => {
+    const seed = validateSeed(options.seed);
+    const knots = bounded("Wood knots", options.knots ?? 0, 0, 12, true);
+    return {
+      ...motion(options),
+      seed,
+      grain: bounded("Wood grain", options.grain ?? 32, 4, 128, true),
+      distortion: bounded("Wood distortion", options.distortion ?? 0.5, 0, 1),
+      roughness: bounded("Wood roughness", options.roughness ?? 0.4, 0, 1),
+      knotSize: bounded("Wood knotSize", options.knotSize ?? 0.09, 0.02, 0.18),
+      knots: Array.from({ length: knots }, (_, i) => ({
+        u: hash(i * 7 + 11, seed),
+        v: hash(i * 7 + 21, seed),
+        aspect: 1 + 0.9 * hash(i * 7 + 31, seed)
+      }))
+    };
+  },
+  (c, u, v, phase) => {
+    v = wrap(v + phase);
+    const broad = noise(u, v, 4, 4, c.seed);
+    const medium = noise(u, v, 8, 8, c.seed ^ 1367130551);
+    const fine = noise(u, v, 16, 16, c.seed ^ 1757159915);
+    let coordinate = u + c.distortion * (0.12 * broad + 0.045 * medium + 0.015 * fine);
+    for (const knot of c.knots) {
+      const dx = wrap(u - knot.u + 0.5) - 0.5;
+      const dy = wrap(v - knot.v + 0.5) - 0.5;
+      const radius = Math.hypot(dx, dy / knot.aspect) / (c.knotSize * 0.7);
+      if (radius >= 2) continue;
+      const outside = Math.max(1, radius);
+      const influence = Math.pow((4 - outside * outside) / 3, 2);
+      coordinate -= dx / (outside * outside) * influence;
+    }
+    const growth = 0.5 + 0.5 * Math.cos(tau * (coordinate * c.grain + c.roughness * fine * 0.2));
+    const fiber = Math.pow(
+      0.5 + 0.5 * Math.cos(tau * coordinate * c.grain * 3),
+      12
+    );
+    let value = 0.72 - 0.32 * Math.pow(growth, 7) + 0.055 * broad - c.roughness * (0.09 * fiber + 0.035 * fine);
+    for (const knot of c.knots) {
+      const dx = wrap(u - knot.u + 0.5) - 0.5;
+      const dy = wrap(v - knot.v + 0.5) - 0.5;
+      const radius = Math.hypot(dx, dy / knot.aspect) / (c.knotSize * 0.7);
+      if (radius >= 1) continue;
+      const edge = Math.min(1, Math.max(0, (radius - 0.85) / 0.15));
+      const blend = 1 - edge * edge * (3 - 2 * edge);
+      const ring = Math.pow(0.5 + 0.5 * Math.cos(tau * radius * 3), 5);
+      const knotValue = 0.55 - 0.23 * ring - 0.28 * Math.pow(Math.max(0, 1 - radius * 3), 2);
+      value += (knotValue - value) * blend;
+    }
+    return value;
+  }
+);
+function woodGrain(options = {}) {
+  return woodRecipe(options);
+}
+function fabricConfig(options) {
+  const threads = bounded(
+    "Fabric threads",
+    options.threads ?? 16,
+    8,
+    128,
+    true
+  );
+  if (threads % 8 !== 0)
+    throw new RangeError("Fabric threads must be a multiple of 8.");
+  return {
+    ...motion(options),
+    seed: validateSeed(options.seed),
+    threads,
+    threadWidth: bounded(
+      "Fabric threadWidth",
+      options.threadWidth ?? 0.8,
+      0.2,
+      1
+    ),
+    relief: bounded("Fabric relief", options.relief ?? 0.65, 0, 1),
+    fuzz: bounded("Fabric fuzz", options.fuzz ?? 0.2, 0, 1)
+  };
+}
+function fabricSample(c, u, v, warpOnTop) {
+  const x = u * c.threads, y = v * c.threads;
+  const warpFiber = noise(u, v, c.threads * 8, 16, c.seed);
+  const weftFiber = noise(u, v, 16, c.threads * 8, c.seed ^ 1757159915);
+  const warpRadius = c.threadWidth * (1 + c.fuzz * 0.14 * warpFiber);
+  const weftRadius = c.threadWidth * (1 + c.fuzz * 0.14 * weftFiber);
+  const acrossWarp = Math.abs(x % 1 - 0.5) * 2 / warpRadius;
+  const acrossWeft = Math.abs(y % 1 - 0.5) * 2 / weftRadius;
+  const softness = 0.1 + c.fuzz * 0.45;
+  const coverage = (across) => {
+    const t = Math.max(
+      0,
+      Math.min(1, (across - (1 - softness)) / (2 * softness))
+    );
+    return 1 - t * t * (3 - 2 * t);
+  };
+  const warp = coverage(acrossWarp), weft = coverage(acrossWeft);
+  const warpCrown = Math.sqrt(Math.max(0, 1 - acrossWarp * acrossWarp));
+  const weftCrown = Math.sqrt(Math.max(0, 1 - acrossWeft * acrossWeft));
+  const warpValue = 0.62 + c.relief * (0.14 * warpCrown - 0.07) + c.fuzz * 0.15 * warpFiber;
+  const weftValue = 0.43 + c.relief * (0.14 * weftCrown - 0.07) + c.fuzz * 0.15 * weftFiber;
+  const gap = 0.18;
+  return warpOnTop ? warpValue * warp + (weftValue * weft + gap * (1 - weft)) * (1 - warp) : weftValue * weft + (warpValue * warp + gap * (1 - warp)) * (1 - weft);
+}
+const plainWeaveRecipe = /* @__PURE__ */ pattern(
+  fabricConfig,
+  (c, u, v, phase) => {
+    v = wrap(v + phase);
+    const x = Math.floor(u * c.threads), y = Math.floor(v * c.threads);
+    return fabricSample(c, u, v, (x + y) % 2 === 0);
+  }
+);
+const twillRecipe = /* @__PURE__ */ pattern(fabricConfig, (c, u, v, phase) => {
+  v = wrap(v + phase);
+  const x = Math.floor(u * c.threads), y = Math.floor(v * c.threads);
+  return fabricSample(c, u, v, ((x - y) % 4 + 4) % 4 < 2);
+});
+const herringboneHarnesses = [0, 1, 2, 3, 1, 0, 3, 2];
+const herringboneRecipe = /* @__PURE__ */ pattern(
+  fabricConfig,
+  (c, u, v, phase) => {
+    v = wrap(v + phase);
+    const x = Math.floor(u * c.threads) % 8, y = Math.floor(v * c.threads);
+    const harness = herringboneHarnesses[x];
+    return fabricSample(c, u, v, (harness + y) % 4 >= 2);
+  }
+);
+function plainWeave(options = {}) {
+  return plainWeaveRecipe(options);
+}
+function twill(options = {}) {
+  return twillRecipe(options);
+}
+function herringbone(options = {}) {
+  return herringboneRecipe(options);
+}
+function noiseConfig(options) {
+  return {
+    ...motion(options),
+    seed: validateSeed(options.seed),
+    frequency: bounded("Noise frequency", options.frequency ?? 4, 1, 16, true),
+    octaves: bounded("Noise octaves", options.octaves ?? 4, 1, 6, true),
+    persistence: bounded("Noise persistence", options.persistence ?? 0.5, 0, 1),
+    contrast: bounded("Noise contrast", options.contrast ?? 1, 0, 4)
+  };
+}
+function layeredNoise(c, u, v, ridge) {
+  let sum = 0, weight = 0, amplitude = 1, frequency = c.frequency;
+  for (let i = 0; i < c.octaves; i++) {
+    const sample = noise(
+      u,
+      v,
+      frequency,
+      frequency,
+      c.seed ^ Math.imul(i, 1367130551)
+    );
+    sum += (ridge ? 1 - Math.abs(sample) : 0.5 + sample * 0.5) * amplitude;
+    weight += amplitude;
+    amplitude *= c.persistence;
+    frequency *= 2;
+  }
+  return 0.5 + (sum / weight - 0.5) * c.contrast;
+}
+const softNoiseRecipe = /* @__PURE__ */ pattern(
+  noiseConfig,
+  (c, u, v, phase) => layeredNoise(c, u, wrap(v + phase), false)
+);
+const ridgedNoiseRecipe = /* @__PURE__ */ pattern(
+  noiseConfig,
+  (c, u, v, phase) => layeredNoise(c, u, wrap(v + phase), true)
+);
+function softNoise(options = {}) {
+  return softNoiseRecipe(options);
+}
+function ridgedNoise(options = {}) {
+  return ridgedNoiseRecipe(options);
+}
+export {
+  checkers,
+  herringbone,
+  plainWeave,
+  ridgedNoise,
+  softNoise,
+  stripes,
+  twill,
+  woodGrain
+};
+//# sourceMappingURL=patterns.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/patterns.ts"],
+  "sourcesContent": ["import {\n  defineTexture,\n  type TextureContext,\n  type TextureRecipe,\n} from \"@pibbl/core\";\nimport { paletteLut, texturePalettes, validateSeed } from \"./palette.js\";\n\n/** Shared periodic motion controls for geometric and fiber recipes. @see {@link stripes} */\nexport interface PatternMotionOptions {\n  /** Initial phase in cycles; any finite value wraps. See {@link PatternMotionOptions}. */\n  readonly phase?: number;\n  /** Nonnegative cycles per second, up to 20; zero idles. See {@link PatternMotionOptions}. */\n  readonly speed?: number;\n}\n/** Controls for periodic stripes; rotate the repeat lattice through paint placement. @see {@link stripes} */\nexport interface StripesOptions extends PatternMotionOptions {\n  /** Integer stripe periods across the tile, 1\u201364; default 8. See {@link StripesOptions}. */\n  readonly bands?: number;\n  /** Foreground fraction of each period, 0\u20131; default 0.5. See {@link StripesOptions}. */\n  readonly dutyCycle?: number;\n  /** Horizontal wave amplitude in tile fractions, 0\u20131; default 0. See {@link StripesOptions}. */\n  readonly wave?: number;\n  /** Integer wave periods down the tile, 1\u201316; default 1. See {@link StripesOptions}. */\n  readonly waveCycles?: number;\n}\n/** Controls for a two-color checkerboard. @see {@link checkers} */\nexport interface CheckersOptions extends PatternMotionOptions {\n  /** Even integer columns, 2\u201364; default 8. See {@link CheckersOptions}. */\n  readonly columns?: number;\n  /** Even integer rows, 2\u201364; default 8. See {@link CheckersOptions}. */\n  readonly rows?: number;\n}\n/** Controls for seeded seamless wood grain with optional knots. @see {@link woodGrain} */\nexport interface WoodGrainOptions extends PatternMotionOptions {\n  /** Unsigned 32-bit variation seed; default 42. See {@link WoodGrainOptions}. */\n  readonly seed?: number;\n  /** Integer grain periods across the tile, 4\u2013128; default 32. See {@link WoodGrainOptions}. */\n  readonly grain?: number;\n  /** Irregular grain bending, 0\u20131; default 0.5. See {@link WoodGrainOptions}. */\n  readonly distortion?: number;\n  /** Fine fiber and pore variation, 0\u20131; default 0.4. See {@link WoodGrainOptions}. */\n  readonly roughness?: number;\n  /** Integer knot count, 0\u201312; default 0 for clear grain. See {@link WoodGrainOptions}. */\n  readonly knots?: number;\n  /** Knot radius in tile fractions, 0.02\u20130.18; default 0.09. See {@link WoodGrainOptions}. */\n  readonly knotSize?: number;\n}\nconst tau = Math.PI * 2;\nfunction wrap(value: number) {\n  return ((value % 1) + 1) % 1;\n}\nfunction bounded(\n  name: string,\n  value: number,\n  min: number,\n  max: number,\n  integer = false,\n) {\n  if (\n    !Number.isFinite(value) ||\n    value < min ||\n    value > max ||\n    (integer && !Number.isInteger(value))\n  )\n    throw new RangeError(\n      `${name} must be ${integer ? \"an integer \" : \"\"}in [${min}, ${max}].`,\n    );\n  return value;\n}\nfunction motion(options: PatternMotionOptions) {\n  const phase = options.phase ?? 0;\n  if (!Number.isFinite(phase))\n    throw new RangeError(\"Texture phase must be finite.\");\n  return {\n    phase: wrap(phase),\n    speed: bounded(\"Texture speed\", options.speed ?? 0, 0, 20),\n  };\n}\ntype Motion = ReturnType<typeof motion>;\ninterface PatternState<Config> {\n  config: Config;\n  phase: number;\n  fresh: boolean;\n  fieldDirty: boolean;\n  field: Float32Array;\n  image: ImageData | undefined;\n  paletteKey?: string;\n  lut?: Uint8ClampedArray;\n}\n// Shared lifecycle only. Each public factory has its own configuration and one\n// fixed return contract. Sampling and recoloring reuse bounded buffers.\nfunction pattern<Options, Config extends Motion>(\n  validate: (options: Options) => Config,\n  sample: (config: Config, u: number, v: number, phase: number) => number,\n) {\n  const definition = defineTexture<Config, PatternState<Config>>({\n    create(context, config) {\n      const { width, height } = context.canvas;\n      if (config.speed > 0) context.requestFrame();\n      return {\n        config,\n        phase: config.phase,\n        fresh: true,\n        fieldDirty: true,\n        field: new Float32Array(width * height),\n        image: new ImageData(width, height),\n      };\n    },\n    update(state, config, context) {\n      if (JSON.stringify(config) === JSON.stringify(state.config)) return;\n      if (config.phase !== state.config.phase) state.phase = config.phase;\n      if (config.speed !== state.config.speed) state.fresh = true;\n      state.config = config;\n      state.fieldDirty = true;\n      context.invalidate();\n      if (config.speed > 0) context.requestFrame();\n    },\n    advance(state, frame, context) {\n      if (state.config.speed === 0) return;\n      if (!state.fresh && frame.delta > 0) {\n        state.phase = wrap(\n          state.phase + (frame.delta * state.config.speed) / 1000,\n        );\n        state.fieldDirty = true;\n        context.invalidate();\n      }\n      state.fresh = false;\n      context.requestFrame();\n    },\n    rasterize(state, context: TextureContext) {\n      const { width, height } = context.canvas;\n      if (state.fieldDirty) {\n        for (let y = 0; y < height; y++)\n          for (let x = 0; x < width; x++)\n            state.field[y * width + x] = sample(\n              state.config,\n              x === width - 1 ? 0 : x / (width - 1),\n              y === height - 1 ? 0 : y / (height - 1),\n              state.phase,\n            );\n        state.fieldDirty = false;\n      }\n      const palette = context.palette ?? texturePalettes.porcelain;\n      const key = palette.join();\n      if (key !== state.paletteKey) {\n        state.lut = paletteLut(palette);\n        state.paletteKey = key;\n      }\n      const image = state.image!;\n      const data = image.data,\n        lut = state.lut!;\n      for (let i = 0; i < state.field.length; i++) {\n        const index =\n          Math.round(Math.max(0, Math.min(1, state.field[i])) * 255) * 4;\n        data[i * 4] = lut[index];\n        data[i * 4 + 1] = lut[index + 1];\n        data[i * 4 + 2] = lut[index + 2];\n        data[i * 4 + 3] = 255;\n      }\n      context.canvas.getContext(\"2d\")!.putImageData(image, 0, 0);\n    },\n    dispose(state) {\n      state.field = new Float32Array(0);\n      state.image = undefined;\n      state.lut = undefined;\n    },\n  });\n  return (options: Options): TextureRecipe => definition(validate(options));\n}\nconst stripeRecipe = /* @__PURE__ */ pattern(\n  (options: StripesOptions) => ({\n    ...motion(options),\n    bands: bounded(\"Stripe bands\", options.bands ?? 8, 1, 64, true),\n    dutyCycle: bounded(\"Stripe dutyCycle\", options.dutyCycle ?? 0.5, 0, 1),\n    wave: bounded(\"Stripe wave\", options.wave ?? 0, 0, 1),\n    waveCycles: bounded(\n      \"Stripe waveCycles\",\n      options.waveCycles ?? 1,\n      1,\n      16,\n      true,\n    ),\n  }),\n  (c, u, v, phase) =>\n    wrap(\n      (u + c.wave * Math.sin(tau * (v * c.waveCycles + phase))) * c.bands +\n        phase,\n    ) < c.dutyCycle\n      ? 1\n      : 0,\n);\n\n/**\n * Creates seamless straight or wavy stripes using the palette endpoints.\n * @param options - Stripe geometry and periodic motion. See {@link StripesOptions}.\n * @returns A mountable texture recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link StripesOptions}\n */\nexport function stripes(options: StripesOptions = {}): TextureRecipe {\n  return stripeRecipe(options);\n}\nconst checkerRecipe = /* @__PURE__ */ pattern(\n  (options: CheckersOptions) => {\n    const columns = bounded(\n      \"Checker columns\",\n      options.columns ?? 8,\n      2,\n      64,\n      true,\n    );\n    const rows = bounded(\"Checker rows\", options.rows ?? 8, 2, 64, true);\n    if (columns % 2 || rows % 2)\n      throw new RangeError(\n        \"Checker rows and columns must be even for seamless alternation.\",\n      );\n    return { ...motion(options), columns, rows };\n  },\n  (c, u, v, phase) =>\n    (Math.floor(wrap(u + phase) * c.columns) + Math.floor(v * c.rows)) % 2,\n);\n/**\n * Creates a seamless checkerboard using the palette endpoints.\n * @param options - Even row/column counts and periodic motion. See {@link CheckersOptions}.\n * @returns A mountable texture recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link CheckersOptions}\n */\nexport function checkers(options: CheckersOptions = {}): TextureRecipe {\n  return checkerRecipe(options);\n}\nfunction hash(index: number, seed: number) {\n  let value = Math.imul(index ^ seed, 0x45d9f3b);\n  value = Math.imul(value ^ (value >>> 16), 0x45d9f3b);\n  return ((value ^ (value >>> 16)) >>> 0) / 0xffffffff;\n}\n// Seeded lattice noise wraps both axes. Several scales bend the growth lines\n// independently, avoiding the uniform sine-wave paths of the original study.\nfunction noise(\n  u: number,\n  v: number,\n  columns: number,\n  rows: number,\n  seed: number,\n) {\n  const x = wrap(u) * columns,\n    y = wrap(v) * rows;\n  const ix = Math.floor(x),\n    iy = Math.floor(y);\n  const fx = x - ix,\n    fy = y - iy;\n  const sx = fx * fx * fx * (fx * (fx * 6 - 15) + 10);\n  const sy = fy * fy * fy * (fy * (fy * 6 - 15) + 10);\n  const a = hash(iy * columns + ix, seed);\n  const b = hash(iy * columns + ((ix + 1) % columns), seed);\n  const c = hash(((iy + 1) % rows) * columns + ix, seed);\n  const d = hash(((iy + 1) % rows) * columns + ((ix + 1) % columns), seed);\n  return ((a + (b - a) * sx) * (1 - sy) + (c + (d - c) * sx) * sy) * 2 - 1;\n}\nconst woodRecipe = /* @__PURE__ */ pattern(\n  (options: WoodGrainOptions) => {\n    const seed = validateSeed(options.seed);\n    const knots = bounded(\"Wood knots\", options.knots ?? 0, 0, 12, true);\n    return {\n      ...motion(options),\n      seed,\n      grain: bounded(\"Wood grain\", options.grain ?? 32, 4, 128, true),\n      distortion: bounded(\"Wood distortion\", options.distortion ?? 0.5, 0, 1),\n      roughness: bounded(\"Wood roughness\", options.roughness ?? 0.4, 0, 1),\n      knotSize: bounded(\"Wood knotSize\", options.knotSize ?? 0.09, 0.02, 0.18),\n      knots: Array.from({ length: knots }, (_, i) => ({\n        u: hash(i * 7 + 11, seed),\n        v: hash(i * 7 + 21, seed),\n        aspect: 1 + 0.9 * hash(i * 7 + 31, seed),\n      })),\n    };\n  },\n  (c, u, v, phase) => {\n    v = wrap(v + phase);\n    const broad = noise(u, v, 4, 4, c.seed);\n    const medium = noise(u, v, 8, 8, c.seed ^ 0x517cc1b7);\n    const fine = noise(u, v, 16, 16, c.seed ^ 0x68bc21eb);\n    let coordinate =\n      u + c.distortion * (0.12 * broad + 0.045 * medium + 0.015 * fine);\n    // Shortest periodic offsets let a knot crossing a tile boundary continue\n    // in its neighboring copy. Compact support vanishes before antipodal points.\n    for (const knot of c.knots) {\n      const dx = wrap(u - knot.u + 0.5) - 0.5;\n      const dy = wrap(v - knot.v + 0.5) - 0.5;\n      const radius = Math.hypot(dx, dy / knot.aspect) / (c.knotSize * 0.7);\n      if (radius >= 2) continue;\n      // Inverse stream coordinate around an elliptical obstacle: subtracting\n      // this displacement makes equal-growth contours bow away from the core.\n      // At radius 1 the center streamline follows the knot boundary; the\n      // compact taper restores undisturbed grain at radius 2.\n      const outside = Math.max(1, radius);\n      const influence = Math.pow((4 - outside * outside) / 3, 2);\n      coordinate -= (dx / (outside * outside)) * influence;\n    }\n    const growth =\n      0.5 +\n      0.5 * Math.cos(tau * (coordinate * c.grain + c.roughness * fine * 0.2));\n    const fiber = Math.pow(\n      0.5 + 0.5 * Math.cos(tau * coordinate * c.grain * 3),\n      12,\n    );\n    let value =\n      0.72 -\n      0.32 * Math.pow(growth, 7) +\n      0.055 * broad -\n      c.roughness * (0.09 * fiber + 0.035 * fine);\n    for (const knot of c.knots) {\n      const dx = wrap(u - knot.u + 0.5) - 0.5;\n      const dy = wrap(v - knot.v + 0.5) - 0.5;\n      const radius = Math.hypot(dx, dy / knot.aspect) / (c.knotSize * 0.7);\n      if (radius >= 1) continue;\n      const edge = Math.min(1, Math.max(0, (radius - 0.85) / 0.15));\n      const blend = 1 - edge * edge * (3 - 2 * edge);\n      const ring = Math.pow(0.5 + 0.5 * Math.cos(tau * radius * 3), 5);\n      const knotValue =\n        0.55 - 0.23 * ring - 0.28 * Math.pow(Math.max(0, 1 - radius * 3), 2);\n      value += (knotValue - value) * blend;\n    }\n    return value;\n  },\n);\n/**\n * Creates seamless seeded wood with irregular grain, fine fibers, and optional knots.\n * @param options - Grain frequency, distortion, roughness, knots, seed, and motion. See {@link WoodGrainOptions}.\n * @returns A mountable texture recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link WoodGrainOptions}\n */\nexport function woodGrain(options: WoodGrainOptions = {}): TextureRecipe {\n  return woodRecipe(options);\n}\n\n/** Shared thread geometry and shading for seamless woven fabrics. @see {@link plainWeave} */\nexport interface FabricOptions extends PatternMotionOptions {\n  /** Unsigned 32-bit fiber variation seed; default 42. See {@link FabricOptions}. */\n  readonly seed?: number;\n  /** Thread count on each axis, a multiple of 8 in 8\u2013128; default 16. See {@link FabricOptions}. */\n  readonly threads?: number;\n  /** Thread width as a fraction of cell spacing, 0.2\u20131; default 0.8. See {@link FabricOptions}. */\n  readonly threadWidth?: number;\n  /** Rounded thread lighting strength, 0\u20131; default 0.65. See {@link FabricOptions}. */\n  readonly relief?: number;\n  /** Seeded directional fibers and soft, uneven yarn edges, 0\u20131; default 0.2. See {@link FabricOptions}. */\n  readonly fuzz?: number;\n}\nfunction fabricConfig(options: FabricOptions) {\n  const threads = bounded(\n    \"Fabric threads\",\n    options.threads ?? 16,\n    8,\n    128,\n    true,\n  );\n  if (threads % 8 !== 0)\n    throw new RangeError(\"Fabric threads must be a multiple of 8.\");\n  return {\n    ...motion(options),\n    seed: validateSeed(options.seed),\n    threads,\n    threadWidth: bounded(\n      \"Fabric threadWidth\",\n      options.threadWidth ?? 0.8,\n      0.2,\n      1,\n    ),\n    relief: bounded(\"Fabric relief\", options.relief ?? 0.65, 0, 1),\n    fuzz: bounded(\"Fabric fuzz\", options.fuzz ?? 0.2, 0, 1),\n  };\n}\ntype FabricConfig = ReturnType<typeof fabricConfig>;\nfunction fabricSample(\n  c: FabricConfig,\n  u: number,\n  v: number,\n  warpOnTop: boolean,\n) {\n  const x = u * c.threads,\n    y = v * c.threads;\n  const warpFiber = noise(u, v, c.threads * 8, 16, c.seed);\n  const weftFiber = noise(u, v, 16, c.threads * 8, c.seed ^ 0x68bc21eb);\n  // Spun yarn has uneven edges and a soft fiber envelope. Coverage, rather\n  // than a binary inside/outside test, keeps enlarged yarn from looking cut out.\n  const warpRadius = c.threadWidth * (1 + c.fuzz * 0.14 * warpFiber);\n  const weftRadius = c.threadWidth * (1 + c.fuzz * 0.14 * weftFiber);\n  const acrossWarp = (Math.abs((x % 1) - 0.5) * 2) / warpRadius;\n  const acrossWeft = (Math.abs((y % 1) - 0.5) * 2) / weftRadius;\n  const softness = 0.1 + c.fuzz * 0.45;\n  const coverage = (across: number) => {\n    const t = Math.max(\n      0,\n      Math.min(1, (across - (1 - softness)) / (2 * softness)),\n    );\n    return 1 - t * t * (3 - 2 * t);\n  };\n  const warp = coverage(acrossWarp),\n    weft = coverage(acrossWeft);\n  const warpCrown = Math.sqrt(Math.max(0, 1 - acrossWarp * acrossWarp));\n  const weftCrown = Math.sqrt(Math.max(0, 1 - acrossWeft * acrossWeft));\n  const warpValue =\n    0.62 + c.relief * (0.14 * warpCrown - 0.07) + c.fuzz * 0.15 * warpFiber;\n  const weftValue =\n    0.43 + c.relief * (0.14 * weftCrown - 0.07) + c.fuzz * 0.15 * weftFiber;\n  const gap = 0.18;\n  // The drawdown determines occlusion at crossings. A yarn stays continuous\n  // along a float; no per-cell bevel or repeated shadow chops it into blocks.\n  return warpOnTop\n    ? warpValue * warp + (weftValue * weft + gap * (1 - weft)) * (1 - warp)\n    : weftValue * weft + (warpValue * warp + gap * (1 - warp)) * (1 - weft);\n}\nconst plainWeaveRecipe = /* @__PURE__ */ pattern(\n  fabricConfig,\n  (c, u, v, phase) => {\n    v = wrap(v + phase);\n    const x = Math.floor(u * c.threads),\n      y = Math.floor(v * c.threads);\n    return fabricSample(c, u, v, (x + y) % 2 === 0);\n  },\n);\nconst twillRecipe = /* @__PURE__ */ pattern(fabricConfig, (c, u, v, phase) => {\n  v = wrap(v + phase);\n  const x = Math.floor(u * c.threads),\n    y = Math.floor(v * c.threads);\n  return fabricSample(c, u, v, (((x - y) % 4) + 4) % 4 < 2);\n});\nconst herringboneHarnesses = [0, 1, 2, 3, 1, 0, 3, 2] as const;\nconst herringboneRecipe = /* @__PURE__ */ pattern(\n  fabricConfig,\n  (c, u, v, phase) => {\n    v = wrap(v + phase);\n    const x = Math.floor(u * c.threads) % 8,\n      y = Math.floor(v * c.threads);\n    // CottonWorks Weaving 101, p. 23: harness sequence 1,2,3,4,2,1,4,3.\n    // The offset at each reversal breaks the diagonal instead of duplicating\n    // the turning end, which would produce a pointed/chevron-like twill.\n    const harness = herringboneHarnesses[x];\n    return fabricSample(c, u, v, (harness + y) % 4 >= 2);\n  },\n);\n/**\n * Creates an alternating over-under plain weave with rounded threads and seeded fibers.\n * @param options - Thread geometry, shading, seed, and motion. See {@link FabricOptions}.\n * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link FabricOptions}\n */\nexport function plainWeave(options: FabricOptions = {}): TextureRecipe {\n  return plainWeaveRecipe(options);\n}\n/**\n * Creates a two-over, two-under diagonal twill fabric.\n * @param options - Thread geometry, shading, seed, and motion. See {@link FabricOptions}.\n * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link FabricOptions}\n */\nexport function twill(options: FabricOptions = {}): TextureRecipe {\n  return twillRecipe(options);\n}\n/**\n * Creates a reversing twill fabric with repeating herringbone chevrons.\n * @param options - Thread geometry, shading, seed, and motion. See {@link FabricOptions}.\n * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link FabricOptions}\n */\nexport function herringbone(options: FabricOptions = {}): TextureRecipe {\n  return herringboneRecipe(options);\n}\n\n/** Seeded seamless noise layers and their tonal response. @see {@link softNoise} */\nexport interface NoiseOptions extends PatternMotionOptions {\n  /** Unsigned 32-bit noise seed; default 42. See {@link NoiseOptions}. */\n  readonly seed?: number;\n  /** Integer base lattice periods per axis, 1\u201316; default 4. See {@link NoiseOptions}. */\n  readonly frequency?: number;\n  /** Number of doubled-frequency layers, integer 1\u20136; default 4. See {@link NoiseOptions}. */\n  readonly octaves?: number;\n  /** Relative amplitude of each successive layer, 0\u20131; default 0.5. See {@link NoiseOptions}. */\n  readonly persistence?: number;\n  /** Tonal contrast about the midpoint, 0\u20134; default 1. See {@link NoiseOptions}. */\n  readonly contrast?: number;\n}\nfunction noiseConfig(options: NoiseOptions) {\n  return {\n    ...motion(options),\n    seed: validateSeed(options.seed),\n    frequency: bounded(\"Noise frequency\", options.frequency ?? 4, 1, 16, true),\n    octaves: bounded(\"Noise octaves\", options.octaves ?? 4, 1, 6, true),\n    persistence: bounded(\"Noise persistence\", options.persistence ?? 0.5, 0, 1),\n    contrast: bounded(\"Noise contrast\", options.contrast ?? 1, 0, 4),\n  };\n}\nfunction layeredNoise(\n  c: ReturnType<typeof noiseConfig>,\n  u: number,\n  v: number,\n  ridge: boolean,\n) {\n  let sum = 0,\n    weight = 0,\n    amplitude = 1,\n    frequency = c.frequency;\n  for (let i = 0; i < c.octaves; i++) {\n    const sample = noise(\n      u,\n      v,\n      frequency,\n      frequency,\n      c.seed ^ Math.imul(i, 0x517cc1b7),\n    );\n    sum += (ridge ? 1 - Math.abs(sample) : 0.5 + sample * 0.5) * amplitude;\n    weight += amplitude;\n    amplitude *= c.persistence;\n    frequency *= 2;\n  }\n  return 0.5 + (sum / weight - 0.5) * c.contrast;\n}\nconst softNoiseRecipe = /* @__PURE__ */ pattern(noiseConfig, (c, u, v, phase) =>\n  layeredNoise(c, u, wrap(v + phase), false),\n);\nconst ridgedNoiseRecipe = /* @__PURE__ */ pattern(\n  noiseConfig,\n  (c, u, v, phase) => layeredNoise(c, u, wrap(v + phase), true),\n);\n/**\n * Creates smooth seamless multiscale lattice noise for clouds, pigment, and material variation.\n * @param options - Seed, lattice frequencies, amplitudes, contrast, and motion. See {@link NoiseOptions}.\n * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link NoiseOptions}\n */\nexport function softNoise(options: NoiseOptions = {}): TextureRecipe {\n  return softNoiseRecipe(options);\n}\n/**\n * Creates seamless multiscale ridges by folding each noise layer around its midpoint.\n * @param options - Seed, lattice frequencies, amplitudes, contrast, and motion. See {@link NoiseOptions}.\n * @returns A mountable recipe with no message commands. See {@link TextureRecipe}.\n * @see {@link NoiseOptions}\n */\nexport function ridgedNoise(options: NoiseOptions = {}): TextureRecipe {\n  return ridgedNoiseRecipe(options);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/textures/lib/rain-drops.js

@@ -221,7 +221,8 @@ const recipe = defineTexture({
       const x = bounded(message.x, "nudge x", 1), y = bounded(message.y, "nudge y", 1);
       const radius = bounded(message.radius ?? 0.12, "nudge radius", 2);
       if (radius === 0) throw new RangeError("Rain nudge radius must be positive.");
-      for (const delta of [message.dx, message.dy]) if (!Number.isFinite(delta) || Math.abs(delta) > 1) throw new RangeError("Rain nudge movement must be finite and within [-1, 1].");
+      if (!Number.isFinite(message.dx) || Math.abs(message.dx) > 1 || !Number.isFinite(message.dy) || Math.abs(message.dy) > 1)
+        throw new RangeError("Rain nudge movement must be finite and within [-1, 1].");
       if (message.dx === 0 && message.dy === 0) return;
       const side = Math.min(context.canvas.width, context.canvas.height);
       const width = context.canvas.width / side, height = context.canvas.height / side;