@mkbabb/glass-ui 3.13.0 → 4.0.1

package/dist/components/custom/aurora/composables/runtime.d.ts

@@ -70,8 +70,27 @@ export interface AuroraRuntimeOptions {
      * NOTE: this is the `useAurora` Vue-wrapper contract surface. The imperative
      * `createAurora(...)` runtime throws on eager init failure and — for
      * `instance.arm()` on the deferred path — rethrows from `arm()`.
+     *
+     * BB.W-AURORA-SWRASTER — a SOFTWARE-RASTER fall is NOT a contract violation:
+     * it never reaches `onInitError`. The wedge catch (see {@link createAurora})
+     * recognizes the software-raster signal at arm time, leaves the canvas
+     * un-armed (the placeholder stays the surface), and returns CLEANLY — so a
+     * consumer who pins `mode:"capture"`/`mode:"webgl"` under SwiftShader never
+     * has to wire `onInitError` to avoid the hang. The handler is preserved for
+     * GENUINE violations (a malformed shader, an OOM, a real link failure).
      */
     onInitError?: (err: Error) => void;
+    /**
+     * BB.W-AURORA-SWRASTER — opt OUT of the runtime software-raster wedge catch.
+     * Default `false`: the wedge catch is the safe default — `createAurora`
+     * recognizes a software renderer at arm time and falls cleanly to the
+     * placeholder rather than arming the page-wedging live GL layer. `true` (the
+     * named, recorded escape for a deterministic test that ACCEPTS the cost)
+     * arms WebGL even under a detected software renderer. Mirrors the
+     * `resolveRenderMode` escape of the same name — ONE consumer-facing flag,
+     * threaded through both seams.
+     */
+    forceWebGLUnderSoftwareRaster?: boolean;
 }
 /**
  * The concrete `createAurora` return shape. It IS an {@link AuroraInstance}

package/dist/components/custom/aurora/composables/uniformBridge.d.ts

@@ -27,6 +27,7 @@ export declare const MEDIUM_ID: {
     readonly crayon: 4;
     readonly vangogh: 5;
     readonly "oil-pastel": 6;
+    readonly kuwahara: 7;
 };
 export declare const HUE_PATH_ID: {
     readonly shorter: 0;
@@ -50,6 +51,7 @@ export declare const WARP_ID: {
     readonly fbm: 0;
     readonly cellular: 1;
     readonly hybrid: 2;
+    readonly curl: 3;
 };
 export declare const STROKE_MODE_ID: {
     readonly oil: 0;
@@ -81,7 +83,9 @@ export declare function resolveStrokeModeId(cfg: AuroraConfig): number;
  * `oil-pastel`, `crayon`) FORCE the structure-tensor orientation regardless of the
  * config's `strokeOrient` field — their marks must hug the color zones (the
  * congruent-to-real-works contract). Every other medium honors the config's
- * `strokeOrient` (default `"flow"`).
+ * `strokeOrient` (default `"flow"`). BB.W-AUR-KUWAHARA — `kuwahara` ALSO forces
+ * tensor: the anisotropic Kuwahara kernel is squeezed along the structure-tensor
+ * minor eigenvector, so the orientation source must be the tensor field.
  */
 export declare function resolveStrokeOrientId(cfg: AuroraConfig): number;
 /**

package/dist/components/custom/aurora/composables/uniformBridgeWGPU.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Aurora WGSL uniform bridge — the typed-struct SOURCE OF TRUTH for the WebGPU primary.
+ *
+ * The WGSL `Uniforms` struct (`aurora.wgsl.ts`) and the JS `ArrayBuffer` write offsets
+ * are generated from the SAME layout table here, so a std140-vs-WGSL alignment mismatch
+ * (the parity-ΔE-blowout trap the wave's §Triumvirate names) is structurally impossible:
+ * the field order + the byte offsets are ONE declaration.
+ *
+ * The struct packs every scalar into a vec4 lane + every per-nucleus row / palette stop
+ * into a vec4 so the array stride is the natural 16 bytes (no std140 16-byte-array-stride
+ * surprise). The byte layout (all offsets in bytes, std140-compatible — vec4 align 16):
+ *
+ *   scalars0 : vec4<f32>   off   0   (uTime, uSoftmaxBeta, uValueVariance, uWarpAmount)
+ *   scalars1 : vec4<f32>   off  16   (uWarpScale, uWarpDrift, uSaturation, uPaperGrain)
+ *   scalars2 : vec4<f32>   off  32   (uAlpha, uNucleiDrift, uPaletteDrift, uBreathDepth)
+ *   scalars3 : vec4<f32>   off  48   (uBreathPeriod, uCursorStrength, uCursorRadius, _)
+ *   cursor   : vec4<f32>   off  64   (uCursor.x, uCursor.y, _, _)
+ *   ints0    : vec4<i32>   off  80   (uStopCount, uNucleiCount, uWarpMode, uNoiseOctaves)
+ *   ints1    : vec4<i32>   off  96   (uMedium, uHuePath, _, _)
+ *   palette  : array<vec4<f32>, 8>  off 112  (rgb linear-sRGB stop + pad)
+ *   nuc0     : array<vec4<f32>, 6>  off 240  (pos.x, pos.y, radius, paletteBias)
+ *   nuc1     : array<vec4<f32>, 6>  off 336  (valueBias, driftRadius, driftPhase, elong)
+ *   nuc2     : array<vec4<f32>, 6>  off 432  (angle, _, _, _)
+ *   total    : 528 bytes (16-aligned)
+ *
+ * Y-origin: config authoring is CSS-top-origin (0 = top); the bridge flips Y at the
+ * uniform boundary (`flipY`), exactly as the GLSL `uniformBridge` does.
+ */
+import { type AuroraConfig } from "../constants/presets";
+import type { CursorState } from "./cursorModel";
+/** The total uniform-buffer byte size (16-aligned). */
+export declare const AURORA_WGPU_UNIFORM_BYTES = 528;
+/**
+ * The packed scratch buffer + the dual ArrayBuffer views. A slider drag refills this
+ * in place (no per-frame allocation) — mirroring the GLSL bridge's pre-allocated
+ * upload buffers. The Float32 view writes the float lanes; the Int32 view writes the
+ * two int lanes (a WGSL `i32` shares the buffer at the 16-byte-aligned offsets).
+ */
+export interface AuroraWGPUUniformScratch {
+    buffer: ArrayBuffer;
+    f32: Float32Array;
+    i32: Int32Array;
+    paletteScratch: Float32Array;
+}
+export declare function createAuroraWGPUUniformScratch(): AuroraWGPUUniformScratch;
+/**
+ * Pack an {@link AuroraConfig} + the live cursor + the frame time into the uniform
+ * scratch buffer. The byte layout mirrors the WGSL `Uniforms` struct EXACTLY. Returns
+ * the same scratch (the caller `queue.writeBuffer`s `scratch.buffer`).
+ */
+export declare function packAuroraWGPUUniforms(scratch: AuroraWGPUUniformScratch, cfg: AuroraConfig, cursor: CursorState, timeSec: number): AuroraWGPUUniformScratch;

package/dist/components/custom/aurora/composables/wgpuSetup.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Aurora WGSL setup seam — the WebGPU twin of `glSetup` + `frameLoop`.
+ *
+ * `createAuroraWGPUSetup` returns a `setupWGPU(device, context, format)` callback the
+ * `useGpuSubstrate` picker invokes on the async arm (AND on every device-restore). It
+ * builds the render pipeline (the `aurora.wgsl` full-screen-triangle pass), the uniform
+ * buffer (the `uniformBridgeWGPU` typed-struct source-of-truth), and the bind group, then
+ * returns the substrate's per-frame hooks (`frame`/`shouldContinue`/`resize`/`time`/
+ * `teardown`).
+ *
+ * The render-demand gate + the cursor-advance + the DPR resize mirror the WebGL2
+ * `frameLoop`/`runtime.resize` exactly — the loop is substrate-AGNOSTIC, so the same
+ * `getConfig`/`getReducedMotion`/`cursor` closures drive both backends.
+ */
+import type { WebGPUCanvasFrame } from "../../../../composables/glass/webgpu/useWebGPUCanvas";
+import { type CursorState } from "./cursorModel";
+import type { AuroraConfig } from "../constants/presets";
+export interface AuroraWGPUSetupDeps {
+    canvas: HTMLCanvasElement;
+    cursor: CursorState;
+    getConfig: () => AuroraConfig;
+    getReducedMotion: () => boolean;
+}
+/**
+ * Build the aurora `setupWGPU(device, context, format)` callback. Closes over the
+ * aurora-specific state (cursor/config/reduced-motion) the runtime owns — identical to
+ * the closures the WebGL2 `setup` threads.
+ */
+export declare function createAuroraWGPUSetup(deps: AuroraWGPUSetupDeps): (device: GPUDevice, context: GPUCanvasContext, format: GPUTextureFormat) => WebGPUCanvasFrame;

