@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

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

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

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

@@ -0,0 +1,305 @@
+import { defineTexture } from "@pibbl/core";
+import { paletteLut, texturePalettes, validateSeed } from "./palette.js";
+const tau = 2 * Math.PI;
+const wrap = (n) => (n % 1 + 1) % 1;
+function bound(name, n, min, max, integer = false) {
+  if (!Number.isFinite(n) || n < min || n > max || integer && !Number.isInteger(n))
+    throw new RangeError(
+      `${name} must be ${integer ? "an integer" : "finite"} in ${min}\u2013${max}.`
+    );
+  return n;
+}
+function motion(o) {
+  return {
+    phase: wrap(
+      bound("phase", o.phase ?? 0, -Number.MAX_VALUE, Number.MAX_VALUE)
+    ),
+    speed: bound("speed", o.speed ?? 0, 0, 20)
+  };
+}
+function grid(o, defaults, even = false) {
+  const columns = bound("columns", o.columns ?? defaults, 1, 64, true), rows = bound("rows", o.rows ?? defaults, even ? 2 : 1, 64, true);
+  if (even && rows % 2)
+    throw new RangeError("rows must be even for seamless stagger.");
+  return { columns, rows };
+}
+function hash(x, y, columns, rows, seed) {
+  const ix = (x % columns + columns) % columns, iy = (y % rows + rows) % rows;
+  let h = Math.imul(iy * columns + ix ^ seed, 73244475);
+  h = Math.imul(h ^ h >>> 16, 73244475);
+  return ((h ^ h >>> 16) >>> 0) / 4294967296;
+}
+function coverage(distance, halfWidth, pixel) {
+  if (halfWidth === 0) return 0;
+  const t = Math.max(0, Math.min(1, (halfWidth - distance) / pixel + 0.5));
+  return t * t * (3 - 2 * t);
+}
+function geometry(validate, sample, named = false) {
+  const definition = defineTexture({
+    create(context, config) {
+      if (config.speed) context.requestFrame();
+      return {
+        config,
+        phase: config.phase,
+        fresh: true,
+        dirty: true,
+        image: new ImageData(context.canvas.width, context.canvas.height),
+        paletteKey: "",
+        lut: void 0
+      };
+    },
+    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.dirty = true;
+      context.invalidate();
+      if (config.speed) context.requestFrame();
+    },
+    advance(state, frame, context) {
+      if (!state.config.speed) return;
+      if (!state.fresh && frame.delta > 0) {
+        state.phase = wrap(
+          state.phase + frame.delta * state.config.speed / 1e3
+        );
+        state.dirty = true;
+        context.invalidate();
+      }
+      state.fresh = false;
+      context.requestFrame();
+    },
+    rasterize(state, context) {
+      if (named && context.palette !== void 0)
+        throw new TypeError(
+          "plaid uses its named colors dictionary; omit useTexture palette."
+        );
+      const palette = context.palette ?? texturePalettes.porcelain, key = palette.join();
+      if (!named && key !== state.paletteKey) {
+        state.lut = paletteLut(palette);
+        state.paletteKey = key;
+        state.dirty = true;
+      }
+      if (!state.dirty) return;
+      const { width, height } = context.canvas, data = state.image.data;
+      for (let y = 0; y < height; y++)
+        for (let x = 0; x < width; x++) {
+          const result = sample(
+            state.config,
+            x === width - 1 ? 0 : x / (width - 1),
+            y === height - 1 ? 0 : y / (height - 1),
+            state.phase,
+            1 / (width - 1),
+            1 / (height - 1)
+          ), index = (y * width + x) * 4;
+          if (typeof result === "number") {
+            const at = Math.round(Math.max(0, Math.min(1, result)) * 255) * 4;
+            data[index] = state.lut[at];
+            data[index + 1] = state.lut[at + 1];
+            data[index + 2] = state.lut[at + 2];
+          } else {
+            data[index] = result[0];
+            data[index + 1] = result[1];
+            data[index + 2] = result[2];
+          }
+          data[index + 3] = 255;
+        }
+      context.canvas.getContext("2d").putImageData(state.image, 0, 0);
+      state.dirty = false;
+    },
+    dispose(state) {
+      state.image = void 0;
+      state.lut = void 0;
+    }
+  });
+  return (o) => definition(validate(o));
+}
+function dots(c, u, v, radius, px, py) {
+  const x = u * c.columns, y = v * c.rows, pixel = Math.max(px * c.columns, py * c.rows);
+  let amount = 0;
+  for (let j = Math.floor(y) - 1; j <= Math.floor(y) + 1; j++)
+    for (let i = Math.floor(x) - 2; i <= Math.floor(x) + 1; i++) {
+      const row = (j % c.rows + c.rows) % c.rows;
+      const cx = i + 0.5 + row % 2 * c.stagger + (hash(i, j, c.columns, c.rows, c.seed) - 0.5) * 2 * c.jitter;
+      const cy = j + 0.5 + (hash(i, j, c.columns, c.rows, c.seed ^ 6574) - 0.5) * 2 * c.jitter;
+      amount = Math.max(
+        amount,
+        coverage(Math.hypot(x - cx, y - cy), radius(i, j), pixel)
+      );
+    }
+  return amount;
+}
+const dotRecipe = geometry(
+  (o) => ({
+    ...motion(o),
+    ...grid(o, 12, true),
+    radius: bound("radius", o.radius ?? 0.3, 0, 0.5),
+    stagger: bound("stagger", o.stagger ?? 0, 0, 1),
+    jitter: bound("jitter", o.jitter ?? 0, 0, 0.5),
+    seed: validateSeed(o.seed ?? 42)
+  }),
+  (c, u, v, p, px, py) => dots(c, wrap(u + p), v, () => c.radius, px, py)
+);
+function polkaDots(options = {}) {
+  return dotRecipe(options);
+}
+const halftoneRecipe = geometry(
+  (o) => {
+    const minRadius = bound("minRadius", o.minRadius ?? 0.05, 0, 0.5), maxRadius = bound("maxRadius", o.maxRadius ?? 0.45, minRadius, 0.5);
+    return {
+      ...motion(o),
+      ...grid(o, 24, true),
+      minRadius,
+      maxRadius,
+      cyclesX: bound("cyclesX", o.cyclesX ?? 1, 0, 16, true),
+      cyclesY: bound("cyclesY", o.cyclesY ?? 1, 0, 16, true),
+      contrast: bound("contrast", o.contrast ?? 0.7, 0, 1),
+      stagger: bound("stagger", o.stagger ?? 0.5, 0, 1),
+      jitter: 0,
+      seed: 42
+    };
+  },
+  (c, u, v, p, px, py) => dots(
+    c,
+    u,
+    v,
+    (x, y) => {
+      const tone = 0.5 + 0.25 * c.contrast * (Math.sin(tau * ((x + 0.5) / c.columns * c.cyclesX + p)) + Math.sin(tau * ((y + 0.5) / c.rows * c.cyclesY + p)));
+      return c.minRadius + (c.maxRadius - c.minRadius) * tone;
+    },
+    px,
+    py
+  )
+);
+function halftone(options = {}) {
+  return halftoneRecipe(options);
+}
+const truchetRecipe = geometry(
+  (o) => ({
+    ...motion(o),
+    ...grid(o, 8),
+    lineWidth: bound("lineWidth", o.lineWidth ?? 0.12, 0, 0.5),
+    orientationBias: bound("orientationBias", o.orientationBias ?? 0.5, 0, 1),
+    seed: validateSeed(o.seed ?? 42)
+  }),
+  (c, u, v, p, px, py) => {
+    const x = wrap(u + p) * c.columns, y = wrap(v + p) * c.rows, ix = Math.floor(x), iy = Math.floor(y), a = x - ix, b = y - iy;
+    const first = hash(ix, iy, c.columns, c.rows, c.seed) < c.orientationBias;
+    const distance = first ? Math.min(
+      Math.abs(Math.hypot(a, b) - 0.5),
+      Math.abs(Math.hypot(1 - a, 1 - b) - 0.5)
+    ) : Math.min(
+      Math.abs(Math.hypot(1 - a, b) - 0.5),
+      Math.abs(Math.hypot(a, 1 - b) - 0.5)
+    );
+    return coverage(
+      distance,
+      c.lineWidth / 2,
+      Math.max(px * c.columns, py * c.rows)
+    );
+  }
+);
+function truchet(options = {}) {
+  return truchetRecipe(options);
+}
+function bands(input, colors) {
+  if (!Array.isArray(input) || input.length < 1 || input.length > 32)
+    throw new RangeError("Plaid requires 1\u201332 bands per axis.");
+  const total = input.reduce(
+    (n, b) => n + bound("band width", b.width, Number.MIN_VALUE, 1e6),
+    0
+  );
+  let end = 0;
+  return input.map((b) => {
+    if (!Object.hasOwn(colors, b.color))
+      throw new TypeError(`Unknown plaid color key: ${b.color}`);
+    end += b.width / total;
+    return { end, color: colors[b.color] };
+  });
+}
+function bandColor(bands2, position, footprint) {
+  const center = wrap(position), lo = center - footprint / 2, hi = center + footprint / 2, result = [0, 0, 0];
+  for (let shift = -1; shift <= 1; shift++) {
+    let start = shift;
+    for (const band of bands2) {
+      const end = shift + band.end, weight = Math.max(0, Math.min(hi, end) - Math.max(lo, start)) / footprint;
+      for (let k = 0; k < 3; k++) result[k] += band.color[k] * weight;
+      start = end;
+    }
+  }
+  return result;
+}
+const plaidRecipe = geometry(
+  (o) => {
+    const entries = Object.entries(o.colors);
+    if (entries.length < 1 || entries.length > 16)
+      throw new RangeError("Plaid colors requires 1\u201316 named entries.");
+    const colors = /* @__PURE__ */ Object.create(null);
+    for (const [key, value] of entries) {
+      if (!key || !/^#[\da-f]{6}$/i.test(value))
+        throw new TypeError("Plaid colors require named #RRGGBB entries.");
+      colors[key] = [
+        parseInt(value.slice(1, 3), 16),
+        parseInt(value.slice(3, 5), 16),
+        parseInt(value.slice(5, 7), 16)
+      ];
+    }
+    return {
+      ...motion(o),
+      horizontal: bands(o.horizontal, colors),
+      vertical: bands(o.vertical, colors),
+      crossing: bound("crossing", o.crossing ?? 0.5, 0, 1)
+    };
+  },
+  (c, u, v, p, px, py) => {
+    const horizontal = bandColor(c.horizontal, v + p, py), vertical = bandColor(c.vertical, u + p, px);
+    return horizontal.map(
+      (n, i) => n * c.crossing + vertical[i] * (1 - c.crossing)
+    );
+  },
+  true
+);
+function plaid(options) {
+  return plaidRecipe(options);
+}
+const presetColors = Object.freeze({
+  background: "#f5e9d3",
+  primary: "#304c48",
+  accent: "#c56948"
+});
+function preset(sequence) {
+  const bands2 = Object.freeze(sequence.map((b) => Object.freeze({ ...b })));
+  return Object.freeze({
+    colors: presetColors,
+    horizontal: bands2,
+    vertical: bands2,
+    crossing: 0.5
+  });
+}
+const plaidPresets = Object.freeze({
+  /** Equal-width alternating bands. See {@link plaidPresets}. */
+  gingham: preset([
+    { width: 1, color: "background" },
+    { width: 1, color: "primary" }
+  ]),
+  /** Symmetric bands with narrow accent lines. See {@link plaidPresets}. */
+  tartan: preset([
+    { width: 8, color: "primary" },
+    { width: 2, color: "background" },
+    { width: 1, color: "accent" },
+    { width: 2, color: "background" }
+  ]),
+  /** Narrow crossing lines on a broad background. See {@link plaidPresets}. */
+  windowpane: preset([
+    { width: 14, color: "background" },
+    { width: 1, color: "primary" }
+  ])
+});
+export {
+  halftone,
+  plaid,
+  plaidPresets,
+  polkaDots,
+  truchet
+};
+//# sourceMappingURL=geometric-patterns.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/geometric-patterns.ts"],
+  "sourcesContent": ["import { defineTexture, type TextureRecipe } from \"@pibbl/core\";\nimport { paletteLut, texturePalettes, validateSeed } from \"./palette.js\";\nimport type { PatternMotionOptions } from \"./patterns.js\";\n\n/** Seamless circular dots with optional stagger and seeded displacement. @see {@link polkaDots} */\nexport interface PolkaDotsOptions extends PatternMotionOptions {\n  /** Integer columns, 1\u201364; default 12. See {@link PolkaDotsOptions}. */\n  readonly columns?: number;\n  /** Even integer rows, 2\u201364; default 12, preserving stagger across the seam. See {@link PolkaDotsOptions}. */\n  readonly rows?: number;\n  /** Radius in cell fractions, 0\u20130.5; default 0.3. See {@link PolkaDotsOptions}. */\n  readonly radius?: number;\n  /** Alternate-row horizontal offset in cell fractions, 0\u20131; default 0. See {@link PolkaDotsOptions}. */\n  readonly stagger?: number;\n  /** Seeded center displacement per axis in cell fractions, 0\u20130.5; default 0. See {@link PolkaDotsOptions}. */\n  readonly jitter?: number;\n  /** Unsigned 32-bit variation seed; default 42. See {@link PolkaDotsOptions}. */\n  readonly seed?: number;\n}\n/** A periodic tonal field expressed as varying dot sizes. @see {@link halftone} */\nexport interface HalftoneOptions extends PatternMotionOptions {\n  /** Integer columns, 1\u201364; default 24. See {@link HalftoneOptions}. */\n  readonly columns?: number;\n  /** Even integer rows, 2\u201364; default 24. See {@link HalftoneOptions}. */\n  readonly rows?: number;\n  /** Smallest dot radius in cell fractions, 0\u20130.5; default 0.05. See {@link HalftoneOptions}. */\n  readonly minRadius?: number;\n  /** Largest dot radius in cell fractions, minRadius\u20130.5; default 0.45. See {@link HalftoneOptions}. */\n  readonly maxRadius?: number;\n  /** Integer horizontal tonal periods, 0\u201316; default 1. See {@link HalftoneOptions}. */\n  readonly cyclesX?: number;\n  /** Integer vertical tonal periods, 0\u201316; default 1. See {@link HalftoneOptions}. */\n  readonly cyclesY?: number;\n  /** Tonal wave amplitude, 0\u20131; default 0.7. See {@link HalftoneOptions}. */\n  readonly contrast?: number;\n  /** Alternate-row offset in cell fractions, 0\u20131; default 0.5. See {@link HalftoneOptions}. */\n  readonly stagger?: number;\n}\n/** Seeded connecting quarter-circle tiles. @see {@link truchet} */\nexport interface TruchetOptions extends PatternMotionOptions {\n  /** Integer columns, 1\u201364; default 8. See {@link TruchetOptions}. */\n  readonly columns?: number;\n  /** Integer rows, 1\u201364; default 8. See {@link TruchetOptions}. */\n  readonly rows?: number;\n  /** Stroke width in cell fractions, 0\u20130.5; default 0.12. See {@link TruchetOptions}. */\n  readonly lineWidth?: number;\n  /** Fraction of tiles with the first orientation, 0\u20131; default 0.5. See {@link TruchetOptions}. */\n  readonly orientationBias?: number;\n  /** Unsigned 32-bit orientation seed; default 42. See {@link TruchetOptions}. */\n  readonly seed?: number;\n}\n/** One band in an ordered plaid repeat; colors are named keys. @see {@link PlaidOptions} */\nexport interface PlaidBand<Key extends string = string> {\n  /** Positive relative width; all widths on an axis are normalized together. See {@link PlaidBand}. */\n  readonly width: number;\n  /** A key from the plaid's colors dictionary. See {@link PlaidBand}. */\n  readonly color: Key;\n}\n/** A plaid's named colors, ordered bands, and crossing balance. @see {@link plaid} */\nexport interface PlaidOptions<\n  Colors extends Readonly<Record<string, string>> = Readonly<\n    Record<string, string>\n  >,\n> extends PatternMotionOptions {\n  /** Dictionary of 1\u201316 opaque #RRGGBB colors. See {@link PlaidOptions}. */\n  readonly colors: Colors;\n  /** Ordered horizontal bands, 1\u201332, referencing existing color keys. See {@link PlaidOptions}. */\n  readonly horizontal: readonly PlaidBand<\n    NoInfer<Extract<keyof Colors, string>>\n  >[];\n  /** Ordered vertical bands, 1\u201332, referencing existing color keys. See {@link PlaidOptions}. */\n  readonly vertical: readonly PlaidBand<\n    NoInfer<Extract<keyof Colors, string>>\n  >[];\n  /** Horizontal contribution at crossings, 0\u20131; default 0.5. See {@link PlaidOptions}. */\n  readonly crossing?: number;\n}\nconst tau = 2 * Math.PI;\nconst wrap = (n: number) => ((n % 1) + 1) % 1;\nfunction bound(\n  name: string,\n  n: number,\n  min: number,\n  max: number,\n  integer = false,\n) {\n  if (\n    !Number.isFinite(n) ||\n    n < min ||\n    n > max ||\n    (integer && !Number.isInteger(n))\n  )\n    throw new RangeError(\n      `${name} must be ${integer ? \"an integer\" : \"finite\"} in ${min}\u2013${max}.`,\n    );\n  return n;\n}\nfunction motion(o: PatternMotionOptions) {\n  return {\n    phase: wrap(\n      bound(\"phase\", o.phase ?? 0, -Number.MAX_VALUE, Number.MAX_VALUE),\n    ),\n    speed: bound(\"speed\", o.speed ?? 0, 0, 20),\n  };\n}\nfunction grid(\n  o: { columns?: number; rows?: number },\n  defaults: number,\n  even = false,\n) {\n  const columns = bound(\"columns\", o.columns ?? defaults, 1, 64, true),\n    rows = bound(\"rows\", o.rows ?? defaults, even ? 2 : 1, 64, true);\n  if (even && rows % 2)\n    throw new RangeError(\"rows must be even for seamless stagger.\");\n  return { columns, rows };\n}\nfunction hash(\n  x: number,\n  y: number,\n  columns: number,\n  rows: number,\n  seed: number,\n) {\n  const ix = ((x % columns) + columns) % columns,\n    iy = ((y % rows) + rows) % rows;\n  let h = Math.imul((iy * columns + ix) ^ seed, 0x45d9f3b);\n  h = Math.imul(h ^ (h >>> 16), 0x45d9f3b);\n  return ((h ^ (h >>> 16)) >>> 0) / 0x100000000;\n}\nfunction coverage(distance: number, halfWidth: number, pixel: number) {\n  if (halfWidth === 0) return 0;\n  const t = Math.max(0, Math.min(1, (halfWidth - distance) / pixel + 0.5));\n  return t * t * (3 - 2 * t);\n}\ntype Motion = { phase: number; speed: number };\ntype RGB = readonly [number, number, number];\ninterface State<C> {\n  config: C;\n  phase: number;\n  fresh: boolean;\n  dirty: boolean;\n  image: ImageData | undefined;\n  paletteKey: string;\n  lut: Uint8ClampedArray | undefined;\n}\n// Each factory owns a stable definition. Color samplers share only bounded raster\n// storage and the existing Pibbl lifecycle; they never start a separate timer.\nfunction geometry<O, C extends Motion>(\n  validate: (o: O) => C,\n  sample: (\n    c: C,\n    u: number,\n    v: number,\n    phase: number,\n    pixelX: number,\n    pixelY: number,\n  ) => number | RGB,\n  named = false,\n) {\n  const definition = defineTexture<C, State<C>>({\n    create(context, config) {\n      if (config.speed) context.requestFrame();\n      return {\n        config,\n        phase: config.phase,\n        fresh: true,\n        dirty: true,\n        image: new ImageData(context.canvas.width, context.canvas.height),\n        paletteKey: \"\",\n        lut: undefined,\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.dirty = true;\n      context.invalidate();\n      if (config.speed) context.requestFrame();\n    },\n    advance(state, frame, context) {\n      if (!state.config.speed) return;\n      if (!state.fresh && frame.delta > 0) {\n        state.phase = wrap(\n          state.phase + (frame.delta * state.config.speed) / 1000,\n        );\n        state.dirty = true;\n        context.invalidate();\n      }\n      state.fresh = false;\n      context.requestFrame();\n    },\n    rasterize(state, context) {\n      if (named && context.palette !== undefined)\n        throw new TypeError(\n          \"plaid uses its named colors dictionary; omit useTexture palette.\",\n        );\n      const palette = context.palette ?? texturePalettes.porcelain,\n        key = palette.join();\n      if (!named && key !== state.paletteKey) {\n        state.lut = paletteLut(palette);\n        state.paletteKey = key;\n        state.dirty = true;\n      }\n      if (!state.dirty) return;\n      const { width, height } = context.canvas,\n        data = state.image!.data;\n      for (let y = 0; y < height; y++)\n        for (let x = 0; x < width; x++) {\n          const result = sample(\n              state.config,\n              x === width - 1 ? 0 : x / (width - 1),\n              y === height - 1 ? 0 : y / (height - 1),\n              state.phase,\n              1 / (width - 1),\n              1 / (height - 1),\n            ),\n            index = (y * width + x) * 4;\n          if (typeof result === \"number\") {\n            const at = Math.round(Math.max(0, Math.min(1, result)) * 255) * 4;\n            data[index] = state.lut![at];\n            data[index + 1] = state.lut![at + 1];\n            data[index + 2] = state.lut![at + 2];\n          } else {\n            data[index] = result[0];\n            data[index + 1] = result[1];\n            data[index + 2] = result[2];\n          }\n          data[index + 3] = 255;\n        }\n      context.canvas.getContext(\"2d\")!.putImageData(state.image!, 0, 0);\n      state.dirty = false;\n    },\n    dispose(state) {\n      state.image = undefined;\n      state.lut = undefined;\n    },\n  });\n  return (o: O): TextureRecipe => definition(validate(o));\n}\nfunction dots(\n  c: {\n    columns: number;\n    rows: number;\n    stagger: number;\n    jitter: number;\n    seed: number;\n  },\n  u: number,\n  v: number,\n  radius: (x: number, y: number) => number,\n  px: number,\n  py: number,\n) {\n  const x = u * c.columns,\n    y = v * c.rows,\n    pixel = Math.max(px * c.columns, py * c.rows);\n  let amount = 0;\n  // Neighboring periodic cells include dots displaced across cell/tile boundaries.\n  for (let j = Math.floor(y) - 1; j <= Math.floor(y) + 1; j++)\n    for (let i = Math.floor(x) - 2; i <= Math.floor(x) + 1; i++) {\n      const row = ((j % c.rows) + c.rows) % c.rows;\n      const cx =\n        i +\n        0.5 +\n        (row % 2) * c.stagger +\n        (hash(i, j, c.columns, c.rows, c.seed) - 0.5) * 2 * c.jitter;\n      const cy =\n        j +\n        0.5 +\n        (hash(i, j, c.columns, c.rows, c.seed ^ 0x19ae) - 0.5) * 2 * c.jitter;\n      amount = Math.max(\n        amount,\n        coverage(Math.hypot(x - cx, y - cy), radius(i, j), pixel),\n      );\n    }\n  return amount;\n}\nconst dotRecipe = geometry(\n  (o: PolkaDotsOptions) => ({\n    ...motion(o),\n    ...grid(o, 12, true),\n    radius: bound(\"radius\", o.radius ?? 0.3, 0, 0.5),\n    stagger: bound(\"stagger\", o.stagger ?? 0, 0, 1),\n    jitter: bound(\"jitter\", o.jitter ?? 0, 0, 0.5),\n    seed: validateSeed(o.seed ?? 42),\n  }),\n  (c, u, v, p, px, py) => dots(c, wrap(u + p), v, () => c.radius, px, py),\n);\n/**\n * Creates a seamless dot lattice using palette endpoints.\n * @param options - Dot geometry and motion.\n * @returns A mountable texture recipe.\n * @see {@link PolkaDotsOptions}\n */\nexport function polkaDots(options: PolkaDotsOptions = {}): TextureRecipe {\n  return dotRecipe(options);\n}\nconst halftoneRecipe = geometry(\n  (o: HalftoneOptions) => {\n    const minRadius = bound(\"minRadius\", o.minRadius ?? 0.05, 0, 0.5),\n      maxRadius = bound(\"maxRadius\", o.maxRadius ?? 0.45, minRadius, 0.5);\n    return {\n      ...motion(o),\n      ...grid(o, 24, true),\n      minRadius,\n      maxRadius,\n      cyclesX: bound(\"cyclesX\", o.cyclesX ?? 1, 0, 16, true),\n      cyclesY: bound(\"cyclesY\", o.cyclesY ?? 1, 0, 16, true),\n      contrast: bound(\"contrast\", o.contrast ?? 0.7, 0, 1),\n      stagger: bound(\"stagger\", o.stagger ?? 0.5, 0, 1),\n      jitter: 0,\n      seed: 42,\n    };\n  },\n  (c, u, v, p, px, py) =>\n    dots(\n      c,\n      u,\n      v,\n      (x, y) => {\n        const tone =\n          0.5 +\n          0.25 *\n            c.contrast *\n            (Math.sin(tau * (((x + 0.5) / c.columns) * c.cyclesX + p)) +\n              Math.sin(tau * (((y + 0.5) / c.rows) * c.cyclesY + p)));\n        return c.minRadius + (c.maxRadius - c.minRadius) * tone;\n      },\n      px,\n      py,\n    ),\n);\n/**\n * Creates seamless varying-size dots from a periodic tonal field.\n * @param options - Dot sizes, tonal periods, and motion.\n * @returns A mountable texture recipe.\n * @see {@link HalftoneOptions}\n */\nexport function halftone(options: HalftoneOptions = {}): TextureRecipe {\n  return halftoneRecipe(options);\n}\nconst truchetRecipe = geometry(\n  (o: TruchetOptions) => ({\n    ...motion(o),\n    ...grid(o, 8),\n    lineWidth: bound(\"lineWidth\", o.lineWidth ?? 0.12, 0, 0.5),\n    orientationBias: bound(\"orientationBias\", o.orientationBias ?? 0.5, 0, 1),\n    seed: validateSeed(o.seed ?? 42),\n  }),\n  (c, u, v, p, px, py) => {\n    const x = wrap(u + p) * c.columns,\n      y = wrap(v + p) * c.rows,\n      ix = Math.floor(x),\n      iy = Math.floor(y),\n      a = x - ix,\n      b = y - iy;\n    const first = hash(ix, iy, c.columns, c.rows, c.seed) < c.orientationBias;\n    const distance = first\n      ? Math.min(\n          Math.abs(Math.hypot(a, b) - 0.5),\n          Math.abs(Math.hypot(1 - a, 1 - b) - 0.5),\n        )\n      : Math.min(\n          Math.abs(Math.hypot(1 - a, b) - 0.5),\n          Math.abs(Math.hypot(a, 1 - b) - 0.5),\n        );\n    return coverage(\n      distance,\n      c.lineWidth / 2,\n      Math.max(px * c.columns, py * c.rows),\n    );\n  },\n);\n/**\n * Creates seeded quarter-circle tiles that connect across every edge.\n * @param options - Tile counts, stroke width, seed, and motion.\n * @returns A mountable texture recipe.\n * @see {@link TruchetOptions}\n */\nexport function truchet(options: TruchetOptions = {}): TextureRecipe {\n  return truchetRecipe(options);\n}\ninterface Band {\n  end: number;\n  color: RGB;\n}\nfunction bands(\n  input: readonly PlaidBand[],\n  colors: Readonly<Record<string, RGB>>,\n): Band[] {\n  if (!Array.isArray(input) || input.length < 1 || input.length > 32)\n    throw new RangeError(\"Plaid requires 1\u201332 bands per axis.\");\n  const total = input.reduce(\n    (n, b) => n + bound(\"band width\", b.width, Number.MIN_VALUE, 1e6),\n    0,\n  );\n  let end = 0;\n  return input.map((b) => {\n    if (!Object.hasOwn(colors, b.color))\n      throw new TypeError(`Unknown plaid color key: ${b.color}`);\n    end += b.width / total;\n    return { end, color: colors[b.color] };\n  });\n}\n// Integrate a box footprint across periodic band boundaries, giving crisp interiors\n// and gradual coverage at edges at any raster resolution.\nfunction bandColor(\n  bands: readonly Band[],\n  position: number,\n  footprint: number,\n): RGB {\n  const center = wrap(position),\n    lo = center - footprint / 2,\n    hi = center + footprint / 2,\n    result = [0, 0, 0];\n  for (let shift = -1; shift <= 1; shift++) {\n    let start = shift;\n    for (const band of bands) {\n      const end = shift + band.end,\n        weight =\n          Math.max(0, Math.min(hi, end) - Math.max(lo, start)) / footprint;\n      for (let k = 0; k < 3; k++) result[k] += band.color[k] * weight;\n      start = end;\n    }\n  }\n  return result as [number, number, number];\n}\nconst plaidRecipe = geometry(\n  (\n    o: PatternMotionOptions & {\n      colors: Readonly<Record<string, string>>;\n      horizontal: readonly PlaidBand[];\n      vertical: readonly PlaidBand[];\n      crossing?: number;\n    },\n  ) => {\n    const entries = Object.entries(o.colors);\n    if (entries.length < 1 || entries.length > 16)\n      throw new RangeError(\"Plaid colors requires 1\u201316 named entries.\");\n    const colors: Record<string, RGB> = Object.create(null);\n    for (const [key, value] of entries) {\n      if (!key || !/^#[\\da-f]{6}$/i.test(value))\n        throw new TypeError(\"Plaid colors require named #RRGGBB entries.\");\n      colors[key] = [\n        parseInt(value.slice(1, 3), 16),\n        parseInt(value.slice(3, 5), 16),\n        parseInt(value.slice(5, 7), 16),\n      ];\n    }\n    return {\n      ...motion(o),\n      horizontal: bands(o.horizontal, colors),\n      vertical: bands(o.vertical, colors),\n      crossing: bound(\"crossing\", o.crossing ?? 0.5, 0, 1),\n    };\n  },\n  (c, u, v, p, px, py) => {\n    const horizontal = bandColor(c.horizontal, v + p, py),\n      vertical = bandColor(c.vertical, u + p, px);\n    return horizontal.map(\n      (n, i) => n * c.crossing + vertical[i] * (1 - c.crossing),\n    ) as [number, number, number];\n  },\n  true,\n);\n/**\n * Creates plaid using checked color keys and ordered relative-width bands.\n * @param options - Named colors, bands, crossing balance, and motion.\n * @returns A mountable texture recipe.\n * @see {@link PlaidOptions}\n */\nexport function plaid<const Colors extends Readonly<Record<string, string>>>(\n  options: PlaidOptions<Colors>,\n): TextureRecipe {\n  return plaidRecipe(options);\n}\nconst presetColors = Object.freeze({\n  background: \"#f5e9d3\",\n  primary: \"#304c48\",\n  accent: \"#c56948\",\n});\nfunction preset(sequence: readonly PlaidBand<keyof typeof presetColors>[]) {\n  const bands = Object.freeze(sequence.map((b) => Object.freeze({ ...b })));\n  return Object.freeze({\n    colors: presetColors,\n    horizontal: bands,\n    vertical: bands,\n    crossing: 0.5,\n  });\n}\n/** Named-color band configurations for gingham, tartan, and windowpane patterns. @see {@link plaid} */\nexport const plaidPresets = Object.freeze({\n  /** Equal-width alternating bands. See {@link plaidPresets}. */\n  gingham: preset([\n    { width: 1, color: \"background\" },\n    { width: 1, color: \"primary\" },\n  ]),\n  /** Symmetric bands with narrow accent lines. See {@link plaidPresets}. */\n  tartan: preset([\n    { width: 8, color: \"primary\" },\n    { width: 2, color: \"background\" },\n    { width: 1, color: \"accent\" },\n    { width: 2, color: \"background\" },\n  ]),\n  /** Narrow crossing lines on a broad background. See {@link plaidPresets}. */\n  windowpane: preset([\n    { width: 14, color: \"background\" },\n    { width: 1, color: \"primary\" },\n  ]),\n});\n"],
+  "mappings": "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",
+  "names": ["bands"]
+}

