@keeex/utils 7.2.0 → 7.3.0

package/lib/bits/triggers/base.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import * as types from "./types.js";
+/**
+ * Base implementation for all triggers.
+ */
+export declare abstract class BaseTrigger implements types.Trigger {
+    #private;
+    constructor(handler: types.TriggerHandler, delayMs: number, logger?: Logger | string);
+    protected get state(): types.TriggerState;
+    protected set state(value: types.TriggerState);
+    protected get logger(): Logger;
+    abstract trigger(): void;
+    cancel: () => void;
+    stop: () => void;
+}

package/lib/bits/triggers/base.js

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { createLogger } from "@keeex/log";
+import { dropPromise } from "../../promise.js";
+import * as types from "./types.js";
+/**
+ * Base implementation for all triggers.
+ */
+export class BaseTrigger {
+    #state = types.TriggerState.inactive;
+    #timeout = null;
+    #delay;
+    #handler;
+    #logger;
+    constructor(handler, delayMs, logger) {
+        this.#handler = handler;
+        this.#delay = delayMs;
+        if (typeof logger === "string") {
+            this.#logger = createLogger({ tag: logger, numbered: true });
+        }
+        else if (logger) {
+            this.#logger = logger;
+        }
+        else {
+            this.#logger = createLogger({ tag: "PromiseTrigger", numbered: true });
+        }
+        this.#logger.debug(`Initialized with timer of ${delayMs}`);
+    }
+    get state() {
+        return this.#state;
+    }
+    set state(value) {
+        const oldState = this.#state;
+        this.#logger.debug(`State transition: ${oldState} → ${value}`);
+        this.#state = value;
+        switch (oldState) {
+            case types.TriggerState.inactive:
+                this.#stateFromInactive(value);
+                break;
+            case types.TriggerState.pending:
+                this.#stateFromPending(value);
+                break;
+            case types.TriggerState.running:
+                this.#stateFromRunning(value);
+                break;
+            case types.TriggerState.runningRetrigger:
+                this.#stateFromRunningRetrigger(value);
+                break;
+            case types.TriggerState.runningStop:
+                this.#stateFromRunningStop(value);
+                break;
+            case types.TriggerState.stop:
+                this.#stateFromStop(value);
+                break;
+        }
+    }
+    get logger() {
+        return this.#logger;
+    }
+    cancel = () => {
+        this.state = types.TriggerState.inactive;
+    };
+    stop = () => {
+        this.state = types.TriggerState.stop;
+    };
+    #stateFromInactive = (value) => {
+        switch (value) {
+            case types.TriggerState.pending:
+                this.#armTimeout();
+                break;
+            case types.TriggerState.running:
+            case types.TriggerState.runningRetrigger:
+                throw new Error("Cannot transition from inactive to running");
+        }
+    };
+    #stateFromPending = (value) => {
+        switch (value) {
+            case types.TriggerState.inactive:
+                this.#disarmTimeout();
+                break;
+            case types.TriggerState.running:
+                this.#timeout = null;
+                break;
+            case types.TriggerState.stop:
+                this.#disarmTimeout();
+                this.#runHandler();
+        }
+    };
+    #stateFromRunning = (value) => {
+        switch (value) {
+            case types.TriggerState.pending:
+                this.state = types.TriggerState.runningRetrigger;
+        }
+    };
+    #stateFromRunningRetrigger = (value) => {
+        switch (value) {
+            case types.TriggerState.inactive:
+                this.state = types.TriggerState.pending;
+                break;
+            case types.TriggerState.pending:
+                this.state = types.TriggerState.runningRetrigger;
+                break;
+            case types.TriggerState.running:
+                throw new Error("Cannot transition from retrigger to running");
+            case types.TriggerState.stop:
+                this.#runHandler();
+        }
+    };
+    #stateFromRunningStop = (value) => {
+        switch (value) {
+            case types.TriggerState.inactive:
+                this.state = types.TriggerState.stop;
+                break;
+            case types.TriggerState.pending:
+            case types.TriggerState.running:
+            case types.TriggerState.runningRetrigger:
+            case types.TriggerState.runningStop:
+                throw new Error("Invalid state transition from runningStop");
+        }
+    };
+    #stateFromStop = (value) => {
+        switch (value) {
+            case types.TriggerState.inactive:
+            case types.TriggerState.pending:
+            case types.TriggerState.runningRetrigger:
+                this.state = types.TriggerState.stop;
+                break;
+            case types.TriggerState.running:
+                this.state = types.TriggerState.runningStop;
+                break;
+        }
+    };
+    #armTimeout = () => {
+        this.#disarmTimeout();
+        this.#logger.debug("Arming timeout");
+        this.#timeout = setTimeout(this.#runHandler, this.#delay);
+    };
+    #disarmTimeout = () => {
+        if (this.#timeout === null)
+            return;
+        this.#logger.debug("Disarming previous timeout");
+        clearTimeout(this.#timeout);
+        this.#timeout = null;
+    };
+    #runHandler = () => {
+        this.#logger.debug("Running handler");
+        this.state = types.TriggerState.running;
+        dropPromise(this.#runHandlerPromise, this.#logger);
+    };
+    #runHandlerPromise = async () => {
+        try {
+            await this.#handler();
+        }
+        finally {
+            this.state = types.TriggerState.inactive;
+        }
+    };
+}

package/lib/bits/triggers/debounce.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Debouncing trigger.
+ *
+ * Each time the trigger is triggered, the timer rearms itself, delaying the callback ever more.
+ * Once there is no trigger for the duration of the trigger, the callback is finally called.
+ *
+ * Useful for debouncing.
+ */
+export declare class DebounceTrigger extends BaseTrigger {
+    constructor(handler: types.TriggerHandler, delayMs: number, logger?: Logger | string);
+    trigger: () => void;
+}

