@design-edito/tools 0.4.11 → 0.4.13

package/agnostic/arrays/index.d.ts

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

package/agnostic/arrays/index.js

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

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 luminance from './luminance/index.js'
-export * as palette from './palette/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 typechecks from './typechecks/index.js'
 export * as tidy from './tidy/index.js'
+export * as typechecks from './typechecks/index.js'
+export * as luminance from './luminance/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 luminance from './luminance/index.js'
-export * as palette from './palette/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 typechecks from './typechecks/index.js'
 export * as tidy from './tidy/index.js'
+export * as typechecks from './typechecks/index.js'
+export * as luminance from './luminance/index.js'

package/agnostic/errors/index.d.ts

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

package/agnostic/errors/index.js

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

package/agnostic/html/deep-select/index.d.ts

@@ -0,0 +1,31 @@
+/** Options for `deepSelect`. */
+type Options = {
+    /** Root node to start traversal from. Defaults to `document`. */
+    fromElement?: Element;
+    /** Number of element nodes to visit before yielding to the main thread. Defaults to `500`. */
+    chunkSize?: number;
+};
+/**
+ * Queries the DOM for all elements matching a CSS selector, including inside open shadow roots.
+ *
+ * Walks the tree with `document.createTreeWalker` instead of `querySelectorAll`, so traversal can
+ * descend into `element.shadowRoot` trees that standard selectors do not pierce. The traversal
+ * root (`fromElement` or `document`) is never included in the results, even if it matches.
+ *
+ * Yields to the main thread every `chunkSize` visited nodes, using `scheduler.yield()` when
+ * available or `setTimeout(0)` as a fallback. Requires a browser environment with `document`.
+ *
+ * @param {string} selector - CSS selector tested with `Element.prototype.matches`.
+ * @param {Options} [options] - Optional configuration:
+ *   - `fromElement`: Element (or `document`) to start the walk from.
+ *   - `chunkSize`: How many element nodes to process between yields.
+ * @returns {Promise<Element[]>} All matching elements in tree-walker order (depth-first).
+ *
+ * @example
+ * const items = await deepSelect('[data-item]', { fromElement: app })
+ *
+ * @example
+ * const labels = await deepSelect('.label', { chunkSize: 100 })
+ */
+export declare const deepSelect: (selector: string, options?: Options) => Promise<Element[]>;
+export {};

package/agnostic/html/deep-select/index.js

@@ -0,0 +1,52 @@
+import * as Window from '../../misc/crossenv/window/index.js';
+const yieldToMain = async (windowLike) => {
+    if (typeof windowLike.scheduler?.yield === 'function')
+        return windowLike.scheduler.yield();
+    return await new Promise(resolve => setTimeout(resolve, 0));
+};
+/**
+ * Queries the DOM for all elements matching a CSS selector, including inside open shadow roots.
+ *
+ * Walks the tree with `document.createTreeWalker` instead of `querySelectorAll`, so traversal can
+ * descend into `element.shadowRoot` trees that standard selectors do not pierce. The traversal
+ * root (`fromElement` or `document`) is never included in the results, even if it matches.
+ *
+ * Yields to the main thread every `chunkSize` visited nodes, using `scheduler.yield()` when
+ * available or `setTimeout(0)` as a fallback. Requires a browser environment with `document`.
+ *
+ * @param {string} selector - CSS selector tested with `Element.prototype.matches`.
+ * @param {Options} [options] - Optional configuration:
+ *   - `fromElement`: Element (or `document`) to start the walk from.
+ *   - `chunkSize`: How many element nodes to process between yields.
+ * @returns {Promise<Element[]>} All matching elements in tree-walker order (depth-first).
+ *
+ * @example
+ * const items = await deepSelect('[data-item]', { fromElement: app })
+ *
+ * @example
+ * const labels = await deepSelect('.label', { chunkSize: 100 })
+ */
+export const deepSelect = async (selector, options) => {
+    const window = Window.get();
+    const { document } = window;
+    const from = options?.fromElement ?? document;
+    const results = [];
+    const chunkSize = options?.chunkSize ?? 500;
+    let nodeCount = 0;
+    const traverse = async (root) => {
+        const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+        let node = walker.currentNode;
+        while (node !== null) {
+            if (node !== root && node instanceof Element && node.matches(selector))
+                results.push(node);
+            if (node instanceof Element && node.shadowRoot !== null)
+                await traverse(node.shadowRoot);
+            nodeCount++;
+            if (nodeCount % chunkSize === 0)
+                await yieldToMain(window);
+            node = walker.nextNode();
+        }
+    };
+    await traverse(from);
+    return results;
+};

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

