@nordhealth/components 3.7.0 → 3.8.0

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.
@@ -456,6 +456,11 @@
456
456
  "description": "Controls the box shadow for the avatar.",
457
457
  "name": "--n-avatar-box-shadow",
458
458
  "default": "none"
459
+ },
460
+ {
461
+ "description": "Controls the color of the avatar’s text and icon, using [color tokens](/tokens/#color).",
462
+ "name": "--n-avatar-text-color",
463
+ "default": "var(--n-color-text-on-accent)"
459
464
  }
460
465
  ],
461
466
  "members": [
@@ -630,82 +635,52 @@
630
635
  },
631
636
  {
632
637
  "kind": "javascript-module",
633
- "path": "src/badge/Badge.ts",
638
+ "path": "src/banner/Banner.ts",
634
639
  "declarations": [
635
640
  {
636
641
  "kind": "class",
637
- "description": "Badges are used to inform users of the status of an object\nor of an action that’s been taken. Commonly used in tabular\ndata to indicate status.",
638
- "name": "Badge",
639
- "slots": [
642
+ "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.",
643
+ "name": "Banner",
644
+ "cssProperties": [
640
645
  {
641
- "description": "The badge content.",
642
- "name": ""
646
+ "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
647
+ "name": "--n-banner-border-radius",
648
+ "default": "var(--n-border-radius)"
643
649
  },
644
650
  {
645
- "description": "Used to place an icon at the start of badge.",
646
- "name": "icon"
651
+ "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
652
+ "name": "--n-banner-box-shadow",
653
+ "default": "var(--n-box-shadow-card)"
647
654
  }
648
655
  ],
649
- "members": [
656
+ "slots": [
650
657
  {
651
- "kind": "field",
652
- "name": "type",
653
- "type": {
654
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
655
- },
656
- "description": "The type of badge.\nDetermines the background color of the badge.",
657
- "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
658
- "attribute": "type",
659
- "reflects": true
660
- },
658
+ "description": "default slot",
659
+ "name": ""
660
+ }
661
+ ],
662
+ "members": [
661
663
  {
662
664
  "kind": "field",
663
665
  "name": "variant",
664
666
  "type": {
665
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
667
+ "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
666
668
  },
667
- "description": "The style variant of the badge.\nDetermines the background color of the badge.",
669
+ "default": "\"info\"",
670
+ "description": "The style variant of the banner.",
668
671
  "attribute": "variant",
669
672
  "reflects": true
670
- },
671
- {
672
- "kind": "field",
673
- "name": "strong",
674
- "type": {
675
- "text": "boolean"
676
- },
677
- "default": "false",
678
- "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
679
- "attribute": "strong",
680
- "reflects": true
681
673
  }
682
674
  ],
683
675
  "attributes": [
684
- {
685
- "name": "type",
686
- "type": {
687
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
688
- },
689
- "description": "The type of badge.\nDetermines the background color of the badge.",
690
- "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
691
- "fieldName": "type"
692
- },
693
676
  {
694
677
  "name": "variant",
695
678
  "type": {
696
- "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
679
+ "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
697
680
  },
698
- "description": "The style variant of the badge.\nDetermines the background color of the badge.",
681
+ "default": "\"info\"",
682
+ "description": "The style variant of the banner.",
699
683
  "fieldName": "variant"
700
- },
701
- {
702
- "name": "strong",
703
- "type": {
704
- "text": "boolean"
705
- },
706
- "default": "false",
707
- "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
708
- "fieldName": "strong"
709
684
  }
710
685
  ],
711
686
  "superclass": {
@@ -714,11 +689,13 @@
714
689
  },
715
690
  "localization": [],
716
691
  "status": "ready",
717
- "category": "text",
718
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Use established variants and color patterns so that users can clearly identify the importance level.\n- Use to show a status update on a piece of information or action.\n- Use to mark something as a “draft” or “new”.\n- Use when you want to highlight something that has been added recently.\n- Always position badge so that it’s clear to understand what object it’s related to.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t make badges clickable. Instead use button component’s small variant.\n- Don’t use alternatives to existing badge variants.\n\n</div>\n\n---\n\n## Content guidelines\n\nBadge labels should use a single word to describe the status of an object. Only use two words if you need to describe a complex state:\n\n<div class=\"n-usage n-usage-do\">Complete</div>\n<div class=\"n-usage n-usage-dont\">Action completed</div>\n\nWhen writing badge labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Partially refunded</div>\n<div class=\"n-usage n-usage-dont\">Partially Refunded</div>\n\nAvoid unnecessary words and articles in badge labels, such as “is”, “the”, “an or “a”:\n\n<div class=\"n-usage n-usage-do\">Pending</div>\n<div class=\"n-usage n-usage-dont\">Item is pending</div>\n\nAlways describe the status in the past tense:\n\n<div class=\"n-usage n-usage-do\">Refunded</div>\n<div class=\"n-usage n-usage-dont\">Refund</div>\n\n---\n\n## Variants\n\nThis section describes the different component variants, their purpose, and when to use each variant.\n\n| Name | Purpose |\n| ----------- | --------------------------------------------------------------------------------------------------------------------------------------- |\n| `neutral` | The default style variant. |\n| `info` | Used to convey general information that isnt 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",
692
+ "category": "feedback",
693
+ "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\">Were experiencing an incident</div>\n",
719
694
  "examples": [],
720
- "dependencies": [],
721
- "tagName": "nord-badge",
695
+ "dependencies": [
696
+ "icon"
697
+ ],
698
+ "tagName": "nord-banner",
722
699
  "customElement": true
723
700
  }
724
701
  ],
@@ -727,16 +704,16 @@
727
704
  "kind": "js",
728
705
  "name": "default",
729
706
  "declaration": {
730
- "name": "Badge",
731
- "module": "src/badge/Badge.ts"
707
+ "name": "Banner",
708
+ "module": "src/banner/Banner.ts"
732
709
  }
733
710
  },
734
711
  {
735
712
  "kind": "custom-element-definition",
736
- "name": "nord-badge",
713
+ "name": "nord-banner",
737
714
  "declaration": {
738
- "name": "Badge",
739
- "module": "src/badge/Badge.ts"
715
+ "name": "Banner",
716
+ "module": "src/banner/Banner.ts"
740
717
  }
741
718
  }
742
719
  ]
@@ -1332,52 +1309,78 @@
1332
1309
  },
