zeed 1.2.4 → 1.3.0

package/dist/day-DuVjyrK6.d.mts

@@ -0,0 +1,206 @@
+//#region src/common/data/day.d.ts
+/**
+ * Enable test mode for date functions by forcing "today" to a fixed day value.
+ *
+ * Use a numeric DayValue like 20000101 (YYYYMMDD). This is intended for tests
+ * to make date-based logic deterministic. Call with no args to reset.
+ *
+ * @param ts - day to use as "today" in YYYYMMDD format (default: 20000101)
+ */
+declare function setDayTest(ts?: number): void;
+/**
+ * @deprecated use TIME_DAY_MS
+ * Number of milliseconds in one calendar day (24 * 60 * 60 * 1000). */
+declare const DAY_MS = 86400000;
+/** DayValue is a numeric date encoded as YYYYMMDD (for example 20250907). */
+type DayValue = number;
+/**
+ * Accepted inputs for day conversion helpers.
+ * - DayValue or number: a YYYYMMDD numeric value
+ * - string: a date string (parsed by digits)
+ * - Date: JavaScript Date
+ * - [year, month?, day?]: numeric parts
+ */
+type DayInput = DayValue | number | string | Date | [number, number?, number?];
+/**
+ * Extract the year (YYYY) from a DayValue.
+ *
+ * @param day - day as YYYYMMDD
+ * @returns year as number (e.g. 2025)
+ */
+declare function dayYear(day: DayValue): DayValue;
+/**
+ * Extract the month (1-12) from a DayValue.
+ *
+ * @param day - day as YYYYMMDD
+ * @returns month number (1-12)
+ */
+declare function dayMonth(day: DayValue): DayValue;
+/**
+ * Extract the day of month (1-31) from a DayValue.
+ *
+ * @param day - day as YYYYMMDD
+ * @returns day of month (1-31)
+ */
+declare function dayDay(day: DayValue): DayValue;
+/**
+ * Split a DayValue into [year, month, day].
+ *
+ * @param day - day as YYYYMMDD
+ * @returns tuple [year, month, day]
+ */
+declare function dayToParts(day: DayValue): [number, number, number];
+/**
+ * Convert a DayValue to a JavaScript Date.
+ *
+ * By default returns a local Date at midnight for the day. If `utc` is true
+ * the returned Date represents midnight UTC for that day.
+ *
+ * @param day - day as YYYYMMDD
+ * @param utc - whether to construct the Date in UTC (default: false)
+ * @returns Date object for the given day
+ */
+declare function dayToDate(day: DayValue, utc?: boolean): Date;
+/**
+ * Return today's day as a DayValue (YYYYMMDD).
+ *
+ * If test mode has been enabled via `setDayTest` this returns the forced
+ * value instead. Otherwise it uses the current local date.
+ */
+declare function dayFromToday(): DayValue;
+/**
+ * Convert multiple input types to a DayValue (YYYYMMDD).
+ *
+ * Supports numbers (DayValue), strings, Date objects and [year, month?, day?]
+ * tuples. Returns undefined for invalid or unsupported values.
+ *
+ * @param value - input to convert
+ * @param utc - when converting from Date, interpret as UTC if true
+ */
+declare function dayFromAny(value: DayInput, utc?: boolean): DayValue | undefined;
+/** Convert a DayValue to a Date at midnight UTC. */
+declare function dayToDateUTC(day: DayValue): Date;
+/**
+ * @deprecated use dayToDateUTC
+ *
+ * Kept for backwards compatibility; returns a Date for midnight UTC.
+ */
+declare function dayToDateGMT(day: DayValue): Date;
+/**
+ * Convert a JavaScript Date to a DayValue (YYYYMMDD).
+ *
+ * If `utc` is true the function uses the ISO string representation to
+ * calculate the day in UTC. Otherwise it uses local date components.
+ */
+declare function dayFromDate(date: Date, utc?: boolean): DayValue;
+/** Convert a Date to DayValue using UTC. */
+declare function dayFromDateUTC(date: Date): DayValue;
+/** @deprecated use dayFromDateUTC */
+/**
+ * Deprecated: use `dayFromDateUTC`.
+ *
+ * Kept for backwards compatibility; converts a Date to a UTC DayValue.
+ */
+declare function dayFromDateGMT(date: Date): DayValue;
+/**
+ * Convert a DayValue to a UNIX timestamp in seconds. Returns seconds since
+ * epoch for midnight of the given day. Defaults to UTC.
+ */
+declare function dayToTimestampSeconds(day: DayValue, utc?: boolean): number;
+/**
+ * Convert a DayValue to a timestamp in milliseconds for midnight of that day.
+ * Defaults to UTC when constructing the Date.
+ */
+declare function dayToTimestamp(day: DayValue, utc?: boolean): number;
+/**
+ * Convert a timestamp in milliseconds to a DayValue. The timestamp is turned
+ * into a Date and then converted; `utc` controls interpretation.
+ */
+declare function dayFromTimestamp(ms: number, utc?: boolean): DayValue;
+/**
+ * Convert a UNIX timestamp in seconds to a DayValue.
+ *
+ * @param ms - seconds since epoch
+ */
+declare function dayFromTimestampSeconds(ms: number, utc?: boolean): DayValue;
+/**
+ * Format a DayValue as a string with an optional separator.
+ *
+ * Example: dayToString(20250907) -> "2025-09-07"
+ */
+declare function dayToString(day: DayValue, sep?: string): string;
+/**
+ * Build a DayValue from numeric parts. Returns undefined for invalid parts.
+ *
+ * @param year - full year (e.g. 2025)
+ * @param month - 1-12 (default 1)
+ * @param day - 1-31 (default 1)
+ */
+declare function dayFromParts(year: number, month?: number, day?: number): DayValue | undefined;
+/**
+ * Parse a string into a DayValue by extracting up to 8 digits (YYYYMMDD).
+ * Returns undefined for invalid results.
+ *
+ * Example:
+ * dayValue === dayFromString(String(dayValue))
+ */
+declare function dayFromString(value: string): DayValue | undefined;
+/**
+ * Return the first day of the month for the given DayValue. An optional
+ * `offset` (positive or negative) moves the result by months.
+ *
+ * @param day - source DayValue
+ * @param offset - months to offset (default 0)
+ */
+declare function dayMonthStart(day: DayValue, offset?: number): DayValue;
+/**
+ * Return the day offset by whole months, keeping the day-of-month when possible.
+ * If the target month has fewer days, the result is clamped to the last day.
+ *
+ * @param day - source DayValue
+ * @param offset - months to offset (positive or negative)
+ */
+declare function dayMonthOffset(day: DayValue, offset: number): DayValue;
+/**
+ * Return the first day of the year for the given DayValue. `offset` moves
+ * the year by the given amount.
+ */
+declare function dayYearStart(day: DayValue, offset?: number): DayValue;
+/**
+ * Return the day offset by whole years, keeping month and day when possible.
+ * If the target month has fewer days, the result is clamped to the last day.
+ *
+ * @param day - source DayValue
+ * @param offset - years to offset (positive or negative)
+ */
+declare function dayYearOffset(day: DayValue, offset: number): DayValue;
+/** Return number of days in a given month. Month is 1-12. */
+declare function dayDaysInMonth(year: number, month: number): number;
+/**
+ * Offset a DayValue by a number of days. Uses timestamp math to avoid local
+ * DST issues.
+ *
+ * @param day - source DayValue
+ * @param offset - days to add (negative to subtract)
+ */
+declare function dayOffset(day: DayValue, offset: number): DayValue;
+/**
+ * Compute the difference in whole days between two DayValues (right - left).
+ */
+declare function dayDiff(left: DayValue, right: DayValue): number;
+/**
+ * Return an array of DayValues from left to right (inclusive).
+ *
+ * If `right` is omitted it defaults to today. If `left` is negative it is
+ * interpreted as an offset relative to `right` (e.g. -7 means the last 7 days).
+ */
+declare function dayRange(left: DayValue, right?: DayValue): number[];
+/** Iterator, see dayRange */
+/**
+ * Generator that yields DayValues from left to right (inclusive). Same rules
+ * as `dayRange` regarding defaults and negative left values.
+ */
+declare function dayIterator(left: DayValue, right?: DayValue): Generator<number, number[], unknown>;
+//#endregion
+export { dayYearOffset as A, dayToDateGMT as C, dayToTimestamp as D, dayToString as E, setDayTest as M, dayToTimestampSeconds as O, dayToDate as S, dayToParts as T, dayMonth as _, dayDaysInMonth as a, dayOffset as b, dayFromDate as c, dayFromParts as d, dayFromString as f, dayIterator as g, dayFromToday as h, dayDay as i, dayYearStart as j, dayYear as k, dayFromDateGMT as l, dayFromTimestampSeconds as m, DayInput as n, dayDiff as o, dayFromTimestamp as p, DayValue as r, dayFromAny as s, DAY_MS as t, dayFromDateUTC as u, dayMonthOffset as v, dayToDateUTC as w, dayRange as x, dayMonthStart as y };
+//# sourceMappingURL=day-DuVjyrK6.d.mts.map

package/dist/day-legacy-DZUpxFsu.d.cts

@@ -0,0 +1,47 @@
+import { n as DayInput, r as DayValue } from "./day-Db1kbQMd.cjs";
+
+//#region src/common/data/day-legacy.d.ts
+type DayInputLegacy = DayInput | Day;
+/**
+ * Date represented as positive integer value. Years smaller 0 are not supported.
+ * @deprecated
+ */
+declare class Day {
+  days: DayValue;
+  get value(): number;
+  constructor(days?: DayInputLegacy);
+  static fromNumber(n: number): Day;
+  static fromString(dateString: string): Day | undefined;
+  static fromDate(date: Date, utc?: boolean): Day;
+  static fromDateUTC(date: Date): Day;
+  /** @deprecated use fromDateUTC */
+  static fromDateGMT(date: Date): Day;
+  static from(value: DayInputLegacy, utc?: boolean): Day | undefined;
+  toNumber(): number;
+  /** Just for future extensions */
+  toJson(): number;
+  toString(sep?: string): string;
+  toDate(utc?: boolean): Date;
+  toDateUTC(): Date;
+  /** @deprecated use toDateUTC */
+  toDateGMT(): Date;
+  get year(): number;
+  get month(): number;
+  get day(): number;
+  dayOffset(offset: number): Day;
+  monthStart(): Day;
+  yearStart(): Day;
+  /** Very stupid approach, only works for days <= 28 */
+  monthOffset(offset: number): Day;
+  daysUntil(otherDay: DayInputLegacy): number;
+  yesterday(): Day;
+  tomorrow(): Day;
+}
+declare function forEachDay(from: DayInputLegacy, to: DayInputLegacy, handler: (date: Day) => Promise<void> | void): Promise<void>;
+declare function today(): Day;
+/** @deprecated */
+declare function day(days?: DayInputLegacy): Day;
+declare function dateStringToDays(dateString: string): number;
+//#endregion
+export { forEachDay as a, day as i, DayInputLegacy as n, today as o, dateStringToDays as r, Day as t };
+//# sourceMappingURL=day-legacy-DZUpxFsu.d.cts.map

