@mkbabb/glass-ui 6.0.0 → 8.0.0

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

@@ -3,22 +3,7 @@ export type BlobMood = "idle" | "happy" | "curious" | "sleepy" | "excited";
 /** Smin merge variant — `quadratic` (cheap, creased) | `circular` (rounder menisci). */
 export type BlobMerge = "quadratic" | "circular";
 /**
- * The render-variant axis (BC.W-GOOBLOB-PLAIN — STAGE 1 owns the first two members).
- *
- * - `"blob"` — the STAGE-1 first-principles floor: a plain shadowless lightless
- *   fill-only droplet (SDF + smin satellites + fwidth-AA + warm-cream fill). The
- *   minimal verifiable "it renders, it meatballs, it works on Safari" register the
- *   `uStage` gate strips the lit/shadow blocks for. NO specular, NO iridescence, NO
- *   SSS, NO shadow — deliberately minimal.
- * - `"meatball"` — the full lit register (the default): STAGE 2 builds the lit-glass
- *   surface / Fresnel rim / iridescence / SSS / shadow ON the same field via the
- *   `uLit`/`uShadow` flags. Byte-identical to the pre-STAGE-1 default pipeline.
- *
- * `"dot-matrix"` / `"dot-sphere"` are the later-sub-wave siblings (not STAGE 1).
- */
-export type BlobVariant = "blob" | "meatball";
-/**
- * Render-quality axis (AX.W16) — `full` (default) renders the metaball pass at the
+ * Render-quality axis: `full` (default) renders the metaball pass at the
  * clamped DPR; `half` renders the backing store at HALF resolution and lets the
  * browser bilinear-upsample on composite (~4× fragment savings for weak GPUs — the
  * blob is the ideal candidate: the soft FBM/AA edge hides the interpolation).
@@ -45,11 +30,11 @@ export interface MetaballSource {
     radius: number;
     opacity: number;
     /**
-     * BD.W-GOOBLOB-MERCURY-COLONY — the per-source SPLIT token (default `false`). When a
+     * the per-source SPLIT token (default `false`). When a
      * satellite is mid-`fissioning`, this is `true` and the uniform packers DROP the
      * `orbitWiden` bridge to nominal for it ALONE, so its neck thins past the smin reach
      * and SNAPS into a free bead. Every non-fissioning source keeps the full bridge (the
-     * R8-07 "instant fully-detached disc" cure). Trail sources never fission (`false`).
+     *  "instant fully-detached disc" cure). Trail sources never fission (`false`).
      */
     fissioning?: boolean;
 }
@@ -82,17 +67,17 @@ export interface SatelliteInternal {
      * `phase`, but exposed on the published `MetaballSource` (below) so the GL leaves can
      * gate the bridge widen per-satellite WITHOUT importing the satellite internals. A
      * fissioning satellite drops to nominal bridge (its neck snaps); every other
-     * satellite keeps the full+capped widen (R8-07 cured).
+     * satellite keeps the full+capped widen ( cured).
      */
     fissioning: boolean;
     /**
-     * BD.W-GOOBLOB-MERCURY-COLONY — the phase-local SNAP latch: false at the fission
+     * the phase-local SNAP latch: false at the fission
      * beat start, set true once the neck crosses the snap band (so the body-pulse recoil
      * kick fires EXACTLY ONCE per pinch, not every frame across the snap window).
      */
     snapFired: boolean;
 }
-/** Body / orbit / satellite geometry — the contained-droplet length cohort (W15). */
+/** Body, orbit, and satellite geometry. */
 export interface BlobGeometry {
     canvasSize: number;
     bodyRadius: number;
@@ -134,14 +119,12 @@ export interface BlobColor {
     colorNoiseFreq: number;
     colorNoiseSpeed: number;
     /**
-     * BI.W-BLOB-SEAMS (GAP-L5 / value.js D8) — the OKLab-L ink FLOOR the derived
-     * palette's deepest (body) stop is clamped to, so a seed-derived hero body never
-     * collapses toward an illegible near-black. A CONFIG atom (the consumer/HERO sets
-     * it; the palette derivation reads it via `deriveBlobPalette`'s `lightnessFloor`
-     * param). Bracket-bounded `[0.12, 0.20]` OKLab L — see `LIGHTNESS_FLOOR_BRACKET` /
-     * `clampLightnessFloor` (`./presets`); default 0.15. This does NOT affect the bare
-     * default paint (its `paletteStops` are pre-baked CSS strings) — it is the floor a
-     * consumer DERIVING a palette off `config.color.lightnessFloor` applies.
+     * The OKLab-L floor for the deepest derived palette stop, preventing a
+     * seed-derived hero body from collapsing toward an illegible near-black.
+     * Palette derivation reads it through `deriveBlobPalette.lightnessFloor`.
+     * Bounded to `[0.12, 0.20]` OKLab L by `LIGHTNESS_FLOOR_BRACKET` and
+     * `clampLightnessFloor`; default 0.15. This does not affect the pre-baked
+     * default `paletteStops`.
      */
     lightnessFloor?: number;
 }
@@ -149,14 +132,13 @@ export interface BlobColor {
 export interface BlobSurface {
     lit: boolean;
     /**
-     * The procedural 2D SDF soft-shadow march (BC.W-GOOBLOB-MEATBALL T2). A soft contact
-     * shadow FOLLOWING the irregular silhouette (NOT a hard disc/box shadow), gated behind
-     * the shader `uShadow` flag. Default ON (the `meatball` register); the `blob` STAGE-1
-     * floor ships shadowless via the `uStage` gate.
+     * Procedural 2D SDF soft-shadow march. The contact shadow follows the irregular
+     * silhouette rather than a disc or box, gated by `uShadow`. Default on; the
+     * flat `blob` stage is shadowless through `uStage`.
      */
     shadow: boolean;
     /**
-     * Soft-shadow penumbra hardness (BC.W-GOOBLOB-MEATBALL T2) — the inverse light-source
+     * Soft-shadow penumbra hardness: the inverse light-source
      * size fed to the IQ rmshadows march `w` term (a higher value = a harder penumbra).
      * Range 4–48, default 16.
      */
@@ -184,29 +166,29 @@ export interface BlobSurface {
     /** Thickness-driven inner-luminosity (core glow) lift. */
     coreGlow: number;
     /**
-     * BD.W-GOOBLOB-MERCURY-COLONY — the MERCURY-COLONY split register (the OPT-IN scalar,
-     * 0..1, default the calm floor `0`). At `0` the shipped `variant:"blob"` default stays
-     * calm + gate-faithful: a permanently-bonded merge/un-merge breath, NO pinch (so
-     * `proof:blob-render`/`-studio`/`-page` are UNMOVED — `orbitRadius 0.17` is NOT
+     * the MERCURY-COLONY split register (the OPT-IN scalar,
+     * 0..1, default the calm floor `0`). At `0` a flat-surface configuration stays
+     * calm: a permanently bonded merge/unmerge breath with no pinch, so the existing
+     * studio and page presets remain unchanged and `orbitRadius 0.17` is not
      * re-based). Lifting it toward `1` arms the `fissioning` beat: the colony breathes a
      * satellite OUT through a thinning neck whose gap exceeds the smin reach so it SNAPS
      * into a free orbiting bead (the mercury pinch), then re-merges next cycle. This is a
-     * DERIVED bundling over the EXISTING `surface` atom (the variant IS the bundle) — NOT
+     * DERIVED bundling over the EXISTING `surface` atom — NOT
      * a 9th geometry atom; the split rides MOTION (the satellite moves) on the EXISTING
      * phase machine, NOT a global smin-band re-base (which would lean-regress per
-     * AZ.W-BLOB-STUDIO D2). Mood-coupled: `excited` splits more, `sleepy` barely. The
+     *  D2). Mood-coupled: `excited` splits more, `sleepy` barely. The
      * `colony`/`mercury` register a consumer/studio opts into.
      */
     fissionAmp: number;
 }
-/** Pointer interaction — lean / squash-stretch / click-impulse. */
+/** Pointer interaction — lean, squash-stretch, click-impulse. */
 export interface BlobInteraction {
     pointerAttraction: number;
     pointerStrength: number;
     /**
      * Velocity-driven volume-preserving squash-and-stretch magnitude (0 = off).
      *
-     * AY.W-BLOB-CONFIG D3 — a SWAMPED fine-detail axis. The squash rides the smoothed
+     *  D3 — a SWAMPED fine-detail axis. The squash rides the smoothed
      * spring velocity (`useBlobPointer`'s critically-damped `response: 0.18` follow),
      * which is heavily damped and down-scaled into body space — so the tanh-saturated
      * elongation reads at the noise floor (a live readback measured 0% body-aspect change
@@ -230,25 +212,11 @@ export interface BlobConfig {
     surface: BlobSurface;
     interaction: BlobInteraction;
     /**
-     * The render variant (BC.W-GOOBLOB-PLAIN) — `"meatball"` (default, the full lit
-     * pipeline) | `"blob"` (the STAGE-1 plain shadowless fill-only floor). `"blob"`
-     * sets the shader `uStage` gate so the lit/shadow/iridescence/SSS blocks are NOT
-     * reached — the minimal verifiable floor. `"meatball"` is byte-identical to the
-     * pre-STAGE-1 default (the `surface.lit` flag still owns the lit-on/off within it).
-     */
-    variant: BlobVariant;
-    /**
-     * BD.W-GOO-CAROUSEL-DECK — the blob↔meatball SHADING-MORPH scalar (0..1). The user's
-     * "MORPH BLOB and MEATBALL from one to another" — a CONTINUOUS in-between, not a hard
-     * `variant` cut. `0` = the flat warm-cream blob (byte-identical to `variant: "blob"`);
-     * `1` = the fully-dressed lit meatball (byte-identical to `variant: "meatball"`);
-     * `0 < morphT < 1` lerps the SURFACE shading (the smin GEOMETRY is shared, so only the
-     * fill→lit/shadow/iridescence dressing interpolates). UNSET (the default) → the value
-     * is resolved from `variant` (blob → 0, meatball → 1), so the existing `variant` prop
-     * is byte-back-compat. A consumer ANIMATING this (a `useSpring`/registered-scalar) gets
-     * the live morph.
+     * The sole flat↔dressed surface axis. Values are clamped to `[0, 1]`: `0` is the
+     * flat warm-cream blob, `1` is the fully dressed lit meatball, and intermediate
+     * values smoothly interpolate the surface over the shared smin geometry.
      */
-    morphT?: number;
+    morphT: number;
     quality: BlobQuality;
     tempo: number;
 }

package/dist/components/button/Button.vue.d.ts

@@ -1,27 +1,39 @@
-import type { ButtonHTMLAttributes, HTMLAttributes } from 'vue';
-import { type PrimitiveProps } from 'reka-ui';
-import { type ButtonVariants } from './';
-import type { Surface } from '../_shared/useSurfaceAxis';
-interface Props extends PrimitiveProps {
-    variant?: ButtonVariants['variant'];
-    size?: ButtonVariants['size'];
-    tone?: ButtonVariants['tone'];
-    iconOnly?: ButtonVariants['iconOnly'];
-    class?: HTMLAttributes['class'];
-    surface?: Surface;
-    liquid?: boolean;
-    punch?: boolean;
-    type?: ButtonHTMLAttributes['type'];
-    disabled?: ButtonHTMLAttributes['disabled'];
-    /** Marks an in-flight command and disables native activation until it settles. */
+import { type ButtonHTMLAttributes, type HTMLAttributes } from "vue";
+import type { Size, Tone } from "../_shared/axes.js";
+import type { PrimitiveProps } from "../_shared/primitive.js";
+export type ButtonEmphasis = "primary" | "secondary" | "quiet" | "text";
+export type ButtonSize = Extract<Size, "xs" | "sm" | "md" | "lg">;
+/**
+ * The command's intent axis, a RESTRICTION of the one `Tone` union (the sub-range
+ * law). A command is neutral or it is destructive; `success`/`warning`/`info` are
+ * message tones and live on Alert/Toast, where a surface reports rather than acts.
+ */
+export type ButtonTone = Extract<Tone, "neutral" | "destructive">;
+export interface ButtonProps extends PrimitiveProps {
+    /** Visual priority. It does not change the command's semantics. */
+    emphasis?: ButtonEmphasis;
+    /** Semantic intent, orthogonal to emphasis. Tone tints; it never replaces. */
+    tone?: ButtonTone;
+    size?: ButtonSize;
+    /** Square geometry for an accessibly named icon command. */
+    iconOnly?: boolean;
+    /** Marks an in-flight command and suppresses activation until it settles. */
     loading?: boolean;
+    type?: ButtonHTMLAttributes["type"];
+    disabled?: ButtonHTMLAttributes["disabled"];
+    class?: HTMLAttributes["class"];
 }
-declare var __VLS_17: {};
+declare var __VLS_23: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_17) => any;
+    default?: (props: typeof __VLS_23) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
-    as: import("reka-ui").AsTag | import("vue").Component;
+declare const __VLS_base: import("vue").DefineComponent<ButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ButtonProps> & Readonly<{}>, {
+    size: ButtonSize;
+    as: import("../_shared/primitive.js").AsTag | import("vue").Component;
+    tone: ButtonTone;
+    emphasis: ButtonEmphasis;
+    iconOnly: boolean;
+    loading: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/button/index.d.ts

@@ -1,9 +1 @@
-import { type VariantProps } from 'class-variance-authority';
-export { default as Button } from './Button.vue';
-export declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "glass" | "accent" | "secondary" | "outline" | "primary-audacious" | "gold-audacious" | "ghost" | "glass-wash" | "ai" | null | undefined;
-    size?: "sm" | "md" | "lg" | "xs" | null | undefined;
-    iconOnly?: boolean | null | undefined;
-    tone?: "neutral" | "destructive" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export type ButtonVariants = VariantProps<typeof buttonVariants>;
+export { default as Button, type ButtonProps, type ButtonEmphasis, type ButtonSize, type ButtonTone, } from "./Button.vue.js";

package/dist/components/button/styles.css

@@ -0,0 +1 @@
+@layer components{.button{--button-size: var(--control-h-md);--button-tone: var(--foreground);--button-accent: var(--primary);--button-quiet-ink: var(--muted-foreground);--button-ink: var(--button-tone);--button-edge: transparent;display: inline-flex;min-inline-size: 0;max-inline-size: 100%;min-block-size: var(--button-size);align-items: center;justify-content: center;gap: var(--space-atom);padding-inline: var(--space-body);border: 1px solid var(--button-edge);border-radius: calc(var(--button-size) / 2);color: var(--button-ink);font: inherit;font-size: var(--control-text);font-weight: 500;line-height: 1.1;text-align: center;text-decoration: none;cursor: pointer;appearance: none;touch-action: manipulation;user-select: none;scale: 1;--scale-press: var(--scale-press-sm);transition: background-color var(--engage-control-engage-release) var(--ease-standard),border-color var(--engage-control-engage-release) var(--ease-standard),box-shadow var(--engage-control-engage-release) var(--ease-standard),color var(--engage-control-engage-release) var(--ease-standard),opacity var(--engage-control-engage-release) var(--ease-standard),scale var(--spring-press-duration) var(--transition-liquid-spatial);}.button > svg{flex: none;pointer-events: none;}.button > svg:not([class*="size-"]){inline-size: var(--ui-glyph);block-size: var(--ui-glyph);}.button > .button-mark{flex: none;inline-size: var(--ui-glyph);}.button[data-emphasis="primary"]{--glass-depth: var(--glass-depth-content);font-weight: 600;}.button[data-emphasis="secondary"]{--glass-veil-tier: var(--glass-veil-quiet);--glass-blur-floating: var(--glass-blur-quiet);}.button[data-tone="destructive"]{--button-tone: var(--destructive);--button-accent: var(--destructive);--button-quiet-ink: var(--destructive);--button-edge: color-mix( in oklab,var(--destructive) calc(var(--ink-perimeter) * 100%),transparent );--glass-capsule-fill: color-mix( in oklab,var(--glass-veil),var(--destructive) var(--feedback-tone-strength) );}.button[data-emphasis="quiet"],.button[data-emphasis="text"]{--button-edge: transparent;--button-ink: var(--button-quiet-ink);background: transparent;box-shadow: none;}.button[data-emphasis="text"]{--button-ink: var(--button-accent);padding-inline: var(--space-residue);text-underline-offset: 0.25em;}@media (hover: hover){.button[data-emphasis="quiet"]:hover:not(:disabled,[aria-disabled="true"]){--button-ink: var(--button-tone);background: color-mix( in oklab,var(--button-tone) calc(var(--fill-hover) * 100%),transparent );}.button[data-emphasis="text"]:hover:not(:disabled,[aria-disabled="true"]){text-decoration: underline;}}.button[data-emphasis="quiet"]:active:not(:disabled,[aria-disabled="true"]){background: color-mix( in oklab,var(--button-tone) calc(var(--fill-selected) * 100%),transparent );}.button[data-emphasis="text"]:active:not(:disabled,[aria-disabled="true"]){background: color-mix( in oklab,var(--button-accent) calc(var(--fill-hover) * 100%),transparent );}.button[data-size="xs"]{--button-size: var(--control-h-xs);gap: var(--space-residue);padding-inline: var(--space-atom);font-size: var(--control-text-sm);}.button[data-size="sm"]{--button-size: var(--control-h-sm);gap: var(--space-residue);padding-inline: var(--space-atom);font-size: var(--control-text-sm);}.button[data-size="lg"]{--button-size: var(--control-h-lg);font-size: var(--type-body);}.button[data-icon-only]{inline-size: var(--button-size);block-size: var(--button-size);min-block-size: var(--button-size);padding: 0;}.button:disabled,.button[aria-disabled="true"]{--button-ink: oklch(from var(--foreground) l 0 h / var(--opacity-disabled));cursor: not-allowed;}.button[data-loading]{cursor: progress;}.button.glass-specular-track:active::before{--specular-intensity: calc( var(--glass-specular-intensity-hover) + ( var(--glass-specular-intensity-active) - var(--glass-specular-intensity-hover) ) * var(--glass-btn-press-t) );}}

package/dist/components/card/Card.vue.d.ts

@@ -1,174 +1,36 @@
-import { type HTMLAttributes } from "vue";
-import type { PrimitiveProps } from "reka-ui";
-import type { Surface as SurfaceKind } from "../_shared/useSurfaceAxis";
-import type { Motion } from "../_shared/axes";
+import { type SurfaceProps } from "../surface/Surface.vue.js";
+export type CardSize = "sm" | "md";
 /**
- * The glass surface ladder — the 5-rung base tier (BI.W-SURFACE-EXTRACT collapsed
- * `opaque`/`deep` OUT of this union). Maps 1:1 to `.glass-{tier}` in glass.css and is
- * now value-identical to the `SurfaceTier` grammar vocabulary:
+ * A semantic content group. Material concerns are forwarded to Surface; the card
+ * owns proportion, anatomy, and — when `selected` is present — engagement.
  *
- *   wash     — lightest (~0.30α)        : inline workspace chrome, scroll-pane host
- *   quiet    — light    (~0.50α)        : ambient panels, secondary surfaces
- *   resting  — canonical (~0.65α)       : the protagonist plate (default)
- *   floating — heavy   (~0.80α)         : popover-class, login surfaces
- *   overlay  — heaviest (~0.95α + blur) : modal-on-modal, dialog over content
- *
- * The solid-card escape is now `<Card surface="opaque">` (the `--glass-level:0`
- * decoration on the surface axis, not a tier), and the maximal iOS-27 deep-glass
- * register is `<Card deep>` (the boolean — `.glass-floating glass-deep`, BB.W-DEEP-GLASS).
- * Both are clean breaks: no `tier="opaque"` / `tier="deep"` alias (MIGRATION row).
- */
-export type CardTier = "wash" | "quiet" | "resting" | "floating" | "overlay";
-/**
- * Surface decoration register — the SHARED {glass·veil·opaque·clear} axis (the
- * `Surface` grammar) PLUS Card's local `cartoon` superset (BI.W-SURFACE-EXTRACT:
- * `CardSurface = Surface | "cartoon"`; `opaque`/`clear` joined the union as the
- * `tier="opaque"` collapse landing + the clear register). Orthogonal to
- * `tier`/`shadow`/`grain`.
- *
- *   glass    — the tier's plain glass rung (default)
- *   veil     — the text-legibility PLATE (R5-7). The wash/quiet glass fill + blur
- *              with the border AND rim/highlight STRIPPED. An optional radial
- *              feather axis (`--veil-feather`, default none). Routes the glass
- *              material through the `--glass-*` ladder, so `--glass-level` / the
- *              W55 bright-bucket retune it in lockstep with every glass surface.
- *   opaque   — the `--glass-level:0` solid-card escape (the prior `tier="opaque"`
- *              rung's clean-break successor): a solid `--card` plate through the ONE
- *              level knob, the tint axis zeroed.
- *   clear    — the scrim-coupled maximally-translucent Apple-Clear plate
- *              (BE.W-CLEAR-VARIANT).
- *   cartoon  — the Card-LOCAL Memphis-sticker decoration (NOT a `Surface` axis
- *              member — the grammar fence): 2px border, offset-stamp shadow,
- *              hover-lift. Composes onto ANY tier over the glass base.
- */
-export type CardSurface = SurfaceKind | "cartoon";
-/**
- * Specular catch-light register (AX.W09) — the pointer-anchored moving lens on a
- * glass card.
- *
- *   off    — NO catch-light (default). The clean resting panel: a data/content
- *            `surface="glass"` card over any backplate reads flat — no centred
- *            white bloom, no pointer wiring. The §24 three-consumer-confirmed
- *            default for the common content-card case.
- *   subtle — the token-ladder lens: the pointer-anchored catch-light wakes on
- *            hover/active at the SUBTLE `--glass-specular-intensity-*` magnitudes.
- *            The explicit opt-in for a hero/chrome surface.
- *   full   — the brighter pre-tune rung set, for the busy-backdrop case the recipe
- *            was originally authored over (a local intensity-token override).
- */
-export type CardSpecular = "off" | "subtle" | "full";
-/**
- * Decoration variant — the ONE new Atlas component (BC.W-SELECTION-CARD, the I5
- * selection card). Default UNSET: a bare `<Card>` is byte-identical to HEAD; the
- * variant is additive default-OFF (the no-op floor). `selection` binds
- * `:data-variant="selection"` on the root and ROUTES the chromatic-rim (A-2,
- * `--glass-accent`) + selected metal-shimmer (A-3, `.metal-*-border`) decoration
- * through the SHARED BUILT seams — it mints NO new sub-system. The shape mirrors
- * the `surface` axis exactly: a data-attr the CSS seam reads, ORTHOGONAL to
- * `tier`/`surface`/`motion` (a `variant="selection" surface="glass"
- * tier="resting" as="button"` card is valid). The hue is a CONSUMER value
- * (`data-hue`/`data-hue-strength` per-instance); NO consumer hue enters a token.
+ * `material` is SEVERED (DAG, via `_shared/surface`): the card is the elevated
+ * role by construction, which is Surface's own default, so the axis added a knob
+ * and no capacity. `shadow` is CARD's own — Surface went three-prop and the
+ * card is the one component with a real elevation grammar, so it stamps its own
+ * `data-shadow` for the edge keying instead of routing the flag through a
+ * primitive that no longer reads it. `grain` and `specular` are gone from the
+ * whole library. `cartoon` / `grid` / `metal` / `variant` / `dataHue` /
+ * `dataHueStrength` are struck: three of them wrote a class a consumer can write
+ * (`cartoon-surface`, `paper-grid`), and `variant`+`dataHue`+`selected` were one
+ * state wearing three props. A per-instance rim hue is `--glass-accent`, written
+ * by the consumer on the element.
  */
-export type CardVariant = "selection";
-/** The earned metal for a SELECTED selection-card (gold default — BA.W-PHASE-PALETTE
- *  "gold is earned" for the chosen item). Composes the BUILT `.metal-{name}-border`
- *  utility; NO forked keyframe, NO baked metal color. */
-export type CardMetal = "gold" | "silver" | "bronze";
-interface Props extends PrimitiveProps {
-    /** Surface tier; selects one rung of the glass ladder. Default `resting`. */
-    tier?: CardTier;
-    /** Surface decoration register (the shared `Surface` axis + Card's `cartoon`
-     *  superset). `glass` (default) renders the tier's glass rung; `veil` overlays
-     *  the borderless/rimless text-legibility plate; `opaque` is the
-     *  `--glass-level:0` solid-card escape (the `tier="opaque"` collapse landing);
-     *  `clear` the scrim-coupled Apple-Clear plate; `cartoon` overlays the
-     *  Card-LOCAL Memphis-sticker decoration. Orthogonal to `tier`/`shadow`/`grain`. */
-    surface?: CardSurface;
-    /** BB.W-DEEP-GLASS — the maximal iOS-27 deep-glass opt-in (Apple
-     *  saturate-1.5/blur-16px): the `.glass-deep` decoration on the `floating` base
-     *  rung. Default `false` (the calm content default, byte-unchanged). The
-     *  clean-break successor of the retired `tier="deep"` rung. */
-    deep?: boolean;
-    /** Surface drop shadow via `--shadow-card`. Off for cards nested inside cards. */
+export interface CardProps extends SurfaceProps {
+    size?: CardSize;
+    /** The opt-in elevation. Card owns this axis; Surface no longer has one. */
     shadow?: boolean;
-    /** `::after` paper-grain overlay. Off for scroll panes (the grain conflicts
-     *  with overflow:auto repaints). */
-    grain?: boolean;
-    /** BB.W-PAPER-GRID-TEXTURE — the GEOMETRIC paper register: a `::after`
-     *  blueprint/graph-paper grid felt THROUGH the card interior (the math/grid
-     *  brand pillar, read through the plate rather than only in the page
-     *  margin). Default **OFF** — a bare card is byte-identical to HEAD; a
-     *  document-register card opts in. ORTHOGONAL to `grain` (organic) — a card
-     *  may carry BOTH the turbulence grain and the geometric grid. The register
-     *  doctrine (paper-register cards opt in, instrument-glass surfaces do NOT)
-     *  is a CONSUMER choice the default-OFF honors by construction. */
-    grid?: boolean;
-    /** Specular catch-light register (AX.W09). `off` (default) keeps the card
-     *  CLEAN — no pointer-anchored lens, clean over any backplate (the §24
-     *  three-consumer-confirmed default for a data/content card). `subtle` wakes
-     *  the pointer-anchored moving catch-light at the token-ladder magnitudes (a
-     *  hero/chrome opt-in); `full` runs the brighter pre-tune rung set for a busy
-     *  backdrop. Only `glass` surfaces wire it; `cartoon` owns its own sticker lift. */
-    specular?: CardSpecular;
-    /** BH.W-MOTION-AXIS — the ONE motion-weight axis (the `pressable` boolean's
-     *  clean-break successor). `full` (default) — the FULL liquid register, gesture
-     *  enrichments armed (zero-delta at default). `reduced` — the JS press physics
-     *  degrade to the `.tap-squish` `:active` CSS floor (the SAME state PRM produces).
-     *  `off` — the press unbinds AND `--motion-weight: 0` zeroes the cartoon channels;
-     *  the click still selects. PRM forces `full → reduced` regardless (a11y absolute).
-     *
-     *  The press CAPABILITY derives from INTERACTIVITY, not this axis: a Card presses
-     *  IFF it renders interactive (`as="button"`/`as="a"`/`href`/`role="button"` on the
-     *  root) AND `motion !== "off"`. A bare static `<Card>` never presses because it has
-     *  no interaction to enrich — the "static plate never presses" fence holds by
-     *  DERIVATION, not by a default. The press is `useLiquidPress` (the interruptible
-     *  coupled spring-press — Card is the SECOND `useSpringPress` binary, Button first),
-     *  compositor-only (`scale` + `--card-press-t`); the `.glass-press` CSS `:active`
-     *  scale is the no-JS / SSR floor. */
-    motion?: Motion;
-    /** BC.W-SELECTION-CARD — the selection decoration axis (the ONE new Atlas
-     *  component). `selection` ROUTES the per-instance data-hue rim (A-2) +
-     *  the selected metal-shimmer border (A-3) through the BUILT seams; default
-     *  UNSET (a bare Card is byte-identical to HEAD). ORTHOGONAL to
-     *  `tier`/`surface`/`motion`. */
-    variant?: CardVariant;
-    /** BC.W-SELECTION-CARD — the chosen state of a `variant="selection"` card.
-     *  When `true` the card composes the earned `.metal-${metal}-border` swept
-     *  rim + lifts the accent-strength toward `--selection-accent-strength-selected`
-     *  (rim-not-fill — the plate stays warm-cream translucent). The consumer wires
-     *  the matching `aria-selected`/`aria-checked` role contract on the card. */
+    /** Presence makes the card an option: role, tabindex, aria-selected, states. */
     selected?: boolean;
-    /** BC.W-SELECTION-CARD — the metal of the SELECTED-state swept rim. `gold`
-     *  (default) is earned for the chosen item; `silver`/`bronze` are the other
-     *  two BUILT `.metal-*-border` quads. Only read when `variant="selection"` +
-     *  `selected`. */
-    metal?: CardMetal;
-    /** BC.W-SELECTION-CARD — the per-instance data hue (a complete `<color>`) a
-     *  `variant="selection"` card tints its RIM + catch-light glint toward (the
-     *  A-2 `--glass-accent` consumer). The hue NEVER tints the plate background
-     *  (the distinct-axis fence); unset → the neutral `transparent` no-op floor. */
-    dataHue?: string;
-    /** BC.W-SELECTION-CARD — the bounded accent strength override (a `<percentage>`,
-     *  e.g. `"20%"`). Unset → the calm `--selection-accent-strength` default
-     *  (≤ the W-GLASS-ACCENT rim ceiling). Bounded — a whisper at the rim, never a
-     *  flooded plate. */
-    dataHueStrength?: string;
-    class?: HTMLAttributes["class"];
 }
-declare var __VLS_17: {};
+declare var __VLS_8: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_17) => any;
+    default?: (props: typeof __VLS_8) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+declare const __VLS_base: import("vue").DefineComponent<CardProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CardProps> & Readonly<{}>, {
+    size: CardSize;
     shadow: boolean;
-    as: import("reka-ui").AsTag | import("vue").Component;
-    surface: CardSurface;
-    grid: boolean;
-    deep: boolean;
-    tier: CardTier;
-    grain: boolean;
-    specular: CardSpecular;
-    metal: CardMetal;
+    selected: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/card/CardContent.vue.d.ts

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'vue';
+import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/card/CardDescription.vue.d.ts

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'vue';
+import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/card/CardFooter.vue.d.ts

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'vue';
+import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/card/CardHeader.vue.d.ts

@@ -1,47 +1,15 @@
-import type { HTMLAttributes } from 'vue';
-/**
- * <CardHeader> — header lane of the Card family.
- *
- * AI.W1-α additive `shrink` modifier — when true, the header binds to the
- * `--card-scroll` named scroll-timeline (emitted by the canonical
- * `.card-scroll-host` utility on a scroll-overflow ancestor, owned by
- * `<ScrollCard>`) and runs the 4-lane compositor-safe shrink choreography as
- * the host scrolls: (1) header content compress (translateY), (2) title
- * shrink-in-place (the shared `title-collapse` SCALE keyframe), (3)
- * description retire (opacity + scaleY), (4) header background lift (a
- * `::before` backplate opacity). Every lane is COMPOSITOR-SAFE (scale /
- * transform / opacity only — BB.W-CARD-COMPOSITE) so ZERO reflow fires per
- * scroll frame (the A'-3 CLS 1.03 worst-cluster killed).
- *
- * BG.W-SCROLL-SHRINK-UNIFY — the choreography is EXTERNALIZED to the global,
- * un-hashed `src/styles/card-scroll.css` (this SFC carries NO `<style>` block).
- * A global stylesheet has no Vue `data-v-…` scope hash, so it reaches the
- * light-DOM slotted `<CardTitle>`/`<CardDescription>` via the PLAIN descendant
- * selector `.card-header--shrink > [data-slot=…]` (the correct global-file form
- * — no `:slotted()`/`:deep()` scope escape needed). The lane-2 title SCALE leg
- * is shared with the page/hero large-title collapse via ONE `@keyframes
- * title-collapse` (the DRY fold; card supplies `--title-collapse-scale: 0.695`,
- * page/hero supply `0.82`). The scrub ease is the NO-OVERSHOOT
- * `--card-shrink-ease` (off the retired cartoon-punch — a scroll scrub must be
- * monotonic). `proof:no-layout-animation` (W1-W4) makes the layout-property
- * class structurally impossible to re-ship AND asserts the externalized-global
- * shape.
- *
- * **Required ancestor**: when `shrink` is true, `.card-scroll-host` MUST sit on
- * the scroll-overflow ancestor (`<ScrollCard>` owns it). Without that host the
- * named timeline never emits and the choreography sits idle. Sticky positioning
- * stays consumer-side (the consumer adds `class="sticky top-0"` etc. via
- * `props.class`); the background TINT is scroll-driven by lane 4.
- */
+import { type HTMLAttributes } from "vue";
 type __VLS_Props = {
     /**
-     * Bind the header to the `--card-scroll` named timeline and run the
-     * 3-lane shrink choreography. Requires `.card-scroll-host` on the
-     * scroll-overflow ancestor. Default `false` — the existing 5+
-     * consumers see no change.
+     * Requires `.card-scroll-host` on the scrollable ancestor — an element INSIDE
+     * the plate, NEVER the plate itself. The host wears `overflow-y` and the
+     * trailing feather MASK, and a mask clips the element's whole rendering: put
+     * it on the `<Card>` and the plate's own bottom edge dissolves and the cast it
+     * casts is clipped away with it. The host is the viewport the header sticks
+     * to; the plate stays crisp around it.
      */
     shrink?: boolean;
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/card/CardTitle.vue.d.ts

@@ -1,12 +1,15 @@
 import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
+    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
     class?: HTMLAttributes["class"];
 };
-declare var __VLS_1: {};
+declare var __VLS_8: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+    default?: (props: typeof __VLS_8) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    as: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+}, {}, {}, {}, 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;

package/dist/components/card/index.d.ts

@@ -1,9 +1,6 @@
-export { default as Card, type CardTier, type CardSurface, type CardSpecular, type CardVariant, type CardMetal, } from "./Card.vue";
-export { default as CardHeader } from "./CardHeader.vue";
-export { default as ScrollCard, type ScrollCardProps } from "./ScrollCard.vue";
-export { default as ScrollCardHeader, type ScrollCardHeaderProps, } from "./ScrollCardHeader.vue";
-export { default as CardTitle } from "./CardTitle.vue";
-export { default as CardDescription } from "./CardDescription.vue";
-export { default as CardContent } from "./CardContent.vue";
-export { default as CardFooter } from "./CardFooter.vue";
-export { default as CardAction } from "./CardAction.vue";
+export { default as Card, type CardProps, type CardSize } from "./Card.vue.js";
+export { default as CardHeader } from "./CardHeader.vue.js";
+export { default as CardTitle } from "./CardTitle.vue.js";
+export { default as CardDescription } from "./CardDescription.vue.js";
+export { default as CardContent } from "./CardContent.vue.js";
+export { default as CardFooter } from "./CardFooter.vue.js";

package/dist/components/card/scroll.css

@@ -0,0 +1 @@
+@layer components{.card-scroll-host{contain: layout style paint;overflow-y: auto;mask-image: linear-gradient( to bottom,black calc(100% - var(--fade-end)),transparent 100% );}@supports (animation-timeline: scroll()){.card-scroll-host{animation: gl-fade-end-out linear both;animation-timeline: scroll(self block);animation-range: calc(100% - var(--fade-scroll-width)) 100%;}}.card-header--shrink{position: relative;isolation: isolate;}.card-header--shrink::before{content: "";position: absolute;inset: 0 0 calc(var(--card-gap) * -1);z-index: -1;border-radius: inherit;background: var(--glass-veil);mask-image: linear-gradient( to bottom,black calc(100% - var(--card-gap)),transparent );opacity: 0;pointer-events: none;transition: opacity var(--duration-normal) var(--ease-standard);}.card-header--shrink > [data-slot="card-title"]{font-size: calc(var(--type-body) * 2.058);transform-origin: 0 50%;}.card-header--shrink[data-condensed="true"]{padding-block-start: var(--card-gap);}.card-header--shrink[data-condensed="true"]::before{opacity: 1;}.card-header--shrink[data-condensed="true"] > [data-slot="card-title"]{font-size: calc(var(--type-body) * 1.618);}@keyframes card-title-condense{from{scale: 1.272;}to{scale: 1;}}@keyframes card-title-release{from{scale: 0.786151;}to{scale: 1;}}.card-header--shrink[data-shrink-glide][data-condensed="true"] > [data-slot="card-title"]{animation: card-title-condense var(--duration-normal) var(--ease-standard);}.card-header--shrink[data-shrink-glide][data-condensed="false"] > [data-slot="card-title"]{animation: card-title-release var(--duration-normal) var(--ease-standard);}.card-header--shrink > [data-slot="card-description"]{transition: opacity var(--duration-normal) var(--ease-standard),visibility var(--duration-normal) var(--ease-standard);transition-behavior: allow-discrete;}.card-header--shrink[data-condensed="true"] > [data-slot="card-description"]{visibility: hidden;opacity: 0;}@media (prefers-reduced-motion: reduce){.card-header--shrink::before,.card-header--shrink > [data-slot="card-description"]{transition: none;}.card-header--shrink[data-shrink-glide] > [data-slot="card-title"]{animation: none;}}}