@nordhealth/components 1.0.0-beta.6 → 1.0.0-beta.7

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 (45) hide show
  1. package/custom-elements.json +1210 -987
  2. package/lib/Avatar.js +2 -0
  3. package/lib/Avatar.js.map +1 -0
  4. package/lib/Badge.js +1 -1
  5. package/lib/Banner.js +1 -1
  6. package/lib/Banner.js.map +1 -1
  7. package/lib/Button.js +1 -1
  8. package/lib/{Calendar-55a0b169.js → Calendar-90013fdb.js} +2 -2
  9. package/lib/{Calendar-55a0b169.js.map → Calendar-90013fdb.js.map} +1 -1
  10. package/lib/Calendar.js +1 -1
  11. package/lib/Card.js +1 -1
  12. package/lib/Checkbox.js +1 -1
  13. package/lib/CommandMenu.js +1 -1
  14. package/lib/CommandMenuAction.js +1 -1
  15. package/lib/Component-6762b5eb.js +2 -0
  16. package/lib/Component-6762b5eb.js.map +1 -0
  17. package/lib/DatePicker.js +1 -1
  18. package/lib/EmptyState.js +1 -1
  19. package/lib/Fieldset.js +1 -1
  20. package/lib/Fieldset.js.map +1 -1
  21. package/lib/FormAssociatedMixin-49b778dd.js +2 -0
  22. package/lib/{FormAssociatedMixin-e146e0ab.js.map → FormAssociatedMixin-49b778dd.js.map} +1 -1
  23. package/lib/Header.js +1 -1
  24. package/lib/Icon.js +1 -1
  25. package/lib/Input.js +1 -1
  26. package/lib/Input.js.map +1 -1
  27. package/lib/Layout.js +1 -1
  28. package/lib/NavGroup.js +1 -1
  29. package/lib/Radio.js +1 -1
  30. package/lib/Select.js +1 -1
  31. package/lib/Spinner.js +1 -1
  32. package/lib/Stack.js +1 -1
  33. package/lib/Textarea.js +1 -1
  34. package/lib/Tooltip.js +1 -1
  35. package/lib/bundle.js +3 -3
  36. package/lib/bundle.js.map +1 -1
  37. package/lib/index.js +1 -1
  38. package/lib/src/avatar/Avatar.d.ts +37 -0
  39. package/lib/src/avatar/Avatar.test.d.ts +1 -0
  40. package/lib/src/common/fsm.d.ts +5 -0
  41. package/lib/src/index.d.ts +1 -0
  42. package/package.json +2 -2
  43. package/lib/Component-a19be7c9.js +0 -2
  44. package/lib/Component-a19be7c9.js.map +0 -1
  45. package/lib/FormAssociatedMixin-e146e0ab.js +0 -2
@@ -214,9 +214,164 @@
214
214
  "name": "default",
215
215
  "module": "\"./banner/Banner.js\""
216
216
  }
217
+ },
218
+ {
219
+ "kind": "js",
220
+ "name": "Avatar",
221
+ "declaration": {
222
+ "name": "default",
223
+ "module": "\"./avatar/Avatar.js\""
224
+ }
217
225
  }
218
226
  ]
219
227
  },
228
+ {
229
+ "kind": "javascript-module",
230
+ "path": "src/avatar/Avatar.ts",
231
+ "declarations": [
232
+ {
233
+ "kind": "class",
234
+ "description": "Avatar is used for showing a thumbnail representation of a user or entity.\nDefault avatar illustration is displayed when no src is specified.",
235
+ "name": "Avatar",
236
+ "members": [
237
+ {
238
+ "kind": "field",
239
+ "name": "state",
240
+ "type": {
241
+ "text": "States"
242
+ },
243
+ "privacy": "private",
244
+ "default": "\"initial\""
245
+ },
246
+ {
247
+ "kind": "field",
248
+ "name": "size",
249
+ "type": {
250
+ "text": "\"m\" | \"l\" | \"xl\""
251
+ },
252
+ "default": "\"m\"",
253
+ "description": "The size of the avatar.",
254
+ "attribute": "size",
255
+ "reflects": true
256
+ },
257
+ {
258
+ "kind": "field",
259
+ "name": "src",
260
+ "type": {
261
+ "text": "string | undefined"
262
+ },
263
+ "description": "The URL of the avatar image uploaded by the user.",
264
+ "attribute": "src",
265
+ "reflects": true
266
+ },
267
+ {
268
+ "kind": "field",
269
+ "name": "name",
270
+ "type": {
271
+ "text": "string"
272
+ },
273
+ "default": "\"\"",
274
+ "description": "The name of the person.",
275
+ "attribute": "name"
276
+ },
277
+ {
278
+ "kind": "method",
279
+ "name": "renderImage",
280
+ "privacy": "protected"
281
+ },
282
+ {
283
+ "kind": "method",
284
+ "name": "renderFallback"
285
+ },
286
+ {
287
+ "kind": "method",
288
+ "name": "handleLoad",
289
+ "privacy": "private"
290
+ },
291
+ {
292
+ "kind": "method",
293
+ "name": "handleError",
294
+ "privacy": "private"
295
+ },
296
+ {
297
+ "kind": "field",
298
+ "name": "_warningLogged",
299
+ "type": {
300
+ "text": "boolean"
301
+ },
302
+ "privacy": "private",
303
+ "static": true,
304
+ "default": "false",
305
+ "inheritedFrom": {
306
+ "name": "DraftComponentMixin",
307
+ "module": "src/common/mixins/DraftComponentMixin.ts"
308
+ }
309
+ }
310
+ ],
311
+ "attributes": [
312
+ {
313
+ "name": "size",
314
+ "type": {
315
+ "text": "\"m\" | \"l\" | \"xl\""
316
+ },
317
+ "default": "\"m\"",
318
+ "description": "The size of the avatar.",
319
+ "fieldName": "size"
320
+ },
321
+ {
322
+ "name": "src",
323
+ "type": {
324
+ "text": "string | undefined"
325
+ },
326
+ "description": "The URL of the avatar image uploaded by the user.",
327
+ "fieldName": "src"
328
+ },
329
+ {
330
+ "name": "name",
331
+ "type": {
332
+ "text": "string"
333
+ },
334
+ "default": "\"\"",
335
+ "description": "The name of the person.",
336
+ "fieldName": "name"
337
+ }
338
+ ],
339
+ "mixins": [
340
+ {
341
+ "name": "DraftComponentMixin",
342
+ "module": "/src/common/mixins/DraftComponentMixin.js"
343
+ }
344
+ ],
345
+ "superclass": {
346
+ "name": "LitElement",
347
+ "package": "lit"
348
+ },
349
+ "status": "draft",
350
+ "category": "image",
351
+ "tagName": "nord-avatar",
352
+ "customElement": true
353
+ }
354
+ ],
355
+ "exports": [
356
+ {
357
+ "kind": "js",
358
+ "name": "default",
359
+ "declaration": {
360
+ "name": "Avatar",
361
+ "module": "src/avatar/Avatar.ts"
362
+ }
363
+ },
364
+ {
365
+ "kind": "custom-element-definition",
366
+ "name": "nord-avatar",
367
+ "declaration": {
368
+ "name": "Avatar",
369
+ "module": "src/avatar/Avatar.ts"
370
+ }
371
+ }
372
+ ],
373
+ "readme": "## Usage\n\nThis section includes guidelines for designers and developers about the usage of this component in different contexts.\n\n<div class=\"n-usage n-usage-do\">\n\n### Do\n\n- Always add the name of the person using the `name` property.\n- For the best results, use square images or images cropped into a square.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Try to avoid using landscape or portrait images as avatars. Let users crop their images before or after uploading if possible.\n\n</div>\n"
374
+ },
220
375
  {
221
376
  "kind": "javascript-module",
222
377
  "path": "src/badge/Badge.ts",
@@ -395,247 +550,275 @@
395
550
  },
396
551
  {
397
552
  "kind": "javascript-module",
398
- "path": "src/button/Button.ts",
553
+ "path": "src/calendar/Calendar.ts",
399
554
  "declarations": [
400
555
  {
401
556
  "kind": "class",
402
- "description": "Buttons are used for interface actions. Primary style should be\nused only once per section for main call-to-action, while other\nstyles can appear more frequently.",
403
- "name": "Button",
404
- "slots": [
557
+ "description": "Calendar allows user to pick a date. It comes with built-in\nfunctionality that allows you to set a minimum and a maximum allowed date.\nPlease note that the date must be passed in ISO-8601 format.",
558
+ "name": "Calendar",
559
+ "members": [
405
560
  {
406
- "description": "The button content",
407
- "name": ""
561
+ "kind": "field",
562
+ "name": "dialogLabelId",
563
+ "type": {
564
+ "text": "string"
565
+ },
566
+ "privacy": "private",
567
+ "default": "\"dialog-header\""
408
568
  },
409
569
  {
410
- "description": "Used to place content before button text. Typically used for icons.",
411
- "name": "before"
570
+ "kind": "field",
571
+ "name": "monthSelectNode",
572
+ "type": {
573
+ "text": "HTMLElement"
574
+ },
575
+ "privacy": "private"
412
576
  },
413
577
  {
414
- "description": "Used to place content after button text. Typically used for icons.",
415
- "name": "after"
416
- }
417
- ],
418
- "members": [
578
+ "kind": "field",
579
+ "name": "focusedDayNode",
580
+ "type": {
581
+ "text": "HTMLButtonElement"
582
+ },
583
+ "privacy": "private"
584
+ },
419
585
  {
420
586
  "kind": "field",
421
- "name": "buttonRef",
587
+ "name": "direction",
588
+ "privacy": "private",
589
+ "default": "new DirectionController(this)"
590
+ },
591
+ {
592
+ "kind": "field",
593
+ "name": "swipe",
594
+ "privacy": "private",
595
+ "default": "new SwipeController(this, {\n matchesGesture: isHorizontalSwipe,\n onSwipeEnd: ({ distX }) => this.addMonths(distX < 0 ? 1 : -1),\n })"
596
+ },
597
+ {
598
+ "kind": "field",
599
+ "name": "shortcuts",
422
600
  "privacy": "private"
423
601
  },
424
602
  {
425
603
  "kind": "field",
426
- "name": "lightDom",
604
+ "name": "dateFormatShort",
605
+ "type": {
606
+ "text": "Intl.DateTimeFormat"
607
+ },
427
608
  "privacy": "private",
428
- "default": "new LightDomController(this, {\n render: () => this.renderLightDom(),\n })"
609
+ "description": "Whilst dateAdapter is used for handling the formatting/parsing dates in the input,\nthese are used to format dates exclusively for the benefit of screen readers.\n\nWe prefer DateTimeFormat over date.toLocaleDateString, as the former has\nbetter performance when formatting large number of dates. See:\nhttps://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString#Performance"
429
610
  },
430
611
  {
431
612
  "kind": "field",
432
- "name": "variant",
613
+ "name": "localization",
433
614
  "type": {
434
- "text": "\"default\" | \"primary\" | \"dashed\" | \"plain\" | \"danger\""
615
+ "text": "CalendarLocalizedText"
435
616
  },
436
- "default": "\"default\"",
437
- "description": "The style variant of the button.",
438
- "attribute": "variant",
439
- "reflects": true
617
+ "default": "localization"
440
618
  },
441
619
  {
442
620
  "kind": "field",
443
- "name": "type",
621
+ "name": "value",
444
622
  "type": {
445
- "text": "\"button\" | \"submit\" | \"reset\""
623
+ "text": "string"
446
624
  },
447
- "default": "\"submit\"",
448
- "description": "The type of the button.",
449
- "attribute": "type",
450
- "reflects": true
625
+ "default": "\"\"",
626
+ "description": "The selected date on the calendar. Must be in IS0-8601 format: YYYY-MM-DD.",
627
+ "attribute": "value"
451
628
  },
452
629
  {
453
630
  "kind": "field",
454
- "name": "size",
631
+ "name": "firstDayOfWeek",
455
632
  "type": {
456
- "text": "\"s\" | \"m\" | \"l\""
633
+ "text": "DaysOfWeek"
457
634
  },
458
- "default": "\"m\"",
459
- "description": "The size of the button.\nThis affects font-size and padding.",
460
- "attribute": "size",
461
- "reflects": true
635
+ "description": "Which day is considered first day of the week? `0` for Sunday, `1` for Monday, etc.\nDefault is Monday.",
636
+ "attribute": "firstDayOfWeek"
462
637
  },
463
638
  {
464
639
  "kind": "field",
465
- "name": "href",
640
+ "name": "min",
466
641
  "type": {
467
- "text": "string | undefined"
642
+ "text": "string"
468
643
  },
469
- "description": "When provided, renders the button as a link,\nwith its href attribute set to the given value.",
470
- "attribute": "href",
471
- "reflects": true
644
+ "default": "\"\"",
645
+ "description": "Minimum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the max property.",
646
+ "attribute": "min"
472
647
  },
473
648
  {
474
649
  "kind": "field",
475
- "name": "download",
650
+ "name": "max",
476
651
  "type": {
477
- "text": "boolean"
652
+ "text": "string"
478
653
  },
479
- "default": "false",
480
- "description": "When provided together with a href property, the button will\ntrigger a file download instead of a page visit.",
481
- "attribute": "download"
654
+ "default": "\"\"",
655
+ "description": "Maximum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the min property.",
656
+ "attribute": "max"
482
657
  },
483
658
  {
484
659
  "kind": "field",
485
- "name": "target",
660
+ "name": "isDateDisabled",
486
661
  "type": {
487
- "text": "\"_self\" | \"_blank\" | \"_parent\" | \"_top\""
662
+ "text": "DateDisabledPredicate"
488
663
  },
489
- "default": "\"_self\"",
490
- "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.",
491
- "attribute": "target",
492
- "reflects": true
664
+ "default": "isDateDisabled",
665
+ "description": "Controls which days are disabled and therefore disallowed.\nFor example, this can be used to disallow selection of weekends."
493
666
  },
494
667
  {
495
668
  "kind": "field",
496
- "name": "expand",
669
+ "name": "activeFocus",
497
670
  "type": {
498
671
  "text": "boolean"
499
672
  },
500
- "default": "false",
501
- "description": "Controls whether the button expands to fill the width of its container.",
502
- "attribute": "expand",
503
- "reflects": true
673
+ "privacy": "private",
674
+ "default": "false"
504
675
  },
505
676
  {
506
- "kind": "method",
507
- "name": "renderLink",
677
+ "kind": "field",
678
+ "name": "focusedDay",
508
679
  "privacy": "private",
680
+ "default": "new Date()"
681
+ },
682
+ {
683
+ "kind": "method",
684
+ "name": "focus",
509
685
  "parameters": [
510
686
  {
511
- "name": "innards",
687
+ "name": "options",
688
+ "optional": true,
512
689
  "type": {
513
- "text": "TemplateResult"
690
+ "text": "FocusOptions & { target: \"day\" | \"month\" }"
514
691
  }
515
692
  }
516
- ],
517
- "description": "We jump through some hoops here to ensure the link is treated correctly when \"disabled\".\nLinks cannot be disabled natively, so we need to rely on some aria magic to get the correct semantics.\nAlong with the advice in the article below, we also set tabindex to \"-1\", so it is taken out of tab order."
693
+ ]
518
694
  },
519
695
  {
520
696
  "kind": "method",
521
- "name": "renderButton",
697
+ "name": "createDateFormatter",
698
+ "privacy": "private"
699
+ },
700
+ {
701
+ "kind": "field",
702
+ "name": "handleDaySelect",
703
+ "privacy": "private"
704
+ },
705
+ {
706
+ "kind": "method",
707
+ "name": "addDays",
522
708
  "privacy": "private",
523
709
  "parameters": [
524
710
  {
525
- "name": "innards",
711
+ "name": "days",
526
712
  "type": {
527
- "text": "TemplateResult"
713
+ "text": "number"
528
714
  }
529
715
  }
530
716
  ]
531
717
  },
532
718
  {
533
719
  "kind": "method",
534
- "name": "renderLightDom",
720
+ "name": "addMonths",
721
+ "privacy": "private",
722
+ "parameters": [
723
+ {
724
+ "name": "months",
725
+ "type": {
726
+ "text": "number"
727
+ }
728
+ }
729
+ ]
730
+ },
731
+ {
732
+ "kind": "method",
733
+ "name": "addYears",
734
+ "privacy": "private",
735
+ "parameters": [
736
+ {
737
+ "name": "years",
738
+ "type": {
739
+ "text": "number"
740
+ }
741
+ }
742
+ ]
743
+ },
744
+ {
745
+ "kind": "method",
746
+ "name": "startOfWeek",
535
747
  "privacy": "private"
536
748
  },
537
749
  {
538
750
  "kind": "method",
539
- "name": "handleClick",
751
+ "name": "endOfWeek",
540
752
  "privacy": "private"
541
753
  },
542
754
  {
543
- "kind": "field",
544
- "name": "disabled",
545
- "type": {
546
- "text": "boolean"
547
- },
548
- "default": "false",
549
- "description": "Makes the component disabled. This prevents users from\nbeing able to interact with the component, and conveys\nits inactive state to assistive technologies.",
550
- "attribute": "disabled",
551
- "reflects": true,
552
- "inheritedFrom": {
553
- "name": "InputMixin",
554
- "module": "src/common/mixins/InputMixin.ts"
555
- }
755
+ "kind": "method",
756
+ "name": "setMonth",
757
+ "privacy": "private",
758
+ "parameters": [
759
+ {
760
+ "name": "month",
761
+ "type": {
762
+ "text": "number"
763
+ }
764
+ }
765
+ ]
556
766
  },
557
767
  {
558
- "kind": "field",
559
- "name": "name",
560
- "type": {
561
- "text": "string | undefined"
562
- },
563
- "description": "The name of the form component.",
564
- "attribute": "name",
565
- "inheritedFrom": {
566
- "name": "InputMixin",
567
- "module": "src/common/mixins/InputMixin.ts"
568
- }
768
+ "kind": "method",
769
+ "name": "setYear",
770
+ "privacy": "private",
771
+ "parameters": [
772
+ {
773
+ "name": "year",
774
+ "type": {
775
+ "text": "number"
776
+ }
777
+ }
778
+ ]
779
+ },
780
+ {
781
+ "kind": "method",
782
+ "name": "setFocusedDay",
783
+ "privacy": "private",
784
+ "parameters": [
785
+ {
786
+ "name": "day",
787
+ "type": {
788
+ "text": "Date"
789
+ }
790
+ }
791
+ ]
569
792
  },
570
793
  {
571
794
  "kind": "field",
572
- "name": "value",
573
- "type": {
574
- "text": "string"
575
- },
576
- "default": "\"\"",
577
- "description": "The value of the form component.",
578
- "attribute": "value",
579
- "inheritedFrom": {
580
- "name": "InputMixin",
581
- "module": "src/common/mixins/InputMixin.ts"
582
- }
795
+ "name": "handleMonthSelect",
796
+ "privacy": "private"
583
797
  },
584
798
  {
585
799
  "kind": "field",
586
- "name": "form",
587
- "privacy": "protected",
588
- "description": "Gets the form, if any, associated with the form element.",
589
- "inheritedFrom": {
590
- "name": "InputMixin",
591
- "module": "src/common/mixins/InputMixin.ts"
592
- }
800
+ "name": "handleYearSelect",
801
+ "privacy": "private"
593
802
  },
594
803
  {
595
804
  "kind": "field",
596
- "name": "focusableRef",
597
- "privacy": "protected",
598
- "inheritedFrom": {
599
- "name": "FocusableMixin",
600
- "module": "src/common/mixins/FocusableMixin.ts"
601
- }
805
+ "name": "handleNextMonthClick",
806
+ "privacy": "private"
602
807
  },
603
808
  {
604
- "kind": "method",
605
- "name": "focus",
606
- "parameters": [
607
- {
608
- "name": "options",
609
- "optional": true,
610
- "type": {
611
- "text": "FocusOptions"
612
- },
613
- "description": "An object which controls aspects of the focusing process."
614
- }
615
- ],
616
- "description": "Programmatically move focus to the component.",
617
- "inheritedFrom": {
618
- "name": "FocusableMixin",
619
- "module": "src/common/mixins/FocusableMixin.ts"
620
- }
809
+ "kind": "field",
810
+ "name": "handlePreviousMonthClick",
811
+ "privacy": "private"
621
812
  },
622
813
  {
623
- "kind": "method",
624
- "name": "blur",
625
- "description": "Programmatically remove focus from the component.",
626
- "inheritedFrom": {
627
- "name": "FocusableMixin",
628
- "module": "src/common/mixins/FocusableMixin.ts"
629
- }
814
+ "kind": "field",
815
+ "name": "enableActiveFocus",
816
+ "privacy": "private"
630
817
  },
631
818
  {
632
- "kind": "method",
633
- "name": "click",
634
- "description": "Programmatically simulates a click on the component.",
635
- "inheritedFrom": {
636
- "name": "FocusableMixin",
637
- "module": "src/common/mixins/FocusableMixin.ts"
638
- }
819
+ "kind": "field",
820
+ "name": "disableActiveFocus",
821
+ "privacy": "private"
639
822
  },
640
823
  {
641
824
  "kind": "field",
@@ -654,373 +837,293 @@
654
837
  ],
655
838
  "attributes": [
656
839
  {
657
- "name": "variant",
658
- "type": {
659
- "text": "\"default\" | \"primary\" | \"dashed\" | \"plain\" | \"danger\""
660
- },
661
- "default": "\"default\"",
662
- "description": "The style variant of the button.",
663
- "fieldName": "variant"
664
- },
665
- {
666
- "name": "type",
667
- "type": {
668
- "text": "\"button\" | \"submit\" | \"reset\""
669
- },
670
- "default": "\"submit\"",
671
- "description": "The type of the button.",
672
- "fieldName": "type"
673
- },
674
- {
675
- "name": "size",
840
+ "name": "value",
676
841
  "type": {
677
- "text": "\"s\" | \"m\" | \"l\""
842
+ "text": "string"
678
843
  },
679
- "default": "\"m\"",
680
- "description": "The size of the button.\nThis affects font-size and padding.",
681
- "fieldName": "size"
844
+ "default": "\"\"",
845
+ "description": "The selected date on the calendar. Must be in IS0-8601 format: YYYY-MM-DD.",
846
+ "fieldName": "value"
682
847
  },
683
848
  {
684
- "name": "href",
849
+ "name": "firstDayOfWeek",
685
850
  "type": {
686
- "text": "string | undefined"
851
+ "text": "DaysOfWeek"
687
852
  },
688
- "description": "When provided, renders the button as a link,\nwith its href attribute set to the given value.",
689
- "fieldName": "href"
853
+ "description": "Which day is considered first day of the week? `0` for Sunday, `1` for Monday, etc.\nDefault is Monday.",
854
+ "fieldName": "firstDayOfWeek"
690
855
  },
691
856
  {
692
- "name": "download",
857
+ "name": "min",
693
858
  "type": {
694
- "text": "boolean"
859
+ "text": "string"
695
860
  },
696
- "default": "false",
697
- "description": "When provided together with a href property, the button will\ntrigger a file download instead of a page visit.",
698
- "fieldName": "download"
861
+ "default": "\"\"",
862
+ "description": "Minimum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the max property.",
863
+ "fieldName": "min"
699
864
  },
700
865
  {
701
- "name": "target",
866
+ "name": "max",
702
867
  "type": {
703
- "text": "\"_self\" | \"_blank\" | \"_parent\" | \"_top\""
868
+ "text": "string"
704
869
  },
705
- "default": "\"_self\"",
706
- "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.",
707
- "fieldName": "target"
708
- },
870
+ "default": "\"\"",
871
+ "description": "Maximum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the min property.",
872
+ "fieldName": "max"
873
+ }
874
+ ],
875
+ "mixins": [
709
876
  {
710
- "name": "expand",
711
- "type": {
712
- "text": "boolean"
713
- },
714
- "default": "false",
715
- "description": "Controls whether the button expands to fill the width of its container.",
716
- "fieldName": "expand"
717
- },
877
+ "name": "DraftComponentMixin",
878
+ "module": "/src/common/mixins/DraftComponentMixin.js"
879
+ }
880
+ ],
881
+ "superclass": {
882
+ "name": "LitElement",
883
+ "package": "lit"
884
+ },
885
+ "status": "draft",
886
+ "category": "list",
887
+ "tagName": "nord-calendar",
888
+ "customElement": true
889
+ }
890
+ ],
891
+ "exports": [
892
+ {
893
+ "kind": "js",
894
+ "name": "default",
895
+ "declaration": {
896
+ "name": "Calendar",
897
+ "module": "src/calendar/Calendar.ts"
898
+ }
899
+ },
900
+ {
901
+ "kind": "custom-element-definition",
902
+ "name": "nord-calendar",
903
+ "declaration": {
904
+ "name": "Calendar",
905
+ "module": "src/calendar/Calendar.ts"
906
+ }
907
+ }
908
+ ],
909
+ "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
910
+ },
911
+ {
912
+ "kind": "javascript-module",
913
+ "path": "src/calendar/DateSelectEvent.ts",
914
+ "declarations": [
915
+ {
916
+ "kind": "class",
917
+ "description": "",
918
+ "name": "DateSelectEvent",
919
+ "members": [
718
920
  {
719
- "name": "disabled",
921
+ "kind": "field",
922
+ "name": "eventName",
720
923
  "type": {
721
- "text": "boolean"
924
+ "text": "string"
722
925
  },
723
- "default": "false",
724
- "description": "Makes the component disabled. This prevents users from\nbeing able to interact with the component, and conveys\nits inactive state to assistive technologies.",
725
- "fieldName": "disabled",
726
- "inheritedFrom": {
727
- "name": "InputMixin",
728
- "module": "src/common/mixins/InputMixin.ts"
729
- }
926
+ "static": true,
927
+ "default": "\"nord-select\""
730
928
  },
731
929
  {
732
- "name": "name",
930
+ "kind": "field",
931
+ "name": "date",
733
932
  "type": {
734
- "text": "string | undefined"
933
+ "text": "Date"
735
934
  },
736
- "description": "The name of the form component.",
737
- "fieldName": "name",
738
- "inheritedFrom": {
739
- "name": "InputMixin",
740
- "module": "src/common/mixins/InputMixin.ts"
741
- }
742
- },
935
+ "default": "date"
936
+ }
937
+ ],
938
+ "superclass": {
939
+ "name": "NordEvent",
940
+ "module": "/src/common/events.js"
941
+ }
942
+ }
943
+ ],
944
+ "exports": [
945
+ {
946
+ "kind": "js",
947
+ "name": "DateSelectEvent",
948
+ "declaration": {
949
+ "name": "DateSelectEvent",
950
+ "module": "src/calendar/DateSelectEvent.ts"
951
+ }
952
+ }
953
+ ],
954
+ "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
955
+ },
956
+ {
957
+ "kind": "javascript-module",
958
+ "path": "src/calendar/calendar-localization.ts",
959
+ "declarations": [
960
+ {
961
+ "kind": "variable",
962
+ "name": "localization",
963
+ "type": {
964
+ "text": "CalendarLocalizedText"
965
+ },
966
+ "default": "{\n prevMonthLabel: \"Previous month\",\n nextMonthLabel: \"Next month\",\n monthSelectLabel: \"Month\",\n yearSelectLabel: \"Year\",\n calendarHeading: \"Choose a date\",\n dayNames: [\"Sunday\", \"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\", \"Saturday\"],\n monthNames: [\n \"January\",\n \"February\",\n \"March\",\n \"April\",\n \"May\",\n \"June\",\n \"July\",\n \"August\",\n \"September\",\n \"October\",\n \"November\",\n \"December\",\n ],\n monthNamesShort: [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"],\n locale: \"en-GB\",\n}"
967
+ }
968
+ ],
969
+ "exports": [
970
+ {
971
+ "kind": "js",
972
+ "name": "default",
973
+ "declaration": {
974
+ "name": "localization",
975
+ "module": "src/calendar/calendar-localization.ts"
976
+ }
977
+ }
978
+ ],
979
+ "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
980
+ },
981
+ {
982
+ "kind": "javascript-module",
983
+ "path": "src/calendar/month-view.ts",
984
+ "declarations": [
985
+ {
986
+ "kind": "function",
987
+ "name": "dayView",
988
+ "parameters": [
743
989
  {
744
- "name": "value",
990
+ "name": "{\n focusedDay,\n today,\n day,\n onDaySelect,\n onKeyboardNavigation,\n disabled,\n inRange,\n isSelected,\n dateFormatter,\n}",
745
991
  "type": {
746
- "text": "string"
747
- },
748
- "default": "\"\"",
749
- "description": "The value of the form component.",
750
- "fieldName": "value",
751
- "inheritedFrom": {
752
- "name": "InputMixin",
753
- "module": "src/common/mixins/InputMixin.ts"
992
+ "text": "DatePickerDayProps"
754
993
  }
755
994
  }
756
- ],
757
- "mixins": [
758
- {
759
- "name": "InputMixin",
760
- "module": "/src/common/mixins/InputMixin.js"
761
- },
762
- {
763
- "name": "FocusableMixin",
764
- "module": "/src/common/mixins/FocusableMixin.js"
765
- },
995
+ ]
996
+ },
997
+ {
998
+ "kind": "function",
999
+ "name": "monthView",
1000
+ "parameters": [
766
1001
  {
767
- "name": "DraftComponentMixin",
768
- "module": "/src/common/mixins/DraftComponentMixin.js"
1002
+ "name": "{\n onFocusIn,\n onFocusOut,\n selectedDate,\n focusedDate,\n labelledById,\n localization,\n firstDayOfWeek,\n min,\n max,\n dateFormatter,\n isDateDisabled,\n onDateSelect,\n onKeyboardNavigation,\n}",
1003
+ "type": {
1004
+ "text": "MonthViewArgs"
1005
+ }
769
1006
  }
770
- ],
771
- "superclass": {
772
- "name": "LitElement",
773
- "package": "lit"
774
- },
775
- "status": "draft",
776
- "category": "action",
777
- "tagName": "nord-button",
778
- "customElement": true
1007
+ ]
779
1008
  }
780
1009
  ],
