@codeleap/utils 6.8.0 → 7.0.1

package/dist/array.js

@@ -0,0 +1,60 @@
+/**
+ * Indexes an array into an object keyed by a derived value.
+ *
+ * `keyAccessor` may be a property name string or a callback that returns a
+ * key. When omitted, array indices are used as keys. Duplicate keys silently
+ * overwrite earlier entries.
+ */
+export function objectFromArray(arr, keyAccessor) {
+    let getObjectKey = (_, idx) => idx;
+    if (keyAccessor) {
+        switch (typeof keyAccessor) {
+            case 'string':
+                getObjectKey = (value) => value[keyAccessor];
+                break;
+            case 'function':
+                getObjectKey = keyAccessor;
+                break;
+        }
+    }
+    const indexedMap = arr.map((value, idx) => [getObjectKey(value, idx), value]);
+    return Object.fromEntries(indexedMap);
+}
+/**
+ * Returns a deduplicated copy of `array` where uniqueness is determined by
+ * the value returned from `getProperty`.
+ *
+ * When duplicates exist, the **last** occurrence wins because `objectFromArray`
+ * overwrites earlier entries with the same key.
+ */
+export function uniqueArrayByProperty(array, getProperty) {
+    return Object.values(objectFromArray(array, getProperty));
+}
+/**
+ * Recursively flattens a nested array of arbitrary depth into a single-level array.
+ *
+ * Unlike `Array.prototype.flat(Infinity)`, this implementation does not rely on
+ * native flat support and works identically across all environments.
+ */
+export function flatten(arr) {
+    let newArr = [];
+    arr.forEach((item) => {
+        if (Array.isArray(item)) {
+            newArr = [...newArr, ...flatten(item)];
+        }
+        else {
+            newArr.push(item);
+        }
+    });
+    return newArr;
+}
+/**
+ * Returns an inclusive integer array from `start` to `end`.
+ *
+ * Both bounds are included: `range(1, 3)` → `[1, 2, 3]`.
+ */
+export function range(start, end) {
+    const length = end - start + 1;
+    return Array.from({ length }, (_, index) => index + start);
+}
+//# sourceMappingURL=array.js.map

package/dist/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAQ,EACR,WAAoB;IAEpB,IAAI,YAAY,GAA+C,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAA;IAE9E,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,OAAO,WAAW,EAAE,CAAC;YAC3B,KAAK,QAAQ;gBACX,YAAY,GAAG,CAAC,KAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,WAAsB,CAA+B,CAAA;gBACxF,MAAK;YACP,KAAK,UAAU;gBACb,YAAY,GAAG,WAAyD,CAAA;gBACxE,MAAK;QACT,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;IAE7E,OAAO,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAU,EACV,WAAc;IAEd,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAoB,GAAQ;IACjD,IAAI,MAAM,GAAG,EAAS,CAAA;IAEtB,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACnB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACxC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW;IAC9C,MAAM,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG,CAAC,CAAA;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAA;AAC5D,CAAC"}

package/dist/cloneDeep.js

@@ -0,0 +1,44 @@
+/**
+ * Produces a full recursive clone of `value` without any external dependencies.
+ *
+ * Supported types: primitives (returned as-is), plain objects, arrays, `Date`,
+ * `Map`, `Set`, and `RegExp`. Class instances with prototype methods beyond
+ * these built-ins are cloned as plain objects — prototype chain is not preserved.
+ * Circular references will cause a stack overflow.
+ */
+export function cloneDeep(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(cloneDeep);
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (value instanceof Map) {
+        const clonedMap = new Map();
+        value.forEach((v, k) => {
+            clonedMap.set(k, cloneDeep(v));
+        });
+        return clonedMap;
+    }
+    if (value instanceof Set) {
+        const clonedSet = new Set();
+        value.forEach((v) => {
+            clonedSet.add(cloneDeep(v));
+        });
+        return clonedSet;
+    }
+    if (value instanceof RegExp) {
+        return new RegExp(value.source, value.flags);
+    }
+    const clonedObj = {};
+    for (const key in value) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+            clonedObj[key] = cloneDeep(value[key]);
+        }
+    }
+    return clonedObj;
+}
+//# sourceMappingURL=cloneDeep.js.map

package/dist/cloneDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneDeep.js","sourceRoot":"","sources":["../src/cloneDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAU,KAAQ;IACzC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAiB,CAAA;IAC7C,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAiB,CAAA;IAClD,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAA;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAChC,CAAC,CAAC,CAAA;QACF,OAAO,SAAyB,CAAA;IAClC,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAA;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAClB,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;QACF,OAAO,SAAyB,CAAA;IAClC,CAAC;IAED,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAiB,CAAA;IAC9D,CAAC;IAED,MAAM,SAAS,GAA4B,EAAE,CAAA;IAE7C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACrD,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED,OAAO,SAAyB,CAAA;AAClC,CAAC"}

package/dist/colors.js

