@lipemat/js-helpers 1.0.0

package/dist/error/error.js

@@ -0,0 +1,33 @@
+/**
+ * Use in place from the default Error handler to include
+ * information about form fields which caused the errors.
+ *
+ * Translates `WP_Error` responses from REST API into
+ * field name and their corresponding messages.
+ *
+ * @version 1.2.1
+ */
+export class ErrorWithFields extends Error {
+    fields;
+    constructor(error) {
+        const errors = [error];
+        if (undefined !== error.additional_errors) {
+            errors.push(...error.additional_errors);
+        }
+        super(errors.map(er => er.message).join(' '));
+        this.name = 'ErrorWithData';
+        this.fields = {};
+        errors.forEach(field => {
+            this.fields[this.translate(field).code] = field.message;
+        });
+    }
+    translate(error) {
+        error.code = error.code
+            .toString()
+            .replace('user_name', 'username')
+            .replace('user_email', 'email')
+            .replace('rest_user_invalid_email', 'email');
+        return error;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error/error.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAyD,SAAQ,KAAK;IAC3E,MAAM,CAAY;IAEzB,YAAa,KAAoB;QAChC,MAAM,MAAM,GAAG,CAAE,KAAK,CAAE,CAAC;QACzB,IAAK,SAAS,KAAK,KAAK,CAAC,iBAAiB,EAAG,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAE,GAAG,KAAK,CAAC,iBAAiB,CAAE,CAAC;QAC3C,CAAC;QAED,KAAK,CAAE,MAAM,CAAC,GAAG,CAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAE,CAAC,IAAI,CAAE,GAAG,CAAE,CAAE,CAAC;QAEpD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,MAAM,CAAC,OAAO,CAAE,KAAK,CAAC,EAAE;YACvB,IAAI,CAAC,MAAM,CAAE,IAAI,CAAC,SAAS,CAAE,KAAK,CAAE,CAAC,IAAI,CAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7D,CAAC,CAAE,CAAC;IACL,CAAC;IAED,SAAS,CAAE,KAAoB;QAC9B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;aACrB,QAAQ,EAAE;aACV,OAAO,CAAE,WAAW,EAAE,UAAU,CAAE;aAClC,OAAO,CAAE,YAAY,EAAE,OAAO,CAAE;aAChC,OAAO,CAAE,yBAAyB,EAAE,OAAO,CAAE,CAAC;QAEhD,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

package/dist/escaping/escaping.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Taken nearly verbatim from the Gutenberg package.
+ *
+ * Added to the helpers in case we are
+ * not loading wp-html-entities on the front-end.
+ *
+ * @notice We likely are loading wp-html-entities unless a special project.
+ *
+ * @see @wordpress/html-entities
+ *
+ * @version 1.0.5
+ *
+ * @link https://github.com/WordPress/gutenberg/blob/d5915916abc45e6682f4bdb70888aa41e98aa395/packages/html-entities/src/index.js#L14
+ * @param  html
+ */
+export declare function decodeEntities(html: string): string;
+//# sourceMappingURL=escaping.d.ts.map

package/dist/escaping/escaping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escaping.d.ts","sourceRoot":"","sources":["../../src/escaping/escaping.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAE,IAAI,EAAE,MAAM,UAqB3C"}

package/dist/escaping/escaping.js

@@ -0,0 +1,39 @@
+import DOMPurify from 'dompurify';
+let _decodeTextArea;
+/**
+ * Taken nearly verbatim from the Gutenberg package.
+ *
+ * Added to the helpers in case we are
+ * not loading wp-html-entities on the front-end.
+ *
+ * @notice We likely are loading wp-html-entities unless a special project.
+ *
+ * @see @wordpress/html-entities
+ *
+ * @version 1.0.5
+ *
+ * @link https://github.com/WordPress/gutenberg/blob/d5915916abc45e6682f4bdb70888aa41e98aa395/packages/html-entities/src/index.js#L14
+ * @param  html
+ */
+export function decodeEntities(html) {
+    // Not a string, or no entities to decode.
+    if (-1 === html.indexOf('&')) {
+        return html;
+    }
+    // Create a textarea for decoding entities, that we can reuse.
+    if (undefined === _decodeTextArea) {
+        if (undefined !== document.implementation) {
+            _decodeTextArea = document.implementation
+                .createHTMLDocument('')
+                .createElement('textarea');
+        }
+        else {
+            _decodeTextArea = document.createElement('textarea');
+        }
+    }
+    _decodeTextArea.innerHTML = DOMPurify.sanitize(html);
+    const decoded = _decodeTextArea.textContent;
+    _decodeTextArea.innerHTML = '';
+    return (decoded);
+}
+//# sourceMappingURL=escaping.js.map

package/dist/escaping/escaping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escaping.js","sourceRoot":"","sources":["../../src/escaping/escaping.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,IAAI,eAAoC,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAE,IAAY;IAC3C,0CAA0C;IAC1C,IAAK,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,CAAE,GAAG,CAAE,EAAG,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,8DAA8D;IAC9D,IAAK,SAAS,KAAK,eAAe,EAAG,CAAC;QACrC,IAAK,SAAS,KAAK,QAAQ,CAAC,cAAc,EAAG,CAAC;YAC7C,eAAe,GAAG,QAAQ,CAAC,cAAc;iBACvC,kBAAkB,CAAE,EAAE,CAAE;iBACxB,aAAa,CAAE,UAAU,CAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACP,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAE,UAAU,CAAE,CAAC;QACxD,CAAC;IACF,CAAC;IAED,eAAe,CAAC,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAE,IAAI,CAAE,CAAC;IACvD,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC;IAC5C,eAAe,CAAC,SAAS,GAAG,EAAE,CAAC;IAC/B,OAAO,CAAE,OAAO,CAAE,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Public entry point for `@lipemat/js-helpers`.
+ *
+ * Re-exports the public API of every helper so consumers can use
+ * `import {<helper>} from '@lipemat/js-helpers'`.
+ */
+export * from './classes/classes.js';
+export * from './colors/colors.js';
+export * from './csvExport/csvExport.js';
+export * from './date/date.js';
+export * from './debounce/debounce.js';
+export * from './delay/delay.js';
+export * from './device/device.js';
+export * from './dom-ready/dom-ready.js';
+export * from './error/error.js';
+export * from './escaping/escaping.js';
+export * from './injectScript/injectScript.js';
+export * from './memoize/memoize.js';
+export * from './noop/noop.js';
+export * from './objects/objects.js';
+export * from './once/once.js';
+export * from './string/string.js';
+export * from './throttle/throttle.js';
+export * from './url/url.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * Public entry point for `@lipemat/js-helpers`.
+ *
+ * Re-exports the public API of every helper so consumers can use
+ * `import {<helper>} from '@lipemat/js-helpers'`.
+ */
+export * from './classes/classes.js';
+export * from './colors/colors.js';
+export * from './csvExport/csvExport.js';
+export * from './date/date.js';
+export * from './debounce/debounce.js';
+export * from './delay/delay.js';
+export * from './device/device.js';
+export * from './dom-ready/dom-ready.js';
+export * from './error/error.js';
+export * from './escaping/escaping.js';
+export * from './injectScript/injectScript.js';
+export * from './memoize/memoize.js';
+export * from './noop/noop.js';
+export * from './objects/objects.js';
+export * from './once/once.js';
+export * from './string/string.js';
+export * from './throttle/throttle.js';
+export * from './url/url.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

package/dist/injectScript/injectScript.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Inject a script into the DOM.
+ *
+ * May be called multiple times and will ony inject the script once.
+ *
+ * @param {string}  $src    - URL of the script.
+ * @param {boolean} $inBody - Put in body tag instead of head
+ *
+ * @version 1.2.1
+ *
+ * @return {Promise}
+ */
+export declare const injectScript: import("../memoize/memoize.js").MemoizedFunction<(src: any, inBody?: boolean) => Promise<unknown>>;
+//# sourceMappingURL=injectScript.d.ts.map

package/dist/injectScript/injectScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectScript.d.ts","sourceRoot":"","sources":["../../src/injectScript/injectScript.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,uEAA2B,OAAO,sBAgBxD,CAAC"}

package/dist/injectScript/injectScript.js

@@ -0,0 +1,30 @@
+import { memoize } from '../memoize/memoize.js';
+/**
+ * Inject a script into the DOM.
+ *
+ * May be called multiple times and will ony inject the script once.
+ *
+ * @param {string}  $src    - URL of the script.
+ * @param {boolean} $inBody - Put in body tag instead of head
+ *
+ * @version 1.2.1
+ *
+ * @return {Promise}
+ */
+export const injectScript = memoize((src, inBody = false) => {
+    return new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.async = false;
+        script.src = src;
+        script.addEventListener('load', () => resolve('Loaded: ' + src));
+        script.addEventListener('error', () => reject('Error loading script.'));
+        script.addEventListener('abort', () => reject('Script loading aborted.'));
+        if (inBody) {
+            document.body.appendChild(script);
+        }
+        else {
+            document.head.appendChild(script);
+        }
+    });
+});
+//# sourceMappingURL=injectScript.js.map

