@fusion.dev/helix 0.166.0 → 0.167.0

package/types/vue.d.ts

@@ -174,6 +174,7 @@ import type {
   HelixBeforeChangeEvent,
   HelixPressEvent,
   HelixBeforeMoveEvent,
+  HelixBeforePasteEvent,
   HelixBeforeReconnectEvent,
   HelixBeforeRelabelEvent,
   HelixCanvasEditEvent,
@@ -182,6 +183,7 @@ import type {
   HelixCanvasZoomEvent,
   HelixConnectEvent,
   HelixMoveEvent,
+  HelixPastedEvent,
   HelixReconnectEvent,
   HelixRelabelEvent,
   HelixRemoveEvent,
@@ -2230,6 +2232,9 @@ export type HelixCanvasElementEvent<E = Event> = TypedEvent<HelixCanvas, E>;
 /** `helix-before-move` event type */
 export type HelixCanvasHelixBeforeMoveElementEvent =
   HelixCanvasElementEvent<HelixBeforeMoveEvent>;
+/** `helix-before-paste` event type */
+export type HelixCanvasHelixBeforePasteElementEvent =
+  HelixCanvasElementEvent<HelixBeforePasteEvent>;
 /** `helix-before-reconnect` event type */
 export type HelixCanvasHelixBeforeReconnectElementEvent =
   HelixCanvasElementEvent<HelixBeforeReconnectEvent>;
@@ -2254,6 +2259,9 @@ export type HelixCanvasHelixConnectElementEvent =
 /** `helix-move` event type */
 export type HelixCanvasHelixMoveElementEvent =
   HelixCanvasElementEvent<HelixMoveEvent>;
+/** `helix-pasted` event type */
+export type HelixCanvasHelixPastedElementEvent =
+  HelixCanvasElementEvent<HelixPastedEvent>;
 /** `helix-reconnect` event type */
 export type HelixCanvasHelixReconnectElementEvent =
   HelixCanvasElementEvent<HelixReconnectEvent>;
@@ -2426,6 +2434,10 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   /** The hint shown when the board, waiting to be pressed with
 `gestures="activate"`, is scrolled or swiped over. */
   activateHintLabel?: (HelixCanvas["activateHintLabel"]) | undefined;
+  /** What screen readers hear after `arrange()` moves the cards. */
+  "arranged-label"?: (HelixCanvas["arrangedLabel"]) | undefined;
+  /** What screen readers hear after `arrange()` moves the cards. */
+  arrangedLabel?: (HelixCanvas["arrangedLabel"]) | undefined;
   /** The text read with a card to say where its connections come from, with `{cards}`. */
   "comes-from-label"?: (HelixCanvas["comesFromLabel"]) | undefined;
   /** The text read with a card to say where its connections come from, with `{cards}`. */
@@ -2524,6 +2536,10 @@ on a board that is a flow is the order its author meant.
 Absent is spatial, a resting value being an attribute's absence: a default
 that reflected would write a choice onto every host that no server sent. */
   order?: (HelixCanvas["order"]) | undefined;
+  /** What screen readers hear after a paste, with `{count}` for the cards pasted. */
+  "pasted-label"?: (HelixCanvas["pastedLabel"]) | undefined;
+  /** What screen readers hear after a paste, with `{count}` for the cards pasted. */
+  pastedLabel?: (HelixCanvas["pastedLabel"]) | undefined;
   /** The route every connection takes when it sets no `path` of its own:
 `straight`, or `step` for right angles.
 
@@ -2557,6 +2573,14 @@ walk the cards. */
   "redone-label"?: (HelixCanvas["redoneLabel"]) | undefined;
   /** What screen readers hear after a move or a resize is made again. */
   redoneLabel?: (HelixCanvas["redoneLabel"]) | undefined;
+  /** What screen readers hear when Delete asks to remove what is selected, with
+`{count}` for how many cards and connections, and `{name}` for the one
+where there is one. */
+  "removed-label"?: (HelixCanvas["removedLabel"]) | undefined;
+  /** What screen readers hear when Delete asks to remove what is selected, with
+`{count}` for how many cards and connections, and `{name}` for the one
+where there is one. */
+  removedLabel?: (HelixCanvas["removedLabel"]) | undefined;
   /** What screen readers hear after a key resizes a card, with `{name}` for the
 card and `{width}` and `{height}` for its new size, in the document's
 units. */
@@ -2702,6 +2726,8 @@ it rather than fitting the board again. */
 export type HelixCanvasVueEvents = {
   /** Cards are about to move. Cancelable: cancel it to keep the positions in your own state. */
   "helix-before-move": HelixCanvasHelixBeforeMoveElementEvent;
+  /** Cards and connections are about to be pasted. Cancelable: cancel it to add the detail's document to your own state. */
+  "helix-before-paste": HelixCanvasHelixBeforePasteElementEvent;
   /** A connection's end is about to move to another card or side. Cancelable: cancel it to keep connections in your own state. */
   "helix-before-reconnect": HelixCanvasHelixBeforeReconnectElementEvent;
   /** A connection's label or a group's name is about to change. Cancelable: cancel it to keep labels in your own state. */
@@ -2718,6 +2744,8 @@ export type HelixCanvasVueEvents = {
   "helix-connect": HelixCanvasHelixConnectElementEvent;
   /** Cards moved and the move is finished: a drag was released, a click put a card down, or a key was pressed. */
   "helix-move": HelixCanvasHelixMoveElementEvent;
+  /** Cards and connections were pasted, and the board holds them. */
+  "helix-pasted": HelixCanvasHelixPastedElementEvent;
   /** A connection's end moved, and the move is finished. */
   "helix-reconnect": HelixCanvasHelixReconnectElementEvent;
   /** A connection's label or a group's name changed. */
@@ -8370,7 +8398,8 @@ such as `buddhist` for `th-TH`, and `gregory` for every other, such as
 `persian` for `fa-IR`, so a date written here reads as the same date a
 Date Picker beside it shows. Write `calendar="persian"` for Mehr 14, 1405. */
   calendar?: (HelixFormatDate["calendar"]) | undefined;
-  /** The timestamp, in any format `Date` can parse.
+  /** The timestamp: a `Date`, milliseconds since the epoch, or a string in any
+format `Date` can parse. The attribute is the string.
 
 An ISO string is what an API sends and what `<time datetime>` takes, so it
 is the shape that needs no translation at either end. Left unset this
@@ -17507,6 +17536,15 @@ order has its whole sentence. `{order}` is the deprecated
   "unsorted-label"?: (HelixTable["unsortedLabel"]) | undefined;
   /** What screen readers hear when the table stops being sorted. */
   unsortedLabel?: (HelixTable["unsortedLabel"]) | undefined;
+  /** Draws only the rows in view, with empty space in place of the rest, as
+Data Table's `windowed` does. The table's box then scrolls, at the
+height `--table-block-size` gives it in the styled tier, and the
+headings stick to its top.
+
+Off by default. Windowing costs a scroll listener, a measurement per row
+drawn, and a height on the table, and a table of twenty rows should pay
+none of them. */
+  windowed?: (HelixTable["windowed"]) | undefined;
 };
 
 export type HelixTableVueEvents = {
@@ -18794,6 +18832,12 @@ and a wheel has exactly one value by construction. Rather than draw
 something that cannot say what it holds, `wheels` renders as a list
 whenever a mode is set. */
   mode?: (HelixTimePicker["mode"]) | undefined;
+  /** The words on the button that chooses the current time, drawn with
+`show-now`. */
+  "now-label"?: (HelixTimePicker["nowLabel"]) | undefined;
+  /** The words on the button that chooses the current time, drawn with
+`show-now`. */
+  nowLabel?: (HelixTimePicker["nowLabel"]) | undefined;
   /** The validation message for a time after `max`. `{max}` is replaced with
 `max`, written in `locale`. */
   "range-overflow-message"?: (HelixTimePicker["rangeOverflowMessage"]) | undefined;
@@ -18850,6 +18894,22 @@ wheels take a column of seconds, and `step` counts seconds, the unit
 rows, so give `seconds` a `step` and bounds that keep it a list, or use
 the wheels. */
   seconds?: (HelixTimePicker["seconds"]) | undefined;
+  /** Draws a button under the times that chooses the current time, as
+`selectNow()` does.
+
+For a form about something happening now, such as a shift starting or a
+dose taken, where the reader would otherwise scroll to the time on the
+clock. The button is a tab stop after the times, and its words are
+`now-label`. */
+  "show-now"?: (HelixTimePicker["showNow"]) | undefined;
+  /** Draws a button under the times that chooses the current time, as
+`selectNow()` does.
+
+For a form about something happening now, such as a shift starting or a
+dose taken, where the reader would otherwise scroll to the time on the
+clock. The button is a tab stop after the times, and its words are
+`now-label`. */
+  showNow?: (HelixTimePicker["showNow"]) | undefined;
   /** How far apart the offered times are, in minutes, or in seconds with
 `seconds`.
 
@@ -21004,6 +21064,23 @@ follows the box as it resizes, which `columns` then does not decide. */
 out as many columns as fit the box at that width, at least one, and
 follows the box as it resizes, which `columns` then does not decide. */
   minColumnWidth?: (HelixVirtualList["minColumnWidth"]) | undefined;
+  /** Which way the list runs. `horizontal` lays the items out along a line
+and scrolls it sideways: Left and Right move between items, the other
+way round on a right-to-left page, and `estimate` is an item's width. A
+grid always runs down. */
+  orientation?: (HelixVirtualList["orientation"]) | undefined;
+  /** The field of each item that names its section, as a key or a path of
+keys. Set, the items are drawn in sections: a header, then the items, in
+an element with the `group` role that the header names. A section starts
+wherever the field changes, so give the items in order. A list of one
+column only. */
+  "section-field"?: (HelixVirtualList["sectionField"]) | undefined;
+  /** The field of each item that names its section, as a key or a path of
+keys. Set, the items are drawn in sections: a header, then the items, in
+an element with the `group` role that the header names. A section starts
+wherever the field changes, so give the items in order. A list of one
+column only. */
+  sectionField?: (HelixVirtualList["sectionField"]) | undefined;
   /** What a press does to the items already chosen: `toggle` adds or takes out
 the item, and `replace` selects it alone and lets the arrow keys carry the
 selection, with Control or Command adding or taking out one item. */
@@ -21046,6 +21123,10 @@ It returns what Lit renders: a template from `html`, a string, or a DOM
 node. The list wraps each result in a `<div>` that carries the row's role
 and place in the set. Where it is unset, the row `<template>` is used. */
   renderItem?: (HelixVirtualList["renderItem"]) | undefined;
+  /** Draws each section's header, given its name and its place among the
+sections, for a list given `section-field`. Set it as a property. Where
+it is unset, the header is the name as text. */
+  renderSection?: (HelixVirtualList["renderSection"]) | undefined;
 };
 
 export type HelixVirtualListVueEvents = {
@@ -23084,6 +23165,8 @@ export type CustomCssProperties = {
   "--switch-thumb-color"?: (string) | undefined;
   /** The text alignment of the column above the cell: `start`, `center`, or `end`, and unset when the column sets none. The table writes it, and the stylesheet that draws the cell reads it for `justify-content` and `text-align`, which both follow the writing direction. */
   "--table-cell-align"?: (string) | undefined;
+  /** How tall the table's box is while `windowed`, when it scrolls its rows. 24em by default. */
+  "--table-block-size"?: (string) | undefined;
   /** Track list for the columns. It overrides the track list worked out from the columns. */
   "--table-columns"?: (string) | undefined;
   /** The fill behind the copy of a row a pointer drags. */
@@ -23100,6 +23183,8 @@ export type CustomCssProperties = {
   "--table-drag-preview-shadow"?: (string) | undefined;
   /** The color of the words in the line shown while `error-text` is set. */
   "--table-error-color"?: (string) | undefined;
+  /** The fill behind the headings while `windowed`, which the rows scroll under. The page's background by default. */
+  "--table-heading-background-color"?: (string) | undefined;
   /** The color of the words in the `heading` slot. */
   "--table-title-color"?: (string) | undefined;
   /** The space between the `heading` slot and the grid. */
@@ -23232,6 +23317,8 @@ export type CustomCssProperties = {
   "--time-picker-list-block-size"?: (string) | undefined;
   /** The corners of the mark on a wheel's row. */
   "--time-picker-mark-radius"?: (string) | undefined;
+  /** The ink of the button that chooses the current time, with `show-now`. */
+  "--time-picker-now-color"?: (string) | undefined;
   /** Fill behind the times inside a range. */
   "--time-picker-range-color"?: (string) | undefined;
   /** Height and minimum width of one row in a wheel. */
@@ -23518,7 +23605,7 @@ export type CustomCssProperties = {
   "--video-level"?: (string) | undefined;
   /** How far playback has reached, as a fraction of the duration. */
   "--video-progress"?: (string) | undefined;
-  /** How tall the scrolling box is. */
+  /** How tall the scrolling box is. A list that runs across is as tall as its rows unless you set it. */
   "--virtual-list-block-size"?: (string) | undefined;
   /** How faint a row `disabled-keys` names is drawn. */
   "--virtual-list-disabled-opacity"?: (string) | undefined;

package/types/words.d.ts

@@ -16,6 +16,12 @@ declare module '@fusion.dev/helix-core' {
        * English: `Press the board to use it`
        */
       activateHintLabel: Message
+      /**
+       * What screen readers hear after `arrange()` moves the cards.
+       *
+       * English: `Cards arranged`
+       */
+      arrangedLabel: Message
       /**
        * What a screen reader hears when a turn arrives. `{author}` is who wrote
        * it, as its name says it, and `{text}` its words. A turn with no author a
@@ -528,6 +534,12 @@ declare module '@fusion.dev/helix-core' {
        * English: `Pan up`
        */
       panUpLabel: Message
+      /**
+       * What screen readers hear after a paste, with `{count}` for the cards pasted.
+       *
+       * English: `{count, plural, one {# card pasted} other {# cards pasted}}`
+       */
+      pastedLabel: Message
       /**
        * What screen readers hear when a key or a click picks up a row, with
        * `reorderable-rows`. `{name}` is the row's name.
@@ -622,6 +634,14 @@ declare module '@fusion.dev/helix-core' {
        * English: `Move made again`
        */
       redoneLabel: Message
+      /**
+       * What screen readers hear when Delete asks to remove what is selected, with
+       * `{count}` for how many cards and connections, and `{name}` for the one
+       * where there is one.
+       *
+       * English: `{count, plural, one {Asked to remove {name}.} other {Asked to remove # items.}}`
+       */
+      removedLabel: Message
       /**
        * The name of the control that removes one chosen option, with `{name}`
        * filled in.
@@ -2509,6 +2529,13 @@ declare module '@fusion.dev/helix-core' {
        * English: `Time`
        */
       label: Message
+      /**
+       * The words on the button that chooses the current time, drawn with
+       * `show-now`.
+       *
+       * English: `Now`
+       */
+      nowLabel: Message
       /**
        * The validation message for a time after `max`. `{max}` is replaced with
        * `max`, written in `locale`.