@@ -0,0 +1,57 @@
+import tinycolor from 'tinycolor2';
+import { TypeGuards } from '@codeleap/types';
+/**
+ * Parses a 6-digit hex colour string (with or without leading `#`) into its
+ * `{ r, g, b }` components.
+ *
+ * Returns `null` for invalid or short (3-digit) hex values.
+ */
+export function hexToRgb(hex) {
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    return result
+        ? {
+            r: parseInt(result[1], 16),
+            g: parseInt(result[2], 16),
+            b: parseInt(result[3], 16),
+        }
+        : null;
+}
+const shadeColorCache = {};
+/**
+ * Lightens or darkens `color` by `percent` and optionally applies `opacity`,
+ * returning an `rgba(...)` string.
+ *
+ * - Positive `percent` → lighten; negative → darken (magnitude is used).
+ * - `opacity` must be in the `0–1` range (passed directly to tinycolor's `setAlpha`).
+ * - Results are memoised in a module-level cache keyed by the serialised parameters,
+ *   so repeated calls with identical arguments are effectively free.
+ */
+export function shadeColor(color, percent = 0, opacity = null) {
+    const _color = color.trim();
+    const serialParams = [_color, percent.toString()];
+    if (TypeGuards.isNumber(opacity)) {
+        serialParams.push(opacity.toString());
+    }
+    const cacheKey = serialParams.join('/');
+    if (!!shadeColorCache[cacheKey]) {
+        return shadeColorCache[cacheKey];
+    }
+    const cl = tinycolor(_color);
+    if (percent !== 0) {
+        const shouldDarken = percent < 0;
+        if (shouldDarken) {
+            cl.darken(-percent);
+        }
+        else {
+            cl.lighten(percent);
+        }
+    }
+    if (TypeGuards.isNumber(opacity)) {
+        cl.setAlpha(opacity);
+    }
+    const rgbObj = cl.toRgb();
+    const rgbStr = `rgba(${rgbObj.r},${rgbObj.g},${rgbObj.b},${rgbObj.a})`;
+    shadeColorCache[cacheKey] = rgbStr;
+    return rgbStr;
+}
+//# sourceMappingURL=colors.js.map

package/dist/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,MAAM,GAAG,2CAA2C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACpE,OAAO,MAAM;QACX,CAAC,CAAC;YACA,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1B,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1B,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;SAC3B;QACD,CAAC,CAAC,IAAI,CAAA;AACV,CAAC;AAED,MAAM,eAAe,GAA2B,EAAE,CAAA;AAElD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAO,GAAG,CAAC,EAAE,UAAyB,IAAI;IAClF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IACjD,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvC,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEvC,IAAI,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAC5B,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAElB,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,CAAA;QAEhC,IAAI,YAAY,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;QACrB,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEtB,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,CAAA;IACzB,MAAM,MAAM,GAAG,QAAQ,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAA;IACtE,eAAe,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAA;IAClC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/date.js

@@ -0,0 +1,26 @@
+import dayjs from 'dayjs';
+const removeTimezoneAndFormat = (date, format = 'YYYY-MM-DD') => {
+    if (!date)
+        return '';
+    let normalizedDate = date;
+    if (date instanceof Date) {
+        normalizedDate = date.toISOString().split('T')[0] + 'T12:00:00';
+    }
+    else if (typeof date === 'string' && date.includes('T')) {
+        normalizedDate = date.split('T')[0] + 'T12:00:00';
+    }
+    return dayjs(normalizedDate).startOf('day').format(format);
+};
+/**
+ * Date helpers that normalise timezone-sensitive values before formatting.
+ *
+ * - `removeTimezoneAndFormat(date, format?)` — strips the time component from
+ *   a `Date` or ISO string, anchors it to noon local time, then formats with
+ *   dayjs. This prevents off-by-one-day errors that occur when UTC midnight
+ *   falls on a different calendar day in the user's timezone. Returns `''` for
+ *   falsy input.
+ */
+export const dateUtils = {
+    removeTimezoneAndFormat,
+};
+//# sourceMappingURL=date.js.map

package/dist/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,uBAAuB,GAAG,CAAC,IAAS,EAAE,MAAM,GAAG,YAAY,EAAE,EAAE;IACnE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IAEpB,IAAI,cAAc,GAAG,IAAI,CAAA;IAEzB,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QACzB,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAA;IACjE,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAA;IACnD,CAAC;IAED,OAAO,KAAK,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC5D,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,uBAAuB;CACxB,CAAA"}

package/dist/faker.js

@@ -0,0 +1,43 @@
+const names = [
+    'James', 'John', 'Robert', 'Michael', 'William', 'David', 'Richard', 'Joseph', 'Thomas',
+    'Charles', 'Christopher', 'Daniel', 'Matthew', 'Anthony', 'Donald', 'Mark', 'Paul', 'Steven',
+    'Andrew', 'Kenneth', 'Joshua', 'Kevin', 'Brian', 'George', 'Edward', 'Ronald', 'Timothy',
+    'Jason', 'Jeffrey', 'Ryan', 'Gary', 'Jacob'
+];
+const surnames = [
+    'Smith', 'Johnson', 'Williams', 'Brown', 'Jones', 'Garcia', 'Miller', 'Davis',
+    'Lopez', 'Wilson', 'Anderson', 'Thomas', 'Taylor', 'Moore',
+    'Jackson', 'Martin', 'Lee', 'Perez', 'Thompson', 'White', 'Harris', 'Sanchez', 'Clark',
+    'Ramirez', 'Lewis', 'Robinson', 'Walker', 'Young', 'Allen', 'King', 'Wright', 'Scott', 'Torres',
+];
+const animals = [
+    'lion', 'tiger', 'zebra', 'panda', 'koala', 'bear',
+    'wolf', 'fox', 'rabbit', 'bat', 'spider', 'frog', 'shark'
+];
+function getRandom(list) {
+    return list[Math.floor(Math.random() * list.length)];
+}
+function number(min = 0, max = 100) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+/**
+ * Lightweight in-house fixture-data generator with no external dependencies.
+ *
+ * Provided methods:
+ * - `firstName()` / `lastName()` — random entries from hard-coded name lists.
+ * - `name()` — space-joined first + last name.
+ * - `animal()` — random animal name.
+ * - `number(min?, max?)` — random integer in `[min, max]` (default 0–100).
+ *
+ * All selections use `Math.random`, so results are not reproducible across calls.
+ * Use this instead of heavy faker libraries in tests or seed scripts where the
+ * small vocabulary is sufficient.
+ */
+export const faker = {
+    lastName: () => getRandom(surnames),
+    firstName: () => getRandom(names),
+    animal: () => getRandom(animals),
+    number,
+    name: () => `${getRandom(names)} ${getRandom(surnames)}`
+};
+//# sourceMappingURL=faker.js.map

package/dist/faker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faker.js","sourceRoot":"","sources":["../src/faker.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG;IACZ,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ;IACvF,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;IAC5F,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS;IACxF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;CAC5C,CAAA;AAED,MAAM,QAAQ,GAAG;IACf,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;IAC7E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;IAC1D,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO;IACtF,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ;CAChG,CAAA;AAED,MAAM,OAAO,GAAG;IACd,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IAClD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO;CAC1D,CAAA;AAED,SAAS,SAAS,CAAC,IAAmB;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,CAAC,EAAE,MAAc,GAAG;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AAC1D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;IACnC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;IACjC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC;IAChC,MAAM;IACN,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE;CACzD,CAAA"}

package/dist/file.js

@@ -0,0 +1,26 @@
+const separators = /[\\\/]+/;
+/**
+ * Splits a file system path into its directory, base name, and extension.
+ *
+ * Both `/` and `\` are treated as separators, so Windows and POSIX paths are
+ * handled uniformly. Files without an extension return an empty string for
+ * `extension`. The returned `path` is always joined with `/` regardless of the
+ * original separator.
+ */
+export function parseFilePathData(path) {
+    const parts = path.split(separators);
+    const lastPart = parts[parts.length - 1];
+    let fileName = lastPart;
+    let ext = '';
+    if (lastPart.includes('.')) {
+        const dotIdx = fileName.lastIndexOf('.');
+        fileName = fileName.substring(0, dotIdx);
+        ext = lastPart.substring(dotIdx + 1);
+    }
+    return {
+        path: parts.slice(0, -1).join('/'),
+        extension: ext,
+        name: fileName,
+    };
+}
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,SAAS,CAAA;AAE5B;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAEpC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAExC,IAAI,QAAQ,GAAG,QAAQ,CAAA;IACvB,IAAI,GAAG,GAAG,EAAE,CAAA;IAEZ,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACxC,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QAExC,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAClC,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,QAAQ;KACf,CAAA;AACH,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from './array';
+export * from './colors';
+export * from './misc';
+export * from './object';
+export * from './react';
+export * from './file';
+export * from './string';
+export * from './faker';
+export * from './cloneDeep';
+export * from './locale';
+export * from './date';
+//# 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,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA"}

package/dist/locale.js

@@ -0,0 +1,18 @@
+/**
+ * Finds the closest matching key in `languageDictionary` for a given `locale`.
+ *
+ * Matching uses only the first two characters (the language subtag), so `'en-AU'`
+ * will match an `'en-US'` dictionary key. Returns `defaultLocale` when no
+ * partial match exists.
+ */
+export function getSimilarLocale(locale, defaultLocale, languageDictionary) {
+    const inputFirstPart = locale.substring(0, 2);
+    const keys = Object.keys(languageDictionary);
+    for (const key of keys) {
+        const keyFirstPart = key.substring(0, 2);
+        if (inputFirstPart === keyFirstPart)
+            return key;
+    }
+    return defaultLocale;
+}
+//# sourceMappingURL=locale.js.map

package/dist/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,aAAqB,EACrB,kBAA6B;IAE7B,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAC5C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,YAAY,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACxC,IAAI,cAAc,KAAK,YAAY;YAAE,OAAO,GAAG,CAAA;IACjD,CAAC;IACD,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/dist/misc.js