781
1010
  "exports": [
782
1011
  {
783
1012
  "kind": "js",
784
- "name": "default",
1013
+ "name": "dayView",
785
1014
  "declaration": {
786
- "name": "Button",
787
- "module": "src/button/Button.ts"
1015
+ "name": "dayView",
1016
+ "module": "src/calendar/month-view.ts"
788
1017
  }
789
1018
  },
790
1019
  {
791
- "kind": "custom-element-definition",
792
- "name": "nord-button",
1020
+ "kind": "js",
1021
+ "name": "monthView",
793
1022
  "declaration": {
794
- "name": "Button",
795
- "module": "src/button/Button.ts"
1023
+ "name": "monthView",
1024
+ "module": "src/calendar/month-view.ts"
796
1025
  }
797
1026
  }
798
1027
  ],
799
- "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 clear and accurate labels.\n- Use established button colors appropriately. For example, only use a danger button style for an action that’s difficult or impossible to undo.\n- Prioritize the most important actions. Too many buttons will cause confusion.\n- Be consistent with positioning of buttons in the user interface.\n- Use strong, actionable verbs in labels such as “Add”, “Close”, “Cancel”, or “Save”.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use buttons to link to other pages. Use regular link or a plain style instead where necessary.\n- Don’t use buttons for navigation where the link appears within or following a sentence.\n- Don’t use labels such as “Read more”, “Click here” or “More”.\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\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| `default` | Default style is the most common button variant. Only switch to another variant if you need to adjust the visual weight of the element. |\n| `primary` | Primary style is reserved for main call-to-actions. Should be used only once per content area or panel, e.g. for a “Save” action. |\n| `dashed` | Dashed style should be used for actions that trigger filtering. |\n| `danger` | Danger style should be used for actions that delete data or otherwise make it hard to undo the action. |\n| `plain` | Used for less important or less common actions. Can be also used for linking to other pages. |\n| `disabled` | Used for actions that aren’t currently available or not available anymore. Also prevents users from being able to interact with the component, and conveys its inactive state to assistive technologies. |\n\n---\n\n## Additional considerations\n\n- Users of assistive technology expect a button to submit data or do an action. If you need the button to navigate into another view, use the `href` property which will output `<a>` tag instead of a `<button>`.\n- When you need to disable a button, use `disabled` property as it conveys this information correctly to assistive technologies like screen readers.\n- Button component provides 3 size variants; small, medium and large. The large size should only be used for marketing purposes or on areas such as an empty space/content notice.\n"
1028
+ "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
800
1029
  },
