@m3e/chips 1.0.0-rc.1 → 1.0.0-rc.3

package/dist/html-custom-data.json

@@ -4,7 +4,7 @@
   "tags": [
     {
       "name": "m3e-assist-chip",
-      "description": "A chip users interact with to perform a smart or automated action that can span multiple applications.\n---\n\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **icon** - Renders an icon before the chip's label.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_",
+      "description": "A chip users interact with to perform a smart or automated action that can span multiple applications.\n---\n\n\n### **Events:**\n - **click** - Emitted when the element is clicked.\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **icon** - Renders an icon before the chip's label.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_",
       "attributes": [
         {
           "name": "disabled",
@@ -39,12 +39,12 @@
         {
           "name": "target",
           "description": "The target of the link button.",
-          "values": []
+          "values": [{ "name": "LinkTarget" }]
         },
         {
           "name": "type",
           "description": "The type of the element.",
-          "values": []
+          "values": [{ "name": "FormSubmitterType" }]
         },
         {
           "name": "value",
@@ -90,7 +90,7 @@
     },
     {
       "name": "m3e-filter-chip",
-      "description": "A chip users interact with to select/deselect options.\n---\n\n\n### **Events:**\n - **input** - Emitted when the selected state changes.\n- **change** - Emitted when the selected state changes.\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **icon** - Renders an icon before the chip's label.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_\n- **--m3e-chip-selected-outline-thickness** - Outline thickness for selected state. _(default: undefined)_\n- **--m3e-chip-selected-label-text-color** - Text color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-container-color** - Background color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-container-hover-color** - Hover state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-container-focus-color** - Focus state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-hover-elevation** - Elevation on hover in selected state. _(default: undefined)_\n- **--m3e-chip-selected-ripple-color** - Ripple color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-state-layer-focus-color** - Focus state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-state-layer-hover-color** - Hover state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-leading-icon-color** - Leading icon color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-trailing-icon-color** - Trailing icon color in selected state. _(default: undefined)_\n- **--m3e-chip-unselected-label-text-color** - Text color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-ripple-color** - Ripple color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-state-layer-focus-color** - Focus state layer color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-state-layer-hover-color** - Hover state layer color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-leading-icon-color** - Leading icon color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-trailing-icon-color** - Trailing icon color in unselected state. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_",
+      "description": "A chip users interact with to select/deselect options.\n---\n\n\n### **Events:**\n - **input** - Emitted when the selected state changes.\n- **change** - Emitted when the selected state changes.\n- **click** - Emitted when the element is clicked.\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **icon** - Renders an icon before the chip's label.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_\n- **--m3e-chip-selected-outline-thickness** - Outline thickness for selected state. _(default: undefined)_\n- **--m3e-chip-selected-label-text-color** - Text color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-container-color** - Background color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-container-hover-color** - Hover state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-container-focus-color** - Focus state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-hover-elevation** - Elevation on hover in selected state. _(default: undefined)_\n- **--m3e-chip-selected-ripple-color** - Ripple color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-state-layer-focus-color** - Focus state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-state-layer-hover-color** - Hover state layer color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-leading-icon-color** - Leading icon color in selected state. _(default: undefined)_\n- **--m3e-chip-selected-trailing-icon-color** - Trailing icon color in selected state. _(default: undefined)_\n- **--m3e-chip-unselected-label-text-color** - Text color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-ripple-color** - Ripple color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-state-layer-focus-color** - Focus state layer color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-state-layer-hover-color** - Hover state layer color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-leading-icon-color** - Leading icon color in unselected state. _(default: undefined)_\n- **--m3e-chip-unselected-trailing-icon-color** - Trailing icon color in unselected state. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_",
       "attributes": [
         {
           "name": "disabled",
@@ -122,7 +122,7 @@
     },
     {
       "name": "m3e-filter-chip-set",
-      "description": "A container that organizes filter chips into a cohesive group, enabling selection and\r\ndeselection of values used to refine content or trigger contextual behavior.\n---\n\n\n### **Events:**\n - **change** - Emitted when the selected state of a chip changes.\n- **input** - Emitted when the selected state of a chip changes.\n\n### **Slots:**\n - _default_ - Renders the chips of the set.\n\n### **CSS Properties:**\n - **--m3e-chip-set-spacing** - The spacing (gap) between chips in the set. _(default: undefined)_",
+      "description": "A container that organizes filter chips into a cohesive group, enabling selection and\r\ndeselection of values used to refine content or trigger contextual behavior.\n---\n\n\n### **Events:**\n - **change** - Emitted when the selected state of a chip changes.\n- **input** - Emitted when the selected state of a chip changes.\n\n### **Methods:**\n - **markAsPristine(): _void_** - Marks the element as pristine.\n- **markAsDirty(): _void_** - Marks the element as dirty.\n- **markAsTouched(): _void_** - Marks the element as touched.\n- **markAsUntouched(): _void_** - Marks the element as untouched.\n- **formDisabledCallback(disabled: _boolean_): _void_** - Called when the element is disabled or enabled via its form association.\n- **formResetCallback(): _void_** - Called when the associated form is reset.\n\n### **Slots:**\n - _default_ - Renders the chips of the set.\n\n### **CSS Properties:**\n - **--m3e-chip-set-spacing** - The spacing (gap) between chips in the set. _(default: undefined)_",
       "attributes": [
         {
           "name": "disabled",
@@ -154,7 +154,7 @@
     },
     {
       "name": "m3e-input-chip",
-      "description": "A chip which represents a discrete piece of information entered by a user.\n---\n\n\n### **Events:**\n - **remove** - Emitted when the remove button is clicked or DELETE or BACKSPACE key is pressed.\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **avatar** - Renders an avatar before the chip's label.\n- **icon** - Renders an icon before the chip's label.\n- **remove-icon** - Renders the icon for the button used to remove the chip.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_\n- **--m3e-chip-avatar-size** - Font size of the avatar slot content. _(default: undefined)_\n- **--m3e-chip-disabled-avatar-opacity** - Opacity applied to the avatar when disabled. _(default: undefined)_\n- **--m3e-chip-with-avatar-padding-start** - Start padding when an avatar is present. _(default: undefined)_",
+      "description": "A chip which represents a discrete piece of information entered by a user.\n---\n\n\n### **Events:**\n - **remove** - Emitted when the remove button is clicked or DELETE or BACKSPACE key is pressed.\n- **click** - Emitted when the element is clicked.\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **avatar** - Renders an avatar before the chip's label.\n- **icon** - Renders an icon before the chip's label.\n- **remove-icon** - Renders the icon for the button used to remove the chip.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_\n- **--m3e-chip-avatar-size** - Font size of the avatar slot content. _(default: undefined)_\n- **--m3e-chip-disabled-avatar-opacity** - Opacity applied to the avatar when disabled. _(default: undefined)_\n- **--m3e-chip-with-avatar-padding-start** - Start padding when an avatar is present. _(default: undefined)_",
       "attributes": [
         {
           "name": "disabled",
@@ -191,7 +191,7 @@
     },
     {
       "name": "m3e-input-chip-set",
-      "description": "A container that transforms user input into a cohesive set of interactive chips, supporting entry, editing, and removal of discrete values.\n---\n\n\n### **Events:**\n - **change** - Emitted when a chip is added to, or removed from, the set.\n\n### **Slots:**\n - _default_ - Renders the chips of the set.\n- **input** - Renders the input element used to add new chips to the set.\n\n### **CSS Properties:**\n - **--m3e-chip-set-spacing** - The spacing (gap) between chips in the set. _(default: undefined)_",
+      "description": "A container that transforms user input into a cohesive set of interactive chips, supporting entry, editing, and removal of discrete values.\n---\n\n\n### **Events:**\n - **change** - Emitted when a chip is added to, or removed from, the set.\n\n### **Methods:**\n - **reportValidity(): _boolean_** - Returns `true` if the element has no validity problems; otherwise, returns `false`, fires\r\nan invalid event, and (if the event isn't canceled) reports the problem to the user.\n- **checkValidity(): _boolean_** - Returns `true` if the element has no validity problems; otherwise,\r\nreturns `false`, fires an invalid event.\n- **setCustomValidity(error: _string_): _void_** - Sets a custom validity message for the element.\n- **markAsPristine(): _void_** - Marks the element as pristine.\n- **markAsDirty(): _void_** - Marks the element as dirty.\n- **markAsTouched(): _void_** - Marks the element as touched.\n- **markAsUntouched(): _void_** - Marks the element as untouched.\n- **formDisabledCallback(disabled: _boolean_): _void_** - Called when the element is disabled or enabled via its form association.\n- **formResetCallback(): _void_** - Called when the associated form is reset.\n\n### **Slots:**\n - _default_ - Renders the chips of the set.\n- **input** - Renders the input element used to add new chips to the set.\n\n### **CSS Properties:**\n - **--m3e-chip-set-spacing** - The spacing (gap) between chips in the set. _(default: undefined)_",
       "attributes": [
         {
           "name": "disabled",
@@ -218,7 +218,7 @@
     },
     {
       "name": "m3e-suggestion-chip",
-      "description": "A chip used to help narrow a user's intent by presenting dynamically generated suggestions, such as\r\nsuggested responses or search filters.\n---\n\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **icon** - Renders an icon before the chip's label.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_",
+      "description": "A chip used to help narrow a user's intent by presenting dynamically generated suggestions, such as\r\nsuggested responses or search filters.\n---\n\n\n### **Events:**\n - **click** - Emitted when the element is clicked.\n\n### **Slots:**\n - _default_ - Renders the label of the chip.\n- **icon** - Renders an icon before the chip's label.\n- **trailing-icon** - Renders an icon after the chip's label.\n\n### **CSS Properties:**\n - **--m3e-chip-container-shape** - Border radius of the chip container. _(default: undefined)_\n- **--m3e-chip-container-height** - Base height of the chip container before density adjustment. _(default: undefined)_\n- **--m3e-chip-label-text-font-size** - Font size of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-font-weight** - Font weight of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-line-height** - Line height of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-tracking** - Letter spacing of the chip label text. _(default: undefined)_\n- **--m3e-chip-label-text-color** - Label text color in default state. _(default: undefined)_\n- **--m3e-chip-icon-color** - Icon color in default state. _(default: undefined)_\n- **--m3e-chip-icon-size** - Font size of leading/trailing icons. _(default: undefined)_\n- **--m3e-chip-spacing** - Horizontal gap between chip content elements. _(default: undefined)_\n- **--m3e-chip-padding-start** - Default start padding when no icon is present. _(default: undefined)_\n- **--m3e-chip-padding-end** - Default end padding when no trailing icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-start** - Start padding when leading icon is present. _(default: undefined)_\n- **--m3e-chip-with-icon-padding-end** - End padding when trailing icon is present. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-color** - Base color for disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-label-text-opacity** - Opacity applied to disabled label text. _(default: undefined)_\n- **--m3e-chip-disabled-icon-color** - Base color for disabled icons. _(default: undefined)_\n- **--m3e-chip-disabled-icon-opacity** - Opacity applied to disabled icons. _(default: undefined)_\n- **--m3e-elevated-chip-container-color** - Background color for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-elevation** - Elevation level for elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-hover-elevation** - Elevation level on hover. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-color** - Background color for disabled elevated variant. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-container-opacity** - Opacity applied to disabled elevated background. _(default: undefined)_\n- **--m3e-elevated-chip-disabled-elevation** - Elevation level for disabled elevated variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-thickness** - Outline thickness for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-outline-color** - Outline color for outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-color** - Outline color for disabled outlined variant. _(default: undefined)_\n- **--m3e-outlined-chip-disabled-outline-opacity** - Opacity applied to disabled outline. _(default: undefined)_",
       "attributes": [
         {
           "name": "disabled",
@@ -253,12 +253,12 @@
         {
           "name": "target",
           "description": "The target of the link button.",
-          "values": []
+          "values": [{ "name": "LinkTarget" }]
         },
         {
           "name": "type",
           "description": "The type of the element.",
-          "values": []
+          "values": [{ "name": "FormSubmitterType" }]
         },
         {
           "name": "value",

package/dist/index.js

@@ -3,8 +3,8 @@
  * Copyright (c) 2025 matraic
  * See LICENSE file in the project root for full license text.
  */
-import { LitElement, nothing, html, unsafeCSS, css } from 'lit';
-import { Role, isDisabledMixin, isDisabledInteractiveMixin, isLinkButtonMixin, renderPseudoLink, DesignToken, hasAssignedNodes, getTextContent, FormSubmitter, AttachInternals, LinkButton, KeyboardClick, Focusable, DisabledInteractive, Disabled, Vertical, Selected, Labelled, Dirty, Touched, FormAssociated, formValue, EventAttribute, RequiredConstraintValidation, Required, ConstraintValidation } from '@m3e/core';
+import { unsafeCSS, css, LitElement, nothing, html } from 'lit';
+import { DesignToken, isDisabledMixin, isDisabledInteractiveMixin, isLinkButtonMixin, renderPseudoLink, hasAssignedNodes, getTextContent, FormSubmitter, AttachInternals, LinkButton, KeyboardClick, Focusable, DisabledInteractive, Disabled, Role, Vertical, Selected, Labelled, Dirty, Touched, FormAssociated, formValue, EventAttribute, RequiredConstraintValidation, Required, ConstraintValidation } from '@m3e/core';
 import { selectionManager, SelectionManager, ListManager, ListKeyManager } from '@m3e/core/a11y';
 
 /******************************************************************************
@@ -90,7 +90,6 @@ const e$2=(e,t,c)=>(c.configurable=true,c.enumerable=true,Reflect.decorate&&"obj
 
 var _M3eChipElement_instances, _M3eChipElement_value, _M3eChipElement_textContent, _M3eChipElement_renderContent, _M3eChipElement_handleIconSlotChange, _M3eChipElement_handleTrailingIconSlotChange, _M3eChipElement_handleSlotChange;
 /**
- * @summary
  * A non-interactive chip used to convey small pieces of information.
  *
  * @description
@@ -138,7 +137,7 @@ var _M3eChipElement_instances, _M3eChipElement_value, _M3eChipElement_textConten
  * @cssprop --m3e-outlined-chip-outline-thickness - Outline thickness for outlined variant.
  * @cssprop --m3e-outlined-chip-outline-color - Outline color for outlined variant.
  */
-let M3eChipElement = class M3eChipElement extends Role(LitElement, "none") {
+let M3eChipElement = class M3eChipElement extends LitElement {
     constructor() {
         super(...arguments);
         _M3eChipElement_instances.add(this);
@@ -269,6 +268,16 @@ M3eChipElement.styles = css `
       overflow: hidden;
       text-overflow: ellipsis;
     }
+    a {
+      all: unset;
+      display: block;
+      position: absolute;
+      top: 0px;
+      left: 0px;
+      right: 0px;
+      bottom: 0px;
+      z-index: 1;
+    }
     :host([variant="elevated"]) .base {
       background-color: var(--m3e-elevated-chip-container-color, ${DesignToken.color.surfaceContainerLow});
 
@@ -402,7 +411,6 @@ M3eChipElement = __decorate([
 ], M3eChipElement);
 
 /**
- * @summary
  * A chip users interact with to perform a smart or automated action that can span multiple applications.
  *
  * @description
@@ -441,6 +449,8 @@ M3eChipElement = __decorate([
  * @attr value - A string representing the value of the chip.
  * @attr variant - The appearance variant of the chip.
  *
+ * @fires click - Emitted when the element is clicked.
+ *
  * @cssprop --m3e-chip-container-shape - Border radius of the chip container.
  * @cssprop --m3e-chip-container-height - Base height of the chip container before density adjustment.
  * @cssprop --m3e-chip-label-text-font-size - Font size of the chip label text.
@@ -481,7 +491,6 @@ M3eAssistChipElement = __decorate([
 ], M3eAssistChipElement);
 
 /**
- * @summary
  * A container used to organize chips into a cohesive unit.
  *
  * @description
@@ -508,7 +517,7 @@ M3eAssistChipElement = __decorate([
  *
  * @cssprop --m3e-chip-set-spacing - The spacing (gap) between chips in the set.
  */
-let M3eChipSetElement = class M3eChipSetElement extends Vertical(Role(LitElement, "none")) {
+let M3eChipSetElement = class M3eChipSetElement extends Vertical(LitElement) {
     /** @inheritdoc */
     render() {
         return html `<slot></slot>`;
@@ -533,7 +542,6 @@ M3eChipSetElement = __decorate([
 
 var _M3eFilterChipElement_instances, _M3eFilterChipElement_clickHandler, _M3eFilterChipElement_handleClick;
 /**
- * @summary
  * A chip users interact with to select/deselect options.
  *
  * @description
@@ -543,6 +551,18 @@ var _M3eFilterChipElement_instances, _M3eFilterChipElement_clickHandler, _M3eFil
  * with Material 3 guidelines.  Appearance variants include `elevated` and `outlined`, enabling visual
  * differentiation and contextual emphasis.
  *
+ * @example
+ * The following example illustrates a single-select `m3e-filter-chip-set` containing multiple `m3e-filter-chip` components that
+ * allow a user to choose an option. You can use the `multi` attribute to enable multiselect.
+ * ```html
+ * <m3e-filter-chip-set aria-label="Filter by topic">
+ *  <m3e-filter-chip><m3e-icon slot="icon" name="palette"></m3e-icon>Design</m3e-filter-chip>
+ *  <m3e-filter-chip><m3e-icon slot="icon" name="accessibility_new"></m3e-icon>Accessibility</m3e-filter-chip>
+ *  <m3e-filter-chip><m3e-icon slot="icon" name="motion_photos_on"></m3e-icon>Motion</m3e-filter-chip>
+ *  <m3e-filter-chip><m3e-icon slot="icon" name="description"></m3e-icon>Documentation</m3e-filter-chip>
+ * </m3e-filter-chip-set>
+ * ```
+ *
  * @tag m3e-filter-chip
  *
  * @slot - Renders the label of the chip.
@@ -557,6 +577,7 @@ var _M3eFilterChipElement_instances, _M3eFilterChipElement_clickHandler, _M3eFil
  *
  * @fires input - Emitted when the selected state changes.
  * @fires change - Emitted when the selected state changes.
+ * @fires click - Emitted when the element is clicked.
  *
  * @cssprop --m3e-chip-container-shape - Border radius of the chip container.
  * @cssprop --m3e-chip-container-height - Base height of the chip container before density adjustment.
@@ -764,7 +785,6 @@ M3eFilterChipElement = __decorate([
 
 var _M3eFilterChipSetElement_instances, _M3eFilterChipSetElement_handleSlotChange, _M3eFilterChipSetElement_handleKeyDown, _M3eFilterChipSetElement_handleChange, _a;
 /**
- * @summary
  * A container that organizes filter chips into a cohesive group, enabling selection and
  * deselection of values used to refine content or trigger contextual behavior.
  *
@@ -917,7 +937,6 @@ const t=globalThis,i=t.trustedTypes,s=i?i.createPolicy("lit-html",{createHTML:t=
 
 var _M3eInputChipElement_instances, _M3eInputChipElement_handleAvatarSlotChange, _M3eInputChipElement_handleRemoveButtonClick, _M3eInputChipElement_handleKeyDown;
 /**
- * @summary
  * A chip which represents a discrete piece of information entered by a user.
  *
  * @description
@@ -925,6 +944,19 @@ var _M3eInputChipElement_instances, _M3eInputChipElement_handleAvatarSlotChange,
  * and manage discrete values such as tags or keywords. It supports expressive styling, accessibility,
  * keyboard interaction, and appearance variants including `elevated` and `outlined`.
  *
+ * @example
+ * The following example illustrates the use of the `m3e-input-chip-set` inside a `m3e-form-field`.
+ * In this example, the `input` slot specifies the `input` element used to add input chips and the
+ * field label's `for` attribute targets the `input` element to provide an accessible label.
+ * ```html
+ * <m3e-form-field>
+ *  <label slot="label" for="keywords">Keywords</label>
+ *  <m3e-input-chip-set aria-label="Enter keywords">
+ *    <input id="keywords" slot="input" placeholder="New keyword..." />
+ *  </m3e-input-chip-set>
+ * </m3e-form-field>
+ * ```
+ *
  * @tag m3e-input-chip
  *
  * @slot - Renders the label of the chip.
@@ -940,6 +972,7 @@ var _M3eInputChipElement_instances, _M3eInputChipElement_handleAvatarSlotChange,
  * @attr variant - The appearance variant of the chip.
  *
  * @fires remove - Emitted when the remove button is clicked or DELETE or BACKSPACE key is pressed.
+ * @fires click - Emitted when the element is clicked.
  *
  * @cssprop --m3e-chip-container-shape - Border radius of the chip container.
  * @cssprop --m3e-chip-container-height - Base height of the chip container before density adjustment.
@@ -1148,7 +1181,6 @@ M3eInputChipElement = __decorate([
 
 var _M3eInputChipSetElement_instances, _M3eInputChipSetElement_inputChangeHandler, _M3eInputChipSetElement_inputKeyDownHandler, _M3eInputChipSetElement_focusHandler, _M3eInputChipSetElement_focusInHandler, _M3eInputChipSetElement_focusOutHandler, _M3eInputChipSetElement_chipRemoveHandler, _M3eInputChipSetElement_chipClickHandler, _M3eInputChipSetElement_listManager, _M3eInputChipSetElement_listKeyManager, _M3eInputChipSetElement_ignoreInputChange, _M3eInputChipSetElement_input, _M3eInputChipSetElement_tabindex, _M3eInputChipSetElement_handleKeyDown, _M3eInputChipSetElement_handleSlotChange, _M3eInputChipSetElement_handleInputSlotChange, _M3eInputChipSetElement_handleFocus, _M3eInputChipSetElement_handleFocusIn, _M3eInputChipSetElement_handleFocusOut, _M3eInputChipSetElement_handleChipRemove, _M3eInputChipSetElement_handleChipClick, _M3eInputChipSetElement_handleInputChange, _M3eInputChipSetElement_handleInputKeyDown;
 /**
- * @summary
  * A container that transforms user input into a cohesive set of interactive chips, supporting entry, editing, and removal of discrete values.
  *
  * @description
@@ -1210,7 +1242,7 @@ let M3eInputChipSetElement = class M3eInputChipSetElement extends RequiredConstr
         // validating required state on change to support form-field integration.
         return [...this.querySelectorAll("m3e-input-chip")];
     }
-    /** The selected values of the set. */
+    /** The values of the set. */
     get value() {
         const values = this.chips.map((x) => x.value);
         return values.length == 0 ? null : values;
@@ -1384,6 +1416,29 @@ _M3eInputChipSetElement_handleInputKeyDown = function _M3eInputChipSetElement_ha
         }
     }
 };
+(() => {
+    const lightDomStyle = new CSSStyleSheet();
+    lightDomStyle.replaceSync(css `
+        m3e-input-chip-set [slot="input"]::placeholder {
+          user-select: none;
+          color: currentColor;
+          transition: opacity ${DesignToken.motion.duration.extraLong1};
+        }
+        m3e-input-chip-set:not(:focus-within) [slot="input"]::placeholder {
+          opacity: 0;
+          transition: 0s;
+        }
+        m3e-input-chip-set:hover [slot="input"]::placeholder {
+          transition: 0s;
+        }
+        @media (prefers-reduced-motion) {
+          m3e-input-chip-set [slot="input"]::placeholder {
+            transition: none !important;
+          }
+        }
+      `.toString());
+    document.adoptedStyleSheets = [...document.adoptedStyleSheets, lightDomStyle];
+})();
 /** The styles of the element. */
 M3eInputChipSetElement.styles = [
     M3eChipSetElement.styles,
@@ -1405,27 +1460,10 @@ M3eInputChipSetElement.styles = [
       ::slotted(m3e-input-chip) {
         min-width: 0;
       }
-      ::slotted([slot="input"])::placeholder {
-        user-select: none;
-        color: currentColor;
-        transition: opacity ${DesignToken.motion.duration.extraLong1};
-      }
-      :host(:not(:focus-within)) ::slotted([slot="input"])::placeholder {
-        opacity: 0;
-        transition: 0s;
-      }
-      :host(:hover) ::slotted([slot="input"])::placeholder {
-        transition: 0s;
-      }
       span[role="row"],
       span[role="gridcell"] {
         display: contents;
       }
-      @media (prefers-reduced-motion) {
-        ::slotted([slot="input"])::placeholder {
-          transition: none !important;
-        }
-      }
     `,
 ];
 M3eInputChipSetElement = __decorate([
@@ -1433,7 +1471,6 @@ M3eInputChipSetElement = __decorate([
 ], M3eInputChipSetElement);
 
 /**
- * @summary
  * A chip used to help narrow a user's intent by presenting dynamically generated suggestions, such as
  * suggested responses or search filters.
  *
@@ -1473,6 +1510,8 @@ M3eInputChipSetElement = __decorate([
  * @attr value - A string representing the value of the chip.
  * @attr variant - The appearance variant of the chip.
  *
+ * @fires click - Emitted when the element is clicked.
+ *
  * @cssprop --m3e-chip-container-shape - Border radius of the chip container.
  * @cssprop --m3e-chip-container-height - Base height of the chip container before density adjustment.
  * @cssprop --m3e-chip-label-text-font-size - Font size of the chip label text.