@fusion.dev/helix-headless 0.186.1 → 0.188.0

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.186.1",
+  "version": "0.188.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -21,7 +21,9 @@
       "types": "./dist/*/index.d.ts",
       "default": "./dist/*/index.js"
     },
+    "./api.json": "./api.json",
     "./custom-elements.json": "./custom-elements.json",
+    "./examples.json": "./examples.json",
     "./jsx": "./types/jsx.d.ts",
     "./lint.json": "./lint.json",
     "./svelte": "./types/svelte.d.ts",
@@ -29,8 +31,10 @@
     "./words": "./types/words.d.ts"
   },
   "files": [
+    "api.json",
     "custom-elements.json",
     "dist",
+    "examples.json",
     "lint.json",
     "types"
   ],
@@ -49,14 +53,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.186.1",
-    "@fusion.dev/helix-icons": "0.186.1",
+    "@fusion.dev/helix-core": "0.188.0",
+    "@fusion.dev/helix-icons": "0.188.0",
     "tslib": "^2.8.1",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.186.1",
-    "@fusion.dev/helix-testing": "0.186.1",
+    "@fusion.dev/helix-cem": "0.188.0",
+    "@fusion.dev/helix-testing": "0.188.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.14.5",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -16990,7 +16990,7 @@ The state is `aria-pressed`, not this. */
 validation.
 
 **Not reflected.** Reflection exists so a selector can reach a value, and
-no stylesheet in this repository selects on `type`. Reflecting it writes
+no Helix stylesheet selects on `type`. Reflecting it writes
 `type="text"` onto every `<helix-headless-input>` ever rendered, an
 attribute no consumer's markup has, which is the fault the area rules write
 up under `Button`'s `href`, `target` and `rel`.
@@ -17237,7 +17237,7 @@ The state is `aria-pressed`, not this. */
 validation.
 
 **Not reflected.** Reflection exists so a selector can reach a value, and
-no stylesheet in this repository selects on `type`. Reflecting it writes
+no Helix stylesheet selects on `type`. Reflecting it writes
 `type="text"` onto every `<helix-headless-input>` ever rendered, an
 attribute no consumer's markup has, which is the fault the area rules write
 up under `Button`'s `href`, `target` and `rel`.
@@ -50170,7 +50170,7 @@ export type CustomElements = {
    * renders its full inner markup, because most icons are several elements, each
    * with its own stroke and fill.
    *
-   * The markup is generated at build time from SVG files in this repository and
+   * The markup is generated at build time from the SVG files Helix ships and
    * never comes from user input, so rendering it with `unsafeSVG` is safe.
    *
    * The `<svg>` carries `fill="currentColor"`. The generator keeps only the inner
@@ -50541,7 +50541,7 @@ export type CustomElements = {
    * validation.
    *
    * **Not reflected.** Reflection exists so a selector can reach a value, and
-   * no stylesheet in this repository selects on `type`. Reflecting it writes
+   * no Helix stylesheet selects on `type`. Reflecting it writes
    * `type="text"` onto every `<helix-headless-input>` ever rendered, an
    * attribute no consumer's markup has, which is the fault the area rules write
    * up under `Button`'s `href`, `target` and `rel`.
@@ -62440,6 +62440,7 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The table's rows.
+   * - `columns`: The columns, as `TableColumn` elements. The table moves each column here itself, so markup that runs in a browser leaves it out; a server-rendered page writes `slot="columns"` on each column so the headings sit in place before the table upgrades.
    * - `empty`: Content shown when there are no rows and none are loading, such as a picture and a link. Falls back to `empty-text`, which the live region still says.
    * - `error`: Content shown while `error-text` is set, such as a button that tries again. Falls back to `error-text`, which the live region still says.
    * - `heading`: Words that name the table, shown above it, such as a heading.
@@ -80411,7 +80412,7 @@ export type CustomElementsSolidJs = {
    * renders its full inner markup, because most icons are several elements, each
    * with its own stroke and fill.
    *
-   * The markup is generated at build time from SVG files in this repository and
+   * The markup is generated at build time from the SVG files Helix ships and
    * never comes from user input, so rendering it with `unsafeSVG` is safe.
    *
    * The `<svg>` carries `fill="currentColor"`. The generator keeps only the inner
@@ -80788,7 +80789,7 @@ export type CustomElementsSolidJs = {
    * validation.
    *
    * **Not reflected.** Reflection exists so a selector can reach a value, and
-   * no stylesheet in this repository selects on `type`. Reflecting it writes
+   * no Helix stylesheet selects on `type`. Reflecting it writes
    * `type="text"` onto every `<helix-headless-input>` ever rendered, an
    * attribute no consumer's markup has, which is the fault the area rules write
    * up under `Button`'s `href`, `target` and `rel`.
@@ -92835,6 +92836,7 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The table's rows.
+   * - `columns`: The columns, as `TableColumn` elements. The table moves each column here itself, so markup that runs in a browser leaves it out; a server-rendered page writes `slot="columns"` on each column so the headings sit in place before the table upgrades.
    * - `empty`: Content shown when there are no rows and none are loading, such as a picture and a link. Falls back to `empty-text`, which the live region still says.
    * - `error`: Content shown while `error-text` is set, such as a button that tries again. Falls back to `error-text`, which the live region still says.
    * - `heading`: Words that name the table, shown above it, such as a heading.

package/types/vue.d.ts

@@ -8739,7 +8739,7 @@ The state is `aria-pressed`, not this. */
 validation.
 
 **Not reflected.** Reflection exists so a selector can reach a value, and
-no stylesheet in this repository selects on `type`. Reflecting it writes
+no Helix stylesheet selects on `type`. Reflecting it writes
 `type="text"` onto every `<helix-headless-input>` ever rendered, an
 attribute no consumer's markup has, which is the fault the area rules write
 up under `Button`'s `href`, `target` and `rel`.
@@ -19901,7 +19901,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessIconButtonVueProps,
     HelixHeadlessIconButtonVueEvents
   >;
-  /** The icons are Phosphor, drawn on a 256 box at stroke-width 16. Each glyph renders its full inner markup, because most icons are several elements, each with its own stroke and fill.  The markup is generated at build time from SVG files in this repository and never comes from user input, so rendering it with 'unsafeSVG' is safe.  The '<svg>' carries 'fill="currentColor"'. The generator keeps only the inner markup, and Phosphor sets its fill on the root tag that the generator discards. Without it, the 65 solid glyphs fall back to black and disappear on a dark background. Shapes that set their own 'fill' or 'stroke' are unaffected.  **A name is looked up in a registry.** The family's entry registers the whole set, so any name in it draws, and 'icon/all' registers the same set. The element's own entry, '@fusion.dev/helix-headless/icon/root', registers none: a page that imports it and calls 'registerIcons' with the glyphs it names ships those and no others. 'registerIconLibrary' resolves names under a prefix of your own, such as 'lucide:camera', at once or later, and the element fires 'load' when a glyph that came later is drawn. A glyph registered after the element rendered is drawn then.  **Or point 'src' at an SVG file**, such as 'src="/icons/rocket.svg"', and the element fetches it and draws its shapes in 'currentColor' where the file does not color them. A file is fetched once a page, however many icons name it, and 'load' fires when it is drawn. Scripts, event handlers and 'javascript:' links in the file are taken out before it is drawn. A server fetches nothing, so a served icon with a 'src' is drawn once the script runs.  A name with no match, or a 'src' that is no SVG, renders nothing, and the element fires 'error', so a typo in a name can be heard. It waits until the page has loaded and painted first, so a library a later module registers is not taken for a typo.  An icon is decorative by default and hidden from assistive technology. Set 'label' only when the icon is the only carrier of meaning, such as in a button with no text. An 'aria-label' on the element works too: the element is then an image with that name.  **A decorative icon that is all a control holds is reported.** In a development build, a button or a link whose only content is an icon with no 'label', and which has no name of its own, warns 'missing-name' once, through the runtime channel every Helix warning uses. */
+  /** The icons are Phosphor, drawn on a 256 box at stroke-width 16. Each glyph renders its full inner markup, because most icons are several elements, each with its own stroke and fill.  The markup is generated at build time from the SVG files Helix ships and never comes from user input, so rendering it with 'unsafeSVG' is safe.  The '<svg>' carries 'fill="currentColor"'. The generator keeps only the inner markup, and Phosphor sets its fill on the root tag that the generator discards. Without it, the 65 solid glyphs fall back to black and disappear on a dark background. Shapes that set their own 'fill' or 'stroke' are unaffected.  **A name is looked up in a registry.** The family's entry registers the whole set, so any name in it draws, and 'icon/all' registers the same set. The element's own entry, '@fusion.dev/helix-headless/icon/root', registers none: a page that imports it and calls 'registerIcons' with the glyphs it names ships those and no others. 'registerIconLibrary' resolves names under a prefix of your own, such as 'lucide:camera', at once or later, and the element fires 'load' when a glyph that came later is drawn. A glyph registered after the element rendered is drawn then.  **Or point 'src' at an SVG file**, such as 'src="/icons/rocket.svg"', and the element fetches it and draws its shapes in 'currentColor' where the file does not color them. A file is fetched once a page, however many icons name it, and 'load' fires when it is drawn. Scripts, event handlers and 'javascript:' links in the file are taken out before it is drawn. A server fetches nothing, so a served icon with a 'src' is drawn once the script runs.  A name with no match, or a 'src' that is no SVG, renders nothing, and the element fires 'error', so a typo in a name can be heard. It waits until the page has loaded and painted first, so a library a later module registers is not taken for a typo.  An icon is decorative by default and hidden from assistive technology. Set 'label' only when the icon is the only carrier of meaning, such as in a button with no text. An 'aria-label' on the element works too: the element is then an image with that name.  **A decorative icon that is all a control holds is reported.** In a development build, a button or a link whose only content is an icon with no 'label', and which has no name of its own, warns 'missing-name' once, through the runtime channel every Helix warning uses. */
   "helix-headless-icon": DefineCustomElement<
     HelixHeadlessIcon,
     HelixHeadlessIconVueProps,