@mkbabb/glass-ui 4.0.1 → 4.2.0

package/dist/components/custom/watercolor-dot/WatercolorDot.vue.d.ts

@@ -1,32 +1,47 @@
 /**
- * WatercolorDot — an organic pastel blob swatch (AU.W7 lift). A CSS/SVG primitive
- * (no WebGL): the blob shape is a deterministic per-vertex `border-radius` morph
- * (seeded by `color + seed`), and the wet, bleeding edge is an SVG turbulence +
- * displacement filter that is INTERNALISED — the component mounts its own
- * namespaced `<filter>` so there is zero consumer plumbing. Mount the dot and the
- * filter just works.
+ * WatercolorDot — an organic pastel blob swatch. A CSS/SVG primitive (NO drawing
+ * context — no WebGL/WebGPU/Canvas2D; the deliberate suite counterexample, the mark
+ * that documents WHY it is not a GPU context): the blob shape is a deterministic
+ * per-vertex `border-radius` morph (seeded by `color + seed`), and the wet, bleeding
+ * edge is an SVG turbulence + displacement filter that is INTERNALISED — the component
+ * mounts its own namespaced `<filter>` so there is zero consumer plumbing. Mount the
+ * dot and the filter just works.
+ *
+ * Safari-safe by construction (USER-DEFECTS §H): the SVG `<filter>` rasterizes ONCE
+ * + caches (the HandMark `texture.ts` idiom) and NEVER re-rasterizes per frame; the
+ * `animate` liveness rides a seeded COMPOSITOR `transform` wobble the compositor
+ * accelerates without touching the filter graph (a per-frame `border-radius` paint
+ * under the filter is the §H Safari flash, retired here). The filter `seed` is
+ * per-instance off `hashString(color + seed)` so each dot's wet edge is uniquely
+ * displaced (no twelve-clones).
  *
  * Color arrives as a CSS string painted straight onto the swatch background — the
  * dot needs no resolver because it does not feed a shader; the injected-color seam
- * shape is "pass the CSS color in".
+ * shape is "pass the CSS color in". Warm-cream identity by default (the dot bakes no
+ * hue; the demo palette is presets-in-consumers).
  */
 type __VLS_Props = {
     /** CSS color painted as the swatch background (any CSS color form). */
     color: string;
     /**
-     * Render mode (BA.W-EMISSION / BA-VJS-C2):
+     * Render mode:
      *   `solid` (default) — the filled organic blob (the swatch background IS the
      *                       color; the existing register, unchanged).
-     *   `ghost`  — the SAME seeded blob SILHOUETTE rendered as a STROKE: a
-     *              `color` border over a low-alpha `color` fill, the irregular-blob
-     *              outline (NOT a CSS dashed rectangle). A `ghost` of a given
-     *              `color + seed` matches the SAME silhouette the `solid` dot of
-     *              that seed renders — both read the same `useWatercolorBlob`
-     *              border-radius morph; the stroke is the only delta. The
-     *              empty-palette-slot / placeholder affordance.
+     *   `ghost`  — the SAME seeded blob SILHOUETTE traced as a DASHED outline: a
+     *              dashed CSS BORDER reading the SAME seeded `border-radius`
+     *              silhouette the solid dot fills (`activeBorderRadius`), carrying
+     *              the SAME wet `feDisplacementMap` filter so the displacement
+     *              wobbles the dashed border INTO the seeded organic outline. A
+     *              CSS dashed border hugs its own `border-radius`, so the outline
+     *              follows the seeded blob EXACTLY — NOT an ellipse, NOT a circle,
+     *              NOT a dashed rectangle. A low-alpha `color` fill is kept behind
+     *              the border. A `ghost` of a given `color + seed` traces the SAME
+     *              outline the `solid` dot of that seed fills (both read the same
+     *              `useWatercolorBlob` morph — the ONE shape source). The empty-
+     *              palette-slot / placeholder affordance.
      */
     variant?: "solid" | "ghost";
-    /** Run the rAF-driven shape morph (default false → static, hover-morph only). */
+    /** Run the rAF-driven compositor transform wobble (default false → static). */
     animate?: boolean;
     /** Host tag — `div` (decorative) or `button` (interactive). */
     tag?: "div" | "button";
@@ -34,7 +49,7 @@ type __VLS_Props = {
     cycleDuration?: number;
     /** Border-radius range [lo, hi] as percentages (default [20, 80]). */
     range?: [number, number];
-    /** Extra seed string mixed into the shape PRNG for reproducible uniqueness. */
+    /** Extra seed string mixed into the shape + wet-edge PRNG for uniqueness. */
     seed?: string;
 };
 declare var __VLS_11: {};

package/dist/components/custom/watercolor-dot/useWatercolorBlob.d.ts

@@ -1,6 +1,6 @@
 import { type Ref } from "vue";
 export interface UseWatercolorBlobOptions {
-    /** Enable the rAF animation loop. */
+    /** Enable the rAF animation loop (drives a COMPOSITOR transform wobble). */
     animate?: boolean;
     /** Base cycle duration in ms (default 4000). */
     cycleDuration?: number;
@@ -11,14 +11,19 @@ export interface UseWatercolorBlobOptions {
 }
 /**
  * Drives a watercolor dot's organic blob shape. Deterministic given `color + seed`
- * (seeds the PRNG), so the same color reproduces the same shape across mounts. In
- * static mode it emits a base + hover `border-radius`; in `animate` mode it runs an
- * rAF loop morphing each of the 8 radii independently. `nudge()` retargets all
- * vertices for a quick jiggle.
+ * (seeds the PRNG), so the same color reproduces the same shape across mounts. The
+ * seeded `border-radius` silhouette is set ONCE (the dot's identity) and is STATIC —
+ * the box never re-paints its radius per frame (the §H Safari fix: a per-frame
+ * `border-radius` write under the SVG filter forces the filter graph to RE-RASTERIZE
+ * every frame, which flashes Safari). In `animate` mode the liveness rides a seeded
+ * COMPOSITOR `transform` wobble (scale/skew/rotate) the compositor handles WITHOUT
+ * touching the cached filter — the HandMark static-filter idiom. `nudge()` retargets
+ * the wobble for a quick jiggle on hover.
  */
 export declare function useWatercolorBlob(color: Ref<string> | (() => string), options?: UseWatercolorBlobOptions): {
     borderRadius: Ref<string, string>;
     hoverBorderRadius: Ref<string, string>;
+    transform: Ref<string, string>;
     nudge: () => void;
 };
 export type WatercolorBlob = ReturnType<typeof useWatercolorBlob>;

package/dist/components/ui/_shared/index.d.ts

@@ -2,3 +2,5 @@ export { menuItemVariants } from "./menuItemVariants";
 export type { MenuItemVariants } from "./menuItemVariants";
 export { surfaceClass } from "./useSurfaceAxis";
 export type { Surface, SurfaceTier } from "./useSurfaceAxis";
+export { controlSizeClass, switchSizeClass } from "./useControlSize";
+export type { ControlSize } from "./useControlSize";

package/dist/components/ui/_shared/useControlSize.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The shared control-size axis — three rungs, ONE grammar. The meaningful
+ * control-size hierarchy rungs the input register needs (Button's `xs`/icon rungs
+ * are Button-specific — an input has no icon-only register, so they are NOT here).
+ *
+ *   sm      — the quieter/secondary control: the `--control-h-sm` height +
+ *             `--control-text-sm` font (shorter + quieter).
+ *   default — the canonical golden pill: the `--control-h-md` height +
+ *             `--control-text` font (byte-identical to HEAD).
+ *   lg      — the primary/emphatic control: the `--control-h-lg` height with the
+ *             base `--control-text` font (taller, same workhorse weight — matching
+ *             Button's `lg`, where only the height grows).
+ */
+export type ControlSize = "sm" | "default" | "lg";
+/**
+ * Resolve a `ControlSize` to the element-level token-override class string the
+ * `.input-pill` recipe reads. The `default` rung emits NO override (so the recipe
+ * falls back to the cohort `--control-h-md` / `--control-text` — byte-identical to
+ * HEAD); `sm`/`lg` re-point `--control-pill-h` / `--control-pill-text` to the
+ * chosen cohort rung.
+ *
+ *   controlSizeClass()        → ""                                              (golden default)
+ *   controlSizeClass("sm")    → "[--control-pill-h:var(--control-h-sm)] [--control-pill-text:var(--control-text-sm)]"
+ *   controlSizeClass("lg")    → "[--control-pill-h:var(--control-h-lg)]"
+ *
+ * @param size the control-size rung (`default` · `sm` · `lg`)
+ */
+export declare function controlSizeClass(size?: ControlSize): string;
+/**
+ * The Switch geometry rung. A Switch is a control-height-DERIVED geometry (the
+ * track/thumb/throw are NOT the bare cohort height — a switch track is shorter
+ * than an input), so it derives its `--switch-track-h` from the chosen
+ * `--control-h-*` rung (×0.6, the iOS proportion) and the rest of the
+ * `--switch-*` quad follows in Switch.vue:
+ *
+ *   --switch-thumb   = --switch-track-h − 0.25rem   (the 2px×2 track border)
+ *   --switch-track-w = --switch-track-h × 11/6      (the iOS track aspect)
+ *   --switch-throw   = --switch-track-w − --switch-thumb − 0.25rem
+ *
+ * The `default` rung (`--control-h-md`) resolves the HEAD `h-6 w-11` track +
+ * `h-5 w-5` thumb + `translate-x-5` throw EXACTLY (byte-identical). `sm`/`lg`
+ * re-point the anchor `--switch-track-h` so the whole quad scales in lockstep.
+ *
+ * @param size the control-size rung (`default` · `sm` · `lg`)
+ */
+export declare function switchSizeClass(size?: ControlSize): string;

package/dist/components/ui/_shared/useSurfaceAxis.d.ts

@@ -1,5 +1,5 @@
 /**
- * The shared surface-decoration axis — three rungs, ONE grammar.
+ * The shared surface-decoration axis — four rungs, ONE grammar.
  *
  *   glass   — the resolved tier's plain glass rung (default). The translucent
  *             blur surface, the maximal glass-first register.
@@ -11,8 +11,16 @@
  *   opaque  — the `--glass-level:0` solid-card escape: solid `--card` + `blur(0)`
  *             through the ONE level knob. The explicit opt-out from the maximal
  *             glass default.
+ *   clear   — BE.W-CLEAR-VARIANT: the Apple-Clear MAXIMALLY translucent register —
+ *             the `--glass-bg-clear` (0.58) plate, the clearest the library ships
+ *             (the album grid bleeds genuinely through). STRUCTURALLY coupled to a
+ *             MANDATORY `::before` legibility scrim (a near-transparent plate → the
+ *             text needs a scrim floor) whose strength derives from the sampled
+ *             `--glass-backdrop-luma` (it dims MORE over a bright backdrop). A
+ *             scrim-less clear surface is FORBIDDEN — the `.glass-clear` decoration
+ *             class carries the scrim in the SAME rule (the Apple Clear contract).
  */
-export type Surface = "glass" | "veil" | "opaque";
+export type Surface = "glass" | "veil" | "opaque" | "clear";
 /**
  * The 5-rung glass-ladder tier the surface paints its base over. Mirrors the
  * `.glass-{wash,quiet,resting,floating,overlay}` ladder. A surface passes the rung
@@ -34,8 +42,14 @@ export type SurfaceTier = "wash" | "quiet" | "resting" | "floating" | "overlay";
  *   surfaceClass("glass",  "floating") → "glass-floating"
  *   surfaceClass("veil",   "floating") → "glass-floating veil-surface"
  *   surfaceClass("opaque", "floating") → "glass-floating glass-opaque"
+ *   surfaceClass("clear",  "floating") → "glass-floating glass-clear"
  *
- * @param surface the decoration rung (`glass` default · `veil` · `opaque`)
+ * The `glass-clear` decoration class (BE.W-CLEAR-VARIANT) is scrim-COUPLED: its CSS
+ * rule carries the MANDATORY `::before` legibility scrim in the SAME seam, so a
+ * `surface="clear"` surface can NEVER paint the maximally-translucent plate without
+ * the dim — the Apple Clear contract is structural, not opt-out.
+ *
+ * @param surface the decoration rung (`glass` default · `veil` · `opaque` · `clear`)
  * @param tier    the base ladder rung (default `resting`)
  */
 export declare function surfaceClass(surface?: Surface, tier?: SurfaceTier): string;

package/dist/components/ui/badge/Badge.vue.d.ts

@@ -3,6 +3,20 @@ import { type BadgeVariants } from '.';
 type __VLS_Props = {
     variant?: BadgeVariants['variant'];
     size?: BadgeVariants['size'];
+    /**
+     * BD.W-GLASS-ATOM-REGISTER — the register split. `loud` (default) is the opaque
+     * saturated identity pill; `glass` is the quiet transmissive `.glass-atom`
+     * capsule tinted via `--glass-fill-tint`. A status badge stays loud (information,
+     * not a sticker); `secondary`/`outline` placements may route quiet.
+     */
+    surface?: BadgeVariants['surface'];
+    /**
+     * The LOUD cel cast opt-in (BD.W-CARTOON-CASTER). Every badge carries the
+     * family floor (the press-squish + a hairline rim-cast); `cast` INTENSIFIES the
+     * loud layered-offset stamp + mounts the inert `.cartoon-cast` child. A status
+     * pill is information, so the loud stamp is opt-in (not the default).
+     */
+    cast?: boolean;
     class?: HTMLAttributes['class'];
 };
 declare var __VLS_1: {};

package/dist/components/ui/badge/index.d.ts

@@ -3,5 +3,6 @@ export { default as Badge } from './Badge.vue';
 export declare const badgeVariants: (props?: ({
     variant?: "default" | "outline" | "destructive" | "secondary" | "success" | "warning" | "info" | null | undefined;
     size?: "sm" | "lg" | "md" | null | undefined;
+    surface?: "glass" | "loud" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type BadgeVariants = VariantProps<typeof badgeVariants>;

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

@@ -8,6 +8,7 @@ interface Props extends PrimitiveProps {
     class?: HTMLAttributes['class'];
     surface?: Surface;
     liquid?: boolean;
+    punch?: boolean;
     type?: ButtonHTMLAttributes['type'];
     disabled?: ButtonHTMLAttributes['disabled'];
 }

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

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

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

@@ -51,6 +51,23 @@ export type CardSurface = "glass" | "cartoon" | "veil";
  *            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`/`pressable` (a `variant="selection" surface="glass"
+ * tier="resting" pressable` card is valid). The hue is a CONSUMER value
+ * (`data-hue`/`data-hue-strength` per-instance); NO consumer hue enters a token.
+ */
+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;
@@ -97,6 +114,33 @@ interface Props extends PrimitiveProps {
      *  compositor-only (`scale` + a custom property); the `.glass-press` CSS `:active`
      *  scale is the no-JS / SSR floor. */
     pressable?: boolean;
+    /** 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`/`pressable`. */
+    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. */
+    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_13: {};
@@ -105,13 +149,14 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     shadow: boolean;
+    tier: CardTier;
     grid: boolean;
     surface: CardSurface;
     as: import("reka-ui").AsTag | import("vue").Component;
-    tier: CardTier;
     grain: boolean;
     specular: CardSpecular;
     pressable: boolean;
+    metal: CardMetal;
 }, {}, {}, {}, 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/ui/card/ScrollCard.vue.d.ts

@@ -19,9 +19,9 @@ declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<ScrollCardProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ScrollCardProps> & Readonly<{}>, {
     shadow: boolean;
+    tier: CardTier;
     maxHeight: string;
     surface: CardSurface;
-    tier: CardTier;
     specular: CardSpecular;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     default?: (props: {}) => any;

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

@@ -1,4 +1,4 @@
-export { default as Card, type CardTier, type CardSurface, type CardSpecular, } from "./Card.vue";
+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";

package/dist/components/ui/carousel/CarouselContent.vue.d.ts

@@ -1,11 +1,9 @@
-import type { WithClassAsProps } from './interface';
+import type { WithClassAsProps } from "./interface";
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<WithClassAsProps, {
-    carouselRef: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<WithClassAsProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<WithClassAsProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<WithClassAsProps> & Readonly<{}>, {}, {}, {}, {}, 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/ui/carousel/CarouselNext.vue.d.ts

@@ -10,7 +10,7 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     size: "default" | "icon" | "xs" | "sm" | "lg" | "icon-sm" | null;
-    variant: "link" | "default" | "glass" | "outline" | "solid" | "primary-audacious" | "gold-audacious" | "destructive" | "secondary" | "accent" | "ghost" | "glass-wash" | "ai" | null;
+    variant: "link" | "default" | "glass" | "outline" | "primary-audacious" | "gold-audacious" | "destructive" | "secondary" | "accent" | "ghost" | "glass-wash" | "ai" | null;
 }, {}, {}, {}, 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/ui/carousel/CarouselPrevious.vue.d.ts

@@ -10,7 +10,7 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     size: "default" | "icon" | "xs" | "sm" | "lg" | "icon-sm" | null;
-    variant: "link" | "default" | "glass" | "outline" | "solid" | "primary-audacious" | "gold-audacious" | "destructive" | "secondary" | "accent" | "ghost" | "glass-wash" | "ai" | null;
+    variant: "link" | "default" | "glass" | "outline" | "primary-audacious" | "gold-audacious" | "destructive" | "secondary" | "accent" | "ghost" | "glass-wash" | "ai" | null;
 }, {}, {}, {}, 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/ui/command/CommandDialog.vue.d.ts

@@ -1,13 +1,19 @@
 import type { DialogRootProps } from 'reka-ui';
+import type { Surface } from '../_shared/useSurfaceAxis';
+type __VLS_Props = DialogRootProps & {
+    surface?: Surface;
+};
 declare var __VLS_20: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_20) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<DialogRootProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
-}, string, import("vue").PublicProps, Readonly<DialogRootProps> & Readonly<{
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}>, {
+    surface: Surface;
+}, {}, {}, {}, 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/ui/command/CommandList.vue.d.ts

@@ -1,7 +1,9 @@
 import { type HTMLAttributes } from 'vue';
 import type { ComboboxContentProps } from 'reka-ui';
+import { type Surface } from '../_shared/useSurfaceAxis';
 type __VLS_Props = ComboboxContentProps & {
     class?: HTMLAttributes['class'];
+    surface?: Surface;
 };
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
@@ -18,6 +20,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onFocusOutside?: ((event: import("reka-ui").FocusOutsideEvent) => any) | undefined;
     onInteractOutside?: ((event: import("reka-ui").PointerDownOutsideEvent | import("reka-ui").FocusOutsideEvent) => any) | undefined;
 }>, {
+    surface: Surface;
     disableOutsidePointerEvents: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/ui/context-menu/ContextMenuContent.vue.d.ts

@@ -1,7 +1,9 @@
 import { type HTMLAttributes } from 'vue';
 import { type ContextMenuContentProps } from 'reka-ui';
+import { type Surface } from '../_shared/useSurfaceAxis';
 type __VLS_Props = ContextMenuContentProps & {
     class?: HTMLAttributes['class'];
+    surface?: Surface;
 };
 declare var __VLS_14: {};
 type __VLS_Slots = {} & {
@@ -19,7 +21,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onFocusOutside?: ((event: import("reka-ui").FocusOutsideEvent) => any) | undefined;
     onInteractOutside?: ((event: import("reka-ui").PointerDownOutsideEvent | import("reka-ui").FocusOutsideEvent) => any) | undefined;
     onCloseAutoFocus?: ((event: Event) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}>, {
+    surface: Surface;
+}, {}, {}, {}, 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/ui/dialog/DialogContent.vue.d.ts

@@ -51,6 +51,14 @@ type __VLS_Props = DialogContentProps & {
      * double-up. The default keeps every existing mount byte-identical.
      */
     showClose?: boolean;
+    /**
+     * BD.W-OVERLAY-STAGE-COUPLE — the scene-staging enum for the centered modal band.
+     * `none` (default — byte-identical to HEAD) leaves the page untouched; `dim`/
+     * `scale`/`immersive` flip the ONE `--stage-t` scalar 0→1 on open so the page
+     * RECEDES + SCALES behind the dialog (the iOS card-recede) and the scrim deepens.
+     * PRM degrades `scale`/`immersive` → `dim` (no page transform, fold C1·R6).
+     */
+    stage?: 'none' | 'dim' | 'scale' | 'immersive';
 };
 declare var __VLS_19: {};
 type __VLS_Slots = {} & {
@@ -73,6 +81,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
 }>, {
     surface: Surface;
     showClose: boolean;
+    stage: "none" | "dim" | "scale" | "immersive";
 }, {}, {}, {}, 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/ui/drawer/Drawer.vue.d.ts

@@ -1,4 +1,4 @@
-import type { DrawerDirection, DrawerMode } from './index';
+import type { DrawerDirection, DrawerMode, DrawerStage } from './index';
 /**
  * BB.W-DRAWER-ABROGATE — the Drawer root on the HOUSE reka `DialogRoot` substrate
  * (the SAME shape `Dialog.vue` binds). vaul-vue is gone: reka owns the open-control,
@@ -7,17 +7,31 @@ import type { DrawerDirection, DrawerMode } from './index';
  * owns the snap math vaul used to own.
  *
  * `mode` — additive shorthand (AN.W3). `"modal"` (default) keeps the iOS scale-down
- * look: `modal: true` (reka focus-traps + page-occludes). `"live-behind"` is the
- * non-modal peek/half/full bottom sheet — `modal: false` (no focus trap, no page
- * `aria-hidden`, page-behind stays interactive — reka delivers this natively),
- * `shouldScaleBackground: false`, and the direction-derived snap ladder. Every prop
- * the mode sets is still overridable by an explicit prop — `mode` only supplies
- * defaults.
+ * look: `modal: true` (reka focus-traps + page-occludes) + `stage: "scale"` (the page
+ * recedes). `"live-behind"` is the non-modal peek/half/full bottom sheet — `modal:
+ * false` (no focus trap, no page `aria-hidden`, page-behind stays interactive — reka
+ * delivers this natively), `stage: "none"`, and the direction-derived snap ladder.
+ * Every prop the mode sets is still overridable by an explicit prop — `mode` only
+ * supplies defaults.
  *
- * The snap props (`snapPoints`/`activeSnapPoint`/`direction`/`shouldScaleBackground`)
- * are HOUSE props now (they were vaul's `DrawerRootProps` surface — preserved by
- * shape so the consumer binding is byte-identical, but resolved by the house engine,
- * not forwarded to reka, which knows only `open`/`defaultOpen`/`modal`).
+ * The snap props (`snapPoints`/`activeSnapPoint`/`direction`) are HOUSE props now
+ * (they were vaul's `DrawerRootProps` surface — preserved by shape so the consumer
+ * binding is byte-identical, but resolved by the house engine, not forwarded to reka,
+ * which knows only `open`/`defaultOpen`/`modal`).
+ *
+ * BD.W-OVERLAY-STAGE-COUPLE — `stage` is the honest scene-staging enum that RETIRES
+ * the dead `shouldScaleBackground` boolean (clean break, no alias — the old boolean
+ * was read by NOTHING, `#app transform: none` at every detent):
+ *   • `none`      — no staging (the live-behind peek sheet leaves the page untouched).
+ *   • `dim`       — the scrim deepens with the detent; the page does NOT transform
+ *                   (the PRM-safe luminance-only depth cue; also the `scale` degrade).
+ *   • `scale`     — `dim` + the page RECEDES + SCALES (the iOS card-recede depth cue).
+ *   • `immersive` — `scale` + the scrim's backdrop-blur ENGAGES (the spotlight).
+ * Under `prefers-reduced-motion: reduce`, `scale`/`immersive` degrade to `dim` (no
+ * page transform — a full-page snap-scale IS perceived motion, fold C1·R6). The enum
+ * toggles `data-stage-scale` / `data-stage-immersive` on the page-wrapper marker
+ * (`[data-stage-wrapper]`, mounted by the consumer/demo shell) while the sheet is
+ * open; the `--stage-t` scalar the snap engine writes at `:root` drives the couplings.
  */
 type __VLS_Props = {
     /** The controlled open state (`v-model:open`). */
@@ -34,8 +48,13 @@ type __VLS_Props = {
     activeSnapPoint?: number | string | null;
     /** Drag/slide axis (BB-2 default-ladder source). */
     direction?: DrawerDirection;
-    /** iOS page scale-down on open (the modal look). Defaulted by `mode`. */
-    shouldScaleBackground?: boolean;
+    /**
+     * BD.W-OVERLAY-STAGE-COUPLE — the scene-staging enum (retires the dead
+     * `shouldScaleBackground`). `none` leaves the page untouched (the live-behind
+     * default); `dim` deepens the scrim only; `scale` recedes + scales the page;
+     * `immersive` adds the backdrop-blur engage. Defaulted by `mode`.
+     */
+    stage?: DrawerStage;
 };
 declare var __VLS_10: {};
 type __VLS_Slots = {} & {
@@ -53,9 +72,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     mode: DrawerMode;
     defaultOpen: boolean;
     modal: boolean;
+    stage: DrawerStage;
     snapPoints: (number | string)[];
     activeSnapPoint: number | string | null;
-    shouldScaleBackground: 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/ui/drawer/constants.d.ts

@@ -8,14 +8,16 @@ import type { DrawerDirection } from "./index";
  * give than the dock's crisp 0.32/0.7 box-morph). Co-located here so the pair is
  * defined ONCE rather than at the top of the composable.
  *
- * `response 0.4` — the angular period (≈ the swing time); a hair looser than the
- * dock so the sheet reads as a heavier surface settling. `dampingFraction 0.82` —
- * the iOS "smooth" register: sub-perceptual overshoot (a settled sheet, not a
- * bouncing one) while staying alive on a flung release.
+ * BD.W-ANIM-IOS27-TUNE — re-tuned `{0.4, 0.82}` → `{0.50, 0.74}` so the sheet-grow
+ * reads as inertial liquid MASS (the Maps-card reference): `response 0.50` lengthens
+ * the settle ~+25% (the flowing-heavy arrival) and `dampingFraction 0.74` adds a small
+ * ~3.2% liquid overshoot (vs the prior near-critical 0%) — the sheet settles cleanly to
+ * its detent WITHOUT over-shooting past the viewport (ζ ≥ 0.72 keeps overshoot ≤ ~4%).
+ * The fling-decision (`DRAWER_FLING_VELOCITY`) is SEPARATE + unchanged.
  */
 export declare const DRAWER_SNAP: {
-    readonly response: 0.4;
-    readonly dampingFraction: 0.82;
+    readonly response: 0.5;
+    readonly dampingFraction: 0.74;
 };
 /**
  * BB-2 (the direction-aware default snap ladder fold) — the peek/half/full detent

package/dist/components/ui/drawer/index.d.ts

@@ -12,10 +12,20 @@ export type DrawerDirection = "top" | "bottom" | "left" | "right";
  * focus-trapped (reka `:modal="true"`), page-behind scaled. `"live-behind"` is the
  * non-modal peek/half/full bottom sheet — reka `:modal="false"` (no focus trap, no
  * page `aria-hidden`, page-behind at native size + interactive) — bundling the
- * `modal:false` + `shouldScaleBackground:false` + the direction-derived snap ladder.
- * Explicit props still override the mode's defaults.
+ * `modal:false` + `stage:"none"` + the direction-derived snap ladder. Explicit props
+ * still override the mode's defaults.
  */
 export type DrawerMode = "modal" | "live-behind";
+/**
+ * BD.W-OVERLAY-STAGE-COUPLE — the scene-staging enum (retires the dead
+ * `shouldScaleBackground` boolean, clean break). `none` leaves the page untouched;
+ * `dim` deepens the scrim only (the PRM-safe luminance depth cue); `scale` recedes +
+ * scales the page (the iOS card-recede); `immersive` adds the backdrop-blur engage.
+ * `modal` defaults to `scale`; `live-behind` to `none`. PRM degrades `scale`/
+ * `immersive` to `dim`. All four couplings ride the ONE `--stage-t` scalar the snap
+ * engine writes at `:root`.
+ */
+export type DrawerStage = "none" | "dim" | "scale" | "immersive";
 export { default as Drawer } from "./Drawer.vue";
 export { default as DrawerOverlay } from "./DrawerOverlay.vue";
 export { default as DrawerContent } from "./DrawerContent.vue";

package/dist/components/ui/dropdown-menu/DropdownMenuContent.vue.d.ts

@@ -1,7 +1,9 @@
 import { type HTMLAttributes } from 'vue';
 import { type DropdownMenuContentProps } from 'reka-ui';
+import { type Surface } from '../_shared/useSurfaceAxis';
 type __VLS_Props = DropdownMenuContentProps & {
     class?: HTMLAttributes['class'];
+    surface?: Surface;
 };
 declare var __VLS_14: {};
 type __VLS_Slots = {} & {
@@ -20,6 +22,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onInteractOutside?: ((event: import("reka-ui").PointerDownOutsideEvent | import("reka-ui").FocusOutsideEvent) => any) | undefined;
     onCloseAutoFocus?: ((event: Event) => any) | undefined;
 }>, {
+    align: "start" | "center" | "end";
+    surface: Surface;
     sideOffset: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;