logisheets 1.5.0 → 1.7.0

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

@@ -1,9 +1,23 @@
-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, LinkInfo } 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[]>;
+    /** Blocks a `colCnt`-wide range can be linked to: same column count and not
+     * already linked. Used by the "link range → block" picker. */
+    getLinkableBlocks(colCnt: number): Result<BlockInfo[]>;
+    /** Ranges on this sheet that are linked to a block, in sheet coordinates.
+     * Used to draw an outer border around each linked source range. */
+    getLinks(): Result<LinkInfo[]>;
     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;

package/dist/src/api/worksheet.js

@@ -25,6 +25,28 @@ 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);
+    }
+    /** Blocks a `colCnt`-wide range can be linked to: same column count and not
+     * already linked. Used by the "link range → block" picker. */
+    getLinkableBlocks(colCnt) {
+        return rpc('getLinkableBlocks', { sheetIdx: this._sheetIdx, colCnt }, this._id);
+    }
+    /** Ranges on this sheet that are linked to a block, in sheet coordinates.
+     * Used to draw an outer border around each linked source range. */
+    getLinks() {
+        return rpc('getLinks', { sheetIdx: this._sheetIdx }, this._id);
+    }
     getDisplayWindow(startRow, endRow, startCol, endCol) {
         return rpc('getDisplayWindow', { sheetIdx: this._sheetIdx, startRow, endRow, startCol, endCol }, this._id);
     }
@@ -69,7 +91,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', {

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/create_link.d.ts

@@ -0,0 +1,30 @@
+export interface CreateLink {
+    sheetIdx: number;
+    masterRow: number;
+    masterCol: number;
+    rowCnt: number;
+    colCnt: number;
+    blockId: number;
+}
+export declare class CreateLinkBuilder {
+    private _sheetIdx;
+    private _masterRow;
+    private _masterCol;
+    private _rowCnt;
+    private _colCnt;
+    private _blockId;
+    sheetIdx(value: number): this;
+    masterRow(value: number): this;
+    masterCol(value: number): this;
+    rowCnt(value: number): this;
+    colCnt(value: number): this;
+    blockId(value: number): this;
+    build(): {
+        sheetIdx: number;
+        masterRow: number;
+        masterCol: number;
+        rowCnt: number;
+        colCnt: number;
+        blockId: number;
+    };
+}

package/dist/src/bindings/create_link.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateLinkBuilder = void 0;
+class CreateLinkBuilder {
+    _sheetIdx;
+    _masterRow;
+    _masterCol;
+    _rowCnt;
+    _colCnt;
+    _blockId;
+    sheetIdx(value) {
+        this._sheetIdx = value;
+        return this;
+    }
+    masterRow(value) {
+        this._masterRow = value;
+        return this;
+    }
+    masterCol(value) {
+        this._masterCol = value;
+        return this;
+    }
+    rowCnt(value) {
+        this._rowCnt = value;
+        return this;
+    }
+    colCnt(value) {
+        this._colCnt = value;
+        return this;
+    }
+    blockId(value) {
+        this._blockId = value;
+        return this;
+    }
+    build() {
+        if (this._sheetIdx === undefined)
+            throw new Error('missing sheetIdx');
+        if (this._masterRow === undefined)
+            throw new Error('missing masterRow');
+        if (this._masterCol === undefined)
+            throw new Error('missing masterCol');
+        if (this._rowCnt === undefined)
+            throw new Error('missing rowCnt');
+        if (this._colCnt === undefined)
+            throw new Error('missing colCnt');
+        if (this._blockId === undefined)
+            throw new Error('missing blockId');
+        return { sheetIdx: this._sheetIdx, masterRow: this._masterRow, masterCol: this._masterCol, rowCnt: this._rowCnt, colCnt: this._colCnt, blockId: this._blockId };
+    }
+}
+exports.CreateLinkBuilder = CreateLinkBuilder;

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/edit_payload.d.ts

@@ -14,6 +14,7 @@ import { CreateAppendix } from './create_appendix';
 import { CreateBlock } from './create_block';
 import { CreateDiyCell } from './create_diy_cell';
 import { CreateDiyCellById } from './create_diy_cell_by_id';
+import { CreateLink } from './create_link';
 import { CreateSheet } from './create_sheet';
 import { DeleteCellImage } from './delete_cell_image';
 import { DeleteCols } from './delete_cols';
