@stll/folio-core 0.6.1 → 0.8.0

package/dist/prosemirror/extensions/features/ParaIdAllocatorExtension.js

@@ -4,26 +4,76 @@ import { ignoreTrackedChanges } from "./ParagraphChangeTrackerExtension.js";
 import { Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.ts
 const paraIdAllocatorKey = new PluginKey("paraIdAllocator");
-const collectParaIdUpdates = (doc) => {
-	const seen = /* @__PURE__ */ new Set();
-	const updates = [];
+const isUsableParaId = (value) => typeof value === "string" && value.length > 0 && value !== "00000000";
+/**
+* For every valid paraId in the pre-transaction doc, the position its
+* paragraph ends up at after `transactions` — the occurrence that
+* rightfully keeps the id when the new doc holds duplicates. Ids whose
+* paragraph start was deleted by the steps are left out.
+*/
+const mapKeeperPositions = (oldDoc, transactions) => {
+	const keepers = /* @__PURE__ */ new Map();
+	oldDoc.descendants((node, pos) => {
+		if (node.type.name !== "paragraph") return true;
+		const id = node.attrs["paraId"];
+		if (!isUsableParaId(id) || keepers.has(id)) return false;
+		let mapped = pos;
+		let deleted = false;
+		for (const tr of transactions) {
+			const result = tr.mapping.mapResult(mapped);
+			if (result.deleted) {
+				deleted = true;
+				break;
+			}
+			mapped = result.pos;
+		}
+		if (!deleted) keepers.set(id, mapped);
+		return false;
+	});
+	return keepers;
+};
+const collectParaIdUpdates = (doc, keeperPositions) => {
+	const missing = [];
+	const occurrencesById = /* @__PURE__ */ new Map();
 	doc.descendants((node, pos) => {
-		if (node.type.name !== "paragraph") return;
+		if (node.type.name !== "paragraph") return true;
 		const id = node.attrs["paraId"];
-		if (typeof id !== "string" || id.length === 0 || seen.has(id)) {
-			let newId = generateHexId();
-			while (seen.has(newId)) newId = generateHexId();
-			seen.add(newId);
-			updates.push({
+		if (!isUsableParaId(id)) missing.push({
+			pos,
+			attrs: node.attrs
+		});
+		else {
+			const occurrences = occurrencesById.get(id) ?? [];
+			occurrences.push({
 				pos,
-				attrs: {
-					...node.attrs,
-					paraId: newId
-				}
+				attrs: node.attrs
 			});
-		} else seen.add(id);
+			occurrencesById.set(id, occurrences);
+		}
 		return false;
 	});
+	const needFreshId = [...missing];
+	for (const [id, occurrences] of occurrencesById) {
+		if (occurrences.length === 1) continue;
+		const keeperPos = keeperPositions?.get(id);
+		const keeper = occurrences.find((occurrence) => occurrence.pos === keeperPos) ?? occurrences[0];
+		for (const occurrence of occurrences) if (occurrence !== keeper) needFreshId.push(occurrence);
+	}
+	const taken = new Set(occurrencesById.keys());
+	const updates = [];
+	for (const { pos, attrs } of needFreshId) {
+		let newId = generateHexId();
+		while (taken.has(newId)) newId = generateHexId();
+		taken.add(newId);
+		updates.push({
+			pos,
+			attrs: {
+				...attrs,
+				paraId: newId
+			}
+		});
+	}
+	updates.sort((a, b) => a.pos - b.pos);
 	return updates;
 };
 const ensureParaIdsInState = (state) => {
@@ -38,12 +88,14 @@ const ensureParaIdsInState = (state) => {
 };
 const createParaIdAllocatorPlugin = () => new Plugin({
 	key: paraIdAllocatorKey,
-	appendTransaction(transactions, _oldState, newState) {
+	appendTransaction(transactions, oldState, newState) {
 		if (!transactions.some((t) => t.docChanged)) return null;
-		const updates = collectParaIdUpdates(newState.doc);
+		const keeperPositions = mapKeeperPositions(oldState.doc, transactions);
+		const updates = collectParaIdUpdates(newState.doc, keeperPositions);
 		if (updates.length === 0) return null;
 		const tr = newState.tr;
 		for (const u of updates) tr.setNodeMarkup(u.pos, void 0, u.attrs);
+		ignoreTrackedChanges(tr);
 		tr.setMeta(paraIdAllocatorKey, "allocated");
 		tr.setMeta("addToHistory", false);
 		return tr;

package/dist/prosemirror/extensions/nodes/TableExtension.js

@@ -152,6 +152,7 @@ const tableSpec = {
 		cellMargins: { default: null },
 		look: { default: null },
 		borders: { default: null },
+		_resolvedIndent: { default: null },
 		_originalFormatting: { default: null },
 		tblPrChange: { default: null }
 	},

package/dist/prosemirror/extensions/nodes/TextBoxExtension.d.ts

@@ -6,7 +6,8 @@ import { ImagePositionAttrs } from "../../schema/nodes.js";
 //#region src/prosemirror/extensions/nodes/TextBoxExtension.d.ts
 type TextBoxAttrs = {
   /** Width in pixels */width?: number; /** Height in pixels */
-  height?: number; /** Unique identifier */
+  height?: number; /** Text fitting behavior */
+  autoFit?: document_d_exports.ShapeTextBody["autoFit"]; /** Unique identifier */
   textBoxId?: string; /** Fill color as CSS color */
   fillColor?: string; /** Outline width in pixels */
   outlineWidth?: number; /** Outline color as CSS color */

package/dist/prosemirror/extensions/nodes/TextBoxExtension.js

@@ -15,6 +15,9 @@ function parseTextBoxPosition(raw) {
 function parseTextBoxWrapType(raw) {
 	for (const value of IMAGE_WRAP_TYPE_VALUES) if (value === raw) return value;
 }
+function parseTextBoxAutoFit(raw) {
+	if (raw === "none" || raw === "normal" || raw === "shape") return raw;
+}
 const TextBoxExtension = createNodeExtension({
 	name: "textBox",
 	schemaNodeName: "textBox",
@@ -26,6 +29,7 @@ const TextBoxExtension = createNodeExtension({
 		attrs: {
 			width: { default: 200 },
 			height: { default: null },
+			autoFit: { default: null },
 			textBoxId: { default: null },
 			fillColor: { default: null },
 			outlineWidth: { default: null },
@@ -55,9 +59,11 @@ const TextBoxExtension = createNodeExtension({
 				const d = dom.dataset;
 				const position = parseTextBoxPosition(d["position"]);
 				const wrapType = parseTextBoxWrapType(d["wrapType"]);
+				const autoFit = parseTextBoxAutoFit(d["autoFit"]);
 				return {
 					...d["width"] ? { width: Number(d["width"]) } : {},
 					...d["height"] ? { height: Number(d["height"]) } : {},
+					...autoFit ? { autoFit } : {},
 					...d["textboxId"] ? { textBoxId: d["textboxId"] } : {},
 					...d["fillColor"] ? { fillColor: d["fillColor"] } : {},
 					...d["outlineWidth"] ? { outlineWidth: Number(d["outlineWidth"]) } : {},
@@ -85,6 +91,7 @@ const TextBoxExtension = createNodeExtension({
 			const domAttrs = { class: "docx-textbox" };
 			if (attrs.width) domAttrs["data-width"] = String(attrs.width);
 			if (attrs.height) domAttrs["data-height"] = String(attrs.height);
+			if (attrs.autoFit) domAttrs["data-auto-fit"] = attrs.autoFit;
 			if (attrs.textBoxId) domAttrs["data-textbox-id"] = attrs.textBoxId;
 			if (attrs.fillColor) domAttrs["data-fill-color"] = attrs.fillColor;
 			if (attrs.outlineWidth) domAttrs["data-outline-width"] = String(attrs.outlineWidth);

package/dist/prosemirror/schema/nodes.d.ts

@@ -46,7 +46,8 @@ type ParagraphAttrs = {
   listMarker?: string; /** Whether the list marker is hidden (w:vanish on numbering level rPr) */
   listMarkerHidden?: boolean; /** Marker font family from numbering level rPr */
   listMarkerFontFamily?: string; /** Marker font size from numbering level rPr, in points */
-  listMarkerFontSize?: number;
+  listMarkerFontSize?: number; /** Horizontal alignment of the marker around the paragraph's list anchor. */
+  listMarkerAlignment?: "left" | "center" | "right";
   /**
    * `w:suff` (§17.9.25) — what follows the marker before body text.
    * `tab` (default) grows the marker to the next tab stop; `space` adds one
@@ -307,7 +308,8 @@ type ShapeAttrs = {
  */
 type TextBoxAttrs = {
   /** Width in pixels */width?: number; /** Height in pixels */
-  height?: number; /** Unique identifier */
+  height?: number; /** Text fitting behavior */
+  autoFit?: document_d_exports.ShapeTextBody["autoFit"]; /** Unique identifier */
   textBoxId?: string; /** Fill color as CSS color */
   fillColor?: string; /** Outline width in pixels */
   outlineWidth?: number; /** Outline color as CSS color */
@@ -347,7 +349,8 @@ type TableAttrs = {
     right?: number;
   }; /** Table look flags for conditional formatting (w:tblLook) */
   look?: document_d_exports.TableLook; /** Table-level borders (w:tblBorders) — full BorderSpec per side */
-  borders?: document_d_exports.TableBorders; /** Original table formatting from DOCX for lossless round-trip serialization */
+  borders?: document_d_exports.TableBorders; /** Effective table indent after style resolution. PM-only; never serialized. */
+  _resolvedIndent?: NonNullable<document_d_exports.TableFormatting["indent"]>; /** Original table formatting from DOCX for lossless round-trip serialization */
   _originalFormatting?: document_d_exports.TableFormatting; /** Tracked table property changes (w:tblPrChange) for round-trip + accept/reject */
   tblPrChange?: document_d_exports.TablePropertyChange[];
 };

package/dist/prosemirror/styles/resolvedStyleAttrs.js

@@ -86,6 +86,7 @@ function listAttrsFromResolvedStyle(resolved, numbering) {
 		listMarkerHidden: rendering?.markerHidden ?? null,
 		listMarkerFontFamily: rendering?.markerFontFamily ?? null,
 		listMarkerFontSize: rendering?.markerFontSize ?? null,
+		listMarkerAlignment: rendering?.markerAlignment ?? null,
 		listMarkerSuffix: rendering?.markerSuffix ?? null,
 		listMarkerAllCaps: rendering?.markerAllCaps ?? null,
 		listImplicitChildLevelAdvances: null,

package/dist/prosemirror/utils/tabCalculator.js

@@ -105,7 +105,7 @@ function calculateTabWidth(currentXPx, context, following = {}) {
 		...nextStop.leader !== void 0 ? { leader: nextStop.leader } : {},
 		alignment: "bar"
 	};
-	if (width < 1) {
+	if (width <= 0) {
 		const defaultTabPx = twipsToPixels(defaultTabInterval);
 		let fallbackWidth = defaultTabPx - currentXPx % defaultTabPx;
 		if (fallbackWidth <= 0) fallbackWidth = defaultTabPx;

package/dist/server.d.ts

@@ -1,12 +1,16 @@
-import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAITextRangeHandle } from "./ai-edits/types.js";
+import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./ai-edits/types.js";
 import { 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, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { FolioReviewChange, FolioReviewChangeKind } from "./ai-edits/read.js";
 import { ApplyFolioAIEditsToBufferOptions, ApplyFolioAIEditsToBufferResult, FolioApplyDocumentOperationsOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocxReviewer, FolioDocxReviewerOptions, FolioReviewChangeFilter, FolioReviewComment, FolioReviewCommentFilter, FolioReviewCommentReply, FolioReviewReplyInput, applyFolioAIEditsToBuffer } from "./ai-edits/headless.js";
 import { createFolioAITextRangeHandle } from "./ai-edits/snapshot.js";
+import { getFolioDocumentOutline, readFolioDocumentSection } from "./ai-edits/scoped-reading.js";
 import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createDocument.js";
 import { createDocx } from "./docx/rezip.js";
+import { EnsureParaIdsError, EnsureParaIdsOptions, EnsureParaIdsResult, ensureParaIds } from "./docx/ensureParaIds.js";
 import { CreateCommentReplyInput, replyToComment } from "./docx/replyToComment.js";
+import { DocxArchiveError } from "./docx/server/boundedArchive.js";
+import { DocxParagraphSource, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText } from "./docx/server/extractDocxText.js";
 import { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, generateRedlineDocx } from "./redline.js";
 import { FolioBlockDiff, FolioFormatProperty, FolioVersionDiff, FolioVersionDiffSegment, compareDocxVersions } from "./version-comparison.js";
-export { type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, type DeriveBlockIdInput, 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 FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, 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 FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioFormatProperty, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioVersionDiff, type FolioVersionDiffSegment, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditsToBuffer, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, deriveBlockId, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, replyToComment };
+export { type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, type DeriveBlockIdInput, DocxArchiveError, type DocxParagraphSource, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type ExtractedDocxParagraph, type ExtractedDocxText, 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 FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, 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, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioFormatProperty, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioVersionDiff, type FolioVersionDiffSegment, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditsToBuffer, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, deriveBlockId, ensureParaIds, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment };

package/dist/server.js

@@ -3,8 +3,12 @@ import { createFolioAITextRangeHandle } from "./ai-edits/snapshot.js";
 import { 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, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { createEmptyDocument } from "./utils/createDocument.js";
 import { createDocx } from "./docx/rezip.js";
+import { getFolioDocumentOutline, readFolioDocumentSection } from "./ai-edits/scoped-reading.js";
 import { replyToComment } from "./docx/replyToComment.js";
 import { FolioDocxReviewer, applyFolioAIEditsToBuffer } from "./ai-edits/headless.js";
 import { compareDocxVersions } from "./version-comparison.js";
 import { generateRedlineDocx } from "./redline.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, FolioDocxReviewer, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditsToBuffer, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, deriveBlockId, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, replyToComment };
+import { EnsureParaIdsError, ensureParaIds } from "./docx/ensureParaIds.js";
+import { DocxArchiveError } from "./docx/server/boundedArchive.js";
+import { extractDocxText } from "./docx/server/extractDocxText.js";
+export { DocxArchiveError, EnsureParaIdsError, 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, FolioDocxReviewer, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditsToBuffer, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, deriveBlockId, ensureParaIds, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment };

package/dist/types/index.d.ts

@@ -13,6 +13,7 @@ type ConditionalFormatStyle = document_d_exports.ConditionalFormatStyle;
 type DocDefaults = document_d_exports.DocDefaults;
 type Document = document_d_exports.Document;
 type DocumentBody = document_d_exports.DocumentBody;
+type DocxConformanceClass = document_d_exports.DocxConformanceClass;
 type DocxPackage = document_d_exports.DocxPackage;
 type DrawingContent = document_d_exports.DrawingContent;
 type EmphasisMark = document_d_exports.EmphasisMark;
@@ -104,4 +105,4 @@ type ThemeFont = document_d_exports.ThemeFont;
 type ThemeFontScheme = document_d_exports.ThemeFontScheme;
 type UnderlineStyle = document_d_exports.UnderlineStyle;
 type VerticalAlign = document_d_exports.VerticalAlign;
-export type { AbstractNumbering, BlockContent, BookmarkEnd, BookmarkStart, BorderSpec, BreakContent, CellMargins, ColorValue, Column, ComplexField, ConditionalFormatStyle, DocDefaults, Document, DocumentBody, DocxPackage, DrawingContent, EmphasisMark, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FloatingTableProperties, FontInfo, FontTable, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InstrTextContent, LevelSuffix, LineNumberRestart, LineSpacingRule, ListLevel, ListRendering, MediaFile, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, NumberFormat, NumberingDefinitions, NumberingInstance, PageOrientation, Paragraph, ParagraphAlignment, ParagraphContent, ParagraphFormatting, Relationship, RelationshipMap, RelationshipType, Run, RunContent, Section, SectionProperties, SectionStart, ShadingProperties, Shape, ShapeContent, ShapeFill, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, Style, StyleDefinitions, StyleType, SymbolContent, TabContent, TabLeader, TabStop, TabStopAlignment, Table, TableBorders, TableCell, TableCellFormatting, TableFormatting, TableLook, TableMeasurement, TableRow, TableRowFormatting, TableWidthType, TextBox, TextContent, TextEffect, TextFormatting, Theme, ThemeColorScheme, ThemeColorSlot, ThemeFont, ThemeFontScheme, UnderlineStyle, VerticalAlign };
+export type { AbstractNumbering, BlockContent, BookmarkEnd, BookmarkStart, BorderSpec, BreakContent, CellMargins, ColorValue, Column, ComplexField, ConditionalFormatStyle, DocDefaults, Document, DocumentBody, DocxConformanceClass, DocxPackage, DrawingContent, EmphasisMark, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FloatingTableProperties, FontInfo, FontTable, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InstrTextContent, LevelSuffix, LineNumberRestart, LineSpacingRule, ListLevel, ListRendering, MediaFile, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, NumberFormat, NumberingDefinitions, NumberingInstance, PageOrientation, Paragraph, ParagraphAlignment, ParagraphContent, ParagraphFormatting, Relationship, RelationshipMap, RelationshipType, Run, RunContent, Section, SectionProperties, SectionStart, ShadingProperties, Shape, ShapeContent, ShapeFill, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, Style, StyleDefinitions, StyleType, SymbolContent, TabContent, TabLeader, TabStop, TabStopAlignment, Table, TableBorders, TableCell, TableCellFormatting, TableFormatting, TableLook, TableMeasurement, TableRow, TableRowFormatting, TableWidthType, TextBox, TextContent, TextEffect, TextFormatting, Theme, ThemeColorScheme, ThemeColorSlot, ThemeFont, ThemeFontScheme, UnderlineStyle, VerticalAlign };

package/dist/utils/createDocument.js

@@ -1,5 +1,11 @@
+import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 //#region src/utils/createDocument.ts
 /**
+* Create Document Utility
+*
+* Provides functions to create new documents programmatically.
+*/
+/**
 * Get default paragraph styles (matching Google Docs defaults)
 *
 * Font sizes are in half-points (e.g., 22 = 11pt, 40 = 20pt)
@@ -207,26 +213,28 @@ function createEmptyDocument(options = {}) {
 		type: "text",
 		text: options.initialText || ""
 	};
+	const documentBody = {
+		content: [{
+			type: "paragraph",
+			content: [{
+				type: "run",
+				content: options.initialText ? [textContent] : [],
+				formatting: {
+					fontSize: 22,
+					fontFamily: {
+						ascii: "Arial",
+						hAnsi: "Arial"
+					}
+				}
+			}],
+			formatting: { lineSpacing: 276 }
+		}],
+		finalSectionProperties: sectionProps
+	};
 	return {
 		package: {
-			document: {
-				content: [{
-					type: "paragraph",
-					content: [{
-						type: "run",
-						content: options.initialText ? [textContent] : [],
-						formatting: {
-							fontSize: 22,
-							fontFamily: {
-								ascii: "Arial",
-								hAnsi: "Arial"
-							}
-						}
-					}],
-					formatting: { lineSpacing: 276 }
-				}],
-				finalSectionProperties: sectionProps
-			},
+			conformanceClass: DOCX_CONFORMANCE_CLASSES.TRANSITIONAL,
+			document: documentBody,
 			styles: {
 				docDefaults: {
 					rPr: {

package/dist/utils/formatToStyle.js

@@ -1,4 +1,4 @@
-import { eighthsToPixels, formatPx, halfPointsToPixels, halfPointsToPoints, twipsToPixels } from "./units.js";
+import { AUTO_PARAGRAPH_SPACING_PX, eighthsToPixels, formatPx, halfPointsToPixels, halfPointsToPoints, twipsToPixels } from "./units.js";
 import { resolveFontFamily, resolveThemeFont } from "./fontResolver.js";
 import { resolveColor, resolveHighlightToCss, resolveShadingColor } from "./colorResolver.js";
 //#region src/utils/formatToStyle.ts
@@ -89,9 +89,9 @@ function paragraphToStyle(formatting, theme) {
 	if (!formatting) return {};
 	const style = {};
 	if (formatting.alignment) style.textAlign = mapAlignment(formatting.alignment);
-	if (formatting.beforeAutospacing) style.marginTop = formatPx(14);
+	if (formatting.beforeAutospacing) style.marginTop = formatPx(AUTO_PARAGRAPH_SPACING_PX);
 	else if (formatting.spaceBefore !== void 0) style.marginTop = formatPx(twipsToPixels(formatting.spaceBefore));
-	if (formatting.afterAutospacing) style.marginBottom = formatPx(14);
+	if (formatting.afterAutospacing) style.marginBottom = formatPx(AUTO_PARAGRAPH_SPACING_PX);
 	else if (formatting.spaceAfter !== void 0) style.marginBottom = formatPx(twipsToPixels(formatting.spaceAfter));
 	if (formatting.lineSpacing !== void 0 && formatting.lineSpacing > 0) if (formatting.lineSpacingRule === "exact") {
 		const exactPx = twipsToPixels(formatting.lineSpacing);

package/dist/utils/hexId.d.ts

@@ -3,6 +3,8 @@
  * Lifted from
  * https://github.com/eigenpal/docx-editor/blob/main/packages/core/src/utils/hexId.ts
  * (Apache-2.0). Keep the bound and the comments in sync upstream.
+ * folio divergence: `00000000` is excluded from both generators — Word
+ * treats a zero `w14:paraId` as unassigned, so it must never be minted.
  */
 /**
  * Strictest OOXML `ST_LongHexNumber` upper bound (exclusive) across the
@@ -17,7 +19,8 @@ declare const MAX_HEX_ID_EXCLUSIVE = 2147483647;
  * Random 8-char uppercase hex id, matching Microsoft's `w14:paraId`
  * extension format (also reused for comment `paraId` / `durableId`).
  *
- * Range is `[0, MAX_HEX_ID_EXCLUSIVE)` = `[0, 0x7FFFFFFE]`.
+ * Range is `[1, MAX_HEX_ID_EXCLUSIVE)` = `[1, 0x7FFFFFFE]` — zero is
+ * excluded because Word reads `w14:paraId="00000000"` as "no id".
  *
  * Uses `Math.random()` rather than `crypto.randomUUID()` so the
  * generator works in non-secure contexts (file://, web workers).
@@ -27,6 +30,10 @@ declare const generateHexId: () => string;
  * Deterministic 8-char uppercase hex id (FNV-1a over `seed`), `< 0x7FFFFFFF`.
  * Re-deriving from the same seed mints the same id, so content/position-derived
  * ids (block paraIds, comment thread keys) are stable across saves.
+ *
+ * A hash of exactly zero is remapped to `1`: `00000000` is Word's "no id"
+ * sentinel, and remapping only that one (already invalid) output keeps every
+ * previously shipped deterministic id unchanged.
  */
 declare const deterministicHexId: (seed: string) => string;
 //#endregion

package/dist/utils/hexId.js

@@ -3,6 +3,8 @@
 * Lifted from
 * https://github.com/eigenpal/docx-editor/blob/main/packages/core/src/utils/hexId.ts
 * (Apache-2.0). Keep the bound and the comments in sync upstream.
+* folio divergence: `00000000` is excluded from both generators — Word
+* treats a zero `w14:paraId` as unassigned, so it must never be minted.
 */
 /**
 * Strictest OOXML `ST_LongHexNumber` upper bound (exclusive) across the
@@ -17,21 +19,27 @@ const MAX_HEX_ID_EXCLUSIVE = 2147483647;
 * Random 8-char uppercase hex id, matching Microsoft's `w14:paraId`
 * extension format (also reused for comment `paraId` / `durableId`).
 *
-* Range is `[0, MAX_HEX_ID_EXCLUSIVE)` = `[0, 0x7FFFFFFE]`.
+* Range is `[1, MAX_HEX_ID_EXCLUSIVE)` = `[1, 0x7FFFFFFE]` — zero is
+* excluded because Word reads `w14:paraId="00000000"` as "no id".
 *
 * Uses `Math.random()` rather than `crypto.randomUUID()` so the
 * generator works in non-secure contexts (file://, web workers).
 */
-const generateHexId = () => Math.floor(Math.random() * MAX_HEX_ID_EXCLUSIVE).toString(16).toUpperCase().padStart(8, "0");
+const generateHexId = () => (Math.floor(Math.random() * (MAX_HEX_ID_EXCLUSIVE - 1)) + 1).toString(16).toUpperCase().padStart(8, "0");
 /**
 * Deterministic 8-char uppercase hex id (FNV-1a over `seed`), `< 0x7FFFFFFF`.
 * Re-deriving from the same seed mints the same id, so content/position-derived
 * ids (block paraIds, comment thread keys) are stable across saves.
+*
+* A hash of exactly zero is remapped to `1`: `00000000` is Word's "no id"
+* sentinel, and remapping only that one (already invalid) output keeps every
+* previously shipped deterministic id unchanged.
 */
 const deterministicHexId = (seed) => {
 	let hash = 2166136261;
 	for (const character of seed) hash = Math.imul(hash ^ (character.codePointAt(0) ?? 0), 16777619) >>> 0;
-	return (hash % MAX_HEX_ID_EXCLUSIVE).toString(16).toUpperCase().padStart(8, "0");
+	const value = hash % MAX_HEX_ID_EXCLUSIVE;
+	return (value === 0 ? 1 : value).toString(16).toUpperCase().padStart(8, "0");
 };
 //#endregion
 export { MAX_HEX_ID_EXCLUSIVE, deterministicHexId, generateHexId };

package/dist/utils/units.d.ts

@@ -13,16 +13,16 @@
  */
 /** Twips per inch (1 inch = 1440 twips) */
 declare const TWIPS_PER_INCH = 1440;
+/** Pixels per inch at standard DPI */
+declare const PIXELS_PER_INCH = 96;
 /**
  * Word's auto paragraph spacing in px. HTML-origin paragraphs use
  * `w:beforeAutospacing`/`w:afterAutospacing` instead of explicit before/after;
- * Word ignores any explicit value on such paragraphs and renders ~14px. The
- * value is empirical (Word's rendered auto gap), not derivable from a twips
- * conversion. See eigenpal/docx-editor#823.
+ * Word ignores any explicit value on such paragraphs and renders a 14pt gap.
+ * The value is empirical (Word's rendered auto gap), not derivable from a
+ * twips conversion. See eigenpal/docx-editor#823.
  */
-declare const AUTO_PARAGRAPH_SPACING_PX = 14;
-/** Pixels per inch at standard DPI */
-declare const PIXELS_PER_INCH = 96;
+declare const AUTO_PARAGRAPH_SPACING_PX: number;
 /**
  * Convert twips to pixels (at 96 DPI)
  *

package/dist/utils/units.js

@@ -15,14 +15,6 @@
 const STANDARD_DPI = 96;
 /** Twips per inch (1 inch = 1440 twips) */
 const TWIPS_PER_INCH = 1440;
-/**
-* Word's auto paragraph spacing in px. HTML-origin paragraphs use
-* `w:beforeAutospacing`/`w:afterAutospacing` instead of explicit before/after;
-* Word ignores any explicit value on such paragraphs and renders ~14px. The
-* value is empirical (Word's rendered auto gap), not derivable from a twips
-* conversion. See eigenpal/docx-editor#823.
-*/
-const AUTO_PARAGRAPH_SPACING_PX = 14;
 /** EMUs per inch (1 inch = 914400 EMUs) */
 const EMUS_PER_INCH = 914400;
 /** Points per inch (1 inch = 72 points) */
@@ -34,6 +26,14 @@ const EIGHTHS_PER_INCH = 576;
 /** Pixels per inch at standard DPI */
 const PIXELS_PER_INCH = STANDARD_DPI;
 /**
+* Word's auto paragraph spacing in px. HTML-origin paragraphs use
+* `w:beforeAutospacing`/`w:afterAutospacing` instead of explicit before/after;
+* Word ignores any explicit value on such paragraphs and renders a 14pt gap.
+* The value is empirical (Word's rendered auto gap), not derivable from a
+* twips conversion. See eigenpal/docx-editor#823.
+*/
+const AUTO_PARAGRAPH_SPACING_PX = pointsToPixels(14);
+/**
 * Convert twips to pixels (at 96 DPI)
 *
 * 1 inch = 1440 twips = 96 pixels

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",