@stll/folio-core 0.8.0 → 0.9.0

package/README.md

@@ -32,6 +32,45 @@ bun add @stll/folio-core
 | `@stll/folio-core/server`   | DOM-free helpers for server-side use (block-id derivation, document creation, re-zip)                                                                              |
 | `@stll/folio-core/*`        | the source-mirrored module tree (e.g. `@stll/folio-core/types/document`, `@stll/folio-core/prosemirror/schema`) for adapters that need lower-level building blocks |
 
+## New documents and reusable style sets
+
+Create a legal-shaped blank document with the built-in preset:
+
+```ts
+import { createDocx, createEmptyDocument, createStellaStyleDocumentPreset } from "@stll/folio-core";
+
+const document = createEmptyDocument({
+  preset: createStellaStyleDocumentPreset(),
+});
+const docx = await createDocx(document);
+```
+
+Style sets are content-free JSON values. Inspect a source file before presenting
+styles for selection, extract the selected dependency closure, persist the
+result, and load it into any later document:
+
+```ts
+import {
+  createEmptyDocument,
+  extractDocumentStyleSetFromDocx,
+  inspectDocumentStylesFromDocx,
+} from "@stll/folio-core";
+
+const catalog = await inspectDocumentStylesFromDocx(sourceDocx);
+const styleSet = await extractDocumentStyleSetFromDocx(sourceDocx, {
+  name: "Firm contract styles",
+  styleIds: catalog.styles
+    .filter(({ role }) => role === "default" || role === "quick")
+    .map(({ styleId }) => styleId),
+});
+
+const document = createEmptyDocument({ styleSet });
+```
+
+Extraction excludes document content, metadata, relationships, media, comments,
+and revision data. It keeps only the selected styles and the numbering, theme,
+font-table, and settings data required to reproduce their formatting.
+
 ## License
 
 [Apache-2.0](./LICENSE)

package/dist/ai-edits/apply.js

