@mkbabb/glass-ui 6.0.0 → 8.0.0

package/dist/command-BuBnYpxF.js

@@ -0,0 +1,340 @@
+import { t as e } from "./class-names-q-UGOkHH.js";
+import { t } from "./primitive-B2t2jdqM.js";
+import { t as n } from "./selection-DqIULxRG.js";
+import { n as r, t as i } from "./DialogContent-4hzLiaCQ.js";
+import { t as a } from "./rowClass-DYOXwxhO.js";
+import { t as o } from "./participation-B0hdsIRo.js";
+import { computed as s, createBlock as c, createCommentVNode as l, createElementBlock as u, createTextVNode as d, createVNode as f, defineComponent as p, mergeProps as m, normalizeClass as h, openBlock as g, renderSlot as _, toDisplayString as v, unref as y, useAttrs as b, withCtx as x } from "vue";
+import { ComboboxContent as S, ComboboxEmpty as C, ComboboxGroup as w, ComboboxInput as T, ComboboxItem as E, ComboboxLabel as D, ComboboxRoot as O, ComboboxSeparator as k } from "reka-ui";
+import { Search as A } from "@lucide/vue";
+//#endregion
+//#region src/components/command/Command.vue
+var j = /* @__PURE__ */ p({
+	name: "Command",
+	inheritAttrs: !1,
+	__name: "Command",
+	props: {
+		modelValue: {},
+		open: {
+			type: Boolean,
+			default: void 0
+		},
+		defaultOpen: {
+			type: Boolean,
+			default: !0
+		},
+		disabled: {
+			type: Boolean,
+			default: void 0
+		},
+		class: { type: [
+			Boolean,
+			null,
+			String,
+			Object,
+			Array
+		] },
+		surface: { default: "glass" }
+	},
+	emits: ["update:modelValue", "update:open"],
+	setup(t, { emit: r }) {
+		let i = t, a = r, o = b(), l = s(() => ({
+			...o,
+			modelValue: i.modelValue,
+			...i.open === void 0 ? {} : { open: i.open },
+			defaultOpen: i.defaultOpen,
+			disabled: i.disabled
+		}));
+		function u(e) {
+			let t = Array.isArray(e) ? e : [e];
+			for (let e of t) if (e != null && !n(e)) throw TypeError("[glass-ui] Command received a non-scalar value.");
+			a("update:modelValue", e);
+		}
+		return (t, n) => (g(), c(y(O), m(l.value, {
+			"data-slot": "command",
+			"data-surface": i.surface,
+			class: y(e)("command", i.class),
+			"onUpdate:modelValue": u,
+			"onUpdate:open": n[0] ||= (e) => a("update:open", e)
+		}), {
+			default: x(() => [_(t.$slots, "default")]),
+			_: 3
+		}, 16, ["data-surface", "class"]));
+	}
+}), M = /* @__PURE__ */ p({
+	name: "CommandDialog",
+	inheritAttrs: !1,
+	__name: "CommandDialog",
+	props: {
+		surface: { default: "glass" },
+		modelValue: {},
+		open: {
+			type: Boolean,
+			default: void 0
+		},
+		defaultOpen: {
+			type: Boolean,
+			default: void 0
+		},
+		modal: {
+			type: Boolean,
+			default: void 0
+		},
+		unmountOnHide: {
+			type: Boolean,
+			default: void 0
+		},
+		origin: {}
+	},
+	emits: ["update:open", "update:modelValue"],
+	setup(e, { emit: t }) {
+		let n = e, a = t, o = s(() => {
+			let { surface: e, modelValue: t, open: r, defaultOpen: i, modal: a, unmountOnHide: o, ...s } = n;
+			return {
+				...s,
+				...r === void 0 ? {} : { open: r },
+				...i === void 0 ? {} : { defaultOpen: i },
+				...a === void 0 ? {} : { modal: a },
+				...o === void 0 ? {} : { unmountOnHide: o }
+			};
+		}), l = s(() => ({
+			modelValue: n.modelValue,
+			...n.open === void 0 ? {} : { open: n.open }
+		}));
+		return (e, t) => (g(), c(r, m(o.value, { "onUpdate:open": t[2] ||= (e) => a("update:open", e) }), {
+			default: x(() => [f(i, {
+				surface: n.surface,
+				dismiss: "deliberate",
+				class: "command-dialog__content"
+			}, {
+				default: x(() => [f(j, m(l.value, {
+					"onUpdate:open": t[0] ||= (e) => a("update:open", e),
+					"onUpdate:modelValue": t[1] ||= (e) => a("update:modelValue", e)
+				}), {
+					default: x(() => [_(e.$slots, "default")]),
+					_: 3
+				}, 16)]),
+				_: 3
+			}, 8, ["surface"])]),
+			_: 3
+		}, 16));
+	}
+}), N = /* @__PURE__ */ p({
+	name: "CommandEmpty",
+	inheritAttrs: !1,
+	__name: "CommandEmpty",
+	props: { class: { type: [
+		Boolean,
+		null,
+		String,
+		Object,
+		Array
+	] } },
+	setup(n) {
+		let r = n, i = b(), a = s(() => t(i));
+		return (t, n) => (g(), c(y(C), m(a.value, {
+			"data-slot": "command-empty",
+			class: y(e)("command__empty", r.class)
+		}), {
+			default: x(() => [_(t.$slots, "default")]),
+			_: 3
+		}, 16, ["class"]));
+	}
+}), P = /* @__PURE__ */ p({
+	name: "CommandGroup",
+	inheritAttrs: !1,
+	__name: "CommandGroup",
+	props: {
+		heading: {},
+		class: { type: [
+			Boolean,
+			null,
+			String,
+			Object,
+			Array
+		] }
+	},
+	setup(n) {
+		let r = n, i = b(), a = s(() => t(i));
+		return (t, n) => (g(), c(y(w), m(a.value, {
+			"data-slot": "command-group",
+			class: y(e)("command__group", r.class)
+		}), {
+			default: x(() => [r.heading ? (g(), c(y(D), {
+				key: 0,
+				class: "command__group-label"
+			}, {
+				default: x(() => [d(v(r.heading), 1)]),
+				_: 1
+			})) : l("", !0), _(t.$slots, "default")]),
+			_: 3
+		}, 16, ["class"]));
+	}
+}), F = {
+	class: "command__input-wrapper",
+	"data-slot": "command-input-wrapper"
+}, I = /* @__PURE__ */ p({
+	name: "CommandInput",
+	inheritAttrs: !1,
+	__name: "CommandInput",
+	props: {
+		modelValue: {},
+		autoFocus: { type: Boolean },
+		disabled: { type: Boolean },
+		placeholder: {},
+		class: { type: [
+			Boolean,
+			null,
+			String,
+			Object,
+			Array
+		] }
+	},
+	emits: ["update:modelValue"],
+	setup(n, { emit: r }) {
+		let i = n, a = r, o = b(), c = s(() => ({
+			...t(o),
+			placeholder: i.placeholder
+		}));
+		return (t, n) => (g(), u("div", F, [f(y(A), {
+			class: "command__input-icon",
+			"aria-hidden": "true"
+		}), f(y(T), m(c.value, {
+			"data-slot": "command-input",
+			"model-value": i.modelValue,
+			"auto-focus": i.autoFocus,
+			disabled: i.disabled,
+			class: y(e)("command__input", i.class),
+			"onUpdate:modelValue": n[0] ||= (e) => a("update:modelValue", e)
+		}), null, 16, [
+			"model-value",
+			"auto-focus",
+			"disabled",
+			"class"
+		])]));
+	}
+}), L = /* @__PURE__ */ p({
+	name: "CommandItem",
+	inheritAttrs: !1,
+	__name: "CommandItem",
+	props: {
+		value: {},
+		disabled: { type: Boolean },
+		textValue: {},
+		class: { type: [
+			Boolean,
+			null,
+			String,
+			Object,
+			Array
+		] }
+	},
+	emits: ["select"],
+	setup(n, { emit: r }) {
+		let i = n, o = r, l = b(), u = s(() => t(l));
+		function d(e) {
+			if (i.disabled) {
+				e.preventDefault();
+				return;
+			}
+			o("select", e);
+		}
+		return (t, n) => (g(), c(y(E), m(u.value, {
+			"data-slot": "command-item",
+			value: i.value,
+			disabled: i.disabled,
+			"text-value": i.textValue,
+			class: y(e)("command__item", y(a)(), i.class),
+			onSelect: d
+		}), {
+			default: x(() => [_(t.$slots, "default")]),
+			_: 3
+		}, 16, [
+			"value",
+			"disabled",
+			"text-value",
+			"class"
+		]));
+	}
+}), R = /* @__PURE__ */ p({
+	name: "CommandList",
+	inheritAttrs: !1,
+	__name: "CommandList",
+	props: {
+		class: { type: [
+			Boolean,
+			null,
+			String,
+			Object,
+			Array
+		] },
+		surface: { default: "glass" }
+	},
+	emits: [
+		"escapeKeyDown",
+		"pointerDownOutside",
+		"focusOutside",
+		"interactOutside"
+	],
+	setup(t, { emit: n }) {
+		let r = t, i = n, a = b(), l = s(() => ({ ...a })), u = o();
+		return (t, n) => (g(), c(y(S), m({
+			...l.value,
+			...y(u).portalAttrs.value
+		}, {
+			"data-slot": "command-list",
+			"data-fade-start": "",
+			"data-fade-end": "",
+			"disable-outside-pointer-events": !1,
+			"data-surface": r.surface,
+			class: y(e)("command__list fading-scroll fading-scroll--y", r.class),
+			onEscapeKeyDown: n[0] ||= (e) => i("escapeKeyDown", e),
+			onPointerDownOutside: n[1] ||= (e) => i("pointerDownOutside", e),
+			onFocusOutside: n[2] ||= (e) => i("focusOutside", e),
+			onInteractOutside: n[3] ||= (e) => i("interactOutside", e)
+		}), {
+			default: x(() => [_(t.$slots, "default")]),
+			_: 3
+		}, 16, ["data-surface", "class"]));
+	}
+}), z = /* @__PURE__ */ p({
+	name: "CommandSeparator",
+	inheritAttrs: !1,
+	__name: "CommandSeparator",
+	props: { class: { type: [
+		Boolean,
+		null,
+		String,
+		Object,
+		Array
+	] } },
+	setup(n) {
+		let r = n, i = b(), a = s(() => t(i));
+		return (t, n) => (g(), c(y(k), m(a.value, {
+			"data-slot": "command-separator",
+			class: y(e)("glass-menu-divider command__separator", r.class)
+		}), {
+			default: x(() => [_(t.$slots, "default")]),
+			_: 3
+		}, 16, ["class"]));
+	}
+}), B = /* @__PURE__ */ p({
+	name: "CommandShortcut",
+	__name: "CommandShortcut",
+	props: { class: { type: [
+		Boolean,
+		null,
+		String,
+		Object,
+		Array
+	] } },
+	setup(t) {
+		let n = t;
+		return (t, r) => (g(), u("span", {
+			"data-slot": "command-shortcut",
+			class: h(y(e)("command__shortcut", n.class))
+		}, [_(t.$slots, "default")], 2));
+	}
+});
+//#endregion
+export { I as a, M as c, L as i, j as l, z as n, P as o, R as r, N as s, B as t };

