superdoc 2.4.0-next.9 → 2.5.0

package/dist/chunks/{rolldown-runtime-D7PMmH3s.es.js → rolldown-runtime-B5TtN50X.es.js}

@@ -1,11 +1,19 @@
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __esmMin = (fn, res, err) => () => {
+	if (err) throw err[0];
+	try {
+		return fn && (res = fn(fn = 0)), res;
+	} catch (e) {
+		throw err = [e], e;
+	}
+};
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
@@ -16,12 +24,13 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
 	if (typeof require !== "undefined") return require.apply(this, arguments);
-	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function.");
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
 });
+//#endregion
 export { __toESM as i, __esmMin as n, __require as r, __commonJSMin as t };

package/dist/chunks/{rolldown-runtime-1Y-nnZJ3.cjs → rolldown-runtime-DtsSbkrh.cjs}

@@ -1,11 +1,19 @@
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __esmMin = (fn, res, err) => () => {
+	if (err) throw err[0];
+	try {
+		return fn && (res = fn(fn = 0)), res;
+	} catch (e) {
+		throw err = [e], e;
+	}
+};
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
@@ -16,10 +24,11 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
+//#endregion
 Object.defineProperty(exports, "__commonJSMin", {
 	enumerable: true,
 	get: function() {

package/dist/chunks/{uuid-CFp0WGVU.cjs → uuid-BhG0ngwk.cjs}

@@ -1,10 +1,13 @@
+//#region ../../node_modules/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm-browser/stringify.js
 var byteToHex = [];
 for (let i = 0; i < 256; ++i) byteToHex.push((i + 256).toString(16).slice(1));
 function unsafeStringify(arr, offset = 0) {
 	return (byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]]).toLowerCase();
 }
+//#endregion
+//#region ../../node_modules/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm-browser/rng.js
 var getRandomValues;
-var rnds8 = new Uint8Array(16);
+var rnds8 = /* @__PURE__ */ new Uint8Array(16);
 function rng() {
 	if (!getRandomValues) {
 		if (typeof crypto === "undefined" || !crypto.getRandomValues) throw new Error("crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported");
@@ -12,8 +15,9 @@ function rng() {
 	}
 	return getRandomValues(rnds8);
 }
-var randomUUID = typeof crypto !== "undefined" && crypto.randomUUID && crypto.randomUUID.bind(crypto);
-var native_default = { randomUUID };
+var native_default = { randomUUID: typeof crypto !== "undefined" && crypto.randomUUID && crypto.randomUUID.bind(crypto) };
+//#endregion
+//#region ../../node_modules/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm-browser/v4.js
 function v4(options, buf, offset) {
 	if (native_default.randomUUID && !buf && !options) return native_default.randomUUID();
 	options = options || {};
@@ -29,10 +33,10 @@ function v4(options, buf, offset) {
 	}
 	return unsafeStringify(rnds);
 }
-var v4_default = v4;
-Object.defineProperty(exports, "v4_default", {
+//#endregion
+Object.defineProperty(exports, "v4", {
 	enumerable: true,
 	get: function() {
-		return v4_default;
+		return v4;
 	}
 });

package/dist/chunks/{uuid-B2Sqk-3p.es.js → uuid-H0Xcmmhy.es.js}

@@ -1,10 +1,13 @@
+//#region ../../node_modules/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm-browser/stringify.js
 var byteToHex = [];
 for (let i = 0; i < 256; ++i) byteToHex.push((i + 256).toString(16).slice(1));
 function unsafeStringify(arr, offset = 0) {
 	return (byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]]).toLowerCase();
 }
+//#endregion
+//#region ../../node_modules/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm-browser/rng.js
 var getRandomValues;
-var rnds8 = new Uint8Array(16);
+var rnds8 = /* @__PURE__ */ new Uint8Array(16);
 function rng() {
 	if (!getRandomValues) {
 		if (typeof crypto === "undefined" || !crypto.getRandomValues) throw new Error("crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported");
@@ -13,6 +16,8 @@ function rng() {
 	return getRandomValues(rnds8);
 }
 var native_default = { randomUUID: typeof crypto !== "undefined" && crypto.randomUUID && crypto.randomUUID.bind(crypto) };
+//#endregion
+//#region ../../node_modules/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm-browser/v4.js
 function v4(options, buf, offset) {
 	if (native_default.randomUUID && !buf && !options) return native_default.randomUUID();
 	options = options || {};
@@ -28,5 +33,5 @@ function v4(options, buf, offset) {
 	}
 	return unsafeStringify(rnds);
 }
-var v4_default = v4;
-export { v4_default as t };
+//#endregion
+export { v4 as t };

package/dist/collaboration-upgrade-engine.cjs

@@ -1,33 +1,58 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let __superdoc_docx_engine_collaboration_upgrade_engine = require("@superdoc/docx-engine/collaboration-upgrade-engine");
-const COLLABORATION_UPGRADE_ENGINE_PROTOCOL_VERSION = 1;
-const SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS = Object.freeze([1]);
-const SUPPORTED_V1_READER_CONTRACT_VERSIONS = Object.freeze([1]);
-const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
-var PRIVATE_ENGINE_INFO = (0, __superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
+let _superdoc_docx_engine_collaboration_upgrade_engine = require("@superdoc/docx-engine/collaboration-upgrade-engine");
+//#region src/public/collaboration-upgrade-engine.ts
+/**
+* SuperDoc public facade: `superdoc/collaboration-upgrade-engine`.
+*
+* This is a Node-only bridge used by the public v2 collaboration upgrade package.
+* It deliberately exposes data-only inputs and outputs: no live Y.Doc, editor,
+* provider, browser, UI, or private workspace type crosses this boundary.
+*/
+/** Compatibility protocol between the upgrade package and installed SuperDoc. */
+var COLLABORATION_UPGRADE_ENGINE_PROTOCOL_VERSION = 1;
+/** Recovery-bundle versions accepted by this engine. */
+var SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS = Object.freeze([1]);
+/** Frozen final-v1 reader contracts accepted by this engine. */
+var SUPPORTED_V1_READER_CONTRACT_VERSIONS = Object.freeze([1]);
+/** Minimum supported Node.js major version. */
+var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
+var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.9",
+	superdocVersion: "2.5.0",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS
 });
+/** Return immutable metadata used to reject incompatible engines preflight. */
 function getCollaborationUpgradeEngineInfo() {
 	return ENGINE_INFO;
 }
+/**
+* Build and offline-validate one self-contained v2 collaboration update.
+*
+* This function performs no provider I/O and never mutates the v1 source room.
+*/
 async function buildV2CollaborationUpgradeArtifactFromBundle(input) {
 	assertSupportedNodeRuntime();
-	return (0, __superdoc_docx_engine_collaboration_upgrade_engine.buildV2CollaborationUpgradeArtifactFromBundle)(input);
+	return (0, _superdoc_docx_engine_collaboration_upgrade_engine.buildV2CollaborationUpgradeArtifactFromBundle)(input);
 }
+/**
+* Validate target bytes after a provider reads them through a fresh client.
+*
+* Provenance and carrier bytes are derived from the authenticated recovery
+* bundle rather than accepted as independent caller assertions.
+*/
 async function validateV2CollaborationUpgradeTarget(input) {
 	assertSupportedNodeRuntime();
-	return (0, __superdoc_docx_engine_collaboration_upgrade_engine.validateV2CollaborationUpgradeTarget)(input);
+	return (0, _superdoc_docx_engine_collaboration_upgrade_engine.validateV2CollaborationUpgradeTarget)(input);
 }
 function assertSupportedNodeRuntime() {
 	const nodeVersion = globalThis.process?.versions?.node;
 	const nodeMajor = nodeVersion ? Number.parseInt(nodeVersion.split(".")[0] ?? "", 10) : NaN;
 	if (!Number.isInteger(nodeMajor) || nodeMajor < 20) throw new Error(`superdoc/collaboration-upgrade-engine requires Node.js 20 or newer`);
 }
+//#endregion
 exports.COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR;
 exports.COLLABORATION_UPGRADE_ENGINE_PROTOCOL_VERSION = COLLABORATION_UPGRADE_ENGINE_PROTOCOL_VERSION;
 exports.SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS = SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS;

package/dist/collaboration-upgrade-engine.es.js

@@ -1,23 +1,47 @@
 import { buildV2CollaborationUpgradeArtifactFromBundle as buildV2CollaborationUpgradeArtifactFromBundle$1, getCollaborationUpgradeEngineInfo as getCollaborationUpgradeEngineInfo$1, validateV2CollaborationUpgradeTarget as validateV2CollaborationUpgradeTarget$1 } from "@superdoc/docx-engine/collaboration-upgrade-engine";
-const COLLABORATION_UPGRADE_ENGINE_PROTOCOL_VERSION = 1;
-const SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS = Object.freeze([1]);
-const SUPPORTED_V1_READER_CONTRACT_VERSIONS = Object.freeze([1]);
-const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
+//#region src/public/collaboration-upgrade-engine.ts
+/**
+* SuperDoc public facade: `superdoc/collaboration-upgrade-engine`.
+*
+* This is a Node-only bridge used by the public v2 collaboration upgrade package.
+* It deliberately exposes data-only inputs and outputs: no live Y.Doc, editor,
+* provider, browser, UI, or private workspace type crosses this boundary.
+*/
+/** Compatibility protocol between the upgrade package and installed SuperDoc. */
+var COLLABORATION_UPGRADE_ENGINE_PROTOCOL_VERSION = 1;
+/** Recovery-bundle versions accepted by this engine. */
+var SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS = Object.freeze([1]);
+/** Frozen final-v1 reader contracts accepted by this engine. */
+var SUPPORTED_V1_READER_CONTRACT_VERSIONS = Object.freeze([1]);
+/** Minimum supported Node.js major version. */
+var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.9",
+	superdocVersion: "2.5.0",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS
 });
+/** Return immutable metadata used to reject incompatible engines preflight. */
 function getCollaborationUpgradeEngineInfo() {
 	return ENGINE_INFO;
 }
+/**
+* Build and offline-validate one self-contained v2 collaboration update.
+*
+* This function performs no provider I/O and never mutates the v1 source room.
+*/
 async function buildV2CollaborationUpgradeArtifactFromBundle(input) {
 	assertSupportedNodeRuntime();
 	return buildV2CollaborationUpgradeArtifactFromBundle$1(input);
 }
+/**
+* Validate target bytes after a provider reads them through a fresh client.
+*
+* Provenance and carrier bytes are derived from the authenticated recovery
+* bundle rather than accepted as independent caller assertions.
+*/
 async function validateV2CollaborationUpgradeTarget(input) {
 	assertSupportedNodeRuntime();
 	return validateV2CollaborationUpgradeTarget$1(input);
@@ -27,4 +51,5 @@ function assertSupportedNodeRuntime() {
 	const nodeMajor = nodeVersion ? Number.parseInt(nodeVersion.split(".")[0] ?? "", 10) : NaN;
 	if (!Number.isInteger(nodeMajor) || nodeMajor < 20) throw new Error(`superdoc/collaboration-upgrade-engine requires Node.js 20 or newer`);
 }
+//#endregion
 export { COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR, COLLABORATION_UPGRADE_ENGINE_PROTOCOL_VERSION, SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS, SUPPORTED_V1_READER_CONTRACT_VERSIONS, buildV2CollaborationUpgradeArtifactFromBundle, getCollaborationUpgradeEngineInfo, validateV2CollaborationUpgradeTarget };

package/dist/document-api/src/citations/citations.types.d.ts

@@ -1,5 +1,6 @@
 import { InlineAnchor } from '../types/base.js';
 import { TextTarget } from '../types/address.js';
+import { StoryLocator } from '../types/story.types.js';
 import { AdapterMutationFailure } from '../types/adapter-result.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 import { TocCreateLocation } from '../toc/toc.types.js';
@@ -7,6 +8,14 @@ export interface CitationAddress {
     kind: 'inline';
     nodeType: 'citation';
     anchor: InlineAnchor;
+    /** Story containing this citation. Omit for body (backward compatible). */
+    story?: StoryLocator;
+    /** Session-stable story identity used by the v2 runtime with `fieldId`. */
+    storyId?: string;
+    /** Session-stable identity of the citation's backing OOXML field. */
+    fieldId?: string;
+    /** Field occurrence fallback for collocated citations with identical anchors. */
+    occurrenceIndex?: number;
 }
 export interface CitationSourceAddress {
     kind: 'entity';

package/dist/document-api/src/comments/comments.types.d.ts

@@ -200,6 +200,13 @@ export interface CommentsListQuery {
     includeResolved?: boolean;
     limit?: number;
     offset?: number;
+    /**
+     * Optional bounded review-window filter. Each id may be canonical or an
+     * imported/source alias. Only matching visible threads are projected.
+     */
+    visibleCommentIds?: readonly string[];
+    /** Include every reply belonging to a matched visible thread. */
+    includeThreadReplies?: boolean;
 }
 /**
  * Domain fields for a comment discovery item (C2).

package/dist/document-api/src/types/receipt.d.ts

@@ -42,22 +42,26 @@ export type ReviewWarning = {
  * operation. Callers maintain their own held-ref state by applying these
  * deltas:
  *
- * - Any caller-held text address whose `range.start` is `>= atChar` in the
- *   same `story` gets `range.start += delta` (and similarly `range.end`).
- * - Any caller-held text address whose range straddles `atChar` is
- *   *invalidated* — the kernel already lists those in `invalidatedRefs`.
+ * `atChar` is story-absolute. When `blockId` and `atCharInBlock` are both
+ * present, they identify the same shift in block-local visible coordinates.
+ * Consumers that store block-local ranges must fail closed when that pair is
+ * absent rather than interpreting `atChar` as a block offset.
  *
  * Negative `delta` describes a deletion. Positive `delta` describes an
  * insertion (e.g. when a `<w:del>` is rejected and its content is restored
  * to the visible flow).
  *
- * One entry per story. Cross-story shifts are reported as separate entries.
+ * One entry is emitted per story. Cross-story shifts are reported separately.
  */
 export interface TextRangeShift {
     /** The story whose text was shifted. */
     story: StoryLocator;
     /** Character offset in the story's flattened text where the shift begins. */
     atChar: number;
+    /** Block containing the shift, when the producer can prove one. */
+    blockId?: string;
+    /** Visible character offset within `blockId`, paired with `blockId`. */
+    atCharInBlock?: number;
     /** Net change in characters. Negative for deletions, positive for insertions. */
     delta: number;
 }

package/dist/document-api/src/types/track-changes.types.d.ts

@@ -457,6 +457,16 @@ export interface TrackChangeNavigationTarget {
     blockId: string;
     role: 'primary' | 'move-source' | 'move-destination' | 'formatting-carrier' | 'structural-carrier';
 }
+export interface TrackChangeCustomAttribute {
+    /** Source-qualified attribute name, preserving the prefix used by the carrier. */
+    name: string;
+    /** Resolved extension namespace URI. */
+    namespaceUri: string;
+    /** Attribute local name without its namespace prefix. */
+    localName: string;
+    /** Decoded XML attribute value. */
+    value: string;
+}
 export interface TrackChangeInfo {
     address: TrackedChangeAddress;
     /** Stable SuperDoc logical tracked-change id (spec §3 / §4). */
@@ -569,6 +579,11 @@ export interface TrackChangeInfo {
      * tracked changes. Absent when the change is standalone.
      */
     overlap?: TrackChangeOverlapInfo;
+    /**
+     * Unknown extension attributes attached to contributing OOXML revision carriers.
+     * Exact duplicates are removed in document order; conflicting values are retained.
+     */
+    readonly customAttributes?: readonly TrackChangeCustomAttribute[];
 }
 export interface TrackChangesListQuery {
     limit?: number;
@@ -694,6 +709,8 @@ export interface TrackChangeDomain {
      * stack without an extra `trackChanges.get` round trip.
      */
     overlap?: TrackChangeOverlapInfo;
+    /** Unknown extension attributes attached to the contributing OOXML revision carriers. */
+    readonly customAttributes?: readonly TrackChangeCustomAttribute[];
 }
 /**
  * Standardized discovery output for `trackChanges.list`.

package/dist/layout-engine/contracts/src/graphic-placement.d.ts

@@ -1,7 +1,19 @@
-type AnchorVRelative = 'paragraph' | 'page' | 'margin';
-type AnchorHRelative = 'column' | 'page' | 'margin';
-type AnchorAlignH = 'left' | 'center' | 'right';
-type AnchorAlignV = 'top' | 'center' | 'bottom';
+/** ECMA-376 Part 1 §20.4.3.4 (`ST_RelFromH`). */
+export declare const ANCHOR_H_RELATIVE_VALUES: readonly ["margin", "page", "column", "character", "leftMargin", "rightMargin", "insideMargin", "outsideMargin"];
+/** ECMA-376 Part 1 §20.4.3.5 (`ST_RelFromV`). */
+export declare const ANCHOR_V_RELATIVE_VALUES: readonly ["margin", "page", "paragraph", "line", "topMargin", "bottomMargin", "insideMargin", "outsideMargin"];
+/** ECMA-376 Part 1 §20.4.3.1 (`ST_AlignH`). */
+export declare const ANCHOR_H_ALIGN_VALUES: readonly ["left", "right", "center", "inside", "outside"];
+/** ECMA-376 Part 1 §20.4.3.2 (`ST_AlignV`). */
+export declare const ANCHOR_V_ALIGN_VALUES: readonly ["top", "bottom", "center", "inside", "outside"];
+export type AnchorHRelative = (typeof ANCHOR_H_RELATIVE_VALUES)[number];
+export type AnchorVRelative = (typeof ANCHOR_V_RELATIVE_VALUES)[number];
+export type AnchorAlignH = (typeof ANCHOR_H_ALIGN_VALUES)[number];
+export type AnchorAlignV = (typeof ANCHOR_V_ALIGN_VALUES)[number];
+export declare function isAnchorHRelative(value: unknown): value is AnchorHRelative;
+export declare function isAnchorVRelative(value: unknown): value is AnchorVRelative;
+export declare function isAnchorAlignH(value: unknown): value is AnchorAlignH;
+export declare function isAnchorAlignV(value: unknown): value is AnchorAlignV;
 export declare function isPositionedParagraphFrame<T extends {
     wrap?: string;
 }>(frame: T | undefined): frame is T & {
@@ -35,6 +47,10 @@ export type ColumnLayoutForAnchor = {
  */
 export type ResolveAnchoredGraphicYInput = {
     anchor?: {
+        simplePos?: {
+            x: number;
+            y: number;
+        };
         vRelativeFrom?: AnchorVRelative;
         alignV?: AnchorAlignV;
         offsetV?: number;
@@ -49,8 +65,12 @@ export type ResolveAnchoredGraphicYInput = {
      * Used for `paragraph` and legacy (undefined vRelativeFrom) positioning.
      */
     anchorParagraphY?: number;
+    /** Anchor line top Y. Falls back to the paragraph top when unavailable. */
+    anchorLineY?: number;
     /** First line height of the anchor paragraph (paragraph-relative alignV). */
     firstLineHeight?: number;
+    /** One-based physical page number, used by inside/outside placement. */
+    pageNumber?: number;
     /**
      * When true, anchor has no host paragraph (pre-registered / paragraphless layout).
      * For `vRelativeFrom: 'paragraph'`, use `contentTop + offsetV` instead of alignV on a
@@ -62,15 +82,24 @@ export type ResolveAnchoredGraphicYInput = {
  * Resolve the vertical paint position for an anchored graphic (image, drawing, or table).
  */
 export declare function resolveAnchoredGraphicY(input: ResolveAnchoredGraphicYInput): number;
+export type ResolveAnchoredGraphicXContext = {
+    /** One-based physical page number, used by inside/outside placement. */
+    pageNumber?: number;
+    /** Page-space X of the anchor character. Falls back to the column origin. */
+    anchorCharacterX?: number;
+};
 /**
  * Resolve horizontal paint position for an anchored graphic.
  */
 export declare function resolveAnchoredGraphicX(anchor: {
+    simplePos?: {
+        x: number;
+        y: number;
+    };
     hRelativeFrom?: AnchorHRelative;
     alignH?: AnchorAlignH;
     offsetH?: number;
 }, columnIndex: number, columns: ColumnLayoutForAnchor, objectWidth: number, margins?: {
     left?: number;
     right?: number;
-}, pageWidth?: number): number;
-export {};
+}, pageWidth?: number, context?: ResolveAnchoredGraphicXContext): number;

package/dist/layout-engine/contracts/src/incremental-dependency.d.ts

@@ -5,6 +5,26 @@
  * every retained dependency that required the checkpoint; consumers reject
  * empty, duplicate, or unknown lists instead of trusting a generic boolean.
  */
-export type PageCheckpointDependencyClass = 'multiple-sections' | 'furniture-page-tokens' | 'non-balanceable-multi-column-sections' | 'body-anchored-objects' | 'footnotes' | 'page-references' | 'keep-constraints' | 'tables' | 'furniture-anchored-objects';
-export declare const PAGE_CHECKPOINT_DEPENDENCY_CLASSES: readonly ["multiple-sections", "furniture-page-tokens", "non-balanceable-multi-column-sections", "body-anchored-objects", "footnotes", "page-references", "keep-constraints", "tables", "furniture-anchored-objects"];
+export type PageCheckpointDependencyClass = 'multiple-sections' | 'furniture-page-tokens' | 'non-balanceable-multi-column-sections' | 'body-anchored-objects' | 'non-flowing-page-relative-body-anchors' | 'footnotes' | 'page-references' | 'keep-constraints' | 'tables' | 'furniture-anchored-objects';
+export declare const PAGE_CHECKPOINT_DEPENDENCY_CLASSES: readonly ["multiple-sections", "furniture-page-tokens", "non-balanceable-multi-column-sections", "body-anchored-objects", "non-flowing-page-relative-body-anchors", "footnotes", "page-references", "keep-constraints", "tables", "furniture-anchored-objects"];
+/**
+ * Exact retained-generation proof for page/margin-relative body anchors that
+ * cannot influence paragraph flow (`wrap=None`). The host builds this once
+ * from a canonical layout generation; warm consumers validate the epoch,
+ * inventory, identities, and page ownership before admitting bounded layout.
+ */
+export type NonFlowingPageRelativeAnchorDependencyProof = {
+    version: 1;
+    sourceLayoutEpoch: number;
+    inventoryFingerprint: string;
+    entries: readonly {
+        blockId: string;
+        carrierParagraphId: string;
+        sourcePageIndex: number;
+        sectionIndex: number;
+        geometryFingerprint: string;
+        measureFingerprint: string;
+        pageGeometryFingerprint: string;
+    }[];
+};
 export declare function areValidPageCheckpointDependencyClasses(value: unknown): value is readonly PageCheckpointDependencyClass[];