1333
1310
  {
1334
1311
  "kind": "javascript-module",
1335
- "path": "src/banner/Banner.ts",
1312
+ "path": "src/button-group/ButtonGroup.ts",
1336
1313
  "declarations": [
1337
1314
  {
1338
1315
  "kind": "class",
1339
- "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.",
1340
- "name": "Banner",
1316
+ "description": "Button groups are designed to bring together button controls that are of a similar nature. For example text formatting controls.",
1317
+ "name": "ButtonGroup",
1341
1318
  "cssProperties": [
1342
1319
  {
1343
- "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
1344
- "name": "--n-banner-border-radius",
1345
- "default": "var(--n-border-radius)"
1320
+ "description": "Controls the rounded corners of the button, using [border radius tokens](/tokens/#border-radius).",
1321
+ "name": "--n-button-group-border-radius",
1322
+ "default": "var(--n-border-radius-s)"
1346
1323
  },
1347
1324
  {
1348
1325
  "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
1349
- "name": "--n-banner-box-shadow",
1350
- "default": "var(--n-box-shadow-card)"
1326
+ "name": "--n-button-group-box-shadow",
1327
+ "default": "var(--n-box-shadow)"
1351
1328
  }
1352
1329
  ],
1353
1330
  "slots": [
1354
1331
  {
1355
- "description": "default slot",
1332
+ "description": "The button group content",
1356
1333
  "name": ""
1357
1334
  }
1358
1335
  ],
1359
1336
  "members": [
1360
1337
  {
1361
1338
  "kind": "field",
1362
- "name": "variant",
1339
+ "name": "dirController",
1340
+ "privacy": "private",
1341
+ "default": "new DirectionController(this)"
1342
+ },
1343
+ {
1344
+ "kind": "field",
1345
+ "name": "direction",
1363
1346
  "type": {
1364
- "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
1347
+ "text": "\"vertical\" | \"horizontal\""
1365
1348
  },
1366
- "default": "\"info\"",
1367
- "description": "The style variant of the banner.",
1368
- "attribute": "variant",
1349
+ "default": "\"horizontal\"",
1350
+ "description": "The direction of the button group.",
1351
+ "attribute": "direction",
1352
+ "reflects": true
1353
+ },
1354
+ {
1355
+ "kind": "field",
1356
+ "name": "role",
1357
+ "type": {
1358
+ "text": "string"
1359
+ },
1360
+ "default": "\"group\"",
1361
+ "description": "The appropriate role for the containing element.",
1362
+ "attribute": "role",
1369
1363
  "reflects": true
1370
1364
  }
1371
1365
  ],
1372
1366
  "attributes": [
1373
1367
  {
1374
- "name": "variant",
1368
+ "name": "direction",
1375
1369
  "type": {
1376
- "text": "\"info\" | \"danger\" | \"success\" | \"warning\""
1370
+ "text": "\"vertical\" | \"horizontal\""
1377
1371
  },
1378
- "default": "\"info\"",
1379
- "description": "The style variant of the banner.",
1380
- "fieldName": "variant"
1372
+ "default": "\"horizontal\"",
1373
+ "description": "The direction of the button group.",
1374
+ "fieldName": "direction"
1375
+ },
1376
+ {
1377
+ "name": "role",
1378
+ "type": {
1379
+ "text": "string"
1380
+ },
1381
+ "default": "\"group\"",
1382
+ "description": "The appropriate role for the containing element.",
1383
+ "fieldName": "role"
1381
1384
  }
1382
1385
  ],
1383
1386
  "superclass": {
@@ -1385,14 +1388,12 @@
1385
1388
  "package": "lit"
1386
1389
  },
1387
1390
  "localization": [],
1388
- "status": "ready",
1389
- "category": "feedback",
1390
- "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",
1391
+ "status": "new",
1392
+ "category": "structure",
1393
+ "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 labels should be clear, accurate and predictable. It should be possible for the user to understand what will happen when they click a button:\n\n<div class=\"n-usage n-usage-do\">View user settings</div>\n<div class=\"n-usage n-usage-dont\">Click here</div>\n\nWhen writing button 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 button labels, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Add item</div>\n<div class=\"n-usage n-usage-dont\">Add an item</div>\n",
1391
1394
  "examples": [],
1392
- "dependencies": [
1393
- "icon"
1394
- ],
1395
- "tagName": "nord-banner",
1395
+ "dependencies": [],
1396
+ "tagName": "nord-button-group",
1396
1397
  "customElement": true
1397
1398
  }
1398
1399
  ],
@@ -1401,16 +1402,16 @@
1401
1402
  "kind": "js",
1402
1403
  "name": "default",
1403
1404
  "declaration": {
1404
- "name": "Banner",
1405
- "module": "src/banner/Banner.ts"
1405
+ "name": "ButtonGroup",
1406
+ "module": "src/button-group/ButtonGroup.ts"
1406
1407
  }
1407
1408
  },
1408
1409
  {
1409
1410
  "kind": "custom-element-definition",
1410
- "name": "nord-banner",
1411
+ "name": "nord-button-group",
1411
1412
  "declaration": {
1412
- "name": "Banner",
1413
- "module": "src/banner/Banner.ts"
1413
+ "name": "ButtonGroup",
1414
+ "module": "src/button-group/ButtonGroup.ts"
1414
1415
  }
1415
1416
  }
1416
1417
  ]
@@ -1920,78 +1921,92 @@
1920
1921
  },
