@mkbabb/glass-ui 4.2.0 → 6.0.0

package/dist/components/ui/_shared/ModalOverlay.vue.d.ts

@@ -1,90 +0,0 @@
-import { type HTMLAttributes } from "vue";
-/**
- * ModalOverlay — canonical wrapper for Dialog / Sheet / AlertDialog scrim
- * declarations (V.W3.T4 / A5 §4). Three near-bit-identical class strings
- * (DialogContent, DialogScrollContent, SheetContent) collapse onto one
- * primitive parameterised by:
- *
- * - `scrim`: `glass` (default — `bg-overlay-scrim`) | `dim`
- *   (`bg-overlay-scrim-strong`) | `clear` (`bg-overlay-scrim-subtle`)
- * - `animate`: `fade` (default — composes `.sheet-animate`) | `scale`
- *   | `slide` | `none` (Drawer / vaul-vue case)
- * - `layout`: `centered` (default flat overlay) | `edge` (reserved alias —
- *   maps to no-op today; held for future right/bottom edge-pinned overlays
- *   per A5 §4.4 forward-reservation) | `scroll` (the DialogScrollContent
- *   pattern: grid place-items-center overflow-y-auto so content scrolls
- *   inside the scrim)
- * - `scrimAnimation` (AJ-W4-δ): a CSS `animation` shorthand value forwarded
- *   to the portaled overlay element via the typed `--scrim-animation`
- *   cascade variable. Consumers that need a long-running scrim-breath
- *   (e.g. CellularWarningDialog's slow opacity pulse) cannot reach the
- *   portaled overlay through their scoped CSS — reka-ui's DialogPortal
- *   teleports it outside the consumer's component subtree. The publisher
- *   owns the bridge: the prop value lands as `--scrim-animation` on the
- *   overlay's inline style, and the rule
- *   `[data-scrim-animation] { animation: var(--scrim-animation, none) }`
- *   in the canonical animations.css consumes it.
- *
- * Drawer / vaul-vue stays carved per A5 §4.4 — its transform-driven motion
- * conflicts with `.sheet-animate`'s data-state animation, and the
- * vaul-vue overlay is a different reka-ui primitive entirely.
- */
-interface ModalOverlayProps {
-    class?: HTMLAttributes["class"];
-    /**
-     * Scrim intensity. `glass` reads `--overlay-scrim` (the default Dialog /
-     * Sheet paint); `clear` reads `--overlay-scrim-subtle` (DialogScrollContent
-     * — quieter so chassis content shows through); `dim` reads
-     * `--overlay-scrim-strong` (Drawer / heavy-modal host).
-     */
-    scrim?: "glass" | "clear" | "dim";
-    /**
-     * Animation grammar. `fade` enables the canonical `.sheet-animate`
-     * data-state pair (Dialog, Sheet); `none` skips it for hosts whose
-     * portal library drives its own motion.
-     */
-    animate?: "fade" | "scale" | "slide" | "none";
-    /**
-     * Layout — `centered` is the default flat overlay. `scroll` adds
-     * `grid place-items-center overflow-y-auto` so content scrolls inside
-     * the scrim (DialogScrollContent's "scrollable centred dialog" pattern).
-     * `edge` is a forward-reserved alias that maps to no-op today (held for
-     * future right/bottom edge-pinned overlays per A5 §4.4).
-     */
-    layout?: "centered" | "edge" | "scroll";
-    /**
-     * Optional CSS `animation` shorthand applied to the portaled overlay
-     * via the `--scrim-animation` typed cascade variable. Pairs with the
-     * `[data-scrim-animation] { animation: var(--scrim-animation, none) }`
-     * rule in `animations.css` so consumers can drive a long-running
-     * scrim-breath without owning the portal traversal. Composes with the
-     * `animate="fade"` data-state enter/exit (the fade rides
-     * `tw-animate-css` keyframes on `data-[state]`; the scrim-breath
-     * rides the typed variable on `data-scrim-animation` — distinct
-     * selectors, no cascade fight).
-     *
-     * Example: `scrimAnimation="scrim-breath 6s ease-in-out infinite"`
-     * — pairs with a `@keyframes scrim-breath` declared at the consumer
-     * (or in `animations.css` if the rhythm is canonical).
-     *
-     * AJ-W4-δ.
-     */
-    scrimAnimation?: string;
-}
-declare var __VLS_8: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<ModalOverlayProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ModalOverlayProps> & Readonly<{}>, {
-    animate: "fade" | "scale" | "slide" | "none";
-    layout: "centered" | "edge" | "scroll";
-    scrim: "glass" | "clear" | "dim";
-}, {}, {}, {}, 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;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

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

@@ -1,6 +0,0 @@
-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/menuItemVariants.d.ts

@@ -1,51 +0,0 @@
-import { type VariantProps } from "class-variance-authority";
-/**
- * `menuItemVariants` — canonical CVA shared by 9 menu-family + picker-family
- * primitives. Promotes the four-state contract (hover / focus / data-highlighted /
- * data-disabled) above reka-ui's base classes so consumer-side overrides win
- * via `cn()`'s tailwind-merge ordering.
- *
- * Substrate composition:
- * - `interactive-item` (utilities.css) provides `border-radius: var(--radius-lg)`,
- *   the active-scale (`:active { transform: scale(0.98); }`), the focus-visible
- *   box-shadow ring, and the `data-disabled` paint extension (V.W3 patch — the
- *   :disabled pseudo doesn't fire on reka-ui's `data-disabled="true"` attr,
- *   so utilities.css now paints both).
- *
- * Three input modes paint identical hover/focus accent:
- * - `:hover` — pointer hover.
- * - `:focus` — keyboard focus (also handled at the substrate via :focus-visible).
- * - `[data-highlighted]` — reka-ui's internal navigation highlight (Combobox /
- *   Command / Select families emit this attr instead of relying on browser focus).
- *
- * The CVA composes ABOVE reka-ui's base classes (R4 §4.2 pre-empt): consumer
- * SFCs call `menuItemVariants(...)` last in the `cn()` chain so any radius /
- * background / spacing the upstream library writes is overridden.
- *
- * Indicator slot variants reserve the gutter for radio-dot / check / chevron
- * indicator spans the consumer SFCs render absolutely-positioned.
- *
- * Surface axis (BA.W-MENU-GLASS) — the menu-row's MATERIAL register, an
- * EXPRESSION of the shared {glass·veil·opaque} surface-decoration axis
- * (`_shared/useSurfaceAxis.ts` / `glass/surface-axis.css`), NOT a second axis:
- * - `glass` (DEFAULT, glass-first canon AX.W54) — the `.glass-menu-row` recipe
- *   (`src/styles/menu.css`): the hover / focus / `data-highlighted` / open states
- *   paint the ELEMENT-LEVEL glass-quiet oklab tint (so the row darkens-over-light
- *   AND lifts-over-dark per W-DARK-MATERIAL's tint arm) + a PRM-gated `translateY`
- *   hover-lift, the 44px touch floor, the iOS-grade glassy hover-lift plate. The
- *   flat `bg-accent` utilities are DROPPED on this arm — the cascade-trap-safe
- *   shape: with no unlayered `hover:bg-accent` utility the ONLY background-painters
- *   are the `@layer components` `.interactive-item:hover` accent rule and the
- *   `.glass-menu-row` recipe (imported AFTER utilities.css so it source-order-wins
- *   at equal specificity+layer — the AZ dock-rail `@layer`-loses-to-utility trap
- *   pre-empted: never re-add an unlayered flat-accent utility here).
- * - `accent` — the EXPLICIT flat-accent escape (the prior default's look). A clean
- *   break, NOT a back-compat alias (BA inv-7): a consumer that wants the flat fill
- *   opts in via `surface="accent"`.
- */
-export declare const menuItemVariants: (props?: ({
-    surface?: "glass" | "accent" | null | undefined;
-    indicator?: "start" | "none" | "start-wide" | null | undefined;
-    density?: "comfortable" | "audacious" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export type MenuItemVariants = VariantProps<typeof menuItemVariants>;

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

@@ -1,46 +0,0 @@
-/**
- * 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,55 +0,0 @@
-/**
- * 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.
- *   veil    — the borderless/rimless text-legibility plate: the `--glass-bg-quiet`
- *             fill + blur with the box border AND rim STRIPPED (the boxed look
- *             reads as a dividing line on a text plate). Reads the same `--glass-*`
- *             ladder + W55 `--glass-tint-*` seam, so `--glass-level` / the bright
- *             bucket retune it in lockstep with every glass surface.
- *   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" | "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
- * it already paints (Card's `resting`, Dialog/Sheet/Popover's `floating`); the
- * resolver maps it to the `glass-${tier}` base class. `opaque` is NOT a ladder
- * rung here — it is a decoration on TOP of a base tier (the `.glass-opaque`
- * escape keeps the tier's edge/rim), exactly as Card composes it.
- */
-export type SurfaceTier = "wash" | "quiet" | "resting" | "floating" | "overlay";
-/**
- * Resolve a (surface, tier) pair to the class string a surface composes. Pairs
- * with a `:data-surface="surface"` attribute binding on the same element — the
- * CSS seam (`surface-axis.css`) reads the attr to apply the veil/opaque
- * decoration UNIFORMLY, while this resolver emits the back-compat decoration
- * classes (`veil-surface` / `glass-opaque`) so Card's three shared rungs stay
- * byte-identical and a surface composing the class set alone (no attr) still
- * paints correctly.
- *
- *   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"
- *
- * 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/alert/Alert.vue.d.ts

@@ -1,19 +0,0 @@
-import type { HTMLAttributes } from 'vue';
-import { type AlertVariants } from '.';
-type __VLS_Props = {
-    class?: HTMLAttributes['class'];
-    variant?: AlertVariants['variant'];
-};
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => 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_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

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

@@ -1,8 +0,0 @@
-import { type VariantProps } from 'class-variance-authority';
-export { default as Alert } from './Alert.vue';
-export { default as AlertDescription } from './AlertDescription.vue';
-export { default as AlertTitle } from './AlertTitle.vue';
-export declare const alertVariants: (props?: ({
-    variant?: "default" | "destructive" | "success" | "warning" | "info" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export type AlertVariants = VariantProps<typeof alertVariants>;

package/dist/components/ui/avatar/Avatar.vue.d.ts

@@ -1,23 +0,0 @@
-import type { HTMLAttributes } from 'vue';
-import { type AvatarVariants } from '.';
-type __VLS_Props = {
-    class?: HTMLAttributes['class'];
-    size?: AvatarVariants['size'];
-    shape?: AvatarVariants['shape'];
-};
-declare var __VLS_8: {};
-type __VLS_Slots = {} & {
-    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<{}>, {
-    size: "base" | "sm" | "lg" | null;
-    shape: "circle" | "square" | null;
-}, {}, {}, {}, 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;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/components/ui/avatar/AvatarImage.vue.d.ts

@@ -1,8 +0,0 @@
-import type { ImgHTMLAttributes } from 'vue';
-import { type AvatarImageProps } from 'reka-ui';
-type __VLS_Props = AvatarImageProps & {
-    alt?: ImgHTMLAttributes['alt'];
-};
-declare const __VLS_export: 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 _default: typeof __VLS_export;
-export default _default;

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

@@ -1,9 +0,0 @@
-import { type VariantProps } from 'class-variance-authority';
-export { default as Avatar } from './Avatar.vue';
-export { default as AvatarImage } from './AvatarImage.vue';
-export { default as AvatarFallback } from './AvatarFallback.vue';
-export declare const avatarVariants: (props?: ({
-    size?: "base" | "sm" | "lg" | null | undefined;
-    shape?: "circle" | "square" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export type AvatarVariants = VariantProps<typeof avatarVariants>;

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

@@ -1,34 +0,0 @@
-import type { HTMLAttributes } from 'vue';
-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: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => 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_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

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

@@ -1,8 +0,0 @@
-import { type VariantProps } from 'class-variance-authority';
-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

@@ -1,29 +0,0 @@
-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'];
-    class?: HTMLAttributes['class'];
-    surface?: Surface;
-    liquid?: boolean;
-    punch?: boolean;
-    type?: ButtonHTMLAttributes['type'];
-    disabled?: ButtonHTMLAttributes['disabled'];
-}
-declare var __VLS_13: {};
-type __VLS_Slots = {} & {
-    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<{}>, {
-    as: import("reka-ui").AsTag | import("vue").Component;
-}, {}, {}, {}, 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;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

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

@@ -1,7 +0,0 @@
-import { type VariantProps } from 'class-variance-authority';
-export { default as Button } from './Button.vue';
-export declare const buttonVariants: (props?: ({
-    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

@@ -1,168 +0,0 @@
-import { type HTMLAttributes } from "vue";
-import { type PrimitiveProps } from "reka-ui";
-/**
- * The glass surface ladder. Maps 1:1 to `.glass-{tier}` in glass.css after the
- * v0.8.0 R3-spec rename:
- *
- *   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
- *   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" | "deep";
-/**
- * Surface decoration register — orthogonal to `tier`/`shadow`/`grain`.
- *
- *   glass    — the tier's plain glass rung (default)
- *   cartoon  — the Memphis-sticker decoration layered on top of the resolved
- *              tier: 2px border, offset-stamp shadow, hover-lift. Composes onto
- *              ANY tier; the retired `<CartoonCard>` was `tier="quiet" surface="cartoon"`.
- *   veil     — the text-legibility PLATE (R5-7). The wash/quiet glass fill +
- *              blur with the border AND rim/highlight STRIPPED (border:none,
- *              box-shadow:none — the boxed look reads as a "dividing line" on a
- *              text plate). An optional radial feather axis (`--veil-feather`,
- *              default none) fades the plate edges into the backdrop. Conceptually
- *              the W55 adaptive-legibility tint applied as a LOCAL plate over a
- *              busy/bright backdrop. Token-first (`--veil-*` rungs). It routes the
- *              glass material through the `--glass-*` ladder, so `--glass-level` /
- *              the W55 bright-bucket retune it in lockstep with every glass surface.
- */
-export type CardSurface = "glass" | "cartoon" | "veil";
-/**
- * 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`/`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;
-    /** Surface decoration register. `glass` (default) renders the tier's glass
-     *  rung; `cartoon` overlays the `cartoon-surface` decoration utility (2px
-     *  border, offset-stamp shadow, hover-lift); `veil` overlays the borderless,
-     *  rimless `veil-surface` text-legibility plate (the wash/quiet glass fill +
-     *  blur with the boxed border + rim STRIPPED, an optional `--veil-feather`
-     *  radial edge fade). Orthogonal to `tier`/`shadow`/`grain` — exactly like
-     *  `shadow` and `grain`; NOT a `tier` rung. */
-    surface?: CardSurface;
-    /** Surface drop shadow via `--shadow-card`. Off for cards nested inside cards. */
-    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;
-    /** 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;
-    /** 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: {};
-type __VLS_Slots = {} & {
-    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;
-    tier: CardTier;
-    grid: boolean;
-    surface: CardSurface;
-    as: import("reka-ui").AsTag | import("vue").Component;
-    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;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};