@fusion.dev/helix 0.159.0 → 0.160.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -42941,6 +42941,20 @@
42941
42941
  "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
42942
42942
  }
42943
42943
  },
42944
+ {
42945
+ "kind": "field",
42946
+ "name": "touched",
42947
+ "type": {
42948
+ "text": "boolean"
42949
+ },
42950
+ "privacy": "private",
42951
+ "default": "false",
42952
+ "description": "Whether the reader has committed an answer, or a form has refused the\npicker. A reset forgets it.",
42953
+ "inheritedFrom": {
42954
+ "name": "MixinPickerFeedback",
42955
+ "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
42956
+ }
42957
+ },
42944
42958
  {
42945
42959
  "kind": "field",
42946
42960
  "name": "marked",
@@ -42948,13 +42962,44 @@
42948
42962
  "text": "boolean"
42949
42963
  },
42950
42964
  "privacy": "protected",
42951
- "description": "Whether a reader is told the answer is wrong: `invalid`, or `feedback`.",
42965
+ "description": "Whether a reader is told the answer is wrong: `invalid`, `feedback`, a\nheld answer the picker refuses, or a missing answer once the reader has\ncommitted one or a form has refused the picker.\n\n**A refused answer is marked at once, and a missing one waits**, as\nChromium's tree does for native controls: a time input holding a time\npast its `max` reports invalid on load, and an empty required text field\ndoes not, since the reader already hears that it is required. Measured\nbefore this on Time Picker: `value=\"13:00\" max=\"12:00\"` reported\n`rangeOverflow` while the list said nothing and `:state(invalid)` was off.",
42966
+ "readonly": true,
42967
+ "inheritedFrom": {
42968
+ "name": "MixinPickerFeedback",
42969
+ "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
42970
+ }
42971
+ },
42972
+ {
42973
+ "kind": "field",
42974
+ "name": "failure",
42975
+ "type": {
42976
+ "text": "'missing' | 'refused' | undefined"
42977
+ },
42978
+ "privacy": "protected",
42979
+ "description": "What the picker's own validation finds: `missing`, `refused`, or\nnothing, which is what a picker that does not answer it reports.",
42952
42980
  "readonly": true,
42953
42981
  "inheritedFrom": {
42954
42982
  "name": "MixinPickerFeedback",
42955
42983
  "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
42956
42984
  }
42957
42985
  },
42986
+ {
42987
+ "kind": "method",
42988
+ "name": "formResetCallback",
42989
+ "return": {
42990
+ "type": {
42991
+ "text": "void"
42992
+ }
42993
+ },
42994
+ "description": "Returns the control to its `defaultValue`, or to its `value` attribute\nwhere there is no `default-value`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value.",
42995
+ "inheritedFrom": {
42996
+ "name": "HelixFormElement",
42997
+ "module": "src/helix-form-element/helix-form-element.ts"
42998
+ },
42999
+ "type": {
43000
+ "text": "formResetCallback() => void"
43001
+ }
43002
+ },
42958
43003
  {
42959
43004
  "kind": "method",
42960
43005
  "name": "renderPickerFeedback",
@@ -43080,23 +43125,6 @@
43080
43125
  "module": "src/mixins/mixin-controller-value/mixin-controller-value.ts"
43081
43126
  }
43082
43127
  },
43083
- {
43084
- "kind": "method",
43085
- "name": "formResetCallback",
43086
- "return": {
43087
- "type": {
43088
- "text": "void"
43089
- }
43090
- },
43091
- "description": "Returns the control to its `defaultValue`, or to its `value` attribute\nwhere there is no `default-value`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value.",
43092
- "inheritedFrom": {
43093
- "name": "HelixFormElement",
43094
- "module": "src/helix-form-element/helix-form-element.ts"
43095
- },
43096
- "type": {
43097
- "text": "formResetCallback() => void"
43098
- }
43099
- },
43100
43128
  {
43101
43129
  "kind": "method",
43102
43130
  "name": "formStateRestoreCallback",
@@ -59418,6 +59446,40 @@
59418
59446
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59419
59447
  }
59420
59448
  },
59449
+ {
59450
+ "kind": "field",
59451
+ "name": "rangeEndLabel",
59452
+ "type": {
59453
+ "text": "string"
59454
+ },
59455
+ "default": "'End'",
59456
+ "description": "What a screen reader hears before the segments of a range's second date\nor time, after each segment's own name.",
59457
+ "attribute": "range-end-label",
59458
+ "helix": {
59459
+ "words": true
59460
+ },
59461
+ "inheritedFrom": {
59462
+ "name": "MixinSegmentedField",
59463
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59464
+ }
59465
+ },
59466
+ {
59467
+ "kind": "field",
59468
+ "name": "rangeStartLabel",
59469
+ "type": {
59470
+ "text": "string"
59471
+ },
59472
+ "default": "'Start'",
59473
+ "description": "What a screen reader hears before the segments of a range's first date\nor time, after each segment's own name: \"month, Start, Stay\".",
59474
+ "attribute": "range-start-label",
59475
+ "helix": {
59476
+ "words": true
59477
+ },
59478
+ "inheritedFrom": {
59479
+ "name": "MixinSegmentedField",
59480
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59481
+ }
59482
+ },
59421
59483
  {
59422
59484
  "kind": "field",
59423
59485
  "name": "segmented",
@@ -59436,11 +59498,11 @@
59436
59498
  "kind": "field",
59437
59499
  "name": "parts",
59438
59500
  "type": {
59439
- "text": "Segments"
59501
+ "text": "Segments[]"
59440
59502
  },
59441
59503
  "privacy": "private",
59442
- "default": "{}",
59443
- "description": "The parts set so far, which may be fewer than a whole value.",
59504
+ "default": "[{}]",
59505
+ "description": "The parts set so far in each row, which may be fewer than a whole\nvalue: one row, or two for a range.",
59444
59506
  "inheritedFrom": {
59445
59507
  "name": "MixinSegmentedField",
59446
59508
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
@@ -59499,6 +59561,35 @@
59499
59561
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59500
59562
  }
59501
59563
  },
59564
+ {
59565
+ "kind": "field",
59566
+ "name": "opener",
59567
+ "type": {
59568
+ "text": "HTMLElement | undefined"
59569
+ },
59570
+ "privacy": "private",
59571
+ "default": "undefined",
59572
+ "description": "The segment Alt+Down opened the picker from, which focus goes back to.",
59573
+ "inheritedFrom": {
59574
+ "name": "MixinSegmentedField",
59575
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59576
+ }
59577
+ },
59578
+ {
59579
+ "kind": "method",
59580
+ "name": "returnFocus",
59581
+ "privacy": "protected",
59582
+ "return": {
59583
+ "type": {
59584
+ "text": "void"
59585
+ }
59586
+ },
59587
+ "description": "Puts focus back on the segment the picker was opened from, as the\ntrigger takes it back to the field. Measured before this: Escape after\nAlt+Down on AM/PM put focus on the hour.",
59588
+ "inheritedFrom": {
59589
+ "name": "MixinPickerField",
59590
+ "module": "src/mixins/mixin-picker-field/mixin-picker-field.ts"
59591
+ }
59592
+ },
59502
59593
  {
59503
59594
  "kind": "field",
59504
59595
  "name": "segmentable",
@@ -59527,6 +59618,66 @@
59527
59618
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59528
59619
  }
59529
59620
  },
59621
+ {
59622
+ "kind": "field",
59623
+ "name": "segmentGroups",
59624
+ "type": {
59625
+ "text": "number"
59626
+ },
59627
+ "privacy": "protected",
59628
+ "description": "How many rows of segments the value takes: two for a range, one otherwise.",
59629
+ "readonly": true,
59630
+ "inheritedFrom": {
59631
+ "name": "MixinSegmentedField",
59632
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59633
+ }
59634
+ },
59635
+ {
59636
+ "kind": "method",
59637
+ "name": "joined",
59638
+ "privacy": "private",
59639
+ "return": {
59640
+ "type": {
59641
+ "text": "string"
59642
+ }
59643
+ },
59644
+ "parameters": [
59645
+ {
59646
+ "name": "rows",
59647
+ "type": {
59648
+ "text": "readonly Segments[]"
59649
+ }
59650
+ }
59651
+ ],
59652
+ "description": "The value the rows add up to: each row's, joined by commas, or empty while any row is not whole.",
59653
+ "inheritedFrom": {
59654
+ "name": "MixinSegmentedField",
59655
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59656
+ }
59657
+ },
59658
+ {
59659
+ "kind": "method",
59660
+ "name": "rowsOf",
59661
+ "privacy": "private",
59662
+ "return": {
59663
+ "type": {
59664
+ "text": "Segments[]"
59665
+ }
59666
+ },
59667
+ "parameters": [
59668
+ {
59669
+ "name": "value",
59670
+ "type": {
59671
+ "text": "string"
59672
+ }
59673
+ }
59674
+ ],
59675
+ "description": "The rows a value names, one per row, empty where it names none.",
59676
+ "inheritedFrom": {
59677
+ "name": "MixinSegmentedField",
59678
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59679
+ }
59680
+ },
59530
59681
  {
59531
59682
  "kind": "field",
59532
59683
  "name": "segmentedKind",
@@ -59569,6 +59720,20 @@
59569
59720
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59570
59721
  }
59571
59722
  },
59723
+ {
59724
+ "kind": "field",
59725
+ "name": "segmentSystem",
59726
+ "type": {
59727
+ "text": "MonthSystem | undefined"
59728
+ },
59729
+ "privacy": "protected",
59730
+ "description": "The calendar a date's parts are counted in, or `undefined` for the Gregorian calendar.",
59731
+ "readonly": true,
59732
+ "inheritedFrom": {
59733
+ "name": "MixinSegmentedField",
59734
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
59735
+ }
59736
+ },
59572
59737
  {
59573
59738
  "kind": "field",
59574
59739
  "name": "layout",
@@ -59634,6 +59799,12 @@
59634
59799
  }
59635
59800
  },
59636
59801
  "parameters": [
59802
+ {
59803
+ "name": "row",
59804
+ "type": {
59805
+ "text": "number"
59806
+ }
59807
+ },
59637
59808
  {
59638
59809
  "name": "next",
59639
59810
  "type": {
@@ -60137,21 +60308,6 @@
60137
60308
  "module": "src/mixins/mixin-picker-field/mixin-picker-field.ts"
60138
60309
  }
60139
60310
  },
60140
- {
60141
- "kind": "method",
60142
- "name": "returnFocus",
60143
- "privacy": "protected",
60144
- "return": {
60145
- "type": {
60146
- "text": "void"
60147
- }
60148
- },
60149
- "description": "Puts the caret back in the field without the field reopening the panel.\n\nThe anchor rather than the text, which is the trigger where there is no\ntext: Color Input's swatch dropped focus to the body on Escape.",
60150
- "inheritedFrom": {
60151
- "name": "MixinPickerField",
60152
- "module": "src/mixins/mixin-picker-field/mixin-picker-field.ts"
60153
- }
60154
- },
60155
60311
  {
60156
60312
  "kind": "method",
60157
60313
  "name": "focus",
@@ -61049,7 +61205,7 @@
61049
61205
  "text": "string"
61050
61206
  },
61051
61207
  "default": "''",
61052
- "description": "What the browser may autofill here, as one of the platform's own tokens.\n\nEmpty leaves the attribute off, which is the browser's default and is what\nlets autofill work at all: hardcoding `off` here means a birthday or a\npostal code can never be filled in for a reader.",
61208
+ "description": "What the browser may autofill here, as one of the platform's own tokens,\nsuch as `bday`.\n\nEmpty leaves the attribute off, which is the browser's default and is what\nlets autofill work at all: hardcoding `off` here means a birthday or a\npostal code can never be filled in for a reader. With `segmented`, a\nhidden native date input carries it, since no browser fills the segments.",
61053
61209
  "attribute": "autocomplete",
61054
61210
  "inheritedFrom": {
61055
61211
  "name": "HelixHeadlessDateInput",
@@ -61060,9 +61216,9 @@
61060
61216
  "kind": "field",
61061
61217
  "name": "calendar",
61062
61218
  "type": {
61063
- "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | undefined"
61219
+ "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'chinese' | 'coptic' | 'dangi' | 'ethioaa' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic' | 'islamic-civil' | 'islamic-rgsa' | 'islamic-tbla' | 'islamic-umalqura' | 'persian' | undefined"
61064
61220
  },
61065
- "description": "The calendar the written date and the calendar's days are in: `gregory`,\n`buddhist`, `japanese`, `roc`, or `iso8601`.\n\nAbsent is the locale's own where it is one of the five, and `gregory` for\nevery other, as Date Picker's `calendar` is. The value is `YYYY-MM-DD` in\nevery calendar, and a focused field is ISO in every calendar. In\n`segmented`, the segments are the Gregorian day, month, and year, in the\norder the locale writes them, or ISO order for `iso8601`.",
61221
+ "description": "The calendar the written date, the segments, and the calendar's days are\nin: `gregory`, `buddhist`, `japanese`, `roc`, or `iso8601`, or a calendar\nwith months of its own that Date Picker's `calendar` names, such as\n`persian`, `hebrew`, `islamic-umalqura`, `ethiopic`, or `chinese`.\n\nAbsent is the locale's own where its months are the Gregorian months, and\n`gregory` for every other, as Date Picker's `calendar` is. The value is\n`YYYY-MM-DD` in every calendar, and a focused text field is ISO in every\ncalendar. In `segmented`, the segments are the day, month, and year as\nthe calendar counts them, in the order the locale writes them: Mehr 14,\n1405 is month 7 and day 14 of 1405 under `persian`. Under the five with\nGregorian months they are the Gregorian day, month, and year, or ISO order\nfor `iso8601`.",
61066
61222
  "attribute": "calendar",
61067
61223
  "inheritedFrom": {
61068
61224
  "name": "HelixHeadlessDateInput",
@@ -61086,6 +61242,37 @@
61086
61242
  "module": "src/date-input/root/date-input-root.ts"
61087
61243
  }
61088
61244
  },
61245
+ {
61246
+ "kind": "field",
61247
+ "name": "clearable",
61248
+ "type": {
61249
+ "text": "boolean"
61250
+ },
61251
+ "default": "false",
61252
+ "description": "Whether the field shows a button that empties it, as Input's `clearable`\ndoes. Shown only while the field holds something to clear and is neither\ndisabled nor read-only.",
61253
+ "attribute": "clearable",
61254
+ "inheritedFrom": {
61255
+ "name": "HelixHeadlessDateInput",
61256
+ "module": "src/date-input/root/date-input-root.ts"
61257
+ }
61258
+ },
61259
+ {
61260
+ "kind": "field",
61261
+ "name": "clearLabel",
61262
+ "type": {
61263
+ "text": "string"
61264
+ },
61265
+ "default": "'Clear'",
61266
+ "description": "The accessible name of the clear button, which shows only an icon.",
61267
+ "attribute": "clear-label",
61268
+ "helix": {
61269
+ "words": true
61270
+ },
61271
+ "inheritedFrom": {
61272
+ "name": "HelixHeadlessDateInput",
61273
+ "module": "src/date-input/root/date-input-root.ts"
61274
+ }
61275
+ },
61089
61276
  {
61090
61277
  "kind": "field",
61091
61278
  "name": "dateStyle",
@@ -61093,7 +61280,7 @@
61093
61280
  "text": "'full' | 'iso' | 'long' | 'medium' | 'short'"
61094
61281
  },
61095
61282
  "default": "'long'",
61096
- "description": "How a date is written in the field: `short` through `full`, or ISO.\n\n**The field renders when it is idle and holds the value when it is being\nedited.** A written date is a rendering, and a document being edited must\nnot be a rendering of something else: `Intl.DateTimeFormat` formats and does\nnot parse, so `4 August 2026` cannot be typed back, and writing a parser per\nlocale is how a field ends up rejecting what it just displayed.\n\nThe way out is not to choose between the two but to separate them in time.\nIdle, the field shows `4 August 2026`, which is what a date is for reading.\nFocused, it shows `2026-08-04`, which is what a date is for typing, and it\ngoes back on the way out. Nothing parses a rendering, and nothing is\nread-only, which is what an earlier version of this settled for.\n\nA range is the exception that needs no swap: the dash between its two dates\nis a separator this element understands, so that much reads back either way.\n\n`iso` turns the rendering off, for a field whose reader is entering data\nrather than reading it, or where the ISO form is itself the point.\n\nThe value is always `YYYY-MM-DD` regardless, because that is what a form\nsubmits and what `min` and `max` compare against.",
61283
+ "description": "How a date is written in the field: `short` through `full`, or ISO.\n\n**The field renders when it is idle and holds the value when it is being\nedited.** A written date is a rendering, and a document being edited must\nnot be a rendering of something else: `Intl.DateTimeFormat` formats and does\nnot parse, so a rendering such as `Tuesday, August 4, 2026` is no text to\nedit. The field does read a date typed in the locale's order and digits as\nyou leave it, which covers what a reader types.\n\nThe way out is not to choose between the two but to separate them in time.\nIdle, the field shows `4 August 2026`, which is what a date is for reading.\nFocused, it shows `2026-08-04`, which is what a date is for typing, and it\ngoes back on the way out. Nothing parses a rendering, and nothing is\nread-only, which is what an earlier version of this settled for.\n\nA range is the exception that needs no swap: the dash between its two dates\nis a separator this element understands, so that much reads back either way.\n\n`iso` turns the rendering off, for a field whose reader is entering data\nrather than reading it, or where the ISO form is itself the point.\n\nThe value is always `YYYY-MM-DD` regardless, because that is what a form\nsubmits and what `min` and `max` compare against.",
61097
61284
  "attribute": "date-style",
61098
61285
  "inheritedFrom": {
61099
61286
  "name": "HelixHeadlessDateInput",
@@ -61494,6 +61681,23 @@
61494
61681
  "module": "src/date-input/root/date-input-root.ts"
61495
61682
  }
61496
61683
  },