package/dist/components/custom/aurora/constants/budget.d.ts

@@ -19,6 +19,19 @@
  * after the offscreen-park. Consumed by aurora's + goo-blob's `resize()`.
  */
 export declare const AV_DPR_MAX = 2;
+/**
+ * BB.W-PERF-PRODUCER A′-5 — the aurora decorative-WASH DPR ceiling, SUB-2× and
+ * DISTINCT from the focal goo-blob's {@link AV_DPR_MAX}. The aurora atmosphere is a
+ * heavily-blurred drift background, not a sharp-silhouette creature: backing it at
+ * full-viewport 2× (the value.js LP1 trace: ~2880×1800, ~21.8 MB native heap) is
+ * visually indistinguishable from 1.5× on a drift wash (the per-pixel FBM is
+ * already smoothed below the DPR-2 detail floor), so the 1.5× ceiling quarters the
+ * GPU memory + per-composite raster for no perceptible loss. The FOCAL goo-blob
+ * KEEPS {@link AV_DPR_MAX} = 2 — its silhouette is sharp; only the aurora wash
+ * reads this sub-cap. This is the CPU-side backing-store DIMENSION only; it never
+ * reaches the shader (`aurora.frag` is byte-fenced — the GL fence is absolute).
+ */
+export declare const AV_AURORA_DPR_MAX = 1.5;
 /**
  * The maximum animated metaball nuclei (the goo-blob body + its satellites, or
  * an aurora field's count). The goo-blob shader hard-caps satellites at 4; this
@@ -48,3 +61,11 @@ export declare function clampBudget(value: number, min: number, max: number): nu
  * `1` when `window` is absent). The single CPU-side reader of {@link AV_DPR_MAX}.
  */
 export declare function resolveBudgetDpr(): number;
+/**
+ * BB.W-PERF-PRODUCER A′-5 — resolve the budget-clamped backing-store DPR for the
+ * aurora decorative WASH, at the SUB-2× {@link AV_AURORA_DPR_MAX} ceiling (distinct
+ * from {@link resolveBudgetDpr}'s focal 2×). SSR-safe (returns `1` when `window` is
+ * absent). The single CPU-side reader is aurora's `runtime.ts` `resize()`; the
+ * focal goo-blob keeps {@link resolveBudgetDpr}.
+ */
+export declare function resolveAuroraWashDpr(): number;

package/dist/components/custom/aurora/constants/presets.d.ts

@@ -39,7 +39,7 @@ export interface AuroraNucleus {
      */
     angle?: number;
 }
-export type AuroraMedium = "smooth" | "pastel" | "watercolor" | "oil" | "crayon" | "vangogh" | "oil-pastel";
+export type AuroraMedium = "smooth" | "pastel" | "watercolor" | "oil" | "crayon" | "vangogh" | "oil-pastel" | "kuwahara";
 /** Oil-stroke sub-mode. Applied only when `medium === "oil"`. Routes inside the shader. */
 export type StrokeMode = "oil" | "knife" | "chunky";
 export type FlowPattern = "none" | "radial" | "swirl" | "diagonal" | "multi" | "tensor";
@@ -50,7 +50,7 @@ export type FlowPattern = "none" | "radial" | "swirl" | "diagonal" | "multi" | "
  * edge-tangent flow). No default that hides one as a duplicate of the other.
  */
 export type StrokeOrient = "flow" | "tensor";
-export type WarpMode = "fbm" | "cellular" | "hybrid";
+export type WarpMode = "fbm" | "cellular" | "hybrid" | "curl";
 /**
  * AW.W6/W8 — the interactivity flag SHAPE (declared at W6, default OFF; behavior
  * wired at W8). Each axis opts the aurora into a pointer/scroll response:
@@ -181,3 +181,31 @@ export declare const MAX_STOPS = 8;
  * Not a themed preset — the demo's 11 authored presets override every field.
  */
 export declare const DEFAULT_AURORA_CONFIG: AuroraConfig;
+/**
+ * `PAPER_WASH_GROUND` — the library-canon recessive-ground crayon calibration
+ * (BA.W-ATLAS-RECONCILE A-4a; d6 9467bd16 adopt). A pure PRESET PARTIAL (no
+ * palette/nuclei/motion) pinning the recessive crayon-ground deposition dials so a
+ * data-ground aurora reads as paper-on-tooth without each consumer dial-tuning the
+ * same recessive calibration by hand. It carries NO palette/nuclei — the consumer
+ * spreads it over its own pole-derived pigment (page-glow IS data-glow):
+ * `const cfg = { ...consumerBase, ...PAPER_WASH_GROUND }`.
+ *
+ * House-rule clean (presets-in-consumers): this is the LIBRARY's own recessive-ground
+ * IDENTITY, not a consumer theme — admissible at the root. `satisfies
+ * Partial<AuroraConfig>` holds (every key is a first-class `AuroraConfig` field at
+ * HEAD; the `crayon` medium is `uMedium==4`).
+ */
+export declare const PAPER_WASH_GROUND: {
+    readonly medium: "crayon";
+    readonly strokeOrient: "tensor";
+    readonly granulation: 0.3;
+    readonly canvasGrain: 0.5;
+    readonly strokeAmount: 0.35;
+    readonly strokeAnisotropy: 0.5;
+    readonly strokeLayers: 1;
+    readonly impasto: 0;
+    readonly brokenColor: 0;
+    readonly wetEdge: 0;
+    readonly saturation: 0.92;
+    readonly paperGrain: 0.008;
+};

package/dist/components/custom/aurora/constants/renderMode.d.ts

@@ -1,22 +1,75 @@
+export type AuroraRenderMode = "webgl" | "css" | "auto";
 /**
- * Aurora adaptive render substrate (AM.W1; `aurora-lazy-init §3.1`).
+ * Detect a SOFTWARE / CPU WebGL renderer (SwiftShader, llvmpipe, the Microsoft
+ * Basic Render Driver) via the shared `probeWebGL2Renderer` capability helper
+ * (BB.W-CI-GREEN — the substrate owns the SINGLE `getContext("webgl2")`
+ * bootstrap; this consumer reads the renderer STRING through it rather than
+ * creating a second probe context, per `proof:webgl-substrate-single`).
+ *
+ * WHY this is a `"css"` signal (the N.W5 Defect-A root cause, proven live under
+ * the playwright SwiftShader harness): a full-viewport WebGL2 surface is a
+ * compositor layer the rasteriser must re-raster on every composite. On a
+ * software rasteriser that per-composite cost is so high that a REAL pointer
+ * interaction — which forces a composite — starves the renderer's input ack and
+ * the page goes UNRESPONSIVE (the headless-Chromium hang; the same severe jank a
+ * GPU-blocklisted user feels). Neither a frame-cadence cap, a backing-store
+ * shrink, nor a reduced-motion park cures it (all keep the live GL layer);
+ * ONLY *not creating the WebGL surface* does. So a software renderer takes the
+ * `"css"` substrate — the static gradient placeholder is a complete render of the
+ * same palette, composites cheaply, and never stalls input. A blocklisted-GPU
+ * user gets a smooth atmosphere instead of a janky/hanging one.
  *
- * Aurora is NEVER retired — the warm wash composites under every branch. Only
- * the *substrate* adapts: the animated WebGL field on capable devices, the
- * static CSS-gradient placeholder (a complete render of the same palette) on
- * low-power / reduced-motion / save-data devices.
+ * A `null` probe (no WebGL2 / extension masked / throw) returns `false` — we
+ * never downgrade a renderer we cannot PROVE is software (the `"css"` path is the
+ * conservative-but-lossy choice, so a false miss keeps the richer default).
  */
