@ecoma-io/loom 0.2.0 → 0.4.0

package/dist/packages/blocks/row-actions/src/RowActions.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,47 @@
+import { createElementBlock, defineComponent, openBlock, renderSlot } from "vue";
+//#region packages/blocks/row-actions/src/RowActions.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "flex translate-x-1 items-center gap-1 opacity-0 transition duration-fast ease-out group-hover:translate-x-0 group-hover:opacity-100 group-focus-within:translate-x-0 group-focus-within:opacity-100 pointer-coarse:translate-x-0 pointer-coarse:opacity-100" };
+var RowActions_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "RowActions",
+	setup(__props) {
+		/**
+		* RowActions — the actions belonging to one row of a dense list, quiet at
+		* rest and revealed on hover or keyboard focus.
+		*
+		* Why this is a component and not three utility classes copied per view: the
+		* reveal carries an accessibility contract that is easy to get wrong in a way
+		* nothing fails on.
+		*
+		* - **Revealed by `opacity`, never by `display`/`v-if`.** A row action hidden
+		*   with `hidden` or unmounted until hover leaves the tab order, so a
+		*   keyboard-only or screen-reader user simply cannot reach it — and no test
+		*   notices, because the pointer path still works.
+		* - **`group-focus-within`, not only `group-hover`.** Tabbing into the row
+		*   must bring the actions up; otherwise focus lands on something invisible
+		*   and the focus ring appears to come from nowhere.
+		* - **The actions stay mounted and named.** Each child keeps its own
+		*   `aria-label` — the reveal changes what is *seen*, never what exists.
+		* - **`pointer-coarse` opts out of the reveal entirely.** A hover reveal has
+		*   no trigger on a touch screen: there is no hover state to enter, and the
+		*   `focus-within` fallback only fires after a tap has already landed on
+		*   something invisible. So on a coarse pointer the actions are simply always
+		*   visible — the reveal is a refinement for precise pointers, not a gate on
+		*   reaching the actions at all.
+		*
+		* The reveal rides a 4px inward slide alongside the fade so it reads as the
+		* actions arriving rather than a panel blinking on (motion carries cause and
+		* effect); both are token-tier and `duration-fast`, and the global
+		* reduced-motion rule flattens them together.
+		*
+		* Requires the row element to carry Tailwind's `group` class; the reveal is
+		* scoped to that group so sibling rows stay quiet.
+		*/
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", _hoisted_1, [renderSlot(_ctx.$slots, "default")]);
+		};
+	}
+});
+//#endregion
+export { RowActions_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=RowActions.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/blocks/row-actions/src/RowActions.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RowActions.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../../packages/blocks/row-actions/src/RowActions.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/**\n * RowActions — the actions belonging to one row of a dense list, quiet at\n * rest and revealed on hover or keyboard focus.\n *\n * Why this is a component and not three utility classes copied per view: the\n * reveal carries an accessibility contract that is easy to get wrong in a way\n * nothing fails on.\n *\n * - **Revealed by `opacity`, never by `display`/`v-if`.** A row action hidden\n *   with `hidden` or unmounted until hover leaves the tab order, so a\n *   keyboard-only or screen-reader user simply cannot reach it — and no test\n *   notices, because the pointer path still works.\n * - **`group-focus-within`, not only `group-hover`.** Tabbing into the row\n *   must bring the actions up; otherwise focus lands on something invisible\n *   and the focus ring appears to come from nowhere.\n * - **The actions stay mounted and named.** Each child keeps its own\n *   `aria-label` — the reveal changes what is *seen*, never what exists.\n * - **`pointer-coarse` opts out of the reveal entirely.** A hover reveal has\n *   no trigger on a touch screen: there is no hover state to enter, and the\n *   `focus-within` fallback only fires after a tap has already landed on\n *   something invisible. So on a coarse pointer the actions are simply always\n *   visible — the reveal is a refinement for precise pointers, not a gate on\n *   reaching the actions at all.\n *\n * The reveal rides a 4px inward slide alongside the fade so it reads as the\n * actions arriving rather than a panel blinking on (motion carries cause and\n * effect); both are token-tier and `duration-fast`, and the global\n * reduced-motion rule flattens them together.\n *\n * Requires the row element to carry Tailwind's `group` class; the reveal is\n * scoped to that group so sibling rows stay quiet.\n */\n</script>\n\n<template>\n  <div\n    class=\"flex translate-x-1 items-center gap-1 opacity-0 transition duration-fast ease-out group-hover:translate-x-0 group-hover:opacity-100 group-focus-within:translate-x-0 group-focus-within:opacity-100 pointer-coarse:translate-x-0 pointer-coarse:opacity-100\"\n  >\n    <slot />\n  </div>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCE,OAAA,UAAA,GAAA,mBAIM,OAJN,YAIM,CADJ,WAAQ,KAAA,QAAA,SAAA,CAAA,CAAA"}

package/dist/packages/blocks/row-actions/src/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./RowActions.vue";
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/blocks/row-actions/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/blocks/row-actions/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/packages/blocks/row-actions/src/index.js

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

package/dist/packages/blocks/sidebar-nav/src/SidebarNav.js

@@ -0,0 +1,7 @@
+import SidebarNav_vue_vue_type_script_setup_true_lang_default from "./SidebarNav.vue_vue_type_script_setup_true_lang.js";
+//#region packages/blocks/sidebar-nav/src/SidebarNav.vue
+var SidebarNav_default = SidebarNav_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { SidebarNav_default as default };
+
+//# sourceMappingURL=SidebarNav.js.map

package/dist/packages/blocks/sidebar-nav/src/SidebarNav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarNav.js","names":[],"sources":["../../../../../packages/blocks/sidebar-nav/src/SidebarNav.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { Component } from \"vue\";\n\n/** One destination in the sidebar. */\nexport interface SidebarNavItem {\n  /** A Lucide icon component (e.g. `Home` from `@lucide/vue`) — decorative; the label carries the meaning. */\n  icon?: Component;\n  label: string;\n  /** Marks this as the current page — the sole `--primary` accent drawn in the list. */\n  active?: boolean;\n  /** Renders the item as a real `<a>` instead of a `<button>`. The host owns the router/navigation. */\n  href?: string;\n  /** Short count/status shown after the label. Hidden in collapsed mode — folded into its tooltip instead. */\n  badge?: string | number;\n}\n\n/** A labeled group of items; `label` may be omitted for an unlabeled leading group. */\nexport interface SidebarNavSection {\n  label?: string;\n  items: SidebarNavItem[];\n}\n</script>\n\n<script setup lang=\"ts\">\nimport Tooltip from \"@ecoma-io/loom-tooltip\";\nimport Badge from \"@ecoma-io/loom-badge\";\nimport Separator from \"@ecoma-io/loom-separator\";\nimport { cn } from \"@ecoma-io/loom-core\";\n\n/**\n * SidebarNav — the primary NAVIGATION chrome: a `<nav>` landmark of sections\n * and destinations, pinned to the sunken plane (the recessed layer of the\n * shell — sunken < background < card, so work surfaces read as lifted and\n * navigation recedes).\n *\n * The active item carries a flat `--primary` fill and an inset accent bar —\n * a human decides which surface they are on, so this is the primary force\n * alone. It never mixes in `--accent`: this is navigation chrome, not a place\n * reporting a second semantic category.\n *\n * Presentational only: the host owns routing (`href` renders a real anchor)\n * and which item is `active` — this component does not track a current\n * route itself.\n *\n * Collapsed mode drops to icon-only rows: each item still needs an\n * accessible name once its label text is hidden, so it moves to `aria-label`\n * (Tooltip's own contract is `aria-describedby`, never the *only* source of\n * a name) and its Tooltip doubles as the visible hint. Native `<a>`/`<button>`\n * elements are used throughout, so Enter/Space activation and tab order come\n * from the platform, not custom key handling.\n *\n * Collapsed rows are square (`h-9 w-9`) rather than full-width, so the nav\n * centers its own children in that mode. The host is what narrows the rail,\n * and it may narrow it late or not at all — without the centering, a collapsed\n * nav still sitting in an expanded-width container leaves a column of icons\n * hugging the left edge of a wide empty panel. Centering makes the mode read\n * correctly at every container width, and the host's width animation then only\n * has to tighten what already looks right.\n */\nwithDefaults(\n  defineProps<{\n    sections: SidebarNavSection[];\n    /** Icon-only rail: section headings and item labels hide; each item's name moves into a Tooltip. */\n    collapsed?: boolean;\n    /** Accessible name for the `<nav>` landmark — the host owns wording (see `AppHeader`'s same prop). */\n    ariaLabel?: string;\n  }>(),\n  { collapsed: false },\n);\n\nconst emit = defineEmits<{ select: [item: SidebarNavItem] }>();\n\nfunction tooltipContent(item: SidebarNavItem): string {\n  return item.badge !== undefined && item.badge !== null\n    ? `${item.label} · ${item.badge}`\n    : item.label;\n}\n\nfunction itemClass(item: SidebarNavItem, collapsed: boolean): string {\n  return cn(\n    \"relative flex items-center gap-2 rounded-md text-left text-sm outline-none\",\n    \"transition-colors duration-fast ease-out\",\n    \"focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo\",\n    collapsed ? \"h-9 w-9 justify-center\" : \"h-9 w-full px-2.5\",\n    item.active\n      ? \"bg-primary/10 font-medium text-primary-text\"\n      : // Hover lifts the row to the raised plane rather than tinting it with\n        // `--subtle`. `--subtle` is the neutral hover fill for surfaces sitting\n        // on `--background` (96% L), where it lands 2% darker and reads. This\n        // nav sits on `--sunken` (93% L) and `--subtle` is 94% — one percent\n        // apart, so the hover state was there in the markup and invisible on\n        // screen. Lifting to `bg-card` is the elevation rhythm's own answer\n        // (sunken < background < card): the row the pointer is on comes\n        // forward.\n        \"text-muted-foreground hover:bg-card hover:text-foreground\",\n  );\n}\n</script>\n\n<template>\n  <nav\n    :aria-label=\"ariaLabel\"\n    class=\"flex h-full w-full flex-col gap-1 overflow-y-auto overscroll-contain bg-sunken p-2\"\n    :class=\"collapsed && 'items-center'\"\n  >\n    <template v-for=\"(section, sectionIndex) in sections\" :key=\"sectionIndex\">\n      <Separator v-if=\"sectionIndex > 0\" class=\"my-1\" />\n      <p\n        v-if=\"section.label && !collapsed\"\n        class=\"select-none px-2 pb-1 pt-2 text-micro font-medium uppercase tracking-wide text-muted-foreground\"\n      >\n        {{ section.label }}\n      </p>\n      <ul class=\"flex flex-col gap-0.5\">\n        <li v-for=\"(item, itemIndex) in section.items\" :key=\"itemIndex\">\n          <Tooltip v-if=\"collapsed\" :content=\"tooltipContent(item)\" side=\"right\">\n            <template #trigger>\n              <component\n                :is=\"item.href ? 'a' : 'button'\"\n                :type=\"item.href ? undefined : 'button'\"\n                :href=\"item.href\"\n                :aria-current=\"item.active ? 'page' : undefined\"\n                :aria-label=\"item.label\"\n                :class=\"itemClass(item, true)\"\n                @click=\"emit('select', item)\"\n              >\n                <span\n                  v-if=\"item.active\"\n                  aria-hidden=\"true\"\n                  class=\"absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary\"\n                />\n                <component :is=\"item.icon\" v-if=\"item.icon\" aria-hidden=\"true\" class=\"shrink-0\" />\n              </component>\n            </template>\n          </Tooltip>\n\n          <component\n            :is=\"item.href ? 'a' : 'button'\"\n            v-else\n            :type=\"item.href ? undefined : 'button'\"\n            :href=\"item.href\"\n            :aria-current=\"item.active ? 'page' : undefined\"\n            :class=\"itemClass(item, false)\"\n            @click=\"emit('select', item)\"\n          >\n            <span\n              v-if=\"item.active\"\n              aria-hidden=\"true\"\n              class=\"absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary\"\n            />\n            <component :is=\"item.icon\" v-if=\"item.icon\" aria-hidden=\"true\" class=\"shrink-0\" />\n            <span class=\"min-w-0 flex-1 truncate\">{{ item.label }}</span>\n            <Badge v-if=\"item.badge !== undefined\" variant=\"neutral\" class=\"shrink-0\">\n              {{ item.badge }}\n            </Badge>\n          </component>\n        </li>\n      </ul>\n    </template>\n  </nav>\n</template>\n"],"mappings":""}

package/dist/packages/blocks/sidebar-nav/src/SidebarNav.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarNav.vue.d.ts","sourceRoot":"","sources":["../../../../../packages/blocks/sidebar-nav/src/SidebarNav.vue"],"names":[],"mappings":"AA0KA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,4GAA4G;IAC5G,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4GAA4G;IAC5G,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;wBACoB,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;cAgCJ,iBAAiB,EAAE;IAC7B,oGAAoG;gBACxF,OAAO;IACnB,sGAAsG;gBAC1F,MAAM;;;;cAJR,iBAAiB,EAAE;IAC7B,oGAAoG;gBACxF,OAAO;IACnB,sGAAsG;gBAC1F,MAAM;;;;eAFN,OAAO;6EA4SnB,CAAC"}

package/dist/packages/blocks/sidebar-nav/src/SidebarNav.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,129 @@
+import { cn } from "../../../core/src/cn.js";
+import "../../../core/src/index.js";
+import Separator_default from "../../../primitives/separator/src/Separator.js";
+import "../../../primitives/separator/src/index.js";
+import Badge_default from "../../../primitives/badge/src/Badge.js";
+import "../../../primitives/badge/src/index.js";
+import Tooltip_default from "../../../primitives/tooltip/src/Tooltip.js";
+import "../../../primitives/tooltip/src/index.js";
+import { Fragment, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, defineComponent, normalizeClass, openBlock, renderList, resolveDynamicComponent, toDisplayString, unref, withCtx } from "vue";
+//#region packages/blocks/sidebar-nav/src/SidebarNav.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["aria-label"];
+var _hoisted_2 = {
+	key: 1,
+	class: "select-none px-2 pb-1 pt-2 text-micro font-medium uppercase tracking-wide text-muted-foreground"
+};
+var _hoisted_3 = { class: "flex flex-col gap-0.5" };
+var _hoisted_4 = {
+	key: 0,
+	"aria-hidden": "true",
+	class: "absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary"
+};
+var _hoisted_5 = {
+	key: 0,
+	"aria-hidden": "true",
+	class: "absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary"
+};
+var _hoisted_6 = { class: "min-w-0 flex-1 truncate" };
+var SidebarNav_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "SidebarNav",
+	props: {
+		sections: {},
+		collapsed: {
+			type: Boolean,
+			default: false
+		},
+		ariaLabel: {}
+	},
+	emits: ["select"],
+	setup(__props, { emit: __emit }) {
+		const emit = __emit;
+		function tooltipContent(item) {
+			return item.badge !== void 0 && item.badge !== null ? `${item.label} · ${item.badge}` : item.label;
+		}
+		function itemClass(item, collapsed) {
+			return cn("relative flex items-center gap-2 rounded-md text-left text-sm outline-none", "transition-colors duration-fast ease-out", "focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo", collapsed ? "h-9 w-9 justify-center" : "h-9 w-full px-2.5", item.active ? "bg-primary/10 font-medium text-primary-text" : "text-muted-foreground hover:bg-card hover:text-foreground");
+		}
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("nav", {
+				"aria-label": __props.ariaLabel,
+				class: normalizeClass(["flex h-full w-full flex-col gap-1 overflow-y-auto overscroll-contain bg-sunken p-2", __props.collapsed && "items-center"])
+			}, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.sections, (section, sectionIndex) => {
+				return openBlock(), createElementBlock(Fragment, { key: sectionIndex }, [
+					sectionIndex > 0 ? (openBlock(), createBlock(unref(Separator_default), {
+						key: 0,
+						class: "my-1"
+					})) : createCommentVNode("", true),
+					section.label && !__props.collapsed ? (openBlock(), createElementBlock("p", _hoisted_2, toDisplayString(section.label), 1)) : createCommentVNode("", true),
+					createElementVNode("ul", _hoisted_3, [(openBlock(true), createElementBlock(Fragment, null, renderList(section.items, (item, itemIndex) => {
+						return openBlock(), createElementBlock("li", { key: itemIndex }, [__props.collapsed ? (openBlock(), createBlock(unref(Tooltip_default), {
+							key: 0,
+							content: tooltipContent(item),
+							side: "right"
+						}, {
+							trigger: withCtx(() => [(openBlock(), createBlock(resolveDynamicComponent(item.href ? "a" : "button"), {
+								type: item.href ? void 0 : "button",
+								href: item.href,
+								"aria-current": item.active ? "page" : void 0,
+								"aria-label": item.label,
+								class: normalizeClass(itemClass(item, true)),
+								onClick: ($event) => emit("select", item)
+							}, {
+								default: withCtx(() => [item.active ? (openBlock(), createElementBlock("span", _hoisted_4)) : createCommentVNode("", true), item.icon ? (openBlock(), createBlock(resolveDynamicComponent(item.icon), {
+									key: 1,
+									"aria-hidden": "true",
+									class: "shrink-0"
+								})) : createCommentVNode("", true)]),
+								_: 2
+							}, 1032, [
+								"type",
+								"href",
+								"aria-current",
+								"aria-label",
+								"class",
+								"onClick"
+							]))]),
+							_: 2
+						}, 1032, ["content"])) : (openBlock(), createBlock(resolveDynamicComponent(item.href ? "a" : "button"), {
+							key: 1,
+							type: item.href ? void 0 : "button",
+							href: item.href,
+							"aria-current": item.active ? "page" : void 0,
+							class: normalizeClass(itemClass(item, false)),
+							onClick: ($event) => emit("select", item)
+						}, {
+							default: withCtx(() => [
+								item.active ? (openBlock(), createElementBlock("span", _hoisted_5)) : createCommentVNode("", true),
+								item.icon ? (openBlock(), createBlock(resolveDynamicComponent(item.icon), {
+									key: 1,
+									"aria-hidden": "true",
+									class: "shrink-0"
+								})) : createCommentVNode("", true),
+								createElementVNode("span", _hoisted_6, toDisplayString(item.label), 1),
+								item.badge !== void 0 ? (openBlock(), createBlock(unref(Badge_default), {
+									key: 2,
+									variant: "neutral",
+									class: "shrink-0"
+								}, {
+									default: withCtx(() => [createTextVNode(toDisplayString(item.badge), 1)]),
+									_: 2
+								}, 1024)) : createCommentVNode("", true)
+							]),
+							_: 2
+						}, 1032, [
+							"type",
+							"href",
+							"aria-current",
+							"class",
+							"onClick"
+						]))]);
+					}), 128))])
+				], 64);
+			}), 128))], 10, _hoisted_1);
+		};
+	}
+});
+//#endregion
+export { SidebarNav_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=SidebarNav.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/blocks/sidebar-nav/src/SidebarNav.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarNav.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../../packages/blocks/sidebar-nav/src/SidebarNav.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { Component } from \"vue\";\n\n/** One destination in the sidebar. */\nexport interface SidebarNavItem {\n  /** A Lucide icon component (e.g. `Home` from `@lucide/vue`) — decorative; the label carries the meaning. */\n  icon?: Component;\n  label: string;\n  /** Marks this as the current page — the sole `--primary` accent drawn in the list. */\n  active?: boolean;\n  /** Renders the item as a real `<a>` instead of a `<button>`. The host owns the router/navigation. */\n  href?: string;\n  /** Short count/status shown after the label. Hidden in collapsed mode — folded into its tooltip instead. */\n  badge?: string | number;\n}\n\n/** A labeled group of items; `label` may be omitted for an unlabeled leading group. */\nexport interface SidebarNavSection {\n  label?: string;\n  items: SidebarNavItem[];\n}\n</script>\n\n<script setup lang=\"ts\">\nimport Tooltip from \"@ecoma-io/loom-tooltip\";\nimport Badge from \"@ecoma-io/loom-badge\";\nimport Separator from \"@ecoma-io/loom-separator\";\nimport { cn } from \"@ecoma-io/loom-core\";\n\n/**\n * SidebarNav — the primary NAVIGATION chrome: a `<nav>` landmark of sections\n * and destinations, pinned to the sunken plane (the recessed layer of the\n * shell — sunken < background < card, so work surfaces read as lifted and\n * navigation recedes).\n *\n * The active item carries a flat `--primary` fill and an inset accent bar —\n * a human decides which surface they are on, so this is the primary force\n * alone. It never mixes in `--accent`: this is navigation chrome, not a place\n * reporting a second semantic category.\n *\n * Presentational only: the host owns routing (`href` renders a real anchor)\n * and which item is `active` — this component does not track a current\n * route itself.\n *\n * Collapsed mode drops to icon-only rows: each item still needs an\n * accessible name once its label text is hidden, so it moves to `aria-label`\n * (Tooltip's own contract is `aria-describedby`, never the *only* source of\n * a name) and its Tooltip doubles as the visible hint. Native `<a>`/`<button>`\n * elements are used throughout, so Enter/Space activation and tab order come\n * from the platform, not custom key handling.\n *\n * Collapsed rows are square (`h-9 w-9`) rather than full-width, so the nav\n * centers its own children in that mode. The host is what narrows the rail,\n * and it may narrow it late or not at all — without the centering, a collapsed\n * nav still sitting in an expanded-width container leaves a column of icons\n * hugging the left edge of a wide empty panel. Centering makes the mode read\n * correctly at every container width, and the host's width animation then only\n * has to tighten what already looks right.\n */\nwithDefaults(\n  defineProps<{\n    sections: SidebarNavSection[];\n    /** Icon-only rail: section headings and item labels hide; each item's name moves into a Tooltip. */\n    collapsed?: boolean;\n    /** Accessible name for the `<nav>` landmark — the host owns wording (see `AppHeader`'s same prop). */\n    ariaLabel?: string;\n  }>(),\n  { collapsed: false },\n);\n\nconst emit = defineEmits<{ select: [item: SidebarNavItem] }>();\n\nfunction tooltipContent(item: SidebarNavItem): string {\n  return item.badge !== undefined && item.badge !== null\n    ? `${item.label} · ${item.badge}`\n    : item.label;\n}\n\nfunction itemClass(item: SidebarNavItem, collapsed: boolean): string {\n  return cn(\n    \"relative flex items-center gap-2 rounded-md text-left text-sm outline-none\",\n    \"transition-colors duration-fast ease-out\",\n    \"focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:shadow-halo\",\n    collapsed ? \"h-9 w-9 justify-center\" : \"h-9 w-full px-2.5\",\n    item.active\n      ? \"bg-primary/10 font-medium text-primary-text\"\n      : // Hover lifts the row to the raised plane rather than tinting it with\n        // `--subtle`. `--subtle` is the neutral hover fill for surfaces sitting\n        // on `--background` (96% L), where it lands 2% darker and reads. This\n        // nav sits on `--sunken` (93% L) and `--subtle` is 94% — one percent\n        // apart, so the hover state was there in the markup and invisible on\n        // screen. Lifting to `bg-card` is the elevation rhythm's own answer\n        // (sunken < background < card): the row the pointer is on comes\n        // forward.\n        \"text-muted-foreground hover:bg-card hover:text-foreground\",\n  );\n}\n</script>\n\n<template>\n  <nav\n    :aria-label=\"ariaLabel\"\n    class=\"flex h-full w-full flex-col gap-1 overflow-y-auto overscroll-contain bg-sunken p-2\"\n    :class=\"collapsed && 'items-center'\"\n  >\n    <template v-for=\"(section, sectionIndex) in sections\" :key=\"sectionIndex\">\n      <Separator v-if=\"sectionIndex > 0\" class=\"my-1\" />\n      <p\n        v-if=\"section.label && !collapsed\"\n        class=\"select-none px-2 pb-1 pt-2 text-micro font-medium uppercase tracking-wide text-muted-foreground\"\n      >\n        {{ section.label }}\n      </p>\n      <ul class=\"flex flex-col gap-0.5\">\n        <li v-for=\"(item, itemIndex) in section.items\" :key=\"itemIndex\">\n          <Tooltip v-if=\"collapsed\" :content=\"tooltipContent(item)\" side=\"right\">\n            <template #trigger>\n              <component\n                :is=\"item.href ? 'a' : 'button'\"\n                :type=\"item.href ? undefined : 'button'\"\n                :href=\"item.href\"\n                :aria-current=\"item.active ? 'page' : undefined\"\n                :aria-label=\"item.label\"\n                :class=\"itemClass(item, true)\"\n                @click=\"emit('select', item)\"\n              >\n                <span\n                  v-if=\"item.active\"\n                  aria-hidden=\"true\"\n                  class=\"absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary\"\n                />\n                <component :is=\"item.icon\" v-if=\"item.icon\" aria-hidden=\"true\" class=\"shrink-0\" />\n              </component>\n            </template>\n          </Tooltip>\n\n          <component\n            :is=\"item.href ? 'a' : 'button'\"\n            v-else\n            :type=\"item.href ? undefined : 'button'\"\n            :href=\"item.href\"\n            :aria-current=\"item.active ? 'page' : undefined\"\n            :class=\"itemClass(item, false)\"\n            @click=\"emit('select', item)\"\n          >\n            <span\n              v-if=\"item.active\"\n              aria-hidden=\"true\"\n              class=\"absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary\"\n            />\n            <component :is=\"item.icon\" v-if=\"item.icon\" aria-hidden=\"true\" class=\"shrink-0\" />\n            <span class=\"min-w-0 flex-1 truncate\">{{ item.label }}</span>\n            <Badge v-if=\"item.badge !== undefined\" variant=\"neutral\" class=\"shrink-0\">\n              {{ item.badge }}\n            </Badge>\n          </component>\n        </li>\n      </ul>\n    </template>\n  </nav>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsEA,MAAM,OAAO;EAEb,SAAS,eAAe,MAA8B;GACpD,OAAO,KAAK,UAAU,KAAA,KAAa,KAAK,UAAU,OAC9C,GAAG,KAAK,MAAM,KAAK,KAAK,UACxB,KAAK;EACX;EAEA,SAAS,UAAU,MAAsB,WAA4B;GACnE,OAAO,GACL,8EACA,4CACA,+GACA,YAAY,2BAA2B,qBACvC,KAAK,SACD,gDASA,2DACN;EACF;;GAIE,OAAA,UAAA,GAAA,mBA2DM,OAAA;IA1DH,cAAY,QAAA;IACb,OAAK,eAAA,CAAC,sFACE,QAAA,aAAS,cAAA,CAAA;GAEjB,GAAA,EAAA,UAAA,IAAA,GAAA,mBAqDW,UAAA,MAAA,WArDiC,QAAA,WAA1B,SAAS,iBAAY;IAAqB,OAAA,UAAA,GAAA,mBAAA,UAAA,EAAA,KAAA,aAAY,GAAA;KACrD,eAAY,KAA7B,UAAA,GAAA,YAAkD,MAAA,iBAAA,GAAA;;MAAf,OAAM;;KAEjC,QAAQ,SAAK,CAAK,QAAA,aAD1B,UAAA,GAAA,mBAKI,KALJ,YAKI,gBADC,QAAQ,KAAK,GAAA,CAAA,KAAA,mBAAA,IAAA,IAAA;KAElB,mBA4CK,MA5CL,YA4CK,EA3CH,UAAA,IAAA,GAAA,mBA0CK,UAAA,MAAA,WA1C2B,QAAQ,QAA5B,MAAM,cAAS;MAA3B,OAAA,UAAA,GAAA,mBA0CK,MAAA,EA1C2C,KAAK,UAAS,GAAA,CAC7C,QAAA,aAAf,UAAA,GAAA,YAmBU,MAAA,eAAA,GAAA;;OAnBiB,SAAS,eAAe,IAAI;OAAG,MAAK;;OAClD,SAAO,cAgBJ,EAfZ,UAAA,GAAA,YAeY,wBAdL,KAAK,OAAI,MAAA,QAAA,GAAA;QACb,MAAM,KAAK,OAAO,KAAA,IAAS;QAC3B,MAAM,KAAK;QACX,gBAAc,KAAK,SAAM,SAAY,KAAA;QACrC,cAAY,KAAK;QACjB,OAAK,eAAE,UAAU,MAAI,IAAA,CAAA;QACrB,UAAK,WAAE,KAAI,UAAW,IAAI;;QAE3B,SAAA,cAIE,CAHM,KAAK,UADb,UAAA,GAAA,mBAIE,QAJF,UAIE,KAAA,mBAAA,IAAA,IAAA,GAC+B,KAAK,QAAtC,UAAA,GAAA,YAAkF,wBAAlE,KAAK,IAAI,GAAA;;SAAmB,eAAY;SAAO,OAAM;;;;;;;;;;;;MAK3E,GAAA,MAAA,CAAA,SAAA,CAAA,MAAA,UAAA,GAAA,YAmBY,wBAlBL,KAAK,OAAI,MAAA,QAAA,GAAA;;OAEb,MAAM,KAAK,OAAO,KAAA,IAAS;OAC3B,MAAM,KAAK;OACX,gBAAc,KAAK,SAAM,SAAY,KAAA;OACrC,OAAK,eAAE,UAAU,MAAI,KAAA,CAAA;OACrB,UAAK,WAAE,KAAI,UAAW,IAAI;;OAE3B,SAAA,cAIE;QAHM,KAAK,UADb,UAAA,GAAA,mBAIE,QAJF,UAIE,KAAA,mBAAA,IAAA,IAAA;QAC+B,KAAK,QAAtC,UAAA,GAAA,YAAkF,wBAAlE,KAAK,IAAI,GAAA;;SAAmB,eAAY;SAAO,OAAM;;QACrE,mBAA6D,QAA7D,YAA6D,gBAApB,KAAK,KAAK,GAAA,CAAA;QACtC,KAAK,UAAU,KAAA,KAA5B,UAAA,GAAA,YAEQ,MAAA,aAAA,GAAA;;SAF+B,SAAQ;SAAU,OAAM;;SAC7D,SAAA,cAAgB,CAAb,gBAAA,gBAAA,KAAK,KAAK,GAAA,CAAA,CAAA,CAAA"}

package/dist/packages/blocks/sidebar-nav/src/index.d.ts

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

package/dist/packages/blocks/sidebar-nav/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/blocks/sidebar-nav/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/packages/blocks/sidebar-nav/src/index.js

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

package/dist/packages/blocks/title-bar/src/TitleBar.js

@@ -0,0 +1,7 @@
+import TitleBar_vue_vue_type_script_setup_true_lang_default from "./TitleBar.vue_vue_type_script_setup_true_lang.js";
+//#region packages/blocks/title-bar/src/TitleBar.vue
+var TitleBar_default = TitleBar_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { TitleBar_default as default };
+
+//# sourceMappingURL=TitleBar.js.map

package/dist/packages/blocks/title-bar/src/TitleBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TitleBar.js","names":[],"sources":["../../../../../packages/blocks/title-bar/src/TitleBar.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * TitleBar — a desktop app's custom window chrome (a block: composed from\n * primitives, domain-aware, but still presentational). Layout:\n *\n *   Windows / Linux:\n *   [ ⬡ brand ] [ File View Help ]  ····· drag / title ····· [ – ▢ ✕ ]\n *\n *   macOS (native traffic-lights on the left):\n *   [ 🔴🟡🟢   ⬡ brand ] [ File View Help ]  ····· drag / title ·····\n *\n * The whole bar is a drag region (`-webkit-app-region: drag`); the interactive\n * clusters (Menubar, WindowControls) opt back out. It owns NO app logic — it\n * re-emits `select` from the menu and the window intents, so the desktop host\n * wires the window bridge around it.\n *\n * `platform` is the host's declaration, not a runtime sniff: a Tauri/Electron\n * host already knows its OS, and a PWA has no native window controls. On macOS\n * the brand cluster shifts right to leave room for the native traffic-light\n * buttons, and WindowControls renders nothing (the OS owns those buttons).\n */\nimport type { MenubarMenu } from \"@ecoma-io/loom-menubar\";\nimport type { WindowPlatform } from \"@ecoma-io/loom-window-controls\";\n</script>\n\n<script setup lang=\"ts\">\nimport Menubar from \"@ecoma-io/loom-menubar\";\nimport WindowControls, { type WindowControlsLabels } from \"@ecoma-io/loom-window-controls\";\nimport { optional } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** The host app's brand name — required: this block has no identity of its own. */\n    appName: string;\n    /** Centered subtitle — usually the open project / composition. */\n    title?: string;\n    menus?: MenubarMenu[];\n    isMaximized?: boolean;\n    /**\n     * The desktop platform the window runs on. Controls whether WindowControls\n     * renders (hidden on macOS) and how the brand cluster is spaced (shifted\n     * right on macOS to avoid the native traffic-light buttons). The host\n     * decides — Loom never sniffs the OS at runtime.\n     */\n    platform?: WindowPlatform;\n    /** Passed through to WindowControls (host-side i18n); omit for its English defaults. */\n    windowControlsLabels?: WindowControlsLabels;\n  }>(),\n  {\n    title: \"\",\n    menus: () => [],\n    isMaximized: false,\n    platform: \"windows\",\n  },\n);\n\nconst emit = defineEmits<{\n  (e: \"select\", command: string): void;\n  (e: \"minimize\"): void;\n  (e: \"maximize\"): void;\n  (e: \"close\"): void;\n}>();\n</script>\n\n<template>\n  <header\n    data-loom-titlebar\n    class=\"flex h-9 select-none items-center border-b border-border bg-card text-foreground\"\n    style=\"-webkit-app-region: drag\"\n  >\n    <!-- Brand. Deliberately NOT `no-drag`: nothing here is interactive, and the\n         logo corner is the spot people reach for to move a window — opting it\n         out of the drag region would take that away and give nothing back.\n         Only the clusters that actually take clicks (Menubar, WindowControls)\n         opt out.\n\n         On macOS the brand cluster shifts right to leave room for the native\n         traffic-light buttons. The 4.5rem (72px) covers the three 12px\n         buttons plus their 8px left margin and 4px inter-button gap, matching\n         what macOS draws at the default window scale. -->\n    <div\n      class=\"flex shrink-0 items-center gap-2 pr-1.5\"\n      :class=\"platform === 'macos' ? 'pl-[4.5rem]' : 'pl-3'\"\n    >\n      <!-- @slot Brand icon — the consumer provides their own mark. Rendered\n           inside a 16px coloured tile, `aria-hidden` by the container. -->\n      <slot name=\"brandIcon\">\n        <span\n          class=\"grid h-4 w-4 place-items-center rounded-[5px] bg-primary text-primary-foreground shadow-sm\"\n          aria-hidden=\"true\"\n        >\n          <!-- stroke bumped for optical balance at tiny size -->\n          <slot name=\"brandMark\" />\n        </span>\n      </slot>\n      <span class=\"text-xs font-semibold tracking-tight\">{{ appName }}</span>\n    </div>\n\n    <!-- Menu bar -->\n    <Menubar v-if=\"menus.length\" :menus=\"menus\" @select=\"emit('select', $event)\" />\n\n    <!-- Draggable spacer + centered title -->\n    <div class=\"flex min-w-0 flex-1 items-center justify-center overflow-hidden px-4\">\n      <span v-if=\"title\" class=\"truncate text-xs text-muted-foreground\">{{ title }}</span>\n    </div>\n\n    <!-- Window controls (hidden on macOS — the OS draws its own) -->\n    <WindowControls\n      :platform=\"platform\"\n      :is-maximized=\"isMaximized\"\n      v-bind=\"optional({ labels: windowControlsLabels })\"\n      @minimize=\"emit('minimize')\"\n      @maximize=\"emit('maximize')\"\n      @close=\"emit('close')\"\n    />\n  </header>\n</template>\n"],"mappings":""}