package/dist/command.d.ts

@@ -1 +1 @@
-export * from "./components/command";
+export * from "./components/command/index.js";

package/dist/command.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./command-BjPjUU9z.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./command-BuBnYpxF.js";
 export { r as Command, t as CommandDialog, s as CommandEmpty, a as CommandGroup, e as CommandInput, n as CommandItem, o as CommandList, i as CommandSeparator, c as CommandShortcut };

package/dist/component-styles.css

@@ -0,0 +1,4 @@
+@import "./styles/track-well.css";
+@import "./styles/glass/value-marks.css";
+@import "./styles/glass/track-flow.css";
+@import "./glass-ui.css";

package/dist/components/_shared/axes.d.ts

@@ -1,4 +1,9 @@
-export type { Surface, SurfaceTier } from "./useSurfaceAxis";
+/** The surface-decoration axis. */
+export declare const SURFACES: readonly ["glass", "veil", "opaque"];
+export type Surface = (typeof SURFACES)[number];
+/** The five-rung glass ladder. */
+export declare const SURFACE_TIERS: readonly ["wash", "quiet", "resting", "floating", "overlay"];
+export type SurfaceTier = (typeof SURFACE_TIERS)[number];
 /** The scale axis — one honest ordinal; rung names ≡ the `--control-h-*` token cohort. */
 export declare const SIZES: readonly ["xs", "sm", "md", "lg", "xl"];
 export type Size = (typeof SIZES)[number];
