@design-edito/tools 0.5.31 → 0.5.33

package/agnostic/arrays/index.d.ts

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
-export * as isArrayOf from './is-array-of/index.js'
+export * as make from './make/index.js'
 export * as randomPick from './random-pick/index.js'
 export * as shuffle from './shuffle/index.js'
-export * as make from './make/index.js'
+export * as isArrayOf from './is-array-of/index.js'

package/agnostic/arrays/index.js

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
-export * as isArrayOf from './is-array-of/index.js'
+export * as make from './make/index.js'
 export * as randomPick from './random-pick/index.js'
 export * as shuffle from './shuffle/index.js'
-export * as make from './make/index.js'
+export * as isArrayOf from './is-array-of/index.js'

package/agnostic/colors/index.d.ts

@@ -3,10 +3,10 @@ export * as contrast from './contrast/index.js'
 export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
-export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
+export * as invert from './invert/index.js'
 export * as luminance from './luminance/index.js'
-export * as rotate from './rotate/index.js'
 export * as palette from './palette/index.js'
+export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'

package/agnostic/colors/index.js

@@ -3,10 +3,10 @@ export * as contrast from './contrast/index.js'
 export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
-export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
+export * as invert from './invert/index.js'
 export * as luminance from './luminance/index.js'
-export * as rotate from './rotate/index.js'
 export * as palette from './palette/index.js'
+export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'

package/agnostic/css/index.d.ts

@@ -1,6 +1,6 @@
-export * as clss from './clss/index.js'
 export * as bem from './bem/index.js'
+export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
-export * as stylesSet from './styles-set/index.js'
-export * as scale from './scale/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
+export * as scale from './scale/index.js'
+export * as stylesSet from './styles-set/index.js'

package/agnostic/css/index.js

@@ -1,6 +1,6 @@
-export * as clss from './clss/index.js'
 export * as bem from './bem/index.js'
+export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
-export * as stylesSet from './styles-set/index.js'
-export * as scale from './scale/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
+export * as scale from './scale/index.js'
+export * as stylesSet from './styles-set/index.js'

package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts

@@ -6,8 +6,8 @@ export * as at from './at/index.js'
 export * as call from './call/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
-export * as getattribute from './getattribute/index.js'
 export * as equals from './equals/index.js'
+export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
@@ -15,12 +15,13 @@ export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
 export * as initialize from './initialize/index.js'
 export * as join from './join/index.js'
-export * as map from './map/index.js'
 export * as length from './length/index.js'
+export * as map from './map/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
+export * as populate from './populate/index.js'
 export * as print from './print/index.js'
 export * as push from './push/index.js'
 export * as pusheach from './pusheach/index.js'
@@ -30,23 +31,22 @@ export * as removeclass from './removeclass/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
 export * as set from './set/index.js'
-export * as select from './select/index.js'
 export * as setattribute from './setattribute/index.js'
-export * as populate from './populate/index.js'
-export * as sorton from './sorton/index.js'
 export * as setproperty from './setproperty/index.js'
+export * as sorton from './sorton/index.js'
+export * as split from './split/index.js'
 export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
-export * as split from './split/index.js'
 export * as toboolean from './toboolean/index.js'
 export * as toelement from './toelement/index.js'
 export * as toggleclass from './toggleclass/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonull from './tonull/index.js'
+export * as select from './select/index.js'
 export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
+export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as toref from './toref/index.js'

package/agnostic/html/hyper-json/smart-tags/coalesced/index.js

@@ -6,8 +6,8 @@ export * as at from './at/index.js'
 export * as call from './call/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
-export * as getattribute from './getattribute/index.js'
 export * as equals from './equals/index.js'
+export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
@@ -15,12 +15,13 @@ export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
 export * as initialize from './initialize/index.js'
 export * as join from './join/index.js'
-export * as map from './map/index.js'
 export * as length from './length/index.js'
+export * as map from './map/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
+export * as populate from './populate/index.js'
 export * as print from './print/index.js'
 export * as push from './push/index.js'
 export * as pusheach from './pusheach/index.js'
