@emuanalytics/flow-rdf-ui 4.1.28 → 4.2.1

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.
@@ -265,191 +265,6 @@
265
265
  }
266
266
  ]
267
267
  },
268
- {
269
- "kind": "javascript-module",
270
- "path": "components/avatar/avatar.component.js",
271
- "declarations": [
272
- {
273
- "kind": "class",
274
- "description": "",
275
- "name": "FlowUiAvatar",
276
- "cssProperties": [
277
- {
278
- "description": "The size of the avatar.",
279
- "name": "--size"
280
- }
281
- ],
282
- "cssParts": [
283
- {
284
- "description": "The component's base wrapper.",
285
- "name": "base"
286
- },
287
- {
288
- "description": "The container that wraps the avatar's icon.",
289
- "name": "icon"
290
- },
291
- {
292
- "description": "The container that wraps the avatar's initials.",
293
- "name": "initials"
294
- },
295
- {
296
- "description": "The avatar image. Only shown when the `image` attribute is set.",
297
- "name": "image"
298
- }
299
- ],
300
- "slots": [
301
- {
302
- "description": "The default icon to use when no image or initials are present. Works best with `<flow-ui-icon>`.",
303
- "name": "icon"
304
- }
305
- ],
306
- "members": [
307
- {
308
- "kind": "field",
309
- "name": "hasError",
310
- "type": {
311
- "text": "boolean"
312
- },
313
- "privacy": "private",
314
- "default": "false"
315
- },
316
- {
317
- "kind": "field",
318
- "name": "image",
319
- "type": {
320
- "text": "string"
321
- },
322
- "default": "''",
323
- "description": "The image source to use for the avatar.",
324
- "attribute": "image"
325
- },
326
- {
327
- "kind": "field",
328
- "name": "label",
329
- "type": {
330
- "text": "string"
331
- },
332
- "default": "''",
333
- "description": "A label to use to describe the avatar to assistive devices.",
334
- "attribute": "label"
335
- },
336
- {
337
- "kind": "field",
338
- "name": "initials",
339
- "type": {
340
- "text": "string"
341
- },
342
- "default": "''",
343
- "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
344
- "attribute": "initials"
345
- },
346
- {
347
- "kind": "field",
348
- "name": "loading",
349
- "type": {
350
- "text": "'eager' | 'lazy'"
351
- },
352
- "default": "'eager'",
353
- "description": "Indicates how the browser should load the image.",
354
- "attribute": "loading"
355
- },
356
- {
357
- "kind": "field",
358
- "name": "shape",
359
- "type": {
360
- "text": "'circle' | 'square' | 'rounded'"
361
- },
362
- "default": "'circle'",
363
- "description": "The shape of the avatar.",
364
- "attribute": "shape",
365
- "reflects": true
366
- }
367
- ],
368
- "attributes": [
369
- {
370
- "name": "image",
371
- "type": {
372
- "text": "string"
373
- },
374
- "default": "''",
375
- "description": "The image source to use for the avatar.",
376
- "fieldName": "image"
377
- },
378
- {
379
- "name": "label",
380
- "type": {
381
- "text": "string"
382
- },
383
- "default": "''",
384
- "description": "A label to use to describe the avatar to assistive devices.",
385
- "fieldName": "label"
386
- },
387
- {
388
- "name": "initials",
389
- "type": {
390
- "text": "string"
391
- },
392
- "default": "''",
393
- "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
394
- "fieldName": "initials"
395
- },
396
- {
397
- "name": "loading",
398
- "type": {
399
- "text": "'eager' | 'lazy'"
400
- },
401
- "default": "'eager'",
402
- "description": "Indicates how the browser should load the image.",
403
- "fieldName": "loading"
404
- },
405
- {
406
- "name": "shape",
407
- "type": {
408
- "text": "'circle' | 'square' | 'rounded'"
409
- },
410
- "default": "'circle'",
411
- "description": "The shape of the avatar.",
412
- "fieldName": "shape"
413
- }
414
- ],
415
- "superclass": {
416
- "name": "FlowRdfElement",
417
- "module": "/src/internal/flow-ui-rdf-element"
418
- },
419
- "tagName": "flow-ui-avatar",
420
- "summary": "Avatars are used to represent a person or object.",
421
- "dependencies": [
422
- "flow-ui-icon"
423
- ],
424
- "customElement": true
425
- }
426
- ],
427
- "exports": [
428
- {
429
- "kind": "js",
430
- "name": "default",
431
- "declaration": {
432
- "name": "FlowUiAvatar",
433
- "module": "components/avatar/avatar.component.js"
434
- }
435
- }
436
- ]
437
- },
438
- {
439
- "kind": "javascript-module",
440
- "path": "components/avatar/avatar.js",
441
- "declarations": [],
442
- "exports": [
443
- {
444
- "kind": "js",
445
- "name": "default",
446
- "declaration": {
447
- "name": "FlowUiAvatar",
448
- "module": "components/avatar/avatar.js"
449
- }
450
- }
451
- ]
452
- },
453
268
  {
454
269
  "kind": "javascript-module",
455
270
  "path": "components/animation/animation.component.js",
@@ -855,550 +670,645 @@
855
670
  },