-export type AuroraRenderMode = "webgl" | "css" | "auto";
+export declare function isSoftwareWebGLRenderer(): boolean;
 /**
- * Resolve `"auto"` to a concrete substrate per device tier. `"webgl"` and
- * `"css"` pass through unchanged.
+ * Resolve-mode options. The software-raster GUARD is the safe DEFAULT (see
+ * {@link resolveRenderMode}); the single ESCAPE is `forceWebGLUnderSoftwareRaster`
+ * (BB.W-AURORA-SWRASTER).
+ */
+export interface ResolveRenderModeOptions {
+    /**
+     * Opt OUT of the universal software-raster guard. When `true`, a forced
+     * `mode:"webgl"`/`mode:"capture"` arm ARMS the live WebGL2 surface even on a
+     * detected software renderer (SwiftShader / llvmpipe / MS Basic Render) — for
+     * a deterministic test that ACCEPTS the per-composite raster cost. Default
+     * `false`: the guard is the SAFE default (a software-raster signal forces
+     * `"css"` regardless of the requested mode, so a consumer who pins
+     * `mode:"webgl"` on a headless / GPU-blocklisted device gets the static
+     * ground, never the page-wedging hang). The escape is NAMED + recorded,
+     * never silent.
+     */
+    forceWebGLUnderSoftwareRaster?: boolean;
+}
+/**
+ * Resolve `"auto"` to a concrete substrate per device tier — AND universalize the
+ * software-raster guard out of the `"auto"`-only branch (BB.W-AURORA-SWRASTER).
+ *
+ * THE GUARD (the universal first leg). A SOFTWARE WebGL renderer (SwiftShader /
+ * llvmpipe / MS Basic Render — the GPU-blocklisted / headless path) forces `"css"`
+ * for ANY WebGL-ARMING requested mode (`"webgl"` OR `"auto"`), not only `"auto"`.
+ * A full-viewport software-rastered GL layer is so expensive to re-raster on every
+ * composite that a pointer interaction starves the renderer's input ack and the
+ * page goes UNRESPONSIVE (the headless-Chromium hang the speedtest harness
+ * documents). A consumer (or a capture harness) that pins `mode:"webgl"` /
+ * `mode:"capture"` on such a device MUST still fall to the static ground — so the
+ * probe runs BEFORE the `mode !== "auto"` short-circuit when the requested mode
+ * would arm WebGL. The single ESCAPE is `options.forceWebGLUnderSoftwareRaster`
+ * (default `false` — the guard is the safe default).
  *
- * `"auto"` resolves to `"css"` when ANY low-power signal is present:
+ * `"auto"` then resolves to `"css"` when ANY low-power signal is present:
+ *   - a SOFTWARE WebGL renderer (already handled by the universal guard above),
  *   - `navigator.hardwareConcurrency <= 4` (few logical cores),
  *   - `prefers-reduced-motion: reduce`,
  *   - `navigator.connection.saveData === true` (Data Saver on).
  * Otherwise `"webgl"`.
  *
+ * THE CAPABLE PATH IS BYTE-UNTOUCHED: `isSoftwareWebGLRenderer()` returns `false`
+ * on a real GPU (or a null probe — never a false downgrade), so a forced
+ * `mode:"webgl"` on hardware passes through exactly as before.
+ *
  * SSR / missing-API safe: if `navigator` / `window` / the probes are
  * unavailable we ASSUME a capable device and resolve `"webgl"` (the warm wash
  * still composites either way — the only question is whether it animates).
@@ -27,4 +80,4 @@ export type AuroraRenderMode = "webgl" | "css" | "auto";
  * not a reactive one (a connection-type flip mid-session does not re-resolve;
  * the consumer remounts to re-evaluate, matching the deferred-arm contract).
  */
-export declare function resolveRenderMode(mode: AuroraRenderMode): "webgl" | "css";
+export declare function resolveRenderMode(mode: AuroraRenderMode, options?: ResolveRenderModeOptions): "webgl" | "css";

package/dist/components/custom/aurora/constants/shaders/aurora.wgsl.d.ts

