@momentum-design/components 0.129.25 → 0.129.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/browser/index.js +230 -213
  2. package/dist/browser/index.js.map +3 -3
  3. package/dist/components/announcementdialog/announcementdialog.component.d.ts +4 -9
  4. package/dist/components/announcementdialog/announcementdialog.component.js +4 -9
  5. package/dist/components/buttonlink/buttonlink.component.d.ts +1 -0
  6. package/dist/components/buttonlink/buttonlink.component.js +23 -0
  7. package/dist/components/checkbox/checkbox.component.d.ts +39 -39
  8. package/dist/components/checkbox/checkbox.component.js +39 -39
  9. package/dist/components/checkbox/checkbox.styles.js +10 -10
  10. package/dist/components/chip/chip.component.d.ts +7 -6
  11. package/dist/components/chip/chip.component.js +4 -12
  12. package/dist/components/dialog/dialog.constants.js +6 -4
  13. package/dist/components/linksimple/linksimple.component.d.ts +8 -0
  14. package/dist/components/linksimple/linksimple.component.js +2 -1
  15. package/dist/components/select/select.styles.js +0 -1
  16. package/dist/components/staticcheckbox/staticcheckbox.component.d.ts +19 -19
  17. package/dist/components/staticcheckbox/staticcheckbox.component.js +19 -19
  18. package/dist/components/staticcheckbox/staticcheckbox.styles.js +29 -29
  19. package/dist/components/staticchip/staticchip.component.d.ts +6 -4
  20. package/dist/components/staticchip/staticchip.component.js +3 -10
  21. package/dist/components/statictoggle/statictoggle.styles.js +1 -1
  22. package/dist/custom-elements.json +239 -251
  23. package/dist/react/announcementdialog/index.d.ts +4 -9
  24. package/dist/react/announcementdialog/index.js +4 -9
  25. package/dist/react/checkbox/index.d.ts +19 -26
  26. package/dist/react/checkbox/index.js +19 -26
  27. package/dist/react/chip/index.d.ts +3 -4
  28. package/dist/react/chip/index.js +3 -4
  29. package/dist/react/staticcheckbox/index.d.ts +11 -11
  30. package/dist/react/staticcheckbox/index.js +11 -11
  31. package/dist/react/staticchip/index.d.ts +2 -2
  32. package/dist/react/staticchip/index.js +2 -2
  33. package/package.json +1 -1
@@ -153,8 +153,8 @@
153
153
  "attribute": "disabled",
154
154
  "reflects": true,
155
155
  "inheritedFrom": {
156
- "name": "AccordionButton",
157
- "module": "components/accordionbutton/accordionbutton.component.js"
156
+ "name": "DisabledMixin",
157
+ "module": "utils/mixins/DisabledMixin.js"
158
158
  }
159
159
  },
160
160
  {
@@ -412,8 +412,8 @@
412
412
  "default": "undefined",
413
413
  "fieldName": "disabled",
414
414
  "inheritedFrom": {
415
- "name": "AccordionButton",
416
- "module": "src/components/accordionbutton/accordionbutton.component.ts"
415
+ "name": "DisabledMixin",
416
+ "module": "src/utils/mixins/DisabledMixin.ts"
417
417
  }
418
418
  },
419
419
  {
@@ -1197,6 +1197,7 @@
1197
1197
  "text": "IconNames | undefined"
1198
1198
  },
1199
1199
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
1200
+ "default": "undefined",
1200
1201
  "attribute": "icon-name",
1201
1202
  "inheritedFrom": {
1202
1203
  "name": "IconNameMixin",
@@ -1478,6 +1479,7 @@
1478
1479
  "text": "IconNames | undefined"
1479
1480
  },
1480
1481
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
1482
+ "default": "undefined",
1481
1483
  "fieldName": "iconName",
