superdoc 2.0.0-next.24 → 2.0.0-next.26

package/AGENTS.md

@@ -55,8 +55,8 @@ Drop SuperDoc into any HTML page via `<script>` tag. No bundler, no `npm install
 
 ### Production pinning and integrity
 
-- The examples above use the v2 `@next` channel. **In production, pin to a specific version** (for example `superdoc@2.0.0-beta.33`) so you control upgrades.
-- Add [SRI hashes](https://developer.mozilla.org/docs/Web/Security/Subresource_Integrity) for production. Generate with: `curl -s https://cdn.jsdelivr.net/npm/superdoc@2.0.0-beta.33/dist-cdn/superdoc.min.js | openssl dgst -sha384 -binary | openssl base64 -A | sed 's/^/sha384-/'`. Include `integrity="sha384-..." crossorigin="anonymous"` on each `<script>` and `<link>`.
+- The examples above use the v2 `@next` channel. **In production, pin to a specific published `2.0.0-next.N` version** (for example `superdoc@2.0.0-next.24`) so you control upgrades.
+- Add [SRI hashes](https://developer.mozilla.org/docs/Web/Security/Subresource_Integrity) for production. Generate with: `curl -s https://cdn.jsdelivr.net/npm/superdoc@2.0.0-next.24/dist-cdn/superdoc.min.js | openssl dgst -sha384 -binary | openssl base64 -A | sed 's/^/sha384-/'`. Include `integrity="sha384-..." crossorigin="anonymous"` on each `<script>` and `<link>`.
 - jsDelivr serves immutable, gzipped responses (~1.5 MB on the wire for `superdoc.min.js`).
 
 Unpkg is mirrored automatically: replace `cdn.jsdelivr.net/npm/` with `unpkg.com/`.

package/dist/chunks/{create-super-doc-ui-BMpP-iB6.es.js → create-super-doc-ui-CBs8xQUw.es.js}

@@ -3051,6 +3051,11 @@ function createSuperDocUI(options) {
 		if (fromConfig && fromRuntime && fromConfig !== fromRuntime) return fromConfig;
 		return fromRuntime ?? fromConfig ?? fromOptions;
 	};
+	const commentsReadOnlyForReview = () => {
+		const comments$1 = (((superdoc && typeof superdoc === "object" ? superdoc : null)?.config)?.modules)?.comments;
+		return !!comments$1 && typeof comments$1 === "object" && comments$1.readOnly === true;
+	};
+	const reviewMutationsAreReadOnly = () => readDocumentMode() === "viewing" || commentsReadOnlyForReview();
 	const normalizeSelectionInfo = (raw) => raw && typeof raw === "object" ? raw : null;
 	const selectionSliceFromInfo = (info, status) => {
 		if (!info) return {
@@ -3611,7 +3616,7 @@ function createSuperDocUI(options) {
 			const supportsSingle = typeof tcApi?.decide === "function" || typeof tcApi?.[trackCommand.kind] === "function";
 			const supportsAll = typeof tcApi?.decide === "function" || typeof tcApi?.[`${trackCommand.kind}All`] === "function";
 			const supported = trackCommand.scope === "all" ? supportsAll : supportsSingle;
-			const reason = bulkTrackDecisionBlockedReason(trackCommand, tcApi) ?? trackDecisionReason(trackCommand, supported, readonly, selection$1, doc);
+			const reason = bulkTrackDecisionBlockedReason(trackCommand, tcApi) ?? trackDecisionReason(trackCommand, supported, reviewMutationsAreReadOnly(), selection$1, doc);
 			return normalizeCommandState({
 				enabled: reason == null,
 				active: false,
@@ -6118,7 +6123,7 @@ function createSuperDocUI(options) {
 		}, id, story);
 	};
 	const executeTrackDecisionTarget = (kind, target, changeId, story) => {
-		if (readDocumentMode() === "viewing") return false;
+		if (reviewMutationsAreReadOnly()) return false;
 		const tcApi = getDoc()?.trackChanges;
 		if (bulkTrackDecisionBlockedReason({
 			kind,

package/dist/chunks/{create-super-doc-ui-DbFtp705.cjs → create-super-doc-ui-CHZKlLiH.cjs}

@@ -3051,6 +3051,11 @@ function createSuperDocUI(options) {
 		if (fromConfig && fromRuntime && fromConfig !== fromRuntime) return fromConfig;
 		return fromRuntime ?? fromConfig ?? fromOptions;
 	};
+	const commentsReadOnlyForReview = () => {
+		const comments$1 = (((superdoc && typeof superdoc === "object" ? superdoc : null)?.config)?.modules)?.comments;
+		return !!comments$1 && typeof comments$1 === "object" && comments$1.readOnly === true;
+	};
+	const reviewMutationsAreReadOnly = () => readDocumentMode() === "viewing" || commentsReadOnlyForReview();
 	const normalizeSelectionInfo = (raw) => raw && typeof raw === "object" ? raw : null;
 	const selectionSliceFromInfo = (info, status) => {
 		if (!info) return {
@@ -3611,7 +3616,7 @@ function createSuperDocUI(options) {
 			const supportsSingle = typeof tcApi?.decide === "function" || typeof tcApi?.[trackCommand.kind] === "function";
 			const supportsAll = typeof tcApi?.decide === "function" || typeof tcApi?.[`${trackCommand.kind}All`] === "function";
 			const supported = trackCommand.scope === "all" ? supportsAll : supportsSingle;
-			const reason = bulkTrackDecisionBlockedReason(trackCommand, tcApi) ?? trackDecisionReason(trackCommand, supported, readonly, selection$1, doc);
+			const reason = bulkTrackDecisionBlockedReason(trackCommand, tcApi) ?? trackDecisionReason(trackCommand, supported, reviewMutationsAreReadOnly(), selection$1, doc);
 			return normalizeCommandState({
 				enabled: reason == null,
 				active: false,
@@ -6118,7 +6123,7 @@ function createSuperDocUI(options) {
 		}, id, story);
 	};
 	const executeTrackDecisionTarget = (kind, target, changeId, story) => {
-		if (readDocumentMode() === "viewing") return false;
+		if (reviewMutationsAreReadOnly()) return false;
 		const tcApi = getDoc()?.trackChanges;
 		if (bulkTrackDecisionBlockedReason({
 			kind,

package/dist/collaboration-upgrade-engine.cjs

@@ -7,7 +7,7 @@ const 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.0.0-next.24",
+	superdocVersion: "2.0.0-next.26",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -6,7 +6,7 @@ const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.0.0-next.24",
+	superdocVersion: "2.0.0-next.26",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -84,8 +84,10 @@ export interface DeletedBlockSummary {
 export interface BlocksSplitInput {
     /** Paragraph-shaped block to split. Only `paragraph` / `heading` / `listItem` are supported. */
     target: BlockNodeAddress;
-    /** Char offset inside the target paragraph's visible text where the split occurs. */
+    /** Char offset inside the target paragraph in the declared coordinate space. */
     offset: number;
+    /** Include deleted tracked text in the offset ruler. Defaults to `visible`. */
+    coordinateSpace?: 'visible' | 'tracked';
 }
 export interface BlocksSplitSuccessResult {
     success: true;

package/dist/layout-engine/layout-engine/src/paginator.d.ts

@@ -95,6 +95,14 @@ export declare class PaginationEarlyStop extends Error {
     constructor();
 }
 export declare function isPaginationEarlyStop(error: unknown): error is PaginationEarlyStop;
+/**
+ * Break paragraph-only spacing and border adjacency at an in-flow block boundary.
+ *
+ * Paragraph layout has already included `trailingSpacing` in `cursorY`, so this
+ * intentionally does not move the cursor. It only prevents a later paragraph
+ * from collapsing spacing or borders through an intervening block.
+ */
+export declare function breakParagraphAdjacency(state: PageState): void;
 export declare function createPaginator(opts: PaginatorOptions): {
     readonly pages: Page[];
     readonly states: PageState[];

package/dist/public/ui-react.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-_dR15c8t.cjs");
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DbFtp705.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CHZKlLiH.cjs");
 let react = require("react");
 var SuperDocUIContext = (0, react.createContext)(null);
 function SuperDocUIProvider(props) {

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BMpP-iB6.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-CBs8xQUw.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 var SuperDocUIContext = createContext(null);
 function SuperDocUIProvider(props) {

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DbFtp705.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CHZKlLiH.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as BUILT_IN_COMMAND_IDS, r as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BMpP-iB6.es.js";
+import { n as BUILT_IN_COMMAND_IDS, r as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-CBs8xQUw.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };