@watermarkinsights/ripple 0.0.1 → 0.1.0-alpha.1

package/dist/docs/props-reference.json

@@ -0,0 +1,2079 @@
+[
+  {
+    "tag": "wm-action-menu",
+    "description": "Dropdown interface that displays a list of action items. When closed it shows a text\nbutton, icon button, or selector box depending on action-menu-type. Selecting an item\nexecutes an action and closes the menu. Composed of a parent wm-action-menu element and\none or more wm-menuitem children.",
+    "props": [
+      {
+        "name": "actionMenuType",
+        "attribute": "action-menu-type",
+        "type": "\"icon\" | \"selector\" | \"selector-primary\" | \"text\"",
+        "default": "\"icon\"",
+        "required": false
+      },
+      {
+        "name": "buttonText",
+        "attribute": "button-text",
+        "type": "string | undefined",
+        "required": false,
+        "conditionallyRequired": "when action-menu-type is 'text', 'selector', or 'selector-primary'"
+      },
+      {
+        "name": "darkMode",
+        "attribute": "dark-mode",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "icon",
+        "attribute": "icon",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "iconFlip",
+        "attribute": "icon-flip",
+        "type": "\"horizontal\" | \"vertical\" | undefined",
+        "required": false
+      },
+      {
+        "name": "iconRotate",
+        "attribute": "icon-rotate",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "iconSize",
+        "attribute": "icon-size",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "labelForIdenticalButtons",
+        "attribute": "label-for-identical-buttons",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "maxWidth",
+        "attribute": "max-width",
+        "type": "string",
+        "default": "\"25.875rem\"",
+        "required": false
+      },
+      {
+        "name": "tooltip",
+        "attribute": "tooltip",
+        "type": "string | undefined",
+        "required": false,
+        "conditionallyRequired": "when action-menu-type is 'icon'"
+      },
+      {
+        "name": "tooltipPosition",
+        "attribute": "tooltip-position",
+        "type": "\"bottom\" | \"bottom-left\" | \"bottom-right\" | \"left\" | \"right\" | \"top\" | \"top-left\" | \"top-right\" | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-button",
+    "description": "Interactive button element that triggers actions and workflows. Has seven visual\ntypes plus AI variants.",
+    "props": [
+      {
+        "name": "ariaExpandedPassthrough",
+        "attribute": "aria-expanded-passthrough",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "ariaLabelPassthrough",
+        "attribute": "aria-label-passthrough",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "buttonType",
+        "attribute": "button-type",
+        "type": "\"icononly\" | \"icononly-ai\" | \"navigational\" | \"navigational-ai\" | \"pairnegative\" | \"pairpositive\" | \"primary\" | \"primary-ai\" | \"secondary\" | \"secondary-ai\" | \"selector\" | \"selector-primary\" | \"textonly\" | \"textonly-ai\"",
+        "default": "\"secondary\"",
+        "required": false
+      },
+      {
+        "name": "customBackground",
+        "attribute": "custom-background",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "icon",
+        "attribute": "icon",
+        "type": "string | undefined",
+        "required": false,
+        "conditionallyRequired": "when button-type is 'icononly' or 'navigational' (conditionallyRequired means that the prop is required, but only if the button-type is 'icononly' or 'navigational')"
+      },
+      {
+        "name": "iconFlip",
+        "attribute": "icon-flip",
+        "type": "\"horizontal\" | \"vertical\" | undefined",
+        "required": false
+      },
+      {
+        "name": "iconRotate",
+        "attribute": "icon-rotate",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "iconSize",
+        "attribute": "icon-size",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "isSubmit",
+        "attribute": "is-submit",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "labelForIdenticalButtons",
+        "attribute": "label-for-identical-buttons",
+        "type": "string | undefined",
+        "required": false,
+        "conditionallyRequired": "when multiple buttons on the same page share identical visible text or identical tooltips (conditionallyRequired means that the prop is required, but only if multiple buttons on the same page share identical visible text or identical tooltips)"
+      },
+      {
+        "name": "permanentlyDelete",
+        "attribute": "permanently-delete",
+        "type": "boolean | undefined",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "textWrap",
+        "attribute": "text-wrap",
+        "type": "boolean",
+        "default": "true",
+        "required": false
+      },
+      {
+        "name": "tooltip",
+        "attribute": "tooltip",
+        "type": "string | undefined",
+        "required": false,
+        "conditionallyRequired": "when button-type is 'icononly' or 'navigational' (conditionallyRequired means that the prop is required, but only if the button-type is 'icononly' or 'navigational')"
+      },
+      {
+        "name": "tooltipPosition",
+        "attribute": "tooltip-position",
+        "type": "\"bottom\" | \"bottom-left\" | \"bottom-right\" | \"left\" | \"right\" | \"top\" | \"top-left\" | \"top-right\"",
+        "default": "\"bottom-right\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-chart",
+    "description": "Composition chart component rendering doughnut or stacked bar charts. Composed of a parent\nwm-chart element and wm-chart-slice children. Has 3 doughnut subtypes and 5 bar subtypes,\neach designed for a specific composition use case.\n\n**Important:** The bar subtypes (`bar2`–`bar7`) are COMPOSITION patterns — they show parts\nof a whole for specific qualitative use cases. They are NOT general-purpose bar charts. For\ngeneral comparison or distribution bar charts, use wm-chart-bar or wm-chart-column instead.",
+    "props": [
+      {
+        "name": "chartType",
+        "attribute": "chart-type",
+        "type": "\"bar\" | \"bar2\" | \"bar3\" | \"bar4\" | \"bar5\" | \"bar6\" | \"bar7\" | \"doughnut\" | \"doughnut1\" | \"doughnut2\" | \"doughnut3\"",
+        "default": "\"doughnut1\"",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string | undefined",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "labelWidth",
+        "attribute": "label-width",
+        "type": "string",
+        "default": "\"150px\"",
+        "required": false
+      },
+      {
+        "name": "notStartedColor",
+        "attribute": "not-started-color",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "printMode",
+        "attribute": "print-mode",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "printModeFormat",
+        "attribute": "print-mode-format",
+        "type": "\"amount\" | \"percentage\"",
+        "default": "\"amount\"",
+        "required": false
+      },
+      {
+        "name": "showBarLegend",
+        "attribute": "show-bar-legend",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "showGrid",
+        "attribute": "show-grid",
+        "type": "boolean | undefined",
+        "default": "true",
+        "required": false
+      },
+      {
+        "name": "showLegend",
+        "attribute": "show-legend",
+        "type": "boolean",
+        "default": "true",
+        "required": false
+      },
+      {
+        "name": "subinfo",
+        "attribute": "subinfo",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "valueFormat",
+        "attribute": "value-format",
+        "type": "\"amount\" | \"none\" | \"percentage\"",
+        "default": "\"none\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-chart-bar",
+    "description": "Renders a horizontal bar chart for comparing values across nominal categories. Data and\nconfiguration are set via JavaScript properties (`chart.config` and `chart.data`) — not\nHTML attributes. Supports single-color, discrete palette, semantic palette, and grouped bars.\n\n**Preferred** over wm-chart's bar subtypes for all comparison and distribution use cases.\nUse this component (or wm-chart-column) instead of `<wm-chart chart-type=\"bar*\">`.",
+    "props": [
+      {
+        "name": "config",
+        "type": "undefined | { label: string; showLabel: boolean; valueAxisLabel: string; categoryAxisLabel: string; printMode: boolean; printModeFormat: \"amount\" | \"percentage\"; gridMax: number | \"auto\"; sort?: \"ascending\" | \"descending\" | \"none\" | undefined; showLegend?: \"top\" | \"bottom\" | \"left\" | \"right\" | \"none\" | undefined; showGrid?: boolean | undefined; subinfo?: string | undefined; valueFormat?: \"amount\" | \"percentage\" | \"none\" | undefined; colors?: string | undefined; popoverTitle?: string | undefined; popoverText?: string | undefined; popoverButtonText?: string | undefined; decimalPlaces?: number | undefined; patternMode?: boolean | undefined; }",
+        "required": false
+      },
+      {
+        "name": "data",
+        "type": "ChartData[] | undefined",
+        "required": false
+      },
+      {
+        "name": "patternMode",
+        "attribute": "pattern-mode",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "printMode",
+        "attribute": "print-mode",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "subinfo",
+        "attribute": "subinfo",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-chart-column",
+    "description": "Renders a vertical column chart for comparing values across nominal categories or showing\ndistribution across interval/ratio ranges. Data and configuration are set via JavaScript\nproperties (`chart.config` and `chart.data`) — not HTML attributes. Supports single-color,\ndiscrete palette, semantic palette, and grouped columns.\n\n**Preferred** over wm-chart's bar subtypes for comparison and distribution use cases.\nUse this component (or wm-chart-bar) instead of `<wm-chart chart-type=\"bar*\">`. When\ncolumns exceed available width, the chart scrolls horizontally.",
+    "props": [
+      {
+        "name": "config",
+        "type": "undefined | { label: string; showLabel: boolean; valueAxisLabel: string; categoryAxisLabel: string; printMode: boolean; printModeFormat: \"amount\" | \"percentage\"; gridMax: number | \"auto\"; sort?: \"ascending\" | \"descending\" | \"none\" | undefined; showLegend?: \"top\" | \"bottom\" | \"left\" | \"right\" | \"none\" | undefined; showGrid?: boolean | undefined; subinfo?: string | undefined; valueFormat?: \"amount\" | \"percentage\" | \"none\" | undefined; colors?: string | undefined; popoverTitle?: string | undefined; popoverText?: string | undefined; popoverButtonText?: string | undefined; decimalPlaces?: number | undefined; patternMode?: boolean | undefined; }",
+        "required": false
+      },
+      {
+        "name": "data",
+        "type": "ChartData[] | undefined",
+        "required": false
+      },
+      {
+        "name": "patternMode",
+        "attribute": "pattern-mode",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "printMode",
+        "attribute": "print-mode",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "printWidth",
+        "attribute": "print-width",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "subinfo",
+        "attribute": "subinfo",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-chart-legend",
+    "description": "External legend component for wm-chart-bar and wm-chart-column. Retrieves color and label\ndata from one or more charts via element IDs, allowing a single legend to serve multiple\ncharts. Hidden from screen readers — relevant data is announced when the user interacts with\nthe associated chart directly.\n\nFor simple single-chart scenarios, the `config.showLegend` option on wm-chart-bar or\nwm-chart-column renders an internal legend without requiring this element. Use\nwm-chart-legend when sharing one legend across multiple charts or when external placement\nis required.",
+    "props": [
+      {
+        "name": "chartIds",
+        "attribute": "chart-ids",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "orientation",
+        "attribute": "orientation",
+        "type": "\"horizontal\" | \"vertical\"",
+        "default": "\"horizontal\"",
+        "required": false
+      },
+      {
+        "name": "printMode",
+        "attribute": "print-mode",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-chart-slice",
+    "description": "Data slice for a wm-chart composition chart. Each slice represents one segment of the whole.\nAlways used as a direct child of wm-chart.",
+    "props": [
+      {
+        "name": "amount",
+        "attribute": "amount",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "legend",
+        "attribute": "legend",
+        "type": "string | undefined",
+        "required": true
+      },
+      {
+        "name": "popoverButtonText",
+        "attribute": "popover-button-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "popoverText",
+        "attribute": "popover-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "popoverTitle",
+        "attribute": "popover-title",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-chart-stack",
+    "description": "Renders a horizontal stacked bar chart: each stack's segments are sized as a percentage of\nthat stack's total. Supports any number of stacks and segments, each occupying their own row.\nData and configuration are set via JavaScript properties (`chart.config` and `chart.data`) — not\nHTML attributes.",
+    "props": [
+      {
+        "name": "config",
+        "type": "undefined | { label: string; subinfo?: string | undefined; popoverTitle?: string | undefined; popoverText?: string | undefined; popoverButtonText?: string | undefined; colors?: \"discrete\" | \"semantic\" | undefined; showLabel?: boolean | undefined; showLegend?: \"top\" | \"bottom\" | \"left\" | \"right\" | \"none\" | undefined; showGrid?: boolean | undefined; valueFormat?: \"percentage\" | \"none\" | undefined; printMode?: boolean | undefined; patternMode?: boolean | undefined; }",
+        "required": false
+      },
+      {
+        "name": "data",
+        "type": "StackSegmentData[] | undefined",
+        "required": false
+      },
+      {
+        "name": "patternMode",
+        "attribute": "pattern-mode",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "printMode",
+        "attribute": "print-mode",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "subinfo",
+        "attribute": "subinfo",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-date-range",
+    "description": "Two linked date inputs (start and end) with a shared calendar popup for selecting a date\nrange. Users can type or click to set each date. Provides separate error states for start\nand end, and emits distinct blur events for each input. Use instead of two native\n`<input type=\"date\">` elements when a range is required.",
+    "props": [
+      {
+        "name": "dateFormat",
+        "attribute": "date-format",
+        "type": "string",
+        "default": "\"mm/dd/yyyy\"",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "invalidEnd",
+        "attribute": "invalid-end",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "invalidStart",
+        "attribute": "invalid-start",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "labelEnd",
+        "attribute": "label-end",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "labelStart",
+        "attribute": "label-start",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "preselected",
+        "attribute": "preselected",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "valueEnd",
+        "attribute": "value-end",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "valueStart",
+        "attribute": "value-start",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-datepicker",
+    "description": "Date input that lets users type a date or pick one from a calendar popup. Supports\nconfigurable date formats, pre-selection, validation, and full keyboard navigation of the calendar.\nUse instead of native `<input type=\"date\">`.",
+    "props": [
+      {
+        "name": "dateFormat",
+        "attribute": "date-format",
+        "type": "string",
+        "default": "\"mm/dd/yyyy\"",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "preselected",
+        "attribute": "preselected",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "value",
+        "attribute": "value",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-file",
+    "description": "Displays a single file row with its name, optional metadata, and configurable action buttons\n(preview, download, delete). Adapts responsively — at narrow widths action buttons collapse\ninto an action menu. Used as a child of wm-file-list or wm-uploader.",
+    "props": [
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "fileActions",
+        "attribute": "file-actions",
+        "type": "string",
+        "default": "\"download delete\"",
+        "required": false
+      },
+      {
+        "name": "lastUpdated",
+        "attribute": "last-updated",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "name",
+        "attribute": "name",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "progress",
+        "attribute": "progress",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "showInfo",
+        "attribute": "show-info",
+        "type": "\"all\" | \"last-updated\" | \"none\" | \"size\" | \"time\" | \"uploaded-by\" | undefined",
+        "default": "\"last-updated\"",
+        "required": false
+      },
+      {
+        "name": "size",
+        "attribute": "size",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "type",
+        "attribute": "type",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "uploadedBy",
+        "attribute": "uploaded-by",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-file-list",
+    "description": "Read-only list of files with optional preview and download actions. Visually similar to the\nUploader but with no upload capability. Use when displaying existing files users can view or\ndownload, not when they need to upload new ones.",
+    "props": [
+      {
+        "name": "showInfo",
+        "attribute": "show-info",
+        "type": "\"all\" | \"last-updated\" | \"none\" | \"size\" | \"uploaded-by\"",
+        "default": "\"last-updated\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-flyout",
+    "description": "Slide-in panel that renders over the main content as a modal dialog. Used for detail views,\nmulti-step workflows, and forms that require focus without navigating away from the page.",
+    "props": [
+      {
+        "name": "breadcrumb",
+        "attribute": "breadcrumb",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "elementToFocus",
+        "attribute": "element-to-focus",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "eyebrow",
+        "attribute": "eyebrow",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "flyoutWidth",
+        "attribute": "flyout-width",
+        "type": "string",
+        "default": "\"45rem\"",
+        "required": false
+      },
+      {
+        "name": "heading",
+        "attribute": "heading",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "infoText",
+        "attribute": "info-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "open",
+        "attribute": "open",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "primaryText",
+        "attribute": "primary-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "secondaryText",
+        "attribute": "secondary-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "subheading",
+        "attribute": "subheading",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-input",
+    "description": "Accessible single-line text input. Supports text and number types, character limits,\nsymbol prefixes/suffixes, and inline info/error messaging. Use instead of a native\n`<input>` in all Watermark UI.",
+    "props": [
+      {
+        "name": "characterLimit",
+        "attribute": "character-limit",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "info",
+        "attribute": "info",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "inputWidth",
+        "attribute": "input-width",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "isSubmit",
+        "attribute": "is-submit",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "max",
+        "attribute": "max",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "min",
+        "attribute": "min",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "placeholder",
+        "attribute": "placeholder",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "step",
+        "attribute": "step",
+        "type": "number | undefined",
+        "default": "1",
+        "required": false
+      },
+      {
+        "name": "symbolAfter",
+        "attribute": "symbol-after",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "symbolBefore",
+        "attribute": "symbol-before",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "textAfter",
+        "attribute": "text-after",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "type",
+        "attribute": "type",
+        "type": "\"number\" | \"text\"",
+        "default": "\"text\"",
+        "required": false
+      },
+      {
+        "name": "value",
+        "attribute": "value",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-line-chart",
+    "description": "Visualizes how data changes over time. Ideal for trend analysis — tracking one or more\nmetrics across chronological intervals such as semesters, academic years, or months.\nSupports up to 7 lines, each differentiated by both color and symbol. Data is set via the\n`line-data` prop (JSON string or object). Minimum width of 562 px; horizontally scrollable\nat smaller viewports.",
+    "props": [
+      {
+        "name": "decimalPlaces",
+        "attribute": "decimal-places",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "description",
+        "attribute": "description",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "highlightEnd",
+        "attribute": "highlight-end",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "highlightQualifier",
+        "attribute": "highlight-qualifier",
+        "type": "string",
+        "default": "lineChartMessages.highlightQualifier",
+        "required": false
+      },
+      {
+        "name": "highlightStart",
+        "attribute": "highlight-start",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "labelWidth",
+        "attribute": "label-width",
+        "type": "string",
+        "default": "\"120px\"",
+        "required": false
+      },
+      {
+        "name": "lineData",
+        "attribute": "line-data",
+        "type": "string | { [lineLabel: string]: Line; }",
+        "required": true
+      },
+      {
+        "name": "showDeltas",
+        "attribute": "show-deltas",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "showGrid",
+        "attribute": "show-grid",
+        "type": "boolean",
+        "default": "true",
+        "required": false
+      },
+      {
+        "name": "spotlightData",
+        "type": "SpotlightData | undefined",
+        "required": false
+      },
+      {
+        "name": "units",
+        "attribute": "units",
+        "type": "string",
+        "default": "\"null,null\"",
+        "required": false
+      },
+      {
+        "name": "visibilityToggles",
+        "attribute": "visibility-toggles",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "xAxisLabel",
+        "attribute": "x-axis-label",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "yAxisLabel",
+        "attribute": "y-axis-label",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "yRange",
+        "attribute": "y-range",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-menuitem",
+    "description": "A single item within a wm-action-menu dropdown. Always used as a direct child of\nwm-action-menu — never rendered in isolation.",
+    "props": [
+      {
+        "name": "description",
+        "attribute": "description",
+        "type": "string | undefined",
+        "default": "undefined",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "icon",
+        "attribute": "icon",
+        "type": "string | undefined",
+        "default": "undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-modal",
+    "description": "Modal dialog that overlays the page. Renders as a full-bleed `modal` (default) or a\nsmaller centered `dialog`. Content is provided through wm-modal-header, wm-modal-footer,\nand arbitrary slotted children.",
+    "props": [
+      {
+        "name": "elementToFocus",
+        "attribute": "element-to-focus",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "modalType",
+        "attribute": "modal-type",
+        "type": "\"dialog\" | \"modal\"",
+        "default": "\"modal\"",
+        "required": false
+      },
+      {
+        "name": "open",
+        "attribute": "open",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "uid",
+        "attribute": "uid",
+        "type": "string",
+        "required": true
+      }
+    ]
+  },
+  {
+    "tag": "wm-modal-footer",
+    "description": "Footer section for a wm-modal. Renders a primary action button, an optional secondary\nbutton, and optional informational text. Button clicks delegate to the parent modal's\n`emitPrimaryEvent()` and `emitSecondaryEvent()` methods, which fire\n`wmModalPrimaryTriggered` and `wmModalSecondaryTriggered` respectively. Always used as a\ndirect child of wm-modal — never rendered in isolation.",
+    "props": [
+      {
+        "name": "deleteStyle",
+        "attribute": "delete-style",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "infoText",
+        "attribute": "info-text",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "primaryActionDisabled",
+        "attribute": "primary-action-disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "primaryText",
+        "attribute": "primary-text",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "secondaryText",
+        "attribute": "secondary-text",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-modal-header",
+    "description": "Header section for a wm-modal. Renders the modal title, an optional subheading, and the\nclose button. Always used as a direct child of wm-modal — never rendered in isolation.",
+    "props": [
+      {
+        "name": "heading",
+        "attribute": "heading",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "subheading",
+        "attribute": "subheading",
+        "type": "string | undefined",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-navigation",
+    "description": "Sidebar navigation that collapses into a hamburger menu on viewports narrower than 1024px.\nContains wm-navigation-item children and works alongside an external wm-navigation-hamburger\ntoggle. Must be placed in the DOM after `<header>` and before `<main>`.",
+    "props": [
+      {
+        "name": "open",
+        "attribute": "open",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-navigation-hamburger",
+    "description": "Toggle button for the collapsible wm-navigation sidebar. Renders a hamburger/menu icon\nbutton that communicates with wm-navigation via window events. Place immediately before\nthe associated wm-navigation element in the DOM.",
+    "props": [
+      {
+        "name": "navId",
+        "attribute": "nav-id",
+        "type": "string | undefined",
+        "required": true
+      }
+    ]
+  },
+  {
+    "tag": "wm-navigation-item",
+    "description": "A single navigation link inside a wm-navigation. Renders as an anchor element with an\noptional icon slot. Always used as a direct child of wm-navigation.",
+    "props": [
+      {
+        "name": "active",
+        "attribute": "active",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "href",
+        "attribute": "href",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "text",
+        "attribute": "text",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-navigator",
+    "description": "User account menu that displays the logged-in user's name, email, and a product switcher\nfor navigating between Watermark applications. Renders as a button that opens a dropdown\nlisting available products and a logout option.",
+    "props": [
+      {
+        "name": "authType",
+        "attribute": "auth-type",
+        "type": "number",
+        "default": "1",
+        "required": false,
+        "conditionallyRequired": "when load-from-userinfo is false and products are provided"
+      },
+      {
+        "name": "connectionName",
+        "attribute": "connection-name",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "email",
+        "attribute": "email",
+        "type": "string | undefined",
+        "required": false,
+        "conditionallyRequired": "when load-from-userinfo is false"
+      },
+      {
+        "name": "loadFromUserinfo",
+        "attribute": "load-from-userinfo",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "logoutUrl",
+        "attribute": "logout-url",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "products",
+        "attribute": "products",
+        "type": "[] | string | undefined",
+        "required": false
+      },
+      {
+        "name": "userName",
+        "attribute": "user-name",
+        "type": "string | undefined",
+        "required": true
+      }
+    ]
+  },
+  {
+    "tag": "wm-nested-select",
+    "description": "Dropdown list of grouped options that allows single or multi-select. Like wm-select but\noptions are organized into labeled categories via a two-level hierarchy. Composed of a\nparent wm-nested-select, one or more wm-optgroup children, and wm-option elements inside\neach group.",
+    "props": [
+      {
+        "name": "allSelectedMessage",
+        "attribute": "all-selected-message",
+        "type": "string",
+        "default": "selectMessages.allSelected",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string | undefined",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "maxHeight",
+        "attribute": "max-height",
+        "type": "string",
+        "default": "\"200px\"",
+        "required": false
+      },
+      {
+        "name": "multiple",
+        "attribute": "multiple",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "placeholder",
+        "attribute": "placeholder",
+        "type": "string",
+        "default": "this.multiple ? selectMessages.multiPlaceholder : selectMessages.singlePlaceholder",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "search",
+        "attribute": "search",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "searchPlaceholder",
+        "attribute": "search-placeholder",
+        "type": "string",
+        "default": "selectMessages.searchPlaceholder",
+        "required": false
+      },
+      {
+        "name": "selectAll",
+        "attribute": "select-all",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-optgroup",
+    "description": "Named group of wm-option elements used inside wm-nested-select. Renders as a slide-in\npanel that appears when the user selects the group from the top-level menu.",
+    "props": [
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "required": true
+      }
+    ]
+  },
+  {
+    "tag": "wm-option",
+    "description": "Individual selectable item used inside wm-select, wm-nested-select (via wm-optgroup), and\nwm-optgroup. Renders as a listbox option with optional secondary text.",
+    "props": [
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "selected",
+        "attribute": "selected",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "subinfo",
+        "attribute": "subinfo",
+        "type": "string | undefined",
+        "default": "undefined",
+        "required": false
+      },
+      {
+        "name": "value",
+        "attribute": "value",
+        "type": "null | string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-pagination",
+    "description": "Pagination controls for navigating large data sets. Renders a full page-number strip on\nwider viewports and a minimal prev/next/first/last layout on narrow viewports. Does not\nrender at all when the total item count fits on a single page.",
+    "props": [
+      {
+        "name": "currentPage",
+        "attribute": "current-page",
+        "type": "number",
+        "default": "1",
+        "required": true
+      },
+      {
+        "name": "itemsPerPage",
+        "attribute": "items-per-page",
+        "type": "number | undefined",
+        "default": "undefined",
+        "required": true
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "totalItems",
+        "attribute": "total-items",
+        "type": "number | undefined",
+        "default": "undefined",
+        "required": true
+      },
+      {
+        "name": "value",
+        "attribute": "value",
+        "type": "number",
+        "default": "1",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-progress-indicator",
+    "description": "Single progress indicator used inside a wm-progress-monitor. Renders the binary completion\ndata for one category as either a doughnut chart (wide layout) or a horizontal bar (narrow\nlayout), switching automatically based on the parent monitor's breakpoint.\n\nMust contain EXACTLY TWO wm-progress-slice children — one for the \"complete\" state and one\nfor the \"incomplete\" state.",
+    "props": [
+      {
+        "name": "completionMessage",
+        "attribute": "completion-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string | undefined",
+        "required": true
+      },
+      {
+        "name": "printMode",
+        "attribute": "print-mode",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "printModeFormat",
+        "attribute": "print-mode-format",
+        "type": "\"amount\" | \"percentage\"",
+        "default": "\"amount\"",
+        "required": false
+      },
+      {
+        "name": "showLegend",
+        "attribute": "show-legend",
+        "type": "boolean",
+        "default": "true",
+        "required": false
+      },
+      {
+        "name": "subinfo",
+        "attribute": "subinfo",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-progress-monitor",
+    "description": "Container for one or more wm-progress-indicator elements, each showing binary completion\nprogress (e.g. \"Completed\" vs \"Not Completed\"). Above the layout breakpoint, indicators\nrender as doughnuts in a horizontal row; below it, they collapse into horizontal bars in a\nvertical stack.\n\n**Strict constraints:**\n1. Each wm-progress-indicator must have EXACTLY TWO wm-progress-slice children — one for\n   the \"complete\" state and one for the \"incomplete\" state.\n2. This component is ONLY suitable for binary completion tracking. For more than two states,\n   general comparisons, composition breakdowns, or distributions, use wm-chart,\n   wm-chart-bar, or wm-chart-column.",
+    "props": [
+      {
+        "name": "barLabelsWidth",
+        "attribute": "bar-labels-width",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "breakpoint",
+        "attribute": "breakpoint",
+        "type": "number | string | undefined",
+        "required": false
+      },
+      {
+        "name": "groupLegend",
+        "attribute": "group-legend",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-progress-slice",
+    "description": "Data slice for a wm-progress-indicator. Represents one state (complete or incomplete) in\na binary progress chart. Always used as a direct child of wm-progress-indicator.\n\nEach wm-progress-indicator must contain EXACTLY TWO wm-progress-slice elements.",
+    "props": [
+      {
+        "name": "amount",
+        "attribute": "amount",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "legend",
+        "attribute": "legend",
+        "type": "string | undefined",
+        "required": true
+      },
+      {
+        "name": "popoverButtonText",
+        "attribute": "popover-button-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "popoverText",
+        "attribute": "popover-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "popoverTitle",
+        "attribute": "popover-title",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-search",
+    "description": "Search input for filtering data by query. Two variants: `'basic'` for simple text\nfiltering, and `'find'` which adds prev/next result navigation buttons, a result count\n(\"x of y results\"), and a keyboard-accessible \"jump to result\" link. The component does\nnot filter data itself — it exposes the user's query and result position via events and\nproperties for the application to handle.",
+    "props": [
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "highlightedId",
+        "attribute": "highlighted-id",
+        "type": "string",
+        "default": "\"\"",
+        "required": false,
+        "conditionallyRequired": "Required when `search-type=\"find\"`."
+      },
+      {
+        "name": "highlightedName",
+        "attribute": "highlighted-name",
+        "type": "null | string",
+        "default": "null",
+        "required": false,
+        "conditionallyRequired": "Required when `search-type=\"find\"`."
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "numResults",
+        "attribute": "num-results",
+        "type": "number",
+        "default": "0",
+        "required": false
+      },
+      {
+        "name": "placeholder",
+        "attribute": "placeholder",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "searchType",
+        "attribute": "search-type",
+        "type": "\"basic\" | \"find\"",
+        "default": "\"basic\"",
+        "required": false
+      },
+      {
+        "name": "value",
+        "attribute": "value",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-select",
+    "description": "Dropdown list of options that allows single or multi-select. Functionally similar to the\nnative HTML `<select>` element but with Ripple styling and richer features including\nmultiselect, search filtering, and a Select All control. Composed of a parent wm-select\nelement and wm-option children.",
+    "props": [
+      {
+        "name": "allSelectedMessage",
+        "attribute": "all-selected-message",
+        "type": "string",
+        "default": "selectMessages.allSelected",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "info",
+        "attribute": "info",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string | undefined",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "maxHeight",
+        "attribute": "max-height",
+        "type": "string",
+        "default": "\"200px\"",
+        "required": false
+      },
+      {
+        "name": "multiple",
+        "attribute": "multiple",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "placeholder",
+        "attribute": "placeholder",
+        "type": "string",
+        "default": "selectMessages.multiPlaceholder",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "search",
+        "attribute": "search",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "searchPlaceholder",
+        "attribute": "search-placeholder",
+        "type": "string",
+        "default": "selectMessages.searchPlaceholder",
+        "required": false
+      },
+      {
+        "name": "selectAll",
+        "attribute": "select-all",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-snackbar",
+    "description": "Toast notification stack that renders transient messages at the bottom of the page.\nNotifications auto-dismiss after 6 seconds unless they include a `link` or `action`, in\nwhich case they persist until explicitly dismissed or the user tabs past them.",
+    "props": [
+      {
+        "name": "notifications",
+        "attribute": "notifications",
+        "type": "string",
+        "default": "\"[]\"",
+        "required": true
+      }
+    ]
+  },
+  {
+    "tag": "wm-tab-item",
+    "description": "Individual tab button inside a wm-tab-list. Renders as a link with `role=\"tab\"` and\nmanages selection state. Always used as a direct child of wm-tab-list.",
+    "props": [
+      {
+        "name": "tabId",
+        "attribute": "tab-id",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      }
+    ]
+  },
+  {
+    "tag": "wm-tab-list",
+    "description": "Tab list container that manages a group of wm-tab-item children and their associated\nwm-tab-panel elements. Handles keyboard navigation, ARIA wiring between tabs and panels,\nhorizontal scroll with arrow buttons on overflow, and optional dark theme.",
+    "props": [
+      {
+        "name": "customBackground",
+        "attribute": "custom-background",
+        "type": "\"\" | \"dark\" | undefined",
+        "required": false
+      },
+      {
+        "name": "selectedTab",
+        "attribute": "selected-tab",
+        "type": "string | undefined",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-tab-panel",
+    "description": "Content panel associated with a wm-tab-item. Shows or hides based on whether its\n`tab-id` matches the selected tab in the parent wm-tab-list. Rendered with\n`role=\"tabpanel\"`. Always used alongside a wm-tab-list.",
+    "props": [
+      {
+        "name": "tabId",
+        "attribute": "tab-id",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      }
+    ]
+  },
+  {
+    "tag": "wm-tag-input",
+    "description": "Input for selecting or creating a list of tags. Two variants: `'dropdown'` (options in a\nfilterable list, supports creating new tags) and `'table'` (options in a filterable\nmulti-column table). Options are defined as wm-tag-option children. Selected options appear\nas removable tags above the search field.",
+    "props": [
+      {
+        "name": "addNew",
+        "attribute": "add-new",
+        "type": "boolean",
+        "default": "true",
+        "required": false
+      },
+      {
+        "name": "characterLimit",
+        "attribute": "character-limit",
+        "type": "number",
+        "default": "50",
+        "required": false
+      },
+      {
+        "name": "colHeaders",
+        "attribute": "col-headers",
+        "type": "string",
+        "required": true,
+        "conditionallyRequired": "Required when `tag-input-type=\"table\"`."
+      },
+      {
+        "name": "colWidths",
+        "attribute": "col-widths",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "colWrap",
+        "attribute": "col-wrap",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "helpText",
+        "attribute": "help-text",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "info",
+        "attribute": "info",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "maxTags",
+        "attribute": "max-tags",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "placeholder",
+        "attribute": "placeholder",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "tagInputType",
+        "attribute": "tag-input-type",
+        "type": "\"dropdown\" | \"table\"",
+        "default": "\"dropdown\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-tag-option",
+    "description": "Option element for wm-tag-input. Represents a selectable tag in the dropdown list or\ntable. Always used as a direct child of wm-tag-input. For the dropdown variant, slotted\ntext content is the tag label; for the table variant, use `col1`–`col4` props.",
+    "props": [
+      {
+        "name": "col1",
+        "attribute": "col1",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "col2",
+        "attribute": "col2",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "col3",
+        "attribute": "col3",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "col4",
+        "attribute": "col4",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "locked",
+        "attribute": "locked",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "selected",
+        "attribute": "selected",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-textarea",
+    "description": "Multi-line plain-text editing control with a drag handle for vertical resizing. Shares\nmost functionality with wm-input. Use instead of native `<textarea>` in all Watermark UI.",
+    "props": [
+      {
+        "name": "characterLimit",
+        "attribute": "character-limit",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "info",
+        "attribute": "info",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "inputHeight",
+        "attribute": "input-height",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "inputWidth",
+        "attribute": "input-width",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "placeholder",
+        "attribute": "placeholder",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "value",
+        "attribute": "value",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-timepicker",
+    "description": "Time input that lets users type a time or pick one from a dropdown list of 15-minute\nintervals. Supports 12-hour and 24-hour display and provides `reformatTime` and\n`isValidTime` utility methods. Use instead of native `<input type=\"time\">`.",
+    "props": [
+      {
+        "name": "disabled",
+        "attribute": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string",
+        "default": "\"\"",
+        "required": true
+      },
+      {
+        "name": "labelPosition",
+        "attribute": "label-position",
+        "type": "\"left\" | \"none\" | \"top\"",
+        "default": "\"top\"",
+        "required": false
+      },
+      {
+        "name": "preselected",
+        "attribute": "preselected",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean",
+        "default": "false",
+        "required": false
+      },
+      {
+        "name": "value",
+        "attribute": "value",
+        "type": "string",
+        "default": "\"\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-toggletip",
+    "description": "Toggletip button that shows a small informational panel when clicked. Two visual types:\n`'info'` renders an info icon button; `'ai'` renders an animated AI sparkle icon. The\npanel content is provided via the `tooltip` prop and is announced to screen readers via\nan `aria-live` region.",
+    "props": [
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string | undefined",
+        "required": true
+      },
+      {
+        "name": "targetSize",
+        "attribute": "target-size",
+        "type": "\"large\" | \"small\"",
+        "default": "\"small\"",
+        "required": false
+      },
+      {
+        "name": "toggletipType",
+        "attribute": "toggletip-type",
+        "type": "\"ai\" | \"info\"",
+        "default": "\"info\"",
+        "required": false
+      },
+      {
+        "name": "tooltip",
+        "attribute": "tooltip",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "tooltipPosition",
+        "attribute": "tooltip-position",
+        "type": "\"bottom\" | \"bottom-left\" | \"bottom-right\" | \"left\" | \"right\" | \"top\" | \"top-left\" | \"top-right\"",
+        "default": "\"bottom-right\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-uploader",
+    "description": "File upload component for attaching files. Composed of a trigger button and a list of\nwm-file children. Two variants: `'select'` opens the browser file picker; `'drop'` adds a\ndrag-and-drop area. The component emits events when files are selected and when file\nactions are triggered — the application is responsible for validation, upload, and managing\nthe file list. Use wm-file-list instead when displaying files without uploading.",
+    "props": [
+      {
+        "name": "buttonText",
+        "attribute": "button-text",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "dropArea",
+        "attribute": "drop-area",
+        "type": "\"component\" | \"page\"",
+        "default": "\"component\"",
+        "required": false
+      },
+      {
+        "name": "errorMessage",
+        "attribute": "error-message",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "fileTypes",
+        "attribute": "file-types",
+        "type": "string",
+        "default": "\"pdf txt log xml doc docx xls xlsx ppt pptx gif jpg jpeg png csv\"",
+        "required": false
+      },
+      {
+        "name": "icon",
+        "attribute": "icon",
+        "type": "string",
+        "required": true
+      },
+      {
+        "name": "label",
+        "attribute": "label",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "maxFiles",
+        "attribute": "max-files",
+        "type": "number | undefined",
+        "required": false
+      },
+      {
+        "name": "maxSize",
+        "attribute": "max-size",
+        "type": "string | undefined",
+        "required": false
+      },
+      {
+        "name": "requiredField",
+        "attribute": "required-field",
+        "type": "boolean | undefined",
+        "required": false
+      },
+      {
+        "name": "showInfo",
+        "attribute": "show-info",
+        "type": "\"none\" | \"size\" | \"time\"",
+        "default": "\"time\"",
+        "required": false
+      },
+      {
+        "name": "uploaderType",
+        "attribute": "uploader-type",
+        "type": "\"drop\" | \"select\"",
+        "default": "\"select\"",
+        "required": false
+      }
+    ]
+  },
+  {
+    "tag": "wm-wrapper",
+    "props": []
+  }
+]