@pine-ds/core 4.1.0 → 4.3.0

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-24T21:36:30",
+  "timestamp": "2026-10-08T21:54:46",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -12891,6 +12891,14 @@
         {
           "name": "part",
           "text": "button"
+        },
+        {
+          "name": "part",
+          "text": "dot - Exposes the dot for styling, such as a custom color. Appears only when `dot` is set."
+        },
+        {
+          "name": "part",
+          "text": "icon - Exposes the icon component for styling, such as a custom color. Appears only when `icon` is set."
         }
       ],
       "usage": {},
@@ -12976,6 +12984,29 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "dotColor",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "dot-color",
+          "reflectToAttr": false,
+          "docs": "Sets the dot color. Accepts a sentiment name other than `brand` (e.g. `success`), a color token, or a [valid color value](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value).\nDefaults to the dot color of the chip's sentiment. Only applies when `dot` is set.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "icon",
           "type": "string",
@@ -12999,6 +13030,29 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "iconColor",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "icon-color",
+          "reflectToAttr": false,
+          "docs": "Sets the icon color. Accepts a sentiment name other than `brand` (e.g. `success`), a color token, or a [valid color value](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value).\nDefaults to the chip's text color. Only applies when `icon` is set.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "maxWidth",
           "type": "string",
@@ -13123,10 +13177,10 @@
         },
         {
           "name": "sentiment",
-          "type": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"success\" | \"warning\"",
+          "type": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"solid\" | \"subtle\" | \"success\" | \"warning\"",
           "complexType": {
             "original": "ChipSentimentType",
-            "resolved": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"success\" | \"warning\"",
+            "resolved": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"solid\" | \"subtle\" | \"success\" | \"warning\"",
             "references": {
               "ChipSentimentType": {
                 "location": "import",
@@ -13168,6 +13222,14 @@
               "value": "neutral",
               "type": "string"
             },
+            {
+              "value": "solid",
+              "type": "string"
+            },
+            {
+              "value": "subtle",
+              "type": "string"
+            },
             {
               "value": "success",
               "type": "string"
@@ -13301,6 +13363,14 @@
         {
           "name": "button",
           "docs": ""
+        },
+        {
+          "name": "dot",
+          "docs": "Exposes the dot for styling, such as a custom color. Appears only when `dot` is set."
+        },
+        {
+          "name": "icon",
+          "docs": "Exposes the icon component for styling, such as a custom color. Appears only when `icon` is set."
         }
       ],
       "states": [],
@@ -13489,10 +13559,10 @@
         },
         {
           "name": "chipSentiment",
-          "type": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"success\" | \"warning\"",
+          "type": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"solid\" | \"subtle\" | \"success\" | \"warning\"",
           "complexType": {
             "original": "ChipSentimentType",
-            "resolved": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"success\" | \"warning\"",
+            "resolved": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"solid\" | \"subtle\" | \"success\" | \"warning\"",
             "references": {
               "ChipSentimentType": {
                 "location": "import",
@@ -13534,6 +13604,14 @@
               "value": "neutral",
               "type": "string"
             },
+            {
+              "value": "solid",
+              "type": "string"
+            },
+            {
+              "value": "subtle",
+              "type": "string"
+            },
             {
               "value": "success",
               "type": "string"
@@ -14949,6 +15027,351 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/pds-drawer/pds-drawer.tsx",
+      "encapsulation": "none",
+      "tag": "pds-drawer",
+      "readme": "# pds-drawer\n\n\n",
+      "docs": "A non-modal side panel composed from `pds-modal`.\n\nUnlike `pds-modal`, the page stays interactive while a drawer is open: no\ndimming, no blur, no scroll lock, no click blocking. `pds-drawer` renders a\n`pds-modal` internally with `disableTopLayer` always on and its backdrop\nsuppressed, and adds the edge, width and dismiss behavior a side panel\nneeds on top. It does not reimplement focus, Escape or dialog semantics —\nthose come from `pds-modal` unchanged.",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "componentId",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "component-id",
+          "reflectToAttr": false,
+          "docs": "A unique identifier used for the underlying component `id` attribute.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "initialFocus",
+          "type": "\"auto\" | \"none\"",
+          "complexType": {
+            "original": "'auto' | 'none'",
+            "resolved": "\"auto\" | \"none\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "initial-focus",
+          "reflectToAttr": false,
+          "docs": "Whether to move focus into the drawer when it opens. `auto` is right for\na drawer opened by a direct user action (a click, a deep link the user\njust navigated to). Set to `none` for a drawer that can open from a\nbackground event while the user is mid-task elsewhere on the page —\nmoving focus there would interrupt them, and the page stays live under\na non-modal drawer, so it is a genuine data-entry risk, not just an\nannoyance.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'auto'"
+            }
+          ],
+          "default": "'auto'",
+          "values": [
+            {
+              "value": "auto",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "lightDismiss",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "light-dismiss",
+          "reflectToAttr": false,
+          "docs": "Whether the drawer can be dismissed with a pointerdown outside it.\nReplaces `pds-modal`'s `backdropDismiss` — there is no backdrop to click.\nThis also gates Escape, matching how `backdropDismiss` gates Escape on\n`pds-modal` today: setting this to `false` means the close button is the\nonly way out.\n\nA trigger outside the drawer should only ever set `open` to `true` and\nleave closing to the drawer itself. A toggle-style trigger (`open =\n!open`) fights light dismiss: clicking it while open closes the drawer\non `pointerdown`, then the trigger's own click handler re-opens it.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "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": "Whether the drawer is open",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "scrollable",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "scrollable",
+          "reflectToAttr": false,
+          "docs": "Whether the drawer content should be scrollable",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "side",
+          "type": "\"end\" | \"start\"",
+          "complexType": {
+            "original": "'start' | 'end'",
+            "resolved": "\"end\" | \"start\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "side",
+          "reflectToAttr": false,
+          "docs": "Which edge of the viewport the drawer is docked to. Logical, so this is\nfree under RTL — `end` is the inline-end edge regardless of direction.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'end'"
+            }
+          ],
+          "default": "'end'",
+          "values": [
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "size",
+          "type": "\"md\" | \"sm\"",
+          "complexType": {
+            "original": "'sm' | 'md'",
+            "resolved": "\"md\" | \"sm\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "size",
+          "reflectToAttr": false,
+          "docs": "The drawer's width.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'md'"
+            }
+          ],
+          "default": "'md'",
+          "values": [
+            {
+              "value": "md",
+              "type": "string"
+            },
+            {
+              "value": "sm",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [
+        {
+          "event": "pdsDrawerClose",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the drawer is closed",
+          "docsTags": []
+        },
+        {
+          "event": "pdsDrawerOpen",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the drawer is opened",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "pdsModalClose",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "pdsModalOpen",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "pointerdown",
+          "target": "document",
+          "capture": false,
+          "passive": true
+        }
+      ],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [
+        "pds-modal"
+      ],
+      "dependencyGraph": {
+        "pds-drawer": [
+          "pds-modal"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/pds-drawer/pds-drawer-content/pds-drawer-content.tsx",
+      "encapsulation": "none",
+      "tag": "pds-drawer-content",
+      "readme": "# pds-drawer-content\n\n\n",
+      "docs": "Fills the drawer panel's height by default — unlike `pds-modal-content`,\nwhich caps itself against the viewport for a centered, possibly-shorter\nmodal, a drawer panel is already edge-to-edge, so its content can simply\nflex to fill whatever space the header and footer leave.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
+    {
+      "filePath": "src/components/pds-drawer/pds-drawer-footer/pds-drawer-footer.tsx",
+      "encapsulation": "none",
+      "tag": "pds-drawer-footer",
+      "readme": "# pds-drawer-footer\n\n\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
+    {
+      "filePath": "src/components/pds-drawer/pds-drawer-header/pds-drawer-header.tsx",
+      "encapsulation": "none",
+      "tag": "pds-drawer-header",
+      "readme": "# pds-drawer-header\n\n\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
     {
       "filePath": "src/components/pds-dropdown-menu/pds-dropdown-menu.tsx",
       "encapsulation": "shadow",
@@ -17596,6 +18019,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "disableInitialFocus",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disable-initial-focus",
+          "reflectToAttr": false,
+          "docs": "Whether to skip moving focus into the modal when it opens — both our own\n`setInitialFocus()` and the browser's native \"dialog focusing steps\",\nwhich move focus into the dialog as soon as `show()`/`showModal()` is\ncalled regardless of application code. Focus return on close is\nunaffected either way. For a modal opened by something other than a\ndirect user click — a redirect, a deep link, a background event —\nstealing focus on open can interrupt whatever the user was already\ndoing. Default `false` preserves today's behavior for every existing\nconsumer.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "disableTopLayer",
           "type": "boolean",
@@ -17685,16 +18137,27 @@
         },
         {
           "name": "size",
-          "type": "\"fullscreen\" | \"lg\" | \"md\" | \"sm\"",
+          "type": "\"fullscreen\" | \"lg\" | \"md\" | \"sm\" | string & Record<never, never>",
           "complexType": {
-            "original": "'sm' | 'md' | 'lg' | 'fullscreen'",
-            "resolved": "\"fullscreen\" | \"lg\" | \"md\" | \"sm\"",
-            "references": {}
+            "original": "ModalSizeType | (string & Record<never, never>)",
+            "resolved": "\"fullscreen\" | \"lg\" | \"md\" | \"sm\" | string & Record<never, never>",
+            "references": {
+              "ModalSizeType": {
+                "location": "import",
+                "path": "@utils/types",
+                "id": "src/utils/types.ts::ModalSizeType",
+                "referenceLocation": "ModalSizeType"
+              },
+              "Record": {
+                "location": "global",
+                "id": "global::Record"
+              }
+            }
           },
           "mutable": false,
           "attr": "size",
           "reflectToAttr": false,
-          "docs": "The size of the modal",
+          "docs": "The size of the modal. Can be a predefined value ('sm', 'md', 'lg', 'fullscreen') or a custom\nmax-width as a CSS length (e.g., '1250px', '80vw'). A custom width stays fluid below that size.\nA value that is neither falls back to 'md'.",
           "docsTags": [
             {
               "name": "default",
@@ -17718,6 +18181,9 @@
             {
               "value": "sm",
               "type": "string"
+            },
+            {
+              "type": "string & Record<never, never>"
             }
           ],
           "optional": false,
@@ -17816,9 +18282,15 @@
         }
       ],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "pds-drawer"
+      ],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {
+        "pds-drawer": [
+          "pds-modal"
+        ]
+      }
     },
     {
       "filePath": "src/components/pds-modal/pds-modal-content/pds-modal-content.tsx",
@@ -22993,7 +23465,7 @@
           "mutable": false,
           "attr": "truncate",
           "reflectToAttr": false,
-          "docs": "Truncates content to a max width and adds an ellipsis.\nWhen text overflows, a tooltip showing the full text will appear on hover/focus.\nNote: When truncate is enabled, the element automatically receives tabindex=\"0\" for keyboard accessibility.",
+          "docs": "Truncates content to a max width and adds an ellipsis.\nWhen text overflows, a tooltip showing the full text will appear on hover/focus.\nNote: While the content is overflowing, the cell receives tabindex=\"0\" so the\ntooltip can be reached by keyboard. Content that fits is left out of the tab order.",
           "docsTags": [],
           "values": [
             {
@@ -24118,7 +24590,7 @@
           "mutable": false,
           "attr": "truncate",
           "reflectToAttr": true,
-          "docs": "If set or `true`, the text will be truncated. Must add a `width` to the element.\nWhen text overflows, a tooltip showing the full text will appear on hover/focus.\nNote: When truncate is enabled, the element automatically receives tabindex=\"0\" for keyboard accessibility.",
+          "docs": "If set or `true`, the text will be truncated. Must add a `width` to the element.\nWhen text overflows, a tooltip showing the full text will appear on hover/focus.\nNote: While the text is overflowing, the element receives tabindex=\"0\" so the\ntooltip can be reached by keyboard. Text that fits is left out of the tab order.",
           "docsTags": [],
           "values": [
             {
@@ -25423,7 +25895,7 @@
       "path": "src/utils/types.ts"
     },
     "src/utils/types.ts::ChipSentimentType": {
-      "declaration": "export type ChipSentimentType =\n  'accent'\n  | 'brand'\n  | 'danger'\n  | 'info'\n  | 'neutral'\n  | 'success'\n  | 'warning';",
+      "declaration": "export type ChipSentimentType =\n  'accent'\n  | 'brand'\n  | 'danger'\n  | 'info'\n  | 'neutral'\n  | 'solid'\n  | 'subtle'\n  | 'success'\n  | 'warning';",
       "docstring": "",
       "path": "src/utils/types.ts"
     },
@@ -25482,6 +25954,11 @@
       "docstring": "",
       "path": "src/components/pds-input/input-interface.ts"
     },
+    "src/utils/types.ts::ModalSizeType": {
+      "declaration": "export type ModalSizeType = 'sm' | 'md' | 'lg' | 'fullscreen';",
+      "docstring": "",
+      "path": "src/utils/types.ts"
+    },
     "src/i18n/index.ts::PluralForms": {
       "declaration": "any",
       "docstring": "",

package/dist/esm/{index-Bu9gFIxM.js → index-BU1hN5Vy.js}

@@ -1,4 +1,4 @@
-/* pds-icons v10.4.2, ES Modules */
+/* pds-icons v10.5.1, ES Modules */
 
 const addCircle = "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' class='pdsicon'><path fill-rule='evenodd' d='M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m11-5a1 1 0 0 1 1 1v3h3a1 1 0 1 1 0 2h-3v3a1 1 0 1 1-2 0v-3H8a1 1 0 1 1 0-2h3V8a1 1 0 0 1 1-1'/></svg>";
 const caretDown = "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' class='pdsicon'><path fill-rule='evenodd' d='M5.293 8.293a1 1 0 0 1 1.414 0L12 13.586l5.293-5.293a1 1 0 1 1 1.414 1.414l-6 6a1 1 0 0 1-1.414 0l-6-6a1 1 0 0 1 0-1.414'/></svg>";