@mkbabb/glass-ui 4.0.1 → 4.2.0

package/dist/components/custom/paper-grid/constants.d.ts

@@ -0,0 +1,95 @@
+import type { OklchStop } from "../../../composables/color";
+/** The WGSL `#define` cap mirror (the grid is a fullscreen fragment — no array caps needed). */
+export declare const PAPER_GRID_MAX_MAJOR_EVERY = 16;
+/**
+ * The full author schema — the studio's `useConfiguratorState` model (commit-on-write — a
+ * single surface). Every field is a tunable the demo configurator drives; the SFC resolves
+ * it into the uniform table.
+ */
+export interface PaperGridConfig {
+    /** The grid cell pitch in CSS px — LARGER = bigger cells (the user's "LARGER"). */
+    cellSize: number;
+    /** How many minor cells per major rule (the kf `--graph-major` 5rem/1rem ratio). */
+    majorEvery: number;
+    /** Minor line alpha — the calm hairline (≈ kf 3%). */
+    minorAlpha: number;
+    /** Major rule alpha — the bolder tier (kf 11%, above the 10% floor). */
+    majorAlpha: number;
+    /** Line width in device-px — one crisp pixel via Golus AA. */
+    lineWidth: number;
+    /** Max per-cell twist angle at the crest (rad ≈ 15° — a clear lean, never a tumble; ≤ ~18° floor). */
+    twistMax: number;
+    /** Max per-cell shear at the crest — a small skew so the box MORPHS, not just rotates. */
+    shearMax: number;
+    /** The traveling-wave front direction (a gentle diagonal). */
+    waveDir: [number, number];
+    /** The crest-band spatial frequency (LOW — cells per crest). */
+    waveK: number;
+    /** The front speed (slow — inertia). */
+    waveOmega: number;
+    /** The crest-band width (a localized front, not a global pulse). */
+    waveSigma: number;
+    /** The GLOBAL subtlety knob — 1 demo, ~0.12 suffusion (the site-wide background). */
+    fieldAlpha: number;
+    /** How far the cursor pushes the grid (the local bulge). */
+    bulgeStrength: number;
+    /** The Gaussian falloff radius in CELL units. */
+    bulgeRadius: number;
+    /** Push grid away (repel) or toward (attract) the cursor. */
+    bulgeMode: "repel" | "attract";
+    /** The line ink (the warm `--foreground` identity by default — NEVER teal-on-navy). */
+    lineColor: OklchStop;
+    /**
+     * The filled-FACE opacity — **default `0`** so the face EVAPORATES → byte-identical to the
+     * line-only HEAD render (every `proof:viz-papergrid` cage clause + the warm-identity fence
+     * stay GREEN). The demo `PAPER_GRID_PRESET_RIPPLE` lifts it (presets-in-consumers).
+     */
+    faceAlpha: number;
+    /** The slope-shade gain (the ∇H Lambert relief — higher = steeper crest/trough contrast). */
+    faceRelief: number;
+    /** The volume-preserving SQUASH: the plateau inset retreats at the crest so the face inflates. */
+    squashK: number;
+    /** The base inset-square coverage (the soft tile inside the warped cell, 0..0.5 grid units). */
+    baseInset: number;
+    /**
+     * The 3-stop warm-DIVERGENT face ramp (FOLD B — height-keyed, NOT a 2-point mid-park `mix`):
+     * trough → mid → crest. ALL hues ∈ [20,90] (rose-umber → ember/amber → warm-wheat) so the
+     * teal-navy purge is clear by construction. `proof:viz-papergrid` clause reds a hue ∈ [180,280].
+     */
+    faceWarmLo: OklchStop;
+    faceWarmMid: OklchStop;
+    faceWarmHi: OklchStop;
+    /** The fixed cel key-light direction (upper-right) the slope-shade Lamberts against. */
+    lightDir: [number, number];
+    /** The ground (default transparent so it suffuses over the page). */
+    background: OklchStop | "transparent";
+    /** Pointer bulge (§4/§8) — on (demo) / off (suffusion). */
+    interactive: boolean;
+    /** ONE static frame then park under `prefers-reduced-motion: reduce`. */
+    respectReducedMotion: boolean;
+}
+/**
+ * The warm-cream identity line ink (the library default — NOT a themed hue). A warm-amber
+ * ink in the `--foreground` family (OKLab hue ~62, the BA.W-NO-GRAY warm identity) so the
+ * grid reads as warm ink over the page; the SFC resolves the live `--foreground` token at
+ * mount, this stop is the SSR/no-token fallback identity. A consumer (the demo) themes it
+ * through a PRESET, never a token edit. NEVER teal/navy (h in [180,280] reds P5).
+ */
+export declare const WARM_IDENTITY_INK: OklchStop;
+/**
+ * The library-default FACE ramp stops — a CALM warm-divergent fold the face would paint IF lit
+ * (the `faceAlpha:0` default keeps the face evaporated, so these never paint at HEAD; they are
+ * the warm-identity SSR fallback the vivid demo preset overrides). ALL hues ∈ [20,90] — the
+ * teal-navy purge clear by construction (`proof:viz-papergrid` reds a hue ∈ [180,280] here).
+ *   trough → rose-umber, mid → ember-amber, crest → warm-wheat.
+ */
+export declare const FACE_WARM_LO: OklchStop;
+export declare const FACE_WARM_MID: OklchStop;
+export declare const FACE_WARM_HI: OklchStop;
+/**
+ * The shipped warm-identity default config — evenly-spaced, LARGE 64px cells, a crisp fine
+ * rule with a bolder major rule every 5 cells, on a slowly breathing liquid curl-flow sheet
+ * (research/viz/paper-grid.md §6). SUBTLE + LARGE + evenly-spaced — the user's binding
+ * aesthetic. `fieldAlpha: 1` is the demo lead; the suffusion preset drops it to ~0.12.
+ */
+export declare const DEFAULT_PAPER_GRID_CONFIG: PaperGridConfig;

package/dist/components/custom/paper-grid/index.d.ts

@@ -0,0 +1,5 @@
+export { default as PaperGrid } from "./PaperGrid.vue";
+export { usePaperGrid, type PaperGridHandle, type UsePaperGridOptions, } from "./composables/usePaperGrid";
+export { type PaperGridConfig, DEFAULT_PAPER_GRID_CONFIG, WARM_IDENTITY_INK, FACE_WARM_LO, FACE_WARM_MID, FACE_WARM_HI, PAPER_GRID_MAX_MAJOR_EVERY, } from "./constants";
+export { type Vec2, type PaperGridSampleParams, type PaperGridFace, potentialFBM, curlFBM, gridCoverage, samplePaperGrid, gridScaleFor, CURL_EPS, } from "./composables/paperGrid";
+export type { OklchStop } from "../../../composables/color";

package/dist/components/custom/paper-grid/shaders/paper-grid.glsl.d.ts

@@ -0,0 +1,4 @@
+/** The full-screen-triangle vertex shader (the substrate's standard fullscreen pass). */
+export declare const PAPER_GRID_VERT_GLSL = "#version 300 es\nprecision highp float;\nin vec2 aPosition;\nout vec2 vUv;\nvoid main() {\n  vUv = aPosition;            // [-1,1]\u00B2 domain\n  gl_Position = vec4(aPosition, 0.0, 1.0);\n}";
+/** The paper-grid fragment source — the liquid AA-grid (the same field as the WGSL primary). */
+export declare const PAPER_GRID_FRAG_GLSL = "#version 300 es\nprecision highp float;\n\n#define TAU 6.283185307179586\n\nin vec2 vUv;\nout vec4 fragColor;\n\nuniform float uTime;\nuniform float uGridScale;\nuniform float uMajorEvery;\nuniform float uAspect;\nuniform vec4  uWarp;          // (warpScale, warpSpeed, warpScale2, warpSpeed2)\nuniform float uAmplitude;\nuniform vec4  uGrid;          // (targetWidth, targetWidthMajor, minorAlpha, majorAlpha)\nuniform float uFieldAlpha;\nuniform float uHasBackground;\nuniform vec4  uCursor;        // (cursorX, cursorY, swirlStrength, swirlRadius)\nuniform float uBulgeMode;     // +1 repel / \u22121 attract (signs the swirl)\nuniform float uInteractive;   // 1 = cursor swirl on\nuniform vec4  uWave;          // (waveDirX, waveDirY, waveK, waveOmega)\nuniform vec4  uWave2;         // (waveSigma, twistMax, shearMax, amp)\nuniform vec3  uLineColor;     // linear-sRGB ink\nuniform vec3  uBg;            // linear-sRGB themed bg\n// \u2500\u2500 The FACE (BD.W-PAPERGRID-FACE) \u2014 the height-lit filled cell interior \u2500\u2500\nuniform vec4  uFace;          // (faceAlpha, faceRelief, squashK, baseInset)\nuniform vec2  uLightDir;      // the cel key-light direction\nuniform vec3  uFaceLo;        // linear-sRGB rose-umber trough (FOLD B, 3-stop)\nuniform vec3  uFaceMid;       // linear-sRGB ember-amber mid\nuniform vec3  uFaceHi;        // linear-sRGB warm-wheat crest\n\n\nfloat srgbToLinearCh(float c) {\n    return c <= 0.04045 ? c / 12.92 : pow((c + 0.055) / 1.055, 2.4);\n}\nvec3 srgbToLinear(vec3 c) {\n    return vec3(srgbToLinearCh(c.r), srgbToLinearCh(c.g), srgbToLinearCh(c.b));\n}\n\nfloat linearToSrgbCh(float c) {\n    return c <= 0.0031308 ? c * 12.92 : 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\nvec3 linearToSrgb(vec3 c) {\n    return vec3(linearToSrgbCh(c.r), linearToSrgbCh(c.g), linearToSrgbCh(c.b));\n}\n\n// The 3-stop warm-divergent FACE ramp (FOLD B \u2014 height-keyed, NOT a 2-point mid-park). All stops\n// warm hue \u2208 [20,90]; linear-space (the OETF runs in main, FOLD E).\nvec3 faceRamp(float rampT) {\n  float s = clamp(rampT, 0.0, 1.0);\n  if (s < 0.5) {\n    return mix(uFaceLo, uFaceMid, s * 2.0);\n  }\n  return mix(uFaceMid, uFaceHi, (s - 0.5) * 2.0);\n}\n\n// The shared divergence-free 2D-curl operator (flow.glsl.ts) \u2014 the prototype declares\n// potentialFBM; the host defines its BODY below the splice (GLSL forward-declaration).\n\nconst float CURL_EPS = 0.012;\n\n// Scalar fbm potential psi \u2014 the host's noise basis, wrapped so the curl operator is\n// basis-agnostic. A host carrying its own fbm defines this as: return fbm(p);\nfloat potentialFBM(vec2 p);\n\n// \u2207\u00D7\u03C8 in 2D \u2014 the divergence-free flow direction. Central finite differences of the\n// scalar potential give the partials; the cross-pairing (\u2202y, \u2212\u2202x) is the 2D curl.\nvec2 curlFBM(vec2 p) {\n  float dx = potentialFBM(p + vec2(CURL_EPS, 0.0)) - potentialFBM(p - vec2(CURL_EPS, 0.0));\n  float dy = potentialFBM(p + vec2(0.0, CURL_EPS)) - potentialFBM(p - vec2(0.0, CURL_EPS));\n  // \u03C8-gradient is (dx, dy)/(2\u00B7eps); the curl rotates it 90\u00B0: (\u2202\u03C8/\u2202y, \u2212\u2202\u03C8/\u2202x).\n  vec2 g = vec2(dx, dy) / (2.0 * CURL_EPS);\n  return vec2(g.y, -g.x);\n}\n\n\n// \u2500\u2500 The host noise basis (transcribes paperGrid.ts hash21/valueNoise/potentialFBM) \u2500\u2500\nfloat hash21(float x, float y) {\n  float px = fract(x * 0.1031);\n  float py = fract(y * 0.1031);\n  float pz = fract(x * 0.1031);\n  float d = px * (py + 33.33) + py * (pz + 33.33) + pz * (px + 33.33);\n  px += d;\n  py += d;\n  pz += d;\n  return fract((px + py) * pz);\n}\n\nfloat valueNoise(float x, float y) {\n  float ix = floor(x);\n  float iy = floor(y);\n  float fx = x - ix;\n  float fy = y - iy;\n  float ux = fx * fx * fx * (fx * (fx * 6.0 - 15.0) + 10.0);\n  float uy = fy * fy * fy * (fy * (fy * 6.0 - 15.0) + 10.0);\n  float a = hash21(ix, iy);\n  float b = hash21(ix + 1.0, iy);\n  float c = hash21(ix, iy + 1.0);\n  float d2 = hash21(ix + 1.0, iy + 1.0);\n  return mix(mix(a, b, ux), mix(c, d2, ux), uy);\n}\n\n// The 3-octave scalar fbm potential \u2014 the curl chunk's forward-declared potentialFBM body.\nfloat potentialFBM(vec2 p) {\n  float v = 0.0;\n  float amp = 0.5;\n  float freq = 1.0;\n  float px = p.x;\n  float py = p.y;\n  for (int i = 0; i < 3; i++) {\n    v += amp * valueNoise(px * freq, py * freq);\n    // FBM_ROT mat2(0.8, 0.6, -0.6, 0.8) \u2014 same rotation as the shared chunk.\n    float rx = 0.8 * px - 0.6 * py;\n    float ry = 0.6 * px + 0.8 * py;\n    px = rx;\n    py = ry;\n    freq *= 2.0;\n    amp *= 0.5;\n  }\n  return v;\n}\n\n// The shared traveling-wave CELL-WARP chunk (waveField.glsl.ts \u2014 cellTwist/cursorSwirl/\n// travelingEnvelope; spliced AFTER valueNoise + potentialFBM bodies + the curlFBM chunk).\n// paper-grid + concentric share this EXACTLY (the C3 cure: the boxes twist about their own\n// center, the lines stay locally straight \u2014 never the retired LINE-warp).\n\n#ifndef WAVE_FIELD_TAU\n#define WAVE_FIELD_TAU 6.283185307179586\n#endif\n\n// The traveling-wave envelope \u2014 a moving Gaussian crest band sweeping along waveDir.\nfloat travelingEnvelope(vec2 pivot, float t, vec2 waveDir, float waveK, float waveOmega, float waveSigma) {\n  float coord = dot(pivot, waveDir) * waveK - t * waveOmega;\n  float crest = fract(coord / WAVE_FIELD_TAU);\n  float z = (crest - 0.5) * 2.0;\n  return exp(-(z * z) / max(waveSigma, 1e-3));\n}\n\n// The curl-direction scalar \u2014 the smooth low-freq director the per-cell twist follows.\nfloat curlScalar(vec2 cc, float t) {\n  vec2 f = curlFBM(vec2(cc.x * 0.5 + t * 0.08, cc.y * 0.5 - t * 0.06));\n  return clamp(f.x, -1.0, 1.0);\n}\n\n// The directed-twist FLOOR (the visibility cure): keep the curl SIGN (adjacent cells lean\n// together) but floor the magnitude so a crest-band cell ALWAYS rotates decisively.\n#ifndef WAVE_FIELD_TWIST_FLOOR\n#define WAVE_FIELD_TWIST_FLOOR 0.62\n#endif\nfloat directedTwist(float s, float floorMag) {\n  float mag = max(floorMag, abs(s));\n  float sgn = tanh(s * 6.0);\n  return sgn * mag;\n}\n\n// \u2500\u2500 The FACE leaf (the structurally-absent RE-INVENT \u2014 height-lit filled cell interior) \u2500\u2500\n// Defined ABOVE cellTwist: cellTwist rides cellHeight via the driver so twist + face read ONE\n// envelope.\n\n// The sheet displacement at a cell center = the EXACT traveling-wave scalar the twist rides.\nfloat cellHeight(vec2 cc, float t, vec2 waveDir, float waveK, float waveOmega, float waveSigma, float amp) {\n  return travelingEnvelope(cc, t, waveDir, waveK, waveOmega, waveSigma) * amp;\n}\n\n// The pre-twist driver (FOLD A): the cell pivot cc + the crest envelope env the twist AND the\n// face both ride. The face samples height/relief at THIS pre-twist cc (floor(twisted_g) at the\n// crest lights a NEIGHBOUR cell). cc in .xy, env in .z.\nvec3 cellDriver(vec2 g, float cellSize, float t, vec2 waveDir, float waveK, float waveOmega,\n                float waveSigma, float amp) {\n  float cs = max(cellSize, 1e-3);\n  vec2 cc = (floor(g / cs) + 0.5) * cs;\n  float env = cellHeight(cc, t, waveDir, waveK, waveOmega, waveSigma, amp);\n  return vec3(cc, env);\n}\n\n// The central-difference slope of cellHeight across a cell (eps = 0.5\u00B7cellSize) \u2014 derivative-\n// FREE (NO dFdx on the height) \u2192 Safari WebGL2-safe. Returns \u2207H.\nvec2 faceRelief(vec2 cc, float cellSize, float t, vec2 waveDir, float waveK, float waveOmega,\n                float waveSigma, float amp) {\n  float eps = max(cellSize, 1e-3) * 0.5;\n  float hxp = cellHeight(cc + vec2(eps, 0.0), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  float hxm = cellHeight(cc - vec2(eps, 0.0), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  float hyp = cellHeight(cc + vec2(0.0, eps), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  float hym = cellHeight(cc - vec2(0.0, eps), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  return vec2((hxp - hxm) / (2.0 * eps), (hyp - hym) / (2.0 * eps));\n}\n\n// Soft inset-square coverage inside a (warped) cell \u2014 the filled FACE plateau. d is the distance\n// into the cell from the nearest gutter (the Golus triangle-wave); the inset retreats as it grows\n// (the squash). aa = the shader's fwidth(g) (JS passes a fixed uvDeriv).\nfloat facePlateau(vec2 g, float inset, vec2 uvDeriv) {\n  vec2 tri = 1.0 - abs(fract(g) * 2.0 - 1.0);\n  float d = min(tri.x, tri.y);\n  float aa = max(uvDeriv.x, uvDeriv.y) * 1.5;\n  return smoothstep(inset, inset + 2.0 * aa, d);\n}\n\n// The cell-local twist about each cell's own center, gated by the traveling wave + directed\n// by the curl flow. amp is the spring-eased envelope amplitude the JS host drives. FOLD C: the\n// TWIST_FLOOR is crest-gated by env so OFF-crest cells relax to flat calm paper (the traveling\n// read, not static foil).\nvec2 cellTwist(vec2 g, float cellSize, float t, vec2 waveDir, float waveK, float waveOmega,\n               float waveSigma, float twistMax, float shearMax, float amp) {\n  vec3 drv = cellDriver(g, cellSize, t, waveDir, waveK, waveOmega, waveSigma, amp);\n  vec2 cc = drv.xy;\n  float env = drv.z;\n  float floorMag = WAVE_FIELD_TWIST_FLOOR * env;   // FOLD C: crest-gated floor\n  float theta = twistMax * env * directedTwist(curlScalar(cc, t), floorMag);\n  float shear = shearMax * env * directedTwist(curlScalar(cc + vec2(17.3, 9.1), t), floorMag);\n  vec2 local = g - cc;\n  float ct = cos(theta);\n  float st = sin(theta);\n  vec2 rot = vec2(ct * local.x - st * local.y, st * local.x + ct * local.y);\n  rot.x += shear * rot.y;   // a small skew so the box MORPHS, not just rotates\n  return cc + rot;\n}\n\n// The CONTINUOUS traveling-wave FLOW warp \u2014 the SMOOTH twin of cellTwist (no per-cell seam;\n// for the level-set contours that shatter into a mesh under the cell discontinuity).\nvec2 waveFlow(vec2 g, float t, vec2 waveDir, float waveK, float waveOmega, float waveSigma,\n              float twistMax, float amp) {\n  float env = travelingEnvelope(g, t, waveDir, waveK, waveOmega, waveSigma) * amp;\n  vec2 f = curlFBM(vec2(g.x * 0.6 + t * 0.05, g.y * 0.6 - t * 0.04));\n  vec2 f2 = curlFBM(vec2(g.x * 1.1 - t * 0.03, g.y * 1.1 + t * 0.035));\n  float k = twistMax * env;\n  return g + (f + f2 * 0.5) * k;\n}\n\n// The local cursor swirl \u2014 the finger twists the cells around it (re-aimed cursorBulge).\nvec2 cursorSwirl(vec2 g, vec2 cursor, float strength, float radius) {\n  vec2 to = g - cursor;\n  float d2 = dot(to, to);\n  float r = max(radius, 1e-4);\n  float theta = strength * exp(-d2 / (2.0 * r * r));\n  float ct = cos(theta);\n  float st = sin(theta);\n  return cursor + vec2(ct * to.x - st * to.y, st * to.x + ct * to.y);\n}\n\n// The LOW-octave value-noise topography \u2014 the scalar field concentric extracts contours of.\nfloat heightField(vec2 p, float octavesF, float seed) {\n  float v = 0.0;\n  float amp = 0.5;\n  float freq = 1.0;\n  float px = p.x + seed;\n  float py = p.y - seed;\n  int n = int(clamp(octavesF, 1.0, 6.0));\n  for (int i = 0; i < 6; i++) {\n    if (i >= n) break;\n    v += amp * valueNoise(px * freq, py * freq);\n    float rx = 0.8 * px - 0.6 * py;\n    float ry = 0.6 * px + 0.8 * py;\n    px = rx;\n    py = ry;\n    freq *= 2.0;\n    amp *= 0.5;\n  }\n  return v;\n}\n\n// The \u03C9=\u221A(g\u00B7k) breathing swell \u2014 basins inflate/deflate with weight.\nfloat waveSwell(float t, float phase) {\n  return sin(t * 0.35 + phase) * 0.5 + sin(t * 0.21 + phase * 1.7) * 0.5;\n}\n\n\n// \u2500\u2500 \u00A71 The Ben Golus derivative-AA grid coverage (transcribes paperGrid.ts gridCoverage) \u2500\u2500\nfloat gridCoverage(vec2 g, float targetWidth, vec2 uvDeriv) {\n  vec2 gridUV = 1.0 - abs(fract(g) * 2.0 - 1.0);\n  vec2 drawWidth = clamp(vec2(targetWidth), uvDeriv, vec2(0.5));\n  vec2 lineAA = uvDeriv * 1.5;\n  vec2 grid2 = smoothstep(drawWidth + lineAA, drawWidth - lineAA, gridUV);\n  grid2 *= clamp(vec2(targetWidth) / max(drawWidth, vec2(1e-6)), vec2(0.0), vec2(1.0));\n  grid2 = mix(grid2, vec2(targetWidth), clamp(uvDeriv * 2.0 - 1.0, vec2(0.0), vec2(1.0)));\n  return max(grid2.x, grid2.y);\n}\n\nvoid main() {\n  float aspect = max(uAspect, 1e-4);\n  vec2 uv = vec2(vUv.x * aspect, vUv.y);\n\n  // \u00A75 the per-pixel kernel: CELL-TWIST + cursor-swirl the grid coordinate, then two-tier Golus.\n  // cellTwist rotates each cell about its OWN center (the boxes twist, the lines stay locally\n  // straight \u2014 the C3 cure) gated by a traveling Gaussian crest; cursorSwirl twists the cells\n  // about the finger. The Golus dv reads the FINAL twisted coord (the crisp-line fence survives).\n  vec2 g0 = uv * uGridScale;\n  // FOLD A \u2014 the PRE-twist driver: the face samples height/relief at THIS cc (floor(twisted_g)\n  // at the crest lights a NEIGHBOUR cell). cellTwist rides the SAME driver, so twist + face fuse.\n  vec3 drv = cellDriver(g0, 1.0, uTime, uWave.xy, uWave.z, uWave.w, uWave2.x, uWave2.w);\n  vec2 cc = drv.xy;\n  vec2 g = cellTwist(g0, 1.0, uTime, uWave.xy, uWave.z, uWave.w, uWave2.x, uWave2.y, uWave2.z, uWave2.w);\n  if (uInteractive > 0.5) {\n    g = cursorSwirl(g, uCursor.xy, uCursor.z * uBulgeMode, uCursor.w);\n  }\n\n  // The screen-space derivative of g (Golus): length(vec2(dFdx, dFdy)) per axis (the actual\n  // backing-store pixel \u2014 NOT a CSS sub-pixel, the blur-kill).\n  vec2 dv = vec2(\n    length(vec2(dFdx(g.x), dFdy(g.x))),\n    length(vec2(dFdx(g.y), dFdy(g.y)))\n  );\n\n  float minor = gridCoverage(g, uGrid.x, dv);\n  float me = max(uMajorEvery, 1.0);\n  float major = gridCoverage(g / me, uGrid.y, dv / me);\n  float line = max(minor * uGrid.z, major * uGrid.w);\n\n  // \u2500\u2500 The FACE (BD.W-PAPERGRID-FACE) \u2014 height-lit filled cell interior \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Sample height/relief at the pre-twist driver cc (FOLD A); Lambert the \u2207H slope against the\n  // fixed cel key-light; squash the inset so the crest face inflates; multi-stop warm-divergent\n  // ramp keyed on mix(shade, h) (FOLD B); the ink through the production OETF (FOLD E).\n  float h      = cellHeight(cc, uTime, uWave.xy, uWave.z, uWave.w, uWave2.x, uWave2.w);\n  vec2  grad   = faceRelief(cc, 1.0, uTime, uWave.xy, uWave.z, uWave.w, uWave2.x, uWave2.w);\n  vec3  n      = normalize(vec3(-grad * uFace.y, 1.0));\n  float shade  = clamp(0.5 + dot(n, normalize(vec3(uLightDir, 1.0))) * 0.5, 0.0, 1.0);\n  float inset  = uFace.w * (1.0 - uFace.z * h);            // squash & stretch\n  float face   = facePlateau(g, inset, dv);\n  float rampT  = clamp(shade * 0.5 + h * 0.5, 0.0, 1.0);   // FOLD B \u2014 height-keyed crest\n  vec3  faceInk = clamp(linearToSrgb(faceRamp(rampT)), vec3(0.0), vec3(1.0));\n  float faceA  = face * uFace.x * uFieldAlpha;             // FOLD D \u2014 one field-blend scalar\n\n  vec3 col = clamp(linearToSrgb(uLineColor), vec3(0.0), vec3(1.0));\n  if (uHasBackground > 0.5) {\n    vec3 bg = clamp(linearToSrgb(uBg), vec3(0.0), vec3(1.0));\n    vec3 base = mix(bg, faceInk, faceA);\n    float a = line * uFieldAlpha;\n    fragColor = vec4(mix(base, col, a), 1.0);\n    return;\n  }\n  // transparent ground: the FACE composites UNDER the line, the SOURCE-OVER operator in\n  // PREMULTIPLIED space. faceAlpha:0 \u2192 faceA=0 \u2192 the face term vanishes \u2192 vec4(col\u00B7line, line) =\n  // byte-identical to the HEAD line-only render.\n  vec3 linePremult = (col * line) * uFieldAlpha;          // line layer (the FieldAlpha subtlety)\n  float lineA = line * uFieldAlpha;\n  vec3 facePremult = faceInk * faceA;                     // face layer premultiplied (faceA folds field)\n  vec3 outPremult = linePremult + facePremult * (1.0 - lineA);\n  float a = lineA + faceA * (1.0 - lineA);\n  fragColor = vec4(outPremult, a);  // premultiplied over transparent\n}";

package/dist/components/custom/paper-grid/shaders/paper-grid.wgsl.d.ts

@@ -0,0 +1 @@
+export declare const PAPER_GRID_WGSL = "\nconst TAU: f32 = 6.283185307179586;\n\n// \u2500\u2500 Paper-grid uniforms (the typed-struct source-of-truth \u2014 see uniformBridgeWGPU.ts) \u2500\u2500\nstruct PaperGridUniforms {\n  // u0: (uTime, uGridScale, uMinorPitch, uMajorEvery)\n  u0: vec4<f32>,\n  // face: (uFaceAlpha, uFaceRelief, uSquashK, uBaseInset) \u2014 the height-lit FACE (re-points the retired warp lane)\n  face: vec4<f32>,\n  // warp2: (uAmplitude, uAspect, uLightDirX, uLightDirY) \u2014 aspect + the cel key-light\n  warp2: vec4<f32>,\n  // grid: (uTargetWidth, uTargetWidthMajor, uMinorAlpha, uMajorAlpha)\n  grid: vec4<f32>,\n  // field: (uFieldAlpha, uHasBackground, _pad, _pad)\n  field: vec4<f32>,\n  // cursor: (uCursorX, uCursorY, uSwirlStrength, uSwirlRadius)\n  cursor: vec4<f32>,\n  // cursor2: (uBulgeMode, uInteractive, _pad, _pad)\n  cursor2: vec4<f32>,\n  // line: (uLineColor.rgb (linear), _pad)\n  line: vec4<f32>,\n  // bg: (uBg.rgb (linear), _pad)\n  bg: vec4<f32>,\n  // wave: (waveDirX, waveDirY, waveK, waveOmega) \u2014 the traveling-wave crest\n  wave: vec4<f32>,\n  // wave2: (waveSigma, twistMax, shearMax, amp) \u2014 the cell-twist envelope (amp: spring-eased)\n  wave2: vec4<f32>,\n  // faceLo: (rose-umber trough .rgb (linear), _pad) \u2014 the warm-divergent ramp (FOLD B, 3-stop)\n  faceLo: vec4<f32>,\n  // faceMid: (ember-amber mid .rgb (linear), _pad)\n  faceMid: vec4<f32>,\n  // faceHi: (warm-wheat crest .rgb (linear), _pad)\n  faceHi: vec4<f32>,\n};\n\n@group(0) @binding(0) var<uniform> u: PaperGridUniforms;\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// \u2500\u2500 The host noise basis (transcribes paperGrid.ts hash21/valueNoise/potentialFBM) \u2500\u2500\n// A quintic-faded 2D value-noise fbm potential \u2014 the SAME basis the dot-flow-field carries\n// (so the suite speaks ONE noise basis). DECLARED ABOVE the curl splice (WGSL has no forward\n// declaration \u2014 a function may only call one declared earlier).\nfn hash21(x: f32, y: f32) -> f32 {\n  var px = fract(x * 0.1031);\n  var py = fract(y * 0.1031);\n  var pz = fract(x * 0.1031);\n  let d = px * (py + 33.33) + py * (pz + 33.33) + pz * (px + 33.33);\n  px = px + d;\n  py = py + d;\n  pz = pz + d;\n  return fract((px + py) * pz);\n}\n\nfn valueNoise(x: f32, y: f32) -> f32 {\n  let ix = floor(x);\n  let iy = floor(y);\n  let fx = x - ix;\n  let fy = y - iy;\n  let ux = fx * fx * fx * (fx * (fx * 6.0 - 15.0) + 10.0);\n  let uy = fy * fy * fy * (fy * (fy * 6.0 - 15.0) + 10.0);\n  let a = hash21(ix, iy);\n  let b = hash21(ix + 1.0, iy);\n  let c = hash21(ix, iy + 1.0);\n  let d2 = hash21(ix + 1.0, iy + 1.0);\n  return mix(mix(a, b, ux), mix(c, d2, ux), uy);\n}\n\n// The 3-octave scalar fbm potential \u2014 the host noise basis the curl operator wraps.\nfn potentialFBM(p: vec2f) -> f32 {\n  var v = 0.0;\n  var amp = 0.5;\n  var freq = 1.0;\n  var px = p.x;\n  var py = p.y;\n  for (var i = 0; i < 3; i = i + 1) {\n    v = v + amp * valueNoise(px * freq, py * freq);\n    // FBM_ROT mat2(0.8, 0.6, -0.6, 0.8) \u2014 same rotation as the shared chunk.\n    let rx = 0.8 * px - 0.6 * py;\n    let ry = 0.6 * px + 0.8 * py;\n    px = rx;\n    py = ry;\n    freq = freq * 2.0;\n    amp = amp * 0.5;\n  }\n  return v;\n}\n\n// The shared divergence-free 2D-curl operator (flow.wgsl.ts \u2014 the FIRST WGSL curl consumer).\n\nconst CURL_EPS: f32 = 0.012;\n\n// \u2207\u00D7\u03C8 in 2D \u2014 the divergence-free flow direction. Central finite differences of the\n// scalar potential give the partials; the cross-pairing (\u2202y, \u2212\u2202x) is the 2D curl.\nfn curlFBM(p: vec2f) -> vec2f {\n  let dx = potentialFBM(p + vec2f(CURL_EPS, 0.0)) - potentialFBM(p - vec2f(CURL_EPS, 0.0));\n  let dy = potentialFBM(p + vec2f(0.0, CURL_EPS)) - potentialFBM(p - vec2f(0.0, CURL_EPS));\n  // \u03C8-gradient is (dx, dy)/(2\u00B7eps); the curl rotates it 90\u00B0: (\u2202\u03C8/\u2202y, \u2212\u2202\u03C8/\u2202x).\n  let g = vec2f(dx, dy) / (2.0 * CURL_EPS);\n  return vec2f(g.y, -g.x);\n}\n\n\n// The shared traveling-wave CELL-WARP chunk (waveField.wgsl.ts \u2014 cellTwist/cursorSwirl/\n// travelingEnvelope; splices AFTER valueNoise + curlFBM are declared). paper-grid + concentric\n// share this EXACTLY \u2014 the cell-local twist replaces the retired LINE-warp (the C3 cure: the\n// boxes twist about their own center, the lines stay locally straight).\n\nconst WAVE_FIELD_TAU: f32 = 6.283185307179586;\n\n// The traveling-wave envelope \u2014 a moving Gaussian crest band sweeping along waveDir.\nfn travelingEnvelope(pivot: vec2f, t: f32, waveDir: vec2f, waveK: f32, waveOmega: f32, waveSigma: f32) -> f32 {\n  let coord = dot(pivot, waveDir) * waveK - t * waveOmega;\n  let crest = fract(coord / WAVE_FIELD_TAU);\n  let z = (crest - 0.5) * 2.0;\n  return exp(-(z * z) / max(waveSigma, 1e-3));\n}\n\n// The curl-direction scalar \u2014 the smooth low-freq director the per-cell twist follows.\nfn curlScalar(cc: vec2f, t: f32) -> f32 {\n  let f = curlFBM(vec2f(cc.x * 0.5 + t * 0.08, cc.y * 0.5 - t * 0.06));\n  return clamp(f.x, -1.0, 1.0);\n}\n\n// The directed-twist FLOOR (the visibility cure): keep the curl SIGN (adjacent cells lean\n// together) but floor the magnitude so a crest-band cell ALWAYS rotates decisively.\nconst WAVE_FIELD_TWIST_FLOOR: f32 = 0.62;\nfn directedTwist(s: f32, floorMag: f32) -> f32 {\n  let mag = max(floorMag, abs(s));\n  let sgn = tanh(s * 6.0);\n  return sgn * mag;\n}\n\n// \u2500\u2500 The FACE leaf (the structurally-absent RE-INVENT \u2014 height-lit filled cell interior) \u2500\u2500\n// DECLARED ABOVE cellTwist (no WGSL forward declaration): cellTwist rides cellHeight via the\n// driver so twist + face read ONE envelope.\n\n// The sheet displacement at a cell center = the EXACT traveling-wave scalar the twist rides.\nfn cellHeight(cc: vec2f, t: f32, waveDir: vec2f, waveK: f32, waveOmega: f32, waveSigma: f32, amp: f32) -> f32 {\n  return travelingEnvelope(cc, t, waveDir, waveK, waveOmega, waveSigma) * amp;\n}\n\n// The pre-twist driver (FOLD A): the cell pivot cc + the crest envelope env the twist AND the\n// face both ride. The face samples height/relief at THIS pre-twist cc (the crest twist crosses\n// the cell boundary \u2192 floor(twisted_g) would light a NEIGHBOUR cell). cc in .xy, env in .z.\nfn cellDriver(g: vec2f, cellSize: f32, t: f32, waveDir: vec2f, waveK: f32, waveOmega: f32,\n              waveSigma: f32, amp: f32) -> vec3f {\n  let cs = max(cellSize, 1e-3);\n  let cc = (floor(g / cs) + 0.5) * cs;\n  let env = cellHeight(cc, t, waveDir, waveK, waveOmega, waveSigma, amp);\n  return vec3f(cc, env);\n}\n\n// The central-difference slope of cellHeight across a cell (eps = 0.5\u00B7cellSize) \u2014 derivative-\n// FREE (NO dFdx on the height) \u2192 Safari WebGL2-safe. Returns \u2207H.\nfn faceRelief(cc: vec2f, cellSize: f32, t: f32, waveDir: vec2f, waveK: f32, waveOmega: f32,\n              waveSigma: f32, amp: f32) -> vec2f {\n  let eps = max(cellSize, 1e-3) * 0.5;\n  let hxp = cellHeight(cc + vec2f(eps, 0.0), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  let hxm = cellHeight(cc - vec2f(eps, 0.0), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  let hyp = cellHeight(cc + vec2f(0.0, eps), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  let hym = cellHeight(cc - vec2f(0.0, eps), t, waveDir, waveK, waveOmega, waveSigma, amp);\n  return vec2f((hxp - hxm) / (2.0 * eps), (hyp - hym) / (2.0 * eps));\n}\n\n// Soft inset-square coverage inside a (warped) cell \u2014 the filled FACE plateau. d is the\n// distance into the cell from the nearest gutter (the Golus triangle-wave); the inset retreats\n// as it grows (the squash). aa = the shader's fwidth(g) (JS passes a fixed uvDeriv).\nfn facePlateau(g: vec2f, inset: f32, uvDeriv: vec2f) -> f32 {\n  let tri = 1.0 - abs(fract(g) * 2.0 - 1.0);\n  let d = min(tri.x, tri.y);\n  let aa = max(uvDeriv.x, uvDeriv.y) * 1.5;\n  return smoothstep(inset, inset + 2.0 * aa, d);\n}\n\n// The cell-local twist about each cell's own center, gated by the traveling wave + directed\n// by the curl flow. amp is the spring-eased envelope amplitude the JS host drives. FOLD C: the\n// TWIST_FLOOR is crest-gated by env so OFF-crest cells relax to flat calm paper (the traveling\n// read, not static foil).\nfn cellTwist(g: vec2f, cellSize: f32, t: f32, waveDir: vec2f, waveK: f32, waveOmega: f32,\n             waveSigma: f32, twistMax: f32, shearMax: f32, amp: f32) -> vec2f {\n  let drv = cellDriver(g, cellSize, t, waveDir, waveK, waveOmega, waveSigma, amp);\n  let cc = drv.xy;\n  let env = drv.z;\n  let floorMag = WAVE_FIELD_TWIST_FLOOR * env;   // FOLD C: crest-gated floor\n  let theta = twistMax * env * directedTwist(curlScalar(cc, t), floorMag);\n  let shear = shearMax * env * directedTwist(curlScalar(cc + vec2f(17.3, 9.1), t), floorMag);\n  let local = g - cc;\n  let ct = cos(theta);\n  let st = sin(theta);\n  var rot = vec2f(ct * local.x - st * local.y, st * local.x + ct * local.y);\n  rot.x = rot.x + shear * rot.y;   // a small skew so the box MORPHS, not just rotates\n  return cc + rot;\n}\n\n// The CONTINUOUS traveling-wave FLOW warp \u2014 the SMOOTH twin of cellTwist (no per-cell seam;\n// for the level-set contours that shatter into a mesh under the cell discontinuity).\nfn waveFlow(g: vec2f, t: f32, waveDir: vec2f, waveK: f32, waveOmega: f32, waveSigma: f32,\n            twistMax: f32, amp: f32) -> vec2f {\n  let env = travelingEnvelope(g, t, waveDir, waveK, waveOmega, waveSigma) * amp;\n  let f = curlFBM(vec2f(g.x * 0.6 + t * 0.05, g.y * 0.6 - t * 0.04));\n  let f2 = curlFBM(vec2f(g.x * 1.1 - t * 0.03, g.y * 1.1 + t * 0.035));\n  let k = twistMax * env;\n  return g + (f + f2 * 0.5) * k;\n}\n\n// The local cursor swirl \u2014 the finger twists the cells around it (re-aimed cursorBulge).\nfn cursorSwirl(g: vec2f, cursor: vec2f, strength: f32, radius: f32) -> vec2f {\n  let to = g - cursor;\n  let d2 = dot(to, to);\n  let r = max(radius, 1e-4);\n  let theta = strength * exp(-d2 / (2.0 * r * r));\n  let ct = cos(theta);\n  let st = sin(theta);\n  return cursor + vec2f(ct * to.x - st * to.y, st * to.x + ct * to.y);\n}\n\n// The LOW-octave value-noise topography \u2014 the scalar field concentric extracts contours of.\nfn heightField(p: vec2f, octavesF: f32, seed: f32) -> f32 {\n  var v = 0.0;\n  var amp = 0.5;\n  var freq = 1.0;\n  var px = p.x + seed;\n  var py = p.y - seed;\n  let n = i32(clamp(octavesF, 1.0, 6.0));\n  for (var i = 0; i < 6; i = i + 1) {\n    if (i >= n) { break; }\n    v = v + amp * valueNoise(px * freq, py * freq);\n    let rx = 0.8 * px - 0.6 * py;\n    let ry = 0.6 * px + 0.8 * py;\n    px = rx;\n    py = ry;\n    freq = freq * 2.0;\n    amp = amp * 0.5;\n  }\n  return v;\n}\n\n// The \u03C9=\u221A(g\u00B7k) breathing swell \u2014 basins inflate/deflate with weight.\nfn waveSwell(t: f32, phase: f32) -> f32 {\n  return sin(t * 0.35 + phase) * 0.5 + sin(t * 0.21 + phase * 1.7) * 0.5;\n}\n\n\n// \u2500\u2500 \u00A71 The crisp line: Ben Golus derivative-AA grid coverage (transcribes gridCoverage) \u2500\u2500\n// targetWidth is the line half-width in GRID UNITS (lineWidthPx / minorPitchPx); uvDeriv is\n// the per-axis screen-space derivative of g (length(vec2(dpdx, dpdy)) per axis). Returns\n// line coverage [0..1] \u2014 exactly N device-pixels wide at ANY DPR/zoom (the blur-kill).\nfn gridCoverage(g: vec2f, targetWidth: f32, uvDeriv: vec2f) -> f32 {\n  // triangle wave per axis: 0 at a line, 1 at the cell center.\n  let gridUV = 1.0 - abs(fract(g) * 2.0 - 1.0);\n  let drawWidth = clamp(vec2f(targetWidth), uvDeriv, vec2f(0.5));\n  let lineAA = uvDeriv * 1.5;\n  // smoothstep with edge0 > edge1 (Golus) \u2192 a falling edge.\n  var grid2 = smoothstep(drawWidth + lineAA, drawWidth - lineAA, gridUV);\n  // preserve thin-line intensity where the line is sub-drawWidth.\n  grid2 = grid2 * clamp(vec2f(targetWidth) / max(drawWidth, vec2f(1e-6)), vec2f(0.0), vec2f(1.0));\n  // Moir\u00E9 suppression: fade toward the average where the cell packs tighter than a pixel.\n  grid2 = mix(grid2, vec2f(targetWidth), clamp(uvDeriv * 2.0 - 1.0, vec2f(0.0), vec2f(1.0)));\n  return max(grid2.x, grid2.y);\n}\n\n// \u2500\u2500 The 3-stop warm-divergent FACE ramp (FOLD B \u2014 height-keyed, NOT a 2-point mid-park) \u2500\u2500\n// trough (faceLo) \u2192 mid (faceMid) \u2192 crest (faceHi), keyed on rampT = mix(shade, h). All stops\n// are warm hue \u2208 [20,90] (the teal-navy purge clear by construction). Linear-space stops; the\n// fs_main routes the result through the production OETF (FOLD E).\nfn faceRamp(rampT: f32) -> vec3f {\n  let s = clamp(rampT, 0.0, 1.0);\n  if (s < 0.5) {\n    return mix(u.faceLo.rgb, u.faceMid.rgb, s * 2.0);\n  }\n  return mix(u.faceMid.rgb, u.faceHi.rgb, (s - 0.5) * 2.0);\n}\n\n// Full-screen-triangle (the pilot idiom): NDC corners (-1,-1),(3,-1),(-1,3) cover the\n// viewport from a single 3-vertex draw \u2014 no vertex buffer.\nstruct VSOut {\n  @builtin(position) pos: vec4f,\n  @location(0) uv: vec2f,  // domain [-1,1]\u00B2, aspect-corrected x\n};\n\n@vertex\nfn vs_main(@builtin(vertex_index) vi: u32) -> VSOut {\n  var corners = array<vec2f, 3>(\n    vec2f(-1.0, -1.0), vec2f(3.0, -1.0), vec2f(-1.0, 3.0),\n  );\n  let c = corners[vi];\n  var out: VSOut;\n  out.pos = vec4f(c, 0.0, 1.0);\n  out.uv = vec2f(c.x, c.y);\n  return out;\n}\n\n@fragment\nfn fs_main(in: VSOut) -> @location(0) vec4f {\n  let aspect = max(u.warp2.y, 1e-4);\n  // aspect-correct the domain x so the cells read square.\n  let uv = vec2f(in.uv.x * aspect, in.uv.y);\n  let t = u.u0.x;\n  let gridScale = u.u0.y;\n\n  // \u00A75 the per-pixel kernel: CELL-TWIST + cursor-swirl the grid coordinate, then two-tier Golus.\n  // cellTwist rotates each cell about its OWN center (the boxes twist, the lines stay locally\n  // straight \u2014 the C3 cure) gated by a traveling Gaussian crest; cursorSwirl twists the cells\n  // about the finger. The Golus dv reads the FINAL twisted coord (the crisp-line fence survives).\n  let g0 = uv * gridScale;\n  // FOLD A \u2014 the PRE-twist driver: the face samples height/relief at THIS cc (floor(twisted_g)\n  // at the crest lights a NEIGHBOUR cell). cellTwist rides the SAME driver, so twist + face fuse.\n  let drv = cellDriver(g0, 1.0, t, u.wave.xy, u.wave.z, u.wave.w, u.wave2.x, u.wave2.w);\n  let cc = drv.xy;\n  var g = cellTwist(g0, 1.0, t, u.wave.xy, u.wave.z, u.wave.w, u.wave2.x, u.wave2.y, u.wave2.z, u.wave2.w);\n  if (u.cursor2.y > 0.5) {\n    // bulgeMode (cursor2.x: +repel / \u2212attract) signs the swirl direction.\n    g = cursorSwirl(g, u.cursor.xy, u.cursor.z * u.cursor2.x, u.cursor.w);\n  }\n\n  // The screen-space derivative of g (Golus): length(vec2(dpdx, dpdy)) per axis. fwidth-class\n  // derivative reads the ACTUAL backing-store pixel (NOT fwidthFine \u2014 Compatibility-Mode safe).\n  let dv = vec2f(\n    length(vec2f(dpdx(g.x), dpdy(g.x))),\n    length(vec2f(dpdx(g.y), dpdy(g.y))),\n  );\n\n  let minor = gridCoverage(g, u.grid.x, dv);\n  // The major tier evals at g / majorEvery with its own derivative scaling.\n  let me = max(u.u0.w, 1.0);\n  let major = gridCoverage(g / me, u.grid.y, dv / me);\n  let line = max(minor * u.grid.z, major * u.grid.w);\n\n  // \u2500\u2500 The FACE (BD.W-PAPERGRID-FACE) \u2014 height-lit filled cell interior \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Sample height/relief at the pre-twist driver cc (FOLD A); Lambert the \u2207H slope against the\n  // fixed cel key-light; squash the inset so the crest face inflates; multi-stop warm-divergent\n  // ramp keyed on mix(shade, h) (FOLD B); the ink through the production OETF (FOLD E).\n  let h     = cellHeight(cc, t, u.wave.xy, u.wave.z, u.wave.w, u.wave2.x, u.wave2.w);\n  let grad  = faceRelief(cc, 1.0, t, u.wave.xy, u.wave.z, u.wave.w, u.wave2.x, u.wave2.w);\n  let n     = normalize(vec3f(-grad * u.face.y, 1.0));\n  let shade = clamp(0.5 + dot(n, normalize(vec3f(u.warp2.zw, 1.0))) * 0.5, 0.0, 1.0);\n  let inset = u.face.w * (1.0 - u.face.z * h);            // squash & stretch\n  let face  = facePlateau(g, inset, dv);\n  let rampT = clamp(shade * 0.5 + h * 0.5, 0.0, 1.0);     // FOLD B \u2014 height-keyed crest\n  let faceInk = clamp(linearToSrgb(faceRamp(rampT)), vec3f(0.0), vec3f(1.0));\n  let faceA = face * u.face.x * u.field.x;                // FOLD D \u2014 one field-blend scalar\n\n  let col = clamp(linearToSrgb(u.line.rgb), vec3f(0.0), vec3f(1.0));\n  let hasBg = u.field.y;\n  if (hasBg > 0.5) {\n    // opaque ground: the face fills the cell, the ink over the themed bg, the line on top.\n    let bg = clamp(linearToSrgb(u.bg.rgb), vec3f(0.0), vec3f(1.0));\n    let base = mix(bg, faceInk, faceA);\n    let a = line * u.field.x;\n    let outRgb = mix(base, col, a);\n    return vec4f(outRgb, 1.0);\n  }\n  // transparent ground: the FACE composites UNDER the line, the SOURCE-OVER operator in\n  // PREMULTIPLIED space (the page reads through the gutters). faceAlpha:0 \u2192 faceA=0 \u2192 the face\n  // term vanishes \u2192 vec4f(col\u00B7line, line) = byte-identical to the HEAD line-only render.\n  let linePremult = (col * line) * u.field.x;            // line layer (the FieldAlpha global subtlety)\n  let lineA = line * u.field.x;\n  let facePremult = faceInk * faceA;                     // face layer premultiplied (faceA folds field.x)\n  let outPremult = linePremult + facePremult * (1.0 - lineA);\n  let a = lineA + faceA * (1.0 - lineA);\n  return vec4f(outPremult, a);                           // premultiplied over transparent\n}\n";

package/dist/components/custom/search/FuzzySearch.vue.d.ts

@@ -1,7 +1,11 @@
+import type { Surface } from "../../ui/_shared/useSurfaceAxis";
+import { type ControlSize, type SearchVariant } from "./searchVariants";
 import type { FuzzySearchState, SearchableItem } from "./composables/types";
 type __VLS_Props = {
     state: FuzzySearchState;
-    variant?: "sidebar" | "floating";
+    variant?: SearchVariant;
+    size?: ControlSize;
+    surface?: Surface;
     placeholder?: string;
     typeLabel?: (item: SearchableItem) => string;
 };
@@ -9,7 +13,9 @@ declare function focus(): void;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
     focus: typeof focus;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    variant: "sidebar" | "floating";
+    size: ControlSize;
+    variant: SearchVariant;
+    surface: Surface;
     placeholder: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/components/custom/search/SearchBar.vue.d.ts

@@ -1,9 +1,14 @@
 import { type Component } from "vue";
+import type { Surface } from "../../ui/_shared/useSurfaceAxis";
+import { type ControlSize, type SearchVariant } from "./searchVariants";
 type __VLS_Props = {
     modelValue?: string;
     placeholder?: string;
     icon?: Component;
     tag?: string;
+    size?: ControlSize;
+    surface?: Surface;
+    variant?: SearchVariant;
 };
 declare var __VLS_13: {};
 type __VLS_Slots = {} & {
@@ -16,6 +21,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
+    size: ControlSize;
+    variant: SearchVariant;
+    surface: Surface;
     modelValue: string;
     placeholder: string;
     tag: string;

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

@@ -1,5 +1,7 @@
 export { default as FuzzySearch } from "./FuzzySearch.vue";
 export { default as SearchBar } from "./SearchBar.vue";
+export { searchFieldVariants } from "./searchVariants";
+export type { SearchVariant, SearchVariants } from "./searchVariants";
 export { useFuzzySearch } from "./composables/useFuzzySearch";
 export type { UseFuzzySearchOptions } from "./composables/useFuzzySearch";
 export { buildIndex, searchIndex, fuzzyMatch, clearSearchCache } from "./composables/fuzzySearchIndex";

package/dist/components/custom/search/searchVariants.d.ts

@@ -0,0 +1,19 @@
+import { type VariantProps } from "class-variance-authority";
+import { type ControlSize, controlSizeClass } from "../../ui/_shared/useControlSize";
+/**
+ * The search field-CHROME variant. `inline` is the boxed glass pill (identity over
+ * the `.input-bar` recipe); `bare`/`floating` strip the box to a chromeless field —
+ * the real CVA rung the `!important` cluster was fighting (clean break, no `!`).
+ *
+ *   searchFieldVariants()                    → ""                                          (the boxed pill)
+ *   searchFieldVariants({ variant: "bare" }) → "border-none bg-transparent p-0 rounded-none"
+ */
+export declare const searchFieldVariants: (props?: ({
+    variant?: "floating" | "inline" | "bare" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type SearchVariant = NonNullable<VariantProps<typeof searchFieldVariants>["variant"]>;
+/** The CVA's variant-prop shape — the `/api` discovery surface (the SFCs cannot
+ *  re-export a type, so this CVA home is the type source). */
+export type SearchVariants = VariantProps<typeof searchFieldVariants>;
+export { controlSizeClass };
+export type { ControlSize };

package/dist/components/custom/selectable-chip/SelectableChip.vue.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SelectableChip — the public face of the BC.W-ACCENT-TONE tonal-accent register.
+ * A reka-`Toggle` selectable chip whose COLOUR identity comes from ONE `:tone` (a
+ * complete `<color>`): the chip reads the `.accent-tone` register — a faint idle
+ * FILL floored ≥3:1 (legible at rest, the load-bearing fourier ask), a bolder active
+ * BAND + EDGE rim, and a contrast-safe INK label (auto-darkened/lightened by value.js
+ * `safeAccentColor` so the text never drops below AA over the resolved band).
+ *
+ * Usage:
+ *   <SelectableChip v-model="on" :tone="'var(--section-color-7)'">React</SelectableChip>
+ *
+ * The toggle state is the reka-ui Toggle `modelValue` contract — bind via `v-model`
+ * (or `:model-value` / `@update:model-value`). For an exclusive picker, wire the chips
+ * via direct refs (deliberately unopinionated about ToggleGroup — the ToggleChip
+ * precedent).
+ *
+ * VALUE.JS-BEARING: this SFC STATICALLY imports `useAccentTone` (the contrast-safe-ink
+ * composable, which reaches value.js `safeAccentColor`/`computeSafeAccent`), so the
+ * chip chunk transitively reaches value.js — it ships on `/selectable-chip` ONLY, OFF
+ * the value.js-free root barrel (the BorderProgress/EasingPicker SCC-trap precedent).
+ */
+import type { HTMLAttributes } from "vue";
+import { type ToggleProps } from "reka-ui";
+import { type SelectableChipVariants } from "./selectableChipVariants";
+type __VLS_Props = ToggleProps & {
+    /** The accent COLOUR identity — a complete `<color>` (e.g. `var(--section-color-7)`
+     *  or a concrete `oklch(…)`). Defaults to `var(--primary)` via the register. The
+     *  SEMANTIC choice is a prop; the strength MAGNITUDES are tokens (no over-prop). */
+    tone?: string;
+    /** The structural size rung. Default `md`. */
+    size?: SelectableChipVariants["size"];
+    class?: HTMLAttributes["class"];
+};
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => 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/selectable-chip/chipVariants.d.ts

@@ -0,0 +1,39 @@
+import { type VariantProps } from "class-variance-authority";
+/**
+ * chipVariants — the ONE congruent chip recipe (BD.W-CHIP-CONGRUENT-GLASS).
+ *
+ * The chip family (ToggleChip · SelectableChip + the toggle-group children)
+ * collapses to ONE `chipVariants({ size })`: a stadium-pill warm-glass LENS that
+ * PUNCHES when you pick it. Survival of the fittest — `selectableChipVariants`
+ * (`sm`/`md`/`lg`) + the `ToggleChip` `chip`/`cell` axis collapse here (clean
+ * break, no alias — the no-legacy law). The three SFCs stay DISTINCT (bool toggle
+ * vs tonal picker vs glyph tile) but render the SAME register.
+ *
+ * The recipe is STRUCTURE + the shared-register hooks: it COMPOSES the read-only
+ * shared registers, never re-forks a parallel glass/cartoon/motion system —
+ *   · `.glass-chip`         — the chip-family material/motion layer (the warm idle
+ *                             floor + the `--glass-fill-tint` plate tint + the ONE
+ *                             scale write + the `::after` colour-flood punch).
+ *   · `.glass-capsule`      — the warm-transmissive lozenge BODY (fill + rim +
+ *                             shadow + blur, on `--radius-pill` → the stadium
+ *                             end-cap at every rung). Radius is INVARIANT — the
+ *                             capsule re-rounds itself at every height; no
+ *                             `rounded-*` rung (retires the 4/6/10px grab-bag).
+ *   · `.glass-capsule-hover`— the SHARED specular-lift + press-snap on hover.
+ *   · `.accent-tone`        — the contrast-floored tonal channels (idle fill /
+ *                             active band / active edge / contrast-safe ink).
+ *
+ * The geometry: radius invariant (the capsule's `--radius-pill`); only padding/
+ * text vary, on a √φ ladder (φ≈1.618). The `cell` is the ONE documented exception
+ * (`.glass-chip--cell` → `--radius-card`): a 72px icon+label tile is a CARD, not a
+ * pill — a DELIBERATE 2-silhouette family, composing the SAME material + motion.
+ *
+ * NO scale CVA — the ONE `scale` write lives on `.glass-chip` (hover/press/punch
+ * folded into a single source of truth; a CVA `hover:scale-*` would collide).
+ * The CVA carries no `color-mix(…--primary…)` literal — the tonal COLOUR is the
+ * `.accent-tone` register's.
+ */
+export declare const chipVariants: (props?: ({
+    size?: "cell" | "sm" | "lg" | "md" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type ChipVariants = VariantProps<typeof chipVariants>;

package/dist/components/custom/selectable-chip/index.d.ts

@@ -0,0 +1,2 @@
+export { default as SelectableChip } from "./SelectableChip.vue";
+export { selectableChipVariants, type SelectableChipVariants, } from "./selectableChipVariants";

package/dist/components/custom/selectable-chip/selectableChipVariants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * selectableChipVariants — the public name for the SelectableChip face of the ONE
+ * shared `chipVariants` recipe (BD.W-CHIP-CONGRUENT-GLASS).
+ *
+ * The chip family collapsed to ONE congruent stadium-pill warm-glass register
+ * (`./chipVariants`). SelectableChip reads it through this stable name; the
+ * `size` axis (`sm`/`md`/`lg`/`cell`) IS the shared axis. No second recipe, no
+ * grab-bag — the tonal channels are the `.accent-tone` register's, the lens is
+ * `.glass-chip` over `.glass-capsule`. Clean break: the prior per-state
+ * `color-mix(…--primary…)` literals + the `rounded-sm`/`-md`/`-lg` grab-bag are
+ * GONE (no alias — the no-legacy law); this file is the public re-point, not a
+ * parallel CVA.
+ */
+export { chipVariants as selectableChipVariants } from "./chipVariants";
+export type { ChipVariants as SelectableChipVariants } from "./chipVariants";

package/dist/components/custom/split-chars/SplitChars.vue.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SplitChars — the component face of the per-glyph split. It renders the `text`
+ * prop into per-glyph `.char` spans (each carrying `--char-index`), wraps them in
+ * the shipped `.char-stagger` host (so the library CSS staggers them into a
+ * kinetic entrance on the per-spring `--spring-smooth` clock), and — by
+ * construction — keeps the word as ONE accessible name: the wrapper carries
+ * `aria-label="{text}"`, every glyph span is `aria-hidden`. AT hears "Fourier",
+ * never the spell-out.
+ *
+ * Usage:
+ *   <SplitChars text="Fourier" />
+ *   <SplitChars text="Hello World" by="word" as="h1" />
+ *
+ * The `text` PROP is the single source for BOTH the split AND the label — there
+ * is NO default slot (a slot would split arbitrary markup, so the accessible name
+ * would be ambiguous). The split re-runs on a `text` change (the watcher →
+ * `split()`). Engine-free: it composes `useCharStagger` (vue-only) + the shipped
+ * CSS; it adds NO animation engine and NO PRM logic (it inherits the recipe's
+ * carve — the split is structural, only the CSS `fade-in` is PRM-gated).
+ */
+import { type Component, type HTMLAttributes } from "vue";
+import { type UseCharStaggerOptions } from "../../../composables/motion/useCharStagger";
+type __VLS_Props = {
+    /** The word to split — REQUIRED. It is the single source for both the
+     *  per-glyph split AND the accessible label (the load-bearing a11y fact). */
+    text: string;
+    /** The split unit. Default `"char"`. */
+    by?: UseCharStaggerOptions["by"];
+    /** Host tag/component (reka-ui Primitive `as`; default `"span"`) — set
+     *  `as="h1"` to render the kinetic word as a heading. */
+    as?: string | Component;
+    class?: HTMLAttributes["class"];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    as: string | Component;
+    by: "char" | "word" | "grapheme";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/custom/split-chars/index.d.ts

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

package/dist/components/custom/tabs/SegmentedTabs.vue.d.ts

@@ -50,12 +50,14 @@ export interface SegmentedTabsProps {
      */
     responsive?: boolean | SegmentedTabsResponsive;
     /**
-     * BB.W-DRAG-MORPH — the LIQUID TAB. When `true` (ADDITIVE, default `false`),
-     * the `pill` indicator becomes a physical lozenge you can GRAB and PULL: it
-     * follows the finger ~1:1, squishes on drag velocity, and flings to the nearest
-     * tab on release (`useDragMorph`). The click-selection path is byte-identical;
-     * the drag is opt-in. No-op on `underline` (the ink hairline has no indicator
-     * element to deform).
+     * BC.W-LIQUID-TAB — the LIQUID TAB. The `pill` indicator is a physical lozenge
+     * you can GRAB and PULL: it follows the finger ~1:1, squishes on drag velocity,
+     * and flings to the nearest tab on release (`useDragMorph`). DEFAULT `true` — the
+     * pull is the iOS-27 primary affordance, ADDITIVE OVER the click/keyboard path
+     * (which stays byte-identical + fully operable — the drag is a pointer
+     * ENHANCEMENT, never the sole selection mechanism, WCAG 2.1.1). A consumer who
+     * wants click-only opts out with `:draggable="false"`. No-op on `underline` (the
+     * ink hairline has no indicator element to deform — `dragEnabled` gates it).
      */
     draggable?: boolean;
     class?: HTMLAttributes["class"];

package/dist/components/custom/tabs/constants.d.ts

@@ -1,10 +1,26 @@
 /**
  * Fallback for `--tab-indicator-max-stretch` when the cascade leaves it unset — the
- * default ≈+8% travel-squish cap (AX.W53). `--stretch = 1 + frac · (cap − 1)`, so a
+ * default ≈+15% travel-squish cap. `--stretch = 1 + frac · (cap − 1)`, so a
  * full-width jump reaches the cap and a tiny hop stays near 1. The token is the
  * authority; this is the no-token floor.
+ *
+ * BD.W-TABS-LIQUID — re-tuned 1.18 → 1.11. The `--tab-blob` area-inflation channel now
+ * carries the 5-beat "grow"/overshoot, so the per-axis travel-squish cap drops: the FENCE
+ * is the COMPOSED visible bbox area (`blob × stretch`) ≤ ~1.14, NOT the bare per-axis
+ * scalar. The cap is shared by the click travel-squish AND the drag pull-morph (the SOLE
+ * cap source — the constant + the token in lockstep, never a fork); the volume-preserving
+ * reciprocal pairing (`scale: var(--stretch) calc(1/var(--stretch))`) is unchanged.
  */
-export declare const DEFAULT_INDICATOR_MAX_STRETCH = 1.08;
+export declare const DEFAULT_INDICATOR_MAX_STRETCH = 1.11;
+/**
+ * BD.W-TABS-LIQUID — fallback for `--tab-indicator-blob-max` when the cascade leaves it
+ * unset: the 5-beat blob's area-inflation overshoot peak. The 2nd `useLiquidFlex` channel
+ * drives `--tab-blob` toward this on the grow-overshoot beat, then de-inflates to 1 at
+ * arrival (shrink-to-fit). Kept LOW (~1.045) so the COMPOSED bbox area (`blob × stretch` ≈
+ * blob², the squish being volume-preserving) clears the ≤ ~1.14 anti-taffy fence. The
+ * token is the authority; this is the no-token floor (the SOLE blob-cap source).
+ */
+export declare const DEFAULT_INDICATOR_BLOB_MAX = 1.045;
 /**
  * The travel-progress fraction at which the squish RELEASES — the Material
  * "grow then shrink" close, keyed to ARRIVAL (BA.W-TABS). The squish opens with
@@ -14,5 +30,15 @@ export declare const DEFAULT_INDICATOR_MAX_STRETCH = 1.08;
  * release schedules off the calibrated clock (`--spring-snappy-duration`) scaled
  * by this fraction, so the stretch peaks during travel and shrinks to fit AT
  * arrival, never before.
+ *
+ * BC.W-UNDERLINE-TUNE — VERIFIED against the eased `snappy` (response 0.42 / ζ 0.78,
+ * the BC.W-SPRING-EASE re-derive). On that curve the position arrives (≥99% travel)
+ * at ~74% of the `--spring-snappy-duration` clock and the 90%-travel point lands at
+ * ~57% (mid-clock — the front-load gone). 0.82 releases the squish at ~279ms (= 0.82
+ * × 340ms), i.e. AT arrival (just past the ~74% arrival), so the stretch peaks DURING
+ * travel and shrinks to fit AT arrival — never before (0.82 ≥ the 0.74 arrival point).
+ * The position + squish now read ONE matched window: the desync (HEAD position-at-16%
+ * vs squish-at-82%) collapsed because the eased curve actually travels across the clock.
+ * KEPT at 0.82 — the eased arrival sits inside the release fraction; no nudge needed.
  */
 export declare const INDICATOR_RELEASE_AT_ARRIVAL = 0.82;

package/dist/components/custom/timeline/ScrubberTimeline.vue.d.ts

@@ -7,6 +7,22 @@
  *
  * AA.A4 §S-16 — the `aria-valuenow` binding coerces `Number(modelValue ?? 0)`
  * so a numeric attribute always renders (axe `aria-required-attr` regression).
+ *
+ * BD.W-TIMELINE-RAIL-UNIFY (LEG 2) — the head is RE-INVENTED as a warm-glass
+ * liquid lozenge. The four cartoon beats COMPOSE shipped engines only (no new
+ * motion engine): travel rides a `useSpring`/SpringProgress position written
+ * to `transform: translateX()` (NEVER `style.left` — Safari composites
+ * transform, not left); `useLiquidFlex` `"tanh"` velocity-squish multiplies
+ * into the SAME matrix (vol-preserving, cap ≤1.12); `useSpringPress` grab
+ * anticipation; the velocity term is the head spring's own derivative (the
+ * self-extinguishing per-frame velocity SpringProgress already computes — the
+ * GOLDEN §0 "drive off the spring derivative" path, no free-running rAF); the
+ * fill LAGS the head on a slower spring clock; release settles ζ<1 on the
+ * cartoon-punch clock; a one-shot accent-flood ripples on landing. Always
+ * visible (the
+ * `opacity:0`-until-hover is RETIRED — the affordance must be present during
+ * keyboard/touch scrub). The bead seats φ-INSIDE the channel; the 44px touch
+ * target is an invisible `::before` halo, decoupled from the visible bead.
  */
 type __VLS_Props = {
     /** 0..1 scrubber position. */

package/dist/components/custom/timeline/geometry.d.ts

@@ -16,14 +16,6 @@
  */
 import { type ComputedRef, type Ref } from "vue";
 import type { TimelineSegment } from "./types";
-/**
- * Resolve a segment's gradient declaration to a CSS background expression.
- * - `string` (raw CSS): consumed verbatim — caller controls direction.
- * - `{from, to}` pair: expanded to `linear-gradient(90deg, from, to)`.
- * - undefined: falls through to the `--timeline-segment-default-gradient`
- *   token (consumer can override on the primitive or via a section-tone).
- */
-export declare function gradientFor(seg: TimelineSegment): string;
 /**
  * Fill percentage per state. Explicit `progress` wins; otherwise the
  * canonical mapping (pending=0, active=0.5, completed=1). Clamped to

package/dist/components/custom/toggle-chip/index.d.ts

@@ -1,15 +1,26 @@
 import { type VariantProps } from "class-variance-authority";
 export { default as ToggleChip } from "./ToggleChip.vue";
 /**
- * Shared toggleable "chip" / "cell" primitive for selector grids.
+ * Shared toggleable "chip" / "cell" primitive for selector grids
+ * (BD.W-CHIP-CONGRUENT-GLASS).
  *
  * `chip` — inline horizontal token (e.g. tag pickers, tool-filter rows).
  * `cell` — square card that stacks an icon/preview over a label
  *          (e.g. pose pickers, palette swatches, emotion pickers).
  *
- * The `data-state="on"` attribute is set by the reka-ui Toggle root
- * when pressed, so selected styling hangs off the data attribute and
- * doesn't need a class-binding at the call site.
+ * Survival of the fittest: the chip family collapsed to ONE congruent recipe
+ * (`../selectable-chip/chipVariants`). ToggleChip keeps its `variant` ergonomics
+ * (`chip` inline pill / `cell` square card) but RE-POINTS onto the shared
+ * `chipVariants` `size` axis — `chip` → the `md` stadium rung, `cell` → the
+ * `cell` card exception. Clean break (no alias): the prior 4px `rounded-sm`
+ * grab-bag + the `rounded-[0.625rem]→0px` cell + the per-state
+ * `color-mix(…--primary…)` literals are GONE; the recipe is now the shared
+ * `.glass-chip .glass-capsule .glass-capsule-hover .accent-tone` lens — the SAME
+ * register SelectableChip + the toggle-group render. ONE family, no fork.
+ *
+ * The `data-state="on"` attribute is set by the reka-ui Toggle root when pressed,
+ * so the selected colour-flood + the punch hang off the data attribute (in
+ * `glass/glass-chip.css`) — no class-binding at the call site.
  */
 export declare const toggleChipVariants: (props?: ({
     variant?: "cell" | "chip" | null | undefined;