@orkestrel/workspace 0.0.12 → 0.0.14

package/dist/src/core/index.js

@@ -1,7 +1,7 @@
-import { arrayOf, holds, isArray, isInstance, isNumber, isRecord, isString, literalOf, rawShape, stringShape } from "@orkestrel/contract";
+import { INTRINSICS, arrayOf, escapeRegExp, holds, isArray, isFunction, isNumber, isObject, isRecord, isString, literalOf, rawShape, stringShape } from "@orkestrel/contract";
 import { createDatabase, createMemoryDriver } from "@orkestrel/database";
 import { Emitter } from "@orkestrel/emitter";
-//#region src/core/constants.ts
+// src/core/constants.ts
 /**
 * Maps file extensions to language tags for text content.
 *
@@ -50,8 +50,7 @@ var EXTENSION_LANGUAGES = Object.freeze({
 	svg: "xml",
 	txt: "text"
 });
-//#endregion
-//#region src/core/errors.ts
+// src/core/errors.ts
 /**
 * Reports an invalid workspace edit or search operation, carrying a {@link WorkspaceErrorCode}
 * and, when the operation had one, the context it ran under.
@@ -68,6 +67,7 @@ var WorkspaceError = class extends Error {
 	*/
 	constructor(code, message, context) {
 		super(message);
+		INTRINSICS.define(this, Symbol.for("@orkestrel/workspace.WorkspaceError"), { value: this });
 		this.name = "WorkspaceError";
 		this.code = code;
 		if (context !== void 0) this.context = context;
@@ -77,8 +77,8 @@ var WorkspaceError = class extends Error {
 * Narrows a caught value to a {@link WorkspaceError}.
 *
 * @remarks
-* The check is one `instanceof` test, so it stays total: every input answers `true` or `false`
-* and none throws.
+* Checks the identity brand and declared members across package copies, accepting subclasses
+* and refusing transparent proxies. Inspection failures return false.
 *
 * @param value - The caught value
 * @returns True if the value is a workspace error; false otherwise
@@ -89,10 +89,16 @@ var WorkspaceError = class extends Error {
 * ```
 */
 function isWorkspaceError(value) {
-	return isInstance(value, WorkspaceError);
+	return holds(() => {
+		if (!(value instanceof Error) || INTRINSICS.prototype(value) === Error.prototype) return false;
+		if (INTRINSICS.describe(value, Symbol.for("@orkestrel/workspace.WorkspaceError"))?.value !== value) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (code !== "MISSING" && code !== "MODALITY" && code !== "PATTERN" && code !== "RANGE") return false;
+		const context = INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || isObject(context) || isFunction(context);
+	});
 }
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Infers a language tag from the final file extension.
 *
@@ -117,10 +123,10 @@ function inferLanguage(path) {
 *
 * @example
 * ```ts
-* isText({ text: 'hello', language: 'text' }) // true
+* isTextContent({ text: 'hello', language: 'text' }) // true
 * ```
 */
-function isText(content) {
+function isTextContent(content) {
 	return "text" in content;
 }
 /**
@@ -149,7 +155,7 @@ function isBinary(content) {
 * ```
 */
 function computeSize(content) {
-	if (isText(content)) return new TextEncoder().encode(content.text).length;
+	if (isTextContent(content)) return new TextEncoder().encode(content.text).length;
 	return computeDecodedSize(content.base64);
 }
 /**
@@ -164,11 +170,9 @@ function computeSize(content) {
 * ```
 */
 function countLines(content) {
-	if (!isText(content)) return 0;
+	if (!isTextContent(content)) return 0;
 	if (content.text.length === 0) return 0;
-	let count = 1;
-	for (const character of content.text) if (character === "\n") count += 1;
-	return count;
+	return content.text.split(/\r\n|\n/).length;
 }
 /**
 * Computes the decoded byte length of a base64 string, arithmetically rather than by decoding it.
@@ -182,16 +186,14 @@ function countLines(content) {
 * ```
 */
 function computeDecodedSize(base64) {
-	let padding = 0;
-	if (base64.endsWith("==")) padding = 2;
-	else if (base64.endsWith("=")) padding = 1;
+	const padding = base64.endsWith("==") ? 2 : base64.endsWith("=") ? 1 : 0;
 	return Math.floor(base64.length * 3 / 4) - padding;
 }
 /**
 * Determines whether a 1-based range is structurally valid.
 *
 * @param range - The range to inspect
-* @returns True if both positions are positive and ordered; false otherwise
+* @returns True if both carets are positive and ordered; false otherwise
 *
 * @example
 * ```ts
@@ -205,28 +207,28 @@ function isValidRange(range) {
 	return !(range.start.line === range.end.line && range.start.column > range.end.column);
 }
 /**
-* Clamps a position to text bounds.
+* Clamps a caret to text bounds.
 *
 * @param text - The addressed text
-* @param position - The requested position
-* @returns The clamped position
+* @param caret - The requested caret
+* @returns The clamped caret
 *
 * @example
 * ```ts
-* clampPosition('ab', { line: 9, column: 9 }) // { line: 1, column: 3 }
+* clampCaret('ab', { line: 9, column: 9 }) // { line: 1, column: 3 }
 * ```
 */
-function clampPosition(text, position) {
+function clampCaret(text, caret) {
 	const lines = text.split("\n");
-	const line = Math.max(1, Math.min(position.line, lines.length));
+	const line = Math.max(1, Math.min(caret.line, lines.length));
 	const lineText = lines[line - 1] ?? "";
 	return {
 		line,
-		column: Math.max(1, Math.min(position.column, lineText.length + 1))
+		column: Math.max(1, Math.min(caret.column, lineText.length + 1))
 	};
 }
 /**
-* Clamps both positions in a range to text bounds.
+* Clamps both carets in a range to text bounds.
 *
 * @param text - The addressed text
 * @param range - The requested range
@@ -239,15 +241,15 @@ function clampPosition(text, position) {
 */
 function clampRange(text, range) {
 	return {
-		start: clampPosition(text, range.start),
-		end: clampPosition(text, range.end)
+		start: clampCaret(text, range.start),
+		end: clampCaret(text, range.end)
 	};
 }
 /**
-* Converts a 1-based position to a zero-based string offset.
+* Converts a 1-based caret to a zero-based string offset.
 *
 * @param text - The addressed text
-* @param position - The requested position
+* @param caret - The requested caret
 * @returns The bounded string offset
 *
 * @example
@@ -255,12 +257,9 @@ function clampRange(text, range) {
 * offsetAt('ab\ncd', { line: 2, column: 1 }) // 3
 * ```
 */
-function offsetAt(text, position) {
-	const lines = text.split("\n");
-	let offset = 0;
-	for (let index = 0; index < position.line - 1 && index < lines.length; index += 1) offset += (lines[index]?.length ?? 0) + 1;
-	offset += position.column - 1;
-	return Math.min(offset, text.length);
+function offsetAt(text, caret) {
+	const offset = text.split("\n").filter((_, index) => index < caret.line - 1).reduce((total, line) => total + line.length + 1, 0);
+	return Math.min(offset + (caret.column - 1), text.length);
 }
 /**
 * Slices a clamped half-open text range.
@@ -323,22 +322,7 @@ function rangeOf(fromLine, fromColumn, toLine, toColumn) {
 		}
 	};
 }
-/**
-* Escapes regular-expression metacharacters for literal matching.
-*
-* @param value - The literal text
-* @returns The escaped regular-expression source
-*
-* @example
-* ```ts
-* escapeRegExp('a.b') // 'a\\.b'
-* ```
-*/
-function escapeRegExp(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-//#endregion
-//#region src/core/validators.ts
+// src/core/validators.ts
 /**
 * Narrows an unknown value to an immutable file record.
 *
@@ -375,8 +359,7 @@ function isFile(value) {
 function isWorkspaceSnapshot(value) {
 	return holds(() => isRecord(value) && isString(value.id) && arrayOf(isFile)(value.files));
 }
-//#endregion
-//#region src/core/workspaces/Workspace.ts
+// src/core/workspaces/Workspace.ts
 /**
 * Implements `WorkspaceInterface` over one insertion-ordered path map the instance owns,
 * projecting fresh arrays on every read.
@@ -432,14 +415,14 @@ var Workspace = class {
 			const result = {};
 			for (const one of path) {
 				const file = this.#files.get(one);
-				if (file && isText(file.content)) result[one] = file.content.text;
+				if (file && isTextContent(file.content)) result[one] = file.content.text;
 			}
 			return result;
 		}
 		const file = this.#files.get(path);
 		if (!file) return void 0;
-		if (!range) return isText(file.content) ? file.content.text : void 0;
-		if (!isText(file.content)) throw new WorkspaceError("MODALITY", `Cannot read a range of a binary file: ${path}`, { path });
+		if (!range) return isTextContent(file.content) ? file.content.text : void 0;
+		if (!isTextContent(file.content)) throw new WorkspaceError("MODALITY", `Cannot read a range of a binary file: ${path}`, { path });
 		return {
 			content: sliceRange(file.content.text, range),
 			range: clampRange(file.content.text, range)
@@ -455,14 +438,12 @@ var Workspace = class {
 		const matches = [];
 		for (const file of this.#files.values()) {
 			if (limit !== void 0 && matches.length >= limit) break;
-			if (!isText(file.content)) continue;
+			if (!isTextContent(file.content)) continue;
 			const lines = file.content.text.split(/\r\n|\n/);
-			for (let index = 0; index < lines.length; index += 1) {
+			for (const [index, lineText] of lines.entries()) {
 				if (limit !== void 0 && matches.length >= limit) break;
-				const lineText = lines[index] ?? "";
 				pattern.lastIndex = 0;
-				let hit = pattern.exec(lineText);
-				while (hit !== null) {
+				for (const hit of lineText.matchAll(pattern)) {
 					if (limit !== void 0 && matches.length >= limit) break;
 					matches.push({
 						path: file.path,
@@ -471,8 +452,6 @@ var Workspace = class {
 						length: hit[0].length,
 						content: lineText
 					});
-					if (hit[0].length === 0) pattern.lastIndex += 1;
-					hit = pattern.exec(lineText);
 				}
 			}
 		}
@@ -481,28 +460,26 @@ var Workspace = class {
 	replace(query, replacement, options) {
 		const pattern = this.#pattern(query, options);
 		const limit = options?.limit;
-		let occurrences = 0;
-		let files = 0;
+		const changes = [];
 		for (const [path, file] of this.#files) {
+			const occurrences = changes.reduce((total, count) => total + count, 0);
 			if (limit !== void 0 && occurrences >= limit) break;
-			if (!isText(file.content)) continue;
+			if (!isTextContent(file.content)) continue;
 			const remaining = limit === void 0 ? void 0 : limit - occurrences;
-			let count = 0;
 			pattern.lastIndex = 0;
-			const next = file.content.text.replace(pattern, (match) => {
-				if (remaining !== void 0 && count >= remaining) return match;
-				count += 1;
-				return replacement;
-			});
+			const text = file.content.text;
+			const matches = Array.from(text.matchAll(pattern));
+			const count = matches.filter((_, index) => remaining === void 0 || !(index >= remaining)).length;
+			const positions = matches.keys();
+			const next = text.replace(pattern, (match) => (positions.next().value ?? Number.POSITIVE_INFINITY) < count ? replacement : match);
 			if (count > 0) {
-				occurrences += count;
-				files += 1;
+				changes.push(count);
 				this.write(path, next);
 			}
 		}
 		return {
-			occurrences,
-			files
+			occurrences: changes.reduce((total, count) => total + count, 0),
+			files: changes.length
 		};
 	}
 	write(path, content, range) {
@@ -534,20 +511,12 @@ var Workspace = class {
 		this.#append(path, content);
 	}
 	move(from, to) {
-		if (isRecord(from)) {
-			let moved = true;
-			for (const [one, target] of Object.entries(from)) if (!this.#move(one, target)) moved = false;
-			return moved;
-		}
+		if (isRecord(from)) return Object.entries(from).reduce((moved, [one, target]) => this.#move(one, target) && moved, true);
 		if (to === void 0) return false;
 		return this.#move(from, to);
 	}
 	remove(path) {
-		if (isArray(path)) {
-			let removed = true;
-			for (const one of path) if (!this.#remove(one)) removed = false;
-			return removed;
-		}
+		if (isArray(path)) return Iterator.from(path).reduce((removed, one) => this.#remove(one) && removed, true);
 		return this.#remove(path);
 	}
 	clear() {
@@ -569,7 +538,7 @@ var Workspace = class {
 			path,
 			content: {
 				text: content,
-				language: existing && isText(existing.content) ? existing.content.language : inferLanguage(path)
+				language: existing && isTextContent(existing.content) ? existing.content.language : inferLanguage(path)
 			},
 			state: existing ? "modified" : "created"
 		});
@@ -579,7 +548,7 @@ var Workspace = class {
 	#splice(path, content, range) {
 		const existing = this.#files.get(path);
 		if (!existing) throw new WorkspaceError("MISSING", `Cannot splice a range of a missing file: ${path}`, { path });
-		if (!isText(existing.content)) throw new WorkspaceError("MODALITY", `Cannot splice a range of a binary file: ${path}`, { path });
+		if (!isTextContent(existing.content)) throw new WorkspaceError("MODALITY", `Cannot splice a range of a binary file: ${path}`, { path });
 		if (!isValidRange(range)) throw new WorkspaceError("RANGE", `Invalid range for file: ${path}`, {
 			path,
 			range
@@ -597,21 +566,21 @@ var Workspace = class {
 	}
 	#prepend(path, content) {
 		const existing = this.#files.get(path);
-		let text = "";
-		if (existing) {
-			if (!isText(existing.content)) throw new WorkspaceError("MODALITY", `Cannot prepend text to a binary file: ${path}`, { path });
-			text = existing.content.text;
+		if (existing === void 0) {
+			this.#write(path, content);
+			return;
 		}
-		this.#write(path, content + text);
+		if (!isTextContent(existing.content)) throw new WorkspaceError("MODALITY", `Cannot prepend text to a binary file: ${path}`, { path });
+		this.#write(path, content + existing.content.text);
 	}
 	#append(path, content) {
 		const existing = this.#files.get(path);
-		let text = "";
-		if (existing) {
-			if (!isText(existing.content)) throw new WorkspaceError("MODALITY", `Cannot append text to a binary file: ${path}`, { path });
-			text = existing.content.text;
+		if (existing === void 0) {
+			this.#write(path, content);
+			return;
 		}
-		this.#write(path, text + content);
+		if (!isTextContent(existing.content)) throw new WorkspaceError("MODALITY", `Cannot append text to a binary file: ${path}`, { path });
+		this.#write(path, existing.content.text + content);
 	}
 	#move(from, to) {
 		if (from === to) return false;
@@ -644,8 +613,7 @@ var Workspace = class {
 		}
 	}
 };
-//#endregion
-//#region src/core/workspaces/WorkspaceManager.ts
+// src/core/workspaces/WorkspaceManager.ts
 /**
 * Implements `WorkspaceManagerInterface` over an insertion-ordered id map and one active id
 * the instance owns, resolving `active` through that map on every read and holding no emitter.
@@ -732,11 +700,7 @@ var WorkspaceManager = class {
 		return true;
 	}
 	remove(ids) {
-		if (isArray(ids)) {
-			let removed = true;
-			for (const id of ids) if (!this.#drop(id)) removed = false;
-			return removed;
-		}
+		if (isArray(ids)) return Iterator.from(ids).reduce((removed, id) => this.#drop(id) && removed, true);
 		return this.#drop(ids);
 	}
 	clear() {
@@ -753,8 +717,7 @@ var WorkspaceManager = class {
 		return true;
 	}
 };
-//#endregion
-//#region src/core/workspaces/stores/DatabaseWorkspaceStore.ts
+// src/core/workspaces/stores/DatabaseWorkspaceStore.ts
 /**
 * Persists workspace snapshots in a database table.
 *
@@ -798,8 +761,7 @@ var DatabaseWorkspaceStore = class {
 		await this.#table.remove(id);
 	}
 };
-//#endregion
-//#region src/core/workspaces/stores/MemoryWorkspaceStore.ts
+// src/core/workspaces/stores/MemoryWorkspaceStore.ts
 /**
 * Holds workspace snapshots in the current process.
 *
@@ -824,8 +786,7 @@ var MemoryWorkspaceStore = class {
 		return Promise.resolve();
 	}
 };
-//#endregion
-//#region src/core/factories.ts
+// src/core/factories.ts
 /**
 * Creates an immutable file with derived size and line counts.
 *
@@ -842,7 +803,7 @@ var MemoryWorkspaceStore = class {
 * 	createTextContent,
 * 	inferLanguage,
 * 	isBinary,
-* 	isText,
+* 	isTextContent,
 * } from '@orkestrel/workspace'
 *
 * const note = createFile({
@@ -853,7 +814,7 @@ var MemoryWorkspaceStore = class {
 * note.size // 12 — UTF-8 bytes, through computeSize
 * note.lines // 2 — through countLines
 * note.state // 'created'
-* isText(note.content) // true
+* isTextContent(note.content) // true
 *
 * const icon = createFile({ path: 'icon.png', content: createBinaryContent('AAAA', 'image/png') })
 * isBinary(icon.content) // true
@@ -984,7 +945,6 @@ function createDatabaseWorkspaceStore(driver = createMemoryDriver()) {
 function createWorkspaceManager(options) {
 	return new WorkspaceManager(options);
 }
-//#endregion
-export { DatabaseWorkspaceStore, EXTENSION_LANGUAGES, MemoryWorkspaceStore, Workspace, WorkspaceError, WorkspaceManager, clampPosition, clampRange, computeDecodedSize, computeSize, countLines, createBinaryContent, createDatabaseWorkspaceStore, createFile, createMemoryWorkspaceStore, createTextContent, createWorkspace, createWorkspaceManager, escapeRegExp, inferLanguage, isBinary, isFile, isText, isValidRange, isWorkspaceError, isWorkspaceSnapshot, offsetAt, rangeOf, sliceRange, spliceRange };
+export { DatabaseWorkspaceStore, EXTENSION_LANGUAGES, MemoryWorkspaceStore, Workspace, WorkspaceError, WorkspaceManager, clampCaret, clampRange, computeDecodedSize, computeSize, countLines, createBinaryContent, createDatabaseWorkspaceStore, createFile, createMemoryWorkspaceStore, createTextContent, createWorkspace, createWorkspaceManager, inferLanguage, isBinary, isFile, isTextContent, isValidRange, isWorkspaceError, isWorkspaceSnapshot, offsetAt, rangeOf, sliceRange, spliceRange };
 
 //# sourceMappingURL=index.js.map