@fusion.dev/helix 0.46.1 → 0.47.0

package/custom-elements.json

@@ -110888,7 +110888,7 @@
           "summary": "One cell of a table.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/table",
             "tier": "styled",
             "group": "Table",
@@ -111692,7 +111692,7 @@
           "summary": "One column of a table: its heading, and how wide it is.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/table",
             "aliases": [
               "Column header",
@@ -111954,12 +111954,8 @@
           "name": "HelixTable",
           "cssProperties": [
             {
-              "description": "Track list for the columns.",
-              "name": "--table-columns",
-              "inheritedFrom": {
-                "name": "HelixHeadlessTable",
-                "module": "src/table/root/table-root.ts"
-              }
+              "description": "Track list for the columns, which wins over the one the columns worked out.",
+              "name": "--table-columns"
             },
             {
               "description": "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.",
@@ -112166,7 +112162,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The column widths as one track list, written once on the table.\n\nWith `helix-table-column` children, each track sizes the column in its\nplace, a hidden column counted, so hiding one takes its track with it and\nthe rest keep theirs. The columns decide how many tracks there are and this\nlist only how wide: a track past the last column is dropped, and a column\npast the last track shares what is left. With no columns declared it is\nthe whole track list. Tracks count as the grid counts them, so\n`minmax(0, 1fr)` is one and `repeat(2, 8rem)` is two, and one the grid\nwould refuse leaves its column at the default rather than taking the table\ndown to one column.\n\n**A column's own `width` wins over its track here.** The width is written\non the column it sizes, which is the more particular statement, and it is\nwhere a resize lands: a reader dragging a column's edge writes `width`, so\nwere this list to win, the drag would move the separator and leave the\ntrack where the list put it. This is the table's default for its columns,\nand each column may say otherwise.",
+              "description": "The column widths as one track list, written once on the table.\n\nWith `helix-table-column` children, each track sizes the column in its\nplace, a hidden column counted, so hiding one takes its track with it and\nthe rest keep theirs. The columns decide how many tracks there are and this\nlist only how wide: a track past the last column is dropped, and a column\npast the last track shares what is left. With no columns declared it is\nthe whole track list. Tracks count as the grid counts them, so\n`minmax(0, 1fr)` is one and `repeat(2, 8rem)` is two, and one the grid\nwould refuse leaves its column at the default rather than taking the table\ndown to one column.\n\n**A column's own `width` wins over its track here.** The width is written\non the column it sizes, which is the more particular statement, and it is\nwhere a resize lands: a reader dragging a column's edge writes `width`, so\nwere this list to win, the drag would move the separator and leave the\ntrack where the list put it. This is the table's default for its columns,\nand each column may say otherwise.\n\n**It is also the only track list a server can send.** The shim has no tree\nto walk, so a render there knows of no columns and this attribute is the\nwhole answer: a table given one lays its grid out in the first paint, and a\ntable sized only by its columns is one track wide until it upgrades.\n\n**`helix-data-table` has none of this, and should not.** Its columns are\nits schema rather than an option, so there is always a column to write a\n`width` on and a list here would be a second way to say what that says.\nThis table's cells are markup, and a table written as rows of cells with no\n`helix-table-column` in it has nowhere else to be sized from. Both families\ntake the same CSS hook, `--table-columns` and `--data-table-columns`, which\nwins over whichever list the element worked out.",
               "attribute": "columns",
               "inheritedFrom": {
                 "name": "HelixHeadlessTable",
@@ -112642,7 +112638,7 @@
           "helix": {
             "category": "data",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/table",
             "tier": "styled",
             "group": "Table",
@@ -112707,7 +112703,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The column widths as one track list, written once on the table.\n\nWith `helix-table-column` children, each track sizes the column in its\nplace, a hidden column counted, so hiding one takes its track with it and\nthe rest keep theirs. The columns decide how many tracks there are and this\nlist only how wide: a track past the last column is dropped, and a column\npast the last track shares what is left. With no columns declared it is\nthe whole track list. Tracks count as the grid counts them, so\n`minmax(0, 1fr)` is one and `repeat(2, 8rem)` is two, and one the grid\nwould refuse leaves its column at the default rather than taking the table\ndown to one column.\n\n**A column's own `width` wins over its track here.** The width is written\non the column it sizes, which is the more particular statement, and it is\nwhere a resize lands: a reader dragging a column's edge writes `width`, so\nwere this list to win, the drag would move the separator and leave the\ntrack where the list put it. This is the table's default for its columns,\nand each column may say otherwise.",
+              "description": "The column widths as one track list, written once on the table.\n\nWith `helix-table-column` children, each track sizes the column in its\nplace, a hidden column counted, so hiding one takes its track with it and\nthe rest keep theirs. The columns decide how many tracks there are and this\nlist only how wide: a track past the last column is dropped, and a column\npast the last track shares what is left. With no columns declared it is\nthe whole track list. Tracks count as the grid counts them, so\n`minmax(0, 1fr)` is one and `repeat(2, 8rem)` is two, and one the grid\nwould refuse leaves its column at the default rather than taking the table\ndown to one column.\n\n**A column's own `width` wins over its track here.** The width is written\non the column it sizes, which is the more particular statement, and it is\nwhere a resize lands: a reader dragging a column's edge writes `width`, so\nwere this list to win, the drag would move the separator and leave the\ntrack where the list put it. This is the table's default for its columns,\nand each column may say otherwise.\n\n**It is also the only track list a server can send.** The shim has no tree\nto walk, so a render there knows of no columns and this attribute is the\nwhole answer: a table given one lays its grid out in the first paint, and a\ntable sized only by its columns is one track wide until it upgrades.\n\n**`helix-data-table` has none of this, and should not.** Its columns are\nits schema rather than an option, so there is always a column to write a\n`width` on and a list here would be a second way to say what that says.\nThis table's cells are markup, and a table written as rows of cells with no\n`helix-table-column` in it has nowhere else to be sized from. Both families\ntake the same CSS hook, `--table-columns` and `--data-table-columns`, which\nwins over whichever list the element worked out.",
               "fieldName": "columns",
               "inheritedFrom": {
                 "name": "HelixHeadlessTable",
@@ -113146,7 +113142,7 @@
           "summary": "One row of a table.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/table",
             "tier": "styled",
             "group": "Table",
@@ -131256,8 +131252,7 @@
               "type": {
                 "text": "number | undefined"
               },
-              "description": "Depth from the root, set by the tree so indentation needs no CSS nesting.\n\nNot reflected. The tree assigns this after it upgrades, so an attribute\nhere would be a change to markup the consumer rendered and hydration would\nreport it. The indent it drives is written onto the row instead, inside the\nshadow root, which is not part of the tree React hydrates.",
-              "attribute": "level",
+              "description": "Depth from the root, counted by the tree so indentation needs no CSS nesting.\n\n**Read rather than written, and no attribute at all.** The tree counts the\nitems a row sits inside and assigns this on every sync, so a value declared\nhere is overwritten before the first paint: measured at `level=\"2\"` on three\nrows of a flat list, all three back to 1 with `--tree-level: 1` on every\nrow. It carried an attribute and a shipped example setting it for as long as\nboth existed, which is a depth a consumer could state and nothing would\nhonor. Depth in this tree is where a row is, not what it claims: a branch's\nchildren go in its `children` slot, and that nesting is also what decides\nwhich rows a shut branch hides and which row the outward arrow moves to.\n\nNot reflected either. The tree assigns this after it upgrades, so an\nattribute here would be a change to markup the consumer rendered and\nhydration would report it. The indent it drives is written onto the row\ninstead, inside the shadow root, which is not part of the tree React\nhydrates.",
               "inheritedFrom": {
                 "name": "HelixHeadlessTreeItem",
                 "module": "src/tree/item/tree-item.ts"
@@ -131284,7 +131279,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this item is the current one.\n\nNot reflected, for the reason `level` below gives in full: the tree assigns\nthis after it upgrades, so the attribute would be a change to markup the\nconsumer rendered and hydration would report it. Mirroring to\n`data-selected` on the host instead is the same fault under another name.\n\nThe stylesheet reads it from the row inside this shadow root, because the\nrow is not part of the tree React hydrates.",
+              "description": "Whether this item is the current one.\n\nNot reflected, for the reason `level` above gives in full: the tree assigns\nthis after it upgrades, so the attribute would be a change to markup the\nconsumer rendered and hydration would report it. Mirroring to\n`data-selected` on the host instead is the same fault under another name.\n\nThe stylesheet reads it from the row inside this shadow root, because the\nrow is not part of the tree React hydrates.",
               "attribute": "selected",
               "inheritedFrom": {
                 "name": "HelixHeadlessTreeItem",
@@ -131829,7 +131824,7 @@
           "summary": "One node in a tree.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tree",
             "aliases": [
               "TreeNode",
@@ -131881,18 +131876,6 @@
                 "module": "src/tree/item/tree-item.ts"
               }
             },
-            {
-              "name": "level",
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "Depth from the root, set by the tree so indentation needs no CSS nesting.\n\nNot reflected. The tree assigns this after it upgrades, so an attribute\nhere would be a change to markup the consumer rendered and hydration would\nreport it. The indent it drives is written onto the row instead, inside the\nshadow root, which is not part of the tree React hydrates.",
-              "fieldName": "level",
-              "inheritedFrom": {
-                "name": "HelixHeadlessTreeItem",
-                "module": "src/tree/item/tree-item.ts"
-              }
-            },
             {
               "name": "rel",
               "type": {
@@ -131912,7 +131895,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this item is the current one.\n\nNot reflected, for the reason `level` below gives in full: the tree assigns\nthis after it upgrades, so the attribute would be a change to markup the\nconsumer rendered and hydration would report it. Mirroring to\n`data-selected` on the host instead is the same fault under another name.\n\nThe stylesheet reads it from the row inside this shadow root, because the\nrow is not part of the tree React hydrates.",
+              "description": "Whether this item is the current one.\n\nNot reflected, for the reason `level` above gives in full: the tree assigns\nthis after it upgrades, so the attribute would be a change to markup the\nconsumer rendered and hydration would report it. Mirroring to\n`data-selected` on the host instead is the same fault under another name.\n\nThe stylesheet reads it from the row inside this shadow root, because the\nrow is not part of the tree React hydrates.",
               "fieldName": "selected",
               "inheritedFrom": {
                 "name": "HelixHeadlessTreeItem",
@@ -132986,7 +132969,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tree",
             "aliases": [
               "FileTree",
@@ -133012,10 +132995,6 @@
                 "description": "Choosing bubbles to the tree and opening does not, which is why they are bound apart.",
                 "slug": "events"
               },
-              {
-                "description": "A node told its own depth, for a tree built from a flat list rather than by nesting.",
-                "slug": "flattened"
-              },
               {
                 "description": "Depth as a position, depth as a rank, and a branch that is a heading.",
                 "slug": "nesting"

package/dist/table/cell/table-cell.d.ts

@@ -10,7 +10,7 @@ import type { CSSResultGroup } from 'lit';
  * identifier breaks rather than running into the next column.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @documentation https://fusion.dev/helix/components/table
  *
  * @slot - The cell's content.

package/dist/table/column/table-column.d.ts

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * table.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases Column header, Th
  * @documentation https://fusion.dev/helix/components/table
  */

package/dist/table/root/table-root.d.ts

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * decorating none of it.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category data
  * @documentation https://fusion.dev/helix/components/table
  *
@@ -17,7 +17,7 @@ import type { CSSResultGroup } from 'lit';
  *
  * @csspart table - The grid.
  *
- * @cssproperty --table-columns - Track list for the columns.
+ * @cssproperty --table-columns - Track list for the columns, which wins over the one the columns worked out.
  */
 export declare class HelixTable extends HelixHeadlessTable {
     static styles: CSSResultGroup;

package/dist/table/row/table-row.d.ts

@@ -10,7 +10,7 @@ import type { CSSResultGroup } from 'lit';
  * columns.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @documentation https://fusion.dev/helix/components/table
  *
  * @slot - The row's cells.

package/dist/tree/item/tree-item.d.ts

@@ -14,7 +14,7 @@ import type { CSSResultGroup } from 'lit';
  * the row itself stays flat.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases TreeNode, Branch, Leaf
  * @documentation https://fusion.dev/helix/components/tree
  *

package/dist/tree/root/tree-root.d.ts

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * to it is one more thing between the reader and the label.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases FileTree, Navigation tree
  * @documentation https://fusion.dev/helix/components/tree

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix",
   "description": "Styled component tier. Extends the headless tier with token-driven presentation.",
-  "version": "0.46.1",
+  "version": "0.47.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -47,14 +47,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.46.1",
-    "@fusion.dev/helix-headless": "0.46.1",
-    "@fusion.dev/helix-styles": "0.46.1"
+    "@fusion.dev/helix-core": "0.47.0",
+    "@fusion.dev/helix-headless": "0.47.0",
+    "@fusion.dev/helix-styles": "0.47.0"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.46.1",
-    "@fusion.dev/helix-testing": "0.46.1",
+    "@fusion.dev/helix-cem": "0.47.0",
+    "@fusion.dev/helix-testing": "0.47.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -16525,7 +16525,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?: (HelixTable["columns"]) | undefined;
   /** Accessible name for the table. */
   label?: (HelixTable["label"]) | undefined;
@@ -16563,7 +16576,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"?: (HelixTable["columns"]) | undefined;
   /** Accessible name for the table. */
   "prop:label"?: (HelixTable["label"]) | undefined;
@@ -19067,13 +19093,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?: (HelixTreeItem["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?: (HelixTreeItem["level"]) | undefined;
   /** What the link declares about where it goes.
 
 Set by the consumer rather than derived from `target`: `noreferrer` is a
@@ -19083,7 +19102,7 @@ this library supports implies it for `target="_blank"` already. */
   rel?: (HelixTreeItem["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.
@@ -19095,6 +19114,24 @@ row is not part of the tree React hydrates. */
   target?: (HelixTreeItem["target"]) | undefined;
   /** Identifies the item to the consumer, carried in `helix-select`. */
   value?: (HelixTreeItem["value"]) | 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?: (HelixTreeItem["level"]) | undefined;
   /** Whether this item holds the tree's single tab stop. */
   focusable?: (HelixTreeItem["focusable"]) | undefined;
 
@@ -19134,13 +19171,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"?: (HelixTreeItem["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"?: (HelixTreeItem["level"]) | undefined;
   /** What the link declares about where it goes.
 
 Set by the consumer rather than derived from `target`: `noreferrer` is a
@@ -19150,7 +19180,7 @@ this library supports implies it for `target="_blank"` already. */
   "prop:rel"?: (HelixTreeItem["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.
@@ -19162,6 +19192,24 @@ row is not part of the tree React hydrates. */
   "prop:target"?: (HelixTreeItem["target"]) | undefined;
   /** Identifies the item to the consumer, carried in `helix-select`. */
   "prop:value"?: (HelixTreeItem["value"]) | 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"?: (HelixTreeItem["level"]) | undefined;
   /** Whether this item holds the tree's single tab stop. */
   "prop:focusable"?: (HelixTreeItem["focusable"]) | undefined;
   /** Fired when the item is chosen. Cancelable: refusing it takes the decision and nothing moves. */
@@ -36009,6 +36057,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.
    * - `tableColumns`: The columns declared as children, in the order they are written. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -36042,7 +36103,7 @@ export type CustomElements = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--table-columns`: Track list for the columns. (default: `undefined`)
+   * - `--table-columns`: Track list for the columns, which wins over the one the columns worked out. (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
@@ -38507,12 +38568,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
@@ -38521,7 +38576,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.
@@ -38530,6 +38585,23 @@ export type CustomElements = {
    * row is not part of the tree React hydrates.
    * - `target`: Where the link opens, for the rare row that leaves the site.
    * - `value`: Identifies the item to the consumer, carried in `helix-select`.
+   * - `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.
    *
@@ -55600,6 +55672,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.
    * - `tableColumns`: The columns declared as children, in the order they are written. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -55633,7 +55718,7 @@ export type CustomElementsSolidJs = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--table-columns`: Track list for the columns. (default: `undefined`)
+   * - `--table-columns`: Track list for the columns, which wins over the one the columns worked out. (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
@@ -58157,12 +58242,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
@@ -58171,7 +58250,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.
@@ -58180,6 +58259,23 @@ export type CustomElementsSolidJs = {
    * row is not part of the tree React hydrates.
    * - `target`: Where the link opens, for the rare row that leaves the site.
    * - `value`: Identifies the item to the consumer, carried in `helix-select`.
+   * - `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.
    *
@@ -60117,7 +60213,7 @@ export type CustomCssProperties = {
   "--switch-thumb-color"?: (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. */
+  /** Track list for the columns, which wins over the one the columns worked out. */
   "--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;

package/types/vue.d.ts

@@ -8482,7 +8482,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?: (HelixTable["columns"]) | undefined;
   /** Accessible name for the table. */
   label?: (HelixTable["label"]) | undefined;
@@ -9792,13 +9805,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?: (HelixTreeItem["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?: (HelixTreeItem["level"]) | undefined;
   /** What the link declares about where it goes.
 
 Set by the consumer rather than derived from `target`: `noreferrer` is a
@@ -9808,7 +9814,7 @@ this library supports implies it for `target="_blank"` already. */
   rel?: (HelixTreeItem["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.
@@ -9820,6 +9826,24 @@ row is not part of the tree React hydrates. */
   target?: (HelixTreeItem["target"]) | undefined;
   /** Identifies the item to the consumer, carried in `helix-select`. */
   value?: (HelixTreeItem["value"]) | 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?: (HelixTreeItem["level"]) | undefined;
   /** Whether this item holds the tree's single tab stop. */
   focusable?: (HelixTreeItem["focusable"]) | undefined;
 };
@@ -11299,7 +11323,7 @@ export type CustomCssProperties = {
   "--switch-thumb-color"?: (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. */
+  /** Track list for the columns, which wins over the one the columns worked out. */
   "--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;