@mkbabb/glass-ui 4.1.0 → 5.0.0

package/dist/components/custom/goo-dot-matrix/composables/gooDotSetup.d.ts

@@ -1,50 +0,0 @@
-import { type BlobWGPUUniformScratch } from "../../goo-blob/composables/uniformBridgeWGPU";
-import { type MetaballUniformLocations } from "../../goo-blob/composables/uploadBlobUniforms";
-import { type GooDotUniformScratch } from "./uniformBridgeWGPU";
-export declare const GOO_DOT_LABEL = "[GooDotMatrix]";
-/** The one-time WGPU resources the per-frame closure reads (pipeline + the two buffers + scratch). */
-export interface GooDotWGPUResources {
-    pipeline: GPURenderPipeline;
-    bindGroup: GPUBindGroup;
-    fieldBuffer: GPUBuffer;
-    dotBuffer: GPUBuffer;
-    fieldScratch: BlobWGPUUniformScratch;
-    dotScratch: GooDotUniformScratch;
-}
-/**
- * Build the WGPU dot-stamp pipeline + the field (binding0) / dot-grid (binding1) uniform
- * buffers + bind group + the two scratch buffers — ONCE on `setupWGPU`. The composable's
- * per-frame closure writes the scratch via the pack helpers then submits the draw.
- */
-export declare function createGooDotWGPUResources(device: GPUDevice, format: GPUTextureFormat): GooDotWGPUResources;
-/** The dot-grid uniform locations (the dot extend, beside the field locations). */
-export interface GooDotGLUniforms {
-    mode: WebGLUniformLocation | null;
-    pix: WebGLUniformLocation | null;
-    floor: WebGLUniformLocation | null;
-    bright: WebGLUniformLocation | null;
-    min: WebGLUniformLocation | null;
-    max: WebGLUniformLocation | null;
-    pr: WebGLUniformLocation | null;
-    pm: WebGLUniformLocation | null;
-    pa: WebGLUniformLocation | null;
-    cursor: WebGLUniformLocation | null;
-    bloom: WebGLUniformLocation | null;
-}
-/** The one-time GL resources the per-frame closure reads (program + VAO + the field + dot locations). */
-export interface GooDotGLResources {
-    prog: WebGLProgram;
-    vs: WebGLShader;
-    fs: WebGLShader;
-    buf: WebGLBuffer;
-    vao: WebGLVertexArrayObject;
-    locs: MetaballUniformLocations;
-    dU: GooDotGLUniforms;
-}
-/**
- * Build the WebGL2 dot-stamp program + the full-quad VAO + the field uniform-location cache
- * (the SAME UNIFORM_NAMES the field GLSL declares) + the dot-grid uniform locations — ONCE on
- * `setupGL`. The composable's per-frame closure sets the dot uniforms then calls the REUSED
- * goo-blob `uploadBlobUniforms` (which writes the field + issues the draw).
- */
-export declare function createGooDotGLResources(gl: WebGL2RenderingContext): GooDotGLResources;

package/dist/components/custom/goo-dot-matrix/composables/uniformBridgeWGPU.d.ts

