@ecoma-io/loom 0.2.0 → 0.4.0

package/dist/packages/primitives/list/src/index.js

@@ -0,0 +1,3 @@
+import List_default from "./List.js";
+import ListItem_default from "./ListItem.js";
+export { List_default as List, ListItem_default as ListItem };

package/dist/packages/primitives/menubar/src/Menubar.js

@@ -0,0 +1,7 @@
+import Menubar_vue_vue_type_script_setup_true_lang_default from "./Menubar.vue_vue_type_script_setup_true_lang.js";
+//#region packages/primitives/menubar/src/Menubar.vue
+var Menubar_default = Menubar_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { Menubar_default as default };
+
+//# sourceMappingURL=Menubar.js.map

package/dist/packages/primitives/menubar/src/Menubar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menubar.js","names":[],"sources":["../../../../../packages/primitives/menubar/src/Menubar.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Menubar — the classic desktop-app menu strip (File · View · Help …).\n *\n * Data-driven: pass a `menus` array; the component owns open/close, hover-to-switch,\n * keyboard nav and click-outside. Selecting an item emits `select` with its `command`\n * id — the host maps that id to an action (keeps the primitive free of app logic).\n *\n * A11y: WAI-ARIA menubar semantics over real DOM focus, not aria-activedescendant.\n * Opening a menu moves focus onto its first enabled row and the arrows walk it from\n * there, so \"the highlighted row\" and \"the focused row\" are the same thing by\n * construction and a screen reader announces each walked row natively — no\n * bookkeeping that could drift out of sync with what is actually announced.\n */\nexport interface MenubarItem {\n  /** Visible label. */\n  label: string;\n  /** Command id emitted on select. Omit for a non-actionable row. */\n  command?: string;\n  /** Right-aligned accelerator hint, e.g. \"Ctrl+S\". */\n  shortcut?: string;\n  /** Render a divider instead of an item (label ignored). */\n  separator?: boolean;\n  disabled?: boolean;\n}\n\nexport interface MenubarMenu {\n  id: string;\n  label: string;\n  items: MenubarItem[];\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, onBeforeUnmount, onMounted, ref, nextTick } from \"vue\";\nimport { listStaggerDelay } from \"@ecoma-io/loom-core\";\n\nconst props = defineProps<{\n  /** The top-level menus; their reading order follows `dir`. */\n  menus: MenubarMenu[];\n  /**\n   * Reading direction. Right-to-left mirrors the strip's arrow keys —\n   * ArrowRight travels toward the visual left — which a hand-rolled\n   * handler must do itself, unlike its Reka siblings.\n   */\n  dir?: \"ltr\" | \"rtl\";\n}>();\nconst emit = defineEmits<{ select: [command: string] }>();\n\n// Horizontal arrows are visual, not logical: in right-to-left, ArrowRight\n// moves toward the previous menu.\nconst horizontal = computed(() => (props.dir === \"rtl\" ? -1 : 1) as 1 | -1);\n\nconst openId = ref<string | null>(null);\nconst activeIndex = ref(-1); // the focused row within the open menu\n// String refs would do here only outside a v-for; inside one Vue collects them\n// into arrays. Function refs keyed BY MENU ID instead: during a menu switch the\n// incoming panel can mount before the outgoing one unmounts, so a single\n// latest-wins slot would let the outgoing null clobber the just-bound element.\nconst panelEls = new Map<string, HTMLElement>();\nconst triggerEls = new Map<string, HTMLButtonElement>();\n\nfunction bindPanel(id: string, el: unknown): void {\n  if (el instanceof HTMLElement) panelEls.set(id, el);\n  else panelEls.delete(id);\n}\n\nfunction bindTrigger(id: string, el: unknown): void {\n  if (el instanceof HTMLButtonElement) triggerEls.set(id, el);\n  else triggerEls.delete(id);\n}\n\nfunction boundPanel(): HTMLElement | null {\n  return openId.value ? (panelEls.get(openId.value) ?? null) : null;\n}\n\nconst openMenu = (menu: MenubarMenu | undefined) => menu?.items ?? [];\nconst firstEnabled = (items: MenubarItem[], from = 0, dir = 1): number => {\n  for (let i = from; i >= 0 && i < items.length; i += dir) {\n    const item = items[i];\n    if (item && !item.separator && !item.disabled) return i;\n  }\n  return -1;\n};\n\n/** One arrow-step away from `from`, wrapping through every slot exactly once. */\nfunction neighborEnabled(items: MenubarItem[], from: number, dir: 1 | -1): number {\n  const n = items.length;\n  for (let step = 1; step <= n; step++) {\n    const i = (((from + dir * step) % n) + n) % n;\n    const item = items[i];\n    if (item && !item.separator && !item.disabled) return i;\n  }\n  return -1;\n}\n\n/** Rows render only for non-separator items, so an item index maps to its button's ordinal among the rendered ones. */\nfunction rowOrdinal(items: MenubarItem[], index: number): number {\n  let ordinal = -1;\n  for (let k = 0; k <= index && k < items.length; k++) {\n    if (!items[k]?.separator) ordinal++;\n  }\n  return ordinal;\n}\n\nfunction rowButtons(): HTMLButtonElement[] {\n  const panel = boundPanel();\n  return panel\n    ? Array.from(panel.querySelectorAll<HTMLButtonElement>('button[role=\"menuitem\"]'))\n    : [];\n}\n\nfunction focusRow(items: MenubarItem[], index: number): void {\n  rowButtons()[rowOrdinal(items, index)]?.focus();\n}\n\nfunction goTo(items: MenubarItem[], index: number): void {\n  if (index < 0) return;\n  activeIndex.value = index;\n  focusRow(items, index);\n}\n\nasync function openAndFocusFirst(id: string, items: MenubarItem[]): Promise<void> {\n  await nextTick();\n  // A hover or another key can supersede this open within the same tick; only\n  // the menu that still owns `openId` may claim focus.\n  if (openId.value !== id) return;\n  goTo(items, firstEnabled(items));\n}\n\nasync function toggle(id: string): Promise<void> {\n  if (openId.value === id) {\n    close(true);\n    return;\n  }\n  const menu = props.menus.find((m) => m.id === id);\n  if (!menu) return;\n  openId.value = id;\n  activeIndex.value = -1;\n  await openAndFocusFirst(id, menu.items);\n}\n\nasync function hover(id: string, via: \"pointer\" | \"trigger-focus\"): Promise<void> {\n  if (openId.value === null || openId.value === id) return;\n  const menu = props.menus.find((m) => m.id === id);\n  if (!menu) return;\n  openId.value = id;\n  activeIndex.value = -1;\n  // Pointer switching takes focus into the new menu like a desktop menubar.\n  // A switch caused by tabbing between triggers must not yank focus out of\n  // the tab order mid-Tab, so it switches the panel and leaves focus alone.\n  if (via === \"pointer\") await openAndFocusFirst(id, menu.items);\n}\n\nfunction choose(item: MenubarItem): void {\n  if (item.separator || item.disabled) return;\n  close(true);\n  if (item.command) emit(\"select\", item.command);\n}\n\nfunction close(restoreFocus = false): void {\n  const id = openId.value;\n  openId.value = null;\n  activeIndex.value = -1;\n  // Escape and selection hand focus back to the owning trigger; Tab-out and\n  // outside clicks do not — focus has already gone where the user sent it.\n  if (restoreFocus && id) triggerEls.get(id)?.focus();\n}\n\nasync function moveMenu(dir: 1 | -1): Promise<void> {\n  const ids = props.menus.map((m) => m.id);\n  const cur = openId.value ? ids.indexOf(openId.value) : 0;\n  const id = ids[(cur + dir + ids.length) % ids.length];\n  const menu = props.menus.find((m) => m.id === id);\n  if (!menu) return;\n  openId.value = menu.id;\n  activeIndex.value = -1;\n  await openAndFocusFirst(menu.id, menu.items);\n}\n\n/**\n * Pointer highlight of an enabled row moves focus with it — under the roving\n * model the highlighted row IS the focused row, and screen readers announce\n * focus changes, not CSS classes.\n */\nfunction pointAtRow(items: MenubarItem[], item: MenubarItem, index: number): void {\n  if (item.disabled || item.separator || activeIndex.value === index) return;\n  activeIndex.value = index;\n  focusRow(items, index);\n}\n\n/** Native focus landing on a row keeps `activeIndex` truthful about it. */\nfunction noteFocus(item: MenubarItem, index: number): void {\n  if (item.disabled || item.separator) return;\n  activeIndex.value = index;\n}\n\n/**\n * The APG's closed-state traversal: Left/Right across the strip land on the\n * neighbouring trigger without opening anything — opening is ArrowDown,\n * Enter or Space's job.\n */\nfunction moveTriggerFocus(from: string, dir: 1 | -1): void {\n  const ids = props.menus.map((m) => m.id);\n  const cur = ids.indexOf(from);\n  if (cur === -1) return;\n  triggerEls.get(ids[(cur + dir + ids.length) % ids.length] ?? \"\")?.focus();\n}\n\nasync function onTriggerKeydown(e: KeyboardEvent, menu: MenubarMenu): Promise<void> {\n  switch (e.key) {\n    case \"ArrowDown\":\n    case \"Enter\":\n    case \" \":\n      e.preventDefault(); // suppresses the button's own activation click\n      openId.value = menu.id;\n      activeIndex.value = -1;\n      await openAndFocusFirst(menu.id, menu.items);\n      break;\n    case \"ArrowRight\":\n      e.preventDefault();\n      if (openId.value) void moveMenu(horizontal.value);\n      else moveTriggerFocus(menu.id, horizontal.value);\n      break;\n    case \"ArrowLeft\":\n      e.preventDefault();\n      if (openId.value) void moveMenu(-horizontal.value as 1 | -1);\n      else moveTriggerFocus(menu.id, -horizontal.value as 1 | -1);\n      break;\n    case \"Escape\":\n      e.preventDefault();\n      close(true);\n      break;\n  }\n}\n\nfunction onMenuKeydown(e: KeyboardEvent, menu: MenubarMenu): void {\n  const items = menu.items;\n  switch (e.key) {\n    case \"ArrowDown\":\n      e.preventDefault();\n      goTo(items, neighborEnabled(items, activeIndex.value, 1));\n      break;\n    case \"ArrowUp\":\n      e.preventDefault();\n      goTo(items, neighborEnabled(items, activeIndex.value, -1));\n      break;\n    case \"Home\":\n      e.preventDefault();\n      goTo(items, firstEnabled(items, 0, 1));\n      break;\n    case \"End\":\n      e.preventDefault();\n      goTo(items, firstEnabled(items, items.length - 1, -1));\n      break;\n    case \"ArrowRight\":\n      e.preventDefault();\n      void moveMenu(horizontal.value);\n      break;\n    case \"ArrowLeft\":\n      e.preventDefault();\n      void moveMenu(-horizontal.value as 1 | -1);\n      break;\n    // Handled here rather than left to the button's native activation:\n    // preventDefault stops the browser's synthesized click, which would run\n    // choose() a second time alongside this delegated handler.\n    case \"Enter\":\n    case \" \": {\n      e.preventDefault();\n      const item = items[activeIndex.value];\n      if (item) choose(item);\n      break;\n    }\n    case \"Escape\":\n      e.preventDefault();\n      close(true);\n      break;\n  }\n}\n\nfunction onRootFocusout(e: FocusEvent): void {\n  if (!openId.value) return;\n  const root = e.currentTarget;\n  const next = e.relatedTarget;\n  // Tab out of the strip dismisses the menu and leaves focus where the browser\n  // put it. Moves that stay inside the menubar (opening handing focus to a\n  // row) keep it.\n  if (!(root instanceof Element) || !(next instanceof Node) || !root.contains(next)) close();\n}\n\n// A wrapper, not `close` itself: the listener's event argument would otherwise\n// arrive as `restoreFocus`, and an outside click would yank focus back to the\n// trigger instead of leaving it where the press landed.\nconst onWindowClick = (): void => close();\nonMounted(() => window.addEventListener(\"click\", onWindowClick));\nonBeforeUnmount(() => window.removeEventListener(\"click\", onWindowClick));\n</script>\n\n<template>\n  <!-- The attribute rides the strip itself, not just the prop: a host may\n       pass dir without setting document direction, and both the flex order\n       and the mirrored keys must agree with what is on screen. -->\n  <div\n    :dir=\"dir\"\n    role=\"menubar\"\n    class=\"flex items-center gap-0.5\"\n    style=\"-webkit-app-region: no-drag\"\n    @click.stop\n    @focusout=\"onRootFocusout\"\n  >\n    <div v-for=\"menu in menus\" :key=\"menu.id\" class=\"relative\">\n      <button\n        :id=\"`menubar-trigger-${menu.id}`\"\n        :ref=\"(el) => bindTrigger(menu.id, el)\"\n        type=\"button\"\n        role=\"menuitem\"\n        :aria-haspopup=\"'menu'\"\n        :aria-expanded=\"openId === menu.id\"\n        class=\"min-h-6 rounded-sm px-2 py-1 text-xs text-muted-foreground transition-colors duration-fast ease-out hover:bg-subtle hover:text-foreground focus-visible:bg-subtle focus-visible:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo\"\n        :class=\"openId === menu.id && 'bg-subtle text-foreground'\"\n        @click.stop=\"toggle(menu.id)\"\n        @mouseenter=\"hover(menu.id, 'pointer')\"\n        @focus=\"hover(menu.id, 'trigger-focus')\"\n        @keydown=\"onTriggerKeydown($event, menu)\"\n      >\n        {{ menu.label }}\n      </button>\n\n      <!-- Scoped presence, matching every sibling overlay: enter animates in,\n           leave answers with scale-out. The unconditional mount-only animation\n           this used to carry never plays on close at all. In jsdom, with no\n           stylesheet loaded, Vue computes zero animation duration and ends both\n           phases immediately, so tests see plain unmount. -->\n      <Transition enter-active-class=\"animate-scale-in\" leave-active-class=\"animate-scale-out\">\n        <div\n          v-if=\"openId === menu.id\"\n          :ref=\"(el) => bindPanel(menu.id, el)\"\n          role=\"menu\"\n          :aria-label=\"menu.label\"\n          tabindex=\"-1\"\n          class=\"absolute left-0 top-full z-overlay mt-1 min-w-[13rem] origin-top-left rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-md\"\n          @click.stop\n          @keydown=\"onMenuKeydown($event, menu)\"\n        >\n          <template v-for=\"(item, i) in openMenu(menu)\" :key=\"i\">\n            <div v-if=\"item.separator\" role=\"separator\" class=\"my-1 h-px bg-border\" />\n            <!-- The row's colour, not its alpha, says it is unavailable. A menu\n                 row is nothing but its label, and `disabled:opacity-40` composited\n                 that label to 2.40:1 on the popover — a disabled row a reader\n                 cannot make out tells them nothing about what is unavailable,\n                 which is the only thing it is there to say. Muted instead: 5.76:1\n                 at rest, and a clear drop from the 15.46:1 an available row wears,\n                 so the state still reads at a glance. The shortcut beside it\n                 declares `text-muted-foreground` on its own element, so it lands\n                 on the same colour rather than inheriting this one.\n\n                 Rows sit at text-sm/py-1.5 like DropdownMenu's — one row grammar\n                 across menus; the compact trigger above stays desktop chrome.\n                 Every row carries tabindex -1: focus arrives programmatically,\n                 never by tabbing through the strip. -->\n            <button\n              v-else\n              type=\"button\"\n              role=\"menuitem\"\n              tabindex=\"-1\"\n              :disabled=\"item.disabled\"\n              :data-highlighted=\"activeIndex === i || undefined\"\n              :style=\"{ animationDelay: listStaggerDelay(i) }\"\n              class=\"flex w-full items-center justify-between gap-6 rounded-sm px-2 py-1.5 text-left text-sm text-foreground transition-colors duration-fast ease-out hover:bg-subtle disabled:pointer-events-none disabled:text-muted-foreground data-[highlighted]:bg-subtle focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo animate-fade-rise\"\n              @click=\"choose(item)\"\n              @mouseenter=\"pointAtRow(openMenu(menu), item, i)\"\n              @focus=\"noteFocus(item, i)\"\n            >\n              <span>{{ item.label }}</span>\n              <span v-if=\"item.shortcut\" class=\"tabular text-micro text-muted-foreground\">\n                {{ item.shortcut }}\n              </span>\n            </button>\n          </template>\n        </div>\n      </Transition>\n    </div>\n  </div>\n</template>\n"],"mappings":""}

