superdoc 2.4.0-next.2 → 2.4.0-next.21

package/dist/chunks/{rolldown-runtime-D7PMmH3s.es.js → rolldown-runtime-0pSA04fp.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];
@@ -22,6 +30,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : 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-74VwNCz7.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];
@@ -20,6 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	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.2",
+	superdocVersion: "2.4.0-next.21",
 	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.2",
+	superdocVersion: "2.4.0-next.21",
 	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/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/track-changes.types.d.ts

@@ -2,9 +2,7 @@ import { TextTarget, TrackedChangeAddress } from './address.js';
 import { DiscoveryOutput } from './discovery.js';
 import { StoryLocator } from './story.types.js';
 /**
- * Canonical v2 tracked-change broad-type vocabulary defined by
- * `../labs/tests/requirements/specs/tracked-changes-comments/tracked-changes-spec.md`
- * §3 / §5.
+ * Canonical v2 tracked-change broad-type vocabulary.
  *
  * Public adapters MUST emit one of these values. Existing v1 emitters and
  * tests still produce the legacy `insert` / `delete` / `format` strings; both

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[];

package/dist/layout-engine/contracts/src/index.d.ts

@@ -2455,5 +2455,5 @@ export declare const extractHeaderFooterSpace: (margins?: PageMargins | null) =>
 export type { ResolvedLayout, ResolvedPage, ResolvedPaintItem, ResolvedGroupItem, ResolvedFragmentItem, ResolvedParagraphContent, ResolvedTextLineItem, ResolvedDropCapItem, ResolvedListMarkerItem, ResolvedTableItem, ResolvedImageItem, ResolvedDrawingItem, ResolvedHeaderFooterPage, ResolvedHeaderFooterLayout, } from './resolved-layout.js';
 export { isResolvedTableItem, isResolvedImageItem, isResolvedDrawingItem } from './resolved-layout.js';
 export { expandRunsForInlineNewlines, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, sliceRunsForLine, } from './run-helpers.js';
-export { PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, type PageCheckpointDependencyClass, } from './incremental-dependency.js';
+export { PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyClass, } from './incremental-dependency.js';
 export * as Engines from './engines/index.js';

package/dist/layout-engine/layout-bridge/src/incrementalLayout.d.ts

@@ -1,4 +1,4 @@
-import { PageCheckpointDependencyClass, FlowBlock, Layout, Measure, HeaderFooterLayout, ParagraphBlock, ParagraphMeasure, ColumnLayout } from '../../contracts/src/index.js';
+import { NonFlowingPageRelativeAnchorDependencyProof, PageCheckpointDependencyClass, FlowBlock, Layout, Measure, HeaderFooterLayout, ParagraphBlock, ParagraphMeasure, ColumnLayout } from '../../contracts/src/index.js';
 import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
 import { LayoutOptions, HeaderFooterConstraints } from '../../layout-engine/src/index.js';
 import { computeDirtyRegions } from './diff.js';
@@ -207,6 +207,7 @@ export type IncrementalPaginationProof = IncrementalPaginationProofBase & ({
     globalDependenciesAbsent: false;
     globalDependenciesFencedByPageCheckpoint: true;
     admittedDependencyClasses: readonly PageCheckpointDependencyClass[];
+    nonFlowingPageRelativeAnchorDependency?: NonFlowingPageRelativeAnchorDependencyProof;
     localKeepDependencyClosure?: {
         checkpointPageIndex: number;
         checkpointBlockId: string | null;

package/dist/layout-engine/layout-bridge/src/index.d.ts

@@ -12,6 +12,7 @@ export type { BoundaryRange } from './text-boundaries.js';
 export { buildSectionAwareHeaderFooterLayoutKey, buildSectionContentWidth, buildEffectiveHeaderFooterRefsBySection, collectReferencedHeaderFooterRIds, buildSectionAwareHeaderFooterMeasurementGroups, } from './sectionAwareHeaderFooter.js';
 export type { HeaderFooterSectionKind, HeaderFooterRefs, SectionAwareHeaderFooterMeasurementGroup, } from './sectionAwareHeaderFooter.js';
 export { clearIncrementalModuleState, incrementalLayout, measureCache, normalizeMargin, hydrateTableTextboxMeasures, } from './incrementalLayout.js';
+export { hashMeasureContent } from './cache.js';
 export type { HeaderFooterLayoutResult, IncrementalLayoutBridgeTiming, IncrementalLayoutResult, IncrementalMeasureReuseProof, IncrementalLayoutReuseOptions, IncrementalLayoutReuseSummary, IncrementalSectionPageNumberTransform, IncrementalLayoutTailAdoption, IncrementalLayoutTailDisposition, IncrementalPaginationProof, LayoutPositionTransform, FootnoteReserveSeed, } from './incrementalLayout.js';
 export { collectFootnoteLedgers, getPreferredReserveCandidates, getPreferredReserveTrialTargets, isMandatoryOnlyFootnotePage, scoreFootnoteWindow, summarizeFootnoteWindow, } from './footnote-scorer.js';
 export type { FootnotePreferredReserveCandidate, FootnoteWindowScoreInput, FootnoteWindowScoreReason, FootnoteWindowScoreResult, FootnoteWindowStats, } from './footnote-scorer.js';

package/dist/public/ui-react.cjs

@@ -1,17 +1,45 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rolldown_runtime = require("../chunks/rolldown-runtime-1Y-nnZJ3.cjs");
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DXdWuTzm.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-jSJQis_0.cjs");
 let react = require("react");
+//#region src/public/ui/react.ts
+/**
+* v2-native React bindings for the `superdoc/ui` controller.
+*
+* Provider + hooks over the SuperDoc-owned controller (`superdoc.ui`). For a
+* real `SuperDoc` this layer never creates or destroys a controller; it binds
+* to the one the instance already owns. It falls back to building (and then
+* owning) one only for a structural host that carries no `ui`, since
+* `SuperDocHost` leaves that property optional. Authored with
+* `React.createElement` (no JSX) so the
+* library build needs no JSX transform, and `react` stays an external/optional
+* peer. No v1 editor or private v2 runtime imports.
+*/
 var SuperDocUIContext = (0, react.createContext)(null);
+/**
+* Destroy a controller this provider built itself. Controllers read off
+* `superdoc.ui` are never passed here: the instance owns those.
+*/
 function disposeOwnedUi(ref) {
 	const ui = ref.current;
 	if (!ui) return;
 	ui.destroy();
 	ref.current = null;
 }
+/**
+* Root provider. Call {@link useSetSuperDoc} from your editor-mount
+* component's ready callback to bind a running SuperDoc instance; the hooks
+* below then read that instance's own controller (`superdoc.ui`).
+*
+* The provider is a consumer, not an owner. SuperDoc creates the controller
+* and destroys it in `superdoc.destroy()`, so unmounting or rebinding the
+* provider leaves it running for the built-in toolbar and any other consumer
+* of the same instance. Every React hook therefore observes the same command
+* state the rest of the application sees.
+*/
 function SuperDocUIProvider(props) {
 	const [ui, setUi] = (0, react.useState)(null);
 	const [host, setHost] = (0, react.useState)(null);
+	/** Only ever holds a controller this provider created for a host lacking one. */
 	const ownedUiRef = (0, react.useRef)(null);
 	const setSuperDoc = (0, react.useCallback)((superdoc) => {
 		const hostUi = superdoc.ui;
@@ -37,15 +65,33 @@ function useContextValue() {
 	if (!value) throw new Error("[superdoc/ui/react] hooks must be used within <SuperDocUIProvider>.");
 	return value;
 }
+/**
+* Read the controller, or `null` until a SuperDoc instance is bound.
+*
+* Borrowed: the bound instance owns teardown, so the returned type omits
+* `destroy()`. A provider-built fallback controller is disposed by the provider.
+*/
 function useSuperDocUI() {
 	return useContextValue().ui;
 }
+/** Read the raw bound SuperDoc host, or `null` until one is bound. */
 function useSuperDocHost() {
 	return useContextValue().host;
 }
+/** Get the stable callback used to bind a running SuperDoc instance. */
 function useSetSuperDoc() {
 	return useContextValue().setSuperDoc;
 }
+/**
+* Normalize a `pick` result into a {@link SliceSource}. Domain handles and the
+* command/font hooks already expose the snapshot-shaped contract
+* (`getSnapshot` + `observe`) and pass through unchanged. A raw `ui.select(...)`
+* {@link Subscribable} (`get` + `subscribe`) is adapted: it `subscribe`s FIRST,
+* then emits the current value, so a synchronous recompute triggered by the
+* first listener is not missed (the substrate's `subscribe` does not emit on
+* attach). Exported for unit tests; not re-exported by the `superdoc/ui/react`
+* facade, so it stays off the public surface.
+*/
 function toSliceSource(source) {
 	const candidate = source;
 	if (typeof candidate.getSnapshot === "function" && typeof candidate.observe === "function") return source;
@@ -59,6 +105,13 @@ function toSliceSource(source) {
 		}
 	};
 }
+/**
+* Subscribe to a derived slice of controller state. `pick` selects a value
+* source from the controller: a domain handle / snapshot source
+* ({@link SliceSource}) or a raw `ui.select(...)` {@link Subscribable}, both
+* normalized via {@link toSliceSource}. `initial` is returned until the
+* controller is bound.
+*/
 function useSuperDocSlice(pick, initial) {
 	const ui = useSuperDocUI();
 	const [value, setValue] = (0, react.useState)(() => ui ? toSliceSource(pick(ui)).getSnapshot() : initial);
@@ -83,9 +136,11 @@ var EMPTY_SELECTION = {
 	activeChangeIds: [],
 	quotedText: ""
 };
+/** Subscribe to the selection slice. */
 function useSuperDocSelection() {
 	return useSuperDocSlice((ui) => ui.selection, EMPTY_SELECTION);
 }
+/** Subscribe to the comments slice. */
 function useSuperDocComments() {
 	return useSuperDocSlice((ui) => ui.comments, {
 		status: "pending",
@@ -96,6 +151,7 @@ function useSuperDocComments() {
 		activeId: null
 	});
 }
+/** Subscribe to the content-controls slice. */
 function useSuperDocContentControls() {
 	return useSuperDocSlice((ui) => ui.contentControls, {
 		status: "pending",
@@ -105,6 +161,7 @@ function useSuperDocContentControls() {
 		activeIds: []
 	});
 }
+/** Subscribe to the track-changes slice. */
 function useSuperDocTrackChanges() {
 	return useSuperDocSlice((ui) => ui.trackChanges, {
 		status: "pending",
@@ -114,6 +171,7 @@ function useSuperDocTrackChanges() {
 		authors: []
 	});
 }
+/** Subscribe to the toolbar snapshot slice. */
 function useSuperDocToolbar() {
 	return useSuperDocSlice((ui) => ui.toolbar, {
 		context: null,
@@ -121,6 +179,7 @@ function useSuperDocToolbar() {
 		copyFormatActive: false
 	});
 }
+/** Subscribe to a single command's enable/active state. */
 function useSuperDocCommand(id) {
 	return useSuperDocSlice((ui) => ({
 		getSnapshot: () => ui.commands.get(id).getState(),
@@ -131,6 +190,7 @@ function useSuperDocCommand(id) {
 		supported: false
 	});
 }
+/** Subscribe to the document slice. */
 function useSuperDocDocument() {
 	return useSuperDocSlice((ui) => ui.document, {
 		ready: false,
@@ -138,18 +198,21 @@ function useSuperDocDocument() {
 		dirty: false
 	});
 }
+/** Subscribe to available font-family options. */
 function useSuperDocFontOptions() {
 	return useSuperDocSlice((ui) => ({
 		getSnapshot: () => ui.fonts.getFamilyOptions(),
 		observe: (cb) => ui.fonts.observe((slice) => cb(slice.options))
 	}), []);
 }
+/** Subscribe to available font-size options. */
 function useSuperDocFontSizeOptions() {
 	return useSuperDocSlice((ui) => ({
 		getSnapshot: () => ui.fonts.getSizeOptions(),
 		observe: (cb) => ui.fonts.observe((slice) => cb(slice.sizeOptions))
 	}), []);
 }
+/** Subscribe to the zoom slice. */
 function useSuperDocZoom() {
 	return useSuperDocSlice((ui) => ui.zoom, {
 		mode: null,
@@ -158,6 +221,7 @@ function useSuperDocZoom() {
 		max: 100
 	});
 }
+//#endregion
 exports.SuperDocUIProvider = SuperDocUIProvider;
 exports.useSetSuperDoc = useSetSuperDoc;
 exports.useSuperDocCommand = useSuperDocCommand;