61684
+ {
61685
+ "kind": "field",
61686
+ "name": "selectionLabel",
61687
+ "type": {
61688
+ "text": "string"
61689
+ },
61690
+ "default": "'{kind, select, date {Selected date: {start}} start {Range starts {start}. Choose the day it ends.} range {Selected range: {start} to {end}} other {{count, plural, one {# date selected} other {# dates selected}}}}'",
61691
+ "description": "What a screen reader hears about the dates chosen in the calendar, with\n`{kind}`, `{start}`, `{end}` and `{count}` filled in as Date Picker's\n`selection-label` says.",
61692
+ "attribute": "selection-label",
61693
+ "helix": {
61694
+ "words": true
61695
+ },
61696
+ "inheritedFrom": {
61697
+ "name": "HelixHeadlessDateInput",
61698
+ "module": "src/date-input/root/date-input-root.ts"
61699
+ }
61700
+ },
61497
61701
  {
61498
61702
  "kind": "field",
61499
61703
  "name": "step",
@@ -61525,6 +61729,20 @@
61525
61729
  "module": "src/date-input/root/date-input-root.ts"
61526
61730
  }
61527
61731
  },
61732
+ {
61733
+ "kind": "field",
61734
+ "name": "timeZone",
61735
+ "type": {
61736
+ "text": "string"
61737
+ },
61738
+ "default": "''",
61739
+ "description": "The time zone today is read in, such as `America/New_York`, handed to the\ncalendar: the day marked today, and the month an empty field opens on.\nEmpty is the reader's own. Dates are plain `YYYY-MM-DD` and carry no zone.",
61740
+ "attribute": "time-zone",
61741
+ "inheritedFrom": {
61742
+ "name": "HelixHeadlessDateInput",
61743
+ "module": "src/date-input/root/date-input-root.ts"
61744
+ }
61745
+ },
61528
61746
  {
61529
61747
  "kind": "field",
61530
61748
  "name": "triggerLabel",
@@ -61604,6 +61822,40 @@
61604
61822
  "module": "src/date-input/root/date-input-root.ts"
61605
61823
  }
61606
61824
  },
61825
+ {
61826
+ "kind": "method",
61827
+ "name": "read",
61828
+ "privacy": "private",
61829
+ "return": {
61830
+ "type": {
61831
+ "text": "string"
61832
+ }
61833
+ },
61834
+ "parameters": [
61835
+ {
61836
+ "name": "text",
61837
+ "type": {
61838
+ "text": "string"
61839
+ }
61840
+ }
61841
+ ],
61842
+ "description": "A date as the reader wrote it, as `YYYY-MM-DD`: ISO as it is, and the\norder, the digits, and the month names of the field's locale and calendar\nread back, so `8/4/2026` in `en-US` is August 4, 2026. Empty where it is\nno date.",
61843
+ "inheritedFrom": {
61844
+ "name": "HelixHeadlessDateInput",
61845
+ "module": "src/date-input/root/date-input-root.ts"
61846
+ }
61847
+ },
61848
+ {
61849
+ "kind": "field",
61850
+ "name": "handleTextCommit",
61851
+ "privacy": "private",
61852
+ "readonly": true,
61853
+ "description": "The text the reader leaves, read in the field's locale: a date written as\nthe locale writes one becomes the value, as ISO, when the field commits.\nNot on each key, where `8/4/202` is a date in the year 202 and taking it\nwould move the caret mid-year.",
61854
+ "inheritedFrom": {
61855
+ "name": "HelixHeadlessDateInput",
61856
+ "module": "src/date-input/root/date-input-root.ts"
61857
+ }
61858
+ },
61607
61859
  {
61608
61860
  "kind": "field",
61609
61861
  "name": "handleDraftKey",
@@ -61681,6 +61933,23 @@
61681
61933
  "module": "src/date-input/root/date-input-root.ts"
61682
61934
  }
61683
61935
  },
61936
+ {
61937
+ "kind": "field",
61938
+ "name": "unreadableMessage",
61939
+ "type": {
61940
+ "text": "string"
61941
+ },
61942
+ "default": "'{mode, select, single {Enter a date as YYYY-MM-DD.} other {Enter dates as YYYY-MM-DD, separated by commas.}}'",
61943
+ "description": "The message for text that is no date, where `bad-input-message` is not\nset. `{mode}` is `single`, `range`, or `multiple`.",
61944
+ "attribute": "unreadable-message",
61945
+ "helix": {
61946
+ "words": true
61947
+ },
61948
+ "inheritedFrom": {
61949
+ "name": "HelixHeadlessDateInput",
61950
+ "module": "src/date-input/root/date-input-root.ts"
61951
+ }
61952
+ },
61684
61953
  {
61685
61954
  "kind": "field",
61686
61955
  "name": "yearViewLabel",
@@ -61784,6 +62053,71 @@
61784
62053
  "module": "src/date-input/root/date-input-root.ts"
61785
62054
  }
61786
62055
  },
62056
+ {
62057
+ "kind": "method",
62058
+ "name": "renderAutofill",
62059
+ "privacy": "private",
62060
+ "return": {
62061
+ "type": {
62062
+ "text": "TemplateResult | typeof nothing"
62063
+ }
62064
+ },
62065
+ "description": "A native date input a browser's autofill can fill, where the field shows\nsegments: a row of spans that no browser fills. React Aria's\n`HiddenDateInput` is the same answer for its segmented field.\n\nDrawn and never seen, a pixel and see-through, as Select's hidden select\nis, since Safari skips a field that is `display: none`. `aria-hidden` and\nout of the tab order, and in this shadow root, so the form still takes\nthe value once, from the host. A fill is taken as a pick, with `input`\nand `change` from the host.",
62066
+ "inheritedFrom": {
62067
+ "name": "HelixHeadlessDateInput",
62068
+ "module": "src/date-input/root/date-input-root.ts"
62069
+ }
62070
+ },
62071
+ {
62072
+ "kind": "field",
62073
+ "name": "handleAutofill",
62074
+ "privacy": "private",
62075
+ "readonly": true,
62076
+ "inheritedFrom": {
62077
+ "name": "HelixHeadlessDateInput",
62078
+ "module": "src/date-input/root/date-input-root.ts"
62079
+ }
62080
+ },
62081
+ {
62082
+ "kind": "field",
62083
+ "name": "showsClear",
62084
+ "type": {
62085
+ "text": "boolean"
62086
+ },
62087
+ "privacy": "private",
62088
+ "description": "Whether there is a clear button on screen right now.",
62089
+ "readonly": true,
62090
+ "inheritedFrom": {
62091
+ "name": "HelixHeadlessDateInput",
62092
+ "module": "src/date-input/root/date-input-root.ts"
62093
+ }
62094
+ },
62095
+ {
62096
+ "kind": "field",
62097
+ "name": "handleClear",
62098
+ "privacy": "private",
62099
+ "readonly": true,
62100
+ "description": "Empties the field, through `requestValue` so a consumer who owns the\nvalue decides, then says `change` and `helix-clear` and puts focus back\nin the field, the button having gone.",
62101
+ "inheritedFrom": {
62102
+ "name": "HelixHeadlessDateInput",
62103
+ "module": "src/date-input/root/date-input-root.ts"
62104
+ }
62105
+ },
62106
+ {
62107
+ "kind": "method",
62108
+ "name": "renderClearIcon",
62109
+ "privacy": "protected",
62110
+ "return": {
62111
+ "type": {
62112
+ "text": "TemplateResult"
62113
+ }
62114
+ },
62115
+ "description": "The cross on the clear button, behind a seam a tier can move.",
62116
+ "inheritedFrom": {
62117
+ "name": "HelixHeadlessDateInput",
62118
+ "module": "src/date-input/root/date-input-root.ts"
62119
+ }
62120
+ },
61787
62121
  {
61788
62122
  "kind": "method",
61789
62123
  "name": "renderControl",
@@ -62678,6 +63012,32 @@
62678
63012
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
62679
63013
  }
62680
63014
  },
