zeed 1.2.4 → 1.3.1

package/dist/throttle-debounce-Psb0ay1r.d.cts

@@ -0,0 +1,38 @@
+//#region src/common/exec/throttle-debounce.d.ts
+/**
+ * A special throttle implementation that tries to distribute execution
+ * in an optimal way.
+ *
+ * **Functionality:** For UI usage the function is executed on first occasion (`leading`).
+ * If more calls follow it will again be executed at end (`trailing`).
+ * If the next call is inside the timeframe, it is delayed until `trailing`.
+ * This avoids timewise too close calls.
+ * It is possible to `cancel` the timeout and to `flush` a call, e.g. if
+ * leaving UI situation where a final call is required to write data or similar.
+ */
+declare function throttle<F extends (...args: any[]) => any>(callback: F, opt?: {
+  delay?: number;
+  trailing?: boolean;
+  leading?: boolean;
+}): F & {
+  /** Stop all timers, do not exec nothing */cancel: () => void; /** Stop all timers and execute right now. */
+  immediate: (...args: Parameters<F>) => Promise<void>; /** Stop all timers and execute trailing call, if exists. */
+  stop: () => void;
+  dispose: () => void;
+};
+/**
+ * Debounce fits best for filtering a large peak of events.
+ * For UI event filtering throttle is probably a better choice.
+ *
+ * **Functionality:**  It only fires after triggers pause for `delay` ms.
+ */
+declare function debounce<F extends (...args: any[]) => any | Promise<any>>(callback: F, opt?: {
+  delay?: number;
+}): F & {
+  cancel: () => void;
+  immediate: (...args: Parameters<F>) => Promise<void>;
+  dispose: () => void;
+};
+//#endregion
+export { throttle as n, debounce as t };
+//# sourceMappingURL=throttle-debounce-Psb0ay1r.d.cts.map

package/dist/time-BfKJBbym.d.cts

@@ -0,0 +1,140 @@
+//#region src/common/time.d.ts
+/**
+ * Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.
+ *
+ * Pass a millisecond timestamp (for example created with Date.UTC) to force
+ * time-based helpers to return deterministic values during tests.
+ *
+ * @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)
+ */
+declare function setTimestampTest(ts?: number): void;
+/**
+ * Return the current timestamp in milliseconds.
+ *
+ * In test mode (when `setTimestampTest` was called) the forced value is
+ * returned instead of the real current time.
+ *
+ * @returns timestamp in milliseconds
+ */
+declare function getTimestamp(): number;
+/**
+ * Return the current timestamp in seconds.
+ *
+ * Uses `getTimestamp()` which can be overridden for tests with
+ * `setTimestampTest`.
+ *
+ * @returns timestamp in whole seconds (integer)
+ */
+declare function getTimestampInSeconds(): number;
+/**
+ * Convert a UNIX timestamp in seconds to a JavaScript Date.
+ *
+ * @param ts - seconds since epoch
+ * @returns Date instance corresponding to the provided seconds
+ */
+declare function dateFromSeconds(ts: number): Date;
+/**
+ * Format a millisecond duration into a human readable string.
+ *
+ * - Values >= 1000ms are shown in seconds with one decimal (e.g. "1.2 s").
+ * - Smaller values are shown in milliseconds with two decimals (e.g. "123.45 ms").
+ *
+ * @param ms - duration in milliseconds
+ * @returns formatted duration string
+ */
+declare function formatMilliseconds(ms: number): string;
+/**
+ * Parses the given date candidates and returns the first valid Date object found.
+ *
+ * @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.
+ * @returns The parsed Date object, or undefined if no valid date is found.
+ */
+declare function parseDate(...dateCandidates: (string | Date)[]): Date | undefined;
+/**
+ * Return a high-resolution timestamp in milliseconds.
+ *
+ * Uses the `performance.now()` clock when available (monotonic, high
+ * resolution), otherwise falls back to `Date.now()`.
+ *
+ * @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)
+ */
+declare function getPerformanceTimestamp(): number;
+/**
+ * Create a simple duration reporter.
+ *
+ * Returns a function that, when called, reports the elapsed time since
+ * `duration()` was called. The returned string is formatted via
+ * `formatMilliseconds`.
+ *
+ * Example: const t = duration(); // do work...; console.log(t());
+ *
+ * @returns a zero-argument function that returns the elapsed time string
+ */
+declare function duration(): () => string;
+/**
+ * If you parsed a date string that didn't include a time zone, adjust the
+ * naive UTC components into a local Date with the same Y/M/D/H/M/S values.
+ *
+ * This effectively treats the input as if it already represented local time
+ * and builds a corresponding Date using the local timezone.
+ */
+declare function datetimeToLocal(fromDate: Date): Date;
+/**
+ * If you parsed a date string that didn't include a time zone, adjust the
+ * local date components into a UTC Date with the same Y/M/D/H/M/S values.
+ */
+declare function datetimeToUTC(fromDate: Date): Date;
+/**
+ * Convert a timestamp in milliseconds to seconds.
+ *
+ * When `smart` is true the function will try to detect already-second
+ * timestamps and return them unchanged (heuristic threshold). For example,
+ * small numbers (< 1e12) are likely seconds and are returned as-is.
+ *
+ * @param ts - timestamp in milliseconds or seconds
+ * @param smart - enable heuristic detection (default: true)
+ * @returns timestamp in seconds
+ */
+declare function timestampMillisecondsToSeconds(ts: number, smart?: boolean): number;
+/**
+ * Convert a timestamp in seconds to milliseconds.
+ *
+ * When `smart` is true the function tries to detect already-millisecond
+ * values and returns them unchanged (heuristic threshold). Very large
+ * numbers (> 1e12) are assumed to already be milliseconds.
+ *
+ * @param ts - timestamp in seconds or milliseconds
+ * @param smart - enable heuristic detection (default: true)
+ * @returns timestamp in milliseconds
+ */
+declare function timestampSecondsToMilliseconds(ts: number, smart?: boolean): number;
+/** Number of milliseconds in (approx.) one year (365 days). */
+declare const TIME_YEAR_MS = 31536000000;
+/** Number of seconds in (approx.) one year (365 days). */
+declare const TIME_YEAR_S = 31536000;
+/** Number of milliseconds in (approx.) one month (30 days). */
+declare const TIME_MONTH_MS = 2592000000;
+/** Number of seconds in (approx.) one month (30 days). */
+declare const TIME_MONTH_S = 2592000;
+/** Number of milliseconds in one week (7 days). */
+declare const TIME_WEEK_MS = 604800000;
+/** Number of seconds in one week (7 days). */
+declare const TIME_WEEK_S = 604800;
+/** Number of milliseconds in one day (24 hours). */
+declare const TIME_DAY_MS = 86400000;
+/** Number of seconds in one day (24 hours). */
+declare const TIME_DAY_S = 86400;
+/** Number of milliseconds in one hour (60 minutes). */
+declare const TIME_HOUR_MS = 3600000;
+/** Number of seconds in one hour (60 minutes). */
+declare const TIME_HOUR_S = 3600;
+/** Number of milliseconds in one minute (60 seconds). */
+declare const TIME_MINUTE_MS = 60000;
+/** Number of seconds in one minute (60 seconds). */
+declare const TIME_MINUTE_S = 60;
+/** Build number is minutes since 2025-01-01 in base32 "agnoster" encoded format */
+declare function getBuildNumber(): string;
+declare function getSecondsFromBuildNumber(buildNumber: string): number;
+//#endregion
+export { parseDate as C, timestampSecondsToMilliseconds as E, getTimestampInSeconds as S, timestampMillisecondsToSeconds as T, formatMilliseconds as _, TIME_MINUTE_MS as a, getSecondsFromBuildNumber as b, TIME_MONTH_S as c, TIME_YEAR_MS as d, TIME_YEAR_S as f, duration as g, datetimeToUTC as h, TIME_HOUR_S as i, TIME_WEEK_MS as l, datetimeToLocal as m, TIME_DAY_S as n, TIME_MINUTE_S as o, dateFromSeconds as p, TIME_HOUR_MS as r, TIME_MONTH_MS as s, TIME_DAY_MS as t, TIME_WEEK_S as u, getBuildNumber as v, setTimestampTest as w, getTimestamp as x, getPerformanceTimestamp as y };
+//# sourceMappingURL=time-BfKJBbym.d.cts.map

