@momentum-design/components 0.92.4 → 0.92.5

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.
@@ -12178,202 +12178,6 @@
12178
12178
  }
12179
12179
  ]
12180
12180
  },
12181
- {
12182
- "kind": "javascript-module",
12183
- "path": "components/iconprovider/iconprovider.component.js",
12184
- "declarations": [
12185
- {
12186
- "kind": "class",
12187
- "description": "IconProvider component, which allows to be consumed from sub components\n(see `providerUtils.consume` for how to consume)\n\nAttribute `iconSet` can be set to either `momentum-icons` or `custom-icons`.\nIf `momentum-icons` is selected, the icons will be fetched from the\nMomentum Design System icon set per a dynamic JS Import (no need to provide a URL).\nThis requires the consumer to have the `@momentum-designs` package installed and the\nbuild tooling needs to support dynamic imports.\n\nIf `custom-icons` is selected, the icons will be fetched from the provided URL.\nThis requires the consumer to provide a URL from which the icons will be fetched and\nthe consumer needs to make sure to bundle the icons in the application.\n\nIf `cacheStrategy` is provided (only works with iconSet = `custom-icons`), the\nIconProvider will cache the icons in the selected cache (either web-api-cache or in-memory-cache),\nto avoid fetching the same icon multiple times over the network.\nThis is useful when the same icon is used multiple times in the application.\nTo consider:\n- The `in-memory-cache` is not persisted and will be lost when the\nIconProvider is removed from the DOM.\n- The `web-api-cache` is persisted, but only works in https environments\n(https://developer.mozilla.org/en-US/docs/Web/API/Cache).",
12188
- "name": "IconProvider",
12189
- "slots": [
12190
- {
12191
- "description": "children",
12192
- "name": ""
12193
- }
12194
- ],
12195
- "members": [
12196
- {
12197
- "kind": "field",
12198
- "name": "Context",
12199
- "privacy": "public",
12200
- "static": true,
12201
- "description": "Context object of the IconProvider, to be consumed by child components",
12202
- "readonly": true
12203
- },
12204
- {
12205
- "kind": "field",
12206
- "name": "iconSet",
12207
- "type": {
12208
- "text": "IconSet | undefined"
12209
- },
12210
- "description": "Icon set to be used\n\nIf `momentum-icons` is selected, the icons will be fetched from the\nMomentum Design System icon set per a dynamic JS Import (no need to provide a URL).\nThis requires the consumer to have the `@momentum-designs` package installed and the\nbuild tooling needs to support dynamic imports.\n\nIf `custom-icons` is selected, the icons will be fetched from the provided URL.\nThis requires the consumer to provide a URL from which the icons will be fetched and\nthe consumer needs to make sure to bundle the icons in the application.",
12211
- "default": "momentum-icons",
12212
- "attribute": "icon-set",
12213
- "reflects": true
12214
- },
12215
- {
12216
- "kind": "field",
12217
- "name": "url",
12218
- "type": {
12219
- "text": "string | undefined"
12220
- },
12221
- "description": "Url of where icons will be fetched from\n(if Icon set is `custom-icons`, this will be the base url)",
12222
- "attribute": "url"
12223
- },
12224
- {
12225
- "kind": "field",
12226
- "name": "fileExtension",
12227
- "type": {
12228
- "text": "string | undefined"
12229
- },
12230
- "description": "File extension of icons\n(if Icon set is `custom-icons`, this will be the file extension for icons)",
12231
- "default": "svg",
12232
- "attribute": "file-extension",
12233
- "reflects": true
12234
- },
12235
- {
12236
- "kind": "field",
12237
- "name": "lengthUnit",
12238
- "type": {
12239
- "text": "string"
12240
- },
12241
- "description": "Length unit used for sizing of icons",
12242
- "default": "em",
12243
- "attribute": "length-unit",
12244
- "reflects": true
12245
- },
12246
- {
12247
- "kind": "field",
12248
- "name": "size",
12249
- "type": {
12250
- "text": "number | undefined"
12251
- },
12252
- "description": "The default size of the icon.\nIf not set, it falls back to the size defined by the length unit.",
12253
- "default": "1",
12254
- "attribute": "size",
12255
- "reflects": true
12256
- },
12257
- {
12258
- "kind": "field",
12259
- "name": "cacheStrategy",
12260
- "type": {
12261
- "text": "CacheStrategy | undefined"
12262
- },
12263
- "description": "Icons Cache Strategy to use\n\n**Can only be used if Icon set is `custom-icons`**\n\nChoose `in-memory-cache` to cache icons in a JS cache (in-memory cache).\nChoose `web-cache-api` to cache icons using the Web Cache API.\n\nNOTE: `cache-name` must be provided if `cache-strategy` is provided.\n\nIf not provided or invalid value provided, the icons will not be cached.",
12264
- "default": "undefined",
12265
- "attribute": "cache-strategy"
12266
- },
12267
- {
12268
- "kind": "field",
12269
- "name": "cacheName",
12270
- "type": {
12271
- "text": "string | undefined"
12272
- },
12273
- "description": "Icons Cache Name to use (cache strategy must be provided)\n\nIf provided, Icons inside the provider will be cached in the\ncache (determined by `cache-strategy`) with the provided name.\n\nNOTE: `cache-name` requires `cache-strategy` to be set.\n\nIf not provided, the icons will not be cached.",
12274
- "default": "undefined",
12275
- "attribute": "cache-name"
12276
- },
12277
- {
12278
- "kind": "method",
12279
- "name": "updateValuesInContext",
12280
- "privacy": "private"
12281
- },
12282
- {
12283
- "kind": "method",
12284
- "name": "updateContext",
12285
- "privacy": "protected",
12286
- "return": {
12287
- "type": {
12288
- "text": "void"
12289
- }
12290
- }
12291
- }
12292
- ],
12293
- "attributes": [
12294
- {
12295
- "name": "icon-set",
12296
- "type": {
12297
- "text": "IconSet | undefined"
12298
- },
12299
- "description": "Icon set to be used\n\nIf `momentum-icons` is selected, the icons will be fetched from the\nMomentum Design System icon set per a dynamic JS Import (no need to provide a URL).\nThis requires the consumer to have the `@momentum-designs` package installed and the\nbuild tooling needs to support dynamic imports.\n\nIf `custom-icons` is selected, the icons will be fetched from the provided URL.\nThis requires the consumer to provide a URL from which the icons will be fetched and\nthe consumer needs to make sure to bundle the icons in the application.",
12300
- "default": "momentum-icons",
12301
- "fieldName": "iconSet"
12302
- },
12303
- {
12304
- "name": "url",
12305
- "type": {
12306
- "text": "string | undefined"
12307
- },
12308
- "description": "Url of where icons will be fetched from\n(if Icon set is `custom-icons`, this will be the base url)",
12309
- "fieldName": "url"
12310
- },
12311
- {
12312
- "name": "file-extension",
12313
- "type": {
12314
- "text": "string | undefined"
12315
- },
12316
- "description": "File extension of icons\n(if Icon set is `custom-icons`, this will be the file extension for icons)",
12317
- "default": "svg",
12318
- "fieldName": "fileExtension"
12319
- },
12320
- {
12321
- "name": "length-unit",
12322
- "type": {
12323
- "text": "string"
12324
- },
12325
- "description": "Length unit used for sizing of icons",
12326
- "default": "em",
12327
- "fieldName": "lengthUnit"
12328
- },
12329
- {
12330
- "name": "size",
12331
- "type": {
12332
- "text": "number | undefined"
12333
- },
12334
- "description": "The default size of the icon.\nIf not set, it falls back to the size defined by the length unit.",
12335
- "default": "1",
12336
- "fieldName": "size"
12337
- },
12338
- {
12339
- "name": "cache-strategy",
12340
- "type": {
12341
- "text": "CacheStrategy | undefined"
12342
- },
12343
- "description": "Icons Cache Strategy to use\n\n**Can only be used if Icon set is `custom-icons`**\n\nChoose `in-memory-cache` to cache icons in a JS cache (in-memory cache).\nChoose `web-cache-api` to cache icons using the Web Cache API.\n\nNOTE: `cache-name` must be provided if `cache-strategy` is provided.\n\nIf not provided or invalid value provided, the icons will not be cached.",
12344
- "default": "undefined",
12345
- "fieldName": "cacheStrategy"
12346
- },
12347
- {
12348
- "name": "cache-name",
12349
- "type": {
12350
- "text": "string | undefined"
12351
- },
12352
- "description": "Icons Cache Name to use (cache strategy must be provided)\n\nIf provided, Icons inside the provider will be cached in the\ncache (determined by `cache-strategy`) with the provided name.\n\nNOTE: `cache-name` requires `cache-strategy` to be set.\n\nIf not provided, the icons will not be cached.",
12353
- "default": "undefined",
12354
- "fieldName": "cacheName"
12355
- }
12356
- ],
12357
- "superclass": {
12358
- "name": "Provider",
12359
- "module": "/src/models"
12360
- },
12361
- "tagName": "mdc-iconprovider",
12362
- "jsDoc": "/**\n * IconProvider component, which allows to be consumed from sub components\n * (see `providerUtils.consume` for how to consume)\n *\n * Attribute `iconSet` can be set to either `momentum-icons` or `custom-icons`.\n * If `momentum-icons` is selected, the icons will be fetched from the\n * Momentum Design System icon set per a dynamic JS Import (no need to provide a URL).\n * This requires the consumer to have the `@momentum-designs` package installed and the\n * build tooling needs to support dynamic imports.\n *\n * If `custom-icons` is selected, the icons will be fetched from the provided URL.\n * This requires the consumer to provide a URL from which the icons will be fetched and\n * the consumer needs to make sure to bundle the icons in the application.\n *\n * If `cacheStrategy` is provided (only works with iconSet = `custom-icons`), the\n * IconProvider will cache the icons in the selected cache (either web-api-cache or in-memory-cache),\n * to avoid fetching the same icon multiple times over the network.\n * This is useful when the same icon is used multiple times in the application.\n * To consider:\n * - The `in-memory-cache` is not persisted and will be lost when the\n * IconProvider is removed from the DOM.\n * - The `web-api-cache` is persisted, but only works in https environments\n * (https://developer.mozilla.org/en-US/docs/Web/API/Cache).\n *\n * @tagname mdc-iconprovider\n *\n * @slot - children\n */",
12363
- "customElement": true
12364
- }
12365
- ],
12366
- "exports": [
12367
- {
12368
- "kind": "js",
12369
- "name": "default",
12370
- "declaration": {
12371
- "name": "IconProvider",
12372
- "module": "components/iconprovider/iconprovider.component.js"
12373
- }
12374
- }
12375
- ]
12376
- },
12377
12181
  {
12378
12182
  "kind": "javascript-module",
12379
12183
  "path": "components/icon/icon.component.js",
@@ -12584,30 +12388,226 @@
12584
12388
  "fieldName": "lengthUnit"
12585
12389
  },
