logisheets 1.10.0 → 1.12.0

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

@@ -127,8 +127,21 @@ export declare class Workbook {
     batchGetCellCoordinateWithSheetById(ids: readonly SheetCellId[]): Result<readonly CellCoordinateWithSheet[]>;
     execTransaction(tx: Transaction): ActionEffect;
     load(buf: Uint8Array, bookName: string): ReturnCode;
-    save(data: string): SaveFileResult;
+    /**
+     * Serialize to .xlsx bytes.
+     *
+     * `resolveBlockRefs` writes block formulas as ordinary A1 references
+     * instead of `BLOCKREF(...)`. Off by default: the named form is readable
+     * and reopens here intact, but no other spreadsheet knows those functions,
+     * so a file Excel must recalculate needs the coordinates. One-way — a
+     * resolved `BLOCKREFS` becomes a plain range, which LogiSheets does not
+     * parse back when it straddles a block.
+     */
+    save(data: string, resolveBlockRefs?: boolean): SaveFileResult;
     getAppData(): readonly AppData[];
+    /** Monotonic counter bumped on every committed write — snapshot it to
+     *  detect concurrent modification (optimistic concurrency). */
+    getVersion(): number;
     release(): void;
     getSheetCount(): number;
     getWorksheet(idx: number): Worksheet;

package/dist/src/api/workbook.js

@@ -302,7 +302,7 @@ class Workbook {
         rpc('commitTempStatus', undefined, this._id);
     }
     cleanupTempStatus() {
-        rpc('cleanTempStatus', undefined, this._id);
+        rpc('cleanupTempStatus', undefined, this._id);
     }
     toggleStatus(useTemp) {
         rpc('toggleStatus', { useTemp }, this._id);
@@ -365,12 +365,27 @@ class Workbook {
     load(buf, bookName) {
         return rpc('loadWorkbook', { content: Array.from(buf), name: bookName }, this._id);
     }
-    save(data) {
-        return rpc('saveWorkbook', { appData: data }, this._id);
+    /**
+     * Serialize to .xlsx bytes.
+     *
+     * `resolveBlockRefs` writes block formulas as ordinary A1 references
+     * instead of `BLOCKREF(...)`. Off by default: the named form is readable
+     * and reopens here intact, but no other spreadsheet knows those functions,
+     * so a file Excel must recalculate needs the coordinates. One-way — a
+     * resolved `BLOCKREFS` becomes a plain range, which LogiSheets does not
+     * parse back when it straddles a block.
+     */
+    save(data, resolveBlockRefs = false) {
+        return rpc('saveWorkbook', { appData: data, resolveBlockRefs }, this._id);
     }
     getAppData() {
         return rpc('getAppData', undefined, this._id);
     }
+    /** Monotonic counter bumped on every committed write — snapshot it to
+     *  detect concurrent modification (optimistic concurrency). */
+    getVersion() {
+        return rpc('getVersion', undefined, this._id);
+    }
     release() {
         rpc('release', undefined, this._id);
     }

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

@@ -1,4 +1,4 @@
-import { BlockInfo, CellPosition, ColInfo, DisplayWindow, DisplayWindowWithStartPoint, RowInfo, Style, Value, CellInfo, SheetDimension, MergeCell, AppendixWithCell, ReproducibleCell, SheetCoordinate, CellInput, Comment, CellImageInfo, ChartInfo, DependentCell, CellRefRange, LinkInfo } from '../bindings';
+import { BlockInfo, CellPosition, ColInfo, DisplayWindow, DisplayWindowWithStartPoint, RowInfo, Style, Value, CellInfo, SheetDimension, MergeCell, AppendixWithCell, ReproducibleCell, SheetCoordinate, CellInput, Comment, CellImageInfo, ChartInfo, CfRuleInfo, DependentCell, CellRefRange, LinkInfo } from '../bindings';
 import { Cell } from './cell';
 import { Result } from './utils';
 export declare class Worksheet {
@@ -91,6 +91,16 @@ export declare class Worksheet {
      * anchor and re-reads live values from the source ranges.
      */
     getCharts(): Result<ChartInfo[]>;
+    /**
+     * Every conditional-formatting rule on this sheet, in `priority` order —
+     * the order they are applied, and the order a rule manager lists them in.
+     *
+     * Each rule's `spec` is the same shape the create/update payloads accept, so
+     * a UI can load one into an editor and send it straight back. `ruleId` is
+     * session-scoped: it is re-minted when the file is reloaded, so it must not
+     * be persisted.
+     */
+    getConditionalFormattingRules(): Result<CfRuleInfo[]>;
     getFullyCoveredBlocks(rowIdx: number, colIdx: number, rowCnt: number, colCnt: number): Result<BlockInfo[]>;
     private _id;
     private _sheetId;

package/dist/src/api/worksheet.js

@@ -260,6 +260,18 @@ class Worksheet {
     getCharts() {
         return rpc('getCharts', { sheetIdx: this._sheetIdx }, this._id);
     }
+    /**
+     * Every conditional-formatting rule on this sheet, in `priority` order —
+     * the order they are applied, and the order a rule manager lists them in.
+     *
+     * Each rule's `spec` is the same shape the create/update payloads accept, so
+     * a UI can load one into an editor and send it straight back. `ruleId` is
+     * session-scoped: it is re-minted when the file is reloaded, so it must not
+     * be persisted.
+     */
+    getConditionalFormattingRules() {
+        return rpc('getConditionalFormattingRules', { sheetIdx: this._sheetIdx }, this._id);
+    }
     getFullyCoveredBlocks(rowIdx, colIdx, rowCnt, colCnt) {
         return rpc('getFullyCoveredBlocks', {
             sheetId: this._sheetId,

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

@@ -17,6 +17,7 @@ export interface ActionEffect {
     colRemoved: readonly SheetColId[];
     colUpdated: readonly SheetColId[];
     headerUpdated: readonly number[];
+    errorMessage?: string;
 }
 export declare class ActionEffectBuilder {
     private _version;
@@ -32,6 +33,7 @@ export declare class ActionEffectBuilder {
     private _colRemoved;
     private _colUpdated;
     private _headerUpdated;
+    private _errorMessage?;
     version(value: number): this;
     asyncTasks(value: readonly Task[]): this;
     status(value: StatusCode): this;
@@ -45,6 +47,7 @@ export declare class ActionEffectBuilder {
     colRemoved(value: readonly SheetColId[]): this;
     colUpdated(value: readonly SheetColId[]): this;
     headerUpdated(value: readonly number[]): this;
+    errorMessage(value: string): this;
     build(): {
         version: number;
         asyncTasks: readonly Task[];
@@ -59,5 +62,6 @@ export declare class ActionEffectBuilder {
         colRemoved: readonly SheetColId[];
         colUpdated: readonly SheetColId[];
         headerUpdated: readonly number[];
+        errorMessage: string | undefined;
     };
 }

package/dist/src/bindings/action_effect.js

@@ -15,6 +15,7 @@ class ActionEffectBuilder {
     _colRemoved;
     _colUpdated;
     _headerUpdated;
+    _errorMessage;
     version(value) {
         this._version = value;
         return this;
@@ -67,6 +68,10 @@ class ActionEffectBuilder {
         this._headerUpdated = value;
         return this;
     }
+    errorMessage(value) {
+        this._errorMessage = value;
+        return this;
+    }
     build() {
         if (this._version === undefined)
             throw new Error('missing version');
@@ -94,7 +99,7 @@ class ActionEffectBuilder {
             throw new Error('missing colUpdated');
         if (this._headerUpdated === undefined)
             throw new Error('missing headerUpdated');
-        return { version: this._version, asyncTasks: this._asyncTasks, status: this._status, valueChanged: this._valueChanged, cellRemoved: this._cellRemoved, styleChanged: this._styleChanged, rowInserted: this._rowInserted, rowRemoved: this._rowRemoved, rowUpdated: this._rowUpdated, colInserted: this._colInserted, colRemoved: this._colRemoved, colUpdated: this._colUpdated, headerUpdated: this._headerUpdated };
+        return { version: this._version, asyncTasks: this._asyncTasks, status: this._status, valueChanged: this._valueChanged, cellRemoved: this._cellRemoved, styleChanged: this._styleChanged, rowInserted: this._rowInserted, rowRemoved: this._rowRemoved, rowUpdated: this._rowUpdated, colInserted: this._colInserted, colRemoved: this._colRemoved, colUpdated: this._colUpdated, headerUpdated: this._headerUpdated, errorMessage: this._errorMessage };
     }
 }
 exports.ActionEffectBuilder = ActionEffectBuilder;

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

@@ -1,3 +1,4 @@
+import { ConditionalFormat } from './conditional_format';
 import { Style } from './style';
 import { Value } from './value';
 export interface CellInfo {
@@ -7,4 +8,5 @@ export interface CellInfo {
     blockId?: number;
     diyCellId?: number;
     validationShadow?: Value;
+    conditionalFormat?: ConditionalFormat;
 }

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

@@ -0,0 +1,6 @@
+import { Color } from './color';
+export interface CfDataBar {
+    color: Color;
+    fraction: number;
+    showValue: boolean;
+}

package/dist/src/bindings/cf_data_bar.js

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

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

@@ -0,0 +1,26 @@
+export interface CfFormatSpec {
+    fillColor?: string;
+    fontColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    strike?: boolean;
+}
+export declare class CfFormatSpecBuilder {
+    private _fillColor?;
+    private _fontColor?;
+    private _bold?;
+    private _italic?;
+    private _strike?;
+    fillColor(value: string): this;
+    fontColor(value: string): this;
+    bold(value: boolean): this;
+    italic(value: boolean): this;
+    strike(value: boolean): this;
+    build(): {
+        fillColor: string | undefined;
+        fontColor: string | undefined;
+        bold: boolean | undefined;
+        italic: boolean | undefined;
+        strike: boolean | undefined;
+    };
+}

package/dist/src/bindings/cf_format_spec.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CfFormatSpecBuilder = void 0;
+class CfFormatSpecBuilder {
+    _fillColor;
+    _fontColor;
+    _bold;
+    _italic;
+    _strike;
+    fillColor(value) {
+        this._fillColor = value;
+        return this;
+    }
+    fontColor(value) {
+        this._fontColor = value;
+        return this;
+    }
+    bold(value) {
+        this._bold = value;
+        return this;
+    }
+    italic(value) {
+        this._italic = value;
+        return this;
+    }
+    strike(value) {
+        this._strike = value;
+        return this;
+    }
+    build() {
+        return { fillColor: this._fillColor, fontColor: this._fontColor, bold: this._bold, italic: this._italic, strike: this._strike };
+    }
+}
+exports.CfFormatSpecBuilder = CfFormatSpecBuilder;

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

@@ -0,0 +1,6 @@
+export interface CfIcon {
+    set: string;
+    index: number;
+    count: number;
+    showValue: boolean;
+}

package/dist/src/bindings/cf_icon.js

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

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

@@ -0,0 +1,9 @@
+import { CfRuleSpec } from './cf_rule_spec';
+import { Style } from './style';
+export interface CfRuleInfo {
+    ruleId: number;
+    range: string;
+    priority: number;
+    spec: CfRuleSpec;
+    preview?: Style;
+}

package/dist/src/bindings/cf_rule_info.js

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

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

@@ -0,0 +1,71 @@
+import { CfFormatSpec } from './cf_format_spec';
+export interface CfRuleSpec {
+    ty: string;
+    operator?: string;
+    operands: readonly string[];
+    text?: string;
+    timePeriod?: string;
+    rank?: number;
+    percent: boolean;
+    bottom: boolean;
+    aboveAverage: boolean;
+    equalAverage: boolean;
+    stdDev?: number;
+    colors: readonly string[];
+    iconSet?: string;
+    reverse: boolean;
+    stopIfTrue: boolean;
+    format?: CfFormatSpec;
+}
+export declare class CfRuleSpecBuilder {
+    private _ty;
+    private _operator?;
+    private _operands;
+    private _text?;
+    private _timePeriod?;
+    private _rank?;
+    private _percent;
+    private _bottom;
+    private _aboveAverage;
+    private _equalAverage;
+    private _stdDev?;
+    private _colors;
+    private _iconSet?;
+    private _reverse;
+    private _stopIfTrue;
+    private _format?;
+    ty(value: string): this;
+    operator(value: string): this;
+    operands(value: readonly string[]): this;
+    text(value: string): this;
+    timePeriod(value: string): this;
+    rank(value: number): this;
+    percent(value: boolean): this;
+    bottom(value: boolean): this;
+    aboveAverage(value: boolean): this;
+    equalAverage(value: boolean): this;
+    stdDev(value: number): this;
+    colors(value: readonly string[]): this;
+    iconSet(value: string): this;
+    reverse(value: boolean): this;
+    stopIfTrue(value: boolean): this;
+    format(value: CfFormatSpec): this;
+    build(): {
+        ty: string;
+        operator: string | undefined;
+        operands: readonly string[];
+        text: string | undefined;
+        timePeriod: string | undefined;
+        rank: number | undefined;
+        percent: boolean;
+        bottom: boolean;
+        aboveAverage: boolean;
+        equalAverage: boolean;
+        stdDev: number | undefined;
+        colors: readonly string[];
+        iconSet: string | undefined;
+        reverse: boolean;
+        stopIfTrue: boolean;
+        format: CfFormatSpec | undefined;
+    };
+}

package/dist/src/bindings/cf_rule_spec.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CfRuleSpecBuilder = void 0;
+class CfRuleSpecBuilder {
+    _ty;
+    _operator;
+    _operands;
+    _text;
+    _timePeriod;
+    _rank;
+    _percent;
+    _bottom;
+    _aboveAverage;
+    _equalAverage;
+    _stdDev;
+    _colors;
+    _iconSet;
+    _reverse;
+    _stopIfTrue;
+    _format;
+    ty(value) {
+        this._ty = value;
+        return this;
+    }
+    operator(value) {
+        this._operator = value;
+        return this;
+    }
+    operands(value) {
+        this._operands = value;
+        return this;
+    }
+    text(value) {
+        this._text = value;
+        return this;
+    }
+    timePeriod(value) {
+        this._timePeriod = value;
+        return this;
+    }
+    rank(value) {
+        this._rank = value;
+        return this;
+    }
+    percent(value) {
+        this._percent = value;
+        return this;
+    }
+    bottom(value) {
+        this._bottom = value;
+        return this;
+    }
+    aboveAverage(value) {
+        this._aboveAverage = value;
+        return this;
+    }
+    equalAverage(value) {
+        this._equalAverage = value;
+        return this;
+    }
+    stdDev(value) {
+        this._stdDev = value;
+        return this;
+    }
+    colors(value) {
+        this._colors = value;
+        return this;
+    }
+    iconSet(value) {
+        this._iconSet = value;
+        return this;
+    }
+    reverse(value) {
+        this._reverse = value;
+        return this;
+    }
+    stopIfTrue(value) {
+        this._stopIfTrue = value;
+        return this;
+    }
+    format(value) {
+        this._format = value;
+        return this;
+    }
+    build() {
+        if (this._ty === undefined)
+            throw new Error('missing ty');
+        if (this._operands === undefined)
+            throw new Error('missing operands');
+        if (this._percent === undefined)
+            throw new Error('missing percent');
+        if (this._bottom === undefined)
+            throw new Error('missing bottom');
+        if (this._aboveAverage === undefined)
+            throw new Error('missing aboveAverage');
+        if (this._equalAverage === undefined)
+            throw new Error('missing equalAverage');
+        if (this._colors === undefined)
+            throw new Error('missing colors');
+        if (this._reverse === undefined)
+            throw new Error('missing reverse');
+        if (this._stopIfTrue === undefined)
+            throw new Error('missing stopIfTrue');
+        return { ty: this._ty, operator: this._operator, operands: this._operands, text: this._text, timePeriod: this._timePeriod, rank: this._rank, percent: this._percent, bottom: this._bottom, aboveAverage: this._aboveAverage, equalAverage: this._equalAverage, stdDev: this._stdDev, colors: this._colors, iconSet: this._iconSet, reverse: this._reverse, stopIfTrue: this._stopIfTrue, format: this._format };
+    }
+}
+exports.CfRuleSpecBuilder = CfRuleSpecBuilder;

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

@@ -0,0 +1,9 @@
+import { CfDataBar } from './cf_data_bar';
+import { CfIcon } from './cf_icon';
+import { Style } from './style';
+export interface ConditionalFormat {
+    style: Style;
+    scale?: number;
+    dataBar?: CfDataBar;
+    icon?: CfIcon;
+}

package/dist/src/bindings/conditional_format.js

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

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

@@ -0,0 +1,31 @@
+import { CfRuleSpec } from './cf_rule_spec';
+export interface CreateConditionalFormattingRule {
+    sheetIdx: number;
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+    rule: CfRuleSpec;
+}
+export declare class CreateConditionalFormattingRuleBuilder {
+    private _sheetIdx;
+    private _startRow;
+    private _startCol;
+    private _endRow;
+    private _endCol;
+    private _rule;
+    sheetIdx(value: number): this;
+    startRow(value: number): this;
+    startCol(value: number): this;
+    endRow(value: number): this;
+    endCol(value: number): this;
+    rule(value: CfRuleSpec): this;
+    build(): {
+        sheetIdx: number;
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+        rule: CfRuleSpec;
+    };
+}

package/dist/src/bindings/create_conditional_formatting_rule.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateConditionalFormattingRuleBuilder = void 0;
+class CreateConditionalFormattingRuleBuilder {
+    _sheetIdx;
+    _startRow;
+    _startCol;
+    _endRow;
+    _endCol;
+    _rule;
+    sheetIdx(value) {
+        this._sheetIdx = value;
+        return this;
+    }
+    startRow(value) {
+        this._startRow = value;
+        return this;
+    }
+    startCol(value) {
+        this._startCol = value;
+        return this;
+    }
+    endRow(value) {
+        this._endRow = value;
+        return this;
+    }
+    endCol(value) {
+        this._endCol = value;
+        return this;
+    }
+    rule(value) {
+        this._rule = value;
+        return this;
+    }
+    build() {
+        if (this._sheetIdx === undefined)
+            throw new Error('missing sheetIdx');
+        if (this._startRow === undefined)
+            throw new Error('missing startRow');
+        if (this._startCol === undefined)
+            throw new Error('missing startCol');
+        if (this._endRow === undefined)
+            throw new Error('missing endRow');
+        if (this._endCol === undefined)
+            throw new Error('missing endCol');
+        if (this._rule === undefined)
+            throw new Error('missing rule');
+        return { sheetIdx: this._sheetIdx, startRow: this._startRow, startCol: this._startCol, endRow: this._endRow, endCol: this._endCol, rule: this._rule };
+    }
+}
+exports.CreateConditionalFormattingRuleBuilder = CreateConditionalFormattingRuleBuilder;

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

@@ -0,0 +1,14 @@
+export interface DeleteConditionalFormattingRule {
+    sheetIdx: number;
+    ruleId: number;
+}
+export declare class DeleteConditionalFormattingRuleBuilder {
+    private _sheetIdx;
+    private _ruleId;
+    sheetIdx(value: number): this;
+    ruleId(value: number): this;
+    build(): {
+        sheetIdx: number;
+        ruleId: number;
+    };
+}

package/dist/src/bindings/delete_conditional_formatting_rule.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteConditionalFormattingRuleBuilder = void 0;
+class DeleteConditionalFormattingRuleBuilder {
+    _sheetIdx;
+    _ruleId;
+    sheetIdx(value) {
+        this._sheetIdx = value;
+        return this;
+    }
+    ruleId(value) {
+        this._ruleId = value;
+        return this;
+    }
+    build() {
+        if (this._sheetIdx === undefined)
+            throw new Error('missing sheetIdx');
+        if (this._ruleId === undefined)
+            throw new Error('missing ruleId');
+        return { sheetIdx: this._sheetIdx, ruleId: this._ruleId };
+    }
+}
+exports.DeleteConditionalFormattingRuleBuilder = DeleteConditionalFormattingRuleBuilder;

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

@@ -13,6 +13,7 @@ import { ConvertBlock } from './convert_block';
 import { CreateAppendix } from './create_appendix';
 import { CreateBlock } from './create_block';
 import { CreateChart } from './create_chart';
+import { CreateConditionalFormattingRule } from './create_conditional_formatting_rule';
 import { CreateDiyCell } from './create_diy_cell';
 import { CreateDiyCellById } from './create_diy_cell_by_id';
 import { CreateLink } from './create_link';
@@ -22,6 +23,7 @@ import { DeleteChart } from './delete_chart';
 import { DeleteCols } from './delete_cols';
 import { DeleteColsInBlock } from './delete_cols_in_block';
 import { DeleteComment } from './delete_comment';
+import { DeleteConditionalFormattingRule } from './delete_conditional_formatting_rule';
 import { DeleteRows } from './delete_rows';
 import { DeleteRowsInBlock } from './delete_rows_in_block';
 import { DeleteSheet } from './delete_sheet';
@@ -39,6 +41,7 @@ import { MergeCells } from './merge_cells';
 import { MoveBlock } from './move_block';
 import { MoveBlockLine } from './move_block_line';
 import { MoveChart } from './move_chart';
+import { MoveConditionalFormattingRule } from './move_conditional_formatting_rule';
 import { RemoveAppendix } from './remove_appendix';
 import { RemoveBlock } from './remove_block';
 import { RemoveDiyCell } from './remove_diy_cell';
@@ -57,6 +60,7 @@ import { SetVisible } from './set_visible';
 import { SheetRename } from './sheet_rename';
 import { SplitMergedCells } from './split_merged_cells';
 import { UpdateChart } from './update_chart';
+import { UpdateConditionalFormattingRule } from './update_conditional_formatting_rule';
 import { UpsertFieldFormulas } from './upsert_field_formulas';
 import { UpsertFieldRenderInfo } from './upsert_field_render_info';
 import { UpsertPerson } from './upsert_person';
@@ -162,6 +166,18 @@ export type EditPayload = {
 } | {
     type: 'moveChart';
     value: MoveChart;
+} | {
+    type: 'createConditionalFormattingRule';
+    value: CreateConditionalFormattingRule;
+} | {
+    type: 'updateConditionalFormattingRule';
+    value: UpdateConditionalFormattingRule;
+} | {
+    type: 'moveConditionalFormattingRule';
+    value: MoveConditionalFormattingRule;
+} | {
+    type: 'deleteConditionalFormattingRule';
+    value: DeleteConditionalFormattingRule;
 } | {
     type: 'deleteChart';
     value: DeleteChart;

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

@@ -40,6 +40,11 @@ export * from './cell_protection';
 export * from './cell_ref';
 export * from './cell_ref_range';
 export * from './cell_style_update';
+export * from './cf_data_bar';
+export * from './cf_format_spec';
+export * from './cf_icon';
+export * from './cf_rule_info';
+export * from './cf_rule_spec';
 export * from './chart_info';
 export * from './chart_series_info';
 export * from './checkpoint_meta';
@@ -50,11 +55,13 @@ export * from './comment_mention';
 export * from './comment_mention_info';
 export * from './comment_note';
 export * from './comment_person';
+export * from './conditional_format';
 export * from './convert_block';
 export * from './create_appendix';
 export * from './create_block';
 export * from './create_chart';
 export * from './create_chart_series';
+export * from './create_conditional_formatting_rule';
 export * from './create_diy_cell';
 export * from './create_diy_cell_by_id';
 export * from './create_link';
@@ -72,6 +79,7 @@ export * from './delete_chart';
 export * from './delete_cols';
 export * from './delete_cols_in_block';
 export * from './delete_comment';
+export * from './delete_conditional_formatting_rule';
 export * from './delete_rows';
 export * from './delete_rows_in_block';
 export * from './delete_sheet';
@@ -111,6 +119,7 @@ export * from './modify_policy';
 export * from './move_block';
 export * from './move_block_line';
 export * from './move_chart';
+export * from './move_conditional_formatting_rule';
 export * from './msg_edit';
 export * from './msg_join';
 export * from './msg_sequencer_action_invalid_message';
@@ -161,6 +170,7 @@ export * from './rpc_get_cells_params';
 export * from './rpc_get_charts_params';
 export * from './rpc_get_col_width_params';
 export * from './rpc_get_comments_params';
+export * from './rpc_get_conditional_formatting_rules_params';
 export * from './rpc_get_data_boundary_params';
 export * from './rpc_get_dependents_params';
 export * from './rpc_get_display_units_of_formula_params';
@@ -227,6 +237,7 @@ export * from './token_type';
 export * from './token_unit';
 export * from './underline_property';
 export * from './update_chart';
+export * from './update_conditional_formatting_rule';
 export * from './upsert_field_formulas';
 export * from './upsert_field_render_info';
 export * from './upsert_person';

package/dist/src/bindings/index.js

@@ -57,6 +57,11 @@ __exportStar(require("./cell_protection"), exports);
 __exportStar(require("./cell_ref"), exports);
 __exportStar(require("./cell_ref_range"), exports);
 __exportStar(require("./cell_style_update"), exports);
+__exportStar(require("./cf_data_bar"), exports);
+__exportStar(require("./cf_format_spec"), exports);
+__exportStar(require("./cf_icon"), exports);
+__exportStar(require("./cf_rule_info"), exports);
+__exportStar(require("./cf_rule_spec"), exports);
 __exportStar(require("./chart_info"), exports);
 __exportStar(require("./chart_series_info"), exports);
 __exportStar(require("./checkpoint_meta"), exports);
@@ -67,11 +72,13 @@ __exportStar(require("./comment_mention"), exports);
 __exportStar(require("./comment_mention_info"), exports);
 __exportStar(require("./comment_note"), exports);
 __exportStar(require("./comment_person"), exports);
+__exportStar(require("./conditional_format"), exports);
 __exportStar(require("./convert_block"), exports);
 __exportStar(require("./create_appendix"), exports);
 __exportStar(require("./create_block"), exports);
 __exportStar(require("./create_chart"), exports);
 __exportStar(require("./create_chart_series"), exports);
+__exportStar(require("./create_conditional_formatting_rule"), exports);
 __exportStar(require("./create_diy_cell"), exports);
 __exportStar(require("./create_diy_cell_by_id"), exports);
 __exportStar(require("./create_link"), exports);
@@ -89,6 +96,7 @@ __exportStar(require("./delete_chart"), exports);
 __exportStar(require("./delete_cols"), exports);
 __exportStar(require("./delete_cols_in_block"), exports);
 __exportStar(require("./delete_comment"), exports);
+__exportStar(require("./delete_conditional_formatting_rule"), exports);
 __exportStar(require("./delete_rows"), exports);
 __exportStar(require("./delete_rows_in_block"), exports);
 __exportStar(require("./delete_sheet"), exports);
@@ -128,6 +136,7 @@ __exportStar(require("./modify_policy"), exports);
 __exportStar(require("./move_block"), exports);
 __exportStar(require("./move_block_line"), exports);
 __exportStar(require("./move_chart"), exports);
+__exportStar(require("./move_conditional_formatting_rule"), exports);
 __exportStar(require("./msg_edit"), exports);
 __exportStar(require("./msg_join"), exports);
 __exportStar(require("./msg_sequencer_action_invalid_message"), exports);
@@ -178,6 +187,7 @@ __exportStar(require("./rpc_get_cells_params"), exports);
 __exportStar(require("./rpc_get_charts_params"), exports);
 __exportStar(require("./rpc_get_col_width_params"), exports);
 __exportStar(require("./rpc_get_comments_params"), exports);
+__exportStar(require("./rpc_get_conditional_formatting_rules_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);
@@ -244,6 +254,7 @@ __exportStar(require("./token_type"), exports);
 __exportStar(require("./token_unit"), exports);
 __exportStar(require("./underline_property"), exports);
 __exportStar(require("./update_chart"), exports);
+__exportStar(require("./update_conditional_formatting_rule"), exports);
 __exportStar(require("./upsert_field_formulas"), exports);
 __exportStar(require("./upsert_field_render_info"), exports);
 __exportStar(require("./upsert_person"), exports);

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

@@ -0,0 +1,30 @@
+export interface MoveConditionalFormattingRule {
+    sheetIdx: number;
+    ruleId: number;
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}
+export declare class MoveConditionalFormattingRuleBuilder {
+    private _sheetIdx;
+    private _ruleId;
+    private _startRow;
+    private _startCol;
+    private _endRow;
+    private _endCol;
+    sheetIdx(value: number): this;
+    ruleId(value: number): this;
+    startRow(value: number): this;
+    startCol(value: number): this;
+    endRow(value: number): this;
+    endCol(value: number): this;
+    build(): {
+        sheetIdx: number;
+        ruleId: number;
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+    };
+}

package/dist/src/bindings/move_conditional_formatting_rule.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoveConditionalFormattingRuleBuilder = void 0;
+class MoveConditionalFormattingRuleBuilder {
+    _sheetIdx;
+    _ruleId;
+    _startRow;
+    _startCol;
+    _endRow;
+    _endCol;
+    sheetIdx(value) {
+        this._sheetIdx = value;
+        return this;
+    }
+    ruleId(value) {
+        this._ruleId = value;
+        return this;
+    }
+    startRow(value) {
+        this._startRow = value;
+        return this;
+    }
+    startCol(value) {
+        this._startCol = value;
+        return this;
+    }
+    endRow(value) {
+        this._endRow = value;
+        return this;
+    }
+    endCol(value) {
+        this._endCol = value;
+        return this;
+    }
+    build() {
+        if (this._sheetIdx === undefined)
+            throw new Error('missing sheetIdx');
+        if (this._ruleId === undefined)
+            throw new Error('missing ruleId');
+        if (this._startRow === undefined)
+            throw new Error('missing startRow');
+        if (this._startCol === undefined)
+            throw new Error('missing startCol');
+        if (this._endRow === undefined)
+            throw new Error('missing endRow');
+        if (this._endCol === undefined)
+            throw new Error('missing endCol');
+        return { sheetIdx: this._sheetIdx, ruleId: this._ruleId, startRow: this._startRow, startCol: this._startCol, endRow: this._endRow, endCol: this._endCol };
+    }
+}
+exports.MoveConditionalFormattingRuleBuilder = MoveConditionalFormattingRuleBuilder;

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

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

package/dist/src/bindings/rpc_get_conditional_formatting_rules_params.js

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

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

@@ -1,3 +1,4 @@
 export interface SaveParams {
     appData: string;
+    resolveBlockRefs?: boolean;
 }

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

@@ -14,6 +14,7 @@ import { CellInfo } from './cell_info';
 import { CellInput } from './cell_input';
 import { CellPosition } from './cell_position';
 import { CellRefRange } from './cell_ref_range';
+import { CfRuleInfo } from './cf_rule_info';
 import { ChartInfo } from './chart_info';
 import { CheckFormulaParams } from './rpc_check_formula_params';
 import { CheckpointMetaDto } from './checkpoint_meta';
@@ -44,6 +45,7 @@ import { GetCellsParams } from './rpc_get_cells_params';
 import { GetChartsParams } from './rpc_get_charts_params';
 import { GetColWidthParams } from './rpc_get_col_width_params';
 import { GetCommentsParams } from './rpc_get_comments_params';
+import { GetConditionalFormattingRulesParams } from './rpc_get_conditional_formatting_rules_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';
@@ -134,6 +136,7 @@ export interface WorkbookMethods {
     getComments(params: GetCommentsParams, bookId?: number): Promise<readonly Comment[] | ErrorMessage>;
     getCellImages(params: GetCellImagesParams, bookId?: number): Promise<readonly CellImageInfo[] | ErrorMessage>;
     getCharts(params: GetChartsParams, bookId?: number): Promise<readonly ChartInfo[] | ErrorMessage>;
+    getConditionalFormattingRules(params: GetConditionalFormattingRulesParams, bookId?: number): Promise<readonly CfRuleInfo[] | ErrorMessage>;
     getShadowCellId(params: GetShadowCellIdParams, bookId?: number): Promise<SheetCellId | ErrorMessage>;
     getShadowCellIds(params: GetShadowCellIdsParams, bookId?: number): Promise<readonly SheetCellId[] | ErrorMessage>;
     getShadowInfoById(params: GetShadowInfoByIdParams, bookId?: number): Promise<ShadowCellInfo | ErrorMessage>;
@@ -146,6 +149,7 @@ export interface WorkbookMethods {
     loadWorkbook(params: LoadWorkbookParams, bookId?: number): Promise<void | ErrorMessage>;
     save(params: SaveParams, bookId?: number): Promise<SaveFileResult | ErrorMessage>;
     getAppData(bookId?: number): Promise<readonly AppData[] | ErrorMessage>;
+    getVersion(bookId?: number): Promise<number | ErrorMessage>;
     getDisplayUnitsOfFormula(params: GetDisplayUnitsOfFormulaParams, bookId?: number): Promise<FormulaDisplayInfo | ErrorMessage>;
     calcCondition(params: CalcConditionParams, bookId?: number): Promise<boolean | ErrorMessage>;
     getCellIdByBlockRef(params: GetCellIdByBlockRefParams, bookId?: number): Promise<SheetCellId | ErrorMessage>;

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

@@ -1 +1 @@
-export type ShadowKind = 'validation' | 'userEditable';
+export type ShadowKind = 'validation' | 'userEditable' | 'conditionalFormat' | 'conditionalFormatScale';

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

@@ -0,0 +1,19 @@
+import { CfRuleSpec } from './cf_rule_spec';
+export interface UpdateConditionalFormattingRule {
+    sheetIdx: number;
+    ruleId: number;
+    rule: CfRuleSpec;
+}
+export declare class UpdateConditionalFormattingRuleBuilder {
+    private _sheetIdx;
+    private _ruleId;
+    private _rule;
+    sheetIdx(value: number): this;
+    ruleId(value: number): this;
+    rule(value: CfRuleSpec): this;
+    build(): {
+        sheetIdx: number;
+        ruleId: number;
+        rule: CfRuleSpec;
+    };
+}

package/dist/src/bindings/update_conditional_formatting_rule.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateConditionalFormattingRuleBuilder = void 0;
+class UpdateConditionalFormattingRuleBuilder {
+    _sheetIdx;
+    _ruleId;
+    _rule;
+    sheetIdx(value) {
+        this._sheetIdx = value;
+        return this;
+    }
+    ruleId(value) {
+        this._ruleId = value;
+        return this;
+    }
+    rule(value) {
+        this._rule = value;
+        return this;
+    }
+    build() {
+        if (this._sheetIdx === undefined)
+            throw new Error('missing sheetIdx');
+        if (this._ruleId === undefined)
+            throw new Error('missing ruleId');
+        if (this._rule === undefined)
+            throw new Error('missing rule');
+        return { sheetIdx: this._sheetIdx, ruleId: this._ruleId, rule: this._rule };
+    }
+}
+exports.UpdateConditionalFormattingRuleBuilder = UpdateConditionalFormattingRuleBuilder;

package/dist/wasm/logisheets_wasm_server.d.ts

@@ -1,11 +1,5 @@
 /* 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
@@ -18,3 +12,9 @@ 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;
+/**
+ * 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;
+export function handle(msg: any, book_id?: number | null): any;

package/dist/wasm/logisheets_wasm_server.js

@@ -170,40 +170,6 @@ 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.
- * @param {string} fmt
- * @param {string} text
- * @returns {string}
- */
-module.exports.format_text = function(fmt, text) {
-    let deferred3_0;
-    let deferred3_1;
-    try {
-        const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len1 = WASM_VECTOR_LEN;
-        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
-        deferred3_0 = ret[0];
-        deferred3_1 = ret[1];
-        return getStringFromWasm0(ret[0], ret[1]);
-    } finally {
-        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
-    }
-};
-
 /**
  * Input: AsyncFuncResult
  * Output: ActionAffect
@@ -240,6 +206,40 @@ module.exports.format_number = function(fmt, value) {
     }
 };
 
+/**
+ * Render a text value with an Excel number-format code (for the `@` text
+ * section). Falls back to the text itself on an unsupported format.
+ * @param {string} fmt
+ * @param {string} text
+ * @returns {string}
+ */
+module.exports.format_text = function(fmt, text) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
+        deferred3_0 = ret[0];
+        deferred3_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+};
+
+/**
+ * @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;
+};
+
 module.exports.__wbg_String_eecc4a11987127d6 = function(arg0, arg1) {
     const ret = String(arg1);
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);

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.10.0",
+  "version": "1.12.0",
   "files": [
     "logisheets_wasm_server_bg.wasm",
     "logisheets_wasm_server.js",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "logisheets",
-  "version": "1.10.0",
-  "description": "Read and write the xlsx files",
+  "version": "1.12.0",
+  "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",
   "scripts": {
@@ -18,7 +18,15 @@
   },
   "keywords": [
     "xlsx",
-    "spreadsheets"
+    "excel",
+    "spreadsheet",
+    "spreadsheet-engine",
+    "wasm",
+    "webassembly",
+    "rust",
+    "nodejs",
+    "formula",
+    "ooxml"
   ],
   "author": "Jeremy He<yiliang.he@qq.com>",
   "license": "MIT",

package/wasm/logisheets_wasm_server.d.ts

@@ -1,11 +1,5 @@
 /* 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
@@ -18,3 +12,9 @@ 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;
+/**
+ * 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;
+export function handle(msg: any, book_id?: number | null): any;

package/wasm/logisheets_wasm_server.js

@@ -170,40 +170,6 @@ 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.
- * @param {string} fmt
- * @param {string} text
- * @returns {string}
- */
-module.exports.format_text = function(fmt, text) {
-    let deferred3_0;
-    let deferred3_1;
-    try {
-        const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len1 = WASM_VECTOR_LEN;
-        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
-        deferred3_0 = ret[0];
-        deferred3_1 = ret[1];
-        return getStringFromWasm0(ret[0], ret[1]);
-    } finally {
-        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
-    }
-};
-
 /**
  * Input: AsyncFuncResult
  * Output: ActionAffect
@@ -240,6 +206,40 @@ module.exports.format_number = function(fmt, value) {
     }
 };
 
+/**
+ * Render a text value with an Excel number-format code (for the `@` text
+ * section). Falls back to the text itself on an unsupported format.
+ * @param {string} fmt
+ * @param {string} text
+ * @returns {string}
+ */
+module.exports.format_text = function(fmt, text) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
+        deferred3_0 = ret[0];
+        deferred3_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+};
+
+/**
+ * @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;
+};
+
 module.exports.__wbg_String_eecc4a11987127d6 = function(arg0, arg1) {
     const ret = String(arg1);
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);

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.10.0",
+  "version": "1.12.0",
   "files": [
     "logisheets_wasm_server_bg.wasm",
     "logisheets_wasm_server.js",