@ds-mo/ui 13.16.1 → 13.18.0

package/dist/docs/components.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-08-13T02:34:25",
+  "timestamp": "2026-08-14T00:27:50",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -2041,6 +2041,7 @@
         "ds-mobile-bar-nav",
         "ds-mobile-sheet-nav",
         "ds-panel-nav",
+        "ds-select",
         "ds-tab-group"
       ],
       "dependencies": [
@@ -2074,6 +2075,9 @@
         "ds-panel-nav": [
           "ds-badge"
         ],
+        "ds-select": [
+          "ds-badge"
+        ],
         "ds-tab-group": [
           "ds-badge"
         ]
@@ -2730,9 +2734,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-shell-app": [
           "ds-bar-nav"
         ]
@@ -3367,9 +3376,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-shell-app": [
           "ds-bar-title"
         ]
@@ -3801,9 +3815,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -5705,6 +5724,7 @@
         "ds-card-chart",
         "ds-card-setting",
         "ds-code-block",
+        "ds-filter-menu",
         "ds-input",
         "ds-message-actions",
         "ds-message-composer",
@@ -5761,6 +5781,9 @@
         "ds-code-block": [
           "ds-button-unfilled"
         ],
+        "ds-filter-menu": [
+          "ds-button-unfilled"
+        ],
         "ds-input": [
           "ds-button-unfilled"
         ],
@@ -7615,6 +7638,7 @@
       "states": [],
       "dependents": [
         "ds-agent-questionnaire",
+        "ds-filter-menu",
         "ds-select",
         "ds-table"
       ],
@@ -7628,6 +7652,9 @@
         "ds-agent-questionnaire": [
           "ds-checkbox"
         ],
+        "ds-filter-menu": [
+          "ds-checkbox"
+        ],
         "ds-select": [
           "ds-checkbox"
         ],
@@ -8959,7 +8986,781 @@
               "type": "string"
             },
             {
-              "type": "undefined"
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "error",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "error",
+          "reflectToAttr": false,
+          "docs": "Invalid visual and accessible state forwarded to supported ds controls.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "errorMessage",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "error-message",
+          "reflectToAttr": false,
+          "docs": "Visible error associated with the slotted control while error is true.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "fieldId",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "field-id",
+          "reflectToAttr": false,
+          "docs": "Explicit ID for the slotted control; generated when omitted.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "Persistent visible label for the single slotted control.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": true,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [
+        "ds-text"
+      ],
+      "dependencyGraph": {
+        "ds-field": [
+          "ds-text"
+        ]
+      }
+    },
+    {
+      "filePath": "src/wc/components/FilterMenu/FilterMenu.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-filter-menu",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "activeFill",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "active-fill",
+          "reflectToAttr": false,
+          "docs": "Show selected interaction fill when one or more criteria are active.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "activeFilterId",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "active-filter-id",
+          "reflectToAttr": false,
+          "docs": "Controlled category shown in the option pane.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "align",
+          "type": "\"center\" | \"end\" | \"start\"",
+          "complexType": {
+            "original": "AnchoredAlign",
+            "resolved": "\"center\" | \"end\" | \"start\"",
+            "references": {
+              "AnchoredAlign": {
+                "location": "import",
+                "path": "../../utils/anchored-position",
+                "id": "src/wc/utils/anchored-position.ts::AnchoredAlign",
+                "referenceLocation": "AnchoredAlign"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "align",
+          "reflectToAttr": false,
+          "docs": "Cross-axis alignment against the trigger.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'end'"
+            }
+          ],
+          "default": "'end'",
+          "values": [
+            {
+              "value": "center",
+              "type": "string"
+            },
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "alignOffset",
+          "type": "number | string",
+          "complexType": {
+            "original": "number | string",
+            "resolved": "number | string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "align-offset",
+          "reflectToAttr": false,
+          "docs": "Cross-axis offset — number in px or a TokoMo length.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "0"
+            }
+          ],
+          "default": "0",
+          "values": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "anchor",
+          "type": "HTMLElement | undefined",
+          "complexType": {
+            "original": "HTMLElement | undefined",
+            "resolved": "HTMLElement | undefined",
+            "references": {
+              "HTMLElement": {
+                "location": "global",
+                "id": "global::HTMLElement"
+              }
+            }
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "External trigger element to position against.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "HTMLElement"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "anchorId",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "anchor-id",
+          "reflectToAttr": false,
+          "docs": "ID of the external trigger element used for positioning and focus return.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "ariaLabel",
+          "type": "null | string",
+          "complexType": {
+            "original": "string | null",
+            "resolved": "null | string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "aria-label",
+          "reflectToAttr": false,
+          "docs": "Direct accessible name for the internal select trigger.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "null"
+            }
+          ],
+          "default": "null",
+          "values": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "categoriesLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "categories-label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the category tab list.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Filter categories'"
+            }
+          ],
+          "default": "'Filter categories'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "clearLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "clear-label",
+          "reflectToAttr": false,
+          "docs": "Footer action and date-clear accessible label.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Clear'"
+            }
+          ],
+          "default": "'Clear'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "filters",
+          "type": "FilterMenuFilter[]",
+          "complexType": {
+            "original": "FilterMenuFilter[]",
+            "resolved": "FilterMenuFilter[]",
+            "references": {
+              "FilterMenuFilter": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/FilterMenu/FilterMenu.tsx",
+                "id": "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuFilter"
+              }
+            }
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Product-owned filter categories and option definitions.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "type": "FilterMenuFilter[]"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "hasBorder",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "has-border",
+          "reflectToAttr": false,
+          "docs": "Show the surface-aware inset border around the select trigger.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "icon",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "icon",
+          "reflectToAttr": false,
+          "docs": "Optional select trigger prefix icon name.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Filters'"
+            }
+          ],
+          "default": "'Filters'",
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "initialFocusVisible",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "initial-focus-visible",
+          "reflectToAttr": false,
+          "docs": "Show a visible focus ring on initial entry after keyboard activation.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "inputId",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "input-id",
+          "reflectToAttr": false,
+          "docs": "ID applied to the internal select trigger.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "menuLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "menu-label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the non-modal filter dialog.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Filters'"
+            }
+          ],
+          "default": "'Filters'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "menuWidth",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "menu-width",
+          "reflectToAttr": false,
+          "docs": "Popup width. It remains clamped to the viewport by the component recipe.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "TOKEN_CSS_LENGTHS.menuWidthLg"
+            }
+          ],
+          "default": "TOKEN_CSS_LENGTHS.menuWidthLg",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": false,
+          "docs": "Controlled popup visibility.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "side",
+          "type": "\"bottom\" | \"left\" | \"right\" | \"top\"",
+          "complexType": {
+            "original": "AnchoredSide",
+            "resolved": "\"bottom\" | \"left\" | \"right\" | \"top\"",
+            "references": {
+              "AnchoredSide": {
+                "location": "import",
+                "path": "../../utils/anchored-position",
+                "id": "src/wc/utils/anchored-position.ts::AnchoredSide",
+                "referenceLocation": "AnchoredSide"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "side",
+          "reflectToAttr": false,
+          "docs": "Preferred popup side; collision handling may flip it.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'bottom'"
+            }
+          ],
+          "default": "'bottom'",
+          "values": [
+            {
+              "value": "bottom",
+              "type": "string"
+            },
+            {
+              "value": "left",
+              "type": "string"
+            },
+            {
+              "value": "right",
+              "type": "string"
+            },
+            {
+              "value": "top",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "sideOffset",
+          "type": "number | string",
+          "complexType": {
+            "original": "number | string",
+            "resolved": "number | string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "side-offset",
+          "reflectToAttr": false,
+          "docs": "Gap between trigger and popup — number in px or a TokoMo length.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "TOKEN_CSS_LENGTHS.space050"
+            }
+          ],
+          "default": "TOKEN_CSS_LENGTHS.space050",
+          "values": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "size",
+          "type": "\"lg\" | \"md\" | \"sm\" | \"xs\"",
+          "complexType": {
+            "original": "FilterMenuSize",
+            "resolved": "\"lg\" | \"md\" | \"sm\" | \"xs\"",
+            "references": {
+              "FilterMenuSize": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/FilterMenu/FilterMenu.tsx",
+                "id": "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuSize"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "size",
+          "reflectToAttr": false,
+          "docs": "Select trigger density.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'md'"
+            }
+          ],
+          "default": "'md'",
+          "values": [
+            {
+              "value": "lg",
+              "type": "string"
+            },
+            {
+              "value": "md",
+              "type": "string"
+            },
+            {
+              "value": "sm",
+              "type": "string"
+            },
+            {
+              "value": "xs",
+              "type": "string"
             }
           ],
           "optional": false,
@@ -8968,27 +9769,27 @@
           "setter": false
         },
         {
-          "name": "error",
-          "type": "boolean",
+          "name": "triggerLabel",
+          "type": "string",
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
           "mutable": false,
-          "attr": "error",
+          "attr": "trigger-label",
           "reflectToAttr": false,
-          "docs": "Invalid visual and accessible state forwarded to supported ds controls.",
+          "docs": "Select trigger text. The selected count is appended automatically.",
           "docsTags": [
             {
               "name": "default",
-              "text": "false"
+              "text": "'Filters'"
             }
           ],
-          "default": "false",
+          "default": "'Filters'",
           "values": [
             {
-              "type": "boolean"
+              "type": "string"
             }
           ],
           "optional": false,
@@ -8997,24 +9798,35 @@
           "setter": false
         },
         {
-          "name": "errorMessage",
-          "type": "string | undefined",
+          "name": "values",
+          "type": "{ [x: string]: FilterMenuValue | undefined; }",
           "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
+            "original": "FilterMenuValues",
+            "resolved": "{ [x: string]: FilterMenuValue | undefined; }",
+            "references": {
+              "FilterMenuValues": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/FilterMenu/FilterMenu.tsx",
+                "id": "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuValues"
+              }
+            }
           },
           "mutable": false,