12586
12390
  {
12587
- "name": "aria-label",
12391
+ "name": "aria-label",
12392
+ "type": {
12393
+ "text": "string | null"
12394
+ },
12395
+ "default": "null",
12396
+ "description": "Aria-label attribute to be set for accessibility",
12397
+ "fieldName": "ariaLabel"
12398
+ },
12399
+ {
12400
+ "name": "aria-labelledby",
12401
+ "type": {
12402
+ "text": "string | null"
12403
+ },
12404
+ "default": "null",
12405
+ "description": "Aria-labelledby attribute to be set for accessibility",
12406
+ "fieldName": "ariaLabelledBy"
12407
+ }
12408
+ ],
12409
+ "superclass": {
12410
+ "name": "Component",
12411
+ "module": "/src/models"
12412
+ },
12413
+ "tagName": "mdc-icon",
12414
+ "jsDoc": "/**\n * Icon component that dynamically displays SVG icons based on a valid name.\n *\n * This component must be mounted within an `IconProvider` component.\n *\n * The `IconProvider` defines the source URL from which icons are consumed.\n * The `Icon` component accepts a `name` attribute, which corresponds to\n * the file name of the icon to be loaded from the specified URL.\n *\n * Once fetched, the icon will be rendered. If the fetching process is unsuccessful,\n * no icon will be displayed.\n *\n * The `size` attribute allows for dynamic sizing of the icon based on the provided\n * `length-unit` attribute. This unit can either come from the `IconProvider`\n * or can be overridden for each individual icon. For example:\n * if `size = 1` and `length-unit = 'em'`, the dimensions of the icon will be\n * `width: 1em; height: 1em`.\n *\n * Regarding accessibility, there are three types of icons: decorative, informative and informative standalone.\n *\n * ### Decorative Icons\n * - Decorative icons do not convey any essential information to the content of a page.\n * - They should be hidden from screen readers (SR) to prevent confusion for users.\n * - For decorative icons, an `aria-label` is not required, and the `role` will be set to null.\n *\n * ### Informative Icons\n * - Informative icons convey important information that is not adequately represented\n * by surrounding text or components.\n * - They provide valuable context and must be announced by assistive technologies.\n * - For informative icons, an `aria-label` is required, and the `role` will be set to \"img\" automatically.\n * - If an `aria-label` is provided, the role will be set to 'img'; if it is absent,\n * the role will be unset.\n *\n * ### Informative Standalone Icons\n * - If an icon is informative (as mentioned above) and does not belong to a button (=standalone), it must\n * have a Tooltip that describes what it means.\n * - For informative standalone icons, an `aria-label` & `tabindex=\"0\"` is required,\n * and the `role` will be set to \"img\" automatically.\n * - **Only use this when a Icon is standalone and is not part of a button or other interactive elements.**\n *\n * @tagname mdc-icon\n *\n * @cssproperty --mdc-icon-fill-color - Allows customization of the default fill color.\n * @cssproperty --mdc-icon-size - Allows customization of the icon size.\n * @cssproperty --mdc-icon-border-radius - Allows customization of the icon border radius.\n *\n * @csspart icon - The svg inside the icon element.\n */",
12415
+ "customElement": true
12416
+ }
12417
+ ],
12418
+ "exports": [
12419
+ {
12420
+ "kind": "js",
12421
+ "name": "default",
12422
+ "declaration": {
12423
+ "name": "Icon",
12424
+ "module": "components/icon/icon.component.js"
12425
+ }
12426
+ }
12427
+ ]
12428
+ },
12429
+ {
12430
+ "kind": "javascript-module",
12431
+ "path": "components/iconprovider/iconprovider.component.js",
12432
+ "declarations": [
12433
+ {
12434
+ "kind": "class",
12435
+ "description": "IconProvider component, which allows to be consumed from sub components\n(see `providerUtils.consume` for how to consume)\n\nAttribute `iconSet` can be set to either `momentum-icons` or `custom-icons`.\nIf `momentum-icons` is selected, the icons will be fetched from the\nMomentum Design System icon set per a dynamic JS Import (no need to provide a URL).\nThis requires the consumer to have the `@momentum-designs` package installed and the\nbuild tooling needs to support dynamic imports.\n\nIf `custom-icons` is selected, the icons will be fetched from the provided URL.\nThis requires the consumer to provide a URL from which the icons will be fetched and\nthe consumer needs to make sure to bundle the icons in the application.\n\nIf `cacheStrategy` is provided (only works with iconSet = `custom-icons`), the\nIconProvider will cache the icons in the selected cache (either web-api-cache or in-memory-cache),\nto avoid fetching the same icon multiple times over the network.\nThis is useful when the same icon is used multiple times in the application.\nTo consider:\n- The `in-memory-cache` is not persisted and will be lost when the\nIconProvider is removed from the DOM.\n- The `web-api-cache` is persisted, but only works in https environments\n(https://developer.mozilla.org/en-US/docs/Web/API/Cache).",
12436
+ "name": "IconProvider",
12437
+ "slots": [
12438
+ {
12439
+ "description": "children",
12440
+ "name": ""
12441
+ }
12442
+ ],
12443
+ "members": [
12444
+ {
12445
+ "kind": "field",
12446
+ "name": "Context",
12447
+ "privacy": "public",
12448
+ "static": true,
12449
+ "description": "Context object of the IconProvider, to be consumed by child components",
12450
+ "readonly": true
12451
+ },
12452
+ {
12453
+ "kind": "field",
12454
+ "name": "iconSet",
12455
+ "type": {
12456
+ "text": "IconSet | undefined"
12457
+ },
12458
+ "description": "Icon set to be used\n\nIf `momentum-icons` is selected, the icons will be fetched from the\nMomentum Design System icon set per a dynamic JS Import (no need to provide a URL).\nThis requires the consumer to have the `@momentum-designs` package installed and the\nbuild tooling needs to support dynamic imports.\n\nIf `custom-icons` is selected, the icons will be fetched from the provided URL.\nThis requires the consumer to provide a URL from which the icons will be fetched and\nthe consumer needs to make sure to bundle the icons in the application.",
12459
+ "default": "momentum-icons",
12460
+ "attribute": "icon-set",
12461
+ "reflects": true
12462
+ },
12463
+ {
12464
+ "kind": "field",
12465
+ "name": "url",
12466
+ "type": {
12467
+ "text": "string | undefined"
12468
+ },
12469
+ "description": "Url of where icons will be fetched from\n(if Icon set is `custom-icons`, this will be the base url)",
12470
+ "attribute": "url"
12471
+ },
12472
+ {
12473
+ "kind": "field",
12474
+ "name": "fileExtension",
12475
+ "type": {
12476
+ "text": "string | undefined"
12477
+ },
12478
+ "description": "File extension of icons\n(if Icon set is `custom-icons`, this will be the file extension for icons)",
12479
+ "default": "svg",
12480
+ "attribute": "file-extension",
12481
+ "reflects": true
12482
+ },
12483
+ {
12484
+ "kind": "field",
12485
+ "name": "lengthUnit",
12486
+ "type": {
12487
+ "text": "string"
12488
+ },
12489
+ "description": "Length unit used for sizing of icons",
12490
+ "default": "em",
12491
+ "attribute": "length-unit",
12492
+ "reflects": true
12493
+ },
12494
+ {
12495
+ "kind": "field",
12496
+ "name": "size",
12497
+ "type": {
12498
+ "text": "number | undefined"
12499
+ },
12500
+ "description": "The default size of the icon.\nIf not set, it falls back to the size defined by the length unit.",
12501
+ "default": "1",
12502
+ "attribute": "size",
12503
+ "reflects": true
12504
+ },
12505
+ {
12506
+ "kind": "field",
12507
+ "name": "cacheStrategy",
12508
+ "type": {
12509
+ "text": "CacheStrategy | undefined"
12510
+ },
12511
+ "description": "Icons Cache Strategy to use\n\n**Can only be used if Icon set is `custom-icons`**\n\nChoose `in-memory-cache` to cache icons in a JS cache (in-memory cache).\nChoose `web-cache-api` to cache icons using the Web Cache API.\n\nNOTE: `cache-name` must be provided if `cache-strategy` is provided.\n\nIf not provided or invalid value provided, the icons will not be cached.",
12512
+ "default": "undefined",
12513
+ "attribute": "cache-strategy"
12514
+ },
12515
+ {
12516
+ "kind": "field",
12517
+ "name": "cacheName",
12518
+ "type": {
12519
+ "text": "string | undefined"
12520
+ },
12521
+ "description": "Icons Cache Name to use (cache strategy must be provided)\n\nIf provided, Icons inside the provider will be cached in the\ncache (determined by `cache-strategy`) with the provided name.\n\nNOTE: `cache-name` requires `cache-strategy` to be set.\n\nIf not provided, the icons will not be cached.",
12522
+ "default": "undefined",
12523
+ "attribute": "cache-name"
12524
+ },
12525
+ {
12526
+ "kind": "method",
12527
+ "name": "updateValuesInContext",
12528
+ "privacy": "private"
12529
+ },
12530
+ {
12531
+ "kind": "method",
12532
+ "name": "updateContext",
12533
+ "privacy": "protected",
12534
+ "return": {
12535
+ "type": {
12536
+ "text": "void"
12537
+ }
12538
+ }
12539
+ }
12540
+ ],
12541
+ "attributes": [
12542
+ {
12543
+ "name": "icon-set",
12544
+ "type": {
12545
+ "text": "IconSet | undefined"
12546
+ },
12547
+ "description": "Icon set to be used\n\nIf `momentum-icons` is selected, the icons will be fetched from the\nMomentum Design System icon set per a dynamic JS Import (no need to provide a URL).\nThis requires the consumer to have the `@momentum-designs` package installed and the\nbuild tooling needs to support dynamic imports.\n\nIf `custom-icons` is selected, the icons will be fetched from the provided URL.\nThis requires the consumer to provide a URL from which the icons will be fetched and\nthe consumer needs to make sure to bundle the icons in the application.",
12548
+ "default": "momentum-icons",
12549
+ "fieldName": "iconSet"
12550
+ },
12551
+ {
12552
+ "name": "url",
12553
+ "type": {
12554
+ "text": "string | undefined"
12555
+ },
12556
+ "description": "Url of where icons will be fetched from\n(if Icon set is `custom-icons`, this will be the base url)",
12557
+ "fieldName": "url"
12558
+ },
12559
+ {
12560
+ "name": "file-extension",
12561
+ "type": {
12562
+ "text": "string | undefined"
12563
+ },
12564
+ "description": "File extension of icons\n(if Icon set is `custom-icons`, this will be the file extension for icons)",
12565
+ "default": "svg",
12566
+ "fieldName": "fileExtension"
12567
+ },
12568
+ {
12569
+ "name": "length-unit",
12570
+ "type": {
12571
+ "text": "string"
12572
+ },
12573
+ "description": "Length unit used for sizing of icons",
12574
+ "default": "em",
12575
+ "fieldName": "lengthUnit"
12576
+ },
12577
+ {
12578
+ "name": "size",
12579
+ "type": {
12580
+ "text": "number | undefined"
12581
+ },
12582
+ "description": "The default size of the icon.\nIf not set, it falls back to the size defined by the length unit.",
12583
+ "default": "1",
12584
+ "fieldName": "size"
12585
+ },
12586
+ {
12587
+ "name": "cache-strategy",
12588
12588
  "type": {
12589
- "text": "string | null"
12589
+ "text": "CacheStrategy | undefined"
12590
12590
  },
12591
- "default": "null",
12592
- "description": "Aria-label attribute to be set for accessibility",
12593
- "fieldName": "ariaLabel"
12591
+ "description": "Icons Cache Strategy to use\n\n**Can only be used if Icon set is `custom-icons`**\n\nChoose `in-memory-cache` to cache icons in a JS cache (in-memory cache).\nChoose `web-cache-api` to cache icons using the Web Cache API.\n\nNOTE: `cache-name` must be provided if `cache-strategy` is provided.\n\nIf not provided or invalid value provided, the icons will not be cached.",
12592
+ "default": "undefined",
12593
+ "fieldName": "cacheStrategy"
12594
12594
  },
12595
12595
  {
12596
- "name": "aria-labelledby",
12596
+ "name": "cache-name",
12597
12597
  "type": {
12598
- "text": "string | null"
12598
+ "text": "string | undefined"
12599
12599
  },
12600
- "default": "null",
12601
- "description": "Aria-labelledby attribute to be set for accessibility",
12602
- "fieldName": "ariaLabelledBy"
12600
+ "description": "Icons Cache Name to use (cache strategy must be provided)\n\nIf provided, Icons inside the provider will be cached in the\ncache (determined by `cache-strategy`) with the provided name.\n\nNOTE: `cache-name` requires `cache-strategy` to be set.\n\nIf not provided, the icons will not be cached.",
12601
+ "default": "undefined",
12602
+ "fieldName": "cacheName"
12603
12603
  }
12604
12604
  ],
12605
12605
  "superclass": {
12606
- "name": "Component",
12606
+ "name": "Provider",
12607
12607
  "module": "/src/models"
12608
12608
  },
12609
- "tagName": "mdc-icon",
12610
- "jsDoc": "/**\n * Icon component that dynamically displays SVG icons based on a valid name.\n *\n * This component must be mounted within an `IconProvider` component.\n *\n * The `IconProvider` defines the source URL from which icons are consumed.\n * The `Icon` component accepts a `name` attribute, which corresponds to\n * the file name of the icon to be loaded from the specified URL.\n *\n * Once fetched, the icon will be rendered. If the fetching process is unsuccessful,\n * no icon will be displayed.\n *\n * The `size` attribute allows for dynamic sizing of the icon based on the provided\n * `length-unit` attribute. This unit can either come from the `IconProvider`\n * or can be overridden for each individual icon. For example:\n * if `size = 1` and `length-unit = 'em'`, the dimensions of the icon will be\n * `width: 1em; height: 1em`.\n *\n * Regarding accessibility, there are three types of icons: decorative, informative and informative standalone.\n *\n * ### Decorative Icons\n * - Decorative icons do not convey any essential information to the content of a page.\n * - They should be hidden from screen readers (SR) to prevent confusion for users.\n * - For decorative icons, an `aria-label` is not required, and the `role` will be set to null.\n *\n * ### Informative Icons\n * - Informative icons convey important information that is not adequately represented\n * by surrounding text or components.\n * - They provide valuable context and must be announced by assistive technologies.\n * - For informative icons, an `aria-label` is required, and the `role` will be set to \"img\" automatically.\n * - If an `aria-label` is provided, the role will be set to 'img'; if it is absent,\n * the role will be unset.\n *\n * ### Informative Standalone Icons\n * - If an icon is informative (as mentioned above) and does not belong to a button (=standalone), it must\n * have a Tooltip that describes what it means.\n * - For informative standalone icons, an `aria-label` & `tabindex=\"0\"` is required,\n * and the `role` will be set to \"img\" automatically.\n * - **Only use this when a Icon is standalone and is not part of a button or other interactive elements.**\n *\n * @tagname mdc-icon\n *\n * @cssproperty --mdc-icon-fill-color - Allows customization of the default fill color.\n * @cssproperty --mdc-icon-size - Allows customization of the icon size.\n * @cssproperty --mdc-icon-border-radius - Allows customization of the icon border radius.\n *\n * @csspart icon - The svg inside the icon element.\n */",
12609
+ "tagName": "mdc-iconprovider",
12610
+ "jsDoc": "/**\n * IconProvider component, which allows to be consumed from sub components\n * (see `providerUtils.consume` for how to consume)\n *\n * Attribute `iconSet` can be set to either `momentum-icons` or `custom-icons`.\n * If `momentum-icons` is selected, the icons will be fetched from the\n * Momentum Design System icon set per a dynamic JS Import (no need to provide a URL).\n * This requires the consumer to have the `@momentum-designs` package installed and the\n * build tooling needs to support dynamic imports.\n *\n * If `custom-icons` is selected, the icons will be fetched from the provided URL.\n * This requires the consumer to provide a URL from which the icons will be fetched and\n * the consumer needs to make sure to bundle the icons in the application.\n *\n * If `cacheStrategy` is provided (only works with iconSet = `custom-icons`), the\n * IconProvider will cache the icons in the selected cache (either web-api-cache or in-memory-cache),\n * to avoid fetching the same icon multiple times over the network.\n * This is useful when the same icon is used multiple times in the application.\n * To consider:\n * - The `in-memory-cache` is not persisted and will be lost when the\n * IconProvider is removed from the DOM.\n * - The `web-api-cache` is persisted, but only works in https environments\n * (https://developer.mozilla.org/en-US/docs/Web/API/Cache).\n *\n * @tagname mdc-iconprovider\n *\n * @slot - children\n */",
12611
12611
  "customElement": true
12612
12612
  }
12613
12613
  ],
@@ -12616,8 +12616,8 @@
12616
12616
  "kind": "js",
12617
12617
  "name": "default",
12618
12618
  "declaration": {
12619
- "name": "Icon",
12620
- "module": "components/icon/icon.component.js"
12619
+ "name": "IconProvider",
12620
+ "module": "components/iconprovider/iconprovider.component.js"
12621
12621
  }
12622
12622
  }
