@wave3d/core 0.9.0 → 0.11.0

package/dist/studio/randomize.js.map

@@ -1 +1 @@
-{"version":3,"file":"randomize.js","names":[],"sources":["../../src/studio/randomize.ts"],"sourcesContent":["/**\n * The \"Randomize\" helpers: `randomizeConfig` (\"Tasteful Randomize\") plus the per-section randomizers\n * the studio wires to each folder's 🎲. Studio-facing (not part of the renderer core), exposed via\n * the `@wave3d/core/studio` entry.\n */\nimport { clamp, roundTo } from \"../util/math\";\nimport type {\n  StudioConfig,\n  WaveConfig,\n  MeshGradientPoint,\n  ColorStop,\n  GradientType,\n} from \"../config/model\";\n\nconst RANDOM_PALETTES: string[][] = [\n  [\"#9bb0ff\", \"#ffb14e\", \"#ff6aa8\", \"#b15cff\", \"#6f7bff\"],\n  [\"#ffd166\", \"#ff6b6b\", \"#c44dff\", \"#4d79ff\", \"#22d3ee\"],\n  [\"#f97316\", \"#ec4899\", \"#8b5cf6\", \"#3b82f6\", \"#06b6d4\"],\n  [\"#00f5d4\", \"#00bbf9\", \"#9b5de5\", \"#f15bb5\", \"#fee440\"],\n  [\"#7c3aed\", \"#db2777\", \"#f59e0b\", \"#10b981\", \"#06b6d4\"],\n];\n\nfunction rand(min: number, max: number): number {\n  return min + Math.random() * (max - min);\n}\n\nfunction pick<T>(arr: T[]): T {\n  return arr[Math.floor(Math.random() * arr.length)];\n}\n\n/** \"Tasteful Randomize\": keep the scene (background, camera, lights, quality) and randomize the\n *  post-fx plus every wave independently — so a multi-wave stack becomes visibly varied.\n *  The camera is deliberately left alone so the result always lands in view. */\nexport function randomizeConfig(base: StudioConfig): StudioConfig {\n  const cfg = structuredClone(base);\n  cfg.grain = r2(rand(0, 1.5));\n  cfg.blur = r3(rand(0, 0.02));\n  for (const s of cfg.waves) randomizeWave(s);\n  return cfg;\n}\n\n/** Randomize a whole wave: colour, shape (displacement/twist), transform, finish + the\n *  compositing knobs (speed/opacity/seed/blend). Used by each wave's 🎲 and by \"Tasteful Randomize\". */\nexport function randomizeWave(s: WaveConfig): void {\n  randomizeGradient(s);\n  randomizeColor(s);\n  randomizeSpine(s);\n  randomizeTransform(s);\n  randomizeTwist(s);\n  randomizeFinish(s);\n  s.speed = r2(rand(0.02, 0.15));\n  s.opacity = r2(rand(0.6, 1));\n  s.seed = r2(rand(0, 12));\n  // Bias to the vivid squared blend; occasionally normal/additive (skip multiply — it muddies\n  // the wave on light/transparent backgrounds).\n  s.blendMode = pick([\"squared\", \"squared\", \"normal\", \"additive\"]);\n}\n\n// ---- Per-section randomizers (each mutates only its own fields, in place) ----\n\nfunction r2(x: number): number {\n  return roundTo(x, 2);\n}\nfunction r3(x: number): number {\n  return roundTo(x, 3);\n}\n\nconst LIGHT_TINTS = [\"#ffffff\", \"#ffffff\", \"#fff0e0\", \"#e2e8ff\", \"#ffe2f0\", \"#e2fff4\", \"#fff6cc\"];\n\n/** Random sorted positions in [0,1] with the ends pinned to 0 and 1. */\nfunction randomSortedPositions(n: number): number[] {\n  if (n <= 1) return [0];\n  if (n === 2) return [0, 1];\n  const inner = Array.from({ length: n - 2 }, () => r2(rand(0.06, 0.94))).sort((a, b) => a - b);\n  return [0, ...inner, 1];\n}\n\nfunction randomMeshPoints(colors: string[]): MeshGradientPoint[] {\n  return colors.map((color) => ({\n    color,\n    x: r2(rand(0.08, 0.92)),\n    y: r2(rand(0.08, 0.92)),\n    influence: r2(rand(0.5, 0.95)),\n  }));\n}\n\nfunction randomStops(colors: string[]): ColorStop[] {\n  const positions = randomSortedPositions(colors.length);\n  return colors.map((color, i) => ({ color, pos: positions[i] }));\n}\n\nexport function randomizeGradient(c: WaveConfig): void {\n  const colors = pick(RANDOM_PALETTES);\n  const count = clamp(Math.round(rand(3, colors.length)), 3, colors.length);\n  const chosen = colors.slice(0, count);\n  c.palette = randomStops(chosen);\n  // Bias toward linear, occasionally radial/conic/mesh for variety.\n  c.gradientType = pick([\n    \"linear\",\n    \"linear\",\n    \"linear\",\n    \"radial\",\n    \"conic\",\n    \"mesh\",\n  ] as GradientType[]);\n  c.gradientAngle = Math.round(rand(0, 180));\n  c.gradientShift = r2(rand(0, 0.4)); // 2D warp\n  // Also refresh the mesh field + edge tint so the whole colour section changes regardless of the\n  // active source (both are inert unless gradientType is \"mesh\" / the source is \"stops\").\n  c.meshGradientPoints = randomMeshPoints(colors);\n  c.meshGradientSoftness = r2(rand(0.45, 0.85));\n  c.paletteEdgeColor = pick(chosen);\n  c.paletteEdgeAmount = r2(rand(0, 0.5));\n  // Colour engine: mostly the editable stops (as a 2D texture or procedurally), occasionally the\n  // baked hero LUT. Clear any loaded custom image/video so the picked source actually shows.\n  c.paletteImageUrl = undefined;\n  c.paletteVideoUrl = undefined;\n  const engine = pick([\"stops-tex\", \"stops-tex\", \"procedural\", \"hero\"]);\n  c.usePaletteTexture = engine !== \"procedural\";\n  c.paletteSource = engine === \"hero\" ? \"hero\" : \"stops\";\n  // Occasional slow colour flow along the ribbon (inert on mesh / procedural palettes).\n  c.paletteDriftX = rand(0, 1) < 0.25 ? r2(rand(-0.25, 0.25)) : 0;\n  c.paletteDriftY = 0;\n}\n\n/** \"Background\" folder: a fresh random gradient (linear/radial/conic) or mesh backdrop. Left out\n *  of \"Tasteful Randomize\", which deliberately preserves the background. */\nexport function randomizeBackground(c: StudioConfig): void {\n  const colors = pick(RANDOM_PALETTES);\n  c.transparentBackground = false;\n  c.backgroundMode = \"gradient\";\n  c.backgroundGradientType = pick([\"linear\", \"radial\", \"conic\", \"mesh\"] as GradientType[]);\n  c.backgroundGradientAngle = Math.round(rand(0, 360));\n  c.background = colors[0]; // matte fallback (shown only if a gradient ever fails to cover)\n  if (c.backgroundGradientType === \"mesh\") {\n    c.backgroundMeshPoints = randomMeshPoints(colors);\n    c.backgroundMeshSoftness = r2(rand(0.45, 0.85));\n  } else {\n    c.backgroundGradientSource = \"stops\";\n    c.backgroundPalette = randomStops(colors);\n  }\n}\n\n/** \"Post FX\" folder: enable a single random effect (the rest off) with random shape params — one\n *  post effect reads cleaner than a stack, so this stays tasteful. */\nexport function randomizePostFx(c: StudioConfig): void {\n  c.dither = 0;\n  c.halftone = 0;\n  c.halftoneCmyk = 0;\n  c.heatmap = 0;\n  c.paperTexture = 0;\n  c.innerLight = 0;\n  switch (pick([\"dither\", \"halftone\", \"cmyk\", \"heatmap\", \"paper\", \"light\"])) {\n    case \"dither\":\n      c.dither = r2(rand(0.6, 1));\n      c.ditherScale = Math.round(rand(1, 5));\n      c.ditherSteps = Math.round(rand(2, 6));\n      break;\n    case \"halftone\":\n      c.halftone = r2(rand(0.7, 1));\n      c.halftoneCell = r2(rand(4, 12));\n      c.halftoneAngle = r2(rand(0, 1.2));\n      break;\n    case \"cmyk\":\n      c.halftoneCmyk = r2(rand(0.7, 1));\n      c.halftoneCmykCell = r2(rand(4, 10));\n      break;\n    case \"heatmap\":\n      c.heatmap = r2(rand(0.6, 1));\n      break;\n    case \"paper\":\n      c.paperTexture = r2(rand(0.4, 0.9));\n      c.paperTextureScale = r2(rand(1, 4));\n      break;\n    case \"light\":\n      c.innerLight = r2(rand(0.4, 0.9));\n      c.innerLightDensity = r2(rand(0.3, 0.8));\n      c.innerLightDecay = r3(rand(0.9, 0.98));\n      c.innerLightX = r2(rand(0.2, 0.8));\n      c.innerLightY = r2(rand(0, 0.4));\n      break;\n  }\n}\n\n/** \"Color\" folder: hue / contrast / saturation grading. */\nexport function randomizeColor(c: WaveConfig): void {\n  c.hueShift = Math.round(rand(0, 360));\n  c.colorContrast = r2(rand(0.9, 1.3));\n  c.colorSaturation = r2(rand(0.8, 1.35));\n}\n\nexport function randomizeSpine(c: WaveConfig): void {\n  // Wider frequency spread than before so a re-roll is actually visible (the old range barely\n  // moved). Amount takes either sign so the ribbon folds either way.\n  c.displaceFrequency = { x: r3(rand(0.002, 0.016)), y: r3(rand(0.004, 0.02)) };\n  c.displaceAmount = r2(rand(3, 10)) * pick([1, -1]);\n  // Occasionally layer a finer second octave for a richer, two-scale shape.\n  if (rand(0, 1) < 0.35) {\n    c.detailFrequency = r3(rand(0.03, 0.08));\n    c.detailAmount = r2(rand(0.8, 2.5)) * pick([1, -1]);\n  } else {\n    c.detailAmount = 0;\n  }\n}\n\nexport function randomizeTransform(c: WaveConfig): void {\n  c.rotation = { x: r2(rand(-20, 5)), y: r2(rand(-25, 10)), z: r2(rand(-170, -150)) };\n  // Full scale (×10) — the mesh lives in the tens, not fractions.\n  const s = r2(rand(6, 14));\n  c.scale = { x: s, y: s, z: r2(s * rand(0.6, 0.8)) };\n  // z is modest — the ortho camera barely shows depth, and a big z can clip the near/far planes.\n  c.position = { x: r2(rand(-60, 60)), y: r2(rand(-60, 60)), z: r2(rand(-20, 20)) };\n}\n\nexport function randomizeTwist(c: WaveConfig): void {\n  c.twistFrequency = { x: r3(rand(-0.5, 0.5)), y: r3(rand(-0.3, 0.5)), z: r3(rand(-1.6, -0.6)) };\n  c.twistPower = { x: r2(rand(2, 6)), y: r2(rand(2, 6)), z: r2(rand(2, 7)) };\n  c.twistMotion = rand(0, 1) < 0.25; // occasionally enable the breathing wobble\n}\n\n/** A wave's surface finish: fibers/texture + roundness/crease/edge. Grain & blur are scene post-fx\n *  (see randomizeGlobal), so they're not touched here. */\nexport function randomizeFinish(c: WaveConfig): void {\n  c.fiberCount = Math.round(rand(200, 900));\n  c.fiberStrength = r2(rand(0.1, 0.35));\n  c.texture = r2(rand(0, 0.35));\n  c.roundness = r2(rand(0.3, 0.8)); // rounded-solid shading\n  c.sheen = r2(rand(0.2, 0.9));\n  c.iridescence = rand(0, 1) < 0.35 ? r2(rand(0.15, 0.6)) : 0; // occasional thin-film sheen\n  c.creaseLight = r2(rand(0.4, 1.0)); // crease strength (where streaks appear)\n  c.creaseSharpness = r2(rand(0.45, 0.8));\n  c.creaseSoftness = r2(rand(0.8, 1.2));\n  c.edgeFade = r2(rand(0, 0.08));\n  c.edgeFeather = r2(rand(0.03, 0.22)); // crisp graphic ↔ soft vapor edges\n  c.depthTint = rand(0, 1) < 0.3 ? r2(rand(0.2, 0.6)) : 0; // occasional atmospheric depth fade\n  // Wireframe line params (inert unless theme is \"wireframe\") — randomized too so a wireframe\n  // wave's Finish 🎲 refreshes its whole look, not just the solid-shader knobs.\n  c.lineAmount = Math.round(rand(200, 900));\n  c.lineThickness = r2(rand(0.5, 2));\n  c.lineDerivativePower = r2(rand(0.4, 1.2));\n  c.maxWidth = Math.round(rand(400, 1600));\n  c.theme = rand(0, 1) < 0.2 ? \"wireframe\" : \"solid\"; // occasionally flip the material\n}\n\nexport function randomizeLights(c: StudioConfig): void {\n  c.ambient = r2(rand(0.25, 0.6));\n  for (const l of c.lights) {\n    l.position = { x: r2(rand(-1000, 1000)), y: r2(rand(-500, 1000)), z: r2(rand(-500, 1200)) };\n    l.intensity = r2(rand(0.5, 1.6));\n    l.color = pick(LIGHT_TINTS);\n  }\n}\n\n/** Scene knobs: the post-fx (grain/blur) + camera framing (zoom). */\nexport function randomizeGlobal(c: StudioConfig): void {\n  c.grain = r2(rand(0, 1.5));\n  c.blur = r3(rand(0, 0.02));\n  // Ortho: vary the zoom (framing), keep the camera pose/target — distance doesn't size it.\n  c.cameraZoom = r2(rand(1.2, 2.6));\n}\n"],"mappings":"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"}
+{"version":3,"file":"randomize.js","names":[],"sources":["../../src/studio/randomize.ts"],"sourcesContent":["/**\n * The \"Randomize\" helpers: `randomizeConfig` (\"Tasteful Randomize\") plus the per-section randomizers\n * the studio wires to each folder's 🎲. Studio-facing (not part of the renderer core), exposed via\n * the `@wave3d/core/studio` entry.\n */\nimport { clamp, roundTo } from \"../util/math\";\nimport type {\n  StudioConfig,\n  WaveConfig,\n  MeshGradientPoint,\n  ColorStop,\n  GradientType,\n} from \"../config/model\";\n\nconst RANDOM_PALETTES: string[][] = [\n  [\"#9bb0ff\", \"#ffb14e\", \"#ff6aa8\", \"#b15cff\", \"#6f7bff\"],\n  [\"#ffd166\", \"#ff6b6b\", \"#c44dff\", \"#4d79ff\", \"#22d3ee\"],\n  [\"#f97316\", \"#ec4899\", \"#8b5cf6\", \"#3b82f6\", \"#06b6d4\"],\n  [\"#00f5d4\", \"#00bbf9\", \"#9b5de5\", \"#f15bb5\", \"#fee440\"],\n  [\"#7c3aed\", \"#db2777\", \"#f59e0b\", \"#10b981\", \"#06b6d4\"],\n];\n\nfunction rand(min: number, max: number): number {\n  return min + Math.random() * (max - min);\n}\n\nfunction pick<T>(arr: T[]): T {\n  return arr[Math.floor(Math.random() * arr.length)];\n}\n\n/** \"Tasteful Randomize\": keep the scene (background, camera, lights, quality) and randomize the\n *  post-fx plus every wave independently — so a multi-wave stack becomes visibly varied.\n *  The camera is deliberately left alone so the result always lands in view. */\nexport function randomizeConfig(base: StudioConfig): StudioConfig {\n  const cfg = structuredClone(base);\n  cfg.grain = r2(rand(0, 1.5));\n  cfg.blur = r3(rand(0, 0.02));\n  for (const s of cfg.waves) randomizeWave(s);\n  return cfg;\n}\n\n/** Randomize a whole wave: colour, shape (displacement/twist), transform, finish + the\n *  compositing knobs (speed/opacity/seed/blend). Used by each wave's 🎲 and by \"Tasteful Randomize\". */\nexport function randomizeWave(s: WaveConfig): void {\n  randomizeGradient(s);\n  randomizeColor(s);\n  randomizeSpine(s);\n  randomizeTransform(s);\n  randomizeTwist(s);\n  randomizeFinish(s);\n  s.speed = r2(rand(0.02, 0.15));\n  s.opacity = r2(rand(0.6, 1));\n  s.seed = r2(rand(0, 12));\n  // Bias to the vivid squared blend; occasionally normal/additive (skip multiply — it muddies\n  // the wave on light/transparent backgrounds).\n  s.blendMode = pick([\"squared\", \"squared\", \"normal\", \"additive\"]);\n}\n\n// ---- Per-section randomizers (each mutates only its own fields, in place) ----\n\nfunction r2(x: number): number {\n  return roundTo(x, 2);\n}\nfunction r3(x: number): number {\n  return roundTo(x, 3);\n}\n\nconst LIGHT_TINTS = [\"#ffffff\", \"#ffffff\", \"#fff0e0\", \"#e2e8ff\", \"#ffe2f0\", \"#e2fff4\", \"#fff6cc\"];\n\n/** Random sorted positions in [0,1] with the ends pinned to 0 and 1. */\nfunction randomSortedPositions(n: number): number[] {\n  if (n <= 1) return [0];\n  if (n === 2) return [0, 1];\n  const inner = Array.from({ length: n - 2 }, () => r2(rand(0.06, 0.94))).sort((a, b) => a - b);\n  return [0, ...inner, 1];\n}\n\nfunction randomMeshPoints(colors: string[]): MeshGradientPoint[] {\n  return colors.map((color) => ({\n    color,\n    x: r2(rand(0.08, 0.92)),\n    y: r2(rand(0.08, 0.92)),\n    influence: r2(rand(0.5, 0.95)),\n  }));\n}\n\nfunction randomStops(colors: string[]): ColorStop[] {\n  const positions = randomSortedPositions(colors.length);\n  return colors.map((color, i) => ({ color, pos: positions[i] }));\n}\n\nexport function randomizeGradient(c: WaveConfig): void {\n  const colors = pick(RANDOM_PALETTES);\n  const count = clamp(Math.round(rand(3, colors.length)), 3, colors.length);\n  const chosen = colors.slice(0, count);\n  c.palette = randomStops(chosen);\n  // Bias toward linear, occasionally radial/conic/mesh for variety.\n  c.gradientType = pick([\n    \"linear\",\n    \"linear\",\n    \"linear\",\n    \"radial\",\n    \"conic\",\n    \"mesh\",\n  ] as GradientType[]);\n  c.gradientAngle = Math.round(rand(0, 180));\n  c.gradientShift = r2(rand(0, 0.4)); // 2D warp\n  // Also refresh the mesh field + edge tint so the whole colour section changes regardless of the\n  // active source (both are inert unless gradientType is \"mesh\" / the source is \"stops\").\n  c.meshGradientPoints = randomMeshPoints(colors);\n  c.meshGradientSoftness = r2(rand(0.45, 0.85));\n  c.paletteEdgeColor = pick(chosen);\n  c.paletteEdgeAmount = r2(rand(0, 0.5));\n  // Colour engine: mostly the editable stops (as a 2D texture or procedurally), occasionally the\n  // baked hero LUT. Clear any loaded custom image/video so the picked source actually shows.\n  c.paletteImageUrl = undefined;\n  c.paletteVideoUrl = undefined;\n  const engine = pick([\"stops-tex\", \"stops-tex\", \"procedural\", \"hero\"]);\n  c.usePaletteTexture = engine !== \"procedural\";\n  c.paletteSource = engine === \"hero\" ? \"hero\" : \"stops\";\n  // Occasional slow colour flow along the ribbon (inert on mesh / procedural palettes).\n  c.paletteDriftX = rand(0, 1) < 0.25 ? r2(rand(-0.25, 0.25)) : 0;\n  c.paletteDriftY = 0;\n}\n\n/** \"Background\" folder: a fresh random gradient (linear/radial/conic) or mesh backdrop. Left out\n *  of \"Tasteful Randomize\", which deliberately preserves the background. */\nexport function randomizeBackground(c: StudioConfig): void {\n  const colors = pick(RANDOM_PALETTES);\n  c.transparentBackground = false;\n  c.backgroundMode = \"gradient\";\n  c.backgroundGradientType = pick([\"linear\", \"radial\", \"conic\", \"mesh\"] as GradientType[]);\n  c.backgroundGradientAngle = Math.round(rand(0, 360));\n  c.background = colors[0]; // matte fallback (shown only if a gradient ever fails to cover)\n  if (c.backgroundGradientType === \"mesh\") {\n    c.backgroundMeshPoints = randomMeshPoints(colors);\n    c.backgroundMeshSoftness = r2(rand(0.45, 0.85));\n  } else {\n    c.backgroundGradientSource = \"stops\";\n    c.backgroundPalette = randomStops(colors);\n  }\n}\n\n/** \"Post FX\" folder: enable a single random effect (the rest off) with random shape params — one\n *  post effect reads cleaner than a stack, so this stays tasteful. */\nexport function randomizePostFx(c: StudioConfig): void {\n  c.dither = 0;\n  c.halftone = 0;\n  c.halftoneCmyk = 0;\n  c.heatmap = 0;\n  c.paperTexture = 0;\n  c.innerLight = 0;\n  switch (pick([\"dither\", \"halftone\", \"cmyk\", \"heatmap\", \"paper\", \"light\"])) {\n    case \"dither\":\n      c.dither = r2(rand(0.6, 1));\n      c.ditherScale = Math.round(rand(1, 5));\n      c.ditherSteps = Math.round(rand(2, 6));\n      break;\n    case \"halftone\":\n      c.halftone = r2(rand(0.7, 1));\n      c.halftoneCell = r2(rand(4, 12));\n      c.halftoneAngle = r2(rand(0, 1.2));\n      break;\n    case \"cmyk\":\n      c.halftoneCmyk = r2(rand(0.7, 1));\n      c.halftoneCmykCell = r2(rand(4, 10));\n      break;\n    case \"heatmap\":\n      c.heatmap = r2(rand(0.6, 1));\n      break;\n    case \"paper\":\n      c.paperTexture = r2(rand(0.4, 0.9));\n      c.paperTextureScale = r2(rand(1, 4));\n      break;\n    case \"light\":\n      c.innerLight = r2(rand(0.4, 0.9));\n      c.innerLightDensity = r2(rand(0.3, 0.8));\n      c.innerLightDecay = r3(rand(0.9, 0.98));\n      c.innerLightX = r2(rand(0.2, 0.8));\n      c.innerLightY = r2(rand(0, 0.4));\n      break;\n  }\n}\n\n/** \"Color\" folder: hue / contrast / saturation grading. */\nexport function randomizeColor(c: WaveConfig): void {\n  c.hueShift = Math.round(rand(0, 360));\n  c.colorContrast = r2(rand(0.9, 1.3));\n  c.colorSaturation = r2(rand(0.8, 1.35));\n}\n\nexport function randomizeSpine(c: WaveConfig): void {\n  // Wider frequency spread than before so a re-roll is actually visible (the old range barely\n  // moved). Amount takes either sign so the ribbon folds either way.\n  c.displaceFrequency = { x: r3(rand(0.002, 0.016)), y: r3(rand(0.004, 0.02)) };\n  c.displaceAmount = r2(rand(3, 10)) * pick([1, -1]);\n  // Occasionally layer a finer second octave for a richer, two-scale shape.\n  if (rand(0, 1) < 0.35) {\n    c.detailFrequency = r3(rand(0.03, 0.08));\n    c.detailAmount = r2(rand(0.8, 2.5)) * pick([1, -1]);\n  } else {\n    c.detailAmount = 0;\n  }\n}\n\nexport function randomizeTransform(c: WaveConfig): void {\n  c.rotation = { x: r2(rand(-20, 5)), y: r2(rand(-25, 10)), z: r2(rand(-170, -150)) };\n  // Full scale (×10) — the mesh lives in the tens, not fractions.\n  const s = r2(rand(6, 14));\n  c.scale = { x: s, y: s, z: r2(s * rand(0.6, 0.8)) };\n  // z is modest — the ortho camera barely shows depth, and a big z can clip the near/far planes.\n  c.position = { x: r2(rand(-60, 60)), y: r2(rand(-60, 60)), z: r2(rand(-20, 20)) };\n}\n\nexport function randomizeTwist(c: WaveConfig): void {\n  c.twistFrequency = { x: r3(rand(-0.5, 0.5)), y: r3(rand(-0.3, 0.5)), z: r3(rand(-1.6, -0.6)) };\n  c.twistPower = { x: r2(rand(2, 6)), y: r2(rand(2, 6)), z: r2(rand(2, 7)) };\n  c.twistMotion = rand(0, 1) < 0.25; // occasionally enable the breathing wobble\n}\n\n/** A wave's surface finish: fibers/texture + roundness/crease/edge. Grain & blur are scene post-fx\n *  (see randomizeGlobal), so they're not touched here. */\nexport function randomizeFinish(c: WaveConfig): void {\n  c.fiberCount = Math.round(rand(200, 900));\n  c.fiberStrength = r2(rand(0.1, 0.35));\n  c.texture = r2(rand(0, 0.35));\n  c.roundness = r2(rand(0.3, 0.8)); // rounded-solid shading\n  c.sheen = r2(rand(0.2, 0.9));\n  c.iridescence = rand(0, 1) < 0.35 ? r2(rand(0.15, 0.6)) : 0; // occasional thin-film sheen\n  c.creaseLight = r2(rand(0.4, 1.0)); // crease strength (where streaks appear)\n  c.creaseSharpness = r2(rand(0.45, 0.8));\n  c.creaseSoftness = r2(rand(0.8, 1.2));\n  c.edgeFade = r2(rand(0, 0.08));\n  c.edgeFeather = r2(rand(0.03, 0.22)); // crisp graphic ↔ soft vapor edges\n  c.depthTint = rand(0, 1) < 0.3 ? r2(rand(0.2, 0.6)) : 0; // occasional atmospheric depth fade\n  // Wireframe line params (inert unless theme is \"wireframe\") — randomized too so a wireframe\n  // wave's Finish 🎲 refreshes its whole look, not just the solid-shader knobs.\n  c.lineAmount = Math.round(rand(200, 900));\n  c.lineThickness = r2(rand(0.5, 2));\n  c.lineDerivativePower = r2(rand(0.4, 1.2));\n  c.theme = rand(0, 1) < 0.2 ? \"wireframe\" : \"solid\"; // occasionally flip the material\n}\n\nexport function randomizeLights(c: StudioConfig): void {\n  c.ambient = r2(rand(0.25, 0.6));\n  for (const l of c.lights) {\n    l.position = { x: r2(rand(-1000, 1000)), y: r2(rand(-500, 1000)), z: r2(rand(-500, 1200)) };\n    l.intensity = r2(rand(0.5, 1.6));\n    l.color = pick(LIGHT_TINTS);\n  }\n}\n\n/** Scene knobs: the post-fx (grain/blur) + camera framing (zoom). */\nexport function randomizeGlobal(c: StudioConfig): void {\n  c.grain = r2(rand(0, 1.5));\n  c.blur = r3(rand(0, 0.02));\n  // Ortho: vary the zoom (framing), keep the camera pose/target — distance doesn't size it.\n  c.cameraZoom = r2(rand(1.2, 2.6));\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wave3d/core",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Framework-agnostic 3D gradient-wave renderer + config model (the engine behind Wave Studio)",
   "keywords": [
     "animation",

package/skills/wave3d/SKILL.md

@@ -10,7 +10,7 @@ description: >
 metadata:
   type: core
   library: "@wave3d/core"
-  library_version: "0.9.0"
+  library_version: "0.11.0"
 sources:
   - "wave3d/wave3d:README.md"
   - "wave3d/wave3d:packages/core/src/config/model.ts"
@@ -109,9 +109,134 @@ a repeating helix:
 - `helixRoll` rolls the ribbon's own cross-section in step (1 = rigid twisted ribbon), swinging its
   two long edges onto opposite sides of the axis, so **one wave becomes a ladder whose edges are
   both strands**. Add `rungAmount` (wireframe theme) for the rungs between them.
+- `radialCone` (on the radial fan, not the helix) lifts the fan out of its own plane as it spreads,
+  turning the flat plume into a TRUMPET whose combed strands run down the slant into the throat. A
+  helix carries the ribbon around an axis but its WIDTH never follows the slant, so this is the only
+  route to a cone mouth.
+- `radialSwirl` (degrees) lets the fan's ANGLE advance along the band as well as across it. Radius
+  already grows with uv.y, so angle growing with it too is what curls a straight arm into a SPIRAL
+  one wrapping the throat. Narrow the `radialArc` and a few of these, posed a quarter-turn apart,
+  read as one vortex.
 - Both are off at 0, and the helix code path isn't compiled unless `helixRadius` or `helixRoll` is
   non-zero — a wave without one renders byte-identically to before.
 
+**Which shape control to reach for.** They overlap less than they look:
+
+| want                                                                  | use       | why not the other                                                                                                                                                      |
+| --------------------------------------------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| a coil, a spring, a double helix                                      | `helix*`  | it carries the ribbon around an axis WITHOUT banking it, and it is animatable — `helixPhase` / `helixTurns` / `helixRadius` are binding targets, so scroll can spin it |
+| a fan, a plume, a trumpet                                             | `radial*` | it remaps the ribbon's WIDTH to an angle; a path only moves the centreline, so it can never splay a sheet into a sector                                                |
+| anything else: an S-curve, a knot, a ring, a throat, a shape you draw | `path`    | the others bend a centreline that stays put                                                                                                                            |
+
+A path SWEEPS with a transported frame, so it banks into its curves like a
+rollercoaster track; a helix TRANSLATES around an axis, so the ribbon keeps facing the same way. Same
+coil, different object — which is why both stay.
+
+**`path` — the ribbon's centreline, and the one shape control the others cannot substitute for.**
+Everything else deforms a ribbon whose centreline is fixed: the twists rotate it, the helix carries it
+around an axis, the radial fan splays it. So none of them can make a ribbon that changes direction
+more than once, crosses itself, or is wide here and narrow there. A path can, because it IS the
+centreline.
+
+```ts
+path: [
+  { x: -200, y: 0, z: -8 },
+  { x: 0, y: 120, z: 32, width: 0.3, twist: 45 }, // a throat, and a quarter turn of the section
+  { x: 200, y: 0, z: -8 },
+];
+```
+
+- Points are where the centreline goes, in the wave's LOCAL space. The un-pathed ribbon runs
+  x −200 → +200 along the plane z = −8 (the folded geometry's centre), so a straight path there —
+  `straightPath()` — reproduces any wave exactly, twists and all. Absent ⇒ that straight ribbon.
+- `width` per point is what a separate "pinch" knob would be, and `twist` (degrees) rotates the
+  cross-section. Both interpolate smoothly between points.
+- A path whose LAST point sits on its FIRST is a closed ring. That is the whole declaration — there
+  is no `closed` flag, because the points already say it.
+- `arcPath(turns)` builds one: `arcPath(1)` is a closed ring whose radius comes from the ribbon's own
+  length, `arcPath(0.35)` an open curve.
+- It is swept by ARC LENGTH with a parallel-transported frame, so the strand comb stays even wherever
+  the points are dragged and the ribbon never flips through an inflection.
+
+**In the studio, double-click a ribbon to shape it.** The primary gesture is dragging the RIBBON
+itself: it moves like putty, with the push falling off smoothly along the length so only the part you
+grabbed follows (hold Shift for a fingertip-tight push instead of a palm). The path densifies itself
+as you sculpt, so there is always something local to move. Control points are still there for
+precision — drag a handle, double-click a point to remove it, double-click the ribbon to insert one —
+and Escape leaves. The gestures are listed on a bar while the mode is on, and the cursor says what is
+under it (grab on the ribbon, pointer on a handle). The wave takes a straight path on entry, so nothing moves until you move it.
+
+**Disintegration (`WaveConfig.dissolve`).** A front sweeps across the wave and eats it away chunk by
+chunk, so the surface CRUMBLES rather than fading. Absent ⇒ intact and byte-identical.
+
+```ts
+dissolve: { amount: 0.3, axis: "screenX", reverse: true, band: 0.55, scale: 150, blocky: 0.75, dust: 1 }
+```
+
+- `amount` is the whole animation: 0 whole, 1 gone, whatever the `band` (fray width). It is a binding
+  target, so `{ source: "scroll", target: "dissolveAmount", to: 1 }` snaps the wave as the page moves.
+- `axis` `"length"` / `"width"` ride the ribbon's own uv; **`"screenX"` / `"screenY"` are a straight
+  line on the canvas**, which is what makes a multi-wave STACK crumble as one object — give every
+  wave the same axis and amount and they share one edge. `reverse` flips which end goes first.
+- `scale` sets how finely the sheet is diced and `blocky` the chunk character (0 organic tatters,
+  1 hard quantized cells).
+- `dust` pins the wave's own `particles` field to that same front: each mote is the chunk that just
+  left, so the dust and the holes are ONE event. Under a screen axis the debris also blows along the
+  sweep instead of radiating in every direction. Pair with `shape: "square"` and `blend: "normal"`
+  for hard dark debris — `blend` defaults to `"additive"`, which can only brighten and so is
+  invisible on a pale page.
+
+**Which way the stripes run is the biggest single decision.** `lineAmount` carves at constant uv.x, so
+each strand runs the ribbon's LENGTH; `rungAmount` carves at constant uv.y, so each crosses its WIDTH.
+On a twisting ribbon the two look nothing alike: along-stripes just follow the flow, while
+across-stripes ARE the twist made visible — they fan wide where the sheet faces the camera, pinch to a
+dense line where it turns edge-on, and sweep as nested arcs through a fold. For a striped-ribbon look,
+reach for rungs first and set `lineThickness: 0` to switch the lengthwise family off. `rungThickness`
+is in PIXELS, so it must come DOWN as `rungAmount` goes up or the strands merge into solid; and past
+~300-400 rungs the periods go sub-pixel in a small embed, where a pixel-width stripe stops being
+stable (it falls back to the strands' analytic duty cycle, which is a flat tone, not detail).
+
+**A wireframe strand is a MASK, not a material — unless you light it.** Its colour comes from its uv
+alone, so it holds one tone wherever the surface turns, which is why a dense wireframe reads as
+hatching however it is posed. `lineLight` (0..1) shades it with the same derivative normal and scene
+`lights` the solid theme uses, AND gives each strand a round cross-section so a specular travels along
+one strand and not its neighbour — which is what separates combed thread from print. One knob, not
+three: shading a flat stripe barely reads, so the rounding is not optional to it. Default 0.
+
+**`lineDerivativePower` decides whether a close-framed wave has any ink.** It scales strand thickness
+by the screen-space uv derivative, which is right for a ribbon seen whole (strands thicken where the
+surface turns away, which reads as light on a curve). But the bigger a sheet gets on screen the
+SMALLER its uv derivative, so framed close the strands thin to pale grey exactly where you want them
+black. Set it to 0 and `lineThickness` alone is the duty cycle, crisp at any zoom.
+
+**Wireframe ink (`theme: "wireframe"`).** The strand is a soft ramp by default, so `lineThickness`
+alone goes from pale hairlines to flat solid without passing through dense ink. `lineSharpness`
+(0..1) steepens it, which turns `lineThickness` into a DUTY CYCLE and gives engraved black strands
+with the background still showing between them; `lineDepthFade` (default 1) turns off the recede
+into the background colour, which a deep or stacked composition needs.
+
+**`lineGapColor` is the one to know about** — it decides what sits BETWEEN the strands, which is most
+of what a wireframe looks like. Absent, the gaps take the page background, so the wave is a window
+onto the page (dark strands, paper between) and, being opaque, the near fold HIDES the far one, which
+is what makes a stack read solid. Give it a dark colour and the ribbon becomes its own body: bright
+combed lines on a dark ground. Set it to `"transparent"` (or an 8-digit hex) and the gaps go clear, so
+stacked folds show through each other — airier, at the cost of that occlusion. Note that `lineAmount` counts strands across the whole of uv.x, which the
+radial fan maps to `radialArc`, so a narrow arc needs a proportionally SMALLER count or the strands
+go sub-pixel and average to grey. `edgeFeather` now applies to the wireframe too — without it a
+ribbon ends at a flat end-cap that reads as a straight cut across the strands.
+
+**Glass (`theme: "glass"`) is a lens over whatever is behind it — so put something there.** The
+sheet draws opaque and samples the frame behind it, bent along its own normal: over a flat page it is
+a silvered ribbon with a bright rim and nothing more; a gradient, an image or another wave behind it
+is what makes it read. The palette only sets the HUE of what gets through — `glassTint` (default
+0.12) and `glassDensity` decide how much — and `blendMode`, `lights`, `fiber*` and noise bands are
+not read at all. The knobs: `glassStrength` (bend at the silhouette, px), `glassChroma` (dispersion),
+`glassRim` / `glassRimPower`, `glassSpec`, `glassIrid` + `glassFilmNm`, `glassFrost` (scatter; under
+~0.1 it is sub-pixel and skipped), `glassCaustic`, `glassLayerGain` (a fold over itself thickens),
+`glassFusion` (two close sheets bend along one merged silhouette), and the liquid trio `glassRipple`
+/ `glassRippleScale` / `glassFlow`. `glassRipple`, `glassStrength` and `glassTint` are binding
+targets.
+
 **React flat props** are a shortcut mapped onto `waves[0]` and the scene:
 `palette` (`string[]` | `ColorStop[]`), `fiberCount`, `fiberStrength`, `sheen`, `iridescence`,
 `displaceAmount`, `speed`, `opacity`, `blendMode`, `theme` → the first wave; `background`,
@@ -200,9 +325,10 @@ Only `blur` and `grain` are bindable from an interaction input; the others are a
 
 ## Presets
 
-14 built-in presets (`@wave3d/core/presets`): **Hero**, **Wave 2**, **Wave 3**, **Wave 4**,
-**Wireframe**, **Neon Dark Multistrand**, **Mesh Gradient**, **Solar Bloom**, **Holographic**,
-**Aurora**, **Palestine**, **Spain**, **Vaporwave Sunset**, **Kaleidoscope**.
+18 built-in presets (`@wave3d/core/presets`): **Hero**, **Wave 2**, **Wave 3**, **Wave 4**,
+**Wireframe**, **Neon Dark Multistrand**, **Mesh Gradient**, **Solar Bloom**, **Latte Ring**,
+**Particle Zoo**, **Holographic**, **Aurora**, **Palestine**, **Spain**, **Vaporwave Sunset**,
+**Corkscrew**, **Disintegration**, **Kaleidoscope**.
 
 - React: `preset="Hero"` (a **string** lazy-imports the presets chunk) or
   `preset={() => PRESETS["Hero"]()}` (a **function** is tree-shakeable — bundles only that preset).
@@ -227,7 +353,18 @@ The shell shows a poster immediately, then crossfades to the live wave.
   `@wave3d/vite/client` for React / `createWave`. Re-snapshots over HMR; `vite build` just uses the
   committed file.
 - **`onFallback(reason)`** fires when the shell keeps the poster instead of upgrading; reasons:
-  `"no-webgl" | "reduced-motion" | "save-data" | "context-lost" | "load-error"`.
+  `"no-webgl" | "software-renderer" | "reduced-motion" | "save-data" | "context-lost" |
+"load-error"`.
+- **`webgl="auto"` upgrades only onto a GPU.** A software rasteriser (SwiftShader, llvmpipe) keeps
+  the poster and reports `"software-renderer"` — it can run the wave, at roughly 2 fps with seconds
+  of blocked main thread, which is worse for the page than the still it already has. Use
+  `webgl="force"` if you want the live render anyway. `probeWebGL()` and `isSoftwareRenderer(gl)`
+  are exported for pages that need the same answer for their own reasons; note that an unreadable
+  renderer string counts as HARDWARE, because the extension is hidden under some privacy settings
+  and guessing "software" there downgrades people silently.
+- **`paused` does not decline the upgrade.** It stops FRAMES: the engine is still fetched, the
+  renderer still builds, ready still fires and the poster is still swapped for a static canvas.
+  `webgl="off"` is the one that keeps the poster and builds nothing.
 - **`onStateChange(state)`**: `"poster" → "loading" → "running"`, or `"fallback"`.
 
 ## Performance