@gitkraken/core-gitlens 0.5.116 → 0.7.0

package/dist/utils/dedupedAsyncCache.js

@@ -1,68 +1,65 @@
+//#region ../utils/src/dedupedAsyncCache.ts
 /**
- * Per-key cache for async resolution that dedupes concurrent first-time callers and caches the
- * resolved value (including `undefined`) for subsequent reads.
- *
- * Two internal Maps drive the semantics:
- * - `_resolved` holds settled values. `has(key)` distinguishes a cached `undefined` from "never
- *   resolved", so callers can intentionally cache "no result" without re-running the resolver.
- * - `_resolving` holds in-flight Promises. While a key resolves, concurrent `getOrResolve` callers
- *   share the same Promise instead of each invoking the resolver.
- *
- * Failed resolutions do not poison the cache — the entry is removed when the in-flight Promise
- * rejects, so the next call retries.
- */
-export class DedupedAsyncCache {
-    _resolved = new Map();
-    _resolving = new Map();
-    /** True iff `key` has a settled value cached. Distinct from "currently resolving". */
-    has(key) {
-        return this._resolved.has(key);
-    }
-    /** Settled value for `key`, or `undefined` when not yet cached. May also legitimately return
-     *  `undefined` for a key whose cached value is `undefined`; use `has` to disambiguate. */
-    get(key) {
-        return this._resolved.get(key);
-    }
-    /** Populates the cache directly, bypassing the resolver. Used by callers that already know the
-     *  value (e.g. event payloads, post-write reconciles) and want subsequent reads to hit. */
-    set(key, value) {
-        this._resolved.set(key, value);
-    }
-    /** Removes both the settled value and any in-flight Promise for `key`. */
-    delete(key) {
-        this._resolved.delete(key);
-        this._resolving.delete(key);
-    }
-    /** Clears everything — both settled values and in-flight Promises. */
-    clear() {
-        this._resolved.clear();
-        this._resolving.clear();
-    }
-    /**
-     * Returns the cached value for `key`, invoking `resolver` only on a cache miss. Concurrent
-     * cache-miss callers for the same key share the same in-flight Promise — `resolver` is invoked
-     * exactly once per cache fill. If `resolver` rejects, the entry is removed so subsequent calls
-     * retry rather than receiving a permanently cached failure.
-     */
-    getOrResolve(key, resolver) {
-        if (this._resolved.has(key)) {
-            // Map.get returns `V | undefined`; `has` confirmed presence, so the value (even if it
-            // is `undefined` by intent) is the cached one. Cast pins the return type.
-            return Promise.resolve(this._resolved.get(key));
-        }
-        const existing = this._resolving.get(key);
-        if (existing != null)
-            return existing;
-        const pending = resolver()
-            .then(value => {
-            this._resolved.set(key, value);
-            return value;
-        })
-            .finally(() => {
-            this._resolving.delete(key);
-        });
-        this._resolving.set(key, pending);
-        return pending;
-    }
-}
+* Per-key cache for async resolution that dedupes concurrent first-time callers and caches the
+* resolved value (including `undefined`) for subsequent reads.
+*
+* Two internal Maps drive the semantics:
+* - `_resolved` holds settled values. `has(key)` distinguishes a cached `undefined` from "never
+*   resolved", so callers can intentionally cache "no result" without re-running the resolver.
+* - `_resolving` holds in-flight Promises. While a key resolves, concurrent `getOrResolve` callers
+*   share the same Promise instead of each invoking the resolver.
+*
+* Failed resolutions do not poison the cache — the entry is removed when the in-flight Promise
+* rejects, so the next call retries.
+*/
+var DedupedAsyncCache = class {
+	_resolved = /* @__PURE__ */ new Map();
+	_resolving = /* @__PURE__ */ new Map();
+	/** True iff `key` has a settled value cached. Distinct from "currently resolving". */
+	has(key) {
+		return this._resolved.has(key);
+	}
+	/** Settled value for `key`, or `undefined` when not yet cached. May also legitimately return
+	*  `undefined` for a key whose cached value is `undefined`; use `has` to disambiguate. */
+	get(key) {
+		return this._resolved.get(key);
+	}
+	/** Populates the cache directly, bypassing the resolver. Used by callers that already know the
+	*  value (e.g. event payloads, post-write reconciles) and want subsequent reads to hit. */
+	set(key, value) {
+		this._resolved.set(key, value);
+	}
+	/** Removes both the settled value and any in-flight Promise for `key`. */
+	delete(key) {
+		this._resolved.delete(key);
+		this._resolving.delete(key);
+	}
+	/** Clears everything — both settled values and in-flight Promises. */
+	clear() {
+		this._resolved.clear();
+		this._resolving.clear();
+	}
+	/**
+	* Returns the cached value for `key`, invoking `resolver` only on a cache miss. Concurrent
+	* cache-miss callers for the same key share the same in-flight Promise — `resolver` is invoked
+	* exactly once per cache fill. If `resolver` rejects, the entry is removed so subsequent calls
+	* retry rather than receiving a permanently cached failure.
+	*/
+	getOrResolve(key, resolver) {
+		if (this._resolved.has(key)) return Promise.resolve(this._resolved.get(key));
+		const existing = this._resolving.get(key);
+		if (existing != null) return existing;
+		const pending = resolver().then((value) => {
+			this._resolved.set(key, value);
+			return value;
+		}).finally(() => {
+			this._resolving.delete(key);
+		});
+		this._resolving.set(key, pending);
+		return pending;
+	}
+};
+//#endregion
+export { DedupedAsyncCache };
+
 //# sourceMappingURL=dedupedAsyncCache.js.map