12623
12623
  ]
@@ -15223,6 +15223,26 @@
15223
15223
  "description": "(React: onFocus) This event is dispatched when the listitem receives focus.",
15224
15224
  "name": "focus",
15225
15225
  "reactName": "onFocus"
15226
+ },
15227
+ {
15228
+ "description": "(React: onEnabled) This event is dispatched after the listitem is enabled",
15229
+ "name": "enabled",
15230
+ "reactName": "onEnabled"
15231
+ },
15232
+ {
15233
+ "description": "(React: onDisabled) This event is dispatched after the listitem is disabled",
15234
+ "name": "disabled",
15235
+ "reactName": "onDisabled"
15236
+ },
15237
+ {
15238
+ "description": "(React: onCreated) This event is dispatched after the listitem is created (added to the DOM)",
15239
+ "name": "created",
15240
+ "reactName": "onCreated"
15241
+ },
15242
+ {
15243
+ "description": "(React: onDestroyed) This event is dispatched after the listitem is destroyed (removed from the DOM)",
15244
+ "name": "destroyed",
15245
+ "reactName": "onDestroyed"
15226
15246
  }
15227
15247
  ],
15228
15248
  "attributes": [
@@ -15343,7 +15363,7 @@
15343
15363
  "module": "/src/models"
15344
15364
  },