package/dist/time-DxE-vjjw.d.mts

@@ -0,0 +1,140 @@
+//#region src/common/time.d.ts
+/**
+ * Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.
+ *
+ * Pass a millisecond timestamp (for example created with Date.UTC) to force
+ * time-based helpers to return deterministic values during tests.
+ *
+ * @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)
+ */
+declare function setTimestampTest(ts?: number): void;
+/**
+ * Return the current timestamp in milliseconds.
+ *
+ * In test mode (when `setTimestampTest` was called) the forced value is
+ * returned instead of the real current time.
+ *
+ * @returns timestamp in milliseconds
+ */
+declare function getTimestamp(): number;
+/**
+ * Return the current timestamp in seconds.
+ *
+ * Uses `getTimestamp()` which can be overridden for tests with
+ * `setTimestampTest`.
+ *
+ * @returns timestamp in whole seconds (integer)
+ */
+declare function getTimestampInSeconds(): number;
+/**
+ * Convert a UNIX timestamp in seconds to a JavaScript Date.
+ *
+ * @param ts - seconds since epoch
+ * @returns Date instance corresponding to the provided seconds
+ */
+declare function dateFromSeconds(ts: number): Date;
+/**
+ * Format a millisecond duration into a human readable string.
+ *
+ * - Values >= 1000ms are shown in seconds with one decimal (e.g. "1.2 s").
+ * - Smaller values are shown in milliseconds with two decimals (e.g. "123.45 ms").
+ *
+ * @param ms - duration in milliseconds
+ * @returns formatted duration string
+ */
+declare function formatMilliseconds(ms: number): string;
+/**
+ * Parses the given date candidates and returns the first valid Date object found.
+ *
+ * @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.
+ * @returns The parsed Date object, or undefined if no valid date is found.
+ */
+declare function parseDate(...dateCandidates: (string | Date)[]): Date | undefined;
+/**
+ * Return a high-resolution timestamp in milliseconds.
+ *
+ * Uses the `performance.now()` clock when available (monotonic, high
+ * resolution), otherwise falls back to `Date.now()`.
+ *
+ * @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)
+ */
+declare function getPerformanceTimestamp(): number;
+/**
+ * Create a simple duration reporter.
+ *
+ * Returns a function that, when called, reports the elapsed time since
+ * `duration()` was called. The returned string is formatted via
+ * `formatMilliseconds`.
+ *
+ * Example: const t = duration(); // do work...; console.log(t());
+ *
+ * @returns a zero-argument function that returns the elapsed time string
+ */
+declare function duration(): () => string;
+/**
+ * If you parsed a date string that didn't include a time zone, adjust the
+ * naive UTC components into a local Date with the same Y/M/D/H/M/S values.
+ *
+ * This effectively treats the input as if it already represented local time
+ * and builds a corresponding Date using the local timezone.
+ */
+declare function datetimeToLocal(fromDate: Date): Date;
+/**
+ * If you parsed a date string that didn't include a time zone, adjust the
+ * local date components into a UTC Date with the same Y/M/D/H/M/S values.
+ */
+declare function datetimeToUTC(fromDate: Date): Date;
+/**
+ * Convert a timestamp in milliseconds to seconds.
+ *
+ * When `smart` is true the function will try to detect already-second
+ * timestamps and return them unchanged (heuristic threshold). For example,
+ * small numbers (< 1e12) are likely seconds and are returned as-is.
+ *
+ * @param ts - timestamp in milliseconds or seconds
+ * @param smart - enable heuristic detection (default: true)
+ * @returns timestamp in seconds
+ */
+declare function timestampMillisecondsToSeconds(ts: number, smart?: boolean): number;
+/**
+ * Convert a timestamp in seconds to milliseconds.
+ *
+ * When `smart` is true the function tries to detect already-millisecond
+ * values and returns them unchanged (heuristic threshold). Very large
+ * numbers (> 1e12) are assumed to already be milliseconds.
+ *
+ * @param ts - timestamp in seconds or milliseconds
+ * @param smart - enable heuristic detection (default: true)
+ * @returns timestamp in milliseconds
+ */
+declare function timestampSecondsToMilliseconds(ts: number, smart?: boolean): number;
+/** Number of milliseconds in (approx.) one year (365 days). */
+declare const TIME_YEAR_MS = 31536000000;
+/** Number of seconds in (approx.) one year (365 days). */
+declare const TIME_YEAR_S = 31536000;
+/** Number of milliseconds in (approx.) one month (30 days). */
+declare const TIME_MONTH_MS = 2592000000;
+/** Number of seconds in (approx.) one month (30 days). */
+declare const TIME_MONTH_S = 2592000;
+/** Number of milliseconds in one week (7 days). */
+declare const TIME_WEEK_MS = 604800000;
+/** Number of seconds in one week (7 days). */
+declare const TIME_WEEK_S = 604800;
+/** Number of milliseconds in one day (24 hours). */
+declare const TIME_DAY_MS = 86400000;
+/** Number of seconds in one day (24 hours). */
+declare const TIME_DAY_S = 86400;
+/** Number of milliseconds in one hour (60 minutes). */
+declare const TIME_HOUR_MS = 3600000;
+/** Number of seconds in one hour (60 minutes). */
+declare const TIME_HOUR_S = 3600;
+/** Number of milliseconds in one minute (60 seconds). */
+declare const TIME_MINUTE_MS = 60000;
+/** Number of seconds in one minute (60 seconds). */
+declare const TIME_MINUTE_S = 60;
+/** Build number is minutes since 2025-01-01 in base32 "agnoster" encoded format */
+declare function getBuildNumber(): string;
+declare function getSecondsFromBuildNumber(buildNumber: string): number;
+//#endregion
+export { parseDate as C, timestampSecondsToMilliseconds as E, getTimestampInSeconds as S, timestampMillisecondsToSeconds as T, formatMilliseconds as _, TIME_MINUTE_MS as a, getSecondsFromBuildNumber as b, TIME_MONTH_S as c, TIME_YEAR_MS as d, TIME_YEAR_S as f, duration as g, datetimeToUTC as h, TIME_HOUR_S as i, TIME_WEEK_MS as l, datetimeToLocal as m, TIME_DAY_S as n, TIME_MINUTE_S as o, dateFromSeconds as p, TIME_HOUR_MS as r, TIME_MONTH_MS as s, TIME_DAY_MS as t, TIME_WEEK_S as u, getBuildNumber as v, setTimestampTest as w, getTimestamp as x, getPerformanceTimestamp as y };
+//# sourceMappingURL=time-DxE-vjjw.d.mts.map

