@mkbabb/glass-ui 3.13.0 → 4.0.1

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

@@ -11,8 +11,13 @@ import { type PrimitiveProps } from "reka-ui";
  *   overlay  — heaviest (~0.95α + blur) : modal-on-modal, dialog over content
  *   opaque   — `--glass-level:0` escape : the solid-card opt-out (AX.W54), maps to
  *              `.glass-opaque` through the same `glass-${tier}` rung as the rest
+ *   deep     — `--glass-blur-deep-*` OPT-IN : the maximal iOS-27 Liquid-Glass tier
+ *              ABOVE the W-GLASS-CAL calm default (Apple saturate-1.5/blur-16px),
+ *              maps to `.glass-floating glass-deep` (a base rung + the deep
+ *              decoration, mirroring opaque) — the hero glass / CTA register
+ *              (BB.W-DEEP-GLASS). The calm content default is byte-unchanged.
  */
-export type CardTier = "wash" | "quiet" | "resting" | "floating" | "overlay" | "opaque";
+export type CardTier = "wash" | "quiet" | "resting" | "floating" | "overlay" | "opaque" | "deep";
 /**
  * Surface decoration register — orthogonal to `tier`/`shadow`/`grain`.
  *
@@ -62,6 +67,15 @@ interface Props extends PrimitiveProps {
     /** `::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
@@ -69,19 +83,35 @@ interface Props extends PrimitiveProps {
      *  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;
+    /** BB.W-PRESS-UNIFY — the interactive PRESS register, default **OFF**. A bare
+     *  Card is a static content PLATE and never presses (a press on a static surface
+     *  is the visual-load-bearing anti-pattern). A `:pressable` Card is a TAPPABLE
+     *  LIST-CARD (a selectable result row, a navigable tile) — it gains the ONE
+     *  interruptible coupled spring-press (`useLiquidPress`): the reciprocal X/Y squish
+     *  + a sub-perceptual brightness lift on the `--card-press-t` drive, on the
+     *  `--spring-snappy`-class clock, INTERRUPTIBLE (a rapid re-tap re-seats the spring
+     *  velocity-continuously), PRM-instant (the press snaps with zero in-between
+     *  frames). Card is the SECOND binary the dead `useSpringPress` primitive reaches
+     *  (Button is the first — direct; Card via `useLiquidPress` which composes it — the
+     *  J-inv-10 ≥2-consumer bar met; the dock control is the booked third). The press is
+     *  compositor-only (`scale` + a custom property); the `.glass-press` CSS `:active`
+     *  scale is the no-JS / SSR floor. */
+    pressable?: boolean;
     class?: HTMLAttributes["class"];
 }
-declare var __VLS_10: {};
+declare var __VLS_13: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_10) => any;
+    default?: (props: typeof __VLS_13) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     shadow: boolean;
+    grid: boolean;
+    surface: CardSurface;
     as: import("reka-ui").AsTag | import("vue").Component;
     tier: CardTier;
-    surface: CardSurface;
     grain: boolean;
     specular: CardSpecular;
+    pressable: 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/card/CardHeader.vue.d.ts

@@ -5,30 +5,56 @@ import type { HTMLAttributes } from 'vue';
  * 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) and runs a