1482
1484
  "inheritedFrom": {
1483
1485
  "name": "IconNameMixin",
@@ -1877,7 +1879,7 @@
1877
1879
  "declarations": [
1878
1880
  {
1879
1881
  "kind": "class",
1880
- "description": "AnnouncementDialog component is a modal dialog that can be used to display announcements, extending the existing Dialog component.\nIt can be used to create custom dialogs where a illustration, content and footer actions are provided by the consumer.\nThe dialog is available in 4 sizes: medium, large, xlarge and fullscreen. It may also receive custom styling/sizing.\nThe dialog interrupts the user and will block interaction with the rest of the application until it is closed.\n\nThe dialog can be controlled solely through the `visible` property, no trigger element is required.\nIf a `triggerId` is provided, the dialog will manage focus with that element, otherwise it will\nremember the previously focused element before the dialog was opened.\n\nThe dialog is a controlled component, meaning it does not have its own state management for visibility.\nUse the `visible` property to control the visibility of the dialog.\nUse the `onClose` event to handle the close action of the dialog (fired when Close button is clicked\nor Escape is pressed).\n\n**Accessibility notes for consuming (have to be explicitly set when you consume the component)**\n\n- The dialog should have an aria-label or aria-labelledby attribute to provide a label for screen readers.\n- Use aria-labelledby to reference the ID of the element that labels the dialog when there is no visible title.\n\n**Note: Programmatic show/hide requires the ? prefix on the visible attribute**\n- Use `?visible=true/false` as an attribute instead of `visible=true/false`\n- Reference docs for more info: https://lit.dev/docs/templates/expressions/#boolean-attribute-expressions",
1882
+ "description": "AnnouncementDialog component is a modal dialog that can be used to display announcements, extending the existing Dialog component.\nIt can be used to create custom dialogs where a illustration, content and footer actions are provided by the consumer.\nThe dialog is available in 4 sizes: medium, large, xlarge and fullscreen. It may also receive custom styling/sizing.\nThe dialog interrupts the user and will block interaction with the rest of the application until it is closed.\n\nThe dialog can be controlled solely through the `visible` property, no trigger element is required.\nIf a `triggerId` is provided, the dialog will manage focus with that element, otherwise it will\nremember the previously focused element before the dialog was opened.\n\nThe dialog is a controlled component, meaning it does not have its own state management for visibility.\nUse the `visible` property to control the visibility of the dialog.\nUse the `onClose` event to handle the close action of the dialog (fired when Close button is clicked\nor Escape is pressed).\n\n## Accessibility\n- You have to be explicitly set the following attributes:\n * The dialog should have an aria-label or aria-labelledby attribute to provide a label for screen readers.\n * Use aria-labelledby to reference the ID of the element that labels the dialog when there is no visible title.",
1881
1883
  "name": "AnnouncementDialog",
1882
1884
  "cssProperties": [
1883
1885
  {
@@ -3251,7 +3253,7 @@
3251
3253
  "module": "/src/components/dialog/dialog.component"
3252
3254
  },
3253
3255
  "tagName": "mdc-announcementdialog",
3254
- "jsDoc": "/**\n * AnnouncementDialog component is a modal dialog that can be used to display announcements, extending the existing Dialog component.\n * It can be used to create custom dialogs where a illustration, content and footer actions are provided by the consumer.\n * The dialog is available in 4 sizes: medium, large, xlarge and fullscreen. It may also receive custom styling/sizing.\n * The dialog interrupts the user and will block interaction with the rest of the application until it is closed.\n *\n * The dialog can be controlled solely through the `visible` property, no trigger element is required.\n * If a `triggerId` is provided, the dialog will manage focus with that element, otherwise it will\n * remember the previously focused element before the dialog was opened.\n *\n * The dialog is a controlled component, meaning it does not have its own state management for visibility.\n * Use the `visible` property to control the visibility of the dialog.\n * Use the `onClose` event to handle the close action of the dialog (fired when Close button is clicked\n * or Escape is pressed).\n *\n * **Accessibility notes for consuming (have to be explicitly set when you consume the component)**\n *\n * - The dialog should have an aria-label or aria-labelledby attribute to provide a label for screen readers.\n * - Use aria-labelledby to reference the ID of the element that labels the dialog when there is no visible title.\n *\n * **Note: Programmatic show/hide requires the ? prefix on the visible attribute**\n * - Use `?visible=true/false` as an attribute instead of `visible=true/false`\n * - Reference docs for more info: https://lit.dev/docs/templates/expressions/#boolean-attribute-expressions\n *\n * @dependency mdc-button\n * @dependency mdc-illustration\n * @dependency mdc-text\n *\n * @tagname mdc-announcementdialog\n *\n * @event shown - (React: onShown) Dispatched when the dialog is shown\n * @event hidden - (React: onHidden) Dispatched when the dialog is hidden\n * @event created - (React: onCreated) Dispatched when the dialog is created (added to the DOM)\n * @event destroyed - (React: onDestroyed) Dispatched when the dialog is destroyed (removed from the DOM)\n * @event close - (React: onClose) Dispatched when the Close Button is clicked or Escape key is pressed\n * (this does not hide the dialog)\n *\n * @cssproperty --mdc-announcementdialog-illustration-background-color - background color of the illustration section\n * @cssproperty --mdc-dialog-primary-background-color - primary background color of the dialog\n * @cssproperty --mdc-dialog-border-color - border color of the dialog\n * @cssproperty --mdc-dialog-header-text-color - text color of the header/title of the dialog\n * @cssproperty --mdc-dialog-description-text-color - text color of the below header description of the dialog\n * @cssproperty --mdc-dialog-elevation-3 - elevation of the dialog\n * @cssproperty --mdc-dialog-width - width of the dialog\n * @cssproperty --mdc-dialog-height - height of the dialog\n *\n * @csspart body - The main body container that holds the illustration and content sections\n * @csspart illustration-container - The container for the illustration section\n * @csspart content-container - The container for the content section\n * @csspart header-text - The header text\n *\n * @slot header-prefix - Slot for the dialog header content. This can be used to pass custom header content.\n * @slot dialog-body - Slot for the dialog body content\n * @slot illustration-container - Slot for the illustration container section\n * @slot content-container - Slot for the content (header, description, etc) section\n * @slot description-container - Slot for the description in the content (below header) - pass in Text, Links etc as needed.\n * @slot footer-link - This slot is for passing `mdc-link` component within the footer section.\n * @slot footer-button-secondary - This slot is for passing secondary variant of `mdc-button` component\n * within the footer section.\n * @slot footer-button-primary - This slot is for passing primary variant of\n * `mdc-button` component within the footer section.\n * @slot footer - This slot is for passing custom footer content. Only use this if really needed,\n * using the footer-link and footer-button slots is preferred\n */",
3256
+ "jsDoc": "/**\n * AnnouncementDialog component is a modal dialog that can be used to display announcements, extending the existing Dialog component.\n * It can be used to create custom dialogs where a illustration, content and footer actions are provided by the consumer.\n * The dialog is available in 4 sizes: medium, large, xlarge and fullscreen. It may also receive custom styling/sizing.\n * The dialog interrupts the user and will block interaction with the rest of the application until it is closed.\n *\n * The dialog can be controlled solely through the `visible` property, no trigger element is required.\n * If a `triggerId` is provided, the dialog will manage focus with that element, otherwise it will\n * remember the previously focused element before the dialog was opened.\n *\n * The dialog is a controlled component, meaning it does not have its own state management for visibility.\n * Use the `visible` property to control the visibility of the dialog.\n * Use the `onClose` event to handle the close action of the dialog (fired when Close button is clicked\n * or Escape is pressed).\n *\n * ## Accessibility\n * - You have to be explicitly set the following attributes:\n * * The dialog should have an aria-label or aria-labelledby attribute to provide a label for screen readers.\n * * Use aria-labelledby to reference the ID of the element that labels the dialog when there is no visible title.\n *\n * @dependency mdc-illustration\n * @dependency mdc-text\n *\n * @tagname mdc-announcementdialog\n *\n * @event shown - (React: onShown) Dispatched when the dialog is shown\n * @event hidden - (React: onHidden) Dispatched when the dialog is hidden\n * @event created - (React: onCreated) Dispatched when the dialog is created (added to the DOM)\n * @event destroyed - (React: onDestroyed) Dispatched when the dialog is destroyed (removed from the DOM)\n * @event close - (React: onClose) Dispatched when the Close Button is clicked or Escape key is pressed\n * (this does not hide the dialog)\n *\n * @cssproperty --mdc-announcementdialog-illustration-background-color - background color of the illustration section\n * @cssproperty --mdc-dialog-primary-background-color - primary background color of the dialog\n * @cssproperty --mdc-dialog-border-color - border color of the dialog\n * @cssproperty --mdc-dialog-header-text-color - text color of the header/title of the dialog\n * @cssproperty --mdc-dialog-description-text-color - text color of the below header description of the dialog\n * @cssproperty --mdc-dialog-elevation-3 - elevation of the dialog\n * @cssproperty --mdc-dialog-width - width of the dialog\n * @cssproperty --mdc-dialog-height - height of the dialog\n *\n * @csspart body - The main body container that holds the illustration and content sections\n * @csspart illustration-container - The container for the illustration section\n * @csspart content-container - The container for the content section\n * @csspart header-text - The header text\n *\n * @slot header-prefix - Slot for the dialog header content. This can be used to pass custom header content.\n * @slot dialog-body - Slot for the dialog body content\n * @slot illustration-container - Slot for the illustration container section\n * @slot content-container - Slot for the content (header, description, etc) section\n * @slot description-container - Slot for the description in the content (below header) - pass in Text, Links etc as needed.\n * @slot footer-link - This slot is for passing `mdc-link` component within the footer section.\n * @slot footer-button-secondary - This slot is for passing secondary variant of `mdc-button` component\n * within the footer section.\n * @slot footer-button-primary - This slot is for passing primary variant of\n * `mdc-button` component within the footer section.\n * @slot footer - This slot is for passing custom footer content. Only use this if really needed,\n * using the footer-link and footer-button slots is preferred\n */",
3255
3257
  "customElement": true
3256
3258
  }
3257
3259
  ],
@@ -3402,6 +3404,7 @@
3402
3404
  "text": "IconNames | undefined"
3403
3405
  },
3404
3406
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
3407
+ "default": "undefined",
3405
3408
  "attribute": "icon-name",
3406
3409
  "inheritedFrom": {
3407
3410
  "name": "IconNameMixin",
@@ -3575,6 +3578,7 @@
3575
3578
  "text": "IconNames | undefined"
3576
3579
  },
3577
3580
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
3581
+ "default": "undefined",
3578
3582
  "fieldName": "iconName",
3579
3583
  "inheritedFrom": {
3580
3584
  "name": "IconNameMixin",
@@ -3823,6 +3827,7 @@
3823
3827
  "text": "IconNames | undefined"
3824
3828
  },
3825
3829
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
3830
+ "default": "undefined",
3826
3831
  "attribute": "icon-name",
3827
3832
  "inheritedFrom": {
3828
3833
  "name": "IconNameMixin",
@@ -4216,6 +4221,7 @@
4216
4221
  "text": "IconNames | undefined"
4217
4222
  },
4218
4223
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
4224
+ "default": "undefined",
4219
4225
  "fieldName": "iconName",
4220
4226
  "inheritedFrom": {
4221
4227
  "name": "IconNameMixin",
@@ -4568,6 +4574,7 @@
4568
4574
  "text": "IconNames | undefined"
4569
4575
  },
4570
4576
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
4577
+ "default": "undefined",
4571
4578
  "attribute": "icon-name",
4572
4579
  "inheritedFrom": {
4573
4580
  "name": "IconNameMixin",
@@ -4687,6 +4694,7 @@
4687
4694
  "text": "IconNames | undefined"
4688
4695
  },
4689
4696
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
4697
+ "default": "undefined",
4690
4698
  "fieldName": "iconName",
4691
4699
  "inheritedFrom": {
4692
4700
  "name": "IconNameMixin",
@@ -6571,6 +6579,19 @@
6571
6579
  "module": "utils/mixins/ButtonComponentMixin.js"
6572
6580
  }
6573
6581
  },