63015
+ {
63016
+ "name": "range-end-label",
63017
+ "type": {
63018
+ "text": "string"
63019
+ },
63020
+ "default": "'End'",
63021
+ "description": "What a screen reader hears before the segments of a range's second date\nor time, after each segment's own name.",
63022
+ "fieldName": "rangeEndLabel",
63023
+ "inheritedFrom": {
63024
+ "name": "MixinSegmentedField",
63025
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
63026
+ }
63027
+ },
63028
+ {
63029
+ "name": "range-start-label",
63030
+ "type": {
63031
+ "text": "string"
63032
+ },
63033
+ "default": "'Start'",
63034
+ "description": "What a screen reader hears before the segments of a range's first date\nor time, after each segment's own name: \"month, Start, Stay\".",
63035
+ "fieldName": "rangeStartLabel",
63036
+ "inheritedFrom": {
63037
+ "name": "MixinSegmentedField",
63038
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
63039
+ }
63040
+ },
62681
63041
  {
62682
63042
  "name": "segmented",
62683
63043
  "type": {
@@ -62914,7 +63274,7 @@
62914
63274
  "text": "string"
62915
63275
  },
62916
63276
  "default": "''",
62917
- "description": "What the browser may autofill here, as one of the platform's own tokens.\n\nEmpty leaves the attribute off, which is the browser's default and is what\nlets autofill work at all: hardcoding `off` here means a birthday or a\npostal code can never be filled in for a reader.",
63277
+ "description": "What the browser may autofill here, as one of the platform's own tokens,\nsuch as `bday`.\n\nEmpty leaves the attribute off, which is the browser's default and is what\nlets autofill work at all: hardcoding `off` here means a birthday or a\npostal code can never be filled in for a reader. With `segmented`, a\nhidden native date input carries it, since no browser fills the segments.",
62918
63278
  "fieldName": "autocomplete",
62919
63279
  "inheritedFrom": {
62920
63280
  "name": "HelixHeadlessDateInput",
@@ -62924,9 +63284,9 @@
62924
63284
  {
62925
63285
  "name": "calendar",
62926
63286
  "type": {
62927
- "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | undefined"
63287
+ "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'chinese' | 'coptic' | 'dangi' | 'ethioaa' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic' | 'islamic-civil' | 'islamic-rgsa' | 'islamic-tbla' | 'islamic-umalqura' | 'persian' | undefined"
62928
63288
  },
62929
- "description": "The calendar the written date and the calendar's days are in: `gregory`,\n`buddhist`, `japanese`, `roc`, or `iso8601`.\n\nAbsent is the locale's own where it is one of the five, and `gregory` for\nevery other, as Date Picker's `calendar` is. The value is `YYYY-MM-DD` in\nevery calendar, and a focused field is ISO in every calendar. In\n`segmented`, the segments are the Gregorian day, month, and year, in the\norder the locale writes them, or ISO order for `iso8601`.",
63289
+ "description": "The calendar the written date, the segments, and the calendar's days are\nin: `gregory`, `buddhist`, `japanese`, `roc`, or `iso8601`, or a calendar\nwith months of its own that Date Picker's `calendar` names, such as\n`persian`, `hebrew`, `islamic-umalqura`, `ethiopic`, or `chinese`.\n\nAbsent is the locale's own where its months are the Gregorian months, and\n`gregory` for every other, as Date Picker's `calendar` is. The value is\n`YYYY-MM-DD` in every calendar, and a focused text field is ISO in every\ncalendar. In `segmented`, the segments are the day, month, and year as\nthe calendar counts them, in the order the locale writes them: Mehr 14,\n1405 is month 7 and day 14 of 1405 under `persian`. Under the five with\nGregorian months they are the Gregorian day, month, and year, or ISO order\nfor `iso8601`.",
62930
63290
  "fieldName": "calendar",
62931
63291
  "inheritedFrom": {
62932
63292
  "name": "HelixHeadlessDateInput",
@@ -62946,13 +63306,39 @@
62946
63306
  "module": "src/date-input/root/date-input-root.ts"
62947
63307
  }
62948
63308
  },
63309
+ {
63310
+ "name": "clearable",
63311
+ "type": {
63312
+ "text": "boolean"
63313
+ },
63314
+ "default": "false",
63315
+ "description": "Whether the field shows a button that empties it, as Input's `clearable`\ndoes. Shown only while the field holds something to clear and is neither\ndisabled nor read-only.",
63316
+ "fieldName": "clearable",
63317
+ "inheritedFrom": {
63318
+ "name": "HelixHeadlessDateInput",
63319
+ "module": "src/date-input/root/date-input-root.ts"
63320
+ }
63321
+ },
63322
+ {
63323
+ "name": "clear-label",
63324
+ "type": {
63325
+ "text": "string"
63326
+ },
63327
+ "default": "'Clear'",
63328
+ "description": "The accessible name of the clear button, which shows only an icon.",
63329
+ "fieldName": "clearLabel",
63330
+ "inheritedFrom": {
63331
+ "name": "HelixHeadlessDateInput",
63332
+ "module": "src/date-input/root/date-input-root.ts"
63333
+ }
63334
+ },
62949
63335
  {
62950
63336
  "name": "date-style",
62951
63337
  "type": {
62952
63338
  "text": "'full' | 'iso' | 'long' | 'medium' | 'short'"
62953
63339
  },
62954
63340
  "default": "'long'",
62955
- "description": "How a date is written in the field: `short` through `full`, or ISO.\n\n**The field renders when it is idle and holds the value when it is being\nedited.** A written date is a rendering, and a document being edited must\nnot be a rendering of something else: `Intl.DateTimeFormat` formats and does\nnot parse, so `4 August 2026` cannot be typed back, and writing a parser per\nlocale is how a field ends up rejecting what it just displayed.\n\nThe way out is not to choose between the two but to separate them in time.\nIdle, the field shows `4 August 2026`, which is what a date is for reading.\nFocused, it shows `2026-08-04`, which is what a date is for typing, and it\ngoes back on the way out. Nothing parses a rendering, and nothing is\nread-only, which is what an earlier version of this settled for.\n\nA range is the exception that needs no swap: the dash between its two dates\nis a separator this element understands, so that much reads back either way.\n\n`iso` turns the rendering off, for a field whose reader is entering data\nrather than reading it, or where the ISO form is itself the point.\n\nThe value is always `YYYY-MM-DD` regardless, because that is what a form\nsubmits and what `min` and `max` compare against.",
63341
+ "description": "How a date is written in the field: `short` through `full`, or ISO.\n\n**The field renders when it is idle and holds the value when it is being\nedited.** A written date is a rendering, and a document being edited must\nnot be a rendering of something else: `Intl.DateTimeFormat` formats and does\nnot parse, so a rendering such as `Tuesday, August 4, 2026` is no text to\nedit. The field does read a date typed in the locale's order and digits as\nyou leave it, which covers what a reader types.\n\nThe way out is not to choose between the two but to separate them in time.\nIdle, the field shows `4 August 2026`, which is what a date is for reading.\nFocused, it shows `2026-08-04`, which is what a date is for typing, and it\ngoes back on the way out. Nothing parses a rendering, and nothing is\nread-only, which is what an earlier version of this settled for.\n\nA range is the exception that needs no swap: the dash between its two dates\nis a separator this element understands, so that much reads back either way.\n\n`iso` turns the rendering off, for a field whose reader is entering data\nrather than reading it, or where the ISO form is itself the point.\n\nThe value is always `YYYY-MM-DD` regardless, because that is what a form\nsubmits and what `min` and `max` compare against.",
62956
63342
  "fieldName": "dateStyle",
62957
63343
  "inheritedFrom": {
62958
63344
  "name": "HelixHeadlessDateInput",
@@ -63229,6 +63615,19 @@
63229
63615
  "module": "src/date-input/root/date-input-root.ts"
63230
63616
  }
63231
63617
  },
63618
+ {
63619
+ "name": "selection-label",
63620
+ "type": {
63621
+ "text": "string"
63622
+ },
63623
+ "default": "'{kind, select, date {Selected date: {start}} start {Range starts {start}. Choose the day it ends.} range {Selected range: {start} to {end}} other {{count, plural, one {# date selected} other {# dates selected}}}}'",
63624
+ "description": "What a screen reader hears about the dates chosen in the calendar, with\n`{kind}`, `{start}`, `{end}` and `{count}` filled in as Date Picker's\n`selection-label` says.",
63625
+ "fieldName": "selectionLabel",
63626
+ "inheritedFrom": {
63627
+ "name": "HelixHeadlessDateInput",
63628
+ "module": "src/date-input/root/date-input-root.ts"
63629
+ }
63630
+ },
63232
63631
  {
63233
63632
  "name": "step",
63234
63633
  "type": {
@@ -63255,6 +63654,19 @@
63255
63654
  "module": "src/date-input/root/date-input-root.ts"
63256
63655
  }
63257
63656
  },
63657
+ {
63658
+ "name": "time-zone",
63659
+ "type": {
63660
+ "text": "string"
63661
+ },
63662
+ "default": "''",
63663
+ "description": "The time zone today is read in, such as `America/New_York`, handed to the\ncalendar: the day marked today, and the month an empty field opens on.\nEmpty is the reader's own. Dates are plain `YYYY-MM-DD` and carry no zone.",
63664
+ "fieldName": "timeZone",
63665
+ "inheritedFrom": {
63666
+ "name": "HelixHeadlessDateInput",
63667
+ "module": "src/date-input/root/date-input-root.ts"
63668
+ }
63669
+ },
63258
63670
  {
63259
63671
  "name": "trigger-label",
63260
63672
  "type": {
@@ -63281,6 +63693,19 @@
63281
63693
  "module": "src/date-input/root/date-input-root.ts"
63282
63694
  }
63283
63695
  },
63696
+ {
63697
+ "name": "unreadable-message",
63698
+ "type": {
63699
+ "text": "string"
63700
+ },
63701
+ "default": "'{mode, select, single {Enter a date as YYYY-MM-DD.} other {Enter dates as YYYY-MM-DD, separated by commas.}}'",
63702
+ "description": "The message for text that is no date, where `bad-input-message` is not\nset. `{mode}` is `single`, `range`, or `multiple`.",
63703
+ "fieldName": "unreadableMessage",
63704
+ "inheritedFrom": {
63705
+ "name": "HelixHeadlessDateInput",
63706
+ "module": "src/date-input/root/date-input-root.ts"
63707
+ }
63708
+ },
63284
63709
  {
63285
63710
  "name": "year-view-label",
63286
63711
  "type": {
@@ -63382,6 +63807,18 @@
63382
63807
  "module": "src/date-input/root/date-input-root.ts"
63383
63808
  }
63384
63809
  },
63810
+ {
63811
+ "type": {
63812
+ "text": "HelixClearEvent"
63813
+ },
63814
+ "description": "Fired after the clear button has emptied the field, after `input` and `change`.",
63815
+ "name": "helix-clear",
63816
+ "reactProp": "onhelix-clear",
63817
+ "inheritedFrom": {
63818
+ "name": "HelixHeadlessDateInput",
63819
+ "module": "src/date-input/root/date-input-root.ts"
63820
+ }
63821
+ },
63385
63822
  {
63386
63823
  "type": {
63387
63824
  "text": "Event"
@@ -63396,6 +63833,14 @@
63396
63833
  }
63397
63834
  ],
63398
63835
  "slots": [
63836
+ {
63837
+ "description": "Replaces the cross on the clear button, under `clearable`.",
63838
+ "name": "clear-icon",
63839
+ "inheritedFrom": {
63840
+ "name": "HelixHeadlessDateInput",
63841
+ "module": "src/date-input/root/date-input-root.ts"
63842
+ }
63843
+ },
63399
63844
  {
63400
63845
  "description": "Content after the date, before the trigger, such as a clear button.",
63401
63846
  "name": "end",
@@ -63478,6 +63923,14 @@
63478
63923
  }
63479
63924
  ],
63480
63925
  "cssParts": [
63926
+ {
63927
+ "description": "The button that empties the field, under `clearable`, while it holds a date.",
63928
+ "name": "clear",
63929
+ "inheritedFrom": {
63930
+ "name": "HelixHeadlessDateInput",
63931
+ "module": "src/date-input/root/date-input-root.ts"
63932
+ }
63933
+ },
63481
63934
  {
63482
63935
  "description": "The text input.",
63483
63936
  "name": "control",
@@ -63806,6 +64259,14 @@
63806
64259
  "module": "src/date-input/root/date-input-root.ts"
63807
64260
  }
63808
64261
  },
64262
+ {
64263
+ "description": "The chosen date or range in words, which screen readers hear when it changes. Drawn for screen readers only.",
64264
+ "name": "picker-selection",
64265
+ "inheritedFrom": {
64266
+ "name": "HelixHeadlessDateInput",
64267
+ "module": "src/date-input/root/date-input-root.ts"
64268
+ }
64269
+ },
63809
64270
  {
63810
64271
  "description": "One row of days.",
63811
64272
  "name": "picker-week",
@@ -63822,6 +64283,14 @@
63822
64283
  "module": "src/date-input/root/date-input-root.ts"
63823
64284
  }
63824
64285
  },
64286
+ {
64287
+ "description": "The dash between a range's two rows of segments, in `segmented`, beside `literal`.",
64288
+ "name": "range-separator",
64289
+ "inheritedFrom": {
64290
+ "name": "HelixHeadlessDateInput",
64291
+ "module": "src/date-input/root/date-input-root.ts"
64292
+ }
64293
+ },
63825
64294
  {
63826
64295
  "description": "The count of dates beyond the ones shown. It is a `<button>` with `expandable` and a `<span>` without it.",
63827
64296
  "name": "rest",
@@ -63888,6 +64357,14 @@
63888
64357
  }
63889
64358
  ],
63890
64359
  "cssStates": [
64360
+ {
64361
+ "description": "The field holds no date.",
64362
+ "name": "blank",
64363
+ "inheritedFrom": {
64364
+ "name": "HelixHeadlessDateInput",
64365
+ "module": "src/date-input/root/date-input-root.ts"
64366
+ }
64367
+ },
63891
64368
  {
63892
64369
  "description": "The field has an error to show, from the browser's validation or from your `feedback`.",
63893
64370
  "name": "invalid",
@@ -64000,6 +64477,10 @@
64000
64477
  "description": "Band behind the days in a range.",
64001
64478
  "name": "--date-picker-range-color"
64002
64479
  },
64480
+ {
64481
+ "description": "Band behind the days a waiting range is drawn to, before its second end is chosen.",
64482
+ "name": "--date-picker-range-preview-color"
64483
+ },
64003
64484
  {
64004
64485
  "description": "Height of a week row.",
64005
64486
  "name": "--date-picker-row-size"
@@ -64051,6 +64532,20 @@
64051
64532
  "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
64052
64533
  }
64053
64534
  },
64535
+ {
64536
+ "kind": "field",
64537
+ "name": "touched",
64538
+ "type": {
64539
+ "text": "boolean"
64540
+ },
64541
+ "privacy": "private",
64542
+ "default": "false",
64543
+ "description": "Whether the reader has committed an answer, or a form has refused the\npicker. A reset forgets it.",
64544
+ "inheritedFrom": {
64545
+ "name": "MixinPickerFeedback",
64546
+ "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
64547
+ }
64548
+ },
64054
64549
  {
64055
64550
  "kind": "field",
64056
64551
  "name": "marked",
@@ -64058,13 +64553,44 @@
64058
64553
  "text": "boolean"
64059
64554
  },
64060
64555
  "privacy": "protected",
64061
- "description": "Whether a reader is told the answer is wrong: `invalid`, or `feedback`.",
64556
+ "description": "Whether a reader is told the answer is wrong: `invalid`, `feedback`, a\nheld answer the picker refuses, or a missing answer once the reader has\ncommitted one or a form has refused the picker.\n\n**A refused answer is marked at once, and a missing one waits**, as\nChromium's tree does for native controls: a time input holding a time\npast its `max` reports invalid on load, and an empty required text field\ndoes not, since the reader already hears that it is required. Measured\nbefore this on Time Picker: `value=\"13:00\" max=\"12:00\"` reported\n`rangeOverflow` while the list said nothing and `:state(invalid)` was off.",
64557
+ "readonly": true,
64558
+ "inheritedFrom": {
64559
+ "name": "MixinPickerFeedback",
64560
+ "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
64561
+ }
64562
+ },
64563
+ {
64564
+ "kind": "field",
64565
+ "name": "failure",
64566
+ "type": {
64567
+ "text": "'missing' | 'refused' | undefined"
64568
+ },
64569
+ "privacy": "protected",
64570
+ "description": "What the picker's own validation finds: `missing`, `refused`, or\nnothing, which is what a picker that does not answer it reports.",
64062
64571
  "readonly": true,
64063
64572
  "inheritedFrom": {
64064
64573
  "name": "MixinPickerFeedback",
64065
64574
  "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
64066
64575
  }
64067
64576
  },
