@ecoma-io/loom 0.2.0 → 0.4.0

package/dist/packages/composition/sidebar/src/index.js

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

package/dist/packages/composition/split/src/Split.js

@@ -0,0 +1,7 @@
+import Split_vue_vue_type_script_setup_true_lang_default, { gapClass } from "./Split.vue_vue_type_script_setup_true_lang.js";
+//#region packages/composition/split/src/Split.vue
+var Split_default = Split_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { Split_default as default, gapClass };
+
+//# sourceMappingURL=Split.js.map

package/dist/packages/composition/split/src/Split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Split.js","names":[],"sources":["../../../../../packages/composition/split/src/Split.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Split — two-panel layout with intrinsic collapse.\n *\n * A flex row that places a side panel and a content area side by side above\n * a `collapseAt` width, and stacks them vertically below it. The side panel\n * gets a fixed minimum width; the content area grows to fill the remaining\n * space.\n *\n * This is the Every Layout \"Sidebar\" pattern, simplified for the common\n * two-panel case. The intrinsic collapse — panels stack when the container is\n * too narrow — avoids a breakpoint per viewport, and works identically inside\n * a sidebar-narrowed workspace and full-bleed on an ultra-wide monitor.\n *\n * A Split is a component, not a hand-rolled flex row with a media query,\n * because the collapse width is a layout decision the call site should name\n * rather than compute, and the stacking order (side above or below) is an\n * intent the `side` prop expresses.\n */\nexport type SplitSide = \"left\" | \"right\";\n\nexport type SplitGap = \"sm\" | \"md\" | \"lg\" | \"none\";\n\nconst gapClass: Record<Exclude<SplitGap, \"none\">, string> = {\n  sm: \"gap-2 sm:gap-3\",\n  md: \"gap-3 sm:gap-4\",\n  lg: \"gap-4 sm:gap-6\",\n} as const;\n\nexport { gapClass };\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** The side the panel sits on. Controls stacking order when collapsed: \"left\" stacks the panel above, \"right\" stacks it below. */\n    side?: SplitSide;\n    /** Below this CSS width the two panels stack vertically instead of sitting side by side. Default: `\"48rem\"`. */\n    collapseAt?: string;\n    /** Minimum width for the side panel (e.g. \"16rem\"). The content area takes the rest. */\n    minSideWidth?: string;\n    /** Gap between the two panels. Tightens one notch below `sm` (except \"none\"). */\n    gap?: SplitGap;\n  }>(),\n  { side: \"left\", collapseAt: \"48rem\", minSideWidth: \"16rem\", gap: \"md\" },\n);\n</script>\n\n<template>\n  <!--\n    `flex-wrap` is the intrinsic collapse mechanism: when the combined\n    `min-width` of both panels exceeds the container, the second panel wraps\n    to a new line. The `collapseAt` prop sets the breakpoint that controls\n    when `flex-wrap` is active.\n  -->\n  <div\n    :class=\"\n      cn(\n        'flex',\n        side === 'right' ? 'flex-row-reverse' : 'flex-row',\n        gap !== 'none' ? gapClass[gap] : undefined,\n      )\n    \"\n    :style=\"{\n      flexWrap: 'wrap',\n    }\"\n  >\n    <!-- Side panel: fixed minimum width, does not grow. When collapsed the\n         panel takes full width (flex-basis: 100%). -->\n    <div\n      :style=\"{\n        flexBasis: minSideWidth,\n        flexGrow: 0,\n        flexShrink: 0,\n        minWidth: minSideWidth,\n      }\"\n    >\n      <slot name=\"side\" />\n    </div>\n\n    <!-- Content area: fills remaining space, but demands at least 50% of\n         the container before wrapping. When collapsed it also takes full\n         width. -->\n    <div\n      :style=\"{\n        flexBasis: 0,\n        flexGrow: 999,\n        flexShrink: 1,\n        minWidth: '50%',\n      }\"\n    >\n      <slot />\n    </div>\n  </div>\n</template>\n"],"mappings":""}