- * 3-lane choreography as the host scrolls:
+ * 3-lane choreography as the host scrolls. The 3 lanes are now
+ * COMPOSITOR-SAFE (transform/opacity only — BB.W-CARD-COMPOSITE) so ZERO
+ * reflow fires per scroll frame (the A'-3 CLS 1.03 worst-cluster killed):
  *
- *   1. Header padding shrink (0..120px scroll range) — top/bottom padding
- *      collapses from 1rem/0.5rem to 0.5rem/0.25rem.
- *   2. Title font-size shrink (0..120px) — `[data-slot="card-title"]`
- *      glyph scales from `--type-heading` down to `--type-prose`.
- *   3. Description grid-row collapse (0..80px, faster fade) —
- *      `[data-slot="card-description"]` collapses its 1fr → 0fr grid
- *      row while fading opacity → 0; the slot retires entirely past the
- *      80px boundary, freeing vertical real estate for the body.
+ *   1. Header content compress (0..120px scroll range) — the header content
+ *      slides up via `transform: translateY` as the host scrolls so the top
+ *      breathing room visually compresses; the header box keeps its layout
+ *      size (no padding reflow). The visual gestalt — ~0.5rem of top space
+ *      collapses — reads identically.
+ *   2. Title shrink (0..120px) — `[data-slot="card-title"]` scales DOWN via
+ *      `transform: scale(--card-title-shrink-ratio)` (origin: leading edge),
+ *      so the glyph visually shrinks from `--type-heading` to roughly
+ *      `--type-prose` while the text run lays out ONCE (no per-frame
+ *      `font-size` text re-measure — the worst reflow lane, killed).
+ *   3. Description retire (0..80px, faster fade) —
+ *      `[data-slot="card-description"]` fades `opacity: 1 → 0` AND collapses
+ *      `transform: scaleY(1 → 0)` (origin: top) so the slot visually retires
+ *      upward; the real-estate reclaim is the composited scaleY, NOT a
+ *      `grid-template-rows` relayout.
+ *   4. Header background lift (0..120px — BB.W-SCROLL-CARD) — a `::before`
+ *      BACKPLATE carrying the `--card-header-bg` tint fades `opacity: 0 → 1`
+ *      on the same timeline, so a stuck header reads transparent over the
+ *      body at scroll-top and lifts to the painted tint as it sticks. The
+ *      opacity channel keeps the lift compositor-safe.
  *
- * The choreography migrates verbatim from value.js's `PaneHeader.vue`
- * (the load-bearing pane-scroll-fade pattern that ran across the 9 panes)
- * — same `--card-scroll` timeline, same `0..120px` / `0..80px` ranges,
- * same animation keyframes (renamed `pane-*` → `card-*`).
+ * BB.W-SCROLL-CARD — the two text lanes (2 + 3) re-target via `:slotted()`
+ * (the precise Vue scoped-CSS slotted-content selector, the MetricRow.vue
+ * idiom) so they MATCH a consumer-SLOTTED <CardTitle>/<CardDescription>; the
+ * prior `:deep()` enabler was the W-CARD-COMPOSITE minimal stopgap, replaced
+ * here by the precise tool (no descendant-leak sledgehammer).
+ *
+ * The choreography ORIGINALLY migrated verbatim from value.js's
+ * `PaneHeader.vue`, which animated LAYOUT properties (padding/font-size/
+ * grid-template-rows/margin) — a per-scroll-frame reflow storm (CLS 1.03,
+ * the A'-3 P0 that shipped at 4.0.0). BB.W-CARD-COMPOSITE re-expresses each
+ * lane as the compositor-transform equivalent the house already speaks
+ * (the `scroll-driven.css` scaleX/translateY/opacity idiom) — the visual
+ * choreography is IDENTICAL; only the mechanism changed. The
+ * `proof:no-layout-animation` gate makes the layout-property class
+ * structurally impossible to re-ship.
  *
  * **Required ancestor**: when `shrink` is true, `.card-scroll-host` MUST
  * sit on the scroll-overflow ancestor (typically the same `<Card>` host's
  * scroll wrapper). Without that host the named timeline never emits and
  * the choreography sits idle. Documented in DESIGN.md `## Card` section.
  *
- * Sticky positioning + background tint stay consumer-side (the consumer
- * adds `class="sticky top-0 backdrop-blur-md"` etc. via `props.class`);
- * `--card-header-bg` is the canonical tint token for that backdrop.
+ * Sticky positioning stays consumer-side (the consumer adds
+ * `class="sticky top-0 backdrop-blur-md"` etc. via `props.class`); the
+ * background TINT is now scroll-driven by lane 4 (the `::before` backplate),
+ * reading `--card-header-bg` as the canonical tint token.
  */
 type __VLS_Props = {
     /**

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

@@ -0,0 +1,33 @@
+import type { HTMLAttributes } from "vue";
+import type { CardTier, CardSurface, CardSpecular } from "./Card.vue";
+/** Props for `<ScrollCard>` — the first-class scroll-shrink card. */
+export interface ScrollCardProps {
+    /** Card surface tier — forwarded to the inner `<Card>`. Default `resting`. */
+    tier?: CardTier;
+    /** Surface decoration register — forwarded to `<Card>`. Default `glass`. */
+    surface?: CardSurface;
+    /** Surface drop shadow — forwarded to `<Card>`. Default `true`. */
+    shadow?: boolean;
+    /** Specular catch-light — forwarded to `<Card>`. Default `off`. */
+    specular?: CardSpecular;
+    /** Max scroll-port height. The scroll region needs a bounded height for
+     *  the `--card-scroll` timeline to have a scroll range. Default `18rem`. */
+    maxHeight?: string;
+    class?: HTMLAttributes["class"];
+}
+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;
+    maxHeight: string;
+    surface: CardSurface;
+    tier: CardTier;
+    specular: CardSpecular;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,17 @@
+import type { HTMLAttributes } from "vue";
+/** Props for `<ScrollCardHeader>` — the larger-header-items scroll-shrink header. */
+export interface ScrollCardHeaderProps {
+    /** A consumer that wants the header NOT pinned passes `:sticky="false"`. */
+    sticky?: boolean;
+    class?: HTMLAttributes["class"];
+}
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<ScrollCardHeaderProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ScrollCardHeaderProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

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

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

@@ -9,8 +9,8 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_10) => any;
 };
 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" | "xs" | "sm" | "lg" | "icon" | "icon-sm" | null;
-    variant: "link" | "default" | "solid" | "primary-audacious" | "gold-audacious" | "destructive" | "outline" | "secondary" | "accent" | "ghost" | "glass" | "glass-wash" | "ai" | null;
+    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;
 }, {}, {}, {}, 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