@@ -0,0 +1 @@
+export declare const AURORA_WGSL = "\nconst MAX_NUCLEI: i32 = 6;\nconst MAX_STOPS: i32 = 8;\nconst PI: f32 = 3.141592653589793;\n\n// \u2500\u2500 Uniforms (the typed-struct source-of-truth \u2014 see aurora.wgsl.uniforms.ts) \u2500\u2500\n// Scalars are packed into vec4 lanes to keep the std140/WGSL 16-byte struct alignment\n// trivial. nuc0[i] = (pos.x, pos.y, radius, paletteBias); nuc1[i] = (valueBias,\n// driftRadius, driftPhase, elong); nuc2[i] = (angle, _, _, _). palette[i].rgb is the\n// CPU-baked linear-sRGB stop.\nstruct Uniforms {\n  // scalars0: (uTime, uSoftmaxBeta, uValueVariance, uWarpAmount)\n  scalars0: vec4<f32>,\n  // scalars1: (uWarpScale, uWarpDrift, uSaturation, uPaperGrain)\n  scalars1: vec4<f32>,\n  // scalars2: (uAlpha, uNucleiDrift, uPaletteDrift, uBreathDepth)\n  scalars2: vec4<f32>,\n  // scalars3: (uBreathPeriod, uCursorStrength, uCursorRadius, _pad)\n  scalars3: vec4<f32>,\n  // cursor: (uCursor.x, uCursor.y, _pad, _pad)\n  cursor: vec4<f32>,\n  // ints: (uStopCount, uNucleiCount, uWarpMode, uNoiseOctaves)\n  ints0: vec4<i32>,\n  // ints1: (uMedium, uHuePath, _, _)\n  ints1: vec4<i32>,\n  palette: array<vec4<f32>, 8>,\n  nuc0: array<vec4<f32>, 6>,\n  nuc1: array<vec4<f32>, 6>,\n  nuc2: array<vec4<f32>, 6>,\n};\n\n@group(0) @binding(0) var<uniform> u: Uniforms;\n\n// \u2500\u2500 Authoring-scale \u2192 rad/sec lifts (byte-identical to aurora.frag.ts) \u2500\u2500\nconst K_NUCLEI: f32 = 14.0;\nconst K_PAL: f32 = 24.0;\nconst K_WARP: f32 = 5.0;\n\n// \u2500\u2500 Noise (aurora-local hash21/vnoise/fbm \u2014 legitimately divergent per AV.W2 \u00A73a) \u2500\u2500\nfn hash21(p0: vec2<f32>) -> f32 {\n  var p = fract(p0 * vec2<f32>(123.34, 456.21));\n  p = p + dot(p, p + 45.32);\n  return fract(p.x * p.y);\n}\n\nfn hash22(p0: vec2<f32>) -> vec2<f32> {\n  let p = vec2<f32>(dot(p0, vec2<f32>(127.1, 311.7)),\n                    dot(p0, vec2<f32>(269.5, 183.3)));\n  return fract(sin(p) * 43758.5453);\n}\n\nfn vnoise(p: vec2<f32>) -> f32 {\n  let i = floor(p);\n  let f = fract(p);\n  let uu = f * f * (3.0 - 2.0 * f);\n  let a = hash21(i);\n  let b = hash21(i + vec2<f32>(1.0, 0.0));\n  let c = hash21(i + vec2<f32>(0.0, 1.0));\n  let d = hash21(i + vec2<f32>(1.0, 1.0));\n  return mix(mix(a, b, uu.x), mix(c, d, uu.x), uu.y);\n}\n\nconst FBM_ROT: mat2x2<f32> = mat2x2<f32>(0.8, 0.6, -0.6, 0.8);\n\nfn fbm(p0: vec2<f32>) -> f32 {\n  var v = 0.0;\n  var a = 0.5;\n  var p = p0;\n  let octaves = u.ints0.w;\n  for (var i = 0; i < 5; i = i + 1) {\n    if (i >= octaves) { break; }\n    v = v + a * vnoise(p);\n    p = FBM_ROT * p * 2.02;\n    a = a * 0.5;\n  }\n  return v;\n}\n\n\nfn srgbToLinearCh(c: f32) -> f32 {\n  if (c <= 0.04045) { return c / 12.92; }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\nfn srgbToLinear(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(srgbToLinearCh(c.r), srgbToLinearCh(c.g), srgbToLinearCh(c.b));\n}\n\nfn linearToSrgbCh(c: f32) -> f32 {\n  if (c <= 0.0031308) { return c * 12.92; }\n  return 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\nfn linearToSrgb(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(linearToSrgbCh(c.r), linearToSrgbCh(c.g), linearToSrgbCh(c.b));\n}\n\n// value.js LINEAR_SRGB_TO_LMS, row-major \u2192 WGSL columns (= the transpose).\nconst LINEAR_SRGB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  0.4122214708, 0.2119034982, 0.0883024619,\n  0.5363325363, 0.6806995451, 0.2817188376,\n  0.0514459929, 0.1073969566, 0.6299787005\n);\n\n// value.js srgbToOKLab's INLINE LMS\u2192OKLab coefficients, row-major \u2192 WGSL columns.\nconst LMS_TO_OKLAB: mat3x3<f32> = mat3x3<f32>(\n  0.2104542553, 1.9779984951, 0.0259040371,\n  0.7936177850, -2.4285922050, 0.7827717662,\n  -0.0040720468, 0.4505937099, -0.8086757660\n);\n\n// value.js OKLAB_TO_LMS_COEFF, row-major \u2192 WGSL columns.\nconst OKLAB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  1.0, 1.0, 1.0,\n  0.3963377774, -0.1055613458, -0.0894841775,\n  0.2158037573, -0.0638541728, -1.2914855480\n);\n\n// value.js LMS_TO_LINEAR_SRGB, row-major \u2192 WGSL columns.\nconst LMS_TO_LINEAR_SRGB: mat3x3<f32> = mat3x3<f32>(\n  4.0767416621, -1.2684380046, -0.0041960863,\n  -3.3077115913, 2.6097574011, -0.7034186147,\n  0.2309699292, -0.3413193965, 1.7076147010\n);\n\nfn cbrt3(v: vec3<f32>) -> vec3<f32> {\n  return sign(v) * pow(abs(v), vec3<f32>(1.0 / 3.0));\n}\n\n// Gamma sRGB \u2192 raw OKLab (L, a, b). Mirrors value.js srgbToOKLab.\nfn srgbToOklab(c: vec3<f32>) -> vec3<f32> {\n  let lin = srgbToLinear(c);\n  let lms = LINEAR_SRGB_TO_LMS * lin;\n  return LMS_TO_OKLAB * cbrt3(lms);\n}\n\n// Raw OKLab (L, a, b) \u2192 linear sRGB. Mirrors value.js oklabToLinearSRGB.\nfn oklabToLinearSrgb(lab: vec3<f32>) -> vec3<f32> {\n  let lms_ = OKLAB_TO_LMS * lab;\n  let lms = lms_ * lms_ * lms_;\n  return LMS_TO_LINEAR_SRGB * lms;\n}\n\n// OKLab \u2192 OKLCh: H in RADIANS, folded to [0, 2pi). Mirrors value.js rawOklabToOklch.\nfn oklabToOklch(lab: vec3<f32>) -> vec3<f32> {\n  let C = length(lab.yz);\n  var H = atan2(lab.z, lab.y);\n  if (H < 0.0) { H = H + 2.0 * PI; }\n  return vec3<f32>(lab.x, C, H);\n}\n\n// OKLCh (H radians) \u2192 OKLab. Mirrors value.js rawOklchToOklab.\nfn oklchToOklab(lch: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));\n}\n\n// value.js interpolateHue in the NORMALIZED-TURNS domain. methods: 0 shorter,\n// 1 longer, 2 increasing, 3 decreasing.\nfn interpolateHueTurns(h0: f32, h1: f32, t: f32, method: i32) -> f32 {\n  let TAU = 2.0 * PI;\n  var a = h0 / TAU;\n  var b = h1 / TAU;\n  let i = b - a;\n  if (method == 0) {              // shorter\n    if (i > 0.5) { a = a + 1.0; } else if (i < -0.5) { b = b + 1.0; }\n  } else if (method == 1) {       // longer\n    if (i > 0.0 && i < 0.5) { a = a + 1.0; } else if (i > -0.5 && i <= 0.0) { b = b + 1.0; }\n  } else if (method == 2) {       // increasing\n    if (i < 0.0) { b = b + 1.0; }\n  } else {                        // decreasing\n    if (i > 0.0) { a = a + 1.0; }\n  }\n  var r = a + t * (b - a);\n  r = fract(r);                   // fract is non-negative in WGSL\n  return r * TAU;                 // back to radians\n}\n\n// Linear-sRGB endpoint pair \u2192 OKLab-rectangular interpolation \u2192 linear sRGB.\nfn mixPaletteOklab(linA: vec3<f32>, linB: vec3<f32>, t: f32) -> vec3<f32> {\n  let labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linA);\n  let labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linB);\n  let lab = mix(labA, labB, t);\n  return oklabToLinearSrgb(lab);\n}\n\n// Linear-sRGB endpoint pair \u2192 OKLCh hue-arc interpolation \u2192 linear sRGB.\nfn mixPaletteOklchArc(linA: vec3<f32>, linB: vec3<f32>, t: f32, method: i32) -> vec3<f32> {\n  let labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linA);\n  let labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linB);\n  let lchA = oklabToOklch(labA);\n  let lchB = oklabToOklch(labB);\n  let L = mix(lchA.x, lchB.x, t);\n  let C = mix(lchA.y, lchB.y, t);\n  let H = interpolateHueTurns(lchA.z, lchB.z, t, method);\n  return oklabToLinearSrgb(oklchToOklab(vec3<f32>(L, C, H)));\n}\n\n// The ramp dispatcher (the samplePalette splices it). tRaw is the raw inter-stop\n// parameter [0,1]; the smoothstep ease + the huePath branch live here so the ramp is\n// one source. increasing(2)/decreasing(3) take the OKLCh hue-arc; every other method\n// takes the OKLab-rectangular straight line.\nfn samplePaletteRamp(a: vec3<f32>, b: vec3<f32>, tRaw: f32, huePath: i32) -> vec3<f32> {\n  let t = smoothstep(0.0, 1.0, tRaw);\n  if (huePath == 2 || huePath == 3) {\n    return mixPaletteOklchArc(a, b, t, huePath);\n  }\n  return mixPaletteOklab(a, b, t);\n}\n\n// Interleaved Gradient Noise (Jimenez) \u2014 display-space 1-LSB dither.\nfn ign(p: vec2<f32>) -> f32 {\n  return fract(52.9829189 * fract(dot(p, vec2<f32>(0.06711056, 0.00583715))));\n}\n\n// Cellular / Worley f1.\nfn cellular(p: vec2<f32>) -> f32 {\n  let i = floor(p);\n  let f = fract(p);\n  var m = 1e9;\n  for (var y = -1; y <= 1; y = y + 1) {\n    for (var x = -1; x <= 1; x = x + 1) {\n      let g = vec2<f32>(f32(x), f32(y));\n      let o = hash22(i + g);\n      let r = g + o - f;\n      m = min(m, dot(r, r));\n    }\n  }\n  return sqrt(m);\n}\n\n// \u2500\u2500 Warp (Quilez double warp + the three warp modes + the cursor swirl) \u2500\u2500\nfn domainWarp(p: vec2<f32>, t: f32) -> vec2<f32> {\n  let warpScale = u.scalars1.x;\n  let warpDrift = u.scalars1.y;\n  let warpAmount = u.scalars0.w;\n  let warpMode = u.ints0.z;\n  let cursorStrength = u.scalars3.y;\n  let cursorRadius = u.scalars3.z;\n  let cursor = u.cursor.xy;\n\n  let q = vec2<f32>(fbm(p * warpScale + vec2<f32>(0.0, 0.0) + t * warpDrift * K_WARP),\n                    fbm(p * warpScale + vec2<f32>(5.2, 1.3) + t * warpDrift * K_WARP));\n  let r = vec2<f32>(fbm(p * warpScale + 4.0 * q + vec2<f32>(1.7, 9.2)),\n                    fbm(p * warpScale + 4.0 * q + vec2<f32>(8.3, 2.8)));\n\n  var warp = r;\n  if (warpMode == 1) {\n    // cellular \u2014 chunky territories\n    let c1 = cellular(p * warpScale * 1.5 + vec2<f32>(t * warpDrift * K_WARP * 2.0, 0.0));\n    let c2 = cellular(p * warpScale * 1.5 + vec2<f32>(11.0, 7.0 + t * warpDrift * K_WARP * 2.0));\n    warp = vec2<f32>(c1, c2);\n  } else if (warpMode == 2) {\n    // hybrid \u2014 fbm + cellular averaged\n    let c1 = cellular(p * warpScale * 1.2);\n    let c2 = cellular(p * warpScale * 1.2 + vec2<f32>(11.0, 7.0));\n    warp = mix(r, vec2<f32>(c1, c2), 0.5);\n  }\n  var warped = p + warpAmount * warp;\n\n  // Cursor swirl \u2014 rotate p around the cursor with radial falloff.\n  if (cursorStrength > 0.001) {\n    let toP = p - cursor;\n    let d = length(toP);\n    let rr = max(cursorRadius, 0.01);\n    let w = exp(-(d * d) / (rr * rr * 0.45));\n    let ang = w * cursorStrength * 2.1;\n    let ca = cos(ang);\n    let sa = sin(ang);\n    var rotated = vec2<f32>(ca * toP.x - sa * toP.y, sa * toP.x + ca * toP.y) + cursor;\n    let pinch = w * cursorStrength * 0.08;\n    rotated = mix(rotated, cursor, pinch);\n    warped = mix(warped, rotated + warpAmount * warp * 0.7, w * cursorStrength);\n  }\n  return warped;\n}\n\n// \u2500\u2500 Palette LUT \u2500\u2500\nfn samplePalette(id0: f32) -> vec3<f32> {\n  let id = clamp(id0, 0.0, 1.0);\n  let stopCount = u.ints0.x;\n  let scaled = id * f32(stopCount - 1);\n  let i0 = i32(floor(scaled));\n  let i1 = min(i0 + 1, stopCount - 1);\n  let t = fract(scaled);\n  return samplePaletteRamp(u.palette[i0].rgb, u.palette[i1].rgb, t, u.ints1.y);\n}\n\n// \u2500\u2500 Nuclei field (anisotropic Gaussian softmax + drift + palette drift) \u2500\u2500\nstruct NucleiResult { paletteId: f32, valueMod: f32 };\n\nfn nucleiField(p: vec2<f32>, t: f32) -> NucleiResult {\n  let nucleiCount = u.ints0.y;\n  let nucleiDrift = u.scalars2.y;\n  let paletteDrift = u.scalars2.z;\n  let softmaxBeta = u.scalars0.y;\n\n  var accumBias = 0.0;\n  var accumValue = 0.0;\n  var accumW = 0.0;\n  for (var i = 0; i < MAX_NUCLEI; i = i + 1) {\n    if (i >= nucleiCount) { break; }\n    let n0 = u.nuc0[i];   // pos.x, pos.y, radius, paletteBias\n    let n1 = u.nuc1[i];   // valueBias, driftRadius, driftPhase, elong\n    let angle = u.nuc2[i].x;\n    let driftRadius = n1.y;\n    let driftPhase = n1.z;\n    let posI = n0.xy + driftRadius * vec2<f32>(\n      cos(t * nucleiDrift * K_NUCLEI + driftPhase),\n      sin(t * nucleiDrift * K_NUCLEI + driftPhase * 1.13)\n    );\n    let diff = p - posI;\n    let ca = cos(angle);\n    let sa = sin(angle);\n    let local = vec2<f32>(ca * diff.x + sa * diff.y, -sa * diff.x + ca * diff.y);\n    let along = local.x / max(n1.w, 0.01);\n    let across = local.y;\n    let d2 = along * along + across * across;\n    let r = max(n0.z, 0.01);\n    let w = exp(-softmaxBeta * d2 / (r * r));\n    accumBias = accumBias + w * n0.w;\n    accumValue = accumValue + w * n1.x;\n    accumW = accumW + w;\n  }\n  var paletteId = accumBias / max(accumW, 1e-4);\n  let valueMod = accumValue / max(accumW, 1e-4);\n\n  let palAmp = clamp(paletteDrift * 6.0, 0.0, 0.06);\n  paletteId = paletteId + palAmp * sin(t * paletteDrift * K_PAL);\n  paletteId = clamp(paletteId, 0.0, 1.0);\n  return NucleiResult(paletteId, valueMod);\n}\n\n// \u2500\u2500 Color utils (OKLCh saturation) \u2500\u2500\nfn linOklab(lin: vec3<f32>) -> vec3<f32> {\n  let lms = LINEAR_SRGB_TO_LMS * lin;\n  return LMS_TO_OKLAB * cbrt3(lms);\n}\n\nfn saturate3(c: vec3<f32>, amt: f32) -> vec3<f32> {\n  var lch = oklabToOklch(linOklab(c));\n  lch.y = max(lch.y * amt, 0.0);\n  return max(oklabToLinearSrgb(oklchToOklab(lch)), vec3<f32>(0.0));\n}\n\n// \u2500\u2500 PBR-Neutral tonemap (named aces() in the GLSL \u2014 the tonemap slot) \u2500\u2500\nfn aces(color0: vec3<f32>) -> vec3<f32> {\n  let startCompression = 0.8 - 0.04;\n  let desaturation = 0.15;\n  var color = color0;\n  let x = min(color.r, min(color.g, color.b));\n  var offset = 0.04;\n  if (x < 0.08) { offset = x - 6.25 * x * x; }\n  color = color - offset;\n  let peak = max(color.r, max(color.g, color.b));\n  if (peak < startCompression) { return clamp(color, vec3<f32>(0.0), vec3<f32>(1.0)); }\n  let d = 1.0 - startCompression;\n  let newPeak = 1.0 - d * d / (peak + d - startCompression);\n  color = color * (newPeak / peak);\n  let g = 1.0 - 1.0 / (desaturation * (peak - newPeak) + 1.0);\n  return clamp(mix(color, newPeak * vec3<f32>(1.0), g), vec3<f32>(0.0), vec3<f32>(1.0));\n}\n\n// \u2500\u2500 Full-screen triangle vertex stage (the pilot idiom \u2014 no vertex buffer) \u2500\u2500\nstruct VSOut {\n  @builtin(position) pos: vec4<f32>,\n  @location(0) uv: vec2<f32>,\n};\n\n@vertex\nfn vs_main(@builtin(vertex_index) vi: u32) -> VSOut {\n  // NDC corners of the covering triangle (-1,-1), (3,-1), (-1,3).\n  var p = vec2<f32>(-1.0, -1.0);\n  if (vi == 1u) { p = vec2<f32>(3.0, -1.0); }\n  else if (vi == 2u) { p = vec2<f32>(-1.0, 3.0); }\n  var out: VSOut;\n  out.pos = vec4<f32>(p, 0.0, 1.0);\n  // vUv = aPos * 0.5 + 0.5 (the aurora.vert convention).\n  out.uv = p * 0.5 + 0.5;\n  return out;\n}\n\n// \u2500\u2500 Fragment stage (the main() transcription) \u2500\u2500\n@fragment\nfn fs_main(in: VSOut) -> @location(0) vec4<f32> {\n  let t = u.scalars0.x;\n  let valueVariance = u.scalars0.z;\n  let breathDepth = u.scalars2.w;\n  let breathPeriod = u.scalars3.x;\n  let saturation = u.scalars1.z;\n  let paperGrain = u.scalars1.w;\n  let alpha = u.scalars2.x;\n\n  let uv = in.uv;\n  let pN = uv;\n\n  let p_warp = domainWarp(pN, t);\n\n  let nf = nucleiField(p_warp, t);\n  var col = samplePalette(nf.paletteId);\n  col = col * (1.0 + valueVariance * nf.valueMod);\n\n  // Breath \u2014 slow global luminance wobble.\n  let breath = sin(t * 6.2831 / max(breathPeriod, 1.0));\n  col = col * (1.0 + breathDepth * breath * 0.5);\n\n  // The painterly mediums (uMedium 1-6) are the WebGL2 fallback's register; the WGSL\n  // primary renders the smooth core for the default parity capture (the booked\n  // W-AURORA-WGPU-MEDIUMS successor ports the painterly bodies).\n\n  // Saturation trim.\n  col = saturate3(col, saturation);\n\n  // Tonemap + film grain.\n  col = aces(col);\n  // gl_FragCoord.xy \u2192 the device-pixel position (the WGSL @builtin(position)).\n  let fragCoord = in.pos.xy;\n  let grain = hash21(fragCoord + t * 17.0);\n  col = col + (grain - 0.5) * paperGrain;\n\n  col = clamp(col * 0.985 + 0.008, vec3<f32>(0.0), vec3<f32>(1.0));\n\n  // MANDATORY OETF \u2014 closes the seam (the whole pipeline above runs in LINEAR).\n  col = linearToSrgb(col);\n\n  // 1-LSB triangular IGN dither in DISPLAY space, AFTER the OETF.\n  col = col + (1.0 / 255.0) * (ign(fragCoord) - 0.5);\n\n  // Premultiply on DISPLAY-space color (matches the WebGL2 path: OETF, then premul).\n  return vec4<f32>(col * alpha, alpha);\n}\n";