@@ -1,16 +1,16 @@
 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 call from './call/index.js'
-export * as addclass from './addclass/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
 export * as getattribute from './getattribute/index.js'
+export * as equals from './equals/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
-export * as equals from './equals/index.js'
 export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
 export * as initialize from './initialize/index.js'
@@ -20,33 +20,33 @@ export * as map from './map/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
-export * as pickrandom from './pickrandom/index.js'
 export * as populate from './populate/index.js'
+export * as pickrandom from './pickrandom/index.js'
+export * as print from './print/index.js'
 export * as push from './push/index.js'
 export * as pusheach from './pusheach/index.js'
+export * as recordtoarray from './recordtoarray/index.js'
 export * as removeattribute from './removeattribute/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as recordtoarray from './recordtoarray/index.js'
-export * as print from './print/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 setproperty from './setproperty/index.js'
-export * as toelement from './toelement/index.js'
-export * as toboolean from './toboolean/index.js'
 export * as toarray from './toarray/index.js'
+export * as toboolean from './toboolean/index.js'
+export * as renameproperty from './renameproperty/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 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 toref from './toref/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as tonodelist from './tonodelist/index.js'

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

@@ -1,16 +1,16 @@
 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 call from './call/index.js'
-export * as addclass from './addclass/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
 export * as getattribute from './getattribute/index.js'
+export * as equals from './equals/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
-export * as equals from './equals/index.js'
 export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
 export * as initialize from './initialize/index.js'
@@ -20,33 +20,33 @@ export * as map from './map/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
-export * as pickrandom from './pickrandom/index.js'
 export * as populate from './populate/index.js'
+export * as pickrandom from './pickrandom/index.js'
+export * as print from './print/index.js'
 export * as push from './push/index.js'
 export * as pusheach from './pusheach/index.js'
+export * as recordtoarray from './recordtoarray/index.js'
 export * as removeattribute from './removeattribute/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as recordtoarray from './recordtoarray/index.js'
-export * as print from './print/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 setproperty from './setproperty/index.js'
-export * as toelement from './toelement/index.js'
-export * as toboolean from './toboolean/index.js'
 export * as toarray from './toarray/index.js'
+export * as toboolean from './toboolean/index.js'
+export * as renameproperty from './renameproperty/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 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 toref from './toref/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as tonodelist from './tonodelist/index.js'

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

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

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

package/agnostic/html/index.d.ts

@@ -1,8 +1,10 @@
+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 insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
-export * as stringToNodes from './string-to-nodes/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'

package/agnostic/html/index.js

@@ -1,8 +1,10 @@
+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 insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
-export * as stringToNodes from './string-to-nodes/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'

package/agnostic/html/watch-selection/index.d.ts