package/dist/packages/composition/split/src/Split.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Split.vue.d.ts","sourceRoot":"","sources":["../../../../../packages/composition/split/src/Split.vue"],"names":[],"mappings":"AAuGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAEnD,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAI9C,CAAC;AAEX,OAAO,EAAE,QAAQ,EAAE,CAAC;wBACC,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAEd,kIAAkI;WAC3H,SAAS;IAChB,gHAAgH;iBACnG,MAAM;IACnB,wFAAwF;mBACzE,MAAM;IACrB,iFAAiF;UAC3E,QAAQ;;IAPd,kIAAkI;WAC3H,SAAS;IAChB,gHAAgH;iBACnG,MAAM;IACnB,wFAAwF;mBACzE,MAAM;IACrB,iFAAiF;UAC3E,QAAQ;;SAAR,QAAQ;UANP,SAAS;gBAEH,MAAM;kBAEJ,MAAM;;WA+Dd,CAAC,KAAK,IAAgB,KAAK,GAAG;;cAC3B,CAAC,KAAK,IAAgB,KAAK,GAAG;EAUxC,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/composition/split/src/Split.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,41 @@
+import { cn } from "../../../core/src/cn.js";
+import "../../../core/src/index.js";
+import { createElementBlock, createElementVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, renderSlot, unref } from "vue";
+//#region packages/composition/split/src/Split.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { style: {
+	flexBasis: 0,
+	flexGrow: 999,
+	flexShrink: 1,
+	minWidth: "50%"
+} };
+var gapClass = {
+	sm: "gap-2 sm:gap-3",
+	md: "gap-3 sm:gap-4",
+	lg: "gap-4 sm:gap-6"
+};
+var Split_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "Split",
+	props: {
+		side: { default: "left" },
+		collapseAt: { default: "48rem" },
+		minSideWidth: { default: "16rem" },
+		gap: { default: "md" }
+	},
+	setup(__props) {
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", {
+				class: normalizeClass(unref(cn)("flex", __props.side === "right" ? "flex-row-reverse" : "flex-row", __props.gap !== "none" ? gapClass[__props.gap] : void 0)),
+				style: { flexWrap: "wrap" }
+			}, [createElementVNode("div", { style: normalizeStyle({
+				flexBasis: __props.minSideWidth,
+				flexGrow: 0,
+				flexShrink: 0,
+				minWidth: __props.minSideWidth
+			}) }, [renderSlot(_ctx.$slots, "side")], 4), createElementVNode("div", _hoisted_1, [renderSlot(_ctx.$slots, "default")])], 2);
+		};
+	}
+});
+//#endregion
+export { Split_vue_vue_type_script_setup_true_lang_default as default, gapClass };
+
+//# sourceMappingURL=Split.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/composition/split/src/Split.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Split.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../../packages/composition/split/src/Split.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Split — two-panel layout with intrinsic collapse.\n *\n * A flex row that places a side panel and a content area side by side above\n * a `collapseAt` width, and stacks them vertically below it. The side panel\n * gets a fixed minimum width; the content area grows to fill the remaining\n * space.\n *\n * This is the Every Layout \"Sidebar\" pattern, simplified for the common\n * two-panel case. The intrinsic collapse — panels stack when the container is\n * too narrow — avoids a breakpoint per viewport, and works identically inside\n * a sidebar-narrowed workspace and full-bleed on an ultra-wide monitor.\n *\n * A Split is a component, not a hand-rolled flex row with a media query,\n * because the collapse width is a layout decision the call site should name\n * rather than compute, and the stacking order (side above or below) is an\n * intent the `side` prop expresses.\n */\nexport type SplitSide = \"left\" | \"right\";\n\nexport type SplitGap = \"sm\" | \"md\" | \"lg\" | \"none\";\n\nconst gapClass: Record<Exclude<SplitGap, \"none\">, string> = {\n  sm: \"gap-2 sm:gap-3\",\n  md: \"gap-3 sm:gap-4\",\n  lg: \"gap-4 sm:gap-6\",\n} as const;\n\nexport { gapClass };\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** The side the panel sits on. Controls stacking order when collapsed: \"left\" stacks the panel above, \"right\" stacks it below. */\n    side?: SplitSide;\n    /** Below this CSS width the two panels stack vertically instead of sitting side by side. Default: `\"48rem\"`. */\n    collapseAt?: string;\n    /** Minimum width for the side panel (e.g. \"16rem\"). The content area takes the rest. */\n    minSideWidth?: string;\n    /** Gap between the two panels. Tightens one notch below `sm` (except \"none\"). */\n    gap?: SplitGap;\n  }>(),\n  { side: \"left\", collapseAt: \"48rem\", minSideWidth: \"16rem\", gap: \"md\" },\n);\n</script>\n\n<template>\n  <!--\n    `flex-wrap` is the intrinsic collapse mechanism: when the combined\n    `min-width` of both panels exceeds the container, the second panel wraps\n    to a new line. The `collapseAt` prop sets the breakpoint that controls\n    when `flex-wrap` is active.\n  -->\n  <div\n    :class=\"\n      cn(\n        'flex',\n        side === 'right' ? 'flex-row-reverse' : 'flex-row',\n        gap !== 'none' ? gapClass[gap] : undefined,\n      )\n    \"\n    :style=\"{\n      flexWrap: 'wrap',\n    }\"\n  >\n    <!-- Side panel: fixed minimum width, does not grow. When collapsed the\n         panel takes full width (flex-basis: 100%). -->\n    <div\n      :style=\"{\n        flexBasis: minSideWidth,\n        flexGrow: 0,\n        flexShrink: 0,\n        minWidth: minSideWidth,\n      }\"\n    >\n      <slot name=\"side\" />\n    </div>\n\n    <!-- Content area: fills remaining space, but demands at least 50% of\n         the container before wrapping. When collapsed it also takes full\n         width. -->\n    <div\n      :style=\"{\n        flexBasis: 0,\n        flexGrow: 999,\n        flexShrink: 1,\n        minWidth: '50%',\n      }\"\n    >\n      <slot />\n    </div>\n  </div>\n</template>\n"],"mappings":";;;;;;;;;;AAuBA,IAAM,WAAsD;CAC1D,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;;;;;;;;;;GA8BE,OAAA,UAAA,GAAA,mBAsCM,OAAA;IArCH,OAAK,eAAS,MAAA,EAAA,CAAE,CAAA,QAA0B,QAAA,SAAI,UAAA,qBAAA,YAAwD,QAAA,QAAG,SAAc,SAAS,QAAA,OAAO,KAAA,CAAA,CAAA;IAOvI,OAAO,EAAA,UAAA,OAEP;GAID,GAAA,CAAA,mBASM,OAAA,EARH,OAAK,eAAA;IAAuB,WAAA,QAAA;;;IAA4E,UAAA,QAAA;GAOzG,CAAA,EAAA,GAAA,CAAA,WAAoB,KAAA,QAAA,MAAA,CAAA,GAAA,CAAA,GAMtB,mBASM,OATN,YASM,CADJ,WAAQ,KAAA,QAAA,SAAA,CAAA,CAAA,CAAA,GAAA,CAAA"}

package/dist/packages/composition/split/src/index.d.ts

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

package/dist/packages/composition/split/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/composition/split/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/packages/composition/split/src/index.js

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

package/dist/packages/composition/stack/src/Stack.js

@@ -0,0 +1,7 @@
+import Stack_vue_vue_type_script_setup_true_lang_default, { alignClass, gapClass } from "./Stack.vue_vue_type_script_setup_true_lang.js";
+//#region packages/composition/stack/src/Stack.vue
+var Stack_default = Stack_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { alignClass, Stack_default as default, gapClass };
+
+//# sourceMappingURL=Stack.js.map

package/dist/packages/composition/stack/src/Stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stack.js","names":[],"sources":["../../../../../packages/composition/stack/src/Stack.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Stack — vertical flow with consistent, responsive gap.\n *\n * A flex column that tightens its gutter one step below the `sm` breakpoint,\n * where stacked items have no room to waste on air. The gap steps mirror\n * DashboardGrid's: the value each step names applies from `sm` up, and drops\n * one notch below it.\n *\n * A Stack is a component, not `flex flex-col gap-4`, for three reasons: the\n * responsive gap is the component's job (not every call site's), the\n * `separator` slot avoids a repeated `v-for` + `v-if` pattern, and the\n * `align` prop maps cross-axis intent to a Tailwind class without the caller\n * remembering which flex utility is which.\n */\nexport type StackGap = \"sm\" | \"md\" | \"lg\";\n\nexport type StackAlign = \"start\" | \"center\" | \"end\" | \"stretch\";\n\nconst gapClass: Record<StackGap, string> = {\n  sm: \"gap-2 sm:gap-3\",\n  md: \"gap-3 sm:gap-4\",\n  lg: \"gap-4 sm:gap-6\",\n} as const;\n\nconst alignClass: Record<StackAlign, string> = {\n  start: \"items-start\",\n  center: \"items-center\",\n  end: \"items-end\",\n  stretch: \"items-stretch\",\n} as const;\n\nexport { gapClass, alignClass };\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** Vertical gap step — mirrors DashboardGrid's scale. Tightens one notch below `sm`. */\n    gap?: StackGap;\n    /** Cross-axis alignment of children. */\n    align?: StackAlign;\n  }>(),\n  { gap: \"md\", align: \"stretch\" },\n);\n</script>\n\n<template>\n  <div :class=\"cn('flex flex-col', gapClass[gap], alignClass[align])\">\n    <!-- Each direct child is a stack item. The separator slot, if filled,\n         is rendered between every pair of children — a <Separator /> or a\n         thin <div class=\"border-t border-border\">, for example. -->\n    <slot />\n  </div>\n</template>\n"],"mappings":""}

package/dist/packages/composition/stack/src/Stack.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stack.vue.d.ts","sourceRoot":"","sources":["../../../../../packages/composition/stack/src/Stack.vue"],"names":[],"mappings":"AA+DA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEhE,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAI7B,CAAC;AAEX,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAKjC,CAAC;AAEX,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;wBACX,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAEd,wFAAwF;UAClF,QAAQ;IACd,wCAAwC;YAChC,UAAU;;IAHlB,wFAAwF;UAClF,QAAQ;IACd,wCAAwC;YAChC,UAAU;;SAFZ,QAAQ;WAEN,UAAU;;cAmCR,CAAC,KAAK,IAAgB,KAAK,GAAG;EAUxC,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/composition/stack/src/Stack.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,31 @@
+import { cn } from "../../../core/src/cn.js";
+import "../../../core/src/index.js";
+import { createElementBlock, defineComponent, normalizeClass, openBlock, renderSlot, unref } from "vue";
+//#region packages/composition/stack/src/Stack.vue?vue&type=script&setup=true&lang.ts
+var gapClass = {
+	sm: "gap-2 sm:gap-3",
+	md: "gap-3 sm:gap-4",
+	lg: "gap-4 sm:gap-6"
+};
+var alignClass = {
+	start: "items-start",
+	center: "items-center",
+	end: "items-end",
+	stretch: "items-stretch"
+};
+var Stack_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "Stack",
+	props: {
+		gap: { default: "md" },
+		align: { default: "stretch" }
+	},
+	setup(__props) {
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cn)("flex flex-col", gapClass[__props.gap], alignClass[__props.align])) }, [renderSlot(_ctx.$slots, "default")], 2);
+		};
+	}
+});
+//#endregion
+export { alignClass, Stack_vue_vue_type_script_setup_true_lang_default as default, gapClass };
+
+//# sourceMappingURL=Stack.vue_vue_type_script_setup_true_lang.js.map

package/dist/packages/composition/stack/src/Stack.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stack.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../../packages/composition/stack/src/Stack.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Stack — vertical flow with consistent, responsive gap.\n *\n * A flex column that tightens its gutter one step below the `sm` breakpoint,\n * where stacked items have no room to waste on air. The gap steps mirror\n * DashboardGrid's: the value each step names applies from `sm` up, and drops\n * one notch below it.\n *\n * A Stack is a component, not `flex flex-col gap-4`, for three reasons: the\n * responsive gap is the component's job (not every call site's), the\n * `separator` slot avoids a repeated `v-for` + `v-if` pattern, and the\n * `align` prop maps cross-axis intent to a Tailwind class without the caller\n * remembering which flex utility is which.\n */\nexport type StackGap = \"sm\" | \"md\" | \"lg\";\n\nexport type StackAlign = \"start\" | \"center\" | \"end\" | \"stretch\";\n\nconst gapClass: Record<StackGap, string> = {\n  sm: \"gap-2 sm:gap-3\",\n  md: \"gap-3 sm:gap-4\",\n  lg: \"gap-4 sm:gap-6\",\n} as const;\n\nconst alignClass: Record<StackAlign, string> = {\n  start: \"items-start\",\n  center: \"items-center\",\n  end: \"items-end\",\n  stretch: \"items-stretch\",\n} as const;\n\nexport { gapClass, alignClass };\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** Vertical gap step — mirrors DashboardGrid's scale. Tightens one notch below `sm`. */\n    gap?: StackGap;\n    /** Cross-axis alignment of children. */\n    align?: StackAlign;\n  }>(),\n  { gap: \"md\", align: \"stretch\" },\n);\n</script>\n\n<template>\n  <div :class=\"cn('flex flex-col', gapClass[gap], alignClass[align])\">\n    <!-- Each direct child is a stack item. The separator slot, if filled,\n         is rendered between every pair of children — a <Separator /> or a\n         thin <div class=\"border-t border-border\">, for example. -->\n    <slot />\n  </div>\n</template>\n"],"mappings":";;;;AAmBA,IAAM,WAAqC;CACzC,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,IAAM,aAAyC;CAC7C,OAAO;CACP,QAAQ;CACR,KAAK;CACL,SAAS;AACX;;;;;;;;;GAoBE,OAAA,UAAA,GAAA,mBAKM,OAAA,EALA,OAAK,eAAE,MAAA,EAAA,CAAE,CAAA,iBAAkB,SAAS,QAAA,MAAM,WAAW,QAAA,MAAK,CAAA,EAAA,GAAA,CAI9D,WAAQ,KAAA,QAAA,SAAA,CAAA,GAAA,CAAA"}