package/dist/day-legacy-y_LR0llQ.d.mts

@@ -0,0 +1,47 @@
+import { n as DayInput, r as DayValue } from "./day-DuVjyrK6.mjs";
+
+//#region src/common/data/day-legacy.d.ts
+type DayInputLegacy = DayInput | Day;
+/**
+ * Date represented as positive integer value. Years smaller 0 are not supported.
+ * @deprecated
+ */
+declare class Day {
+  days: DayValue;
+  get value(): number;
+  constructor(days?: DayInputLegacy);
+  static fromNumber(n: number): Day;
+  static fromString(dateString: string): Day | undefined;
+  static fromDate(date: Date, utc?: boolean): Day;
+  static fromDateUTC(date: Date): Day;
+  /** @deprecated use fromDateUTC */
+  static fromDateGMT(date: Date): Day;
+  static from(value: DayInputLegacy, utc?: boolean): Day | undefined;
+  toNumber(): number;
+  /** Just for future extensions */
+  toJson(): number;
+  toString(sep?: string): string;
+  toDate(utc?: boolean): Date;
+  toDateUTC(): Date;
+  /** @deprecated use toDateUTC */
+  toDateGMT(): Date;
+  get year(): number;
+  get month(): number;
+  get day(): number;
+  dayOffset(offset: number): Day;
+  monthStart(): Day;
+  yearStart(): Day;
+  /** Very stupid approach, only works for days <= 28 */
+  monthOffset(offset: number): Day;
+  daysUntil(otherDay: DayInputLegacy): number;
+  yesterday(): Day;
+  tomorrow(): Day;
+}
+declare function forEachDay(from: DayInputLegacy, to: DayInputLegacy, handler: (date: Day) => Promise<void> | void): Promise<void>;
+declare function today(): Day;
+/** @deprecated */
+declare function day(days?: DayInputLegacy): Day;
+declare function dateStringToDays(dateString: string): number;
+//#endregion
+export { forEachDay as a, day as i, DayInputLegacy as n, today as o, dateStringToDays as r, Day as t };
+//# sourceMappingURL=day-legacy-y_LR0llQ.d.mts.map