@@ -30,23 +31,22 @@ export * as removeclass from './removeclass/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
 export * as set from './set/index.js'
-export * as select from './select/index.js'
 export * as setattribute from './setattribute/index.js'
-export * as populate from './populate/index.js'
-export * as sorton from './sorton/index.js'
 export * as setproperty from './setproperty/index.js'
+export * as sorton from './sorton/index.js'
+export * as split from './split/index.js'
 export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
-export * as split from './split/index.js'
 export * as toboolean from './toboolean/index.js'
 export * as toelement from './toelement/index.js'
 export * as toggleclass from './toggleclass/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonull from './tonull/index.js'
+export * as select from './select/index.js'
 export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
+export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as toref from './toref/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts

@@ -3,8 +3,8 @@ export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
 export * as element from './element/index.js'
 export * as get from './get/index.js'
-export * as nodelist from './nodelist/index.js'
 export * as guess from './guess/index.js'
+export * as nodelist from './nodelist/index.js'
 export * as null from './null/index.js'
 export * as number from './number/index.js'
 export * as record from './record/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.js

@@ -3,8 +3,8 @@ export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
 export * as element from './element/index.js'
 export * as get from './get/index.js'
-export * as nodelist from './nodelist/index.js'
 export * as guess from './guess/index.js'
+export * as nodelist from './nodelist/index.js'
 export * as null from './null/index.js'
 export * as number from './number/index.js'
 export * as record from './record/index.js'

package/agnostic/html/index.d.ts

@@ -1,10 +1,10 @@
-export * as hyperJson from './hyper-json/index.js'
 export * as deepSelect from './deep-select/index.js'
+export * as getPositionInsideParent from './get-position-inside-parent/index.js'
+export * as getNodeAncestors from './get-node-ancestors/index.js'
+export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
-export * as getNodeAncestors from './get-node-ancestors/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'
 export * as stringToNodes from './string-to-nodes/index.js'
 export * as watchSelection from './watch-selection/index.js'
-export * as getPositionInsideParent from './get-position-inside-parent/index.js'

package/agnostic/html/index.js

@@ -1,10 +1,10 @@
-export * as hyperJson from './hyper-json/index.js'
 export * as deepSelect from './deep-select/index.js'
+export * as getPositionInsideParent from './get-position-inside-parent/index.js'
+export * as getNodeAncestors from './get-node-ancestors/index.js'
+export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
-export * as getNodeAncestors from './get-node-ancestors/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'
 export * as stringToNodes from './string-to-nodes/index.js'
 export * as watchSelection from './watch-selection/index.js'
-export * as getPositionInsideParent from './get-position-inside-parent/index.js'

package/agnostic/index.d.ts

@@ -1,11 +1,11 @@
-export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
+export * as arrays from './arrays/index.js'
 export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
-export * as numbers from './numbers/index.js'
 export * as misc from './misc/index.js'
+export * as numbers from './numbers/index.js'
 export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
 export * as random from './random/index.js'
@@ -13,5 +13,5 @@ export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
 export * as time from './time/index.js'
-export * as subtitles from './subtitles/index.js'
 export * as typescript from './typescript/index.js'
+export * as subtitles from './subtitles/index.js'

package/agnostic/index.js

@@ -1,11 +1,11 @@
-export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
+export * as arrays from './arrays/index.js'
 export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
-export * as numbers from './numbers/index.js'
 export * as misc from './misc/index.js'
+export * as numbers from './numbers/index.js'
 export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
 export * as random from './random/index.js'
@@ -13,5 +13,5 @@ export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
 export * as time from './time/index.js'
-export * as subtitles from './subtitles/index.js'
 export * as typescript from './typescript/index.js'
+export * as subtitles from './subtitles/index.js'

package/agnostic/misc/crossenv/index.d.ts

@@ -1,2 +1,2 @@
-export * as detectRuntime from './detect-runtime/index.js'
 export * as window from './window/index.js'
+export * as detectRuntime from './detect-runtime/index.js'

