@mkbabb/glass-ui 8.0.0 → 9.0.0

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

@@ -1,69 +0,0 @@
-/**
- * constants.ts — the marking-space geometry constants (the colocation home).
- * ─────────────────────────────────────────────────────────────────────────────
- * The hand-mark family's named geometry constants live here (the
- * 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 ( 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;
-/**
- * The boil voice — φ-incommensurate fractal value-noise (the masthead morphology).
- * ─────────────────────────────────────────────────────────────────────────────
- * The boil centerline is a 1-D fractal value-noise displacement off the HOUSE
- * `mulberry32`, NOT a seeded sinusoid. A sinusoid self-correlates
- * into a near-period — it reads as a spell-check squiggle and a clean sine fails any
- * honest non-periodicity discriminator (a sine's extrema are near-uniformly spaced).
- * The value-noise sums octaves at φ-stepped frequencies (mutually irrational → the
- * sum NEVER closes into a period); each octave's amplitude decays by 1/φ. The result
- * is a hump-to-hump-IRREGULAR hand line whose inter-extremum spacing-CV is the honest
- * teeth (measured: ~0.41 at the paint's segment count, ~0.71 resampled at RES=64,
- * over 400 seeds — vs a sinusoid's ~0.14; a clean separation either side of a
- * 0.30 floor). The amplitude is SCALE-RELATIVE (a fraction of the rendered span), so
- * a long word and a short word wobble in proportion. FILTER-FREE — the wander lives
- * in the control points + the hull width, never a feTurbulence.
- *
- * Constants pinned against a 400-seed spacing-CV spike (NOT a seed-overfit autocorr
- * peak — autocorr cannot separate smooth low-frequency value-
- * noise from a sinusoid at any resolution).
- */
-/** φ — the per-octave frequency step (mutually irrational → never periodic). */
-export declare const NOISE_PHI = 1.618033988749895;
-/** octave count of the fractal value-noise sum. */
-export declare const NOISE_OCTAVES = 4;
-/** base octave frequency (humps across the unit span); octave k rides F0·φ^k. */
-export declare const NOISE_F0 = 2.5;
-/** displacement amplitude as a fraction of the rendered span (scale-relative). */
-export declare const NOISE_AMP_FRAC = 0.05;
-/** endpoint-only cosine taper width (the ends settle to baseline; the BODY stays irregular). */
-export declare const NOISE_EDGE = 0.12;
-/**
- * The AMPLITUDE-KNOB reference wobble ( (c)). The natural-underline
- * excursion is `span × NOISE_AMP_FRAC × f(wobble)` where `f(wobble) = wobble, NOISE_WOBBLE_REF`
- * repurposing the existing Brush `wobble` scalar to drive the centerline amplitude,
- * decoupling excursion from stroke `weight` (the published `amplitude` contract, no 13th
- * scalar). Pinned to the shipped `boil` brush's wobble (1.4) so `f(1.4) = 1` ⇒ the default
- * boil render is BYTE-IDENTICAL; a consumer lifts excursion by raising `wobble` (or the
- * explicit `amplitude` prop, which wins). A lower-wobble brush wobbles proportionally less.
- */
-export declare const NOISE_WOBBLE_REF = 1.4;

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

