superdoc 2.27.0 → 2.28.0-next.10

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

@@ -64,7 +64,7 @@ import { CaptionsApi, CaptionsAdapter } from './captions/captions.js';
 import { FieldsApi, FieldsAdapter } from './fields/fields.js';
 import { CitationsApi, CitationsAdapter } from './citations/citations.js';
 import { AuthoritiesApi, AuthoritiesAdapter } from './authorities/authorities.js';
-export type { TemporaryMutationInput, TemporaryMutationHandleInput, TemporaryMutationCommitInput, TemporaryMutationReplaceInput, TemporaryMutationReceipt, TemporaryMutationMetadata, TemporaryMutationOperation, TemporaryOperationResultTarget, } from './types/temporary-mutation.js';
+export type { TemporaryMutationInput, TemporaryMutationHandleInput, TemporaryMutationCommitInput, TemporaryMutationReplaceInput, TemporaryMutationReceipt, TemporaryMutationMetadata, TemporaryMutationOperation, TemporaryOperationResultTarget, TemporaryOperationEffects, } from './types/temporary-mutation.js';
 export * from './types/index.js';
 export * from './contract/index.js';
 export * from './capabilities/capabilities.js';
@@ -75,6 +75,7 @@ export { executeHistoryGet, executeHistoryUndo, executeHistoryRedo } from './his
 export type { DiffAdapter, DiffApi } from './diff/diff.js';
 export * from './diff/diff.types.js';
 export type { ExportAdapter, ExportApi } from './export/export.js';
+export { resolveDocxExportPolicies } from './export/export.js';
 export * from './export/export.types.js';
 export type { SelectionMutationAdapter, SelectionMutationRequest, SelectionInsertRequest, } from './selection-mutation.js';
 export type { RangeAnchor, DocumentEdgeAnchor, PointAnchor, RefBoundaryAnchor, ResolveRangeInput, ResolveRangeOutput, RangeBlockPreview, RangePreview, RangeResolverAdapter, ScrollIntoViewInput, ScrollIntoViewOutput, } from './ranges/index.js';
