@fusion.dev/helix-headless 0.30.2 → 0.32.0

package/types/vue.d.ts

@@ -4707,8 +4707,10 @@ answer, and asking them to encode it as thresholds so this can decode it
 again is a worse API than letting them say it.
 
 Not reflected. Nothing selects on it: the band reaches the stylesheet as
-`data-band` on the fill, because that is the element being colored, so
-reflecting here would write an attribute onto the host for no reader. */
+`data-band` on the fill, because that is the element being colored, and a
+stylesheet outside as `indicator-good`, `-fair` or `-poor` among the fill's
+part names, so reflecting here would write an attribute onto the host for
+no reader. */
   band?: (HelixHeadlessMeter["band"]) | undefined;
   /** Bottom of the high band.
 
@@ -6832,7 +6834,18 @@ export type HelixHeadlessTableColumnVueProps = {
 
 `end` is what a column of numbers wants, so digits of the same magnitude sit
 above each other. Left unset the cell inherits the table's own alignment,
-which is `start` for text in either writing direction. */
+which is `start` for text in either writing direction. `helix-data-table`
+aligns the cells it draws; a `helix-table`'s cells are markup the consumer
+wrote, and align as the consumer styles them. The heading is this element's
+own, and `@fusion.dev/helix` sets it to the same edge in either table.
+
+**Reflected, because the heading is drawn by a stylesheet and has no other
+way to learn it.** Set as a property, which is how React sets it, an
+unreflected `align` left no attribute to select on, so the heading stayed at
+the start over a column of digits set to the end. It is the author's
+declaration and nothing moves it afterwards, so an attribute cannot come to
+disagree with the element, which is the reason `open` records a custom
+state instead. No default, so an unset column writes nothing onto its host. */
   align?: (HelixHeadlessTableColumn["align"]) | undefined;
   /** The key this column reads out of a row.
 
@@ -9018,7 +9031,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessDrawerVueProps,
     HelixHeadlessDrawerVueEvents
   >;
-  /** A row that opens a page *contains* that page: its rows are this row's own children, assigned to the 'page' slot. The tree is the structure, so there are no ids to wire and a consumer who moves a row has moved its page with it.  **It renders one of three things**, and which one is the stack's business rather than its own. On the page showing, it is a row. Showing its own page, it contributes that page's rows and nothing else, because its row belongs to the page above. On neither, it renders nothing at all: the rows are in the light DOM and come back untouched, so there is no state to keep and nothing to hide with an attribute this element would have to write onto itself.  Choosing is announced, never applied. The row dispatches and the stack decides whether that means drilling in or choosing a command. */
+  /** A row that opens a page *contains* that page: its rows are this row's own children, assigned to the 'page' slot. The tree is the structure, so there are no ids to wire and a consumer who moves a row has moved its page with it.  **It renders one of three things**, and which one is the stack's business rather than its own. On the page showing, it is a row. Showing its own page, it contributes that page's rows and nothing else, because its row belongs to the page above. On neither, it renders nothing at all: the rows are in the light DOM and come back untouched, so there is no state to keep and nothing to hide with an attribute this element would have to write onto itself.  Choosing is announced, never applied. The row dispatches and the stack decides whether that means drilling in or choosing a command.  **A row that opens a page says so**, with a caret after its words and 'aria-haspopup', the way 'Menu' marks a row with a submenu: a row that goes somewhere and a row that does something otherwise look the same until one is pressed. Not on the server, which cannot see the children and so cannot know. */
   "helix-headless-drilldown-item": DefineCustomElement<
     HelixHeadlessDrilldownItem,
     HelixHeadlessDrilldownItemVueProps,