@@ -73,6 +74,9 @@ export type EditPayload = {
 } | {
     type: 'convertBlock';
     value: ConvertBlock;
+} | {
+    type: 'createLink';
+    value: CreateLink;
 } | {
     type: 'bindFormSchema';
     value: BindFormSchema;

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';
@@ -51,6 +52,7 @@ export * from './create_appendix';
 export * from './create_block';
 export * from './create_diy_cell';
 export * from './create_diy_cell_by_id';
+export * from './create_link';
 export * from './create_sheet';
 export * from './ct_border';
 export * from './ct_border_pr';
@@ -67,6 +69,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';
@@ -95,6 +98,7 @@ export * from './insert_rows_in_block';
 export * from './int_property';
 export * from './line_format_brush';
 export * from './line_style_update';
+export * from './link_info';
 export * from './merge_cell';
 export * from './merge_cells';
 export * from './modify_policy';
@@ -149,12 +153,16 @@ 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_linkable_blocks_params';
+export * from './rpc_get_links_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);
@@ -68,6 +69,7 @@ __exportStar(require("./create_appendix"), exports);
 __exportStar(require("./create_block"), exports);
 __exportStar(require("./create_diy_cell"), exports);
 __exportStar(require("./create_diy_cell_by_id"), exports);
+__exportStar(require("./create_link"), exports);
 __exportStar(require("./create_sheet"), exports);
 __exportStar(require("./ct_border"), exports);
 __exportStar(require("./ct_border_pr"), exports);
@@ -84,6 +86,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);
@@ -112,6 +115,7 @@ __exportStar(require("./insert_rows_in_block"), exports);
 __exportStar(require("./int_property"), exports);
 __exportStar(require("./line_format_brush"), exports);
 __exportStar(require("./line_style_update"), exports);
+__exportStar(require("./link_info"), exports);
 __exportStar(require("./merge_cell"), exports);
 __exportStar(require("./merge_cells"), exports);
 __exportStar(require("./modify_policy"), exports);
@@ -166,12 +170,16 @@ __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_linkable_blocks_params"), exports);
+__exportStar(require("./rpc_get_links_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/link_info.d.ts

@@ -0,0 +1,8 @@
+export interface LinkInfo {
+    sheetIdx: number;
+    blockId: number;
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}

package/dist/src/bindings/link_info.js

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

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_linkable_blocks_params.d.ts

@@ -0,0 +1,4 @@
+export interface GetLinkableBlocksParams {
+    sheetIdx: number;
+    colCnt: number;
+}

package/dist/src/bindings/rpc_get_linkable_blocks_params.js

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

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

@@ -0,0 +1,3 @@
+export interface GetLinksParams {
+    sheetIdx: number;
+}

package/dist/src/bindings/rpc_get_links_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,16 @@ 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 { GetLinkableBlocksParams } from './rpc_get_linkable_blocks_params';
+import { GetLinksParams } from './rpc_get_links_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';
@@ -57,6 +63,7 @@ import { GetSheetIdParams } from './rpc_get_sheet_id_params';
 import { GetSheetIdxParams } from './rpc_get_sheet_idx_params';
 import { GetSheetNameByIdxParams } from './rpc_get_sheet_name_by_idx_params';
 import { HandleTransactionParams } from './rpc_handle_transaction_params';
+import { LinkInfo } from './link_info';
 import { LoadWorkbookParams } from './rpc_load_workbook_params';
 import { LookupAppendixUpwardParams } from './rpc_lookup_appendix_upward_params';
 import { MergeCell } from './merge_cell';
@@ -76,6 +83,8 @@ 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>;
@@ -109,6 +118,8 @@ export interface WorkbookMethods {
     getAvailableBlockId(params: GetAvailableBlockIdParams, bookId?: number): Promise<number | ErrorMessage>;
     getAllBlockFields(bookId?: number): Promise<readonly BlockField[] | ErrorMessage>;
     getAllBlocks(params: GetAllBlocksParams, bookId?: number): Promise<readonly BlockInfo[] | ErrorMessage>;
+    getLinkableBlocks(params: GetLinkableBlocksParams, bookId?: number): Promise<readonly BlockInfo[] | ErrorMessage>;
+    getLinks(params: GetLinksParams, bookId?: number): Promise<readonly LinkInfo[] | ErrorMessage>;
     saveCheckpoint(params: SaveCheckpointParams, bookId?: number): Promise<number | ErrorMessage>;
     deleteCheckpoint(params: DeleteCheckpointParams, bookId?: number): Promise<boolean | ErrorMessage>;
     listCheckpoints(bookId?: number): Promise<readonly CheckpointMetaDto[] | ErrorMessage>;

package/dist/wasm/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logisheets",
-  "version": "1.5.0",
+  "version": "1.7.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.5.0",
+  "version": "1.7.0",
   "files": [
     "logisheets_wasm_server_bg.wasm",
     "logisheets_wasm_server.js",