@@ -8,14 +13,18 @@ export type Orientation = (typeof ORIENTATIONS)[number];
 /** The motion-weight axis — opt-DOWN, not opt-in (liquid-weight universal). */
 export declare const MOTIONS: readonly ["full", "reduced", "off"];
 export type Motion = (typeof MOTIONS)[number];
-/** The surface-decoration axis — mirrors `useSurfaceAxis`'s `Surface` (gate-asserted ≡). */
-export declare const SURFACES: readonly ["glass", "veil", "opaque"];
 /** The tone axis — the semantic status register (`--<tone>` token cohort); NEVER a `variant` member. */
 export declare const TONES: readonly ["neutral", "success", "warning", "info", "destructive"];
 export type Tone = (typeof TONES)[number];
-/** The overlay-placement axis — Sheet's side-slide + Dialog center fold onto ONE placement. */
+/** The overlay-placement axis — ONE union for every surface that sites itself against an
+ * edge or the centre. `center` is the Dialog's rest and is excluded by the two consumers
+ * that only ever anchor: `SidePlacement` (sheet/motion.ts) and `FloatingSide`
+ * (_shared/overlay/placement.ts). */
 export declare const PLACEMENTS: readonly ["center", "top", "right", "bottom", "left"];
 export type Placement = (typeof PLACEMENTS)[number];
 /** The overlay-trigger axis — click | hover | context (the sealed Popover Kronecker fold). */
 export declare const TRIGGERS: readonly ["click", "hover", "context"];
 export type Trigger = (typeof TRIGGERS)[number];
