@pine-ds/core 4.0.0 → 4.2.0

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-23T19:30:28",
+  "timestamp": "2026-10-06T17:46:04",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -14801,7 +14801,12 @@
       "tag": "pds-divider",
       "readme": "# pds-divider\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "label - Exposes the label text for styling, such as a custom color. Appears only when `label` is set and `vertical` is `false`."
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -14827,6 +14832,29 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "label",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "Text to be displayed as the divider label, centered between two lines. Ignored when `vertical` is `true`.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "offset",
           "type": "\"lg\" | \"md\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"",
@@ -14910,6 +14938,356 @@
       "listeners": [],
       "styles": [],
       "slots": [],
+      "parts": [
+        {
+          "name": "label",
+          "docs": "Exposes the label text for styling, such as a custom color. Appears only when `label` is set and `vertical` is `false`."
+        }
+      ],
+      "states": [],
+      "dependents": [],
+      "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": [],
@@ -17563,6 +17941,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",
@@ -17783,9 +18190,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",
@@ -22960,7 +23373,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": [
             {
@@ -24085,7 +24498,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": [
             {