856
671
  {
857
672
  "kind": "javascript-module",
858
- "path": "components/autocomplete/autocomplete.component.js",
673
+ "path": "components/badge/badge.component.js",
859
674
  "declarations": [
860
675
  {
861
676
  "kind": "class",
862
677
  "description": "",
863
- "name": "FlowUiAutocomplete",
678
+ "name": "FlowUiBadge",
864
679
  "cssParts": [
865
680
  {
866
- "description": "The form control that wraps the label, input, and help text.",
867
- "name": "form-control"
868
- },
869
- {
870
- "description": "The label's wrapper.",
871
- "name": "form-control-label"
872
- },
873
- {
874
- "description": "The select's wrapper.",
875
- "name": "form-control-input"
876
- },
877
- {
878
- "description": "The help text's wrapper.",
879
- "name": "form-control-help-text"
880
- },
881
- {
882
- "description": "The container the wraps the prefix, suffix, combobox, clear icon, and expand button.",
883
- "name": "combobox"
884
- },
885
- {
886
- "description": "The container that wraps the prefix slot.",
887
- "name": "prefix"
888
- },
889
- {
890
- "description": "The container that wraps the suffix slot.",
891
- "name": "suffix"
892
- },
893
- {
894
- "description": "The element that displays the selected option's label, an `<input>` element.",
895
- "name": "display-input"
896
- },
897
- {
898
- "description": "The listbox container where options are slotted.",
899
- "name": "listbox"
900
- },
901
- {
902
- "description": "The clear button.",
903
- "name": "clear-button"
681
+ "description": "The component's base wrapper.",
682
+ "name": "base"
904
683
  }
905
684
  ],
906
685
  "slots": [
907
686
  {
908
- "description": "The listbox options. Must be `<flow-option>` elements. You can use `<flow-divider>` to group items visually.",
687
+ "description": "The badge's content.",
909
688
  "name": ""
910
- },
911
- {
912
- "description": "The input's label. Alternatively, you can use the `label` attribute.",
913
- "name": "label"
914
- },
915
- {
916
- "description": "Used to prepend a presentational icon or similar element to the combobox.",
917
- "name": "prefix"
918
- },
919
- {
920
- "description": "Used to append a presentational icon or similar element to the combobox.",
921
- "name": "suffix"
922
- },
923
- {
924
- "description": "An icon to use in lieu of the default clear icon.",
925
- "name": "clear-icon"
926
- },
927
- {
928
- "description": "Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.",
929
- "name": "help-text"
930
689
  }
931
690
  ],
932
691
  "members": [
933
692
  {
934
693
  "kind": "field",
935
- "name": "dependencies",
694
+ "name": "variant",
936
695
  "type": {
937
- "text": "object"
696
+ "text": "'primary' | 'secondary' | 'success' | 'neutral' | 'warning' | 'danger'"
938
697
  },
939
- "static": true,
940
- "default": "{\n 'flow-ui-popup': FlowPopup,\n 'flow-ui-icon': FlowIcon\n }"
941
- },
942
- {
943
- "kind": "field",
944
- "name": "hasSlotController",
945
- "privacy": "private",
946
- "readonly": true,
947
- "default": "new HasSlotController(this, 'help-text', 'label')"
948
- },
949
- {
950
- "kind": "field",
951
- "name": "localize",
952
- "privacy": "private",
953
- "readonly": true,
954
- "default": "new LocalizeController(this)"
698
+ "default": "'primary'",
699
+ "description": "The badge's theme variant.",
700
+ "attribute": "variant",
701
+ "reflects": true
955
702
  },
956
703
  {
957
704
  "kind": "field",
958
- "name": "debouncedInput",
705
+ "name": "size",
959
706
  "type": {
960
- "text": "(displayValue: string) => void"
707
+ "text": "'small' | 'medium' | 'large'"
961
708
  },
962
- "privacy": "private"
709
+ "default": "'medium'",
710
+ "description": "The badge size.",
711
+ "attribute": "size",
712
+ "reflects": true
963
713
  },
964
714
  {
965
715
  "kind": "field",
966
- "name": "pendingChangeEvent",
716
+ "name": "pill",
967
717
  "type": {
968
718
  "text": "boolean"
969
719
  },
970
- "privacy": "private",
971
- "default": "false"
720
+ "default": "false",
721
+ "description": "Draws a pill-style badge with rounded edges.",
722
+ "attribute": "pill",
723
+ "reflects": true
972
724
  },
973
725
  {
974
726
  "kind": "field",
975
- "name": "pendingInputEvent",
727
+ "name": "pulse",
976
728
  "type": {
977
729
  "text": "boolean"
978
730
  },
979
- "privacy": "private",
980
- "default": "false"
981
- },
731
+ "default": "false",
732
+ "description": "Makes the badge pulsate to draw attention.",
733
+ "attribute": "pulse",
734
+ "reflects": true
735
+ }
736
+ ],
737
+ "attributes": [
982
738
  {
983
- "kind": "field",
984
- "name": "hasOptions",
739
+ "name": "variant",
985
740
  "type": {
986
- "text": "boolean"
741
+ "text": "'primary' | 'secondary' | 'success' | 'neutral' | 'warning' | 'danger'"
987
742
  },
988
- "privacy": "private",
989
- "default": "false"
990
- },
991
- {
992
- "kind": "field",
993
- "name": "formControlController",
994
- "privacy": "private",
995
- "readonly": true,
996
- "default": "new FormControlController(this, {\n assumeInteractionOn: ['flow-ui-blur', 'flow-ui-input']\n })"
743
+ "default": "'primary'",
744
+ "description": "The badge's theme variant.",
745
+ "fieldName": "variant"
997
746
  },
998
747
  {
999
- "kind": "field",
1000
748
  "name": "size",
1001
749
  "type": {
1002
750
  "text": "'small' | 'medium' | 'large'"
1003
751
  },
1004
752
  "default": "'medium'",
1005
- "description": "The autocomplete's size",
1006
- "attribute": "size",
1007
- "reflects": true
753
+ "description": "The badge size.",
754
+ "fieldName": "size"
1008
755
  },
1009
756
  {
1010
- "kind": "field",
1011
- "name": "filled",
757
+ "name": "pill",
1012
758
  "type": {
1013
759
  "text": "boolean"
1014
760
  },
1015
761
  "default": "false",
1016
- "description": "Draws a filled autocomplete input",
1017
- "attribute": "filled",
1018
- "reflects": true
762
+ "description": "Draws a pill-style badge with rounded edges.",
763
+ "fieldName": "pill"
1019
764
  },
1020
765
  {
1021
- "kind": "field",
1022
- "name": "pill",
766
+ "name": "pulse",
1023
767
  "type": {
1024
768
  "text": "boolean"
1025
769
  },
1026
770
  "default": "false",
1027
- "description": "Draws a pill-style autocomplete input with rounded edges",
1028
- "attribute": "pill",
1029
- "reflects": true
771
+ "description": "Makes the badge pulsate to draw attention.",
772
+ "fieldName": "pulse"
773
+ }
774
+ ],
775
+ "superclass": {
776
+ "name": "FlowRdfElement",
777
+ "module": "/src/internal/flow-ui-rdf-element"
778
+ },
779
+ "tagName": "flow-ui-badge",
780
+ "summary": "Badges are used to draw attention and display statuses or counts.",
781
+ "customElement": true
782
+ }
783
+ ],
784
+ "exports": [
785
+ {
786
+ "kind": "js",
787
+ "name": "default",
788
+ "declaration": {
789
+ "name": "FlowUiBadge",
790
+ "module": "components/badge/badge.component.js"
791
+ }
792
+ }
793
+ ]
794
+ },
795
+ {
796
+ "kind": "javascript-module",
797
+ "path": "components/badge/badge.js",
798
+ "declarations": [],
799
+ "exports": [
800
+ {
801
+ "kind": "js",
802
+ "name": "default",
803
+ "declaration": {
804
+ "name": "FlowUiBadge",
805
+ "module": "components/badge/badge.js"
806
+ }
807
+ }
808
+ ]
809
+ },
810
+ {
811
+ "kind": "javascript-module",
812
+ "path": "components/avatar/avatar.component.js",
813
+ "declarations": [
814
+ {
815
+ "kind": "class",
816
+ "description": "",
817
+ "name": "FlowUiAvatar",
818
+ "cssProperties": [
819
+ {
820
+ "description": "The size of the avatar.",
821
+ "name": "--size"
822
+ }
823
+ ],
824
+ "cssParts": [
825
+ {
826
+ "description": "The component's base wrapper.",
827
+ "name": "base"
828
+ },
829
+ {
830
+ "description": "The container that wraps the avatar's icon.",
831
+ "name": "icon"
1030
832
  },
833
+ {
834
+ "description": "The container that wraps the avatar's initials.",
835
+ "name": "initials"
836
+ },
837
+ {
838
+ "description": "The avatar image. Only shown when the `image` attribute is set.",
839
+ "name": "image"
840
+ }
841
+ ],
842
+ "slots": [
843
+ {
844
+ "description": "The default icon to use when no image or initials are present. Works best with `<flow-ui-icon>`.",
845
+ "name": "icon"
846
+ }
847
+ ],
848
+ "members": [
1031
849
  {
1032
850
  "kind": "field",
1033
- "name": "label",
851
+ "name": "hasError",
1034
852
  "type": {
1035
- "text": "string"
853
+ "text": "boolean"
1036
854
  },
1037
- "default": "''",
1038
- "description": "The autocomplete input's label. If you need to display HTML, use the `help-text` slot instead",
1039
- "attribute": "label"
855
+ "privacy": "private",
856
+ "default": "false"
1040
857
  },
1041
858
  {
1042
859
  "kind": "field",
1043
- "name": "helpText",
860
+ "name": "image",
1044
861
  "type": {
1045
862
  "text": "string"
1046
863
  },
1047
864
  "default": "''",
1048
- "description": "The autocomplete input's help text. If you need to display HTML, use the `help-text` slot instead",
1049
- "attribute": "help-text"
865
+ "description": "The image source to use for the avatar.",
866
+ "attribute": "image"
1050
867
  },
1051
868
  {
1052
869
  "kind": "field",
1053
- "name": "placeholder",
870
+ "name": "label",
1054
871
  "type": {
1055
872
  "text": "string"
1056
873
  },
1057
874
  "default": "''",
1058
- "description": "The autocomplete input's placeholder text",
1059
- "attribute": "placeholder"
875
+ "description": "A label to use to describe the avatar to assistive devices.",
876
+ "attribute": "label"
1060
877
  },
1061
878
  {
1062
879
  "kind": "field",
1063
- "name": "disabled",
880
+ "name": "initials",
1064
881
  "type": {
1065
- "text": "boolean"
882
+ "text": "string"
1066
883
  },
1067
- "default": "false",
1068
- "description": "Disables the autocomplete",
1069
- "attribute": "disabled",
1070
- "reflects": true
884
+ "default": "''",
885
+ "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
886
+ "attribute": "initials"
1071
887
  },
1072
888
  {
1073
889
  "kind": "field",
1074
- "name": "form",
890
+ "name": "loading",
1075
891
  "type": {
1076
- "text": "string"
892
+ "text": "'eager' | 'lazy'"
1077
893
  },
1078
- "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
1079
- "attribute": "form"
894
+ "default": "'eager'",
895
+ "description": "Indicates how the browser should load the image.",
896
+ "attribute": "loading"
1080
897
  },
1081
898
  {
1082
899
  "kind": "field",
1083
- "name": "required",
900
+ "name": "shape",
1084
901
  "type": {
1085
- "text": "boolean"
902
+ "text": "'circle' | 'square' | 'rounded'"
1086
903
  },
1087
- "default": "false",
1088
- "description": "Makes the autocomplete a required field",
1089
- "attribute": "required",
904
+ "default": "'circle'",
905
+ "description": "The shape of the avatar.",
906
+ "attribute": "shape",
1090
907
  "reflects": true
1091
- },
908
+ }
909
+ ],
910
+ "attributes": [
1092
911
  {
1093
- "kind": "field",
1094
- "name": "inline",
912
+ "name": "image",
1095
913
  "type": {
1096
- "text": "boolean"
914
+ "text": "string"
1097
915
  },
1098
- "default": "false",
1099
- "description": "Display the autocomplete in the 'inline' form control style",
1100
- "attribute": "inline",
1101
- "reflects": true
916
+ "default": "''",
917
+ "description": "The image source to use for the avatar.",
918
+ "fieldName": "image"
1102
919
  },
1103
920
  {
1104
- "kind": "field",
1105
- "name": "divider",
921
+ "name": "label",
1106
922
  "type": {
1107
- "text": "boolean"
923
+ "text": "string"
1108
924
  },
1109
- "default": "false",
1110
- "description": "Indicates that the control should display a divider",
1111
- "attribute": "divider",
1112
- "reflects": true
925
+ "default": "''",
926
+ "description": "A label to use to describe the avatar to assistive devices.",
927
+ "fieldName": "label"
1113
928
  },
1114
929
  {
1115
- "kind": "field",
1116
- "name": "hoist",
930
+ "name": "initials",
1117
931
  "type": {
1118
- "text": "boolean"
932
+ "text": "string"
1119
933
  },
1120
- "default": "false",
1121
- "description": "Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
1122
- "attribute": "hoist"
934
+ "default": "''",
935
+ "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
936
+ "fieldName": "initials"
1123
937
  },
1124
938
  {
1125
- "kind": "field",
1126
- "name": "placement",
939
+ "name": "loading",
1127
940
  "type": {
1128
- "text": "'top' | 'bottom'"
941
+ "text": "'eager' | 'lazy'"
1129
942
  },
1130
- "default": "'bottom'",
1131
- "description": "The preferred placement of the autocomplete's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.",
1132
- "attribute": "placement",
1133
- "reflects": true
943
+ "default": "'eager'",
944
+ "description": "Indicates how the browser should load the image.",
945
+ "fieldName": "loading"
1134
946
  },
1135
947
  {
1136
- "kind": "field",
1137
- "name": "value",
948
+ "name": "shape",
1138
949
  "type": {
1139
- "text": "string"
950
+ "text": "'circle' | 'square' | 'rounded'"
1140
951
  },
1141
- "default": "''",
1142
- "description": "Current value of the control, selected from one of the valid options available",
1143
- "attribute": "value"
952
+ "default": "'circle'",
953
+ "description": "The shape of the avatar.",
954
+ "fieldName": "shape"
955
+ }
956
+ ],
957
+ "superclass": {
958
+ "name": "FlowRdfElement",
959
+ "module": "/src/internal/flow-ui-rdf-element"
960
+ },
961
+ "tagName": "flow-ui-avatar",
962
+ "summary": "Avatars are used to represent a person or object.",
963
+ "dependencies": [
964
+ "flow-ui-icon"
965
+ ],
966
+ "customElement": true
967
+ }
968
+ ],
969
+ "exports": [
970
+ {
971
+ "kind": "js",
972
+ "name": "default",
973
+ "declaration": {
974
+ "name": "FlowUiAvatar",
975
+ "module": "components/avatar/avatar.component.js"
976
+ }
977
+ }
978
+ ]
979
+ },
980
+ {
981
+ "kind": "javascript-module",
982
+ "path": "components/avatar/avatar.js",
983
+ "declarations": [],
984
+ "exports": [
985
+ {
986
+ "kind": "js",
987
+ "name": "default",
988
+ "declaration": {
989
+ "name": "FlowUiAvatar",
990
+ "module": "components/avatar/avatar.js"
991
+ }
992
+ }
993
+ ]
994
+ },
995
+ {
996
+ "kind": "javascript-module",
997
+ "path": "components/base-control/base-control.component.js",
998
+ "declarations": [
999
+ {
1000
+ "kind": "class",
1001
+ "description": "",
1002
+ "name": "FlowUiBaseControl",
1003
+ "cssParts": [
1004
+ {
1005
+ "description": "The form control that wraps the label, input, and help text.",
1006
+ "name": "form-control"
1007
+ },
1008
+ {
1009
+ "description": "The label's wrapper.",
1010
+ "name": "form-control-label"
1011
+ },
1012
+ {
1013
+ "description": "The input's wrapper.",
1014
+ "name": "form-control-input"
1015
+ },
1016
+ {
1017
+ "description": "The help text's wrapper.",
1018
+ "name": "form-control-help-text"
1019
+ },
1020
+ {
1021
+ "description": "The component's base wrapper.",
1022
+ "name": "base"
1023
+ },
1024
+ {
1025
+ "description": "The internal `<input>` control.",
1026
+ "name": "input"
1027
+ },
1028
+ {
1029
+ "description": "The container that wraps the prefix.",
1030
+ "name": "prefix"
1031
+ },
1032
+ {
1033
+ "description": "The clear button.",
1034
+ "name": "clear-button"
1035
+ },
1036
+ {
1037
+ "description": "The password toggle button.",
1038
+ "name": "password-toggle-button"
1039
+ },
1040
+ {
1041
+ "description": "The container that wraps the suffix.",
1042
+ "name": "suffix"
1043
+ }
1044
+ ],
1045
+ "slots": [
1046
+ {
1047
+ "description": "The input's label. Alternatively, you can use the `label` attribute.",
1048
+ "name": "label"
1049
+ },
1050
+ {
1051
+ "description": "Used to prepend a presentational icon or similar element to the input.",
1052
+ "name": "prefix"
1053
+ },
1054
+ {
1055
+ "description": "Used to append a presentational icon or similar element to the input.",
1056
+ "name": "suffix"
1057
+ },
1058
+ {
1059
+ "description": "An icon to use in lieu of the default clear icon.",
1060
+ "name": "clear-icon"
1061
+ },
1062
+ {
1063
+ "description": "An icon to use in lieu of the default show password icon.",
1064
+ "name": "show-password-icon"
1065
+ },
1066
+ {
1067
+ "description": "An icon to use in lieu of the default hide password icon.",
1068
+ "name": "hide-password-icon"
1144
1069
  },
1070
+ {
1071
+ "description": "Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.",
1072
+ "name": "help-text"
1073
+ }
1074
+ ],
1075
+ "members": [
1145
1076
  {
1146
1077
  "kind": "field",
1147
- "name": "displayWith",
1078
+ "name": "formControlController",
1079
+ "privacy": "private",
1080
+ "readonly": true,
1081
+ "default": "new FormControlController(this, {\n assumeInteractionOn: ['flow-ui-blur', 'flow-ui-input']\n })"
1082
+ },
1083
+ {
1084
+ "kind": "field",
1085
+ "name": "hasSlotController",
1086
+ "privacy": "private",
1087
+ "readonly": true,
1088
+ "default": "new HasSlotController(this, 'help-text', 'label')"
1089
+ },
1090
+ {
1091
+ "kind": "field",
1092
+ "name": "hasFocus",
1148
1093
  "type": {
1149
- "text": "((value: string) => string) | ((value: string) => Promise<string>)"
1094
+ "text": "boolean"
1150
1095
  },
1151
- "description": "Function for determining the `displayValue` for a given `value`.\nBy default, it will show the `value` itself.",
1152
- "attribute": "displayWith"
1096
+ "privacy": "private",
1097
+ "default": "false"
1153
1098
  },
1154
1099
  {
1155
1100
  "kind": "field",
1156
- "name": "debounceDelay",
1101
+ "name": "size",
1157
1102
  "type": {
1158
- "text": "number"
1103
+ "text": "'small' | 'medium' | 'large'"
1159
1104
  },
1160
- "default": "0",
1161
- "description": "Debounce delay",
1162
- "attribute": "debounce-delay",
1105
+ "default": "'medium'",
1106
+ "description": "The input's size.",
1107
+ "attribute": "size",
1163
1108
  "reflects": true
1164
1109
  },
1165
1110
  {
1166
1111
  "kind": "field",
1167
- "name": "clearable",
1112
+ "name": "filled",
1168
1113
  "type": {
1169
1114
  "text": "boolean"
1170
1115
  },
1171
1116
  "default": "false",
1172
- "description": "Show the option to clear input",
1173
- "attribute": "clearable",
1117
+ "description": "Draws a filled input.",
1118
+ "attribute": "filled",
1174
1119
  "reflects": true
1175
1120
  },
1176
1121
  {
1177
1122
  "kind": "field",
1178
- "name": "clearOnFocus",
1123
+ "name": "pill",
1179
1124
  "type": {
1180
1125
  "text": "boolean"
1181
1126
  },
1182
1127
  "default": "false",
1183
- "description": "Clear the value when the autocomplete is focused on",
1184
- "attribute": "clear-on-focus",
1128
+ "description": "Draws a pill-style input with rounded edges.",
1129
+ "attribute": "pill",
1185
1130
  "reflects": true
1186
1131
  },
1187
1132
  {
1188
1133
  "kind": "field",
1189
- "name": "inputText",
1134
+ "name": "label",
1190
1135
  "type": {
1191
1136
  "text": "string"
1192
1137
  },
1193
- "privacy": "private",
1194
1138
  "default": "''",
1195
- "description": "Current value displayed by the control; this can be what the user is typing or the label of the selected option"
1139
+ "description": "The input's label. If you need to display HTML, use the `label` slot instead.",
1140
+ "attribute": "label"
1196
1141
  },
1197
1142
  {
1198
1143
  "kind": "field",
1199
- "name": "selectedOption",
1144
+ "name": "helpText",
1200
1145
  "type": {
1201
- "text": "FlowOption | null"
1146
+ "text": "string"
1202
1147
  },
1203
- "privacy": "private",
1204
- "default": "null"
1148
+ "default": "''",
1149
+ "description": "The input's help text. If you need to display HTML, use the `help-text` slot instead.",
1150
+ "attribute": "help-text"
1205
1151
  },
1206
1152
  {
1207
1153
  "kind": "field",
1208
- "name": "currentOption",
1154
+ "name": "disabled",
1209
1155
  "type": {
1210
- "text": "FlowOption | null"
1156
+ "text": "boolean"
1211
1157
  },
1212
- "privacy": "private",
1213
- "default": "null"
1158
+ "default": "false",
1159
+ "description": "Disables the input.",
1160
+ "attribute": "disabled",
1161
+ "reflects": true
1214
1162
  },
1215
1163
  {
1216
1164
  "kind": "field",
1217
- "name": "input",
1165
+ "name": "form",
1218
1166
  "type": {
1219
- "text": "HTMLInputElement"
1167
+ "text": "string"
1220
1168
  },
1221
- "privacy": "private"
1169
+ "default": "''",
1170
+ "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
1171
+ "attribute": "form",
1172
+ "reflects": true
1222
1173
  },
1223
1174
  {
1224
1175
  "kind": "field",
1225
- "name": "popup",
1176
+ "name": "required",
1226
1177
  "type": {
1227
- "text": "FlowPopup"
1178
+ "text": "boolean"
1228
1179
  },
1229
- "privacy": "private"
1180
+ "default": "false",
1181
+ "description": "Makes the input a required field.",
1182
+ "attribute": "required",
1183
+ "reflects": true
1230
1184
  },
1231
1185
  {
1232
1186
  "kind": "field",
1233
- "name": "listbox",
1187
+ "name": "inline",
1234
1188
  "type": {
1235
- "text": "HTMLElement"
1189
+ "text": "boolean"
1236
1190
  },
1237
- "privacy": "private"
1191
+ "default": "false",
1192
+ "description": "Display the input in the 'inline' form control style.",
1193
+ "attribute": "inline",
1194
+ "reflects": true
1238
1195
  },
1239
1196
  {
1240
- "kind": "method",
1241
- "name": "getForm",
1242
- "return": {
1243
- "type": {
1244
- "text": "HTMLFormElement | null"
1245
- }
1197
+ "kind": "field",
1198
+ "name": "divider",
1199
+ "type": {
1200
+ "text": "boolean"
1246
1201
  },
1247
- "description": "Gets the associated form, if one exists."
1202
+ "default": "false",
1203
+ "description": "Indicates that the control should display a divider",
1204
+ "attribute": "divider",
1205
+ "reflects": true
1248
1206
  },
1249
1207
  {
1250
1208
  "kind": "field",
1251
1209
  "name": "validity",
1252
- "description": "Gets the validity state object.",
1210
+ "description": "Gets the validity state object",
1253
1211
  "readonly": true
1254
1212
  },
1255
1213
  {
1256
1214
  "kind": "field",
1257
1215
  "name": "validationMessage",
1258
- "description": "Gets the validation message.",
1216
+ "description": "Gets the validation message",
1259
1217
  "readonly": true
1260
1218
  },
1261
1219
  {
1262
1220
  "kind": "method",
1263
- "name": "checkValidity",
1264
- "return": {
1265
- "type": {
1266
- "text": "boolean"
1267
- }
1268
- },
1269
- "description": "Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
1221
+ "name": "handleBlur",
1222
+ "privacy": "private"
1270
1223
  },
1271
1224
  {
1272
1225
  "kind": "method",
1273
- "name": "reportValidity",
1274
- "return": {
1275
- "type": {
1276
- "text": "boolean"
1277
- }
1278
- },
1279
- "description": "Checks for validity and shows the browser's validation message if the control is invalid."
1226
+ "name": "handleFocus",
1227
+ "privacy": "private"
1280
1228
  },
1281
1229
  {
1282
1230
  "kind": "method",
1283
- "name": "setCustomValidity",
1231
+ "name": "focus",
1284
1232
  "parameters": [
1285
1233
  {
1286
- "name": "_",
1234
+ "name": "options",
1235
+ "optional": true,
1287
1236
  "type": {
1288
- "text": "string"
1237
+ "text": "FocusOptions"
1289
1238
  }
1290
1239
  }
1291
1240
  ],
1292
- "description": "Sets a custom validation message. Pass an empty string to restore validity."
1293
- },
1294
- {
1295
- "kind": "method",
1296
- "name": "handleClearClick",
1297
- "parameters": [
1298
- {
1299
- "name": "event",
1300
- "type": {
1301
- "text": "MouseEvent"
1302
- }
1303
- }
1304
- ]
1241
+ "description": "Sets focus on the input."
1305
1242
  },
1306
1243
  {
1307
1244
  "kind": "method",
1308
- "name": "focus",
1309
- "description": "Focuses on the control"
1245
+ "name": "blur",
1246
+ "description": "Removes focus from the input."
1310
1247
  },
1311
1248
  {
1312
1249
  "kind": "method",
1313
- "name": "blur",
1314
- "description": "Blurs from the control."
1250
+ "name": "checkValidity",
1251
+ "description": "Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
1315
1252
  },
1316
1253
  {
1317
1254
  "kind": "method",
1318
- "name": "show",
1319
- "description": "Shows the listbox."
1255
+ "name": "getForm",
1256
+ "return": {
1257
+ "type": {
1258
+ "text": "HTMLFormElement | null"
1259
+ }
1260
+ },
1261
+ "description": "Gets the associated form, if one exists."
1320
1262
  },
1321
1263
  {
1322
1264
  "kind": "method",
1323
- "name": "hide",
1324
- "description": "Hides the listbox."
1265
+ "name": "reportValidity",
1266
+ "description": "Checks for validity and shows the browser's validation message if the control is invalid."
1325
1267
  },
1326
1268
  {
1327
1269
  "kind": "method",
1328
- "name": "getInputText",
1329
- "description": "Gets the current value of the text input"
1270
+ "name": "setCustomValidity",
1271
+ "parameters": [
1272
+ {
1273
+ "name": "message",
1274
+ "type": {
1275
+ "text": "string"
1276
+ }
1277
+ }
1278
+ ],
1279
+ "description": "Sets a custom validation message. Pass an empty string to restore validity."
1330
1280
  }
1331
1281
  ],
1332
1282
  "events": [
1333
1283
  {
1334
- "description": "Emitted when the display value changes.",
1335
- "name": "flow-ui-input",
1336
- "reactName": "onFlowUiInput"
1337
- },
1338
- {
1339
- "description": "Emitted when the input value changes.",
1340
- "name": "flow-ui-change",
1341
- "reactName": "onFlowUiChange"
1342
- },
1343
- {
1344
- "description": "Emitted when the input is focused.",
1345
- "name": "flow-ui-focus",
1346
- "reactName": "onFlowUiFocus"
1347
- },
1348
- {
1349
- "description": "Emitted when the input is blurred.",
1284
+ "description": "Emitted when the control loses focus.",
1350
1285
  "name": "flow-ui-blur",
1351
1286
  "reactName": "onFlowUiBlur"
1352
1287
  },
1353
1288
  {
1354
- "description": "Emitted when the dropdown is shown.",
1355
- "name": "flow-ui-show",
1356
- "reactName": "onFlowUiShow"
1289
+ "description": "Emitted when an alteration to the control's value is committed by the user.",
1290
+ "name": "flow-ui-change",
1291
+ "reactName": "onFlowUiChange"
1357
1292
  },
1358
1293
  {
1359
- "description": "Emitted when the dropdown is shown.",
1360
- "name": "flow-ui-after-show",
1361
- "reactName": "onFlowUiAfterShow"
1294
+ "description": "Emitted when the clear button is activated.",
1295
+ "name": "flow-ui-clear",
1296
+ "reactName": "onFlowUiClear"
1362
1297
  },
1363
1298
  {
1364
- "description": "Emitted when the dropdown is hidden.",
1365
- "name": "flow-ui-hide",
1366
- "reactName": "onFlowUiHide"
1299
+ "description": "Emitted when the control gains focus.",
1300
+ "name": "flow-ui-focus",
1301
+ "reactName": "onFlowUiFocus"
1367
1302
  },
1368
1303
  {
1369
- "description": "Emitted when the dropdown is hidden.",
1370
- "name": "flow-ui-after-hide",
1371
- "reactName": "onFlowUiAfterHide"
1304
+ "description": "Emitted when the control receives input.",
1305
+ "name": "flow-ui-input",
1306
+ "reactName": "onFlowUiInput"
1372
1307
  },
1373
1308
  {
1374
- "description": "Emitted when the input is invalid.",
1309
+ "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied.",
1375
1310
  "name": "flow-ui-invalid",
1376
1311
  "reactName": "onFlowUiInvalid"
1377
- },
1378
- {
1379
- "description": "Emitted when the input is valid.",
1380
- "name": "flow-ui-valid",
1381
- "reactName": "onFlowUiValid"
1382
- },
1383
- {
1384
- "description": "Emitted when the input is validated.",
1385
- "name": "flow-ui-validate",
1386
- "reactName": "onFlowUiValidate"
1387
- },
1388
- {
1389
- "description": "Emitted when the input is validated and the validity state is updated.",
1390
- "name": "flow-ui-validate-complete",
1391
- "reactName": "onFlowUiValidateComplete"
1392
- },
1393
- {
1394
- "description": "Emitted when the input is validated and an error occurs.",
1395
- "name": "flow-ui-validate-error",
1396
- "reactName": "onFlowUiValidateError"
1397
- },
1398
- {
1399
- "description": "Emitted when the input is validated and no errors occur.",
1400
- "name": "flow-ui-validate-success",
1401
- "reactName": "onFlowUiValidateSuccess"
1402
1312
  }
1403
1313
  ],
1404
1314
  "attributes": [
@@ -1408,7 +1318,7 @@
1408
1318
  "text": "'small' | 'medium' | 'large'"
1409
1319
  },
1410
1320
  "default": "'medium'",
1411
- "description": "The autocomplete's size",
1321
+ "description": "The input's size.",
1412
1322
  "fieldName": "size"
1413
1323
  },
1414
1324
  {
@@ -1417,7 +1327,7 @@
1417
1327
  "text": "boolean"
1418
1328
  },
1419
1329
  "default": "false",
1420
- "description": "Draws a filled autocomplete input",
1330
+ "description": "Draws a filled input.",
1421
1331
  "fieldName": "filled"
1422
1332
  },
1423
1333
  {
@@ -1426,7 +1336,7 @@
1426
1336
  "text": "boolean"
1427
1337
  },
1428
1338
  "default": "false",
1429
- "description": "Draws a pill-style autocomplete input with rounded edges",
1339
+ "description": "Draws a pill-style input with rounded edges.",
1430
1340
  "fieldName": "pill"
1431
1341
  },
1432
1342
  {
@@ -1435,7 +1345,7 @@
1435
1345
  "text": "string"
1436
1346
  },
1437
1347
  "default": "''",
1438
- "description": "The autocomplete input's label. If you need to display HTML, use the `help-text` slot instead",
1348
+ "description": "The input's label. If you need to display HTML, use the `label` slot instead.",
1439
1349
  "fieldName": "label"
1440
1350
  },
