@fusion.dev/helix 0.49.1 → 0.51.0

package/types/vue.d.ts

@@ -1561,6 +1561,29 @@ attribute is the one answer to how wide a pane is.
 A value the track cannot honor is taken to the nearest one it can, by
 `across`, and both tiers read that rather than this.
 
+**`auto` fits as many as the track can hold**, at `--carousel-slide-min`
+apiece, and nothing is written onto the track: the count is the sheet's,
+and the sheet's alone, because it is the one number here CSS can work out
+for itself. Everything it takes is a length the sheet already has, so the
+panes are laid out at their final width by the first rule that runs, on a
+server's markup as on the client's, and no script is waited on. That is the
+whole reason a declared count was ever the only option: a carousel that
+asks how wide its container is can only ask on the client, so the panes go
+down at one width and move to another when the answer arrives. Written
+inline the count would outrank the sheet that computes it, which is why an
+`auto` track is handed nothing. A count stays for the design that calls for
+exactly three.
+
+The styled sheet says how it divides, and the headless `auto` example
+carries the same three lines for a consumer writing their own.
+
+**A value rather than the resting behavior**, which is what the
+responsiveness policy asks of every axis that a box decides: a splitter
+turns on `orientation="auto"` and a plain one does not turn at all. Fitting
+changes what the carousel *does*, since how many are across is how many
+places the track can stop, so a carousel that had not asked for it would
+find its position count moving with the window.
+
 No default, because it reflects. A reflected property with a value writes
 its attribute on upgrade, and the host then carries something a consumer's
 server markup never had, which React reports as a mismatch. The one-across
@@ -1598,6 +1621,29 @@ attribute is the one answer to how wide a pane is.
 A value the track cannot honor is taken to the nearest one it can, by
 `across`, and both tiers read that rather than this.
 
+**`auto` fits as many as the track can hold**, at `--carousel-slide-min`
+apiece, and nothing is written onto the track: the count is the sheet's,
+and the sheet's alone, because it is the one number here CSS can work out
+for itself. Everything it takes is a length the sheet already has, so the
+panes are laid out at their final width by the first rule that runs, on a
+server's markup as on the client's, and no script is waited on. That is the
+whole reason a declared count was ever the only option: a carousel that
+asks how wide its container is can only ask on the client, so the panes go
+down at one width and move to another when the answer arrives. Written
+inline the count would outrank the sheet that computes it, which is why an
+`auto` track is handed nothing. A count stays for the design that calls for
+exactly three.
+
+The styled sheet says how it divides, and the headless `auto` example
+carries the same three lines for a consumer writing their own.
+
+**A value rather than the resting behavior**, which is what the
+responsiveness policy asks of every axis that a box decides: a splitter
+turns on `orientation="auto"` and a plain one does not turn at all. Fitting
+changes what the carousel *does*, since how many are across is how many
+places the track can stop, so a carousel that had not asked for it would
+find its position count moving with the window.
+
 No default, because it reflects. A reflected property with a value writes
 its attribute on upgrade, and the host then carries something a consumer's
 server markup never had, which React reports as a mismatch. The one-across
@@ -2275,7 +2321,13 @@ holds a model beside its value, which Date Picker and Time Picker do not:
 `moved` is the HSB the square is drawn from, and it is written before the
 value is requested. Gating only the request would leave the square under
 the reader's pointer and the value where it was, which is a control that
-refuses and looks like it accepted. */
+refuses and looks like it accepted.
+
+**Two controls are refused whole rather than at either seam**, because
+both do something before they ask. The syntax toggle rewrites the value, so
+letting it move would show `rgb` over a hex it is no longer allowed to
+restate. The eyedropper clears the screen and runs a system sampler, so
+letting it open would take a color from the reader and drop it. */
   readonly?: (HelixColorPicker["readOnly"]) | undefined;
   /** Whether the control refuses changes while still submitting its value.
 
@@ -2294,7 +2346,13 @@ holds a model beside its value, which Date Picker and Time Picker do not:
 `moved` is the HSB the square is drawn from, and it is written before the
 value is requested. Gating only the request would leave the square under
 the reader's pointer and the value where it was, which is a control that
-refuses and looks like it accepted. */
+refuses and looks like it accepted.
+
+**Two controls are refused whole rather than at either seam**, because
+both do something before they ask. The syntax toggle rewrites the value, so
+letting it move would show `rgb` over a hex it is no longer allowed to
+restate. The eyedropper clears the screen and runs a system sampler, so
+letting it open would take a color from the reader and drop it. */
   readOnly?: (HelixColorPicker["readOnly"]) | undefined;
   /** Whether the form refuses to submit while no color is chosen.
 
@@ -7505,13 +7563,27 @@ attribute at all. */
 
 Zero closes it outright. A panel whose contents include the control that
 reopens it, a row of tabs being the usual one, wants that row left showing,