package/dist/packages/composition/stack/src/index.d.ts

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

package/dist/packages/composition/stack/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/composition/stack/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/packages/composition/stack/src/index.js

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

package/dist/packages/core/src/a11y-scope.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The WCAG scope Loom holds itself to: the assistive-technology and keyboard
+ * rules, not axe's SEO and document-structure best-practice set. A component
+ * library cannot know what document it will be rendered into, so a rule about
+ * the document is the consumer's to answer, not ours.
+ *
+ * Single source for every axe run against this package, and there is more
+ * than one, in different processes: the documentation site's live
+ * accessibility panel and the end-to-end gate that scans the built site. Both
+ * import this. The list must never be restated, or the panel a contributor
+ * reads and the gate that blocks the merge drift into disagreeing about what
+ * counts as a violation.
+ *
+ * Exported from the narrow `@ecoma-io/loom/a11y` entry so a tool that only
+ * needs this array — a Playwright run, a CI script — can read it without
+ * pulling in a single Vue component.
+ */
+export declare const WCAG_TAGS: readonly ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa", "wcag22aa"];
+//# sourceMappingURL=a11y-scope.d.ts.map

package/dist/packages/core/src/a11y-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-scope.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/a11y-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,mEAAoE,CAAC"}

package/dist/packages/core/src/a11y-scope.js

@@ -0,0 +1,29 @@
+//#region packages/core/src/a11y-scope.ts
+/**
+* The WCAG scope Loom holds itself to: the assistive-technology and keyboard
+* rules, not axe's SEO and document-structure best-practice set. A component
+* library cannot know what document it will be rendered into, so a rule about
+* the document is the consumer's to answer, not ours.
+*
+* Single source for every axe run against this package, and there is more
+* than one, in different processes: the documentation site's live
+* accessibility panel and the end-to-end gate that scans the built site. Both
+* import this. The list must never be restated, or the panel a contributor
+* reads and the gate that blocks the merge drift into disagreeing about what
+* counts as a violation.
+*
+* Exported from the narrow `@ecoma-io/loom/a11y` entry so a tool that only
+* needs this array — a Playwright run, a CI script — can read it without
+* pulling in a single Vue component.
+*/
+var WCAG_TAGS = [
+	"wcag2a",
+	"wcag2aa",
+	"wcag21a",
+	"wcag21aa",
+	"wcag22aa"
+];
+//#endregion
+export { WCAG_TAGS };
+
+//# sourceMappingURL=a11y-scope.js.map

package/dist/packages/core/src/a11y-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-scope.js","names":[],"sources":["../../../../packages/core/src/a11y-scope.ts"],"sourcesContent":["/**\n * The WCAG scope Loom holds itself to: the assistive-technology and keyboard\n * rules, not axe's SEO and document-structure best-practice set. A component\n * library cannot know what document it will be rendered into, so a rule about\n * the document is the consumer's to answer, not ours.\n *\n * Single source for every axe run against this package, and there is more\n * than one, in different processes: the documentation site's live\n * accessibility panel and the end-to-end gate that scans the built site. Both\n * import this. The list must never be restated, or the panel a contributor\n * reads and the gate that blocks the merge drift into disagreeing about what\n * counts as a violation.\n *\n * Exported from the narrow `@ecoma-io/loom/a11y` entry so a tool that only\n * needs this array — a Playwright run, a CI script — can read it without\n * pulling in a single Vue component.\n */\nexport const WCAG_TAGS = [\"wcag2a\", \"wcag2aa\", \"wcag21a\", \"wcag21aa\", \"wcag22aa\"] as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,IAAa,YAAY;CAAC;CAAU;CAAW;CAAW;CAAY;AAAU"}

package/dist/packages/core/src/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/attrs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5C,CAOA"}

package/dist/packages/core/src/attrs.js

@@ -0,0 +1,28 @@
+import { computed, useAttrs } from "vue";
+//#region packages/core/src/attrs.ts
+/**
+* Split `useAttrs()` into the raw fallthrough attributes — read `.class` off
+* `attrs` for a `cn()` merge — and the same attributes minus `class` (`rest`,
+* for `v-bind` onto whichever node is not the `class` target).
+*
+* Every caller pairs this with `defineOptions({ inheritAttrs: false })`.
+* NumberField's input, Slider's thumb and Select's trigger each route `class`
+* onto one specific rendered node rather than taking Vue's default
+* single-root fallthrough, because `class` needs a Tailwind-aware merge while
+* the rest of the fallthrough — aria-*, data-testid — only needs to land
+* somewhere real.
+*/
+function useSplitAttrs() {
+	const attrs = useAttrs();
+	return {
+		attrs,
+		rest: computed(() => {
+			const { class: _class, ...others } = attrs;
+			return others;
+		})
+	};
+}
+//#endregion
+export { useSplitAttrs };
+
+//# sourceMappingURL=attrs.js.map

package/dist/packages/core/src/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","names":[],"sources":["../../../../packages/core/src/attrs.ts"],"sourcesContent":["import { computed, useAttrs, type ComputedRef } from \"vue\";\n\n/**\n * Split `useAttrs()` into the raw fallthrough attributes — read `.class` off\n * `attrs` for a `cn()` merge — and the same attributes minus `class` (`rest`,\n * for `v-bind` onto whichever node is not the `class` target).\n *\n * Every caller pairs this with `defineOptions({ inheritAttrs: false })`.\n * NumberField's input, Slider's thumb and Select's trigger each route `class`\n * onto one specific rendered node rather than taking Vue's default\n * single-root fallthrough, because `class` needs a Tailwind-aware merge while\n * the rest of the fallthrough — aria-*, data-testid — only needs to land\n * somewhere real.\n */\nexport function useSplitAttrs(): {\n  attrs: Record<string, unknown>;\n  rest: ComputedRef<Record<string, unknown>>;\n} {\n  const attrs = useAttrs();\n  const rest = computed(() => {\n    const { class: _class, ...others } = attrs;\n    return others;\n  });\n  return { attrs, rest };\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,gBAGd;CACA,MAAM,QAAQ,SAAS;CAKvB,OAAO;EAAE;EAAO,MAJH,eAAe;GAC1B,MAAM,EAAE,OAAO,QAAQ,GAAG,WAAW;GACrC,OAAO;EACT,CACgB;CAAK;AACvB"}