@@ -1,69 +0,0 @@
-/**
- * freehand.ts — the VENDORED perfect-freehand geometry core (MIT, tldraw).
- * ─────────────────────────────────────────────────────────────────────────────
- * SPEC §1.1 / §11: glass-ui ships ZERO hard deps. `perfect-freehand` is an
- * OPTIONAL peer; its `getStroke` is the only one of the four engines that
- * produces TRUE variable width (the swelling/tapering crayon nib). We vendor only
- * its *geometry* core (a few hundred LOC, MIT) behind this L2 seam so:
- *
- *   - the default pen/crayon presets (`ribbon: 'stroke'`) NEVER import it — the
- *     bundle treeshakes it away (the shipped stroke-crayon, `ds-crayon-handmark`),
- *   - the `ribbon: 'hull'` opt-in (the future width-variance upgrade) has a
- *     dependency-free, deterministic body engine already in place,
- *   - the pointer-capture half of the library (dead weight to us) never ships.
- *
- * This is the `getStroke` + `getStrokeOutlinePoints` + `getStrokePoints` core
- * from perfect-freehand@1.2.3 (Steve Ruiz, MIT), transcribed to TypeScript with
- * the `getSvgPathFromStroke` median-quad serialiser the references use. The
- * algorithm is verbatim; only the module shape (named exports, vendored vec math)
- * is glass-ui-local.
- *
- * @license MIT — perfect-freehand © Stephen Ruiz Ltd. https://github.com/steveruizok/perfect-freehand
- */
-/** A point: [x, y] or [x, y, pressure]. */
-export type InputPoint = [number, number] | [number, number, number];
-export interface StrokeOptions {
-    size?: number;
-    thinning?: number;
-    smoothing?: number;
-    streamline?: number;
-    easing?: (t: number) => number;
-    simulatePressure?: boolean;
-    start?: {
-        cap?: boolean;
-        taper?: number | boolean;
-        easing?: (t: number) => number;
-    };
-    end?: {
-        cap?: boolean;
-        taper?: number | boolean;
-        easing?: (t: number) => number;
-    };
-    last?: boolean;
-}
-interface StrokePoint {
-    point: number[];
-    pressure: number;
-    distance: number;
-    vector: number[];
-    runningLength: number;
-}
-/**
- * getStrokePoints — resample the raw input into smoothed StrokePoints with
- * running length + per-segment unit vectors (the streamline low-pass).
- */
-export declare function getStrokePoints(points: InputPoint[], options?: StrokeOptions): StrokePoint[];
-/**
- * getStrokeOutlinePoints — walk the StrokePoints, emit left/right offset points
- * (the variable-width hull), with tapered caps.
- */
-export declare function getStrokeOutlinePoints(points: StrokePoint[], options?: StrokeOptions): number[][];
-/** getStroke — the public entry: raw input → variable-width hull outline points. */
-export declare function getStroke(points: InputPoint[], options?: StrokeOptions): number[][];
-/**
- * getSvgPathFromStroke — the canonical median-quad serialiser the references use:
- * each segment's control point is the midpoint of two consecutive outline points,
- * yielding a smooth closed fill `d`-string.
- */
-export declare function getSvgPathFromStroke(stroke: number[][], closed?: boolean): string;
-export {};

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

@@ -1,62 +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 type { HandShape, MarkBox } from "./types.js";
-/** 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.js";
-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 house per-instance SVG-namespace 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.js";
-/** @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.js";
-/** 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/search/SearchBar.vue.d.ts

@@ -1,38 +0,0 @@
-import { type Component } from "vue";
-import type { Surface } from "../_shared/axes.js";
-import { type ControlSize, type SearchVariant } from "./searchVariants.js";
-type __VLS_Props = {
-    modelValue?: string;
-    placeholder?: string;
-    icon?: Component;
-    tag?: string;
-    size?: ControlSize;
-    surface?: Surface;
-    variant?: SearchVariant;
-};
-declare var __VLS_13: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_13) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
-    inputRef: import("vue").Ref<HTMLInputElement | null, HTMLInputElement | null>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-}>, {
-    size: ControlSize;
-    placeholder: string;
-    modelValue: string;
-    variant: SearchVariant;
-    surface: Surface;
-    tag: string;
-}, {}, {}, {}, 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/search/index.d.ts

@@ -1,8 +0,0 @@
-export { default as SearchBar } from "./SearchBar.vue.js";
-export { searchFieldVariants } from "./searchVariants.js";
-export type { SearchVariant, SearchVariants } from "./searchVariants.js";
-export { useFuzzySearch } from "./composables/useFuzzySearch.js";
-export type { UseFuzzySearchOptions } from "./composables/useFuzzySearch.js";
-export { buildIndex, searchIndex, fuzzyMatch, clearSearchCache } from "./composables/fuzzySearchIndex.js";
-export type { SearchIndex } from "./composables/fuzzySearchIndex.js";
-export type { SearchableItem, SearchResult, FuzzySearchState } from "./composables/types.js";

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

@@ -1,16 +0,0 @@
-import { type ClassValue } from "../_shared/class-names.js";
-import { type ControlSize } from "../_shared/control.js";
-declare const VARIANT: {
-    readonly inline: "";
-    readonly floating: "";
-    readonly bare: "border-none bg-transparent p-0 rounded-none";
-};
-export type SearchVariant = keyof typeof VARIANT;
-export interface SearchVariants {
-    variant?: SearchVariant | null;
-    class?: ClassValue;
-    className?: ClassValue;
-}
-/** Search field chrome; size remains on the shared control-size axis. */
-export declare function searchFieldVariants(options?: SearchVariants): string;
-export type { ControlSize };