superdoc 2.29.0-next.9 → 2.30.0-next.4

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.29.0-next.9",
+	superdocVersion: "2.30.0-next.4",
 	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.29.0-next.9",
+	superdocVersion: "2.30.0-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -0,0 +1,26 @@
+import { ChangeRecord, ChangesActorsResult, ChangesGetInput, ChangesListInput, ChangesListResult, ChangesResolveInput, ChangesResolveResult, ChangesSnapshotInput, ChangesSnapshotResult } from './changes.types.js';
+export interface ChangesAdapter {
+    list(input: ChangesListInput): Promise<ChangesListResult>;
+    get(input: ChangesGetInput): Promise<ChangeRecord | null>;
+    resolve(input: ChangesResolveInput): Promise<ChangesResolveResult>;
+    actors(): Promise<ChangesActorsResult>;
+    snapshot(input: ChangesSnapshotInput): Promise<ChangesSnapshotResult>;
+}
+export interface ChangesApi {
+    list(input?: ChangesListInput): Promise<ChangesListResult>;
+    get(input: ChangesGetInput): Promise<ChangeRecord | null>;
+    resolve(input: ChangesResolveInput): Promise<ChangesResolveResult>;
+    actors(): Promise<ChangesActorsResult>;
+    snapshot(input?: ChangesSnapshotInput): Promise<ChangesSnapshotResult>;
+}
+export declare const CHANGES_LIST_LIMIT_MAX = 1000;
+export declare const CHANGES_WAIT_MS_MAX = 30000;
+export declare function validateChangesListInput(input: unknown): ChangesListInput;
+export declare function validateChangesGetInput(input: unknown): ChangesGetInput;
+export declare function validateChangesResolveInput(input: unknown): ChangesResolveInput;
+export declare function validateChangesSnapshotInput(input: unknown): ChangesSnapshotInput;
+export declare function executeChangesList(adapter: ChangesAdapter | undefined, input?: ChangesListInput): Promise<ChangesListResult>;
+export declare function executeChangesGet(adapter: ChangesAdapter | undefined, input: ChangesGetInput): Promise<ChangeRecord | null>;
+export declare function executeChangesResolve(adapter: ChangesAdapter | undefined, input: ChangesResolveInput): Promise<ChangesResolveResult>;
+export declare function executeChangesActors(adapter: ChangesAdapter | undefined): Promise<ChangesActorsResult>;
+export declare function executeChangesSnapshot(adapter: ChangesAdapter | undefined, input?: ChangesSnapshotInput): Promise<ChangesSnapshotResult>;

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

@@ -0,0 +1,156 @@
+import { StoryLocator } from '../types/story.types.js';
+export type ChangeCause = 'user' | 'api' | 'undo' | 'redo';
+export type ChangeProvenance = 'authored' | 'declared' | 'relayed' | 'unknown';
+export type ChangeOrigin = 'local' | 'remote';
+export type ChangeActorType = 'human' | 'code';
+export type ChangesIdentityState = 'configured' | 'missing';
+export type ChangeSidecarKind = 'comment' | 'trackedChange' | 'bookmark';
+export interface ChangeActor {
+    id: string | null;
+    name?: string;
+    email?: string;
+    claim?: string;
+}
+export interface ChangeTextRange {
+    start: number;
+    end: number;
+}
+export interface TextBlockChange {
+    kind: 'text';
+    story: StoryLocator;
+    blockId: string;
+    range: ChangeTextRange;
+    inserted: string;
+    deleted: string;
+}
+export interface FormatBlockChange {
+    kind: 'format';
+    story: StoryLocator;
+    blockId: string;
+    range: ChangeTextRange;
+    attributes: Record<string, unknown>;
+}
+export interface ParagraphBlockChange {
+    kind: 'paragraph';
+    story: StoryLocator;
+    blockId: string;
+    properties: Record<string, unknown>;
+}
+export interface SplitBlockChange {
+    kind: 'split';
+    story: StoryLocator;
+    blockId: string;
+    tailBlockId: string;
+    offset: number;
+}
+export interface MergeBlockChange {
+    kind: 'merge';
+    story: StoryLocator;
+    blockId: string;
+    mergedBlockId: string;
+}
+export interface MoveBlockChange {
+    kind: 'move';
+    story: StoryLocator;
+    blockId: string;
+    afterBlockId: string | null;
+}
+export interface CreateBlockChange {
+    kind: 'create';
+    story: StoryLocator;
+    blockId: string;
+    text: string;
+}
+export interface RemoveBlockChange {
+    kind: 'remove';
+    story: StoryLocator;
+    blockId: string;
+    text: string;
+}
+export interface TableBlockChange {
+    kind: 'table';
+    story: StoryLocator;
+    tableId: string;
+    detail: Record<string, unknown>;
+}
+export interface SidecarBlockChange {
+    kind: 'sidecar';
+    affects: ChangeSidecarKind;
+    ids: string[];
+}
+export type BlockChange = TextBlockChange | FormatBlockChange | ParagraphBlockChange | SplitBlockChange | MergeBlockChange | MoveBlockChange | CreateBlockChange | RemoveBlockChange | TableBlockChange | SidecarBlockChange;
+export interface ChangeRecordTimes {
+    declared: string | null;
+    observed: string;
+}
+export interface ChangeRecordSession {
+    id: string | null;
+    clientId: number;
+}
+export interface ChangeRecord {
+    id: string;
+    seq: number;
+    revision: string;
+    origin: ChangeOrigin;
+    actor: ChangeActor | null;
+    contributors?: ChangeActor[];
+    actorType: ChangeActorType | null;
+    cause: ChangeCause | null;
+    provenance: ChangeProvenance;
+    at: ChangeRecordTimes;
+    session: ChangeRecordSession;
+    changeTag?: string;
+    changes: BlockChange[];
+    update?: string;
+}
+export interface ChangesListInput {
+    after?: string;
+    limit?: number;
+    story?: StoryLocator;
+    blockId?: string;
+    actorId?: string;
+    includeUpdate?: boolean;
+    waitMs?: number;
+}
+export interface ChangesListResult {
+    items: ChangeRecord[];
+    cursor: string | null;
+    truncated: boolean;
+    identity: ChangesIdentityState;
+    collaboration: boolean;
+}
+export interface ChangesGetInput {
+    id: string;
+}
+export interface ChangesResolveInput {
+    blockId: string;
+    limit?: number;
+}
+export interface ChangesResolveResult {
+    blockId: string;
+    lineage: string[];
+    items: ChangeRecord[];
+}
+export interface ChangesActorBinding {
+    clientId: number;
+    actorId: string | null;
+    name?: string;
+    email?: string;
+    sessionId: string;
+    declaredAt: string;
+    claim?: string;
+}
+export interface ChangesActorsResult {
+    items: ChangesActorBinding[];
+}
+export interface ChangesSnapshotInput {
+    includeState?: boolean;
+}
+export interface ChangesSnapshotResult {
+    revision: string;
+    cursor: string | null;
+    lastChangeId: string | null;
+    stateVector: string;
+    state?: string;
+    at: string;
+}

package/dist/document-api/src/contract/command-catalog.d.ts

@@ -1,7 +1,7 @@
 import { CommandCatalog, CommandStaticMetadata, OperationId } from './types.js';
 export declare const COMMAND_CATALOG: CommandCatalog;
 /** Operation IDs whose catalog entry has `mutates: true`. */
-export declare const MUTATING_OPERATION_IDS: ("replace" | "find" | "delete" | "insert" | "info" | "selection.extractOoxml" | "selection.current" | "selection.releaseSnapshot" | "format.readSelection" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "comments.patch" | "trackChanges.decide" | "styles.getCatalog" | "blocks.delete" | "comments.create" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "tables.moveColumn" | "format.bold" | "format.strike" | "format.color" | "format.position" | "format.cs" | "format.shading" | "format.rtl" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "format.italic" | "format.underline" | "format.caps" | "format.smallCaps" | "format.outline" | "format.shadow" | "format.emboss" | "format.imprint" | "format.vanish" | "format.webHidden" | "format.specVanish" | "format.border" | "format.dstrike" | "format.vertAlign" | "format.bCs" | "format.iCs" | "format.snapToGrid" | "format.oMath" | "format.letterSpacing" | "format.charScale" | "format.kerning" | "format.fitText" | "format.rStyle" | "format.rFonts" | "format.eastAsianLayout" | "format.em" | "format.ligatures" | "format.numForm" | "format.numSpacing" | "format.stylisticSets" | "format.contextualAlternates" | "get" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "blocks.findText" | "blocks.list" | "blocks.deleteRange" | "styles.apply" | "styles.create" | "styles.getTheme" | "templates.apply" | "create.paragraph" | "create.heading" | "create.sectionBreak" | "sections.list" | "sections.get" | "sections.setBreakType" | "sections.setPageMargins" | "sections.setHeaderFooterMargins" | "sections.setPageSetup" | "sections.setColumns" | "sections.setLineNumbering" | "sections.setPageNumbering" | "sections.setTitlePage" | "sections.setOddEvenHeadersFooters" | "sections.setVerticalAlign" | "sections.setSectionDirection" | "sections.setHeaderFooterRef" | "sections.clearHeaderFooterRef" | "sections.setLinkToPrevious" | "sections.setPageBorders" | "sections.clearPageBorders" | "styles.paragraph.setStyle" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "format.paragraph.resetDirectFormatting" | "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.clearTabStop" | "format.paragraph.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection" | "format.paragraph.setNumbering" | "lists.list" | "lists.get" | "lists.insert" | "lists.create" | "lists.attach" | "lists.detach" | "lists.delete" | "lists.indent" | "lists.outdent" | "lists.join" | "lists.canJoin" | "lists.separate" | "lists.merge" | "lists.split" | "lists.setLevel" | "lists.setValue" | "lists.continuePrevious" | "lists.canContinuePrevious" | "lists.setLevelRestart" | "lists.convertToText" | "lists.applyTemplate" | "lists.applyPreset" | "lists.setType" | "lists.captureTemplate" | "lists.setLevelNumbering" | "lists.setLevelBullet" | "lists.setLevelPictureBullet" | "lists.setLevelAlignment" | "lists.setLevelIndents" | "lists.setLevelTrailingCharacter" | "lists.setLevelMarkerFont" | "lists.clearLevelOverrides" | "lists.getStyle" | "lists.applyStyle" | "lists.restartAt" | "lists.setLevelNumberStyle" | "lists.setLevelText" | "lists.setLevelStart" | "lists.setLevelLayout" | "comments.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "query.match" | "ranges.resolve" | "mutations.beginTemporary" | "mutations.replaceTemporary" | "mutations.rollbackTemporary" | "mutations.commitTemporary" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "capabilities.resolve" | "create.table" | "tables.convertFromText" | "tables.delete" | "tables.clearContents" | "tables.move" | "tables.split" | "tables.convertToText" | "tables.setLayout" | "tables.insertRow" | "tables.deleteRow" | "tables.setRowHeight" | "tables.distributeRows" | "tables.setRowOptions" | "tables.insertColumn" | "tables.deleteColumn" | "tables.setColumnWidth" | "tables.distributeColumns" | "tables.insertCell" | "tables.deleteCell" | "tables.mergeCells" | "tables.unmergeCells" | "tables.splitCell" | "tables.setCellProperties" | "tables.setCellText" | "tables.sort" | "tables.setAltText" | "tables.setStyle" | "tables.clearStyle" | "tables.setStyleOption" | "tables.setBorder" | "tables.clearBorder" | "tables.applyBorderPreset" | "tables.setShading" | "tables.clearShading" | "tables.setTablePadding" | "tables.setCellPadding" | "tables.setCellSpacing" | "tables.clearCellSpacing" | "tables.applyStyle" | "tables.setBorders" | "tables.setTableOptions" | "tables.applyPreset" | "tables.get" | "tables.getCells" | "tables.getProperties" | "tables.getStyles" | "tables.setDefaultStyle" | "tables.clearDefaultStyle" | "create.tableOfContents" | "toc.list" | "toc.get" | "toc.configure" | "toc.update" | "toc.remove" | "toc.markEntry" | "toc.unmarkEntry" | "toc.listEntries" | "toc.getEntry" | "toc.editEntry" | "history.get" | "history.undo" | "history.redo" | "create.image" | "images.list" | "images.get" | "images.delete" | "images.move" | "images.convertToInline" | "images.convertToFloating" | "images.setSize" | "images.setWrapType" | "images.setWrapSide" | "images.setWrapDistances" | "images.setPosition" | "images.setAnchorOptions" | "images.setZOrder" | "images.scale" | "images.setLockAspectRatio" | "images.rotate" | "images.flip" | "images.crop" | "images.resetCrop" | "images.replaceSource" | "images.setAltText" | "images.setDecorative" | "images.setName" | "images.setHyperlink" | "images.insertCaption" | "images.updateCaption" | "images.removeCaption" | "hyperlinks.list" | "hyperlinks.get" | "hyperlinks.wrap" | "hyperlinks.insert" | "hyperlinks.patch" | "hyperlinks.remove" | "headerFooters.list" | "headerFooters.get" | "headerFooters.resolve" | "headerFooters.refs.set" | "headerFooters.refs.clear" | "headerFooters.refs.setLinkedToPrevious" | "headerFooters.parts.list" | "headerFooters.parts.create" | "headerFooters.parts.delete" | "headerFooters.pageNumbers.get" | "headerFooters.pageNumbers.insert" | "headerFooters.pageNumbers.set" | "headerFooters.pageNumbers.remove" | "watermarks.apply" | "watermarks.list" | "watermarks.insert" | "watermarks.replace" | "watermarks.remove" | "create.contentControl" | "contentControls.list" | "contentControls.get" | "contentControls.listInRange" | "contentControls.selectByTag" | "contentControls.selectByTitle" | "contentControls.listChildren" | "contentControls.getParent" | "contentControls.wrap" | "contentControls.unwrap" | "contentControls.delete" | "contentControls.copy" | "contentControls.move" | "contentControls.patch" | "contentControls.setLockMode" | "contentControls.setType" | "contentControls.getContent" | "contentControls.replaceContent" | "contentControls.clearContent" | "contentControls.appendContent" | "contentControls.prependContent" | "contentControls.insertBefore" | "contentControls.insertAfter" | "contentControls.getBinding" | "contentControls.setBinding" | "contentControls.clearBinding" | "contentControls.getRawProperties" | "contentControls.patchRawProperties" | "contentControls.validateWordCompatibility" | "contentControls.normalizeWordCompatibility" | "contentControls.normalizeTagPayload" | "contentControls.text.setMultiline" | "contentControls.text.setValue" | "contentControls.text.clearValue" | "contentControls.date.setValue" | "contentControls.date.clearValue" | "contentControls.date.setDisplayFormat" | "contentControls.date.setDisplayLocale" | "contentControls.date.setStorageFormat" | "contentControls.date.setCalendar" | "contentControls.checkbox.getState" | "contentControls.checkbox.setState" | "contentControls.checkbox.toggle" | "contentControls.checkbox.setSymbolPair" | "contentControls.choiceList.getItems" | "contentControls.choiceList.setItems" | "contentControls.choiceList.setSelected" | "contentControls.repeatingSection.listItems" | "contentControls.repeatingSection.insertItemBefore" | "contentControls.repeatingSection.insertItemAfter" | "contentControls.repeatingSection.cloneItem" | "contentControls.repeatingSection.deleteItem" | "contentControls.repeatingSection.setAllowInsertDelete" | "contentControls.group.wrap" | "contentControls.group.ungroup" | "bookmarks.list" | "bookmarks.get" | "bookmarks.insert" | "bookmarks.rename" | "bookmarks.remove" | "footnotes.list" | "footnotes.get" | "footnotes.insert" | "footnotes.update" | "footnotes.remove" | "footnotes.configure" | "clipboard.parse" | "clipboard.insert" | "clipboard.serializeSelection" | "crossRefs.list" | "crossRefs.get" | "crossRefs.insert" | "crossRefs.rebuild" | "crossRefs.remove" | "index.list" | "index.get" | "index.insert" | "index.configure" | "index.rebuild" | "index.remove" | "index.entries.list" | "index.entries.get" | "index.entries.insert" | "index.entries.update" | "index.entries.remove" | "captions.list" | "captions.get" | "captions.insert" | "captions.update" | "captions.remove" | "captions.configure" | "fields.list" | "fields.get" | "fields.insert" | "fields.rebuild" | "fields.remove" | "citations.list" | "citations.get" | "citations.insert" | "citations.update" | "citations.remove" | "citations.sources.list" | "citations.sources.get" | "citations.sources.insert" | "citations.sources.update" | "citations.sources.remove" | "citations.bibliography.get" | "citations.bibliography.insert" | "citations.bibliography.rebuild" | "citations.bibliography.configure" | "citations.bibliography.remove" | "authorities.list" | "authorities.get" | "authorities.insert" | "authorities.configure" | "authorities.rebuild" | "authorities.remove" | "authorities.entries.list" | "authorities.entries.get" | "authorities.entries.insert" | "authorities.entries.update" | "authorities.entries.remove" | "diff.capture" | "diff.compare" | "diff.apply" | "export.toDocx" | "protection.get" | "protection.setEditingRestriction" | "protection.clearEditingRestriction" | "permissionRanges.list" | "permissionRanges.get" | "permissionRanges.create" | "permissionRanges.remove" | "permissionRanges.updatePrincipal" | "customXml.parts.list" | "customXml.parts.get" | "customXml.parts.create" | "customXml.parts.patch" | "customXml.parts.remove" | "metadata.attach" | "metadata.list" | "metadata.get" | "metadata.update" | "metadata.remove" | "metadata.resolve")[];
+export declare const MUTATING_OPERATION_IDS: ("insert" | "replace" | "find" | "delete" | "info" | "selection.extractOoxml" | "selection.current" | "selection.releaseSnapshot" | "format.readSelection" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "comments.patch" | "trackChanges.decide" | "styles.getCatalog" | "blocks.delete" | "comments.create" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "tables.moveColumn" | "format.bold" | "format.strike" | "format.color" | "format.position" | "format.cs" | "format.shading" | "format.rtl" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "format.italic" | "format.underline" | "format.caps" | "format.smallCaps" | "format.outline" | "format.shadow" | "format.emboss" | "format.imprint" | "format.vanish" | "format.webHidden" | "format.specVanish" | "format.border" | "format.dstrike" | "format.vertAlign" | "format.bCs" | "format.iCs" | "format.snapToGrid" | "format.oMath" | "format.letterSpacing" | "format.charScale" | "format.kerning" | "format.fitText" | "format.rStyle" | "format.rFonts" | "format.eastAsianLayout" | "format.em" | "format.ligatures" | "format.numForm" | "format.numSpacing" | "format.stylisticSets" | "format.contextualAlternates" | "get" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "blocks.findText" | "blocks.list" | "blocks.deleteRange" | "styles.apply" | "styles.create" | "styles.getTheme" | "templates.apply" | "create.paragraph" | "create.heading" | "create.sectionBreak" | "sections.list" | "sections.get" | "sections.setBreakType" | "sections.setPageMargins" | "sections.setHeaderFooterMargins" | "sections.setPageSetup" | "sections.setColumns" | "sections.setLineNumbering" | "sections.setPageNumbering" | "sections.setTitlePage" | "sections.setOddEvenHeadersFooters" | "sections.setVerticalAlign" | "sections.setSectionDirection" | "sections.setHeaderFooterRef" | "sections.clearHeaderFooterRef" | "sections.setLinkToPrevious" | "sections.setPageBorders" | "sections.clearPageBorders" | "styles.paragraph.setStyle" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "format.paragraph.resetDirectFormatting" | "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.clearTabStop" | "format.paragraph.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection" | "format.paragraph.setNumbering" | "lists.list" | "lists.get" | "lists.insert" | "lists.create" | "lists.attach" | "lists.detach" | "lists.delete" | "lists.indent" | "lists.outdent" | "lists.join" | "lists.canJoin" | "lists.separate" | "lists.merge" | "lists.split" | "lists.setLevel" | "lists.setValue" | "lists.continuePrevious" | "lists.canContinuePrevious" | "lists.setLevelRestart" | "lists.convertToText" | "lists.applyTemplate" | "lists.applyPreset" | "lists.setType" | "lists.captureTemplate" | "lists.setLevelNumbering" | "lists.setLevelBullet" | "lists.setLevelPictureBullet" | "lists.setLevelAlignment" | "lists.setLevelIndents" | "lists.setLevelTrailingCharacter" | "lists.setLevelMarkerFont" | "lists.clearLevelOverrides" | "lists.getStyle" | "lists.applyStyle" | "lists.restartAt" | "lists.setLevelNumberStyle" | "lists.setLevelText" | "lists.setLevelStart" | "lists.setLevelLayout" | "comments.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "query.match" | "ranges.resolve" | "mutations.beginTemporary" | "mutations.replaceTemporary" | "mutations.rollbackTemporary" | "mutations.commitTemporary" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "capabilities.resolve" | "create.table" | "tables.convertFromText" | "tables.delete" | "tables.clearContents" | "tables.move" | "tables.split" | "tables.convertToText" | "tables.setLayout" | "tables.insertRow" | "tables.deleteRow" | "tables.setRowHeight" | "tables.distributeRows" | "tables.setRowOptions" | "tables.insertColumn" | "tables.deleteColumn" | "tables.setColumnWidth" | "tables.distributeColumns" | "tables.insertCell" | "tables.deleteCell" | "tables.mergeCells" | "tables.unmergeCells" | "tables.splitCell" | "tables.setCellProperties" | "tables.setCellText" | "tables.sort" | "tables.setAltText" | "tables.setStyle" | "tables.clearStyle" | "tables.setStyleOption" | "tables.setBorder" | "tables.clearBorder" | "tables.applyBorderPreset" | "tables.setShading" | "tables.clearShading" | "tables.setTablePadding" | "tables.setCellPadding" | "tables.setCellSpacing" | "tables.clearCellSpacing" | "tables.applyStyle" | "tables.setBorders" | "tables.setTableOptions" | "tables.applyPreset" | "tables.get" | "tables.getCells" | "tables.getProperties" | "tables.getStyles" | "tables.setDefaultStyle" | "tables.clearDefaultStyle" | "create.tableOfContents" | "toc.list" | "toc.get" | "toc.configure" | "toc.update" | "toc.remove" | "toc.markEntry" | "toc.unmarkEntry" | "toc.listEntries" | "toc.getEntry" | "toc.editEntry" | "history.get" | "history.undo" | "history.redo" | "changes.list" | "changes.get" | "changes.resolve" | "changes.actors" | "changes.snapshot" | "create.image" | "images.list" | "images.get" | "images.delete" | "images.move" | "images.convertToInline" | "images.convertToFloating" | "images.setSize" | "images.setWrapType" | "images.setWrapSide" | "images.setWrapDistances" | "images.setPosition" | "images.setAnchorOptions" | "images.setZOrder" | "images.scale" | "images.setLockAspectRatio" | "images.rotate" | "images.flip" | "images.crop" | "images.resetCrop" | "images.replaceSource" | "images.setAltText" | "images.setDecorative" | "images.setName" | "images.setHyperlink" | "images.insertCaption" | "images.updateCaption" | "images.removeCaption" | "hyperlinks.list" | "hyperlinks.get" | "hyperlinks.wrap" | "hyperlinks.insert" | "hyperlinks.patch" | "hyperlinks.remove" | "headerFooters.list" | "headerFooters.get" | "headerFooters.resolve" | "headerFooters.refs.set" | "headerFooters.refs.clear" | "headerFooters.refs.setLinkedToPrevious" | "headerFooters.parts.list" | "headerFooters.parts.create" | "headerFooters.parts.delete" | "headerFooters.pageNumbers.get" | "headerFooters.pageNumbers.insert" | "headerFooters.pageNumbers.set" | "headerFooters.pageNumbers.remove" | "watermarks.apply" | "watermarks.list" | "watermarks.insert" | "watermarks.replace" | "watermarks.remove" | "create.contentControl" | "contentControls.list" | "contentControls.get" | "contentControls.listInRange" | "contentControls.selectByTag" | "contentControls.selectByTitle" | "contentControls.listChildren" | "contentControls.getParent" | "contentControls.wrap" | "contentControls.unwrap" | "contentControls.delete" | "contentControls.copy" | "contentControls.move" | "contentControls.patch" | "contentControls.setLockMode" | "contentControls.setType" | "contentControls.getContent" | "contentControls.replaceContent" | "contentControls.clearContent" | "contentControls.appendContent" | "contentControls.prependContent" | "contentControls.insertBefore" | "contentControls.insertAfter" | "contentControls.getBinding" | "contentControls.setBinding" | "contentControls.clearBinding" | "contentControls.getRawProperties" | "contentControls.patchRawProperties" | "contentControls.validateWordCompatibility" | "contentControls.normalizeWordCompatibility" | "contentControls.normalizeTagPayload" | "contentControls.text.setMultiline" | "contentControls.text.setValue" | "contentControls.text.clearValue" | "contentControls.date.setValue" | "contentControls.date.clearValue" | "contentControls.date.setDisplayFormat" | "contentControls.date.setDisplayLocale" | "contentControls.date.setStorageFormat" | "contentControls.date.setCalendar" | "contentControls.checkbox.getState" | "contentControls.checkbox.setState" | "contentControls.checkbox.toggle" | "contentControls.checkbox.setSymbolPair" | "contentControls.choiceList.getItems" | "contentControls.choiceList.setItems" | "contentControls.choiceList.setSelected" | "contentControls.repeatingSection.listItems" | "contentControls.repeatingSection.insertItemBefore" | "contentControls.repeatingSection.insertItemAfter" | "contentControls.repeatingSection.cloneItem" | "contentControls.repeatingSection.deleteItem" | "contentControls.repeatingSection.setAllowInsertDelete" | "contentControls.group.wrap" | "contentControls.group.ungroup" | "bookmarks.list" | "bookmarks.get" | "bookmarks.insert" | "bookmarks.rename" | "bookmarks.remove" | "footnotes.list" | "footnotes.get" | "footnotes.insert" | "footnotes.update" | "footnotes.remove" | "footnotes.configure" | "clipboard.parse" | "clipboard.insert" | "clipboard.serializeSelection" | "crossRefs.list" | "crossRefs.get" | "crossRefs.insert" | "crossRefs.rebuild" | "crossRefs.remove" | "index.list" | "index.get" | "index.insert" | "index.configure" | "index.rebuild" | "index.remove" | "index.entries.list" | "index.entries.get" | "index.entries.insert" | "index.entries.update" | "index.entries.remove" | "captions.list" | "captions.get" | "captions.insert" | "captions.update" | "captions.remove" | "captions.configure" | "fields.list" | "fields.get" | "fields.insert" | "fields.rebuild" | "fields.remove" | "citations.list" | "citations.get" | "citations.insert" | "citations.update" | "citations.remove" | "citations.sources.list" | "citations.sources.get" | "citations.sources.insert" | "citations.sources.update" | "citations.sources.remove" | "citations.bibliography.get" | "citations.bibliography.insert" | "citations.bibliography.rebuild" | "citations.bibliography.configure" | "citations.bibliography.remove" | "authorities.list" | "authorities.get" | "authorities.insert" | "authorities.configure" | "authorities.rebuild" | "authorities.remove" | "authorities.entries.list" | "authorities.entries.get" | "authorities.entries.insert" | "authorities.entries.update" | "authorities.entries.remove" | "diff.capture" | "diff.compare" | "diff.apply" | "export.toDocx" | "protection.get" | "protection.setEditingRestriction" | "protection.clearEditingRestriction" | "permissionRanges.list" | "permissionRanges.get" | "permissionRanges.create" | "permissionRanges.remove" | "permissionRanges.updatePrincipal" | "customXml.parts.list" | "customXml.parts.get" | "customXml.parts.create" | "customXml.parts.patch" | "customXml.parts.remove" | "metadata.attach" | "metadata.list" | "metadata.get" | "metadata.update" | "metadata.remove" | "metadata.resolve")[];
 /** Maps each operation to its human-readable description. */
 export declare const OPERATION_DESCRIPTION_MAP: Record<OperationId, string>;
 /** Maps each operation to whether it requires an open document to execute. */

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

@@ -1,5 +1,5 @@
 import { CommandStaticMetadata } from './metadata-types.js';
-export type ReferenceGroupKey = 'core' | 'blocks' | 'capabilities' | 'create' | 'sections' | 'format' | 'format.paragraph' | 'styles' | 'styles.paragraph' | 'templates' | 'lists' | 'comments' | 'trackChanges' | 'query' | 'mutations' | 'tables' | 'history' | 'toc' | 'images' | 'hyperlinks' | 'headerFooters' | 'watermarks' | 'contentControls' | 'bookmarks' | 'footnotes' | 'clipboard' | 'crossRefs' | 'index' | 'captions' | 'fields' | 'citations' | 'authorities' | 'ranges' | 'selection' | 'diff' | 'export' | 'protection' | 'permissionRanges' | 'customXml' | 'metadata';
+export type ReferenceGroupKey = 'core' | 'blocks' | 'capabilities' | 'create' | 'sections' | 'format' | 'format.paragraph' | 'styles' | 'styles.paragraph' | 'templates' | 'lists' | 'comments' | 'trackChanges' | 'query' | 'mutations' | 'tables' | 'history' | 'changes' | 'toc' | 'images' | 'hyperlinks' | 'headerFooters' | 'watermarks' | 'contentControls' | 'bookmarks' | 'footnotes' | 'clipboard' | 'crossRefs' | 'index' | 'captions' | 'fields' | 'citations' | 'authorities' | 'ranges' | 'selection' | 'diff' | 'export' | 'protection' | 'permissionRanges' | 'customXml' | 'metadata';
 export interface OperationDefinitionEntry {
     memberPath: string;
     description: string;
@@ -1800,6 +1800,56 @@ export declare const OPERATION_DEFINITIONS: {
         readonly intentGroup: "edit";
         readonly intentAction: "redo";
     };
+    readonly 'changes.list': {
+        readonly memberPath: "changes.list";
+        readonly description: "List the change records this session retains, oldest first, with each change's actor, cause, provenance and affected blocks. Pass the returned cursor back as `after` to read only newer records; `waitMs` long-polls until at least one newer record exists.";
+        readonly expectedResult: "Returns a ChangesListResult with items (oldest to newest), a resume cursor, a truncated flag when records after `after` were evicted, the session identity state and whether the session is collaborative.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/list.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.get': {
+        readonly memberPath: "changes.get";
+        readonly description: "Get one retained change record by id.";
+        readonly expectedResult: "Returns the ChangeRecord with that id, or null when this session does not retain it.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/get.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.resolve': {
+        readonly memberPath: "changes.resolve";
+        readonly description: "List the retained change records that touched a block, following the blocks it was split from or merged with.";
+        readonly expectedResult: "Returns a ChangesResolveResult with the block id, its lineage (the block plus the blocks it was split from or merged with) and the matching records, oldest to newest.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/resolve.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.actors': {
+        readonly memberPath: "changes.actors";
+        readonly description: "List the identities that collaboration clients declared for this document. Identities and claims are declared by each client and are not verified by SuperDoc.";
+        readonly expectedResult: "Returns a ChangesActorsResult with one item per declared client binding: client id, actor id, optional name, email and claim, session id and declaration time.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/actors.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.snapshot': {
+        readonly memberPath: "changes.snapshot";
+        readonly description: "Capture the current revision, change cursor and collaboration state vector so a verifier can later replay or compare change records against this point.";
+        readonly expectedResult: "Returns a ChangesSnapshotResult with the revision, change cursor, last change id, base64 state vector, optional base64 full state and capture time.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/snapshot.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
     readonly 'create.image': {
         readonly memberPath: "create.image";
         readonly description: "Insert a new image at the target position.";

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

@@ -17,11 +17,7 @@ export interface CreateApi {
 export type CreateAdapter = CreateApi;
 export declare function normalizeCreateParagraphInput(input: CreateParagraphInput): CreateParagraphInput;
 export declare function executeCreateParagraph(adapter: CreateAdapter, input: CreateParagraphInput, options?: MutationOptions): CreateParagraphResult;
-export declare function normalizeCreateHeadingInput(input: CreateHeadingInput): CreateHeadingInput;
 export declare function executeCreateHeading(adapter: CreateAdapter, input: CreateHeadingInput, options?: MutationOptions): CreateHeadingResult;
-export declare function normalizeCreateTableInput(input: CreateTableInput): CreateTableInput;
 export declare function executeCreateTable(adapter: CreateAdapter, input: CreateTableInput, options?: MutationOptions): CreateTableResult;
-export declare function normalizeCreateSectionBreakInput(input: CreateSectionBreakInput): CreateSectionBreakInput;
 export declare function executeCreateSectionBreak(adapter: CreateAdapter, input: CreateSectionBreakInput, options?: MutationOptions): CreateSectionBreakResult;
-export declare function normalizeCreateTableOfContentsInput(input: CreateTableOfContentsInput): CreateTableOfContentsInput;
 export declare function executeCreateTableOfContents(adapter: CreateAdapter, input: CreateTableOfContentsInput, options?: MutationOptions): CreateTableOfContentsResult;

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

@@ -105,23 +105,23 @@ export interface DiffApplyResult {
     coverage: DiffCoverage;
     summary: DiffSummary;
     diagnostics: string[];
-    /** Style definitions applied directly; these changes remain when body revisions are rejected. */
+    /** Style policy used for this comparison. Tracked mode preserves unused proposal definitions after rejection. */
     styleChanges?: {
-        changeMode: 'direct';
+        changeMode: 'direct' | 'tracked';
         partUris: string[];
     };
 }
 /** Input for `diff.compare`. */
 export interface DiffCompareInput {
     targetSnapshot: DiffSnapshot;
-    /** Assess tracked eligibility with explicit consent to apply style definitions directly. */
-    styleChangeMode?: 'direct';
+    /** Directly adopt definitions, or review references to separate proposed styles. */
+    styleChangeMode?: 'direct' | 'tracked';
 }
 /** Input for `diff.apply`. */
 export interface DiffApplyInput {
     diff: DiffPayload;
-    /** Apply target style definitions directly, even when body changes are tracked. */
-    styleChangeMode?: 'direct';
+    /** Tracked styles require tracked application; direct styles persist after body rejection. */
+    styleChangeMode?: 'direct' | 'tracked';
 }
 /** How body content changes are applied. */
 export type DiffChangeMode = 'direct' | 'tracked';

package/dist/document-api/src/header-footers/header-footers.d.ts

@@ -1,6 +1,6 @@
 import { MutationOptions } from '../write/write.js';
 import { SectionMutationResult } from '../sections/sections.types.js';
-import { HeaderFooterKind, HeaderFooterVariant, HeaderFooterSlotAddress, HeaderFooterPartAddress, HeaderFooterSlotEntry, HeaderFooterResolveResult, HeaderFootersListQuery, HeaderFootersListResult, HeaderFootersGetInput, HeaderFootersResolveInput, HeaderFootersRefsSetInput, HeaderFootersRefsClearInput, HeaderFootersRefsSetLinkedToPreviousInput, HeaderFootersPartsListQuery, HeaderFootersPartsListResult, HeaderFootersPartsCreateInput, HeaderFootersPartsDeleteInput, HeaderFooterPartsMutationResult, HeaderFootersPageNumbersInsertInput, HeaderFooterPageNumbersInsertResult, HeaderFootersPageNumbersSetInput, HeaderFooterPageNumbersSetResult, HeaderFootersPageNumbersRemoveInput, HeaderFooterPageNumbersRemoveResult, HeaderFootersPageNumbersGetInput, HeaderFooterPageNumbersInfo } from './header-footers.types.js';
+import { HeaderFooterSlotAddress, HeaderFooterPartAddress, HeaderFooterSlotEntry, HeaderFooterResolveResult, HeaderFootersListQuery, HeaderFootersListResult, HeaderFootersGetInput, HeaderFootersResolveInput, HeaderFootersRefsSetInput, HeaderFootersRefsClearInput, HeaderFootersRefsSetLinkedToPreviousInput, HeaderFootersPartsListQuery, HeaderFootersPartsListResult, HeaderFootersPartsCreateInput, HeaderFootersPartsDeleteInput, HeaderFooterPartsMutationResult, HeaderFootersPageNumbersInsertInput, HeaderFooterPageNumbersInsertResult, HeaderFootersPageNumbersSetInput, HeaderFooterPageNumbersSetResult, HeaderFootersPageNumbersRemoveInput, HeaderFooterPageNumbersRemoveResult, HeaderFootersPageNumbersGetInput, HeaderFooterPageNumbersInfo } from './header-footers.types.js';
 export type { HeaderFooterKind, HeaderFooterVariant, HeaderFooterSlotAddress, HeaderFooterPartAddress, HeaderFooterSlotEntry, HeaderFooterResolveResult, HeaderFooterPartEntry, HeaderFootersListQuery, HeaderFootersListResult, HeaderFootersGetInput, HeaderFootersResolveInput, HeaderFootersRefsSetInput, HeaderFootersRefsClearInput, HeaderFootersRefsSetLinkedToPreviousInput, HeaderFootersPartsListQuery, HeaderFootersPartsListResult, HeaderFootersPartsCreateInput, HeaderFootersPartsDeleteInput, HeaderFooterPartsMutationResult, HeaderFooterRefsMutationResult, HeaderFooterRefsMutationSuccessResult, HeaderFooterRefsMutationFailureResult, HeaderFooterPartsMutationSuccessResult, HeaderFooterPartsMutationFailureResult, HeaderFooterPageNumberAlignment, HeaderFootersPageNumbersInsertInput, HeaderFooterPageNumbersInsertResult, HeaderFooterPageNumbersInsertSuccessResult, HeaderFooterPageNumbersInsertFailureResult, HeaderFootersPageNumbersNumberingInput, HeaderFootersPageNumbersSetInput, HeaderFooterPageNumbersSetResult, HeaderFootersPageNumbersRemoveInput, HeaderFooterPageNumbersRemoveResult, HeaderFooterPageNumbersRemoveSuccessResult, HeaderFootersPageNumbersGetInput, HeaderFooterPageNumberPlacement, HeaderFooterPageNumbersInfo, } from './header-footers.types.js';
 export interface HeaderFootersAdapter {
     list(query?: HeaderFootersListQuery): HeaderFootersListResult;
@@ -27,8 +27,6 @@ export interface HeaderFootersAdapter {
 export type HeaderFootersApi = Omit<HeaderFootersAdapter, 'pageNumbers'> & {
     pageNumbers: NonNullable<HeaderFootersAdapter['pageNumbers']>;
 };
-export declare function validateHeaderFooterKind(operationName: string, kind: unknown): asserts kind is HeaderFooterKind;
-export declare function validateHeaderFooterVariant(operationName: string, variant: unknown): asserts variant is HeaderFooterVariant;
 export declare function assertHeaderFooterSlotTarget(input: unknown, operationName: string): asserts input is {
     target: HeaderFooterSlotAddress;
 };

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

@@ -40,6 +40,7 @@ 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 { ParagraphsAdapter, ParagraphFormatApi, ParagraphStylesApi } from './paragraphs/paragraphs.js';
@@ -72,6 +73,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';
@@ -517,6 +521,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 +623,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. */

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/layout-engine/contracts/src/index.d.ts

@@ -371,7 +371,7 @@ export type CrossReferenceMetadata = {
     preferFollowing?: boolean;
 };
 export type TextRun = RunMarks & {
-    kind?: 'text';
+    kind: 'text';
     text: string;
     fontFamily: string;
     fontSize: number;
@@ -2923,7 +2923,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/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.