logisheets 1.13.0 → 1.14.0

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

@@ -1,4 +1,4 @@
-import { ActionEffect, BlockField, BlockInfo, BlockSortOrder, GetBlockSortOrderParams, 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, 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';
@@ -171,6 +171,26 @@ export declare class Workbook {
      * a sort order. Fails for random-schema blocks (no fields).
      */
     getBlockSortOrder(params: GetBlockSortOrderParams): Result<BlockSortOrder>;
+    /**
+     * Whether `actor` may perform `op` on this block.
+     *
+     * The engine cannot enforce a block's write policy on its own — a payload
+     * carries no trace of who prompted it — so a host that offers an
+     * operation should ask this first and refuse it itself. The decision lives
+     * in the core so this app, node, the desktop build and the craft runtime
+     * cannot drift apart on what a policy means.
+     *
+     * The block's `description`, `owner`, `modifyPolicy` and `permissions`
+     * come back on `getBlockInfo` if you need to explain the refusal.
+     */
+    mayModifyBlock(params: MayModifyBlockParams): Result<boolean>;
+    /**
+     * A block's governance metadata on its own — owner, default policy,
+     * per-operation overrides, description. `getBlockInfo` carries the same
+     * fields but drags every cell along with them, which is the wrong shape
+     * for a check that runs once per payload.
+     */
+    getBlockModifyInfo(params: GetBlockModifyInfoParams): Result<BlockModifyInfo>;
     /**
      * Sort a block's records by the named field and commit the reorder as a
      * single (undoable) transaction. The engine computes the type-aware order;

package/dist/src/api/workbook.js

@@ -424,6 +424,30 @@ class Workbook {
     getBlockSortOrder(params) {
         return rpc('getBlockSortOrder', params, this._id);
     }
+    /**
+     * Whether `actor` may perform `op` on this block.
+     *
+     * The engine cannot enforce a block's write policy on its own — a payload
+     * carries no trace of who prompted it — so a host that offers an
+     * operation should ask this first and refuse it itself. The decision lives
+     * in the core so this app, node, the desktop build and the craft runtime
+     * cannot drift apart on what a policy means.
+     *
+     * The block's `description`, `owner`, `modifyPolicy` and `permissions`
+     * come back on `getBlockInfo` if you need to explain the refusal.
+     */
+    mayModifyBlock(params) {
+        return rpc('mayModifyBlock', params, this._id);
+    }
+    /**
+     * A block's governance metadata on its own — owner, default policy,
+     * per-operation overrides, description. `getBlockInfo` carries the same
+     * fields but drags every cell along with them, which is the wrong shape
+     * for a check that runs once per payload.
+     */
+    getBlockModifyInfo(params) {
+        return rpc('getBlockModifyInfo', params, this._id);
+    }
     /**
      * Sort a block's records by the named field and commit the reorder as a
      * single (undoable) transaction. The engine computes the type-aware order;

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

@@ -0,0 +1,30 @@
+export interface AxisScaleUpdate {
+    min?: number;
+    max?: number;
+    logBase?: number;
+    reversed: boolean;
+    majorUnit?: number;
+    minorUnit?: number;
+}
+export declare class AxisScaleUpdateBuilder {
+    private _min?;
+    private _max?;
+    private _logBase?;
+    private _reversed;
+    private _majorUnit?;
+    private _minorUnit?;
+    min(value: number): this;
+    max(value: number): this;
+    logBase(value: number): this;
+    reversed(value: boolean): this;
+    majorUnit(value: number): this;
+    minorUnit(value: number): this;
+    build(): {
+        min: number | undefined;
+        max: number | undefined;
+        logBase: number | undefined;
+        reversed: boolean;
+        majorUnit: number | undefined;
+        minorUnit: number | undefined;
+    };
+}

package/dist/src/bindings/axis_scale_update.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AxisScaleUpdateBuilder = void 0;
+class AxisScaleUpdateBuilder {
+    _min;
+    _max;
+    _logBase;
+    _reversed;
+    _majorUnit;
+    _minorUnit;
+    min(value) {
+        this._min = value;
+        return this;
+    }
+    max(value) {
+        this._max = value;
+        return this;
+    }
+    logBase(value) {
+        this._logBase = value;
+        return this;
+    }
+    reversed(value) {
+        this._reversed = value;
+        return this;
+    }
+    majorUnit(value) {
+        this._majorUnit = value;
+        return this;
+    }
+    minorUnit(value) {
+        this._minorUnit = value;
+        return this;
+    }
+    build() {
+        if (this._reversed === undefined)
+            throw new Error('missing reversed');
+        return { min: this._min, max: this._max, logBase: this._logBase, reversed: this._reversed, majorUnit: this._majorUnit, minorUnit: this._minorUnit };
+    }
+}
+exports.AxisScaleUpdateBuilder = AxisScaleUpdateBuilder;

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

@@ -0,0 +1,4 @@
+export type BlockActor = 'user' | {
+    type: 'craft';
+    value: string;
+};

package/dist/src/bindings/block_actor.js

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

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

@@ -1,6 +1,8 @@
 import { BlockCellInfo } from './block_cell_info';
+import { BlockPermissions } from './block_permissions';
 import { BlockSchema } from './block_schema';
 import { FieldRenderEntry } from './field_render_entry';
+import { ModifyPolicy } from './modify_policy';
 export interface BlockInfo {
     sheetIdx: number;
     sheetId: number;
@@ -12,4 +14,8 @@ export interface BlockInfo {
     schema?: BlockSchema;
     fieldRenders: readonly FieldRenderEntry[];
     cells: readonly BlockCellInfo[];
+    description: string;
+    owner: string;
+    modifyPolicy: ModifyPolicy;
+    permissions: BlockPermissions;
 }

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

@@ -0,0 +1,8 @@
+import { BlockPermissions } from './block_permissions';
+import { ModifyPolicy } from './modify_policy';
+export interface BlockModifyInfo {
+    owner: string;
+    modifyPolicy: ModifyPolicy;
+    permissions: BlockPermissions;
+    description: string;
+}

package/dist/src/bindings/block_modify_info.js

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

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

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

package/dist/src/bindings/block_op.js

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

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

@@ -0,0 +1,31 @@
+import { ModifyPolicy } from './modify_policy';
+export interface BlockPermissions {
+    insertDeleteLines?: ModifyPolicy;
+    removeBlock?: ModifyPolicy;
+    modifySchema?: ModifyPolicy;
+    cellInput?: ModifyPolicy;
+    sortByField?: ModifyPolicy;
+    modifyDescription?: ModifyPolicy;
+}
+export declare class BlockPermissionsBuilder {
+    private _insertDeleteLines?;
+    private _removeBlock?;
+    private _modifySchema?;
+    private _cellInput?;
+    private _sortByField?;
+    private _modifyDescription?;
+    insertDeleteLines(value: ModifyPolicy): this;
+    removeBlock(value: ModifyPolicy): this;
+    modifySchema(value: ModifyPolicy): this;
+    cellInput(value: ModifyPolicy): this;
+    sortByField(value: ModifyPolicy): this;
+    modifyDescription(value: ModifyPolicy): this;
+    build(): {
+        insertDeleteLines: ModifyPolicy | undefined;
+        removeBlock: ModifyPolicy | undefined;
+        modifySchema: ModifyPolicy | undefined;
+        cellInput: ModifyPolicy | undefined;
+        sortByField: ModifyPolicy | undefined;
+        modifyDescription: ModifyPolicy | undefined;
+    };
+}

package/dist/src/bindings/block_permissions.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockPermissionsBuilder = void 0;
+class BlockPermissionsBuilder {
+    _insertDeleteLines;
+    _removeBlock;
+    _modifySchema;
+    _cellInput;
+    _sortByField;
+    _modifyDescription;
+    insertDeleteLines(value) {
+        this._insertDeleteLines = value;
+        return this;
+    }
+    removeBlock(value) {
+        this._removeBlock = value;
+        return this;
+    }
+    modifySchema(value) {
+        this._modifySchema = value;
+        return this;
+    }
+    cellInput(value) {
+        this._cellInput = value;
+        return this;
+    }
+    sortByField(value) {
+        this._sortByField = value;
+        return this;
+    }
+    modifyDescription(value) {
+        this._modifyDescription = value;
+        return this;
+    }
+    build() {
+        return { insertDeleteLines: this._insertDeleteLines, removeBlock: this._removeBlock, modifySchema: this._modifySchema, cellInput: this._cellInput, sortByField: this._sortByField, modifyDescription: this._modifyDescription };
+    }
+}
+exports.BlockPermissionsBuilder = BlockPermissionsBuilder;

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

@@ -0,0 +1,8 @@
+export interface ChartAxisScaleInfo {
+    min?: number;
+    max?: number;
+    logBase?: number;
+    reversed: boolean;
+    majorUnit?: number;
+    minorUnit?: number;
+}

package/dist/src/bindings/chart_axis_scale_info.js

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

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

@@ -0,0 +1,18 @@
+export interface ChartBlockSource {
+    blockId: number;
+    categoryField?: string;
+    valueFields: readonly string[];
+}
+export declare class ChartBlockSourceBuilder {
+    private _blockId;
+    private _categoryField?;
+    private _valueFields;
+    blockId(value: number): this;
+    categoryField(value: string): this;
+    valueFields(value: readonly string[]): this;
+    build(): {
+        blockId: number;
+        categoryField: string | undefined;
+        valueFields: readonly string[];
+    };
+}

package/dist/src/bindings/chart_block_source.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChartBlockSourceBuilder = void 0;
+class ChartBlockSourceBuilder {
+    _blockId;
+    _categoryField;
+    _valueFields;
+    blockId(value) {
+        this._blockId = value;
+        return this;
+    }
+    categoryField(value) {
+        this._categoryField = value;
+        return this;
+    }
+    valueFields(value) {
+        this._valueFields = value;
+        return this;
+    }
+    build() {
+        if (this._blockId === undefined)
+            throw new Error('missing blockId');
+        if (this._valueFields === undefined)
+            throw new Error('missing valueFields');
+        return { blockId: this._blockId, categoryField: this._categoryField, valueFields: this._valueFields };
+    }
+}
+exports.ChartBlockSourceBuilder = ChartBlockSourceBuilder;

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

@@ -0,0 +1,5 @@
+export interface ChartBlockSourceInfo {
+    blockId: number;
+    categoryField?: string;
+    valueFields: readonly string[];
+}

package/dist/src/bindings/chart_block_source_info.js

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

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

@@ -0,0 +1,9 @@
+export interface ChartDataLabelsInfo {
+    showValue: boolean;
+    showCategory: boolean;
+    showSeries: boolean;
+    showPercent: boolean;
+    showLegendKey: boolean;
+    position?: string;
+    numFmt?: string;
+}

package/dist/src/bindings/chart_data_labels_info.js

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

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

@@ -1,3 +1,7 @@
+import { ChartAxisScaleInfo } from './chart_axis_scale_info';
+import { ChartBlockSourceInfo } from './chart_block_source_info';
+import { ChartDataLabelsInfo } from './chart_data_labels_info';
+import { ChartOfPieSplitInfo } from './chart_of_pie_split_info';
 import { ChartSeriesInfo } from './chart_series_info';
 export interface ChartInfo {
     chartId: string;
@@ -9,12 +13,21 @@ export interface ChartInfo {
     toCol: number;
     toColOff: number;
     toRowOff: number;
+    extCx?: number;
+    extCy?: number;
     chartType: string;
     stacked: boolean;
     title?: string;
     legendPos?: string;
     categories: readonly string[];
+    catRef?: string;
     series: readonly ChartSeriesInfo[];
     catAxisTitle?: string;
     valAxisTitle?: string;
+    dataLabels: ChartDataLabelsInfo;
+    ofPieSplit: ChartOfPieSplitInfo;
+    valAxisScale: ChartAxisScaleInfo;
+    catAxisScale: ChartAxisScaleInfo;
+    valAxisNumFmt?: string;
+    blockSource?: ChartBlockSourceInfo;
 }

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

@@ -0,0 +1,5 @@
+export interface ChartOfPieSplitInfo {
+    by?: string;
+    pos?: number;
+    secondSize?: number;
+}

package/dist/src/bindings/chart_of_pie_split_info.js

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

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

@@ -2,4 +2,10 @@ export interface ChartSeriesInfo {
     name?: string;
     values: readonly number[];
     color?: string;
+    formattedValues: readonly string[];
+    sizes: readonly number[];
+    sizeRef?: string;
+    seriesType?: string;
+    valRef?: string;
+    numFmt?: string;
 }

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

@@ -1,3 +1,4 @@
+import { BlockPermissions } from './block_permissions';
 import { ModifyPolicy } from './modify_policy';
 export interface CreateBlock {
     sheetIdx: number;
@@ -8,6 +9,8 @@ export interface CreateBlock {
     colCnt: number;
     owner?: string;
     modifyPolicy?: ModifyPolicy;
+    permissions?: BlockPermissions;
+    description?: string;
 }
 export declare class CreateBlockBuilder {
     private _sheetIdx;
@@ -18,6 +21,8 @@ export declare class CreateBlockBuilder {
     private _colCnt;
     private _owner?;
     private _modifyPolicy?;
+    private _permissions?;
+    private _description?;
     sheetIdx(value: number): this;
     id(value: number): this;
     masterRow(value: number): this;
@@ -26,6 +31,8 @@ export declare class CreateBlockBuilder {
     colCnt(value: number): this;
     owner(value: string): this;
     modifyPolicy(value: ModifyPolicy): this;
+    permissions(value: BlockPermissions): this;
+    description(value: string): this;
     build(): {
         sheetIdx: number;
         id: number;
@@ -35,5 +42,7 @@ export declare class CreateBlockBuilder {
         colCnt: number;
         owner: string | undefined;
         modifyPolicy: ModifyPolicy | undefined;
+        permissions: BlockPermissions | undefined;
+        description: string | undefined;
     };
 }

package/dist/src/bindings/create_block.js

@@ -10,6 +10,8 @@ class CreateBlockBuilder {
     _colCnt;
     _owner;
     _modifyPolicy;
+    _permissions;
+    _description;
     sheetIdx(value) {
         this._sheetIdx = value;
         return this;
@@ -42,6 +44,14 @@ class CreateBlockBuilder {
         this._modifyPolicy = value;
         return this;
     }
+    permissions(value) {
+        this._permissions = value;
+        return this;
+    }
+    description(value) {
+        this._description = value;
+        return this;
+    }
     build() {
         if (this._sheetIdx === undefined)
             throw new Error('missing sheetIdx');
@@ -55,7 +65,7 @@ class CreateBlockBuilder {
             throw new Error('missing rowCnt');
         if (this._colCnt === undefined)
             throw new Error('missing colCnt');
-        return { sheetIdx: this._sheetIdx, id: this._id, masterRow: this._masterRow, masterCol: this._masterCol, rowCnt: this._rowCnt, colCnt: this._colCnt, owner: this._owner, modifyPolicy: this._modifyPolicy };
+        return { sheetIdx: this._sheetIdx, id: this._id, masterRow: this._masterRow, masterCol: this._masterCol, rowCnt: this._rowCnt, colCnt: this._colCnt, owner: this._owner, modifyPolicy: this._modifyPolicy, permissions: this._permissions, description: this._description };
     }
 }
 exports.CreateBlockBuilder = CreateBlockBuilder;

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

@@ -1,3 +1,4 @@
+import { ChartBlockSource } from './chart_block_source';
 import { CreateChartSeries } from './create_chart_series';
 export interface CreateChart {
     sheetIdx: number;
@@ -14,6 +15,7 @@ export interface CreateChart {
     title?: string;
     categoriesRef?: string;
     series: readonly CreateChartSeries[];
+    blockSource?: ChartBlockSource;
 }
 export declare class CreateChartBuilder {
     private _sheetIdx;
@@ -30,6 +32,7 @@ export declare class CreateChartBuilder {
     private _title?;
     private _categoriesRef?;
     private _series;
+    private _blockSource?;
     sheetIdx(value: number): this;
     chartId(value: string): this;
     chartType(value: string): this;
@@ -44,6 +47,7 @@ export declare class CreateChartBuilder {
     title(value: string): this;
     categoriesRef(value: string): this;
     series(value: readonly CreateChartSeries[]): this;
+    blockSource(value: ChartBlockSource): this;
     build(): {
         sheetIdx: number;
         chartId: string;
@@ -59,5 +63,6 @@ export declare class CreateChartBuilder {
         title: string | undefined;
         categoriesRef: string | undefined;
         series: readonly CreateChartSeries[];
+        blockSource: ChartBlockSource | undefined;
     };
 }

package/dist/src/bindings/create_chart.js

@@ -16,6 +16,7 @@ class CreateChartBuilder {
     _title;
     _categoriesRef;
     _series;
+    _blockSource;
     sheetIdx(value) {
         this._sheetIdx = value;
         return this;
@@ -72,6 +73,10 @@ class CreateChartBuilder {
         this._series = value;
         return this;
     }
+    blockSource(value) {
+        this._blockSource = value;
+        return this;
+    }
     build() {
         if (this._sheetIdx === undefined)
             throw new Error('missing sheetIdx');
@@ -97,7 +102,7 @@ class CreateChartBuilder {
             throw new Error('missing toRowOff');
         if (this._series === undefined)
             throw new Error('missing series');
-        return { sheetIdx: this._sheetIdx, chartId: this._chartId, chartType: this._chartType, fromRow: this._fromRow, fromCol: this._fromCol, fromColOff: this._fromColOff, fromRowOff: this._fromRowOff, toRow: this._toRow, toCol: this._toCol, toColOff: this._toColOff, toRowOff: this._toRowOff, title: this._title, categoriesRef: this._categoriesRef, series: this._series };
+        return { sheetIdx: this._sheetIdx, chartId: this._chartId, chartType: this._chartType, fromRow: this._fromRow, fromCol: this._fromCol, fromColOff: this._fromColOff, fromRowOff: this._fromRowOff, toRow: this._toRow, toCol: this._toCol, toColOff: this._toColOff, toRowOff: this._toRowOff, title: this._title, categoriesRef: this._categoriesRef, series: this._series, blockSource: this._blockSource };
     }
 }
 exports.CreateChartBuilder = CreateChartBuilder;

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

@@ -1,14 +1,26 @@
 export interface CreateChartSeries {
     name?: string;
     valueRef: string;
+    color?: string;
+    sizeRef?: string;
+    seriesType?: string;
 }
 export declare class CreateChartSeriesBuilder {
     private _name?;
     private _valueRef;
+    private _color?;
+    private _sizeRef?;
+    private _seriesType?;
     name(value: string): this;
     valueRef(value: string): this;
+    color(value: string): this;
+    sizeRef(value: string): this;
+    seriesType(value: string): this;
     build(): {
         name: string | undefined;
         valueRef: string;
+        color: string | undefined;
+        sizeRef: string | undefined;
+        seriesType: string | undefined;
     };
 }

package/dist/src/bindings/create_chart_series.js

@@ -4,6 +4,9 @@ exports.CreateChartSeriesBuilder = void 0;
 class CreateChartSeriesBuilder {
     _name;
     _valueRef;
+    _color;
+    _sizeRef;
+    _seriesType;
     name(value) {
         this._name = value;
         return this;
@@ -12,10 +15,22 @@ class CreateChartSeriesBuilder {
         this._valueRef = value;
         return this;
     }
+    color(value) {
+        this._color = value;
+        return this;
+    }
+    sizeRef(value) {
+        this._sizeRef = value;
+        return this;
+    }
+    seriesType(value) {
+        this._seriesType = value;
+        return this;
+    }
     build() {
         if (this._valueRef === undefined)
             throw new Error('missing valueRef');
-        return { name: this._name, valueRef: this._valueRef };
+        return { name: this._name, valueRef: this._valueRef, color: this._color, sizeRef: this._sizeRef, seriesType: this._seriesType };
     }
 }
 exports.CreateChartSeriesBuilder = CreateChartSeriesBuilder;

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

@@ -51,6 +51,8 @@ import { ReproduceCells } from './reproduce_cells';
 import { ResizeBlock } from './resize_block';
 import { ResolveComment } from './resolve_comment';
 import { RestoreCheckpoint } from './restore_checkpoint';
+import { SetBlockDescription } from './set_block_description';
+import { SetBlockPermissions } from './set_block_permissions';
 import { SetCellImage } from './set_cell_image';
 import { SetColWidth } from './set_col_width';
 import { SetRowHeight } from './set_row_height';
@@ -139,6 +141,12 @@ export type EditPayload = {
 } | {
     type: 'blockLineNameFieldUpdate';
     value: BlockLineNameFieldUpdate;
+} | {
+    type: 'setBlockDescription';
+    value: SetBlockDescription;
+} | {
+    type: 'setBlockPermissions';
+    value: SetBlockPermissions;
 } | {
     type: 'cellFormatBrush';
     value: CellFormatBrush;

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

@@ -0,0 +1,4 @@
+export interface GetBlockModifyInfoParams {
+    sheetIdx: number;
+    blockId: number;
+}

package/dist/src/bindings/get_block_modify_info_params.js

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