@pixerate/editor 0.275.1 → 0.277.0

package/dist/{chunk-ZM7IKQ4X.js → chunk-PPDUCZZV.js}

@@ -9,17 +9,21 @@ import {
 import {
   DEFAULT_BLENDER,
   DEFAULT_BRUSH,
+  DEFAULT_LIVE_PATTERNS,
   DEFAULT_MIXER,
   DEFAULT_SMUDGE,
   GRAIN_PATTERNS,
+  LIVE_PATTERN_KINDS,
+  LIVE_PATTERN_PRESETS,
   MAX_BRUSH_SIZE,
   PAINT_GRADIENT_JSON_SCHEMA,
   normalizeBlender,
   normalizeBrush,
+  normalizeLivePatterns,
   normalizeMixer,
   normalizeSmudge,
   readPaintSource
-} from "./chunk-ACTHSQOI.js";
+} from "./chunk-LDZOXESA.js";
 import {
   BLEND_MODES
 } from "./chunk-IRSTHLQQ.js";
@@ -278,6 +282,29 @@ var BRUSH_PRESETS = [
     behaviour: { surface: "wet", exchange: { pickup: 0.4, mix: 0.4 }, wet: { water: 0.8, pigment: 0.45, rewet: 0.2 } },
     colour: { default: { type: "gradient", stops: [{ offset: 0, color: "paint" }, { offset: 1, color: "secondary" }], space: "pigment", map: { by: "distance", length: 500, repeat: "mirror", unit: "px" } } }
   },
+  // Live patterns: Gray-Scott reaction-diffusion that grows inside the wet wash and freezes as it dries.
+  {
+    id: "turing-wash",
+    name: "Turing wash",
+    kind: "mark",
+    medium: "paint",
+    variety: "watercolor",
+    tip: { shape: "round", size: 36, hardness: 0.5, spacing: 0.12 },
+    dynamics: { smoothing: 0.25, pressureOpacity: true, minSize: 0.35 },
+    behaviour: { surface: "wet", exchange: { pickup: 0.45 }, wet: { water: 0.75, pigment: 0.55, rewet: 0.2 } },
+    livePatterns: { pattern: "spots", contrast: 1.2, secondColor: "#0ea5e9", relief: 0.25 }
+  },
+  {
+    id: "coral-ink",
+    name: "Coral ink",
+    kind: "mark",
+    medium: "ink",
+    variety: "watercolor",
+    tip: { shape: "round", size: 22, hardness: 0.65, spacing: 0.12 },
+    dynamics: { smoothing: 0.3, pressureOpacity: true, minSize: 0.3 },
+    behaviour: { surface: "wet", exchange: { pickup: 0.35 }, wet: { water: 0.7, pigment: 0.75, rewet: 0.15 } },
+    livePatterns: { pattern: "coral", scale: 1.2, contrast: 1.3 }
+  },
   {
     id: "watercolor-detail",
     name: "Watercolour rigger",
@@ -905,6 +932,29 @@ var BRUSH_PRESETS = [
     tip: { shape: "round", size: 6, hardness: 0.9, spacing: 0.06 },
     dynamics: { smoothing: 0.35, pressureSmoothing: 0.25, minSize: 0.25 },
     mutation: {}
+  },
+  // --- Ferrofluid paint: liquid magnetic paint that rises into lit Rosensweig spikes near magnets ---
+  {
+    id: "ferrofluid",
+    name: "Ferrofluid",
+    kind: "mark",
+    medium: "paint",
+    variety: "ferrofluid",
+    tip: { shape: "round", size: 28, hardness: 0.75, flow: 0.9 },
+    dynamics: { smoothing: 0.35 },
+    ferro: { amount: 0.85 },
+    colour: { default: "#111827", palette: ["#111827", "#1e293b", "#312e81", "#0f3d3e", "#3b0764", "#451a03"] }
+  },
+  {
+    id: "ferro-ink",
+    name: "Ferro ink",
+    kind: "mark",
+    medium: "ink",
+    variety: "ferrofluid",
+    tip: { shape: "round", size: 12, spacing: 0.08 },
+    dynamics: { smoothing: 0.45, minSize: 0.25, velocitySize: -0.25 },
+    ferro: { amount: 0.7, wavelength: 12, threshold: 0.15 },
+    colour: { default: "#0f172a" }
   }
 ];
 
@@ -1074,6 +1124,18 @@ function normalizeMutation(raw = {}, base = DEFAULT_MUTATION) {
     fade: range(raw.fade, 0.5, 10, base.fade)
   };
 }
+var DEFAULT_FERRO = { amount: 0, wavelength: 16, threshold: 0.12 };
+function normalizeFerro(raw = {}, base = DEFAULT_FERRO) {
+  if (typeof raw === "number") {
+    return { amount: unit2(raw, base.amount), wavelength: base.wavelength, threshold: base.threshold };
+  }
+  const r = raw ?? {};
+  return {
+    amount: unit2(r.amount, base.amount),
+    wavelength: range(r.wavelength, 4, 64, base.wavelength),
+    threshold: range(r.threshold, 0.01, 0.95, base.threshold)
+  };
+}
 function normalizeImpasto(raw = {}, base = DEFAULT_IMPASTO) {
   return {
     tool: IMPASTO_TOOLS.includes(raw.tool) ? raw.tool : base.tool,
@@ -1152,6 +1214,12 @@ function countAndFlip(raw, base) {
   return { ...n > 1 ? { count: n } : {}, ...flip !== "none" ? { flip } : {} };
 }
 var withTipGrain = (g) => g ? { tipGrain: g } : {};
+var withLivePatterns = (lp) => lp ? { livePatterns: lp } : {};
+function readLivePatterns(raw, base) {
+  if (raw === null) return null;
+  if (!raw || typeof raw !== "object") return base;
+  return normalizeLivePatterns(raw, base ?? DEFAULT_LIVE_PATTERNS);
+}
 function readTipGrain(raw, base) {
   if (raw === null) return null;
   if (!raw || typeof raw !== "object") return base;
@@ -1296,9 +1364,11 @@ function normalizePaintBrush(raw = {}, base) {
     ...withIridescence(readIridescence(raw.iridescence, b.iridescence ?? null)),
     ...ghost ? { ghost } : {},
     ...mutation ? { mutation } : {},
+    ferro: normalizeFerro(raw.ferro, b.ferro ?? DEFAULT_FERRO),
     stamp: readStamp(raw.stamp, b.stamp ?? null),
     spray: readSpray(raw.spray, b.spray ?? null),
     ...withTipGrain(readTipGrain(raw.tipGrain, b.tipGrain ?? null)),
+    ...withLivePatterns(readLivePatterns(raw.livePatterns, b.livePatterns ?? null)),
     paint,
     ...raw.builtin ? { builtin: true } : {}
   };
@@ -1326,6 +1396,7 @@ var BASE_BRUSH = {
   light: { ...DEFAULT_LIGHT },
   fluorescence: { ...DEFAULT_FLUORESCENCE },
   thermochromic: { ...DEFAULT_THERMOCHROMIC },
+  ferro: { ...DEFAULT_FERRO },
   stamp: null,
   spray: null,
   paint: null
@@ -1352,6 +1423,23 @@ var ONE_STAMP = {
   toEngine: (v) => v[0] ?? null,
   toFacet: (v) => v ? [v] : void 0
 };
+var LIVE_PATTERNS_MAP = {
+  toEngine: (v) => v !== null && typeof v === "object" ? JSON.parse(JSON.stringify(v)) : v,
+  toFacet: (v) => {
+    if (!v || typeof v !== "object") return void 0;
+    const lp = v;
+    const preset = LIVE_PATTERN_PRESETS[lp.pattern] ?? LIVE_PATTERN_PRESETS.spots;
+    return {
+      pattern: lp.pattern,
+      ...lp.feed !== preset.feed ? { feed: lp.feed } : {},
+      ...lp.kill !== preset.kill ? { kill: lp.kill } : {},
+      ...lp.scale !== DEFAULT_LIVE_PATTERNS.scale ? { scale: lp.scale } : {},
+      ...lp.contrast !== DEFAULT_LIVE_PATTERNS.contrast ? { contrast: lp.contrast } : {},
+      ...lp.secondColor !== null ? { secondColor: lp.secondColor } : {},
+      ...lp.relief !== DEFAULT_LIVE_PATTERNS.relief ? { relief: lp.relief } : {}
+    };
+  }
+};
 var f = (facet, engine, engines = ALL, extra = {}) => ({ facet, engine, engines, ...extra });
 var each = (facetPrefix, enginePrefix, keys, engines) => keys.map((k) => f(`${facetPrefix}.${k}`, `${enginePrefix}.${k}`, engines));
 var BRUSH_FIELDS = [
@@ -1368,6 +1456,7 @@ var BRUSH_FIELDS = [
   ...each("fluorescence", "fluorescence", ["amount", "invisible"]),
   ...each("thermochromic", "thermochromic", ["hotColor", "threshold"]),
   ...each("iridescence", "iridescence", ["thickness", "pressureToThickness", "ior"], FILM),
+  ...each("ferro", "ferro", ["amount", "wavelength", "threshold"]),
   // Paint exchange: the dab, wet and impasto engines' behaviour, or the Mixer Brush's settings.
   f("behaviour.exchange.pickup", "behavior.pickup", EXCHANGE),
   f("behaviour.exchange.mix", "behavior.mix", EXCHANGE),
@@ -1390,6 +1479,7 @@ var BRUSH_FIELDS = [
   f("behaviour.strength", "wet.strength", ["wet"]),
   // Surfaces.
   ...each("behaviour.wet", "wet", ["medium", "water", "pigment", "body", "rewet", "load", "thinner"], ["wet"]),
+  f("livePatterns", "livePatterns", ["wet"], { map: LIVE_PATTERNS_MAP }),
   ...each("ghost", "ghost", ["linger", "smear", "trigger"], ["wet"]),
   ...each("mutation", "mutation", ["settle", "patience", "fade"], ["dab", "wet", "impasto", "particle", "bristle"]),
   f("behaviour.thick.applicator", "impasto.tool", ["impasto"]),
@@ -1486,6 +1576,7 @@ function resolveBrush(brush, options = {}) {
   if (brush.iridescence && FILM.includes(engine)) input.iridescence = { ...input.iridescence ?? {} };
   if (engine === "wet") {
     setPath(input, "wet.tool", brush.kind === "tool" ? WET_TOOL_OF[brush.tool] : "paint");
+    if (brush.kind === "tool") delete input.livePatterns;
     const medium = resolveWetMedium(brush);
     if (medium) setPath(input, "wet.medium", medium);
     if (brush.kind !== "tool" && brush.ghost) input.ghost = { ...input.ghost ?? {} };
@@ -1574,7 +1665,7 @@ function skeleton(b) {
     }
   }
 }
-var ORDER = ["id", "name", "description", "tags", "kind", "medium", "variety", "tool", "tip", "marks", "dynamics", "behaviour", "light", "fluorescence", "thermochromic", "iridescence", "ghost", "mutation", "motion", "colour"];
+var ORDER = ["id", "name", "description", "tags", "kind", "medium", "variety", "tool", "tip", "marks", "dynamics", "behaviour", "light", "fluorescence", "thermochromic", "iridescence", "ghost", "mutation", "ferro", "motion", "livePatterns", "colour"];
 function migrateBrushV1(raw) {
   const b = normalizePaintBrush(raw);
   const brush = skeleton(b);
@@ -1813,11 +1904,29 @@ var MUTATION = object("Mutation paint: you paint something and pause; once an ag
   patience: num(5, 300, "Seconds to wait for an agent before giving up and keeping the paint as ordinary paint (default 45)."),
   fade: num(0.5, 10, "Seconds the paint takes to sink away once claimed by read_mutation (default 2).")
 });
+var FERRO = object("Liquid ferrofluid paint: rises into glossy Rosensweig spikes near magnets until cured.", {
+  amount: unit3("How much liquid ferrofluid the brush lays per dab (default 0: none)."),
+  wavelength: num(4, 64, "Capillary wavelength (spike-to-spike spacing) in pixels (default 16)."),
+  threshold: num(0.01, 0.95, "Critical magnetic field |B| threshold where spikes begin to rise (default 0.12).")
+});
 var MOTION = object("Animation after painting.", {
   live: bool("Effect paint keeps playing on stroke layers (default false)."),
   fps: int(1, 60, "Suggested playback rate in frames per second."),
   waveSpeed: unit3("Particle waves: how fast they run by stroke time; 0 they stand still (default 0), 1 about four a second.")
 });
+var LIVE_PATTERNS = object("Gray-Scott reaction-diffusion patterns (spots, stripes, coral, maze, worms) that grow inside wet paint (behaviour.surface: wet) and freeze where the paint dries.", {
+  pattern: oneOf2(LIVE_PATTERN_KINDS, "Named Pearson feed/kill preset: spots (default, dividing mitosis spots), stripes (labyrinthine stripes), coral (branching dendrites), maze (winding channels) or worms (vermicular tracks)."),
+  feed: num(0.01, 0.1, "Gray-Scott feed rate F (0.01..0.1; default from pattern)."),
+  kill: num(0.03, 0.08, "Gray-Scott kill rate k (0.03..0.08; default from pattern)."),
+  scale: num(0.5, 4, "Spatial scale of the pattern (diffusion multiplier, 0.5..4, default 1)."),
+  contrast: num(0, 2, "Visual contrast of the V concentration field (0..2, default 1)."),
+  secondColor: {
+    type: ["string", "null"],
+    pattern: "^#[0-9a-fA-F]{6}$",
+    description: "Optional second colour (#rrggbb) that V blends the wet paint towards; null or omitted modulates pigment density/contrast."
+  },
+  relief: unit3("Impasto relief height written to the layer thick map as patterns grow (0..1, default 0).")
+});
 var SOLID = {
   type: "string",
   pattern: "^(#([0-9a-fA-F]{6}|[0-9a-fA-F]{8})|rgba?\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*(,\\s*(0|1|0?\\.\\d+)\\s*)?\\))$",
@@ -1881,7 +1990,9 @@ var BRUSH_JSON_SCHEMA = object(
     iridescence: IRIDESCENCE,
     ghost: GHOST,
     mutation: MUTATION,
+    ferro: FERRO,
     motion: MOTION,
+    livePatterns: LIVE_PATTERNS,
     colour: COLOUR
   },
   ["id", "name", "kind", "tip"]
@@ -1898,7 +2009,9 @@ var BRUSH_FACET_SCHEMAS = {
   iridescence: IRIDESCENCE,
   ghost: GHOST,
   mutation: MUTATION,
+  ferro: FERRO,
   motion: MOTION,
+  livePatterns: LIVE_PATTERNS,
   colour: COLOUR,
   paint: PAINT
 };
@@ -2047,17 +2160,19 @@ function read(value, schema, path, problems) {
     problems.push(`${path} must be ${JSON.stringify(schema.const)}; dropped.`);
     return void 0;
   }
-  switch (schema.type) {
+  if (value === null && Array.isArray(schema.type) && schema.type.includes("null")) return null;
+  const schemaType = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+  switch (schemaType) {
     case "number":
     case "integer": {
       if (typeof value !== "number" || !Number.isFinite(value)) {
         problems.push(`${path} must be a number; dropped.`);
         return void 0;
       }
-      let n = schema.type === "integer" ? Math.round(value) : value;
+      let n = schemaType === "integer" ? Math.round(value) : value;
       if (schema.minimum !== void 0 && n < schema.minimum) n = schema.minimum;
       if (schema.maximum !== void 0 && n > schema.maximum) n = schema.maximum;
-      if (n !== value) problems.push(`${path} ${value} is out of range (${schema.minimum}..${schema.maximum}${schema.type === "integer" ? ", whole" : ""}); set to ${n}.`);
+      if (n !== value) problems.push(`${path} ${value} is out of range (${schema.minimum}..${schema.maximum}${schemaType === "integer" ? ", whole" : ""}); set to ${n}.`);
       return n;
     }
     case "boolean":
@@ -2070,7 +2185,8 @@ function read(value, schema, path, problems) {
         problems.push(`${path} ${JSON.stringify(value)} is not valid${schema.enum ? `; use one of ${schema.enum.join(", ")}` : ""}; dropped.`);
         return void 0;
       }
-      return schema.maxLength !== void 0 ? value.slice(0, schema.maxLength) : value;
+      const s = schema.pattern === "^#[0-9a-fA-F]{6}$" ? value.toLowerCase() : value;
+      return schema.maxLength !== void 0 ? s.slice(0, schema.maxLength) : s;
     }
     case "array": {
       if (!Array.isArray(value)) {
@@ -2139,14 +2255,14 @@ function normalizeBrushSpec(raw, problems = []) {
   else if (raw.kind === void 0) kind = tool ? "tool" : "mark";
   else throw new Error(`Brush "${raw.id}" kind ${JSON.stringify(raw.kind)} is not valid: use mark (lays a material) or tool (works on paint already down).`);
   if (kind === "tool" && !tool) throw new Error(`Brush "${raw.id}" is a tool and needs tool: one of ${BRUSH_TOOLS.join(", ")}.`);
-  const { colour: rawColour, marks: rawMarks, kind: _k, id: _i, name: _n, tool: _t, ...rest } = raw;
+  const { colour: rawColour, marks: rawMarks, ferro: rawFerro, kind: _k, id: _i, name: _n, tool: _t, ...rest } = raw;
   if (typeof rest.fluorescence === "number" && Number.isFinite(rest.fluorescence)) rest.fluorescence = { amount: rest.fluorescence };
   const out = readObject(rest, BRUSH_JSON_SCHEMA, "brush", problems);
   if (out.thermochromic?.hotColor) out.thermochromic.hotColor = out.thermochromic.hotColor.toLowerCase();
   const brush = { id: raw.id, name, ...out, kind, ...tool ? { tool } : {}, tip: out.tip ?? { shape: "round" } };
   const ordered = () => {
-    const { id, name: n, description, tags, kind: k, medium, variety, tool: t, tip, marks, dynamics, behaviour, light, fluorescence, thermochromic, iridescence, ghost, mutation, motion, colour } = brush;
-    const all = { id, name: n, description, tags, kind: k, medium, variety, tool: t, tip, marks, dynamics, behaviour, light, fluorescence, thermochromic, iridescence, ghost, mutation, motion, colour };
+    const { id, name: n, description, tags, kind: k, medium, variety, tool: t, tip, marks, dynamics, behaviour, light, fluorescence, thermochromic, iridescence, ghost, mutation, ferro, motion, livePatterns, colour } = brush;
+    const all = { id, name: n, description, tags, kind: k, medium, variety, tool: t, tip, marks, dynamics, behaviour, light, fluorescence, thermochromic, iridescence, ghost, mutation, ferro, motion, livePatterns, colour };
     return Object.fromEntries(Object.entries(all).filter(([, v]) => v !== void 0));
   };
   if (!out.tip) problems.push("tip is missing; a round tip is used.");
@@ -2160,6 +2276,11 @@ function normalizeBrushSpec(raw, problems = []) {
     if (!schema) problems.push(`marks.kind ${JSON.stringify(k)} is not valid; use continuous, scatter, particles or objects. marks dropped.`);
     else brush.marks = readObject(rawMarks, schema, "brush.marks", problems);
   }
+  if (rawFerro !== void 0) {
+    const ferroObj = typeof rawFerro === "number" ? { amount: rawFerro } : rawFerro;
+    const f2 = readObject(ferroObj, BRUSH_FACET_SCHEMAS.ferro, "brush.ferro", problems);
+    if (f2 && Object.keys(f2).length) brush.ferro = f2;
+  }
   if (rawColour !== void 0) {
     const c = readObject(rawColour, { ...BRUSH_FACET_SCHEMAS.colour, properties: { own: BRUSH_FACET_SCHEMAS.colour.properties.own, default: {}, palette: {} } }, "brush.colour", problems);
     if (c) {
@@ -2194,6 +2315,10 @@ function normalizeBrushSpec(raw, problems = []) {
       drop("marks", "tools lay no marks");
       delete brush.marks;
     }
+    if (brush.ferro) {
+      drop("ferro", "tools lay no ferrofluid");
+      delete brush.ferro;
+    }
     if (brush.iridescence) {
       drop("iridescence", "tools lay no film");
       delete brush.iridescence;
@@ -2279,6 +2404,10 @@ function normalizeBrushSpec(raw, problems = []) {
       delete b.exchange;
     }
   }
+  if (brush.livePatterns && (kind !== "mark" || brush.behaviour?.surface !== "wet" || brush.marks?.kind === "particles" || brush.marks?.kind === "objects" || brush.tip.shape === "bristle")) {
+    drop("livePatterns", "only wet paint brushes grow live patterns (set behaviour.surface to wet)");
+    delete brush.livePatterns;
+  }
   if (brush.ghost) {
     if (kind === "tool" || brush.behaviour?.surface !== "wet") {
       drop("ghost", "it needs a mark brush with behaviour.surface wet");
@@ -2318,7 +2447,9 @@ var PAINT_PROFILE = {
   tilt: "full",
   tipGrain: "full",
   dabCount: "full",
-  iridescence: "full"
+  livePatterns: "full",
+  iridescence: "full",
+  ferro: "full"
 };
 var IMAGE_PROFILE = {
   id: "image",
@@ -2395,6 +2526,7 @@ function checkBrush(brush, profile) {
   feature(profile.exchange, !ex?.reservoir && (nonZero(ex?.pickup) || !!ex?.dirty), "behaviour.exchange", "picking paint up", "Remove behaviour.exchange.");
   feature(profile.grain, nonZero(brush.behaviour?.grain), "behaviour.grain", "paper grain", "Set behaviour.grain to 0.");
   feature(profile.light, nonZero(brush.light?.amount), "light", "light paint (glow and spill)", "Remove light (or set light.amount to 0).");
+  feature(profile.livePatterns ?? "none", Boolean(brush.livePatterns), "livePatterns", "live reaction-diffusion patterns", "Remove livePatterns.");
   const smartInks = profile.id === "paint" ? "full" : "none";
   feature(smartInks, nonZero(brush.fluorescence?.amount), "fluorescence", "UV-fluorescent ink", "Remove fluorescence (or set fluorescence.amount to 0).");
   feature(smartInks, Boolean(brush.thermochromic?.hotColor), "thermochromic", "thermochromic ink", "Remove thermochromic.");
@@ -2408,6 +2540,7 @@ function checkBrush(brush, profile) {
     else if (nonZero(ex?.pickup) || !!ex?.dirty) add("mutation", "error", "Mutation brushes must lay their own colour without picking up paint from beneath.", "Remove behaviour.exchange (or set pickup to 0 and dirty to false), or remove mutation.");
     else if (surface === "wet" && nonZero(brush.light?.amount)) add("mutation", "error", "Wet mutation brushes use the wet light channel as their fade tracer.", "Remove light (or set light.amount to 0), or remove mutation.");
   }
+  feature(profile.ferro ?? "none", nonZero(brush.ferro?.amount), "ferro", "ferrofluid spikes and magnets", "Remove ferro (or set ferro.amount to 0).");
   const m = brush.motion;
   feature(profile.motion, !!m && (!!m.live || nonZero(m.waveSpeed) || m.fps !== void 0), "motion", "animation", "Remove motion.");
   const d = brush.dynamics ?? {};
@@ -2458,8 +2591,12 @@ function degrade(brush, profile, options = {}) {
         delete b.behaviour.surface;
         delete b.behaviour.wet;
         delete b.behaviour.thick;
+        delete b.livePatterns;
         delete b.ghost;
         break;
+      case "livePatterns":
+        delete b.livePatterns;
+        break;
       case "ghost":
         delete b.ghost;
         break;
@@ -2493,6 +2630,9 @@ function degrade(brush, profile, options = {}) {
       case "iridescence":
         delete b.iridescence;
         break;
+      case "ferro":
+        delete b.ferro;
+        break;
       case "motion":
         delete b.motion;
         break;
@@ -2880,6 +3020,8 @@ export {
   normalizeGhost,
   DEFAULT_MUTATION,
   normalizeMutation,
+  DEFAULT_FERRO,
+  normalizeFerro,
   normalizeImpasto,
   MULTI_COLOR_MODES,
   DEFAULT_MULTI_COLOR,