15345
15365
  "tagName": "mdc-listitem",
15346
- "jsDoc": "/**\n * mdc-listitem component is used to display a label with different types of controls.\n * There can be three types of controls, a radio button, a checkbox on the\n * leading side and a toggle on the trailing side.\n * The list item can contain an avatar on the leading side and a badge on the trailing side.\n * Additionally, the list item can contain a side header and a subline text.\n *\n * The leading and trailing slots can be used to display controls and text. <br/>\n * Based on the leading/trailing slot, the position of the controls and text can be adjusted. <br/>\n * Please use mdc-list as a parent element even when there is only listitem for a11y purpose.\n *\n * By providing the tooltip-text attribute, a tooltip will be displayed on hover of the listitem.\n * The placement of the tooltip can be adjusted using the tooltip-placement attribute.\n * This will be helpful when the listitem text is truncated or\n * when you want to display additional information about the listitem.\n *\n * @tagname mdc-listitem\n *\n * @dependency mdc-text\n * @dependency mdc-tooltip\n *\n * @slot leading-controls - slot for list item controls to appear of leading end.\n * @slot leading-text-primary-label - slot for list item primary label.\n * @slot leading-text-secondary-label - slot for list item secondary label.\n * @slot leading-text-tertiary-label - slot for list item tertiary label.\n * @slot trailing-text-side-header - slot for list item side header text.\n * @slot trailing-text-subline - slot for list item subline text.\n * @slot trailing-controls - slot for list item controls to appear of trailing end.\n *\n * @cssproperty --mdc-listitem-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-listitem-background-color-hover - Allows customization of the background color on hover.\n * @cssproperty --mdc-listitem-background-color-active - Allows customization of the background color when pressed.\n * @cssproperty --mdc-listitem-primary-label-color\n * - Allows customization of the primary label, side header and subline text slot color.\n * @cssproperty --mdc-listitem-secondary-label-color\n * - Allows customization of the secondary and tertiary label text slot color.\n * @cssproperty --mdc-listitem-disabled-color - Allows customization of the disabled color.\n * @cssproperty --mdc-listitem-column-gap - Allows customization of column gap.\n * @cssproperty --mdc-listitem-padding-left-and-right - Allows customization of padding left and right.\n *\n * @event click - (React: onClick) This event is dispatched when the listitem is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the listitem.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the listitem.\n * @event focus - (React: onFocus) This event is dispatched when the listitem receives focus.\n */",
15366
+ "jsDoc": "/**\n * mdc-listitem component is used to display a label with different types of controls.\n * There can be three types of controls, a radio button, a checkbox on the\n * leading side and a toggle on the trailing side.\n * The list item can contain an avatar on the leading side and a badge on the trailing side.\n * Additionally, the list item can contain a side header and a subline text.\n *\n * The leading and trailing slots can be used to display controls and text. <br/>\n * Based on the leading/trailing slot, the position of the controls and text can be adjusted. <br/>\n * Please use mdc-list as a parent element even when there is only listitem for a11y purpose.\n *\n * By providing the tooltip-text attribute, a tooltip will be displayed on hover of the listitem.\n * The placement of the tooltip can be adjusted using the tooltip-placement attribute.\n * This will be helpful when the listitem text is truncated or\n * when you want to display additional information about the listitem.\n *\n * @tagname mdc-listitem\n *\n * @dependency mdc-text\n * @dependency mdc-tooltip\n *\n * @slot leading-controls - slot for list item controls to appear of leading end.\n * @slot leading-text-primary-label - slot for list item primary label.\n * @slot leading-text-secondary-label - slot for list item secondary label.\n * @slot leading-text-tertiary-label - slot for list item tertiary label.\n * @slot trailing-text-side-header - slot for list item side header text.\n * @slot trailing-text-subline - slot for list item subline text.\n * @slot trailing-controls - slot for list item controls to appear of trailing end.\n *\n * @cssproperty --mdc-listitem-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-listitem-background-color-hover - Allows customization of the background color on hover.\n * @cssproperty --mdc-listitem-background-color-active - Allows customization of the background color when pressed.\n * @cssproperty --mdc-listitem-primary-label-color\n * - Allows customization of the primary label, side header and subline text slot color.\n * @cssproperty --mdc-listitem-secondary-label-color\n * - Allows customization of the secondary and tertiary label text slot color.\n * @cssproperty --mdc-listitem-disabled-color - Allows customization of the disabled color.\n * @cssproperty --mdc-listitem-column-gap - Allows customization of column gap.\n * @cssproperty --mdc-listitem-padding-left-and-right - Allows customization of padding left and right.\n *\n * @event click - (React: onClick) This event is dispatched when the listitem is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the listitem.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the listitem.\n * @event focus - (React: onFocus) This event is dispatched when the listitem receives focus.\n * @event enabled - (React: onEnabled) This event is dispatched after the listitem is enabled\n * @event disabled - (React: onDisabled) This event is dispatched after the listitem is disabled\n * @event created - (React: onCreated) This event is dispatched after the listitem is created (added to the DOM)\n * @event destroyed - (React: onDestroyed) This event is dispatched after the listitem is destroyed (removed from the DOM)\n */",
15347
15367
  "customElement": true
15348
15368
  }
15349
15369
  ],
@@ -16286,6 +16306,42 @@
16286
16306
  "name": "ListItem",
16287
16307
  "module": "src/components/listitem/listitem.component.ts"
16288
16308
  }