801
1030
  {
802
1031
  "kind": "javascript-module",
803
- "path": "src/checkbox/Checkbox.ts",
1032
+ "path": "src/button/Button.ts",
804
1033
  "declarations": [
805
1034
  {
806
1035
  "kind": "class",
807
- "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.",
808
- "name": "Checkbox",
1036
+ "description": "Buttons are used for interface actions. Primary style should be\nused only once per section for main call-to-action, while other\nstyles can appear more frequently.",
1037
+ "name": "Button",
809
1038
  "slots": [
810
1039
  {
811
- "description": "Use when a label requires more than plain text.",
812
- "name": "label"
1040
+ "description": "The button content",
1041
+ "name": ""
813
1042
  },
814
1043
  {
815
- "description": "Optional slot that holds hint text for the input.",
816
- "name": "hint"
1044
+ "description": "Used to place content before button text. Typically used for icons.",
1045
+ "name": "before"
817
1046
  },
818
1047
  {
819
- "description": "Optional slot that holds error text for the input.",
820
- "name": "error"
1048
+ "description": "Used to place content after button text. Typically used for icons.",
1049
+ "name": "after"
821
1050
  }
822
1051
  ],
823
1052
  "members": [
824
1053
  {
825
1054
  "kind": "field",
826
- "name": "formValue",
827
- "privacy": "protected",
828
- "inheritedFrom": {
829
- "name": "FormAssociatedMixin",
830
- "module": "src/common/mixins/FormAssociatedMixin.ts"
831
- }
1055
+ "name": "buttonRef",
1056
+ "privacy": "private"
832
1057
  },
833
1058
  {
834
1059
  "kind": "field",
835
- "name": "checked",
1060
+ "name": "lightDom",
1061
+ "privacy": "private",
1062
+ "default": "new LightDomController(this, {\n render: () => this.renderLightDom(),\n })"
1063
+ },
1064
+ {
1065
+ "kind": "field",
1066
+ "name": "variant",
836
1067
  "type": {
837
- "text": "boolean"
1068
+ "text": "\"default\" | \"primary\" | \"dashed\" | \"plain\" | \"danger\""
838
1069
  },
839
- "default": "false",
840
- "description": "Controls whether the checkbox is checked or not.",
841
- "attribute": "checked"
1070
+ "default": "\"default\"",
1071
+ "description": "The style variant of the button.",
1072
+ "attribute": "variant",
1073
+ "reflects": true
842
1074
  },
843
1075
  {
844
- "kind": "method",
845
- "name": "handleChange",
846
- "privacy": "protected",
847
- "return": {
848
- "type": {
849
- "text": "void"
850
- }
1076
+ "kind": "field",
1077
+ "name": "type",
1078
+ "type": {
1079
+ "text": "\"button\" | \"submit\" | \"reset\""
851
1080
  },
852
- "parameters": [
853
- {
854
- "name": "e",
855
- "type": {
856
- "text": "Event"
857
- }
858
- }
859
- ],
860
- "inheritedFrom": {
861
- "name": "FormAssociatedMixin",
862
- "module": "src/common/mixins/FormAssociatedMixin.ts"
863
- }
1081
+ "default": "\"submit\"",
1082
+ "description": "The type of the button.",
1083
+ "attribute": "type",
1084
+ "reflects": true
864
1085
  },
865
1086
  {
866
1087
  "kind": "field",
867
- "name": "labelSlot",
868
- "privacy": "protected",
869
- "default": "new SlotController(this, \"label\")",
870
- "inheritedFrom": {
871
- "name": "FormAssociatedMixin",
872
- "module": "src/common/mixins/FormAssociatedMixin.ts"
873
- }
874
- },
875
- {
876
- "kind": "field",
877
- "name": "errorSlot",
878
- "privacy": "protected",
879
- "default": "new SlotController(this, \"error\")",
880
- "inheritedFrom": {
881
- "name": "FormAssociatedMixin",
882
- "module": "src/common/mixins/FormAssociatedMixin.ts"
883
- }
884
- },
885
- {
886
- "kind": "field",
887
- "name": "hintSlot",
888
- "privacy": "protected",
889
- "default": "new SlotController(this, \"hint\")",
890
- "inheritedFrom": {
891
- "name": "FormAssociatedMixin",
892
- "module": "src/common/mixins/FormAssociatedMixin.ts"
893
- }
894
- },
895
- {
896
- "kind": "field",
897
- "name": "formData",
898
- "privacy": "protected",
899
- "default": "new FormDataController(this, { value: () => this.formValue })",
900
- "inheritedFrom": {
901
- "name": "FormAssociatedMixin",
902
- "module": "src/common/mixins/FormAssociatedMixin.ts"
903
- }
904
- },
905
- {
906
- "kind": "field",
907
- "name": "inputId",
908
- "type": {
909
- "text": "string"
910
- },
911
- "privacy": "protected",
912
- "default": "\"input\"",
913
- "inheritedFrom": {
914
- "name": "FormAssociatedMixin",
915
- "module": "src/common/mixins/FormAssociatedMixin.ts"
916
- }
917
- },
918
- {
919
- "kind": "field",
920
- "name": "errorId",
921
- "type": {
922
- "text": "string"
923
- },
924
- "privacy": "protected",
925
- "default": "\"error\"",
926
- "inheritedFrom": {
927
- "name": "FormAssociatedMixin",
928
- "module": "src/common/mixins/FormAssociatedMixin.ts"
929
- }
930
- },
931
- {
932
- "kind": "field",
933
- "name": "hintId",
934
- "type": {
935
- "text": "string"
936
- },
937
- "privacy": "protected",
938
- "default": "\"hint\"",
939
- "inheritedFrom": {
940
- "name": "FormAssociatedMixin",
941
- "module": "src/common/mixins/FormAssociatedMixin.ts"
942
- }
943
- },
944
- {
945
- "kind": "field",
946
- "name": "label",
1088
+ "name": "size",
947
1089
  "type": {
948
- "text": "string"
1090
+ "text": "\"s\" | \"m\" | \"l\""
949
1091
  },
950
- "default": "\"\"",
951
- "description": "Label for the input.",
952
- "attribute": "label",
953
- "inheritedFrom": {
954
- "name": "FormAssociatedMixin",
955
- "module": "src/common/mixins/FormAssociatedMixin.ts"
956
- }
1092
+ "default": "\"m\"",
1093
+ "description": "The size of the button.\nThis affects font-size and padding.",
1094
+ "attribute": "size",
1095
+ "reflects": true
957
1096
  },
958
1097
  {
959
1098
  "kind": "field",
960
- "name": "hint",
1099
+ "name": "href",
961
1100
  "type": {
962
1101
  "text": "string | undefined"
963
1102
  },
964
- "description": "Optional hint text to be displayed with the input. Alternatively use the hint slot.",
965
- "attribute": "hint",
966
- "inheritedFrom": {
967
- "name": "FormAssociatedMixin",
968
- "module": "src/common/mixins/FormAssociatedMixin.ts"
969
- }
1103
+ "description": "When provided, renders the button as a link,\nwith its href attribute set to the given value.",
1104
+ "attribute": "href",
1105
+ "reflects": true
970
1106
  },
971
1107
  {
972
1108
  "kind": "field",
973
- "name": "hideLabel",
1109
+ "name": "download",
974
1110
  "type": {
975
1111
  "text": "boolean"
976
1112
  },
977
1113
  "default": "false",
978
- "description": "Visually hide the label, but still show it to assistive technologies like screen readers.",
979
- "attribute": "hide-label",
980
- "inheritedFrom": {
981
- "name": "FormAssociatedMixin",
982
- "module": "src/common/mixins/FormAssociatedMixin.ts"
983
- }
984
- },
985
- {
986
- "kind": "field",
987
- "name": "placeholder",
988
- "type": {
989
- "text": "string | undefined"
990
- },
991
- "description": "Placeholder text to display within the input.",
992
- "attribute": "placeholder",
993
- "inheritedFrom": {
994
- "name": "FormAssociatedMixin",
995
- "module": "src/common/mixins/FormAssociatedMixin.ts"
996
- }
997
- },
998
- {
999
- "kind": "field",
1000
- "name": "error",
1001
- "type": {
1002
- "text": "string | undefined"
1003
- },
1004
- "description": "Optional error to be shown with the input. Alternatively use the error slot.",
1005
- "attribute": "error",
1006
- "inheritedFrom": {
1007
- "name": "FormAssociatedMixin",
1008
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1009
- }
1114
+ "description": "When provided together with a href property, the button will\ntrigger a file download instead of a page visit.",
1115
+ "attribute": "download"
1010
1116
  },
1011
1117
  {
1012
1118
  "kind": "field",
1013
- "name": "required",
1119
+ "name": "target",
1014
1120
  "type": {
1015
- "text": "boolean"
1121
+ "text": "\"_self\" | \"_blank\" | \"_parent\" | \"_top\""
1016
1122
  },
1017
- "default": "false",
1018
- "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 setnovalidateattribute on a form element to prevent browser from displaying its own validation errors.",
1019
- "attribute": "required",
1020
- "inheritedFrom": {
1021
- "name": "FormAssociatedMixin",
1022
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1023
- }
1123
+ "default": "\"_self\"",
1124
+ "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, _parentmeans 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.",
1125
+ "attribute": "target",
1126
+ "reflects": true
1024
1127
  },
1025
1128
  {
1026
1129
  "kind": "field",
@@ -1029,84 +1132,46 @@
1029
1132
  "text": "boolean"
1030
1133
  },
1031
1134
  "default": "false",
1032
- "description": "Controls whether the input expands to fill the width of its container.",
1135
+ "description": "Controls whether the button expands to fill the width of its container.",
1033
1136
  "attribute": "expand",
1034
- "reflects": true,
1035
- "inheritedFrom": {
1036
- "name": "FormAssociatedMixin",
1037
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1038
- }
1137
+ "reflects": true
1039
1138
  },
1040
1139
  {
1041
1140
  "kind": "method",
1042
- "name": "handleInput",
1043
- "privacy": "protected",
1141
+ "name": "renderLink",
1142
+ "privacy": "private",
1044
1143
  "parameters": [
1045
1144
  {
1046
- "name": "e",
1145
+ "name": "innards",
1047
1146
  "type": {
1048
- "text": "Event"
1147
+ "text": "TemplateResult"
1049
1148
  }
1050
1149
  }
1051
1150
  ],
1052
- "inheritedFrom": {
1053
- "name": "FormAssociatedMixin",
1054
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1055
- }
1056
- },
1057
- {
1058
- "kind": "method",
1059
- "name": "renderLabel",
1060
- "privacy": "protected",
1061
- "inheritedFrom": {
1062
- "name": "FormAssociatedMixin",
1063
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1064
- }
1151
+ "description": "We jump through some hoops here to ensure the link is treated correctly when \"disabled\".\nLinks cannot be disabled natively, so we need to rely on some aria magic to get the correct semantics.\nAlong with the advice in the article below, we also set tabindex to \"-1\", so it is taken out of tab order."
1065
1152
  },
1066
1153
  {
1067
1154
  "kind": "method",
1068
- "name": "renderError",
1069
- "privacy": "protected",
1070
- "inheritedFrom": {
1071
- "name": "FormAssociatedMixin",
1072
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1073
- }
1155
+ "name": "renderButton",
1156
+ "privacy": "private",
1157
+ "parameters": [
1158
+ {
1159
+ "name": "innards",
1160
+ "type": {
1161
+ "text": "TemplateResult"
1162
+ }
1163
+ }
1164
+ ]
1074
1165
  },
1075
1166
  {
1076
1167
  "kind": "method",
1077
- "name": "getDescribedBy",
1078
- "privacy": "protected",
1079
- "inheritedFrom": {
1080
- "name": "FormAssociatedMixin",
1081
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1082
- }
1168
+ "name": "renderLightDom",
1169
+ "privacy": "private"
1083
1170
  },
1084
1171
  {
1085
1172
  "kind": "method",
1086
- "name": "getInvalid",
1087
- "privacy": "protected",
1088
- "inheritedFrom": {
1089
- "name": "FormAssociatedMixin",
1090
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1091
- }
1092
- },
1093
- {
1094
- "kind": "field",
1095
- "name": "hasHint",
1096
- "privacy": "protected",
1097
- "inheritedFrom": {
1098
- "name": "FormAssociatedMixin",
1099
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1100
- }
1101
- },
1102
- {
1103
- "kind": "field",
1104
- "name": "hasError",
1105
- "privacy": "protected",
1106
- "inheritedFrom": {
1107
- "name": "FormAssociatedMixin",
1108
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1109
- }
1173
+ "name": "handleClick",
1174
+ "privacy": "private"
1110
1175
  },
1111
1176
  {
1112
1177
  "kind": "field",
@@ -1223,88 +1288,57 @@
1223
1288
  ],
1224
1289
  "attributes": [
1225
1290
  {
1226
- "name": "checked",
1291
+ "name": "variant",
1227
1292
  "type": {
1228
- "text": "boolean"
1293
+ "text": "\"default\" | \"primary\" | \"dashed\" | \"plain\" | \"danger\""
1229
1294
  },
1230
- "default": "false",
1231
- "description": "Controls whether the checkbox is checked or not.",
1232
- "fieldName": "checked"
1295
+ "default": "\"default\"",
1296
+ "description": "The style variant of the button.",
1297
+ "fieldName": "variant"
1233
1298
  },
1234
1299
  {
1235
- "name": "label",
1300
+ "name": "type",
1236
1301
  "type": {
1237
- "text": "string"
1302
+ "text": "\"button\" | \"submit\" | \"reset\""
1238
1303
  },
1239
- "default": "\"\"",
1240
- "description": "Label for the input.",
1241
- "fieldName": "label",
1242
- "inheritedFrom": {
1243
- "name": "FormAssociatedMixin",
1244
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1245
- }
1304
+ "default": "\"submit\"",
1305
+ "description": "The type of the button.",
1306
+ "fieldName": "type"
1246
1307
  },
1247
1308
  {
1248
- "name": "hint",
1249
- "type": {
1250
- "text": "string | undefined"
1251
- },
1252
- "description": "Optional hint text to be displayed with the input. Alternatively use the hint slot.",
1253
- "fieldName": "hint",
1254
- "inheritedFrom": {
1255
- "name": "FormAssociatedMixin",
1256
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1257
- }
1258
- },
1259
- {
1260
- "name": "hide-label",
1309
+ "name": "size",
1261
1310
  "type": {
1262
- "text": "boolean"
1311
+ "text": "\"s\" | \"m\" | \"l\""
1263
1312
  },
1264
- "default": "false",
1265
- "description": "Visually hide the label, but still show it to assistive technologies like screen readers.",
1266
- "fieldName": "hideLabel",
1267
- "inheritedFrom": {
1268
- "name": "FormAssociatedMixin",
1269
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1270
- }
1313
+ "default": "\"m\"",
1314
+ "description": "The size of the button.\nThis affects font-size and padding.",
1315
+ "fieldName": "size"
1271
1316
  },
1272
1317
  {
1273
- "name": "placeholder",
1318
+ "name": "href",
1274
1319
  "type": {
1275
1320
  "text": "string | undefined"
1276
1321
  },
1277
- "description": "Placeholder text to display within the input.",
1278
- "fieldName": "placeholder",
1279
- "inheritedFrom": {
1280
- "name": "FormAssociatedMixin",
1281
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1282
- }
1322
+ "description": "When provided, renders the button as a link,\nwith its href attribute set to the given value.",
1323
+ "fieldName": "href"
1283
1324
  },
1284
1325
  {
1285
- "name": "error",
1326
+ "name": "download",
1286
1327
  "type": {
1287
- "text": "string | undefined"
1328
+ "text": "boolean"
1288
1329
  },
1289
- "description": "Optional error to be shown with the input. Alternatively use the error slot.",
1290
- "fieldName": "error",
1291
- "inheritedFrom": {
1292
- "name": "FormAssociatedMixin",
1293
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1294
- }
1330
+ "default": "false",
1331
+ "description": "When provided together with a href property, the button will\ntrigger a file download instead of a page visit.",
1332
+ "fieldName": "download"
1295
1333
  },
1296
1334
  {
1297
- "name": "required",
1335
+ "name": "target",
1298
1336
  "type": {
1299
- "text": "boolean"
1337
+ "text": "\"_self\" | \"_blank\" | \"_parent\" | \"_top\""
1300
1338
  },
1301
- "default": "false",
1302
- "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 setnovalidateattribute on a form element to prevent browser from displaying its own validation errors.",
1303
- "fieldName": "required",
1304
- "inheritedFrom": {
1305
- "name": "FormAssociatedMixin",
1306
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1307
- }
1339
+ "default": "\"_self\"",
1340
+ "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, _parentmeans 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.",
1341
+ "fieldName": "target"
1308
1342
  },
1309
1343
  {
1310
1344
  "name": "expand",
@@ -1312,12 +1346,8 @@
1312
1346
  "text": "boolean"
1313
1347
  },
1314
1348
  "default": "false",
1315
- "description": "Controls whether the input expands to fill the width of its container.",
1316
- "fieldName": "expand",
1317
- "inheritedFrom": {
1318
- "name": "FormAssociatedMixin",
1319
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1320
- }
1349
+ "description": "Controls whether the button expands to fill the width of its container.",
1350
+ "fieldName": "expand"
1321
1351
  },
1322
1352
  {
1323
1353
  "name": "disabled",
@@ -1359,10 +1389,6 @@
1359
1389
  }
1360
1390
  ],
1361
1391
  "mixins": [
1362
- {
1363
- "name": "FormAssociatedMixin",
1364
- "module": "/src/common/mixins/FormAssociatedMixin.js"
1365
- },
1366
1392
  {
1367
1393
  "name": "InputMixin",
1368
1394
  "module": "/src/common/mixins/InputMixin.js"
@@ -1381,33 +1407,9 @@
1381
1407
  "package": "lit"
1382
1408
  },
1383
1409
  "status": "draft",
1384
- "category": "form",
1385
- "tagName": "nord-checkbox",
1386
- "customElement": true,
1387
- "events": [
1388
- {
1389
- "name": "input",
1390
- "type": {
1391
- "text": "NordEvent"
1392
- },
1393
- "description": "Fired as the user types into the input.",
1394
- "inheritedFrom": {
1395
- "name": "FormAssociatedMixin",
1396
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1397
- }
1398
- },
1399
- {
1400
- "name": "change",
1401
- "type": {
1402
- "text": "NordEvent"
1403
- },
1404
- "description": "Fired whenever the input's value is changed via user interaction.",
1405
- "inheritedFrom": {
1406
- "name": "FormAssociatedMixin",
1407
- "module": "src/common/mixins/FormAssociatedMixin.ts"
1408
- }
1409
- }
1410
- ]
1410
+ "category": "action",
1411
+ "tagName": "nord-button",
1412
+ "customElement": true
1411
1413
  }
1412
1414
  ],
1413
1415
  "exports": [
@@ -1415,292 +1417,536 @@
1415
1417
  "kind": "js",
1416
1418
  "name": "default",
1417
1419
  "declaration": {
1418
- "name": "Checkbox",
1419
- "module": "src/checkbox/Checkbox.ts"
1420
+ "name": "Button",
1421
+ "module": "src/button/Button.ts"
1420
1422
  }
1421
1423
  },
1422
1424
  {
1423
1425
  "kind": "custom-element-definition",
1424
- "name": "nord-checkbox",
1426
+ "name": "nord-button",
1425
1427
  "declaration": {
1426
- "name": "Checkbox",
1427
- "module": "src/checkbox/Checkbox.ts"
1428
+ "name": "Button",
1429
+ "module": "src/button/Button.ts"
1428
1430
  }
1429
1431
  }
1430
1432
  ],
1431
- "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 for making it possible to choose one or more options from a limited number of options.\n- Use for “accepting terms of service” and similar functionality.\n- Use in forms to toggle something on or off.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use when you have more than 10 options to choose from.\n- Don’t change the selection of another checkbox when another one is clicked. Only exception is when a checkbox is used to make a bulk selection of multiple items.\n\n</div>\n\n---\n\n## Content guidelines\n\nCheckbox labels should be clear, accurate and predictable. It should be possible for the user to understand what they are selecting:\n\n<div class=\"n-usage n-usage-do\">User settings</div>\n<div class=\"n-usage n-usage-dont\">Option 1</div>\n\nWhen writing checkbox 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\">User settings</div>\n<div class=\"n-usage n-usage-dont\">User Settings</div>\n\nAvoid ending in punctuation if it’s a single sentence, word, or a fragment:\n\n<div class=\"n-usage n-usage-do\">Show dashboard</div>\n<div class=\"n-usage n-usage-dont\">Show dashboard.</div>\n\nDo not use commas or semicolons at the end of each line\n\n<div class=\"n-usage n-usage-do\">Patients</div>\n<div class=\"n-usage n-usage-dont\">Patients;</div>\n"
1433
+ "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 clear and accurate labels.\n- Use established button colors appropriately. For example, only use a danger button style for an action that’s difficult or impossible to undo.\n- Prioritize the most important actions. Too many buttons will cause confusion.\n- Be consistent with positioning of buttons in the user interface.\n- Use strong, actionable verbs in labels such as “Add”, “Close”, “Cancel”, or “Save”.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use buttons to link to other pages. Use regular link or a plain style instead where necessary.\n- Don’t use buttons for navigation where the link appears within or following a sentence.\n- Don’t use labels such as “Read more”, “Click here” or “More”.\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\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| `default` | Default style is the most common button variant. Only switch to another variant if you need to adjust the visual weight of the element. |\n| `primary` | Primary style is reserved for main call-to-actions. Should be used only once per content area or panel, e.g. for a “Save” action. |\n| `dashed` | Dashed style should be used for actions that trigger filtering. |\n| `danger` | Danger style should be used for actions that delete data or otherwise make it hard to undo the action. |\n| `plain` | Used for less important or less common actions. Can be also used for linking to other pages. |\n| `disabled` | Used for actions that aren’t currently available or not available anymore. Also prevents users from being able to interact with the component, and conveys its inactive state to assistive technologies. |\n\n---\n\n## Additional considerations\n\n- Users of assistive technology expect a button to submit data or do an action. If you need the button to navigate into another view, use the `href` property which will output `<a>` tag instead of a `<button>`.\n- When you need to disable a button, use `disabled` property as it conveys this information correctly to assistive technologies like screen readers.\n- Button component provides 3 size variants; small, medium and large. The large size should only be used for marketing purposes or on areas such as an empty space/content notice.\n"
1432
1434
  },