package/lib/bits/triggers/debounce.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Debouncing trigger.
+ *
+ * Each time the trigger is triggered, the timer rearms itself, delaying the callback ever more.
+ * Once there is no trigger for the duration of the trigger, the callback is finally called.
+ *
+ * Useful for debouncing.
+ */
+export class DebounceTrigger extends BaseTrigger {
+    constructor(handler, delayMs, logger = "DebounceTrigger") {
+        super(handler, delayMs, logger);
+    }
+    trigger = () => {
+        if (this.state === types.TriggerState.pending) {
+            this.state = types.TriggerState.inactive;
+        }
+        this.state = types.TriggerState.pending;
+    };
+}

package/lib/bits/triggers/grenade.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Trigger that *will* fire its event after the time is elapsed, no matter how many times it is
+ * triggered afterward.
+ *
+ * After a call to `trigger()`, the timer is started.
+ * When it runs out, the even function is called.
+ * Multiple calls to `trigger()` will not delay the call, and they will not cause additional calls
+ * to occur.
+ * Calling `trigger()` while the callback is running will reschedule a call *after* the callback
+ * completes.
+ */
+export declare class GrenadeTrigger extends BaseTrigger {
+    constructor(handler: types.TriggerHandler, delayMs: number, logger?: Logger | string);
+    trigger: () => void;
+}

package/lib/bits/triggers/grenade.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Trigger that *will* fire its event after the time is elapsed, no matter how many times it is
+ * triggered afterward.
+ *
+ * After a call to `trigger()`, the timer is started.
+ * When it runs out, the even function is called.
+ * Multiple calls to `trigger()` will not delay the call, and they will not cause additional calls
+ * to occur.
+ * Calling `trigger()` while the callback is running will reschedule a call *after* the callback
+ * completes.
+ */
+export class GrenadeTrigger extends BaseTrigger {
+    constructor(handler, delayMs, logger = "GrenadeTrigger") {
+        super(handler, delayMs, logger);
+    }
+    trigger = () => {
+        this.logger.debug("Triggered");
+        this.state = types.TriggerState.pending;
+    };
+}

package/lib/bits/triggers/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Awaitable } from "../../types/types.js";
+export type TriggerHandler = () => Awaitable<void>;
+export declare enum TriggerState {
+    /** Trigger was not triggered */
+    inactive = "inactive",
+    /** Trigger was triggered, fuse timer is counting down */
+    pending = "pending",
+    /** Trigger was triggered and timer expired, the handler is running */
+    running = "running",
+    /** Handler is running, and trigger was called again */
+    runningRetrigger = "runningTrigger",
+    /** Last run after stop */
+    runningStop = "runningStop",
+    /** Handler is killed, will never run except for currently triggered call */
+    stop = "stop"
+}
+/** Generic interface for delayed triggers */
+export interface Trigger {
+    /** Call when the trigger should start (or restart, depending on the implementation) */
+    trigger: () => void;
+    /** Call when the trigger should be canceled */
+    cancel: () => void;
+    /**
+     * Call when the trigger should stop (it can't be triggered again).
+     * If there is an execution pending, it is run immediately.
+     */
+    stop: () => void;
+}

package/lib/bits/triggers/types.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+export var TriggerState;
+(function (TriggerState) {
+    /** Trigger was not triggered */
+    TriggerState["inactive"] = "inactive";
+    /** Trigger was triggered, fuse timer is counting down */
+    TriggerState["pending"] = "pending";
+    /** Trigger was triggered and timer expired, the handler is running */
+    TriggerState["running"] = "running";
+    /** Handler is running, and trigger was called again */
+    TriggerState["runningRetrigger"] = "runningTrigger";
+    /** Last run after stop */
+    TriggerState["runningStop"] = "runningStop";
+    /** Handler is killed, will never run except for currently triggered call */
+    TriggerState["stop"] = "stop";
+})(TriggerState || (TriggerState = {}));

package/lib/promise.d.ts

@@ -36,10 +36,29 @@ export type PromiseFunc<T> = () => Promise<T | void>;
  */
 export declare const firstTruthy: <T>(promiseFuncs: Array<PromiseFunc<T>>) => Promise<T>;
 type AwaitableFn<T> = () => Awaitable<T>;
+type ErrorHandler = boolean | ((e: Error) => void) | {
+    error: (e: unknown) => void;
+};
 /**
  * Drop a promise and silence any exception.
  *
  * This is to be used *only* on dropped promises to explicitly silence any warning.
+ *
+ * @param errorHandler - How to handle rejection
+ * If not provided or true, an error message is printed on the error output.
+ * If false, the error is silently ignored.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
+ */
+export declare const dropPromise: <T>(promise: Awaitable<T> | AwaitableFn<T>, errorHandler?: ErrorHandler) => void;
+/**
+ * Wait for a promise to complete, but ignore rejection.
+
+ * @param errorHandler - How to handle rejection
+ * If not provided or false, the error is silently ignored.
+ * If true, an error message is printed on the error output.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
  */
-export declare const dropPromise: <T>(promise: Awaitable<T> | AwaitableFn<T>) => void;
+export declare const ignorePromise: <T>(promise: Awaitable<T> | AwaitableFn<T>, errorHandler?: ErrorHandler) => Promise<void>;
 export {};

package/lib/promise.js

@@ -14,6 +14,8 @@
  * 
  */
 /* eslint-env node */