1441
1351
  {
@@ -1444,25 +1354,16 @@
1444
1354
  "text": "string"
1445
1355
  },
1446
1356
  "default": "''",
1447
- "description": "The autocomplete input's help text. If you need to display HTML, use the `help-text` slot instead",
1357
+ "description": "The input's help text. If you need to display HTML, use the `help-text` slot instead.",
1448
1358
  "fieldName": "helpText"
1449
1359
  },
1450
- {
1451
- "name": "placeholder",
1452
- "type": {
1453
- "text": "string"
1454
- },
1455
- "default": "''",
1456
- "description": "The autocomplete input's placeholder text",
1457
- "fieldName": "placeholder"
1458
- },
1459
1360
  {
1460
1361
  "name": "disabled",
1461
1362
  "type": {
1462
1363
  "text": "boolean"
1463
1364
  },
1464
1365
  "default": "false",
1465
- "description": "Disables the autocomplete",
1366
+ "description": "Disables the input.",
1466
1367
  "fieldName": "disabled"
1467
1368
  },
1468
1369
  {
@@ -1470,7 +1371,8 @@
1470
1371
  "type": {
1471
1372
  "text": "string"
1472
1373
  },
1473
- "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
1374
+ "default": "''",
1375
+ "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
1474
1376
  "fieldName": "form"
1475
1377
  },
1476
1378
  {
@@ -1479,7 +1381,7 @@
1479
1381
  "text": "boolean"
1480
1382
  },
1481
1383
  "default": "false",
1482
- "description": "Makes the autocomplete a required field",
1384
+ "description": "Makes the input a required field.",
1483
1385
  "fieldName": "required"
1484
1386
  },
1485
1387
  {
@@ -1488,7 +1390,7 @@
1488
1390
  "text": "boolean"
1489
1391
  },
1490
1392
  "default": "false",
1491
- "description": "Display the autocomplete in the 'inline' form control style",
1393
+ "description": "Display the input in the 'inline' form control style.",
1492
1394
  "fieldName": "inline"
1493
1395
  },
1494
1396
  {
@@ -1499,79 +1401,20 @@
1499
1401
  "default": "false",
1500
1402
  "description": "Indicates that the control should display a divider",
1501
1403
  "fieldName": "divider"
1502
- },
1503
- {
1504
- "name": "hoist",
1505
- "type": {
1506
- "text": "boolean"
1507
- },
1508
- "default": "false",
1509
- "description": "Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
1510
- "fieldName": "hoist"
1511
- },
1512
- {
1513
- "name": "placement",
1514
- "type": {
1515
- "text": "'top' | 'bottom'"
1516
- },
1517
- "default": "'bottom'",
1518
- "description": "The preferred placement of the autocomplete's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.",
1519
- "fieldName": "placement"
1520
- },
1521
- {
1522
- "name": "value",
1523
- "type": {
1524
- "text": "string"
1525
- },
1526
- "default": "''",
1527
- "description": "Current value of the control, selected from one of the valid options available",
1528
- "fieldName": "value"
1529
- },
1530
- {
1531
- "name": "displayWith",
1532
- "type": {
1533
- "text": "((value: string) => string) | ((value: string) => Promise<string>)"
1534
- },
1535
- "description": "Function for determining the `displayValue` for a given `value`.\nBy default, it will show the `value` itself.",
1536
- "fieldName": "displayWith"
1537
- },
1538
- {
1539
- "name": "debounce-delay",
1540
- "type": {
1541
- "text": "number"
1542
- },
1543
- "default": "0",
1544
- "description": "Debounce delay",
1545
- "fieldName": "debounceDelay"
1546
- },
1547
- {
1548
- "name": "clearable",
1549
- "type": {
1550
- "text": "boolean"
1551
- },
1552
- "default": "false",
1553
- "description": "Show the option to clear input",
1554
- "fieldName": "clearable"
1555
- },
1556
- {
1557
- "name": "clear-on-focus",
1558
- "type": {
1559
- "text": "boolean"
1560
- },
1561
- "default": "false",
1562
- "description": "Clear the value when the autocomplete is focused on",
1563
- "fieldName": "clearOnFocus"
1564
1404
  }
1565
1405
  ],
1566
1406
  "superclass": {
1567
1407
  "name": "FlowRdfFormControl",
1568
1408
  "module": "/src/internal/flow-ui-rdf-element"
1569
1409
  },
1570
- "tagName": "flow-ui-autocomplete",
1571
- "summary": "The Autocomplete is a Text input enhanced by a panel of suggested options.",
1410
+ "tagName": "flow-ui-base-control",
1411
+ "summary": "Inputs collect data from the user.",
1412
+ "documentation": "https://developer.emu-analytics.net/docs/flow-ui-rdf/components/input",
1413
+ "status": "stable",
1414
+ "since": "2.0",
1572
1415
  "dependencies": [
1573
- "flow-ui-popup",
1574
- "flow-ui-icon"
1416
+ "flow-ui-icon",
1417
+ "flow-ui-icon-button"
1575
1418
  ],
1576
1419
  "customElement": true
1577
1420
  }
@@ -1581,15 +1424,15 @@
1581
1424
  "kind": "js",
1582
1425
  "name": "default",
1583
1426
  "declaration": {
1584
- "name": "FlowUiAutocomplete",
1585
- "module": "components/autocomplete/autocomplete.component.js"
1427
+ "name": "FlowUiBaseControl",
1428
+ "module": "components/base-control/base-control.component.js"
1586
1429
  }
1587
1430
  }
1588
1431
  ]
1589
1432
  },
1590
1433
  {
1591
1434
  "kind": "javascript-module",
1592
- "path": "components/autocomplete/autocomplete.js",
1435
+ "path": "components/base-control/base-control.js",
1593
1436
  "declarations": [],
1594
1437
  "exports": [
1595
1438
  {
@@ -1597,150 +1440,27 @@
1597
1440
  "name": "*",
1598
1441
  "declaration": {
1599
1442
  "name": "*",
1600
- "package": "./autocomplete.component"
1443
+ "package": "./base-control.component"
1601
1444
  }
1602
1445
  },
1603
1446
  {
1604
1447
  "kind": "js",
1605
1448
  "name": "default",
1606
1449
  "declaration": {
1607
- "name": "FlowUiAutocomplete",
1608
- "module": "components/autocomplete/autocomplete.js"
1450
+ "name": "FlowUiBaseControl",
1451
+ "module": "components/base-control/base-control.js"
1609
1452
  }
1610
1453
  }
1611
1454
  ]
1612
1455
  },