package/agnostic/misc/crossenv/index.js

@@ -1,2 +1,2 @@
-export * as detectRuntime from './detect-runtime/index.js'
 export * as window from './window/index.js'
+export * as detectRuntime from './detect-runtime/index.js'

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
 export * as assert from './assert/index.js'
 export * as cast from './cast/index.js'
+export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
-export * as crossenv from './crossenv/index.js'
 export * as dataSize from './data-size/index.js'
+export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as isNullish from './is-nullish/index.js'
 export * as logs from './logs/index.js'
-export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
+export * as crossenv from './crossenv/index.js'
 export * as outcome from './outcome/index.js'
-export * as connection from './connection/index.js'

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
 export * as assert from './assert/index.js'
 export * as cast from './cast/index.js'
+export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
-export * as crossenv from './crossenv/index.js'
 export * as dataSize from './data-size/index.js'
+export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as isNullish from './is-nullish/index.js'
 export * as logs from './logs/index.js'
-export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
+export * as crossenv from './crossenv/index.js'
 export * as outcome from './outcome/index.js'
-export * as connection from './connection/index.js'

package/agnostic/numbers/index.d.ts

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as clamp from './clamp/index.js'
 export * as approximateRational from './approximate-rational/index.js'
+export * as clamp from './clamp/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
-export * as round from './round/index.js'
 export * as interpolate from './interpolate/index.js'
+export * as round from './round/index.js'

package/agnostic/numbers/index.js

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as clamp from './clamp/index.js'
 export * as approximateRational from './approximate-rational/index.js'
+export * as clamp from './clamp/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
-export * as round from './round/index.js'
 export * as interpolate from './interpolate/index.js'
+export * as round from './round/index.js'

package/agnostic/objects/index.d.ts

@@ -1,8 +1,8 @@
 export * as deepGetProperty from './deep-get-property/index.js'
 export * as enums from './enums/index.js'
+export * as flattenGetters from './flatten-getters/index.js'
 export * as isObject from './is-object/index.js'
 export * as isRecord from './is-record/index.js'
-export * as flattenGetters from './flatten-getters/index.js'
 export * as recordFormat from './record-format/index.js'
 export * as recordMap from './record-map/index.js'
 export * as validation from './validation/index.js'

package/agnostic/objects/index.js

@@ -1,8 +1,8 @@
 export * as deepGetProperty from './deep-get-property/index.js'
 export * as enums from './enums/index.js'
+export * as flattenGetters from './flatten-getters/index.js'
 export * as isObject from './is-object/index.js'
 export * as isRecord from './is-record/index.js'
-export * as flattenGetters from './flatten-getters/index.js'
 export * as recordFormat from './record-format/index.js'
 export * as recordMap from './record-map/index.js'
 export * as validation from './validation/index.js'

package/agnostic/random/index.d.ts

@@ -1,3 +1,3 @@
 export * as hexChar from './hex-char/index.js'
-export * as uuid from './uuid/index.js'
 export * as random from './random/index.js'
+export * as uuid from './uuid/index.js'

package/agnostic/random/index.js

@@ -1,3 +1,3 @@
 export * as hexChar from './hex-char/index.js'
-export * as uuid from './uuid/index.js'
 export * as random from './random/index.js'
+export * as uuid from './uuid/index.js'

package/agnostic/sanitization/index.d.ts

@@ -1,4 +1,4 @@
 export * as fileName from './file-name/index.js'
 export * as html from './html/index.js'
-export * as userInput from './user-input/index.js'
 export * as path from './path/index.js'
+export * as userInput from './user-input/index.js'

package/agnostic/sanitization/index.js

@@ -1,4 +1,4 @@
 export * as fileName from './file-name/index.js'
 export * as html from './html/index.js'
-export * as userInput from './user-input/index.js'
 export * as path from './path/index.js'
+export * as userInput from './user-input/index.js'

package/agnostic/strings/index.d.ts