package/dist/timeout-CnUk6Ruj.d.mts

@@ -0,0 +1,13 @@
+//#region src/common/timeout.d.ts
+/**
+ * Slightliy enhanced setTimeout to avoid garbage collection issues.
+ * Returns a dispose function.
+ *
+ * Discussion see
+ * https://jakearchibald.com/2024/garbage-collection-and-closures/
+ * https://news.ycombinator.com/item?id=41111062
+ */
+declare function safeTimeout(fn: () => void, delay?: number, unref?: boolean): () => void;
+//#endregion
+export { safeTimeout as t };
+//# sourceMappingURL=timeout-CnUk6Ruj.d.mts.map

package/dist/timeout-CpFcK8MD.d.cts

@@ -0,0 +1,13 @@
+//#region src/common/timeout.d.ts
+/**
+ * Slightliy enhanced setTimeout to avoid garbage collection issues.
+ * Returns a dispose function.
+ *
+ * Discussion see
+ * https://jakearchibald.com/2024/garbage-collection-and-closures/
+ * https://news.ycombinator.com/item?id=41111062
+ */
+declare function safeTimeout(fn: () => void, delay?: number, unref?: boolean): () => void;
+//#endregion
+export { safeTimeout as t };
+//# sourceMappingURL=timeout-CpFcK8MD.d.cts.map

