@momentum-design/components 0.130.8 → 0.131.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -45334,6 +45334,1224 @@
45334
45334
  }
45335
45335
  ]
45336
45336
  },
45337
+ {
45338
+ "kind": "javascript-module",
45339
+ "path": "components/timepicker/timepicker.component.js",
45340
+ "declarations": [
45341
+ {
45342
+ "kind": "class",
45343
+ "description": "mdc-timepicker is a component that allows users to select a specific time\nor enter a time manually. It supports both 12-hour and 24-hour formats.\n\nThe component consists of:\n- label - describes the time picker field\n- input field - made up of 2-3 spinbuttons (hours, minutes, optional AM/PM period)\n- dropdown arrow button - opens a flyout menu with predefined time intervals\n- helper text - displayed below the input field\n\nUsers can input values by:\n- Manually entering numbers/characters in spinbuttons\n- Navigating using arrow keys to increment/decrement values\n- Selecting a predefined time from the dropdown menu",
45344
+ "name": "TimePicker",
45345
+ "cssProperties": [
45346
+ {
45347
+ "description": "Background color of the timepicker input.",
45348
+ "name": "--mdc-timepicker-background-color"
45349
+ },
45350
+ {
45351
+ "description": "Border color of the timepicker input.",
45352
+ "name": "--mdc-timepicker-border-color"
45353
+ },
45354
+ {
45355
+ "description": "Text color of the timepicker input.",
45356
+ "name": "--mdc-timepicker-text-color"
45357
+ },
45358
+ {
45359
+ "description": "Width of the timepicker component.",
45360
+ "name": "--mdc-timepicker-width"
45361
+ },
45362
+ {
45363
+ "description": "Font size for the label text.",
45364
+ "name": "--mdc-label-font-size",
45365
+ "inheritedFrom": {
45366
+ "name": "FormfieldWrapper",
45367
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45368
+ }
45369
+ },
45370
+ {
45371
+ "description": "Font weight for the label text.",
45372
+ "name": "--mdc-label-font-weight",
45373
+ "inheritedFrom": {
45374
+ "name": "FormfieldWrapper",
45375
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45376
+ }
45377
+ },
45378
+ {
45379
+ "description": "Line height for the label text.",
45380
+ "name": "--mdc-label-line-height",
45381
+ "inheritedFrom": {
45382
+ "name": "FormfieldWrapper",
45383
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45384
+ }
45385
+ },
45386
+ {
45387
+ "description": "Color for the label text.",
45388
+ "name": "--mdc-label-color",
45389
+ "inheritedFrom": {
45390
+ "name": "FormfieldWrapper",
45391
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45392
+ }
45393
+ },
45394
+ {
45395
+ "description": "Font size for the help text.",
45396
+ "name": "--mdc-help-text-font-size",
45397
+ "inheritedFrom": {
45398
+ "name": "FormfieldWrapper",
45399
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45400
+ }
45401
+ },
45402
+ {
45403
+ "description": "Font weight for the help text.",
45404
+ "name": "--mdc-help-text-font-weight",
45405
+ "inheritedFrom": {
45406
+ "name": "FormfieldWrapper",
45407
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45408
+ }
45409
+ },
45410
+ {
45411
+ "description": "Line height for the help text.",
45412
+ "name": "--mdc-help-text-line-height",
45413
+ "inheritedFrom": {
45414
+ "name": "FormfieldWrapper",
45415
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45416
+ }
45417
+ },
45418
+ {
45419
+ "description": "Color for the help text.",
45420
+ "name": "--mdc-help-text-color",
45421
+ "inheritedFrom": {
45422
+ "name": "FormfieldWrapper",
45423
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45424
+ }
45425
+ },
45426
+ {
45427
+ "description": "Color for the required indicator text.",
45428
+ "name": "--mdc-required-indicator-color",
45429
+ "inheritedFrom": {
45430
+ "name": "FormfieldWrapper",
45431
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45432
+ }
45433
+ }
45434
+ ],
45435
+ "cssParts": [
45436
+ {
45437
+ "description": "The label element.",
45438
+ "name": "label",
45439
+ "inheritedFrom": {
45440
+ "name": "FormfieldWrapper",
45441
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45442
+ }
45443
+ },
45444
+ {
45445
+ "description": "The container for the label and required indicator elements.",
45446
+ "name": "label-text",
45447
+ "inheritedFrom": {
45448
+ "name": "FormfieldWrapper",
45449
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45450
+ }
45451
+ },
45452
+ {
45453
+ "description": "The required indicator element.",
45454
+ "name": "required-indicator",
45455
+ "inheritedFrom": {
45456
+ "name": "FormfieldWrapper",
45457
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45458
+ }
45459
+ },
45460
+ {
45461
+ "description": "The info icon button element.",
45462
+ "name": "info-icon-btn",
45463
+ "inheritedFrom": {
45464
+ "name": "FormfieldWrapper",
45465
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45466
+ }
45467
+ },
45468
+ {
45469
+ "description": "The toggletip element.",
45470
+ "name": "label-toggletip",
45471
+ "inheritedFrom": {
45472
+ "name": "FormfieldWrapper",
45473
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45474
+ }
45475
+ },
45476
+ {
45477
+ "description": "The helper/validation text element.",
45478
+ "name": "help-text",
45479
+ "inheritedFrom": {
45480
+ "name": "FormfieldWrapper",
45481
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45482
+ }
45483
+ },
45484
+ {
45485
+ "description": "The helper/validation icon element.",
45486
+ "name": "helper-icon",
45487
+ "inheritedFrom": {
45488
+ "name": "FormfieldWrapper",
45489
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45490
+ }
45491
+ },
45492
+ {
45493
+ "description": "The container for helper/validation elements.",
45494
+ "name": "help-text-container",
45495
+ "inheritedFrom": {
45496
+ "name": "FormfieldWrapper",
45497
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45498
+ }
45499
+ },
45500
+ {
45501
+ "description": "The outer container for the input and popover.",
45502
+ "name": "container"
45503
+ },
45504
+ {
45505
+ "description": "The input container with border and background.",
45506
+ "name": "base-container"
45507
+ },
45508
+ {
45509
+ "description": "The container for spinbutton elements.",
45510
+ "name": "spinbutton-group"
45511
+ },
45512
+ {
45513
+ "description": "A spinbutton input element.",
45514
+ "name": "spinbutton"
45515
+ },
45516
+ {
45517
+ "description": "The colon separator between spinbuttons.",
45518
+ "name": "separator"
45519
+ },
45520
+ {
45521
+ "description": "The AM/PM period spinbutton.",
45522
+ "name": "period"
45523
+ },
45524
+ {
45525
+ "description": "The dropdown arrow button container.",
45526
+ "name": "icon-container"
45527
+ },
45528
+ {
45529
+ "description": "The hidden native input for form participation.",
45530
+ "name": "native-input"
45531
+ },
45532
+ {
45533
+ "description": "The dropdown list container.",
45534
+ "name": "listbox"
45535
+ }
45536
+ ],
45537
+ "slots": [
45538
+ {
45539
+ "description": "Slot for the label element.",
45540
+ "name": "label",
45541
+ "inheritedFrom": {
45542
+ "name": "FormfieldWrapper",
45543
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45544
+ }
45545
+ },
45546
+ {
45547
+ "description": "Slot for the toggletip info icon button.",
45548
+ "name": "toggletip",
45549
+ "inheritedFrom": {
45550
+ "name": "FormfieldWrapper",
45551
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45552
+ }
45553
+ },
45554
+ {
45555
+ "description": "Slot for the helper/validation icon.",
45556
+ "name": "help-icon",
45557
+ "inheritedFrom": {
45558
+ "name": "FormfieldWrapper",
45559
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45560
+ }
45561
+ },
45562
+ {
45563
+ "description": "Slot for the helper/validation text.",
45564
+ "name": "help-text",
45565
+ "inheritedFrom": {
45566
+ "name": "FormfieldWrapper",
45567
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
45568
+ }
45569
+ }
45570
+ ],
45571
+ "members": [
45572
+ {
45573
+ "kind": "field",
45574
+ "name": "appendTo",
45575
+ "type": {
45576
+ "text": "string | undefined"
45577
+ },
45578
+ "description": "Element ID that the popover will be appended to.\nThis is useful when the timepicker is inside a scrollable container\nand the popover needs to be portalled to avoid clipping.",
45579
+ "attribute": "append-to",
45580
+ "reflects": true
45581
+ },
45582
+ {
45583
+ "kind": "field",
45584
+ "name": "backdropAppendTo",
45585
+ "type": {
45586
+ "text": "string | undefined"
45587
+ },
45588
+ "description": "Element ID the backdrop will be appended to (if backdrop is enabled).\nThis is useful to ensure that the backdrop is appended to the correct element in the DOM.\nIf not set, the backdrop will be appended to the parent element of the timepicker.",
45589
+ "attribute": "backdrop-append-to",
45590
+ "reflects": true
45591
+ },
45592
+ {
45593
+ "kind": "method",
45594
+ "name": "checkValidity",
45595
+ "return": {
45596
+ "type": {
45597
+ "text": "boolean"
45598
+ }
45599
+ },
45600
+ "inheritedFrom": {
45601
+ "name": "FormInternalsMixin",
45602
+ "module": "utils/mixins/FormInternalsMixin.js"
45603
+ }
45604
+ },
45605
+ {
45606
+ "kind": "field",
45607
+ "name": "dataAriaLabel",
45608
+ "type": {
45609
+ "text": "string | null"
45610
+ },
45611
+ "default": "null",
45612
+ "description": "Defines a string value that labels the current element.\nThe Aria-Label attribute to be set for accessibility.",
45613
+ "attribute": "data-aria-label",
45614
+ "reflects": true,
45615
+ "inheritedFrom": {
45616
+ "name": "DataAriaLabelMixin",
45617
+ "module": "utils/mixins/DataAriaLabelMixin.js"
45618
+ }
45619
+ },
45620
+ {
45621
+ "kind": "field",
45622
+ "name": "disabled",
45623
+ "type": {
45624
+ "text": "boolean | undefined"
45625
+ },
45626
+ "description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
45627
+ "default": "undefined",
45628
+ "attribute": "disabled",
45629
+ "reflects": true,
45630
+ "inheritedFrom": {
45631
+ "name": "FormfieldWrapper",
45632
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45633
+ }
45634
+ },
45635
+ {
45636
+ "kind": "field",
45637
+ "name": "disableFlip",
45638
+ "type": {
45639
+ "text": "boolean"
45640
+ },
45641
+ "description": "Determines whether the dropdown should flip its position when it hits the boundary.",
45642
+ "default": "false",
45643
+ "attribute": "disable-flip",
45644
+ "reflects": true
45645
+ },
45646
+ {
45647
+ "kind": "field",
45648
+ "name": "helpText",
45649
+ "type": {
45650
+ "text": "string | undefined"
45651
+ },
45652
+ "description": "The help text that is displayed below the input field.",
45653
+ "attribute": "help-text",
45654
+ "reflects": true,
45655
+ "inheritedFrom": {
45656
+ "name": "FormfieldWrapper",
45657
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45658
+ }
45659
+ },
45660
+ {
45661
+ "kind": "field",
45662
+ "name": "helpTextType",
45663
+ "type": {
45664
+ "text": "ValidationType"
45665
+ },
45666
+ "description": "The type of help text. It can be 'default', 'error', 'warning', 'success', 'priority'.",
45667
+ "default": "'default'",
45668
+ "attribute": "help-text-type",
45669
+ "reflects": true,
45670
+ "inheritedFrom": {
45671
+ "name": "FormfieldWrapper",
45672
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45673
+ }
45674
+ },
45675
+ {
45676
+ "kind": "field",
45677
+ "name": "infoIconAriaLabel",
45678
+ "type": {
45679
+ "text": "string | undefined"
45680
+ },
45681
+ "description": "Aria label for the info icon that is displayed next to the label when `toggletipText` is set.\nThis is used for accessibility purposes to provide a description of the icon.",
45682
+ "attribute": "info-icon-aria-label",
45683
+ "reflects": true,
45684
+ "inheritedFrom": {
45685
+ "name": "FormfieldWrapper",
45686
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45687
+ }
45688
+ },
45689
+ {
45690
+ "kind": "field",
45691
+ "name": "interval",
45692
+ "type": {
45693
+ "text": "number"
45694
+ },
45695
+ "description": "The interval in minutes between time options in the dropdown menu.",
45696
+ "default": "30",
45697
+ "attribute": "interval",
45698
+ "reflects": true
45699
+ },
45700
+ {
45701
+ "kind": "field",
45702
+ "name": "label",
45703
+ "type": {
45704
+ "text": "string | undefined"
45705
+ },
45706
+ "description": "The label of the input field. It is linked to the input field using the `for` attribute.",
45707
+ "attribute": "label",
45708
+ "reflects": true,
45709
+ "inheritedFrom": {
45710
+ "name": "FormfieldWrapper",
45711
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45712
+ }
45713
+ },
45714
+ {
45715
+ "kind": "field",
45716
+ "name": "localeAmLabel",
45717
+ "type": {
45718
+ "text": "string"
45719
+ },
45720
+ "default": "''",
45721
+ "description": "Label for the AM period.\nConsumers must provide a translated string.",
45722
+ "attribute": "locale-am-label"
45723
+ },
45724
+ {
45725
+ "kind": "field",
45726
+ "name": "localeHoursLabel",
45727
+ "type": {
45728
+ "text": "string"
45729
+ },
45730
+ "default": "''",
45731
+ "description": "Accessible label for the hours spinbutton.\nConsumers must provide a translated string.",
45732
+ "attribute": "locale-hours-label"
45733
+ },
45734
+ {
45735
+ "kind": "field",
45736
+ "name": "localeHoursPlaceholder",
45737
+ "type": {
45738
+ "text": "string"
45739
+ },
45740
+ "default": "''",
45741
+ "description": "Placeholder text for the hours spinbutton.\nConsumers must provide a translated string.",
45742
+ "attribute": "locale-hours-placeholder"
45743
+ },
45744
+ {
45745
+ "kind": "field",
45746
+ "name": "localeMinutesLabel",
45747
+ "type": {
45748
+ "text": "string"
45749
+ },
45750
+ "default": "''",
45751
+ "description": "Accessible label for the minutes spinbutton.\nConsumers must provide a translated string.",
45752
+ "attribute": "locale-minutes-label"
45753
+ },
45754
+ {
45755
+ "kind": "field",
45756
+ "name": "localeMinutesPlaceholder",
45757
+ "type": {
45758
+ "text": "string"
45759
+ },
45760
+ "default": "''",
45761
+ "description": "Placeholder text for the minutes spinbutton.\nConsumers must provide a translated string.",
45762
+ "attribute": "locale-minutes-placeholder"
45763
+ },
45764
+ {
45765
+ "kind": "field",
45766
+ "name": "localePeriodLabel",
45767
+ "type": {
45768
+ "text": "string"
45769
+ },
45770
+ "default": "''",
45771
+ "description": "Accessible label for the period (AM/PM) spinbutton.\nConsumers must provide a translated string.",
45772
+ "attribute": "locale-period-label"
45773
+ },
45774
+ {
45775
+ "kind": "field",
45776
+ "name": "localePeriodPlaceholder",
45777
+ "type": {
45778
+ "text": "string"
45779
+ },
45780
+ "default": "''",
45781
+ "description": "Placeholder text for the period spinbutton.\nConsumers must provide a translated string.",
45782
+ "attribute": "locale-period-placeholder"
45783
+ },
45784
+ {
45785
+ "kind": "field",
45786
+ "name": "localePmLabel",
45787
+ "type": {
45788
+ "text": "string"
45789
+ },
45790
+ "default": "''",
45791
+ "description": "Label for the PM period.\nConsumers must provide a translated string.",
45792
+ "attribute": "locale-pm-label"
45793
+ },
45794
+ {
45795
+ "kind": "field",
45796
+ "name": "localeShowTimePickerLabel",
45797
+ "type": {
45798
+ "text": "string"
45799
+ },
45800
+ "default": "''",
45801
+ "description": "Accessible label for the dropdown toggle button.\nConsumers must provide a translated string.",
45802
+ "attribute": "locale-show-time-picker-label"
45803
+ },
45804
+ {
45805
+ "kind": "field",
45806
+ "name": "localeSpinbuttonDescription",
45807
+ "type": {
45808
+ "text": "string"
45809
+ },
45810
+ "default": "''",
45811
+ "description": "Accessible description for spinbutton inputs (instruction text).\nConsumers must provide a translated string.",
45812
+ "attribute": "locale-spinbutton-description"
45813
+ },
45814
+ {
45815
+ "kind": "field",
45816
+ "name": "localeTimeOptionsLabel",
45817
+ "type": {
45818
+ "text": "string"
45819
+ },
45820
+ "default": "''",
45821
+ "description": "Accessible label for the time options listbox.\nConsumers must provide a translated string.",
45822
+ "attribute": "locale-time-options-label"
45823
+ },
45824
+ {
45825
+ "kind": "field",
45826
+ "name": "max",
45827
+ "type": {
45828
+ "text": "string | undefined"
45829
+ },
45830
+ "description": "The maximum allowed time value in 24-hour format (HH:MM).",
45831
+ "attribute": "max",
45832
+ "reflects": true
45833
+ },
45834
+ {
45835
+ "kind": "field",
45836
+ "name": "min",
45837
+ "type": {
45838
+ "text": "string | undefined"
45839
+ },
45840
+ "description": "The minimum allowed time value in 24-hour format (HH:MM).",
45841
+ "attribute": "min",
45842
+ "reflects": true
45843
+ },
45844
+ {
45845
+ "kind": "field",
45846
+ "name": "name",
45847
+ "type": {
45848
+ "text": "string"
45849
+ },
45850
+ "default": "''",
45851
+ "description": "Indicates the name of the component group.\nThey are used to group elements in a form together.",
45852
+ "attribute": "name",
45853
+ "reflects": true,
45854
+ "inheritedFrom": {
45855
+ "name": "FormInternalsMixin",
45856
+ "module": "utils/mixins/FormInternalsMixin.js"
45857
+ }
45858
+ },
45859
+ {
45860
+ "kind": "field",
45861
+ "name": "placement",
45862
+ "type": {
45863
+ "text": "Placement"
45864
+ },
45865
+ "description": "The placement of the popover dropdown.",
45866
+ "default": "'bottom-start'",
45867
+ "attribute": "placement",
45868
+ "reflects": true
45869
+ },
45870
+ {
45871
+ "kind": "field",
45872
+ "name": "readonly",
45873
+ "type": {
45874
+ "text": "boolean"
45875
+ },
45876
+ "default": "false",
45877
+ "description": "Determines whether the form field is read-only.",
45878
+ "attribute": "readonly",
45879
+ "reflects": true,
45880
+ "inheritedFrom": {
45881
+ "name": "FormfieldWrapper",
45882
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45883
+ }
45884
+ },
45885
+ {
45886
+ "kind": "method",
45887
+ "name": "renderHelperText",
45888
+ "privacy": "protected",
45889
+ "description": "renders the help-text container that contains the helpertext icon and helpertext.",
45890
+ "return": {
45891
+ "type": {
45892
+ "text": ""
45893
+ }
45894
+ },
45895
+ "inheritedFrom": {
45896
+ "name": "FormfieldWrapper",
45897
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45898
+ }
45899
+ },
45900
+ {
45901
+ "kind": "method",
45902
+ "name": "renderHelpText",
45903
+ "privacy": "protected",
45904
+ "description": "creates the helper text component when the helpertext value is set.\nIt is also used to display the validation message based on the helpTextType.",
45905
+ "return": {
45906
+ "type": {
45907
+ "text": ""
45908
+ }
45909
+ },
45910
+ "inheritedFrom": {
45911
+ "name": "FormfieldWrapper",
45912
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45913
+ }
45914
+ },
45915
+ {
45916
+ "kind": "method",
45917
+ "name": "renderHelpTextIcon",
45918
+ "privacy": "protected",
45919
+ "description": "creates the helpertext icon based on the helpTextType for validation.\nIf the helpTextType is not set, it defaults to 'default' and it doesn't display any icon.",
45920
+ "return": {
45921
+ "type": {
45922
+ "text": ""
45923
+ }
45924
+ },
45925
+ "inheritedFrom": {
45926
+ "name": "FormfieldWrapper",
45927
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45928
+ }
45929
+ },
45930
+ {
45931
+ "kind": "method",
45932
+ "name": "renderLabel",
45933
+ "privacy": "protected",
45934
+ "description": "renders the label container that contains the label and labelInfoToggleTip.",
45935
+ "return": {
45936
+ "type": {
45937
+ "text": ""
45938
+ }
45939
+ },
45940
+ "inheritedFrom": {
45941
+ "name": "FormfieldWrapper",
45942
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45943
+ }
45944
+ },
45945
+ {
45946
+ "kind": "method",
45947
+ "name": "renderLabelElement",
45948
+ "privacy": "protected",
45949
+ "description": "creates the label element when the label property is set.\nid is used to link the label with the input field.",
45950
+ "return": {
45951
+ "type": {
45952
+ "text": ""
45953
+ }
45954
+ },
45955
+ "inheritedFrom": {
45956
+ "name": "FormfieldWrapper",
45957
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45958
+ }
45959
+ },
45960
+ {
45961
+ "kind": "method",
45962
+ "name": "reportValidity",
45963
+ "inheritedFrom": {
45964
+ "name": "FormInternalsMixin",
45965
+ "module": "utils/mixins/FormInternalsMixin.js"
45966
+ }
45967
+ },
45968
+ {
45969
+ "kind": "field",
45970
+ "name": "required",
45971
+ "type": {
45972
+ "text": "boolean"
45973
+ },
45974
+ "default": "false",
45975
+ "description": "The required attribute to indicate that the input field is required.\nIt is used to append a required indicator (*) to the label.",
45976
+ "attribute": "required",
45977
+ "reflects": true,
45978
+ "inheritedFrom": {
45979
+ "name": "FormfieldWrapper",
45980
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
45981
+ }
45982
+ },
45983
+ {
45984
+ "kind": "method",
45985
+ "name": "setValidity",
45986
+ "description": "Sets the validity of the input field based on the input field's validity.",
45987
+ "return": {
45988
+ "type": {
45989
+ "text": ""
45990
+ }
45991
+ },
45992
+ "inheritedFrom": {
45993
+ "name": "FormInternalsMixin",
45994
+ "module": "utils/mixins/FormInternalsMixin.js"
45995
+ }
45996
+ },
45997
+ {
45998
+ "kind": "field",
45999
+ "name": "softDisabled",
46000
+ "type": {
46001
+ "text": "boolean"
46002
+ },
46003
+ "default": "false",
46004
+ "description": "Determines whether the form field is soft-disabled.",
46005
+ "attribute": "soft-disabled",
46006
+ "reflects": true,
46007
+ "inheritedFrom": {
46008
+ "name": "FormfieldWrapper",
46009
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
46010
+ }
46011
+ },
46012
+ {
46013
+ "kind": "field",
46014
+ "name": "strategy",
46015
+ "type": {
46016
+ "text": "PopoverStrategy"
46017
+ },
46018
+ "description": "The strategy for positioning the popover.",
46019
+ "default": "'absolute'",
46020
+ "attribute": "strategy",
46021
+ "reflects": true
46022
+ },
46023
+ {
46024
+ "kind": "field",
46025
+ "name": "timeFormat",
46026
+ "type": {
46027
+ "text": "TimeFormat"
46028
+ },
46029
+ "description": "The time format to use for display.\n- `'12h'`: 12-hour format with AM/PM period\n- `'24h'`: 24-hour format without period",
46030
+ "default": "'12h'",
46031
+ "attribute": "time-format",
46032
+ "reflects": true
46033
+ },
46034
+ {
46035
+ "kind": "field",
46036
+ "name": "toggletipPlacement",
46037
+ "type": {
46038
+ "text": "PopoverPlacement"
46039
+ },
46040
+ "description": "The placement of the toggletip that is displayed when the info icon is clicked or pressed.",
46041
+ "default": "'top'",
46042
+ "attribute": "toggletip-placement",
46043
+ "reflects": true,
46044
+ "inheritedFrom": {
46045
+ "name": "FormfieldWrapper",
46046
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
46047
+ }
46048
+ },
46049
+ {
46050
+ "kind": "field",
46051
+ "name": "toggletipStrategy",
46052
+ "type": {
46053
+ "text": "PopoverStrategy"
46054
+ },
46055
+ "description": "The positioning strategy for the toggletip.\n- **absolute**: Positioned relative to the nearest positioned ancestor.\n- **fixed**: Positioned relative to the viewport.",
46056
+ "default": "'absolute'",
46057
+ "attribute": "toggletip-strategy",
46058
+ "reflects": true,
46059
+ "inheritedFrom": {
46060
+ "name": "FormfieldWrapper",
46061
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
46062
+ }
46063
+ },
46064
+ {
46065
+ "kind": "field",
46066
+ "name": "toggletipText",
46067
+ "type": {
46068
+ "text": "string | undefined"
46069
+ },
46070
+ "description": "The toggletip text that is displayed when the info icon is clicked or pressed.\nIt is used to provide additional information about the label.",
46071
+ "attribute": "toggletip-text",
46072
+ "reflects": true,
46073
+ "inheritedFrom": {
46074
+ "name": "FormfieldWrapper",
46075
+ "module": "components/formfieldwrapper/formfieldwrapper.component.js"
46076
+ }
46077
+ },
46078
+ {
46079
+ "kind": "field",
46080
+ "name": "validationMessage",
46081
+ "type": {
46082
+ "text": "string | undefined"
46083
+ },
46084
+ "description": "Custom validation message that will override the default message and displayed when the input is invalid.\n\nTo display custom validation messages, you must listen for input events (or other relevant events)\non your component and update the `validationMessage` property with the desired message string.\nUpdating this property will ensure that new validation messages are shown to the user.\n- The `validationMessage` property overrides the default browser validation message when set.\n- Consumers are responsible for updating `validationMessage` in response to input or validation state changes.",
46085
+ "attribute": "validation-message",
46086
+ "reflects": true,
46087
+ "inheritedFrom": {
46088
+ "name": "FormInternalsMixin",
46089
+ "module": "utils/mixins/FormInternalsMixin.js"
46090
+ }
46091
+ },
46092
+ {
46093
+ "kind": "field",
46094
+ "name": "validity",
46095
+ "type": {
46096
+ "text": "ValidityState"
46097
+ },
46098
+ "readonly": true,
46099
+ "inheritedFrom": {
46100
+ "name": "FormInternalsMixin",
46101
+ "module": "utils/mixins/FormInternalsMixin.js"
46102
+ }
46103
+ },
46104
+ {
46105
+ "kind": "field",
46106
+ "name": "value",
46107
+ "type": {
46108
+ "text": "string"
46109
+ },
46110
+ "default": "''",
46111
+ "description": "Indicates the value of the component group (ex: input, checkbox, radio, select etc...)",
46112
+ "attribute": "value",
46113
+ "reflects": true,
46114
+ "inheritedFrom": {
46115
+ "name": "FormInternalsMixin",
46116
+ "module": "utils/mixins/FormInternalsMixin.js"
46117
+ }
46118
+ },
46119
+ {
46120
+ "kind": "field",
46121
+ "name": "willValidate",
46122
+ "readonly": true,
46123
+ "inheritedFrom": {
46124
+ "name": "FormInternalsMixin",
46125
+ "module": "utils/mixins/FormInternalsMixin.js"
46126
+ }
46127
+ }
46128
+ ],
46129
+ "events": [
46130
+ {
46131
+ "name": "input",
46132
+ "type": {
46133
+ "text": "CustomEvent"
46134
+ },
46135
+ "description": "(React: onInput) This event is dispatched when the time value changes.",
46136
+ "reactName": "onInput"
46137
+ },
46138
+ {
46139
+ "name": "change",
46140
+ "type": {
46141
+ "text": "CustomEvent"
46142
+ },
46143
+ "description": "(React: onChange) This event is dispatched when the time value is committed.",
46144
+ "reactName": "onChange"
46145
+ },
46146
+ {
46147
+ "description": "(React: onFocus) This event is dispatched when the timepicker receives focus.",
46148
+ "name": "focus",
46149
+ "reactName": "onFocus"
46150
+ },
46151
+ {
46152
+ "description": "(React: onBlur) This event is dispatched when the timepicker loses focus.",
46153
+ "name": "blur",
46154
+ "reactName": "onBlur"
46155
+ }
46156
+ ],
46157
+ "attributes": [
46158
+ {
46159
+ "name": "time-format",
46160
+ "type": {
46161
+ "text": "TimeFormat"
46162
+ },
46163
+ "description": "The time format to use for display.\n- `'12h'`: 12-hour format with AM/PM period\n- `'24h'`: 24-hour format without period",
46164
+ "default": "'12h'",
46165
+ "fieldName": "timeFormat"
46166
+ },
46167
+ {
46168
+ "name": "interval",
46169
+ "type": {
46170
+ "text": "number"
46171
+ },
46172
+ "description": "The interval in minutes between time options in the dropdown menu.",
46173
+ "default": "30",
46174
+ "fieldName": "interval"
46175
+ },
46176
+ {
46177
+ "name": "placement",
46178
+ "type": {
46179
+ "text": "Placement"
46180
+ },
46181
+ "description": "The placement of the popover dropdown.",
46182
+ "default": "'bottom-start'",
46183
+ "fieldName": "placement"
46184
+ },
46185
+ {
46186
+ "name": "strategy",
46187
+ "type": {
46188
+ "text": "PopoverStrategy"
46189
+ },
46190
+ "description": "The strategy for positioning the popover.",
46191
+ "default": "'absolute'",
46192
+ "fieldName": "strategy"
46193
+ },
46194
+ {
46195
+ "name": "disable-flip",
46196
+ "type": {
46197
+ "text": "boolean"
46198
+ },
46199
+ "description": "Determines whether the dropdown should flip its position when it hits the boundary.",
46200
+ "default": "false",
46201
+ "fieldName": "disableFlip"
46202
+ },
46203
+ {
46204
+ "name": "append-to",
46205
+ "type": {
46206
+ "text": "string | undefined"
46207
+ },
46208
+ "description": "Element ID that the popover will be appended to.\nThis is useful when the timepicker is inside a scrollable container\nand the popover needs to be portalled to avoid clipping.",
46209
+ "fieldName": "appendTo"
46210
+ },
46211
+ {
46212
+ "name": "backdrop-append-to",
46213
+ "type": {
46214
+ "text": "string | undefined"
46215
+ },
46216
+ "description": "Element ID the backdrop will be appended to (if backdrop is enabled).\nThis is useful to ensure that the backdrop is appended to the correct element in the DOM.\nIf not set, the backdrop will be appended to the parent element of the timepicker.",
46217
+ "fieldName": "backdropAppendTo"
46218
+ },
46219
+ {
46220
+ "name": "min",
46221
+ "type": {
46222
+ "text": "string | undefined"
46223
+ },
46224
+ "description": "The minimum allowed time value in 24-hour format (HH:MM).",
46225
+ "fieldName": "min"
46226
+ },
46227
+ {
46228
+ "name": "max",
46229
+ "type": {
46230
+ "text": "string | undefined"
46231
+ },
46232
+ "description": "The maximum allowed time value in 24-hour format (HH:MM).",
46233
+ "fieldName": "max"
46234
+ },
46235
+ {
46236
+ "name": "locale-hours-label",
46237
+ "type": {
46238
+ "text": "string"
46239
+ },
46240
+ "default": "''",
46241
+ "description": "Accessible label for the hours spinbutton.\nConsumers must provide a translated string.",
46242
+ "fieldName": "localeHoursLabel"
46243
+ },
46244
+ {
46245
+ "name": "locale-minutes-label",
46246
+ "type": {
46247
+ "text": "string"
46248
+ },
46249
+ "default": "''",
46250
+ "description": "Accessible label for the minutes spinbutton.\nConsumers must provide a translated string.",
46251
+ "fieldName": "localeMinutesLabel"
46252
+ },
46253
+ {
46254
+ "name": "locale-period-label",
46255
+ "type": {
46256
+ "text": "string"
46257
+ },
46258
+ "default": "''",
46259
+ "description": "Accessible label for the period (AM/PM) spinbutton.\nConsumers must provide a translated string.",
46260
+ "fieldName": "localePeriodLabel"
46261
+ },
46262
+ {
46263
+ "name": "locale-hours-placeholder",
46264
+ "type": {
46265
+ "text": "string"
46266
+ },
46267
+ "default": "''",
46268
+ "description": "Placeholder text for the hours spinbutton.\nConsumers must provide a translated string.",
46269
+ "fieldName": "localeHoursPlaceholder"
46270
+ },
46271
+ {
46272
+ "name": "locale-minutes-placeholder",
46273
+ "type": {
46274
+ "text": "string"
46275
+ },
46276
+ "default": "''",
46277
+ "description": "Placeholder text for the minutes spinbutton.\nConsumers must provide a translated string.",
46278
+ "fieldName": "localeMinutesPlaceholder"
46279
+ },
46280
+ {
46281
+ "name": "locale-period-placeholder",
46282
+ "type": {
46283
+ "text": "string"
46284
+ },
46285
+ "default": "''",
46286
+ "description": "Placeholder text for the period spinbutton.\nConsumers must provide a translated string.",
46287
+ "fieldName": "localePeriodPlaceholder"
46288
+ },
46289
+ {
46290
+ "name": "locale-am-label",
46291
+ "type": {
46292
+ "text": "string"
46293
+ },
46294
+ "default": "''",
46295
+ "description": "Label for the AM period.\nConsumers must provide a translated string.",
46296
+ "fieldName": "localeAmLabel"
46297
+ },
46298
+ {
46299
+ "name": "locale-pm-label",
46300
+ "type": {
46301
+ "text": "string"
46302
+ },
46303
+ "default": "''",
46304
+ "description": "Label for the PM period.\nConsumers must provide a translated string.",
46305
+ "fieldName": "localePmLabel"
46306
+ },
46307
+ {
46308
+ "name": "locale-show-time-picker-label",
46309
+ "type": {
46310
+ "text": "string"
46311
+ },
46312
+ "default": "''",
46313
+ "description": "Accessible label for the dropdown toggle button.\nConsumers must provide a translated string.",
46314
+ "fieldName": "localeShowTimePickerLabel"
46315
+ },
46316
+ {
46317
+ "name": "locale-time-options-label",
46318
+ "type": {
46319
+ "text": "string"
46320
+ },
46321
+ "default": "''",
46322
+ "description": "Accessible label for the time options listbox.\nConsumers must provide a translated string.",
46323
+ "fieldName": "localeTimeOptionsLabel"
46324
+ },
46325
+ {
46326
+ "name": "locale-spinbutton-description",
46327
+ "type": {
46328
+ "text": "string"
46329
+ },
46330
+ "default": "''",
46331
+ "description": "Accessible description for spinbutton inputs (instruction text).\nConsumers must provide a translated string.",
46332
+ "fieldName": "localeSpinbuttonDescription"
46333
+ },
46334
+ {
46335
+ "name": "name",
46336
+ "type": {
46337
+ "text": "string"
46338
+ },
46339
+ "default": "''",
46340
+ "description": "Indicates the name of the component group.\nThey are used to group elements in a form together.",
46341
+ "fieldName": "name",
46342
+ "inheritedFrom": {
46343
+ "name": "FormInternalsMixin",
46344
+ "module": "src/utils/mixins/FormInternalsMixin.ts"
46345
+ }
46346
+ },
46347
+ {
46348
+ "name": "value",
46349
+ "type": {
46350
+ "text": "string"
46351
+ },
46352
+ "default": "''",
46353
+ "description": "Indicates the value of the component group (ex: input, checkbox, radio, select etc...)",
46354
+ "fieldName": "value",
46355
+ "inheritedFrom": {
46356
+ "name": "FormInternalsMixin",
46357
+ "module": "src/utils/mixins/FormInternalsMixin.ts"
46358
+ }
46359
+ },
46360
+ {
46361
+ "name": "validation-message",
46362
+ "type": {
46363
+ "text": "string | undefined"
46364
+ },
46365
+ "description": "Custom validation message that will override the default message and displayed when the input is invalid.\n\nTo display custom validation messages, you must listen for input events (or other relevant events)\non your component and update the `validationMessage` property with the desired message string.\nUpdating this property will ensure that new validation messages are shown to the user.\n- The `validationMessage` property overrides the default browser validation message when set.\n- Consumers are responsible for updating `validationMessage` in response to input or validation state changes.",
46366
+ "fieldName": "validationMessage",
46367
+ "inheritedFrom": {
46368
+ "name": "FormInternalsMixin",
46369
+ "module": "src/utils/mixins/FormInternalsMixin.ts"
46370
+ }
46371
+ },
46372
+ {
46373
+ "name": "data-aria-label",
46374
+ "type": {
46375
+ "text": "string | null"
46376
+ },
46377
+ "default": "null",
46378
+ "description": "Defines a string value that labels the current element.\nThe Aria-Label attribute to be set for accessibility.",
46379
+ "fieldName": "dataAriaLabel",
46380
+ "inheritedFrom": {
46381
+ "name": "DataAriaLabelMixin",
46382
+ "module": "src/utils/mixins/DataAriaLabelMixin.ts"
46383
+ }
46384
+ },
46385
+ {
46386
+ "name": "disabled",
46387
+ "type": {
46388
+ "text": "boolean | undefined"
46389
+ },
46390
+ "description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
46391
+ "default": "undefined",
46392
+ "fieldName": "disabled",
46393
+ "inheritedFrom": {
46394
+ "name": "FormfieldWrapper",
46395
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46396
+ }
46397
+ },
46398
+ {
46399
+ "name": "label",
46400
+ "type": {
46401
+ "text": "string | undefined"
46402
+ },
46403
+ "description": "The label of the input field. It is linked to the input field using the `for` attribute.",
46404
+ "fieldName": "label",
46405
+ "inheritedFrom": {
46406
+ "name": "FormfieldWrapper",
46407
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46408
+ }
46409
+ },
46410
+ {
46411
+ "name": "required",
46412
+ "type": {
46413
+ "text": "boolean"
46414
+ },
46415
+ "default": "false",
46416
+ "description": "The required attribute to indicate that the input field is required.\nIt is used to append a required indicator (*) to the label.",
46417
+ "fieldName": "required",
46418
+ "inheritedFrom": {
46419
+ "name": "FormfieldWrapper",
46420
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46421
+ }
46422
+ },
46423
+ {
46424
+ "name": "help-text-type",
46425
+ "type": {
46426
+ "text": "ValidationType"
46427
+ },
46428
+ "description": "The type of help text. It can be 'default', 'error', 'warning', 'success', 'priority'.",
46429
+ "default": "'default'",
46430
+ "fieldName": "helpTextType",
46431
+ "inheritedFrom": {
46432
+ "name": "FormfieldWrapper",
46433
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46434
+ }
46435
+ },
46436
+ {
46437
+ "name": "help-text",
46438
+ "type": {
46439
+ "text": "string | undefined"
46440
+ },
46441
+ "description": "The help text that is displayed below the input field.",
46442
+ "fieldName": "helpText",
46443
+ "inheritedFrom": {
46444
+ "name": "FormfieldWrapper",
46445
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46446
+ }
46447
+ },
46448
+ {
46449
+ "name": "toggletip-text",
46450
+ "type": {
46451
+ "text": "string | undefined"
46452
+ },
46453
+ "description": "The toggletip text that is displayed when the info icon is clicked or pressed.\nIt is used to provide additional information about the label.",
46454
+ "fieldName": "toggletipText",
46455
+ "inheritedFrom": {
46456
+ "name": "FormfieldWrapper",
46457
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46458
+ }
46459
+ },
46460
+ {
46461
+ "name": "toggletip-placement",
46462
+ "type": {
46463
+ "text": "PopoverPlacement"
46464
+ },
46465
+ "description": "The placement of the toggletip that is displayed when the info icon is clicked or pressed.",
46466
+ "default": "'top'",
46467
+ "fieldName": "toggletipPlacement",
46468
+ "inheritedFrom": {
46469
+ "name": "FormfieldWrapper",
46470
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46471
+ }
46472
+ },
46473
+ {
46474
+ "name": "toggletip-strategy",
46475
+ "type": {
46476
+ "text": "PopoverStrategy"
46477
+ },
46478
+ "description": "The positioning strategy for the toggletip.\n- **absolute**: Positioned relative to the nearest positioned ancestor.\n- **fixed**: Positioned relative to the viewport.",
46479
+ "default": "'absolute'",
46480
+ "fieldName": "toggletipStrategy",
46481
+ "inheritedFrom": {
46482
+ "name": "FormfieldWrapper",
46483
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46484
+ }
46485
+ },
46486
+ {
46487
+ "name": "info-icon-aria-label",
46488
+ "type": {
46489
+ "text": "string | undefined"
46490
+ },
46491
+ "description": "Aria label for the info icon that is displayed next to the label when `toggletipText` is set.\nThis is used for accessibility purposes to provide a description of the icon.",
46492
+ "fieldName": "infoIconAriaLabel",
46493
+ "inheritedFrom": {
46494
+ "name": "FormfieldWrapper",
46495
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46496
+ }
46497
+ },
46498
+ {
46499
+ "name": "readonly",
46500
+ "type": {
46501
+ "text": "boolean"
46502
+ },
46503
+ "default": "false",
46504
+ "description": "Determines whether the form field is read-only.",
46505
+ "fieldName": "readonly",
46506
+ "inheritedFrom": {
46507
+ "name": "FormfieldWrapper",
46508
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46509
+ }
46510
+ },
46511
+ {
46512
+ "name": "soft-disabled",
46513
+ "type": {
46514
+ "text": "boolean"
46515
+ },
46516
+ "default": "false",
46517
+ "description": "Determines whether the form field is soft-disabled.",
46518
+ "fieldName": "softDisabled",
46519
+ "inheritedFrom": {
46520
+ "name": "FormfieldWrapper",
46521
+ "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
46522
+ }
46523
+ }
46524
+ ],
46525
+ "mixins": [
46526
+ {
46527
+ "name": "FormInternalsMixin",
46528
+ "module": "/src/utils/mixins/FormInternalsMixin"
46529
+ },
46530
+ {
46531
+ "name": "DataAriaLabelMixin",
46532
+ "module": "/src/utils/mixins/DataAriaLabelMixin"
46533
+ }
46534
+ ],
46535
+ "superclass": {
46536
+ "name": "FormfieldWrapper",
46537
+ "module": "/src/components/formfieldwrapper/formfieldwrapper.component"
46538
+ },
46539
+ "tagName": "mdc-timepicker",
46540
+ "jsDoc": "/**\n * mdc-timepicker is a component that allows users to select a specific time\n * or enter a time manually. It supports both 12-hour and 24-hour formats.\n *\n * The component consists of:\n * - label - describes the time picker field\n * - input field - made up of 2-3 spinbuttons (hours, minutes, optional AM/PM period)\n * - dropdown arrow button - opens a flyout menu with predefined time intervals\n * - helper text - displayed below the input field\n *\n * Users can input values by:\n * - Manually entering numbers/characters in spinbuttons\n * - Navigating using arrow keys to increment/decrement values\n * - Selecting a predefined time from the dropdown menu\n *\n * @tagname mdc-timepicker\n *\n * @dependency mdc-button\n * @dependency mdc-icon\n * @dependency mdc-option\n * @dependency mdc-popover\n * @dependency mdc-text\n * @dependency mdc-toggletip\n *\n * @event input - (React: onInput) This event is dispatched when the time value changes.\n * @event change - (React: onChange) This event is dispatched when the time value is committed.\n * @event focus - (React: onFocus) This event is dispatched when the timepicker receives focus.\n * @event blur - (React: onBlur) This event is dispatched when the timepicker loses focus.\n *\n * @slot label - Slot for the label element.\n * @slot toggletip - Slot for the toggletip info icon button.\n * @slot help-icon - Slot for the helper/validation icon.\n * @slot help-text - Slot for the helper/validation text.\n *\n * @cssproperty --mdc-timepicker-background-color - Background color of the timepicker input.\n * @cssproperty --mdc-timepicker-border-color - Border color of the timepicker input.\n * @cssproperty --mdc-timepicker-text-color - Text color of the timepicker input.\n * @cssproperty --mdc-timepicker-width - Width of the timepicker component.\n *\n * @csspart label - The label element.\n * @csspart label-text - The container for the label and required indicator elements.\n * @csspart required-indicator - The required indicator element.\n * @csspart info-icon-btn - The info icon button element.\n * @csspart label-toggletip - The toggletip element.\n * @csspart help-text - The helper/validation text element.\n * @csspart helper-icon - The helper/validation icon element.\n * @csspart help-text-container - The container for helper/validation elements.\n * @csspart container - The outer container for the input and popover.\n * @csspart base-container - The input container with border and background.\n * @csspart spinbutton-group - The container for spinbutton elements.\n * @csspart spinbutton - A spinbutton input element.\n * @csspart separator - The colon separator between spinbuttons.\n * @csspart period - The AM/PM period spinbutton.\n * @csspart icon-container - The dropdown arrow button container.\n * @csspart native-input - The hidden native input for form participation.\n * @csspart listbox - The dropdown list container.\n */",
46541
+ "customElement": true
46542
+ }
46543
+ ],
46544
+ "exports": [
46545
+ {
46546
+ "kind": "js",
46547
+ "name": "default",
46548
+ "declaration": {
46549
+ "name": "TimePicker",
46550
+ "module": "components/timepicker/timepicker.component.js"
46551
+ }
46552
+ }
46553
+ ]
46554
+ },
45337
46555
  {
45338
46556
  "kind": "javascript-module",
45339
46557
  "path": "components/toast/toast.component.js",