1921
1922
  {
1922
1923
  "kind": "javascript-module",
1923
- "path": "src/button-group/ButtonGroup.ts",
1924
+ "path": "src/card/Card.ts",
1924
1925
  "declarations": [
1925
1926
  {
1926
1927
  "kind": "class",
1927
- "description": "Button groups are designed to bring together button controls that are of a similar nature. For example text formatting controls.",
1928
- "name": "ButtonGroup",
1928
+ "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.",
1929
+ "name": "Card",
1929
1930
  "cssProperties": [
1930
1931
  {
1931
- "description": "Controls the rounded corners of the button, using [border radius tokens](/tokens/#border-radius).",
1932
- "name": "--n-button-group-border-radius",
1933
- "default": "var(--n-border-radius-s)"
1932
+ "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
1933
+ "name": "--n-card-border-radius",
1934
+ "default": "var(--n-border-radius)"
1934
1935
  },
1935
1936
  {
1936
1937
  "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
1937
- "name": "--n-button-group-box-shadow",
1938
- "default": "var(--n-box-shadow)"
1938
+ "name": "--n-card-box-shadow",
1939
+ "default": "var(--n-box-shadow-popout)"
1940
+ },
1941
+ {
1942
+ "description": "Controls the padding on all sides of the card.",
1943
+ "name": "--n-card-padding",
1944
+ "default": "var(--n-space-m)"
1945
+ },
1946
+ {
1947
+ "description": "Controls the padding of items slotted within the card. This does not affect the block padding of items slotted into the header.",
1948
+ "name": "--n-card-slot-padding",
1949
+ "default": "var(--n-space-m)"
1939
1950
  }
1940
1951
  ],
1941
1952
  "slots": [
1942
1953
  {
1943
- "description": "The button group content",
1954
+ "description": "The card content.",
1944
1955
  "name": ""
1956
+ },
1957
+ {
1958
+ "description": "Optional slot that holds a header for the card.",
1959
+ "name": "header"
1960
+ },
1961
+ {
1962
+ "description": "Optional slot that positions content at the end of the header. Useful for actions or additional info.",
1963
+ "name": "header-end"
1964
+ },
1965
+ {
1966
+ "description": "Optional slot that holds footer content for the card.",
1967
+ "name": "footer"
1945
1968
  }
1946
1969
  ],
1947
1970
  "members": [
1948
1971
  {
1949
1972
  "kind": "field",
1950
- "name": "dirController",
1973
+ "name": "headerSlot",
1951
1974
  "privacy": "private",
1952
- "default": "new DirectionController(this)"
1975
+ "default": "new SlotController(this, \"header\")"
1953
1976
  },
1954
1977
  {
1955
1978
  "kind": "field",
1956
- "name": "direction",
1957
- "type": {
1958
- "text": "\"vertical\" | \"horizontal\""
1959
- },
1960
- "default": "\"horizontal\"",
1961
- "description": "The direction of the button group.",
1962
- "attribute": "direction",
1963
- "reflects": true
1979
+ "name": "headerEndSlot",
1980
+ "privacy": "private",
1981
+ "default": "new SlotController(this, \"header-end\")"
1964
1982
  },
1965
1983
  {
1966
1984
  "kind": "field",
1967
- "name": "role",
1985
+ "name": "footerSlot",
1986
+ "privacy": "private",
1987
+ "default": "new SlotController(this, \"footer\")"
1988
+ },
1989
+ {
1990
+ "kind": "field",
1991
+ "name": "padding",
1968
1992
  "type": {
1969
- "text": "string"
1993
+ "text": "\"m\" | \"l\" | \"none\""
1970
1994
  },
1971
- "default": "\"group\"",
1972
- "description": "The appropriate role for the containing element.",
1973
- "attribute": "role",
1995
+ "default": "\"m\"",
1996
+ "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
1997
+ "attribute": "padding",
1974
1998
  "reflects": true
1975
1999
  }
1976
2000
  ],
1977
2001
  "attributes": [
1978
2002
  {
1979
- "name": "direction",
2003
+ "name": "padding",
1980
2004
  "type": {
1981
- "text": "\"vertical\" | \"horizontal\""
1982
- },
1983
- "default": "\"horizontal\"",
1984
- "description": "The direction of the button group.",
1985
- "fieldName": "direction"
1986
- },
1987
- {
1988
- "name": "role",
1989
- "type": {
1990
- "text": "string"
2005
+ "text": "\"m\" | \"l\" | \"none\""
1991
2006
  },
1992
- "default": "\"group\"",
1993
- "description": "The appropriate role for the containing element.",
1994
- "fieldName": "role"
2007
+ "default": "\"m\"",
2008
+ "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
2009
+ "fieldName": "padding"
1995
2010
  }
1996
2011
  ],
1997
2012
  "superclass": {
@@ -1999,12 +2014,12 @@
1999
2014
  "package": "lit"
2000
2015
  },
2001
2016
  "localization": [],
2002
- "status": "new",
2017
+ "status": "ready",
2003
2018
  "category": "structure",
2004
- "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 labels should be clear, accurate and predictable. It should be possible for the user to understand what will happen when they click a button:\n\n<div class=\"n-usage n-usage-do\">View user settings</div>\n<div class=\"n-usage n-usage-dont\">Click here</div>\n\nWhen writing button 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 button labels, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Add item</div>\n<div class=\"n-usage n-usage-dont\">Add an item</div>\n",
2019
+ "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",
2005
2020
  "examples": [],
2006
2021
  "dependencies": [],
2007
- "tagName": "nord-button-group",
2022
+ "tagName": "nord-card",
2008
2023
  "customElement": true
2009
2024
  }
2010
2025
  ],
@@ -2013,108 +2028,98 @@
2013
2028
  "kind": "js",
2014
2029
  "name": "default",
2015
2030
  "declaration": {
2016
- "name": "ButtonGroup",
2017
- "module": "src/button-group/ButtonGroup.ts"
2031
+ "name": "Card",
2032
+ "module": "src/card/Card.ts"
2018
2033
  }
2019
2034
  },
2020
2035
  {
2021
2036
  "kind": "custom-element-definition",
2022
- "name": "nord-button-group",
2037
+ "name": "nord-card",
2023
2038
  "declaration": {
2024
- "name": "ButtonGroup",
2025
- "module": "src/button-group/ButtonGroup.ts"
2039
+ "name": "Card",
2040
+ "module": "src/card/Card.ts"
2026
2041
  }
2027
2042
  }
2028
2043
  ]
2029
2044
  },
