@brandup/ui-helpers 2.0.1 → 2.0.3

package/README.md

@@ -12,7 +12,7 @@ npm i @brandup/ui-helpers@latest
 
 ## Helper groups
 
-The package exposes the following named helper groups, plus a set of global prototype/static extensions:
+The package exposes the following named helper groups:
 
 | Import | Module |
 | --- | --- |
@@ -21,8 +21,7 @@ The package exposes the following named helper groups, plus a set of global prot
 | `FuncHelper` | timing / async helpers |
 | `WordHelper` | word pluralization |
 | `Guid` | GUID generation |
-| (extensions) | `String.prototype.format`, `Object.prop`, `Object.hasProp` |
-| (string) | `formatText` |
+| `formatText` | string template formatting |
 
 ```TypeScript
 import { ObjectHelper, TypeHelper, FuncHelper, WordHelper, Guid, formatText } from "@brandup/ui-helpers";
@@ -46,36 +45,15 @@ Format with positional arguments (placeholders are zero-based indexes):
 const result = formatText("Hello, {0}", "Dmitry"); // Hello, Dmitry
 ```
 
-## Extensions
+## Format text
 
-Importing the package augments built-in prototypes with convenience methods.
-
-### Format text
+`formatText` substitutes `{...}` placeholders in a template — by name from a model object, or by zero-based index from positional arguments.
 
 ```TypeScript
-const text = "Hello, {name}";
-const result = text.format({ name: "Dmitry" }); // Hello, Dmitry
-```
-
-Format with arguments:
-
-```TypeScript
-const text = "Hello, {0}";
-const result = text.format("Dmitry"); // Hello, Dmitry
-```
-
-### Get value by property path
-
-```TypeScript
-const model = {
-	header: {
-		value: "Item"
-	}
-}
-
-const value = Object.prop(model, "header.value"); // return "Item"
+import { formatText } from "@brandup/ui-helpers";
 
-const hasValue = Object.hasProp(model, "header.value"); // return true
+formatText("Hello, {name}", { name: "Dmitry" }); // "Hello, Dmitry"
+formatText("Hello, {0}", "Dmitry");              // "Hello, Dmitry"
 ```
 
 ## Object helpers
@@ -151,6 +129,9 @@ const data = await FuncHelper.minWaitAsync(() => loadData(), 1000);
 
 // Reject with TimeoutError if the request takes longer than 5000ms
 const result = await FuncHelper.timeout(fetch("/api"), 5000);
+
+// Make the wait abortable without stopping the underlying work
+const value = await FuncHelper.abortable(longRunning(), abortController.signal);
 ```
 
 Detect a timeout by checking the error type:
@@ -168,7 +149,8 @@ try {
 ```
 
 - `minWait(func, minTime?)` — wraps a callback so it runs no sooner than `minTime` ms after wrapping.
-- `minWaitAsync(func, minTime?, abort?)` — awaits an async operation, padding so it settles no sooner than `minTime` ms.
-- `delay(time, abort?)` — a promise resolved after `time` ms; rejects on abort.
-- `timeout(promise, timeout, abort?)` — races `promise` against `timeout` ms; rejects with a `TimeoutError` on timeout. Throws synchronously if `timeout ≤ 0`.
+- `minWaitAsync(func, minTime?, abort?)` — awaits an async operation, padding so it settles no sooner than `minTime` ms. An already-aborted signal rejects immediately, before `func` runs.
+- `delay(ms, abort?)` — a promise resolved after `ms` ms; rejects on abort. Throws synchronously if `ms` is negative (`0` is allowed).
+- `timeout(promise, ms, abort?)` — races `promise` against `ms` ms; rejects with a `TimeoutError` on timeout, or with the signal's reason on abort. Throws synchronously if `ms ≤ 0`. The underlying `promise` is not cancelled — only the wait ends.
+- `abortable(promise, abort?)` — makes *waiting* for `promise` abortable: rejects with the signal's reason on abort. Does not stop the underlying work; without a signal the promise is awaited as-is.
 - `TimeoutError` — error class thrown by `timeout` when the time limit is exceeded.

package/dist/cjs/helpers/func.js

@@ -0,0 +1,158 @@
+'use strict';
+
+/**
+ * Wraps a callback so that, when invoked, it runs no sooner than `minTime` milliseconds
+ * after this wrapper was created.
+ *
+ * The deadline is measured from the moment `minWait` is called. If `minTime` is omitted
+ * or falsy, the original function is returned unchanged.
+ *
+ * @param func Callback to defer.
+ * @param minTime Minimum delay in milliseconds before the callback may run.
+ * @returns A wrapped function with the same arguments as `func`.
+ */
+const minWait = (func, minTime) => {
+    if (!minTime)
+        return func;
+    const beginTime = Date.now();
+    const ret = (...args) => {
+        const rightTime = getRightTime(beginTime, minTime);
+        if (rightTime)
+            setTimeout(() => func(...args), rightTime);
+        else
+            func(...args);
+    };
+    return ret;
+};
+/**
+ * Awaits an async operation and guarantees the returned promise settles no sooner than
+ * `minTime` milliseconds after invocation, padding with an extra delay when needed.
+ *
+ * Useful for keeping spinners/loading states visible for a minimum duration. If `minTime`
+ * is omitted or falsy, `func` is awaited and its result returned without padding.
+ *
+ * An already-aborted signal rejects immediately, before `func` runs; aborting later cancels
+ * the padding delay (but not `func` itself, which can't be cancelled here).
+ *
+ * @typeParam TResult Result type produced by `func`.
+ * @param func Factory returning the promise to await.
+ * @param minTime Minimum total duration in milliseconds.
+ * @param abort Optional signal used to cancel the wait.
+ * @returns The result produced by `func`.
+ */
+async function minWaitAsync(func, minTime, abort) {
+    abort?.throwIfAborted();
+    if (!minTime)
+        return func();
+    const beginTime = Date.now();
+    const result = await func();
+    const rightTime = getRightTime(beginTime, minTime);
+    if (rightTime)
+        await delay(rightTime, abort);
+    return result;
+}
+/** @internal */
+const getRightTime = (start, minTime) => {
+    const finishTime = Date.now();
+    const w = minTime - (finishTime - start);
+    // Skip padding when the leftover is within 10% of `minTime`: the wait is already
+    // "close enough", and a sub-tick delay would only add jitter without a visible effect.
+    return w > minTime * 0.1 ? w : 0;
+};
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ *
+ * If an already-aborted signal is supplied the promise rejects immediately; otherwise
+ * aborting before the delay elapses clears the timer and rejects with the abort reason.
+ *
+ * @param ms Delay in milliseconds; must not be negative. Values above 2147483647 (~24.8 days)
+ *           overflow the timer and fire on the next tick — a `setTimeout` limitation.
+ * @param abort Optional signal used to cancel the delay.
+ * @returns A promise that resolves when the delay elapses.
+ * @throws {Error} When `ms` is negative.
+ */
+function delay(ms, abort) {
+    if (ms < 0)
+        throw new Error("Invalid delay value.");
+    return new Promise((resolve, reject) => {
+        abort?.throwIfAborted();
+        const onAbort = () => {
+            clearTimeout(timer);
+            // `onAbort` only runs once the listener has fired, which means `abort` exists.
+            reject(abort.reason);
+        };
+        const timer = setTimeout(() => {
+            abort?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        abort?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+/**
+ * Races a promise against a timeout.
+ *
+ * Resolves/rejects with the original promise if it settles in time. If the timeout elapses
+ * first the returned promise rejects with a {@link TimeoutError}. Aborting via `abort`
+ * rejects with the signal's reason.
+ *
+ * @typeParam T Resolved value type of the wrapped promise.
+ * @param promise Promise to guard with a timeout.
+ * @param ms Timeout in milliseconds; must be greater than `0`. Values above 2147483647
+ *           (~24.8 days) overflow the timer and fire on the next tick — a `setTimeout` limitation.
+ * @param abort Optional signal used to cancel the wait.
+ * @returns A promise mirroring `promise` unless the timeout or abort fires first.
+ * @throws {Error} When `ms` is not greater than `0`.
+ */
+function timeout(promise, ms, abort) {
+    if (ms <= 0)
+        throw new Error("Invalid timeout value.");
+    // Own controller so the `delay` timer can be torn down once the race is decided,
+    // independently of the caller's `abort`.
+    const timer = new AbortController();
+    // Wins the race only by timing out (rejects with TimeoutError). If the timer is cancelled
+    // instead — the guarded work settled, or the caller aborted — `delay` rejects, and we turn
+    // that into a never-settling promise so `expire` simply stands aside: the race never produces
+    // a stray rejection that nobody is listening for.
+    const expire = delay(ms, timer.signal).then(() => Promise.reject(new TimeoutError()), () => new Promise(() => { }));
+    return abortable(Promise.race([promise, expire]), abort)
+        .finally(() => timer.abort());
+}
+/**
+ * Makes *waiting* for a promise abortable: rejects with the signal's reason on abort.
+ * Does not stop the underlying work the promise performs.
+ *
+ * If no signal is supplied the promise is awaited as-is. An already-aborted signal rejects
+ * immediately; otherwise the abort listener is removed once the promise settles.
+ *
+ * @typeParam T Resolved value type of the wrapped promise.
+ * @param promise Promise (or thenable) whose wait should become abortable.
+ * @param abort Optional signal used to cancel the wait.
+ * @returns A promise mirroring `promise` unless the abort fires first.
+ */
+function abortable(promise, abort) {
+    if (!abort)
+        return Promise.resolve(promise);
+    if (abort.aborted)
+        return Promise.reject(abort.reason);
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(abort.reason);
+        abort.addEventListener("abort", onAbort, { once: true });
+        const cleanup = () => abort.removeEventListener("abort", onAbort);
+        Promise.resolve(promise).then(v => { cleanup(); resolve(v); }, e => { cleanup(); reject(e); });
+    });
+}
+/** Thrown by {@link timeout} when the time limit is exceeded. */
+class TimeoutError extends Error {
+    constructor() {
+        super("Timeout");
+        this.name = "TimeoutError";
+    }
+}
+
+exports.TimeoutError = TimeoutError;
+exports.abortable = abortable;
+exports.delay = delay;
+exports.minWait = minWait;
+exports.minWaitAsync = minWaitAsync;
+exports.timeout = timeout;
+//# sourceMappingURL=func.js.map

package/dist/cjs/helpers/func.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"func.js","sources":["../../../../source/helpers/func.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/cjs/helpers/guid.js

@@ -0,0 +1,16 @@
+'use strict';
+
+/**
+ * Generates a RFC 4122 UUID v4 string using `crypto.randomUUID()`.
+ *
+ * @returns A newly generated UUID string in `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx` form.
+ * @example
+ * createGuid(); // e.g. "3f2a1b4c-9d8e-4a23-b123-456789abcdef"
+ */
+const createGuid = () => crypto.randomUUID();
+/** The empty (all-zero) GUID value `"00000000-0000-0000-0000-000000000000"`. */
+const empty = "00000000-0000-0000-0000-000000000000";
+
+exports.createGuid = createGuid;
+exports.empty = empty;
+//# sourceMappingURL=guid.js.map

package/dist/cjs/helpers/guid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid.js","sources":["../../../../source/helpers/guid.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;AAMG;AACH,MAAM,UAAU,GAAG,MAAc,MAAM,CAAC,UAAU;AAElD;AACA,MAAM,KAAK,GAAG;;;;;"}

package/dist/cjs/helpers/object.js

@@ -0,0 +1,53 @@
+'use strict';
+
+/**
+ * Reads a nested property value from an object by a dot-separated path.
+ *
+ * @param obj Source object to read from.
+ * @param path Dot-separated property path, e.g. `"header.value"`.
+ * @returns The resolved value; `null` when `obj` is falsy, or `undefined` when
+ * any segment of the path does not exist.
+ * @example
+ * getProperty({ header: { value: "Item" } }, "header.value"); // "Item"
+ */
+function getProperty(obj, path) {
+    if (!obj)
+        return null;
+    const props = path.split('.');
+    for (let i = 0; i < props.length; i++) {
+        const name = props[i];
+        if (obj == null || (typeof obj !== "object" && typeof obj !== "function"))
+            return undefined;
+        if (!(name in obj))
+            return undefined;
+        obj = obj[name];
+    }
+    return obj;
+}
+/**
+ * Determines whether an object has a nested property at the given dot-separated path.
+ *
+ * @param obj Source object to inspect.
+ * @param path Dot-separated property path, e.g. `"header.value"`.
+ * @returns `true` if every segment of the path exists, otherwise `false`.
+ * @example
+ * hasProperty({ header: { value: "Item" } }, "header.value"); // true
+ */
+function hasProperty(obj, path) {
+    if (!obj)
+        return false;
+    const props = path.split('.');
+    for (let i = 0; i < props.length; i++) {
+        const name = props[i];
+        if (obj == null || (typeof obj !== "object" && typeof obj !== "function"))
+            return false;
+        if (!(name in obj))
+            return false;
+        obj = obj[name];
+    }
+    return true;
+}
+
+exports.getProperty = getProperty;
+exports.hasProperty = hasProperty;
+//# sourceMappingURL=object.js.map

package/dist/cjs/helpers/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sources":["../../../../source/helpers/object.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;AASG;AACH,SAAS,WAAW,CAAC,GAAQ,EAAE,IAAY,EAAA;AAC1C,IAAA,IAAI,CAAC,GAAG;AACP,QAAA,OAAO,IAAI;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;AAE7B,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACtC,QAAA,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;AACrB,QAAA,IAAI,GAAG,IAAI,IAAI,KAAK,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,UAAU,CAAC;AACxE,YAAA,OAAO,SAAS;AAEjB,QAAA,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC;AACjB,YAAA,OAAO,SAAS;AAEjB,QAAA,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;IAChB;AAEA,IAAA,OAAO,GAAG;AACX;AAEA;;;;;;;;AAQG;AACH,SAAS,WAAW,CAAC,GAAQ,EAAE,IAAY,EAAA;AAC1C,IAAA,IAAI,CAAC,GAAG;AACP,QAAA,OAAO,KAAK;IAEb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;AAE7B,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACtC,QAAA,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;AACrB,QAAA,IAAI,GAAG,IAAI,IAAI,KAAK,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,UAAU,CAAC;AACxE,YAAA,OAAO,KAAK;AAEb,QAAA,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC;AACjB,YAAA,OAAO,KAAK;AAEb,QAAA,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;IAChB;AAEA,IAAA,OAAO,IAAI;AACZ;;;;;"}

package/dist/cjs/helpers/string.js

@@ -0,0 +1,37 @@
+'use strict';
+
+var object = require('./object.js');
+
+/**
+ * Formats a template string by substituting `{...}` placeholders.
+ *
+ * When the first argument is an object, placeholders are treated as dot-separated
+ * property paths resolved against that object (see {@link getProperty}). Otherwise
+ * placeholders are treated as zero-based indexes into the remaining arguments.
+ * Unresolved placeholders are replaced with an empty string.
+ *
+ * @param template Template containing `{name}` or `{0}` placeholders.
+ * @param args Either a single model object, or positional arguments.
+ * @returns The formatted string.
+ * @example
+ * formatText("Hello, {name}", { name: "Dmitry" }); // "Hello, Dmitry"
+ * formatText("Hello, {0}", "Dmitry");              // "Hello, Dmitry"
+ */
+function formatText(template, ...args) {
+    if (!args.length)
+        return template;
+    const obj = typeof args[0] === "object" ? args[0] : null;
+    return template.replace(/\{([^}]+)\}/g, (_match, key) => {
+        if (obj)
+            return object.getProperty(obj, key) ?? "";
+        else {
+            const paramIndex = parseInt(key);
+            if (!isNaN(paramIndex) && paramIndex < args.length)
+                return args[paramIndex] ?? "";
+        }
+        return "";
+    });
+}
+
+exports.formatText = formatText;
+//# sourceMappingURL=string.js.map

package/dist/cjs/helpers/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sources":["../../../../source/helpers/string.ts"],"sourcesContent":[null],"names":["getProperty"],"mappings":";;;;AAEA;;;;;;;;;;;;;;AAcG;AACH,SAAS,UAAU,CAAC,QAAgB,EAAE,GAAG,IAAW,EAAA;IACnD,IAAI,CAAC,IAAI,CAAC,MAAM;AAAE,QAAA,OAAO,QAAQ;IAEjC,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAExD,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,GAAG,KAAI;AACvD,QAAA,IAAI,GAAG;YAAE,OAAOA,kBAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE;aACtC;AACJ,YAAA,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,IAAI,CAAC,MAAM;AACjD,gBAAA,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;QAC/B;AAEA,QAAA,OAAO,EAAE;AACV,IAAA,CAAC,CAAC;AACH;;;;"}

package/dist/cjs/helpers/type.js

@@ -0,0 +1,26 @@
+'use strict';
+
+/**
+ * Determines whether the given value is a function.
+ *
+ * @param value Value to test.
+ * @returns `true` if the value is a function, otherwise `false`.
+ */
+function isFunction(value) {
+    return (typeof value === "function");
+}
+/**
+ * Determines whether the given value is a string.
+ *
+ * Returns `true` for both string primitives and `String` object instances.
+ *
+ * @param value Value to test.
+ * @returns `true` if the value is a string, otherwise `false`.
+ */
+function isString(value) {
+    return (typeof value === "string" || value instanceof String);
+}
+
+exports.isFunction = isFunction;
+exports.isString = isString;
+//# sourceMappingURL=type.js.map

package/dist/cjs/helpers/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sources":["../../../../source/helpers/type.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AACH,SAAS,UAAU,CAAC,KAAU,EAAA;AAC7B,IAAA,QAAQ,OAAO,KAAK,KAAK,UAAU;AACpC;AAEA;;;;;;;AAOG;AACH,SAAS,QAAQ,CAAC,KAAU,EAAA;IAC3B,QAAQ,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,MAAM;AAC7D;;;;;"}

package/dist/cjs/helpers/word.js

@@ -0,0 +1,30 @@
+'use strict';
+
+/**
+ * Returns a word combined with the grammatical ending that agrees with the given count.
+ *
+ * Implements Russian-style pluralization rules: the ending is chosen depending on
+ * whether the count ends in 1, in 2–4, or in 0/5–9 (with 11–14 treated as the "five" form).
+ *
+ * @param count Quantity that the word refers to.
+ * @param word Word stem to which the ending is appended.
+ * @param one Ending used for counts ending in 1 (but not 11).
+ * @param two Ending used for counts ending in 2–4 (but not 12–14).
+ * @param five Ending used for counts ending in 0, 5–9 and 11–20.
+ * @returns The word with the appropriate ending appended.
+ * @example
+ * getWordEnd(1, "товар", "", "а", "ов"); // "товар"
+ * getWordEnd(3, "товар", "", "а", "ов"); // "товара"
+ * getWordEnd(5, "товар", "", "а", "ов"); // "товаров"
+ */
+function getWordEnd(count, word, one, two, five) {
+    const tt = count % 100;
+    if (tt >= 5 && tt <= 20)
+        return word + (five || "");
+    const t = count % 10;
+    return (t === 1 ?
+        (word + (one || "")) : ((t >= 2 && t <= 4) ? (word + (two || "")) : (word + (five || ""))));
+}
+
+exports.getWordEnd = getWordEnd;
+//# sourceMappingURL=word.js.map

package/dist/cjs/helpers/word.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word.js","sources":["../../../../source/helpers/word.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;AAgBG;AACH,SAAS,UAAU,CAAC,KAAa,EAAE,IAAY,EAAE,GAAY,EAAE,GAAY,EAAE,IAAa,EAAA;AACzF,IAAA,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG;AACtB,IAAA,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;AACtB,QAAA,OAAO,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;AAE3B,IAAA,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE;AAEpB,IAAA,QAAQ,CAAC,KAAK,CAAC;SACb,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;AAE5F;;;;"}