@mkbabb/glass-ui 7.0.0 → 8.0.0

package/dist/composables/motion/number/useNumericTransition.d.ts

@@ -1,56 +0,0 @@
-import type { TimingFunction } from "@mkbabb/keyframes.js";
-import { type Ref } from "vue";
-export type SpringSnapshot<K extends string> = Record<K, number>;
-/**
- * The named `useNumericTransition` return shape.
- * The transition is driver-only: `start`/`stop` control playback, `progress`
- * (0..1) + `playing` are reactive read-outs.
- */
-export interface UseNumericTransitionReturn {
-    /** Play the transition from `from` → `to`; resolves at completion. */
-    start: () => Promise<void>;
-    /** Stop the in-flight transition. */
-    stop: () => void;
-    /** Reactive 0..1 progress derived from the first interpolated key. */
-    progress: Ref<number>;
-    /** Reactive true-while-playing flag. */
-    playing: Ref<boolean>;
-}
-export interface UseNumericTransitionOptions<K extends string> {
-    /** Named numeric endpoints to interpolate between. */
-    from: SpringSnapshot<K>;
-    to: SpringSnapshot<K>;
-    /** Playback duration in ms. */
-    duration: number;
-    /** Honor prefers-reduced-motion by snapping to the target. Default true. */
-    respectReducedMotion?: boolean;
-    /**
-     * keyframes.js timing function — an explicit callable `(t) => number`.
-     *
-     * This is a callable `TimingFunction`, not a string easing name.
-     * keyframes 4 removed string-name acceptance from `NumericAnimationOptions`
-     * (a name now resolves only through the ASYNC `resolveEasing`, which crosses
-     * the value.js dynamic boundary the dock/motion light surface must never
-     * pull in). Narrowing glass-ui's public option to a callable decouples it
-     * from keyframes' name-resolution churn. A consumer wanting a named curve
-     * passes the function directly (e.g. `(t) => 1 - Math.pow(1 - t, 3)` for
-     * easeOutCubic).
-     */
-    timingFunction?: TimingFunction;
-    /** Per-frame consumer. Receives the same zero-allocation record each tick. */
-    onFrame?: (values: SpringSnapshot<K>) => void;
-}
-/**
- * Drive a numeric transition between two snapshots — e.g. CSS variable
- * values, element transforms, or color channel tuples. Wraps keyframes.js's
- * `NumericAnimation`, which handles easing, binary-search segment lookup,
- * and zero-allocation playback.
- *
- * The caller owns how values map to the DOM: provide `onFrame` and write
- * the record into `element.style.setProperty`, a `ref`, or wherever. This
- * composable never touches the DOM directly — it's the orchestrator, not
- * the renderer.
- *
- * For physics-based motion (mass / stiffness / damping), use `useSpring`.
- */
-export declare function useNumericTransition<K extends string>(options: UseNumericTransitionOptions<K>): UseNumericTransitionReturn;

package/dist/composables/motion/reveal/bloomUpField.d.ts

@@ -1,29 +0,0 @@
-import type { Ref } from "vue";
-/** The ambient-strength ceiling (sub-perceptual; never a flood). */
-export declare const AMBIENT_STRENGTH_CEILING = 8;
-/** The live reduced-motion probe (matchMedia, SSR-safe). */
-export declare function prefersReducedMotion(): boolean;
-/** Clamp the ambient-strength target into the bounded warm-cream-identity band `[0, 8]`. */
-export declare function clampStrength(n: number | undefined): number;
-/**
- * Resolve the FIELD container the 4th color channel writes onto. Explicit `field` ref
- * wins; else walk up from `dest` to the nearest `[data-glass-field]` ancestor (the
- * field-marker contract); else `dest.parentElement`. The field is a DIFFERENT element
- * from the blooming surface — the compositor-only de-risk.
- */
-export declare function resolveField(dest: HTMLElement, explicit: Ref<HTMLElement | null> | undefined): HTMLElement | null;
-/**
- * Read the source's dominant hue — the explicit `fieldHue` OR the `--glass-ambient-hue`
- * computed off the source element (the AMBIENT-TINT source). Returns `null` for a
- * neutral/absent hue (the field tints nothing).
- */
-export declare function resolveHue(source: HTMLElement | null, explicit: string | undefined): string | null;
-/** Set the field's dominant hue (the 4th-channel hue, set ONCE — not animated). */
-export declare function writeFieldHue(field: HTMLElement, hue: string): void;
-/** Write the field's ambient strength (the registered @property interpolates it). */
-export declare function writeFieldStrength(field: HTMLElement, pct: number): void;
-/**
- * Release the field bias back to the no-op floor (0%) and clear the hue so the field returns
- * to its un-biased `--glass-tint-ink` (the warm-cream identity).
- */
-export declare function releaseField(field: HTMLElement | null): void;

package/dist/composables/motion/reveal/useBloomUp.d.ts

@@ -1,33 +0,0 @@
-import { type Ref } from "vue";
-import { type SpringPresetName } from "../spring/springPresets";
-export type BloomUpPreset = Extract<SpringPresetName, "snappy" | "bouncy">;
-export interface UseBloomUpOptions {
-    /** The spring register (default `snappy`). */
-    preset?: BloomUpPreset;
-    /** Starting destination blur in pixels. Default `4`. */
-    blur?: number;
-    /** Explicit field hue; otherwise read from the source's `--glass-ambient-hue`. */
-    fieldHue?: string;
-    /** Destination field; otherwise use the nearest `[data-glass-field]` ancestor. */
-    field?: Ref<HTMLElement | null>;
-    /** Ambient strength percentage, clamped to `0..8`. Default `8`. */
-    fieldStrength?: number;
-    /** Snap spatial motion under reduced motion. Default `true`. */
-    respectReducedMotion?: boolean;
-    /** Seat a newly mounted destination before paint. Default `true`. */
-    autoPrime?: boolean;
-    /** Fired once when the bloom reaches its terminal state. */
-    onBloomed?: () => void;
-}
-export interface UseBloomUpReturn {
-    bloom: () => void;
-    reset: () => void;
-    prime: () => void;
-    blooming: Readonly<Ref<boolean>>;
-}
-/**
- * Bloom a destination from a source rect while warming its surrounding field.
- * Geometry and paint share `useElementMorph`'s one spring clock; this wrapper has no
- * scheduler or `ElementMorph` instance of its own.
- */
-export declare function useBloomUp(source: Ref<HTMLElement | null>, dest: Ref<HTMLElement | null>, options?: UseBloomUpOptions): UseBloomUpReturn;

package/dist/composables/motion/reveal/useStaggerReveal.d.ts

@@ -1,28 +0,0 @@
-interface StaggerRevealConfig {
-    /** Delay between each target becoming `revealed`. Default 60ms. */
-    staggerMs?: number;
-    /** When true (default), a target stays revealed after first entering the viewport. */
-    once?: boolean;
-    /** IntersectionObserver rootMargin. Default `0px`. */
-    rootMargin?: string;
-    /** IntersectionObserver threshold. Default 0.15. */
-    threshold?: number;
-}
-/**
- * Sequence entrance animations for a list/grid. Each registered target
- * gets a staggered `revealed` flag once it crosses the viewport threshold.
- * Consumers bind the flag to a Tailwind class (e.g. `opacity-100 translate-y-0`)
- * and let CSS transitions handle the visual entry.
- *
- * On an engine with native `view()` timelines, no `IntersectionObserver`
- * is constructed — prefer the `[data-scroll-reveal]` CSS recipe
- * (scroll-driven.css). This composable is the feature-detected fallback (the
- * sole writer when the native feature is absent); under native, `register()`
- * reveals immediately so the terminal state is correct and the CSS animates.
- */
-export declare function useStaggerReveal(options?: StaggerRevealConfig): {
-    targets: import("vue").Ref<HTMLElement[], HTMLElement[]>;
-    register: (el: HTMLElement | null, index?: number) => void;
-    revealed: Record<number, boolean>;
-};
-export {};

package/dist/composables/motion/reveal/useTextHighlight.d.ts