6582
+ {
6583
+ "kind": "field",
6584
+ "name": "shadowRootOptions",
6585
+ "type": {
6586
+ "text": "object"
6587
+ },
6588
+ "static": true,
6589
+ "default": "{ ...Component.shadowRootOptions, delegatesFocus: true }",
6590
+ "inheritedFrom": {
6591
+ "name": "Linksimple",
6592
+ "module": "components/linksimple/linksimple.component.js"
6593
+ }
6594
+ },
6574
6595
  {
6575
6596
  "kind": "field",
6576
6597
  "name": "size",
@@ -10248,102 +10269,8 @@
10248
10269
  "declarations": [
10249
10270
  {
10250
10271
  "kind": "class",
10251
- "description": "Checkboxes allow users to select multiple options from a list or turn an item/feature on or off.\nThese are often used in forms, settings, and selections in lists.\n\nA checkbox component contains an optional label and an optional helper text.\n\nTo create a group of checkboxes, use the FormFieldGroup component.",
10272
+ "description": "The Checkbox component allows users to select one or multiple options from a list, toggle features on/off,\nor indicate agreement in forms and settings. These are commonly used in forms, lists, and settings panels\nwhere users need to make selections or express preferences.\n\nTo create a group of checkboxes, use the `mdc-formfieldgroup` component.\n\n**Note:** This component internally renders a native checkbox input element with custom styling.\n\n## When to use\nUse checkboxes when users can select multiple options from a list, or when a single checkbox represents a binary choice (e.g., agreeing to terms).\n\n## Accessibility\n- Provide clear labels that describe what the checkbox controls\n- Use `data-aria-label` when a visual label is not present\n- Keyboard navigation: Space to toggle, Tab to navigate, Enter to submit form\n\n## Styling\nUse the `static-checkbox` part to apply custom styles to the checkbox visual element.\nThis part exposes the underlying [StaticCheckbox](?path=/docs/components-decorator-staticcheckbox--docs) component for advanced styling.",
10252
10273
  "name": "Checkbox",
10253
- "cssProperties": [
10254
- {
10255
- "description": "Allows customization of the background color on hover.",
10256
- "name": "--mdc-checkbox-background-color-hover"
10257
- },
10258
- {
10259
- "description": "Background color for a selected checkbox when hovered.",
10260
- "name": "--mdc-checkbox-checked-background-color-hover"
10261
- },
10262
- {
10263
- "description": "Background color for a selected checkbox when pressed.",
10264
- "name": "--mdc-checkbox-checked-pressed-icon-color"
10265
- },
10266
- {
10267
- "description": "Background color for a selected checkbox when pressed.",
10268
- "name": "--mdc-checkbox-pressed-icon-color"
10269
- },
10270
- {
10271
- "description": "Background color for a selected checkbox when disabled.",
10272
- "name": "--mdc-checkbox-disabled-checked-icon-color"
10273
- },
10274
- {
10275
- "description": "Font size for the label text.",
10276
- "name": "--mdc-label-font-size",
10277
- "inheritedFrom": {
10278
- "name": "FormfieldWrapper",
10279
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10280
- }
10281
- },
10282
- {
10283
- "description": "Font weight for the label text.",
10284
- "name": "--mdc-label-font-weight",
10285
- "inheritedFrom": {
10286
- "name": "FormfieldWrapper",
10287
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10288
- }
10289
- },
10290
- {
10291
- "description": "Line height for the label text.",
10292
- "name": "--mdc-label-line-height",
10293
- "inheritedFrom": {
10294
- "name": "FormfieldWrapper",
10295
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10296
- }
10297
- },
10298
- {
10299
- "description": "Color for the label text.",
10300
- "name": "--mdc-label-color",
10301
- "inheritedFrom": {
10302
- "name": "FormfieldWrapper",
10303
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10304
- }
10305
- },
10306
- {
10307
- "description": "Font size for the help text.",
10308
- "name": "--mdc-help-text-font-size",
10309
- "inheritedFrom": {
10310
- "name": "FormfieldWrapper",
10311
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10312
- }
10313
- },
10314
- {
10315
- "description": "Font weight for the help text.",
10316
- "name": "--mdc-help-text-font-weight",
10317
- "inheritedFrom": {
10318
- "name": "FormfieldWrapper",
10319
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10320
- }
10321
- },
10322
- {
10323
- "description": "Line height for the help text.",
10324
- "name": "--mdc-help-text-line-height",
10325
- "inheritedFrom": {
10326
- "name": "FormfieldWrapper",
10327
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10328
- }
10329
- },
10330
- {
10331
- "description": "Color for the help text.",
10332
- "name": "--mdc-help-text-color",
10333
- "inheritedFrom": {
10334
- "name": "FormfieldWrapper",
10335
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10336
- }
10337
- },
10338
- {
10339
- "description": "Color for the required indicator text.",
10340
- "name": "--mdc-required-indicator-color",
10341
- "inheritedFrom": {
10342
- "name": "FormfieldWrapper",
10343
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10344
- }
10345
- }
10346
- ],
10347
10274
  "cssParts": [
10348
10275
  {
10349
10276
  "description": "The label element.",
@@ -10410,7 +10337,7 @@
10410
10337
  }
10411
10338
  },
10412
10339
  {
10413
- "description": "The native checkbox input element.",
10340
+ "description": "The native checkbox input element that provides the interactive functionality.",
10414
10341
  "name": "checkbox-input"
10415
10342
  },
10416
10343
  {
@@ -10418,44 +10345,10 @@
10418
10345
  "name": "text-container"
10419
10346
  },
10420
10347
  {
10421
- "description": "The static checkbox element.",
10348
+ "description": "The staticcheckbox that provides the visual checkbox appearance.",
10422
10349
  "name": "static-checkbox"
10423
10350
  }
10424
10351
  ],
10425
- "slots": [
10426
- {
10427
- "description": "Slot for the label element. If not provided, the `label` property will be used to render the label.",
10428
- "name": "label",
10429
- "inheritedFrom": {
10430
- "name": "FormfieldWrapper",
10431
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10432
- }
10433
- },
10434
- {
10435
- "description": "Slot for the toggletip info icon button. If not provided, the `toggletip-text` property will be used to render the info icon button and toggletip.",
10436
- "name": "toggletip",
10437
- "inheritedFrom": {
10438
- "name": "FormfieldWrapper",
10439
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10440
- }
10441
- },
10442
- {
10443
- "description": "Slot for the helper/validation icon. If not provided, the icon will be rendered based on the `helpTextType` property.",
10444
- "name": "help-icon",
10445
- "inheritedFrom": {
10446
- "name": "FormfieldWrapper",
10447
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10448
- }
10449
- },
10450
- {
10451
- "description": "Slot for the helper/validation text. If not provided, the `helpText` property will be used to render the helper/validation text.",
10452
- "name": "help-text",
10453
- "inheritedFrom": {
10454
- "name": "FormfieldWrapper",
10455
- "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
10456
- }
10457
- }
10458
- ],
10459
10352
  "members": [
10460
10353
  {
10461
10354
  "kind": "field",
@@ -10464,7 +10357,7 @@
10464
10357
  "text": "boolean"
10465
10358
  },
10466
10359
  "default": "false",
10467
- "description": "Automatically focus on the element when the page loads.\n[MDN Reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)",
10360
+ "description": "Automatically focuses the checkbox when the page loads.\n[MDN Reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)",
10468
10361
  "attribute": "autofocus",
10469
10362
  "reflects": true
10470
10363
  },
@@ -10490,7 +10383,7 @@
10490
10383
  "text": "boolean"
10491
10384
  },
10492
10385
  "default": "false",
10493
- "description": "Determines whether the checkbox is selected or unselected.",
10386
+ "description": "Determines whether the checkbox is checked (selected) or unchecked.",
10494
10387
  "attribute": "checked",
10495
10388
  "reflects": true
10496
10389
  },
@@ -10537,45 +10430,6 @@
10537
10430
  "module": "utils/mixins/DisabledMixin.js"
10538
10431
  }
