@ecoma-io/loom 0.2.0 → 0.3.0

package/dist/packages/primitives/alert-dialog/src/AlertDialog.js

@@ -0,0 +1,7 @@
+import AlertDialog_vue_vue_type_script_setup_true_lang_default, { ALERT_DIALOG_LABELS } from "./AlertDialog.vue_vue_type_script_setup_true_lang.js";
+//#region packages/primitives/alert-dialog/src/AlertDialog.vue
+var AlertDialog_default = AlertDialog_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { ALERT_DIALOG_LABELS, AlertDialog_default as default };
+
+//# sourceMappingURL=AlertDialog.js.map

package/dist/packages/primitives/alert-dialog/src/AlertDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertDialog.js","names":[],"sources":["../../../../../packages/primitives/alert-dialog/src/AlertDialog.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { AlertDialogLabels } 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 ALERT_DIALOG_LABELS: AlertDialogLabels = {\n  confirm: \"Confirm\",\n  cancel: \"Cancel\",\n};\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from \"vue\";\nimport {\n  AlertDialogRoot,\n  AlertDialogTrigger,\n  AlertDialogPortal,\n  AlertDialogOverlay,\n  AlertDialogContent,\n  AlertDialogTitle,\n  AlertDialogDescription,\n  AlertDialogAction,\n  AlertDialogCancel,\n} from \"reka-ui\";\nimport { cn } from \"@ecoma-io/loom-core\";\nimport { optional } from \"@ecoma-io/loom-core\";\nimport { useSplitAttrs } from \"@ecoma-io/loom-core\";\nimport { buttonVariants } from \"@ecoma-io/loom-button\";\nimport { useLabels, type LabelOverrides } from \"@ecoma-io/loom-labels\";\n\n/**\n * AlertDialog — the modal that demands a decision before anything else\n * happens: \"Delete this permanently?\", \"Discard unsaved changes?\".\n *\n * It is `Dialog` with the exits removed, and that is the whole of the\n * difference. A `Dialog` is dismissible: Esc, a click on the overlay and the\n * close glyph all mean \"not now\", which is right for a task surface. An\n * AlertDialog has no such exit — a click outside does nothing, there is no\n * close glyph, and the only ways out are the two buttons. It carries\n * `role=\"alertdialog\"`, so its description is announced with its name rather\n * than waiting to be navigated to.\n *\n * Reach for it only when dismissing by accident would lose work or destroy\n * something. Reach for `Dialog` for everything else — an AlertDialog used for\n * an ordinary form is a control that traps a reader for no reason.\n *\n * There is deliberately no body slot. A question that needs body content is a\n * task, and a task is a `Dialog`; keeping the surface to a title, a\n * consequence line and two buttons is what stops this component from becoming\n * an undismissible form.\n *\n * Initial focus lands on **Cancel**, never on the action. A destructive\n * confirm that focuses \"Delete\" turns a reflexive Enter — from a reader who\n * has not finished the sentence — into a deletion. Reka does this in\n * `AlertDialogContent`; the test pins it, because it is the single behaviour\n * this component exists to guarantee.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** Drive the alert from the host with `v-model:open`; omit it and the alert owns its own state. */\n    open?: boolean | undefined;\n    /** The accessible name, and the decision being asked for. State the consequence (\"Delete scene?\"), not \"Are you sure?\". */\n    title: string;\n    /** The consequence line, announced with the title rather than found later. Omit it only when the title already says everything. */\n    description?: string;\n    /** Paints the action in the destructive language. The verb in `labels.confirm` is what carries the meaning; this only adds emphasis to it. */\n    destructive?: boolean;\n    /**\n     * The two button names, as any subset of `AlertDialogLabels` — what it\n     * leaves out stays as the host's `provideLoomLabels` vocabulary left it,\n     * and then as Loom's English.\n     *\n     * **`confirm` is meant to be set here on all but the rarest alert**, since\n     * the verb is what tells a reader what the button does; `cancel` belongs in\n     * the application's vocabulary, where it is written once.\n     */\n    labels?: LabelOverrides<AlertDialogLabels>;\n  }>(),\n  // `open: undefined` is load-bearing, not a redundant default — it is what\n  // keeps the uncontrolled third state reachable past Vue's absent-Boolean\n  // casting, and `optional()` in the template is the other half. Its docblock\n  // carries the reasoning for both.\n  {\n    open: undefined,\n    destructive: false,\n  },\n);\n\ndefineEmits<{\n  /** The reader chose the action. The alert does not close itself — the host decides, so a failed save can keep it open. */\n  confirm: [];\n  /** The reader backed out, by the cancel button or by Esc. */\n  cancel: [];\n  /** A close was requested. Fires alongside `confirm` and `cancel`, so a host driving `v-model:open` needs only this one. */\n  \"update:open\": [value: boolean];\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(\"alertDialog\", ALERT_DIALOG_LABELS, () => props.labels);\n\n// The root renders no DOM node at all, so fallthrough attributes would be\n// dropped on the floor rather than landing anywhere. They go to the panel,\n// which is the only element this component reliably renders — there may be no\n// trigger at all when the host drives `open` itself.\n//\n// `class` is pulled out of that spread and merged through `cn()` instead:\n// spreading it alongside the panel's own `:class` only concatenates the two\n// lists, so a caller's width silently wins or loses depending on which utility\n// Tailwind happened to emit last.\ndefineOptions({ inheritAttrs: false });\nconst { attrs, rest: panelAttrs } = useSplitAttrs();\n\n// Reka wires `aria-describedby` to its own description id unconditionally, so\n// a panel rendered without a description ships a reference to an element that\n// does not exist. That is not cosmetic here: `role=\"alertdialog\"` earns its\n// keep by having the description announced with the name, and a dangling IDREF\n// announces nothing. Clearing the attribute is what removes it — fallthrough\n// attributes are merged after Reka's own, and Vue drops an attribute bound to\n// `undefined`. A caller's own `aria-describedby` still wins, because\n// `panelAttrs` is spread last.\nconst panelBindings = computed(() => ({\n  ...(props.description ? {} : { \"aria-describedby\": undefined }),\n  ...panelAttrs.value,\n}));\n</script>\n\n<template>\n  <AlertDialogRoot v-bind=\"optional({ open })\" @update:open=\"$emit('update:open', $event)\">\n    <!-- @slot The control that opens the alert. Optional — omit it and drive\n         the alert entirely from the host with `v-model:open`. -->\n    <AlertDialogTrigger v-if=\"$slots.trigger\" as-child>\n      <slot name=\"trigger\" />\n    </AlertDialogTrigger>\n\n    <AlertDialogPortal>\n      <!-- Same scrim as Dialog, and it is inert here: Reka's AlertDialogContent\n           prevents both `pointerDownOutside` and `interactOutside`, so a click\n           lands on nothing. That is the point — an accidental click at the edge\n           of the screen must not be able to answer the question. -->\n      <AlertDialogOverlay\n        class=\"fixed inset-0 z-50 bg-foreground/70 data-[state=open]:animate-fade\"\n      />\n      <AlertDialogContent\n        v-bind=\"panelBindings\"\n        :data-destructive=\"destructive || undefined\"\n        :class=\"\n          cn(\n            'fixed left-1/2 top-1/2 z-50 -translate-x-1/2 -translate-y-1/2',\n            // One width, and no `size` prop to vary it. A decision has one\n            // shape; the wider panels exist on Dialog because an authoring\n            // surface needs them, and there is no authoring surface here.\n            'w-[min(92vw,32rem)]',\n            'rounded-lg border border-border bg-popover p-6 text-popover-foreground shadow-lg outline-none',\n            // Scoped to the open state, never unconditional. Reka's Presence\n            // keeps closed content mounted until an animationend arrives, and a\n            // mount-only animation never fires a second one — which here would\n            // strand a full-screen, input-blocking overlay over a page with no\n            // alert on it. Scoped, the closed element computes\n            // `animation-name: none` and Presence unmounts it at once.\n            'data-[state=open]:animate-scale-in',\n            attrs.class as string,\n          )\n        \"\n        @escape-key-down=\"$emit('cancel')\"\n      >\n        <AlertDialogTitle class=\"text-base font-semibold\">{{ title }}</AlertDialogTitle>\n        <AlertDialogDescription v-if=\"description\" class=\"mt-1 text-sm text-muted-foreground\">\n          {{ description }}\n        </AlertDialogDescription>\n\n        <div class=\"mt-6 flex items-center justify-end gap-2\">\n          <!-- Cancel is first in the DOM as well as first visually, so the\n               order a screen reader reads matches the order the eye does. It is\n               also the element Reka focuses on open. -->\n          <AlertDialogCancel\n            :class=\"buttonVariants({ variant: 'subtle' })\"\n            @click=\"$emit('cancel')\"\n          >\n            {{ text.cancel }}\n          </AlertDialogCancel>\n          <!-- The destructive paint is emphasis, not the signal. What tells a\n               reader this button destroys something is the verb in its label,\n               which is why `labels.confirm` is meant to be replaced rather than\n               left as \"Confirm\". -->\n          <AlertDialogAction\n            :class=\"buttonVariants({ variant: destructive ? 'destructive' : 'primary' })\"\n            @click=\"$emit('confirm')\"\n          >\n            {{ text.confirm }}\n          </AlertDialogAction>\n        </div>\n      </AlertDialogContent>\n    </AlertDialogPortal>\n  </AlertDialogRoot>\n</template>\n"],"mappings":""}

