@components-kit/open-workbook-excel-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Open Workbook contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @components-kit/open-workbook-excel-core
+
+Core workbook utilities for Open Workbook.
+
+It contains:
+
+- A1 range parsing and cell counting
+- stable fingerprints
+- batch compilation
+- backup records
+- snapshot comparison
+- template registry
+- plan manager
+- default permission policy
+
+## Usage
+
+```ts
+import { BatchCompiler, BackupManager, SnapshotManager, TemplateRegistry } from "@components-kit/open-workbook-excel-core";
+```
+
+This package is runtime-agnostic. It does not depend on Office.js and can be reused by future Excel engines.

package/dist/backup-manager.d.ts

@@ -0,0 +1,31 @@
+import { type A1Range, type BackupId, type BackupRef, type OperationId, type WorkbookId } from "@components-kit/open-workbook-protocol";
+export interface BackupRecord extends BackupRef {
+    affectedRanges: A1Range[];
+    retention: "session" | "persistent";
+    payloadRef?: string;
+    payload?: unknown;
+    pinned?: boolean;
+    verifiedAt?: string;
+    restoreStatus?: "available" | "missing" | "checksum_mismatch" | "unsupported";
+}
+export interface CreateBackupInput {
+    workbookId: WorkbookId;
+    kind: BackupRecord["kind"];
+    reason: string;
+    operationId?: OperationId;
+    affectedRanges?: A1Range[];
+    payloadRef?: string;
+    payload?: unknown;
+}
+export declare class BackupManager {
+    private readonly backups;
+    createBackup(input: CreateBackupInput): BackupRecord;
+    listBackups(workbookId: WorkbookId): BackupRecord[];
+    getBackup(backupId: BackupId): BackupRecord | undefined;
+    updateBackup(backupId: BackupId, patch: Partial<BackupRecord>): BackupRecord | undefined;
+    deleteBackup(backupId: BackupId): boolean;
+    load(records: BackupRecord[]): void;
+    dump(): BackupRecord[];
+    assertRollbackAvailable(backupIds: BackupId[]): void;
+}
+//# sourceMappingURL=backup-manager.d.ts.map

package/dist/backup-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-manager.d.ts","sourceRoot":"","sources":["../src/backup-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EAEhB,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,SAAS,EAAE,SAAS,GAAG,YAAY,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,mBAAmB,GAAG,aAAa,CAAC;CAC/E;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY;IAwBpD,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,YAAY,EAAE;IAInD,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS;IAIvD,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,SAAS;IAUxF,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAIzC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAOnC,IAAI,IAAI,YAAY,EAAE;IAItB,uBAAuB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;CAMrD"}

package/dist/backup-manager.js

@@ -0,0 +1,61 @@
+import { makeId } from "@components-kit/open-workbook-protocol";
+export class BackupManager {
+    backups = new Map();
+    createBackup(input) {
+        const backupId = makeId("backup");
+        const record = {
+            backupId,
+            workbookId: input.workbookId,
+            kind: input.kind,
+            createdAt: new Date().toISOString(),
+            reason: input.reason,
+            affectedRanges: input.affectedRanges ?? [],
+            retention: input.kind === "workbook-copy" || input.kind === "file-copy" ? "persistent" : "session"
+        };
+        if (input.operationId !== undefined) {
+            record.operationId = input.operationId;
+        }
+        if (input.payloadRef !== undefined) {
+            record.payloadRef = input.payloadRef;
+        }
+        if (input.payload !== undefined) {
+            record.payload = input.payload;
+        }
+        this.backups.set(backupId, record);
+        return record;
+    }
+    listBackups(workbookId) {
+        return [...this.backups.values()].filter((backup) => backup.workbookId === workbookId);
+    }
+    getBackup(backupId) {
+        return this.backups.get(backupId);
+    }
+    updateBackup(backupId, patch) {
+        const existing = this.backups.get(backupId);
+        if (!existing) {
+            return undefined;
+        }
+        const updated = { ...existing, ...patch, backupId: existing.backupId, workbookId: existing.workbookId };
+        this.backups.set(backupId, updated);
+        return { ...updated };
+    }
+    deleteBackup(backupId) {
+        return this.backups.delete(backupId);
+    }
+    load(records) {
+        this.backups.clear();
+        for (const record of records) {
+            this.backups.set(record.backupId, { ...record });
+        }
+    }
+    dump() {
+        return [...this.backups.values()].map((backup) => ({ ...backup }));
+    }
+    assertRollbackAvailable(backupIds) {
+        const missing = backupIds.filter((backupId) => !this.backups.has(backupId));
+        if (missing.length > 0) {
+            throw new Error(`Missing backup records: ${missing.join(", ")}`);
+        }
+    }
+}
+//# sourceMappingURL=backup-manager.js.map