@@ -1,35 +0,0 @@
-import type { GooDotConfig } from "../constants";
-/** The total dot-grid uniform-buffer byte size (16-aligned). */
-export declare const GOO_DOT_UNIFORM_BYTES = 64;
-/** The dot-mode int the shader branches on (0 = smooth field dot, 1 = Bayer dither). */
-export declare function dotModeFor(variant: GooDotConfig["variant"]): number;
-/** The repel/attract sign for a pointer mode (repel pushes out, attract pulls in). */
-export declare function pointerModeSign(mode: GooDotConfig["pointerMode"]): number;
-/** The transient dot-cursor state the interactive arm writes (closed over, never the config). */
-export interface GooDotPointerState {
-    /** Field-uv cursor [-0.5, 0.5] (0,0 = canvas center). */
-    x: number;
-    y: number;
-    /** 1 while the pointer is over the host, 0 at rest (decays the influence). */
-    active: number;
-    /** The accel-burst brightness/scale bloom 0..1 (the flick term). */
-    bloom: number;
-}
-/** A fresh resting dot-cursor state. */
-export declare function restingDotPointer(): GooDotPointerState;
-export interface GooDotUniformScratch {
-    buffer: ArrayBuffer;
-    f32: Float32Array;
-}
-export declare function createGooDotScratch(): GooDotUniformScratch;
-/**
- * Pack the per-frame dot-grid uniforms in place. `resolutionPx` drives the cell grid;
- * `pointer` carries the §T7 dot-cursor influence (parallax/swell/bloom). The field lanes are
- * packed SEPARATELY by the goo-blob `packBlobWGPUUniforms` into binding0 — this module owns
- * ONLY the dot-grid lanes (the extend).
- */
-export declare function packGooDotUniforms(scratch: GooDotUniformScratch, config: GooDotConfig, resolutionPx: {
-    w: number;
-    h: number;
-}, dpr: number, pointer: GooDotPointerState): GooDotUniformScratch;
-export { restingDotPointer as restingPointer };

package/dist/components/custom/goo-dot-matrix/composables/useGooDotMatrix.d.ts

@@ -1,31 +0,0 @@
-import { type Ref } from "vue";
-import { type GpuBackend } from "../../../../composables/glass/webgpu/useGpuSubstrate";
-import type { GooDotConfig } from "../constants";
-export interface UseGooDotMatrixOptions {
-    config: GooDotConfig;
-    /** `"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 GooDotMatrixHandle {
-    /** The resolved backend (`"webgpu"` where supported, else the WebGL2 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/setter 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;
-    /** Tear down the renderer + release GPU/GL resources. */
-    dispose: () => void;
-}
-/**
- * Mount the goo-dot-matrix renderer on `canvasRef`. The WebGPU primary runs the dot-stamp
- * fragment over the byte-untouched goo-blob field; the WebGL2 fallback runs the SAME dot-stamp
- * (the ONE field, the ONE dot-grid output). Returns the uniform lifecycle handle.
- */
-export declare function useGooDotMatrix(canvasRef: Ref<HTMLCanvasElement | null>, options: UseGooDotMatrixOptions): GooDotMatrixHandle;

package/dist/components/custom/goo-dot-matrix/constants.d.ts