package/dist/packages/core/src/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAqF7C;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}

package/dist/packages/core/src/cn.js

@@ -0,0 +1,61 @@
+import { clsx } from "clsx";
+import { extendTailwindMerge } from "tailwind-merge";
+//#region packages/core/src/cn.ts
+var twMerge = extendTailwindMerge({ extend: { classGroups: {
+	"font-size": [
+		"text-display",
+		"text-heading",
+		"text-title",
+		"text-body",
+		"text-small",
+		"text-micro"
+	],
+	animate: [
+		"animate-fade",
+		"animate-fade-rise",
+		"animate-fade-out",
+		"animate-fade-fall",
+		"animate-scale-in",
+		"animate-scale-out",
+		"animate-shimmer",
+		"animate-progress-indeterminate",
+		"animate-toast-in",
+		"animate-slide-out-to-left",
+		"animate-slide-out-to-right",
+		"animate-slide-out-to-top",
+		"animate-slide-out-to-bottom"
+	],
+	duration: [
+		"duration-instant",
+		"duration-fast",
+		"duration-slow",
+		"duration-slower"
+	],
+	ease: ["ease-spring"],
+	z: [
+		"z-raised",
+		"z-sticky",
+		"z-chrome",
+		"z-overlay",
+		"z-toast"
+	],
+	opacity: [
+		"opacity-disabled",
+		"opacity-scrim",
+		"opacity-scrim-light"
+	],
+	scale: ["scale-press"]
+} } });
+/**
+* Merge conditional class names, resolving Tailwind conflicts so the last
+* utility in a group wins. Every component routes its `class` through this,
+* which is what lets a consumer override any utility from the outside without
+* reaching for `!important`.
+*/
+function cn(...inputs) {
+	return twMerge(clsx(inputs));
+}
+//#endregion
+export { cn };
+
+//# sourceMappingURL=cn.js.map

package/dist/packages/core/src/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","names":[],"sources":["../../../../packages/core/src/cn.ts"],"sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { extendTailwindMerge } from \"tailwind-merge\";\n\n/**\n * Loom's named type scale, as tailwind-merge knows it.\n *\n * `theme.css` declares the scale under Tailwind's `--text-*` namespace, which\n * makes `text-body` a font-size utility exactly like `text-sm`. tailwind-merge\n * cannot see that: it resolves conflicts from a static table of Tailwind's own\n * value names, and every unrecognised `text-<x>` falls through to the colour\n * group. So `text-micro` and `text-primary-foreground` looked like two colours,\n * the later one won, and the size was dropped on the floor.\n *\n * The failure is silent and it is not hypothetical — Indicator's count pill was\n * shipping without its 11px size, and it was found by reading a diff rather\n * than by anything failing. It also reached further than any one component:\n * `cn()` is the documented way a consumer overrides a class from outside, so\n * `<PageHeader class=\"text-small\">` had its size swallowed by the component's\n * own `text-foreground` and there was nothing to notice.\n *\n * Registering the six names restores the property they actually set. Both\n * directions then merge correctly against Tailwind's built-ins, because they\n * are one group rather than two: `text-xs text-body` keeps `text-body`, and\n * `text-body text-xs` keeps `text-xs`.\n */\nconst TYPE_SCALE = [\n  \"text-display\",\n  \"text-heading\",\n  \"text-title\",\n  \"text-body\",\n  \"text-small\",\n  \"text-micro\",\n];\n\n/**\n * The rest of the named vocabulary, registered for the same reason and found by\n * probing rather than by reading — every one of these was returning *both*\n * classes, leaving the winner to stylesheet order instead of to what the\n * component wrote.\n *\n * A registration here is the precondition for adding a name to `theme.css`, not\n * a follow-up to it. Anything Loom names under a namespace tailwind-merge\n * resolves by value table — durations, easings, animations — is invisible to it\n * until it appears below, and the defect it produces is the silent one this\n * file already exists to document.\n */\nconst ANIMATIONS = [\n  \"animate-fade\",\n  \"animate-fade-rise\",\n  \"animate-fade-out\",\n  \"animate-fade-fall\",\n  \"animate-scale-in\",\n  \"animate-scale-out\",\n  \"animate-shimmer\",\n  \"animate-progress-indeterminate\",\n  \"animate-toast-in\",\n  \"animate-slide-out-to-left\",\n  \"animate-slide-out-to-right\",\n  \"animate-slide-out-to-top\",\n  \"animate-slide-out-to-bottom\",\n];\n\n// The four `@utility` blocks at the foot of `theme.css`. They exist because\n// Tailwind's generated `duration-*` takes a millisecond count and not a token\n// name, which is the same reason tailwind-merge cannot see them either.\nconst DURATIONS = [\"duration-instant\", \"duration-fast\", \"duration-slow\", \"duration-slower\"];\n\n// `ease-out`, `ease-in` and `ease-in-out` are Tailwind's own names and already\n// resolve; only the restrained overshoot is ours.\nconst EASINGS = [\"ease-spring\"];\n\nconst twMerge = extendTailwindMerge({\n  extend: {\n    classGroups: {\n      \"font-size\": TYPE_SCALE,\n      animate: ANIMATIONS,\n      duration: DURATIONS,\n      ease: EASINGS,\n      z: [\"z-raised\", \"z-sticky\", \"z-chrome\", \"z-overlay\", \"z-toast\"],\n      opacity: [\"opacity-disabled\", \"opacity-scrim\", \"opacity-scrim-light\"],\n      scale: [\"scale-press\"],\n    },\n  },\n});\n\n/**\n * Merge conditional class names, resolving Tailwind conflicts so the last\n * utility in a group wins. Every component routes its `class` through this,\n * which is what lets a consumer override any utility from the outside without\n * reaching for `!important`.\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":";;;AAuEA,IAAM,UAAU,oBAAoB,EAClC,QAAQ,EACN,aAAa;CACX,aAAa;EAhDjB;EACA;EACA;EACA;EACA;EACA;CA2CiB;CACb,SAAS;EA5Bb;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAgBa;CACT,UAAU;EAXG;EAAoB;EAAiB;EAAiB;CAWzD;CACV,MAAM,CARK,aAQL;CACN,GAAG;EAAC;EAAY;EAAY;EAAY;EAAa;CAAS;CAC9D,SAAS;EAAC;EAAoB;EAAiB;CAAqB;CACpE,OAAO,CAAC,aAAa;AACvB,EACF,EACF,CAAC;;;;;;;AAQD,SAAgB,GAAG,GAAG,QAA8B;CAClD,OAAO,QAAQ,KAAK,MAAM,CAAC;AAC7B"}

