@nordhealth/components 2.16.1-alpha.4 → 2.16.1-alpha.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.
Files changed (108) hide show
  1. package/custom-elements.json +1047 -1047
  2. package/lib/{AutocompleteMixin-5163f8db.js → AutocompleteMixin-c8018288.js} +2 -2
  3. package/lib/{AutocompleteMixin-5163f8db.js.map → AutocompleteMixin-c8018288.js.map} +1 -1
  4. package/lib/Avatar.js +1 -1
  5. package/lib/Badge.js +1 -1
  6. package/lib/Banner.js +1 -1
  7. package/lib/Banner.js.map +1 -1
  8. package/lib/Button.js +1 -1
  9. package/lib/ButtonGroup.js +1 -1
  10. package/lib/{Calendar-88644376.js → Calendar-27eae615.js} +2 -2
  11. package/lib/{Calendar-88644376.js.map → Calendar-27eae615.js.map} +1 -1
  12. package/lib/Calendar.js +1 -1
  13. package/lib/Card.js +1 -1
  14. package/lib/Checkbox.js +1 -1
  15. package/lib/CommandMenu.js +1 -1
  16. package/lib/CommandMenu.js.map +1 -1
  17. package/lib/CommandMenuAction.js +1 -1
  18. package/lib/CommandMenuAction.js.map +1 -1
  19. package/lib/{Component-449e40fb.js → Component-d4d6fa77.js} +2 -2
  20. package/lib/Component-d4d6fa77.js.map +1 -0
  21. package/lib/DatePicker.js +1 -1
  22. package/lib/Divider.js +1 -1
  23. package/lib/Divider.js.map +1 -1
  24. package/lib/Drawer.js +1 -1
  25. package/lib/Dropdown.js +1 -1
  26. package/lib/DropdownGroup.js +1 -1
  27. package/lib/DropdownItem.js +1 -1
  28. package/lib/EmptyState.js +1 -1
  29. package/lib/Fieldset.js +1 -1
  30. package/lib/FocusableMixin-fc1e2a13.js +2 -0
  31. package/lib/{FocusableMixin-32631bff.js.map → FocusableMixin-fc1e2a13.js.map} +1 -1
  32. package/lib/{FormAssociatedMixin-dc7ee1d9.js → FormAssociatedMixin-ad4d6c08.js} +2 -2
  33. package/lib/{FormAssociatedMixin-dc7ee1d9.js.map → FormAssociatedMixin-ad4d6c08.js.map} +1 -1
  34. package/lib/{FormField-413f22f5.js → FormField-c733b196.js} +2 -2
  35. package/lib/FormField-c733b196.js.map +1 -0
  36. package/lib/Header.js +1 -1
  37. package/lib/Header.js.map +1 -1
  38. package/lib/Icon.js +1 -1
  39. package/lib/Input.js +1 -1
  40. package/lib/{InputMixin-7fa755e1.js → InputMixin-1564ca2a.js} +2 -2
  41. package/lib/{InputMixin-7fa755e1.js.map → InputMixin-1564ca2a.js.map} +1 -1
  42. package/lib/Layout.js +1 -1
  43. package/lib/{LightDomController-052f446a.js → LightDomController-3b7b1f44.js} +2 -2
  44. package/lib/{LightDomController-052f446a.js.map → LightDomController-3b7b1f44.js.map} +1 -1
  45. package/lib/Modal.js +1 -1
  46. package/lib/NavGroup.js +1 -1
  47. package/lib/NavItem.js +1 -1
  48. package/lib/NavItem.js.map +1 -1
  49. package/lib/NavToggle.js +1 -1
  50. package/lib/NavToggle.js.map +1 -1
  51. package/lib/Navigation.js +1 -1
  52. package/lib/{Popout-c0d2cb72.js → Popout-0baf2085.js} +2 -2
  53. package/lib/{Popout-c0d2cb72.js.map → Popout-0baf2085.js.map} +1 -1
  54. package/lib/Popout.js +1 -1
  55. package/lib/ProgressBar.js +1 -1
  56. package/lib/Qrcode.js +1 -1
  57. package/lib/Radio.js +1 -1
  58. package/lib/Range.js +1 -1
  59. package/lib/Select.js +1 -1
  60. package/lib/{SizeMixin-4d04817d.js → SizeMixin-9da6dc81.js} +2 -2
  61. package/lib/{SizeMixin-4d04817d.js.map → SizeMixin-9da6dc81.js.map} +1 -1
  62. package/lib/Skeleton.js +1 -1
  63. package/lib/Spinner.js +1 -1
  64. package/lib/Stack.js +1 -1
  65. package/lib/{Sticky-c4cf185e.js → Sticky-64b0b58a.js} +2 -2
  66. package/lib/Sticky-64b0b58a.js.map +1 -0
  67. package/lib/Tab.js +1 -1
  68. package/lib/TabGroup.js +1 -1
  69. package/lib/TabPanel.js +1 -1
  70. package/lib/Table.js +1 -1
  71. package/lib/{TextField-ca819c35.js → TextField-6a272cd7.js} +2 -2
  72. package/lib/{TextField-ca819c35.js.map → TextField-6a272cd7.js.map} +1 -1
  73. package/lib/Textarea.js +1 -1
  74. package/lib/Toast.js +1 -1
  75. package/lib/ToastGroup.js +1 -1
  76. package/lib/Toggle.js +1 -1
  77. package/lib/Tooltip.js +1 -1
  78. package/lib/VisuallyHidden.js +1 -1
  79. package/lib/bundle.js +7 -8
  80. package/lib/bundle.js.map +1 -1
  81. package/lib/class-map-1bc3148f.js +7 -0
  82. package/lib/{class-map-21152cee.js.map → class-map-1bc3148f.js.map} +1 -1
  83. package/lib/{collection-7eee4e72.js → collection-a0cd49b2.js} +2 -2
  84. package/lib/{collection-7eee4e72.js.map → collection-a0cd49b2.js.map} +1 -1
  85. package/lib/cond-8e7df9cf.js +2 -0
  86. package/lib/{cond-2da54107.js.map → cond-8e7df9cf.js.map} +1 -1
  87. package/lib/{if-defined-720964c0.js → if-defined-718a58b2.js} +2 -2
  88. package/lib/{if-defined-720964c0.js.map → if-defined-718a58b2.js.map} +1 -1
  89. package/lib/index.js +1 -1
  90. package/lib/positioning-acf73137.js +2 -0
  91. package/lib/positioning-acf73137.js.map +1 -0
  92. package/lib/query-assigned-elements-89f41e17.js +34 -0
  93. package/lib/query-assigned-elements-89f41e17.js.map +1 -0
  94. package/lib/{ref-c44e9f3c.js → ref-4265fcf9.js} +4 -4
  95. package/lib/{ref-c44e9f3c.js.map → ref-4265fcf9.js.map} +1 -1
  96. package/lib/{style-map-2e8fcab6.js → style-map-c63c0180.js} +2 -2
  97. package/lib/{style-map-2e8fcab6.js.map → style-map-c63c0180.js.map} +1 -1
  98. package/package.json +5 -6
  99. package/lib/Component-449e40fb.js.map +0 -1
  100. package/lib/FocusableMixin-32631bff.js +0 -2
  101. package/lib/FormField-413f22f5.js.map +0 -1
  102. package/lib/Sticky-c4cf185e.js.map +0 -1
  103. package/lib/class-map-21152cee.js +0 -7
  104. package/lib/cond-2da54107.js +0 -2
  105. package/lib/positioning-3bbd3548.js +0 -2
  106. package/lib/positioning-3bbd3548.js.map +0 -1
  107. package/lib/query-assigned-elements-cf502539.js +0 -35
  108. package/lib/query-assigned-elements-cf502539.js.map +0 -1
@@ -587,175 +587,6 @@
587
587
  }
588
588
  ]
589
589
  },
590
- {
591
- "kind": "javascript-module",
592
- "path": "src/banner/Banner.ts",
593
- "declarations": [
594
- {
595
- "kind": "class",
596
- "description": "Banner informs users about important changes or conditions in the\ninterface. Use this component if you need to communicate to users\nin a prominent way.",
597
- "name": "Banner",
598
- "cssProperties": [
599
- {
600
- "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
601
- "name": "--n-banner-border-radius",
602
- "default": "var(--n-border-radius)"
603
- },
604
- {
605
- "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
606
- "name": "--n-banner-box-shadow",
607
- "default": "var(--n-box-shadow-card)"
608
- }
609
- ],
610
- "slots": [
611
- {
612
- "description": "default slot",
613
- "name": ""
614
- }
615
- ],
616
- "members": [
617
- {
618
- "kind": "field",
619
- "name": "variant",
620
- "type": {
621
- "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
622
- },
623
- "default": "\"info\"",
624
- "description": "The style variant of the banner.",
625
- "attribute": "variant",
626
- "reflects": true
627
- }
628
- ],
629
- "attributes": [
630
- {
631
- "name": "variant",
632
- "type": {
633
- "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
634
- },
635
- "default": "\"info\"",
636
- "description": "The style variant of the banner.",
637
- "fieldName": "variant"
638
- }
639
- ],
640
- "superclass": {
641
- "name": "LitElement",
642
- "package": "lit"
643
- },
644
- "localization": [],
645
- "status": "ready",
646
- "category": "feedback",
647
- "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 this component if you need to communicate in a prominent way.\n- Place banner at the top of the section it applies to.\n- Use for highlighting errors and success statuses.\n- Put banner close to the context it’s referring to.\n- Move focus to the banner if it’s relevant to the current workflow.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Move focus to banner if it appears on page load.\n- Use for highlighting general content or as a banner.\n- Use to replace an error page.\n\n</div>\n\n---\n\n## Content guidelines\n\nBanner content should be clear, accurate and easy to understand:\n\n<div class=\"n-usage n-usage-do\">We’re experiencing an incident. Please see our status page for more details.</div>\n<div class=\"n-usage n-usage-dont\">There was an error.</div>\n\nWhen writing banner 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\">We’re experiencing an incident.</div>\n<div class=\"n-usage n-usage-dont\">We’re Experiencing An Incident.</div>\n\nAlways end in punctuation:\n\n<div class=\"n-usage n-usage-do\">We’re experiencing an incident.</div>\n<div class=\"n-usage n-usage-dont\">We’re experiencing an incident</div>\n",
648
- "examples": [],
649
- "tagName": "nord-banner",
650
- "customElement": true
651
- }
652
- ],
653
- "exports": [
654
- {
655
- "kind": "js",
656
- "name": "default",
657
- "declaration": {
658
- "name": "Banner",
659
- "module": "src/banner/Banner.ts"
660
- }
661
- },
662
- {
663
- "kind": "custom-element-definition",
664
- "name": "nord-banner",
665
- "declaration": {
666
- "name": "Banner",
667
- "module": "src/banner/Banner.ts"
668
- }
669
- }
670
- ]
671
- },
672
- {
673
- "kind": "javascript-module",
674
- "path": "src/badge/Badge.ts",
675
- "declarations": [
676
- {
677
- "kind": "class",
678
- "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.",
679
- "name": "Badge",
680
- "slots": [
681
- {
682
- "description": "The badge content.",
683
- "name": ""
684
- }
685
- ],
686
- "members": [
687
- {
688
- "kind": "field",
689
- "name": "type",
690
- "type": {
691
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
692
- },
693
- "default": "\"neutral\"",
694
- "description": "The type of badge.\nDetermines the background color of the badge.",
695
- "attribute": "type",
696
- "reflects": true
697
- },
698
- {
699
- "kind": "field",
700
- "name": "progress",
701
- "type": {
702
- "text": "\"cancelled\" | \"complete\" | \"incomplete\" | \"partially-complete\" | undefined"
703
- },
704
- "description": "The progress of the badge. Displays a progress\nindicator next to the label.",
705
- "attribute": "progress"
706
- }
707
- ],
708
- "attributes": [
709
- {
710
- "name": "type",
711
- "type": {
712
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
713
- },
714
- "default": "\"neutral\"",
715
- "description": "The type of badge.\nDetermines the background color of the badge.",
716
- "fieldName": "type"
717
- },
718
- {
719
- "name": "progress",
720
- "type": {
721
- "text": "\"cancelled\" | \"complete\" | \"incomplete\" | \"partially-complete\" | undefined"
722
- },
723
- "description": "The progress of the badge. Displays a progress\nindicator next to the label.",
724
- "fieldName": "progress"
725
- }
726
- ],
727
- "superclass": {
728
- "name": "LitElement",
729
- "package": "lit"
730
- },
731
- "localization": [],
732
- "status": "ready",
733
- "category": "text",
734
- "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",
735
- "examples": [],
736
- "tagName": "nord-badge",
737
- "customElement": true
738
- }
739
- ],
740
- "exports": [
741
- {
742
- "kind": "js",
743
- "name": "default",
744
- "declaration": {
745
- "name": "Badge",
746
- "module": "src/badge/Badge.ts"
747
- }
748
- },
749
- {
750
- "kind": "custom-element-definition",
751
- "name": "nord-badge",
752
- "declaration": {
753
- "name": "Badge",
754
- "module": "src/badge/Badge.ts"
755
- }
756
- }
757
- ]
758
- },
759
590
  {
760
591
  "kind": "javascript-module",
761
592
  "path": "src/button/Button.ts",
@@ -1298,92 +1129,57 @@
1298
1129
  },