@@ -1,76 +0,0 @@
-import type { OklchStop } from "../../../composables/color";
-import { type BlobConfig } from "../goo-blob";
-/** The four render registers — the §T4 `variant` axis (default `dot-field`). */
-export type GooDotVariant = "dot-field" | "dot-dither" | "dot-lattice" | "dot-sphere";
-/** Pointer interaction mode — repel pushes dots off the field, attract pulls them in. */
-export type GooDotPointerMode = "repel" | "attract";
-/**
- * Compile-time dot-stamp cell cap (px) — the device-px cell SIZE the fragment quantizes the
- * grid to; mirrors the §T1 `uDotPixelSize` band (a floor so a tiny cell never hangs the
- * fragment over a huge grid). Register-A only.
- */
-export declare const MIN_DOT_PIXEL_SIZE = 4;
-/** Compile-time lattice column cap — mirrors the Register-B `uCols` instance fan-out. */
-export declare const MAX_LATTICE_COLS = 96;
-/**
- * The full author schema — the studio's `useConfiguratorState` model. The FIELD atoms are
- * REUSED from the goo-blob `BlobConfig` (the metaball field is the byte-untouched goo half),
- * and the DOT-RENDER atoms are ADDED (the §T1/§T2/§T3 dot-grid output). A NEW schema (no
- * prior `goo-dot-matrix`, no MIGRATION row).
- */
-export interface GooDotConfig {
-    /** Which render register — `dot-field` (default) | `dot-dither` | `dot-lattice` | `dot-sphere`. */
-    variant: GooDotVariant;
-    /**
-     * The metaball FIELD config — the byte-untouched goo-blob field atoms (geometry, the
-     * smin membrane, the satellites, the warm-cream palette). The hybrid READS the field
-     * `sceneDistG`/`thickness` off this; it does not rebuild the math.
-     */
-    field: BlobConfig;
-    /**
-     * The dot-grid CELL size in device px (Register A — §T1 `uDotPixelSize`). Larger cells →
-     * coarser dots. Floored at `MIN_DOT_PIXEL_SIZE` so the fragment never over-grids.
-     */
-    dotPixelSize: number;
-    /** Dot radius MIN (the rim/outside dot, fraction of the cell, §T1 `uDotMin`). */
-    dotMin: number;
-    /** Dot radius MAX (the core dot, fraction of the cell, §T1 `uDotMax`). */
-    dotMax: number;
-    /** The field floor below which no dot paints (§T1 `uFieldFloor`). */
-    fieldFloor: number;
-    /** The dim-outside brightness floor (the dots dim at the rim, §T1 `uDotBrightFloor`). */
-    dotBrightFloor: number;
-    /**
-     * Register-B lattice column count (§T3 `uCols`). The instanced grid is `cols × rows`
-     * fit to the aspect; capped at `MAX_LATTICE_COLS`.
-     */
-    cols: number;
-    /** Register-B flow displacement toward the merging core (§T3 `uFlowAmt`; capped < 0.5 pitch). */
-    flowAmt: number;
-    /** The dot-color ramp (resolved via the ColorResolver; default warm-cream). */
-    palette: OklchStop[];
-    /** The ground color (default transparent so the glass card shows through). */
-    background: OklchStop | "transparent";
-    /** Pointer parallax + repel + accel-burst (the §T7 dot-cursor influence). */
-    interactive: boolean;
-    /** repel ↔ attract (the dot-influence direction). */
-    pointerMode: GooDotPointerMode;
-    /** The pointer influence radius (NDC; the §T7 `pointerRadius`). */
-    pointerRadius: number;
-    /** ONE static frame then park under `prefers-reduced-motion: reduce`. */
-    respectReducedMotion: boolean;
-}
-/**
- * The warm-cream identity palette (the library default — NOT teal). The dot core is the soft
- * warm cream of the goo-blob bead; the rim fades to warm amber. Mirrors the dot-matrix /
- * dot-flow `WARM_IDENTITY_PALETTE` family — a consumer themes it mono-warm-white-on-near-black
- * through a PRESET, never a token edit.
- */
-export declare const WARM_IDENTITY_PALETTE: OklchStop[];
-/**
- * The shipped warm-identity default — the §T6 default table: the Register-A field-driven dot
- * stamp over the byte-untouched goo-blob field (the cream metaball), warm-cream dots over a
- * transparent ground (the glass card shows through). The near-dark + reference reproductions
- * are DEMO presets (presets-in-consumers).
- */
-export declare const DEFAULT_GOO_DOT_CONFIG: GooDotConfig;

package/dist/components/custom/goo-dot-matrix/index.d.ts

@@ -1,5 +0,0 @@
-export { default as GooDotMatrix } from "./GooDotMatrix.vue";
-export { useGooDotMatrix, type GooDotMatrixHandle, type UseGooDotMatrixOptions, } from "./composables/useGooDotMatrix";
-export { type GooDotConfig, type GooDotVariant, type GooDotPointerMode, DEFAULT_GOO_DOT_CONFIG, WARM_IDENTITY_PALETTE, MIN_DOT_PIXEL_SIZE, MAX_LATTICE_COLS, } from "./constants";
-export { gridOrigin, latticeInstanceCount, fibonacciDot, type Vec2, type Vec3, } from "./composables/gooDotLattice";
-export type { OklchStop } from "../../../composables/color";

package/dist/components/custom/goo-dot-matrix/shaders/goo-dot.frag.d.ts

