@zwave-js/waddle 1.0.0

package/build/esm/Task.d.ts

@@ -0,0 +1,138 @@
+/** A high-level task that can be started and stepped through */
+export interface Task<TReturn, TaskTag extends {
+    id: string;
+} = {
+    id: string;
+}, TError extends Error = Error> {
+    readonly id: number;
+    readonly timestamp: number;
+    readonly builder: TaskBuilder<TReturn, TaskTag>;
+    /** The parent task spawning this subtask, if any */
+    readonly parent?: Task<unknown, TaskTag, TError>;
+    /** A name to identify the task */
+    readonly name?: string;
+    /** A tag to identify the task programmatically */
+    readonly tag?: TaskTag;
+    /** The task's priority */
+    readonly priority: TaskPriority;
+    /** How the task should behave when interrupted */
+    readonly interrupt: TaskInterruptBehavior;
+    /** Starts the task it if hasn't been started yet, and executes the next step of the task */
+    step(): Promise<TaskStepResult<TReturn, TaskTag>>;
+    /** Stops the task without further executing it, cleans up, and prepares it for starting again */
+    reset(): Promise<void>;
+    /** Resolves the task's promise to notify the caller */
+    resolve(result: TReturn): void;
+    /** Rejects the task's promise to notify the caller */
+    reject(error: TError): void;
+    /** The current state of the task */
+    get state(): TaskState;
+    readonly generator: ReturnType<TaskBuilder<TReturn>["task"]> | undefined;
+    readonly promise: Promise<TReturn>;
+}
+/** Defines the necessary information for creating a task */
+export interface TaskBuilder<TReturn, TaskTag extends {
+    id: string;
+} = {
+    id: string;
+}, TInner = unknown> {
+    /** A name to identify the task */
+    name?: string;
+    /** A tag to identify the task programmatically */
+    tag?: TaskTag;
+    /** The task's priority */
+    priority: TaskPriority;
+    /** How the task should behave when interrupted */
+    interrupt?: TaskInterruptBehavior;
+    /**
+     * The task's main generator function. This is called repeatedly until it's done.
+     * The function must yield at points where it may be interrupted.
+     *
+     * At those points, the task can also wait for something to happen:
+     * - Either a Promise, in which case it must yield a function that returns that Promise
+     * - Or another task, in which case it must yield a TaskBuilder object or a function that returns one
+     *
+     * Yielded Promises should not spawn new tasks. If they do, the spawned tasks MUST have a higher priority than the parent task.
+     */
+    task: () => AsyncGenerator<(() => Promise<TInner> | TaskBuilder<TReturn, TaskTag, TInner>) | (() => TaskBuilder<TReturn, TaskTag, TInner>) | TaskBuilder<TReturn, TaskTag, TInner> | undefined, TReturn, TInner>;
+    /** A cleanup function that gets called when the task is dropped */
+    cleanup?: () => Promise<void>;
+}
+export type TaskReturnType<T extends TaskBuilder<unknown>> = T extends TaskBuilder<infer R> ? R : never;
+/**
+ * The priority of a task.
+ *
+ * Higher priority tasks are executed first and interrupt lower priority tasks.
+ * The recommended priority for application-initiated communication is `Normal`.
+ * `Low` and `Lower` are recommended for internal long-running tasks that should not interfere with user-initiated tasks.
+ * `Idle` is recommended for tasks that should only run when no other tasks are pending.
+ */
+export declare enum TaskPriority {
+    Highest = 0,
+    High = 1,
+    Normal = 2,
+    Low = 3,
+    Lower = 4,
+    Idle = 5
+}
+export declare enum TaskState {
+    /** The task has not been created yet */
+    None = 0,
+    /** The task is being executed */
+    Active = 1,
+    /** The task is waiting for a Promise to resolve */
+    AwaitingPromise = 2,
+    /** The task is waiting for another task to finish */
+    AwaitingTask = 3,
+    /** The task is finished */
+    Done = 4
+}
+export declare enum TaskInterruptBehavior {
+    /** The task may not be interrupted */
+    Forbidden = 0,
+    /** The task will be resumed after being interrupted (default) */
+    Resume = 1,
+    /** The task needs to be restarted after being interrupted */
+    Restart = 2
+}
+export type TaskStepResult<T, TaskTag extends {
+    id: string;
+} = {
+    id: string;
+}> = {
+    newState: TaskState.Done;
+    result: T;
+} | {
+    newState: TaskState.Active;
+} | {
+    newState: TaskState.AwaitingPromise;
+    promise: Promise<unknown>;
+} | {
+    newState: TaskState.AwaitingTask;
+    task: Task<unknown, TaskTag>;
+};
+export declare class TaskScheduler<TaskTag extends {
+    id: string;
+} = {
+    id: string;
+}, TError extends Error = Error> {
+    private defaultErrorFactory;
+    private verbose;
+    constructor(defaultErrorFactory?: () => TError, verbose?: boolean);
+    private _tasks;
+    private _currentTask;
+    private _idGenerator;
+    private _continueSignal;
+    private _stopSignal;
+    private _stopPromise;
+    queueTask<T>(builder: TaskBuilder<T, TaskTag>): Promise<T>;
+    /** Removes/stops tasks matching the given predicate. Returns `true` when a task was removed, `false` otherwise. */
+    removeTasks(predicate: (task: Task<unknown, TaskTag>) => boolean, reason?: TError): Promise<boolean>;
+    findTask<T = unknown>(predicate: (task: Task<T, TaskTag>) => boolean): Promise<T> | undefined;
+    /** Creates a task that can be executed */
+    private createTask;
+    start(): void;
+    private run;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=Task.d.ts.map

package/build/esm/Task.d.ts.map

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

package/build/esm/Task.js

@@ -0,0 +1,413 @@
+import { createDeferredPromise, } from "alcalzone-shared/deferred-promise";
+import { SortedList } from "alcalzone-shared/sorted-list";
+import { createWrappingCounter } from "./wrappingCounter.js";
+import { evalOrStatic, highResTimestamp, noop } from "./utils.js";
+function getTaskName(task) {
+    return `${task.name ?? (task.tag && JSON.stringify(task.tag)) ?? "unnamed"} (ID ${task.id})`;
+}
+function isTaskBuilder(obj) {
+    return (typeof obj === "object" &&
+        typeof obj.task === "function" &&
+        typeof obj.priority === "number");
+}
+/**
+ * The priority of a task.
+ *
+ * Higher priority tasks are executed first and interrupt lower priority tasks.
+ * The recommended priority for application-initiated communication is `Normal`.
+ * `Low` and `Lower` are recommended for internal long-running tasks that should not interfere with user-initiated tasks.
+ * `Idle` is recommended for tasks that should only run when no other tasks are pending.
+ */
+export var TaskPriority;
+(function (TaskPriority) {
+    TaskPriority[TaskPriority["Highest"] = 0] = "Highest";
+    TaskPriority[TaskPriority["High"] = 1] = "High";
+    TaskPriority[TaskPriority["Normal"] = 2] = "Normal";
+    TaskPriority[TaskPriority["Low"] = 3] = "Low";
+    TaskPriority[TaskPriority["Lower"] = 4] = "Lower";
+    TaskPriority[TaskPriority["Idle"] = 5] = "Idle";
+})(TaskPriority || (TaskPriority = {}));
+export var TaskState;
+(function (TaskState) {
+    /** The task has not been created yet */
+    TaskState[TaskState["None"] = 0] = "None";
+    /** The task is being executed */
+    TaskState[TaskState["Active"] = 1] = "Active";
+    /** The task is waiting for a Promise to resolve */
+    TaskState[TaskState["AwaitingPromise"] = 2] = "AwaitingPromise";
+    /** The task is waiting for another task to finish */
+    TaskState[TaskState["AwaitingTask"] = 3] = "AwaitingTask";
+    /** The task is finished */
+    TaskState[TaskState["Done"] = 4] = "Done";
+})(TaskState || (TaskState = {}));
+export var TaskInterruptBehavior;
+(function (TaskInterruptBehavior) {
+    /** The task may not be interrupted */
+    TaskInterruptBehavior[TaskInterruptBehavior["Forbidden"] = 0] = "Forbidden";
+    /** The task will be resumed after being interrupted (default) */
+    TaskInterruptBehavior[TaskInterruptBehavior["Resume"] = 1] = "Resume";
+    /** The task needs to be restarted after being interrupted */
+    TaskInterruptBehavior[TaskInterruptBehavior["Restart"] = 2] = "Restart";
+})(TaskInterruptBehavior || (TaskInterruptBehavior = {}));
+function compareTasks(a, b) {
+    // Sort by priority first. Higher priority goes to the end of the list
+    if (a.priority < b.priority)
+        return 1;
+    if (a.priority > b.priority)
+        return -1;
+    // Deprioritize waiting tasks
+    const aWaiting = a.state === TaskState.AwaitingPromise ||
+        a.state === TaskState.AwaitingTask;
+    const bWaiting = b.state === TaskState.AwaitingPromise ||
+        b.state === TaskState.AwaitingTask;
+    if (!aWaiting && bWaiting)
+        return 1;
+    if (aWaiting && !bWaiting)
+        return -1;
+    // Sort equal priority by timestamp. Newer tasks go to the end of the list
+    if (a.timestamp < b.timestamp)
+        return 1;
+    if (a.timestamp > b.timestamp)
+        return -1;
+    // If all else fails, sort by ID
+    return Math.sign(b.id - a.id);
+}
+export class TaskScheduler {
+    defaultErrorFactory;
+    verbose;
+    constructor(defaultErrorFactory = () => new Error("Task was removed"), verbose = false) {
+        this.defaultErrorFactory = defaultErrorFactory;
+        this.verbose = verbose;
+    }
+    _tasks = new SortedList(undefined, compareTasks);
+    _currentTask;
+    _idGenerator = createWrappingCounter(0xff_ff_ff);
+    _continueSignal;
+    _stopSignal;
+    _stopPromise;
+    queueTask(builder) {
+        const task = this.createTask(builder);
+        this._tasks.add(task);
+        if (this.verbose) {
+            console.log(`Task queued: ${getTaskName(task)}`);
+        }
+        if (this._continueSignal)
+            this._continueSignal.resolve();
+        return task.promise;
+    }
+    /** Removes/stops tasks matching the given predicate. Returns `true` when a task was removed, `false` otherwise. */
+    async removeTasks(predicate, reason) {
+        // Collect tasks that should be removed, but in reverse order,
+        // so that we handle the current task last.
+        const tasksToRemove = [];
+        let removeCurrentTask = false;
+        for (const task of this._tasks) {
+            if (predicate(task)) {
+                if (task === this._currentTask) {
+                    removeCurrentTask = true;
+                }
+                else {
+                    tasksToRemove.push(task);
+                }
+            }
+        }
+        reason ??= this.defaultErrorFactory();
+        for (const task of tasksToRemove) {
+            if (this.verbose) {
+                console.log(`Removing task: ${getTaskName(task)}`);
+            }
+            this._tasks.remove(task);
+            if (task.state === TaskState.Active ||
+                task.state === TaskState.AwaitingPromise ||
+                task.state === TaskState.AwaitingTask) {
+                // The task is running, clean it up
+                await task.reset().catch(noop);
+            }
+            task.reject(reason);
+            // Re-add the parent task to the list if there is one
+            if (task.parent) {
+                if (this.verbose) {
+                    console.log(`Restoring parent task: ${getTaskName(task.parent)}`);
+                }
+                this._tasks.add(task.parent);
+            }
+        }
+        if (removeCurrentTask && this._currentTask) {
+            if (this.verbose) {
+                console.log(`Removing task: ${getTaskName(this._currentTask)}`);
+            }
+            this._tasks.remove(this._currentTask);
+            await this._currentTask.reset().catch(noop);
+            this._currentTask.reject(reason);
+            // Re-add the parent task to the list if there is one
+            if (this._currentTask.parent) {
+                if (this.verbose) {
+                    console.log(`Restoring parent task: ${getTaskName(this._currentTask.parent)}`);
+                }
+                this._tasks.add(this._currentTask.parent);
+            }
+            this._currentTask = undefined;
+        }
+        if (this._continueSignal)
+            this._continueSignal.resolve();
+        return tasksToRemove.length > 0 || removeCurrentTask;
+    }
+    findTask(predicate) {
+        return this._tasks.find((t) => predicate(t))?.promise;
+    }
+    /** Creates a task that can be executed */
+    createTask(builder, parent) {
+        let state = TaskState.None;
+        let generator;
+        let waitForPromise;
+        const promise = createDeferredPromise();
+        let prevResult;
+        let waitError;
+        const self = this;
+        return {
+            id: this._idGenerator(),
+            timestamp: highResTimestamp(),
+            builder,
+            parent,
+            name: builder.name,
+            tag: builder.tag,
+            priority: builder.priority,
+            interrupt: builder.interrupt ?? TaskInterruptBehavior.Resume,
+            promise,
+            async step() {
+                // Do not proceed while still waiting for a Promise to resolve
+                if (state === TaskState.AwaitingPromise && waitForPromise) {
+                    return {
+                        newState: state,
+                        promise: waitForPromise,
+                    };
+                }
+                else if (state === TaskState.AwaitingTask) {
+                    throw new Error("Cannot step through a task that is waiting for another task");
+                }
+                generator ??= builder.task();
+                state = TaskState.Active;
+                const { value, done } = waitError
+                    ? await generator.throw(waitError)
+                    : await generator.next(prevResult);
+                prevResult = undefined;
+                waitError = undefined;
+                if (done) {
+                    state = TaskState.Done;
+                    return {
+                        newState: state,
+                        result: value,
+                    };
+                }
+                else if (value != undefined) {
+                    const waitFor = evalOrStatic(value);
+                    if (waitFor instanceof Promise) {
+                        state = TaskState.AwaitingPromise;
+                        waitForPromise = waitFor
+                            .then((result) => {
+                            prevResult = result;
+                        })
+                            .catch((e) => {
+                            waitError = e;
+                        })
+                            .finally(() => {
+                            waitForPromise = undefined;
+                            if (state === TaskState.AwaitingPromise) {
+                                state = TaskState.Active;
+                            }
+                        });
+                        return {
+                            newState: state,
+                            promise: waitForPromise,
+                        };
+                    }
+                    else if (isTaskBuilder(waitFor)) {
+                        if (waitFor.priority > builder.priority) {
+                            throw new Error("Tasks cannot yield to tasks with lower priority than their own");
+                        }
+                        // Create a sub-task with a reference to this task
+                        state = TaskState.AwaitingTask;
+                        const subTask = self.createTask(waitFor, this);
+                        subTask.promise
+                            .then((result) => {
+                            prevResult = result;
+                        })
+                            .catch((e) => {
+                            waitError = e;
+                        })
+                            .finally(() => {
+                            if (state === TaskState.AwaitingTask) {
+                                state = TaskState.Active;
+                            }
+                        });
+                        return {
+                            newState: state,
+                            task: subTask,
+                        };
+                    }
+                    else {
+                        throw new Error("Invalid value yielded by task");
+                    }
+                }
+                else {
+                    return { newState: state };
+                }
+            },
+            async reset() {
+                if (state === TaskState.None)
+                    return;
+                state = TaskState.None;
+                waitForPromise = undefined;
+                generator = undefined;
+                await builder.cleanup?.();
+            },
+            resolve(result) {
+                promise.resolve(result);
+            },
+            reject(error) {
+                promise.reject(error);
+            },
+            get state() {
+                return state;
+            },
+            get generator() {
+                return generator;
+            },
+        };
+    }
+    start() {
+        this._stopSignal = createDeferredPromise();
+        setImmediate(async () => {
+            try {
+                await this.run();
+            }
+            catch (e) {
+                console.error("Task runner crashed", e);
+            }
+        });
+    }
+    async run() {
+        while (true) {
+            let waitFor;
+            if (this._tasks.length > 0) {
+                const firstTask = this._tasks.peekStart();
+                if (!this._currentTask) {
+                    // We're not currently executing a task, start executing the first one
+                    this._currentTask = firstTask;
+                }
+                else if (this._currentTask !== firstTask &&
+                    this._currentTask.interrupt !==
+                        TaskInterruptBehavior.Forbidden) {
+                    // We are executing an interruptible task, and a new task with a higher priority was added
+                    if (this._currentTask.interrupt ===
+                        TaskInterruptBehavior.Restart) {
+                        // The current task needs to be restarted after being interrupted, so reset it
+                        await this._currentTask.reset();
+                    }
+                    // switch to the new task
+                    this._currentTask = firstTask;
+                }
+                if (this.verbose) {
+                    console.log(`Stepping through task: ${getTaskName(this._currentTask)}`);
+                }
+                const cleanupCurrentTask = async () => {
+                    if (this._currentTask) {
+                        this._tasks.remove(this._currentTask);
+                        await this._currentTask.reset();
+                        // Re-add the parent task to the list if there is one
+                        if (this._currentTask.parent) {
+                            if (this.verbose) {
+                                console.log(`Restoring parent task: ${getTaskName(this._currentTask.parent)}`);
+                            }
+                            this._tasks.add(this._currentTask.parent);
+                        }
+                        this._currentTask = undefined;
+                    }
+                };
+                // Execute the current task one step further
+                waitFor = undefined;
+                let stepResult;
+                try {
+                    stepResult = await this._currentTask.step();
+                }
+                catch (e) {
+                    if (this.verbose) {
+                        console.error(`- Task threw an error:`, e);
+                    }
+                    // The task threw an error, expose the result and clean up.
+                    this._currentTask.reject(e);
+                    await cleanupCurrentTask();
+                    // Then continue with the next iteration
+                    continue;
+                }
+                if (stepResult.newState === TaskState.Done) {
+                    if (this.verbose) {
+                        console.log(`- Task finished`);
+                    }
+                    // The task is done, clean up
+                    this._currentTask.resolve(stepResult.result);
+                    await cleanupCurrentTask();
+                    // Then continue with the next iteration
+                    continue;
+                }
+                else if (stepResult.newState === TaskState.AwaitingPromise) {
+                    // The task is waiting for something
+                    if (this.verbose) {
+                        console.log(`- Task waiting`);
+                    }
+                    // If the task may be interrupted, check if there are other same-priority tasks that should be executed instead
+                    if (this._currentTask.interrupt !==
+                        TaskInterruptBehavior.Forbidden) {
+                        // Re-queue the task, so the queue gets reordered
+                        this._tasks.remove(this._currentTask);
+                        this._tasks.add(this._currentTask);
+                        if (this._tasks.peekStart() !== this._currentTask) {
+                            if (this.verbose) {
+                                console.log(`-- Continuing with another task`);
+                            }
+                            // The task is no longer the first in the queue. Switch to the other one
+                            continue;
+                        }
+                    }
+                    // Otherwise, we got nothing to do right now than to wait
+                    waitFor = stepResult.promise;
+                }
+                else if (stepResult.newState === TaskState.AwaitingTask) {
+                    // The task spawned a sub-task. Replace it with the sub-task and continue executing
+                    if (this.verbose) {
+                        console.log(`- Task spawned a sub-task`);
+                    }
+                    this._tasks.add(stepResult.task);
+                    this._tasks.remove(this._currentTask);
+                    // Continue with the next iteration
+                    continue;
+                }
+                else {
+                    // The current task is not done, continue with the next iteration
+                    continue;
+                }
+            }
+            // Task queue empty. Wait for either a new task or the stop signal,
+            // or the current task to finish waiting
+            this._continueSignal = createDeferredPromise();
+            const nextAction = await Promise.race([
+                this._continueSignal.then(() => "continue"),
+                this._stopSignal.then(() => "stop"),
+                waitFor?.then(() => "continue"),
+            ].filter((p) => p !== undefined));
+            this._continueSignal = undefined;
+            if (nextAction === "stop")
+                break;
+        }
+        this._stopPromise.resolve();
+    }
+    async stop() {
+        if (!this._stopSignal)
+            return;
+        // Signal to the task runner that it should stop
+        this._stopPromise = createDeferredPromise();
+        this._stopSignal.resolve();
+        await this._stopPromise;
+    }
+}
+//# sourceMappingURL=Task.js.map

package/build/esm/Task.js.map

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

package/build/esm/index.d.ts

@@ -0,0 +1,2 @@
+export { Task, TaskBuilder, TaskInterruptBehavior, TaskPriority, TaskReturnType, TaskScheduler, TaskState, TaskStepResult, } from "./Task.js";
+//# sourceMappingURL=index.d.ts.map

package/build/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,EACT,cAAc,GACd,MAAM,WAAW,CAAC"}

package/build/esm/index.js

@@ -0,0 +1,2 @@
+export { TaskInterruptBehavior, TaskPriority, TaskScheduler, TaskState, } from "./Task.js";
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,qBAAqB,EACrB,YAAY,EAEZ,aAAa,EACb,SAAS,GAET,MAAM,WAAW,CAAC"}

package/build/esm/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "module"
+}

package/build/esm/utils.d.ts

@@ -0,0 +1,8 @@
+/** Returns a timestamp with nano-second precision */
+export declare function highResTimestamp(): number;
+/** Does nothing. Can be used for empty `.catch(...)` calls. */
+export declare function noop(): void;
+export type FnOrStatic<TArgs extends any[], TReturn> = ((...args: TArgs) => TReturn) | TReturn;
+export type ReturnTypeOrStatic<T> = T extends (...args: any[]) => infer R ? R : T;
+export declare function evalOrStatic<T>(fnOrConst: T, ...args: any[]): ReturnTypeOrStatic<T>;
+//# sourceMappingURL=utils.d.ts.map

package/build/esm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,+DAA+D;AAC/D,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,IAChD,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,GAC7B,OAAO,CAAC;AAEX,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAC1E,CAAC,CAAC;AAEL,wBAAgB,YAAY,CAAC,CAAC,EAC7B,SAAS,EAAE,CAAC,EACZ,GAAG,IAAI,EAAE,GAAG,EAAE,GACZ,kBAAkB,CAAC,CAAC,CAAC,CAGvB"}

package/build/esm/utils.js

@@ -0,0 +1,22 @@
+/** Returns a timestamp with nano-second precision */
+export function highResTimestamp() {
+    if (typeof process !== "undefined") {
+        const [s, ns] = process.hrtime();
+        return s * 1e9 + ns;
+    }
+    else if (performance != undefined) {
+        return performance.now() * 1e6;
+    }
+    else {
+        throw new Error("No high-resolution timer available");
+    }
+}
+/** Does nothing. Can be used for empty `.catch(...)` calls. */
+export function noop() {
+    // intentionally empty
+}
+export function evalOrStatic(fnOrConst, ...args) {
+    // @ts-expect-error https://github.com/microsoft/TypeScript/issues/61337
+    return typeof fnOrConst === "function" ? fnOrConst(...args) : fnOrConst;
+}
+//# sourceMappingURL=utils.js.map

package/build/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,UAAU,gBAAgB;IAC/B,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;IACrB,CAAC;SAAM,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;QACrC,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC;IAChC,CAAC;SAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACvD,CAAC;AACF,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,IAAI;IACnB,sBAAsB;AACvB,CAAC;AASD,MAAM,UAAU,YAAY,CAC3B,SAAY,EACZ,GAAG,IAAW;IAEd,wEAAwE;IACxE,OAAO,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzE,CAAC"}

package/build/esm/wrappingCounter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates a counter that starts at 1 and wraps after surpassing `maxValue`.
+ * @param maxValue The maximum value that the counter can reach. Must a number where all bits are set to 1.
+ * @param randomSeed Whether the initial value should be randomized. Default: `false`.
+ */
+export declare function createWrappingCounter(maxValue: number, randomSeed?: boolean): () => number;
+//# sourceMappingURL=wrappingCounter.d.ts.map

package/build/esm/wrappingCounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrappingCounter.d.ts","sourceRoot":"","sources":["../../src/wrappingCounter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,OAAe,GACzB,MAAM,MAAM,CAOd"}