@gitkraken/core-gitlens 0.6.0 → 0.7.0

package/dist/utils/cancellation.js

@@ -1,178 +1,163 @@
-import { getScopedCounter } from './counter.js';
-const cancellationErrorBrand = Symbol.for('CancellationError');
+import { getScopedCounter } from "./counter.js";
+//#region ../utils/src/cancellation.ts
+const cancellationErrorBrand = Symbol.for("CancellationError");
 /**
- * A standalone CancellationError for use in the library.
- * Uses a symbol brand so that both this class and the extension's
- * CancellationError (which extends vscode.CancellationError) are
- * recognized by `isCancellationError`.
- */
-export class CancellationError extends Error {
-    original;
-    [cancellationErrorBrand] = true;
-    constructor(original) {
-        super();
-        this.original = original;
-        this.name = 'CancellationError';
-        if (this.original) {
-            if (this.original.message.startsWith('Operation cancelled')) {
-                this.message = this.original.message;
-            }
-            else {
-                this.message = `Operation cancelled; ${this.original.message}`;
-            }
-        }
-        else {
-            this.message = 'Operation cancelled';
-        }
-        Error.captureStackTrace?.(this, new.target);
-    }
-}
-export function isCancellationError(ex) {
-    return ((ex instanceof Error && (cancellationErrorBrand in ex || ex.name === 'CancellationError')) ||
-        (ex instanceof DOMException && ex.name === 'AbortError'));
+* A standalone CancellationError for use in the library.
+* Uses a symbol brand so that both this class and the extension's
+* CancellationError (which extends vscode.CancellationError) are
+* recognized by `isCancellationError`.
+*/
+var CancellationError = class extends Error {
+	original;
+	_cancellationErrorBrand = true;
+	constructor(original) {
+		super();
+		this.original = original;
+		Object.defineProperty(this, cancellationErrorBrand, {
+			value: true,
+			writable: true,
+			enumerable: true,
+			configurable: true
+		});
+		this.name = "CancellationError";
+		if (this.original) {
+			if (this.original.message.startsWith("Operation cancelled")) this.message = this.original.message;
+			else this.message = `Operation cancelled; ${this.original.message}`;
+		} else this.message = "Operation cancelled";
+		Error.captureStackTrace?.(this, new.target);
+	}
+};
+function isCancellationError(ex) {
+	return ex instanceof Error && (cancellationErrorBrand in ex || ex.name === "CancellationError") || ex instanceof DOMException && ex.name === "AbortError";
 }
 /**
- * Races a promise against an `AbortSignal`. If the signal fires before
- * the promise settles, the returned promise rejects with `CancellationError`.
- * If the promise settles first, the signal listener is cleaned up.
- */
-export function raceWithSignal(promise, signal) {
-    if (signal.aborted)
-        return Promise.reject(new CancellationError());
-    return new Promise((resolve, reject) => {
-        const onAbort = () => reject(new CancellationError());
-        signal.addEventListener('abort', onAbort, { once: true });
-        promise.then(v => {
-            signal.removeEventListener('abort', onAbort);
-            resolve(v);
-        }, (e) => {
-            signal.removeEventListener('abort', onAbort);
-            reject(e instanceof Error ? e : new Error(String(e)));
-        });
-    });
+* Races a promise against an `AbortSignal`. If the signal fires before
+* the promise settles, the returned promise rejects with `CancellationError`.
+* If the promise settles first, the signal listener is cleaned up.
+*/
+function raceWithSignal(promise, signal) {
+	if (signal.aborted) return Promise.reject(new CancellationError());
+	return new Promise((resolve, reject) => {
+		const onAbort = () => reject(new CancellationError());
+		signal.addEventListener("abort", onAbort, { once: true });
+		promise.then((v) => {
+			signal.removeEventListener("abort", onAbort);
+			resolve(v);
+		}, (e) => {
+			signal.removeEventListener("abort", onAbort);
+			reject(e instanceof Error ? e : new Error(String(e)));
+		});
+	});
 }
 /**
- * Races a promise against a timeout. If `ms` elapses before the promise settles, the returned promise
- * rejects with `CancellationError`. If the promise settles first, the timer is cleared. Parallels
- * `raceWithSignal`, with a timer standing in for the signal.
- *
- * When `abortOnTimeout` is provided, it is aborted on timeout — so a caller can link the underlying operation to
- * it (e.g. via `AbortSignal.any`) and have it torn down instead of orphaned. Abort is best-effort (a truly-stuck
- * op may ignore it); the returned promise rejects on timeout regardless of whether the underlying op settles.
- */
-export function raceWithTimeout(promise, ms, abortOnTimeout) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => {
-            const error = new CancellationError(new Error(`Timed out after ${ms}ms`));
-            abortOnTimeout?.abort(error);
-            reject(error);
-        }, ms);
-        // Don't let the timeout timer keep a (Node) process alive on its own — a still-pending promise shouldn't
-        // hold the event loop open just for its backstop (no-op in the browser, where setTimeout returns a number).
-        if (typeof timer !== 'number') {
-            timer.unref();
-        }
-        promise.then(v => {
-            clearTimeout(timer);
-            resolve(v);
-        }, (e) => {
-            clearTimeout(timer);
-            reject(e instanceof Error ? e : new Error(String(e)));
-        });
-    });
+* Races a promise against a timeout. If `ms` elapses before the promise settles, the returned promise
+* rejects with `CancellationError`. If the promise settles first, the timer is cleared. Parallels
+* `raceWithSignal`, with a timer standing in for the signal.
+*
+* When `abortOnTimeout` is provided, it is aborted on timeout — so a caller can link the underlying operation to
+* it (e.g. via `AbortSignal.any`) and have it torn down instead of orphaned. Abort is best-effort (a truly-stuck
+* op may ignore it); the returned promise rejects on timeout regardless of whether the underlying op settles.
+*/
+function raceWithTimeout(promise, ms, abortOnTimeout) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => {
+			const error = new CancellationError(/* @__PURE__ */ new Error(`Timed out after ${ms}ms`));
+			abortOnTimeout?.abort(error);
+			reject(error);
+		}, ms);
+		if (typeof timer !== "number") timer.unref();
+		promise.then((v) => {
+			clearTimeout(timer);
+			resolve(v);
+		}, (e) => {
+			clearTimeout(timer);
+			reject(e instanceof Error ? e : new Error(String(e)));
+		});
+	});
 }
 /**
- * Aggregates multiple caller `AbortSignal`s into a single signal that
- * only fires when **all** callers have cancelled (the inverse of `AbortSignal.any()`).
- *
- * Designed for shared-promise caching: each caller registers their signal,
- * and the underlying operation receives the aggregate signal. Individual callers
- * can cancel early (via `raceWithSignal`), but the operation continues as long
- * as at least one caller is still active.
- */
-export class AbortAggregate {
-    controller = new AbortController();
-    activeCount = 0;
-    /** One listener-remover per registration (NOT keyed by signal), so adding the same signal twice is safe. */
-    cleanups = new Set();
-    /** The aggregate signal — only fires when all callers have cancelled. */
-    get signal() {
-        return this.controller.signal;
-    }
-    /**
-     * Register a caller.
-     * - If `cancellation` is provided, the caller is auto-removed when it fires.
-     * - If `cancellation` is `undefined`, the caller is "permanent" — the aggregate
-     *   can never fire while it's active. Call the returned cleanup on promise settle.
-     * - The same signal instance may safely be added more than once — each registration is tracked and cleaned up
-     *   independently, so no listener leaks.
-     * @returns A cleanup function to unregister the caller.
-     */
-    add(cancellation) {
-        this.activeCount++;
-        if (cancellation == null) {
-            return () => {
-                this.activeCount--;
-                this.checkAbort();
-            };
-        }
-        if (cancellation.aborted) {
-            this.activeCount--;
-            this.checkAbort();
-            return () => { };
-        }
-        // Track this registration's listener removal individually (a Set of removers, NOT keyed by the signal) so
-        // adding the same signal twice can't overwrite the other's cleanup. `settled` keeps both exit paths (abort
-        // vs. manual cleanup) idempotent and preserves the accounting: only `onAbort` decrements `activeCount`.
-        let settled = false;
-        let remove;
-        const onAbort = () => {
-            if (settled)
-                return;
-            settled = true;
-            this.cleanups.delete(remove);
-            this.activeCount--;
-            this.checkAbort();
-        };
-        remove = () => cancellation.removeEventListener('abort', onAbort);
-        cancellation.addEventListener('abort', onAbort, { once: true });
-        this.cleanups.add(remove);
-        return () => {
-            if (settled)
-                return;
-            settled = true;
-            this.cleanups.delete(remove);
-            remove();
-        };
-    }
-    checkAbort() {
-        if (this.activeCount <= 0 && !this.controller.signal.aborted) {
-            this.controller.abort();
-        }
-    }
-    /** Remove all abort listeners. Call when the cached promise settles. */
-    dispose() {
-        for (const remove of this.cleanups) {
-            remove();
-        }
-        this.cleanups.clear();
-    }
-}
-const signalIds = new WeakMap();
+* Aggregates multiple caller `AbortSignal`s into a single signal that
+* only fires when **all** callers have cancelled (the inverse of `AbortSignal.any()`).
+*
+* Designed for shared-promise caching: each caller registers their signal,
+* and the underlying operation receives the aggregate signal. Individual callers
+* can cancel early (via `raceWithSignal`), but the operation continues as long
+* as at least one caller is still active.
+*/
+var AbortAggregate = class {
+	controller = new AbortController();
+	activeCount = 0;
+	/** One listener-remover per registration (NOT keyed by signal), so adding the same signal twice is safe. */
+	cleanups = /* @__PURE__ */ new Set();
+	/** The aggregate signal — only fires when all callers have cancelled. */
+	get signal() {
+		return this.controller.signal;
+	}
+	/**
+	* Register a caller.
+	* - If `cancellation` is provided, the caller is auto-removed when it fires.
+	* - If `cancellation` is `undefined`, the caller is "permanent" — the aggregate
+	*   can never fire while it's active. Call the returned cleanup on promise settle.
+	* - The same signal instance may safely be added more than once — each registration is tracked and cleaned up
+	*   independently, so no listener leaks.
+	* @returns A cleanup function to unregister the caller.
+	*/
+	add(cancellation) {
+		this.activeCount++;
+		if (cancellation == null) return () => {
+			this.activeCount--;
+			this.checkAbort();
+		};
+		if (cancellation.aborted) {
+			this.activeCount--;
+			this.checkAbort();
+			return () => {};
+		}
+		let settled = false;
+		let remove;
+		const onAbort = () => {
+			if (settled) return;
+			settled = true;
+			this.cleanups.delete(remove);
+			this.activeCount--;
+			this.checkAbort();
+		};
+		remove = () => cancellation.removeEventListener("abort", onAbort);
+		cancellation.addEventListener("abort", onAbort, { once: true });
+		this.cleanups.add(remove);
+		return () => {
+			if (settled) return;
+			settled = true;
+			this.cleanups.delete(remove);
+			remove();
+		};
+	}
+	checkAbort() {
+		if (this.activeCount <= 0 && !this.controller.signal.aborted) this.controller.abort();
+	}
+	/** Remove all abort listeners. Call when the cached promise settles. */
+	dispose() {
+		for (const remove of this.cleanups) remove();
+		this.cleanups.clear();
+	}
+};
+const signalIds = /* @__PURE__ */ new WeakMap();
 const signalIdCounter = getScopedCounter();
 /**
- * Returns a stable, unique numeric ID for the given AbortSignal.
- * Used to differentiate concurrent git commands that have different
- * cancellation signals, so one caller aborting doesn't cancel another.
- */
-export function getAbortSignalId(signal) {
-    if (signal == null)
-        return '';
-    let id = signalIds.get(signal);
-    if (id == null) {
-        id = signalIdCounter.next();
-        signalIds.set(signal, id);
-    }
-    return String(id);
+* Returns a stable, unique numeric ID for the given AbortSignal.
+* Used to differentiate concurrent git commands that have different
+* cancellation signals, so one caller aborting doesn't cancel another.
+*/
+function getAbortSignalId(signal) {
+	if (signal == null) return "";
+	let id = signalIds.get(signal);
+	if (id == null) {
+		id = signalIdCounter.next();
+		signalIds.set(signal, id);
+	}
+	return String(id);
 }
+//#endregion
+export { AbortAggregate, CancellationError, getAbortSignalId, isCancellationError, raceWithSignal, raceWithTimeout };
+
 //# sourceMappingURL=cancellation.js.map

package/dist/utils/cancellation.js.map

@@ -1 +1 @@
-{"version":3,"file":"cancellation.js","sourceRoot":"","sources":["../../src/utils/cancellation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cancellation.js","names":[],"sources":["../../../utils/src/cancellation.ts"],"sourcesContent":["import { getScopedCounter } from './counter.js';\n\nconst cancellationErrorBrand = Symbol.for('CancellationError');\n\n/**\n * A standalone CancellationError for use in the library.\n * Uses a symbol brand so that both this class and the extension's\n * CancellationError (which extends vscode.CancellationError) are\n * recognized by `isCancellationError`.\n */\nexport class CancellationError extends Error {\n\t// TS-only nominal brand (not read anywhere) — without it, `CancellationError` has the same\n\t// structural shape as any other `Error` subtype, so `isCancellationError`'s negative narrowing\n\t// (`if (isCancellationError(ex)) throw ex;`) collapses an unrelated error union to `never` instead\n\t// of leaving it narrowed. The runtime brand stays a symbol (below) for the cross-realm check.\n\tprivate readonly _cancellationErrorBrand: true = true;\n\n\tconstructor(public readonly original?: Error) {\n\t\tsuper();\n\t\t// A symbol-keyed computed class field can't be typed for `isolatedDeclarations` (only well-known\n\t\t// symbols like `Symbol.iterator` qualify), so the brand is set here with the same runtime shape\n\t\t// (writable/enumerable/configurable) a plain field assignment would produce.\n\t\tObject.defineProperty(this, cancellationErrorBrand, {\n\t\t\tvalue: true,\n\t\t\twritable: true,\n\t\t\tenumerable: true,\n\t\t\tconfigurable: true,\n\t\t});\n\t\tthis.name = 'CancellationError';\n\n\t\tif (this.original) {\n\t\t\tif (this.original.message.startsWith('Operation cancelled')) {\n\t\t\t\tthis.message = this.original.message;\n\t\t\t} else {\n\t\t\t\tthis.message = `Operation cancelled; ${this.original.message}`;\n\t\t\t}\n\t\t} else {\n\t\t\tthis.message = 'Operation cancelled';\n\t\t}\n\t\tError.captureStackTrace?.(this, new.target);\n\t}\n}\n\nexport function isCancellationError(ex: unknown): ex is CancellationError {\n\treturn (\n\t\t(ex instanceof Error && (cancellationErrorBrand in ex || ex.name === 'CancellationError')) ||\n\t\t(ex instanceof DOMException && ex.name === 'AbortError')\n\t);\n}\n\n/**\n * Races a promise against an `AbortSignal`. If the signal fires before\n * the promise settles, the returned promise rejects with `CancellationError`.\n * If the promise settles first, the signal listener is cleaned up.\n */\nexport function raceWithSignal<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {\n\tif (signal.aborted) return Promise.reject(new CancellationError());\n\n\treturn new Promise<T>((resolve, reject) => {\n\t\tconst onAbort = () => reject(new CancellationError());\n\t\tsignal.addEventListener('abort', onAbort, { once: true });\n\t\tpromise.then(\n\t\t\tv => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort);\n\t\t\t\tresolve(v);\n\t\t\t},\n\t\t\t(e: unknown) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort);\n\t\t\t\treject(e instanceof Error ? e : new Error(String(e)));\n\t\t\t},\n\t\t);\n\t});\n}\n\n/**\n * Races a promise against a timeout. If `ms` elapses before the promise settles, the returned promise\n * rejects with `CancellationError`. If the promise settles first, the timer is cleared. Parallels\n * `raceWithSignal`, with a timer standing in for the signal.\n *\n * When `abortOnTimeout` is provided, it is aborted on timeout — so a caller can link the underlying operation to\n * it (e.g. via `AbortSignal.any`) and have it torn down instead of orphaned. Abort is best-effort (a truly-stuck\n * op may ignore it); the returned promise rejects on timeout regardless of whether the underlying op settles.\n */\nexport function raceWithTimeout<T>(promise: Promise<T>, ms: number, abortOnTimeout?: AbortController): Promise<T> {\n\treturn new Promise<T>((resolve, reject) => {\n\t\tconst timer = setTimeout(() => {\n\t\t\tconst error = new CancellationError(new Error(`Timed out after ${ms}ms`));\n\t\t\tabortOnTimeout?.abort(error);\n\t\t\treject(error);\n\t\t}, ms);\n\t\t// Don't let the timeout timer keep a (Node) process alive on its own — a still-pending promise shouldn't\n\t\t// hold the event loop open just for its backstop (no-op in the browser, where setTimeout returns a number).\n\t\tif (typeof timer !== 'number') {\n\t\t\ttimer.unref();\n\t\t}\n\t\tpromise.then(\n\t\t\tv => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tresolve(v);\n\t\t\t},\n\t\t\t(e: unknown) => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\treject(e instanceof Error ? e : new Error(String(e)));\n\t\t\t},\n\t\t);\n\t});\n}\n\n/**\n * Aggregates multiple caller `AbortSignal`s into a single signal that\n * only fires when **all** callers have cancelled (the inverse of `AbortSignal.any()`).\n *\n * Designed for shared-promise caching: each caller registers their signal,\n * and the underlying operation receives the aggregate signal. Individual callers\n * can cancel early (via `raceWithSignal`), but the operation continues as long\n * as at least one caller is still active.\n */\nexport class AbortAggregate {\n\tprivate readonly controller = new AbortController();\n\tprivate activeCount = 0;\n\t/** One listener-remover per registration (NOT keyed by signal), so adding the same signal twice is safe. */\n\tprivate readonly cleanups = new Set<() => void>();\n\n\t/** The aggregate signal — only fires when all callers have cancelled. */\n\tget signal(): AbortSignal {\n\t\treturn this.controller.signal;\n\t}\n\n\t/**\n\t * Register a caller.\n\t * - If `cancellation` is provided, the caller is auto-removed when it fires.\n\t * - If `cancellation` is `undefined`, the caller is \"permanent\" — the aggregate\n\t *   can never fire while it's active. Call the returned cleanup on promise settle.\n\t * - The same signal instance may safely be added more than once — each registration is tracked and cleaned up\n\t *   independently, so no listener leaks.\n\t * @returns A cleanup function to unregister the caller.\n\t */\n\tadd(cancellation?: AbortSignal): () => void {\n\t\tthis.activeCount++;\n\n\t\tif (cancellation == null) {\n\t\t\treturn () => {\n\t\t\t\tthis.activeCount--;\n\t\t\t\tthis.checkAbort();\n\t\t\t};\n\t\t}\n\n\t\tif (cancellation.aborted) {\n\t\t\tthis.activeCount--;\n\t\t\tthis.checkAbort();\n\t\t\treturn () => {};\n\t\t}\n\n\t\t// Track this registration's listener removal individually (a Set of removers, NOT keyed by the signal) so\n\t\t// adding the same signal twice can't overwrite the other's cleanup. `settled` keeps both exit paths (abort\n\t\t// vs. manual cleanup) idempotent and preserves the accounting: only `onAbort` decrements `activeCount`.\n\t\tlet settled = false;\n\t\tlet remove: () => void;\n\t\tconst onAbort = () => {\n\t\t\tif (settled) return;\n\n\t\t\tsettled = true;\n\t\t\tthis.cleanups.delete(remove);\n\t\t\tthis.activeCount--;\n\t\t\tthis.checkAbort();\n\t\t};\n\t\tremove = () => cancellation.removeEventListener('abort', onAbort);\n\t\tcancellation.addEventListener('abort', onAbort, { once: true });\n\t\tthis.cleanups.add(remove);\n\n\t\treturn () => {\n\t\t\tif (settled) return;\n\n\t\t\tsettled = true;\n\t\t\tthis.cleanups.delete(remove);\n\t\t\tremove();\n\t\t};\n\t}\n\n\tprivate checkAbort(): void {\n\t\tif (this.activeCount <= 0 && !this.controller.signal.aborted) {\n\t\t\tthis.controller.abort();\n\t\t}\n\t}\n\n\t/** Remove all abort listeners. Call when the cached promise settles. */\n\tdispose(): void {\n\t\tfor (const remove of this.cleanups) {\n\t\t\tremove();\n\t\t}\n\t\tthis.cleanups.clear();\n\t}\n}\n\nconst signalIds = new WeakMap<AbortSignal, number>();\nconst signalIdCounter = getScopedCounter();\n\n/**\n * Returns a stable, unique numeric ID for the given AbortSignal.\n * Used to differentiate concurrent git commands that have different\n * cancellation signals, so one caller aborting doesn't cancel another.\n */\nexport function getAbortSignalId(signal: AbortSignal | undefined): string {\n\tif (signal == null) return '';\n\n\tlet id = signalIds.get(signal);\n\tif (id == null) {\n\t\tid = signalIdCounter.next();\n\t\tsignalIds.set(signal, id);\n\t}\n\treturn String(id);\n}\n"],"mappings":"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"}

package/dist/utils/charCode.d.ts

@@ -1,39 +1,33 @@
-export declare const CharCode: {
-    /**
-     * The `#` character.
-     */
-    readonly Hash: 35;
-    /**
-     * The `/` character.
-     */
-    readonly Slash: 47;
-    readonly Digit0: 48;
-    readonly Digit1: 49;
-    readonly Digit2: 50;
-    readonly Digit3: 51;
-    readonly Digit4: 52;
-    readonly Digit5: 53;
-    readonly Digit6: 54;
-    readonly Digit7: 55;
-    readonly Digit8: 56;
-    readonly Digit9: 57;
-    /**
-     * The `\` character.
-     */
-    readonly Backslash: 92;
-    readonly A: 65;
-    readonly B: 66;
-    readonly C: 67;
-    readonly D: 68;
-    readonly E: 69;
-    readonly F: 70;
-    readonly Z: 90;
-    readonly a: 97;
-    readonly b: 98;
-    readonly c: 99;
-    readonly d: 100;
-    readonly e: 101;
-    readonly f: 102;
-    readonly z: 122;
+//#region ../utils/src/charCode.d.ts
+type CharCodeMap = {
+  readonly Hash: 35;
+  readonly Slash: 47;
+  readonly Digit0: 48;
+  readonly Digit1: 49;
+  readonly Digit2: 50;
+  readonly Digit3: 51;
+  readonly Digit4: 52;
+  readonly Digit5: 53;
+  readonly Digit6: 54;
+  readonly Digit7: 55;
+  readonly Digit8: 56;
+  readonly Digit9: 57;
+  readonly Backslash: 92;
+  readonly A: 65;
+  readonly B: 66;
+  readonly C: 67;
+  readonly D: 68;
+  readonly E: 69;
+  readonly F: 70;
+  readonly Z: 90;
+  readonly a: 97;
+  readonly b: 98;
+  readonly c: 99;
+  readonly d: 100;
+  readonly e: 101;
+  readonly f: 102;
+  readonly z: 122;
 };
+export declare const CharCode: CharCodeMap;
+//#endregion
 //# sourceMappingURL=charCode.d.ts.map

package/dist/utils/charCode.js

@@ -1,39 +1,43 @@
-export const CharCode = {
-    /**
-     * The `#` character.
-     */
-    Hash: 35,
-    /**
-     * The `/` character.
-     */
-    Slash: 47,
-    Digit0: 48,
-    Digit1: 49,
-    Digit2: 50,
-    Digit3: 51,
-    Digit4: 52,
-    Digit5: 53,
-    Digit6: 54,
-    Digit7: 55,
-    Digit8: 56,
-    Digit9: 57,
-    /**
-     * The `\` character.
-     */
-    Backslash: 92,
-    A: 65,
-    B: 66,
-    C: 67,
-    D: 68,
-    E: 69,
-    F: 70,
-    Z: 90,
-    a: 97,
-    b: 98,
-    c: 99,
-    d: 100,
-    e: 101,
-    f: 102,
-    z: 122,
+//#region ../utils/src/charCode.ts
+const CharCode = {
+	/**
+	* The `#` character.
+	*/
+	Hash: 35,
+	/**
+	* The `/` character.
+	*/
+	Slash: 47,
+	Digit0: 48,
+	Digit1: 49,
+	Digit2: 50,
+	Digit3: 51,
+	Digit4: 52,
+	Digit5: 53,
+	Digit6: 54,
+	Digit7: 55,
+	Digit8: 56,
+	Digit9: 57,
+	/**
+	* The `\` character.
+	*/
+	Backslash: 92,
+	A: 65,
+	B: 66,
+	C: 67,
+	D: 68,
+	E: 69,
+	F: 70,
+	Z: 90,
+	a: 97,
+	b: 98,
+	c: 99,
+	d: 100,
+	e: 101,
+	f: 102,
+	z: 122
 };
+//#endregion
+export { CharCode };
+
 //# sourceMappingURL=charCode.js.map

package/dist/utils/charCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"charCode.js","sourceRoot":"","sources":["../../src/utils/charCode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE,EAAE;IACR;;OAEG;IACH,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV;;OAEG;IACH,SAAS,EAAE,EAAE;IACb,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;CACoC,CAAC"}
+{"version":3,"file":"charCode.js","names":[],"sources":["../../../utils/src/charCode.ts"],"sourcesContent":["type CharCodeMap = {\n\treadonly Hash: 35;\n\treadonly Slash: 47;\n\treadonly Digit0: 48;\n\treadonly Digit1: 49;\n\treadonly Digit2: 50;\n\treadonly Digit3: 51;\n\treadonly Digit4: 52;\n\treadonly Digit5: 53;\n\treadonly Digit6: 54;\n\treadonly Digit7: 55;\n\treadonly Digit8: 56;\n\treadonly Digit9: 57;\n\treadonly Backslash: 92;\n\treadonly A: 65;\n\treadonly B: 66;\n\treadonly C: 67;\n\treadonly D: 68;\n\treadonly E: 69;\n\treadonly F: 70;\n\treadonly Z: 90;\n\treadonly a: 97;\n\treadonly b: 98;\n\treadonly c: 99;\n\treadonly d: 100;\n\treadonly e: 101;\n\treadonly f: 102;\n\treadonly z: 122;\n};\n\nexport const CharCode: CharCodeMap = {\n\t/**\n\t * The `#` character.\n\t */\n\tHash: 35,\n\t/**\n\t * The `/` character.\n\t */\n\tSlash: 47,\n\tDigit0: 48,\n\tDigit1: 49,\n\tDigit2: 50,\n\tDigit3: 51,\n\tDigit4: 52,\n\tDigit5: 53,\n\tDigit6: 54,\n\tDigit7: 55,\n\tDigit8: 56,\n\tDigit9: 57,\n\t/**\n\t * The `\\` character.\n\t */\n\tBackslash: 92,\n\tA: 65,\n\tB: 66,\n\tC: 67,\n\tD: 68,\n\tE: 69,\n\tF: 70,\n\tZ: 90,\n\ta: 97,\n\tb: 98,\n\tc: 99,\n\td: 100,\n\te: 101,\n\tf: 102,\n\tz: 122,\n} as const satisfies Record<string, number>;\n"],"mappings":";AA8BA,MAAa,WAAwB;;;;CAIpC,MAAM;;;;CAIN,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;;;;CAIR,WAAW;CACX,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACJ"}

package/dist/utils/coalescedRun.d.ts

@@ -1,16 +1,18 @@
+//#region ../utils/src/coalescedRun.d.ts
 /** Single-flight async runner with one trailing rerun: `run()` while a run is in flight joins the
  *  SAME promise and marks it dirty; when the run settles (resolve OR reject), one trailing `refire`
  *  fires so state that changed mid-run is re-processed. `refire` should re-enter the owner's calling
  *  method (which applies its own gates) — fire-and-forget. `markDirty()` forces the trailing refire
  *  (e.g. on a repo swap mid-run) without joining. */
 export declare class CoalescedRun<T> {
-    private readonly fn;
-    private readonly refire;
-    private _dirty;
-    private _inflight;
-    constructor(fn: () => Promise<T>, refire: () => void);
-    get running(): boolean;
-    markDirty(): void;
-    run(): Promise<T>;
+  private readonly fn;
+  private readonly refire;
+  private _dirty;
+  private _inflight;
+  constructor(fn: () => Promise<T>, refire: () => void);
+  get running(): boolean;
+  markDirty(): void;
+  run(): Promise<T>;
 }
+//#endregion
 //# sourceMappingURL=coalescedRun.d.ts.map