@design-edito/tools 0.5.5 → 0.5.6

package/agnostic/colors/index.d.ts

@@ -4,9 +4,9 @@ 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 luminance from './luminance/index.js'
+export * as lerp from './lerp/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 rotate from './rotate/index.js'
 export * as typechecks from './typechecks/index.js'

package/agnostic/colors/index.js

@@ -4,9 +4,9 @@ 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 luminance from './luminance/index.js'
+export * as lerp from './lerp/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 rotate from './rotate/index.js'
 export * as typechecks from './typechecks/index.js'

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

@@ -2,9 +2,9 @@ export * as add from './add/index.js'
 export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
 export * as append from './append/index.js'
+export * as clone from './clone/index.js'
 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 equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
@@ -12,22 +12,22 @@ export * as getproperties from './getproperties/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 if from './if/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 length from './length/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 or from './or/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 removeclass from './removeclass/index.js'
+export * as push from './push/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
 export * as select from './select/index.js'
@@ -48,5 +48,5 @@ 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 transformselected from './transformselected/index.js'

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

@@ -2,9 +2,9 @@ export * as add from './add/index.js'
 export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
 export * as append from './append/index.js'
+export * as clone from './clone/index.js'
 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 equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
@@ -12,22 +12,22 @@ export * as getproperties from './getproperties/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 if from './if/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 length from './length/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 or from './or/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 removeclass from './removeclass/index.js'
+export * as push from './push/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
 export * as select from './select/index.js'
@@ -48,5 +48,5 @@ 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 transformselected from './transformselected/index.js'

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

@@ -1,11 +1,11 @@
 export * as any from './any/index.js'
-export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
+export * as array from './array/index.js'
 export * as element from './element/index.js'
 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 nodelist from './nodelist/index.js'
 export * as number from './number/index.js'
 export * as record from './record/index.js'
 export * as ref from './ref/index.js'

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

@@ -1,11 +1,11 @@
 export * as any from './any/index.js'
-export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
+export * as array from './array/index.js'
 export * as element from './element/index.js'
 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 nodelist from './nodelist/index.js'
 export * as number from './number/index.js'
 export * as record from './record/index.js'
 export * as ref from './ref/index.js'

package/agnostic/html/index.d.ts

@@ -6,5 +6,5 @@ export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/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 stringToNodes from './string-to-nodes/index.js'

package/agnostic/html/index.js

@@ -6,5 +6,5 @@ export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/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 stringToNodes from './string-to-nodes/index.js'

package/agnostic/misc/index.d.ts

@@ -1,11 +1,11 @@
 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 cast from './cast/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'

package/agnostic/misc/index.js

@@ -1,11 +1,11 @@
 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 cast from './cast/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/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 clamp from './clamp/index.js'
+export * as approximateRational from './approximate-rational/index.js'
 export * as geometricProgressions from './geometric-progressions/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 approximateRational from './approximate-rational/index.js'
 export * as clamp from './clamp/index.js'
+export * as approximateRational from './approximate-rational/index.js'
 export * as geometricProgressions from './geometric-progressions/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 isObject from './is-object/index.js'
 export * as recordFormat from './record-format/index.js'
 export * as recordMap from './record-map/index.js'
 export * as sortKeys from './sort-keys/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 isObject from './is-object/index.js'
 export * as recordFormat from './record-format/index.js'
 export * as recordMap from './record-map/index.js'
 export * as sortKeys from './sort-keys/index.js'

package/agnostic/strings/index.d.ts

@@ -2,7 +2,7 @@ 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 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'
+export * as replaceAll from './replace-all/index.js'

package/agnostic/strings/index.js

@@ -2,7 +2,7 @@ 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 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'
+export * as replaceAll from './replace-all/index.js'

package/components/Paginator/index.d.ts

@@ -32,6 +32,10 @@ type DirectionState = 'forwards' | 'backwards' | null;
  * trigger it again.
  * @property onPagesChanged - Called after any page's {@link PageState} changed,
  * with a flat array of every page's state, ordered by position.
+ * @property onPageElementsChanged - Called with the page slot elements, in order,
+ * whenever the observed set changes. Unlike the other handlers it *does* fire on
+ * mount: the elements don't exist before it, so their appearance is the change.
+ * Lets a parent measure the pages without reaching into this component's DOM.
  * @property className - Optional additional class name(s) applied to the root element.
  * @property children - Each direct child is treated as an individual page slot.
  */
@@ -39,6 +43,7 @@ export type Props = PropsWithChildren<WithClassName<{
     thresholdOffsetPercent?: number;
     onDirectionChanged?: (direction: DirectionState) => void;
     onPagesChanged?: (pages: PageState[]) => void;
+    onPageElementsChanged?: (pageElements: HTMLElement[]) => void;
 }>>;
 /**
  * A scroll-driven pagination component that tracks which child page is currently

package/components/Paginator/index.js

@@ -27,7 +27,7 @@ import cssModule from './styles.module.css';
  * - `currCount` on each {@link PageState} increments each time a page transitions
  *   into the `'curr'` position, making it useful as a re-entry counter.
  */
-export const Paginator = ({ thresholdOffsetPercent, onDirectionChanged, onPagesChanged, className, children }) => {
+export const Paginator = ({ thresholdOffsetPercent, onDirectionChanged, onPagesChanged, onPageElementsChanged, className, children }) => {
     // State, refs, effects
     const [pagesState, setPagesState] = useState(new Map());
     const [directionState, setDirectionState] = useState(null);
@@ -67,6 +67,7 @@ export const Paginator = ({ thresholdOffsetPercent, onDirectionChanged, onPagesC
         if (pagesRef.current === null)
             return;
         const pages = Array.from(pagesRef.current.children);
+        onPageElementsChanged?.(pages.filter(page => page instanceof HTMLElement));
         const observerRootMargin = `-${thresholdOffsetPercent ?? 0}%`
             + ' 0px'
             + ` -${100 - (thresholdOffsetPercent ?? 0)}%`

package/components/Scrllgngn/index.d.ts

@@ -1,17 +1,20 @@
 import { type PropsWithChildren, type FunctionComponent } from 'react';
 import type { WithClassName } from '../utils/types.js';
+import { type TrackedBlockContext } from './utils.js';
 /**
  * Common properties shared by all block types.
  *
  * @property id - Optional stable identifier for the block. Used to consolidate
  * blocks with the same id across multiple pages into a single sticky block
  * displayed across those pages.
- * @property trackScroll - Whether scroll tracking is enabled for this block.
+ * @property onScrolled - Called with this block's {@link TrackedBlockContext} on
+ * every frame the scroll moved it, while it is displayed. Declaring it is what
+ * turns tracking on for the block — nothing is measured for a block without it.
  * @property children - Content rendered inside the block.
  */
 export type PropsCommonBlock = PropsWithChildren<{
     id?: string;
-    trackScroll?: boolean;
+    onScrolled?: (context: TrackedBlockContext) => void;
 }>;
 /**
  * A block that scrolls with the page content.
@@ -129,10 +132,37 @@ export type Props = WithClassName<{
  * - An inline `z-index` derived from the block's position in the sorted stack
  * (overridden by {@link PropsStickyBlock.zIndex} if provided).
  *
+ * ### Scroll block elements
+ * Each scroll block sits in its own wrapper, whatever it does — a block that isn't
+ * tracked still gets one, so the DOM keeps the same shape either way.
+ *
+ * ### Tracked block elements
+ * A block declaring {@link PropsCommonBlock.onScrolled} also carries its
+ * {@link TrackedBlockContext} on its wrapper, for scrollytelling driven in CSS
+ * alone. Written straight to the element on the frames they change, so they never
+ * re-render the sequence.
+ *
+ * Progressions, as unitless `0`–`1` ratios:
+ * - `--lm-scrllgngn-block-current-page-progression-ratio`
+ * - `--lm-scrllgngn-block-display-zone-progression-ratio`
+ * - `--lm-scrllgngn-block-contiguous-display-zone-progression-ratio`
+ *
+ * Position, which only moves with the page:
+ * - `data-current-page`
+ * - `data-display-zone` — comma-separated page positions.
+ * - `data-index-of-current-page-in-display-zone`
+ * - `data-contiguous-display-zone`
+ * - `data-index-of-current-page-in-contiguous-display-zone`
+ *
  * @param props - Component properties.
  * @see {@link Props}
  * @returns A div wrapping the full scrollytelling structure: top-bound sentinel,
  * back-blocks layer, front-blocks layer, paginated scrolling content, and
  * bottom-bound sentinel.
+ *
+ * @remarks
+ * Tracking costs nothing until a block asks for it: with no `onScrolled` anywhere,
+ * the component never joins the shared scroll listener. Once it does, each frame
+ * measures only the pages the displayed tracked blocks span, not the whole sequence.
  */
 export declare const Scrllgngn: FunctionComponent<Props>;

package/components/Scrllgngn/index.js

@@ -1,12 +1,14 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState, useEffect } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 import { clss } from '../../agnostic/css/clss/index.js';
+import { randomHash } from '../../agnostic/random/uuid/index.js';
 import { IntersectionObserverComponent } from '../IntersectionObserver/index.js';
 import { Paginator } from '../Paginator/index.js';
 import { ResizeObserverComponent } from '../ResizeObserver/index.js';
+import { subscribe, unsubscribe } from '../ScrollListener/utils.js';
 import { mergeClassNames, useChangeDispatch } from '../utils/index.js';
 import { scrllgngn as publicClassName } from '../public-classnames.js';
-import { consolidateStickyBlocks, lazyLoadedBlocks, toScreenCssProps } from './utils.js';
+import { blockDisplayZones, consolidateStickyBlocks, contextsAreEqual, lazyLoadedBlocks, measurePages, sameDiscretePart, scrollBlocksOf, scrollKey, stickyKey, toScreenCssProps, toTrackedBlockContext, toTrackedBlockCssProps, toTrackedBlockDataAttributes } from './utils.js';
 import cssModule from './styles.module.css';
 /**
  * Scrollytelling engine component. Orchestrates layered sticky blocks (`back`
@@ -50,11 +52,38 @@ import cssModule from './styles.module.css';
  * - An inline `z-index` derived from the block's position in the sorted stack
  * (overridden by {@link PropsStickyBlock.zIndex} if provided).
  *
+ * ### Scroll block elements
+ * Each scroll block sits in its own wrapper, whatever it does — a block that isn't
+ * tracked still gets one, so the DOM keeps the same shape either way.
+ *
+ * ### Tracked block elements
+ * A block declaring {@link PropsCommonBlock.onScrolled} also carries its
+ * {@link TrackedBlockContext} on its wrapper, for scrollytelling driven in CSS
+ * alone. Written straight to the element on the frames they change, so they never
+ * re-render the sequence.
+ *
+ * Progressions, as unitless `0`–`1` ratios:
+ * - `--lm-scrllgngn-block-current-page-progression-ratio`
+ * - `--lm-scrllgngn-block-display-zone-progression-ratio`
+ * - `--lm-scrllgngn-block-contiguous-display-zone-progression-ratio`
+ *
+ * Position, which only moves with the page:
+ * - `data-current-page`
+ * - `data-display-zone` — comma-separated page positions.
+ * - `data-index-of-current-page-in-display-zone`
+ * - `data-contiguous-display-zone`
+ * - `data-index-of-current-page-in-contiguous-display-zone`
+ *
  * @param props - Component properties.
  * @see {@link Props}
  * @returns A div wrapping the full scrollytelling structure: top-bound sentinel,
  * back-blocks layer, front-blocks layer, paginated scrolling content, and
  * bottom-bound sentinel.
+ *
+ * @remarks
+ * Tracking costs nothing until a block asks for it: with no `onScrolled` anywhere,
+ * the component never joins the shared scroll listener. Once it does, each frame
+ * measures only the pages the displayed tracked blocks span, not the whole sequence.
  */
 export const Scrllgngn = ({ pages, thresholdOffsetPercent, stickyBlocksLazyLoadDistance = 2, forceStickBlocks, onPageChanged, onContentVisibilityChanged, className }) => {
     // State
@@ -64,12 +93,122 @@ export const Scrllgngn = ({ pages, thresholdOffsetPercent, stickyBlocksLazyLoadD
     const [currentPagePos, setCurrentPagePos] = useState(0);
     const [stickyBlocks, setStickyBlocks] = useState(new Map());
     const [partialBoundingRect, setPartialBoundingRect] = useState();
+    // Scroll tracking. Everything the per-frame pass reads lives in a ref: it is
+    // registered once with the shared scroll listener, and writes straight to the DOM
+    // rather than through state, which would re-render the whole sequence per frame.
+    const rootRef = useRef(null);
+    const subscriptionIdRef = useRef(randomHash(8));
+    const pageElementsRef = useRef([]);
+    const trackedBlocksRef = useRef(new Map());
+    const trackedWrappersRef = useRef(new Map());
+    const lastContextsRef = useRef(new Map());
+    const currentPagePosRef = useRef(currentPagePos);
     // Sticky blocks calculations
     useEffect(() => {
         setStickyBlocks(consolidateStickyBlocks(pages));
     }, [pages]);
     const lazyLoadedBackBlocks = lazyLoadedBlocks(stickyBlocks, 'back', currentPagePos, stickyBlocksLazyLoadDistance);
     const lazyLoadedFrontBlocks = lazyLoadedBlocks(stickyBlocks, 'front', currentPagePos, stickyBlocksLazyLoadDistance);
+    // Tracked blocks, keyed the same way their wrappers are
+    const displayZones = blockDisplayZones(pages);
+    const trackedBlocks = new Map();
+    for (const [blockId, block] of stickyBlocks) {
+        if (block.onScrolled === undefined)
+            continue;
+        trackedBlocks.set(stickyKey(blockId), {
+            displayZone: block.id === undefined
+                ? block.displayOnPages
+                : displayZones.get(block.id) ?? block.displayOnPages,
+            onScrolled: block.onScrolled
+        });
+    }
+    pages?.forEach((page, pagePos) => {
+        scrollBlocksOf(page).forEach((block, blockPos) => {
+            if (block.onScrolled === undefined)
+                return;
+            trackedBlocks.set(scrollKey(pagePos, blockPos), {
+                displayZone: block.id === undefined
+                    ? [pagePos]
+                    : displayZones.get(block.id) ?? [pagePos],
+                onScrolled: block.onScrolled
+            });
+        });
+    });
+    const hasTrackedBlocks = trackedBlocks.size > 0;
+    // Fx. no dep. - Keep what the per-frame pass reads in sync with the last render
+    useEffect(() => {
+        trackedBlocksRef.current = trackedBlocks;
+        currentPagePosRef.current = currentPagePos;
+    });
+    // The per-frame pass: measure only the pages the displayed tracked blocks span,
+    // then hand each block its context — once, and only when something moved.
+    const handleScrolled = useCallback(() => {
+        const trackedBlocks = trackedBlocksRef.current;
+        const lastContexts = lastContextsRef.current;
+        const currentPage = currentPagePosRef.current;
+        const pending = [];
+        for (const [key, block] of trackedBlocks) {
+            if (block.displayZone.includes(currentPage))
+                pending.push([key, block, currentPage]);
+        }
+        // A block that just left the current page gets one last pass, on the page it was
+        // on: its progressions are clamped, so it lands on the edge it crossed instead of
+        // freezing part-way.
+        for (const [key, lastContext] of lastContexts) {
+            const block = trackedBlocks.get(key);
+            if (block === undefined) {
+                lastContexts.delete(key);
+                continue;
+            }
+            if (block.displayZone.includes(currentPage))
+                continue;
+            pending.push([key, block, lastContext.currentPage]);
+        }
+        if (pending.length === 0)
+            return;
+        const pagesToMeasure = new Set();
+        for (const [, block, page] of pending) {
+            pagesToMeasure.add(page);
+            for (const pagePos of block.displayZone)
+                pagesToMeasure.add(pagePos);
+        }
+        const metrics = measurePages(pageElementsRef.current, pagesToMeasure, thresholdOffsetPercent);
+        for (const [key, block, page] of pending) {
+            const context = toTrackedBlockContext(block.displayZone, page, metrics);
+            const lastContext = lastContexts.get(key);
+            if (contextsAreEqual(context, lastContext))
+                continue;
+            const wrapper = trackedWrappersRef.current.get(key);
+            if (wrapper !== undefined) {
+                for (const [name, value] of Object.entries(toTrackedBlockCssProps(context))) {
+                    wrapper.style.setProperty(name, value);
+                }
+                // Discrete values only move with the page, so they don't need a write per frame
+                if (!sameDiscretePart(context, lastContext)) {
+                    for (const [name, value] of Object.entries(toTrackedBlockDataAttributes(context))) {
+                        wrapper.setAttribute(name, value);
+                    }
+                }
+            }
+            block.onScrolled(context);
+            if (page === currentPage)
+                lastContexts.set(key, context);
+            else
+                lastContexts.delete(key);
+        }
+    }, [thresholdOffsetPercent]);
+    // Fx. dep. hasTrackedBlocks, handleScrolled - Join the shared scroll listener, and
+    // only then: no tracked block, no measurement pass at all.
+    useEffect(() => {
+        if (!hasTrackedBlocks)
+            return;
+        const subscriptionId = subscriptionIdRef.current;
+        subscribe(subscriptionId, {
+            rootRef,
+            onScrollStateChange: handleScrolled
+        });
+        return () => unsubscribe(subscriptionId);
+    }, [hasTrackedBlocks, handleScrolled]);
     // Handlers
     useChangeDispatch(currentPagePos, pagePos => onPageChanged?.(pagePos, pages?.[pagePos]));
     useChangeDispatch(contentVisible, onContentVisibilityChanged);
@@ -82,6 +221,17 @@ export const Scrllgngn = ({ pages, thresholdOffsetPercent, stickyBlocksLazyLoadD
             return;
         setCurrentPagePos(curPagePos);
     };
+    const handlePageElementsChanged = elements => {
+        pageElementsRef.current = elements;
+    };
+    // Registers a block wrapper under the key its context is tracked by. Blocks come
+    // and go with lazy loading, so the map is kept clean on unmount rather than grown.
+    const registerWrapper = (key) => (element) => {
+        if (element === null)
+            trackedWrappersRef.current.delete(key);
+        else
+            trackedWrappersRef.current.set(key, element);
+    };
     const handleResize = ({ boundingClientRect }) => {
         if (partialBoundingRect === undefined
             || boundingClientRect.left !== partialBoundingRect.left
@@ -101,24 +251,21 @@ export const Scrllgngn = ({ pages, thresholdOffsetPercent, stickyBlocksLazyLoadD
         'force-stick-blocks-both': forceStickBlocks === 'both'
     }), className);
     const customCssProps = toScreenCssProps(partialBoundingRect);
-    return _jsx("div", { className: rootClss, "data-current-page-pos": currentPagePos, "data-current-page-id": pages?.[currentPagePos]?.id, style: { ...customCssProps }, children: _jsxs(ResizeObserverComponent, { onResized: handleResize, children: [_jsx("div", { className: c('top-bound'), children: _jsx(IntersectionObserverComponent, { onIntersected: handleTopBoundDetect }) }), _jsx("div", { className: c('back-blocks'), children: lazyLoadedBackBlocks.map((block, blockPos) => {
+    return _jsx("div", { ref: rootRef, className: rootClss, "data-current-page-pos": currentPagePos, "data-current-page-id": pages?.[currentPagePos]?.id, style: { ...customCssProps }, children: _jsxs(ResizeObserverComponent, { onResized: handleResize, children: [_jsx("div", { className: c('top-bound'), children: _jsx(IntersectionObserverComponent, { onIntersected: handleTopBoundDetect }) }), _jsx("div", { className: c('back-blocks'), children: lazyLoadedBackBlocks.map(([blockId, block], blockPos) => {
                         const isActive = block.displayOnPages.includes(currentPagePos);
                         const blockClss = c('back-block', {
                             active: isActive,
                             'lazy-loaded': !isActive
                         });
-                        return _jsx("div", { className: blockClss, style: { zIndex: blockPos }, children: block.children });
-                    }) }), _jsx("div", { className: c('front-blocks'), children: lazyLoadedFrontBlocks.map((block, blockPos) => {
+                        return _jsx("div", { ref: registerWrapper(stickyKey(blockId)), className: blockClss, style: { zIndex: blockPos }, children: block.children }, blockId);
+                    }) }), _jsx("div", { className: c('front-blocks'), children: lazyLoadedFrontBlocks.map(([blockId, block], blockPos) => {
                         const isActive = block.displayOnPages.includes(currentPagePos);
                         const blockClss = c('front-block', {
                             active: isActive,
                             'lazy-loaded': !isActive
                         });
-                        return _jsx("div", { className: blockClss, style: { zIndex: blockPos }, children: block.children });
-                    }) }), _jsx("div", { className: c('scrolling-content'), children: _jsx(IntersectionObserverComponent, { onIntersected: handleCntDetect, children: _jsx(Paginator, { thresholdOffsetPercent: thresholdOffsetPercent, onPagesChanged: handlePagesChanged, children: pages?.map(page => {
-                                const scrollBlocks = page.blocks
-                                    ?.filter(b => b.depth === 'scroll' || b.depth === undefined) ?? [];
-                                // eslint-disable-next-line @typescript-eslint/promise-function-async
-                                return _jsx(_Fragment, { children: scrollBlocks.map(b => b.children) });
+                        return _jsx("div", { ref: registerWrapper(stickyKey(blockId)), className: blockClss, style: { zIndex: blockPos }, children: block.children }, blockId);
+                    }) }), _jsx("div", { className: c('scrolling-content'), children: _jsx(IntersectionObserverComponent, { onIntersected: handleCntDetect, children: _jsx(Paginator, { thresholdOffsetPercent: thresholdOffsetPercent, onPagesChanged: handlePagesChanged, onPageElementsChanged: handlePageElementsChanged, children: pages?.map((page, pagePos) => {
+                                return _jsx(_Fragment, { children: scrollBlocksOf(page).map((block, blockPos) => _jsx("div", { ref: registerWrapper(scrollKey(pagePos, blockPos)), className: c('scroll-block'), children: block.children }, blockPos)) });
                             }) }) }) }), _jsx("div", { className: c('bottom-bound'), children: _jsx(IntersectionObserverComponent, { onIntersected: handleBtmBoundDetect }) })] }) });
 };

package/components/Scrllgngn/utils.d.ts

@@ -1,4 +1,4 @@
-import type { PropsPage, PropsStickyBlock } from './index.js';
+import type { PropsBlock, PropsPage, PropsStickyBlock } from './index.js';
 /** The subset of a bounding rect a {@link Scrllgngn} tracks and exposes. */
 export type ScreenRect = {
     left: number;
@@ -33,9 +33,11 @@ export declare function consolidateStickyBlocks(pages?: PropsPage[]): Map<string
  * @param currentPagePos - Zero-based position of the page in view.
  * @param lazyLoadDistance - How many pages around the current one still mount
  * their blocks.
- * @returns The blocks to render, stacked by ascending `zIndex`.
+ * @returns The blocks to render with the id they were consolidated under, stacked
+ * by ascending `zIndex`. The id comes along because it is what identifies the block
+ * across renders — its own `id` is optional, a consolidation key never is.
  */
-export declare function lazyLoadedBlocks(blocks: Map<string, ConsolidatedStickyBlock>, depth: 'back' | 'front', currentPagePos: number, lazyLoadDistance: number): ConsolidatedStickyBlock[];
+export declare function lazyLoadedBlocks(blocks: Map<string, ConsolidatedStickyBlock>, depth: 'back' | 'front', currentPagePos: number, lazyLoadDistance: number): Array<[string, ConsolidatedStickyBlock]>;
 /**
  * Builds the CSS custom properties exposed on a {@link Scrllgngn} root.
  *
@@ -50,3 +52,136 @@ export declare function lazyLoadedBlocks(blocks: Map<string, ConsolidatedStickyB
  * @returns The custom properties, keyed by their full name.
  */
 export declare function toScreenCssProps(rect?: ScreenRect): Record<string, string>;
+/**
+ * Where one tracked block stands in the scroll, as handed to its `onScrolled`.
+ *
+ * Every progression is a `0`–`1` ratio measured against the threshold line, and
+ * weighted **by pixel height**: a zone of unequal pages is not the same as
+ * `(indexOfCurrentPage + currentPageProgression) / displayZone.length`.
+ *
+ * @property currentPage - Zero-based position of the page in view.
+ * @property currentPageProgression - `0` when the current page's top meets the
+ * threshold, `1` when its bottom does.
+ * @property displayZone - Every page the block's `id` appears on. A block without
+ * an `id` shows on one page, so its zone holds that page alone and its three
+ * progressions are equal.
+ * @property indexOfCurrentPageInDisplayZone - Where `currentPage` sits in
+ * `displayZone`.
+ * @property displayZoneProgression - Progression across the whole zone. On a zone
+ * like `[2, 3, 5]` it runs 0 → ~0.66 over pages 2–3, pauses while page 4 shows the
+ * block nowhere, then resumes to 1 on page 5.
+ * @property contiguousDisplayZone - The unbroken run of `displayZone` containing
+ * `currentPage` — `[2, 3]` for the zone above while on page 2 or 3.
+ * @property indexOfCurrentPageInContiguousDisplayZone - Where `currentPage` sits in
+ * `contiguousDisplayZone`.
+ * @property contiguousDisplayZoneProgression - Progression across that run alone,
+ * so it always spans a full 0 → 1.
+ */
+export type TrackedBlockContext = {
+    currentPage: number;
+    currentPageProgression: number;
+    displayZone: number[];
+    indexOfCurrentPageInDisplayZone: number;
+    displayZoneProgression: number;
+    contiguousDisplayZone: number[];
+    indexOfCurrentPageInContiguousDisplayZone: number;
+    contiguousDisplayZoneProgression: number;
+};
+/** How far the threshold line has travelled through one page, in pixels. */
+export type PageScrollMetrics = {
+    scrolled: number;
+    height: number;
+};
+/**
+ * Lists the pages each block id shows on.
+ *
+ * @param pages - The pages to walk, in order.
+ * @returns Zero-based page positions per id, ordered. Blocks without an `id` are
+ * left out: they show on their own page and nowhere else.
+ */
+export declare function blockDisplayZones(pages?: PropsPage[]): Map<string, number[]>;
+/**
+ * Isolates the unbroken run of pages around one page.
+ *
+ * @param zone - The pages a block shows on, in any order.
+ * @param page - The page the run must contain.
+ * @returns The run holding `page`, ascending, or an empty array when `zone` misses
+ * it entirely.
+ */
+export declare function contiguousRunContaining(zone: number[], page: number): number[];
+/**
+ * Measures how far the threshold line has travelled through each of the pages
+ * asked for.
+ *
+ * Only those pages are measured, not all of them: a long sequence would otherwise
+ * pay for a forced layout per page on every frame, where the tracked blocks rarely
+ * span more than a handful.
+ *
+ * @param pageElements - Every page slot, indexed by position.
+ * @param pagePositions - The positions worth measuring.
+ * @param thresholdOffsetPercent - The same offset the internal `Paginator` uses,
+ * as a percentage of the viewport height.
+ * @returns The metrics of each measurable page, keyed by position.
+ */
+export declare function measurePages(pageElements: HTMLElement[], pagePositions: Iterable<number>, thresholdOffsetPercent?: number): Map<number, PageScrollMetrics>;
+/**
+ * Assembles what one tracked block is told about the scroll.
+ *
+ * @param displayZone - The pages the block shows on.
+ * @param currentPage - Zero-based position of the page in view.
+ * @param metrics - Measurements covering at least `displayZone`.
+ * @returns The context to hand to `onScrolled`.
+ */
+export declare function toTrackedBlockContext(displayZone: number[], currentPage: number, metrics: Map<number, PageScrollMetrics>): TrackedBlockContext;
+/** Whether two contexts hold the same discrete fields, ignoring the progressions. */
+export declare function sameDiscretePart(a: TrackedBlockContext, b?: TrackedBlockContext): boolean;
+/** Whether two contexts are equal down to the progressions. */
+export declare function contextsAreEqual(a: TrackedBlockContext, b?: TrackedBlockContext): boolean;
+/**
+ * Builds the CSS custom properties carrying a tracked block's progressions.
+ *
+ * Only the continuous fields land here — the discrete ones are `data-` attributes,
+ * written by {@link toTrackedBlockDataAttributes}.
+ *
+ * @param context - The block's current context.
+ * @returns The custom properties, keyed by their full name.
+ */
+export declare function toTrackedBlockCssProps(context: TrackedBlockContext): Record<string, string>;
+/**
+ * Builds the `data-` attributes carrying a tracked block's discrete position.
+ *
+ * @param context - The block's current context.
+ * @returns The attributes, keyed by their full name.
+ */
+export declare function toTrackedBlockDataAttributes(context: TrackedBlockContext): Record<string, string>;
+/** What the per-frame pass needs to know about one tracked block. */
+export type TrackedBlock = {
+    displayZone: number[];
+    onScrolled: (context: TrackedBlockContext) => void;
+};
+/**
+ * Keys a tracked sticky block.
+ *
+ * Sticky and scroll blocks share one map of wrappers, and a sticky block is one
+ * element for the whole sequence where a scroll block is one per page — hence two
+ * key shapes rather than a single ambiguous one.
+ *
+ * @param blockId - The id the block was consolidated under.
+ * @returns The key its wrapper is registered as.
+ */
+export declare function stickyKey(blockId: string): string;
+/**
+ * Keys a tracked scroll block.
+ *
+ * @param pagePos - Zero-based position of the page it belongs to.
+ * @param blockPos - Its position among that page's scroll blocks.
+ * @returns The key its wrapper is registered as.
+ */
+export declare function scrollKey(pagePos: number, blockPos: number): string;
+/**
+ * Picks the blocks of a page that scroll with the content.
+ *
+ * @param page - The page to read.
+ * @returns Its scroll blocks, in order. `depth` left out means `'scroll'`.
+ */
+export declare function scrollBlocksOf(page: PropsPage): PropsBlock[];

package/components/Scrllgngn/utils.js

@@ -1,3 +1,4 @@
+import { clamp } from '../../agnostic/numbers/clamp/index.js';
 import { randomHash } from '../../agnostic/random/uuid/index.js';
 /**
  * Merges the sticky blocks of every page into a single entry per block id.
@@ -50,18 +51,19 @@ export function consolidateStickyBlocks(pages) {
  * @param currentPagePos - Zero-based position of the page in view.
  * @param lazyLoadDistance - How many pages around the current one still mount
  * their blocks.
- * @returns The blocks to render, stacked by ascending `zIndex`.
+ * @returns The blocks to render with the id they were consolidated under, stacked
+ * by ascending `zIndex`. The id comes along because it is what identifies the block
+ * across renders — its own `id` is optional, a consolidation key never is.
  */
 export function lazyLoadedBlocks(blocks, depth, currentPagePos, lazyLoadDistance) {
     return Array
         .from(blocks)
-        .map(([, block]) => block)
-        .filter(block => block.depth === depth
+        .filter(([, block]) => block.depth === depth
         && block.displayOnPages.some(dispPage => {
             const absDiff = Math.abs(dispPage - currentPagePos);
             return absDiff <= lazyLoadDistance;
         }))
-        .sort((a, b) => (a.zIndex ?? -Infinity) - (b.zIndex ?? -Infinity));
+        .sort(([, a], [, b]) => (a.zIndex ?? -Infinity) - (b.zIndex ?? -Infinity));
 }
 /**
  * Builds the CSS custom properties exposed on a {@link Scrllgngn} root.
@@ -100,3 +102,194 @@ export function toScreenCssProps(rect) {
 function toPrivateLength(value) {
     return value === undefined ? 'initial' : `${value}px`;
 }
+/**
+ * Lists the pages each block id shows on.
+ *
+ * @param pages - The pages to walk, in order.
+ * @returns Zero-based page positions per id, ordered. Blocks without an `id` are
+ * left out: they show on their own page and nowhere else.
+ */
+export function blockDisplayZones(pages) {
+    const zones = new Map();
+    (pages ?? []).forEach((page, pagePos) => {
+        for (const block of page.blocks ?? []) {
+            if (block.id === undefined)
+                continue;
+            const zone = zones.get(block.id) ?? [];
+            if (!zone.includes(pagePos))
+                zone.push(pagePos);
+            zones.set(block.id, zone);
+        }
+    });
+    return zones;
+}
+/**
+ * Isolates the unbroken run of pages around one page.
+ *
+ * @param zone - The pages a block shows on, in any order.
+ * @param page - The page the run must contain.
+ * @returns The run holding `page`, ascending, or an empty array when `zone` misses
+ * it entirely.
+ */
+export function contiguousRunContaining(zone, page) {
+    const ascending = [...zone].sort((a, b) => a - b);
+    let run = [];
+    for (const pagePos of ascending) {
+        const previous = run[run.length - 1];
+        if (previous !== undefined && pagePos !== previous + 1) {
+            if (run.includes(page))
+                return run;
+            run = [];
+        }
+        run.push(pagePos);
+    }
+    return run.includes(page) ? run : [];
+}
+/**
+ * Measures how far the threshold line has travelled through each of the pages
+ * asked for.
+ *
+ * Only those pages are measured, not all of them: a long sequence would otherwise
+ * pay for a forced layout per page on every frame, where the tracked blocks rarely
+ * span more than a handful.
+ *
+ * @param pageElements - Every page slot, indexed by position.
+ * @param pagePositions - The positions worth measuring.
+ * @param thresholdOffsetPercent - The same offset the internal `Paginator` uses,
+ * as a percentage of the viewport height.
+ * @returns The metrics of each measurable page, keyed by position.
+ */
+export function measurePages(pageElements, pagePositions, thresholdOffsetPercent) {
+    const thresholdY = window.innerHeight * (thresholdOffsetPercent ?? 0) / 100;
+    const measured = new Map();
+    for (const pagePos of pagePositions) {
+        const element = pageElements[pagePos];
+        if (element === undefined)
+            continue;
+        const { top, height } = element.getBoundingClientRect();
+        measured.set(pagePos, {
+            scrolled: clamp(thresholdY - top, 0, height),
+            height
+        });
+    }
+    return measured;
+}
+/** Pixel-weighted progression across a set of pages, `0` when none is measured. */
+function zoneProgression(zone, metrics) {
+    let scrolled = 0;
+    let height = 0;
+    for (const pagePos of zone) {
+        const pageMetrics = metrics.get(pagePos);
+        if (pageMetrics === undefined)
+            continue;
+        scrolled += pageMetrics.scrolled;
+        height += pageMetrics.height;
+    }
+    return height === 0 ? 0 : scrolled / height;
+}
+/**
+ * Assembles what one tracked block is told about the scroll.
+ *
+ * @param displayZone - The pages the block shows on.
+ * @param currentPage - Zero-based position of the page in view.
+ * @param metrics - Measurements covering at least `displayZone`.
+ * @returns The context to hand to `onScrolled`.
+ */
+export function toTrackedBlockContext(displayZone, currentPage, metrics) {
+    const contiguousDisplayZone = contiguousRunContaining(displayZone, currentPage);
+    return {
+        currentPage,
+        currentPageProgression: zoneProgression([currentPage], metrics),
+        displayZone,
+        indexOfCurrentPageInDisplayZone: displayZone.indexOf(currentPage),
+        displayZoneProgression: zoneProgression(displayZone, metrics),
+        contiguousDisplayZone,
+        indexOfCurrentPageInContiguousDisplayZone: contiguousDisplayZone.indexOf(currentPage),
+        contiguousDisplayZoneProgression: zoneProgression(contiguousDisplayZone, metrics)
+    };
+}
+/** The fields that only move when the page does, so they can be written sparingly. */
+function discretePart(context) {
+    return [
+        context.currentPage,
+        context.indexOfCurrentPageInDisplayZone,
+        context.indexOfCurrentPageInContiguousDisplayZone,
+        context.displayZone.join(','),
+        context.contiguousDisplayZone.join(',')
+    ].join('|');
+}
+/** Whether two contexts hold the same discrete fields, ignoring the progressions. */
+export function sameDiscretePart(a, b) {
+    return b !== undefined && discretePart(a) === discretePart(b);
+}
+/** Whether two contexts are equal down to the progressions. */
+export function contextsAreEqual(a, b) {
+    return sameDiscretePart(a, b)
+        && b !== undefined
+        && a.currentPageProgression === b.currentPageProgression
+        && a.displayZoneProgression === b.displayZoneProgression
+        && a.contiguousDisplayZoneProgression === b.contiguousDisplayZoneProgression;
+}
+/**
+ * Builds the CSS custom properties carrying a tracked block's progressions.
+ *
+ * Only the continuous fields land here — the discrete ones are `data-` attributes,
+ * written by {@link toTrackedBlockDataAttributes}.
+ *
+ * @param context - The block's current context.
+ * @returns The custom properties, keyed by their full name.
+ */
+export function toTrackedBlockCssProps(context) {
+    return {
+        '--lm-scrllgngn-block-current-page-progression-ratio': `${context.currentPageProgression}`,
+        '--lm-scrllgngn-block-display-zone-progression-ratio': `${context.displayZoneProgression}`,
+        '--lm-scrllgngn-block-contiguous-display-zone-progression-ratio': `${context.contiguousDisplayZoneProgression}`
+    };
+}
+/**
+ * Builds the `data-` attributes carrying a tracked block's discrete position.
+ *
+ * @param context - The block's current context.
+ * @returns The attributes, keyed by their full name.
+ */
+export function toTrackedBlockDataAttributes(context) {
+    return {
+        'data-current-page': `${context.currentPage}`,
+        'data-display-zone': context.displayZone.join(','),
+        'data-index-of-current-page-in-display-zone': `${context.indexOfCurrentPageInDisplayZone}`,
+        'data-contiguous-display-zone': context.contiguousDisplayZone.join(','),
+        'data-index-of-current-page-in-contiguous-display-zone': `${context.indexOfCurrentPageInContiguousDisplayZone}`
+    };
+}
+/**
+ * Keys a tracked sticky block.
+ *
+ * Sticky and scroll blocks share one map of wrappers, and a sticky block is one
+ * element for the whole sequence where a scroll block is one per page — hence two
+ * key shapes rather than a single ambiguous one.
+ *
+ * @param blockId - The id the block was consolidated under.
+ * @returns The key its wrapper is registered as.
+ */
+export function stickyKey(blockId) {
+    return `sticky:${blockId}`;
+}
+/**
+ * Keys a tracked scroll block.
+ *
+ * @param pagePos - Zero-based position of the page it belongs to.
+ * @param blockPos - Its position among that page's scroll blocks.
+ * @returns The key its wrapper is registered as.
+ */
+export function scrollKey(pagePos, blockPos) {
+    return `scroll:${pagePos}:${blockPos}`;
+}
+/**
+ * Picks the blocks of a page that scroll with the content.
+ *
+ * @param page - The page to read.
+ * @returns Its scroll blocks, in order. `depth` left out means `'scroll'`.
+ */
+export function scrollBlocksOf(page) {
+    return page.blocks?.filter(block => block.depth === 'scroll' || block.depth === undefined) ?? [];
+}

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 copyDir from './copy-dir/index.js'
 export * as moveDir from './move-dir/index.js'
 export * as removeDir from './remove-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 copyDir from './copy-dir/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 download from './download/index.js'
 export * as generateSignedUrl from './generate-signed-url/index.js'
 export * as getMetadata from './get-metadata/index.js'
 export * as getPermissions from './get-permissions/index.js'
-export * as move from './move/index.js'
 export * as remove from './remove/index.js'
+export * as move from './move/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 download from './download/index.js'
 export * as generateSignedUrl from './generate-signed-url/index.js'
 export * as getMetadata from './get-metadata/index.js'
 export * as getPermissions from './get-permissions/index.js'
-export * as move from './move/index.js'
 export * as remove from './remove/index.js'
+export * as move from './move/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,7 +1,7 @@
 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 downloadFile from './download-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'

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

@@ -1,7 +1,7 @@
 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 downloadFile from './download-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'

package/node/images/index.d.ts

@@ -1,5 +1,5 @@
-export * as create from './create/index.js'
 export * as format from './format/index.js'
+export * as create from './create/index.js'
 export * as metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'

package/node/images/index.js

@@ -1,5 +1,5 @@
-export * as create from './create/index.js'
 export * as format from './format/index.js'
+export * as create from './create/index.js'
 export * as metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'

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

@@ -3,8 +3,8 @@ 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 flop from './flop/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 level from './level/index.js'
 export * as lighten from './lighten/index.js'

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

@@ -3,8 +3,8 @@ 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 flop from './flop/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 level from './level/index.js'
 export * as lighten from './lighten/index.js'

package/node/index.d.ts

@@ -1,6 +1,6 @@
 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 designEdito from './@design-edito/index.js'
 export * as googleCloud from './@google-cloud/index.js'
 export * as cloudStorage from './cloud-storage/index.js'
 export * as encryption from './encryption/index.js'

package/node/index.js

@@ -1,6 +1,6 @@
 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 designEdito from './@design-edito/index.js'
 export * as googleCloud from './@google-cloud/index.js'
 export * as cloudStorage from './cloud-storage/index.js'
 export * as encryption from './encryption/index.js'

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

@@ -1,5 +1,5 @@
-export * as copy from './copy/index.js'
 export * as download from './download/index.js'
+export * as copy from './copy/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/sftp/file/index.js

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

package/package.json

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