@carbon/ibm-products-web-components 0.36.0 → 0.37.0

package/custom-elements.json

@@ -123,6 +123,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -188,13 +192,87 @@
         }
       ]
     },
+    {
+      "name": "c4p-action-set",
+      "path": "./src/components/action-set/action-set.ts",
+      "description": "Action Set component - A specialized button set with validation and ordering logic.\nExtends Carbon's button-set with additional features for action buttons.",
+      "attributes": [
+        {
+          "name": "button-size",
+          "description": "The size of buttons to use for the actions.",
+          "type": "\"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\" | undefined"
+        },
+        {
+          "name": "size",
+          "description": "The size of the action set. Different button arrangements are used at\ndifferent sizes, to make best use of the available space.",
+          "type": "\"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\"",
+          "default": "\"md\""
+        },
+        {
+          "name": "disable-stacking",
+          "description": "When true, prevents automatic stacking of buttons even when size would\nnormally trigger stacking (e.g., 'sm' size or 'md' with 3+ actions).\nButtons will remain in a horizontal layout.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "actions",
+          "description": "Array of action button configurations. When provided, buttons will be\nrendered internally instead of using slotted content.",
+          "type": "ActionButton[]",
+          "default": "[]"
+        }
+      ],
+      "properties": [
+        {
+          "name": "stacked",
+          "description": "Computed property: `true` if the buttons are currently stacked.\nThis is derived from size, disableStacking, and button count.",
+          "type": "boolean"
+        },
+        {
+          "name": "buttonSize",
+          "attribute": "button-size",
+          "description": "The size of buttons to use for the actions.",
+          "type": "\"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\" | undefined"
+        },
+        {
+          "name": "size",
+          "attribute": "size",
+          "description": "The size of the action set. Different button arrangements are used at\ndifferent sizes, to make best use of the available space.",
+          "type": "\"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\"",
+          "default": "\"md\""
+        },
+        {
+          "name": "disableStacking",
+          "attribute": "disable-stacking",
+          "description": "When true, prevents automatic stacking of buttons even when size would\nnormally trigger stacking (e.g., 'sm' size or 'md' with 3+ actions).\nButtons will remain in a horizontal layout.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "actions",
+          "attribute": "actions",
+          "description": "Array of action button configurations. When provided, buttons will be\nrendered internally instead of using slotted content.",
+          "type": "ActionButton[]",
+          "default": "[]"
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Slot for cds-button elements (used when actions prop is not provided)"
+        }
+      ]
+    },
     {
       "name": "c4p-big-number-skeleton",
       "path": "./src/components/big-number/big-number-skeleton.ts",
       "attributes": [
         {
           "name": "size",
-          "type": "\"default\" | \"lg\" | \"xl\" | undefined",
+          "type": "\"lg\" | \"xl\" | \"default\" | undefined",
           "default": "\"default\""
         }
       ],
@@ -202,7 +280,7 @@
         {
           "name": "size",
           "attribute": "size",
-          "type": "\"default\" | \"lg\" | \"xl\" | undefined",
+          "type": "\"lg\" | \"xl\" | \"default\" | undefined",
           "default": "\"default\""
         },
         {
@@ -241,7 +319,7 @@
         },
         {
           "name": "size",
-          "type": "\"default\" | \"lg\" | \"xl\"",
+          "type": "\"lg\" | \"xl\" | \"default\"",
           "default": "\"default\""
         },
         {
@@ -296,7 +374,7 @@
         {
           "name": "size",
           "attribute": "size",
-          "type": "\"default\" | \"lg\" | \"xl\"",
+          "type": "\"lg\" | \"xl\" | \"default\"",
           "default": "\"default\""
         },
         {
@@ -694,6 +772,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -842,6 +924,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -1012,6 +1098,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -1144,6 +1234,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -1248,6 +1342,12 @@
           "description": "Specify whether a drop shadow should be rendered on the popover.",
           "type": "boolean | undefined",
           "default": "false"
+        },
+        {
+          "name": "caret",
+          "description": "Specify whether a caret should be rendered on the popover. This is intended to use only for coachmark patterns.",
+          "type": "boolean | undefined",
+          "default": "false"
         }
       ],
       "properties": [
@@ -1292,6 +1392,13 @@
           "type": "boolean | undefined",
           "default": "false"
         },
+        {
+          "name": "caret",
+          "attribute": "caret",
+          "description": "Specify whether a caret should be rendered on the popover. This is intended to use only for coachmark patterns.",
+          "type": "boolean | undefined",
+          "default": "false"
+        },
         {
           "name": "enabledWarnings",
           "description": "Read or set all the enabled warning categories for this class.\n\nThis property is only used in development builds.",
@@ -1374,6 +1481,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -1592,6 +1703,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -1729,6 +1844,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -1845,6 +1964,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -2005,6 +2128,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -2229,6 +2356,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -2457,6 +2588,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -2632,6 +2767,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -2747,6 +2886,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -2934,6 +3077,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -3081,6 +3228,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -3233,6 +3384,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -3648,11 +3803,12 @@
         },
         {
           "name": "dangerDescription",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string"
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean"
         },
         {
@@ -3667,7 +3823,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -3677,17 +3833,17 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND"
         },
         {
@@ -3707,7 +3863,7 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -3719,7 +3875,7 @@
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -3734,12 +3890,12 @@
         },
         {
           "name": "tooltipText",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE"
         },
         {
@@ -4732,7 +4888,7 @@
         },
         {
           "name": "tabIndex",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number"
         }
       ]
@@ -5012,6 +5168,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -5294,6 +5454,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -5407,6 +5571,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -5525,6 +5693,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -5741,6 +5913,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -5944,6 +6120,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -6055,6 +6235,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -6178,11 +6362,12 @@
         },
         {
           "name": "dangerDescription",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string"
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean"
         },
         {
@@ -6197,7 +6382,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -6207,17 +6392,17 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND"
         },
         {
@@ -6237,7 +6422,7 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -6249,7 +6434,7 @@
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -6264,12 +6449,12 @@
         },
         {
           "name": "tooltipText",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE"
         },
         {
@@ -7266,7 +7451,7 @@
         },
         {
           "name": "tabIndex",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number"
         }
       ]
@@ -7395,6 +7580,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -7668,6 +7857,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -7902,6 +8095,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"
@@ -8315,6 +8512,10 @@
           "name": "registry",
           "type": "CustomElementRegistry | undefined"
         },
+        {
+          "name": "c4p-action-set",
+          "type": "CDSActionSet"
+        },
         {
           "name": "set-of-tags-example",
           "type": "SetOfTags"