@@ -0,0 +1,41 @@
+/** Options for `watchSelection`. */
+type Options = {
+    /** Called when a matching element newly appears in the selection. Defaults to a no-op. */
+    watch?: (elt: Element) => void;
+    /** Called when a matching element is no longer in the selection. Defaults to a no-op. */
+    unwatch?: (elt: Element) => void;
+    /** Interval in milliseconds between selection polls. Defaults to `100`. */
+    selectIntervalMs?: number;
+};
+/**
+ * Watches a CSS selector over time and invokes callbacks when the matching set changes.
+ *
+ * Performs an initial `deepSelect`, calls `watch` on every match, then polls on a fixed interval.
+ * On each poll, newly matched elements trigger `watch` and elements that disappeared trigger
+ * `unwatch`. Comparison uses element identity (`===`), not structural equality.
+ *
+ * Requires a browser environment with `window` and `document`.
+ *
+ * @param {string} selector - CSS selector passed to `deepSelect`.
+ * @param {Options} options - Callbacks and polling configuration:
+ *   - `watch`: Handler for elements that enter the selection.
+ *   - `unwatch`: Handler for elements that leave the selection.
+ *   - `selectIntervalMs`: Delay between polls in milliseconds.
+ * @returns {Promise<{ kill: () => void }>}
+ * Resolves after the initial selection is processed. `kill` stops polling and calls `unwatch`
+ * on every element still watched.
+ *
+ * @example
+ * const { kill } = await watchSelection('.widget', {
+ *   watch: elt => elt.classList.add('is-active'),
+ *   unwatch: elt => elt.classList.remove('is-active'),
+ * })
+ *
+ * @example
+ * // later, when tearing down:
+ * kill()
+ */
+export declare const watchSelection: (selector: string, options: Options) => Promise<{
+    kill: () => void;
+}>;
+export {};

package/agnostic/html/watch-selection/index.js

@@ -0,0 +1,50 @@
+import { deepSelect } from '../deep-select/index.js';
+/**
+ * Watches a CSS selector over time and invokes callbacks when the matching set changes.
+ *
+ * Performs an initial `deepSelect`, calls `watch` on every match, then polls on a fixed interval.
+ * On each poll, newly matched elements trigger `watch` and elements that disappeared trigger
+ * `unwatch`. Comparison uses element identity (`===`), not structural equality.
+ *
+ * Requires a browser environment with `window` and `document`.
+ *
+ * @param {string} selector - CSS selector passed to `deepSelect`.
+ * @param {Options} options - Callbacks and polling configuration:
+ *   - `watch`: Handler for elements that enter the selection.
+ *   - `unwatch`: Handler for elements that leave the selection.
+ *   - `selectIntervalMs`: Delay between polls in milliseconds.
+ * @returns {Promise<{ kill: () => void }>}
+ * Resolves after the initial selection is processed. `kill` stops polling and calls `unwatch`
+ * on every element still watched.
+ *
+ * @example
+ * const { kill } = await watchSelection('.widget', {
+ *   watch: elt => elt.classList.add('is-active'),
+ *   unwatch: elt => elt.classList.remove('is-active'),
+ * })
+ *
+ * @example
+ * // later, when tearing down:
+ * kill()
+ */
+export const watchSelection = async (selector, options) => {
+    const watch = options?.watch ?? (() => { });
+    const unwatch = options?.unwatch ?? (() => { });
+    let watched = await deepSelect(selector);
+    watched.forEach(watch);
+    const selectIntervalMs = options?.selectIntervalMs ?? 100;
+    const interval = window.setInterval(() => {
+        void deepSelect(selector).then(watchedNow => {
+            const staleWatched = watched.filter(elt => !watchedNow.includes(elt));
+            const newWatched = watchedNow.filter(elt => !watched.includes(elt));
+            staleWatched.forEach(unwatch);
+            newWatched.forEach(watch);
+            watched = watchedNow;
+        });
+    }, selectIntervalMs);
+    const kill = () => {
+        window.clearInterval(interval);
+        watched.forEach(unwatch);
+    };
+    return { kill };
+};

package/agnostic/index.d.ts

@@ -1,13 +1,13 @@
+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 html from './html/index.js'
-export * as numbers from './numbers/index.js'
 export * as misc from './misc/index.js'
-export * as arrays from './arrays/index.js'
 export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
+export * as numbers from './numbers/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'

package/agnostic/index.js

@@ -1,13 +1,13 @@
+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 html from './html/index.js'
-export * as numbers from './numbers/index.js'
 export * as misc from './misc/index.js'
-export * as arrays from './arrays/index.js'
 export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
+export * as numbers from './numbers/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'

package/agnostic/misc/index.d.ts

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

package/agnostic/misc/index.js

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

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

@@ -1,3 +1,3 @@
-export * as makeTextBlock from './make-text-block/index.js'
-export * as styles from './styles/index.js'
 export * as logger from './logger/index.js'
+export * as styles from './styles/index.js'
+export * as makeTextBlock from './make-text-block/index.js'

package/agnostic/misc/logs/index.js

@@ -1,3 +1,3 @@
-export * as makeTextBlock from './make-text-block/index.js'
-export * as styles from './styles/index.js'
 export * as logger from './logger/index.js'
+export * as styles from './styles/index.js'
+export * as makeTextBlock from './make-text-block/index.js'

package/agnostic/numbers/index.d.ts

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as geometricProgressions from './geometric-progressions/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 interpolate from './interpolate/index.js'
 export * as round from './round/index.js'
-export * as approximateRational from './approximate-rational/index.js'

package/agnostic/numbers/index.js

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as geometricProgressions from './geometric-progressions/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 interpolate from './interpolate/index.js'
 export * as round from './round/index.js'
-export * as approximateRational from './approximate-rational/index.js'

package/agnostic/objects/index.d.ts

@@ -1,9 +1,9 @@
 export * as enums from './enums/index.js'
-export * as isObject from './is-object/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 deepGetProperty from './deep-get-property/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'
 export * as validation from './validation/index.js'
+export * as sortKeys from './sort-keys/index.js'
+export * as deepGetProperty from './deep-get-property/index.js'

package/agnostic/objects/index.js

@@ -1,9 +1,9 @@
 export * as enums from './enums/index.js'
-export * as isObject from './is-object/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 deepGetProperty from './deep-get-property/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'
 export * as validation from './validation/index.js'
+export * as sortKeys from './sort-keys/index.js'
+export * as deepGetProperty from './deep-get-property/index.js'

package/agnostic/random/index.d.ts

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

package/agnostic/random/index.js

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

package/agnostic/strings/index.d.ts

@@ -1,7 +1,8 @@
+export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
 export * as 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 charCodes from './char-codes/index.js'

package/agnostic/strings/index.js

@@ -1,7 +1,8 @@
+export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
 export * as 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 charCodes from './char-codes/index.js'

package/agnostic/strings/split-trim/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Splits a string into segments, trims whitespace from each part, and optionally removes empty segments.
+ *
+ * Each segment is trimmed with `String.prototype.trim`. When `removeEmpty` is `true`, segments that
+ * become empty after trimming are filtered out.
+ *
+ * When `splitter` is an array, each separator is applied in order: every current segment is split
+ * with the next separator before moving on to the following one.
+ *
+ * @param toSplit - The string to split.
+ * @param splitter - A single separator, or an ordered list of separators passed to `String.prototype.split`.
+ * @param removeEmpty - When `true`, drops segments that are empty after trimming. Defaults to `false`.
+ * @returns An array of trimmed string segments.
+ *
+ * @example
+ * splitTrim(' foo , bar , baz ', ',')
+ * // => ['foo', 'bar', 'baz']
+ *
+ * @example
+ * splitTrim('foo,,bar', ',', true)
+ * // => ['foo', 'bar']
+ *
+ * @example
+ * splitTrim('foo bar,baz', [' ', ','])
+ * // => ['foo', 'bar', 'baz']
+ */
+export declare const splitTrim: (toSplit: string, splitter: string | RegExp | Array<string | RegExp>, removeEmpty?: boolean) => string[];