@paged-media/introspect-wasm 0.62.0 → 0.64.0

package/catalog.json

@@ -630,6 +630,13 @@
       "kind": "write",
       "summary": "Flip a condition's visibility."
     },
+    {
+      "name": "paged.setFlowGrowRule",
+      "params": "(storyId, grow, maxPages?, copyFrameOptions?)",
+      "returns": "bool",
+      "kind": "write",
+      "summary": "Let a story's frame chain grow: generated pages are added after its last frame's page while it oversets (InDesign's Smart Text Reflow), and removed when empty. copyFrameOptions gives generated frames the chain's frame options (a Word section's mode) instead of InDesign's defaults. grow=false clears the rule."
+    },
     {
       "name": "paged.activateConditionSet",
       "params": "(setId)",
@@ -756,12 +763,257 @@
       "kind": "write",
       "summary": "Set or clear the text caret/range."
     },
+    {
+      "name": "paged.reorderElement",
+      "params": "(id, target)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Raise or lower an element in its parent's z-order. target = front | back | forward | backward | {index: n} (n = the final slot, 0 = backmost)."
+    },
+    {
+      "name": "paged.pasteInto",
+      "params": "(containerId, childId)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Nest an existing item inside a container frame."
+    },
+    {
+      "name": "paged.releaseFrom",
+      "params": "(childId)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Lift a nested item back out of its container (inverse of pasteInto)."
+    },
+    {
+      "name": "paged.closePath",
+      "params": "(id, subpath?)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Close an open contour; subpath defaults to the whole path."
+    },
+    {
+      "name": "paged.joinPaths",
+      "params": "(id, otherId)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Weld two open paths into one."
+    },
+    {
+      "name": "paged.pathfinderDivide",
+      "params": "([id, ...])",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Divide the selection into its planar regions."
+    },
+    {
+      "name": "paged.pathfinderTrim",
+      "params": "([id, ...])",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Trim hidden parts of the lower shapes away."
+    },
+    {
+      "name": "paged.pathfinderMerge",
+      "params": "([id, ...])",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Merge adjacent same-paint regions of the selection."
+    },
+    {
+      "name": "paged.pathfinderCrop",
+      "params": "([id, ...])",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Crop the selection to the topmost shape."
+    },
+    {
+      "name": "paged.pathfinderOutline",
+      "params": "([id, ...])",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Reduce the selection to its outlined edges."
+    },
+    {
+      "name": "paged.pathfinderMinusBack",
+      "params": "([id, ...])",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Subtract the shapes behind from the frontmost one."
+    },
+    {
+      "name": "paged.pathfinderFaces",
+      "params": "([id, ...], [faceId, ...], mode)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Keep or drop named faces of the planar arrangement; mode = keep | remove. Face ids come from paged.planarRegions."
+    },
+    {
+      "name": "paged.planarRegions",
+      "params": "([id, ...], [x, y]?)",
+      "returns": "PlanarRegionsResult JSON",
+      "kind": "read",
+      "summary": "The planar arrangement of the named paths: found, faces (each with an id), inputCount, complete, reason. With a point, only the face under it. This is how a script names a face for pathfinderFaces."
+    },
+    {
+      "name": "paged.applyOpacityMask",
+      "params": "(targetId, maskId, {maskType?, invert?}?)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Mask one element with another."
+    },
+    {
+      "name": "paged.releaseOpacityMask",
+      "params": "(targetId)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Remove an element's opacity mask."
+    },
+    {
+      "name": "paged.attachTextToPath",
+      "params": "(id, storyId, {pathTypeAlignment?, flipPathEffect?, startBracket?, endBracket?}?)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Run a story along a path."
+    },
+    {
+      "name": "paged.detachTextFromPath",
+      "params": "(id)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Take a story back off its path."
+    },
+    {
+      "name": "paged.insertAnchoredFrame",
+      "params": "(storyId, offset, width, height, imageUri?)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Anchor a frame in the text at a story offset; with imageUri the frame is created holding that image."
+    },
+    {
+      "name": "paged.insertHyperlink",
+      "params": "(storyId, start, end, url)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Make a character range a clickable link. Read the result with paged.collection(\"hyperlinks\") — paged.links() is the placed-asset list, not this."
+    },
+    {
+      "name": "paged.layerSetVisible",
+      "params": "(layerId, visible)",
+      "returns": "bool",
+      "kind": "write",
+      "summary": "Show or hide a layer."
+    },
+    {
+      "name": "paged.layerSetLocked",
+      "params": "(layerId, locked)",
+      "returns": "bool",
+      "kind": "write",
+      "summary": "Lock or unlock a layer."
+    },
+    {
+      "name": "paged.layerSetPrintable",
+      "params": "(layerId, printable)",
+      "returns": "bool",
+      "kind": "write",
+      "summary": "Include a layer in output, or hold it back."
+    },
+    {
+      "name": "paged.layerSetName",
+      "params": "(layerId, name)",
+      "returns": "bool",
+      "kind": "write",
+      "summary": "Rename a layer."
+    },
+    {
+      "name": "paged.createSwatch",
+      "params": "(spec)",
+      "returns": "string (created id) | null",
+      "kind": "author",
+      "summary": "Create a swatch from a SwatchSpec ({space, value: [...], name?, model?, tint?}); returns its selfId."
+    },
+    {
+      "name": "paged.editSwatch",
+      "params": "(swatchId, spec)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Replace a swatch's definition."
+    },
+    {
+      "name": "paged.deleteSwatch",
+      "params": "(swatchId)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Delete a swatch."
+    },
+    {
+      "name": "paged.createGradient",
+      "params": "(spec)",
+      "returns": "string (created id) | null",
+      "kind": "author",
+      "summary": "Create a gradient from a GradientSpec ({kind: \"Linear\"|\"Radial\", stops: [...], name?}); returns its selfId."
+    },
+    {
+      "name": "paged.editGradient",
+      "params": "(gradientId, spec)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Replace a gradient's definition."
+    },
+    {
+      "name": "paged.deleteGradient",
+      "params": "(gradientId)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Delete a gradient."
+    },
+    {
+      "name": "paged.createColorGroup",
+      "params": "(spec)",
+      "returns": "string (created id) | null",
+      "kind": "author",
+      "summary": "Create a colour group from a ColorGroupSpec; returns its selfId."
+    },
+    {
+      "name": "paged.editColorGroup",
+      "params": "(groupId, spec)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Replace a colour group's definition."
+    },
+    {
+      "name": "paged.deleteColorGroup",
+      "params": "(groupId)",
+      "returns": "bool",
+      "kind": "author",
+      "summary": "Delete a colour group."
+    },
     {
       "name": "console.log",
       "params": "(...)",
       "returns": "undefined",
       "kind": "console",
-      "summary": "Append a line to the captured output log (also warn/error/info)."
+      "summary": "Append a line to the captured output log."
+    },
+    {
+      "name": "console.warn",
+      "params": "(...)",
+      "returns": "undefined",
+      "kind": "console",
+      "summary": "Append a warn-level line to the captured output log."
+    },
+    {
+      "name": "console.error",
+      "params": "(...)",
+      "returns": "undefined",
+      "kind": "console",
+      "summary": "Append an error-level line to the captured output log."
+    },
+    {
+      "name": "console.info",
+      "params": "(...)",
+      "returns": "undefined",
+      "kind": "console",
+      "summary": "Append an info-level line to the captured output log."
     }
   ],
   "idGrammar": [
@@ -924,6 +1176,7 @@
     "frameDirectionalFeatherNoise",
     "frameDirectionalFeatherChoke",
     "frameBlendMode",
+    "frameGradientFeather",
     "cellFillColor",
     "cellFillTint",
     "cellInsetTop",
@@ -943,8 +1196,6 @@
     "cellRightEdgeStrokeColor",
     "cellRightEdgeStrokeWeight",
     "cellRightEdgeStrokeTint",
-    "tableRowCount",
-    "tableColumnCount",
     "pluginMetadata",
     "anchoredPosition",
     "anchorPoint",
@@ -957,7 +1208,51 @@
     "anchoredSpineRelative",
     "anchoredLockPosition",
     "elementVisible",
-    "elementLocked"
+    "elementLocked",
+    "characterFontFamily",
+    "characterFontStyle",
+    "characterKerningMethod",
+    "characterCase",
+    "characterPosition",
+    "characterLanguage",
+    "characterBaselineShift",
+    "characterHorizontalScale",
+    "characterVerticalScale",
+    "characterSkew",
+    "characterUnderline",
+    "characterStrikethru",
+    "characterLigatures",
+    "characterOtfFeatures",
+    "paragraphLeftIndent",
+    "paragraphRightIndent",
+    "paragraphDropCapCharacters",
+    "paragraphDropCapLines",
+    "paragraphHyphenation",
+    "paragraphHyphenationZone",
+    "paragraphKeepLinesTogether",
+    "paragraphKeepWithNext",
+    "paragraphKeepAllLinesTogether",
+    "paragraphKeepFirstLines",
+    "paragraphKeepLastLines",
+    "paragraphStartParagraph",
+    "paragraphSpanColumnType",
+    "paragraphSpanSplitColumnCount",
+    "paragraphSpanColumnMinSpaceBefore",
+    "paragraphSpanColumnMinSpaceAfter",
+    "paragraphSplitColumnInsideGutter",
+    "paragraphSplitColumnOutsideGutter",
+    "paragraphRuleAbove",
+    "paragraphRuleBelow",
+    "paragraphTabStops",
+    "paragraphListType",
+    "paragraphBulletCharacter",
+    "paragraphNumberingFormat",
+    "paragraphBulletsTextAfter",
+    "paragraphNumberingExpression",
+    "paragraphNumberingStartAt",
+    "paragraphNumberingContinue",
+    "paragraphBulletsCharacterStyle",
+    "paragraphNumberingCharacterStyle"
   ],
   "constraints": [
     "Scripts run in Boa (pure ECMAScript), NOT Node: no require/import, fetch, fs, setTimeout, or network. Use only paged.* and console.*.",
@@ -968,6 +1263,126 @@
     "insertFrame/insertTextFrame return the new element's kind:id address (and auto-select it); insertPage returns the new page's selfId. Pass the returned id straight to paged.set / placeImage / insertText (use paged.pages() for a page id, paged.stories() for the minted story).",
     "Bounds are page-local points in [top, left, bottom, right] order. The document works in points (1/72 inch)."
   ],