64577
+ {
64578
+ "kind": "method",
64579
+ "name": "formResetCallback",
64580
+ "return": {
64581
+ "type": {
64582
+ "text": "void"
64583
+ }
64584
+ },
64585
+ "description": "Returns the control to its `defaultValue`, or to its `value` attribute\nwhere there is no `default-value`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value.",
64586
+ "inheritedFrom": {
64587
+ "name": "HelixFormElement",
64588
+ "module": "src/helix-form-element/helix-form-element.ts"
64589
+ },
64590
+ "type": {
64591
+ "text": "formResetCallback() => void"
64592
+ }
64593
+ },
64068
64594
  {
64069
64595
  "kind": "method",
64070
64596
  "name": "renderPickerFeedback",
@@ -64190,23 +64716,6 @@
64190
64716
  "module": "src/mixins/mixin-controller-value/mixin-controller-value.ts"
64191
64717
  }
64192
64718
  },
64193
- {
64194
- "kind": "method",
64195
- "name": "formResetCallback",
64196
- "return": {
64197
- "type": {
64198
- "text": "void"
64199
- }
64200
- },
64201
- "description": "Returns the control to its `defaultValue`, or to its `value` attribute\nwhere there is no `default-value`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value.",
64202
- "inheritedFrom": {
64203
- "name": "HelixFormElement",
64204
- "module": "src/helix-form-element/helix-form-element.ts"
64205
- },
64206
- "type": {
64207
- "text": "formResetCallback() => void"
64208
- }
64209
- },
64210
64719
  {
64211
64720
  "kind": "method",
64212
64721
  "name": "formStateRestoreCallback",
@@ -64267,9 +64776,9 @@
64267
64776
  "kind": "field",
64268
64777
  "name": "calendar",
64269
64778
  "type": {
64270
- "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'coptic' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic-civil' | 'islamic-umalqura' | 'persian' | undefined"
64779
+ "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'chinese' | 'coptic' | 'dangi' | 'ethioaa' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic' | 'islamic-civil' | 'islamic-rgsa' | 'islamic-tbla' | 'islamic-umalqura' | 'persian' | undefined"
64271
64780
  },
64272
- "description": "The calendar the heading, the days, and the months are written in.\n\n`gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five\nwhose months are the Gregorian months. Absent is the locale's own where\nit is one of the five, such as `buddhist` for `th-TH` or `japanese` for\n`ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`\nfor `fa-IR`.\n\n`persian`, `hebrew`, `islamic-umalqura`, `islamic-civil`, `ethiopic`,\n`coptic`, and `indian` draw a calendar with months of its own, as React\nAria's calendars do: each grid is one of that calendar's months, the\nHebrew leap month and Ethiopia's five-day thirteenth month included, and\nPrevious, Next and the page keys move by those months. `month` and\n`helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The\nheading stays text, as the months and years views are drawn in Gregorian\nmonths only. The value is `YYYY-MM-DD` in every calendar.",
64781
+ "description": "The calendar the heading, the days, and the months are written in.\n\n`gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five\nwhose months are the Gregorian months. Absent is the locale's own where\nit is one of the five, such as `buddhist` for `th-TH` or `japanese` for\n`ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`\nfor `fa-IR`.\n\n`persian`, `hebrew`, `islamic`, `islamic-umalqura`, `islamic-civil`,\n`islamic-tbla`, `islamic-rgsa`, `ethiopic`, `ethioaa`, `coptic`,\n`indian`, `chinese`, and `dangi` draw a calendar with months of its own,\nas React Aria's calendars do: each grid is one of that calendar's months,\nthe Hebrew and Chinese leap months and Ethiopia's five-day thirteenth\nmonth included, and Previous, Next and the page keys move by those\nmonths. With `max-view`, the months view shows that calendar's year, of\ntwelve or thirteen months, and the years view its years. `month` and\n`helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The\nvalue is `YYYY-MM-DD` in every calendar.",
64273
64782
  "attribute": "calendar",
64274
64783
  "inheritedFrom": {
64275
64784
  "name": "HelixHeadlessDatePicker",
@@ -64469,6 +64978,20 @@
64469
64978
  "module": "src/date-picker/root/date-picker-root.ts"
64470
64979
  }
64471
64980
  },
64981
+ {
64982
+ "kind": "field",
64983
+ "name": "browsed",
64984
+ "type": {
64985
+ "text": "boolean"
64986
+ },
64987
+ "privacy": "private",
64988
+ "default": "false",
64989
+ "description": "Whether the month on show is one the reader paged to, which `showChosen` forgets.",
64990
+ "inheritedFrom": {
64991
+ "name": "HelixHeadlessDatePicker",
64992
+ "module": "src/date-picker/root/date-picker-root.ts"
64993
+ }
64994
+ },
64472
64995
  {
64473
64996
  "kind": "field",
64474
64997
  "name": "month",
@@ -64716,13 +65239,55 @@
64716
65239
  "module": "src/date-picker/root/date-picker-root.ts"
64717
65240
  }
64718
65241
  },
65242
+ {
65243
+ "kind": "field",
65244
+ "name": "previewed",
65245
+ "type": {
65246
+ "text": "string"
65247
+ },
65248
+ "privacy": "private",
65249
+ "default": "''",
65250
+ "description": "The day a reader points at or moves to while a range holds one end, which\nthe grid draws the range to before it is chosen.",
65251
+ "inheritedFrom": {
65252
+ "name": "HelixHeadlessDatePicker",
65253
+ "module": "src/date-picker/root/date-picker-root.ts"
65254
+ }
65255
+ },
65256
+ {
65257
+ "kind": "field",
65258
+ "name": "pending",
65259
+ "type": {
65260
+ "text": "boolean"
65261
+ },
65262
+ "privacy": "private",
65263
+ "description": "Whether a range holds its first end and waits for the second.",
65264
+ "readonly": true,
65265
+ "inheritedFrom": {
65266
+ "name": "HelixHeadlessDatePicker",
65267
+ "module": "src/date-picker/root/date-picker-root.ts"
65268
+ }
65269
+ },
65270
+ {
65271
+ "kind": "field",
65272
+ "name": "drawnRange",
65273
+ "type": {
65274
+ "text": "{ ends: [string, string]; preview: boolean } | null"
65275
+ },
65276
+ "privacy": "private",
65277
+ "description": "The range the grid draws: the chosen one, or, while one end waits for\nthe other, the run to the day under the pointer or the focus.",
65278
+ "readonly": true,
65279
+ "inheritedFrom": {
65280
+ "name": "HelixHeadlessDatePicker",
65281
+ "module": "src/date-picker/root/date-picker-root.ts"
65282
+ }
65283
+ },
64719
65284
  {
64720
65285
  "kind": "method",
64721
- "name": "isSelected",
65286
+ "name": "preview",
64722
65287
  "privacy": "private",
64723
65288
  "return": {
64724
65289
  "type": {
64725
- "text": "boolean"
65290
+ "text": "void"
64726
65291
  }
64727
65292
  },
64728
65293
  "parameters": [
@@ -64733,6 +65298,7 @@
64733
65298
  }
64734
65299
  }
64735
65300
  ],
65301
+ "description": "Draws a waiting range to the day the pointer is on.",
64736
65302
  "inheritedFrom": {
64737
65303
  "name": "HelixHeadlessDatePicker",
64738
65304
  "module": "src/date-picker/root/date-picker-root.ts"
@@ -64740,26 +65306,44 @@
64740
65306
  },
64741
65307
  {
64742
65308
  "kind": "field",
64743
- "name": "shown",
64744
- "type": {
64745
- "text": "Date"
64746
- },
65309
+ "name": "handleGridLeave",
64747
65310
  "privacy": "private",
64748
- "description": "The month being shown, resolved from `month`, then `value`, then today.",
64749
65311
  "readonly": true,
64750
65312
  "inheritedFrom": {
64751
65313
  "name": "HelixHeadlessDatePicker",
64752
65314
  "module": "src/date-picker/root/date-picker-root.ts"
64753
65315
  }
64754
65316
  },
65317
+ {
65318
+ "kind": "method",
65319
+ "name": "isSelected",
65320
+ "privacy": "private",
65321
+ "return": {
65322
+ "type": {
65323
+ "text": "boolean"
65324
+ }
65325
+ },
65326
+ "parameters": [
65327
+ {
65328
+ "name": "iso",
65329
+ "type": {
65330
+ "text": "string"
65331
+ }
65332
+ }
65333
+ ],
65334
+ "inheritedFrom": {
65335
+ "name": "HelixHeadlessDatePicker",
65336
+ "module": "src/date-picker/root/date-picker-root.ts"
65337
+ }
65338
+ },
64755
65339
  {
64756
65340
  "kind": "field",
64757
- "name": "system",
65341
+ "name": "shown",
64758
65342
  "type": {
64759
- "text": "MonthSystem"
65343
+ "text": "Date"
64760
65344
  },
64761
65345
  "privacy": "private",
64762
- "description": "The months the calendar pages through: its own under a `calendar` with\nmonths of its own, and the Gregorian months otherwise.",
65346
+ "description": "The month being shown, resolved from `month`, then `value`, then today.",
64763
65347
  "readonly": true,
64764
65348
  "inheritedFrom": {
64765
65349
  "name": "HelixHeadlessDatePicker",
@@ -64768,12 +65352,12 @@
64768
65352
  },
64769
65353
  {
64770
65354
  "kind": "field",
64771
- "name": "ownMonths",
65355
+ "name": "system",
64772
65356
  "type": {
64773
- "text": "boolean"
65357
+ "text": "MonthSystem"
64774
65358
  },
64775
65359
  "privacy": "private",
64776
- "description": "Whether `calendar` names a calendar with months of its own.",
65360
+ "description": "The months the calendar pages through: its own under a `calendar` with\nmonths of its own, and the Gregorian months otherwise.",
64777
65361
  "readonly": true,
64778
65362
  "inheritedFrom": {
64779
65363
  "name": "HelixHeadlessDatePicker",
@@ -65214,6 +65798,23 @@
65214
65798
  "text": "focus(options?: FocusOptions) => void"
65215
65799
  }
65216
65800
  },
65801
+ {
65802
+ "kind": "method",
65803
+ "name": "showChosen",
65804
+ "return": {
65805
+ "type": {
65806
+ "text": "void"
65807
+ }
65808
+ },
65809
+ "description": "Shows the days again, on the month of the chosen date, with the tab stop\non that date, forgetting the month and the day the reader browsed to.\n\nDate Input calls it each time its panel opens, which is where the APG\ndate picker dialog puts focus. Measured before this: from August 4, two\npresses of Page Down, Escape, and Down again opened on October 4.\nA `month` you set stays until the reader pages away from it.",
65810
+ "type": {
65811
+ "text": "showChosen() => void"
65812
+ },
65813
+ "inheritedFrom": {
65814
+ "name": "HelixHeadlessDatePicker",
65815
+ "module": "src/date-picker/root/date-picker-root.ts"
65816
+ }
65817
+ },
65217
65818
  {
65218
65819
  "kind": "field",
65219
65820
  "name": "rangeUnderflowMessage",
@@ -65261,6 +65862,37 @@
65261
65862
  "module": "src/date-picker/root/date-picker-root.ts"
65262
65863
  }
65263
65864
  },
65865
+ {
65866
+ "kind": "field",
65867
+ "name": "selectionLabel",
65868
+ "type": {
65869
+ "text": "string"
65870
+ },
65871
+ "default": "'{kind, select, date {Selected date: {start}} start {Range starts {start}. Choose the day it ends.} range {Selected range: {start} to {end}} other {{count, plural, one {# date selected} other {# dates selected}}}}'",
65872
+ "description": "What a screen reader hears about the chosen dates: the grid's\ndescription, said again whenever the dates change. `{kind}` is `date`,\n`start` while a range holds one end, `range`, or `dates` for `multiple`.\n`{start}` and `{end}` are dates written in `locale`, and `{count}` is how\nmany dates are chosen.",
65873
+ "attribute": "selection-label",
65874
+ "helix": {
65875
+ "words": true
65876
+ },
65877
+ "inheritedFrom": {
65878
+ "name": "HelixHeadlessDatePicker",
65879
+ "module": "src/date-picker/root/date-picker-root.ts"
65880
+ }
65881
+ },
65882
+ {
65883
+ "kind": "field",
65884
+ "name": "selectionWords",
65885
+ "type": {
65886
+ "text": "string"
65887
+ },
65888
+ "privacy": "private",
65889
+ "description": "`selectionLabel` for the dates chosen now, or nothing while there are none.\n\nReact Aria's calendars describe the grid by the chosen date or range and\nannounce it when it changes. Measured before this: a range of seven days\nwas seven cells with `aria-selected` in a grid that said nothing of a\nrange, and choosing its end was heard as one more selected cell.",
65890
+ "readonly": true,
65891
+ "inheritedFrom": {
65892
+ "name": "HelixHeadlessDatePicker",
65893
+ "module": "src/date-picker/root/date-picker-root.ts"
65894
+ }
65895
+ },
65264
65896
  {
65265
65897
  "kind": "field",
65266
65898
  "name": "step",
@@ -65432,6 +66064,20 @@
65432
66064
  "module": "src/date-picker/root/date-picker-root.ts"
65433
66065
  }
65434
66066
  },