1433
1435
  {
1434
1436
  "kind": "javascript-module",
1435
- "path": "src/calendar/Calendar.ts",
1437
+ "path": "src/card/Card.ts",
1436
1438
  "declarations": [
1437
1439
  {
1438
1440
  "kind": "class",
1439
- "description": "Calendar allows user to pick a date. It comes with built-in\nfunctionality that allows you to set a minimum and a maximum allowed date.\nPlease note that the date must be passed in ISO-8601 format.",
1440
- "name": "Calendar",
1441
- "members": [
1441
+ "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.",
1442
+ "name": "Card",
1443
+ "slots": [
1442
1444
  {
1443
- "kind": "field",
1444
- "name": "dialogLabelId",
1445
- "type": {
1446
- "text": "string"
1447
- },
1448
- "privacy": "private",
1449
- "default": "\"dialog-header\""
1445
+ "description": "The card content.",
1446
+ "name": ""
1450
1447
  },
1451
1448
  {
1452
- "kind": "field",
1453
- "name": "monthSelectNode",
1454
- "type": {
1455
- "text": "HTMLElement"
1456
- },
1457
- "privacy": "private"
1449
+ "description": "Optional slot that holds a header for the card.",
1450
+ "name": "header"
1458
1451
  },
1459
1452
  {
1460
- "kind": "field",
1461
- "name": "focusedDayNode",
1462
- "type": {
1463
- "text": "HTMLButtonElement"
1464
- },
1465
- "privacy": "private"
1466
- },
1453
+ "description": "Optional slot that holds footer content for the card.",
1454
+ "name": "footer"
1455
+ }
1456
+ ],
1457
+ "members": [
1467
1458
  {
1468
1459
  "kind": "field",
1469
- "name": "direction",
1460
+ "name": "headerSlot",
1470
1461
  "privacy": "private",
1471
- "default": "new DirectionController(this)"
1462
+ "default": "new SlotController(this, \"header\")"
1472
1463
  },
1473
1464
  {
1474
1465
  "kind": "field",
1475
- "name": "swipe",
1466
+ "name": "footerSlot",
1476
1467
  "privacy": "private",
1477
- "default": "new SwipeController(this, {\n matchesGesture: isHorizontalSwipe,\n onSwipeEnd: ({ distX }) => this.addMonths(distX < 0 ? 1 : -1),\n })"
1468
+ "default": "new SlotController(this, \"footer\")"
1478
1469
  },
1479
1470
  {
1480
1471
  "kind": "field",
1481
- "name": "shortcuts",
1482
- "privacy": "private"
1472
+ "name": "padding",
1473
+ "type": {
1474
+ "text": "\"m\" | \"l\" | \"none\""
1475
+ },
1476
+ "default": "\"m\"",
1477
+ "description": "Controls the padding of card component. When set to “none”,\nthe header and footer slots will still have padding.",
1478
+ "attribute": "padding",
1479
+ "reflects": true
1483
1480
  },
1484
1481
  {
1485
1482
  "kind": "field",
1486
- "name": "dateFormatShort",
1483
+ "name": "_warningLogged",
1487
1484
  "type": {
1488
- "text": "Intl.DateTimeFormat"
1485
+ "text": "boolean"
1489
1486
  },
1490
1487
  "privacy": "private",
1491
- "description": "Whilst dateAdapter is used for handling the formatting/parsing dates in the input,\nthese are used to format dates exclusively for the benefit of screen readers.\n\nWe prefer DateTimeFormat over date.toLocaleDateString, as the former has\nbetter performance when formatting large number of dates. See:\nhttps://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString#Performance"
1492
- },
1488
+ "static": true,
1489
+ "default": "false",
1490
+ "inheritedFrom": {
1491
+ "name": "DraftComponentMixin",
1492
+ "module": "src/common/mixins/DraftComponentMixin.ts"
1493
+ }
1494
+ }
1495
+ ],
1496
+ "attributes": [
1493
1497
  {
1494
- "kind": "field",
1495
- "name": "localization",
1498
+ "name": "padding",
1496
1499
  "type": {
1497
- "text": "CalendarLocalizedText"
1500
+ "text": "\"m\" | \"l\" | \"none\""
1498
1501
  },
1499
- "default": "localization"
1502
+ "default": "\"m\"",
1503
+ "description": "Controls the padding of card component. When set to “none”,\nthe header and footer slots will still have padding.",
1504
+ "fieldName": "padding"
1505
+ }
1506
+ ],
1507
+ "mixins": [
1508
+ {
1509
+ "name": "DraftComponentMixin",
1510
+ "module": "/src/common/mixins/DraftComponentMixin.js"
1511
+ }
1512
+ ],
1513
+ "superclass": {
1514
+ "name": "LitElement",
1515
+ "package": "lit"
1516
+ },
1517
+ "status": "draft",
1518
+ "category": "structure",
1519
+ "tagName": "nord-card",
1520
+ "customElement": true
1521
+ }
1522
+ ],
1523
+ "exports": [
1524
+ {
1525
+ "kind": "js",
1526
+ "name": "default",
1527
+ "declaration": {
1528
+ "name": "Card",
1529
+ "module": "src/card/Card.ts"
1530
+ }
1531
+ },
1532
+ {
1533
+ "kind": "custom-element-definition",
1534
+ "name": "nord-card",
1535
+ "declaration": {
1536
+ "name": "Card",
1537
+ "module": "src/card/Card.ts"
1538
+ }
1539
+ }
1540
+ ],
1541
+ "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\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\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"
1542
+ },
1543
+ {
1544
+ "kind": "javascript-module",
1545
+ "path": "src/checkbox/Checkbox.ts",
1546
+ "declarations": [
1547
+ {
1548
+ "kind": "class",
1549
+ "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.",
1550
+ "name": "Checkbox",
1551
+ "slots": [
1552
+ {
1553
+ "description": "Use when a label requires more than plain text.",
1554
+ "name": "label"
1500
1555
  },
1501
1556
  {
1502
- "kind": "field",
1503
- "name": "value",
1504
- "type": {
1505
- "text": "string"
1506
- },
1507
- "default": "\"\"",
1508
- "description": "The selected date on the calendar. Must be in IS0-8601 format: YYYY-MM-DD.",
1509
- "attribute": "value"
1557
+ "description": "Optional slot that holds hint text for the input.",
1558
+ "name": "hint"
1510
1559
  },
1560
+ {
1561
+ "description": "Optional slot that holds error text for the input.",
1562
+ "name": "error"
1563
+ }
1564
+ ],
1565
+ "members": [
1511
1566
  {
1512
1567
  "kind": "field",
1513
- "name": "firstDayOfWeek",
1568
+ "name": "formValue",
1569
+ "privacy": "protected",
1570
+ "inheritedFrom": {
1571
+ "name": "FormAssociatedMixin",
1572
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1573
+ }
1574
+ },
1575
+ {
1576
+ "kind": "field",
1577
+ "name": "checked",
1514
1578
  "type": {
1515
- "text": "DaysOfWeek"
1579
+ "text": "boolean"
1516
1580
  },
1517
- "description": "Which day is considered first day of the week? `0` for Sunday, `1` for Monday, etc.\nDefault is Monday.",
1518
- "attribute": "firstDayOfWeek"
1581
+ "default": "false",
1582
+ "description": "Controls whether the checkbox is checked or not.",
1583
+ "attribute": "checked"
1584
+ },
1585
+ {
1586
+ "kind": "method",
1587
+ "name": "handleChange",
1588
+ "privacy": "protected",
1589
+ "parameters": [
1590
+ {
1591
+ "name": "e",
1592
+ "type": {
1593
+ "text": "Event"
1594
+ }
1595
+ }
1596
+ ],
1597
+ "return": {
1598
+ "type": {
1599
+ "text": "void"
1600
+ }
1601
+ },
1602
+ "inheritedFrom": {
1603
+ "name": "FormAssociatedMixin",
1604
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1605
+ }
1519
1606
  },
1520
1607
  {
1521
1608
  "kind": "field",
1522
- "name": "min",
1609
+ "name": "labelSlot",
1610
+ "privacy": "protected",
1611
+ "default": "new SlotController(this, \"label\")",
1612
+ "inheritedFrom": {
1613
+ "name": "FormAssociatedMixin",
1614
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1615
+ }
1616
+ },
1617
+ {
1618
+ "kind": "field",
1619
+ "name": "errorSlot",
1620
+ "privacy": "protected",
1621
+ "default": "new SlotController(this, \"error\")",
1622
+ "inheritedFrom": {
1623
+ "name": "FormAssociatedMixin",
1624
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1625
+ }
1626
+ },
1627
+ {
1628
+ "kind": "field",
1629
+ "name": "hintSlot",
1630
+ "privacy": "protected",
1631
+ "default": "new SlotController(this, \"hint\")",
1632
+ "inheritedFrom": {
1633
+ "name": "FormAssociatedMixin",
1634
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1635
+ }
1636
+ },
1637
+ {
1638
+ "kind": "field",
1639
+ "name": "formData",
1640
+ "privacy": "protected",
1641
+ "default": "new FormDataController(this, { value: () => this.formValue })",
1642
+ "inheritedFrom": {
1643
+ "name": "FormAssociatedMixin",
1644
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1645
+ }
1646
+ },
1647
+ {
1648
+ "kind": "field",
1649
+ "name": "inputId",
1523
1650
  "type": {
1524
1651
  "text": "string"
1525
1652
  },
1526
- "default": "\"\"",
1527
- "description": "Minimum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the max property.",
1528
- "attribute": "min"
1653
+ "privacy": "protected",
1654
+ "default": "\"input\"",
1655
+ "inheritedFrom": {
1656
+ "name": "FormAssociatedMixin",
1657
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1658
+ }
1529
1659
  },
1530
1660
  {
1531
1661
  "kind": "field",
1532
- "name": "max",
1662
+ "name": "errorId",
1663
+ "type": {
1664
+ "text": "string"
1665
+ },
1666
+ "privacy": "protected",
1667
+ "default": "\"error\"",
1668
+ "inheritedFrom": {
1669
+ "name": "FormAssociatedMixin",
1670
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1671
+ }
1672
+ },
1673
+ {
1674
+ "kind": "field",
1675
+ "name": "hintId",
1676
+ "type": {
1677
+ "text": "string"
1678
+ },
1679
+ "privacy": "protected",
1680
+ "default": "\"hint\"",
1681
+ "inheritedFrom": {
1682
+ "name": "FormAssociatedMixin",
1683
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1684
+ }
1685
+ },
1686
+ {
1687
+ "kind": "field",
1688
+ "name": "label",
1533
1689
  "type": {
1534
1690
  "text": "string"
1535
1691
  },
1536
1692
  "default": "\"\"",
1537
- "description": "Maximum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the min property.",
1538
- "attribute": "max"
1693
+ "description": "Label for the input.",
1694
+ "attribute": "label",
1695
+ "inheritedFrom": {
1696
+ "name": "FormAssociatedMixin",
1697
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1698
+ }
1539
1699
  },
1540
1700
  {
1541
1701
  "kind": "field",
1542
- "name": "isDateDisabled",
1702
+ "name": "hint",
1543
1703
  "type": {
1544
- "text": "DateDisabledPredicate"
1704
+ "text": "string | undefined"
1545
1705
  },
1546
- "default": "isDateDisabled",
1547
- "description": "Controls which days are disabled and therefore disallowed.\nFor example, this can be used to disallow selection of weekends."
1706
+ "description": "Optional hint text to be displayed with the input. Alternatively use the hint slot.",
1707
+ "attribute": "hint",
1708
+ "inheritedFrom": {
1709
+ "name": "FormAssociatedMixin",
1710
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1711
+ }
1548
1712
  },
1549
1713
  {
1550
1714
  "kind": "field",
1551
- "name": "activeFocus",
1715
+ "name": "hideLabel",
1552
1716
  "type": {
1553
1717
  "text": "boolean"
1554
1718
  },
1555
- "privacy": "private",
1556
- "default": "false"
1719
+ "default": "false",
1720
+ "description": "Visually hide the label, but still show it to assistive technologies like screen readers.",
1721
+ "attribute": "hide-label",
1722
+ "inheritedFrom": {
1723
+ "name": "FormAssociatedMixin",
1724
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1725
+ }
1557
1726
  },
1558
1727
  {
1559
1728
  "kind": "field",
1560
- "name": "focusedDay",
1561
- "privacy": "private",
1562
- "default": "new Date()"
1729
+ "name": "placeholder",
1730
+ "type": {
1731
+ "text": "string | undefined"
1732
+ },
1733
+ "description": "Placeholder text to display within the input.",
1734
+ "attribute": "placeholder",
1735
+ "inheritedFrom": {
1736
+ "name": "FormAssociatedMixin",
1737
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1738
+ }
1563
1739
  },
1564
1740
  {
1565
- "kind": "method",
1566
- "name": "focus",
1567
- "parameters": [
1568
- {
1569
- "name": "options",
1570
- "optional": true,
1571
- "type": {
1572
- "text": "FocusOptions & { target: \"day\" | \"month\" }"
1573
- }
1574
- }
1575
- ]
1741
+ "kind": "field",
1742
+ "name": "error",
1743
+ "type": {
1744
+ "text": "string | undefined"
1745
+ },
1746
+ "description": "Optional error to be shown with the input. Alternatively use the error slot.",
1747
+ "attribute": "error",
1748
+ "inheritedFrom": {
1749
+ "name": "FormAssociatedMixin",
1750
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1751
+ }
1576
1752
  },
1577
1753
  {
1578
- "kind": "method",
1579
- "name": "createDateFormatter",
1580
- "privacy": "private"
1754
+ "kind": "field",
1755
+ "name": "required",
1756
+ "type": {
1757
+ "text": "boolean"
1758
+ },
1759
+ "default": "false",
1760
+ "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.",
1761
+ "attribute": "required",
1762
+ "inheritedFrom": {
1763
+ "name": "FormAssociatedMixin",
1764
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1765
+ }
1581
1766
  },
1582
1767
  {
1583
1768
  "kind": "field",
1584
- "name": "handleDaySelect",
1585
- "privacy": "private"
1769
+ "name": "expand",
1770
+ "type": {
1771
+ "text": "boolean"
1772
+ },
1773
+ "default": "false",
1774
+ "description": "Controls whether the input expands to fill the width of its container.",
1775
+ "attribute": "expand",
1776
+ "reflects": true,
1777
+ "inheritedFrom": {
1778
+ "name": "FormAssociatedMixin",
1779
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1780
+ }
1586
1781
  },
1587
1782
  {
1588
1783
  "kind": "method",
1589
- "name": "addDays",
1590
- "privacy": "private",
1784
+ "name": "handleInput",
1785
+ "privacy": "protected",
1591
1786
  "parameters": [
1592
1787
  {
1593
- "name": "days",
1788
+ "name": "e",
1594
1789
  "type": {
1595
- "text": "number"
1790
+ "text": "Event"
1596
1791
  }
1597
1792
  }
1598
- ]
1793
+ ],
1794
+ "inheritedFrom": {
1795
+ "name": "FormAssociatedMixin",
1796
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1797
+ }
1599
1798
  },
1600
1799
  {
1601
1800
  "kind": "method",
1602
- "name": "addMonths",
1603
- "privacy": "private",
1604
- "parameters": [
1605
- {
1606
- "name": "months",
1607
- "type": {
1608
- "text": "number"
1609
- }
1610
- }
1611
- ]
1801
+ "name": "renderLabel",
1802
+ "privacy": "protected",
1803
+ "inheritedFrom": {
1804
+ "name": "FormAssociatedMixin",
1805
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1806
+ }
1612
1807
  },
1613
1808
  {
1614
1809
  "kind": "method",
1615
- "name": "addYears",
1616
- "privacy": "private",
1617
- "parameters": [
1618
- {
1619
- "name": "years",
1620
- "type": {
1621
- "text": "number"
1622
- }
1623
- }
1624
- ]
1810
+ "name": "renderError",
1811
+ "privacy": "protected",
1812
+ "inheritedFrom": {
1813
+ "name": "FormAssociatedMixin",
1814
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1815
+ }
1625
1816
  },
1626
1817
  {
1627
1818
  "kind": "method",
1628
- "name": "startOfWeek",
1629
- "privacy": "private"
1819
+ "name": "getDescribedBy",
1820
+ "privacy": "protected",
1821
+ "inheritedFrom": {
1822
+ "name": "FormAssociatedMixin",
1823
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1824
+ }
1630
1825
  },
1631
1826
  {
1632
1827
  "kind": "method",
1633
- "name": "endOfWeek",
1634
- "privacy": "private"
1828
+ "name": "getInvalid",
1829
+ "privacy": "protected",
1830
+ "inheritedFrom": {
1831
+ "name": "FormAssociatedMixin",
1832
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1833
+ }
1635
1834
  },
1636
1835
  {
1637
- "kind": "method",
1638
- "name": "setMonth",
1639
- "privacy": "private",
1640
- "parameters": [
1641
- {
1642
- "name": "month",
1643
- "type": {
1644
- "text": "number"
1645
- }
1646
- }
1647
- ]
1836
+ "kind": "field",
1837
+ "name": "hasHint",
1838
+ "privacy": "protected",
1839
+ "inheritedFrom": {
1840
+ "name": "FormAssociatedMixin",
1841
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1842
+ }
1648
1843
  },
1649
1844
  {
1650
- "kind": "method",
1651
- "name": "setYear",
1652
- "privacy": "private",
1653
- "parameters": [
1654
- {
1655
- "name": "year",
1656
- "type": {
1657
- "text": "number"
1658
- }
1659
- }
1660
- ]
1845
+ "kind": "field",
1846
+ "name": "hasError",
1847
+ "privacy": "protected",
1848
+ "inheritedFrom": {
1849
+ "name": "FormAssociatedMixin",
1850
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1851
+ }
1661
1852
  },
1662
1853
  {
1663
- "kind": "method",
1664
- "name": "setFocusedDay",
1665
- "privacy": "private",
1666
- "parameters": [
1667
- {
1668
- "name": "day",
1669
- "type": {
1670
- "text": "Date"
1671
- }
1672
- }
1673
- ]
1854
+ "kind": "field",
1855
+ "name": "disabled",
1856
+ "type": {
1857
+ "text": "boolean"
1858
+ },
1859
+ "default": "false",
1860
+ "description": "Makes the component disabled. This prevents users from\nbeing able to interact with the component, and conveys\nits inactive state to assistive technologies.",
1861
+ "attribute": "disabled",
1862
+ "reflects": true,
1863
+ "inheritedFrom": {
1864
+ "name": "InputMixin",
1865
+ "module": "src/common/mixins/InputMixin.ts"
1866
+ }
1674
1867
  },
1675
1868
  {
1676
1869
  "kind": "field",
1677
- "name": "handleMonthSelect",
1678
- "privacy": "private"
1870
+ "name": "name",
1871
+ "type": {
1872
+ "text": "string | undefined"
1873
+ },
1874
+ "description": "The name of the form component.",
1875
+ "attribute": "name",
1876
+ "inheritedFrom": {
1877
+ "name": "InputMixin",
1878
+ "module": "src/common/mixins/InputMixin.ts"
1879
+ }
1679
1880
  },
1680
1881
  {
1681
1882
  "kind": "field",
1682
- "name": "handleYearSelect",
1683
- "privacy": "private"
1883
+ "name": "value",
1884
+ "type": {
1885
+ "text": "string"
1886
+ },
1887
+ "default": "\"\"",
1888
+ "description": "The value of the form component.",
1889
+ "attribute": "value",
1890
+ "inheritedFrom": {
1891
+ "name": "InputMixin",
1892
+ "module": "src/common/mixins/InputMixin.ts"
1893
+ }
1684
1894
  },
1685
1895
  {
1686
1896
  "kind": "field",
1687
- "name": "handleNextMonthClick",
1688
- "privacy": "private"
1897
+ "name": "form",
1898
+ "privacy": "protected",
1899
+ "description": "Gets the form, if any, associated with the form element.",
1900
+ "inheritedFrom": {
1901
+ "name": "InputMixin",
1902
+ "module": "src/common/mixins/InputMixin.ts"
1903
+ }
1689
1904
  },
1690
1905
  {
1691
1906
  "kind": "field",
1692
- "name": "handlePreviousMonthClick",
1693
- "privacy": "private"
1907
+ "name": "focusableRef",
1908
+ "privacy": "protected",
1909
+ "inheritedFrom": {
1910
+ "name": "FocusableMixin",
1911
+ "module": "src/common/mixins/FocusableMixin.ts"
1912
+ }
1694
1913
  },
1695
1914
  {
1696
- "kind": "field",
1697
- "name": "enableActiveFocus",
1698
- "privacy": "private"
1915
+ "kind": "method",
1916
+ "name": "focus",
1917
+ "parameters": [
1918
+ {
1919
+ "name": "options",
1920
+ "optional": true,
1921
+ "type": {
1922
+ "text": "FocusOptions"
1923
+ },
1924
+ "description": "An object which controls aspects of the focusing process."
1925
+ }
1926
+ ],
1927
+ "description": "Programmatically move focus to the component.",
1928
+ "inheritedFrom": {
1929
+ "name": "FocusableMixin",
1930
+ "module": "src/common/mixins/FocusableMixin.ts"
1931
+ }
1699
1932
  },
1700
1933
  {
1701
- "kind": "field",
1702
- "name": "disableActiveFocus",
1703
- "privacy": "private"
1934
+ "kind": "method",
1935
+ "name": "blur",
1936
+ "description": "Programmatically remove focus from the component.",
1937
+ "inheritedFrom": {
1938
+ "name": "FocusableMixin",
1939
+ "module": "src/common/mixins/FocusableMixin.ts"
1940
+ }
1941
+ },
1942
+ {
1943
+ "kind": "method",
1944
+ "name": "click",
1945
+ "description": "Programmatically simulates a click on the component.",
1946
+ "inheritedFrom": {
1947
+ "name": "FocusableMixin",
1948
+ "module": "src/common/mixins/FocusableMixin.ts"
1949
+ }
1704
1950
  },
1705
1951
  {
1706
1952
  "kind": "field",
@@ -1719,269 +1965,154 @@
1719
1965
  ],
1720
1966
  "attributes": [
1721
1967
  {
1722
- "name": "value",
1723
- "type": {
1724
- "text": "string"
1725
- },
1726
- "default": "\"\"",
1727
- "description": "The selected date on the calendar. Must be in IS0-8601 format: YYYY-MM-DD.",
1728
- "fieldName": "value"
1729
- },
1730
- {
1731
- "name": "firstDayOfWeek",
1732
- "type": {
1733
- "text": "DaysOfWeek"
1734
- },
1735
- "description": "Which day is considered first day of the week? `0` for Sunday, `1` for Monday, etc.\nDefault is Monday.",
1736
- "fieldName": "firstDayOfWeek"
1737
- },
1738
- {
1739
- "name": "min",
1968
+ "name": "checked",
1740
1969
  "type": {
1741
- "text": "string"
1970
+ "text": "boolean"
1742
1971
  },
1743
- "default": "\"\"",
1744
- "description": "Minimum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the max property.",
1745
- "fieldName": "min"
1972
+ "default": "false",
1973
+ "description": "Controls whether the checkbox is checked or not.",
1974
+ "fieldName": "checked"
1746
1975
  },
1747
1976
  {
1748
- "name": "max",
1977
+ "name": "label",
1749
1978
  "type": {
1750
1979
  "text": "string"
1751
1980
  },
1752
1981
  "default": "\"\"",
1753
- "description": "Maximum date allowed to be picked. Must be in IS0-8601 format: YYYY-MM-DD.\nThis setting can be used alone or together with the min property.",
1754
- "fieldName": "max"
1755
- }
1756
- ],
1757
- "mixins": [
1758
- {
1759
- "name": "DraftComponentMixin",
1760
- "module": "/src/common/mixins/DraftComponentMixin.js"
1761
- }
1762
- ],
1763
- "superclass": {
1764
- "name": "LitElement",
1765
- "package": "lit"
1766
- },
1767
- "status": "draft",
1768
- "category": "list",
1769
- "tagName": "nord-calendar",
1770
- "customElement": true
1771
- }
1772
- ],
1773
- "exports": [
1774
- {
1775
- "kind": "js",
1776
- "name": "default",
1777
- "declaration": {
1778
- "name": "Calendar",
1779
- "module": "src/calendar/Calendar.ts"
1780
- }
1781
- },
1782
- {
1783
- "kind": "custom-element-definition",
1784
- "name": "nord-calendar",
1785
- "declaration": {
1786
- "name": "Calendar",
1787
- "module": "src/calendar/Calendar.ts"
1788
- }
1789
- }
1790
- ],
1791
- "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
1792
- },
1793
- {
1794
- "kind": "javascript-module",
1795
- "path": "src/calendar/DateSelectEvent.ts",
1796
- "declarations": [
1797
- {
1798
- "kind": "class",
1799
- "description": "",
1800
- "name": "DateSelectEvent",
1801
- "members": [
1802
- {
1803
- "kind": "field",
1804
- "name": "eventName",
1805
- "type": {
1806
- "text": "string"
1807
- },
1808
- "static": true,
1809
- "default": "\"nord-select\""
1810
- },
1811
- {
1812
- "kind": "field",
1813
- "name": "date",
1814
- "type": {
1815
- "text": "Date"
1816
- },
1817
- "default": "date"
1818
- }
1819
- ],
1820
- "superclass": {
1821
- "name": "NordEvent",
1822
- "module": "/src/common/events.js"
1823
- }
1824
- }
1825
- ],
1826
- "exports": [
1827
- {
1828
- "kind": "js",
1829
- "name": "DateSelectEvent",
1830
- "declaration": {
1831
- "name": "DateSelectEvent",
1832
- "module": "src/calendar/DateSelectEvent.ts"
1833
- }
1834
- }
1835
- ],
1836
- "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
1837
- },
1838
- {
1839
- "kind": "javascript-module",
1840
- "path": "src/calendar/calendar-localization.ts",
1841
- "declarations": [
1842
- {
1843
- "kind": "variable",
1844
- "name": "localization",
1845
- "type": {
1846
- "text": "CalendarLocalizedText"
1847
- },
1848
- "default": "{\n prevMonthLabel: \"Previous month\",\n nextMonthLabel: \"Next month\",\n monthSelectLabel: \"Month\",\n yearSelectLabel: \"Year\",\n calendarHeading: \"Choose a date\",\n dayNames: [\"Sunday\", \"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\", \"Saturday\"],\n monthNames: [\n \"January\",\n \"February\",\n \"March\",\n \"April\",\n \"May\",\n \"June\",\n \"July\",\n \"August\",\n \"September\",\n \"October\",\n \"November\",\n \"December\",\n ],\n monthNamesShort: [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"],\n locale: \"en-GB\",\n}"
1849
- }
1850
- ],
1851
- "exports": [
1852
- {
1853
- "kind": "js",
1854
- "name": "default",
1855
- "declaration": {
1856
- "name": "localization",
1857
- "module": "src/calendar/calendar-localization.ts"
1858
- }
1859
- }
1860
- ],
1861
- "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
1862
- },
1863
- {
1864
- "kind": "javascript-module",
1865
- "path": "src/calendar/month-view.ts",
1866
- "declarations": [
1867
- {
1868
- "kind": "function",
1869
- "name": "dayView",
1870
- "parameters": [
1871
- {
1872
- "name": "{\n focusedDay,\n today,\n day,\n onDaySelect,\n onKeyboardNavigation,\n disabled,\n inRange,\n isSelected,\n dateFormatter,\n}",
1873
- "type": {
1874
- "text": "DatePickerDayProps"
1875
- }
1876
- }
1877
- ]
1878
- },
1879
- {
1880
- "kind": "function",
1881
- "name": "monthView",
1882
- "parameters": [
1883
- {
1884
- "name": "{\n onFocusIn,\n onFocusOut,\n selectedDate,\n focusedDate,\n labelledById,\n localization,\n firstDayOfWeek,\n min,\n max,\n dateFormatter,\n isDateDisabled,\n onDateSelect,\n onKeyboardNavigation,\n}",
1885
- "type": {
1886
- "text": "MonthViewArgs"
1887
- }
1888
- }
1889
- ]
1890
- }
1891
- ],
1892
- "exports": [
1893
- {
1894
- "kind": "js",
1895
- "name": "dayView",
1896
- "declaration": {
1897
- "name": "dayView",
1898
- "module": "src/calendar/month-view.ts"
1899
- }
1900
- },
1901
- {
1902
- "kind": "js",
1903
- "name": "monthView",
1904
- "declaration": {
1905
- "name": "monthView",
1906
- "module": "src/calendar/month-view.ts"
1907
- }
1908
- }
1909
- ],
1910
- "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 the user needs to choose a single date or a date range.\n- Close calendar after a single date is selected, unless a range with a start and end date is required.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use for entering date of birth. Use input component instead.\n- Don’t use for choosing a date that is over 10 years in the future or the past.\n\n</div>\n\n---\n\n## Keyboard accessibility\n\nCalendar component is built to closely follow [W3C Date Picker Dialog example](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/datepicker-dialog.html) with some small exceptions to e.g. better support iOS VoiceOver and Android TalkBack.\n\n### Month/year buttons\n\n- `Space, Enter`: Changes the month and/or year displayed.\n\n### Calendar grid\n\n- `Space, Enter`: Selects a date.\n- `Arrow up`: Moves focus to the same day of the previous week.\n- `Arrow down`: Moves focus to the same day of the next week.\n- `Arrow right`: Moves focus to the next day. In right-to-left languages, moves focus to the previous day.\n- `Arrow left`: Moves focus to the previous day. In right-to-left languages, moves focus to the next day.\n- `Home`: Moves focus to the first day (e.g Monday) of the current week.\n- `End`: Moves focus to the last day (e.g. Sunday) of the current week.\n- `Page Up`: Changes the grid of dates to the previous month and sets focus on the same day of the same week.\n- `Shift + Page Up`: Changes the grid of dates to the previous year and sets focus on the same day of the same week.\n- `Page Down`: Changes the grid of dates to the next month and sets focus on the same day of the same week.\n- `Shift + Page Down`: Changes the grid of dates to the next year and sets focus on the same day of the same week.\n"
1911
- },
1912
- {
1913
- "kind": "javascript-module",
1914
- "path": "src/card/Card.ts",
1915
- "declarations": [
1916
- {
1917
- "kind": "class",
1918
- "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.",
1919
- "name": "Card",
1920
- "slots": [
1982
+ "description": "Label for the input.",
1983
+ "fieldName": "label",
1984
+ "inheritedFrom": {
1985
+ "name": "FormAssociatedMixin",
1986
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1987
+ }
1988
+ },
1921
1989
  {
1922
- "description": "The card content.",
1923
- "name": ""
1990
+ "name": "hint",
1991
+ "type": {
1992
+ "text": "string | undefined"
1993
+ },
1994
+ "description": "Optional hint text to be displayed with the input. Alternatively use the hint slot.",
1995
+ "fieldName": "hint",
1996
+ "inheritedFrom": {
1997
+ "name": "FormAssociatedMixin",
1998
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
1999
+ }
1924
2000
  },
1925
2001
  {
1926
- "description": "Optional slot that holds a header for the card.",
1927
- "name": "header"
2002
+ "name": "hide-label",
2003
+ "type": {
2004
+ "text": "boolean"
2005
+ },
2006
+ "default": "false",
2007
+ "description": "Visually hide the label, but still show it to assistive technologies like screen readers.",
2008
+ "fieldName": "hideLabel",
2009
+ "inheritedFrom": {
2010
+ "name": "FormAssociatedMixin",
2011
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
2012
+ }
1928
2013
  },
1929
2014
  {
1930
- "description": "Optional slot that holds footer content for the card.",
1931
- "name": "footer"
1932
- }
1933
- ],
1934
- "members": [
2015
+ "name": "placeholder",
2016
+ "type": {
2017
+ "text": "string | undefined"
2018
+ },
2019
+ "description": "Placeholder text to display within the input.",
2020
+ "fieldName": "placeholder",
2021
+ "inheritedFrom": {
2022
+ "name": "FormAssociatedMixin",
2023
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
2024
+ }
2025
+ },
1935
2026
  {
1936
- "kind": "field",
1937
- "name": "headerSlot",
1938
- "privacy": "private",
1939
- "default": "new SlotController(this, \"header\")"
2027
+ "name": "error",
2028
+ "type": {
2029
+ "text": "string | undefined"
2030
+ },
2031
+ "description": "Optional error to be shown with the input. Alternatively use the error slot.",
2032
+ "fieldName": "error",
2033
+ "inheritedFrom": {
2034
+ "name": "FormAssociatedMixin",
2035
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
2036
+ }
1940
2037
  },
1941
2038
  {
1942
- "kind": "field",
1943
- "name": "footerSlot",
1944
- "privacy": "private",
1945
- "default": "new SlotController(this, \"footer\")"
2039
+ "name": "required",
2040
+ "type": {
2041
+ "text": "boolean"
2042
+ },
2043
+ "default": "false",
2044
+ "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.",
2045
+ "fieldName": "required",
2046
+ "inheritedFrom": {
2047
+ "name": "FormAssociatedMixin",
2048
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
2049
+ }
1946
2050
  },
1947
2051
  {
1948
- "kind": "field",
1949
- "name": "padding",
2052
+ "name": "expand",
1950
2053
  "type": {
1951
- "text": "\"m\" | \"l\" | \"none\""
2054
+ "text": "boolean"
1952
2055
  },
1953
- "default": "\"m\"",
1954
- "description": "Controls the padding of card component. When set to “none”,\nthe header and footer slots will still have padding.",
1955
- "attribute": "padding",
1956
- "reflects": true
2056
+ "default": "false",
2057
+ "description": "Controls whether the input expands to fill the width of its container.",
2058
+ "fieldName": "expand",
2059
+ "inheritedFrom": {
2060
+ "name": "FormAssociatedMixin",
2061
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
2062
+ }
1957
2063
  },
1958
2064
  {
1959
- "kind": "field",
1960
- "name": "_warningLogged",
2065
+ "name": "disabled",
1961
2066
  "type": {
1962
2067
  "text": "boolean"
1963
2068
  },
1964
- "privacy": "private",
1965
- "static": true,
1966
2069
  "default": "false",
2070
+ "description": "Makes the component disabled. This prevents users from\nbeing able to interact with the component, and conveys\nits inactive state to assistive technologies.",
2071
+ "fieldName": "disabled",
1967
2072
  "inheritedFrom": {
1968
- "name": "DraftComponentMixin",
1969
- "module": "src/common/mixins/DraftComponentMixin.ts"
2073
+ "name": "InputMixin",
2074
+ "module": "src/common/mixins/InputMixin.ts"
1970
2075
  }
1971
- }
1972
- ],
1973
- "attributes": [
2076
+ },
1974
2077
  {
1975
- "name": "padding",
2078
+ "name": "name",
1976
2079
  "type": {
1977
- "text": "\"m\" | \"l\" | \"none\""
2080
+ "text": "string | undefined"
1978
2081
  },
1979
- "default": "\"m\"",
1980
- "description": "Controls the padding of card component. When set to “none”,\nthe header and footer slots will still have padding.",
1981
- "fieldName": "padding"
2082
+ "description": "The name of the form component.",
2083
+ "fieldName": "name",
2084
+ "inheritedFrom": {
2085
+ "name": "InputMixin",
2086
+ "module": "src/common/mixins/InputMixin.ts"
2087
+ }
2088
+ },
2089
+ {
2090
+ "name": "value",
2091
+ "type": {
2092
+ "text": "string"
2093
+ },
2094
+ "default": "\"\"",
2095
+ "description": "The value of the form component.",
2096
+ "fieldName": "value",
2097
+ "inheritedFrom": {
2098
+ "name": "InputMixin",
2099
+ "module": "src/common/mixins/InputMixin.ts"
2100
+ }
1982
2101
  }
1983
2102
  ],