package/dist/injectScript/injectScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectScript.js","sourceRoot":"","sources":["../../src/injectScript/injectScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,uBAAuB,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAE,CAAE,GAAG,EAAE,SAAkB,KAAK,EAAG,EAAE;IACvE,OAAO,IAAI,OAAO,CAAE,CAAE,OAAO,EAAE,MAAM,EAAG,EAAE;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAE,QAAQ,CAAE,CAAC;QAClD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;QACjB,MAAM,CAAC,gBAAgB,CAAE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAE,UAAU,GAAG,GAAG,CAAE,CAAE,CAAC;QACrE,MAAM,CAAC,gBAAgB,CAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAE,uBAAuB,CAAE,CAAE,CAAC;QAC5E,MAAM,CAAC,gBAAgB,CAAE,OAAO,EAAE,GAAG,EAAE,CACtC,MAAM,CAAE,yBAAyB,CAAE,CACnC,CAAC;QACF,IAAK,MAAM,EAAG,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAE,MAAM,CAAE,CAAC;QACrC,CAAC;aAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAE,MAAM,CAAE,CAAC;QACrC,CAAC;IACF,CAAC,CAAE,CAAC;AACL,CAAC,CAAE,CAAC"}

package/dist/memoize/memoize.d.ts

@@ -0,0 +1,13 @@
+import type { Callback, Return } from '../once/once.js';
+type Resolver<T extends Callback> = (...args: Parameters<T>) => string;
+export type MemoizedFunction<T extends Callback> = Return<T> & {
+    cache: Map<string, ReturnType<T>>;
+};
+/**
+ * Similar to lodash memoize but without requiring lodash.
+ *
+ * @version 1.1.3
+ */
+export declare function memoize<T extends Callback>(fn: T, resolver?: Resolver<T>): MemoizedFunction<T>;
+export {};
+//# sourceMappingURL=memoize.d.ts.map