16309
+ },
16310
+ {
16311
+ "description": "(React: onEnabled) This event is dispatched after the listitem is enabled",
16312
+ "name": "enabled",
16313
+ "reactName": "onEnabled",
16314
+ "inheritedFrom": {
16315
+ "name": "ListItem",
16316
+ "module": "src/components/listitem/listitem.component.ts"
16317
+ }
16318
+ },
16319
+ {
16320
+ "description": "(React: onDisabled) This event is dispatched after the listitem is disabled",
16321
+ "name": "disabled",
16322
+ "reactName": "onDisabled",
16323
+ "inheritedFrom": {
16324
+ "name": "ListItem",
16325
+ "module": "src/components/listitem/listitem.component.ts"
16326
+ }
16327
+ },
16328
+ {
16329
+ "description": "(React: onCreated) This event is dispatched after the listitem is created (added to the DOM)",
16330
+ "name": "created",
16331
+ "reactName": "onCreated",
16332
+ "inheritedFrom": {
16333
+ "name": "ListItem",
16334
+ "module": "src/components/listitem/listitem.component.ts"
16335
+ }
16336
+ },
16337
+ {
16338
+ "description": "(React: onDestroyed) This event is dispatched after the listitem is destroyed (removed from the DOM)",
16339
+ "name": "destroyed",
16340
+ "reactName": "onDestroyed",
16341
+ "inheritedFrom": {
16342
+ "name": "ListItem",
16343
+ "module": "src/components/listitem/listitem.component.ts"
16344
+ }
16289
16345
  }
16290
16346
  ],
16291
16347
  "attributes": [
@@ -17155,6 +17211,42 @@
17155
17211
  "name": "ListItem",
17156
17212
  "module": "src/components/listitem/listitem.component.ts"
17157
17213
  }
17214
+ },
17215
+ {
17216
+ "description": "(React: onEnabled) This event is dispatched after the listitem is enabled",
17217
+ "name": "enabled",
17218
+ "reactName": "onEnabled",
17219
+ "inheritedFrom": {
17220
+ "name": "ListItem",
17221
+ "module": "src/components/listitem/listitem.component.ts"
17222
+ }
17223
+ },
17224
+ {
17225
+ "description": "(React: onDisabled) This event is dispatched after the listitem is disabled",
17226
+ "name": "disabled",
17227
+ "reactName": "onDisabled",
17228
+ "inheritedFrom": {
17229
+ "name": "ListItem",
17230
+ "module": "src/components/listitem/listitem.component.ts"
17231
+ }
17232
+ },
17233
+ {
17234
+ "description": "(React: onCreated) This event is dispatched after the listitem is created (added to the DOM)",
17235
+ "name": "created",
17236
+ "reactName": "onCreated",
17237
+ "inheritedFrom": {
17238
+ "name": "ListItem",
17239
+ "module": "src/components/listitem/listitem.component.ts"
17240
+ }
17241
+ },
17242
+ {
17243
+ "description": "(React: onDestroyed) This event is dispatched after the listitem is destroyed (removed from the DOM)",
17244
+ "name": "destroyed",
17245
+ "reactName": "onDestroyed",
17246
+ "inheritedFrom": {
17247
+ "name": "ListItem",
17248
+ "module": "src/components/listitem/listitem.component.ts"
17249
+ }
17158
17250
  }
17159
17251
  ],
17160
17252
  "attributes": [
@@ -18069,6 +18161,42 @@
18069
18161
  "name": "ListItem",
18070
18162
  "module": "src/components/listitem/listitem.component.ts"
18071
18163
  }
18164
+ },
18165
+ {
18166
+ "description": "(React: onEnabled) This event is dispatched after the listitem is enabled",
18167
+ "name": "enabled",
18168
+ "reactName": "onEnabled",
18169
+ "inheritedFrom": {
18170
+ "name": "ListItem",
18171
+ "module": "src/components/listitem/listitem.component.ts"
18172
+ }
18173
+ },
18174
+ {
18175
+ "description": "(React: onDisabled) This event is dispatched after the listitem is disabled",
18176
+ "name": "disabled",
18177
+ "reactName": "onDisabled",
18178
+ "inheritedFrom": {
18179
+ "name": "ListItem",
18180
+ "module": "src/components/listitem/listitem.component.ts"
18181
+ }
18182
+ },
18183
+ {
18184
+ "description": "(React: onCreated) This event is dispatched after the listitem is created (added to the DOM)",
18185
+ "name": "created",
18186
+ "reactName": "onCreated",
18187
+ "inheritedFrom": {
18188
+ "name": "ListItem",
18189
+ "module": "src/components/listitem/listitem.component.ts"
18190
+ }
18191
+ },
18192
+ {
18193
+ "description": "(React: onDestroyed) This event is dispatched after the listitem is destroyed (removed from the DOM)",
18194
+ "name": "destroyed",
18195
+ "reactName": "onDestroyed",
18196
+ "inheritedFrom": {
18197
+ "name": "ListItem",
18198
+ "module": "src/components/listitem/listitem.component.ts"
18199
+ }
18072
18200
  }
18073
18201
  ],
18074
18202
  "attributes": [
@@ -18303,54 +18431,195 @@
18303
18431
  }
18304
18432
  },
18305
18433
  {
18306
- "description": "Allows customization of the background color when pressed.",
18307
- "name": "--mdc-listitem-background-color-active",
18308
- "inheritedFrom": {
18309
- "name": "ListItem",
18310
- "module": "src/components/listitem/listitem.component.ts"
18311
- }
18312
- },
18434
+ "description": "Allows customization of the background color when pressed.",
18435
+ "name": "--mdc-listitem-background-color-active",
18436
+ "inheritedFrom": {
18437
+ "name": "ListItem",
18438
+ "module": "src/components/listitem/listitem.component.ts"
18439
+ }
18440
+ },
18441
+ {
18442
+ "description": "Allows customization of the primary label, side header and subline text slot color.",
18443
+ "name": "--mdc-listitem-primary-label-color",
18444
+ "inheritedFrom": {
18445
+ "name": "ListItem",
18446
+ "module": "src/components/listitem/listitem.component.ts"
18447
+ }
18448
+ },
18449
+ {
18450
+ "description": "Allows customization of the secondary and tertiary label text slot color.",
18451
+ "name": "--mdc-listitem-secondary-label-color",
18452
+ "inheritedFrom": {
18453
+ "name": "ListItem",
18454
+ "module": "src/components/listitem/listitem.component.ts"
18455
+ }
18456
+ },
18457
+ {
18458
+ "description": "Allows customization of the disabled color.",
18459
+ "name": "--mdc-listitem-disabled-color",
18460
+ "inheritedFrom": {
18461
+ "name": "ListItem",
18462
+ "module": "src/components/listitem/listitem.component.ts"
18463
+ }
18464
+ },
18465
+ {
18466
+ "description": "Allows customization of column gap.",
18467
+ "name": "--mdc-listitem-column-gap",
18468
+ "inheritedFrom": {
18469
+ "name": "ListItem",
18470
+ "module": "src/components/listitem/listitem.component.ts"
18471
+ }
18472
+ },
18473
+ {
18474
+ "description": "Allows customization of padding left and right.",
18475
+ "name": "--mdc-listitem-padding-left-and-right",
18476
+ "inheritedFrom": {
18477
+ "name": "ListItem",
18478
+ "module": "src/components/listitem/listitem.component.ts"
18479
+ }
18480
+ }
18481
+ ]
18482
+ }
18483
+ ],
18484
+ "exports": [
18485
+ {
18486
+ "kind": "js",
18487
+ "name": "default",
18488
+ "declaration": {
18489
+ "name": "MenuItemRadio",
18490
+ "module": "components/menuitemradio/menuitemradio.component.js"
18491
+ }
18492
+ }
18493
+ ]
18494
+ },
18495
+ {
18496
+ "kind": "javascript-module",
18497
+ "path": "components/menusection/menusection.component.js",
18498
+ "declarations": [
18499
+ {
18500
+ "kind": "class",
18501
+ "description": "`mdc-menusection` is a container element used to group a set of menu items.\n\nThis component supports a mix of `menuitem`, `menuitemcheckbox`, and `menuitemradio` components.\n\n- If multiple `menuitemradio` components are slotted into the section, the group enforces a single-selection rule:\n only one radio item can be selected at a time.\n- If `menuitemcheckbox` components are included, their checked state can be toggled independently.",
18502
+ "name": "MenuSection",
18503
+ "slots": [
18504
+ {
18505
+ "description": "Default slot for inserting `menuitem`, `menuitemcheckbox`, or `menuitemradio`",
18506
+ "name": ""
18507
+ }
18508
+ ],
18509
+ "members": [
18510
+ {
18511
+ "kind": "field",
18512
+ "name": "ariaLabel",
18513
+ "type": {
18514
+ "text": "string | null"
18515
+ },
18516
+ "default": "null",
18517
+ "description": "The aria-label for the section.\nThis is used for accessibility purposes to describe the section.\nIf not provided, it defaults to the `headerText`.",
18518
+ "attribute": "aria-label",
18519
+ "reflects": true
18520
+ },
18521
+ {
18522
+ "kind": "field",
18523
+ "name": "headerText",
18524
+ "type": {
18525
+ "text": "string | null"
18526
+ },
18527
+ "default": "null",
18528
+ "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
18529
+ "attribute": "header-text",
18530
+ "reflects": true
18531
+ },
18532
+ {
18533
+ "kind": "field",
18534
+ "name": "prefixIcon",
18535
+ "type": {
18536
+ "text": "IconNames | undefined"
18537
+ },
18538
+ "description": "Name of the icon rendered before the text\n\nIf not provided, no icon will be rendered and text will be aligned to the start.",
18539
+ "attribute": "prefix-icon"
18540
+ },
18541
+ {
18542
+ "kind": "field",
18543
+ "name": "showDivider",
18544
+ "type": {
18545
+ "text": "boolean"
18546
+ },
18547
+ "default": "false",
18548
+ "description": "Whether to show a divider below the section header.\nThis is useful for visually separating sections in the menu.",
18549
+ "attribute": "show-divider",
18550
+ "reflects": true
18551
+ },
18552
+ {
18553
+ "kind": "field",
18554
+ "name": "dividerVariant",
18555
+ "description": "The variant of the divider.\nCan be set to 'solid' or 'gradient'.\n\nKeep 'solid' if used in MenuPopovers, as it is the default style.",
18556
+ "default": "'solid'",
18557
+ "attribute": "divider-variant",
18558
+ "reflects": true
18559
+ },
18560
+ {
18561
+ "kind": "method",
18562
+ "name": "renderHeader",
18563
+ "privacy": "private"
18564
+ }
18565
+ ],
18566
+ "events": [
18313
18567
  {
18314
- "description": "Allows customization of the primary label, side header and subline text slot color.",
18315
- "name": "--mdc-listitem-primary-label-color",
18316
- "inheritedFrom": {
18317
- "name": "ListItem",
18318
- "module": "src/components/listitem/listitem.component.ts"
18319
- }
18568
+ "description": "(React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.",
18569
+ "name": "change",
18570
+ "reactName": "onChange"
18571
+ }
18572
+ ],
18573
+ "attributes": [
18574
+ {
18575
+ "name": "aria-label",
18576
+ "type": {
18577
+ "text": "string | null"
18578
+ },
18579
+ "default": "null",
18580
+ "description": "The aria-label for the section.\nThis is used for accessibility purposes to describe the section.\nIf not provided, it defaults to the `headerText`.",
18581
+ "fieldName": "ariaLabel"
18320
18582
  },
18321
18583
  {
18322
- "description": "Allows customization of the secondary and tertiary label text slot color.",
18323
- "name": "--mdc-listitem-secondary-label-color",
18324
- "inheritedFrom": {
18325
- "name": "ListItem",
18326
- "module": "src/components/listitem/listitem.component.ts"
18327
- }
18584
+ "name": "header-text",
18585
+ "type": {
18586
+ "text": "string | null"
18587
+ },
18588
+ "default": "null",
18589
+ "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
18590
+ "fieldName": "headerText"
18328
18591
  },
18329
18592
  {
18330
- "description": "Allows customization of the disabled color.",
18331
- "name": "--mdc-listitem-disabled-color",
18332
- "inheritedFrom": {
18333
- "name": "ListItem",
18334
- "module": "src/components/listitem/listitem.component.ts"
18335
- }
18593
+ "name": "prefix-icon",
18594
+ "type": {
18595
+ "text": "IconNames | undefined"
18596
+ },
18597
+ "description": "Name of the icon rendered before the text\n\nIf not provided, no icon will be rendered and text will be aligned to the start.",
18598
+ "fieldName": "prefixIcon"
18336
18599
  },
18337
18600
  {
18338
- "description": "Allows customization of column gap.",
18339
- "name": "--mdc-listitem-column-gap",
18340
- "inheritedFrom": {
18341
- "name": "ListItem",
18342
- "module": "src/components/listitem/listitem.component.ts"
18343
- }
18601
+ "name": "show-divider",
18602
+ "type": {
18603
+ "text": "boolean"
18604
+ },
18605
+ "default": "false",
18606
+ "description": "Whether to show a divider below the section header.\nThis is useful for visually separating sections in the menu.",
18607
+ "fieldName": "showDivider"
18344
18608
  },
18345
18609
  {
18346
- "description": "Allows customization of padding left and right.",
18347
- "name": "--mdc-listitem-padding-left-and-right",
18348
- "inheritedFrom": {
18349
- "name": "ListItem",
18350
- "module": "src/components/listitem/listitem.component.ts"
18351
- }
18610
+ "name": "divider-variant",
18611
+ "description": "The variant of the divider.\nCan be set to 'solid' or 'gradient'.\n\nKeep 'solid' if used in MenuPopovers, as it is the default style.",
18612
+ "default": "'solid'",
18613
+ "fieldName": "dividerVariant"
18352
18614
  }
18353
- ]
18615
+ ],
18616
+ "superclass": {
18617
+ "name": "Component",
18618
+ "module": "/src/models"
18619
+ },
18620
+ "tagName": "mdc-menusection",
18621
+ "jsDoc": "/**\n * `mdc-menusection` is a container element used to group a set of menu items.\n *\n * This component supports a mix of `menuitem`, `menuitemcheckbox`, and `menuitemradio` components.\n *\n * - If multiple `menuitemradio` components are slotted into the section, the group enforces a single-selection rule:\n * only one radio item can be selected at a time.\n * - If `menuitemcheckbox` components are included, their checked state can be toggled independently.\n *\n * @tagname mdc-menusection\n *\n * @slot - Default slot for inserting `menuitem`, `menuitemcheckbox`, or `menuitemradio`\n *\n * @event change - (React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.\n */",
18622
+ "customElement": true
18354
18623
  }
18355
18624
  ],
18356
18625
  "exports": [
@@ -18358,8 +18627,8 @@
18358
18627
  "kind": "js",
18359
18628
  "name": "default",
18360
18629
  "declaration": {
18361
- "name": "MenuItemRadio",
18362
- "module": "components/menuitemradio/menuitemradio.component.js"
18630
+ "name": "MenuSection",
18631
+ "module": "components/menusection/menusection.component.js"
18363
18632
  }
18364
18633
  }
18365
18634
  ]
@@ -18604,6 +18873,29 @@
18604
18873
  ],
18605
18874
  "description": "Handles mouse click events on the menu items.\nThis method checks if the clicked element is a valid menu item and not a submenu trigger.\nIf it is, it closes all other menu popovers to ensure only one menu is open at a time."
18606
18875
  },
18876
+ {
18877
+ "kind": "method",
18878
+ "name": "handleItemCreation",
18879
+ "privacy": "private",
18880
+ "parameters": [
18881
+ {
18882
+ "name": "event",
18883
+ "type": {
18884
+ "text": "Event"
18885
+ }
18886
+ }
18887
+ ]
18888
+ },
18889
+ {
18890
+ "kind": "field",
18891
+ "name": "handleItemChangeEvent",
18892
+ "privacy": "private"
18893
+ },
18894
+ {
18895
+ "kind": "field",
18896
+ "name": "resetMenuNavigation",
18897
+ "privacy": "private"
18898
+ },
18607
18899
  {
18608
18900
  "kind": "method",
18609
18901
  "name": "resolveDirectionKey",
@@ -20340,219 +20632,78 @@
20340
20632
  }
20341
20633
  },
20342
20634
  {
20343
- "description": "border of the arrow",
20344
- "name": "--mdc-popover-arrow-border",
20345
- "inheritedFrom": {
20346
- "name": "Popover",
20347
- "module": "src/components/popover/popover.component.ts"
20348
- }
20349
- },
20350
- {
20351
- "description": "primary background color of the popover",
20352
- "name": "--mdc-popover-primary-background-color",
20353
- "inheritedFrom": {
20354
- "name": "Popover",
20355
- "module": "src/components/popover/popover.component.ts"
20356
- }
20357
- },
20358
- {
20359
- "description": "border color of the popover",
20360
- "name": "--mdc-popover-border-color",
20361
- "inheritedFrom": {
20362
- "name": "Popover",
20363
- "module": "src/components/popover/popover.component.ts"
20364
- }
20365
- },
20366
- {
20367
- "description": "inverted background color of the popover",
20368
- "name": "--mdc-popover-inverted-background-color",
20369
- "inheritedFrom": {
20370
- "name": "Popover",
20371
- "module": "src/components/popover/popover.component.ts"
20372
- }
20373
- },
20374
- {
20375
- "description": "inverted border color of the popover",
20376
- "name": "--mdc-popover-inverted-border-color",
20377
- "inheritedFrom": {
20378
- "name": "Popover",
20379
- "module": "src/components/popover/popover.component.ts"
20380
- }
20381
- },
20382
- {
20383
- "description": "inverted text color of the popover",
20384
- "name": "--mdc-popover-inverted-text-color",
20385
- "inheritedFrom": {
20386
- "name": "Popover",
20387
- "module": "src/components/popover/popover.component.ts"
20388
- }
20389
- },
20390
- {
20391
- "description": "elevation of the popover",
20392
- "name": "--mdc-popover-elevation-3",
20393
- "inheritedFrom": {
20394
- "name": "Popover",
20395
- "module": "src/components/popover/popover.component.ts"
20396
- }
20397
- },
20398
- {
20399
- "description": "max width of the popover",
20400
- "name": "--mdc-popover-max-width",
20401
- "inheritedFrom": {
20402
- "name": "Popover",
20403
- "module": "src/components/popover/popover.component.ts"
20404
- }
20405
- },
20406
- {
20407
- "description": "max height of the popover",
20408
- "name": "--mdc-popover-max-height",
20409
- "inheritedFrom": {
20410
- "name": "Popover",
20411
- "module": "src/components/popover/popover.component.ts"
20412
- }
20413
- }
20414
- ]
20415
- }
20416
- ],
20417
- "exports": [
20418
- {
20419
- "kind": "js",
20420
- "name": "default",
20421
- "declaration": {
20422
- "name": "MenuPopover",
20423
- "module": "components/menupopover/menupopover.component.js"
20424
- }
20425
- }
20426
- ]
20427
- },
20428
- {
20429
- "kind": "javascript-module",
20430
- "path": "components/menusection/menusection.component.js",
20431
- "declarations": [
20432
- {
20433
- "kind": "class",
20434
- "description": "`mdc-menusection` is a container element used to group a set of menu items.\n\nThis component supports a mix of `menuitem`, `menuitemcheckbox`, and `menuitemradio` components.\n\n- If multiple `menuitemradio` components are slotted into the section, the group enforces a single-selection rule:\n only one radio item can be selected at a time.\n- If `menuitemcheckbox` components are included, their checked state can be toggled independently.",
20435
- "name": "MenuSection",
20436
- "slots": [
20437
- {
20438
- "description": "Default slot for inserting `menuitem`, `menuitemcheckbox`, or `menuitemradio`",
20439
- "name": ""
20440
- }
20441
- ],
20442
- "members": [
20443
- {
20444
- "kind": "field",
20445
- "name": "ariaLabel",
20446
- "type": {
20447
- "text": "string | null"
20448
- },
20449
- "default": "null",
20450
- "description": "The aria-label for the section.\nThis is used for accessibility purposes to describe the section.\nIf not provided, it defaults to the `headerText`.",
20451
- "attribute": "aria-label",
20452
- "reflects": true
20453
- },
20454
- {
20455
- "kind": "field",
20456
- "name": "headerText",
20457
- "type": {
20458
- "text": "string | null"
20459
- },
20460
- "default": "null",
20461
- "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
20462
- "attribute": "header-text",
20463
- "reflects": true
20464
- },
20465
- {
20466
- "kind": "field",
20467
- "name": "prefixIcon",
20468
- "type": {
20469
- "text": "IconNames | undefined"
20470
- },
20471
- "description": "Name of the icon rendered before the text\n\nIf not provided, no icon will be rendered and text will be aligned to the start.",
20472
- "attribute": "prefix-icon"
20473
- },
20474
- {
20475
- "kind": "field",
20476
- "name": "showDivider",
20477
- "type": {
20478
- "text": "boolean"
20479
- },
20480
- "default": "false",
20481
- "description": "Whether to show a divider below the section header.\nThis is useful for visually separating sections in the menu.",
20482
- "attribute": "show-divider",
20483
- "reflects": true
20635
+ "description": "border of the arrow",
20636
+ "name": "--mdc-popover-arrow-border",
20637
+ "inheritedFrom": {
20638
+ "name": "Popover",
20639
+ "module": "src/components/popover/popover.component.ts"
20640
+ }
20484
20641
  },
20485
20642
  {
20486
- "kind": "field",
20487
- "name": "dividerVariant",
20488
- "description": "The variant of the divider.\nCan be set to 'solid' or 'gradient'.\n\nKeep 'solid' if used in MenuPopovers, as it is the default style.",
20489
- "default": "'solid'",
20490
- "attribute": "divider-variant",
20491
- "reflects": true
20643
+ "description": "primary background color of the popover",
20644
+ "name": "--mdc-popover-primary-background-color",
20645
+ "inheritedFrom": {
20646
+ "name": "Popover",
20647
+ "module": "src/components/popover/popover.component.ts"
20648
+ }
20492
20649
  },
20493
20650
  {
20494
- "kind": "method",
20495
- "name": "renderHeader",
20496
- "privacy": "private"
20497
- }
20498
- ],
20499
- "events": [
20651
+ "description": "border color of the popover",
20652
+ "name": "--mdc-popover-border-color",
20653
+ "inheritedFrom": {
20654
+ "name": "Popover",
20655
+ "module": "src/components/popover/popover.component.ts"
20656
+ }
20657
+ },
20500
20658
  {
20501
- "description": "(React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.",
20502
- "name": "change",
20503
- "reactName": "onChange"
20504
- }
20505
- ],
20506
- "attributes": [
20659
+ "description": "inverted background color of the popover",
20660
+ "name": "--mdc-popover-inverted-background-color",
20661
+ "inheritedFrom": {
20662
+ "name": "Popover",
20663
+ "module": "src/components/popover/popover.component.ts"
20664
+ }
20665
+ },
20507
20666
  {
20508
- "name": "aria-label",
20509
- "type": {
20510
- "text": "string | null"
20511
- },
20512
- "default": "null",
20513
- "description": "The aria-label for the section.\nThis is used for accessibility purposes to describe the section.\nIf not provided, it defaults to the `headerText`.",
20514
- "fieldName": "ariaLabel"
20667
+ "description": "inverted border color of the popover",
20668
+ "name": "--mdc-popover-inverted-border-color",
20669
+ "inheritedFrom": {
20670
+ "name": "Popover",
20671
+ "module": "src/components/popover/popover.component.ts"
20672
+ }
20515
20673
  },
20516
20674
  {
20517
- "name": "header-text",
20518
- "type": {
20519
- "text": "string | null"
20520
- },
20521
- "default": "null",
20522
- "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
20523
- "fieldName": "headerText"
20675
+ "description": "inverted text color of the popover",
20676
+ "name": "--mdc-popover-inverted-text-color",
20677
+ "inheritedFrom": {
20678
+ "name": "Popover",
20679
+ "module": "src/components/popover/popover.component.ts"
20680
+ }
20524
20681
  },
20525
20682
  {
20526
- "name": "prefix-icon",
20527
- "type": {
20528
- "text": "IconNames | undefined"
20529
- },
20530
- "description": "Name of the icon rendered before the text\n\nIf not provided, no icon will be rendered and text will be aligned to the start.",
20531
- "fieldName": "prefixIcon"
20683
+ "description": "elevation of the popover",
20684
+ "name": "--mdc-popover-elevation-3",
20685
+ "inheritedFrom": {
20686
+ "name": "Popover",
20687
+ "module": "src/components/popover/popover.component.ts"
20688
+ }
20532
20689
  },
20533
20690
  {
20534
- "name": "show-divider",
20535
- "type": {
20536
- "text": "boolean"
20537
- },
20538
- "default": "false",
20539
- "description": "Whether to show a divider below the section header.\nThis is useful for visually separating sections in the menu.",
20540
- "fieldName": "showDivider"
20691
+ "description": "max width of the popover",
20692
+ "name": "--mdc-popover-max-width",
20693
+ "inheritedFrom": {
20694
+ "name": "Popover",
20695
+ "module": "src/components/popover/popover.component.ts"
20696
+ }
20541
20697
  },
20542
20698
  {
20543
- "name": "divider-variant",
20544
- "description": "The variant of the divider.\nCan be set to 'solid' or 'gradient'.\n\nKeep 'solid' if used in MenuPopovers, as it is the default style.",
20545
- "default": "'solid'",
20546
- "fieldName": "dividerVariant"
20699
+ "description": "max height of the popover",
20700
+ "name": "--mdc-popover-max-height",
20701
+ "inheritedFrom": {
20702
+ "name": "Popover",
20703
+ "module": "src/components/popover/popover.component.ts"
20704
+ }
20547
20705
  }
20548
- ],
20549
- "superclass": {
20550
- "name": "Component",
20551
- "module": "/src/models"
20552
- },
20553
- "tagName": "mdc-menusection",
20554
- "jsDoc": "/**\n * `mdc-menusection` is a container element used to group a set of menu items.\n *\n * This component supports a mix of `menuitem`, `menuitemcheckbox`, and `menuitemradio` components.\n *\n * - If multiple `menuitemradio` components are slotted into the section, the group enforces a single-selection rule:\n * only one radio item can be selected at a time.\n * - If `menuitemcheckbox` components are included, their checked state can be toggled independently.\n *\n * @tagname mdc-menusection\n *\n * @slot - Default slot for inserting `menuitem`, `menuitemcheckbox`, or `menuitemradio`\n *\n * @event change - (React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.\n */",
20555
- "customElement": true
20706
+ ]
20556
20707
  }
20557
20708
  ],
20558
20709
  "exports": [
@@ -20560,8 +20711,8 @@
20560
20711
  "kind": "js",
20561
20712
  "name": "default",
20562
20713
  "declaration": {
20563
- "name": "MenuSection",
20564
- "module": "components/menusection/menusection.component.js"
20714
+ "name": "MenuPopover",
20715
+ "module": "components/menupopover/menupopover.component.js"
20565
20716
  }
20566
20717
  }
20567
20718
  ]
@@ -21311,6 +21462,42 @@
21311
21462
  "description": "(React: onActiveChange) Dispatched when the active state of the navmenuitem changes.",
21312
21463
  "name": "activechange",
21313
21464
  "reactName": "onActiveChange"
21465
+ },
21466
+ {
21467
+ "description": "(React: onEnabled) This event is dispatched after the listitem is enabled",
21468
+ "name": "enabled",
21469
+ "reactName": "onEnabled",
21470
+ "inheritedFrom": {
21471
+ "name": "ListItem",
21472
+ "module": "src/components/listitem/listitem.component.ts"
21473
+ }
21474
+ },
21475
+ {
21476
+ "description": "(React: onDisabled) This event is dispatched after the listitem is disabled",
21477
+ "name": "disabled",
21478
+ "reactName": "onDisabled",
21479
+ "inheritedFrom": {
21480
+ "name": "ListItem",
21481
+ "module": "src/components/listitem/listitem.component.ts"
21482
+ }
21483
+ },
21484
+ {
21485
+ "description": "(React: onCreated) This event is dispatched after the listitem is created (added to the DOM)",
21486
+ "name": "created",
21487
+ "reactName": "onCreated",
21488
+ "inheritedFrom": {
21489
+ "name": "ListItem",
21490
+ "module": "src/components/listitem/listitem.component.ts"
21491
+ }
21492
+ },
21493
+ {
21494
+ "description": "(React: onDestroyed) This event is dispatched after the listitem is destroyed (removed from the DOM)",
21495
+ "name": "destroyed",
21496
+ "reactName": "onDestroyed",
21497
+ "inheritedFrom": {
21498
+ "name": "ListItem",
21499
+ "module": "src/components/listitem/listitem.component.ts"
21500
+ }
21314
21501
  }
21315
21502
  ],
21316
21503
  "attributes": [
@@ -22398,6 +22585,42 @@
22398
22585
  "name": "ListItem",
22399
22586
  "module": "src/components/listitem/listitem.component.ts"
22400
22587
  }
22588
+ },
22589
+ {
22590
+ "description": "(React: onEnabled) This event is dispatched after the listitem is enabled",
22591
+ "name": "enabled",
22592
+ "reactName": "onEnabled",
22593
+ "inheritedFrom": {
22594
+ "name": "ListItem",
22595
+ "module": "src/components/listitem/listitem.component.ts"
22596
+ }
22597
+ },
22598
+ {
22599
+ "description": "(React: onDisabled) This event is dispatched after the listitem is disabled",
22600
+ "name": "disabled",
22601
+ "reactName": "onDisabled",
22602
+ "inheritedFrom": {
22603
+ "name": "ListItem",
22604
+ "module": "src/components/listitem/listitem.component.ts"
22605
+ }
22606
+ },
22607
+ {
22608
+ "description": "(React: onCreated) This event is dispatched after the listitem is created (added to the DOM)",
22609
+ "name": "created",
22610
+ "reactName": "onCreated",
22611
+ "inheritedFrom": {
22612
+ "name": "ListItem",
22613
+ "module": "src/components/listitem/listitem.component.ts"
22614
+ }
22615
+ },
22616
+ {
22617
+ "description": "(React: onDestroyed) This event is dispatched after the listitem is destroyed (removed from the DOM)",
22618
+ "name": "destroyed",
22619
+ "reactName": "onDestroyed",
22620
+ "inheritedFrom": {
22621
+ "name": "ListItem",
22622
+ "module": "src/components/listitem/listitem.component.ts"
22623
+ }
22401
22624
  }
22402
22625
  ],
22403
22626
  "attributes": [
@@ -29326,6 +29549,46 @@
29326
29549
  }
29327
29550
  ]
29328
29551
  },
29552
+ {
29553
+ "kind": "javascript-module",
29554
+ "path": "components/selectlistbox/selectlistbox.component.js",
29555
+ "declarations": [
29556
+ {
29557
+ "kind": "class",
29558
+ "description": "Selectlistbox component as Light DOM component to act as a simple wrapper\nfor mdc-option components to ensure accessibility and proper role assignment.\n\nOnce [ariaOwnsElements](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/ariaOwnsElements) is supported in browsers, this component can be removed\nand mdc-option can be used directly in the select component with a listbox in a different\nshadow root and aria-owns attribute to connect them.",
29559
+ "name": "Selectlistbox",
29560
+ "slots": [
29561
+ {
29562
+ "description": "This is a default/unnamed slot, which can be used to insert mdc-option components.",
29563
+ "name": "default"
29564
+ }
29565
+ ],
29566
+ "members": [
29567
+ {
29568
+ "kind": "field",
29569
+ "name": "role"
29570
+ }
29571
+ ],
29572
+ "superclass": {
29573
+ "name": "Component",
29574
+ "module": "/src/models"
29575
+ },
29576
+ "tagName": "mdc-selectlistbox",
29577
+ "jsDoc": "/**\n * Selectlistbox component as Light DOM component to act as a simple wrapper\n * for mdc-option components to ensure accessibility and proper role assignment.\n *\n * Once [ariaOwnsElements](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/ariaOwnsElements) is supported in browsers, this component can be removed\n * and mdc-option can be used directly in the select component with a listbox in a different\n * shadow root and aria-owns attribute to connect them.\n *\n * @tagname mdc-selectlistbox\n *\n * @slot default - This is a default/unnamed slot, which can be used to insert mdc-option components.\n */",
29578
+ "customElement": true
29579
+ }
29580
+ ],
29581
+ "exports": [
29582
+ {
29583
+ "kind": "js",
29584
+ "name": "default",
29585
+ "declaration": {
29586
+ "name": "Selectlistbox",
29587
+ "module": "components/selectlistbox/selectlistbox.component.js"
29588
+ }
29589
+ }
29590
+ ]
29591
+ },
29329
29592
  {
29330
29593
  "kind": "javascript-module",
29331
29594
  "path": "components/select/select.component.js",
@@ -30250,46 +30513,6 @@
30250
30513
  }
30251
30514
  ]
30252
30515
  },
30253
- {
30254
- "kind": "javascript-module",
30255
- "path": "components/selectlistbox/selectlistbox.component.js",
30256
- "declarations": [
30257
- {
30258
- "kind": "class",
30259
- "description": "Selectlistbox component as Light DOM component to act as a simple wrapper\nfor mdc-option components to ensure accessibility and proper role assignment.\n\nOnce [ariaOwnsElements](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/ariaOwnsElements) is supported in browsers, this component can be removed\nand mdc-option can be used directly in the select component with a listbox in a different\nshadow root and aria-owns attribute to connect them.",
30260
- "name": "Selectlistbox",
30261
- "slots": [
30262
- {
30263
- "description": "This is a default/unnamed slot, which can be used to insert mdc-option components.",
30264
- "name": "default"
30265
- }
30266
- ],
30267
- "members": [
30268
- {
30269
- "kind": "field",
30270
- "name": "role"
30271
- }
30272
- ],
30273
- "superclass": {
30274
- "name": "Component",
30275
- "module": "/src/models"
30276
- },
30277
- "tagName": "mdc-selectlistbox",
30278
- "jsDoc": "/**\n * Selectlistbox component as Light DOM component to act as a simple wrapper\n * for mdc-option components to ensure accessibility and proper role assignment.\n *\n * Once [ariaOwnsElements](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/ariaOwnsElements) is supported in browsers, this component can be removed\n * and mdc-option can be used directly in the select component with a listbox in a different\n * shadow root and aria-owns attribute to connect them.\n *\n * @tagname mdc-selectlistbox\n *\n * @slot default - This is a default/unnamed slot, which can be used to insert mdc-option components.\n */",
30279
- "customElement": true
30280
- }
30281
- ],
30282
- "exports": [
30283
- {
30284
- "kind": "js",
30285
- "name": "default",
30286
- "declaration": {
30287
- "name": "Selectlistbox",
30288
- "module": "components/selectlistbox/selectlistbox.component.js"
30289
- }
30290
- }
30291
- ]
30292
- },
30293
30516
  {
30294
30517
  "kind": "javascript-module",
30295
30518
  "path": "components/sidenavigation/sidenavigation.component.js",