@paged-media/introspect-wasm 0.62.0 → 0.63.0

package/catalog.json

@@ -756,12 +756,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 +1169,7 @@
     "frameDirectionalFeatherNoise",
     "frameDirectionalFeatherChoke",
     "frameBlendMode",
+    "frameGradientFeather",
     "cellFillColor",
     "cellFillTint",
     "cellInsetTop",
@@ -943,8 +1189,6 @@
     "cellRightEdgeStrokeColor",
     "cellRightEdgeStrokeWeight",
     "cellRightEdgeStrokeTint",
-    "tableRowCount",
-    "tableColumnCount",
     "pluginMetadata",
     "anchoredPosition",
     "anchorPoint",
@@ -957,7 +1201,34 @@
     "anchoredSpineRelative",
     "anchoredLockPosition",
     "elementVisible",
-    "elementLocked"
+    "elementLocked",
+    "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"
   ],
   "constraints": [
     "Scripts run in Boa (pure ECMAScript), NOT Node: no require/import, fetch, fs, setTimeout, or network. Use only paged.* and console.*.",
@@ -968,6 +1239,125 @@
     "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",
+    "activateConditionSet",
+    "applyMasterToPage",
+    "duplicatePage",
+    "insertSection",
+    "editSection",
+    "deleteSection",
+    "setRowHeight",
+    "setColumnWidth",
+    "insertTableRow",
+    "deleteTableRow",
+    "insertTableColumn",
+    "deleteTableColumn",
+    "insertHeaderRow",
+    "removeHeaderRow",
+    "insertFooterRow",
+    "removeFooterRow",
+    "setCellSpan",
+    "insertTable"
+  ],
   "elements": [
     {
       "name": "TextFrame",
@@ -1329,5 +1719,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.63.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: "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,18 +386,6 @@ 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
@@ -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;