package/dist/backup-manager.js.map

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

package/dist/batch-compiler.d.ts

@@ -0,0 +1,11 @@
+import type { BatchRequest, CompiledBatch } from "@components-kit/open-workbook-protocol";
+export interface BatchCompilerOptions {
+    now?: () => string;
+}
+export declare class BatchCompiler {
+    private readonly options;
+    constructor(options?: BatchCompilerOptions);
+    compile(request: BatchRequest): CompiledBatch;
+    private now;
+}
+//# sourceMappingURL=batch-compiler.d.ts.map

package/dist/batch-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-compiler.d.ts","sourceRoot":"","sources":["../src/batch-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAId,MAAM,wCAAwC,CAAC;AAYhD,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,oBAAyB;IAE/D,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IA2C7C,OAAO,CAAC,GAAG;CAGZ"}

package/dist/batch-compiler.js

@@ -0,0 +1,103 @@
+import { createRangeFingerprint } from "./fingerprint.js";
+import { cellCount } from "./range-address.js";
+const DESTRUCTIVE_RANK = {
+    none: 0,
+    values: 1,
+    format: 2,
+    structure: 3,
+    workbook: 4
+};
+export class BatchCompiler {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    compile(request) {
+        const requiredBackups = new Set();
+        const targetFingerprints = [];
+        let estimatedCellsTouched = 0;
+        let destructiveLevel = "none";
+        for (const operation of request.operations) {
+            destructiveLevel = maxDestructiveLevel(destructiveLevel, operation.destructiveLevel);
+            if (operation.kind.startsWith("range.")) {
+                requiredBackups.add("region");
+            }
+            if (operation.kind === "sheet.delete") {
+                requiredBackups.add("workbook-copy");
+            }
+            if (operation.kind === "sheet.clear") {
+                requiredBackups.add("sheet");
+            }
+            if (operation.kind === "template.create_sheet_from_template") {
+                requiredBackups.add("sheet");
+                requiredBackups.add("workbook-copy");
+            }
+            if (operation.destructiveLevel === "structure" || operation.destructiveLevel === "workbook") {
+                requiredBackups.add("workbook-copy");
+            }
+            const target = getOperationTarget(operation);
+            if (target) {
+                estimatedCellsTouched += cellCount(target.address);
+                targetFingerprints.push(createRangeFingerprint(target, { pending: operation.kind }, this.now()));
+            }
+        }
+        return {
+            workbookId: request.workbookId,
+            operations: request.operations,
+            requiredBackups: [...requiredBackups],
+            targetFingerprints,
+            estimatedCellsTouched,
+            destructiveLevel
+        };
+    }
+    now() {
+        return this.options.now?.() ?? new Date().toISOString();
+    }
+}
+function maxDestructiveLevel(left, right) {
+    return DESTRUCTIVE_RANK[right] > DESTRUCTIVE_RANK[left] ? right : left;
+}
+function getOperationTarget(operation) {
+    switch (operation.kind) {
+        case "range.read_full":
+        case "range.write_values":
+        case "range.write_formulas":
+        case "range.write_number_formats":
+        case "range.write_styles":
+        case "range.write_hyperlinks":
+        case "range.write_comments":
+        case "range.clear":
+        case "range.clear_values":
+        case "range.clear_formats":
+        case "range.clear_values_keep_format":
+        case "range.insert_rows":
+        case "range.delete_rows":
+        case "range.insert_columns":
+        case "range.delete_columns":
+        case "range.autofit_columns":
+        case "range.autofit_rows":
+        case "range.merge":
+        case "range.unmerge":
+        case "range.restore_snapshot":
+            return operation.target;
+        case "range.copy":
+        case "range.move":
+            return operation.source;
+        case "template.create_sheet_from_template":
+        case "workbook.calculate":
+        case "workbook.save":
+        case "sheet.create":
+        case "sheet.copy":
+        case "sheet.rename":
+        case "sheet.delete":
+        case "sheet.move":
+        case "sheet.hide":
+        case "sheet.unhide":
+        case "sheet.protect":
+        case "sheet.unprotect":
+        case "sheet.clear":
+        case "sheet.set_tab_color":
+            return undefined;
+    }
+}
+//# sourceMappingURL=batch-compiler.js.map

package/dist/batch-compiler.js.map

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

package/dist/chunking.d.ts

@@ -0,0 +1,6 @@
+export interface MatrixRowChunk<T = unknown> {
+    rowOffset: number;
+    rows: T[][];
+}
+export declare function chunkMatrixRows<T>(matrix: T[][], maxCellsPerChunk: number): Array<MatrixRowChunk<T>>;
+//# sourceMappingURL=chunking.d.ts.map

package/dist/chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;CACb;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAiBpG"}

package/dist/chunking.js

@@ -0,0 +1,19 @@
+export function chunkMatrixRows(matrix, maxCellsPerChunk) {
+    if (matrix.length === 0) {
+        return [];
+    }
+    const columnCount = matrix[0]?.length ?? 0;
+    if (columnCount === 0 || matrix.some((row) => row.length !== columnCount)) {
+        throw new Error("Matrix must be rectangular and contain at least one column.");
+    }
+    const rowChunkSize = Math.max(1, Math.floor(maxCellsPerChunk / columnCount));
+    const chunks = [];
+    for (let rowOffset = 0; rowOffset < matrix.length; rowOffset += rowChunkSize) {
+        chunks.push({
+            rowOffset,
+            rows: matrix.slice(rowOffset, rowOffset + rowChunkSize)
+        });
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunking.js.map

package/dist/chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.js","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,eAAe,CAAI,MAAa,EAAE,gBAAwB;IACxE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC3C,IAAI,WAAW,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,YAAY,EAAE,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC;YACV,SAAS;YACT,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/conflicts.d.ts

@@ -0,0 +1,26 @@
+import type { ConflictRecord, ConflictResolutionGuidance, TransactionRollbackConflict, TransactionId, WorkbookId, WorkbookScope } from "@components-kit/open-workbook-protocol";
+export type DependencyConflictCode = "STRUCTURE_CONFLICT" | "TABLE_CONFLICT" | "FORMULA_DEPENDENCY_CONFLICT" | "DERIVED_OBJECT_CONFLICT" | "NAMED_RANGE_CONFLICT" | "LOCK_CONFLICT";
+export interface ClassifiedScopeConflict {
+    code: DependencyConflictCode;
+    message: string;
+    scopes: WorkbookScope[];
+    suggestedAction: "wait_for_lock" | "refresh_plan" | "rebase_plan" | "split_scope" | "manual_review";
+}
+export declare function classifyScopeConflict(left: WorkbookScope, right: WorkbookScope): ClassifiedScopeConflict | undefined;
+export declare function makeLockConflict(input: {
+    workbookId: WorkbookId;
+    left: WorkbookScope;
+    right: WorkbookScope;
+    ownerAgentId?: ConflictRecord["ownerAgentId"];
+    taskId?: ConflictRecord["taskId"];
+    transactionId?: ConflictRecord["transactionId"];
+}): ConflictRecord | undefined;
+export declare function makeRollbackConflict(input: {
+    transactionId: TransactionId;
+    conflictingTransactionId: TransactionId;
+    left: WorkbookScope;
+    right: WorkbookScope;
+}): TransactionRollbackConflict | undefined;
+export declare function makeConflictGuidance(conflict: ConflictRecord): ConflictResolutionGuidance;
+export declare function attachConflictGuidance(conflict: ConflictRecord): ConflictRecord;
+//# sourceMappingURL=conflicts.d.ts.map

package/dist/conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../src/conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,0BAA0B,EAE1B,2BAA2B,EAC3B,aAAa,EACb,UAAU,EACV,aAAa,EACd,MAAM,wCAAwC,CAAC;AAIhD,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,gBAAgB,GAChB,6BAA6B,GAC7B,yBAAyB,GACzB,sBAAsB,GACtB,eAAe,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,EAAE,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC;CACrG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,uBAAuB,GAAG,SAAS,CAWpH;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CACjD,GAAG,cAAc,GAAG,SAAS,CAyB7B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,aAAa,EAAE,aAAa,CAAC;IAC7B,wBAAwB,EAAE,aAAa,CAAC;IACxC,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,2BAA2B,GAAG,SAAS,CAa1C;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,0BAA0B,CA0BzF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAK/E"}

package/dist/conflicts.js

@@ -0,0 +1,269 @@
+import { makeId } from "@components-kit/open-workbook-protocol";
+import { scopesConflict } from "./lock-manager.js";
+export function classifyScopeConflict(left, right) {
+    if (!scopesConflict(left, right)) {
+        return undefined;
+    }
+    const code = conflictCode(left, right);
+    return {
+        code,
+        message: conflictMessage(code, left, right),
+        scopes: [left, right],
+        suggestedAction: code === "LOCK_CONFLICT" ? "wait_for_lock" : "manual_review"
+    };
+}
+export function makeLockConflict(input) {
+    const classified = classifyScopeConflict(input.left, input.right);
+    if (!classified) {
+        return undefined;
+    }
+    const conflict = {
+        conflictId: makeId("conflict"),
+        code: classified.code,
+        message: classified.message,
+        workbookId: input.workbookId,
+        scopes: classified.scopes,
+        retryable: true,
+        suggestedAction: classified.suggestedAction,
+        createdAt: new Date().toISOString()
+    };
+    if (input.ownerAgentId !== undefined) {
+        conflict.ownerAgentId = input.ownerAgentId;
+    }
+    if (input.taskId !== undefined) {
+        conflict.taskId = input.taskId;
+    }
+    if (input.transactionId !== undefined) {
+        conflict.transactionId = input.transactionId;
+    }
+    return conflict;
+}
+export function makeRollbackConflict(input) {
+    const classified = classifyScopeConflict(input.left, input.right);
+    if (!classified) {
+        return undefined;
+    }
+    return {
+        code: rollbackCode(classified.code),
+        message: `Rollback would conflict with later transaction ${input.conflictingTransactionId}: ${classified.message}`,
+        transactionId: input.transactionId,
+        conflictingTransactionId: input.conflictingTransactionId,
+        scopes: classified.scopes,
+        suggestedAction: "manual_review"
+    };
+}
+export function makeConflictGuidance(conflict) {
+    const primaryAction = primaryActionForConflict(conflict);
+    const guidance = {
+        code: conflict.code,
+        severity: severityForConflict(conflict),
+        retryable: conflict.retryable,
+        primaryAction,
+        scopes: conflict.scopes,
+        steps: guidanceSteps(conflict, primaryAction)
+    };
+    if (conflict.lockExpiresAt !== undefined) {
+        guidance.nextRetryAt = conflict.lockExpiresAt;
+    }
+    if (conflict.ownerAgentId !== undefined) {
+        guidance.ownerAgentId = conflict.ownerAgentId;
+    }
+    if (conflict.taskId !== undefined) {
+        guidance.taskId = conflict.taskId;
+    }
+    if (conflict.transactionId !== undefined) {
+        guidance.transactionId = conflict.transactionId;
+    }
+    if (conflict.lockId !== undefined) {
+        guidance.lockId = conflict.lockId;
+    }
+    return guidance;
+}
+export function attachConflictGuidance(conflict) {
+    return {
+        ...conflict,
+        guidance: makeConflictGuidance(conflict)
+    };
+}
+function conflictCode(left, right) {
+    if (left.type === "workbook" || right.type === "workbook" || left.type === "sheet" || right.type === "sheet") {
+        return "STRUCTURE_CONFLICT";
+    }
+    if (left.type === "table" || right.type === "table") {
+        return "TABLE_CONFLICT";
+    }
+    if (left.type === "formula" || right.type === "formula") {
+        return "FORMULA_DEPENDENCY_CONFLICT";
+    }
+    if (left.type === "chart" || left.type === "pivot" || right.type === "chart" || right.type === "pivot") {
+        return "DERIVED_OBJECT_CONFLICT";
+    }
+    if (left.type === "named_range" || right.type === "named_range") {
+        return "NAMED_RANGE_CONFLICT";
+    }
+    if (left.type === "range" && right.type === "range") {
+        return "LOCK_CONFLICT";
+    }
+    return "FORMULA_DEPENDENCY_CONFLICT";
+}
+function rollbackCode(code) {
+    if (code === "FORMULA_DEPENDENCY_CONFLICT" || code === "DERIVED_OBJECT_CONFLICT" || code === "NAMED_RANGE_CONFLICT" || code === "TABLE_CONFLICT") {
+        return "ROLLBACK_DEPENDENCY_CONFLICT";
+    }
+    return "ROLLBACK_CONFLICT";
+}
+function conflictMessage(code, left, right) {
+    switch (code) {
+        case "STRUCTURE_CONFLICT":
+            return `${describeScope(left)} conflicts with workbook or sheet structure scope ${describeScope(right)}.`;
+        case "TABLE_CONFLICT":
+            return `${describeScope(left)} conflicts with table scope ${describeScope(right)}.`;
+        case "DERIVED_OBJECT_CONFLICT":
+            return `${describeScope(left)} conflicts with derived object scope ${describeScope(right)}.`;
+        case "NAMED_RANGE_CONFLICT":
+            return `${describeScope(left)} conflicts with named range scope ${describeScope(right)}.`;
+        case "FORMULA_DEPENDENCY_CONFLICT":
+            return `${describeScope(left)} may affect formula dependencies in ${describeScope(right)}.`;
+        case "LOCK_CONFLICT":
+            return `${describeScope(left)} overlaps ${describeScope(right)}.`;
+    }
+}
+function primaryActionForConflict(conflict) {
+    if (conflict.code === "LOCK_CONFLICT") {
+        return conflict.lockExpiresAt ? "retry_after" : "wait_for_lock";
+    }
+    if (conflict.code === "TARGET_REGION_CHANGED") {
+        return "refresh_plan";
+    }
+    if (conflict.code === "ROLLBACK_CONFLICT" || conflict.code === "ROLLBACK_DEPENDENCY_CONFLICT") {
+        return "preview_rollback_chain";
+    }
+    if (conflict.code === "ROLLBACK_UNAVAILABLE") {
+        return "repair_from_backup";
+    }
+    if (conflict.code === "STRUCTURE_CONFLICT") {
+        return "manual_review";
+    }
+    if (conflict.code === "TABLE_CONFLICT" || conflict.code === "FORMULA_DEPENDENCY_CONFLICT" || conflict.code === "DERIVED_OBJECT_CONFLICT" || conflict.code === "NAMED_RANGE_CONFLICT") {
+        return "handoff_task";
+    }
+    return conflict.suggestedAction;
+}
+function severityForConflict(conflict) {
+    if (!conflict.retryable || conflict.code === "STRUCTURE_CONFLICT" || conflict.code === "ROLLBACK_UNAVAILABLE") {
+        return "blocked";
+    }
+    if (conflict.code === "LOCK_CONFLICT" || conflict.code === "TARGET_REGION_CHANGED") {
+        return "warning";
+    }
+    return "blocked";
+}
+function guidanceSteps(conflict, primaryAction) {
+    const steps = [];
+    if (primaryAction === "retry_after" || primaryAction === "wait_for_lock") {
+        steps.push({
+            action: primaryAction,
+            title: conflict.lockExpiresAt ? "Wait for lock expiry" : "Wait for active lock",
+            description: conflict.lockExpiresAt
+                ? `Retry after ${conflict.lockExpiresAt}, or coordinate with the lock owner if the task is urgent.`
+                : "Wait for the active lock to be released, then evaluate the task schedule again.",
+            toolName: "excel.task.evaluate_schedule",
+            arguments: { workbookId: conflict.workbookId }
+        });
+        if (conflict.lockId !== undefined) {
+            steps.push({
+                action: "renew_or_release_lock",
+                title: "Coordinate lock ownership",
+                description: "Ask the lock owner to renew if still working or release the lock if the reserved work is done.",
+                toolName: "excel.lock.release",
+                arguments: { lockIds: [conflict.lockId] }
+            });
+        }
+    }
+    if (conflict.taskId !== undefined) {
+        steps.push({
+            action: "handoff_task",
+            title: "Coordinate with task owner",
+            description: "Review the owning task before retrying so two agents do not overwrite the same workbook area.",
+            toolName: "excel.task.get",
+            arguments: { taskId: conflict.taskId }
+        });
+    }
+    if (canSuggestSplit(conflict)) {
+        steps.push({
+            action: "split_scope",
+            title: "Split non-overlapping work",
+            description: "Create a narrower task or plan that excludes the conflicting range/table/object scope.",
+            toolName: "excel.task.create",
+            arguments: { workbookId: conflict.workbookId, allowedScopes: conflict.scopes }
+        });
+    }
+    if (primaryAction === "refresh_plan") {
+        steps.push({
+            action: "refresh_plan",
+            title: "Refresh plan preview",
+            description: "Refresh the plan preview and recreate the plan if target fingerprints changed.",
+            toolName: "excel.plan.refresh_preview"
+        });
+    }
+    if (primaryAction === "preview_rollback_chain") {
+        steps.push({
+            action: "preview_rollback_chain",
+            title: "Preview rollback chain",
+            description: "Check whether later dependent transactions must be rolled back together.",
+            toolName: "excel.transaction.preview_rollback_chain",
+            arguments: conflict.transactionId ? { transactionId: conflict.transactionId } : undefined
+        });
+    }
+    if (primaryAction === "repair_from_backup") {
+        steps.push({
+            action: "repair_from_backup",
+            title: "Repair from backup",
+            description: "Use backup or template repair because this conflict cannot be resolved through transaction rollback metadata."
+        });
+    }
+    steps.push({
+        action: "manual_review",
+        title: "Manual review",
+        description: "If scope splitting or waiting is unsafe, ask the user to choose the winning change before applying more workbook mutations."
+    });
+    return dedupeSteps(steps);
+}
+function canSuggestSplit(conflict) {
+    return conflict.scopes.some((scope) => scope.type === "range" || scope.type === "table") && conflict.code !== "STRUCTURE_CONFLICT";
+}
+function dedupeSteps(steps) {
+    const seen = new Set();
+    const deduped = [];
+    for (const step of steps) {
+        const key = `${step.action}:${step.toolName ?? ""}:${JSON.stringify(step.arguments ?? {})}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            deduped.push(step);
+        }
+    }
+    return deduped;
+}
+function describeScope(scope) {
+    switch (scope.type) {
+        case "workbook":
+            return "workbook";
+        case "sheet":
+            return `${scope.sheetName}`;
+        case "range":
+            return `${scope.sheetName}!${scope.address}`;
+        case "formula":
+            return `formulas ${scope.sheetName}${scope.address ? `!${scope.address}` : ""}`;
+        case "table":
+            return `table ${scope.tableName}`;
+        case "named_range":
+            return `named range ${scope.name}`;
+        case "chart":
+            return `chart ${scope.chartName}`;
+        case "pivot":
+            return `pivot ${scope.pivotName}`;
+        case "template":
+            return `template ${scope.templateId}`;
+    }
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/conflicts.js.map

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

package/dist/fingerprint.d.ts

@@ -0,0 +1,6 @@
+import type { A1Range, RangeFingerprint, WorkbookFingerprint, WorkbookId } from "@components-kit/open-workbook-protocol";
+export declare function createRangeFingerprint(range: A1Range, payload: unknown, capturedAt?: string): RangeFingerprint;
+export declare function createWorkbookFingerprint(workbookId: WorkbookId, workbookPayload: unknown, structurePayload: unknown, capturedAt?: string): WorkbookFingerprint;
+export declare function hashStable(value: unknown): string;
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAGzH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,SAA2B,GAAG,gBAAgB,CAOhI;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,OAAO,EACxB,gBAAgB,EAAE,OAAO,EACzB,UAAU,SAA2B,GACpC,mBAAmB,CAOrB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWjD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CActD"}