@paged-media/canvas-wasm 0.71.7 → 0.71.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paged-media/canvas-wasm",
-  "version": "0.71.7",
+  "version": "0.71.8",
   "type": "module",
   "main": "paged_canvas_wasm.js",
   "types": "paged_canvas_wasm.d.ts",

package/paged_canvas_wasm.d.ts

@@ -759,7 +759,9 @@ export interface HitResult {
     bounds?: [number, number, number, number] | null;
     /**
      * Phase A — composed affine `[a, b, c, d, tx, ty]` on the hit
-     * element. `None` for items with no `ItemTransform`.
+     * element, into the hit page\'s space like `frame_bounds` (the
+     * page\'s origin inside its spread folded in). `None` for an item
+     * with no `ItemTransform` on a page at its spread\'s origin.
      */
     itemTransform?: [number, number, number, number, number, number] | null;
     /**
@@ -1135,8 +1137,9 @@ export type GestureHandle = number;
 /**
  * Oriented geometry for one selected element. `bounds` is the raw
  * `GeometricBounds` (content-box space); `item_transform` is the
- * composed affine. The overlay layer multiplies bounds corners by
- * the transform to draw the oriented selection chrome.
+ * composed affine into the PAGE the element sits on (see
+ * [`Self::item_transform`]). The overlay layer multiplies bounds
+ * corners by the transform to draw the oriented selection chrome.
  */
 export interface ElementGeometryItem {
     id: ElementId;
@@ -1151,7 +1154,8 @@ export interface ElementGeometryItem {
      * grouped something it then could not read back.
      *
      * **The convention `None` carries:** `bounds` + `item_transform`
-     * compose against the SPREAD origin rather than a page origin.
+     * compose against the SPREAD origin rather than a page origin (a
+     * page-owned item composes against its page\'s).
      * `spread_id` names which spread, because without it the answer is
      * unusable the moment a document has two.
      *
@@ -1170,9 +1174,23 @@ export interface ElementGeometryItem {
      */
     bounds: [number, number, number, number];
     /**
-     * `[a, b, c, d, tx, ty]`.
+     * `[a, b, c, d, tx, ty]`: `bounds` through it lands in the
+     * coordinates of `page_id`\'s page, `(0, 0)` at its top-left — the
+     * space of the hit test\'s `frameBounds`, carets, selection rects and
+     * the inserts. It is the stored `ItemTransform` with the page\'s
+     * origin inside its spread folded in ([`Self::page_origin`]); the two
+     * differ wherever a page does not start at its spread\'s origin (a
+     * verso, every page of an InDesign document). `moveFrame` takes it
+     * back in the same space. A pageless item answers in spread space.
      */
     itemTransform?: [number, number, number, number, number, number] | null;
+    /**
+     * The page\'s origin inside its spread, `[x, y]` in spread
+     * coordinates; `None` for a pageless item and a table cell. The
+     * stored `ItemTransform` (what the `frameTransform` property reads
+     * and writes) is `translate(page_origin) ∘ item_transform`. Additive.
+     */
+    pageOrigin?: [number, number];
     /**
      * Phase F — `true` when this element hosts a placed image
      * (`Rectangle` with `<Image>` / `<EPSImage>` / `<PDF>` /
@@ -1791,6 +1809,13 @@ export interface PageSummary {
      * 1-based index — what the user types in \"Go to page #\".
      */
     index: number;
+    /**
+     * The page\'s name as InDesign gives it: its folio, the label a
+     * page-number marker on it prints (`\"3\"`, `\"iv\"`, `\"A-2\"`) — the
+     * baked `Name` of a page InDesign wrote, else the number the section
+     * rules give it where it stands. Never the page\'s id. Additive.
+     */
+    name?: string;
     /**
      * `[width, height]` in points.
      */
@@ -1894,8 +1919,10 @@ export interface LinkSummary {
 /**
  * SDK Phase 5 (v1 sweep) — one spread summary. Backs
  * `documentCollection:spreads`. `pageCount` is the number of
- * `<Page>` children in the spread; `label` is the spread\'s
- * `Self` id (or filename when missing).
+ * `<Page>` children in the spread; `label` is what InDesign\'s Pages
+ * panel shows for it, its pages\' folios (`\"3\"`, `\"2–3\"`, see
+ * [`PageSummary::name`]) — the spread\'s `Self` id (or filename) only
+ * when it has no built page.
  */
 export interface SpreadSummary {
     selfId: string;
@@ -2015,9 +2042,15 @@ export interface PathAnchorsResult {
      */
     subpathOpen?: boolean[];
     /**
-     * `[a, b, c, d, tx, ty]`. None ⇒ identity.
+     * `[a, b, c, d, tx, ty]`. None ⇒ identity. Into the PAGE the path
+     * sits on, the page\'s origin folded in, exactly as
+     * [`ElementGeometryItem::item_transform`].
      */
     itemTransform?: [number, number, number, number, number, number] | null;
+    /**
+     * See [`ElementGeometryItem::page_origin`]. Additive.
+     */
+    pageOrigin?: [number, number];
 }
 
 /**

package/paged_canvas_wasm.js

@@ -1655,12 +1655,12 @@ function __wbg_get_imports() {
             arg0.writeTexture(arg1, getArrayU8FromWasm0(arg2, arg3), arg4, arg5);
         }, arguments); },
         __wbindgen_generic_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 5530, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 5573, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h90756ddb99d2201d);
             return ret;
         },
         __wbindgen_generic_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 6811, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 6856, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h78ff2cea7266d1aa);
             return ret;
         },