+/** The overlay-backdrop axis — the flat scrim vs the graded box-following halo. */
+export declare const BACKDROPS: readonly ["scrim", "graded"];
+export type Backdrop = (typeof BACKDROPS)[number];

package/dist/components/_shared/class-names.d.ts

@@ -1,21 +1,20 @@
-import { type ClassValue } from "clsx";
+export type ClassValue = string | number | false | null | undefined | ClassValue[] | {
+    readonly [className: string]: unknown;
+};
 /**
  * `cn()` — class-name compositor for glass-ui components.
  *
- * Rationale (W3.b.2 / A5 §3 Split 6): `tailwind-merge` ships ~22 KB
- * gzipped of full Tailwind config to resolve every conflict pair across
- * the framework. Glass-ui exercises a small, stable subset of Tailwind
- * utilities; the conflict surface is enumerable. We replace twMerge with
- * a hand-rolled deduplicator that handles the ~30 conflict pairs glass-ui
- * actually relies on, paying ~0.5 KB gzipped instead.
+ * Glass-ui uses a small, stable subset of Tailwind utilities, so a compact
+ * local conflict table is sufficient. This keeps class normalization and
+ * last-write-wins deduplication in one dependency-free owner.
  *
- * Semantics: clsx normalises the variadic argument shape (strings,
+ * Semantics: `joinClassValues` normalises the variadic argument shape (strings,
  * arrays, conditional objects, falsy filtering). The deduplicator then
  * walks the joined string left-to-right, computes each token's
  * conflict-key (the CSS-property bucket the utility writes to), and
  * keeps only the last token per bucket. Variant prefixes like
  * `hover:`, `md:`, `dark:`, `[&::after]:` carry their own conflict
- * scope: a bucket-key incorporates the prefix so `text-sm md:text-lg`
+ * scope: a bucket-key incorporates the prefix so `text-small md:text-lg`
  * keeps both. `!`-important tokens scope identically to their
  * non-important twin (`!p-2 p-4` keeps `p-4` — last-write-wins ignores
  * importance, mirroring twMerge's behaviour for the cases glass-ui hits).
@@ -25,3 +24,5 @@ import { type ClassValue } from "clsx";
  * not in the conflict table).
  */
 export declare function cn(...inputs: ClassValue[]): string;
+/** Normalize Vue-compatible class values without shipping a runtime class helper. */
+export declare function joinClassValues(...inputs: ClassValue[]): string;

package/dist/components/_shared/control.d.ts

