@brandup/ui-helpers 1.0.43 → 2.0.1

package/README.md

@@ -10,11 +10,47 @@ Install NPM package [@brandup/ui-helpers](https://www.npmjs.com/package/@brandup
 npm i @brandup/ui-helpers@latest
 ```
 
+## Helper groups
+
+The package exposes the following named helper groups, plus a set of global prototype/static extensions:
+
+| Import | Module |
+| --- | --- |
+| `ObjectHelper` | object property access by path |
+| `TypeHelper` | runtime type checks |
+| `FuncHelper` | timing / async helpers |
+| `WordHelper` | word pluralization |
+| `Guid` | GUID generation |
+| (extensions) | `String.prototype.format`, `Object.prop`, `Object.hasProp` |
+| (string) | `formatText` |
+
+```TypeScript
+import { ObjectHelper, TypeHelper, FuncHelper, WordHelper, Guid, formatText } from "@brandup/ui-helpers";
+```
+
 ## String helpers
 
-### Format text
+`formatText` substitutes `{...}` placeholders in a template.
+
+Format with model values (placeholders are dot-separated property paths):
+
+```TypeScript
+import { formatText } from "@brandup/ui-helpers";
+
+const result = formatText("Hello, {name}", { name: "Dmitry" }); // Hello, Dmitry
+```
+
+Format with positional arguments (placeholders are zero-based indexes):
+
+```TypeScript
+const result = formatText("Hello, {0}", "Dmitry"); // Hello, Dmitry
+```
+
+## Extensions
 
-Format with model values:
+Importing the package augments built-in prototypes with convenience methods.
+
+### Format text
 
 ```TypeScript
 const text = "Hello, {name}";
@@ -28,8 +64,6 @@ const text = "Hello, {0}";
 const result = text.format("Dmitry"); // Hello, Dmitry
 ```
 
-## Object helpers
-
 ### Get value by property path
 
 ```TypeScript
@@ -42,4 +76,99 @@ const model = {
 const value = Object.prop(model, "header.value"); // return "Item"
 
 const hasValue = Object.hasProp(model, "header.value"); // return true
-```
+```
+
+## Object helpers
+
+`ObjectHelper` reads nested values by a dot-separated path.
+
+```TypeScript
+import { ObjectHelper } from "@brandup/ui-helpers";
+
+const model = { header: { value: "Item" } };
+
+ObjectHelper.getProperty(model, "header.value"); // "Item"
+ObjectHelper.hasProperty(model, "header.value"); // true
+```
+
+- `getProperty(obj, path)` — returns the resolved value; `null` when `obj` is falsy, `undefined` when any path segment is missing or a mid-path value is `null`/primitive.
+- `hasProperty(obj, path)` — returns `true` if every segment of the path exists; safely returns `false` when a mid-path value is `null` or a primitive.
+
+## Type helpers
+
+`TypeHelper` provides runtime type checks.
+
+```TypeScript
+import { TypeHelper } from "@brandup/ui-helpers";
+
+TypeHelper.isFunction(() => {}); // true
+TypeHelper.isString("text");     // true
+```
+
+- `isFunction(value)` — `true` if the value is a function.
+- `isString(value)` — `true` for string primitives and `String` instances.
+
+## Word helpers
+
+`WordHelper.getWordEnd` picks a grammatical ending that agrees with a count (Russian-style pluralization).
+
+```TypeScript
+import { WordHelper } from "@brandup/ui-helpers";
+
+WordHelper.getWordEnd(1, "товар", "", "а", "ов"); // товар
+WordHelper.getWordEnd(3, "товар", "", "а", "ов"); // товара
+WordHelper.getWordEnd(5, "товар", "", "а", "ов"); // товаров
+```
+
+- `getWordEnd(count, word, one?, two?, five?)` — appends `one` for counts ending in 1, `two` for 2–4, and `five` for 0/5–9 and 11–20.
+
+## Guid helpers
+
+`Guid` generates and exposes UUID values.
+
+```TypeScript
+import { Guid } from "@brandup/ui-helpers";
+
+const id = Guid.createGuid(); // e.g. "3f2a1b4c-9d8e-4a23-b123-456789abcdef"
+Guid.empty;                   // "00000000-0000-0000-0000-000000000000"
+```
+
+- `createGuid()` — a new RFC 4122 UUID v4 string (lowercase, uses `crypto.randomUUID()`).
+- `empty` — the all-zero UUID constant.
+
+## Func helpers
+
+`FuncHelper` contains timing and async utilities.
+
+```TypeScript
+import { FuncHelper } from "@brandup/ui-helpers";
+
+// Resolve after 500ms (cancellable via AbortSignal)
+await FuncHelper.delay(500);
+
+// Keep a loading state visible for at least 1000ms
+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);
+```
+
+Detect a timeout by checking the error type:
+
+```TypeScript
+import { FuncHelper } from "@brandup/ui-helpers";
+
+try {
+    const result = await FuncHelper.timeout(fetch("/api"), 5000);
+} catch (e) {
+    if (e instanceof FuncHelper.TimeoutError) {
+        console.log("Request timed out");
+    }
+}
+```
+
+- `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`.
+- `TimeoutError` — error class thrown by `timeout` when the time limit is exceeded.

package/dist/cjs/index.js

@@ -1,23 +1,46 @@
 '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];
@@ -31,9 +54,23 @@ var object = /*#__PURE__*/Object.freeze({
     hasProperty: hasProperty
 });
 
+/**
+ * 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);
 }
@@ -44,6 +81,17 @@ var type = /*#__PURE__*/Object.freeze({
     isString: isString
 });
 
+/**
+ * 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;
@@ -51,12 +99,25 @@ const minWait = (func, minTime) => {
     const ret = (...args) => {
         const rightTime = getRightTime(beginTime, minTime);
         if (rightTime)
-            window.setTimeout(() => func(...args), 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.
+ *
+ * @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 padding delay.
+ * @returns The result produced by `func`.
+ */
 async function minWaitAsync(func, minTime, abort) {
     if (!minTime)
         return func();
@@ -67,59 +128,107 @@ async function minWaitAsync(func, minTime, abort) {
         await delay(rightTime, abort);
     return result;
 }
+/** @internal */
 const getRightTime = (start, minTime) => {
     const finishTime = Date.now();
     const w = minTime - (finishTime - start);
     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 time Delay in milliseconds.
+ * @param abort Optional signal used to cancel the delay.
+ * @returns A promise that resolves when the delay elapses.
+ */
 function delay(time, abort) {
     return new Promise((resolve, reject) => {
         abort?.throwIfAborted();
         const onAbort = () => {
-            window.clearTimeout(timer);
+            clearTimeout(timer);
             reject(abort?.reason);
         };
-        const timer = window.setTimeout(() => {
+        const timer = setTimeout(() => {
             abort?.removeEventListener("abort", onAbort);
             resolve();
         }, time);
         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 timeout Timeout in milliseconds; must be greater than `0`.
+ * @param abort Optional signal used to cancel the wait.
+ * @returns A promise mirroring `promise` unless the timeout or abort fires first.
+ * @throws {Error} When `timeout` is not greater than `0`.
+ */
 function timeout(promise, timeout, abort) {
+    if (timeout <= 0)
+        throw new Error("Invalid timeout value.");
     return new Promise((resolve, reject) => {
-        if (timeout <= 0)
-            throw new Error("Invalid timeout value.");
         abort?.throwIfAborted();
         const onAbort = () => {
-            window.clearTimeout(timer);
+            clearTimeout(timer);
             reject(abort?.reason);
         };
-        const timer = window.setTimeout(() => {
+        const timer = setTimeout(() => {
             abort?.removeEventListener("abort", onAbort);
-            reject(TIMEOUT_REASON);
+            reject(new TimeoutError());
         }, timeout);
         abort?.addEventListener("abort", onAbort, { once: true });
         promise
             .then(result => resolve(result))
             .catch(reason => reject(reason))
             .finally(() => {
-            window.clearTimeout(timer);
+            clearTimeout(timer);
             abort?.removeEventListener("abort", onAbort);
         });
     });
 }
-const TIMEOUT_REASON = "Timeout";
+/** Thrown by {@link timeout} when the time limit is exceeded. */
+class TimeoutError extends Error {
+    constructor() {
+        super("Timeout");
+        this.name = "TimeoutError";
+    }
+}
 
 var func = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    TIMEOUT_REASON: TIMEOUT_REASON,
+    TimeoutError: TimeoutError,
     delay: delay,
     minWait: minWait,
     minWaitAsync: minWaitAsync,
     timeout: timeout
 });
 
+/**
+ * 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)
@@ -134,19 +243,15 @@ var word = /*#__PURE__*/Object.freeze({
     getWordEnd: getWordEnd
 });
 
-const createGuid = () => {
-    var result;
-    var i;
-    var j;
-    result = "";
-    for (j = 0; j < 32; j++) {
-        if (j == 8 || j == 12 || j == 16 || j == 20)
-            result = result + '-';
-        i = Math.floor(Math.random() * 16).toString(16).toUpperCase();
-        result = result + i;
-    }
-    return result;
-};
+/**
+ * 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";
 
 var guid = /*#__PURE__*/Object.freeze({
@@ -155,6 +260,21 @@ var guid = /*#__PURE__*/Object.freeze({
     empty: empty
 });
 
+/**
+ * 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;

package/dist/cjs/index.js.map

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

package/dist/mjs/index.js

@@ -1,21 +1,44 @@
+/**
+ * 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];
@@ -29,9 +52,23 @@ var object = /*#__PURE__*/Object.freeze({
     hasProperty: hasProperty
 });
 
+/**
+ * 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);
 }
@@ -42,6 +79,17 @@ var type = /*#__PURE__*/Object.freeze({
     isString: isString
 });
 
+/**
+ * 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;
@@ -49,12 +97,25 @@ const minWait = (func, minTime) => {
     const ret = (...args) => {
         const rightTime = getRightTime(beginTime, minTime);
         if (rightTime)
-            window.setTimeout(() => func(...args), 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.
+ *
+ * @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 padding delay.
+ * @returns The result produced by `func`.
+ */
 async function minWaitAsync(func, minTime, abort) {
     if (!minTime)
         return func();
@@ -65,59 +126,107 @@ async function minWaitAsync(func, minTime, abort) {
         await delay(rightTime, abort);
     return result;
 }
+/** @internal */
 const getRightTime = (start, minTime) => {
     const finishTime = Date.now();
     const w = minTime - (finishTime - start);
     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 time Delay in milliseconds.
+ * @param abort Optional signal used to cancel the delay.
+ * @returns A promise that resolves when the delay elapses.
+ */
 function delay(time, abort) {
     return new Promise((resolve, reject) => {
         abort?.throwIfAborted();
         const onAbort = () => {
-            window.clearTimeout(timer);
+            clearTimeout(timer);
             reject(abort?.reason);
         };
-        const timer = window.setTimeout(() => {
+        const timer = setTimeout(() => {
             abort?.removeEventListener("abort", onAbort);
             resolve();
         }, time);
         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 timeout Timeout in milliseconds; must be greater than `0`.
+ * @param abort Optional signal used to cancel the wait.
+ * @returns A promise mirroring `promise` unless the timeout or abort fires first.
+ * @throws {Error} When `timeout` is not greater than `0`.
+ */
 function timeout(promise, timeout, abort) {
+    if (timeout <= 0)
+        throw new Error("Invalid timeout value.");
     return new Promise((resolve, reject) => {
-        if (timeout <= 0)
-            throw new Error("Invalid timeout value.");
         abort?.throwIfAborted();
         const onAbort = () => {
-            window.clearTimeout(timer);
+            clearTimeout(timer);
             reject(abort?.reason);
         };
-        const timer = window.setTimeout(() => {
+        const timer = setTimeout(() => {
             abort?.removeEventListener("abort", onAbort);
-            reject(TIMEOUT_REASON);
+            reject(new TimeoutError());
         }, timeout);
         abort?.addEventListener("abort", onAbort, { once: true });
         promise
             .then(result => resolve(result))
             .catch(reason => reject(reason))
             .finally(() => {
-            window.clearTimeout(timer);
+            clearTimeout(timer);
             abort?.removeEventListener("abort", onAbort);
         });
     });
 }
-const TIMEOUT_REASON = "Timeout";
+/** Thrown by {@link timeout} when the time limit is exceeded. */
+class TimeoutError extends Error {
+    constructor() {
+        super("Timeout");
+        this.name = "TimeoutError";
+    }
+}
 
 var func = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    TIMEOUT_REASON: TIMEOUT_REASON,
+    TimeoutError: TimeoutError,
     delay: delay,
     minWait: minWait,
     minWaitAsync: minWaitAsync,
     timeout: timeout
 });
 
+/**
+ * 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)
@@ -132,19 +241,15 @@ var word = /*#__PURE__*/Object.freeze({
     getWordEnd: getWordEnd
 });
 
-const createGuid = () => {
-    var result;
-    var i;
-    var j;
-    result = "";
-    for (j = 0; j < 32; j++) {
-        if (j == 8 || j == 12 || j == 16 || j == 20)
-            result = result + '-';
-        i = Math.floor(Math.random() * 16).toString(16).toUpperCase();
-        result = result + i;
-    }
-    return result;
-};
+/**
+ * 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";
 
 var guid = /*#__PURE__*/Object.freeze({
@@ -153,6 +258,21 @@ var guid = /*#__PURE__*/Object.freeze({
     empty: empty
 });
 
+/**
+ * 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;

package/dist/mjs/index.js.map

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

package/dist/types.d.ts

@@ -1,4 +1,23 @@
+/**
+ * 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"
+ */
 declare function getProperty(obj: any, path: string): any;
+/**
+ * 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
+ */
 declare function hasProperty(obj: any, path: string): boolean;
 
 declare const object_getProperty: typeof getProperty;
@@ -10,7 +29,21 @@ declare namespace object {
   };
 }
 
+/**
+ * Determines whether the given value is a function.
+ *
+ * @param value Value to test.
+ * @returns `true` if the value is a function, otherwise `false`.
+ */
 declare function isFunction(value: any): boolean;
+/**
+ * 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`.
+ */
 declare function isString(value: any): value is string | String;
 
 declare const type_isFunction: typeof isFunction;
@@ -22,20 +55,72 @@ declare namespace type {
   };
 }
 
+/**
+ * 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`.
+ */
 declare const minWait: (func: (...args: any[]) => void, minTime?: number) => (...args: any[]) => void;
+/**
+ * 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.
+ *
+ * @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 padding delay.
+ * @returns The result produced by `func`.
+ */
 declare function minWaitAsync<TResult = unknown>(func: () => Promise<TResult>, minTime?: number, abort?: AbortSignal): Promise<TResult>;
+/**
+ * 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 time Delay in milliseconds.
+ * @param abort Optional signal used to cancel the delay.
+ * @returns A promise that resolves when the delay elapses.
+ */
 declare function delay(time: number, abort?: AbortSignal): Promise<void>;
+/**
+ * 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 timeout Timeout in milliseconds; must be greater than `0`.
+ * @param abort Optional signal used to cancel the wait.
+ * @returns A promise mirroring `promise` unless the timeout or abort fires first.
+ * @throws {Error} When `timeout` is not greater than `0`.
+ */
 declare function timeout<T = unknown>(promise: Promise<T>, timeout: number, abort?: AbortSignal): Promise<T>;
-declare const TIMEOUT_REASON = "Timeout";
+/** Thrown by {@link timeout} when the time limit is exceeded. */
+declare class TimeoutError extends Error {
+    constructor();
+}
 
-declare const func_TIMEOUT_REASON: typeof TIMEOUT_REASON;
+type func_TimeoutError = TimeoutError;
+declare const func_TimeoutError: typeof TimeoutError;
 declare const func_delay: typeof delay;
 declare const func_minWait: typeof minWait;
 declare const func_minWaitAsync: typeof minWaitAsync;
 declare const func_timeout: typeof timeout;
 declare namespace func {
   export {
-    func_TIMEOUT_REASON as TIMEOUT_REASON,
+    func_TimeoutError as TimeoutError,
     func_delay as delay,
     func_minWait as minWait,
     func_minWaitAsync as minWaitAsync,
@@ -43,6 +128,23 @@ declare namespace func {
   };
 }
 
+/**
+ * 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, "товар", "", "а", "ов"); // "товаров"
+ */
 declare function getWordEnd(count: number, word: string, one?: string, two?: string, five?: string): string;
 
 declare const word_getWordEnd: typeof getWordEnd;
@@ -52,7 +154,15 @@ declare namespace word {
   };
 }
 
+/**
+ * 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"
+ */
 declare const createGuid: () => string;
+/** The empty (all-zero) GUID value `"00000000-0000-0000-0000-000000000000"`. */
 declare const empty = "00000000-0000-0000-0000-000000000000";
 
 declare const guid_createGuid: typeof createGuid;
@@ -66,14 +176,53 @@ declare namespace guid {
 
 declare global {
     interface String {
+        /**
+         * Formats this string by substituting `{...}` placeholders.
+         *
+         * @param args Either a single model object whose properties fill named placeholders,
+         * or positional arguments referenced by zero-based index. See {@link formatText}.
+         * @returns The formatted string.
+         * @example
+         * "Hello, {name}".format({ name: "Dmitry" }); // "Hello, Dmitry"
+         * "Hello, {0}".format("Dmitry");              // "Hello, Dmitry"
+         */
         format(...args: any[]): string;
     }
     interface ObjectConstructor {
+        /**
+         * Reads a nested property value by a dot-separated path. See {@link getProperty}.
+         *
+         * @param obj Source object.
+         * @param path Dot-separated property path, e.g. `"header.value"`.
+         * @returns The resolved value, or `undefined`/`null` when not found.
+         */
         prop(obj: any, path: string): any;
+        /**
+         * Determines whether a nested property exists at a dot-separated path. See {@link hasProperty}.
+         *
+         * @param obj Source object.
+         * @param path Dot-separated property path, e.g. `"header.value"`.
+         * @returns `true` if the property exists, otherwise `false`.
+         */
         hasProp(obj: any, path: string): boolean;
     }
 }
 
-declare function formatText(template: string, ...args: any[]): any;
+/**
+ * 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"
+ */
+declare function formatText(template: string, ...args: any[]): string;
 
 export { func as FuncHelper, guid as Guid, object as ObjectHelper, type as TypeHelper, word as WordHelper, formatText };

package/package.json

@@ -22,7 +22,7 @@
     "email": "it@brandup.online"
   },
   "license": "Apache-2.0",
-  "version": "1.0.43",
+  "version": "2.0.1",
   "main": "dist/cjs/index.js",
   "module": "dist/mjs/index.js",
   "types": "dist/types.d.ts",

package/tsconfig.json

@@ -24,7 +24,9 @@
 		"esModuleInterop": true,
 		"forceConsistentCasingInFileNames": true,
 		"skipLibCheck": true,
-		"allowSyntheticDefaultImports": true
+		"allowSyntheticDefaultImports": true,
+		"typeRoots": ["../../node_modules/@types", "./node_modules/@types"],
+		"types": ["jest"]
 	},
 	"include": [
 		"source",