@oods/components-vue 0.3.3 → 0.4.1

package/dist/index.js

@@ -1,5 +1,10 @@
-import { defineComponent, h, ref, computed, useId, watch, nextTick, onMounted, onBeforeUnmount, isVNode, Text as Text$1, Comment, Fragment } from 'vue';
-import { svgCarriesTitle, assertStaticSvg, formatPriceAmount, formatPriceCode, formatReferenceLabel, summaryValue, formatDateTime, dateTimeInputValue, formatReadOnlyValue, BILLING_MINOR_UNITS, billingSummary, formatBillingAmount, billingAmountText, billingAmountMessage, parseBillingAmount, BILLING_INTERVALS, billingIntervalMessage, billingCycle, auditSummary, initialSort, ariaSort, nextSort, recipeItemLabels, DEFAULT_COLOR_STATES, geoFieldMapping, currencyMinorUnits, billingPaymentSummary, billingPaymentRows, traitEventRows, vizControlFields, VIZ_CONTROL_TITLES, vizFieldValue, vizSummaryRows, editVizIntent } from '@oods/component-contracts';
+import { defineComponent, h, useId, computed, ref, onMounted, onBeforeUnmount, watch, nextTick, isVNode, Text as Text$1, Comment, Fragment } from 'vue';
+import { vizPreviewLayers, svgCarriesTitle, formatPriceAmount, formatPriceCode, formatReferenceLabel, ownershipPhrase, summaryValue, formatDateTime, dateTimeInputValue, formatReadOnlyValue, BILLING_MINOR_UNITS, billingSummary, formatBillingAmount, billingAmountText, billingAmountMessage, parseBillingAmount, BILLING_INTERVALS, billingIntervalMessage, billingCycle, auditSummary, initialSort, ariaSort, nextSort, recipeItemLabels, DEFAULT_COLOR_STATES, geoFieldMapping, STATUS_ICON_SVG_ATTRS, STATUS_ICON_SHAPES, getStatusPresentation, resolveStatusIcon, currencyMinorUnits, billingPaymentSummary, billingPaymentRows, traitEventRows, vizControlFields, VIZ_CONTROL_TITLES, vizFieldValue, vizSummaryRows, editVizIntent } from '@oods/component-contracts';
+
+// src/primitives.ts
+function statusIcon(name) {
+  return h("svg", { ...STATUS_ICON_SVG_ATTRS }, STATUS_ICON_SHAPES[name].map((shape) => h(shape.tag, { ...shape.attrs })));
+}
 
 // src/primitives.ts
 var toneProp = String;
@@ -142,7 +147,7 @@ var Banner = defineComponent({
           class: "oods-banner-dismiss oods-banner__dismiss",
           "aria-label": props.dismissLabel,
           onClick: () => emit("dismiss")
-        }, [h("span", { "aria-hidden": "true" }, "\xD7")]) : null
+        }, [statusIcon("x")]) : null
       ]);
     };
   }
@@ -152,7 +157,7 @@ var Button = defineComponent({
   props: {
     content: { type: [String, Number], default: "" },
     intent: { type: String, default: "neutral" },
-    size: { type: sizeProp, default: "md" },
+    size: { type: String, default: "md" },
     disabled: Boolean,
     type: { type: String, default: "button" }
   },
@@ -179,6 +184,130 @@ var Button = defineComponent({
     }, [slotOrValue(slots.default, props.content)]);
   }
 });
+var canShowModal = () => typeof HTMLDialogElement !== "undefined" && typeof HTMLDialogElement.prototype.showModal === "function";
+var pageLocks = 0;
+var pageStyle;
+function lockPageScroll() {
+  const page = document.documentElement;
+  if (pageLocks++ === 0) {
+    const scrollbar = window.innerWidth - page.clientWidth;
+    pageStyle = { overflow: page.style.overflow, paddingRight: page.style.paddingRight };
+    if (scrollbar > 0) page.style.paddingRight = `${parseFloat(getComputedStyle(page).paddingRight) + scrollbar}px`;
+    page.style.overflow = "hidden";
+  }
+  let held = true;
+  return () => {
+    if (!held) return;
+    held = false;
+    if (--pageLocks === 0 && pageStyle) {
+      page.style.overflow = pageStyle.overflow;
+      page.style.paddingRight = pageStyle.paddingRight;
+      pageStyle = void 0;
+    }
+  };
+}
+var outsideBox = (event, dialog) => {
+  const box = dialog.getBoundingClientRect();
+  return event.clientX < box.left || event.clientX > box.right || event.clientY < box.top || event.clientY > box.bottom;
+};
+var Dialog = defineComponent({
+  name: "OodsDialog",
+  props: {
+    id: String,
+    open: Boolean,
+    modal: { type: Boolean, default: true },
+    title: { type: String, default: "" },
+    description: String,
+    dismissLabel: { type: String, default: "Close" },
+    size: { type: String, default: "md" },
+    actions: { type: [String, Number, Object, Array], default: void 0 }
+  },
+  emits: {
+    close: () => true
+  },
+  setup(props, { emit, slots }) {
+    const generatedId = useId().replace(/[^\w-]/g, "");
+    const dialogId = computed(() => props.id || `oods-dialog-${generatedId}`);
+    const element = ref(null);
+    const mounted = ref(false);
+    const managed = computed(() => props.modal && mounted.value && canShowModal());
+    let unlockScroll;
+    let pressedBackdrop = false;
+    const releaseScroll = () => {
+      unlockScroll?.();
+      unlockScroll = void 0;
+    };
+    const sync = () => {
+      const dialog = element.value;
+      if (!dialog || !managed.value) return;
+      if (props.open && !dialog.open) {
+        dialog.showModal();
+        unlockScroll ??= lockPageScroll();
+      } else if (!props.open && dialog.open) dialog.close();
+    };
+    onMounted(() => {
+      mounted.value = true;
+    });
+    onBeforeUnmount(releaseScroll);
+    watch([() => props.open, managed], sync, { flush: "post" });
+    const requestClose = (event) => {
+      event.preventDefault();
+      emit("close");
+    };
+    return () => {
+      const titleId = `${dialogId.value}-title`;
+      const descriptionId = `${dialogId.value}-description`;
+      const actions = slotOrValue(slots.actions, props.actions);
+      return h("dialog", {
+        ref: element,
+        id: dialogId.value,
+        class: "oods-dialog",
+        "data-oods-component": "Dialog",
+        "data-size": props.size,
+        "aria-labelledby": titleId,
+        "aria-describedby": props.description ? descriptionId : void 0,
+        open: managed.value ? void 0 : props.open,
+        onKeydown: (event) => {
+          if (event.key === "Escape" && !event.defaultPrevented) requestClose(event);
+        },
+        onCancel: requestClose,
+        // A close event from moving a mounted dialog into the top layer finds it open again, and is not reported. Any other
+        // close releases the page; when the browser closed it (a close request it would not let be cancelled) while open is
+        // still true, it is reported.
+        onClose: () => {
+          if (element.value?.open) return;
+          releaseScroll();
+          if (props.open) emit("close");
+        },
+        onMousedown: (event) => {
+          pressedBackdrop = managed.value && event.target === event.currentTarget && outsideBox(event, event.currentTarget);
+        },
+        // s223-m02 (#2527 ruling 13b): a click on the backdrop emits close, as the close control does. A press that began
+        // inside the dialog (text selected and dragged out) is not a backdrop click.
+        onClick: (event) => {
+          const backdrop = pressedBackdrop && event.target === event.currentTarget && outsideBox(event, event.currentTarget);
+          pressedBackdrop = false;
+          if (backdrop) emit("close");
+        }
+      }, [
+        h("div", { class: "oods-dialog__header" }, [
+          h("div", { class: "oods-dialog__heading" }, [
+            h("h2", { id: titleId, class: "oods-dialog__title" }, props.title),
+            props.description ? h("p", { id: descriptionId, class: "oods-dialog__description" }, props.description) : null
+          ]),
+          h("button", {
+            type: "button",
+            class: "oods-dialog__close",
+            "aria-label": props.dismissLabel,
+            onClick: () => emit("close")
+          }, [statusIcon("x")])
+        ]),
+        slots.default ? h("div", { class: "oods-dialog__body" }, slots.default()) : null,
+        actions !== void 0 && actions !== null && actions !== "" ? h("div", { class: "oods-dialog__footer" }, [actions]) : null
+      ]);
+    };
+  }
+});
 var SAFE_CARD_ELEMENTS = /* @__PURE__ */ new Set(["div", "article", "section", "aside"]);
 var Card = defineComponent({
   name: "OodsCard",
@@ -458,6 +587,13 @@ var VizAreaPreview = defineComponent({
     svgNarrow: String,
     /** The same chart rendered at the wide size; the figure shows it instead of svg when its own inline size is at least 900px. */
     svgWide: String,
+    /** s222-m02 (F7): the dark and high-contrast renders; with any of them, svg* are the light ones (see React's types). */
+    svgDark: String,
+    svgDarkNarrow: String,
+    svgDarkWide: String,
+    svgHc: String,
+    svgHcNarrow: String,
+    svgHcWide: String,
     title: String,
     description: String,
     width: { type: Number, default: 640 },
@@ -466,6 +602,7 @@ var VizAreaPreview = defineComponent({
   setup(props, { slots }) {
     return () => {
       const content = authoredContent(slots.default?.());
+      const renders = (layer) => layer.renders.map(([attribute, markup]) => h("div", { [attribute]: "true", innerHTML: markup }));
       if (props.svg !== void 0) return h("figure", {
         class: "oods-viz-area-preview",
         "data-oods-component": "VizAreaPreview",
@@ -480,9 +617,11 @@ var VizAreaPreview = defineComponent({
         style: { "--oods-viz-width": `${props.width}px` }
       }, [
         ...props.title && !svgCarriesTitle(props.svg, props.title) ? [h("figcaption", props.title)] : [],
-        h("div", { "data-viz-svg": "true", innerHTML: assertStaticSvg(props.svg) }),
-        ...props.svgNarrow !== void 0 ? [h("div", { "data-viz-svg-narrow": "true", innerHTML: assertStaticSvg(props.svgNarrow) })] : [],
-        ...props.svgWide !== void 0 ? [h("div", { "data-viz-svg-wide": "true", innerHTML: assertStaticSvg(props.svgWide) })] : [],
+        ...vizPreviewLayers(props).flatMap((layer) => layer.theme === void 0 ? renders(layer) : [h("div", {
+          "data-viz-theme": layer.theme,
+          ...layer.narrow ? { "data-viz-narrow": "true" } : {},
+          ...layer.wide ? { "data-viz-wide": "true" } : {}
+        }, renders(layer))]),
         ...props.description ? [h("p", { "data-viz-description": "true" }, props.description)] : []
       ]);
       return h("div", {
@@ -711,12 +850,15 @@ function createBadgeFamily(options) {
   };
   for (const key of options.extraProps) props[key] = String;
   for (const key of options.booleanProps ?? []) props[key] = { type: [String, Boolean], default: void 0 };
+  if (options.booleanProps) props.hideWhenFalse = { type: [Boolean, String], default: void 0 };
   return defineComponent({
     name: `Oods${options.component}`,
     props,
     setup(componentProps, { slots }) {
       return () => {
         const record = componentProps;
+        const flag = options.booleanProps?.map((key) => record[key]).find((value) => typeof value === "boolean");
+        if (record.hideWhenFalse === true && flag === false) return null;
         const content = authoredContent(slots.default?.());
         const scalar = scalarContent(content);
         const read = (key) => typeof record[key] === "boolean" && options.booleanProps?.includes(key) ? String(record[key]) : record[key];
@@ -1343,12 +1485,13 @@ var TagSummary = defineComponent({
 });
 var OwnershipMeta = defineComponent({
   name: "OodsOwnershipMeta",
-  props: { title: String, label: String, heading: String, name: String, ownerType: String, owner_type: String, role: String, ownershipRole: String },
+  props: { title: String, label: String, heading: String, name: String, ownerType: String, owner_type: String, role: String, ownershipRole: String, ownerLabel: String },
   setup(props, { slots }) {
     return () => {
       const content = authoredContent(slots.default?.());
       const terms = [["Owner Type", firstScalar(props.ownerType, props.owner_type)], ["Role", firstScalar(props.role, props.ownershipRole)]].filter((entry) => entry[1] !== void 0);
-      return h("div", { class: "oods-ownership-meta", "data-oods-component": "OwnershipMeta", "data-meta-type": "ownership" }, content.length ? content : [
+      const phrase = props.ownerLabel !== void 0 ? ownershipPhrase(props.ownerLabel, firstScalar(props.ownerType, props.owner_type), firstScalar(props.role, props.ownershipRole)) : void 0;
+      return h("div", { class: "oods-ownership-meta", "data-oods-component": "OwnershipMeta", "data-meta-type": "ownership" }, content.length ? content : phrase ? [h("span", { "data-meta-item": "true" }, phrase)] : [
         h("span", { "data-meta-title": "true" }, firstText(props.title, props.label, props.heading, props.name) ?? "Ownership"),
         ...terms.map(([term, value]) => h("span", { key: term, "data-meta-item": "true" }, [h("strong", `${term}:`), ` ${value}`]))
       ]);
@@ -1725,6 +1868,75 @@ var Checkbox = defineComponent({
     };
   }
 });
+var Switch = defineComponent({
+  name: "OodsSwitch",
+  props: {
+    id: String,
+    label: String,
+    modelValue: { type: Boolean, default: void 0 },
+    checked: { type: Boolean, default: void 0 },
+    defaultChecked: Boolean,
+    required: Boolean,
+    disabled: Boolean,
+    help: String,
+    validation: Object,
+    size: { type: String, default: "md" }
+  },
+  emits: {
+    "update:modelValue": (_value) => true,
+    change: (_value) => true
+  },
+  setup(props, { emit, slots }) {
+    const internalChecked = ref(props.defaultChecked);
+    const currentChecked = computed(() => props.modelValue ?? props.checked ?? internalChecked.value);
+    const metadata = useFieldMetadata("Switch", props, slots);
+    const toggle = () => {
+      const next = !currentChecked.value;
+      if (props.modelValue === void 0 && props.checked === void 0) internalChecked.value = next;
+      emit("update:modelValue", next);
+      emit("change", next);
+    };
+    return () => {
+      const label = slots.label?.() ?? props.label;
+      const help = slots.help?.() ?? props.help;
+      const validation = slots.validation?.() ?? props.validation?.message;
+      const controlId = metadata.controlId.value;
+      return h("div", {
+        class: "oods-field oods-switch",
+        style: validationStyle(props.validation),
+        "data-oods-component": "Switch",
+        "data-size": props.size,
+        "data-validation-state": props.validation?.state
+      }, [
+        h("div", { class: "oods-switch__row" }, [
+          h("button", {
+            id: controlId,
+            type: "button",
+            role: "switch",
+            class: "oods-switch__control",
+            "aria-checked": currentChecked.value ? "true" : "false",
+            "aria-labelledby": `${controlId}-label`,
+            "aria-describedby": metadata.describedBy.value,
+            "aria-required": props.required ? "true" : void 0,
+            "aria-invalid": props.validation?.state === "error" ? "true" : void 0,
+            disabled: props.disabled,
+            onClick: toggle
+          }, [h("span", { class: "oods-switch__thumb", "aria-hidden": "true" })]),
+          h("label", { id: `${controlId}-label`, class: "oods-field-label oods-switch__label", for: controlId }, [
+            label,
+            props.required ? h("span", { class: "oods-field-required", "aria-hidden": "true" }, "*") : null
+          ])
+        ]),
+        help ? h("p", { id: metadata.helpId.value, class: "oods-field-help" }, help) : null,
+        validation ? h("p", {
+          id: metadata.validationId.value,
+          class: "oods-field-error",
+          role: props.validation?.state === "error" ? "alert" : void 0
+        }, validation) : null
+      ]);
+    };
+  }
+});
 var TableCaption = defineComponent({
   name: "OodsTableCaption",
   setup(_props, { slots }) {
@@ -1769,6 +1981,8 @@ var Table = defineComponent({
   inheritAttrs: false,
   props: {
     caption: { type: String, default: "" },
+    // s222-m02 (#2502 ruling 11): false keeps the caption as the table's accessible name but hides it visually.
+    showCaption: { type: Boolean, default: true },
     columns: { type: Array, default: () => [] },
     rows: { type: Array, default: () => [] },
     density: { type: String, default: "default" },
@@ -1785,7 +1999,7 @@ var Table = defineComponent({
       "data-oods-component": "Table",
       "data-density": props.density
     }, [
-      slots.caption || props.caption ? h(TableCaption, {}, {
+      slots.caption || props.caption ? h(TableCaption, { "data-visually-hidden": props.showCaption ? void 0 : "true" }, {
         default: () => slots.caption?.() ?? props.caption
       }) : null,
       h(TableHead, {}, {
@@ -2003,82 +2217,63 @@ var Tabs = defineComponent({
     ]);
   }
 });
-
-// src/ported-core.ts
-var STATUS_METADATA = {
-  subscription: {
-    future: {
-      description: "Subscription is scheduled but not yet active.",
-      tone: "info",
-      icon: "\u23F2"
-    },
-    trialing: {
-      description: "Subscription is in a trial period before billing begins.",
-      tone: "accent",
-      icon: "\u2605"
-    },
-    active: {
-      description: "Subscription is paid and service is provisioned.",
-      tone: "success",
-      icon: "\u2714\uFE0E"
-    },
-    paused: {
-      description: "Billing paused temporarily by finance or customer request.",
-      tone: "neutral",
-      icon: "\u23F8"
-    },
-    pending_cancellation: {
-      description: "Subscription will cancel at period end but remains active now.",
-      tone: "info",
-      icon: "\u2026"
-    },
-    past_due: {
-      description: "Renewal payment failed; smart retries ongoing and access retained during the grace window.",
-      tone: "critical",
-      icon: "\u26A0\uFE0E"
-    },
-    unpaid: {
-      description: "Payment retries exhausted; service access revoked.",
-      tone: "critical",
-      icon: "\u2A2F"
-    },
-    terminated: {
-      description: "Subscription ended; service access revoked and billing stopped.",
-      tone: "neutral",
-      icon: "\u2205"
-    }
+var SegmentedControl = defineComponent({
+  name: "OodsSegmentedControl",
+  props: {
+    id: String,
+    label: String,
+    modelValue: String,
+    value: String,
+    defaultValue: { type: String, default: "" },
+    name: String,
+    size: { type: String, default: "md" },
+    disabled: Boolean,
+    options: { type: Array, default: () => [] }
   },
-  invoice: {
-    draft: {
-      description: "Invoice is editable and not yet finalized.",
-      tone: "neutral",
-      icon: "\u270E"
-    },
-    posted: {
-      description: "Invoice finalized with terms before collection.",
-      tone: "info",
-      icon: "\u2026"
-    },
-    paid: {
-      description: "Invoice collected successfully in full.",
-      tone: "success",
-      icon: "\u2714\uFE0E"
-    },
-    past_due: {
-      description: "Invoice is unpaid past its due date.",
-      tone: "critical",
-      icon: "\u2A2F"
-    },
-    void: {
-      description: "Invoice canceled and no longer payable.",
-      tone: "neutral",
-      icon: "\u2205"
-    }
+  emits: {
+    "update:modelValue": (_value) => true,
+    change: (_value) => true
+  },
+  setup(props, { emit, slots }) {
+    const generatedId = useId();
+    const internalValue = ref(props.defaultValue);
+    const currentValue = computed(() => props.modelValue ?? props.value ?? internalValue.value);
+    const select = (event) => {
+      const next = event.target.value;
+      if (props.modelValue === void 0 && props.value === void 0) internalValue.value = next;
+      emit("update:modelValue", next);
+      emit("change", next);
+    };
+    return () => {
+      const id = props.id || `oods-segmentedcontrol-${generatedId}`;
+      const label = slots.label?.() ?? props.label;
+      return h("div", {
+        class: "oods-field oods-segmented-control",
+        "data-oods-component": "SegmentedControl",
+        "data-size": props.size
+      }, [
+        h("span", { id: `${id}-label`, class: "oods-field-label" }, [label]),
+        h("div", {
+          id,
+          role: "radiogroup",
+          "aria-labelledby": `${id}-label`,
+          class: "oods-segmented-control__track"
+        }, props.options.map((option) => h("label", { key: option.value, class: "oods-segmented-control__option" }, [
+          h("input", {
+            type: "radio",
+            class: "oods-segmented-control__input",
+            name: props.name || id,
+            value: option.value,
+            checked: option.value === currentValue.value,
+            disabled: props.disabled || option.disabled,
+            onChange: select
+          }),
+          h("span", { class: "oods-segmented-control__label" }, option.label)
+        ])))
+      ]);
+    };
   }
-};
-var STATUS_ALIASES = {
-  subscription: { delinquent: "unpaid" }
-};
+});
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -2095,18 +2290,13 @@ function statusLabel2(status) {
   return status.split(/[_-]/).filter(Boolean).map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1)).join(" ");
 }
 function getPortedStatusPresentation(domain, status) {
-  const normalizedDomain = domain.toLowerCase();
-  const normalizedStatus = status.toLowerCase();
-  const alias = STATUS_ALIASES[normalizedDomain]?.[normalizedStatus];
-  const metadata = STATUS_METADATA[normalizedDomain]?.[alias ?? normalizedStatus];
-  if (!metadata) {
-    return {
-      label: statusLabel2(status || "Unknown"),
-      description: "Status not found in registry; falling back to the requested token set.",
-      tone: "neutral"
-    };
-  }
-  return { ...metadata, label: statusLabel2(status) };
+  const presentation = getStatusPresentation(domain.toLowerCase(), status);
+  return {
+    label: statusLabel2(status || "Unknown"),
+    description: presentation.description,
+    tone: presentation.tone,
+    icon: resolveStatusIcon(presentation.iconName)
+  };
 }
 function formatPrice(amountCents, amount, currency) {
   const normalizedAmount = amount;
@@ -2250,11 +2440,10 @@ var StatusBadge = defineComponent({
         domain: props.domain,
         tone,
         emphasis: props.variant === "solid" ? "solid" : props.emphasis,
-        icon: props.showIcon ? presentation.icon : void 0,
         title: stringValue(attrs.title) ?? presentation.description,
         "aria-label": ariaLabel,
         "data-oods-component": "StatusBadge"
-      }, slots);
+      }, props.showIcon && presentation.icon && !slots.icon ? { ...slots, icon: () => statusIcon(presentation.icon) } : slots);
     };
   }
 });
@@ -2567,7 +2756,7 @@ var SearchInput = defineComponent({
           "aria-label": "Clear search",
           disabled: props.disabled,
           onClick: clear
-        }, "\xD7") : null
+        }, [statusIcon("x")]) : null
       ]);
     };
   }
@@ -2714,17 +2903,18 @@ var RelativeTimestamp = defineComponent({
         props.createdAt
       ) ?? "";
       if (props.hideWhenEmpty && (!datetime || Number.isNaN(Date.parse(datetime)))) return null;
+      const absolute = formatDateTime(datetime, { timeZone: props.timezone });
       const content = firstDefined(
         props.relative,
         props.label,
         props.text,
-        props.now === void 0 ? formatDateTime(datetime, { timeZone: props.timezone }) : relativeTimestampLabel(datetime, props.now)
+        !absolute ? "Unknown time" : props.now === void 0 ? absolute : relativeTimestampLabel(datetime, props.now)
       ) ?? "";
       return h("time", {
         ...attrs,
         class: mergedClass("oods-relative-timestamp", attrs.class),
         datetime: datetime || void 0,
-        title: stringValue(attrs.title) ?? formatDateTime(datetime, { timeZone: props.timezone }),
+        title: stringValue(attrs.title) ?? absolute,
         "data-oods-component": "RelativeTimestamp"
       }, content);
     };
@@ -2901,7 +3091,8 @@ var array = Array;
 function eventRecipe(id, kind, title) {
   return defineComponent({ name: id, props: { id: String, title: { type: String, default: title }, archivedAt: String, restoredAt: String, archivedBy: String, reason: String, timestamp: String, code: String, history: array, status: String, showActor: { type: Boolean, default: true }, showReason: { type: Boolean, default: true } }, setup: (props) => () => {
     const rows = traitEventRows(kind, props);
-    return h("article", { id: props.id, class: "oods-trait-recipe", "data-oods-component": id, "aria-label": props.title }, [h("h2", props.title), rows.length ? h("ol", rows.map((row, index) => h("li", { key: index }, [h("strong", row.title), h("p", row.at ? h("time", { datetime: row.at }, row.time) : row.time), row.actor && h("p", `Actor: ${row.actor}`), row.reason && h("p", `Reason: ${row.reason}`), row.code && h("p", `Code: ${row.code}`)]))) : h("p", "No events recorded.")]);
+    if (!rows.length) return null;
+    return h("article", { id: props.id, class: "oods-trait-recipe", "data-oods-component": id, "aria-label": props.title }, [h("h2", props.title), h("ol", rows.map((row, index) => h("li", { key: index }, [h("strong", row.title), h("p", row.at ? h("time", { datetime: row.at }, row.time) : row.time), row.actor && h("p", `Actor: ${row.actor}`), row.reason && h("p", `Reason: ${row.reason}`), row.code && h("p", `Code: ${row.code}`)])))]);
   } });
 }
 var ArchiveEvent = eventRecipe("ArchiveEvent", "archive", "Archive events");
@@ -2972,7 +3163,7 @@ function summary(id) {
   } });
 }
 function preview(id, type) {
-  return defineComponent({ name: id, props: { svg: String, svgNarrow: String, svgWide: String, title: String, description: String, width: Number, height: Number }, setup(props, { slots }) {
+  return defineComponent({ name: id, props: { svg: String, svgNarrow: String, svgWide: String, svgDark: String, svgDarkNarrow: String, svgDarkWide: String, svgHc: String, svgHcNarrow: String, svgHcWide: String, title: String, description: String, width: Number, height: Number }, setup(props, { slots }) {
     return () => h(VizAreaPreview, { ...props, title: props.title ?? `${type[0].toUpperCase()}${type.slice(1)} chart`, "data-oods-component": id, "data-viz-preview-type": type }, { default: slots.default ?? (() => h(Text, { content: "No rendered chart supplied" })) });
   } });
 }
@@ -3002,5 +3193,210 @@ var VizLinePreview = preview("VizLinePreview", "line");
 var VizMarkPreview = preview("VizMarkPreview", "bar");
 var VizPointPreview = preview("VizPointPreview", "scatter");
 var VizScatterPreview = preview("VizScatterPreview", "scatter");
+var Combobox = defineComponent({
+  name: "OodsCombobox",
+  props: {
+    id: String,
+    label: String,
+    options: { type: Array, default: () => [] },
+    modelValue: String,
+    value: String,
+    defaultValue: { type: String, default: "" },
+    placeholder: String,
+    name: String,
+    required: Boolean,
+    disabled: Boolean,
+    help: String,
+    validation: Object,
+    /** The control height, as Button, Input and Select: xs 24, sm 28, md 32 (default) or lg 40. */
+    size: { type: String, default: "md" }
+  },
+  emits: {
+    "update:modelValue": (_value) => true,
+    change: (_value) => true
+  },
+  setup(props, { emit, slots }) {
+    const generatedId = useId();
+    const controlId = computed(() => props.id || `oods-combobox-${generatedId}`);
+    const internalValue = ref(props.defaultValue);
+    const query = ref(null);
+    const open = ref(false);
+    const active = ref(-1);
+    const root = ref(null);
+    const listbox = ref(null);
+    const chosenValue = computed(() => props.modelValue ?? props.value ?? internalValue.value);
+    const chosen = computed(() => props.options.find((option) => option.value === chosenValue.value));
+    const text = computed(() => query.value ?? chosen.value?.label ?? "");
+    const matches = computed(() => {
+      const needle = (query.value ?? "").trim().toLowerCase();
+      return props.options.map((option) => needle === "" || option.label.toLowerCase().includes(needle));
+    });
+    const reachable = computed(() => props.options.flatMap((option, index) => matches.value[index] && !option.disabled ? [index] : []));
+    const optionId = (index) => `${controlId.value}-option-${index}`;
+    const close = () => {
+      open.value = false;
+      active.value = -1;
+    };
+    const commit = (next) => {
+      if (props.modelValue === void 0 && props.value === void 0) internalValue.value = next;
+      emit("update:modelValue", next);
+      emit("change", next);
+    };
+    const pick = (index) => {
+      const option = props.options[index];
+      if (!option || option.disabled) return;
+      query.value = null;
+      close();
+      if (option.value !== chosenValue.value) commit(option.value);
+    };
+    const outside = (event) => {
+      if (!root.value?.contains(event.target)) close();
+    };
+    watch(open, (isOpen) => {
+      if (isOpen) document.addEventListener("pointerdown", outside);
+      else document.removeEventListener("pointerdown", outside);
+    });
+    onBeforeUnmount(() => {
+      if (typeof document !== "undefined") document.removeEventListener("pointerdown", outside);
+    });
+    watch([open, active], async () => {
+      if (!open.value || active.value < 0) return;
+      await nextTick();
+      const element = listbox.value?.children[active.value];
+      element?.scrollIntoView?.({ block: "nearest" });
+    });
+    const keydown = (event) => {
+      if (event.defaultPrevented || props.disabled || event.isComposing) return;
+      const order = reachable.value;
+      const first = order[0] ?? -1;
+      const last = order[order.length - 1] ?? -1;
+      const at = order.indexOf(active.value);
+      switch (event.key) {
+        case "ArrowDown":
+          event.preventDefault();
+          active.value = !open.value || at === -1 ? first : order[(at + 1) % order.length];
+          open.value = true;
+          return;
+        case "ArrowUp":
+          event.preventDefault();
+          active.value = !open.value || at <= 0 ? last : order[at - 1];
+          open.value = true;
+          return;
+        case "Home":
+        case "End":
+          if (!open.value) return;
+          event.preventDefault();
+          active.value = event.key === "Home" ? first : last;
+          return;
+        case "Enter":
+          if (!open.value) return;
+          event.preventDefault();
+          if (active.value >= 0) pick(active.value);
+          return;
+        case "Escape":
+          if (open.value) {
+            event.preventDefault();
+            close();
+            return;
+          }
+          if (text.value === "" && chosenValue.value === "") return;
+          event.preventDefault();
+          query.value = null;
+          if (chosenValue.value !== "") commit("");
+          return;
+        case "Tab":
+          if (open.value) close();
+          return;
+      }
+    };
+    return () => {
+      const id = controlId.value;
+      const label = slots.label?.() ?? props.label;
+      const help = slots.help?.() ?? props.help;
+      const validation = slots.validation?.() ?? props.validation?.message;
+      const tone = props.validation ? props.validation.state === "error" ? "critical" : props.validation.state : void 0;
+      const describedBy = [help ? `${id}-help` : void 0, validation ? `${id}-validation` : void 0].filter(Boolean).join(" ") || void 0;
+      const noMatches = open.value && !matches.value.some(Boolean);
+      return h("div", {
+        ref: root,
+        class: "oods-field oods-combobox",
+        ...tone ? { style: { "--cmp-input-message-border": `var(--sys-status-${tone}-border)`, "--cmp-input-message-text": `var(--sys-status-${tone}-text)` } } : {},
+        "data-oods-component": "Combobox",
+        "data-size": props.size,
+        "data-validation-state": props.validation?.state
+      }, [
+        h("label", { id: `${id}-label`, class: "oods-field-label", for: id }, [
+          label,
+          props.required ? h("span", { class: "oods-field-required", "aria-hidden": "true" }, "*") : null
+        ]),
+        h("div", { class: "oods-combobox__control" }, [
+          h("input", {
+            id,
+            type: "text",
+            role: "combobox",
+            class: "oods-field-control oods-combobox__input",
+            value: text.value,
+            placeholder: props.placeholder,
+            autocomplete: "off",
+            "aria-autocomplete": "list",
+            "aria-expanded": open.value ? "true" : "false",
+            "aria-controls": `${id}-listbox`,
+            "aria-activedescendant": open.value && active.value >= 0 ? optionId(active.value) : void 0,
+            "aria-describedby": describedBy,
+            "aria-invalid": props.validation?.state === "error" ? "true" : void 0,
+            required: props.required,
+            disabled: props.disabled,
+            onInput: (event) => {
+              query.value = event.target.value;
+              open.value = true;
+              active.value = -1;
+            },
+            onKeydown: keydown,
+            onClick: () => {
+              if (!props.disabled) open.value = true;
+            },
+            onBlur: () => {
+              query.value = null;
+              close();
+            }
+          }),
+          h("span", { class: "oods-combobox__chevron", "aria-hidden": "true" }, [statusIcon("chevron-down")]),
+          h("div", {
+            class: "oods-combobox__popup",
+            hidden: !open.value,
+            onMousedown: (event) => event.preventDefault()
+          }, [
+            h(
+              "ul",
+              { ref: listbox, id: `${id}-listbox`, class: "oods-combobox__listbox", role: "listbox", "aria-labelledby": `${id}-label` },
+              props.options.map((option, index) => h("li", {
+                key: option.value,
+                id: optionId(index),
+                class: "oods-combobox__option",
+                role: "option",
+                "aria-selected": option.value === chosenValue.value ? "true" : "false",
+                "aria-disabled": option.disabled ? "true" : void 0,
+                "data-value": option.value,
+                "data-active": index === active.value ? "true" : void 0,
+                hidden: !matches.value[index],
+                onClick: () => pick(index),
+                onPointermove: () => {
+                  if (!option.disabled && index !== active.value) active.value = index;
+                }
+              }, [
+                h("span", { class: "oods-combobox__option-label" }, option.label),
+                h("span", { class: "oods-combobox__check", "aria-hidden": "true" }, [statusIcon("check")])
+              ]))
+            ),
+            h("p", { class: "oods-combobox__empty", role: "status" }, noMatches ? "No matches" : "")
+          ])
+        ]),
+        props.name ? h("input", { type: "hidden", name: props.name, value: chosenValue.value }) : null,
+        help ? h("p", { id: `${id}-help`, class: "oods-field-help" }, help) : null,
+        validation ? h("p", { id: `${id}-validation`, class: "oods-field-error", role: props.validation?.state === "error" ? "alert" : void 0 }, validation) : null
+      ]);
+    };
+  }
+});
 
-export { AddressCollectionPanel, AddressEditor, AddressSummaryBadge, AddressValidationTimeline, ArchiveEvent, ArchivePill, ArchiveSummary, ArchivedRowOverlay, AuditEvent, AuditSummaryCard, AuditTimeline, Badge, Banner, BillingAmountInput, BillingCardMeta, BillingIntervalSelector, BillingSummaryBadge, Button, CancellationBadge, CancellationEvent, CancellationForm, CancellationSummary, Card, CardHeader, Checkbox, ClassificationBadge, ClassificationEditor, ClassificationPanel, ColorStatePicker, ColorSwatch, ColorizedBadge, CommunicationDetailPanel, CycleProgressCard, DatePicker, DetailHeader, FilterPanel, FormLabelGroup, GeoFieldMappingForm, GeoResolutionBadge, GeocodablePreview, Grid, InlineLabel, Input, LabelCell, MembershipAuditTimeline, MembershipPanel, MessageEventTimeline, MessageStatusBadge, OwnerBadge, OwnershipMeta, OwnershipSummary, PaginationBar, PaymentEventTimeline, PaymentTimeline, PreferenceEditor, PreferencePanel, PreferenceSummaryBadge, PreferenceTimeline, PriceBadge, PriceCardMeta, PriceSummary, RelativeTimestamp, RoleAssignmentForm, RoleBadgeList, SearchInput, Select, SortIndicator, Stack, StateTransitionEvent, StatusBadge, StatusColorLegend, StatusSelector, StatusTimeline, Table, TableBody, TableCaption, TableCell, TableHead, TableHeaderCell, TableRow, Tabs, TagInput, TagManager, TagPills, TagSummary, TemplatePicker, Text, Textarea, TimelineEntryLabel, VizAreaControls, VizAreaPreview, VizAxisControls, VizAxisSummary, VizColorControls, VizColorLegendConfig, VizEncodingBadge, VizGraphPreview, VizHeatmapControls, VizHeatmapPreview, VizLineControls, VizLinePreview, VizMarkControls, VizMarkPreview, VizOpacityControls, VizOpacitySummary, VizPointControls, VizPointPreview, VizRoleBadge, VizScaleControls, VizScaleSummary, VizScatterControls, VizScatterPreview, VizShapeControls, VizShapeLegend, VizSizeControls, VizSizeSummary };
+export { AddressCollectionPanel, AddressEditor, AddressSummaryBadge, AddressValidationTimeline, ArchiveEvent, ArchivePill, ArchiveSummary, ArchivedRowOverlay, AuditEvent, AuditSummaryCard, AuditTimeline, Badge, Banner, BillingAmountInput, BillingCardMeta, BillingIntervalSelector, BillingSummaryBadge, Button, CancellationBadge, CancellationEvent, CancellationForm, CancellationSummary, Card, CardHeader, Checkbox, ClassificationBadge, ClassificationEditor, ClassificationPanel, ColorStatePicker, ColorSwatch, ColorizedBadge, Combobox, CommunicationDetailPanel, CycleProgressCard, DatePicker, DetailHeader, Dialog, FilterPanel, FormLabelGroup, GeoFieldMappingForm, GeoResolutionBadge, GeocodablePreview, Grid, InlineLabel, Input, LabelCell, MembershipAuditTimeline, MembershipPanel, MessageEventTimeline, MessageStatusBadge, OwnerBadge, OwnershipMeta, OwnershipSummary, PaginationBar, PaymentEventTimeline, PaymentTimeline, PreferenceEditor, PreferencePanel, PreferenceSummaryBadge, PreferenceTimeline, PriceBadge, PriceCardMeta, PriceSummary, RelativeTimestamp, RoleAssignmentForm, RoleBadgeList, SearchInput, SegmentedControl, Select, SortIndicator, Stack, StateTransitionEvent, StatusBadge, StatusColorLegend, StatusSelector, StatusTimeline, Switch, Table, TableBody, TableCaption, TableCell, TableHead, TableHeaderCell, TableRow, Tabs, TagInput, TagManager, TagPills, TagSummary, TemplatePicker, Text, Textarea, TimelineEntryLabel, VizAreaControls, VizAreaPreview, VizAxisControls, VizAxisSummary, VizColorControls, VizColorLegendConfig, VizEncodingBadge, VizGraphPreview, VizHeatmapControls, VizHeatmapPreview, VizLineControls, VizLinePreview, VizMarkControls, VizMarkPreview, VizOpacityControls, VizOpacitySummary, VizPointControls, VizPointPreview, VizRoleBadge, VizScaleControls, VizScaleSummary, VizScatterControls, VizScatterPreview, VizShapeControls, VizShapeLegend, VizSizeControls, VizSizeSummary };