@brandup/ui-helpers 2.0.1 → 2.0.3

package/dist/mjs/index.js

@@ -1,303 +1,12 @@
-/**
- * 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;
-}
-
-var object = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    getProperty: getProperty,
-    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);
-}
-
-var type = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    isFunction: isFunction,
-    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;
-    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.
- *
- * @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();
-    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);
-    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 = () => {
-            clearTimeout(timer);
-            reject(abort?.reason);
-        };
-        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) => {
-        abort?.throwIfAborted();
-        const onAbort = () => {
-            clearTimeout(timer);
-            reject(abort?.reason);
-        };
-        const timer = setTimeout(() => {
-            abort?.removeEventListener("abort", onAbort);
-            reject(new TimeoutError());
-        }, timeout);
-        abort?.addEventListener("abort", onAbort, { once: true });
-        promise
-            .then(result => resolve(result))
-            .catch(reason => reject(reason))
-            .finally(() => {
-            clearTimeout(timer);
-            abort?.removeEventListener("abort", onAbort);
-        });
-    });
-}
-/** 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,
-    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)
-        return word + (five || "");
-    const t = count % 10;
-    return (t === 1 ?
-        (word + (one || "")) : ((t >= 2 && t <= 4) ? (word + (two || "")) : (word + (five || ""))));
-}
-
-var word = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    getWordEnd: getWordEnd
-});
-
-/**
- * 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({
-    __proto__: null,
-    createGuid: createGuid,
-    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;
-    const obj = typeof args[0] === "object" ? args[0] : null;
-    return template.replace(/\{([^}]+)\}/g, (_match, key) => {
-        if (obj)
-            return getProperty(obj, key) ?? "";
-        else {
-            const paramIndex = parseInt(key);
-            if (!isNaN(paramIndex) && paramIndex < args.length)
-                return args[paramIndex] ?? "";
-        }
-        return "";
-    });
-}
-
-Object.prop = function (obj, path) {
-    return getProperty(obj, path);
-};
-Object.hasProp = function (obj, path) {
-    return hasProperty(obj, path);
-};
-String.prototype.format = function (...args) {
-    return formatText(this.toString(), ...args);
-};
-
-export { func as FuncHelper, guid as Guid, object as ObjectHelper, type as TypeHelper, word as WordHelper, formatText };
+import * as object from './helpers/object.js';
+export { object as ObjectHelper };
+import * as type from './helpers/type.js';
+export { type as TypeHelper };
+import * as func from './helpers/func.js';
+export { func as FuncHelper };
+import * as word from './helpers/word.js';
+export { word as WordHelper };
+import * as guid from './helpers/guid.js';
+export { guid as Guid };
+export { formatText } from './helpers/string.js';
 //# sourceMappingURL=index.js.map

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":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/types.d.ts

@@ -74,10 +74,13 @@ declare const minWait: (func: (...args: any[]) => void, minTime?: number) => (..
  * 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 padding delay.
+ * @param abort Optional signal used to cancel the wait.
  * @returns The result produced by `func`.
  */
 declare function minWaitAsync<TResult = unknown>(func: () => Promise<TResult>, minTime?: number, abort?: AbortSignal): Promise<TResult>;
@@ -87,11 +90,13 @@ declare function minWaitAsync<TResult = unknown>(func: () => Promise<TResult>, m
  * 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 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.
  */
-declare function delay(time: number, abort?: AbortSignal): Promise<void>;
+declare function delay(ms: number, abort?: AbortSignal): Promise<void>;
 /**
  * Races a promise against a timeout.
  *
@@ -101,12 +106,26 @@ declare function delay(time: number, abort?: AbortSignal): Promise<void>;
  *
  * @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 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 `timeout` is not greater than `0`.
+ * @throws {Error} When `ms` is not greater than `0`.
+ */
+declare function timeout<T = unknown>(promise: Promise<T>, ms: number, abort?: AbortSignal): Promise<T>;
+/**
+ * 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.
  */
-declare function timeout<T = unknown>(promise: Promise<T>, timeout: number, abort?: AbortSignal): Promise<T>;
+declare function abortable<T>(promise: PromiseLike<T>, abort?: AbortSignal): Promise<T>;
 /** Thrown by {@link timeout} when the time limit is exceeded. */
 declare class TimeoutError extends Error {
     constructor();
@@ -114,6 +133,7 @@ declare class TimeoutError extends Error {
 
 type func_TimeoutError = TimeoutError;
 declare const func_TimeoutError: typeof TimeoutError;
+declare const func_abortable: typeof abortable;
 declare const func_delay: typeof delay;
 declare const func_minWait: typeof minWait;
 declare const func_minWaitAsync: typeof minWaitAsync;
@@ -121,6 +141,7 @@ declare const func_timeout: typeof timeout;
 declare namespace func {
   export {
     func_TimeoutError as TimeoutError,
+    func_abortable as abortable,
     func_delay as delay,
     func_minWait as minWait,
     func_minWaitAsync as minWaitAsync,
@@ -174,40 +195,6 @@ 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;
-    }
-}
-
 /**
  * Formats a template string by substituting `{...}` placeholders.
  *

package/package.json

@@ -22,10 +22,18 @@
     "email": "it@brandup.online"
   },
   "license": "Apache-2.0",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "main": "dist/cjs/index.js",
   "module": "dist/mjs/index.js",
   "types": "dist/types.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/mjs/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
   "files": [
     "dist",
     "tsconfig.json",