superdoc 2.28.0-next.5 → 2.28.0-next.6

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ 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.28.0-next.5",
+	superdocVersion: "2.28.0-next.6",
 	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

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

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -744,7 +744,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.captureTemplate': {
         readonly memberPath: "lists.captureTemplate";
-        readonly description: "Advanced alias for lists.getStyle. Capture list formatting from the abstract definition only (does not merge lvlOverride formatting).";
+        readonly description: "Capture reusable effective list formatting, including full level overrides and Word defaults, without instance continuation checkpoints (startOverride).";
         readonly expectedResult: "Returns a ListsCaptureTemplateResult containing the captured template.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -834,8 +834,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.applyStyle': {
         readonly memberPath: "lists.applyStyle";
-        readonly description: "Apply a reusable list style to the target list. Sequence-local: if the abstract definition is shared with other lists, it is cloned first to avoid affecting them.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if all levels already match.";
+        readonly description: "Apply a reusable list style to the target list. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when all levels already match.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/apply-style.mdx";
@@ -852,8 +852,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelNumberStyle': {
         readonly memberPath: "lists.setLevelNumberStyle";
-        readonly description: "Set the numbering style (e.g. decimal, lowerLetter, upperRoman) for a specific list level. Rejects \"bullet\": use setLevelBullet instead. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if the value already matches.";
+        readonly description: "Set the numbering style (e.g. decimal, lowerLetter, upperRoman) for a specific list level. Rejects \"bullet\": use setLevelBullet instead. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE for numberInDash and inherited, mixed-counter, or nested-restart continuations whose numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when the effective value already matches.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-number-style.mdx";
@@ -861,8 +861,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelText': {
         readonly memberPath: "lists.setLevelText";
-        readonly description: "Set the level text pattern (e.g. \"%1.\", \"(%1)\") for a specific list level. Uses OOXML level-placeholder syntax. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if the value already matches.";
+        readonly description: "Set the level text pattern (e.g. \"%1.\", \"(%1)\") for a specific list level. Uses OOXML level-placeholder syntax. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when the value already matches.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-text.mdx";
@@ -870,8 +870,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelStart': {
         readonly memberPath: "lists.setLevelStart";
-        readonly description: "Set the start value for a specific list level. Rejects bullet levels and non-positive values. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if the value already matches.";
+        readonly description: "Set the start value for a specific list level. Rejects bullet levels and non-positive values. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when the value already matches.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-start.mdx";
@@ -879,8 +879,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelLayout': {
         readonly memberPath: "lists.setLevelLayout";
-        readonly description: "Set the layout properties (alignment, indentation, trailing character, tab stop) for a specific list level. Accepts partial updates: omitted fields are left unchanged. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if all values already match.";
+        readonly description: "Set the layout properties (alignment, indentation, trailing character, tab stop) for a specific list level. Accepts partial updates: omitted fields are left unchanged. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when all values already match.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-layout.mdx";

package/dist/document-api/src/index.d.ts

@@ -185,7 +185,7 @@ export { isBlockNodeAddress } from './validation-primitives.js';
 export type { InsertInput, InsertContentType, TextInsertInput, PlainTextInsertInput, RichContentInsertInput, NativeOoxmlInsertInput, LegacyInsertInput, } from './insert/insert.js';
 export { isStructuralInsertInput } from './insert/insert.js';
 export type { ReplaceInput, TextReplaceInput, TextReplacementGranularity, RichContentReplaceInput, ReplaceMutationOptions, NativeOoxmlReplaceInput, SnapshotReplaceInput, ParagraphTextReplaceInput, } from './replace/replace.js';
-export { executeReplace, isStructuralReplaceInput, isRichContentReplaceInput } from './replace/replace.js';
+export { executeReplace, isStructuralReplaceInput, isRichContentReplaceInput, TEXT_REPLACEMENT_GRANULARITIES, isTextReplacementGranularity, isSingleParagraphVisibleTextSelection, } from './replace/replace.js';
 export { executeFind } from './find/find.js';
 export { validateDocumentFragment, validateSDFragment } from './validation/fragment-validator.js';
 export type { DeleteInput } from './delete/delete.js';

package/dist/document-api/src/replace/replace.d.ts

@@ -7,7 +7,10 @@ import { BodyStoryLocator, StoryLocator } from '../types/story.types.js';
 import { BlockNodeAddress } from '../types/base.js';
 import { NestingPolicy } from '../types/placement.js';
 import { SelectionMutationAdapter } from '../selection-mutation.js';
-export type TextReplacementGranularity = 'word' | 'phrase' | 'range';
+export declare const TEXT_REPLACEMENT_GRANULARITIES: readonly ["word", "phrase", "range"];
+export type TextReplacementGranularity = (typeof TEXT_REPLACEMENT_GRANULARITIES)[number];
+export declare function isTextReplacementGranularity(value: unknown): value is TextReplacementGranularity;
+export declare function isSingleParagraphVisibleTextSelection(target: unknown): target is SelectionTarget;
 /** Text replacement input: uses SelectionTarget / ref, or the complete main body. */
 export type TextReplaceInput = {
     target: SelectionTarget;

package/dist/document-api/src/types/mutation-plan.types.d.ts

@@ -6,6 +6,7 @@ import { InlineRunPatch } from '../format/inline-run-patch.js';
 import { SDFragment } from './fragment.js';
 import { Placement, NestingPolicy } from './placement.js';
 import { AffectedRef, ReceiptSuccess } from './receipt.js';
+import { TextReplacementGranularity } from '../replace/replace.js';
 import { ChangeMode } from '../write/write.js';
 import { StoryLocator } from './story.types.js';
 export type SelectWhere = {
@@ -70,6 +71,7 @@ export type TextRewriteStep = {
         replacementMode?: 'literal' | 'regex-template';
         /** Preserve the matched text's casing pattern instead of using replacement casing verbatim. */
         caseHandling?: 'exact' | 'preserve-match';
+        replacementGranularity?: TextReplacementGranularity;
         /**
          * Style policy for the replacement text.
          * When omitted, uses the native preserve policy: