@fusion.dev/helix 0.174.0 → 0.176.0

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.174.0",
+  "version": "0.176.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -54,13 +54,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.174.0",
-    "@fusion.dev/helix-headless": "0.174.0",
-    "@fusion.dev/helix-styles": "0.174.0"
+    "@fusion.dev/helix-core": "0.176.0",
+    "@fusion.dev/helix-headless": "0.176.0",
+    "@fusion.dev/helix-styles": "0.176.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.174.0",
-    "@fusion.dev/helix-testing": "0.174.0",
+    "@fusion.dev/helix-cem": "0.176.0",
+    "@fusion.dev/helix-testing": "0.176.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

@@ -18633,12 +18633,10 @@ disagreeing with its own name for every reader who meant the left. */
   /** The name of the icon in the Helix set.
 
 **A lookup, and the reason both this and `icon` exist.** A name is a string,
-so it is what markup can carry, and resolving one means an index of the
-whole set that no bundler can shake: 15 kB for a consumer who renders one
-mark. An attribute is the only thing an HTML author can write, and that is
-worth the index; a consumer who would rather not pay it imports the
-element from `icon/root` and registers the glyphs it names, or hands over
-the value instead.
+so it is what markup can carry, and resolving one means an index that no
+bundler can shake. The family's entry indexes a small set, `icon/all`
+indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
+page that registers the glyphs it names or hands over the value instead.
 
 A name written `prefix:name` asks the library registered under that
 prefix. */
@@ -18707,12 +18705,10 @@ disagreeing with its own name for every reader who meant the left. */
   /** The name of the icon in the Helix set.
 
 **A lookup, and the reason both this and `icon` exist.** A name is a string,
-so it is what markup can carry, and resolving one means an index of the
-whole set that no bundler can shake: 15 kB for a consumer who renders one
-mark. An attribute is the only thing an HTML author can write, and that is
-worth the index; a consumer who would rather not pay it imports the
-element from `icon/root` and registers the glyphs it names, or hands over
-the value instead.
+so it is what markup can carry, and resolving one means an index that no
+bundler can shake. The family's entry indexes a small set, `icon/all`
+indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
+page that registers the glyphs it names or hands over the value instead.
 
 A name written `prefix:name` asks the library registered under that
 prefix. */
@@ -19904,7 +19900,8 @@ Written by the root, which is the only thing that sees the set. */
   /** The item's name. It names the item's group, and fills `{label}` in the
 lightbox's `status-label`. */
   label?: (HelixLightboxItem["label"]) | undefined;
-  /** The item's identifier. The root compares its `active` value against it. */
+  /** The item's identifier. The root compares its `active` value against it.
+Without one, the item is named by its place in the set, counted from 1. */
   value?: (HelixLightboxItem["value"]) | undefined;
 };
 
@@ -19916,7 +19913,8 @@ Written by the root, which is the only thing that sees the set. */
   /** The item's name. It names the item's group, and fills `{label}` in the
 lightbox's `status-label`. */
   "prop:label"?: (HelixLightboxItem["label"]) | undefined;
-  /** The item's identifier. The root compares its `active` value against it. */
+  /** The item's identifier. The root compares its `active` value against it.
+Without one, the item is named by its place in the set, counted from 1. */
   "prop:value"?: (HelixLightboxItem["value"]) | undefined;
 
   /** Set the innerHTML of the element */
@@ -52060,6 +52058,10 @@ export type CustomElements = {
    * The headless element documents the model, including why a tick applies a
    * filter immediately and why the menu decides the operator.
    *
+   * Imported from its own entry, `@fusion.dev/helix/filter-input/menu`, which registers
+   * it with the `Menu` it draws its pages with. The family's entry leaves it out,
+   * so a field without a picker does not carry `Menu`.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -53995,6 +53997,11 @@ export type CustomElements = {
    * Reduced motion stills every animation. `auto-width` gives the box the
    * glyph's own proportions, for a mark wider than it is tall.
    *
+   * **`@fusion.dev/helix/icon` registers thirteen glyphs by name**, the ones a
+   * control most often needs, and `@fusion.dev/helix/icon/all` registers the
+   * whole set. The headless element lists the thirteen and says how a name is
+   * resolved.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -54026,12 +54033,10 @@ export type CustomElements = {
    * - `name`: The name of the icon in the Helix set.
    *
    * **A lookup, and the reason both this and `icon` exist.** A name is a string,
-   * so it is what markup can carry, and resolving one means an index of the
-   * whole set that no bundler can shake: 15 kB for a consumer who renders one
-   * mark. An attribute is the only thing an HTML author can write, and that is
-   * worth the index; a consumer who would rather not pay it imports the
-   * element from `icon/root` and registers the glyphs it names, or hands over
-   * the value instead.
+   * so it is what markup can carry, and resolving one means an index that no
+   * bundler can shake. The family's entry indexes a small set, `icon/all`
+   * indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
+   * page that registers the glyphs it names or hands over the value instead.
    *
    * A name written `prefix:name` asks the library registered under that
    * prefix.
@@ -54897,6 +54902,7 @@ export type CustomElements = {
    * - `label`: The item's name. It names the item's group, and fills `{label}` in the
    * lightbox's `status-label`.
    * - `value`: The item's identifier. The root compares its `active` value against it.
+   * Without one, the item is named by its place in the set, counted from 1.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -81767,6 +81773,10 @@ export type CustomElementsSolidJs = {
    * The headless element documents the model, including why a tick applies a
    * filter immediately and why the menu decides the operator.
    *
+   * Imported from its own entry, `@fusion.dev/helix/filter-input/menu`, which registers
+   * it with the `Menu` it draws its pages with. The family's entry leaves it out,
+   * so a field without a picker does not carry `Menu`.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -83729,6 +83739,11 @@ export type CustomElementsSolidJs = {
    * Reduced motion stills every animation. `auto-width` gives the box the
    * glyph's own proportions, for a mark wider than it is tall.
    *
+   * **`@fusion.dev/helix/icon` registers thirteen glyphs by name**, the ones a
+   * control most often needs, and `@fusion.dev/helix/icon/all` registers the
+   * whole set. The headless element lists the thirteen and says how a name is
+   * resolved.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -83760,12 +83775,10 @@ export type CustomElementsSolidJs = {
    * - `name`: The name of the icon in the Helix set.
    *
    * **A lookup, and the reason both this and `icon` exist.** A name is a string,
-   * so it is what markup can carry, and resolving one means an index of the
-   * whole set that no bundler can shake: 15 kB for a consumer who renders one
-   * mark. An attribute is the only thing an HTML author can write, and that is
-   * worth the index; a consumer who would rather not pay it imports the
-   * element from `icon/root` and registers the glyphs it names, or hands over
-   * the value instead.
+   * so it is what markup can carry, and resolving one means an index that no
+   * bundler can shake. The family's entry indexes a small set, `icon/all`
+   * indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
+   * page that registers the glyphs it names or hands over the value instead.
    *
    * A name written `prefix:name` asks the library registered under that
    * prefix.
@@ -84648,6 +84661,7 @@ export type CustomElementsSolidJs = {
    * - `label`: The item's name. It names the item's group, and fills `{label}` in the
    * lightbox's `status-label`.
    * - `value`: The item's identifier. The root compares its `active` value against it.
+   * Without one, the item is named by its place in the set, counted from 1.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by

package/types/vue.d.ts

@@ -9571,12 +9571,10 @@ disagreeing with its own name for every reader who meant the left. */
   /** The name of the icon in the Helix set.
 
 **A lookup, and the reason both this and `icon` exist.** A name is a string,
-so it is what markup can carry, and resolving one means an index of the
-whole set that no bundler can shake: 15 kB for a consumer who renders one
-mark. An attribute is the only thing an HTML author can write, and that is
-worth the index; a consumer who would rather not pay it imports the
-element from `icon/root` and registers the glyphs it names, or hands over
-the value instead.
+so it is what markup can carry, and resolving one means an index that no
+bundler can shake. The family's entry indexes a small set, `icon/all`
+indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
+page that registers the glyphs it names or hands over the value instead.
 
 A name written `prefix:name` asks the library registered under that
 prefix. */
@@ -10199,7 +10197,8 @@ Written by the root, which is the only thing that sees the set. */
   /** The item's name. It names the item's group, and fills `{label}` in the
 lightbox's `status-label`. */
   label?: (HelixLightboxItem["label"]) | undefined;
-  /** The item's identifier. The root compares its `active` value against it. */
+  /** The item's identifier. The root compares its `active` value against it.
+Without one, the item is named by its place in the set, counted from 1. */
   value?: (HelixLightboxItem["value"]) | undefined;
 };
 
@@ -24291,7 +24290,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixFilterFieldVueProps,
     HelixFilterFieldVueEvents
   >;
-  /** Draws nothing of its own. The trigger is yours, and the pages are 'Menu''s, whose reserved tick column keeps ticked and unticked values aligned. The element's stylesheet has one rule: 'display: contents'.  The headless element documents the model, including why a tick applies a filter immediately and why the menu decides the operator. */
+  /** Draws nothing of its own. The trigger is yours, and the pages are 'Menu''s, whose reserved tick column keeps ticked and unticked values aligned. The element's stylesheet has one rule: 'display: contents'.  The headless element documents the model, including why a tick applies a filter immediately and why the menu decides the operator.  Imported from its own entry, '@fusion.dev/helix/filter-input/menu', which registers it with the 'Menu' it draws its pages with. The family's entry leaves it out, so a field without a picker does not carry 'Menu'. */
   "helix-filter-menu": DefineCustomElement<
     HelixFilterMenu,
     HelixFilterMenuVueProps,
@@ -24345,7 +24344,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixIconButtonVueProps,
     HelixIconButtonVueEvents
   >;
-  /** Draws in 'currentColor' and sizes from '--icon-size', so an icon takes the color of the text around it and a container can resize it without a property. Inside a button, '--icon-size' is set in 'em', so the icon scales with the button.  **The glyph turns, flips and moves inside its own box**, so the line around it keeps its place: 'rotate' turns it by a quarter, a half or three quarters, '--icon-rotate' by any angle, 'flip' mirrors it across either axis, and 'animation' spins, pulses or beats it, as Web Awesome's icon does. Reduced motion stills every animation. 'auto-width' gives the box the glyph's own proportions, for a mark wider than it is tall. */
+  /** Draws in 'currentColor' and sizes from '--icon-size', so an icon takes the color of the text around it and a container can resize it without a property. Inside a button, '--icon-size' is set in 'em', so the icon scales with the button.  **The glyph turns, flips and moves inside its own box**, so the line around it keeps its place: 'rotate' turns it by a quarter, a half or three quarters, '--icon-rotate' by any angle, 'flip' mirrors it across either axis, and 'animation' spins, pulses or beats it, as Web Awesome's icon does. Reduced motion stills every animation. 'auto-width' gives the box the glyph's own proportions, for a mark wider than it is tall.  **'@fusion.dev/helix/icon' registers thirteen glyphs by name**, the ones a control most often needs, and '@fusion.dev/helix/icon/all' registers the whole set. The headless element lists the thirteen and says how a name is resolved. */
   "helix-icon": DefineCustomElement<
     HelixIcon,
     HelixIconVueProps,