@@ -1,8 +1,8 @@
+export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
-export * as charCodes from './char-codes/index.js'
-export * as replaceAll from './replace-all/index.js'
+export * as parseTable from './parse-table/index.js'
 export * as splitTrim from './split-trim/index.js'
+export * as replaceAll from './replace-all/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
-export * as parseTable from './parse-table/index.js'
 export * as trim from './trim/index.js'

package/agnostic/strings/index.js

@@ -1,8 +1,8 @@
+export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
-export * as charCodes from './char-codes/index.js'
-export * as replaceAll from './replace-all/index.js'
+export * as parseTable from './parse-table/index.js'
 export * as splitTrim from './split-trim/index.js'
+export * as replaceAll from './replace-all/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
-export * as parseTable from './parse-table/index.js'
 export * as trim from './trim/index.js'

package/agnostic/time/dates/index.d.ts

@@ -1,2 +1,2 @@
-export * as toFrenchRepublican from './to-french-republican/index.js'
 export * as formatDate from './format-date/index.js'
+export * as toFrenchRepublican from './to-french-republican/index.js'

package/agnostic/time/dates/index.js

@@ -1,2 +1,2 @@
-export * as toFrenchRepublican from './to-french-republican/index.js'
 export * as formatDate from './format-date/index.js'
+export * as toFrenchRepublican from './to-french-republican/index.js'

package/agnostic/time/index.d.ts

@@ -1,5 +1,5 @@
 export * as dates from './dates/index.js'
 export * as duration from './duration/index.js'
-export * as timeout from './timeout/index.js'
-export * as transitions from './transitions/index.js'
 export * as wait from './wait/index.js'
+export * as transitions from './transitions/index.js'
+export * as timeout from './timeout/index.js'

package/agnostic/time/index.js

@@ -1,5 +1,5 @@
 export * as dates from './dates/index.js'
 export * as duration from './duration/index.js'
-export * as timeout from './timeout/index.js'
-export * as transitions from './transitions/index.js'
 export * as wait from './wait/index.js'
+export * as transitions from './transitions/index.js'
+export * as timeout from './timeout/index.js'

package/components/Gallery/index.d.ts