1299
1130
  {
1300
1131
  "kind": "javascript-module",
1301
- "path": "src/button-group/ButtonGroup.ts",
1132
+ "path": "src/badge/Badge.ts",
1302
1133
  "declarations": [
1303
1134
  {
1304
1135
  "kind": "class",
1305
- "description": "Button groups are designed to bring together button controls that are of a similar nature. For example text formatting controls.",
1306
- "name": "ButtonGroup",
1307
- "cssProperties": [
1308
- {
1309
- "description": "Controls the rounded corners of the button, using [border radius tokens](/tokens/#border-radius).",
1310
- "name": "--n-button-group-border-radius",
1311
- "default": "var(--n-border-radius-s)"
1312
- },
1313
- {
1314
- "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
1315
- "name": "--n-button-group-box-shadow",
1316
- "default": "var(--n-box-shadow)"
1317
- }
1318
- ],
1136
+ "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.",
1137
+ "name": "Badge",
1319
1138
  "slots": [
1320
1139
  {
1321
- "description": "The button group content",
1140
+ "description": "The badge content.",
1322
1141
  "name": ""
1323
1142
  }
1324
1143
  ],
1325
1144
  "members": [
1326
1145
  {
1327
1146
  "kind": "field",
1328
- "name": "direction",
1329
- "type": {
1330
- "text": "\"vertical\" | \"horizontal\""
1331
- },
1332
- "default": "\"horizontal\"",
1333
- "description": "The direction of the button group.",
1334
- "attribute": "direction",
1335
- "reflects": true
1336
- },
1337
- {
1338
- "kind": "field",
1339
- "name": "role",
1147
+ "name": "type",
1340
1148
  "type": {
1341
- "text": "string"
1149
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
1342
1150
  },
1343
- "default": "\"group\"",
1344
- "description": "The appropriate role for the containing element.",
1345
- "attribute": "role",
1151
+ "default": "\"neutral\"",
1152
+ "description": "The type of badge.\nDetermines the background color of the badge.",
1153
+ "attribute": "type",
1346
1154
  "reflects": true
1347
1155
  },
1348
1156
  {
1349
1157
  "kind": "field",
1350
- "name": "_warningLogged",
1158
+ "name": "progress",
1351
1159
  "type": {
1352
- "text": "boolean"
1160
+ "text": "\"cancelled\" | \"complete\" | \"incomplete\" | \"partially-complete\" | undefined"
1353
1161
  },
1354
- "privacy": "private",
1355
- "static": true,
1356
- "default": "false",
1357
- "inheritedFrom": {
1358
- "name": "DraftComponentMixin",
1359
- "module": "src/common/mixins/DraftComponentMixin.ts"
1360
- }
1162
+ "description": "The progress of the badge. Displays a progress\nindicator next to the label.",
1163
+ "attribute": "progress"
1361
1164
  }
1362
1165
  ],
1363
1166
  "attributes": [
1364
1167
  {
1365
- "name": "direction",
1168
+ "name": "type",
1366
1169
  "type": {
1367
- "text": "\"vertical\" | \"horizontal\""
1170
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
1368
1171
  },
1369
- "default": "\"horizontal\"",
1370
- "description": "The direction of the button group.",
1371
- "fieldName": "direction"
1172
+ "default": "\"neutral\"",
1173
+ "description": "The type of badge.\nDetermines the background color of the badge.",
1174
+ "fieldName": "type"
1372
1175
  },
1373
1176
  {
1374
- "name": "role",
1177
+ "name": "progress",
1375
1178
  "type": {
1376
- "text": "string"
1179
+ "text": "\"cancelled\" | \"complete\" | \"incomplete\" | \"partially-complete\" | undefined"
1377
1180
  },
1378
- "default": "\"group\"",
1379
- "description": "The appropriate role for the containing element.",
1380
- "fieldName": "role"
1381
- }
1382
- ],
1383
- "mixins": [
1384
- {
1385
- "name": "DraftComponentMixin",
1386
- "module": "/src/common/mixins/DraftComponentMixin.js"
1181
+ "description": "The progress of the badge. Displays a progress\nindicator next to the label.",
1182
+ "fieldName": "progress"
1387
1183
  }
1388
1184
  ],
1389
1185
  "superclass": {
@@ -1391,11 +1187,215 @@
1391
1187
  "package": "lit"
1392
1188
  },
1393
1189
  "localization": [],
1394
- "status": "draft",
1395
- "category": "structure",
1396
- "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 group together buttons, or dropdowns, of a similar nature or purpose.\n- Use the appropriate `role` attribute on the button group to provide additional semantics.\n- Use an `aria-labelledby` attribute referencing another element to best explain the contents of the button group.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t add components other than buttons, dropdowns and in some instances visually hidden components to the button group.\n- Don’t skip the addition of an appropriate label if the added `role` attribute value calls for it.\n- Don’t use for building grid based layouts.\n\n</div>\n\n---\n\n## Content guidelines\n\nButton group labels should be accurate and predictable.\n",
1190
+ "status": "ready",
1191
+ "category": "text",
1192
+ "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",
1397
1193
  "examples": [],
1398
- "tagName": "nord-button-group",
1194
+ "tagName": "nord-badge",
1195
+ "customElement": true
1196
+ }
1197
+ ],
1198
+ "exports": [
1199
+ {
1200
+ "kind": "js",
1201
+ "name": "default",
1202
+ "declaration": {
1203
+ "name": "Badge",
1204
+ "module": "src/badge/Badge.ts"
1205
+ }
1206
+ },
1207
+ {
1208
+ "kind": "custom-element-definition",
1209
+ "name": "nord-badge",
1210
+ "declaration": {
1211
+ "name": "Badge",
1212
+ "module": "src/badge/Badge.ts"
1213
+ }
1214
+ }
1215
+ ]
1216
+ },
1217
+ {
1218
+ "kind": "javascript-module",
1219
+ "path": "src/banner/Banner.ts",
1220
+ "declarations": [
1221
+ {
1222
+ "kind": "class",
1223
+ "description": "Banner informs users about important changes or conditions in the\ninterface. Use this component if you need to communicate to users\nin a prominent way.",
1224
+ "name": "Banner",
1225
+ "cssProperties": [
1226
+ {
1227
+ "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
1228
+ "name": "--n-banner-border-radius",
1229
+ "default": "var(--n-border-radius)"
1230
+ },
1231
+ {
1232
+ "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
1233
+ "name": "--n-banner-box-shadow",
1234
+ "default": "var(--n-box-shadow-card)"
1235
+ }
1236
+ ],
1237
+ "slots": [
1238
+ {
1239
+ "description": "default slot",
1240
+ "name": ""
1241
+ }
1242
+ ],
1243
+ "members": [
1244
+ {
1245
+ "kind": "field",
1246
+ "name": "variant",
1247
+ "type": {
1248
+ "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
1249
+ },
1250
+ "default": "\"info\"",
1251
+ "description": "The style variant of the banner.",
1252
+ "attribute": "variant",
1253
+ "reflects": true
1254
+ }
1255
+ ],
1256
+ "attributes": [
1257
+ {
1258
+ "name": "variant",
1259
+ "type": {
1260
+ "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
1261
+ },
1262
+ "default": "\"info\"",
1263
+ "description": "The style variant of the banner.",
1264
+ "fieldName": "variant"
1265
+ }
1266
+ ],
1267
+ "superclass": {
1268
+ "name": "LitElement",
1269
+ "package": "lit"
1270
+ },
1271
+ "localization": [],
1272
+ "status": "ready",
1273
+ "category": "feedback",
1274
+ "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 this component if you need to communicate in a prominent way.\n- Place banner at the top of the section it applies to.\n- Use for highlighting errors and success statuses.\n- Put banner close to the context it’s referring to.\n- Move focus to the banner if it’s relevant to the current workflow.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Move focus to banner if it appears on page load.\n- Use for highlighting general content or as a banner.\n- Use to replace an error page.\n\n</div>\n\n---\n\n## Content guidelines\n\nBanner content should be clear, accurate and easy to understand:\n\n<div class=\"n-usage n-usage-do\">We’re experiencing an incident. Please see our status page for more details.</div>\n<div class=\"n-usage n-usage-dont\">There was an error.</div>\n\nWhen writing banner 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\">We’re experiencing an incident.</div>\n<div class=\"n-usage n-usage-dont\">We’re Experiencing An Incident.</div>\n\nAlways end in punctuation:\n\n<div class=\"n-usage n-usage-do\">We’re experiencing an incident.</div>\n<div class=\"n-usage n-usage-dont\">We’re experiencing an incident</div>\n",
1275
+ "examples": [],
1276
+ "tagName": "nord-banner",
1277
+ "customElement": true
1278
+ }
1279
+ ],
1280
+ "exports": [
1281
+ {
1282
+ "kind": "js",
1283
+ "name": "default",
1284
+ "declaration": {
1285
+ "name": "Banner",
1286
+ "module": "src/banner/Banner.ts"
1287
+ }
1288
+ },
1289
+ {
1290
+ "kind": "custom-element-definition",
1291
+ "name": "nord-banner",
1292
+ "declaration": {
1293
+ "name": "Banner",
1294
+ "module": "src/banner/Banner.ts"
1295
+ }
1296
+ }
1297
+ ]
1298
+ },
1299
+ {
1300
+ "kind": "javascript-module",
1301
+ "path": "src/button-group/ButtonGroup.ts",
1302
+ "declarations": [
1303
+ {
1304
+ "kind": "class",
1305
+ "description": "Button groups are designed to bring together button controls that are of a similar nature. For example text formatting controls.",
1306
+ "name": "ButtonGroup",
1307
+ "cssProperties": [
1308
+ {
1309
+ "description": "Controls the rounded corners of the button, using [border radius tokens](/tokens/#border-radius).",
1310
+ "name": "--n-button-group-border-radius",
1311
+ "default": "var(--n-border-radius-s)"
1312
+ },
1313
+ {
1314
+ "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
1315
+ "name": "--n-button-group-box-shadow",
1316
+ "default": "var(--n-box-shadow)"
1317
+ }
1318
+ ],
1319
+ "slots": [
1320
+ {
1321
+ "description": "The button group content",
1322
+ "name": ""
1323
+ }
1324
+ ],
1325
+ "members": [
1326
+ {
1327
+ "kind": "field",
1328
+ "name": "direction",
1329
+ "type": {
1330
+ "text": "\"vertical\" | \"horizontal\""
1331
+ },
1332
+ "default": "\"horizontal\"",
1333
+ "description": "The direction of the button group.",
1334
+ "attribute": "direction",
1335
+ "reflects": true
1336
+ },
1337
+ {
1338
+ "kind": "field",
1339
+ "name": "role",
1340
+ "type": {
1341
+ "text": "string"
1342
+ },
1343
+ "default": "\"group\"",
1344
+ "description": "The appropriate role for the containing element.",
1345
+ "attribute": "role",
1346
+ "reflects": true
1347
+ },
1348
+ {
1349
+ "kind": "field",
1350
+ "name": "_warningLogged",
1351
+ "type": {
1352
+ "text": "boolean"
1353
+ },
1354
+ "privacy": "private",
1355
+ "static": true,
1356
+ "default": "false",
1357
+ "inheritedFrom": {
1358
+ "name": "DraftComponentMixin",
1359
+ "module": "src/common/mixins/DraftComponentMixin.ts"
1360
+ }
1361
+ }
1362
+ ],
1363
+ "attributes": [
1364
+ {
1365
+ "name": "direction",
1366
+ "type": {
1367
+ "text": "\"vertical\" | \"horizontal\""
1368
+ },
1369
+ "default": "\"horizontal\"",
1370
+ "description": "The direction of the button group.",
1371
+ "fieldName": "direction"
1372
+ },
1373
+ {
1374
+ "name": "role",
1375
+ "type": {
1376
+ "text": "string"
1377
+ },
1378
+ "default": "\"group\"",
1379
+ "description": "The appropriate role for the containing element.",
1380
+ "fieldName": "role"
1381
+ }
1382
+ ],
1383
+ "mixins": [
1384
+ {
1385
+ "name": "DraftComponentMixin",
1386
+ "module": "/src/common/mixins/DraftComponentMixin.js"
1387
+ }
1388
+ ],
1389
+ "superclass": {
1390
+ "name": "LitElement",
1391
+ "package": "lit"
1392
+ },
1393
+ "localization": [],
1394
+ "status": "draft",
1395
+ "category": "structure",
1396
+ "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 group together buttons, or dropdowns, of a similar nature or purpose.\n- Use the appropriate `role` attribute on the button group to provide additional semantics.\n- Use an `aria-labelledby` attribute referencing another element to best explain the contents of the button group.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t add components other than buttons, dropdowns and in some instances visually hidden components to the button group.\n- Don’t skip the addition of an appropriate label if the added `role` attribute value calls for it.\n- Don’t use for building grid based layouts.\n\n</div>\n\n---\n\n## Content guidelines\n\nButton group labels should be accurate and predictable.\n",
1397
+ "examples": [],
1398
+ "tagName": "nord-button-group",
1399
1399
  "customElement": true
1400
1400
  }
1401
1401
  ],
@@ -1918,167 +1918,45 @@
1918
1918
  },
