@digital-alchemy/core 26.1.9 → 26.5.1

package/dist/helpers/utilities.d.mts

@@ -1,60 +1,145 @@
 import type { Dayjs } from "dayjs";
 import type { Duration } from "dayjs/plugin/duration.js";
 import type { TOffset } from "./cron.mts";
+/** Even divisor — used when checking parity (`value % EVEN === 0`). */
 export declare const EVEN = 2;
+/** Alias for EVEN; used when the "twoness" is conceptually a pair, not parity. */
 export declare const PAIR = 2;
+/** Multiplier for half of a value (`total * HALF`). */
 export declare const HALF = 0.5;
+/** One-third fraction constant (`total * ONE_THIRD`). */
 export declare const ONE_THIRD: number;
+/** Two-thirds fraction constant (`total * TWO_THIRDS`). */
 export declare const TWO_THIRDS: number;
 /**
+ * Sensible default cap for concurrency and pagination limits.
+ *
  * Good for a surprising number of situations
  */
 export declare const DEFAULT_LIMIT = 5;
+/** Multiply by this to negate a number (`value * INVERT_VALUE`). */
 export declare const INVERT_VALUE = -1;
+/** Sort comparator return for ascending order (`a > b ? UP : ...`). */
 export declare const UP = 1;
+/** Index of the value element in a `[label, value]` tuple. */
 export declare const VALUE = 1;
+/**
+ * Offset applied when converting a 1-based length to a 0-based last index
+ * (`array.length - ARRAY_OFFSET`).
+ */
 export declare const ARRAY_OFFSET = 1;
+/** Step size when walking an array index one position at a time. */
 export declare const INCREMENT = 1;
+/** Canonical "one of something" constant; avoids the bare literal `1`. */
 export declare const SINGLE = 1;
+/** Sort comparator return for equal elements (`a === b ? SAME : ...`). */
 export declare const SAME = 0;
+/** Index of the label element in a `[label, value]` tuple. */
 export declare const LABEL = 0;
+/** Zero-based start index; use instead of bare `0` for array access. */
 export declare const START = 0;
+/** Canonical zero-count sentinel (`if (count === NONE)`). */
 export declare const NONE = 0;
+/** First index in any zero-based collection. */
 export declare const FIRST = 0;
+/** Type alias for the literal `0`; useful in discriminated union positions. */
 export type FIRST = 0;
+/** Zero-length sentinel; use `length === EMPTY` instead of `length === 0`. */
 export declare const EMPTY = 0;
+/** No-op delta — returned from comparators when a value has not changed. */
 export declare const NO_CHANGE = 0;
+/** Sentinel returned by `Array.prototype.indexOf` when the element is absent. */
 export declare const NOT_FOUND = -1;
+/** Sort comparator return for descending order (`a < b ? DOWN : ...`). */
 export declare const DOWN = -1;
+/** One minute expressed in milliseconds (`60_000`). */
 export declare const MINUTE = 60000;
+/** One hour expressed in milliseconds (`3_600_000`). */
 export declare const HOUR = 3600000;
+/** One day expressed in milliseconds (`86_400_000`). */
 export declare const DAY = 86400000;
+/** One week expressed in milliseconds (`7 * DAY`). */
 export declare const WEEK: number;
+/** One second expressed in milliseconds (`1_000`). */
 export declare const SECOND = 1000;
+/** Denominator for percent calculations (`value / PERCENT * 100`). */
 export declare const PERCENT = 100;
+/** One calendar year expressed in milliseconds (`365 * DAY`). */
 export declare const YEAR: number;
