@univerjs-pro/sheets-mcp 0.10.14-nightly.202511031023 → 0.10.14-nightly.202511070640

package/lib/types/controllers/config.schema.d.ts

@@ -1,5 +1,7 @@
 export declare const SHEET_MCP_PLUGIN_CONFIG_KEY = "sheet-mcp.config";
 export declare const configSymbol: unique symbol;
 export interface IUniverSheetMCPConfig {
+    /** Whether to enable worker mode */
+    enableWorker?: boolean;
 }
 export declare const defaultPluginConfig: IUniverSheetMCPConfig;

package/lib/types/facade/f-range.d.ts

@@ -0,0 +1,41 @@
+import { IFormulaUsage, IFormulaUsageAsA1 } from '@univerjs-pro/sheets-mcp';
+import { FRange } from '@univerjs/sheets/facade';
+/**
+ * @ignore
+ */
+export interface IFRangeSheetsMCP {
+    /**
+     * Get all formula usages in the range
+     * @returns A promise that resolves to an array of formula usages
+     *
+     * @example
+     * ```ts
+     * const workbook = univerAPI.getActiveWorkbook()
+     * const sheet = workbook.getActiveSheet()
+     * const range = sheet.getRangeByA1('A1:C10')
+     * const usages = await range.getFormulaUsages();
+     * ```
+     */
+    getFormulaUsages(): Promise<IFormulaUsage[]>;
+    /**
+     * Get all formula usages in the range in A1 notation
+     * @returns A promise that resolves to an array of formula usages in A1 notation
+     *
+     * @example
+     * ```ts
+     * const workbook = univerAPI.getActiveWorkbook()
+     * const sheet = workbook.getActiveSheet()
+     * const range = sheet.getRangeByA1('A1:C10')
+     * const usagesA1 = await range.getFormulaUsagesAsA1();
+     * ```
+     */
+    getFormulaUsagesAsA1(): Promise<IFormulaUsageAsA1[]>;
+}
+export declare class FRangeSheetsMCP extends FRange implements IFRangeSheetsMCP {
+    getFormulaUsages(): Promise<IFormulaUsage[]>;
+    getFormulaUsagesAsA1(): Promise<IFormulaUsageAsA1[]>;
+}
+declare module '@univerjs/sheets/facade' {
+    interface FRange extends IFRangeSheetsMCP {
+    }
+}

package/lib/types/facade/f-univer.d.ts

@@ -1,16 +1,14 @@
-import { ISheetFormulaError } from '@univerjs/engine-formula';
-import { IDataValidationError } from '@univerjs/sheets-data-validation/facade';
+import { ILintErrorReport } from './f-workbook';
 import { FUniver } from '@univerjs/core/facade';
 import '@univerjs/sheets-formula/facade';
 import '@univerjs/sheets-data-validation/facade';