-          "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Visible error associated with the slotted control while error is true.",
-          "docsTags": [],
+          "docs": "Controlled values keyed by filter id.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "{}"
+            }
+          ],
+          "default": "{}",
           "values": [
             {
-              "type": "string"
+              "type": "{ [x: string]: FilterMenuValue"
             },
             {
-              "type": "undefined"
+              "type": "undefined; }"
             }
           ],
           "optional": false,
@@ -9023,68 +9835,185 @@
           "setter": false
         },
         {
-          "name": "fieldId",
-          "type": "string | undefined",
+          "name": "width",
+          "type": "\"fill\" | \"hug\"",
           "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
+            "original": "FilterMenuWidth",
+            "resolved": "\"fill\" | \"hug\"",
+            "references": {
+              "FilterMenuWidth": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/FilterMenu/FilterMenu.tsx",
+                "id": "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuWidth"
+              }
+            }
           },
           "mutable": false,
-          "attr": "field-id",
+          "attr": "width",
           "reflectToAttr": false,
-          "docs": "Explicit ID for the slotted control; generated when omitted.",
-          "docsTags": [],
+          "docs": "Select trigger width fit.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'hug'"
+            }
+          ],
+          "default": "'hug'",
           "values": [
             {
+              "value": "fill",
               "type": "string"
             },
             {
-              "type": "undefined"
+              "value": "hug",
+              "type": "string"
             }
           ],
           "optional": false,
           "required": false,
           "getter": false,
           "setter": false
-        },
+        }
+      ],
+      "methods": [],
+      "events": [
         {
-          "name": "label",
-          "type": "string",
+          "event": "dsActiveFilterChange",
+          "detail": "string",
+          "bubbles": true,
           "complexType": {
             "original": "string",
             "resolved": "string",
             "references": {}
           },
-          "mutable": false,
-          "attr": "label",
-          "reflectToAttr": false,
-          "docs": "Persistent visible label for the single slotted control.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
+          "cancelable": true,
+          "composed": true,
+          "docs": "Requests a controlled active-category replacement.",
+          "docsTags": []
+        },
+        {
+          "event": "dsAfterClose",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted after exit motion and rendered popup removal complete.",
+          "docsTags": []
+        },
+        {
+          "event": "dsChange",
+          "detail": "FilterMenuChangeDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "FilterMenuChangeDetail",
+            "resolved": "FilterMenuChangeDetail",
+            "references": {
+              "FilterMenuChangeDetail": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/FilterMenu/FilterMenu.tsx",
+                "id": "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuChangeDetail"
+              }
             }
-          ],
-          "optional": false,
-          "required": true,
-          "getter": false,
-          "setter": false
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Requests a controlled value replacement without closing the popup.",
+          "docsTags": []
+        },
+        {
+          "event": "dsClear",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Requests that the consumer clear every filter value.",
+          "docsTags": []
+        },
+        {
+          "event": "dsClose",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Requests that the controlled popup close.",
+          "docsTags": []
+        },
+        {
+          "event": "dsOpenChange",
+          "detail": "boolean",
+          "bubbles": true,
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted whenever internal select-trigger activation changes popup visibility.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "keydown",
+          "capture": false,
+          "passive": false
         }
       ],
