@design-edito/tools 0.5.16 → 0.5.18

package/agnostic/colors/index.d.ts

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

package/agnostic/colors/index.js

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

package/agnostic/css/index.d.ts

@@ -1,6 +1,6 @@
 export * as bem from './bem/index.js'
-export * as generateNiceColor from './generate-nice-color/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'

package/agnostic/css/index.js

@@ -1,6 +1,6 @@
 export * as bem from './bem/index.js'
-export * as generateNiceColor from './generate-nice-color/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'

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

@@ -1,52 +1,52 @@
+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 at from './at/index.js'
-export * as add from './add/index.js'
 export * as call from './call/index.js'
-export * as deleteproperties from './deleteproperties/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'
 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 initialize from './initialize/index.js'
 export * as if from './if/index.js'
 export * as join from './join/index.js'
+export * as initialize from './initialize/index.js'
 export * as length from './length/index.js'
 export * as map from './map/index.js'
 export * as negate from './negate/index.js'
-export * as or from './or/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 populate from './populate/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 removeclass from './removeclass/index.js'
-export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
+export * as renameproperty from './renameproperty/index.js'
 export * as select from './select/index.js'
-export * as setproperty from './setproperty/index.js'
-export * as setattribute from './setattribute/index.js'
 export * as set from './set/index.js'
+export * as setattribute from './setattribute/index.js'
+export * as setproperty from './setproperty/index.js'
 export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
 export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
+export * as 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 tonumber from './tonumber/index.js'
-export * as toboolean from './toboolean/index.js'
 export * as torecord from './torecord/index.js'
 export * as tostring from './tostring/index.js'
-export * as toref from './toref/index.js'
 export * as totext from './totext/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
+export * as toref from './toref/index.js'

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

@@ -1,52 +1,52 @@
+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 at from './at/index.js'
-export * as add from './add/index.js'
 export * as call from './call/index.js'
-export * as deleteproperties from './deleteproperties/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'
 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 initialize from './initialize/index.js'
 export * as if from './if/index.js'
 export * as join from './join/index.js'
+export * as initialize from './initialize/index.js'
 export * as length from './length/index.js'
 export * as map from './map/index.js'
 export * as negate from './negate/index.js'
-export * as or from './or/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 populate from './populate/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 removeclass from './removeclass/index.js'
-export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
+export * as renameproperty from './renameproperty/index.js'
 export * as select from './select/index.js'
-export * as setproperty from './setproperty/index.js'
-export * as setattribute from './setattribute/index.js'
 export * as set from './set/index.js'
+export * as setattribute from './setattribute/index.js'
+export * as setproperty from './setproperty/index.js'
 export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
 export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
+export * as 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 tonumber from './tonumber/index.js'
-export * as toboolean from './toboolean/index.js'
 export * as torecord from './torecord/index.js'
 export * as tostring from './tostring/index.js'
-export * as toref from './toref/index.js'
 export * as totext from './totext/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
+export * as toref from './toref/index.js'

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

@@ -1,13 +1,13 @@
-export * as array from './array/index.js'
 export * as any from './any/index.js'
+export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
-export * as get from './get/index.js'
 export * as element from './element/index.js'
-export * as guess from './guess/index.js'
+export * as get from './get/index.js'
 export * as nodelist from './nodelist/index.js'
-export * as record from './record/index.js'
 export * as null from './null/index.js'
-export * as ref from './ref/index.js'
+export * as number from './number/index.js'
+export * as guess from './guess/index.js'
+export * as record from './record/index.js'
 export * as string from './string/index.js'
 export * as text from './text/index.js'
-export * as number from './number/index.js'
+export * as ref from './ref/index.js'

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

@@ -1,13 +1,13 @@
-export * as array from './array/index.js'
 export * as any from './any/index.js'
+export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
-export * as get from './get/index.js'
 export * as element from './element/index.js'
-export * as guess from './guess/index.js'
+export * as get from './get/index.js'
 export * as nodelist from './nodelist/index.js'
-export * as record from './record/index.js'
 export * as null from './null/index.js'
-export * as ref from './ref/index.js'
+export * as number from './number/index.js'
+export * as guess from './guess/index.js'
+export * as record from './record/index.js'
 export * as string from './string/index.js'
 export * as text from './text/index.js'
-export * as number from './number/index.js'
+export * as ref from './ref/index.js'

package/agnostic/html/index.d.ts

@@ -1,8 +1,8 @@
+export * as deepSelect from './deep-select/index.js'
 export * as getNodeAncestors from './get-node-ancestors/index.js'
-export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as hyperJson from './hyper-json/index.js'
+export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as insertNode from './insert-node/index.js'
-export * as deepSelect from './deep-select/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'

package/agnostic/html/index.js

@@ -1,8 +1,8 @@
+export * as deepSelect from './deep-select/index.js'
 export * as getNodeAncestors from './get-node-ancestors/index.js'
-export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as hyperJson from './hyper-json/index.js'
+export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as insertNode from './insert-node/index.js'
-export * as deepSelect from './deep-select/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'

package/agnostic/index.d.ts

@@ -1,17 +1,17 @@
+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 errors from './errors/index.js'
-export * as arrays from './arrays/index.js'
 export * as html from './html/index.js'
+export * as css from './css/index.js'
 export * as misc from './misc/index.js'
 export * as numbers from './numbers/index.js'
-export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
+export * as objects from './objects/index.js'
 export * as random from './random/index.js'
-export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
-export * as time from './time/index.js'
+export * as regexps from './regexps/index.js'
 export * as subtitles from './subtitles/index.js'
+export * as time from './time/index.js'
 export * as typescript from './typescript/index.js'

package/agnostic/index.js

@@ -1,17 +1,17 @@
+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 errors from './errors/index.js'
-export * as arrays from './arrays/index.js'
 export * as html from './html/index.js'
+export * as css from './css/index.js'
 export * as misc from './misc/index.js'
 export * as numbers from './numbers/index.js'
-export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
+export * as objects from './objects/index.js'
 export * as random from './random/index.js'
-export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
-export * as time from './time/index.js'
+export * as regexps from './regexps/index.js'
 export * as subtitles from './subtitles/index.js'
+export * as time from './time/index.js'
 export * as typescript from './typescript/index.js'

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
-export * as assert from './assert/index.js'
 export * as cast from './cast/index.js'
+export * as assert from './assert/index.js'
 export * as crawler from './crawler/index.js'
-export * as dataSize from './data-size/index.js'
 export * as connection from './connection/index.js'
+export * as crossenv from './crossenv/index.js'
+export * as dataSize from './data-size/index.js'
+export * as isNullish from './is-nullish/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
-export * as crossenv from './crossenv/index.js'
-export * as outcome from './outcome/index.js'
-export * as isNullish from './is-nullish/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 assert from './assert/index.js'
 export * as cast from './cast/index.js'
+export * as assert from './assert/index.js'
 export * as crawler from './crawler/index.js'
-export * as dataSize from './data-size/index.js'
 export * as connection from './connection/index.js'
+export * as crossenv from './crossenv/index.js'
+export * as dataSize from './data-size/index.js'
+export * as isNullish from './is-nullish/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
-export * as crossenv from './crossenv/index.js'
-export * as outcome from './outcome/index.js'
-export * as isNullish from './is-nullish/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 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'
+export * as interpolate from './interpolate/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'
+export * as interpolate from './interpolate/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 recordMap from './record-map/index.js'
-export * as enums from './enums/index.js'
 export * as sortKeys from './sort-keys/index.js'
+export * as recordMap from './record-map/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 recordMap from './record-map/index.js'
-export * as enums from './enums/index.js'
 export * as sortKeys from './sort-keys/index.js'
+export * as recordMap from './record-map/index.js'
 export * as validation from './validation/index.js'

package/agnostic/sanitization/index.d.ts

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

package/agnostic/sanitization/index.js

@@ -1,4 +1,4 @@
 export * as fileName from './file-name/index.js'
-export * as html from './html/index.js'
 export * as path from './path/index.js'
 export * as userInput from './user-input/index.js'
+export * as html from './html/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 dates from './dates/index.js'
+export * as duration from './duration/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 dates from './dates/index.js'
+export * as duration from './duration/index.js'

package/components/Image/index.d.ts

@@ -7,6 +7,12 @@ import type { WithClassName } from '../utils/types.js';
  * @property type - MIME type hint for the source (e.g. `'image/webp'`).
  * @property media - Media condition under which this source is selected (e.g. `'(max-width: 768px)'`).
  * @property sizes - Sizes attribute forwarded to the `<source>` element.
+ *
+ * **A picture source is not a video source.** `Video` keeps a shape of its own: a
+ * `<source>` inside a `<video>` carries `src` and nothing else useful, where this one
+ * carries `srcSet`, `media` and `sizes`, and neither element accepts the other's
+ * attributes. What the two do share is how a list of them is read — see
+ * `parseSourceList` in `components/utils`, whose `stringKey` is exactly that difference.
  */
 type SourceData = {
     srcSet?: string;

package/components/Image/index.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useMemo } from 'react';
 import { clss } from '../../agnostic/css/clss/index.js';
-import { mergeClassNames } from '../utils/index.js';
+import { mergeClassNames, parseSourceList } from '../utils/index.js';
 import { image as publicClassName } from '../public-classnames.js';
 import cssModule from './styles.module.css';
 /**
@@ -19,27 +19,12 @@ import cssModule from './styles.module.css';
  */
 export const Image = ({ sources, className, ...intrinsicImgAttributes }) => {
     // State
-    const parsedSources = useMemo(() => {
-        if (sources === undefined)
-            return [];
-        if (typeof sources === 'string')
-            return [{ srcSet: sources }];
-        if (Array.isArray(sources)) {
-            if (sources.length === 0)
-                return [];
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- first element sampled just above; array is expected to be homogeneous
-            if (typeof sources[0] === 'string')
-                return sources.map(srcSet => ({ srcSet }));
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- first element was checked not to be a string just above; array is expected to be homogeneous
-            return sources;
-        }
-        return [];
-    }, [sources]);
+    const parsedSources = useMemo(() => parseSourceList(sources, 'srcSet'), [sources]);
     // Rendering
     const c = clss(publicClassName, { cssModule });
     const rootClss = mergeClassNames(c(), className);
     const pictureClss = c('picture');
     const imgClss = c('image');
-    const pictureContent = _jsxs("picture", { className: pictureClss, children: [parsedSources.map((source, index) => _jsx("source", { srcSet: typeof source === 'string' ? source : source.srcSet, type: typeof source === 'string' ? undefined : source.type, media: typeof source === 'string' ? undefined : source.media, sizes: typeof source === 'string' ? undefined : source.sizes }, index)), _jsx("img", { className: imgClss, ...intrinsicImgAttributes })] });
+    const pictureContent = _jsxs("picture", { className: pictureClss, children: [parsedSources.map((source, index) => _jsx("source", { srcSet: source.srcSet, type: source.type, media: source.media, sizes: source.sizes }, index)), _jsx("img", { className: imgClss, ...intrinsicImgAttributes })] });
     return _jsx("figure", { className: rootClss, children: pictureContent });
 };

package/components/IntersectionObserver/index.d.ts

@@ -1,4 +1,4 @@
-import { type PropsWithChildren, type FunctionComponent } from 'react';
+import { type PropsWithChildren, type FunctionComponent, type RefObject } from 'react';
 import type { WithClassName } from '../utils/types.js';
 /** Alias for the native IntersectionObserver interface. */
 export type IO = IntersectionObserver;
@@ -40,18 +40,43 @@ export type Props = PropsWithChildren<WithClassName<{
         observer: IO;
     }) => void;
 } & ObserverOptions>>;
+/**
+ * Observes an element a caller already renders, rather than one wrapped in a div of
+ * our own.
+ *
+ * This is the whole of the behaviour; {@link IntersectionObserverComponent} is this
+ * hook plus a div to hang it on. Reach for the hook when the element to watch is
+ * already in the tree — a component's own root, typically — and for the component
+ * when there is nothing to watch yet and a box has to be created.
+ *
+ * @param targetRef - The element to observe. Nothing happens until it is attached.
+ * @param options - See {@link ObserverOptions}.
+ * @param onIntersected - Called on every intersection change.
+ * @param enabled - `false` skips the observer entirely, for a caller whose need for
+ * it depends on its own props. A hook cannot be called conditionally; this is how
+ * the condition is expressed.
+ *
+ * @returns The latest {@link IntersectionObserverEntry}, or `null` before the first.
+ *
+ * @remarks
+ * - Automatically creates and disconnects the {@link IntersectionObserver} instance.
+ * - Re-observes the element shortly after mount to handle late layout changes.
+ */
+export declare function useIntersectionObserver(targetRef: RefObject<Element | null>, { root, rootMargin, threshold }: ObserverOptions, onIntersected?: Props['onIntersected'], enabled?: boolean): IOE | null;
 /**
  * Component that observes its root element using the IntersectionObserver API
  * and notifies consumers about visibility changes.
  *
+ * A div and {@link useIntersectionObserver}, and nothing else. A component that
+ * already renders the element it wants watched should use the hook and keep its own
+ * root, rather than gain a wrapper it has no other use for.
+ *
  * @param props - Component properties.
  * @see {@link Props}
  *
  * @returns A div element wrapping `children`, observed for intersection changes.
  *
  * @remarks
- * - Automatically creates and disconnects the {@link IntersectionObserver} instance.
- * - Re-observes the element shortly after mount to handle late layout changes.
  * - Adds an `is-intersecting` modifier class when the element is intersecting.
  */
 export declare const IntersectionObserverComponent: FunctionComponent<Props>;