@bilig/workbook 0.90.0 → 0.90.4

package/README.md

@@ -169,8 +169,9 @@ an agent inspected cannot be mutated behind the same handoff object.
 `verifyPlan` also treats plans as data: malformed, sparse, or accessor-backed
 handoff objects return an `invalid_plan` issue instead of executing hidden
 properties or throwing at the caller.
-`verifyModel` keeps the same behavior at whole-model scope: invalid manifests
-return an invalid verdict with an `invalid_model` error and no actions.
+`verifyModel` keeps the same behavior at whole-model scope: invalid,
+array-backed, or accessor-backed manifests return an invalid verdict with an
+`invalid_model` error and no actions.
 Its `{ inputs }` option is data-only too: accessor-backed option payloads or
 per-action inputs produce structured `invalid_action_input` results without
 running hidden consumer code.
@@ -220,7 +221,10 @@ proof keep nested JSON paths such as `input.rows[1]` and
 hydration. Plan-data guards only trust own payload fields; inherited
 prototype fields never satisfy the transport contract. Transported plan arrays
 must contain own enumerable data entries too; holes, non-enumerable entries, or
-accessor-backed entries are rejected without running getters. The hydrated plan
+accessor-backed entries are rejected without running getters. The plan root and
+nested plan entries such as commands, changes, checks, formula labels, and
+expectations must be record-shaped payloads, not arrays with attached fields.
+The hydrated plan
 exposes `refs: { refsUsed }` instead of the consumer's private model-shaped
 `refs` object, so transported execution stays generic. A valid
 `checkPlanData(data)` result returns canonical plan data, stripping caller-owned
@@ -296,6 +300,8 @@ must be own enumerable data entries; holes, non-enumerable entries, or
 accessor-backed entries are rejected without running getters. Use
 `checkRuntimeAdapter(planOrRequirements, adapter)` when an agent wants to check
 `apply`, `read`, and `verifyChecks` coverage before calling the runtime.
+The requirements root object, every requirement entry, and runtime adapter
+objects must be record-shaped payloads, not arrays with attached fields.
 Runtime requirement descriptions are frozen normalized data too:
 `describeRuntimeRequirements` and `checkRuntimeRequirements` strip
 caller-owned extra fields and freeze the returned requirement tree, including
@@ -340,14 +346,18 @@ and the frozen run-result description, and roll back engine ops if post-apply
 readback or check proof fails.
 Runtime apply results, undo refs, apply errors, and check verifier output are
 validated from own fields only; prototype-inherited fields are ignored before
-they can become run proof. Adapter-returned ops and verifier proof must be data
-properties, including non-enumerable guard fields such as `kind`. Runtime
-evidence arrays must contain own enumerable data entries; holes,
-non-enumerable entries, and accessors are rejected before any getter can run
-during validation, cloning, or preview/apply comparison.
+they can become run proof. Apply-result objects and verifier check objects must
+be plain record-shaped payloads, not arrays with attached fields.
+Adapter-returned ops and verifier proof must be data properties, including
+non-enumerable guard fields such as `kind`. Runtime evidence arrays must contain
+own enumerable data entries; holes, non-enumerable entries, and accessors are
+rejected before any getter can run during validation, cloning, or preview/apply
+comparison.
 Readback checks attach proof to passed checks, such as
 `{ source: "readback", value: 12 }` or
 `{ source: "readback", formula: "Table[Quantity]*Table[Rate]" }`.
+Readback proof objects, check objects, expectations, and formula labels must be
+record-shaped payloads, not arrays with attached fields.
 Formula readback proof is parsed with `@bilig/formula` and stored in canonical
 no-leading-`=` form, so harmless runtime differences such as a leading equals
 sign, whitespace, or redundant parentheses do not make proof fail.
@@ -455,10 +465,11 @@ It returns the same boring `{ status, issues }` shape for receipt fields such as
 `changedRanges`, `proof`, `metadata`, and `errors`. Feature manifests, command
 requests, and command receipts are validated from own payload fields only;
 prototype-inherited fields are ignored. Receipt verdicts are frozen. Receipt ops are frozen after
