@orkestrel/table 0.0.11 → 0.0.13

package/dist/src/core/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _orkestrel_contract = require("@orkestrel/contract");
 let _orkestrel_emitter = require("@orkestrel/emitter");
-//#region src/core/constants.ts
+// src/core/constants.ts
 /** Lists every column cell, in the order declared by the public contract. */
 var COLUMN_CELLS = Object.freeze([
 	"text",
@@ -23,8 +23,7 @@ var STRING_LIMIT = 65536;
 var TEXT_LIMIT = 1048576;
 /** Names the maximum total number of records, arrays, and leaves one schema retains: 16384. */
 var NODE_LIMIT = 16384;
-//#endregion
-//#region src/core/errors.ts
+// src/core/errors.ts
 /**
 * Represents an error raised by the table domain — a machine-readable `code` and optional
 * structured `context`.
@@ -43,6 +42,7 @@ var TableError = class extends Error {
 	*/
 	constructor(code, message, context) {
 		super(message);
+		_orkestrel_contract.INTRINSICS.define(this, Symbol.for("@orkestrel/table.TableError"), { value: this });
 		this.name = "TableError";
 		this.code = code;
 		if (context !== void 0) this.context = context;
@@ -52,14 +52,45 @@ var TableError = class extends Error {
 * Determines whether a caught value is a table error, so a `catch` branches on `code` without an
 * assertion.
 *
+* @remarks
+* Recognizes self-branded errors across copies and subclasses and refuses transparent proxies.
+* Validates the declared code and optional JSON context.
+*
 * @param input - The value to inspect.
 * @returns True if the value is a {@link TableError} instance; false otherwise.
 */
 function isTableError(input) {
-	return (0, _orkestrel_contract.isInstance)(input, TableError);
+	return (0, _orkestrel_contract.holds)(() => {
+		if (!(input instanceof Error) || _orkestrel_contract.INTRINSICS.prototype(input) === Error.prototype) return false;
+		if (_orkestrel_contract.INTRINSICS.describe(input, Symbol.for("@orkestrel/table.TableError"))?.value !== input) return false;
+		const code = _orkestrel_contract.INTRINSICS.reflect.read(input, "code");
+		const context = _orkestrel_contract.INTRINSICS.reflect.read(input, "context");
+		if (code !== "SCHEMA" && code !== "COLUMN" && code !== "KEY" && code !== "CELL" && code !== "DESTROYED") return false;
+		if (context === void 0) return true;
+		if (!(0, _orkestrel_contract.isRecord)(context)) return false;
+		const pending = [{
+			value: context,
+			ancestors: []
+		}];
+		for (const { value, ancestors } of pending) {
+			if (value === null || [
+				"string",
+				"number",
+				"boolean"
+			].includes(typeof value)) continue;
+			if (!Array.isArray(value) && !(0, _orkestrel_contract.isRecord)(value)) return false;
+			if (ancestors.length >= _orkestrel_contract.GUARD_DEPTH_LIMIT || ancestors.includes(value)) return false;
+			const path = [...ancestors, value];
+			const children = Array.isArray(value) ? Array.from({ length: value.length }, (_, index) => value[index]) : Object.values(value);
+			for (const child of children) pending.push({
+				value: child,
+				ancestors: path
+			});
+		}
+		return true;
+	});
 }
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Finds one column by key; `undefined` when the schema declares no such column.
 *
@@ -282,88 +313,102 @@ function sortRows(schema, rows, orders, comparators) {
 */
 function auditTable(schema) {
 	const faults = [];
-	const columns = /* @__PURE__ */ new Set();
-	let choiceExceeded;
-	let nameExceeded = schema.name !== void 0 && schema.name.length > 128;
+	const columns = [];
+	const longName = schema.name !== void 0 && schema.name.length > 128;
 	if (schema.columns.length > 256) faults.push(`schema declares more than 256 columns`);
 	const columnCount = Math.min(schema.columns.length, 257);
-	for (let index = 0; index < columnCount; index += 1) {
+	const indices = Array.from({ length: columnCount }, (_, index) => index);
+	const [choiceExceeded, nameExceeded] = indices.reduce(([choice, name], index) => {
 		const column = schema.columns[index];
-		if (column === void 0) continue;
-		if (column.key.length > 128) nameExceeded = true;
-		if (choiceExceeded === void 0 && column.cell === "choice" && column.choices.length > 1024) choiceExceeded = column.key;
-	}
+		if (column === void 0) return [choice, name];
+		const exceeded = column.key.length > 128;
+		return [choice === void 0 && column.cell === "choice" && column.choices.length > 1024 ? column.key : choice, name || exceeded];
+	}, [void 0, longName]);
 	if (choiceExceeded !== void 0) faults.push(`column "${choiceExceeded}" offers more than ${CHOICE_LIMIT} choices`);
 	if (nameExceeded) faults.push(`schema contains a name longer than 128`);
 	const pending = [schema];
 	const metadata = [false];
-	let position = 0;
-	let stringExceeded = false;
-	let textExceeded = false;
-	let nodeExceeded = false;
-	let text = 0;
-	while (position < pending.length) {
-		const node = pending[position];
+	const measurements = [];
+	for (const [position, node] of pending.entries()) {
 		const inMeta = metadata[position] === true;
-		position += 1;
 		if ((0, _orkestrel_contract.isString)(node)) {
-			if (node.length > 65536) stringExceeded = true;
-			text = Math.min(TEXT_LIMIT + 1, text + node.length);
-			if (text > 1048576) textExceeded = true;
+			measurements.push([
+				node.length,
+				node.length > STRING_LIMIT,
+				false
+			]);
 			continue;
 		}
 		if ((0, _orkestrel_contract.isArray)(node)) {
 			const read = (0, _orkestrel_contract.readArrayEntries)(node);
 			if (!read.success || !read.value.dense) continue;
-			for (const entry of read.value.entries) {
-				if (pending.length >= 16384) {
-					nodeExceeded = true;
-					continue;
-				}
+			const exceeded = read.value.entries.reduce((refused, entry) => {
+				if (pending.length >= 16384) return true;
 				pending.push(entry);
 				metadata.push(inMeta);
-			}
+				return refused;
+			}, false);
+			measurements.push([
+				0,
+				false,
+				exceeded
+			]);
 			continue;
 		}
 		if (!(0, _orkestrel_contract.isRecord)(node)) continue;
 		const keys = (0, _orkestrel_contract.attempt)(() => Object.keys(node));
 		if (!keys.success) continue;
-		for (const key of keys.value) {
-			if (inMeta) {
-				if (key.length > 65536) stringExceeded = true;
-				text = Math.min(TEXT_LIMIT + 1, text + key.length);
-				if (text > 1048576) textExceeded = true;
-			}
+		const measured = keys.value.reduce(([text, string, refused], key) => {
+			const length = text + (inMeta ? key.length : 0);
+			const oversized = string || inMeta && key.length > 65536;
 			const value = (0, _orkestrel_contract.attempt)(() => node[key]);
-			if (!value.success || value.value === void 0) continue;
-			if (pending.length >= 16384) {
-				nodeExceeded = true;
-				continue;
-			}
+			if (!value.success || value.value === void 0) return [
+				length,
+				oversized,
+				refused
+			];
+			if (pending.length >= 16384) return [
+				length,
+				oversized,
+				true
+			];
 			pending.push(value.value);
 			metadata.push(inMeta || key === "meta");
-		}
-	}
+			return [
+				length,
+				oversized,
+				refused
+			];
+		}, [
+			0,
+			false,
+			false
+		]);
+		measurements.push(measured);
+	}
+	const stringExceeded = measurements.some((entry) => entry[1]);
+	const textExceeded = measurements.reduce((total, entry) => total + entry[0], 0) > TEXT_LIMIT;
+	const nodeExceeded = measurements.some((entry) => entry[2]);
 	if (stringExceeded) faults.push(`schema contains a string longer than ${STRING_LIMIT}`);
 	if (textExceeded) faults.push(`schema retains more than ${TEXT_LIMIT} string code units`);
 	if (nodeExceeded) faults.push(`schema retains more than ${NODE_LIMIT} nodes`);
-	for (let index = 0; index < columnCount; index += 1) {
+	for (const index of indices) {
 		const column = schema.columns[index];
 		if (column === void 0) continue;
 		if (!nodeExceeded && column.meta !== void 0) {
 			if (!(0, _orkestrel_contract.attempt)(() => (0, _orkestrel_contract.cloneJSONRecord)(column.meta)).success) faults.push(`column "${column.key}" has metadata that cannot be owned`);
 		}
 		if (column.key.length === 0) faults.push("column \"\" has an empty key");
-		if (columns.has(column.key)) faults.push(`column "${column.key}" is declared more than once`);
-		columns.add(column.key);
+		if (columns.includes(column.key)) faults.push(`column "${column.key}" is declared more than once`);
+		columns.push(column.key);
 		if (column.cell === "choice") {
-			const choices = /* @__PURE__ */ new Set();
+			const choices = [];
 			const choiceCount = Math.min(column.choices.length, CHOICE_LIMIT + 1);
-			for (let choiceIndex = 0; choiceIndex < choiceCount; choiceIndex += 1) {
+			for (const choiceIndex of Array.from({ length: choiceCount }, (_, position) => position)) {
 				const choice = column.choices[choiceIndex];
 				if (choice === void 0) continue;
-				if (choices.has(choice.value)) faults.push(`column "${column.key}" offers choice "${choice.value}" more than once`);
-				choices.add(choice.value);
+				if (choices.includes(choice.value)) faults.push(`column "${column.key}" offers choice "${choice.value}" more than once`);
+				choices.push(choice.value);
 			}
 			if (column.choices.length === 0) faults.push(`column "${column.key}" offers no choices`);
 		}
@@ -448,8 +493,7 @@ function serializeRows(schema, rows) {
 function matchesTableRow(left, right) {
 	return left !== void 0 && Object.keys(left).length === Object.keys(right).length && Object.keys(right).every((key) => Object.hasOwn(left, key) && left[key] === right[key]);
 }
-//#endregion
-//#region src/core/validators.ts
+// src/core/validators.ts
 /**
 * Determines whether an unknown value has a table cell shape — a string, a finite number, or a
 * boolean.
@@ -580,8 +624,7 @@ function isTableSchema(input) {
 	const outcome = (0, _orkestrel_contract.attempt)(() => isStructuralTableSchema(input) && auditTable(input).length === 0);
 	return outcome.success && outcome.value;
 }
-//#endregion
-//#region src/core/cloners.ts
+// src/core/cloners.ts
 /**
 * Clones one row into an owned frozen snapshot.
 *
@@ -602,13 +645,12 @@ function cloneSchema(schema) {
 	return Object.freeze({
 		...schema,
 		columns: Object.freeze(schema.columns.map((column) => {
-			let meta = {};
-			if (column.meta !== void 0) try {
-				meta = { meta: (0, _orkestrel_contract.cloneJSONRecord)(column.meta) };
-			} catch (error) {
-				if (!(0, _orkestrel_contract.isContractError)(error)) throw error;
+			const owned = column.meta === void 0 ? void 0 : (0, _orkestrel_contract.attempt)(() => (0, _orkestrel_contract.cloneJSONRecord)(column.meta));
+			if (owned !== void 0 && !owned.success) {
+				if (!(0, _orkestrel_contract.isContractError)(owned.error)) throw owned.error;
 				throw new TableError("SCHEMA", `column "${column.key}" has metadata that cannot be owned`, { column: column.key });
 			}
+			const meta = owned === void 0 ? {} : { meta: owned.value };
 			if (column.cell === "choice") return Object.freeze({
 				...column,
 				...meta,
@@ -621,8 +663,7 @@ function cloneSchema(schema) {
 		}))
 	});
 }
-//#endregion
-//#region src/core/parsers.ts
+// src/core/parsers.ts
 /**
 * Parses unknown wire data into an owned, structurally valid, semantically sound table schema.
 *
@@ -660,12 +701,8 @@ function parseRows(schema, input) {
 				const column = extractColumn(schema, key);
 				if (column === void 0) return void 0;
 				const inputCell = candidate[key];
-				let cell = inputCell;
-				if (column.cell === "number" && (0, _orkestrel_contract.isString)(inputCell)) {
-					if (inputCell.length > 65536) return void 0;
-					cell = (0, _orkestrel_contract.parseNumber)(inputCell);
-				} else if (column.cell === "flag" && inputCell === "true") cell = true;
-				else if (column.cell === "flag" && inputCell === "false") cell = false;
+				if (column.cell === "number" && (0, _orkestrel_contract.isString)(inputCell) && inputCell.length > 65536) return void 0;
+				const cell = column.cell === "number" && (0, _orkestrel_contract.isString)(inputCell) ? (0, _orkestrel_contract.parseNumber)(inputCell) : column.cell === "flag" && inputCell === "true" ? true : column.cell === "flag" && inputCell === "false" ? false : inputCell;
 				if (!matchesCell(column, cell)) return void 0;
 				Object.defineProperty(row, key, {
 					value: cell,
@@ -684,8 +721,7 @@ function parseRows(schema, input) {
 	});
 	return outcome.success ? outcome.value : void 0;
 }
-//#endregion
-//#region src/core/tables/KeyManager.ts
+// src/core/tables/KeyManager.ts
 /** Manages the key set one table axis holds, and the event it announces when that set moves. */
 var KeyManager = class {
 	#emitter;
@@ -712,7 +748,7 @@ var KeyManager = class {
 		this.#read = read;
 		this.#write = write;
 	}
-	/** Returns the keys held right now. */
+	/** Returns the keys held. */
 	get keys() {
 		return new Set(this.#read());
 	}
@@ -736,8 +772,7 @@ var KeyManager = class {
 		return input === void 0 ? void 0 : true;
 	}
 };
-//#endregion
-//#region src/core/tables/ExpansionManager.ts
+// src/core/tables/ExpansionManager.ts
 /** Manages the keys of the rows somebody has opened. */
 var ExpansionManager = class {
 	#keys;
@@ -753,7 +788,7 @@ var ExpansionManager = class {
 	constructor(emitter, gate, rows, read, write) {
 		this.#keys = new KeyManager(emitter, "expand", gate, rows, read, write);
 	}
-	/** Returns the keys of the rows opened right now. */
+	/** Returns the keys of the rows opened. */
 	get keys() {
 		return this.#keys.keys;
 	}
@@ -770,8 +805,7 @@ var ExpansionManager = class {
 		return this.#keys.change(input, (included) => !included) === true;
 	}
 };
-//#endregion
-//#region src/core/tables/FilterManager.ts
+// src/core/tables/FilterManager.ts
 /** Manages the filters one table applies with and-only composition. */
 var FilterManager = class {
 	#schema;
@@ -845,8 +879,7 @@ var FilterManager = class {
 		return left.operator === "equals" && right.operator === "equals" && left.value === right.value;
 	}
 };
-//#endregion
-//#region src/core/tables/PaginationManager.ts
+// src/core/tables/PaginationManager.ts
 /** Manages the page arithmetic over one table's filtered rows. */
 var PaginationManager = class {
 	#emitter;
@@ -920,8 +953,7 @@ var PaginationManager = class {
 		return (0, _orkestrel_contract.isFiniteNumber)(value) ? Math.max(1, Math.trunc(value)) : 1;
 	}
 };
-//#endregion
-//#region src/core/tables/RowManager.ts
+// src/core/tables/RowManager.ts
 /** Manages the rows one table holds in its own order. */
 var RowManager = class {
 	#schema;
@@ -995,8 +1027,7 @@ var RowManager = class {
 		}
 		const next = [...current];
 		const moved = [];
-		for (let index = 0; index < updates.length; index += 1) {
-			const update = updates[index];
+		for (const [index, update] of updates.entries()) {
 			const location = locations[index];
 			if (update === void 0 || location === void 0) continue;
 			const previous = next[location];
@@ -1122,8 +1153,7 @@ var RowManager = class {
 		throw new TableError("KEY", message, { key });
 	}
 };
-//#endregion
-//#region src/core/tables/SelectionManager.ts
+// src/core/tables/SelectionManager.ts
 /** Manages the keys of the rows somebody has picked. */
 var SelectionManager = class {
 	#keys;
@@ -1139,7 +1169,7 @@ var SelectionManager = class {
 	constructor(emitter, gate, rows, read, write) {
 		this.#keys = new KeyManager(emitter, "select", gate, rows, read, write);
 	}
-	/** Returns the keys of the rows picked right now. */
+	/** Returns the keys of the rows picked. */
 	get keys() {
 		return this.#keys.keys;
 	}
@@ -1156,8 +1186,7 @@ var SelectionManager = class {
 		return this.#keys.change(input, (included) => !included) === true;
 	}
 };
-//#endregion
-//#region src/core/tables/SortManager.ts
+// src/core/tables/SortManager.ts
 /** Manages the ordered sort terms of one table. */
 var SortManager = class {
 	#schema;
@@ -1216,8 +1245,7 @@ var SortManager = class {
 		if (extractColumn(this.#schema, column) === void 0) throw new TableError("COLUMN", `The schema declares no column named "${column}"`, { column });
 	}
 };
-//#endregion
-//#region src/core/Table.ts
+// src/core/Table.ts
 /**
 * Holds a schema, its rows, and the lens through which they are read, implementing
 * {@link TableInterface} exactly.
@@ -1386,8 +1414,7 @@ var Table = class {
 		if (this.#destroyed) throw new TableError("DESTROYED", "The table was destroyed and cannot change");
 	}
 };
-//#endregion
-//#region src/core/factories.ts
+// src/core/factories.ts
 /**
 * Opens a table against a schema. The schema is copied, and the copy is what the table declares.
 *
@@ -1431,7 +1458,6 @@ var Table = class {
 function createTable(schema, options) {
 	return new Table(schema, options);
 }
-//#endregion
 exports.CHOICE_LIMIT = CHOICE_LIMIT;
 exports.COLUMN_CELLS = COLUMN_CELLS;
 exports.COLUMN_LIMIT = COLUMN_LIMIT;