1919
1919
  {
1920
1920
  "kind": "javascript-module",
1921
- "path": "src/card/Card.ts",
1921
+ "path": "src/checkbox/Checkbox.ts",
1922
1922
  "declarations": [
1923
1923
  {
1924
1924
  "kind": "class",
1925
- "description": "Cards are shadowed surfaces that display content and actions on a\nsingle topic. They should be easy to scan for relevant and\nactionable information.",
1926
- "name": "Card",
1927
- "cssProperties": [
1928
- {
1929
- "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
1930
- "name": "--n-card-border-radius",
1931
- "default": "var(--n-border-radius)"
1932
- },
1925
+ "description": "Checkboxes allow user to choose one or more options from a limited set of options.\nIf you have more than 10 options, please use Select component instead.",
1926
+ "name": "Checkbox",
1927
+ "slots": [
1933
1928
  {
1934
- "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
1935
- "name": "--n-card-box-shadow",
1936
- "default": "var(--n-box-shadow-popout)"
1929
+ "description": "Use when a label requires more than plain text.",
1930
+ "name": "label"
1937
1931
  },
1938
1932
  {
1939
- "description": "Controls the padding on all sides of the card.",
1940
- "name": "--n-card-padding",
1941
- "default": "var(--n-space-m)"
1933
+ "description": "Optional slot that holds hint text for the input.",
1934
+ "name": "hint"
1942
1935
  },
1943
1936
  {
1944
- "description": "Controls the padding of items slotted within the card. This does not affect the block padding of items slotted into the header.",
1945
- "name": "--n-card-slot-padding",
1946
- "default": "var(--n-space-m)"
1937
+ "description": "Optional slot that holds error text for the input.",
1938
+ "name": "error"
1947
1939
  }
1948
1940
  ],
1949
- "slots": [
1941
+ "members": [
1950
1942
  {
1951
- "description": "The card content.",
1952
- "name": ""
1943
+ "kind": "field",
1944
+ "name": "formValue",
1945
+ "privacy": "protected",
1946
+ "inheritedFrom": {
1947
+ "name": "FormAssociatedMixin",
1948
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1949
+ }
1953
1950
  },
1954
1951
  {
1955
- "description": "Optional slot that holds a header for the card.",
1956
- "name": "header"
1957
- },
1958
- {
1959
- "description": "Optional slot that positions content at the end of the header. Useful for actions or additional info.",
1960
- "name": "header-end"
1961
- },
1962
- {
1963
- "description": "Optional slot that holds footer content for the card.",
1964
- "name": "footer"
1965
- }
1966
- ],
1967
- "members": [
1968
- {
1969
- "kind": "field",
1970
- "name": "headerSlot",
1971
- "privacy": "private",
1972
- "default": "new SlotController(this, \"header\")"
1973
- },
1974
- {
1975
- "kind": "field",
1976
- "name": "headerEndSlot",
1977
- "privacy": "private",
1978
- "default": "new SlotController(this, \"header-end\")"
1979
- },
1980
- {
1981
- "kind": "field",
1982
- "name": "footerSlot",
1983
- "privacy": "private",
1984
- "default": "new SlotController(this, \"footer\")"
1985
- },
1986
- {
1987
- "kind": "field",
1988
- "name": "padding",
1989
- "type": {
1990
- "text": "\"m\" | \"l\" | \"none\""
1991
- },
1992
- "default": "\"m\"",
1993
- "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
1994
- "attribute": "padding",
1995
- "reflects": true
1996
- }
1997
- ],
1998
- "attributes": [
1999
- {
2000
- "name": "padding",
2001
- "type": {
2002
- "text": "\"m\" | \"l\" | \"none\""
2003
- },
2004
- "default": "\"m\"",
2005
- "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
2006
- "fieldName": "padding"
2007
- }
2008
- ],
2009
- "superclass": {
2010
- "name": "LitElement",
2011
- "package": "lit"
2012
- },
2013
- "localization": [],
2014
- "status": "ready",
2015
- "category": "structure",
2016
- "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 display content and actions on a single topic inside a container.\n- Use to visually separate specific parts of content in an application view.\n- Use to wrap a form into a container, for example a login form.\n- Include a header when placing a [Table](/components/table) component inside the card.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t place cards within cards. Consider using the [divider](/components/divider/) component to break up sections instead.\n- Don’t use when you need to capture user’s attention in a prominent way.\n- Don’t use to inform user about important changes or conditions in the interface.\n- Don’t use multiple primary buttons inside a card. A card should only contain a single primary action.\n\n</div>\n",
2017
- "examples": [],
2018
- "tagName": "nord-card",
2019
- "customElement": true
2020
- }
2021
- ],
2022
- "exports": [
2023
- {
2024
- "kind": "js",
2025
- "name": "default",
2026
- "declaration": {
2027
- "name": "Card",
2028
- "module": "src/card/Card.ts"
2029
- }
2030
- },
2031
- {
2032
- "kind": "custom-element-definition",
2033
- "name": "nord-card",
2034
- "declaration": {
2035
- "name": "Card",
2036
- "module": "src/card/Card.ts"
2037
- }
2038
- }
2039
- ]
2040
- },
2041
- {
2042
- "kind": "javascript-module",
2043
- "path": "src/checkbox/Checkbox.ts",
2044
- "declarations": [
2045
- {
2046
- "kind": "class",
2047
- "description": "Checkboxes allow user to choose one or more options from a limited set of options.\nIf you have more than 10 options, please use Select component instead.",
2048
- "name": "Checkbox",
2049
- "slots": [
2050
- {
2051
- "description": "Use when a label requires more than plain text.",
2052
- "name": "label"
2053
- },
2054
- {
2055
- "description": "Optional slot that holds hint text for the input.",
2056
- "name": "hint"
2057
- },
2058
- {
2059
- "description": "Optional slot that holds error text for the input.",
2060
- "name": "error"
2061
- }
2062
- ],
2063
- "members": [
2064
- {
2065
- "kind": "field",
2066
- "name": "formValue",
2067
- "privacy": "protected",
2068
- "inheritedFrom": {
2069
- "name": "FormAssociatedMixin",
2070
- "module": "src/common/mixins/FormAssociatedMixin.ts"
2071
- }
2072
- },
2073
- {
2074
- "kind": "field",
2075
- "name": "indeterminate",
2076
- "type": {
2077
- "text": "boolean"
2078
- },
2079
- "default": "false",
2080
- "description": "Controls whether the checkbox is in an indeterminate state.",
2081
- "attribute": "indeterminate"
1952
+ "kind": "field",
1953
+ "name": "indeterminate",
1954
+ "type": {
1955
+ "text": "boolean"
1956
+ },
1957
+ "default": "false",
1958
+ "description": "Controls whether the checkbox is in an indeterminate state.",
1959
+ "attribute": "indeterminate"
2082
1960
  },
2083
1961
  {
2084
1962
  "kind": "field",
@@ -2712,6 +2590,128 @@
2712
2590
  }
2713
2591
  ]
2714
2592
  },
2593
+ {
2594
+ "kind": "javascript-module",
2595
+ "path": "src/card/Card.ts",
2596
+ "declarations": [
2597
+ {
2598
+ "kind": "class",
2599
+ "description": "Cards are shadowed surfaces that display content and actions on a\nsingle topic. They should be easy to scan for relevant and\nactionable information.",
2600
+ "name": "Card",
2601
+ "cssProperties": [
2602
+ {
2603
+ "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
2604
+ "name": "--n-card-border-radius",
2605
+ "default": "var(--n-border-radius)"
2606
+ },
2607
+ {
2608
+ "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
2609
+ "name": "--n-card-box-shadow",
2610
+ "default": "var(--n-box-shadow-popout)"
2611
+ },
2612
+ {
2613
+ "description": "Controls the padding on all sides of the card.",
2614
+ "name": "--n-card-padding",
2615
+ "default": "var(--n-space-m)"
2616
+ },
2617
+ {
2618
+ "description": "Controls the padding of items slotted within the card. This does not affect the block padding of items slotted into the header.",
2619
+ "name": "--n-card-slot-padding",
2620
+ "default": "var(--n-space-m)"
2621
+ }
2622
+ ],
2623
+ "slots": [
2624
+ {
2625
+ "description": "The card content.",
2626
+ "name": ""
2627
+ },
2628
+ {
2629
+ "description": "Optional slot that holds a header for the card.",
2630
+ "name": "header"
2631
+ },
2632
+ {
2633
+ "description": "Optional slot that positions content at the end of the header. Useful for actions or additional info.",
2634
+ "name": "header-end"
2635
+ },
2636
+ {
2637
+ "description": "Optional slot that holds footer content for the card.",
2638
+ "name": "footer"
2639
+ }
2640
+ ],
2641
+ "members": [
2642
+ {
2643
+ "kind": "field",
2644
+ "name": "headerSlot",
2645
+ "privacy": "private",
2646
+ "default": "new SlotController(this, \"header\")"
2647
+ },
2648
+ {
2649
+ "kind": "field",
2650
+ "name": "headerEndSlot",
2651
+ "privacy": "private",
2652
+ "default": "new SlotController(this, \"header-end\")"
2653
+ },
2654
+ {
2655
+ "kind": "field",
2656
+ "name": "footerSlot",
2657
+ "privacy": "private",
2658
+ "default": "new SlotController(this, \"footer\")"
2659
+ },
2660
+ {
2661
+ "kind": "field",
2662
+ "name": "padding",
2663
+ "type": {
2664
+ "text": "\"m\" | \"l\" | \"none\""
2665
+ },
2666
+ "default": "\"m\"",
2667
+ "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
2668
+ "attribute": "padding",
2669
+ "reflects": true
2670
+ }
2671
+ ],
2672
+ "attributes": [
2673
+ {
2674
+ "name": "padding",
2675
+ "type": {
2676
+ "text": "\"m\" | \"l\" | \"none\""
2677
+ },
2678
+ "default": "\"m\"",
2679
+ "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
2680
+ "fieldName": "padding"
2681
+ }
2682
+ ],
2683
+ "superclass": {
2684
+ "name": "LitElement",
2685
+ "package": "lit"
2686
+ },
2687
+ "localization": [],
2688
+ "status": "ready",
2689
+ "category": "structure",
2690
+ "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 display content and actions on a single topic inside a container.\n- Use to visually separate specific parts of content in an application view.\n- Use to wrap a form into a container, for example a login form.\n- Include a header when placing a [Table](/components/table) component inside the card.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t place cards within cards. Consider using the [divider](/components/divider/) component to break up sections instead.\n- Don’t use when you need to capture user’s attention in a prominent way.\n- Don’t use to inform user about important changes or conditions in the interface.\n- Don’t use multiple primary buttons inside a card. A card should only contain a single primary action.\n\n</div>\n",
2691
+ "examples": [],
2692
+ "tagName": "nord-card",
2693
+ "customElement": true
2694
+ }
2695
+ ],
2696
+ "exports": [
2697
+ {
2698
+ "kind": "js",
2699
+ "name": "default",
2700
+ "declaration": {
2701
+ "name": "Card",
2702
+ "module": "src/card/Card.ts"
2703
+ }
2704
+ },
2705
+ {
2706
+ "kind": "custom-element-definition",
2707
+ "name": "nord-card",
2708
+ "declaration": {
2709
+ "name": "Card",
2710
+ "module": "src/card/Card.ts"
2711
+ }
2712
+ }
2713
+ ]
2714
+ },
2715
2715
  {
2716
2716
  "kind": "javascript-module",
2717
2717
  "path": "src/command-menu/CommandMenu.ts",
@@ -6586,462 +6586,155 @@
6586
6586
  },
6587
6587
  {
6588
6588
  "kind": "javascript-module",
6589
- "path": "src/icon/Icon.ts",
6589
+ "path": "src/input/Input.ts",
6590
6590
  "declarations": [
6591
6591
  {
6592
6592
  "kind": "class",
6593
- "description": "Icons are used to provide additional meaning or in places where text label doesn’t fit.\nIcon component allows you to display an icon from the Nordicons library.",
6594
- "name": "Icon",
6595
- "slots": [
6593
+ "description": "Inputs are used to allow users to provide text input when the expected input is short.\nAs well as plain text, Input supports various types of text, including passwords and numbers.",
6594
+ "name": "Input",
6595
+ "cssProperties": [
6596
6596
  {
6597
- "description": "The default slot used for placing a custom SVG icon.",
6598
- "name": ""
6599
- }
6600
- ],
6601
- "members": [
6597
+ "description": "Controls the inline size, or width, of the input.",
6598
+ "name": "--n-input-inline-size",
6599
+ "default": "240px"
6600
+ },
6602
6601
  {
6603
- "kind": "field",
6604
- "name": "manager",
6605
- "privacy": "private",
6606
- "static": true,
6607
- "default": "new IconManager()"
6602
+ "description": "Controls the background of the input, using our [color tokens](/tokens/#color).",
6603
+ "name": "--n-input-background",
6604
+ "default": "var(--n-color-active)"
6608
6605
  },
6609
6606
  {
6610
- "kind": "method",
6611
- "name": "registerResolver",
6612
- "static": true,
6613
- "parameters": [
6614
- {
6615
- "name": "resolver",
6616
- "type": {
6617
- "text": "IconResolver"
6618
- },
6619
- "description": "The resolver function to register."
6620
- }
6621
- ],
6622
- "description": "Register a custom icon resolver, which accepts the icon name as an parameter, and returns an SVG string.\nCan return a string synchronously, or a promise of a string.\nBy default, will load icons from the Nord CDN."
6607
+ "description": "Controls the text color of the input, using our [color tokens](/tokens/#color).",
6608
+ "name": "--n-input-color",
6609
+ "default": "var(--n-color-text)"
6623
6610
  },
6624
6611
  {
6625
- "kind": "method",
6626
- "name": "registerIcon",
6627
- "static": true,
6628
- "return": {
6629
- "type": {
6630
- "text": "void"
6631
- }
6632
- },
6633
- "parameters": [
6634
- {
6635
- "name": "icon",
6636
- "type": {
6637
- "text": "{ title: string; default: string }"
6638
- },
6639
- "description": "An object representing the icon to be registered, where \"title\" is the icon's name, and \"default\" is the SVG string.\nThis is intended to be used in cases where you import an icon's entire ES module and register it directly."
6640
- }
6641
- ],
6642
- "description": "Register an individual icon so it can be rendered synchronously, to avoid loading over the network."
6612
+ "description": "Controls the border color of the input, using our [color tokens](/tokens/#color).",
6613
+ "name": "--n-input-border-color",
6614
+ "default": "var(--n-color-border-strong)"
6643
6615
  },
6644
6616
  {
6645
- "kind": "method",
6646
- "name": "registerIcon",
6647
- "static": true,
6648
- "return": {
6649
- "type": {
6650
- "text": "void"
6651
- }
6652
- },
6653
- "parameters": [
6654
- {
6655
- "name": "name",
6656
- "type": {
6657
- "text": "string"
6658
- },
6659
- "description": "The name of the icon to be registered."
6660
- },
6661
- {
6662
- "name": "icon",
6663
- "type": {
6664
- "text": "string"
6665
- },
6666
- "description": "The SVG string for the icon."
6667
- }
6668
- ],
6669
- "description": "Register an individual icon so it can be rendered synchronously, to avoid loading over the network."
6617
+ "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
6618
+ "name": "--n-input-border-radius",
6619
+ "default": "var(--n-border-radius-s)"
6620
+ }
6621
+ ],
6622
+ "slots": [
6623
+ {
6624
+ "description": "Use when a label requires more than plain text.",
6625
+ "name": "label"
6670
6626
  },
6671
6627
  {
6672
- "kind": "method",
6673
- "name": "registerIcon",
6674
- "static": true,
6675
- "parameters": [
6676
- {
6677
- "name": "iconOrName",
6678
- "type": {
6679
- "text": "string | { title: string; default: string }"
6680
- },
6681
- "description": "The name of the icon to be registered or an object representing the icon to be registered, where \"title\" is the icon's name, and \"default\" is the SVG string."
6682
- },
6683
- {
6684
- "name": "icon",
6685
- "optional": true,
6686
- "type": {
6687
- "text": "string"
6688
- },
6689
- "description": "The SVG string for the icon."
6690
- }
6691
- ],
6692
- "description": "Register an individual icon so it can be rendered synchronously, to avoid loading over the network."
6628
+ "description": "Optional slot that holds hint text for the input.",
6629
+ "name": "hint"
6630
+ },
6631
+ {
6632
+ "description": "Optional slot that holds error text for the input.",
6633
+ "name": "error"
6634
+ },
6635
+ {
6636
+ "description": "Optional slot used to place an icon or prefix at the start of the input.",
6637
+ "name": "start"
6693
6638
  },
6639
+ {
6640
+ "description": "Optional slot used to place an icon or suffix at the end of the input.",
6641
+ "name": "end"
6642
+ }
6643
+ ],
6644
+ "members": [
6694
6645
  {
6695
6646
  "kind": "field",
6696
- "name": "name",
6697
- "type": {
6698
- "text": "string"
6699
- },
6700
- "default": "\"\"",
6701
- "description": "The name of the icon to display, as defined by [nordicons](/nordicons/).",
6702
- "attribute": "name",
6703
- "reflects": true
6647
+ "name": "startSlot",
6648
+ "privacy": "private",
6649
+ "default": "new SlotController(this, \"start\")"
6704
6650
  },
6705
6651
  {
6706
6652
  "kind": "field",
6707
- "name": "size",
6708
- "type": {
6709
- "text": "\"xxs\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\" | undefined"
6710
- },
6711
- "description": "The size of the icon.",
6712
- "attribute": "size",
6713
- "reflects": true
6653
+ "name": "endSlot",
6654
+ "privacy": "private",
6655
+ "default": "new SlotController(this, \"end\")"
6714
6656
  },
6715
6657
  {
6716
6658
  "kind": "field",
6717
- "name": "color",
6659
+ "name": "direction",
6660
+ "privacy": "private",
6661
+ "default": "new DirectionController(this)"
6662
+ },
6663
+ {
6664
+ "kind": "field",
6665
+ "name": "type",
6718
6666
  "type": {
6719
- "text": "string | undefined"
6667
+ "text": "\"text\" | \"email\" | \"password\" | \"tel\" | \"url\" | \"search\" | \"number\""
6720
6668
  },
6721
- "description": "The color of the icon.\nCan accept any valid CSS color value, including custom properties.",
6722
- "attribute": "color",
6669
+ "default": "\"text\"",
6670
+ "description": "The type of the input.",
6671
+ "attribute": "type",
6723
6672
  "reflects": true
6724
6673
  },
6725
6674
  {
6726
6675
  "kind": "field",
6727
- "name": "label",
6676
+ "name": "expand",
6728
6677
  "type": {
6729
- "text": "string | undefined"
6678
+ "text": "boolean"
6730
6679
  },
6731
- "description": "An accessible label for the icon.\nIf no label is supplied, the icon is hidden from assistive technology.",
6732
- "attribute": "label",
6680
+ "default": "false",
6681
+ "description": "Controls whether the input expands to fill the width of its container.",
6682
+ "attribute": "expand",
6733
6683
  "reflects": true
6734
6684
  },
6735
6685
  {
6736
6686
  "kind": "field",
6737
- "name": "svg",
6687
+ "name": "disallowPattern",
6738
6688
  "type": {
6739
- "text": "string"
6689
+ "text": "string | undefined"
6740
6690
  },
6741
- "privacy": "private",
6742
- "default": "\"\""
6691
+ "default": "undefined",
6692
+ "description": "Optionally disallow certain characters from being used inside the input, using a regex pattern.",
6693
+ "attribute": "disallow-pattern",
6694
+ "reflects": true
6743
6695
  },
6744
6696
  {
6745
6697
  "kind": "method",
6746
- "name": "handleNameChange",
6747
- "privacy": "protected"
6748
- }
6749
- ],
6750
- "attributes": [
6698
+ "name": "handleKeydown",
6699
+ "privacy": "private",
6700
+ "parameters": [
6701
+ {
6702
+ "name": "e",
6703
+ "type": {
6704
+ "text": "KeyboardEvent"
6705
+ }
6706
+ }
6707
+ ]
6708
+ },
6751
6709
  {
6752
- "name": "name",
6753
- "type": {
6754
- "text": "string"
6755
- },
6756
- "default": "\"\"",
6757
- "description": "The name of the icon to display, as defined by [nordicons](/nordicons/).",
6758
- "fieldName": "name"
6710
+ "kind": "field",
6711
+ "name": "handleInputChange",
6712
+ "privacy": "private"
6759
6713
  },
6760
6714
  {
6715
+ "kind": "field",
6761
6716
  "name": "size",
6762
6717
  "type": {
6763
- "text": "\"xxs\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\" | undefined"
6718
+ "text": "\"s\" | \"m\" | \"l\""
6764
6719
  },
6765
- "description": "The size of the icon.",
6766
- "fieldName": "size"
6720
+ "default": "\"m\"",
6721
+ "description": "The size of the component.",
6722
+ "attribute": "size",
6723
+ "reflects": true,
6724
+ "inheritedFrom": {
6725
+ "name": "SizeMixin",
6726
+ "module": "src/common/mixins/SizeMixin.ts"
6727
+ }
6767
6728
  },
6768
6729
  {
6769
- "name": "color",
6770
- "type": {
6771
- "text": "string | undefined"
6772
- },
6773
- "description": "The color of the icon.\nCan accept any valid CSS color value, including custom properties.",
6774
- "fieldName": "color"
6775
- },
6776
- {
6777
- "name": "label",
6778
- "type": {
6779
- "text": "string | undefined"
6780
- },
6781
- "description": "An accessible label for the icon.\nIf no label is supplied, the icon is hidden from assistive technology.",
6782
- "fieldName": "label"
6783
- }
6784
- ],
6785
- "superclass": {
6786
- "name": "LitElement",
6787
- "package": "lit"
6788
- },
6789
- "localization": [],
6790
- "status": "ready",
6791
- "category": "image",
6792
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<nord-button href=\"/nordicons/\" variant=\"primary\">View Nordicons</nord-button>\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use to provide additional meaning in addition to a text label.\n- Use to help users who have difficulties with reading and attention.\n- Use in places where text label doesn’t fit (remember to add an accessible label for the icon).\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for decorative purposes alone.\n- Don’t use when a button’s action is already clear based on the text label.\n- Don’t use the same icon for differing purposes, as users will come to associate icons with specific types of actions.\n\n</div>\n\n---\n\n## Additional considerations\n\n- Icon components are hidden from assistive technologies by default.\n- Use `label` property to give an accessible label for the icon and to make it visible to assistive technologies.\n",
6793
- "examples": [],
6794
- "tagName": "nord-icon",
6795
- "customElement": true
6796
- }
6797
- ],
6798
- "exports": [
6799
- {
6800
- "kind": "js",
6801
- "name": "default",
6802
- "declaration": {
6803
- "name": "Icon",
6804
- "module": "src/icon/Icon.ts"
6805
- }
6806
- },
6807
- {
6808
- "kind": "custom-element-definition",
6809
- "name": "nord-icon",
6810
- "declaration": {
6811
- "name": "Icon",
6812
- "module": "src/icon/Icon.ts"
6813
- }
6814
- }
6815
- ]
6816
- },
6817
- {
6818
- "kind": "javascript-module",
6819
- "path": "src/icon/IconManager.ts",
6820
- "declarations": [
6821
- {
6822
- "kind": "class",
6823
- "description": "",
6824
- "name": "IconManager",
6825
- "members": [
6826
- {
6827
- "kind": "field",
6828
- "name": "cache",
6829
- "privacy": "private",
6830
- "default": "new Map<string, string | Promise<string>>()"
6831
- },
6832
- {
6833
- "kind": "field",
6834
- "name": "resolver",
6835
- "type": {
6836
- "text": "IconResolver"
6837
- }
6838
- },
6839
- {
6840
- "kind": "method",
6841
- "name": "resolve",
6842
- "parameters": [
6843
- {
6844
- "name": "name",
6845
- "type": {
6846
- "text": "string"
6847
- }
6848
- },
6849
- {
6850
- "name": "onResolved",
6851
- "type": {
6852
- "text": "(svg: string) => void"
6853
- }
6854
- }
6855
- ]
6856
- },
6857
- {
6858
- "kind": "method",
6859
- "name": "registerIcon",
6860
- "parameters": [
6861
- {
6862
- "name": "iconOrName",
6863
- "type": {
6864
- "text": "string | { title: string; default: string }"
6865
- }
6866
- },
6867
- {
6868
- "name": "icon",
6869
- "optional": true,
6870
- "type": {
6871
- "text": "string"
6872
- }
6873
- }
6874
- ]
6875
- },
6876
- {
6877
- "kind": "method",
6878
- "name": "clear"
6879
- }
6880
- ]
6881
- }
6882
- ],
6883
- "exports": [
6884
- {
6885
- "kind": "js",
6886
- "name": "IconManager",
6887
- "declaration": {
6888
- "name": "IconManager",
6889
- "module": "src/icon/IconManager.ts"
6890
- }
6891
- }
6892
- ]
6893
- },
6894
- {
6895
- "kind": "javascript-module",
6896
- "path": "src/input/Input.ts",
6897
- "declarations": [
6898
- {
6899
- "kind": "class",
6900
- "description": "Inputs are used to allow users to provide text input when the expected input is short.\nAs well as plain text, Input supports various types of text, including passwords and numbers.",
6901
- "name": "Input",
6902
- "cssProperties": [
6903
- {
6904
- "description": "Controls the inline size, or width, of the input.",
6905
- "name": "--n-input-inline-size",
6906
- "default": "240px"
6907
- },
6908
- {
6909
- "description": "Controls the background of the input, using our [color tokens](/tokens/#color).",
6910
- "name": "--n-input-background",
6911
- "default": "var(--n-color-active)"
6912
- },
6913
- {
6914
- "description": "Controls the text color of the input, using our [color tokens](/tokens/#color).",
6915
- "name": "--n-input-color",
6916
- "default": "var(--n-color-text)"
6917
- },
6918
- {
6919
- "description": "Controls the border color of the input, using our [color tokens](/tokens/#color).",
6920
- "name": "--n-input-border-color",
6921
- "default": "var(--n-color-border-strong)"
6922
- },
6923
- {
6924
- "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
6925
- "name": "--n-input-border-radius",
6926
- "default": "var(--n-border-radius-s)"
6927
- }
6928
- ],
6929
- "slots": [
6930
- {
6931
- "description": "Use when a label requires more than plain text.",
6932
- "name": "label"
6933
- },
6934
- {
6935
- "description": "Optional slot that holds hint text for the input.",
6936
- "name": "hint"
6937
- },
6938
- {
6939
- "description": "Optional slot that holds error text for the input.",
6940
- "name": "error"
6941
- },
6942
- {
6943
- "description": "Optional slot used to place an icon or prefix at the start of the input.",
6944
- "name": "start"
6945
- },
6946
- {
6947
- "description": "Optional slot used to place an icon or suffix at the end of the input.",
6948
- "name": "end"
6949
- }
6950
- ],
6951
- "members": [
6952
- {
6953
- "kind": "field",
6954
- "name": "startSlot",
6955
- "privacy": "private",
6956
- "default": "new SlotController(this, \"start\")"
6957
- },
6958
- {
6959
- "kind": "field",
6960
- "name": "endSlot",
6961
- "privacy": "private",
6962
- "default": "new SlotController(this, \"end\")"
6963
- },
6964
- {
6965
- "kind": "field",
6966
- "name": "direction",
6967
- "privacy": "private",
6968
- "default": "new DirectionController(this)"
6969
- },
6970
- {
6971
- "kind": "field",
6972
- "name": "type",
6973
- "type": {
6974
- "text": "\"text\" | \"email\" | \"password\" | \"tel\" | \"url\" | \"search\" | \"number\""
6975
- },
6976
- "default": "\"text\"",
6977
- "description": "The type of the input.",
6978
- "attribute": "type",
6979
- "reflects": true
6980
- },
6981
- {
6982
- "kind": "field",
6983
- "name": "expand",
6984
- "type": {
6985
- "text": "boolean"
6986
- },
6987
- "default": "false",
6988
- "description": "Controls whether the input expands to fill the width of its container.",
6989
- "attribute": "expand",
6990
- "reflects": true
6991
- },
6992
- {
6993
- "kind": "field",
6994
- "name": "disallowPattern",
6995
- "type": {
6996
- "text": "string | undefined"
6997
- },
6998
- "default": "undefined",
6999
- "description": "Optionally disallow certain characters from being used inside the input, using a regex pattern.",
7000
- "attribute": "disallow-pattern",
7001
- "reflects": true
7002
- },
7003
- {
7004
- "kind": "method",
7005
- "name": "handleKeydown",
7006
- "privacy": "private",
7007
- "parameters": [
7008
- {
7009
- "name": "e",
7010
- "type": {
7011
- "text": "KeyboardEvent"
7012
- }
7013
- }
7014
- ]
7015
- },
7016
- {
7017
- "kind": "field",
7018
- "name": "handleInputChange",
7019
- "privacy": "private"
7020
- },
7021
- {
7022
- "kind": "field",
7023
- "name": "size",
7024
- "type": {
7025
- "text": "\"s\" | \"m\" | \"l\""
7026
- },
7027
- "default": "\"m\"",
7028
- "description": "The size of the component.",
7029
- "attribute": "size",
7030
- "reflects": true,
7031
- "inheritedFrom": {
7032
- "name": "SizeMixin",
7033
- "module": "src/common/mixins/SizeMixin.ts"
7034
- }
7035
- },
7036
- {
7037
- "kind": "field",
7038
- "name": "labelSlot",
7039
- "privacy": "protected",
7040
- "default": "new SlotController(this, \"label\")",
7041
- "inheritedFrom": {
7042
- "name": "FormAssociatedMixin",
7043
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7044
- }
6730
+ "kind": "field",
6731
+ "name": "labelSlot",
6732
+ "privacy": "protected",
6733
+ "default": "new SlotController(this, \"label\")",
6734
+ "inheritedFrom": {
6735
+ "name": "FormAssociatedMixin",
6736
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
6737
+ }
7045
6738
  },
7046
6739
  {
7047
6740
  "kind": "field",
@@ -7510,157 +7203,411 @@
7510
7203
  }
7511
7204
  },
7512
7205
  {
7513
- "name": "hide-label",
7206
+ "name": "hide-label",
7207
+ "type": {
7208
+ "text": "boolean"
7209
+ },
7210
+ "default": "false",
7211
+ "description": "Visually hide the label, but still show it to assistive technologies like screen readers.",
7212
+ "fieldName": "hideLabel",
7213
+ "inheritedFrom": {
7214
+ "name": "FormAssociatedMixin",
7215
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
7216
+ }
7217
+ },
7218
+ {
7219
+ "name": "placeholder",
7220
+ "type": {
7221
+ "text": "string | undefined"
7222
+ },
7223
+ "description": "Placeholder text to display within the input.",
7224
+ "fieldName": "placeholder",
7225
+ "inheritedFrom": {
7226
+ "name": "FormAssociatedMixin",
7227
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
7228
+ }
7229
+ },
7230
+ {
7231
+ "name": "error",
7232
+ "type": {
7233
+ "text": "string | undefined"
7234
+ },
7235
+ "description": "Optional error to be shown with the input. Alternatively use the error slot.",
7236
+ "fieldName": "error",
7237
+ "inheritedFrom": {
7238
+ "name": "FormAssociatedMixin",
7239
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
7240
+ }
7241
+ },
7242
+ {
7243
+ "name": "required",
7244
+ "type": {
7245
+ "text": "boolean"
7246
+ },
7247
+ "default": "false",
7248
+ "description": "Determines whether the input is required or not.\nAn input marked as required will be announced as such to users of assistive technology.\nWhen using this property you need to also set “novalidate” attribute on a form element to prevent browser from displaying its own validation errors.",
7249
+ "fieldName": "required",
7250
+ "inheritedFrom": {
7251
+ "name": "FormAssociatedMixin",
7252
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
7253
+ }
7254
+ },
7255
+ {
7256
+ "name": "hide-required",
7257
+ "type": {
7258
+ "text": "boolean"
7259
+ },
7260
+ "default": "false",
7261
+ "description": "Visually hide the required indicator, but still show\nrequired attribute to assistive technologies like screen readers.",
7262
+ "fieldName": "hideRequired",
7263
+ "inheritedFrom": {
7264
+ "name": "FormAssociatedMixin",
7265
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
7266
+ }
7267
+ },
7268
+ {
7269
+ "name": "autocomplete",
7270
+ "type": {
7271
+ "text": "AutocompleteAttribute"
7272
+ },
7273
+ "default": "\"off\"",
7274
+ "description": "Specifies the data type of the field, so that the browser may attempt to fill out the field automatically on behalf of the user.",
7275
+ "fieldName": "autocomplete",
7276
+ "inheritedFrom": {
7277
+ "name": "AutocompleteMixin",
7278
+ "module": "src/common/mixins/AutocompleteMixin.ts"
7279
+ }
7280
+ },
7281
+ {
7282
+ "name": "readonly",
7283
+ "type": {
7284
+ "text": "boolean"
7285
+ },
7286
+ "default": "false",
7287
+ "description": "Makes the component readonly, so that it is not editable.\nReadonly differs from disabled in that readonly fields are still focusable and will be submitted with a form.",
7288
+ "fieldName": "readonly",
7289
+ "inheritedFrom": {
7290
+ "name": "ReadonlyMixin",
7291
+ "module": "src/common/mixins/ReadonlyMixin.ts"
7292
+ }
7293
+ },
7294
+ {
7295
+ "name": "disabled",
7296
+ "type": {
7297
+ "text": "boolean"
7298
+ },
7299
+ "default": "false",
7300
+ "description": "Makes the component disabled. This prevents users from\nbeing able to interact with the component, and conveys\nits inactive state to assistive technologies.",
7301
+ "fieldName": "disabled",
7302
+ "inheritedFrom": {
7303
+ "name": "InputMixin",
7304
+ "module": "src/common/mixins/InputMixin.ts"
7305
+ }
7306
+ },
7307
+ {
7308
+ "name": "name",
7309
+ "type": {
7310
+ "text": "string | undefined"
7311
+ },
7312
+ "description": "The name of the form component.",
7313
+ "fieldName": "name",
7314
+ "inheritedFrom": {
7315
+ "name": "InputMixin",
7316
+ "module": "src/common/mixins/InputMixin.ts"
7317
+ }
7318
+ },
7319
+ {
7320
+ "name": "value",
7321
+ "type": {
7322
+ "text": "string"
7323
+ },
7324
+ "default": "\"\"",
7325
+ "description": "The value of the form component.",
7326
+ "fieldName": "value",
7327
+ "inheritedFrom": {
7328
+ "name": "InputMixin",
7329
+ "module": "src/common/mixins/InputMixin.ts"
7330
+ }
7331
+ }
7332
+ ],
7333
+ "mixins": [
7334
+ {
7335
+ "name": "SizeMixin",
7336
+ "module": "/src/common/mixins/SizeMixin.js"
7337
+ },
7338
+ {
7339
+ "name": "FormAssociatedMixin",
7340
+ "module": "/src/common/mixins/FormAssociatedMixin.js"
7341
+ },
7342
+ {
7343
+ "name": "AutocompleteMixin",
7344
+ "module": "/src/common/mixins/AutocompleteMixin.js"
7345
+ },
7346
+ {
7347
+ "name": "ReadonlyMixin",
7348
+ "module": "/src/common/mixins/ReadonlyMixin.js"
7349
+ },
7350
+ {
7351
+ "name": "InputMixin",
7352
+ "module": "/src/common/mixins/InputMixin.js"
7353
+ },
7354
+ {
7355
+ "name": "FocusableMixin",
7356
+ "module": "/src/common/mixins/FocusableMixin.js"
7357
+ }
7358
+ ],
7359
+ "superclass": {
7360
+ "name": "LitElement",
7361
+ "package": "lit"
7362
+ },
7363
+ "localization": [],
7364
+ "status": "ready",
7365
+ "category": "form",
7366
+ "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 provide a text input where the expected input is short.\n- Use to only ask for information that’s really needed. Hide optional fields by default if possible or have them shown with a lower priority.\n- Use help text and placeholder to provide additional, non-critical instructions.\n- Validate input as soon as users have finished interacting with them (but not before).\n- Where necessary, label the input as “Optional” when you need to request input that’s not required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use when the expected text input is long. Use textarea component instead.\n- Don’t use the placeholder to provide information that’s required to use the input. Hint text should be used for this purpose instead.\n\n</div>\n\n---\n\n## Content guidelines\n\nInput labels act as a title for the text field. Labels should typically be short and in noun form:\n\n<div class=\"n-usage n-usage-do\">Company name</div>\n<div class=\"n-usage n-usage-dont\">What is your company name?</div>\n\nWhen writing input 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\">Company name</div>\n<div class=\"n-usage n-usage-dont\">Company Name</div>\n\nWhen an input isn’t part of a form and is placed individually on a page, you could provide the input label as a call to action:\n\n<div class=\"n-usage n-usage-do\">Leave a comment</div>\n<div class=\"n-usage n-usage-dont\">Comment</div>\n\nDo not use colons in input label:\n\n<div class=\"n-usage n-usage-do\">First name</div>\n<div class=\"n-usage n-usage-dont\">First name:</div>\n\n---\n\n## Types\n\nThis section describes the different input types, their purpose, and when to use each type.\n\n| Name | Purpose |\n| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `text` | The default and most common variant. Displayed as a single-line text field. Line-breaks are automatically removed from the input value. |\n| `email` | A field for editing an email address. Looks similar to a text input, but has validation parameters and relevant keyboard for devices with dynamic keyboards. |\n| `password` | A single-line text field where the value is obscured. This type will alert user if a site is not secure. |\n| `tel` | A field for entering a telephone number. Displays a number keypad on mobile devices. |\n| `url` | A field variant that is used to let the user enter and edit an URL. |\n| `search` | A single-line text field for entering search strings. |\n| `number` | Used to let the user enter a number. |\n\n## Icon usage in input\n\nEach [input size](/components/input/?example=size) has a recommended icon size. The medium input uses the `s` icon size, the small input uses the `xs` icon size, and the large input uses the `m` icon size. The icon will adjust size automatically based on the button size, so you will get the correct behavior by default. However, this can be overridden by explicitly setting a size on the icon.\n",
7367
+ "examples": [],
7368
+ "tagName": "nord-input",
7369
+ "customElement": true,
7370
+ "events": [
7371
+ {
7372
+ "name": "input",
7373
+ "type": {
7374
+ "text": "NordEvent"
7375
+ },
7376
+ "description": "Fired as the user types into the input.",
7377
+ "inheritedFrom": {
7378
+ "name": "FormAssociatedMixin",
7379
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
7380
+ }
7381
+ },
7382
+ {
7383
+ "name": "change",
7384
+ "type": {
7385
+ "text": "NordEvent"
7386
+ },
7387
+ "description": "Fired whenever the input's value is changed via user interaction.",
7388
+ "inheritedFrom": {
7389
+ "name": "FormAssociatedMixin",
7390
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
7391
+ }
7392
+ }
7393
+ ]
7394
+ }
7395
+ ],
7396
+ "exports": [
7397
+ {
7398
+ "kind": "js",
7399
+ "name": "default",
7400
+ "declaration": {
7401
+ "name": "Input",
7402
+ "module": "src/input/Input.ts"
7403
+ }
7404
+ },
7405
+ {
7406
+ "kind": "custom-element-definition",
7407
+ "name": "nord-input",
7408
+ "declaration": {
7409
+ "name": "Input",
7410
+ "module": "src/input/Input.ts"
7411
+ }
7412
+ }
7413
+ ]
7414
+ },
7415
+ {
7416
+ "kind": "javascript-module",
7417
+ "path": "src/icon/Icon.ts",
7418
+ "declarations": [
7419
+ {
7420
+ "kind": "class",
7421
+ "description": "Icons are used to provide additional meaning or in places where text label doesn’t fit.\nIcon component allows you to display an icon from the Nordicons library.",
7422
+ "name": "Icon",
7423
+ "slots": [
7424
+ {
7425
+ "description": "The default slot used for placing a custom SVG icon.",
7426
+ "name": ""
7427
+ }
7428
+ ],
7429
+ "members": [
7430
+ {
7431
+ "kind": "field",
7432
+ "name": "manager",
7433
+ "privacy": "private",
7434
+ "static": true,
7435
+ "default": "new IconManager()"
7436
+ },
7437
+ {
7438
+ "kind": "method",
7439
+ "name": "registerResolver",
7440
+ "static": true,
7441
+ "parameters": [
7442
+ {
7443
+ "name": "resolver",
7444
+ "type": {
7445
+ "text": "IconResolver"
7446
+ },
7447
+ "description": "The resolver function to register."
7448
+ }
7449
+ ],
7450
+ "description": "Register a custom icon resolver, which accepts the icon name as an parameter, and returns an SVG string.\nCan return a string synchronously, or a promise of a string.\nBy default, will load icons from the Nord CDN."
7451
+ },
7452
+ {
7453
+ "kind": "method",
7454
+ "name": "registerIcon",
7455
+ "static": true,
7456
+ "return": {
7457
+ "type": {
7458
+ "text": "void"
7459
+ }
7460
+ },
7461
+ "parameters": [
7462
+ {
7463
+ "name": "icon",
7464
+ "type": {
7465
+ "text": "{ title: string; default: string }"
7466
+ },
7467
+ "description": "An object representing the icon to be registered, where \"title\" is the icon's name, and \"default\" is the SVG string.\nThis is intended to be used in cases where you import an icon's entire ES module and register it directly."
7468
+ }
7469
+ ],
7470
+ "description": "Register an individual icon so it can be rendered synchronously, to avoid loading over the network."
7471
+ },
7472
+ {
7473
+ "kind": "method",
7474
+ "name": "registerIcon",
7475
+ "static": true,
7476
+ "return": {
7477
+ "type": {
7478
+ "text": "void"
7479
+ }
7480
+ },
7481
+ "parameters": [
7482
+ {
7483
+ "name": "name",
7484
+ "type": {
7485
+ "text": "string"
7486
+ },
7487
+ "description": "The name of the icon to be registered."
7488
+ },
7489
+ {
7490
+ "name": "icon",
7491
+ "type": {
7492
+ "text": "string"
7493
+ },
7494
+ "description": "The SVG string for the icon."
7495
+ }
7496
+ ],
7497
+ "description": "Register an individual icon so it can be rendered synchronously, to avoid loading over the network."
7498
+ },
7499
+ {
7500
+ "kind": "method",
7501
+ "name": "registerIcon",
7502
+ "static": true,
7503
+ "parameters": [
7504
+ {
7505
+ "name": "iconOrName",
7506
+ "type": {
7507
+ "text": "string | { title: string; default: string }"
7508
+ },
7509
+ "description": "The name of the icon to be registered or an object representing the icon to be registered, where \"title\" is the icon's name, and \"default\" is the SVG string."
7510
+ },
7511
+ {
7512
+ "name": "icon",
7513
+ "optional": true,
7514
+ "type": {
7515
+ "text": "string"
7516
+ },
7517
+ "description": "The SVG string for the icon."
7518
+ }
7519
+ ],
7520
+ "description": "Register an individual icon so it can be rendered synchronously, to avoid loading over the network."
7521
+ },
7522
+ {
7523
+ "kind": "field",
7524
+ "name": "name",
7514
7525
  "type": {
7515
- "text": "boolean"
7526
+ "text": "string"
7516
7527
  },
7517
- "default": "false",
7518
- "description": "Visually hide the label, but still show it to assistive technologies like screen readers.",
7519
- "fieldName": "hideLabel",
7520
- "inheritedFrom": {
7521
- "name": "FormAssociatedMixin",
7522
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7523
- }
7528
+ "default": "\"\"",
7529
+ "description": "The name of the icon to display, as defined by [nordicons](/nordicons/).",
7530
+ "attribute": "name",
7531
+ "reflects": true
7524
7532
  },
7525
7533
  {
7526
- "name": "placeholder",
7534
+ "kind": "field",
7535
+ "name": "size",
7527
7536
  "type": {
7528
- "text": "string | undefined"
7537
+ "text": "\"xxs\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\" | undefined"
7529
7538
  },
7530
- "description": "Placeholder text to display within the input.",
7531
- "fieldName": "placeholder",
7532
- "inheritedFrom": {
7533
- "name": "FormAssociatedMixin",
7534
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7535
- }
7539
+ "description": "The size of the icon.",
7540
+ "attribute": "size",
7541
+ "reflects": true
7536
7542
  },
7537
7543
  {
7538
- "name": "error",
7544
+ "kind": "field",
7545
+ "name": "color",
7539
7546
  "type": {
7540
7547
  "text": "string | undefined"
7541
7548
  },
7542
- "description": "Optional error to be shown with the input. Alternatively use the error slot.",
7543
- "fieldName": "error",
7544
- "inheritedFrom": {
7545
- "name": "FormAssociatedMixin",
7546
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7547
- }
7549
+ "description": "The color of the icon.\nCan accept any valid CSS color value, including custom properties.",
7550
+ "attribute": "color",
7551
+ "reflects": true
7548
7552
  },
7549
7553
  {
7550
- "name": "required",
7554
+ "kind": "field",
7555
+ "name": "label",
7551
7556
  "type": {
7552
- "text": "boolean"
7557
+ "text": "string | undefined"
7553
7558
  },
7554
- "default": "false",
7555
- "description": "Determines whether the input is required or not.\nAn input marked as required will be announced as such to users of assistive technology.\nWhen using this property you need to also set “novalidate” attribute on a form element to prevent browser from displaying its own validation errors.",
7556
- "fieldName": "required",
7557
- "inheritedFrom": {
7558
- "name": "FormAssociatedMixin",
7559
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7560
- }
7559
+ "description": "An accessible label for the icon.\nIf no label is supplied, the icon is hidden from assistive technology.",
7560
+ "attribute": "label",
7561
+ "reflects": true
7561
7562
  },
7562
7563
  {
7563
- "name": "hide-required",
7564
+ "kind": "field",
7565
+ "name": "svg",
7564
7566
  "type": {
7565
- "text": "boolean"
7567
+ "text": "string"
7566
7568
  },
7567
- "default": "false",
7568
- "description": "Visually hide the required indicator, but still show\nrequired attribute to assistive technologies like screen readers.",
7569
- "fieldName": "hideRequired",
7570
- "inheritedFrom": {
7571
- "name": "FormAssociatedMixin",
7572
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7573
- }
7569
+ "privacy": "private",
7570
+ "default": "\"\""
7574
7571
  },
7575
7572
  {
7576
- "name": "autocomplete",
7577
- "type": {
7578
- "text": "AutocompleteAttribute"
7579
- },
7580
- "default": "\"off\"",
7581
- "description": "Specifies the data type of the field, so that the browser may attempt to fill out the field automatically on behalf of the user.",
7582
- "fieldName": "autocomplete",
7583
- "inheritedFrom": {
7584
- "name": "AutocompleteMixin",
7585
- "module": "src/common/mixins/AutocompleteMixin.ts"
7586
- }
7587
- },
7573
+ "kind": "method",
7574
+ "name": "handleNameChange",
7575
+ "privacy": "protected"
7576
+ }
7577
+ ],
7578
+ "attributes": [
7588
7579
  {
7589
- "name": "readonly",
7580
+ "name": "name",
7590
7581
  "type": {
7591
- "text": "boolean"
7582
+ "text": "string"
7592
7583
  },
7593
- "default": "false",
7594
- "description": "Makes the component readonly, so that it is not editable.\nReadonly differs from disabled in that readonly fields are still focusable and will be submitted with a form.",
7595
- "fieldName": "readonly",
7596
- "inheritedFrom": {
7597
- "name": "ReadonlyMixin",
7598
- "module": "src/common/mixins/ReadonlyMixin.ts"
7599
- }
7584
+ "default": "\"\"",
7585
+ "description": "The name of the icon to display, as defined by [nordicons](/nordicons/).",
7586
+ "fieldName": "name"
7600
7587
  },
7601
7588
  {
7602
- "name": "disabled",
7589
+ "name": "size",
7603
7590
  "type": {
7604
- "text": "boolean"
7591
+ "text": "\"xxs\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\" | undefined"
7605
7592
  },
7606
- "default": "false",
7607
- "description": "Makes the component disabled. This prevents users from\nbeing able to interact with the component, and conveys\nits inactive state to assistive technologies.",
7608
- "fieldName": "disabled",
7609
- "inheritedFrom": {
7610
- "name": "InputMixin",
7611
- "module": "src/common/mixins/InputMixin.ts"
7612
- }
7593
+ "description": "The size of the icon.",
7594
+ "fieldName": "size"
7613
7595
  },
7614
7596
  {
7615
- "name": "name",
7597
+ "name": "color",
7616
7598
  "type": {
7617
7599
  "text": "string | undefined"
7618
7600
  },
7619
- "description": "The name of the form component.",
7620
- "fieldName": "name",
7621
- "inheritedFrom": {
7622
- "name": "InputMixin",
7623
- "module": "src/common/mixins/InputMixin.ts"
7624
- }
7601
+ "description": "The color of the icon.\nCan accept any valid CSS color value, including custom properties.",
7602
+ "fieldName": "color"
7625
7603
  },
7626
7604
  {
7627
- "name": "value",
7605
+ "name": "label",
7628
7606
  "type": {
7629
- "text": "string"
7607
+ "text": "string | undefined"
7630
7608
  },
7631
- "default": "\"\"",
7632
- "description": "The value of the form component.",
7633
- "fieldName": "value",
7634
- "inheritedFrom": {
7635
- "name": "InputMixin",
7636
- "module": "src/common/mixins/InputMixin.ts"
7637
- }
7638
- }
7639
- ],
7640
- "mixins": [
7641
- {
7642
- "name": "SizeMixin",
7643
- "module": "/src/common/mixins/SizeMixin.js"
7644
- },
7645
- {
7646
- "name": "FormAssociatedMixin",
7647
- "module": "/src/common/mixins/FormAssociatedMixin.js"
7648
- },
7649
- {
7650
- "name": "AutocompleteMixin",
7651
- "module": "/src/common/mixins/AutocompleteMixin.js"
7652
- },
7653
- {
7654
- "name": "ReadonlyMixin",
7655
- "module": "/src/common/mixins/ReadonlyMixin.js"
7656
- },
7657
- {
7658
- "name": "InputMixin",
7659
- "module": "/src/common/mixins/InputMixin.js"
7660
- },
7661
- {
7662
- "name": "FocusableMixin",
7663
- "module": "/src/common/mixins/FocusableMixin.js"
7609
+ "description": "An accessible label for the icon.\nIf no label is supplied, the icon is hidden from assistive technology.",
7610
+ "fieldName": "label"
7664
7611
  }
7665
7612
  ],
7666
7613
  "superclass": {
@@ -7669,33 +7616,94 @@
7669
7616
  },
7670
7617
  "localization": [],
7671
7618
  "status": "ready",
7672
- "category": "form",
7673
- "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 provide a text input where the expected input is short.\n- Use to only ask for information that’s really needed. Hide optional fields by default if possible or have them shown with a lower priority.\n- Use help text and placeholder to provide additional, non-critical instructions.\n- Validate input as soon as users have finished interacting with them (but not before).\n- Where necessary, label the input as “Optional” when you need to request input that’s not required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use when the expected text input is long. Use textarea component instead.\n- Don’t use the placeholder to provide information that’s required to use the input. Hint text should be used for this purpose instead.\n\n</div>\n\n---\n\n## Content guidelines\n\nInput labels act as a title for the text field. Labels should typically be short and in noun form:\n\n<div class=\"n-usage n-usage-do\">Company name</div>\n<div class=\"n-usage n-usage-dont\">What is your company name?</div>\n\nWhen writing input 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\">Company name</div>\n<div class=\"n-usage n-usage-dont\">Company Name</div>\n\nWhen an input isn’t part of a form and is placed individually on a page, you could provide the input label as a call to action:\n\n<div class=\"n-usage n-usage-do\">Leave a comment</div>\n<div class=\"n-usage n-usage-dont\">Comment</div>\n\nDo not use colons in input label:\n\n<div class=\"n-usage n-usage-do\">First name</div>\n<div class=\"n-usage n-usage-dont\">First name:</div>\n\n---\n\n## Types\n\nThis section describes the different input types, their purpose, and when to use each type.\n\n| Name | Purpose |\n| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `text` | The default and most common variant. Displayed as a single-line text field. Line-breaks are automatically removed from the input value. |\n| `email` | A field for editing an email address. Looks similar to a text input, but has validation parameters and relevant keyboard for devices with dynamic keyboards. |\n| `password` | A single-line text field where the value is obscured. This type will alert user if a site is not secure. |\n| `tel` | A field for entering a telephone number. Displays a number keypad on mobile devices. |\n| `url` | A field variant that is used to let the user enter and edit an URL. |\n| `search` | A single-line text field for entering search strings. |\n| `number` | Used to let the user enter a number. |\n\n## Icon usage in input\n\nEach [input size](/components/input/?example=size) has a recommended icon size. The medium input uses the `s` icon size, the small input uses the `xs` icon size, and the large input uses the `m` icon size. The icon will adjust size automatically based on the button size, so you will get the correct behavior by default. However, this can be overridden by explicitly setting a size on the icon.\n",
7619
+ "category": "image",
7620
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<nord-button href=\"/nordicons/\" variant=\"primary\">View Nordicons</nord-button>\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use to provide additional meaning in addition to a text label.\n- Use to help users who have difficulties with reading and attention.\n- Use in places where text label doesn’t fit (remember to add an accessible label for the icon).\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for decorative purposes alone.\n- Don’t use when a button’s action is already clear based on the text label.\n- Don’t use the same icon for differing purposes, as users will come to associate icons with specific types of actions.\n\n</div>\n\n---\n\n## Additional considerations\n\n- Icon components are hidden from assistive technologies by default.\n- Use `label` property to give an accessible label for the icon and to make it visible to assistive technologies.\n",
7674
7621
  "examples": [],
7675
- "tagName": "nord-input",
7676
- "customElement": true,
7677
- "events": [
7622
+ "tagName": "nord-icon",
7623
+ "customElement": true
7624
+ }
7625
+ ],
7626
+ "exports": [
7627
+ {
7628
+ "kind": "js",
7629
+ "name": "default",
7630
+ "declaration": {
7631
+ "name": "Icon",
7632
+ "module": "src/icon/Icon.ts"
7633
+ }
7634
+ },
7635
+ {
7636
+ "kind": "custom-element-definition",
7637
+ "name": "nord-icon",
7638
+ "declaration": {
7639
+ "name": "Icon",
7640
+ "module": "src/icon/Icon.ts"
7641
+ }
7642
+ }
7643
+ ]
7644
+ },
7645
+ {
7646
+ "kind": "javascript-module",
7647
+ "path": "src/icon/IconManager.ts",
7648
+ "declarations": [
7649
+ {
7650
+ "kind": "class",
7651
+ "description": "",
7652
+ "name": "IconManager",
7653
+ "members": [
7678
7654
  {
7679
- "name": "input",
7655
+ "kind": "field",
7656
+ "name": "cache",
7657
+ "privacy": "private",
7658
+ "default": "new Map<string, string | Promise<string>>()"
7659
+ },
7660
+ {
7661
+ "kind": "field",
7662
+ "name": "resolver",
7680
7663
  "type": {
7681
- "text": "NordEvent"
7682
- },
7683
- "description": "Fired as the user types into the input.",
7684
- "inheritedFrom": {
7685
- "name": "FormAssociatedMixin",
7686
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7664
+ "text": "IconResolver"
7687
7665
  }
7688
7666
  },
7689
7667
  {
7690
- "name": "change",
7691
- "type": {
7692
- "text": "NordEvent"
7693
- },
7694
- "description": "Fired whenever the input's value is changed via user interaction.",
7695
- "inheritedFrom": {
7696
- "name": "FormAssociatedMixin",
7697
- "module": "src/common/mixins/FormAssociatedMixin.ts"
7698
- }
7668
+ "kind": "method",
7669
+ "name": "resolve",
7670
+ "parameters": [
7671
+ {
7672
+ "name": "name",
7673
+ "type": {
7674
+ "text": "string"
7675
+ }
7676
+ },
7677
+ {
7678
+ "name": "onResolved",
7679
+ "type": {
7680
+ "text": "(svg: string) => void"
7681
+ }
7682
+ }
7683
+ ]
7684
+ },
7685
+ {
7686
+ "kind": "method",
7687
+ "name": "registerIcon",
7688
+ "parameters": [
7689
+ {
7690
+ "name": "iconOrName",
7691
+ "type": {
7692
+ "text": "string | { title: string; default: string }"
7693
+ }
7694
+ },
7695
+ {
7696
+ "name": "icon",
7697
+ "optional": true,
7698
+ "type": {
7699
+ "text": "string"
7700
+ }
7701
+ }
7702
+ ]
7703
+ },
7704
+ {
7705
+ "kind": "method",
7706
+ "name": "clear"
7699
7707
  }
7700
7708
  ]
7701
7709
  }
@@ -7703,18 +7711,10 @@
7703
7711
  "exports": [
7704
7712
  {
7705
7713
  "kind": "js",
7706
- "name": "default",
7707
- "declaration": {
7708
- "name": "Input",
7709
- "module": "src/input/Input.ts"
7710
- }
7711
- },
7712
- {
7713
- "kind": "custom-element-definition",
7714
- "name": "nord-input",
7714
+ "name": "IconManager",
7715
7715
  "declaration": {
7716
- "name": "Input",
7717
- "module": "src/input/Input.ts"
7716
+ "name": "IconManager",
7717
+ "module": "src/icon/IconManager.ts"
7718
7718
  }
7719
7719
  }
7720
7720
  ]
@@ -8865,73 +8865,6 @@
8865
8865
  }
8866
8866
  ]
8867
8867
  },
8868
- {
8869
- "kind": "javascript-module",
8870
- "path": "src/nav-group/NavGroup.ts",
8871
- "declarations": [
8872
- {
8873
- "kind": "class",
8874
- "description": "Navigation group includes all the actions or items in a single\ngroup and is used for grouping items into related categories.",
8875
- "name": "NavGroup",
8876
- "slots": [
8877
- {
8878
- "description": "The default slot used for the nav items.",
8879
- "name": ""
8880
- }
8881
- ],
8882
- "members": [
8883
- {
8884
- "kind": "field",
8885
- "name": "heading",
8886
- "type": {
8887
- "text": "string | undefined"
8888
- },
8889
- "description": "Heading and accessible label for the nav group",
8890
- "attribute": "heading"
8891
- }
8892
- ],
8893
- "attributes": [
8894
- {
8895
- "name": "heading",
8896
- "type": {
8897
- "text": "string | undefined"
8898
- },
8899
- "description": "Heading and accessible label for the nav group",
8900
- "fieldName": "heading"
8901
- }
8902
- ],
8903
- "superclass": {
8904
- "name": "LitElement",
8905
- "package": "lit"
8906
- },
8907
- "localization": [],
8908
- "status": "ready",
8909
- "category": "navigation",
8910
- "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 navigation items into navigation groups based on related categories.\n- Use group headings to clarify the category of a section.\n- Use icons for all top level navigation items.\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\nWhen writing navigation item 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 item labels, 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 item labels 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\nUse as few words as possible to describe each item 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 item labels and group titles:\n\n<div class=\"n-usage n-usage-do\">Dashboard</div>\n<div class=\"n-usage n-usage-dont\">DASHBOARD</div>\n",
8911
- "examples": [],
8912
- "tagName": "nord-nav-group",
8913
- "customElement": true
8914
- }
8915
- ],
8916
- "exports": [
8917
- {
8918
- "kind": "js",
8919
- "name": "default",
8920
- "declaration": {
8921
- "name": "NavGroup",
8922
- "module": "src/nav-group/NavGroup.ts"
8923
- }
8924
- },
8925
- {
8926
- "kind": "custom-element-definition",
8927
- "name": "nord-nav-group",
8928
- "declaration": {
8929
- "name": "NavGroup",
8930
- "module": "src/nav-group/NavGroup.ts"
8931
- }
8932
- }
8933
- ]
8934
- },
8935
8868
  {
8936
8869
  "kind": "javascript-module",
8937
8870
  "path": "src/nav-item/NavItem.ts",
@@ -9193,6 +9126,73 @@
9193
9126
  }
9194
9127
  ]