66067
+ {
66068
+ "kind": "field",
66069
+ "name": "problem",
66070
+ "type": {
66071
+ "text": "[ValidityStateFlags, string] | undefined"
66072
+ },
66073
+ "privacy": "private",
66074
+ "description": "What is wrong with the answer, as validity flags and a message, or nothing.\n`reportRequired` hands it to the form, and `failure` to the mark.",
66075
+ "readonly": true,
66076
+ "inheritedFrom": {
66077
+ "name": "HelixHeadlessDatePicker",
66078
+ "module": "src/date-picker/root/date-picker-root.ts"
66079
+ }
66080
+ },
65435
66081
  {
65436
66082
  "kind": "method",
65437
66083
  "name": "report",
@@ -66538,9 +67184,9 @@
66538
67184
  {
66539
67185
  "name": "calendar",
66540
67186
  "type": {
66541
- "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'coptic' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic-civil' | 'islamic-umalqura' | 'persian' | undefined"
67187
+ "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'chinese' | 'coptic' | 'dangi' | 'ethioaa' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic' | 'islamic-civil' | 'islamic-rgsa' | 'islamic-tbla' | 'islamic-umalqura' | 'persian' | undefined"
66542
67188
  },
66543
- "description": "The calendar the heading, the days, and the months are written in.\n\n`gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five\nwhose months are the Gregorian months. Absent is the locale's own where\nit is one of the five, such as `buddhist` for `th-TH` or `japanese` for\n`ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`\nfor `fa-IR`.\n\n`persian`, `hebrew`, `islamic-umalqura`, `islamic-civil`, `ethiopic`,\n`coptic`, and `indian` draw a calendar with months of its own, as React\nAria's calendars do: each grid is one of that calendar's months, the\nHebrew leap month and Ethiopia's five-day thirteenth month included, and\nPrevious, Next and the page keys move by those months. `month` and\n`helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The\nheading stays text, as the months and years views are drawn in Gregorian\nmonths only. The value is `YYYY-MM-DD` in every calendar.",
67189
+ "description": "The calendar the heading, the days, and the months are written in.\n\n`gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five\nwhose months are the Gregorian months. Absent is the locale's own where\nit is one of the five, such as `buddhist` for `th-TH` or `japanese` for\n`ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`\nfor `fa-IR`.\n\n`persian`, `hebrew`, `islamic`, `islamic-umalqura`, `islamic-civil`,\n`islamic-tbla`, `islamic-rgsa`, `ethiopic`, `ethioaa`, `coptic`,\n`indian`, `chinese`, and `dangi` draw a calendar with months of its own,\nas React Aria's calendars do: each grid is one of that calendar's months,\nthe Hebrew and Chinese leap months and Ethiopia's five-day thirteenth\nmonth included, and Previous, Next and the page keys move by those\nmonths. With `max-view`, the months view shows that calendar's year, of\ntwelve or thirteen months, and the years view its years. `month` and\n`helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The\nvalue is `YYYY-MM-DD` in every calendar.",
66544
67190
  "fieldName": "calendar",
66545
67191
  "inheritedFrom": {
66546
67192
  "name": "HelixHeadlessDatePicker",
@@ -66842,6 +67488,19 @@
66842
67488
  "module": "src/date-picker/root/date-picker-root.ts"
66843
67489
  }
66844
67490
  },
67491
+ {
67492
+ "name": "selection-label",
67493
+ "type": {
67494
+ "text": "string"
67495
+ },
67496
+ "default": "'{kind, select, date {Selected date: {start}} start {Range starts {start}. Choose the day it ends.} range {Selected range: {start} to {end}} other {{count, plural, one {# date selected} other {# dates selected}}}}'",
67497
+ "description": "What a screen reader hears about the chosen dates: the grid's\ndescription, said again whenever the dates change. `{kind}` is `date`,\n`start` while a range holds one end, `range`, or `dates` for `multiple`.\n`{start}` and `{end}` are dates written in `locale`, and `{count}` is how\nmany dates are chosen.",
67498
+ "fieldName": "selectionLabel",
67499
+ "inheritedFrom": {
67500
+ "name": "HelixHeadlessDatePicker",
67501
+ "module": "src/date-picker/root/date-picker-root.ts"
67502
+ }
67503
+ },
66845
67504
  {
66846
67505
  "name": "step",
66847
67506
  "type": {
@@ -67004,7 +67663,7 @@
67004
67663
  }
67005
67664
  },
67006
67665
  {
67007
- "description": "The cell of a range's last day, beside `cell`.",
67666
+ "description": "The cell of a range's last day, beside `cell`, or of the day a waiting range is drawn to.",
67008
67667
  "name": "cell-range-end",
67009
67668
  "inheritedFrom": {
67010
67669
  "name": "HelixHeadlessDatePicker",
@@ -67211,6 +67870,14 @@
67211
67870
  "module": "src/date-picker/root/date-picker-root.ts"
67212
67871
  }
67213
67872
  },
67873
+ {
67874
+ "description": "The chosen date or range in words, which screen readers hear when it changes. Drawn for screen readers only.",
67875
+ "name": "selection",
67876
+ "inheritedFrom": {
67877
+ "name": "HelixHeadlessDatePicker",
67878
+ "module": "src/date-picker/root/date-picker-root.ts"
67879
+ }
67880
+ },
67214
67881
  {
67215
67882
  "description": "One row of days.",
67216
67883
  "name": "week",
@@ -67280,13 +67947,45 @@
67280
67947
  ],
67281
67948
  "cssStates": [
67282
67949
  {
67283
- "description": "While `invalid` is set or `feedback` says what is wrong.",
67950
+ "description": "While no date is chosen.",
67951
+ "name": "blank",
67952
+ "inheritedFrom": {
67953
+ "name": "HelixHeadlessDatePicker",
67954
+ "module": "src/date-picker/root/date-picker-root.ts"
67955
+ }
67956
+ },
67957
+ {
67958
+ "description": "While `invalid` is set, `feedback` says what is wrong, the picker holds a date outside `min` and `max` or one it bars, or it is `required`, holds no date, and the reader has answered once or a form has refused it.",
67284
67959
  "name": "invalid",
67285
67960
  "inheritedFrom": {
67286
67961
  "name": "HelixHeadlessDatePicker",
67287
67962
  "module": "src/date-picker/root/date-picker-root.ts"
67288
67963
  }
67289
67964
  },
67965
+ {
67966
+ "description": "While the months of a year are shown, where `max-view` is set.",
67967
+ "name": "month-view",
67968
+ "inheritedFrom": {
67969
+ "name": "HelixHeadlessDatePicker",
67970
+ "module": "src/date-picker/root/date-picker-root.ts"
67971
+ }
67972
+ },
67973
+ {
67974
+ "description": "While a `range` holds its first end and waits for the second.",
67975
+ "name": "range-pending",
67976
+ "inheritedFrom": {
67977
+ "name": "HelixHeadlessDatePicker",
67978
+ "module": "src/date-picker/root/date-picker-root.ts"
67979
+ }
67980
+ },
67981
+ {
67982
+ "description": "While a page of years is shown, where `max-view` is `year`.",
67983
+ "name": "year-view",
67984
+ "inheritedFrom": {
67985
+ "name": "HelixHeadlessDatePicker",
67986
+ "module": "src/date-picker/root/date-picker-root.ts"
67987
+ }
67988
+ },
67290
67989
  {
67291
67990
  "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
67292
67991
  "name": "settled",
@@ -86331,9 +87030,9 @@
86331
87030
  "kind": "field",
86332
87031
  "name": "calendar",
86333
87032
  "type": {
86334
- "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | undefined"
87033
+ "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'chinese' | 'coptic' | 'dangi' | 'ethioaa' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic' | 'islamic-civil' | 'islamic-rgsa' | 'islamic-tbla' | 'islamic-umalqura' | 'persian' | undefined"
86335
87034
  },
86336
- "description": "The calendar a date is written in: `gregory`, `buddhist`, `japanese`,\n`roc`, or `iso8601`, the calendars Date Picker and Date Input draw.\n\nAbsent is the locale's own where it is one of the five, such as\n`buddhist` for `th-TH`, and `gregory` for every other, such as `persian`\nfor `fa-IR`, so a date written here reads as the same date a Date Picker\nbeside it shows.",
87035
+ "description": "The calendar a date is written in: `gregory`, `buddhist`, `japanese`,\n`roc`, or `iso8601`, or a calendar with months of its own, such as\n`persian`, `hebrew`, `islamic-umalqura`, `ethiopic`, or `chinese`: every\ncalendar Date Picker and Date Input draw.\n\nAbsent is the locale's own where its months are the Gregorian months,\nsuch as `buddhist` for `th-TH`, and `gregory` for every other, such as\n`persian` for `fa-IR`, so a date written here reads as the same date a\nDate Picker beside it shows. Write `calendar=\"persian\"` for Mehr 14, 1405.",
86337
87036
  "attribute": "calendar",
86338
87037
  "inheritedFrom": {
86339
87038
  "name": "HelixHeadlessFormatDate",
@@ -86380,6 +87079,19 @@
86380
87079
  "module": "src/format-date/root/format-date-root.ts"
86381
87080
  }
86382
87081
  },
87082
+ {
87083
+ "kind": "field",
87084
+ "name": "dayPeriod",
87085
+ "type": {
87086
+ "text": "'long' | 'narrow' | 'short' | undefined"
87087
+ },
87088
+ "description": "Writes the part of the day in words, such as \"in the morning\" or \"at\nnight\", in its `long`, `short`, or `narrow` form, where `hour` is on a\ntwelve-hour clock.",
87089
+ "attribute": "day-period",
87090
+ "inheritedFrom": {
87091
+ "name": "HelixHeadlessFormatDate",
87092
+ "module": "src/format-date/root/format-date-root.ts"
87093
+ }
87094
+ },
86383
87095
  {
86384
87096
  "kind": "field",
86385
87097
  "name": "elapsed",
@@ -86421,6 +87133,19 @@
86421
87133
  "module": "src/format-date/root/format-date-root.ts"
86422
87134
  }
86423
87135
  },
87136
+ {
87137
+ "kind": "field",
87138
+ "name": "fractionalSecondDigits",
87139
+ "type": {
87140
+ "text": "1 | 2 | 3 | undefined"
87141
+ },
87142
+ "description": "How many digits of a fraction of a second to write after `second`: 1, 2,\nor 3, as in 09:41:07.250.",
87143
+ "attribute": "fractional-second-digits",
87144
+ "inheritedFrom": {
87145
+ "name": "HelixHeadlessFormatDate",
87146
+ "module": "src/format-date/root/format-date-root.ts"
87147
+ }
87148
+ },
86424
87149
  {
86425
87150
  "kind": "field",
86426
87151
  "name": "frozen",
@@ -86584,9 +87309,9 @@
86584
87309
  "kind": "field",
86585
87310
  "name": "timeZoneName",
86586
87311
  "type": {
86587
- "text": "'long' | 'short' | undefined"
87312
+ "text": "'long' | 'longGeneric' | 'longOffset' | 'short' | 'shortGeneric' | 'shortOffset' | undefined"
86588
87313
  },
86589
- "description": "Shows the name of the time zone, in its `long` or `short` form.",
87314
+ "description": "Shows the name of the time zone: `long` or `short`, as Pacific Daylight\nTime or PDT, `longOffset` or `shortOffset`, as GMT-07:00 or GMT-7, or\n`longGeneric` or `shortGeneric`, as Pacific Time or PT.",
86590
87315
  "attribute": "time-zone-name",
86591
87316
  "inheritedFrom": {
86592
87317
  "name": "HelixHeadlessFormatDate",
@@ -87159,6 +87884,14 @@
87159
87884
  "module": "src/format-date/root/format-date-root.ts"
87160
87885
  }
87161
87886
  },
87887
+ {
87888
+ "description": "The fraction of a second, with `fields` and `fractional-second-digits`.",
87889
+ "name": "fractional-second",
87890
+ "inheritedFrom": {
87891
+ "name": "HelixHeadlessFormatDate",
87892
+ "module": "src/format-date/root/format-date-root.ts"
87893
+ }
87894
+ },
87162
87895
  {
87163
87896
  "description": "The hour, with `fields`.",
87164
87897
  "name": "hour",
@@ -87228,9 +87961,9 @@
87228
87961
  {
87229
87962
  "name": "calendar",
87230
87963
  "type": {
87231
- "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | undefined"
87964
+ "text": "'buddhist' | 'gregory' | 'iso8601' | 'japanese' | 'roc' | 'chinese' | 'coptic' | 'dangi' | 'ethioaa' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic' | 'islamic-civil' | 'islamic-rgsa' | 'islamic-tbla' | 'islamic-umalqura' | 'persian' | undefined"
87232
87965
  },
87233
- "description": "The calendar a date is written in: `gregory`, `buddhist`, `japanese`,\n`roc`, or `iso8601`, the calendars Date Picker and Date Input draw.\n\nAbsent is the locale's own where it is one of the five, such as\n`buddhist` for `th-TH`, and `gregory` for every other, such as `persian`\nfor `fa-IR`, so a date written here reads as the same date a Date Picker\nbeside it shows.",
87966
+ "description": "The calendar a date is written in: `gregory`, `buddhist`, `japanese`,\n`roc`, or `iso8601`, or a calendar with months of its own, such as\n`persian`, `hebrew`, `islamic-umalqura`, `ethiopic`, or `chinese`: every\ncalendar Date Picker and Date Input draw.\n\nAbsent is the locale's own where its months are the Gregorian months,\nsuch as `buddhist` for `th-TH`, and `gregory` for every other, such as\n`persian` for `fa-IR`, so a date written here reads as the same date a\nDate Picker beside it shows. Write `calendar=\"persian\"` for Mehr 14, 1405.",
87234
87967
  "fieldName": "calendar",
87235
87968
  "inheritedFrom": {
87236
87969
  "name": "HelixHeadlessFormatDate",
@@ -87274,6 +88007,18 @@
87274
88007
  "module": "src/format-date/root/format-date-root.ts"
87275
88008
  }
87276
88009
  },
88010
+ {
88011
+ "name": "day-period",
88012
+ "type": {
88013
+ "text": "'long' | 'narrow' | 'short' | undefined"
88014
+ },
88015
+ "description": "Writes the part of the day in words, such as \"in the morning\" or \"at\nnight\", in its `long`, `short`, or `narrow` form, where `hour` is on a\ntwelve-hour clock.",
88016
+ "fieldName": "dayPeriod",
88017
+ "inheritedFrom": {
88018
+ "name": "HelixHeadlessFormatDate",
88019
+ "module": "src/format-date/root/format-date-root.ts"
88020
+ }
88021
+ },
87277
88022
  {
87278
88023
  "name": "elapsed",
87279
88024
  "type": {
@@ -87311,6 +88056,18 @@
87311
88056
  "module": "src/format-date/root/format-date-root.ts"
87312
88057
  }
87313
88058
  },
88059
+ {
88060
+ "name": "fractional-second-digits",
88061
+ "type": {
88062
+ "text": "1 | 2 | 3 | undefined"
88063
+ },
88064
+ "description": "How many digits of a fraction of a second to write after `second`: 1, 2,\nor 3, as in 09:41:07.250.",
88065
+ "fieldName": "fractionalSecondDigits",
88066
+ "inheritedFrom": {
88067
+ "name": "HelixHeadlessFormatDate",
88068
+ "module": "src/format-date/root/format-date-root.ts"
88069
+ }
88070
+ },
87314
88071
  {
87315
88072
  "name": "frozen",
87316
88073
  "type": {
@@ -87448,9 +88205,9 @@
87448
88205
  {
87449
88206
  "name": "time-zone-name",
87450
88207
  "type": {
87451
- "text": "'long' | 'short' | undefined"
88208
+ "text": "'long' | 'longGeneric' | 'longOffset' | 'short' | 'shortGeneric' | 'shortOffset' | undefined"
87452
88209
  },
87453
- "description": "Shows the name of the time zone, in its `long` or `short` form.",
88210
+ "description": "Shows the name of the time zone: `long` or `short`, as Pacific Daylight\nTime or PDT, `longOffset` or `shortOffset`, as GMT-07:00 or GMT-7, or\n`longGeneric` or `shortGeneric`, as Pacific Time or PT.",
87454
88211
  "fieldName": "timeZoneName",
87455
88212
  "inheritedFrom": {
87456
88213
  "name": "HelixHeadlessFormatDate",
@@ -135346,6 +136103,14 @@
135346
136103
  "module": "src/notifications/notification/notification.ts"
135347
136104
  }
135348
136105
  },
136106
+ {
136107
+ "description": "Format Date's `fractional-second`, forwarded for a time drawn as fields. An elapsed time draws none.",
136108
+ "name": "time-fractional-second",
136109
+ "inheritedFrom": {
136110
+ "name": "HelixHeadlessNotification",
136111
+ "module": "src/notifications/notification/notification.ts"
136112
+ }
136113
+ },
135349
136114
  {
135350
136115
  "description": "Format Date's `hour`, forwarded for a time drawn as fields. An elapsed time draws none.",
135351
136116
  "name": "time-hour",
@@ -175926,6 +176691,19 @@
175926
176691
  "module": "src/slider/root/slider-root.ts"
175927
176692
  }
175928
176693
  },
176694
+ {
176695
+ "kind": "field",
176696
+ "name": "pageStep",
176697
+ "type": {
176698
+ "text": "number | undefined"
176699
+ },
176700
+ "description": "How far Page Up and Page Down move a thumb, in the slider's own units, as\nReact Aria's `pageSize` and Zag's `largeStep` do. Absent leaves the keys\nto the platform, which moves a tenth of the track.",
176701
+ "attribute": "page-step",
176702
+ "inheritedFrom": {
176703
+ "name": "HelixHeadlessSlider",
176704
+ "module": "src/slider/root/slider-root.ts"
176705
+ }
176706
+ },
175929
176707
  {
175930
176708
  "kind": "field",
175931
176709
  "name": "range",
@@ -176171,6 +176949,143 @@
176171
176949
  "module": "src/slider/root/slider-root.ts"
176172
176950
  }
176173
176951
  },
176952
+ {
176953
+ "kind": "field",
176954
+ "name": "dragging",
176955
+ "type": {
176956
+ "text": "boolean"
176957
+ },
176958
+ "privacy": "private",
176959
+ "default": "false",
176960
+ "description": "Whether a pointer is dragging a thumb, which `:state(dragging)` says.",
176961
+ "inheritedFrom": {
176962
+ "name": "HelixHeadlessSlider",
176963
+ "module": "src/slider/root/slider-root.ts"
176964
+ }
176965
+ },
176966
+ {
176967
+ "kind": "field",
176968
+ "name": "endDrag",
176969
+ "privacy": "private",
176970
+ "readonly": true,
176971
+ "description": "Ends a drag when its pointer lifts, wherever it lifts.",
176972
+ "inheritedFrom": {
176973
+ "name": "HelixHeadlessSlider",
176974
+ "module": "src/slider/root/slider-root.ts"
176975
+ }
176976
+ },
176977
+ {
176978
+ "kind": "method",
176979
+ "name": "startDrag",
176980
+ "privacy": "private",
176981
+ "return": {
176982
+ "type": {
176983
+ "text": "void"
176984
+ }
176985
+ },
176986
+ "inheritedFrom": {
176987
+ "name": "HelixHeadlessSlider",
176988
+ "module": "src/slider/root/slider-root.ts"
176989
+ }
176990
+ },
176991
+ {
176992
+ "kind": "method",
176993
+ "name": "thumbInset",
176994
+ "privacy": "private",
176995
+ "return": {
176996
+ "type": {
176997
+ "text": "number"
176998
+ }
176999
+ },
177000
+ "parameters": [
177001
+ {
177002
+ "name": "field",
177003
+ "type": {
177004
+ "text": "HTMLElement"
177005
+ }
177006
+ }
177007
+ ],
177008
+ "description": "Half a thumb, which is where the thumb's center stops short of each end\nof its input. Measured off the thumb's length as the stylesheet sets it,\nor a platform thumb's 16 pixels where none does.",
177009
+ "inheritedFrom": {
177010
+ "name": "HelixHeadlessSlider",
177011
+ "module": "src/slider/root/slider-root.ts"
177012
+ }
177013
+ },
177014
+ {
177015
+ "kind": "method",
177016
+ "name": "valueAt",
177017
+ "privacy": "private",
177018
+ "return": {
177019
+ "type": {
177020
+ "text": "number"
177021
+ }
177022
+ },
177023
+ "parameters": [
177024
+ {
177025
+ "name": "event",
177026
+ "type": {
177027
+ "text": "PointerEvent"
177028
+ }
177029
+ },
177030
+ {
177031
+ "name": "input",
177032
+ "type": {
177033
+ "text": "HTMLElement"
177034
+ }
177035
+ },
177036
+ {
177037
+ "name": "inset",
177038
+ "type": {
177039
+ "text": "number"
177040
+ }
177041
+ }
177042
+ ],
177043
+ "description": "The value under a pointer, along a thumb's input, less `inset` at each\nend. Upward on a vertical track, and from the right on a right-to-left\npage.",
177044
+ "inheritedFrom": {
177045
+ "name": "HelixHeadlessSlider",
177046
+ "module": "src/slider/root/slider-root.ts"
177047
+ }
177048
+ },
177049
+ {
177050
+ "kind": "method",
177051
+ "name": "moveThumb",
177052
+ "privacy": "private",
177053
+ "return": {
177054
+ "type": {
177055
+ "text": "boolean"
177056
+ }
177057
+ },
177058
+ "parameters": [
177059
+ {
177060
+ "name": "at",
177061
+ "type": {
177062
+ "text": "number"
177063
+ }
177064
+ },
177065
+ {
177066
+ "name": "wanted",
177067
+ "type": {
177068
+ "text": "number"
177069
+ }
177070
+ }
177071
+ ],
177072
+ "description": "Moves one of a range's thumbs, kept between its neighbors, and says whether it moved.",
177073
+ "inheritedFrom": {
177074
+ "name": "HelixHeadlessSlider",
177075
+ "module": "src/slider/root/slider-root.ts"
177076
+ }
177077
+ },
177078
+ {
177079
+ "kind": "field",
177080
+ "name": "handlePress",
177081
+ "privacy": "private",
177082
+ "readonly": true,
177083
+ "description": "A press on the field: on a thumb, the start of the platform's own drag,\nand on a range's track, the nearest thumb taken to the point and dragged\nfrom there.\n\n**A range's inputs take presses on their thumbs only**, being stacked on\none track, so a press beside a thumb reached no input at all and did\nnothing. Measured before this: a press at 90 on a range holding 20 and 60\nleft it at 20 and 60. React Aria's and Web Awesome's sliders move the\nnearest thumb there.",
177084
+ "inheritedFrom": {
177085
+ "name": "HelixHeadlessSlider",
177086
+ "module": "src/slider/root/slider-root.ts"
177087
+ }
177088
+ },
176174
177089
  {
176175
177090
  "kind": "field",
176176
177091
  "name": "handleChange",
@@ -176187,7 +177102,18 @@
176187
177102
  "name": "handleKeydown",
176188
177103
  "privacy": "private",
176189
177104
  "readonly": true,
176190
- "description": "Keeps a read-only thumb still under the keys that move it. Tab and every\nother key pass, so focus moves on.",
177105
+ "description": "Keeps a read-only thumb still under the keys that move it, and moves a\nthumb by `page-step` under Page Up and Page Down. Tab and every other key\npass, so focus moves on.",
177106
+ "inheritedFrom": {
177107
+ "name": "HelixHeadlessSlider",
177108
+ "module": "src/slider/root/slider-root.ts"
177109
+ }
177110
+ },
177111
+ {
177112
+ "kind": "field",
177113
+ "name": "handleFocusChange",
177114
+ "privacy": "private",
177115
+ "readonly": true,
177116
+ "description": "Says whether the keyboard brought focus to a thumb, as\n`:state(focus-visible)` on the host, where a stylesheet outside can reach\nthe whole control: a ring around the track, or the readout in bold.",
176191
177117
  "inheritedFrom": {
176192
177118
  "name": "HelixHeadlessSlider",
176193
177119
  "module": "src/slider/root/slider-root.ts"
@@ -177567,6 +178493,18 @@
177567
178493
  "module": "src/slider/root/slider-root.ts"
177568
178494
  }
177569
178495
  },
178496
+ {
178497
+ "name": "page-step",
178498
+ "type": {
178499
+ "text": "number | undefined"
178500
+ },
178501
+ "description": "How far Page Up and Page Down move a thumb, in the slider's own units, as\nReact Aria's `pageSize` and Zag's `largeStep` do. Absent leaves the keys\nto the platform, which moves a tenth of the track.",
178502
+ "fieldName": "pageStep",
178503
+ "inheritedFrom": {
178504
+ "name": "HelixHeadlessSlider",
178505
+ "module": "src/slider/root/slider-root.ts"
178506
+ }
178507
+ },
177570
178508
  {
177571
178509
  "name": "range",
177572
178510
  "type": {
@@ -177885,6 +178823,22 @@
177885
178823
  }
177886
178824
  ],
177887
178825
  "cssStates": [
178826
+ {
178827
+ "description": "A thumb is being dragged, by its thumb or from a press on the track.",
178828
+ "name": "dragging",
178829
+ "inheritedFrom": {
178830
+ "name": "HelixHeadlessSlider",
178831
+ "module": "src/slider/root/slider-root.ts"
178832
+ }
178833
+ },
178834
+ {
178835
+ "description": "A thumb has focus that the keyboard brought, where the browser draws a focus ring.",
178836
+ "name": "focus-visible",
178837
+ "inheritedFrom": {
178838
+ "name": "HelixHeadlessSlider",
178839
+ "module": "src/slider/root/slider-root.ts"
178840
+ }
178841
+ },
177888
178842
  {
177889
178843
  "description": "The slider has an error to show, from the browser's validation or from your `feedback`.",
177890
178844
  "name": "invalid",
@@ -202342,6 +203296,40 @@
202342
203296
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
202343
203297
  }
202344
203298
  },
203299
+ {
203300
+ "kind": "field",
203301
+ "name": "rangeEndLabel",
203302
+ "type": {
203303
+ "text": "string"
203304
+ },
203305
+ "default": "'End'",
203306
+ "description": "What a screen reader hears before the segments of a range's second date\nor time, after each segment's own name.",
203307
+ "attribute": "range-end-label",
203308
+ "helix": {
203309
+ "words": true
203310
+ },
203311
+ "inheritedFrom": {
203312
+ "name": "MixinSegmentedField",
203313
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
203314
+ }
203315
+ },
203316
+ {
203317
+ "kind": "field",
203318
+ "name": "rangeStartLabel",
203319
+ "type": {
203320
+ "text": "string"
203321
+ },
203322
+ "default": "'Start'",
203323
+ "description": "What a screen reader hears before the segments of a range's first date\nor time, after each segment's own name: \"month, Start, Stay\".",
203324
+ "attribute": "range-start-label",
203325
+ "helix": {
203326
+ "words": true
203327
+ },
203328
+ "inheritedFrom": {
203329
+ "name": "MixinSegmentedField",
203330
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
203331
+ }
203332
+ },
202345
203333
  {
202346
203334
  "kind": "field",
202347
203335
  "name": "segmented",
@@ -202360,11 +203348,11 @@
202360
203348
  "kind": "field",
202361
203349
  "name": "parts",
202362
203350
  "type": {
202363
- "text": "Segments"
203351
+ "text": "Segments[]"
202364
203352
  },
202365
203353
  "privacy": "private",
202366
- "default": "{}",
202367
- "description": "The parts set so far, which may be fewer than a whole value.",
203354
+ "default": "[{}]",
203355
+ "description": "The parts set so far in each row, which may be fewer than a whole\nvalue: one row, or two for a range.",
202368
203356
  "inheritedFrom": {
202369
203357
  "name": "MixinSegmentedField",
202370
203358
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
@@ -202423,6 +203411,35 @@
202423
203411
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
202424
203412
  }
202425
203413
  },
203414
+ {
203415
+ "kind": "field",
203416
+ "name": "opener",
203417
+ "type": {
203418
+ "text": "HTMLElement | undefined"
203419
+ },
203420
+ "privacy": "private",
203421
+ "default": "undefined",
203422
+ "description": "The segment Alt+Down opened the picker from, which focus goes back to.",
203423
+ "inheritedFrom": {
203424
+ "name": "MixinSegmentedField",
203425
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
203426
+ }
203427
+ },
203428
+ {
203429
+ "kind": "method",
203430
+ "name": "returnFocus",
203431
+ "privacy": "protected",
203432
+ "return": {
203433
+ "type": {
203434
+ "text": "void"
203435
+ }
203436
+ },
203437
+ "description": "Puts focus back on the segment the picker was opened from, as the\ntrigger takes it back to the field. Measured before this: Escape after\nAlt+Down on AM/PM put focus on the hour.",
203438
+ "inheritedFrom": {
203439
+ "name": "MixinPickerField",
203440
+ "module": "src/mixins/mixin-picker-field/mixin-picker-field.ts"
203441
+ }
203442
+ },
202426
203443
  {
202427
203444
  "kind": "field",
202428
203445
  "name": "segmentable",
@@ -202451,6 +203468,66 @@
202451
203468
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
202452
203469
  }
202453
203470
  },
203471
+ {
203472
+ "kind": "field",
203473
+ "name": "segmentGroups",
203474
+ "type": {
203475
+ "text": "number"
203476
+ },
203477
+ "privacy": "protected",
203478
+ "description": "How many rows of segments the value takes: two for a range, one otherwise.",
203479
+ "readonly": true,
203480
+ "inheritedFrom": {
203481
+ "name": "MixinSegmentedField",
203482
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
203483
+ }
203484
+ },
203485
+ {
203486
+ "kind": "method",
203487
+ "name": "joined",
203488
+ "privacy": "private",
203489
+ "return": {
203490
+ "type": {
203491
+ "text": "string"
203492
+ }
203493
+ },
203494
+ "parameters": [
203495
+ {
203496
+ "name": "rows",
203497
+ "type": {
203498
+ "text": "readonly Segments[]"
203499
+ }
203500
+ }
203501
+ ],
203502
+ "description": "The value the rows add up to: each row's, joined by commas, or empty while any row is not whole.",
203503
+ "inheritedFrom": {
203504
+ "name": "MixinSegmentedField",
203505
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
203506
+ }
203507
+ },
203508
+ {
203509
+ "kind": "method",
203510
+ "name": "rowsOf",
203511
+ "privacy": "private",
203512
+ "return": {
203513
+ "type": {
203514
+ "text": "Segments[]"
203515
+ }
203516
+ },
203517
+ "parameters": [
203518
+ {
203519
+ "name": "value",
203520
+ "type": {
203521
+ "text": "string"
203522
+ }
203523
+ }
203524
+ ],
203525
+ "description": "The rows a value names, one per row, empty where it names none.",
203526
+ "inheritedFrom": {
203527
+ "name": "MixinSegmentedField",
203528
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
203529
+ }
203530
+ },
202454
203531
  {
202455
203532
  "kind": "field",
202456
203533
  "name": "segmentedKind",
@@ -202493,6 +203570,20 @@
202493
203570
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
202494
203571
  }
202495
203572
  },
203573
+ {
203574
+ "kind": "field",
203575
+ "name": "segmentSystem",
203576
+ "type": {
203577
+ "text": "MonthSystem | undefined"
203578
+ },
203579
+ "privacy": "protected",
203580
+ "description": "The calendar a date's parts are counted in, or `undefined` for the Gregorian calendar.",
203581
+ "readonly": true,
203582
+ "inheritedFrom": {
203583
+ "name": "MixinSegmentedField",
203584
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
203585
+ }
203586
+ },
202496
203587
  {
202497
203588
  "kind": "field",
202498
203589
  "name": "layout",
@@ -202558,6 +203649,12 @@
202558
203649
  }
202559
203650
  },
202560
203651
  "parameters": [
203652
+ {
203653
+ "name": "row",
203654
+ "type": {
203655
+ "text": "number"
203656
+ }
203657
+ },
202561
203658
  {
202562
203659
  "name": "next",
202563
203660
  "type": {
@@ -203061,21 +204158,6 @@
203061
204158
  "module": "src/mixins/mixin-picker-field/mixin-picker-field.ts"
203062
204159
  }
203063
204160
  },
203064
- {
203065
- "kind": "method",
203066
- "name": "returnFocus",
203067
- "privacy": "protected",
203068
- "return": {
203069
- "type": {
203070
- "text": "void"
203071
- }
203072
- },
203073
- "description": "Puts the caret back in the field without the field reopening the panel.\n\nThe anchor rather than the text, which is the trigger where there is no\ntext: Color Input's swatch dropped focus to the body on Escape.",
203074
- "inheritedFrom": {
203075
- "name": "MixinPickerField",
203076
- "module": "src/mixins/mixin-picker-field/mixin-picker-field.ts"
203077
- }
203078
- },
203079
204161
  {
203080
204162
  "kind": "method",
203081
204163
  "name": "focus",
@@ -203980,6 +205062,37 @@
203980
205062
  "module": "src/time-input/root/time-input-root.ts"
203981
205063
  }
203982
205064
  },
205065
+ {
205066
+ "kind": "field",
205067
+ "name": "clearable",
205068
+ "type": {
205069
+ "text": "boolean"
205070
+ },
205071
+ "default": "false",
205072
+ "description": "Whether the field shows a button that empties it, as Input's `clearable`\ndoes. Shown only while the field holds something to clear and is neither\ndisabled nor read-only.",
205073
+ "attribute": "clearable",
205074
+ "inheritedFrom": {
205075
+ "name": "HelixHeadlessTimeInput",
205076
+ "module": "src/time-input/root/time-input-root.ts"
205077
+ }
205078
+ },
205079
+ {
205080
+ "kind": "field",
205081
+ "name": "clearLabel",
205082
+ "type": {
205083
+ "text": "string"
205084
+ },
205085
+ "default": "'Clear'",
205086
+ "description": "The accessible name of the clear button, which shows only an icon.",
205087
+ "attribute": "clear-label",
205088
+ "helix": {
205089
+ "words": true
205090
+ },
205091
+ "inheritedFrom": {
205092
+ "name": "HelixHeadlessTimeInput",
205093
+ "module": "src/time-input/root/time-input-root.ts"
205094
+ }
205095
+ },
203983
205096
  {
203984
205097
  "kind": "field",
203985
205098
  "name": "disableTimes",
@@ -204238,6 +205351,23 @@
204238
205351
  "module": "src/time-input/root/time-input-root.ts"
204239
205352
  }
204240
205353
  },
205354
+ {
205355
+ "kind": "field",
205356
+ "name": "unreadableMessage",
205357
+ "type": {
205358
+ "text": "string"
205359
+ },
205360
+ "default": "'{mode, select, single {Enter a time as {shape}.} other {Enter times as {shape}, separated by commas.}}'",
205361
+ "description": "The message for text that is no time, where `bad-input-message` is not\nset. `{mode}` is `single`, `range`, or `multiple`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.",
205362
+ "attribute": "unreadable-message",
205363
+ "helix": {
205364
+ "words": true
205365
+ },
205366
+ "inheritedFrom": {
205367
+ "name": "HelixHeadlessTimeInput",
205368
+ "module": "src/time-input/root/time-input-root.ts"
205369
+ }
205370
+ },
204241
205371
  {
204242
205372
  "kind": "field",
204243
205373
  "name": "held",
@@ -204340,6 +205470,40 @@
204340
205470
  "module": "src/time-input/root/time-input-root.ts"
204341
205471
  }
204342
205472
  },
205473
+ {
205474
+ "kind": "method",
205475
+ "name": "read",
205476
+ "privacy": "private",
205477
+ "return": {
205478
+ "type": {
205479
+ "text": "string"
205480
+ }
205481
+ },
205482
+ "parameters": [
205483
+ {
205484
+ "name": "text",
205485
+ "type": {
205486
+ "text": "string"
205487
+ }
205488
+ }
205489
+ ],
205490
+ "description": "A time as the reader wrote it, as the value writes one: `HH:mm` as it\nis, and `2:30 PM`, `2.30pm`, `14h30`, or `1430` read back, with the half\nof the day in the locale's words. Empty where it is no time.",
205491
+ "inheritedFrom": {
205492
+ "name": "HelixHeadlessTimeInput",
205493
+ "module": "src/time-input/root/time-input-root.ts"
205494
+ }
205495
+ },
205496
+ {
205497
+ "kind": "field",
205498
+ "name": "handleTextCommit",
205499
+ "privacy": "private",
205500
+ "readonly": true,
205501
+ "description": "The text the reader leaves, read: a time written as a reader writes one\nbecomes the value as the field commits. Not on each key, where `2:3` is\na time a moment before it is `2:30`.",
205502
+ "inheritedFrom": {
205503
+ "name": "HelixHeadlessTimeInput",
205504
+ "module": "src/time-input/root/time-input-root.ts"
205505
+ }
205506
+ },
204343
205507
  {
204344
205508
  "kind": "field",
204345
205509
  "name": "handleDraftKey",
@@ -204474,6 +205638,46 @@
204474
205638
  "module": "src/time-input/root/time-input-root.ts"
204475
205639
  }
204476
205640
  },
205641
+ {
205642
+ "kind": "field",
205643
+ "name": "showsClear",
205644
+ "type": {
205645
+ "text": "boolean"
205646
+ },
205647
+ "privacy": "private",
205648
+ "description": "Whether there is a clear button on screen right now.",
205649
+ "readonly": true,
205650
+ "inheritedFrom": {
205651
+ "name": "HelixHeadlessTimeInput",
205652
+ "module": "src/time-input/root/time-input-root.ts"
205653
+ }
205654
+ },
205655
+ {
205656
+ "kind": "field",
205657
+ "name": "handleClear",
205658
+ "privacy": "private",
205659
+ "readonly": true,
205660
+ "description": "Empties the field, through `requestValue` so a consumer who owns the\nvalue decides, then says `change` and `helix-clear` and puts focus back\nin the field, the button having gone.",
205661
+ "inheritedFrom": {
205662
+ "name": "HelixHeadlessTimeInput",
205663
+ "module": "src/time-input/root/time-input-root.ts"
205664
+ }
205665
+ },
205666
+ {
205667
+ "kind": "method",
205668
+ "name": "renderClearIcon",
205669
+ "privacy": "protected",
205670
+ "return": {
205671
+ "type": {
205672
+ "text": "TemplateResult"
205673
+ }
205674
+ },
205675
+ "description": "The cross on the clear button, behind a seam a tier can move.",
205676
+ "inheritedFrom": {
205677
+ "name": "HelixHeadlessTimeInput",
205678
+ "module": "src/time-input/root/time-input-root.ts"
205679
+ }
205680
+ },
204477
205681
  {
204478
205682
  "kind": "method",
204479
205683
  "name": "renderControl",
@@ -205363,6 +206567,32 @@
205363
206567
  "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
205364
206568
  }
205365
206569
  },
206570
+ {
206571
+ "name": "range-end-label",
206572
+ "type": {
206573
+ "text": "string"
206574
+ },
206575
+ "default": "'End'",
206576
+ "description": "What a screen reader hears before the segments of a range's second date\nor time, after each segment's own name.",
206577
+ "fieldName": "rangeEndLabel",
206578
+ "inheritedFrom": {
206579
+ "name": "MixinSegmentedField",
206580
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
206581
+ }
206582
+ },
206583
+ {
206584
+ "name": "range-start-label",
206585
+ "type": {
206586
+ "text": "string"
206587
+ },
206588
+ "default": "'Start'",
206589
+ "description": "What a screen reader hears before the segments of a range's first date\nor time, after each segment's own name: \"month, Start, Stay\".",
206590
+ "fieldName": "rangeStartLabel",
206591
+ "inheritedFrom": {
206592
+ "name": "MixinSegmentedField",
206593
+ "module": "src/mixins/mixin-segmented-field/mixin-segmented-field.ts"
206594
+ }
206595
+ },
205366
206596
  {
205367
206597
  "name": "segmented",
205368
206598
  "type": {
@@ -205606,6 +206836,32 @@
205606
206836
  "module": "src/time-input/root/time-input-root.ts"
205607
206837
  }
205608
206838
  },
206839
+ {
206840
+ "name": "clearable",
206841
+ "type": {
206842
+ "text": "boolean"
206843
+ },
206844
+ "default": "false",
206845
+ "description": "Whether the field shows a button that empties it, as Input's `clearable`\ndoes. Shown only while the field holds something to clear and is neither\ndisabled nor read-only.",
206846
+ "fieldName": "clearable",
206847
+ "inheritedFrom": {
206848
+ "name": "HelixHeadlessTimeInput",
206849
+ "module": "src/time-input/root/time-input-root.ts"
206850
+ }
206851
+ },
206852
+ {
206853
+ "name": "clear-label",
206854
+ "type": {
206855
+ "text": "string"
206856
+ },
206857
+ "default": "'Clear'",
206858
+ "description": "The accessible name of the clear button, which shows only an icon.",
206859
+ "fieldName": "clearLabel",
206860
+ "inheritedFrom": {
206861
+ "name": "HelixHeadlessTimeInput",
206862
+ "module": "src/time-input/root/time-input-root.ts"
206863
+ }
206864
+ },
205609
206865
  {
205610
206866
  "name": "disable-times",
205611
206867
  "type": {
@@ -205812,6 +207068,19 @@
205812
207068
  "module": "src/time-input/root/time-input-root.ts"
205813
207069
  }
205814
207070
  },
207071
+ {
207072
+ "name": "unreadable-message",
207073
+ "type": {
207074
+ "text": "string"
207075
+ },
207076
+ "default": "'{mode, select, single {Enter a time as {shape}.} other {Enter times as {shape}, separated by commas.}}'",
207077
+ "description": "The message for text that is no time, where `bad-input-message` is not\nset. `{mode}` is `single`, `range`, or `multiple`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.",
207078
+ "fieldName": "unreadableMessage",
207079
+ "inheritedFrom": {
207080
+ "name": "HelixHeadlessTimeInput",
207081
+ "module": "src/time-input/root/time-input-root.ts"
207082
+ }
207083
+ },
205815
207084
  {
205816
207085
  "name": "variant",
205817
207086
  "type": {
@@ -205912,6 +207181,18 @@
205912
207181
  "module": "src/time-input/root/time-input-root.ts"
205913
207182
  }
205914
207183
  },
207184
+ {
207185
+ "type": {
207186
+ "text": "HelixClearEvent"
207187
+ },
207188
+ "description": "Fired after the clear button has emptied the field, after `input` and `change`.",
207189
+ "name": "helix-clear",
207190
+ "reactProp": "onhelix-clear",
207191
+ "inheritedFrom": {
207192
+ "name": "HelixHeadlessTimeInput",
207193
+ "module": "src/time-input/root/time-input-root.ts"
207194
+ }
207195
+ },
205915
207196
  {
205916
207197
  "type": {
205917
207198
  "text": "Event"
@@ -205926,6 +207207,14 @@
205926
207207
  }
205927
207208
  ],
