@design-edito/tools 0.5.18 → 0.5.20

package/agnostic/colors/convert/index.js

@@ -1,5 +1,4 @@
 /* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- TransformedColor<C> can't be narrowed from a generic type param at compile time; every assertion here is guarded by an isX(...) runtime check immediately prior */
-/* eslint-disable max-lines */
 import { absoluteModulo } from '../../numbers/absolute-modulo/index.js';
 import { tidy } from '../tidy/index.js';
 import { cssColors } from '../cssColorsMap.js';

package/agnostic/colors/index.d.ts

@@ -3,10 +3,10 @@ export * as contrast from './contrast/index.js'
 export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
+export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
-export * as luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
+export * as luminance from './luminance/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 invert from './invert/index.js'
+export * as tidy from './tidy/index.js'

package/agnostic/colors/index.js

@@ -3,10 +3,10 @@ export * as contrast from './contrast/index.js'
 export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
+export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
-export * as luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
+export * as luminance from './luminance/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 invert from './invert/index.js'
+export * as tidy from './tidy/index.js'

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

@@ -14,39 +14,39 @@ export * as hjparse from './hjparse/index.js'
 export * as hjstringify from './hjstringify/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 notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
-export * as print from './print/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 initialize from './initialize/index.js'
 export * as removeattribute from './removeattribute/index.js'
+export * as recordtoarray from './recordtoarray/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as replace from './replace/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 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 spread from './spread/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 toggleclass from './toggleclass/index.js'
 export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
+export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
-export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as toref from './toref/index.js'
+export * as transformselected from './transformselected/index.js'

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

@@ -14,39 +14,39 @@ export * as hjparse from './hjparse/index.js'
 export * as hjstringify from './hjstringify/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 notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
-export * as print from './print/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 initialize from './initialize/index.js'
 export * as removeattribute from './removeattribute/index.js'
+export * as recordtoarray from './recordtoarray/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as replace from './replace/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 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 spread from './spread/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 toggleclass from './toggleclass/index.js'
 export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
+export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
-export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as toref from './toref/index.js'
+export * as transformselected from './transformselected/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 nodelist from './nodelist/index.js'
 export * as null from './null/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 guess from './guess/index.js'
 export * as string from './string/index.js'
-export * as text from './text/index.js'
 export * as ref from './ref/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 nodelist from './nodelist/index.js'
 export * as null from './null/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 guess from './guess/index.js'
 export * as string from './string/index.js'
-export * as text from './text/index.js'
 export * as ref from './ref/index.js'
+export * as text from './text/index.js'

package/agnostic/html/hyper-json/utils/index.js

@@ -1,4 +1,4 @@
-/* eslint-disable max-lines, @typescript-eslint/no-unsafe-type-assertion -- generic type params (T/K/Value) and DOM NodeList casts here can't be narrowed from a generic/runtime check at compile time; guarded by runtime typeCheck(s)/instanceof checks immediately prior */
+/* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- generic type params (T/K/Value) and DOM NodeList casts here can't be narrowed from a generic/runtime check at compile time; guarded by runtime typeCheck(s)/instanceof checks immediately prior */
 import * as Window from '../../../misc/crossenv/window/index.js';
 import { isRecord } from '../../../objects/is-record/index.js';
 import { recordMap } from '../../../objects/record-map/index.js';

package/agnostic/html/index.d.ts

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

package/agnostic/html/index.js

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

package/agnostic/index.d.ts

@@ -2,16 +2,16 @@ export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
 export * as errors from './errors/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 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 random from './random/index.js'
-export * as sanitization from './sanitization/index.js'
-export * as strings from './strings/index.js'
 export * as regexps from './regexps/index.js'
-export * as subtitles from './subtitles/index.js'
+export * as strings from './strings/index.js'
+export * as sanitization from './sanitization/index.js'
 export * as time from './time/index.js'
 export * as typescript from './typescript/index.js'
+export * as subtitles from './subtitles/index.js'
+export * as optim from './optim/index.js'

package/agnostic/index.js

@@ -2,16 +2,16 @@ export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
 export * as errors from './errors/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 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 random from './random/index.js'
-export * as sanitization from './sanitization/index.js'
-export * as strings from './strings/index.js'
 export * as regexps from './regexps/index.js'
-export * as subtitles from './subtitles/index.js'
+export * as strings from './strings/index.js'
+export * as sanitization from './sanitization/index.js'
 export * as time from './time/index.js'
 export * as typescript from './typescript/index.js'
+export * as subtitles from './subtitles/index.js'
+export * as optim from './optim/index.js'

package/agnostic/misc/index.d.ts

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

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
-export * as cast from './cast/index.js'
 export * as assert from './assert/index.js'
-export * as crawler from './crawler/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 isNullish from './is-nullish/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 loremIpsum from './lorem-ipsum/index.js'
-export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/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 clamp from './clamp/index.js'
 export * as approximateRational from './approximate-rational/index.js'
+export * as clamp from './clamp/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
-export * as round from './round/index.js'
 export * as interpolate from './interpolate/index.js'
+export * as round from './round/index.js'

package/agnostic/numbers/index.js

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

package/agnostic/objects/index.d.ts

@@ -1,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 flattenGetters from './flatten-getters/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 flattenGetters from './flatten-getters/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'
+export * as fileName from './file-name/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'
+export * as fileName from './file-name/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 charCodes from './char-codes/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 splitTrim from './split-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 charCodes from './char-codes/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 splitTrim from './split-trim/index.js'

package/agnostic/subtitles/index.d.ts

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

package/agnostic/subtitles/index.js

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

package/agnostic/time/index.d.ts

@@ -1,5 +1,5 @@
-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'
+export * as transitions from './transitions/index.js'
+export * as timeout from './timeout/index.js'
+export * as wait from './wait/index.js'

package/agnostic/time/index.js

@@ -1,5 +1,5 @@
-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'
+export * as transitions from './transitions/index.js'
+export * as timeout from './timeout/index.js'
+export * as wait from './wait/index.js'

package/components/Video/index.d.ts

@@ -1,11 +1,18 @@
 import { type FunctionComponent } from 'react';
-import { type ViewportBehaviours } from '../utils/viewport-behaviours/index.js';
+import type { ViewportBehaviours } from '../utils/viewport-behaviours/types.js';
 import type { VideoAction } from './types.js';
 import { type Props as ControlledProps } from './index.controlled.js';
 /**
  * Props for the {@link Video} component.
  *
  * Extends all ControlledVideo props except play, mute, fullscreen, volume, playbackRate, and their associated event handlers
+ * @property behavioursSuspended - Holds back the instructions that **start** something,
+ * and lets through those that stop it. For a consumer withholding the video behind
+ * something — a warning to accept, typically: a video kept back that plays anyway is not
+ * withheld, it is merely hard to see. What was held back is replayed the moment this
+ * goes false, so lifting the veil on an already-visible video does what was asked, which
+ * a crossing-based trigger could never do. `':force'` does not override it: it speaks of
+ * consent not yet given, where a surrender speaks of an intention already expressed.
  * @property visibilityThreshold - How much of the video has to be on screen to count as
  * seen. See {@link VisibilityOptions} for this and the four that follow it.
  * @property whenVisible - What to do each time it becomes visible.
@@ -32,6 +39,7 @@ import { type Props as ControlledProps } from './index.controlled.js';
  */
 export type Props = Omit<ControlledProps, 'play' | 'fullscreen' | 'volume' | 'mute' | 'playbackRate' | 'subtitlesOn' | 'rootRef' | 'videoRef'> & ViewportBehaviours<VideoAction> & {
     defaultSubtitlesOn?: boolean;
+    behavioursSuspended?: boolean;
 };
 /**
  * Full-featured video player component. Wraps a native `<video>` element with

package/components/Video/index.js

@@ -51,7 +51,7 @@ import { ControlledVideo } from './index.controlled.js';
  * The media still won't play, though: autoplay muted, and leave unmuting to the
  * reader.
  */
-export const Video = ({ defaultSubtitlesOn = true, visibilityThreshold, visibilityRoot, visibilityRootMargin, visibilityOnAfterMs, visibilityOffAfterMs, whenVisible, whenHidden, onVisibilityChanged, onVideoClicked, onPlayButtonClicked, onPauseButtonClicked, onLoudButtonClicked, onMuteButtonClicked, onVolumeRangeChanged, onRateRangeChanged, onFullscreenButtonClicked, onSubtitlesButtonClicked, ...controlledProps }) => {
+export const Video = ({ defaultSubtitlesOn = true, behavioursSuspended, visibilityThreshold, visibilityRoot, visibilityRootMargin, visibilityOnAfterMs, visibilityOffAfterMs, whenVisible, whenHidden, onVisibilityChanged, onVideoClicked, onPlayButtonClicked, onPauseButtonClicked, onLoudButtonClicked, onMuteButtonClicked, onVolumeRangeChanged, onRateRangeChanged, onFullscreenButtonClicked, onSubtitlesButtonClicked, ...controlledProps }) => {
     // State & refs
     const [play, setPlay] = useState(false);
     const [volume, setVolume] = useState(1);
@@ -101,7 +101,7 @@ export const Video = ({ defaultSubtitlesOn = true, visibilityThreshold, visibili
         whenVisible,
         whenHidden,
         onVisibilityChanged
-    }, actions);
+    }, actions, behavioursSuspended === true);
     // Narrowed back to this component's own domains. The generic layer takes a `string`,
     // having no vocabulary of its own; handing the handlers a typed door means a
     // misspelled domain fails to compile instead of quietly never surrendering anything.

package/components/Video/types.d.ts

@@ -4,7 +4,23 @@
  * `jump-to` is the only one taking an argument, and the table is keyed by the verb
  * alone — the argument is parsed out of the instruction before the lookup.
  */
-export type VideoVerb = 'play' | 'pause' | 'loud' | 'mute' | 'jump-to' | 'jump-start' | 'jump-end';
+export declare const VIDEO_VERBS: readonly ["play", "pause", "loud", "mute", "jump-to", "jump-start", "jump-end"];
+export type VideoVerb = typeof VIDEO_VERBS[number];
+/**
+ * How to read the argument of each verb that takes one.
+ *
+ * **Exported because a consumer has to validate what it is handed**, and a type gives a
+ * runtime validator nothing to compare against. lm-link reads an article's props out of
+ * static XML and has to reject `'jump-to:banana'` before it ever reaches here — with the
+ * list restated on its side, the day a verb is added is the day an article writing it
+ * silently gets nothing.
+ *
+ * A digit string, and deliberately not `Number`: that would take `'1e3'` and `'0x10'`,
+ * which nobody means to write in an article.
+ */
+export declare const VIDEO_VERB_ARGUMENTS: {
+    readonly 'jump-to': (arg: string) => boolean;
+};
 /**
  * The instructions a consumer writes in `whenVisible` / `whenHidden`.
  *

package/components/Video/types.js

@@ -1 +1,30 @@
-export {};
+/**
+ * The verbs a video answers to, as the table keys them.
+ *
+ * `jump-to` is the only one taking an argument, and the table is keyed by the verb
+ * alone — the argument is parsed out of the instruction before the lookup.
+ */
+export const VIDEO_VERBS = [
+    'play',
+    'pause',
+    'loud',
+    'mute',
+    'jump-to',
+    'jump-start',
+    'jump-end'
+];
+/**
+ * How to read the argument of each verb that takes one.
+ *
+ * **Exported because a consumer has to validate what it is handed**, and a type gives a
+ * runtime validator nothing to compare against. lm-link reads an article's props out of
+ * static XML and has to reject `'jump-to:banana'` before it ever reaches here — with the
+ * list restated on its side, the day a verb is added is the day an article writing it
+ * silently gets nothing.
+ *
+ * A digit string, and deliberately not `Number`: that would take `'1e3'` and `'0x10'`,
+ * which nobody means to write in an article.
+ */
+export const VIDEO_VERB_ARGUMENTS = {
+    'jump-to': (arg) => /^-?\d+$/v.test(arg)
+};

package/components/index.d.ts

@@ -1,11 +1,11 @@
 export * as beforeAfter from './BeforeAfter/index.js'
+export * as clippable from './Clippable/index.js'
 export * as button from './Button/index.js'
 export * as disclaimer from './Disclaimer/index.js'
-export * as clippable from './Clippable/index.js'
-export * as eventListener from './EventListener/index.js'
 export * as drawer from './Drawer/index.js'
-export * as iframe from './Iframe/index.js'
+export * as eventListener from './EventListener/index.js'
 export * as gallery from './Gallery/index.js'
+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'
@@ -13,17 +13,17 @@ 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 resizeObserver from './ResizeObserver/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 select from './Select/index.js'
 export * as sequencer from './Sequencer/index.js'
 export * as shadowRoot from './ShadowRoot/index.js'
-export * as textarea from './Textarea/index.js'
 export * as subtitles from './Subtitles/index.js'
-export * as uiModule from './UIModule/index.js'
+export * as textarea from './Textarea/index.js'
 export * as video from './Video/index.js'
-export * as wipAudioQuote from './_WIP_AudioQuote/index.js'
+export * as uiModule from './UIModule/index.js'
 export * as wipIcon from './_WIP_Icon/index.js'
+export * as wipAudioQuote from './_WIP_AudioQuote/index.js'
 export * as utils from './utils/index.js'

package/components/index.js

@@ -1,11 +1,11 @@
 export * as beforeAfter from './BeforeAfter/index.js'
+export * as clippable from './Clippable/index.js'
 export * as button from './Button/index.js'
 export * as disclaimer from './Disclaimer/index.js'
-export * as clippable from './Clippable/index.js'
-export * as eventListener from './EventListener/index.js'
 export * as drawer from './Drawer/index.js'
-export * as iframe from './Iframe/index.js'
+export * as eventListener from './EventListener/index.js'
 export * as gallery from './Gallery/index.js'
+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'
@@ -13,17 +13,17 @@ 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 resizeObserver from './ResizeObserver/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 select from './Select/index.js'
 export * as sequencer from './Sequencer/index.js'
 export * as shadowRoot from './ShadowRoot/index.js'
-export * as textarea from './Textarea/index.js'
 export * as subtitles from './Subtitles/index.js'
-export * as uiModule from './UIModule/index.js'
+export * as textarea from './Textarea/index.js'
 export * as video from './Video/index.js'
-export * as wipAudioQuote from './_WIP_AudioQuote/index.js'
+export * as uiModule from './UIModule/index.js'
 export * as wipIcon from './_WIP_Icon/index.js'
+export * as wipAudioQuote from './_WIP_AudioQuote/index.js'
 export * as utils from './utils/index.js'

package/components/utils/viewport-behaviours/index.d.ts

@@ -1,5 +1,30 @@
 import { type RefObject } from 'react';
 import type { ActionTable, ViewportBehaviours, VisibilityOptions } from './types.js';
+/**
+ * Whether a string is an instruction this vocabulary answers to.
+ *
+ * **It lives in the entry point and not next to `parseInstruction`**, which is where it
+ * belongs by subject, because the publish step only maps `index.js` and `types.js` into
+ * the package's exports — a `utils.js` is unreachable from outside, whatever it holds.
+ *
+ * **Exported for the consumers that receive their props as text.** lm-link reads an
+ * article's XML, where nothing is typed, and has to reject `'jump-to:banana'` before it
+ * reaches a component. Written on its side, the rule would exist twice and drift in
+ * silence — a verb added here would be rejected there for no visible reason.
+ *
+ * Returns a plain boolean rather than a type predicate, and that is not an oversight: a
+ * verb taking an argument is written `'jump-to:500'`, which is not a member of the verb
+ * list this checks against. Narrowing to `Instruction<A>` would therefore claim more than
+ * the list can support, and the caller that needs the narrow type is better off asserting
+ * it once, where it can say why.
+ *
+ * @param value - What the consumer wrote.
+ * @param verbs - The vocabulary, bare — `VIDEO_VERBS` and its like.
+ * @param withArgument - Those of them that take one, and what a valid one looks like. A
+ * verb given an argument it does not take, or denied one it needs, fails either way:
+ * both are a consumer meaning something the component cannot do.
+ */
+export declare function isInstruction(value: unknown, verbs: readonly string[], withArgument?: Readonly<Partial<Record<string, (arg: string) => boolean>>>): boolean;
 /**
  * Whether the element counts as visible — **as a state, not as a crossing**.
  *
@@ -51,4 +76,3 @@ export type ViewportBehavioursResult = {
  * and yielding is the silent one.
  */
 export declare function useViewportBehaviours<A extends string>(targetRef: RefObject<Element | null>, props: ViewportBehaviours<A>, table: ActionTable<A>, suspended?: boolean): ViewportBehavioursResult;
-export type { ActionSpec, ActionTable, Instruction, Modifier, ParsedInstruction, ViewportBehaviours, VisibilityOptions } from './types.js';

package/components/utils/viewport-behaviours/index.js

@@ -2,6 +2,41 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import { useIntersectionObserver } from '../../IntersectionObserver/index.js';
 import { useChangeDispatch } from '../index.js';
 import { parseInstruction, toInstructionList } from './utils.js';
+/**
+ * Whether a string is an instruction this vocabulary answers to.
+ *
+ * **It lives in the entry point and not next to `parseInstruction`**, which is where it
+ * belongs by subject, because the publish step only maps `index.js` and `types.js` into
+ * the package's exports — a `utils.js` is unreachable from outside, whatever it holds.
+ *
+ * **Exported for the consumers that receive their props as text.** lm-link reads an
+ * article's XML, where nothing is typed, and has to reject `'jump-to:banana'` before it
+ * reaches a component. Written on its side, the rule would exist twice and drift in
+ * silence — a verb added here would be rejected there for no visible reason.
+ *
+ * Returns a plain boolean rather than a type predicate, and that is not an oversight: a
+ * verb taking an argument is written `'jump-to:500'`, which is not a member of the verb
+ * list this checks against. Narrowing to `Instruction<A>` would therefore claim more than
+ * the list can support, and the caller that needs the narrow type is better off asserting
+ * it once, where it can say why.
+ *
+ * @param value - What the consumer wrote.
+ * @param verbs - The vocabulary, bare — `VIDEO_VERBS` and its like.
+ * @param withArgument - Those of them that take one, and what a valid one looks like. A
+ * verb given an argument it does not take, or denied one it needs, fails either way:
+ * both are a consumer meaning something the component cannot do.
+ */
+export function isInstruction(value, verbs, withArgument = {}) {
+    if (typeof value !== 'string')
+        return false;
+    const { verb, arg } = parseInstruction(value);
+    if (!verbs.includes(verb))
+        return false;
+    const validate = withArgument[verb];
+    if (validate === undefined)
+        return arg === undefined;
+    return arg !== undefined && validate(arg);
+}
 /**
  * Whether the element counts as visible — **as a state, not as a crossing**.
  *

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 upload from './upload/index.js'
-export * as download from './download/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 upload from './upload/index.js'
-export * as download from './download/index.js'

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

@@ -1,8 +1,8 @@
 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 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'

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

@@ -1,8 +1,8 @@
 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 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'

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 metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'
-export * as format from './format/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 metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'
-export * as format from './format/index.js'

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

@@ -1,15 +1,15 @@
 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 brighten from './brighten/index.js'
 export * as hue from './hue/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 overlay from './overlay/index.js'
-export * as lighten from './lighten/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 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 brighten from './brighten/index.js'
 export * as hue from './hue/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 overlay from './overlay/index.js'
-export * as lighten from './lighten/index.js'
 export * as resize from './resize/index.js'
 export * as rotate from './rotate/index.js'
 export * as saturate from './saturate/index.js'

package/package.json

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