package/dist/decimal-B9ODzKIH.d.cts

@@ -0,0 +1,17 @@
+//#region src/common/data/decimal.d.ts
+type DecimalValue = number;
+type DecimalInput = number | string | DecimalValue;
+/**
+ * The float returned is guaraneteed to have only the `decimalPlaces` length,
+ * no rounding errors or float arithmetic artefacts.
+ */
+declare function decimal(value: DecimalInput, decimalPlaces?: number): DecimalValue;
+/** `123` becomes `1.23` */
+declare function decimalFromCents(value: DecimalInput, decimalPlaces?: number): DecimalValue;
+/** `1.23` becomes `123` */
+declare function decimalToCents(value: DecimalInput, decimalPlaces?: number): number;
+/** `1.23` becomes `23` */
+declare function decimalCentsPart(value: DecimalInput, decimalPlaces?: number): DecimalValue;
+//#endregion
+export { decimalFromCents as a, decimalCentsPart as i, DecimalValue as n, decimalToCents as o, decimal as r, DecimalInput as t };
+//# sourceMappingURL=decimal-B9ODzKIH.d.cts.map

package/dist/decimal-CyyKSk3e.d.mts

@@ -0,0 +1,17 @@
+//#region src/common/data/decimal.d.ts
+type DecimalValue = number;
+type DecimalInput = number | string | DecimalValue;
+/**
+ * The float returned is guaraneteed to have only the `decimalPlaces` length,
+ * no rounding errors or float arithmetic artefacts.
+ */
+declare function decimal(value: DecimalInput, decimalPlaces?: number): DecimalValue;
+/** `123` becomes `1.23` */
+declare function decimalFromCents(value: DecimalInput, decimalPlaces?: number): DecimalValue;
+/** `1.23` becomes `123` */
+declare function decimalToCents(value: DecimalInput, decimalPlaces?: number): number;
+/** `1.23` becomes `23` */
+declare function decimalCentsPart(value: DecimalInput, decimalPlaces?: number): DecimalValue;
+//#endregion
+export { decimalFromCents as a, decimalCentsPart as i, DecimalValue as n, decimalToCents as o, decimal as r, DecimalInput as t };
+//# sourceMappingURL=decimal-CyyKSk3e.d.mts.map

package/dist/deep-CwDKF2Ly.d.cts

@@ -0,0 +1,8 @@
+//#region src/common/data/deep.d.ts
+declare function deepEqual(a: any, b: any, hash?: WeakSet<object>): boolean;
+/** Strip properties with value `undefined` in place */
+declare function deepStripUndefinedInPlace(a: any, hash?: WeakSet<object>): any;
+declare function deepMerge(target: any, ...sources: any[]): any;
+//#endregion
+export { deepMerge as n, deepStripUndefinedInPlace as r, deepEqual as t };
+//# sourceMappingURL=deep-CwDKF2Ly.d.cts.map

package/dist/deep-DAt8YjIm.d.mts

@@ -0,0 +1,8 @@
+//#region src/common/data/deep.d.ts
+declare function deepEqual(a: any, b: any, hash?: WeakSet<object>): boolean;
+/** Strip properties with value `undefined` in place */
+declare function deepStripUndefinedInPlace(a: any, hash?: WeakSet<object>): any;
+declare function deepMerge(target: any, ...sources: any[]): any;
+//#endregion
+export { deepMerge as n, deepStripUndefinedInPlace as r, deepEqual as t };
+//# sourceMappingURL=deep-DAt8YjIm.d.mts.map

package/dist/diff-CP3d9TYo.d.cts

@@ -0,0 +1,30 @@
+//#region src/common/data/diff.d.ts
+type DifferenceType = 'new' | 'upd' | 'del';
+interface Difference {
+  type: DifferenceType;
+  path: (string | number)[];
+  value?: any;
+}
+interface DiffOptions {
+  cyclesFix: boolean;
+}
+/**
+ * Describes the changes between to object with a list like:
+ *
+ * ```
+ * [{
+ *    type: 'upd',
+ *    path: ['a'],
+ *    value: 1
+ * },
+ * {
+ *    type: 'del',
+ *    path: ['b', 'c']
+ * }
+ * ...]
+ * ```
+ */
+declare function diffObjects(obj: Record<string, any> | any[], newObj: Record<string, any> | any[], options?: Partial<DiffOptions>, _stack?: Record<string, any>[]): Difference[];
+//#endregion
+export { diffObjects as i, Difference as n, DifferenceType as r, DiffOptions as t };
+//# sourceMappingURL=diff-CP3d9TYo.d.cts.map

package/dist/diff-DM-YgQPY.d.mts

@@ -0,0 +1,30 @@
+//#region src/common/data/diff.d.ts
+type DifferenceType = 'new' | 'upd' | 'del';
+interface Difference {
+  type: DifferenceType;
+  path: (string | number)[];
+  value?: any;
+}
+interface DiffOptions {
+  cyclesFix: boolean;
+}
+/**
+ * Describes the changes between to object with a list like:
+ *
+ * ```
+ * [{
+ *    type: 'upd',
+ *    path: ['a'],
+ *    value: 1
+ * },
+ * {
+ *    type: 'del',
+ *    path: ['b', 'c']
+ * }
+ * ...]
+ * ```
+ */
+declare function diffObjects(obj: Record<string, any> | any[], newObj: Record<string, any> | any[], options?: Partial<DiffOptions>, _stack?: Record<string, any>[]): Difference[];
+//#endregion
+export { diffObjects as i, Difference as n, DifferenceType as r, DiffOptions as t };
+//# sourceMappingURL=diff-DM-YgQPY.d.mts.map

package/dist/dispose-defer-BoCXEHoJ.d.cts

@@ -0,0 +1,40 @@
+import { _ as LoggerInterface } from "./log-base-omQ8fkjE.cjs";
+import { n as DisposerFunction } from "./dispose-types-CVL-NcAL.cjs";
+
+//#region src/common/dispose-defer.d.ts
+declare function polyfillUsing(): void;
+/** A disposable entry: either a function or an object with a dispose() method. */
+type DisposableEntry = DisposerFunction | {
+  dispose: DisposerFunction;
+};
+interface UseDisposeConfig {
+  name?: string;
+  log?: LoggerInterface;
+}
+declare function useDispose(opt?: string | UseDisposeConfig | LoggerInterface): ((strictSync?: boolean) => Promise<any> | void) & {
+  /** Counter that increments each time dispose has been called */readonly disposed: number;
+  add: (obj?: DisposableEntry) => DisposerFunction | undefined;
+  remove: (disposable: DisposableEntry) => Promise<void> | void; /** @deprecated use add */
+  track: (obj?: DisposableEntry) => DisposerFunction | undefined; /** @deprecated use remove */
+  untrack: (disposable: DisposableEntry) => Promise<void> | void;
+  dispose: (strictSync?: boolean) => Promise<any> | void;
+  disposeSync: () => void;
+  sync: () => void; /** @deprecated use dispose */
+  exec: (strictSync?: boolean) => Promise<any> | void;
+  getSize(): number;
+  isDisposed(): boolean;
+  [Symbol.dispose](): void | Promise<any>;
+  [Symbol.asyncDispose](): Promise<any>;
+};
+type UseDispose = ReturnType<typeof useDispose>;
+declare function useDefer(config?: {
+  mode?: 'lifo' | 'fifo';
+}): ((expectSync?: boolean) => Promise<void>) & {
+  add: (obj: DisposableEntry) => void;
+  exec: (expectSync?: boolean) => Promise<void>;
+  getSize(): number;
+};
+type UseDefer = ReturnType<typeof useDefer>;
+//#endregion
+export { useDefer as a, polyfillUsing as i, UseDispose as n, useDispose as o, UseDisposeConfig as r, UseDefer as t };
+//# sourceMappingURL=dispose-defer-BoCXEHoJ.d.cts.map

package/dist/dispose-defer-Dr619CtL.d.mts

@@ -0,0 +1,40 @@
+import { _ as LoggerInterface } from "./log-base-BP-JwjKY.mjs";
+import { n as DisposerFunction } from "./dispose-types-Duihe1hZ.mjs";
+
+//#region src/common/dispose-defer.d.ts
+declare function polyfillUsing(): void;
+/** A disposable entry: either a function or an object with a dispose() method. */
+type DisposableEntry = DisposerFunction | {
+  dispose: DisposerFunction;
+};
+interface UseDisposeConfig {
+  name?: string;
+  log?: LoggerInterface;
+}
+declare function useDispose(opt?: string | UseDisposeConfig | LoggerInterface): ((strictSync?: boolean) => Promise<any> | void) & {
+  /** Counter that increments each time dispose has been called */readonly disposed: number;
+  add: (obj?: DisposableEntry) => DisposerFunction | undefined;
+  remove: (disposable: DisposableEntry) => Promise<void> | void; /** @deprecated use add */
+  track: (obj?: DisposableEntry) => DisposerFunction | undefined; /** @deprecated use remove */
+  untrack: (disposable: DisposableEntry) => Promise<void> | void;
+  dispose: (strictSync?: boolean) => Promise<any> | void;
+  disposeSync: () => void;
+  sync: () => void; /** @deprecated use dispose */
+  exec: (strictSync?: boolean) => Promise<any> | void;
+  getSize(): number;
+  isDisposed(): boolean;
+  [Symbol.dispose](): void | Promise<any>;
+  [Symbol.asyncDispose](): Promise<any>;
+};
+type UseDispose = ReturnType<typeof useDispose>;
+declare function useDefer(config?: {
+  mode?: 'lifo' | 'fifo';
+}): ((expectSync?: boolean) => Promise<void>) & {
+  add: (obj: DisposableEntry) => void;
+  exec: (expectSync?: boolean) => Promise<void>;
+  getSize(): number;
+};
+type UseDefer = ReturnType<typeof useDefer>;
+//#endregion
+export { useDefer as a, polyfillUsing as i, UseDispose as n, useDispose as o, UseDisposeConfig as r, UseDefer as t };
+//# sourceMappingURL=dispose-defer-Dr619CtL.d.mts.map

package/dist/dispose-types-CVL-NcAL.d.cts

@@ -0,0 +1,9 @@
+//#region src/common/dispose-types.d.ts
+type DisposerFunction = () => any | Promise<any>;
+/** @deprecated conflicts with `using` feature */
+type Disposer = DisposerFunction | {
+  dispose: DisposerFunction;
+};
+//#endregion
+export { DisposerFunction as n, Disposer as t };
+//# sourceMappingURL=dispose-types-CVL-NcAL.d.cts.map

package/dist/dispose-types-Duihe1hZ.d.mts

