superdoc 2.29.0 → 2.30.0-next.13

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

@@ -40,8 +40,10 @@ import { OperationId } from './contract/types.js';
 import { DynamicInvokeRequest, InvokeRequest, InvokeResult } from './contract/operation-registry.js';
 import { PlanApi, PlanExecuteResult, AtomicPlanExecutor } from './plan/plan.js';
 import { HistoryAdapter, HistoryApi } from './history/history.js';
+import { ChangesAdapter, ChangesApi } from './changes/changes.js';
 import { DiffAdapter, DiffApi } from './diff/diff.js';
 import { ExportAdapter, ExportApi } from './export/export.js';
+import { TablesListPresetsInput, TablesListPresetsOutput } from './tables/table-style-presets.js';
 import { ParagraphsAdapter, ParagraphFormatApi, ParagraphStylesApi } from './paragraphs/paragraphs.js';
 import { SectionsAdapter, SectionsApi } from './sections/sections.js';
 import { HeaderFootersAdapter, HeaderFootersApi } from './header-footers/header-footers.js';
@@ -72,6 +74,9 @@ export * from './capabilities/html-markdown-support.js';
 export * from './inline-semantics/index.js';
 export type { HistoryAdapter, HistoryApi } from './history/history.js';
 export { executeHistoryGet, executeHistoryUndo, executeHistoryRedo } from './history/history.js';
+export type { ChangesAdapter, ChangesApi } from './changes/changes.js';
+export { CHANGES_LIST_LIMIT_MAX, CHANGES_WAIT_MS_MAX, executeChangesActors, executeChangesGet, executeChangesList, executeChangesResolve, executeChangesSnapshot, } from './changes/changes.js';
+export type * from './changes/changes.types.js';
 export type { DiffAdapter, DiffApi } from './diff/diff.js';
 export * from './diff/diff.types.js';
 export type { ExportAdapter, ExportApi } from './export/export.js';