package/dist/features/textures/lib/gray-scott.d.ts

@@ -0,0 +1,55 @@
+/** Curated immutable Gray–Scott feed/kill pairs. Appearance also depends on seed and elapsed steps. @see {@link ReactionDiffusionOptions} */
+export declare const grayScottPresets: Readonly<{
+    /** Existing isolated spots. See {@link grayScottPresets}. */
+    spots: Readonly<{
+        feed: 0.0367;
+        kill: 0.0649;
+    }>;
+    /** Existing connected stripes. See {@link grayScottPresets}. */
+    stripes: Readonly<{
+        feed: 0.029;
+        kill: 0.057;
+    }>;
+    /** Branching coral-like fronts. See {@link grayScottPresets}. */
+    coral: Readonly<{
+        feed: 0.0545;
+        kill: 0.062;
+    }>;
+    /** Elongated worm-like structures. See {@link grayScottPresets}. */
+    worms: Readonly<{
+        feed: 0.078;
+        kill: 0.061;
+    }>;
+    /** Dense connected labyrinths. See {@link grayScottPresets}. */
+    labyrinths: Readonly<{
+        feed: 0.037;
+        kill: 0.06;
+    }>;
+    /** Growing and dividing spots in suitable seeded conditions. See {@link grayScottPresets}. */
+    mitosis: Readonly<{
+        feed: 0.028;
+        kill: 0.062;
+    }>;
+}>;
+/** Named configurations of the same Gray–Scott solver and message contract. @see {@link grayScottPresets} */
+export type ReactionDiffusionPreset = keyof typeof grayScottPresets;
+/** Seed, chemistry, and initialization controls for Gray–Scott textures. @see {@link grayScottPresets} */
+export interface ReactionDiffusionOptions {
+    /** Unsigned 32-bit initialization seed; default 42. See {@link ReactionDiffusionOptions}. */
+    readonly seed?: number;
+    /** Curated feed/kill configuration; default spots. See {@link ReactionDiffusionPreset}. */
+    readonly preset?: ReactionDiffusionPreset;
+    /** Feed-rate override, finite 0–0.1. Changes reset the field. See {@link ReactionDiffusionOptions}. */
+    readonly feed?: number;
+    /** Kill-rate override, finite 0–0.1. Changes reset the field. See {@link ReactionDiffusionOptions}. */
+    readonly kill?: number;
+    /** Initial numerical steps, integer 0–4096; default 0. Runs once per initialization. See {@link ReactionDiffusionOptions}. */
+    readonly warmupSteps?: number;
+}
+export declare function grayScottConfig(options: ReactionDiffusionOptions): {
+    seed: number;
+    preset: "coral" | "labyrinths" | "mitosis" | "spots" | "stripes" | "worms";
+    feed: number;
+    kill: number;
+    warmupSteps: number;
+};

