@fusion.dev/helix 0.48.0 → 0.49.1

package/custom-elements.json

@@ -81391,7 +81391,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/outline",
             "aliases": [
               "Table of contents",
@@ -105752,6 +105752,20 @@
                 "module": "src/splitter/root/splitter-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "began",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "Where the divider was when the gesture now under way began.\n\nTaken on the press, read once by `settle` and cleared there. `undefined`\nbetween gestures and for every discrete path, where nothing has been\napplied yet and so the position it has *is* the position it began at.\n\nBeside `opened` rather than folded into it: that one is `undefined` for a\npane that starts shut, which is a different question and a real answer.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessSplitter",
+                "module": "src/splitter/root/splitter-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "reached",
@@ -106062,7 +106076,7 @@
                   }
                 }
               ],
-              "description": "Says the arrangement has settled, so a consumer can keep it.\n\nThrough the audited path, so a consumer who owns `position` is told what was\nasked for and decides, and one who does not has already had it applied.\n\n**The second announcement is conditional on the first, because it is derived\nfrom it.** `shutAt` reads the position the gesture ended on, so a refused\n`helix-before-resize` leaves a collapse computed from a number that was\nrefused. Announced anyway, the refusal produced the outcome it was refusing:\nmeasured on a divider at 40 with a listener calling `preventDefault`, Home\nleft `position` reporting 0 and `collapsed` reporting `start`, because the\ncollapse applied and `position` reads the sliver once a pane is shut. The\nreturn of the first request is what says so, and it was being dropped: a\ncancelable event dispatched as a bare statement with nothing reading the\nanswer, which is the shape the navigation cohort named on `Outline` and left.\n\nRefusing the collapse alone still leaves the resize, which is the other way\nround and is coherent: the divider goes where the drag put it and the pane\nis not declared shut. What a consumer cannot have is a pane that collapses\nout from under a position they said no to.",
+              "description": "Says the arrangement has settled, so a consumer can keep it.\n\nThrough the audited path, so a consumer who owns `position` is told what was\nasked for and decides, and one who does not has already had it applied.\n\n**The second announcement is conditional on the first, because it is derived\nfrom it.** `shutAt` reads the position the gesture ended on, so a refused\n`helix-before-resize` leaves a collapse computed from a number that was\nrefused. Announced anyway, the refusal produced the outcome it was refusing:\nmeasured on a divider at 40 with a listener calling `preventDefault`, Home\nleft `position` reporting 0 and `collapsed` reporting `start`, because the\ncollapse applied and `position` reads the sliver once a pane is shut. The\nreturn of the first request is what says so, and it was being dropped: a\ncancelable event dispatched as a bare statement with nothing reading the\nanswer, which is the shape the navigation cohort named on `Outline` and left.\n\nRefusing the collapse alone still leaves the resize, which is the other way\nround and is coherent: the divider goes where the drag put it and the pane\nis not declared shut. What a consumer cannot have is a pane that collapses\nout from under a position they said no to.\n\n**A gesture that moved nothing announces nothing, and this is the one place\nthat can say so.** A change carrying the position the divider already had\nrewrites a consumer's stored value from a gesture that moved nothing:\nharmless where the value round-trips exactly, and not where it does not,\nwhich is any consumer storing pixels and dividing by a box. The separator's\n`pointerup` held that as an early return of its own and was the only door\nwith one. There are five: the separator's pointer and arrows, the corner's\npointer and arrows, and a double click through `reset`, and `moveTo` is a\nsixth a consumer can open. Measured in Chromium 17 Sep 2026 on the built\nbundle, every door but the guarded one announced a move of zero: a corner\npress with nothing between announced on both splitters, `Home` on a divider\nalready at its minimum announced, and a double click on one already at its\ndefault announced.\n\n**Measured against where the gesture began, and not against `position`.**\n`move` applies as it goes, so by the time a drag settles the position is\nalready the number about to be announced, and comparing those two would\nsilence every drag there is. `began` is the press; a discrete path takes\nnone and compares against the position, which for it is the same thing.\n\n**Per divider rather than per gesture, which is the corner's question.** The\ncorner drives two at once, so \"moved nothing\" cannot mean \"neither moved\":\na drag along one axis moves one of them, and the other would be announcing\na number nobody asked to change. Each settles on its own and guards on its\nown, so the one that moved still announces while the one that did not stays\nquiet. That is also why the guard cannot live in `handleCornerUp`, which\nonly ever sees the pair.\n\n**The collapse counts as movement, because a refusal can leave the two\ndisagreeing.** A consumer who refuses `helix-before-collapse` has a pane at\nthe edge that is not declared shut, and a guard reading the position alone\nwould then never offer the collapse again: `Home` is already at the\nminimum, so every later press is a move of zero.",
               "inheritedFrom": {
                 "name": "HelixHeadlessSplitter",
                 "module": "src/splitter/root/splitter-root.ts"
@@ -106877,7 +106891,7 @@
               "type": {
                 "text": "HelixBeforeResizeEvent"
               },
-              "description": "Fired before the divider settles. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own.",
+              "description": "Fired before the divider settles, and only where the gesture moved it: a press that moved nothing, a drag that came back, an arrow with nowhere left to go and a corner that moved the other divider are all silent on this one. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own.",
               "name": "helix-before-resize",
               "reactProp": "onhelix-before-resize",
               "inheritedFrom": {
@@ -113808,7 +113822,7 @@
           "summary": "The content shown for one tab.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tabs",
             "tier": "styled",
             "group": "Tabs",
@@ -114530,7 +114544,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tabs",
             "tier": "styled",
             "group": "Tabs",
@@ -115159,7 +115173,7 @@
           "summary": "One tab in a tab list.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tabs",
             "tier": "styled",
             "group": "Tabs",
@@ -129211,7 +129225,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The styled tier of `BaseTour`. It draws the light and nothing else.",
+          "description": "It draws the light and nothing else: the scrim's color and the lit box's\ncorners are this tier's, and the order, the stops and the measuring stay\nbelow.",
           "name": "HelixTour",
           "cssProperties": [
             {
@@ -129960,7 +129974,7 @@
           "helix": {
             "category": "overlays",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tour",
             "tier": "styled",
             "group": "Tour",
@@ -130240,7 +130254,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The styled tier of `BaseTourStop`. The panel is `Popover`'s panel by another\nname, on purpose.",
+          "description": "The panel is `Popover`'s panel by another name, on purpose: a surface, an\ninset and a lift, so a stop and a flyout on the same page are the same\nobject. What this tier adds beyond that is the point, which no other surface\nhere draws.",
           "name": "HelixTourStop",
           "cssProperties": [
             {
@@ -130806,7 +130820,7 @@
           "helix": {
             "category": "overlays",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tour",
             "tier": "styled",
             "group": "Tour",

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

@@ -15,7 +15,7 @@ import type { CSSResultGroup } from 'lit';
  * and the document is not always where the headings are.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases Table of contents, On this page, Outline
  * @documentation https://fusion.dev/helix/components/outline

package/dist/tabs/panel/tab-panel.d.ts

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * quarter of it.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @documentation https://fusion.dev/helix/components/tabs
  *
  * @slot - The panel's content.

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

@@ -16,7 +16,7 @@ import type { CSSResultGroup } from 'lit';
  * box inside a sunken track.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @documentation https://fusion.dev/helix/components/tabs
  *

package/dist/tabs/tab/tab.d.ts

@@ -10,7 +10,7 @@ import type { CSSResultGroup } from 'lit';
  * when it becomes current.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @documentation https://fusion.dev/helix/components/tabs
  *
  * @slot - The tab's label.

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

@@ -4,10 +4,12 @@ import type { CSSResultGroup } from 'lit';
  * @summary A guided run through an interface, one stop at a time.
  *
  * @description
- * The styled tier of `BaseTour`. It draws the light and nothing else.
+ * It draws the light and nothing else: the scrim's color and the lit box's
+ * corners are this tier's, and the order, the stops and the measuring stay
+ * below.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category overlays
  * @documentation https://fusion.dev/helix/components/tour
  *

package/dist/tour/stop/tour-stop.d.ts

@@ -5,11 +5,13 @@ import '../../button/index.js';
  * @summary One stop on a tour: what it points at, and a panel to say it in.
  *
  * @description
- * The styled tier of `BaseTourStop`. The panel is `Popover`'s panel by another
- * name, on purpose.
+ * The panel is `Popover`'s panel by another name, on purpose: a surface, an
+ * inset and a lift, so a stop and a flyout on the same page are the same
+ * object. What this tier adds beyond that is the point, which no other surface
+ * here draws.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category overlays
  * @documentation https://fusion.dev/helix/components/tour
  *

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.48.0",
+  "version": "0.49.1",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -47,14 +47,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.48.0",
-    "@fusion.dev/helix-headless": "0.48.0",
-    "@fusion.dev/helix-styles": "0.48.0"
+    "@fusion.dev/helix-core": "0.49.1",
+    "@fusion.dev/helix-headless": "0.49.1",
+    "@fusion.dev/helix-styles": "0.49.1"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.48.0",
-    "@fusion.dev/helix-testing": "0.48.0",
+    "@fusion.dev/helix-cem": "0.49.1",
+    "@fusion.dev/helix-testing": "0.49.1",
     "@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

@@ -16043,7 +16043,7 @@ has an honest answer. */
   "onhelix-before-collapse"?: ((
     e: HelixSplitterHelixBeforeCollapseElementEvent,
   ) => void) | undefined;
-  /** Fired before the divider settles. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own. */
+  /** Fired before the divider settles, and only where the gesture moved it: a press that moved nothing, a drag that came back, an arrow with nowhere left to go and a corner that moved the other divider are all silent on this one. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own. */
   "onhelix-before-resize"?: ((
     e: HelixSplitterHelixBeforeResizeElementEvent,
   ) => void) | undefined;
@@ -16163,7 +16163,7 @@ has an honest answer. */
   "on:helix-before-collapse"?: ((
     e: HelixSplitterHelixBeforeCollapseElementEvent,
   ) => void) | undefined;
-  /** Fired before the divider settles. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own. */
+  /** Fired before the divider settles, and only where the gesture moved it: a press that moved nothing, a drag that came back, an arrow with nowhere left to go and a corner that moved the other divider are all silent on this one. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own. */
   "on:helix-before-resize"?: ((
     e: HelixSplitterHelixBeforeResizeElementEvent,
   ) => void) | undefined;
@@ -35625,7 +35625,7 @@ export type CustomElements = {
    * Events that will be emitted by the component.
    *
    * - `helix-before-collapse`: Fired before a pane shuts or reopens, and only where the position it is derived from stood. Cancelable: refusing it leaves the pane as it was and the divider where the gesture put it.
-   * - `helix-before-resize`: Fired before the divider settles. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own.
+   * - `helix-before-resize`: Fired before the divider settles, and only where the gesture moved it: a press that moved nothing, a drag that came back, an arrow with nowhere left to go and a corner that moved the other divider are all silent on this one. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own.
    *
    * ## Slots
    *
@@ -38732,7 +38732,9 @@ export type CustomElements = {
   >;
 
   /**
-   * The styled tier of `BaseTour`. It draws the light and nothing else.
+   * It draws the light and nothing else: the scrim's color and the lit box's
+   * corners are this tier's, and the order, the stops and the measuring stay
+   * below.
    *
    * ## Attributes & Properties
    *
@@ -38828,8 +38830,10 @@ export type CustomElements = {
   "helix-tour": Partial<HelixTourProps & BaseProps<HelixTour> & BaseEvents<HelixTour>>;
 
   /**
-   * The styled tier of `BaseTourStop`. The panel is `Popover`'s panel by another
-   * name, on purpose.
+   * The panel is `Popover`'s panel by another name, on purpose: a surface, an
+   * inset and a lift, so a stop and a flyout on the same page are the same
+   * object. What this tier adds beyond that is the point, which no other surface
+   * here draws.
    *
    * ## Attributes & Properties
    *
@@ -55322,7 +55326,7 @@ export type CustomElementsSolidJs = {
    * Events that will be emitted by the component.
    *
    * - `helix-before-collapse`: Fired before a pane shuts or reopens, and only where the position it is derived from stood. Cancelable: refusing it leaves the pane as it was and the divider where the gesture put it.
-   * - `helix-before-resize`: Fired before the divider settles. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own.
+   * - `helix-before-resize`: Fired before the divider settles, and only where the gesture moved it: a press that moved nothing, a drag that came back, an arrow with nowhere left to go and a corner that moved the other divider are all silent on this one. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own.
    *
    * ## Slots
    *
@@ -58507,7 +58511,9 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
-   * The styled tier of `BaseTour`. It draws the light and nothing else.
+   * It draws the light and nothing else: the scrim's color and the lit box's
+   * corners are this tier's, and the order, the stops and the measuring stay
+   * below.
    *
    * ## Attributes & Properties
    *
@@ -58605,8 +58611,10 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
-   * The styled tier of `BaseTourStop`. The panel is `Popover`'s panel by another
-   * name, on purpose.
+   * The panel is `Popover`'s panel by another name, on purpose: a surface, an
+   * inset and a lift, so a stop and a flyout on the same page are the same
+   * object. What this tier adds beyond that is the point, which no other surface
+   * here draws.
    *
    * ## Attributes & Properties
    *

package/types/vue.d.ts

@@ -8277,7 +8277,7 @@ has an honest answer. */
 export type HelixSplitterVueEvents = {
   /** Fired before a pane shuts or reopens, and only where the position it is derived from stood. Cancelable: refusing it leaves the pane as it was and the divider where the gesture put it. */
   "helix-before-collapse": HelixSplitterHelixBeforeCollapseElementEvent;
-  /** Fired before the divider settles. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own. */
+  /** Fired before the divider settles, and only where the gesture moved it: a press that moved nothing, a drag that came back, an arrow with nowhere left to go and a corner that moved the other divider are all silent on this one. Cancelable: refusing it takes the whole of where the gesture ended, so no collapse follows from it either. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own. */
   "helix-before-resize": HelixSplitterHelixBeforeResizeElementEvent;
 };
 
@@ -12385,13 +12385,13 @@ export interface WcToolkitVueGlobalComponents {
     HelixTooltipVueProps,
     HelixTooltipVueEvents
   >;
-  /** The styled tier of 'BaseTour'. It draws the light and nothing else. */
+  /** It draws the light and nothing else: the scrim's color and the lit box's corners are this tier's, and the order, the stops and the measuring stay below. */
   "helix-tour": DefineCustomElement<
     HelixTour,
     HelixTourVueProps,
     HelixTourVueEvents
   >;
-  /** The styled tier of 'BaseTourStop'. The panel is 'Popover''s panel by another name, on purpose. */
+  /** The panel is 'Popover''s panel by another name, on purpose: a surface, an inset and a lift, so a stop and a flyout on the same page are the same object. What this tier adds beyond that is the point, which no other surface here draws. */
   "helix-tour-stop": DefineCustomElement<
     HelixTourStop,
     HelixTourStopVueProps,