1984
2103
  "mixins": [
2104
+ {
2105
+ "name": "FormAssociatedMixin",
2106
+ "module": "/src/common/mixins/FormAssociatedMixin.js"
2107
+ },
2108
+ {
2109
+ "name": "InputMixin",
2110
+ "module": "/src/common/mixins/InputMixin.js"
2111
+ },
2112
+ {
2113
+ "name": "FocusableMixin",
2114
+ "module": "/src/common/mixins/FocusableMixin.js"
2115
+ },
1985
2116
  {
1986
2117
  "name": "DraftComponentMixin",
1987
2118
  "module": "/src/common/mixins/DraftComponentMixin.js"
@@ -1992,9 +2123,33 @@
1992
2123
  "package": "lit"
1993
2124
  },
1994
2125
  "status": "draft",
1995
- "category": "structure",
1996
- "tagName": "nord-card",
1997
- "customElement": true
2126
+ "category": "form",
2127
+ "tagName": "nord-checkbox",
2128
+ "customElement": true,
2129
+ "events": [
2130
+ {
2131
+ "name": "input",
2132
+ "type": {
2133
+ "text": "NordEvent"
2134
+ },
2135
+ "description": "Fired as the user types into the input.",
2136
+ "inheritedFrom": {
2137
+ "name": "FormAssociatedMixin",
2138
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
2139
+ }
2140
+ },
2141
+ {
2142
+ "name": "change",
2143
+ "type": {
2144
+ "text": "NordEvent"
2145
+ },
2146
+ "description": "Fired whenever the input's value is changed via user interaction.",
2147
+ "inheritedFrom": {
2148
+ "name": "FormAssociatedMixin",
2149
+ "module": "src/common/mixins/FormAssociatedMixin.ts"
2150
+ }
2151
+ }
2152
+ ]
1998
2153
  }