@@ -3,45 +3,33 @@ import type { WithClassName } from '../utils/types.js';
 /**
  * Props for the Gallery component.
  *
- * @property paddingLeft - Left padding applied to the first slot. Accepts a number (pixels) or any valid CSS length value.
- * If not provided, falls back to `padding` or `0px`.
- * @property paddingRight - Right padding applied to the last slot. Accepts a number (pixels) or any valid CSS length value.
- * If not provided, falls back to `padding` or `0px`.
- * @property padding - Shorthand horizontal padding applied to both ends when `paddingLeft` and/or `paddingRight`
- * are not explicitly defined. Accepts a number (pixels) or any valid CSS length value.
- * @property prevButtonContent - Content rendered inside the "previous" navigation control.
- * Defaults to the string `"prev"` when not provided.
- * @property nextButtonContent - Content rendered inside the "next" navigation control.
- * Defaults to the string `"next"` when not provided.
- * @property paginationContent - Content rendered inside each pagination item.
- * Can be:
- * - A ReactNode used for all pages,
- * - A function receiving the page index and returning a ReactNode,
- * - Undefined, in which case the page index is displayed.
- * @property defaultActive - Optional. When uncontrolled mode, sets the default active slot at mount
- * @property active - Optional controlled index. When provided, the active slot is driven by this
- * value instead of internal scroll-derived state. When omitted, the component manages its own
- * active index based on scroll position.
- * @property noSnap - Optional, defines if scroll is free in side the scroller or not (defaults to false)
- * @property onPrevClicked - Called when the "previous" control is clicked,
- * before the gallery reacts, with the active index as it was.
- * @property onNextClicked - Called when the "next" control is clicked, before
- * the gallery reacts, with the active index as it was.
- * @property onPaginationClicked - Called when a pagination item is clicked,
- * before the gallery reacts, with the active index as it was and the target index.
- * @property onActiveSlotChanged - Called after the active slot changed, with
- * the new index.
- * @property onCanGoLeftChanged - Called after the ability to scroll further left
- * changed, with the new value. Never on mount.
- * @property onCanGoRightChanged - Called after the ability to scroll further
- * right changed, with the new value. Never on mount.
- * @property className - Optional additional class name(s) applied to the root element.
- * @property children - Elements rendered as gallery slots. Each child is wrapped in a slot container.
+ * @property offsetLeft - Room kept before the first slot, so it can reach the middle
+ * like any other. A number is pixels. Falls back to `offset`, then `0px`.
+ * @property offsetRight - Room kept after the last slot. Same rules.
+ * @property offset - Shorthand for both ends, used when a side is not set.
+ * @property prevButtonContent - Content of the "previous" control. Defaults to `"prev"`.
+ * @property nextButtonContent - Content of the "next" control. Defaults to `"next"`.
+ * @property paginationContent - Content of each pagination item: a node used for all of
+ * them, a function of the page index, or undefined to show the index.
+ * @property defaultActive - Slot to scroll to at mount, in uncontrolled mode.
+ * @property active - Controlled index. When set, the active slot is this one and hand
+ * scrolling is disabled.
+ * @property noSnap - Frees the scroll from snapping to a slot.
+ * @property onPrevClicked - Fires before the gallery reacts, with the index as it was.
+ * @property onNextClicked - Fires before the gallery reacts, with the index as it was.
+ * @property onPaginationClicked - Fires before the gallery reacts, with the index as it
+ * was and the one aimed at.
+ * @property onActiveSlotChanged - Fires after the active slot changed, with the new index.
+ * @property onCanGoLeftChanged - Fires after the ability to scroll further left changed.
+ * Never on mount.
+ * @property onCanGoRightChanged - Same, to the right.
+ * @property className - Added to the root element.
+ * @property children - One slot per child.
  */
 export type Props = PropsWithChildren<WithClassName<{
-    paddingLeft?: string | number;
-    paddingRight?: string | number;
-    padding?: string | number;
+    offsetLeft?: string | number;
+    offsetRight?: string | number;
+    offset?: string | number;
     prevButtonContent?: ReactNode;
     nextButtonContent?: ReactNode;
     paginationContent?: ReactNode | ((page: number) => ReactNode);
@@ -56,16 +44,32 @@ export type Props = PropsWithChildren<WithClassName<{
     onCanGoRightChanged?: (canGoRight: boolean) => void;
 }>>;
 /**
- * Horizontally scrollable gallery component with navigation controls and pagination.
+ * Horizontally scrollable gallery, with navigation controls and pagination.
  *
- * Tracks the active slot based on scroll position and exposes state through CSS class names
- * and a `data-active` attribute on the root element.
+ * Geometry is measured **once per layout change** into a table of scroll positions, one
+ * per slot, and the boundaries between them. A scroll event then only has to place a
+ * number between two others — no element is measured while the reader scrolls.
+ *
+ * The same table is what the controls scroll to, so reading the active slot and moving
+ * to one cannot disagree, with or without snapping.
+ *
+ * ### CSS elements
+ * - `scroller`
+ * - `slot`, `slot--active`
+ * - `actions`, `prev`, `next`
+ * - `pagination`, `page`, `page--active`
+ *
+ * Root modifiers: `controlled`, `no-snap`, `measured`, `at-first`, `at-last`,
+ * `can-go-left`, `can-go-right`.
  *
  * @param props - Component properties.
  * @see {@link Props}
- * @returns A container element wrapping:
- * - A scrollable area containing each child in a slot wrapper,
- * - Previous/next navigation controls,
- * - Pagination controls allowing direct slot activation.
+ * @returns A container wrapping the scroller, the two controls and the pagination.
+ *
+ * @remarks
+ * Nothing is measured while the reader scrolls: the table is rebuilt only when a box
+ * changes size or a slot is added, watched through a `ResizeObserver`. Until the first
+ * measurement lands, the root carries no `measured` modifier and every slot position
+ * reads as `0`.
  */
 export declare const Gallery: FunctionComponent<Props>;