+  "operations": [
+    "insertText",
+    "deleteRange",
+    "applyStyle",
+    "insertField",
+    "insertAnchoredFrame",
+    "insertHyperlink",
+    "setFieldValue",
+    "placeImage",
+    "replaceImageBytes",
+    "moveFrame",
+    "resizeFrame",
+    "linkFrames",
+    "unlinkFrames",
+    "insertPage",
+    "deletePage",
+    "resizePage",
+    "insertFrame",
+    "insertTextFrame",
+    "deleteFrame",
+    "insertLine",
+    "insertPath",
+    "setDocumentDefaults",
+    "setColorSettings",
+    "setProofSetup",
+    "importSwatchLibrary",
+    "setInkSetting",
+    "setUseStandardLabForSpots",
+    "pathPointInsert",
+    "pathPointRemove",
+    "pathOpenAt",
+    "outlineStroke",
+    "offsetPath",
+    "simplifyPath",
+    "closePath",
+    "joinPaths",
+    "pasteInto",
+    "releaseFrom",
+    "reorderElement",
+    "applyOpacityMask",
+    "releaseOpacityMask",
+    "attachTextToPath",
+    "detachTextFromPath",
+    "createGroup",
+    "dissolveGroup",
+    "setGroupTransform",
+    "setPluginMetadata",
+    "pathPointCurveType",
+    "pathPointSet",
+    "batch",
+    "bindCreated",
+    "layerSetVisible",
+    "layerSetLocked",
+    "layerSetPrintable",
+    "layerSetName",
+    "layerMove",
+    "layerInsert",
+    "layerRemove",
+    "setElementProperty",
+    "pathfinderBoolean",
+    "pathfinderDivide",
+    "pathfinderTrim",
+    "pathfinderMerge",
+    "pathfinderCrop",
+    "pathfinderOutline",
+    "pathfinderMinusBack",
+    "pathfinderFaces",
+    "createSwatch",
+    "editSwatch",
+    "deleteSwatch",
+    "createGradient",
+    "editGradient",
+    "deleteGradient",
+    "createColorGroup",
+    "editColorGroup",
+    "deleteColorGroup",
+    "createNumberingList",
+    "editNumberingList",
+    "deleteNumberingList",
+    "createParagraphStyle",
+    "renameParagraphStyle",
+    "deleteParagraphStyle",
+    "createCharacterStyle",
+    "renameCharacterStyle",
+    "deleteCharacterStyle",
+    "createObjectStyle",
+    "renameObjectStyle",
+    "deleteObjectStyle",
+    "createCellStyle",
+    "renameCellStyle",
+    "deleteCellStyle",
+    "createTableStyle",
+    "renameTableStyle",
+    "deleteTableStyle",
+    "setStyleProperty",
+    "insertOval",
+    "insertGuide",
+    "moveGuide",
+    "deleteGuide",
+    "setConditionVisible",
+    "setFlowGrowRule",
+    "activateConditionSet",
+    "applyMasterToPage",
+    "duplicatePage",
+    "insertSection",
+    "editSection",
+    "deleteSection",
+    "setRowHeight",
+    "setColumnWidth",
+    "insertTableRow",
+    "deleteTableRow",
+    "insertTableColumn",
+    "deleteTableColumn",
+    "insertHeaderRow",
+    "removeHeaderRow",
+    "insertFooterRow",
+    "removeFooterRow",
+    "setCellSpan",
+    "insertTable"
+  ],
   "elements": [
     {
       "name": "TextFrame",
@@ -1329,5 +1744,39 @@
         }
       ]
     }
+  ],
+  "pathAliases": [
+    {
+      "name": "frameTextWrapInvert",
+      "wire": "textWrapInvert"
+    },
+    {
+      "name": "frameInnerShadow",
+      "wire": "frameInnerShadowEnabled"
+    },
+    {
+      "name": "frameOuterGlow",
+      "wire": "frameOuterGlowEnabled"
+    },
+    {
+      "name": "frameInnerGlow",
+      "wire": "frameInnerGlowEnabled"
+    },
+    {
+      "name": "frameBevel",
+      "wire": "frameBevelEnabled"
+    },
+    {
+      "name": "frameSatin",
+      "wire": "frameSatinEnabled"
+    },
+    {
+      "name": "frameFeather",
+      "wire": "frameFeatherEnabled"
+    },
+    {
+      "name": "frameDirectionalFeather",
+      "wire": "frameDirectionalFeatherEnabled"
+    }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paged-media/introspect-wasm",
-  "version": "0.62.0",
+  "version": "0.64.0",
   "type": "module",
   "main": "paged_introspect_wasm.js",
   "types": "paged_introspect_wasm.d.ts",

package/paged_introspect_wasm.d.ts

@@ -5,6 +5,17 @@
  */
 export type ScenePathSeg = { op: "moveTo"; x: number; y: number } | { op: "lineTo"; x: number; y: number } | { op: "cubicTo"; cx1: number; cy1: number; cx2: number; cy2: number; x: number; y: number } | { op: "close" };
 
+/**
+ * A byte buffer that crosses the message channel. Wraps `Vec<u8>`
+ * so transferable-via-`postMessage` semantics are explicit at call
+ * sites; the wasm crate decides whether to clone or transfer based
+ * on whether the value is the JS-side `Uint8Array` or a Rust-side
+ * `Vec`. The wire form is whatever serde produces for `Vec<u8>` —
+ * JSON renders an array of numbers; future binary protocols (CBOR
+ * / messagepack) render a real bytes blob without code change.
+ */
+export type ByteBuf = number[];
+
 /**
  * A compositing blend mode for [`SceneItem::FillPathBlend`] (C-1.4).
  * Mirrors the CSS-relevant subset of the display list\'s
@@ -15,6 +26,17 @@ export type ScenePathSeg = { op: "moveTo"; x: number; y: number } | { op: "lineT
  */
 export type SceneBlendMode = "multiply" | "screen" | "overlay" | "darken" | "lighten" | "colorDodge" | "colorBurn" | "hardLight" | "softLight" | "difference" | "exclusion" | "hue" | "saturation" | "color" | "luminosity";
 
+/**
+ * A content-space mutation. Phase 1 carries the *envelope* only —
+ * the worker rejects each variant with `WorkerError::NotImplemented`.
+ * Phase 3 lights these up incrementally.
+ *
+ * Behind the default `mutations` feature: its payload types come from
+ * `paged-mutate`, and the read-only viewer SDK must not link that.
+ * See the crate docs.
+ */
+export type Mutation = { op: "insertText"; args: { storyId: string; offset: number; text: string; cell?: TextCellAddr | null } } | { op: "deleteRange"; args: { storyId: string; start: number; end: number; cell?: TextCellAddr | null } } | { op: "applyStyle"; args: { storyId: string; start: number; end: number; style: string; scope: StyleScope; cell?: TextCellAddr | null } } | { op: "insertField"; args: { storyId: string; offset: number; field: FieldKind } } | { op: "insertAnchoredFrame"; args: { storyId: string; offset: number; width: number; height: number; imageUri?: string | null } } | { op: "insertHyperlink"; args: { storyId: string; start: number; end: number; url: string } } | { op: "setFieldValue"; args: { storyId: string; offset: number; value?: string | null } } | { op: "placeImage"; args: { elementId: string; uri: string; fit?: string | null } } | { op: "replaceImageBytes"; args: { elementId: string; bytes?: number[] | null } } | { op: "moveFrame"; args: { frameId: string; transform: [number, number, number, number, number, number] } } | { op: "resizeFrame"; args: { frameId: string; bounds: [number, number, number, number] } } | { op: "linkFrames"; args: { from: string; to: string } } | { op: "unlinkFrames"; args: { frame: string } } | { op: "insertPage"; args: { afterPageId: PageId | null; masterId: string | null } } | { op: "deletePage"; args: { pageId: PageId } } | { op: "resizePage"; args: { pageId: PageId; bounds: [number, number, number, number] } } | { op: "insertFrame"; args: { pageId: PageId; bounds: [number, number, number, number] } } | { op: "insertTextFrame"; args: { pageId: PageId; bounds: [number, number, number, number] } } | { op: "deleteFrame"; args: { frameId: string } } | { op: "insertLine"; args: { pageId: PageId; start: [number, number]; end: [number, number] } } | { op: "insertPath"; args: { pageId: PageId; anchors: PathAnchorSpec[]; open: boolean; smooth?: boolean } } | { op: "setDocumentDefaults"; args: { fillColor: string | null; strokeColor: string | null; strokeWeight: number | null } } | { op: "setColorSettings"; args: { cmykProfileName: string | null; rgbPolicy: string | null; intent: string | null; bpc: boolean | null } } | { op: "setProofSetup"; args: { profileName: string | null; simulatePaperWhite?: boolean; intent: string | null } } | { op: "importSwatchLibrary"; args: { bytes: number[]; groupName?: string | null } } | { op: "setInkSetting"; args: { spotId: string; convertToProcess?: boolean; aliasTo?: string | null } } | { op: "setUseStandardLabForSpots"; args: { enabled: boolean } } | { op: "pathPointInsert"; args: { elementId: ElementId; index: number; anchor: PathAnchorSpec; prevSubpathStarts?: number[] | null } } | { op: "pathPointRemove"; args: { elementId: ElementId; index: number } } | { op: "pathOpenAt"; args: { elementId: ElementId; index: number } } | { op: "outlineStroke"; args: { elementId: ElementId; width: number; cap: string; join: string; miterLimit: number } } | { op: "offsetPath"; args: { elementId: ElementId; delta: number; join: string; miterLimit: number } } | { op: "simplifyPath"; args: { elementId: ElementId; tolerance: number } } | { op: "closePath"; args: { elementId: ElementId; subpath?: number | null } } | { op: "joinPaths"; args: { elementId: ElementId; otherId: ElementId } } | { op: "pasteInto"; args: { containerId: ElementId; childId: ElementId } } | { op: "releaseFrom"; args: { childId: ElementId } } | { op: "reorderElement"; args: { elementId: ElementId; to: ZOrderTarget } } | { op: "applyOpacityMask"; args: { targetId: ElementId; maskId: ElementId; maskType?: string | null; invert?: boolean | null } } | { op: "releaseOpacityMask"; args: { targetId: ElementId } } | { op: "attachTextToPath"; args: { elementId: ElementId; storyId: string; pathTypeAlignment?: string | null; flipPathEffect?: string | null; startBracket?: number | null; endBracket?: number | null } } | { op: "detachTextFromPath"; args: { elementId: ElementId } } | { op: "createGroup"; args: { memberIds: ElementId[] } } | { op: "dissolveGroup"; args: { groupId: string } } | { op: "setGroupTransform"; args: { groupId: string; transform?: [number, number, number, number, number, number] | null } } | { op: "setPluginMetadata"; args: { elementId: ElementId; key: string; value?: string | null; caller?: string | null } } | { op: "pathPointCurveType"; args: { elementId: ElementId; index: number; smooth: boolean } } | { op: "pathPointSet"; args: { elementId: ElementId; index: number; role: PathPointRole; position: [number, number] } } | { op: "batch"; args: { ops: Mutation[] } } | { op: "bindCreated"; args: { handle: string } } | { op: "layerSetVisible"; args: { layerId: string; visible: boolean } } | { op: "layerSetLocked"; args: { layerId: string; locked: boolean } } | { op: "layerSetPrintable"; args: { layerId: string; printable: boolean } } | { op: "layerSetName"; args: { layerId: string; name: string } } | { op: "layerMove"; args: { layerId: string; newIndex: number } } | { op: "layerInsert"; args: { position: number; name: string } } | { op: "layerRemove"; args: { layerId: string } } | { op: "setElementProperty"; args: { elementId: ElementId; path: PropertyPath; value: Value } } | { op: "pathfinderBoolean"; args: { kept: ElementId; others: ElementId[]; kind: PathfinderKind } } | { op: "pathfinderDivide"; args: { elementIds: ElementId[] } } | { op: "pathfinderTrim"; args: { elementIds: ElementId[] } } | { op: "pathfinderMerge"; args: { elementIds: ElementId[] } } | { op: "pathfinderCrop"; args: { elementIds: ElementId[] } } | { op: "pathfinderOutline"; args: { elementIds: ElementId[] } } | { op: "pathfinderMinusBack"; args: { elementIds: ElementId[] } } | { op: "pathfinderFaces"; args: { elementIds: ElementId[]; faces: string[]; mode: FaceSelectMode } } | { op: "createSwatch"; args: { spec: SwatchSpec } } | { op: "editSwatch"; args: { swatchId: string; spec: SwatchSpec } } | { op: "deleteSwatch"; args: { swatchId: string } } | { op: "createGradient"; args: { spec: GradientSpec } } | { op: "editGradient"; args: { gradientId: string; spec: GradientSpec } } | { op: "deleteGradient"; args: { gradientId: string } } | { op: "createColorGroup"; args: { spec: ColorGroupSpec } } | { op: "editColorGroup"; args: { groupId: string; spec: ColorGroupSpec } } | { op: "deleteColorGroup"; args: { groupId: string } } | { op: "createNumberingList"; args: { spec: NumberingListSpec } } | { op: "editNumberingList"; args: { listId: string; spec: NumberingListSpec } } | { op: "deleteNumberingList"; args: { listId: string } } | { op: "createParagraphStyle"; args: { selfId?: string | null; name?: string | null; basedOn?: string | null } } | { op: "renameParagraphStyle"; args: { styleId: string; name: string } } | { op: "deleteParagraphStyle"; args: { styleId: string } } | { op: "createCharacterStyle"; args: { selfId?: string | null; name?: string | null; basedOn?: string | null } } | { op: "renameCharacterStyle"; args: { styleId: string; name: string } } | { op: "deleteCharacterStyle"; args: { styleId: string } } | { op: "createObjectStyle"; args: { selfId?: string | null; name?: string | null; basedOn?: string | null } } | { op: "renameObjectStyle"; args: { styleId: string; name: string } } | { op: "deleteObjectStyle"; args: { styleId: string } } | { op: "createCellStyle"; args: { selfId?: string | null; name?: string | null; basedOn?: string | null } } | { op: "renameCellStyle"; args: { styleId: string; name: string } } | { op: "deleteCellStyle"; args: { styleId: string } } | { op: "createTableStyle"; args: { selfId?: string | null; name?: string | null; basedOn?: string | null } } | { op: "renameTableStyle"; args: { styleId: string; name: string } } | { op: "deleteTableStyle"; args: { styleId: string } } | { op: "setStyleProperty"; args: { collection: StyleCollection; styleId: string; path: PropertyPath; value: Value } } | { op: "insertOval"; args: { pageId: PageId; bounds: [number, number, number, number] } } | { op: "insertGuide"; args: { spreadId: string; orientation: GuideOrientationSpec; position: number; pageIndex?: number } } | { op: "moveGuide"; args: { guideId: string; position: number } } | { op: "deleteGuide"; args: { guideId: string } } | { op: "setConditionVisible"; args: { condition: string; visible: boolean } } | { op: "setFlowGrowRule"; args: { storyId: string; grow: boolean; maxPages?: number | null; copyFrameOptions?: boolean | null } } | { op: "activateConditionSet"; args: { set: string } } | { op: "applyMasterToPage"; args: { page: PageId; master?: string | null } } | { op: "duplicatePage"; args: { page: PageId } } | { op: "insertSection"; args: { atPage: PageId; prefix?: string | null; numberingStyle?: string | null; startAt?: number | null } } | { op: "editSection"; args: { sectionId: string; prefix?: string | null | null; numberingStyle?: string | null; startAt?: number | null | null } } | { op: "deleteSection"; args: { sectionId: string } } | { op: "setRowHeight"; args: { storyId: string; tableId: string; row: number; height?: number | null } } | { op: "setColumnWidth"; args: { storyId: string; tableId: string; col: number; width?: number | null } } | { op: "insertTableRow"; args: { storyId: string; tableId: string; at: number } } | { op: "deleteTableRow"; args: { storyId: string; tableId: string; at: number } } | { op: "insertTableColumn"; args: { storyId: string; tableId: string; at: number } } | { op: "deleteTableColumn"; args: { storyId: string; tableId: string; at: number } } | { op: "insertHeaderRow"; args: { storyId: string; tableId: string } } | { op: "removeHeaderRow"; args: { storyId: string; tableId: string } } | { op: "insertFooterRow"; args: { storyId: string; tableId: string } } | { op: "removeFooterRow"; args: { storyId: string; tableId: string } } | { op: "setCellSpan"; args: { storyId: string; tableId: string; row: number; col: number; rowSpan: number; columnSpan: number } } | { op: "insertTable"; args: { storyId: string; rows: number; cols: number; headerRows?: number; footerRows?: number; columnWidths?: number[]; rowHeights?: number[] } };
+
 /**
  * A plugin gradient paint for [`SceneItem::FillPathGradient`] (C-1.3).
  * Coordinates are frame-content points (mapped by the frame transform
@@ -222,6 +244,19 @@ export interface GradientFeatherStopSpec {
     midpointPct?: number;
 }
 
+/**
+ * Element address the user can select OR a `SetElementProperty`
+ * mutation can target. The first six variants are page items
+ * (selection state holds these); `StoryRange` is the half-open
+ * character range that character / paragraph property writes
+ * address. Selection state today never holds `StoryRange` (the
+ * text-side caret + range live in `ContentSelection`); the
+ * variant exists so the apply layer can be reached via the
+ * existing `Mutation::SetElementProperty` wire shape — see
+ * `docs/paged/sdk-implementation-plan.md` §3c.1 ADR.
+ */
+export type ElementId = { kind: "textFrame"; id: string } | { kind: "rectangle"; id: string } | { kind: "oval"; id: string } | { kind: "polygon"; id: string } | { kind: "graphicLine"; id: string } | { kind: "group"; id: string } | { kind: "storyRange"; id: { story_id: string; start: number; end: number } } | { kind: "table"; id: { story_id: string; table_id: string } } | { kind: "tableCell"; id: { story_id: string; table_id: string; row: number; col: number } };
+
 /**
  * Hint to downstream caches about what the apply touched. Lists
  * instead of a single enum so a Batch aggregates by union without
@@ -239,6 +274,16 @@ export interface InvalidationHint {
     structural: boolean;
 }
 
+/**
+ * How a `SetElementSelection` request combines with the current set.
+ * Mirrors the canonical macOS / industry convention:
+ * - `Replace` — plain click; selection becomes the request.
+ * - `Add` — Shift-click; union (already-selected ids stay).
+ * - `Toggle` — Cmd/Ctrl-click; ids already in the set are removed,
+ *   ids not in the set are added.
+ */
+export type SelectionMode = "replace" | "add" | "toggle";
+
 /**
  * One RGBA8 tile of a [`PixelLayer`]. `rgba` is tightly packed
  * (`width*height*4`, row-major); the tile is placed at the `(x, y)`
@@ -341,25 +386,13 @@ export type PathfinderKind = "union" | "intersect" | "subtract" | "exclude";
  */
 export type NodeId = { kind: "TextFrame"; id: string } | { kind: "Rectangle"; id: string } | { kind: "Oval"; id: string } | { kind: "Polygon"; id: string } | { kind: "GraphicLine"; id: string } | { kind: "Group"; id: string } | { kind: "Spread"; id: string } | { kind: "Page"; id: string } | { kind: "Story"; id: string } | { kind: "Layer"; id: string } | { kind: "StoryRange"; id: { story_id: string; start: number; end: number } } | { kind: "Table"; id: { story_id: string; table_id: string } } | { kind: "TableCell"; id: { story_id: string; table_id: string; row: number; col: number } };
 
-/**
- * Stable page identity, independent of position in the page vector.
- *
- * Derived from the IDML `<Page Self=\"...\">` attribute where present;
- * synthesised as `\"page-<spread_idx>-<local_idx>\"` when missing
- * (older / synthetic fixtures without `Self`). The canvas keys
- * display-list caches and LOD tiles by `PageId`, so the value must
- * stay stable across re-layouts — only document-structural edits
- * (insert/delete page) should ever change the set of `PageId`s.
- */
-export type PageId = string;
-
 /**
  * The canonical mutation primitive. A closed set, extended only with
  * deliberation. Collection mutations (swatches, styles) operate on the
  * document\'s `BTreeMap` palettes/stylesheets rather than the scene
  * tree, so they\'re top-level variants rather than `InsertNode`.
  */
-export type Operation = { kind: "SetProperty"; node: NodeId; path: PropertyPath; value: Value } | { kind: "InsertNode"; parent: NodeId; position: number; node: NodeSpec; z_slot?: number | null } | { kind: "RemoveNode"; node: NodeId } | { kind: "MoveNode"; node: NodeId; new_parent: NodeId; position: number } | { kind: "ReorderNode"; node: NodeId; target: ZOrderTarget } | { kind: "Batch"; ops: Operation[] } | { kind: "InsertPage"; after_page_id?: string | null; master_id?: string | null; spread_self_id?: string | null; page_self_id?: string | null; restore_spread_json?: string | null } | { kind: "RemovePage"; page_id: string } | { kind: "MoveLayer"; layer_id: string; new_index: number } | { kind: "InsertLayer"; position: number; name: string; self_id?: string | null } | { kind: "RemoveLayer"; layer_id: string } | { kind: "CreateSwatch"; spec: SwatchSpec } | { kind: "EditSwatch"; swatch_id: string; spec: SwatchSpec } | { kind: "DeleteSwatch"; swatch_id: string } | { kind: "CreateParagraphStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameParagraphStyle"; style_id: string; name: string } | { kind: "DeleteParagraphStyle"; style_id: string } | { kind: "CreateCharacterStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameCharacterStyle"; style_id: string; name: string } | { kind: "DeleteCharacterStyle"; style_id: string } | { kind: "CreateObjectStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameObjectStyle"; style_id: string; name: string } | { kind: "DeleteObjectStyle"; style_id: string } | { kind: "CreateCellStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameCellStyle"; style_id: string; name: string } | { kind: "DeleteCellStyle"; style_id: string } | { kind: "CreateTableStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameTableStyle"; style_id: string; name: string } | { kind: "DeleteTableStyle"; style_id: string } | { kind: "CreateGroup"; spec: GroupSpec } | { kind: "DissolveGroup"; group_id: string; restore_slots?: number[] | null } | { kind: "SetGroupTransform"; group: string; transform?: [number, number, number, number, number, number] | null; prev?: [number, number, number, number, number, number] | null } | { kind: "CreateGradient"; spec: GradientSpec } | { kind: "EditGradient"; gradient_id: string; spec: GradientSpec } | { kind: "DeleteGradient"; gradient_id: string } | { kind: "CreateColorGroup"; spec: ColorGroupSpec } | { kind: "EditColorGroup"; group_id: string; spec: ColorGroupSpec } | { kind: "DeleteColorGroup"; group_id: string } | { kind: "CreateNumberingList"; spec: NumberingListSpec } | { kind: "EditNumberingList"; list_id: string; spec: NumberingListSpec } | { kind: "DeleteNumberingList"; list_id: string } | { kind: "SetStyleProperty"; collection: StyleCollection; style_id: string; path: PropertyPath; value: Value } | { kind: "PathfinderBoolean"; kept: NodeId; others: NodeId[]; opKind: PathfinderKind } | { kind: "PathfinderRegion"; elements: NodeId[]; verb: PathfinderRegionVerb } | { kind: "PathfinderFaces"; elements: NodeId[]; faces: string[]; mode: FaceSelectMode } | { kind: "JoinPaths"; kept: NodeId; other: NodeId } | { kind: "PasteInto"; container: NodeId; child: NodeId; child_index?: number | null } | { kind: "ReleaseFrom"; child: NodeId; restore_slot?: number | null } | { kind: "ApplyOpacityMask"; target: NodeId; mask: NodeId; mask_type?: OpacityMaskMode; invert?: boolean } | { kind: "ReleaseOpacityMask"; target: NodeId; restore_slot?: number | null } | { kind: "AttachTextToPath"; host: NodeId; story_id: string; spec?: TextPathSpec } | { kind: "DetachTextFromPath"; host: NodeId; index?: number | null; restore?: TextPathSpec | null } | { kind: "LinkFrames"; from: string; to: string } | { kind: "UnlinkFrames"; frame: string; prev_next?: string | null; restore_target?: [string, string | null, string | null] | null } | { kind: "ApplyStyle"; story_id: string; start: number; end: number; style: string; scope: StyleScope; cell?: CellAddr | null } | { kind: "InsertField"; story_id: string; offset: number; field: FieldKind } | { kind: "DeleteField"; story_id: string; offset: number; field: FieldKind } | { kind: "InsertAnchoredFrame"; story_id: string; offset: number; width: number; height: number; image_uri?: string | null; self_id: string } | { kind: "RemoveAnchoredFrame"; story_id: string; self_id: string } | { kind: "InsertHyperlink"; story_id: string; start: number; end: number; url: string; source_id: string; dest_id: string; hyperlink_id: string } | { kind: "RemoveHyperlink"; story_id: string; start: number; end: number; url: string; source_id: string; dest_id: string; hyperlink_id: string } | { kind: "SetFieldValue"; story_id: string; offset: number; value?: string | null } | { kind: "PlaceImage"; frame: NodeId; image_uri?: string | null; fit?: string | null } | { kind: "ReplaceImageBytes"; frame: NodeId; bytes?: number[] | null; prior_has_image_element?: boolean | null } | { kind: "InsertGuide"; spread_id: string; orientation: GuideOrientationSpec; position: number; page_index?: number; guide_id?: string | null } | { kind: "MoveGuide"; guide_id: string; position: number } | { kind: "DeleteGuide"; guide_id: string } | { kind: "SetConditionVisible"; condition: string; visible: boolean } | { kind: "ActivateConditionSet"; set: string } | { kind: "RestoreConditionVisibility"; states: [string, boolean][] } | { kind: "ApplyMasterToPage"; page: string; master?: string | null } | { kind: "DuplicatePage"; page: string; clone_spread_json?: string | null } | { kind: "InsertSection"; at_page: string; prefix?: string | null; numbering_style?: string | null; start_at?: number | null; self_id?: string | null } | { kind: "EditSection"; section_id: string; prefix?: string | null | null; numbering_style?: string | null; start_at?: number | null | null } | { kind: "DeleteSection"; section_id: string } | { kind: "SetRowHeight"; story_id: string; table_id: string; row: number; height?: number | null } | { kind: "SetColumnWidth"; story_id: string; table_id: string; col: number; width?: number | null } | { kind: "InsertTableRow"; story_id: string; table_id: string; at: number; restore?: TableLineRestoreJson | null } | { kind: "DeleteTableRow"; story_id: string; table_id: string; at: number } | { kind: "InsertTableColumn"; story_id: string; table_id: string; at: number; restore?: TableLineRestoreJson | null } | { kind: "DeleteTableColumn"; story_id: string; table_id: string; at: number } | { kind: "InsertHeaderRow"; story_id: string; table_id: string; restore?: TableLineRestoreJson | null } | { kind: "RemoveHeaderRow"; story_id: string; table_id: string } | { kind: "InsertFooterRow"; story_id: string; table_id: string; restore?: TableLineRestoreJson | null } | { kind: "RemoveFooterRow"; story_id: string; table_id: string } | { kind: "SetCellSpan"; story_id: string; table_id: string; row: number; col: number; row_span: number; column_span: number };
+export type Operation = { kind: "SetProperty"; node: NodeId; path: PropertyPath; value: Value } | { kind: "InsertNode"; parent: NodeId; position: number; node: NodeSpec; z_slot?: number | null } | { kind: "RemoveNode"; node: NodeId } | { kind: "MoveNode"; node: NodeId; new_parent: NodeId; position: number } | { kind: "ReorderNode"; node: NodeId; target: ZOrderTarget } | { kind: "Batch"; ops: Operation[] } | { kind: "InsertPage"; after_page_id?: string | null; master_id?: string | null; spread_self_id?: string | null; page_self_id?: string | null; restore_spread_json?: string | null } | { kind: "RemovePage"; page_id: string } | { kind: "MoveLayer"; layer_id: string; new_index: number } | { kind: "InsertLayer"; position: number; name: string; self_id?: string | null } | { kind: "RemoveLayer"; layer_id: string } | { kind: "CreateSwatch"; spec: SwatchSpec } | { kind: "EditSwatch"; swatch_id: string; spec: SwatchSpec } | { kind: "DeleteSwatch"; swatch_id: string } | { kind: "CreateParagraphStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameParagraphStyle"; style_id: string; name: string } | { kind: "DeleteParagraphStyle"; style_id: string } | { kind: "CreateCharacterStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameCharacterStyle"; style_id: string; name: string } | { kind: "DeleteCharacterStyle"; style_id: string } | { kind: "CreateObjectStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameObjectStyle"; style_id: string; name: string } | { kind: "DeleteObjectStyle"; style_id: string } | { kind: "CreateCellStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameCellStyle"; style_id: string; name: string } | { kind: "DeleteCellStyle"; style_id: string } | { kind: "CreateTableStyle"; self_id?: string | null; name?: string | null; based_on?: string | null; restore_json?: string | null } | { kind: "RenameTableStyle"; style_id: string; name: string } | { kind: "DeleteTableStyle"; style_id: string } | { kind: "CreateGroup"; spec: GroupSpec } | { kind: "DissolveGroup"; group_id: string; restore_slots?: number[] | null } | { kind: "SetGroupTransform"; group: string; transform?: [number, number, number, number, number, number] | null; prev?: [number, number, number, number, number, number] | null } | { kind: "CreateGradient"; spec: GradientSpec } | { kind: "EditGradient"; gradient_id: string; spec: GradientSpec } | { kind: "DeleteGradient"; gradient_id: string } | { kind: "CreateColorGroup"; spec: ColorGroupSpec } | { kind: "EditColorGroup"; group_id: string; spec: ColorGroupSpec } | { kind: "DeleteColorGroup"; group_id: string } | { kind: "CreateNumberingList"; spec: NumberingListSpec } | { kind: "EditNumberingList"; list_id: string; spec: NumberingListSpec } | { kind: "DeleteNumberingList"; list_id: string } | { kind: "SetStyleProperty"; collection: StyleCollection; style_id: string; path: PropertyPath; value: Value } | { kind: "PathfinderBoolean"; kept: NodeId; others: NodeId[]; opKind: PathfinderKind } | { kind: "PathfinderRegion"; elements: NodeId[]; verb: PathfinderRegionVerb } | { kind: "PathfinderFaces"; elements: NodeId[]; faces: string[]; mode: FaceSelectMode } | { kind: "JoinPaths"; kept: NodeId; other: NodeId } | { kind: "PasteInto"; container: NodeId; child: NodeId; child_index?: number | null } | { kind: "ReleaseFrom"; child: NodeId; restore_slot?: number | null } | { kind: "ApplyOpacityMask"; target: NodeId; mask: NodeId; mask_type?: OpacityMaskMode; invert?: boolean } | { kind: "ReleaseOpacityMask"; target: NodeId; restore_slot?: number | null } | { kind: "AttachTextToPath"; host: NodeId; story_id: string; spec?: TextPathSpec } | { kind: "DetachTextFromPath"; host: NodeId; index?: number | null; restore?: TextPathSpec | null } | { kind: "LinkFrames"; from: string; to: string } | { kind: "UnlinkFrames"; frame: string; prev_next?: string | null; restore_target?: [string, string | null, string | null] | null } | { kind: "ApplyStyle"; story_id: string; start: number; end: number; style: string; scope: StyleScope; cell?: CellAddr | null } | { kind: "InsertField"; story_id: string; offset: number; field: FieldKind } | { kind: "DeleteField"; story_id: string; offset: number; field: FieldKind } | { kind: "InsertAnchoredFrame"; story_id: string; offset: number; width: number; height: number; image_uri?: string | null; self_id: string } | { kind: "RemoveAnchoredFrame"; story_id: string; self_id: string } | { kind: "InsertHyperlink"; story_id: string; start: number; end: number; url: string; source_id: string; dest_id: string; hyperlink_id: string } | { kind: "RemoveHyperlink"; story_id: string; start: number; end: number; url: string; source_id: string; dest_id: string; hyperlink_id: string } | { kind: "SetFieldValue"; story_id: string; offset: number; value?: string | null } | { kind: "PlaceImage"; frame: NodeId; image_uri?: string | null; fit?: string | null } | { kind: "ReplaceImageBytes"; frame: NodeId; bytes?: number[] | null; prior_has_image_element?: boolean | null } | { kind: "InsertGuide"; spread_id: string; orientation: GuideOrientationSpec; position: number; page_index?: number; guide_id?: string | null } | { kind: "MoveGuide"; guide_id: string; position: number } | { kind: "DeleteGuide"; guide_id: string } | { kind: "SetConditionVisible"; condition: string; visible: boolean } | { kind: "SetFlowGrowRule"; story_id: string; rule: FlowGrowRule | null } | { kind: "ActivateConditionSet"; set: string } | { kind: "RestoreConditionVisibility"; states: [string, boolean][] } | { kind: "ApplyMasterToPage"; page: string; master?: string | null } | { kind: "DuplicatePage"; page: string; clone_spread_json?: string | null } | { kind: "InsertSection"; at_page: string; prefix?: string | null; numbering_style?: string | null; start_at?: number | null; self_id?: string | null } | { kind: "EditSection"; section_id: string; prefix?: string | null | null; numbering_style?: string | null; start_at?: number | null | null } | { kind: "DeleteSection"; section_id: string } | { kind: "SetRowHeight"; story_id: string; table_id: string; row: number; height?: number | null } | { kind: "SetColumnWidth"; story_id: string; table_id: string; col: number; width?: number | null } | { kind: "InsertTableRow"; story_id: string; table_id: string; at: number; restore?: TableLineRestoreJson | null } | { kind: "DeleteTableRow"; story_id: string; table_id: string; at: number } | { kind: "InsertTableColumn"; story_id: string; table_id: string; at: number; restore?: TableLineRestoreJson | null } | { kind: "DeleteTableColumn"; story_id: string; table_id: string; at: number } | { kind: "InsertHeaderRow"; story_id: string; table_id: string; restore?: TableLineRestoreJson | null } | { kind: "RemoveHeaderRow"; story_id: string; table_id: string } | { kind: "InsertFooterRow"; story_id: string; table_id: string; restore?: TableLineRestoreJson | null } | { kind: "RemoveFooterRow"; story_id: string; table_id: string } | { kind: "SetCellSpan"; story_id: string; table_id: string; row: number; col: number; row_span: number; column_span: number };
 
 /**
  * Track J — wire-shape mirror of `paged_model::PathAnchor`. The
@@ -390,7 +423,7 @@ export type Value = { type: "bounds"; value: [number, number, number, number] }
  * (`\"fill.color\"`) — so JS callers don\'t need to learn the Rust
  * enum shape.
  */
-export type PropertyPath = "frameBounds" | "frameFillColor" | "frameStrokeColor" | "frameStrokeWeight" | "frameOpacity" | "frameTransform" | "imageContentTransform" | "framePathPoint" | "pathPointInsert" | "pathPointRemove" | "pathPointCurveType" | "layerVisible" | "layerLocked" | "layerPrintable" | "layerName" | "characterFontSize" | "characterLeading" | "characterTracking" | "characterFillColor" | "paragraphSpaceBefore" | "paragraphSpaceAfter" | "paragraphFirstLineIndent" | "appliedParagraphStyle" | "appliedCharacterStyle" | "appliedObjectStyle" | "itemLayer" | "appliedCellStyle" | "appliedTableStyle" | "framePath" | "frameNonprinting" | "frameFillTint" | "frameGradientFillAngle" | "frameGradientFillLength" | "frameGradientStrokeAngle" | "frameGradientStrokeLength" | "pathOpenAt" | "outlineStroke" | "outlineStrokeVariable" | "offsetPath" | "simplifyPath" | "closePath" | "frameGradientFeather" | "pageBounds" | "frameDropShadowMode" | "frameDropShadowXOffset" | "frameDropShadowYOffset" | "frameDropShadowSize" | "frameDropShadowOpacity" | "frameDropShadowColor" | "frameDropShadow" | "frameFittingCrops" | "frameFittingType" | "frameTextWrapMode" | "frameTextWrapOffsets" | "frameTextWrapContourType" | "frameTextWrapContourIncludeInside" | "paragraphJustification" | "paragraphStyleNextStyle" | "paragraphAppliedNumberingList" | "frameStrokeEndCap" | "frameInsetSpacing" | "appliedConditions" | "characterFontFamily" | "characterFontStyle" | "characterKerningMethod" | "characterCase" | "characterPosition" | "characterLanguage" | "characterBaselineShift" | "characterHorizontalScale" | "characterVerticalScale" | "characterSkew" | "characterUnderline" | "characterStrikethru" | "characterLigatures" | "characterOtfFeatures" | "paragraphLeftIndent" | "paragraphRightIndent" | "paragraphDropCapCharacters" | "paragraphDropCapLines" | "paragraphHyphenation" | "paragraphKeepLinesTogether" | "paragraphKeepWithNext" | "paragraphRuleAbove" | "paragraphRuleBelow" | "paragraphTabStops" | "paragraphListType" | "paragraphBulletCharacter" | "paragraphNumberingFormat" | "textFrameColumnCount" | "textFrameColumnGutter" | "textFrameColumnBalance" | "textFrameVerticalJustification" | "textFrameAutoSizing" | "textFrameFirstBaseline" | "textWrapInvert" | "frameFittingReferencePoint" | "frameAutoFit" | "frameStrokeType" | "frameStrokeJoin" | "frameStrokeMiterLimit" | "frameStrokeAlignment" | "frameStrokeGapColor" | "frameStrokeGapTint" | "frameStrokeDashArray" | "frameCornerOptionTopLeft" | "frameCornerOptionTopRight" | "frameCornerOptionBottomLeft" | "frameCornerOptionBottomRight" | "frameCornerRadiusTopLeft" | "frameCornerRadiusTopRight" | "frameCornerRadiusBottomLeft" | "frameCornerRadiusBottomRight" | "frameRotationAngle" | "frameScaleX" | "frameScaleY" | "frameFlipH" | "frameFlipV" | "frameOverprintFill" | "frameOverprintStroke" | "frameInnerShadowEnabled" | "frameInnerShadowBlendMode" | "frameInnerShadowColor" | "frameInnerShadowOpacity" | "frameInnerShadowAngle" | "frameInnerShadowDistance" | "frameInnerShadowSize" | "frameInnerShadowChoke" | "frameInnerShadowNoise" | "frameOuterGlowEnabled" | "frameOuterGlowBlendMode" | "frameOuterGlowColor" | "frameOuterGlowOpacity" | "frameOuterGlowSpread" | "frameOuterGlowSize" | "frameOuterGlowNoise" | "frameInnerGlowEnabled" | "frameInnerGlowBlendMode" | "frameInnerGlowColor" | "frameInnerGlowOpacity" | "frameInnerGlowChoke" | "frameInnerGlowSize" | "frameInnerGlowSource" | "frameInnerGlowNoise" | "frameBevelEnabled" | "frameBevelStyle" | "frameBevelTechnique" | "frameBevelDepth" | "frameBevelDirection" | "frameBevelSize" | "frameBevelSoften" | "frameBevelAngle" | "frameBevelAltitude" | "frameBevelHighlightColor" | "frameBevelShadowColor" | "frameBevelHighlightOpacity" | "frameBevelShadowOpacity" | "frameSatinEnabled" | "frameSatinBlendMode" | "frameSatinColor" | "frameSatinOpacity" | "frameSatinAngle" | "frameSatinDistance" | "frameSatinSize" | "frameSatinInvert" | "frameFeatherEnabled" | "frameFeatherWidth" | "frameFeatherCornerType" | "frameFeatherNoise" | "frameFeatherChoke" | "frameDirectionalFeatherEnabled" | "frameDirectionalFeatherLeftWidth" | "frameDirectionalFeatherRightWidth" | "frameDirectionalFeatherTopWidth" | "frameDirectionalFeatherBottomWidth" | "frameDirectionalFeatherAngle" | "frameDirectionalFeatherNoise" | "frameDirectionalFeatherChoke" | "frameBlendMode" | "nextTextFrame" | "previousTextFrame" | "cellFillColor" | "cellFillTint" | "cellInsetTop" | "cellInsetLeft" | "cellInsetBottom" | "cellInsetRight" | "cellVerticalJustification" | "cellTopEdgeStrokeColor" | "cellTopEdgeStrokeWeight" | "cellTopEdgeStrokeTint" | "cellBottomEdgeStrokeColor" | "cellBottomEdgeStrokeWeight" | "cellBottomEdgeStrokeTint" | "cellLeftEdgeStrokeColor" | "cellLeftEdgeStrokeWeight" | "cellLeftEdgeStrokeTint" | "cellRightEdgeStrokeColor" | "cellRightEdgeStrokeWeight" | "cellRightEdgeStrokeTint" | "tableRowCount" | "tableColumnCount" | "pluginMetadata" | "anchoredPosition" | "anchorPoint" | "anchoredXOffset" | "anchoredYOffset" | "anchoredHorizontalReference" | "anchoredVerticalReference" | "anchoredHorizontalAlignment" | "anchoredVerticalAlignment" | "anchoredSpineRelative" | "anchoredLockPosition" | "elementVisible" | "elementLocked" | "frameStrokeStartArrowhead" | "frameStrokeEndArrowhead";
+export type PropertyPath = "frameBounds" | "frameFillColor" | "frameStrokeColor" | "frameStrokeWeight" | "frameOpacity" | "frameTransform" | "imageContentTransform" | "framePathPoint" | "pathPointInsert" | "pathPointRemove" | "pathPointCurveType" | "layerVisible" | "layerLocked" | "layerPrintable" | "layerName" | "characterFontSize" | "characterLeading" | "characterTracking" | "characterFillColor" | "paragraphSpaceBefore" | "paragraphSpaceAfter" | "paragraphFirstLineIndent" | "appliedParagraphStyle" | "appliedCharacterStyle" | "appliedObjectStyle" | "itemLayer" | "appliedCellStyle" | "appliedTableStyle" | "framePath" | "frameNonprinting" | "frameFillTint" | "frameGradientFillAngle" | "frameGradientFillLength" | "frameGradientStrokeAngle" | "frameGradientStrokeLength" | "pathOpenAt" | "outlineStroke" | "outlineStrokeVariable" | "offsetPath" | "simplifyPath" | "closePath" | "frameGradientFeather" | "pageBounds" | "frameDropShadowMode" | "frameDropShadowXOffset" | "frameDropShadowYOffset" | "frameDropShadowSize" | "frameDropShadowOpacity" | "frameDropShadowColor" | "frameDropShadow" | "frameFittingCrops" | "frameFittingType" | "frameTextWrapMode" | "frameTextWrapOffsets" | "frameTextWrapContourType" | "frameTextWrapContourIncludeInside" | "paragraphJustification" | "paragraphStyleNextStyle" | "paragraphAppliedNumberingList" | "frameStrokeEndCap" | "frameInsetSpacing" | "appliedConditions" | "characterFontFamily" | "characterFontStyle" | "characterKerningMethod" | "characterCase" | "characterPosition" | "characterLanguage" | "characterBaselineShift" | "characterHorizontalScale" | "characterVerticalScale" | "characterSkew" | "characterUnderline" | "characterStrikethru" | "characterLigatures" | "characterOtfFeatures" | "paragraphLeftIndent" | "paragraphRightIndent" | "paragraphDropCapCharacters" | "paragraphDropCapLines" | "paragraphHyphenation" | "paragraphHyphenationZone" | "paragraphKeepLinesTogether" | "paragraphKeepWithNext" | "paragraphKeepAllLinesTogether" | "paragraphKeepFirstLines" | "paragraphKeepLastLines" | "paragraphStartParagraph" | "paragraphSpanColumnType" | "paragraphSpanSplitColumnCount" | "paragraphSpanColumnMinSpaceBefore" | "paragraphSpanColumnMinSpaceAfter" | "paragraphSplitColumnInsideGutter" | "paragraphSplitColumnOutsideGutter" | "paragraphRuleAbove" | "paragraphRuleBelow" | "paragraphTabStops" | "paragraphListType" | "paragraphBulletCharacter" | "paragraphNumberingFormat" | "paragraphBulletsTextAfter" | "paragraphNumberingExpression" | "paragraphNumberingStartAt" | "paragraphNumberingContinue" | "paragraphBulletsCharacterStyle" | "paragraphNumberingCharacterStyle" | "textFrameColumnCount" | "textFrameColumnGutter" | "textFrameColumnBalance" | "textFrameVerticalJustification" | "textFrameAutoSizing" | "textFrameFirstBaseline" | "textWrapInvert" | "frameFittingReferencePoint" | "frameAutoFit" | "frameStrokeType" | "frameStrokeJoin" | "frameStrokeMiterLimit" | "frameStrokeAlignment" | "frameStrokeGapColor" | "frameStrokeGapTint" | "frameStrokeDashArray" | "frameCornerOptionTopLeft" | "frameCornerOptionTopRight" | "frameCornerOptionBottomLeft" | "frameCornerOptionBottomRight" | "frameCornerRadiusTopLeft" | "frameCornerRadiusTopRight" | "frameCornerRadiusBottomLeft" | "frameCornerRadiusBottomRight" | "frameRotationAngle" | "frameScaleX" | "frameScaleY" | "frameFlipH" | "frameFlipV" | "frameOverprintFill" | "frameOverprintStroke" | "frameInnerShadowEnabled" | "frameInnerShadowBlendMode" | "frameInnerShadowColor" | "frameInnerShadowOpacity" | "frameInnerShadowAngle" | "frameInnerShadowDistance" | "frameInnerShadowSize" | "frameInnerShadowChoke" | "frameInnerShadowNoise" | "frameOuterGlowEnabled" | "frameOuterGlowBlendMode" | "frameOuterGlowColor" | "frameOuterGlowOpacity" | "frameOuterGlowSpread" | "frameOuterGlowSize" | "frameOuterGlowNoise" | "frameInnerGlowEnabled" | "frameInnerGlowBlendMode" | "frameInnerGlowColor" | "frameInnerGlowOpacity" | "frameInnerGlowChoke" | "frameInnerGlowSize" | "frameInnerGlowSource" | "frameInnerGlowNoise" | "frameBevelEnabled" | "frameBevelStyle" | "frameBevelTechnique" | "frameBevelDepth" | "frameBevelDirection" | "frameBevelSize" | "frameBevelSoften" | "frameBevelAngle" | "frameBevelAltitude" | "frameBevelHighlightColor" | "frameBevelShadowColor" | "frameBevelHighlightOpacity" | "frameBevelShadowOpacity" | "frameSatinEnabled" | "frameSatinBlendMode" | "frameSatinColor" | "frameSatinOpacity" | "frameSatinAngle" | "frameSatinDistance" | "frameSatinSize" | "frameSatinInvert" | "frameFeatherEnabled" | "frameFeatherWidth" | "frameFeatherCornerType" | "frameFeatherNoise" | "frameFeatherChoke" | "frameDirectionalFeatherEnabled" | "frameDirectionalFeatherLeftWidth" | "frameDirectionalFeatherRightWidth" | "frameDirectionalFeatherTopWidth" | "frameDirectionalFeatherBottomWidth" | "frameDirectionalFeatherAngle" | "frameDirectionalFeatherNoise" | "frameDirectionalFeatherChoke" | "frameBlendMode" | "nextTextFrame" | "previousTextFrame" | "cellFillColor" | "cellFillTint" | "cellInsetTop" | "cellInsetLeft" | "cellInsetBottom" | "cellInsetRight" | "cellVerticalJustification" | "cellTopEdgeStrokeColor" | "cellTopEdgeStrokeWeight" | "cellTopEdgeStrokeTint" | "cellBottomEdgeStrokeColor" | "cellBottomEdgeStrokeWeight" | "cellBottomEdgeStrokeTint" | "cellLeftEdgeStrokeColor" | "cellLeftEdgeStrokeWeight" | "cellLeftEdgeStrokeTint" | "cellRightEdgeStrokeColor" | "cellRightEdgeStrokeWeight" | "cellRightEdgeStrokeTint" | "tableRowCount" | "tableColumnCount" | "pluginMetadata" | "anchoredPosition" | "anchorPoint" | "anchoredXOffset" | "anchoredYOffset" | "anchoredHorizontalReference" | "anchoredVerticalReference" | "anchoredHorizontalAlignment" | "anchoredVerticalAlignment" | "anchoredSpineRelative" | "anchoredLockPosition" | "elementVisible" | "elementLocked" | "frameStrokeStartArrowhead" | "frameStrokeEndArrowhead";
 
 /**
  * W0.2 — wire mirror of `paged_model::ParagraphRule` (the
@@ -441,6 +474,60 @@ export type FieldKind = "pageNumber" | "nextPageNumber" | { placeholder: { plugi
  */
 export type GuideOrientationSpec = "vertical" | "horizontal";
 
+/**
+ * W1.13 — cell qualifier for a content address that points INTO a
+ * table cell rather than the story\'s main paragraph flow.
+ *
+ * ## The two-stream addressing model
+ *
+ * Table-cell text is stored out of band on `Table.cells[].paragraphs`
+ * (see `idml_import`), disjoint from `Story.paragraphs`. So a content
+ * address needs to say *which* paragraph stream its byte offsets index:
+ *
+ * - `ContentSelection.cell == None` — offsets are story-local bytes
+ *   over `story.paragraphs` (the body flow). Unchanged from before.
+ * - `ContentSelection.cell == Some(addr)` — offsets are CELL-LOCAL
+ *   bytes over `cell.paragraphs`, under the same story-offset contract
+ *   (run bytes + one synthetic `\\n` per inter-paragraph boundary,
+ *   counted within the cell). The owning story is still `story_id`;
+ *   `addr` picks the cell within that story\'s table.
+ *
+ * `table_id` / `row` / `col` are the SAME identifiers the hit-test
+ * surface emits (`HitResult.table_context` / `TableHitContext`) and
+ * that the renderer stamps onto cell `LineLayout`s
+ * (`paged_renderer::CellAddr`), so a hit that lands in a cell hands
+ * back exactly the qualifier the caret/edit address needs — no second
+ * query.
+ *
+ * ## Why a qualifier and not a re-numbered flat offset
+ *
+ * The alternative — fold cells into one flat story-offset space via a
+ * reserved high-bit/region scheme — was rejected: it makes
+ * `shift_for_insert`/`shift_for_delete`, undo inverse offsets, and the
+ * existing body-only consumers (BreakRecord, the A/B harness, every
+ * `RequestWordBounds`/`RequestLineBounds` caller) all have to learn the
+ * encoding, and a single arithmetic slip silently routes an edit into
+ * the wrong cell. The qualifier keeps body addressing byte-identical
+ * (the field defaults to `None` and is `#[serde(default)]`, so it
+ * rides v35 additively — old senders omit it) and makes \"which stream\
+ * an explicit, type-checked decision. Undo is trivially correct
+ * because the inverse op carries the same `cell` qualifier.
+ */
+export interface TextCellAddr {
+    /**
+     * `<Table Self=\"...\">` id within `story_id`.
+     */
+    tableId: string;
+    /**
+     * Template row (0-based); span-origin row for spanned cells.
+     */
+    row: number;
+    /**
+     * Column (0-based); span-origin column for spanned cells.
+     */
+    col: number;
+}
+
 /**
  * W1.20 — `(parent_group_id, index_within_parent_members)` carried by
  * a `GroupSpec` when a group must be (re)created nested inside another
@@ -567,6 +654,8 @@ export type StyleScope = "paragraph" | "character";
  */
 export type ZOrderTarget = "front" | "back" | "forward" | "backward" | { index: number };
 
+export type PageId = string;
+
 
 export class Inspector {
     free(): void;

package/paged_introspect_wasm.js

@@ -199,14 +199,14 @@ export function on_start() {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_ef53bc310eb298a0: function(arg0, arg1) {
+        __wbg_Error_67e7344beaa85059: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg___wbindgen_throw_1506f2235d1bdba0: function(arg0, arg1) {
+        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_error_a6fa202b58aa1cd3: function(arg0, arg1) {
+        __wbg_error_757e9472f8410341: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
             try {
@@ -217,7 +217,7 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_log_cf2e968649f3384e: function(arg0) {
+        __wbg_log_363d83b9114c8831: function(arg0) {
             console.log(arg0);
         },
         __wbg_new_227d7c05414eb861: function() {
@@ -231,7 +231,7 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
+        __wbindgen_generic_0000000000000001: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
@@ -373,11 +373,15 @@ function __wbg_finalize_init(instance, module) {
 
 async function __wbg_load(module, imports) {
     if (typeof Response === 'function' && module instanceof Response) {
+        if (!module.ok) {
+            throw new Error(`failed to fetch Wasm: ${module.status} ${module.statusText} fetching '${module.url}'`);
+        }
+
         if (typeof WebAssembly.instantiateStreaming === 'function') {
             try {
                 return await WebAssembly.instantiateStreaming(module, imports);
             } catch (e) {
-                const validResponse = module.ok && expectedResponseType(module.type);
+                const validResponse = expectedResponseType(module.type);
 
                 if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
                     console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);