1999
2154
  ],
2000
2155
  "exports": [
@@ -2002,20 +2157,20 @@
2002
2157
  "kind": "js",
2003
2158
  "name": "default",
2004
2159
  "declaration": {
2005
- "name": "Card",
2006
- "module": "src/card/Card.ts"
2160
+ "name": "Checkbox",
2161
+ "module": "src/checkbox/Checkbox.ts"
2007
2162
  }
2008
2163
  },
2009
2164
  {
2010
2165
  "kind": "custom-element-definition",
2011
- "name": "nord-card",
2166
+ "name": "nord-checkbox",
2012
2167
  "declaration": {
2013
- "name": "Card",
2014
- "module": "src/card/Card.ts"
2168
+ "name": "Checkbox",
2169
+ "module": "src/checkbox/Checkbox.ts"
2015
2170
  }
2016
2171
  }
2017
2172
  ],
2018
- "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\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\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"
2173
+ "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 for making it possible to choose one or more options from a limited number of options.\n- Use for “accepting terms of service” and similar functionality.\n- Use in forms to toggle something on or off.\n\n</div>\n<div class=\"n-usage n-usage-dont\">\n\n### Don’t\n\n- Don’t use when you have more than 10 options to choose from.\n- Don’t change the selection of another checkbox when another one is clicked. Only exception is when a checkbox is used to make a bulk selection of multiple items.\n\n</div>\n\n---\n\n## Content guidelines\n\nCheckbox labels should be clear, accurate and predictable. It should be possible for the user to understand what they are selecting:\n\n<div class=\"n-usage n-usage-do\">User settings</div>\n<div class=\"n-usage n-usage-dont\">Option 1</div>\n\nWhen writing checkbox 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\">User settings</div>\n<div class=\"n-usage n-usage-dont\">User Settings</div>\n\nAvoid ending in punctuation if it’s a single sentence, word, or a fragment:\n\n<div class=\"n-usage n-usage-do\">Show dashboard</div>\n<div class=\"n-usage n-usage-dont\">Show dashboard.</div>\n\nDo not use commas or semicolons at the end of each line\n\n<div class=\"n-usage n-usage-do\">Patients</div>\n<div class=\"n-usage n-usage-dont\">Patients;</div>\n"
2019
2174
  },
