@stll/folio-core 0.8.0 → 0.9.0

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,
+		listMarkerBold: rendering?.markerBold ?? null,
 		listMarkerAlignment: rendering?.markerAlignment ?? null,
 		listMarkerSuffix: rendering?.markerSuffix ?? null,
 		listMarkerAllCaps: rendering?.markerAllCaps ?? null,

package/dist/prosemirror/utils/tabCalculator.d.ts

@@ -64,7 +64,9 @@ declare function pixelsToTwips(pixels: number): number;
  * Compute the list of effective tab stops for a paragraph
  *
  * Merges explicit stops with default stops at regular intervals.
- * Filters out stops that fall before the left indent.
+ * Explicit stops before the left indent remain available to a hanging first
+ * line. Continuation lines naturally skip them because their cursor already
+ * starts at the left indent.
  *
  * @param context - Tab context with explicit stops and settings
  * @returns Sorted array of tab stops in twips

package/dist/prosemirror/utils/tabCalculator.js

@@ -27,25 +27,27 @@ function pixelsToTwips(pixels) {
 * Compute the list of effective tab stops for a paragraph
 *
 * Merges explicit stops with default stops at regular intervals.
-* Filters out stops that fall before the left indent.
+* Explicit stops before the left indent remain available to a hanging first
+* line. Continuation lines naturally skip them because their cursor already
+* starts at the left indent.
 *
 * @param context - Tab context with explicit stops and settings
 * @returns Sorted array of tab stops in twips
 */
 function computeTabStops(context) {
 	const { explicitStops = [], defaultTabInterval = 720, leftIndent = 0 } = context;
-	const validExplicitStops = explicitStops.filter((stop) => stop.val !== "clear").filter((stop) => stop.pos >= leftIndent);
+	const validExplicitStops = explicitStops.filter((stop) => stop.val !== "clear");
 	const clearPositions = explicitStops.filter((stop) => stop.val === "clear").map((stop) => stop.pos);
 	let maxExplicit = 0;
 	for (const stop of validExplicitStops) maxExplicit = Math.max(maxExplicit, stop.pos);
 	const stops = [...validExplicitStops];
-	if (leftIndent > 0 && !validExplicitStops.some((s) => s.pos <= leftIndent)) {
-		if (!clearPositions.some((p) => Math.abs(p - leftIndent) < 20)) stops.push({
-			val: "start",
-			pos: leftIndent,
-			leader: "none"
-		});
-	}
+	const hasLeftIndentClear = clearPositions.some((p) => Math.abs(p - leftIndent) < 20);
+	const addsImplicitLeftIndent = leftIndent > 0 && !hasLeftIndentClear && !validExplicitStops.some((stop) => stop.pos <= leftIndent);
+	if (addsImplicitLeftIndent) stops.push({
+		val: "start",
+		pos: leftIndent,
+		leader: "none"
+	});
 	let pos = Math.floor(Math.max(maxExplicit, leftIndent) / defaultTabInterval) * defaultTabInterval;
 	const limitPos = leftIndent + 14400;
 	while (pos < limitPos) {
@@ -60,7 +62,7 @@ function computeTabStops(context) {
 			hasClearStop = true;
 			break;
 		}
-		const isAtLeftIndent = leftIndent > 0 && Math.abs(pos - leftIndent) < 20;
+		const isAtLeftIndent = addsImplicitLeftIndent && Math.abs(pos - leftIndent) < 20;
 		if (!hasExplicitStop && !hasClearStop && !isAtLeftIndent) stops.push({
 			val: "start",
 			pos,

package/dist/prosemirror/validation.js

@@ -1,4 +1,4 @@
-import { readBlockSdtAttrs, readCharacterSpacingMarkAttrs, readCharacterStyleMarkAttrs, readCommentMarkAttrs, readEmphasisMarkAttrs, readFieldAttrs, readFontFamilyMarkAttrs, readFontSizeMarkAttrs, readFootnoteRefMarkAttrs, readHardBreakAttrs, readHighlightMarkAttrs, readHyperlinkMarkAttrs, readImageAttrs, readMathAttrs, readParagraphAttrs, readRunFormattingOverrideMarkAttrs, readRunShadingMarkAttrs, readSdtAttrs, readShapeAttrs, readStrikeMarkAttrs, readTableAttrs, readTableCellAttrs, readTableRowAttrs, readTextBoxAttrs, readTextColorMarkAttrs, readTextEffectMarkAttrs, readTrackedChangeMarkAttrs, readUnderlineMarkAttrs } from "./attrs/index.js";
+import { readBlockSdtAttrs, readCharacterSpacingMarkAttrs, readCharacterStyleMarkAttrs, readCommentMarkAttrs, readEmphasisMarkAttrs, readFieldAttrs, readFontFamilyMarkAttrs, readFontSizeMarkAttrs, readFootnoteRefMarkAttrs, readHardBreakAttrs, readHighlightMarkAttrs, readHyperlinkMarkAttrs, readImageAttrs, readLanguageMarkAttrs, readMathAttrs, readParagraphAttrs, readRunFormattingOverrideMarkAttrs, readRunShadingMarkAttrs, readSdtAttrs, readShapeAttrs, readStrikeMarkAttrs, readTableAttrs, readTableCellAttrs, readTableRowAttrs, readTextBoxAttrs, readTextColorMarkAttrs, readTextEffectMarkAttrs, readTrackedChangeMarkAttrs, readUnderlineMarkAttrs } from "./attrs/index.js";
 //#region src/prosemirror/validation.ts
 var ProseMirrorDocumentValidationError = class extends Error {
 	issues;
@@ -133,6 +133,9 @@ const validateMarks = (marks, path, issues) => {
 			case "fontFamily":
 				appendAttrIssues(markPath, readFontFamilyMarkAttrs(mark), issues);
 				continue;
+			case "language":
+				appendAttrIssues(markPath, readLanguageMarkAttrs(mark), issues);
+				continue;
 			case "characterSpacing":
 				appendAttrIssues(markPath, readCharacterSpacingMarkAttrs(mark), issues);
 				continue;

package/dist/redline.js

@@ -69,7 +69,7 @@ const generateRedlineDocx = async (base, revised, options = {}) => {
 	const operations = [];
 	let operationSeq = 0;
 	const nextOperationId = () => `redline-${++operationSeq}`;
-	/** Additions past the last base block, inserted after it in reverse so the final order matches the revised document. */
+	/** Additions past the last base block, kept in revised-document order. */
 	const trailingAdditions = [];
 	const lastBaseBlockId = baseSnapshot.blocks.at(-1)?.id ?? null;
 	events.forEach((event, eventIndex) => {
@@ -106,10 +106,20 @@ const generateRedlineDocx = async (base, revised, options = {}) => {
 			...event.block.styleId !== void 0 && { styleId: event.block.styleId }
 		});
 	});
-	for (const addition of trailingAdditions.toReversed()) operations.push({
+	if (lastBaseBlockId === null && baseSnapshot.emptyDocumentAnchorId !== void 0) {
+		const firstAddition = trailingAdditions.shift();
+		if (firstAddition !== void 0) operations.push({
+			id: nextOperationId(),
+			type: "replaceBlock",
+			blockId: baseSnapshot.emptyDocumentAnchorId,
+			text: firstAddition.text,
+			...firstAddition.styleId !== void 0 && { styleId: firstAddition.styleId }
+		});
+	}
+	for (const addition of trailingAdditions) operations.push({
 		id: nextOperationId(),
 		type: "insertAfterBlock",
-		blockId: lastBaseBlockId ?? "redline-unanchored",
+		blockId: lastBaseBlockId ?? baseSnapshot.emptyDocumentAnchorId ?? "redline-unanchored",
 		text: addition.text,
 		...addition.styleId !== void 0 && { styleId: addition.styleId }
 	});

package/dist/server.d.ts

@@ -1,11 +1,14 @@
 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 { 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, 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 { ApplyFolioAIEditsToBufferOptions, ApplyFolioAIEditsToBufferResult, FolioApplyDocumentOperationsOptions, FolioApplyDocumentOperationsToStoryOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioDocxReviewer, FolioDocxReviewerOptions, FolioEditableDocumentStoryHandle, 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 { 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 { EnsureParaIdsError, EnsureParaIdsOptions, EnsureParaIdsResult, ensureParaIds } from "./docx/ensureParaIds.js";
 import { CreateCommentReplyInput, replyToComment } from "./docx/replyToComment.js";
@@ -13,4 +16,4 @@ 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, 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 };
+export { type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, DocxArchiveError, type DocxParagraphSource, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type ExtractDocumentStyleSetOptions, 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 FolioApplyDocumentOperationsToStoryOptions, 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 FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioEditableDocumentStoryHandle, 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, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditsToBuffer, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment };

package/dist/server.js

@@ -1,14 +1,17 @@
 import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 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 { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-sets/types.js";
 import { createEmptyDocument } from "./utils/createDocument.js";
+import { 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 { getFolioDocumentOutline, readFolioDocumentSection } from "./ai-edits/scoped-reading.js";
 import { replyToComment } from "./docx/replyToComment.js";
-import { FolioDocxReviewer, applyFolioAIEditsToBuffer } from "./ai-edits/headless.js";
+import { FolioDocumentStoryNotFoundError, FolioDocxReviewer, applyFolioAIEditsToBuffer } from "./ai-edits/headless.js";
 import { compareDocxVersions } from "./version-comparison.js";
 import { generateRedlineDocx } from "./redline.js";
 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 };
+export { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, 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, FolioDocumentStoryNotFoundError, FolioDocxReviewer, InvalidFolioDocumentOperationBatchError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditsToBuffer, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment };

package/dist/style-sets/extract.d.ts

@@ -0,0 +1,35 @@
+import { document_d_exports } from "../types/document.js";
+import { DocumentStyleSet } from "./types.js";
+import { DocxInput } from "../utils/docxInput.js";
+
+//#region src/style-sets/extract.d.ts
+type ExtractDocumentStyleSetOptions = {
+  name: string; /** Style IDs selected by the user. Omit to extract every style. */
+  styleIds?: readonly string[]; /** Defaults to the source document's default paragraph style. */
+  initialParagraphStyleId?: string;
+};
+type DocumentStyleCatalogEntry = {
+  styleId: string;
+  name: string;
+  type: document_d_exports.Style["type"];
+  role: "default" | "quick" | "available" | "supporting";
+  dependencies: string[];
+  numberingId?: number;
+};
+type DocumentStyleCatalog = {
+  defaultParagraphStyleId?: string;
+  styles: DocumentStyleCatalogEntry[];
+};
+declare const inspectDocumentStyles: (document: document_d_exports.Document) => DocumentStyleCatalog;
+declare const inspectDocumentStylesFromDocx: (input: DocxInput) => Promise<DocumentStyleCatalog>;
+/**
+ * Extract a sanitized style set from a parsed document.
+ *
+ * Selected styles expand to a dependency closure over basedOn, next, and link
+ * references. Only numbering definitions referenced by the resulting styles
+ * are retained. No source content or package relationship can enter the result.
+ */
+declare const extractDocumentStyleSet: (document: document_d_exports.Document, options: ExtractDocumentStyleSetOptions) => DocumentStyleSet;
+declare const extractDocumentStyleSetFromDocx: (input: DocxInput, options: ExtractDocumentStyleSetOptions) => Promise<DocumentStyleSet>;
+//#endregion
+export { DocumentStyleCatalog, DocumentStyleCatalogEntry, ExtractDocumentStyleSetOptions, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx };

package/dist/style-sets/extract.js

@@ -0,0 +1,123 @@
+import "./types.js";
+import { parseDocx } from "../docx/parser.js";
+import { panic } from "better-result";
+//#region src/style-sets/extract.ts
+const inspectDocumentStyles = (document) => {
+	const styles = document.package.styles?.styles ?? [];
+	const defaultParagraphStyleId = styles.find((style) => style.type === "paragraph" && style.default)?.styleId;
+	return {
+		...defaultParagraphStyleId ? { defaultParagraphStyleId } : {},
+		styles: styles.map(toCatalogEntry)
+	};
+};
+const inspectDocumentStylesFromDocx = async (input) => inspectDocumentStyles(await parseDocx(input, {
+	preloadFonts: false,
+	parseHeadersFooters: false,
+	parseNotes: false,
+	detectVariables: false
+}));
+/**
+* Extract a sanitized style set from a parsed document.
+*
+* Selected styles expand to a dependency closure over basedOn, next, and link
+* references. Only numbering definitions referenced by the resulting styles
+* are retained. No source content or package relationship can enter the result.
+*/
+const extractDocumentStyleSet = (document, options) => {
+	const definitions = document.package.styles;
+	if (!definitions || definitions.styles.length === 0) return panic("Cannot extract a style set from a document without styles");
+	const stylesById = new Map(definitions.styles.map((style) => [style.styleId, style]));
+	const selectedStyleIds = options.styleIds === void 0 ? new Set(stylesById.keys()) : collectStyleDependencyClosure(stylesById, options.styleIds);
+	const styles = definitions.styles.filter((style) => selectedStyleIds.has(style.styleId));
+	if (styles.length === 0) return panic("Cannot extract an empty style set");
+	const defaultParagraphStyle = styles.find((style) => style.type === "paragraph" && style.default);
+	const initialParagraphStyleId = options.initialParagraphStyleId ?? defaultParagraphStyle?.styleId ?? "Normal";
+	if (!styles.find((style) => style.styleId === initialParagraphStyleId && style.type === "paragraph")) return panic(`Initial paragraph style "${initialParagraphStyleId}" is not present in the extracted set`);
+	const numbering = extractReferencedNumbering(styles, document);
+	const fontTable = sanitizeFontTable(document.package.fontTable);
+	return structuredClone({
+		version: 1,
+		name: options.name,
+		initialParagraphStyleId,
+		styles: {
+			...definitions.docDefaults ? { docDefaults: definitions.docDefaults } : {},
+			...definitions.latentStyles ? { latentStyles: definitions.latentStyles } : {},
+			styles
+		},
+		...numbering ? { numbering } : {},
+		...document.package.theme ? { theme: document.package.theme } : {},
+		...fontTable ? { fontTable } : {},
+		...document.package.settings ? { settings: document.package.settings } : {}
+	});
+};
+const extractDocumentStyleSetFromDocx = async (input, options) => {
+	const document = await parseDocx(input, {
+		preloadFonts: false,
+		parseHeadersFooters: false,
+		parseNotes: false,
+		detectVariables: false
+	});
+	return extractDocumentStyleSet(document, options);
+};
+const collectStyleDependencyClosure = (stylesById, requestedStyleIds) => {
+	const selected = /* @__PURE__ */ new Set();
+	const pending = [...requestedStyleIds];
+	while (pending.length > 0) {
+		const styleId = pending.pop();
+		if (styleId === void 0 || selected.has(styleId)) continue;
+		const style = stylesById.get(styleId);
+		if (!style) return panic(`Cannot extract unknown style "${styleId}"`);
+		selected.add(styleId);
+		for (const dependency of [
+			style.basedOn,
+			style.next,
+			style.link
+		]) if (dependency !== void 0 && !selected.has(dependency)) pending.push(dependency);
+	}
+	return selected;
+};
+const extractReferencedNumbering = (styles, document) => {
+	const source = document.package.numbering;
+	if (!source) return;
+	const referencedNumIds = /* @__PURE__ */ new Set();
+	for (const style of styles) {
+		const numId = style.pPr?.numPr?.numId;
+		if (numId !== void 0) referencedNumIds.add(numId);
+	}
+	if (referencedNumIds.size === 0) return;
+	const nums = source.nums.filter((numbering) => referencedNumIds.has(numbering.numId));
+	const referencedAbstractNumIds = new Set(nums.map((numbering) => numbering.abstractNumId));
+	return {
+		abstractNums: source.abstractNums.filter((numbering) => referencedAbstractNumIds.has(numbering.abstractNumId)),
+		nums
+	};
+};
+const sanitizeFontTable = (fontTable) => {
+	if (!fontTable) return;
+	return { fonts: fontTable.fonts.map(stripEmbeddedFontRelationships) };
+};
+const stripEmbeddedFontRelationships = ({ embedRegular: _embedRegular, embedBold: _embedBold, embedItalic: _embedItalic, embedBoldItalic: _embedBoldItalic, ...font }) => font;
+const toCatalogEntry = (style) => {
+	const entry = {
+		styleId: style.styleId,
+		name: style.name ?? style.styleId,
+		type: style.type,
+		role: styleRole(style),
+		dependencies: [...new Set([
+			style.basedOn,
+			style.next,
+			style.link
+		].filter((dependency) => dependency !== void 0))]
+	};
+	const numberingId = style.pPr?.numPr?.numId;
+	if (numberingId !== void 0) entry.numberingId = numberingId;
+	return entry;
+};
+const styleRole = (style) => {
+	if (style.default) return "default";
+	if (style.qFormat) return "quick";
+	if (!style.hidden && !style.semiHidden) return "available";
+	return "supporting";
+};
+//#endregion
+export { extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx };

package/dist/style-sets/stellaStyle.d.ts

@@ -0,0 +1,13 @@
+import { DocumentPreset, DocumentStyleSet } from "./types.js";
+
+//#region src/style-sets/stellaStyle.d.ts
+declare const STELLA_STYLE_SET_NAME = "Stella Style";
+/**
+ * A conservative legal drafting system inspired by common continental and
+ * common-law contract structure. It uses explicit fonts and neutral punctuation
+ * so the package does not depend on a locale-specific Office theme.
+ */
+declare const createStellaStyleSet: () => DocumentStyleSet;
+declare const createStellaStyleDocumentPreset: () => DocumentPreset;
+//#endregion
+export { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet };