@watermarkinsights/ripple 5.31.0-alpha.4 → 5.31.0-alpha.5

package/dist/cjs/{app-globals-c5dc38bb.js → app-globals-77259a15.js}

@@ -2,7 +2,7 @@
 
 require('./index-bb947bd5.js');
 
-const version = "5.31.0-alpha.4";
+const version = "5.31.0-alpha.5";
 
 // PRINT RIPPLE VERSION IN CONSOLE
 // test envs return 0 for plugin.length

package/dist/cjs/loader.cjs.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-bb947bd5.js');
-const appGlobals = require('./app-globals-c5dc38bb.js');
+const appGlobals = require('./app-globals-77259a15.js');
 
 const defineCustomElements = async (win, options) => {
   if (typeof window === 'undefined') return undefined;

package/dist/cjs/ripple.cjs.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-bb947bd5.js');
-const appGlobals = require('./app-globals-c5dc38bb.js');
+const appGlobals = require('./app-globals-77259a15.js');
 
 /*
  Stencil Client Patch Browser v4.21.0 | MIT Licensed | https://stenciljs.com

package/dist/cjs/wm-action-menu_2.cjs.entry.js

@@ -475,7 +475,7 @@ const Menuitem = class {
         }
     }
     render() {
-        return (index.h(index.Host, { key: 'bba02970ceda1fe78026e8653bee4549b05698df', tabindex: -1, role: "menuitem", "aria-disabled": this.disabled ? "true" : null }, index.h("div", { key: '28b699ff8e174ce427ef1f31cab36ad1eed50ac7', class: "wrapper", "aria-disabled": this.disabled ? "true" : null }, index.h("div", { key: '8d93236530ede11b7fbdfecd75f98ba7b467240f', class: "main-text" }, this.icon && this.renderIcon(), this.el.textContent), this.description ? index.h("div", { class: "description" }, this.description) : "")));
+        return (index.h(index.Host, { key: '403704be13ca1f9c938e18a76f8442cbbaa4aab9', tabindex: -1, role: "menuitem", "aria-disabled": this.disabled ? "true" : null }, index.h("div", { key: 'c5818b2f8bd133a846abcd493f70c581b9d7113b', class: "wrapper", "aria-disabled": this.disabled ? "true" : null }, index.h("div", { key: '05f047e1ffad3376e1aaeffd060ed52a6a3e80bf', class: "main-text" }, this.icon && this.renderIcon(), this.el.textContent), this.description ? index.h("div", { class: "description" }, this.description) : "")));
     }
     get el() { return index.getElement(this); }
     static get watchers() { return {

package/dist/collection/components/wm-menuitem/wm-menuitem.js

@@ -8,9 +8,6 @@ import { getIconCodeFromName } from "../../global/interfaces";
  *
  * @accessibility
  * - Rendered with `role="menuitem"` and `aria-disabled` when disabled.
- * - Keyboard events (Arrow keys, Home, End, Tab, Escape, character keys) are captured and
- *   re-emitted as custom events consumed by the parent wm-action-menu to manage focus and
- *   menu state — do not listen to these events directly in application code.
  *
  * @usageNotes
  * - `description` is limited to 100 characters and is incompatible with `icon`.
@@ -137,7 +134,7 @@ export class Menuitem {
         }
     }
     render() {
-        return (h(Host, { key: 'bba02970ceda1fe78026e8653bee4549b05698df', tabindex: -1, role: "menuitem", "aria-disabled": this.disabled ? "true" : null }, h("div", { key: '28b699ff8e174ce427ef1f31cab36ad1eed50ac7', class: "wrapper", "aria-disabled": this.disabled ? "true" : null }, h("div", { key: '8d93236530ede11b7fbdfecd75f98ba7b467240f', class: "main-text" }, this.icon && this.renderIcon(), this.el.textContent), this.description ? h("div", { class: "description" }, this.description) : "")));
+        return (h(Host, { key: '403704be13ca1f9c938e18a76f8442cbbaa4aab9', tabindex: -1, role: "menuitem", "aria-disabled": this.disabled ? "true" : null }, h("div", { key: 'c5818b2f8bd133a846abcd493f70c581b9d7113b', class: "wrapper", "aria-disabled": this.disabled ? "true" : null }, h("div", { key: '05f047e1ffad3376e1aaeffd060ed52a6a3e80bf', class: "main-text" }, this.icon && this.renderIcon(), this.el.textContent), this.description ? h("div", { class: "description" }, this.description) : "")));
     }
     static get is() { return "wm-menuitem"; }
     static get encapsulation() { return "shadow"; }
@@ -252,7 +249,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -272,7 +272,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -292,7 +295,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -312,7 +318,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -332,7 +341,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -352,7 +364,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -372,7 +387,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -392,7 +410,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -412,7 +433,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {
@@ -427,7 +451,10 @@ export class Menuitem {
                 "cancelable": true,
                 "composed": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
                     "text": ""
                 },
                 "complexType": {

package/dist/docs/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-01T14:14:05",
+  "timestamp": "2026-07-01T17:02:26",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.21.0",
@@ -6618,7 +6618,7 @@
         },
         {
           "name": "accessibility",
-          "text": "- Rendered with `role=\"menuitem\"` and `aria-disabled` when disabled.\n- Keyboard events (Arrow keys, Home, End, Tab, Escape, character keys) are captured and\n  re-emitted as custom events consumed by the parent wm-action-menu to manage focus and\n  menu state — do not listen to these events directly in application code."
+          "text": "- Rendered with `role=\"menuitem\"` and `aria-disabled` when disabled."
         },
         {
           "name": "usageNotes",
@@ -6745,134 +6745,6 @@
       ],
       "methods": [],
       "events": [
-        {
-          "event": "wmEndKeyPressed",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmEscKeyPressed",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmHomeKeyPressed",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmKeyDownPressed",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmKeyUpPressed",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmLetterPressed",
-          "detail": "any",
-          "bubbles": true,
-          "complexType": {
-            "original": "any",
-            "resolved": "any",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmMenuitemBlurred",
-          "detail": "{ relatedTarget: EventTarget | null; }",
-          "bubbles": true,
-          "complexType": {
-            "original": "{ relatedTarget: EventTarget | null }",
-            "resolved": "{ relatedTarget: EventTarget | null; }",
-            "references": {
-              "EventTarget": {
-                "location": "global",
-                "id": "global::EventTarget"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
         {
           "event": "wmMenuitemClicked",
           "detail": "HTMLWmMenuitemElement",
@@ -6896,63 +6768,6 @@
               "text": "Fires when the menu item is clicked or Enter is pressed while focused.\nConsumed by the parent wm-action-menu to close the dropdown."
             }
           ]
-        },
-        {
-          "event": "wmPageDownItems",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmPageUpItems",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "event": "wmTabKeyPressed",
-          "detail": "HTMLWmMenuitemElement",
-          "bubbles": true,
-          "complexType": {
-            "original": "HTMLWmMenuitemElement",
-            "resolved": "HTMLWmMenuitemElement",
-            "references": {
-              "HTMLWmMenuitemElement": {
-                "location": "global",
-                "id": "global::HTMLWmMenuitemElement"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
         }
       ],
       "listeners": [

package/dist/docs/skill/wm-action-menu.md

@@ -34,19 +34,19 @@ one or more wm-menuitem children.
 - `tooltip` is required when `action-menu-type` is `icon`.
 
 **Props:**
-- `action-menu-type` -- Visual style of the trigger button. `'icon'` shows an icon-only button (requires `tooltip`). `'text'` shows a labelled button (requires `button-text`). `'selector'` shows a selector box that visually mimics a select control (requires `button-text`). `'selector-primary'` is a primary-styled variant of selector. _(default: `"icon"`)_
+- `action-menu-type` -- Visual style of the trigger button. `'icon'` shows an icon-only button (requires `tooltip`). `'text'` shows a labelled button (requires `button-text`). `'selector'` shows a selector box that visually mimics a select control (requires `button-text`). `'selector-primary'` is a primary-styled variant of selector. _(type: `"icon" | "selector" | "selector-primary" | "text"`; default: `"icon"`)_
 - `button-text` -- Label displayed on the trigger button. _(conditionally required: when action-menu-type is 'text', 'selector', or 'selector-primary')_
 - `dark-mode` -- Applies dark styling to `selector` and `selector-primary` variants. Has no effect on `icon` or `text` types.
 - `disabled` -- Disables the entire menu, preventing the trigger from being activated. _(default: `false`)_
 - `label-for-identical-buttons` -- Use only when multiple action menus on the same page share identical tooltips or button text. Set this to a more descriptive label for screen readers; the visible label stays unchanged. Sets aria-label to this value.
 - `tooltip` -- Tooltip text shown on hover. For `icon` menus, also serves as the accessible name announced by screen readers. _(conditionally required: when action-menu-type is 'icon')_
-- `tooltip-position` -- Position of the tooltip relative to the trigger button. Repositions automatically when there is insufficient space at the specified position.
+- `tooltip-position` -- Position of the tooltip relative to the trigger button. Repositions automatically when there is insufficient space at the specified position. _(type: `"bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right"`)_
 
 **Slots:**
 - _(default)_ -- One or more wm-menuitem elements.
 
 **Events:**
-- `menuLoaded`
+- `menuLoaded` _(deprecated: Use wmActionMenuLoaded instead.)_
 - `wmActionMenuLoaded`
 
 **Accessibility:**
@@ -54,8 +54,9 @@ one or more wm-menuitem children.
 - For `icon` menus, `tooltip` is required and serves as the accessible name announced by screen readers.
 - When multiple action menus share identical tooltips or button text, use `label-for-identical-buttons` to give each a unique `aria-label`.
 - Focus returns automatically to the trigger button after an item is activated, unless the action removes the trigger from the DOM -- in that case, manage focus explicitly in your action handler.
-- **Keyboard:** - **Trigger button (closed)**: Down Arrow / Space / Enter opens the menu and focuses the first item; Up Arrow opens and focuses the last item.
-- **Open menu**: Up/Down Arrow navigates items (wraps around); Home/End jumps to first/last; Enter activates the focused item and closes the menu; Escape closes the menu and returns focus to the trigger; Tab closes the menu; typing a character focuses the next item starting with that letter.
+- **Keyboard:**
+  - **Trigger button (closed)**: Down Arrow / Space / Enter opens the menu and focuses the first item; Up Arrow opens and focuses the last item.
+  - **Open menu**: Up/Down Arrow navigates items (wraps around); Home/End jumps to first/last; Enter activates the focused item and closes the menu; Escape closes the menu and returns focus to the trigger; Tab closes the menu; typing a character focuses the next item starting with that letter.
 
 **Related components:**
 

package/dist/docs/skill/wm-button.md

@@ -55,11 +55,11 @@ menu, popover, or dialog. Use this prop instead of setting `aria-expanded` direc
 - `aria-label-passthrough` -- Sets the button's `aria-label`. Takes priority over `label-for-identical-buttons` and over
 the label automatically derived from `tooltip` for `icononly` and `navigational` buttons. Use
 this prop instead of setting `aria-label` directly on `<wm-button>`.
-- `button-type` -- Visual style of the button. 'primary' for the single preferred action (use sparingly, ideally once per page/section). 'secondary' for other actions, often alongside a primary. 'textonly' for low-emphasis actions. 'icononly' requires icon and tooltip. 'navigational' for icon-only back/forward navigation (e.g. flyout back button). 'pairpositive' and 'pairnegative' must be used together for binary choices (neither is preferred, e.g. Approve/Reject). AI variants apply AI styling automatically -- do not set the icon property on AI types. 'selector' and 'selector-primary' are internal types used by wm-select -- do not use directly. _(default: `"secondary"`)_
+- `button-type` -- Visual style of the button. 'primary' for the single preferred action (use sparingly, ideally once per page/section). 'secondary' for other actions, often alongside a primary. 'textonly' for low-emphasis actions. 'icononly' requires icon and tooltip. 'navigational' for icon-only back/forward navigation (e.g. flyout back button). 'pairpositive' and 'pairnegative' must be used together for binary choices (neither is preferred, e.g. Approve/Reject). AI variants apply AI styling automatically -- do not set the icon property on AI types. 'selector' and 'selector-primary' are internal types used by wm-select -- do not use directly. _(type: `"icononly" | "icononly-ai" | "navigational" | "navigational-ai" | "pairnegative" | "pairpositive" | "primary" | "primary-ai" | "secondary" | "secondary-ai" | "selector" | "selector-primary" | "textonly" | "textonly-ai"`; default: `"secondary"`)_
 - `custom-background` -- Set to 'dark' to render button styles appropriate for a dark background surface.
 - `disabled` -- Disables the button, preventing interaction and applying disabled styling. _(default: `false`)_
 - `icon` -- Icon to display. Required when button-type is 'icononly' or 'navigational'. Formats: '#icon-name' for a commonly-used Ripple icon (e.g. '#edit', '#add-person'), '/path/to/file.svg#symbol-id' for a local SVG sprite symbol, or an MDI character code like 'f3eb' (deprecated). Do not set on AI button types -- their icon is applied automatically. _(conditionally required: when button-type is 'icononly' or 'navigational')_
-- `icon-flip` -- Flips the icon along the specified axis. For use with the icon property.
+- `icon-flip` -- Flips the icon along the specified axis. For use with the icon property. _(type: `"horizontal" | "vertical"`)_
 - `icon-rotate` -- Rotates the icon by the given number of degrees. For use with the icon property.
 - `icon-size` -- Overrides the default icon size. Accepts any valid CSS size value, e.g. '22px' or '1.3rem'.
 - `is-submit` -- When true, the button submits its containing form. Equivalent to type="submit" on a native button element. _(default: `false`)_
@@ -67,7 +67,7 @@ this prop instead of setting `aria-label` directly on `<wm-button>`.
 - `permanently-delete` -- Applies danger/destructive styling to the button. Use sparingly and only for irreversible destructive actions (e.g. permanently deleting an account or record). Applied as a modifier -- not a separate button-type. _(default: `false`)_
 - `text-wrap` -- For 'textonly' buttons only. When false, text is truncated with an ellipsis and a tooltip reveals the full text on hover. _(default: `true`)_
 - `tooltip` -- Tooltip text displayed on hover. _(conditionally required: when button-type is 'icononly' or 'navigational')_
-- `tooltip-position` -- Position of the tooltip relative to the button. If there is insufficient space at the specified position, the component repositions automatically. _(default: `"bottom-right"`)_
+- `tooltip-position` -- Position of the tooltip relative to the button. If there is insufficient space at the specified position, the component repositions automatically. _(type: `"bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right"`; default: `"bottom-right"`)_
 
 **Slots:**
 - _(default)_ -- Button label text. Required for all types. For `icononly` and `navigational`

package/dist/docs/skill/wm-chart-bar.md

@@ -19,10 +19,10 @@ Use this component (or wm-chart-column) instead of `<wm-chart chart-type="bar*">
 **Props:**
 - `config` -- Chart configuration object. Set via JavaScript property -- not an HTML
 attribute. See the `ChartConfig` interface for the full list of options (label, gridMax,
-valueFormat, colors, showLegend, etc.).
+valueFormat, colors, showLegend, etc.). _(type: `undefined | { label: string; showLabel: boolean; valueAxisLabel: string; categoryAxisLabel: string; printMode: boolean; printModeFormat: "amount" | "percentage"; gridMax: number | "auto"; sort?: "ascending" | "descending" | "none"; showLegend?: "top" | "bottom" | "left" | "right" | "none"; showGrid?: boolean; subinfo?: string; valueFormat?: "amount" | "percentage" | "none"; colors?: string; popoverTitle?: string; popoverText?: string; popoverButtonText?: string; decimalPlaces?: number; patternMode?: boolean; }`)_
 - `data` -- Array of data items to render. Set via JavaScript property -- not an HTML
 attribute. Each item must include at least `barLegend` and `amount`; grouped charts also
-require `groupName`. See the `ChartData` interface.
+require `groupName`. See the `ChartData` interface. _(type: `ChartData[]`)_
 - `pattern-mode` -- When true, applies a hatching pattern fill to bars in addition to color,
 improving distinguishability for users with color vision deficiencies. Takes precedence
 over `config.patternMode`.
@@ -39,12 +39,13 @@ over `config.subinfo`.
   grouped), bar legend, and display value.
 - The chart renders with `role="application"` and `aria-roledescription="Interactive chart"`.
 - In `print-mode`, keyboard interaction instructions are removed from the DOM.
-- **Keyboard:** - **Tab**: Enters the chart wrapper.
-- **Arrow Down / Right**: Focuses the first bar; subsequent presses cycle to the next bar.
-- **Arrow Up / Left**: Cycles to the previous bar.
-- **Enter**: Activates the popover button when the popover is open.
-- **Escape**: Closes the open popover.
-- **Tab** (from within): Exits the chart and clears focus.
+- **Keyboard:**
+  - **Tab**: Enters the chart wrapper.
+  - **Arrow Down / Right**: Focuses the first bar; subsequent presses cycle to the next bar.
+  - **Arrow Up / Left**: Cycles to the previous bar.
+  - **Enter**: Activates the popover button when the popover is open.
+  - **Escape**: Closes the open popover.
+  - **Tab** (from within): Exits the chart and clears focus.
 
 **Code example:**
 

package/dist/docs/skill/wm-chart-column.md

@@ -22,10 +22,10 @@ columns exceed available width, the chart scrolls horizontally.
 **Props:**
 - `config` -- Chart configuration object. Set via JavaScript property -- not an HTML
 attribute. See the `ChartConfig` interface for the full list of options (label, gridMax,
-valueFormat, colors, showLegend, etc.).
+valueFormat, colors, showLegend, etc.). _(type: `undefined | { label: string; showLabel: boolean; valueAxisLabel: string; categoryAxisLabel: string; printMode: boolean; printModeFormat: "amount" | "percentage"; gridMax: number | "auto"; sort?: "ascending" | "descending" | "none"; showLegend?: "top" | "bottom" | "left" | "right" | "none"; showGrid?: boolean; subinfo?: string; valueFormat?: "amount" | "percentage" | "none"; colors?: string; popoverTitle?: string; popoverText?: string; popoverButtonText?: string; decimalPlaces?: number; patternMode?: boolean; }`)_
 - `data` -- Array of data items to render. Set via JavaScript property -- not an HTML
 attribute. Each item must include at least `barLegend` and `amount`; grouped charts also
-require `groupName`. See the `ChartData` interface.
+require `groupName`. See the `ChartData` interface. _(type: `ChartData[]`)_
 - `pattern-mode` -- When true, applies a hatching pattern fill to columns in addition to color,
 improving distinguishability for users with color vision deficiencies. Takes precedence
 over `config.patternMode`.
@@ -45,12 +45,13 @@ over `config.subinfo`.
   grouped), bar legend, and display value.
 - The chart renders with `role="application"` and `aria-roledescription="Interactive chart"`.
 - In `print-mode`, keyboard interaction instructions are removed from the DOM.
-- **Keyboard:** - **Tab**: Enters the chart wrapper.
-- **Arrow Down / Right**: Focuses the first column; subsequent presses cycle to the next.
-- **Arrow Up / Left**: Cycles to the previous column.
-- **Enter**: Activates the popover button when the popover is open.
-- **Escape**: Closes the open popover.
-- **Tab** (from within): Exits the chart and clears focus.
+- **Keyboard:**
+  - **Tab**: Enters the chart wrapper.
+  - **Arrow Down / Right**: Focuses the first column; subsequent presses cycle to the next.
+  - **Arrow Up / Left**: Cycles to the previous column.
+  - **Enter**: Activates the popover button when the popover is open.
+  - **Escape**: Closes the open popover.
+  - **Tab** (from within): Exits the chart and clears focus.
 
 **Code example:**
 

package/dist/docs/skill/wm-chart-legend.md

@@ -22,7 +22,7 @@ is required.
 - `chart-ids` -- Space-separated list of element IDs of the wm-chart-bar or wm-chart-column
 elements this legend serves. The legend derives its color swatches and labels from these
 charts automatically. _(default: `""`)_
-- `orientation` -- Layout orientation of legend items. _(default: `"horizontal"`)_
+- `orientation` -- Layout orientation of legend items. _(type: `"horizontal" | "vertical"`; default: `"horizontal"`)_
 - `print-mode` -- When true, the print value for each item is shown next to its swatch in the
 legend -- suitable for printed output. _(default: `false`)_
 

package/dist/docs/skill/wm-chart-stack.md

@@ -35,7 +35,7 @@ its percentage label above the bar.
 the props take precedence when both are set.
 - `popoverTitle` / `popoverText` / `popoverButtonText` (string): default popover content applied
 to every segment, each overridable per-segment in `data`. When unset, the popover title
-defaults to `amount/total`, the text to the segment's legend, and no button is shown.
+defaults to `amount/total`, the text to the segment's legend, and no button is shown. _(type: `undefined | { label: string; subinfo?: string; popoverTitle?: string; popoverText?: string; popoverButtonText?: string; colors?: "discrete" | "semantic"; showLabel?: boolean; showLegend?: "top" | "bottom" | "left" | "right" | "none"; showGrid?: boolean; valueFormat?: "percentage" | "none"; printMode?: boolean; patternMode?: boolean; }`)_
 - `data` -- Array of segments to render. Set via JavaScript property -- not an HTML attribute.
 Each segment's fields:
 - `stackName` (string, required): groups segments into the same stack (row); the set of distinct
@@ -45,7 +45,7 @@ consistent color across stacks.
 - `amount` (number, required): the raw value; the segment's width is `amount / stackTotal`.
 - `color` (string): a `wmcolor` token overriding the palette color for this segment.
 - `popoverTitle` / `popoverText` / `popoverButtonText` (string): popover content for this segment,
-overriding the corresponding `config` defaults.
+overriding the corresponding `config` defaults. _(type: `StackSegmentData[]`)_
 - `pattern-mode` -- When true, applies a hatching pattern fill to segments and enlarges the legend
 tiles, in addition to color -- improving distinguishability for users with color vision
 deficiencies. Takes precedence over `config.patternMode`.
@@ -63,13 +63,14 @@ precedence over `config.printMode`.
 - When a percentage label is hidden for lack of space, a "click a segment to see values" hint is
   shown; it is removed when printing, where clicking isn't available and the data table lists
   every value.
-- **Keyboard:** - **Tab**: Enters the chart wrapper.
-- **Arrow Down / Right**: Focuses the first segment.
-- **Arrow Left / Right**: Moves to the previous / next segment within the stack, wrapping at the ends.
-- **Arrow Up / Down**: Moves to the previous / next stack (focusing its first segment), wrapping at the ends.
-- **Enter**: Activates the popover button when the popover is open.
-- **Escape**: Closes the open popover.
-- **Tab** (from within): Exits the chart and clears focus.
+- **Keyboard:**
+  - **Tab**: Enters the chart wrapper.
+  - **Arrow Down / Right**: Focuses the first segment.
+  - **Arrow Left / Right**: Moves to the previous / next segment within the stack, wrapping at the ends.
+  - **Arrow Up / Down**: Moves to the previous / next stack (focusing its first segment), wrapping at the ends.
+  - **Enter**: Activates the popover button when the popover is open.
+  - **Escape**: Closes the open popover.
+  - **Tab** (from within): Exits the chart and clears focus.
 
 **Code example:**
 

package/dist/docs/skill/wm-chart.md

@@ -21,24 +21,24 @@ general comparison or distribution bar charts, use wm-chart-bar or wm-chart-colu
 
 **Props:**
 - `chart-type` -- Chart subtype. Doughnut subtypes (`doughnut1`-`doughnut3`) and bar composition
-subtypes (`bar2`-`bar7`) -- each tailored to a specific composition use case. _(default: `"doughnut1"`)_
+subtypes (`bar2`-`bar7`) -- each tailored to a specific composition use case. _(type: `"bar" | "bar2" | "bar3" | "bar4" | "bar5" | "bar6" | "bar7" | "doughnut" | "doughnut1" | "doughnut2" | "doughnut3"`; default: `"doughnut1"`)_
 - `label` -- Accessible label for the chart. Required -- the component throws an error if
 omitted. Used as the `aria-label` on the chart container and as the visual chart label.
 - `label-position` -- Position of the chart label relative to the chart. When `"none"`, no label is
-rendered -- an external label matching `label` must be visually grouped with the chart. _(default: `"top"`)_
+rendered -- an external label matching `label` must be visually grouped with the chart. _(type: `"left" | "none" | "top"`; default: `"top"`)_
 - `label-width` -- Controls the bar label width. Only applies to `bar6` and `bar7` subtypes. _(default: `"150px"`)_
 - `not-started-color` -- When true, applies a gray color to the first slice to represent a
 "not started" state. Only applies to `bar5`. _(default: `false`)_
 - `print-mode` -- When true, slice values are included in the legend and keyboard interaction
 instructions are removed from the DOM -- suitable for printed output. _(default: `false`)_
-- `print-mode-format` -- Format for legend values when `print-mode` is enabled. _(default: `"amount"`)_
+- `print-mode-format` -- Format for legend values when `print-mode` is enabled. _(type: `"amount" | "percentage"`; default: `"amount"`)_
 - `show-bar-legend` -- Show or hide the y-axis bar legend. Only applies to `bar7`. _(default: `false`)_
 - `show-grid` -- Show or hide the value grid lines. Only applies to `bar6`. _(default: `true`)_
 - `show-legend` -- Show or hide the legend below the chart. The legend is still read by screen
 readers regardless of this setting. _(default: `true`)_
 - `subinfo` -- Optional secondary text displayed beneath the chart label. Not shown when
 `label-position` is `"none"`.
-- `value-format` -- Controls how individual segment values are displayed on the chart. _(default: `"none"`)_
+- `value-format` -- Controls how individual segment values are displayed on the chart. _(type: `"amount" | "none" | "percentage"`; default: `"none"`)_
 
 **Accessibility:**
 
@@ -46,10 +46,11 @@ readers regardless of this setting. _(default: `true`)_
 - The chart renders with `role="application"` and an `aria-roledescription` of
   "Interactive chart". Each segment is individually focusable with an `aria-label`.
 - `print-mode` removes keyboard interaction instructions for printed output.
-- **Keyboard:** - **Tab**: Enters the chart. Subsequent Tab exits the chart.
-- **Arrow keys**: Navigate between slices/segments.
-- **Enter / Space**: Opens the data popover for the focused segment.
-- **Escape**: Closes the popover and returns to the chart container.
+- **Keyboard:**
+  - **Tab**: Enters the chart. Subsequent Tab exits the chart.
+  - **Arrow keys**: Navigate between slices/segments.
+  - **Enter / Space**: Opens the data popover for the focused segment.
+  - **Escape**: Closes the popover and returns to the chart container.
 
 **Code example:**