package/dist/packages/primitives/alert-dialog/src/AlertDialog.vue.d.ts

@@ -0,0 +1,69 @@
+import { type LabelOverrides } from "@ecoma-io/loom-labels";
+import type { AlertDialogLabels } from "@ecoma-io/loom-labels";
+/**
+
+/**
+ * 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 ALERT_DIALOG_LABELS: AlertDialogLabels;
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    /** Drive the alert from the host with `v-model:open`; omit it and the alert owns its own state. */
+    open?: boolean | undefined;
+    /** The accessible name, and the decision being asked for. State the consequence ("Delete scene?"), not "Are you sure?". */
+    title: string;
+    /** The consequence line, announced with the title rather than found later. Omit it only when the title already says everything. */
+    description?: string;
+    /** Paints the action in the destructive language. The verb in `labels.confirm` is what carries the meaning; this only adds emphasis to it. */
+    destructive?: boolean;
+    /**
+     * The two button names, as any subset of `AlertDialogLabels` — what it
+     * leaves out stays as the host's `provideLoomLabels` vocabulary left it,
+     * and then as Loom's English.
+     *
+     * **`confirm` is meant to be set here on all but the rarest alert**, since
+     * the verb is what tells a reader what the button does; `cancel` belongs in
+     * the application's vocabulary, where it is written once.
+     */
+    labels?: LabelOverrides<AlertDialogLabels>;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+    cancel: () => any;
+    confirm: () => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /** Drive the alert from the host with `v-model:open`; omit it and the alert owns its own state. */
+    open?: boolean | undefined;
+    /** The accessible name, and the decision being asked for. State the consequence ("Delete scene?"), not "Are you sure?". */
+    title: string;
+    /** The consequence line, announced with the title rather than found later. Omit it only when the title already says everything. */
+    description?: string;
+    /** Paints the action in the destructive language. The verb in `labels.confirm` is what carries the meaning; this only adds emphasis to it. */
+    destructive?: boolean;
+    /**
+     * The two button names, as any subset of `AlertDialogLabels` — what it
+     * leaves out stays as the host's `provideLoomLabels` vocabulary left it,
+     * and then as Loom's English.
+     *
+     * **`confirm` is meant to be set here on all but the rarest alert**, since
+     * the verb is what tells a reader what the button does; `cancel` belongs in
+     * the application's vocabulary, where it is written once.
+     */
+    labels?: LabelOverrides<AlertDialogLabels>;
+}> & Readonly<{
+    "onUpdate:open"?: (value: boolean) => any;
+    onCancel?: () => any;
+    onConfirm?: () => any;
+}>, {
+    open: boolean | undefined;
+    destructive: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    trigger?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=AlertDialog.vue.d.ts.map

package/dist/packages/primitives/alert-dialog/src/AlertDialog.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertDialog.vue.d.ts","sourceRoot":"","sources":["../../../../../packages/primitives/alert-dialog/src/AlertDialog.vue"],"names":[],"mappings":"AA2NA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAGjC,CAAC;wBACmB,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IA6Bd,mGAAmG;WAC5F,OAAO,GAAG,SAAS;IAC1B,2HAA2H;WACpH,MAAM;IACb,mIAAmI;kBACrH,MAAM;IACpB,8IAA8I;kBAChI,OAAO;IACrB;;;;;;;;OAQG;aACM,cAAc,CAAC,iBAAiB,CAAC;;;;;;IAjB1C,mGAAmG;WAC5F,OAAO,GAAG,SAAS;IAC1B,2HAA2H;WACpH,MAAM;IACb,mIAAmI;kBACrH,MAAM;IACpB,8IAA8I;kBAChI,OAAO;IACrB;;;;;;;;OAQG;aACM,cAAc,CAAC,iBAAiB,CAAC;;;;;;UAhBnC,OAAO,GAAG,SAAS;iBAMZ,OAAO;;cAmVX,CAAC,KAAK,IAAiB,KAAK,GAAG;EAWzC,CAAC;AAWL,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/packages/primitives/alert-dialog/src/AlertDialog.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,104 @@
+import { cn } from "../../../core/src/cn.js";
+import { optional } from "../../../core/src/props.js";
+import { useSplitAttrs } from "../../../core/src/attrs.js";
+import "../../../core/src/index.js";
+import { useLabels } from "../../../labels/src/labels.js";
+import "../../../labels/src/index.js";
+import { buttonVariants } from "../../button/src/Button.vue_vue_type_script_setup_true_lang.js";
+import "../../button/src/index.js";
+import { computed, createBlock, createCommentVNode, createElementVNode, createTextVNode, createVNode, defineComponent, mergeProps, normalizeClass, openBlock, renderSlot, toDisplayString, unref, withCtx } from "vue";
+import { AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogOverlay, AlertDialogPortal, AlertDialogRoot, AlertDialogTitle, AlertDialogTrigger } from "reka-ui";
+//#region packages/primitives/alert-dialog/src/AlertDialog.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "mt-6 flex items-center justify-end gap-2" };
+/**
+
+/**
+* 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.
+*/
+var ALERT_DIALOG_LABELS = {
+	confirm: "Confirm",
+	cancel: "Cancel"
+};
+var AlertDialog_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	inheritAttrs: false,
+	__name: "AlertDialog",
+	props: {
+		open: {
+			type: Boolean,
+			default: void 0
+		},
+		title: {},
+		description: {},
+		destructive: {
+			type: Boolean,
+			default: false
+		},
+		labels: {}
+	},
+	emits: [
+		"confirm",
+		"cancel",
+		"update:open"
+	],
+	setup(__props) {
+		const props = __props;
+		const text = useLabels("alertDialog", ALERT_DIALOG_LABELS, () => props.labels);
+		const { attrs, rest: panelAttrs } = useSplitAttrs();
+		const panelBindings = computed(() => ({
+			...props.description ? {} : { "aria-describedby": void 0 },
+			...panelAttrs.value
+		}));
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(AlertDialogRoot), mergeProps(unref(optional)({ open: __props.open }), { "onUpdate:open": _cache[3] || (_cache[3] = ($event) => _ctx.$emit("update:open", $event)) }), {
+				default: withCtx(() => [_ctx.$slots.trigger ? (openBlock(), createBlock(unref(AlertDialogTrigger), {
+					key: 0,
+					"as-child": ""
+				}, {
+					default: withCtx(() => [renderSlot(_ctx.$slots, "trigger")]),
+					_: 3
+				})) : createCommentVNode("", true), createVNode(unref(AlertDialogPortal), null, {
+					default: withCtx(() => [createVNode(unref(AlertDialogOverlay), { class: "fixed inset-0 z-50 bg-foreground/70 data-[state=open]:animate-fade" }), createVNode(unref(AlertDialogContent), mergeProps(panelBindings.value, {
+						"data-destructive": __props.destructive || void 0,
+						class: unref(cn)("fixed left-1/2 top-1/2 z-50 -translate-x-1/2 -translate-y-1/2", "w-[min(92vw,32rem)]", "rounded-lg border border-border bg-popover p-6 text-popover-foreground shadow-lg outline-none", "data-[state=open]:animate-scale-in", unref(attrs).class),
+						onEscapeKeyDown: _cache[2] || (_cache[2] = ($event) => _ctx.$emit("cancel"))
+					}), {
+						default: withCtx(() => [
+							createVNode(unref(AlertDialogTitle), { class: "text-base font-semibold" }, {
+								default: withCtx(() => [createTextVNode(toDisplayString(__props.title), 1)]),
+								_: 1
+							}),
+							__props.description ? (openBlock(), createBlock(unref(AlertDialogDescription), {
+								key: 0,
+								class: "mt-1 text-sm text-muted-foreground"
+							}, {
+								default: withCtx(() => [createTextVNode(toDisplayString(__props.description), 1)]),
+								_: 1
+							})) : createCommentVNode("", true),
+							createElementVNode("div", _hoisted_1, [createVNode(unref(AlertDialogCancel), {
+								class: normalizeClass(unref(buttonVariants)({ variant: "subtle" })),
+								onClick: _cache[0] || (_cache[0] = ($event) => _ctx.$emit("cancel"))
+							}, {
+								default: withCtx(() => [createTextVNode(toDisplayString(unref(text).cancel), 1)]),
+								_: 1
+							}, 8, ["class"]), createVNode(unref(AlertDialogAction), {
+								class: normalizeClass(unref(buttonVariants)({ variant: __props.destructive ? "destructive" : "primary" })),
+								onClick: _cache[1] || (_cache[1] = ($event) => _ctx.$emit("confirm"))
+							}, {
+								default: withCtx(() => [createTextVNode(toDisplayString(unref(text).confirm), 1)]),
+								_: 1
+							}, 8, ["class"])])
+						]),
+						_: 1
+					}, 16, ["data-destructive", "class"])]),
+					_: 1
+				})]),
+				_: 3
+			}, 16);
+		};
+	}
+});
+//#endregion
+export { ALERT_DIALOG_LABELS, AlertDialog_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=AlertDialog.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/primitives/alert-dialog/src/AlertDialog.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertDialog.vue_vue_type_script_setup_true_lang.js","names":["$emit","$slots"],"sources":["../../../../../packages/primitives/alert-dialog/src/AlertDialog.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { AlertDialogLabels } 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 ALERT_DIALOG_LABELS: AlertDialogLabels = {\n  confirm: \"Confirm\",\n  cancel: \"Cancel\",\n};\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from \"vue\";\nimport {\n  AlertDialogRoot,\n  AlertDialogTrigger,\n  AlertDialogPortal,\n  AlertDialogOverlay,\n  AlertDialogContent,\n  AlertDialogTitle,\n  AlertDialogDescription,\n  AlertDialogAction,\n  AlertDialogCancel,\n} from \"reka-ui\";\nimport { cn } from \"@ecoma-io/loom-core\";\nimport { optional } from \"@ecoma-io/loom-core\";\nimport { useSplitAttrs } from \"@ecoma-io/loom-core\";\nimport { buttonVariants } from \"@ecoma-io/loom-button\";\nimport { useLabels, type LabelOverrides } from \"@ecoma-io/loom-labels\";\n\n/**\n * AlertDialog — the modal that demands a decision before anything else\n * happens: \"Delete this permanently?\", \"Discard unsaved changes?\".\n *\n * It is `Dialog` with the exits removed, and that is the whole of the\n * difference. A `Dialog` is dismissible: Esc, a click on the overlay and the\n * close glyph all mean \"not now\", which is right for a task surface. An\n * AlertDialog has no such exit — a click outside does nothing, there is no\n * close glyph, and the only ways out are the two buttons. It carries\n * `role=\"alertdialog\"`, so its description is announced with its name rather\n * than waiting to be navigated to.\n *\n * Reach for it only when dismissing by accident would lose work or destroy\n * something. Reach for `Dialog` for everything else — an AlertDialog used for\n * an ordinary form is a control that traps a reader for no reason.\n *\n * There is deliberately no body slot. A question that needs body content is a\n * task, and a task is a `Dialog`; keeping the surface to a title, a\n * consequence line and two buttons is what stops this component from becoming\n * an undismissible form.\n *\n * Initial focus lands on **Cancel**, never on the action. A destructive\n * confirm that focuses \"Delete\" turns a reflexive Enter — from a reader who\n * has not finished the sentence — into a deletion. Reka does this in\n * `AlertDialogContent`; the test pins it, because it is the single behaviour\n * this component exists to guarantee.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** Drive the alert from the host with `v-model:open`; omit it and the alert owns its own state. */\n    open?: boolean | undefined;\n    /** The accessible name, and the decision being asked for. State the consequence (\"Delete scene?\"), not \"Are you sure?\". */\n    title: string;\n    /** The consequence line, announced with the title rather than found later. Omit it only when the title already says everything. */\n    description?: string;\n    /** Paints the action in the destructive language. The verb in `labels.confirm` is what carries the meaning; this only adds emphasis to it. */\n    destructive?: boolean;\n    /**\n     * The two button names, as any subset of `AlertDialogLabels` — what it\n     * leaves out stays as the host's `provideLoomLabels` vocabulary left it,\n     * and then as Loom's English.\n     *\n     * **`confirm` is meant to be set here on all but the rarest alert**, since\n     * the verb is what tells a reader what the button does; `cancel` belongs in\n     * the application's vocabulary, where it is written once.\n     */\n    labels?: LabelOverrides<AlertDialogLabels>;\n  }>(),\n  // `open: undefined` is load-bearing, not a redundant default — it is what\n  // keeps the uncontrolled third state reachable past Vue's absent-Boolean\n  // casting, and `optional()` in the template is the other half. Its docblock\n  // carries the reasoning for both.\n  {\n    open: undefined,\n    destructive: false,\n  },\n);\n\ndefineEmits<{\n  /** The reader chose the action. The alert does not close itself — the host decides, so a failed save can keep it open. */\n  confirm: [];\n  /** The reader backed out, by the cancel button or by Esc. */\n  cancel: [];\n  /** A close was requested. Fires alongside `confirm` and `cancel`, so a host driving `v-model:open` needs only this one. */\n  \"update:open\": [value: boolean];\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(\"alertDialog\", ALERT_DIALOG_LABELS, () => props.labels);\n\n// The root renders no DOM node at all, so fallthrough attributes would be\n// dropped on the floor rather than landing anywhere. They go to the panel,\n// which is the only element this component reliably renders — there may be no\n// trigger at all when the host drives `open` itself.\n//\n// `class` is pulled out of that spread and merged through `cn()` instead:\n// spreading it alongside the panel's own `:class` only concatenates the two\n// lists, so a caller's width silently wins or loses depending on which utility\n// Tailwind happened to emit last.\ndefineOptions({ inheritAttrs: false });\nconst { attrs, rest: panelAttrs } = useSplitAttrs();\n\n// Reka wires `aria-describedby` to its own description id unconditionally, so\n// a panel rendered without a description ships a reference to an element that\n// does not exist. That is not cosmetic here: `role=\"alertdialog\"` earns its\n// keep by having the description announced with the name, and a dangling IDREF\n// announces nothing. Clearing the attribute is what removes it — fallthrough\n// attributes are merged after Reka's own, and Vue drops an attribute bound to\n// `undefined`. A caller's own `aria-describedby` still wins, because\n// `panelAttrs` is spread last.\nconst panelBindings = computed(() => ({\n  ...(props.description ? {} : { \"aria-describedby\": undefined }),\n  ...panelAttrs.value,\n}));\n</script>\n\n<template>\n  <AlertDialogRoot v-bind=\"optional({ open })\" @update:open=\"$emit('update:open', $event)\">\n    <!-- @slot The control that opens the alert. Optional — omit it and drive\n         the alert entirely from the host with `v-model:open`. -->\n    <AlertDialogTrigger v-if=\"$slots.trigger\" as-child>\n      <slot name=\"trigger\" />\n    </AlertDialogTrigger>\n\n    <AlertDialogPortal>\n      <!-- Same scrim as Dialog, and it is inert here: Reka's AlertDialogContent\n           prevents both `pointerDownOutside` and `interactOutside`, so a click\n           lands on nothing. That is the point — an accidental click at the edge\n           of the screen must not be able to answer the question. -->\n      <AlertDialogOverlay\n        class=\"fixed inset-0 z-50 bg-foreground/70 data-[state=open]:animate-fade\"\n      />\n      <AlertDialogContent\n        v-bind=\"panelBindings\"\n        :data-destructive=\"destructive || undefined\"\n        :class=\"\n          cn(\n            'fixed left-1/2 top-1/2 z-50 -translate-x-1/2 -translate-y-1/2',\n            // One width, and no `size` prop to vary it. A decision has one\n            // shape; the wider panels exist on Dialog because an authoring\n            // surface needs them, and there is no authoring surface here.\n            'w-[min(92vw,32rem)]',\n            'rounded-lg border border-border bg-popover p-6 text-popover-foreground shadow-lg outline-none',\n            // Scoped to the open state, never unconditional. Reka's Presence\n            // keeps closed content mounted until an animationend arrives, and a\n            // mount-only animation never fires a second one — which here would\n            // strand a full-screen, input-blocking overlay over a page with no\n            // alert on it. Scoped, the closed element computes\n            // `animation-name: none` and Presence unmounts it at once.\n            'data-[state=open]:animate-scale-in',\n            attrs.class as string,\n          )\n        \"\n        @escape-key-down=\"$emit('cancel')\"\n      >\n        <AlertDialogTitle class=\"text-base font-semibold\">{{ title }}</AlertDialogTitle>\n        <AlertDialogDescription v-if=\"description\" class=\"mt-1 text-sm text-muted-foreground\">\n          {{ description }}\n        </AlertDialogDescription>\n\n        <div class=\"mt-6 flex items-center justify-end gap-2\">\n          <!-- Cancel is first in the DOM as well as first visually, so the\n               order a screen reader reads matches the order the eye does. It is\n               also the element Reka focuses on open. -->\n          <AlertDialogCancel\n            :class=\"buttonVariants({ variant: 'subtle' })\"\n            @click=\"$emit('cancel')\"\n          >\n            {{ text.cancel }}\n          </AlertDialogCancel>\n          <!-- The destructive paint is emphasis, not the signal. What tells a\n               reader this button destroys something is the verb in its label,\n               which is why `labels.confirm` is meant to be replaced rather than\n               left as \"Confirm\". -->\n          <AlertDialogAction\n            :class=\"buttonVariants({ variant: destructive ? 'destructive' : 'primary' })\"\n            @click=\"$emit('confirm')\"\n          >\n            {{ text.confirm }}\n          </AlertDialogAction>\n        </div>\n      </AlertDialogContent>\n    </AlertDialogPortal>\n  </AlertDialogRoot>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;AAQA,IAAa,sBAAyC;CACpD,SAAS;CACT,QAAQ;AACV;;;;;;;;;;;;;;;;;;;;;;;EAiDA,MAAM,QAAQ;EA2Cd,MAAM,OAAO,UAAU,eAAe,2BAA2B,MAAM,MAAM;EAY7E,MAAM,EAAE,OAAO,MAAM,eAAe,cAAc;EAUlD,MAAM,gBAAgB,gBAAgB;GACpC,GAAI,MAAM,cAAc,CAAC,IAAI,EAAE,oBAAoB,KAAA,EAAU;GAC7D,GAAG,WAAW;EAChB,EAAE;;GAIA,OAAA,UAAA,GAAA,YAkEkB,MAAA,eAAA,GAlElB,WAAyB,MAkEP,QAAA,CAlEe,CAAA,EAAA,MAAG,QAAA,KAAI,CAAA,GAAA,EAAM,iBAAW,OAAA,OAAA,OAAA,MAAA,WAAEA,KAAAA,MAAK,eAAgB,MAAM,GAAA,CAAA,GAAA;IAGpF,SAAA,cAEqB,CAFKC,KAAAA,OAAO,WAAjC,UAAA,GAAA,YAEqB,MAAA,kBAAA,GAAA;;KAFqB,YAAA;;KACxC,SAAA,cAAuB,CAAvB,WAAuB,KAAA,QAAA,SAAA,CAAA,CAAA;;IAGzB,CAAA,KAAA,mBAAA,IAAA,IAAA,GAAA,YA0DoB,MAAA,iBAAA,GAAA,MAAA;KArDlB,SAAA,cAEE,CAFF,YAEE,MAAA,kBAAA,GAAA,EADA,OAAM,qEAAoE,CAAA,GAE5E,YAiDqB,MAAA,kBAAA,GAjDrB,WACU,cAgDW,OAhDE;MACpB,oBAAkB,QAAA,eAAe,KAAA;MACjC,OAAkB,MAAA,EAAA,CAAE,CAAA,iEAAA,uBAAA,iGAAA,sCAAu8B,MAAA,KAAA,CAAK,CAAC,KAAA;MAkBj+B,iBAAe,OAAA,OAAA,OAAA,MAAA,WAAED,KAAAA,MAAK,QAAA;;MAEvB,SAAA,cAAgF;OAAhF,YAAgF,MAAA,gBAAA,GAAA,EAA9D,OAAM,0BAAyB,GAAA;QAAC,SAAA,cAAW,CAAR,gBAAA,gBAAA,QAAA,KAAK,GAAA,CAAA,CAAA,CAAA;;;OAC5B,QAAA,eAA9B,UAAA,GAAA,YAEyB,MAAA,sBAAA,GAAA;;QAFkB,OAAM;;QAC/C,SAAA,cAAiB,CAAd,gBAAA,gBAAA,QAAA,WAAW,GAAA,CAAA,CAAA,CAAA;;;OAGhB,mBAoBM,OApBN,YAoBM,CAhBJ,YAKoB,MAAA,iBAAA,GAAA;QAJjB,OAAK,eAAE,MAAA,cAAA,CAAc,CAAA,EAAA,SAAA,SAAA,CAAA,CAAA;QACrB,SAAK,OAAA,OAAA,OAAA,MAAA,WAAEA,KAAAA,MAAK,QAAA;;QAEb,SAAA,cAAiB,CAAd,gBAAA,gBAAA,MAAA,IAAA,CAAI,CAAC,MAAM,GAAA,CAAA,CAAA,CAAA;;OAMhB,GAAA,GAAA,CAAA,OAAA,CAAA,GAAA,YAKoB,MAAA,iBAAA,GAAA;QAJjB,OAAK,eAAE,MAAA,cAAA,CAAc,CAAA,EAAA,SAAY,QAAA,cAAW,gBAAA,UAAA,CAAA,CAAA;QAC5C,SAAK,OAAA,OAAA,OAAA,MAAA,WAAEA,KAAAA,MAAK,SAAA;;QAEb,SAAA,cAAkB,CAAf,gBAAA,gBAAA,MAAA,IAAA,CAAI,CAAC,OAAO,GAAA,CAAA,CAAA,CAAA"}

package/dist/packages/primitives/alert-dialog/src/index.d.ts

@@ -0,0 +1,3 @@
+export { ALERT_DIALOG_LABELS, default } from "./AlertDialog.vue";
+export type { AlertDialogLabels } from "@ecoma-io/loom-labels";
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/primitives/alert-dialog/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/primitives/alert-dialog/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/packages/primitives/alert-dialog/src/index.js

@@ -0,0 +1,3 @@
+import { ALERT_DIALOG_LABELS } from "./AlertDialog.vue_vue_type_script_setup_true_lang.js";
+import AlertDialog_default from "./AlertDialog.js";
+export { ALERT_DIALOG_LABELS, AlertDialog_default as default };

package/dist/packages/primitives/avatar/src/Avatar.js

@@ -0,0 +1,7 @@
+import Avatar_vue_vue_type_script_setup_true_lang_default, { avatarVariants } from "./Avatar.vue_vue_type_script_setup_true_lang.js";
+//#region packages/primitives/avatar/src/Avatar.vue
+var Avatar_default = Avatar_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { avatarVariants, Avatar_default as default };
+
+//# sourceMappingURL=Avatar.js.map

package/dist/packages/primitives/avatar/src/Avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.js","names":[],"sources":["../../../../../packages/primitives/avatar/src/Avatar.vue"],"sourcesContent":["<script lang=\"ts\">\nimport { cva } from \"class-variance-authority\";\n\n/** Control height, and the text size the initials fallback prints at. */\nexport type AvatarSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\n\n/** A circle, or a rounded square tile. */\nexport type AvatarShape = \"circle\" | \"square\";\n\n/**\n * Which visual treatment the avatar receives. `accent` applies the accent\n * colour as a rim, signalling a second semantic category distinct from the\n * default — a different role, origin, or mode.\n */\nexport type AvatarVariant = \"default\" | \"accent\";\n\nexport const avatarVariants = cva(\n  \"relative inline-flex shrink-0 items-center justify-center overflow-hidden select-none\",\n  {\n    // `satisfies` keeps the two halves honest: the unions above are the names a\n    // consumer imports and the documentation prints, the maps below are the\n    // classes. Adding a member to one and not the other stops compiling — which\n    // is what the three inline `size === '…' &&` conditionals this replaced\n    // could not do, and the reason five sizes could not stay written that way.\n    variants: {\n      size: {\n        // `text-xs` twice, deliberately. It is the smallest step Tailwind's own\n        // scale has, and the step below it — Loom's `text-micro` — is a name\n        // tailwind-merge classifies as a text *colour* rather than a size, so\n        // `cn()` drops it the moment the force map adds `text-muted-foreground`\n        // after it. Two initials at 12px still fit inside 24px.\n        xs: \"h-6 w-6 text-xs\",\n        sm: \"h-8 w-8 text-xs\",\n        md: \"h-10 w-10 text-sm\",\n        lg: \"h-12 w-12 text-base\",\n        xl: \"h-16 w-16 text-lg\",\n      } satisfies Record<AvatarSize, string>,\n      force: {\n        default: \"bg-muted text-muted-foreground\",\n        // The accent rim. Two signals, not one: the rim's *presence* is what a\n        // reader who cannot resolve the hue still sees — a default avatar has no\n        // edge at all — and the hidden `accentLabel` is what a reader who sees\n        // no avatar hears. The corner is left alone on purpose, because the\n        // corner is Indicator's: a presence dot pinned there would land on top\n        // of anything this component drew.\n        accent: \"border-2 border-accent bg-accent-muted text-accent-text\",\n      } satisfies Record<AvatarVariant, string>,\n    },\n    defaultVariants: { size: \"md\", force: \"default\" },\n  },\n);\n\n/**\n * A square avatar's corner radius, one value per size rather than the control\n * radius throughout. `rounded-md` is calibrated against a ~36px control; on a\n * 24px tile it is a third of the side, where a milled fillet stops reading as\n * a corner and starts reading as a blob, and on a 64px one it has almost\n * disappeared. Stepping it holds the corner between a sixth and a quarter of\n * the side at every size — the band the control radius already sits in — which\n * is the nesting law applied to a tile whose \"padding\" is its own edge.\n */\nconst SQUARE_RADIUS = {\n  xs: \"rounded-sm\",\n  sm: \"rounded-md\",\n  md: \"rounded-md\",\n  lg: \"rounded-lg\",\n  xl: \"rounded-xl\",\n} satisfies Record<AvatarSize, string>;\n\n/**\n * The rounding for one size and shape. A circle is one value at every size; a\n * square is not, which is why the radius cannot live in the `cva` map beside\n * the heights. Kept off the public surface deliberately: a consumer wanting an\n * avatar-shaped tile should render an `Avatar`, not reassemble one.\n */\nfunction avatarRadius(size: AvatarSize, shape: AvatarShape): string {\n  return shape === \"circle\" ? \"rounded-full\" : SQUARE_RADIUS[size];\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from \"vue\";\nimport { AvatarRoot, AvatarImage, AvatarFallback } from \"reka-ui\";\nimport { cn, useSplitAttrs } from \"@ecoma-io/loom-core\";\n\n/**\n * Avatar — a user's picture, with a graceful initials fallback for\n * no `src`, a broken URL, or a still-loading image. Built on Reka UI's\n * Avatar: the image only paints once it has actually finished loading, so\n * the fallback stays visible the whole time until then — first paint is\n * either the real photo or the initials, never a broken-image icon.\n *\n * Two neighbours are worth naming. Several faces standing for one thing — the\n * people on a task, the agents on a run — are an `AvatarGroup`, which owns the\n * overlap, the stacking order and the \"+3\" so a row of them is one object to a\n * screen reader rather than N unrelated images. Anything pinned onto the\n * avatar's corner — a presence dot, an unread count — is an `Indicator`\n * wrapped around it; this component deliberately draws nothing there.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** Image URL. Omit it to render the fallback outright. */\n    src?: string;\n    /** Accessible name for the photo — required on `AvatarImage` so a screen reader announces who it is, not just that an image loaded. */\n    alt?: string;\n    /** Initials to show while there is no image, or once one has failed — computed by the caller, never derived from `alt` here. */\n    fallback?: string;\n    /** Control height. */\n    size?: AvatarSize;\n    /** A circle, or a rounded square tile. Square suits a subject a circle would misdescribe — an organisation, a project, a repository — and takes a radius that steps with the size rather than one fixed value. */\n    shape?: AvatarShape;\n    /** Which visual treatment the avatar receives. `accent` applies the accent rim and `accentLabel` for a screen reader, so the distinction never rests on the hue alone. */\n    variant?: AvatarVariant;\n    /** What a screen reader announces after the name of an `accent` avatar. Localise it. Set it empty when something outside already says so — `AvatarGroup` does, because each row item composes its own name — and nothing is added for a `default` avatar either way. */\n    accentLabel?: string;\n  }>(),\n  {\n    alt: \"\",\n    size: \"md\",\n    shape: \"circle\",\n    variant: \"default\",\n    accentLabel: \"\",\n  },\n);\n\n// One rendered node, and it is the right home for every fallthrough attribute\n// — but `class` still goes the long way round, through `cn()`. Vue's own merge\n// only concatenates, so the `bg-subtle` an AvatarGroup paints its overflow tile\n// with would win or lose against this root's `bg-muted` depending on the order\n// Tailwind happened to emit the two rules in, rather than on intent.\ndefineOptions({ inheritAttrs: false });\nconst { attrs, rest } = useSplitAttrs();\n\nconst radius = computed(() => avatarRadius(props.size, props.shape));\n</script>\n\n<template>\n  <AvatarRoot\n    v-bind=\"rest\"\n    :data-variant=\"variant\"\n    :class=\"cn(avatarVariants({ size, force: variant }), radius, attrs.class as string)\"\n  >\n    <!-- Reka paints AvatarImage only once the photo has loaded, so scale-in\n         plays exactly on that swap-in — a gentle settle over the fallback. -->\n    <AvatarImage\n      v-if=\"src\"\n      :src=\"src\"\n      :alt=\"alt\"\n      class=\"h-full w-full animate-scale-in object-cover\"\n    />\n    <AvatarFallback class=\"font-medium\">{{ fallback }}</AvatarFallback>\n    <!-- The half of the accent signal a rim cannot carry. It sits after the\n         image so it is announced as a qualifier on the name rather than in\n         place of it, and it is dropped entirely for an empty `accentLabel`: a\n         wrapper that has already worked the qualifier into its own name would\n         otherwise leave a second copy of it in the tree. -->\n    <span v-if=\"variant === 'accent' && accentLabel\" class=\"sr-only\">{{ accentLabel }}</span>\n  </AvatarRoot>\n</template>\n"],"mappings":""}

package/dist/packages/primitives/avatar/src/Avatar.vue.d.ts

@@ -0,0 +1,54 @@
+/** Control height, and the text size the initials fallback prints at. */
+export type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
+/** A circle, or a rounded square tile. */
+export type AvatarShape = "circle" | "square";
+/**
+ * Which visual treatment the avatar receives. `accent` applies the accent
+ * colour as a rim, signalling a second semantic category distinct from the
+ * default — a different role, origin, or mode.
+ */
+export type AvatarVariant = "default" | "accent";
+export declare const avatarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "xs" | "xl" | null | undefined;
+    force?: "accent" | "default" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    /** Image URL. Omit it to render the fallback outright. */
+    src?: string;
+    /** Accessible name for the photo — required on `AvatarImage` so a screen reader announces who it is, not just that an image loaded. */
+    alt?: string;
+    /** Initials to show while there is no image, or once one has failed — computed by the caller, never derived from `alt` here. */
+    fallback?: string;
+    /** Control height. */
+    size?: AvatarSize;
+    /** A circle, or a rounded square tile. Square suits a subject a circle would misdescribe — an organisation, a project, a repository — and takes a radius that steps with the size rather than one fixed value. */
+    shape?: AvatarShape;
+    /** Which visual treatment the avatar receives. `accent` applies the accent rim and `accentLabel` for a screen reader, so the distinction never rests on the hue alone. */
+    variant?: AvatarVariant;
+    /** What a screen reader announces after the name of an `accent` avatar. Localise it. Set it empty when something outside already says so — `AvatarGroup` does, because each row item composes its own name — and nothing is added for a `default` avatar either way. */
+    accentLabel?: string;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    /** Image URL. Omit it to render the fallback outright. */
+    src?: string;
+    /** Accessible name for the photo — required on `AvatarImage` so a screen reader announces who it is, not just that an image loaded. */
+    alt?: string;
+    /** Initials to show while there is no image, or once one has failed — computed by the caller, never derived from `alt` here. */
+    fallback?: string;
+    /** Control height. */
+    size?: AvatarSize;
+    /** A circle, or a rounded square tile. Square suits a subject a circle would misdescribe — an organisation, a project, a repository — and takes a radius that steps with the size rather than one fixed value. */
+    shape?: AvatarShape;
+    /** Which visual treatment the avatar receives. `accent` applies the accent rim and `accentLabel` for a screen reader, so the distinction never rests on the hue alone. */
+    variant?: AvatarVariant;
+    /** What a screen reader announces after the name of an `accent` avatar. Localise it. Set it empty when something outside already says so — `AvatarGroup` does, because each row item composes its own name — and nothing is added for a `default` avatar either way. */
+    accentLabel?: string;
+}> & Readonly<{}>, {
+    size: AvatarSize;
+    variant: AvatarVariant;
+    alt: string;
+    shape: AvatarShape;
+    accentLabel: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+//# sourceMappingURL=Avatar.vue.d.ts.map

package/dist/packages/primitives/avatar/src/Avatar.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.vue.d.ts","sourceRoot":"","sources":["../../../../../packages/primitives/avatar/src/Avatar.vue"],"names":[],"mappings":"AAyKA,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD,eAAO,MAAM,cAAc;;;8EAkC1B,CAAC;wBA4BmB,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAgBd,0DAA0D;UACpD,MAAM;IACZ,uIAAuI;UACjI,MAAM;IACZ,gIAAgI;eACrH,MAAM;IACjB,sBAAsB;WACf,UAAU;IACjB,kNAAkN;YAC1M,WAAW;IACnB,0KAA0K;cAChK,aAAa;IACvB,wQAAwQ;kBAC1P,MAAM;;IAbpB,0DAA0D;UACpD,MAAM;IACZ,uIAAuI;UACjI,MAAM;IACZ,gIAAgI;eACrH,MAAM;IACjB,sBAAsB;WACf,UAAU;IACjB,kNAAkN;YAC1M,WAAW;IACnB,0KAA0K;cAChK,aAAa;IACvB,wQAAwQ;kBAC1P,MAAM;;UANb,UAAU;aAIP,aAAa;SARjB,MAAM;WAMJ,WAAW;iBAIL,MAAM;6EA4HpB,CAAC"}

package/dist/packages/primitives/avatar/src/Avatar.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,115 @@
+import { cn } from "../../../core/src/cn.js";
+import { useSplitAttrs } from "../../../core/src/attrs.js";
+import "../../../core/src/index.js";
+import { computed, createBlock, createCommentVNode, createElementBlock, createTextVNode, createVNode, defineComponent, mergeProps, openBlock, toDisplayString, unref, withCtx } from "vue";
+import { AvatarFallback, AvatarImage, AvatarRoot } from "reka-ui";
+import { cva } from "class-variance-authority";
+//#region packages/primitives/avatar/src/Avatar.vue?vue&type=script&setup=true&lang.ts
+/**
+* Avatar — a user's picture, with a graceful initials fallback for
+* no `src`, a broken URL, or a still-loading image. Built on Reka UI's
+* Avatar: the image only paints once it has actually finished loading, so
+* the fallback stays visible the whole time until then — first paint is
+* either the real photo or the initials, never a broken-image icon.
+*
+* Two neighbours are worth naming. Several faces standing for one thing — the
+* people on a task, the agents on a run — are an `AvatarGroup`, which owns the
+* overlap, the stacking order and the "+3" so a row of them is one object to a
+* screen reader rather than N unrelated images. Anything pinned onto the
+* avatar's corner — a presence dot, an unread count — is an `Indicator`
+* wrapped around it; this component deliberately draws nothing there.
+*/
+var _hoisted_1 = {
+	key: 1,
+	class: "sr-only"
+};
+var avatarVariants = cva("relative inline-flex shrink-0 items-center justify-center overflow-hidden select-none", {
+	variants: {
+		size: {
+			xs: "h-6 w-6 text-xs",
+			sm: "h-8 w-8 text-xs",
+			md: "h-10 w-10 text-sm",
+			lg: "h-12 w-12 text-base",
+			xl: "h-16 w-16 text-lg"
+		},
+		force: {
+			default: "bg-muted text-muted-foreground",
+			accent: "border-2 border-accent bg-accent-muted text-accent-text"
+		}
+	},
+	defaultVariants: {
+		size: "md",
+		force: "default"
+	}
+});
+/**
+* A square avatar's corner radius, one value per size rather than the control
+* radius throughout. `rounded-md` is calibrated against a ~36px control; on a
+* 24px tile it is a third of the side, where a milled fillet stops reading as
+* a corner and starts reading as a blob, and on a 64px one it has almost
+* disappeared. Stepping it holds the corner between a sixth and a quarter of
+* the side at every size — the band the control radius already sits in — which
+* is the nesting law applied to a tile whose "padding" is its own edge.
+*/
+var SQUARE_RADIUS = {
+	xs: "rounded-sm",
+	sm: "rounded-md",
+	md: "rounded-md",
+	lg: "rounded-lg",
+	xl: "rounded-xl"
+};
+/**
+* The rounding for one size and shape. A circle is one value at every size; a
+* square is not, which is why the radius cannot live in the `cva` map beside
+* the heights. Kept off the public surface deliberately: a consumer wanting an
+* avatar-shaped tile should render an `Avatar`, not reassemble one.
+*/
+function avatarRadius(size, shape) {
+	return shape === "circle" ? "rounded-full" : SQUARE_RADIUS[size];
+}
+var Avatar_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	inheritAttrs: false,
+	__name: "Avatar",
+	props: {
+		src: {},
+		alt: { default: "" },
+		fallback: {},
+		size: { default: "md" },
+		shape: { default: "circle" },
+		variant: { default: "default" },
+		accentLabel: { default: "" }
+	},
+	setup(__props) {
+		const props = __props;
+		const { attrs, rest } = useSplitAttrs();
+		const radius = computed(() => avatarRadius(props.size, props.shape));
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(AvatarRoot), mergeProps(unref(rest), {
+				"data-variant": __props.variant,
+				class: unref(cn)(unref(avatarVariants)({
+					size: __props.size,
+					force: __props.variant
+				}), radius.value, unref(attrs).class)
+			}), {
+				default: withCtx(() => [
+					__props.src ? (openBlock(), createBlock(unref(AvatarImage), {
+						key: 0,
+						src: __props.src,
+						alt: __props.alt,
+						class: "h-full w-full animate-scale-in object-cover"
+					}, null, 8, ["src", "alt"])) : createCommentVNode("", true),
+					createVNode(unref(AvatarFallback), { class: "font-medium" }, {
+						default: withCtx(() => [createTextVNode(toDisplayString(__props.fallback), 1)]),
+						_: 1
+					}),
+					__props.variant === "accent" && __props.accentLabel ? (openBlock(), createElementBlock("span", _hoisted_1, toDisplayString(__props.accentLabel), 1)) : createCommentVNode("", true)
+				]),
+				_: 1
+			}, 16, ["data-variant", "class"]);
+		};
+	}
+});
+//#endregion
+export { avatarVariants, Avatar_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=Avatar.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/primitives/avatar/src/Avatar.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../../packages/primitives/avatar/src/Avatar.vue"],"sourcesContent":["<script lang=\"ts\">\nimport { cva } from \"class-variance-authority\";\n\n/** Control height, and the text size the initials fallback prints at. */\nexport type AvatarSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\n\n/** A circle, or a rounded square tile. */\nexport type AvatarShape = \"circle\" | \"square\";\n\n/**\n * Which visual treatment the avatar receives. `accent` applies the accent\n * colour as a rim, signalling a second semantic category distinct from the\n * default — a different role, origin, or mode.\n */\nexport type AvatarVariant = \"default\" | \"accent\";\n\nexport const avatarVariants = cva(\n  \"relative inline-flex shrink-0 items-center justify-center overflow-hidden select-none\",\n  {\n    // `satisfies` keeps the two halves honest: the unions above are the names a\n    // consumer imports and the documentation prints, the maps below are the\n    // classes. Adding a member to one and not the other stops compiling — which\n    // is what the three inline `size === '…' &&` conditionals this replaced\n    // could not do, and the reason five sizes could not stay written that way.\n    variants: {\n      size: {\n        // `text-xs` twice, deliberately. It is the smallest step Tailwind's own\n        // scale has, and the step below it — Loom's `text-micro` — is a name\n        // tailwind-merge classifies as a text *colour* rather than a size, so\n        // `cn()` drops it the moment the force map adds `text-muted-foreground`\n        // after it. Two initials at 12px still fit inside 24px.\n        xs: \"h-6 w-6 text-xs\",\n        sm: \"h-8 w-8 text-xs\",\n        md: \"h-10 w-10 text-sm\",\n        lg: \"h-12 w-12 text-base\",\n        xl: \"h-16 w-16 text-lg\",\n      } satisfies Record<AvatarSize, string>,\n      force: {\n        default: \"bg-muted text-muted-foreground\",\n        // The accent rim. Two signals, not one: the rim's *presence* is what a\n        // reader who cannot resolve the hue still sees — a default avatar has no\n        // edge at all — and the hidden `accentLabel` is what a reader who sees\n        // no avatar hears. The corner is left alone on purpose, because the\n        // corner is Indicator's: a presence dot pinned there would land on top\n        // of anything this component drew.\n        accent: \"border-2 border-accent bg-accent-muted text-accent-text\",\n      } satisfies Record<AvatarVariant, string>,\n    },\n    defaultVariants: { size: \"md\", force: \"default\" },\n  },\n);\n\n/**\n * A square avatar's corner radius, one value per size rather than the control\n * radius throughout. `rounded-md` is calibrated against a ~36px control; on a\n * 24px tile it is a third of the side, where a milled fillet stops reading as\n * a corner and starts reading as a blob, and on a 64px one it has almost\n * disappeared. Stepping it holds the corner between a sixth and a quarter of\n * the side at every size — the band the control radius already sits in — which\n * is the nesting law applied to a tile whose \"padding\" is its own edge.\n */\nconst SQUARE_RADIUS = {\n  xs: \"rounded-sm\",\n  sm: \"rounded-md\",\n  md: \"rounded-md\",\n  lg: \"rounded-lg\",\n  xl: \"rounded-xl\",\n} satisfies Record<AvatarSize, string>;\n\n/**\n * The rounding for one size and shape. A circle is one value at every size; a\n * square is not, which is why the radius cannot live in the `cva` map beside\n * the heights. Kept off the public surface deliberately: a consumer wanting an\n * avatar-shaped tile should render an `Avatar`, not reassemble one.\n */\nfunction avatarRadius(size: AvatarSize, shape: AvatarShape): string {\n  return shape === \"circle\" ? \"rounded-full\" : SQUARE_RADIUS[size];\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from \"vue\";\nimport { AvatarRoot, AvatarImage, AvatarFallback } from \"reka-ui\";\nimport { cn, useSplitAttrs } from \"@ecoma-io/loom-core\";\n\n/**\n * Avatar — a user's picture, with a graceful initials fallback for\n * no `src`, a broken URL, or a still-loading image. Built on Reka UI's\n * Avatar: the image only paints once it has actually finished loading, so\n * the fallback stays visible the whole time until then — first paint is\n * either the real photo or the initials, never a broken-image icon.\n *\n * Two neighbours are worth naming. Several faces standing for one thing — the\n * people on a task, the agents on a run — are an `AvatarGroup`, which owns the\n * overlap, the stacking order and the \"+3\" so a row of them is one object to a\n * screen reader rather than N unrelated images. Anything pinned onto the\n * avatar's corner — a presence dot, an unread count — is an `Indicator`\n * wrapped around it; this component deliberately draws nothing there.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** Image URL. Omit it to render the fallback outright. */\n    src?: string;\n    /** Accessible name for the photo — required on `AvatarImage` so a screen reader announces who it is, not just that an image loaded. */\n    alt?: string;\n    /** Initials to show while there is no image, or once one has failed — computed by the caller, never derived from `alt` here. */\n    fallback?: string;\n    /** Control height. */\n    size?: AvatarSize;\n    /** A circle, or a rounded square tile. Square suits a subject a circle would misdescribe — an organisation, a project, a repository — and takes a radius that steps with the size rather than one fixed value. */\n    shape?: AvatarShape;\n    /** Which visual treatment the avatar receives. `accent` applies the accent rim and `accentLabel` for a screen reader, so the distinction never rests on the hue alone. */\n    variant?: AvatarVariant;\n    /** What a screen reader announces after the name of an `accent` avatar. Localise it. Set it empty when something outside already says so — `AvatarGroup` does, because each row item composes its own name — and nothing is added for a `default` avatar either way. */\n    accentLabel?: string;\n  }>(),\n  {\n    alt: \"\",\n    size: \"md\",\n    shape: \"circle\",\n    variant: \"default\",\n    accentLabel: \"\",\n  },\n);\n\n// One rendered node, and it is the right home for every fallthrough attribute\n// — but `class` still goes the long way round, through `cn()`. Vue's own merge\n// only concatenates, so the `bg-subtle` an AvatarGroup paints its overflow tile\n// with would win or lose against this root's `bg-muted` depending on the order\n// Tailwind happened to emit the two rules in, rather than on intent.\ndefineOptions({ inheritAttrs: false });\nconst { attrs, rest } = useSplitAttrs();\n\nconst radius = computed(() => avatarRadius(props.size, props.shape));\n</script>\n\n<template>\n  <AvatarRoot\n    v-bind=\"rest\"\n    :data-variant=\"variant\"\n    :class=\"cn(avatarVariants({ size, force: variant }), radius, attrs.class as string)\"\n  >\n    <!-- Reka paints AvatarImage only once the photo has loaded, so scale-in\n         plays exactly on that swap-in — a gentle settle over the fallback. -->\n    <AvatarImage\n      v-if=\"src\"\n      :src=\"src\"\n      :alt=\"alt\"\n      class=\"h-full w-full animate-scale-in object-cover\"\n    />\n    <AvatarFallback class=\"font-medium\">{{ fallback }}</AvatarFallback>\n    <!-- The half of the accent signal a rim cannot carry. It sits after the\n         image so it is announced as a qualifier on the name rather than in\n         place of it, and it is dropped entirely for an empty `accentLabel`: a\n         wrapper that has already worked the qualifier into its own name would\n         otherwise leave a second copy of it in the tree. -->\n    <span v-if=\"variant === 'accent' && accentLabel\" class=\"sr-only\">{{ accentLabel }}</span>\n  </AvatarRoot>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,IAAa,iBAAiB,IAC5B,yFACA;CAME,UAAU;EACR,MAAM;GAMJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;EACN;EACA,OAAO;GACL,SAAS;GAOT,QAAQ;EACV;CACF;CACA,iBAAiB;EAAE,MAAM;EAAM,OAAO;CAAU;AAClD,CACF;;;;;;;;;;AAWA,IAAM,gBAAgB;CACpB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;;;;;;AAQA,SAAS,aAAa,MAAkB,OAA4B;CAClE,OAAO,UAAU,WAAW,iBAAiB,cAAc;AAC7D;;;;;;;;;;;;;;EAsBA,MAAM,QAAQ;EAgCd,MAAM,EAAE,OAAO,SAAS,cAAc;EAEtC,MAAM,SAAS,eAAe,aAAa,MAAM,MAAM,MAAM,KAAK,CAAC;;GAIjE,OAAA,UAAA,GAAA,YAoBa,MAAA,UAAA,GApBb,WACU,MAmBG,IAAA,GAnBC;IACX,gBAAc,QAAA;IACd,OAAO,MAAA,EAAA,CAAE,CAAC,MAAA,cAAA,CAAc,CAAA;KAAA,MAAG,QAAA;KAAI,OAAS,QAAA;IAAO,CAAA,GAAK,OAAA,OAAQ,MAAA,KAAA,CAAK,CAAC,KAAK;;IAIxE,SAAA,cAKE;KAJM,QAAA,OADR,UAAA,GAAA,YAKE,MAAA,WAAA,GAAA;;MAHC,KAAK,QAAA;MACL,KAAK,QAAA;MACN,OAAM;;KAER,YAAmE,MAAA,cAAA,GAAA,EAAnD,OAAM,cAAa,GAAA;MAAC,SAAA,cAAc,CAAX,gBAAA,gBAAA,QAAA,QAAQ,GAAA,CAAA,CAAA,CAAA;;;KAMnC,QAAA,YAAO,YAAiB,QAAA,eAApC,UAAA,GAAA,mBAAyF,QAAzF,YAAyF,gBAArB,QAAA,WAAW,GAAA,CAAA,KAAA,mBAAA,IAAA,IAAA"}

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

@@ -0,0 +1,3 @@
+export { default, avatarVariants } from "./Avatar.vue";
+export type { AvatarSize, AvatarShape, AvatarVariant } from "./Avatar.vue";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+import { avatarVariants } from "./Avatar.vue_vue_type_script_setup_true_lang.js";
+import Avatar_default from "./Avatar.js";
+export { avatarVariants, Avatar_default as default };

package/dist/packages/primitives/avatar-group/src/AvatarGroup.js

@@ -0,0 +1,7 @@
+import AvatarGroup_vue_vue_type_script_setup_true_lang_default, { AVATAR_GROUP_LABELS } from "./AvatarGroup.vue_vue_type_script_setup_true_lang.js";
+//#region packages/primitives/avatar-group/src/AvatarGroup.vue
+var AvatarGroup_default = AvatarGroup_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { AVATAR_GROUP_LABELS, AvatarGroup_default as default };
+
+//# sourceMappingURL=AvatarGroup.js.map

package/dist/packages/primitives/avatar-group/src/AvatarGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AvatarGroup.js","names":[],"sources":["../../../../../packages/primitives/avatar-group/src/AvatarGroup.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { AvatarGroupLabels } from \"@ecoma-io/loom-labels\";\nimport type { AvatarShape, AvatarSize, AvatarVariant } from \"@ecoma-io/loom-avatar\";\n\n/** One face in the row. */\nexport interface AvatarGroupItem {\n  /** Image URL. Omit it and this face renders `fallback` instead. */\n  src?: string;\n  /** Who this face is. It is what a screen reader reads for this member, whether or not the image ever loads — so it is the field to fill in even when there is no photo. */\n  alt?: string;\n  /** Initials shown while there is no image, or once one has failed. */\n  fallback?: string;\n  /** Which variant this member uses. Defaults to the group's own `variant`, so a row that mixes members states it per member and a row of one kind states it once. */\n  variant?: AvatarVariant;\n}\n\n/** The surface the row sits on, which the separating ring matches. */\nexport type AvatarGroupSurface = \"background\" | \"card\" | \"sunken\" | \"popover\";\n\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 AVATAR_GROUP_LABELS: AvatarGroupLabels = {\n  overflow: ({ count }) => `${String(count)} more`,\n  accent: ({ name }) => (name ? `${name}, Accent` : \"Accent\"),\n};\n\n/**\n * How far each face tucks under the one before it — a quarter of its own width\n * at every size, so a row of `xs` avatars reads at the same density as a row of\n * `xl` ones. A fixed offset would look like a badly spaced flex row at the top\n * of the scale and swallow the initials at the bottom of it.\n */\nconst OVERLAP = {\n  xs: \"-ml-1.5\",\n  sm: \"-ml-2\",\n  md: \"-ml-2.5\",\n  lg: \"-ml-3\",\n  xl: \"-ml-4\",\n} satisfies Record<AvatarSize, string>;\n\n/**\n * The ring that cuts each face out of the one it overlaps. Without it two\n * portraits of similar tone merge into one shape, so it is structural rather\n * than decorative — which is also why it has to be the colour of whatever\n * surrounds the row, something only the caller knows. The names are\n * Indicator's, for the same reason and with the same meaning.\n */\nconst SURFACE_RING = {\n  background: \"ring-background\",\n  card: \"ring-card\",\n  sunken: \"ring-sunken\",\n  popover: \"ring-popover\",\n} satisfies Record<AvatarGroupSurface, string>;\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from \"vue\";\nimport Avatar from \"@ecoma-io/loom-avatar\";\nimport { cn } from \"@ecoma-io/loom-core\";\nimport { optional } from \"@ecoma-io/loom-core\";\nimport { useSplitAttrs } from \"@ecoma-io/loom-core\";\nimport { useLabels, type LabelOverrides } from \"@ecoma-io/loom-labels\";\n\n/**\n * AvatarGroup — the faces on one thing, overlapped into a single row: the\n * people assigned to a task, the agents on a run, the members of a workspace.\n * Past `max` of them the rest collapse into a counter, so the row's width is\n * bounded by the layout rather than by how many people happen to be involved.\n *\n * Reach for a plain `Avatar` when there is one subject, and for a real list of\n * rows when the reader needs to *act* on the members — a stack of overlapping\n * portraits is an at-a-glance summary, not a control. Nothing here is\n * focusable or clickable on purpose: the moment a face has to be pressable it\n * wants a row, a menu or a set of chips, each of which can carry a name and a\n * keyboard path that a 40px circle cannot.\n *\n * To a screen reader the row is one object — a labelled list of members ending\n * in \"3 more\" — rather than N unrelated images. Each face is announced by its\n * `alt` and nothing else: the portrait itself is hidden from assistive\n * technology and the name supplied beside it, which is what keeps the reading\n * identical whether the photo loaded, failed, or was never given.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** The members, in the order they are shown. The first is the one painted on top. */\n    avatars: AvatarGroupItem[];\n    /** How many faces render before the rest collapse into the counter. Values below 1 are treated as 1 — a row of nothing but \"+5\" identifies nobody. */\n    max?: number;\n    /** Height of every face in the row, and of the counter — one of `Avatar`'s five sizes, `xs` through `xl`. */\n    size?: AvatarSize;\n    /** `circle` or `square`, forwarded to every face so the row reads as one shape. */\n    shape?: AvatarShape;\n    /** `default` or `accent`, for members that do not name their own — set it to `accent` for a row where every member uses the accent variant. */\n    variant?: AvatarVariant;\n    /** The group's accessible name: \"Assignees\", \"Reviewers\", \"Members\". */\n    label?: string;\n    /** The surface the row sits on, so the ring separating the faces matches what surrounds them. */\n    surface?: AvatarGroupSurface;\n    /**\n     * Names for the counter and for an accent member, as any subset of\n     * `AvatarGroupLabels` — the rest stay as the host's `provideLoomLabels`\n     * vocabulary left them, and then as Loom's English.\n     *\n     * The per-instance case is a row where \"more\" is the wrong word for what\n     * was left out: three reviewers, three members, three files.\n     */\n    labels?: LabelOverrides<AvatarGroupLabels>;\n  }>(),\n  {\n    max: 4,\n    size: \"md\",\n    shape: \"circle\",\n    variant: \"default\",\n    surface: \"background\",\n  },\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(\"avatarGroup\", AVATAR_GROUP_LABELS, () => props.labels);\n\n// One rendered node, and it takes every fallthrough attribute — but `class`\n// goes through `cn()`, so a caller's `gap-1` can beat the row's own layout\n// utilities instead of tying with them on stylesheet order.\ndefineOptions({ inheritAttrs: false });\nconst { attrs, rest } = useSplitAttrs();\n\n/**\n * At least one face always renders. `max = 0` is the boundary that decides\n * this: a group collapsed to nothing but \"+5\" has spent an avatar row saying\n * only that some people exist, which is strictly less than one face and a\n * count would have said.\n */\nconst shown = computed(() => props.avatars.slice(0, Math.max(1, Math.trunc(props.max))));\n\n/** How many members the row did not have room for. Zero renders no counter at all. */\nconst hidden = computed(() => props.avatars.length - shown.value.length);\n\n/** What the counter prints. `+3` is the layout; the sentence below is the information. */\nconst printed = computed(() => `+${String(hidden.value)}`);\n\nconst overlap = computed(() => OVERLAP[props.size]);\n\n/** `ring-2` in the surface colour, on every face including the counter. */\nconst ring = computed(() => cn(\"ring-2\", SURFACE_RING[props.surface]));\n\n/**\n * What a screen reader reads for one member. The accent qualifier is composed\n * here rather than left to `Avatar`'s own hidden label, because the portrait\n * inside each item is `aria-hidden` — the item says the name once, in one\n * voice, whichever state the image is in.\n */\nfunction memberName(item: AvatarGroupItem): string {\n  const who = (item.alt ?? item.fallback ?? \"\").trim();\n  if ((item.variant ?? props.variant) !== \"accent\") return who;\n  return text.value.accent({ name: who });\n}\n</script>\n\n<template>\n  <!-- `role=\"list\"` on a div rather than a real `<ul>`, and the reason is the\n       page this is documented on. VitePress styles `.vp-doc li + li` with a top\n       margin and `.vp-doc ul` with a disc marker and a left indent, unlayered —\n       and unlayered CSS beats every Tailwind utility, which all live in\n       `@layer utilities`. A genuine list element here arrives bulleted, indented\n       and stepping 8px downhill per face. The roles are the semantics; the\n       elements were only ever carrying them.\n\n       The explicit attributes sit before `v-bind`, so a caller who names the\n       group with `aria-labelledby` instead of `label` keeps their own value\n       rather than having an unset prop overwrite it. -->\n  <div\n    v-if=\"avatars.length > 0\"\n    role=\"list\"\n    :aria-label=\"label\"\n    v-bind=\"rest\"\n    :class=\"cn('flex items-center', attrs.class as string)\"\n  >\n    <!-- The first face on top, each later one tucked under it. `z-index` is not\n         automatic on a flex row — painting order alone puts the *last* sibling\n         over its neighbours, which reads as a stack dealt backwards — and it\n         needs the positioned parent this span provides. -->\n    <span\n      v-for=\"(item, index) in shown\"\n      :key=\"`${String(index)}-${item.src ?? item.fallback ?? ''}`\"\n      role=\"listitem\"\n      :style=\"{ zIndex: shown.length - index }\"\n      :class=\"cn('relative', index > 0 && overlap)\"\n    >\n      <!-- `accent-label` is cleared because the item beside it has already\n           worked the qualifier into one name; left at its default the row would\n           carry two copies of the accent label per accent member. -->\n      <Avatar\n        aria-hidden=\"true\"\n        accent-label=\"\"\n        v-bind=\"optional({ src: item.src, alt: item.alt, fallback: item.fallback })\"\n        :size=\"size\"\n        :shape=\"shape\"\n        :variant=\"item.variant ?? variant\"\n        :class=\"ring\"\n      />\n      <span class=\"sr-only\">{{ memberName(item) }}</span>\n    </span>\n\n    <!-- The counter is a face-shaped tile rather than a shape of its own, so\n         the row keeps one rhythm: same size, same corner, same ring, and the\n         neutral well instead of a portrait's fill so it never reads as a\n         person. It sits under everything, at the back of the stack. -->\n    <span v-if=\"hidden > 0\" role=\"listitem\" :style=\"{ zIndex: 0 }\" :class=\"cn('relative', overlap)\">\n      <Avatar\n        aria-hidden=\"true\"\n        :fallback=\"printed\"\n        :size=\"size\"\n        :shape=\"shape\"\n        :class=\"cn(ring, 'bg-subtle text-subtle-foreground tabular')\"\n      />\n      <span class=\"sr-only\">{{ text.overflow({ count: hidden }) }}</span>\n    </span>\n  </div>\n</template>\n"],"mappings":""}

package/dist/packages/primitives/avatar-group/src/AvatarGroup.vue.d.ts

@@ -0,0 +1,81 @@
+import { type LabelOverrides } from "@ecoma-io/loom-labels";
+import type { AvatarGroupLabels } from "@ecoma-io/loom-labels";
+import type { AvatarShape, AvatarSize, AvatarVariant } from "@ecoma-io/loom-avatar";
+/** One face in the row. */
+export interface AvatarGroupItem {
+    /** Image URL. Omit it and this face renders `fallback` instead. */
+    src?: string;
+    /** Who this face is. It is what a screen reader reads for this member, whether or not the image ever loads — so it is the field to fill in even when there is no photo. */
+    alt?: string;
+    /** Initials shown while there is no image, or once one has failed. */
+    fallback?: string;
+    /** Which variant this member uses. Defaults to the group's own `variant`, so a row that mixes members states it per member and a row of one kind states it once. */
+    variant?: AvatarVariant;
+}
+/** The surface the row sits on, which the separating ring matches. */
+export type AvatarGroupSurface = "background" | "card" | "sunken" | "popover";
+/**
+
+/**
+ * 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 AVATAR_GROUP_LABELS: AvatarGroupLabels;
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    /** The members, in the order they are shown. The first is the one painted on top. */
+    avatars: AvatarGroupItem[];
+    /** How many faces render before the rest collapse into the counter. Values below 1 are treated as 1 — a row of nothing but "+5" identifies nobody. */
+    max?: number;
+    /** Height of every face in the row, and of the counter — one of `Avatar`'s five sizes, `xs` through `xl`. */
+    size?: AvatarSize;
+    /** `circle` or `square`, forwarded to every face so the row reads as one shape. */
+    shape?: AvatarShape;
+    /** `default` or `accent`, for members that do not name their own — set it to `accent` for a row where every member uses the accent variant. */
+    variant?: AvatarVariant;
+    /** The group's accessible name: "Assignees", "Reviewers", "Members". */
+    label?: string;
+    /** The surface the row sits on, so the ring separating the faces matches what surrounds them. */
+    surface?: AvatarGroupSurface;
+    /**
+     * Names for the counter and for an accent member, as any subset of
+     * `AvatarGroupLabels` — the rest stay as the host's `provideLoomLabels`
+     * vocabulary left them, and then as Loom's English.
+     *
+     * The per-instance case is a row where "more" is the wrong word for what
+     * was left out: three reviewers, three members, three files.
+     */
+    labels?: LabelOverrides<AvatarGroupLabels>;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    /** The members, in the order they are shown. The first is the one painted on top. */
+    avatars: AvatarGroupItem[];
+    /** How many faces render before the rest collapse into the counter. Values below 1 are treated as 1 — a row of nothing but "+5" identifies nobody. */
+    max?: number;
+    /** Height of every face in the row, and of the counter — one of `Avatar`'s five sizes, `xs` through `xl`. */
+    size?: AvatarSize;
+    /** `circle` or `square`, forwarded to every face so the row reads as one shape. */
+    shape?: AvatarShape;
+    /** `default` or `accent`, for members that do not name their own — set it to `accent` for a row where every member uses the accent variant. */
+    variant?: AvatarVariant;
+    /** The group's accessible name: "Assignees", "Reviewers", "Members". */
+    label?: string;
+    /** The surface the row sits on, so the ring separating the faces matches what surrounds them. */
+    surface?: AvatarGroupSurface;
+    /**
+     * Names for the counter and for an accent member, as any subset of
+     * `AvatarGroupLabels` — the rest stay as the host's `provideLoomLabels`
+     * vocabulary left them, and then as Loom's English.
+     *
+     * The per-instance case is a row where "more" is the wrong word for what
+     * was left out: three reviewers, three members, three files.
+     */
+    labels?: LabelOverrides<AvatarGroupLabels>;
+}> & Readonly<{}>, {
+    size: AvatarSize;
+    max: number;
+    variant: AvatarVariant;
+    shape: AvatarShape;
+    surface: AvatarGroupSurface;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+//# sourceMappingURL=AvatarGroup.vue.d.ts.map