package/dist/components/custom/aurora/constants/shaders/oil-modes.glsl.d.ts

@@ -0,0 +1 @@
+export declare const AURORA_OIL_MODES_GLSL = "StrokeProfile profileFor(int medium, int mode) {\n  // The oil baseline (mode 0) \u2014 balanced modern-abstract/palette-knife hybrid.\n  StrokeProfile prof = StrokeProfile(\n    0,      // shapeType \u2014 tapered\n    0.25,   // bristleAmp\n    9.0,    // streakFreq\n    0.09,   // streakAmp\n    0.9,    // impastoAmp\n    0.80,   // hardness\n    340.0,  // toothScale \u2014 W-AUR-VANGOGH-CONFIG reconcile: FINER 240 \u2192 340. Oil's \u00A74.3 \u03B2 sat\n            //               right AT the \u22121.45 band ceiling (\u00B10.02 frame variance straddling\n            //               it, surfaced once the vangogh bands went green and the spec reached\n            //               the oil \u03B2 assert). MEASURED on the live GPU: ADDING fine high-\n            //               frequency tooth energy steepens oil's power-spectrum slope (more\n            //               negative \u2014 coarsening it the other way pushed \u03B2 SHALLOWER to\n            //               \u22121.33). A finer, stronger tooth moves \u03B2 to a safe distance inside\n            //               the \u22125/3 band [\u22121.85, \u22121.45]. Oil-only (oil-pastel sets 280).\n    0.14,   // toothAmp \u2014 raised 0.09 \u2192 0.14 (same oil-\u03B2 steepen: more fine-grain high band).\n    1.03,   // pigmentSat\n    0.65,   // densityBig\n    0.78,   // densityMed\n    0.90,   // densitySml\n    0.0,    // energyGrade \u2014 oil is uniform-length (no Starry-Night cascade)\n    0.4,    // impastoFloor \u2014 oil's 0.4+0.6\u00B7edgeN crown falloff\n    0.92,   // densityFill \u2014 oil fills DENSELY with the directional low-relief fill so the\n            //               flat-colour regions between the macro strokes are TEXTURED with\n            //               flow-aligned fine strokes (the \u00A74.2 anisotropy needs every pixel\n            //               to carry directional gradient; a flat untextured region reads as\n            //               an isotropic/degenerate tensor and drags mean A down). The fill\n            //               is now directional + low-streak, so dense coverage textures\n            //               WITHOUT the prior round-dab speckle.\n    1.0     // groundFloor \u2014 oil keeps the full base (no ground darken; fills everywhere)\n  );\n\n  // W-AUR-VANGOGH-REBUILD \u2014 the van-Gogh medium NO LONGER routes through this oil\n  // StrokeProfile cascade. It is a DEDICATED atomic-dab body (mediumVangogh / vangoghDab\n  // below) \u2014 the prior profile-driven cascade (four dense layers of long-thin\n  // tensor-oriented strokes) merged into the \"marbled flow-bands\" read and ran at ~4fps.\n  // profileFor now serves ONLY the oil + oil-pastel stroke mediums; the MEDIUM_VANGOGH\n  // case is removed (no caller). MEDIUM_VANGOGH stays #define'd (the main() dispatch +\n  // isPainterlyStroke still key off uMedium==5).\n\n  // \u2500\u2500 Oil-pastel \u2014 broad smeared directional strokes deposited via the brush engine\n  // (slice 8 F1). Creamy soft edges (low hardness), heavy build-up, and a chroma punch.\n  // Distinct from the dry-crayon tooth-multiply (mediumCrayon): oil-pastel LAYS strokes.\n  if (medium == MEDIUM_OILPASTEL) {\n    prof.shapeType   = 0;     // tapered directional smear \u2014 a round dab reads locally\n                              // isotropic (steep \u03B2 / low A); the creamy oil-pastel mark\n                              // is a broad DIRECTIONAL smear, which carries the \u00A74.2\n                              // coherence + adds the directional mid-band the \u00A74.3 slope\n                              // needs (the round-dab profile rolled \u03B2 off to \u22122.8)\n    prof.bristleAmp  = 0.10;  // smooth creamy edges (waxy pastel, not bristle)\n    prof.streakFreq  = 18.0;  // finer internal smear \u2014 adds the mid/high-band the smooth\n                              // round-dab profile lacked (the \u03B2-too-steep fix); the\n                              // directional along-spine streak flattens the \u00A74.3 slope\n                              // without crossing the strokes\n    prof.streakAmp   = 0.20;\n    prof.impastoAmp  = 0.7;   // build-up, but flatter than oil impasto\n    prof.hardness    = 0.42;  // CREAMY \u2014 soft compositing, strokes blend on overlap\n    prof.toothScale  = 280.0;\n    prof.toothAmp    = 0.12;  // the pastel tooth reads stronger\n    prof.pigmentSat  = 0.80;  // the waxy chroma \u2014 eased off 1.16 so the rendered C clears\n                              // the \u00A74.1 band ceiling with margin while the K-M subtractive\n                              // overlap path (paintOverOklab) keeps the chroma OFF the grey floor\n    prof.hardness    = 0.58;  // creamy but the strokes still REGISTER \u2014 a too-soft blend\n                              // (0.42) smeared the marks into the smooth colour zones and\n                              // the field rolled off too steep (\u03B2\u2248\u22122.9, a near-gradient);\n                              // a crisper deposit keeps the mid/high-band the \u22125/3 slope needs\n    prof.densityBig  = 0.62;  // broad directional coverage \u2014 but NOT over-dense: too many\n                              // overlapping creamy strokes point in slightly-varied\n                              // directions and the local \u00A74.2 coherence DROPS (over-dense\n                              // measured A=0.57 < the 0.62-density A=0.63). The mid-density\n                              // flow-aligned deposit is the coherence sweet spot.\n    prof.densityMed  = 0.78;\n    prof.densitySml  = 0.90;\n    prof.energyGrade = 0.80;  // a strong Starry-Night length cascade \u2014 varies stroke length\n                              // by luma/coherence so the dab-size energy spreads across\n                              // scales (the \u22125/3 cascade the uniform-length 0.0 grade lacked,\n                              // the \u00A74.3 \u03B2-too-steep fix). Not the full van-Gogh 1.0 (oil-\n                              // pastel keeps its creamy broad character).\n    prof.impastoFloor = 0.55; // a softer crown than van-Gogh's full-height glint\n    return prof;\n  }\n\n  // \u2500\u2500 Oil sub-modes (mode dispatch on the oil medium).\n  if (mode == 1) {           // palette knife \u2014 razor edges, heavy impasto\n    prof.shapeType  = 3;     // flat, even\n    prof.bristleAmp = 0.12;\n    prof.streakFreq = 4.0;  prof.streakAmp = 0.05;\n    prof.impastoAmp = 1.6;\n    prof.hardness   = 0.95;\n    prof.toothAmp   = 0.04;\n    prof.densityBig = 0.80; prof.densityMed = 0.88; prof.densitySml = 0.70;\n  } else if (mode == 3) {    // thick brushwork \u2014 heavy bristle brush\n    prof.shapeType  = 0;     // tapered\n    prof.bristleAmp = 0.32;\n    prof.streakFreq = 14.0; prof.streakAmp = 0.14;\n    prof.impastoAmp = 1.2;\n    prof.hardness   = 0.85;\n    prof.toothAmp   = 0.07;\n  }\n  return prof;\n}\n";