-      "methods": [],
-      "events": [],
-      "listeners": [],
       "styles": [],
       "slots": [],
       "parts": [],
       "states": [],
       "dependents": [],
       "dependencies": [
-        "ds-text"
+        "ds-checkbox",
+        "ds-text",
+        "ds-button-unfilled",
+        "ds-icon",
+        "ds-tag",
+        "ds-tooltip"
       ],
       "dependencyGraph": {
-        "ds-field": [
+        "ds-filter-menu": [
+          "ds-checkbox",
+          "ds-text",
+          "ds-button-unfilled",
+          "ds-icon",
+          "ds-tag",
+          "ds-tooltip"
+        ],
+        "ds-checkbox": [
+          "ds-text"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
+          "ds-text"
+        ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
+        "ds-tooltip": [
           "ds-text"
         ]
       }
@@ -9439,6 +10368,7 @@
         "ds-button-unfilled",
         "ds-chip",
         "ds-empty-state",
+        "ds-filter-menu",
         "ds-input",
         "ds-message-composer",
         "ds-mobile-bar-nav",
@@ -9485,6 +10415,9 @@
         "ds-empty-state": [
           "ds-icon"
         ],
+        "ds-filter-menu": [
+          "ds-icon"
+        ],
         "ds-input": [
           "ds-icon"
         ],
@@ -11465,6 +12398,7 @@
       "dependencies": [
         "ds-text",
         "ds-swatch-picker",
+        "ds-tag",
         "ds-badge",
         "ds-switch"
       ],
@@ -11472,9 +12406,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-badge": [
           "ds-text"
         ],
@@ -13750,9 +14689,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-bar-workflow": [
           "ds-mobile-header"
         ],
@@ -13903,9 +14847,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-badge": [
           "ds-text"
         ],
@@ -17868,19 +18817,48 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "clear-label",
-          "reflectToAttr": false,
-          "docs": "Localized clear action label.",
+          "attr": "clear-label",
+          "reflectToAttr": false,
+          "docs": "Localized clear action label.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Clear'"
+            }
+          ],
+          "default": "'Clear'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disabled",
+          "reflectToAttr": true,
+          "docs": "Native disabled state.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'Clear'"
+              "text": "false"
             }
           ],
-          "default": "'Clear'",
+          "default": "false",
           "values": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
           "optional": false,
