@ecoma-io/loom 0.1.0 → 0.2.0

package/dist/blocks/ErrorState/ErrorState.vue.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ErrorState — the shape of "something went wrong": icon → title → optional
+ * description → optional retry action, centered in the error region. This is
+ * EmptyState's mirror: where that block says "nothing here yet" and invites
+ * the next step, this one says "something broke" and offers a retry.
+ *
+ * No staggered entrance. EmptyState is content appearing — a welcome, budgeted
+ * like a panel reveal. An error is not content; it is a problem that needs
+ * attention now, and a fade-rise film that delays the message reads as
+ * indifference. Everything renders at once.
+ *
+ * The icon sits in a hairline medallion — the same shape as EmptyState's, but
+ * tinted `bg-destructive/10` with a `border-destructive/30` ring — because a
+ * bare glyph in a region that already signals alarm has no anchor and the
+ * colour alone does the work that EmptyState's neutral medallion needed
+ * `bg-subtle` for. The icon is decorative and `aria-hidden`; the title already
+ * carries the meaning.
+ *
+ * The action slot is semantically a retry affordance but remains a generic
+ * slot — the host owns the wording and behaviour, and no fallback copy ships
+ * with the component.
+ */
+type __VLS_Props = {
+    /** What went wrong, stated plainly — always shown. */
+    title: string;
+    /** More context about the error. Omit rather than pad the region with filler copy. */
+    description?: string;
+};
+declare var __VLS_1: {}, __VLS_3: {};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_1) => any;
+} & {
+    action?: (props: typeof __VLS_3) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=ErrorState.vue.d.ts.map

package/dist/blocks/ErrorState/ErrorState.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorState.vue.d.ts","sourceRoot":"","sources":["../../../src/blocks/ErrorState/ErrorState.vue"],"names":[],"mappings":"AAsDA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,KAAK,WAAW,GAAG;IACjB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAwEF,QAAA,IAAI,OAAO,IAAU,EAAE,OAAO,IAAW,CAAE;AAC3C,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACzC;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK9C,QAAA,MAAM,UAAU,kSAEd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/blocks/ErrorState/ErrorState.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,60 @@
+import { createCommentVNode, createElementBlock, createElementVNode, defineComponent, openBlock, renderSlot, toDisplayString } from "vue";
+//#region src/blocks/ErrorState/ErrorState.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "flex flex-col items-center justify-center gap-1.5 px-6 py-10 text-center sm:py-14" };
+var _hoisted_2 = {
+	key: 0,
+	"aria-hidden": "true",
+	class: "grid h-12 w-12 place-items-center rounded-full border border-destructive/30 bg-destructive/10 text-destructive [&_svg]:h-5 [&_svg]:w-5"
+};
+var _hoisted_3 = { class: "text-title text-foreground" };
+var _hoisted_4 = {
+	key: 1,
+	class: "max-w-sm text-balance text-small text-muted-foreground"
+};
+var _hoisted_5 = {
+	key: 2,
+	class: "mt-4"
+};
+var ErrorState_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "ErrorState",
+	props: {
+		title: {},
+		description: {}
+	},
+	setup(__props) {
+		/**
+		* ErrorState — the shape of "something went wrong": icon → title → optional
+		* description → optional retry action, centered in the error region. This is
+		* EmptyState's mirror: where that block says "nothing here yet" and invites
+		* the next step, this one says "something broke" and offers a retry.
+		*
+		* No staggered entrance. EmptyState is content appearing — a welcome, budgeted
+		* like a panel reveal. An error is not content; it is a problem that needs
+		* attention now, and a fade-rise film that delays the message reads as
+		* indifference. Everything renders at once.
+		*
+		* The icon sits in a hairline medallion — the same shape as EmptyState's, but
+		* tinted `bg-destructive/10` with a `border-destructive/30` ring — because a
+		* bare glyph in a region that already signals alarm has no anchor and the
+		* colour alone does the work that EmptyState's neutral medallion needed
+		* `bg-subtle` for. The icon is decorative and `aria-hidden`; the title already
+		* carries the meaning.
+		*
+		* The action slot is semantically a retry affordance but remains a generic
+		* slot — the host owns the wording and behaviour, and no fallback copy ships
+		* with the component.
+		*/
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", _hoisted_1, [
+				_ctx.$slots.icon ? (openBlock(), createElementBlock("div", _hoisted_2, [renderSlot(_ctx.$slots, "icon")])) : createCommentVNode("", true),
+				createElementVNode("p", _hoisted_3, toDisplayString(__props.title), 1),
+				__props.description ? (openBlock(), createElementBlock("p", _hoisted_4, toDisplayString(__props.description), 1)) : createCommentVNode("", true),
+				_ctx.$slots.action ? (openBlock(), createElementBlock("div", _hoisted_5, [renderSlot(_ctx.$slots, "action")])) : createCommentVNode("", true)
+			]);
+		};
+	}
+});
+//#endregion
+export { ErrorState_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=ErrorState.vue_vue_type_script_setup_true_lang.js.map

package/dist/blocks/ErrorState/ErrorState.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorState.vue_vue_type_script_setup_true_lang.js","names":["$slots"],"sources":["../../../src/blocks/ErrorState/ErrorState.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/**\n * ErrorState — the shape of \"something went wrong\": icon → title → optional\n * description → optional retry action, centered in the error region. This is\n * EmptyState's mirror: where that block says \"nothing here yet\" and invites\n * the next step, this one says \"something broke\" and offers a retry.\n *\n * No staggered entrance. EmptyState is content appearing — a welcome, budgeted\n * like a panel reveal. An error is not content; it is a problem that needs\n * attention now, and a fade-rise film that delays the message reads as\n * indifference. Everything renders at once.\n *\n * The icon sits in a hairline medallion — the same shape as EmptyState's, but\n * tinted `bg-destructive/10` with a `border-destructive/30` ring — because a\n * bare glyph in a region that already signals alarm has no anchor and the\n * colour alone does the work that EmptyState's neutral medallion needed\n * `bg-subtle` for. The icon is decorative and `aria-hidden`; the title already\n * carries the meaning.\n *\n * The action slot is semantically a retry affordance but remains a generic\n * slot — the host owns the wording and behaviour, and no fallback copy ships\n * with the component.\n */\ndefineProps<{\n  /** What went wrong, stated plainly — always shown. */\n  title: string;\n  /** More context about the error. Omit rather than pad the region with filler copy. */\n  description?: string;\n}>();\n</script>\n\n<template>\n  <div class=\"flex flex-col items-center justify-center gap-1.5 px-6 py-10 text-center sm:py-14\">\n    <div\n      v-if=\"$slots.icon\"\n      aria-hidden=\"true\"\n      class=\"grid h-12 w-12 place-items-center rounded-full border border-destructive/30 bg-destructive/10 text-destructive [&_svg]:h-5 [&_svg]:w-5\"\n    >\n      <slot name=\"icon\" />\n    </div>\n    <p class=\"text-title text-foreground\">\n      {{ title }}\n    </p>\n    <p v-if=\"description\" class=\"max-w-sm text-balance text-small text-muted-foreground\">\n      {{ description }}\n    </p>\n    <div v-if=\"$slots.action\" class=\"mt-4\">\n      <slot name=\"action\" />\n    </div>\n  </div>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCE,OAAA,UAAA,GAAA,mBAiBM,OAjBN,YAiBM;IAfIA,KAAAA,OAAO,QADf,UAAA,GAAA,mBAMM,OANN,YAMM,CADJ,WAAoB,KAAA,QAAA,MAAA,CAAA,CAAA,KAAA,mBAAA,IAAA,IAAA;IAEtB,mBAEI,KAFJ,YAEI,gBADC,QAAA,KAAK,GAAA,CAAA;IAED,QAAA,eAAT,UAAA,GAAA,mBAEI,KAFJ,YAEI,gBADC,QAAA,WAAW,GAAA,CAAA,KAAA,mBAAA,IAAA,IAAA;IAELA,KAAAA,OAAO,UAAlB,UAAA,GAAA,mBAEM,OAFN,YAEM,CADJ,WAAsB,KAAA,QAAA,QAAA,CAAA,CAAA,KAAA,mBAAA,IAAA,IAAA"}

