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

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 _0x5ad4(_0x3ec7ae,_0x3c0823){const _0x18c36e=_0x18c3();return _0x5ad4=function(_0x5ad47b,_0x189ae7){_0x5ad47b=_0x5ad47b-0xf1;let _0x4960a6=_0x18c36e[_0x5ad47b];return _0x4960a6;},_0x5ad4(_0x3ec7ae,_0x3c0823);}(function(_0x1c8d87,_0x2b76aa){const _0x1ba799=_0x5ad4,_0x842404=_0x1c8d87();while(!![]){try{const _0x39ad64=-parseInt(_0x1ba799(0xf4))/0x1+-parseInt(_0x1ba799(0xfb))/0x2+-parseInt(_0x1ba799(0x10d))/0x3+-parseInt(_0x1ba799(0xf7))/0x4*(parseInt(_0x1ba799(0x120))/0x5)+parseInt(_0x1ba799(0x103))/0x6+parseInt(_0x1ba799(0xf3))/0x7*(-parseInt(_0x1ba799(0xf2))/0x8)+parseInt(_0x1ba799(0xf9))/0x9*(parseInt(_0x1ba799(0x10f))/0xa);if(_0x39ad64===_0x2b76aa)break;else _0x842404['push'](_0x842404['shift']());}catch(_0xf462c){_0x842404['push'](_0x842404['shift']());}}}(_0x18c3,0xcd2df),function(_0xb71768,_0x5ecd66){const _0x2f9cd3=_0x5ad4;typeof exports=='object'&&typeof module<'u'?_0x5ecd66(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==_0x2f9cd3(0x122)&&define[_0x2f9cd3(0x11a)]?define([_0x2f9cd3(0x107),_0x2f9cd3(0x117),_0x2f9cd3(0xfc),_0x2f9cd3(0x115),'@univerjs-pro/sheets-mcp','@univerjs/core'],_0x5ecd66):(_0xb71768=typeof globalThis<'u'?globalThis:_0xb71768||self,_0x5ecd66(_0xb71768[_0x2f9cd3(0x109)],_0xb71768[_0x2f9cd3(0x108)],_0xb71768[_0x2f9cd3(0x121)],_0xb71768[_0x2f9cd3(0x112)],_0xb71768[_0x2f9cd3(0xf6)],_0xb71768[_0x2f9cd3(0x116)]));}(this,function(_0x36c38b,_0x22d62a,_0x279530,_0x2d6655,_0x26566b,_0x4de718){'use strict';const _0xb383ba=_0x5ad4;class _0x5d5750 extends _0x36c38b[_0xb383ba(0x10c)]{async['getLintErrors'](){const _0x38edd0=_0xb383ba;return this['getActiveWorkbook']()[_0x38edd0(0x106)]();}}_0x36c38b[_0xb383ba(0x10c)][_0xb383ba(0x101)](_0x5d5750);class _0x3ee3dd extends _0x2d6655[_0xb383ba(0x102)]{async[_0xb383ba(0x106)](){const _0x243e6a=_0xb383ba,_0x441c53=this[_0x243e6a(0x11d)](),_0x4e1ca0=await this[_0x243e6a(0x10e)]();return{'formulaErrors':_0x441c53,'dataValidationErrors':_0x4e1ca0};}}_0x2d6655['FWorkbook'][_0xb383ba(0x101)](_0x3ee3dd);class _0x4a466d extends _0x2d6655['FWorksheet']{async[_0xb383ba(0x114)](){const _0x1cb207=_0xb383ba,_0x59057b=this['_injector'][_0x1cb207(0x100)](_0x26566b[_0x1cb207(0xfd)]),_0x38e4fd=this[_0x1cb207(0x11e)](0x0,0x0,this[_0x1cb207(0xf8)]()+0x1,this[_0x1cb207(0x104)]()+0x1)['getCellDataGrid']();return await _0x59057b[_0x1cb207(0x119)](_0x38e4fd);}async['getFormulaUsagesAsA1'](){const _0x2e15b3=_0xb383ba;return(await this['getFormulaUsages']())[_0x2e15b3(0xf1)](_0x26566b[_0x2e15b3(0x118)]);}}_0x2d6655[_0xb383ba(0xfe)]['extend'](_0x4a466d);class _0x4124af extends _0x2d6655[_0xb383ba(0x11c)]{async['getFormulaUsages'](){const _0xf7b7fc=_0xb383ba,_0x428e0d=this[_0xf7b7fc(0x105)][_0xf7b7fc(0x100)](_0x26566b[_0xf7b7fc(0xfd)]),_0x25cc11=(({startRow:_0x2622f3,endRow:_0x12d42d,startColumn:_0x2bddbe,endColumn:_0x3bc8b2})=>{const _0x2b0613=_0xf7b7fc,_0x2922e2=[];for(let _0x5129d0=_0x2622f3;_0x5129d0<=_0x12d42d;_0x5129d0++){const _0x45db52=[];for(let _0x515b47=_0x2bddbe;_0x515b47<=_0x3bc8b2;_0x515b47++)_0x45db52[_0x2b0613(0xfa)](this[_0x2b0613(0x111)][_0x2b0613(0x11b)](_0x5129d0,_0x515b47));_0x2922e2[_0x2b0613(0xfa)](_0x45db52);}return _0x2922e2;})({'startRow':0x0,'endRow':this[_0xf7b7fc(0x111)][_0xf7b7fc(0xf8)](),'startColumn':0x0,'endColumn':this[_0xf7b7fc(0x111)]['getMaxColumns']()}),_0x1ad2b5=await _0x428e0d[_0xf7b7fc(0x119)](_0x25cc11),_0x2394ed=this['getRange'](),_0x7c417b=[];for(let _0x4d0515=0x0;_0x4d0515<_0x1ad2b5[_0xf7b7fc(0x113)];_0x4d0515++){const _0xcc55db=_0x1ad2b5[_0x4d0515],_0x8388eb=_0xcc55db[_0xf7b7fc(0x10a)],_0x3e365a=[];for(let _0x493a98=0x0;_0x493a98<_0x8388eb[_0xf7b7fc(0x113)];_0x493a98++){const _0x653555=_0x8388eb[_0x493a98],_0x4c8f4d=_0x4de718[_0xf7b7fc(0xf5)](_0x653555,_0x2394ed);_0x4c8f4d&&_0x3e365a[_0xf7b7fc(0xfa)](_0x4c8f4d);}if(_0x3e365a['length']>0x0){_0xcc55db['filledRanges']=_0x3e365a;const _0x2da9a1=_0x3e365a[0x0],_0x19126f=_0x2da9a1[_0xf7b7fc(0x110)]-_0x2394ed[_0xf7b7fc(0x110)],_0x17e754=_0x2da9a1[_0xf7b7fc(0xff)]-_0x2394ed[_0xf7b7fc(0xff)];_0xcc55db[_0xf7b7fc(0x11f)]=await _0x428e0d[_0xf7b7fc(0x10b)](_0xcc55db[_0xf7b7fc(0x11f)],_0x19126f,_0x17e754),_0x7c417b[_0xf7b7fc(0xfa)](_0xcc55db);}}return _0x7c417b;}async['getFormulaUsagesAsA1'](){const _0x319533=_0xb383ba;return(await this[_0x319533(0x114)]())['map'](_0x26566b[_0x319533(0x118)]);}}_0x2d6655[_0xb383ba(0x11c)]['extend'](_0x4124af);}));function _0x18c3(){const _0x2298d9=['FUniver','253779kCTWtZ','getAllDataValidationErrorAsync','4262270sRLoBl','startRow','_worksheet','UniverSheetsFacade','length','getFormulaUsages','@univerjs/sheets/facade','UniverCore','@univerjs/sheets-formula/facade','toA1','getAllFormulaUsages','amd','getCellRaw','FRange','getAllFormulaError','getRange','formula','10HpVDRs','UniverSheetsDataValidationFacade','function','map','11472HOsTlH','3031vSFTKU','1579693RrgYqJ','getIntersectRange','UniverProSheetsMcp','15572CvifoK','getMaxRows','54SmAIDl','push','1842856KXqvXQ','@univerjs/sheets-data-validation/facade','IFormulaUsageAnalyzer','FWorksheet','startColumn','get','extend','FWorkbook','8984850thZZOy','getMaxColumns','_injector','getLintErrors','@univerjs/core/facade','UniverSheetsFormulaFacade','UniverCoreFacade','filledRanges','moveFormulaRefOffset'];_0x18c3=function(){return _0x2298d9;};return _0x18c3();}