logisheets 1.4.0 → 1.6.0

package/dist/src/api/workbook.d.ts

@@ -80,6 +80,12 @@ export declare class Workbook {
     registerHeaderUpdatedCallback(callback: (sheetIdxes: readonly number[]) => void): void;
     getSheetNameByIdx(idx: number): Result<string>;
     getAllSheetInfo(): Array<SheetInfo>;
+    /**
+     * Every distinct formula function name used across the workbook (cell
+     * formulas + defined names), read from the parsed ASTs. Uppercased as
+     * stored at parse time, sorted + deduped.
+     */
+    getFormulaFunctionNames(): Result<string[]>;
     checkFormula(f: string): boolean;
     calcCondition(sheetIdx: number, f: string): Result<boolean>;
     /**

package/dist/src/api/workbook.js

@@ -204,6 +204,14 @@ class Workbook {
     getAllSheetInfo() {
         return rpc('getAllSheetInfo', undefined, this._id);
     }
+    /**
+     * Every distinct formula function name used across the workbook (cell
+     * formulas + defined names), read from the parsed ASTs. Uppercased as
+     * stored at parse time, sorted + deduped.
+     */
+    getFormulaFunctionNames() {
+        return rpc('getFormulaFunctionNames', undefined, this._id);
+    }
     checkFormula(f) {
         return rpc('checkFormula', { formula: f }, this._id);
     }

package/dist/src/api/worksheet.d.ts

@@ -1,9 +1,17 @@
-import { BlockInfo, CellPosition, ColInfo, DisplayWindow, DisplayWindowWithStartPoint, RowInfo, Style, Value, CellInfo, SheetDimension, MergeCell, AppendixWithCell, ReproducibleCell, SheetCoordinate, CellInput, Comment, CellImageInfo } from '../bindings';
+import { BlockInfo, CellPosition, ColInfo, DisplayWindow, DisplayWindowWithStartPoint, RowInfo, Style, Value, CellInfo, SheetDimension, MergeCell, AppendixWithCell, ReproducibleCell, SheetCoordinate, CellInput, Comment, CellImageInfo, DependentCell, CellRefRange } from '../bindings';
 import { Cell } from './cell';
 import { Result } from './utils';
 export declare class Worksheet {
     constructor(id: number, sheetIdxOrId: number, isSheetIdx?: boolean);
     getSheetDimension(): Result<SheetDimension>;
+    /**
+     * Cells whose formula references the given range (Excel "trace dependents").
+     * Each result carries the reference (`via`) it used, resolved to a rectangle,
+     * so callers can tell an aggregate/range reference from a single-cell one.
+     */
+    getDependents(startRow: number, startCol: number, endRow: number, endCol: number): Result<DependentCell[]>;
+    /** The ranges/cells a cell's formula references (Excel "trace precedents"). */
+    getPrecedents(row: number, col: number): Result<CellRefRange[]>;
     getDisplayWindow(startRow: number, endRow: number, startCol: number, endCol: number): Result<DisplayWindow>;
     getDisplayWindowWithStartPoint(startX: number, startY: number, height: number, width: number): DisplayWindowWithStartPoint;
     getCellPosition(row: number, col: number): CellPosition;
@@ -22,6 +30,7 @@ export declare class Worksheet {
     getRowInfo(rowIdx: number): Result<RowInfo>;
     getColInfo(colIdx: number): Result<ColInfo>;
     getCellInfo(rowIdx: number, colIdx: number): Result<CellInfo>;
+    getCellListValidation(rowIdx: number, colIdx: number): Result<readonly string[] | undefined>;
     getReproducibleCell(rowIdx: number, colIdx: number): Result<ReproducibleCell>;
     getReproducibleCells(coordinates: readonly SheetCoordinate[]): Result<readonly ReproducibleCell[]>;
     getCellInfos(startRow: number, startCol: number, endRow: number, endCol: number): Result<readonly CellInfo[]>;

package/dist/src/api/worksheet.js

@@ -25,6 +25,18 @@ class Worksheet {
     getSheetDimension() {
         return rpc('getSheetDimension', { sheetId: this._sheetId }, this._id);
     }
+    /**
+     * Cells whose formula references the given range (Excel "trace dependents").
+     * Each result carries the reference (`via`) it used, resolved to a rectangle,
+     * so callers can tell an aggregate/range reference from a single-cell one.
+     */
+    getDependents(startRow, startCol, endRow, endCol) {
+        return rpc('getDependents', { sheetIdx: this._sheetIdx, startRow, startCol, endRow, endCol }, this._id);
+    }
+    /** The ranges/cells a cell's formula references (Excel "trace precedents"). */
+    getPrecedents(row, col) {
+        return rpc('getPrecedents', { sheetIdx: this._sheetIdx, row, col }, this._id);
+    }
     getDisplayWindow(startRow, endRow, startCol, endCol) {
         return rpc('getDisplayWindow', { sheetIdx: this._sheetIdx, startRow, endRow, startCol, endCol }, this._id);
     }
@@ -69,7 +81,12 @@ class Worksheet {
     // Ctrl+Arrow: jump to the next data/block boundary. Returns an
     // ErrorMessage when there is no boundary ahead (caller shows a hint).
     getUpwardDataBoundary(row, col) {
-        return rpc('getDataBoundary', { sheetIdx: this._sheetIdx, rowIdx: row, colIdx: col, direction: 'up' }, this._id);
+        return rpc('getDataBoundary', {
+            sheetIdx: this._sheetIdx,
+            rowIdx: row,
+            colIdx: col,
+            direction: 'up',
+        }, this._id);
     }
     getDownwardDataBoundary(row, col) {
         return rpc('getDataBoundary', {
@@ -116,6 +133,12 @@ class Worksheet {
     getCellInfo(rowIdx, colIdx) {
         return rpc('getCell', { sheetIdx: this._sheetIdx, row: rowIdx, col: colIdx }, this._id);
     }
+    // The enum option set of a cell's list data-validation (inline lists),
+    // or undefined when the cell has no such dropdown. Used by douyoushu to
+    // prefill enum inputs from a workbook's existing dropdowns.
+    getCellListValidation(rowIdx, colIdx) {
+        return rpc('getCellListValidation', { sheetIdx: this._sheetIdx, row: rowIdx, col: colIdx }, this._id);
+    }
     getReproducibleCell(rowIdx, colIdx) {
         return rpc('getReproducibleCell', { sheetIdx: this._sheetIdx, row: rowIdx, col: colIdx }, this._id);
     }

package/dist/src/bindings/cell_ref_range.d.ts

@@ -0,0 +1,9 @@
+export interface CellRefRange {
+    sheetIdx: number;
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+    allRows: boolean;
+    allCols: boolean;
+}

package/dist/src/bindings/cell_ref_range.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/bindings/dependent_cell.d.ts

@@ -0,0 +1,7 @@
+import { CellRefRange } from './cell_ref_range';
+export interface DependentCell {
+    sheetIdx: number;
+    row: number;
+    col: number;
+    via: CellRefRange;
+}

package/dist/src/bindings/dependent_cell.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/bindings/index.d.ts

@@ -37,6 +37,7 @@ export * from './cell_input';
 export * from './cell_position';
 export * from './cell_protection';
 export * from './cell_ref';
+export * from './cell_ref_range';
 export * from './cell_style_update';
 export * from './checkpoint_meta';
 export * from './col_info';
@@ -67,6 +68,7 @@ export * from './delete_comment';
 export * from './delete_rows';
 export * from './delete_rows_in_block';
 export * from './delete_sheet';
+export * from './dependent_cell';
 export * from './display_window';
 export * from './display_window_request';
 export * from './display_window_with_start_point';
@@ -149,12 +151,14 @@ export * from './rpc_get_cells_params';
 export * from './rpc_get_col_width_params';
 export * from './rpc_get_comments_params';
 export * from './rpc_get_data_boundary_params';
+export * from './rpc_get_dependents_params';
 export * from './rpc_get_display_units_of_formula_params';
 export * from './rpc_get_display_window_params';
 export * from './rpc_get_display_window_within_cell_params';
 export * from './rpc_get_diy_cell_id_with_block_id_params';
 export * from './rpc_get_merged_cells_params';
 export * from './rpc_get_next_visible_cell_params';
+export * from './rpc_get_precedents_params';
 export * from './rpc_get_reproducible_cell_params';
 export * from './rpc_get_reproducible_cells_params';
 export * from './rpc_get_row_height_params';

package/dist/src/bindings/index.js

@@ -54,6 +54,7 @@ __exportStar(require("./cell_input"), exports);
 __exportStar(require("./cell_position"), exports);
 __exportStar(require("./cell_protection"), exports);
 __exportStar(require("./cell_ref"), exports);
+__exportStar(require("./cell_ref_range"), exports);
 __exportStar(require("./cell_style_update"), exports);
 __exportStar(require("./checkpoint_meta"), exports);
 __exportStar(require("./col_info"), exports);
@@ -84,6 +85,7 @@ __exportStar(require("./delete_comment"), exports);
 __exportStar(require("./delete_rows"), exports);
 __exportStar(require("./delete_rows_in_block"), exports);
 __exportStar(require("./delete_sheet"), exports);
+__exportStar(require("./dependent_cell"), exports);
 __exportStar(require("./display_window"), exports);
 __exportStar(require("./display_window_request"), exports);
 __exportStar(require("./display_window_with_start_point"), exports);
@@ -166,12 +168,14 @@ __exportStar(require("./rpc_get_cells_params"), exports);
 __exportStar(require("./rpc_get_col_width_params"), exports);
 __exportStar(require("./rpc_get_comments_params"), exports);
 __exportStar(require("./rpc_get_data_boundary_params"), exports);
+__exportStar(require("./rpc_get_dependents_params"), exports);
 __exportStar(require("./rpc_get_display_units_of_formula_params"), exports);
 __exportStar(require("./rpc_get_display_window_params"), exports);
 __exportStar(require("./rpc_get_display_window_within_cell_params"), exports);
 __exportStar(require("./rpc_get_diy_cell_id_with_block_id_params"), exports);
 __exportStar(require("./rpc_get_merged_cells_params"), exports);
 __exportStar(require("./rpc_get_next_visible_cell_params"), exports);
+__exportStar(require("./rpc_get_precedents_params"), exports);
 __exportStar(require("./rpc_get_reproducible_cell_params"), exports);
 __exportStar(require("./rpc_get_reproducible_cells_params"), exports);
 __exportStar(require("./rpc_get_row_height_params"), exports);

package/dist/src/bindings/rpc_get_dependents_params.d.ts

@@ -0,0 +1,7 @@
+export interface GetDependentsParams {
+    sheetIdx: number;
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}

package/dist/src/bindings/rpc_get_dependents_params.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/bindings/rpc_get_precedents_params.d.ts

@@ -0,0 +1,5 @@
+export interface GetPrecedentsParams {
+    sheetIdx: number;
+    row: number;
+    col: number;
+}

package/dist/src/bindings/rpc_get_precedents_params.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/bindings/rpc_workbook_methods.d.ts

@@ -12,10 +12,12 @@ import { CellImageInfo } from './cell_image_info';
 import { CellInfo } from './cell_info';
 import { CellInput } from './cell_input';
 import { CellPosition } from './cell_position';
+import { CellRefRange } from './cell_ref_range';
 import { CheckFormulaParams } from './rpc_check_formula_params';
 import { CheckpointMetaDto } from './checkpoint_meta';
 import { Comment } from './comment';
 import { DeleteCheckpointParams } from './rpc_delete_checkpoint_params';
+import { DependentCell } from './dependent_cell';
 import { DisplayWindow } from './display_window';
 import { DisplayWindowWithStartPoint } from './display_window_with_start_point';
 import { ErrorMessage } from './error_message';
@@ -39,12 +41,14 @@ import { GetCellsParams } from './rpc_get_cells_params';
 import { GetColWidthParams } from './rpc_get_col_width_params';
 import { GetCommentsParams } from './rpc_get_comments_params';
 import { GetDataBoundaryParams } from './rpc_get_data_boundary_params';
+import { GetDependentsParams } from './rpc_get_dependents_params';
 import { GetDisplayUnitsOfFormulaParams } from './rpc_get_display_units_of_formula_params';
 import { GetDisplayWindowParams } from './rpc_get_display_window_params';
 import { GetDisplayWindowWithinCellParams } from './rpc_get_display_window_within_cell_params';
 import { GetDiyCellIdWithBlockIdParams } from './rpc_get_diy_cell_id_with_block_id_params';
 import { GetMergedCellsParams } from './rpc_get_merged_cells_params';
 import { GetNextVisibleCellParams } from './rpc_get_next_visible_cell_params';
+import { GetPrecedentsParams } from './rpc_get_precedents_params';
 import { GetReproducibleCellParams } from './rpc_get_reproducible_cell_params';
 import { GetReproducibleCellsParams } from './rpc_get_reproducible_cells_params';
 import { GetRowHeightParams } from './rpc_get_row_height_params';
@@ -76,7 +80,10 @@ import { ToggleStatusParams } from './rpc_toggle_status_params';
 import { Value } from './value';
 export interface WorkbookMethods {
     getSheetDimension(params: GetSheetDimensionParams, bookId?: number): Promise<SheetDimension | ErrorMessage>;
+    getDependents(params: GetDependentsParams, bookId?: number): Promise<readonly DependentCell[] | ErrorMessage>;
+    getPrecedents(params: GetPrecedentsParams, bookId?: number): Promise<readonly CellRefRange[] | ErrorMessage>;
     getAllSheetInfo(bookId?: number): Promise<readonly SheetInfo[] | ErrorMessage>;
+    getFormulaFunctionNames(bookId?: number): Promise<readonly string[] | ErrorMessage>;
     getSheetIdx(params: GetSheetIdxParams, bookId?: number): Promise<number | ErrorMessage>;
     getSheetId(params: GetSheetIdParams, bookId?: number): Promise<number | ErrorMessage>;
     getSheetNameByIdx(params: GetSheetNameByIdxParams, bookId?: number): Promise<string | ErrorMessage>;

package/dist/wasm/package.json

@@ -3,7 +3,7 @@
   "collaborators": [
     "JeremyHe <yiliang.he@qq.com>"
   ],
-  "version": "1.4.0",
+  "version": "1.6.0",
   "files": [
     "logisheets_wasm_server_bg.wasm",
     "logisheets_wasm_server.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logisheets",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Read and write the xlsx files",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/wasm/package.json

@@ -3,7 +3,7 @@
   "collaborators": [
     "JeremyHe <yiliang.he@qq.com>"
   ],
-  "version": "1.4.0",
+  "version": "1.6.0",
   "files": [
     "logisheets_wasm_server_bg.wasm",
     "logisheets_wasm_server.js",