2020
2175
  {
2021
2176
  "kind": "javascript-module",
@@ -3380,6 +3535,34 @@
3380
3535
  }
3381
3536
  ]
3382
3537
  },
3538
+ {
3539
+ "kind": "javascript-module",
3540
+ "path": "src/common/fsm.ts",
3541
+ "declarations": [
3542
+ {
3543
+ "kind": "function",
3544
+ "name": "fsm",
3545
+ "parameters": [
3546
+ {
3547
+ "name": "config",
3548
+ "type": {
3549
+ "text": "TTransitions"
3550
+ }
3551
+ }
3552
+ ]
3553
+ }
3554
+ ],
3555
+ "exports": [
3556
+ {
3557
+ "kind": "js",
3558
+ "name": "fsm",
3559
+ "declaration": {
3560
+ "name": "fsm",
3561
+ "module": "src/common/fsm.ts"
3562
+ }
3563
+ }
3564
+ ]
3565
+ },
3383
3566
  {
3384
3567
  "kind": "javascript-module",
3385
3568
  "path": "src/common/input.ts",
@@ -3997,6 +4180,14 @@
3997
4180
  "kind": "method",
3998
4181
  "name": "handleChange",
3999
4182
  "privacy": "protected",
4183
+ "parameters": [
4184
+ {
4185
+ "name": "e",
4186
+ "type": {
4187
+ "text": "Event"
4188
+ }
4189
+ }
4190
+ ],
4000
4191
  "inheritedFrom": {
4001
4192
  "name": "FormAssociatedMixin",
4002
4193
  "module": "src/common/mixins/FormAssociatedMixin.ts"
@@ -5263,6 +5454,14 @@
5263
5454
  "kind": "method",
5264
5455
  "name": "handleChange",
5265
5456
  "privacy": "protected",
5457
+ "parameters": [
5458
+ {
5459
+ "name": "e",
5460
+ "type": {
5461
+ "text": "Event"
5462
+ }
5463
+ }
5464
+ ],
5266
5465
  "inheritedFrom": {
5267
5466
  "name": "FormAssociatedMixin",
5268
5467
  "module": "src/common/mixins/FormAssociatedMixin.ts"
@@ -6282,11 +6481,6 @@
6282
6481
  "kind": "method",
6283
6482
  "name": "handleChange",
6284
6483
  "privacy": "protected",
6285
- "return": {
6286
- "type": {
6287
- "text": "void"
6288
- }
6289
- },
6290
6484
  "parameters": [
6291
6485
  {
6292
6486
  "name": "e",
@@ -6295,6 +6489,11 @@
6295
6489
  }
6296
6490
  }
6297
6491
  ],
6492
+ "return": {
6493
+ "type": {
6494
+ "text": "void"
6495
+ }
6496
+ },
6298
6497
  "inheritedFrom": {
6299
6498
  "name": "FormAssociatedMixin",
6300
6499
  "module": "src/common/mixins/FormAssociatedMixin.ts"
@@ -7083,6 +7282,14 @@
7083
7282
  "kind": "method",
7084
7283
  "name": "handleChange",
7085
7284
  "privacy": "protected",
7285
+ "parameters": [
7286
+ {
7287
+ "name": "e",
7288
+ "type": {
7289
+ "text": "Event"
7290
+ }
7291
+ }
7292
+ ],
7086
7293
  "inheritedFrom": {
7087
7294
  "name": "FormAssociatedMixin",
7088
7295
  "module": "src/common/mixins/FormAssociatedMixin.ts"
@@ -8043,6 +8250,14 @@
8043
8250
  "kind": "method",
8044
8251
  "name": "handleChange",
8045
8252
  "privacy": "protected",
8253
+ "parameters": [
8254
+ {
8255
+ "name": "e",
8256
+ "type": {
8257
+ "text": "Event"
8258
+ }
8259
+ }
8260
+ ],
8046
8261
  "inheritedFrom": {
8047
8262
  "name": "FormAssociatedMixin",
8048
8263
  "module": "src/common/mixins/FormAssociatedMixin.ts"
@@ -10128,7 +10343,15 @@
10128
10343
  {
10129
10344
  "kind": "method",
10130
10345
  "name": "handleChange",
10131
- "privacy": "protected"
10346
+ "privacy": "protected",
10347
+ "parameters": [
10348
+ {
10349
+ "name": "e",
10350
+ "type": {
10351
+ "text": "Event"
10352
+ }
10353
+ }
10354
+ ]
10132
10355
  },
10133
10356
  {
10134
10357
  "kind": "method",