@pine-ds/core 3.22.1 → 3.24.0

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-04-09T17:22:45",
+  "timestamp": "2026-04-21T19:26:17",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.38.3",
@@ -422,6 +422,10 @@
         {
           "name": "slot",
           "text": "actions - Slot for alert actions."
+        },
+        {
+          "name": "part",
+          "text": "dismiss"
         }
       ],
       "usage": {},
@@ -629,6 +633,14 @@
       "readme": "# pds-avatar\n\n\n",
       "docs": "",
       "docsTags": [
+        {
+          "name": "part",
+          "text": "asset-wrapper"
+        },
+        {
+          "name": "part",
+          "text": "button"
+        },
         {
           "name": "part",
           "text": "image - The main image element that represents the avatar component."
@@ -12506,6 +12518,10 @@
         {
           "name": "slot",
           "text": "(default) - The chip's label text."
+        },
+        {
+          "name": "part",
+          "text": "button"
         }
       ],
       "usage": {},
@@ -12898,7 +12914,8 @@
         }
       ],
       "dependents": [
-        "pds-combobox"
+        "pds-combobox",
+        "pds-multiselect"
       ],
       "dependencies": [
         "pds-icon"
@@ -12909,6 +12926,9 @@
         ],
         "pds-combobox": [
           "pds-chip"
+        ],
+        "pds-multiselect": [
+          "pds-chip"
         ]
       }
     },
@@ -13414,7 +13434,7 @@
           "mutable": false,
           "attr": "hide-label",
           "reflectToAttr": false,
-          "docs": "Visually hides the label text for instances where only the combobox should be displayed.\nLabel remains accessible to assistive technology such as screen readers.",
+          "docs": "Visually hides the label text for instances where only the combobox should be displayed.\nThe visible `<label>` is omitted (same pattern as `pds-select`) so label spacing does not reserve layout;\nthe trigger uses `aria-label` so the name stays available to assistive technology.",
           "docsTags": [
             {
               "name": "default",
@@ -13653,6 +13673,40 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "triggerShape",
+          "type": "\"input\" | \"pill\"",
+          "complexType": {
+            "original": "'pill' | 'input'",
+            "resolved": "\"input\" | \"pill\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "trigger-shape",
+          "reflectToAttr": false,
+          "docs": "The shape of the button trigger. Use 'input' to render the trigger with input-like styling\n(subtle border radius, input height) for use in form or filter rows alongside PdsSelect and PdsMultiselect.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'pill'"
+            }
+          ],
+          "default": "'pill'",
+          "values": [
+            {
+              "value": "input",
+              "type": "string"
+            },
+            {
+              "value": "pill",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "triggerVariant",
           "type": "\"accent\" | \"destructive\" | \"primary\" | \"secondary\"",
@@ -13913,6 +13967,130 @@
         ]
       }
     },