package/dist/blocks/FormActions/FormActions.js

@@ -0,0 +1,7 @@
+import FormActions_vue_vue_type_script_setup_true_lang_default from "./FormActions.vue_vue_type_script_setup_true_lang.js";
+//#region src/blocks/FormActions/FormActions.vue
+var FormActions_default = FormActions_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { FormActions_default as default };
+
+//# sourceMappingURL=FormActions.js.map

package/dist/blocks/FormActions/FormActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormActions.js","names":[],"sources":["../../../src/blocks/FormActions/FormActions.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * FormActions — the submit/cancel button row at the bottom of a form. A block\n * that owns the layout of form actions so every form in the product has the\n * same action alignment: primary action right, cancel left, separated from the\n * form content by a top border.\n *\n * The block exists because \"submit right, cancel left\" is a layout decision\n * repeated in every form, and getting the spacing and alignment wrong is easy.\n * It owns the geometry; the host owns the button text and behavior.\n *\n * The default slot carries the primary actions (submit, save) and the `cancel`\n * slot carries the secondary action. In \"between\" mode the two slots sit at\n * opposite ends; in \"right\" or \"left\" mode everything goes through the default\n * slot, shifted to one side.\n */\nexport type FormActionsAlign = \"right\" | \"left\" | \"between\";\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"../../lib/cn\";\n\nwithDefaults(\n  defineProps<{\n    /**\n     * How the action row distributes its content.\n     * - \"between\": cancel slot left, primary actions right (default — the\n     *   arrangement most forms need)\n     * - \"right\": all actions pushed right (short forms, single CTA)\n     * - \"left\": all actions pushed left (right-to-left locales, or a design\n     *   that calls for it)\n     */\n    align?: FormActionsAlign;\n  }>(),\n  { align: \"between\" },\n);\n\nconst justify: Record<FormActionsAlign, string> = {\n  between: \"justify-between\",\n  right: \"justify-end\",\n  left: \"justify-start\",\n};\n</script>\n\n<template>\n  <!-- border-t separates the actions from the form content above without\n       needing a wrapping section or extra spacing rules -->\n  <div :class=\"cn('flex items-center gap-3 border-t border-border pt-6', justify[align])\">\n    <!-- @slot The secondary/cancel action — placed on the left in \"between\" mode. -->\n    <slot name=\"cancel\" />\n    <!-- @slot The primary actions (submit, save) — placed on the right in \"between\" mode. -->\n    <slot />\n  </div>\n</template>\n"],"mappings":""}

package/dist/blocks/FormActions/FormActions.vue.d.ts

@@ -0,0 +1,51 @@
+/**
+ * FormActions — the submit/cancel button row at the bottom of a form. A block
+ * that owns the layout of form actions so every form in the product has the
+ * same action alignment: primary action right, cancel left, separated from the
+ * form content by a top border.
+ *
+ * The block exists because "submit right, cancel left" is a layout decision
+ * repeated in every form, and getting the spacing and alignment wrong is easy.
+ * It owns the geometry; the host owns the button text and behavior.
+ *
+ * The default slot carries the primary actions (submit, save) and the `cancel`
+ * slot carries the secondary action. In "between" mode the two slots sit at
+ * opposite ends; in "right" or "left" mode everything goes through the default
+ * slot, shifted to one side.
+ */
+export type FormActionsAlign = "right" | "left" | "between";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    /**
+     * How the action row distributes its content.
+     * - "between": cancel slot left, primary actions right (default — the
+     *   arrangement most forms need)
+     * - "right": all actions pushed right (short forms, single CTA)
+     * - "left": all actions pushed left (right-to-left locales, or a design
+     *   that calls for it)
+     */
+    align?: FormActionsAlign;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    /**
+     * How the action row distributes its content.
+     * - "between": cancel slot left, primary actions right (default — the
+     *   arrangement most forms need)
+     * - "right": all actions pushed right (short forms, single CTA)
+     * - "left": all actions pushed left (right-to-left locales, or a design
+     *   that calls for it)
+     */
+    align?: FormActionsAlign;
+}> & Readonly<{}>, {
+    align: FormActionsAlign;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    cancel?: (props: {}) => any;
+} & {
+    default?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=FormActions.vue.d.ts.map

package/dist/blocks/FormActions/FormActions.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormActions.vue.d.ts","sourceRoot":"","sources":["../../../src/blocks/FormActions/FormActions.vue"],"names":[],"mappings":"AA4DA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;wBACvC,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAEd;;;;;;;OAOG;YACK,gBAAgB;;IARxB;;;;;;;OAOG;YACK,gBAAgB;;WAAhB,gBAAgB;;aA0Cf,CAAC,KAAK,IAAgB,KAAK,GAAG;;cAC7B,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/blocks/FormActions/FormActions.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,21 @@
+import { cn } from "../../lib/cn.js";
+import { createElementBlock, defineComponent, normalizeClass, openBlock, renderSlot, unref } from "vue";
+//#region src/blocks/FormActions/FormActions.vue?vue&type=script&setup=true&lang.ts
+var FormActions_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "FormActions",
+	props: { align: { default: "between" } },
+	setup(__props) {
+		const justify = {
+			between: "justify-between",
+			right: "justify-end",
+			left: "justify-start"
+		};
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cn)("flex items-center gap-3 border-t border-border pt-6", justify[__props.align])) }, [renderSlot(_ctx.$slots, "cancel"), renderSlot(_ctx.$slots, "default")], 2);
+		};
+	}
+});
+//#endregion
+export { FormActions_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=FormActions.vue_vue_type_script_setup_true_lang.js.map

package/dist/blocks/FormActions/FormActions.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormActions.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../src/blocks/FormActions/FormActions.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * FormActions — the submit/cancel button row at the bottom of a form. A block\n * that owns the layout of form actions so every form in the product has the\n * same action alignment: primary action right, cancel left, separated from the\n * form content by a top border.\n *\n * The block exists because \"submit right, cancel left\" is a layout decision\n * repeated in every form, and getting the spacing and alignment wrong is easy.\n * It owns the geometry; the host owns the button text and behavior.\n *\n * The default slot carries the primary actions (submit, save) and the `cancel`\n * slot carries the secondary action. In \"between\" mode the two slots sit at\n * opposite ends; in \"right\" or \"left\" mode everything goes through the default\n * slot, shifted to one side.\n */\nexport type FormActionsAlign = \"right\" | \"left\" | \"between\";\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"../../lib/cn\";\n\nwithDefaults(\n  defineProps<{\n    /**\n     * How the action row distributes its content.\n     * - \"between\": cancel slot left, primary actions right (default — the\n     *   arrangement most forms need)\n     * - \"right\": all actions pushed right (short forms, single CTA)\n     * - \"left\": all actions pushed left (right-to-left locales, or a design\n     *   that calls for it)\n     */\n    align?: FormActionsAlign;\n  }>(),\n  { align: \"between\" },\n);\n\nconst justify: Record<FormActionsAlign, string> = {\n  between: \"justify-between\",\n  right: \"justify-end\",\n  left: \"justify-start\",\n};\n</script>\n\n<template>\n  <!-- border-t separates the actions from the form content above without\n       needing a wrapping section or extra spacing rules -->\n  <div :class=\"cn('flex items-center gap-3 border-t border-border pt-6', justify[align])\">\n    <!-- @slot The secondary/cancel action — placed on the left in \"between\" mode. -->\n    <slot name=\"cancel\" />\n    <!-- @slot The primary actions (submit, save) — placed on the right in \"between\" mode. -->\n    <slot />\n  </div>\n</template>\n"],"mappings":";;;;;;;EAqCA,MAAM,UAA4C;GAChD,SAAS;GACT,OAAO;GACP,MAAM;EACR;;GAME,OAAA,UAAA,GAAA,mBAKM,OAAA,EALA,OAAK,eAAE,MAAA,EAAA,CAAE,CAAA,uDAAwD,QAAQ,QAAA,MAAK,CAAA,EAAA,GAAA,CAElF,WAAsB,KAAA,QAAA,QAAA,GAEtB,WAAQ,KAAA,QAAA,SAAA,CAAA,GAAA,CAAA"}

package/dist/blocks/FormSection/FormSection.js

@@ -0,0 +1,7 @@
+import FormSection_vue_vue_type_script_setup_true_lang_default, { gapClass } from "./FormSection.vue_vue_type_script_setup_true_lang.js";
+//#region src/blocks/FormSection/FormSection.vue
+var FormSection_default = FormSection_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { FormSection_default as default, gapClass };
+
+//# sourceMappingURL=FormSection.js.map

package/dist/blocks/FormSection/FormSection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSection.js","names":[],"sources":["../../../src/blocks/FormSection/FormSection.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * FormSection — a labeled group of form fields with an optional\n * description, the arrangement every form page reaches for repeatedly: a\n * Fieldset (for the accessible `<fieldset>/<legend>` semantics, disabled/\n * readonly propagation, and hint/error line) with vertical Stack spacing\n * between the fields.\n *\n * The block exists because that composition is written at every form page\n * and the spacing between sections is a layout decision it can own once.\n * It is a thin convenience over Fieldset, not a replacement: when a group\n * needs a shape FormSection does not offer, Fieldset is still the right\n * primitive.\n *\n * `description` is NOT Fieldset's `hint`. The description sits between the\n * legend and the fields — it orients the person filling the form (\"Where\n * should we ship your order?\"). The hint sits below the fields and\n * supplements the controls themselves (\"Street address, P.O. box, or\n * military address\"). They serve different readers at different points in\n * the form and both can be present at once.\n */\nexport type FormSectionGap = \"sm\" | \"md\" | \"lg\";\n\nconst gapClass: Record<FormSectionGap, 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 Fieldset from \"../../primitives/Fieldset/Fieldset.vue\";\nimport { cn } from \"../../lib/cn\";\nimport { optional } from \"../../lib/props\";\n\nwithDefaults(\n  defineProps<{\n    /** The section title — rendered as a real `<legend>` by Fieldset. */\n    legend?: string;\n    /**\n     * Supporting text shown below the legend, above the fields.\n     * NOT the same as `hint`, which sits below the fields — this orients the\n     * person filling the form, while `hint` supplements the controls.\n     */\n    description?: string;\n    /** Forwarded to Fieldset: supporting text shown below the group. Hidden while `error` is set. */\n    hint?: string;\n    /** Forwarded to Fieldset: the group's error message. Replaces `hint`. */\n    error?: string;\n    /** Forwarded to Fieldset: marks the group mandatory and appends a destructive asterisk. */\n    required?: boolean;\n    /** Forwarded to Fieldset: disables every control inside, slotted ones included. */\n    disabled?: boolean;\n    /** Forwarded to Fieldset: renders every Loom control inside read-only. */\n    readonly?: boolean | undefined;\n    /** Forwarded to Fieldset: set on the `<fieldset>`, used to derive the hint/error id. */\n    id?: string;\n    /** Gap between fields — mirrors Stack's gap scale. */\n    gap?: FormSectionGap;\n  }>(),\n  {\n    required: false,\n    disabled: false,\n    // Explicitly `undefined`, not `false`: matches Fieldset's own default so\n    // an absent prop does not overrule a Field or control that set it.\n    readonly: undefined,\n    gap: \"md\",\n  },\n);\n</script>\n\n<template>\n  <Fieldset\n    v-bind=\"optional({ legend, hint, error, id })\"\n    :required=\"required\"\n    :disabled=\"disabled\"\n    :readonly=\"readonly\"\n  >\n    <p v-if=\"description\" class=\"max-w-prose text-small text-muted-foreground\">\n      {{ description }}\n    </p>\n    <div :class=\"cn('flex flex-col', gapClass[gap])\">\n      <!-- @slot The form fields in the section. -->\n      <slot />\n    </div>\n  </Fieldset>\n</template>\n"],"mappings":""}

package/dist/blocks/FormSection/FormSection.vue.d.ts

@@ -0,0 +1,85 @@
+/**
+ * FormSection — a labeled group of form fields with an optional
+ * description, the arrangement every form page reaches for repeatedly: a
+ * Fieldset (for the accessible `<fieldset>/<legend>` semantics, disabled/
+ * readonly propagation, and hint/error line) with vertical Stack spacing
+ * between the fields.
+ *
+ * The block exists because that composition is written at every form page
+ * and the spacing between sections is a layout decision it can own once.
+ * It is a thin convenience over Fieldset, not a replacement: when a group
+ * needs a shape FormSection does not offer, Fieldset is still the right
+ * primitive.
+ *
+ * `description` is NOT Fieldset's `hint`. The description sits between the
+ * legend and the fields — it orients the person filling the form ("Where
+ * should we ship your order?"). The hint sits below the fields and
+ * supplements the controls themselves ("Street address, P.O. box, or
+ * military address"). They serve different readers at different points in
+ * the form and both can be present at once.
+ */
+export type FormSectionGap = "sm" | "md" | "lg";
+declare const gapClass: Record<FormSectionGap, string>;
+export { gapClass };
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    /** The section title — rendered as a real `<legend>` by Fieldset. */
+    legend?: string;
+    /**
+     * Supporting text shown below the legend, above the fields.
+     * NOT the same as `hint`, which sits below the fields — this orients the
+     * person filling the form, while `hint` supplements the controls.
+     */
+    description?: string;
+    /** Forwarded to Fieldset: supporting text shown below the group. Hidden while `error` is set. */
+    hint?: string;
+    /** Forwarded to Fieldset: the group's error message. Replaces `hint`. */
+    error?: string;
+    /** Forwarded to Fieldset: marks the group mandatory and appends a destructive asterisk. */
+    required?: boolean;
+    /** Forwarded to Fieldset: disables every control inside, slotted ones included. */
+    disabled?: boolean;
+    /** Forwarded to Fieldset: renders every Loom control inside read-only. */
+    readonly?: boolean | undefined;
+    /** Forwarded to Fieldset: set on the `<fieldset>`, used to derive the hint/error id. */
+    id?: string;
+    /** Gap between fields — mirrors Stack's gap scale. */
+    gap?: FormSectionGap;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    /** The section title — rendered as a real `<legend>` by Fieldset. */
+    legend?: string;
+    /**
+     * Supporting text shown below the legend, above the fields.
+     * NOT the same as `hint`, which sits below the fields — this orients the
+     * person filling the form, while `hint` supplements the controls.
+     */
+    description?: string;
+    /** Forwarded to Fieldset: supporting text shown below the group. Hidden while `error` is set. */
+    hint?: string;
+    /** Forwarded to Fieldset: the group's error message. Replaces `hint`. */
+    error?: string;
+    /** Forwarded to Fieldset: marks the group mandatory and appends a destructive asterisk. */
+    required?: boolean;
+    /** Forwarded to Fieldset: disables every control inside, slotted ones included. */
+    disabled?: boolean;
+    /** Forwarded to Fieldset: renders every Loom control inside read-only. */
+    readonly?: boolean | undefined;
+    /** Forwarded to Fieldset: set on the `<fieldset>`, used to derive the hint/error id. */
+    id?: string;
+    /** Gap between fields — mirrors Stack's gap scale. */
+    gap?: FormSectionGap;
+}> & Readonly<{}>, {
+    gap: FormSectionGap;
+    disabled: boolean;
+    readonly: boolean | undefined;
+    required: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=FormSection.vue.d.ts.map

package/dist/blocks/FormSection/FormSection.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSection.vue.d.ts","sourceRoot":"","sources":["../../../src/blocks/FormSection/FormSection.vue"],"names":[],"mappings":"AAiGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAInC,CAAC;AAEX,OAAO,EAAE,QAAQ,EAAE,CAAC;wBACC,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAEd,qEAAqE;aAC5D,MAAM;IACf;;;;OAIG;kBACW,MAAM;IACpB,iGAAiG;WAC1F,MAAM;IACb,yEAAyE;YACjE,MAAM;IACd,2FAA2F;eAChF,OAAO;IAClB,mFAAmF;eACxE,OAAO;IAClB,0EAA0E;eAC/D,OAAO,GAAG,SAAS;IAC9B,wFAAwF;SACnF,MAAM;IACX,sDAAsD;UAChD,cAAc;;IArBpB,qEAAqE;aAC5D,MAAM;IACf;;;;OAIG;kBACW,MAAM;IACpB,iGAAiG;WAC1F,MAAM;IACb,yEAAyE;YACjE,MAAM;IACd,2FAA2F;eAChF,OAAO;IAClB,mFAAmF;eACxE,OAAO;IAClB,0EAA0E;eAC/D,OAAO,GAAG,SAAS;IAC9B,wFAAwF;SACnF,MAAM;IACX,sDAAsD;UAChD,cAAc;;SAAd,cAAc;cANT,OAAO;cAEP,OAAO,GAAG,SAAS;cAJnB,OAAO;;cAqFR,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/blocks/FormSection/FormSection.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,62 @@
+import { cn } from "../../lib/cn.js";
+import { optional } from "../../lib/props.js";
+import Fieldset_default from "../../primitives/Fieldset/Fieldset.js";
+import { createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeProps, normalizeClass, openBlock, renderSlot, toDisplayString, unref, withCtx } from "vue";
+//#region src/blocks/FormSection/FormSection.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = {
+	key: 0,
+	class: "max-w-prose text-small text-muted-foreground"
+};
+var gapClass = {
+	sm: "gap-2 sm:gap-3",
+	md: "gap-3 sm:gap-4",
+	lg: "gap-4 sm:gap-6"
+};
+var FormSection_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "FormSection",
+	props: {
+		legend: {},
+		description: {},
+		hint: {},
+		error: {},
+		required: {
+			type: Boolean,
+			default: false
+		},
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		readonly: {
+			type: Boolean,
+			default: void 0
+		},
+		id: {},
+		gap: { default: "md" }
+	},
+	setup(__props) {
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(Fieldset_default, mergeProps(unref(optional)({
+				legend: __props.legend,
+				hint: __props.hint,
+				error: __props.error,
+				id: __props.id
+			}), {
+				required: __props.required,
+				disabled: __props.disabled,
+				readonly: __props.readonly
+			}), {
+				default: withCtx(() => [__props.description ? (openBlock(), createElementBlock("p", _hoisted_1, toDisplayString(__props.description), 1)) : createCommentVNode("", true), createElementVNode("div", { class: normalizeClass(unref(cn)("flex flex-col", gapClass[__props.gap])) }, [renderSlot(_ctx.$slots, "default")], 2)]),
+				_: 3
+			}, 16, [
+				"required",
+				"disabled",
+				"readonly"
+			]);
+		};
+	}
+});
+//#endregion
+export { FormSection_vue_vue_type_script_setup_true_lang_default as default, gapClass };
+
+//# sourceMappingURL=FormSection.vue_vue_type_script_setup_true_lang.js.map

package/dist/blocks/FormSection/FormSection.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSection.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../src/blocks/FormSection/FormSection.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * FormSection — a labeled group of form fields with an optional\n * description, the arrangement every form page reaches for repeatedly: a\n * Fieldset (for the accessible `<fieldset>/<legend>` semantics, disabled/\n * readonly propagation, and hint/error line) with vertical Stack spacing\n * between the fields.\n *\n * The block exists because that composition is written at every form page\n * and the spacing between sections is a layout decision it can own once.\n * It is a thin convenience over Fieldset, not a replacement: when a group\n * needs a shape FormSection does not offer, Fieldset is still the right\n * primitive.\n *\n * `description` is NOT Fieldset's `hint`. The description sits between the\n * legend and the fields — it orients the person filling the form (\"Where\n * should we ship your order?\"). The hint sits below the fields and\n * supplements the controls themselves (\"Street address, P.O. box, or\n * military address\"). They serve different readers at different points in\n * the form and both can be present at once.\n */\nexport type FormSectionGap = \"sm\" | \"md\" | \"lg\";\n\nconst gapClass: Record<FormSectionGap, 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 Fieldset from \"../../primitives/Fieldset/Fieldset.vue\";\nimport { cn } from \"../../lib/cn\";\nimport { optional } from \"../../lib/props\";\n\nwithDefaults(\n  defineProps<{\n    /** The section title — rendered as a real `<legend>` by Fieldset. */\n    legend?: string;\n    /**\n     * Supporting text shown below the legend, above the fields.\n     * NOT the same as `hint`, which sits below the fields — this orients the\n     * person filling the form, while `hint` supplements the controls.\n     */\n    description?: string;\n    /** Forwarded to Fieldset: supporting text shown below the group. Hidden while `error` is set. */\n    hint?: string;\n    /** Forwarded to Fieldset: the group's error message. Replaces `hint`. */\n    error?: string;\n    /** Forwarded to Fieldset: marks the group mandatory and appends a destructive asterisk. */\n    required?: boolean;\n    /** Forwarded to Fieldset: disables every control inside, slotted ones included. */\n    disabled?: boolean;\n    /** Forwarded to Fieldset: renders every Loom control inside read-only. */\n    readonly?: boolean | undefined;\n    /** Forwarded to Fieldset: set on the `<fieldset>`, used to derive the hint/error id. */\n    id?: string;\n    /** Gap between fields — mirrors Stack's gap scale. */\n    gap?: FormSectionGap;\n  }>(),\n  {\n    required: false,\n    disabled: false,\n    // Explicitly `undefined`, not `false`: matches Fieldset's own default so\n    // an absent prop does not overrule a Field or control that set it.\n    readonly: undefined,\n    gap: \"md\",\n  },\n);\n</script>\n\n<template>\n  <Fieldset\n    v-bind=\"optional({ legend, hint, error, id })\"\n    :required=\"required\"\n    :disabled=\"disabled\"\n    :readonly=\"readonly\"\n  >\n    <p v-if=\"description\" class=\"max-w-prose text-small text-muted-foreground\">\n      {{ description }}\n    </p>\n    <div :class=\"cn('flex flex-col', gapClass[gap])\">\n      <!-- @slot The form fields in the section. -->\n      <slot />\n    </div>\n  </Fieldset>\n</template>\n"],"mappings":";;;;;;;;;AAuBA,IAAM,WAA2C;CAC/C,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;;;;;;;;;;;;;;;;;;;;;;;;GA+CE,OAAA,UAAA,GAAA,YAaW,kBAbX,WACU,MAYC,QAAA,CAZO,CAAA;IAAA,QAAG,QAAA;IAAM,MAAE,QAAA;IAAI,OAAE,QAAA;IAAK,IAAE,QAAA;GAAE,CAAA,GAAA;IACzC,UAAU,QAAA;IACV,UAAU,QAAA;IACV,UAAU,QAAA;;IAEX,SAAA,cAEI,CAFK,QAAA,eAAT,UAAA,GAAA,mBAEI,KAFJ,YAEI,gBADC,QAAA,WAAW,GAAA,CAAA,KAAA,mBAAA,IAAA,IAAA,GAEhB,mBAGM,OAAA,EAHA,OAAK,eAAE,MAAA,EAAA,CAAE,CAAA,iBAAkB,SAAS,QAAA,IAAG,CAAA,EAAA,GAAA,CAE3C,WAAQ,KAAA,QAAA,SAAA,CAAA,GAAA,CAAA,CAAA,CAAA"}

package/dist/blocks/LoadingState/LoadingState.js

@@ -0,0 +1,7 @@
+import LoadingState_vue_vue_type_script_setup_true_lang_default from "./LoadingState.vue_vue_type_script_setup_true_lang.js";
+//#region src/blocks/LoadingState/LoadingState.vue
+var LoadingState_default = LoadingState_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { LoadingState_default as default };
+
+//# sourceMappingURL=LoadingState.js.map

package/dist/blocks/LoadingState/LoadingState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingState.js","names":[],"sources":["../../../src/blocks/LoadingState/LoadingState.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/**\n * LoadingState — the shape of \"not yet known\": a Spinner for short waits or a\n * column of skeleton lines for content-shaped waits. This replaces the \"flash\n * of EmptyState\" antipattern — never show EmptyState before the real result is\n * known, because an empty state that flickers and disappears is a short-lived\n * lie.\n *\n * Two modes controlled by `mode`:\n * - `spinner` (default): centred Spinner with an optional label. Good for\n *   indeterminate waits where the host does not know the content shape.\n * - `skeleton`: a column of skeleton lines that approximate the content the\n *   host is loading. The default lines are three bars of varying width — enough\n *   to suggest paragraph-shaped content without the host having to compose\n *   anything. Hosts that know their own shape provide a default slot and render\n *   whatever Skeleton arrangement matches their real layout.\n *\n * The Spinner carries its own accessible label (`aria-label` on the primitive)\n * so this block does not add a redundant one. The skeleton lines are purely\n * decorative (`aria-hidden` on each Skeleton) — the host's real content will\n * replace them.\n */\nimport Spinner from \"../../primitives/Spinner/Spinner.vue\";\nimport Skeleton from \"../../primitives/Skeleton/Skeleton.vue\";\n\nwithDefaults(\n  defineProps<{\n    /** Shown below the spinner in spinner mode. Omit for a spinner-only wait. */\n    label?: string;\n    /** `spinner` for short indeterminate waits; `skeleton` for content-shaped waits. */\n    mode?: \"spinner\" | \"skeleton\";\n  }>(),\n  { mode: \"spinner\" },\n);\n</script>\n\n<template>\n  <div\n    v-if=\"mode === 'spinner'\"\n    class=\"flex flex-col items-center justify-center gap-3 px-6 py-10 sm:py-14\"\n  >\n    <Spinner size=\"lg\" />\n    <p v-if=\"label\" class=\"text-small text-muted-foreground\">{{ label }}</p>\n  </div>\n  <div v-else class=\"flex flex-col gap-3 px-6 py-10 sm:py-14\">\n    <slot>\n      <!-- Default skeleton lines approximate paragraph-shaped content without\n           requiring the host to compose anything. Hosts that know their own\n           shape slot their own Skeleton arrangement instead. -->\n      <Skeleton class=\"h-4 w-full\" />\n      <Skeleton class=\"h-4 w-3/4\" />\n      <Skeleton class=\"h-4 w-5/6\" />\n    </slot>\n  </div>\n</template>\n"],"mappings":""}