package/dist/packages/core/src/icon-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-defaults.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/icon-defaults.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/packages/core/src/icon-defaults.js

@@ -0,0 +1,32 @@
+import { setLucideProps } from "@lucide/vue";
+//#region packages/core/src/icon-defaults.ts
+/**
+* Apply the Loom icon defaults once at a host's root: size 16, stroke 1.5 —
+* hairline-first, matching the 1px border language. Every `@lucide/vue` icon
+* rendered after this call inherits them, so an individual icon declares
+* `size` or `strokeWidth` only where it deliberately diverges.
+*
+* The one standing divergence: a glyph rendered at 12px or below declares
+* `stroke-width` 2.5 exactly. Stroke lives on the 24 grid and scales with
+* size, so 1.5 at 12px renders 0.75 device pixels against 1.0 at 16px; 2.5
+* restores the optical weight.
+*
+* The numbers live here, not in each host.
+*
+* Call it from the `setup()` of the host's root component — `App.vue`, or the
+* component a documentation theme wraps its layout in. It resolves to Vue's
+* `provide()`, so it needs an active component instance: called from a plain
+* entry module it silently provides nothing, and every icon keeps Lucide's own
+* 24/2 defaults. There is no app-level alternative, because the injection key
+* Lucide provides under is not part of its public surface.
+*/
+function applyLoomIconDefaults() {
+	setLucideProps({
+		size: 16,
+		strokeWidth: 1.5
+	});
+}
+//#endregion
+export { applyLoomIconDefaults };
+
+//# sourceMappingURL=icon-defaults.js.map

package/dist/packages/core/src/icon-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-defaults.js","names":[],"sources":["../../../../packages/core/src/icon-defaults.ts"],"sourcesContent":["import { setLucideProps } from \"@lucide/vue\";\n\n/**\n * Apply the Loom icon defaults once at a host's root: size 16, stroke 1.5 —\n * hairline-first, matching the 1px border language. Every `@lucide/vue` icon\n * rendered after this call inherits them, so an individual icon declares\n * `size` or `strokeWidth` only where it deliberately diverges.\n *\n * The one standing divergence: a glyph rendered at 12px or below declares\n * `stroke-width` 2.5 exactly. Stroke lives on the 24 grid and scales with\n * size, so 1.5 at 12px renders 0.75 device pixels against 1.0 at 16px; 2.5\n * restores the optical weight.\n *\n * The numbers live here, not in each host.\n *\n * Call it from the `setup()` of the host's root component — `App.vue`, or the\n * component a documentation theme wraps its layout in. It resolves to Vue's\n * `provide()`, so it needs an active component instance: called from a plain\n * entry module it silently provides nothing, and every icon keeps Lucide's own\n * 24/2 defaults. There is no app-level alternative, because the injection key\n * Lucide provides under is not part of its public surface.\n */\nexport function applyLoomIconDefaults(): void {\n  setLucideProps({ size: 16, strokeWidth: 1.5 });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,wBAA8B;CAC5C,eAAe;EAAE,MAAM;EAAI,aAAa;CAAI,CAAC;AAC/C"}

package/dist/packages/core/src/index.d.ts

@@ -0,0 +1,9 @@
+export { cn } from "./cn";
+export { optional } from "./props";
+export { useSplitAttrs } from "./attrs";
+export { LIST_STAGGER_CAP, LIST_STAGGER_STEP_MS, listStaggerDelay, smoothScrollBehavior, } from "./motion";
+export { WCAG_TAGS } from "./a11y-scope";
+export { useTheme, themeScript } from "./theme";
+export type { ThemePreference, ResolvedTheme } from "./theme";
+export { applyLoomIconDefaults } from "./icon-defaults";
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/packages/core/src/index.js

@@ -0,0 +1,8 @@
+import { cn } from "./cn.js";
+import { optional } from "./props.js";
+import { useSplitAttrs } from "./attrs.js";
+import { listStaggerDelay, smoothScrollBehavior } from "./motion.js";
+import { WCAG_TAGS } from "./a11y-scope.js";
+import { themeScript, useTheme } from "./theme.js";
+import { applyLoomIconDefaults } from "./icon-defaults.js";
+export { WCAG_TAGS, applyLoomIconDefaults, cn, listStaggerDelay, optional, smoothScrollBehavior, themeScript, useSplitAttrs, useTheme };

