@fusion.dev/helix-core 0.159.0 → 0.161.0

package/custom-elements.json

@@ -5977,6 +5977,25 @@
               },
               "description": "Whether the reader is scrolling: a finger is on the box, the box moved\nwithin the last 150 milliseconds, or it has moved and its `scroll` event\nhas not arrived yet.\n\nFor a host that holds its own reader: a write to the scroll offset while\nthis is true ends a fling on iOS, and a reader position noted before the\nlast move is out of date."
             },
+            {
+              "kind": "method",
+              "name": "noteClamp",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "box",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Takes the offset as the box's own where the box moved it up only because\nthe set below it got shorter, which the browser does to keep the offset\ninside the content, and answers where it was before.\n\n**Not a reader scrolling.** Rows at the end of the set measured shorter\nthan their estimates shrink the content, and the box pulls its offset back\nto the new bottom before any `scroll` event arrives. Read as a scroll, the\ndifference went into the spacer as drift and was then paid a second time:\nin Chromium, End on 2,000 rows of one to five lines left the window 292\npixels above the last item, which stayed drawn below the box as the row\nholding focus."
+            },
             {
               "kind": "field",
               "name": "rest",
@@ -6091,6 +6110,17 @@
               },
               "description": "How tall one item is on the straight line: the drawn rows' height once\nread, and `estimate` until then.\n\n**An estimate that is wrong on the straight line leaves the end of the\nset out of reach.** Rows of 21 pixels placed at 32 fill two thirds of the\nroom they are counted for, so the window stops short of the bottom of the\nbox and the spacer after it holds the rest: in Chromium, `scrollToIndex`\non the last of 5,000 such rows scrolled to the end and drew nothing there.\nReading the drawn rows once corrects the slope, and it is still a line."
             },
+            {
+              "kind": "method",
+              "name": "gap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "description": "The space the host draws between two items, which each item counts."
+            },
             {
               "kind": "method",
               "name": "sampleRows",
@@ -14401,6 +14431,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 +14639,14 @@
             "module": "./utils/calendar/calendar.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "CalendarParts",
+          "declaration": {
+            "name": "CalendarParts",
+            "module": "./utils/calendar/calendar.js"
+          }
+        },
         {
           "kind": "js",
           "name": "CalendarView",
@@ -15153,6 +15199,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",
@@ -18451,9 +18513,16 @@
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "cause",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ],
-              "description": "Requests a new current item, and returns whether the change was applied."
+              "description": "Requests a new current item, and returns whether the change was applied.\n`cause` says why, where the family names its causes, and reaches\n`helix-before-activate` as `detail.cause`."
             },
             {
               "kind": "method",
@@ -18525,9 +18594,16 @@
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "cause",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ],
-              "description": "Requests a new current item, and returns whether the change was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-activate` is\na refusal and nothing moves. Unlike a native control, nothing has moved\nby the time this runs, so refusing is simply not writing: there is\nnothing to put back. Nobody refusing means the set updates itself,\nwhether or not a consumer declared `active`, a declared property being a\nseed and a correction."
+              "description": "Requests a new current item, and returns whether the change was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-activate` is\na refusal and nothing moves. Unlike a native control, nothing has moved\nby the time this runs, so refusing is simply not writing: there is\nnothing to put back. Nobody refusing means the set updates itself,\nwhether or not a consumer declared `active`, a declared property being a\nseed and a correction. `cause` says why, where the family names its\ncauses, and reaches the event as `detail.cause`."
             },
             {
               "kind": "method",
@@ -20436,7 +20512,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 +20565,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 +20582,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 +21199,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 +21225,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 +21285,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 +21363,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 +21403,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 +21446,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 +21487,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 +21565,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 +21624,12 @@
                 }
               },
               "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "number"
+                  }
+                },
                 {
                   "name": "next",
                   "type": {
@@ -21488,6 +21750,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 +24160,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 +24258,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 +24275,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 +24384,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 +24418,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 +24436,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 +24482,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 +26098,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 +26171,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 +26217,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 +26270,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 +26297,7 @@
               }
             },
             {
-              "name": "{ kind, locale, segments, twelve, typed }",
+              "name": "{ kind, locale, segments, system, twelve, typed }",
               "type": {
                 "text": "SegmentKeyState"
               }
@@ -25999,9 +26325,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 +26362,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 +26399,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 +26478,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 +26512,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 +26685,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 +32903,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.159.0'",
+          "default": "'0.161.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 +33463,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.159.0"
+    "version": "0.161.0"
   }
 }