@mkbabb/glass-ui 7.0.0 → 9.0.0

package/dist/components/handmark/geometry.d.ts

@@ -1,65 +0,0 @@
-/**
- * geometry.ts — SEMANTIC shape → pencil-boil centerlines (L1, pure; SPEC §3).
- * ─────────────────────────────────────────────────────────────────────────────
- * A shape is a pure mapper: (semantic target) → L1 geometry. The renderer never
- * knows what it drew — it sees only `Point[]`. Adding a shape = adding one switch
- * arm; nothing downstream changes (texture + animation are shape-blind). This is
- * the generality lever (Brush ⟂ Path).
- *
- * The marking coordinate space is 0..100 × 0..40, with `preserveAspectRatio="none"`
- * so the <svg> stretches to the slotted word box (the SPEC §6.2 width-invariance
- * contract). Two usage modes:
- *   - text mode (box == null): use the full viewBox (single-line underline/strike)
- *   - positioned mode (box = {x,y,w,h}): map an explicit rect (circle a datum)
- *
- * The circle arm rides pencil-boil's `ellipsePoints` (the hand-circle
- * overshoot ring — the sole upstream geometry delta this component required).
- *
- * THE SEED RECONCILE ( [S2]): the wobble centerlines are seeded from
- * the HOUSE prng leaf (`src/composables/glass/procedural/prng.ts` mulberry32 + hashString — the
- * single-source). The family FEEDS pencil-boil a house-derived integer seed; glass-
- * ui code imports ZERO `mulberry32` from pencil-boil (its internal mulberry32 stays
- * inside its OWN perturb math). ONE seed leaf, the house identity.
- */
-import { type WobbleOptions } from "@mkbabb/pencil-boil";
-import { UNDERLINE_GAP, VB_H, VB_W } from "./constants";
-import type { HandShape, MarkBox } from "./types";
-export { naturalUnderlinePoints } from "./noise";
-export { VB_W, VB_H, UNDERLINE_GAP };
-/** A shape maps to one or more centerlines (open polylines) or one closed ring. */
-export interface ShapeGeom {
-    lines: [number, number][][];
-    closed: boolean;
-}
-/**
- * Semantic shape → { lines, closed } in the marking space (or a positioned box).
- *
- * The text-mode underline anchors to a MEASURED baseline: `baselineFrac` is the
- * slotted word's alphabetic baseline as a fraction of the `.hm` box height (the SFC
- * measures it via ResizeObserver + `document.fonts.ready`). The underline y is then
- * `H × (baselineFrac + UNDERLINE_GAP)` — not a hardcoded fraction (a fixed `32`,
- * 80% of the box, strikes through tight-leading headings). `null` ⇒ not yet measured: fall
- * back to a fixed `H − 8` constant so first paint (and jsdom/SSR) still renders a
- * line, replaced the instant the measure lands.
- *
- * `natural` routes the underline through the φ-incommensurate value-noise
- * `naturalUnderlinePoints` morphology instead of pencil-boil's `wobbleLinePoints`
- * (the masthead `boil` voice); the default underline keeps the pencil-boil line.
- *
- * The aspect-correct viewBox: `vbH` is the SFC-measured
- * marking-space HEIGHT (`VB_W, boxAspect`) for the TEXT-MODE underline/strikethrough/
- * highlight, so `preserveAspectRatio="none"` scales the wobble SHAPE uniformly (the x
- * and y scales EQUAL → the humps stop being x-stretched flat). It defaults to `VB_H`,
- * and is used ONLY for the measured text-mode y — the positioned/box/circle/bracket
- * path keeps `VB_H` byte-for-byte (it DEPENDS on the none-stretch to fill the datum
- * rect; the text-mode fix must not touch it).
- *
- * The amplitude knob: `ampScale` multiplies the natural-
- * underline excursion (default 1 ⇒ byte-identical; the SFC derives it from the brush
- * `wobble` scalar, decoupling excursion from stroke `weight`).
- */
-export declare function shapeGeom(shape: HandShape, opts: WobbleOptions, box?: MarkBox | null, baselineFrac?: number | null, natural?: boolean, vbH?: number, ampScale?: number): ShapeGeom;
-/** Boil one geometry: re-perturb the CACHED centerlines (anchored → no draw-on pop). */
-export declare function boilLines({ lines, closed }: ShapeGeom, amount: number, seed: number): [number, number][][];
-/** Serialize centerlines → one SVG `d` (multi-line shapes concat with a space). */
-export declare function serialize(lines: [number, number][][], jagged?: boolean): string;

package/dist/components/handmark/ink.d.ts

