@mkbabb/glass-ui 7.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-SFqDQ65h.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

@@ -16,7 +16,10 @@ export type Motion = (typeof MOTIONS)[number];
 /** 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). */

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

@@ -14,7 +14,7 @@ export type ClassValue = string | number | false | null | undefined | ClassValue
  * 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).

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/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/{fieldControl.d.ts → field/control.d.ts}

@@ -5,7 +5,7 @@ export declare function useFieldControlState(props: {
     invalid?: boolean;
     readonly?: boolean;
 }, attrs: Record<string, unknown>): {
-    ariaInvalid: import("vue").ComputedRef<"grammar" | "spelling" | (boolean | "true" | "false") | undefined>;
+    ariaInvalid: import("vue").ComputedRef<(boolean | "true" | "false") | "grammar" | "spelling" | undefined>;
     forwardedAttrs: import("vue").ComputedRef<{
         [x: string]: unknown;
     }>;

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,2 +1,2 @@
-export { controlSizeClass } from "./control-size";
-export type { ControlSize } from "./control-size";
+export { controlSizeClass } from "./control.js";
+export type { ControlSize } from "./control.js";

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

@@ -1,4 +1,4 @@
-import type { SelectionValue } from "./selection";
+import type { SelectionValue } from "./selection.js";
 /** Pointer interaction dispatched outside dismissable floating content. */
 export type PointerDownOutsideEvent = CustomEvent<{
     originalEvent: PointerEvent;

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;

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

@@ -0,0 +1,22 @@
+import type { Placement } from "../axes.js";
+/**
+ * The placement TYPES, and nothing else.
+ *
+ * This file is what is left of `_shared/floating.ts` after the 38-entry
+ * retired-attribute denylist died (#19 W-SHIM-PURGE): four type
+ * declarations that every portalled surface's props extend. It moves here
+ * because the types belong beside the seam that consumes them
+ * (`overlayContentAttrs`), not in a `_shared/` root that no longer has a
+ * runtime half to justify its own file.
+ */
+/** Edge used to place floating content relative to its trigger. */
+export type FloatingSide = Exclude<Placement, "center">;
+/** Cross-axis alignment of floating content against its trigger. */
+export type FloatingAlign = "start" | "center" | "end";
+/** Placement controls intentionally shared by Glass floating surfaces. */
+export interface FloatingPlacementProps {
+    side?: FloatingSide;
+    sideOffset?: number;
+    align?: FloatingAlign;
+    alignOffset?: number;
+}

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

@@ -1,3 +1,5 @@
+import type { HTMLAttributes, InputHTMLAttributes } from "vue";
+import type { FocusOutsideEvent, ListboxItemSelectEvent, PointerDownOutsideEvent } from "./interaction.js";
 /** Stable scalar identity used by Glass selection controls. */
 export type SelectionValue = string | number;
 /** Checkbox state, including the mixed state exposed through ARIA. */
@@ -5,3 +7,40 @@ export type CheckedState = boolean | "indeterminate";
 /** Cardinality of a Glass selection model. */
 export type SelectionMode = "single" | "multiple";
 export declare function isSelectionValue(value: unknown): value is SelectionValue;
+/** Stable scalar selection, with `null` representing no single selection. */
+export type ComboboxValue = SelectionValue | null;
+export interface ComboboxInputProps {
+    modelValue?: string;
+    autoFocus?: boolean;
+    disabled?: boolean;
+    placeholder?: InputHTMLAttributes["placeholder"];
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxInputEmits {
+    "update:modelValue": [value: string];
+}
+export interface ComboboxItemProps {
+    value: SelectionValue;
+    disabled?: boolean;
+    textValue?: string;
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxItemEmits {
+    select: [event: ListboxItemSelectEvent<SelectionValue>];
+}
+export interface ComboboxGroupProps {
+    heading?: string;
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxEmptyProps {
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxListEmits {
+    escapeKeyDown: [event: KeyboardEvent];
+    pointerDownOutside: [event: PointerDownOutsideEvent];
+    focusOutside: [event: FocusOutsideEvent];
+    interactOutside: [event: PointerDownOutsideEvent | FocusOutsideEvent];
+}
+export interface ComboboxSeparatorProps {
+    class?: HTMLAttributes["class"];
+}