@mkbabb/glass-ui 4.2.0 → 5.0.0

package/dist/styles/scroll-chrome.css

@@ -1,123 +1 @@
-/*
- * scroll-chrome.css — the scroll-driven floating-CHROME collapse recipe
- * (BC.W-SCROLL-CHROME).
- *
- * Cascade rung AFTER scroll-choreography.css. Where scroll-choreography.css is the
- * ENTRANCE register (the page-build / section-cascade / scroll-pinned reveals), this is
- * the COLLAPSE-STATE recipe a floating chrome bar (a dock, a header) composes: scroll
- * down and it SHRINKS smoothly into a compact form; scroll up and it EXPANDS back; on
- * scroll-stop it SNAPS to the nearest state (the `useScrollChrome` JS machine owns the
- * snap + the ramp value — this recipe is the compositor paint of `--chrome-collapse-t`).
- *
- *   .scroll-chrome — the chrome surface (a dock/header) reads `--chrome-collapse-t`
- *                    (0 expanded → 1 collapsed; the @property reg in property-regs.css)
- *                    for the COMPOSITOR shrink/quiet/shadow-lift ramp.
- *
- * COMPOSITOR-ONLY (the proof:no-layout-animation floor — motion-canon P5). The shrink is
- * `transform: scale()/translateY()` — NEVER an animated `height`/`padding`/`width` (the
- * box never reflows per scroll frame; the CDP Layout track stays flat). The quiet is
- * `opacity` BOUNDED above a never-invisible floor (the NN/g pale-fade-into-content trap
- * is the FORBIDDEN direction — the bar reads at EVERY collapse fraction). The
- * SEPARATION/shadow LIFTS as content scrolls under (Apple "as text scrolls underneath,
- * shadows become more prominent") — `box-shadow` is a paint prop, compositor-safe.
- *
- * THE BLUR STAYS CRISP (the W-DOCK-SHRINK-BLUR fence). The chrome's resting
- * `backdrop-filter` blur is NOT animated by `--chrome-collapse-t` — a shrunken bar is
- * crisp glass, not a blurry mess. The recipe touches ONLY transform/opacity/box-shadow;
- * the surface's own `glass-*` tier owns the (untouched) backdrop blur.
- *
- * PERSISTENT BY DEFAULT (the iOS-27 lesson). `--chrome-collapse-t` rests at 0 (the
- * @property initial-value), so a bare `.scroll-chrome` is byte-identical to the expanded
- * chrome — it does NOT collapse until the `useScrollChrome` machine (opted in with
- * `collapseOnScroll: true`) ramps the custom.
- *
- * PRM (the discrete-state-survives model, the useFadingScroll precedent). The transform/
- * opacity RAMP sits inside the `@media (prefers-reduced-motion: no-preference)` outer
- * gate (the scroll-choreography.css discipline) — under reduce the continuous ramp drops;
- * the `useScrollChrome` machine snaps `--chrome-collapse-t` to a discrete 0/1 endpoint, so
- * the DISCRETE collapsed/expanded state stays correct, instant, never half. The shadow
- * lift sits OUTSIDE the gate (a paint cue, not a vestibular motion) so the lifted
- * separation reads even under reduce.
- */
-
-/* The tunable depth knobs — a consumer retunes the shrink/fade depth per chrome. */
-:root {
-    /* The shrink depth: at fully collapsed the chrome scales to (1 − this). 0.12 → a
-       compact 88% bar (a real shrink that still reads as the same bar). */
-    --chrome-shrink-depth: 0.12;
-    /* The rise (px) the chrome translates toward its anchor edge as it collapses. */
-    --chrome-rise-px: 6px;
-    /* The fade depth — BOUNDED LOW: at fully collapsed opacity floors at (1 − this).
-       0.28 → a 0.72 floor (the bar quiets but is NEVER invisible — the NN/g pale-fade
-       trap forbidden). A consumer that wants no quiet sets it 0. */
-    --chrome-fade-depth: 0.28;
-    /* The shadow-lift strength — the separation shadow grows from rest → this as content
-       scrolls under (Apple shadow-on-scroll). A paint prop, compositor-safe. */
-    --chrome-shadow-lift: 18%;
-}
-
-/* The shrink/quiet RAMP — the SPATIAL (transform) + the EFFECTS (opacity) channels. It
-   rides `--chrome-collapse-t` directly (no CSS transition — the JS scalar already glides
-   on the reader's tick; on a native-timeline engine the same custom rides
-   `animation-timeline: scroll(self)`, the native-ramp path). Inside the PRM no-preference
-   gate: under reduce the ramp drops and the chrome reads its discrete snapped endpoint. */
-@media (prefers-reduced-motion: no-preference) {
-    .scroll-chrome {
-        /* SPATIAL leg — scale toward the compact size + a small rise toward the anchor
-           edge. transform-origin at the top (a header anchors its top; a consumer dock
-           re-points the origin to its natural seat). Compositor-only — never height/pad. */
-        transform: scale(calc(1 - var(--chrome-collapse-t) * var(--chrome-shrink-depth)))
-            translateY(calc(var(--chrome-collapse-t) * var(--chrome-rise-px) * -1));
-        transform-origin: top center;
-        /* EFFECTS leg — the quiet, BOUNDED above the never-invisible floor (the bar reads
-           at every fraction; the `* fade-depth` caps the drop, opacity never reaches 0). */
-        opacity: calc(1 - var(--chrome-collapse-t) * var(--chrome-fade-depth));
-        /* will-change the compositor channels (NEVER a layout property). */
-        will-change: transform, opacity;
-    }
-}
-
-/* The shadow LIFT — OUTSIDE the PRM gate (a paint cue, not a vestibular motion): the
-   separation shadow strengthens as content scrolls under the chrome. `box-shadow` is a
-   paint prop (compositor-safe, in the proof:no-layout-animation paint set, NOT the reflow
-   set). The lift composes the house `--shadow-color: var(--foreground)` so it re-tints
-   light↔dark for free; the strength grows from a whisper at rest → `--chrome-shadow-lift`
-   at fully collapsed. */
-.scroll-chrome {
-    box-shadow: 0 calc(2px + var(--chrome-collapse-t) * 6px)
-        calc(8px + var(--chrome-collapse-t) * 12px)
-        color-mix(
-            in srgb,
-            var(--shadow-color)
-                calc(6% + var(--chrome-collapse-t) * var(--chrome-shadow-lift)),
-            transparent
-        );
-}
-
-/* The native-ramp path — on a `scroll()`-supporting engine the consumer can drive
-   `--chrome-collapse-t` off `animation-timeline: scroll(self)` directly (the
-   `useScrollProgress`/`--scroll-t` native precedent: the JS writer is inert, the CSS owns
-   the compositor ramp). The keyframe is the linear 0→1 map over the collapse range; the
-   consumer binds it on the chrome with its own `animation-range` (the collapse-px span).
-   The SNAP-to-state stays the JS leg (a snap is a discrete commit, not a continuous ramp —
-   it rides the `useScrollChrome` scroll-stop tick on every engine). PRM-gated + supports-
-   gated (a non-supporting engine reads the JS `collapseT` write, never this keyframe). */
-@media (prefers-reduced-motion: no-preference) {
-    @supports (animation-timeline: scroll()) {
-        @keyframes gl-chrome-collapse {
-            from {
-                --chrome-collapse-t: 0;
-            }
-            to {
-                --chrome-collapse-t: 1;
-            }
-        }
-        /* OPT-IN: a consumer adds `.scroll-chrome--native` to ride the compositor ramp
-           (it must set `animation-range` for its own collapse-px span; the
-           `useScrollChrome` machine's JS write is the cross-engine floor + the snap). */
-        .scroll-chrome--native {
-            animation: gl-chrome-collapse auto linear both;
-            animation-timeline: scroll(self block);
-        }
-    }
-}
+:root { --chrome-shrink-depth: 0.12; --chrome-rise-px: 6px; --chrome-fade-depth: 0.28; --chrome-shadow-lift: 18%; } @media (prefers-reduced-motion: no-preference) { .scroll-chrome { transform: scale(calc(1 - var(--chrome-collapse-t) * var(--chrome-shrink-depth))) translateY(calc(var(--chrome-collapse-t) * var(--chrome-rise-px) * -1)); transform-origin: top center; opacity: calc(1 - var(--chrome-collapse-t) * var(--chrome-fade-depth)); will-change: transform, opacity; } } .scroll-chrome { box-shadow: 0 calc(2px + var(--chrome-collapse-t) * 6px) calc(8px + var(--chrome-collapse-t) * 12px) color-mix( in srgb, var(--shadow-color) calc(6% + var(--chrome-collapse-t) * var(--chrome-shadow-lift)), transparent ); } @media (prefers-reduced-motion: no-preference) { @supports (animation-timeline: scroll()) { @keyframes gl-chrome-collapse { from { --chrome-collapse-t: 0; } to { --chrome-collapse-t: 1; } } .scroll-chrome--native { animation: gl-chrome-collapse auto linear both; animation-timeline: scroll(self block); } } }

package/dist/styles/scroll-driven.css

@@ -1,110 +1 @@
-/*
- * scroll-driven.css — native scroll-driven CSS animations (AQ.W5 §Design 1).
- *
- * Cascade rung after animations.css. Two token-first recipe families that move
- * the scroll-progress + stagger-reveal work OFF the main thread (the consumer
- * INP lever): the browser runs them on the compositor instead of a rAF/IO
- * listener loop in JS.
- *
- *   .scroll-progress      — a 0..1 scaleX bar driven by a `scroll()` timeline.
- *                           The `useScrollProgress` composable replacement.
- *   [data-scroll-reveal]  — fade + lift on entry, one `view()` timeline PER
- *                           child (the stagger is implicit — no setTimeout
- *                           cascade). The `useStaggerReveal` composable
- *                           replacement.
- *
- * DUAL-PATH with a SINGLE writer (no double-run): when the engine supports
- * `animation-timeline`, the CSS here owns the visual axis and the composables
- * gate their listener/observer machinery OFF (so CSS and JS never both write
- * the same target). When the engine does NOT support it, this block is skipped
- * by `@supports` and the composable is the sole writer. See the gate at the top
- * of `useScrollProgress.ts` / `useStaggerReveal.ts`.
- *
- * Baseline: `scroll-driven-animations` = Newly Available → adopt CSS as
- * primary, keep the composable as the ≤ 20-LOC feature-detected fallback.
- *
- * Reduced-motion is the OUTER gate: the whole `@supports` block sits under
- * `prefers-reduced-motion: no-preference`, so under PRM no scroll animation
- * attaches at all and content renders in its terminal state (the `from`
- * keyframe is never applied because the animation never binds).
- */
-
-/* ── Scroll progress (scroll() timeline) — drives a 0..1 scaleX bar.
- * Consumers add `.scroll-progress` on a position:fixed/absolute element; the
- * scroller is the nearest ancestor block scroller (`root` by default; override
- * via `--scroll-progress-scroller`). */
-@media (prefers-reduced-motion: no-preference) {
-    @supports (animation-timeline: scroll()) {
-        @keyframes gl-scroll-grow {
-            from { transform: scaleX(0); }
-            to   { transform: scaleX(1); }
-        }
-        .scroll-progress {
-            transform-origin: 0 50%;
-            animation: gl-scroll-grow auto linear;
-            animation-timeline: scroll(var(--scroll-progress-scroller, root) block);
-        }
-    }
-}
-
-/* ── View-driven entry (view() timeline) — the useStaggerReveal replacement.
- * Each child of a `[data-scroll-reveal]` scroller fades + lifts on entry. The
- * stagger is implicit in the per-element view-timeline (each child owns its
- * own timeline), so NO setTimeout cascade is needed. Horizontal scrollers add
- * `.scroll-reveal--inline` for a `view(inline)` axis. */
-@media (prefers-reduced-motion: no-preference) {
-    @supports ((animation-timeline: view()) and (animation-range: entry)) {
-        @keyframes gl-reveal-in {
-            from {
-                opacity: 0;
-                transform: translateY(var(--scroll-reveal-rise, 6px));
-            }
-        }
-        [data-scroll-reveal] > * {
-            animation: gl-reveal-in auto linear both;
-            animation-timeline: view(block);
-            animation-range: entry 0% entry var(--scroll-reveal-range-end, 60%);
-        }
-        [data-scroll-reveal].scroll-reveal--inline > * {
-            animation-timeline: view(inline);
-        }
-    }
-}
-
-/* ── ONCE latch (the virtualized/teleporting opt-in) — BC.W-MOTION-PRESETS.
- * The continuous `[data-scroll-reveal]` recipe above re-fires its entrance EVERY
- * time a child re-enters the entry range — correct for a calm cascade, WRONG for
- * a virtualized/teleporting list where a row scrolls out + back (it re-plays the
- * fade-lift). A native `view()` timeline cannot latch "play once" (the CSS limit),
- * so `[data-scroll-reveal-once]` swaps the live-range animation for a one-shot
- * `@keyframes` keyed off a `data-revealed` attr a tiny JS-assist IntersectionObserver
- * sets on FIRST cross + then `unobserve`s — the SHIPPED `useStaggerReveal` `once`
- * machinery (its `if (once) observer?.unobserve(el)` leg), reused, not re-authored.
- *
- * SINGLE WRITER — an element is `[data-scroll-reveal]` XOR `[data-scroll-reveal-once]`
- * (never both): the continuous path rides the `view()` timeline, the once path rides
- * the `[data-revealed]` attr. They never both drive the same child.
- *
- * The keyframe is the SAME fade-lift values as `gl-reveal-in` but runs FORWARD
- * (`from` hidden → `to` shown) so the terminal state holds without a timeline; the
- * `--spring-gentle` partial-sum settle is the convergence-reveal register a consumer
- * pairs with `useStagger` for the N-term build-up. Same PRM outer gate as the
- * continuous recipe (a flourish — under reduce the row paints in-place, no entrance). */
-@media (prefers-reduced-motion: no-preference) {
-    @keyframes gl-reveal-once {
-        from {
-            opacity: 0;
-            transform: translateY(var(--scroll-reveal-rise, 6px));
-        }
-        to {
-            opacity: 1;
-            transform: none;
-        }
-    }
-    [data-scroll-reveal-once] > * {
-        opacity: 0;
-    }
-    [data-scroll-reveal-once] > *[data-revealed] {
-        animation: gl-reveal-once var(--spring-gentle-duration) linear both;
-    }
-}
+.scroll-progress { transform-origin: 0 50%; transform: scaleX(0); } @media (prefers-reduced-motion: no-preference) { @supports (animation-timeline: scroll()) { @keyframes gl-scroll-grow { from { transform: scaleX(0); } to { transform: scaleX(1); } } .scroll-progress { animation: gl-scroll-grow auto linear; animation-timeline: var(--scroll-progress-timeline, scroll(nearest block)); } } } @media (prefers-reduced-motion: no-preference) { @supports ((animation-timeline: view()) and (animation-range: entry)) { @keyframes gl-reveal-in { from { opacity: 0; transform: translateY(var(--scroll-reveal-rise, 6px)); } } [data-scroll-reveal] > * { animation: gl-reveal-in auto linear both; animation-timeline: view(block); animation-range: entry 0% entry var(--scroll-reveal-range-end, 60%); } [data-scroll-reveal].scroll-reveal--inline > * { animation-timeline: view(inline); } } } @media (prefers-reduced-motion: no-preference) { @keyframes gl-reveal-once { from { opacity: 0; transform: translateY(var(--scroll-reveal-rise, 6px)); } to { opacity: 1; transform: none; } } [data-scroll-reveal-once] > * { opacity: 0; } [data-scroll-reveal-once] > *[data-revealed] { animation: gl-reveal-once var(--spring-gentle-duration) linear both; } }