package/dist/features/textures/lib/gray-scott.js

@@ -0,0 +1,39 @@
+import { validateSeed } from "./palette.js";
+const grayScottPresets = Object.freeze({
+  /** Existing isolated spots. See {@link grayScottPresets}. */
+  spots: Object.freeze({ feed: 0.0367, kill: 0.0649 }),
+  /** Existing connected stripes. See {@link grayScottPresets}. */
+  stripes: Object.freeze({ feed: 0.029, kill: 0.057 }),
+  /** Branching coral-like fronts. See {@link grayScottPresets}. */
+  coral: Object.freeze({ feed: 0.0545, kill: 0.062 }),
+  /** Elongated worm-like structures. See {@link grayScottPresets}. */
+  worms: Object.freeze({ feed: 0.078, kill: 0.061 }),
+  /** Dense connected labyrinths. See {@link grayScottPresets}. */
+  labyrinths: Object.freeze({ feed: 0.037, kill: 0.06 }),
+  /** Growing and dividing spots in suitable seeded conditions. See {@link grayScottPresets}. */
+  mitosis: Object.freeze({ feed: 0.028, kill: 0.062 })
+});
+function grayScottConfig(options) {
+  const preset = options.preset ?? "spots";
+  if (!Object.hasOwn(grayScottPresets, preset))
+    throw new TypeError("Unknown reaction-diffusion preset.");
+  const feed = options.feed ?? grayScottPresets[preset].feed;
+  const kill = options.kill ?? grayScottPresets[preset].kill;
+  if (![feed, kill].every(
+    (value) => Number.isFinite(value) && value >= 0 && value <= 0.1
+  ))
+    throw new RangeError(
+      "Gray\u2013Scott feed and kill must be finite values in [0, 0.1]."
+    );
+  const warmupSteps = options.warmupSteps ?? 0;
+  if (!Number.isInteger(warmupSteps) || warmupSteps < 0 || warmupSteps > 4096)
+    throw new RangeError(
+      "Gray\u2013Scott warmupSteps must be an integer in [0, 4096]."
+    );
+  return { seed: validateSeed(options.seed), preset, feed, kill, warmupSteps };
+}
+export {
+  grayScottConfig,
+  grayScottPresets
+};
+//# sourceMappingURL=gray-scott.js.map

