@design-edito/tools 0.5.32 → 0.5.34

package/agnostic/arrays/index.d.ts

@@ -1,6 +1,6 @@
-export * as findDuplicates from './find-duplicates/index.js'
 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 shuffle from './shuffle/index.js'
 export * as randomPick from './random-pick/index.js'
+export * as shuffle from './shuffle/index.js'

package/agnostic/arrays/index.js

@@ -1,6 +1,6 @@
-export * as findDuplicates from './find-duplicates/index.js'
 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 shuffle from './shuffle/index.js'
 export * as randomPick from './random-pick/index.js'
+export * as shuffle from './shuffle/index.js'

package/agnostic/colors/index.d.ts

@@ -1,12 +1,12 @@
 export * as channels from './channels/index.js'
 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 luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
 export * as rotate from './rotate/index.js'
-export * as lerp from './lerp/index.js'
-export * as distance from './distance/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
+export * as lerp from './lerp/index.js'

package/agnostic/colors/index.js

@@ -1,12 +1,12 @@
 export * as channels from './channels/index.js'
 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 luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
 export * as rotate from './rotate/index.js'
-export * as lerp from './lerp/index.js'
-export * as distance from './distance/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
+export * as lerp from './lerp/index.js'

package/agnostic/css/index.d.ts

@@ -1,6 +1,6 @@
 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 isValidCssClassName from './is-valid-css-class-name/index.js'
 export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'
+export * as clss from './clss/index.js'

package/agnostic/css/index.js

@@ -1,6 +1,6 @@
 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 isValidCssClassName from './is-valid-css-class-name/index.js'
 export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'
+export * as clss from './clss/index.js'

package/agnostic/errors/index.d.ts

@@ -1,2 +1,2 @@
-export * as unknownToString from './unknown-to-string/index.js'
 export * as register from './register/index.js'
+export * as unknownToString from './unknown-to-string/index.js'

package/agnostic/errors/index.js

@@ -1,2 +1,2 @@
-export * as unknownToString from './unknown-to-string/index.js'
 export * as register from './register/index.js'
+export * as unknownToString from './unknown-to-string/index.js'

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

@@ -1,6 +1,6 @@
-export * as add from './add/index.js'
 export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
+export * as add from './add/index.js'
 export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as call from './call/index.js'
@@ -9,14 +9,14 @@ export * as deleteproperties from './deleteproperties/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as equals from './equals/index.js'
 export * as getproperties from './getproperties/index.js'
-export * as hjparse from './hjparse/index.js'
 export * as getproperty from './getproperty/index.js'
+export * as hjparse from './hjparse/index.js'
 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 length from './length/index.js'
 export * as map from './map/index.js'
+export * as join from './join/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
@@ -24,13 +24,13 @@ 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'
 export * as recordtoarray from './recordtoarray/index.js'
 export * as removeattribute from './removeattribute/index.js'
-export * as pusheach from './pusheach/index.js'
 export * as removeclass from './removeclass/index.js'
 export * as renameproperty from './renameproperty/index.js'
-export * as replace from './replace/index.js'
 export * as select from './select/index.js'
+export * as replace from './replace/index.js'
 export * as set from './set/index.js'
 export * as setattribute from './setattribute/index.js'
 export * as setproperty from './setproperty/index.js'
@@ -38,15 +38,15 @@ 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 toggleclass from './toggleclass/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 torecord from './torecord/index.js'
 export * as tonumber from './tonumber/index.js'
+export * as torecord from './torecord/index.js'
+export * as tonull from './tonull/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 totext from './totext/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

@@ -1,6 +1,6 @@
-export * as add from './add/index.js'
 export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
+export * as add from './add/index.js'
 export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as call from './call/index.js'
@@ -9,14 +9,14 @@ export * as deleteproperties from './deleteproperties/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as equals from './equals/index.js'
 export * as getproperties from './getproperties/index.js'
-export * as hjparse from './hjparse/index.js'
 export * as getproperty from './getproperty/index.js'
+export * as hjparse from './hjparse/index.js'
 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 length from './length/index.js'
 export * as map from './map/index.js'
+export * as join from './join/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
@@ -24,13 +24,13 @@ 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'
 export * as recordtoarray from './recordtoarray/index.js'
 export * as removeattribute from './removeattribute/index.js'
-export * as pusheach from './pusheach/index.js'
 export * as removeclass from './removeclass/index.js'
 export * as renameproperty from './renameproperty/index.js'
-export * as replace from './replace/index.js'
 export * as select from './select/index.js'
+export * as replace from './replace/index.js'
 export * as set from './set/index.js'
 export * as setattribute from './setattribute/index.js'
 export * as setproperty from './setproperty/index.js'