@@ -116,10 +117,10 @@ export type { FormatReadSelectionAdapter, FormatReadSelectionInput, FormatReadSe
 export type { InlineRunPatch, InlineRunPatchKey, InlinePropertyStorage, InlinePropertyType, InlinePropertyCarrier, InlinePropertyRegistryEntry, UnderlinePatch, ShadingPatch, BorderPatch, FitTextPatch, LangPatch, RFontsPatch, EastAsianLayoutPatch, StylisticSetPatch, } from './format/inline-run-patch.js';
 export { CLEAR_INLINE_FORMATTING_KEYS, INLINE_PROPERTY_REGISTRY, INLINE_PROPERTY_KEY_SET, INLINE_PROPERTY_BY_KEY, INLINE_PROPERTY_KEYS_BY_STORAGE, validateInlineRunPatch, buildInlineRunPatchSchema, } from './format/inline-run-patch.js';
 export { PROPERTY_REGISTRY, EXCLUDED_KEYS, ALLOWED_KEYS_BY_CHANNEL, getPropertyDefinition, toJsonSchema, buildPatchSchema, buildStateSchema, } from './styles/index.js';
-export type { ValueSchema, MergeStrategy, PropertyDefinition, StylesAdapter, StylesApplyInput, StylesApplyRunInput, StylesApplyParagraphInput, StylesApplyOptions, StylesApplyReceipt, StylesBooleanState, StylesNumberState, StylesEnumState, StylesObjectState, StylesArrayState, StylesStateMap, StylesChannel, StylesRunPatch, StylesParagraphPatch, StylesTargetResolution, StylesApplyReceiptSuccess, StylesApplyReceiptFailure, NormalizedStylesApplyOptions, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogDiagnosticSeverity, StyleSourcePartStatus, StyleCatalogUsageStatus, StyleCatalogPreviewStatus, StyleCatalogViewStatus, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogPreviewFontSource, StyleCatalogPreviewColorSource, StyleCatalogPreviewSources, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, StylesGetCatalogAdapter, StylesGetThemeInput, StylesThemeSourceStatus, StylesGetThemeResult, StylesGetThemeAdapter, } from './styles/index.js';
+export type { ValueSchema, MergeStrategy, PropertyDefinition, StylesAdapter, StylesApplyInput, StylesApplyRunInput, StylesApplyParagraphInput, StylesApplyStyleRunInput, StylesStyleRunPatch, StylesDocDefaultsResolution, StylesStyleResolution, StylesApplyOptions, StylesApplyReceipt, StylesBooleanState, StylesNumberState, StylesEnumState, StylesObjectState, StylesArrayState, StylesStateMap, StylesChannel, StylesRunPatch, StylesParagraphPatch, StylesTargetResolution, StylesApplyReceiptSuccess, StylesApplyReceiptFailure, NormalizedStylesApplyOptions, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogDiagnosticSeverity, StyleSourcePartStatus, StyleCatalogUsageStatus, StyleCatalogPreviewStatus, StyleCatalogViewStatus, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogPreviewFontSource, StyleCatalogPreviewColorSource, StyleCatalogPreviewSources, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, StylesGetCatalogAdapter, StylesGetThemeInput, StylesThemeSourceStatus, StylesGetThemeResult, StylesGetThemeAdapter, } from './styles/index.js';
 export { STYLE_CATALOG_VIEWS, STYLE_CATALOG_FILTER_TYPES, executeStylesGetCatalog, validateStylesGetCatalogInput, executeStylesGetTheme, validateStylesGetThemeInput, } from './styles/index.js';
 export type { StylesScope, StyleRunPatch, StyleConflictPolicy, StyleChannelState, StylesCreateAdapter, StylesCreateApi, StylesCreateInput, StylesCreateParagraphInput, StylesCreateCharacterInput, StylesCreateOptions, NormalizedStylesCreateOptions, StylesCreateResolution, StylesCreateReceipt, StylesCreateReceiptSuccess, StylesCreateReceiptFailure, } from './styles/index.js';
-export { STYLE_EXCLUDED_KEYS, EXCLUDED_KEYS_BY_SCOPE, SCOPE_LABEL, STYLE_XML_PATH, executeStylesCreate, validateStylesCreateInput, validateStylesCreateOptions, validatePatchObject, } from './styles/index.js';
+export { STYLE_EXCLUDED_KEYS, EXCLUDED_KEYS_BY_SCOPE, SCOPE_LABEL, STYLE_XML_PATH, STYLE_RUN_XML_PATH, validateStylesApplyInput, executeStylesCreate, validateStylesCreateInput, validateStylesCreateOptions, validatePatchObject, } from './styles/index.js';
 export type { TemplatesAdapter, TemplatesApi, TemplatesApplyInput, TemplatesApplyOptions, TemplatesApplySource, TemplatesApplySourcePath, TemplatesApplySourceBase64, TemplateBodyPolicy, TemplateScope, NormalizedTemplatesApplyOptions, TemplateScopeReport, TemplateSkipReason, TemplateScopeSkip, TemplateUnsupportedItem, TemplateChangeKind, TemplateChangedPart, TemplateIdMapping, TemplateApplyWarning, TemplatesApplySourceInfo, TemplatesApplyReceiptSuccess, TemplatesApplyFailureCode, TemplatesApplyReceiptFailure, TemplatesApplyReceipt, } from './templates/index.js';
 export { executeTemplatesApply } from './templates/index.js';
 export type { CreateAdapter, CreateApi } from './create/create.js';
@@ -185,7 +186,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/styles/apply.d.ts

@@ -1,6 +1,7 @@
 import { ReceiptFailure } from '../types/receipt.js';
 import { StylesChannel } from './registry.js';
 import { StylesGetCatalogInput, StylesGetCatalogResult } from './catalog.js';
+import { StyleRunPatch } from './create.js';
 import { StylesGetThemeInput, StylesGetThemeResult } from './theme.js';
 /** Tri-state for OOXML boolean style properties. */
 export type StylesBooleanState = 'on' | 'off' | 'inherit';
@@ -78,12 +79,22 @@ export interface StylesParagraphPatch {
     borders?: Record<string, unknown>;
     tabStops?: unknown[];
 }
-export interface StylesTargetResolution {
+export interface StylesDocDefaultsResolution {
     scope: 'docDefaults';
     channel: StylesChannel;
     xmlPart: string;
     xmlPath: string;
 }
+export interface StylesStyleResolution {
+    scope: 'style';
+    styleId: string;
+    channel: 'run';
+    xmlPart: string;
+    xmlPath: typeof STYLE_RUN_XML_PATH;
+    linkedStyleId?: string;
+}
+export type StylesTargetResolution = StylesDocDefaultsResolution | StylesStyleResolution;
+export declare const STYLE_RUN_XML_PATH = "w:styles/w:style/w:rPr";
 export interface StylesApplyRunInput {
     target: {
         scope: 'docDefaults';
@@ -98,7 +109,18 @@ export interface StylesApplyParagraphInput {
     };
     patch: StylesParagraphPatch;
 }
-export type StylesApplyInput = StylesApplyRunInput | StylesApplyParagraphInput;
+export type StylesStyleRunPatch = {
+    [K in keyof StyleRunPatch]?: StyleRunPatch[K] | null;
+};
+export interface StylesApplyStyleRunInput {
+    target: {
+        scope: 'style';
+        styleId: string;
+        channel: 'run';
+    };
+    patch: StylesStyleRunPatch;
+}
+export type StylesApplyInput = StylesApplyRunInput | StylesApplyParagraphInput | StylesApplyStyleRunInput;
 export interface StylesApplyOptions {
     dryRun?: boolean;
     expectedRevision?: string;
@@ -121,6 +143,7 @@ export type StylesApplyReceipt = StylesApplyReceiptSuccess | StylesApplyReceiptF
 export interface StylesAdapter {
     apply(input: StylesApplyRunInput, options: NormalizedStylesApplyOptions): StylesApplyReceipt;
     apply(input: StylesApplyParagraphInput, options: NormalizedStylesApplyOptions): StylesApplyReceipt;
+    apply(input: StylesApplyStyleRunInput, options: NormalizedStylesApplyOptions): StylesApplyReceipt;
     apply(input: StylesApplyInput, options: NormalizedStylesApplyOptions): StylesApplyReceipt;
     /** Read the normalized style catalogue. See `styles/catalog.ts`. */
     getCatalog?(input?: StylesGetCatalogInput): StylesGetCatalogResult;
@@ -134,6 +157,7 @@ export interface NormalizedStylesApplyOptions {
 export interface StylesApi {
     apply(input: StylesApplyRunInput, options?: StylesApplyOptions): StylesApplyReceipt;
     apply(input: StylesApplyParagraphInput, options?: StylesApplyOptions): StylesApplyReceipt;
+    apply(input: StylesApplyStyleRunInput, options?: StylesApplyOptions): StylesApplyReceipt;
     apply(input: StylesApplyInput, options?: StylesApplyOptions): StylesApplyReceipt;
     /** Read the normalized style catalogue for discovery and quick-gallery UI. */
     getCatalog(input?: StylesGetCatalogInput): StylesGetCatalogResult;

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

@@ -6,8 +6,8 @@
 export type { ValueSchema, StylesChannel, StylesScope, MergeStrategy, PropertyDefinition } from './registry.js';
 export { PROPERTY_REGISTRY, ALLOWED_KEYS_BY_CHANNEL, EXCLUDED_KEYS, STYLE_EXCLUDED_KEYS, EXCLUDED_KEYS_BY_SCOPE, SCOPE_LABEL, XML_PATH_BY_CHANNEL, getPropertyDefinition, ST_VERTICAL_ALIGN_RUN, ST_EM, ST_TEXT_ALIGNMENT, ST_TEXT_DIRECTION, ST_TEXTBOX_TIGHT_WRAP, ST_TEXT_TRANSFORM, ST_JUSTIFICATION, } from './registry.js';
 export { toJsonSchema, buildPatchSchema, buildStateSchema } from './schema.js';
-export type { StylesBooleanState, StylesNumberState, StylesEnumState, StylesObjectState, StylesArrayState, StylesRunPatch, StylesParagraphPatch, StylesTargetResolution, StylesApplyRunInput, StylesApplyParagraphInput, StylesApplyInput, StylesApplyOptions, StylesStateMap, StylesApplyReceiptSuccess, StylesApplyReceiptFailure, StylesApplyReceipt, StylesAdapter, NormalizedStylesApplyOptions, StylesApi, } from './apply.js';
-export { executeStylesApply } from './apply.js';
+export type { StylesBooleanState, StylesNumberState, StylesEnumState, StylesObjectState, StylesArrayState, StylesRunPatch, StylesParagraphPatch, StylesTargetResolution, StylesApplyRunInput, StylesApplyParagraphInput, StylesApplyStyleRunInput, StylesStyleRunPatch, StylesDocDefaultsResolution, StylesStyleResolution, StylesApplyInput, StylesApplyOptions, StylesStateMap, StylesApplyReceiptSuccess, StylesApplyReceiptFailure, StylesApplyReceipt, StylesAdapter, NormalizedStylesApplyOptions, StylesApi, } from './apply.js';
+export { STYLE_RUN_XML_PATH, executeStylesApply } from './apply.js';
 export type { StyleRunPatch, StyleConflictPolicy, StyleChannelState, StylesCreateParagraphInput, StylesCreateCharacterInput, StylesCreateInput, StylesCreateOptions, NormalizedStylesCreateOptions, StylesCreateResolution, StylesCreateReceiptSuccess, StylesCreateReceiptFailure, StylesCreateReceipt, StylesCreateAdapter, StylesCreateApi, } from './create.js';
 export { STYLE_XML_PATH, executeStylesCreate, validateStylesCreateInput, validateStylesCreateOptions, } from './create.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogDiagnosticSeverity, StyleSourcePartStatus, StyleCatalogUsageStatus, StyleCatalogPreviewStatus, StyleCatalogViewStatus, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogPreviewFontSource, StyleCatalogPreviewColorSource, StyleCatalogPreviewSources, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, StylesGetCatalogAdapter, } from './catalog.js';
@@ -15,4 +15,4 @@ export { STYLE_CATALOG_VIEWS, STYLE_CATALOG_FILTER_TYPES, executeStylesGetCatalo
 export type { StylesGetThemeInput, StylesThemeSourceStatus, StylesGetThemeResult, StylesGetThemeAdapter, } from './theme.js';
 export { executeStylesGetTheme, validateStylesGetThemeInput } from './theme.js';
 export type { PatchKeyClassification } from './validation.js';
-export { validateValue, classifyPatchKey, validatePatchObject } from './validation.js';
+export { validateValue, classifyPatchKey, validatePatchObject, validateStylesApplyInput } from './validation.js';

package/dist/document-api/src/styles/schema.d.ts

@@ -10,7 +10,9 @@ export declare function toJsonSchema(schema: ValueSchema): JsonSchema;
  * a schema that advertised them on `docDefaults` would describe an input the
  * validator rejects.
  */
-export declare function buildPatchSchema(channel: StylesChannel, scope?: StylesScope): JsonSchema;
+export declare function buildPatchSchema(channel: StylesChannel, scope?: StylesScope, options?: {
+    nullable?: boolean;
+}): JsonSchema;
 /**
  * Builds a JSON Schema for the before/after state map of a given scope.
  *

package/dist/document-api/src/styles/validation.d.ts

@@ -13,6 +13,13 @@ export type StylesApplyInputShape = {
         channel: StylesChannel;
     };
     patch: Record<string, unknown>;
+} | {
+    target: {
+        scope: 'style';
+        styleId: string;
+        channel: 'run';
+    };
+    patch: Record<string, unknown>;
 };
 export declare function validateStylesApplyInput(input: unknown): asserts input is StylesApplyInputShape;
 export declare function validateStylesApplyOptions(options: unknown): void;
@@ -36,12 +43,6 @@ export type PatchKeyClassification = {
  * cross-channel lookups.
  */
 export declare function classifyPatchKey(key: string, channel: StylesChannel, scope?: StylesScope): PatchKeyClassification;
-/**
- * Validates the keys and values of a patch object against one channel.
- *
- * Shared by `styles.apply` (scope `docDefaults`) and `styles.create` (scope
- * `style`); `field` names the caller's own input path so the error points at
- * `patch` or at `run` / `paragraph` rather than at whichever one happened to
- * write this code.
- */
-export declare function validatePatchObject(patch: Record<string, unknown>, channel: StylesChannel, scope: StylesScope, field: string): void;
+export declare function validatePatchObject(patch: Record<string, unknown>, channel: StylesChannel, scope: StylesScope, field: string, options?: {
+    allowNull?: boolean;
+}): void;

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:
@@ -173,27 +175,34 @@ export type DomainStep = {
 };
 export type MutationStep = TextRewriteStep | TextInsertStep | TextDeleteStep | StyleApplyStep | StructuralInsertStep | StructuralReplaceStep | AssertStep | DomainStep | ReviewMutationStep;
 export type { ChangeMode } from '../write/write.js';
+type MutationPlanAttribution = {
+    changeMode: 'direct';
+    author?: never;
+} | {
+    changeMode: 'tracked';
+    author?: {
+        name: string;
+    };
+};
 export type MutationsApplyInput = {
     /** Target story for the mutation plan. Omit for body (backward compatible). */
     in?: StoryLocator;
     expectedRevision?: string;
     atomic: true;
-    changeMode: ChangeMode;
     steps: MutationStep[];
-};
+} & MutationPlanAttribution;
 export type MutationsPreviewInput = {
     /** Target story for the mutation preview. Omit for body (backward compatible). */
     in?: StoryLocator;
     expectedRevision?: string;
     atomic: true;
-    changeMode: ChangeMode;
     steps: MutationStep[];
     /** Optional page over verbose resolved-target details. Defaults to the first 100 targets. */
     detail?: {
         offset?: number;
         limit?: number;
     };
-};
+} & MutationPlanAttribution;
 /** Maximum number of steps per mutation plan. */
 export declare const MAX_PLAN_STEPS = 200;
 /**

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

@@ -1,5 +1,5 @@
 import { DocumentApiSurface } from '../index.js';
-import { ReceiptFailureResult, ReceiptSuccess } from './receipt.js';
+import { ReceiptEntity, ReceiptFailureResult, ReceiptSuccess } from './receipt.js';
 import { PlainTextInsertInput } from '../insert/insert.js';
 import { ParagraphTextReplaceInput, ReplaceMutationOptions, TextReplaceInput } from '../replace/replace.js';
 import { MutationOptions, TrackedTextMutationOptions } from '../write/write.js';
@@ -74,11 +74,15 @@ export interface TemporaryMutationMetadata {
     tag: string;
     onNativeEdit?: 'cancel' | 'preserve';
 }
+export type TemporaryOperationEffects = Partial<Record<string, {
+    inserted: ReceiptEntity[];
+}>>;
 export type TemporaryMutationReceipt = (ReceiptSuccess & {
     temporary: TemporaryMutationMetadata;
     revision: {
         before: string;
         after: string;
     };
+    operationEffects?: TemporaryOperationEffects;
 }) | ReceiptFailureResult;
 export {};

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

@@ -579,7 +579,15 @@ export interface TrackChangeInfo {
     author?: string;
     authorEmail?: string;
     authorImage?: string;
-    /** Author initials (spec §3 required field, when provided by the source). */
+    /**
+     * Author initials (spec §3 required field, when known). Read from the revision
+     * wrapper: SuperDoc writes them as `initials` in the `urn:superdoc:tracked-change:1`
+     * namespace (behind `mc:Ignorable`, like `authorEmail`), so they survive save, reopen
+     * and collaboration; a `w:initials` attribute from an older source file is also read.
+     * When the wrapper carries neither, the initials of a comment by the same author
+     * name in the document are used. SuperDoc never writes `w:initials` on revision
+     * wrappers; source wrappers it keeps verbatim are left as they are.
+     */
     initials?: string;
     date?: string;
     /**
@@ -714,7 +722,7 @@ export interface TrackChangeDomain {
     author?: string;
     authorEmail?: string;
     authorImage?: string;
-    /** Author initials. */
+    /** Author initials, resolved as on {@link TrackChangeInfo.initials}. */
     initials?: string;
     date?: string;
     excerpt?: string;

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

@@ -312,6 +312,7 @@ export type RunMarks = {
     bold?: boolean;
     /** Italic text styling. */
     italic?: boolean;
+    smallCaps?: boolean;
     /** Additional letter spacing in pixels (positive for expanded, negative for condensed). */
     letterSpacing?: number;
     /** Horizontal glyph scale as a unitless multiplier (`1` = 100%, `0.9` = 90%). */
@@ -1960,6 +1961,7 @@ export type WordLayoutMarker = {
  * ```
  */
 export type WordLayoutConfig = {
+    textStartMode?: 'paragraph';
     /**
      * Whether this list uses first-line indent mode (true for input-rule-created lists).
      * When true, text positioning uses textStartPx instead of standard hanging indent calculations.
@@ -2969,7 +2971,7 @@ 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, isBodyNoteReferenceRun, isZeroWidthMarkerRun, hasZeroWidthMarkerSpan, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
+export { PAGE_BREAK_DELETION_ANCHOR_ATTR, DELETED_PAGE_BREAK_LABEL, isPageBreakDeletionAnchorRun, expandRunsForInlineNewlines, isBodyNoteReferenceRun, isZeroWidthMarkerRun, hasZeroWidthMarkerSpan, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
 export { INLINE_OBJECT_REPLACEMENT_CHARACTER, flattenParagraphVisibleText, mapVisibleRangeToRunSlices, type ParagraphVisibleRunSlice, } from './paragraph-visible-text.js';
 export { inlineBoxStyleSignature, isFiniteNonNegativeInteger, normalizeInlineBoxLogicalSides, type InlineBoxLogicalSides, type ResolvedInlineBoxLogicalSides, } from './inline-box.js';
 export { INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES, PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, isValidIncrementalDependencyOwnerVersion, isValidNonFlowingPageRelativeAnchorDependencyProof, isValidPageCheckpointDependencyCertificate, type IncrementalDependencyCertificateClass, type IncrementalDependencyOwnerVersion, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyCertificate, type PageCheckpointDependencyClass, } from './incremental-dependency.js';

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

@@ -470,6 +470,7 @@ export type ResolvedHeaderFooterLayout = {
 };
 /** Resolved list marker rendering data with pre-computed positioning. */
 export type ResolvedListMarkerItem = {
+    textStartPx?: number;
     /** Marker text content (e.g., "1.", "a)", bullet). */
     text: string;
     /** Horizontal justification. */

package/dist/layout-engine/contracts/src/run-helpers.d.ts

@@ -1,4 +1,11 @@
 import { FlowBlock, Line, Run, TextRun } from './index.js';
+export declare const PAGE_BREAK_DELETION_ANCHOR_ATTR = "data-page-break-deletion-anchor";
+export declare const DELETED_PAGE_BREAK_LABEL = "Deleted page break";
+export declare function isPageBreakDeletionAnchorRun(run: Run): run is TextRun & {
+    dataAttrs: {
+        [PAGE_BREAK_DELETION_ANCHOR_ATTR]: 'true';
+    };
+};
 export declare const NOTE_REFERENCE_MARKER_ATTR = "data-v2-note-ref";
 export declare const NOTE_LABEL_MARKER_ATTR = "data-v2-note-label";
 /** Body note markers paint text but occupy one source-coordinate unit. */

package/dist/layout-engine/painters/dom/src/page-content.d.ts

@@ -5,6 +5,7 @@ import { BetweenBorderInfo } from './paragraph/borders/index.js';
 import { PageStyles } from './styles.js';
 import { TableFragmentPatchResult } from './table/renderTableFragment.js';
 import { DerivedRunTextPlane } from './derived-run-text-plane.js';
+export declare function refreshPageBreakReviewPlacements(state: PageDomState, page: ResolvedPage, recordChangedRoot?: (root: HTMLElement) => void): void;
 export type FragmentDomState = {
     key: string;
     signature: string;

package/dist/layout-engine/painters/dom/src/review-markers.d.ts

@@ -0,0 +1,3 @@
+export declare const PAGE_BREAK_REVIEW_SELECTOR = "[data-page-break-deletion-anchor=\"true\"]";
+export declare function isVisiblePageBreakReviewMarker(marker: HTMLElement): boolean;
+export declare function copyReviewMarkerSourceAttrs(marker: HTMLElement, source: Element): void;

package/dist/layout-engine/painters/dom/src/table/renderTableCell.d.ts

@@ -111,6 +111,7 @@ type TableCellRenderDependencies = {
 export type TableCellRenderResult = {
     /** The cell container element (with borders, background, sizing, and content as child) */
     cellElement: HTMLElement;
+    reviewMarkers?: HTMLElement[];
 };
 /**
  * Renders a table cell as a DOM element.

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DpVh2nQH.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-B4c55pFy.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 let use_sync_external_store_shim = require("use-sync-external-store/shim");

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-cHUUipYM.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C4Ka5Ph3.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DpVh2nQH.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-B4c55pFy.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-cHUUipYM.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C4Ka5Ph3.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

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-DpVh2nQH.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-B4c55pFy.cjs");
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/public/ui.es.js

@@ -1,4 +1,4 @@
-import { f as shallowEqual, o as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-cHUUipYM.es.js";
+import { p as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C4Ka5Ph3.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/shared/common/list-marker-utils.d.ts

@@ -96,6 +96,9 @@ export type MinimalMarker = {
  * Contains the subset of word layout properties needed to determine text positioning.
  */
 export type MinimalWordLayout = {
+    textStartMode?: 'paragraph';
+    firstLinePx?: number;
+    hangingPx?: number;
     /** Whether this list uses first-line indent mode (input-rule created lists) */
     firstLineIndentMode?: boolean;
     /** Pre-calculated horizontal position where text should start */