@carbon/web-components 2.63.0-rc.0 → 2.63.0

package/custom-elements.json

@@ -2082,6 +2082,549 @@
         }
       ]
     },
+    {
+      "name": "cds-card-action",
+      "path": "./src/components/card/card-action.ts",
+      "description": "Card action — wrapper for a single interactive element inside cds-card-actions.\nThe `label` property provides a fallback string for the overflow menu when this\naction is hidden due to container overflow.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "Label shown in the overflow menu when this action is hidden.\nIf omitted, cds-card-actions resolves the label from the inner button.",
+          "type": "string"
+        }
+      ],
+      "properties": [
+        {
+          "name": "label",
+          "attribute": "label",
+          "description": "Label shown in the overflow menu when this action is hidden.\nIf omitted, cds-card-actions resolves the label from the inner button.",
+          "type": "string"
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for a button or icon-button."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-actions",
+      "path": "./src/components/card/card-actions.ts",
+      "description": "Card actions",
+      "attributes": [
+        {
+          "name": "overflow-menu-label",
+          "description": "Label for the overflow menu trigger button.",
+          "type": "string",
+          "default": "\"More actions\""
+        }
+      ],
+      "properties": [
+        {
+          "name": "overflowMenuLabel",
+          "attribute": "overflow-menu-label",
+          "description": "Label for the overflow menu trigger button.",
+          "type": "string",
+          "default": "\"More actions\""
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for cds-card-action elements."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-body",
+      "path": "./src/components/card/card-body.ts",
+      "description": "Card body — primary content area.",
+      "attributes": [
+        {
+          "name": "is-flush",
+          "description": "Remove all padding so content sits flush to the card edges.",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "properties": [
+        {
+          "name": "isFlush",
+          "attribute": "is-flush",
+          "description": "Remove all padding so content sits flush to the card edges.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for free-form content."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-footer",
+      "path": "./src/components/card/card-footer.ts",
+      "description": "Card footer — bottom content/action bar.\n\nMust not be used inside a `clickable` card. When placed inside one,\nthis element renders nothing and logs a console.error — a clickable\ncard renders its own built-in footer affordance automatically.\n\nReflects `has-actions` when any `cds-card-action` element is slotted,\nenabling CSS rule [17] to apply zero-padding / border-top layout without\nany cross-boundary `:has(> .cds--card__action)`.",
+      "properties": [
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for footer content or cds-card-action elements."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-header-media",
+      "path": "./src/components/card/card-header-media.ts",
+      "description": "Card header media — full-width icon/image slot rendered above the title row.",
+      "properties": [
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for an icon, image, or pictogram."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-header",
+      "path": "./src/components/card/card-header.ts",
+      "description": "Card header — header section of the card.",
+      "properties": [
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for cds-card-title, cds-card-title-media, cds-card-actions."
+        },
+        {
+          "name": "decorator",
+          "description": "Slot for cds-ai-label or other decorator element."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-media",
+      "path": "./src/components/card/card-media.ts",
+      "description": "Card media — aspect-ratio media slot.",
+      "attributes": [
+        {
+          "name": "ratio",
+          "description": "Aspect ratio of the media container in vertical layout.\nE.g. `'16x9'`, `'4x3'`, `'1x1'`. Ignored in horizontal layout.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "media-width",
+          "description": "Width of the media column in horizontal layout.\nAccepts any valid CSS width value (e.g. `'200px'`, `'40%'`).\nHas no effect in vertical (default) layout.",
+          "type": "string",
+          "default": "\"'33.33%'\""
+        }
+      ],
+      "properties": [
+        {
+          "name": "ratio",
+          "attribute": "ratio",
+          "description": "Aspect ratio of the media container in vertical layout.\nE.g. `'16x9'`, `'4x3'`, `'1x1'`. Ignored in horizontal layout.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "mediaWidth",
+          "attribute": "media-width",
+          "description": "Width of the media column in horizontal layout.\nAccepts any valid CSS width value (e.g. `'200px'`, `'40%'`).\nHas no effect in vertical (default) layout.",
+          "type": "string",
+          "default": "\"'33.33%'\""
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for an image, video, or other media content."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-title-media",
+      "path": "./src/components/card/card-title-media.ts",
+      "description": "Card title media — media slot positioned to the left of the card title.",
+      "properties": [
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for an icon, avatar, or pictogram."
+        }
+      ]
+    },
+    {
+      "name": "cds-card-title",
+      "path": "./src/components/card/card-title.ts",
+      "description": "Card title — primary heading within cds-card-header.",
+      "attributes": [
+        {
+          "name": "title-truncate",
+          "description": "Enable truncation on the title text row.",
+          "type": "string | null"
+        },
+        {
+          "name": "max-width",
+          "description": "Maximum width applied to the title text row when truncation is active.",
+          "type": "string",
+          "default": "\"'100%'\""
+        },
+        {
+          "name": "label",
+          "description": "Optional label text rendered above the title (plain string).\nSlot `label` takes precedence when populated.",
+          "type": "string"
+        },
+        {
+          "name": "label-truncate",
+          "description": "Enable truncation on the label.",
+          "type": "string | null"
+        },
+        {
+          "name": "description",
+          "description": "Optional description text rendered below the title (plain string).",
+          "type": "string"
+        },
+        {
+          "name": "description-truncate",
+          "description": "Enable truncation on the description.",
+          "type": "string | null"
+        }
+      ],
+      "properties": [
+        {
+          "name": "titleTruncate",
+          "attribute": "title-truncate",
+          "description": "Enable truncation on the title text row.",
+          "type": "string | null"
+        },
+        {
+          "name": "maxWidth",
+          "attribute": "max-width",
+          "description": "Maximum width applied to the title text row when truncation is active.",
+          "type": "string",
+          "default": "\"'100%'\""
+        },
+        {
+          "name": "label",
+          "attribute": "label",
+          "description": "Optional label text rendered above the title (plain string).\nSlot `label` takes precedence when populated.",
+          "type": "string"
+        },
+        {
+          "name": "labelTruncate",
+          "attribute": "label-truncate",
+          "description": "Enable truncation on the label.",
+          "type": "string | null"
+        },
+        {
+          "name": "description",
+          "attribute": "description",
+          "description": "Optional description text rendered below the title (plain string).",
+          "type": "string"
+        },
+        {
+          "name": "descriptionTruncate",
+          "attribute": "description-truncate",
+          "description": "Enable truncation on the description.",
+          "type": "string | null"
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Title text (required)."
+        },
+        {
+          "name": "label",
+          "description": "Rich label content rendered above the title (overrides `label` attr)."
+        },
+        {
+          "name": "title-start",
+          "description": "Leading icon/content (16px productive, 24px expressive)."
+        },
+        {
+          "name": "title-end",
+          "description": "Trailing icon/content."
+        },
+        {
+          "name": "description",
+          "description": "Rich description rendered below the title (overrides `description` attr)."
+        }
+      ]
+    },
+    {
+      "name": "cds-card",
+      "path": "./src/components/card/card.ts",
+      "description": "Card — composable container component.",
+      "attributes": [
+        {
+          "name": "clickable",
+          "description": "Makes the entire card surface interactive.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "density",
+          "description": "Controls heading typography inside the card.",
+          "type": "CARD_DENSITY",
+          "default": "\"productive\""
+        },
+        {
+          "name": "horizontal",
+          "description": "Side-by-side layout: cds-card-media on one side, other content stacked.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "media-position",
+          "description": "Position of the media column when `horizontal` is true.",
+          "type": "CARD_MEDIA_POSITION",
+          "default": "\"'start'\""
+        },
+        {
+          "name": "disabled",
+          "description": "Mutes all interaction.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "download",
+          "description": "The default file name.",
+          "type": "string"
+        },
+        {
+          "name": "href",
+          "description": "Link `href`.",
+          "type": "string"
+        },
+        {
+          "name": "hreflang",
+          "description": "The language of what `href` points to.",
+          "type": "string"
+        },
+        {
+          "name": "inline",
+          "description": "`true` if the link should be inline.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "link-role",
+          "description": "The a11y role for `<a>`.",
+          "type": "string"
+        },
+        {
+          "name": "ping",
+          "description": "URLs to ping.",
+          "type": "string"
+        },
+        {
+          "name": "rel",
+          "description": "The link type.",
+          "type": "string"
+        },
+        {
+          "name": "size",
+          "description": "Link size.",
+          "type": "string",
+          "default": "\"MEDIUM\""
+        },
+        {
+          "name": "target",
+          "description": "The link target.",
+          "type": "string"
+        },
+        {
+          "name": "type",
+          "description": "MIME type of the `target`.",
+          "type": "string"
+        },
+        {
+          "name": "visited",
+          "description": "When enabled, applies Carbon's visited-link styles to browser-controlled :visited link state.",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "properties": [
+        {
+          "name": "cardContext",
+          "type": "CardContextValue",
+          "default": "{\"clickable\":false,\"disabled\":false,\"horizontal\":false}"
+        },
+        {
+          "name": "clickable",
+          "attribute": "clickable",
+          "description": "Makes the entire card surface interactive.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "density",
+          "attribute": "density",
+          "description": "Controls heading typography inside the card.",
+          "type": "CARD_DENSITY",
+          "default": "\"productive\""
+        },
+        {
+          "name": "horizontal",
+          "attribute": "horizontal",
+          "description": "Side-by-side layout: cds-card-media on one side, other content stacked.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "mediaPosition",
+          "attribute": "media-position",
+          "description": "Position of the media column when `horizontal` is true.",
+          "type": "CARD_MEDIA_POSITION",
+          "default": "\"'start'\""
+        },
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Mutes all interaction.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "download",
+          "attribute": "download",
+          "description": "The default file name.",
+          "type": "string"
+        },
+        {
+          "name": "href",
+          "attribute": "href",
+          "description": "Link `href`.",
+          "type": "string"
+        },
+        {
+          "name": "hreflang",
+          "attribute": "hreflang",
+          "description": "The language of what `href` points to.",
+          "type": "string"
+        },
+        {
+          "name": "inline",
+          "attribute": "inline",
+          "description": "`true` if the link should be inline.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "linkRole",
+          "attribute": "link-role",
+          "description": "The a11y role for `<a>`.",
+          "type": "string"
+        },
+        {
+          "name": "ping",
+          "attribute": "ping",
+          "description": "URLs to ping.",
+          "type": "string"
+        },
+        {
+          "name": "rel",
+          "attribute": "rel",
+          "description": "The link type.",
+          "type": "string"
+        },
+        {
+          "name": "size",
+          "attribute": "size",
+          "description": "Link size.",
+          "type": "string",
+          "default": "\"MEDIUM\""
+        },
+        {
+          "name": "target",
+          "attribute": "target",
+          "description": "The link target.",
+          "type": "string"
+        },
+        {
+          "name": "type",
+          "attribute": "type",
+          "description": "MIME type of the `target`.",
+          "type": "string"
+        },
+        {
+          "name": "visited",
+          "attribute": "visited",
+          "description": "When enabled, applies Carbon's visited-link styles to browser-controlled :visited link state.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "shadowRootOptions",
+          "type": "{ delegatesFocus: boolean; mode: ShadowRootMode; slotAssignment?: SlotAssignmentMode | undefined; customElements?: CustomElementRegistry | undefined; registry?: CustomElementRegistry | undefined; }",
+          "default": "{\"delegatesFocus\":true}"
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Default slot for cds-card-header, cds-card-body, cds-card-footer, cds-card-media."
+        },
+        {
+          "name": "decorator",
+          "description": "Slot for cds-ai-label. Sets `has-ai-label` attribute when populated."
+        },
+        {
+          "name": "footer-icon",
+          "description": "Override the default ArrowRight icon in the clickable footer."
+        }
+      ]
+    },
     {
       "name": "cds-chat-button-skeleton",
       "path": "./src/components/chat-button/chat-button-skeleton.ts",
@@ -30049,6 +30592,108 @@
           "default": "\"styles\""
         }
       ]
+    },
+    {
+      "name": "cds-user-avatar",
+      "path": "./src/components/user-avatar/user-avatar.ts",
+      "description": "User Avatar.",
+      "attributes": [
+        {
+          "name": "tooltip-text",
+          "description": "Specify the text of the tooltip.\nCan be string"
+        },
+        {
+          "name": "tooltip-alignment",
+          "description": "Specify the alignment of the tooltip.",
+          "type": "string",
+          "default": "\"bottom\""
+        },
+        {
+          "name": "name",
+          "description": "When passing the name prop, either send the initials to be used or the\nuser's full name. The first two capital letters of the user's name will be\nused as the name."
+        },
+        {
+          "name": "size",
+          "description": "Set the size of the avatar circle.",
+          "type": "string",
+          "default": "\"md\""
+        },
+        {
+          "name": "image",
+          "description": "When passing the image prop, supply a full path to the image to be\ndisplayed."
+        },
+        {
+          "name": "image-description",
+          "description": "When passing the image prop use the imageDescription prop to describe the\nimage for screen reader."
+        },
+        {
+          "name": "background-color",
+          "description": "Specify the background color for UserAvatar.",
+          "type": "string",
+          "default": "\"order-1-cyan\""
+        },
+        {
+          "name": "theme",
+          "description": "Set theme in which the component will be rendered."
+        }
+      ],
+      "properties": [
+        {
+          "name": "tooltipText",
+          "attribute": "tooltip-text",
+          "description": "Specify the text of the tooltip.\nCan be string"
+        },
+        {
+          "name": "tooltipAlignment",
+          "attribute": "tooltip-alignment",
+          "description": "Specify the alignment of the tooltip.",
+          "type": "string",
+          "default": "\"bottom\""
+        },
+        {
+          "name": "name",
+          "attribute": "name",
+          "description": "When passing the name prop, either send the initials to be used or the\nuser's full name. The first two capital letters of the user's name will be\nused as the name."
+        },
+        {
+          "name": "size",
+          "attribute": "size",
+          "description": "Set the size of the avatar circle.",
+          "type": "string",
+          "default": "\"md\""
+        },
+        {
+          "name": "image",
+          "attribute": "image",
+          "description": "When passing the image prop, supply a full path to the image to be\ndisplayed."
+        },
+        {
+          "name": "imageDescription",
+          "attribute": "image-description",
+          "description": "When passing the image prop use the imageDescription prop to describe the\nimage for screen reader."
+        },
+        {
+          "name": "backgroundColor",
+          "attribute": "background-color",
+          "description": "Specify the background color for UserAvatar.",
+          "type": "string",
+          "default": "\"order-1-cyan\""
+        },
+        {
+          "name": "theme",
+          "attribute": "theme",
+          "description": "Set theme in which the component will be rendered."
+        },
+        {
+          "name": "shadowRootOptions",
+          "type": "{ delegatesFocus: boolean; mode: ShadowRootMode; slotAssignment?: SlotAssignmentMode | undefined; customElements?: CustomElementRegistry | undefined; registry?: CustomElementRegistry | undefined; }",
+          "default": "{\"delegatesFocus\":true}"
+        },
+        {
+          "name": "styles",
+          "default": "\"styles\""
+        }
+      ]
     }
   ]
 }

package/es/components/big-number/big-number.js

@@ -9,9 +9,9 @@ import "../../globals/settings.js";
 import { carbonElement } from "../../globals/decorators/carbon-element.js";
 import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import iconLoader from "../../globals/internal/icon-loader.js";
+import { getSupportedLocale } from "../../globals/internal/getSupportedLocale.js";
 import { DefaultLocale, UNKNOWN } from "./constants.js";
 import "./big-number-skeleton.js";
-import { getSupportedLocale } from "../../globals/internal/getSupportedLocale.js";
 import big_number_default$1 from "./big-number.scss.js";
 import { LitElement, html, nothing } from "lit";
 import { property } from "lit/decorators.js";