@@ -0,0 +1,9 @@
+//#region src/common/dispose-types.d.ts
+type DisposerFunction = () => any | Promise<any>;
+/** @deprecated conflicts with `using` feature */
+type Disposer = DisposerFunction | {
+  dispose: DisposerFunction;
+};
+//#endregion
+export { DisposerFunction as n, Disposer as t };
+//# sourceMappingURL=dispose-types-Duihe1hZ.d.mts.map

package/dist/dispose-utils-CxMUhvzb.d.mts

@@ -0,0 +1,64 @@
+import { _ as LoggerInterface } from "./log-base-BP-JwjKY.mjs";
+import { n as DisposerFunction } from "./dispose-types-Duihe1hZ.mjs";
+import { r as UseDisposeConfig } from "./dispose-defer-Dr619CtL.mjs";
+
+//#region src/common/dispose-utils.d.ts
+type TimerExecFunction = () => void | Promise<void>;
+/** Returns a no-op disposer (shared instance, no allocation per call). */
+declare const noopDisposer: () => DisposerFunction;
+/**
+ * Executes a function after a specified timeout and returns a disposer function
+ * that can be used to cancel the timeout.
+ *
+ * @param fn - The function to execute after the timeout.
+ * @param timeout - The timeout duration in milliseconds (default: 0).
+ * @returns A disposer function that can be used to cancel the timeout.
+ */
+declare function useTimeout(fn: TimerExecFunction, timeout?: number): DisposerFunction;
+/**
+ * Executes a function repeatedly at a specified interval and returns a disposer function
+ * that can be used to stop the execution.
+ *
+ * @param fn - The function to be executed at the specified interval.
+ * @param interval - The interval (in milliseconds) at which the function should be executed.
+ * @returns A disposer function that can be used to stop the execution of the function.
+ */
+declare function useInterval(fn: TimerExecFunction, interval: number): DisposerFunction;
+/** The interval starts only, when the function is finished. */
+declare function useIntervalPause(fn: TimerExecFunction, interval: number, immediately?: boolean): DisposerFunction;
+declare function useEventListener(emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]): DisposerFunction;
+declare function useEventListenerOnce(emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]): DisposerFunction;
+/** Like useDispose but with shorthands for emitter and timers */
+declare function useDisposeWithUtils(config?: string | UseDisposeConfig | LoggerInterface): ((strictSync?: boolean) => Promise<any> | void) & {
+  readonly disposed: number;
+  add: (obj?: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => DisposerFunction | undefined;
+  remove: (disposable: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => Promise<void> | void;
+  track: (obj?: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => DisposerFunction | undefined;
+  untrack: (disposable: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => Promise<void> | void;
+  dispose: (strictSync?: boolean) => Promise<any> | void;
+  disposeSync: () => void;
+  sync: () => void;
+  exec: (strictSync?: boolean) => Promise<any> | void;
+  getSize(): number;
+  isDisposed(): boolean;
+  [Symbol.dispose](): void | Promise<any>;
+  [Symbol.asyncDispose](): Promise<any>;
+} & {
+  timeout: (fn: TimerExecFunction, timeout?: number) => DisposerFunction;
+  interval: (fn: TimerExecFunction, interval?: number) => DisposerFunction;
+  intervalPause: (fn: TimerExecFunction, interval?: number) => DisposerFunction;
+  on: (emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]) => DisposerFunction;
+  once: (emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]) => DisposerFunction;
+};
+type UseDisposeWithUtils = ReturnType<typeof useDisposeWithUtils>;
+//#endregion
+export { useEventListener as a, useIntervalPause as c, useDisposeWithUtils as i, useTimeout as l, UseDisposeWithUtils as n, useEventListenerOnce as o, noopDisposer as r, useInterval as s, TimerExecFunction as t };
+//# sourceMappingURL=dispose-utils-CxMUhvzb.d.mts.map

package/dist/dispose-utils-EQJPLtnc.d.cts

@@ -0,0 +1,64 @@
+import { _ as LoggerInterface } from "./log-base-omQ8fkjE.cjs";
+import { n as DisposerFunction } from "./dispose-types-CVL-NcAL.cjs";
+import { r as UseDisposeConfig } from "./dispose-defer-BoCXEHoJ.cjs";
+
+//#region src/common/dispose-utils.d.ts
+type TimerExecFunction = () => void | Promise<void>;
+/** Returns a no-op disposer (shared instance, no allocation per call). */
+declare const noopDisposer: () => DisposerFunction;
+/**
+ * Executes a function after a specified timeout and returns a disposer function
+ * that can be used to cancel the timeout.
+ *
+ * @param fn - The function to execute after the timeout.
+ * @param timeout - The timeout duration in milliseconds (default: 0).
+ * @returns A disposer function that can be used to cancel the timeout.
+ */
+declare function useTimeout(fn: TimerExecFunction, timeout?: number): DisposerFunction;
+/**
+ * Executes a function repeatedly at a specified interval and returns a disposer function
+ * that can be used to stop the execution.
+ *
+ * @param fn - The function to be executed at the specified interval.
+ * @param interval - The interval (in milliseconds) at which the function should be executed.
+ * @returns A disposer function that can be used to stop the execution of the function.
+ */
+declare function useInterval(fn: TimerExecFunction, interval: number): DisposerFunction;
+/** The interval starts only, when the function is finished. */
+declare function useIntervalPause(fn: TimerExecFunction, interval: number, immediately?: boolean): DisposerFunction;
+declare function useEventListener(emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]): DisposerFunction;
+declare function useEventListenerOnce(emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]): DisposerFunction;
+/** Like useDispose but with shorthands for emitter and timers */
+declare function useDisposeWithUtils(config?: string | UseDisposeConfig | LoggerInterface): ((strictSync?: boolean) => Promise<any> | void) & {
+  readonly disposed: number;
+  add: (obj?: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => DisposerFunction | undefined;
+  remove: (disposable: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => Promise<void> | void;
+  track: (obj?: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => DisposerFunction | undefined;
+  untrack: (disposable: DisposerFunction | {
+    dispose: DisposerFunction;
+  }) => Promise<void> | void;
+  dispose: (strictSync?: boolean) => Promise<any> | void;
+  disposeSync: () => void;
+  sync: () => void;
+  exec: (strictSync?: boolean) => Promise<any> | void;
+  getSize(): number;
+  isDisposed(): boolean;
+  [Symbol.dispose](): void | Promise<any>;
+  [Symbol.asyncDispose](): Promise<any>;
+} & {
+  timeout: (fn: TimerExecFunction, timeout?: number) => DisposerFunction;
+  interval: (fn: TimerExecFunction, interval?: number) => DisposerFunction;
+  intervalPause: (fn: TimerExecFunction, interval?: number) => DisposerFunction;
+  on: (emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]) => DisposerFunction;
+  once: (emitter: any, eventName: string, fn: (ev?: any) => void, ...args: any[]) => DisposerFunction;
+};
+type UseDisposeWithUtils = ReturnType<typeof useDisposeWithUtils>;
+//#endregion
+export { useEventListener as a, useIntervalPause as c, useDisposeWithUtils as i, useTimeout as l, UseDisposeWithUtils as n, useEventListenerOnce as o, noopDisposer as r, useInterval as s, TimerExecFunction as t };
+//# sourceMappingURL=dispose-utils-EQJPLtnc.d.cts.map

package/dist/distributed-6lvCr7zN.d.cts

@@ -0,0 +1,13 @@
+//#region src/common/data/distributed.d.ts
+/**
+ * Distribute file, named by natural numbers, in a way that each folder only
+ * contains `maxEntriesPerFolder` subfolders or files. Returns a list of
+ * names, where the last one is the file name, all others are folder names.
+ *
+ * Example: `distributedFilePath(1003)` results in `['2', '1', '3']` which
+ * could be translated to the file path `2/1/3.json`.
+ */
+declare function distributedFilePath(index: number, maxEntriesPerFolder?: number): string[];
+//#endregion
+export { distributedFilePath as t };
+//# sourceMappingURL=distributed-6lvCr7zN.d.cts.map