package/dist/type-test-BiKyEZkc.d.mts

@@ -0,0 +1,6 @@
+//#region src/common/schema/type-test.d.ts
+type Expect<T extends true> = T;
+type IsEqual<X, Y> = (<T>() => T extends X ? true : false) extends (<T>() => T extends Y ? true : false) ? true : false;
+//#endregion
+export { IsEqual as n, Expect as t };
+//# sourceMappingURL=type-test-BiKyEZkc.d.mts.map

package/dist/type-test-sM7QpfQU.d.cts

@@ -0,0 +1,6 @@
+//#region src/common/schema/type-test.d.ts
+type Expect<T extends true> = T;
+type IsEqual<X, Y> = (<T>() => T extends X ? true : false) extends (<T>() => T extends Y ? true : false) ? true : false;
+//#endregion
+export { IsEqual as n, Expect as t };
+//# sourceMappingURL=type-test-sM7QpfQU.d.cts.map

package/dist/types-BCtWYsuv.d.cts

@@ -0,0 +1,15 @@
+//#region src/common/types.d.ts
+type Json = string | number | boolean | null | {
+  [property: string]: Json;
+} | Json[];
+interface ObjectStorage<T = any> {
+  setItem: (key: string, value: T) => void;
+  getItem: (key: string) => T | undefined;
+  removeItem: (key: string) => void;
+  clear: () => void;
+  allKeys: () => string[];
+}
+type NestedArray<T> = T | Array<NestedArray<T>>;
+//#endregion
+export { NestedArray as n, ObjectStorage as r, Json as t };
+//# sourceMappingURL=types-BCtWYsuv.d.cts.map

package/dist/types-ejoFe34F.d.mts

@@ -0,0 +1,15 @@
+//#region src/common/types.d.ts
+type Json = string | number | boolean | null | {
+  [property: string]: Json;
+} | Json[];
+interface ObjectStorage<T = any> {
+  setItem: (key: string, value: T) => void;
+  getItem: (key: string) => T | undefined;
+  removeItem: (key: string) => void;
+  clear: () => void;
+  allKeys: () => string[];
+}
+type NestedArray<T> = T | Array<NestedArray<T>>;
+//#endregion
+export { NestedArray as n, ObjectStorage as r, Json as t };
+//# sourceMappingURL=types-ejoFe34F.d.mts.map

package/dist/url-4ihUPRLi.d.cts

@@ -0,0 +1,13 @@
+//#region src/common/data/url.d.ts
+declare function toHumanReadableUrl(url: string): string;
+declare const RX_URL: RegExp;
+/** @deprecated use linkifyPlainText */
+declare function linkifyPlainTextSimple(text: string): string;
+interface LinkifyOptions {}
+declare function linkifyPlainText(text: string, options?: LinkifyOptions): string;
+declare function linkifyPlainTextWithLineBreaks(text: string, options?: LinkifyOptions): string;
+declare function encodeQuery(data: Record<string, any>, filterValue?: (value: any) => boolean): string;
+declare function parseQuery(queryString: string): any;
+//#endregion
+export { linkifyPlainTextSimple as a, toHumanReadableUrl as c, linkifyPlainText as i, RX_URL as n, linkifyPlainTextWithLineBreaks as o, encodeQuery as r, parseQuery as s, LinkifyOptions as t };
+//# sourceMappingURL=url-4ihUPRLi.d.cts.map

package/dist/url-Bz-wgbtY.d.mts

@@ -0,0 +1,13 @@
+//#region src/common/data/url.d.ts
+declare function toHumanReadableUrl(url: string): string;
+declare const RX_URL: RegExp;
+/** @deprecated use linkifyPlainText */
+declare function linkifyPlainTextSimple(text: string): string;
+interface LinkifyOptions {}
+declare function linkifyPlainText(text: string, options?: LinkifyOptions): string;
+declare function linkifyPlainTextWithLineBreaks(text: string, options?: LinkifyOptions): string;
+declare function encodeQuery(data: Record<string, any>, filterValue?: (value: any) => boolean): string;
+declare function parseQuery(queryString: string): any;
+//#endregion
+export { linkifyPlainTextSimple as a, toHumanReadableUrl as c, linkifyPlainText as i, RX_URL as n, linkifyPlainTextWithLineBreaks as o, encodeQuery as r, parseQuery as s, LinkifyOptions as t };
+//# sourceMappingURL=url-Bz-wgbtY.d.mts.map

package/dist/utils-B8DsVgFr.d.mts

@@ -0,0 +1,11 @@
+import { n as Type } from "./schema-eMFkYY24.mjs";
+
+//#region src/common/schema/utils.d.ts
+declare function isSchemaObject(schema: Type<any>): boolean;
+declare function isSchemaOptional(schema: Type<any>): boolean;
+declare function isSchemaDefault(schema: Type<any>): boolean;
+declare function isSchemaPrimitive(schema: Type<any>): boolean;
+declare function isSchemaObjectFlat(schema: Type<any>): boolean;
+//#endregion
+export { isSchemaPrimitive as a, isSchemaOptional as i, isSchemaObject as n, isSchemaObjectFlat as r, isSchemaDefault as t };
+//# sourceMappingURL=utils-B8DsVgFr.d.mts.map

package/dist/utils-Bctk_WhH.d.cts

@@ -0,0 +1,11 @@
+import { n as Type } from "./schema-BNke0iHR.cjs";
+
+//#region src/common/schema/utils.d.ts
+declare function isSchemaObject(schema: Type<any>): boolean;
+declare function isSchemaOptional(schema: Type<any>): boolean;
+declare function isSchemaDefault(schema: Type<any>): boolean;
+declare function isSchemaPrimitive(schema: Type<any>): boolean;
+declare function isSchemaObjectFlat(schema: Type<any>): boolean;
+//#endregion
+export { isSchemaPrimitive as a, isSchemaOptional as i, isSchemaObject as n, isSchemaObjectFlat as r, isSchemaDefault as t };
+//# sourceMappingURL=utils-Bctk_WhH.d.cts.map

package/dist/utils-BfZkD2Pt.d.mts

@@ -0,0 +1,5 @@
+//#region src/common/utils.d.ts
+declare function noop(): void;
+//#endregion
+export { noop as t };
+//# sourceMappingURL=utils-BfZkD2Pt.d.mts.map

package/dist/utils-DHQBNh-Z.d.cts

@@ -0,0 +1,5 @@
+//#region src/common/utils.d.ts
+declare function noop(): void;
+//#endregion
+export { noop as t };
+//# sourceMappingURL=utils-DHQBNh-Z.d.cts.map

package/dist/utils-DX0sASsJ.d.mts