@@ -1,11 +0,0 @@
-import type { Brush, InkPath } from "./brush";
-export interface SVGFragment {
-    paths: InkPath[];
-    filterId: string | null;
-    defs: string[];
-}
-/**
- * ink — the only stage the brush fully drives. `jagged` serialises the stroke body
- * with angular kinks (pointsToLinear) instead of the smooth Catmull-Rom bezier.
- */
-export declare function ink(centerline: [number, number][], b: Brush, seed: number, color: string, filterId: string, jagged?: boolean): SVGFragment;

package/dist/components/handmark/noise.d.ts

@@ -1,30 +0,0 @@
-/** smootherstep (6t⁵−15t⁴+10t³) — the C² fairing for the value-noise lerp. */
-export declare function smootherstep(t: number): number;
-/**
- * The boil voice — φ-incommensurate fractal value-noise (the masthead morphology):
- *
- *   disp(t) = Σ_{k=0..OCT-1} aₖ · vnoiseₖ(t·fₖ + φₖ)   normalised by Σaₖ
- *     fₖ = NOISE_F0 · φ^k   (φ mutually-irrational steps → the sum NEVER closes
- *                            into a period — the non-periodicity mechanism)
- *     aₖ = (1/φ)^k          (per-octave decay)
- *     φₖ = seeded per-octave phase (house mulberry32)
- *     vnoiseₖ = seeded lattice value-noise, smootherstep-faired
- *
- * The four brush axes:
- *   - amplitude SCALES with the rendered span (`(x2−x1) × NOISE_AMP_FRAC × ampScale`),
- *     not a viewBox-stretched constant (a long word and a short word wobble in
- *     proportion); `ampScale` is the excursion knob (default 1
- *     ⇒ byte-identical; the SFC derives it from the brush `wobble` scalar, decoupling
- *     excursion from stroke `weight`);
- *   - the hump-to-hump spacing is IRREGULAR (the φ-incommensurate octave sum — the
- *     honest non-periodicity teeth, spacing-CV ~0.41 at the paint count vs a
- *     sinusoid's ~0.14, over 400 seeds);
- *   - the non-uniform body gives the pf hull a pressure-taper-friendly point stream;
- *   - the seed is the HOUSE mulberry32.
- *
- * ENDPOINT anchor (NOT a body-wide envelope): a narrow cosine taper at the very ends
- * only (`NOISE_EDGE`), so the ends settle to baseline (no draw-on pop) while the BODY
- * amplitude stays irregular hump-to-hump. FILTER-FREE: the wander is in the control
- * points + the hull width, never a feTurbulence.
- */
-export declare function naturalUnderlinePoints(x1: number, y: number, x2: number, seed: number, segments: number, ampScale?: number): [number, number][];

package/dist/components/handmark/texture.d.ts

@@ -1,39 +0,0 @@
-/**
- * texture.ts — the L3 grain as ONE parameterized SVG <filter> (pure; SPEC §4.2).
- * ─────────────────────────────────────────────────────────────────────────────
- * `grainFilter(id, b, seed)` returns the markup for ONE static, seeded <filter>
- * driven entirely by the brush vector. The KISS invariant (the PEN-is-free law,
- * SPEC §12 acc-4):
- *
- *     grain <= 0 && grainScale <= 0  ⇒  returns ''  ⇒  NO filter emitted  ⇒  bare <path>.
- *
- * So pen/marker-lite get the cleanest vector edge at zero filter cost; pencil/
- * crayon get a real broken-edge filter. SAME code path, field delta only — never
- * an instrument `if`.
- *
- * The graph is the proven 5-stage pipeline from the `proto/_final` sandbox (it
- * supersets the bare SPEC §4.2 graph with a trailing re-break displacement —
- * `ds-crayon-handmark §4.4` keeps the proven one):
- *   1. feTurbulence (warp)      — low-freq fractal noise for edge wobble
- *   2. feDisplacementMap (wob)  — push the stroke edge by grainScale
- *   3. feTurbulence (grain)     — high-freq noise = paper tooth / wax grain
- *   4. feColorMatrix (grainA)   — threshold the grain into a hard alpha mask
- *   5. feComposite + feDisplace — knock paper-through holes (operator="in") + re-break
- *
- * CRITICAL (the Δ4 gate, `ds-crayon-handmark §3`): this filter is STATIC + SEEDED.
- * It rasters ONCE per (mount, resize, scheme flip) and is cached. The draw-on is a
- * `clip-path: inset()` wipe that mutates only the clip — it NEVER animates
- * `stroke-dashoffset` under the filter (which would re-raster the graph per frame).
- * Boil does NOT ship on this register (`ds-crayon-handmark §5.3`).
- *
- * `id` MUST be per-instance (the component's `useId()`) so two marks never collide
- * their <filter> namespaces — the glass-ui WatercolorDot idiom.
- *
- * The grain sub-seed is derived (`seed ^ 0x85eb`) per SPEC §7, so one top seed
- * re-rolls the grain coherently with the centerline wobble.
- */
-import type { Brush } from "./brush";
-/** @returns SVG <filter> markup, or '' when the brush is clean ink (pen). */
-export declare function grainFilter(id: string, b: Brush, seed: number): string;
-/** Does this brush emit a grain filter? (the pen-is-free predicate). */
-export declare function hasGrain(b: Brush): boolean;