1613
1456
  {
1614
1457
  "kind": "javascript-module",
1615
- "path": "components/breadcrumb/breadcrumb.component.js",
1458
+ "path": "components/autocomplete/autocomplete.component.js",
1616
1459
  "declarations": [
1617
1460
  {
1618
1461
  "kind": "class",
1619
1462
  "description": "",
1620
- "name": "FlowUiBreadcrumb",
1621
- "cssParts": [
1622
- {
1623
- "description": "The component's base wrapper.",
1624
- "name": "base"
1625
- }
1626
- ],
1627
- "slots": [
1628
- {
1629
- "description": "One or more breadcrumb items to display.",
1630
- "name": ""
1631
- },
1632
- {
1633
- "description": "The separator to use between breadcrumb items. Works best with `<flow-ui-icon>`.",
1634
- "name": "separator"
1635
- }
1636
- ],
1637
- "members": [
1638
- {
1639
- "kind": "field",
1640
- "name": "localize",
1641
- "privacy": "private",
1642
- "readonly": true,
1643
- "default": "new LocalizeController(this)"
1644
- },
1645
- {
1646
- "kind": "field",
1647
- "name": "separatorDir",
1648
- "privacy": "private"
1649
- },
1650
- {
1651
- "kind": "field",
1652
- "name": "defaultSlot",
1653
- "type": {
1654
- "text": "HTMLSlotElement"
1655
- },
1656
- "privacy": "private"
1657
- },
1658
- {
1659
- "kind": "field",
1660
- "name": "separatorSlot",
1661
- "type": {
1662
- "text": "HTMLSlotElement"
1663
- },
1664
- "privacy": "private"
1665
- },
1666
- {
1667
- "kind": "field",
1668
- "name": "label",
1669
- "type": {
1670
- "text": "string"
1671
- },
1672
- "default": "''",
1673
- "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
1674
- "attribute": "label"
1675
- },
1676
- {
1677
- "kind": "method",
1678
- "name": "getSeparator",
1679
- "privacy": "private"
1680
- },
1681
- {
1682
- "kind": "method",
1683
- "name": "handleSlotChange",
1684
- "privacy": "private"
1685
- }
1686
- ],
1687
- "attributes": [
1688
- {
1689
- "name": "label",
1690
- "type": {
1691
- "text": "string"
1692
- },
1693
- "default": "''",
1694
- "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
1695
- "fieldName": "label"
1696
- }
1697
- ],
1698
- "superclass": {
1699
- "name": "FlowRdfElement",
1700
- "module": "/src/internal/flow-ui-rdf-element"
1701
- },
1702
- "tagName": "flow-ui-breadcrumb",
1703
- "summary": "Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.",
1704
- "dependencies": [
1705
- "flow-ui-icon"
1706
- ],
1707
- "customElement": true
1708
- }
1709
- ],
1710
- "exports": [
1711
- {
1712
- "kind": "js",
1713
- "name": "default",
1714
- "declaration": {
1715
- "name": "FlowUiBreadcrumb",
1716
- "module": "components/breadcrumb/breadcrumb.component.js"
1717
- }
1718
- }
1719
- ]
1720
- },
1721
- {
1722
- "kind": "javascript-module",
1723
- "path": "components/breadcrumb/breadcrumb.js",
1724
- "declarations": [],
1725
- "exports": [
1726
- {
1727
- "kind": "js",
1728
- "name": "default",
1729
- "declaration": {
1730
- "name": "FlowUiBreadcrumb",
1731
- "module": "components/breadcrumb/breadcrumb.js"
1732
- }
1733
- }
1734
- ]
1735
- },
1736
- {
1737
- "kind": "javascript-module",
1738
- "path": "components/base-control/base-control.component.js",
1739
- "declarations": [
1740
- {
1741
- "kind": "class",
1742
- "description": "",
1743
- "name": "FlowUiBaseControl",
1463
+ "name": "FlowUiAutocomplete",
1744
1464
  "cssParts": [
1745
1465
  {
1746
1466
  "description": "The form control that wraps the label, input, and help text.",
@@ -1751,7 +1471,7 @@
1751
1471
  "name": "form-control-label"
1752
1472
  },
1753
1473
  {
1754
- "description": "The input's wrapper.",
1474
+ "description": "The select's wrapper.",
1755
1475
  "name": "form-control-input"
1756
1476
  },
1757
1477
  {
@@ -1759,55 +1479,51 @@
1759
1479
  "name": "form-control-help-text"
1760
1480
  },
1761
1481
  {
1762
- "description": "The component's base wrapper.",
1763
- "name": "base"
1482
+ "description": "The container the wraps the prefix, suffix, combobox, clear icon, and expand button.",
1483
+ "name": "combobox"
1764
1484
  },
1765
1485
  {
1766
- "description": "The internal `<input>` control.",
1767
- "name": "input"
1486
+ "description": "The container that wraps the prefix slot.",
1487
+ "name": "prefix"
1768
1488
  },
1769
1489
  {
1770
- "description": "The container that wraps the prefix.",
1771
- "name": "prefix"
1490
+ "description": "The container that wraps the suffix slot.",
1491
+ "name": "suffix"
1772
1492
  },
1773
1493
  {
1774
- "description": "The clear button.",
1775
- "name": "clear-button"
1494
+ "description": "The element that displays the selected option's label, an `<input>` element.",
1495
+ "name": "display-input"
1776
1496
  },
1777
1497
  {
1778
- "description": "The password toggle button.",
1779
- "name": "password-toggle-button"
1498
+ "description": "The listbox container where options are slotted.",
1499
+ "name": "listbox"
1780
1500
  },
1781
1501
  {
1782
- "description": "The container that wraps the suffix.",
1783
- "name": "suffix"
1502
+ "description": "The clear button.",
1503
+ "name": "clear-button"
1784
1504
  }
1785
1505
  ],
1786
1506
  "slots": [
1507
+ {
1508
+ "description": "The listbox options. Must be `<flow-option>` elements. You can use `<flow-divider>` to group items visually.",
1509
+ "name": ""
1510
+ },
1787
1511
  {
1788
1512
  "description": "The input's label. Alternatively, you can use the `label` attribute.",
1789
1513
  "name": "label"
1790
1514
  },
1791
1515
  {
1792
- "description": "Used to prepend a presentational icon or similar element to the input.",
1516
+ "description": "Used to prepend a presentational icon or similar element to the combobox.",
1793
1517
  "name": "prefix"
1794
1518
  },
1795
1519
  {
1796
- "description": "Used to append a presentational icon or similar element to the input.",
1520
+ "description": "Used to append a presentational icon or similar element to the combobox.",
1797
1521
  "name": "suffix"
1798
1522
  },
1799
1523
  {
1800
1524
  "description": "An icon to use in lieu of the default clear icon.",
1801
1525
  "name": "clear-icon"
1802
1526
  },
1803
- {
1804
- "description": "An icon to use in lieu of the default show password icon.",
1805
- "name": "show-password-icon"
1806
- },
1807
- {
1808
- "description": "An icon to use in lieu of the default hide password icon.",
1809
- "name": "hide-password-icon"
1810
- },
1811
1527
  {
1812
1528
  "description": "Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.",
1813
1529
  "name": "help-text"
@@ -1816,10 +1532,12 @@
1816
1532
  "members": [
1817
1533
  {
1818
1534
  "kind": "field",
1819
- "name": "formControlController",
1820
- "privacy": "private",
1821
- "readonly": true,
1822
- "default": "new FormControlController(this, {\n assumeInteractionOn: ['flow-ui-blur', 'flow-ui-input']\n })"
1535
+ "name": "dependencies",
1536
+ "type": {
1537
+ "text": "object"
1538
+ },
1539
+ "static": true,
1540
+ "default": "{\n 'flow-ui-popup': FlowPopup,\n 'flow-ui-icon': FlowIcon\n }"
1823
1541
  },
1824
1542
  {
1825
1543
  "kind": "field",
@@ -1830,13 +1548,45 @@
1830
1548
  },
1831
1549
  {
1832
1550
  "kind": "field",
1833
- "name": "hasFocus",
1551
+ "name": "localize",
1552
+ "privacy": "private",
1553
+ "readonly": true,
1554
+ "default": "new LocalizeController(this)"
1555
+ },
1556
+ {
1557
+ "kind": "field",
1558
+ "name": "pendingChangeEvent",
1559
+ "type": {
1560
+ "text": "boolean"
1561
+ },
1562
+ "privacy": "private",
1563
+ "default": "false"
1564
+ },
1565
+ {
1566
+ "kind": "field",
1567
+ "name": "pendingInputEvent",
1568
+ "type": {
1569
+ "text": "boolean"
1570
+ },
1571
+ "privacy": "private",
1572
+ "default": "false"
1573
+ },
1574
+ {
1575
+ "kind": "field",
1576
+ "name": "hasOptions",
1834
1577
  "type": {
1835
1578
  "text": "boolean"
1836
1579
  },
1837
1580
  "privacy": "private",
1838
1581
  "default": "false"
1839
1582
  },
1583
+ {
1584
+ "kind": "field",
1585
+ "name": "formControlController",
1586
+ "privacy": "private",
1587
+ "readonly": true,
1588
+ "default": "new FormControlController(this, {\n assumeInteractionOn: ['flow-ui-blur', 'flow-ui-input']\n })"
1589
+ },
1840
1590
  {
1841
1591
  "kind": "field",
1842
1592
  "name": "size",
@@ -1844,7 +1594,7 @@
1844
1594
  "text": "'small' | 'medium' | 'large'"
1845
1595
  },
1846
1596
  "default": "'medium'",
1847
- "description": "The input's size.",
1597
+ "description": "The autocomplete's size",
1848
1598
  "attribute": "size",
1849
1599
  "reflects": true
1850
1600
  },
@@ -1855,7 +1605,7 @@
1855
1605
  "text": "boolean"
1856
1606
  },
1857
1607
  "default": "false",
1858
- "description": "Draws a filled input.",
1608
+ "description": "Draws a filled autocomplete input",
1859
1609
  "attribute": "filled",
1860
1610
  "reflects": true
1861
1611
  },
@@ -1866,7 +1616,7 @@
1866
1616
  "text": "boolean"
1867
1617
  },
1868
1618
  "default": "false",
1869
- "description": "Draws a pill-style input with rounded edges.",
1619
+ "description": "Draws a pill-style autocomplete input with rounded edges",
1870
1620
  "attribute": "pill",
1871
1621
  "reflects": true
1872
1622
  },
@@ -1877,7 +1627,7 @@
1877
1627
  "text": "string"
1878
1628
  },
1879
1629
  "default": "''",
1880
- "description": "The input's label. If you need to display HTML, use the `label` slot instead.",
1630
+ "description": "The autocomplete input's label. If you need to display HTML, use the `help-text` slot instead",
1881
1631
  "attribute": "label"
1882
1632
  },
1883
1633
  {
@@ -1887,9 +1637,19 @@
1887
1637
  "text": "string"
1888
1638
  },
1889
1639
  "default": "''",
1890
- "description": "The input's help text. If you need to display HTML, use the `help-text` slot instead.",
1640
+ "description": "The autocomplete input's help text. If you need to display HTML, use the `help-text` slot instead",
1891
1641
  "attribute": "help-text"
1892
1642
  },
1643
+ {
1644
+ "kind": "field",
1645
+ "name": "placeholder",
1646
+ "type": {
1647
+ "text": "string"
1648
+ },
1649
+ "default": "''",
1650
+ "description": "The autocomplete input's placeholder text",
1651
+ "attribute": "placeholder"
1652
+ },
1893
1653
  {
1894
1654
  "kind": "field",
1895
1655
  "name": "disabled",
@@ -1897,7 +1657,7 @@
1897
1657
  "text": "boolean"
1898
1658
  },
1899
1659
  "default": "false",
1900
- "description": "Disables the input.",
1660
+ "description": "Disables the autocomplete",
1901
1661
  "attribute": "disabled",
1902
1662
  "reflects": true
1903
1663
  },
@@ -1907,10 +1667,8 @@
1907
1667
  "type": {
1908
1668
  "text": "string"
1909
1669
  },
1910
- "default": "''",
1911
- "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
1912
- "attribute": "form",
1913
- "reflects": true
1670
+ "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
1671
+ "attribute": "form"
1914
1672
  },
1915
1673
  {
1916
1674
  "kind": "field",
@@ -1919,7 +1677,7 @@
1919
1677
  "text": "boolean"
1920
1678
  },
1921
1679
  "default": "false",
1922
- "description": "Makes the input a required field.",
1680
+ "description": "Makes the autocomplete a required field",
1923
1681
  "attribute": "required",
1924
1682
  "reflects": true
1925
1683
  },
@@ -1930,7 +1688,7 @@
1930
1688
  "text": "boolean"
1931
1689
  },
1932
1690
  "default": "false",
1933
- "description": "Display the input in the 'inline' form control style.",
1691
+ "description": "Display the autocomplete in the 'inline' form control style",
1934
1692
  "attribute": "inline",
1935
1693
  "reflects": true
1936
1694
  },
@@ -1947,49 +1705,128 @@
1947
1705
  },
1948
1706
  {
1949
1707
  "kind": "field",
1950
- "name": "validity",
1951
- "description": "Gets the validity state object",
1952
- "readonly": true
1708
+ "name": "hoist",
1709
+ "type": {
1710
+ "text": "boolean"
1711
+ },
1712
+ "default": "false",
1713
+ "description": "Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
1714
+ "attribute": "hoist"
1953
1715
  },
1954
1716
  {
1955
1717
  "kind": "field",
1956
- "name": "validationMessage",
1957
- "description": "Gets the validation message",
1958
- "readonly": true
1959
- },
1960
- {
1961
- "kind": "method",
1962
- "name": "handleBlur",
1963
- "privacy": "private"
1718
+ "name": "placement",
1719
+ "type": {
1720
+ "text": "'top' | 'bottom'"
1721
+ },
1722
+ "default": "'bottom'",
1723
+ "description": "The preferred placement of the autocomplete's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.",
1724
+ "attribute": "placement",
1725
+ "reflects": true
1964
1726
  },
1965
1727
  {
1966
- "kind": "method",
1967
- "name": "handleFocus",
1968
- "privacy": "private"
1728
+ "kind": "field",
1729
+ "name": "value",
1730
+ "type": {
1731
+ "text": "string"
1732
+ },
1733
+ "default": "''",
1734
+ "description": "Current value of the control, selected from one of the valid options available",
1735
+ "attribute": "value"
1969
1736
  },
1970
1737
  {
1971
- "kind": "method",
1972
- "name": "focus",
1973
- "parameters": [
1974
- {
1975
- "name": "options",
1976
- "optional": true,
1977
- "type": {
1978
- "text": "FocusOptions"
1979
- }
1980
- }
1981
- ],
1982
- "description": "Sets focus on the input."
1738
+ "kind": "field",
1739
+ "name": "displayWith",
1740
+ "type": {
1741
+ "text": "((value: string) => string) | ((value: string) => Promise<string>)"
1742
+ },
1743
+ "description": "Function for determining the `displayValue` for a given `value`.\nBy default, it will show the `value` itself.",
1744
+ "attribute": "displayWith"
1983
1745
  },
1984
1746
  {
1985
- "kind": "method",
1986
- "name": "blur",
1987
- "description": "Removes focus from the input."
1747
+ "kind": "field",
1748
+ "name": "debounceDelay",
1749
+ "type": {
1750
+ "text": "number"
1751
+ },
1752
+ "default": "0",
1753
+ "description": "Debounce delay",
1754
+ "attribute": "debounce-delay",
1755
+ "reflects": true
1988
1756
  },
1989
1757
  {
1990
- "kind": "method",
1991
- "name": "checkValidity",
1992
- "description": "Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
1758
+ "kind": "field",
1759
+ "name": "clearable",
1760
+ "type": {
1761
+ "text": "boolean"
1762
+ },
1763
+ "default": "false",
1764
+ "description": "Show the option to clear input",
1765
+ "attribute": "clearable",
1766
+ "reflects": true
1767
+ },
1768
+ {
1769
+ "kind": "field",
1770
+ "name": "clearOnFocus",
1771
+ "type": {
1772
+ "text": "boolean"
1773
+ },
1774
+ "default": "false",
1775
+ "description": "Clear the value when the autocomplete is focused on",
1776
+ "attribute": "clear-on-focus",
1777
+ "reflects": true
1778
+ },
1779
+ {
1780
+ "kind": "field",
1781
+ "name": "inputText",
1782
+ "type": {
1783
+ "text": "string"
1784
+ },
1785
+ "privacy": "private",
1786
+ "default": "''",
1787
+ "description": "Current value displayed by the control; this can be what the user is typing or the label of the selected option"
1788
+ },
1789
+ {
1790
+ "kind": "field",
1791
+ "name": "selectedOption",
1792
+ "type": {
1793
+ "text": "FlowOption | null"
1794
+ },
1795
+ "privacy": "private",
1796
+ "default": "null"
1797
+ },
1798
+ {
1799
+ "kind": "field",
1800
+ "name": "currentOption",
1801
+ "type": {
1802
+ "text": "FlowOption | null"
1803
+ },
1804
+ "privacy": "private",
1805
+ "default": "null"
1806
+ },
1807
+ {
1808
+ "kind": "field",
1809
+ "name": "input",
1810
+ "type": {
1811
+ "text": "HTMLInputElement"
1812
+ },
1813
+ "privacy": "private"
1814
+ },
1815
+ {
1816
+ "kind": "field",
1817
+ "name": "popup",
1818
+ "type": {
1819
+ "text": "FlowPopup"
1820
+ },
1821
+ "privacy": "private"
1822
+ },
1823
+ {
1824
+ "kind": "field",
1825
+ "name": "listbox",
1826
+ "type": {
1827
+ "text": "HTMLElement"
1828
+ },
1829
+ "privacy": "private"
1993
1830
  },
1994
1831
  {
1995
1832
  "kind": "method",
@@ -2001,9 +1838,36 @@
2001
1838
  },
