@orkestrel/workspace 0.0.12 → 0.0.14

package/dist/src/core/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _orkestrel_contract = require("@orkestrel/contract");
 let _orkestrel_database = require("@orkestrel/database");
 let _orkestrel_emitter = require("@orkestrel/emitter");
-//#region src/core/constants.ts
+// src/core/constants.ts
 /**
 * Maps file extensions to language tags for text content.
 *
@@ -51,8 +51,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.
@@ -69,6 +68,7 @@ var WorkspaceError = class extends Error {
 	*/
 	constructor(code, message, context) {
 		super(message);
+		_orkestrel_contract.INTRINSICS.define(this, Symbol.for("@orkestrel/workspace.WorkspaceError"), { value: this });
 		this.name = "WorkspaceError";
 		this.code = code;
 		if (context !== void 0) this.context = context;
@@ -78,8 +78,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
@@ -90,10 +90,16 @@ var WorkspaceError = class extends Error {
 * ```
 */
 function isWorkspaceError(value) {
-	return (0, _orkestrel_contract.isInstance)(value, WorkspaceError);
+	return (0, _orkestrel_contract.holds)(() => {
+		if (!(value instanceof Error) || _orkestrel_contract.INTRINSICS.prototype(value) === Error.prototype) return false;
+		if (_orkestrel_contract.INTRINSICS.describe(value, Symbol.for("@orkestrel/workspace.WorkspaceError"))?.value !== value) return false;
+		const code = _orkestrel_contract.INTRINSICS.reflect.read(value, "code");
+		if (code !== "MISSING" && code !== "MODALITY" && code !== "PATTERN" && code !== "RANGE") return false;
+		const context = _orkestrel_contract.INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || (0, _orkestrel_contract.isObject)(context) || (0, _orkestrel_contract.isFunction)(context);
+	});
 }
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Infers a language tag from the final file extension.
 *
@@ -118,10 +124,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;
 }
 /**
@@ -150,7 +156,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);
 }
 /**
@@ -165,11 +171,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.
@@ -183,16 +187,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
@@ -206,28 +208,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
@@ -240,15 +242,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
@@ -256,12 +258,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.
@@ -324,22 +323,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.
 *
@@ -376,8 +360,7 @@ function isFile(value) {
 function isWorkspaceSnapshot(value) {
 	return (0, _orkestrel_contract.holds)(() => (0, _orkestrel_contract.isRecord)(value) && (0, _orkestrel_contract.isString)(value.id) && (0, _orkestrel_contract.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.
@@ -433,14 +416,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)
@@ -456,14 +439,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,
@@ -472,8 +453,6 @@ var Workspace = class {
 						length: hit[0].length,
 						content: lineText
 					});
-					if (hit[0].length === 0) pattern.lastIndex += 1;
-					hit = pattern.exec(lineText);
 				}
 			}
 		}
@@ -482,28 +461,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) {
@@ -535,20 +512,12 @@ var Workspace = class {
 		this.#append(path, content);
 	}
 	move(from, to) {
-		if ((0, _orkestrel_contract.isRecord)(from)) {
-			let moved = true;
-			for (const [one, target] of Object.entries(from)) if (!this.#move(one, target)) moved = false;
-			return moved;
-		}
+		if ((0, _orkestrel_contract.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 ((0, _orkestrel_contract.isArray)(path)) {
-			let removed = true;
-			for (const one of path) if (!this.#remove(one)) removed = false;
-			return removed;
-		}
+		if ((0, _orkestrel_contract.isArray)(path)) return Iterator.from(path).reduce((removed, one) => this.#remove(one) && removed, true);
 		return this.#remove(path);
 	}
 	clear() {
@@ -570,7 +539,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"
 		});
@@ -580,7 +549,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
@@ -598,21 +567,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;
@@ -636,7 +605,7 @@ var Workspace = class {
 		return removed;
 	}
 	#pattern(query, options) {
-		const source = options?.regex === true ? query : escapeRegExp(query);
+		const source = options?.regex === true ? query : (0, _orkestrel_contract.escapeRegExp)(query);
 		const flags = options?.sensitive === false ? "gi" : "g";
 		try {
 			return new RegExp(source, flags);
@@ -645,8 +614,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.
@@ -733,11 +701,7 @@ var WorkspaceManager = class {
 		return true;
 	}
 	remove(ids) {
-		if ((0, _orkestrel_contract.isArray)(ids)) {
-			let removed = true;
-			for (const id of ids) if (!this.#drop(id)) removed = false;
-			return removed;
-		}
+		if ((0, _orkestrel_contract.isArray)(ids)) return Iterator.from(ids).reduce((removed, id) => this.#drop(id) && removed, true);
 		return this.#drop(ids);
 	}
 	clear() {
@@ -754,8 +718,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.
 *
@@ -799,8 +762,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.
 *
@@ -825,8 +787,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.
 *
@@ -843,7 +804,7 @@ var MemoryWorkspaceStore = class {
 * 	createTextContent,
 * 	inferLanguage,
 * 	isBinary,
-* 	isText,
+* 	isTextContent,
 * } from '@orkestrel/workspace'
 *
 * const note = createFile({
@@ -854,7 +815,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
@@ -985,14 +946,13 @@ function createDatabaseWorkspaceStore(driver = (0, _orkestrel_database.createMem
 function createWorkspaceManager(options) {
 	return new WorkspaceManager(options);
 }
-//#endregion
 exports.DatabaseWorkspaceStore = DatabaseWorkspaceStore;
 exports.EXTENSION_LANGUAGES = EXTENSION_LANGUAGES;
 exports.MemoryWorkspaceStore = MemoryWorkspaceStore;
 exports.Workspace = Workspace;
 exports.WorkspaceError = WorkspaceError;
 exports.WorkspaceManager = WorkspaceManager;
-exports.clampPosition = clampPosition;
+exports.clampCaret = clampCaret;
 exports.clampRange = clampRange;
 exports.computeDecodedSize = computeDecodedSize;
 exports.computeSize = computeSize;
@@ -1004,11 +964,10 @@ exports.createMemoryWorkspaceStore = createMemoryWorkspaceStore;
 exports.createTextContent = createTextContent;
 exports.createWorkspace = createWorkspace;
 exports.createWorkspaceManager = createWorkspaceManager;
-exports.escapeRegExp = escapeRegExp;
 exports.inferLanguage = inferLanguage;
 exports.isBinary = isBinary;
 exports.isFile = isFile;
-exports.isText = isText;
+exports.isTextContent = isTextContent;
 exports.isValidRange = isValidRange;
 exports.isWorkspaceError = isWorkspaceError;
 exports.isWorkspaceSnapshot = isWorkspaceSnapshot;