@nordhealth/components 3.4.0-alpha.1 → 3.4.0-alpha.2

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.
@@ -628,119 +628,6 @@
628
628
  }
629
629
  ]
630
630
  },
631
- {
632
- "kind": "javascript-module",
633
- "path": "src/badge/Badge.ts",
634
- "declarations": [
635
- {
636
- "kind": "class",
637
- "description": "Badges are used to inform users of the status of an object\nor of an action that’s been taken. Commonly used in tabular\ndata to indicate status.",
638
- "name": "Badge",
639
- "slots": [
640
- {
641
- "description": "The badge content.",
642
- "name": ""
643
- },
644
- {
645
- "description": "Used to place an icon at the start of badge.",
646
- "name": "icon"
647
- }
648
- ],
649
- "members": [
650
- {
651
- "kind": "field",
652
- "name": "type",
653
- "type": {
654
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
655
- },
656
- "description": "The type of badge.\nDetermines the background color of the badge.",
657
- "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
658
- "attribute": "type",
659
- "reflects": true
660
- },
661
- {
662
- "kind": "field",
663
- "name": "variant",
664
- "type": {
665
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
666
- },
667
- "description": "The style variant of the badge.\nDetermines the background color of the badge.",
668
- "attribute": "variant",
669
- "reflects": true
670
- },
671
- {
672
- "kind": "field",
673
- "name": "strong",
674
- "type": {
675
- "text": "boolean"
676
- },
677
- "default": "false",
678
- "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
679
- "attribute": "strong",
680
- "reflects": true
681
- }
682
- ],
683
- "attributes": [
684
- {
685
- "name": "type",
686
- "type": {
687
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
688
- },
689
- "description": "The type of badge.\nDetermines the background color of the badge.",
690
- "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
691
- "fieldName": "type"
692
- },
693
- {
694
- "name": "variant",
695
- "type": {
696
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
697
- },
698
- "description": "The style variant of the badge.\nDetermines the background color of the badge.",
699
- "fieldName": "variant"
700
- },
701
- {
702
- "name": "strong",
703
- "type": {
704
- "text": "boolean"
705
- },
706
- "default": "false",
707
- "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
708
- "fieldName": "strong"
709
- }
710
- ],
711
- "superclass": {
712
- "name": "LitElement",
713
- "package": "lit"
714
- },
715
- "localization": [],
716
- "status": "ready",
717
- "category": "text",
718
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use established variants and color patterns so that users can clearly identify the importance level.\n- Use to show a status update on a piece of information or action.\n- Use to mark something as a “draft” or “new”.\n- Use when you want to highlight something that has been added recently.\n- Always position badge so that it’s clear to understand what object it’s related to.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t make badges clickable. Instead use button component’s small variant.\n- Don’t use alternatives to existing badge variants.\n\n</div>\n\n---\n\n## Content guidelines\n\nBadge labels should use a single word to describe the status of an object. Only use two words if you need to describe a complex state:\n\n<div class=\"n-usage n-usage-do\">Complete</div>\n<div class=\"n-usage n-usage-dont\">Action completed</div>\n\nWhen writing badge labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Partially refunded</div>\n<div class=\"n-usage n-usage-dont\">Partially Refunded</div>\n\nAvoid unnecessary words and articles in badge labels, such as “is”, “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Pending</div>\n<div class=\"n-usage n-usage-dont\">Item is pending</div>\n\nAlways describe the status in the past tense:\n\n<div class=\"n-usage n-usage-do\">Refunded</div>\n<div class=\"n-usage n-usage-dont\">Refund</div>\n\n---\n\n## Variants\n\nThis section describes the different component variants, their purpose, and when to use each variant.\n\n| Name | Purpose |\n| ----------- | --------------------------------------------------------------------------------------------------------------------------------------- |\n| `neutral` | The default style variant. |\n| `info` | Used to convey general information that isn’t critical. |\n| `success` | Used to convey success states. For example, you might want to show a badge that tells the user a payment was successful. |\n| `highlight` | Used to highlight specific items in the interface, like notifications. |\n| `danger` | Used to communicate problems that have to be resolved so that user can continue forward. Should always be used for highlighting errors. |\n| `warning` | Used to display information that needs a user’s attention attention and may require further steps. |\n| `progress` | Used to convey something that’s in progress. |\n",
719
- "examples": [],
720
- "dependencies": [],
721
- "tagName": "nord-badge",
722
- "customElement": true
723
- }
724
- ],
725
- "exports": [
726
- {
727
- "kind": "js",
728
- "name": "default",
729
- "declaration": {
730
- "name": "Badge",
731
- "module": "src/badge/Badge.ts"
732
- }
733
- },
734
- {
735
- "kind": "custom-element-definition",
736
- "name": "nord-badge",
737
- "declaration": {
738
- "name": "Badge",
739
- "module": "src/badge/Badge.ts"
740
- }
741
- }
742
- ]
743
- },
744
631
  {
745
632
  "kind": "javascript-module",
746
633
  "path": "src/banner/Banner.ts",
@@ -1518,6 +1405,119 @@
1518
1405
  }
1519
1406
  ]
1520
1407
  },
1408
+ {
1409
+ "kind": "javascript-module",
1410
+ "path": "src/badge/Badge.ts",
1411
+ "declarations": [
1412
+ {
1413
+ "kind": "class",
1414
+ "description": "Badges are used to inform users of the status of an object\nor of an action that’s been taken. Commonly used in tabular\ndata to indicate status.",
1415
+ "name": "Badge",
1416
+ "slots": [
1417
+ {
1418
+ "description": "The badge content.",
1419
+ "name": ""
1420
+ },
1421
+ {
1422
+ "description": "Used to place an icon at the start of badge.",
1423
+ "name": "icon"
1424
+ }
1425
+ ],
1426
+ "members": [
1427
+ {
1428
+ "kind": "field",
1429
+ "name": "type",
1430
+ "type": {
1431
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
1432
+ },
1433
+ "description": "The type of badge.\nDetermines the background color of the badge.",
1434
+ "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
1435
+ "attribute": "type",
1436
+ "reflects": true
1437
+ },
1438
+ {
1439
+ "kind": "field",
1440
+ "name": "variant",
1441
+ "type": {
1442
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
1443
+ },
1444
+ "description": "The style variant of the badge.\nDetermines the background color of the badge.",
1445
+ "attribute": "variant",
1446
+ "reflects": true
1447
+ },
1448
+ {
1449
+ "kind": "field",
1450
+ "name": "strong",
1451
+ "type": {
1452
+ "text": "boolean"
1453
+ },
1454
+ "default": "false",
1455
+ "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
1456
+ "attribute": "strong",
1457
+ "reflects": true
1458
+ }
1459
+ ],
1460
+ "attributes": [
1461
+ {
1462
+ "name": "type",
1463
+ "type": {
1464
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
1465
+ },
1466
+ "description": "The type of badge.\nDetermines the background color of the badge.",
1467
+ "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
1468
+ "fieldName": "type"
1469
+ },
1470
+ {
1471
+ "name": "variant",
1472
+ "type": {
1473
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
1474
+ },
1475
+ "description": "The style variant of the badge.\nDetermines the background color of the badge.",
1476
+ "fieldName": "variant"
1477
+ },
1478
+ {
1479
+ "name": "strong",
1480
+ "type": {
1481
+ "text": "boolean"
1482
+ },
1483
+ "default": "false",
1484
+ "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
1485
+ "fieldName": "strong"
1486
+ }
1487
+ ],
1488
+ "superclass": {
1489
+ "name": "LitElement",
1490
+ "package": "lit"
1491
+ },
1492
+ "localization": [],
1493
+ "status": "ready",
1494
+ "category": "text",
1495
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use established variants and color patterns so that users can clearly identify the importance level.\n- Use to show a status update on a piece of information or action.\n- Use to mark something as a “draft” or “new”.\n- Use when you want to highlight something that has been added recently.\n- Always position badge so that it’s clear to understand what object it’s related to.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t make badges clickable. Instead use button component’s small variant.\n- Don’t use alternatives to existing badge variants.\n\n</div>\n\n---\n\n## Content guidelines\n\nBadge labels should use a single word to describe the status of an object. Only use two words if you need to describe a complex state:\n\n<div class=\"n-usage n-usage-do\">Complete</div>\n<div class=\"n-usage n-usage-dont\">Action completed</div>\n\nWhen writing badge labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Partially refunded</div>\n<div class=\"n-usage n-usage-dont\">Partially Refunded</div>\n\nAvoid unnecessary words and articles in badge labels, such as “is”, “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Pending</div>\n<div class=\"n-usage n-usage-dont\">Item is pending</div>\n\nAlways describe the status in the past tense:\n\n<div class=\"n-usage n-usage-do\">Refunded</div>\n<div class=\"n-usage n-usage-dont\">Refund</div>\n\n---\n\n## Variants\n\nThis section describes the different component variants, their purpose, and when to use each variant.\n\n| Name | Purpose |\n| ----------- | --------------------------------------------------------------------------------------------------------------------------------------- |\n| `neutral` | The default style variant. |\n| `info` | Used to convey general information that isn’t critical. |\n| `success` | Used to convey success states. For example, you might want to show a badge that tells the user a payment was successful. |\n| `highlight` | Used to highlight specific items in the interface, like notifications. |\n| `danger` | Used to communicate problems that have to be resolved so that user can continue forward. Should always be used for highlighting errors. |\n| `warning` | Used to display information that needs a user’s attention attention and may require further steps. |\n| `progress` | Used to convey something that’s in progress. |\n",
1496
+ "examples": [],
1497
+ "dependencies": [],
1498
+ "tagName": "nord-badge",
1499
+ "customElement": true
1500
+ }
1501
+ ],
1502
+ "exports": [
1503
+ {
1504
+ "kind": "js",
1505
+ "name": "default",
1506
+ "declaration": {
1507
+ "name": "Badge",
1508
+ "module": "src/badge/Badge.ts"
1509
+ }
1510
+ },
1511
+ {
1512
+ "kind": "custom-element-definition",
1513
+ "name": "nord-badge",
1514
+ "declaration": {
1515
+ "name": "Badge",
1516
+ "module": "src/badge/Badge.ts"
1517
+ }
1518
+ }
1519
+ ]
1520
+ },
1521
1521
  {
1522
1522
  "kind": "javascript-module",
1523
1523
  "path": "src/calendar/Calendar.ts",
@@ -6332,40 +6332,108 @@
6332
6332
  },