-normalization, changed ranges must be own-field data, and manifest or receipt
-arrays must contain own enumerable data entries. Holes, non-enumerable entries,
-and accessor-backed ops, undo ops, ranges, or errors are rejected before any
-getter can run.
+normalization, changed ranges are canonicalized through the same workbook range
+normalizer used by command scopes, and manifest or receipt arrays must contain
+own enumerable data entries. Holes, non-enumerable entries, invalid range
+addresses, and accessor-backed ops, undo ops, ranges, or errors are rejected
+before any getter can run.
 Receipt statuses are semantic: `previewed` cannot include applied proof,
 `applied` cannot include errors and must carry applied evidence, `rejected`
 cannot claim changed workbook proof, and `noop` cannot claim changed ranges or

package/dist/command-ranges.js

@@ -1,11 +1,18 @@
 import { formatAddress, parseCellAddress } from '@bilig/formula';
+const commandRangeDataFields = Object.freeze(['sheetName', 'startAddress', 'endAddress']);
 export function normalizeCommandRange(value, path, label = 'Workbook command bundle') {
     if (!isRecord(value)) {
         throw new Error(`${label} ${path} must be an object`);
     }
-    const sheetName = ownValue(value, 'sheetName');
-    const startAddress = ownValue(value, 'startAddress');
-    const endAddress = ownValue(value, 'endAddress');
+    for (const field of commandRangeDataFields) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, field);
+        if (descriptor !== undefined && !('value' in descriptor)) {
+            throw new Error(`${label} ${path}.${field} must be a data property`);
+        }
+    }
+    const sheetName = ownDataValue(value, 'sheetName');
+    const startAddress = ownDataValue(value, 'startAddress');
+    const endAddress = ownDataValue(value, 'endAddress');
     if (typeof sheetName !== 'string' || typeof startAddress !== 'string' || typeof endAddress !== 'string') {
         throw new Error(`${label} ${path} must include sheetName, startAddress, and endAddress strings`);
     }
@@ -76,7 +83,7 @@ function normalizeExactString(value, path, label) {
     }
     return normalized;
 }
