@fusion.dev/helix-headless 0.46.1 → 0.47.1

package/types/jsx.d.ts

@@ -1839,6 +1839,27 @@ clamps to the last *slide*, so three of the six indicators point at an
 offset the track has already reached: pressing next walks the dots to the
 end while the slides stop moving a third of the way through.
 
+**The number is published to the styles rather than enumerated by them**,
+as `--carousel-per-view` on the track, which is what keeps a width and a
+count from disagreeing. A sheet can only name a value it wrote a rule for,
+so the styled tier enumerated `per-view="2"` through `5` and called five a
+judgment; above it the pane fell back to one across while this file went on
+counting positions. Measured in Chromium over eight slides, six across gave
+three dots, a pane taking the whole track and five slides reachable only by
+dragging. Written from here there is no ceiling to exceed, and a consumer's
+own sheet reads the same declaration the styled one does. `runEnd` publishes
+its correction the same way and for the same reason.
+
+**On the track and not on the host.** A custom property on the host is a
+reflected attribute by another name: it would arrive on upgrade, and a
+consumer's server markup never had it. Inside the component's own shadow
+root it serializes with the rest of the template on the server, and the
+track's own declaration beats anything a consumer inherits in, so the
+attribute is the one answer to how wide a pane is.
+
+A value the track cannot honor is taken to the nearest one it can, by
+`across`, and both tiers read that rather than this.
+
 No default, because it reflects. A reflected property with a value writes
 its attribute on upgrade, and the host then carries something a consumer's
 server markup never had, which React reports as a mismatch. The one-across
@@ -1855,6 +1876,27 @@ clamps to the last *slide*, so three of the six indicators point at an
 offset the track has already reached: pressing next walks the dots to the
 end while the slides stop moving a third of the way through.
 
+**The number is published to the styles rather than enumerated by them**,
+as `--carousel-per-view` on the track, which is what keeps a width and a
+count from disagreeing. A sheet can only name a value it wrote a rule for,
+so the styled tier enumerated `per-view="2"` through `5` and called five a
+judgment; above it the pane fell back to one across while this file went on
+counting positions. Measured in Chromium over eight slides, six across gave
+three dots, a pane taking the whole track and five slides reachable only by
+dragging. Written from here there is no ceiling to exceed, and a consumer's
+own sheet reads the same declaration the styled one does. `runEnd` publishes
+its correction the same way and for the same reason.
+
+**On the track and not on the host.** A custom property on the host is a
+reflected attribute by another name: it would arrive on upgrade, and a
+consumer's server markup never had it. Inside the component's own shadow
+root it serializes with the rest of the template on the server, and the
+track's own declaration beats anything a consumer inherits in, so the
+attribute is the one answer to how wide a pane is.
+
+A value the track cannot honor is taken to the nearest one it can, by
+`across`, and both tiers read that rather than this.
+
 No default, because it reflects. A reflected property with a value writes
 its attribute on upgrade, and the host then carries something a consumer's
 server markup never had, which React reports as a mismatch. The one-across
@@ -1940,6 +1982,27 @@ clamps to the last *slide*, so three of the six indicators point at an
 offset the track has already reached: pressing next walks the dots to the
 end while the slides stop moving a third of the way through.
 
+**The number is published to the styles rather than enumerated by them**,
+as `--carousel-per-view` on the track, which is what keeps a width and a
+count from disagreeing. A sheet can only name a value it wrote a rule for,
+so the styled tier enumerated `per-view="2"` through `5` and called five a
+judgment; above it the pane fell back to one across while this file went on
+counting positions. Measured in Chromium over eight slides, six across gave
+three dots, a pane taking the whole track and five slides reachable only by
+dragging. Written from here there is no ceiling to exceed, and a consumer's
+own sheet reads the same declaration the styled one does. `runEnd` publishes
+its correction the same way and for the same reason.
+
+**On the track and not on the host.** A custom property on the host is a
+reflected attribute by another name: it would arrive on upgrade, and a
+consumer's server markup never had it. Inside the component's own shadow
+root it serializes with the rest of the template on the server, and the
+track's own declaration beats anything a consumer inherits in, so the
+attribute is the one answer to how wide a pane is.
+
+A value the track cannot honor is taken to the nearest one it can, by
+`across`, and both tiers read that rather than this.
+
 No default, because it reflects. A reflected property with a value writes
 its attribute on upgrade, and the host then carries something a consumer's
 server markup never had, which React reports as a mismatch. The one-across
@@ -1956,6 +2019,27 @@ clamps to the last *slide*, so three of the six indicators point at an
 offset the track has already reached: pressing next walks the dots to the
 end while the slides stop moving a third of the way through.
 
+**The number is published to the styles rather than enumerated by them**,
+as `--carousel-per-view` on the track, which is what keeps a width and a
+count from disagreeing. A sheet can only name a value it wrote a rule for,
+so the styled tier enumerated `per-view="2"` through `5` and called five a
+judgment; above it the pane fell back to one across while this file went on
+counting positions. Measured in Chromium over eight slides, six across gave
+three dots, a pane taking the whole track and five slides reachable only by
+dragging. Written from here there is no ceiling to exceed, and a consumer's
+own sheet reads the same declaration the styled one does. `runEnd` publishes
+its correction the same way and for the same reason.
+
+**On the track and not on the host.** A custom property on the host is a
+reflected attribute by another name: it would arrive on upgrade, and a
+consumer's server markup never had it. Inside the component's own shadow
+root it serializes with the rest of the template on the server, and the
+track's own declaration beats anything a consumer inherits in, so the
+attribute is the one answer to how wide a pane is.
+
+A value the track cannot honor is taken to the nearest one it can, by
+`across`, and both tiers read that rather than this.
+
 No default, because it reflects. A reflected property with a value writes
 its attribute on upgrade, and the host then carries something a consumer's
 server markup never had, which React reports as a mismatch. The one-across
@@ -13809,7 +13893,20 @@ on the column it sizes, which is the more particular statement, and it is
 where a resize lands: a reader dragging a column's edge writes `width`, so
 were this list to win, the drag would move the separator and leave the
 track where the list put it. This is the table's default for its columns,
-and each column may say otherwise. */
+and each column may say otherwise.
+
+**It is also the only track list a server can send.** The shim has no tree
+to walk, so a render there knows of no columns and this attribute is the
+whole answer: a table given one lays its grid out in the first paint, and a
+table sized only by its columns is one track wide until it upgrades.
+
+**`helix-data-table` has none of this, and should not.** Its columns are
+its schema rather than an option, so there is always a column to write a
+`width` on and a list here would be a second way to say what that says.
+This table's cells are markup, and a table written as rows of cells with no
+`helix-table-column` in it has nowhere else to be sized from. Both families
+take the same CSS hook, `--table-columns` and `--data-table-columns`, which
+wins over whichever list the element worked out. */
   columns?: (HelixHeadlessTable["columns"]) | undefined;
   /** Accessible name for the table. */
   label?: (HelixHeadlessTable["label"]) | undefined;
@@ -13847,7 +13944,20 @@ on the column it sizes, which is the more particular statement, and it is
 where a resize lands: a reader dragging a column's edge writes `width`, so
 were this list to win, the drag would move the separator and leave the
 track where the list put it. This is the table's default for its columns,
-and each column may say otherwise. */
+and each column may say otherwise.
+
+**It is also the only track list a server can send.** The shim has no tree
+to walk, so a render there knows of no columns and this attribute is the
+whole answer: a table given one lays its grid out in the first paint, and a
+table sized only by its columns is one track wide until it upgrades.
+
+**`helix-data-table` has none of this, and should not.** Its columns are
+its schema rather than an option, so there is always a column to write a
+`width` on and a list here would be a second way to say what that says.
+This table's cells are markup, and a table written as rows of cells with no
+`helix-table-column` in it has nowhere else to be sized from. Both families
+take the same CSS hook, `--table-columns` and `--data-table-columns`, which
+wins over whichever list the element worked out. */
   "prop:columns"?: (HelixHeadlessTable["columns"]) | undefined;
   /** Accessible name for the table. */
   "prop:label"?: (HelixHeadlessTable["label"]) | undefined;
@@ -16189,13 +16299,6 @@ Unset by default, and unreflected: a tree of choosable nodes is not a tree
 of links, and an empty `href` written onto every row would be a link to the
 current page on every item a consumer never asked to be one. */
   href?: (HelixHeadlessTreeItem["href"]) | undefined;
-  /** Depth from the root, set by the tree so indentation needs no CSS nesting.
-
-Not reflected. The tree assigns this after it upgrades, so an attribute
-here would be a change to markup the consumer rendered and hydration would
-report it. The indent it drives is written onto the row instead, inside the
-shadow root, which is not part of the tree React hydrates. */
-  level?: (HelixHeadlessTreeItem["level"]) | undefined;
   /** What the link declares about where it goes.
 
 Set by the consumer rather than derived from `target`: `noreferrer` is a
@@ -16205,7 +16308,7 @@ this library supports implies it for `target="_blank"` already. */
   rel?: (HelixHeadlessTreeItem["rel"]) | undefined;
   /** Whether this item is the current one.
 
-Not reflected, for the reason `level` below gives in full: the tree assigns
+Not reflected, for the reason `level` above gives in full: the tree assigns
 this after it upgrades, so the attribute would be a change to markup the
 consumer rendered and hydration would report it. Mirroring to
 `data-selected` on the host instead is the same fault under another name.
@@ -16234,6 +16337,24 @@ the resolved state for stylesheets, which is what the mirror is for. */
   "default-open"?: (HelixHeadlessTreeItem["defaultOpen"]) | undefined;
   /** Initial open state for uncontrolled use, where nothing declared one. */
   defaultOpen?: (HelixHeadlessTreeItem["defaultOpen"]) | undefined;
+  /** Depth from the root, counted by the tree so indentation needs no CSS nesting.
+
+**Read rather than written, and no attribute at all.** The tree counts the
+items a row sits inside and assigns this on every sync, so a value declared
+here is overwritten before the first paint: measured at `level="2"` on three
+rows of a flat list, all three back to 1 with `--tree-level: 1` on every
+row. It carried an attribute and a shipped example setting it for as long as
+both existed, which is a depth a consumer could state and nothing would
+honor. Depth in this tree is where a row is, not what it claims: a branch's
+children go in its `children` slot, and that nesting is also what decides
+which rows a shut branch hides and which row the outward arrow moves to.
+
+Not reflected either. The tree assigns this after it upgrades, so an
+attribute here would be a change to markup the consumer rendered and
+hydration would report it. The indent it drives is written onto the row
+instead, inside the shadow root, which is not part of the tree React
+hydrates. */
+  level?: (HelixHeadlessTreeItem["level"]) | undefined;
   /** Whether this item holds the tree's single tab stop. */
   focusable?: (HelixHeadlessTreeItem["focusable"]) | undefined;
 
@@ -16258,13 +16379,6 @@ Unset by default, and unreflected: a tree of choosable nodes is not a tree
 of links, and an empty `href` written onto every row would be a link to the
 current page on every item a consumer never asked to be one. */
   "prop:href"?: (HelixHeadlessTreeItem["href"]) | undefined;
-  /** Depth from the root, set by the tree so indentation needs no CSS nesting.
-
-Not reflected. The tree assigns this after it upgrades, so an attribute
-here would be a change to markup the consumer rendered and hydration would
-report it. The indent it drives is written onto the row instead, inside the
-shadow root, which is not part of the tree React hydrates. */
-  "prop:level"?: (HelixHeadlessTreeItem["level"]) | undefined;
   /** What the link declares about where it goes.
 
 Set by the consumer rather than derived from `target`: `noreferrer` is a
@@ -16274,7 +16388,7 @@ this library supports implies it for `target="_blank"` already. */
   "prop:rel"?: (HelixHeadlessTreeItem["rel"]) | undefined;
   /** Whether this item is the current one.
 
-Not reflected, for the reason `level` below gives in full: the tree assigns
+Not reflected, for the reason `level` above gives in full: the tree assigns
 this after it upgrades, so the attribute would be a change to markup the
 consumer rendered and hydration would report it. Mirroring to
 `data-selected` on the host instead is the same fault under another name.
@@ -16303,6 +16417,24 @@ the resolved state for stylesheets, which is what the mirror is for. */
   "bool:default-open"?: (HelixHeadlessTreeItem["defaultOpen"]) | undefined;
   /** Initial open state for uncontrolled use, where nothing declared one. */
   "prop:defaultOpen"?: (HelixHeadlessTreeItem["defaultOpen"]) | undefined;
+  /** Depth from the root, counted by the tree so indentation needs no CSS nesting.
+
+**Read rather than written, and no attribute at all.** The tree counts the
+items a row sits inside and assigns this on every sync, so a value declared
+here is overwritten before the first paint: measured at `level="2"` on three
+rows of a flat list, all three back to 1 with `--tree-level: 1` on every
+row. It carried an attribute and a shipped example setting it for as long as
+both existed, which is a depth a consumer could state and nothing would
+honor. Depth in this tree is where a row is, not what it claims: a branch's
+children go in its `children` slot, and that nesting is also what decides
+which rows a shut branch hides and which row the outward arrow moves to.
+
+Not reflected either. The tree assigns this after it upgrades, so an
+attribute here would be a change to markup the consumer rendered and
+hydration would report it. The indent it drives is written onto the row
+instead, inside the shadow root, which is not part of the tree React
+hydrates. */
+  "prop:level"?: (HelixHeadlessTreeItem["level"]) | undefined;
   /** Whether this item holds the tree's single tab stop. */
   "prop:focusable"?: (HelixHeadlessTreeItem["focusable"]) | undefined;
   /** Fired before a branch closes, and cancelable. */
@@ -19148,6 +19280,27 @@ export type CustomElements = {
    * offset the track has already reached: pressing next walks the dots to the
    * end while the slides stop moving a third of the way through.
    *
+   * **The number is published to the styles rather than enumerated by them**,
+   * as `--carousel-per-view` on the track, which is what keeps a width and a
+   * count from disagreeing. A sheet can only name a value it wrote a rule for,
+   * so the styled tier enumerated `per-view="2"` through `5` and called five a
+   * judgment; above it the pane fell back to one across while this file went on
+   * counting positions. Measured in Chromium over eight slides, six across gave
+   * three dots, a pane taking the whole track and five slides reachable only by
+   * dragging. Written from here there is no ceiling to exceed, and a consumer's
+   * own sheet reads the same declaration the styled one does. `runEnd` publishes
+   * its correction the same way and for the same reason.
+   *
+   * **On the track and not on the host.** A custom property on the host is a
+   * reflected attribute by another name: it would arrive on upgrade, and a
+   * consumer's server markup never had it. Inside the component's own shadow
+   * root it serializes with the rest of the template on the server, and the
+   * track's own declaration beats anything a consumer inherits in, so the
+   * attribute is the one answer to how wide a pane is.
+   *
+   * A value the track cannot honor is taken to the nearest one it can, by
+   * `across`, and both tiers read that rather than this.
+   *
    * No default, because it reflects. A reflected property with a value writes
    * its attribute on upgrade, and the host then carries something a consumer's
    * server markup never had, which React reports as a mismatch. The one-across
@@ -19204,6 +19357,7 @@ export type CustomElements = {
    *
    * - `--carousel-gap`: Space between slides. A sheet sets it and the component measures the run with it. (default: `undefined`)
    * - `--carousel-pane`: The size one pane is laid out at. A sheet sets it and the component measures the run with it. (default: `undefined`)
+   * - `--carousel-per-view`: How many slides go across, written onto the track by the component so a sheet divides the track by the same number the positions are counted from. Read it rather than selecting on `per-view`, which cannot be enumerated without a ceiling. See `perView`. (default: `undefined`)
    * - `--carousel-run-end`: How far short of a whole pixel the run ends, on the last slide alone, for a sheet to take up as `margin-inline-end`. See `runEnd`. (default: `undefined`)
    *
    * ## CSS Parts
@@ -21393,6 +21547,15 @@ export type CustomElements = {
    * in the order on screen, in the columns on screen. Saving it is the page's
    * business, the same as any other file.
    *
+   * **There is no `columns` attribute here, and `helix-table` has one.** The
+   * difference is what a column is in each: here it is the schema, so a table
+   * without one has nothing to read a row with, and every column is a place to
+   * write a `width`. A `helix-table` holds cells a consumer wrote and can be
+   * written with no column at all, so its `columns` is where such a table is
+   * sized from. Written on this element the attribute is inert, which is the trap
+   * worth knowing when moving between the two. What both take is the CSS hook,
+   * `--data-table-columns` here and `--table-columns` there.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -31339,11 +31502,14 @@ export type CustomElements = {
 
   /**
    * **The column is the source of both its heading and its track.** Add one and
-   * the table has another track; remove one and it does not. Declaring the widths
-   * separately, as a CSS track list on the table, leaves nothing tying the two
-   * together: a table with three headings and a two-track list renders without
-   * complaint, and a track list that is accidentally the headings is invalid CSS
-   * the grid silently ignores, collapsing the whole table into one column.
+   * the table has another track; remove one and it does not. That is what ties
+   * the two together, and a table-level track list on its own does not: a list
+   * that is accidentally the headings is invalid CSS a grid ignores in silence,
+   * drawing the whole table as one column. `helix-table`'s `columns` is dealt out
+   * a track at a time against the columns declared under it, so a heading among
+   * the widths costs its own column a width and no more, and a list longer or
+   * shorter than the columns is trimmed or shared rather than being a second
+   * count of them. A column's own `width` wins over the track in its place.
    *
    * **It is also where every per-column fact goes**, which is the reason
    * `helix-data-table` needs no column config object. `field` names the key the
@@ -31577,6 +31743,19 @@ export type CustomElements = {
    * were this list to win, the drag would move the separator and leave the
    * track where the list put it. This is the table's default for its columns,
    * and each column may say otherwise.
+   *
+   * **It is also the only track list a server can send.** The shim has no tree
+   * to walk, so a render there knows of no columns and this attribute is the
+   * whole answer: a table given one lays its grid out in the first paint, and a
+   * table sized only by its columns is one track wide until it upgrades.
+   *
+   * **`helix-data-table` has none of this, and should not.** Its columns are
+   * its schema rather than an option, so there is always a column to write a
+   * `width` on and a list here would be a second way to say what that says.
+   * This table's cells are markup, and a table written as rows of cells with no
+   * `helix-table-column` in it has nowhere else to be sized from. Both families
+   * take the same CSS hook, `--table-columns` and `--data-table-columns`, which
+   * wins over whichever list the element worked out.
    * - `label`: Accessible name for the table.
    * - `empty-text`/`emptyText`: What is said where there are none, and none are coming.
    * - `loading`: Whether the rows are still on their way.
@@ -31617,7 +31796,6 @@ export type CustomElements = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--table-columns`: Track list for the columns. (default: `undefined`)
    * - `--table-template`: The column track list this element worked out from the columns declared in it. Written by the component, read by the sheet that paints: a stylesheet takes it to lay the grid out, and setting it does nothing, because the component writes it inline on the very element that reads it and an inline declaration beats any sheet. `--table-columns` is the one to set. (default: `undefined`)
    *
    * ## CSS Parts
@@ -33987,12 +34165,6 @@ export type CustomElements = {
    * Unset by default, and unreflected: a tree of choosable nodes is not a tree
    * of links, and an empty `href` written onto every row would be a link to the
    * current page on every item a consumer never asked to be one.
-   * - `level`: Depth from the root, set by the tree so indentation needs no CSS nesting.
-   *
-   * Not reflected. The tree assigns this after it upgrades, so an attribute
-   * here would be a change to markup the consumer rendered and hydration would
-   * report it. The indent it drives is written onto the row instead, inside the
-   * shadow root, which is not part of the tree React hydrates.
    * - `rel`: What the link declares about where it goes.
    *
    * Set by the consumer rather than derived from `target`: `noreferrer` is a
@@ -34001,7 +34173,7 @@ export type CustomElements = {
    * this library supports implies it for `target="_blank"` already.
    * - `selected`: Whether this item is the current one.
    *
-   * Not reflected, for the reason `level` below gives in full: the tree assigns
+   * Not reflected, for the reason `level` above gives in full: the tree assigns
    * this after it upgrades, so the attribute would be a change to markup the
    * consumer rendered and hydration would report it. Mirroring to
    * `data-selected` on the host instead is the same fault under another name.
@@ -34023,6 +34195,23 @@ export type CustomElements = {
    * last reader did rather than what the author wrote. `:state(open)` carries
    * the resolved state for stylesheets, which is what the mirror is for.
    * - `default-open`/`defaultOpen`: Initial open state for uncontrolled use, where nothing declared one.
+   * - `level`: Depth from the root, counted by the tree so indentation needs no CSS nesting.
+   *
+   * **Read rather than written, and no attribute at all.** The tree counts the
+   * items a row sits inside and assigns this on every sync, so a value declared
+   * here is overwritten before the first paint: measured at `level="2"` on three
+   * rows of a flat list, all three back to 1 with `--tree-level: 1` on every
+   * row. It carried an attribute and a shipped example setting it for as long as
+   * both existed, which is a depth a consumer could state and nothing would
+   * honor. Depth in this tree is where a row is, not what it claims: a branch's
+   * children go in its `children` slot, and that nesting is also what decides
+   * which rows a shut branch hides and which row the outward arrow moves to.
+   *
+   * Not reflected either. The tree assigns this after it upgrades, so an
+   * attribute here would be a change to markup the consumer rendered and
+   * hydration would report it. The indent it drives is written onto the row
+   * instead, inside the shadow root, which is not part of the tree React
+   * hydrates. (property only)
    * - `focusable`: Whether this item holds the tree's single tab stop. (property only)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
@@ -36890,6 +37079,27 @@ export type CustomElementsSolidJs = {
    * offset the track has already reached: pressing next walks the dots to the
    * end while the slides stop moving a third of the way through.
    *
+   * **The number is published to the styles rather than enumerated by them**,
+   * as `--carousel-per-view` on the track, which is what keeps a width and a
+   * count from disagreeing. A sheet can only name a value it wrote a rule for,
+   * so the styled tier enumerated `per-view="2"` through `5` and called five a
+   * judgment; above it the pane fell back to one across while this file went on
+   * counting positions. Measured in Chromium over eight slides, six across gave
+   * three dots, a pane taking the whole track and five slides reachable only by
+   * dragging. Written from here there is no ceiling to exceed, and a consumer's
+   * own sheet reads the same declaration the styled one does. `runEnd` publishes
+   * its correction the same way and for the same reason.
+   *
+   * **On the track and not on the host.** A custom property on the host is a
+   * reflected attribute by another name: it would arrive on upgrade, and a
+   * consumer's server markup never had it. Inside the component's own shadow
+   * root it serializes with the rest of the template on the server, and the
+   * track's own declaration beats anything a consumer inherits in, so the
+   * attribute is the one answer to how wide a pane is.
+   *
+   * A value the track cannot honor is taken to the nearest one it can, by
+   * `across`, and both tiers read that rather than this.
+   *
    * No default, because it reflects. A reflected property with a value writes
    * its attribute on upgrade, and the host then carries something a consumer's
    * server markup never had, which React reports as a mismatch. The one-across
@@ -36946,6 +37156,7 @@ export type CustomElementsSolidJs = {
    *
    * - `--carousel-gap`: Space between slides. A sheet sets it and the component measures the run with it. (default: `undefined`)
    * - `--carousel-pane`: The size one pane is laid out at. A sheet sets it and the component measures the run with it. (default: `undefined`)
+   * - `--carousel-per-view`: How many slides go across, written onto the track by the component so a sheet divides the track by the same number the positions are counted from. Read it rather than selecting on `per-view`, which cannot be enumerated without a ceiling. See `perView`. (default: `undefined`)
    * - `--carousel-run-end`: How far short of a whole pixel the run ends, on the last slide alone, for a sheet to take up as `margin-inline-end`. See `runEnd`. (default: `undefined`)
    *
    * ## CSS Parts
@@ -39162,6 +39373,15 @@ export type CustomElementsSolidJs = {
    * in the order on screen, in the columns on screen. Saving it is the page's
    * business, the same as any other file.
    *
+   * **There is no `columns` attribute here, and `helix-table` has one.** The
+   * difference is what a column is in each: here it is the schema, so a table
+   * without one has nothing to read a row with, and every column is a place to
+   * write a `width`. A `helix-table` holds cells a consumer wrote and can be
+   * written with no column at all, so its `columns` is where such a table is
+   * sized from. Written on this element the attribute is inert, which is the trap
+   * worth knowing when moving between the two. What both take is the CSS hook,
+   * `--data-table-columns` here and `--table-columns` there.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -49269,11 +49489,14 @@ export type CustomElementsSolidJs = {
 
   /**
    * **The column is the source of both its heading and its track.** Add one and
-   * the table has another track; remove one and it does not. Declaring the widths
-   * separately, as a CSS track list on the table, leaves nothing tying the two
-   * together: a table with three headings and a two-track list renders without
-   * complaint, and a track list that is accidentally the headings is invalid CSS
-   * the grid silently ignores, collapsing the whole table into one column.
+   * the table has another track; remove one and it does not. That is what ties
+   * the two together, and a table-level track list on its own does not: a list
+   * that is accidentally the headings is invalid CSS a grid ignores in silence,
+   * drawing the whole table as one column. `helix-table`'s `columns` is dealt out
+   * a track at a time against the columns declared under it, so a heading among
+   * the widths costs its own column a width and no more, and a list longer or
+   * shorter than the columns is trimmed or shared rather than being a second
+   * count of them. A column's own `width` wins over the track in its place.
    *
    * **It is also where every per-column fact goes**, which is the reason
    * `helix-data-table` needs no column config object. `field` names the key the
@@ -49508,6 +49731,19 @@ export type CustomElementsSolidJs = {
    * were this list to win, the drag would move the separator and leave the
    * track where the list put it. This is the table's default for its columns,
    * and each column may say otherwise.
+   *
+   * **It is also the only track list a server can send.** The shim has no tree
+   * to walk, so a render there knows of no columns and this attribute is the
+   * whole answer: a table given one lays its grid out in the first paint, and a
+   * table sized only by its columns is one track wide until it upgrades.
+   *
+   * **`helix-data-table` has none of this, and should not.** Its columns are
+   * its schema rather than an option, so there is always a column to write a
+   * `width` on and a list here would be a second way to say what that says.
+   * This table's cells are markup, and a table written as rows of cells with no
+   * `helix-table-column` in it has nowhere else to be sized from. Both families
+   * take the same CSS hook, `--table-columns` and `--data-table-columns`, which
+   * wins over whichever list the element worked out.
    * - `label`: Accessible name for the table.
    * - `empty-text`/`emptyText`: What is said where there are none, and none are coming.
    * - `loading`: Whether the rows are still on their way.
@@ -49548,7 +49784,6 @@ export type CustomElementsSolidJs = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--table-columns`: Track list for the columns. (default: `undefined`)
    * - `--table-template`: The column track list this element worked out from the columns declared in it. Written by the component, read by the sheet that paints: a stylesheet takes it to lay the grid out, and setting it does nothing, because the component writes it inline on the very element that reads it and an inline declaration beats any sheet. `--table-columns` is the one to set. (default: `undefined`)
    *
    * ## CSS Parts
@@ -51969,12 +52204,6 @@ export type CustomElementsSolidJs = {
    * Unset by default, and unreflected: a tree of choosable nodes is not a tree
    * of links, and an empty `href` written onto every row would be a link to the
    * current page on every item a consumer never asked to be one.
-   * - `level`: Depth from the root, set by the tree so indentation needs no CSS nesting.
-   *
-   * Not reflected. The tree assigns this after it upgrades, so an attribute
-   * here would be a change to markup the consumer rendered and hydration would
-   * report it. The indent it drives is written onto the row instead, inside the
-   * shadow root, which is not part of the tree React hydrates.
    * - `rel`: What the link declares about where it goes.
    *
    * Set by the consumer rather than derived from `target`: `noreferrer` is a
@@ -51983,7 +52212,7 @@ export type CustomElementsSolidJs = {
    * this library supports implies it for `target="_blank"` already.
    * - `selected`: Whether this item is the current one.
    *
-   * Not reflected, for the reason `level` below gives in full: the tree assigns
+   * Not reflected, for the reason `level` above gives in full: the tree assigns
    * this after it upgrades, so the attribute would be a change to markup the
    * consumer rendered and hydration would report it. Mirroring to
    * `data-selected` on the host instead is the same fault under another name.
@@ -52005,6 +52234,23 @@ export type CustomElementsSolidJs = {
    * last reader did rather than what the author wrote. `:state(open)` carries
    * the resolved state for stylesheets, which is what the mirror is for.
    * - `default-open`/`defaultOpen`: Initial open state for uncontrolled use, where nothing declared one.
+   * - `level`: Depth from the root, counted by the tree so indentation needs no CSS nesting.
+   *
+   * **Read rather than written, and no attribute at all.** The tree counts the
+   * items a row sits inside and assigns this on every sync, so a value declared
+   * here is overwritten before the first paint: measured at `level="2"` on three
+   * rows of a flat list, all three back to 1 with `--tree-level: 1` on every
+   * row. It carried an attribute and a shipped example setting it for as long as
+   * both existed, which is a depth a consumer could state and nothing would
+   * honor. Depth in this tree is where a row is, not what it claims: a branch's
+   * children go in its `children` slot, and that nesting is also what decides
+   * which rows a shut branch hides and which row the outward arrow moves to.
+   *
+   * Not reflected either. The tree assigns this after it upgrades, so an
+   * attribute here would be a change to markup the consumer rendered and
+   * hydration would report it. The indent it drives is written onto the row
+   * instead, inside the shadow root, which is not part of the tree React
+   * hydrates. (property only)
    * - `focusable`: Whether this item holds the tree's single tab stop. (property only)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
@@ -53014,6 +53260,8 @@ export type CustomCssProperties = {
   "--carousel-gap"?: (string) | undefined;
   /** The size one pane is laid out at. A sheet sets it and the component measures the run with it. */
   "--carousel-pane"?: (string) | undefined;
+  /** How many slides go across, written onto the track by the component so a sheet divides the track by the same number the positions are counted from. Read it rather than selecting on `per-view`, which cannot be enumerated without a ceiling. See `perView`. */
+  "--carousel-per-view"?: (string) | undefined;
   /** How far short of a whole pixel the run ends, on the last slide alone, for a sheet to take up as `margin-inline-end`. See `runEnd`. */
   "--carousel-run-end"?: (string) | undefined;
   /** The chosen color, to paint over the transparency check. */
@@ -53118,8 +53366,6 @@ export type CustomCssProperties = {
   "--splitter-position"?: (string) | undefined;
   /** The edge the column this cell sits under is set to, `start`, `center` or `end`, and unset under a column that sets none. Written by the table around it, since the cell is the consumer's markup and nothing is written onto it; read by the sheet that draws the cell, where `justify-content` and `text-align` both take it as it comes and both follow the writing direction. */
   "--table-cell-align"?: (string) | undefined;
-  /** Track list for the columns. */
-  "--table-columns"?: (string) | undefined;
   /** The column track list this element worked out from the columns declared in it. Written by the component, read by the sheet that paints: a stylesheet takes it to lay the grid out, and setting it does nothing, because the component writes it inline on the very element that reads it and an inline declaration beats any sheet. `--table-columns` is the one to set. */
   "--table-template"?: (string) | undefined;
   /** How long this message stays, in milliseconds, for a progress hint. */