@oods/components-vue 0.3.3 → 0.4.0

package/README.md

@@ -34,4 +34,4 @@ Use matching versions of the OODS packages. These packages are separate from the
 
 ## License
 
-Apache License 2.0. See [LICENSE](https://cdn.jsdelivr.net/npm/@oods/components-vue@0.3.3/LICENSE) and [NOTICE](https://cdn.jsdelivr.net/npm/@oods/components-vue@0.3.3/NOTICE). Generated output belongs to its user; installed package dependencies retain their own licenses.
+Apache License 2.0. See [LICENSE](https://cdn.jsdelivr.net/npm/@oods/components-vue@0.4.0/LICENSE) and [NOTICE](https://cdn.jsdelivr.net/npm/@oods/components-vue@0.4.0/NOTICE). Generated output belongs to its user; installed package dependencies retain their own licenses.

package/dist/index.cjs

@@ -3,6 +3,11 @@
 var vue = require('vue');
 var componentContracts = require('@oods/component-contracts');
 
+// src/primitives.ts
+function statusIcon(name) {
+  return vue.h("svg", { ...componentContracts.STATUS_ICON_SVG_ATTRS }, componentContracts.STATUS_ICON_SHAPES[name].map((shape) => vue.h(shape.tag, { ...shape.attrs })));
+}
+
 // src/primitives.ts
 var toneProp = String;
 var emphasisProp = String;
@@ -144,7 +149,7 @@ var Banner = vue.defineComponent({
           class: "oods-banner-dismiss oods-banner__dismiss",
           "aria-label": props.dismissLabel,
           onClick: () => emit("dismiss")
-        }, [vue.h("span", { "aria-hidden": "true" }, "\xD7")]) : null
+        }, [statusIcon("x")]) : null
       ]);
     };
   }
@@ -154,7 +159,7 @@ var Button = vue.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" }
   },
@@ -181,6 +186,83 @@ var Button = vue.defineComponent({
     }, [slotOrValue(slots.default, props.content)]);
   }
 });
+var canShowModal = () => typeof HTMLDialogElement !== "undefined" && typeof HTMLDialogElement.prototype.showModal === "function";
+var Dialog = vue.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 = vue.useId().replace(/[^\w-]/g, "");
+    const dialogId = vue.computed(() => props.id || `oods-dialog-${generatedId}`);
+    const element = vue.ref(null);
+    const mounted = vue.ref(false);
+    const managed = vue.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();
+    };
+    vue.onMounted(() => {
+      mounted.value = true;
+    });
+    vue.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 vue.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");
+        }
+      }, [
+        vue.h("div", { class: "oods-dialog__header" }, [
+          vue.h("div", { class: "oods-dialog__heading" }, [
+            vue.h("h2", { id: titleId, class: "oods-dialog__title" }, props.title),
+            props.description ? vue.h("p", { id: descriptionId, class: "oods-dialog__description" }, props.description) : null
+          ]),
+          vue.h("button", {
+            type: "button",
+            class: "oods-dialog__close",
+            "aria-label": props.dismissLabel,
+            onClick: () => emit("close")
+          }, [statusIcon("x")])
+        ]),
+        slots.default ? vue.h("div", { class: "oods-dialog__body" }, slots.default()) : null,
+        actions !== void 0 && actions !== null && actions !== "" ? vue.h("div", { class: "oods-dialog__footer" }, [actions]) : null
+      ]);
+    };
+  }
+});
 var SAFE_CARD_ELEMENTS = /* @__PURE__ */ new Set(["div", "article", "section", "aside"]);
 var Card = vue.defineComponent({
   name: "OodsCard",
@@ -460,6 +542,13 @@ var VizAreaPreview = vue.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 },
@@ -468,6 +557,7 @@ var VizAreaPreview = vue.defineComponent({
   setup(props, { slots }) {
     return () => {
       const content = authoredContent(slots.default?.());
+      const renders = (layer) => layer.renders.map(([attribute, markup]) => vue.h("div", { [attribute]: "true", innerHTML: markup }));
       if (props.svg !== void 0) return vue.h("figure", {
         class: "oods-viz-area-preview",
         "data-oods-component": "VizAreaPreview",
@@ -482,9 +572,11 @@ var VizAreaPreview = vue.defineComponent({
         style: { "--oods-viz-width": `${props.width}px` }
       }, [
         ...props.title && !componentContracts.svgCarriesTitle(props.svg, props.title) ? [vue.h("figcaption", props.title)] : [],
-        vue.h("div", { "data-viz-svg": "true", innerHTML: componentContracts.assertStaticSvg(props.svg) }),
-        ...props.svgNarrow !== void 0 ? [vue.h("div", { "data-viz-svg-narrow": "true", innerHTML: componentContracts.assertStaticSvg(props.svgNarrow) })] : [],
-        ...props.svgWide !== void 0 ? [vue.h("div", { "data-viz-svg-wide": "true", innerHTML: componentContracts.assertStaticSvg(props.svgWide) })] : [],
+        ...componentContracts.vizPreviewLayers(props).flatMap((layer) => layer.theme === void 0 ? renders(layer) : [vue.h("div", {
+          "data-viz-theme": layer.theme,
+          ...layer.narrow ? { "data-viz-narrow": "true" } : {},
+          ...layer.wide ? { "data-viz-wide": "true" } : {}
+        }, renders(layer))]),
         ...props.description ? [vue.h("p", { "data-viz-description": "true" }, props.description)] : []
       ]);
       return vue.h("div", {
@@ -1727,6 +1819,75 @@ var Checkbox = vue.defineComponent({
     };
   }
 });
+var Switch = vue.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 = vue.ref(props.defaultChecked);
+    const currentChecked = vue.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 vue.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
+      }, [
+        vue.h("div", { class: "oods-switch__row" }, [
+          vue.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
+          }, [vue.h("span", { class: "oods-switch__thumb", "aria-hidden": "true" })]),
+          vue.h("label", { id: `${controlId}-label`, class: "oods-field-label oods-switch__label", for: controlId }, [
+            label,
+            props.required ? vue.h("span", { class: "oods-field-required", "aria-hidden": "true" }, "*") : null
+          ])
+        ]),
+        help ? vue.h("p", { id: metadata.helpId.value, class: "oods-field-help" }, help) : null,
+        validation ? vue.h("p", {
+          id: metadata.validationId.value,
+          class: "oods-field-error",
+          role: props.validation?.state === "error" ? "alert" : void 0
+        }, validation) : null
+      ]);
+    };
+  }
+});
 var TableCaption = vue.defineComponent({
   name: "OodsTableCaption",
   setup(_props, { slots }) {
@@ -1771,6 +1932,8 @@ var Table = vue.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" },
@@ -1787,7 +1950,7 @@ var Table = vue.defineComponent({
       "data-oods-component": "Table",
       "data-density": props.density
     }, [
-      slots.caption || props.caption ? vue.h(TableCaption, {}, {
+      slots.caption || props.caption ? vue.h(TableCaption, { "data-visually-hidden": props.showCaption ? void 0 : "true" }, {
         default: () => slots.caption?.() ?? props.caption
       }) : null,
       vue.h(TableHead, {}, {
@@ -2005,82 +2168,6 @@ var Tabs = vue.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);
 }
@@ -2097,18 +2184,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 = componentContracts.getStatusPresentation(domain.toLowerCase(), status);
+  return {
+    label: statusLabel2(status || "Unknown"),
+    description: presentation.description,
+    tone: presentation.tone,
+    icon: componentContracts.resolveStatusIcon(presentation.iconName)
+  };
 }
 function formatPrice(amountCents, amount, currency) {
   const normalizedAmount = amount;
@@ -2252,11 +2334,10 @@ var StatusBadge = vue.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);
     };
   }
 });
@@ -2569,7 +2650,7 @@ var SearchInput = vue.defineComponent({
           "aria-label": "Clear search",
           disabled: props.disabled,
           onClick: clear
-        }, "\xD7") : null
+        }, [statusIcon("x")]) : null
       ]);
     };
   }
@@ -2716,17 +2797,18 @@ var RelativeTimestamp = vue.defineComponent({
         props.createdAt
       ) ?? "";
       if (props.hideWhenEmpty && (!datetime || Number.isNaN(Date.parse(datetime)))) return null;
+      const absolute = componentContracts.formatDateTime(datetime, { timeZone: props.timezone });
       const content = firstDefined(
         props.relative,
         props.label,
         props.text,
-        props.now === void 0 ? componentContracts.formatDateTime(datetime, { timeZone: props.timezone }) : relativeTimestampLabel(datetime, props.now)
+        !absolute ? "Unknown time" : props.now === void 0 ? absolute : relativeTimestampLabel(datetime, props.now)
       ) ?? "";
       return vue.h("time", {
         ...attrs,
         class: mergedClass("oods-relative-timestamp", attrs.class),
         datetime: datetime || void 0,
-        title: stringValue(attrs.title) ?? componentContracts.formatDateTime(datetime, { timeZone: props.timezone }),
+        title: stringValue(attrs.title) ?? absolute,
         "data-oods-component": "RelativeTimestamp"
       }, content);
     };
@@ -2974,7 +3056,7 @@ function summary(id) {
   } });
 }
 function preview(id, type) {
-  return vue.defineComponent({ name: id, props: { svg: String, svgNarrow: String, svgWide: String, title: String, description: String, width: Number, height: Number }, setup(props, { slots }) {
+  return vue.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 () => vue.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 ?? (() => vue.h(Text, { content: "No rendered chart supplied" })) });
   } });
 }
@@ -3040,6 +3122,7 @@ exports.CommunicationDetailPanel = CommunicationDetailPanel;
 exports.CycleProgressCard = CycleProgressCard;
 exports.DatePicker = DatePicker;
 exports.DetailHeader = DetailHeader;
+exports.Dialog = Dialog;
 exports.FilterPanel = FilterPanel;
 exports.FormLabelGroup = FormLabelGroup;
 exports.GeoFieldMappingForm = GeoFieldMappingForm;
@@ -3078,6 +3161,7 @@ exports.StatusBadge = StatusBadge;
 exports.StatusColorLegend = StatusColorLegend;
 exports.StatusSelector = StatusSelector;
 exports.StatusTimeline = StatusTimeline;
+exports.Switch = Switch;
 exports.Table = Table;
 exports.TableBody = TableBody;
 exports.TableCaption = TableCaption;