-function ownValue(value, key) {
+function ownDataValue(value, key) {
     return Object.getOwnPropertyDescriptor(value, key)?.value;
 }
 function isRecord(value) {

package/dist/command-ranges.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-ranges.js","sourceRoot":"","sources":["../src/command-ranges.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-ranges.js","sourceRoot":"","sources":["../src/command-ranges.ts"],"names":[],"mappings":"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"}

package/dist/command-receipt-ranges.d.ts

@@ -0,0 +1,7 @@
+import type { CellRangeRef } from '@bilig/protocol';
+export interface WorkbookCommandReceiptRangeIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export declare function commandReceiptChangedRangeIssues(value: unknown): readonly WorkbookCommandReceiptRangeIssue[];
+export declare function normalizeCommandReceiptChangedRanges(value: unknown): readonly CellRangeRef[] | null;

package/dist/command-receipt-ranges.js

@@ -0,0 +1,64 @@
+import { normalizeCommandRange } from './command-ranges.js';
+const commandReceiptRangeDataFields = Object.freeze(['sheetName', 'startAddress', 'endAddress']);
+export function commandReceiptChangedRangeIssues(value) {
+    if (!Array.isArray(value)) {
+        return Object.freeze([rangeIssue('changedRanges', 'Workbook command receipt changed ranges must be an array')]);
+    }
+    const issues = [];
+    for (let index = 0; index < value.length; index += 1) {
+        const path = `changedRanges[${String(index)}]`;
+        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+        if (descriptor === undefined || !descriptor.enumerable || !('value' in descriptor)) {
+            issues.push(rangeIssue(path, 'Workbook command receipt changed ranges must contain only data properties'));
+            continue;
+        }
+        const dataFieldIssue = firstRangeDataFieldIssue(descriptor.value, path);
+        if (dataFieldIssue !== null) {
+            issues.push(dataFieldIssue);
+            continue;
+        }
+        try {
+            normalizeCommandRange(descriptor.value, path, 'Workbook command receipt');
+        }
+        catch (error) {
+            issues.push(rangeIssue(path, errorMessage(error)));
+        }
+    }
+    return Object.freeze(issues);
+}
+function firstRangeDataFieldIssue(value, path) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return null;
+    }
+    for (const field of commandReceiptRangeDataFields) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, field);
+        if (descriptor !== undefined && !('value' in descriptor)) {
+            return rangeIssue(`${path}.${field}`, `Workbook command receipt ${path}.${field} must be a data property`);
+        }
+    }
+    return null;
+}
+export function normalizeCommandReceiptChangedRanges(value) {
+    if (commandReceiptChangedRangeIssues(value).length > 0 || !Array.isArray(value)) {
+        return null;
+    }
+    const ranges = [];
+    for (let index = 0; index < value.length; index += 1) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+        if (descriptor === undefined || !descriptor.enumerable || !('value' in descriptor)) {
+            return null;
+        }
+        ranges.push(normalizeCommandRange(descriptor.value, `changedRanges[${String(index)}]`, 'Workbook command receipt').range);
+    }
+    return Object.freeze(ranges);
+}
+function rangeIssue(path, message) {
+    return Object.freeze({
+        path,
+        message,
+    });
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=command-receipt-ranges.js.map

package/dist/command-receipt-ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-receipt-ranges.js","sourceRoot":"","sources":["../src/command-receipt-ranges.ts"],"names":[],"mappings":"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"}

package/dist/command-result-undo.d.ts

@@ -0,0 +1,2 @@
+import type { WorkbookUndoRef } from './result.js';
+export declare function normalizeCommandResultUndoRef(value: unknown, path: string): WorkbookUndoRef;

package/dist/command-result-undo.js

@@ -0,0 +1,148 @@
+import { isWorkbookOp } from './guards.js';
+export function normalizeCommandResultUndoRef(value, path) {
+    if (!isRecord(value)) {
+        throw new Error(`Workbook command result ${path} must be an object`);
+    }
+    const accessorKeys = ownAccessorKeys(value, ['id', 'ops']);
+    if (accessorKeys.length > 0) {
+        throw new Error(`Workbook command result ${path}.${accessorKeys[0]} must be a data property`);
+    }
+    const id = ownValue(value, 'id');
+    if (typeof id !== 'string') {
+        throw new Error(`Workbook command result ${path}.id must be a string`);
+    }
+    const ops = ownValue(value, 'ops');
+    if (ops !== undefined && !Array.isArray(ops)) {
+        throw new Error(`Workbook command result ${path}.ops must be an array`);
+    }
+    if (Array.isArray(ops)) {
+        const accessorPath = firstAccessorPath(ops, `${path}.ops`);
+        if (accessorPath !== null) {
+            throw new Error(`Workbook command result ${accessorPath} must contain only data properties`);
+        }
+        const normalizedOps = [];
+        for (let index = 0; index < ops.length; index += 1) {
+            const op = arrayDataValue(ops, index);
+            if (op === undefined) {
+                throw new Error(`Workbook command result ${path}.ops[${String(index)}] must contain only data properties`);
+            }
+            normalizedOps.push(normalizeOp(op));
+        }
+        return Object.freeze({
+            id: normalizeExactString(id, `${path}.id`),
+            ops: Object.freeze(normalizedOps),
+        });
+    }
+    return Object.freeze({
+        id: normalizeExactString(id, `${path}.id`),
+    });
+}
+function normalizeOp(value) {
+    if (!isWorkbookOp(value)) {
+        throw new Error('Workbook command result op is invalid');
+    }
+    const cloned = cloneData(value);
+    if (!isWorkbookOp(cloned)) {
+        throw new Error('Workbook command result op clone is invalid');
+    }
+    return freezeData(cloned);
+}
+function normalizeExactString(value, path) {
+    const normalized = value.trim();
+    if (normalized === '') {
+        throw new Error(`Workbook command result ${path} cannot be empty`);
+    }
+    if (normalized !== value) {
+        throw new Error(`Workbook command result ${path} must not have leading or trailing whitespace`);
+    }
+    return normalized;
+}
+function arrayDataValue(value, index) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+    return descriptor !== undefined && descriptor.enumerable && 'value' in descriptor ? descriptor.value : undefined;
+}
+function ownValue(value, key) {
+    return Object.getOwnPropertyDescriptor(value, key)?.value;
+}
+function ownAccessorKeys(value, keys) {
+    const accessors = [];
+    for (const key of keys) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor !== undefined && !('value' in descriptor)) {
+            accessors.push(key);
+        }
+    }
+    return accessors;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function firstAccessorPath(value, path, seen = new WeakSet()) {
+    if (typeof value !== 'object' || value === null) {
+        return null;
+    }
+    if (seen.has(value)) {
+        return null;
+    }
+    seen.add(value);
+    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
+        const childPath = Array.isArray(value) && /^\d+$/.test(key) ? `${path}[${key}]` : `${path}.${key}`;
+        if (!('value' in descriptor)) {
+            return childPath;
+        }
+        const nestedPath = firstAccessorPath(descriptor.value, childPath, seen);
+        if (nestedPath !== null) {
+            return nestedPath;
+        }
+    }
+    return null;
+}
+function freezeData(value, seen = new WeakSet()) {
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    if (seen.has(value)) {
+        return value;
+    }
+    seen.add(value);
+    Object.values(Object.getOwnPropertyDescriptors(value)).forEach((descriptor) => {
+        if ('value' in descriptor) {
+            freezeData(descriptor.value, seen);
+        }
+    });
+    return Object.freeze(value);
+}
+function cloneData(value, seen = new WeakMap()) {
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    const existing = seen.get(value);
+    if (existing !== undefined) {
+        return existing;
+    }
+    if (Array.isArray(value)) {
+        const cloned = [];
+        seen.set(value, cloned);
+        for (let index = 0; index < value.length; index += 1) {
+            const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+            if (descriptor !== undefined && descriptor.enumerable && 'value' in descriptor) {
+                cloned[index] = cloneData(descriptor.value, seen);
+            }
+        }
+        return cloned;
+    }
+    const cloned = Object.create(Object.getPrototypeOf(value));
+    seen.set(value, cloned);
+    Object.entries(Object.getOwnPropertyDescriptors(value)).forEach(([key, descriptor]) => {
+        if (descriptor.enumerable && 'value' in descriptor) {
+            Object.defineProperty(cloned, key, {
+                configurable: true,
+                enumerable: true,
+                value: cloneData(descriptor.value, seen),
+                writable: true,
+            });
+        }
+    });
+    return cloned;
+}
+//# sourceMappingURL=command-result-undo.js.map