10539
10432
  },
10540
- {
10541
- "kind": "method",
10542
- "name": "handleChange",
10543
- "privacy": "public",
10544
- "return": {
10545
- "type": {
10546
- "text": "void"
10547
- }
10548
- },
10549
- "parameters": [
10550
- {
10551
- "name": "event",
10552
- "type": {
10553
- "text": "Event"
10554
- }
10555
- }
10556
- ],
10557
- "description": "Toggles the state of the checkbox element.\nand dispatch the new change event."
10558
- },
10559
- {
10560
- "kind": "method",
10561
- "name": "handleKeyDown",
10562
- "privacy": "private",
10563
- "return": {
10564
- "type": {
10565
- "text": "void"
10566
- }
10567
- },
10568
- "parameters": [
10569
- {
10570
- "name": "event",
10571
- "type": {
10572
- "text": "KeyboardEvent"
10573
- },
10574
- "description": "The keyboard event."
10575
- }
10576
- ],
10577
- "description": "Handles the keydown event on the checkbox.\nWhen the user presses Enter, the form is submitted."
10578
- },
10579
10433
  {
10580
10434
  "kind": "field",
10581
10435
  "name": "helpText",
@@ -10596,7 +10450,7 @@
10596
10450
  "type": {
10597
10451
  "text": "ValidationType"
10598
10452
  },
10599
- "description": "The type of help text/validation. It can be 'default' or 'error'.",
10453
+ "description": "Determines the visual style of the helper text.\n- **default**: Standard helper text appearance\n- **error**: Error state with validation styling",
10600
10454
  "default": "'default'",
10601
10455
  "attribute": "help-text-type",
10602
10456
  "reflects": true,
@@ -10612,7 +10466,7 @@
10612
10466
  "text": "boolean"
10613
10467
  },
10614
10468
  "default": "false",
10615
- "description": "This property is used to determine the parent checkbox in a nested checkbox group.\nIf any one of the children is unselected, then the parent checkbox will be indeterminate.\nIf all children are either selected or unselected, then the parent checkbox will not be indeterminate.",
10469
+ "description": "Determines whether the checkbox is in an indeterminate (mixed) state.\nTypically used in nested checkbox groups where the parent checkbox represents partial selection.\n- If any child is unchecked, the parent appears indeterminate.\n- If all children share the same state (all checked or all unchecked), the parent is not indeterminate.",
10616
10470
  "attribute": "indeterminate",
10617
10471
  "reflects": true
10618
10472
  },
@@ -10644,12 +10498,6 @@
10644
10498
  "module": "components/formfieldwrapper/formfieldwrapper.component.js"
10645
10499
  }
10646
10500
  },
10647
- {
10648
- "kind": "method",
10649
- "name": "manageRequired",
10650
- "privacy": "private",
10651
- "description": "Manages the required state of the checkbox.\nIf the checkbox is not checked and the required property is set, then the checkbox is invalid."
10652
- },
10653
10501
  {
10654
10502
  "kind": "field",
10655
10503
  "name": "name",
@@ -10740,11 +10588,6 @@
10740
10588
  "module": "components/formfieldwrapper/formfieldwrapper.component.js"
10741
10589
  }
10742
10590
  },
10743
- {
10744
- "kind": "field",
10745
- "name": "renderLabelAndHelperText",
10746
- "privacy": "private"
10747
- },
10748
10591
  {
10749
10592
  "kind": "method",
10750
10593
  "name": "renderLabelElement",
@@ -10783,12 +10626,6 @@
10783
10626
  "module": "components/formfieldwrapper/formfieldwrapper.component.js"
10784
10627
  }
10785
10628
  },
10786
- {
10787
- "kind": "method",
10788
- "name": "setFormValue",
10789
- "privacy": "private",
10790
- "description": "Updates the form value to reflect the current state of the checkbox.\nIf checked, the value is set to either the user-provided value or 'on' if no value is provided.\nIf unchecked, the value is set to null."
10791
- },
10792
10629
  {
10793
10630
  "kind": "method",
10794
10631
  "name": "setValidity",
@@ -10818,17 +10655,6 @@
10818
10655
  "module": "components/formfieldwrapper/formfieldwrapper.component.js"
10819
10656
  }
10820
10657
  },
10821
- {
10822
- "kind": "method",
10823
- "name": "toggleState",
10824
- "privacy": "private",
10825
- "return": {
10826
- "type": {
10827
- "text": "void"
10828
- }
10829
- },
10830
- "description": "Toggles the state of the checkbox element.\nIf the element is not disabled, soft-disabled, or readonly, then\nthe checked property is toggled and the indeterminate property is set to false."
10831
- },
10832
10658
  {
10833
10659
  "kind": "field",
10834
10660
  "name": "toggletipPlacement",
@@ -10948,7 +10774,7 @@
10948
10774
  "text": "boolean"
10949
10775
  },
10950
10776
  "default": "false",
10951
- "description": "Determines whether the checkbox is selected or unselected.",
10777
+ "description": "Determines whether the checkbox is checked (selected) or unchecked.",
10952
10778
  "fieldName": "checked"
10953
10779
  },
10954
10780
  {
@@ -10957,7 +10783,7 @@
10957
10783
  "text": "boolean"
10958
10784
  },
10959
10785
  "default": "false",
10960
- "description": "This property is used to determine the parent checkbox in a nested checkbox group.\nIf any one of the children is unselected, then the parent checkbox will be indeterminate.\nIf all children are either selected or unselected, then the parent checkbox will not be indeterminate.",
10786
+ "description": "Determines whether the checkbox is in an indeterminate (mixed) state.\nTypically used in nested checkbox groups where the parent checkbox represents partial selection.\n- If any child is unchecked, the parent appears indeterminate.\n- If all children share the same state (all checked or all unchecked), the parent is not indeterminate.",
10961
10787
  "fieldName": "indeterminate"
10962
10788
  },
10963
10789
  {
@@ -10966,7 +10792,7 @@
10966
10792
  "text": "boolean"
10967
10793
  },
10968
10794
  "default": "false",
10969
- "description": "Automatically focus on the element when the page loads.\n[MDN Reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)",
10795
+ "description": "Automatically focuses the checkbox when the page loads.\n[MDN Reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)",
10970
10796
  "fieldName": "autofocus"
10971
10797
  },