2030
2045
  {
2031
2046
  "kind": "javascript-module",
2032
- "path": "src/card/Card.ts",
2047
+ "path": "src/badge/Badge.ts",
2033
2048
  "declarations": [
2034
2049
  {
2035
2050
  "kind": "class",
2036
- "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.",
2037
- "name": "Card",
2038
- "cssProperties": [
2039
- {
2040
- "description": "Controls how rounded the corners are, using [border radius tokens](/tokens/#border-radius).",
2041
- "name": "--n-card-border-radius",
2042
- "default": "var(--n-border-radius)"
2043
- },
2044
- {
2045
- "description": "Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow).",
2046
- "name": "--n-card-box-shadow",
2047
- "default": "var(--n-box-shadow-popout)"
2048
- },
2049
- {
2050
- "description": "Controls the padding on all sides of the card.",
2051
- "name": "--n-card-padding",
2052
- "default": "var(--n-space-m)"
2053
- },
2054
- {
2055
- "description": "Controls the padding of items slotted within the card. This does not affect the block padding of items slotted into the header.",
2056
- "name": "--n-card-slot-padding",
2057
- "default": "var(--n-space-m)"
2058
- }
2059
- ],
2051
+ "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.",
2052
+ "name": "Badge",
2060
2053
  "slots": [
2061
2054
  {
2062
- "description": "The card content.",
2055
+ "description": "The badge content.",
2063
2056
  "name": ""
2064
2057
  },
2065
2058
  {
2066
- "description": "Optional slot that holds a header for the card.",
2067
- "name": "header"
2068
- },
2069
- {
2070
- "description": "Optional slot that positions content at the end of the header. Useful for actions or additional info.",
2071
- "name": "header-end"
2072
- },
2073
- {
2074
- "description": "Optional slot that holds footer content for the card.",
2075
- "name": "footer"
2059
+ "description": "Used to place an icon at the start of badge.",
2060
+ "name": "icon"
2076
2061
  }
2077
2062
  ],
2078
2063
  "members": [
2079
2064
  {
2080
2065
  "kind": "field",
2081
- "name": "headerSlot",
2082
- "privacy": "private",
2083
- "default": "new SlotController(this, \"header\")"
2084
- },
2085
- {
2086
- "kind": "field",
2087
- "name": "headerEndSlot",
2088
- "privacy": "private",
2089
- "default": "new SlotController(this, \"header-end\")"
2066
+ "name": "type",
2067
+ "type": {
2068
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
2069
+ },
2070
+ "description": "The type of badge.\nDetermines the background color of the badge.",
2071
+ "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
2072
+ "attribute": "type",
2073
+ "reflects": true
2090
2074
  },
2091
2075
  {
2092
2076
  "kind": "field",
2093
- "name": "footerSlot",
2094
- "privacy": "private",
2095
- "default": "new SlotController(this, \"footer\")"
2077
+ "name": "variant",
2078
+ "type": {
2079
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
2080
+ },
2081
+ "description": "The style variant of the badge.\nDetermines the background color of the badge.",
2082
+ "attribute": "variant",
2083
+ "reflects": true
2096
2084
  },
2097
2085
  {
2098
2086
  "kind": "field",
2099
- "name": "padding",
2087
+ "name": "strong",
2100
2088
  "type": {
2101
- "text": "\"m\" | \"l\" | \"none\""
2089
+ "text": "boolean"
2102
2090
  },
2103
- "default": "\"m\"",
2104
- "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
2105
- "attribute": "padding",
2091
+ "default": "false",
2092
+ "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
2093
+ "attribute": "strong",
2106
2094
  "reflects": true
2107
2095
  }
2108
2096
  ],
2109
2097
  "attributes": [
2110
2098
  {
2111
- "name": "padding",
2099
+ "name": "type",
2112
2100
  "type": {
2113
- "text": "\"m\" | \"l\" | \"none\""
2101
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"info\" | \"neutral\" | \"progress\" | undefined"
2114
2102
  },
2115
- "default": "\"m\"",
2116
- "description": "Controls the padding of the card component. When set to “none”,\nthe header and footer slots will still have padding.",
2117
- "fieldName": "padding"
2103
+ "description": "The type of badge.\nDetermines the background color of the badge.",
2104
+ "deprecated": "Use `variant` instead. If you previously used `\"progress\"`, use `\"info\"` instead.",
2105
+ "fieldName": "type"
2106
+ },
2107
+ {
2108
+ "name": "variant",
2109
+ "type": {
2110
+ "text": "\"warning\" | \"success\" | \"danger\" | \"highlight\" | \"neutral\" | \"info\" | undefined"
2111
+ },
2112
+ "description": "The style variant of the badge.\nDetermines the background color of the badge.",
2113
+ "fieldName": "variant"
2114
+ },
2115
+ {
2116
+ "name": "strong",
2117
+ "type": {
2118
+ "text": "boolean"
2119
+ },
2120
+ "default": "false",
2121
+ "description": "Strong badges are a secondary style for badges.\nThey provide more visual prominence and emphasize them.",
2122
+ "fieldName": "strong"
2118
2123
  }
2119
2124
  ],
2120
2125
  "superclass": {
@@ -2123,11 +2128,11 @@
2123
2128
  },
2124
2129
  "localization": [],
2125
2130
  "status": "ready",
2126
- "category": "structure",
2127
- "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",
2131
+ "category": "text",
2132
+ "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",
2128
2133
  "examples": [],
2129
2134
  "dependencies": [],
2130
- "tagName": "nord-card",
2135
+ "tagName": "nord-badge",
2131
2136
  "customElement": true
2132
2137
  }
2133
2138
  ],
@@ -2136,16 +2141,16 @@
2136
2141
  "kind": "js",
2137
2142
  "name": "default",
2138
2143
  "declaration": {
2139
- "name": "Card",
2140
- "module": "src/card/Card.ts"
2144
+ "name": "Badge",
2145
+ "module": "src/badge/Badge.ts"
2141
2146
  }
2142
2147
  },
2143
2148
  {
2144
2149
  "kind": "custom-element-definition",
2145
- "name": "nord-card",
2150
+ "name": "nord-badge",
2146
2151
  "declaration": {
2147
- "name": "Card",
2148
- "module": "src/card/Card.ts"
2152
+ "name": "Badge",
2153
+ "module": "src/badge/Badge.ts"
2149
2154
  }
2150
2155
  }
2151
2156
  ]
@@ -5956,6 +5961,74 @@
5956
5961
  }
5957
5962
  ]
5958
5963
  },
5964
+ {
5965
+ "kind": "javascript-module",
5966
+ "path": "src/dropdown-group/DropdownGroup.ts",
5967
+ "declarations": [
5968
+ {
5969
+ "kind": "class",
5970
+ "description": "Dropdown group includes all the actions or items in a single dropdown\ngroup and is used for grouping items into related categories.",
5971
+ "name": "DropdownGroup",
5972
+ "slots": [
5973
+ {
5974
+ "description": "The dropdown group content.",
5975
+ "name": ""
5976
+ }
5977
+ ],
5978
+ "members": [
5979
+ {
5980
+ "kind": "field",
5981
+ "name": "heading",
5982
+ "type": {
5983
+ "text": "string | undefined"
5984
+ },
5985
+ "description": "Heading and accessible label for the dropdown group.",
5986
+ "attribute": "heading"
5987
+ }
5988
+ ],
5989
+ "attributes": [
5990
+ {
5991
+ "name": "heading",
5992
+ "type": {
5993
+ "text": "string | undefined"
5994
+ },
5995
+ "description": "Heading and accessible label for the dropdown group.",
5996
+ "fieldName": "heading"
5997
+ }
5998
+ ],
5999
+ "superclass": {
6000
+ "name": "LitElement",
6001
+ "package": "lit"
6002
+ },
6003
+ "localization": [],
6004
+ "status": "ready",
6005
+ "category": "action",
6006
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Group dropdown items into dropdown groups based on related categories.\n- Use group headings to clarify the category of a section.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for grouping other types of content.\n\n</div>\n\n---\n\n## Content guidelines\n\nDropdown items should be always written in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Create user</div>\n<div class=\"n-usage n-usage-dont\">Create User</div>\n\nDropdown items should always lead with a strong verb that encourages action. Use the `{verb}+{noun}` format except in the case of common actions like Save, Close or Cancel:\n\n<div class=\"n-usage n-usage-do\">Edit row</div>\n<div class=\"n-usage n-usage-dont\">Editing options</div>\n\nAvoid unnecessary words and articles in dropdown items, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme</div>\n\nAvoid ending dropdown items in punctuation:\n\n<div class=\"n-usage n-usage-do\">Switch user</div>\n<div class=\"n-usage n-usage-dont\">Switch user.</div>\n\nAvoid all caps for dropdown items:\n\n<div class=\"n-usage n-usage-do\">Rename</div>\n<div class=\"n-usage n-usage-dont\">RENAME</div>\n\nKeep dropdown items to a single line of text:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme<br/>of the veterinary application.</div>\n",
6007
+ "examples": [],
6008
+ "dependencies": [],
6009
+ "tagName": "nord-dropdown-group",
6010
+ "customElement": true
6011
+ }
6012
+ ],
6013
+ "exports": [
6014
+ {
6015
+ "kind": "js",
6016
+ "name": "default",
6017
+ "declaration": {
6018
+ "name": "DropdownGroup",
6019
+ "module": "src/dropdown-group/DropdownGroup.ts"
6020
+ }
6021
+ },
6022
+ {
6023
+ "kind": "custom-element-definition",
6024
+ "name": "nord-dropdown-group",
6025
+ "declaration": {
6026
+ "name": "DropdownGroup",
6027
+ "module": "src/dropdown-group/DropdownGroup.ts"
6028
+ }
6029
+ }
6030
+ ]
6031
+ },
5959
6032
  {
5960
6033
  "kind": "javascript-module",
5961
6034
  "path": "src/drawer/Drawer.ts",
@@ -6338,110 +6411,42 @@
6338
6411
  },