package/dist/command-result-undo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-result-undo.js","sourceRoot":"","sources":["../src/command-result-undo.ts"],"names":[],"mappings":"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"}

package/dist/command-result.js

@@ -1,12 +1,22 @@
 import { commandRangeBounds, commandRangeContains, commandRangeLabel, normalizeCommandRange } from './command-ranges.js';
+import { normalizeCommandResultUndoRef } from './command-result-undo.js';
 import { checkWorkbookCommandReceipt, normalizeWorkbookCommandReceipt, workbookCommandReceiptOpsMatch, workbookCommandReceiptStatuses, } from './features.js';
-import { isWorkbookOp } from './guards.js';
 export const workbookCommandResultStatuses = Object.freeze([
     'accepted',
     ...workbookCommandReceiptStatuses,
 ]);
 const WORKBOOK_COMMAND_RESULT_STATUS_SET = new Set(workbookCommandResultStatuses);
 const acceptedResultSettledFields = Object.freeze(['receipts', 'matched', 'changedRanges', 'revision', 'undo', 'errors']);
+const commandResultDataFields = Object.freeze([
+    'status',
+    'bundleId',
+    'targetRevision',
+    'idempotencyKey',
+    'commandCount',
+    'touchedRanges',
+    'touchedCellCount',
+    ...acceptedResultSettledFields,
+]);
 export const workbookOpCommandFeatureId = 'workbook-op';
 export function isWorkbookCommandResultStatus(value) {
     return typeof value === 'string' && WORKBOOK_COMMAND_RESULT_STATUS_SET.has(value);
@@ -45,7 +55,7 @@ export function workbookCommandResultForReceipts(bundle, receipts, options = {})
     if (revision !== undefined && !isSafeNonNegativeInteger(revision)) {
         throw new Error('Workbook command result is invalid: revision must be a safe non-negative integer');
     }
-    const undo = options.undo === undefined ? undefined : normalizeUndoRef(options.undo, 'undo');
+    const undo = options.undo === undefined ? undefined : normalizeCommandResultUndoRef(options.undo, 'undo');
     const changedRanges = normalizedReceipts.flatMap((receipt) => [...(receipt.changedRanges ?? [])]);
     const errors = commandResultErrorsForReceipts(normalizedReceipts);
     return normalizeWorkbookCommandResult({
@@ -83,37 +93,69 @@ export function checkWorkbookCommandResult(value) {
         });
     }
     const issues = [];
-    const status = ownValue(value, 'status');
+    const accessorKeys = new Set(ownAccessorKeys(value, commandResultDataFields));
+    accessorKeys.forEach((key) => {
+        issues.push(commandResultIssue('invalid_command_result', key, `Workbook command result ${key} must be a data property`));
+    });
+    const status = accessorKeys.has('status') ? undefined : ownValue(value, 'status');
     if (!isWorkbookCommandResultStatus(status)) {
         issues.push(commandResultIssue('invalid_command_result', 'status', 'Workbook command result status is invalid'));
     }
-    pushResultOptionalStringIssue(issues, ownValue(value, 'bundleId'), 'bundleId', 'bundle id');
-    pushResultSafeIntegerIssue(issues, ownValue(value, 'targetRevision'), 'targetRevision', 'target revision', true);
-    pushResultRequiredStringIssue(issues, ownValue(value, 'idempotencyKey'), 'idempotencyKey', 'idempotency key');
-    pushResultSafeIntegerIssue(issues, ownValue(value, 'commandCount'), 'commandCount', 'command count', true);
-    pushResultRangesIssues(issues, ownValue(value, 'touchedRanges'), 'touchedRanges', 'touched ranges');
-    pushResultSafeIntegerIssue(issues, ownValue(value, 'touchedCellCount'), 'touchedCellCount', 'touched cell count', true);
+    if (!accessorKeys.has('bundleId')) {
+        pushResultOptionalStringIssue(issues, ownValue(value, 'bundleId'), 'bundleId', 'bundle id');
+    }
+    if (!accessorKeys.has('targetRevision')) {
+        pushResultSafeIntegerIssue(issues, ownValue(value, 'targetRevision'), 'targetRevision', 'target revision', true);
+    }
+    if (!accessorKeys.has('idempotencyKey')) {
+        pushResultRequiredStringIssue(issues, ownValue(value, 'idempotencyKey'), 'idempotencyKey', 'idempotency key');
+    }
+    if (!accessorKeys.has('commandCount')) {
+        pushResultSafeIntegerIssue(issues, ownValue(value, 'commandCount'), 'commandCount', 'command count', true);
+    }
+    if (!accessorKeys.has('touchedRanges')) {
+        pushResultRangesIssues(issues, ownValue(value, 'touchedRanges'), 'touchedRanges', 'touched ranges');
+    }
+    if (!accessorKeys.has('touchedCellCount')) {
+        pushResultSafeIntegerIssue(issues, ownValue(value, 'touchedCellCount'), 'touchedCellCount', 'touched cell count', true);
+    }
     if (status === 'accepted') {
         pushAcceptedResultSettledFieldIssues(issues, value);
     }
     else if (isWorkbookCommandResultStatus(status)) {
-        pushResultSafeIntegerIssue(issues, ownValue(value, 'revision'), 'revision', 'revision', false);
-        pushResultReceiptsIssues(issues, ownValue(value, 'receipts'));
-        const matched = ownValue(value, 'matched');
-        if (matched !== null && typeof matched !== 'boolean') {
-            issues.push(commandResultIssue('invalid_command_result', 'matched', 'Workbook command result matched must be boolean or null'));
-        }
-        pushResultRangesIssues(issues, ownValue(value, 'changedRanges'), 'changedRanges', 'changed ranges');
-        const undo = ownValue(value, 'undo');
-        if (undo !== undefined) {
-            try {
-                normalizeUndoRef(undo, 'undo');
+        if (!accessorKeys.has('revision')) {
+            pushResultSafeIntegerIssue(issues, ownValue(value, 'revision'), 'revision', 'revision', false);
+        }
+        if (!accessorKeys.has('receipts')) {
+            pushResultReceiptsIssues(issues, ownValue(value, 'receipts'));
+        }
+        if (!accessorKeys.has('matched')) {
+            const matched = ownValue(value, 'matched');
+            if (matched !== null && typeof matched !== 'boolean') {
+                issues.push(commandResultIssue('invalid_command_result', 'matched', 'Workbook command result matched must be boolean or null'));
             }
-            catch (error) {
-                issues.push(commandResultIssue('invalid_undo', 'undo', errorMessage(error)));
+        }
+        if (!accessorKeys.has('changedRanges')) {
+            pushResultRangesIssues(issues, ownValue(value, 'changedRanges'), 'changedRanges', 'changed ranges');
+        }
+        const undo = accessorKeys.has('undo') ? undefined : ownValue(value, 'undo');
+        if (!accessorKeys.has('undo') && undo !== undefined) {
+            const undoAccessorKeys = isRecord(undo) ? ownAccessorKeys(undo, ['id', 'ops']) : [];
+            undoAccessorKeys.forEach((key) => {
+                issues.push(commandResultIssue('invalid_undo', `undo.${key}`, `Workbook command result undo.${key} must be a data property`));
+            });
+            if (undoAccessorKeys.length === 0) {
+                try {
+                    normalizeCommandResultUndoRef(undo, 'undo');
+                }
+                catch (error) {
+                    issues.push(commandResultIssue('invalid_undo', 'undo', errorMessage(error)));
+                }
             }
         }
-        pushResultErrorsIssues(issues, ownValue(value, 'errors'));
+        if (!accessorKeys.has('errors')) {
+            pushResultErrorsIssues(issues, ownValue(value, 'errors'));
+        }
     }
     if (issues.length > 0) {
         return Object.freeze({
@@ -545,7 +587,7 @@ function normalizeWorkbookCommandResultData(value) {
         receipts: Object.freeze(normalizeResultReceipts(ownValue(value, 'receipts'))),
         matched: matched === true ? true : matched === false ? false : null,
         changedRanges: Object.freeze(normalizeResultRanges(ownValue(value, 'changedRanges'), 'changedRanges')),
-        ...(undo !== undefined ? { undo: normalizeUndoRef(undo, 'undo') } : {}),
+        ...(undo !== undefined ? { undo: normalizeCommandResultUndoRef(undo, 'undo') } : {}),
         ...(Array.isArray(errors) ? { errors: Object.freeze(normalizeResultErrors(errors)) } : {}),
     });
 }
@@ -569,50 +611,6 @@ function normalizeResultErrors(errors) {
         return normalizeExactString(entry, `errors[${String(index)}]`);
     });
 }
-function normalizeUndoRef(value, path) {
-    if (!isRecord(value)) {
-        throw new Error(`Workbook command result ${path} must be an object`);
-    }
-    const id = ownValue(value, 'id');
-    if (typeof id !== 'string') {
-        throw new Error(`Workbook command result ${path}.id must be a string`);
-    }
-    const ops = ownValue(value, 'ops');
-    if (ops !== undefined && !Array.isArray(ops)) {
-        throw new Error(`Workbook command result ${path}.ops must be an array`);
-    }
-    if (Array.isArray(ops)) {
-        const accessorPath = firstAccessorPath(ops, `${path}.ops`);
-        if (accessorPath !== null) {
-            throw new Error(`Workbook command result ${accessorPath} must contain only data properties`);
-        }
-        const normalizedOps = [];
-        for (let index = 0; index < ops.length; index += 1) {
-            const op = arrayDataValue(ops, index);
-            if (op === undefined) {
-                throw new Error(`Workbook command result ${path}.ops[${String(index)}] must contain only data properties`);
-            }
-            normalizedOps.push(normalizeOp(op));
-        }
-        return Object.freeze({
-            id: normalizeExactString(id, `${path}.id`),
-            ops: Object.freeze(normalizedOps),
-        });
-    }
-    return Object.freeze({
-        id: normalizeExactString(id, `${path}.id`),
-    });
-}
-function normalizeOp(value) {
-    if (!isWorkbookOp(value)) {
-        throw new Error('Workbook command result op is invalid');
-    }
-    const cloned = cloneData(value);
-    if (!isWorkbookOp(cloned)) {
-        throw new Error('Workbook command result op clone is invalid');
-    }
-    return freezeData(cloned);
-}
 function normalizeExactString(value, path) {
     const normalized = value.trim();
     if (normalized === '') {
@@ -630,6 +628,16 @@ function arrayDataValue(value, index) {
 function ownValue(value, key) {
     return Object.getOwnPropertyDescriptor(value, key)?.value;
 }
+function ownAccessorKeys(value, keys) {
+    const accessors = [];
+    for (const key of keys) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor !== undefined && !('value' in descriptor)) {
+            accessors.push(key);
+        }
+    }
+    return accessors;
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -639,72 +647,4 @@ function isSafeNonNegativeInteger(value) {
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
-function firstAccessorPath(value, path, seen = new WeakSet()) {
-    if (typeof value !== 'object' || value === null) {
-        return null;
-    }
-    if (seen.has(value)) {
-        return null;
-    }
-    seen.add(value);
-    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
-        const childPath = Array.isArray(value) && /^\d+$/.test(key) ? `${path}[${key}]` : `${path}.${key}`;
-        if (!('value' in descriptor)) {
-            return childPath;
-        }
-        const nestedPath = firstAccessorPath(descriptor.value, childPath, seen);
-        if (nestedPath !== null) {
-            return nestedPath;
-        }
-    }
-    return null;
-}
-function freezeData(value, seen = new WeakSet()) {
-    if (typeof value !== 'object' || value === null) {
-        return value;
-    }
-    if (seen.has(value)) {
-        return value;
-    }
-    seen.add(value);
-    Object.values(Object.getOwnPropertyDescriptors(value)).forEach((descriptor) => {
-        if ('value' in descriptor) {
-            freezeData(descriptor.value, seen);
-        }
-    });
-    return Object.freeze(value);
-}
-function cloneData(value, seen = new WeakMap()) {
-    if (typeof value !== 'object' || value === null) {
-        return value;
-    }
-    const existing = seen.get(value);
-    if (existing !== undefined) {
-        return existing;
-    }
-    if (Array.isArray(value)) {
-        const cloned = [];
-        seen.set(value, cloned);
-        for (let index = 0; index < value.length; index += 1) {
-            const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
-            if (descriptor !== undefined && descriptor.enumerable && 'value' in descriptor) {
-                cloned[index] = cloneData(descriptor.value, seen);
-            }
-        }
-        return cloned;
-    }
-    const cloned = Object.create(Object.getPrototypeOf(value));
-    seen.set(value, cloned);
-    Object.entries(Object.getOwnPropertyDescriptors(value)).forEach(([key, descriptor]) => {
-        if (descriptor.enumerable && 'value' in descriptor) {
-            Object.defineProperty(cloned, key, {
-                configurable: true,
-                enumerable: true,
-                value: cloneData(descriptor.value, seen),
-                writable: true,
-            });
-        }
-    });
-    return cloned;
-}
 //# sourceMappingURL=command-result.js.map