10972
10798
  {
@@ -10974,7 +10800,7 @@
10974
10800
  "type": {
10975
10801
  "text": "ValidationType"
10976
10802
  },
10977
- "description": "The type of help text/validation. It can be 'default' or 'error'.",
10803
+ "description": "Determines the visual style of the helper text.\n- **default**: Standard helper text appearance\n- **error**: Error state with validation styling",
10978
10804
  "default": "'default'",
10979
10805
  "fieldName": "helpTextType",
10980
10806
  "inheritedFrom": {
@@ -11192,8 +11018,116 @@
11192
11018
  "module": "/src/components/formfieldwrapper/formfieldwrapper.component"
11193
11019
  },
11194
11020
  "tagName": "mdc-checkbox",
11195
- "jsDoc": "/**\n * Checkboxes allow users to select multiple options from a list or turn an item/feature on or off.\n * These are often used in forms, settings, and selections in lists.\n *\n * A checkbox component contains an optional label and an optional helper text.\n *\n * To create a group of checkboxes, use the FormFieldGroup component.\n *\n * @dependency mdc-button\n * @dependency mdc-icon\n * @dependency mdc-staticcheckbox\n * @dependency mdc-text\n * @dependency mdc-toggletip\n *\n * @tagname mdc-checkbox\n *\n * @event change - (React: onChange) Event that gets dispatched when the checkbox state changes.\n * @event focus - (React: onFocus) Event that gets dispatched when the checkbox receives focus.\n *\n * @cssproperty --mdc-checkbox-background-color-hover - Allows customization of the background color on hover.\n * @cssproperty --mdc-checkbox-checked-background-color-hover - Background color for a selected checkbox when hovered.\n * @cssproperty --mdc-checkbox-checked-pressed-icon-color - Background color for a selected checkbox when pressed.\n * @cssproperty --mdc-checkbox-pressed-icon-color - Background color for a selected checkbox when pressed.\n * @cssproperty --mdc-checkbox-disabled-checked-icon-color - Background color for a selected checkbox when disabled.\n * @cssproperty --mdc-label-font-size - Font size for the label text.\n * @cssproperty --mdc-label-font-weight - Font weight for the label text.\n * @cssproperty --mdc-label-line-height - Line height for the label text.\n * @cssproperty --mdc-label-color - Color for the label text.\n * @cssproperty --mdc-help-text-font-size - Font size for the help text.\n * @cssproperty --mdc-help-text-font-weight - Font weight for the help text.\n * @cssproperty --mdc-help-text-line-height - Line height for the help text.\n * @cssproperty --mdc-help-text-color - Color for the help text.\n * @cssproperty --mdc-required-indicator-color - Color for the required indicator text.\n *\n * @slot label - Slot for the label element. If not provided, the `label` property will be used to render the label.\n * @slot toggletip - Slot for the toggletip info icon button. If not provided, the `toggletip-text` property will be used to render the info icon button and toggletip.\n * @slot help-icon - Slot for the helper/validation icon. If not provided, the icon will be rendered based on the `helpTextType` property.\n * @slot help-text - Slot for the helper/validation text. If not provided, the `helpText` property will be used to render the helper/validation text.\n *\n * @csspart label - The label element.\n * @csspart label-text - The container for the label and required indicator elements.\n * @csspart required-indicator - The required indicator element that is displayed next to the label when the `required` property is set to true.\n * @csspart info-icon-btn - The info icon button element that is displayed next to the label when the `toggletip-text` property is set.\n * @csspart label-toggletip - The toggletip element that is displayed when the info icon button is clicked.\n * @csspart help-text - The helper/validation text element.\n * @csspart helper-icon - The helper/validation icon element that is displayed next to the helper/validation text.\n * @csspart help-text-container - The container for the helper/validation icon and text elements.\n * @csspart checkbox-input - The native checkbox input element.\n * @csspart text-container - The container for the label and helper text elements.\n * @csspart static-checkbox - The static checkbox element.\n */",
11196
- "customElement": true
11021
+ "jsDoc": "/**\n * The Checkbox component allows users to select one or multiple options from a list, toggle features on/off,\n * or indicate agreement in forms and settings. These are commonly used in forms, lists, and settings panels\n * where users need to make selections or express preferences.\n *\n * To create a group of checkboxes, use the `mdc-formfieldgroup` component.\n *\n * **Note:** This component internally renders a native checkbox input element with custom styling.\n *\n * ## When to use\n * Use checkboxes when users can select multiple options from a list, or when a single checkbox represents a binary choice (e.g., agreeing to terms).\n *\n * ## Accessibility\n * - Provide clear labels that describe what the checkbox controls\n * - Use `data-aria-label` when a visual label is not present\n * - Keyboard navigation: Space to toggle, Tab to navigate, Enter to submit form\n *\n * ## Styling\n * Use the `static-checkbox` part to apply custom styles to the checkbox visual element.\n * This part exposes the underlying [StaticCheckbox](?path=/docs/components-decorator-staticcheckbox--docs) component for advanced styling.\n *\n * @dependency mdc-button\n * @dependency mdc-icon\n * @dependency mdc-staticcheckbox\n * @dependency mdc-text\n * @dependency mdc-toggletip\n *\n * @tagname mdc-checkbox\n *\n * @event change - (React: onChange) Event that gets dispatched when the checkbox state changes.\n * @event focus - (React: onFocus) Event that gets dispatched when the checkbox receives focus.\n *\n * @csspart label - The label element.\n * @csspart label-text - The container for the label and required indicator elements.\n * @csspart required-indicator - The required indicator element that is displayed next to the label when the `required` property is set to true.\n * @csspart info-icon-btn - The info icon button element that is displayed next to the label when the `toggletip-text` property is set.\n * @csspart label-toggletip - The toggletip element that is displayed when the info icon button is clicked.\n * @csspart help-text - The helper/validation text element.\n * @csspart helper-icon - The helper/validation icon element that is displayed next to the helper/validation text.\n * @csspart help-text-container - The container for the helper/validation icon and text elements.\n * @csspart checkbox-input - The native checkbox input element that provides the interactive functionality.\n * @csspart text-container - The container for the label and helper text elements.\n * @csspart static-checkbox - The staticcheckbox that provides the visual checkbox appearance.\n */",
11022
+ "customElement": true,
11023
+ "slots": [
11024
+ {
11025
+ "description": "Slot for the label element. If not provided, the `label` property will be used to render the label.",
11026
+ "name": "label",
11027
+ "inheritedFrom": {
11028
+ "name": "FormfieldWrapper",
11029
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11030
+ }
11031
+ },
11032
+ {
11033
+ "description": "Slot for the toggletip info icon button. If not provided, the `toggletip-text` property will be used to render the info icon button and toggletip.",
11034
+ "name": "toggletip",
11035
+ "inheritedFrom": {
11036
+ "name": "FormfieldWrapper",
11037
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11038
+ }
11039
+ },
11040
+ {
11041
+ "description": "Slot for the helper/validation icon. If not provided, the icon will be rendered based on the `helpTextType` property.",
11042
+ "name": "help-icon",
11043
+ "inheritedFrom": {
11044
+ "name": "FormfieldWrapper",
11045
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11046
+ }
11047
+ },
11048
+ {
11049
+ "description": "Slot for the helper/validation text. If not provided, the `helpText` property will be used to render the helper/validation text.",
11050
+ "name": "help-text",
11051
+ "inheritedFrom": {
11052
+ "name": "FormfieldWrapper",
11053
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11054
+ }
11055
+ }
11056
+ ],
11057
+ "cssProperties": [
11058
+ {
11059
+ "description": "Font size for the label text.",
11060
+ "name": "--mdc-label-font-size",
11061
+ "inheritedFrom": {
11062
+ "name": "FormfieldWrapper",
11063
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11064
+ }
11065
+ },
11066
+ {
11067
+ "description": "Font weight for the label text.",
11068
+ "name": "--mdc-label-font-weight",
11069
+ "inheritedFrom": {
11070
+ "name": "FormfieldWrapper",
11071
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11072
+ }
11073
+ },
11074
+ {
11075
+ "description": "Line height for the label text.",
11076
+ "name": "--mdc-label-line-height",
11077
+ "inheritedFrom": {
11078
+ "name": "FormfieldWrapper",
11079
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11080
+ }
11081
+ },
11082
+ {
11083
+ "description": "Color for the label text.",
11084
+ "name": "--mdc-label-color",
11085
+ "inheritedFrom": {
11086
+ "name": "FormfieldWrapper",
11087
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11088
+ }
11089
+ },
11090
+ {
11091
+ "description": "Font size for the help text.",
11092
+ "name": "--mdc-help-text-font-size",
11093
+ "inheritedFrom": {
11094
+ "name": "FormfieldWrapper",
11095
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11096
+ }
11097
+ },
11098
+ {
11099
+ "description": "Font weight for the help text.",
11100
+ "name": "--mdc-help-text-font-weight",
11101
+ "inheritedFrom": {
11102
+ "name": "FormfieldWrapper",
11103
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11104
+ }
11105
+ },
11106
+ {
11107
+ "description": "Line height for the help text.",
11108
+ "name": "--mdc-help-text-line-height",
11109
+ "inheritedFrom": {
11110
+ "name": "FormfieldWrapper",
11111
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11112
+ }
11113
+ },
11114
+ {
11115
+ "description": "Color for the help text.",
11116
+ "name": "--mdc-help-text-color",
11117
+ "inheritedFrom": {
11118
+ "name": "FormfieldWrapper",
11119
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11120
+ }
11121
+ },
11122
+ {
11123
+ "description": "Color for the required indicator text.",
11124
+ "name": "--mdc-required-indicator-color",
11125
+ "inheritedFrom": {
11126
+ "name": "FormfieldWrapper",
11127
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
11128
+ }
11129
+ }
11130
+ ]
11197
11131
  }