9195
9128
  },
9129
+ {
9130
+ "kind": "javascript-module",
9131
+ "path": "src/nav-group/NavGroup.ts",
9132
+ "declarations": [
9133
+ {
9134
+ "kind": "class",
9135
+ "description": "Navigation group includes all the actions or items in a single\ngroup and is used for grouping items into related categories.",
9136
+ "name": "NavGroup",
9137
+ "slots": [
9138
+ {
9139
+ "description": "The default slot used for the nav items.",
9140
+ "name": ""
9141
+ }
9142
+ ],
9143
+ "members": [
9144
+ {
9145
+ "kind": "field",
9146
+ "name": "heading",
9147
+ "type": {
9148
+ "text": "string | undefined"
9149
+ },
9150
+ "description": "Heading and accessible label for the nav group",
9151
+ "attribute": "heading"
9152
+ }
9153
+ ],
9154
+ "attributes": [
9155
+ {
9156
+ "name": "heading",
9157
+ "type": {
9158
+ "text": "string | undefined"
9159
+ },
9160
+ "description": "Heading and accessible label for the nav group",
9161
+ "fieldName": "heading"
9162
+ }
9163
+ ],
9164
+ "superclass": {
9165
+ "name": "LitElement",
9166
+ "package": "lit"
9167
+ },
9168
+ "localization": [],
9169
+ "status": "ready",
9170
+ "category": "navigation",
9171
+ "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 navigation items into navigation groups based on related categories.\n- Use group headings to clarify the category of a section.\n- Use icons for all top level navigation items.\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\nWhen writing navigation item 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 item labels, 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 item labels 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\nUse as few words as possible to describe each item 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 item labels and group titles:\n\n<div class=\"n-usage n-usage-do\">Dashboard</div>\n<div class=\"n-usage n-usage-dont\">DASHBOARD</div>\n",
9172
+ "examples": [],
9173
+ "tagName": "nord-nav-group",
9174
+ "customElement": true
9175
+ }
9176
+ ],
9177
+ "exports": [
9178
+ {
9179
+ "kind": "js",
9180
+ "name": "default",
9181
+ "declaration": {
9182
+ "name": "NavGroup",
9183
+ "module": "src/nav-group/NavGroup.ts"
9184
+ }
9185
+ },
9186
+ {
9187
+ "kind": "custom-element-definition",
9188
+ "name": "nord-nav-group",
9189
+ "declaration": {
9190
+ "name": "NavGroup",
9191
+ "module": "src/nav-group/NavGroup.ts"
9192
+ }
9193
+ }
9194
+ ]
9195
+ },
9196
9196
  {
9197
9197
  "kind": "javascript-module",
9198
9198
  "path": "src/nav-toggle/NavToggle.ts",
@@ -12943,53 +12943,6 @@
12943
12943
  }
