@docmentis/udoc-wasm 0.8.2 → 0.8.3

package/dist/wasm/udoc.d.ts

@@ -1045,7 +1045,7 @@ export interface TableCell3D {
 /**
  * A cell's address in a worksheet grid — its row's and its column's ids, the
  * pair [`SpreadsheetHit`](crate::layout::SpreadsheetHit) reports and
- * [`GridCellRange`] corners are named by.
+ * [`GridCellRange`](super::GridCellRange) corners are named by.
  *
  * A cell has no id of its own: the **pair** is its identity, and it is ids
  * rather than positions because both survive a concurrent insert, so a peer's
@@ -5211,6 +5211,14 @@ export interface ShapeProperties {
     shape3d: PaintShape3d | null;
 }
 
+/**
+ * A sheet's visibility — the `state` attribute of a `<sheet>` entry. Maps to
+ * `ST_SheetState` in the XLSX schema. A `Hidden` sheet is hidden from the tab
+ * bar but the user can unhide it; a `VeryHidden` sheet is hidden from the UI
+ * entirely (unhideable only through VBA).
+ */
+export type SheetState = "visible" | "hidden" | "veryHidden";
+
 /**
  * A signature field (§12.7.4.5) — held unsigned: its `/V`, `/Lock` and
  * `/SV` aren't.
@@ -11689,6 +11697,24 @@ export interface PageList {
     pages: PageId[];
 }
 
+/**
+ * The part of a plane a caller needs current — the request an
+ * [`update_layout`](crate::engine::Engine::update_layout) carries down to
+ * [`LayoutPlane::update`](crate::layout::LayoutPlane::update).
+ *
+ * A plane is either a run of pages, each composed whole, or a single grid page
+ * composed by its rows (a worksheet in Normal view), so a request names one or
+ * the other, never both. Both bounds are inclusive, and the scope is what the
+ * caller needs, not a promise about what gets touched: how it maps to work is
+ * the doc type's decision.
+ *
+ * - A paged plane composes the pages of a [`Pages`](Self::Pages) scope, and
+ *   nothing for a [`Rows`](Self::Rows) one, which names nothing it holds.
+ * - A grid page composes the rows of a [`Rows`](Self::Rows) scope, and all of
+ *   them for a [`Pages`](Self::Pages) one that covers it — an export's.
+ */
+export type LayoutScope = { pages: { start: number; limit: number } } | { rows: { start: number; limit: number } };
+
 /**
  * The part of a word-processing document a search covers — the
  * wordprocessing
@@ -14136,7 +14162,7 @@ export type ShapeOleBinding = { embed: { followColorScheme?: ShapeOleColorScheme
  * Where a [`TextHyperlinkAction::ShowJump`] moves — `jump=` of
  * `ppaction://hlinkshowjump`.
  */
-export type TextHyperlinkShowJump = "endShow" | "firstSlide" | "lastSlide" | "lastSlideViewed" | "nextSlide" | "previousSlide" | { slide: { number: number } };
+export type TextHyperlinkShowJump = "endShow" | "firstSlide" | "lastSlide" | "lastSlideViewed" | "nextSlide" | "previousSlide" | { slide: { slideIndex: number } };
 
 /**
  * Where a blip's image comes from — the `a:blip` relationship attributes.
@@ -18683,7 +18709,8 @@ export class WasmSession {
      *
      * A 404, a css2 response with no covering block, and giving up after three
      * retries are the same event: those characters are recorded as unavailable
-     * from that vendor and the next layout tries the next one down the chain. To
+     * from that vendor, and the next vendor down the chain is on order at once —
+     * the next [`takeFontRequests`](Self::take_font_requests) hands it out. To
      * retry instead, simply don't call this until you have stopped trying — the
      * order stays open and the document renders in the stand-in meanwhile.
      *
@@ -18702,6 +18729,16 @@ export class WasmSession {
      * [`viewState`](Self::view_state) (indices 3–4).
      */
     composedPageCount(): number;
+    /**
+     * How many rows the current sheet's grid has composed. Grows as an
+     * [`updateLayout`](Self::update_layout) over `{ rows: { start, limit } }`
+     * composes, a worksheet's grid being one page however many of its rows
+     * are composed — the progress a host composing a sheet ahead guards its
+     * pump with, as [`composedPageCount`](Self::composed_page_count) for
+     * pages. `0` when no document is open, for a chartsheet, and for every
+     * other doc type.
+     */
+    composedRowCount(): number;
     /**
      * The camera as `[a, b, c, d, e, f]` (PDF/SVG order): content space
      * (document points) → **CSS px** under the current scroll/zoom.
@@ -19243,12 +19280,6 @@ export class WasmSession {
      * type with no sheets, or when nothing is open.
      */
     planeIsChartsheet(plane: number): boolean;
-    /**
-     * Whether plane `plane` is a spreadsheet's very hidden sheet —
-     * `state="veryHidden"`, which shows no tab. `false` for any other sheet, a
-     * plane out of range, a doc type with no sheets, or when nothing is open.
-     */
-    planeIsVeryHidden(plane: number): boolean;
     /**
      * The display name of plane `plane` — a spreadsheet's sheet-tab label
      * (the `<sheet name>` from `workbook.xml`), or `undefined` for a plane out
@@ -19257,6 +19288,13 @@ export class WasmSession {
      * for the bound.
      */
     planeName(plane: number): string | undefined;
+    /**
+     * The visibility of a spreadsheet's sheet on plane `plane` — its
+     * `state`: `"visible"`, `"hidden"` (no tab until the user unhides it) or
+     * `"veryHidden"` (no tab, and no way to unhide it). `undefined` for a
+     * plane out of range, a doc type with no sheets, or when nothing is open.
+     */
+    planeSheetState(plane: number): SheetState | undefined;
     /**
      * The colour of plane `plane`'s tab — a spreadsheet's sheet-tab colour
      * (`<sheetPr><tabColor>`) as Excel draws it — or `undefined` for a tab in
@@ -19942,7 +19980,9 @@ export class WasmSession {
      * `{ url: { url } }`. Fetch them however you like — in parallel, with
      * whatever retry policy — then settle each with
      * [`completeFontRequest`](Self::complete_font_request) and call
-     * [`refreshFonts`](Self::refresh_fonts) once for the batch.
+     * [`refreshFonts`](Self::refresh_fonts) once for a batch that brought a
+     * font. A batch of refusals needs none: it installed nothing, and the next
+     * vendors' orders are already waiting here.
      *
      * Nothing here blocks or waits: an order is out until it is settled, and the
      * document keeps rendering in a stand-in throughout.
@@ -19972,11 +20012,13 @@ export class WasmSession {
      */
     undo(): void;
     /**
-     * Compose ahead through page index `page_limit`, growing the composed
-     * prefix, and return whether the document is now **fully composed**. The
-     * idle compose-ahead seam: the host calls it from `requestIdleCallback`
-     * with a rising limit (e.g. `composedPageCount + 1` to advance one page)
-     * until it returns `true` — at which point
+     * Compose `scope` on the current plane — `{ pages: { start, limit } }`
+     * for a paged plane, growing the composed prefix through page index
+     * `limit`, or `{ rows: { start, limit } }` for a worksheet's grid — and
+     * return whether the plane is now **fully composed**. The idle
+     * compose-ahead seam: the host calls it from `requestIdleCallback` with a
+     * rising limit (e.g. `composedPageCount + 1` to advance one page) until it
+     * returns `true` — at which point
      * [`composedPageCount`](Self::composed_page_count) is the document's page
      * count. There is no total to ask for up front: a page is known only once
      * composed.
@@ -19990,9 +20032,10 @@ export class WasmSession {
      * `composedPageCount`.
      *
      * # Errors
-     * Returns a JS error if no document is open.
+     * Returns a JS error if no document is open, or if `scope` isn't a
+     * [`LayoutScope`].
      */
-    updateLayout(page_limit: number): boolean;
+    updateLayout(scope: LayoutScope): boolean;
     /**
      * The session's version vector — the opaque handshake token to hand another
      * session's [`patchSince`](Self::patch_since) so it can send back only the
@@ -20125,6 +20168,7 @@ export interface InitOutput {
     readonly wasmsession_close: (a: number) => void;
     readonly wasmsession_completeFontRequest: (a: number, b: bigint, c: number, d: number) => number;
     readonly wasmsession_composedPageCount: (a: number) => number;
+    readonly wasmsession_composedRowCount: (a: number) => number;
     readonly wasmsession_contentToViewport: (a: number, b: number) => void;
     readonly wasmsession_copy: (a: number) => number;
     readonly wasmsession_currentPlane: (a: number) => number;
@@ -20169,8 +20213,8 @@ export interface InitOutput {
     readonly wasmsession_plainText: (a: number, b: number, c: number) => void;
     readonly wasmsession_planeCount: (a: number) => number;
     readonly wasmsession_planeIsChartsheet: (a: number, b: number) => number;
-    readonly wasmsession_planeIsVeryHidden: (a: number, b: number) => number;
     readonly wasmsession_planeName: (a: number, b: number, c: number) => void;
+    readonly wasmsession_planeSheetState: (a: number, b: number) => number;
     readonly wasmsession_planeTabColor: (a: number, b: number) => number;
     readonly wasmsession_presence: (a: number, b: number) => void;
     readonly wasmsession_redo: (a: number, b: number) => void;
@@ -20237,8 +20281,8 @@ export interface InitOutput {
     readonly fontpreviewimage_width: (a: number) => number;
     readonly fontpreviewimage_bleed: (a: number) => number;
     readonly fontpreviewimage_height: (a: number) => number;
-    readonly __wasm_bindgen_func_elem_68517: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_68519: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_74162: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_74164: (a: number, b: number, c: number, d: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/dist/wasm/udoc.js

@@ -1047,7 +1047,8 @@ export class WasmSession {
      *
      * A 404, a css2 response with no covering block, and giving up after three
      * retries are the same event: those characters are recorded as unavailable
-     * from that vendor and the next layout tries the next one down the chain. To
+     * from that vendor, and the next vendor down the chain is on order at once —
+     * the next [`takeFontRequests`](Self::take_font_requests) hands it out. To
      * retry instead, simply don't call this until you have stopped trying — the
      * order stays open and the document renders in the stand-in meanwhile.
      *
@@ -1078,6 +1079,20 @@ export class WasmSession {
         const ret = wasm.wasmsession_composedPageCount(this.__wbg_ptr);
         return ret >>> 0;
     }
+    /**
+     * How many rows the current sheet's grid has composed. Grows as an
+     * [`updateLayout`](Self::update_layout) over `{ rows: { start, limit } }`
+     * composes, a worksheet's grid being one page however many of its rows
+     * are composed — the progress a host composing a sheet ahead guards its
+     * pump with, as [`composedPageCount`](Self::composed_page_count) for
+     * pages. `0` when no document is open, for a chartsheet, and for every
+     * other doc type.
+     * @returns {number}
+     */
+    composedRowCount() {
+        const ret = wasm.wasmsession_composedRowCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
     /**
      * The camera as `[a, b, c, d, e, f]` (PDF/SVG order): content space
      * (document points) → **CSS px** under the current scroll/zoom.
@@ -2196,17 +2211,6 @@ export class WasmSession {
         const ret = wasm.wasmsession_planeIsChartsheet(this.__wbg_ptr, plane);
         return ret !== 0;
     }
-    /**
-     * Whether plane `plane` is a spreadsheet's very hidden sheet —
-     * `state="veryHidden"`, which shows no tab. `false` for any other sheet, a
-     * plane out of range, a doc type with no sheets, or when nothing is open.
-     * @param {number} plane
-     * @returns {boolean}
-     */
-    planeIsVeryHidden(plane) {
-        const ret = wasm.wasmsession_planeIsVeryHidden(this.__wbg_ptr, plane);
-        return ret !== 0;
-    }
     /**
      * The display name of plane `plane` — a spreadsheet's sheet-tab label
      * (the `<sheet name>` from `workbook.xml`), or `undefined` for a plane out
@@ -2232,6 +2236,18 @@ export class WasmSession {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * The visibility of a spreadsheet's sheet on plane `plane` — its
+     * `state`: `"visible"`, `"hidden"` (no tab until the user unhides it) or
+     * `"veryHidden"` (no tab, and no way to unhide it). `undefined` for a
+     * plane out of range, a doc type with no sheets, or when nothing is open.
+     * @param {number} plane
+     * @returns {SheetState | undefined}
+     */
+    planeSheetState(plane) {
+        const ret = wasm.wasmsession_planeSheetState(this.__wbg_ptr, plane);
+        return takeObject(ret);
+    }
     /**
      * The colour of plane `plane`'s tab — a spreadsheet's sheet-tab colour
      * (`<sheetPr><tabColor>`) as Excel draws it — or `undefined` for a tab in
@@ -3593,7 +3609,9 @@ export class WasmSession {
      * `{ url: { url } }`. Fetch them however you like — in parallel, with
      * whatever retry policy — then settle each with
      * [`completeFontRequest`](Self::complete_font_request) and call
-     * [`refreshFonts`](Self::refresh_fonts) once for the batch.
+     * [`refreshFonts`](Self::refresh_fonts) once for a batch that brought a
+     * font. A batch of refusals needs none: it installed nothing, and the next
+     * vendors' orders are already waiting here.
      *
      * Nothing here blocks or waits: an order is out until it is settled, and the
      * document keeps rendering in a stand-in throughout.
@@ -3669,11 +3687,13 @@ export class WasmSession {
         }
     }
     /**
-     * Compose ahead through page index `page_limit`, growing the composed
-     * prefix, and return whether the document is now **fully composed**. The
-     * idle compose-ahead seam: the host calls it from `requestIdleCallback`
-     * with a rising limit (e.g. `composedPageCount + 1` to advance one page)
-     * until it returns `true` — at which point
+     * Compose `scope` on the current plane — `{ pages: { start, limit } }`
+     * for a paged plane, growing the composed prefix through page index
+     * `limit`, or `{ rows: { start, limit } }` for a worksheet's grid — and
+     * return whether the plane is now **fully composed**. The idle
+     * compose-ahead seam: the host calls it from `requestIdleCallback` with a
+     * rising limit (e.g. `composedPageCount + 1` to advance one page) until it
+     * returns `true` — at which point
      * [`composedPageCount`](Self::composed_page_count) is the document's page
      * count. There is no total to ask for up front: a page is known only once
      * composed.
@@ -3687,14 +3707,15 @@ export class WasmSession {
      * `composedPageCount`.
      *
      * # Errors
-     * Returns a JS error if no document is open.
-     * @param {number} page_limit
+     * Returns a JS error if no document is open, or if `scope` isn't a
+     * [`LayoutScope`].
+     * @param {LayoutScope} scope
      * @returns {boolean}
      */
-    updateLayout(page_limit) {
+    updateLayout(scope) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.wasmsession_updateLayout(retptr, this.__wbg_ptr, page_limit);
+            wasm.wasmsession_updateLayout(retptr, this.__wbg_ptr, addBorrowedObject(scope));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -3704,6 +3725,7 @@ export class WasmSession {
             return r0 !== 0;
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
+            heap[stack_pointer++] = undefined;
         }
     }
     /**
@@ -3914,7 +3936,7 @@ function __wbg_get_imports() {
         __wbg_clip_5f059eebddcbe6ae: function(arg0) {
             getObject(arg0).clip();
         },
-        __wbg_covers_70a032ceb753624b: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
+        __wbg_covers_f7b1296b43fc610f: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
             const ret = getObject(arg0).covers(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
             return ret;
         }, arguments); },
@@ -3939,7 +3961,7 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_export4(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_fetch_905ef070afbf9d64: function() { return handleError(function (arg0) {
+        __wbg_fetch_b468ac3d8d7d6b29: function() { return handleError(function (arg0) {
             const ret = fetch(getObject(arg0));
             return addHeapObject(ret);
         }, arguments); },
@@ -4021,11 +4043,11 @@ function __wbg_get_imports() {
             const ret = getObject(arg0).length;
             return ret;
         },
-        __wbg_measure_52806bd0c0248e79: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
+        __wbg_measure_4a7db9e7c5b085b5: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
             const ret = getObject(arg0).measure(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
             return ret;
         }, arguments); },
-        __wbg_metrics_61e641fe3ecc3aa9: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_metrics_b1c7aa43e31c7d63: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = getObject(arg0).metrics(getStringFromWasm0(arg1, arg2));
             return addHeapObject(ret);
         }, arguments); },
@@ -4072,7 +4094,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_68519(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_74164(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -4143,7 +4165,7 @@ function __wbg_get_imports() {
         __wbg_randomFillSync_6c25eac9869eb53c: function() { return handleError(function (arg0, arg1) {
             getObject(arg0).randomFillSync(takeObject(arg1));
         }, arguments); },
-        __wbg_rasterize_802d05dbeea6e8ac: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) {
+        __wbg_rasterize_6d92bc147edd07ee: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) {
             const ret = getObject(arg0).rasterize(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), getArrayF64FromWasm0(arg5, arg6), arg7 === 0 ? undefined : arg8);
             return addHeapObject(ret);
         }, arguments); },
@@ -4246,8 +4268,8 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 15189, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_68517);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 15553, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_74162);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0) {
@@ -4279,10 +4301,10 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_68517(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_74162(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_68517(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_74162(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -4293,8 +4315,8 @@ function __wasm_bindgen_func_elem_68517(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_68519(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_68519(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_74164(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_74164(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 const FontPreviewImageFinalization = (typeof FinalizationRegistry === 'undefined')

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@docmentis/udoc-wasm",
-    "version": "0.8.2",
-    "description": "Generated udoc engine artifacts: the WASM binary + wasm-bindgen glue and its TypeScript ABI, which declares the command/model types.",
+    "version": "0.8.3",
+    "description": "WebAssembly document engine powering docMentis viewing, editing, and processing.",
     "license": "SEE LICENSE IN LICENSE",
     "type": "module",
     "sideEffects": [