+/**
+ * Live set of every `SleepReturn` that has not yet resolved or been killed.
+ *
+ * @remarks
+ * The scheduler and teardown logic iterate this set to cancel in-flight sleeps
+ * on shutdown. Entries are added when `sleep()` is called and removed when the
+ * timer fires or `.kill()` is called.
+ *
+ * @internal
+ */
 export declare const ACTIVE_SLEEPS: Set<SleepReturn>;
 /**
+ * Normalise a {@link TOffset} into a dayjs `Duration` object.
+ *
+ * @remarks
+ * Supports the full `TOffset` union:
+ * - **function** — called first to unwrap the real offset
+ * - **`[amount, unit]` tuple** — passed directly to `dayjs.duration`
+ * - **`DurationUnitsObjectType` object** — passed to `dayjs.duration`; an existing
+ *   `Duration` instance is returned as-is
+ * - **string** — interpreted as a partial ISO 8601 duration after prepending `"PT"`
+ *   (e.g. `"30s"` → `"PT30S"`)
+ * - **number** — treated as raw milliseconds
+ *
+ * Returns `undefined` when the offset does not match any supported form.
+ *
  * Converts a TOffset to a Duration object (or undefined if invalid)
  * Handles function unwrapping, arrays, objects, strings, and numbers
  */
 export declare function toOffsetDuration(offset: TOffset): Duration | undefined;
 /**
+ * Normalise a {@link TOffset} into a plain millisecond count.
+ *
+ * @remarks
+ * Unwraps function offsets then takes a fast path for raw numbers to avoid
+ * allocating a `Duration` object. All other forms are delegated to
+ * {@link toOffsetDuration} and converted via `asMilliseconds()`.
+ *
+ * Returns `NONE` (0) when the offset cannot be resolved.
+ *
  * Converts a TOffset to milliseconds
  */
 export declare function toOffsetMs(offset: TOffset): number;
+/**
+ * A `Promise<void>` extended with a `.kill()` method for early cancellation.
+ *
+ * @remarks
+ * Returned by {@link sleep}. Awaiting resolves when the timer fires naturally.
+ * Calling `.kill("continue")` resolves the promise immediately and cancels the
+ * timer. Calling `.kill("stop")` (the default) cancels the timer and lets the
+ * promise remain forever-pending — useful when you want the awaiting code to
+ * simply stop without advancing.
+ */
 export type SleepReturn = Promise<void> & {
     kill: (execute?: "stop" | "continue") => void;
 };
 /**
- * #MARK: Simple usage
+ * Async delay that supports early cancellation via `.kill()`.
  *
+ * @remarks
+ * Accepts any {@link TOffset}, a JS `Date`, or a `Dayjs` instance. Absolute
+ * time values (`Date` / `Dayjs`) are converted to a relative delay from now at
+ * the moment `sleep()` is called.
+ *
+ * The returned {@link SleepReturn} is tracked in {@link ACTIVE_SLEEPS} for
+ * lifecycle-aware shutdown; it is removed automatically when the timer fires or
+ * `.kill()` is called.
+ *
+ * @example Simple usage
  * ```typescript
  * await sleep(5000);
  * ```
  *
- * #MARK: Early stop
- *
+ * @example Early stop
  * ```typescript
  * const start = Date.now();
  * const timer = sleep(5000);
@@ -65,13 +150,48 @@ export type SleepReturn = Promise<void> & {
  * ```
  */
 export declare function sleep(target: TOffset | Date | Dayjs): SleepReturn;
+/**
+ * Set of identifiers currently in the throttle window.
+ *
+ * @internal
+ */
 export declare const ACTIVE_THROTTLE: Set<string>;
+/**
+ * Map of identifier → pending sleep for the active debounce window.
+ *
+ * @remarks
+ * Each key is a caller-supplied `identifier` string. When a new call arrives
+ * for an existing identifier, the current sleep is killed and replaced, pushing
+ * the expiry forward. Entries are removed once the delay resolves.
+ *
+ * @internal
+ */
 export declare const ACTIVE_DEBOUNCE: Map<string, SleepReturn>;
 /**
+ * Debounce an async operation by identifier.
+ *
+ * @remarks
+ * Each call resets the timer for `identifier`, so the operation does not
+ * proceed until no further calls for that identifier arrive within `timeout`.
+ * Multiple concurrent callers sharing the same `identifier` all wait on the
+ * same sliding window — the last writer wins.
+ *
  * wait for duration after call before allowing next, extends for calls inside window
  */
 export declare function debounce(identifier: string, timeout: TOffset): Promise<void>;
+/** Async no-op that resolves after one event-loop tick via `sleep(0)`. */
 export declare const asyncNoop: () => Promise<void>;
+/** Synchronous no-op — a named empty function for use as a default callback. */
 export declare const noop: () => void;