205928
207209
  "slots": [
207210
+ {
207211
+ "description": "Replaces the cross on the clear button, under `clearable`.",
207212
+ "name": "clear-icon",
207213
+ "inheritedFrom": {
207214
+ "name": "HelixHeadlessTimeInput",
207215
+ "module": "src/time-input/root/time-input-root.ts"
207216
+ }
207217
+ },
205929
207218
  {
205930
207219
  "description": "Content after the time, before the trigger, such as a clear button.",
205931
207220
  "name": "end",
@@ -205992,6 +207281,14 @@
205992
207281
  }
205993
207282
  ],
205994
207283
  "cssParts": [
207284
+ {
207285
+ "description": "The button that empties the field, under `clearable`, while it holds a time.",
207286
+ "name": "clear",
207287
+ "inheritedFrom": {
207288
+ "name": "HelixHeadlessTimeInput",
207289
+ "module": "src/time-input/root/time-input-root.ts"
207290
+ }
207291
+ },
205995
207292
  {
205996
207293
  "description": "The text input.",
205997
207294
  "name": "control",
@@ -206352,6 +207649,14 @@
206352
207649
  "module": "src/time-input/root/time-input-root.ts"
206353
207650
  }
206354
207651
  },
207652
+ {
207653
+ "description": "The dash between a range's two rows of segments, in `segmented`, beside `literal`.",
207654
+ "name": "range-separator",
207655
+ "inheritedFrom": {
207656
+ "name": "HelixHeadlessTimeInput",
207657
+ "module": "src/time-input/root/time-input-root.ts"
207658
+ }
207659
+ },
206355
207660
  {
206356
207661
  "description": "The count of times held beyond the ones shown. A `<button>` with `expandable`, and a `<span>` without it.",
206357
207662
  "name": "rest",
@@ -206474,6 +207779,14 @@
206474
207779
  }
206475
207780
  ],
206476
207781
  "cssStates": [
207782
+ {
207783
+ "description": "The field holds no time.",
207784
+ "name": "blank",
207785
+ "inheritedFrom": {
207786
+ "name": "HelixHeadlessTimeInput",
207787
+ "module": "src/time-input/root/time-input-root.ts"
207788
+ }
207789
+ },
206477
207790
  {
206478
207791
  "description": "The control has an error to show, from the browser's validation or from your `feedback`.",
206479
207792
  "name": "invalid",
@@ -206659,6 +207972,20 @@
206659
207972
  "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
206660
207973
  }
206661
207974
  },
207975
+ {
207976
+ "kind": "field",
207977
+ "name": "touched",
207978
+ "type": {
207979
+ "text": "boolean"
207980
+ },
207981
+ "privacy": "private",
207982
+ "default": "false",
207983
+ "description": "Whether the reader has committed an answer, or a form has refused the\npicker. A reset forgets it.",
207984
+ "inheritedFrom": {
207985
+ "name": "MixinPickerFeedback",
207986
+ "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
207987
+ }
207988
+ },
206662
207989
  {
206663
207990
  "kind": "field",
206664
207991
  "name": "marked",
@@ -206666,13 +207993,44 @@
206666
207993
  "text": "boolean"
206667
207994
  },
206668
207995
  "privacy": "protected",
206669
- "description": "Whether a reader is told the answer is wrong: `invalid`, or `feedback`.",
207996
+ "description": "Whether a reader is told the answer is wrong: `invalid`, `feedback`, a\nheld answer the picker refuses, or a missing answer once the reader has\ncommitted one or a form has refused the picker.\n\n**A refused answer is marked at once, and a missing one waits**, as\nChromium's tree does for native controls: a time input holding a time\npast its `max` reports invalid on load, and an empty required text field\ndoes not, since the reader already hears that it is required. Measured\nbefore this on Time Picker: `value=\"13:00\" max=\"12:00\"` reported\n`rangeOverflow` while the list said nothing and `:state(invalid)` was off.",
207997
+ "readonly": true,
207998
+ "inheritedFrom": {
207999
+ "name": "MixinPickerFeedback",
208000
+ "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
208001
+ }
208002
+ },
208003
+ {
208004
+ "kind": "field",
208005
+ "name": "failure",
208006
+ "type": {
208007
+ "text": "'missing' | 'refused' | undefined"
208008
+ },
208009
+ "privacy": "protected",
208010
+ "description": "What the picker's own validation finds: `missing`, `refused`, or\nnothing, which is what a picker that does not answer it reports.",
206670
208011
  "readonly": true,
206671
208012
  "inheritedFrom": {
206672
208013
  "name": "MixinPickerFeedback",
206673
208014
  "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
206674
208015
  }
206675
208016
  },
208017
+ {
208018
+ "kind": "method",
208019
+ "name": "formResetCallback",
208020
+ "return": {
208021
+ "type": {
208022
+ "text": "void"
208023
+ }
208024
+ },
208025
+ "description": "Returns the control to its `defaultValue`, or to its `value` attribute\nwhere there is no `default-value`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value.",
208026
+ "inheritedFrom": {
208027
+ "name": "HelixFormElement",
208028
+ "module": "src/helix-form-element/helix-form-element.ts"
208029
+ },
208030
+ "type": {
208031
+ "text": "formResetCallback() => void"
208032
+ }
208033
+ },
206676
208034
  {
206677
208035
  "kind": "method",
206678
208036
  "name": "renderPickerFeedback",
@@ -206798,23 +208156,6 @@
206798
208156
  "module": "src/mixins/mixin-controller-value/mixin-controller-value.ts"
206799
208157
  }
206800
208158
  },
206801
- {
206802
- "kind": "method",
206803
- "name": "formResetCallback",
206804
- "return": {
206805
- "type": {
206806
- "text": "void"
206807
- }
206808
- },
206809
- "description": "Returns the control to its `defaultValue`, or to its `value` attribute\nwhere there is no `default-value`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value.",
206810
- "inheritedFrom": {
206811
- "name": "HelixFormElement",
206812
- "module": "src/helix-form-element/helix-form-element.ts"
206813
- },
206814
- "type": {
206815
- "text": "formResetCallback() => void"
206816
- }
206817
- },
206818
208159
  {
206819
208160
  "kind": "method",
206820
208161
  "name": "formStateRestoreCallback",
@@ -207312,6 +208653,40 @@
207312
208653
  "module": "src/time-picker/root/time-picker-root.ts"
207313
208654
  }
207314
208655
  },
208656
+ {
208657
+ "kind": "field",
208658
+ "name": "previewed",
208659
+ "type": {
208660
+ "text": "string"
208661
+ },
208662
+ "privacy": "private",
208663
+ "default": "''",
208664
+ "description": "The time under the pointer while a range holds one end, which the list\nbands the range to before it is chosen, as Date Picker does.",
208665
+ "inheritedFrom": {
208666
+ "name": "HelixHeadlessTimePicker",
208667
+ "module": "src/time-picker/root/time-picker-root.ts"
208668
+ }
208669
+ },
208670
+ {
208671
+ "kind": "field",
208672
+ "name": "handleListHover",
208673
+ "privacy": "private",
208674
+ "readonly": true,
208675
+ "inheritedFrom": {
208676
+ "name": "HelixHeadlessTimePicker",
208677
+ "module": "src/time-picker/root/time-picker-root.ts"
208678
+ }
208679
+ },
208680
+ {
208681
+ "kind": "field",
208682
+ "name": "handleListLeave",
208683
+ "privacy": "private",
208684
+ "readonly": true,
208685
+ "inheritedFrom": {
208686
+ "name": "HelixHeadlessTimePicker",
208687
+ "module": "src/time-picker/root/time-picker-root.ts"
208688
+ }
208689
+ },
207315
208690
  {
207316
208691
  "kind": "method",
207317
208692
  "name": "between",
@@ -207329,7 +208704,7 @@
207329
208704
  }
207330
208705
  }
207331
208706
  ],
207332
- "description": "Whether a time falls inside a range, which is what gets banded.",
208707
+ "description": "Whether a time falls inside a range, which is what gets banded: the\nchosen range, or while one end waits, the run to the time under the\npointer.",
207333
208708
  "inheritedFrom": {
207334
208709
  "name": "HelixHeadlessTimePicker",
207335
208710
  "module": "src/time-picker/root/time-picker-root.ts"
@@ -207593,6 +208968,20 @@
207593
208968
  "module": "src/time-picker/root/time-picker-root.ts"
207594
208969
  }
207595
208970
  },
208971
+ {
208972
+ "kind": "field",
208973
+ "name": "problem",
208974
+ "type": {
208975
+ "text": "[ValidityStateFlags, string] | undefined"
208976
+ },
208977
+ "privacy": "private",
208978
+ "description": "What is wrong with the answer, as validity flags and a message, or nothing.\n`reportRequired` hands it to the form, and `failure` to the mark.",
208979
+ "readonly": true,
208980
+ "inheritedFrom": {
208981
+ "name": "HelixHeadlessTimePicker",
208982
+ "module": "src/time-picker/root/time-picker-root.ts"
208983
+ }
208984
+ },
207596
208985
  {
207597
208986
  "kind": "method",
207598
208987
  "name": "report",
@@ -209375,7 +210764,7 @@
209375
210764
  }
209376
210765
  },
209377
210766
  {
209378
- "description": "One time in the list. It carries `data-between` inside a range.",
210767
+ "description": "One time in the list. It carries `data-between` inside a range, and inside the run to the time under the pointer while a range waits for its second end.",
209379
210768
  "name": "option",
209380
210769
  "inheritedFrom": {
209381
210770
  "name": "HelixHeadlessTimePicker",
@@ -209487,13 +210876,21 @@
209487
210876
  }
209488
210877
  },
209489
210878
  {
209490
- "description": "While `invalid` is set or `feedback` says what is wrong.",
210879
+ "description": "While `invalid` is set, `feedback` says what is wrong, or the list carries `aria-invalid`.",
209491
210880
  "name": "invalid",
209492
210881
  "inheritedFrom": {
209493
210882
  "name": "HelixHeadlessTimePicker",
209494
210883
  "module": "src/time-picker/root/time-picker-root.ts"
209495
210884
  }
209496
210885
  },
210886
+ {
210887
+ "description": "While a `range` holds its first time and waits for the second.",
210888
+ "name": "range-pending",
210889
+ "inheritedFrom": {
210890
+ "name": "HelixHeadlessTimePicker",
210891
+ "module": "src/time-picker/root/time-picker-root.ts"
210892
+ }
210893
+ },
209497
210894
  {
209498
210895
  "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
209499
210896
  "name": "settled",
@@ -214388,6 +215785,18 @@
214388
215785
  "module": "src/toggle/group/toggle-group.ts"
214389
215786
  }
214390
215787
  },
215788
+ {
215789
+ "kind": "field",
215790
+ "name": "marked",
215791
+ "privacy": "private",
215792
+ "readonly": true,
215793
+ "default": "new WeakSet<HelixHeadlessToggle>()",
215794
+ "description": "The items whose `selected` this group has written, which `adopt` passes\nover: the mark is this group's answer, and the markup declared nothing.\n\nMeasured before this: in a group with no default, choosing List and then\nresetting the form left List chosen and submitted, because `adopt` read\nthe mark `sync` had put on it as a declaration and made it the default.",
215795
+ "inheritedFrom": {
215796
+ "name": "HelixHeadlessToggleGroup",
215797
+ "module": "src/toggle/group/toggle-group.ts"
215798
+ }
215799
+ },
214391
215800
  {
214392
215801
  "kind": "method",
214393
215802
  "name": "sync",
@@ -214470,6 +215879,20 @@
214470
215879
  "module": "src/toggle/group/toggle-group.ts"
214471
215880
  }
214472
215881
  },
215882
+ {
215883
+ "kind": "field",
215884
+ "name": "allowEmptySelection",
215885
+ "type": {
215886
+ "text": "boolean"
215887
+ },
215888
+ "default": "false",
215889
+ "description": "Whether a press on the chosen item, or Space or Enter on it, takes it\nback so nothing is chosen, as React Aria's `ToggleButtonGroup` and\nRadix's `ToggleGroup` do in a single group. Absent, a single group always\nkeeps its choice once it has one, as a radio group does. A multiple group\nreleases a pressed item either way.",
215890
+ "attribute": "allow-empty-selection",
215891
+ "inheritedFrom": {
215892
+ "name": "HelixHeadlessToggleGroup",
215893
+ "module": "src/toggle/group/toggle-group.ts"
215894
+ }
215895
+ },
214473
215896
  {
214474
215897
  "kind": "field",
214475
215898
  "name": "focusable",
@@ -215572,6 +216995,19 @@
215572
216995
  "module": "src/mixins/mixin-field/mixin-field.ts"
215573
216996
  }
215574
216997
  },
216998
+ {
216999
+ "name": "allow-empty-selection",
217000
+ "type": {
217001
+ "text": "boolean"
217002
+ },
217003
+ "default": "false",
217004
+ "description": "Whether a press on the chosen item, or Space or Enter on it, takes it\nback so nothing is chosen, as React Aria's `ToggleButtonGroup` and\nRadix's `ToggleGroup` do in a single group. Absent, a single group always\nkeeps its choice once it has one, as a radio group does. A multiple group\nreleases a pressed item either way.",
217005
+ "fieldName": "allowEmptySelection",
217006
+ "inheritedFrom": {
217007
+ "name": "HelixHeadlessToggleGroup",
217008
+ "module": "src/toggle/group/toggle-group.ts"
217009
+ }
217010
+ },
215575
217011
  {
215576
217012
  "name": "label-placement",
215577
217013
  "type": {
@@ -216475,7 +217911,7 @@
216475
217911
  ],
216476
217912
  "cssStates": [
216477
217913
  {
216478
- "description": "The item is pressed, in a group where several can be.",
217914
+ "description": "The item is pressed, on its own or in a group where several can be.",
216479
217915
  "name": "pressed",
216480
217916
  "inheritedFrom": {
216481
217917
  "name": "HelixHeadlessToggle",
@@ -234747,6 +236183,6 @@
234747
236183
  ],
234748
236184
  "helix": {
234749
236185
  "package": "@fusion.dev/helix",
234750
- "version": "0.159.0"
236186
+ "version": "0.160.0"
234751
236187
  }
234752
236188
  }