@fusion.dev/helix-headless 0.34.2 → 0.35.0

package/custom-elements.json

@@ -15478,11 +15478,10 @@
           "helix": {
             "category": "forms",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://helix.fusion.dev/components/checkbox",
             "aliases": [
-              "Tickbox",
-              "Toggle"
+              "Tickbox"
             ],
             "tier": "headless",
             "group": "BaseCheckbox",
@@ -24255,7 +24254,7 @@
           "helix": {
             "category": "actions",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://helix.fusion.dev/components/copy-button",
             "aliases": [
               "Copy",
@@ -49231,7 +49230,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://helix.fusion.dev/components/legend",
             "aliases": [
               "Key",
@@ -79009,7 +79008,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://helix.fusion.dev/components/sparkline",
             "aliases": [
               "Micro Chart",
@@ -108095,7 +108094,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "**The set arrives as data, which is what makes this a virtual list rather\nthan a box that hides children.** `for` names a\n`<script type=\"application/json\">` holding an array of objects, and a\n`<template>` child says what one row looks like: elements carrying\n`data-field=\"name\"` are filled with that field of the item.\n\nBoth halves are markup, and that is the reason for the shape. An `items`\nproperty cannot survive React hydration, which skips every property it would\nhave to apply imperatively, and light-DOM children exist by the time anything\ncould decide not to create them. Text in the document is neither, and it is\none node whatever the row count.\n\n**The accessible version is not a `<table>`**, the way it is for the charts\nthat share this `for=\"<id>\"` shape: ten thousand rows in one is the cost this\nexists to avoid. It is the rendered window plus `aria-setsize`.",
+          "description": "**The set arrives as data, which is what makes this a virtual list rather\nthan a box that hides children.** `for` names a\n`<script type=\"application/json\">` holding an array of objects, and a\n`<template>` child says what one row looks like: elements carrying\n`data-field=\"name\"` are filled with that field of the item.\n\nBoth halves are markup, and that is the reason for the shape. An `items`\nproperty cannot survive React hydration, which skips every property it would\nhave to apply imperatively, and light-DOM children exist by the time anything\ncould decide not to create them. Text in the document is neither, and it is\none node whatever the row count.\n\n**The accessible version is not a `<table>`**, the way it is for the charts\nthat share this `for=\"<id>\"` shape: ten thousand rows in one is the cost this\nexists to avoid. It is the rendered window plus `aria-setsize`.\n\n**The box scrolls on this tier.** The viewport carries `data-scroller` and\n`core` ships `[data-scroller] { overflow: auto }` into every shadow root, so\n`scrollTop` exists with no stylesheet at all. What a headless consumer still\nhas to supply is a block size, which is a design decision; the `overflow`\nthey used to supply was a mechanism they had no way of knowing was missing.",
           "name": "HelixHeadlessVirtualList",
           "cssParts": [
             {
@@ -108107,7 +108106,7 @@
               "name": "before"
             },
             {
-              "description": "The scrolling box. Needs a block size and an overflow on this tier.",
+              "description": "The scrolling box. Needs a block size on this tier, and nothing else.",
               "name": "viewport"
             }
           ],
@@ -108581,7 +108580,7 @@
           "helix": {
             "category": "layout",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://helix.fusion.dev/components/virtual-list",
             "tier": "headless",
             "group": "BaseVirtualList",

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

@@ -24,9 +24,9 @@ declare const HelixHeadlessCheckbox_base: (new (...args: any[]) => import("@fusi
  * third state that survives interaction is a control nobody can finish.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category forms
- * @aliases Tickbox, Toggle
+ * @aliases Tickbox
  * @documentation https://helix.fusion.dev/components/checkbox
  *
  * @slot - The label.

package/dist/copy-button/root/copy-button-root.d.ts

@@ -17,7 +17,7 @@ import '../../tooltip/index.js';
  * the button exactly as it was.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category actions
  * @aliases Copy, Copy to clipboard
  * @documentation https://helix.fusion.dev/components/copy-button

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

@@ -16,7 +16,7 @@ import { type PropertyValues, type TemplateResult } from 'lit';
  * **The table is resolved on the client and there is no server pass.**
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category charts
  * @aliases Key, Series Key
  * @documentation https://helix.fusion.dev/components/legend

package/dist/legend/root/legend-root.js

@@ -4,10 +4,9 @@ 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;
 };
-import { customElement, HelixElement, SourceController } from '@fusion.dev/helix-core';
+import { customElement, HelixElement, SourceController, seriesIndex, } from '@fusion.dev/helix-core';
 import { html } from 'lit';
 import { property } from 'lit/decorators.js';
-const PALETTE = 24;
 let HelixHeadlessLegend = class HelixHeadlessLegend extends HelixElement {
     constructor() {
         super(...arguments);
@@ -28,9 +27,9 @@ let HelixHeadlessLegend = class HelixHeadlessLegend extends HelixElement {
     render() {
         return html `<ul part="list" role="list">
       ${this.names().map((name, index) => html `<li
-          data-series=${(index % PALETTE) + 1}
+          data-series=${seriesIndex(index)}
           part="entry"
-          style="--chart-series: var(--chart-series-${(index % PALETTE) + 1})"
+          style="--chart-series: var(--chart-series-${seriesIndex(index)})"
           role="listitem"
         >
           <span aria-hidden="true" part="swatch"></span>

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

@@ -32,7 +32,7 @@ import { type PropertyValues, type TemplateResult } from 'lit';
  * without measuring anything itself.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category charts
  * @aliases Micro Chart, Trend Line, Inline Chart
  * @documentation https://helix.fusion.dev/components/sparkline

package/dist/virtual-list/root/virtual-list-root.d.ts

@@ -20,14 +20,20 @@ import { type PropertyValues, type TemplateResult } from 'lit';
  * that share this `for="<id>"` shape: ten thousand rows in one is the cost this
  * exists to avoid. It is the rendered window plus `aria-setsize`.
  *
+ * **The box scrolls on this tier.** The viewport carries `data-scroller` and
+ * `core` ships `[data-scroller] { overflow: auto }` into every shadow root, so
+ * `scrollTop` exists with no stylesheet at all. What a headless consumer still
+ * has to supply is a block size, which is a design decision; the `overflow`
+ * they used to supply was a mechanism they had no way of knowing was missing.
+ *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category layout
  * @documentation https://helix.fusion.dev/components/virtual-list
  *
  * @csspart after - The space standing in for rows below the window.
  * @csspart before - The space standing in for rows above the window.
- * @csspart viewport - The scrolling box. Needs a block size and an overflow on this tier.
+ * @csspart viewport - The scrolling box. Needs a block size on this tier, and nothing else.
  */
 export declare class HelixHeadlessVirtualList extends HelixElement {
     /**

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.34.2",
+  "version": "0.35.0",
   "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.34.2",
-    "@fusion.dev/helix-icons": "0.34.2",
+    "@fusion.dev/helix-core": "0.35.0",
+    "@fusion.dev/helix-icons": "0.35.0",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.34.2",
-    "@fusion.dev/helix-testing": "0.34.2",
+    "@fusion.dev/helix-cem": "0.35.0",
+    "@fusion.dev/helix-testing": "0.35.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

@@ -34363,6 +34363,12 @@ export type CustomElements = {
    * that share this `for="<id>"` shape: ten thousand rows in one is the cost this
    * exists to avoid. It is the rendered window plus `aria-setsize`.
    *
+   * **The box scrolls on this tier.** The viewport carries `data-scroller` and
+   * `core` ships `[data-scroller] { overflow: auto }` into every shadow root, so
+   * `scrollTop` exists with no stylesheet at all. What a headless consumer still
+   * has to supply is a block size, which is a design decision; the `overflow`
+   * they used to supply was a mechanism they had no way of knowing was missing.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -34407,7 +34413,7 @@ export type CustomElements = {
    *
    * - `after`: The space standing in for rows below the window.
    * - `before`: The space standing in for rows above the window.
-   * - `viewport`: The scrolling box. Needs a block size and an overflow on this tier.
+   * - `viewport`: The scrolling box. Needs a block size on this tier, and nothing else.
    *
    * ## CSS States
    *
@@ -52050,6 +52056,12 @@ export type CustomElementsSolidJs = {
    * that share this `for="<id>"` shape: ten thousand rows in one is the cost this
    * exists to avoid. It is the rendered window plus `aria-setsize`.
    *
+   * **The box scrolls on this tier.** The viewport carries `data-scroller` and
+   * `core` ships `[data-scroller] { overflow: auto }` into every shadow root, so
+   * `scrollTop` exists with no stylesheet at all. What a headless consumer still
+   * has to supply is a block size, which is a design decision; the `overflow`
+   * they used to supply was a mechanism they had no way of knowing was missing.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -52094,7 +52106,7 @@ export type CustomElementsSolidJs = {
    *
    * - `after`: The space standing in for rows below the window.
    * - `before`: The space standing in for rows above the window.
-   * - `viewport`: The scrolling box. Needs a block size and an overflow on this tier.
+   * - `viewport`: The scrolling box. Needs a block size on this tier, and nothing else.
    *
    * ## CSS States
    *

package/types/vue.d.ts

@@ -9637,7 +9637,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessVideoVueProps,
     HelixHeadlessVideoVueEvents
   >;
-  /** **The set arrives as data, which is what makes this a virtual list rather than a box that hides children.** 'for' names a '<script type="application/json">' holding an array of objects, and a '<template>' child says what one row looks like: elements carrying 'data-field="name"' are filled with that field of the item.  Both halves are markup, and that is the reason for the shape. An 'items' property cannot survive React hydration, which skips every property it would have to apply imperatively, and light-DOM children exist by the time anything could decide not to create them. Text in the document is neither, and it is one node whatever the row count.  **The accessible version is not a '<table>'**, the way it is for the charts that share this 'for="<id>"' shape: ten thousand rows in one is the cost this exists to avoid. It is the rendered window plus 'aria-setsize'. */
+  /** **The set arrives as data, which is what makes this a virtual list rather than a box that hides children.** 'for' names a '<script type="application/json">' holding an array of objects, and a '<template>' child says what one row looks like: elements carrying 'data-field="name"' are filled with that field of the item.  Both halves are markup, and that is the reason for the shape. An 'items' property cannot survive React hydration, which skips every property it would have to apply imperatively, and light-DOM children exist by the time anything could decide not to create them. Text in the document is neither, and it is one node whatever the row count.  **The accessible version is not a '<table>'**, the way it is for the charts that share this 'for="<id>"' shape: ten thousand rows in one is the cost this exists to avoid. It is the rendered window plus 'aria-setsize'.  **The box scrolls on this tier.** The viewport carries 'data-scroller' and 'core' ships '[data-scroller] { overflow: auto }' into every shadow root, so 'scrollTop' exists with no stylesheet at all. What a headless consumer still has to supply is a block size, which is a design decision; the 'overflow' they used to supply was a mechanism they had no way of knowing was missing. */
   "helix-headless-virtual-list": DefineCustomElement<
     HelixHeadlessVirtualList,
     HelixHeadlessVirtualListVueProps,