package/dist/utils/dedupedAsyncCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"dedupedAsyncCache.js","sourceRoot":"","sources":["../../src/utils/dedupedAsyncCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IACZ,SAAS,GAAG,IAAI,GAAG,EAAQ,CAAC;IAC5B,UAAU,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEvD,sFAAsF;IACtF,GAAG,CAAC,GAAM;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;8FAC0F;IAC1F,GAAG,CAAC,GAAM;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;+FAC2F;IAC3F,GAAG,CAAC,GAAM,EAAE,KAAQ;QACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,0EAA0E;IAC1E,MAAM,CAAC,GAAM;QACZ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,sEAAsE;IACtE,KAAK;QACJ,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,GAAM,EAAE,QAA0B;QAC9C,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,sFAAsF;YACtF,0EAA0E;YAC1E,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,QAAQ,IAAI,IAAI;YAAE,OAAO,QAAQ,CAAC;QAEtC,MAAM,OAAO,GAAG,QAAQ,EAAE;aACxB,IAAI,CAAC,KAAK,CAAC,EAAE;YACb,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/B,OAAO,KAAK,CAAC;QACd,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}
+{"version":3,"file":"dedupedAsyncCache.js","names":[],"sources":["../../../utils/src/dedupedAsyncCache.ts"],"sourcesContent":["/**\n * Per-key cache for async resolution that dedupes concurrent first-time callers and caches the\n * resolved value (including `undefined`) for subsequent reads.\n *\n * Two internal Maps drive the semantics:\n * - `_resolved` holds settled values. `has(key)` distinguishes a cached `undefined` from \"never\n *   resolved\", so callers can intentionally cache \"no result\" without re-running the resolver.\n * - `_resolving` holds in-flight Promises. While a key resolves, concurrent `getOrResolve` callers\n *   share the same Promise instead of each invoking the resolver.\n *\n * Failed resolutions do not poison the cache — the entry is removed when the in-flight Promise\n * rejects, so the next call retries.\n */\nexport class DedupedAsyncCache<K, V> {\n\tprivate readonly _resolved = new Map<K, V>();\n\tprivate readonly _resolving = new Map<K, Promise<V>>();\n\n\t/** True iff `key` has a settled value cached. Distinct from \"currently resolving\". */\n\thas(key: K): boolean {\n\t\treturn this._resolved.has(key);\n\t}\n\n\t/** Settled value for `key`, or `undefined` when not yet cached. May also legitimately return\n\t *  `undefined` for a key whose cached value is `undefined`; use `has` to disambiguate. */\n\tget(key: K): V | undefined {\n\t\treturn this._resolved.get(key);\n\t}\n\n\t/** Populates the cache directly, bypassing the resolver. Used by callers that already know the\n\t *  value (e.g. event payloads, post-write reconciles) and want subsequent reads to hit. */\n\tset(key: K, value: V): void {\n\t\tthis._resolved.set(key, value);\n\t}\n\n\t/** Removes both the settled value and any in-flight Promise for `key`. */\n\tdelete(key: K): void {\n\t\tthis._resolved.delete(key);\n\t\tthis._resolving.delete(key);\n\t}\n\n\t/** Clears everything — both settled values and in-flight Promises. */\n\tclear(): void {\n\t\tthis._resolved.clear();\n\t\tthis._resolving.clear();\n\t}\n\n\t/**\n\t * Returns the cached value for `key`, invoking `resolver` only on a cache miss. Concurrent\n\t * cache-miss callers for the same key share the same in-flight Promise — `resolver` is invoked\n\t * exactly once per cache fill. If `resolver` rejects, the entry is removed so subsequent calls\n\t * retry rather than receiving a permanently cached failure.\n\t */\n\tgetOrResolve(key: K, resolver: () => Promise<V>): Promise<V> {\n\t\tif (this._resolved.has(key)) {\n\t\t\t// Map.get returns `V | undefined`; `has` confirmed presence, so the value (even if it\n\t\t\t// is `undefined` by intent) is the cached one. Cast pins the return type.\n\t\t\treturn Promise.resolve(this._resolved.get(key) as V);\n\t\t}\n\n\t\tconst existing = this._resolving.get(key);\n\t\tif (existing != null) return existing;\n\n\t\tconst pending = resolver()\n\t\t\t.then(value => {\n\t\t\t\tthis._resolved.set(key, value);\n\t\t\t\treturn value;\n\t\t\t})\n\t\t\t.finally(() => {\n\t\t\t\tthis._resolving.delete(key);\n\t\t\t});\n\t\tthis._resolving.set(key, pending);\n\t\treturn pending;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,IAAa,oBAAb,MAAqC;CACpC,4BAA6B,IAAI,IAAU;CAC3C,6BAA8B,IAAI,IAAmB;;CAGrD,IAAI,KAAiB;EACpB,OAAO,KAAK,UAAU,IAAI,GAAG;CAC9B;;;CAIA,IAAI,KAAuB;EAC1B,OAAO,KAAK,UAAU,IAAI,GAAG;CAC9B;;;CAIA,IAAI,KAAQ,OAAgB;EAC3B,KAAK,UAAU,IAAI,KAAK,KAAK;CAC9B;;CAGA,OAAO,KAAc;EACpB,KAAK,UAAU,OAAO,GAAG;EACzB,KAAK,WAAW,OAAO,GAAG;CAC3B;;CAGA,QAAc;EACb,KAAK,UAAU,MAAM;EACrB,KAAK,WAAW,MAAM;CACvB;;;;;;;CAQA,aAAa,KAAQ,UAAwC;EAC5D,IAAI,KAAK,UAAU,IAAI,GAAG,GAGzB,OAAO,QAAQ,QAAQ,KAAK,UAAU,IAAI,GAAG,CAAM;EAGpD,MAAM,WAAW,KAAK,WAAW,IAAI,GAAG;EACxC,IAAI,YAAY,MAAM,OAAO;EAE7B,MAAM,UAAU,SAAS,CAAC,CACxB,MAAK,UAAS;GACd,KAAK,UAAU,IAAI,KAAK,KAAK;GAC7B,OAAO;EACR,CAAC,CAAC,CACD,cAAc;GACd,KAAK,WAAW,OAAO,GAAG;EAC3B,CAAC;EACF,KAAK,WAAW,IAAI,KAAK,OAAO;EAChC,OAAO;CACR;AACD"}

package/dist/utils/diff.d.ts

@@ -1,2 +1,4 @@
+//#region ../utils/src/diff.d.ts
 export declare function annotateDiffWithNewLineNumbers(diff: string): string;
+//#endregion
 //# sourceMappingURL=diff.d.ts.map

package/dist/utils/diff.js

@@ -1,53 +1,43 @@
-// Annotates diff to make is easier for agentic reference to line number.
-// Brackets sit AFTER the line-type marker so file-level diff parsers
-// (e.g. `filterDiffFiles`) that key off `diff --git` / `+++` / `---` headers still work.
-export function annotateDiffWithNewLineNumbers(diff) {
-    if (!diff)
-        return diff;
-    const lines = diff.split('\n');
-    const out = new Array(lines.length);
-    let newLine = 0;
-    let inHunk = false;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.startsWith('@@')) {
-            const match = /\+(\d+)(?:,\d+)?\s/.exec(line);
-            newLine = match != null ? parseInt(match[1], 10) : 0;
-            inHunk = true;
-            out[i] = line;
-            continue;
-        }
-        if (line.startsWith('diff --git') ||
-            line.startsWith('index ') ||
-            line.startsWith('--- ') ||
-            line.startsWith('+++ ') ||
-            line.startsWith('new file') ||
-            line.startsWith('deleted file') ||
-            line.startsWith('rename ') ||
-            line.startsWith('copy ') ||
-            line.startsWith('similarity ') ||
-            line.startsWith('dissimilarity ') ||
-            line.startsWith('Binary files')) {
-            inHunk = false;
-            out[i] = line;
-            continue;
-        }
-        if (!inHunk || line.startsWith('\\')) {
-            out[i] = line;
-            continue;
-        }
-        const marker = line[0];
-        if (marker === '-') {
-            out[i] = `-[     ]${line.slice(1)}`;
-            continue;
-        }
-        if (marker === '+' || marker === ' ') {
-            out[i] = `${marker}[${String(newLine).padStart(5, ' ')}]${line.slice(1)}`;
-            newLine++;
-            continue;
-        }
-        out[i] = line;
-    }
-    return out.join('\n');
+//#region ../utils/src/diff.ts
+function annotateDiffWithNewLineNumbers(diff) {
+	if (!diff) return diff;
+	const lines = diff.split("\n");
+	const out = new Array(lines.length);
+	let newLine = 0;
+	let inHunk = false;
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i];
+		if (line.startsWith("@@")) {
+			const match = /\+(\d+)(?:,\d+)?\s/.exec(line);
+			newLine = match != null ? parseInt(match[1], 10) : 0;
+			inHunk = true;
+			out[i] = line;
+			continue;
+		}
+		if (line.startsWith("diff --git") || line.startsWith("index ") || line.startsWith("--- ") || line.startsWith("+++ ") || line.startsWith("new file") || line.startsWith("deleted file") || line.startsWith("rename ") || line.startsWith("copy ") || line.startsWith("similarity ") || line.startsWith("dissimilarity ") || line.startsWith("Binary files")) {
+			inHunk = false;
+			out[i] = line;
+			continue;
+		}
+		if (!inHunk || line.startsWith("\\")) {
+			out[i] = line;
+			continue;
+		}
+		const marker = line[0];
+		if (marker === "-") {
+			out[i] = `-[     ]${line.slice(1)}`;
+			continue;
+		}
+		if (marker === "+" || marker === " ") {
+			out[i] = `${marker}[${String(newLine).padStart(5, " ")}]${line.slice(1)}`;
+			newLine++;
+			continue;
+		}
+		out[i] = line;
+	}
+	return out.join("\n");
 }
+//#endregion
+export { annotateDiffWithNewLineNumbers };
+
 //# sourceMappingURL=diff.js.map

package/dist/utils/diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qEAAqE;AACrE,yFAAyF;AACzF,MAAM,UAAU,8BAA8B,CAAC,IAAY;IAC1D,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAa,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,GAAG,IAAI,CAAC;YACd,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACd,SAAS;QACV,CAAC;QAED,IACC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YACxB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;YAC9B,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAC9B,CAAC;YACF,MAAM,GAAG,KAAK,CAAC;YACf,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACd,SAAS;QACV,CAAC;QAED,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACd,SAAS;QACV,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACpB,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,SAAS;QACV,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACtC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,OAAO,EAAE,CAAC;YACV,SAAS;QACV,CAAC;QAED,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACf,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"diff.js","names":[],"sources":["../../../utils/src/diff.ts"],"sourcesContent":["// Annotates diff to make is easier for agentic reference to line number.\n// Brackets sit AFTER the line-type marker so file-level diff parsers\n// (e.g. `filterDiffFiles`) that key off `diff --git` / `+++` / `---` headers still work.\nexport function annotateDiffWithNewLineNumbers(diff: string): string {\n\tif (!diff) return diff;\n\n\tconst lines = diff.split('\\n');\n\tconst out: string[] = new Array(lines.length);\n\tlet newLine = 0;\n\tlet inHunk = false;\n\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tconst line = lines[i];\n\n\t\tif (line.startsWith('@@')) {\n\t\t\tconst match = /\\+(\\d+)(?:,\\d+)?\\s/.exec(line);\n\t\t\tnewLine = match != null ? parseInt(match[1], 10) : 0;\n\t\t\tinHunk = true;\n\t\t\tout[i] = line;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (\n\t\t\tline.startsWith('diff --git') ||\n\t\t\tline.startsWith('index ') ||\n\t\t\tline.startsWith('--- ') ||\n\t\t\tline.startsWith('+++ ') ||\n\t\t\tline.startsWith('new file') ||\n\t\t\tline.startsWith('deleted file') ||\n\t\t\tline.startsWith('rename ') ||\n\t\t\tline.startsWith('copy ') ||\n\t\t\tline.startsWith('similarity ') ||\n\t\t\tline.startsWith('dissimilarity ') ||\n\t\t\tline.startsWith('Binary files')\n\t\t) {\n\t\t\tinHunk = false;\n\t\t\tout[i] = line;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (!inHunk || line.startsWith('\\\\')) {\n\t\t\tout[i] = line;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst marker = line[0];\n\t\tif (marker === '-') {\n\t\t\tout[i] = `-[     ]${line.slice(1)}`;\n\t\t\tcontinue;\n\t\t}\n\t\tif (marker === '+' || marker === ' ') {\n\t\t\tout[i] = `${marker}[${String(newLine).padStart(5, ' ')}]${line.slice(1)}`;\n\t\t\tnewLine++;\n\t\t\tcontinue;\n\t\t}\n\n\t\tout[i] = line;\n\t}\n\n\treturn out.join('\\n');\n}\n"],"mappings":";AAGA,SAAgB,+BAA+B,MAAsB;CACpE,IAAI,CAAC,MAAM,OAAO;CAElB,MAAM,QAAQ,KAAK,MAAM,IAAI;CAC7B,MAAM,MAAgB,IAAI,MAAM,MAAM,MAAM;CAC5C,IAAI,UAAU;CACd,IAAI,SAAS;CAEb,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACtC,MAAM,OAAO,MAAM;EAEnB,IAAI,KAAK,WAAW,IAAI,GAAG;GAC1B,MAAM,QAAQ,qBAAqB,KAAK,IAAI;GAC5C,UAAU,SAAS,OAAO,SAAS,MAAM,IAAI,EAAE,IAAI;GACnD,SAAS;GACT,IAAI,KAAK;GACT;EACD;EAEA,IACC,KAAK,WAAW,YAAY,KAC5B,KAAK,WAAW,QAAQ,KACxB,KAAK,WAAW,MAAM,KACtB,KAAK,WAAW,MAAM,KACtB,KAAK,WAAW,UAAU,KAC1B,KAAK,WAAW,cAAc,KAC9B,KAAK,WAAW,SAAS,KACzB,KAAK,WAAW,OAAO,KACvB,KAAK,WAAW,aAAa,KAC7B,KAAK,WAAW,gBAAgB,KAChC,KAAK,WAAW,cAAc,GAC7B;GACD,SAAS;GACT,IAAI,KAAK;GACT;EACD;EAEA,IAAI,CAAC,UAAU,KAAK,WAAW,IAAI,GAAG;GACrC,IAAI,KAAK;GACT;EACD;EAEA,MAAM,SAAS,KAAK;EACpB,IAAI,WAAW,KAAK;GACnB,IAAI,KAAK,WAAW,KAAK,MAAM,CAAC;GAChC;EACD;EACA,IAAI,WAAW,OAAO,WAAW,KAAK;GACrC,IAAI,KAAK,GAAG,OAAO,GAAG,OAAO,OAAO,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;GACtE;GACA;EACD;EAEA,IAAI,KAAK;CACV;CAEA,OAAO,IAAI,KAAK,IAAI;AACrB"}

package/dist/utils/disposable.d.ts

@@ -1,3 +1,4 @@
+//#region ../utils/src/disposable.d.ts
 /**
  * Minimal disposable contract — a single `dispose(): void` method.
  *
@@ -9,45 +10,46 @@
  * (`Symbol.dispose`) protocol; everything else can stay on this looser type.
  */
 export type Disposable = {
-    dispose: () => void;
+  dispose: () => void;
 };
 export type UnifiedDisposable = {
-    dispose: () => void;
+  dispose: () => void;
 } & globalThis.Disposable;
 export type UnifiedAsyncDisposable = {
-    dispose: () => Promise<void>;
+  dispose: () => Promise<void>;
 } & AsyncDisposable;
 export declare function createDisposable(dispose: () => void, options?: {
-    once?: boolean;
+  once?: boolean;
 }): UnifiedDisposable;
 export declare function createDisposable(dispose: (() => void) | undefined, options?: {
-    once?: boolean;
+  once?: boolean;
 }): UnifiedDisposable | undefined;
 export declare function createAsyncDisposable(dispose: () => Promise<any>, options?: {
-    once?: boolean;
+  once?: boolean;
 }): UnifiedAsyncDisposable;
 export declare function disposableInterval(fn: (...args: any[]) => void, ms: number): UnifiedDisposable;
 export declare function fromDisposables(...disposables: (UnifiedDisposable | globalThis.Disposable | {
-    dispose: () => void;
+  dispose: () => void;
 } | undefined)[]): UnifiedDisposable;
 /** Returns the existing object with disposable methods added */
 export declare function mixinDisposable<T extends {
-    dispose: () => void;
+  dispose: () => void;
 }>(disposable: T): T & UnifiedDisposable;
 export declare function mixinDisposable<T extends {
-    dispose: () => void;
+  dispose: () => void;
 } | undefined>(disposable: T): (T & UnifiedDisposable) | undefined;
 export declare function mixinDisposable<T extends object & {
-    dispose?: never;
+  dispose?: never;
 }>(obj: T, dispose: () => void): T & UnifiedDisposable;
 /** Returns the existing object with async disposable methods added */
 export declare function mixinAsyncDisposable<T extends {
-    dispose: () => Promise<any>;
+  dispose: () => Promise<any>;
 }>(disposable: T): T & UnifiedAsyncDisposable;
 export declare function mixinAsyncDisposable<T extends {
-    dispose: () => Promise<any>;
+  dispose: () => Promise<any>;
 } | undefined>(disposable: T): (T & UnifiedAsyncDisposable) | undefined;
 export declare function mixinAsyncDisposable<T extends object & {
-    dispose?: never;
+  dispose?: never;
 }>(obj: T, dispose: () => Promise<any>): T & UnifiedAsyncDisposable;