@@ -0,0 +1,45 @@
+import { t as Json } from "./types-ejoFe34F.mjs";
+
+//#region src/common/data/utils.d.ts
+/**
+ * Call a create function if key does not yet exist on an object. Returns the found or created object. Example:
+ *
+ * ```js
+ * function createRoom(room, rooms) { return new Room() }
+ * ensureKey(rooms, room, createRoom).enter()
+ * ```
+ */
+declare function ensureKey<T>(obj: Record<string, T>, key: string, createFn: (key?: string, obj?: Record<string, T>) => T): T;
+/**
+ * Call a create function if key does not yet exist on an object. Returns the found or created object. Example:
+ *
+ * ```js
+ * async function fetchItem(id, cache) { ... }
+ * let data = await ensureKey(cache, id, fetchItem)
+ * ```
+ */
+declare function ensureKeyAsync<T>(obj: Record<string, T>, key: string, createFn: (key?: string, obj?: Record<string, T>) => Promise<T>): Promise<T>;
+/**
+ * Returns the size of an object, array, string or similar. For example:
+ */
+declare function size(obj: any): any;
+declare function first<T>(array?: T[]): T | undefined;
+declare function last<T>(array?: T[]): T | undefined;
+declare function empty(value: any): boolean;
+declare function cloneObject<T>(obj: T): T;
+declare function cloneJsonObject<T = Json>(obj: T): T;
+/**
+ * Cache result of a function. Same arguments have to always return the same result in order to get expected optimization!
+ *
+ * ```
+ * const square = memoize((value) => value * value)`
+ * square(2) // == 2
+ * ```
+ */
+declare function memoize<In, Out>(fn: (arg: In) => Out): (arg: In) => Out;
+declare function memoizeAsync<In extends any[], Out extends Promise<any>>(fn: (...arg: In) => Out): (...arg: In) => Promise<Out>;
+/** Repeat `count` times. Starts with `0` */
+declare function forTimes<T = undefined>(count: number, fn: (i: number, count: number) => T): T[];
+//#endregion
+export { ensureKeyAsync as a, last as c, size as d, ensureKey as i, memoize as l, cloneObject as n, first as o, empty as r, forTimes as s, cloneJsonObject as t, memoizeAsync as u };
+//# sourceMappingURL=utils-DX0sASsJ.d.mts.map

package/dist/utils-DxFqV18u.d.cts

@@ -0,0 +1,45 @@
+import { t as Json } from "./types-BCtWYsuv.cjs";
+
+//#region src/common/data/utils.d.ts
+/**
+ * Call a create function if key does not yet exist on an object. Returns the found or created object. Example:
+ *
+ * ```js
+ * function createRoom(room, rooms) { return new Room() }
+ * ensureKey(rooms, room, createRoom).enter()
+ * ```
+ */
+declare function ensureKey<T>(obj: Record<string, T>, key: string, createFn: (key?: string, obj?: Record<string, T>) => T): T;
+/**
+ * Call a create function if key does not yet exist on an object. Returns the found or created object. Example:
+ *
+ * ```js
+ * async function fetchItem(id, cache) { ... }
+ * let data = await ensureKey(cache, id, fetchItem)
+ * ```
+ */
+declare function ensureKeyAsync<T>(obj: Record<string, T>, key: string, createFn: (key?: string, obj?: Record<string, T>) => Promise<T>): Promise<T>;
+/**
+ * Returns the size of an object, array, string or similar. For example:
+ */
+declare function size(obj: any): any;
+declare function first<T>(array?: T[]): T | undefined;
+declare function last<T>(array?: T[]): T | undefined;
+declare function empty(value: any): boolean;
+declare function cloneObject<T>(obj: T): T;
+declare function cloneJsonObject<T = Json>(obj: T): T;
+/**
+ * Cache result of a function. Same arguments have to always return the same result in order to get expected optimization!
+ *
+ * ```
+ * const square = memoize((value) => value * value)`
+ * square(2) // == 2
+ * ```
+ */
+declare function memoize<In, Out>(fn: (arg: In) => Out): (arg: In) => Out;
+declare function memoizeAsync<In extends any[], Out extends Promise<any>>(fn: (...arg: In) => Out): (...arg: In) => Promise<Out>;
+/** Repeat `count` times. Starts with `0` */
+declare function forTimes<T = undefined>(count: number, fn: (i: number, count: number) => T): T[];
+//#endregion
+export { ensureKeyAsync as a, last as c, size as d, ensureKey as i, memoize as l, cloneObject as n, first as o, empty as r, forTimes as s, cloneJsonObject as t, memoizeAsync as u };
+//# sourceMappingURL=utils-DxFqV18u.d.cts.map