@@ -678,10 +678,24 @@ const resolveOperation = ({ snapshot, operation, liveBlocks, liveBlocksByParaId,
 	}
 	if (operation.type === "deleteBlock" || operation.type === "replaceBlock") {
 		const range = getTextRangeFromCleanBlock(cleanBlock);
-		if (!range) return {
-			type: "skip",
-			reason: "unsupportedBlock"
-		};
+		if (!range) {
+			const insertionPoint = cleanBlock.offsets.at(0);
+			if (operation.type === "replaceBlock" && currentText.length === 0 && operation.text.length > 0 && insertionPoint !== void 0) return {
+				type: "resolved",
+				operation: {
+					operation,
+					from: insertionPoint,
+					to: insertionPoint,
+					blockFrom,
+					blockTo,
+					blockNode
+				}
+			};
+			return {
+				type: "skip",
+				reason: "unsupportedBlock"
+			};
+		}
 		if (operation.type === "replaceBlock" && operation.text === currentText) return {
 			type: "skip",
 			reason: "noopOperation"

package/dist/ai-edits/headless.d.ts

@@ -39,10 +39,22 @@ type FolioDocumentStoryHandle = {
   type: "footnote" | "endnote";
   noteId: number;
 };
+type FolioEditableDocumentStoryHandle = Exclude<FolioDocumentStoryHandle, {
+  type: "footnote" | "endnote";
+}>;
 type FolioDocumentStory = {
   handle: FolioDocumentStoryHandle;
   text: string;
 };
+declare const FolioDocumentStoryNotFoundError_base: import("better-result").TaggedErrorClass<"FolioDocumentStoryNotFoundError", {
+  message: string;
+  story: FolioEditableDocumentStoryHandle;
+}>;
+declare class FolioDocumentStoryNotFoundError extends FolioDocumentStoryNotFoundError_base {}
+type FolioApplyDocumentOperationsToStoryOptions = FolioApplyDocumentOperationsOptions & {
+  story: FolioEditableDocumentStoryHandle;
+  batch: FolioDocumentOperationBatch;
+};
 /** Filter for {@link FolioDocxReviewer.getChanges}. */
 type FolioReviewChangeFilter = {
   author?: string;
@@ -97,6 +109,7 @@ declare class FolioDocxReviewer {
   private readonly baseDocument;
   private readonly originalBuffer;
   private state;
+  private readonly headerFooterStoryStates;
   private readonly createdComments;
   private readonly documentOperationUndoEntries;
   /**
@@ -116,6 +129,8 @@ declare class FolioDocxReviewer {
    * the anchor map the apply layer resolves operations against.
    */
   snapshot(): FolioAIEditSnapshot;
+  /** Snapshot one editable story into stable, operation-ready blocks. */
+  snapshotStory(story: FolioEditableDocumentStoryHandle): FolioAIEditSnapshot | null;
   /**
    * Apply operations against the current state. Reuses the live-editor applier
    * verbatim via a headless `{ state, dispatch }` seam; the resulting state
@@ -129,6 +144,12 @@ declare class FolioDocxReviewer {
    * edit semantics.
    */
   applyDocumentOperations(batch: FolioDocumentOperationBatch, options?: FolioApplyDocumentOperationsOptions): FolioDocumentOperationResult;
+  /** Apply a versioned operation batch to the main story, a header, or a footer. */
+  applyDocumentOperationsToStory({
+    story,
+    batch,
+    snapshot
+  }: FolioApplyDocumentOperationsToStoryOptions): FolioDocumentOperationResult;
   private applyDocumentOperationsInternal;
   /** Undo the latest unchanged document-operation batch and its created comments. */
   undoDocumentOperations(undoHandle: FolioDocumentOperationUndoHandle): FolioDocumentOperationUndoResult;
@@ -153,9 +174,9 @@ declare class FolioDocxReviewer {
   /**
    * Header / footer and footnote / endnote text as labeled, LLM-ready lines,
    * one per non-empty part: `[header default] …`, `[footer default] …`,
-   * `[footnote #N] …`, `[endnote #N] …`. Read-only — note bodies are outside
-   * the reviewer's body-only apply scope, so this reflects the parsed source.
-   * Empty parts and separator notes are omitted.
+   * `[footnote #N] …`, `[endnote #N] …`. Header and footer lines reflect
+   * in-memory edits; note bodies reflect the parsed source. Empty parts and
+   * separator notes are omitted.
    */
   getNotesAsText(): string;
   /** Discover every readable document story through a typed, serializable handle. */
@@ -239,6 +260,12 @@ declare class FolioDocxReviewer {
    * is the graceful handling — no separate error surface is needed here.
    */
   private trySelectiveSave;
+  private getEditableStoryState;
+  private requireEditableStoryState;
+  private setEditableStoryState;
+  private getHeaderFooterStory;
+  private getHeaderFooterStoryText;
+  private mergeEditedHeaderFooterStories;
   /**
    * Count every tracked change an accept-all / reject-all sweep resolves: the
    * inline insertion / deletion groups {@link getChanges} enumerates, plus the
@@ -283,4 +310,4 @@ type ApplyFolioAIEditsToBufferResult = FolioAIEditApplyResult & {
  */
 declare const applyFolioAIEditsToBuffer: (buffer: ArrayBuffer, operations: FolioAIEditOperation[], options?: ApplyFolioAIEditsToBufferOptions) => Promise<ApplyFolioAIEditsToBufferResult>;
 //#endregion
-export { ApplyFolioAIEditsToBufferOptions, ApplyFolioAIEditsToBufferResult, FolioApplyDocumentOperationsOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocxReviewer, FolioDocxReviewerOptions, FolioGetContentAsTextOptions, type FolioReviewChange, FolioReviewChangeFilter, type FolioReviewChangeKind, FolioReviewComment, FolioReviewCommentFilter, FolioReviewCommentReply, FolioReviewReplyInput, applyFolioAIEditsToBuffer };
+export { ApplyFolioAIEditsToBufferOptions, ApplyFolioAIEditsToBufferResult, FolioApplyDocumentOperationsOptions, FolioApplyDocumentOperationsToStoryOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioDocxReviewer, FolioDocxReviewerOptions, FolioEditableDocumentStoryHandle, FolioGetContentAsTextOptions, type FolioReviewChange, FolioReviewChangeFilter, type FolioReviewChangeKind, FolioReviewComment, FolioReviewCommentFilter, FolioReviewCommentReply, FolioReviewReplyInput, applyFolioAIEditsToBuffer };

package/dist/ai-edits/headless.js

@@ -2,18 +2,19 @@ import { buildAnnotatedBlockText } from "./clean-text.js";
 import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
 import { applyFolioDocumentOperations } from "../document-operations.js";
 import { getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
+import { getHeaderFooterText } from "../docx/headerFooterParser.js";
+import { parseDocx } from "../docx/parser.js";
 import { deterministicHexId } from "../utils/hexId.js";
 import { repackDocx } from "../docx/rezip.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { createReply } from "../docx/replyToComment.js";
 import { attemptSelectiveSave } from "../docx/selectiveSave.js";
-import { getHeaderFooterText } from "../docx/headerFooterParser.js";
-import { parseDocx } from "../docx/parser.js";
 import { acceptAIEditRevision, acceptAllChanges, rejectAIEditRevision, rejectAllChanges } from "../prosemirror/commands/comments.js";
-import { updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
+import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
 import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { schema, singletonManager } from "../prosemirror/schema/index.js";
-import { toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
+import { headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
+import { TaggedError } from "better-result";
 import { EditorState } from "prosemirror-state";
 //#region src/ai-edits/headless.ts
 /**
@@ -33,8 +34,8 @@ import { EditorState } from "prosemirror-state";
 * paragraphs in `document.xml` (leaving every untouched part byte-exact), with
 * a full repack as the fallback for structural edits.
 *
-* Scope: BODY blocks. Footnote / endnote note-body apply is intentionally out
-* of scope here and can build on the note serialization work separately.
+* Scope: main, header, and footer blocks. Footnote and endnote bodies build on
+* the note serialization path separately.
 */
 /**
 * Standalone comment-id allocator for the reviewer. The React editor uses
@@ -114,6 +115,9 @@ const ensureDeterministicParaIdsInState = (state) => {
 	tr.setMeta("addToHistory", false);
 	return state.apply(tr);
 };
+var FolioDocumentStoryNotFoundError = class extends TaggedError("FolioDocumentStoryNotFoundError")() {};
+const MAIN_STORY = Object.freeze({ type: "main" });
+const headerFooterStoryKey = ({ type, relationshipId }) => `${type}:${relationshipId}`;
 /**
 * One LLM-ready line for a block: `[<blockId>] text`, with an `(h<level>)` tag
 * for headings and the list marker for list items, so a model can copy the
@@ -162,6 +166,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	baseDocument;
 	originalBuffer;
 	state;
+	headerFooterStoryStates = /* @__PURE__ */ new Map();
 	createdComments = [];
 	documentOperationUndoEntries = [];
 	/**
@@ -206,6 +211,11 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	snapshot() {
 		return createFolioAIEditSnapshot(this.state.doc);
 	}
+	/** Snapshot one editable story into stable, operation-ready blocks. */
+	snapshotStory(story) {
+		const state = this.getEditableStoryState(story);
+		return state ? createFolioAIEditSnapshot(state.doc) : null;
+	}
 	/**
 	* Apply operations against the current state. Reuses the live-editor applier
 	* verbatim via a headless `{ state, dispatch }` seam; the resulting state
@@ -213,10 +223,15 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	*/
 	applyOperations(operations, options = {}) {
 		const { applied, skipped } = this.applyDocumentOperationsInternal({
-			version: 1,
-			operations,
-			mode: options.mode ?? "tracked-changes"
-		}, { ...options.snapshot !== void 0 && { snapshot: options.snapshot } }, false);
+			story: MAIN_STORY,
+			batch: {
+				version: 1,
+				operations,
+				mode: options.mode ?? "tracked-changes"
+			},
+			...options.snapshot !== void 0 && { snapshot: options.snapshot },
+			createUndoEntry: false
+		});
 		return {
 			applied,
 			skipped
@@ -229,21 +244,36 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* edit semantics.
 	*/
 	applyDocumentOperations(batch, options = {}) {
-		return this.applyDocumentOperationsInternal(batch, options, true);
+		return this.applyDocumentOperationsInternal({
+			story: MAIN_STORY,
+			batch,
+			...options.snapshot !== void 0 && { snapshot: options.snapshot },
+			createUndoEntry: true
+		});
+	}
+	/** Apply a versioned operation batch to the main story, a header, or a footer. */
+	applyDocumentOperationsToStory({ story, batch, snapshot }) {
+		return this.applyDocumentOperationsInternal({
+			story,
+			batch,
+			...snapshot !== void 0 && { snapshot },
+			createUndoEntry: true
+		});
 	}
-	applyDocumentOperationsInternal(batch, options, createUndoEntry) {
-		const beforeState = this.state;
+	applyDocumentOperationsInternal({ story, batch, snapshot, createUndoEntry }) {
+		const beforeState = this.requireEditableStoryState(story);
 		const createdCommentsLengthBefore = this.createdComments.length;
 		const view = {
-			state: this.state,
+			state: beforeState,
 			dispatch: (transaction) => {
 				view.state = view.state.apply(transaction);
 			}
 		};
 		const result = applyFolioDocumentOperations({
 			view,
-			snapshot: options.snapshot ?? this.snapshot(),
+			snapshot: snapshot ?? createFolioAIEditSnapshot(beforeState.doc),
 			batch,
+			story: story.type === "main" ? "main" : story,
 			author: this.author,
 			createCommentId: (text) => {
 				const comment = createReviewerComment(text, this.author);
@@ -255,11 +285,12 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				id: `headless-${String(undoHandleCursor++)}`
 			}) }
 		});
-		this.state = view.state;
+		this.setEditableStoryState(story, view.state);
 		if (result.undoHandle !== null) this.documentOperationUndoEntries.push({
 			undoHandle: result.undoHandle,
+			story,
 			beforeState,
-			afterState: this.state,
+			afterState: view.state,
 			createdCommentsLengthBefore,
 			createdCommentsLengthAfter: this.createdComments.length
 		});
@@ -284,12 +315,12 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			undoHandle,
 			reason: "unknownHandle"
 		};
-		if (this.state !== entry.afterState || this.createdComments.length !== entry.createdCommentsLengthAfter) return {
+		if (this.requireEditableStoryState(entry.story) !== entry.afterState || this.createdComments.length !== entry.createdCommentsLengthAfter) return {
 			status: "rejected",
 			undoHandle,
 			reason: "documentChanged"
 		};
-		this.state = entry.beforeState;
+		this.setEditableStoryState(entry.story, entry.beforeState);
 		this.createdComments.length = entry.createdCommentsLengthBefore;
 		this.documentOperationUndoEntries.pop();
 		return {
@@ -331,17 +362,21 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	/**
 	* Header / footer and footnote / endnote text as labeled, LLM-ready lines,
 	* one per non-empty part: `[header default] …`, `[footer default] …`,
-	* `[footnote #N] …`, `[endnote #N] …`. Read-only — note bodies are outside
-	* the reviewer's body-only apply scope, so this reflects the parsed source.
-	* Empty parts and separator notes are omitted.
+	* `[footnote #N] …`, `[endnote #N] …`. Header and footer lines reflect
+	* in-memory edits; note bodies reflect the parsed source. Empty parts and
+	* separator notes are omitted.
 	*/
 	getNotesAsText() {
 		const pkg = this.baseDocument.package;
 		const lines = [];
 		const pushHeaderFooter = (map, label) => {
 			if (!map) return;
-			for (const hf of map.values()) {
-				const text = normalizeFolioAIBlockText(getHeaderFooterText(hf));
+			for (const [relationshipId, hf] of map) {
+				const handle = {
+					type: label,
+					relationshipId
+				};
+				const text = this.getHeaderFooterStoryText(handle, hf);
 				if (text.length > 0) lines.push(`[${label} ${hf.hdrFtrType}] ${text}`);
 			}
 		};
@@ -366,20 +401,26 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			handle: { type: "main" },
 			text: this.getContentAsText()
 		}];
-		for (const [relationshipId, header] of pkg.headers ?? []) stories.push({
-			handle: {
+		for (const [relationshipId, header] of pkg.headers ?? []) {
+			const handle = {
 				type: "header",
 				relationshipId
-			},
-			text: normalizeFolioAIBlockText(getHeaderFooterText(header))
-		});
-		for (const [relationshipId, footer] of pkg.footers ?? []) stories.push({
-			handle: {
+			};
+			stories.push({
+				handle,
+				text: this.getHeaderFooterStoryText(handle, header)
+			});
+		}
+		for (const [relationshipId, footer] of pkg.footers ?? []) {
+			const handle = {
 				type: "footer",
 				relationshipId
-			},
-			text: normalizeFolioAIBlockText(getHeaderFooterText(footer))
-		});
+			};
+			stories.push({
+				handle,
+				text: this.getHeaderFooterStoryText(handle, footer)
+			});
+		}
 		for (const footnote of pkg.footnotes ?? []) if (!isSeparatorFootnote(footnote)) stories.push({
 			handle: {
 				type: "footnote",
@@ -537,6 +578,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	/** The current document model with edits merged back in. */
 	toDocument() {
 		const document = updateDocumentContent(this.baseDocument, this.state.doc);
+		this.mergeEditedHeaderFooterStories(document);
 		if (this.createdComments.length > 0 || this.resolvedOverrides.size > 0) document.package.document.comments = this.withResolvedOverrides([...document.package.document.comments ?? [], ...this.createdComments]);
 		return document;
 	}
@@ -572,6 +614,77 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			return null;
 		}
 	}
+	getEditableStoryState(story) {
+		if (story.type === "main") return this.state;
+		const key = headerFooterStoryKey(story);
+		const existing = this.headerFooterStoryStates.get(key);
+		if (existing) return existing.state;
+		const source = this.getHeaderFooterStory(story);
+		if (!source) return null;
+		const state = ensureDeterministicParaIdsInState(EditorState.create({
+			schema,
+			doc: headerFooterToProseDoc(source.content, {
+				...this.baseDocument.package.styles !== void 0 && { styles: this.baseDocument.package.styles },
+				...this.baseDocument.package.theme !== void 0 && { theme: this.baseDocument.package.theme }
+			}),
+			plugins: singletonManager.getPlugins()
+		}));
+		this.headerFooterStoryStates.set(key, {
+			handle: story,
+			initialState: state,
+			state
+		});
+		return state;
+	}
+	requireEditableStoryState(story) {
+		const state = this.getEditableStoryState(story);
+		if (state) return state;
+		throw new FolioDocumentStoryNotFoundError({
+			message: `Document story ${JSON.stringify(story)} was not found.`,
+			story
+		});
+	}
+	setEditableStoryState(story, state) {
+		if (story.type === "main") {
+			this.state = state;
+			return;
+		}
+		const entry = this.headerFooterStoryStates.get(headerFooterStoryKey(story));
+		if (!entry) throw new FolioDocumentStoryNotFoundError({
+			message: `Document story ${JSON.stringify(story)} was not found.`,
+			story
+		});
+		entry.state = state;
+	}
+	getHeaderFooterStory(story) {
+		return (story.type === "header" ? this.baseDocument.package.headers : this.baseDocument.package.footers)?.get(story.relationshipId);
+	}
+	getHeaderFooterStoryText(story, source) {
+		const state = this.headerFooterStoryStates.get(headerFooterStoryKey(story))?.state;
+		return normalizeFolioAIBlockText(state?.doc.textContent ?? getHeaderFooterText(source));
+	}
+	mergeEditedHeaderFooterStories(document) {
+		let headers;
+		let footers;
+		for (const entry of this.headerFooterStoryStates.values()) {
+			if (entry.state === entry.initialState) continue;
+			const source = this.getHeaderFooterStory(entry.handle);
+			if (!source) continue;
+			const edited = {
+				...source,
+				content: proseDocToBlocks(entry.state.doc)
+			};
+			if (entry.handle.type === "header") {
+				headers ??= new Map(document.package.headers);
+				headers.set(entry.handle.relationshipId, edited);
+				continue;
+			}
+			footers ??= new Map(document.package.footers);
+			footers.set(entry.handle.relationshipId, edited);
+		}
+		if (headers) document.package.headers = headers;
+		if (footers) document.package.footers = footers;
+	}
 	/**
 	* Count every tracked change an accept-all / reject-all sweep resolves: the
 	* inline insertion / deletion groups {@link getChanges} enumerates, plus the
@@ -654,4 +767,4 @@ const applyFolioAIEditsToBuffer = async (buffer, operations, options = {}) => {
 	};
 };
 //#endregion
-export { FolioDocxReviewer, applyFolioAIEditsToBuffer };
+export { FolioDocumentStoryNotFoundError, FolioDocxReviewer, applyFolioAIEditsToBuffer };

package/dist/ai-edits/index.d.ts

@@ -2,11 +2,11 @@ import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreview
 import { FolioAIEditView, applyFolioAIEditOperations } from "./apply.js";
 import { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange } from "./blockRange.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
-import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
+import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { FolioCommentAnchor, FolioReviewChange, FolioReviewChangeKind, getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
-import { FolioDocumentStory, FolioDocumentStoryHandle } from "./headless.js";
+import { FolioApplyDocumentOperationsToStoryOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioEditableDocumentStoryHandle } from "./headless.js";
 import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./snapshot.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
 import { WordDiffSegment, diffWordSegments } from "./word-diff.js";
-export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineFormatting, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioCommentAnchor, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, type FolioReviewChange, type FolioReviewChangeKind, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange };
+export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineFormatting, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioReviewChange, type FolioReviewChangeKind, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange };

package/dist/ai-edits/index.js

@@ -7,4 +7,5 @@ import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT
 import { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange } from "./blockRange.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
-export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange };
+import { FolioDocumentStoryNotFoundError } from "./headless.js";
+export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentStoryNotFoundError, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange };

package/dist/ai-edits/snapshot.js

@@ -22,12 +22,28 @@ const createFolioAIEditSnapshot = (doc) => {
 	const draftBlocks = [];
 	const hashCounts = /* @__PURE__ */ new Map();
 	const usedBlockIds = /* @__PURE__ */ new Set();
+	const emptyAnchorState = {
+		candidate: null,
+		textblockCount: 0
+	};
 	let blockIndex = 0;
-	doc.descendants((node, pos) => {
+	doc.descendants((node, pos, parent) => {
 		if (!node.isTextblock) return;
 		const { text } = buildCleanBlockText(node, pos);
 		const normalizedText = normalizeFolioAIBlockText(text);
-		if (normalizedText.length === 0) return;
+		if (normalizedText.length === 0) {
+			if (parent?.type !== doc.type) return;
+			emptyAnchorState.textblockCount++;
+			if (emptyAnchorState.candidate === null) {
+				const paraIdAttr = node.attrs["paraId"];
+				emptyAnchorState.candidate = {
+					from: pos,
+					to: pos + node.nodeSize,
+					paraId: typeof paraIdAttr === "string" && paraIdAttr.length > 0 ? paraIdAttr : null
+				};
+			}
+			return;
+		}
 		const textHash = hashFolioAIBlockText(normalizedText);
 		hashCounts.set(textHash, (hashCounts.get(textHash) ?? 0) + 1);
 		blockIndex++;
@@ -72,10 +88,31 @@ const createFolioAIEditSnapshot = (doc) => {
 			hashOccurrenceCount: hashCounts.get(draft.anchor.textHash) ?? 0
 		};
 	}
-	return {
+	const emptyAnchorCandidate = emptyAnchorState.candidate;
+	if (blocks.length > 0 || emptyAnchorCandidate === null) return {
 		blocks,
 		anchors
 	};
+	const emptyDocumentAnchorId = deriveBlockId({
+		paraId: emptyAnchorCandidate.paraId,
+		index: 1,
+		taken: usedBlockIds
+	});
+	const normalizedText = "";
+	anchors[emptyDocumentAnchorId] = {
+		id: emptyDocumentAnchorId,
+		from: emptyAnchorCandidate.from,
+		to: emptyAnchorCandidate.to,
+		text: "",
+		normalizedText,
+		textHash: hashFolioAIBlockText(normalizedText),
+		hashOccurrenceCount: emptyAnchorState.textblockCount
+	};
+	return {
+		blocks,
+		anchors,
+		emptyDocumentAnchorId
+	};
 };
 const getBlockKind = (node, headingLevel) => {
 	const listMarker = node.attrs["listMarker"];

package/dist/ai-edits/types.d.ts

@@ -21,7 +21,8 @@ type FolioAIBlock = {
 };
 type FolioAIEditSnapshot = {
   blocks: FolioAIBlock[];
-  anchors: Record<string, FolioAIBlockAnchor>;
+  anchors: Record<string, FolioAIBlockAnchor>; /** Hidden empty paragraph used to anchor insertions when `blocks` is empty. */
+  emptyDocumentAnchorId?: string;
 };
 type FolioAIBlockAnchor = {
   id: string;

package/dist/compat/eigenpal.d.ts

@@ -1,7 +1,7 @@
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty } from "../ai-edits/types.js";
 import { applyFolioAIEditOperations } from "../ai-edits/apply.js";
 import { document_d_exports } from "../types/document.js";
-import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
+import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "../ai-edits/snapshot.js";
 import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
 import { WordDiffSegment, diffWordSegments } from "../ai-edits/word-diff.js";
@@ -9,10 +9,12 @@ import { AIBarStatus, AIChatMode, AICitation, AICitationSource, AIGenerateInput,
 import { ApplyResult, applySuggestions } from "../ai-suggestions/apply.js";
 import { ResolvedAnchor, isSuggestionStale, resolveSuggestionAnchor } from "../ai-suggestions/conflict.js";
 import { PositionalText, buildPositionalText } from "../ai-suggestions/text-positions.js";
+import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocumentPreset, DocumentStyleSet } from "../style-sets/types.js";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "../utils/createDocument.js";
+import { DocumentStyleCatalog, DocumentStyleCatalogEntry, ExtractDocumentStyleSetOptions, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "../style-sets/extract.js";
+import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "../style-sets/stellaStyle.js";
 import { createDocx } from "../docx/rezip.js";
-import { FOLIO_DOCX_CAPABILITY_HOSTS, FOLIO_DOCX_CAPABILITY_IDS, FOLIO_DOCX_CAPABILITY_MANIFEST, FOLIO_DOCX_CAPABILITY_MANIFEST_VERSION, FOLIO_DOCX_CAPABILITY_OPERATIONS, FOLIO_DOCX_COMPATIBILITY_HOSTS, FOLIO_DOCX_COMPATIBILITY_PROFILES, FOLIO_DOCX_PROFILES, FOLIO_DOCX_SUPPORT_STATES, FolioDocxCapabilityHost, FolioDocxCapabilityId, FolioDocxCapabilityManifest, FolioDocxCapabilityOperation, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, FolioDocxFeatureCapability, FolioDocxProfile, FolioDocxSupportState, InvalidFolioDocxCapabilityIdError, getFolioDocxCapability, isFolioDocxCapabilityId } from "../docx/capabilities.js";
-import { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, InspectDocxCompatibilityOptions, inspectDocxCompatibility } from "../docx/compatibility.js";
+import { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility } from "../docx/compatibility.js";
 import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
 import { scrollFolioPositionIntoView } from "../paged-layout/scrollToPmPosition.js";
 import { getFolioCaretViewportRect, getFolioSelectionViewportRect } from "../paged-layout/selectionViewportRect.js";
@@ -30,4 +32,4 @@ import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResol
 import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCX_CAPABILITY_HOSTS, FOLIO_DOCX_CAPABILITY_IDS, FOLIO_DOCX_CAPABILITY_MANIFEST, FOLIO_DOCX_CAPABILITY_MANIFEST_VERSION, FOLIO_DOCX_CAPABILITY_OPERATIONS, FOLIO_DOCX_COMPATIBILITY_HOSTS, FOLIO_DOCX_COMPATIBILITY_PROFILES, FOLIO_DOCX_PROFILES, FOLIO_DOCX_SUPPORT_STATES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCapabilityHost, type FolioDocxCapabilityId, type FolioDocxCapabilityManifest, type FolioDocxCapabilityOperation, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioDocxFeatureCapability, type FolioDocxProfile, type FolioDocxSupportState, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocxCapabilityIdError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocxCapability, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocxCapabilityId, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };