@fusion.dev/helix-core 0.185.0 → 0.186.0

package/custom-elements.json

@@ -14167,6 +14167,14 @@
             "package": "#audit-children"
           }
         },
+        {
+          "kind": "js",
+          "name": "auditIconControl",
+          "declaration": {
+            "name": "auditIconControl",
+            "package": "#audit-name"
+          }
+        },
         {
           "kind": "js",
           "name": "auditName",
@@ -17439,6 +17447,14 @@
             "module": "./utils/format-numbers/format-numbers.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "glyphPath",
+          "declaration": {
+            "name": "glyphPath",
+            "module": "./utils/glyph-path/glyph-path.js"
+          }
+        },
         {
           "kind": "js",
           "name": "GridBounds",
@@ -18519,6 +18535,14 @@
             "module": "./utils/scroll-item-into-view/scroll-item-into-view.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "scrollWithin",
+          "declaration": {
+            "name": "scrollWithin",
+            "module": "./utils/scroll-item-into-view/scroll-item-into-view.js"
+          }
+        },
         {
           "kind": "js",
           "name": "lockScroll",
@@ -26107,6 +26131,22 @@
           "type": {
             "text": "typeof audit"
           }
+        },
+        {
+          "kind": "function",
+          "name": "auditField",
+          "description": "The field's missing-name warning in a production build: nothing.",
+          "type": {
+            "text": "typeof field"
+          }
+        },
+        {
+          "kind": "function",
+          "name": "auditIconControl",
+          "description": "The warning about a control named by a decorative icon, in a production build: nothing.",
+          "type": {
+            "text": "typeof iconControl"
+          }
         }
       ],
       "exports": [
@@ -26117,6 +26157,22 @@
             "name": "auditName",
             "module": "src/utils/audit-name/audit-name-off.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "auditField",
+          "declaration": {
+            "name": "auditField",
+            "module": "src/utils/audit-name/audit-name-off.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "auditIconControl",
+          "declaration": {
+            "name": "auditIconControl",
+            "module": "src/utils/audit-name/audit-name-off.ts"
+          }
         }
       ]
     },
@@ -26192,6 +26248,48 @@
             }
           ],
           "description": "Warns once, through the runtime channel, when a control has no accessible\nname: none on the host, and none on the control inside it.\n\n**Read a task after the control first renders**, so a label that arrives in\nthe same pass counts: slotted, written by a framework beside the control, or\nforwarded from a `<label for>`. One timer serves every control that asked in\nthat task, and an element is read once in its life, so a name taken away\nlater is not reported.\n\n**In a development build only.** Every field and Button calls it, so in\nproduction it would cost each of them about 450 bytes gzip for a sentence\nmeant for the person writing the page. Core imports it as `#audit-name`,\nwhich `package.json` resolves here under the `development` condition (Vite\nand webpack in development, `bun --conditions development`,\n`node --conditions=development`) and to `audit-name-off.ts`, which does\nnothing, everywhere else. Like every runtime warning it reports through the\none channel, and a project that wants the console quiet tells\n`@fusion.dev/helix-diagnostics` with `core.warnings: false`.\n\n`control` returns the control inside the host, `null` where the host is the\ncontrol, or `undefined` where the control is not drawn at the moment of the\nread: the host is then read again the next time it asks.\n\n`also` answers for a name the component gave through its internals, which no\nattribute shows. `fix` is the sentence that says how to name it, or its key\nin `FIXES`. `shown` is the part where the control shows its value or its\nplaceholder, whose words are no name."
+        },
+        {
+          "kind": "function",
+          "name": "auditField",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ],
+          "description": "Asks whether a field is named, as `auditName` does, with what every field\nanswers it by: the control its label points at, a label it was given or one\nslotted with words in it, and the `value` part, whose words are no name.\n\n**Here rather than at the call in `MixinField`**, for the reason `FIXES` is\nhere: the call is a no-op in production, and the closures it was handed were\nin every field's bundle anyway."
+        },
+        {
+          "kind": "function",
+          "name": "auditIconControl",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "icon",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Asks the button or link a decorative icon sits in whether it has a name.\nIts content is the icon alone where it has none, and the warning says so.\n`label` is the icon's own, which names it, and the control with it.\n\nWords or a named picture beside the icon name the control from its\ncontent, which the audit reads for a button and not for a link."
         }
       ],
       "exports": [
@@ -26210,6 +26308,22 @@
             "name": "auditName",
             "module": "src/utils/audit-name/audit-name.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "auditField",
+          "declaration": {
+            "name": "auditField",
+            "module": "src/utils/audit-name/audit-name.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "auditIconControl",
+          "declaration": {
+            "name": "auditIconControl",
+            "module": "src/utils/audit-name/audit-name.ts"
+          }
         }
       ]
     },
@@ -29212,7 +29326,7 @@
               }
             }
           ],
-          "description": "Draws an icon that was imported by name, rather than looked up by string.\n\n**`<helix-icon name=\"play\">` looks its glyph up in a registry at runtime.**\nThe registry holds the whole set once `@fusion.dev/helix-headless/icon/all`\nregisters it, and no bundler can shake a lookup by string, so every consumer\nof any component that renders one ships all of the generated path data: measured at 50,814 bytes raw and 15,010 gzipped for 102 icons, and\ngrowing about 147 gzipped bytes per icon added. A named import ships one path\nand is checked when the package compiles rather than by a name lookup later.\n\nThat element still earns its place as *public* API, where a consumer writes a\nname in markup and a lookup is the only thing that can work, and\n`@fusion.dev/helix-headless/icon/root` names glyphs without registering the\nset. What it should not be is how this library draws its own marks.\n\n**There is no `part` option, and there cannot be.** A part name behind an\ninterpolation is a part the manifest cannot see, so the component's own\nstylesheet matches nothing and the part stops being\nAPI. `Trend` needs one and therefore writes its `<svg>` out with a literal\n`part=\"icon\"`, which is the honest cost: a helper can carry everything except\nthe thing static analysis has to read.\n\n`data-glyph` rather than a class, because the sizing lives in\n`helix/styled/src/shared/glyph/glyph.css` and a component's own `--icon-size`\ndeclarations have to keep working untouched: the variable was read by\n`helix-icon`, and now it is read by the rule that sheet carries. Without it\nevery one of those declarations would go quietly dead and every mark in six\nfamilies would change size."
+          "description": "Draws an icon that was imported by name, rather than looked up by string.\n\n**`<helix-icon name=\"play\">` looks its glyph up in a registry at runtime.**\nThe registry holds the whole set once `@fusion.dev/helix-headless/icon`\nregisters it, and no bundler can shake a lookup by string, so every consumer\nof any component that renders one ships all of the generated path data: measured at 50,814 bytes raw and 15,010 gzipped for 102 icons, and\ngrowing about 147 gzipped bytes per icon added. A named import ships one path\nand is checked when the package compiles rather than by a name lookup later.\n\nThat element still earns its place as *public* API, where a consumer writes a\nname in markup and a lookup is the only thing that can work, and\n`@fusion.dev/helix-headless/icon/root` names glyphs without registering the\nset. What it should not be is how this library draws its own marks.\n\n**There is no `part` option, and there cannot be.** A part name behind an\ninterpolation is a part the manifest cannot see, so the component's own\nstylesheet matches nothing and the part stops being\nAPI. `Trend` needs one and therefore writes its `<svg>` out with a literal\n`part=\"icon\"`, which is the honest cost: a helper can carry everything except\nthe thing static analysis has to read.\n\n`data-glyph` rather than a class, because the sizing lives in\n`helix/styled/src/shared/glyph/glyph.css` and a component's own `--icon-size`\ndeclarations have to keep working untouched: the variable was read by\n`helix-icon`, and now it is read by the rule that sheet carries. Without it\nevery one of those declarations would go quietly dead and every mark in six\nfamilies would change size."
         }
       ],
       "exports": [
@@ -30093,6 +30207,40 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/glyph-path/glyph-path.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "glyphPath",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "glyph",
+              "type": {
+                "text": "{ readonly content: string }"
+              }
+            }
+          ],
+          "description": "The `d` of a glyph drawn as one path, for a template that writes the\n`<path>` itself.\n\n**For a fixed glyph, which needs no directive.** `unsafeSVG(glyph.content)`\nparses markup a template could have written, and the directive and its base\nclass come to about 1,000 bytes in a bundle that draws nothing else through\nit. Measured October 8, 2026, bundled alone, brotli: Dialog and Tag were\neach about 300 bytes larger for the cross alone, and Tabs about 350 for the\ncross and its four carets.\n\nA glyph of more than one element keeps `unsafeSVG`, which is what Icon draws\nevery glyph with. `glyph-path.pure.spec.ts` holds each glyph drawn this way\nto a single path, so a set that redraws one in two cannot lose half of it."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "glyphPath",
+          "declaration": {
+            "name": "glyphPath",
+            "module": "src/utils/glyph-path/glyph-path.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/grid-move/grid-move.ts",
@@ -33418,6 +33566,37 @@
               }
             }
           ]
+        },
+        {
+          "kind": "function",
+          "name": "scrollWithin",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "item",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "scroller",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "{ padding = 0, smooth = false }",
+              "default": "{}",
+              "type": {
+                "text": "Omit<ScrollItemOptions, 'scroller'>"
+              }
+            }
+          ],
+          "description": "`scrollItemIntoView` in a scroller the caller already holds.\n\n**For a family that always knows its scroller**, as Tabs knows its strip:\n`scrollingAncestor` and the walk it takes are then in no bundle of its own,\nwhere the fallback carried them into every one. Measured October 8, 2026,\nbundled alone, brotli: about 165 bytes on Tabs."
         }
       ],
       "exports": [
@@ -33444,6 +33623,14 @@
             "name": "scrollItemIntoView",
             "module": "src/utils/scroll-item-into-view/scroll-item-into-view.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "scrollWithin",
+          "declaration": {
+            "name": "scrollWithin",
+            "module": "src/utils/scroll-item-into-view/scroll-item-into-view.ts"
+          }
         }
       ]
     },
@@ -35496,7 +35683,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.185.0'",
+          "default": "'0.186.0'",
           "description": "The version of the package this file ships in.\n\n**Written by `fusion/scripts/version.mjs`** wherever it writes the package's\n`package.json`, and stamped back into the repository beside it after a\nrelease, so the two never disagree; a spec beside this holds them to it.\nNothing else in the running code knows which release it is."
         }
       ],
@@ -36132,6 +36319,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.185.0"
+    "version": "0.186.0"
   }
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { auditChildren, auditEntry } from '@fusion.dev/helix-core/audits/children';
-export { auditName } from '@fusion.dev/helix-core/audits/name';
+export { auditIconControl, auditName } from '@fusion.dev/helix-core/audits/name';
 export { auditNesting } from '@fusion.dev/helix-core/audits/nesting';
 export { auditServed } from '@fusion.dev/helix-core/audits/served';
 export { AriaForwardController, type AriaForwardOptions, } from './controllers/aria-forward-controller/aria-forward-controller.js';
@@ -95,6 +95,7 @@ export { focusTarget } from './utils/focus-target/focus-target.js';
 export { deepActiveElement, deepContains, focusableElements, PRESSABLE, pressedOwnControl, } from './utils/focusable-elements/focusable-elements.js';
 export { afterLinkFollowed, followLink, type LinkModifiers, type LinkTarget, } from './utils/follow-link/follow-link.js';
 export { formatNumbers } from './utils/format-numbers/format-numbers.js';
+export { glyphPath } from './utils/glyph-path/glyph-path.js';
 export { type GridBounds, type GridKeys, type GridPlace, gridMove, pageRows, } from './utils/grid-move/grid-move.js';
 export { headingIn, headingsIn } from './utils/heading-in/heading-in.js';
 export { headingLevel } from './utils/heading-level/heading-level.js';
@@ -137,7 +138,7 @@ export { valueAt } from './utils/row-data/row-data.js';
 export { type Arranged, type Axis, arranged, cycle, type DataRow, filter, format, type Ordered, ordered, parse, type Sort, sort, window_, } from './utils/row-order/row-order.js';
 export { extent, linear, type Scale } from './utils/scale/scale.js';
 export { ticks } from './utils/scale/ticks.js';
-export { type ScrollerOptions, type ScrollItemOptions, type ScrollRoomOptions, scrollItemIntoView, scrollingAncestor, scrollRoom, } from './utils/scroll-item-into-view/scroll-item-into-view.js';
+export { type ScrollerOptions, type ScrollItemOptions, type ScrollRoomOptions, scrollItemIntoView, scrollingAncestor, scrollRoom, scrollWithin, } from './utils/scroll-item-into-view/scroll-item-into-view.js';
 export { lockScroll, scrollHolders, unlockScroll } from './utils/scroll-lock/scroll-lock.js';
 export { slotFilled, slotNamed } from './utils/slot-filled/slot-filled.js';
 export { SlottedGlyph } from './utils/slotted-glyph/slotted-glyph.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { auditChildren, auditEntry } from '@fusion.dev/helix-core/audits/children';
-export { auditName } from '@fusion.dev/helix-core/audits/name';
+export { auditIconControl, auditName } from '@fusion.dev/helix-core/audits/name';
 export { auditNesting } from '@fusion.dev/helix-core/audits/nesting';
 export { auditServed } from '@fusion.dev/helix-core/audits/served';
 export { AriaForwardController, } from './controllers/aria-forward-controller/aria-forward-controller.js';
@@ -95,6 +95,7 @@ export { focusTarget } from './utils/focus-target/focus-target.js';
 export { deepActiveElement, deepContains, focusableElements, PRESSABLE, pressedOwnControl, } from './utils/focusable-elements/focusable-elements.js';
 export { afterLinkFollowed, followLink, } from './utils/follow-link/follow-link.js';
 export { formatNumbers } from './utils/format-numbers/format-numbers.js';
+export { glyphPath } from './utils/glyph-path/glyph-path.js';
 export { gridMove, pageRows, } from './utils/grid-move/grid-move.js';
 export { headingIn, headingsIn } from './utils/heading-in/heading-in.js';
 export { headingLevel } from './utils/heading-level/heading-level.js';
@@ -137,7 +138,7 @@ export { valueAt } from './utils/row-data/row-data.js';
 export { arranged, cycle, filter, format, ordered, parse, sort, window_, } from './utils/row-order/row-order.js';
 export { extent, linear } from './utils/scale/scale.js';
 export { ticks } from './utils/scale/ticks.js';
-export { scrollItemIntoView, scrollingAncestor, scrollRoom, } from './utils/scroll-item-into-view/scroll-item-into-view.js';
+export { scrollItemIntoView, scrollingAncestor, scrollRoom, scrollWithin, } from './utils/scroll-item-into-view/scroll-item-into-view.js';
 export { lockScroll, scrollHolders, unlockScroll } from './utils/scroll-lock/scroll-lock.js';
 export { slotFilled, slotNamed } from './utils/slot-filled/slot-filled.js';
 export { SlottedGlyph } from './utils/slotted-glyph/slotted-glyph.js';

package/dist/mixins/mixin-field/mixin-field.js

@@ -1,7 +1,7 @@
 import { __decorate } from "tslib";
 import { html, nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
-import { auditName } from '@fusion.dev/helix-core/audits/name';
+import { auditField } from '@fusion.dev/helix-core/audits/name';
 import { hostAria } from '../../utils/host-aria/host-aria.js';
 const HINT_ID = 'helix-hint';
 const FEEDBACK_ID = 'helix-feedback';
@@ -170,8 +170,7 @@ export const MixinField = (Base) => {
             });
             this.addEventListener('change', touch);
             this.renderRoot.addEventListener('slotchange', this.noteSlotted);
-            auditName(this, () => this.namedControl, 'Give it a `label`, an `aria-label`, words in its label, or a `<label for>` that names it.', () => this.labeled ||
-                [...this.children].some((child) => child.slot === 'label' && (child.textContent ?? '').trim() !== ''), () => this.partNamed('value'));
+            auditField(this);
         }
     }
     __decorate([

package/dist/utils/audit-name/audit-name-off.d.ts

@@ -1,4 +1,4 @@
-import type { auditName as audit } from './audit-name.js';
+import type { auditName as audit, auditField as field, auditIconControl as iconControl } from './audit-name.js';
 /**
  * The missing-name warning in a production build: nothing.
  *
@@ -8,3 +8,7 @@ import type { auditName as audit } from './audit-name.js';
  * builds. See `audit-name.ts`.
  */
 export declare const auditName: typeof audit;
+/** The field's missing-name warning in a production build: nothing. */
+export declare const auditField: typeof field;
+/** The warning about a control named by a decorative icon, in a production build: nothing. */
+export declare const auditIconControl: typeof iconControl;

package/dist/utils/audit-name/audit-name-off.js

@@ -1 +1,3 @@
 export const auditName = () => { };
+export const auditField = () => { };
+export const auditIconControl = () => { };

package/dist/utils/audit-name/audit-name.d.ts

@@ -48,3 +48,22 @@ export declare const hasName: (element: HTMLElement, shown?: Element | null) =>
  * placeholder, whose words are no name.
  */
 export declare const auditName: (host: HTMLElement, control: () => HTMLElement | null | undefined, fix: string, also?: () => boolean, shown?: () => Element | null) => void;
+/**
+ * Asks whether a field is named, as `auditName` does, with what every field
+ * answers it by: the control its label points at, a label it was given or one
+ * slotted with words in it, and the `value` part, whose words are no name.
+ *
+ * **Here rather than at the call in `MixinField`**, for the reason `FIXES` is
+ * here: the call is a no-op in production, and the closures it was handed were
+ * in every field's bundle anyway.
+ */
+export declare const auditField: (host: HTMLElement) => void;
+/**
+ * Asks the button or link a decorative icon sits in whether it has a name.
+ * Its content is the icon alone where it has none, and the warning says so.
+ * `label` is the icon's own, which names it, and the control with it.
+ *
+ * Words or a named picture beside the icon name the control from its
+ * content, which the audit reads for a button and not for a link.
+ */
+export declare const auditIconControl: (icon: HTMLElement, label: string) => void;

package/dist/utils/audit-name/audit-name.js

@@ -50,7 +50,37 @@ const implicitRole = (element) => {
     return element.localName === 'a' && element.hasAttribute('href') ? 'link' : '';
 };
 const FIXES = new Map([
+    ['accordion-item', 'Write its title in the `summary` slot.'],
     ['button', 'Give it words, a `label`, or an `aria-label`.'],
+    ['button-group', 'Give it a `label`, or an `aria-label` that says what the buttons are for.'],
+    ['canvas', 'Give it a `label` that says what the board holds, such as "Release plan".'],
+    ['dialog', 'Give it a `label`, or a heading in the `header` slot.'],
+    [
+        'field',
+        'Give it a `label`, an `aria-label`, words in its label, or a `<label for>` that names it.',
+    ],
+    ['graph', 'Give it a `label` that says what the notes are, such as "Research notes".'],
+    ['lightbox', 'Give it a `label`, such as "Project photos".'],
+    ['list', 'Give it a `label`, or an `aria-label` that says what the rows are.'],
+    ['map', 'Give it a `label` that says what the map shows, such as "Stores in Edinburgh".'],
+    ['popover', 'Give it a `label`, or a heading in the panel.'],
+    ['row', 'Give the row words in its default slot, or a label on the icon it holds.'],
+    ['sandbox', 'Give each source pane a `label` or a `name`, which its file tab shows.'],
+    [
+        'table',
+        'Give it a `label`, or put a heading in its `heading` slot, that says what the rows are.',
+    ],
+    [
+        'time-picker',
+        'Give it a `label`, a label in the `label` slot, or an `aria-label` that says what the time is for.',
+    ],
+    [
+        'toggle',
+        'Give it words in its default slot, an `aria-label`, or a label on the icon it holds.',
+    ],
+    ['tour', 'Give it a `label`, such as "Getting started".'],
+    ['tree', 'Give it a `label` that says what it holds, such as "Files".'],
+    ['video', 'Give it a `label` that says what the video shows, such as "Product tour".'],
     ['virtual-list', 'Give it a `label`, or an `aria-label` that says what the items are.'],
 ]);
 const audited = new WeakSet();
@@ -93,3 +123,18 @@ export const auditName = (host, control, fix, also, shown) => {
         });
     });
 };
+export const auditField = (host) => {
+    const field = host;
+    auditName(field, () => field.namedControl, 'field', () => field.labeled ||
+        [...field.children].some((child) => child.slot === 'label' && (child.textContent ?? '').trim() !== ''), () => field.partNamed('value'));
+};
+export const auditIconControl = (icon, label) => {
+    if (label !== '' || icon.hasAttribute('aria-label')) {
+        return;
+    }
+    const control = icon.closest('a[href], button, summary, [role="button"], [role="link"]');
+    if (control) {
+        auditName(control, () => null, `Its only content is <${icon.localName}>, which is decorative: give the icon a \`label\`, or the control an \`aria-label\`.`, () => (control.textContent ?? '').trim() !== '' ||
+            control.querySelector('[alt]:not([alt=""]), [aria-label]:not([aria-label=""])') !== null);
+    }
+};

package/dist/utils/draw-dismiss/draw-dismiss.js

@@ -1,6 +1,6 @@
 import { x } from '@fusion.dev/helix-icons';
 import { html, nothing } from 'lit';
-import { unsafeSVG } from 'lit/directives/unsafe-svg.js';
+import { glyphPath } from '../glyph-path/glyph-path.js';
 export const drawDismiss = ({ disabled = false, label, mark, onDismiss, tabindex, }) => html `<button
   part="dismiss"
   type="button"
@@ -12,5 +12,5 @@ export const drawDismiss = ({ disabled = false, label, mark, onDismiss, tabindex
   ${mark}
 </button>`;
 export const drawDismissGlyph = () => html `<svg part="dismiss-mark" viewBox=${x.viewBox} fill="currentColor" aria-hidden="true">
-    ${unsafeSVG(x.content)}
+    <path d=${glyphPath(x)}></path>
   </svg>`;

package/dist/utils/draw-icon/draw-icon.d.ts

@@ -11,7 +11,7 @@ export interface DrawIconOptions {
  * Draws an icon that was imported by name, rather than looked up by string.
  *
  * **`<helix-icon name="play">` looks its glyph up in a registry at runtime.**
- * The registry holds the whole set once `@fusion.dev/helix-headless/icon/all`
+ * The registry holds the whole set once `@fusion.dev/helix-headless/icon`
  * registers it, and no bundler can shake a lookup by string, so every consumer
  * of any component that renders one ships all of the generated path data: measured at 50,814 bytes raw and 15,010 gzipped for 102 icons, and
  * growing about 147 gzipped bytes per icon added. A named import ships one path

package/dist/utils/glyph-path/glyph-path.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The `d` of a glyph drawn as one path, for a template that writes the
+ * `<path>` itself.
+ *
+ * **For a fixed glyph, which needs no directive.** `unsafeSVG(glyph.content)`
+ * parses markup a template could have written, and the directive and its base
+ * class come to about 1,000 bytes in a bundle that draws nothing else through
+ * it. Measured October 8, 2026, bundled alone, brotli: Dialog and Tag were
+ * each about 300 bytes larger for the cross alone, and Tabs about 350 for the
+ * cross and its four carets.
+ *
+ * A glyph of more than one element keeps `unsafeSVG`, which is what Icon draws
+ * every glyph with. `glyph-path.pure.spec.ts` holds each glyph drawn this way
+ * to a single path, so a set that redraws one in two cannot lose half of it.
+ */
+export declare const glyphPath: (glyph: {
+    readonly content: string;
+}) => string;

package/dist/utils/glyph-path/glyph-path.js

@@ -0,0 +1 @@
+export const glyphPath = (glyph) => /\sd="([^"]*)"/.exec(glyph.content)?.[1] ?? '';

package/dist/utils/scroll-item-into-view/scroll-item-into-view.d.ts

@@ -58,3 +58,12 @@ export interface ScrollerOptions {
     readonly stop?: Element | null;
 }
 export declare const scrollItemIntoView: (item: HTMLElement, options?: ScrollItemOptions) => void;
+/**
+ * `scrollItemIntoView` in a scroller the caller already holds.
+ *
+ * **For a family that always knows its scroller**, as Tabs knows its strip:
+ * `scrollingAncestor` and the walk it takes are then in no bundle of its own,
+ * where the fallback carried them into every one. Measured October 8, 2026,
+ * bundled alone, brotli: about 165 bytes on Tabs.
+ */
+export declare const scrollWithin: (item: HTMLElement, scroller: HTMLElement, { padding, smooth }?: Omit<ScrollItemOptions, 'scroller'>) => void;

package/dist/utils/scroll-item-into-view/scroll-item-into-view.js

@@ -29,11 +29,12 @@ const climb = (node) => {
     return root instanceof ShadowRoot ? root.host : null;
 };
 export const scrollItemIntoView = (item, options = {}) => {
-    const { padding = 0, smooth = false } = options;
     const scroller = options.scroller ?? scrollingAncestor(item);
-    if (!scroller) {
-        return;
+    if (scroller) {
+        scrollWithin(item, scroller, options);
     }
+};
+export const scrollWithin = (item, scroller, { padding = 0, smooth = false } = {}) => {
     const box = item.getBoundingClientRect();
     const view = scroller.getBoundingClientRect();
     const before = { block: view.top - box.top + padding, inline: view.left - box.left + padding };

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  * release, so the two never disagree; a spec beside this holds them to it.
  * Nothing else in the running code knows which release it is.
  */
-export declare const VERSION = "0.185.0";
+export declare const VERSION = "0.186.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.185.0';
+export const VERSION = '0.186.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.185.0",
+  "version": "0.186.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -74,12 +74,12 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.185.0",
+    "@fusion.dev/helix-icons": "0.186.0",
     "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.185.0",
-    "@fusion.dev/helix-testing": "0.185.0",
+    "@fusion.dev/helix-cem": "0.186.0",
+    "@fusion.dev/helix-testing": "0.186.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },