@wow-two-beta/ui-vue 0.0.5 → 0.0.6

package/dist/chunks/FieldHelperText.vue_vue_type_script_setup_true_lang-YYE7Zysp.js

@@ -0,0 +1,497 @@
+import { defineComponent, useAttrs, useTemplateRef, computed, openBlock, createElementBlock, mergeProps, renderSlot, getCurrentInstance, createVNode, unref, createCommentVNode } from "vue";
+import { c as cn } from "./Cn-CzDCF-Ah.js";
+import { X } from "lucide-vue-next";
+import { tv } from "tailwind-variants";
+import { _ as _sfc_main$6 } from "./Icon.vue_vue_type_script_setup_true_lang-BVWSqaoe.js";
+import { Temporal } from "temporal-polyfill";
+import { S as Size } from "./StyleTokens-Bkz7Dm5L.js";
+import { u as useFormControl, a as useFormControlChrome } from "./FormControlContext-B71MFW26.js";
+const _sfc_main$5 = /* @__PURE__ */ defineComponent({
+  ...{ name: "KbdText", inheritAttrs: false },
+  __name: "KbdText",
+  setup(__props, { expose: __expose }) {
+    const attrs = useAttrs();
+    const el = useTemplateRef("el");
+    const classes = computed(
+      () => cn(
+        "inline-flex h-5 min-w-5 items-center justify-center rounded-sm border border-border",
+        "bg-muted px-1.5 font-mono text-xs text-muted-foreground shadow-[inset_0_-1px_0_0_rgb(0_0_0/0.05)]",
+        attrs.class
+      )
+    );
+    const rest = computed(() => {
+      const { class: _class, ...others } = attrs;
+      return others;
+    });
+    __expose({ el });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("kbd", mergeProps({
+        ref_key: "el",
+        ref: el
+      }, rest.value, { class: classes.value }), [
+        renderSlot(_ctx.$slots, "default")
+      ], 16);
+    };
+  }
+});
+const TagVariant = {
+  /** Refers to the neutral bordered chip. */
+  Neutral: "neutral",
+  /** Refers to the primary brand tint. */
+  Brand: "brand",
+  /** Refers to the positive / confirmation tint. */
+  Success: "success",
+  /** Refers to the caution tint. */
+  Warning: "warning",
+  /** Refers to the destructive / error tint. */
+  Danger: "danger",
+  /** Refers to the informational tint. */
+  Info: "info"
+};
+const tagVariants = tv({
+  base: "inline-flex items-center gap-1 rounded-md border border-border bg-card px-2 py-0.5 text-xs font-medium text-card-foreground",
+  variants: {
+    variant: {
+      neutral: "",
+      brand: "border-transparent bg-primary-soft text-primary-soft-foreground",
+      success: "border-transparent bg-success-soft text-success-soft-foreground",
+      warning: "border-transparent bg-warning-soft text-warning-soft-foreground",
+      danger: "border-transparent bg-destructive-soft text-destructive-soft-foreground",
+      info: "border-transparent bg-info-soft text-info-soft-foreground"
+    }
+  },
+  defaultVariants: {
+    variant: "neutral"
+  }
+});
+const _hoisted_1$3 = ["aria-label"];
+const _sfc_main$4 = /* @__PURE__ */ defineComponent({
+  ...{ name: "Tag", inheritAttrs: false },
+  __name: "Tag",
+  props: {
+    variant: {},
+    closeLabel: { default: "Remove" }
+  },
+  emits: ["close"],
+  setup(__props, { expose: __expose, emit: __emit }) {
+    const CloseIcon = X;
+    const props = __props;
+    const emit = __emit;
+    const attrs = useAttrs();
+    const instance = getCurrentInstance();
+    const el = useTemplateRef("el");
+    const hasClose = () => Boolean(instance?.vnode.props?.onClose);
+    const classes = computed(() => cn(tagVariants({ variant: props.variant }), attrs.class));
+    const rest = computed(() => {
+      const { class: _class, ...others } = attrs;
+      return others;
+    });
+    __expose({ el });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("span", mergeProps({
+        ref_key: "el",
+        ref: el
+      }, rest.value, { class: classes.value }), [
+        renderSlot(_ctx.$slots, "default"),
+        hasClose() ? (openBlock(), createElementBlock("button", {
+          key: 0,
+          type: "button",
+          "aria-label": props.closeLabel,
+          class: "-mr-1 inline-flex h-4 w-4 items-center justify-center rounded-sm text-muted-foreground hover:bg-muted hover:text-foreground focus-visible:outline-hidden focus-visible:ring-1 focus-visible:ring-ring",
+          onClick: _cache[0] || (_cache[0] = ($event) => emit("close"))
+        }, [
+          createVNode(unref(_sfc_main$6), {
+            icon: unref(CloseIcon),
+            size: 12
+          }, null, 8, ["icon"])
+        ], 8, _hoisted_1$3)) : createCommentVNode("", true)
+      ], 16);
+    };
+  }
+});
+const WeekdayLabelsShort = ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"];
+const MonthLabelsLong = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+function sundayIndex(d) {
+  return d.dayOfWeek % 7;
+}
+function today() {
+  return Temporal.Now.plainDateISO();
+}
+function isSameDay(a, b) {
+  if (!a || !b) return false;
+  return a.equals(b);
+}
+function isToday(d) {
+  return d.equals(today());
+}
+function addMonths(d, n) {
+  return d.add({ months: n });
+}
+function addDays(d, n) {
+  return d.add({ days: n });
+}
+function startOfMonth(d) {
+  return d.with({ day: 1 });
+}
+function daysInMonth(year, month) {
+  return Temporal.PlainDate.from({ year, month, day: 1 }).daysInMonth;
+}
+function buildMonthGrid(year, month) {
+  const first = Temporal.PlainDate.from({ year, month, day: 1 });
+  const start = first.subtract({ days: sundayIndex(first) });
+  const cells = [];
+  for (let i = 0; i < 42; i++) {
+    const date = start.add({ days: i });
+    cells.push({ date, outOfMonth: date.month !== month });
+  }
+  return cells;
+}
+function formatISODate(d) {
+  if (!d) return "";
+  return d.toString();
+}
+function parseISODate(s) {
+  if (!s) return null;
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(s)) return null;
+  try {
+    return Temporal.PlainDate.from(s, { overflow: "reject" });
+  } catch {
+    return null;
+  }
+}
+function formatISOTime(t) {
+  if (!t) return "";
+  return t.toString({ smallestUnit: "minute" });
+}
+function formatISODateTime(dt) {
+  if (!dt) return "";
+  return dt.toString({ smallestUnit: "minute" });
+}
+function parseISODateTime(s) {
+  if (!s) return null;
+  if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?$/.test(s)) return null;
+  try {
+    return Temporal.PlainDateTime.from(s, { overflow: "reject" });
+  } catch {
+    return null;
+  }
+}
+function isDateDisabled(d, options) {
+  const { min, max, isDisabled } = options;
+  if (min && Temporal.PlainDate.compare(d, min) < 0) return true;
+  if (max && Temporal.PlainDate.compare(d, max) > 0) return true;
+  if (isDisabled?.(d)) return true;
+  return false;
+}
+function isInRange(d, start, end) {
+  if (!start || !end) return false;
+  const lo = Temporal.PlainDate.compare(start, end) <= 0 ? start : end;
+  const hi = Temporal.PlainDate.compare(start, end) <= 0 ? end : start;
+  return Temporal.PlainDate.compare(d, lo) >= 0 && Temporal.PlainDate.compare(d, hi) <= 0;
+}
+function daysBetween(a, b) {
+  return a.until(b, { largestUnit: "day" }).days;
+}
+function isWeekend(d) {
+  return d.dayOfWeek === 6 || d.dayOfWeek === 7;
+}
+function nowZoned() {
+  return Temporal.Now.zonedDateTimeISO();
+}
+function isZonedOnDay(z, day) {
+  return z.toPlainDate().equals(day);
+}
+function zonedAtHour(day, hour, timeZone) {
+  return day.toZonedDateTime({
+    timeZone,
+    plainTime: new Temporal.PlainTime(hour)
+  });
+}
+function minutesBetween(a, b) {
+  return a.until(b, { largestUnit: "minute", smallestUnit: "minute" }).minutes;
+}
+function maxZoned(a, b) {
+  return Temporal.ZonedDateTime.compare(a, b) >= 0 ? a : b;
+}
+function minZoned(a, b) {
+  return Temporal.ZonedDateTime.compare(a, b) <= 0 ? a : b;
+}
+function isZonedDayInRange(z, start, end) {
+  return isInRange(z.toPlainDate(), start.toPlainDate(), end.toPlainDate());
+}
+function formatZonedTime(z) {
+  return z.toLocaleString(void 0, { hour: "2-digit", minute: "2-digit" });
+}
+const _sfc_main$3 = /* @__PURE__ */ defineComponent({
+  ...{ name: "LegendText", inheritAttrs: false },
+  __name: "LegendText",
+  setup(__props, { expose: __expose }) {
+    const attrs = useAttrs();
+    const OwnedAttributes = /* @__PURE__ */ new Set(["class"]);
+    const passthroughAttrs = computed(
+      () => Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key)))
+    );
+    const rootClass = computed(() => cn("mb-2 text-sm font-medium text-foreground", attrs.class));
+    const root = useTemplateRef("root");
+    __expose({ el: root });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("legend", mergeProps({
+        ref_key: "root",
+        ref: root,
+        class: rootClass.value
+      }, passthroughAttrs.value), [
+        renderSlot(_ctx.$slots, "default")
+      ], 16);
+    };
+  }
+});
+const _hoisted_1$2 = ["for", "id"];
+const _hoisted_2 = {
+  key: 0,
+  class: "ml-0.5 text-destructive",
+  "aria-hidden": "true"
+};
+const SizeClass = {
+  xs: "text-xs",
+  sm: "text-sm",
+  md: "text-sm"
+};
+const _sfc_main$2 = /* @__PURE__ */ defineComponent({
+  ...{ name: "LabelText", inheritAttrs: false },
+  __name: "LabelText",
+  props: {
+    isRequired: { type: Boolean, default: void 0 },
+    size: { default: Size.Md },
+    htmlFor: {},
+    for: {},
+    id: {}
+  },
+  setup(__props, { expose: __expose }) {
+    const props = __props;
+    const attrs = useAttrs();
+    const ctx = useFormControl();
+    useFormControlChrome("label", () => props.id == null);
+    const isRequired = computed(() => props.isRequired ?? ctx?.isRequired ?? false);
+    const labelFor = computed(() => props.for ?? props.htmlFor ?? ctx?.id);
+    const labelId = computed(() => props.id ?? ctx?.labelId);
+    const OwnedAttributes = /* @__PURE__ */ new Set(["class"]);
+    const passthroughAttrs = computed(
+      () => Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key)))
+    );
+    const rootClass = computed(
+      () => cn(
+        SizeClass[props.size] ?? SizeClass.md,
+        "font-medium text-foreground",
+        ctx?.isDisabled && "opacity-60",
+        attrs.class
+      )
+    );
+    const root = useTemplateRef("root");
+    __expose({ el: root });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("label", mergeProps({
+        ref_key: "root",
+        ref: root,
+        for: labelFor.value,
+        id: labelId.value,
+        class: rootClass.value
+      }, passthroughAttrs.value), [
+        renderSlot(_ctx.$slots, "default"),
+        isRequired.value ? (openBlock(), createElementBlock("span", _hoisted_2, "*")) : createCommentVNode("", true)
+      ], 16, _hoisted_1$2);
+    };
+  }
+});
+const SwatchShape = {
+  /** Refers to a rounded-square swatch. */
+  Square: "square",
+  /** Refers to a circular swatch. */
+  Circle: "circle"
+};
+const ColorSwatchPreviewSize = {
+  /** Refers to the extra-small step (h-4). */
+  Xs: "xs",
+  /** Refers to the small step (h-5). */
+  Sm: "sm",
+  /** Refers to the medium (default) step (h-6). */
+  Md: "md",
+  /** Refers to the large step (h-9). */
+  Lg: "lg"
+};
+const colorSwatchVariants = tv({
+  base: "inline-block shrink-0 border border-border bg-[image:linear-gradient(45deg,_#ddd_25%,_transparent_25%),_linear-gradient(-45deg,_#ddd_25%,_transparent_25%),_linear-gradient(45deg,_transparent_75%,_#ddd_75%),_linear-gradient(-45deg,_transparent_75%,_#ddd_75%)] bg-[length:8px_8px] bg-[position:0_0,_0_4px,_4px_-4px,_-4px_0px]",
+  variants: {
+    size: {
+      xs: "h-4 w-4",
+      sm: "h-5 w-5",
+      md: "h-6 w-6",
+      lg: "h-9 w-9"
+    },
+    shape: {
+      square: "rounded-sm",
+      circle: "rounded-full"
+    },
+    interactive: {
+      true: "cursor-pointer transition-shadow focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1 hover:shadow-sm",
+      false: ""
+    },
+    isSelected: {
+      true: "ring-2 ring-ring ring-offset-1",
+      false: ""
+    },
+    isDisabled: {
+      true: "cursor-not-allowed opacity-50",
+      false: ""
+    }
+  },
+  defaultVariants: {
+    size: "md",
+    shape: "square",
+    interactive: false,
+    isSelected: false,
+    isDisabled: false
+  }
+});
+const _hoisted_1$1 = ["disabled"];
+const _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  ...{ name: "ColorSwatchPreview", inheritAttrs: false },
+  __name: "ColorSwatchPreview",
+  props: {
+    color: { default: "#000000" },
+    size: {},
+    shape: {},
+    isSelected: { type: Boolean, default: void 0 },
+    isDisabled: { type: Boolean, default: void 0 }
+  },
+  setup(__props, { expose: __expose }) {
+    const props = __props;
+    const attrs = useAttrs();
+    const isInteractive = computed(() => Boolean(attrs.onClick));
+    const OwnedAttributes = /* @__PURE__ */ new Set(["class", "style"]);
+    const passthroughAttrs = computed(
+      () => Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key)))
+    );
+    const rootClass = computed(
+      () => cn(
+        colorSwatchVariants({
+          size: props.size,
+          shape: props.shape,
+          interactive: isInteractive.value,
+          isSelected: props.isSelected,
+          isDisabled: props.isDisabled
+        }),
+        attrs.class
+      )
+    );
+    const rootStyle = computed(() => [
+      attrs.style,
+      { boxShadow: `inset 0 0 0 100px ${props.color}` }
+    ]);
+    const root = useTemplateRef("root");
+    __expose({ el: root });
+    return (_ctx, _cache) => {
+      return isInteractive.value ? (openBlock(), createElementBlock("button", mergeProps({
+        key: 0,
+        ref_key: "root",
+        ref: root,
+        type: "button",
+        disabled: __props.isDisabled,
+        class: rootClass.value,
+        style: rootStyle.value
+      }, passthroughAttrs.value), null, 16, _hoisted_1$1)) : (openBlock(), createElementBlock("div", mergeProps({
+        key: 1,
+        ref_key: "root",
+        ref: root,
+        class: rootClass.value,
+        style: rootStyle.value
+      }, passthroughAttrs.value), null, 16));
+    };
+  }
+});
+const _hoisted_1 = ["id"];
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "FieldHelperText", inheritAttrs: false },
+  __name: "FieldHelperText",
+  props: {
+    id: {}
+  },
+  setup(__props, { expose: __expose }) {
+    const props = __props;
+    const attrs = useAttrs();
+    const ctx = useFormControl();
+    useFormControlChrome("helper", () => props.id == null);
+    const helperId = computed(() => props.id ?? ctx?.helperId);
+    const OwnedAttributes = /* @__PURE__ */ new Set(["class"]);
+    const passthroughAttrs = computed(
+      () => Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key)))
+    );
+    const rootClass = computed(() => cn("text-sm text-muted-foreground", attrs.class));
+    const root = useTemplateRef("root");
+    __expose({ el: root });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("p", mergeProps({
+        ref_key: "root",
+        ref: root,
+        id: helperId.value,
+        class: rootClass.value
+      }, passthroughAttrs.value), [
+        renderSlot(_ctx.$slots, "default")
+      ], 16, _hoisted_1);
+    };
+  }
+});
+export {
+  formatISODate as A,
+  parseISODate as B,
+  ColorSwatchPreviewSize as C,
+  formatISODateTime as D,
+  parseISODateTime as E,
+  formatISOTime as F,
+  isInRange as G,
+  daysInMonth as H,
+  MonthLabelsLong as M,
+  SwatchShape as S,
+  TagVariant as T,
+  WeekdayLabelsShort as W,
+  _sfc_main$1 as _,
+  _sfc_main as a,
+  _sfc_main$5 as b,
+  _sfc_main$2 as c,
+  _sfc_main$3 as d,
+  _sfc_main$4 as e,
+  colorSwatchVariants as f,
+  formatZonedTime as g,
+  today as h,
+  daysBetween as i,
+  isWeekend as j,
+  addDays as k,
+  isZonedDayInRange as l,
+  minutesBetween as m,
+  nowZoned as n,
+  isToday as o,
+  isZonedOnDay as p,
+  maxZoned as q,
+  minZoned as r,
+  buildMonthGrid as s,
+  tagVariants as t,
+  addMonths as u,
+  isSameDay as v,
+  sundayIndex as w,
+  startOfMonth as x,
+  isDateDisabled as y,
+  zonedAtHour as z
+};
+//# sourceMappingURL=FieldHelperText.vue_vue_type_script_setup_true_lang-YYE7Zysp.js.map

package/dist/chunks/FieldHelperText.vue_vue_type_script_setup_true_lang-YYE7Zysp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldHelperText.vue_vue_type_script_setup_true_lang-YYE7Zysp.js","sources":["../../src/presentation/display/kbdText/KbdText.vue","../../src/presentation/display/tag/Tag.variants.ts","../../src/presentation/display/tag/Tag.vue","../../src/presentation/forms/DateExtensions.ts","../../src/presentation/display/legendText/LegendText.vue","../../src/presentation/display/labelText/LabelText.vue","../../src/presentation/display/colorSwatchPreview/ColorSwatchPreview.variants.ts","../../src/presentation/display/colorSwatchPreview/ColorSwatchPreview.vue","../../src/presentation/display/fieldHelperText/FieldHelperText.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { HTMLAttributes } from 'vue';\n\nexport type KbdTextProps = HTMLAttributes;\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, useAttrs, useTemplateRef } from 'vue';\nimport { cn } from '../../../foundation/styles';\n\n/**\n * Renders one keyboard key as a `<kbd>` with a subtle border and inset shadow.\n *\n * One key per `KbdText`; chain via `<KbdText>⌘</KbdText> + <KbdText>K</KbdText>`.\n */\ndefineOptions({ name: 'KbdText', inheritAttrs: false });\n\n/** The key glyph — React's `children`. */\ndefineSlots<{ default(): unknown }>();\n\nconst attrs = useAttrs();\nconst el = useTemplateRef<HTMLElement>('el');\n\nconst classes = computed(() =>\n  cn(\n    'inline-flex h-5 min-w-5 items-center justify-center rounded-sm border border-border',\n    'bg-muted px-1.5 font-mono text-xs text-muted-foreground shadow-[inset_0_-1px_0_0_rgb(0_0_0/0.05)]',\n    attrs.class as string | undefined,\n  ),\n);\n\n/** Everything but `class`, which is re-applied through `cn` above. */\nconst rest = computed(() => {\n  const { class: _class, ...others } = attrs;\n  return others;\n});\n\ndefineExpose({ el });\n</script>\n\n<template>\n  <kbd ref=\"el\" v-bind=\"rest\" :class=\"classes\"><slot /></kbd>\n</template>\n","import { tv, type VariantProps } from '../../../foundation/styles';\n\n/** Defines the Tag color treatment. */\nexport const TagVariant = {\n  /** Refers to the neutral bordered chip. */\n  Neutral: 'neutral',\n  /** Refers to the primary brand tint. */\n  Brand: 'brand',\n  /** Refers to the positive / confirmation tint. */\n  Success: 'success',\n  /** Refers to the caution tint. */\n  Warning: 'warning',\n  /** Refers to the destructive / error tint. */\n  Danger: 'danger',\n  /** Refers to the informational tint. */\n  Info: 'info',\n} as const;\n\nexport type TagVariant = (typeof TagVariant)[keyof typeof TagVariant];\n\nexport const tagVariants = tv({\n  base: 'inline-flex items-center gap-1 rounded-md border border-border bg-card px-2 py-0.5 text-xs font-medium text-card-foreground',\n  variants: {\n    variant: {\n      neutral: '',\n      brand: 'border-transparent bg-primary-soft text-primary-soft-foreground',\n      success: 'border-transparent bg-success-soft text-success-soft-foreground',\n      warning: 'border-transparent bg-warning-soft text-warning-soft-foreground',\n      danger: 'border-transparent bg-destructive-soft text-destructive-soft-foreground',\n      info: 'border-transparent bg-info-soft text-info-soft-foreground',\n    },\n  },\n  defaultVariants: {\n    variant: 'neutral',\n  },\n});\n\nexport type TagVariants = VariantProps<typeof tagVariants>;\n\n/* Compile-time lock: enum values ≡ tv variant value-set (drift = type error). */\ntype AssertExact<A, B> = [A] extends [B] ? ([B] extends [A] ? true : never) : never;\nconst _assertTagVariant: AssertExact<TagVariant, NonNullable<VariantProps<typeof tagVariants>['variant']>> = true;\nvoid _assertTagVariant;\n","<script lang=\"ts\">\nimport type { TagVariant } from './Tag.variants';\n\nexport interface TagProps {\n  /** The color treatment. */\n  readonly variant?: TagVariant;\n\n  /** The accessible label for the close button. Default `\"Remove\"`. */\n  readonly closeLabel?: string;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, getCurrentInstance, useAttrs, useTemplateRef } from 'vue';\nimport { X } from 'lucide-vue-next';\nimport { cn } from '../../../foundation/styles';\nimport { Icon } from '../../../foundation/icons';\nimport { tagVariants } from './Tag.variants';\n\nconst CloseIcon = X;\n\n/**\n * Renders a pill with an optional close button, shown only when the consumer binds `@close`.\n *\n * The close button is a raw `<button>` to keep the strict atom rule — `Tag` is L3, so importing `Button` would make\n * this an atom-on-atom composition.\n */\ndefineOptions({ name: 'Tag', inheritAttrs: false });\n\n/** The tag copy — React's optional `children`. */\ndefineSlots<{ default?(): unknown }>();\n\nconst props = withDefaults(defineProps<TagProps>(), { closeLabel: 'Remove' });\n\n/** Replaces React's `onClose`; omitting `@close` omits the close button. */\nconst emit = defineEmits<{\n  /** Fires when the close (×) button is clicked. */\n  close: [];\n}>();\n\nconst attrs = useAttrs();\nconst instance = getCurrentInstance();\nconst el = useTemplateRef<HTMLSpanElement>('el');\n\n/**\n * Mirrors React's `onClose && <button/>` guard — the close button renders only\n * when the consumer bound `@close`. Read through a call, not a cached computed:\n * `instance.vnode` is replaced on every re-render.\n */\nconst hasClose = () => Boolean(instance?.vnode.props?.onClose);\n\nconst classes = computed(() => cn(tagVariants({ variant: props.variant }), attrs.class as string | undefined));\n\n/** Everything but `class`, which is re-applied through `cn` above. */\nconst rest = computed(() => {\n  const { class: _class, ...others } = attrs;\n  return others;\n});\n\ndefineExpose({ el });\n</script>\n\n<template>\n  <span ref=\"el\" v-bind=\"rest\" :class=\"classes\">\n    <slot />\n    <button\n      v-if=\"hasClose()\"\n      type=\"button\"\n      :aria-label=\"props.closeLabel\"\n      class=\"-mr-1 inline-flex h-4 w-4 items-center justify-center rounded-sm text-muted-foreground hover:bg-muted hover:text-foreground focus-visible:outline-hidden focus-visible:ring-1 focus-visible:ring-ring\"\n      @click=\"emit('close')\"\n    >\n      <Icon :icon=\"CloseIcon\" :size=\"12\" />\n    </button>\n  </span>\n</template>\n","// Shared date helpers for CalendarPicker / DatePicker / DateInput / RangeCalendarPicker.\n// Co-located in `forms/` so imports stay within-domain.\n//\n// Temporal-based — the ecosystem standardizes on the Temporal API (dates =\n// `Temporal.*`). `Temporal.PlainDate` carries calendar math (no timezone), so\n// these helpers are inherently local/wall-clock, which is what calendar UIs want.\n// `Temporal.PlainTime` carries hour/minute for the time components.\n\nimport { Temporal } from 'temporal-polyfill';\n\nexport const WeekdayLabelsShort = ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'];\nexport const MonthLabelsLong = [\n  'January',\n  'February',\n  'March',\n  'April',\n  'May',\n  'June',\n  'July',\n  'August',\n  'September',\n  'October',\n  'November',\n  'December',\n];\n\n/** Sunday-anchored column index (0 = Sun … 6 = Sat) for a PlainDate. */\nexport function sundayIndex(d: Temporal.PlainDate): number {\n  // Temporal `dayOfWeek` is 1 (Mon) … 7 (Sun); map Sunday to 0 for our Su-first grid.\n  return d.dayOfWeek % 7;\n}\n\n/** Today as a PlainDate in the local time zone. */\nexport function today(): Temporal.PlainDate {\n  return Temporal.Now.plainDateISO();\n}\n\nexport function isSameDay(a: Temporal.PlainDate | null | undefined, b: Temporal.PlainDate | null | undefined): boolean {\n  if (!a || !b) return false;\n  return a.equals(b);\n}\n\nexport function isToday(d: Temporal.PlainDate): boolean {\n  return d.equals(today());\n}\n\n/** Add `n` months; Temporal clamps to the target month's last day (Jan 31 +1 → Feb 28). */\nexport function addMonths(d: Temporal.PlainDate, n: number): Temporal.PlainDate {\n  return d.add({ months: n });\n}\n\nexport function addDays(d: Temporal.PlainDate, n: number): Temporal.PlainDate {\n  return d.add({ days: n });\n}\n\n/** First day of `d`'s month. */\nexport function startOfMonth(d: Temporal.PlainDate): Temporal.PlainDate {\n  return d.with({ day: 1 });\n}\n\n/** Number of days in the given year/month (1-indexed month). */\nexport function daysInMonth(year: number, month: number): number {\n  return Temporal.PlainDate.from({ year, month, day: 1 }).daysInMonth;\n}\n\n/**\n * Build the 6-week (42-cell) grid that the calendar UI renders.\n * `year`/`month` are 1-indexed (Temporal convention). Cells outside the target\n * month carry `outOfMonth: true`.\n */\nexport function buildMonthGrid(\n  year: number,\n  month: number,\n): ReadonlyArray<{ date: Temporal.PlainDate; outOfMonth: boolean }> {\n  const first = Temporal.PlainDate.from({ year, month, day: 1 });\n  const start = first.subtract({ days: sundayIndex(first) });\n  const cells: { date: Temporal.PlainDate; outOfMonth: boolean }[] = [];\n  for (let i = 0; i < 42; i++) {\n    const date = start.add({ days: i });\n    cells.push({ date, outOfMonth: date.month !== month });\n  }\n  return cells;\n}\n\n/** Format PlainDate → \"YYYY-MM-DD\" for a native `<input type=\"date\">` value. */\nexport function formatISODate(d: Temporal.PlainDate | null | undefined): string {\n  if (!d) return '';\n  return d.toString();\n}\n\n/** Parse \"YYYY-MM-DD\" → PlainDate. Returns null for invalid input. */\nexport function parseISODate(s: string | null | undefined): Temporal.PlainDate | null {\n  if (!s) return null;\n  if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(s)) return null;\n  try {\n    return Temporal.PlainDate.from(s, { overflow: 'reject' });\n  } catch {\n    return null;\n  }\n}\n\n/** Format PlainTime → \"HH:MM\" for a native `<input type=\"time\">` value. */\nexport function formatISOTime(t: Temporal.PlainTime | null | undefined): string {\n  if (!t) return '';\n  return t.toString({ smallestUnit: 'minute' });\n}\n\n/** Parse \"HH:MM\" → PlainTime. Returns null for invalid input. */\nexport function parseISOTime(s: string | null | undefined): Temporal.PlainTime | null {\n  if (!s) return null;\n  if (!/^\\d{2}:\\d{2}$/.test(s)) return null;\n  try {\n    return Temporal.PlainTime.from(s, { overflow: 'reject' });\n  } catch {\n    return null;\n  }\n}\n\n/** Format PlainDateTime → \"YYYY-MM-DDTHH:MM\" for a native `<input type=\"datetime-local\">` value. */\nexport function formatISODateTime(dt: Temporal.PlainDateTime | null | undefined): string {\n  if (!dt) return '';\n  return dt.toString({ smallestUnit: 'minute' });\n}\n\n/** Parse \"YYYY-MM-DDTHH:MM\" (seconds optional) → PlainDateTime. Returns null for invalid input. */\nexport function parseISODateTime(s: string | null | undefined): Temporal.PlainDateTime | null {\n  if (!s) return null;\n  if (!/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$/.test(s)) return null;\n  try {\n    return Temporal.PlainDateTime.from(s, { overflow: 'reject' });\n  } catch {\n    return null;\n  }\n}\n\nexport function clampDate(\n  d: Temporal.PlainDate,\n  min?: Temporal.PlainDate | null,\n  max?: Temporal.PlainDate | null,\n): Temporal.PlainDate {\n  if (min && Temporal.PlainDate.compare(d, min) < 0) return min;\n  if (max && Temporal.PlainDate.compare(d, max) > 0) return max;\n  return d;\n}\n\nexport function isDateDisabled(\n  d: Temporal.PlainDate,\n  options: {\n    min?: Temporal.PlainDate | null;\n    max?: Temporal.PlainDate | null;\n    isDisabled?: (d: Temporal.PlainDate) => boolean;\n  },\n): boolean {\n  const { min, max, isDisabled } = options;\n  if (min && Temporal.PlainDate.compare(d, min) < 0) return true;\n  if (max && Temporal.PlainDate.compare(d, max) > 0) return true;\n  if (isDisabled?.(d)) return true;\n  return false;\n}\n\nexport function isInRange(\n  d: Temporal.PlainDate,\n  start: Temporal.PlainDate | null | undefined,\n  end: Temporal.PlainDate | null | undefined,\n): boolean {\n  if (!start || !end) return false;\n  const lo = Temporal.PlainDate.compare(start, end) <= 0 ? start : end;\n  const hi = Temporal.PlainDate.compare(start, end) <= 0 ? end : start;\n  return Temporal.PlainDate.compare(d, lo) >= 0 && Temporal.PlainDate.compare(d, hi) <= 0;\n}\n\n/** Signed whole-day count from `a` to `b` (positive when `b` is later). */\nexport function daysBetween(a: Temporal.PlainDate, b: Temporal.PlainDate): number {\n  return a.until(b, { largestUnit: 'day' }).days;\n}\n\n/** True when `d` falls on a Saturday or Sunday. */\nexport function isWeekend(d: Temporal.PlainDate): boolean {\n  // Temporal `dayOfWeek`: 1 (Mon) … 7 (Sun); 6 = Sat, 7 = Sun.\n  return d.dayOfWeek === 6 || d.dayOfWeek === 7;\n}\n\n// ── Datetime helpers (ZonedDateTime) ──────────────────────────────────────\n// EventCalendarViewer / ScheduleView model absolute instants (a wall-clock time in a\n// specific zone) — the `Temporal.ZonedDateTime` peer of .NET `DateTimeOffset`.\n// The grid + navigation still project down to `Temporal.PlainDate` (via the\n// helpers above); these cover the intra-day time-slot math the grid needs.\n\n/** Now as a ZonedDateTime in the local (system) time zone. */\nexport function nowZoned(): Temporal.ZonedDateTime {\n  return Temporal.Now.zonedDateTimeISO();\n}\n\n/** The calendar day a ZonedDateTime falls on (its wall-clock PlainDate). */\nexport function zonedToPlainDate(z: Temporal.ZonedDateTime): Temporal.PlainDate {\n  return z.toPlainDate();\n}\n\n/** True when two ZonedDateTimes land on the same wall-clock day (same zone assumed). */\nexport function isSameZonedDay(a: Temporal.ZonedDateTime, b: Temporal.ZonedDateTime): boolean {\n  return a.toPlainDate().equals(b.toPlainDate());\n}\n\n/** True when a ZonedDateTime falls on `day` (its wall-clock date equals `day`). */\nexport function isZonedOnDay(z: Temporal.ZonedDateTime, day: Temporal.PlainDate): boolean {\n  return z.toPlainDate().equals(day);\n}\n\n/** Start-of-day (00:00, zone-correct) for `day` in `z`'s time zone. */\nexport function startOfZonedDay(day: Temporal.PlainDate, timeZone: Temporal.TimeZoneLike): Temporal.ZonedDateTime {\n  return day.toZonedDateTime({ timeZone, plainTime: Temporal.PlainTime.from('00:00') });\n}\n\n/** `day` at hour `hour` (minutes/seconds zeroed), zone-correct, in `timeZone`. */\nexport function zonedAtHour(\n  day: Temporal.PlainDate,\n  hour: number,\n  timeZone: Temporal.TimeZoneLike,\n): Temporal.ZonedDateTime {\n  return day.toZonedDateTime({\n    timeZone,\n    plainTime: new Temporal.PlainTime(hour),\n  });\n}\n\n/** Signed minutes from `a` to `b` (positive when `b` is later). */\nexport function minutesBetween(a: Temporal.ZonedDateTime, b: Temporal.ZonedDateTime): number {\n  return a.until(b, { largestUnit: 'minute', smallestUnit: 'minute' }).minutes;\n}\n\n/** Later of two instants. */\nexport function maxZoned(a: Temporal.ZonedDateTime, b: Temporal.ZonedDateTime): Temporal.ZonedDateTime {\n  return Temporal.ZonedDateTime.compare(a, b) >= 0 ? a : b;\n}\n\n/** Earlier of two instants. */\nexport function minZoned(a: Temporal.ZonedDateTime, b: Temporal.ZonedDateTime): Temporal.ZonedDateTime {\n  return Temporal.ZonedDateTime.compare(a, b) <= 0 ? a : b;\n}\n\n/** True when `z`'s calendar day lies within [start, end] (inclusive, by day). */\nexport function isZonedDayInRange(\n  z: Temporal.ZonedDateTime,\n  start: Temporal.ZonedDateTime,\n  end: Temporal.ZonedDateTime,\n): boolean {\n  return isInRange(z.toPlainDate(), start.toPlainDate(), end.toPlainDate());\n}\n\n/** Format a ZonedDateTime's time-of-day as \"HH:MM\" (locale-aware). */\nexport function formatZonedTime(z: Temporal.ZonedDateTime): string {\n  return z.toLocaleString(undefined, { hour: '2-digit', minute: '2-digit' });\n}\n","<script lang=\"ts\">\n/**\n * Defines props for a `LegendText`.\n *\n * React's `HTMLAttributes<HTMLLegendElement>` has no Vue counterpart — every\n * native attribute is a fallthrough attr and lands on the `<legend>` unchanged.\n * The name is kept so consumers importing `LegendTextProps` still resolve.\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface LegendTextProps {}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, useAttrs, useTemplateRef } from 'vue';\nimport type { ClassValue } from 'clsx';\nimport { cn } from '../../../foundation/styles';\n\n/** Renders a `<legend>` styled to match `LabelText`, naming the group of controls a `FieldsetLayout` wraps. */\n/* `inheritAttrs: false` so `class` folds into the component's own `cn()` call — plain fallthrough\n   appends outside it and loses tailwind-merge conflict resolution. */\ndefineOptions({ name: 'LegendText', inheritAttrs: false });\n\ndefineSlots<{\n  /** The group's name — React's `children`. */\n  default(): unknown;\n}>();\n\nconst attrs = useAttrs();\n\nconst OwnedAttributes: ReadonlySet<string> = new Set(['class']);\nconst passthroughAttrs = computed(() =>\n  Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key))),\n);\n\nconst rootClass = computed(() => cn('mb-2 text-sm font-medium text-foreground', attrs.class as ClassValue));\n\nconst root = useTemplateRef<HTMLLegendElement>('root');\n\n/** The rendered element — the Vue stand-in for the React original's forwarded ref. */\ndefineExpose({ el: root });\n</script>\n\n<template>\n  <legend ref=\"root\" :class=\"rootClass\" v-bind=\"passthroughAttrs\">\n    <slot />\n  </legend>\n</template>\n","<script lang=\"ts\">\nimport type { Size } from '../../../foundation/styles';\n\nexport interface LabelTextProps {\n  /** The required state, showing a `*` indicator. Auto-derived from `FormControl.isRequired` when present. */\n  readonly isRequired?: boolean;\n\n  /** The visual size. Default `md`. */\n  readonly size?: Size;\n\n  /**\n   * The id of the labelled control — React's `htmlFor`. Auto-filled from\n   * `FormControl` context when omitted.\n   */\n  readonly htmlFor?: string;\n\n  /** The DOM spelling of {@link LabelTextProps.htmlFor}, which wins when both are set. */\n  readonly for?: string;\n\n  /**\n   * The label's own id. An explicit id detaches the node from the context's\n   * `labelId`, so the label stops registering as the context's naming chrome.\n   */\n  readonly id?: string;\n}\n\n/* Sizes not listed fall back to the `md` row at the call site. */\nconst SizeClass: Partial<Record<Size, string>> = {\n  xs: 'text-xs',\n  sm: 'text-sm',\n  md: 'text-sm',\n};\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, useAttrs, useTemplateRef } from 'vue';\nimport type { ClassValue } from 'clsx';\nimport { cn, Size as SizeValue } from '../../../foundation/styles';\nimport { useFormControl, useFormControlChrome } from '../../../foundation/primitives';\n\n/** Renders a `<label>` that takes `htmlFor` and `id` from `FormControl`, plus the required-field asterisk. */\n/* `inheritAttrs: false` so `class` folds into the component's own `cn()` call — plain fallthrough\n   appends outside it and loses tailwind-merge conflict resolution. */\ndefineOptions({ name: 'LabelText', inheritAttrs: false });\n\n/* `children` has no prop counterpart — the label copy is the default slot. */\nconst props = withDefaults(defineProps<LabelTextProps>(), {\n  size: SizeValue.Md,\n  /* `isRequired` must stay `undefined` when absent: the value falls back to the form\n     control's own `isRequired`, and Vue's Boolean casting would turn an absent prop into\n     an explicit `false` that shadows the context. */\n  isRequired: undefined,\n});\n\ndefineSlots<{\n  /** The label copy, rendered before the required asterisk. */\n  default(): unknown;\n}>();\n\nconst attrs = useAttrs();\n\n/* `ctx` is a live-getter object — read fields off it, never destructure. */\nconst ctx = useFormControl();\n\n/* Registration flips the context's `labelledBy` on — widgets that name themselves via\n   `aria-labelledby` reference the label only while it exists. An explicit `id` prop\n   detaches the node from the context's labelId. Passed as a getter to stay reactive. */\nuseFormControlChrome('label', () => props.id == null);\n\nconst isRequired = computed(() => props.isRequired ?? ctx?.isRequired ?? false);\nconst labelFor = computed(() => props.for ?? props.htmlFor ?? ctx?.id);\nconst labelId = computed(() => props.id ?? ctx?.labelId);\n\nconst OwnedAttributes: ReadonlySet<string> = new Set(['class']);\nconst passthroughAttrs = computed(() =>\n  Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key))),\n);\n\nconst rootClass = computed(() =>\n  cn(\n    SizeClass[props.size] ?? SizeClass.md,\n    'font-medium text-foreground',\n    ctx?.isDisabled && 'opacity-60',\n    attrs.class as ClassValue,\n  ),\n);\n\nconst root = useTemplateRef<HTMLLabelElement>('root');\n\n/** The rendered element — the Vue stand-in for the React original's forwarded ref. */\ndefineExpose({ el: root });\n</script>\n\n<template>\n  <label ref=\"root\" :for=\"labelFor\" :id=\"labelId\" :class=\"rootClass\" v-bind=\"passthroughAttrs\">\n    <slot />\n    <span v-if=\"isRequired\" class=\"ml-0.5 text-destructive\" aria-hidden=\"true\">*</span>\n  </label>\n</template>\n","import { tv, type VariantProps } from '../../../foundation/styles';\n\n/** Defines the outline shape of a color swatch. */\nexport const SwatchShape = {\n  /** Refers to a rounded-square swatch. */\n  Square: 'square',\n  /** Refers to a circular swatch. */\n  Circle: 'circle',\n} as const;\n\nexport type SwatchShape = (typeof SwatchShape)[keyof typeof SwatchShape];\n\n/** Defines the size step of a color swatch. */\nexport const ColorSwatchPreviewSize = {\n  /** Refers to the extra-small step (h-4). */\n  Xs: 'xs',\n  /** Refers to the small step (h-5). */\n  Sm: 'sm',\n  /** Refers to the medium (default) step (h-6). */\n  Md: 'md',\n  /** Refers to the large step (h-9). */\n  Lg: 'lg',\n} as const;\n\nexport type ColorSwatchPreviewSize = (typeof ColorSwatchPreviewSize)[keyof typeof ColorSwatchPreviewSize];\n\nexport const colorSwatchVariants = tv({\n  base: 'inline-block shrink-0 border border-border bg-[image:linear-gradient(45deg,_#ddd_25%,_transparent_25%),_linear-gradient(-45deg,_#ddd_25%,_transparent_25%),_linear-gradient(45deg,_transparent_75%,_#ddd_75%),_linear-gradient(-45deg,_transparent_75%,_#ddd_75%)] bg-[length:8px_8px] bg-[position:0_0,_0_4px,_4px_-4px,_-4px_0px]',\n  variants: {\n    size: {\n      xs: 'h-4 w-4',\n      sm: 'h-5 w-5',\n      md: 'h-6 w-6',\n      lg: 'h-9 w-9',\n    },\n    shape: {\n      square: 'rounded-sm',\n      circle: 'rounded-full',\n    },\n    interactive: {\n      true: 'cursor-pointer transition-shadow focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1 hover:shadow-sm',\n      false: '',\n    },\n    isSelected: {\n      true: 'ring-2 ring-ring ring-offset-1',\n      false: '',\n    },\n    isDisabled: {\n      true: 'cursor-not-allowed opacity-50',\n      false: '',\n    },\n  },\n  defaultVariants: {\n    size: 'md',\n    shape: 'square',\n    interactive: false,\n    isSelected: false,\n    isDisabled: false,\n  },\n});\n\nexport type ColorSwatchPreviewVariants = VariantProps<typeof colorSwatchVariants>;\n\n/* Compile-time lock: enum values ≡ tv axis keys (drift = type error). */\ntype AssertExact<A, B> = [A] extends [B] ? ([B] extends [A] ? true : never) : never;\nconst _assertColorSwatchSize: AssertExact<\n  ColorSwatchPreviewSize,\n  NonNullable<VariantProps<typeof colorSwatchVariants>['size']>\n> = true;\nconst _assertSwatchShape: AssertExact<\n  SwatchShape,\n  NonNullable<VariantProps<typeof colorSwatchVariants>['shape']>\n> = true;\nvoid _assertColorSwatchSize;\nvoid _assertSwatchShape;\n","<script lang=\"ts\">\nimport type { ColorSwatchPreviewSize, SwatchShape } from './ColorSwatchPreview.variants';\n\n/**\n * Defines props for a `ColorSwatchPreview`.\n *\n * React declared a discriminated union — `onClick` present selected the\n * `<button>` half and its `ButtonHTMLAttributes`, absent selected the `<div>`\n * half. The union collapses here: every native attribute is a fallthrough attr\n * and lands on whichever element renders, so only the styling axes remain\n * declared.\n *\n * `onClick` is deliberately NOT declared — see the note in `<script setup>`.\n */\nexport interface ColorSwatchPreviewProps {\n  /** Any CSS color string. Default `#000000`. */\n  readonly color?: string;\n  /** The swatch size step. */\n  readonly size?: ColorSwatchPreviewSize;\n  /** The swatch outline shape. */\n  readonly shape?: SwatchShape;\n  /** The selected state — draws the selection ring. */\n  readonly isSelected?: boolean;\n  /** The disabled state. Also sets `disabled` on the interactive (`<button>`) form. */\n  readonly isDisabled?: boolean;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, useAttrs, useTemplateRef, type StyleValue } from 'vue';\nimport type { ClassValue } from 'clsx';\nimport { cn } from '../../../foundation/styles';\nimport { colorSwatchVariants } from './ColorSwatchPreview.variants';\n\n/** Renders a color chip over a checkerboard backdrop — a `<button>` when given a click listener, else a `<div>`. */\n/* `inheritAttrs: false` so `class` folds into the component's own `cn()` call — plain fallthrough\n   appends outside it and loses tailwind-merge conflict resolution. */\ndefineOptions({ name: 'ColorSwatchPreview', inheritAttrs: false });\n\nconst props = withDefaults(defineProps<ColorSwatchPreviewProps>(), {\n  color: '#000000',\n  /* Explicit `undefined` defaults: Vue casts an absent `boolean` prop to `false`, which would\n     pin the tv axis to its explicit-false branch instead of letting `defaultVariants` apply. */\n  isSelected: undefined,\n  isDisabled: undefined,\n});\n\nconst attrs = useAttrs();\n\n/*\n * React switched the rendered element on `onClick`'s presence. `onClick` stays a FALLTHROUGH\n * ATTR here rather than a declared prop or an emit:\n *   - an emit would be stripped out of `useAttrs()`, erasing the discriminator entirely;\n *   - a declared prop would receive the merge ARRAY that `Primitive`'s `asChild` builds when\n *     `ColorPicker` chains the popover's toggle onto this swatch, and an array is not callable.\n * As an attr it stays detectable AND Vue invokes the whole chained array natively.\n */\nconst isInteractive = computed(() => Boolean(attrs.onClick));\n\n/* `style` is owned so the inset box-shadow can be layered after the caller's declarations,\n   the order React's `{ ...style, boxShadow }` spread gave it. */\nconst OwnedAttributes: ReadonlySet<string> = new Set(['class', 'style']);\nconst passthroughAttrs = computed(() =>\n  Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key))),\n);\n\nconst rootClass = computed(() =>\n  cn(\n    colorSwatchVariants({\n      size: props.size,\n      shape: props.shape,\n      interactive: isInteractive.value,\n      isSelected: props.isSelected,\n      isDisabled: props.isDisabled,\n    }),\n    attrs.class as ClassValue,\n  ),\n);\n\n/* Layers the color on top of the checkerboard via an inset box-shadow — keeps the variant\n   class's `bg-[image:…]` checkerboard visible behind a partial-alpha color. */\nconst rootStyle = computed<StyleValue>(() => [\n  attrs.style as StyleValue,\n  { boxShadow: `inset 0 0 0 100px ${props.color}` },\n]);\n\nconst root = useTemplateRef<HTMLElement>('root');\n\n/** The rendered element — the Vue stand-in for the React original's forwarded ref. */\ndefineExpose({ el: root });\n</script>\n\n<template>\n  <button\n    v-if=\"isInteractive\"\n    ref=\"root\"\n    type=\"button\"\n    :disabled=\"isDisabled\"\n    :class=\"rootClass\"\n    :style=\"rootStyle\"\n    v-bind=\"passthroughAttrs\"\n  />\n  <div v-else ref=\"root\" :class=\"rootClass\" :style=\"rootStyle\" v-bind=\"passthroughAttrs\" />\n</template>\n","<script lang=\"ts\">\nexport interface FieldHelperTextProps {\n  /**\n   * The node's own id. An explicit id detaches it from the context's `helperId`,\n   * so the control's `aria-describedby` stops referencing it.\n   */\n  readonly id?: string;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, useAttrs, useTemplateRef } from 'vue';\nimport type { ClassValue } from 'clsx';\nimport { cn } from '../../../foundation/styles';\nimport { useFormControl, useFormControlChrome } from '../../../foundation/primitives';\n\n/** Renders the hint text under a form control, registering its id with the control's `aria-describedby`. */\n/* `inheritAttrs: false` so `class` folds into the component's own `cn()` call — plain fallthrough\n   appends outside it and loses tailwind-merge conflict resolution. */\ndefineOptions({ name: 'FieldHelperText', inheritAttrs: false });\n\n/* React took the copy as `children`; here it is the default slot. */\nconst props = defineProps<FieldHelperTextProps>();\n\ndefineSlots<{\n  /** The hint copy — React's `children`. */\n  default(): unknown;\n}>();\n\nconst attrs = useAttrs();\n\n/* `ctx` is a live-getter object — read fields off it, never destructure. */\nconst ctx = useFormControl();\n\n/* An explicit `id` prop detaches the node from the context's helperId — don't register.\n   Passed as a getter so the registration re-runs if the prop changes. */\nuseFormControlChrome('helper', () => props.id == null);\n\nconst helperId = computed(() => props.id ?? ctx?.helperId);\n\nconst OwnedAttributes: ReadonlySet<string> = new Set(['class']);\nconst passthroughAttrs = computed(() =>\n  Object.fromEntries(Object.entries(attrs).filter(([key]) => !OwnedAttributes.has(key))),\n);\n\nconst rootClass = computed(() => cn('text-sm text-muted-foreground', attrs.class as ClassValue));\n\nconst root = useTemplateRef<HTMLParagraphElement>('root');\n\n/** The rendered element — the Vue stand-in for the React original's forwarded ref. */\ndefineExpose({ el: root });\n</script>\n\n<template>\n  <p ref=\"root\" :id=\"helperId\" :class=\"rootClass\" v-bind=\"passthroughAttrs\">\n    <slot />\n  </p>\n</template>\n"],"names":["_openBlock","_createElementBlock","_mergeProps","_renderSlot","_createVNode","_unref","Icon","_hoisted_1"],"mappings":";;;;;;;;;;;;AAoBA,UAAM,QAAQ,SAAA;AACd,UAAM,KAAK,eAA4B,IAAI;AAE3C,UAAM,UAAU;AAAA,MAAS,MACvB;AAAA,QACE;AAAA,QACA;AAAA,QACA,MAAM;AAAA,MAAA;AAAA,IACR;AAIF,UAAM,OAAO,SAAS,MAAM;AAC1B,YAAM,EAAE,OAAO,QAAQ,GAAG,WAAW;AACrC,aAAO;AAAA,IACT,CAAC;AAED,aAAa,EAAE,IAAI;;AAIjB,aAAAA,UAAA,GAAAC,mBAA2D,OAA3DC,WAA2D;AAAA,iBAAlD;AAAA,QAAJ,KAAI;AAAA,MAAA,GAAa,KAAA,OAAI,EAAG,OAAO,QAAA,MAAA,CAAO,GAAA;AAAA,QAAEC,WAAQ,KAAA,QAAA,SAAA;AAAA,MAAA;;;;ACtChD,MAAM,aAAa;AAAA;AAAA,EAExB,SAAS;AAAA;AAAA,EAET,OAAO;AAAA;AAAA,EAEP,SAAS;AAAA;AAAA,EAET,SAAS;AAAA;AAAA,EAET,QAAQ;AAAA;AAAA,EAER,MAAM;AACR;AAIO,MAAM,cAAc,GAAG;AAAA,EAC5B,MAAM;AAAA,EACN,UAAU;AAAA,IACR,SAAS;AAAA,MACP,SAAS;AAAA,MACT,OAAO;AAAA,MACP,SAAS;AAAA,MACT,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,MAAM;AAAA,IAAA;AAAA,EACR;AAAA,EAEF,iBAAiB;AAAA,IACf,SAAS;AAAA,EAAA;AAEb,CAAC;;;;;;;;;;;AChBD,UAAM,YAAY;AAalB,UAAM,QAAQ;AAGd,UAAM,OAAO;AAKb,UAAM,QAAQ,SAAA;AACd,UAAM,WAAW,mBAAA;AACjB,UAAM,KAAK,eAAgC,IAAI;AAO/C,UAAM,WAAW,MAAM,QAAQ,UAAU,MAAM,OAAO,OAAO;AAE7D,UAAM,UAAU,SAAS,MAAM,GAAG,YAAY,EAAE,SAAS,MAAM,QAAA,CAAS,GAAG,MAAM,KAA2B,CAAC;AAG7G,UAAM,OAAO,SAAS,MAAM;AAC1B,YAAM,EAAE,OAAO,QAAQ,GAAG,WAAW;AACrC,aAAO;AAAA,IACT,CAAC;AAED,aAAa,EAAE,IAAI;;AAIjB,aAAAH,UAAA,GAAAC,mBAWO,QAXPC,WAWO;AAAA,iBAXG;AAAA,QAAJ,KAAI;AAAA,MAAA,GAAa,KAAA,OAAI,EAAG,OAAO,QAAA,MAAA,CAAO,GAAA;AAAA,QAC1CC,WAAQ,KAAA,QAAA,SAAA;AAAA,QAEA,2BADRF,mBAQS,UAAA;AAAA;UANP,MAAK;AAAA,UACJ,cAAY,MAAM;AAAA,UACnB,OAAM;AAAA,UACL,+CAAO,KAAI,OAAA;AAAA,QAAA;UAEZG,YAAqCC,MAAAC,WAAA,GAAA;AAAA,YAA9B,MAAMD,MAAA,SAAA;AAAA,YAAY,MAAM;AAAA,UAAA;;;;;;AC9D9B,MAAM,qBAAqB,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;AACpE,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,YAAY,GAA+B;AAEzD,SAAO,EAAE,YAAY;AACvB;AAGO,SAAS,QAA4B;AAC1C,SAAO,SAAS,IAAI,aAAA;AACtB;AAEO,SAAS,UAAU,GAA0C,GAAmD;AACrH,MAAI,CAAC,KAAK,CAAC,EAAG,QAAO;AACrB,SAAO,EAAE,OAAO,CAAC;AACnB;AAEO,SAAS,QAAQ,GAAgC;AACtD,SAAO,EAAE,OAAO,OAAO;AACzB;AAGO,SAAS,UAAU,GAAuB,GAA+B;AAC9E,SAAO,EAAE,IAAI,EAAE,QAAQ,GAAG;AAC5B;AAEO,SAAS,QAAQ,GAAuB,GAA+B;AAC5E,SAAO,EAAE,IAAI,EAAE,MAAM,GAAG;AAC1B;AAGO,SAAS,aAAa,GAA2C;AACtE,SAAO,EAAE,KAAK,EAAE,KAAK,GAAG;AAC1B;AAGO,SAAS,YAAY,MAAc,OAAuB;AAC/D,SAAO,SAAS,UAAU,KAAK,EAAE,MAAM,OAAO,KAAK,EAAA,CAAG,EAAE;AAC1D;AAOO,SAAS,eACd,MACA,OACkE;AAClE,QAAM,QAAQ,SAAS,UAAU,KAAK,EAAE,MAAM,OAAO,KAAK,GAAG;AAC7D,QAAM,QAAQ,MAAM,SAAS,EAAE,MAAM,YAAY,KAAK,GAAG;AACzD,QAAM,QAA6D,CAAA;AACnE,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,OAAO,MAAM,IAAI,EAAE,MAAM,GAAG;AAClC,UAAM,KAAK,EAAE,MAAM,YAAY,KAAK,UAAU,OAAO;AAAA,EACvD;AACA,SAAO;AACT;AAGO,SAAS,cAAc,GAAkD;AAC9E,MAAI,CAAC,EAAG,QAAO;AACf,SAAO,EAAE,SAAA;AACX;AAGO,SAAS,aAAa,GAAyD;AACpF,MAAI,CAAC,EAAG,QAAO;AACf,MAAI,CAAC,sBAAsB,KAAK,CAAC,EAAG,QAAO;AAC3C,MAAI;AACF,WAAO,SAAS,UAAU,KAAK,GAAG,EAAE,UAAU,UAAU;AAAA,EAC1D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,cAAc,GAAkD;AAC9E,MAAI,CAAC,EAAG,QAAO;AACf,SAAO,EAAE,SAAS,EAAE,cAAc,UAAU;AAC9C;AAcO,SAAS,kBAAkB,IAAuD;AACvF,MAAI,CAAC,GAAI,QAAO;AAChB,SAAO,GAAG,SAAS,EAAE,cAAc,UAAU;AAC/C;AAGO,SAAS,iBAAiB,GAA6D;AAC5F,MAAI,CAAC,EAAG,QAAO;AACf,MAAI,CAAC,2CAA2C,KAAK,CAAC,EAAG,QAAO;AAChE,MAAI;AACF,WAAO,SAAS,cAAc,KAAK,GAAG,EAAE,UAAU,UAAU;AAAA,EAC9D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAYO,SAAS,eACd,GACA,SAKS;AACT,QAAM,EAAE,KAAK,KAAK,WAAA,IAAe;AACjC,MAAI,OAAO,SAAS,UAAU,QAAQ,GAAG,GAAG,IAAI,EAAG,QAAO;AAC1D,MAAI,OAAO,SAAS,UAAU,QAAQ,GAAG,GAAG,IAAI,EAAG,QAAO;AAC1D,MAAI,aAAa,CAAC,EAAG,QAAO;AAC5B,SAAO;AACT;AAEO,SAAS,UACd,GACA,OACA,KACS;AACT,MAAI,CAAC,SAAS,CAAC,IAAK,QAAO;AAC3B,QAAM,KAAK,SAAS,UAAU,QAAQ,OAAO,GAAG,KAAK,IAAI,QAAQ;AACjE,QAAM,KAAK,SAAS,UAAU,QAAQ,OAAO,GAAG,KAAK,IAAI,MAAM;AAC/D,SAAO,SAAS,UAAU,QAAQ,GAAG,EAAE,KAAK,KAAK,SAAS,UAAU,QAAQ,GAAG,EAAE,KAAK;AACxF;AAGO,SAAS,YAAY,GAAuB,GAA+B;AAChF,SAAO,EAAE,MAAM,GAAG,EAAE,aAAa,MAAA,CAAO,EAAE;AAC5C;AAGO,SAAS,UAAU,GAAgC;AAExD,SAAO,EAAE,cAAc,KAAK,EAAE,cAAc;AAC9C;AASO,SAAS,WAAmC;AACjD,SAAO,SAAS,IAAI,iBAAA;AACtB;AAaO,SAAS,aAAa,GAA2B,KAAkC;AACxF,SAAO,EAAE,cAAc,OAAO,GAAG;AACnC;AAQO,SAAS,YACd,KACA,MACA,UACwB;AACxB,SAAO,IAAI,gBAAgB;AAAA,IACzB;AAAA,IACA,WAAW,IAAI,SAAS,UAAU,IAAI;AAAA,EAAA,CACvC;AACH;AAGO,SAAS,eAAe,GAA2B,GAAmC;AAC3F,SAAO,EAAE,MAAM,GAAG,EAAE,aAAa,UAAU,cAAc,SAAA,CAAU,EAAE;AACvE;AAGO,SAAS,SAAS,GAA2B,GAAmD;AACrG,SAAO,SAAS,cAAc,QAAQ,GAAG,CAAC,KAAK,IAAI,IAAI;AACzD;AAGO,SAAS,SAAS,GAA2B,GAAmD;AACrG,SAAO,SAAS,cAAc,QAAQ,GAAG,CAAC,KAAK,IAAI,IAAI;AACzD;AAGO,SAAS,kBACd,GACA,OACA,KACS;AACT,SAAO,UAAU,EAAE,YAAA,GAAe,MAAM,YAAA,GAAe,IAAI,aAAa;AAC1E;AAGO,SAAS,gBAAgB,GAAmC;AACjE,SAAO,EAAE,eAAe,QAAW,EAAE,MAAM,WAAW,QAAQ,WAAW;AAC3E;;;;;ACjOA,UAAM,QAAQ,SAAA;AAEd,UAAM,kBAAuC,oBAAI,IAAI,CAAC,OAAO,CAAC;AAC9D,UAAM,mBAAmB;AAAA,MAAS,MAChC,OAAO,YAAY,OAAO,QAAQ,KAAK,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC;AAAA,IAAA;AAGvF,UAAM,YAAY,SAAS,MAAM,GAAG,4CAA4C,MAAM,KAAmB,CAAC;AAE1G,UAAM,OAAO,eAAkC,MAAM;AAGrD,aAAa,EAAE,IAAI,MAAM;;AAIvB,aAAAL,UAAA,GAAAC,mBAES,UAFTC,WAES;AAAA,iBAFG;AAAA,QAAJ,KAAI;AAAA,QAAQ,OAAO,UAAA;AAAA,MAAA,GAAmB,iBAAA,KAAgB,GAAA;AAAA,QAC5DC,WAAQ,KAAA,QAAA,SAAA;AAAA,MAAA;;;;;;;;;;ACjBZ,MAAM,YAA2C;AAAA,EAC/C,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;;;;;;;;;;;;AAeA,UAAM,QAAQ;AAad,UAAM,QAAQ,SAAA;AAGd,UAAM,MAAM,eAAA;AAKZ,yBAAqB,SAAS,MAAM,MAAM,MAAM,IAAI;AAEpD,UAAM,aAAa,SAAS,MAAM,MAAM,cAAc,KAAK,cAAc,KAAK;AAC9E,UAAM,WAAW,SAAS,MAAM,MAAM,OAAO,MAAM,WAAW,KAAK,EAAE;AACrE,UAAM,UAAU,SAAS,MAAM,MAAM,MAAM,KAAK,OAAO;AAEvD,UAAM,kBAAuC,oBAAI,IAAI,CAAC,OAAO,CAAC;AAC9D,UAAM,mBAAmB;AAAA,MAAS,MAChC,OAAO,YAAY,OAAO,QAAQ,KAAK,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC;AAAA,IAAA;AAGvF,UAAM,YAAY;AAAA,MAAS,MACzB;AAAA,QACE,UAAU,MAAM,IAAI,KAAK,UAAU;AAAA,QACnC;AAAA,QACA,KAAK,cAAc;AAAA,QACnB,MAAM;AAAA,MAAA;AAAA,IACR;AAGF,UAAM,OAAO,eAAiC,MAAM;AAGpD,aAAa,EAAE,IAAI,MAAM;;AAIvB,aAAAH,UAAA,GAAAC,mBAGQ,SAHRC,WAGQ;AAAA,iBAHG;AAAA,QAAJ,KAAI;AAAA,QAAQ,KAAK,SAAA;AAAA,QAAW,IAAI,QAAA;AAAA,QAAU,OAAO,UAAA;AAAA,MAAA,GAAmB,iBAAA,KAAgB,GAAA;AAAA,QACzFC,WAAQ,KAAA,QAAA,SAAA;AAAA,QACI,WAAA,sBAAZF,mBAAmF,QAAnF,YAA2E,GAAC;;;;;AC7FzE,MAAM,cAAc;AAAA;AAAA,EAEzB,QAAQ;AAAA;AAAA,EAER,QAAQ;AACV;AAKO,MAAM,yBAAyB;AAAA;AAAA,EAEpC,IAAI;AAAA;AAAA,EAEJ,IAAI;AAAA;AAAA,EAEJ,IAAI;AAAA;AAAA,EAEJ,IAAI;AACN;AAIO,MAAM,sBAAsB,GAAG;AAAA,EACpC,MAAM;AAAA,EACN,UAAU;AAAA,IACR,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,IAAA;AAAA,IAEN,OAAO;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ;AAAA,IAAA;AAAA,IAEV,aAAa;AAAA,MACX,MAAM;AAAA,MACN,OAAO;AAAA,IAAA;AAAA,IAET,YAAY;AAAA,MACV,MAAM;AAAA,MACN,OAAO;AAAA,IAAA;AAAA,IAET,YAAY;AAAA,MACV,MAAM;AAAA,MACN,OAAO;AAAA,IAAA;AAAA,EACT;AAAA,EAEF,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,YAAY;AAAA,EAAA;AAEhB,CAAC;;;;;;;;;;;;;ACpBD,UAAM,QAAQ;AAQd,UAAM,QAAQ,SAAA;AAUd,UAAM,gBAAgB,SAAS,MAAM,QAAQ,MAAM,OAAO,CAAC;AAI3D,UAAM,kBAAuC,oBAAI,IAAI,CAAC,SAAS,OAAO,CAAC;AACvE,UAAM,mBAAmB;AAAA,MAAS,MAChC,OAAO,YAAY,OAAO,QAAQ,KAAK,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC;AAAA,IAAA;AAGvF,UAAM,YAAY;AAAA,MAAS,MACzB;AAAA,QACE,oBAAoB;AAAA,UAClB,MAAM,MAAM;AAAA,UACZ,OAAO,MAAM;AAAA,UACb,aAAa,cAAc;AAAA,UAC3B,YAAY,MAAM;AAAA,UAClB,YAAY,MAAM;AAAA,QAAA,CACnB;AAAA,QACD,MAAM;AAAA,MAAA;AAAA,IACR;AAKF,UAAM,YAAY,SAAqB,MAAM;AAAA,MAC3C,MAAM;AAAA,MACN,EAAE,WAAW,qBAAqB,MAAM,KAAK,GAAA;AAAA,IAAG,CACjD;AAED,UAAM,OAAO,eAA4B,MAAM;AAG/C,aAAa,EAAE,IAAI,MAAM;;aAKf,cAAA,SADRD,UAAA,GAAAC,mBAQE,UARFC,WAQE;AAAA;iBANI;AAAA,QAAJ,KAAI;AAAA,QACJ,MAAK;AAAA,QACJ,UAAU,QAAA;AAAA,QACV,OAAO,UAAA;AAAA,QACP,OAAO,UAAA;AAAA,MAAA,GACA,iBAAA,KAAgB,GAAA,MAAA,IAAAK,YAAA,MAE1BP,UAAA,GAAAC,mBAAyF,OAAzFC,WAAyF;AAAA;iBAAzE;AAAA,QAAJ,KAAI;AAAA,QAAQ,OAAO,UAAA;AAAA,QAAY,OAAO,UAAA;AAAA,MAAA,GAAmB,iBAAA,KAAgB,GAAA,MAAA,EAAA;AAAA;;;;;;;;;;;AChFvF,UAAM,QAAQ;AAOd,UAAM,QAAQ,SAAA;AAGd,UAAM,MAAM,eAAA;AAIZ,yBAAqB,UAAU,MAAM,MAAM,MAAM,IAAI;AAErD,UAAM,WAAW,SAAS,MAAM,MAAM,MAAM,KAAK,QAAQ;AAEzD,UAAM,kBAAuC,oBAAI,IAAI,CAAC,OAAO,CAAC;AAC9D,UAAM,mBAAmB;AAAA,MAAS,MAChC,OAAO,YAAY,OAAO,QAAQ,KAAK,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC;AAAA,IAAA;AAGvF,UAAM,YAAY,SAAS,MAAM,GAAG,iCAAiC,MAAM,KAAmB,CAAC;AAE/F,UAAM,OAAO,eAAqC,MAAM;AAGxD,aAAa,EAAE,IAAI,MAAM;;AAIvB,aAAAF,UAAA,GAAAC,mBAEI,KAFJC,WAEI;AAAA,iBAFG;AAAA,QAAJ,KAAI;AAAA,QAAQ,IAAI,SAAA;AAAA,QAAW,OAAO,UAAA;AAAA,MAAA,GAAmB,iBAAA,KAAgB,GAAA;AAAA,QACtEC,WAAQ,KAAA,QAAA,SAAA;AAAA,MAAA;;;;"}

package/dist/chunks/FileName-DUtj4I5A.js

@@ -0,0 +1,33 @@
+function fileExtension(filename) {
+  const lastDot = filename.lastIndexOf(".");
+  if (lastDot <= 0 || lastDot === filename.length - 1) return "";
+  return filename.slice(lastDot + 1).toLowerCase();
+}
+function fileBaseName(filename) {
+  const lastDot = filename.lastIndexOf(".");
+  if (lastDot <= 0 || lastDot === filename.length - 1) return filename;
+  return filename.slice(0, lastDot);
+}
+const ControlCharacters = new RegExp("[\\u0000-\\u001f\\u007f]", "g");
+const ReservedCharacters = /[/\\<>:"|?*]+/g;
+function safeFileName(name, options) {
+  const replacement = (options?.replacement ?? "-").replace(ControlCharacters, "").replace(ReservedCharacters, "-");
+  const requestedLength = options?.maxLength ?? 255;
+  const maxLength = Number.isFinite(requestedLength) ? Math.max(1, Math.trunc(requestedLength)) : 255;
+  const cleaned = name.replace(ControlCharacters, "").replace(ReservedCharacters, () => replacement).replace(/\s+/g, " ").replace(/^[.\s]+|[.\s]+$/g, "").trim();
+  if (cleaned === "") return "file".slice(0, maxLength);
+  if (cleaned.length <= maxLength) return cleaned;
+  const extension = fileExtension(cleaned);
+  if (extension === "") return cleaned.slice(0, maxLength).replace(/[.\s]+$/g, "") || "file".slice(0, maxLength);
+  const suffix = `.${extension}`;
+  if (suffix.length >= maxLength)
+    return cleaned.slice(0, maxLength).replace(/[.\s]+$/g, "") || "file".slice(0, maxLength);
+  const headLength = maxLength - suffix.length;
+  return fileBaseName(cleaned).slice(0, headLength) + suffix;
+}
+export {
+  fileExtension as a,
+  fileBaseName as f,
+  safeFileName as s
+};
+//# sourceMappingURL=FileName-DUtj4I5A.js.map

package/dist/chunks/FileName-DUtj4I5A.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileName-DUtj4I5A.js","sources":["../../src/foundation/files/FileName.ts"],"sourcesContent":["// File-name parsing — extension and base-name extraction, plus safe-name sanitizing for a download. Pure string\n// work, deliberately separate from the DOM helpers so it stays node-testable.\n\n/**\n * Returns the lower-cased extension of a file name, without the leading dot. Yields `''` when there is no\n * extension, when the name is a dotfile (`.gitignore` — the dot starts the name, it doesn't separate one), or\n * when the dot is trailing.\n */\nexport function fileExtension(filename: string): string {\n  const lastDot = filename.lastIndexOf('.');\n  if (lastDot <= 0 || lastDot === filename.length - 1) return '';\n  return filename.slice(lastDot + 1).toLowerCase();\n}\n\n/** Returns the file name without its extension (`report.final.pdf` → `report.final`). Dotfiles are returned whole. */\nexport function fileBaseName(filename: string): string {\n  const lastDot = filename.lastIndexOf('.');\n  if (lastDot <= 0 || lastDot === filename.length - 1) return filename;\n  return filename.slice(0, lastDot);\n}\n\n/** Tunes download-name sanitizing. */\nexport interface SafeFileNameOptions {\n  /** The character replacing each illegal run. Defaults to `-`. */\n  readonly replacement?: string;\n\n  /** Maximum length of the result (extension preserved when truncating). Defaults to `255`. */\n  readonly maxLength?: number;\n}\n\n/**\n * Control characters (C0 range plus DEL) — built from escape sequences rather than a regex literal so no literal\n * control byte ever appears in this source file.\n */\n// eslint-disable-next-line no-control-regex -- stripping control chars is the point of this pattern\nconst ControlCharacters = new RegExp('[\\\\u0000-\\\\u001f\\\\u007f]', 'g');\n\n/** Path separators + the characters Windows reserves in a file name. */\nconst ReservedCharacters = /[/\\\\<>:\"|?*]+/g;\n\n/**\n * Sanitizes a string into a file name safe across Windows / macOS / Linux: strips path separators, the reserved\n * characters `< > : \" | ? *`, and control characters; collapses whitespace; trims leading/trailing dots and\n * spaces. Truncates to `maxLength` while preserving the extension. Returns `'file'` when nothing usable remains.\n */\nexport function safeFileName(name: string, options?: SafeFileNameOptions): string {\n  const replacement = (options?.replacement ?? '-').replace(ControlCharacters, '').replace(ReservedCharacters, '-');\n  const requestedLength = options?.maxLength ?? 255;\n  const maxLength = Number.isFinite(requestedLength) ? Math.max(1, Math.trunc(requestedLength)) : 255;\n\n  const cleaned = name\n    .replace(ControlCharacters, '')\n    .replace(ReservedCharacters, () => replacement)\n    .replace(/\\s+/g, ' ')\n    .replace(/^[.\\s]+|[.\\s]+$/g, '')\n    .trim();\n\n  if (cleaned === '') return 'file'.slice(0, maxLength);\n  if (cleaned.length <= maxLength) return cleaned;\n\n  // Truncate the base, keep the extension so the file still opens with the right handler.\n  const extension = fileExtension(cleaned);\n  if (extension === '') return cleaned.slice(0, maxLength).replace(/[.\\s]+$/g, '') || 'file'.slice(0, maxLength);\n\n  const suffix = `.${extension}`;\n  if (suffix.length >= maxLength)\n    return cleaned.slice(0, maxLength).replace(/[.\\s]+$/g, '') || 'file'.slice(0, maxLength);\n  const headLength = maxLength - suffix.length;\n  return fileBaseName(cleaned).slice(0, headLength) + suffix;\n}\n"],"names":[],"mappings":"AAQO,SAAS,cAAc,UAA0B;AACtD,QAAM,UAAU,SAAS,YAAY,GAAG;AACxC,MAAI,WAAW,KAAK,YAAY,SAAS,SAAS,EAAG,QAAO;AAC5D,SAAO,SAAS,MAAM,UAAU,CAAC,EAAE,YAAA;AACrC;AAGO,SAAS,aAAa,UAA0B;AACrD,QAAM,UAAU,SAAS,YAAY,GAAG;AACxC,MAAI,WAAW,KAAK,YAAY,SAAS,SAAS,EAAG,QAAO;AAC5D,SAAO,SAAS,MAAM,GAAG,OAAO;AAClC;AAgBA,MAAM,oBAAoB,IAAI,OAAO,4BAA4B,GAAG;AAGpE,MAAM,qBAAqB;AAOpB,SAAS,aAAa,MAAc,SAAuC;AAChF,QAAM,eAAe,SAAS,eAAe,KAAK,QAAQ,mBAAmB,EAAE,EAAE,QAAQ,oBAAoB,GAAG;AAChH,QAAM,kBAAkB,SAAS,aAAa;AAC9C,QAAM,YAAY,OAAO,SAAS,eAAe,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,eAAe,CAAC,IAAI;AAEhG,QAAM,UAAU,KACb,QAAQ,mBAAmB,EAAE,EAC7B,QAAQ,oBAAoB,MAAM,WAAW,EAC7C,QAAQ,QAAQ,GAAG,EACnB,QAAQ,oBAAoB,EAAE,EAC9B,KAAA;AAEH,MAAI,YAAY,GAAI,QAAO,OAAO,MAAM,GAAG,SAAS;AACpD,MAAI,QAAQ,UAAU,UAAW,QAAO;AAGxC,QAAM,YAAY,cAAc,OAAO;AACvC,MAAI,cAAc,GAAI,QAAO,QAAQ,MAAM,GAAG,SAAS,EAAE,QAAQ,YAAY,EAAE,KAAK,OAAO,MAAM,GAAG,SAAS;AAE7G,QAAM,SAAS,IAAI,SAAS;AAC5B,MAAI,OAAO,UAAU;AACnB,WAAO,QAAQ,MAAM,GAAG,SAAS,EAAE,QAAQ,YAAY,EAAE,KAAK,OAAO,MAAM,GAAG,SAAS;AACzF,QAAM,aAAa,YAAY,OAAO;AACtC,SAAO,aAAa,OAAO,EAAE,MAAM,GAAG,UAAU,IAAI;AACtD;"}

package/dist/chunks/FormControlContext-B71MFW26.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormControlContext-B71MFW26.js","sources":["../../src/foundation/primitives/formControlContext/FormControlContext.ts"],"sourcesContent":["import { inject, toValue, watch, type InjectionKey, type MaybeRefOrGetter } from 'vue';\n\n/** The chrome slots a form control can be described/named by. */\nexport type FormControlChromeKind = 'label' | 'helper' | 'error';\n\nexport interface FormControlContextValue {\n  readonly id: string;\n  readonly labelId: string;\n  readonly helperId: string;\n  readonly errorId: string;\n  /**\n   * The `aria-labelledby` target — `labelId` only while a Label chrome is actually\n   * mounted, else `undefined`. Widgets that can't be named via `for` (button\n   * triggers, ARIA sliders) reference THIS, never `labelId` directly — referencing\n   * a non-rendered id is an axe `aria-valid-attr-value` violation.\n   */\n  readonly labelledBy?: string;\n  /**\n   * The `aria-describedby` target — only the ids of helper/error chrome actually\n   * mounted (space-joined), else `undefined`. Controls wire this verbatim; never\n   * hand-compose `helperId`/`errorId` (dangling ids when the chrome isn't rendered).\n   */\n  readonly describedBy?: string;\n  /**\n   * The field's error messages (client + server merged, client first) — fed by the\n   * forms-engine `Field` glue so error chrome (`FormErrorMessage`) renders them\n   * without hand-wiring. `undefined` outside an engine-driven field.\n   */\n  readonly errors?: readonly string[];\n  readonly isInvalid: boolean;\n  readonly isDisabled: boolean;\n  readonly isRequired: boolean;\n  readonly isReadOnly: boolean;\n  /** Registers a mounted chrome node (label/helper/error); returns the unregister. Chrome uses {@link useFormControlChrome}. */\n  registerChrome: (kind: FormControlChromeKind) => () => void;\n}\n\nexport const FormControlKey: InjectionKey<FormControlContextValue> = Symbol('wow-two.formControl');\n\n/**\n * Read the surrounding form-control context. Returns `null` when used\n * outside a provider — atoms gracefully degrade to standalone mode.\n *\n * Every field on the returned object is a live getter, so `ctx.describedBy`\n * re-reads on each access. Destructuring takes a one-time snapshot; bind to\n * the object instead.\n */\nexport function useFormControl(): FormControlContextValue | null {\n  return inject(FormControlKey, null);\n}\n\n/**\n * Registers a chrome node (label/helper/error) with the surrounding form control\n * while `isRendered` — flips the context's `labelledBy`/`describedBy` to include\n * the node's id only for the frames it actually exists. Call unconditionally;\n * pass `isRendered: false` when the chrome renders nothing or renders under an\n * explicit `id` prop instead of the context id.\n *\n * `isRendered` accepts a ref or getter as well as a plain boolean — the React\n * version re-ran its effect on every render, where Vue needs the reactive source\n * named. `flush: 'post'` is the `useLayoutEffect` equivalent: the registration\n * lands after the DOM updates, before paint.\n */\nexport function useFormControlChrome(\n  kind: FormControlChromeKind,\n  isRendered: MaybeRefOrGetter<boolean>,\n): void {\n  const context = useFormControl();\n  watch(\n    () => toValue(isRendered),\n    (isRenderedNow, _previous, onCleanup) => {\n      if (!isRenderedNow || !context) return;\n      onCleanup(context.registerChrome(kind));\n    },\n    { immediate: true, flush: 'post' },\n  );\n}\n"],"names":[],"mappings":";AAqCO,MAAM,iBAAwD,OAAO,qBAAqB;AAU1F,SAAS,iBAAiD;AAC/D,SAAO,OAAO,gBAAgB,IAAI;AACpC;AAcO,SAAS,qBACd,MACA,YACM;AACN,QAAM,UAAU,eAAA;AAChB;AAAA,IACE,MAAM,QAAQ,UAAU;AAAA,IACxB,CAAC,eAAe,WAAW,cAAc;AACvC,UAAI,CAAC,iBAAiB,CAAC,QAAS;AAChC,gBAAU,QAAQ,eAAe,IAAI,CAAC;AAAA,IACxC;AAAA,IACA,EAAE,WAAW,MAAM,OAAO,OAAA;AAAA,EAAO;AAErC;"}
+{"version":3,"file":"FormControlContext-B71MFW26.js","sources":["../../src/foundation/primitives/formControlContext/FormControlContext.ts"],"sourcesContent":["import { inject, toValue, watch, type InjectionKey, type MaybeRefOrGetter } from 'vue';\n\n/** The chrome slots a form control can be described/named by. */\nexport const FormControlChromeKind = {\n  /** Names the control — its rendered id joins `aria-labelledby`. */\n  Label: 'label',\n\n  /** Describes the control in the resting case — its id joins `aria-describedby`. */\n  Helper: 'helper',\n\n  /** Describes the control's validation failure — its id joins `aria-describedby` and wins over the helper. */\n  Error: 'error',\n} as const;\n\n/** The chrome slots a form control can be described/named by. */\nexport type FormControlChromeKind = (typeof FormControlChromeKind)[keyof typeof FormControlChromeKind];\n\nexport interface FormControlContextValue {\n  readonly id: string;\n  readonly labelId: string;\n  readonly helperId: string;\n  readonly errorId: string;\n  /**\n   * The `aria-labelledby` target — `labelId` only while a Label chrome is actually\n   * mounted, else `undefined`. Widgets that can't be named via `for` (button\n   * triggers, ARIA sliders) reference THIS, never `labelId` directly — referencing\n   * a non-rendered id is an axe `aria-valid-attr-value` violation.\n   */\n  readonly labelledBy?: string;\n  /**\n   * The `aria-describedby` target — only the ids of helper/error chrome actually\n   * mounted (space-joined), else `undefined`. Controls wire this verbatim; never\n   * hand-compose `helperId`/`errorId` (dangling ids when the chrome isn't rendered).\n   */\n  readonly describedBy?: string;\n  /**\n   * The field's error messages (client + server merged, client first) — fed by the\n   * forms-engine `Field` glue so error chrome (`FormErrorMessage`) renders them\n   * without hand-wiring. `undefined` outside an engine-driven field.\n   */\n  readonly errors?: ReadonlyArray<string>;\n  readonly isInvalid: boolean;\n  readonly isDisabled: boolean;\n  readonly isRequired: boolean;\n  readonly isReadOnly: boolean;\n  /** Registers a chrome node (label/helper/error); returns the unregister. Called by {@link useFormControlChrome}. */\n  registerChrome: (kind: FormControlChromeKind) => () => void;\n}\n\nexport const FormControlKey: InjectionKey<FormControlContextValue> = Symbol('wow-two.formControl');\n\n/**\n * Read the surrounding form-control context. Returns `null` when used\n * outside a provider — atoms gracefully degrade to standalone mode.\n *\n * Every field on the returned object is a live getter, so `ctx.describedBy`\n * re-reads on each access. Destructuring takes a one-time snapshot; bind to\n * the object instead.\n */\nexport function useFormControl(): FormControlContextValue | null {\n  return inject(FormControlKey, null);\n}\n\n/**\n * Registers a chrome node (label/helper/error) with the surrounding form control\n * while `isRendered` — flips the context's `labelledBy`/`describedBy` to include\n * the node's id only for the frames it actually exists. Call unconditionally;\n * pass `isRendered: false` when the chrome renders nothing or renders under an\n * explicit `id` prop instead of the context id.\n *\n * `isRendered` accepts a ref or getter as well as a plain boolean — the React\n * version re-ran its effect on every render, where Vue needs the reactive source\n * named. `flush: 'post'` is the `useLayoutEffect` equivalent: the registration\n * lands after the DOM updates, before paint.\n */\nexport function useFormControlChrome(kind: FormControlChromeKind, isRendered: MaybeRefOrGetter<boolean>): void {\n  const context = useFormControl();\n  watch(\n    () => toValue(isRendered),\n    (isRenderedNow, _previous, onCleanup) => {\n      if (!isRenderedNow || !context) return;\n      onCleanup(context.registerChrome(kind));\n    },\n    { immediate: true, flush: 'post' },\n  );\n}\n"],"names":[],"mappings":";AAiDO,MAAM,iBAAwD,OAAO,qBAAqB;AAU1F,SAAS,iBAAiD;AAC/D,SAAO,OAAO,gBAAgB,IAAI;AACpC;AAcO,SAAS,qBAAqB,MAA6B,YAA6C;AAC7G,QAAM,UAAU,eAAA;AAChB;AAAA,IACE,MAAM,QAAQ,UAAU;AAAA,IACxB,CAAC,eAAe,WAAW,cAAc;AACvC,UAAI,CAAC,iBAAiB,CAAC,QAAS;AAChC,gBAAU,QAAQ,eAAe,IAAI,CAAC;AAAA,IACxC;AAAA,IACA,EAAE,WAAW,MAAM,OAAO,OAAA;AAAA,EAAO;AAErC;"}