package/dist/memoize/memoize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.d.ts","sourceRoot":"","sources":["../../src/memoize/memoize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAE,MAAM,EAAC,MAAM,iBAAiB,CAAC;AAEtD,KAAK,QAAQ,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAM,MAAM,CAAC;AAEzE,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;IAC9D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,QAAQ,EAAG,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAI,gBAAgB,CAAC,CAAC,CAAC,CAahG"}

package/dist/memoize/memoize.js

@@ -0,0 +1,19 @@
+/**
+ * Similar to lodash memoize but without requiring lodash.
+ *
+ * @version 1.1.3
+ */
+export function memoize(fn, resolver) {
+    const memoized = function (...args) {
+        const key = resolver ? resolver(...args) : args[0];
+        if (memoized.cache.has(key)) {
+            return memoized.cache.get(key);
+        }
+        const result = fn(...args);
+        memoized.cache = memoized.cache.set(key, result);
+        return result;
+    };
+    memoized.cache = new Map();
+    return memoized;
+}
+//# sourceMappingURL=memoize.js.map

package/dist/memoize/memoize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.js","sourceRoot":"","sources":["../../src/memoize/memoize.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAsB,EAAK,EAAE,QAAsB;IACzE,MAAM,QAAQ,GAAG,UAAU,GAAG,IAAmB;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAE,GAAG,IAAI,CAAE,CAAC,CAAC,CAAC,IAAI,CAAE,CAAC,CAAE,CAAC;QACvD,IAAK,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAE,GAAG,CAAE,EAAG,CAAC;YACjC,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAE,GAAG,CAAE,CAAC;QAClC,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAE,GAAG,IAAI,CAAE,CAAC;QAC7B,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAE,GAAG,EAAE,MAAM,CAAE,CAAC;QACnD,OAAO,MAAM,CAAC;IACf,CAAC,CAAC;IACF,QAAQ,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/noop/noop.d.ts