@@ -0,0 +1,150 @@
+import { capitalize } from './string';
+/**
+ * Converts a remote image URL into a file-upload-compatible object
+ * (`{ uri, name, type }`).
+ *
+ * The `type` is inferred from the URL's file extension. Returns `null` when
+ * `imagePath` is falsy, making it safe to pass directly to optional file-input APIs.
+ */
+export function imagePathToFileObject(imagePath) {
+    const parts = imagePath ? imagePath.split('.') : '';
+    const ext = imagePath ? parts[parts.length - 1].toLowerCase() : '';
+    const fileValue = imagePath
+        ? {
+            uri: imagePath,
+            name: 'image_' + imagePath,
+            type: `image/${ext}`,
+        }
+        : null;
+    return fileValue;
+}
+const letterToColorMap = {
+    a: '#7CB9E8',
+    b: '#3a9e77',
+    c: '#A3C1AD',
+    d: '#E1BD27',
+    e: '#badc58',
+    f: '#db5970',
+    g: '#9b8ef1',
+    h: '#ffe169',
+    i: '#3ea9d1',
+    j: '#8aa341',
+    k: '#baf2f5',
+    l: '#ffa02d',
+    m: '#d46830',
+    n: '#62ecaa',
+    o: '#ffbe50',
+    p: '#0078D7',
+    q: '#8764B8',
+    r: '#52dd64',
+    s: '#7edce9',
+    t: '#dadd5d',
+    u: '#e9b55d',
+    v: '#99d669',
+    w: '#a3c83a',
+    x: '#f28d67',
+    y: '#ea82ec',
+    z: '#ff8295',
+};
+/**
+ * Maps the first character of `anyString` to a deterministic colour for use in
+ * avatar placeholders.
+ *
+ * Lookup is case-insensitive. Returns `'#999999'` for empty, undefined, or
+ * characters not in the `a–z` range.
+ */
+export function matchInitialToColor(anyString) {
+    if (!anyString)
+        return '#999999';
+    return letterToColorMap[anyString.toLowerCase().charAt(0)] || '#999999';
+}
+/** Returns a Promise that resolves after `ms` milliseconds. */
+export function waitFor(ms) {
+    return new Promise((resolve) => {
+        setTimeout(() => {
+            resolve();
+        }, ms);
+    });
+}
+export function parseSourceUrl(args, Settings) {
+    if (!args)
+        return null;
+    let res = '';
+    let address = '';
+    if (typeof args === 'string') {
+        address = args;
+    }
+    else {
+        address = args.source || args.src || '';
+    }
+    if (address && address.startsWith('/media/')) {
+        const tmp = address.substr(1, address.length);
+        res = `${Settings.BaseURL}${tmp}`;
+    }
+    else if (address) {
+        res = address;
+    }
+    else {
+        res = `https://picsum.photos/600?random=${Math.random() * 100}`;
+    }
+    return res;
+}
+/**
+ * Extracts style entries from a variant styles map whose keys begin with `match`,
+ * returning them as a new object with the prefix stripped and the first
+ * remaining character lowercased.
+ *
+ * Used internally by component style systems to pull out sub-part styles
+ * (e.g. `inputLabel`, `inputWrapper`) into their own namespaced objects.
+ */
+export function getNestedStylesByKey(match, variantStyles) {
+    const styles = {};
+    for (const [key, value] of Object.entries(variantStyles)) {
+        if (key.startsWith(match)) {
+            const partName = capitalize(key.replace(match, ''), true);
+            styles[partName] = value;
+        }
+    }
+    return styles;
+}
+/**
+ * Heuristically detects whether the app has been React Fast Refreshed since
+ * initial launch.
+ *
+ * Compares the elapsed time since `Settings.Environment.InitTime` against a
+ * 1-second threshold. Fast Refresh typically completes well under 1 second from
+ * app start; anything longer suggests a subsequent refresh rather than cold boot.
+ * Returns `undefined` and logs a warning when `InitTime` is not set.
+ */
+export function hasFastRefreshed(Settings) {
+    var _a;
+    if ((_a = Settings === null || Settings === void 0 ? void 0 : Settings.Environment) === null || _a === void 0 ? void 0 : _a.InitTime) {
+        const timeFromStartup = (new Date()).getTime() - Settings.Environment.InitTime.getTime();
+        // It usually takes less than a seconds (~300ms) from app launch to running this, so if's been more than that we've probably fast refreshed
+        const fastRefreshed = Settings.Environment.IsDev && timeFromStartup > 1000;
+        return fastRefreshed;
+    }
+    else {
+        console.log('hasFreshRefreshed() => Missing datetime from settings, please include to make this work');
+        return undefined;
+    }
+}
+const throttleTimerId = {};
+/**
+ * Leading-edge throttle keyed by a `ref` identifier rather than by function reference.
+ *
+ * `func` is called immediately on the first invocation for a given `ref`; subsequent
+ * calls with the same `ref` are dropped until `delay` milliseconds have elapsed.
+ * Using a string/number `ref` allows multiple independent throttle timers to coexist
+ * in a single module without needing to hold separate timer handles.
+ */
+export function throttle(func, ref, delay) {
+    if (throttleTimerId[ref]) {
+        return;
+    }
+    throttleTimerId[ref] = setTimeout(function () {
+        func();
+        throttleTimerId[ref] = undefined;
+    }, delay);
+}
+//# sourceMappingURL=misc.js.map

package/dist/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../src/misc.ts"],"names":[],"mappings":"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"}

package/dist/object.js