@@ -1,41 +0,0 @@
-/** Match a query against a text-node's content, returning matched char ranges. */
-export type HighlightMatcher = (
-/** The text-node's full string content. */
-text: string, 
-/** The active query (already passed through to the matcher unchanged). */
-query: string) => Array<{
-    start: number;
-    end: number;
-}>;
-export interface UseTextHighlightControls {
-    /** Replace the highlight's range set. Empty array clears the paint. */
-    set: (ranges: Range[]) => void;
-    /**
-     * Walk every text node under `container`, run `matcher` per node, and
-     * highlight the returned `[start, end)` char spans. Replaces the prior set.
-     * The default matcher is a case-insensitive substring scan over `query`.
-     */
-    setFromMatches: (container: HTMLElement, query: string, matcher?: HighlightMatcher) => void;
-    /** Drop every range — the named highlight stops painting. */
-    clear: () => void;
-    /** True when the CSS Custom Highlight API is available (else every op no-ops). */
-    readonly supported: boolean;
-}
-/**
- * Drive a named CSS Custom Highlight reactively.
- *
- * @param name registry key — must match a caller-owned
- *   `::highlight(<name>)` style rule. This low-level API does not inject CSS.
- *   Instances sharing a name multiplex: each contributes its own ranges and
- *   the shared paint is their union (last to dispose drops the registry entry).
- *
- * @example
- * const hl = useTextHighlight("fuzzy-search");
- * watch([query, listEl], ([q, el]) => {
- *     if (el) hl.setFromMatches(el, q, fuzzyRanges);
- * });
- *
- * // Or hand it pre-built ranges directly:
- * hl.set([range]);
- */
-export declare function useTextHighlight(name: string): UseTextHighlightControls;

package/dist/composables/motion/scroll/useScrollPin.d.ts

@@ -1,49 +0,0 @@
-import { type MaybeRefOrGetter, type Ref } from "vue";
-import type { ComponentPublicInstance } from "vue";
-import type { ScrollSource } from "./scrollReader";
-export interface UseScrollPinOptions {
-    /**
-     * The tall `.scroll-pin` container (a templateRef to the element or a component). Its
-     * `getBoundingClientRect` gives the pin-slice ratio; `--pin-t` is written onto it (it
-     * `inherits: true` so the sticky stage + phase children read it).
-     */
-    container: MaybeRefOrGetter<HTMLElement | ComponentPublicInstance | null>;
-    /**
-     * The scroll source the pin tracks — the demo passes `main.demo-main-scroller`. Passed
-     * EXPLICITLY (the reader does not auto-discover). Default: the window/document.
-     */
-    source?: MaybeRefOrGetter<ScrollSource>;
-    /**
-     * The pin scrub ∈ [0, 1] — the pin drifts HEAVIER than a control (a scene, not a knob).
-     * Defaults to 1/φ² ≈ 0.382 (the golden heavier-drift rest). PRM → 0.
-     */
-    scrub?: number;
-    /** The spring damping ratio ζ for the felt reveal. < 1 overshoots. Default 0.85. */
-    dampingFraction?: number;
-    /** Honor `prefers-reduced-motion: reduce`. Default true. */
-    respectReducedMotion?: boolean;
-}
-export interface UseScrollPinReturn {
-    /** The spring-damped 0..1 pin progress (reactive — mirrors `--pin-t`). */
-    pinT: Readonly<Ref<number>>;
-    /** Force a re-read (post-resize). */
-    recalculate: () => void;
-    /** Detach. */
-    dispose: () => void;
-}
-/**
- * Drive `--pin-t` ∈ [0, 1] onto a sticky `.scroll-pin` stage off the real scroll port,
- * spring-damped so the pinned reveal arrives with inertia, overshoots, then settles. The
- * phase recipes (`.scroll-pin-phase-reveal` / `-settle`) read `--pin-t` — no
- * `animation-timeline`, every engine.
- *
- * @example
- * ```ts
- * const pinContainer = ref<HTMLElement | null>(null)
- * useScrollPin({
- *   container: pinContainer,
- *   source: () => document.querySelector<HTMLElement>("main.demo-main-scroller"),
- * })
- * ```
- */
-export declare function useScrollPin(options: UseScrollPinOptions): UseScrollPinReturn;