@@ -17889,7 +18867,7 @@
           "setter": false
         },
         {
-          "name": "disabled",
+          "name": "dot",
           "type": "boolean",
           "complexType": {
             "original": "boolean",
@@ -17897,9 +18875,9 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "disabled",
-          "reflectToAttr": true,
-          "docs": "Native disabled state.",
+          "attr": "dot",
+          "reflectToAttr": false,
+          "docs": "Show a supplemental notification dot beside the trigger label.",
           "docsTags": [
             {
               "name": "default",
@@ -17972,6 +18950,32 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "footerActionLabel",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "footer-action-label",
+          "reflectToAttr": false,
+          "docs": "Optional text action shown in the popup footer instead of the clear action.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "hasBorder",
           "type": "boolean",
@@ -18316,6 +19320,46 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "popupAlign",
+          "type": "\"end\" | \"start\"",
+          "complexType": {
+            "original": "SelectPopupAlign",
+            "resolved": "\"end\" | \"start\"",
+            "references": {
+              "SelectPopupAlign": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/Select/Select.tsx",
+                "id": "src/wc/components/Select/Select.tsx::SelectPopupAlign"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "popup-align",
+          "reflectToAttr": false,
+          "docs": "Align the popup's choice edge to the trigger start or end edge.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'start'"
+            }
+          ],
+          "default": "'start'",
+          "values": [
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "required",
           "type": "boolean",
@@ -18543,6 +19587,61 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "triggerLabel",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "trigger-label",
+          "reflectToAttr": false,
+          "docs": "Optional scalar-mode trigger text that does not change the selected option label.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "triggerLabelPlaceholder",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "trigger-label-placeholder",
+          "reflectToAttr": false,
+          "docs": "Present triggerLabel with placeholder emphasis while preserving the selected value.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "value",
           "type": "string | string[]",
@@ -18681,6 +19780,20 @@
           "docs": "Emitted after the footer clear action.",
           "docsTags": []
         },
+        {
+          "event": "dsFooterAction",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the optional popup footer action is activated.",
+          "docsTags": []
+        },
         {
           "event": "dsOpenChange",
           "detail": "boolean",
@@ -18694,6 +19807,26 @@
           "composed": true,
           "docs": "Emitted whenever popup visibility changes.",
           "docsTags": []
+        },
+        {
+          "event": "dsOptionAction",
+          "detail": "SelectOptionActionDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "SelectOptionActionDetail",
+            "resolved": "SelectOptionActionDetail",
+            "references": {
+              "SelectOptionActionDetail": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/Select/Select.tsx",
+                "id": "src/wc/components/Select/Select.tsx::SelectOptionActionDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when an option's contextual ellipsis action is activated.",
+          "docsTags": []
         }
       ],
       "listeners": [],
@@ -18705,29 +19838,27 @@
       "dependencies": [
         "ds-checkbox",
         "ds-icon",
+        "ds-tooltip",
+        "ds-button-unfilled",
         "ds-loader",
         "ds-text",
-        "ds-empty-state",
-        "ds-tooltip",
-        "ds-button-unfilled"
+        "ds-badge",
+        "ds-empty-state"
       ],
       "dependencyGraph": {
         "ds-select": [
           "ds-checkbox",
           "ds-icon",
+          "ds-tooltip",
+          "ds-button-unfilled",
           "ds-loader",
           "ds-text",
-          "ds-empty-state",
-          "ds-tooltip",
-          "ds-button-unfilled"
+          "ds-badge",
+          "ds-empty-state"
         ],
         "ds-checkbox": [
           "ds-text"
         ],
-        "ds-empty-state": [
-          "ds-icon",
-          "ds-text"
-        ],
         "ds-tooltip": [
           "ds-text"
         ],
@@ -18739,6 +19870,10 @@
         ],
         "ds-badge": [
           "ds-text"
+        ],
+        "ds-empty-state": [
+          "ds-icon",
+          "ds-text"
         ]
       }
     },
@@ -19535,9 +20670,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-shell-tools": [
           "ds-panel-tools",
           "ds-mobile-header",
@@ -20612,9 +21752,14 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-tag",
           "ds-badge",
           "ds-switch"
         ],
+        "ds-tag": [
+          "ds-icon",
+          "ds-text"
+        ],
         "ds-shell-app": [
           "ds-shell-tools"
         ]
@@ -24737,6 +25882,8 @@
       "parts": [],
       "states": [],
       "dependents": [
+        "ds-filter-menu",
+        "ds-menu",
         "ds-table"
       ],
       "dependencies": [
@@ -24748,6 +25895,12 @@
           "ds-icon",
           "ds-text"
         ],
+        "ds-filter-menu": [
+          "ds-tag"
+        ],
+        "ds-menu": [
+          "ds-tag"
+        ],
         "ds-table": [
           "ds-tag"
         ]
@@ -25411,6 +26564,7 @@
         "ds-conversation-list-section",
         "ds-empty-state",
         "ds-field",
+        "ds-filter-menu",
         "ds-input",
         "ds-menu",
         "ds-message",
@@ -25508,6 +26662,9 @@
         "ds-field": [
           "ds-text"
         ],
+        "ds-filter-menu": [
+          "ds-text"
+        ],
         "ds-input": [
           "ds-text"
         ],
@@ -26238,6 +27395,7 @@
         "ds-bar-workflow",
         "ds-card-overview",
         "ds-code-block",
+        "ds-filter-menu",
         "ds-message-actions",
         "ds-message-composer",
         "ds-message-scroller",
@@ -26276,6 +27434,9 @@
         "ds-code-block": [
           "ds-tooltip"
         ],
+        "ds-filter-menu": [
+          "ds-tooltip"
+        ],
         "ds-message-actions": [
           "ds-tooltip"
         ],
@@ -26805,6 +27966,41 @@
       "docstring": "",
       "path": "src/wc/components/Divider/Divider.tsx"
     },
