@fusion.dev/helix-headless 0.53.2 → 0.53.3

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

@@ -36,9 +36,10 @@ declare const HelixHeadlessDataTable_base: (new (...args: any[]) => import("@fus
  * **`selectable` adds a column of checkboxes, keyed on `row-key`.** A row is
  * selected by its identity rather than its position, so a selection survives a
  * sort, a filter and a page. `selected` is the chosen keys, comma separated, the
- * shape Listbox uses for a multiple choice, and like `sort` it is controlled
- * when set and seeded by `default-selected`. The box in the heading selects every
- * row in the result, across pages, and shows a dash while only some are chosen.
+ * shape Listbox uses for a multiple choice, and like `sort` writing it applies
+ * while `default-selected` is what the markup declared. The box in the heading
+ * selects every row in the result, across pages, and shows a dash while only
+ * some are chosen.
  * Choosing one of many, rather than several, is opening a row, and that is a
  * link or a button in a cell rather than a selection.
  *

package/dist/donut-chart/root/donut-chart-root.d.ts

@@ -91,7 +91,7 @@ export declare class HelixHeadlessDonutChart extends HelixHeadlessDonutChart_bas
      * `--donut-chart-stroke`, which is a number a rule can do sums with where the
      * word is not. Reflected, it wrote a value onto every host a script had set
      * it on for nothing to read. `sweep` beside it is the converse and reflects,
-     * because three rules select on it.
+     * because the styled sheet selects on it.
      */
     hole?: 'large' | 'none' | 'small';
     /**

package/dist/filter-input/root/filter-input-root.d.ts

@@ -56,20 +56,19 @@ declare const HelixHeadlessFilterInput_base: (new (...args: any[]) => import("@f
  * `selectionStart` and `setSelectionRange` to write a completion back and put
  * the caret after it, or the next parse reads the wrong term.
  *
- * **Three things here have three different owners, and only one of them is a
- * controlled property.**
+ * **Three things here have three different owners.**
  *
- * `value` is the text, and it is uncontrolled by default: the reader types, the
- * element applies it, and `input` says so. **Writing `value` does not take that
- * over.** It is a seed and a correction, so a consumer who sets it and then
- * expects the field to hold still will watch the next keystroke overwrite them.
+ * `value` is the text: the reader types, the element applies it, and `input`
+ * says so. **Writing `value` does not take that over.** It is a seed and a
+ * correction, so a consumer who sets it and then expects the field to hold
+ * still will watch the next keystroke overwrite them.
  * Ownership is taken by refusing `helix-before-change` and writing the value
  * you want, which is the same shape every field in this library uses and is
  * worth saying out loud here because the property looks like React's.
  * `default-value` seeds the field without claiming anything.
  *
- * `open` is the suggestions panel, and it is the ordinary controlled pair:
- * refuse `helix-before-open` or `helix-before-close` to take the decision, and
+ * `open` is the suggestions panel, and it is the ordinary pair: refuse
+ * `helix-before-open` or `helix-before-close` to take the decision, and
  * `default-open` to seed it.
  *
  * The tokens are neither, because they are not state. They are the consumer's

package/dist/object-inspector/root/object-inspector-root.d.ts

@@ -153,6 +153,16 @@ export declare class HelixHeadlessObjectInspector extends HelixElement {
     private active;
     /** Set by a keyboard move, so the next render brings the active row into view. */
     private revealing;
+    /**
+     * How tall a row is taken to be before it has been drawn, in pixels.
+     *
+     * A constant rather than the property `VirtualList` and `DataTable` carry:
+     * every row here is one line of the same text at this family's own leading,
+     * so there is nothing for a consumer to tell it. `reveal` falls back to this
+     * when a drawn row measures zero, and the two have to be the same number or a
+     * keyboard move scrolls by a different row than the window counted with.
+     */
+    static readonly ESTIMATE = 24;
     private readonly virtualize;
     private get root();
     /** Every visible row, in order, worked out once per change rather than per read. */

package/dist/object-inspector/root/object-inspector-root.js

@@ -4,6 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var HelixHeadlessObjectInspector_1;
 import { CopyController, customElement, HelixElement, inlineStep, scrollItemIntoView, VirtualizeController, } from '@fusion.dev/helix-core';
 import { caretDown, caretRight } from '@fusion.dev/helix-icons';
 import { html, nothing } from 'lit';
@@ -30,7 +31,7 @@ let HelixHeadlessObjectInspector = class HelixHeadlessObjectInspector extends He
         this.virtualize = new VirtualizeController(this, {
             container: () => (this.windowed ? this.partNamed('tree') : null),
             count: () => this.rows.length,
-            estimate: () => 24,
+            estimate: () => HelixHeadlessObjectInspector_1.ESTIMATE,
             measured: () => this.windowed,
             rows: () => [...(this.renderRoot?.querySelectorAll('[part~="row"]') ?? [])].map((element) => ({ element, index: Number(element.dataset.index) })),
         });
@@ -95,6 +96,8 @@ let HelixHeadlessObjectInspector = class HelixHeadlessObjectInspector extends He
             event.preventDefault();
         };
     }
+    static { HelixHeadlessObjectInspector_1 = this; }
+    static { this.ESTIMATE = 24; }
     get root() {
         return this.value === undefined ? this.read : this.value;
     }
@@ -196,7 +199,7 @@ let HelixHeadlessObjectInspector = class HelixHeadlessObjectInspector extends He
         if (!tree || !this.windowed || !first || !last || attempts === 0) {
             return;
         }
-        const height = first.offsetHeight || 24;
+        const height = first.offsetHeight || HelixHeadlessObjectInspector_1.ESTIMATE;
         const from = Number(this.active > Number(last.dataset.index) ? last.dataset.index : first.dataset.index);
         tree.scrollTop += (this.active - from) * height;
         this.virtualize.measure();
@@ -347,7 +350,7 @@ __decorate([
 __decorate([
     state()
 ], HelixHeadlessObjectInspector.prototype, "active", void 0);
-HelixHeadlessObjectInspector = __decorate([
+HelixHeadlessObjectInspector = HelixHeadlessObjectInspector_1 = __decorate([
     customElement('helix-headless-object-inspector')
 ], HelixHeadlessObjectInspector);
 export { HelixHeadlessObjectInspector };

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

@@ -72,11 +72,10 @@ export declare class HelixHeadlessOption extends HelixElement {
      * A second destination for this row, taken with the modifier held.
      *
      * **An attribute rather than a second row, which is the whole point.** A
-     * palette of eighty-eight components that offered each of them a reference
-     * page and a sandbox as separate entries would be a palette of a hundred and
-     * seventy-six, and one earns its keep by getting a reader to one thing in
-     * three keystrokes. The row already carries the first destination, so the
-     * second belongs beside it.
+     * palette that offered every component a reference page and a sandbox as
+     * separate entries would be twice as long, and one earns its keep by getting
+     * a reader to one thing in three keystrokes. The row already carries the
+     * first destination, so the second belongs beside it.
      *
      * Declared here and acted on by whatever owns the list, the same division
      * selection already uses: an option says what it is and the listbox decides

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

@@ -269,9 +269,9 @@ export declare class HelixHeadlessPagination extends HelixElement {
     /**
      * Says where the reader now is, once they have moved.
      *
-     * In `updated` rather than in `request`, so it covers both modes: a controlled
-     * consumer assigns `page` and never goes through the request path at all, and
-     * a reader who got there that way deserves the same sentence.
+     * In `updated` rather than in `request`, so it covers every path a page moves
+     * by: a consumer assigning `page` reaches no request at all, and a reader who
+     * got there that way deserves the same sentence.
      */
     protected updated(changed: PropertyValues): void;
     /**

package/dist/pagination/size/pagination-size.d.ts

@@ -27,7 +27,8 @@ import '../../select/index.js';
  * way, through `ElementInternals.states` rather than an attribute the server
  * never wrote.
  *
- * `value` is the controlled property and `default-value` seeds one this owns.
+ * `value` is the size the control holds and `default-value` is what the markup
+ * declared.
  * Changing it announces `helix-before-change`; re-querying and moving back to
  * page one is the consumer's, because only they know whether the reader's
  * position should survive it.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-headless",
   "description": "Headless component tier. Structure, accessibility, state, and form participation. No styling.",
-  "version": "0.53.2",
+  "version": "0.53.3",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -46,14 +46,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.53.2",
-    "@fusion.dev/helix-icons": "0.53.2",
+    "@fusion.dev/helix-core": "0.53.3",
+    "@fusion.dev/helix-icons": "0.53.3",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.53.2",
-    "@fusion.dev/helix-testing": "0.53.2",
+    "@fusion.dev/helix-cem": "0.53.3",
+    "@fusion.dev/helix-testing": "0.53.3",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^4.1.0",