package/dist/packages/primitives/menubar/src/Menubar.vue.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Menubar — the classic desktop-app menu strip (File · View · Help …).
+ *
+ * Data-driven: pass a `menus` array; the component owns open/close, hover-to-switch,
+ * keyboard nav and click-outside. Selecting an item emits `select` with its `command`
+ * id — the host maps that id to an action (keeps the primitive free of app logic).
+ *
+ * A11y: WAI-ARIA menubar semantics over real DOM focus, not aria-activedescendant.
+ * Opening a menu moves focus onto its first enabled row and the arrows walk it from
+ * there, so "the highlighted row" and "the focused row" are the same thing by
+ * construction and a screen reader announces each walked row natively — no
+ * bookkeeping that could drift out of sync with what is actually announced.
+ */
+export interface MenubarItem {
+    /** Visible label. */
+    label: string;
+    /** Command id emitted on select. Omit for a non-actionable row. */
+    command?: string;
+    /** Right-aligned accelerator hint, e.g. "Ctrl+S". */
+    shortcut?: string;
+    /** Render a divider instead of an item (label ignored). */
+    separator?: boolean;
+    disabled?: boolean;
+}
+export interface MenubarMenu {
+    id: string;
+    label: string;
+    items: MenubarItem[];
+}
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    /** The top-level menus; their reading order follows `dir`. */
+    menus: MenubarMenu[];
+    /**
+     * Reading direction. Right-to-left mirrors the strip's arrow keys —
+     * ArrowRight travels toward the visual left — which a hand-rolled
+     * handler must do itself, unlike its Reka siblings.
+     */
+    dir?: "ltr" | "rtl";
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (command: string) => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /** The top-level menus; their reading order follows `dir`. */
+    menus: MenubarMenu[];
+    /**
+     * Reading direction. Right-to-left mirrors the strip's arrow keys —
+     * ArrowRight travels toward the visual left — which a hand-rolled
+     * handler must do itself, unlike its Reka siblings.
+     */
+    dir?: "ltr" | "rtl";
+}> & Readonly<{
+    onSelect?: (command: string) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+//# sourceMappingURL=Menubar.vue.d.ts.map

package/dist/packages/primitives/menubar/src/Menubar.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menubar.vue.d.ts","sourceRoot":"","sources":["../../../../../packages/primitives/menubar/src/Menubar.vue"],"names":[],"mappings":"AAuYA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;wBACoB,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAEhB,8DAA8D;WACvD,WAAW,EAAE;IACpB;;;;OAIG;UACG,KAAK,GAAG,KAAK;;;;IAPnB,8DAA8D;WACvD,WAAW,EAAE;IACpB;;;;OAIG;UACG,KAAK,GAAG,KAAK;;;kFA2ejB,CAAC"}

package/dist/packages/primitives/menubar/src/Menubar.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,299 @@
+import { listStaggerDelay } from "../../../core/src/motion.js";
+import "../../../core/src/index.js";
+import { Fragment, Transition, computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, nextTick, normalizeClass, normalizeStyle, onBeforeUnmount, onMounted, openBlock, ref, renderList, toDisplayString, unref, withCtx, withModifiers } from "vue";
+//#region packages/primitives/menubar/src/Menubar.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["dir"];
+var _hoisted_2 = [
+	"id",
+	"aria-expanded",
+	"onClick",
+	"onMouseenter",
+	"onFocus",
+	"onKeydown"
+];
+var _hoisted_3 = ["aria-label", "onKeydown"];
+var _hoisted_4 = {
+	key: 0,
+	role: "separator",
+	class: "my-1 h-px bg-border"
+};
+var _hoisted_5 = [
+	"disabled",
+	"data-highlighted",
+	"onClick",
+	"onMouseenter",
+	"onFocus"
+];
+var _hoisted_6 = {
+	key: 0,
+	class: "tabular text-micro text-muted-foreground"
+};
+var Menubar_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "Menubar",
+	props: {
+		menus: {},
+		dir: {}
+	},
+	emits: ["select"],
+	setup(__props, { emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const horizontal = computed(() => props.dir === "rtl" ? -1 : 1);
+		const openId = ref(null);
+		const activeIndex = ref(-1);
+		const panelEls = /* @__PURE__ */ new Map();
+		const triggerEls = /* @__PURE__ */ new Map();
+		function bindPanel(id, el) {
+			if (el instanceof HTMLElement) panelEls.set(id, el);
+			else panelEls.delete(id);
+		}
+		function bindTrigger(id, el) {
+			if (el instanceof HTMLButtonElement) triggerEls.set(id, el);
+			else triggerEls.delete(id);
+		}
+		function boundPanel() {
+			return openId.value ? panelEls.get(openId.value) ?? null : null;
+		}
+		const openMenu = (menu) => menu?.items ?? [];
+		const firstEnabled = (items, from = 0, dir = 1) => {
+			for (let i = from; i >= 0 && i < items.length; i += dir) {
+				const item = items[i];
+				if (item && !item.separator && !item.disabled) return i;
+			}
+			return -1;
+		};
+		/** One arrow-step away from `from`, wrapping through every slot exactly once. */
+		function neighborEnabled(items, from, dir) {
+			const n = items.length;
+			for (let step = 1; step <= n; step++) {
+				const i = ((from + dir * step) % n + n) % n;
+				const item = items[i];
+				if (item && !item.separator && !item.disabled) return i;
+			}
+			return -1;
+		}
+		/** Rows render only for non-separator items, so an item index maps to its button's ordinal among the rendered ones. */
+		function rowOrdinal(items, index) {
+			let ordinal = -1;
+			for (let k = 0; k <= index && k < items.length; k++) if (!items[k]?.separator) ordinal++;
+			return ordinal;
+		}
+		function rowButtons() {
+			const panel = boundPanel();
+			return panel ? Array.from(panel.querySelectorAll("button[role=\"menuitem\"]")) : [];
+		}
+		function focusRow(items, index) {
+			rowButtons()[rowOrdinal(items, index)]?.focus();
+		}
+		function goTo(items, index) {
+			if (index < 0) return;
+			activeIndex.value = index;
+			focusRow(items, index);
+		}
+		async function openAndFocusFirst(id, items) {
+			await nextTick();
+			if (openId.value !== id) return;
+			goTo(items, firstEnabled(items));
+		}
+		async function toggle(id) {
+			if (openId.value === id) {
+				close(true);
+				return;
+			}
+			const menu = props.menus.find((m) => m.id === id);
+			if (!menu) return;
+			openId.value = id;
+			activeIndex.value = -1;
+			await openAndFocusFirst(id, menu.items);
+		}
+		async function hover(id, via) {
+			if (openId.value === null || openId.value === id) return;
+			const menu = props.menus.find((m) => m.id === id);
+			if (!menu) return;
+			openId.value = id;
+			activeIndex.value = -1;
+			if (via === "pointer") await openAndFocusFirst(id, menu.items);
+		}
+		function choose(item) {
+			if (item.separator || item.disabled) return;
+			close(true);
+			if (item.command) emit("select", item.command);
+		}
+		function close(restoreFocus = false) {
+			const id = openId.value;
+			openId.value = null;
+			activeIndex.value = -1;
+			if (restoreFocus && id) triggerEls.get(id)?.focus();
+		}
+		async function moveMenu(dir) {
+			const ids = props.menus.map((m) => m.id);
+			const id = ids[((openId.value ? ids.indexOf(openId.value) : 0) + dir + ids.length) % ids.length];
+			const menu = props.menus.find((m) => m.id === id);
+			if (!menu) return;
+			openId.value = menu.id;
+			activeIndex.value = -1;
+			await openAndFocusFirst(menu.id, menu.items);
+		}
+		/**
+		* Pointer highlight of an enabled row moves focus with it — under the roving
+		* model the highlighted row IS the focused row, and screen readers announce
+		* focus changes, not CSS classes.
+		*/
+		function pointAtRow(items, item, index) {
+			if (item.disabled || item.separator || activeIndex.value === index) return;
+			activeIndex.value = index;
+			focusRow(items, index);
+		}
+		/** Native focus landing on a row keeps `activeIndex` truthful about it. */
+		function noteFocus(item, index) {
+			if (item.disabled || item.separator) return;
+			activeIndex.value = index;
+		}
+		/**
+		* The APG's closed-state traversal: Left/Right across the strip land on the
+		* neighbouring trigger without opening anything — opening is ArrowDown,
+		* Enter or Space's job.
+		*/
+		function moveTriggerFocus(from, dir) {
+			const ids = props.menus.map((m) => m.id);
+			const cur = ids.indexOf(from);
+			if (cur === -1) return;
+			triggerEls.get(ids[(cur + dir + ids.length) % ids.length] ?? "")?.focus();
+		}
+		async function onTriggerKeydown(e, menu) {
+			switch (e.key) {
+				case "ArrowDown":
+				case "Enter":
+				case " ":
+					e.preventDefault();
+					openId.value = menu.id;
+					activeIndex.value = -1;
+					await openAndFocusFirst(menu.id, menu.items);
+					break;
+				case "ArrowRight":
+					e.preventDefault();
+					if (openId.value) moveMenu(horizontal.value);
+					else moveTriggerFocus(menu.id, horizontal.value);
+					break;
+				case "ArrowLeft":
+					e.preventDefault();
+					if (openId.value) moveMenu(-horizontal.value);
+					else moveTriggerFocus(menu.id, -horizontal.value);
+					break;
+				case "Escape":
+					e.preventDefault();
+					close(true);
+			}
+		}
+		function onMenuKeydown(e, menu) {
+			const items = menu.items;
+			switch (e.key) {
+				case "ArrowDown":
+					e.preventDefault();
+					goTo(items, neighborEnabled(items, activeIndex.value, 1));
+					break;
+				case "ArrowUp":
+					e.preventDefault();
+					goTo(items, neighborEnabled(items, activeIndex.value, -1));
+					break;
+				case "Home":
+					e.preventDefault();
+					goTo(items, firstEnabled(items, 0, 1));
+					break;
+				case "End":
+					e.preventDefault();
+					goTo(items, firstEnabled(items, items.length - 1, -1));
+					break;
+				case "ArrowRight":
+					e.preventDefault();
+					moveMenu(horizontal.value);
+					break;
+				case "ArrowLeft":
+					e.preventDefault();
+					moveMenu(-horizontal.value);
+					break;
+				case "Enter":
+				case " ": {
+					e.preventDefault();
+					const item = items[activeIndex.value];
+					if (item) choose(item);
+					break;
+				}
+				case "Escape":
+					e.preventDefault();
+					close(true);
+			}
+		}
+		function onRootFocusout(e) {
+			if (!openId.value) return;
+			const root = e.currentTarget;
+			const next = e.relatedTarget;
+			if (!(root instanceof Element) || !(next instanceof Node) || !root.contains(next)) close();
+		}
+		const onWindowClick = () => close();
+		onMounted(() => window.addEventListener("click", onWindowClick));
+		onBeforeUnmount(() => window.removeEventListener("click", onWindowClick));
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", {
+				dir: __props.dir,
+				role: "menubar",
+				class: "flex items-center gap-0.5",
+				style: { "-webkit-app-region": "no-drag" },
+				onClick: _cache[1] || (_cache[1] = withModifiers(() => {}, ["stop"])),
+				onFocusout: onRootFocusout
+			}, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.menus, (menu) => {
+				return openBlock(), createElementBlock("div", {
+					key: menu.id,
+					class: "relative"
+				}, [createElementVNode("button", {
+					id: `menubar-trigger-${menu.id}`,
+					ref_for: true,
+					ref: (el) => bindTrigger(menu.id, el),
+					type: "button",
+					role: "menuitem",
+					"aria-haspopup": "menu",
+					"aria-expanded": openId.value === menu.id,
+					class: normalizeClass(["min-h-6 rounded-sm px-2 py-1 text-xs text-muted-foreground transition-colors duration-fast ease-out hover:bg-subtle hover:text-foreground focus-visible:bg-subtle focus-visible:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo", openId.value === menu.id && "bg-subtle text-foreground"]),
+					onClick: withModifiers(($event) => toggle(menu.id), ["stop"]),
+					onMouseenter: ($event) => hover(menu.id, "pointer"),
+					onFocus: ($event) => hover(menu.id, "trigger-focus"),
+					onKeydown: ($event) => onTriggerKeydown($event, menu)
+				}, toDisplayString(menu.label), 43, _hoisted_2), createVNode(Transition, {
+					"enter-active-class": "animate-scale-in",
+					"leave-active-class": "animate-scale-out"
+				}, {
+					default: withCtx(() => [openId.value === menu.id ? (openBlock(), createElementBlock("div", {
+						key: 0,
+						ref_for: true,
+						ref: (el) => bindPanel(menu.id, el),
+						role: "menu",
+						"aria-label": menu.label,
+						tabindex: "-1",
+						class: "absolute left-0 top-full z-overlay mt-1 min-w-[13rem] origin-top-left rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-md",
+						onClick: _cache[0] || (_cache[0] = withModifiers(() => {}, ["stop"])),
+						onKeydown: ($event) => onMenuKeydown($event, menu)
+					}, [(openBlock(true), createElementBlock(Fragment, null, renderList(openMenu(menu), (item, i) => {
+						return openBlock(), createElementBlock(Fragment, { key: i }, [item.separator ? (openBlock(), createElementBlock("div", _hoisted_4)) : (openBlock(), createElementBlock("button", {
+							key: 1,
+							type: "button",
+							role: "menuitem",
+							tabindex: "-1",
+							disabled: item.disabled,
+							"data-highlighted": activeIndex.value === i || void 0,
+							style: normalizeStyle({ animationDelay: unref(listStaggerDelay)(i) }),
+							class: "flex w-full items-center justify-between gap-6 rounded-sm px-2 py-1.5 text-left text-sm text-foreground transition-colors duration-fast ease-out hover:bg-subtle disabled:pointer-events-none disabled:text-muted-foreground data-[highlighted]:bg-subtle focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo animate-fade-rise",
+							onClick: ($event) => choose(item),
+							onMouseenter: ($event) => pointAtRow(openMenu(menu), item, i),
+							onFocus: ($event) => noteFocus(item, i)
+						}, [createElementVNode("span", null, toDisplayString(item.label), 1), item.shortcut ? (openBlock(), createElementBlock("span", _hoisted_6, toDisplayString(item.shortcut), 1)) : createCommentVNode("", true)], 44, _hoisted_5))], 64);
+					}), 128))], 40, _hoisted_3)) : createCommentVNode("", true)]),
+					_: 2
+				}, 1024)]);
+			}), 128))], 40, _hoisted_1);
+		};
+	}
+});
+//#endregion
+export { Menubar_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=Menubar.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/primitives/menubar/src/Menubar.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menubar.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../../packages/primitives/menubar/src/Menubar.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Menubar — the classic desktop-app menu strip (File · View · Help …).\n *\n * Data-driven: pass a `menus` array; the component owns open/close, hover-to-switch,\n * keyboard nav and click-outside. Selecting an item emits `select` with its `command`\n * id — the host maps that id to an action (keeps the primitive free of app logic).\n *\n * A11y: WAI-ARIA menubar semantics over real DOM focus, not aria-activedescendant.\n * Opening a menu moves focus onto its first enabled row and the arrows walk it from\n * there, so \"the highlighted row\" and \"the focused row\" are the same thing by\n * construction and a screen reader announces each walked row natively — no\n * bookkeeping that could drift out of sync with what is actually announced.\n */\nexport interface MenubarItem {\n  /** Visible label. */\n  label: string;\n  /** Command id emitted on select. Omit for a non-actionable row. */\n  command?: string;\n  /** Right-aligned accelerator hint, e.g. \"Ctrl+S\". */\n  shortcut?: string;\n  /** Render a divider instead of an item (label ignored). */\n  separator?: boolean;\n  disabled?: boolean;\n}\n\nexport interface MenubarMenu {\n  id: string;\n  label: string;\n  items: MenubarItem[];\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, onBeforeUnmount, onMounted, ref, nextTick } from \"vue\";\nimport { listStaggerDelay } from \"@ecoma-io/loom-core\";\n\nconst props = defineProps<{\n  /** The top-level menus; their reading order follows `dir`. */\n  menus: MenubarMenu[];\n  /**\n   * Reading direction. Right-to-left mirrors the strip's arrow keys —\n   * ArrowRight travels toward the visual left — which a hand-rolled\n   * handler must do itself, unlike its Reka siblings.\n   */\n  dir?: \"ltr\" | \"rtl\";\n}>();\nconst emit = defineEmits<{ select: [command: string] }>();\n\n// Horizontal arrows are visual, not logical: in right-to-left, ArrowRight\n// moves toward the previous menu.\nconst horizontal = computed(() => (props.dir === \"rtl\" ? -1 : 1) as 1 | -1);\n\nconst openId = ref<string | null>(null);\nconst activeIndex = ref(-1); // the focused row within the open menu\n// String refs would do here only outside a v-for; inside one Vue collects them\n// into arrays. Function refs keyed BY MENU ID instead: during a menu switch the\n// incoming panel can mount before the outgoing one unmounts, so a single\n// latest-wins slot would let the outgoing null clobber the just-bound element.\nconst panelEls = new Map<string, HTMLElement>();\nconst triggerEls = new Map<string, HTMLButtonElement>();\n\nfunction bindPanel(id: string, el: unknown): void {\n  if (el instanceof HTMLElement) panelEls.set(id, el);\n  else panelEls.delete(id);\n}\n\nfunction bindTrigger(id: string, el: unknown): void {\n  if (el instanceof HTMLButtonElement) triggerEls.set(id, el);\n  else triggerEls.delete(id);\n}\n\nfunction boundPanel(): HTMLElement | null {\n  return openId.value ? (panelEls.get(openId.value) ?? null) : null;\n}\n\nconst openMenu = (menu: MenubarMenu | undefined) => menu?.items ?? [];\nconst firstEnabled = (items: MenubarItem[], from = 0, dir = 1): number => {\n  for (let i = from; i >= 0 && i < items.length; i += dir) {\n    const item = items[i];\n    if (item && !item.separator && !item.disabled) return i;\n  }\n  return -1;\n};\n\n/** One arrow-step away from `from`, wrapping through every slot exactly once. */\nfunction neighborEnabled(items: MenubarItem[], from: number, dir: 1 | -1): number {\n  const n = items.length;\n  for (let step = 1; step <= n; step++) {\n    const i = (((from + dir * step) % n) + n) % n;\n    const item = items[i];\n    if (item && !item.separator && !item.disabled) return i;\n  }\n  return -1;\n}\n\n/** Rows render only for non-separator items, so an item index maps to its button's ordinal among the rendered ones. */\nfunction rowOrdinal(items: MenubarItem[], index: number): number {\n  let ordinal = -1;\n  for (let k = 0; k <= index && k < items.length; k++) {\n    if (!items[k]?.separator) ordinal++;\n  }\n  return ordinal;\n}\n\nfunction rowButtons(): HTMLButtonElement[] {\n  const panel = boundPanel();\n  return panel\n    ? Array.from(panel.querySelectorAll<HTMLButtonElement>('button[role=\"menuitem\"]'))\n    : [];\n}\n\nfunction focusRow(items: MenubarItem[], index: number): void {\n  rowButtons()[rowOrdinal(items, index)]?.focus();\n}\n\nfunction goTo(items: MenubarItem[], index: number): void {\n  if (index < 0) return;\n  activeIndex.value = index;\n  focusRow(items, index);\n}\n\nasync function openAndFocusFirst(id: string, items: MenubarItem[]): Promise<void> {\n  await nextTick();\n  // A hover or another key can supersede this open within the same tick; only\n  // the menu that still owns `openId` may claim focus.\n  if (openId.value !== id) return;\n  goTo(items, firstEnabled(items));\n}\n\nasync function toggle(id: string): Promise<void> {\n  if (openId.value === id) {\n    close(true);\n    return;\n  }\n  const menu = props.menus.find((m) => m.id === id);\n  if (!menu) return;\n  openId.value = id;\n  activeIndex.value = -1;\n  await openAndFocusFirst(id, menu.items);\n}\n\nasync function hover(id: string, via: \"pointer\" | \"trigger-focus\"): Promise<void> {\n  if (openId.value === null || openId.value === id) return;\n  const menu = props.menus.find((m) => m.id === id);\n  if (!menu) return;\n  openId.value = id;\n  activeIndex.value = -1;\n  // Pointer switching takes focus into the new menu like a desktop menubar.\n  // A switch caused by tabbing between triggers must not yank focus out of\n  // the tab order mid-Tab, so it switches the panel and leaves focus alone.\n  if (via === \"pointer\") await openAndFocusFirst(id, menu.items);\n}\n\nfunction choose(item: MenubarItem): void {\n  if (item.separator || item.disabled) return;\n  close(true);\n  if (item.command) emit(\"select\", item.command);\n}\n\nfunction close(restoreFocus = false): void {\n  const id = openId.value;\n  openId.value = null;\n  activeIndex.value = -1;\n  // Escape and selection hand focus back to the owning trigger; Tab-out and\n  // outside clicks do not — focus has already gone where the user sent it.\n  if (restoreFocus && id) triggerEls.get(id)?.focus();\n}\n\nasync function moveMenu(dir: 1 | -1): Promise<void> {\n  const ids = props.menus.map((m) => m.id);\n  const cur = openId.value ? ids.indexOf(openId.value) : 0;\n  const id = ids[(cur + dir + ids.length) % ids.length];\n  const menu = props.menus.find((m) => m.id === id);\n  if (!menu) return;\n  openId.value = menu.id;\n  activeIndex.value = -1;\n  await openAndFocusFirst(menu.id, menu.items);\n}\n\n/**\n * Pointer highlight of an enabled row moves focus with it — under the roving\n * model the highlighted row IS the focused row, and screen readers announce\n * focus changes, not CSS classes.\n */\nfunction pointAtRow(items: MenubarItem[], item: MenubarItem, index: number): void {\n  if (item.disabled || item.separator || activeIndex.value === index) return;\n  activeIndex.value = index;\n  focusRow(items, index);\n}\n\n/** Native focus landing on a row keeps `activeIndex` truthful about it. */\nfunction noteFocus(item: MenubarItem, index: number): void {\n  if (item.disabled || item.separator) return;\n  activeIndex.value = index;\n}\n\n/**\n * The APG's closed-state traversal: Left/Right across the strip land on the\n * neighbouring trigger without opening anything — opening is ArrowDown,\n * Enter or Space's job.\n */\nfunction moveTriggerFocus(from: string, dir: 1 | -1): void {\n  const ids = props.menus.map((m) => m.id);\n  const cur = ids.indexOf(from);\n  if (cur === -1) return;\n  triggerEls.get(ids[(cur + dir + ids.length) % ids.length] ?? \"\")?.focus();\n}\n\nasync function onTriggerKeydown(e: KeyboardEvent, menu: MenubarMenu): Promise<void> {\n  switch (e.key) {\n    case \"ArrowDown\":\n    case \"Enter\":\n    case \" \":\n      e.preventDefault(); // suppresses the button's own activation click\n      openId.value = menu.id;\n      activeIndex.value = -1;\n      await openAndFocusFirst(menu.id, menu.items);\n      break;\n    case \"ArrowRight\":\n      e.preventDefault();\n      if (openId.value) void moveMenu(horizontal.value);\n      else moveTriggerFocus(menu.id, horizontal.value);\n      break;\n    case \"ArrowLeft\":\n      e.preventDefault();\n      if (openId.value) void moveMenu(-horizontal.value as 1 | -1);\n      else moveTriggerFocus(menu.id, -horizontal.value as 1 | -1);\n      break;\n    case \"Escape\":\n      e.preventDefault();\n      close(true);\n      break;\n  }\n}\n\nfunction onMenuKeydown(e: KeyboardEvent, menu: MenubarMenu): void {\n  const items = menu.items;\n  switch (e.key) {\n    case \"ArrowDown\":\n      e.preventDefault();\n      goTo(items, neighborEnabled(items, activeIndex.value, 1));\n      break;\n    case \"ArrowUp\":\n      e.preventDefault();\n      goTo(items, neighborEnabled(items, activeIndex.value, -1));\n      break;\n    case \"Home\":\n      e.preventDefault();\n      goTo(items, firstEnabled(items, 0, 1));\n      break;\n    case \"End\":\n      e.preventDefault();\n      goTo(items, firstEnabled(items, items.length - 1, -1));\n      break;\n    case \"ArrowRight\":\n      e.preventDefault();\n      void moveMenu(horizontal.value);\n      break;\n    case \"ArrowLeft\":\n      e.preventDefault();\n      void moveMenu(-horizontal.value as 1 | -1);\n      break;\n    // Handled here rather than left to the button's native activation:\n    // preventDefault stops the browser's synthesized click, which would run\n    // choose() a second time alongside this delegated handler.\n    case \"Enter\":\n    case \" \": {\n      e.preventDefault();\n      const item = items[activeIndex.value];\n      if (item) choose(item);\n      break;\n    }\n    case \"Escape\":\n      e.preventDefault();\n      close(true);\n      break;\n  }\n}\n\nfunction onRootFocusout(e: FocusEvent): void {\n  if (!openId.value) return;\n  const root = e.currentTarget;\n  const next = e.relatedTarget;\n  // Tab out of the strip dismisses the menu and leaves focus where the browser\n  // put it. Moves that stay inside the menubar (opening handing focus to a\n  // row) keep it.\n  if (!(root instanceof Element) || !(next instanceof Node) || !root.contains(next)) close();\n}\n\n// A wrapper, not `close` itself: the listener's event argument would otherwise\n// arrive as `restoreFocus`, and an outside click would yank focus back to the\n// trigger instead of leaving it where the press landed.\nconst onWindowClick = (): void => close();\nonMounted(() => window.addEventListener(\"click\", onWindowClick));\nonBeforeUnmount(() => window.removeEventListener(\"click\", onWindowClick));\n</script>\n\n<template>\n  <!-- The attribute rides the strip itself, not just the prop: a host may\n       pass dir without setting document direction, and both the flex order\n       and the mirrored keys must agree with what is on screen. -->\n  <div\n    :dir=\"dir\"\n    role=\"menubar\"\n    class=\"flex items-center gap-0.5\"\n    style=\"-webkit-app-region: no-drag\"\n    @click.stop\n    @focusout=\"onRootFocusout\"\n  >\n    <div v-for=\"menu in menus\" :key=\"menu.id\" class=\"relative\">\n      <button\n        :id=\"`menubar-trigger-${menu.id}`\"\n        :ref=\"(el) => bindTrigger(menu.id, el)\"\n        type=\"button\"\n        role=\"menuitem\"\n        :aria-haspopup=\"'menu'\"\n        :aria-expanded=\"openId === menu.id\"\n        class=\"min-h-6 rounded-sm px-2 py-1 text-xs text-muted-foreground transition-colors duration-fast ease-out hover:bg-subtle hover:text-foreground focus-visible:bg-subtle focus-visible:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo\"\n        :class=\"openId === menu.id && 'bg-subtle text-foreground'\"\n        @click.stop=\"toggle(menu.id)\"\n        @mouseenter=\"hover(menu.id, 'pointer')\"\n        @focus=\"hover(menu.id, 'trigger-focus')\"\n        @keydown=\"onTriggerKeydown($event, menu)\"\n      >\n        {{ menu.label }}\n      </button>\n\n      <!-- Scoped presence, matching every sibling overlay: enter animates in,\n           leave answers with scale-out. The unconditional mount-only animation\n           this used to carry never plays on close at all. In jsdom, with no\n           stylesheet loaded, Vue computes zero animation duration and ends both\n           phases immediately, so tests see plain unmount. -->\n      <Transition enter-active-class=\"animate-scale-in\" leave-active-class=\"animate-scale-out\">\n        <div\n          v-if=\"openId === menu.id\"\n          :ref=\"(el) => bindPanel(menu.id, el)\"\n          role=\"menu\"\n          :aria-label=\"menu.label\"\n          tabindex=\"-1\"\n          class=\"absolute left-0 top-full z-overlay mt-1 min-w-[13rem] origin-top-left rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-md\"\n          @click.stop\n          @keydown=\"onMenuKeydown($event, menu)\"\n        >\n          <template v-for=\"(item, i) in openMenu(menu)\" :key=\"i\">\n            <div v-if=\"item.separator\" role=\"separator\" class=\"my-1 h-px bg-border\" />\n            <!-- The row's colour, not its alpha, says it is unavailable. A menu\n                 row is nothing but its label, and `disabled:opacity-40` composited\n                 that label to 2.40:1 on the popover — a disabled row a reader\n                 cannot make out tells them nothing about what is unavailable,\n                 which is the only thing it is there to say. Muted instead: 5.76:1\n                 at rest, and a clear drop from the 15.46:1 an available row wears,\n                 so the state still reads at a glance. The shortcut beside it\n                 declares `text-muted-foreground` on its own element, so it lands\n                 on the same colour rather than inheriting this one.\n\n                 Rows sit at text-sm/py-1.5 like DropdownMenu's — one row grammar\n                 across menus; the compact trigger above stays desktop chrome.\n                 Every row carries tabindex -1: focus arrives programmatically,\n                 never by tabbing through the strip. -->\n            <button\n              v-else\n              type=\"button\"\n              role=\"menuitem\"\n              tabindex=\"-1\"\n              :disabled=\"item.disabled\"\n              :data-highlighted=\"activeIndex === i || undefined\"\n              :style=\"{ animationDelay: listStaggerDelay(i) }\"\n              class=\"flex w-full items-center justify-between gap-6 rounded-sm px-2 py-1.5 text-left text-sm text-foreground transition-colors duration-fast ease-out hover:bg-subtle disabled:pointer-events-none disabled:text-muted-foreground data-[highlighted]:bg-subtle focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo animate-fade-rise\"\n              @click=\"choose(item)\"\n              @mouseenter=\"pointAtRow(openMenu(menu), item, i)\"\n              @focus=\"noteFocus(item, i)\"\n            >\n              <span>{{ item.label }}</span>\n              <span v-if=\"item.shortcut\" class=\"tabular text-micro text-muted-foreground\">\n                {{ item.shortcut }}\n              </span>\n            </button>\n          </template>\n        </div>\n      </Transition>\n    </div>\n  </div>\n</template>\n"],"mappings":"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"}

package/dist/packages/primitives/menubar/src/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from "./Menubar.vue";
+export type { MenubarItem, MenubarMenu } from "./Menubar.vue";
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/primitives/menubar/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/primitives/menubar/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/packages/primitives/menubar/src/index.js

@@ -0,0 +1,2 @@
+import Menubar_default from "./Menubar.js";
+export { Menubar_default as default };

package/dist/packages/primitives/number-field/src/NumberField.js

@@ -0,0 +1,7 @@
+import NumberField_vue_vue_type_script_setup_true_lang_default, { NUMBER_FIELD_LABELS } from "./NumberField.vue_vue_type_script_setup_true_lang.js";
+//#region packages/primitives/number-field/src/NumberField.vue
+var NumberField_default = NumberField_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { NUMBER_FIELD_LABELS, NumberField_default as default };
+
+//# sourceMappingURL=NumberField.js.map

package/dist/packages/primitives/number-field/src/NumberField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberField.js","names":[],"sources":["../../../../../packages/primitives/number-field/src/NumberField.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { NumberFieldLabels } from \"@ecoma-io/loom-labels\";\n/**\n\n/**\n * Loom's English, co-located with the component so it tree-shakes with it, and\n * exported so a host can build a partial vocabulary against the real thing.\n */\nexport const NUMBER_FIELD_LABELS: NumberFieldLabels = {\n  increment: \"Increase value\",\n  decrement: \"Decrease value\",\n  roleDescription: \"Number field\",\n};\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, onUnmounted, ref, useTemplateRef, watch } from \"vue\";\nimport {\n  NumberFieldRoot,\n  NumberFieldInput,\n  NumberFieldIncrement,\n  NumberFieldDecrement,\n} from \"reka-ui\";\nimport { ChevronUp, ChevronDown } from \"@lucide/vue\";\nimport { cn } from \"@ecoma-io/loom-core\";\nimport { useSplitAttrs } from \"@ecoma-io/loom-core\";\nimport { useAncestorDisabled } from \"@ecoma-io/loom-labels\";\nimport { useFieldControl } from \"@ecoma-io/loom-labels\";\nimport { useLabels, type LabelOverrides } from \"@ecoma-io/loom-labels\";\nimport { optional } from \"@ecoma-io/loom-core\";\n\n/**\n * NumberField — a constrained number input you can also *scrub*: drag\n * horizontally anywhere on the field and the value runs with the pointer, the\n * gesture professional editors trained everyone to expect on a numeric row.\n *\n * Built on Reka UI's NumberField, which supplies the spinbutton semantics and\n * the typed-value parsing. Two things are added here because Reka has no\n * equivalent: the scrub-drag gesture, and a Shift multiplier on the arrow\n * keys.\n *\n * The event contract is what makes it usable behind an undo stack.\n * `update:modelValue` is transient — it fires on every drag tick, every arrow\n * tick and every applied edit, so a host can paint a live preview. `commit`\n * fires once per gesture boundary — drag release, Enter, or focus leaving the\n * field. One long drag is therefore one undo checkpoint rather than one per\n * pixel, and a gesture that ends where it started produces none at all.\n *\n * Inside a [Field](../Field/Field.vue) it wires itself: the row's id, the id of\n * its hint or error line, `required`, `invalid`, `disabled`, `readonly` and the\n * name the value is submitted under all arrive through `useFieldControl()`, so\n * `<Field label=\"Rotation\" error=\"…\"><NumberField … /></Field>` needs no\n * attributes at the call site. Every prop below still wins over the row when it\n * is set, in both directions — which is why the three booleans default to\n * `undefined` rather than `false`.\n *\n * `readonly` and `disabled` are different states here for the same reason they\n * are on a text input, and a number is the case that makes it obvious: a rate,\n * a computed total or a locked coordinate is a value on show. It stays a Tab\n * stop, stays in the form's submitted data, and takes a lifted fill with the\n * number at full strength, one step short of the disabled state's drained fill,\n * muted number and slackened rim — and every path that would change it is\n * closed, the stepper included, because a control offering a gesture that does\n * nothing is worse than one that offers none.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** The current value. Transient edits are reported before it changes. */\n    modelValue?: number;\n    /** Lower bound. Every path — typing, arrows, scrub — is clamped to it. */\n    min?: number;\n    /** Upper bound, clamped the same way. It wins over step alignment. */\n    max?: number;\n    /** The granularity of one arrow tick or one scrub step. Shift multiplies it by ten. */\n    step?: number;\n    /** A presentational suffix such as `px` or `deg`. It is never part of the value. */\n    unit?: string;\n    /** Unavailable: dims the field and refuses every edit path. Unset defers to a wrapping Field. */\n    disabled?: boolean | undefined;\n    /** Shows the value without allowing an edit — typing, arrows, stepper and scrub all closed — while staying focusable and still submitted. Unset defers to a wrapping Field. */\n    readonly?: boolean | undefined;\n    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. Unset defers to a wrapping Field's `error`. */\n    invalid?: boolean | undefined;\n    /**\n     * Names for everything this control says out loud, as any subset of\n     * `NumberFieldLabels` — the rest stay as the host's `provideLoomLabels`\n     * vocabulary left them, and then as Loom's English.\n     *\n     * This is the per-instance correction, not the place to localise an\n     * application: the case it exists for is `roleDescription`, where a field\n     * holding a rotation or a price is more useful named as that than as a\n     * number field.\n     */\n    labels?: LabelOverrides<NumberFieldLabels>;\n  }>(),\n  {\n    step: 1,\n    // Not `false`, for any of the three. `false` is a caller saying \"this field\n    // is fine / enabled / editable even though its row is not\"; absent is a\n    // caller saying nothing, and only `undefined` survives to mean that past\n    // Vue's absent-Boolean-casts-to-false rule — see TextField.vue, which\n    // carries the full reasoning.\n    disabled: undefined,\n    readonly: undefined,\n    invalid: undefined,\n  },\n);\n\nconst emit = defineEmits<{\n  /** Transient: every drag tick, arrow tick, or applied edit. Not a checkpoint. */\n  \"update:modelValue\": [value: number];\n  /** Committed: once per gesture boundary — drag release, Enter, or focus leaving. */\n  commit: [value: number];\n}>();\n\n// `text`, not `labels`: the prop of that name is one of the three sources this\n// resolves, and a template reading the raw prop would be reading the overrides\n// rather than the answer.\nconst text = useLabels(\"numberField\", NUMBER_FIELD_LABELS, () => props.labels);\n\n// The rendered root is a non-focusable `role=\"group\"` wrapper, so fallthrough\n// attributes that describe the *control* — `aria-labelledby`, `data-testid` —\n// belong on the spinbutton inside it, not on the group. `class` is the one\n// exception and goes the other way: a caller's sizing or layout class has to\n// land on the element that participates in the parent's layout, merged through\n// `cn()` so a caller's `w-24` actually beats the root's own `w-full` instead of\n// losing to whichever utility Tailwind happened to emit last.\ndefineOptions({ inheritAttrs: false });\nconst { attrs, rest: inputAttrs } = useSplitAttrs();\n\n/**\n * The scrub is the reason this control cannot be left to the platform.\n *\n * `<fieldset disabled>` makes the inner `<input>` and the two stepper buttons\n * inert on its own, which covers the keyboard and the two clicks — but the\n * drag-to-change gesture is a `pointerdown` on the **root**, and a `<div>` is\n * not a form control, so nothing native stops it. `onPointerDown` bails on\n * `field.disabled`, and that is exactly the value a disabled fieldset does not\n * reach. Without this, a field inside a disabled group looked unavailable,\n * refused the keyboard, and still changed its number under a drag.\n *\n * Read off the DOM rather than taken from the Field context, which publishes no\n * `disabled` on purpose — see `../../lib/ancestor-disabled.ts`.\n */\nconst root = useTemplateRef<{ $el?: Element }>(\"root\");\nconst groupDisabled = useAncestorDisabled(() => root.value?.$el);\n\n// `id` and `aria-describedby` reach this control as fallthrough attrs rather\n// than props, so they are read off `attrs` and handed in as this caller's own\n// values — a caller who sets either still beats the row, and the row's\n// description is merged into theirs rather than replacing it. `name` and\n// `required` are absent from this object because there is no prop to oppose\n// the row with; the row's answer stands unopposed, which is what is wanted.\nconst field = useFieldControl(() => ({\n  id: attrs.id as string | undefined,\n  describedBy: attrs[\"aria-describedby\"] as string | undefined,\n  // The fieldset beats the prop in both directions, exactly as it does for the\n  // `<input>` inside this very control.\n  disabled: groupDisabled.value ? true : props.disabled,\n  readonly: props.readonly,\n  invalid: props.invalid,\n}));\n\n// `name` is the one resolved key that does not travel with the bag, and here\n// it is a defect rather than a nicety: the bag lands on the spinbutton, and\n// what the spinbutton holds is the *formatted* number — `1,234` for 1234. A\n// `name` on it would post the grouping separators along with the digits. Reka\n// submits the model value itself through a hidden input it renders from the\n// root's own `name`, so that is where the row's name goes. Everything else in\n// the bag — the id, the merged description, `aria-required`, `aria-invalid` —\n// belongs on the `role=\"spinbutton\"` node, which is that input.\nconst inputFieldAttrs = computed(() => {\n  // Removed from a copy rather than listed positively, so a key added to the\n  // resolved bag later reaches this input without anyone remembering to come\n  // back here.\n  const aria: Record<string, unknown> = { ...field.attrs };\n  delete aria.name;\n  return aria;\n});\n\n// `optional()` drops the absent bounds and an absent name rather than\n// forwarding `undefined`, which Reka would read as \"a bound that is undefined\"\n// rather than \"no bound\" — and, for the name, would have it render a hidden\n// form input for a field nothing is submitting.\nconst rootProps = computed(() =>\n  optional({\n    modelValue: lastValue.value,\n    min: props.min,\n    max: props.max,\n    name: field.name,\n  }),\n);\n\nfunction clampValue(value: number): number {\n  const step = props.step || 1;\n  const stepped = Math.round(value / step) * step;\n  const withMin = props.min !== undefined ? Math.max(props.min, stepped) : stepped;\n  return props.max !== undefined ? Math.min(props.max, withMin) : withMin;\n}\n\n// The single source of truth for \"the last value we know about\", updated the\n// moment it changes — never re-derived from `props.modelValue` at commit time,\n// because that prop only reflects a new value after the host's v-model\n// round-trip re-renders us, which is a tick later than the blur or keydown\n// being handled.\n//\n// It is also what the Reka root binds as its own `model-value`, rather than\n// `props.modelValue`. Given a defined model value Reka runs fully controlled:\n// its increment reads back through that prop, so a host that correctly\n// withholds transient echoes until commit would freeze every arrow tick at\n// start + 1 and freeze the readout at the gesture's start value. Feeding it\n// `lastValue` keeps the ticks accumulating and the readout live inside a\n// gesture, while the host still sees nothing but transient emits until the\n// boundary.\nconst lastValue = ref(props.modelValue);\n\n// The value the host last acknowledged. `commit` only fires when `lastValue`\n// differs from it, so overlapping boundaries (Enter then blur, drag release\n// then blur) and no-edit focus passes (Tab in, Tab out) produce no extra\n// checkpoints.\nconst lastCommittedValue = ref(props.modelValue);\n\n// True while an uncommitted edit is in flight. An external prop change\n// re-baselines `lastCommittedValue` only when nothing is pending — otherwise\n// the host echoing our own transient emits back down would make the pending\n// edit look already committed and swallow its `commit`.\nlet editPending = false;\n\nwatch(\n  () => props.modelValue,\n  (value) => {\n    lastValue.value = value;\n    if (!editPending) lastCommittedValue.value = value;\n  },\n);\n\nfunction onUpdate(value: number | undefined) {\n  // Reka clears its model to `undefined` when the text in the field does not\n  // parse — an emptied field, most reachably. The contract here is a number,\n  // so the field falls back to its own floor instead of forwarding a hole,\n  // which is also what Reka itself does when a stepper is pressed on\n  // unparseable text.\n  const next = value ?? props.min ?? 0;\n  editPending = true;\n  lastValue.value = next;\n  emit(\"update:modelValue\", next);\n}\n\nfunction commitLastValue() {\n  // The boundary ends the edit session even when the value ended up back where\n  // it started — a drag that returned to its origin still ends the gesture.\n  editPending = false;\n  if (lastValue.value === lastCommittedValue.value) return;\n  lastCommittedValue.value = lastValue.value;\n  emit(\"commit\", lastValue.value ?? props.min ?? 0);\n}\n\n// Shift = ×10. Reka's own arrow handling is bound on the input and ignores\n// `shiftKey`, so this intercepts in the capture phase — strictly before the\n// event reaches the input — and fully replaces the default ×1 tick for this\n// one case. Letting both run would double-step.\nfunction onKeydownCapture(event: KeyboardEvent) {\n  // Read-only closes this path as firmly as disabled does. Reka's own arrow\n  // handling already bails on `readonly`, and this override replaces it — so\n  // without the guard Shift+Arrow would be the one way to edit a field that\n  // says it cannot be edited.\n  if (field.disabled || field.readonly) return;\n  if (!event.shiftKey || (event.key !== \"ArrowUp\" && event.key !== \"ArrowDown\")) return;\n  event.preventDefault();\n  event.stopPropagation();\n  const tick = (props.step || 1) * 10;\n  const current = lastValue.value ?? props.min ?? 0;\n  onUpdate(clampValue(event.key === \"ArrowUp\" ? current + tick : current - tick));\n}\n\n// Bubble phase, not capture: by the time this fires, the input's own Enter\n// handling has already applied the typed text, because bubbling visits the\n// target before its ancestors.\nfunction onKeydownCommit(event: KeyboardEvent) {\n  if (event.key !== \"Enter\") return;\n  commitLastValue();\n}\n\n// A held arrow key is one gesture, exactly like a pointer drag: every keydown,\n// including the operating system's auto-repeats, only ticks the transient\n// value, and the keyup ends the gesture and commits the summed delta once. A\n// single tap is a keydown plus a keyup, so it still commits once.\nfunction onKeyupCommit(event: KeyboardEvent) {\n  if (event.key !== \"ArrowUp\" && event.key !== \"ArrowDown\") return;\n  commitLastValue();\n}\n\n// `focusout` bubbles where `blur` does not, so this reliably runs after the\n// input's own blur handling — but it only commits once focus has actually left\n// the field, not when it shifts internally to the hover-revealed stepper.\nfunction onFocusOut(event: FocusEvent) {\n  const root = event.currentTarget as HTMLElement;\n  if (event.relatedTarget instanceof Node && root.contains(event.relatedTarget)) return;\n  commitLastValue();\n}\n\n// Horizontal scrub. A plain click must still place the caret for typing, so\n// the gesture does not take over until the pointer has moved past a small\n// threshold.\nconst DRAG_THRESHOLD_PX = 3;\nconst PIXELS_PER_STEP = 4;\n\n// Set while a drag's window listeners are attached, so unmounting mid-drag\n// detaches them instead of leaking handlers onto `window`.\nlet removeDragListeners: (() => void) | undefined;\nonUnmounted(() => removeDragListeners?.());\n\nfunction onPointerDown(event: PointerEvent) {\n  // A read-only field still places the caret and still selects text, which is\n  // the whole point of it — it simply never starts a scrub.\n  if (field.disabled || field.readonly || event.button !== 0) return;\n  // Disarm before arming: a second concurrent pointerdown used to overwrite\n  // `removeDragListeners` instead of running it, so the first pointer's\n  // release committed this half-finished scrub and its move handler stayed on\n  // the window ticking values with no pointer anywhere near the field.\n  removeDragListeners?.();\n  const startX = event.clientX;\n  const startValue = lastValue.value ?? props.min ?? 0;\n  const step = props.step || 1;\n  let dragging = false;\n\n  function onPointerMove(moveEvent: PointerEvent) {\n    const deltaX = moveEvent.clientX - startX;\n    if (!dragging) {\n      if (Math.abs(deltaX) < DRAG_THRESHOLD_PX) return;\n      dragging = true;\n      window.getSelection()?.removeAllRanges();\n    }\n    moveEvent.preventDefault();\n    const deltaSteps = Math.round(deltaX / PIXELS_PER_STEP);\n    const next = clampValue(startValue + deltaSteps * step);\n    if (next !== lastValue.value) onUpdate(next);\n  }\n\n  function onPointerUp() {\n    removeDragListeners?.();\n    if (dragging) commitLastValue();\n  }\n\n  // Bail-out (Escape mid-scrub, or a browser-issued pointercancel): the\n  // gesture is discarded. Nothing commits, and one last transient update\n  // carrying the start value lets the host restore the pre-drag preview.\n  function abortDrag() {\n    removeDragListeners?.();\n    if (!dragging) return;\n    if (lastValue.value !== startValue) onUpdate(startValue);\n    editPending = false;\n  }\n\n  function onDragKeydown(keyEvent: KeyboardEvent) {\n    if (keyEvent.key !== \"Escape\" || !dragging) return;\n    keyEvent.preventDefault();\n    keyEvent.stopPropagation();\n    abortDrag();\n  }\n\n  window.addEventListener(\"pointermove\", onPointerMove);\n  window.addEventListener(\"pointerup\", onPointerUp);\n  window.addEventListener(\"pointercancel\", abortDrag);\n  window.addEventListener(\"keydown\", onDragKeydown, true);\n  removeDragListeners = () => {\n    window.removeEventListener(\"pointermove\", onPointerMove);\n    window.removeEventListener(\"pointerup\", onPointerUp);\n    window.removeEventListener(\"pointercancel\", abortDrag);\n    window.removeEventListener(\"keydown\", onDragKeydown, true);\n    removeDragListeners = undefined;\n  };\n}\n</script>\n\n<template>\n  <NumberFieldRoot\n    ref=\"root\"\n    v-bind=\"rootProps\"\n    :step=\"step\"\n    :disabled=\"field.disabled\"\n    :readonly=\"field.readonly\"\n    :aria-disabled=\"field.disabled || undefined\"\n    :data-invalid=\"field.invalid || undefined\"\n    :class=\"\n      cn(\n        'group relative inline-flex h-9 w-full items-center rounded-md border border-input bg-background',\n        'transition-[color,background-color,box-shadow] duration-fast ease-out',\n        // Rim-lit at rest; the ring blooms on focus.\n        'focus-within:outline-2 focus-within:outline-offset-2 focus-within:outline-ring',\n        !field.invalid && 'focus-within:shadow-halo',\n        // Three resting appearances, three channels — the same treatment\n        // TextField carries at length. Read-only and disabled used to share one\n        // fill and part only on the text colour, which is a distinction made in\n        // hue alone; the fill and the border weight now part them twice more.\n        //\n        // Read-only keeps its focus ring and its full-strength number: a\n        // read-only value is on show, not an unavailable control. The fill lifts\n        // to `subtle`, the rim stays `input` because the field's reach has not\n        // changed, and Reka's native `readonly` on the input carries the state\n        // to assistive tech, so nothing here rests on colour.\n        field.readonly && 'bg-subtle',\n        // Unavailable is a *colour* and a *weight*, never an opacity.\n        // `opacity-50` on this box faded the value inside it:\n        // `--color-foreground` measures 14.09:1 on the resting fill and 2.99:1\n        // once composited at half alpha, and the unit suffix beside it — muted,\n        // and smaller — fell to 2.02:1. The fill drains a step past read-only\n        // and the rim slackens to `border`; the input below takes the matching\n        // text colour, which has to be declared there rather than inherited from\n        // here because the input names `text-foreground` itself.\n        field.disabled && 'border-border bg-muted',\n        // Last of the rules that name a border colour: `cn()` resolves one by\n        // whichever class it saw last, so a field that is both in error and\n        // unavailable would otherwise lose its destructive rim to the disabled\n        // one.\n        field.invalid && 'border-destructive focus-within:outline-destructive',\n        'data-[disabled]:cursor-not-allowed',\n        attrs.class as string,\n      )\n    \"\n    @update:model-value=\"onUpdate\"\n    @keydown.capture=\"onKeydownCapture\"\n    @keydown=\"onKeydownCommit\"\n    @keyup=\"onKeyupCommit\"\n    @focusout=\"onFocusOut\"\n    @pointerdown=\"onPointerDown\"\n  >\n    <!-- `aria-roledescription` is written before the `v-bind` rather than after\n         it, which is the opposite of the field bag below and deliberate: it is\n         replacing Reka's own literal, not a caller's, so a caller who passes\n         the attribute directly should still beat it. Reka's is merged inside\n         its render function and Vue applies everything from here afterwards,\n         so both orders defeat Reka and only this one leaves the caller a way\n         past Loom. -->\n    <NumberFieldInput\n      :aria-roledescription=\"text.roleDescription\"\n      v-bind=\"{ ...inputAttrs, ...inputFieldAttrs }\"\n      :class=\"\n        cn(\n          'tabular h-full w-full flex-1 rounded-md bg-transparent px-3 text-sm text-foreground outline-none',\n          unit ? 'pr-9' : 'pr-3',\n          // 4.68:1 against the drained fill the root takes, and two steps back\n          // from the black an editable value keeps — the state stays plain to\n          // see and the number stays plain to read. `cn()` is what makes the\n          // pair work: it drops the `text-foreground` above rather than leaving\n          // two colours for the stylesheet to order.\n          field.disabled && 'cursor-not-allowed text-muted-foreground',\n          // The scrub cursor is a promise the field makes about the gesture it\n          // takes. Read-only takes no gesture, so it must not make the promise\n          // — the caret cursor is the honest one for a value you may select\n          // and copy but not change.\n          !field.disabled && !field.readonly && 'cursor-ew-resize',\n        )\n      \"\n    />\n    <!-- The unit is presentation, so it is hidden from assistive technology\n         and it clears out on hover to make room for the stepper. -->\n    <span\n      v-if=\"unit\"\n      aria-hidden=\"true\"\n      class=\"pointer-events-none absolute right-2 text-xs text-muted-foreground transition-opacity duration-fast group-hover:opacity-0\"\n    >\n      {{ unit }}\n    </span>\n    <!-- The stepper is hidden until hover: a column of these is read as a\n         column of numbers, and a permanent pair of chevrons on every row turns\n         that into a column of controls.\n\n         It is not rendered at all on a read-only field. Reka's own\n         `handleChangingValue` bails on `readonly` *after* focusing the input,\n         so a rendered stepper would be two named buttons that a pointer or a\n         screen reader can still reach and press, and that answer by moving\n         focus and changing nothing. Absent is the honest state. -->\n    <div\n      v-if=\"!field.readonly\"\n      class=\"absolute right-1 flex flex-col opacity-0 transition-opacity duration-fast group-hover:opacity-100\"\n    >\n      <!-- Both `:aria-label`s replace one Reka writes in English inside its own\n           render function — \"Increase\" and \"Decrease\". They reach the DOM node\n           as fallthrough attributes, which Vue merges last, so each is a\n           replacement rather than a second name. Removing one does not fall\n           back to nothing; it falls back to Reka's English.\n\n           The two keep `data-[disabled]:opacity-50` where the box around them\n           gave it up, and the difference is that each holds a chevron and\n           nothing else. Fading a glyph costs a reader nothing; their names are\n           in `aria-label`, not in dimmed text. -->\n      <NumberFieldIncrement\n        :aria-label=\"text.increment\"\n        class=\"flex min-h-6 min-w-6 items-center justify-center rounded-sm text-muted-foreground [transition:transform_var(--duration-fast)_var(--ease-spring),background-color_var(--duration-fast)_var(--ease-out),color_var(--duration-fast)_var(--ease-out)] hover:bg-subtle hover:text-foreground active:scale-press focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring data-[disabled]:pointer-events-none data-[disabled]:opacity-50\"\n      >\n        <!-- Stroke lives on the 24 grid and scales with size, so the inherited\n             1.5 would render 0.75 device pixels at this 12px box and all but\n             disappear. 2.5 restores the optical weight. -->\n        <ChevronUp class=\"h-3 w-3\" :stroke-width=\"2.5\" />\n      </NumberFieldIncrement>\n      <NumberFieldDecrement\n        :aria-label=\"text.decrement\"\n        class=\"flex min-h-6 min-w-6 items-center justify-center rounded-sm text-muted-foreground [transition:transform_var(--duration-fast)_var(--ease-spring),background-color_var(--duration-fast)_var(--ease-out),color_var(--duration-fast)_var(--ease-out)] hover:bg-subtle hover:text-foreground active:scale-press focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring data-[disabled]:pointer-events-none data-[disabled]:opacity-50\"\n      >\n        <ChevronDown class=\"h-3 w-3\" :stroke-width=\"2.5\" />\n      </NumberFieldDecrement>\n    </div>\n  </NumberFieldRoot>\n</template>\n"],"mappings":""}

package/dist/packages/primitives/number-field/src/NumberField.vue.d.ts

@@ -0,0 +1,80 @@
+import { type LabelOverrides } from "../../../labels/src/index";
+import type { NumberFieldLabels } from "../../../labels/src/index";
+/**
+
+/**
+ * Loom's English, co-located with the component so it tree-shakes with it, and
+ * exported so a host can build a partial vocabulary against the real thing.
+ */
+export declare const NUMBER_FIELD_LABELS: NumberFieldLabels;
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    /** The current value. Transient edits are reported before it changes. */
+    modelValue?: number;
+    /** Lower bound. Every path — typing, arrows, scrub — is clamped to it. */
+    min?: number;
+    /** Upper bound, clamped the same way. It wins over step alignment. */
+    max?: number;
+    /** The granularity of one arrow tick or one scrub step. Shift multiplies it by ten. */
+    step?: number;
+    /** A presentational suffix such as `px` or `deg`. It is never part of the value. */
+    unit?: string;
+    /** Unavailable: dims the field and refuses every edit path. Unset defers to a wrapping Field. */
+    disabled?: boolean | undefined;
+    /** Shows the value without allowing an edit — typing, arrows, stepper and scrub all closed — while staying focusable and still submitted. Unset defers to a wrapping Field. */
+    readonly?: boolean | undefined;
+    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. Unset defers to a wrapping Field's `error`. */
+    invalid?: boolean | undefined;
+    /**
+     * Names for everything this control says out loud, as any subset of
+     * `NumberFieldLabels` — the rest stay as the host's `provideLoomLabels`
+     * vocabulary left them, and then as Loom's English.
+     *
+     * This is the per-instance correction, not the place to localise an
+     * application: the case it exists for is `roleDescription`, where a field
+     * holding a rotation or a price is more useful named as that than as a
+     * number field.
+     */
+    labels?: LabelOverrides<NumberFieldLabels>;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: number) => any;
+    commit: (value: number) => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /** The current value. Transient edits are reported before it changes. */
+    modelValue?: number;
+    /** Lower bound. Every path — typing, arrows, scrub — is clamped to it. */
+    min?: number;
+    /** Upper bound, clamped the same way. It wins over step alignment. */
+    max?: number;
+    /** The granularity of one arrow tick or one scrub step. Shift multiplies it by ten. */
+    step?: number;
+    /** A presentational suffix such as `px` or `deg`. It is never part of the value. */
+    unit?: string;
+    /** Unavailable: dims the field and refuses every edit path. Unset defers to a wrapping Field. */
+    disabled?: boolean | undefined;
+    /** Shows the value without allowing an edit — typing, arrows, stepper and scrub all closed — while staying focusable and still submitted. Unset defers to a wrapping Field. */
+    readonly?: boolean | undefined;
+    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. Unset defers to a wrapping Field's `error`. */
+    invalid?: boolean | undefined;
+    /**
+     * Names for everything this control says out loud, as any subset of
+     * `NumberFieldLabels` — the rest stay as the host's `provideLoomLabels`
+     * vocabulary left them, and then as Loom's English.
+     *
+     * This is the per-instance correction, not the place to localise an
+     * application: the case it exists for is `roleDescription`, where a field
+     * holding a rotation or a price is more useful named as that than as a
+     * number field.
+     */
+    labels?: LabelOverrides<NumberFieldLabels>;
+}> & Readonly<{
+    "onUpdate:modelValue"?: (value: number) => any;
+    onCommit?: (value: number) => any;
+}>, {
+    disabled: boolean | undefined;
+    invalid: boolean | undefined;
+    readonly: boolean | undefined;
+    step: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+//# sourceMappingURL=NumberField.vue.d.ts.map