package/dist/packages/core/src/motion.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The list-reveal stagger vocabulary — one source for every overlay that
+ * reveals rows (DropdownMenu, Menubar, Select) and for the Motion
+ * documentation page. Each revealed row is delayed one step after the
+ * previous, capped so a long list does not tail off indefinitely.
+ *
+ * It lives here rather than in each template because it was written into
+ * three of them independently once, which is how the three drifted.
+ */
+export declare const LIST_STAGGER_STEP_MS = 24;
+export declare const LIST_STAGGER_CAP = 5;
+/** The inline `animation-delay` for the i-th revealed row. */
+export declare function listStaggerDelay(i: number): string;
+/**
+ * The behaviour a scripted scroll should ask for, given the reader's motion
+ * preference: `"smooth"` normally, `"auto"` under
+ * `prefers-reduced-motion`.
+ *
+ * It has to exist because the stylesheet's kill-switch cannot reach this
+ * path: an explicit `"smooth"` in a `scrollTo` dictionary *overrides* the
+ * CSS `scroll-behavior` property — that is what the spec defines a
+ * non-`"auto"` behaviour value to mean. Every component that scrolls by
+ * script (ScrollReel, Carousel) asks this instead of deciding alone, which
+ * is why it lives here and not in either of them.
+ */
+export declare function smoothScrollBehavior(): "auto" | "smooth";
+//# sourceMappingURL=motion.d.ts.map

package/dist/packages/core/src/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/motion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,QAAQ,CAOxD"}

package/dist/packages/core/src/motion.js

@@ -0,0 +1,27 @@
+/** The inline `animation-delay` for the i-th revealed row. */
+function listStaggerDelay(i) {
+	return `${String(Math.min(i, 5) * 24)}ms`;
+}
+/**
+* The behaviour a scripted scroll should ask for, given the reader's motion
+* preference: `"smooth"` normally, `"auto"` under
+* `prefers-reduced-motion`.
+*
+* It has to exist because the stylesheet's kill-switch cannot reach this
+* path: an explicit `"smooth"` in a `scrollTo` dictionary *overrides* the
+* CSS `scroll-behavior` property — that is what the spec defines a
+* non-`"auto"` behaviour value to mean. Every component that scrolls by
+* script (ScrollReel, Carousel) asks this instead of deciding alone, which
+* is why it lives here and not in either of them.
+*/
+function smoothScrollBehavior() {
+	try {
+		return window.matchMedia("(prefers-reduced-motion: reduce)").matches ? "auto" : "smooth";
+	} catch {
+		return "smooth";
+	}
+}
+//#endregion
+export { listStaggerDelay, smoothScrollBehavior };
+
+//# sourceMappingURL=motion.js.map

package/dist/packages/core/src/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.js","names":[],"sources":["../../../../packages/core/src/motion.ts"],"sourcesContent":["/**\n * The list-reveal stagger vocabulary — one source for every overlay that\n * reveals rows (DropdownMenu, Menubar, Select) and for the Motion\n * documentation page. Each revealed row is delayed one step after the\n * previous, capped so a long list does not tail off indefinitely.\n *\n * It lives here rather than in each template because it was written into\n * three of them independently once, which is how the three drifted.\n */\nexport const LIST_STAGGER_STEP_MS = 24;\nexport const LIST_STAGGER_CAP = 5;\n\n/** The inline `animation-delay` for the i-th revealed row. */\nexport function listStaggerDelay(i: number): string {\n  return `${String(Math.min(i, LIST_STAGGER_CAP) * LIST_STAGGER_STEP_MS)}ms`;\n}\n\n/**\n * The behaviour a scripted scroll should ask for, given the reader's motion\n * preference: `\"smooth\"` normally, `\"auto\"` under\n * `prefers-reduced-motion`.\n *\n * It has to exist because the stylesheet's kill-switch cannot reach this\n * path: an explicit `\"smooth\"` in a `scrollTo` dictionary *overrides* the\n * CSS `scroll-behavior` property — that is what the spec defines a\n * non-`\"auto\"` behaviour value to mean. Every component that scrolls by\n * script (ScrollReel, Carousel) asks this instead of deciding alone, which\n * is why it lives here and not in either of them.\n */\nexport function smoothScrollBehavior(): \"auto\" | \"smooth\" {\n  try {\n    return window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches ? \"auto\" : \"smooth\";\n  } catch {\n    // matchMedia may be unavailable; smooth is the behaviour being replaced.\n    return \"smooth\";\n  }\n}\n"],"mappings":";AAaA,SAAgB,iBAAiB,GAAmB;CAClD,OAAO,GAAG,OAAO,KAAK,IAAI,GAAA,CAAmB,IAAA,EAAwB,EAAE;AACzE;;;;;;;;;;;;;AAcA,SAAgB,uBAA0C;CACxD,IAAI;EACF,OAAO,OAAO,WAAW,kCAAkC,CAAC,CAAC,UAAU,SAAS;CAClF,QAAQ;EAEN,OAAO;CACT;AACF"}

package/dist/packages/core/src/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,MAAM,EAAE,CAAC,GACR;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAAE,CAM/C"}

package/dist/packages/core/src/props.js

@@ -0,0 +1,37 @@
+//#region packages/core/src/props.ts
+/**
+* Drops the keys whose value is `undefined`, so a `v-bind` passes only the
+* props that were actually set.
+*
+* Two rules collide to make this necessary, and neither is avoidable.
+*
+* Vue treats a prop that is absent and a prop explicitly set to `undefined` as
+* the same thing — both resolve to the child's default. TypeScript, under
+* `exactOptionalPropertyTypes`, does not: passing `undefined` to a `foo?: T` is
+* an error, because the flag exists precisely to tell "missing" apart from
+* "present and undefined". A Vue template always emits every key it binds, so
+* forwarding an optional prop straight through (`:open="open"`) hands a child's
+* `open?: boolean` an explicit `undefined` and fails to compile, while behaving
+* correctly at run time.
+*
+* That distinction is not academic for the components underneath. Reka reads
+* `undefined` as "no value supplied — manage this yourself", and any concrete
+* value, `false` included, as "the host owns this". So a control whose
+* `modelValue` is coerced to `false` on its way through stops being
+* uncontrolled and becomes permanently, silently off: it still emits its update
+* event, and its rendered state never moves. That failure has no error and no
+* warning; it looks like a component that ignores clicks.
+*
+* A cast (`open as boolean`) silences the compiler and is the reason to prefer
+* this: it states that a value is there when the whole point is that one may
+* not be. Omitting the key says what is true.
+*/
+function optional(values) {
+	const set = {};
+	for (const key of Object.keys(values)) if (values[key] !== void 0) set[key] = values[key];
+	return set;
+}
+//#endregion
+export { optional };
+
+//# sourceMappingURL=props.js.map

package/dist/packages/core/src/props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.js","names":[],"sources":["../../../../packages/core/src/props.ts"],"sourcesContent":["/**\n * Drops the keys whose value is `undefined`, so a `v-bind` passes only the\n * props that were actually set.\n *\n * Two rules collide to make this necessary, and neither is avoidable.\n *\n * Vue treats a prop that is absent and a prop explicitly set to `undefined` as\n * the same thing — both resolve to the child's default. TypeScript, under\n * `exactOptionalPropertyTypes`, does not: passing `undefined` to a `foo?: T` is\n * an error, because the flag exists precisely to tell \"missing\" apart from\n * \"present and undefined\". A Vue template always emits every key it binds, so\n * forwarding an optional prop straight through (`:open=\"open\"`) hands a child's\n * `open?: boolean` an explicit `undefined` and fails to compile, while behaving\n * correctly at run time.\n *\n * That distinction is not academic for the components underneath. Reka reads\n * `undefined` as \"no value supplied — manage this yourself\", and any concrete\n * value, `false` included, as \"the host owns this\". So a control whose\n * `modelValue` is coerced to `false` on its way through stops being\n * uncontrolled and becomes permanently, silently off: it still emits its update\n * event, and its rendered state never moves. That failure has no error and no\n * warning; it looks like a component that ignores clicks.\n *\n * A cast (`open as boolean`) silences the compiler and is the reason to prefer\n * this: it states that a value is there when the whole point is that one may\n * not be. Omitting the key says what is true.\n */\nexport function optional<T extends Record<string, unknown>>(\n  values: T,\n): { [K in keyof T]?: Exclude<T[K], undefined> } {\n  const set: Record<string, unknown> = {};\n  for (const key of Object.keys(values)) {\n    if (values[key] !== undefined) set[key] = values[key];\n  }\n  return set as { [K in keyof T]?: Exclude<T[K], undefined> };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,SACd,QAC+C;CAC/C,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAClC,IAAI,OAAO,SAAS,KAAA,GAAW,IAAI,OAAO,OAAO;CAEnD,OAAO;AACT"}

package/dist/packages/core/src/theme.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Theme switching for Loom.
+ *
+ * The single source of truth is the `data-theme` attribute on `<html>`.
+ * This composable reads and writes it, persists the preference to
+ * `localStorage`, and resolves `"system"` mode from the OS preference.
+ *
+ * SSR-safe: every DOM access is guarded. On the server, `theme` returns
+ * the persisted or default preference, `resolvedTheme` resolves `"system"`
+ * to `"light"` (the only safe default without a DOM), and the setter and
+ * toggler are no-ops.
+ *
+ * Flash prevention: `themeScript` is a string of inline JavaScript that
+ * reads `localStorage` and sets `data-theme` before the first paint.
+ * Consumers rendering SSR inject it into `<head>`:
+ *
+ *   <script>${themeScript}</script>
+ */
+import { type Ref } from "vue";
+/** The preference a user expresses — `"system"` defers to the OS. */
+export type ThemePreference = "light" | "dark" | "system";
+/** The actual theme applied — `"system"` is resolved away. */
+export type ResolvedTheme = "light" | "dark";
+/**
+ * Reset the shared state. Intended for test isolation only — a real app
+ * never needs this because the state lives for the app's lifetime.
+ */
+export declare function _resetThemeState(): void;
+/**
+ * Read and control the active Loom theme.
+ *
+ * Call it from a component `setup()` or inside an `effectScope()` — that
+ * scope is what releases the shared state when its last real consumer
+ * unmounts. A call from outside any effect scope still works, but it can
+ * never be released, so it is not counted and development warns once; the
+ * shared state simply lives as long as whatever creates it next counts for.
+ * The DOM-apply and persistence side effects are created once per app in a
+ * detached scope of their own — never once per consumer — and storage is
+ * only written when the stored preference actually changes.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useTheme } from "@ecoma-io/loom/theme"
+ * const { theme, resolvedTheme, setTheme, toggleTheme } = useTheme()
+ * </script>
+ *
+ * <template>
+ *   <button @click="toggleTheme">
+ *     {{ resolvedTheme === "dark" ? "☀️" : "🌙" }}
+ *   </button>
+ * </template>
+ * ```
+ */
+export declare function useTheme(): {
+    readonly theme: Ref<ThemePreference>;
+    readonly resolvedTheme: Readonly<Ref<ResolvedTheme>>;
+    readonly setTheme: (preference: ThemePreference) => void;
+    readonly toggleTheme: () => void;
+};
+/**
+ * Inline script to prevent flash-of-wrong-theme on SSR pages.
+ *
+ * Paste it into `<head>` before any stylesheet links:
+ *
+ * ```html
+ * <script><%= themeScript %></script>
+ * ```
+ *
+ * It reads `localStorage` and sets `data-theme` on `<html>` synchronously,
+ * before the browser paints, so the first frame is already in the right
+ * theme. When no preference is stored, it follows the OS preference.
+ *
+ * The script is deliberately tiny and has no dependencies.
+ */
+export declare const themeScript = "(() => {\n  const t = localStorage.getItem(\"loom:theme\");\n  const d = window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n  document.documentElement.setAttribute(\"data-theme\", (t === \"dark\" || (!t && d)) ? \"dark\" : \"light\");\n})()";
+//# sourceMappingURL=theme.d.ts.map

package/dist/packages/core/src/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,GAAG,EAAsE,MAAM,KAAK,CAAC;AAEnG,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AA8C7C;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CASvC;AAkID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;CAClC,CAwCA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,gQAInB,CAAC"}