@@ -1,11 +0,0 @@
-/** The spliced goo-blob field GLSL (decls + sceneDistG/breath/samplePaletteOklch). */
-export declare const GOO_DOT_FIELD_GLSL: string;
-/**
- * The full-quad vertex shader — the BYTE-IDENTICAL metaball.vert convention (the `aPosition`
- * attrib name + `vUv = aPosition·0.5+0.5`), so the goo-blob `uploadBlobUniforms` draw path
- * (the SHARED field upload — `gl.drawArrays(TRIANGLES, 0, 6)` over the `aPosition` quad) is
- * REUSED wholesale for the field lanes; the dot-grid uniforms are set beside it.
- */
-export declare const GOO_DOT_VERT_GLSL = "#version 300 es\nprecision highp float;\nin vec2 aPosition;\nout vec2 vUv;\nvoid main() {\n  vUv = aPosition * 0.5 + 0.5;\n  gl_Position = vec4(aPosition, 0.0, 1.0);\n}";
-/** The Register-A dot-stamp fragment — the GLSL twin of the WGSL `fs_main`. */
-export declare const GOO_DOT_FRAG_GLSL: string;

package/dist/components/custom/goo-dot-matrix/shaders/goo-dot.wgsl.d.ts

@@ -1,3 +0,0 @@
-/** The spliced goo-blob field (struct + bindings + sceneDistG/breath/samplePaletteOklch). */
-export declare const GOO_DOT_FIELD_WGSL: string;
-export declare const GOO_DOT_WGSL: string;

package/dist/components/custom/handmark/brush.d.ts

