@fusion.dev/helix-core 0.159.0 → 0.160.0

package/custom-elements.json

@@ -14401,6 +14401,14 @@
             "module": "./mixins/mixin-picker-feedback/mixin-picker-feedback.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "PickerFailure",
+          "declaration": {
+            "name": "PickerFailure",
+            "module": "./mixins/mixin-picker-feedback/mixin-picker-feedback.js"
+          }
+        },
         {
           "kind": "js",
           "name": "MixinPickerField",
@@ -14601,6 +14609,14 @@
             "module": "./utils/calendar/calendar.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "CalendarParts",
+          "declaration": {
+            "name": "CalendarParts",
+            "module": "./utils/calendar/calendar.js"
+          }
+        },
         {
           "kind": "js",
           "name": "CalendarView",
@@ -15153,6 +15169,22 @@
             "module": "./utils/data-options/data-options.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "readWrittenDate",
+          "declaration": {
+            "name": "readWrittenDate",
+            "module": "./utils/date-segments/date-segments.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readWrittenTime",
+          "declaration": {
+            "name": "readWrittenTime",
+            "module": "./utils/date-segments/date-segments.js"
+          }
+        },
         {
           "kind": "js",
           "name": "segmentName",
@@ -20436,7 +20468,17 @@
                 "text": "boolean"
               },
               "privacy": "protected",
-              "description": "Whether a reader is told the answer is wrong: `invalid`, or `feedback`.",
+              "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.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "failure",
+              "type": {
+                "text": "'missing' | 'refused' | undefined"
+              },
+              "privacy": "protected",
+              "description": "What the picker's own validation finds: `missing` for a required picker\nwith nothing chosen, `refused` for an answer it holds and refuses, or\nnothing. Read in `willUpdate`, so a picker answers it from its properties.",
               "readonly": true
             },
             {
@@ -20479,6 +20521,16 @@
               "attribute": "invalid",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "touched",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the reader has committed an answer, or a form has refused the\npicker. A reset forgets it."
+            },
             {
               "kind": "field",
               "name": "marked",
@@ -20486,9 +20538,28 @@
                 "text": "boolean"
               },
               "privacy": "protected",
-              "description": "Whether a reader is told the answer is wrong: `invalid`, or `feedback`.",
+              "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.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "failure",
+              "type": {
+                "text": "'missing' | 'refused' | undefined"
+              },
+              "privacy": "protected",
+              "description": "What the picker's own validation finds: `missing`, `refused`, or\nnothing, which is what a picker that does not answer it reports.",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "formResetCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "renderPickerFeedback",
@@ -21084,6 +21155,22 @@
               },
               "description": "Whether the field is a row of segments, one for each part of the date or\ntime, in place of a line of text."
             },
+            {
+              "kind": "field",
+              "name": "rangeStartLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "What a screen reader hears before the segments of a range's first date or\ntime, after each segment's own name."
+            },
+            {
+              "kind": "field",
+              "name": "rangeEndLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "What a screen reader hears before the segments of a range's second date or time."
+            },
             {
               "kind": "field",
               "name": "segmentsShown",
@@ -21094,6 +21181,16 @@
               "description": "Whether the segments are drawn: `segmented`, where the family can hold them.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "segmentGroups",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "protected",
+              "description": "How many rows of segments the value takes: two for a range, one otherwise.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "segmentGroup",
@@ -21144,6 +21241,16 @@
               "description": "The clock and the seconds a time is laid out with.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "segmentSystem",
+              "type": {
+                "text": "MonthSystem | undefined"
+              },
+              "privacy": "protected",
+              "description": "The calendar a date's parts are counted in, or `undefined` for the Gregorian calendar.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "renderSegments",
@@ -21212,6 +21319,32 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "rangeEndLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'End'",
+              "description": "What a screen reader hears before the segments of a range's second date\nor time, after each segment's own name.",
+              "attribute": "range-end-label",
+              "helix": {
+                "words": true
+              }
+            },
+            {
+              "kind": "field",
+              "name": "rangeStartLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Start'",
+              "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\".",
+              "attribute": "range-start-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "segmented",
@@ -21226,11 +21359,11 @@
               "kind": "field",
               "name": "parts",
               "type": {
-                "text": "Segments"
+                "text": "Segments[]"
               },
               "privacy": "private",
-              "default": "{}",
-              "description": "The parts set so far, which may be fewer than a whole value."
+              "default": "[{}]",
+              "description": "The parts set so far in each row, which may be fewer than a whole\nvalue: one row, or two for a range."
             },
             {
               "kind": "field",
@@ -21269,6 +21402,27 @@
               "default": "undefined",
               "description": "The value when focus came into the segments, so leaving them says `change` once."
             },
+            {
+              "kind": "field",
+              "name": "opener",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "The segment Alt+Down opened the picker from, which focus goes back to."
+            },
+            {
+              "kind": "method",
+              "name": "returnFocus",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "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."
+            },
             {
               "kind": "field",
               "name": "segmentable",
@@ -21289,6 +21443,54 @@
               "description": "Whether the segments are drawn: `segmented`, where the family can hold them.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "segmentGroups",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "protected",
+              "description": "How many rows of segments the value takes: two for a range, one otherwise.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "joined",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "rows",
+                  "type": {
+                    "text": "readonly Segments[]"
+                  }
+                }
+              ],
+              "description": "The value the rows add up to: each row's, joined by commas, or empty while any row is not whole."
+            },
+            {
+              "kind": "method",
+              "name": "rowsOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Segments[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The rows a value names, one per row, empty where it names none."
+            },
             {
               "kind": "field",
               "name": "segmentedKind",
@@ -21319,6 +21521,16 @@
               "description": "The clock and the seconds a time is laid out with.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "segmentSystem",
+              "type": {
+                "text": "MonthSystem | undefined"
+              },
+              "privacy": "protected",
+              "description": "The calendar a date's parts are counted in, or `undefined` for the Gregorian calendar.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "layout",
@@ -21368,6 +21580,12 @@
                 }
               },
               "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "number"
+                  }
+                },
                 {
                   "name": "next",
                   "type": {
@@ -21488,6 +21706,24 @@
               "description": "What a row of segments reports while some segments are set and others\nare not, where `bad-input-message` is not set. `{kind}` is `date` or\n`time`.",
               "fieldName": "incompleteMessage"
             },
+            {
+              "name": "range-end-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'End'",
+              "description": "What a screen reader hears before the segments of a range's second date\nor time, after each segment's own name.",
+              "fieldName": "rangeEndLabel"
+            },
+            {
+              "name": "range-start-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Start'",
+              "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\".",
+              "fieldName": "rangeStartLabel"
+            },
             {
               "name": "segmented",
               "type": {
@@ -23880,7 +24116,7 @@
               "default": "''"
             }
           ],
-          "description": "The language tag a date family formats with: `locale`, with the calendar it\nwrites dates in.\n\nThat is `calendar` where it is one of the five `DateCalendar` names, then\nthe locale's own calendar where its months are the Gregorian months, then\n`gregory`. **A calendar with months of its own, such as `persian` for `fa-IR`\nor `islamic-umalqura` for `ar-SA` in some engines, is written as `gregory`.**\nThe arithmetic is Gregorian, so a heading in Mehr 1405 over the days of\nOctober 2026 named a month the grid did not show.\n\n`locale` unchanged where nothing moves, so a page in a Gregorian locale\nformats exactly as it did. Empty is the runtime's own locale. A tag `Intl`\nrefuses throws, as every formatter given one does. Remembered per locale and\ncalendar, since reading a locale's calendar builds a formatter."
+          "description": "The language tag a date family formats with: `locale`, with the calendar it\nwrites dates in.\n\nThat is `calendar` where it names a `DateCalendar` or a `MonthCalendar`,\nthen the locale's own calendar where its months are the Gregorian months,\nthen `gregory`. **A calendar with months of its own that only the locale\nnames, such as `persian` for `fa-IR` or `islamic-umalqura` for `ar-SA` in\nsome engines, is written as `gregory`**, so a page that asked for no other\ncalendar keeps the Gregorian dates it had. Before the date families drew\nsuch a calendar's own months, a heading in Mehr 1405 over the days of\nOctober 2026 named a month the grid did not show.\n\n`locale` unchanged where nothing moves, so a page in a Gregorian locale\nformats exactly as it did. Empty is the runtime's own locale. A tag `Intl`\nrefuses throws, as every formatter given one does. Remembered per locale and\ncalendar, since reading a locale's calendar builds a formatter."
         },
         {
           "kind": "function",
@@ -23978,7 +24214,7 @@
           "type": {
             "text": "readonly string[]"
           },
-          "default": "[ 'coptic', 'ethiopic', 'hebrew', 'indian', 'islamic-civil', 'islamic-umalqura', 'persian', ]",
+          "default": "[ 'chinese', 'coptic', 'dangi', 'ethioaa', 'ethiopic', 'hebrew', 'indian', 'islamic', 'islamic-civil', 'islamic-rgsa', 'islamic-tbla', 'islamic-umalqura', 'persian', ]",
           "description": "The `MonthCalendar` names, for a check at run time."
         },
         {
@@ -23995,7 +24231,7 @@
               "default": "''"
             }
           ],
-          "description": "The months a calendar pages through: its own for a `MonthCalendar` name,\nand the Gregorian months for every other."
+          "description": "The days, months, and years a calendar pages through: its own for a\n`MonthCalendar` name, and the Gregorian months for every other."
         },
         {
           "kind": "function",
@@ -24104,6 +24340,10 @@
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "system",
+              "default": "GREGORIAN"
             }
           ],
           "description": "Whether a month, as its first day, lies wholly outside `min` and `max`, either of which may be empty."
@@ -24134,6 +24374,10 @@
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "system",
+              "default": "GREGORIAN"
             }
           ],
           "description": "Whether a year lies wholly outside `min` and `max`, either of which may be empty."
@@ -24148,13 +24392,13 @@
           },
           "parameters": [
             {
-              "name": "{ max, min, page, shown, today, view }",
+              "name": "{\n  max,\n  min,\n  page,\n  shown,\n  system = GREGORIAN,\n  today,\n  view,\n}",
               "type": {
                 "text": "PeriodPage"
               }
             }
           ],
-          "description": "The twelve cells of the months or the years view, in reading order: the\nmonths of `page`, or the page of years that holds it."
+          "description": "The cells of the months or the years view, in reading order: the months of\n`page`, twelve or the thirteen a calendar's year may have, or the twelve\nyears on the page that holds it."
         },
         {
           "kind": "function",
@@ -24194,9 +24438,16 @@
               "type": {
                 "text": "number"
               }
+            },
+            {
+              "name": "months",
+              "default": "() => 12",
+              "type": {
+                "text": "(year: number) => number"
+              }
             }
           ],
-          "description": "Where a key takes the tab stop in the months or the years, or `null` for a\nkey the grid leaves alone.\n\n`stop` is the month's index or the year the stop is on, `year` the year the\nmonths view shows, and `along` which way the inline keys go, as\n`periodMove` takes it. A move off the months of one year lands in the next\nor the last, and a move off a page of years turns the page."
+          "description": "Where a key takes the tab stop in the months or the years, or `null` for a\nkey the grid leaves alone.\n\n`stop` is the month's index or the year the stop is on, `year` the year the\nmonths view shows, and `along` which way the inline keys go, as\n`periodMove` takes it. A move off the months of one year lands in the next\nor the last, and a move off a page of years turns the page. `months` says\nhow many months a year has, twelve where it is not given. The page keys\nmove the months a year, to the month in the same place."
         }
       ],
       "exports": [
@@ -25803,6 +26054,13 @@
               "type": {
                 "text": "boolean"
               }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
           "description": "The lowest and highest a segment can be, as it is shown: the hour on a twelve\nhour clock is 1 to 12, and a day goes as high as its month allows."
@@ -25869,9 +26127,16 @@
               "type": {
                 "text": "boolean"
               }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
-          "description": "Sets a segment from the number shown for it, which on a twelve hour clock\nis put back together with the half of the day, and keeps the day inside its\nmonth."
+          "description": "Sets a segment from the number shown for it, which on a twelve hour clock\nis put back together with the half of the day, and keeps the month inside\nits year and the day inside its month."
         },
         {
           "kind": "function",
@@ -25908,7 +26173,17 @@
             },
             {
               "name": "thisYear",
-              "default": "new Date().getFullYear()"
+              "optional": true,
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
           "description": "A segment moved by a key's step, wrapping at its ends as a dial does, and\nstarting from where a reader would look for it when it is empty: the lowest\ngoing up, the highest going down, and this year for a year."
@@ -25951,6 +26226,13 @@
               "type": {
                 "text": "boolean"
               }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
           "description": "A digit typed into a segment, given what was typed into it already.\n\nThe digits run on while the number they make still fits and could take\nanother, so `1` then `2` in a month is December; a digit that would overflow\nstarts the number over. `advance` says the segment is full, so focus moves\non, which is React Aria's typing: `3` in a month is March and moves to the\nday, `1` waits for a second digit."
@@ -25971,7 +26253,7 @@
               }
             },
             {
-              "name": "{ kind, locale, segments, twelve, typed }",
+              "name": "{ kind, locale, segments, system, twelve, typed }",
               "type": {
                 "text": "SegmentKeyState"
               }
@@ -25999,9 +26281,16 @@
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
-          "description": "The segments a value names, or none where it names nothing whole."
+          "description": "The segments a value names, or none where it names nothing whole: a date's\nyear, month, and day as `system` counts them, Gregorian where none is given."
         },
         {
           "kind": "function",
@@ -26029,6 +26318,13 @@
               "type": {
                 "text": "readonly SegmentSlot[]"
               }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
           "description": "The value the segments add up to, or the empty string while any segment the\nlayout shows is unset.\n\nA date that does not exist, the thirtieth of February, cannot be reached,\nthe day being kept inside its month as it is set."
@@ -26059,6 +26355,13 @@
               "type": {
                 "text": "readonly SegmentSlot[]"
               }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
           "description": "Whether a reader has set some segments and not all of them."
@@ -26131,9 +26434,16 @@
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
             }
           ],