+/**
+ * Represents a return type that callers are not expected to use.
+ *
+ * @remarks
+ * Used as the return type annotation for fire-and-forget callbacks and service
+ * methods where the resolved value is intentionally discarded. Covers `void`,
+ * `Promise<void>`, and any other return to prevent TypeScript from complaining
+ * about unused return values.
+ */
 export type TBlackHole = unknown | void | Promise<void>;
+/** Loose function signature that accepts any arguments and returns a {@link TBlackHole}. */
 export type TAnyFunction = (...data: unknown[]) => TBlackHole;

package/dist/helpers/utilities.mjs

@@ -3,49 +3,110 @@ import duration from "dayjs/plugin/duration.js";
 import { is } from "../index.mjs";
 dayjs.extend(duration);
 /* eslint-disable @typescript-eslint/no-magic-numbers */
+// --- Numeric constants ---------------------------------------------------------
+// These are the canonical zero/one anchors used throughout the codebase.
+// Named constants eliminate magic numbers and make intent explicit at each
+// call site, which is why they live here rather than being inlined.
+/** Even divisor — used when checking parity (`value % EVEN === 0`). */
 export const EVEN = 2;
+/** Alias for EVEN; used when the "twoness" is conceptually a pair, not parity. */
 export const PAIR = 2;
+/** Multiplier for half of a value (`total * HALF`). */
 export const HALF = 0.5;
+/** One-third fraction constant (`total * ONE_THIRD`). */
 export const ONE_THIRD = 1 / 3;
+/** Two-thirds fraction constant (`total * TWO_THIRDS`). */
 export const TWO_THIRDS = 2 / 3;
 /**
+ * Sensible default cap for concurrency and pagination limits.
+ *
  * Good for a surprising number of situations
  */
 export const DEFAULT_LIMIT = 5;
+/** Multiply by this to negate a number (`value * INVERT_VALUE`). */
 export const INVERT_VALUE = -1;
+/** Sort comparator return for ascending order (`a > b ? UP : ...`). */
 // Sort
 export const UP = 1;
+/** Index of the value element in a `[label, value]` tuple. */
 // [LABEL,VALUE]
 export const VALUE = 1;
+/**
+ * Offset applied when converting a 1-based length to a 0-based last index
+ * (`array.length - ARRAY_OFFSET`).
+ */
 // Standard value
 export const ARRAY_OFFSET = 1;
+/** Step size when walking an array index one position at a time. */
 // array[number +- increment]
 export const INCREMENT = 1;
+/** Canonical "one of something" constant; avoids the bare literal `1`. */
 // Generic one-ness
 export const SINGLE = 1;
+/** Sort comparator return for equal elements (`a === b ? SAME : ...`). */
 // Sorting
 export const SAME = 0;
+/** Index of the label element in a `[label, value]` tuple. */
 // [LABEL,VALUE]
 export const LABEL = 0;
+/** Zero-based start index; use instead of bare `0` for array access. */
 // Generic start of something
 export const START = 0;
+/** Canonical zero-count sentinel (`if (count === NONE)`). */
 export const NONE = 0;
+/** First index in any zero-based collection. */
 export const FIRST = 0;
+/** Zero-length sentinel; use `length === EMPTY` instead of `length === 0`. */
 export const EMPTY = 0;
+/** No-op delta — returned from comparators when a value has not changed. */
 export const NO_CHANGE = 0;
+/** Sentinel returned by `Array.prototype.indexOf` when the element is absent. */
 // Testing of indexes
 export const NOT_FOUND = -1;
+/** Sort comparator return for descending order (`a < b ? DOWN : ...`). */
 // Sorting
 export const DOWN = -1;
+/** One minute expressed in milliseconds (`60_000`). */
 export const MINUTE = 60_000;
+/** One hour expressed in milliseconds (`3_600_000`). */
 export const HOUR = 3_600_000;
+/** One day expressed in milliseconds (`86_400_000`). */
 export const DAY = 86_400_000;
+/** One week expressed in milliseconds (`7 * DAY`). */
 export const WEEK = 7 * DAY;
+/** One second expressed in milliseconds (`1_000`). */
 export const SECOND = 1000;
+/** Denominator for percent calculations (`value / PERCENT * 100`). */
 export const PERCENT = 100;
+/** One calendar year expressed in milliseconds (`365 * DAY`). */
 export const YEAR = 365 * DAY;
+// --- Sleep infrastructure -----------------------------------------------------
+/**
+ * Live set of every `SleepReturn` that has not yet resolved or been killed.
+ *
+ * @remarks
+ * The scheduler and teardown logic iterate this set to cancel in-flight sleeps
+ * on shutdown. Entries are added when `sleep()` is called and removed when the
+ * timer fires or `.kill()` is called.
+ *
+ * @internal
+ */
 export const ACTIVE_SLEEPS = new Set();
 /**
+ * Normalise a {@link TOffset} into a dayjs `Duration` object.
+ *
+ * @remarks
+ * Supports the full `TOffset` union:
+ * - **function** — called first to unwrap the real offset
+ * - **`[amount, unit]` tuple** — passed directly to `dayjs.duration`
+ * - **`DurationUnitsObjectType` object** — passed to `dayjs.duration`; an existing
+ *   `Duration` instance is returned as-is
+ * - **string** — interpreted as a partial ISO 8601 duration after prepending `"PT"`
+ *   (e.g. `"30s"` → `"PT30S"`)
+ * - **number** — treated as raw milliseconds
+ *
+ * Returns `undefined` when the offset does not match any supported form.
+ *
  * Converts a TOffset to a Duration object (or undefined if invalid)
  * Handles function unwrapping, arrays, objects, strings, and numbers
  */
@@ -76,6 +137,15 @@ export function toOffsetDuration(offset) {
     return undefined;
 }
 /**
+ * Normalise a {@link TOffset} into a plain millisecond count.
+ *
+ * @remarks
+ * Unwraps function offsets then takes a fast path for raw numbers to avoid
+ * allocating a `Duration` object. All other forms are delegated to
+ * {@link toOffsetDuration} and converted via `asMilliseconds()`.
+ *
+ * Returns `NONE` (0) when the offset cannot be resolved.
+ *
  * Converts a TOffset to milliseconds
  */
 export function toOffsetMs(offset) {
@@ -92,14 +162,23 @@ export function toOffsetMs(offset) {
     return duration?.asMilliseconds() ?? NONE;
 }
 /**
- * #MARK: Simple usage
+ * Async delay that supports early cancellation via `.kill()`.
  *
+ * @remarks
+ * Accepts any {@link TOffset}, a JS `Date`, or a `Dayjs` instance. Absolute
+ * time values (`Date` / `Dayjs`) are converted to a relative delay from now at
+ * the moment `sleep()` is called.
+ *
+ * The returned {@link SleepReturn} is tracked in {@link ACTIVE_SLEEPS} for
+ * lifecycle-aware shutdown; it is removed automatically when the timer fires or
+ * `.kill()` is called.
+ *
+ * @example Simple usage
  * ```typescript
  * await sleep(5000);
  * ```
  *
- * #MARK: Early stop
- *
+ * @example Early stop
  * ```typescript
  * const start = Date.now();
  * const timer = sleep(5000);
@@ -136,6 +215,7 @@ export function sleep(target) {
     ACTIVE_SLEEPS.add(out);
     out.kill = (execute = "stop") => {
         ACTIVE_SLEEPS.delete(out);
+        // only resolve the promise when the caller wants execution to continue after the kill
         if (execute === "continue" && done) {
             done();
         }
@@ -144,13 +224,38 @@ export function sleep(target) {
     };
     return out;
 }
+// --- Debounce infrastructure --------------------------------------------------
+/**
+ * Set of identifiers currently in the throttle window.
+ *
+ * @internal
+ */
 export const ACTIVE_THROTTLE = new Set();
+/**
+ * Map of identifier → pending sleep for the active debounce window.
+ *
+ * @remarks
+ * Each key is a caller-supplied `identifier` string. When a new call arrives
+ * for an existing identifier, the current sleep is killed and replaced, pushing
+ * the expiry forward. Entries are removed once the delay resolves.
+ *
+ * @internal
+ */
 export const ACTIVE_DEBOUNCE = new Map();
 /**
+ * Debounce an async operation by identifier.
+ *
+ * @remarks
+ * Each call resets the timer for `identifier`, so the operation does not
+ * proceed until no further calls for that identifier arrive within `timeout`.
+ * Multiple concurrent callers sharing the same `identifier` all wait on the
+ * same sliding window — the last writer wins.
+ *
  * wait for duration after call before allowing next, extends for calls inside window
  */
 export async function debounce(identifier, timeout) {
     const current = ACTIVE_DEBOUNCE.get(identifier);
+    // kill the outstanding timer so the window slides forward from this call
     if (!is.undefined(current)) {
         current.kill("stop");
     }
@@ -159,6 +264,8 @@ export async function debounce(identifier, timeout) {
     await delay;
     ACTIVE_DEBOUNCE.delete(identifier);
 }
+/** Async no-op that resolves after one event-loop tick via `sleep(0)`. */
 export const asyncNoop = async () => await sleep(NONE);
+/** Synchronous no-op — a named empty function for use as a default callback. */
 export const noop = () => { };
 //# sourceMappingURL=utilities.mjs.map

package/dist/helpers/utilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.mjs","sourceRoot":"","sources":["../../src/helpers/utilities.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utilities.mjs","sourceRoot":"","sources":["../../src/helpers/utilities.mts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,QAAQ,MAAM,0BAA0B,CAAC;AAEhD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAGlC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEvB,wDAAwD;AAExD,kFAAkF;AAClF,yEAAyE;AACzE,2EAA2E;AAC3E,oEAAoE;AAEpE,uEAAuE;AACvE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;AAEtB,kFAAkF;AAClF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;AAEtB,uDAAuD;AACvD,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC;AAExB,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;AAE/B,2DAA2D;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,oEAAoE;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC;AAE/B,uEAAuE;AACvE,OAAO;AACP,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEpB,8DAA8D;AAC9D,gBAAgB;AAChB,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AAEvB;;;GAGG;AACH,iBAAiB;AACjB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,oEAAoE;AACpE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAE3B,0EAA0E;AAC1E,mBAAmB;AACnB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC;AAExB,0EAA0E;AAC1E,UAAU;AACV,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;AAEtB,8DAA8D;AAC9D,gBAAgB;AAChB,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AAEvB,wEAAwE;AACxE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AAEvB,6DAA6D;AAC7D,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;AAEtB,gDAAgD;AAChD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AAKvB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AAEvB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAE3B,iFAAiF;AACjF,qBAAqB;AACrB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC;AAE5B,0EAA0E;AAC1E,UAAU;AACV,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC;AAEvB,uDAAuD;AACvD,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC;AAE7B,wDAAwD;AACxD,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAC;AAE9B,wDAAwD;AACxD,MAAM,CAAC,MAAM,GAAG,GAAG,UAAU,CAAC;AAE9B,sDAAsD;AACtD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC;AAE5B,sDAAsD;AACtD,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;AAE3B,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC;AAE3B,iEAAiE;AACjE,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAE9B,iFAAiF;AAEjF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAe,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,sBAAsB;IACtB,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,MAAM,EAAE,CAAC;IACpB,CAAC;IACD,oBAAoB;IACpB,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,uCAAuC;IACvC,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;YAC7B,CAAC,CAAE,MAAmB;YACtB,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAiC,CAAC,CAAC;IACxD,CAAC;IACD,gCAAgC;IAChC,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,cAAc;IACd,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe;IACxC,sBAAsB;IACtB,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,MAAM,EAAE,CAAC;IACpB,CAAC;IACD,gFAAgF;IAChF,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,sDAAsD;IACtD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,QAAQ,EAAE,cAAc,EAAE,IAAI,IAAI,CAAC;AAC5C,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,KAAK,CAAC,MAA8B;IAClD,6BAA6B;IAC7B,IAAI,IAA8B,CAAC;IAEnC,MAAM,YAAY,GAAG,GAAW,EAAE;QAChC,8BAA8B;QAC9B,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,CAAC;QACD,+BAA+B;QAC/B,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,CAAC;QACD,mCAAmC;QACnC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;QAC9B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;QACD,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAEnB,6CAA6C;IAC7C,gDAAgD;IAChD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAgB,CAAC;IAC9D,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,GAAG,MAAM,EAAE,EAAE;QAC9B,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,sFAAsF;QACtF,IAAI,OAAO,KAAK,UAAU,IAAI,IAAI,EAAE,CAAC;YACnC,IAAI,EAAE,CAAC;QACT,CAAC;QACD,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB,EAAE,OAAgB;IACjE,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,yEAAyE;IACzE,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC;IACZ,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;AAEvD,gFAAgF;AAChF,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC"}