2002
1839
  "description": "Gets the associated form, if one exists."
2003
1840
  },
1841
+ {
1842
+ "kind": "field",
1843
+ "name": "validity",
1844
+ "description": "Gets the validity state object.",
1845
+ "readonly": true
1846
+ },
1847
+ {
1848
+ "kind": "field",
1849
+ "name": "validationMessage",
1850
+ "description": "Gets the validation message.",
1851
+ "readonly": true
1852
+ },
1853
+ {
1854
+ "kind": "method",
1855
+ "name": "checkValidity",
1856
+ "return": {
1857
+ "type": {
1858
+ "text": "boolean"
1859
+ }
1860
+ },
1861
+ "description": "Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid."
1862
+ },
2004
1863
  {
2005
1864
  "kind": "method",
2006
1865
  "name": "reportValidity",
1866
+ "return": {
1867
+ "type": {
1868
+ "text": "boolean"
1869
+ }
1870
+ },
2007
1871
  "description": "Checks for validity and shows the browser's validation message if the control is invalid."
2008
1872
  },
2009
1873
  {
@@ -2011,100 +1875,186 @@
2011
1875
  "name": "setCustomValidity",
2012
1876
  "parameters": [
2013
1877
  {
2014
- "name": "message",
1878
+ "name": "_",
2015
1879
  "type": {
2016
1880
  "text": "string"
2017
1881
  }
2018
1882
  }
2019
1883
  ],
2020
1884
  "description": "Sets a custom validation message. Pass an empty string to restore validity."
2021
- }
2022
- ],
2023
- "events": [
1885
+ },
2024
1886
  {
2025
- "description": "Emitted when the control loses focus.",
2026
- "name": "flow-ui-blur",
2027
- "reactName": "onFlowUiBlur"
1887
+ "kind": "method",
1888
+ "name": "handleClearClick",
1889
+ "parameters": [
1890
+ {
1891
+ "name": "event",
1892
+ "type": {
1893
+ "text": "MouseEvent"
1894
+ }
1895
+ }
1896
+ ]
2028
1897
  },
2029
1898
  {
2030
- "description": "Emitted when an alteration to the control's value is committed by the user.",
2031
- "name": "flow-ui-change",
2032
- "reactName": "onFlowUiChange"
1899
+ "kind": "method",
1900
+ "name": "focus",
1901
+ "description": "Focuses on the control"
2033
1902
  },
2034
1903
  {
2035
- "description": "Emitted when the clear button is activated.",
2036
- "name": "flow-ui-clear",
2037
- "reactName": "onFlowUiClear"
1904
+ "kind": "method",
1905
+ "name": "blur",
1906
+ "description": "Blurs from the control."
2038
1907
  },
2039
1908
  {
2040
- "description": "Emitted when the control gains focus.",
2041
- "name": "flow-ui-focus",
2042
- "reactName": "onFlowUiFocus"
1909
+ "kind": "method",
1910
+ "name": "show",
1911
+ "description": "Shows the listbox."
2043
1912
  },
2044
1913
  {
2045
- "description": "Emitted when the control receives input.",
2046
- "name": "flow-ui-input",
2047
- "reactName": "onFlowUiInput"
1914
+ "kind": "method",
1915
+ "name": "hide",
1916
+ "description": "Hides the listbox."
2048
1917
  },
2049
1918
  {
2050
- "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied.",
2051
- "name": "flow-ui-invalid",
2052
- "reactName": "onFlowUiInvalid"
1919
+ "kind": "method",
1920
+ "name": "getInputText",
1921
+ "description": "Gets the current value of the text input"
2053
1922
  }
2054
1923
  ],
2055
- "attributes": [
1924
+ "events": [
2056
1925
  {
2057
- "name": "size",
2058
- "type": {
2059
- "text": "'small' | 'medium' | 'large'"
2060
- },
2061
- "default": "'medium'",
2062
- "description": "The input's size.",
2063
- "fieldName": "size"
1926
+ "description": "Emitted when the display value changes.",
1927
+ "name": "flow-ui-input",
1928
+ "reactName": "onFlowUiInput"
2064
1929
  },
2065
1930
  {
2066
- "name": "filled",
2067
- "type": {
2068
- "text": "boolean"
2069
- },
2070
- "default": "false",
2071
- "description": "Draws a filled input.",
2072
- "fieldName": "filled"
1931
+ "description": "Emitted when the input value changes.",
1932
+ "name": "flow-ui-change",
1933
+ "reactName": "onFlowUiChange"
2073
1934
  },
2074
1935
  {
2075
- "name": "pill",
2076
- "type": {
2077
- "text": "boolean"
2078
- },
2079
- "default": "false",
2080
- "description": "Draws a pill-style input with rounded edges.",
2081
- "fieldName": "pill"
1936
+ "description": "Emitted when the input is focused.",
1937
+ "name": "flow-ui-focus",
1938
+ "reactName": "onFlowUiFocus"
2082
1939
  },
2083
1940
  {
2084
- "name": "label",
2085
- "type": {
2086
- "text": "string"
2087
- },
2088
- "default": "''",
2089
- "description": "The input's label. If you need to display HTML, use the `label` slot instead.",
2090
- "fieldName": "label"
1941
+ "description": "Emitted when the input is blurred.",
1942
+ "name": "flow-ui-blur",
1943
+ "reactName": "onFlowUiBlur"
2091
1944
  },
2092
1945
  {
2093
- "name": "help-text",
2094
- "type": {
2095
- "text": "string"
2096
- },
2097
- "default": "''",
2098
- "description": "The input's help text. If you need to display HTML, use the `help-text` slot instead.",
2099
- "fieldName": "helpText"
1946
+ "description": "Emitted when the dropdown is shown.",
1947
+ "name": "flow-ui-show",
1948
+ "reactName": "onFlowUiShow"
2100
1949
  },
2101
1950
  {
2102
- "name": "disabled",
2103
- "type": {
2104
- "text": "boolean"
1951
+ "description": "Emitted when the dropdown is shown.",
1952
+ "name": "flow-ui-after-show",
1953
+ "reactName": "onFlowUiAfterShow"
1954
+ },
1955
+ {
1956
+ "description": "Emitted when the dropdown is hidden.",
1957
+ "name": "flow-ui-hide",
1958
+ "reactName": "onFlowUiHide"
1959
+ },
1960
+ {
1961
+ "description": "Emitted when the dropdown is hidden.",
1962
+ "name": "flow-ui-after-hide",
1963
+ "reactName": "onFlowUiAfterHide"
1964
+ },
1965
+ {
1966
+ "description": "Emitted when the input is invalid.",
1967
+ "name": "flow-ui-invalid",
1968
+ "reactName": "onFlowUiInvalid"
1969
+ },
1970
+ {
1971
+ "description": "Emitted when the input is valid.",
1972
+ "name": "flow-ui-valid",
1973
+ "reactName": "onFlowUiValid"
1974
+ },
1975
+ {
1976
+ "description": "Emitted when the input is validated.",
1977
+ "name": "flow-ui-validate",
1978
+ "reactName": "onFlowUiValidate"
1979
+ },
1980
+ {
1981
+ "description": "Emitted when the input is validated and the validity state is updated.",
1982
+ "name": "flow-ui-validate-complete",
1983
+ "reactName": "onFlowUiValidateComplete"
1984
+ },
1985
+ {
1986
+ "description": "Emitted when the input is validated and an error occurs.",
1987
+ "name": "flow-ui-validate-error",
1988
+ "reactName": "onFlowUiValidateError"
1989
+ },
1990
+ {
1991
+ "description": "Emitted when the input is validated and no errors occur.",
1992
+ "name": "flow-ui-validate-success",
1993
+ "reactName": "onFlowUiValidateSuccess"
1994
+ }
1995
+ ],
1996
+ "attributes": [
1997
+ {
1998
+ "name": "size",
1999
+ "type": {
2000
+ "text": "'small' | 'medium' | 'large'"
2001
+ },
2002
+ "default": "'medium'",
2003
+ "description": "The autocomplete's size",
2004
+ "fieldName": "size"
2005
+ },
2006
+ {
2007
+ "name": "filled",
2008
+ "type": {
2009
+ "text": "boolean"
2105
2010
  },
2106
2011
  "default": "false",
2107
- "description": "Disables the input.",
2012
+ "description": "Draws a filled autocomplete input",
2013
+ "fieldName": "filled"
2014
+ },
2015
+ {
2016
+ "name": "pill",
2017
+ "type": {
2018
+ "text": "boolean"
2019
+ },
2020
+ "default": "false",
2021
+ "description": "Draws a pill-style autocomplete input with rounded edges",
2022
+ "fieldName": "pill"
2023
+ },
2024
+ {
2025
+ "name": "label",
2026
+ "type": {
2027
+ "text": "string"
2028
+ },
2029
+ "default": "''",
2030
+ "description": "The autocomplete input's label. If you need to display HTML, use the `help-text` slot instead",
2031
+ "fieldName": "label"
2032
+ },
2033
+ {
2034
+ "name": "help-text",
2035
+ "type": {
2036
+ "text": "string"
2037
+ },
2038
+ "default": "''",
2039
+ "description": "The autocomplete input's help text. If you need to display HTML, use the `help-text` slot instead",
2040
+ "fieldName": "helpText"
2041
+ },
2042
+ {
2043
+ "name": "placeholder",
2044
+ "type": {
2045
+ "text": "string"
2046
+ },
2047
+ "default": "''",
2048
+ "description": "The autocomplete input's placeholder text",
2049
+ "fieldName": "placeholder"
2050
+ },
2051
+ {
2052
+ "name": "disabled",
2053
+ "type": {
2054
+ "text": "boolean"
2055
+ },
2056
+ "default": "false",
2057
+ "description": "Disables the autocomplete",
2108
2058
  "fieldName": "disabled"
2109
2059
  },
2110
2060
  {
@@ -2112,8 +2062,7 @@
2112
2062
  "type": {
2113
2063
  "text": "string"
2114
2064
  },
2115
- "default": "''",
2116
- "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
2065
+ "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
2117
2066
  "fieldName": "form"
2118
2067
  },
2119
2068
  {
@@ -2122,7 +2071,7 @@
2122
2071
  "text": "boolean"
2123
2072
  },
2124
2073
  "default": "false",
2125
- "description": "Makes the input a required field.",
2074
+ "description": "Makes the autocomplete a required field",
2126
2075
  "fieldName": "required"
2127
2076
  },
2128
2077
  {
@@ -2131,7 +2080,7 @@
2131
2080
  "text": "boolean"
2132
2081
  },
2133
2082
  "default": "false",
2134
- "description": "Display the input in the 'inline' form control style.",
2083
+ "description": "Display the autocomplete in the 'inline' form control style",
2135
2084
  "fieldName": "inline"
2136
2085
  },
2137
2086
  {
@@ -2142,20 +2091,79 @@
2142
2091
  "default": "false",
2143
2092
  "description": "Indicates that the control should display a divider",
2144
2093
  "fieldName": "divider"
2094
+ },
2095
+ {
2096
+ "name": "hoist",
2097
+ "type": {
2098
+ "text": "boolean"
2099
+ },
2100
+ "default": "false",
2101
+ "description": "Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
2102
+ "fieldName": "hoist"
2103
+ },
2104
+ {
2105
+ "name": "placement",
2106
+ "type": {
2107
+ "text": "'top' | 'bottom'"
2108
+ },
2109
+ "default": "'bottom'",
2110
+ "description": "The preferred placement of the autocomplete's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.",
2111
+ "fieldName": "placement"
2112
+ },
2113
+ {
2114
+ "name": "value",
2115
+ "type": {
2116
+ "text": "string"
2117
+ },
2118
+ "default": "''",
2119
+ "description": "Current value of the control, selected from one of the valid options available",
2120
+ "fieldName": "value"
2121
+ },
2122
+ {
2123
+ "name": "displayWith",
2124
+ "type": {
2125
+ "text": "((value: string) => string) | ((value: string) => Promise<string>)"
2126
+ },
2127
+ "description": "Function for determining the `displayValue` for a given `value`.\nBy default, it will show the `value` itself.",
2128
+ "fieldName": "displayWith"
2129
+ },
2130
+ {
2131
+ "name": "debounce-delay",
2132
+ "type": {
2133
+ "text": "number"
2134
+ },
2135
+ "default": "0",
2136
+ "description": "Debounce delay",
2137
+ "fieldName": "debounceDelay"
2138
+ },
2139
+ {
2140
+ "name": "clearable",
2141
+ "type": {
2142
+ "text": "boolean"
2143
+ },
2144
+ "default": "false",
2145
+ "description": "Show the option to clear input",
2146
+ "fieldName": "clearable"
2147
+ },
2148
+ {
2149
+ "name": "clear-on-focus",
2150
+ "type": {
2151
+ "text": "boolean"
2152
+ },
2153
+ "default": "false",
2154
+ "description": "Clear the value when the autocomplete is focused on",
2155
+ "fieldName": "clearOnFocus"
2145
2156
  }
2146
2157
  ],
2147
2158
  "superclass": {
2148
2159
  "name": "FlowRdfFormControl",
2149
2160
  "module": "/src/internal/flow-ui-rdf-element"
2150
2161
  },
2151
- "tagName": "flow-ui-base-control",
2152
- "summary": "Inputs collect data from the user.",
2153
- "documentation": "https://developer.emu-analytics.net/docs/flow-ui-rdf/components/input",
2154
- "status": "stable",
2155
- "since": "2.0",
2162
+ "tagName": "flow-ui-autocomplete",
2163
+ "summary": "The Autocomplete is a Text input enhanced by a panel of suggested options.",
2156
2164
  "dependencies": [
2157
- "flow-ui-icon",
2158
- "flow-ui-icon-button"
2165
+ "flow-ui-popup",
2166
+ "flow-ui-icon"
2159
2167
  ],
2160
2168
  "customElement": true
2161
2169
  }
@@ -2165,15 +2173,15 @@
2165
2173
  "kind": "js",
2166
2174
  "name": "default",
2167
2175
  "declaration": {
2168
- "name": "FlowUiBaseControl",
2169
- "module": "components/base-control/base-control.component.js"
2176
+ "name": "FlowUiAutocomplete",
2177
+ "module": "components/autocomplete/autocomplete.component.js"
2170
2178
  }
2171
2179
  }
2172
2180
  ]
2173
2181
  },
2174
2182
  {
2175
2183
  "kind": "javascript-module",
2176
- "path": "components/base-control/base-control.js",
2184
+ "path": "components/autocomplete/autocomplete.js",
2177
2185
  "declarations": [],
2178
2186
  "exports": [
2179
2187
  {
@@ -2181,27 +2189,27 @@
2181
2189
  "name": "*",
2182
2190
  "declaration": {
2183
2191
  "name": "*",
2184
- "package": "./base-control.component"
2192
+ "package": "./autocomplete.component"
2185
2193
  }
2186
2194
  },
2187
2195
  {
2188
2196
  "kind": "js",
2189
2197
  "name": "default",
2190
2198
  "declaration": {
2191
- "name": "FlowUiBaseControl",
2192
- "module": "components/base-control/base-control.js"
2199
+ "name": "FlowUiAutocomplete",
2200
+ "module": "components/autocomplete/autocomplete.js"
2193
2201
  }
2194
2202
  }
2195
2203
  ]
2196
2204
  },
2197
2205
  {
2198
2206
  "kind": "javascript-module",
2199
- "path": "components/badge/badge.component.js",
2207
+ "path": "components/breadcrumb/breadcrumb.component.js",
2200
2208
  "declarations": [
2201
2209
  {
2202
2210
  "kind": "class",
2203
2211
  "description": "",
2204
- "name": "FlowUiBadge",
2212
+ "name": "FlowUiBreadcrumb",
2205
2213
  "cssParts": [
2206
2214
  {
2207
2215
  "description": "The component's base wrapper.",
@@ -2210,100 +2218,84 @@
2210
2218
  ],
2211
2219
  "slots": [
2212
2220
  {
2213
- "description": "The badge's content.",
2221
+ "description": "One or more breadcrumb items to display.",
2214
2222
  "name": ""
2223
+ },
2224
+ {
2225
+ "description": "The separator to use between breadcrumb items. Works best with `<flow-ui-icon>`.",
2226
+ "name": "separator"
2215
2227
  }
2216
2228
  ],
2217
2229
  "members": [
2218
2230
  {
2219
2231
  "kind": "field",
2220
- "name": "variant",
2221
- "type": {
2222
- "text": "'primary' | 'secondary' | 'success' | 'neutral' | 'warning' | 'danger'"
2223
- },
2224
- "default": "'primary'",
2225
- "description": "The badge's theme variant.",
2226
- "attribute": "variant",
2227
- "reflects": true
2232
+ "name": "localize",
2233
+ "privacy": "private",
2234
+ "readonly": true,
2235
+ "default": "new LocalizeController(this)"
2228
2236
  },
2229
2237
  {
2230
2238
  "kind": "field",
2231
- "name": "size",
2232
- "type": {
2233
- "text": "'small' | 'medium' | 'large'"
2234
- },
2235
- "default": "'medium'",
2236
- "description": "The badge size.",
2237
- "attribute": "size",
2238
- "reflects": true
2239
+ "name": "separatorDir",
2240
+ "privacy": "private"
2239
2241
  },
2240
2242
  {
2241
2243
  "kind": "field",
2242
- "name": "pill",
2244
+ "name": "defaultSlot",
2243
2245
  "type": {
2244
- "text": "boolean"
2246
+ "text": "HTMLSlotElement"
2245
2247
  },
2246
- "default": "false",
2247
- "description": "Draws a pill-style badge with rounded edges.",
2248
- "attribute": "pill",
2249
- "reflects": true
2248
+ "privacy": "private"
2250
2249
  },
2251
2250
  {
2252
2251
  "kind": "field",
2253
- "name": "pulse",
2252
+ "name": "separatorSlot",
2254
2253
  "type": {
2255
- "text": "boolean"
2254
+ "text": "HTMLSlotElement"
2256
2255
  },
2257
- "default": "false",
2258
- "description": "Makes the badge pulsate to draw attention.",
2259
- "attribute": "pulse",
2260
- "reflects": true
2261
- }
2262
- ],
2263
- "attributes": [
2256
+ "privacy": "private"
2257
+ },
2264
2258
  {
2265
- "name": "variant",
2259
+ "kind": "field",
2260
+ "name": "label",
2266
2261
  "type": {
2267
- "text": "'primary' | 'secondary' | 'success' | 'neutral' | 'warning' | 'danger'"
2262
+ "text": "string"
2268
2263
  },
2269
- "default": "'primary'",
2270
- "description": "The badge's theme variant.",
2271
- "fieldName": "variant"
2264
+ "default": "''",
2265
+ "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
2266
+ "attribute": "label"
2272
2267
  },
2273
2268
  {
2274
- "name": "size",
2275
- "type": {
2276
- "text": "'small' | 'medium' | 'large'"
2277
- },
2278
- "default": "'medium'",
2279
- "description": "The badge size.",
2280
- "fieldName": "size"
2269
+ "kind": "method",
2270
+ "name": "getSeparator",
2271
+ "privacy": "private"
2281
2272
  },
2282
2273
  {
2283
- "name": "pill",
2284
- "type": {
2285
- "text": "boolean"
2286
- },
2287
- "default": "false",
2288
- "description": "Draws a pill-style badge with rounded edges.",
2289
- "fieldName": "pill"
2290
- },
2274
+ "kind": "method",
2275
+ "name": "handleSlotChange",
2276
+ "privacy": "private"
2277
+ }
2278
+ ],
2279
+ "attributes": [
2291
2280
  {
2292
- "name": "pulse",
2281
+ "name": "label",
2293
2282
  "type": {
2294
- "text": "boolean"
2283
+ "text": "string"
2295
2284
  },
2296
- "default": "false",
2297
- "description": "Makes the badge pulsate to draw attention.",
2298
- "fieldName": "pulse"
2285
+ "default": "''",
2286
+ "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
2287
+ "fieldName": "label"
2299
2288
  }
2300
2289
  ],
2301
2290
  "superclass": {
2302
2291
  "name": "FlowRdfElement",
2303
2292
  "module": "/src/internal/flow-ui-rdf-element"
2304
2293
  },
2305
- "tagName": "flow-ui-badge",
2306
- "summary": "Badges are used to draw attention and display statuses or counts.",
2294
+ "tagName": "flow-ui-breadcrumb",
2295
+ "summary": "Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.",
2296
+ "dependencies": [
2297
+ "flow-ui-icon"
2298
+ ],
2307
2299
  "customElement": true
2308
2300
  }
2309
2301
  ],
@@ -2312,23 +2304,23 @@
2312
2304
  "kind": "js",
2313
2305
  "name": "default",
2314
2306
  "declaration": {
2315
- "name": "FlowUiBadge",
2316
- "module": "components/badge/badge.component.js"
2307
+ "name": "FlowUiBreadcrumb",
2308
+ "module": "components/breadcrumb/breadcrumb.component.js"
2317
2309
  }
2318
2310
  }
2319
2311
  ]
2320
2312
  },
2321
2313
  {
2322
2314
  "kind": "javascript-module",
2323
- "path": "components/badge/badge.js",
2315
+ "path": "components/breadcrumb/breadcrumb.js",
2324
2316
  "declarations": [],
2325
2317
  "exports": [
2326
2318
  {
2327
2319
  "kind": "js",
2328
2320
  "name": "default",
2329
2321
  "declaration": {
2330
- "name": "FlowUiBadge",
2331
- "module": "components/badge/badge.js"
2322
+ "name": "FlowUiBreadcrumb",
2323
+ "module": "components/breadcrumb/breadcrumb.js"
2332
2324
  }
2333
2325
  }
2334
2326
  ]
@@ -3487,11 +3479,11 @@
3487
3479
  "declarations": [
3488
3480
  {
3489
3481
  "kind": "class",
3490
- "description": "",
3482
+ "description": "The calendar component is used to select a date, a time or both. It is also used in the popups of the\n[date time picker](./flow-ui-date-time-picker) and [timer](./flow-ui-timer) components.\n\nSet `range` to select a range instead of a single value. The type of range depends on `display-mode`:\n\n- `date` - A range of days.\n- `datetime` - A range of days with a start time and an end time.\n- `time` - A range of times within a single day.\n\nIn range mode, the value is not updated and no events are emitted until both ends of the range have been selected.\n\nUse `min`, `max` and `max-range` to restrict the dates that can be selected. Note that the calendar does not change\na value that is outside these limits.",
3491
3483
  "name": "FlowUiCalendar",
3492
3484
  "cssProperties": [
3493
3485
  {
3494
- "description": "The width of the calendar in CSS units. Set automatically if `size` is set.",
3486
+ "description": "The width of the calendar in CSS units, or of each month when `months` is `2`. Set automatically if `size` is set.",
3495
3487
  "name": "--width"
3496
3488
  },
3497
3489
  {
@@ -3542,13 +3534,67 @@
3542
3534
  },
3543
3535
  "privacy": "private"
3544
3536
  },
3537
+ {
3538
+ "kind": "field",
3539
+ "name": "_selectedRange",
3540
+ "type": {
3541
+ "text": "Interval<true> | undefined"
3542
+ },
3543
+ "privacy": "private",
3544
+ "description": "The selected date range in range mode (half-open, in whole days)."
3545
+ },
3546
+ {
3547
+ "kind": "field",
3548
+ "name": "_pendingDay",
3549
+ "type": {
3550
+ "text": "DateTime<true> | undefined"
3551
+ },
3552
+ "privacy": "private",
3553
+ "description": "The first day the user clicked in a range that isn't complete yet. It may become the range start or the last day."
3554
+ },
3555
+ {
3556
+ "kind": "field",
3557
+ "name": "_hoverDate",
3558
+ "type": {
3559
+ "text": "DateTime<true> | undefined"
3560
+ },
3561
+ "privacy": "private",
3562
+ "description": "The day that the pointer or focus is on while a range is pending, used for the hover preview."
3563
+ },
3564
+ {
3565
+ "kind": "field",
3566
+ "name": "_startTime",
3567
+ "type": {
3568
+ "text": "TimeOfDay"
3569
+ },
3570
+ "privacy": "private",
3571
+ "default": "{ hour: 0, minute: 0, second: 0 }",
3572
+ "description": "The start time of a datetime range, on the range start."
3573
+ },
3574
+ {
3575
+ "kind": "field",
3576
+ "name": "_endTime",
3577
+ "type": {
3578
+ "text": "TimeOfDay"
3579
+ },
3580
+ "privacy": "private",
3581
+ "default": "{ hour: 24, minute: 0, second: 0 }",
3582
+ "description": "The end time of a datetime range, on the last day. 24:00:00 is the end of the last day."
3583
+ },
3584
+ {
3585
+ "kind": "field",
3586
+ "name": "localize",
3587
+ "privacy": "private",
3588
+ "readonly": true,
3589
+ "default": "new LocalizeController(this)"
3590
+ },
3545
3591
  {
3546
3592
  "kind": "field",
3547
3593
  "name": "value",
3548
3594
  "type": {
3549
3595
  "text": "string"
3550
3596
  },
3551
- "description": "The value of the control. (ISO8601 date/time string)",
3597
+ "description": "The value of the control. (ISO8601 date/time string) In range mode, the value is an ISO8601 interval string\n(`<start>/<end>`) and the end is exclusive. For example, the date range October 1 to October 2 has the value\n`2026-10-01T00:00:00.000+01:00/2026-10-03T00:00:00.000+01:00`.",
3552
3598
  "attribute": "value",
3553
3599
  "reflects": true
3554
3600
  },
@@ -3559,9 +3605,20 @@
3559
3605
  "text": "'date' | 'time' | 'datetime'"
3560
3606
  },
3561
3607
  "default": "'date'",
3562
- "description": "Select whether to show date only, time only or both date and time.",
3608
+ "description": "The display mode: date only, time only, or both date and time.",
3563
3609
  "attribute": "display-mode"
3564
3610
  },
3611
+ {
3612
+ "kind": "field",
3613
+ "name": "range",
3614
+ "type": {
3615
+ "text": "boolean"
3616
+ },
3617
+ "default": "false",
3618
+ "description": "Set to `true` to select a date, datetime or time range instead of a single value, depending on `display-mode`.",
3619
+ "attribute": "range",
3620
+ "reflects": true
3621
+ },
3565
3622
  {
3566
3623
  "kind": "field",
3567
3624
  "name": "timezone",
@@ -3590,126 +3647,556 @@
3590
3647
  "description": "Set the size of the calendar.",
3591
3648
  "attribute": "size"
3592
3649
  },
3650
+ {
3651
+ "kind": "field",
3652
+ "name": "months",
3653
+ "type": {
3654
+ "text": "1 | 2"
3655
+ },
3656
+ "default": "1",
3657
+ "description": "The number of months to show side by side.",
3658
+ "attribute": "months"
3659
+ },
3660
+ {
3661
+ "kind": "field",
3662
+ "name": "min",
3663
+ "type": {
3664
+ "text": "string | undefined"
3665
+ },
3666
+ "description": "The earliest date that can be selected. (ISO8601 date or date/time string) Note that `min` is ignored when\n`display-mode` is `time`.",
3667
+ "attribute": "min"
3668
+ },
3669
+ {
3670
+ "kind": "field",
3671
+ "name": "max",
3672
+ "type": {
3673
+ "text": "string | undefined"
3674
+ },
3675
+ "description": "The latest date that can be selected. (ISO8601 date or date/time string) Note that `max` is ignored when\n`display-mode` is `time`.",
3676
+ "attribute": "max"
3677
+ },
3678
+ {
3679
+ "kind": "field",
3680
+ "name": "maxRange",
3681
+ "type": {
3682
+ "text": "string | undefined"
3683
+ },
3684
+ "description": "The maximum length of a range. (Duration string, e.g. `'7 days'` or `'1 month'`) Supported units are milliseconds,\nseconds, minutes, hours, days, weeks and months.",
3685
+ "attribute": "max-range"
3686
+ },
3687
+ {
3688
+ "kind": "field",
3689
+ "name": "monthCount",
3690
+ "privacy": "private",
3691
+ "description": "The number of months shown. Anything other than `2` shows one month.",
3692
+ "readonly": true
3693
+ },
3694
+ {
3695
+ "kind": "field",
3696
+ "name": "isRangeMode",
3697
+ "privacy": "private",
3698
+ "description": "Whether the calendar selects a range: a date range, a datetime range or a time range.",
3699
+ "readonly": true
3700
+ },
3701
+ {
3702
+ "kind": "field",
3703
+ "name": "isDateTimeRangeMode",
3704
+ "privacy": "private",
3705
+ "description": "Whether the calendar selects a datetime range, with start and end times.",
3706
+ "readonly": true
3707
+ },
3708
+ {
3709
+ "kind": "field",
3710
+ "name": "isTimeRangeMode",
3711
+ "privacy": "private",
3712
+ "description": "Whether the calendar selects a time range: start and end times, with no days.",
3713
+ "readonly": true
3714
+ },
3715
+ {
3716
+ "kind": "field",
3717
+ "name": "limits",
3718
+ "type": {
3719
+ "text": "DateLimits"
3720
+ },
3721
+ "privacy": "private",
3722
+ "description": "The parsed `min`, `max` and `max-range`, in the calendar's timezone. There are no limits in time display mode.",
3723
+ "readonly": true
3724
+ },
3725
+ {
3726
+ "kind": "method",
3727
+ "name": "isDayDisabled",
3728
+ "privacy": "private",
3729
+ "parameters": [
3730
+ {
3731
+ "name": "day",
3732
+ "type": {
3733
+ "text": "DateTime<true>"
3734
+ }
3735
+ },
3736
+ {
3737
+ "name": "limits",
3738
+ "default": "this.limits"
3739
+ }
3740
+ ],
3741
+ "description": "Whether the user can't select `day` (the start of a day): it is outside `min` or `max`, or, while a range is\npending, it would make the range longer than `max-range`."
3742
+ },
3743
+ {
3744
+ "kind": "method",
3745
+ "name": "clampToLimits",
3746
+ "privacy": "private",
3747
+ "return": {
3748
+ "type": {
3749
+ "text": "DateTime<true>"
3750
+ }
3751
+ },
3752
+ "parameters": [
3753
+ {
3754
+ "name": "date",
3755
+ "type": {
3756
+ "text": "DateTime<true>"
3757
+ }
3758
+ }
3759
+ ],
3760
+ "description": "Clamp a date and time to `min` and `max`, so that the time inputs can't select a time outside the limits."
3761
+ },
3762
+ {
3763
+ "kind": "field",
3764
+ "name": "monthLimits",
3765
+ "privacy": "private",
3766
+ "description": "The first and last months the user can navigate to, as the start of each month, if `min` or `max` is set.",
3767
+ "readonly": true
3768
+ },
3769
+ {
3770
+ "kind": "method",
3771
+ "name": "clampMonth",
3772
+ "privacy": "private",
3773
+ "return": {
3774
+ "type": {
3775
+ "text": "DateTime<true>"
3776
+ }
3777
+ },
3778
+ "parameters": [
3779
+ {
3780
+ "name": "month",
3781
+ "type": {
3782
+ "text": "DateTime<true>"
3783
+ }
3784
+ }
3785
+ ],
3786
+ "description": "Clamp a month to the months the user can navigate to."
3787
+ },
3788
+ {
3789
+ "kind": "method",
3790
+ "name": "handleRangeValueChange",
3791
+ "privacy": "private"
3792
+ },
3793
+ {
3794
+ "kind": "method",
3795
+ "name": "showMonthOf",
3796
+ "privacy": "private",
3797
+ "parameters": [
3798
+ {
3799
+ "name": "date",
3800
+ "type": {
3801
+ "text": "DateTime<true>"
3802
+ }
3803
+ }
3804
+ ],
3805
+ "description": "Show the month of `date` as the first month. In the two-month view, a date in the second month is already shown,\nso the display doesn't move."
3806
+ },
3807
+ {
3808
+ "kind": "method",
3809
+ "name": "dateClicked",
3810
+ "privacy": "private",
3811
+ "parameters": [
3812
+ {
3813
+ "name": "val",
3814
+ "type": {
3815
+ "text": "string"
3816
+ }
3817
+ }
3818
+ ]
3819
+ },
3820
+ {
3821
+ "kind": "method",
3822
+ "name": "rangeDateClicked",
3823
+ "privacy": "private",
3824
+ "parameters": [
3825
+ {
3826
+ "name": "val",
3827
+ "type": {
3828
+ "text": "string"
3829
+ }
3830
+ }
3831
+ ],
3832
+ "description": "Handle a day click in range mode. The first click sets the pending day. The second click completes the range,\nwhichever order the two days were clicked in, so the user can click the last day first and then go back to the\nrange start."
3833
+ },
3834
+ {
3835
+ "kind": "method",
3836
+ "name": "isSingleDayOnly",
3837
+ "privacy": "private",
3838
+ "parameters": [
3839
+ {
3840
+ "name": "day",
3841
+ "type": {
3842
+ "text": "DateTime<true>"
3843
+ }
3844
+ }
3845
+ ],
3846
+ "description": "Whether `max-range` only allows ranges of one day starting on `day`, so that a range is a single day."
3847
+ },
3848
+ {
3849
+ "kind": "method",
3850
+ "name": "completeRange",
3851
+ "privacy": "private",
3852
+ "parameters": [
3853
+ {
3854
+ "name": "first",
3855
+ "type": {
3856
+ "text": "DateTime<true>"
3857
+ }
3858
+ },
3859
+ {
3860
+ "name": "last",
3861
+ "type": {
3862
+ "text": "DateTime<true>"
3863
+ }
3864
+ }
3865
+ ],
3866
+ "description": "Complete a range from `first` to `last` (both the start of a day) and update the value."
3867
+ },
3868
+ {
3869
+ "kind": "method",
3870
+ "name": "makeDateTimeRange",
3871
+ "privacy": "private",
3872
+ "return": {
3873
+ "type": {
3874
+ "text": "Interval"
3875
+ }
3876
+ },
3877
+ "parameters": [
3878
+ {
3879
+ "name": "first",
3880
+ "type": {
3881
+ "text": "DateTime<true>"
3882
+ }
3883
+ },
3884
+ {
3885
+ "name": "last",
3886
+ "type": {
3887
+ "text": "DateTime<true>"
3888
+ }
3889
+ }
3890
+ ],
3891
+ "description": "The datetime range from the start time on `first` to the end time on `last` (both the start of a day), clamped to\n`min` and `max`. If the times would make the range empty, for example an end time before the start time on a\nsingle day, the end time is reset to 24:00:00. If the range would be longer than `max-range`, the end is moved\nback."
3892
+ },
3893
+ {
3894
+ "kind": "method",
3895
+ "name": "dayHovered",
3896
+ "privacy": "private",
3897
+ "parameters": [
3898
+ {
3899
+ "name": "val",
3900
+ "type": {
3901
+ "text": "string"
3902
+ }
3903
+ }
3904
+ ]
3905
+ },
3906
+ {
3907
+ "kind": "method",
3908
+ "name": "handleKeyDown",
3909
+ "privacy": "private",
3910
+ "parameters": [
3911
+ {
3912
+ "name": "event",
3913
+ "type": {
3914
+ "text": "KeyboardEvent"
3915
+ }
3916
+ }
3917
+ ]
3918
+ },
3919
+ {
3920
+ "kind": "method",
3921
+ "name": "clearPendingRange",
3922
+ "privacy": "private"
3923
+ },
3924
+ {
3925
+ "kind": "method",
3926
+ "name": "stepDisplayDate",
3927
+ "privacy": "private",
3928
+ "parameters": [
3929
+ {
3930
+ "name": "duration",
3931
+ "type": {
3932
+ "text": "DurationLike"
3933
+ }
3934
+ }
3935
+ ]
3936
+ },
3937
+ {
3938
+ "kind": "method",
3939
+ "name": "yearOptions",
3940
+ "privacy": "private",
3941
+ "return": {
3942
+ "type": {
3943
+ "text": "number[]"
3944
+ }
3945
+ },
3946
+ "description": "Generate a list of years for the year select dropdown, newest first. With no limits, the years are from next year\nto six years ago. With `min` or `max`, the list starts or ends at their years, and always includes the year shown."
3947
+ },
3948
+ {
3949
+ "kind": "method",
3950
+ "name": "makeDate",
3951
+ "privacy": "private",
3952
+ "return": {
3953
+ "type": {
3954
+ "text": "DateTime<true> | undefined"
3955
+ }
3956
+ },
3957
+ "parameters": [
3958
+ {
3959
+ "name": "d",
3960
+ "optional": true,
3961
+ "type": {
3962
+ "text": "string"
3963
+ }
3964
+ }
3965
+ ]
3966
+ },
3967
+ {
3968
+ "kind": "method",
3969
+ "name": "makeRange",
3970
+ "privacy": "private",
3971
+ "return": {
3972
+ "type": {
3973
+ "text": "Interval<true> | undefined"
3974
+ }
3975
+ },
3976
+ "parameters": [
3977
+ {
3978
+ "name": "value",
3979
+ "optional": true,
3980
+ "type": {
3981
+ "text": "string"
3982
+ }
3983
+ }
3984
+ ],
3985
+ "description": "Parse an ISO8601 interval string. In date mode, the interval is widened to whole days in the calendar's timezone:\nthe start is rounded down to the start of its day and the end is rounded up to the start of the next day. An\ninvalid or empty interval gives `undefined`."
3986
+ },
3987
+ {
3988
+ "kind": "method",
3989
+ "name": "highlightedDays",
3990
+ "privacy": "private",
3991
+ "return": {
3992
+ "type": {
3993
+ "text": "HighlightedDays | undefined"
3994
+ }
3995
+ },
3996
+ "description": "The days to highlight in range mode: the hover preview while a range is pending, otherwise the selected range."
3997
+ },
3998
+ {
3999
+ "kind": "method",
4000
+ "name": "updateValue",
4001
+ "privacy": "private",
4002
+ "parameters": [
4003
+ {
4004
+ "name": "emitEvents",
4005
+ "default": "true"
4006
+ }
4007
+ ]
4008
+ },
4009
+ {
4010
+ "kind": "method",
4011
+ "name": "handleHeaderSelectChange",
4012
+ "privacy": "private",
4013
+ "parameters": [
4014
+ {
4015
+ "name": "ev",
4016
+ "type": {
4017
+ "text": "FlowChangeEvent"
4018
+ }
4019
+ }
4020
+ ]
4021
+ },
4022
+ {
4023
+ "kind": "method",
4024
+ "name": "handleTimeChange",
4025
+ "privacy": "private",
4026
+ "parameters": [
4027
+ {
4028
+ "name": "ev",
4029
+ "type": {
4030
+ "text": "FlowChangeEvent"
4031
+ }
4032
+ }
4033
+ ]
4034
+ },
4035
+ {
4036
+ "kind": "method",
4037
+ "name": "handleRangeTimeChange",
4038
+ "privacy": "private",
4039
+ "parameters": [
4040
+ {
4041
+ "name": "ev",
4042
+ "type": {
4043
+ "text": "FlowChangeEvent"
4044
+ }
4045
+ },
4046
+ {
4047
+ "name": "row",
4048
+ "type": {
4049
+ "text": "'start' | 'end'"
4050
+ }
4051
+ }
4052
+ ],
4053
+ "description": "Handle a change in the Start or End row of a datetime range or a time range. In a datetime range, the start time\napplies to the range start and the end time to the last day. The edited time can't pass the other one, so the range\nis never empty."
4054
+ },
3593
4055
  {
3594
4056
  "kind": "method",
3595
- "name": "dateClicked",
4057
+ "name": "calendarHeaderTemplate",
3596
4058
  "privacy": "private",
3597
4059
  "parameters": [
3598
4060
  {
3599
- "name": "val",
4061
+ "name": "month",
3600
4062
  "type": {
3601
- "text": "string"
4063
+ "text": "DateTime<true>"
4064
+ }
4065
+ },
4066
+ {
4067
+ "name": "index",
4068
+ "type": {
4069
+ "text": "number"
3602
4070
  }
3603
4071
  }
3604
- ]
4072
+ ],
4073
+ "description": "The header for the month at `index`. The first month has the month and year selects and the second month has a\nstatic label. The previous button is on the first month and the next button on the last. In the two-month view, a\nhidden button takes the place of each missing button, so the month label stays centered."
3605
4074
  },