@@ -0,0 +1,9 @@
+/**
+ * No operation function.
+ *
+ * Similar to lodash noop but without requiring lodash.
+ *
+ * @version 1.0.0
+ */
+export declare const noop: () => void;
+//# sourceMappingURL=noop.d.ts.map

package/dist/noop/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../src/noop/noop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,YAChB,CAAC"}

package/dist/noop/noop.js

@@ -0,0 +1,10 @@
+/**
+ * No operation function.
+ *
+ * Similar to lodash noop but without requiring lodash.
+ *
+ * @version 1.0.0
+ */
+export const noop = () => {
+};
+//# sourceMappingURL=noop.js.map

package/dist/noop/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../src/noop/noop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE;AACzB,CAAC,CAAC"}

package/dist/objects/objects.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @notice More robust versions are available from the `@lipemat/js-boilerplate-gutenberg` package.
+ */
+/**
+ * Object.keys() with type inference.
+ *
+ * Instead of getting `string[]` we get `keyof T[]`.
+ *
+ * @since 4.3.0
+ */
+export declare function keysOf<T extends object>(obj: T): Array<keyof T>;
+/**
+ * Object.entries() with type inference.
+ *
+ * Instead of getting `Array<[string, any]>` we get `Array<[keyof T, T[keyof T]]>`.
+ *
+ * @since 4.3.0
+ */
+export declare function entriesOf<T extends object>(obj: T): Array<[keyof T, T[keyof T]]>;
+//# sourceMappingURL=objects.d.ts.map

package/dist/objects/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/objects/objects.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAG,GAAG,EAAE,CAAC,GAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAEjE;AAGD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAG,GAAG,EAAE,CAAC,GAAI,KAAK,CAAC,CAAE,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAEpF"}

package/dist/objects/objects.js

@@ -0,0 +1,24 @@
+/**
+ * @notice More robust versions are available from the `@lipemat/js-boilerplate-gutenberg` package.
+ */
+/**
+ * Object.keys() with type inference.
+ *
+ * Instead of getting `string[]` we get `keyof T[]`.
+ *
+ * @since 4.3.0
+ */
+export function keysOf(obj) {
+    return Object.keys(obj);
+}
+/**
+ * Object.entries() with type inference.
+ *
+ * Instead of getting `Array<[string, any]>` we get `Array<[keyof T, T[keyof T]]>`.
+ *
+ * @since 4.3.0
+ */
+export function entriesOf(obj) {
+    return Object.entries(obj);
+}
+//# sourceMappingURL=objects.js.map

package/dist/objects/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/objects/objects.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAoB,GAAM;IAC/C,OAAO,MAAM,CAAC,IAAI,CAAE,GAAG,CAAoB,CAAC;AAC7C,CAAC;AAGD;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAoB,GAAM;IAClD,OAAO,MAAM,CAAC,OAAO,CAAE,GAAG,CAAoC,CAAC;AAChE,CAAC"}

package/dist/once/once.d.ts

@@ -0,0 +1,9 @@
+export type Callback = (...args: Array<any>) => any;
+export type Return<T extends Callback> = (...args: Parameters<T>) => ReturnType<T>;
+/**
+ * Similar to lodash once but without requiring lodash.
+ *
+ * @version 1.0.2
+ */
+export declare function once<T extends Callback>(fn: T): Return<T>;
+//# sourceMappingURL=once.d.ts.map

package/dist/once/once.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"once.d.ts","sourceRoot":"","sources":["../../src/once/once.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,CAAE,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAM,GAAG,CAAC;AACtD,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAM,UAAU,CAAC,CAAC,CAAC,CAAA;AAEpF;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAG,EAAE,EAAE,CAAC,GAAI,MAAM,CAAC,CAAC,CAAC,CAY3D"}

package/dist/once/once.js

@@ -0,0 +1,17 @@
+/**
+ * Similar to lodash once but without requiring lodash.
+ *
+ * @version 1.0.2
+ */
+export function once(fn) {
+    let result;
+    let called = false;
+    return (...args) => {
+        if (!called) {
+            called = true;
+            result = fn(...args);
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=once.js.map

package/dist/once/once.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../../src/once/once.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAsB,EAAK;IAC9C,IAAI,MAAqB,CAAC;IAC1B,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO,CAAE,GAAG,IAAmB,EAAG,EAAE;QACnC,IAAK,CAAE,MAAM,EAAG,CAAC;YAChB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,GAAG,EAAE,CAAE,GAAG,IAAI,CAAE,CAAC;QACxB,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC,CAAC;AACH,CAAC"}

package/dist/string/string.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @notice More robust versions are available from the `@lipemat/js-boilerplate-gutenberg` package.
+ */
+/**
+ * Generate a random key of a given length.
+ *
+ * @version 1.0.0
+ */
+export declare function generateRandomKey(length?: number): string;
+/**
+ * Adds a leading slash to a URL if it doesn't already have one.
+ *
+ * @version 1.0.0
+ */
+export declare function addLeadingSlash(url: string): string;
+/**
+ * Adds a trailing slash to a URL if it doesn't already have one.
+ *
+ * @version 1.0.0
+ */
+export declare function addTrailingSlash(url: string): string;
+/**
+ * Removes a leading slash from a URL if it has one.
+ *
+ * @version 1.0.0
+ */
+export declare function removeLeadingSlash(url: string): string;
+/**
+ * Removes a trailing slash from a URL if it has one.
+ *
+ * @version 1.0.0
+ */
+export declare function removeTrailingSlash(url: string): string;
+//# sourceMappingURL=string.d.ts.map

package/dist/string/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/string/string.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAE,MAAM,GAAE,MAAW,UAOrD;AAGD;;;;GAIG;AACH,wBAAgB,eAAe,CAAE,GAAG,EAAE,MAAM,GAAI,MAAM,CAMrD;AAGD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAE,GAAG,EAAE,MAAM,GAAI,MAAM,CAMtD;AAGD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAE,GAAG,EAAE,MAAM,GAAI,MAAM,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAE,GAAG,EAAE,MAAM,GAAI,MAAM,CAMzD"}

package/dist/string/string.js

@@ -0,0 +1,65 @@
+/**
+ * @notice More robust versions are available from the `@lipemat/js-boilerplate-gutenberg` package.
+ */
+/**
+ * Generate a random key of a given length.
+ *
+ * @version 1.0.0
+ */
+export function generateRandomKey(length = 10) {
+    const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += characters.charAt(Math.floor(Math.random() * characters.length));
+    }
+    return result;
+}
+/**
+ * Adds a leading slash to a URL if it doesn't already have one.
+ *
+ * @version 1.0.0
+ */
+export function addLeadingSlash(url) {
+    const trimmedURL = url.trim();
+    if ('' === trimmedURL) {
+        return url;
+    }
+    return url?.replace(/^\/?/, '/');
+}
+/**
+ * Adds a trailing slash to a URL if it doesn't already have one.
+ *
+ * @version 1.0.0
+ */
+export function addTrailingSlash(url) {
+    const trimmedURL = url.trim();
+    if ('' === trimmedURL) {
+        return url;
+    }
+    return url.replace(/\/?$/, '/');
+}
+/**
+ * Removes a leading slash from a URL if it has one.
+ *
+ * @version 1.0.0
+ */
+export function removeLeadingSlash(url) {
+    const trimmedURL = url.trim();
+    if ('' === trimmedURL) {
+        return url;
+    }
+    return url.replace(/^\//, '');
+}
+/**
+ * Removes a trailing slash from a URL if it has one.
+ *
+ * @version 1.0.0
+ */
+export function removeTrailingSlash(url) {
+    const trimmedURL = url.trim();
+    if ('' === trimmedURL) {
+        return url;
+    }
+    return url.replace(/\/$/, '');
+}
+//# sourceMappingURL=string.js.map

package/dist/string/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/string/string.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAE,SAAiB,EAAE;IACrD,MAAM,UAAU,GAAG,gEAAgE,CAAC;IACpF,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAG,CAAC;QACnC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAE,IAAI,CAAC,KAAK,CAAE,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAE,CAAE,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAGD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAE,GAAW;IAC3C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAK,EAAE,KAAK,UAAU,EAAG,CAAC;QACzB,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,EAAE,OAAO,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;AACpC,CAAC;AAGD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAE,GAAW;IAC5C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAK,EAAE,KAAK,UAAU,EAAG,CAAC;QACzB,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;AACnC,CAAC;AAGD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAE,GAAW;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAK,EAAE,KAAK,UAAU,EAAG,CAAC;QACzB,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAE,KAAK,EAAE,EAAE,CAAE,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAE,GAAW;IAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAK,EAAE,KAAK,UAAU,EAAG,CAAC;QACzB,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAE,KAAK,EAAE,EAAE,CAAE,CAAC;AACjC,CAAC"}

package/dist/throttle/throttle.d.ts

@@ -0,0 +1,17 @@
+import type { Callback } from '../once/once.js';
+type Result<T extends Callback> = {
+    (...args: Parameters<T>): ReturnType<T>;
+    immediate: (...args: Parameters<T>) => ReturnType<T>;
+    cancel: () => void;
+};
+/**
+ * Alternative to lodash throttle.
+ *
+ * - Additional support for `immediate` execution to bypass the wait time.
+ * - Returns a promise to allow waiting for a completion of the throttled function.
+ *
+ * @version 1.0.1
+ */
+export declare function throttle<T extends Callback>(fn: T, wait?: number): Result<T>;
+export {};
+//# sourceMappingURL=throttle.d.ts.map

package/dist/throttle/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/throttle/throttle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAS,MAAM,iBAAiB,CAAC;AAEtD,KAAK,MAAM,CAAC,CAAC,SAAS,QAAQ,IAAI;IACjC,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1C,SAAS,EAAE,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAM,UAAU,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAG,EAAE,EAAE,CAAC,EAAE,IAAI,SAAM,GAAI,MAAM,CAAC,CAAC,CAAC,CAwC3E"}

package/dist/throttle/throttle.js

@@ -0,0 +1,43 @@
+/**
+ * Alternative to lodash throttle.
+ *
+ * - Additional support for `immediate` execution to bypass the wait time.
+ * - Returns a promise to allow waiting for a completion of the throttled function.
+ *
+ * @version 1.0.1
+ */
+export function throttle(fn, wait = 300) {
+    let lastTime = 0;
+    let timer;
+    let result;
+    const throttled = function (...args) {
+        const now = Date.now();
+        const remaining = now - lastTime;
+        if (remaining >= wait) {
+            clearTimeout(timer);
+            timer = undefined;
+            lastTime = now;
+            return fn(...args);
+        }
+        if ('undefined' === typeof timer) {
+            timer = setTimeout(() => {
+                lastTime = Date.now();
+                result = fn(...args);
+                timer = undefined;
+            }, wait - remaining);
+        }
+        return result;
+    };
+    // Immediate execution method.
+    throttled.immediate = function (...args) {
+        clearTimeout(timer);
+        lastTime = Date.now();
+        return fn(...args);
+    };
+    // Cancel method.
+    throttled.cancel = function () {
+        clearTimeout(timer);
+    };
+    return throttled;
+}
+//# sourceMappingURL=throttle.js.map

package/dist/throttle/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/throttle/throttle.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAsB,EAAK,EAAE,IAAI,GAAG,GAAG;IAC9D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAA0C,CAAC;IAC/C,IAAI,MAAqB,CAAC;IAE1B,MAAM,SAAS,GAAG,UAAU,GAAG,IAAmB;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,GAAG,GAAG,QAAQ,CAAC;QAEjC,IAAK,SAAS,IAAI,IAAI,EAAG,CAAC;YACzB,YAAY,CAAE,KAAK,CAAE,CAAC;YACtB,KAAK,GAAG,SAAS,CAAC;YAClB,QAAQ,GAAG,GAAG,CAAC;YACf,OAAO,EAAE,CAAE,GAAG,IAAI,CAAE,CAAC;QACtB,CAAC;QAED,IAAK,WAAW,KAAK,OAAO,KAAK,EAAG,CAAC;YACpC,KAAK,GAAG,UAAU,CAAE,GAAG,EAAE;gBACxB,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACtB,MAAM,GAAG,EAAE,CAAE,GAAG,IAAI,CAAE,CAAC;gBACvB,KAAK,GAAG,SAAS,CAAC;YACnB,CAAC,EAAE,IAAI,GAAG,SAAS,CAAE,CAAC;QACvB,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC,CAAC;IAEF,8BAA8B;IAC9B,SAAS,CAAC,SAAS,GAAG,UAAU,GAAG,IAAmB;QACrD,YAAY,CAAE,KAAK,CAAE,CAAC;QACtB,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,OAAO,EAAE,CAAE,GAAG,IAAI,CAAE,CAAC;IACtB,CAAC,CAAC;IAEF,iBAAiB;IACjB,SAAS,CAAC,MAAM,GAAG;QAClB,YAAY,CAAE,KAAK,CAAE,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO,SAAsB,CAAC;AAC/B,CAAC"}

package/dist/url/url.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @notice More robust versions are available from the `@lipemat/js-boilerplate-gutenberg` package.
+ *
+ * @notice More URL helpers are available within `@wordpress/url` package
+ *         when being used in the admin or when added as a dependency.
+ */
+/**
+ * @see @lipemat/js-boilerplate-gutenberg{getQueryArg} for more robust version.
+ */
+export declare function getUrlParam(parameter: string, defaultValue?: string): string | null;
+/**
+ * @see @lipemat/js-boilerplate-gutenberg{addQueryArgs} for more robust version.
+ */
+export declare function addQueryArgs(url: string | undefined, args: {
+    [name: string]: string | number;
+}): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/url/url.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAC1B,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,MAAW,GACvB,MAAM,GAAG,IAAI,CAOf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAE,GAAG,EAAE,MAAM,YAAK,EAAE,IAAI,EAAE;IAAE,CAAE,IAAI,EAAE,MAAM,GAAI,MAAM,GAAG,MAAM,CAAA;CAAE,UAO1F"}

package/dist/url/url.js

@@ -0,0 +1,28 @@
+import DOMPurify from 'dompurify';
+/**
+ * @notice More robust versions are available from the `@lipemat/js-boilerplate-gutenberg` package.
+ *
+ * @notice More URL helpers are available within `@wordpress/url` package
+ *         when being used in the admin or when added as a dependency.
+ */
+/**
+ * @see @lipemat/js-boilerplate-gutenberg{getQueryArg} for more robust version.
+ */
+export function getUrlParam(parameter, defaultValue = '') {
+    const urlParams = new URLSearchParams(DOMPurify.sanitize(window.location.search));
+    if (urlParams.has(parameter)) {
+        return urlParams.get(parameter);
+    }
+    return defaultValue;
+}
+/**
+ * @see @lipemat/js-boilerplate-gutenberg{addQueryArgs} for more robust version.
+ */
+export function addQueryArgs(url = '', args) {
+    const path = new URL(url);
+    Object.keys(args).forEach(arg => {
+        path.searchParams.append(DOMPurify.sanitize(arg), args[arg].toString());
+    });
+    return path.toString();
+}
+//# sourceMappingURL=url.js.map

package/dist/url/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/url/url.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,WAAW,CAC1B,SAAiB,EACjB,eAAuB,EAAE;IAEzB,MAAM,SAAS,GAAG,IAAI,eAAe,CAAE,SAAS,CAAC,QAAQ,CAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAE,CAAE,CAAC;IAEtF,IAAK,SAAS,CAAC,GAAG,CAAE,SAAS,CAAE,EAAG,CAAC;QAClC,OAAO,SAAS,CAAC,GAAG,CAAE,SAAS,CAAE,CAAC;IACnC,CAAC;IACD,OAAO,YAAY,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAE,MAAc,EAAE,EAAE,IAA2C;IAC1F,MAAM,IAAI,GAAG,IAAI,GAAG,CAAE,GAAG,CAAE,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC,OAAO,CAAE,GAAG,CAAC,EAAE;QAClC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAE,SAAS,CAAC,QAAQ,CAAE,GAAG,CAAE,EAAE,IAAI,CAAE,GAAG,CAAE,CAAC,QAAQ,EAAE,CAAE,CAAC;IAC/E,CAAC,CAAE,CAAC;IAEJ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}