11198
11132
  ],
11199
11133
  "exports": [
@@ -11213,7 +11147,7 @@
11213
11147
  "declarations": [
11214
11148
  {
11215
11149
  "kind": "class",
11216
- "description": "mdc-chip is an interactive element that can be used to represent a chip. It supports a leading icon along with label.\nConsumers can wrap this component around a tooltip to provide additional context.\n\nIt is recommended to keep the label text for the chip component concise and compact.\nFor best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.\n\nThis component is built by extending Buttonsimple.",
11150
+ "description": "mdc-chip is an interactive element that can be used to represent a chip. It supports a leading icon along with label.\nConsumers can wrap this component around a tooltip to provide additional context.\n\nIt is recommended to keep the label text for the chip component concise and compact.<br/>\nFor best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.\n\nThis component is built by extending `Buttonsimple`.",
11217
11151
  "name": "Chip",
11218
11152
  "cssProperties": [
11219
11153
  {
@@ -11262,6 +11196,10 @@
11262
11196
  }
11263
11197
  ],
11264
11198
  "cssParts": [
11199
+ {
11200
+ "description": "The icon part of the chip.",
11201
+ "name": "icon"
11202
+ },
11265
11203
  {
11266
11204
  "description": "The label part of the chip.",
11267
11205
  "name": "label"
@@ -11403,6 +11341,7 @@
11403
11341
  "text": "IconNames | undefined"
11404
11342
  },
11405
11343
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
11344
+ "default": "undefined",
11406
11345
  "attribute": "icon-name",
11407
11346
  "inheritedFrom": {
11408
11347
  "name": "IconNameMixin",
@@ -11413,10 +11352,10 @@
11413
11352
  "kind": "field",
11414
11353
  "name": "label",
11415
11354
  "type": {
11416
- "text": "string"
11355
+ "text": "string | undefined"
11417
11356
  },
11418
- "default": "''",
11419
11357
  "description": "The visible label text of the chip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
11358
+ "default": "undefined",
11420
11359
  "attribute": "label"
11421
11360
  },
11422
11361
  {
@@ -11674,10 +11613,10 @@
11674
11613
  {
11675
11614
  "name": "label",
11676
11615
  "type": {
11677
- "text": "string"
11616
+ "text": "string | undefined"
11678
11617
  },
11679
- "default": "''",
11680
11618
  "description": "The visible label text of the chip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
11619
+ "default": "undefined",
11681
11620
  "fieldName": "label"
11682
11621
  },
11683
11622
  {
@@ -11686,6 +11625,7 @@
11686
11625
  "text": "IconNames | undefined"
11687
11626
  },
11688
11627
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
11628
+ "default": "undefined",
11689
11629
  "fieldName": "iconName",
11690
11630
  "inheritedFrom": {
11691
11631
  "name": "IconNameMixin",
@@ -11845,7 +11785,7 @@
11845
11785
  "module": "/src/components/buttonsimple/buttonsimple.component"
11846
11786
  },
11847
11787
  "tagName": "mdc-chip",
11848
- "jsDoc": "/**\n * mdc-chip is an interactive element that can be used to represent a chip. It supports a leading icon along with label.\n * Consumers can wrap this component around a tooltip to provide additional context.\n *\n * It is recommended to keep the label text for the chip component concise and compact.\n * For best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>,\n * including empty spaces to split words.\n *\n * This component is built by extending Buttonsimple.\n *\n * @tagname mdc-chip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the chip.\n * @cssproperty --mdc-chip-border-color - The border color of the chip.\n * @cssproperty --mdc-chip-background-color - The background color of the chip.\n * @cssproperty --mdc-button-height - Height for button size\n *\n * @csspart label - The label part of the chip.\n *\n * @event click - (React: onClick) This event is dispatched when the chip is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the chip.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the chip.\n * @event focus - (React: onFocus) This event is dispatched when the chip receives focus.\n *\n */",
11788
+ "jsDoc": "/**\n * mdc-chip is an interactive element that can be used to represent a chip. It supports a leading icon along with label.\n * Consumers can wrap this component around a tooltip to provide additional context.\n *\n * It is recommended to keep the label text for the chip component concise and compact.<br/>\n * For best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>,\n * including empty spaces to split words.\n *\n * This component is built by extending `Buttonsimple`.\n *\n * @tagname mdc-chip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the chip.\n * @cssproperty --mdc-chip-border-color - The border color of the chip.\n * @cssproperty --mdc-chip-background-color - The background color of the chip.\n *\n * @csspart icon - The icon part of the chip.\n * @csspart label - The label part of the chip.\n *\n * @event click - (React: onClick) This event is dispatched when the chip is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the chip.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the chip.\n * @event focus - (React: onFocus) This event is dispatched when the chip receives focus.\n */",
11849
11789
  "customElement": true,
11850
11790
  "slots": [
11851
11791
  {
@@ -16763,6 +16703,14 @@
16763
16703
  "name": "Chip",
16764
16704
  "module": "src/components/chip/chip.component.ts"
16765
16705
  }
16706
+ },
16707
+ {
16708
+ "description": "The icon part of the chip.",
16709
+ "name": "icon",
16710
+ "inheritedFrom": {
16711
+ "name": "Chip",
16712
+ "module": "src/components/chip/chip.component.ts"
16713
+ }
16766
16714
  }
16767
16715
  ],
16768
16716
  "members": [
@@ -16910,6 +16858,7 @@
16910
16858
  "text": "IconNames | undefined"
16911
16859
  },
16912
16860
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
16861
+ "default": "undefined",
16913
16862
  "attribute": "icon-name",
16914
16863
  "inheritedFrom": {
16915
16864
  "name": "IconNameMixin",
@@ -16920,10 +16869,10 @@
16920
16869
  "kind": "field",
16921
16870
  "name": "label",
16922
16871
  "type": {
16923
- "text": "string"
16872
+ "text": "string | undefined"
16924
16873
  },
16925
- "default": "''",
16926
16874
  "description": "The visible label text of the chip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
16875
+ "default": "undefined",
16927
16876
  "attribute": "label",
16928
16877
  "inheritedFrom": {
16929
16878
  "name": "Chip",
@@ -17218,6 +17167,7 @@
17218
17167
  "text": "IconNames | undefined"
17219
17168
  },
17220
17169
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
17170
+ "default": "undefined",
17221
17171
  "fieldName": "iconName",
17222
17172
  "inheritedFrom": {
17223
17173
  "name": "IconNameMixin",
@@ -17240,10 +17190,10 @@
17240
17190
  {
17241
17191
  "name": "label",
17242
17192
  "type": {
17243
- "text": "string"
17193
+ "text": "string | undefined"
17244
17194
  },
17245
- "default": "''",
17246
17195
  "description": "The visible label text of the chip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
17196
+ "default": "undefined",
17247
17197
  "fieldName": "label",
17248
17198
  "inheritedFrom": {
17249
17199
  "name": "Chip",
@@ -20561,6 +20511,7 @@
20561
20511
  "text": "IconNames | undefined"
20562
20512
  },
20563
20513
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
20514
+ "default": "undefined",
20564
20515
  "attribute": "icon-name",
20565
20516
  "inheritedFrom": {
20566
20517
  "name": "IconNameMixin",
@@ -20633,6 +20584,7 @@
20633
20584
  "text": "IconNames | undefined"
20634
20585
  },
20635
20586
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
20587
+ "default": "undefined",
20636
20588
  "fieldName": "iconName",
20637
20589
  "inheritedFrom": {
20638
20590
  "name": "IconNameMixin",
@@ -20818,6 +20770,7 @@
20818
20770
  "text": "IconNames | undefined"
20819
20771
  },
20820
20772
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
20773
+ "default": "undefined",
20821
20774
  "attribute": "icon-name",
20822
20775
  "inheritedFrom": {
20823
20776
  "name": "IconNameMixin",
@@ -20920,6 +20873,19 @@
20920
20873
  "module": "components/linksimple/linksimple.component.js"
20921
20874
  }
20922
20875
  },
20876
+ {
20877
+ "kind": "field",
20878
+ "name": "shadowRootOptions",
20879
+ "type": {
20880
+ "text": "object"
20881
+ },
20882
+ "static": true,
20883
+ "default": "{ ...Component.shadowRootOptions, delegatesFocus: true }",
20884
+ "inheritedFrom": {
20885
+ "name": "Linksimple",
20886
+ "module": "components/linksimple/linksimple.component.js"
20887
+ }
20888
+ },
20923
20889
  {
20924
20890
  "kind": "field",
20925
20891
  "name": "size",
@@ -21015,6 +20981,7 @@
21015
20981
  "text": "IconNames | undefined"
21016
20982
  },
21017
20983
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
20984
+ "default": "undefined",
21018
20985
  "fieldName": "iconName",
21019
20986
  "inheritedFrom": {
21020
20987
  "name": "IconNameMixin",
@@ -21484,6 +21451,7 @@
21484
21451
  "text": "IconNames | undefined"
21485
21452
  },
21486
21453
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
21454
+ "default": "undefined",
21487
21455
  "attribute": "icon-name",
21488
21456
  "inheritedFrom": {
21489
21457
  "name": "IconNameMixin",
@@ -21786,6 +21754,7 @@
21786
21754
  "text": "IconNames | undefined"
21787
21755
  },
21788
21756
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
21757
+ "default": "undefined",
21789
21758
  "fieldName": "iconName",
21790
21759
  "inheritedFrom": {
21791
21760
  "name": "IconNameMixin",
@@ -22145,6 +22114,15 @@
22145
22114
  ],
22146
22115
  "description": "Sets or removes `aria-disabled` and updates `tabIndex` to reflect\nthe disabled state. When disabled, the element becomes unfocusable;\nwhen enabled, the previous `tabIndex` is restored."
22147
22116
  },
22117
+ {
22118
+ "kind": "field",
22119
+ "name": "shadowRootOptions",
22120
+ "type": {
22121
+ "text": "object"
22122
+ },
22123
+ "static": true,
22124
+ "default": "{ ...Component.shadowRootOptions, delegatesFocus: true }"
22125
+ },
22148
22126
  {
22149
22127
  "kind": "field",
22150
22128
  "name": "target",
@@ -44665,39 +44643,39 @@
44665
44643
  "declarations": [
44666
44644
  {
44667
44645
  "kind": "class",
44668
- "description": "This is a decorative component that is styled to look as a checkbox.\n\nIt has 5 properties - checked, indeterminate, disabled, readonly and soft-disabled.\n\nWe are using the same styling that has been created for the `mdc-checkbox` component.",
44646
+ "description": "StaticCheckbox is a decorative component styled as a checkbox for visual presentation.\nUnlike the interactive `mdc-checkbox`, this component does not handle user interactions or form submissions.\nIt is used purely for displaying checkbox states in read-only scenarios.\n\nThis component supports five display states: checked, indeterminate, disabled, readonly, and soft-disabled.",
44669
44647
  "name": "StaticCheckbox",
44670
44648
  "cssProperties": [
44671
44649
  {
44672
- "description": "Controls the border color of the checkbox.",
44673
- "name": "--mdc-checkbox-border-color"
44650
+ "description": "The border color of the checkbox.",
44651
+ "name": "--mdc-staticcheckbox-border-color"
44674
44652
  },
44675
44653
  {
44676
- "description": "Controls the background color of the checkbox.",
44677
- "name": "--mdc-checkbox-background-color"
44654
+ "description": "The background color of the checkbox.",
44655
+ "name": "--mdc-staticcheckbox-background-color"
44678
44656
  },
44679
44657
  {
44680
- "description": "Controls the icon color of the checkbox.",
44681
- "name": "--mdc-checkbox-icon-color"
44658
+ "description": "The icon color of the checkbox.",
44659
+ "name": "--mdc-staticcheckbox-icon-color"
44682
44660
  },
44683
44661
  {
44684
- "description": "Controls the size of the checkbox.",
44685
- "name": "--mdc-checkbox-size"
44662
+ "description": "The size of the checkbox.",
44663
+ "name": "--mdc-staticcheckbox-size"
44686
44664
  }
44687
44665
  ],
44688
44666
  "cssParts": [
44689
44667
  {
44690
- "description": "The container for the checkbox icon.",
44668
+ "description": "The container for the checkbox icon",
44691
44669
  "name": "icon-container"
44692
44670
  },
44693
44671
  {
44694
- "description": "The checkbox icon.",
44672
+ "description": "The checkbox icon element",
44695
44673
  "name": "checkbox-icon"
44696
44674
  }
44697
44675
  ],
44698
44676
  "slots": [
44699
44677
  {
44700
- "description": "Default slot for adding label text.",
44678
+ "description": "Default slot for adding label text",
44701
44679
  "name": ""
44702
44680
  }
44703
44681
  ],
@@ -44709,7 +44687,7 @@
44709
44687
  "text": "boolean"
44710
44688
  },
44711
44689
  "default": "false",
44712
- "description": "Determines whether the checkbox is selected or unselected.",
44690
+ "description": "Determines whether the checkbox appears checked (selected) or unchecked.",
44713
44691
  "attribute": "checked",
44714
44692
  "reflects": true
44715
44693
  },
@@ -44735,7 +44713,7 @@
44735
44713
  "text": "boolean"
44736
44714
  },
44737
44715
  "default": "false",
44738
- "description": "Determines whether the checkbox is in an indeterminate state.",
44716
+ "description": "Determines whether the checkbox appears in an indeterminate (mixed) state.\nTypically used to represent partial selection in nested checkbox groups.",
44739
44717
  "attribute": "indeterminate",
44740
44718
  "reflects": true
44741
44719
  },
@@ -44746,7 +44724,7 @@
44746
44724
  "text": "boolean"
44747
44725
  },
44748
44726
  "default": "false",
44749
- "description": "Determines whether the checkbox is read-only.",
44727
+ "description": "Determines whether the checkbox appears in a read-only state.\nNote: This is purely visual as StaticCheckbox is non-interactive by design.",
44750
44728
  "attribute": "readonly",
44751
44729
  "reflects": true
44752
44730
  },
@@ -44757,7 +44735,7 @@
44757
44735
  "text": "boolean"
44758
44736
  },
44759
44737
  "default": "false",
44760
- "description": "Determines whether the checkbox is soft-disabled.",
44738
+ "description": "Determines whether the checkbox appears in a soft-disabled state.\nSoft-disabled provides a less prominent disabled appearance than the standard disabled state.\nNote: This is purely visual as StaticCheckbox is non-interactive by design.",
44761
44739
  "attribute": "soft-disabled",
44762
44740
  "reflects": true
44763
44741
  }