3606
4075
  {
3607
4076
  "kind": "method",
3608
- "name": "stepDisplayDate",
4077
+ "name": "headerSelectsTemplate",
3609
4078
  "privacy": "private",
3610
4079
  "parameters": [
3611
4080
  {
3612
- "name": "duration",
4081
+ "name": "monthsShort",
3613
4082
  "type": {
3614
- "text": "DurationLike"
4083
+ "text": "string[]"
3615
4084
  }
3616
4085
  }
3617
4086
  ]
3618
4087
  },
3619
4088
  {
3620
4089
  "kind": "method",
3621
- "name": "yearOptionsForDate",
4090
+ "name": "isMonthDisabled",
3622
4091
  "privacy": "private",
3623
- "return": {
3624
- "type": {
3625
- "text": "number[]"
3626
- }
3627
- },
3628
4092
  "parameters": [
3629
4093
  {
3630
- "name": "date",
4094
+ "name": "month",
3631
4095
  "type": {
3632
- "text": "DateTime"
4096
+ "text": "number"
3633
4097
  }
3634
4098
  }
3635
4099
  ],
3636
- "description": "Generate a list of years for the year select dropdown"
4100
+ "description": "Whether a month of the year shown is outside the months the user can navigate to."
3637
4101
  },
3638
4102
  {
3639
4103
  "kind": "method",
3640
- "name": "makeDate",
4104
+ "name": "dayOfWeekGridTemplate",
4105
+ "privacy": "private"
4106
+ },
4107
+ {
4108
+ "kind": "method",
4109
+ "name": "daysForMonth",
3641
4110
  "privacy": "private",
3642
4111
  "return": {
3643
4112
  "type": {
3644
- "text": "DateTime<true> | undefined"
4113
+ "text": "CalendarDay[]"
3645
4114
  }
3646
4115
  },
3647
4116
  "parameters": [
3648
4117
  {
3649
- "name": "d",
3650
- "optional": true,
4118
+ "name": "month",
3651
4119
  "type": {
3652
- "text": "string"
4120
+ "text": "DateTime<true>"
3653
4121
  }
3654
- }
3655
- ]
3656
- },
3657
- {
3658
- "kind": "method",
3659
- "name": "updateValue",
3660
- "privacy": "private",
3661
- "parameters": [
4122
+ },
3662
4123
  {
3663
- "name": "emitEvents",
3664
- "default": "true"
4124
+ "name": "hideLeadingFiller",
4125
+ "default": "false"
4126
+ },
4127
+ {
4128
+ "name": "hideTrailingFiller",
4129
+ "default": "false"
3665
4130
  }
3666
- ]
4131
+ ],
4132
+ "description": "The days shown in the grid for a month, including the filler days from the adjacent months that complete the\nfirst and last weeks. In the two-month view, the filler days between the two months are hidden, because the other\nmonth shows them."
3667
4133
  },
3668
4134
  {
3669
4135
  "kind": "method",
3670
- "name": "handleHeaderSelectChange",
4136
+ "name": "dayGridTemplate",
3671
4137
  "privacy": "private",
3672
4138
  "parameters": [
3673
4139
  {
3674
- "name": "ev",
4140
+ "name": "month",
3675
4141
  "type": {
3676
- "text": "FlowChangeEvent"
4142
+ "text": "DateTime<true>"
4143
+ }
4144
+ },
4145
+ {
4146
+ "name": "index",
4147
+ "type": {
4148
+ "text": "number"
3677
4149
  }
3678
4150
  }
3679
4151
  ]
3680
4152
  },
3681
4153
  {
3682
4154
  "kind": "method",
3683
- "name": "handleTimeChange",
4155
+ "name": "monthTemplate",
3684
4156
  "privacy": "private",
3685
4157
  "parameters": [
3686
4158
  {
3687
- "name": "ev",
4159
+ "name": "index",
3688
4160
  "type": {
3689
- "text": "FlowChangeEvent"
4161
+ "text": "number"
3690
4162
  }
3691
4163
  }
3692
4164
  ]
3693
4165
  },
3694
4166
  {
3695
4167
  "kind": "method",
3696
- "name": "calendarHeaderTemplate",
3697
- "privacy": "private"
3698
- },
3699
- {
3700
- "kind": "method",
3701
- "name": "dayOfWeekGridTemplate",
4168
+ "name": "handleGridMouseLeave",
3702
4169
  "privacy": "private"
3703
4170
  },
3704
4171
  {
3705
4172
  "kind": "method",
3706
- "name": "dayGridTemplate",
3707
- "privacy": "private"
4173
+ "name": "timeInputsTemplate",
4174
+ "privacy": "private",
4175
+ "parameters": [
4176
+ {
4177
+ "name": "time",
4178
+ "type": {
4179
+ "text": "TimeOfDay"
4180
+ }
4181
+ },
4182
+ {
4183
+ "name": "onChange",
4184
+ "type": {
4185
+ "text": "(ev: FlowChangeEvent) => void"
4186
+ }
4187
+ },
4188
+ {
4189
+ "name": "maxHour",
4190
+ "default": "23"
4191
+ }
4192
+ ],
4193
+ "description": "The hour, minute and second inputs for `time`."
3708
4194
  },
3709
4195
  {
3710
4196
  "kind": "method",
3711
4197
  "name": "timeTemplate",
3712
- "privacy": "private"
4198
+ "privacy": "private",
4199
+ "description": "The time inputs: one row in single mode, or the Start and End rows of a datetime range or a time range. The Start\nand End rows are stacked, except in a datetime range in the two-month view."
3713
4200
  }
3714
4201
  ],
3715
4202
  "events": [
@@ -3730,7 +4217,7 @@
3730
4217
  "type": {
3731
4218
  "text": "string"
3732
4219
  },
3733
- "description": "The value of the control. (ISO8601 date/time string)",
4220
+ "description": "The value of the control. (ISO8601 date/time string) In range mode, the value is an ISO8601 interval string\n(`<start>/<end>`) and the end is exclusive. For example, the date range October 1 to October 2 has the value\n`2026-10-01T00:00:00.000+01:00/2026-10-03T00:00:00.000+01:00`.",
3734
4221
  "fieldName": "value"
3735
4222
  },