12944
12944
  ]
12945
12945
  },
12946
- {
12947
- "kind": "javascript-module",
12948
- "path": "src/tab-panel/TabPanel.ts",
12949
- "declarations": [
12950
- {
12951
- "kind": "class",
12952
- "description": "The panel which contains content that can be revealed using a tab\nin the tab group component.",
12953
- "name": "TabPanel",
12954
- "slots": [
12955
- {
12956
- "description": "The tab panel content.",
12957
- "name": ""
12958
- }
12959
- ],
12960
- "members": [],
12961
- "superclass": {
12962
- "name": "LitElement",
12963
- "package": "lit"
12964
- },
12965
- "localization": [],
12966
- "status": "ready",
12967
- "category": "navigation",
12968
- "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",
12969
- "examples": [],
12970
- "tagName": "nord-tab-panel",
12971
- "customElement": true
12972
- }
12973
- ],
12974
- "exports": [
12975
- {
12976
- "kind": "js",
12977
- "name": "default",
12978
- "declaration": {
12979
- "name": "TabPanel",
12980
- "module": "src/tab-panel/TabPanel.ts"
12981
- }
12982
- },
12983
- {
12984
- "kind": "custom-element-definition",
12985
- "name": "nord-tab-panel",
12986
- "declaration": {
12987
- "name": "TabPanel",
12988
- "module": "src/tab-panel/TabPanel.ts"
12989
- }
12990
- }
12991
- ]
12992
- },
12993
12946
  {
12994
12947
  "kind": "javascript-module",
12995
12948
  "path": "src/table/Table.ts",
@@ -13141,6 +13094,53 @@
13141
13094
  }
13142
13095
  ]
13143
13096
  },
13097
+ {
13098
+ "kind": "javascript-module",
13099
+ "path": "src/tab-panel/TabPanel.ts",
13100
+ "declarations": [
13101
+ {
13102
+ "kind": "class",
13103
+ "description": "The panel which contains content that can be revealed using a tab\nin the tab group component.",
13104
+ "name": "TabPanel",
13105
+ "slots": [
13106
+ {
13107
+ "description": "The tab panel content.",
13108
+ "name": ""
13109
+ }
13110
+ ],
13111
+ "members": [],
13112
+ "superclass": {
13113
+ "name": "LitElement",
13114
+ "package": "lit"
13115
+ },
13116
+ "localization": [],
13117
+ "status": "ready",
13118
+ "category": "navigation",
13119
+ "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",
13120
+ "examples": [],
13121
+ "tagName": "nord-tab-panel",
13122
+ "customElement": true
13123
+ }
13124
+ ],
13125
+ "exports": [
13126
+ {
13127
+ "kind": "js",
13128
+ "name": "default",
13129
+ "declaration": {
13130
+ "name": "TabPanel",
13131
+ "module": "src/tab-panel/TabPanel.ts"
13132
+ }
13133
+ },
13134
+ {
13135
+ "kind": "custom-element-definition",
13136
+ "name": "nord-tab-panel",
13137
+ "declaration": {
13138
+ "name": "TabPanel",
13139
+ "module": "src/tab-panel/TabPanel.ts"
13140
+ }
13141
+ }
13142
+ ]
13143
+ },
13144
13144
  {
13145
13145
  "kind": "javascript-module",
13146
13146
  "path": "src/textarea/Textarea.ts",