+import * as log from "@keeex/log";
+import { asError } from "./error.js";
 import { timeConvert } from "./units.js";
 /**
  * Create a promise that resolves after a given delay.
@@ -67,18 +69,59 @@ export const firstTruthy = async (promiseFuncs) => {
     }
     throw new Error("No result");
 };
+const logger = log.createLogger("dropPromise");
+const handleError = (handler, outputDefault, error) => {
+    if (handler === undefined) {
+        if (outputDefault)
+            logger.error("Dropped promise rejected:", error);
+    }
+    else if (handler === true) {
+        logger.error("Dropped promise rejected:", error);
+    }
+    else if (typeof handler === "function") {
+        handler(asError(error));
+    }
+    else if (handler !== false) {
+        handler.error(error);
+    }
+};
 /**
  * Drop a promise and silence any exception.
  *
  * This is to be used *only* on dropped promises to explicitly silence any warning.
+ *
+ * @param errorHandler - How to handle rejection
+ * If not provided or true, an error message is printed on the error output.
+ * If false, the error is silently ignored.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
  */
-export const dropPromise = (promise) => {
+export const dropPromise = (promise, errorHandler) => {
     if (typeof promise === "function") {
         dropPromise(promise());
         return;
     }
     if (promise instanceof Promise) {
-        // eslint-disable-next-line @typescript-eslint/no-empty-function, promise/prefer-await-to-then
-        promise.catch(() => { });
+        // eslint-disable-next-line promise/prefer-await-to-then
+        promise.catch((e) => handleError(errorHandler, true, e));
+    }
+};
+/**
+ * Wait for a promise to complete, but ignore rejection.
+
+ * @param errorHandler - How to handle rejection
+ * If not provided or false, the error is silently ignored.
+ * If true, an error message is printed on the error output.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
+ */
+export const ignorePromise = async (promise, errorHandler) => {
+    try {
+        if (typeof promise === "function")
+            return await ignorePromise(promise());
+        await promise;
+    }
+    catch (e) {
+        handleError(errorHandler, false, e);
     }
 };

package/lib/triggers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import { Trigger, TriggerHandler } from "./bits/triggers/types.js";
+/** Return a simple trigger that is run after the initial delay is passed after a trigger call */
+export declare const simpleTrigger: (handler: TriggerHandler, delayMs: number, logger?: Logger) => Trigger;
+/** Return a debouncing trigger that will rearm as long as it is triggered during the grace delay */
+export declare const debouncingTrigger: (handler: TriggerHandler, delayMs: number, logger?: Logger) => Trigger;

package/lib/triggers.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { DebounceTrigger } from "./bits/triggers/debounce.js";
+import { GrenadeTrigger } from "./bits/triggers/grenade.js";
+/** Return a simple trigger that is run after the initial delay is passed after a trigger call */
+export const simpleTrigger = (handler, delayMs, logger) => new GrenadeTrigger(handler, delayMs, logger);
+/** Return a debouncing trigger that will rearm as long as it is triggered during the grace delay */
+export const debouncingTrigger = (handler, delayMs, logger) => new DebounceTrigger(handler, delayMs, logger);

package/lib/units.js

@@ -92,8 +92,8 @@ const convertUnit = (unitDescription, fromUnit, toUnit) => {
     }
     return { from, to };
 };
-const regexBefore = /^(?<unit>[^\d]+)\d+$/u;
-const regexAfter = /^\d+(?<unit>[^\d]+)$/u;
+const regexBefore = /^(?<unit>[^\d,.]+)(?:(?:\d+)|(?:\d*[.,]\d+)|(?:\d+[.,]\d*))$/u;
+const regexAfter = /^(?:(?:\d+)|(?:\d*[.,]\d+)|(?:\d+[.,]\d*))(?<unit>[^\d,.]+)$/u;
 /** Get the unit text from an input value */
 const getUnitFromValue = (value, unitDesc) => {
     if (typeof value !== "string")
@@ -105,12 +105,13 @@ const getUnitFromValue = (value, unitDesc) => {
     const unit = res.groups.unit;
     return unit.trim();
 };
-const regexValue = /^(?:[^\d]*)(?<value>\d+)(?:[^\d]*)$/u;
+const regexFloatValue = /^(?:[^\d,.]*)(?<value>(?:\d+)|(?:\d*[.,]\d+)|(?:\d+[.,]\d*))(?:[^\d,.]*)$/u;
+const regexIntOnlyValue = /^(?:[^\d,.]*)(?<value>\d+)(?:[^\d,.]*)$/u;
 /** Get the numeric value, stripping units */
 const getNumberValue = (value) => {
     if (typeof value === "number")
         return value;
-    const res = regexValue.exec(value);
+    const res = regexFloatValue.exec(value);
     if (!res?.groups)
         throw new Error(`Missing value (${value})`);
     return parseFloat(res.groups.value);
@@ -121,7 +122,7 @@ const getBigintValue = (value) => {
         return value;
     if (typeof value === "number")
         return BigInt(value);
-    const res = regexValue.exec(value);
+    const res = regexIntOnlyValue.exec(value);
     if (!res?.groups)
         throw new Error(`Missing value (${value})`);
     return BigInt(res.groups.value);

package/package.json

@@ -1 +1 @@
-{"name":"@keeex/utils","version":"7.2.0","description":"Various utility functions for pure JavaScript","scripts":{},"author":"KeeeX SAS","contributors":[{"name":"Gabriel Paul \"Cley Faye\" Risterucci","email":"gabriel@keeex.net"}],"homepage":"https://keeex.me/oss","keywords":["utility"],"type":"module","license":"MIT","dependencies":{"@keeex/bubble_babble":"^3.0.1","@keeex/log":"^1.7.1","base64-arraybuffer":"^1.0.2","cron-parser":"^5.2.0","ms":"^2.1.3","text-encoding-shim":"^1.0.5"},"exports":{"./units.js":{"node":"./lib/units.js","browser":"./web/units.js","default":"./lib/units.js"},"./uint8array.js":{"node":"./lib/uint8array.js","browser":"./web/uint8array.js","default":"./lib/uint8array.js"},"./string.js":{"node":"./lib/string.js","browser":"./web/string.js","default":"./lib/string.js"},"./starttime.js":{"node":"./lib/starttime.js","browser":"./web/starttime.js","default":"./lib/starttime.js"},"./promise.js":{"node":"./lib/promise.js","browser":"./web/promise.js","default":"./lib/promise.js"},"./path.js":{"node":"./lib/path.js","browser":"./web/path.js","default":"./lib/path.js"},"./number.js":{"node":"./lib/number.js","browser":"./web/number.js","default":"./lib/number.js"},"./linebuffer.js":{"node":"./lib/linebuffer.js","browser":"./web/linebuffer.js","default":"./lib/linebuffer.js"},"./json.js":{"node":"./lib/json.js","browser":"./web/json.js","default":"./lib/json.js"},"./idx.js":{"node":"./lib/idx.js","browser":"./web/idx.js","default":"./lib/idx.js"},"./hex.js":{"node":"./lib/hex.js","browser":"./web/hex.js","default":"./lib/hex.js"},"./global.js":{"node":"./lib/global.js","browser":"./web/global.js","default":"./lib/global.js"},"./error.js":{"node":"./lib/error.js","browser":"./web/error.js","default":"./lib/error.js"},"./dict.js":{"node":"./lib/dict.js","browser":"./web/dict.js","default":"./lib/dict.js"},"./cron.js":{"node":"./lib/cron.js","browser":"./web/cron.js","default":"./lib/cron.js"},"./consts.js":{"node":"./lib/consts.js","browser":"./web/consts.js","default":"./lib/consts.js"},"./bytebuffer.js":{"node":"./lib/bytebuffer.js","browser":"./web/bytebuffer.js","default":"./lib/bytebuffer.js"},"./benchmark.js":{"node":"./lib/benchmark.js","browser":"./web/benchmark.js","default":"./lib/benchmark.js"},"./base64.js":{"node":"./lib/base64.js","browser":"./web/base64.js","default":"./lib/base64.js"},"./base58.js":{"node":"./lib/base58.js","browser":"./web/base58.js","default":"./lib/base58.js"},"./arraybuffer.js":{"node":"./lib/arraybuffer.js","browser":"./web/arraybuffer.js","default":"./lib/arraybuffer.js"},"./array.js":{"node":"./lib/array.js","browser":"./web/array.js","default":"./lib/array.js"},"./types/utils.js":{"node":"./lib/types/utils.js","browser":"./web/types/utils.js","default":"./lib/types/utils.js"},"./types/types.js":{"node":"./lib/types/types.js","browser":"./web/types/types.js","default":"./lib/types/types.js"},"./types/record.js":{"node":"./lib/types/record.js","browser":"./web/types/record.js","default":"./lib/types/record.js"},"./types/primitive.js":{"node":"./lib/types/primitive.js","browser":"./web/types/primitive.js","default":"./lib/types/primitive.js"},"./types/predicateerror.js":{"node":"./lib/types/predicateerror.js","browser":"./web/types/predicateerror.js","default":"./lib/types/predicateerror.js"},"./types/enum.js":{"node":"./lib/types/enum.js","browser":"./web/types/enum.js","default":"./lib/types/enum.js"},"./types/array.js":{"node":"./lib/types/array.js","browser":"./web/types/array.js","default":"./lib/types/array.js"},"./marshalling/unmarshaller.js":{"node":"./lib/marshalling/unmarshaller.js","browser":"./web/marshalling/unmarshaller.js","default":"./lib/marshalling/unmarshaller.js"},"./marshalling/marshaller.js":{"node":"./lib/marshalling/marshaller.js","browser":"./web/marshalling/marshaller.js","default":"./lib/marshalling/marshaller.js"},"./async/timecache.js":{"node":"./lib/async/timecache.js","browser":"./web/async/timecache.js","default":"./lib/async/timecache.js"},"./async/queues.js":{"node":"./lib/async/queues.js","browser":"./web/async/queues.js","default":"./lib/async/queues.js"},"./async/keycache.js":{"node":"./lib/async/keycache.js","browser":"./web/async/keycache.js","default":"./lib/async/keycache.js"},"./async/deferredpromise.js":{"node":"./lib/async/deferredpromise.js","browser":"./web/async/deferredpromise.js","default":"./lib/async/deferredpromise.js"},"./async/asynctrigger.js":{"node":"./lib/async/asynctrigger.js","browser":"./web/async/asynctrigger.js","default":"./lib/async/asynctrigger.js"}},"files":["/lib","/web"]}
+{"name":"@keeex/utils","version":"7.3.0","description":"Various utility functions for pure JavaScript","scripts":{},"author":"KeeeX SAS","contributors":[{"name":"Gabriel Paul \"Cley Faye\" Risterucci","email":"gabriel@keeex.net"}],"homepage":"https://keeex.me/oss","keywords":["utility"],"type":"module","license":"MIT","dependencies":{"@keeex/bubble_babble":"^3.0.1","@keeex/log":"^1.7.1","base64-arraybuffer":"^1.0.2","cron-parser":"^5.3.0","ms":"^2.1.3","text-encoding-shim":"^1.0.5"},"exports":{"./array.js":{"node":"./lib/array.js","browser":"./web/array.js","react-native":"./web/array.js","default":"./lib/array.js"},"./arraybuffer.js":{"node":"./lib/arraybuffer.js","browser":"./web/arraybuffer.js","react-native":"./web/arraybuffer.js","default":"./lib/arraybuffer.js"},"./async/asynctrigger.js":{"node":"./lib/async/asynctrigger.js","browser":"./web/async/asynctrigger.js","react-native":"./web/async/asynctrigger.js","default":"./lib/async/asynctrigger.js"},"./async/deferredpromise.js":{"node":"./lib/async/deferredpromise.js","browser":"./web/async/deferredpromise.js","react-native":"./web/async/deferredpromise.js","default":"./lib/async/deferredpromise.js"},"./async/keycache.js":{"node":"./lib/async/keycache.js","browser":"./web/async/keycache.js","react-native":"./web/async/keycache.js","default":"./lib/async/keycache.js"},"./async/queues.js":{"node":"./lib/async/queues.js","browser":"./web/async/queues.js","react-native":"./web/async/queues.js","default":"./lib/async/queues.js"},"./async/timecache.js":{"node":"./lib/async/timecache.js","browser":"./web/async/timecache.js","react-native":"./web/async/timecache.js","default":"./lib/async/timecache.js"},"./base58.js":{"node":"./lib/base58.js","browser":"./web/base58.js","react-native":"./web/base58.js","default":"./lib/base58.js"},"./base64.js":{"node":"./lib/base64.js","browser":"./web/base64.js","react-native":"./web/base64.js","default":"./lib/base64.js"},"./benchmark.js":{"node":"./lib/benchmark.js","browser":"./web/benchmark.js","react-native":"./web/benchmark.js","default":"./lib/benchmark.js"},"./bytebuffer.js":{"node":"./lib/bytebuffer.js","browser":"./web/bytebuffer.js","react-native":"./web/bytebuffer.js","default":"./lib/bytebuffer.js"},"./consts.js":{"node":"./lib/consts.js","browser":"./web/consts.js","react-native":"./web/consts.js","default":"./lib/consts.js"},"./cron.js":{"node":"./lib/cron.js","browser":"./web/cron.js","react-native":"./web/cron.js","default":"./lib/cron.js"},"./dict.js":{"node":"./lib/dict.js","browser":"./web/dict.js","react-native":"./web/dict.js","default":"./lib/dict.js"},"./error.js":{"node":"./lib/error.js","browser":"./web/error.js","react-native":"./web/error.js","default":"./lib/error.js"},"./global.js":{"node":"./lib/global.js","browser":"./web/global.js","react-native":"./web/global.js","default":"./lib/global.js"},"./hex.js":{"node":"./lib/hex.js","browser":"./web/hex.js","react-native":"./web/hex.js","default":"./lib/hex.js"},"./idx.js":{"node":"./lib/idx.js","browser":"./web/idx.js","react-native":"./web/idx.js","default":"./lib/idx.js"},"./json.js":{"node":"./lib/json.js","browser":"./web/json.js","react-native":"./web/json.js","default":"./lib/json.js"},"./linebuffer.js":{"node":"./lib/linebuffer.js","browser":"./web/linebuffer.js","react-native":"./web/linebuffer.js","default":"./lib/linebuffer.js"},"./marshalling/marshaller.js":{"node":"./lib/marshalling/marshaller.js","browser":"./web/marshalling/marshaller.js","react-native":"./web/marshalling/marshaller.js","default":"./lib/marshalling/marshaller.js"},"./marshalling/unmarshaller.js":{"node":"./lib/marshalling/unmarshaller.js","browser":"./web/marshalling/unmarshaller.js","react-native":"./web/marshalling/unmarshaller.js","default":"./lib/marshalling/unmarshaller.js"},"./number.js":{"node":"./lib/number.js","browser":"./web/number.js","react-native":"./web/number.js","default":"./lib/number.js"},"./path.js":{"node":"./lib/path.js","browser":"./web/path.js","react-native":"./web/path.js","default":"./lib/path.js"},"./promise.js":{"node":"./lib/promise.js","browser":"./web/promise.js","react-native":"./web/promise.js","default":"./lib/promise.js"},"./starttime.js":{"node":"./lib/starttime.js","browser":"./web/starttime.js","react-native":"./web/starttime.js","default":"./lib/starttime.js"},"./string.js":{"node":"./lib/string.js","browser":"./web/string.js","react-native":"./web/string.js","default":"./lib/string.js"},"./triggers.js":{"node":"./lib/triggers.js","browser":"./web/triggers.js","react-native":"./web/triggers.js","default":"./lib/triggers.js"},"./types/array.js":{"node":"./lib/types/array.js","browser":"./web/types/array.js","react-native":"./web/types/array.js","default":"./lib/types/array.js"},"./types/enum.js":{"node":"./lib/types/enum.js","browser":"./web/types/enum.js","react-native":"./web/types/enum.js","default":"./lib/types/enum.js"},"./types/predicateerror.js":{"node":"./lib/types/predicateerror.js","browser":"./web/types/predicateerror.js","react-native":"./web/types/predicateerror.js","default":"./lib/types/predicateerror.js"},"./types/primitive.js":{"node":"./lib/types/primitive.js","browser":"./web/types/primitive.js","react-native":"./web/types/primitive.js","default":"./lib/types/primitive.js"},"./types/record.js":{"node":"./lib/types/record.js","browser":"./web/types/record.js","react-native":"./web/types/record.js","default":"./lib/types/record.js"},"./types/types.js":{"node":"./lib/types/types.js","browser":"./web/types/types.js","react-native":"./web/types/types.js","default":"./lib/types/types.js"},"./types/utils.js":{"node":"./lib/types/utils.js","browser":"./web/types/utils.js","react-native":"./web/types/utils.js","default":"./lib/types/utils.js"},"./uint8array.js":{"node":"./lib/uint8array.js","browser":"./web/uint8array.js","react-native":"./web/uint8array.js","default":"./lib/uint8array.js"},"./units.js":{"node":"./lib/units.js","browser":"./web/units.js","react-native":"./web/units.js","default":"./lib/units.js"}},"files":["/lib","/web"]}

package/web/bits/triggers/base.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import * as types from "./types.js";
+/**
+ * Base implementation for all triggers.
+ */
+export declare abstract class BaseTrigger implements types.Trigger {
+    #private;
+    constructor(handler: types.TriggerHandler, delayMs: number, logger?: Logger | string);
+    protected get state(): types.TriggerState;
+    protected set state(value: types.TriggerState);
+    protected get logger(): Logger;
+    abstract trigger(): void;
+    cancel: () => void;
+    stop: () => void;
+}

package/web/bits/triggers/base.js

@@ -0,0 +1,173 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { createLogger } from "@keeex/log";
+import { dropPromise } from "../../promise.js";
+import * as types from "./types.js";
+/**
+ * Base implementation for all triggers.
+ */
+export class BaseTrigger {
+  #state = types.TriggerState.inactive;
+  #timeout = null;
+  #delay;
+  #handler;
+  #logger;
+  constructor(handler, delayMs, logger) {
+    this.#handler = handler;
+    this.#delay = delayMs;
+    if (typeof logger === "string") {
+      this.#logger = createLogger({
+        tag: logger,
+        numbered: true
+      });
+    } else if (logger) {
+      this.#logger = logger;
+    } else {
+      this.#logger = createLogger({
+        tag: "PromiseTrigger",
+        numbered: true
+      });
+    }
+    this.#logger.debug(`Initialized with timer of ${delayMs}`);
+  }
+  get state() {
+    return this.#state;
+  }
+  set state(value) {
+    const oldState = this.#state;
+    this.#logger.debug(`State transition: ${oldState} → ${value}`);
+    this.#state = value;
+    switch (oldState) {
+      case types.TriggerState.inactive:
+        this.#stateFromInactive(value);
+        break;
+      case types.TriggerState.pending:
+        this.#stateFromPending(value);
+        break;
+      case types.TriggerState.running:
+        this.#stateFromRunning(value);
+        break;
+      case types.TriggerState.runningRetrigger:
+        this.#stateFromRunningRetrigger(value);
+        break;
+      case types.TriggerState.runningStop:
+        this.#stateFromRunningStop(value);
+        break;
+      case types.TriggerState.stop:
+        this.#stateFromStop(value);
+        break;
+    }
+  }
+  get logger() {
+    return this.#logger;
+  }
+  cancel = () => {
+    this.state = types.TriggerState.inactive;
+  };
+  stop = () => {
+    this.state = types.TriggerState.stop;
+  };
+  #stateFromInactive = value => {
+    switch (value) {
+      case types.TriggerState.pending:
+        this.#armTimeout();
+        break;
+      case types.TriggerState.running:
+      case types.TriggerState.runningRetrigger:
+        throw new Error("Cannot transition from inactive to running");
+    }
+  };
+  #stateFromPending = value => {
+    switch (value) {
+      case types.TriggerState.inactive:
+        this.#disarmTimeout();
+        break;
+      case types.TriggerState.running:
+        this.#timeout = null;
+        break;
+      case types.TriggerState.stop:
+        this.#disarmTimeout();
+        this.#runHandler();
+    }
+  };
+  #stateFromRunning = value => {
+    switch (value) {
+      case types.TriggerState.pending:
+        this.state = types.TriggerState.runningRetrigger;
+    }
+  };
+  #stateFromRunningRetrigger = value => {
+    switch (value) {
+      case types.TriggerState.inactive:
+        this.state = types.TriggerState.pending;
+        break;
+      case types.TriggerState.pending:
+        this.state = types.TriggerState.runningRetrigger;
+        break;
+      case types.TriggerState.running:
+        throw new Error("Cannot transition from retrigger to running");
+      case types.TriggerState.stop:
+        this.#runHandler();
+    }
+  };
+  #stateFromRunningStop = value => {
+    switch (value) {
+      case types.TriggerState.inactive:
+        this.state = types.TriggerState.stop;
+        break;
+      case types.TriggerState.pending:
+      case types.TriggerState.running:
+      case types.TriggerState.runningRetrigger:
+      case types.TriggerState.runningStop:
+        throw new Error("Invalid state transition from runningStop");
+    }
+  };
+  #stateFromStop = value => {
+    switch (value) {
+      case types.TriggerState.inactive:
+      case types.TriggerState.pending:
+      case types.TriggerState.runningRetrigger:
+        this.state = types.TriggerState.stop;
+        break;
+      case types.TriggerState.running:
+        this.state = types.TriggerState.runningStop;
+        break;
+    }
+  };
+  #armTimeout = () => {
+    this.#disarmTimeout();
+    this.#logger.debug("Arming timeout");
+    this.#timeout = setTimeout(this.#runHandler, this.#delay);
+  };
+  #disarmTimeout = () => {
+    if (this.#timeout === null) return;
+    this.#logger.debug("Disarming previous timeout");
+    clearTimeout(this.#timeout);
+    this.#timeout = null;
+  };
+  #runHandler = () => {
+    this.#logger.debug("Running handler");
+    this.state = types.TriggerState.running;
+    dropPromise(this.#runHandlerPromise, this.#logger);
+  };
+  #runHandlerPromise = async () => {
+    try {
+      await this.#handler();
+    } finally {
+      this.state = types.TriggerState.inactive;
+    }
+  };
+}

package/web/bits/triggers/debounce.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Debouncing trigger.
+ *
+ * Each time the trigger is triggered, the timer rearms itself, delaying the callback ever more.
+ * Once there is no trigger for the duration of the trigger, the callback is finally called.
+ *
+ * Useful for debouncing.
+ */
+export declare class DebounceTrigger extends BaseTrigger {
+    constructor(handler: types.TriggerHandler, delayMs: number, logger?: Logger | string);
+    trigger: () => void;
+}

package/web/bits/triggers/debounce.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Debouncing trigger.
+ *
+ * Each time the trigger is triggered, the timer rearms itself, delaying the callback ever more.
+ * Once there is no trigger for the duration of the trigger, the callback is finally called.
+ *
+ * Useful for debouncing.
+ */
+export class DebounceTrigger extends BaseTrigger {
+  constructor(handler, delayMs, logger = "DebounceTrigger") {
+    super(handler, delayMs, logger);
+  }
+  trigger = () => {
+    if (this.state === types.TriggerState.pending) {
+      this.state = types.TriggerState.inactive;
+    }
+    this.state = types.TriggerState.pending;
+  };
+}

package/web/bits/triggers/grenade.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Trigger that *will* fire its event after the time is elapsed, no matter how many times it is
+ * triggered afterward.
+ *
+ * After a call to `trigger()`, the timer is started.
+ * When it runs out, the even function is called.
+ * Multiple calls to `trigger()` will not delay the call, and they will not cause additional calls
+ * to occur.
+ * Calling `trigger()` while the callback is running will reschedule a call *after* the callback
+ * completes.
+ */
+export declare class GrenadeTrigger extends BaseTrigger {
+    constructor(handler: types.TriggerHandler, delayMs: number, logger?: Logger | string);
+    trigger: () => void;
+}

package/web/bits/triggers/grenade.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { BaseTrigger } from "./base.js";
+import * as types from "./types.js";
+/**
+ * Trigger that *will* fire its event after the time is elapsed, no matter how many times it is
+ * triggered afterward.
+ *
+ * After a call to `trigger()`, the timer is started.
+ * When it runs out, the even function is called.
+ * Multiple calls to `trigger()` will not delay the call, and they will not cause additional calls
+ * to occur.
+ * Calling `trigger()` while the callback is running will reschedule a call *after* the callback
+ * completes.
+ */
+export class GrenadeTrigger extends BaseTrigger {
+  constructor(handler, delayMs, logger = "GrenadeTrigger") {
+    super(handler, delayMs, logger);
+  }
+  trigger = () => {
+    this.logger.debug("Triggered");
+    this.state = types.TriggerState.pending;
+  };
+}

package/web/bits/triggers/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Awaitable } from "../../types/types.js";
+export type TriggerHandler = () => Awaitable<void>;
+export declare enum TriggerState {
+    /** Trigger was not triggered */
+    inactive = "inactive",
+    /** Trigger was triggered, fuse timer is counting down */
+    pending = "pending",
+    /** Trigger was triggered and timer expired, the handler is running */
+    running = "running",
+    /** Handler is running, and trigger was called again */
+    runningRetrigger = "runningTrigger",
+    /** Last run after stop */
+    runningStop = "runningStop",
+    /** Handler is killed, will never run except for currently triggered call */
+    stop = "stop"
+}
+/** Generic interface for delayed triggers */
+export interface Trigger {
+    /** Call when the trigger should start (or restart, depending on the implementation) */
+    trigger: () => void;
+    /** Call when the trigger should be canceled */
+    cancel: () => void;
+    /**
+     * Call when the trigger should stop (it can't be triggered again).
+     * If there is an execution pending, it is run immediately.
+     */
+    stop: () => void;
+}

package/web/bits/triggers/types.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+export var TriggerState;
+(function (TriggerState) {
+  /** Trigger was not triggered */
+  TriggerState["inactive"] = "inactive";
+  /** Trigger was triggered, fuse timer is counting down */
+  TriggerState["pending"] = "pending";
+  /** Trigger was triggered and timer expired, the handler is running */
+  TriggerState["running"] = "running";
+  /** Handler is running, and trigger was called again */
+  TriggerState["runningRetrigger"] = "runningTrigger";
+  /** Last run after stop */
+  TriggerState["runningStop"] = "runningStop";
+  /** Handler is killed, will never run except for currently triggered call */
+  TriggerState["stop"] = "stop";
+})(TriggerState || (TriggerState = {}));

package/web/promise.d.ts

@@ -36,10 +36,29 @@ export type PromiseFunc<T> = () => Promise<T | void>;
  */
 export declare const firstTruthy: <T>(promiseFuncs: Array<PromiseFunc<T>>) => Promise<T>;
 type AwaitableFn<T> = () => Awaitable<T>;
+type ErrorHandler = boolean | ((e: Error) => void) | {
+    error: (e: unknown) => void;
+};
 /**
  * Drop a promise and silence any exception.
  *
  * This is to be used *only* on dropped promises to explicitly silence any warning.
+ *
+ * @param errorHandler - How to handle rejection
+ * If not provided or true, an error message is printed on the error output.
+ * If false, the error is silently ignored.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
+ */
+export declare const dropPromise: <T>(promise: Awaitable<T> | AwaitableFn<T>, errorHandler?: ErrorHandler) => void;
+/**
+ * Wait for a promise to complete, but ignore rejection.
+
+ * @param errorHandler - How to handle rejection
+ * If not provided or false, the error is silently ignored.
+ * If true, an error message is printed on the error output.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
  */
-export declare const dropPromise: <T>(promise: Awaitable<T> | AwaitableFn<T>) => void;
+export declare const ignorePromise: <T>(promise: Awaitable<T> | AwaitableFn<T>, errorHandler?: ErrorHandler) => Promise<void>;
 export {};

package/web/promise.js

@@ -14,6 +14,8 @@
  * 
  */
 /* eslint-env node */
+import * as log from "@keeex/log";
+import { asError } from "./error.js";
 import { timeConvert } from "./units.js";
 /**
  * Create a promise that resolves after a given delay.
@@ -63,18 +65,53 @@ export const firstTruthy = async promiseFuncs => {
   }
   throw new Error("No result");
 };
+const logger = log.createLogger("dropPromise");
+const handleError = (handler, outputDefault, error) => {
+  if (handler === undefined) {
+    if (outputDefault) logger.error("Dropped promise rejected:", error);
+  } else if (handler === true) {
+    logger.error("Dropped promise rejected:", error);
+  } else if (typeof handler === "function") {
+    handler(asError(error));
+  } else if (handler !== false) {
+    handler.error(error);
+  }
+};
 /**
  * Drop a promise and silence any exception.
  *
  * This is to be used *only* on dropped promises to explicitly silence any warning.
+ *
+ * @param errorHandler - How to handle rejection
+ * If not provided or true, an error message is printed on the error output.
+ * If false, the error is silently ignored.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
  */
-export const dropPromise = promise => {
+export const dropPromise = (promise, errorHandler) => {
   if (typeof promise === "function") {
     dropPromise(promise());
     return;
   }
   if (promise instanceof Promise) {
-    // eslint-disable-next-line @typescript-eslint/no-empty-function, promise/prefer-await-to-then
-    promise.catch(() => {});
+    // eslint-disable-next-line promise/prefer-await-to-then
+    promise.catch(e => handleError(errorHandler, true, e));
+  }
+};
+/**
+ * Wait for a promise to complete, but ignore rejection.
+
+ * @param errorHandler - How to handle rejection
+ * If not provided or false, the error is silently ignored.
+ * If true, an error message is printed on the error output.
+ * If a function is provided, it is called with an Error object.
+ * If an object with an `error()` function is provided, this error function is called.
+ */
+export const ignorePromise = async (promise, errorHandler) => {
+  try {
+    if (typeof promise === "function") return await ignorePromise(promise());
+    await promise;
+  } catch (e) {
+    handleError(errorHandler, false, e);
   }
 };

package/web/triggers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { Logger } from "@keeex/log";
+import { Trigger, TriggerHandler } from "./bits/triggers/types.js";
+/** Return a simple trigger that is run after the initial delay is passed after a trigger call */
+export declare const simpleTrigger: (handler: TriggerHandler, delayMs: number, logger?: Logger) => Trigger;
+/** Return a debouncing trigger that will rearm as long as it is triggered during the grace delay */
+export declare const debouncingTrigger: (handler: TriggerHandler, delayMs: number, logger?: Logger) => Trigger;

package/web/triggers.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * @preserve
+ *
+ * MIT License
+ * 
+ * Copyright (c) 2023 KeeeX SAS
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * 
+ */
+import { DebounceTrigger } from "./bits/triggers/debounce.js";
+import { GrenadeTrigger } from "./bits/triggers/grenade.js";
+/** Return a simple trigger that is run after the initial delay is passed after a trigger call */
+export const simpleTrigger = (handler, delayMs, logger) => new GrenadeTrigger(handler, delayMs, logger);
+/** Return a debouncing trigger that will rearm as long as it is triggered during the grace delay */
+export const debouncingTrigger = (handler, delayMs, logger) => new DebounceTrigger(handler, delayMs, logger);

package/web/units.js

@@ -125,8 +125,8 @@ const convertUnit = (unitDescription, fromUnit, toUnit) => {
     to
   };
 };
-const regexBefore = /^(?<unit>[^\d]+)\d+$/u;
-const regexAfter = /^\d+(?<unit>[^\d]+)$/u;
+const regexBefore = /^(?<unit>[^\d,.]+)(?:(?:\d+)|(?:\d*[.,]\d+)|(?:\d+[.,]\d*))$/u;
+const regexAfter = /^(?:(?:\d+)|(?:\d*[.,]\d+)|(?:\d+[.,]\d*))(?<unit>[^\d,.]+)$/u;
 /** Get the unit text from an input value */
 const getUnitFromValue = (value, unitDesc) => {
   if (typeof value !== "string") return unitDesc.basename;
@@ -136,11 +136,12 @@ const getUnitFromValue = (value, unitDesc) => {
   const unit = res.groups.unit;
   return unit.trim();
 };
-const regexValue = /^(?:[^\d]*)(?<value>\d+)(?:[^\d]*)$/u;
+const regexFloatValue = /^(?:[^\d,.]*)(?<value>(?:\d+)|(?:\d*[.,]\d+)|(?:\d+[.,]\d*))(?:[^\d,.]*)$/u;
+const regexIntOnlyValue = /^(?:[^\d,.]*)(?<value>\d+)(?:[^\d,.]*)$/u;
 /** Get the numeric value, stripping units */
 const getNumberValue = value => {
   if (typeof value === "number") return value;
-  const res = regexValue.exec(value);
+  const res = regexFloatValue.exec(value);
   if (!res?.groups) throw new Error(`Missing value (${value})`);
   return parseFloat(res.groups.value);
 };
@@ -148,7 +149,7 @@ const getNumberValue = value => {
 const getBigintValue = value => {
   if (typeof value === "bigint") return value;
   if (typeof value === "number") return BigInt(value);
-  const res = regexValue.exec(value);
+  const res = regexIntOnlyValue.exec(value);
   if (!res?.groups) throw new Error(`Missing value (${value})`);
   return BigInt(res.groups.value);
 };