logisheets-core 1.5.0 → 1.7.0

package/dist/ops/index.d.ts

@@ -120,6 +120,23 @@ export declare class WorkbookOps {
         keyIdx: number;
         fields: readonly FormBlockField[];
     }): Promise<void>;
+    /**
+     * Turn an EXISTING cell region into a form-backed block in place: like
+     * `createFormBlock`, but `convertBlock` (keeps the region's cells + values
+     * and its row/col extent, and remaps formulas that reference the range so
+     * they track the block). `fields.length` must equal the region's columns.
+     */
+    convertToFormBlock(opts: {
+        sheetIdx: number;
+        blockId: number;
+        masterRow: number;
+        masterCol: number;
+        rowCnt: number;
+        colCnt: number;
+        refName: string;
+        keyIdx: number;
+        fields: readonly FormBlockField[];
+    }): Promise<void>;
     /**
      * Apply a caller-built payload list as one transaction (at the host's
      * temp-mode). Escape hatch for operations whose payload construction still

package/dist/ops/index.js

@@ -227,6 +227,53 @@ export class WorkbookOps {
         ];
         await this.apply(payloads, true);
     }
+    /**
+     * Turn an EXISTING cell region into a form-backed block in place: like
+     * `createFormBlock`, but `convertBlock` (keeps the region's cells + values
+     * and its row/col extent, and remaps formulas that reference the range so
+     * they track the block). `fields.length` must equal the region's columns.
+     */
+    async convertToFormBlock(opts) {
+        const { sheetIdx, blockId, masterRow, masterCol, rowCnt, colCnt, refName, keyIdx, fields, } = opts;
+        const payloads = [
+            {
+                type: 'convertBlock',
+                value: {
+                    sheetIdx,
+                    id: blockId,
+                    masterRow,
+                    masterCol,
+                    rowCnt,
+                    colCnt,
+                },
+            },
+            {
+                type: 'bindFormSchema',
+                value: {
+                    refName,
+                    sheetIdx,
+                    blockId,
+                    fieldFrom: 0,
+                    row: true,
+                    keyIdx: keyIdx < 0 ? 0 : keyIdx,
+                    fields: fields.map((f) => f.name),
+                    renderIds: fields.map((f) => f.renderId),
+                    fieldFormulas: fields.map((f) => f.valueFormula ?? ''),
+                    validationFormulas: [],
+                    editabilityFormulas: [],
+                },
+            },
+            ...fields.map((f) => ({
+                type: 'upsertFieldRenderInfo',
+                value: {
+                    renderId: f.renderId,
+                    diyRender: f.diyRender,
+                    styleUpdate: { setNumFmt: f.numFmt ?? '' },
+                },
+            })),
+        ];
+        await this.apply(payloads, true);
+    }
     // ---- generic / temp-branch -----------------------------------------
     /**
      * Apply a caller-built payload list as one transaction (at the host's

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "logisheets-core",
-    "version": "1.5.0",
+    "version": "1.7.0",
     "description": "UI-free LogiSheets logic — runs in the browser or on Node. Depends on logisheets-web only for types; the engine Client is injected by the host.",
     "main": "./dist/index.js",
     "module": "./dist/index.js",
@@ -44,7 +44,7 @@
     "author": "Jeremy He",
     "license": "MIT",
     "peerDependencies": {
-        "logisheets-web": "^1.5.0"
+        "logisheets-web": "^1.7.0"
     },
     "devDependencies": {
         "logisheets-web": "workspace:*",