@breadstone/mosaik-elements 0.0.135 → 0.0.137

package/Index.d.ts

@@ -13,4 +13,6 @@ export type { ICancelEventDetail } from './Events/Details/Interfaces/ICancelEven
 export type { IChangedEventDetail } from './Events/Details/Interfaces/IChangedEventDetail';
 export type { IErrorEventDetail } from './Events/Details/Interfaces/IErrorEventDetail';
 export type { IValueEventDetail } from './Events/Details/Interfaces/IValueEventDetail';
+export { filterBy, filterByMemberPath } from './Utils/filterBy';
+export { orderBy, orderByMemberPath } from './Utils/orderBy';
 //# sourceMappingURL=Index.d.ts.map

package/Index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../src/Index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,YAAY,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AACjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,YAAY,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,YAAY,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC"}
+{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../src/Index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,YAAY,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AACjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,YAAY,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,YAAY,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAGvF,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/Index.js

@@ -3,4 +3,7 @@ export { EventListenerSubscription } from './Events/EventListenerSubscription';
 export { HTMLElementEventEmitter } from './Events/Emitters/HTMLElementEventEmitter';
 export { PureEventEmitter } from './Events/Emitters/PureEventEmitter';
 export { isEventListenerSubscription } from './Events/Interfaces/IEventListenerSubscription';
+// utils
+export { filterBy, filterByMemberPath } from './Utils/filterBy';
+export { orderBy, orderByMemberPath } from './Utils/orderBy';
 //# sourceMappingURL=Index.js.map

package/Index.js.map

@@ -1 +1 @@
-{"version":3,"file":"Index.js","sourceRoot":"","sources":["../src/Index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAKtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC"}
+{"version":3,"file":"Index.js","sourceRoot":"","sources":["../src/Index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAKtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAQ7F,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/Utils/filterBy.d.ts

@@ -0,0 +1,30 @@
+import type { Paths } from 'type-fest';
+/**
+ * Filters a list using a predicate function (like Array.prototype.filter).
+ *
+ * @param input      Source array; `null`/`undefined` yields `[]`.
+ * @param predicate  Test function `(item, index, array) => boolean`. Must be synchronous.
+ * @returns          New filtered array (original is not mutated).
+ *
+ * @public
+ */
+export declare function filterBy<T>(input: ReadonlyArray<T> | null | undefined, predicate: (item: T, index: number, array: ReadonlyArray<T>) => boolean): Array<T>;
+/**
+ * Filters a list of items by checking one or multiple (dot-path) properties against a search term.
+ *
+ * - Case-insensitive string matching
+ * - Supports `string | number | boolean | string[]`
+ * - Strict (exact) vs. non-strict (substring) mode
+ * - Deep property access via dot notation ("user.profile.name")
+ * - Member paths are compile-time checked via TypeFest `Paths<T>`
+ *
+ * @param input   The source array. `null`/`undefined` yields an empty list.
+ * @param props   Property paths (dot-notation, type-checked) to check against the search term(s).
+ * @param search  A search term or a list of terms. Non-string terms are stringified.
+ * @param strict  If `true`, matches must be exact (case-insensitive for strings). Otherwise substring matching is used.
+ * @returns       A new filtered array (original is not mutated).
+ *
+ * @public
+ */
+export declare function filterByMemberPath<T>(input: ReadonlyArray<T> | null | undefined, props: ReadonlyArray<Paths<T>>, search?: string | number | boolean | ReadonlyArray<string>, strict?: boolean): Array<T>;
+//# sourceMappingURL=filterBy.d.ts.map

package/Utils/filterBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterBy.d.ts","sourceRoot":"","sources":["../../src/Utils/filterBy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIvC;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACtB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1C,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,OAAO,GACxE,KAAK,CAAC,CAAC,CAAC,CASV;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAChC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1C,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC9B,MAAM,GAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,MAAM,CAAM,EAC9D,MAAM,GAAE,OAAe,GACxB,KAAK,CAAC,CAAC,CAAC,CAgEV"}

package/Utils/filterBy.js

@@ -0,0 +1,124 @@
+// libs/mosaik-elements/src/Utils/filterBy.ts
+// #region Imports
+// #endregion
+/**
+ * Filters a list using a predicate function (like Array.prototype.filter).
+ *
+ * @param input      Source array; `null`/`undefined` yields `[]`.
+ * @param predicate  Test function `(item, index, array) => boolean`. Must be synchronous.
+ * @returns          New filtered array (original is not mutated).
+ *
+ * @public
+ */
+export function filterBy(input, predicate) {
+    const list = Array.isArray(input) ? input : [];
+    if (typeof predicate !== 'function') {
+        return [...list];
+    }
+    // Mirrors Array.prototype.filter semantics.
+    // Reference: MDN Array.prototype.filter.  [oai_citation:3‡MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter?utm_source=chatgpt.com)
+    return list.filter((item, index, array) => predicate(item, index, array));
+}
+/**
+ * Filters a list of items by checking one or multiple (dot-path) properties against a search term.
+ *
+ * - Case-insensitive string matching
+ * - Supports `string | number | boolean | string[]`
+ * - Strict (exact) vs. non-strict (substring) mode
+ * - Deep property access via dot notation ("user.profile.name")
+ * - Member paths are compile-time checked via TypeFest `Paths<T>`
+ *
+ * @param input   The source array. `null`/`undefined` yields an empty list.
+ * @param props   Property paths (dot-notation, type-checked) to check against the search term(s).
+ * @param search  A search term or a list of terms. Non-string terms are stringified.
+ * @param strict  If `true`, matches must be exact (case-insensitive for strings). Otherwise substring matching is used.
+ * @returns       A new filtered array (original is not mutated).
+ *
+ * @public
+ */
+export function filterByMemberPath(input, props, search = '', strict = false) {
+    const list = Array.isArray(input) ? input : [];
+    if (!props.length) {
+        return [...list];
+    }
+    const validType = typeof search === 'string' ||
+        typeof search === 'number' ||
+        typeof search === 'boolean' ||
+        Array.isArray(search);
+    if (!validType) {
+        return [...list];
+    }
+    const isArraySearch = Array.isArray(search);
+    const terms = isArraySearch
+        ? search.map((s) => s.toLowerCase())
+        : [String(search).toLowerCase()];
+    // Historical behavior: empty string means "no filter"
+    if (!isArraySearch && terms[0] === '') {
+        return [...list];
+    }
+    return list.filter((item) => props.some((path) => {
+        // `Paths<T>` from type-fest is a template-literal string union; cast is safe for runtime usage.
+        const value = getByPath(item, path);
+        if (value === null || value === undefined) {
+            return false;
+        }
+        // Support primitive or array-of-primitive values. If an array, match if ANY element satisfies the criteria.
+        if (Array.isArray(value)) {
+            const lowered = value
+                .filter((v) => v !== null && v !== undefined && (typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean'))
+                .map((v) => String(v).toLowerCase());
+            if (!lowered.length) {
+                return false;
+            }
+            if (isArraySearch) {
+                return strict
+                    ? lowered.some((lv) => terms.includes(lv))
+                    : lowered.some((lv) => terms.some((t) => lv.includes(t)));
+            }
+            return strict ? lowered.includes(terms[0]) : lowered.some((lv) => lv.includes(terms[0]));
+        }
+        // Skip plain objects to avoid meaningless "[object Object]" stringification.
+        if (typeof value === 'object') {
+            return false;
+        }
+        // includes() is case-sensitive; normalize both sides for case-insensitive contains.  [oai_citation:4‡MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/includes?utm_source=chatgpt.com)
+        if (typeof value !== 'string' && typeof value !== 'number' && typeof value !== 'boolean') {
+            return false; // Non-primitive (e.g., symbol) is ignored
+        }
+        const normalized = String(value).toLowerCase();
+        return isArraySearch
+            ? terms.some((t) => strict ? normalized === t : normalized.includes(t))
+            : strict
+                ? normalized === terms[0]
+                : normalized.includes(terms[0]);
+    }));
+}
+/**
+ * Safely reads a deep property value from an object using a dot-separated path.
+ *
+ * Example:
+ *   getByPath({ a: { b: 1 } }, "a.b") => 1
+ *
+ * Returns `undefined` if the chain breaks.
+ * See MDN for filter semantics referenced above.  [oai_citation:5‡MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter?utm_source=chatgpt.com)
+ *
+ * @internal
+ */
+function getByPath(obj, path) {
+    if (!path) {
+        return undefined;
+    }
+    const parts = path.split('.');
+    let cursor = obj;
+    for (const key of parts) {
+        if (cursor !== null && typeof cursor === 'object' && key in cursor) {
+            cursor = cursor[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return cursor;
+}
+// #endregion
+//# sourceMappingURL=filterBy.js.map

package/Utils/filterBy.js.map

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

package/Utils/orderBy.d.ts

@@ -0,0 +1,26 @@
+import type { Paths } from 'type-fest';
+type Direction = 'asc' | 'desc';
+/**
+ * Orders a list by one or multiple selector functions (iteratees).
+ *
+ * @public
+ * @param input Source array; `null`/`undefined` yields `[]`.
+ * @param selectors Single selector or list of selectors `(item) => key`.
+ * @param direction `'asc' | 'desc'` or list thereof aligned to `selectors`. Defaults to `'asc'`.
+ * @param collator Optional `Intl.Collator` for locale-aware string comparison.
+ * @returns New sorted array (original is not mutated).
+ */
+export declare function orderBy<T>(input: ReadonlyArray<T> | null | undefined, selectors?: ((item: T) => unknown) | ReadonlyArray<(item: T) => unknown>, direction?: Direction | ReadonlyArray<Direction>, collator?: Intl.Collator): Array<T>;
+/**
+ * Orders a list by one or multiple member paths (string-based, deep paths) with compile-time path safety via `type-fest`'s `Paths<T>`.
+ *
+ * @public
+ * @param input Source array; `null`/`undefined` yields `[]`.
+ * @param paths Single path or list of paths (`Paths<T>`).
+ * @param direction `'asc' | 'desc'` or list thereof aligned to `paths`. Defaults to `'asc'`.
+ * @param collator Optional `Intl.Collator` for locale-aware string comparison.
+ * @returns New sorted array (original is not mutated).
+ */
+export declare function orderByMemberPath<T>(input: ReadonlyArray<T> | null | undefined, paths?: Paths<T> | ReadonlyArray<Paths<T>>, direction?: Direction | ReadonlyArray<Direction>, collator?: Intl.Collator): Array<T>;
+export {};
+//# sourceMappingURL=orderBy.d.ts.map

package/Utils/orderBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderBy.d.ts","sourceRoot":"","sources":["../../src/Utils/orderBy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIvC,KAAK,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhC;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CA0BrO;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAyBjN"}

package/Utils/orderBy.js

@@ -0,0 +1,135 @@
+// #region Imports
+/**
+ * Orders a list by one or multiple selector functions (iteratees).
+ *
+ * @public
+ * @param input Source array; `null`/`undefined` yields `[]`.
+ * @param selectors Single selector or list of selectors `(item) => key`.
+ * @param direction `'asc' | 'desc'` or list thereof aligned to `selectors`. Defaults to `'asc'`.
+ * @param collator Optional `Intl.Collator` for locale-aware string comparison.
+ * @returns New sorted array (original is not mutated).
+ */
+export function orderBy(input, selectors, direction, collator) {
+    const list = Array.isArray(input) ? [...input] : [];
+    if (!selectors || (Array.isArray(selectors) && selectors.length === 0)) {
+        return list.sort((a, b) => baseCompare(String(a), String(b), collator));
+    }
+    const iteratees = typeof selectors === 'function' ? [selectors] : selectors;
+    const directions = Array.isArray(direction)
+        ? direction.length === iteratees.length ? direction : Array(iteratees.length).fill(direction[0] ?? 'asc')
+        : Array(iteratees.length).fill(direction ?? 'asc');
+    return list.sort((a, b) => {
+        for (let i = 0; i < iteratees.length; i += 1) {
+            const asc = directions[i] !== 'desc';
+            const av = iteratees[i](a);
+            const bv = iteratees[i](b);
+            const cmp = baseCompare(av, bv, collator);
+            if (cmp !== 0) {
+                return asc ? cmp : -cmp;
+            }
+        }
+        return 0;
+    });
+}
+/**
+ * Orders a list by one or multiple member paths (string-based, deep paths) with compile-time path safety via `type-fest`'s `Paths<T>`.
+ *
+ * @public
+ * @param input Source array; `null`/`undefined` yields `[]`.
+ * @param paths Single path or list of paths (`Paths<T>`).
+ * @param direction `'asc' | 'desc'` or list thereof aligned to `paths`. Defaults to `'asc'`.
+ * @param collator Optional `Intl.Collator` for locale-aware string comparison.
+ * @returns New sorted array (original is not mutated).
+ */
+export function orderByMemberPath(input, paths, direction, collator) {
+    const list = Array.isArray(input) ? [...input] : [];
+    if (!paths || (Array.isArray(paths) && paths.length === 0)) {
+        return list.sort((a, b) => baseCompare(String(a), String(b), collator));
+    }
+    const pathList = Array.isArray(paths) ? paths : [paths];
+    const directions = Array.isArray(direction)
+        ? direction.length === pathList.length ? direction : Array(pathList.length).fill(direction[0] ?? 'asc')
+        : Array(pathList.length).fill(direction ?? 'asc');
+    return list.sort((a, b) => {
+        for (let i = 0; i < pathList.length; i += 1) {
+            const asc = directions[i] !== 'desc';
+            const av = getByPath(a, pathList[i]);
+            const bv = getByPath(b, pathList[i]);
+            const cmp = baseCompare(av, bv, collator);
+            if (cmp !== 0) {
+                return asc ? cmp : -cmp;
+            }
+        }
+        return 0;
+    });
+}
+/**
+ * Compares two values in a strict, predictable manner.
+ * Rules:
+ *  - `null`/`undefined` come first
+ *  - `Date` compared by epoch time
+ *  - numbers/booleans compared numerically
+ *  - strings compared case-insensitively or with the provided `Intl.Collator`
+ */
+function baseCompare(a, b, collator) {
+    const aNil = a === null || a === undefined;
+    const bNil = b === null || b === undefined;
+    if (aNil && bNil) {
+        return 0;
+    }
+    if (aNil) {
+        return -1;
+    }
+    if (bNil) {
+        return 1;
+    }
+    if (a instanceof Date || b instanceof Date) {
+        const ta = a instanceof Date ? a.getTime() : Number(a);
+        const tb = b instanceof Date ? b.getTime() : Number(b);
+        if (ta < tb) {
+            return -1;
+        }
+        if (ta > tb) {
+            return 1;
+        }
+        return 0;
+    }
+    if (typeof a === 'number' ||
+        typeof b === 'number' ||
+        typeof a === 'boolean' ||
+        typeof b === 'boolean') {
+        const na = Number(a);
+        const nb = Number(b);
+        if (na < nb) {
+            return -1;
+        }
+        if (na > nb) {
+            return 1;
+        }
+        return 0;
+    }
+    const sa = String(a);
+    const sb = String(b);
+    return collator ? collator.compare(sa, sb) : sa.toLowerCase().localeCompare(sb.toLowerCase());
+}
+/**
+ * Reads a deep property via dot-separated path (e.g., "user.profile.lastName").
+ * Returns `undefined` if the path cannot be fully resolved.
+ */
+function getByPath(obj, path) {
+    if (!path) {
+        return undefined;
+    }
+    const segments = path.split('.');
+    let cursor = obj;
+    for (const key of segments) {
+        if (cursor !== null && typeof cursor === 'object' && key in cursor) {
+            cursor = cursor[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return cursor;
+}
+//# sourceMappingURL=orderBy.js.map

package/Utils/orderBy.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@breadstone/mosaik-elements",
-    "version": "0.0.135",
+    "version": "0.0.137",
     "description": "Mosaik element core package.",
     "license": "MIT",
     "author": "andre.wehlert <awehlert@breadstone.de> (https://www.breadstone.de)",