+    {
+      "filePath": "src/components/pds-container/pds-container.tsx",
+      "encapsulation": "shadow",
+      "tag": "pds-container",
+      "readme": "# pds-container\n\n\n",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "container - The inner semantic container element"
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "centered",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "centered",
+          "reflectToAttr": false,
+          "docs": "If `true`, the container is centered horizontally using `margin-inline: auto`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "size",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "size",
+          "reflectToAttr": false,
+          "docs": "Sets the maximum width of the container. Accepts a named size token\n(`'sm'` | `'md'` | `'lg'` | `'xl'` | `'full'`) or any valid CSS length value (e.g. `'640px'`, `'50rem'`).\nWhen omitted, no max-width is applied.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "tag",
+          "type": "\"article\" | \"div\" | \"main\" | \"section\"",
+          "complexType": {
+            "original": "'div' | 'main' | 'section' | 'article'",
+            "resolved": "\"article\" | \"div\" | \"main\" | \"section\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "tag",
+          "reflectToAttr": false,
+          "docs": "Sets the semantic HTML tag rendered as the inner container element.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'div'"
+            }
+          ],
+          "default": "'div'",
+          "values": [
+            {
+              "value": "article",
+              "type": "string"
+            },
+            {
+              "value": "div",
+              "type": "string"
+            },
+            {
+              "value": "main",
+              "type": "string"
+            },
+            {
+              "value": "section",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [
+        {
+          "name": "container",
+          "docs": "The inner semantic container element"
+        }
+      ],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
     {
       "filePath": "src/components/pds-copytext/pds-copytext.tsx",
       "encapsulation": "shadow",
@@ -14371,7 +14549,12 @@
       "tag": "pds-dropdown-menu-item",
       "readme": "# pds-dropdown-item\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "button"
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -16916,6 +17099,14 @@
         {
           "name": "slot",
           "text": "loading - Custom loading indicator"
+        },
+        {
+          "name": "part",
+          "text": "trigger - The trigger surface that opens the dropdown panel"
+        },
+        {
+          "name": "part",
+          "text": "pill-toggle - The chevron button inside the inline pill trigger"
         }
       ],
       "usage": {},
@@ -17427,6 +17618,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "maxInlinePills",
+          "type": "number",
+          "complexType": {
+            "original": "number",
+            "resolved": "number",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "max-inline-pills",
+          "reflectToAttr": false,
+          "docs": "Maximum chips shown inline before collapsing to a \"+N more\" badge.\nOnly applies when `selectedDisplay='pill'` and `pillPosition='inline'`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "3"
+            }
+          ],
+          "default": "3",
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "maxSelections",
           "type": "number",
@@ -17518,7 +17738,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Options provided externally (for consumer-managed async).",
+          "docs": "Options provided externally (for consumer-managed async).\nWhen using `group` on options, keep each group block contiguous in the array.\nThe same `group` label appearing again after other items produces a separate header (same as native `<optgroup>`).",
           "docsTags": [],
           "values": [
             {
@@ -17553,6 +17773,40 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "pillPosition",
+          "type": "\"below\" | \"inline\"",
+          "complexType": {
+            "original": "'inline' | 'below'",
+            "resolved": "\"below\" | \"inline\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "pill-position",
+          "reflectToAttr": false,
+          "docs": "Position of pill chips when `selectedDisplay` is `'pill'`.\n`'inline'` places chips inside the trigger; `'below'` places chips in a\nflex-wrap row directly below the trigger.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'inline'"
+            }
+          ],
+          "default": "'inline'",
+          "values": [
+            {
+              "value": "below",
+              "type": "string"
+            },
+            {
+              "value": "inline",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "placeholder",
           "type": "string",
@@ -17640,6 +17894,40 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "selectedDisplay",
+          "type": "\"count\" | \"pill\"",
+          "complexType": {
+            "original": "'count' | 'pill'",
+            "resolved": "\"count\" | \"pill\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "selected-display",
+          "reflectToAttr": false,
+          "docs": "Display mode for selected items outside the dropdown panel.\n`'count'` shows \"N item(s)\" text in the trigger (default). `'pill'` renders\nselected items as dismissible pds-chip tags.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'count'"
+            }
+          ],
+          "default": "'count'",
+          "values": [
+            {
+              "value": "count",
+              "type": "string"
+            },
+            {
+              "value": "pill",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "triggerWidth",
           "type": "string",
@@ -17864,29 +18152,38 @@
         }
       ],
       "parts": [
+        {
+          "name": "pill-toggle",
+          "docs": "The chevron button inside the inline pill trigger"
+        },
         {
           "name": "trigger",
-          "docs": ""
+          "docs": "The trigger surface that opens the dropdown panel"
         }
       ],
       "dependents": [],
       "dependencies": [
-        "pds-icon",
-        "pds-loader",
         "pds-box",
+        "pds-icon",
         "pds-text",
-        "pds-checkbox"
+        "pds-checkbox",
+        "pds-loader",
+        "pds-chip"
       ],
       "dependencyGraph": {
         "pds-multiselect": [
-          "pds-icon",
-          "pds-loader",
           "pds-box",
+          "pds-icon",
           "pds-text",
-          "pds-checkbox"
+          "pds-checkbox",
+          "pds-loader",
+          "pds-chip"
         ],
         "pds-checkbox": [
           "pds-icon"
+        ],
+        "pds-chip": [
+          "pds-icon"
         ]
       }
     },
@@ -20312,6 +20609,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disabled",
+          "reflectToAttr": true,
+          "docs": "Determines whether or not the sortable is disabled.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dividers",
           "type": "boolean",
@@ -20323,7 +20649,7 @@
           "mutable": false,
           "attr": "dividers",
           "reflectToAttr": true,
-          "docs": "Deternines whether `sortable` items should be divided with border.",
+          "docs": "Determines whether `sortable` items should be divided with border.",
           "docsTags": [
             {
               "name": "default",
@@ -23011,7 +23337,12 @@
       "tag": "pds-toast",
       "readme": "# pds-toast\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "dismiss"
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -23634,7 +23965,7 @@
       "path": "src/components/pds-input/input-interface.ts"
     },
     "src/components/pds-multiselect/multiselect-interface.ts::MultiselectOption": {
-      "declaration": "export interface MultiselectOption {\n  id: string | number;\n  text: string;\n  isCreateOption?: boolean;\n  [key: string]: unknown;\n}",
+      "declaration": "export interface MultiselectOption {\n  id: string | number;\n  text: string;\n  /** When `true`, the option is rendered as non-interactive and cannot be selected. */\n  disabled?: boolean;\n  /**\n   * Optional section label for grouped rendering (with `options` prop or parsed slots).\n   * Options that share a `group` value must be contiguous in the array; non-contiguous\n   * rows with the same label produce separate headers (mirrors native `<optgroup>`).\n   */\n  group?: string;\n  isCreateOption?: boolean;\n  [key: string]: unknown;\n}",
       "docstring": "",
       "path": "src/components/pds-multiselect/multiselect-interface.ts"
     },