+//#endregion
 //# sourceMappingURL=disposable.d.ts.map

package/dist/utils/disposable.js

@@ -1,87 +1,78 @@
-import { once } from './function.js';
-export function createDisposable(dispose, options) {
-    if (dispose == null)
-        return undefined;
-    if (options?.once) {
-        dispose = once(dispose);
-    }
-    return {
-        dispose: dispose,
-        [Symbol.dispose]: dispose,
-    };
+import { once } from "./function.js";
+//#region ../utils/src/disposable.ts
+function createDisposable(dispose, options) {
+	if (dispose == null) return void 0;
+	if (options?.once) dispose = once(dispose);
+	return {
+		dispose,
+		[Symbol.dispose]: dispose
+	};
 }
-export function createAsyncDisposable(dispose, options) {
-    if (options?.once) {
-        dispose = once(dispose);
-    }
-    return {
-        dispose: dispose,
-        [Symbol.asyncDispose]: dispose,
-    };
+function createAsyncDisposable(dispose, options) {
+	if (options?.once) dispose = once(dispose);
+	return {
+		dispose,
+		[Symbol.asyncDispose]: dispose
+	};
 }
-export function disposableInterval(fn, ms) {
-    let timer;
-    const dispose = () => {
-        if (timer != null) {
-            clearInterval(timer);
-            timer = undefined;
-        }
-    };
-    const disposable = {
-        [Symbol.dispose]: dispose,
-        dispose: dispose,
-    };
-    timer = setInterval(fn, ms);
-    return disposable;
+function disposableInterval(fn, ms) {
+	let timer;
+	const dispose = () => {
+		if (timer != null) {
+			clearInterval(timer);
+			timer = void 0;
+		}
+	};
+	const disposable = {
+		[Symbol.dispose]: dispose,
+		dispose
+	};
+	timer = setInterval(fn, ms);
+	return disposable;
 }
-export function fromDisposables(...disposables) {
-    let disposed = false;
-    const dispose = () => {
-        if (disposed)
-            return;
-        disposed = true;
-        for (const d of disposables) {
-            if (d == null)
-                continue;
-            if ('dispose' in d) {
-                d.dispose();
-            }
-            else {
-                d[Symbol.dispose]?.();
-            }
-        }
-    };
-    return {
-        dispose: dispose,
-        [Symbol.dispose]: dispose,
-    };
+function fromDisposables(...disposables) {
+	let disposed = false;
+	const dispose = () => {
+		if (disposed) return;
+		disposed = true;
+		for (const d of disposables) {
+			if (d == null) continue;
+			if ("dispose" in d) d.dispose();
+			else d[Symbol.dispose]?.();
+		}
+	};
+	return {
+		dispose,
+		[Symbol.dispose]: dispose
+	};
 }
-export function mixinDisposable(obj, dispose) {
-    if (obj == null)
-        return undefined;
-    if (dispose != null) {
-        obj.dispose = dispose;
-        obj[Symbol.dispose] = dispose;
-        return obj;
-    }
-    if ('dispose' in obj && obj.dispose != null) {
-        obj[Symbol.dispose] = obj.dispose;
-        return obj;
-    }
-    throw new Error('Object does not have a dispose method or a dispose function was not provided');
+function mixinDisposable(obj, dispose) {
+	if (obj == null) return void 0;
+	if (dispose != null) {
+		obj.dispose = dispose;
+		obj[Symbol.dispose] = dispose;
+		return obj;
+	}
+	if ("dispose" in obj && obj.dispose != null) {
+		obj[Symbol.dispose] = obj.dispose;
+		return obj;
+	}
+	throw new Error("Object does not have a dispose method or a dispose function was not provided");
 }
-export function mixinAsyncDisposable(obj, dispose) {
-    if (obj == null)
-        return undefined;
-    if (dispose != null) {
-        obj.dispose = dispose;
-        obj[Symbol.asyncDispose] = dispose;
-        return obj;
-    }
-    if ('dispose' in obj && obj.dispose != null) {
-        obj[Symbol.asyncDispose] = obj.dispose;
-        return obj;
-    }
-    throw new Error('Object does not have a dispose method or a dispose function was not provided');
+function mixinAsyncDisposable(obj, dispose) {
+	if (obj == null) return void 0;
+	if (dispose != null) {
+		obj.dispose = dispose;
+		obj[Symbol.asyncDispose] = dispose;
+		return obj;
+	}
+	if ("dispose" in obj && obj.dispose != null) {
+		obj[Symbol.asyncDispose] = obj.dispose;
+		return obj;
+	}
+	throw new Error("Object does not have a dispose method or a dispose function was not provided");
 }
+//#endregion
+export { createAsyncDisposable, createDisposable, disposableInterval, fromDisposables, mixinAsyncDisposable, mixinDisposable };
+
 //# sourceMappingURL=disposable.js.map

package/dist/utils/disposable.js.map

@@ -1 +1 @@
-{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../../src/utils/disposable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"disposable.js","names":[],"sources":["../../../utils/src/disposable.ts"],"sourcesContent":["import { once } from './function.js';\n\n/**\n * Minimal disposable contract — a single `dispose(): void` method.\n *\n * Mirrors the shape of `vscode.Disposable` so vscode-free packages can name\n * the contract without requiring lib.es2022's `[Symbol.dispose]`. Classes that\n * already implement `dispose()` (the vscode-style) satisfy it without changes.\n *\n * Use {@link UnifiedDisposable} when you also need the `using`-statement\n * (`Symbol.dispose`) protocol; everything else can stay on this looser type.\n */\n\nexport type Disposable = { dispose: () => void };\n\nexport type UnifiedDisposable = { dispose: () => void } & globalThis.Disposable;\nexport type UnifiedAsyncDisposable = { dispose: () => Promise<void> } & AsyncDisposable;\n\nexport function createDisposable(dispose: () => void, options?: { once?: boolean }): UnifiedDisposable;\nexport function createDisposable(\n\tdispose: (() => void) | undefined,\n\toptions?: { once?: boolean },\n): UnifiedDisposable | undefined;\nexport function createDisposable(\n\tdispose?: (() => void) | undefined,\n\toptions?: { once?: boolean },\n): UnifiedDisposable | undefined {\n\tif (dispose == null) return undefined;\n\n\tif (options?.once) {\n\t\tdispose = once(dispose);\n\t}\n\n\treturn {\n\t\tdispose: dispose,\n\t\t[Symbol.dispose]: dispose,\n\t};\n}\n\nexport function createAsyncDisposable(\n\tdispose: () => Promise<any>,\n\toptions?: { once?: boolean },\n): UnifiedAsyncDisposable {\n\tif (options?.once) {\n\t\tdispose = once(dispose);\n\t}\n\n\treturn {\n\t\tdispose: dispose,\n\t\t[Symbol.asyncDispose]: dispose,\n\t};\n}\n\nexport function disposableInterval(fn: (...args: any[]) => void, ms: number): UnifiedDisposable {\n\tlet timer: ReturnType<typeof setInterval> | undefined;\n\tconst dispose = () => {\n\t\tif (timer != null) {\n\t\t\tclearInterval(timer);\n\t\t\ttimer = undefined;\n\t\t}\n\t};\n\n\tconst disposable = {\n\t\t[Symbol.dispose]: dispose,\n\t\tdispose: dispose,\n\t};\n\ttimer = setInterval(fn, ms);\n\n\treturn disposable;\n}\n\nexport function fromDisposables(\n\t...disposables: (UnifiedDisposable | globalThis.Disposable | { dispose: () => void } | undefined)[]\n): UnifiedDisposable {\n\tlet disposed = false;\n\tconst dispose = () => {\n\t\tif (disposed) return;\n\n\t\tdisposed = true;\n\n\t\tfor (const d of disposables) {\n\t\t\tif (d == null) continue;\n\n\t\t\tif ('dispose' in d) {\n\t\t\t\td.dispose();\n\t\t\t} else {\n\t\t\t\td[Symbol.dispose]?.();\n\t\t\t}\n\t\t}\n\t};\n\n\treturn {\n\t\tdispose: dispose,\n\t\t[Symbol.dispose]: dispose,\n\t};\n}\n\n/** Returns the existing object with disposable methods added */\nexport function mixinDisposable<T extends { dispose: () => void }>(disposable: T): T & UnifiedDisposable;\nexport function mixinDisposable<T extends { dispose: () => void } | undefined>(\n\tdisposable: T,\n): (T & UnifiedDisposable) | undefined;\nexport function mixinDisposable<T extends object & { dispose?: never }>(\n\tobj: T,\n\tdispose: () => void,\n): T & UnifiedDisposable;\nexport function mixinDisposable<T extends (object & { dispose?: never }) | { dispose: () => void }>(\n\tobj: T,\n\tdispose?: () => void,\n): (T & UnifiedDisposable) | undefined {\n\tif (obj == null) return undefined;\n\n\tif (dispose != null) {\n\t\t(obj as any).dispose = dispose;\n\t\t(obj as any)[Symbol.dispose] = dispose;\n\t\treturn obj as T & UnifiedDisposable;\n\t}\n\n\tif ('dispose' in obj && obj.dispose != null) {\n\t\t(obj as any)[Symbol.dispose] = obj.dispose;\n\t\treturn obj as T & UnifiedDisposable;\n\t}\n\n\tthrow new Error('Object does not have a dispose method or a dispose function was not provided');\n}\n\n/** Returns the existing object with async disposable methods added */\nexport function mixinAsyncDisposable<T extends { dispose: () => Promise<any> }>(\n\tdisposable: T,\n): T & UnifiedAsyncDisposable;\nexport function mixinAsyncDisposable<T extends { dispose: () => Promise<any> } | undefined>(\n\tdisposable: T,\n): (T & UnifiedAsyncDisposable) | undefined;\nexport function mixinAsyncDisposable<T extends object & { dispose?: never }>(\n\tobj: T,\n\tdispose: () => Promise<any>,\n): T & UnifiedAsyncDisposable;\nexport function mixinAsyncDisposable<T extends (object & { dispose?: never }) | { dispose: () => Promise<any> }>(\n\tobj: T,\n\tdispose?: () => Promise<any>,\n): (T & UnifiedAsyncDisposable) | undefined {\n\tif (obj == null) return undefined;\n\n\tif (dispose != null) {\n\t\t(obj as any).dispose = dispose;\n\t\t(obj as any)[Symbol.asyncDispose] = dispose;\n\t\treturn obj as T & UnifiedAsyncDisposable;\n\t}\n\n\tif ('dispose' in obj && obj.dispose != null) {\n\t\t(obj as any)[Symbol.asyncDispose] = obj.dispose;\n\t\treturn obj as T & UnifiedAsyncDisposable;\n\t}\n\n\tthrow new Error('Object does not have a dispose method or a dispose function was not provided');\n}\n"],"mappings":";;AAuBA,SAAgB,iBACf,SACA,SACgC;CAChC,IAAI,WAAW,MAAM,OAAO,KAAA;CAE5B,IAAI,SAAS,MACZ,UAAU,KAAK,OAAO;CAGvB,OAAO;EACG;GACR,OAAO,UAAU;CACnB;AACD;AAEA,SAAgB,sBACf,SACA,SACyB;CACzB,IAAI,SAAS,MACZ,UAAU,KAAK,OAAO;CAGvB,OAAO;EACG;GACR,OAAO,eAAe;CACxB;AACD;AAEA,SAAgB,mBAAmB,IAA8B,IAA+B;CAC/F,IAAI;CACJ,MAAM,gBAAgB;EACrB,IAAI,SAAS,MAAM;GAClB,cAAc,KAAK;GACnB,QAAQ,KAAA;EACT;CACD;CAEA,MAAM,aAAa;GACjB,OAAO,UAAU;EACT;CACV;CACA,QAAQ,YAAY,IAAI,EAAE;CAE1B,OAAO;AACR;AAEA,SAAgB,gBACf,GAAG,aACiB;CACpB,IAAI,WAAW;CACf,MAAM,gBAAgB;EACrB,IAAI,UAAU;EAEd,WAAW;EAEX,KAAK,MAAM,KAAK,aAAa;GAC5B,IAAI,KAAK,MAAM;GAEf,IAAI,aAAa,GAChB,EAAE,QAAQ;QAEV,EAAE,OAAO,QAAQ,GAAG;EAEtB;CACD;CAEA,OAAO;EACG;GACR,OAAO,UAAU;CACnB;AACD;AAWA,SAAgB,gBACf,KACA,SACsC;CACtC,IAAI,OAAO,MAAM,OAAO,KAAA;CAExB,IAAI,WAAW,MAAM;EACpB,IAAa,UAAU;EACvB,IAAa,OAAO,WAAW;EAC/B,OAAO;CACR;CAEA,IAAI,aAAa,OAAO,IAAI,WAAW,MAAM;EAC5C,IAAa,OAAO,WAAW,IAAI;EACnC,OAAO;CACR;CAEA,MAAM,IAAI,MAAM,8EAA8E;AAC/F;AAaA,SAAgB,qBACf,KACA,SAC2C;CAC3C,IAAI,OAAO,MAAM,OAAO,KAAA;CAExB,IAAI,WAAW,MAAM;EACpB,IAAa,UAAU;EACvB,IAAa,OAAO,gBAAgB;EACpC,OAAO;CACR;CAEA,IAAI,aAAa,OAAO,IAAI,WAAW,MAAM;EAC5C,IAAa,OAAO,gBAAgB,IAAI;EACxC,OAAO;CACR;CAEA,MAAM,IAAI,MAAM,8EAA8E;AAC/F"}

package/dist/utils/dom.d.ts

@@ -0,0 +1,45 @@
+import { Disposable } from "./disposable.js";
+//#region ../utils/src/dom.d.ts
+export declare namespace DOM {
+  function on<K extends keyof WindowEventMap>(window: Window, name: K, listener: (e: WindowEventMap[K], target: Window) => void, options?: boolean | AddEventListenerOptions): Disposable;
+  function on<K extends keyof DocumentEventMap>(document: Document, name: K, listener: (e: DocumentEventMap[K], target: Document) => void, options?: boolean | AddEventListenerOptions): Disposable;
+  function on<T extends HTMLElement, K extends keyof DocumentEventMap>(element: T, name: K, listener: (e: DocumentEventMap[K] & {
+    target: HTMLElement | null;
+  }, target: T) => void, options?: boolean | AddEventListenerOptions): Disposable;
+  function on<T extends HTMLElement, K>(element: T, name: string, listener: (e: CustomEvent<K> & {
+    target: HTMLElement | null;
+  }, target: T) => void, options?: boolean | AddEventListenerOptions): Disposable;
+  function on<T extends Element, K extends keyof DocumentEventMap>(selector: string, name: K, listener: (e: DocumentEventMap[K] & {
+    target: HTMLElement | null;
+  }, target: T) => void, options?: boolean | AddEventListenerOptions): Disposable;
+  function on<T extends HTMLElement, K>(selector: string, name: string, listener: (e: CustomEvent<K> & {
+    target: HTMLElement | null;
+  }, target: T) => void, options?: boolean | AddEventListenerOptions): Disposable;
+}
+/**
+ * Opens the host context menu for `target` as if it had been right-clicked at its bottom-left corner
+ * — the affordance behind "kebab" buttons that surface a row's normal context menu.
+ *
+ * `composed` is required so the event escapes the component's shadow root and reaches the document
+ * listener that the host's menu is wired to.
+ */
+export declare function dispatchContextMenuAt(target: HTMLElement): void;
+/**
+ * Whether an event originated in a text-entry surface — the guard an app-level single-key shortcut
+ * (e.g. the Commit Graph's `/`) needs so it never swallows a keystroke meant for typing.
+ *
+ * Walks the COMPOSED path rather than reading `event.target`, because a `document`-level listener sees
+ * the target retargeted to the outermost shadow host — for the commit search box that's
+ * `<gl-search-box>`, two shadow roots above the `<input>`.
+ *
+ * Checkbox and radio `<input>`s don't count: `gl-checkbox` / `gl-radio` delegate focus into a real
+ * `<input>`, and a shortcut should still fire while one of those holds focus. Unrecognized input types
+ * DO count, so a new text-ish type errs toward keeping the keystroke.
+ */
+export declare function isTextEntryTarget(event: Event): boolean;
+/** Parses a CSS duration and returns the number of milliseconds. */
+export declare function parseDuration(delay: number | string): number;
+/** Waits for a specific event to be emitted from an element. Ignores events that bubble up from child elements. */
+export declare function waitForEvent(el: HTMLElement, eventName: string): Promise<void>;
+//#endregion
+//# sourceMappingURL=dom.d.ts.map