+    "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuSize": {
+      "declaration": "export type FilterMenuSize = 'lg' | 'md' | 'sm' | 'xs';",
+      "docstring": "",
+      "path": "src/wc/components/FilterMenu/FilterMenu.tsx"
+    },
+    "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuWidth": {
+      "declaration": "export type ControlWidth = 'hug' | 'fill';",
+      "docstring": "",
+      "path": "src/wc/components/FilterMenu/FilterMenu.tsx"
+    },
+    "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuFilter": {
+      "declaration": "export interface FilterMenuFilter {\n  id: string;\n  label: string;\n  kind: FilterMenuFilterKind;\n  options?: FilterMenuOption[];\n  description?: string;\n  fieldLabel?: string;\n  /** Draw a standard menu-section divider after this category. */\n  divider?: boolean;\n}",
+      "docstring": "",
+      "path": "src/wc/components/FilterMenu/FilterMenu.tsx"
+    },
+    "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuValues": {
+      "declaration": "{\n    [P in K]: T;\n}",
+      "docstring": "",
+      "path": "src/wc/components/FilterMenu/FilterMenu.tsx"
+    },
+    "src/wc/utils/anchored-position.ts::AnchoredSide": {
+      "declaration": "export type AnchoredSide = 'top' | 'right' | 'bottom' | 'left';",
+      "docstring": "",
+      "path": "src/wc/utils/anchored-position.ts"
+    },
+    "src/wc/utils/anchored-position.ts::AnchoredAlign": {
+      "declaration": "export type AnchoredAlign = 'start' | 'center' | 'end';",
+      "docstring": "",
+      "path": "src/wc/utils/anchored-position.ts"
+    },
+    "src/wc/components/FilterMenu/FilterMenu.tsx::FilterMenuChangeDetail": {
+      "declaration": "export interface FilterMenuChangeDetail {\n  filterId: string;\n  value: FilterMenuValue;\n}",
+      "docstring": "",
+      "path": "src/wc/components/FilterMenu/FilterMenu.tsx"
+    },
     "src/wc/components/Input/Input.tsx::InputType": {
       "declaration": "export type InputType = 'text' | 'email' | 'tel' | 'url' | 'search' | 'password';",
       "docstring": "",
@@ -26830,8 +28026,28 @@
       "docstring": "",
       "path": "src/wc/components/Loader/Loader.tsx"
     },
+    "src/wc/components/Tag/Tag.tsx::TagIntent": {
+      "declaration": "export type TagIntent   = 'neutral' | 'brand' | 'ai' | 'negative' | 'warning' | 'caution' | 'positive';",
+      "docstring": "",
+      "path": "src/wc/components/Tag/Tag.tsx"
+    },
+    "src/wc/components/Tag/Tag.tsx::TagContrast": {
+      "declaration": "export type TagContrast = 'strong' | 'bold' | 'medium' | 'faint';",
+      "docstring": "",
+      "path": "src/wc/components/Tag/Tag.tsx"
+    },
+    "src/wc/components/Tag/Tag.tsx::TagSize": {
+      "declaration": "export type TagSize     = 'md' | 'sm' | 'xs';",
+      "docstring": "",
+      "path": "src/wc/components/Tag/Tag.tsx"
+    },
+    "src/wc/utils/index.ts::ControlInsetDepth": {
+      "declaration": "any",
+      "docstring": "",
+      "path": "src/wc/utils/index.ts"
+    },
     "src/wc/components/Menu/menu-types.ts::MenuItemData": {
-      "declaration": "export interface MenuItemData {\n  label: string;\n  value?: string;\n  subtext?: string;\n  /** Show a supplemental brand notification dot. */\n  dot?: boolean;\n  isSelected?: boolean;\n  isInactive?: boolean;\n  isDestructive?: boolean;\n  /** Render a compact switch indicator; the menu row owns interaction. */\n  showSwitch?: boolean;\n  switchValue?: boolean;\n}",
+      "declaration": "export interface MenuItemData {\n  label: string;\n  value?: string;\n  subtext?: string;\n  /** Show a supplemental brand notification dot. */\n  dot?: boolean;\n  /** Show a non-interactive tag at the trailing edge of the row. */\n  tag?: MenuItemTagData;\n  isSelected?: boolean;\n  isInactive?: boolean;\n  isDestructive?: boolean;\n  /** Render a compact switch indicator; the menu row owns interaction. */\n  showSwitch?: boolean;\n  switchValue?: boolean;\n}",
       "docstring": "",
       "path": "src/wc/components/Menu/menu-types.ts"
     },