@@ -44769,7 +44747,7 @@
44769
44747
  "text": "boolean"
44770
44748
  },
44771
44749
  "default": "false",
44772
- "description": "Determines whether the checkbox is selected or unselected.",
44750
+ "description": "Determines whether the checkbox appears checked (selected) or unchecked.",
44773
44751
  "fieldName": "checked"
44774
44752
  },
44775
44753
  {
@@ -44778,7 +44756,7 @@
44778
44756
  "text": "boolean"
44779
44757
  },
44780
44758
  "default": "false",
44781
- "description": "Determines whether the checkbox is in an indeterminate state.",
44759
+ "description": "Determines whether the checkbox appears in an indeterminate (mixed) state.\nTypically used to represent partial selection in nested checkbox groups.",
44782
44760
  "fieldName": "indeterminate"
44783
44761
  },
44784
44762
  {
@@ -44787,7 +44765,7 @@
44787
44765
  "text": "boolean"
44788
44766
  },
44789
44767
  "default": "false",
44790
- "description": "Determines whether the checkbox is read-only.",
44768
+ "description": "Determines whether the checkbox appears in a read-only state.\nNote: This is purely visual as StaticCheckbox is non-interactive by design.",
44791
44769
  "fieldName": "readonly"
44792
44770
  },
44793
44771
  {
@@ -44796,7 +44774,7 @@
44796
44774
  "text": "boolean"
44797
44775
  },