6339
6412
  {
6340
6413
  "kind": "javascript-module",
6341
- "path": "src/dropdown-group/DropdownGroup.ts",
6414
+ "path": "src/dropdown-item/DropdownItem.ts",
6342
6415
  "declarations": [
6343
6416
  {
6344
6417
  "kind": "class",
6345
- "description": "Dropdown group includes all the actions or items in a single dropdown\ngroup and is used for grouping items into related categories.",
6346
- "name": "DropdownGroup",
6418
+ "description": "Dropdown item populates dropdown with actions. Items can be\nplaced either inside a dropdown group or directly inside a\ndropdown component.",
6419
+ "name": "DropdownItem",
6347
6420
  "slots": [
6348
6421
  {
6349
- "description": "The dropdown group content.",
6422
+ "description": "The dropdown item content.",
6350
6423
  "name": ""
6424
+ },
6425
+ {
6426
+ "description": "Used to place content before dropdown item text. Typically used for icons.",
6427
+ "name": "start"
6428
+ },
6429
+ {
6430
+ "description": "Used to place content after dropdown item text. Typically used for icons.",
6431
+ "name": "end"
6351
6432
  }
6352
6433
  ],
6353
6434
  "members": [
6354
6435
  {
6355
6436
  "kind": "field",
6356
- "name": "heading",
6437
+ "name": "href",
6357
6438
  "type": {
6358
6439
  "text": "string | undefined"
6359
6440
  },
6360
- "description": "Heading and accessible label for the dropdown group.",
6361
- "attribute": "heading"
6362
- }
6363
- ],
6364
- "attributes": [
6441
+ "description": "The url the dropdown item should link to.",
6442
+ "attribute": "href",
6443
+ "reflects": true
6444
+ },
6365
6445
  {
6366
- "name": "heading",
6446
+ "kind": "field",
6447
+ "name": "target",
6367
6448
  "type": {
6368
- "text": "string | undefined"
6369
- },
6370
- "description": "Heading and accessible label for the dropdown group.",
6371
- "fieldName": "heading"
6372
- }
6373
- ],
6374
- "superclass": {
6375
- "name": "LitElement",
6376
- "package": "lit"
6377
- },
6378
- "localization": [],
6379
- "status": "ready",
6380
- "category": "action",
6381
- "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Group dropdown items into dropdown groups based on related categories.\n- Use group headings to clarify the category of a section.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for grouping other types of content.\n\n</div>\n\n---\n\n## Content guidelines\n\nDropdown items should be always written in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):\n\n<div class=\"n-usage n-usage-do\">Create user</div>\n<div class=\"n-usage n-usage-dont\">Create User</div>\n\nDropdown items should always lead with a strong verb that encourages action. Use the `{verb}+{noun}` format except in the case of common actions like Save, Close or Cancel:\n\n<div class=\"n-usage n-usage-do\">Edit row</div>\n<div class=\"n-usage n-usage-dont\">Editing options</div>\n\nAvoid unnecessary words and articles in dropdown items, such as “the”, “an” or “a”:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme</div>\n\nAvoid ending dropdown items in punctuation:\n\n<div class=\"n-usage n-usage-do\">Switch user</div>\n<div class=\"n-usage n-usage-dont\">Switch user.</div>\n\nAvoid all caps for dropdown items:\n\n<div class=\"n-usage n-usage-do\">Rename</div>\n<div class=\"n-usage n-usage-dont\">RENAME</div>\n\nKeep dropdown items to a single line of text:\n\n<div class=\"n-usage n-usage-do\">Change theme</div>\n<div class=\"n-usage n-usage-dont\">Change the theme<br/>of the veterinary application.</div>\n",
6382
- "examples": [],
6383
- "dependencies": [],
6384
- "tagName": "nord-dropdown-group",
6385
- "customElement": true
6386
- }
6387
- ],
6388
- "exports": [
6389
- {
6390
- "kind": "js",
6391
- "name": "default",
6392
- "declaration": {
6393
- "name": "DropdownGroup",
6394
- "module": "src/dropdown-group/DropdownGroup.ts"
6395
- }
6396
- },
6397
- {
6398
- "kind": "custom-element-definition",
6399
- "name": "nord-dropdown-group",
6400
- "declaration": {
6401
- "name": "DropdownGroup",
6402
- "module": "src/dropdown-group/DropdownGroup.ts"
6403
- }
6404
- }
6405
- ]
6406
- },
6407
- {
6408
- "kind": "javascript-module",
6409
- "path": "src/dropdown-item/DropdownItem.ts",
6410
- "declarations": [
6411
- {
6412
- "kind": "class",
6413
- "description": "Dropdown item populates dropdown with actions. Items can be\nplaced either inside a dropdown group or directly inside a\ndropdown component.",
6414
- "name": "DropdownItem",
6415
- "slots": [
6416
- {
6417
- "description": "The dropdown item content.",
6418
- "name": ""
6419
- },
6420
- {
6421
- "description": "Used to place content before dropdown item text. Typically used for icons.",
6422
- "name": "start"
6423
- },
6424
- {
6425
- "description": "Used to place content after dropdown item text. Typically used for icons.",
6426
- "name": "end"
6427
- }
6428
- ],
6429
- "members": [
6430
- {
6431
- "kind": "field",
6432
- "name": "href",
6433
- "type": {
6434
- "text": "string | undefined"
6435
- },
6436
- "description": "The url the dropdown item should link to.",
6437
- "attribute": "href",
6438
- "reflects": true
6439
- },
6440
- {
6441
- "kind": "field",
6442
- "name": "target",
6443
- "type": {
6444
- "text": "\"_self\" | \"_blank\" | \"_parent\" | \"_top\""
6449
+ "text": "\"_self\" | \"_blank\" | \"_parent\" | \"_top\""
6445
6450
  },
6446
6451
  "default": "\"_self\"",
6447
6452
  "description": "When provided together with a href property, determines where\nto open the linked URL. The keywords have special meanings for\nwhere to load the URL: “_self” means the current browsing context,\n“_blank” usually a new tab but users can configure browsers this to\nopen a new window instead, “_parent” means the parent browsing\ncontext of the current one, but if no parent exists, behaves as\n_self, and finally “top” means the topmost browsing context.",
@@ -6600,6 +6605,87 @@
6600
6605
  }
6601
6606
  ]
6602
6607
  },
6608
+ {
6609
+ "kind": "javascript-module",
6610
+ "path": "src/header/Header.ts",
6611
+ "declarations": [
6612
+ {
6613
+ "kind": "class",
6614
+ "description": "The header is a block of designated space for labelling the currently\nviewed context as well as providing primary actions.",
6615
+ "name": "Header",
6616
+ "slots": [
6617
+ {
6618
+ "description": "The header content.",
6619
+ "name": ""
6620
+ },
6621
+ {
6622
+ "description": "Optional slot for buttons, toggles, etc.",
6623
+ "name": "end"
6624
+ }
6625
+ ],
6626
+ "members": [
6627
+ {
6628
+ "kind": "field",
6629
+ "name": "endSlot",
6630
+ "privacy": "private",
6631
+ "default": "new SlotController(this, \"end\")"
6632
+ },
6633
+ {
6634
+ "kind": "field",
6635
+ "name": "size",
6636
+ "type": {
6637
+ "text": "\"m\" | \"s\""
6638
+ },
6639
+ "default": "\"m\"",
6640
+ "description": "Controls the size of the header component.",
6641
+ "attribute": "size",
6642
+ "reflects": true
6643
+ }
6644
+ ],
6645
+ "attributes": [
6646
+ {
6647
+ "name": "size",
6648
+ "type": {
6649
+ "text": "\"m\" | \"s\""
6650
+ },
6651
+ "default": "\"m\"",
6652
+ "description": "Controls the size of the header component.",
6653
+ "fieldName": "size"
6654
+ }
6655
+ ],
6656
+ "superclass": {
6657
+ "name": "LitElement",
6658
+ "package": "lit"
6659
+ },
6660
+ "localization": [],
6661
+ "status": "ready",
6662
+ "category": "structure",
6663
+ "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 header component to show a heading to describe the current view.\n- Use the header component to hold primary actions.\n- Use the header component at a visual high position at full width.\n- Utilise the [`n-truncate`](/css/#miscellaneous-utilities) CSS helper to prevent long headings from wrapping.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t overcrowd the header component with too many actions or information.\n- Don’t nest the header component too deeply and restrict its available space.\n- Don’t add large amounts of content or long headings. Aim for headings that are short and concise.\n\n</div>\n\n---\n\n## Content guidelines\n\nThe header component should be a containing element placed high on the page to present high level controls and to describe the page itself. It shouldn’t be overcrowded with controls or information.\n\n<div class=\"n-usage n-usage-do\">[Menu] Dashboard [Account] [Log out]</div>\n<div class=\"n-usage n-usage-dont\">[Menu] Use the cards below to view various information [Export] [Save] [Edit Profile] [Log out] [Preferences]</div>\n",
6664
+ "examples": [],
6665
+ "dependencies": [],
6666
+ "tagName": "nord-header",
6667
+ "customElement": true
6668
+ }
6669
+ ],
6670
+ "exports": [
6671
+ {
6672
+ "kind": "js",
6673
+ "name": "default",
6674
+ "declaration": {
6675
+ "name": "Header",
6676
+ "module": "src/header/Header.ts"
6677
+ }
6678
+ },
6679
+ {
6680
+ "kind": "custom-element-definition",
6681
+ "name": "nord-header",
6682
+ "declaration": {
6683
+ "name": "Header",
6684
+ "module": "src/header/Header.ts"
6685
+ }
6686
+ }
6687
+ ]
6688
+ },
6603
6689
  {
6604
6690
  "kind": "javascript-module",
6605
6691
  "path": "src/fieldset/Fieldset.ts",
@@ -6793,87 +6879,6 @@
6793
6879
  }
6794
6880
  ]
6795
6881
  },
6796
- {
6797
- "kind": "javascript-module",
6798
- "path": "src/header/Header.ts",
6799
- "declarations": [
6800
- {
6801
- "kind": "class",
6802
- "description": "The header is a block of designated space for labelling the currently\nviewed context as well as providing primary actions.",
6803
- "name": "Header",
6804
- "slots": [
6805
- {
6806
- "description": "The header content.",
6807
- "name": ""
6808
- },
6809
- {
6810
- "description": "Optional slot for buttons, toggles, etc.",
6811
- "name": "end"
6812
- }
6813
- ],
6814
- "members": [
6815
- {
6816
- "kind": "field",
6817
- "name": "endSlot",
6818
- "privacy": "private",
6819
- "default": "new SlotController(this, \"end\")"
6820
- },
6821
- {
6822
- "kind": "field",
6823
- "name": "size",
6824
- "type": {
6825
- "text": "\"m\" | \"s\""
6826
- },
6827
- "default": "\"m\"",
6828
- "description": "Controls the size of the header component.",
6829
- "attribute": "size",
6830
- "reflects": true
6831
- }
6832
- ],
6833
- "attributes": [
6834
- {
6835
- "name": "size",
6836
- "type": {
6837
- "text": "\"m\" | \"s\""
6838
- },
6839
- "default": "\"m\"",
6840
- "description": "Controls the size of the header component.",
6841
- "fieldName": "size"
6842
- }
6843
- ],
6844
- "superclass": {
6845
- "name": "LitElement",
6846
- "package": "lit"
6847
- },
6848
- "localization": [],
6849
- "status": "ready",
6850
- "category": "structure",
6851
- "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 header component to show a heading to describe the current view.\n- Use the header component to hold primary actions.\n- Use the header component at a visual high position at full width.\n- Utilise the [`n-truncate`](/css/#miscellaneous-utilities) CSS helper to prevent long headings from wrapping.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t overcrowd the header component with too many actions or information.\n- Don’t nest the header component too deeply and restrict its available space.\n- Don’t add large amounts of content or long headings. Aim for headings that are short and concise.\n\n</div>\n\n---\n\n## Content guidelines\n\nThe header component should be a containing element placed high on the page to present high level controls and to describe the page itself. It shouldn’t be overcrowded with controls or information.\n\n<div class=\"n-usage n-usage-do\">[Menu] Dashboard [Account] [Log out]</div>\n<div class=\"n-usage n-usage-dont\">[Menu] Use the cards below to view various information [Export] [Save] [Edit Profile] [Log out] [Preferences]</div>\n",
6852
- "examples": [],
6853
- "dependencies": [],
6854
- "tagName": "nord-header",
6855
- "customElement": true
6856
- }
6857
- ],
6858
- "exports": [
6859
- {
6860
- "kind": "js",
6861
- "name": "default",
6862
- "declaration": {
6863
- "name": "Header",
6864
- "module": "src/header/Header.ts"
6865
- }
6866
- },
6867
- {
6868
- "kind": "custom-element-definition",
6869
- "name": "nord-header",
6870
- "declaration": {
6871
- "name": "Header",
6872
- "module": "src/header/Header.ts"
6873
- }
6874
- }
6875
- ]
6876
- },
6877
6882
  {
6878
6883
  "kind": "javascript-module",
6879
6884
  "path": "src/icon/Icon.ts",
@@ -13444,183 +13449,27 @@
13444
13449
  },