@@ -101,6 +106,7 @@ export type { HistoryState, HistoryActionResult, HistoryNoopReason, SDHistorySta
 export { executeTrackChangesGet, executeTrackChangesList, executeTrackChangesDecide, } from './track-changes/track-changes.js';
 export { createPlanApi, type PlanApi, type PlanExecuteInput, type PlanExecuteEntry, type PlanExecuteEntryExpect, type PlanExecuteResult, type PlanEntryReceipt, type PlanEntryReceiptStatus, type PlanExecuteFailure, type PlanCaptureRefMarker, type PlanProjectTextOffsetMarker, } from './plan/plan.js';
 export type { DiffSnapshot, DiffPayload, DiffPartChange, DiffApplyResult, DiffCompareInput, DiffApplyInput, DiffApplyOptions, DiffApplyOperationReceipt, DiffApplyReviewItem, DiffApplyEligibility, DiffApplyModeEligibility, DiffApplyEligibilityBlocker, DiffApplyEligibilityBlockerCode, } from './diff/diff.types.js';
+export * from './tables/table-style-presets.js';
 export type { GetAdapter } from './get/get.js';
 export type { FindAdapter, FindOptions } from './find/find.js';
 export type { GetNodeAdapter, GetNodeByIdInput } from './get-node/get-node.js';
@@ -166,6 +172,8 @@ export type * from './citations/citations.types.js';
 export type * from './authorities/authorities.types.js';
 export type { ListsAdapter } from './lists/lists.js';
 export type { SectionsAdapter } from './sections/sections.js';
+export { validateParagraphsApplyBatchInput, PARAGRAPH_BATCH_OPERATION_IDS, PARAGRAPH_BATCH_MAX_TARGETS, PARAGRAPH_BATCH_MAX_OPERATIONS, PARAGRAPH_BATCH_MAX_EXPANDED_WRITES, PARAGRAPH_BATCH_MAX_PAYLOAD_BYTES, } from './paragraphs/paragraphs.js';
+export type { ParagraphsApplyBatchInput, ParagraphBatchOperation, ParagraphBatchMutationResult, } from './paragraphs/paragraphs.js';
 export type { ParagraphsAdapter, ParagraphFormatApi, ParagraphStylesApi } from './paragraphs/paragraphs.js';
 export type { ParagraphTarget, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs/paragraphs.js';
 export { PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs/paragraphs.js';
@@ -234,6 +242,7 @@ export interface TablesApi {
     setBorders(input: TablesSetBordersInput, options?: MutationOptions): TableMutationResult;
     setTableOptions(input: TablesSetTableOptionsInput, options?: MutationOptions): TableMutationResult;
     applyPreset(input: TablesApplyPresetInput, options?: MutationOptions): TableMutationResult;
+    listPresets(input?: TablesListPresetsInput): TablesListPresetsOutput;
     get(input: TablesGetInput): TablesGetOutput;
     getCells(input: TablesGetCellsInput): TablesGetCellsOutput;
     getProperties(input: TablesGetPropertiesInput): TablesGetPropertiesOutput;
@@ -241,7 +250,7 @@ export interface TablesApi {
     setDefaultStyle(input: TablesSetDefaultStyleInput, options?: MutationOptions): DocumentMutationResult;
     clearDefaultStyle(input?: TablesClearDefaultStyleInput, options?: MutationOptions): DocumentMutationResult;
 }
-export type TablesAdapter = Omit<TablesApi, 'moveRow' | 'moveColumn'> & {
+export type TablesAdapter = Omit<TablesApi, 'moveRow' | 'moveColumn' | 'listPresets'> & {
     moveRow?: TablesApi['moveRow'];
     moveColumn?: TablesApi['moveColumn'];
 };
@@ -517,6 +526,7 @@ export interface DocumentApiSurface {
      * Session-scoped: reflects the runtime undo/redo stack, not persistent state.
      */
     history: HistoryApi;
+    changes: ChangesApi;
     /**
      * Document-level protection state and editing restriction operations.
      */
@@ -618,6 +628,7 @@ export interface DocumentApiAdapters {
     /** Modeful DOCX export. Optional; gated when the engine does not provide it. */
     export?: ExportAdapter;
     history: HistoryAdapter;
+    changes?: ChangesAdapter;
     protection: ProtectionAdapter;
     permissionRanges: PermissionRangesAdapter;
     /** Custom XML Data Storage Part operations. Optional; not all engines support custom XML. */
@@ -629,3 +640,4 @@ export interface DocumentApiAdapters {
     metadata?: AnchoredMetadataAdapter;
 }
 export declare function createDocumentApi(adapters: DocumentApiAdapters): DocumentApi;
+export { normalizeCommentIdentity } from './comments/comment-create-attribution.js';

package/dist/document-api/src/inline-semantics/token-sets.d.ts

@@ -41,5 +41,3 @@ export declare const ST_THEME_COLOR_VALUE_SET: ReadonlySet<string>;
  * list, and a second name for one union is a second thing to keep in step.
  */
 export declare const ST_HIGHLIGHT_VALUES: readonly ["black", "blue", "cyan", "green", "magenta", "red", "yellow", "white", "darkBlue", "darkCyan", "darkGreen", "darkMagenta", "darkRed", "darkYellow", "darkGray", "lightGray", "none"];
-/** Runtime set for O(1) ST_HighlightColor validation. */
-export declare const ST_HIGHLIGHT_VALUE_SET: ReadonlySet<string>;

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

@@ -55,7 +55,6 @@ export type InsertInput = TextInsertInput | RichContentInsertInput | SDInsertInp
 export type PlainTextInsertInput = TextInsertInput & {
     type?: 'text';
 };
-export declare function isRichContentInsertInput(input: InsertInput): input is RichContentInsertInput;
 /** Returns true when the input uses the structural SDFragment shape. */
 export declare function isStructuralInsertInput(input: InsertInput): input is SDInsertInput;
 /**

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

@@ -1,8 +1,9 @@
 import { MutationOptions } from '../write/write.js';
-import { ParagraphMutationResult, ParagraphsSetStyleInput, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput } from './paragraphs.types.js';
-export type { ParagraphTarget, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs.types.js';
-export { PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs.types.js';
+import { ParagraphsApplyBatchInput, ParagraphBatchMutationResult, ParagraphMutationResult, ParagraphsSetStyleInput, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput } from './paragraphs.types.js';
+export type { ParagraphTarget, ParagraphsApplyBatchInput, ParagraphBatchOperation, ParagraphBatchMutationResult, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs.types.js';
+export { PARAGRAPH_BATCH_MAX_TARGETS, PARAGRAPH_BATCH_MAX_OPERATIONS, PARAGRAPH_BATCH_MAX_EXPANDED_WRITES, PARAGRAPH_BATCH_MAX_PAYLOAD_BYTES, PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs.types.js';
 export interface ParagraphsAdapter {
+    applyBatch?(input: ParagraphsApplyBatchInput, options?: MutationOptions): Promise<ParagraphBatchMutationResult>;
     setStyle(input: ParagraphsSetStyleInput, options?: MutationOptions): ParagraphMutationResult;
     setStyleRef(input: ParagraphsSetStyleRefInput, options?: MutationOptions): ParagraphMutationResult;
     clearStyle(input: ParagraphsClearStyleInput, options?: MutationOptions): ParagraphMutationResult;
@@ -30,6 +31,7 @@ export interface ParagraphsAdapter {
 }
 /** Public API surface for `format.paragraph.*`: direct paragraph formatting. */
 export interface ParagraphFormatApi {
+    applyBatch(input: ParagraphsApplyBatchInput, options?: MutationOptions): Promise<ParagraphBatchMutationResult>;
     resetDirectFormatting(input: ParagraphsResetDirectFormattingInput, options?: MutationOptions): ParagraphMutationResult;
     setAlignment(input: ParagraphsSetAlignmentInput, options?: MutationOptions): ParagraphMutationResult;
     clearAlignment(input: ParagraphsClearAlignmentInput, options?: MutationOptions): ParagraphMutationResult;
@@ -82,3 +84,6 @@ export declare function executeParagraphsSetMarkRunProps(adapter: ParagraphsAdap
 export declare function executeParagraphsSetDirection(adapter: ParagraphsAdapter, input: ParagraphsSetDirectionInput, options?: MutationOptions): ParagraphMutationResult;
 export declare function executeParagraphsClearDirection(adapter: ParagraphsAdapter, input: ParagraphsClearDirectionInput, options?: MutationOptions): ParagraphMutationResult;
 export declare function executeParagraphsSetNumbering(adapter: ParagraphsAdapter, input: ParagraphsSetNumberingInput, options?: MutationOptions): ParagraphMutationResult;
+export declare const PARAGRAPH_BATCH_OPERATION_IDS: ("format.paragraph.setMarkRunProps" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "format.paragraph.setAlignment" | "format.paragraph.clearAlignment" | "format.paragraph.setIndentation" | "format.paragraph.clearIndentation" | "format.paragraph.setSpacing" | "format.paragraph.clearSpacing" | "format.paragraph.setKeepOptions" | "format.paragraph.setOutlineLevel" | "format.paragraph.setFlowOptions" | "format.paragraph.setTabStop" | "format.paragraph.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection")[];
+export declare function validateParagraphsApplyBatchInput(input: unknown): asserts input is ParagraphsApplyBatchInput;
+export declare function executeParagraphsApplyBatch(adapter: ParagraphsAdapter, input: ParagraphsApplyBatchInput, options?: MutationOptions): Promise<ParagraphBatchMutationResult>;

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

@@ -113,9 +113,9 @@ export interface ParagraphsClearSpacingInput {
 /** paragraphs.setKeepOptions */
 export interface ParagraphsSetKeepOptionsInput {
     target: ParagraphTarget;
-    keepNext?: boolean;
-    keepLines?: boolean;
-    widowControl?: boolean;
+    keepNext?: boolean | null;
+    keepLines?: boolean | null;
+    widowControl?: boolean | null;
 }
 /** paragraphs.setOutlineLevel */
 export interface ParagraphsSetOutlineLevelInput {
@@ -125,8 +125,8 @@ export interface ParagraphsSetOutlineLevelInput {
 /** paragraphs.setFlowOptions */
 export interface ParagraphsSetFlowOptionsInput {
     target: ParagraphTarget;
-    contextualSpacing?: boolean;
-    pageBreakBefore?: boolean;
+    contextualSpacing?: boolean | null;
+    pageBreakBefore?: boolean | null;
     suppressAutoHyphens?: boolean;
     /** `w:autoSpaceDE` — auto-space between East-Asian and Latin text. */
     autoSpaceDE?: boolean;
@@ -223,3 +223,47 @@ export interface ParagraphsSetNumberingInput {
     /** Numbering level (`w:ilvl`), 0-8. Defaults to 0 when omitted. */
     level?: number;
 }
+export interface ParagraphBatchInputs {
+    'styles.paragraph.setStyleRef': ParagraphsSetStyleRefInput;
+    'styles.paragraph.clearStyle': ParagraphsClearStyleInput;
+    'format.paragraph.setAlignment': ParagraphsSetAlignmentInput;
+    'format.paragraph.clearAlignment': ParagraphsClearAlignmentInput;
+    'format.paragraph.setSpacing': ParagraphsSetSpacingInput;
+    'format.paragraph.clearSpacing': ParagraphsClearSpacingInput;
+    'format.paragraph.setIndentation': ParagraphsSetIndentationInput;
+    'format.paragraph.clearIndentation': ParagraphsClearIndentationInput;
+    'format.paragraph.setKeepOptions': ParagraphsSetKeepOptionsInput;
+    'format.paragraph.setFlowOptions': ParagraphsSetFlowOptionsInput;
+    'format.paragraph.setOutlineLevel': ParagraphsSetOutlineLevelInput;
+    'format.paragraph.setBorder': ParagraphsSetBorderInput;
+    'format.paragraph.clearBorder': ParagraphsClearBorderInput;
+    'format.paragraph.setShading': ParagraphsSetShadingInput;
+    'format.paragraph.clearShading': ParagraphsClearShadingInput;
+    'format.paragraph.setTabStop': ParagraphsSetTabStopInput;
+    'format.paragraph.clearAllTabStops': ParagraphsClearAllTabStopsInput;
+    'format.paragraph.setDirection': ParagraphsSetDirectionInput;
+    'format.paragraph.clearDirection': ParagraphsClearDirectionInput;
+    'format.paragraph.setMarkRunProps': ParagraphsSetMarkRunPropsInput;
+}
+export type ParagraphBatchOperation = {
+    [Id in keyof ParagraphBatchInputs]: {
+        operationId: Id;
+        input: keyof Omit<ParagraphBatchInputs[Id], 'target'> extends never ? Record<string, never> : Omit<ParagraphBatchInputs[Id], 'target'>;
+    };
+}[keyof ParagraphBatchInputs];
+export interface ParagraphsApplyBatchInput {
+    targets: ParagraphTarget[];
+    operations: ParagraphBatchOperation[];
+}
+export type ParagraphBatchMutationResult = {
+    success: true;
+    resolution: {
+        targets: ParagraphTarget[];
+    };
+    appliedChangeMode?: ChangeMode;
+    trackedChangeRefs?: ReceiptInsert[];
+} | ParagraphMutationFailure;
+export declare const PARAGRAPH_BATCH_MAX_TARGETS = 1000;
+export declare const PARAGRAPH_BATCH_MAX_OPERATIONS = 1000;
+export declare const PARAGRAPH_BATCH_MAX_EXPANDED_WRITES = 32000;
+export declare const PARAGRAPH_BATCH_MAX_PAYLOAD_BYTES = 1048576;

package/dist/document-api/src/tables/data/table-preset-appearance.generated.d.ts

@@ -0,0 +1,2 @@
+import { TablePresetAppearance } from '../table-style-presets.js';
+export declare const WORD_TABLE_PRESET_APPEARANCE: Readonly<Record<string, TablePresetAppearance>>;

package/dist/document-api/src/tables/table-style-presets.d.ts

@@ -0,0 +1,73 @@
+export type TablePresetSource = 'word' | 'superdoc';
+export type TablePresetGroup = 'plain' | 'grid' | 'list' | 'convenience';
+export type TablePresetAccent = 1 | 2 | 3 | 4 | 5 | 6;
+export type SuperDocTablePresetId = 'grid' | 'minimal' | 'striped' | 'accent';
+type WordFamilySlug = 'grid-table' | 'list-table';
+type WordDesignedPresetId = `word.${WordFamilySlug}-${'1-light' | '2' | '3' | '4' | '5-dark' | '6-colorful' | '7-colorful'}` | `word.${WordFamilySlug}-${'1-light' | '2' | '3' | '4' | '5-dark' | '6-colorful' | '7-colorful'}-accent-${TablePresetAccent}`;
+export type WordPlainTablePresetId = 'word.table-grid' | 'word.grid-table-light' | `word.plain-table-${1 | 2 | 3 | 4 | 5}`;
+export type WordTablePresetId = WordPlainTablePresetId | WordDesignedPresetId;
+export type TablePresetId = SuperDocTablePresetId | WordTablePresetId;
+export interface TablePresetColor {
+    themeColor?: string;
+    rgb?: string;
+    tint?: string;
+    shade?: string;
+}
+export interface TablePresetAppearance {
+    baseFill?: TablePresetColor;
+    header: {
+        treatment: Array<'shading' | 'bold' | 'borders'>;
+        fill?: TablePresetColor;
+        textColor?: TablePresetColor;
+    };
+    bandedRows: {
+        effect: 'none' | 'shading' | 'borders' | 'shadingAndBorders';
+        fill?: TablePresetColor;
+        borderColor?: TablePresetColor;
+    };
+    borders: {
+        layout: 'none' | 'horizontal' | 'outer' | 'outerAndHorizontal' | 'grid';
+        color?: TablePresetColor;
+    };
+}
+export interface TablePresetInfo {
+    id: TablePresetId;
+    name: string;
+    source: TablePresetSource;
+    group: TablePresetGroup;
+    accent: TablePresetAccent | null;
+    appearance: TablePresetAppearance | null;
+}
+export interface WordTablePresetDefinition extends TablePresetInfo {
+    id: WordTablePresetId;
+    source: 'word';
+    wordStyleName: string;
+    wordStyleId: string;
+}
+export declare const SUPERDOC_TABLE_PRESET_IDS: readonly ["grid", "minimal", "striped", "accent"];
+export declare const WORD_ACCENT_DISPLAY_SEPARATOR = " - ";
+export declare const WORD_TABLE_PRESETS: readonly WordTablePresetDefinition[];
+export declare const SUPERDOC_TABLE_PRESETS: readonly TablePresetInfo[];
+export declare const TABLE_PRESET_CATALOGUE: readonly TablePresetInfo[];
+export declare const TABLE_PRESET_IDS: readonly TablePresetId[];
+export declare function isWordTablePresetId(value: unknown): value is WordTablePresetId;
+export declare function isSuperDocTablePresetId(value: unknown): value is SuperDocTablePresetId;
+export declare function isTablePresetId(value: unknown): value is TablePresetId;
+export declare function getWordTablePreset(id: string): WordTablePresetDefinition | null;
+export declare const TABLE_PRESET_LIST_DEFAULT_LIMIT = 25;
+export declare const TABLE_PRESET_LIST_MAX_LIMIT = 25;
+export interface TablesListPresetsInput {
+    source?: TablePresetSource;
+    group?: TablePresetGroup;
+    query?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface TablesListPresetsOutput {
+    items: TablePresetInfo[];
+    total: number;
+    offset: number;
+    nextOffset: number | null;
+}
+export declare function listTablePresets(input?: TablesListPresetsInput): TablesListPresetsOutput;
+export {};

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

@@ -1,5 +1,6 @@
 import { MutationOptions } from '../write/write.js';
-import { TablesApplyStyleInput, TablesSetBordersInput, TablesSetCellPaddingInput, TablesSetLayoutInput, TablesSetTableOptionsInput, TablesSortInput } from '../types/table-operations.types.js';
+import { TablesListPresetsInput, TablesListPresetsOutput } from './table-style-presets.js';
+import { TablesApplyPresetInput, TablesApplyStyleInput, TablesSetBordersInput, TablesSetCellPaddingInput, TablesSetLayoutInput, TablesSetTableOptionsInput, TablesSortInput } from '../types/table-operations.types.js';
 type RowLocatorInput = {
     target?: unknown;
     nodeId?: unknown;
@@ -81,4 +82,6 @@ export declare function executeTablesSetTableOptions<TResult>(operationName: str
  * any-of side requirement (and the adapter never authors an empty `w:tcMar`).
  */
 export declare function executeTablesSetCellPadding<TResult>(operationName: string, adapter: (input: TablesSetCellPaddingInput, options?: MutationOptions) => TResult, input: TablesSetCellPaddingInput, options?: MutationOptions): TResult;
+export declare function executeTablesListPresets(input: TablesListPresetsInput | undefined): TablesListPresetsOutput;
+export declare function executeTablesApplyPreset<TResult>(adapter: (input: TablesApplyPresetInput, options?: MutationOptions) => TResult, input: TablesApplyPresetInput, options?: MutationOptions): TResult;
 export {};

package/dist/document-api/src/types/sd-props.d.ts

@@ -125,6 +125,12 @@ export interface SDParagraphProps {
         firstLine?: number;
         /** Hanging indent in points. */
         hanging?: number;
+        leftChars?: number;
+        rightChars?: number;
+        startChars?: number;
+        endChars?: number;
+        firstLineChars?: number;
+        hangingChars?: number;
     };
     spacing?: {
         /** Space before in points. */
@@ -139,6 +145,7 @@ export interface SDParagraphProps {
         line?: number;
         lineRule?: 'auto' | 'multiple' | 'exact' | 'atLeast';
     };
+    contextualSpacing?: boolean;
     keepWithNext?: boolean;
     keepLines?: boolean;
     pageBreakBefore?: boolean;

package/dist/document-api/src/types/table-operations.types.d.ts

@@ -1,3 +1,4 @@
+import { TablePresetId } from '../tables/table-style-presets.js';
 import { BlockNodeAddress, TableAddress, TableCellAddress, TableOrCellAddress, TableOrRowAddress, TableRowAddress } from './base.js';
 import { ReceiptFailure, ReceiptInsert } from './receipt.js';
 /**
@@ -483,24 +484,11 @@ export interface TablesSetTableOptionsInput extends TableLocator {
     /** Non-negative number, or `null` to clear. */
     cellSpacingPt?: number | null;
 }
-/**
- * Named visual presets for tables. Each preset composes borders, shading,
- * and conditional-format flags into a polished look.
- *
- * - `grid` — 0.5pt black borders all around, no shading.
- * - `minimal` — no outer borders, hairline grey separators between rows.
- * - `striped` — banded rows on, 0.5pt grey borders all around.
- * - `accent` — header row filled with `accentColor` (default `1F3864`),
- *   thick accent bottom under the header.
- */
-export type TablePresetName = 'grid' | 'minimal' | 'striped' | 'accent';
+export type TablePresetName = TablePresetId;
 export interface TablesApplyPresetInput extends TableLocator {
     preset: TablePresetName;
-    /**
-     * Optional accent color (hex; same format as `setShading.color`).
-     * Used by presets that need an accent (`accent`). Ignored otherwise.
-     */
     accentColor?: string;
+    styleOptions?: TableStyleOptionsPatch;
 }
 export type BorderEdge = 'top' | 'bottom' | 'left' | 'right' | 'insideH' | 'insideV' | 'diagonalDown' | 'diagonalUp';
 export interface TablesSetBorderInput {
@@ -620,6 +608,15 @@ export type TablesGetPropertiesInput = TableLocator;
 export interface TablesGetPropertiesOutput {
     nodeId: string;
     address: TableAddress;
+    rows?: Array<{
+        rowIndex: number;
+        heightPt?: number;
+        heightRule?: 'atLeast' | 'exact' | 'auto';
+    }>;
+    columns?: Array<{
+        columnIndex: number;
+        widthPt?: number;
+    }>;
     styleId?: string;
     alignment?: TableAlignment;
     direction?: TableDirection;

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

@@ -10,6 +10,7 @@ export type { BaseDirection, WritingMode, SectionDirectionContext, TableDirectio
 export { getParagraphInlineDirection, getTableVisualDirection } from './direction-context.js';
 export { OOXML_PCT_DIVISOR, resolveTableWidthAttr, type TableWidthAttr, type TableColumnSpec, } from './engines/tables.js';
 export { effectiveTableCellSpacing } from './table-cell-spacing.js';
+export { isTableCellVectorOverlay } from './table-cell-vector-overlay.js';
 export { createHeaderFooterResolutionIndex, selectHeaderFooterVariantForPage, resolveEffectiveHeaderFooterRef, type HeaderFooterResolutionIndex, type HeaderFooterKind, type HeaderFooterVariant, type HeaderFooterSectionRefs, type HeaderFooterResolutionSection, type HeaderFooterVariantSelectionInput, type HeaderFooterEffectiveRefInput, type HeaderFooterEffectiveRefResult, } from './header-footer-resolution.js';
 export { rescaleColumnWidths } from './table-column-rescale.js';
 export { getCellSpacingPx } from './cell-spacing.js';
@@ -371,7 +372,7 @@ export type CrossReferenceMetadata = {
     preferFollowing?: boolean;
 };
 export type TextRun = RunMarks & {
-    kind?: 'text';
+    kind: 'text';
     text: string;
     fontFamily: string;
     fontSize: number;
@@ -2923,7 +2924,9 @@ export type LayoutBlockResumeCheckpoint = {
         refId: string;
         fullHeight: number;
         firstLineHeight: number;
+        rowIndex?: number;
     }[];
+    footnoteRequiredStartRefId?: string;
 };
 /** Final layout output ready for painting. */
 export type Layout = {

package/dist/layout-engine/contracts/src/table-cell-vector-overlay.d.ts

@@ -0,0 +1,2 @@
+import { FlowBlock } from './index.js';
+export declare function isTableCellVectorOverlay(block: FlowBlock): boolean;

package/dist/layout-engine/dom-contract/src/data-attrs.d.ts

@@ -28,6 +28,8 @@ export declare const DATA_ATTRS: {
     readonly LAYOUT_EPOCH: "data-layout-epoch";
     /** JSON-encoded table boundary metadata for resize overlays. */
     readonly TABLE_BOUNDARIES: "data-table-boundaries";
+    readonly TABLE_ID: "data-table-id";
+    readonly ROW_INDEX: "data-row-index";
     /** SDT unique identifier. */
     readonly SDT_ID: "data-sdt-id";
     /** SDT type (fieldAnnotation, structuredContent, documentSection, etc.). */
@@ -65,6 +67,8 @@ export declare const DATASET_KEYS: {
     readonly PM_END: "pmEnd";
     readonly LAYOUT_EPOCH: "layoutEpoch";
     readonly TABLE_BOUNDARIES: "tableBoundaries";
+    readonly TABLE_ID: "tableId";
+    readonly ROW_INDEX: "rowIndex";
     readonly SDT_ID: "sdtId";
     readonly SDT_TYPE: "sdtType";
     readonly FIELD_ID: "fieldId";

package/dist/layout-engine/layout-bridge/src/coupled-footnote-pagination.d.ts

@@ -21,6 +21,7 @@ export type CoupledFootnotePageCompletion = {
     anchors: readonly {
         refId: string;
     }[];
+    requiredStartRefId?: string;
 };
 export type CoupledFootnotePageFlow = {
     incomingDemand(pageIndex: number): {

package/dist/layout-engine/layout-bridge/src/footnote-page-certificate.d.ts

@@ -5,6 +5,7 @@ export type FootnoteCertificatePreparedOptions = Readonly<Omit<CoupledFootnotePa
 type PendingEntry = Readonly<{
     id: string;
     ranges: readonly Readonly<FootnoteRange>[];
+    started?: boolean;
 }>;
 export type FootnotePendingQueue = ReadonlyMap<number, readonly PendingEntry[]>;
 declare const ownerBrand: unique symbol;

package/dist/layout-engine/layout-bridge/src/footnote-page-planner.d.ts

@@ -3,10 +3,12 @@ import { FootnoteRange, FootnoteSlice } from './footnote-content.js';
 export type PendingFootnote = {
     id: string;
     ranges: FootnoteRange[];
+    started?: boolean;
 };
 type IncomingFootnote = {
     readonly id: string;
     readonly ranges: readonly FootnoteRange[];
+    readonly started?: boolean;
 };
 export type FootnotePageLedgerDraft = Omit<FootnotePageLedger, 'pageIndex' | 'appliedBodyReservePx' | 'deadReservePx'>;
 export type FootnotePagePlanInput = {
@@ -20,6 +22,9 @@ export type FootnotePagePlanInput = {
     fullHeightById: ReadonlyMap<string, number>;
     firstLineHeightById: ReadonlyMap<string, number>;
     pendingByColumn: ReadonlyMap<number, readonly IncomingFootnote[]>;
+    requiredStartId?: string;
+    deferStartIds?: ReadonlySet<string>;
+    noteOnlyPage?: boolean;
     separatorSpacingBefore: number;
     dividerHeight: number;
     continuationDividerHeight: number;

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

@@ -210,6 +210,7 @@ export type IncrementalLayoutBridgeTiming = {
         headerFooterPreLayoutBodyBlocksEnumerated: number;
         headerFooterPreLayoutSectionsEnumerated: number;
         footnoteRelayouts: number;
+        footnoteIncomingDemandUnconverged: number;
         footnoteReserveRelayouts: number;
         footnoteGrowRelayouts: number;
         footnoteTightenRelayouts: number;

package/dist/layout-engine/layout-engine/src/footnote-page-flow.d.ts

@@ -1,6 +1,8 @@
 import { Page } from '../../contracts/src/index.js';
 import { PageState } from './paginator.js';
 import { FootnoteAnchorRef } from './layout-paragraph.js';
+export declare const maxFootnoteBand: (physicalContentHeight: number) => number;
+export declare const footnoteQueueDemand: (incomingHeight: number, committed: readonly FootnoteAnchorRef[], prior: readonly FootnoteAnchorRef[], currentLine: readonly FootnoteAnchorRef[]) => number;
 /** Internal body/notes handshake. The bridge owns exact continuation ranges. */
 export type FootnotePageFlow = {
     /** False for a bounded block horizon: its EOF is not the document's EOF. */
@@ -15,6 +17,7 @@ export type FootnotePageFlow = {
         bodyBottom: number;
         physicalBottom: number;
         anchors: readonly FootnoteAnchorRef[];
+        requiredStartRefId?: string;
     }): void;
     hasPendingContinuation(): boolean;
 };

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

@@ -3,6 +3,7 @@ import { FootnotePageFlow } from './footnote-page-flow.js';
 import { PageState, ConstraintBoundary } from './paginator.js';
 import { LayoutExecutionControl } from './execution.js';
 export type { FootnotePageFlow } from './footnote-page-flow.js';
+export { maxFootnoteBand } from './footnote-page-flow.js';
 export { findLineIndexForRunOrdinal, findKeepNextChainStart, isOutOfFlowDrawing } from './layout-utils.js';
 type PageSize = {
     w: number;
@@ -50,6 +51,11 @@ export type LayoutOptions = {
      * increasing the effective bottom margin for that page only.
      */
     footnoteReservedByPageIndex?: number[];
+    footnoteIncomingByPageIndex?: ReadonlyArray<{
+        height: number;
+        refs: number;
+    } | undefined>;
+    trailingNotePageCount?: number;
     /**
      * Footnote metadata. The core layout engine consumes only the fields below
      * (SD-3049: ref positions + per-footnote body heights for block-aware breaks).
@@ -226,6 +232,7 @@ export type LayoutOptions = {
             footnoteDemandThisPage: number;
             footnoteRefsThisPage: number;
             footnoteAnchorsThisPage: readonly PageState['footnoteAnchorsThisPage'][number][];
+            footnoteRequiredStartRefId?: string;
         };
     };
     /**

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

@@ -15,9 +15,14 @@ export type FootnoteAnchorRef = {
     refId: string;
     fullHeight: number;
     firstLineHeight: number;
+    rowIndex?: number;
 };
 export type ParagraphLayoutContext = {
     incomingFootnoteDemand?: FootnotePageFlow['incomingDemand'];
+    legacyIncomingFootnoteDemand?: (pageIndex: number) => {
+        height: number;
+        refs: number;
+    } | undefined;
     block: ParagraphBlock;
     measure: ParagraphMeasure;
     columnWidth: number;

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

@@ -11,6 +11,8 @@ export type TableLayoutContext = {
     columnX: (state: PageState, columnIndex?: number) => number;
     resumeCursor?: TableLayoutCursor;
     onFragmentStart?: (state: PageState, cursor: TableLayoutCursor) => void;
+    footnoteRowBottom?: (rowIndex: number, startRow: number, state: PageState) => number;
+    onFragmentPlaced?: (state: PageState, fragment: TableFragment) => void;
 };
 export type TableLayoutCursor = {
     currentRow: number;
@@ -93,7 +95,7 @@ export declare function generateFragmentMetadata(measure: TableMeasure, block: T
  * @param context - Table layout context
 
  */
-export declare function layoutTableBlockSteps({ block, measure, columnWidth, pagePositionedTableFitHeight, ensurePage, advanceColumn, columnX, resumeCursor, onFragmentStart, }: TableLayoutContext): Generator<TableLayoutStep, void, void>;
+export declare function layoutTableBlockSteps({ block, measure, columnWidth, pagePositionedTableFitHeight, ensurePage, advanceColumn, columnX, resumeCursor, onFragmentStart, footnoteRowBottom, onFragmentPlaced, }: TableLayoutContext): Generator<TableLayoutStep, void, void>;
 export declare function layoutTableBlock(context: TableLayoutContext): void;
 /**
  * Create a table fragment for an anchored/floating table at its computed position.

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

@@ -61,10 +61,6 @@ export declare const isEmptyTextParagraph: (block: ParagraphBlock) => boolean;
  */
 export declare const shouldSuppressSpacingForEmpty: (block: ParagraphBlock, side: "before" | "after") => boolean;
 export declare function normalizeLines(measure: ParagraphMeasure): ParagraphMeasure['lines'];
-export declare function sliceLines(lines: ParagraphMeasure['lines'], startIndex: number, availableHeight: number): {
-    toLine: number;
-    height: number;
-};
 export type { LinePmRange };
 /** A marker belongs to the first measured line containing its run. */
 export declare const findLineIndexForRunOrdinal: (lines: readonly Line[] | undefined, runOrdinal: number) => number | null;

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

@@ -55,7 +55,9 @@ export type PageState = {
         refId: string;
         fullHeight: number;
         firstLineHeight: number;
+        rowIndex?: number;
     }>;
+    footnoteRequiredStartRefId?: string;
 };
 export type PaginatorOptions = {
     margins: {
@@ -91,6 +93,7 @@ export type PaginatorOptions = {
         footnoteDemandThisPage: number;
         footnoteRefsThisPage: number;
         footnoteAnchorsThisPage: readonly PageState['footnoteAnchorsThisPage'][number][];
+        footnoteRequiredStartRefId?: string;
     };
     pageNumberOffset?: number;
     createPage(number: number, pageMargins: PageMargins, pageSizeOverride?: {
@@ -114,6 +117,7 @@ export type PaginatorOptions = {
     getFootnoteReserveForPage?: (pageIndex: number) => number;
     /** Coupled note-only continuation pages are real content before note injection. */
     keepNoteOnlyPages?: boolean;
+    initializeEmptyBodyBottom?: boolean;
 };
 export declare class PaginationEarlyStop extends Error {
     constructor();

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

@@ -147,3 +147,5 @@ export { resolveTrackedChangeDecorationFacts, syncTrackedDeletionBand, getTracke
 export { buildLinkRenderData } from './runs/links.js';
 export { INLINE_TRACKED_CHANGE_DEFAULTS } from './styles.js';
 export { resolveDecorationFragmentPosition } from './decoration-geometry.js';
+export { createChartElement } from './chart-renderer.js';
+export { convertOmmlToMathml } from './features/math/omml-to-mathml.js';

package/dist/layout-engine/painters/dom/src/paragraph/list-marker.d.ts

@@ -1,6 +1,6 @@
 import { ResolvePhysicalFamily } from '../../../../../shared/font-system/src/index.js';
 import { ParagraphMeasure, ResolvedListMarkerItem, SourceAnchor } from '../../../../contracts/src/index.js';
-import { MinimalMarker, MinimalWordLayout, ResolvedListMarkerGeometry } from '../../../../../../shared/common/list-marker-utils';
+import { MinimalMarker, MinimalWordLayout, ResolvedListMarkerGeometry } from '../../../../../shared/common/list-marker-utils.js';
 import { MarkerTrackedChangeView } from './marker-tracked-change.js';
 import { TrackedChangesRenderConfig } from '../runs/types.js';
 type PainterListTextStartParams = {

package/dist/layout-engine/painters/dom/src/paragraph/renderParagraphContent.d.ts

@@ -1,6 +1,6 @@
 import { RenderWork } from '../render-work.js';
 import { DropCapDescriptor, Line, ParagraphBlock, ParagraphMeasure, ResolvedParagraphContent, Run, SdtMetadata, SourceAnchor } from '../../../../contracts/src/index.js';
-import { MinimalWordLayout } from '../../../../../../shared/common/list-marker-utils';
+import { MinimalWordLayout } from '../../../../../shared/common/list-marker-utils.js';
 import { ResolvePhysicalFamily } from '../../../../../shared/font-system/src/index.js';
 import { SdtAncestorOptions, SdtBoundaryOptions } from '../sdt/container.js';
 import { BetweenBorderInfo } from './borders/index.js';

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

@@ -57,20 +57,10 @@ export type SurfaceStylePreflightEntry = {
     markerAttribute: string;
     cssText: string;
 };
-export declare const ensurePrintStyles: (doc: Document | null | undefined) => void;
 export declare const ensureDocumentSurfaceStyles: (doc: Document | null | undefined, styleNonce?: string) => void;
 export declare const ensureLinkStyles: (doc: Document | null | undefined) => void;
 export declare const ensureTrackChangeStyles: (doc: Document | null | undefined) => void;
-export declare const ensureFormattingMarksStyles: (doc: Document | null | undefined) => void;
 export declare const ensureSdtContainerStyles: (doc: Document | null | undefined) => void;
-export declare const ensureFieldAnnotationStyles: (doc: Document | null | undefined) => void;
-/**
- * Injects image selection highlight styles into the document head.
- * Ensures styles are only injected once per document lifecycle.
- * @param {Document | null | undefined} doc - The document to inject styles into
- * @returns {void}
- */
-export declare const ensureImageSelectionStyles: (doc: Document | null | undefined) => void;
 /**
  * Injects the MathML <menclose> polyfill into the document head. Required
  * because no browser paints menclose natively (MathML Core dropped it). See