package/dist/blocks/LoadingState/LoadingState.vue.d.ts

@@ -0,0 +1,22 @@
+type __VLS_Props = {
+    /** Shown below the spinner in spinner mode. Omit for a spinner-only wait. */
+    label?: string;
+    /** `spinner` for short indeterminate waits; `skeleton` for content-shaped waits. */
+    mode?: "spinner" | "skeleton";
+};
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    mode: "spinner" | "skeleton";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=LoadingState.vue.d.ts.map

package/dist/blocks/LoadingState/LoadingState.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingState.vue.d.ts","sourceRoot":"","sources":["../../../src/blocks/LoadingState/LoadingState.vue"],"names":[],"mappings":"AAkFA,KAAK,WAAW,GAAG;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CAC/B,CAAC;AA6FJ,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;UArGL,SAAS,GAAG,UAAU;6EAwG/B,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/blocks/LoadingState/LoadingState.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,57 @@
+import Skeleton_default from "../../primitives/Skeleton/Skeleton.js";
+import Spinner_default from "../../primitives/Spinner/Spinner.js";
+import { createCommentVNode, createElementBlock, createVNode, defineComponent, openBlock, renderSlot, toDisplayString } from "vue";
+//#region src/blocks/LoadingState/LoadingState.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = {
+	key: 0,
+	class: "flex flex-col items-center justify-center gap-3 px-6 py-10 sm:py-14"
+};
+var _hoisted_2 = {
+	key: 0,
+	class: "text-small text-muted-foreground"
+};
+var _hoisted_3 = {
+	key: 1,
+	class: "flex flex-col gap-3 px-6 py-10 sm:py-14"
+};
+var LoadingState_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "LoadingState",
+	props: {
+		label: {},
+		mode: { default: "spinner" }
+	},
+	setup(__props) {
+		/**
+		* LoadingState — the shape of "not yet known": a Spinner for short waits or a
+		* column of skeleton lines for content-shaped waits. This replaces the "flash
+		* of EmptyState" antipattern — never show EmptyState before the real result is
+		* known, because an empty state that flickers and disappears is a short-lived
+		* lie.
+		*
+		* Two modes controlled by `mode`:
+		* - `spinner` (default): centred Spinner with an optional label. Good for
+		*   indeterminate waits where the host does not know the content shape.
+		* - `skeleton`: a column of skeleton lines that approximate the content the
+		*   host is loading. The default lines are three bars of varying width — enough
+		*   to suggest paragraph-shaped content without the host having to compose
+		*   anything. Hosts that know their own shape provide a default slot and render
+		*   whatever Skeleton arrangement matches their real layout.
+		*
+		* The Spinner carries its own accessible label (`aria-label` on the primitive)
+		* so this block does not add a redundant one. The skeleton lines are purely
+		* decorative (`aria-hidden` on each Skeleton) — the host's real content will
+		* replace them.
+		*/
+		return (_ctx, _cache) => {
+			return __props.mode === "spinner" ? (openBlock(), createElementBlock("div", _hoisted_1, [createVNode(Spinner_default, { size: "lg" }), __props.label ? (openBlock(), createElementBlock("p", _hoisted_2, toDisplayString(__props.label), 1)) : createCommentVNode("", true)])) : (openBlock(), createElementBlock("div", _hoisted_3, [renderSlot(_ctx.$slots, "default", {}, () => [
+				createVNode(Skeleton_default, { class: "h-4 w-full" }),
+				createVNode(Skeleton_default, { class: "h-4 w-3/4" }),
+				createVNode(Skeleton_default, { class: "h-4 w-5/6" })
+			])]));
+		};
+	}
+});
+//#endregion
+export { LoadingState_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=LoadingState.vue_vue_type_script_setup_true_lang.js.map

package/dist/blocks/LoadingState/LoadingState.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingState.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../src/blocks/LoadingState/LoadingState.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/**\n * LoadingState — the shape of \"not yet known\": a Spinner for short waits or a\n * column of skeleton lines for content-shaped waits. This replaces the \"flash\n * of EmptyState\" antipattern — never show EmptyState before the real result is\n * known, because an empty state that flickers and disappears is a short-lived\n * lie.\n *\n * Two modes controlled by `mode`:\n * - `spinner` (default): centred Spinner with an optional label. Good for\n *   indeterminate waits where the host does not know the content shape.\n * - `skeleton`: a column of skeleton lines that approximate the content the\n *   host is loading. The default lines are three bars of varying width — enough\n *   to suggest paragraph-shaped content without the host having to compose\n *   anything. Hosts that know their own shape provide a default slot and render\n *   whatever Skeleton arrangement matches their real layout.\n *\n * The Spinner carries its own accessible label (`aria-label` on the primitive)\n * so this block does not add a redundant one. The skeleton lines are purely\n * decorative (`aria-hidden` on each Skeleton) — the host's real content will\n * replace them.\n */\nimport Spinner from \"../../primitives/Spinner/Spinner.vue\";\nimport Skeleton from \"../../primitives/Skeleton/Skeleton.vue\";\n\nwithDefaults(\n  defineProps<{\n    /** Shown below the spinner in spinner mode. Omit for a spinner-only wait. */\n    label?: string;\n    /** `spinner` for short indeterminate waits; `skeleton` for content-shaped waits. */\n    mode?: \"spinner\" | \"skeleton\";\n  }>(),\n  { mode: \"spinner\" },\n);\n</script>\n\n<template>\n  <div\n    v-if=\"mode === 'spinner'\"\n    class=\"flex flex-col items-center justify-center gap-3 px-6 py-10 sm:py-14\"\n  >\n    <Spinner size=\"lg\" />\n    <p v-if=\"label\" class=\"text-small text-muted-foreground\">{{ label }}</p>\n  </div>\n  <div v-else class=\"flex flex-col gap-3 px-6 py-10 sm:py-14\">\n    <slot>\n      <!-- Default skeleton lines approximate paragraph-shaped content without\n           requiring the host to compose anything. Hosts that know their own\n           shape slot their own Skeleton arrangement instead. -->\n      <Skeleton class=\"h-4 w-full\" />\n      <Skeleton class=\"h-4 w-3/4\" />\n      <Skeleton class=\"h-4 w-5/6\" />\n    </slot>\n  </div>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCU,OAAA,QAAA,SAAI,aADZ,UAAA,GAAA,mBAMM,OANN,YAMM,CAFJ,YAAqB,iBAAA,EAAZ,MAAK,KAAI,CAAA,GACT,QAAA,SAAT,UAAA,GAAA,mBAAwE,KAAxE,YAAwE,gBAAZ,QAAA,KAAK,GAAA,CAAA,KAAA,mBAAA,IAAA,IAAA,CAAA,CAAA,MAEnE,UAAA,GAAA,mBASM,OATN,YASM,CARJ,WAOO,KAAA,QAAA,WAAA,CAAA,SAAA;IAHL,YAA+B,kBAAA,EAArB,OAAM,aAAY,CAAA;IAC5B,YAA8B,kBAAA,EAApB,OAAM,YAAW,CAAA;IAC3B,YAA8B,kBAAA,EAApB,OAAM,YAAW,CAAA"}