-interface ILintErrorReport {
-    formulaErrors: ISheetFormulaError[];
-    dataValidationErrors: IDataValidationError[];
-}
 /**
  * @ignore
  */
 export interface IFUniverLintMCP {
+    /**
+     * @deprecated use {@link FWorkbookSheetsMCP.getLintErrors} instead.
+     */
     getLintErrors(): Promise<ILintErrorReport>;
 }
 export declare class FUniverLintMCPMixin extends FUniver implements IFUniverLintMCP {
@@ -20,4 +18,3 @@ declare module '@univerjs/core/facade' {
     interface FUniver extends IFUniverLintMCP {
     }
 }
-export {};

package/lib/types/facade/f-workbook.d.ts

@@ -0,0 +1,30 @@
+import { ISheetFormulaError } from '@univerjs/engine-formula';
+import { IDataValidationError } from '@univerjs/sheets-data-validation/facade';
+import { FWorkbook } from '@univerjs/sheets/facade';
+export interface ILintErrorReport {
+    formulaErrors: ISheetFormulaError[];
+    dataValidationErrors: IDataValidationError[];
+}
+/**
+ * @ignore
+ */
+export interface IFWorkbookSheetsMCPMixin {
+    /**
+     * Get lint errors report including formula errors and data validation errors
+     *
+     * @example
+     * ```ts
+     * const workbook = univerAPI.getActiveWorkbook()
+     * const lintErrors = await workbook.getLintErrors();
+     * console.log(lintErrors.formulaErrors, lintErrors.dataValidationErrors);
+     * ```
+     */
+    getLintErrors(): Promise<ILintErrorReport>;
+}
+export declare class FWorkbookSheetsMCPMixin extends FWorkbook implements IFWorkbookSheetsMCPMixin {
+    getLintErrors(): Promise<ILintErrorReport>;
+}
+declare module '@univerjs/sheets/facade' {
+    interface FWorkbook extends IFWorkbookSheetsMCPMixin {
+    }
+}

package/lib/types/facade/f-worksheet.d.ts

@@ -0,0 +1,39 @@
+import { IFormulaUsage, IFormulaUsageAsA1 } from '@univerjs-pro/sheets-mcp';
+import { FWorksheet } from '@univerjs/sheets/facade';
+/**
+ * @ignore
+ */
+export interface IFWorksheetSheetsMCP {
+    /**
+     * Get all formula usages in the worksheet
+     * @returns A promise that resolves to an array of formula usages
+     *
+     * @example
+     * ```ts
+     * const workbook = univerAPI.getActiveWorkbook()
+     * const sheet = workbook.getActiveSheet()
+     * const usages = await sheet.getFormulaUsages();
+     * ```
+     */
+    getFormulaUsages(): Promise<IFormulaUsage[]>;
+    /**
+     * Get all formula usages in the worksheet in A1 notation
+     * @returns A promise that resolves to an array of formula usages in A1 notation
+     *
+     * @example
+     * ```ts
+     * const workbook = univerAPI.getActiveWorkbook()
+     * const sheet = workbook.getActiveSheet()
+     * const usagesA1 = await sheet.getFormulaUsagesAsA1();
+     * ```
+     */
+    getFormulaUsagesAsA1(): Promise<IFormulaUsageAsA1[]>;
+}
+export declare class FWorksheetSheetsMCP extends FWorksheet implements IFWorksheetSheetsMCP {
+    getFormulaUsages(): Promise<IFormulaUsage[]>;
+    getFormulaUsagesAsA1(): Promise<IFormulaUsageAsA1[]>;
+}
+declare module '@univerjs/sheets/facade' {
+    interface FWorksheet extends IFWorksheetSheetsMCP {
+    }
+}

package/lib/types/facade/index.d.ts

@@ -1 +1,4 @@
 import './f-univer';
+import './f-workbook';
+import './f-worksheet';
+import './f-range';

package/lib/types/index.d.ts

@@ -1,2 +1,3 @@
 export { UniverSheetMCPPlugin } from './plugin';
+export { type IFormulaUsage, IFormulaUsageAnalyzer, type IFormulaUsageAsA1, toA1 } from './services/formula-analysis.service';
 export * from './tools';

package/lib/types/services/formula-analysis.service.d.ts

@@ -0,0 +1,53 @@
+import { ICellData, IRange, Nullable } from '@univerjs/core';
+import { ICalculateFormulaService, LexerTreeBuilder } from '@univerjs/engine-formula';
+/**
+ * Interface for formula usage information
+ */
+export interface IFormulaUsage {
+    /**
+     * The formula's first occurrence location
+     */
+    formula: string;
+    /**
+     * The formula's first occurrence cell range
+     */
+    firstOccurrence: IRange;
+    /**
+     * The filled ranges of the formula, including the first occurrence
+     */
+    filledRanges: IRange[];
+}
+/**
+ * Interface for formula usage information in A1 notation
+ */
+export interface IFormulaUsageAsA1 {
+    /**
+     * The formula's first occurrence location
+     */
+    formula: string;
+    /**
+     * The formula's first occurrence cell range in A1 notation
+     */
+    firstOccurrence: string;
+    /**
+     * The filled ranges of the formula in A1 notation, including the first occurrence
+     */
+    filledRanges: string;
+}
+export declare function toA1(usage: IFormulaUsage): IFormulaUsageAsA1;
+/**
+ * Convert rectangle coordinates to A1 notation
+ * @param param0 [r1, r2, c1, c2]
+ * @returns A1 notation string
+ */
+export declare function getA1Notation([r1, r2, c1, c2]: [number, number, number, number]): string;
+export declare const FormulaUsageAnalyzerChannelName = "sheets.mcp.formula-usage-analyzer";
+export declare const IFormulaUsageAnalyzer: import('@wendellhu/redi').IdentifierDecorator<FormulaUsageAnalyzer>;
+export declare class FormulaUsageAnalyzer {
+    protected _formulaService: ICalculateFormulaService;
+    private _lexerTreeBuilder;
+    constructor(_formulaService: ICalculateFormulaService, _lexerTreeBuilder: LexerTreeBuilder);
+    getAllFormulaUsages(data: Nullable<ICellData>[][]): IFormulaUsage[];
+    getFormulaHash(formulaString: string, refOffsetX: number, refOffsetY: number, ignoreAbsolute?: boolean): string;
+    moveFormulaRefOffset(formula: string, refOffsetX: number, refOffsetY: number, ignoreAbsolute?: boolean): string;
+}

package/lib/types/tools/conditional-format-tools.d.ts

@@ -11,20 +11,20 @@ export declare const ZodConditionalFormatRuleSchema: z.ZodObject<{
         colorScale: "colorScale";
     }>>;
     min_type: z.ZodOptional<z.ZodEnum<{
-        formula: "formula";
-        num: "num";
+        percent: "percent";
         min: "min";
         max: "max";
-        percent: "percent";
+        formula: "formula";
+        num: "num";
         percentile: "percentile";
     }>>;
     min_value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     max_type: z.ZodOptional<z.ZodEnum<{
-        formula: "formula";
-        num: "num";
+        percent: "percent";
         min: "min";
         max: "max";
-        percent: "percent";
+        formula: "formula";
+        num: "num";
         percentile: "percentile";
     }>>;
     max_value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -38,11 +38,11 @@ export declare const ZodConditionalFormatRuleSchema: z.ZodObject<{
         index: z.ZodNumber;
         color: z.ZodString;
         value_type: z.ZodEnum<{
-            formula: "formula";
-            num: "num";
+            percent: "percent";
             min: "min";
             max: "max";
-            percent: "percent";
+            formula: "formula";
+            num: "num";
             percentile: "percentile";
         }>;
         value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -50,12 +50,12 @@ export declare const ZodConditionalFormatRuleSchema: z.ZodObject<{
     sub_type: z.ZodOptional<z.ZodEnum<{
         number: "number";
         text: "text";
+        formula: "formula";
         uniqueValues: "uniqueValues";
         duplicateValues: "duplicateValues";
         rank: "rank";
         timePeriod: "timePeriod";
         average: "average";
-        formula: "formula";
     }>>;
     operator: z.ZodOptional<z.ZodEnum<{
         endsWith: "endsWith";

package/lib/types/tools/formula-utils.d.ts

@@ -0,0 +1 @@
+export declare function extractFormulas(univerAPI: any, sheets?: string[]): Promise<string>;

package/lib/umd/facade.js

@@ -1 +1 @@
-function _0x3e23(){const _0x2f2fb3=['@univerjs/sheets-formula/facade','28lgvfTA','3222667cFpKaj','19842eyVxrR','895Fasgne','4631121zcsmOq','function','@univerjs/sheets-data-validation/facade','getAllFormulaError','4kYhpux','20328048rBdSuq','getLintErrors','224766RHoxbv','UniverCoreFacade','@univerjs/core/facade','getActiveWorkbook','8GJmZFS','199929QDFrJo','35120lmWiMQ','object','FUniver','13Uewzse','amd','extend','1760hwqChk'];_0x3e23=function(){return _0x2f2fb3;};return _0x3e23();}function _0xabc3(_0x1084b8,_0x1a8a05){const _0x3e23e2=_0x3e23();return _0xabc3=function(_0xabc3da,_0xc2e3d1){_0xabc3da=_0xabc3da-0x17d;let _0x376552=_0x3e23e2[_0xabc3da];return _0x376552;},_0xabc3(_0x1084b8,_0x1a8a05);}(function(_0x366e10,_0x164182){const _0x207728=_0xabc3,_0x16d4ef=_0x366e10();while(!![]){try{const _0x131244=parseInt(_0x207728(0x181))/0x1*(parseInt(_0x207728(0x192))/0x2)+-parseInt(_0x207728(0x195))/0x3*(parseInt(_0x207728(0x18a))/0x4)+-parseInt(_0x207728(0x18d))/0x5*(-parseInt(_0x207728(0x18c))/0x6)+parseInt(_0x207728(0x18b))/0x7*(parseInt(_0x207728(0x180))/0x8)+parseInt(_0x207728(0x18e))/0x9+parseInt(_0x207728(0x182))/0xa*(parseInt(_0x207728(0x188))/0xb)+-parseInt(_0x207728(0x193))/0xc*(parseInt(_0x207728(0x185))/0xd);if(_0x131244===_0x164182)break;else _0x16d4ef['push'](_0x16d4ef['shift']());}catch(_0x464b7d){_0x16d4ef['push'](_0x16d4ef['shift']());}}}(_0x3e23,0x4bbcf),function(_0x209c21,_0x5dee5f){const _0x37b9d9=_0xabc3;typeof exports==_0x37b9d9(0x183)&&typeof module<'u'?_0x5dee5f(require('@univerjs/core/facade'),require('@univerjs/sheets-formula/facade'),require('@univerjs/sheets-data-validation/facade')):typeof define==_0x37b9d9(0x18f)&&define[_0x37b9d9(0x186)]?define([_0x37b9d9(0x17e),_0x37b9d9(0x189),_0x37b9d9(0x190)],_0x5dee5f):(_0x209c21=typeof globalThis<'u'?globalThis:_0x209c21||self,_0x5dee5f(_0x209c21[_0x37b9d9(0x17d)]));}(this,function(_0x175fce){'use strict';const _0x3ca421=_0xabc3;class _0x6e5202 extends _0x175fce[_0x3ca421(0x184)]{async[_0x3ca421(0x194)](){const _0x58cdb7=_0x3ca421,_0xd85fcc=this[_0x58cdb7(0x17f)](),_0x1c8722=_0xd85fcc[_0x58cdb7(0x191)](),_0xc44e44=await _0xd85fcc['getAllDataValidationErrorAsync']();return{'formulaErrors':_0x1c8722,'dataValidationErrors':_0xc44e44};}}_0x175fce['FUniver'][_0x3ca421(0x187)](_0x6e5202);}));
+function _0x20ad(){const _0x4beccc=['UniverCore','IFormulaUsageAnalyzer','moveFormulaRefOffset','40jufQLX','getMaxColumns','toA1','_worksheet','getLintErrors','@univerjs/core','length','2345WgFigF','get','103584GpaFOh','691036mrCsqO','_injector','getMaxRows','getAllFormulaError','4132584KqBVBW','@univerjs/sheets-data-validation/facade','UniverCoreFacade','object','1200529iWHMWE','push','formula','@univerjs-pro/sheets-mcp','filledRanges','2007140tvaKLt','3924QAmngZ','@univerjs/sheets-formula/facade','getCellRaw','FWorkbook','@univerjs/sheets/facade','FUniver','extend','@univerjs/core/facade','getAllDataValidationErrorAsync','FWorksheet','map','110bzCJPy','2860371WVyrtR','startRow','startColumn','1PasBVZ','UniverSheetsFacade','getAllFormulaUsages','getFormulaUsagesAsA1','amd','30yGIAjc','FRange','UniverSheetsFormulaFacade','getFormulaUsages','getActiveWorkbook','5190YaESbO','getIntersectRange','getRange'];_0x20ad=function(){return _0x4beccc;};return _0x20ad();}function _0x471d(_0x103c45,_0x438de8){const _0x20ade1=_0x20ad();return _0x471d=function(_0x471d5a,_0x49f6f5){_0x471d5a=_0x471d5a-0x73;let _0x157a78=_0x20ade1[_0x471d5a];return _0x157a78;},_0x471d(_0x103c45,_0x438de8);}(function(_0x1eb168,_0x451d6e){const _0x42e286=_0x471d,_0x5d966d=_0x1eb168();while(!![]){try{const _0x482dd9=parseInt(_0x42e286(0x90))/0x1*(-parseInt(_0x42e286(0x80))/0x2)+parseInt(_0x42e286(0x77))/0x3+-parseInt(_0x42e286(0x73))/0x4*(-parseInt(_0x42e286(0x95))/0x5)+-parseInt(_0x42e286(0x9a))/0x6*(parseInt(_0x42e286(0xa7))/0x7)+-parseInt(_0x42e286(0xa0))/0x8*(parseInt(_0x42e286(0x8d))/0x9)+-parseInt(_0x42e286(0x8c))/0xa*(parseInt(_0x42e286(0x7b))/0xb)+-parseInt(_0x42e286(0x81))/0xc*(-parseInt(_0x42e286(0xa9))/0xd);if(_0x482dd9===_0x451d6e)break;else _0x5d966d['push'](_0x5d966d['shift']());}catch(_0x1999ce){_0x5d966d['push'](_0x5d966d['shift']());}}}(_0x20ad,0xe4ac9),function(_0x29f575,_0x555049){const _0xd7b3e6=_0x471d;typeof exports==_0xd7b3e6(0x7a)&&typeof module<'u'?_0x555049(require('@univerjs/core/facade'),require('@univerjs/sheets-formula/facade'),require('@univerjs/sheets-data-validation/facade'),require('@univerjs/sheets/facade'),require('@univerjs-pro/sheets-mcp'),require('@univerjs/core')):typeof define=='function'&&define[_0xd7b3e6(0x94)]?define([_0xd7b3e6(0x88),_0xd7b3e6(0x82),_0xd7b3e6(0x78),_0xd7b3e6(0x85),_0xd7b3e6(0x7e),_0xd7b3e6(0xa5)],_0x555049):(_0x29f575=typeof globalThis<'u'?globalThis:_0x29f575||self,_0x555049(_0x29f575[_0xd7b3e6(0x79)],_0x29f575[_0xd7b3e6(0x97)],_0x29f575['UniverSheetsDataValidationFacade'],_0x29f575[_0xd7b3e6(0x91)],_0x29f575['UniverProSheetsMcp'],_0x29f575[_0xd7b3e6(0x9d)]));}(this,function(_0x12346d,_0x3cb679,_0xb712c4,_0xb9d576,_0x2d3631,_0x5edae6){'use strict';const _0x45c74e=_0x471d;class _0x41e5de extends _0x12346d[_0x45c74e(0x86)]{async[_0x45c74e(0xa4)](){const _0x80020f=_0x45c74e;return this[_0x80020f(0x99)]()[_0x80020f(0xa4)]();}}_0x12346d[_0x45c74e(0x86)][_0x45c74e(0x87)](_0x41e5de);class _0x5d37dd extends _0xb9d576[_0x45c74e(0x84)]{async[_0x45c74e(0xa4)](){const _0x16d4f0=_0x45c74e,_0xd9711d=this[_0x16d4f0(0x76)](),_0x37b2ab=await this[_0x16d4f0(0x89)]();return{'formulaErrors':_0xd9711d,'dataValidationErrors':_0x37b2ab};}}_0xb9d576[_0x45c74e(0x84)][_0x45c74e(0x87)](_0x5d37dd);class _0x46b6a3 extends _0xb9d576[_0x45c74e(0x8a)]{async['getFormulaUsages'](){const _0x4716d3=_0x45c74e,_0x1b5ce6=this[_0x4716d3(0x74)][_0x4716d3(0xa8)](_0x2d3631[_0x4716d3(0x9e)]),_0x303725=this[_0x4716d3(0x9c)](0x0,0x0,this[_0x4716d3(0x75)]()+0x1,this[_0x4716d3(0xa1)]()+0x1)['getCellDataGrid']();return await _0x1b5ce6[_0x4716d3(0x92)](_0x303725);}async['getFormulaUsagesAsA1'](){const _0x3c71a9=_0x45c74e;return(await this[_0x3c71a9(0x98)]())[_0x3c71a9(0x8b)](_0x2d3631[_0x3c71a9(0xa2)]);}}_0xb9d576[_0x45c74e(0x8a)]['extend'](_0x46b6a3);class _0x98d1d4 extends _0xb9d576[_0x45c74e(0x96)]{async[_0x45c74e(0x98)](){const _0x237f64=_0x45c74e,_0x187034=this[_0x237f64(0x74)][_0x237f64(0xa8)](_0x2d3631[_0x237f64(0x9e)]),_0x4e42c3=(({startRow:_0x55c4a7,endRow:_0x183044,startColumn:_0x314594,endColumn:_0x148cdc})=>{const _0x2a28f9=_0x237f64,_0x42f956=[];for(let _0x680943=_0x55c4a7;_0x680943<=_0x183044;_0x680943++){const _0x3f4cfd=[];for(let _0x813d2=_0x314594;_0x813d2<=_0x148cdc;_0x813d2++)_0x3f4cfd[_0x2a28f9(0x7c)](this[_0x2a28f9(0xa3)][_0x2a28f9(0x83)](_0x680943,_0x813d2));_0x42f956[_0x2a28f9(0x7c)](_0x3f4cfd);}return _0x42f956;})({'startRow':0x0,'endRow':this[_0x237f64(0xa3)][_0x237f64(0x75)](),'startColumn':0x0,'endColumn':this[_0x237f64(0xa3)][_0x237f64(0xa1)]()}),_0x1abd15=await _0x187034[_0x237f64(0x92)](_0x4e42c3),_0x39e7ac=this['getRange'](),_0x48baeb=[];for(let _0x30eaca=0x0;_0x30eaca<_0x1abd15['length'];_0x30eaca++){const _0x119389=_0x1abd15[_0x30eaca],_0x19fd83=_0x119389[_0x237f64(0x7f)],_0x3d0936=[];for(let _0x495932=0x0;_0x495932<_0x19fd83[_0x237f64(0xa6)];_0x495932++){const _0x1ae29f=_0x19fd83[_0x495932],_0x37fec3=_0x5edae6[_0x237f64(0x9b)](_0x1ae29f,_0x39e7ac);_0x37fec3&&_0x3d0936[_0x237f64(0x7c)](_0x37fec3);}if(_0x3d0936[_0x237f64(0xa6)]>0x0){_0x119389[_0x237f64(0x7f)]=_0x3d0936;const _0x28b8b5=_0x3d0936[0x0],_0x411efe=_0x28b8b5[_0x237f64(0x8e)]-_0x39e7ac[_0x237f64(0x8e)],_0x24d59a=_0x28b8b5[_0x237f64(0x8f)]-_0x39e7ac[_0x237f64(0x8f)];_0x119389['formula']=await _0x187034[_0x237f64(0x9f)](_0x119389[_0x237f64(0x7d)],_0x411efe,_0x24d59a),_0x48baeb['push'](_0x119389);}}return _0x48baeb;}async[_0x45c74e(0x93)](){const _0x95b58b=_0x45c74e;return(await this[_0x95b58b(0x98)]())[_0x95b58b(0x8b)](_0x2d3631[_0x95b58b(0xa2)]);}}_0xb9d576[_0x45c74e(0x96)]['extend'](_0x98d1d4);}));