package/dist/components/handmark/types.d.ts

@@ -1,70 +0,0 @@
-/**
- * types.ts — the public API surface (SPEC §6). Pure types, 0 runtime.
- * ─────────────────────────────────────────────────────────────────────────────
- * The L5 surface steals rough-notation's *vocabulary* (annotate-style props +
- * ordered groups), not its code. Every prop has a per-brush default, so the
- * common call is one tag: <HandMark>who pays in</HandMark>.
- */
-import type { Brush, BrushName } from "./brush";
-/** A target rect in the 0..100 × 0..40 marking space (positioned mode). */
-export interface MarkBox {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
-export type HandShape = "underline" | "strikethrough" | "highlight" | "circle" | "box" | "bracket" | "path";
-export type HandAnimation = "none" | "draw-on" | "boil" | "draw-then-boil";
-export interface HandMarkProps {
-    /** 'pen'(default) | preset name | full/partial Brush object. */
-    brush?: BrushName | Partial<Brush>;
-    /** default 'underline'. */
-    shape?: HandShape;
-    /** ANY CSS color. default 'currentColor'. */
-    color?: string;
-    /** procedural variant — deterministic. default 1. */
-    seed?: number;
-    /** spread over the resolved brush (3rd resolution level). */
-    overrides?: Partial<Brush>;
-    /** default 'none' (the static-masthead default). */
-    animation?: HandAnimation;
-    /** draw-on duration. default 800. */
-    drawMs?: number;
-    /** draw-on start delay. default 0. */
-    drawDelayMs?: number;
-    /** draw-on trigger. default 'visible' (IntersectionObserver). */
-    appear?: "mount" | "visible" | "manual";
-    /** boil frame rate. default 8 (≈125ms). */
-    boilFps?: number;
-    /** distinct boil frames. default 3. */
-    boilFrames?: number;
-    /** override brush.roughness. */
-    roughness?: number;
-    /** wobble resolution. default per-brush. */
-    segments?: number;
-    /** angular kinks vs smooth bezier. default false. */
-    jagged?: boolean;
-    /**
-     * NATURAL-underline excursion knob ( (c)). Multiplies the
-     * scale-relative wobble amplitude (`span × NOISE_AMP_FRAC × amplitude`). Default is
-     * unset ⇒ the amplitude is derived from the brush `wobble` scalar (byte-identical at
-     * the shipped default); an explicit value WINS (e.g. `1.4` for a bolder hand line,
-     * font-proportional). Only the natural/boil underline reads it.
-     */
-    amplitude?: number;
-    /**
-     * NATURAL underline morphology ( C-2). When true (the masthead
-     * `boil` voice), the underline geometry goes PROCEDURAL — scale-relative
-     * amplitude, an IRREGULAR seeded period count, off the house prng leaf feeding
-     * pencil-boil — instead of pencil-boil's single `wobbleLinePoints` line. The
-     * `boil` brush auto-engages it; the default underline keeps the pencil-boil line.
-     * Ignored on non-underline shapes.
-     */
-    natural?: boolean;
-    /** POSITIONED mode (circle a datum): explicit target rect. */
-    box?: MarkBox;
-    /** shape:'path' escape hatch — arbitrary SVG `d` (wins over shape). */
-    path?: string;
-    /** arbitrary point stream → brush ink. */
-    points?: [number, number][];
-}

package/dist/components/header-ribbon/HeaderRibbon.vue.d.ts

@@ -1,13 +0,0 @@
-import type { HeaderRibbonProps } from "./types";
-type __VLS_Slots = {
-    items?(): unknown;
-};
-declare const __VLS_base: import("vue").DefineComponent<HeaderRibbonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<HeaderRibbonProps> & Readonly<{}>, {}, {}, {}, {}, 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/header-ribbon/index.d.ts

@@ -1,2 +0,0 @@
-export { default as HeaderRibbon } from "./HeaderRibbon.vue";
-export type { HeaderRibbonPlacement, HeaderRibbonProps } from "./types";

package/dist/components/header-ribbon/styles.css

@@ -1 +0,0 @@
-@layer components { .header-ribbon { position: fixed; inset-block-start: 0; z-index: var(--z-header); display: flex; width: max-content; max-width: 100%; padding: 1rem; pointer-events: none; } .header-ribbon[data-placement="left"] { left: 0; } .header-ribbon[data-placement="right"] { right: 0; } .header-ribbon__band { display: flex; align-items: center; min-block-size: var(--size-icon-btn); max-inline-size: min(32rem, calc(100vw - 2rem)); padding: var(--panel-padding); border-radius: var(--radius-pill); pointer-events: auto; direction: ltr; } .header-ribbon[data-placement="right"] .header-ribbon__band { flex-direction: row-reverse; } .header-ribbon__actions { display: flex; align-items: center; gap: 0.5rem; } .header-ribbon:dir(rtl) .header-ribbon__actions { direction: rtl; } } @media (pointer: coarse) { .header-ribbon { padding: 0.75rem; } .header-ribbon__band { max-inline-size: calc(100vw - 1.5rem); } } @media (forced-colors: active) { .header-ribbon__band { border: 1px solid CanvasText; } }

package/dist/components/header-ribbon/types.d.ts

@@ -1,10 +0,0 @@
-import type { HTMLAttributes } from "vue";
-export type HeaderRibbonPlacement = "left" | "right";
-export interface HeaderRibbonProps {
-    /** Side of the viewport the ribbon anchors against. Defaults to `"left"`. */
-    placement?: HeaderRibbonPlacement;
-    /** Accessible name for the persistent action toolbar. */
-    ariaLabel?: string;
-    /** Additional class names. */
-    class?: HTMLAttributes["class"];
-}

package/dist/components/instrument-chassis/InstrumentChassis.vue.d.ts

@@ -1,23 +0,0 @@
-import type { InstrumentChassisBoundary, InstrumentChassisProps } from "./types";
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {};
-type __VLS_Slots = {} & {
-    stage?: (props: typeof __VLS_1) => any;
-} & {
-    inspector?: (props: typeof __VLS_3) => any;
-} & {
-    action?: (props: typeof __VLS_5) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<InstrumentChassisProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<InstrumentChassisProps> & Readonly<{}>, {
-    state: import("./types").InstrumentChassisState;
-    reserve: import("./types").InstrumentChassisReserve;
-    proportion: import("./types").InstrumentChassisProportion;
-    boundaries: readonly InstrumentChassisBoundary[];
-}, {}, {}, {}, 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/instrument-chassis/index.d.ts

@@ -1,2 +0,0 @@
-export { default as InstrumentChassis } from "./InstrumentChassis.vue";
-export type { InstrumentChassisBoundary, InstrumentChassisProportion, InstrumentChassisProps, InstrumentChassisReserve, InstrumentChassisState, } from "./types";

package/dist/components/instrument-chassis/styles.css

@@ -1 +0,0 @@
-@layer components { .instrument-chassis { --instrument-tone: var(--muted-foreground); --instrument-state-tint: 0%; --instrument-dial-padding-inline: clamp(1rem, 3cqi, 1.5rem); --instrument-dial-padding-block: clamp(1rem, 3cqi, 1.5rem); --instrument-dial-gap: clamp(1rem, 3cqi, 1.5rem); --instrument-control-padding-inline: clamp(1rem, 3cqi, 1.5rem); --instrument-control-padding-block: clamp(0.75rem, 2cqi, 0.875rem); --instrument-control-gap: calc(var(--spacing) * 2); --instrument-title-gap: calc( var(--instrument-dial-padding-inline, 1.5rem) / 2.618 ); --instrument-boundary-catch: rgb(255 255 255 / 0.1); --instrument-boundary-shadow: rgb(0 0 0 / 0.12); container-type: inline-size; position: relative; overflow: clip; border: 1px solid var(--glass-border-wash); border-radius: var(--radius-card); background: var(--glass-curvature-overlay, none), color-mix( in oklab, var(--glass-bg-chassis), var(--instrument-tone) var(--instrument-state-tint) ); box-shadow: var(--glass-shadow-quiet), inset 0 1px 0 var(--surface-tint-6), inset 0 -0.5px 0 rgb(0 0 0 / 0.06); -webkit-backdrop-filter: var(--glass-blur-quiet); backdrop-filter: var(--glass-blur-quiet); transition: border-color var(--duration-normal) var(--ease-standard); } .instrument-chassis[data-state="active"] { --instrument-state-tint: 6%; border-color: color-mix( in oklab, var(--instrument-tone) 24%, var(--glass-border-wash) ); } .instrument-chassis[data-state="complete"] { --instrument-state-tint: 9%; border-color: color-mix( in oklab, var(--instrument-tone) 32%, var(--glass-border-wash) ); } .instrument-chassis[data-state="loading"] { --instrument-state-tint: 3%; } .dark .instrument-chassis { --instrument-boundary-catch: rgb(255 255 255 / 0.06); --instrument-boundary-shadow: rgb(0 0 0 / 0.18); } .instrument-composition { display: grid; grid-template-columns: minmax(0, 1fr); gap: var(--instrument-dial-gap); padding: var(--instrument-dial-padding-block) var(--instrument-dial-padding-inline); } .instrument-chassis[data-proportion="golden"] .instrument-composition[data-has-inspector] { grid-template-columns: minmax(0, 61.8033989fr) minmax(0, 38.1966011fr); } .instrument-chassis[data-proportion="preview-dominant"] .instrument-composition[data-has-inspector] { grid-template-columns: minmax(0, 66.6666667fr) minmax(0, 33.3333333fr); } .instrument-stage, .instrument-inspector { min-inline-size: 0; } .instrument-composition[data-boundary] .instrument-inspector { box-shadow: inset 1px 0 0 var(--instrument-boundary-catch), inset 2px 0 0 var(--instrument-boundary-shadow); } .instrument-action { display: flex; flex-wrap: wrap; align-items: center; gap: var(--instrument-control-gap); padding: var(--instrument-control-padding-block) var(--instrument-control-padding-inline); } .instrument-action[data-boundary] { box-shadow: inset 0 1px 0 var(--instrument-boundary-catch), inset 0 2px 0 var(--instrument-boundary-shadow); } .instrument-chassis:is([data-reserve="stage"], [data-reserve="both"]) .instrument-stage { min-block-size: var(--instrument-stage-reserve, 0px); } .instrument-chassis:is([data-reserve="inspector"], [data-reserve="both"]) .instrument-inspector { min-block-size: var(--instrument-inspector-reserve, 0px); } @container (max-width: 44.9375rem) { .instrument-chassis[data-proportion] .instrument-composition[data-has-inspector] { grid-template-columns: minmax(0, 1fr); } .instrument-composition[data-boundary] .instrument-inspector { box-shadow: inset 0 1px 0 var(--instrument-boundary-catch), inset 0 2px 0 var(--instrument-boundary-shadow); } } @media (prefers-reduced-motion: reduce) { .instrument-chassis { transition: none; } } }

package/dist/components/instrument-chassis/types.d.ts

@@ -1,13 +0,0 @@
-import type { HTMLAttributes } from "vue";
-export type InstrumentChassisState = "ready" | "active" | "complete" | "loading";
-export type InstrumentChassisProportion = "golden" | "preview-dominant";
-export type InstrumentChassisBoundary = "stage-inspector" | "inspector-action";
-export type InstrumentChassisReserve = "none" | "stage" | "inspector" | "both";
-export interface InstrumentChassisProps {
-    state?: InstrumentChassisState;
-    tone?: string;
-    proportion?: InstrumentChassisProportion;
-    boundaries?: readonly InstrumentChassisBoundary[];
-    reserve?: InstrumentChassisReserve;
-    class?: HTMLAttributes["class"];
-}

package/dist/components/labeled-field/LabeledSelect.vue.d.ts

@@ -1,20 +0,0 @@
-import type { LabeledSelectProps } from "./types";
-declare var __VLS_48: {};
-type __VLS_Slots = {} & {
-    error?: (props: typeof __VLS_48) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<LabeledSelectProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string) => any;
-    "update:open": (value: boolean) => any;
-}, string, import("vue").PublicProps, Readonly<LabeledSelectProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    "onUpdate:open"?: ((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/liquid-grid/LiquidGrid.vue.d.ts

@@ -1,46 +0,0 @@
-import type { LiquidGridConfig } from "./constants";
-import type { RendererStatus } from "../../composables/glass/webgpu/rendererStatus";
-/**
- * LiquidGrid — a liquid AA-grid: evenly-spaced LARGER lines on a slowly breathing
- * curl-flow sheet.
- *
- * A calm engineering-graph-liquid grid (evenly-spaced, LARGE cells, a crisp fine rule with
- * a bolder major rule every 5 cells) drawn on a slowly breathing liquid sheet — adjacent
- * lines bow and flow TOGETHER as if the grid is ruled on a gently rippling pond, never a
- * per-line jitter. WebGPU-FIRST: a pure fullscreen fragment pass (the aurora/concentric
- * shape-class) computes the grid at a curl-warped coordinate per pixel via the Ben Golus
- * derivative-AA distance function (constant device-pixel-crisp lines, the CSS-blur kill),
- * the Iñigo Quílez domain warp (the "liquid"), and the Bridson divergence-free curl flow
- * (WHY it's liquid not noise). It composes `useLiquidGrid` → 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 line ink is the warm-cream `--foreground` library identity (resolved live at
- * mount); the demo themes it through a PRESET (presets-in-consumers — never a library
- * token). The grid suffuses over the page (transparent ground) — teal-on-navy is gone.
- */
-type __VLS_Props = {
-    /** The full author schema (the studio's `useConfiguratorState` model). */
-    config?: LiquidGridConfig;
-    /**
-     * 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;
-    rendererStatus: Readonly<import("vue").Ref<RendererStatus, RendererStatus>>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    rendererStatus: (status: RendererStatus) => any;
-    "update:paused": (value: boolean) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onRendererStatus?: ((status: RendererStatus) => any) | undefined;
-    "onUpdate:paused"?: ((value: boolean) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export;
-export default _default;

package/dist/components/liquid-grid/composables/liquidGrid.d.ts

@@ -1,113 +0,0 @@
-/** A 2-vector. */
-export interface Vec2 {
-    x: number;
-    y: number;
-}
-/** The curl central-difference epsilon (matches `flow.glsl.ts`, `flow.wgsl.ts`). */
-export declare const CURL_EPS = 0.012;
-/**
- * the liquid-grid curl-sampling spatial frequency (in CELL units).
- * `g0 = uv · gridScale` is CELL-scale (span ~14–40 cells), so the warp must sample the curl
- * potential at a frequency an ORDER OF MAGNITUDE below the grid frequency for the warp to be
- * locally affine at the cell scale — the sheet bows as ONE smooth curve (base wavelength 1/0.03 ≈
- * 33 cells), never the sub-cell crackle a cell-scale `~1` frequency produced. Concentric's own
- * `waveFlow` call passes the unit-scale `0.6` (its `p` is unit-scale). The shaders carry the same
- * `0.03` literal (the round-trip fence). NOT a config tunable — the affine-frequency FLOOR.
- */
-export declare const LIQUID_GRID_WARP_FREQ = 0.03;
-/** A 3-octave scalar fbm potential (the host noise basis the curl operator wraps). */
-export declare function potentialFBM(p: Vec2): number;
-/** The 2D curl of the scalar fbm potential (the JS twin of `curlFBM`). */
-export declare function curlFBM(p: Vec2): Vec2;
-/**
- * The Ben Golus derivative-AA grid line coverage at `g` (grid space). `targetWidth` is the
- * desired line half-width in GRID UNITS (the caller passes `lineWidthPx, minorPitchPx` so
- * the line is N device-pixels wide); `uvDeriv` is the per-axis screen-space derivative of
- * `g` (in the shaders `length(vec2(dFdx(g), dFdy(g)))`; in JS the caller passes it
- * analytically so the path is reproducible). Returns line coverage [0..1].
- *
- * The Golus pipeline (transcribed by the WGSL/GLSL EXACTLY):
- *   gridUV   = 1 − |fract(g)·2 − 1|                 (triangle wave: 0 at line, 1 at center)
- *   drawW    = clamp(targetWidth, uvDeriv, 0.5)
- *   lineAA   = uvDeriv·1.5
- *   grid2    = smoothstep(drawW+lineAA, drawW−lineAA, gridUV)
- *   grid2   *= clamp(targetWidth/drawW, 0, 1)        (preserve thin-line intensity)
- *   grid2    = mix(grid2, targetWidth, clamp(uvDeriv·2−1, 0, 1))   (Moiré suppression)
- *   line     = max(grid2.x, grid2.y)
- */
-export declare function gridCoverage(g: Vec2, targetWidth: number, uvDeriv: Vec2): number;
-/**
- * The complete liquid-grid sample at a domain `uv` (the round-trip anchor). Composes the
- * warp + the bulge + the two-tier Golus coverage EXACTLY as the WGSL/GLSL `fs_main` does,
- * returning the premultiplied-alpha (the page reads through the troughs). `uvDeriv` is the
- * FIXED analytic per-axis derivative (JS has no fragment derivatives); the shaders compute
- * it from `dpdx`/`dpdy`. Returns `{ line, alpha }` — the line coverage + the global alpha.
- */
-export interface LiquidGridSampleParams {
-    /** The grid scale (view, minorPitch → LARGER cells = smaller scale). */
-    gridScale: number;
-    /** The traveling-wave front direction. */
-    waveDir: Vec2;
-    /** The crest-band spatial frequency. */
-    waveK: number;
-    /** The front speed (ω). */
-    waveOmega: number;
-    /** The crest-band width. */
-    waveSigma: number;
-    /** The affine sheet-warp displacement magnitude at the crest (grid units). */
-    twistMax: number;
-    /** The spring-eased envelope amplitude (0..1; PRM snaps to 0). */
-    amp: number;
-    /** The cursor in GRID space. */
-    cursor: Vec2;
-    /** The cursor-swirl peak twist (rad). */
-    bulgeStrength: number;
-    bulgeRadius: number;
-    /** +1 repel, −1 attract (signs the swirl). */
-    bulgeMode: number;
-    /** 1 = cursor swirl on. */
-    interactive: number;
-    /** Golus target half-widths in grid units (minor + major). */
-    targetWidth: number;
-    targetWidthMajor: number;
-    /** How many minor cells per major rule. */
-    majorEvery: number;
-    minorAlpha: number;
-    majorAlpha: number;
-    /** The GLOBAL subtlety knob (suffusion → tiny). */
-    fieldAlpha: number;
-    /** The FIXED per-axis derivative (the JS round-trip; shaders use dpdx/dpdy). */
-    uvDeriv: Vec2;
-    /** The filled-FACE opacity (0 → the face evaporates → the line-only render). */
-    faceAlpha?: number;
-    /** The slope-shade ∇H Lambert gain. */
-    faceReliefGain?: number;
-    /** The volume-preserving squash (the inset retreats at the crest). */
-    squashK?: number;
-    /** The base inset-square coverage. */
-    baseInset?: number;
-    /** The fixed cel key-light direction. */
-    lightDir?: Vec2;
-}
-/** The face-shade scalars the FACE composite reads (the numeric-parity witness — FOLD B/C/D). */
-export interface LiquidGridFace {
-    /** The crest envelope at the pre-twist driver cc (FOLD A). */
-    env: number;
-    /** The sheet height at the driver cc (= env; the named leaf scalar). */
-    h: number;
-    /** The Lambert slope-shade [0,1] against the fixed key-light. */
-    shade: number;
-    /** The squashed inset-square face coverage [0,1]. */
-    faceCov: number;
-    /** The composited face alpha (FOLD D — face·faceAlpha·fieldAlpha, NO h-term). */
-    faceA: number;
-    /** The ramp parameter mix(shade, h) keying the multi-stop warm-divergent ink (FOLD B). */
-    rampT: number;
-}
-export declare function sampleLiquidGrid(uv: Vec2, t: number, p: LiquidGridSampleParams): {
-    line: number;
-    alpha: number;
-    face: LiquidGridFace;
-};
-/** The grid scale from the view + minor pitch (LARGER cells = smaller scale). */
-export declare function gridScaleFor(viewExtentPx: number, minorPitchPx: number): number;

package/dist/components/liquid-grid/composables/liquidGridGLSetup.d.ts

@@ -1,18 +0,0 @@
-import type { WebGLCanvasFrame } from "../../../composables/glass/webgl/useWebGLCanvas";
-import type { LiquidGridConfig } from "../constants";
-import { type Vec2 } from "./liquidGrid";
-export interface LiquidGridGLSetupDeps {
-    canvas: HTMLCanvasElement;
-    config: LiquidGridConfig;
-    getCursor: () => Vec2;
-    /** The spring-eased traveling-wave envelope amplitude (0..1; PRM → 0). */
-    getAmp: () => number;
-    shouldContinue: () => boolean;
-    /**
-     * The per-frame pointer hook — useLiquidGrid advances the shared pointer field + derives
-     * the transient cursor here (the no-own-rAF discipline). ZERO own rAF.
-     */
-    onFrame?: (timeSec: number) => void;
-}
-/** Build the `setupGL(gl)` callback the `createGpuSubstrate` WebGL2 path invokes. */
-export declare function createLiquidGridGLSetup(deps: LiquidGridGLSetupDeps): (gl: WebGL2RenderingContext) => WebGLCanvasFrame;

package/dist/components/liquid-grid/composables/liquidGridWGPUSetup.d.ts

@@ -1,21 +0,0 @@
-import type { WebGPUCanvasFrame } from "../../../composables/glass/webgpu/useWebGPUCanvas";
-import type { LiquidGridConfig } from "../constants";
-import type { Vec2 } from "./liquidGrid";
-export interface LiquidGridWGPUSetupDeps {
-    canvas: HTMLCanvasElement;
-    config: LiquidGridConfig;
-    /** The transient pointer cursor in GRID space — re-read each frame (the cursor swirl). */
-    getCursor: () => Vec2;
-    /** The spring-eased traveling-wave envelope amplitude (0..1; PRM → 0). */
-    getAmp: () => number;
-    /** Demand-gate (the renderer's quiescence layer — substrate-agnostic). */
-    shouldContinue: () => boolean;
-    /**
-     * The per-frame pointer hook — useLiquidGrid advances the shared `usePointerVelocityField`
-     * here (the no-own-rAF discipline: the renderer's frame loop FEEDS `tick(delta)`) and
-     * derives the transient cursor. ZERO own rAF.
-     */
-    onFrame?: (timeSec: number) => void;
-}
-/** Build the liquid-grid `setupWGPU(device, context, format)` callback. */
-export declare function createLiquidGridWGPUSetup(deps: LiquidGridWGPUSetupDeps): (device: GPUDevice, context: GPUCanvasContext, format: GPUTextureFormat) => WebGPUCanvasFrame;

package/dist/components/liquid-grid/composables/uniformBridgeWGPU.d.ts

@@ -1,16 +0,0 @@
-import type { LiquidGridConfig } from "../constants";
-import type { Vec2 } from "./liquidGrid";
-export declare const LIQUID_GRID_UNIFORM_BYTES = 224;
-export interface LiquidGridUniformScratch {
-    buffer: ArrayBuffer;
-    f32: Float32Array;
-}
-export declare function createLiquidGridScratch(): LiquidGridUniformScratch;
-/**
- * Pack the liquid-grid uniforms in place. `viewExtentPx` is the canvas backing-store extent
- * the grid scale derives from (so the cell pitch is honest in device px); `cursor` is the
- * transient pointer in GRID space (the renderer derives it from `usePointerVelocityField`);
- * `aspect` corrects the domain x. The line ink resolves the warm `--foreground` identity
- * (the demo themes it via a preset, never a token edit).
- */
-export declare function packLiquidGridUniforms(scratch: LiquidGridUniformScratch, config: LiquidGridConfig, timeSec: number, aspect: number, viewExtentPx: number, cursor: Vec2, amp: number): LiquidGridUniformScratch;

package/dist/components/liquid-grid/composables/useLiquidGrid.d.ts

@@ -1,32 +0,0 @@
-import { type Ref } from "vue";
-import { type GpuBackend, type RendererStatus } from "../../../composables/glass/webgpu/useGpuSubstrate";
-import type { LiquidGridConfig } from "../constants";
-export interface UseLiquidGridOptions {
-    config: LiquidGridConfig;
-    /** `"capture"` → renderAt-only (the deterministic π capture path). Default `"live"`. */
-    mode?: "live" | "capture";
-}
-/** The uniform handle a consumer wires its lifecycle against (backend-agnostic). */
-export interface LiquidGridHandle {
-    /** The resolved backend (`"webgpu"` where supported, else the WebGL2 GLSL fallback). */
-    readonly backend: GpuBackend;
-    /** Park the loop (the WCAG-2.2.2 pause seam — `DockBackgroundToggle` wires this). */
-    pause: () => void;
-    /** Re-arm the loop. */
-    resume: () => void;
-    /** Re-arm a parked loop on demand (a pointer that re-introduced motion). */
-    wake: () => void;
-    /** Draw one frame out-of-loop (capture / thumbnail). */
-    renderAt: (timeSec: number) => void;
-    /** The live `prefers-reduced-motion: reduce` state. */
-    readonly reducedMotion: boolean;
-    readonly rendererStatus: Readonly<Ref<RendererStatus>>;
-    /** Tear down the renderer + release GPU/GL resources. */
-    dispose: () => void;
-}
-/**
- * Mount the liquid-grid renderer on `canvasRef`. The WebGPU primary + the WebGL2 fallback are
- * BOTH pure fullscreen fragment passes evaluating the SAME liquid grid (the ONE math source
- * `liquidGrid.ts`), so the picker is the only seam. Returns the uniform lifecycle handle.
- */
-export declare function useLiquidGrid(canvasRef: Ref<HTMLCanvasElement | null>, options: UseLiquidGridOptions): LiquidGridHandle;