@pine-ds/core 3.3.0 → 3.4.0

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-06-27T17:07:46",
+  "timestamp": "2025-07-17T17:55:01",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.28.2",
@@ -2886,15 +2886,23 @@
       "parts": [],
       "dependents": [
         "pds-alert",
-        "pds-dropdown-menu"
+        "pds-combobox",
+        "pds-dropdown-menu",
+        "pds-property"
       ],
       "dependencies": [],
       "dependencyGraph": {
         "pds-alert": [
           "pds-box"
         ],
+        "pds-combobox": [
+          "pds-box"
+        ],
         "pds-dropdown-menu": [
           "pds-box"
+        ],
+        "pds-property": [
+          "pds-box"
         ]
       }
     },
@@ -3849,48 +3857,520 @@
           "name": "sentiment",
           "type": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"success\" | \"warning\"",
           "complexType": {
-            "original": "'accent' | 'brand' | 'danger' | 'info' | 'neutral' | 'success' | 'warning'",
-            "resolved": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"success\" | \"warning\"",
+            "original": "'accent' | 'brand' | 'danger' | 'info' | 'neutral' | 'success' | 'warning'",
+            "resolved": "\"accent\" | \"brand\" | \"danger\" | \"info\" | \"neutral\" | \"success\" | \"warning\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "sentiment",
+          "reflectToAttr": false,
+          "docs": "Defines the color scheme of the chip.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'neutral'"
+            }
+          ],
+          "default": "'neutral'",
+          "values": [
+            {
+              "value": "accent",
+              "type": "string"
+            },
+            {
+              "value": "brand",
+              "type": "string"
+            },
+            {
+              "value": "danger",
+              "type": "string"
+            },
+            {
+              "value": "info",
+              "type": "string"
+            },
+            {
+              "value": "neutral",
+              "type": "string"
+            },
+            {
+              "value": "success",
+              "type": "string"
+            },
+            {
+              "value": "warning",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "variant",
+          "type": "\"dropdown\" | \"tag\" | \"text\"",
+          "complexType": {
+            "original": "'text' | 'tag' | 'dropdown'",
+            "resolved": "\"dropdown\" | \"tag\" | \"text\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "variant",
+          "reflectToAttr": false,
+          "docs": "Sets the style variant of the chip.\nNote: This prop is ignored when sentiment is 'brand'.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'text'"
+            }
+          ],
+          "default": "'text'",
+          "values": [
+            {
+              "value": "dropdown",
+              "type": "string"
+            },
+            {
+              "value": "tag",
+              "type": "string"
+            },
+            {
+              "value": "text",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [
+        {
+          "event": "pdsTagCloseClick",
+          "detail": "any",
+          "bubbles": true,
+          "complexType": {
+            "original": "any",
+            "resolved": "any",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Event emitted when the close button is clicked on a tag variant chip.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "(default)",
+          "docs": "The chip's label text."
+        }
+      ],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "pds-icon"
+      ],
+      "dependencyGraph": {
+        "pds-chip": [
+          "pds-icon"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/pds-combobox/pds-combobox.tsx",
+      "encapsulation": "shadow",
+      "tag": "pds-combobox",
+      "readme": "# pds-combobox\n\n\n",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "option - Option elements for the combobox dropdown"
+        },
+        {
+          "name": "slot",
+          "text": "trigger-content - Custom content for the button trigger when customTriggerContent is true"
+        }
+      ],
+      "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": true,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "customOptionLayouts",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "custom-option-layouts",
+          "reflectToAttr": false,
+          "docs": "Enable custom layout content for options. Options with data-layout attribute will render their HTML content.\n⚠️ Security Warning: Only use with trusted content. Basic XSS protection is applied, but avoid user-generated content.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "customTriggerContent",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "custom-trigger-content",
+          "reflectToAttr": false,
+          "docs": "Enable custom layout content for the button trigger via the trigger-content slot.\nWhen true, uses slot content for initial state but updates dynamically with selected option layout.\n⚠️ Security Warning: Only use with trusted content. Basic XSS protection is applied, but avoid user-generated content.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disabled",
+          "reflectToAttr": false,
+          "docs": "If true, the combobox is disabled.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dropdownPlacement",
+          "type": "\"bottom-end\" | \"bottom-start\" | \"top-end\" | \"top-start\"",
+          "complexType": {
+            "original": "'bottom-start' | 'bottom-end' | 'top-start' | 'top-end'",
+            "resolved": "\"bottom-end\" | \"bottom-start\" | \"top-end\" | \"top-start\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "dropdown-placement",
+          "reflectToAttr": false,
+          "docs": "Placement of the dropdown relative to the trigger.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'bottom-start'"
+            }
+          ],
+          "default": "'bottom-start'",
+          "values": [
+            {
+              "value": "bottom-end",
+              "type": "string"
+            },
+            {
+              "value": "bottom-start",
+              "type": "string"
+            },
+            {
+              "value": "top-end",
+              "type": "string"
+            },
+            {
+              "value": "top-start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dropdownWidth",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "dropdown-width",
+          "reflectToAttr": false,
+          "docs": "Width of the dropdown. Any valid CSS width value.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'236px'"
+            }
+          ],
+          "default": "'236px'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "hideLabel",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "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.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "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 combobox label.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "maxHeight",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "max-height",
+          "reflectToAttr": false,
+          "docs": "Maximum height of the dropdown. Can be any valid CSS height value (e.g., '200px', '10rem').\nWhen content exceeds this height, the dropdown will scroll.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "mode",
+          "type": "\"filter\" | \"select-only\"",
+          "complexType": {
+            "original": "'filter' | 'select-only'",
+            "resolved": "\"filter\" | \"select-only\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "mode",
+          "reflectToAttr": false,
+          "docs": "Determines the combobox mode: 'filter' (filter options as you type) or 'select-only' (show all options).",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'filter'"
+            }
+          ],
+          "default": "'filter'",
+          "values": [
+            {
+              "value": "filter",
+              "type": "string"
+            },
+            {
+              "value": "select-only",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "placeholder",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "placeholder",
+          "reflectToAttr": false,
+          "docs": "Placeholder text for the input field.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "trigger",
+          "type": "\"button\" | \"input\"",
+          "complexType": {
+            "original": "'input' | 'button'",
+            "resolved": "\"button\" | \"input\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "trigger",
+          "reflectToAttr": false,
+          "docs": "Determines the combobox trigger: 'input' (editable input) or 'button' (button-like, non-editable).",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'input'"
+            }
+          ],
+          "default": "'input'",
+          "values": [
+            {
+              "value": "button",
+              "type": "string"
+            },
+            {
+              "value": "input",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "triggerVariant",
+          "type": "\"accent\" | \"destructive\" | \"primary\" | \"secondary\"",
+          "complexType": {
+            "original": "'secondary' | 'primary' | 'accent' | 'destructive'",
+            "resolved": "\"accent\" | \"destructive\" | \"primary\" | \"secondary\"",
             "references": {}
           },
           "mutable": false,
-          "attr": "sentiment",
+          "attr": "trigger-variant",
           "reflectToAttr": false,
-          "docs": "Defines the color scheme of the chip.",
+          "docs": "The visual variant for the button trigger. Matches Pine button variants.",
           "docsTags": [
             {
-              "name": "defaultValue",
-              "text": "'neutral'"
+              "name": "default",
+              "text": "'secondary'"
             }
           ],
-          "default": "'neutral'",
+          "default": "'secondary'",
           "values": [
             {
               "value": "accent",
               "type": "string"
             },
             {
-              "value": "brand",
-              "type": "string"
-            },
-            {
-              "value": "danger",
-              "type": "string"
-            },
-            {
-              "value": "info",
-              "type": "string"
-            },
-            {
-              "value": "neutral",
+              "value": "destructive",
               "type": "string"
             },
             {
-              "value": "success",
+              "value": "primary",
               "type": "string"
             },
             {
-              "value": "warning",
+              "value": "secondary",
               "type": "string"
             }
           ],
@@ -3900,35 +4380,50 @@
           "setter": false
         },
         {
-          "name": "variant",
-          "type": "\"dropdown\" | \"tag\" | \"text\"",
+          "name": "triggerWidth",
+          "type": "string",
           "complexType": {
-            "original": "'text' | 'tag' | 'dropdown'",
-            "resolved": "\"dropdown\" | \"tag\" | \"text\"",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
           "mutable": false,
-          "attr": "variant",
+          "attr": "trigger-width",
           "reflectToAttr": false,
-          "docs": "Sets the style variant of the chip.\nNote: This prop is ignored when sentiment is 'brand'.",
+          "docs": "Width of the trigger (button or input). Any valid CSS width value.",
           "docsTags": [
             {
-              "name": "defaultValue",
-              "text": "'text'"
+              "name": "default",
+              "text": "'fit-content'"
             }
           ],
-          "default": "'text'",
+          "default": "'fit-content'",
           "values": [
             {
-              "value": "dropdown",
-              "type": "string"
-            },
-            {
-              "value": "tag",
               "type": "string"
-            },
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "The value of the combobox input.",
+          "docsTags": [],
+          "default": "''",
+          "values": [
             {
-              "value": "text",
               "type": "string"
             }
           ],
@@ -3938,20 +4433,65 @@
           "setter": false
         }
       ],
-      "methods": [],
+      "methods": [
+        {
+          "name": "getSelectedValue",
+          "returns": {
+            "type": "Promise<string>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<string | null>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<string>"
+          },
+          "signature": "getSelectedValue() => Promise<string | null>",
+          "parameters": [],
+          "docs": "Gets the value of the currently selected option.",
+          "docsTags": []
+        },
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the native input element.",
+          "docsTags": []
+        }
+      ],
       "events": [
         {
-          "event": "pdsTagCloseClick",
-          "detail": "any",
+          "event": "pdsComboboxChange",
+          "detail": "{ value: string; }",
           "bubbles": true,
           "complexType": {
-            "original": "any",
-            "resolved": "any",
+            "original": "{ value: string }",
+            "resolved": "{ value: string; }",
             "references": {}
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Event emitted when the close button is clicked on a tag variant chip.",
+          "docs": "Emitted when the value changes.",
           "docsTags": []
         }
       ],
@@ -3959,17 +4499,32 @@
       "styles": [],
       "slots": [
         {
-          "name": "(default)",
-          "docs": "The chip's label text."
+          "name": "option",
+          "docs": "Option elements for the combobox dropdown"
+        },
+        {
+          "name": "trigger-content",
+          "docs": "Custom content for the button trigger when customTriggerContent is true"
+        }
+      ],
+      "parts": [
+        {
+          "name": "button-trigger",
+          "docs": ""
+        },
+        {
+          "name": "input",
+          "docs": ""
         }
       ],
-      "parts": [],
       "dependents": [],
       "dependencies": [
+        "pds-box",
         "pds-icon"
       ],
       "dependencyGraph": {
-        "pds-chip": [
+        "pds-combobox": [
+          "pds-box",
           "pds-icon"
         ]
       }
@@ -4908,6 +5463,10 @@
         {
           "name": "slot",
           "text": "suffix - Content that is displayed visually within the input field after the input field"
+        },
+        {
+          "name": "slot",
+          "text": "action - Content to be displayed in the label area, typically for help icons or links"
         }
       ],
       "usage": {},
@@ -5490,6 +6049,10 @@
       "listeners": [],
       "styles": [],
       "slots": [
+        {
+          "name": "action",
+          "docs": "Content to be displayed in the label area, typically for help icons or links"
+        },
         {
           "name": "append",
           "docs": "Content to be displayed after the input field"
@@ -5508,6 +6071,10 @@
         }
       ],
       "parts": [
+        {
+          "name": "action",
+          "docs": ""
+        },
         {
           "name": "append",
           "docs": ""
@@ -6648,6 +7215,91 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/pds-property/pds-property.tsx",
+      "encapsulation": "shadow",
+      "tag": "pds-property",
+      "readme": "# pds-property\n\n\n",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "(default) - The property text content."
+        }
+      ],
+      "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": "icon",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "icon",
+          "reflectToAttr": false,
+          "docs": "The name of the icon to display before the property text.",
+          "docsTags": [],
+          "default": "'star'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "(default)",
+          "docs": "The property text content."
+        }
+      ],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "pds-box",
+        "pds-icon"
+      ],
+      "dependencyGraph": {
+        "pds-property": [
+          "pds-box",
+          "pds-icon"
+        ]
+      }
+    },
     {
       "filePath": "src/components/pds-radio/pds-radio.tsx",
       "encapsulation": "scoped",
@@ -7234,7 +7886,12 @@
       "tag": "pds-select",
       "readme": "# pds-select\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "action - Content to be displayed in the label area, typically for help icons or links"
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -7559,8 +8216,17 @@
       ],
       "listeners": [],
       "styles": [],
-      "slots": [],
+      "slots": [
+        {
+          "name": "action",
+          "docs": "Content to be displayed in the label area, typically for help icons or links"
+        }
+      ],
       "parts": [
+        {
+          "name": "action",
+          "docs": ""
+        },
         {
           "name": "select",
           "docs": ""
@@ -8903,7 +9569,12 @@
       "tag": "pds-text",
       "readme": "# pds-text\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "content - The text content container"
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -9274,7 +9945,12 @@
       "listeners": [],
       "styles": [],
       "slots": [],
-      "parts": [],
+      "parts": [
+        {
+          "name": "content",
+          "docs": "The text content container"
+        }
+      ],
       "dependents": [
         "pds-alert"
       ],
@@ -9291,7 +9967,12 @@
       "tag": "pds-textarea",
       "readme": "# pds-textarea\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "action - Content to be displayed in the label area, typically for help icons or links"
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -9749,8 +10430,18 @@
       ],
       "listeners": [],
       "styles": [],
-      "slots": [],
-      "parts": [],
+      "slots": [
+        {
+          "name": "action",
+          "docs": "Content to be displayed in the label area, typically for help icons or links"
+        }
+      ],
+      "parts": [
+        {
+          "name": "action",
+          "docs": ""
+        }
+      ],
       "dependents": [],
       "dependencies": [
         "pds-icon"