@@ -9,8 +9,8 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_10) => any;
 };
 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" | "xs" | "sm" | "lg" | "icon" | "icon-sm" | null;
-    variant: "link" | "default" | "solid" | "primary-audacious" | "gold-audacious" | "destructive" | "outline" | "secondary" | "accent" | "ghost" | "glass" | "glass-wash" | "ai" | null;
+    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;
 }, {}, {}, {}, 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/GlassCarouselPager.vue.d.ts

@@ -29,12 +29,12 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     select: (index: number) => any;
-    prev: () => any;
     next: () => any;
+    prev: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelect?: ((index: number) => any) | undefined;
-    onPrev?: (() => any) | undefined;
     onNext?: (() => any) | undefined;
+    onPrev?: (() => any) | undefined;
 }>, {
     loop: boolean;
     orientation: "horizontal" | "vertical";

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

@@ -1,6 +1,5 @@
 export { default as Carousel } from './Carousel.vue';
 export { default as CarouselContent } from './CarouselContent.vue';
-export { default as CarouselDots } from './CarouselDots.vue';
 export { default as CarouselItem } from './CarouselItem.vue';
 export { default as CarouselNext } from './CarouselNext.vue';
 export { default as CarouselPager } from './CarouselPager.vue';

package/dist/components/ui/command/Command.vue.d.ts

@@ -1,7 +1,9 @@
 import { type HTMLAttributes } from 'vue';
 import type { ComboboxRootProps } from 'reka-ui';
+import { type Surface } from '../_shared/useSurfaceAxis';
 type __VLS_Props = ComboboxRootProps & {
     class?: HTMLAttributes['class'];
+    surface?: Surface;
 };
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
@@ -22,8 +24,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     } | undefined) => any) | undefined;
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {
-    modelValue: import("reka-ui").AcceptableValue | import("reka-ui").AcceptableValue[];
     open: boolean;
+    surface: Surface;
+    modelValue: import("reka-ui").AcceptableValue | import("reka-ui").AcceptableValue[];
 }, {}, {}, {}, 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/dialog/DialogContent.vue.d.ts

@@ -1,10 +1,15 @@
 import { type HTMLAttributes } from 'vue';
 import { type DialogContentProps } from 'reka-ui';
 import { type SpringPreset } from '../../../composables/motion/useSpringMount';
+import { type Surface } from '../_shared/useSurfaceAxis';
 type __VLS_Props = DialogContentProps & {
     class?: HTMLAttributes['class'];
-    /** Visual variant: "glass" (translucent blur, default) or "opaque" (solid background). */
-    variant?: 'glass' | 'opaque';
+    /** Surface decoration register (BA.W-SURFACE-AXIS) — the SHARED
+     *  {glass·veil·opaque} axis. `glass` (translucent blur, default) renders the
+     *  floating glass tier; `veil` overlays the borderless/rimless text-legibility
+     *  plate; `opaque` sets `--glass-level:0` (the solid-card escape). Replaces the
+     *  retired binary `variant: glass|opaque` (clean break). */
+    surface?: Surface;
     /**
      * Optional CSS `animation` shorthand forwarded to the portaled scrim
      * via the `--scrim-animation` typed cascade variable. reka-ui's
@@ -66,7 +71,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onOpenAutoFocus?: ((event: Event) => any) | undefined;
     onCloseAutoFocus?: ((event: Event) => any) | undefined;
 }>, {
-    variant: "glass" | "opaque";
+    surface: Surface;
     showClose: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/ui/drawer/Drawer.vue.d.ts

@@ -1,48 +1,61 @@
-import type { DrawerRootProps } from 'vaul-vue';
-import type { DrawerMode } from './index';
+import type { DrawerDirection, DrawerMode } from './index';
 /**
- * `mode` — additive shorthand (AN.W3). `"modal"` (default) keeps the iOS
- * scale-down look: `shouldScaleBackground: true`, `modal: true`. `"live-behind"`
- * bundles the non-modal peek/half/full bottom-sheet contract — `modal: false`
- * (no focus trap, no page `aria-hidden`, page-behind stays interactive),
- * `shouldScaleBackground: false` (page-behind stays at native size), and the
- * default `snapPoints: [0.12, 0.5, 1]` detent ladder. Every prop the mode sets
- * is still overridable by an explicit prop — `mode` only supplies defaults.
+ * 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,
+ * the portal, the focus management (trap when `modal`, free when `live-behind`) and
+ * the scrim; the house `useDrawerSnap` engine (provided here, bound in DrawerContent)
+ * owns the snap math vaul used to own.
  *
- * NOTE: we do NOT route through `useForwardPropsEmits` here. That helper
- * reflects only props the parent vnode actually passed (plus component-declared
- * defaults), so the values our `resolved` computed derives for keys the consumer
- * did NOT pass (e.g. `modal:false` under `mode="live-behind"`) would be dropped.
- * Binding `resolved` directly + merging emit-as-props is the correct shape for a
- * computed-default wrapper.
+ * `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.
+ *
+ * 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`).
  */
-type __VLS_Props = DrawerRootProps & {
+type __VLS_Props = {
+    /** The controlled open state (`v-model:open`). */
+    open?: boolean;
+    /** Initial open state for the uncontrolled case. */
+    defaultOpen?: boolean;
+    /** reka modality — defaulted by `mode`; an explicit value overrides. */
+    modal?: boolean;
+    /** Presentation mode shorthand. */
     mode?: DrawerMode;
+    /** The detent ladder (fractions 0..1). When omitted, resolved from `direction` (BB-2). */
+    snapPoints?: (number | string)[];
+    /** The active detent fraction (`v-model:active-snap-point`). */
+    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;
 };
-declare var __VLS_8: {};
+declare var __VLS_10: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
+    default?: (props: typeof __VLS_10) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    "update:open": (open: boolean) => any;
-    close: () => any;
-    drag: (percentageDragged: number) => any;
-    animationEnd: (open: boolean) => any;
-    release: (open: boolean) => any;
-    "update:activeSnapPoint": (val: string | number) => any;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+    "update:activeSnapPoint": (value: string | number | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:open"?: ((open: boolean) => any) | undefined;
-    onClose?: (() => any) | undefined;
-    onDrag?: ((percentageDragged: number) => any) | undefined;
-    onAnimationEnd?: ((open: boolean) => any) | undefined;
-    onRelease?: ((open: boolean) => any) | undefined;
-    "onUpdate:activeSnapPoint"?: ((val: string | number) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    "onUpdate:activeSnapPoint"?: ((value: string | number | null) => any) | undefined;
 }>, {
-    mode: DrawerMode;
+    direction: DrawerDirection;
     open: boolean;
+    mode: DrawerMode;
+    defaultOpen: boolean;
     modal: boolean;
-    shouldScaleBackground: boolean;
     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/DrawerContent.vue.d.ts

@@ -1,16 +1,19 @@
-import type { DialogContentProps } from 'reka-ui';
-import type { HtmlHTMLAttributes } from 'vue';
+import { type HtmlHTMLAttributes } from 'vue';
+import { type DialogContentProps } from 'reka-ui';
+import { type Surface } from '../_shared/useSurfaceAxis';
 /**
- * `showOverlay` — render the scrim (AN.W3). Defaults `true` for the modal
- * sheet. The live-behind pattern (`<Drawer mode="live-behind">`) passes
- * `:show-overlay="false"` so the page-behind stays visible AND interactive;
- * vaul-vue's `modal:false` already drops `disableOutsidePointerEvents`, but a
- * painted scrim would still visually occlude the live verdict, so the overlay
- * is opt-out at the content level.
+ * `showOverlay` — render the scrim (AN.W3). Defaults `true` for the modal sheet. The
+ * live-behind pattern (`<Drawer mode="live-behind">`) passes `:show-overlay="false"`
+ * so the page-behind stays visible AND interactive; reka's `:modal="false"` already
+ * drops outside-pointer-capture + the focus trap, but a painted scrim would still
+ * visually occlude the live surface, so the overlay is opt-out at the content level.
  */
 type __VLS_Props = DialogContentProps & {
     class?: HtmlHTMLAttributes['class'];
     showOverlay?: boolean;
+    /** Surface decoration register (BA.W-SURFACE-AXIS) — the SHARED
+     *  {glass·veil·opaque} axis on top of the `.glass-drawer` recipe. */
+    surface?: Surface;
 };
 declare var __VLS_19: {};
 type __VLS_Slots = {} & {
@@ -31,6 +34,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onOpenAutoFocus?: ((event: Event) => any) | undefined;
     onCloseAutoFocus?: ((event: Event) => any) | undefined;
 }>, {
+    surface: Surface;
     showOverlay: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/ui/drawer/DrawerDescription.vue.d.ts

@@ -1,6 +1,6 @@
-import type { DrawerDescriptionProps } from 'vaul-vue';
+import { type DialogDescriptionProps } from 'reka-ui';
 import { type HtmlHTMLAttributes } from 'vue';
-type __VLS_Props = DrawerDescriptionProps & {
+type __VLS_Props = DialogDescriptionProps & {
     class?: HtmlHTMLAttributes['class'];
 };
 declare var __VLS_8: {};

package/dist/components/ui/drawer/DrawerOverlay.vue.d.ts

@@ -1,4 +1,4 @@
-import type { DialogOverlayProps } from 'reka-ui';
+import { type DialogOverlayProps } from 'reka-ui';
 import { type HtmlHTMLAttributes } from 'vue';
 type __VLS_Props = DialogOverlayProps & {
     class?: HtmlHTMLAttributes['class'];

package/dist/components/ui/drawer/DrawerTitle.vue.d.ts

@@ -1,6 +1,6 @@
-import type { DrawerTitleProps } from 'vaul-vue';
+import { type DialogTitleProps } from 'reka-ui';
 import { type HtmlHTMLAttributes } from 'vue';
-type __VLS_Props = DrawerTitleProps & {
+type __VLS_Props = DialogTitleProps & {
     class?: HtmlHTMLAttributes['class'];
 };
 declare var __VLS_8: {};

package/dist/components/ui/drawer/composables/drawerSnapContext.d.ts

@@ -0,0 +1,26 @@
+import type { Ref } from "vue";
+import type { DrawerDirection } from "../index";
+/**
+ * The snap seam the root provides + the content consumes. The root resolves the
+ * effective ladder (consumer `snapPoints` ?? the direction-derived default) + the
+ * direction; the content binds the drag gesture against it. The read-only refs
+ * (`snapPoints`/`direction`) are root-derived computeds; `open`/`activeSnapPoint`
+ * are writable so the engine round-trips the open-control + the snap-fraction.
+ */
+export interface DrawerSnapContext {
+    /** The drawer's open state (mirrors the reka root's `v-model:open`). */
+    open: Ref<boolean>;
+    /** The resolved detent ladder (fractions 0..1; empty = full-slide side-lens). */
+    snapPoints: Readonly<Ref<readonly number[]>>;
+    /** The drag/slide axis. */
+    direction: Readonly<Ref<DrawerDirection>>;
+    /** The live active detent fraction (the `v-model:active-snap-point` writeback). */
+    activeSnapPoint: Ref<number | string | null>;
+}
+export declare const DRAWER_SNAP_KEY: import("vue").InjectionKey<DrawerSnapContext>;
+export declare function provideDrawerSnapContext(context: DrawerSnapContext): void;
+/**
+ * Befitting-silent — returns `null` for a `<DrawerContent>` rendered outside a
+ * `<Drawer>` (a misuse the optional context renders bare for, rather than throwing).
+ */
+export declare const useOptionalDrawerSnapContext: () => DrawerSnapContext | null;

package/dist/components/ui/drawer/composables/useDrawerSnap.d.ts

@@ -0,0 +1,17 @@
+import { type Ref } from "vue";
+import type { DrawerSnapContext } from "./drawerSnapContext";
+export interface UseDrawerSnapOptions {
+    /** The content sheet element (the `--glass-drawer-t` host + the drag bound box). */
+    contentEl: Ref<HTMLElement | null>;
+    /** The handle element (the grip the user drags to cycle detents). */
+    handleEl: Ref<HTMLElement | null>;
+    /** The provided snap seam (the ladder, open ref, direction, snap-fraction writeback). */
+    ctx: DrawerSnapContext;
+}
+export interface UseDrawerSnapReturn {
+    /** Whether a pointer drag is in flight (drives the grip's "live" affordance). */
+    dragging: Ref<boolean>;
+    /** Programmatically settle to a detent fraction (the open-sheet re-snap seam). */
+    snapTo(fraction: number): void;
+}
+export declare function useDrawerSnap(options: UseDrawerSnapOptions): UseDrawerSnapReturn;

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

@@ -0,0 +1,45 @@
+import type { DrawerDirection } from "./index";
+/**
+ * The ONE drawer-snap spring authority — the sheet-settle (response, ζ) register the
+ * house `SpringProgress` snap engine (`useDrawerSnap.ts`) drives `--glass-drawer-t`
+ * off. This is the drawer's OWN settle clock — NOT a re-use of the dock's
+ * `DOCK_SPRING` morph-settle (the per-spring-clock §6 doctrine: each register is its
+ * own clock; a sheet that flings up to a detent settles slower + with a touch more
+ * 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.
+ */
+export declare const DRAWER_SNAP: {
+    readonly response: 0.4;
+    readonly dampingFraction: 0.82;
+};
+/**
+ * BB-2 (the direction-aware default snap ladder fold) — the peek/half/full detent
+ * ladder a bottom/top sheet resolves when the consumer passes no `snapPoints`. The
+ * value (12% peek · 50% half · 100% full) is the `DEFAULT_LIVE_SNAP_POINTS` shape
+ * the prior vaul wrapper hardcoded, re-homed into the engine as the bottom/top
+ * default. A side-lens (left/right) sheet resolves a FULL-SLIDE instead (no detents)
+ * — `resolveDefaultSnapPoints` returns `[]` for the side axis.
+ */
+export declare const BOTTOM_SHEET_LADDER: readonly number[];
+/**
+ * BB-2 — resolve the DEFAULT snap ladder from `direction` natively (retiring the
+ * Atlas `:snap-points="[]"` workaround). A bottom/top sheet gets the peek/half/full
+ * ladder; a left/right side-lens gets a full-slide (no detents — an empty ladder, so
+ * `useDrawerSnap` treats it as a single open/closed slide). A consumer-supplied
+ * `snapPoints` always wins over this default.
+ */
+export declare function resolveDefaultSnapPoints(direction: DrawerDirection): readonly number[];
+/**
+ * The drag-release velocity threshold (px/s). A flung drag whose release velocity
+ * exceeds this advances a detent in the drag direction (the `useDockState`-style
+ * velocity-aware decision); a slow release below it snaps to the NEAREST detent. The
+ * sign of the velocity selects the direction (toward-open vs toward-closed).
+ */
+export declare const DRAWER_FLING_VELOCITY = 450;
+/** `Symbol()` label for the `DrawerSnapContext` injection key (`drawerSnapContext.ts`). */
+export declare const DRAWER_SNAP_LABEL = "glass-ui:drawer-snap-context";

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

@@ -1,17 +1,25 @@
-export { DrawerPortal, DrawerTrigger, DrawerClose } from 'vaul-vue';
+export { DialogPortal as DrawerPortal, DialogTrigger as DrawerTrigger, DialogClose as DrawerClose, } from "reka-ui";
 /**
- * Drawer presentation mode (AN.W3). `"modal"` is the default iOS scale-down
- * sheet (focus-trapped, page `aria-hidden`, page-behind scaled). `"live-behind"`
- * is the non-modal peek/half/full bottom sheet — no focus trap, no page
- * `aria-hidden`, page-behind at native size — bundling the
- * `modal:false` + `shouldScaleBackground:false` + `snapPoints:[0.12,0.5,1]`
- * defaults. Explicit props still override the mode's defaults.
+ * Drawer drag/slide direction (BB.W-DRAWER-ABROGATE). `bottom` (default) + `top`
+ * are the peek/half/full bottom-sheet axes; `left`/`right` are the side-lens
+ * full-slide axes. The house snap engine (`useDrawerSnap`) resolves the default
+ * detent ladder FROM this (BB-2): bottom/top → `[0.12, 0.5, 1]`, left/right →
+ * a full-slide (no detents).
  */
-export type DrawerMode = 'modal' | 'live-behind';
-export { default as Drawer } from './Drawer.vue';
-export { default as DrawerOverlay } from './DrawerOverlay.vue';
-export { default as DrawerContent } from './DrawerContent.vue';
-export { default as DrawerHeader } from './DrawerHeader.vue';
-export { default as DrawerFooter } from './DrawerFooter.vue';
-export { default as DrawerTitle } from './DrawerTitle.vue';
-export { default as DrawerDescription } from './DrawerDescription.vue';
+export type DrawerDirection = "top" | "bottom" | "left" | "right";
+/**
+ * Drawer presentation mode (AN.W3). `"modal"` is the default iOS scale-down sheet —
+ * 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.
+ */
+export type DrawerMode = "modal" | "live-behind";
+export { default as Drawer } from "./Drawer.vue";
+export { default as DrawerOverlay } from "./DrawerOverlay.vue";
+export { default as DrawerContent } from "./DrawerContent.vue";
+export { default as DrawerHeader } from "./DrawerHeader.vue";
+export { default as DrawerFooter } from "./DrawerFooter.vue";
+export { default as DrawerTitle } from "./DrawerTitle.vue";
+export { default as DrawerDescription } from "./DrawerDescription.vue";