-and only whoever slotted it knows how tall that is. */
+and only whoever slotted it knows how tall that is.
+
+**A floor rather than a second state**, which is what keeps `panel-size` the
+whole truth about the panel: a divider driven to the end lands here and
+`panel-size` reads this number, so "closed" is something a consumer already
+stores rather than a property they have to learn. The splitter inside has a
+`collapsed` of its own and it is refused, for the reason `handleCollapse`
+gives. */
   "panel-collapsed-size"?: (HelixSandbox["panelCollapsedSize"] | `${number}`) | undefined;
   /** What the panel's height becomes when it is closed.
 
 Zero closes it outright. A panel whose contents include the control that
 reopens it, a row of tabs being the usual one, wants that row left showing,
-and only whoever slotted it knows how tall that is. */
+and only whoever slotted it knows how tall that is.
+
+**A floor rather than a second state**, which is what keeps `panel-size` the
+whole truth about the panel: a divider driven to the end lands here and
+`panel-size` reads this number, so "closed" is something a consumer already
+stores rather than a property they have to learn. The splitter inside has a
+`collapsed` of its own and it is refused, for the reason `handleCollapse`
+gives. */
   panelCollapsedSize?: (HelixSandbox["panelCollapsedSize"]) | undefined;
   /** Accessible name for the panel's divider. */
   "panel-label"?: (HelixSandbox["panelLabel"]) | undefined;
@@ -7532,7 +7604,7 @@ and only whoever slotted it knows how tall that is. */
 export type HelixSandboxVueEvents = {
   /** Fired before the source is edited, by the source pane and heard here. Cancelable: refusing it takes the decision and nothing moves. */
   "helix-before-edit": HelixSandboxHelixBeforeEditElementEvent;
-  /** Fired before the panel's divider is let go, with its height in pixels. Cancelable: refusing it takes the decision and nothing moves. */
+  /** Fired before the panel's divider is let go, with its height in pixels, and a panel driven shut arrives as `panel-collapsed-size`, which is the least it goes to. Cancelable: refusing it takes the decision and nothing moves. */
   "helix-before-panel-resize": HelixSandboxHelixBeforePanelResizeElementEvent;
   /** Fired before the panes' divider is let go, with the lead pane's share. Cancelable: refusing it takes the decision and nothing moves. */
   "helix-before-split": HelixSandboxHelixBeforeSplitElementEvent;
@@ -8275,9 +8347,9 @@ 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. */
+  /** Fired before a pane shuts or reopens, whether or not the resize that reached it was allowed, and carrying its own position: a shut pane sits at `collapsed-size` rather than at the number the resize named. 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, 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. */
+  /** 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 position and leaves the rest of the gesture, so a collapse the gesture reached is still announced and still yours to refuse. A drag has already drawn itself by then and holds where it was dropped until the consumer assigns their own. */
   "helix-before-resize": HelixSplitterHelixBeforeResizeElementEvent;
 };
 
@@ -10720,10 +10792,12 @@ export type CustomCssProperties = {
   "--carousel-gap"?: (string) | undefined;
   /** The size one pane is laid out at. A sheet sets it and the component measures the run with it. */
   "--carousel-pane"?: (string) | undefined;
-  /** How many slides go across, written onto the track by the component so a sheet divides the track by the same number the positions are counted from. Read it rather than selecting on `per-view`, which cannot be enumerated without a ceiling. See `perView`. */
+  /** How many slides go across, written onto the track by the component so a sheet divides the track by the same number the positions are counted from. Read it rather than selecting on `per-view`, which cannot be enumerated without a ceiling. Under `per-view="auto"` the component writes nothing and the sheet declares it instead, so the same name answers in both modes. See `perView`. */
   "--carousel-per-view"?: (string) | undefined;
   /** How far short of a whole pixel the run ends, on the last slide alone, for a sheet to take up as `margin-inline-end`. See `runEnd`. */
   "--carousel-run-end"?: (string) | undefined;
+  /** The narrowest a slide may be laid out, which is what `per-view="auto"` fits the track with. A length, since the sheet divides by it. Unset is the whole track, which is one across. */
+  "--carousel-slide-min"?: (string) | undefined;
   /** Fill behind the composer. */
   "--chat-composer-background-color"?: (string) | undefined;
   /** The composer's edge, so a theme can remove it. */