@@ -0,0 +1,11 @@
+export type ControlSize = "sm" | "md" | "lg";
+export declare const controlSizeClass: (size?: ControlSize) => string;
+/** The state axis every binary control exposes. */
+export interface ControlProps {
+    invalid?: boolean;
+    disabled?: boolean;
+}
+export declare const controlStateAttrs: (invalid?: boolean) => {
+    "data-invalid": true | undefined;
+    "aria-invalid": true | undefined;
+};

package/dist/components/_shared/disclosure/disclosure-context.d.ts

@@ -0,0 +1,7 @@
+interface DisclosureIds {
+    content: string;
+    trigger: string;
+}
+export declare function provideDisclosureIds(): DisclosureIds;
+export declare function useDisclosureIds(): DisclosureIds;
+export {};

package/dist/components/_shared/feedback/DotRing.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/_shared/feedback/dot-ring.css

@@ -0,0 +1 @@
+@layer components{.glass-dot-ring{position: relative;display: inline-block;aspect-ratio: 1;inline-size: var(--icon-lg);--dot-ring-tint: currentColor;--dot-ring-inequality: 0.2360679775;--dot-ring-spin: var(--duration-xl);--_dot-ring-pitch: sin(180deg / 7);--_dot-ring-radius: calc( 50% / (1 + var(--_dot-ring-pitch) * sqrt(1 + var(--dot-ring-inequality))) );--_dot-ring-bead: calc(2 * var(--_dot-ring-pitch) * var(--_dot-ring-radius));animation: glass-dot-ring-redistribute var(--dot-ring-spin) linear infinite;--dot-ring-extent: 1;transition: --dot-ring-extent var(--spring-dock-duration) var(--spring-dock);}@starting-style{.glass-dot-ring{--dot-ring-extent: 0;}}.glass-dot-ring-leave-active{transition: opacity var(--spring-dock-exit-duration) var(--exit-curve);}.glass-dot-ring-leave-active .glass-dot-ring{transition: --dot-ring-extent var(--spring-dock-exit-duration) var(--exit-curve);}.glass-dot-ring-leave-to{opacity: 0;}.glass-dot-ring-leave-to .glass-dot-ring{--dot-ring-extent: 0;}.glass-dot-ring-spoke{position: absolute;inset: 0;rotate: calc(var(--dot-ring-k) * (1turn / 7));}.glass-dot-ring-bead{position: absolute;inset-inline-start: 50%;inset-block-start: 50%;inline-size: var(--_dot-ring-bead);block-size: var(--_dot-ring-bead);margin-inline-start: calc(var(--_dot-ring-bead) / -2);margin-block-start: calc(var(--_dot-ring-bead) / -2);border-radius: var(--radius-pill);background: oklch( from var(--dot-ring-tint) l c calc(h + var(--dot-ring-k) * (360 / 7) * var(--dot-ring-inequality)) );translate: calc( 100% / (2 * var(--_dot-ring-pitch)) * var(--dot-ring-extent) ) 0;scale: calc( sqrt( 1 + var(--dot-ring-inequality) * var(--dot-ring-extent) * cos( var(--dot-ring-phase) + var(--dot-ring-k) * (1turn / 7) ) ) * (1 + (sqrt(7) - 1) * (1 - var(--dot-ring-extent))) );}@media (prefers-reduced-motion: reduce){.glass-dot-ring{animation: none;transition: none;}.glass-dot-ring-leave-active,.glass-dot-ring-leave-active .glass-dot-ring{transition: none;}}@media (forced-colors: active){.glass-dot-ring-bead{background: CanvasText;}}}@keyframes glass-dot-ring-redistribute{to{--dot-ring-phase: 1turn;}}

package/dist/components/_shared/feedback/feedback-tone.css

@@ -0,0 +1 @@
+@layer components{:root{--feedback-tone-strength: 18%;--feedback-tone-rung: var(--glass-plate-floating);--feedback-tone-border-strength: 40%;}.feedback-tone{background: color-mix( in oklab,var(--glass-veil,var(--feedback-tone-rung)),var(--tone) var(--feedback-tone-strength) );border-color: color-mix( in oklab,transparent,var(--tone) var(--feedback-tone-border-strength) );}.feedback-tone-success{--tone: var(--success);}.feedback-tone-warning{--tone: var(--warning);}.feedback-tone-info{--tone: var(--info);}.feedback-tone-destructive{--tone: var(--destructive);}.feedback-tone-glyph{color: var(--tone);}}

package/dist/components/_shared/field/control.d.ts

@@ -0,0 +1,13 @@
+export type FieldControlState = "default" | "invalid" | "readonly" | "disabled";
+export declare function isAriaInvalid(value: unknown): boolean;
+export declare function useFieldControlState(props: {
+    disabled?: boolean;
+    invalid?: boolean;
+    readonly?: boolean;
+}, attrs: Record<string, unknown>): {
+    ariaInvalid: import("vue").ComputedRef<(boolean | "true" | "false") | "grammar" | "spelling" | undefined>;
+    forwardedAttrs: import("vue").ComputedRef<{
+        [x: string]: unknown;
+    }>;
+    state: import("vue").ComputedRef<FieldControlState>;
+};

package/dist/components/_shared/focus.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The one focusable-descendant selector. Sequential-focus candidates only:
+ * `:not([disabled])` on the form controls, `tabindex="-1"` excluded (programmatic
+ * targets are not part of the tab order a disclosure hands focus to).
+ *
+ * DELIBERATE NON-MEMBER: `useDockClickIntegrity`'s interactive-ancestor probe
+ * (dock/composables/useDockClickIntegrity.ts) is a WIDER, different question — "was
+ * this pointer event aimed at something interactive", which includes disabled controls,
+ * `[role=button]` and `tabindex="-1"` targets. It must NOT fold onto this constant.
+ */
+export declare const FOCUSABLE_SELECTOR: string;

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

@@ -1,6 +1,2 @@
-export { menuItemVariants } from "./menuItemVariants";
-export type { MenuItemVariants } from "./menuItemVariants";
-export { surfaceClass, decorationClass } from "./useSurfaceAxis";
-export type { Surface, SurfaceTier } from "./useSurfaceAxis";
-export { controlSizeClass, switchSizeClass } from "./useControlSize";
-export type { ControlSize } from "./useControlSize";
+export { controlSizeClass } from "./control.js";
+export type { ControlSize } from "./control.js";

package/dist/components/_shared/interaction.d.ts

@@ -0,0 +1,23 @@
+import type { SelectionValue } from "./selection.js";
+/** Pointer interaction dispatched outside dismissable floating content. */
+export type PointerDownOutsideEvent = CustomEvent<{
+    originalEvent: PointerEvent;
+}>;
+/** Focus interaction dispatched outside dismissable floating content. */
+export type FocusOutsideEvent = CustomEvent<{
+    originalEvent: FocusEvent;
+}>;
+/** Preventable lifecycle events shared by modal content surfaces. */
+export interface DismissableContentEmits {
+    escapeKeyDown: [event: KeyboardEvent];
+    pointerDownOutside: [event: PointerDownOutsideEvent];
+    focusOutside: [event: FocusOutsideEvent];
+    interactOutside: [event: PointerDownOutsideEvent | FocusOutsideEvent];
+    openAutoFocus: [event: Event];
+    closeAutoFocus: [event: Event];
+}
+/** Preventable selection event dispatched by a Glass listbox item. */
+export type ListboxItemSelectEvent<T = SelectionValue> = CustomEvent<{
+    originalEvent: PointerEvent;
+    value?: T;
+}>;

package/dist/components/_shared/menu/menu.css

@@ -0,0 +1 @@
+@layer components{.glass-menu-row{--menu-row-bg: var(--glass-plate-quiet);--menu-row-lift: -1px;min-block-size: max(2rem,var(--touch-target,2.75rem));transition: background-color var(--engage-control-engage-release) var(--ease-standard),color var(--engage-control-engage-release) var(--ease-standard),border-color var(--engage-control-engage-release) var(--ease-standard),box-shadow var(--engage-control-engage-release) var(--ease-standard),translate var(--spring-dock-duration) var(--spring-dock),scale var(--spring-press-duration) var(--transition-liquid-spatial);translate: 0 0;}.glass-menu-row:focus:not([data-disabled]),.glass-menu-row[data-highlighted]:not([data-disabled]),.glass-menu-row[data-state="open"]:not([data-disabled]){background: var(--menu-row-bg);color: var(--accent-foreground);transition: background-color var(--engage-control-engage-attack) var(--ease-standard),color var(--engage-control-engage-attack) var(--ease-standard),border-color var(--engage-control-engage-attack) var(--ease-standard),box-shadow var(--engage-control-engage-attack) var(--ease-standard),translate var(--spring-dock-duration) var(--spring-dock),scale var(--spring-press-duration) var(--transition-liquid-spatial);}@media (hover: hover){.glass-menu-row:hover:not([data-disabled]){background: var(--menu-row-bg);color: var(--accent-foreground);translate: 0 var(--menu-row-lift);transition: background-color var(--engage-control-engage-attack) var(--ease-standard),color var(--engage-control-engage-attack) var(--ease-standard),border-color var(--engage-control-engage-attack) var(--ease-standard),box-shadow var(--engage-control-engage-attack) var(--ease-standard),translate var(--spring-dock-duration) var(--spring-dock),scale var(--spring-press-duration) var(--transition-liquid-spatial);}}}@media (prefers-reduced-motion: reduce){.glass-menu-row{--menu-row-lift: 0px;transition: background-color var(--engage-control-engage-release) var(--ease-standard),color var(--engage-control-engage-release) var(--ease-standard),border-color var(--engage-control-engage-release) var(--ease-standard),box-shadow var(--engage-control-engage-release) var(--ease-standard);}}@layer components{.glass-menu-divider{block-size: 1px;background: color-mix( in oklab,var(--foreground) calc(var(--ink-seam) * 100%),transparent );}}

package/dist/components/_shared/menu/rowClass.d.ts

@@ -0,0 +1,2 @@
+export type MenuRowIndicator = "none" | "start";
+export declare function rowClass(indicator?: MenuRowIndicator): string;

package/dist/components/_shared/overlay/content.d.ts

@@ -0,0 +1,40 @@
+import { type ClassValue } from "../class-names.js";
+import type { DockPortalAttrs } from "./participation.js";
+/**
+ * ══ THE ONE OVERLAY REGISTER ══
+ *
+ * Three surfaces that are one register used to paint through three cascade
+ * origins and six independent spellings of the literal `"floating"`. This is the
+ * seam they collapse to.
+ *
+ * The ROLE is the register row, and it rides the EXISTING `data-reveal` axis —
+ * nothing parallel is minted. A `hint` is an annotation (bezier, no mass, the
+ * tight pad); a `menu` is an anchored materialization; a `panel` is a body that
+ * arrives with weight. The three differ in exactly three declared values — pad,
+ * corner, minimum measure — and `styles/glass/overlay-plate.css` states them
+ * once, keyed off `.glass-overlay-plate` and the role attribute this writes.
+ *
+ * `data-material` and the content-level `data-surface` are GONE. The first keyed
+ * a role-shadow grammar deleted at #86; the second was a per-component knob for
+ * a decision the rung already owns.
+ */
+export type OverlayRole = "hint" | "menu" | "panel";
+export interface OverlayAttrs extends DockPortalAttrs {
+    class: string;
+    "data-slot": string;
+    "data-reveal": "tooltip" | "menu" | "overlay";
+}
+/**
+ * Every attribute a portalled overlay root carries, from one place.
+ *
+ * Composes `surfaceClass()` — the plain resolver, never a `useSurface()`: the
+ * attrs half would ship with exactly one consumer, which is this function.
+ */
+export declare function overlayContentAttrs(o: {
+    role: OverlayRole;
+    slot: string;
+    /** The stamp pair from `useDockParticipation()`. Absent outside a dock. */
+    dock?: DockPortalAttrs;
+    /** Consumer classes, merged last so a consumer still wins. */
+    class?: ClassValue;
+}): OverlayAttrs;

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

@@ -0,0 +1,12 @@
+/**
+ * `_shared/overlay/` — a RELOCATION, not a growth.
+ *
+ * The portal contract, the keep-open token and the plate's attribute seam were
+ * spread across `dock/composables/`, five component files and a `_shared/`
+ * denylist module. Nothing here is new machinery; it is the same three
+ * contracts, stated once, beside each other, with their readers.
+ */
+export { overlayContentAttrs, type OverlayAttrs, type OverlayRole } from "./content.js";
+export { isTeleportedTarget } from "./isTeleportedTarget.js";
+export { useDockParticipation, useHoldToken, type DockParticipation, type DockPortalAttrs, type HoldTarget, type HoldToken, } from "./participation.js";
+export type { FloatingAlign, FloatingPlacementProps, FloatingSide, } from "./placement.js";

package/dist/components/{dock/composables → _shared/overlay}/isTeleportedTarget.d.ts

@@ -5,5 +5,10 @@
  * `data-glass-dock-portal` and `data-glass-dock-owner`. That keeps click-away
  * logic scoped to the owning dock instead of depending on Reka internals,
  * ARIA roles, or broad class names.
+ *
+ * It lives HERE, beside `overlayContentAttrs()`, because this predicate and that
+ * writer are two halves of one contract: the reader parsed an attribute pair
+ * that five hand-written call sites in five different files were each spelling
+ * for themselves. Sitting in `dock/` it was a reader with no visible writer.
  */
 export declare function isTeleportedTarget(target: EventTarget | null, ownerId?: string): boolean;

package/dist/components/_shared/overlay/participation.d.ts

@@ -0,0 +1,66 @@
+import { type ComputedRef, type MaybeRefOrGetter, type Ref } from "vue";
+import { type DockHoldKind } from "../../dock/composables/dockContext.js";
+/**
+ * ══ THE ONE KEEP-OPEN TOKEN ══
+ *
+ * Four sites used to hand-roll the same six lines: a boolean `isHeld`, an
+ * acquire guarded on it, a release guarded on it, and a teardown that had to
+ * remember to release — `Popover.vue`, `DockLayerGroup.vue`, `useDockSearch.ts`
+ * and `useDockHold.ts`. Four copies of a discipline is four chances to leak a
+ * token, and a leaked token is a dock that never idle-collapses again for the
+ * life of the page. The dock context's `keepOpen`/`release` pair is already a
+ * REF-COUNT; what was duplicated is the *token* — the guarantee that one holder
+ * takes exactly one count and gives it back exactly once, including on unmount.
+ *
+ * `target` is a getter rather than a value so a holder can sit above the thing
+ * it holds (`useDockSearch` drives its own dock state object; a Popover reads an
+ * optional context that may be absent entirely). A null target is not an error:
+ * the flag still flips, because whether the holder is holding is a fact about
+ * the holder, not about whether a dock happened to be listening.
+ */
+export interface HoldTarget {
+    keepOpen: (kind?: DockHoldKind) => void;
+    release: (kind?: DockHoldKind) => void;
+}
+export interface HoldToken {
+    /** `true` while this token holds its count. */
+    readonly isHeld: Readonly<Ref<boolean>>;
+    /** Idempotent — a second call while held is a no-op, never a second count. */
+    acquire: () => void;
+    /** Idempotent — a release while free is a no-op, never a negative count. */
+    release: () => void;
+}
+export declare function useHoldToken(target: () => HoldTarget | null | undefined, kind?: DockHoldKind): HoldToken;
+/**
+ * The portal stamp pair a dock-owned overlay writes onto its TELEPORTED root.
+ *
+ * `isTeleportedTarget()` (beside this file) is the reader. Ten hand-written
+ * spellings across five sites in three files used to write it, and three
+ * portalled surfaces — the tooltip, the submenu, the command list — wrote
+ * nothing at all, so a dock-anchored tooltip collapsed the dock the moment the
+ * pointer left the icon for the hint.
+ */
+export interface DockPortalAttrs {
+    "data-glass-dock-portal"?: string;
+    "data-glass-dock-owner"?: string;
+}
+export interface DockParticipation {
+    /** Spread onto the portalled content root. Empty outside a dock. */
+    portalAttrs: ComputedRef<DockPortalAttrs>;
+    /** `true` while this surface holds the dock open. */
+    readonly isHeld: Readonly<Ref<boolean>>;
+    hold: () => void;
+    release: () => void;
+}
+/**
+ * Dock participation for a portalled overlay: the stamp, and the one token.
+ *
+ * `hold` is the DECLARATIVE arm — pass a ref/getter that is true exactly while
+ * the surface should pin the dock open and the token is driven for you. The
+ * imperative `hold()`/`release()` remain for a caller with an edge rather than a
+ * state (the pointer-hold path).
+ */
+export declare function useDockParticipation(o?: {
+    hold?: MaybeRefOrGetter<boolean>;
+    kind?: DockHoldKind;
+}): DockParticipation;