package/dist/blocks/MetricCard/MetricCard.js

@@ -0,0 +1,7 @@
+import MetricCard_vue_vue_type_script_setup_true_lang_default from "./MetricCard.vue_vue_type_script_setup_true_lang.js";
+//#region src/blocks/MetricCard/MetricCard.vue
+var MetricCard_default = MetricCard_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { MetricCard_default as default };
+
+//# sourceMappingURL=MetricCard.js.map

package/dist/blocks/MetricCard/MetricCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricCard.js","names":[],"sources":["../../../src/blocks/MetricCard/MetricCard.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * MetricCard — one KPI on a dashboard: a compact surface carrying a metric\n * value, its label, and an optional trend arrow. The shape is fixed (icon →\n * label → value + trend) because a hand-rolled metric row drifts from call\n * site to call site — the icon above the label here, the trend on a second\n * line there — and this block pins one layout so the row scans left-to-right.\n *\n * The trend is always inline with the value, never a separate line. A trend\n * on its own row reads as a second metric; sharing the value line reads as\n * context for that metric, which is what it is. The arrows are inline SVGs\n * (12px) rather than an icon-library dependency: a trend indicator is a\n * single directional glyph, and pulling in an icon package for three paths\n * is weight the host did not ask for.\n *\n * Colour encodes direction but is never the only signal: the arrow shape\n * distinguishes up from down even without hue, and \"flat\" is an em dash\n * rather than a horizontal arrow that could be mistaken for a minus sign or\n * a separator. `text-success` / `text-destructive` / `text-muted-foreground`\n * are the semantic tokens rather than fixed greens and reds, so the card\n * adapts to whatever the theme maps those to.\n */\nexport type MetricCardTrend = \"up\" | \"down\" | \"flat\";\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"../../lib/cn\";\n\ndefineProps<{\n  /** The metric value — a formatted string or number the host has already\n   *  localised (e.g. \"1,234\", \"98.5%\", \"$42k\"). Raw numbers are not\n   *  formatted by the card; the host owns formatting so the same value\n   *  can be \"$42k\" in one place and \"42,000\" in another. */\n  value: string | number;\n  /** What the metric measures — always shown. */\n  label: string;\n  /** Direction of change. When absent, no trend indicator is rendered. */\n  trend?: MetricCardTrend;\n  /** The trend magnitude (e.g. \"+12.5%\", \"-3.2%\"). Shown only when `trend`\n   *  is also provided; a magnitude with no direction has no meaning. */\n  trendValue?: string;\n}>();\n</script>\n\n<template>\n  <div :class=\"cn('rounded-lg border border-border bg-card p-4')\">\n    <!-- Decorative icon — hidden from assistive tech because the label and\n         value already carry the metric's meaning. -->\n    <div\n      v-if=\"$slots.icon\"\n      aria-hidden=\"true\"\n      class=\"mb-2 text-muted-foreground [&_svg]:h-4 [&_svg]:w-4\"\n    >\n      <slot name=\"icon\" />\n    </div>\n    <p class=\"text-small text-muted-foreground\">{{ label }}</p>\n    <div class=\"flex items-baseline gap-1.5\">\n      <span class=\"text-2xl font-semibold tracking-tight text-foreground\">\n        {{ value }}\n      </span>\n      <span\n        v-if=\"trend\"\n        :class=\"\n          cn('inline-flex items-center gap-0.5 text-small font-medium', {\n            'text-success': trend === 'up',\n            'text-destructive': trend === 'down',\n            'text-muted-foreground': trend === 'flat',\n          })\n        \"\n      >\n        <!-- Up arrow: a single upward stroke with a chevron head. -->\n        <svg\n          v-if=\"trend === 'up'\"\n          class=\"inline h-3 w-3\"\n          viewBox=\"0 0 12 12\"\n          fill=\"none\"\n          stroke=\"currentColor\"\n          stroke-width=\"2\"\n          aria-hidden=\"true\"\n        >\n          <path d=\"M6 2v8M3 5l3-3 3 3\" />\n        </svg>\n        <!-- Down arrow: a single downward stroke with a chevron head. -->\n        <svg\n          v-else-if=\"trend === 'down'\"\n          class=\"inline h-3 w-3\"\n          viewBox=\"0 0 12 12\"\n          fill=\"none\"\n          stroke=\"currentColor\"\n          stroke-width=\"2\"\n          aria-hidden=\"true\"\n        >\n          <path d=\"M6 10V2M3 7l3 3 3-3\" />\n        </svg>\n        <!-- Flat: an em dash rather than a horizontal arrow — a horizontal\n             arrow at this size reads as a minus sign or a separator. -->\n        <span v-else aria-hidden=\"true\">&mdash;</span>\n        <span v-if=\"trendValue\">{{ trendValue }}</span>\n      </span>\n    </div>\n  </div>\n</template>\n"],"mappings":""}

package/dist/blocks/MetricCard/MetricCard.vue.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MetricCard — one KPI on a dashboard: a compact surface carrying a metric
+ * value, its label, and an optional trend arrow. The shape is fixed (icon →
+ * label → value + trend) because a hand-rolled metric row drifts from call
+ * site to call site — the icon above the label here, the trend on a second
+ * line there — and this block pins one layout so the row scans left-to-right.
+ *
+ * The trend is always inline with the value, never a separate line. A trend
+ * on its own row reads as a second metric; sharing the value line reads as
+ * context for that metric, which is what it is. The arrows are inline SVGs
+ * (12px) rather than an icon-library dependency: a trend indicator is a
+ * single directional glyph, and pulling in an icon package for three paths
+ * is weight the host did not ask for.
+ *
+ * Colour encodes direction but is never the only signal: the arrow shape
+ * distinguishes up from down even without hue, and "flat" is an em dash
+ * rather than a horizontal arrow that could be mistaken for a minus sign or
+ * a separator. `text-success` / `text-destructive` / `text-muted-foreground`
+ * are the semantic tokens rather than fixed greens and reds, so the card
+ * adapts to whatever the theme maps those to.
+ */
+export type MetricCardTrend = "up" | "down" | "flat";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    /** The metric value — a formatted string or number the host has already
+     *  localised (e.g. "1,234", "98.5%", "$42k"). Raw numbers are not
+     *  formatted by the card; the host owns formatting so the same value
+     *  can be "$42k" in one place and "42,000" in another. */
+    value: string | number;
+    /** What the metric measures — always shown. */
+    label: string;
+    /** Direction of change. When absent, no trend indicator is rendered. */
+    trend?: MetricCardTrend;
+    /** The trend magnitude (e.g. "+12.5%", "-3.2%"). Shown only when `trend`
+     *  is also provided; a magnitude with no direction has no meaning. */
+    trendValue?: string;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    /** The metric value — a formatted string or number the host has already
+     *  localised (e.g. "1,234", "98.5%", "$42k"). Raw numbers are not
+     *  formatted by the card; the host owns formatting so the same value
+     *  can be "$42k" in one place and "42,000" in another. */
+    value: string | number;
+    /** What the metric measures — always shown. */
+    label: string;
+    /** Direction of change. When absent, no trend indicator is rendered. */
+    trend?: MetricCardTrend;
+    /** The trend magnitude (e.g. "+12.5%", "-3.2%"). Shown only when `trend`
+     *  is also provided; a magnitude with no direction has no meaning. */
+    trendValue?: string;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    icon?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=MetricCard.vue.d.ts.map

package/dist/blocks/MetricCard/MetricCard.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricCard.vue.d.ts","sourceRoot":"","sources":["../../../src/blocks/MetricCard/MetricCard.vue"],"names":[],"mappings":"AA4GA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;wBAChC,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAEhB;;;8DAG0D;WACnD,MAAM,GAAG,MAAM;IACtB,+CAA+C;WACxC,MAAM;IACb,wEAAwE;YAChE,eAAe;IACvB;0EACsE;iBACzD,MAAM;;IAXnB;;;8DAG0D;WACnD,MAAM,GAAG,MAAM;IACtB,+CAA+C;WACxC,MAAM;IACb,wEAAwE;YAChE,eAAe;IACvB;0EACsE;iBACzD,MAAM;;WAgHV,CAAC,KAAK,IAAgB,KAAK,GAAG;EASrC,CAAC;AACL,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}