3736
4223
  {
@@ -3739,9 +4226,18 @@
3739
4226
  "text": "'date' | 'time' | 'datetime'"
3740
4227
  },
3741
4228
  "default": "'date'",
3742
- "description": "Select whether to show date only, time only or both date and time.",
4229
+ "description": "The display mode: date only, time only, or both date and time.",
3743
4230
  "fieldName": "displayMode"
3744
4231
  },
4232
+ {
4233
+ "name": "range",
4234
+ "type": {
4235
+ "text": "boolean"
4236
+ },
4237
+ "default": "false",
4238
+ "description": "Set to `true` to select a date, datetime or time range instead of a single value, depending on `display-mode`.",
4239
+ "fieldName": "range"
4240
+ },
3745
4241
  {
3746
4242
  "name": "timezone",
3747
4243
  "type": {
@@ -3766,6 +4262,39 @@
3766
4262
  "default": "'medium'",
3767
4263
  "description": "Set the size of the calendar.",
3768
4264
  "fieldName": "size"
4265
+ },
4266
+ {
4267
+ "name": "months",
4268
+ "type": {
4269
+ "text": "1 | 2"
4270
+ },
4271
+ "default": "1",
4272
+ "description": "The number of months to show side by side.",
4273
+ "fieldName": "months"
4274
+ },
4275
+ {
4276
+ "name": "min",
4277
+ "type": {
4278
+ "text": "string | undefined"
4279
+ },
4280
+ "description": "The earliest date that can be selected. (ISO8601 date or date/time string) Note that `min` is ignored when\n`display-mode` is `time`.",
4281
+ "fieldName": "min"
4282
+ },
4283
+ {
4284
+ "name": "max",
4285
+ "type": {
4286
+ "text": "string | undefined"
4287
+ },
4288
+ "description": "The latest date that can be selected. (ISO8601 date or date/time string) Note that `max` is ignored when\n`display-mode` is `time`.",
4289
+ "fieldName": "max"
4290
+ },
4291
+ {
4292
+ "name": "max-range",
4293
+ "type": {
4294
+ "text": "string | undefined"
4295
+ },
4296
+ "description": "The maximum length of a range. (Duration string, e.g. `'7 days'` or `'1 month'`) Supported units are milliseconds,\nseconds, minutes, hours, days, weeks and months.",
4297
+ "fieldName": "maxRange"
3769
4298
  }
3770
4299
  ],
3771
4300
  "superclass": {
@@ -3773,7 +4302,7 @@
3773
4302
  "module": "/src/internal/flow-ui-rdf-element"
3774
4303
  },
3775
4304
  "tagName": "flow-ui-calendar",
3776
- "summary": "A calendar component for selecting dates and times.",
4305
+ "summary": "Calendars allow users to select a date, time or date range.",
3777
4306
  "dependencies": [
3778
4307
  "flow-ui-icon-button",
3779
4308
  "flow-ui-input",
@@ -7669,7 +8198,7 @@
7669
8198
  "declarations": [
7670
8199
  {
7671
8200
  "kind": "class",
7672
- "description": "",
8201
+ "description": "The date time picker component displays its value in a text field and opens a [calendar](./flow-ui-calendar) in a\npopup to change it.\n\nSet `range` to select a date, datetime or time range instead of a single value, depending on `display-mode`.\n\nUse `min`, `max` and `max-range` to restrict the dates that can be selected. Note that a value outside these limits\nis not changed, but fails validation.",
7673
8202
  "name": "FlowUiDateTimePicker",
7674
8203
  "cssParts": [
7675
8204
  {
@@ -7816,7 +8345,7 @@
7816
8345
  "text": "string"
7817
8346
  },
7818
8347
  "default": "''",
7819
- "description": "The current value of the date/time picker. (ISO8601 date/time string)",
8348
+ "description": "The current value of the date/time picker. (ISO8601 date/time string) In range mode, the value is an ISO8601\ninterval string (`<start>/<end>`) and the end is exclusive. For example, the date range October 1 to October 2 has\nthe value `2026-10-01T00:00:00.000+01:00/2026-10-03T00:00:00.000+01:00`.",
7820
8349
  "attribute": "value",
7821
8350
  "reflects": true
7822
8351
  },
@@ -7827,17 +8356,36 @@
7827
8356
  "text": "'date' | 'time' | 'datetime'"
7828
8357
  },
7829
8358
  "default": "'datetime'",
7830
- "description": "Select whether to show date only, time only or both date and time.",
8359
+ "description": "The display mode: date only, time only, or both date and time.",
7831
8360
  "attribute": "display-mode"
7832
8361
  },
8362
+ {
8363
+ "kind": "field",
8364
+ "name": "range",
8365
+ "type": {
8366
+ "text": "boolean"
8367
+ },
8368
+ "default": "false",
8369
+ "description": "Set to `true` to select a date, datetime or time range instead of a single value, depending on `display-mode`.",
8370
+ "attribute": "range",
8371
+ "reflects": true
8372
+ },
8373
+ {
8374
+ "kind": "field",
8375
+ "name": "_format",
8376
+ "type": {
8377
+ "text": "string | undefined"
8378
+ },
8379
+ "privacy": "private",
8380
+ "description": "The format set by the user, if any. The default format depends on `display-mode`, so it is not stored here."
8381
+ },
7833
8382
  {
7834
8383
  "kind": "field",
7835
8384
  "name": "format",
7836
8385
  "type": {
7837
8386
  "text": "string"
7838
8387
  },
7839
- "default": "'FFF'",
7840
- "description": "Specify the display format using a [Luxon format string](https://moment.github.io/luxon/#/formatting?id=table-of-tokens).",
8388
+ "description": "The format to use for display as a\n[Luxon format string](https://moment.github.io/luxon/#/formatting?id=table-of-tokens). If not set, the format\ndepends on `display-mode` (`'DD'` for `date`, `'HH:mm'` for `time` and `'FFF'` for `datetime`).",
7841
8389
  "attribute": "format"
7842
8390
  },
7843
8391
  {
@@ -7878,6 +8426,43 @@
7878
8426
  "attribute": "size",
7879
8427
  "reflects": true
7880
8428
  },
8429
+ {
8430
+ "kind": "field",
8431
+ "name": "months",
8432
+ "type": {
8433
+ "text": "1 | 2"
8434
+ },
8435
+ "default": "1",
8436
+ "description": "The number of months to show side by side in the calendar.",
8437
+ "attribute": "months"
8438
+ },
8439
+ {
8440
+ "kind": "field",
8441
+ "name": "min",
8442
+ "type": {
8443
+ "text": "string | undefined"
8444
+ },
8445
+ "description": "The earliest date that can be selected. (ISO8601 date or date/time string) Note that `min` is ignored when\n`display-mode` is `time`.",
8446
+ "attribute": "min"
8447
+ },
8448
+ {
8449
+ "kind": "field",
8450
+ "name": "max",
8451
+ "type": {
8452
+ "text": "string | undefined"
8453
+ },
8454
+ "description": "The latest date that can be selected. (ISO8601 date or date/time string) Note that `max` is ignored when\n`display-mode` is `time`.",
8455
+ "attribute": "max"
8456
+ },
8457
+ {
8458
+ "kind": "field",
8459
+ "name": "maxRange",
8460
+ "type": {
8461
+ "text": "string | undefined"
8462
+ },
8463
+ "description": "The maximum length of a range. (Duration string, e.g. `'7 days'` or `'1 month'`) Supported units are milliseconds,\nseconds, minutes, hours, days, weeks and months.",
8464
+ "attribute": "max-range"
8465
+ },
7881
8466
  {
7882
8467
  "kind": "field",
7883
8468
  "name": "placeholder",
@@ -8027,6 +8612,16 @@
8027
8612
  "attribute": "divider",
8028
8613
  "reflects": true
8029
8614
  },
8615
+ {
8616
+ "kind": "field",
8617
+ "name": "customValidityMessage",
8618
+ "type": {
8619
+ "text": "string"
8620
+ },
8621
+ "privacy": "private",
8622
+ "default": "''",
8623
+ "description": "The message set with `setCustomValidity()`. It takes precedence over the limits messages."
8624
+ },
8030
8625
  {
8031
8626
  "kind": "field",
8032
8627
  "name": "validity",
@@ -8049,6 +8644,35 @@
8049
8644
  "name": "removeOpenListeners",
8050
8645
  "privacy": "private"
8051
8646
  },
8647
+ {
8648
+ "kind": "field",
8649
+ "name": "isRangeMode",
8650
+ "privacy": "private",
8651
+ "description": "Whether the picker selects a range: a date range, a datetime range or a time range.",
8652
+ "readonly": true
8653
+ },
8654
+ {
8655
+ "kind": "method",
8656
+ "name": "rangeLabel",
8657
+ "privacy": "private",
8658
+ "parameters": [
8659
+ {
8660
+ "name": "zone",
8661
+ "optional": true,
8662
+ "type": {
8663
+ "text": "string"
8664
+ }
8665
+ },
8666
+ {
8667
+ "name": "locale",
8668
+ "optional": true,
8669
+ "type": {
8670
+ "text": "string"
8671
+ }
8672
+ }
8673
+ ],
8674
+ "description": "The label for a range. For a date range, it shows the range start and the last day, both included, and a range of\none day shows that day once. For a datetime range, it shows the start and end instants. For a time range, it shows\nthe start and end times, with an end at the end of the day shown as 24:00. An invalid range shows an empty label,\nas the calendar shows no selection."
8675
+ },
8052
8676
  {
8053
8677
  "kind": "method",
8054
8678
  "name": "handleFocus",
@@ -8155,6 +8779,19 @@
8155
8779
  }
8156
8780
  ]
8157
8781
  },
8782
+ {
8783
+ "kind": "method",
8784
+ "name": "handleCalendarInput",
8785
+ "privacy": "private",
8786
+ "parameters": [
8787
+ {
8788
+ "name": "event",
8789
+ "type": {
8790
+ "text": "Event"
8791
+ }
8792
+ }
8793
+ ]
8794
+ },
8158
8795
  {
8159
8796
  "kind": "method",
8160
8797
  "name": "handleCalendarChange",
@@ -8224,6 +8861,23 @@
8224
8861
  ],
8225
8862
  "description": "Sets a custom validation message. Pass an empty string to restore validity."
8226
8863
  },
8864
+ {
8865
+ "kind": "method",
8866
+ "name": "updateCustomValidity",
8867
+ "privacy": "private",
8868
+ "description": "Set the value input's custom validity: the message from `setCustomValidity()`, or a limits message."
8869
+ },
8870
+ {
8871
+ "kind": "method",
8872
+ "name": "limitsValidityMessage",
8873
+ "privacy": "private",
8874
+ "return": {
8875
+ "type": {
8876
+ "text": "string"
8877
+ }
8878
+ },
8879
+ "description": "The validation message for a value outside `min`, `max` or `max-range`, or an empty string."
8880
+ },
8227
8881
  {
8228
8882
  "kind": "method",
8229
8883
  "name": "focus",
@@ -8312,7 +8966,7 @@
8312
8966
  "text": "string"
8313
8967
  },
8314
8968
  "default": "''",
8315
- "description": "The current value of the date/time picker. (ISO8601 date/time string)",
8969
+ "description": "The current value of the date/time picker. (ISO8601 date/time string) In range mode, the value is an ISO8601\ninterval string (`<start>/<end>`) and the end is exclusive. For example, the date range October 1 to October 2 has\nthe value `2026-10-01T00:00:00.000+01:00/2026-10-03T00:00:00.000+01:00`.",
8316
8970
  "fieldName": "value"
8317
8971
  },
8318
8972
  {
@@ -8321,16 +8975,24 @@
8321
8975
  "text": "'date' | 'time' | 'datetime'"
8322
8976
  },
8323
8977
  "default": "'datetime'",
8324
- "description": "Select whether to show date only, time only or both date and time.",
8978
+ "description": "The display mode: date only, time only, or both date and time.",
8325
8979
  "fieldName": "displayMode"
8326
8980
  },
8981
+ {
8982
+ "name": "range",
8983
+ "type": {
8984
+ "text": "boolean"
8985
+ },
8986
+ "default": "false",
8987
+ "description": "Set to `true` to select a date, datetime or time range instead of a single value, depending on `display-mode`.",
8988
+ "fieldName": "range"
8989
+ },
8327
8990
  {
8328
8991
  "name": "format",
8329
8992
  "type": {
8330
8993
  "text": "string"
8331
8994
  },
8332
- "default": "'FFF'",
8333
- "description": "Specify the display format using a [Luxon format string](https://moment.github.io/luxon/#/formatting?id=table-of-tokens).",
8995
+ "description": "The format to use for display as a\n[Luxon format string](https://moment.github.io/luxon/#/formatting?id=table-of-tokens). If not set, the format\ndepends on `display-mode` (`'DD'` for `date`, `'HH:mm'` for `time` and `'FFF'` for `datetime`).",
8334
8996
  "fieldName": "format"
8335
8997
  },
8336
8998
  {
@@ -8358,6 +9020,39 @@
8358
9020
  "description": "The date/time picker's size.",
8359
9021
  "fieldName": "size"
8360
9022
  },
9023
+ {
9024
+ "name": "months",
9025
+ "type": {
9026
+ "text": "1 | 2"
9027
+ },
9028
+ "default": "1",
9029
+ "description": "The number of months to show side by side in the calendar.",
9030
+ "fieldName": "months"
9031
+ },
9032
+ {
9033
+ "name": "min",
9034
+ "type": {
9035
+ "text": "string | undefined"
9036
+ },
9037
+ "description": "The earliest date that can be selected. (ISO8601 date or date/time string) Note that `min` is ignored when\n`display-mode` is `time`.",
9038
+ "fieldName": "min"
9039
+ },
9040
+ {
9041
+ "name": "max",
9042
+ "type": {
9043
+ "text": "string | undefined"
9044
+ },
9045
+ "description": "The latest date that can be selected. (ISO8601 date or date/time string) Note that `max` is ignored when\n`display-mode` is `time`.",
9046
+ "fieldName": "max"
9047
+ },
9048
+ {
9049
+ "name": "max-range",
9050
+ "type": {
9051
+ "text": "string | undefined"
9052
+ },
9053
+ "description": "The maximum length of a range. (Duration string, e.g. `'7 days'` or `'1 month'`) Supported units are milliseconds,\nseconds, minutes, hours, days, weeks and months.",
9054
+ "fieldName": "maxRange"
9055
+ },
8361
9056
  {
8362
9057
  "name": "placeholder",
8363
9058
  "type": {
@@ -8490,7 +9185,7 @@
8490
9185
  "module": "/src/internal/flow-ui-rdf-element"
8491
9186
  },
8492
9187
  "tagName": "flow-ui-date-time-picker",
8493
- "summary": "Date time pickers allow users to select a date and time from a calendar and clock interface.",
9188
+ "summary": "Date time pickers allow users to select a date and time, or a date range, from a calendar.",
8494
9189
  "dependencies": [
8495
9190
  "flow-ui-icon",
8496
9191
  "flow-ui-popup",
@@ -25922,6 +26617,6 @@
25922
26617
  ],
25923
26618
  "package": {
25924
26619
  "name": "@emuanalytics/flow-rdf-ui",
25925
- "version": "4.1.28"
26620
+ "version": "4.2.1"
25926
26621
  }
25927
26622
  }