@@ -38,15 +38,15 @@ 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 toggleclass from './toggleclass/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 torecord from './torecord/index.js'
 export * as tonumber from './tonumber/index.js'
+export * as torecord from './torecord/index.js'
+export * as tonull from './tonull/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 totext from './totext/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

@@ -6,8 +6,8 @@ export * as get from './get/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 record from './record/index.js'
 export * as number from './number/index.js'
+export * as record from './record/index.js'
 export * as ref from './ref/index.js'
-export * as text from './text/index.js'
 export * as string from './string/index.js'
+export * as text from './text/index.js'

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

@@ -6,8 +6,8 @@ export * as get from './get/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 record from './record/index.js'
 export * as number from './number/index.js'
+export * as record from './record/index.js'
 export * as ref from './ref/index.js'
-export * as text from './text/index.js'
 export * as string from './string/index.js'
+export * as text from './text/index.js'

package/agnostic/index.d.ts

@@ -2,12 +2,12 @@ export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
 export * as css from './css/index.js'
+export * as html from './html/index.js'
 export * as errors from './errors/index.js'
 export * as misc from './misc/index.js'
-export * as html from './html/index.js'
 export * as numbers from './numbers/index.js'
-export * as optim from './optim/index.js'
 export * as objects from './objects/index.js'
+export * as optim from './optim/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'

package/agnostic/index.js

@@ -2,12 +2,12 @@ export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
 export * as css from './css/index.js'
+export * as html from './html/index.js'
 export * as errors from './errors/index.js'
 export * as misc from './misc/index.js'
-export * as html from './html/index.js'
 export * as numbers from './numbers/index.js'
-export * as optim from './optim/index.js'
 export * as objects from './objects/index.js'
+export * as optim from './optim/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
-export * as connection from './connection/index.js'
+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 assert from './assert/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 crossenv from './crossenv/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
-export * as connection from './connection/index.js'
+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 assert from './assert/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 crossenv from './crossenv/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'

package/agnostic/numbers/index.d.ts

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

package/agnostic/numbers/index.js

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

package/agnostic/objects/index.d.ts

@@ -1,9 +1,9 @@
 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 recordFormat from './record-format/index.js'
-export * as isObject from './is-object/index.js'
-export * as sortKeys from './sort-keys/index.js'
 export * as recordMap from './record-map/index.js'
+export * as sortKeys from './sort-keys/index.js'
 export * as validation from './validation/index.js'

package/agnostic/objects/index.js

@@ -1,9 +1,9 @@
 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 recordFormat from './record-format/index.js'
-export * as isObject from './is-object/index.js'
-export * as sortKeys from './sort-keys/index.js'
 export * as recordMap from './record-map/index.js'
+export * as sortKeys from './sort-keys/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/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 toAlphanum from './to-alphanum/index.js'
-export * as splitTrim from './split-trim/index.js'
 export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
+export * as splitTrim from './split-trim/index.js'
+export * as toAlphanum from './to-alphanum/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 toAlphanum from './to-alphanum/index.js'
-export * as splitTrim from './split-trim/index.js'
 export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
+export * as splitTrim from './split-trim/index.js'
+export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'

package/agnostic/subtitles/index.d.ts

@@ -1,2 +1,2 @@
-export * as parseSrt from './parse-srt/index.js'
 export * as srtTimecodeToMs from './srt-timecode-to-ms/index.js'
+export * as parseSrt from './parse-srt/index.js'

package/agnostic/subtitles/index.js

@@ -1,2 +1,2 @@
-export * as parseSrt from './parse-srt/index.js'
 export * as srtTimecodeToMs from './srt-timecode-to-ms/index.js'
+export * as parseSrt from './parse-srt/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 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 timeout from './timeout/index.js'

package/components/Gallery/index.d.ts