package/dist/packages/blocks/title-bar/src/TitleBar.vue.d.ts

@@ -0,0 +1,83 @@
+import { type WindowControlsLabels } from "../../../primitives/window-controls/src/index";
+/**
+ * TitleBar — a desktop app's custom window chrome (a block: composed from
+ * primitives, domain-aware, but still presentational). Layout:
+ *
+ *   Windows / Linux:
+ *   [ ⬡ brand ] [ File View Help ]  ····· drag / title ····· [ – ▢ ✕ ]
+ *
+ *   macOS (native traffic-lights on the left):
+ *   [ 🔴🟡🟢   ⬡ brand ] [ File View Help ]  ····· drag / title ·····
+ *
+ * The whole bar is a drag region (`-webkit-app-region: drag`); the interactive
+ * clusters (Menubar, WindowControls) opt back out. It owns NO app logic — it
+ * re-emits `select` from the menu and the window intents, so the desktop host
+ * wires the window bridge around it.
+ *
+ * `platform` is the host's declaration, not a runtime sniff: a Tauri/Electron
+ * host already knows its OS, and a PWA has no native window controls. On macOS
+ * the brand cluster shifts right to leave room for the native traffic-light
+ * buttons, and WindowControls renders nothing (the OS owns those buttons).
+ */
+import type { MenubarMenu } from "../../../primitives/menubar/src/index";
+import type { WindowPlatform } from "../../../primitives/window-controls/src/index";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    /** The host app's brand name — required: this block has no identity of its own. */
+    appName: string;
+    /** Centered subtitle — usually the open project / composition. */
+    title?: string;
+    menus?: MenubarMenu[];
+    isMaximized?: boolean;
+    /**
+     * The desktop platform the window runs on. Controls whether WindowControls
+     * renders (hidden on macOS) and how the brand cluster is spaced (shifted
+     * right on macOS to avoid the native traffic-light buttons). The host
+     * decides — Loom never sniffs the OS at runtime.
+     */
+    platform?: WindowPlatform;
+    /** Passed through to WindowControls (host-side i18n); omit for its English defaults. */
+    windowControlsLabels?: WindowControlsLabels;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    select: (command: string) => any;
+    close: () => any;
+    minimize: () => any;
+    maximize: () => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /** The host app's brand name — required: this block has no identity of its own. */
+    appName: string;
+    /** Centered subtitle — usually the open project / composition. */
+    title?: string;
+    menus?: MenubarMenu[];
+    isMaximized?: boolean;
+    /**
+     * The desktop platform the window runs on. Controls whether WindowControls
+     * renders (hidden on macOS) and how the brand cluster is spaced (shifted
+     * right on macOS to avoid the native traffic-light buttons). The host
+     * decides — Loom never sniffs the OS at runtime.
+     */
+    platform?: WindowPlatform;
+    /** Passed through to WindowControls (host-side i18n); omit for its English defaults. */
+    windowControlsLabels?: WindowControlsLabels;
+}> & Readonly<{
+    onSelect?: (command: string) => any;
+    onClose?: () => any;
+    onMinimize?: () => any;
+    onMaximize?: () => any;
+}>, {
+    title: string;
+    menus: MenubarMenu[];
+    platform: WindowPlatform;
+    isMaximized: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    brandIcon?: (props: {}) => any;
+} & {
+    brandMark?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=TitleBar.vue.d.ts.map

package/dist/packages/blocks/title-bar/src/TitleBar.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,69 @@
+import { optional } from "../../../core/src/props.js";
+import "../../../core/src/index.js";
+import Menubar_default from "../../../primitives/menubar/src/Menubar.js";
+import "../../../primitives/menubar/src/index.js";
+import WindowControls_default from "../../../primitives/window-controls/src/WindowControls.js";
+import "../../../primitives/window-controls/src/index.js";
+import { createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, mergeProps, normalizeClass, openBlock, renderSlot, toDisplayString, unref } from "vue";
+//#region packages/blocks/title-bar/src/TitleBar.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = {
+	"data-loom-titlebar": "",
+	class: "flex h-9 select-none items-center border-b border-border bg-card text-foreground",
+	style: { "-webkit-app-region": "drag" }
+};
+var _hoisted_2 = {
+	class: "grid h-4 w-4 place-items-center rounded-[5px] bg-primary text-primary-foreground shadow-sm",
+	"aria-hidden": "true"
+};
+var _hoisted_3 = { class: "text-xs font-semibold tracking-tight" };
+var _hoisted_4 = { class: "flex min-w-0 flex-1 items-center justify-center overflow-hidden px-4" };
+var _hoisted_5 = {
+	key: 0,
+	class: "truncate text-xs text-muted-foreground"
+};
+var TitleBar_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "TitleBar",
+	props: {
+		appName: {},
+		title: { default: "" },
+		menus: { default: () => [] },
+		isMaximized: {
+			type: Boolean,
+			default: false
+		},
+		platform: { default: "windows" },
+		windowControlsLabels: {}
+	},
+	emits: [
+		"select",
+		"minimize",
+		"maximize",
+		"close"
+	],
+	setup(__props, { emit: __emit }) {
+		const emit = __emit;
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("header", _hoisted_1, [
+				createElementVNode("div", { class: normalizeClass(["flex shrink-0 items-center gap-2 pr-1.5", __props.platform === "macos" ? "pl-[4.5rem]" : "pl-3"]) }, [renderSlot(_ctx.$slots, "brandIcon", {}, () => [createElementVNode("span", _hoisted_2, [renderSlot(_ctx.$slots, "brandMark")])]), createElementVNode("span", _hoisted_3, toDisplayString(__props.appName), 1)], 2),
+				__props.menus.length ? (openBlock(), createBlock(unref(Menubar_default), {
+					key: 0,
+					menus: __props.menus,
+					onSelect: _cache[0] || (_cache[0] = ($event) => emit("select", $event))
+				}, null, 8, ["menus"])) : createCommentVNode("", true),
+				createElementVNode("div", _hoisted_4, [__props.title ? (openBlock(), createElementBlock("span", _hoisted_5, toDisplayString(__props.title), 1)) : createCommentVNode("", true)]),
+				createVNode(unref(WindowControls_default), mergeProps({
+					platform: __props.platform,
+					"is-maximized": __props.isMaximized
+				}, unref(optional)({ labels: __props.windowControlsLabels }), {
+					onMinimize: _cache[1] || (_cache[1] = ($event) => emit("minimize")),
+					onMaximize: _cache[2] || (_cache[2] = ($event) => emit("maximize")),
+					onClose: _cache[3] || (_cache[3] = ($event) => emit("close"))
+				}), null, 16, ["platform", "is-maximized"])
+			]);
+		};
+	}
+});
+//#endregion
+export { TitleBar_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=TitleBar.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/blocks/title-bar/src/TitleBar.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TitleBar.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../../packages/blocks/title-bar/src/TitleBar.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * TitleBar — a desktop app's custom window chrome (a block: composed from\n * primitives, domain-aware, but still presentational). Layout:\n *\n *   Windows / Linux:\n *   [ ⬡ brand ] [ File View Help ]  ····· drag / title ····· [ – ▢ ✕ ]\n *\n *   macOS (native traffic-lights on the left):\n *   [ 🔴🟡🟢   ⬡ brand ] [ File View Help ]  ····· drag / title ·····\n *\n * The whole bar is a drag region (`-webkit-app-region: drag`); the interactive\n * clusters (Menubar, WindowControls) opt back out. It owns NO app logic — it\n * re-emits `select` from the menu and the window intents, so the desktop host\n * wires the window bridge around it.\n *\n * `platform` is the host's declaration, not a runtime sniff: a Tauri/Electron\n * host already knows its OS, and a PWA has no native window controls. On macOS\n * the brand cluster shifts right to leave room for the native traffic-light\n * buttons, and WindowControls renders nothing (the OS owns those buttons).\n */\nimport type { MenubarMenu } from \"@ecoma-io/loom-menubar\";\nimport type { WindowPlatform } from \"@ecoma-io/loom-window-controls\";\n</script>\n\n<script setup lang=\"ts\">\nimport Menubar from \"@ecoma-io/loom-menubar\";\nimport WindowControls, { type WindowControlsLabels } from \"@ecoma-io/loom-window-controls\";\nimport { optional } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** The host app's brand name — required: this block has no identity of its own. */\n    appName: string;\n    /** Centered subtitle — usually the open project / composition. */\n    title?: string;\n    menus?: MenubarMenu[];\n    isMaximized?: boolean;\n    /**\n     * The desktop platform the window runs on. Controls whether WindowControls\n     * renders (hidden on macOS) and how the brand cluster is spaced (shifted\n     * right on macOS to avoid the native traffic-light buttons). The host\n     * decides — Loom never sniffs the OS at runtime.\n     */\n    platform?: WindowPlatform;\n    /** Passed through to WindowControls (host-side i18n); omit for its English defaults. */\n    windowControlsLabels?: WindowControlsLabels;\n  }>(),\n  {\n    title: \"\",\n    menus: () => [],\n    isMaximized: false,\n    platform: \"windows\",\n  },\n);\n\nconst emit = defineEmits<{\n  (e: \"select\", command: string): void;\n  (e: \"minimize\"): void;\n  (e: \"maximize\"): void;\n  (e: \"close\"): void;\n}>();\n</script>\n\n<template>\n  <header\n    data-loom-titlebar\n    class=\"flex h-9 select-none items-center border-b border-border bg-card text-foreground\"\n    style=\"-webkit-app-region: drag\"\n  >\n    <!-- Brand. Deliberately NOT `no-drag`: nothing here is interactive, and the\n         logo corner is the spot people reach for to move a window — opting it\n         out of the drag region would take that away and give nothing back.\n         Only the clusters that actually take clicks (Menubar, WindowControls)\n         opt out.\n\n         On macOS the brand cluster shifts right to leave room for the native\n         traffic-light buttons. The 4.5rem (72px) covers the three 12px\n         buttons plus their 8px left margin and 4px inter-button gap, matching\n         what macOS draws at the default window scale. -->\n    <div\n      class=\"flex shrink-0 items-center gap-2 pr-1.5\"\n      :class=\"platform === 'macos' ? 'pl-[4.5rem]' : 'pl-3'\"\n    >\n      <!-- @slot Brand icon — the consumer provides their own mark. Rendered\n           inside a 16px coloured tile, `aria-hidden` by the container. -->\n      <slot name=\"brandIcon\">\n        <span\n          class=\"grid h-4 w-4 place-items-center rounded-[5px] bg-primary text-primary-foreground shadow-sm\"\n          aria-hidden=\"true\"\n        >\n          <!-- stroke bumped for optical balance at tiny size -->\n          <slot name=\"brandMark\" />\n        </span>\n      </slot>\n      <span class=\"text-xs font-semibold tracking-tight\">{{ appName }}</span>\n    </div>\n\n    <!-- Menu bar -->\n    <Menubar v-if=\"menus.length\" :menus=\"menus\" @select=\"emit('select', $event)\" />\n\n    <!-- Draggable spacer + centered title -->\n    <div class=\"flex min-w-0 flex-1 items-center justify-center overflow-hidden px-4\">\n      <span v-if=\"title\" class=\"truncate text-xs text-muted-foreground\">{{ title }}</span>\n    </div>\n\n    <!-- Window controls (hidden on macOS — the OS draws its own) -->\n    <WindowControls\n      :platform=\"platform\"\n      :is-maximized=\"isMaximized\"\n      v-bind=\"optional({ labels: windowControlsLabels })\"\n      @minimize=\"emit('minimize')\"\n      @maximize=\"emit('maximize')\"\n      @close=\"emit('close')\"\n    />\n  </header>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDA,MAAM,OAAO;;GASX,OAAA,UAAA,GAAA,mBAkDS,UAlDT,YAkDS;IAnCP,mBAgBM,OAAA,EAfJ,OAAK,eAAA,CAAC,2CACE,QAAA,aAAQ,UAAA,gBAAA,MAAA,CAAA,EAAA,GAAA,CAIhB,WAQO,KAAA,QAAA,aAAA,CAAA,SAAA,CAPL,mBAMO,QANP,YAMO,CADL,WAAyB,KAAA,QAAA,WAAA,CAAA,CAAA,CAAA,CAAA,GAG7B,mBAAuE,QAAvE,YAAuE,gBAAjB,QAAA,OAAO,GAAA,CAAA,CAAA,GAAA,CAAA;IAIhD,QAAA,MAAM,UAArB,UAAA,GAAA,YAA+E,MAAA,eAAA,GAAA;;KAAjD,OAAO,QAAA;KAAQ,UAAM,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,UAAW,MAAM;;IAG1E,mBAEM,OAFN,YAEM,CADQ,QAAA,SAAZ,UAAA,GAAA,mBAAoF,QAApF,YAAoF,gBAAf,QAAA,KAAK,GAAA,CAAA,KAAA,mBAAA,IAAA,IAAA,CAAA,CAAA;IAI5E,YAOE,MAAA,sBAAA,GAPF,WAOE;KANC,UAAU,QAAA;KACV,gBAAc,QAAA;IACP,GAAA,MAAA,QAAA,CAAQ,CAAA,EAAA,QAAW,QAAA,qBAAoB,CAAA,GAAA;KAC9C,YAAQ,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,UAAA;KACd,YAAQ,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,UAAA;KACd,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,OAAA"}

package/dist/packages/blocks/title-bar/src/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./TitleBar.vue";
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/blocks/title-bar/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/blocks/title-bar/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/packages/blocks/title-bar/src/index.js

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

package/dist/packages/blocks/toast-stack/src/ToastStack.js

@@ -0,0 +1,7 @@
+import ToastStack_vue_vue_type_script_setup_true_lang_default from "./ToastStack.vue_vue_type_script_setup_true_lang.js";
+//#region packages/blocks/toast-stack/src/ToastStack.vue
+var ToastStack_default = ToastStack_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { ToastStack_default as default };
+
+//# sourceMappingURL=ToastStack.js.map

package/dist/packages/blocks/toast-stack/src/ToastStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToastStack.js","names":[],"sources":["../../../../../packages/blocks/toast-stack/src/ToastStack.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { ToastVariant } from \"@ecoma-io/loom-toast\";\n\n/** One entry of a host-owned toast queue, rendered by `ToastStack`. */\nexport interface ToastStackItem {\n  readonly id: string | number;\n  readonly title: string;\n  readonly description?: string;\n  readonly variant?: ToastVariant;\n  /** ms before auto-dismiss (default 4000 — a stack turns over faster than a lone toast). */\n  readonly duration?: number;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from \"vue\";\nimport { ToastProvider, ToastViewport } from \"reka-ui\";\nimport { optional } from \"@ecoma-io/loom-core\";\nimport { useLabels, type LabelOverrides } from \"@ecoma-io/loom-labels\";\nimport { ToastItem, TOAST_LABELS, type ToastLabels } from \"@ecoma-io/loom-toast\";\n\n/**\n * ToastStack — renders a host-owned toast queue through ONE shared\n * provider/viewport, so simultaneous toasts stack vertically with a gap\n * instead of piling onto the same fixed corner (which is what N standalone\n * `Toast`s produce — each bundles its own viewport at the same coordinates).\n *\n * The queue stays the host's: the host passes the visible entries and\n * removes an entry when `dismiss` fires — on close, swipe, Esc, or\n * auto-dismiss alike. This block owns only the shared-viewport treatment.\n * Every rendered item is driven with `open` fixed to `true` — `ToastStack`\n * decides an entry is visible by including it in `items`, never by an\n * item's own open state, so there is no per-item boolean left unset for\n * Vue's absent-prop casting to catch.\n *\n * The viewport's geometry is written for the two ends of the range it\n * actually lands in. Width is `min(92vw, 24rem)`, so a phone gets a\n * near-full-bleed card and a desktop a bounded one. The bottom inset\n * resolves through `env(safe-area-inset-bottom)` — on a device with a home\n * indicator a flat `p-4` puts the newest toast, and its dismiss control,\n * under the system gesture bar. And the stack is height-bounded\n * (`max-h-dvh` + `overflow-hidden`) so a host that hands over more entries\n * than fit pushes the oldest off the top rather than growing a column\n * taller than the screen. `dvh`, not `vh`: mobile browser chrome collapses\n * the visual viewport and `vh` does not follow.\n */\nconst props = defineProps<{\n  /** The host's visible toast queue, oldest first. */\n  items: readonly ToastStackItem[];\n  /**\n   * Names for the two things the shared region says out loud, as any subset of\n   * `ToastLabels` — the rest stay as the host's `provideLoomLabels` vocabulary\n   * left them, and then as Loom's English.\n   *\n   * It resolves the same `toast` slot each `ToastItem` does, so a host that has\n   * localised toasts anywhere has localised this too and needs nothing here.\n   */\n  labels?: LabelOverrides<ToastLabels>;\n}>();\n\ndefineEmits<{ dismiss: [id: string | number] }>();\n\n// This block owns a provider and a viewport of its own rather than borrowing\n// `Toast`'s, which is the whole point of it — and that means it owns their two\n// names as well. Left unset they are not unnamed: Reka defaults them to\n// \"Notification\" and \"Notifications ({hotkey})\", English a host has no prop to\n// reach, in the one live region a screen reader is sent to by a hotkey.\nconst text = useLabels(\"toast\", TOAST_LABELS, () => props.labels);\n\n// The function form rather than Reka's `{hotkey}` template, for the reason\n// `Toast.vue` gives: the hole would be Loom deciding where the key sits in the\n// phrase, and that is a property of the language.\nconst regionLabel = computed(() => (hotkey: string) => text.value.region({ hotkey }));\n</script>\n\n<template>\n  <ToastProvider :label=\"text.announce\">\n    <ToastItem\n      v-for=\"item in items\"\n      :key=\"item.id\"\n      :open=\"true\"\n      :title=\"item.title\"\n      v-bind=\"optional({ description: item.description, variant: item.variant })\"\n      :duration=\"item.duration ?? 4000\"\n      @update:open=\"(open) => !open && $emit('dismiss', item.id)\"\n    />\n\n    <ToastViewport\n      :label=\"regionLabel\"\n      class=\"fixed bottom-0 right-0 z-toast flex max-h-dvh w-[min(92vw,24rem)] flex-col gap-2 overflow-hidden p-4 pb-[max(1rem,env(safe-area-inset-bottom))] outline-none\"\n    />\n  </ToastProvider>\n</template>\n"],"mappings":""}

package/dist/packages/blocks/toast-stack/src/ToastStack.vue.d.ts

@@ -0,0 +1,44 @@
+import { type LabelOverrides } from "../../../labels/src/index";
+import { type ToastLabels } from "../../../primitives/toast/src/index";
+import type { ToastVariant } from "../../../primitives/toast/src/index";
+/** One entry of a host-owned toast queue, rendered by `ToastStack`. */
+export interface ToastStackItem {
+    readonly id: string | number;
+    readonly title: string;
+    readonly description?: string;
+    readonly variant?: ToastVariant;
+    /** ms before auto-dismiss (default 4000 — a stack turns over faster than a lone toast). */
+    readonly duration?: number;
+}
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    /** The host's visible toast queue, oldest first. */
+    items: readonly ToastStackItem[];
+    /**
+     * Names for the two things the shared region says out loud, as any subset of
+     * `ToastLabels` — the rest stay as the host's `provideLoomLabels` vocabulary
+     * left them, and then as Loom's English.
+     *
+     * It resolves the same `toast` slot each `ToastItem` does, so a host that has
+     * localised toasts anywhere has localised this too and needs nothing here.
+     */
+    labels?: LabelOverrides<ToastLabels>;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    dismiss: (id: string | number) => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /** The host's visible toast queue, oldest first. */
+    items: readonly ToastStackItem[];
+    /**
+     * Names for the two things the shared region says out loud, as any subset of
+     * `ToastLabels` — the rest stay as the host's `provideLoomLabels` vocabulary
+     * left them, and then as Loom's English.
+     *
+     * It resolves the same `toast` slot each `ToastItem` does, so a host that has
+     * localised toasts anywhere has localised this too and needs nothing here.
+     */
+    labels?: LabelOverrides<ToastLabels>;
+}> & Readonly<{
+    onDismiss?: (id: string | number) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+//# sourceMappingURL=ToastStack.vue.d.ts.map

package/dist/packages/blocks/toast-stack/src/ToastStack.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,52 @@
+import { optional } from "../../../core/src/props.js";
+import "../../../core/src/index.js";
+import { useLabels } from "../../../labels/src/labels.js";
+import "../../../labels/src/index.js";
+import { TOAST_LABELS } from "../../../primitives/toast/src/ToastItem.vue_vue_type_script_setup_true_lang.js";
+import ToastItem_default from "../../../primitives/toast/src/ToastItem.js";
+import "../../../primitives/toast/src/index.js";
+import { Fragment, computed, createBlock, createElementBlock, createVNode, defineComponent, mergeProps, openBlock, renderList, unref, withCtx } from "vue";
+import { ToastProvider, ToastViewport } from "reka-ui";
+//#region packages/blocks/toast-stack/src/ToastStack.vue?vue&type=script&setup=true&lang.ts
+var ToastStack_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "ToastStack",
+	props: {
+		items: {},
+		labels: {}
+	},
+	emits: ["dismiss"],
+	setup(__props) {
+		const props = __props;
+		const text = useLabels("toast", TOAST_LABELS, () => props.labels);
+		const regionLabel = computed(() => (hotkey) => text.value.region({ hotkey }));
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(ToastProvider), { label: unref(text).announce }, {
+				default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item) => {
+					return openBlock(), createBlock(unref(ToastItem_default), mergeProps({
+						key: item.id,
+						open: true,
+						title: item.title
+					}, { ref_for: true }, unref(optional)({
+						description: item.description,
+						variant: item.variant
+					}), {
+						duration: item.duration ?? 4e3,
+						"onUpdate:open": (open) => !open && _ctx.$emit("dismiss", item.id)
+					}), null, 16, [
+						"title",
+						"duration",
+						"onUpdate:open"
+					]);
+				}), 128)), createVNode(unref(ToastViewport), {
+					label: regionLabel.value,
+					class: "fixed bottom-0 right-0 z-toast flex max-h-dvh w-[min(92vw,24rem)] flex-col gap-2 overflow-hidden p-4 pb-[max(1rem,env(safe-area-inset-bottom))] outline-none"
+				}, null, 8, ["label"])]),
+				_: 1
+			}, 8, ["label"]);
+		};
+	}
+});
+//#endregion
+export { ToastStack_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=ToastStack.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/blocks/toast-stack/src/ToastStack.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToastStack.vue_vue_type_script_setup_true_lang.js","names":["$emit"],"sources":["../../../../../packages/blocks/toast-stack/src/ToastStack.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { ToastVariant } from \"@ecoma-io/loom-toast\";\n\n/** One entry of a host-owned toast queue, rendered by `ToastStack`. */\nexport interface ToastStackItem {\n  readonly id: string | number;\n  readonly title: string;\n  readonly description?: string;\n  readonly variant?: ToastVariant;\n  /** ms before auto-dismiss (default 4000 — a stack turns over faster than a lone toast). */\n  readonly duration?: number;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from \"vue\";\nimport { ToastProvider, ToastViewport } from \"reka-ui\";\nimport { optional } from \"@ecoma-io/loom-core\";\nimport { useLabels, type LabelOverrides } from \"@ecoma-io/loom-labels\";\nimport { ToastItem, TOAST_LABELS, type ToastLabels } from \"@ecoma-io/loom-toast\";\n\n/**\n * ToastStack — renders a host-owned toast queue through ONE shared\n * provider/viewport, so simultaneous toasts stack vertically with a gap\n * instead of piling onto the same fixed corner (which is what N standalone\n * `Toast`s produce — each bundles its own viewport at the same coordinates).\n *\n * The queue stays the host's: the host passes the visible entries and\n * removes an entry when `dismiss` fires — on close, swipe, Esc, or\n * auto-dismiss alike. This block owns only the shared-viewport treatment.\n * Every rendered item is driven with `open` fixed to `true` — `ToastStack`\n * decides an entry is visible by including it in `items`, never by an\n * item's own open state, so there is no per-item boolean left unset for\n * Vue's absent-prop casting to catch.\n *\n * The viewport's geometry is written for the two ends of the range it\n * actually lands in. Width is `min(92vw, 24rem)`, so a phone gets a\n * near-full-bleed card and a desktop a bounded one. The bottom inset\n * resolves through `env(safe-area-inset-bottom)` — on a device with a home\n * indicator a flat `p-4` puts the newest toast, and its dismiss control,\n * under the system gesture bar. And the stack is height-bounded\n * (`max-h-dvh` + `overflow-hidden`) so a host that hands over more entries\n * than fit pushes the oldest off the top rather than growing a column\n * taller than the screen. `dvh`, not `vh`: mobile browser chrome collapses\n * the visual viewport and `vh` does not follow.\n */\nconst props = defineProps<{\n  /** The host's visible toast queue, oldest first. */\n  items: readonly ToastStackItem[];\n  /**\n   * Names for the two things the shared region says out loud, as any subset of\n   * `ToastLabels` — the rest stay as the host's `provideLoomLabels` vocabulary\n   * left them, and then as Loom's English.\n   *\n   * It resolves the same `toast` slot each `ToastItem` does, so a host that has\n   * localised toasts anywhere has localised this too and needs nothing here.\n   */\n  labels?: LabelOverrides<ToastLabels>;\n}>();\n\ndefineEmits<{ dismiss: [id: string | number] }>();\n\n// This block owns a provider and a viewport of its own rather than borrowing\n// `Toast`'s, which is the whole point of it — and that means it owns their two\n// names as well. Left unset they are not unnamed: Reka defaults them to\n// \"Notification\" and \"Notifications ({hotkey})\", English a host has no prop to\n// reach, in the one live region a screen reader is sent to by a hotkey.\nconst text = useLabels(\"toast\", TOAST_LABELS, () => props.labels);\n\n// The function form rather than Reka's `{hotkey}` template, for the reason\n// `Toast.vue` gives: the hole would be Loom deciding where the key sits in the\n// phrase, and that is a property of the language.\nconst regionLabel = computed(() => (hotkey: string) => text.value.region({ hotkey }));\n</script>\n\n<template>\n  <ToastProvider :label=\"text.announce\">\n    <ToastItem\n      v-for=\"item in items\"\n      :key=\"item.id\"\n      :open=\"true\"\n      :title=\"item.title\"\n      v-bind=\"optional({ description: item.description, variant: item.variant })\"\n      :duration=\"item.duration ?? 4000\"\n      @update:open=\"(open) => !open && $emit('dismiss', item.id)\"\n    />\n\n    <ToastViewport\n      :label=\"regionLabel\"\n      class=\"fixed bottom-0 right-0 z-toast flex max-h-dvh w-[min(92vw,24rem)] flex-col gap-2 overflow-hidden p-4 pb-[max(1rem,env(safe-area-inset-bottom))] outline-none\"\n    />\n  </ToastProvider>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;EA8CA,MAAM,QAAQ;EAqBd,MAAM,OAAO,UAAU,SAAS,oBAAoB,MAAM,MAAM;EAKhE,MAAM,cAAc,gBAAgB,WAAmB,KAAK,MAAM,OAAO,EAAE,OAAO,CAAC,CAAC;;GAIlF,OAAA,UAAA,GAAA,YAegB,MAAA,aAAA,GAAA,EAfA,OAAO,MAAA,IAAA,CAAI,CAAC,SAAA,GAAA;IAExB,SAAA,cAAqB,EADvB,UAAA,IAAA,GAAA,mBAQE,UAAA,MAAA,WAPe,QAAA,QAAR,SAAI;KADb,OAAA,UAAA,GAAA,YAQE,MAAA,iBAAA,GARF,WAQE;MANC,KAAK,KAAK;MACV,MAAM;MACN,OAAO,KAAK;KACL,GAAA,EAAA,SAAA,KAAA,GAAA,MAAA,QAAA,CAAQ,CAAA;MAAA,aAAgB,KAAK;MAAW,SAAW,KAAK;KAAO,CAAA,GAAA;MACtE,UAAU,KAAK,YAAQ;MACvB,kBAAc,SAAI,CAAM,QAAQA,KAAAA,MAAK,WAAY,KAAK,EAAE;;;;;;IAG3D,CAAA,GAAA,GAAA,IAAA,YAGE,MAAA,aAAA,GAAA;KAFC,OAAO,YAAA;KACR,OAAM"}

package/dist/packages/blocks/toast-stack/src/index.d.ts

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

package/dist/packages/blocks/toast-stack/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/blocks/toast-stack/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}