package/dist/features/textures/lib/gray-scott.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/gray-scott.ts"],
+  "sourcesContent": ["import { validateSeed } from \"./palette.js\";\n/** Curated immutable Gray\u2013Scott feed/kill pairs. Appearance also depends on seed and elapsed steps. @see {@link ReactionDiffusionOptions} */\nexport const grayScottPresets = Object.freeze({\n  /** Existing isolated spots. See {@link grayScottPresets}. */\n  spots: Object.freeze({ feed: 0.0367, kill: 0.0649 }),\n  /** Existing connected stripes. See {@link grayScottPresets}. */\n  stripes: Object.freeze({ feed: 0.029, kill: 0.057 }),\n  /** Branching coral-like fronts. See {@link grayScottPresets}. */\n  coral: Object.freeze({ feed: 0.0545, kill: 0.062 }),\n  /** Elongated worm-like structures. See {@link grayScottPresets}. */\n  worms: Object.freeze({ feed: 0.078, kill: 0.061 }),\n  /** Dense connected labyrinths. See {@link grayScottPresets}. */\n  labyrinths: Object.freeze({ feed: 0.037, kill: 0.06 }),\n  /** Growing and dividing spots in suitable seeded conditions. See {@link grayScottPresets}. */\n  mitosis: Object.freeze({ feed: 0.028, kill: 0.062 }),\n});\n/** Named configurations of the same Gray\u2013Scott solver and message contract. @see {@link grayScottPresets} */\nexport type ReactionDiffusionPreset = keyof typeof grayScottPresets;\n/** Seed, chemistry, and initialization controls for Gray\u2013Scott textures. @see {@link grayScottPresets} */\nexport interface ReactionDiffusionOptions {\n  /** Unsigned 32-bit initialization seed; default 42. See {@link ReactionDiffusionOptions}. */\n  readonly seed?: number;\n  /** Curated feed/kill configuration; default spots. See {@link ReactionDiffusionPreset}. */\n  readonly preset?: ReactionDiffusionPreset;\n  /** Feed-rate override, finite 0\u20130.1. Changes reset the field. See {@link ReactionDiffusionOptions}. */\n  readonly feed?: number;\n  /** Kill-rate override, finite 0\u20130.1. Changes reset the field. See {@link ReactionDiffusionOptions}. */\n  readonly kill?: number;\n  /** Initial numerical steps, integer 0\u20134096; default 0. Runs once per initialization. See {@link ReactionDiffusionOptions}. */\n  readonly warmupSteps?: number;\n}\nexport function grayScottConfig(options: ReactionDiffusionOptions) {\n  const preset = options.preset ?? \"spots\";\n  if (!Object.hasOwn(grayScottPresets, preset))\n    throw new TypeError(\"Unknown reaction-diffusion preset.\");\n  const feed = options.feed ?? grayScottPresets[preset].feed;\n  const kill = options.kill ?? grayScottPresets[preset].kill;\n  if (\n    ![feed, kill].every(\n      (value) => Number.isFinite(value) && value >= 0 && value <= 0.1,\n    )\n  )\n    throw new RangeError(\n      \"Gray\u2013Scott feed and kill must be finite values in [0, 0.1].\",\n    );\n  const warmupSteps = options.warmupSteps ?? 0;\n  if (!Number.isInteger(warmupSteps) || warmupSteps < 0 || warmupSteps > 4096)\n    throw new RangeError(\n      \"Gray\u2013Scott warmupSteps must be an integer in [0, 4096].\",\n    );\n  return { seed: validateSeed(options.seed), preset, feed, kill, warmupSteps };\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB;AAEtB,MAAM,mBAAmB,OAAO,OAAO;AAAA;AAAA,EAE5C,OAAO,OAAO,OAAO,EAAE,MAAM,QAAQ,MAAM,OAAO,CAAC;AAAA;AAAA,EAEnD,SAAS,OAAO,OAAO,EAAE,MAAM,OAAO,MAAM,MAAM,CAAC;AAAA;AAAA,EAEnD,OAAO,OAAO,OAAO,EAAE,MAAM,QAAQ,MAAM,MAAM,CAAC;AAAA;AAAA,EAElD,OAAO,OAAO,OAAO,EAAE,MAAM,OAAO,MAAM,MAAM,CAAC;AAAA;AAAA,EAEjD,YAAY,OAAO,OAAO,EAAE,MAAM,OAAO,MAAM,KAAK,CAAC;AAAA;AAAA,EAErD,SAAS,OAAO,OAAO,EAAE,MAAM,OAAO,MAAM,MAAM,CAAC;AACrD,CAAC;AAgBM,SAAS,gBAAgB,SAAmC;AACjE,QAAM,SAAS,QAAQ,UAAU;AACjC,MAAI,CAAC,OAAO,OAAO,kBAAkB,MAAM;AACzC,UAAM,IAAI,UAAU,oCAAoC;AAC1D,QAAM,OAAO,QAAQ,QAAQ,iBAAiB,MAAM,EAAE;AACtD,QAAM,OAAO,QAAQ,QAAQ,iBAAiB,MAAM,EAAE;AACtD,MACE,CAAC,CAAC,MAAM,IAAI,EAAE;AAAA,IACZ,CAAC,UAAU,OAAO,SAAS,KAAK,KAAK,SAAS,KAAK,SAAS;AAAA,EAC9D;AAEA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,cAAc,QAAQ,eAAe;AAC3C,MAAI,CAAC,OAAO,UAAU,WAAW,KAAK,cAAc,KAAK,cAAc;AACrE,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,SAAO,EAAE,MAAM,aAAa,QAAQ,IAAI,GAAG,QAAQ,MAAM,MAAM,YAAY;AAC7E;",
+  "names": []
+}