@@ -3,10 +3,10 @@ import type { WithClassName } from '../utils/types.js';
 /**
  * Props for the Gallery component.
  *
- * @property paddingLeft - Left padding applied to the first slot. A number is pixels.
- * Falls back to `padding`, then `0px`.
- * @property paddingRight - Right padding applied to the last slot. Same rules.
- * @property padding - Shorthand for both ends, used when a side is not set.
+ * @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
@@ -27,9 +27,9 @@ import type { WithClassName } from '../utils/types.js';
  * @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);

package/components/Gallery/index.js

@@ -5,8 +5,8 @@ import { mergeClassNames, useChangeDispatch } from '../utils/index.js';
 import { gallery as publicClassName } from '../public-classnames.js';
 import { EMPTY_GEOMETRY, measureGeometry, readActiveIndex, readReach } from './utils.js';
 import cssModule from './styles.module.css';
-/** Resolves one side's padding to a CSS length, falling back to the shorthand then to `0px`. */
-function resolvePadding(side, shorthand) {
+/** Resolves one side's offset to a CSS length, falling back to the shorthand then to `0px`. */
+function resolveOffset(side, shorthand) {
     const value = side ?? shorthand ?? 0;
     return typeof value === 'number' ? `${value}px` : value;
 }
@@ -39,7 +39,7 @@ function resolvePadding(side, shorthand) {
  * measurement lands, the root carries no `measured` modifier and every slot position
  * reads as `0`.
  */
-export const Gallery = ({ paddingLeft, paddingRight, padding, prevButtonContent, nextButtonContent, paginationContent, defaultActive, active, noSnap, onPrevClicked, onNextClicked, onPaginationClicked, onActiveSlotChanged, onCanGoLeftChanged, onCanGoRightChanged, children, className }) => {
+export const Gallery = ({ offsetLeft, offsetRight, offset, prevButtonContent, nextButtonContent, paginationContent, defaultActive, active, noSnap, onPrevClicked, onNextClicked, onPaginationClicked, onActiveSlotChanged, onCanGoLeftChanged, onCanGoRightChanged, children, className }) => {
     // State & refs
     const scrollerRef = useRef(null);
     const geometryRef = useRef(EMPTY_GEOMETRY);
@@ -77,10 +77,10 @@ export const Gallery = ({ paddingLeft, paddingRight, padding, prevButtonContent,
     }, [readScroll]);
     const scrollToSlot = useCallback((pos, smooth = true) => {
         const scrollerElt = scrollerRef.current;
-        const offset = geometryRef.current.offsets[pos];
-        if (scrollerElt === null || offset === undefined)
+        const scrollPosition = geometryRef.current.scrollPositions[pos];
+        if (scrollerElt === null || scrollPosition === undefined)
             return;
-        scrollerElt.scrollTo({ left: offset, behavior: smooth ? 'smooth' : 'instant' });
+        scrollerElt.scrollTo({ left: scrollPosition, behavior: smooth ? 'smooth' : 'instant' });
     }, []);
     // User actions handlers
     const handlePrevClick = () => {
@@ -165,16 +165,16 @@ export const Gallery = ({ paddingLeft, paddingRight, padding, prevButtonContent,
     const nextBtnClss = c('next');
     const paginationClss = c('pagination');
     const dataAttributes = { 'data-active': `${activeIndex}` };
-    const actualPaddingLeft = resolvePadding(paddingLeft, padding);
-    const actualPaddingRight = resolvePadding(paddingRight, padding);
+    const actualOffsetLeft = resolveOffset(offsetLeft, offset);
+    const actualOffsetRight = resolveOffset(offsetRight, offset);
     return _jsxs("div", { className: rootClss, ...dataAttributes, children: [_jsx("div", { className: scrollerClss, ref: scrollerRef, children: Children.map(children, (child, pos) => {
                     const slotClss = c('slot', { active: pos === activeIndex });
                     const style = {
                         'margin-left': pos === 0
-                            ? actualPaddingLeft
+                            ? actualOffsetLeft
                             : undefined,
                         'margin-right': pos === childrenCount - 1
-                            ? actualPaddingRight
+                            ? actualOffsetRight
                             : undefined
                     };
                     return _jsx("div", { className: slotClss, style: { ...style }, "data-slot": pos, children: child }, pos);

package/components/Gallery/utils.d.ts

@@ -1,7 +1,7 @@
 /** The layout, measured once, so that reading the active slot touches no element. */
 export type Geometry = {
     /** Scroll positions that bring each slot to the middle, clamped to the track. */
-    offsets: number[];
+    scrollPositions: number[];
     /** Midpoints between consecutive slot centres, in content coordinates. */
     boundaries: number[];
     /** Half the viewport, kept here rather than read again on every scroll. */
@@ -13,9 +13,9 @@ export declare const EMPTY_GEOMETRY: Geometry;
 /**
  * Everything the gallery needs to know about its own layout.
  *
- * Positions are taken against the scroller's own box rather than `offsetLeft`, which is
- * relative to whichever ancestor happens to be positioned — so a gallery nested anywhere
- * measures the same.
+ * Positions are taken against the scroller's own box rather than the DOM's `offsetLeft`,
+ * which is relative to whichever ancestor happens to be positioned — so a gallery nested
+ * anywhere measures the same.
  *
  * **Boundaries come from slot centres, and scroll positions are clamped.** Keeping them
  * apart is what avoids ties: two slots at the same end of the track share a scroll

package/components/Gallery/utils.js

@@ -1,7 +1,7 @@
 /** A tolerance in px, so a sub-pixel scroll position does not read as « can still go ». */
 const EDGE_TOLERANCE = 1;
 export const EMPTY_GEOMETRY = {
-    offsets: [],
+    scrollPositions: [],
     boundaries: [],
     halfViewport: 0,
     maxScroll: 0
@@ -9,9 +9,9 @@ export const EMPTY_GEOMETRY = {
 /**
  * Everything the gallery needs to know about its own layout.
  *
- * Positions are taken against the scroller's own box rather than `offsetLeft`, which is
- * relative to whichever ancestor happens to be positioned — so a gallery nested anywhere
- * measures the same.
+ * Positions are taken against the scroller's own box rather than the DOM's `offsetLeft`,
+ * which is relative to whichever ancestor happens to be positioned — so a gallery nested
+ * anywhere measures the same.
  *
  * **Boundaries come from slot centres, and scroll positions are clamped.** Keeping them
  * apart is what avoids ties: two slots at the same end of the track share a scroll
@@ -27,7 +27,7 @@ export function measureGeometry(scroller) {
         return rect.left - scrollerLeft + scrollLeft + rect.width / 2;
     });
     return {
-        offsets: centers.map(center => Math.min(Math.max(center - halfViewport, 0), maxScroll)),
+        scrollPositions: centers.map(center => Math.min(Math.max(center - halfViewport, 0), maxScroll)),
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- i is in range by construction, centers[i] sits before the one being mapped
         boundaries: centers.slice(1).map((center, i) => (centers[i] + center) / 2),
         halfViewport,

package/components/UIModule/index.d.ts

@@ -1,36 +1,43 @@
 import { type FunctionComponent } from 'react';
 import type { WithClassName } from '../utils/types.js';
 /**
- * Describes the contract a dynamically imported UI module must satisfy.
- * Every member is validated at runtime after the import resolves.
+ * Describes the contract a dynamically imported UI module must satisfy. Only `init`
+ * is required; every member present is validated at runtime after the import resolves.
  *
- * @property init - Called once after the module loads. Receives the current
- * `props` and must return the root `Element` that will be appended to the
- * host `<div>`. Throwing inside `init` is caught and surfaced as an error state.
- * @property destroy - Called when the component unmounts or `src` changes.
- * Receives the `Element` previously returned by `init`. Use it to tear down
- * event listeners, timers, or third-party instances.
- * @property update - Optional. Called when `props` change after the module is
- * already initialized. Receives the live `Element` and the new props object.
+ * @property init - Called once after the module loads. Receives the current `props`
+ * and must return the root `Element` that will be appended to the host `<div>`.
+ * **The element is not in the document yet**, so measuring it or reaching its
+ * ancestors belongs in `postInit`, not here. Throwing is caught and surfaced as an
+ * error state.
+ * @property postInit - Optional. Called once, right after the element returned by
+ * `init` has been appended. First point at which the module holds an attached
+ * element: layout can be measured and ancestors reached.
+ * @property update - Optional. Called when the `props` object changes identity,
+ * once the module is live. Compared by reference, not by value — a consumer passing
+ * an inline object gets one call per render, one passing a stable reference gets one
+ * per real change.
+ * @property destroy - Optional. Called when the component unmounts or `src` changes.
+ * Receives the `Element` previously returned by `init`. Use it to tear down event
+ * listeners, timers, or third-party instances.
  * @property css - Optional array of raw CSS strings scoped automatically to
  * the host element via `.<publicClassName>#<id> { … }` and injected as
  * `<style>` elements.
  */
 type ModuleData = {
     init: (props: Record<string, unknown>) => Element;
-    destroy: (target: Element) => void;
+    postInit?: (target: Element, props: Record<string, unknown>) => void;
     update?: (target: Element, props: Record<string, unknown>) => void;
+    destroy?: (target: Element) => void;
     css?: string[];
 };
 /**
  * Props for the {@link UIModule} component.
  *
  * @property src - URL of the ES module to import dynamically. The module must
- * satisfy the {@link ModuleData} interface — `init` and `destroy` are required,
- * `update` and `css` are optional. When `undefined`, nothing is loaded and the
- * component stays in the `--no-module` state.
- * @property props - Arbitrary key-value object forwarded verbatim to the
- * module's `init` call and, on subsequent changes, to `update` (if exported).
+ * satisfy the {@link ModuleData} interface — only `init` is required. When
+ * `undefined`, nothing is loaded and the component stays in the `--no-module` state.
+ * @property props - Arbitrary key-value object forwarded verbatim to `init`, then to
+ * `postInit`, then to `update` whenever the object's identity changes.
  * @property onIdGenerated - Called once on mount with the instance's generated
  * `id`. The id never changes afterwards, so this fires exactly once.
  * @property onIsLoadingChanged - Called after the loading state changed, with
@@ -55,8 +62,14 @@ export type Props = WithClassName<{
  * and appends that element to its own root `<div>`.
  *
  * The imported module is expected to conform to the {@link ModuleData} interface.
- * Any violation (missing exports, wrong types, `init` not returning an `Element`)
- * transitions the component into the `--error` state and logs to `console.error`.
+ * A missing `init`, a member of the wrong type, or an `init` not returning an
+ * `Element` transitions the component into the `--error` state and logs to
+ * `console.error`.
+ *
+ * ### Lifecycle
+ * `init(props)` builds the element, **detached**. It is appended, then `postInit`
+ * runs on it attached. `update` follows each change of the `props` object's
+ * identity, and `destroy` runs on unmount or when `src` changes.
  *
  * ### CSS modifiers
  * Reflecting the current load lifecycle:

package/components/UIModule/index.js

@@ -13,8 +13,14 @@ import cssModule from './styles.module.css';
  * and appends that element to its own root `<div>`.
  *
  * The imported module is expected to conform to the {@link ModuleData} interface.
- * Any violation (missing exports, wrong types, `init` not returning an `Element`)
- * transitions the component into the `--error` state and logs to `console.error`.
+ * A missing `init`, a member of the wrong type, or an `init` not returning an
+ * `Element` transitions the component into the `--error` state and logs to
+ * `console.error`.
+ *
+ * ### Lifecycle
+ * `init(props)` builds the element, **detached**. It is appended, then `postInit`
+ * runs on it attached. `update` follows each change of the `props` object's
+ * identity, and `destroy` runs on unmount or when `src` changes.
  *
  * ### CSS modifiers
  * Reflecting the current load lifecycle:
@@ -45,10 +51,16 @@ export const UIModule = ({ src, props, onIdGenerated, onIsLoadingChanged, onLoad
     // What the teardown needs, held outside state so the load effect can depend on
     // `src` alone and still destroy whatever is actually live at cleanup time.
     const liveInstanceRef = useRef(null);
+    // The load effect depends on `src` alone, so the props it closes over are those of
+    // the render it ran on. This is what `init` and `postInit` read instead.
+    const propsRef = useRef(props);
     // State dispatch
     useChangeDispatch(isLoading, onIsLoadingChanged);
     useChangeDispatch(loadedModule, onLoadedModuleChanged);
     useChangeDispatch(moduleTarget, onModuleTargetChanged);
+    // Fx. no dep. - keep the latest props reachable from the effects that run outside
+    // their own render, declared first so they read this render's value and not the last
+    useEffect(() => { propsRef.current = props; });
     // Fx. no dep. - report the generated id, which never changes afterwards
     useEffect(() => { onIdGenerated?.(id); }, []);
     // Fx. dep. `src` - import, validate and initialize the module
@@ -63,8 +75,10 @@ export const UIModule = ({ src, props, onIdGenerated, onIsLoadingChanged, onLoad
                 return setLoadedModule(new Error('Not a module'));
             if (!('init' in data) || typeof data.init !== 'function')
                 return setLoadedModule(new Error('Module exported member `init` must be a function'));
-            if (!('destroy' in data) || typeof data.destroy !== 'function')
+            if ('destroy' in data && typeof data.destroy !== 'function')
                 return setLoadedModule(new Error('Module exported member `destroy` must be a function'));
+            if ('postInit' in data && typeof data.postInit !== 'function')
+                return setLoadedModule(new Error('Module exported member `postInit` must be a function'));
             if ('css' in data) {
                 if (!Array.isArray(data.css))
                     return setLoadedModule(new Error('Module exported member `css` must be an array of strings'));
@@ -77,7 +91,7 @@ export const UIModule = ({ src, props, onIdGenerated, onIsLoadingChanged, onLoad
             const module = data;
             setLoadedModule(module);
             try {
-                const target = module.init(props ?? {});
+                const target = module.init(propsRef.current ?? {});
                 if (!(target instanceof Element))
                     return setLoadedModule(new Error('Module exported function `init` must return an Element'));
                 liveInstanceRef.current = { module, target };
@@ -99,7 +113,7 @@ export const UIModule = ({ src, props, onIdGenerated, onIsLoadingChanged, onLoad
             const liveInstance = liveInstanceRef.current;
             if (liveInstance === null)
                 return;
-            liveInstance.module.destroy(liveInstance.target);
+            liveInstance.module.destroy?.(liveInstance.target);
             liveInstanceRef.current = null;
         };
     }, [src]);
@@ -109,14 +123,26 @@ export const UIModule = ({ src, props, onIdGenerated, onIsLoadingChanged, onLoad
         if (loadedModule instanceof Error)
             console.error(loadedModule);
     }, [loadedModule]);
-    // Fx. dep. `moduleTarget` - append the element the module built
+    // Fx. dep. `moduleTarget` - append the element the module built, then hand it back
+    // attached. `init` ran on a detached node, so this is the first point a module can
+    // measure its own box or reach an ancestor.
     useEffect(() => {
         if (moduleTarget === null)
             return;
         if (rootRef.current === null)
             return;
         rootRef.current.appendChild(moduleTarget);
+        liveInstanceRef.current?.module.postInit?.(moduleTarget, propsRef.current ?? {});
     }, [moduleTarget]);
+    // Fx. dep. `props` - hand a props change to a module that is already live. Compared
+    // by reference: the component knows nothing of the values, so it leaves the call to
+    // the consumer's reference discipline and the module's own reading of what changed.
+    useEffect(() => {
+        const liveInstance = liveInstanceRef.current;
+        if (liveInstance === null)
+            return;
+        liveInstance.module.update?.(liveInstance.target, props ?? {});
+    }, [props]);
     // Rendering
     const c = clss(publicClassName, { cssModule });
     const hasErrored = loadedModule instanceof Error;

package/components/index.d.ts

@@ -1,6 +1,6 @@
+export * as beforeAfter from './BeforeAfter/index.js'
 export * as button from './Button/index.js'
 export * as clippable from './Clippable/index.js'
-export * as beforeAfter from './BeforeAfter/index.js'
 export * as disclaimer from './Disclaimer/index.js'
 export * as drawer from './Drawer/index.js'
 export * as eventListener from './EventListener/index.js'
@@ -9,21 +9,21 @@ export * as iframe from './Iframe/index.js'
 export * as image from './Image/index.js'
 export * as input from './Input/index.js'
 export * as intersectionObserver from './IntersectionObserver/index.js'
-export * as lightbox from './Lightbox/index.js'
 export * as jsonEditor from './JsonEditor/index.js'
+export * as lightbox from './Lightbox/index.js'
 export * as listLoader from './ListLoader/index.js'
 export * as overlayer from './Overlayer/index.js'
+export * as paginator from './Paginator/index.js'
+export * as resizeObserver from './ResizeObserver/index.js'
 export * as scrllgngn from './Scrllgngn/index.js'
 export * as scrollListener from './ScrollListener/index.js'
-export * as resizeObserver from './ResizeObserver/index.js'
-export * as paginator from './Paginator/index.js'
 export * as select from './Select/index.js'
 export * as sequencer from './Sequencer/index.js'
-export * as shadowRoot from './ShadowRoot/index.js'
 export * as subtitles from './Subtitles/index.js'
+export * as shadowRoot from './ShadowRoot/index.js'
+export * as textarea from './Textarea/index.js'
 export * as uiModule from './UIModule/index.js'
 export * as video from './Video/index.js'
-export * as textarea from './Textarea/index.js'
 export * as wipAudioQuote from './_WIP_AudioQuote/index.js'
 export * as wipIcon from './_WIP_Icon/index.js'
 export * as utils from './utils/index.js'

package/components/index.js

@@ -1,6 +1,6 @@
+export * as beforeAfter from './BeforeAfter/index.js'
 export * as button from './Button/index.js'
 export * as clippable from './Clippable/index.js'
-export * as beforeAfter from './BeforeAfter/index.js'
 export * as disclaimer from './Disclaimer/index.js'
 export * as drawer from './Drawer/index.js'
 export * as eventListener from './EventListener/index.js'
@@ -9,21 +9,21 @@ export * as iframe from './Iframe/index.js'
 export * as image from './Image/index.js'
 export * as input from './Input/index.js'
 export * as intersectionObserver from './IntersectionObserver/index.js'
-export * as lightbox from './Lightbox/index.js'
 export * as jsonEditor from './JsonEditor/index.js'
+export * as lightbox from './Lightbox/index.js'
 export * as listLoader from './ListLoader/index.js'
 export * as overlayer from './Overlayer/index.js'
+export * as paginator from './Paginator/index.js'
+export * as resizeObserver from './ResizeObserver/index.js'
 export * as scrllgngn from './Scrllgngn/index.js'
 export * as scrollListener from './ScrollListener/index.js'
-export * as resizeObserver from './ResizeObserver/index.js'
-export * as paginator from './Paginator/index.js'
 export * as select from './Select/index.js'
 export * as sequencer from './Sequencer/index.js'
-export * as shadowRoot from './ShadowRoot/index.js'
 export * as subtitles from './Subtitles/index.js'
+export * as shadowRoot from './ShadowRoot/index.js'
+export * as textarea from './Textarea/index.js'
 export * as uiModule from './UIModule/index.js'
 export * as video from './Video/index.js'
-export * as textarea from './Textarea/index.js'
 export * as wipAudioQuote from './_WIP_AudioQuote/index.js'
 export * as wipIcon from './_WIP_Icon/index.js'
 export * as utils from './utils/index.js'

package/node/@aws-s3/storage/directory/index.d.ts

@@ -1,4 +1,4 @@
+export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
 export * as moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
-export * as copyDir from './copy-dir/index.js'

package/node/@aws-s3/storage/directory/index.js

@@ -1,4 +1,4 @@
+export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
 export * as moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
-export * as copyDir from './copy-dir/index.js'

package/node/@aws-s3/storage/file/index.d.ts

@@ -1,7 +1,7 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
 export * as exists from './exists/index.js'
+export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'
-export * as move from './move/index.js'
 export * as upload from './upload/index.js'

package/node/@aws-s3/storage/file/index.js

@@ -1,7 +1,7 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
 export * as exists from './exists/index.js'
+export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'
-export * as move from './move/index.js'
 export * as upload from './upload/index.js'

package/node/@google-cloud/storage/directory/index.d.ts

@@ -1,4 +1,4 @@
-export * as list from './list/index.js'
 export * as copyDir from './copy-dir/index.js'
+export * as list from './list/index.js'
 export * as moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'

package/node/@google-cloud/storage/directory/index.js

@@ -1,4 +1,4 @@
-export * as list from './list/index.js'
 export * as copyDir from './copy-dir/index.js'
+export * as list from './list/index.js'
 export * as moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'

package/node/@google-cloud/storage/file/index.d.ts

@@ -1,11 +1,11 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
 export * as exists from './exists/index.js'
+export * as getMetadata from './get-metadata/index.js'
 export * as generateSignedUrl from './generate-signed-url/index.js'
 export * as getPermissions from './get-permissions/index.js'
-export * as getMetadata from './get-metadata/index.js'
-export * as remove from './remove/index.js'
 export * as move from './move/index.js'
+export * as remove from './remove/index.js'
 export * as revokeSignedUrls from './revoke-signed-urls/index.js'
 export * as stat from './stat/index.js'
 export * as updateMetadata from './update-metadata/index.js'

package/node/@google-cloud/storage/file/index.js

@@ -1,11 +1,11 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
 export * as exists from './exists/index.js'
+export * as getMetadata from './get-metadata/index.js'
 export * as generateSignedUrl from './generate-signed-url/index.js'
 export * as getPermissions from './get-permissions/index.js'
-export * as getMetadata from './get-metadata/index.js'
-export * as remove from './remove/index.js'
 export * as move from './move/index.js'
+export * as remove from './remove/index.js'
 export * as revokeSignedUrls from './revoke-signed-urls/index.js'
 export * as stat from './stat/index.js'
 export * as updateMetadata from './update-metadata/index.js'

package/node/cloud-storage/operations/index.d.ts

@@ -1,11 +1,11 @@
-export * as copyFile from './copy-file/index.js'
 export * as copyDir from './copy-dir/index.js'
+export * as copyFile from './copy-file/index.js'
 export * as downloadFile from './download-file/index.js'
 export * as existsFile from './exists-file/index.js'
 export * as listDir from './list-dir/index.js'
 export * as moveDir from './move-dir/index.js'
+export * as moveFile from './move-file/index.js'
 export * as removeDir from './remove-dir/index.js'
 export * as removeFile from './remove-file/index.js'
 export * as statFile from './stat-file/index.js'
 export * as uploadFile from './upload-file/index.js'
-export * as moveFile from './move-file/index.js'

package/node/cloud-storage/operations/index.js

@@ -1,11 +1,11 @@
-export * as copyFile from './copy-file/index.js'
 export * as copyDir from './copy-dir/index.js'
+export * as copyFile from './copy-file/index.js'
 export * as downloadFile from './download-file/index.js'
 export * as existsFile from './exists-file/index.js'
 export * as listDir from './list-dir/index.js'
 export * as moveDir from './move-dir/index.js'
+export * as moveFile from './move-file/index.js'
 export * as removeDir from './remove-dir/index.js'
 export * as removeFile from './remove-file/index.js'
 export * as statFile from './stat-file/index.js'
 export * as uploadFile from './upload-file/index.js'
-export * as moveFile from './move-file/index.js'

package/node/ftps/directory/index.d.ts

@@ -1,4 +1,4 @@
 export * as copyDir from './copy-dir/index.js'
-export * as moveDir from './move-dir/index.js'
 export * as list from './list/index.js'
+export * as moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'

package/node/ftps/directory/index.js

@@ -1,4 +1,4 @@
 export * as copyDir from './copy-dir/index.js'
-export * as moveDir from './move-dir/index.js'
 export * as list from './list/index.js'
+export * as moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'

package/node/ftps/file/index.d.ts

@@ -1,5 +1,5 @@
-export * as download from './download/index.js'
 export * as copy from './copy/index.js'
+export * as download from './download/index.js'
 export * as exists from './exists/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'

package/node/ftps/file/index.js

@@ -1,5 +1,5 @@
-export * as download from './download/index.js'
 export * as copy from './copy/index.js'
+export * as download from './download/index.js'
 export * as exists from './exists/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'

package/node/images/transform/operations/index.d.ts

@@ -1,15 +1,15 @@
-export * as extend from './extend/index.js'
 export * as blur from './blur/index.js'
+export * as brighten from './brighten/index.js'
+export * as extend from './extend/index.js'
 export * as extract from './extract/index.js'
 export * as flatten from './flatten/index.js'
 export * as flip from './flip/index.js'
 export * as flop from './flop/index.js'
 export * as hue from './hue/index.js'
-export * as brighten from './brighten/index.js'
+export * as level from './level/index.js'
 export * as lighten from './lighten/index.js'
 export * as normalize from './normalize/index.js'
-export * as level from './level/index.js'
-export * as resize from './resize/index.js'
 export * as overlay from './overlay/index.js'
+export * as resize from './resize/index.js'
 export * as rotate from './rotate/index.js'
 export * as saturate from './saturate/index.js'

package/node/images/transform/operations/index.js

@@ -1,15 +1,15 @@
-export * as extend from './extend/index.js'
 export * as blur from './blur/index.js'
+export * as brighten from './brighten/index.js'
+export * as extend from './extend/index.js'
 export * as extract from './extract/index.js'
 export * as flatten from './flatten/index.js'
 export * as flip from './flip/index.js'
 export * as flop from './flop/index.js'
 export * as hue from './hue/index.js'
-export * as brighten from './brighten/index.js'
+export * as level from './level/index.js'
 export * as lighten from './lighten/index.js'
 export * as normalize from './normalize/index.js'
-export * as level from './level/index.js'
-export * as resize from './resize/index.js'
 export * as overlay from './overlay/index.js'
+export * as resize from './resize/index.js'
 export * as rotate from './rotate/index.js'
 export * as saturate from './saturate/index.js'

package/node/index.d.ts

@@ -1,11 +1,11 @@
+export * as awsS3 from './@aws-s3/index.js'
 export * as designEdito from './@design-edito/index.js'
 export * as express from './@express/index.js'
 export * as googleCloud from './@google-cloud/index.js'
-export * as awsS3 from './@aws-s3/index.js'
 export * as cloudStorage from './cloud-storage/index.js'
 export * as encryption from './encryption/index.js'
+export * as files from './files/index.js'
 export * as ftps from './ftps/index.js'
 export * as images from './images/index.js'
 export * as process from './process/index.js'
 export * as sftp from './sftp/index.js'
-export * as files from './files/index.js'

package/node/index.js

@@ -1,11 +1,11 @@
+export * as awsS3 from './@aws-s3/index.js'
 export * as designEdito from './@design-edito/index.js'
 export * as express from './@express/index.js'
 export * as googleCloud from './@google-cloud/index.js'
-export * as awsS3 from './@aws-s3/index.js'
 export * as cloudStorage from './cloud-storage/index.js'
 export * as encryption from './encryption/index.js'
+export * as files from './files/index.js'
 export * as ftps from './ftps/index.js'
 export * as images from './images/index.js'
 export * as process from './process/index.js'
 export * as sftp from './sftp/index.js'
-export * as files from './files/index.js'

package/node/sftp/index.d.ts

@@ -1,2 +1,2 @@
-export * as file from './file/index.js'
 export * as directory from './directory/index.js'
+export * as file from './file/index.js'

package/node/sftp/index.js

@@ -1,2 +1,2 @@
-export * as file from './file/index.js'
 export * as directory from './directory/index.js'
+export * as file from './file/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design-edito/tools",
-  "version": "0.5.32",
+  "version": "0.5.34",
   "description": "",
   "author": "Maxime Fabas",
   "license": "ISC",