@@ -0,0 +1,189 @@
+/**
+ * Recursively merges `changes` into `base`, deep-merging nested plain objects.
+ *
+ * Arrays and `Date` instances are treated as scalar values — they replace rather
+ * than merge. If `changes` is not iterable, it is returned as-is.
+ */
+export function deepMerge(base = {}, changes = {}) {
+    const obj = Object.assign({}, base);
+    let changeEntries = [];
+    try {
+        changeEntries = Object.entries(changes);
+    }
+    catch (e) {
+        return changes;
+    }
+    for (const [key, value] of changeEntries) {
+        obj[key] =
+            typeof value === 'object' && !Array.isArray(value) && !(value instanceof Date)
+                ? deepMerge(obj[key], changes[key])
+                : value;
+    }
+    return obj;
+}
+/**
+ * Like `Array.prototype.map` but over an object's entries.
+ *
+ * Returns an array — not a new object — so it is useful when you need to
+ * transform key-value pairs into arbitrary values (e.g. JSX elements).
+ */
+export function mapObject(obj, callback) {
+    return Object.entries(obj).map((args) => callback(args));
+}
+/**
+ * Sets a value at an arbitrarily deep dot-separated `path`, mutating `base` in place
+ * and returning it.
+ *
+ * Numeric path segments are coerced to array indices when the current node is an array.
+ */
+export const deepSet = (base = {}, path, value) => {
+    const keys = path.split('.');
+    const obj = base;
+    let thisKey = keys[0];
+    if (Array.isArray(base)) {
+        thisKey = Number(thisKey);
+    }
+    obj[thisKey] = keys.length === 1 ? value : deepSet(obj[thisKey], keys.slice(1).join('.'), value);
+    return obj;
+};
+/**
+ * Reads a value from `obj` at a dot-separated `path`.
+ *
+ * Returns `undefined` (without throwing) when any intermediate node is absent,
+ * because property access on `undefined` propagates silently through the loop.
+ */
+export const deepGet = (path, obj) => {
+    const parts = path.split('.');
+    let newObj = Object.assign({}, obj);
+    for (const prop of parts) {
+        newObj = newObj[prop];
+    }
+    return newObj;
+};
+/**
+ * Returns every dot-separated leaf path in a nested object.
+ *
+ * Array values are treated as leaves — their indices are not traversed.
+ */
+export function objectPaths(obj) {
+    let paths = [];
+    Object.entries(obj).forEach(([key, value]) => {
+        if (!Array.isArray(value) && typeof value === 'object') {
+            paths = [...paths, ...objectPaths(value).map((k) => `${key}.${k}`)];
+        }
+        else {
+            paths.push(key);
+        }
+    });
+    return paths;
+}
+/** Returns `true` only for `string`, `number`, and `boolean` — `null`, `undefined`, and objects are excluded. */
+export function isValuePrimitive(a) {
+    return ['string', 'number', 'boolean'].includes(typeof a);
+}
+/**
+ * Inline ternary helper for spread-merging optional style or prop objects.
+ *
+ * Intended for use inside object spreads where the ternary would otherwise
+ * require wrapping: `{ ...optionalObject(flag, trueProps, {}) }`.
+ */
+export function optionalObject(condition, ifTrue, ifFalse) {
+    return condition ? ifTrue : ifFalse;
+}
+/**
+ * Depth-first walk over a nested object, invoking `callback` at each node.
+ *
+ * The callback receives metadata about each visited node (`path`, `depth`,
+ * `key`, `type`, `primitive`). Primitive leaves fire the callback once; object
+ * nodes fire it for each child before recursing into it. Returning `{ stop: true }`
+ * from the callback is accepted by the type but **does not halt traversal** —
+ * the implementation does not check the return value.
+ */
+export function traverse(obj = {}, callback, args) {
+    const isPrimitive = isValuePrimitive(obj);
+    const info = Object.assign({ path: [], depth: 0, key: '', type: typeof obj, value: obj, primitive: isPrimitive }, args);
+    if (isPrimitive) {
+        callback(Object.assign(Object.assign({}, info), { depth: info.depth }));
+    }
+    else {
+        for (const [key, value] of Object.entries(obj || {})) {
+            const isPrimitive = isValuePrimitive(value);
+            if (!isPrimitive) {
+                callback(Object.assign(Object.assign({}, info), { key,
+                    value, type: typeof value, primitive: isPrimitive, path: [...info.path, key] }));
+            }
+            traverse(value, callback, Object.assign(Object.assign({}, info), { key,
+                value, type: typeof value, primitive: isValuePrimitive(value), path: [...info.path, key], depth: info.depth + 1 }));
+        }
+    }
+}
+/**
+ * Identity helper that returns its argument unchanged, typed as `AppSettings`.
+ *
+ * Exists solely to give TypeScript a typed entry point for authoring settings
+ * objects so that editors provide autocompletion and type errors at the
+ * definition site rather than at the point of use.
+ */
+export function createSettings(a) {
+    return a;
+}
+/**
+ * Returns `obj.id` if it exists, otherwise `undefined`.
+ *
+ * Intended as a default `keyExtractor` in list utilities where records are
+ * expected to carry an `id` field.
+ */
+export function extractKey(obj) {
+    if (obj.id) {
+        return obj.id;
+    }
+}
+/**
+ * Returns a new object containing only the entries for which `predicate` returns `true`.
+ *
+ * Only own enumerable keys are visited; prototype-chain properties are skipped.
+ */
+export function objectPickBy(obj, predicate) {
+    var _a;
+    const result = {};
+    for (const key in obj) {
+        if (((_a = obj === null || obj === void 0 ? void 0 : obj.hasOwnProperty) === null || _a === void 0 ? void 0 : _a.call(obj, key)) && (predicate === null || predicate === void 0 ? void 0 : predicate(obj === null || obj === void 0 ? void 0 : obj[key], key))) {
+            result[key] = obj === null || obj === void 0 ? void 0 : obj[key];
+        }
+    }
+    return result;
+}
+/**
+ * Rebuilds an object by running every entry through `predicate`, which must
+ * return a `[newKey, newValue]` tuple.
+ *
+ * Keys returned by `predicate` need not be unique — later entries silently
+ * overwrite earlier ones if they resolve to the same key.
+ */
+export function transformObject(obj, predicate) {
+    const result = {};
+    for (const key in obj) {
+        const [newKey, newValue] = predicate === null || predicate === void 0 ? void 0 : predicate(obj === null || obj === void 0 ? void 0 : obj[key], key);
+        result[newKey] = newValue;
+    }
+    return result;
+}
+/**
+ * Returns a new object containing only keys that start with `prefix`, with the
+ * prefix stripped and the first remaining character lowercased.
+ *
+ * Useful for splitting a flat props object into logical groups, e.g. separating
+ * all `inputXxx` props from a combined component interface.
+ */
+export function filterObjectByPrefix(obj, prefix) {
+    const result = {};
+    for (const key in obj) {
+        if (key.startsWith(prefix)) {
+            const newKey = key.slice(prefix.length);
+            const formattedKey = newKey.charAt(0).toLowerCase() + newKey.slice(1);
+            result[formattedKey] = obj[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,OAA4B,EAAE,EAAE,UAA+B,EAAE;IACzF,MAAM,GAAG,qBACJ,IAAI,CACR,CAAA;IACD,IAAI,aAAa,GAAoB,EAAE,CAAA;IACvC,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;QACzC,GAAG,CAAC,GAAG,CAAC;YACN,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC;gBAC5E,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnC,CAAC,CAAC,KAAK,CAAA;IACb,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,GAAM,EACN,QAAoD;IAEpD,OAAO,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAA6B,CAAC,CAC1G,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAY,EAAE,EAAE,IAAY,EAAE,KAAU,EAAO,EAAE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAA;IAChB,IAAI,OAAO,GAAoB,IAAI,CAAC,CAAC,CAAC,CAAA;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAC3B,CAAC;IACD,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;IAChG,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,GAAwB,EAAE,EAAE;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,MAAM,qBAA6B,GAAG,CAAE,CAAA;IAE5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAwB;IAClD,IAAI,KAAK,GAAa,EAAE,CAAA;IAExB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvD,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;QACrE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,KAAK,CAAA;AACd,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,gBAAgB,CAAC,CAAK;IACpC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,SAAkB,EAAE,MAAW,EAAE,OAAY;IAC1E,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;AACrC,CAAC;AAMD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAW,EAAE,EAAE,QAAyB,EAAE,IAAsB;IACvF,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAEzC,MAAM,IAAI,mBACR,IAAI,EAAE,EAAE,EACR,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,EAAE,EACP,IAAI,EAAE,OAAO,GAAG,EAChB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,WAAW,IACnB,IAAI,CACR,CAAA;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,iCACH,IAAI,KACP,KAAK,EAAE,IAAI,CAAC,KAAK,IAEjB,CAAA;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;YACrD,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;YAE3C,IAAI,CAAC,WAAW,EAAE,CAAC;gBAEjB,QAAQ,iCACH,IAAI,KACP,GAAG;oBACH,KAAK,EACL,IAAI,EAAE,OAAO,KAAK,EAClB,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IACzB,CAAA;YACJ,CAAC;YAED,QAAQ,CAAC,KAAK,EAAE,QAAQ,kCACnB,IAAI,KACP,GAAG;gBACH,KAAK,EACL,IAAI,EAAE,OAAO,KAAK,EAClB,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAClC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,IACrB,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAwB,CAAG;IACvD,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAO;IAChC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,EAAE,CAAA;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAqC,GAAiB,EAAE,SAA2C;;IAC7H,MAAM,MAAM,GAAG,EAAkB,CAAA;IAEjC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,CAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,cAAc,oDAAG,GAAG,CAAC,MAAI,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAG,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA,EAAE,CAAC;YAC/D,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,GAAG,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAuD,GAAiB,EAAE,SAAuC;IAC9I,MAAM,MAAM,GAAwB,EAAE,CAAA;IAEtC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAG,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;QAEvD,MAAM,CAAC,MAAgB,CAAC,GAAG,QAAQ,CAAA;IACrC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAM,EACN,MAAS;IAET,MAAM,MAAM,GAAG,EAAS,CAAA;IACxB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACvC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACrE,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/react.js

@@ -0,0 +1,176 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import equals from 'deep-equal';
+import React from 'react';
+import { TypeGuards } from '@codeleap/types';
+/** Deep structural equality backed by the `deep-equal` package. */
+export const deepEqual = equals;
+/**
+ * Checks a specific subset of props for deep equality between two render cycles.
+ *
+ * `excludeKeys` are deleted from each compared value **in place** before
+ * comparison — this mutates the items inside `previous` and `next`.
+ * Pass only the keys you want to ignore, and be aware of the side-effect.
+ */
+export function arePropsEqual(previous, next, options) {
+    const { check, excludeKeys = [] } = options;
+    for (const c of check) {
+        const nextItem = next[c];
+        const prevItem = previous[c];
+        for (const key of excludeKeys) {
+            if (nextItem === null || nextItem === void 0 ? void 0 : nextItem[key])
+                delete nextItem[key];
+            if (prevItem === null || prevItem === void 0 ? void 0 : prevItem[key])
+                delete prevItem[key];
+        }
+        const propsAreEqual = equals(nextItem, prevItem);
+        if (!propsAreEqual) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Recursively collects a React children tree into a single flat array.
+ *
+ * Uses `React.Children.toArray` at each level (which assigns stable keys), then
+ * follows any `children` prop on the top-level element to continue flattening.
+ * Only one level of `props.children` nesting is followed per call — deeply
+ * nested component trees (not just wrapper nodes) are not fully unwound.
+ */
+export const flattenChildren = (children, flat = []) => {
+    flat = [...flat, ...React.Children.toArray(children)];
+    if ((children === null || children === void 0 ? void 0 : children.props) && children.props.children) {
+        return flattenChildren(children.props.children, flat);
+    }
+    return flat;
+};
+/**
+ * Flattens a children tree and strips the `children` prop from each element's
+ * props, returning a serialisable summary of the tree.
+ *
+ * Intended for introspection and testing — not for re-rendering, since `ref`
+ * and event-handler functions are preserved as-is.
+ */
+export const simplifyChildren = (children) => {
+    const flat = flattenChildren(children);
+    return flat.map((_a) => {
+        var { key, ref, type } = _a, _b = _a.props, { children } = _b, props = __rest(_b, ["children"]);
+        return ({
+            key, ref, type, props,
+        });
+    });
+};
+/**
+ * Renders a slot that accepts a component, a props object, or a pre-rendered node.
+ *
+ * Resolution order:
+ * 1. If `ComponentOrProps` is a function → render it as `<ComponentOrProps {...props} />`.
+ * 2. If it is `null`, `undefined`, or an empty object → return `null`.
+ * 3. If it is already a valid React element → return it as-is.
+ * 4. Otherwise treat it as a props object and render `<DefaultComponent {...props} {...ComponentOrProps} />`.
+ *
+ * This lets call sites pass either a component override, extra props, or nothing,
+ * without needing separate conditional rendering logic.
+ */
+export function getRenderedComponent(ComponentOrProps, DefaultComponent, props) {
+    const _ComponentOrProps = ComponentOrProps;
+    const _DefaultComponent = DefaultComponent;
+    if (TypeGuards.isFunction(ComponentOrProps)) {
+        return React.createElement(_ComponentOrProps, Object.assign({}, props));
+    }
+    if (TypeGuards.isNil(ComponentOrProps) || Object.keys(ComponentOrProps).length === 0) {
+        return null;
+    }
+    if (React.isValidElement(ComponentOrProps)) {
+        return ComponentOrProps;
+    }
+    const _props = ComponentOrProps;
+    return React.createElement(_DefaultComponent, Object.assign({}, props, _props));
+}
+/**
+ * Memoizes a React functional component to prevent unnecessary re-renders.
+ *
+ * This function wraps a React functional component using `React.memo`, which provides
+ * a mechanism for memoizing the result of rendering the component. By default, it
+ * uses a comparison function that always returns `true`, indicating that the component
+ * should not re-render, regardless of prop changes. This behavior essentially freezes
+ * the component's rendering until explicitly updated.
+ *
+ * @template P - The type of the component's props.
+ * @param ComponentToMemoize - The React functional component to memoize.
+ * @returns A memoized version of the input component (`React.NamedExoticComponent`).
+ */
+export function memoize(ComponentToMemoize) {
+    return React.memo(ComponentToMemoize, () => true);
+}
+/**
+ * Checks whether a specific property in two sets of props is equal.
+ *
+ * This function compares the value of a given property (`prop`) between two objects
+ * (`prevProps` and `nextProps`) using a deep equality check (`equals`).
+ *
+ * @template P - The type of the props object.
+ * @param prop - The key of the property to compare.
+ * @param prevProps - The previous props object.
+ * @param nextProps - The next props object.
+ * @returns `true` if the values of the specified property are deeply equal; otherwise, `false`.
+ */
+export function memoChecker(prop, prevProps, nextProps) {
+    const nextItem = nextProps[prop];
+    const prevItem = prevProps[prop];
+    return equals(nextItem, prevItem);
+}
+/**
+ * Memoizes a React functional component based on specific props.
+ *
+ * This function wraps a React functional component using `React.memo` with a custom comparison
+ * function. The comparison function checks if the specified properties (passed as `check`)
+ * remain equal between renders. If all specified properties are equal, the component will not re-render.
+ *
+ * @template P - The type of the component's props.
+ * @param ComponentToMemoize - The React functional component to memoize.
+ * @param check - A single property key or an array of property keys to compare for memoization.
+ * @returns A memoized version of the input component (`React.NamedExoticComponent`).
+ *
+ * @example
+ * import React from 'react';
+ * import { memoBy } from './utils';
+ *
+ * const MyComponent: React.FC<{ name: string; age: number }> = ({ name, age }) => {
+ *   console.log('Rendering MyComponent...');
+ *   return (
+ *     <div>
+ *       {name}, {age}
+ *     </div>
+ *   );
+ * };
+ *
+ * // Memoize the component based on the `name` prop.
+ * const MemoizedByName = memoBy(MyComponent, 'name');
+ *
+ * // Memoize the component based on both `name` and `age` props.
+ * const MemoizedByNameAndAge = memoBy(MyComponent, ['name', 'age']);
+ *
+ * export { MemoizedByName, MemoizedByNameAndAge };
+ *
+ * // Usage in a parent component
+ * <MemoizedByName name="Alice" age={25} />;
+ * <MemoizedByNameAndAge name="Alice" age={25} />;
+ */
+export function memoBy(ComponentToMemoize, check) {
+    return React.memo(ComponentToMemoize, (prevProps, nextProps) => {
+        const checks = Array.isArray(check) ? check : [check];
+        return checks.every((key) => memoChecker(key, prevProps, nextProps));
+    });
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,MAAM,MAAM,YAAY,CAAA;AAC/B,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,mEAAmE;AACnE,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAA;AAO/B;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAW,EACX,IAAO,EACP,OAAoC;IAEpC,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;IAE3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAI,IAAY,CAAC,CAAW,CAAC,CAAA;QAC3C,MAAM,QAAQ,GAAI,QAAgB,CAAC,CAAW,CAAC,CAAA;QAE/C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,IAAI,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,GAAG,CAAC;gBAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;YACzC,IAAI,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,GAAG,CAAC;gBAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC3C,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAEhD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAa,EAAE,OAA0B,EAAE,EAAqB,EAAE;IAChG,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IAErD,IAAI,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,KAAK,KAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/C,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACvD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAa,EAAE,EAAE;IAChD,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IAEtC,OAAQ,IAAc,CAAC,GAAG,CACxB,CAAC,EAQA,EAAE,EAAE;YARJ,EACC,GAAG,EACH,GAAG,EACH,IAAI,OAKL,EAJC,aAGC,EAHD,EACE,QAAQ,OAET,EADI,KAAK,cAFH,YAGN,CADS;QAEN,OAAA,CAAC;YACL,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK;SACtB,CAAC,CAAA;KAAA,CACH,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAAiF,EACjF,gBAAwC,EACxC,KAAS;IAET,MAAM,iBAAiB,GAAG,gBAAuB,CAAA;IACjD,MAAM,iBAAiB,GAAG,gBAAuB,CAAA;IAEjD,IAAI,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5C,OAAO,oBAAC,iBAAiB,oBAAK,KAAqB,EAAI,CAAA;IACzD,CAAC;IAED,IAAI,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,gBAA0B,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/F,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC3C,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgC,CAAA;IAE/C,OAAO,oBAAC,iBAAiB,oBAAK,KAAqB,EAAM,MAAM,EAAI,CAAA;AACrE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAmB,kBAA8C;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;AACnD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAI,IAAa,EAAE,SAAY,EAAE,SAAY;IACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAEhC,OAAO,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,MAAM,CACpB,kBAA8C,EAC9C,KAA+B;IAE/B,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE;QAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/string.js

@@ -0,0 +1,79 @@
+/** Collapses all newline characters in `text` to single spaces. */
+export function singleLine(text) {
+    return text === null || text === void 0 ? void 0 : text.replace(/\n/g, ' ');
+}
+/**
+ * Round-trips a value through `JSON.stringify` → `JSON.parse`.
+ *
+ * Strips non-serialisable properties (functions, `undefined`, class instances)
+ * and produces a plain-object clone. Throws if the value contains circular
+ * references.
+ */
+export function stringiparse(string) {
+    return JSON.parse(JSON.stringify(string));
+}
+/**
+ * Changes only the first character of `str`.
+ *
+ * When `reverse` is `true` the first character is lowercased instead of
+ * uppercased — useful for converting PascalCase to camelCase.
+ */
+export function capitalize(str, reverse = false) {
+    if (!str.length)
+        return str;
+    const firstChar = reverse ? str[0].toLowerCase() : str[0].toUpperCase();
+    return firstChar + str.substring(1);
+}
+/**
+ * Returns `true` if `char` is an uppercase Latin or extended Latin character.
+ *
+ * Covers the Unicode range `U+0080`–`U+024F` in addition to `A–Z`, so
+ * accented capitals (e.g. `É`, `Ñ`) are recognised correctly.
+ */
+export function isUppercase(char) {
+    return /[A-Z]|[\u0080-\u024F]/.test(char) && char.toUpperCase() === char;
+}
+/** Returns `true` when `char` is **not** considered uppercase by {@link isUppercase}. */
+export function isLowercase(char) {
+    return !isUppercase(char);
+}
+/**
+ * Converts a camelCase or PascalCase identifier to a space-separated, title-cased string.
+ *
+ * A space is inserted before each uppercase letter that is immediately preceded
+ * by a lowercase letter. The first character is always uppercased.
+ * Consecutive uppercase runs (e.g. acronyms like "URL") are not split.
+ */
+export function humanizeCamelCase(str) {
+    const characters = [];
+    let previousCharacter = '';
+    str.split('').forEach((char, idx) => {
+        if (idx === 0) {
+            characters.push(char.toUpperCase());
+        }
+        else {
+            if (isUppercase(char) && isLowercase(previousCharacter)) {
+                characters.push(` ${char}`);
+            }
+            else {
+                characters.push(char);
+            }
+        }
+        previousCharacter = char;
+    });
+    return characters.join('');
+}
+/**
+ * Truncates `str` to `maxLen` characters, appending `'...'` when truncation occurs.
+ *
+ * The three dots count toward `maxLen`, so the returned string never exceeds
+ * `maxLen` characters when truncated. Strings already at or below `maxLen` are
+ * returned unchanged.
+ */
+export function ellipsis(str, maxLen) {
+    if (str.length - 3 > maxLen) {
+        return str.slice(0, maxLen - 3) + '...';
+    }
+    return str;
+}
+//# sourceMappingURL=string.js.map

package/dist/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAAO,GAAG,KAAK;IACrD,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,GAAG,CAAA;IAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IACvE,OAAO,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAA;AAC1E,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,IAAI,iBAAiB,GAAG,EAAE,CAAA;IAC1B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAClC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YACd,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACxD,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;YAC7B,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;QAED,iBAAiB,GAAG,IAAI,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAc;IAClD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA;IACzC,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codeleap/utils",
-  "version": "6.8.0",
-  "main": "src/index.ts",
+  "version": "7.0.1",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
@@ -22,8 +22,8 @@
     "directory": "packages/utils"
   },
   "devDependencies": {
-    "@codeleap/config": "6.8.0",
-    "@codeleap/types": "6.8.0",
+    "@codeleap/config": "7.0.1",
+    "@codeleap/types": "7.0.1",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {
@@ -31,7 +31,7 @@
     "typecheck": "bun tsc --noEmit -p ./tsconfig.json"
   },
   "peerDependencies": {
-    "@codeleap/types": "6.8.0",
+    "@codeleap/types": "7.0.1",
     "axios": "^1.7.9",
     "dayjs": "1.11.18",
     "typescript": "6.0.3",