13445
13450
  {
13446
13451
  "kind": "javascript-module",
13447
- "path": "src/stack/Stack.ts",
13452
+ "path": "src/tab/Tab.ts",
13448
13453
  "declarations": [
13449
13454
  {
13450
13455
  "kind": "class",
13451
- "description": "Stack component manages layout of immediate children along the\nvertical or horizontal axis with optional spacing between each child.",
13452
- "name": "Stack",
13456
+ "description": "The interactive tab button for use within the tab group component.",
13457
+ "name": "Tab",
13453
13458
  "cssProperties": [
13454
13459
  {
13455
- "description": "Controls the spacing between items, using our [spacing tokens](/tokens/#space).",
13456
- "name": "--n-stack-gap",
13457
- "default": "var(--n-space-m)"
13460
+ "description": "Controls the text color of the tab, using our [color tokens](/tokens/#color).",
13461
+ "name": "--n-tab-color",
13462
+ "default": "var(--n-color-text-weak)"
13463
+ },
13464
+ {
13465
+ "description": "Controls the font weight of the tab, using our [font tokens](/tokens/#font).",
13466
+ "name": "--n-tab-font-weight",
13467
+ "default": "var(--n-font-weight)"
13458
13468
  }
13459
13469
  ],
13460
13470
  "slots": [
13461
13471
  {
13462
- "description": "The stack content.",
13463
- "name": ""
13464
- }
13465
- ],
13466
- "members": [
13467
- {
13468
- "kind": "field",
13469
- "name": "gap",
13470
- "type": {
13471
- "text": "\"none\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\""
13472
- },
13473
- "default": "\"m\"",
13474
- "description": "The space injected between components.",
13475
- "attribute": "gap",
13476
- "reflects": true
13477
- },
13478
- {
13479
- "kind": "field",
13480
- "name": "direction",
13481
- "type": {
13482
- "text": "\"vertical\" | \"horizontal\""
13483
- },
13484
- "default": "\"vertical\"",
13485
- "description": "The direction of the stack.",
13486
- "attribute": "direction",
13487
- "reflects": true
13488
- },
13489
- {
13490
- "kind": "field",
13491
- "name": "alignItems",
13492
- "type": {
13493
- "text": "\"center\" | \"start\" | \"end\" | \"stretch\" | undefined"
13494
- },
13495
- "default": "\"stretch\"",
13496
- "description": "How to align the child items inside the stack.",
13497
- "attribute": "align-items",
13498
- "reflects": true
13499
- },
13500
- {
13501
- "kind": "field",
13502
- "name": "wrap",
13503
- "type": {
13504
- "text": "boolean"
13505
- },
13506
- "default": "false",
13507
- "description": "Defines whether the Stack items are forced in a single line\nor can be flowed into multiple lines.",
13508
- "attribute": "wrap",
13509
- "reflects": true
13510
- },
13511
- {
13512
- "kind": "field",
13513
- "name": "justifyContent",
13514
- "type": {
13515
- "text": "| \"center\"\n | \"start\"\n | \"end\"\n | \"baseline\"\n | \"space-between\"\n | \"space-around\"\n | \"space-evenly\" | undefined"
13516
- },
13517
- "description": "How to justify the child items inside the stack.",
13518
- "attribute": "justify-content",
13519
- "reflects": true
13520
- }
13521
- ],
13522
- "attributes": [
13523
- {
13524
- "name": "gap",
13525
- "type": {
13526
- "text": "\"none\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\""
13527
- },
13528
- "default": "\"m\"",
13529
- "description": "The space injected between components.",
13530
- "fieldName": "gap"
13531
- },
13532
- {
13533
- "name": "direction",
13534
- "type": {
13535
- "text": "\"vertical\" | \"horizontal\""
13536
- },
13537
- "default": "\"vertical\"",
13538
- "description": "The direction of the stack.",
13539
- "fieldName": "direction"
13540
- },
13541
- {
13542
- "name": "align-items",
13543
- "type": {
13544
- "text": "\"center\" | \"start\" | \"end\" | \"stretch\" | undefined"
13545
- },
13546
- "default": "\"stretch\"",
13547
- "description": "How to align the child items inside the stack.",
13548
- "fieldName": "alignItems"
13549
- },
13550
- {
13551
- "name": "wrap",
13552
- "type": {
13553
- "text": "boolean"
13554
- },
13555
- "default": "false",
13556
- "description": "Defines whether the Stack items are forced in a single line\nor can be flowed into multiple lines.",
13557
- "fieldName": "wrap"
13558
- },
13559
- {
13560
- "name": "justify-content",
13561
- "type": {
13562
- "text": "| \"center\"\n | \"start\"\n | \"end\"\n | \"baseline\"\n | \"space-between\"\n | \"space-around\"\n | \"space-evenly\" | undefined"
13563
- },
13564
- "description": "How to justify the child items inside the stack.",
13565
- "fieldName": "justifyContent"
13566
- }
13567
- ],
13568
- "superclass": {
13569
- "name": "LitElement",
13570
- "package": "lit"
13571
- },
13572
- "localization": [],
13573
- "status": "ready",
13574
- "category": "structure",
13575
- "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 when you need to stack multiple components vertically or horizontally.\n- Use when you want to adjust the white space between two or more components.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for building grid based layouts.\n\n</div>\n",
13576
- "examples": [],
13577
- "dependencies": [],
13578
- "tagName": "nord-stack",
13579
- "customElement": true
13580
- }
13581
- ],
13582
- "exports": [
13583
- {
13584
- "kind": "js",
13585
- "name": "default",
13586
- "declaration": {
13587
- "name": "Stack",
13588
- "module": "src/stack/Stack.ts"
13589
- }
13590
- },
13591
- {
13592
- "kind": "custom-element-definition",
13593
- "name": "nord-stack",
13594
- "declaration": {
13595
- "name": "Stack",
13596
- "module": "src/stack/Stack.ts"
13597
- }
13598
- }
13599
- ]
13600
- },
13601
- {
13602
- "kind": "javascript-module",
13603
- "path": "src/tab/Tab.ts",
13604
- "declarations": [
13605
- {
13606
- "kind": "class",
13607
- "description": "The interactive tab button for use within the tab group component.",
13608
- "name": "Tab",
13609
- "cssProperties": [
13610
- {
13611
- "description": "Controls the text color of the tab, using our [color tokens](/tokens/#color).",
13612
- "name": "--n-tab-color",
13613
- "default": "var(--n-color-text-weak)"
13614
- },
13615
- {
13616
- "description": "Controls the font weight of the tab, using our [font tokens](/tokens/#font).",
13617
- "name": "--n-tab-font-weight",
13618
- "default": "var(--n-font-weight)"
13619
- }
13620
- ],
13621
- "slots": [
13622
- {
13623
- "description": "The tab button content.",
13472
+ "description": "The tab button content.",
13624
13473
  "name": ""
13625
13474
  }
13626
13475
  ],
@@ -13939,6 +13788,162 @@
13939
13788
  }
13940
13789
  ]
13941
13790
  },
13791
+ {
13792
+ "kind": "javascript-module",
13793
+ "path": "src/stack/Stack.ts",
13794
+ "declarations": [
13795
+ {
13796
+ "kind": "class",
13797
+ "description": "Stack component manages layout of immediate children along the\nvertical or horizontal axis with optional spacing between each child.",
13798
+ "name": "Stack",
13799
+ "cssProperties": [
13800
+ {
13801
+ "description": "Controls the spacing between items, using our [spacing tokens](/tokens/#space).",
13802
+ "name": "--n-stack-gap",
13803
+ "default": "var(--n-space-m)"
13804
+ }
13805
+ ],
13806
+ "slots": [
13807
+ {
13808
+ "description": "The stack content.",
13809
+ "name": ""
13810
+ }
13811
+ ],
13812
+ "members": [
13813
+ {
13814
+ "kind": "field",
13815
+ "name": "gap",
13816
+ "type": {
13817
+ "text": "\"none\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\""
13818
+ },
13819
+ "default": "\"m\"",
13820
+ "description": "The space injected between components.",
13821
+ "attribute": "gap",
13822
+ "reflects": true
13823
+ },
13824
+ {
13825
+ "kind": "field",
13826
+ "name": "direction",
13827
+ "type": {
13828
+ "text": "\"vertical\" | \"horizontal\""
13829
+ },
13830
+ "default": "\"vertical\"",
13831
+ "description": "The direction of the stack.",
13832
+ "attribute": "direction",
13833
+ "reflects": true
13834
+ },
13835
+ {
13836
+ "kind": "field",
13837
+ "name": "alignItems",
13838
+ "type": {
13839
+ "text": "\"center\" | \"start\" | \"end\" | \"stretch\" | undefined"
13840
+ },
13841
+ "default": "\"stretch\"",
13842
+ "description": "How to align the child items inside the stack.",
13843
+ "attribute": "align-items",
13844
+ "reflects": true
13845
+ },
13846
+ {
13847
+ "kind": "field",
13848
+ "name": "wrap",
13849
+ "type": {
13850
+ "text": "boolean"
13851
+ },
13852
+ "default": "false",
13853
+ "description": "Defines whether the Stack items are forced in a single line\nor can be flowed into multiple lines.",
13854
+ "attribute": "wrap",
13855
+ "reflects": true
13856
+ },
13857
+ {
13858
+ "kind": "field",
13859
+ "name": "justifyContent",
13860
+ "type": {
13861
+ "text": "| \"center\"\n | \"start\"\n | \"end\"\n | \"baseline\"\n | \"space-between\"\n | \"space-around\"\n | \"space-evenly\" | undefined"
13862
+ },
13863
+ "description": "How to justify the child items inside the stack.",
13864
+ "attribute": "justify-content",
13865
+ "reflects": true
13866
+ }
13867
+ ],
13868
+ "attributes": [
13869
+ {
13870
+ "name": "gap",
13871
+ "type": {
13872
+ "text": "\"none\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"xxl\""
13873
+ },
13874
+ "default": "\"m\"",
13875
+ "description": "The space injected between components.",
13876
+ "fieldName": "gap"
13877
+ },
13878
+ {
13879
+ "name": "direction",
13880
+ "type": {
13881
+ "text": "\"vertical\" | \"horizontal\""
13882
+ },
13883
+ "default": "\"vertical\"",
13884
+ "description": "The direction of the stack.",
13885
+ "fieldName": "direction"
13886
+ },
13887
+ {
13888
+ "name": "align-items",
13889
+ "type": {
13890
+ "text": "\"center\" | \"start\" | \"end\" | \"stretch\" | undefined"
13891
+ },
13892
+ "default": "\"stretch\"",
13893
+ "description": "How to align the child items inside the stack.",
13894
+ "fieldName": "alignItems"
13895
+ },
13896
+ {
13897
+ "name": "wrap",
13898
+ "type": {
13899
+ "text": "boolean"
13900
+ },
13901
+ "default": "false",
13902
+ "description": "Defines whether the Stack items are forced in a single line\nor can be flowed into multiple lines.",
13903
+ "fieldName": "wrap"
13904
+ },
13905
+ {
13906
+ "name": "justify-content",
13907
+ "type": {
13908
+ "text": "| \"center\"\n | \"start\"\n | \"end\"\n | \"baseline\"\n | \"space-between\"\n | \"space-around\"\n | \"space-evenly\" | undefined"
13909
+ },
13910
+ "description": "How to justify the child items inside the stack.",
13911
+ "fieldName": "justifyContent"
13912
+ }
13913
+ ],
13914
+ "superclass": {
13915
+ "name": "LitElement",
13916
+ "package": "lit"
13917
+ },
13918
+ "localization": [],
13919
+ "status": "ready",
13920
+ "category": "structure",
13921
+ "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 when you need to stack multiple components vertically or horizontally.\n- Use when you want to adjust the white space between two or more components.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for building grid based layouts.\n\n</div>\n",
13922
+ "examples": [],
13923
+ "dependencies": [],
13924
+ "tagName": "nord-stack",
13925
+ "customElement": true
13926
+ }
13927
+ ],
13928
+ "exports": [
13929
+ {
13930
+ "kind": "js",
13931
+ "name": "default",
13932
+ "declaration": {
13933
+ "name": "Stack",
13934
+ "module": "src/stack/Stack.ts"
13935
+ }
13936
+ },
13937
+ {
13938
+ "kind": "custom-element-definition",
13939
+ "name": "nord-stack",
13940
+ "declaration": {
13941
+ "name": "Stack",
13942
+ "module": "src/stack/Stack.ts"
13943
+ }
13944
+ }
13945
+ ]
13946
+ },
13942
13947
  {
13943
13948
  "kind": "javascript-module",
13944
13949
  "path": "src/tab-panel/TabPanel.ts",