@@ -26921,7 +28137,7 @@
       "path": "src/wc/components/ScrollOverlay/ScrollOverlay.tsx"
     },
     "src/wc/components/Select/Select.tsx::SelectOption": {
-      "declaration": "export interface ChoiceOption {\n  label: string;\n  value: string;\n  subtext?: string;\n  /** Rendered only when every option in the complete list supplies an icon. */\n  icon?: string;\n  isInactive?: boolean;\n}",
+      "declaration": "export interface ChoiceOption {\n  label: string;\n  value: string;\n  subtext?: string;\n  /** Rendered only when every option in the complete list supplies an icon. */\n  icon?: string;\n  isInactive?: boolean;\n  /** Optional contextual action shown at the trailing edge of this option. */\n  action?: ChoiceOptionAction;\n}",
       "docstring": "",
       "path": "src/wc/components/Select/Select.tsx"
     },
@@ -26945,11 +28161,21 @@
       "docstring": "",
       "path": "src/wc/components/Select/Select.tsx"
     },
+    "src/wc/components/Select/Select.tsx::SelectPopupAlign": {
+      "declaration": "export type SelectPopupAlign = 'start' | 'end';",
+      "docstring": "",
+      "path": "src/wc/components/Select/Select.tsx"
+    },
     "src/wc/components/Select/Select.tsx::SelectBackground": {
       "declaration": "export type ChoiceBackground =\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'always-dark';",
       "docstring": "",
       "path": "src/wc/components/Select/Select.tsx"
     },
+    "src/wc/components/Select/Select.tsx::SelectOptionActionDetail": {
+      "declaration": "export interface SelectOptionActionDetail {\n  value: string;\n  anchorId: string;\n  originalEvent: MouseEvent;\n}",
+      "docstring": "",
+      "path": "src/wc/components/Select/Select.tsx"
+    },
     "src/wc/components/Skeleton/Skeleton.tsx::SkeletonVariant": {
       "declaration": "export type SkeletonVariant = 'text' | 'icon' | 'control';",
       "docstring": "",
@@ -26995,26 +28221,6 @@
       "docstring": "",
       "path": "src/wc/components/Switch/Switch.tsx"
     },
-    "src/wc/components/Tag/Tag.tsx::TagIntent": {
-      "declaration": "export type TagIntent   = 'neutral' | 'brand' | 'ai' | 'negative' | 'warning' | 'caution' | 'positive';",
-      "docstring": "",
-      "path": "src/wc/components/Tag/Tag.tsx"
-    },
-    "src/wc/components/Tag/Tag.tsx::TagContrast": {
-      "declaration": "export type TagContrast = 'strong' | 'bold' | 'medium' | 'faint';",
-      "docstring": "",
-      "path": "src/wc/components/Tag/Tag.tsx"
-    },
-    "src/wc/components/Tag/Tag.tsx::TagSize": {
-      "declaration": "export type TagSize     = 'md' | 'sm' | 'xs';",
-      "docstring": "",
-      "path": "src/wc/components/Tag/Tag.tsx"
-    },
-    "src/wc/utils/index.ts::ControlInsetDepth": {
-      "declaration": "any",
-      "docstring": "",
-      "path": "src/wc/utils/index.ts"
-    },
     "src/wc/components/Text/text-types.ts::TextColor": {
       "declaration": "export type TextColor = TextColorToken | `var(--${string})`;",
       "docstring": "",