@pine-ds/core 4.1.0 → 4.2.0

package/dist/vscode.html-data.json

@@ -7709,6 +7709,136 @@
         }
       ]
     },
+    {
+      "name": "pds-drawer",
+      "description": {
+        "kind": "markdown",
+        "value": "A non-modal side panel. Unlike `pds-modal`, the page stays interactive while a drawer is open — no dimming, no blur, no scroll lock, no click blocking.\n\n**Events:**\n- `pdsDrawerClose` - Emitted when the drawer is closed\n- `pdsDrawerOpen` - Emitted when the drawer is opened"
+      },
+      "attributes": [
+        {
+          "name": "component-id",
+          "description": {
+            "kind": "markdown",
+            "value": "A unique identifier used for the underlying component `id` attribute."
+          }
+        },
+        {
+          "name": "initial-focus",
+          "description": {
+            "kind": "markdown",
+            "value": "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.\n\n**Type:** `\"auto\" | \"none\"`\n\n**Default:** `'auto'`"
+          },
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "none"
+            }
+          ]
+        },
+        {
+          "name": "light-dismiss",
+          "description": {
+            "kind": "markdown",
+            "value": "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.\n\n**Default:** `true`"
+          }
+        },
+        {
+          "name": "open",
+          "description": {
+            "kind": "markdown",
+            "value": "Whether the drawer is open\n\n**Default:** `false`"
+          }
+        },
+        {
+          "name": "scrollable",
+          "description": {
+            "kind": "markdown",
+            "value": "Whether the drawer content should be scrollable\n\n**Default:** `true`"
+          }
+        },
+        {
+          "name": "side",
+          "description": {
+            "kind": "markdown",
+            "value": "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.\n\n**Type:** `\"end\" | \"start\"`\n\n**Default:** `'end'`"
+          },
+          "values": [
+            {
+              "name": "end"
+            },
+            {
+              "name": "start"
+            }
+          ]
+        },
+        {
+          "name": "size",
+          "description": {
+            "kind": "markdown",
+            "value": "The drawer's width.\n\n**Type:** `\"md\" | \"sm\"`\n\n**Default:** `'md'`"
+          },
+          "values": [
+            {
+              "name": "md"
+            },
+            {
+              "name": "sm"
+            }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://pine-design-system.netlify.app/?path=/docs/components-drawer--docs"
+        }
+      ]
+    },
+    {
+      "name": "pds-drawer-content",
+      "description": {
+        "kind": "markdown",
+        "value": "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."
+      },
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://pine-design-system.netlify.app/?path=/docs/components-drawer-content--docs"
+        }
+      ]
+    },
+    {
+      "name": "pds-drawer-footer",
+      "description": {
+        "kind": "markdown",
+        "value": ""
+      },
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://pine-design-system.netlify.app/?path=/docs/components-drawer-footer--docs"
+        }
+      ]
+    },
+    {
+      "name": "pds-drawer-header",
+      "description": {
+        "kind": "markdown",
+        "value": ""
+      },
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://pine-design-system.netlify.app/?path=/docs/components-drawer-header--docs"
+        }
+      ]
+    },
     {
       "name": "pds-dropdown-menu",
       "description": {
@@ -8481,6 +8611,13 @@
             "value": "A unique identifier used for the underlying component `id` attribute."
           }
         },
+        {
+          "name": "disable-initial-focus",
+          "description": {
+            "kind": "markdown",
+            "value": "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.\n\n**Default:** `false`"
+          }
+        },
         {
           "name": "disable-top-layer",
           "description": {
@@ -10181,7 +10318,7 @@
           "name": "truncate",
           "description": {
             "kind": "markdown",
-            "value": "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."
+            "value": "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."
           }
         }
       ],
@@ -10591,7 +10728,7 @@
           "name": "truncate",
           "description": {
             "kind": "markdown",
-            "value": "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."
+            "value": "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."
           }
         },
         {