44798
44776
  "default": "false",
44799
- "description": "Determines whether the checkbox is soft-disabled.",
44777
+ "description": "Determines whether the checkbox appears in a soft-disabled state.\nSoft-disabled provides a less prominent disabled appearance than the standard disabled state.\nNote: This is purely visual as StaticCheckbox is non-interactive by design.",
44800
44778
  "fieldName": "softDisabled"
44801
44779
  },
44802
44780
  {
@@ -44824,7 +44802,7 @@
44824
44802
  "module": "/src/models"
44825
44803
  },
44826
44804
  "tagName": "mdc-staticcheckbox",
44827
- "jsDoc": "/**\n * This is a decorative component that is styled to look as a checkbox.\n *\n * It has 5 properties - checked, indeterminate, disabled, readonly and soft-disabled.\n *\n * We are using the same styling that has been created for the `mdc-checkbox` component.\n *\n * @tagname mdc-staticcheckbox\n *\n * @dependency mdc-icon\n *\n * @cssproperty --mdc-checkbox-border-color - Controls the border color of the checkbox.\n * @cssproperty --mdc-checkbox-background-color - Controls the background color of the checkbox.\n * @cssproperty --mdc-checkbox-icon-color - Controls the icon color of the checkbox.\n * @cssproperty --mdc-checkbox-size - Controls the size of the checkbox.\n *\n * @csspart icon-container - The container for the checkbox icon.\n * @csspart checkbox-icon - The checkbox icon.\n *\n * @slot - Default slot for adding label text.\n */",
44805
+ "jsDoc": "/**\n * StaticCheckbox is a decorative component styled as a checkbox for visual presentation.\n * Unlike the interactive `mdc-checkbox`, this component does not handle user interactions or form submissions.\n * It is used purely for displaying checkbox states in read-only scenarios.\n *\n * This component supports five display states: checked, indeterminate, disabled, readonly, and soft-disabled.\n *\n * @tagname mdc-staticcheckbox\n *\n * @dependency mdc-icon\n *\n * @cssproperty --mdc-staticcheckbox-border-color - The border color of the checkbox.\n * @cssproperty --mdc-staticcheckbox-background-color - The background color of the checkbox.\n * @cssproperty --mdc-staticcheckbox-icon-color - The icon color of the checkbox.\n * @cssproperty --mdc-staticcheckbox-size - The size of the checkbox.\n *\n * @csspart icon-container - The container for the checkbox icon\n * @csspart checkbox-icon - The checkbox icon element\n *\n * @slot - Default slot for adding label text\n */",
44828
44806
  "customElement": true
44829
44807
  }
44830
44808
  ],
@@ -44845,7 +44823,7 @@
44845
44823
  "declarations": [
44846
44824
  {
44847
44825
  "kind": "class",
44848
- "description": "mdc-staticchip is an static element that can be used to represent a chip. It supports a leading icon along with label.\n\nIt is recommended to keep the label text for the chip component concise and compact.\nFor best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>, including empty spaces to split words.",
44826
+ "description": "mdc-staticchip is an static element that can be used to represent a chip. It supports a leading icon along with label.\n\nIt is recommended to keep the label text for the chip component concise and compact.<br/>\nFor best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>, including empty spaces to split words.",
44849
44827
  "name": "StaticChip",
44850
44828
  "cssProperties": [
44851
44829
  {
@@ -44865,6 +44843,10 @@
44865
44843
  {
44866
44844
  "description": "The label of the static chip.",
44867
44845
  "name": "label"
44846
+ },
44847
+ {
44848
+ "description": "The icon of the static chip.",
44849
+ "name": "icon"
44868
44850
  }
44869
44851
  ],
44870
44852
  "members": [
@@ -44886,6 +44868,7 @@
44886
44868
  "text": "IconNames | undefined"
44887
44869
  },
44888
44870
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
44871
+ "default": "undefined",
44889
44872
  "attribute": "icon-name",
44890
44873
  "inheritedFrom": {
44891
44874
  "name": "IconNameMixin",
@@ -44896,10 +44879,10 @@
44896
44879
  "kind": "field",
44897
44880
  "name": "label",
44898
44881
  "type": {
44899
- "text": "string"
44882
+ "text": "string | undefined"
44900
44883
  },
44901
- "default": "''",
44902
44884
  "description": "The visible label text of the chip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
44885
+ "default": "undefined",
44903
44886
  "attribute": "label"
44904
44887
  },
44905
44888
  {
@@ -44927,10 +44910,10 @@
44927
44910
  {
44928
44911
  "name": "label",
44929
44912
  "type": {
44930
- "text": "string"
44913
+ "text": "string | undefined"
44931
44914
  },
44932
- "default": "''",
44933
44915
  "description": "The visible label text of the chip.\n\nWe recommend limiting the <b>maximum length of the label text to 20 characters</b>,\nincluding empty spaces to split words.",
44916
+ "default": "undefined",
44934
44917
  "fieldName": "label"
44935
44918
  },
44936
44919
  {
@@ -44939,6 +44922,7 @@
44939
44922
  "text": "IconNames | undefined"
44940
44923
  },
44941
44924
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
44925
+ "default": "undefined",
44942
44926
  "fieldName": "iconName",
44943
44927
  "inheritedFrom": {
44944
44928
  "name": "IconNameMixin",
@@ -44957,7 +44941,7 @@
44957
44941
  "module": "/src/models"
44958
44942
  },
44959
44943
  "tagName": "mdc-staticchip",
44960
- "jsDoc": "/**\n * mdc-staticchip is an static element that can be used to represent a chip. It supports a leading icon along with label.\n *\n * It is recommended to keep the label text for the chip component concise and compact.\n * For best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>, including empty spaces to split words.\n *\n *\n * @tagname mdc-staticchip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the static chip.\n * @cssproperty --mdc-chip-border-color - The border color of the static chip.\n * @cssproperty --mdc-chip-background-color - The background color of the static chip.\n *\n * @csspart label - The label of the static chip.\n */",
44944
+ "jsDoc": "/**\n * mdc-staticchip is an static element that can be used to represent a chip. It supports a leading icon along with label.\n *\n * It is recommended to keep the label text for the chip component concise and compact.<br/>\n * For best results, we recommend limiting the <b>maximum length of the label text to 20 characters</b>, including empty spaces to split words.\n *\n * @tagname mdc-staticchip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the static chip.\n * @cssproperty --mdc-chip-border-color - The border color of the static chip.\n * @cssproperty --mdc-chip-background-color - The background color of the static chip.\n *\n * @csspart label - The label of the static chip.\n * @csspart icon - The icon of the static chip.\n */",
44961
44945
  "customElement": true
44962
44946
  }
44963
44947
  ],
@@ -46055,6 +46039,7 @@
46055
46039
  "text": "IconNames | undefined"
46056
46040
  },
46057
46041
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
46042
+ "default": "undefined",
46058
46043
  "attribute": "icon-name",
46059
46044
  "inheritedFrom": {
46060
46045
  "name": "IconNameMixin",
@@ -46414,6 +46399,7 @@
46414
46399
  "text": "IconNames | undefined"
46415
46400
  },
46416
46401
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
46402
+ "default": "undefined",
46417
46403
  "fieldName": "iconName",
46418
46404
  "inheritedFrom": {
46419
46405
  "name": "IconNameMixin",
@@ -56482,6 +56468,7 @@
56482
56468
  "text": "IconNames | undefined"
56483
56469
  },
56484
56470
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
56471
+ "default": "undefined",
56485
56472
  "attribute": "icon-name"
56486
56473
  }
56487
56474
  ],
@@ -56492,6 +56479,7 @@
56492
56479
  "text": "IconNames | undefined"
56493
56480
  },
56494
56481
  "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
56482
+ "default": "undefined",
56495
56483
  "fieldName": "iconName"
56496
56484
  }
56497
56485
  ],