package/dist/components/custom/aurora/constants/shaders/procedural-color.wgsl.d.ts

@@ -0,0 +1,4 @@
+export declare const OETF_WGSL = "\nfn srgbToLinearCh(c: f32) -> f32 {\n  if (c <= 0.04045) { return c / 12.92; }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\nfn srgbToLinear(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(srgbToLinearCh(c.r), srgbToLinearCh(c.g), srgbToLinearCh(c.b));\n}\n\nfn linearToSrgbCh(c: f32) -> f32 {\n  if (c <= 0.0031308) { return c * 12.92; }\n  return 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\nfn linearToSrgb(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(linearToSrgbCh(c.r), linearToSrgbCh(c.g), linearToSrgbCh(c.b));\n}";
+export declare const FBM_ROT_WGSL = "const FBM_ROT: mat2x2<f32> = mat2x2<f32>(0.8, 0.6, -0.6, 0.8);";
+export declare const OKLCH_MATRICES_WGSL = "\n// value.js LINEAR_SRGB_TO_LMS, row-major \u2192 WGSL columns (= the transpose).\nconst LINEAR_SRGB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  0.4122214708, 0.2119034982, 0.0883024619,\n  0.5363325363, 0.6806995451, 0.2817188376,\n  0.0514459929, 0.1073969566, 0.6299787005\n);\n\n// value.js srgbToOKLab's INLINE LMS\u2192OKLab coefficients, row-major \u2192 WGSL columns.\nconst LMS_TO_OKLAB: mat3x3<f32> = mat3x3<f32>(\n  0.2104542553, 1.9779984951, 0.0259040371,\n  0.7936177850, -2.4285922050, 0.7827717662,\n  -0.0040720468, 0.4505937099, -0.8086757660\n);\n\n// value.js OKLAB_TO_LMS_COEFF, row-major \u2192 WGSL columns.\nconst OKLAB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  1.0, 1.0, 1.0,\n  0.3963377774, -0.1055613458, -0.0894841775,\n  0.2158037573, -0.0638541728, -1.2914855480\n);\n\n// value.js LMS_TO_LINEAR_SRGB, row-major \u2192 WGSL columns.\nconst LMS_TO_LINEAR_SRGB: mat3x3<f32> = mat3x3<f32>(\n  4.0767416621, -1.2684380046, -0.0041960863,\n  -3.3077115913, 2.6097574011, -0.7034186147,\n  0.2309699292, -0.3413193965, 1.7076147010\n);\n\nfn cbrt3(v: vec3<f32>) -> vec3<f32> {\n  return sign(v) * pow(abs(v), vec3<f32>(1.0 / 3.0));\n}\n\n// Gamma sRGB \u2192 raw OKLab (L, a, b). Mirrors value.js srgbToOKLab.\nfn srgbToOklab(c: vec3<f32>) -> vec3<f32> {\n  let lin = srgbToLinear(c);\n  let lms = LINEAR_SRGB_TO_LMS * lin;\n  return LMS_TO_OKLAB * cbrt3(lms);\n}\n\n// Raw OKLab (L, a, b) \u2192 linear sRGB. Mirrors value.js oklabToLinearSRGB.\nfn oklabToLinearSrgb(lab: vec3<f32>) -> vec3<f32> {\n  let lms_ = OKLAB_TO_LMS * lab;\n  let lms = lms_ * lms_ * lms_;\n  return LMS_TO_LINEAR_SRGB * lms;\n}\n\n// OKLab \u2192 OKLCh: H in RADIANS, folded to [0, 2pi). Mirrors value.js rawOklabToOklch.\nfn oklabToOklch(lab: vec3<f32>) -> vec3<f32> {\n  let C = length(lab.yz);\n  var H = atan2(lab.z, lab.y);\n  if (H < 0.0) { H = H + 2.0 * PI; }\n  return vec3<f32>(lab.x, C, H);\n}\n\n// OKLCh (H radians) \u2192 OKLab. Mirrors value.js rawOklchToOklab.\nfn oklchToOklab(lch: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));\n}";
+export declare const PALETTE_RAMP_WGSL = "\n// value.js interpolateHue in the NORMALIZED-TURNS domain. methods: 0 shorter,\n// 1 longer, 2 increasing, 3 decreasing.\nfn interpolateHueTurns(h0: f32, h1: f32, t: f32, method: i32) -> f32 {\n  let TAU = 2.0 * PI;\n  var a = h0 / TAU;\n  var b = h1 / TAU;\n  let i = b - a;\n  if (method == 0) {              // shorter\n    if (i > 0.5) { a = a + 1.0; } else if (i < -0.5) { b = b + 1.0; }\n  } else if (method == 1) {       // longer\n    if (i > 0.0 && i < 0.5) { a = a + 1.0; } else if (i > -0.5 && i <= 0.0) { b = b + 1.0; }\n  } else if (method == 2) {       // increasing\n    if (i < 0.0) { b = b + 1.0; }\n  } else {                        // decreasing\n    if (i > 0.0) { a = a + 1.0; }\n  }\n  var r = a + t * (b - a);\n  r = fract(r);                   // fract is non-negative in WGSL\n  return r * TAU;                 // back to radians\n}\n\n// Linear-sRGB endpoint pair \u2192 OKLab-rectangular interpolation \u2192 linear sRGB.\nfn mixPaletteOklab(linA: vec3<f32>, linB: vec3<f32>, t: f32) -> vec3<f32> {\n  let labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linA);\n  let labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linB);\n  let lab = mix(labA, labB, t);\n  return oklabToLinearSrgb(lab);\n}\n\n// Linear-sRGB endpoint pair \u2192 OKLCh hue-arc interpolation \u2192 linear sRGB.\nfn mixPaletteOklchArc(linA: vec3<f32>, linB: vec3<f32>, t: f32, method: i32) -> vec3<f32> {\n  let labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linA);\n  let labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * linB);\n  let lchA = oklabToOklch(labA);\n  let lchB = oklabToOklch(labB);\n  let L = mix(lchA.x, lchB.x, t);\n  let C = mix(lchA.y, lchB.y, t);\n  let H = interpolateHueTurns(lchA.z, lchB.z, t, method);\n  return oklabToLinearSrgb(oklchToOklab(vec3<f32>(L, C, H)));\n}\n\n// The ramp dispatcher (the samplePalette splices it). tRaw is the raw inter-stop\n// parameter [0,1]; the smoothstep ease + the huePath branch live here so the ramp is\n// one source. increasing(2)/decreasing(3) take the OKLCh hue-arc; every other method\n// takes the OKLab-rectangular straight line.\nfn samplePaletteRamp(a: vec3<f32>, b: vec3<f32>, tRaw: f32, huePath: i32) -> vec3<f32> {\n  let t = smoothstep(0.0, 1.0, tRaw);\n  if (huePath == 2 || huePath == 3) {\n    return mixPaletteOklchArc(a, b, t, huePath);\n  }\n  return mixPaletteOklab(a, b, t);\n}";

package/dist/components/custom/aurora/index.d.ts

@@ -1,12 +1,13 @@
 export { default as Aurora } from "./Aurora.vue";
-export { resolveRenderMode, type AuroraRenderMode } from "./constants/renderMode";
+export { resolveRenderMode, isSoftwareWebGLRenderer, type AuroraRenderMode, type ResolveRenderModeOptions, } from "./constants/renderMode";
 export { useAurora } from "./composables/useAurora";
 export type { UseAuroraReturn } from "./composables/useAurora";
 export { useCursorInteraction } from "./composables/useCursorInteraction";
 export { createAurora } from "./composables/runtime";
 export type { AuroraRuntimeMode, AuroraRuntimeOptions } from "./composables/runtime";
-export { DEFAULT_AURORA_CONFIG, MAX_NUCLEI, MAX_STOPS, type AuroraConfig, type AuroraCursorApi, type AuroraFlow, type AuroraInstance, type AuroraInteractivity, type AuroraMedium, type AuroraNucleus, type FlowPattern, type OklchStop, type StrokeMode, type StrokeOrient, type WarpMode, } from "./constants/presets";
+export { DEFAULT_AURORA_CONFIG, PAPER_WASH_GROUND, MAX_NUCLEI, MAX_STOPS, type AuroraConfig, type AuroraCursorApi, type AuroraFlow, type AuroraInstance, type AuroraInteractivity, type AuroraMedium, type AuroraNucleus, type FlowPattern, type OklchStop, type StrokeMode, type StrokeOrient, type WarpMode, } from "./constants/presets";
 export { resolveAtoms, configToAtoms, nucleiPrior, DEFAULT_ATOMS, type AuroraAtoms, type AuroraMotionAtom, type AuroraZones, type AuroraZoneArrangement, type AuroraMediumAtom, type AuroraInteractivityAtom, } from "./composables/atoms";
 export { cssToOklch, deriveAurora, flattenPalette, hexToOklchStop, oklchStopToHex, oklchToLinear, paletteToCssGradient, } from "./composables/color";
+export { auroraFallbackGround, sampleAuroraField, nucleiFieldStatic, relativeLuminance, type AuroraFallbackGround, type AuroraFallbackGroundOptions, type AuroraGroundMetrics, } from "./composables/auroraFallbackGround";
 export type { AuroraHarmony, DeriveAuroraOptions, DeriveEasing, } from "./composables/color";
 export type { AuroraHuePath } from "./constants/presets";

package/dist/components/custom/border-progress/BorderProgress.vue.d.ts

@@ -0,0 +1,46 @@
+import { type BorderProgressCoverage, type BorderProgressMilestone, type BorderProgressMilestoneEvent } from "./constants";
+export interface BorderProgressProps {
+    /** The progress scalar. 0..1 (or 0..`max`) drives the registered conic angle. */
+    value: number;
+    /** The value-axis ceiling. Default `1` (a 0..1 scalar; pass `100` for percent). */
+    max?: number;
+    /** `full-ring` (default) sweeps the perimeter; `bottom-edge` paints only the bottom band. */
+    coverage?: BorderProgressCoverage;
+    /**
+     * The conic color stops — CSS color strings. Default the LIBRARY brand ramp
+     * (the `--section-color-*`/`--viz-*` tokens, resolved in the cascade). A
+     * consumer passes its OWN phase palette (presets-in-consumers — no consumer
+     * hue enters a library token). CONCRETE anchors are walked OKLCH/shorter-hue;
+     * `var(--…)` token anchors pass through to the live cascade.
+     */
+    stops?: readonly string[];
+    /** The ring thickness in px (default within the 10-14px envelope). */
+    width?: number;
+    /** The host border-radius in px the ring follows. Default 16. */
+    radius?: number;
+    /**
+     * Phase-edge boundaries. The ring fires `milestone` + (PRM-gated) pulses when
+     * `value` crosses one. The consumer owns the phase colors (the chassis
+     * `--phase-color` cascade precedent — the milestone is the EVENT seam).
+     */
+    milestones?: readonly BorderProgressMilestone[];
+    /** Pass-through class on the root. */
+    class?: string;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<BorderProgressProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    milestone: (event: BorderProgressMilestoneEvent) => any;
+}, string, import("vue").PublicProps, Readonly<BorderProgressProps> & Readonly<{
+    onMilestone?: ((event: BorderProgressMilestoneEvent) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/custom/border-progress/composables/useBorderSpectrum.d.ts

@@ -0,0 +1,22 @@
+import { type OklchStop } from "../../../../composables/color";
+/**
+ * Walk the anchor ramp to the single OKLCh stop at parameter `t` (0..1) via the
+ * shorter-hue arc. The segment is located, then L/C lerp linearly and the hue
+ * walks value.js's `interpolateHue` in the normalized-turns domain (`/360` in,
+ * `*360` out — value.js takes turns, the `.5` short-arc threshold is a half-turn;
+ * the `deriveHue` leaf convention).
+ *
+ * Deterministic + DOM-free (SSR-safe; mirrors `deriveBlobPalette`).
+ */
+export declare function spectrumAt(stops: readonly OklchStop[], t: number): OklchStop;
+/**
+ * Produce `samples` evenly-spaced HEX stops across the anchor ramp — the conic
+ * gradient's color stops, carrying no chroma trough across the sweep. The anchor
+ * stops are CSS color strings parsed via the leaf's `cssToOklch`; CSS `var(--…)`
+ * tokens (the LIBRARY-default brand ramp) are passed through UNTOUCHED (they
+ * resolve in the cascade at paint — the helper only walks CONCRETE color anchors).
+ *
+ * @returns one HEX (`#rrggbb`) per sample, or the raw `var()` strings when the
+ *   anchors are CSS custom-property references (the token-cascade default).
+ */
+export declare function spectrumStops(stops: readonly string[], samples?: number): string[];

package/dist/components/custom/border-progress/constants.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The coverage axis — `full-ring` sweeps the entire border perimeter,
+ * `bottom-edge` paints ONLY the bottom border band (the literal C2 case: "the
+ * bottom progressbar should serve as a thicker, dynamic BORDER"). The two
+ * coverages share the ONE conic-mask mechanism (a `coverage`-scoped mask
+ * region — NOT a second recipe).
+ */
+export type BorderProgressCoverage = "full-ring" | "bottom-edge";
+/**
+ * The thickness envelope (px). AMENDED 6-8px → 10-14px (speedtest AW v3 relay
+ * A1, 2026-06-17): the thin-hairline 6-8px read as a rim, not the "thicker,
+ * dynamic BORDER" the ask wants. The gate W4 + the π assert the band sits inside
+ * [10, 14].
+ */
+export declare const BORDER_PROGRESS_WIDTH_MIN = 10;
+export declare const BORDER_PROGRESS_WIDTH_MAX = 14;
+/** The default ring thickness — the centre of the 10-14px envelope. */
+export declare const BORDER_PROGRESS_WIDTH_DEFAULT = 12;
+/** The default host border-radius (px) the ring follows when unset by the consumer. */
+export declare const BORDER_PROGRESS_RADIUS_DEFAULT = 16;
+/**
+ * The number of conic stops the spectrum walk samples between the consumer's
+ * anchor stops. A denser sample yields a smoother sweep with no visible banding;
+ * the OKLCH/shorter-hue arc keeps every sample saturated (no chroma trough).
+ */
+export declare const BORDER_PROGRESS_SPECTRUM_SAMPLES = 24;
+/**
+ * The LIBRARY-identity default spectrum — the section/viz brand ramp (the
+ * `--section-color-*` 13-stop ramp + the `--viz-*` twins). These resolve through
+ * the CSS token cascade at paint, so the default carries no baked hue; a consumer
+ * that wants its OWN phase palette passes its stops as the `stops` prop
+ * (presets-in-consumers — NO speedtest/ppmycota hue enters a library token).
+ *
+ * The default is a warm→cool brand arc (rose → indigo → violet) sampled off the
+ * 13-stop ramp so the resting ring already reads as "a spectrum of our colors".
+ */
+export declare const BORDER_PROGRESS_DEFAULT_SPECTRUM: readonly string[];
+/**
+ * A phase-edge milestone descriptor — the consumer declares phase boundaries on
+ * the 0..1 (or 0..100) value axis; the ring fires a `milestone` event + (PRM-
+ * gated) pulses when the value crosses one. The chassis `--phase-color` cascade
+ * is the precedent (the bus carries phase IDENTITY; the milestone is the EVENT
+ * seam — the consumer owns the phase colors, presets-in-consumers).
+ */
+export interface BorderProgressMilestone {
+    /** The value-axis boundary (in the same units as `value`). */
+    at: number;
+    /** An opaque id echoed back on the `milestone` emit. */
+    id: string;
+    /** An optional label echoed back on the emit (analytics / a11y). */
+    label?: string;
+}
+/** The payload of the `milestone` emit — the crossed edge + the value at crossing. */
+export interface BorderProgressMilestoneEvent {
+    /** The crossed milestone descriptor. */
+    milestone: BorderProgressMilestone;
+    /** The value at the moment of crossing (post-update). */
+    value: number;
+}

package/dist/components/custom/border-progress/index.d.ts

@@ -0,0 +1,4 @@
+export { default as BorderProgress } from "./BorderProgress.vue";
+export type { BorderProgressProps } from "./BorderProgress.vue";
+export type { BorderProgressCoverage, BorderProgressMilestone, BorderProgressMilestoneEvent, } from "./constants";
+export { spectrumAt, spectrumStops } from "./composables/useBorderSpectrum";

package/dist/components/custom/color-swatch/ColorSwatch.vue.d.ts

@@ -0,0 +1,22 @@
+import { type HTMLAttributes } from "vue";
+type __VLS_Props = {
+    /** The chip edge size. `sm` = 28px, `md` = 32px (default). */
+    size?: "sm" | "md";
+    /** Render the uppercase hex code beside the swatch. Default `false`. */
+    showHex?: boolean;
+    class?: HTMLAttributes["class"];
+};
+type __VLS_ModelProps = {
+    modelValue?: string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    size: "sm" | "md";
+    showHex: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/custom/color-swatch/index.d.ts

@@ -0,0 +1 @@
+export { default as ColorSwatch } from "./ColorSwatch.vue";

package/dist/components/custom/concentric/Concentric.vue.d.ts

@@ -0,0 +1,39 @@
+import type { ConcentricConfig } from "./constants";
+/**
+ * Concentric — a radial Fourier ring-interference field.
+ *
+ * Concentric ellipsoid rings whose interference is a sum of radial harmonics about
+ * one-or-more centers (the cited radial-Fourier math — `composables/ringField.ts`): the
+ * same Fourier-series vocabulary the dot-flow-field's wave potential uses, so the suite
+ * speaks ONE math language. WebGPU-FIRST: a pure fullscreen fragment pass (the aurora
+ * shape-class) evaluates `f(p,t) = Σ_j Σ_i A_i·sin(k_i·‖p−c_j‖_e − ω_i·t + φ_i)` per
+ * pixel, with a clean WebGL2 GLSL fallback where WebGPU is absent. It composes
+ * `useConcentric` → the `createGpuSubstrate` picker over the ONE canvas lifecycle leaf
+ * (offscreen-pause, live-PRM freeze, consumer-owned DPR) — it never bootstraps its own
+ * context.
+ *
+ * The DEFAULT palette is the warm-cream library identity; the demo themes the rings
+ * through a PRESET (presets-in-consumers — never a library token).
+ */
+type __VLS_Props = {
+    /** The full author schema (the studio's `useConfiguratorState` model). */
+    config?: ConcentricConfig;
+    /**
+     * The declarative WCAG-2.2.2 pause seam. `v-model:paused` parks the render loop
+     * (the substrate's `manual` suspend) when `true`. Wire `<DockBackgroundToggle>`'s
+     * `@update:paused` to this `v-model`.
+     */
+    paused?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    pause: () => void;
+    resume: () => void;
+    wake: () => void;
+    renderAt: (timeSec: number) => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:paused": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:paused"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/custom/concentric/composables/concentricGLSetup.d.ts

@@ -0,0 +1,11 @@
+import type { WebGLCanvasFrame } from "../../../../composables/glass/webgl/useWebGLCanvas";
+import type { OklchStop } from "../../../../composables/color";
+import { type ConcentricConfig } from "../constants";
+export interface ConcentricGLSetupDeps {
+    canvas: HTMLCanvasElement;
+    config: ConcentricConfig;
+    getPalette: () => OklchStop[];
+    shouldContinue: () => boolean;
+}
+/** Build the `setupGL(gl)` callback the `createGpuSubstrate` WebGL2 path invokes. */
+export declare function createConcentricGLSetup(deps: ConcentricGLSetupDeps): (gl: WebGL2RenderingContext) => WebGLCanvasFrame;