-          "description": "What a screen reader hears for a segment's value: what it shows, and for a\nmonth its name as well, \"8 – August\", which is React Aria's reading. A\nmonth heard as a number alone leaves a reader counting."
+          "description": "What a screen reader hears for a segment's value: what it shows, and for a\nmonth its name as well, \"8 – August\", which is React Aria's reading. A\nmonth heard as a number alone leaves a reader counting. In a calendar with\nmonths of its own, the name is that calendar's month in the year the\nsegments hold, or in this year: \"7 – Mehr\"."
         },
         {
           "kind": "function",
@@ -26158,6 +26468,65 @@
             }
           ],
           "description": "What a locale calls a segment, such as \"month\" or \"AM/PM\", from `Intl`."
+        },
+        {
+          "kind": "function",
+          "name": "readWrittenDate",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "system",
+              "optional": true,
+              "type": {
+                "text": "MonthSystem"
+              }
+            }
+          ],
+          "description": "The date a reader wrote in the order and the digits of `locale`, as\n`YYYY-MM-DD`, or empty where it is no date.\n\n`8/4/2026` in `en-US` and `4.8.2026` in `de-DE` are August 4, 2026, and a\nmonth written as a word, `Aug 4, 2026` or `4. August 2026`, is read by its\nname in the Gregorian calendar. A first number of four digits is a year,\nas ISO writes it. A year of two digits is the nearest year within eighty\nyears back and twenty forward. `Intl` formats and does not parse, so this\nreads the numbers back in the order `segmentLayout` finds the locale\nwriting them. Under `system`, the numbers are that calendar's year, month,\nand day."
+        },
+        {
+          "kind": "function",
+          "name": "readWrittenTime",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "seconds",
+              "default": "false"
+            }
+          ],
+          "description": "The time a reader wrote, as `HH:mm`, or `HH:mm:ss` with `seconds`, or empty\nwhere it is no time.\n\nReads `2:30 PM`, `2.30pm`, `14h30`, and `3 pm` alike, with the half of the\nday in the locale's own words or as `am` and `pm`, and digits in the\nlocale's own script."
         }
       ],
       "exports": [
@@ -26272,6 +26641,22 @@
             "name": "segmentName",
             "module": "src/utils/date-segments/date-segments.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "readWrittenDate",
+          "declaration": {
+            "name": "readWrittenDate",
+            "module": "src/utils/date-segments/date-segments.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readWrittenTime",
+          "declaration": {
+            "name": "readWrittenTime",
+            "module": "src/utils/date-segments/date-segments.ts"
+          }
         }
       ]
     },
@@ -32474,7 +32859,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.159.0'",
+          "default": "'0.160.0'",
           "description": "The version of the package this file ships in.\n\n**Written by `fusion/scripts/version.mjs`** wherever it writes the package's\n`package.json`, and stamped back into the repository beside it after a\nrelease, so the two never disagree; a spec beside this holds them to it.\nNothing else in the running code knows which release it is."
         }
       ],
@@ -33034,6 +33419,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.159.0"
+    "version": "0.160.0"
   }
 }