6333
6333
  {
6334
6334
  "kind": "javascript-module",
6335
- "path": "src/dropdown-item/DropdownItem.ts",
6335
+ "path": "src/dropdown-group/DropdownGroup.ts",
6336
6336
  "declarations": [
6337
6337
  {
6338
6338
  "kind": "class",
6339
- "description": "Dropdown item populates dropdown with actions. Items can be\nplaced either inside a dropdown group or directly inside a\ndropdown component.",
6340
- "name": "DropdownItem",
6339
+ "description": "Dropdown group includes all the actions or items in a single dropdown\ngroup and is used for grouping items into related categories.",
6340
+ "name": "DropdownGroup",
6341
6341
  "slots": [
6342
6342
  {
6343
- "description": "The dropdown item content.",
6343
+ "description": "The dropdown group content.",
6344
6344
  "name": ""
6345
- },
6346
- {
6347
- "description": "Used to place content before dropdown item text. Typically used for icons.",
6348
- "name": "start"
6349
- },
6350
- {
6351
- "description": "Used to place content after dropdown item text. Typically used for icons.",
6352
- "name": "end"
6353
6345
  }
6354
6346
  ],
6355
6347
  "members": [
6356
6348
  {
6357
6349
  "kind": "field",
6358
- "name": "href",
6350
+ "name": "heading",
6359
6351
  "type": {
6360
6352
  "text": "string | undefined"
6361
6353
  },
6362
- "description": "The url the dropdown item should link to.",
6363
- "attribute": "href",
6364
- "reflects": true
6365
- },
6354
+ "description": "Heading and accessible label for the dropdown group.",
6355
+ "attribute": "heading"
6356
+ }
6357
+ ],
6358
+ "attributes": [
6366
6359
  {
6367
- "kind": "field",
6368
- "name": "target",
6360
+ "name": "heading",
6361
+ "type": {
6362
+ "text": "string | undefined"
6363
+ },
6364
+ "description": "Heading and accessible label for the dropdown group.",
6365
+ "fieldName": "heading"
6366
+ }
6367
+ ],
6368
+ "superclass": {
6369
+ "name": "LitElement",
6370
+ "package": "lit"
6371
+ },
6372
+ "localization": [],
6373
+ "status": "ready",
6374
+ "category": "action",
6375
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Group dropdown items into dropdown groups based on related categories.\n- Use group headings to clarify the category of a section.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for grouping other types of content.\n\n</div>\n\n---\n\n## Content guidelines\n\nDropdown items should be always written in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Create user</div>\n<div class=\"n-usage n-usage-dont\">Create User</div>\n\nDropdown items should always lead with a strong verb that encourages action. Use the `{verb}+{noun}` format except in the case of common actions like Save, Close or Cancel:\n\n<div class=\"n-usage n-usage-do\">Edit row</div>\n<div class=\"n-usage n-usage-dont\">Editing options</div>\n\nAvoid unnecessary words and articles in dropdown items, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme</div>\n\nAvoid ending dropdown items in punctuation:\n\n<div class=\"n-usage n-usage-do\">Switch user</div>\n<div class=\"n-usage n-usage-dont\">Switch user.</div>\n\nAvoid all caps for dropdown items:\n\n<div class=\"n-usage n-usage-do\">Rename</div>\n<div class=\"n-usage n-usage-dont\">RENAME</div>\n\nKeep dropdown items to a single line of text:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme<br/>of the veterinary application.</div>\n",
6376
+ "examples": [],
6377
+ "dependencies": [],
6378
+ "tagName": "nord-dropdown-group",
6379
+ "customElement": true
6380
+ }
6381
+ ],
6382
+ "exports": [
6383
+ {
6384
+ "kind": "js",
6385
+ "name": "default",
6386
+ "declaration": {
6387
+ "name": "DropdownGroup",
6388
+ "module": "src/dropdown-group/DropdownGroup.ts"
6389
+ }
6390
+ },
6391
+ {
6392
+ "kind": "custom-element-definition",
6393
+ "name": "nord-dropdown-group",
6394
+ "declaration": {
6395
+ "name": "DropdownGroup",
6396
+ "module": "src/dropdown-group/DropdownGroup.ts"
6397
+ }
6398
+ }
6399
+ ]
6400
+ },
6401
+ {
6402
+ "kind": "javascript-module",
6403
+ "path": "src/dropdown-item/DropdownItem.ts",
6404
+ "declarations": [
6405
+ {
6406
+ "kind": "class",
6407
+ "description": "Dropdown item populates dropdown with actions. Items can be\nplaced either inside a dropdown group or directly inside a\ndropdown component.",
6408
+ "name": "DropdownItem",
6409
+ "slots": [
6410
+ {
6411
+ "description": "The dropdown item content.",
6412
+ "name": ""
6413
+ },
6414
+ {
6415
+ "description": "Used to place content before dropdown item text. Typically used for icons.",
6416
+ "name": "start"
6417
+ },
6418
+ {
6419
+ "description": "Used to place content after dropdown item text. Typically used for icons.",
6420
+ "name": "end"
6421
+ }
6422
+ ],
6423
+ "members": [
6424
+ {
6425
+ "kind": "field",
6426
+ "name": "href",
6427
+ "type": {
6428
+ "text": "string | undefined"
6429
+ },
6430
+ "description": "The url the dropdown item should link to.",
6431
+ "attribute": "href",
6432
+ "reflects": true
6433
+ },
6434
+ {
6435
+ "kind": "field",
6436
+ "name": "target",
6369
6437
  "type": {
6370
6438
  "text": "\"_self\" | \"_blank\" | \"_parent\" | \"_top\""
6371
6439
  },
@@ -6478,74 +6546,6 @@
6478
6546
  }
6479
6547
  ]
6480
6548
  },
6481
- {
6482
- "kind": "javascript-module",
6483
- "path": "src/dropdown-group/DropdownGroup.ts",
6484
- "declarations": [
6485
- {
6486
- "kind": "class",
6487
- "description": "Dropdown group includes all the actions or items in a single dropdown\ngroup and is used for grouping items into related categories.",
6488
- "name": "DropdownGroup",
6489
- "slots": [
6490
- {
6491
- "description": "The dropdown group content.",
6492
- "name": ""
6493
- }
6494
- ],
6495
- "members": [
6496
- {
6497
- "kind": "field",
6498
- "name": "heading",
6499
- "type": {
6500
- "text": "string | undefined"
6501
- },
6502
- "description": "Heading and accessible label for the dropdown group.",
6503
- "attribute": "heading"
6504
- }
6505
- ],
6506
- "attributes": [
6507
- {
6508
- "name": "heading",
6509
- "type": {
6510
- "text": "string | undefined"
6511
- },
6512
- "description": "Heading and accessible label for the dropdown group.",
6513
- "fieldName": "heading"
6514
- }
6515
- ],
6516
- "superclass": {
6517
- "name": "LitElement",
6518
- "package": "lit"
6519
- },
6520
- "localization": [],
6521
- "status": "ready",
6522
- "category": "action",
6523
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Group dropdown items into dropdown groups based on related categories.\n- Use group headings to clarify the category of a section.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for grouping other types of content.\n\n</div>\n\n---\n\n## Content guidelines\n\nDropdown items should be always written in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Create user</div>\n<div class=\"n-usage n-usage-dont\">Create User</div>\n\nDropdown items should always lead with a strong verb that encourages action. Use the `{verb}+{noun}` format except in the case of common actions like Save, Close or Cancel:\n\n<div class=\"n-usage n-usage-do\">Edit row</div>\n<div class=\"n-usage n-usage-dont\">Editing options</div>\n\nAvoid unnecessary words and articles in dropdown items, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme</div>\n\nAvoid ending dropdown items in punctuation:\n\n<div class=\"n-usage n-usage-do\">Switch user</div>\n<div class=\"n-usage n-usage-dont\">Switch user.</div>\n\nAvoid all caps for dropdown items:\n\n<div class=\"n-usage n-usage-do\">Rename</div>\n<div class=\"n-usage n-usage-dont\">RENAME</div>\n\nKeep dropdown items to a single line of text:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme<br/>of the veterinary application.</div>\n",
6524
- "examples": [],
6525
- "dependencies": [],
6526
- "tagName": "nord-dropdown-group",
6527
- "customElement": true
6528
- }
6529
- ],
6530
- "exports": [
6531
- {
6532
- "kind": "js",
6533
- "name": "default",
6534
- "declaration": {
6535
- "name": "DropdownGroup",
6536
- "module": "src/dropdown-group/DropdownGroup.ts"
6537
- }
6538
- },
6539
- {
6540
- "kind": "custom-element-definition",
6541
- "name": "nord-dropdown-group",
6542
- "declaration": {
6543
- "name": "DropdownGroup",
6544
- "module": "src/dropdown-group/DropdownGroup.ts"
6545
- }
6546
- }
6547
- ]
6548
- },
6549
6549
  {
6550
6550
  "kind": "javascript-module",
6551
6551
  "path": "src/empty-state/EmptyState.ts",
@@ -8518,261 +8518,56 @@
8518
8518
  },
8519
8519
  {
8520
8520
  "kind": "javascript-module",
8521
- "path": "src/message/Message.ts",
8521
+ "path": "src/localization/LocalizeController.ts",
8522
8522
  "declarations": [
8523
8523
  {
8524
8524
  "kind": "class",
8525
- "description": "Message represents a specific item within a collection,\nsuch as notifications, tasks or conversations. Message\ncan be placed directly inside a dropdown component.",
8526
- "name": "Message",
8527
- "cssProperties": [
8528
- {
8529
- "description": "Controls the border color of the message, using our [color tokens](/tokens/#color).",
8530
- "name": "--n-message-border-color",
8531
- "default": "var(--n-color-border)"
8532
- }
8533
- ],
8534
- "slots": [
8535
- {
8536
- "description": "The message content.",
8537
- "name": ""
8538
- },
8539
- {
8540
- "description": "Used to place content after the message. Typically used for a timestamp.",
8541
- "name": "footer"
8542
- }
8543
- ],
8525
+ "description": "",
8526
+ "name": "LocalizeController",
8544
8527
  "members": [
8545
8528
  {
8546
8529
  "kind": "field",
8547
- "name": "localize",
8548
- "privacy": "private",
8549
- "default": "new LocalizeController<\"nord-message\">(this)"
8550
- },
8551
- {
8552
- "kind": "field",
8553
- "name": "href",
8530
+ "name": "unsubscribe",
8554
8531
  "type": {
8555
- "text": "string | undefined"
8532
+ "text": "ReturnType<typeof subscribe> | undefined"
8556
8533
  },
8557
- "description": "The url the message should link to.",
8558
- "attribute": "href",
8559
- "reflects": true
8534
+ "privacy": "private"
8560
8535
  },
8561
8536
  {
8562
8537
  "kind": "field",
8563
- "name": "highlight",
8538
+ "name": "resolvedTranslation",
8564
8539
  "type": {
8565
- "text": "boolean | undefined"
8540
+ "text": "Translation"
8566
8541
  },
8567
- "description": "Highlight the message visually. This is meant for highlighting\na new message that just appeared. Highlight style should be removed\nafter the user has seen the message and there’s been a timeout of\ne.g. 30 seconds.",
8568
- "attribute": "highlight",
8569
- "reflects": true
8542
+ "privacy": "private"
8570
8543
  },
8571
8544
  {
8572
8545
  "kind": "field",
8573
- "name": "unread",
8574
- "type": {
8575
- "text": "boolean | undefined"
8576
- },
8577
- "description": "Mark the message as unread. By default messages are read.",
8578
- "attribute": "unread",
8579
- "reflects": true
8546
+ "name": "lang",
8547
+ "description": "The lang of the document or element, with element taking precedence",
8548
+ "readonly": true
8580
8549
  },
8581
8550
  {
8582
8551
  "kind": "field",
8583
- "name": "focusableRef",
8584
- "privacy": "protected",
8585
- "inheritedFrom": {
8586
- "name": "FocusableMixin",
8587
- "module": "src/common/mixins/FocusableMixin.ts"
8588
- }
8552
+ "name": "resolvedLang",
8553
+ "description": "The lang of the translation being applied.\nThis may not match the document/element lang, in case of fallback translation",
8554
+ "readonly": true
8589
8555
  },
8590
8556
  {
8591
8557
  "kind": "method",
8592
- "name": "focus",
8593
- "parameters": [
8594
- {
8595
- "name": "options",
8596
- "optional": true,
8597
- "type": {
8598
- "text": "FocusOptions"
8599
- },
8600
- "description": "An object which controls aspects of the focusing process."
8601
- }
8602
- ],
8603
- "description": "Programmatically move focus to the component.",
8604
- "inheritedFrom": {
8605
- "name": "FocusableMixin",
8606
- "module": "src/common/mixins/FocusableMixin.ts"
8607
- }
8558
+ "name": "hostConnected"
8608
8559
  },
8609
8560
  {
8610
8561
  "kind": "method",
8611
- "name": "blur",
8612
- "description": "Programmatically remove focus from the component.",
8613
- "inheritedFrom": {
8614
- "name": "FocusableMixin",
8615
- "module": "src/common/mixins/FocusableMixin.ts"
8616
- }
8562
+ "name": "hostDisconnected"
8617
8563
  },
8618
8564
  {
8619
8565
  "kind": "method",
8620
- "name": "click",
8621
- "description": "Programmatically simulates a click on the component.",
8622
- "inheritedFrom": {
8623
- "name": "FocusableMixin",
8624
- "module": "src/common/mixins/FocusableMixin.ts"
8625
- }
8626
- }
8627
- ],
8628
- "attributes": [
8629
- {
8630
- "name": "href",
8631
- "type": {
8632
- "text": "string | undefined"
8633
- },
8634
- "description": "The url the message should link to.",
8635
- "fieldName": "href"
8636
- },
8637
- {
8638
- "name": "highlight",
8639
- "type": {
8640
- "text": "boolean | undefined"
8641
- },
8642
- "description": "Highlight the message visually. This is meant for highlighting\na new message that just appeared. Highlight style should be removed\nafter the user has seen the message and there’s been a timeout of\ne.g. 30 seconds.",
8643
- "fieldName": "highlight"
8644
- },
8645
- {
8646
- "name": "unread",
8647
- "type": {
8648
- "text": "boolean | undefined"
8649
- },
8650
- "description": "Mark the message as unread. By default messages are read.",
8651
- "fieldName": "unread"
8652
- }
8653
- ],
8654
- "mixins": [
8655
- {
8656
- "name": "FocusableMixin",
8657
- "module": "/src/common/mixins/FocusableMixin.js"
8658
- }
8659
- ],
8660
- "superclass": {
8661
- "name": "LitElement",
8662
- "package": "lit"
8663
- },
8664
- "localization": [
8665
- {
8666
- "name": "unreadLabel",
8667
- "description": "Label for the unread messages."
8668
- }
8669
- ],
8670
- "status": "draft",
8671
- "category": "action",
8672
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Messages should always perform an action when clicked.\n- The click action should navigate to a new page or provide more detail about the message.\n- Mark unread messages as read on user interaction.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t slot other components inside a message.\n\n</div>\n\n---\n\n## Content guidelines\n\nMessage content should be clear, accurate and easy to understand:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Patient arrived</div>\n\nWhen writing the message content, be concise. Keep content to 1 to 2 sentence:\n\n<div class=\"n-usage n-usage-do\">You’ve reached the limit of 30 users included in your plan. Upgrade to add more.</div>\n<div class=\"n-usage n-usage-dont\">You have reached the user limit. Your clinic can only have a maximum of 30 users. To add more users, remove users you no longer need or upgrade your plan to add more.</div>\n\nWhen writing the notification content, always write it in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen Arrived To Clinic With Pixie Cat.</div>\n\nAlways end in punctuation:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen arrived to clinic with Pixie cat</div>\n\nAvoid all caps for messages:\n\n<div class=\"n-usage n-usage-do\">Nina Williams arrived to clinic with Norfryd</div>\n<div class=\"n-usage n-usage-dont\">NINA WILLIAMS ARRIVED TO CLINIC WITH NORFRYD</div>\n",
8673
- "examples": [],
8674
- "dependencies": [
8675
- "dropdown-item"
8676
- ],
8677
- "tagName": "nord-message",
8678
- "customElement": true
8679
- }
8680
- ],
8681
- "exports": [
8682
- {
8683
- "kind": "js",
8684
- "name": "default",
8685
- "declaration": {
8686
- "name": "Message",
8687
- "module": "src/message/Message.ts"
8688
- }
8689
- },
8690
- {
8691
- "kind": "custom-element-definition",
8692
- "name": "nord-message",
8693
- "declaration": {
8694
- "name": "Message",
8695
- "module": "src/message/Message.ts"
8696
- }
8697
- }
8698
- ]
8699
- },
8700
- {
8701
- "kind": "javascript-module",
8702
- "path": "src/message/localization.ts",
8703
- "declarations": [
8704
- {
8705
- "kind": "variable",
8706
- "name": "localization",
8707
- "type": {
8708
- "text": "object"
8709
- },
8710
- "default": "{\n unreadLabel: \"Unread\",\n}"
8711
- }
8712
- ],
8713
- "exports": [
8714
- {
8715
- "kind": "js",
8716
- "name": "default",
8717
- "declaration": {
8718
- "name": "localization",
8719
- "module": "src/message/localization.ts"
8720
- }
8721
- }
8722
- ]
8723
- },
8724
- {
8725
- "kind": "javascript-module",
8726
- "path": "src/localization/LocalizeController.ts",
8727
- "declarations": [
8728
- {
8729
- "kind": "class",
8730
- "description": "",
8731
- "name": "LocalizeController",
8732
- "members": [
8733
- {
8734
- "kind": "field",
8735
- "name": "unsubscribe",
8736
- "type": {
8737
- "text": "ReturnType<typeof subscribe> | undefined"
8738
- },
8739
- "privacy": "private"
8740
- },
8741
- {
8742
- "kind": "field",
8743
- "name": "resolvedTranslation",
8744
- "type": {
8745
- "text": "Translation"
8746
- },
8747
- "privacy": "private"
8748
- },
8749
- {
8750
- "kind": "field",
8751
- "name": "lang",
8752
- "description": "The lang of the document or element, with element taking precedence",
8753
- "readonly": true
8754
- },
8755
- {
8756
- "kind": "field",
8757
- "name": "resolvedLang",
8758
- "description": "The lang of the translation being applied.\nThis may not match the document/element lang, in case of fallback translation",
8759
- "readonly": true
8760
- },
8761
- {
8762
- "kind": "method",
8763
- "name": "hostConnected"
8764
- },
8765
- {
8766
- "kind": "method",
8767
- "name": "hostDisconnected"
8768
- },
8769
- {
8770
- "kind": "method",
8771
- "name": "term",
8772
- "return": {
8773
- "type": {
8774
- "text": "Result<Translation[TComponentName], Key>"
8775
- }
8566
+ "name": "term",
8567
+ "return": {
8568
+ "type": {
8569
+ "text": "Result<Translation[TComponentName], Key>"
8570
+ }
8776
8571
  },
8777
8572
  "parameters": [
8778
8573
  {
@@ -8978,140 +8773,345 @@
8978
8773
  },
8979
8774
  {
8980
8775
  "kind": "javascript-module",
8981
- "path": "src/modal/Modal.ts",
8776
+ "path": "src/message/Message.ts",
8982
8777
  "declarations": [
8983
8778
  {
8984
8779
  "kind": "class",
8985
- "description": "Modal component is used to display content that temporarily blocks interactions\nwith the main view of an application. Modal should be used sparingly and\nonly when necessary.",
8986
- "name": "Modal",
8780
+ "description": "Message represents a specific item within a collection,\nsuch as notifications, tasks or conversations. Message\ncan be placed directly inside a dropdown component.",
8781
+ "name": "Message",
8987
8782
  "cssProperties": [
8988
8783
  {
8989
- "description": "Controls the padding on the sides of the modal, using our [spacing tokens](/tokens/#space).",
8990
- "name": "--n-modal-padding-inline",
8991
- "default": "var(--n-space-m)"
8992
- },
8993
- {
8994
- "description": "Controls the padding above and below the modal, using our [spacing tokens](/tokens/#space).",
8995
- "name": "--n-modal-padding-block",
8996
- "default": "var(--n-space-m)"
8997
- },
8998
- {
8999
- "description": "Controls the width of the modal.",
9000
- "name": "--n-modal-max-inline-size",
9001
- "default": "620px"
8784
+ "description": "Controls the border color of the message, using our [color tokens](/tokens/#color).",
8785
+ "name": "--n-message-border-color",
8786
+ "default": "var(--n-color-border)"
9002
8787
  }
9003
8788
  ],
9004
8789
  "slots": [
9005
8790
  {
9006
- "description": "Default slot",
8791
+ "description": "The message content.",
9007
8792
  "name": ""
9008
8793
  },
9009
8794
  {
9010
- "description": "Slot which holds the header of the modal, positioned next to the close button.",
9011
- "name": "header"
9012
- },
9013
- {
9014
- "description": "Slot which is typically used to hold call to action buttons, but can also be used to build custom footers.",
8795
+ "description": "Used to place content after the message. Typically used for a timestamp.",
9015
8796
  "name": "footer"
9016
8797
  }
9017
8798
  ],
9018
8799
  "members": [
9019
- {
9020
- "kind": "field",
9021
- "name": "modal",
9022
- "type": {
9023
- "text": "HTMLDivElement"
9024
- },
9025
- "privacy": "private"
9026
- },
9027
- {
9028
- "kind": "field",
9029
- "name": "backdrop",
9030
- "type": {
9031
- "text": "HTMLDivElement"
9032
- },
9033
- "privacy": "private"
9034
- },
9035
- {
9036
- "kind": "field",
9037
- "name": "headerSlot",
9038
- "privacy": "private",
9039
- "default": "new SlotController(this, \"header\")"
9040
- },
9041
- {
9042
- "kind": "field",
9043
- "name": "featureSlot",
9044
- "privacy": "private",
9045
- "default": "new SlotController(this, \"feature\")"
9046
- },
9047
- {
9048
- "kind": "field",
9049
- "name": "footerSlot",
9050
- "privacy": "private",
9051
- "default": "new SlotController(this, \"footer\")"
9052
- },
9053
8800
  {
9054
8801
  "kind": "field",
9055
8802
  "name": "localize",
9056
8803
  "privacy": "private",
9057
- "default": "new LocalizeController<\"nord-modal\">(this)"
9058
- },
9059
- {
9060
- "kind": "field",
9061
- "name": "modalController",
9062
- "privacy": "private",
9063
- "default": "new ModalController(this, {\n isOpen: () => this.open,\n onDismiss: () => this.handleDismiss(),\n dialog: () => this.modal,\n backdrop: () => this.backdrop,\n close: returnValue => this.close(returnValue),\n })"
8804
+ "default": "new LocalizeController<\"nord-message\">(this)"
9064
8805
  },
9065
8806
  {
9066
8807
  "kind": "field",
9067
- "name": "open",
8808
+ "name": "href",
9068
8809
  "type": {
9069
- "text": "boolean"
8810
+ "text": "string | undefined"
9070
8811
  },
9071
- "default": "false",
9072
- "description": "Controls whether the modal is open or not.",
9073
- "attribute": "open",
8812
+ "description": "The url the message should link to.",
8813
+ "attribute": "href",
9074
8814
  "reflects": true
9075
8815
  },
9076
8816
  {
9077
8817
  "kind": "field",
9078
- "name": "size",
8818
+ "name": "highlight",
9079
8819
  "type": {
9080
- "text": "\"s\" | \"m\" | \"l\""
8820
+ "text": "boolean | undefined"
9081
8821
  },
9082
- "default": "\"m\"",
9083
- "description": "Controls the max-width of the modal when open.",
9084
- "attribute": "size",
8822
+ "description": "Highlight the message visually. This is meant for highlighting\na new message that just appeared. Highlight style should be removed\nafter the user has seen the message and there’s been a timeout of\ne.g. 30 seconds.",
8823
+ "attribute": "highlight",
9085
8824
  "reflects": true
9086
8825
  },
9087
8826
  {
9088
8827
  "kind": "field",
9089
- "name": "returnValue",
9090
- "type": {
9091
- "text": "string"
9092
- },
9093
- "default": "\"\"",
9094
- "description": "The reason why the modal was closed. This typically indicates\nwhich button the user pressed to close the modal, though any value\ncan be supplied if the modal is programmatically closed."
9095
- },
9096
- {
9097
- "kind": "field",
9098
- "name": "scrollable",
8828
+ "name": "unread",
9099
8829
  "type": {
9100
- "text": "boolean"
8830
+ "text": "boolean | undefined"
9101
8831
  },
9102
- "default": "false",
9103
- "description": "By default if a modal is too big for the browser window,\nthe entire modal will scroll. This setting changes that behavior\nso that the body of the modal scrolls instead, with the modal\nitself remaining fixed.",
9104
- "attribute": "scrollable",
8832
+ "description": "Mark the message as unread. By default messages are read.",
8833
+ "attribute": "unread",
9105
8834
  "reflects": true
9106
8835
  },
9107
8836
  {
9108
- "kind": "method",
9109
- "name": "showModal",
9110
- "description": "Show the modal, automatically moving focus to the modal or a child\nelement with an `autofocus` attribute."
8837
+ "kind": "field",
8838
+ "name": "focusableRef",
8839
+ "privacy": "protected",
8840
+ "inheritedFrom": {
8841
+ "name": "FocusableMixin",
8842
+ "module": "src/common/mixins/FocusableMixin.ts"
8843
+ }
9111
8844
  },
9112
8845
  {
9113
8846
  "kind": "method",
9114
- "name": "close",
8847
+ "name": "focus",
8848
+ "parameters": [
8849
+ {
8850
+ "name": "options",
8851
+ "optional": true,
8852
+ "type": {
8853
+ "text": "FocusOptions"
8854
+ },
8855
+ "description": "An object which controls aspects of the focusing process."
8856
+ }
8857
+ ],
8858
+ "description": "Programmatically move focus to the component.",
8859
+ "inheritedFrom": {
8860
+ "name": "FocusableMixin",
8861
+ "module": "src/common/mixins/FocusableMixin.ts"
8862
+ }
8863
+ },
8864
+ {
8865
+ "kind": "method",
8866
+ "name": "blur",
8867
+ "description": "Programmatically remove focus from the component.",
8868
+ "inheritedFrom": {
8869
+ "name": "FocusableMixin",
8870
+ "module": "src/common/mixins/FocusableMixin.ts"
8871
+ }
8872
+ },
8873
+ {
8874
+ "kind": "method",
8875
+ "name": "click",
8876
+ "description": "Programmatically simulates a click on the component.",
8877
+ "inheritedFrom": {
8878
+ "name": "FocusableMixin",
8879
+ "module": "src/common/mixins/FocusableMixin.ts"
8880
+ }
8881
+ }
8882
+ ],
8883
+ "attributes": [
8884
+ {
8885
+ "name": "href",
8886
+ "type": {
8887
+ "text": "string | undefined"
8888
+ },
8889
+ "description": "The url the message should link to.",
8890
+ "fieldName": "href"
8891
+ },
8892
+ {
8893
+ "name": "highlight",
8894
+ "type": {
8895
+ "text": "boolean | undefined"
8896
+ },
8897
+ "description": "Highlight the message visually. This is meant for highlighting\na new message that just appeared. Highlight style should be removed\nafter the user has seen the message and there’s been a timeout of\ne.g. 30 seconds.",
8898
+ "fieldName": "highlight"
8899
+ },
8900
+ {
8901
+ "name": "unread",
8902
+ "type": {
8903
+ "text": "boolean | undefined"
8904
+ },
8905
+ "description": "Mark the message as unread. By default messages are read.",
8906
+ "fieldName": "unread"
8907
+ }
8908
+ ],
8909
+ "mixins": [
8910
+ {
8911
+ "name": "FocusableMixin",
8912
+ "module": "/src/common/mixins/FocusableMixin.js"
8913
+ }
8914
+ ],
8915
+ "superclass": {
8916
+ "name": "LitElement",
8917
+ "package": "lit"
8918
+ },
8919
+ "localization": [
8920
+ {
8921
+ "name": "unreadLabel",
8922
+ "description": "Label for the unread messages."
8923
+ }
8924
+ ],
8925
+ "status": "draft",
8926
+ "category": "action",
8927
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Messages should always perform an action when clicked.\n- The click action should navigate to a new page or provide more detail about the message.\n- Mark unread messages as read on user interaction.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t slot other components inside a message.\n\n</div>\n\n---\n\n## Content guidelines\n\nMessage content should be clear, accurate and easy to understand:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Patient arrived</div>\n\nWhen writing the message content, be concise. Keep content to 1 to 2 sentence:\n\n<div class=\"n-usage n-usage-do\">You’ve reached the limit of 30 users included in your plan. Upgrade to add more.</div>\n<div class=\"n-usage n-usage-dont\">You have reached the user limit. Your clinic can only have a maximum of 30 users. To add more users, remove users you no longer need or upgrade your plan to add more.</div>\n\nWhen writing the notification content, always write it in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen Arrived To Clinic With Pixie Cat.</div>\n\nAlways end in punctuation:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen arrived to clinic with Pixie cat</div>\n\nAvoid all caps for messages:\n\n<div class=\"n-usage n-usage-do\">Nina Williams arrived to clinic with Norfryd</div>\n<div class=\"n-usage n-usage-dont\">NINA WILLIAMS ARRIVED TO CLINIC WITH NORFRYD</div>\n",
8928
+ "examples": [],
8929
+ "dependencies": [
8930
+ "dropdown-item"
8931
+ ],
8932
+ "tagName": "nord-message",
8933
+ "customElement": true
8934
+ }
8935
+ ],
8936
+ "exports": [
8937
+ {
8938
+ "kind": "js",
8939
+ "name": "default",
8940
+ "declaration": {
8941
+ "name": "Message",
8942
+ "module": "src/message/Message.ts"
8943
+ }
8944
+ },
8945
+ {
8946
+ "kind": "custom-element-definition",
8947
+ "name": "nord-message",
8948
+ "declaration": {
8949
+ "name": "Message",
8950
+ "module": "src/message/Message.ts"
8951
+ }
8952
+ }
8953
+ ]
8954
+ },
8955
+ {
8956
+ "kind": "javascript-module",
8957
+ "path": "src/message/localization.ts",
8958
+ "declarations": [
8959
+ {
8960
+ "kind": "variable",
8961
+ "name": "localization",
8962
+ "type": {
8963
+ "text": "object"
8964
+ },
8965
+ "default": "{\n unreadLabel: \"Unread\",\n}"
8966
+ }
8967
+ ],
8968
+ "exports": [
8969
+ {
8970
+ "kind": "js",
8971
+ "name": "default",
8972
+ "declaration": {
8973
+ "name": "localization",
8974
+ "module": "src/message/localization.ts"
8975
+ }
8976
+ }
8977
+ ]
8978
+ },
8979
+ {
8980
+ "kind": "javascript-module",
8981
+ "path": "src/modal/Modal.ts",
8982
+ "declarations": [
8983
+ {
8984
+ "kind": "class",
8985
+ "description": "Modal component is used to display content that temporarily blocks interactions\nwith the main view of an application. Modal should be used sparingly and\nonly when necessary.",
8986
+ "name": "Modal",
8987
+ "cssProperties": [
8988
+ {
8989
+ "description": "Controls the padding on the sides of the modal, using our [spacing tokens](/tokens/#space).",
8990
+ "name": "--n-modal-padding-inline",
8991
+ "default": "var(--n-space-m)"
8992
+ },
8993
+ {
8994
+ "description": "Controls the padding above and below the modal, using our [spacing tokens](/tokens/#space).",
8995
+ "name": "--n-modal-padding-block",
8996
+ "default": "var(--n-space-m)"
8997
+ },
8998
+ {
8999
+ "description": "Controls the width of the modal.",
9000
+ "name": "--n-modal-max-inline-size",
9001
+ "default": "620px"
9002
+ }
9003
+ ],
9004
+ "slots": [
9005
+ {
9006
+ "description": "Default slot",
9007
+ "name": ""
9008
+ },
9009
+ {
9010
+ "description": "Slot which holds the header of the modal, positioned next to the close button.",
9011
+ "name": "header"
9012
+ },
9013
+ {
9014
+ "description": "Slot which is typically used to hold call to action buttons, but can also be used to build custom footers.",
9015
+ "name": "footer"
9016
+ }
9017
+ ],
9018
+ "members": [
9019
+ {
9020
+ "kind": "field",
9021
+ "name": "modal",
9022
+ "type": {
9023
+ "text": "HTMLDivElement"
9024
+ },
9025
+ "privacy": "private"
9026
+ },
9027
+ {
9028
+ "kind": "field",
9029
+ "name": "backdrop",
9030
+ "type": {
9031
+ "text": "HTMLDivElement"
9032
+ },
9033
+ "privacy": "private"
9034
+ },
9035
+ {
9036
+ "kind": "field",
9037
+ "name": "headerSlot",
9038
+ "privacy": "private",
9039
+ "default": "new SlotController(this, \"header\")"
9040
+ },
9041
+ {
9042
+ "kind": "field",
9043
+ "name": "featureSlot",
9044
+ "privacy": "private",
9045
+ "default": "new SlotController(this, \"feature\")"
9046
+ },
9047
+ {
9048
+ "kind": "field",
9049
+ "name": "footerSlot",
9050
+ "privacy": "private",
9051
+ "default": "new SlotController(this, \"footer\")"
9052
+ },
9053
+ {
9054
+ "kind": "field",
9055
+ "name": "localize",
9056
+ "privacy": "private",
9057
+ "default": "new LocalizeController<\"nord-modal\">(this)"
9058
+ },
9059
+ {
9060
+ "kind": "field",
9061
+ "name": "modalController",
9062
+ "privacy": "private",
9063
+ "default": "new ModalController(this, {\n isOpen: () => this.open,\n onDismiss: () => this.handleDismiss(),\n dialog: () => this.modal,\n backdrop: () => this.backdrop,\n close: returnValue => this.close(returnValue),\n })"
9064
+ },
9065
+ {
9066
+ "kind": "field",
9067
+ "name": "open",
9068
+ "type": {
9069
+ "text": "boolean"
9070
+ },
9071
+ "default": "false",
9072
+ "description": "Controls whether the modal is open or not.",
9073
+ "attribute": "open",
9074
+ "reflects": true
9075
+ },
9076
+ {
9077
+ "kind": "field",
9078
+ "name": "size",
9079
+ "type": {
9080
+ "text": "\"s\" | \"m\" | \"l\""
9081
+ },
9082
+ "default": "\"m\"",
9083
+ "description": "Controls the max-width of the modal when open.",
9084
+ "attribute": "size",
9085
+ "reflects": true
9086
+ },
9087
+ {
9088
+ "kind": "field",
9089
+ "name": "returnValue",
9090
+ "type": {
9091
+ "text": "string"
9092
+ },
9093
+ "default": "\"\"",
9094
+ "description": "The reason why the modal was closed. This typically indicates\nwhich button the user pressed to close the modal, though any value\ncan be supplied if the modal is programmatically closed."
9095
+ },
9096
+ {
9097
+ "kind": "field",
9098
+ "name": "scrollable",
9099
+ "type": {
9100
+ "text": "boolean"
9101
+ },
9102
+ "default": "false",
9103
+ "description": "By default if a modal is too big for the browser window,\nthe entire modal will scroll. This setting changes that behavior\nso that the body of the modal scrolls instead, with the modal\nitself remaining fixed.",
9104
+ "attribute": "scrollable",
9105
+ "reflects": true
9106
+ },
9107
+ {
9108
+ "kind": "method",
9109
+ "name": "showModal",
9110
+ "description": "Show the modal, automatically moving focus to the modal or a child\nelement with an `autofocus` attribute."
9111
+ },
9112
+ {
9113
+ "kind": "method",
9114
+ "name": "close",
9115
9115
  "parameters": [
9116
9116
  {
9117
9117
  "name": "returnValue",
@@ -10136,206 +10136,34 @@
10136
10136
  "declarations": [
10137
10137
  {
10138
10138
  "kind": "class",
10139
- "description": "Notification group is used to position and style a group of notifications.",
10140
- "name": "NotificationGroup",
10141
- "slots": [
10142
- {
10143
- "description": "Default slot in which to place notifications.",
10144
- "name": ""
10145
- }
10146
- ],
10147
- "members": [
10148
- {
10149
- "kind": "field",
10150
- "name": "_warningLogged",
10151
- "type": {
10152
- "text": "boolean"
10153
- },
10154
- "privacy": "private",
10155
- "static": true,
10156
- "default": "false",
10157
- "inheritedFrom": {
10158
- "name": "DraftComponentMixin",
10159
- "module": "src/common/mixins/DraftComponentMixin.ts"
10160
- }
10161
- }
10162
- ],
10163
- "mixins": [
10164
- {
10165
- "name": "DraftComponentMixin",
10166
- "module": "/src/common/mixins/DraftComponentMixin.js"
10167
- }
10168
- ],
10169
- "superclass": {
10170
- "name": "LitElement",
10171
- "package": "lit"
10172
- },
10173
- "localization": [],
10174
- "status": "draft",
10175
- "category": "feedback",
10176
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use in combination with [Notification](/components/notification/) so that notifications get styled and positioned correctly.\n- Add as close to the start of your main content area as possible.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for grouping anything other than notification components\n\n</div>\n\n---\n\n## Content guidelines\n\nNotification content should be clear, accurate and easy to understand:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Patient arrived</div>\n\nWhen writing the notification content, be concise. Keep content to 1 to 2 sentence:\n\n<div class=\"n-usage n-usage-do\">You’ve reached the limit of 30 users included in your plan. Upgrade to add more.</div>\n<div class=\"n-usage n-usage-dont\">You have reached the user limit. Your clinic can only have a maximum of 30 users. To add more users, remove users you no longer need or upgrade your plan to add more.</div>\n\nWhen writing the notification content, always write it in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen Arrived To Clinic With Pixie Cat.</div>\n\nAlways end in punctuation:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen arrived to clinic with Pixie cat</div>\n\nAction link labels in notifications should be clear, accurate and predictable. It should be possible for the user to understand what will happen when they click a button:\n\n<div class=\"n-usage n-usage-do\">Start consultation</div>\n<div class=\"n-usage n-usage-dont\">Click here</div>\n\nWhen writing action link labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Start consultation</div>\n<div class=\"n-usage n-usage-dont\">Start Consultation</div>\n\nAvoid unnecessary words and articles in action link labels, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Add item</div>\n<div class=\"n-usage n-usage-dont\">Add an item</div>\n",
10177
- "examples": [],
10178
- "dependencies": [],
10179
- "tagName": "nord-notification-group",
10180
- "customElement": true
10181
- }
10182
- ],
10183
- "exports": [
10184
- {
10185
- "kind": "js",
10186
- "name": "default",
10187
- "declaration": {
10188
- "name": "NotificationGroup",
10189
- "module": "src/notification-group/NotificationGroup.ts"
10190
- }
10191
- },
10192
- {
10193
- "kind": "custom-element-definition",
10194
- "name": "nord-notification-group",
10195
- "declaration": {
10196
- "name": "NotificationGroup",
10197
- "module": "src/notification-group/NotificationGroup.ts"
10198
- }
10199
- }
10200
- ]
10201
- },
10202
- {
10203
- "kind": "javascript-module",
10204
- "path": "src/progress-bar/ProgressBar.ts",
10205
- "declarations": [
10206
- {
10207
- "kind": "class",
10208
- "description": "Progress Bar is used to visually represent the completion\nof a task or process. It shows how much of the task has\nbeen completed and how much is still left.",
10209
- "name": "ProgressBar",
10210
- "cssProperties": [
10211
- {
10212
- "description": "Controls the thickness of the progress bar, using our [spacing tokens](/tokens/#space).",
10213
- "name": "--n-progress-size",
10214
- "default": "var(--n-space-s)"
10215
- },
10216
- {
10217
- "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
10218
- "name": "--n-progress-border-radius",
10219
- "default": "var(--n-border-radius-s)"
10220
- },
10221
- {
10222
- "description": "Controls the color of the progress bar, using [color tokens](/tokens/#color).",
10223
- "name": "--n-progress-color",
10224
- "default": "var(--n-color-accent)"
10225
- }
10226
- ],
10227
- "members": [
10228
- {
10229
- "kind": "field",
10230
- "name": "value",
10231
- "type": {
10232
- "text": "number | undefined"
10233
- },
10234
- "description": "Specifies how much of the task has been completed. Must be a valid floating\npoint number between 0 and max, or between 0 and 100 if max is omitted. If\nthere is no value, the progress bar is indeterminate; this indicates that\nan activity is ongoing with no indication of how long it’s expected to take.",
10235
- "attribute": "value",
10236
- "reflects": true
10237
- },
10238
- {
10239
- "kind": "field",
10240
- "name": "max",
10241
- "type": {
10242
- "text": "number"
10243
- },
10244
- "default": "100",
10245
- "description": "Describes how much work the task indicated by the progress element requires.\nThe max attribute, if present, must have a value greater than 0 and be a\nvalid floating point number.",
10246
- "attribute": "max",
10247
- "reflects": true
10248
- },
10249
- {
10250
- "kind": "field",
10251
- "name": "label",
10252
- "type": {
10253
- "text": "string"
10254
- },
10255
- "default": "\"Current progress\"",
10256
- "description": "Accessible label for the progress indicator. Visually hidden, but shown\nfor assistive technology.",
10257
- "attribute": "label",
10258
- "reflects": true
10259
- },
10260
- {
10261
- "kind": "field",
10262
- "name": "focusableRef",
10263
- "privacy": "protected",
10264
- "inheritedFrom": {
10265
- "name": "FocusableMixin",
10266
- "module": "src/common/mixins/FocusableMixin.ts"
10267
- }
10268
- },
10269
- {
10270
- "kind": "method",
10271
- "name": "focus",
10272
- "parameters": [
10273
- {
10274
- "name": "options",
10275
- "optional": true,
10276
- "type": {
10277
- "text": "FocusOptions"
10278
- },
10279
- "description": "An object which controls aspects of the focusing process."
10280
- }
10281
- ],
10282
- "description": "Programmatically move focus to the component.",
10283
- "inheritedFrom": {
10284
- "name": "FocusableMixin",
10285
- "module": "src/common/mixins/FocusableMixin.ts"
10286
- }
10287
- },
10288
- {
10289
- "kind": "method",
10290
- "name": "blur",
10291
- "description": "Programmatically remove focus from the component.",
10292
- "inheritedFrom": {
10293
- "name": "FocusableMixin",
10294
- "module": "src/common/mixins/FocusableMixin.ts"
10295
- }
10296
- },
10297
- {
10298
- "kind": "method",
10299
- "name": "click",
10300
- "description": "Programmatically simulates a click on the component.",
10301
- "inheritedFrom": {
10302
- "name": "FocusableMixin",
10303
- "module": "src/common/mixins/FocusableMixin.ts"
10304
- }
10305
- }
10306
- ],
10307
- "attributes": [
10308
- {
10309
- "name": "value",
10310
- "type": {
10311
- "text": "number | undefined"
10312
- },
10313
- "description": "Specifies how much of the task has been completed. Must be a valid floating\npoint number between 0 and max, or between 0 and 100 if max is omitted. If\nthere is no value, the progress bar is indeterminate; this indicates that\nan activity is ongoing with no indication of how long it’s expected to take.",
10314
- "fieldName": "value"
10315
- },
10316
- {
10317
- "name": "max",
10318
- "type": {
10319
- "text": "number"
10320
- },
10321
- "default": "100",
10322
- "description": "Describes how much work the task indicated by the progress element requires.\nThe max attribute, if present, must have a value greater than 0 and be a\nvalid floating point number.",
10323
- "fieldName": "max"
10324
- },
10139
+ "description": "Notification group is used to position and style a group of notifications.",
10140
+ "name": "NotificationGroup",
10141
+ "slots": [
10325
10142
  {
10326
- "name": "label",
10143
+ "description": "Default slot in which to place notifications.",
10144
+ "name": ""
10145
+ }
10146
+ ],
10147
+ "members": [
10148
+ {
10149
+ "kind": "field",
10150
+ "name": "_warningLogged",
10327
10151
  "type": {
10328
- "text": "string"
10152
+ "text": "boolean"
10329
10153
  },
10330
- "default": "\"Current progress\"",
10331
- "description": "Accessible label for the progress indicator. Visually hidden, but shown\nfor assistive technology.",
10332
- "fieldName": "label"
10154
+ "privacy": "private",
10155
+ "static": true,
10156
+ "default": "false",
10157
+ "inheritedFrom": {
10158
+ "name": "DraftComponentMixin",
10159
+ "module": "src/common/mixins/DraftComponentMixin.ts"
10160
+ }
10333
10161
  }
10334
10162
  ],
10335
10163
  "mixins": [
10336
10164
  {
10337
- "name": "FocusableMixin",
10338
- "module": "/src/common/mixins/FocusableMixin.js"
10165
+ "name": "DraftComponentMixin",
10166
+ "module": "/src/common/mixins/DraftComponentMixin.js"
10339
10167
  }
10340
10168
  ],
10341
10169
  "superclass": {
@@ -10343,12 +10171,12 @@
10343
10171
  "package": "lit"
10344
10172
  },
10345
10173
  "localization": [],
10346
- "status": "ready",
10174
+ "status": "draft",
10347
10175
  "category": "feedback",
10348
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use to show the completion status of an ongoing task.\n- Use progress bar when you can determine the percentage of the completed task at any time.\n- Always provide an accessible label when using Progress Bar.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use in constrained spaces indicating indeterminate loading state, see [Spinner](/components/spinner/) instead.\n\n</div>\n",
10176
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use in combination with [Notification](/components/notification/) so that notifications get styled and positioned correctly.\n- Add as close to the start of your main content area as possible.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for grouping anything other than notification components\n\n</div>\n\n---\n\n## Content guidelines\n\nNotification content should be clear, accurate and easy to understand:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Patient arrived</div>\n\nWhen writing the notification content, be concise. Keep content to 1 to 2 sentence:\n\n<div class=\"n-usage n-usage-do\">You’ve reached the limit of 30 users included in your plan. Upgrade to add more.</div>\n<div class=\"n-usage n-usage-dont\">You have reached the user limit. Your clinic can only have a maximum of 30 users. To add more users, remove users you no longer need or upgrade your plan to add more.</div>\n\nWhen writing the notification content, always write it in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen Arrived To Clinic With Pixie Cat.</div>\n\nAlways end in punctuation:\n\n<div class=\"n-usage n-usage-do\">Ariel Salminen arrived to clinic with Pixie cat.</div>\n<div class=\"n-usage n-usage-dont\">Ariel Salminen arrived to clinic with Pixie cat</div>\n\nAction link labels in notifications should be clear, accurate and predictable. It should be possible for the user to understand what will happen when they click a button:\n\n<div class=\"n-usage n-usage-do\">Start consultation</div>\n<div class=\"n-usage n-usage-dont\">Click here</div>\n\nWhen writing action link labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Start consultation</div>\n<div class=\"n-usage n-usage-dont\">Start Consultation</div>\n\nAvoid unnecessary words and articles in action link labels, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Add item</div>\n<div class=\"n-usage n-usage-dont\">Add an item</div>\n",
10349
10177
  "examples": [],
10350
10178
  "dependencies": [],
10351
- "tagName": "nord-progress-bar",
10179
+ "tagName": "nord-notification-group",
10352
10180
  "customElement": true
10353
10181
  }
10354
10182
  ],
@@ -10357,16 +10185,16 @@
10357
10185
  "kind": "js",
10358
10186
  "name": "default",
10359
10187
  "declaration": {
10360
- "name": "ProgressBar",
10361
- "module": "src/progress-bar/ProgressBar.ts"
10188
+ "name": "NotificationGroup",
10189
+ "module": "src/notification-group/NotificationGroup.ts"
10362
10190
  }
10363
10191
  },
10364
10192
  {
10365
10193
  "kind": "custom-element-definition",
10366
- "name": "nord-progress-bar",
10194
+ "name": "nord-notification-group",
10367
10195
  "declaration": {
10368
- "name": "ProgressBar",
10369
- "module": "src/progress-bar/ProgressBar.ts"
10196
+ "name": "NotificationGroup",
10197
+ "module": "src/notification-group/NotificationGroup.ts"
10370
10198
  }
10371
10199
  }
10372
10200
  ]
@@ -10557,128 +10385,300 @@
10557
10385
  },
10558
10386
  {
10559
10387
  "kind": "field",
10560
- "name": "open",
10561
- "type": {
10562
- "text": "boolean"
10563
- },
10564
- "default": "false",
10565
- "description": "Controls whether the component is open or not.",
10566
- "attribute": "open",
10567
- "reflects": true,
10388
+ "name": "open",
10389
+ "type": {
10390
+ "text": "boolean"
10391
+ },
10392
+ "default": "false",
10393
+ "description": "Controls whether the component is open or not.",
10394
+ "attribute": "open",
10395
+ "reflects": true,
10396
+ "inheritedFrom": {
10397
+ "name": "FloatingMixin",
10398
+ "module": "src/common/mixins/FloatingComponentMixin.ts"
10399
+ }
10400
+ },
10401
+ {
10402
+ "kind": "field",
10403
+ "name": "align",
10404
+ "type": {
10405
+ "text": "\"start\" | \"end\""
10406
+ },
10407
+ "default": "\"start\"",
10408
+ "description": "Set the alignment in relation to the toggle (or anchor) depending on the position.\n`start` will align it to the left of the toggle (or anchor).\n`end` will align it to the right of the toggle (or anchor).\nSetting the `position` to `inline-start` or `inline-end` will switch\n`start` and `end` to the top and bottom respectively.",
10409
+ "attribute": "align",
10410
+ "reflects": true,
10411
+ "inheritedFrom": {
10412
+ "name": "FloatingMixin",
10413
+ "module": "src/common/mixins/FloatingComponentMixin.ts"
10414
+ }
10415
+ },
10416
+ {
10417
+ "kind": "field",
10418
+ "name": "position",
10419
+ "type": {
10420
+ "text": "\"block-end\" | \"block-start\" | \"inline-start\" | \"inline-end\""
10421
+ },
10422
+ "default": "\"block-end\"",
10423
+ "description": "Set the position in relation to the toggle (or anchor).\nOptions follow logical properties.\n`block-start` and `block-end` referring to top and bottom respectively,\n`inline-start` and `inline-end` referring to left and right respectively.",
10424
+ "attribute": "position",
10425
+ "reflects": true,
10426
+ "inheritedFrom": {
10427
+ "name": "FloatingMixin",
10428
+ "module": "src/common/mixins/FloatingComponentMixin.ts"
10429
+ }
10430
+ }
10431
+ ],
10432
+ "events": [
10433
+ {
10434
+ "name": "open",
10435
+ "type": {
10436
+ "text": "NordEvent"
10437
+ },
10438
+ "description": "Dispatched when the popout is opened."
10439
+ },
10440
+ {
10441
+ "name": "close",
10442
+ "type": {
10443
+ "text": "NordEvent"
10444
+ },
10445
+ "description": "Dispatched when the popout is closed."
10446
+ }
10447
+ ],
10448
+ "attributes": [
10449
+ {
10450
+ "name": "id",
10451
+ "type": {
10452
+ "text": "string"
10453
+ },
10454
+ "default": "\"\"",
10455
+ "description": "The id for the active element to reference via aria-controls.",
10456
+ "fieldName": "id"
10457
+ },
10458
+ {
10459
+ "name": "anchor",
10460
+ "type": {
10461
+ "text": "string | undefined"
10462
+ },
10463
+ "description": "Set an optional anchor element to align against, replacing the triggering element.",
10464
+ "fieldName": "anchor"
10465
+ },
10466
+ {
10467
+ "name": "open",
10468
+ "type": {
10469
+ "text": "boolean"
10470
+ },
10471
+ "default": "false",
10472
+ "description": "Controls whether the component is open or not.",
10473
+ "fieldName": "open",
10474
+ "inheritedFrom": {
10475
+ "name": "FloatingMixin",
10476
+ "module": "src/common/mixins/FloatingComponentMixin.ts"
10477
+ }
10478
+ },
10479
+ {
10480
+ "name": "align",
10481
+ "type": {
10482
+ "text": "\"start\" | \"end\""
10483
+ },
10484
+ "default": "\"start\"",
10485
+ "description": "Set the alignment in relation to the toggle (or anchor) depending on the position.\n`start` will align it to the left of the toggle (or anchor).\n`end` will align it to the right of the toggle (or anchor).\nSetting the `position` to `inline-start` or `inline-end` will switch\n`start` and `end` to the top and bottom respectively.",
10486
+ "fieldName": "align",
10487
+ "inheritedFrom": {
10488
+ "name": "FloatingMixin",
10489
+ "module": "src/common/mixins/FloatingComponentMixin.ts"
10490
+ }
10491
+ },
10492
+ {
10493
+ "name": "position",
10494
+ "type": {
10495
+ "text": "\"block-end\" | \"block-start\" | \"inline-start\" | \"inline-end\""
10496
+ },
10497
+ "default": "\"block-end\"",
10498
+ "description": "Set the position in relation to the toggle (or anchor).\nOptions follow logical properties.\n`block-start` and `block-end` referring to top and bottom respectively,\n`inline-start` and `inline-end` referring to left and right respectively.",
10499
+ "fieldName": "position",
10500
+ "inheritedFrom": {
10501
+ "name": "FloatingMixin",
10502
+ "module": "src/common/mixins/FloatingComponentMixin.ts"
10503
+ }
10504
+ }
10505
+ ],
10506
+ "mixins": [
10507
+ {
10508
+ "name": "FloatingMixin",
10509
+ "module": "/src/common/mixins/FloatingComponentMixin.js"
10510
+ }
10511
+ ],
10512
+ "superclass": {
10513
+ "name": "LitElement",
10514
+ "package": "lit"
10515
+ },
10516
+ "localization": [],
10517
+ "status": "ready",
10518
+ "category": "overlay",
10519
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Always position popout next to the button or other interface element that toggles it.\n- Use a popout to contain controls or information that doesn’t need to be shown immediately.\n- Use a popout to contain items that will most likely not fit into the current view.\n- Use a clearly labelled button to reveal the popout.\n- Use the appropriate `aria-haspopup` and `role` attributes for both the toggle button and containing items. Please refer to the [MDN documentation on both role values](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup#values) and [child role values](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup#associated_roles).\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t hide information inside a popout that is imperative to using the current view.\n- Don’t obscure other controls that are important with the popout.\n- Don’t allow the popout to be obscured by other controls or the outer bounds of the current view.\n</div>\n\n---\n\n## Content guidelines\n\nIf a popout contains actions, they should be always written in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Create user</div>\n<div class=\"n-usage n-usage-dont\">Create User</div>\n\nPopout actions should always lead with a strong verb that encourages action. Use the `{verb}+{noun}` format except in the case of common actions like Save, Close or Cancel:\n\n<div class=\"n-usage n-usage-do\">Edit row</div>\n<div class=\"n-usage n-usage-dont\">Editing options</div>\n\nAvoid unnecessary words and articles in popout actions, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme</div>\n\nAvoid ending popout actions in punctuation:\n\n<div class=\"n-usage n-usage-do\">Switch user</div>\n<div class=\"n-usage n-usage-dont\">Switch user.</div>\n\nAvoid all caps for popout actions:\n\n<div class=\"n-usage n-usage-do\">Rename</div>\n<div class=\"n-usage n-usage-dont\">RENAME</div>\n\n---\n\n## Additional considerations\n\n- The popout component is a containing component, only providing a way to reveal and hide controls by using a single button.\n",
10520
+ "examples": [],
10521
+ "dependencies": [],
10522
+ "tagName": "nord-popout",
10523
+ "customElement": true
10524
+ }
10525
+ ],
10526
+ "exports": [
10527
+ {
10528
+ "kind": "js",
10529
+ "name": "default",
10530
+ "declaration": {
10531
+ "name": "Popout",
10532
+ "module": "src/popout/Popout.ts"
10533
+ }
10534
+ },
10535
+ {
10536
+ "kind": "custom-element-definition",
10537
+ "name": "nord-popout",
10538
+ "declaration": {
10539
+ "name": "Popout",
10540
+ "module": "src/popout/Popout.ts"
10541
+ }
10542
+ }
10543
+ ]
10544
+ },
10545
+ {
10546
+ "kind": "javascript-module",
10547
+ "path": "src/progress-bar/ProgressBar.ts",
10548
+ "declarations": [
10549
+ {
10550
+ "kind": "class",
10551
+ "description": "Progress Bar is used to visually represent the completion\nof a task or process. It shows how much of the task has\nbeen completed and how much is still left.",
10552
+ "name": "ProgressBar",
10553
+ "cssProperties": [
10554
+ {
10555
+ "description": "Controls the thickness of the progress bar, using our [spacing tokens](/tokens/#space).",
10556
+ "name": "--n-progress-size",
10557
+ "default": "var(--n-space-s)"
10558
+ },
10559
+ {
10560
+ "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
10561
+ "name": "--n-progress-border-radius",
10562
+ "default": "var(--n-border-radius-s)"
10563
+ },
10564
+ {
10565
+ "description": "Controls the color of the progress bar, using [color tokens](/tokens/#color).",
10566
+ "name": "--n-progress-color",
10567
+ "default": "var(--n-color-accent)"
10568
+ }
10569
+ ],
10570
+ "members": [
10571
+ {
10572
+ "kind": "field",
10573
+ "name": "value",
10574
+ "type": {
10575
+ "text": "number | undefined"
10576
+ },
10577
+ "description": "Specifies how much of the task has been completed. Must be a valid floating\npoint number between 0 and max, or between 0 and 100 if max is omitted. If\nthere is no value, the progress bar is indeterminate; this indicates that\nan activity is ongoing with no indication of how long it’s expected to take.",
10578
+ "attribute": "value",
10579
+ "reflects": true
10580
+ },
10581
+ {
10582
+ "kind": "field",
10583
+ "name": "max",
10584
+ "type": {
10585
+ "text": "number"
10586
+ },
10587
+ "default": "100",
10588
+ "description": "Describes how much work the task indicated by the progress element requires.\nThe max attribute, if present, must have a value greater than 0 and be a\nvalid floating point number.",
10589
+ "attribute": "max",
10590
+ "reflects": true
10591
+ },
10592
+ {
10593
+ "kind": "field",
10594
+ "name": "label",
10595
+ "type": {
10596
+ "text": "string"
10597
+ },
10598
+ "default": "\"Current progress\"",
10599
+ "description": "Accessible label for the progress indicator. Visually hidden, but shown\nfor assistive technology.",
10600
+ "attribute": "label",
10601
+ "reflects": true
10602
+ },
10603
+ {
10604
+ "kind": "field",
10605
+ "name": "focusableRef",
10606
+ "privacy": "protected",
10568
10607
  "inheritedFrom": {
10569
- "name": "FloatingMixin",
10570
- "module": "src/common/mixins/FloatingComponentMixin.ts"
10608
+ "name": "FocusableMixin",
10609
+ "module": "src/common/mixins/FocusableMixin.ts"
10571
10610
  }
10572
10611
  },
10573
10612
  {
10574
- "kind": "field",
10575
- "name": "align",
10576
- "type": {
10577
- "text": "\"start\" | \"end\""
10578
- },
10579
- "default": "\"start\"",
10580
- "description": "Set the alignment in relation to the toggle (or anchor) depending on the position.\n`start` will align it to the left of the toggle (or anchor).\n`end` will align it to the right of the toggle (or anchor).\nSetting the `position` to `inline-start` or `inline-end` will switch\n`start` and `end` to the top and bottom respectively.",
10581
- "attribute": "align",
10582
- "reflects": true,
10613
+ "kind": "method",
10614
+ "name": "focus",
10615
+ "parameters": [
10616
+ {
10617
+ "name": "options",
10618
+ "optional": true,
10619
+ "type": {
10620
+ "text": "FocusOptions"
10621
+ },
10622
+ "description": "An object which controls aspects of the focusing process."
10623
+ }
10624
+ ],
10625
+ "description": "Programmatically move focus to the component.",
10583
10626
  "inheritedFrom": {
10584
- "name": "FloatingMixin",
10585
- "module": "src/common/mixins/FloatingComponentMixin.ts"
10627
+ "name": "FocusableMixin",
10628
+ "module": "src/common/mixins/FocusableMixin.ts"
10586
10629
  }
10587
10630
  },
10588
10631
  {
10589
- "kind": "field",
10590
- "name": "position",
10591
- "type": {
10592
- "text": "\"block-end\" | \"block-start\" | \"inline-start\" | \"inline-end\""
10593
- },
10594
- "default": "\"block-end\"",
10595
- "description": "Set the position in relation to the toggle (or anchor).\nOptions follow logical properties.\n`block-start` and `block-end` referring to top and bottom respectively,\n`inline-start` and `inline-end` referring to left and right respectively.",
10596
- "attribute": "position",
10597
- "reflects": true,
10632
+ "kind": "method",
10633
+ "name": "blur",
10634
+ "description": "Programmatically remove focus from the component.",
10598
10635
  "inheritedFrom": {
10599
- "name": "FloatingMixin",
10600
- "module": "src/common/mixins/FloatingComponentMixin.ts"
10636
+ "name": "FocusableMixin",
10637
+ "module": "src/common/mixins/FocusableMixin.ts"
10601
10638
  }
10602
- }
10603
- ],
10604
- "events": [
10605
- {
10606
- "name": "open",
10607
- "type": {
10608
- "text": "NordEvent"
10609
- },
10610
- "description": "Dispatched when the popout is opened."
10611
10639
  },
10612
10640
  {
10613
- "name": "close",
10614
- "type": {
10615
- "text": "NordEvent"
10616
- },
10617
- "description": "Dispatched when the popout is closed."
10641
+ "kind": "method",
10642
+ "name": "click",
10643
+ "description": "Programmatically simulates a click on the component.",
10644
+ "inheritedFrom": {
10645
+ "name": "FocusableMixin",
10646
+ "module": "src/common/mixins/FocusableMixin.ts"
10647
+ }
10618
10648
  }
10619
10649
  ],
10620
10650
  "attributes": [
10621
10651
  {
10622
- "name": "id",
10623
- "type": {
10624
- "text": "string"
10625
- },
10626
- "default": "\"\"",
10627
- "description": "The id for the active element to reference via aria-controls.",
10628
- "fieldName": "id"
10629
- },
10630
- {
10631
- "name": "anchor",
10632
- "type": {
10633
- "text": "string | undefined"
10634
- },
10635
- "description": "Set an optional anchor element to align against, replacing the triggering element.",
10636
- "fieldName": "anchor"
10637
- },
10638
- {
10639
- "name": "open",
10652
+ "name": "value",
10640
10653
  "type": {
10641
- "text": "boolean"
10654
+ "text": "number | undefined"
10642
10655
  },
10643
- "default": "false",
10644
- "description": "Controls whether the component is open or not.",
10645
- "fieldName": "open",
10646
- "inheritedFrom": {
10647
- "name": "FloatingMixin",
10648
- "module": "src/common/mixins/FloatingComponentMixin.ts"
10649
- }
10656
+ "description": "Specifies how much of the task has been completed. Must be a valid floating\npoint number between 0 and max, or between 0 and 100 if max is omitted. If\nthere is no value, the progress bar is indeterminate; this indicates that\nan activity is ongoing with no indication of how long it’s expected to take.",
10657
+ "fieldName": "value"
10650
10658
  },
10651
10659
  {
10652
- "name": "align",
10660
+ "name": "max",
10653
10661
  "type": {
10654
- "text": "\"start\" | \"end\""
10662
+ "text": "number"
10655
10663
  },
10656
- "default": "\"start\"",
10657
- "description": "Set the alignment in relation to the toggle (or anchor) depending on the position.\n`start` will align it to the left of the toggle (or anchor).\n`end` will align it to the right of the toggle (or anchor).\nSetting the `position` to `inline-start` or `inline-end` will switch\n`start` and `end` to the top and bottom respectively.",
10658
- "fieldName": "align",
10659
- "inheritedFrom": {
10660
- "name": "FloatingMixin",
10661
- "module": "src/common/mixins/FloatingComponentMixin.ts"
10662
- }
10664
+ "default": "100",
10665
+ "description": "Describes how much work the task indicated by the progress element requires.\nThe max attribute, if present, must have a value greater than 0 and be a\nvalid floating point number.",
10666
+ "fieldName": "max"
10663
10667
  },
10664
10668
  {
10665
- "name": "position",
10669
+ "name": "label",
10666
10670
  "type": {
10667
- "text": "\"block-end\" | \"block-start\" | \"inline-start\" | \"inline-end\""
10671
+ "text": "string"
10668
10672
  },
10669
- "default": "\"block-end\"",
10670
- "description": "Set the position in relation to the toggle (or anchor).\nOptions follow logical properties.\n`block-start` and `block-end` referring to top and bottom respectively,\n`inline-start` and `inline-end` referring to left and right respectively.",
10671
- "fieldName": "position",
10672
- "inheritedFrom": {
10673
- "name": "FloatingMixin",
10674
- "module": "src/common/mixins/FloatingComponentMixin.ts"
10675
- }
10673
+ "default": "\"Current progress\"",
10674
+ "description": "Accessible label for the progress indicator. Visually hidden, but shown\nfor assistive technology.",
10675
+ "fieldName": "label"
10676
10676
  }
10677
10677
  ],
10678
10678
  "mixins": [
10679
10679
  {
10680
- "name": "FloatingMixin",
10681
- "module": "/src/common/mixins/FloatingComponentMixin.js"
10680
+ "name": "FocusableMixin",
10681
+ "module": "/src/common/mixins/FocusableMixin.js"
10682
10682
  }
10683
10683
  ],
10684
10684
  "superclass": {
@@ -10687,11 +10687,11 @@
10687
10687
  },
10688
10688
  "localization": [],
10689
10689
  "status": "ready",
10690
- "category": "overlay",
10691
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Always position popout next to the button or other interface element that toggles it.\n- Use a popout to contain controls or information that doesn’t need to be shown immediately.\n- Use a popout to contain items that will most likely not fit into the current view.\n- Use a clearly labelled button to reveal the popout.\n- Use the appropriate `aria-haspopup` and `role` attributes for both the toggle button and containing items. Please refer to the [MDN documentation on both role values](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup#values) and [child role values](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup#associated_roles).\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t hide information inside a popout that is imperative to using the current view.\n- Don’t obscure other controls that are important with the popout.\n- Don’t allow the popout to be obscured by other controls or the outer bounds of the current view.\n</div>\n\n---\n\n## Content guidelines\n\nIf a popout contains actions, they should be always written in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Create user</div>\n<div class=\"n-usage n-usage-dont\">Create User</div>\n\nPopout actions should always lead with a strong verb that encourages action. Use the `{verb}+{noun}` format except in the case of common actions like Save, Close or Cancel:\n\n<div class=\"n-usage n-usage-do\">Edit row</div>\n<div class=\"n-usage n-usage-dont\">Editing options</div>\n\nAvoid unnecessary words and articles in popout actions, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme</div>\n\nAvoid ending popout actions in punctuation:\n\n<div class=\"n-usage n-usage-do\">Switch user</div>\n<div class=\"n-usage n-usage-dont\">Switch user.</div>\n\nAvoid all caps for popout actions:\n\n<div class=\"n-usage n-usage-do\">Rename</div>\n<div class=\"n-usage n-usage-dont\">RENAME</div>\n\n---\n\n## Additional considerations\n\n- The popout component is a containing component, only providing a way to reveal and hide controls by using a single button.\n",
10690
+ "category": "feedback",
10691
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use to show the completion status of an ongoing task.\n- Use progress bar when you can determine the percentage of the completed task at any time.\n- Always provide an accessible label when using Progress Bar.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use in constrained spaces indicating indeterminate loading state, see [Spinner](/components/spinner/) instead.\n\n</div>\n",
10692
10692
  "examples": [],
10693
10693
  "dependencies": [],
10694
- "tagName": "nord-popout",
10694
+ "tagName": "nord-progress-bar",
10695
10695
  "customElement": true
10696
10696
  }
10697
10697
  ],
@@ -10700,16 +10700,16 @@
10700
10700
  "kind": "js",
10701
10701
  "name": "default",
10702
10702
  "declaration": {
10703
- "name": "Popout",
10704
- "module": "src/popout/Popout.ts"
10703
+ "name": "ProgressBar",
10704
+ "module": "src/progress-bar/ProgressBar.ts"
10705
10705
  }
10706
10706
  },
10707
10707
  {
10708
10708
  "kind": "custom-element-definition",
10709
- "name": "nord-popout",
10709
+ "name": "nord-progress-bar",
10710
10710
  "declaration": {
10711
- "name": "Popout",
10712
- "module": "src/popout/Popout.ts"
10711
+ "name": "ProgressBar",
10712
+ "module": "src/progress-bar/ProgressBar.ts"
10713
10713
  }
10714
10714
  }
10715
10715
  ]
@@ -13637,54 +13637,6 @@
13637
13637
  }
13638
13638
  ]
13639
13639
  },
13640
- {
13641
- "kind": "javascript-module",
13642
- "path": "src/tab-panel/TabPanel.ts",
13643
- "declarations": [
13644
- {
13645
- "kind": "class",
13646
- "description": "The panel which contains content that can be revealed using a tab\nin the tab group component.",
13647
- "name": "TabPanel",
13648
- "slots": [
13649
- {
13650
- "description": "The tab panel content.",
13651
- "name": ""
13652
- }
13653
- ],
13654
- "members": [],
13655
- "superclass": {
13656
- "name": "LitElement",
13657
- "package": "lit"
13658
- },
13659
- "localization": [],
13660
- "status": "ready",
13661
- "category": "navigation",
13662
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use the tab panel component within the tab group component.\n- Use both non-interactive and interactive elements within the contents of the tab panel.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don't use the tab panel component outside of the tab group component.\n- Don't obscure important information within a tab panel that isn't revealed by default.\n\n</div>\n\n---\n\n## Content guidelines\n\nWhen writing tab labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">My tasks</div>\n<div class=\"n-usage n-usage-dont\">My Tasks</div>\n\nAvoid unnecessary words and articles in tab labels, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Dashboard</div>\n<div class=\"n-usage n-usage-dont\">The dashboard</div>\n\nAvoid ending tab labels in punctuation:\n\n<div class=\"n-usage n-usage-do\">Patients</div>\n<div class=\"n-usage n-usage-dont\">Patients.</div>\n\nUse as few words as possible to describe each tab label:\n\n<div class=\"n-usage n-usage-do\">Payments</div>\n<div class=\"n-usage n-usage-dont\">Payments in your clinic</div>\n\nAvoid all caps for tab labels:\n\n<div class=\"n-usage n-usage-do\">Dashboard</div>\n<div class=\"n-usage n-usage-dont\">DASHBOARD</div>\n\n---\n\n## Additional considerations\n\n- If the content contained within the tabs UI has significance or is important for the user to see, consider using a different form of presentation that doesn't obscure it.\n- If there is a particular tab panel you wish to show out of order of the tabs UI itself consider using the `selected` option on the related tab component to select the tab but prevent the order of the tabs being affected.\n",
13663
- "examples": [],
13664
- "dependencies": [],
13665
- "tagName": "nord-tab-panel",
13666
- "customElement": true
13667
- }
13668
- ],
13669
- "exports": [
13670
- {
13671
- "kind": "js",
13672
- "name": "default",
13673
- "declaration": {
13674
- "name": "TabPanel",
13675
- "module": "src/tab-panel/TabPanel.ts"
13676
- }
13677
- },
13678
- {
13679
- "kind": "custom-element-definition",
13680
- "name": "nord-tab-panel",
13681
- "declaration": {
13682
- "name": "TabPanel",
13683
- "module": "src/tab-panel/TabPanel.ts"
13684
- }
13685
- }
13686
- ]
13687
- },
13688
13640
  {
13689
13641
  "kind": "javascript-module",
13690
13642
  "path": "src/tab-group/TabGroup.ts",
@@ -13931,6 +13883,54 @@
13931
13883
  }
13932
13884
  ]
13933
13885
  },
13886
+ {
13887
+ "kind": "javascript-module",
13888
+ "path": "src/tab-panel/TabPanel.ts",
13889
+ "declarations": [
13890
+ {
13891
+ "kind": "class",
13892
+ "description": "The panel which contains content that can be revealed using a tab\nin the tab group component.",
13893
+ "name": "TabPanel",
13894
+ "slots": [
13895
+ {
13896
+ "description": "The tab panel content.",
13897
+ "name": ""
13898
+ }
13899
+ ],
13900
+ "members": [],
13901
+ "superclass": {
13902
+ "name": "LitElement",
13903
+ "package": "lit"
13904
+ },
13905
+ "localization": [],
13906
+ "status": "ready",
13907
+ "category": "navigation",
13908
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use the tab panel component within the tab group component.\n- Use both non-interactive and interactive elements within the contents of the tab panel.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don't use the tab panel component outside of the tab group component.\n- Don't obscure important information within a tab panel that isn't revealed by default.\n\n</div>\n\n---\n\n## Content guidelines\n\nWhen writing tab labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">My tasks</div>\n<div class=\"n-usage n-usage-dont\">My Tasks</div>\n\nAvoid unnecessary words and articles in tab labels, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Dashboard</div>\n<div class=\"n-usage n-usage-dont\">The dashboard</div>\n\nAvoid ending tab labels in punctuation:\n\n<div class=\"n-usage n-usage-do\">Patients</div>\n<div class=\"n-usage n-usage-dont\">Patients.</div>\n\nUse as few words as possible to describe each tab label:\n\n<div class=\"n-usage n-usage-do\">Payments</div>\n<div class=\"n-usage n-usage-dont\">Payments in your clinic</div>\n\nAvoid all caps for tab labels:\n\n<div class=\"n-usage n-usage-do\">Dashboard</div>\n<div class=\"n-usage n-usage-dont\">DASHBOARD</div>\n\n---\n\n## Additional considerations\n\n- If the content contained within the tabs UI has significance or is important for the user to see, consider using a different form of presentation that doesn't obscure it.\n- If there is a particular tab panel you wish to show out of order of the tabs UI itself consider using the `selected` option on the related tab component to select the tab but prevent the order of the tabs being affected.\n",
13909
+ "examples": [],
13910
+ "dependencies": [],
13911
+ "tagName": "nord-tab-panel",
13912
+ "customElement": true
13913
+ }
13914
+ ],
13915
+ "exports": [
13916
+ {
13917
+ "kind": "js",
13918
+ "name": "default",
13919
+ "declaration": {
13920
+ "name": "TabPanel",
13921
+ "module": "src/tab-panel/TabPanel.ts"
13922
+ }
13923
+ },
13924
+ {
13925
+ "kind": "custom-element-definition",
13926
+ "name": "nord-tab-panel",
13927
+ "declaration": {
13928
+ "name": "TabPanel",
13929
+ "module": "src/tab-panel/TabPanel.ts"
13930
+ }
13931
+ }
13932
+ ]
13933
+ },
13934
13934
  {
13935
13935
  "kind": "javascript-module",
13936
13936
  "path": "src/table/Table.ts",