@@ -1,269 +0,0 @@
-/**
- * brush.ts — the flat Brush DATA model (the keystone; SPEC §2). Pure data, 0 deps.
- * ─────────────────────────────────────────────────────────────────────────────
- * A `Brush` is a plain JSON-serialisable record — twelve scalars, four enums, and
- * one optional `stamp` function. Every built-in medium is a frozen literal: a
- * POINT in one continuous parameter space, NOT a class in a taxonomy. The renderer
- * (`ink.ts`) reads fields — it NEVER branches on instrument name (SPEC §12 acc-1).
- * Adding a medium = adding one row here; an in-between medium = a spread/lerp.
- *
- * Field-count discipline (SPEC §2): resist a 13th scalar per new instrument —
- * `blend` earned its place only because highlighter genuinely needed `multiply`.
- *
- * The shipped register: PEN is the default (clean ink, grain:0 ⇒ no filter); the
- * CRAYON ships as the proven STROKE-crayon (constant-width offset passes + the
- * seeded static feTurbulence grain — `ds-crayon-handmark` verdict), i.e.
- * `ribbon:'stroke'`. The HIGHLIGHTER (BA.W-HANDMARK C-1) ENGAGES `ribbon:'hull'`
- * — the perfect-freehand variable-width slab the atlas's field delta names — so the
- * vendored pf body ships whenever the highlighter does (the budget note in the cut
- * + a `profile:budget` rebaseline).
- */
-export type BlendMode = "source-over" | "multiply" | "darken" | "screen";
-export interface TaperSpec {
-    /** px the width ramps 0→full at the start (lift-on). */
-    start: number;
-    /** px the width ramps full→0 at the end (lift-off / dry run-out). */
-    end: number;
-    /** out-cubic = the lazy pencil run-out. */
-    ease: "linear" | "out-cubic";
-}
-export interface Brush {
-    /** base stroke diameter, in viewBox units. */
-    weight: number;
-    /** 0..1.4 seeded ±width variance along arc-length. */
-    weightJitter: number;
-    /** -1..1 pressure→width gain (pf `thinning`). */
-    thinning: number;
-    /** lift-on / lift-off ramp. */
-    taper: TaperSpec;
-    /** L2 body strategy: plain stroked <path> | pf filled hull. DEFAULT 'stroke'. */
-    ribbon: "stroke" | "hull";
-    /** 0..1 base alpha. */
-    opacity: number;
-    /** 'source-over' ink | 'multiply' highlighter-behind-text. */
-    blend: BlendMode;
-    /** overdraw count (pen 1 · crayon 2-3). */
-    passes: number;
-    /** 0..1 per-pass alpha falloff (heavy core, light fringe). */
-    passOpacity: number;
-    /** 0..1 paper-through depth — THE master pen↔crayon knob. 0 ⇒ NO filter. */
-    grain: number;
-    /** feTurbulence baseFrequency (high=pencil tooth · low=crayon wax). */
-    grainFreq: number;
-    /** feDisplacementMap edge-fray scale, px. */
-    grainScale: number;
-    /** feTurbulence numOctaves (grain richness). */
-    octaves: number;
-    /** macro tremor → wobbleLinePoints({ roughness }). */
-    roughness: number;
-    /** micro displacement scale (boil amplitude + warp filter). */
-    wobble: number;
-    /** wobble centerline resolution. */
-    segments: number;
-    cap: "round" | "square" | "butt";
-    /** when present, OVERRIDES the built-in ink stage only. */
-    stamp?: StampFn;
-}
-/** SPEC §5 — the arbitrary-brush escape hatch (one optional field, not a framework). */
-export type StampFn = (ctx: {
-    centerline: [number, number][];
-    brush: Brush;
-    rng: () => number;
-    seed: number;
-    length: number;
-    color: string;
-}) => {
-    paths: InkPath[];
-    filterId?: string | null;
-    defs?: string[];
-};
-/** One ink path the renderer emits (shared with ink.ts; declared here to avoid a cycle). */
-export interface InkPath {
-    d: string;
-    fill?: string;
-    stroke?: string;
-    opacity: number;
-    blend: BlendMode;
-    /** geometry finish — bound to the SVG `stroke-linecap` on the path (C-1(d)). */
-    cap?: "round" | "square" | "butt";
-}
-/**
- * The named points in the continuum. `pen` is the DEFAULT (clean ink, grain:0).
- * `crayon` is the SHIPPED stroke-crayon (ribbon:'stroke', the static grain filter);
- * `pencil`/`marker`/`highlighter` round out the spanning set.
- */
-export declare const BRUSHES: {
-    readonly pen: {
-        readonly weight: 6;
-        readonly weightJitter: 0.1;
-        readonly thinning: 0.15;
-        readonly taper: {
-            readonly start: 14;
-            readonly end: 14;
-            readonly ease: "out-cubic";
-        };
-        readonly ribbon: "stroke";
-        readonly opacity: 1;
-        readonly blend: "source-over";
-        readonly passes: 1;
-        readonly passOpacity: 0;
-        readonly grain: 0;
-        readonly grainFreq: 0.1;
-        readonly grainScale: 0;
-        readonly octaves: 2;
-        readonly roughness: 0.7;
-        readonly wobble: 1.2;
-        readonly segments: 9;
-        readonly cap: "round";
-    };
-    readonly boil: {
-        readonly weight: 5;
-        readonly weightJitter: 0.12;
-        readonly thinning: 0.2;
-        readonly taper: {
-            readonly start: 12;
-            readonly end: 12;
-            readonly ease: "out-cubic";
-        };
-        readonly ribbon: "stroke";
-        readonly opacity: 1;
-        readonly blend: "source-over";
-        readonly passes: 1;
-        readonly passOpacity: 0;
-        readonly grain: 0;
-        readonly grainFreq: 0.1;
-        readonly grainScale: 0;
-        readonly octaves: 2;
-        readonly roughness: 0.9;
-        readonly wobble: 1.4;
-        readonly segments: 14;
-        readonly cap: "round";
-    };
-    readonly pencil: {
-        readonly weight: 3;
-        readonly weightJitter: 0.3;
-        readonly thinning: 0.4;
-        readonly taper: {
-            readonly start: 8;
-            readonly end: 18;
-            readonly ease: "out-cubic";
-        };
-        readonly ribbon: "stroke";
-        readonly opacity: 0.6;
-        readonly blend: "source-over";
-        readonly passes: 1;
-        readonly passOpacity: 0;
-        readonly grain: 0.5;
-        readonly grainFreq: 0.42;
-        readonly grainScale: 1.5;
-        readonly octaves: 3;
-        readonly roughness: 1;
-        readonly wobble: 1.6;
-        readonly segments: 11;
-        readonly cap: "round";
-    };
-    readonly crayon: {
-        readonly weight: 16;
-        readonly weightJitter: 1;
-        readonly thinning: 0.25;
-        readonly taper: {
-            readonly start: 6;
-            readonly end: 6;
-            readonly ease: "linear";
-        };
-        readonly ribbon: "stroke";
-        readonly opacity: 0.8;
-        readonly blend: "source-over";
-        readonly passes: 2;
-        readonly passOpacity: 0.18;
-        readonly grain: 0.85;
-        readonly grainFreq: 0.16;
-        readonly grainScale: 2.6;
-        readonly octaves: 4;
-        readonly roughness: 1.5;
-        readonly wobble: 3;
-        readonly segments: 13;
-        readonly cap: "round";
-    };
-    readonly ring: {
-        readonly weight: 5;
-        readonly weightJitter: 0.6;
-        readonly thinning: 0.3;
-        readonly taper: {
-            readonly start: 8;
-            readonly end: 12;
-            readonly ease: "out-cubic";
-        };
-        readonly ribbon: "stroke";
-        readonly opacity: 0.55;
-        readonly blend: "source-over";
-        readonly passes: 1;
-        readonly passOpacity: 0;
-        readonly grain: 0.7;
-        readonly grainFreq: 0.18;
-        readonly grainScale: 1.8;
-        readonly octaves: 4;
-        readonly roughness: 1.4;
-        readonly wobble: 2.6;
-        readonly segments: 13;
-        readonly cap: "round";
-    };
-    readonly marker: {
-        readonly weight: 12;
-        readonly weightJitter: 0.2;
-        readonly thinning: 0.1;
-        readonly taper: {
-            readonly start: 4;
-            readonly end: 10;
-            readonly ease: "out-cubic";
-        };
-        readonly ribbon: "stroke";
-        readonly opacity: 0.92;
-        readonly blend: "source-over";
-        readonly passes: 1;
-        readonly passOpacity: 0;
-        readonly grain: 0.22;
-        readonly grainFreq: 0.09;
-        readonly grainScale: 1;
-        readonly octaves: 3;
-        readonly roughness: 1;
-        readonly wobble: 2.2;
-        readonly segments: 9;
-        readonly cap: "square";
-    };
-    readonly highlighter: {
-        readonly weight: 26;
-        readonly weightJitter: 0.05;
-        readonly thinning: 0;
-        readonly taper: {
-            readonly start: 6;
-            readonly end: 10;
-            readonly ease: "out-cubic";
-        };
-        readonly ribbon: "hull";
-        readonly opacity: 0.38;
-        readonly blend: "multiply";
-        readonly passes: 1;
-        readonly passOpacity: 0;
-        readonly grain: 0.12;
-        readonly grainFreq: 0.2;
-        readonly grainScale: 1.5;
-        readonly octaves: 2;
-        readonly roughness: 0.5;
-        readonly wobble: 1.4;
-        readonly segments: 9;
-        readonly cap: "square";
-    };
-};
-export type BrushName = keyof typeof BRUSHES;
-/**
- * Resolution order (KISS, deterministic): preset → object overrides → extra `o`.
- * A string selects a preset; an object spreads over `pen`. Later wins.
- */
-export declare const resolveBrush: (b: BrushName | Partial<Brush>, o?: Partial<Brush>) => Brush;
-/**
- * lerpBrush — the continuum proof (SPEC §12 acc-2). Linearly interpolate the
- * scalar fields of two brushes; enums/taper/ribbon snap from `a` below 0.5, `b`
- * at/above. Yields a sensible in-between ("inky crayon"), no NaN.
- */
-export declare const lerpBrush: (a: Brush, b: Brush, t: number) => Brush;

