@oods/components-vue 0.3.3 → 0.4.0

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, watch, nextTick, onBeforeUnmount, isVNode, Text as Text$1, Comment, Fragment } from 'vue';
+import { vizPreviewLayers, svgCarriesTitle, 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, 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,83 @@ var Button = defineComponent({
     }, [slotOrValue(slots.default, props.content)]);
   }
 });
+var canShowModal = () => typeof HTMLDialogElement !== "undefined" && typeof HTMLDialogElement.prototype.showModal === "function";
+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());
+    const sync = () => {
+      const dialog = element.value;
+      if (!dialog || !managed.value) return;
+      if (props.open && !dialog.open) dialog.showModal();
+      else if (!props.open && dialog.open) dialog.close();
+    };
+    onMounted(() => {
+      mounted.value = true;
+    });
+    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,
+        // The browser closed it (a close request it would not let be cancelled) while open is still true. A close event
+        // from moving a mounted dialog into the top layer finds it open again, and is not reported.
+        onClose: () => {
+          if (props.open && !element.value?.open) 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 +540,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 +555,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 +570,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", {
@@ -1725,6 +1817,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 +1930,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 +1948,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 +2166,6 @@ 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"
-    }
-  },
-  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"
-    }
-  }
-};
-var STATUS_ALIASES = {
-  subscription: { delinquent: "unpaid" }
-};
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -2095,18 +2182,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 +2332,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 +2648,7 @@ var SearchInput = defineComponent({
           "aria-label": "Clear search",
           disabled: props.disabled,
           onClick: clear
-        }, "\xD7") : null
+        }, [statusIcon("x")]) : null
       ]);
     };
   }
@@ -2714,17 +2795,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);
     };
@@ -2972,7 +3054,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" })) });
   } });
 }
@@ -3003,4 +3085,4 @@ var VizMarkPreview = preview("VizMarkPreview", "bar");
 var VizPointPreview = preview("VizPointPreview", "scatter");
 var VizScatterPreview = preview("VizScatterPreview", "scatter");
 
-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, 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, 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 };