logisheets 1.14.0 → 1.14.1

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

@@ -1,4 +1,4 @@
-import { ActionEffect, BlockField, BlockInfo, BlockSortOrder, GetBlockSortOrderParams, MayModifyBlockParams, GetBlockModifyInfoParams, BlockModifyInfo, FormulaDisplayInfo, ShadowCellInfo, SheetCellId, SheetInfo, SaveFileResult, AppData, CellInfo, CellCoordinateWithSheet, Transaction, GetBlockValuesParams, GetCellIdParams, GetShadowCellIdParams, GetShadowCellIdsParams, GetAvailableBlockIdParams, TempStatusDiff, BlockDataRow, CommentMention } from '../bindings';
+import { ActionEffect, BlockField, BlockInfo, BlockSortOrder, GetBlockSortOrderParams, MayModifyBlockParams, CheckFieldValidationParams, FieldValidationVerdict, GetBlockModifyInfoParams, BlockModifyInfo, FormulaDisplayInfo, ShadowCellInfo, SheetCellId, SheetInfo, SaveFileResult, AppData, CellInfo, CellCoordinateWithSheet, Transaction, GetBlockValuesParams, GetCellIdParams, GetShadowCellIdParams, GetShadowCellIdsParams, GetAvailableBlockIdParams, TempStatusDiff, BlockDataRow, CommentMention } from '../bindings';
 import { ColId, RowId } from '../types';
 import { Worksheet } from './worksheet';
 import { CustomFunc } from './calculator';
@@ -184,6 +184,20 @@ export declare class Workbook {
      * come back on `getBlockInfo` if you need to explain the refusal.
      */
     mayModifyBlock(params: MayModifyBlockParams): Result<boolean>;
+    /**
+     * Whether writing `proposed` into this cell would break its field's
+     * validation rule.
+     *
+     * The companion to {@link mayModifyBlock} for `overrideValidation`: that
+     * answers whether this actor may write a violating value, this answers
+     * whether the value in hand is a violating one. A host gating a write
+     * needs both, and needs them BEFORE the write — the marker on the cell
+     * only ever judges a value the cell already holds.
+     *
+     * Reads nothing into the workbook: the rule is evaluated against the
+     * proposed value and the cell is left exactly as it was.
+     */
+    checkFieldValidation(params: CheckFieldValidationParams): Result<FieldValidationVerdict>;
     /**
      * A block's governance metadata on its own — owner, default policy,
      * per-operation overrides, description. `getBlockInfo` carries the same

package/dist/src/api/workbook.js

@@ -439,6 +439,22 @@ class Workbook {
     mayModifyBlock(params) {
         return rpc('mayModifyBlock', params, this._id);
     }
+    /**
+     * Whether writing `proposed` into this cell would break its field's
+     * validation rule.
+     *
+     * The companion to {@link mayModifyBlock} for `overrideValidation`: that
+     * answers whether this actor may write a violating value, this answers
+     * whether the value in hand is a violating one. A host gating a write
+     * needs both, and needs them BEFORE the write — the marker on the cell
+     * only ever judges a value the cell already holds.
+     *
+     * Reads nothing into the workbook: the rule is evaluated against the
+     * proposed value and the cell is left exactly as it was.
+     */
+    checkFieldValidation(params) {
+        return rpc('checkFieldValidation', params, this._id);
+    }
     /**
      * A block's governance metadata on its own — owner, default policy,
      * per-operation overrides, description. `getBlockInfo` carries the same

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

@@ -1 +1 @@
-export type BlockOp = 'insertDeleteLines' | 'removeBlock' | 'modifySchema' | 'cellInput' | 'sortByField' | 'modifyDescription';
+export type BlockOp = 'insertDeleteLines' | 'removeBlock' | 'modifySchema' | 'cellInput' | 'sortByField' | 'modifyDescription' | 'overrideValidation';

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

@@ -6,6 +6,7 @@ export interface BlockPermissions {
     cellInput?: ModifyPolicy;
     sortByField?: ModifyPolicy;
     modifyDescription?: ModifyPolicy;
+    overrideValidation?: ModifyPolicy;
 }
 export declare class BlockPermissionsBuilder {
     private _insertDeleteLines?;
@@ -14,12 +15,14 @@ export declare class BlockPermissionsBuilder {
     private _cellInput?;
     private _sortByField?;
     private _modifyDescription?;
+    private _overrideValidation?;
     insertDeleteLines(value: ModifyPolicy): this;
     removeBlock(value: ModifyPolicy): this;
     modifySchema(value: ModifyPolicy): this;
     cellInput(value: ModifyPolicy): this;
     sortByField(value: ModifyPolicy): this;
     modifyDescription(value: ModifyPolicy): this;
+    overrideValidation(value: ModifyPolicy): this;
     build(): {
         insertDeleteLines: ModifyPolicy | undefined;
         removeBlock: ModifyPolicy | undefined;
@@ -27,5 +30,6 @@ export declare class BlockPermissionsBuilder {
         cellInput: ModifyPolicy | undefined;
         sortByField: ModifyPolicy | undefined;
         modifyDescription: ModifyPolicy | undefined;
+        overrideValidation: ModifyPolicy | undefined;
     };
 }

package/dist/src/bindings/block_permissions.js

@@ -8,6 +8,7 @@ class BlockPermissionsBuilder {
     _cellInput;
     _sortByField;
     _modifyDescription;
+    _overrideValidation;
     insertDeleteLines(value) {
         this._insertDeleteLines = value;
         return this;
@@ -32,8 +33,12 @@ class BlockPermissionsBuilder {
         this._modifyDescription = value;
         return this;
     }
+    overrideValidation(value) {
+        this._overrideValidation = value;
+        return this;
+    }
     build() {
-        return { insertDeleteLines: this._insertDeleteLines, removeBlock: this._removeBlock, modifySchema: this._modifySchema, cellInput: this._cellInput, sortByField: this._sortByField, modifyDescription: this._modifyDescription };
+        return { insertDeleteLines: this._insertDeleteLines, removeBlock: this._removeBlock, modifySchema: this._modifySchema, cellInput: this._cellInput, sortByField: this._sortByField, modifyDescription: this._modifyDescription, overrideValidation: this._overrideValidation };
     }
 }
 exports.BlockPermissionsBuilder = BlockPermissionsBuilder;

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

@@ -0,0 +1,6 @@
+export interface CheckFieldValidationParams {
+    sheetIdx: number;
+    row: number;
+    col: number;
+    proposed: string;
+}

package/dist/src/bindings/check_field_validation_params.js

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

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

@@ -0,0 +1,5 @@
+export interface FieldValidationVerdict {
+    hasRule: boolean;
+    violates: boolean;
+    rule: string;
+}

package/dist/src/bindings/field_validation_verdict.js

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

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

@@ -57,6 +57,7 @@ export * from './chart_data_labels_info';
 export * from './chart_info';
 export * from './chart_of_pie_split_info';
 export * from './chart_series_info';
+export * from './check_field_validation_params';
 export * from './checkpoint_meta';
 export * from './col_info';
 export * from './color';
@@ -105,6 +106,7 @@ export * from './ephemeral_cell_remove';
 export * from './ephemeral_cell_style_update';
 export * from './error_message';
 export * from './field_render_entry';
+export * from './field_validation_verdict';
 export * from './fill';
 export * from './font';
 export * from './font_family';

package/dist/src/bindings/index.js

@@ -74,6 +74,7 @@ __exportStar(require("./chart_data_labels_info"), exports);
 __exportStar(require("./chart_info"), exports);
 __exportStar(require("./chart_of_pie_split_info"), exports);
 __exportStar(require("./chart_series_info"), exports);
+__exportStar(require("./check_field_validation_params"), exports);
 __exportStar(require("./checkpoint_meta"), exports);
 __exportStar(require("./col_info"), exports);
 __exportStar(require("./color"), exports);
@@ -122,6 +123,7 @@ __exportStar(require("./ephemeral_cell_remove"), exports);
 __exportStar(require("./ephemeral_cell_style_update"), exports);
 __exportStar(require("./error_message"), exports);
 __exportStar(require("./field_render_entry"), exports);
+__exportStar(require("./field_validation_verdict"), exports);
 __exportStar(require("./fill"), exports);
 __exportStar(require("./font"), exports);
 __exportStar(require("./font_family"), exports);

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

@@ -17,6 +17,7 @@ import { CellPosition } from './cell_position';
 import { CellRefRange } from './cell_ref_range';
 import { CfRuleInfo } from './cf_rule_info';
 import { ChartInfo } from './chart_info';
+import { CheckFieldValidationParams } from './check_field_validation_params';
 import { CheckFormulaParams } from './rpc_check_formula_params';
 import { CheckpointMetaDto } from './checkpoint_meta';
 import { Comment } from './comment';
@@ -26,6 +27,7 @@ import { DisplayWindow } from './display_window';
 import { DisplayWindowWithStartPoint } from './display_window_with_start_point';
 import { ErrorMessage } from './error_message';
 import { ExportBlockDataParams } from './rpc_export_block_data_params';
+import { FieldValidationVerdict } from './field_validation_verdict';
 import { FormulaDisplayInfo } from './formula_display_info';
 import { GetAllBlocksParams } from './rpc_get_all_blocks_params';
 import { GetAvailableBlockIdParams } from './rpc_get_available_block_id_params';
@@ -126,6 +128,7 @@ export interface WorkbookMethods {
     getBlockValues(params: GetBlockValuesParams, bookId?: number): Promise<readonly string[] | ErrorMessage>;
     getBlockSortOrder(params: GetBlockSortOrderParams, bookId?: number): Promise<BlockSortOrder | ErrorMessage>;
     mayModifyBlock(params: MayModifyBlockParams, bookId?: number): Promise<boolean | ErrorMessage>;
+    checkFieldValidation(params: CheckFieldValidationParams, bookId?: number): Promise<FieldValidationVerdict | ErrorMessage>;
     getBlockModifyInfo(params: GetBlockModifyInfoParams, bookId?: number): Promise<BlockModifyInfo | ErrorMessage>;
     getAvailableBlockId(params: GetAvailableBlockIdParams, bookId?: number): Promise<number | ErrorMessage>;
     getAllBlockFields(bookId?: number): Promise<readonly BlockField[] | ErrorMessage>;

package/dist/wasm/logisheets_wasm_server.d.ts

@@ -1,15 +1,11 @@
 /* tslint:disable */
 /* eslint-disable */
+export function handle(msg: any, book_id?: number | null): any;
 /**
  * Render a text value with an Excel number-format code (for the `@` text
  * section). Falls back to the text itself on an unsupported format.
  */
 export function format_text(fmt: string, text: string): string;
-/**
- * Input: AsyncFuncResult
- * Output: ActionAffect
- */
-export function input_async_result(id: number, result: any): any;
 /**
  * Render a number with an Excel number-format code, natively via `ssf-rs`
  * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
@@ -17,4 +13,8 @@ export function input_async_result(id: number, result: any): any;
  * JavaScript `String(value)` representation, matching the previous behavior.
  */
 export function format_number(fmt: string, value: number): string;
-export function handle(msg: any, book_id?: number | null): any;
+/**
+ * Input: AsyncFuncResult
+ * Output: ActionAffect
+ */
+export function input_async_result(id: number, result: any): any;

package/dist/wasm/logisheets_wasm_server.js

@@ -170,6 +170,16 @@ function debugString(val) {
     // TODO we could test for more things here, like `Set`s and `Map`s.
     return className;
 }
+/**
+ * @param {any} msg
+ * @param {number | null} [book_id]
+ * @returns {any}
+ */
+module.exports.handle = function(msg, book_id) {
+    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
+    return ret;
+};
+
 /**
  * Render a text value with an Excel number-format code (for the `@` text
  * section). Falls back to the text itself on an unsupported format.
@@ -194,18 +204,6 @@ module.exports.format_text = function(fmt, text) {
     }
 };
 
-/**
- * Input: AsyncFuncResult
- * Output: ActionAffect
- * @param {number} id
- * @param {any} result
- * @returns {any}
- */
-module.exports.input_async_result = function(id, result) {
-    const ret = wasm.input_async_result(id, result);
-    return ret;
-};
-
 /**
  * Render a number with an Excel number-format code, natively via `ssf-rs`
  * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
@@ -231,12 +229,14 @@ module.exports.format_number = function(fmt, value) {
 };
 
 /**
- * @param {any} msg
- * @param {number | null} [book_id]
+ * Input: AsyncFuncResult
+ * Output: ActionAffect
+ * @param {number} id
+ * @param {any} result
  * @returns {any}
  */
-module.exports.handle = function(msg, book_id) {
-    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
+module.exports.input_async_result = function(id, result) {
+    const ret = wasm.input_async_result(id, result);
     return ret;
 };
 

package/dist/wasm/logisheets_wasm_server_bg.wasm.d.ts

@@ -1,10 +1,10 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const handle: (a: any, b: number) => any;
 export const format_number: (a: number, b: number, c: number) => [number, number];
 export const format_text: (a: number, b: number, c: number, d: number) => [number, number];
 export const input_async_result: (a: number, b: any) => any;
-export const handle: (a: any, b: number) => any;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/dist/wasm/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logisheets",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "description": "Node.js bindings for LogiSheets — a Rust + WebAssembly spreadsheet engine that reads, edits, and writes real .xlsx (Excel) files (formulas, styles, and structure preserved) with no browser required.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/wasm/logisheets_wasm_server.d.ts

@@ -1,15 +1,11 @@
 /* tslint:disable */
 /* eslint-disable */
+export function handle(msg: any, book_id?: number | null): any;
 /**
  * Render a text value with an Excel number-format code (for the `@` text
  * section). Falls back to the text itself on an unsupported format.
  */
 export function format_text(fmt: string, text: string): string;
-/**
- * Input: AsyncFuncResult
- * Output: ActionAffect
- */
-export function input_async_result(id: number, result: any): any;
 /**
  * Render a number with an Excel number-format code, natively via `ssf-rs`
  * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
@@ -17,4 +13,8 @@ export function input_async_result(id: number, result: any): any;
  * JavaScript `String(value)` representation, matching the previous behavior.
  */
 export function format_number(fmt: string, value: number): string;
-export function handle(msg: any, book_id?: number | null): any;
+/**
+ * Input: AsyncFuncResult
+ * Output: ActionAffect
+ */
+export function input_async_result(id: number, result: any): any;

package/wasm/logisheets_wasm_server.js

@@ -170,6 +170,16 @@ function debugString(val) {
     // TODO we could test for more things here, like `Set`s and `Map`s.
     return className;
 }
+/**
+ * @param {any} msg
+ * @param {number | null} [book_id]
+ * @returns {any}
+ */
+module.exports.handle = function(msg, book_id) {
+    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
+    return ret;
+};
+
 /**
  * Render a text value with an Excel number-format code (for the `@` text
  * section). Falls back to the text itself on an unsupported format.
@@ -194,18 +204,6 @@ module.exports.format_text = function(fmt, text) {
     }
 };
 
-/**
- * Input: AsyncFuncResult
- * Output: ActionAffect
- * @param {number} id
- * @param {any} result
- * @returns {any}
- */
-module.exports.input_async_result = function(id, result) {
-    const ret = wasm.input_async_result(id, result);
-    return ret;
-};
-
 /**
  * Render a number with an Excel number-format code, natively via `ssf-rs`
  * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
@@ -231,12 +229,14 @@ module.exports.format_number = function(fmt, value) {
 };
 
 /**
- * @param {any} msg
- * @param {number | null} [book_id]
+ * Input: AsyncFuncResult
+ * Output: ActionAffect
+ * @param {number} id
+ * @param {any} result
  * @returns {any}
  */
-module.exports.handle = function(msg, book_id) {
-    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
+module.exports.input_async_result = function(id, result) {
+    const ret = wasm.input_async_result(id, result);
     return ret;
 };
 

package/wasm/logisheets_wasm_server_bg.wasm.d.ts

@@ -1,10 +1,10 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const handle: (a: any, b: number) => any;
 export const format_number: (a: number, b: number, c: number) => [number, number];
 export const format_text: (a: number, b: number, c: number, d: number) => [number, number];
 export const input_async_result: (a: number, b: any) => any;
-export const handle: (a: any, b: number) => any;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/wasm/package.json

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