package/dist/components/custom/handmark/composables/useHandMark.d.ts

@@ -1,89 +0,0 @@
-/**
- * useHandMark.ts — the headless reactive core (L2/L3/L4; SPEC §9).
- * ─────────────────────────────────────────────────────────────────────────────
- * Sits between the props and the SFC template so a future React/web-component skin
- * reuses L1–L4. It orchestrates: resolve brush → shapeGeom → ink → animation. It
- * owns NO DOM (the SFC anchors/measures/mounts the filter); it owns the reactive
- * pipeline + the draw-on / boil state machine.
- *
- * Two draw-on mechanisms, picked by a FIELD (never an instrument `if`):
- *   - clean ink (no grain): `stroke-dashoffset` on `pathLength="1"` — the slides
- *     recipe, geometry-agnostic, compositor-cheap, no filter to re-raster.
- *   - grained ink (crayon): a `clip-path: inset()` WIPE — the filter rasters ONCE
- *     and the reveal mutates only the clip (`ds-crayon-handmark §5.1`). NEVER
- *     dashoffset under a filter (it would re-raster the graph per frame — the Δ4
- *     gate).
- *
- * PRM: every draw-on collapses to instant (finished static state); boil no-ops
- * (`useLineBoil.start()` early-returns under reduced motion).
- */
-import { type Ref } from "vue";
-import { type Brush, type BrushName } from "../brush";
-/**
- * The boil clock surface the SFC binds — the `useLineBoil` return shape, declared
- * structurally over glass-ui's OWN `Ref` (pencil-boil ships a nested `@vue`, so its
- * `Ref` symbol differs; the no-op stub is built with this `ref`, hence the surface
- * is named here rather than `ReturnType<typeof useLineBoil>`).
- */
-export interface BoilClock {
-    currentFrame: Ref<number>;
-    start: () => void;
-    stop: () => void;
-}
-import { type ShapeGeom } from "../geometry";
-import { type SVGFragment } from "../ink";
-import type { HandAnimation, HandMarkProps, HandShape, MarkBox } from "../types";
-export interface UseHandMarkInput {
-    brush: BrushName | Partial<Brush>;
-    shape: HandShape;
-    color: string;
-    seed: number;
-    overrides?: Partial<Brush>;
-    animation: HandAnimation;
-    boilFps: number;
-    boilFrames: number;
-    roughness: number | null;
-    segments: number | null;
-    jagged: boolean;
-    /** NATURAL underline morphology (C-2) — procedural off the house-seeded engine. */
-    natural: boolean;
-    box: MarkBox | null;
-    path: string | null;
-    filterId: string;
-    /**
-     * The MEASURED text baseline as a fraction of the `.hm` box height (text-mode
-     * underline anchor). `null` until the SFC measures it (ResizeObserver +
-     * `document.fonts.ready`) — geometry falls back to the legacy constant for that
-     * one pre-measure frame. Ignored in positioned (`box`) mode.
-     */
-    baselineFrac: number | null;
-}
-/**
- * Normalise raw HandMarkProps (with their defaults applied) into the core input.
- * `baselineFrac` is the SFC's MEASURED text baseline (text-mode underline anchor) —
- * passed in (not a prop) because it is a runtime measurement, `null` until measured.
- */
-export declare function normalizeProps(props: HandMarkProps, filterId: string, baselineFrac?: number | null): UseHandMarkInput;
-export interface HandMarkCore {
-    /** the resolved effective brush vector. */
-    brush: Ref<Brush>;
-    /** the static base geometry (boil re-perturbs THIS). */
-    baseGeom: Ref<ShapeGeom>;
-    /** the live SVG fragment (paths + filter defs). */
-    fragment: Ref<SVGFragment>;
-    /** the live `d` (escape-hatch path > boiled geometry > static base). */
-    pathD: Ref<string>;
-    /** does the brush emit a grain filter? (drives the draw-on mechanism). */
-    grained: Ref<boolean>;
-    /** the draw-on mechanism for this mark: dashoffset (pen) | clip (crayon). */
-    drawKind: Ref<"dashoffset" | "clip">;
-    /** does this animation draw on at all? */
-    draws: Ref<boolean>;
-    /** does this animation boil? */
-    boils: Ref<boolean>;
-    /** the boil clock (a real `useLineBoil` only when the mark boils; else a no-op stub). */
-    boil: BoilClock;
-    /** arm/disarm boil (draw-then-boil holds it until the draw finishes). */
-    boilArmed: Ref<boolean>;
-}
-export declare function useHandMark(input: Ref<UseHandMarkInput>): HandMarkCore;

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

@@ -1,39 +0,0 @@
-/**
- * constants.ts — the marking-space geometry constants (the colocation home).
- * ─────────────────────────────────────────────────────────────────────────────
- * The hand-mark family's named geometry constants live here (the AY.W-COLOCATE
- * convention's `constants.ts` home). geometry.ts + the SFC re-read them by name.
- */
-/** Marking-space width (the 0..100 × 0..40 viewBox; `preserveAspectRatio="none"`). */
-export declare const VB_W = 100;
-/** Marking-space height. */
-export declare const VB_H = 40;
-/**
- * The hairline gap, as a fraction of the `.hm` box, between the MEASURED text
- * baseline and the underline centerline. The underline rides just under the real
- * glyph bottoms — a hand mark sits a few % of cap-height below the baseline, never
- * through it (the E1 occlusion root: a constant `y=32` strikethroughs tight-leading
- * display type because 80% of a `line-height:1.02` box IS the baseline).
- */
-export declare const UNDERLINE_GAP = 0.06;
-/**
- * The highlighter LOW-SEAT band (BA.W-HANDMARK C-1(a)). A real highlighter rides
- * the low two-thirds of the line — the ink sits on the baseline and rises to
- * ~x-height — NOT the box vertical center the fork shipped. The band centerline
- * seats at `baselineFrac − HIGHLIGHT_RISE` (raised off the baseline by ~half a
- * lowercase x-height) so the wide slab (weight 26) covers x-height down to the
- * baseline. Expressed as a fraction of the `.hm` box, parallel to UNDERLINE_GAP.
- */
-export declare const HIGHLIGHT_RISE = 0.22;
-/** Pre-measure fallback for the highlight band's low seat (null baselineFrac). */
-export declare const HIGHLIGHT_FALLBACK_FRAC = 0.66;
-/**
- * Natural-underline morphology (BA.W-HANDMARK C-2). The procedural wobble is
- * SCALE-RELATIVE: the amplitude is a fraction of the rendered word width (a long
- * word and a short word wobble in proportion, not the viewBox-stretched-constant
- * the fork's GlassUnderline shipped). The period count is IRREGULAR — a seeded
- * pick in [PERIODS_MIN, PERIODS_MAX] — so two seeds differ in hump count, never
- * identical twins.
- */
-export declare const PERIODS_MIN = 2;
-export declare const PERIODS_MAX = 4;

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

@@ -1,52 +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 0.4.x's `ellipsePoints` (the hand-circle
- * overshoot ring — the sole upstream geometry delta this component required).
- *
- * THE SEED RECONCILE (BA.W-HANDMARK [S2]): the wobble centerlines are seeded from
- * the HOUSE prng leaf (`src/utils/prng.ts` mulberry32 + hashString — the AV.W14
- * 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 { 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
- * `VB_H × (baselineFrac + UNDERLINE_GAP)` — never the old hardcoded `32` (80% of the
- * box), which struck through tight-leading headings. `null` ⇒ not yet measured: fall
- * back to the legacy `VB_H − 8` constant so first paint (and jsdom/SSR) still renders
- * a line, replaced the instant the measure lands.
- *
- * `natural` (BA.W-HANDMARK C-2) routes the underline through the procedural
- * `naturalUnderlinePoints` morphology instead of pencil-boil's `wobbleLinePoints`
- * (the masthead `boil` voice); the default underline keeps the pencil-boil line.
- */
-export declare function shapeGeom(shape: HandShape, opts: WobbleOptions, box?: MarkBox | null, baselineFrac?: number | null, natural?: boolean): 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;