package/dist/styles/scroll-progress-rim.css

@@ -0,0 +1 @@
+.scroll-progress-rim { position: absolute; inset: 0; border-radius: var(--scroll-progress-rim-radius, inherit); pointer-events: none; } .scroll-progress-rim__track { position: absolute; inset: 0; border: var(--scroll-progress-rim-width, 4px) solid transparent; border-radius: inherit; background: conic-gradient( from 0deg, var(--scroll-progress-rim-spectrum, var(--section-color-7)), transparent var(--scroll-progress-rim-fill, 0%), transparent 100% ); -webkit-mask: linear-gradient(#fff 0 0) padding-box, linear-gradient(#fff 0 0) border-box; -webkit-mask-composite: xor; mask: linear-gradient(#fff 0 0) padding-box, linear-gradient(#fff 0 0) border-box; mask-composite: exclude; } .scroll-progress-rim[data-coverage="bottom-edge"] .scroll-progress-rim__track { background: linear-gradient( to right, var(--scroll-progress-rim-spectrum, var(--section-color-7)), transparent var(--scroll-progress-rim-fill, 0%), transparent 100% ); -webkit-mask: linear-gradient( to top, #fff 0, #fff var(--scroll-progress-rim-width, 4px), transparent var(--scroll-progress-rim-width, 4px) ), linear-gradient(#fff 0 0) padding-box, linear-gradient(#fff 0 0) border-box; -webkit-mask-composite: source-in, xor, source-over; mask: linear-gradient( to top, #fff 0, #fff var(--scroll-progress-rim-width, 4px), transparent var(--scroll-progress-rim-width, 4px) ), linear-gradient(#fff 0 0) padding-box, linear-gradient(#fff 0 0) border-box; mask-composite: intersect, exclude, add; } .scroll-progress-rim[data-coverage="inline-end-edge"] .scroll-progress-rim__track { background: linear-gradient( to bottom, var(--scroll-progress-rim-spectrum, var(--section-color-7)), transparent var(--scroll-progress-rim-fill, 0%), transparent 100% ); -webkit-mask: linear-gradient( to left, #fff 0, #fff var(--scroll-progress-rim-width, 4px), transparent var(--scroll-progress-rim-width, 4px) ), linear-gradient(#fff 0 0) padding-box, linear-gradient(#fff 0 0) border-box; -webkit-mask-composite: source-in, xor, source-over; mask: linear-gradient( to left, #fff 0, #fff var(--scroll-progress-rim-width, 4px), transparent var(--scroll-progress-rim-width, 4px) ), linear-gradient(#fff 0 0) padding-box, linear-gradient(#fff 0 0) border-box; mask-composite: intersect, exclude, add; }