@stll/folio-core 0.10.0 → 0.12.0

package/dist/render-dom/resolveSidebarItemPositions.d.ts

@@ -0,0 +1,33 @@
+import { RenderedDomContext } from "./RenderedDomContext.js";
+
+//#region src/render-dom/resolveSidebarItemPositions.d.ts
+type RenderedSidebarItem = {
+  id: string;
+  anchorPos: number;
+  anchorKey?: string;
+  priority?: number;
+  fixedY?: number;
+  estimatedHeight?: number;
+};
+type ResolvedSidebarItemPosition<T extends RenderedSidebarItem = RenderedSidebarItem> = {
+  item: T;
+  y: number;
+};
+type ResolveSidebarItemPositionsOptions<T extends RenderedSidebarItem> = {
+  items: T[];
+  anchorPositions: Map<string, number>;
+  renderedDomContext: RenderedDomContext | null;
+  zoom: number;
+  cardHeights: Map<string, number>;
+  lastKnown: Map<string, number>;
+};
+declare const resolveSidebarItemPositions: <T extends RenderedSidebarItem>({
+  items,
+  anchorPositions,
+  renderedDomContext,
+  zoom,
+  cardHeights,
+  lastKnown
+}: ResolveSidebarItemPositionsOptions<T>) => ResolvedSidebarItemPosition<T>[];
+//#endregion
+export { RenderedSidebarItem, ResolveSidebarItemPositionsOptions, ResolvedSidebarItemPosition, resolveSidebarItemPositions };

package/dist/render-dom/resolveSidebarItemPositions.js

@@ -0,0 +1,45 @@
+//#region src/render-dom/resolveSidebarItemPositions.ts
+const MIN_CARD_GAP = 8;
+const resolveSidebarItemPositions = ({ items, anchorPositions, renderedDomContext, zoom, cardHeights, lastKnown }) => {
+	if (items.length === 0) return [];
+	const containerOffset = renderedDomContext?.getContainerOffset();
+	const positioned = [];
+	for (const item of items) {
+		let targetY;
+		if (item.fixedY !== void 0) targetY = item.fixedY * zoom;
+		if (targetY === void 0 && item.anchorKey !== void 0) {
+			const anchorY = anchorPositions.get(item.anchorKey);
+			if (anchorY !== void 0) targetY = anchorY * zoom;
+		}
+		if (targetY === void 0 && renderedDomContext && containerOffset) {
+			const rect = renderedDomContext.getRectsForRange(item.anchorPos, item.anchorPos + 1).at(0);
+			if (rect) targetY = (rect.y + containerOffset.y) * zoom;
+		}
+		if (targetY === void 0) targetY = lastKnown.get(item.id);
+		if (targetY === void 0) continue;
+		positioned.push({
+			item,
+			targetY
+		});
+		lastKnown.set(item.id, targetY);
+	}
+	positioned.sort((left, right) => {
+		const positionDifference = left.targetY - right.targetY;
+		if (positionDifference !== 0) return positionDifference;
+		return (left.item.priority ?? 0) - (right.item.priority ?? 0);
+	});
+	const resolved = [];
+	let previousBottom = 0;
+	for (const position of positioned) {
+		const height = cardHeights.get(position.item.id) ?? position.item.estimatedHeight ?? 80;
+		const y = Math.max(position.targetY, previousBottom + MIN_CARD_GAP);
+		resolved.push({
+			item: position.item,
+			y
+		});
+		previousBottom = y + height;
+	}
+	return resolved;
+};
+//#endregion
+export { resolveSidebarItemPositions };

package/dist/server.d.ts

@@ -13,8 +13,12 @@ import { createDocx } from "./docx/rezip.js";
 import { EnsureParaIdsError, EnsureParaIdsOptions, EnsureParaIdsResult, ensureParaIds } from "./docx/ensureParaIds.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, RewriteDocxMetadataPrivacyResult, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
 import { CreateCommentReplyInput, replyToComment } from "./docx/replyToComment.js";
-import { DocxArchiveError } from "./docx/server/boundedArchive.js";
+import { DocxArchiveError, DocxArchiveOptions } from "./docx/server/boundedArchive.js";
+import { EvaluateDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposal, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalIssue, FolioDocxXmlPatchProposalIssueCode, FolioDocxXmlPatchProposalLimits, FolioDocxXmlReplacement, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal } from "./docx/server/evaluateDocxXmlPatchProposal.js";
+import { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FolioDocxConformanceCheck, FolioDocxConformanceCheckId, FolioDocxConformanceCheckStatus, FolioDocxConformanceIssue, FolioDocxConformanceIssueCode, FolioDocxConformanceReport, FolioDocxConformanceStatus, ValidateDocxConformanceOptions, validateDocxConformance } from "./docx/server/validateDocxConformance.js";
+import { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal } from "./docx/server/applyDocxXmlPatchProposal.js";
 import { DocxParagraphSource, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText } from "./docx/server/extractDocxText.js";
+import { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxInspectedXmlPart, FolioDocxPackageInspection, FolioDocxPackageInspectionError, FolioDocxPackageInspectionErrorCode, FolioDocxPackageInspectionLimits, FolioDocxPackagePart, FolioDocxPackagePartKind, InspectDocxPackageOptions, inspectDocxPackage } from "./docx/server/inspectDocxPackage.js";
 import { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx } from "./redline.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioBlockDiff, FolioCompareDocxVersionsOptions, FolioDocumentMetadataValue, FolioFormatProperty, FolioMetadataDiff, FolioStoryDiff, FolioVersionBlockHandle, FolioVersionComparisonPrivacyTransform, FolioVersionComparisonScope, FolioVersionDiff, FolioVersionDiffPrivacyOptions, FolioVersionDiffPrivacyReport, FolioVersionDiffSegment, FolioVersionDiffSummaryCounts, InvalidFolioVersionComparisonOptionsError, applyFolioVersionDiffPrivacy, compareDocxVersions, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope } from "./version-comparison.js";
-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_METADATA_PROPERTIES, 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_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, 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 FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, 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, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy };
+export { type ApplyDocxXmlPatchProposalArgs, 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 DocxArchiveOptions, type DocxParagraphSource, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, type ExtractedDocxText, FOLIO_DOCUMENT_METADATA_PROPERTIES, 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_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, 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 FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, 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, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioDocxConformanceCheck, type FolioDocxConformanceCheckId, type FolioDocxConformanceCheckStatus, type FolioDocxConformanceIssue, type FolioDocxConformanceIssueCode, type FolioDocxConformanceReport, type FolioDocxConformanceStatus, type FolioDocxInspectedXmlPart, type FolioDocxPackageInspection, FolioDocxPackageInspectionError, type FolioDocxPackageInspectionErrorCode, type FolioDocxPackageInspectionLimits, type FolioDocxPackagePart, type FolioDocxPackagePartKind, type FolioDocxPreparedXmlReplacement, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, type FolioDocxXmlPatchApplicationReceipt, type FolioDocxXmlPatchProposal, type FolioDocxXmlPatchProposalEvaluation, type FolioDocxXmlPatchProposalIssue, type FolioDocxXmlPatchProposalIssueCode, type FolioDocxXmlPatchProposalLimits, type FolioDocxXmlReplacement, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, type InspectDocxPackageOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };

package/dist/server.js

@@ -15,4 +15,8 @@ import { InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx } from "./r
 import { EnsureParaIdsError, ensureParaIds } from "./docx/ensureParaIds.js";
 import { DocxArchiveError } from "./docx/server/boundedArchive.js";
 import { extractDocxText } from "./docx/server/extractDocxText.js";
-export { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocxArchiveError, EnsureParaIdsError, FOLIO_DOCUMENT_METADATA_PROPERTIES, 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_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxReviewer, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy };
+import { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxPackageInspectionError, inspectDocxPackage } from "./docx/server/inspectDocxPackage.js";
+import { FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal } from "./docx/server/evaluateDocxXmlPatchProposal.js";
+import { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, validateDocxConformance } from "./docx/server/validateDocxConformance.js";
+import { FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplicationError, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal } from "./docx/server/applyDocxXmlPatchProposal.js";
+export { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocxArchiveError, EnsureParaIdsError, FOLIO_DOCUMENT_METADATA_PROPERTIES, 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_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };

package/dist/utils/findReplace.d.ts

@@ -0,0 +1,32 @@
+import { document_d_exports } from "../types/document.js";
+import { Paragraph } from "../types/content.js";
+
+//#region src/utils/findReplace.d.ts
+type FindMatch = {
+  paragraphIndex: number;
+  contentIndex: number;
+  startOffset: number;
+  endOffset: number;
+  text: string;
+};
+type FindOptions = {
+  matchCase: boolean;
+  matchWholeWord: boolean;
+  useRegex?: boolean;
+};
+type FindResult = {
+  matches: FindMatch[];
+  totalCount: number;
+  currentIndex: number;
+};
+declare const createDefaultFindOptions: () => FindOptions;
+declare const escapeRegexString: (value: string) => string;
+declare const createSearchPattern: (searchText: string, options: FindOptions) => RegExp | null;
+declare const findAllMatches: (content: string, searchText: string, options: FindOptions) => Array<{
+  start: number;
+  end: number;
+}>;
+declare const findInDocument: (document: document_d_exports.Document | null | undefined, searchText: string, options: FindOptions) => FindMatch[];
+declare const findInParagraph: (paragraph: Paragraph, searchText: string, options: FindOptions, paragraphIndex: number) => FindMatch[];
+//#endregion
+export { FindMatch, FindOptions, FindResult, createDefaultFindOptions, createSearchPattern, escapeRegexString, findAllMatches, findInDocument, findInParagraph };

package/dist/utils/findReplace.js

@@ -0,0 +1,118 @@
+//#region src/utils/findReplace.ts
+const createDefaultFindOptions = () => ({
+	matchCase: false,
+	matchWholeWord: false,
+	useRegex: false
+});
+const escapeRegexString = (value) => value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+const createSearchPattern = (searchText, options) => {
+	if (!searchText) return null;
+	try {
+		const source = options.useRegex ? searchText : escapeRegexString(searchText);
+		const pattern = options.matchWholeWord ? `\\b${source}\\b` : source;
+		return new RegExp(pattern, options.matchCase ? "gu" : "giu");
+	} catch {
+		return null;
+	}
+};
+const findAllMatches = (content, searchText, options) => {
+	if (!content || !searchText) return [];
+	const searchFor = options.matchCase ? searchText : searchText.toLowerCase();
+	const source = escapeRegexString(searchFor);
+	const pattern = new RegExp(options.matchWholeWord ? `\\b${source}\\b` : source, options.matchCase ? "gu" : "giu");
+	const matches = [];
+	let match;
+	while ((match = pattern.exec(content)) !== null) {
+		matches.push({
+			start: match.index,
+			end: match.index + match[0].length
+		});
+		if (match[0].length === 0) pattern.lastIndex++;
+	}
+	return matches;
+};
+const findInDocument = (document, searchText, options) => {
+	if (!document || !searchText) return [];
+	const body = document.package.document;
+	if (!isRecord(body) || !Array.isArray(body.content)) return [];
+	const matches = [];
+	forEachParagraph(body.content, (paragraph, paragraphIndex) => {
+		matches.push(...findInParagraph(paragraph, searchText, options, paragraphIndex));
+	});
+	return matches;
+};
+const findInParagraph = (paragraph, searchText, options, paragraphIndex) => {
+	const paragraphText = getParagraphPlainText(paragraph);
+	if (!paragraphText) return [];
+	return findAllMatches(paragraphText, searchText, options).map(({ start, end }) => ({
+		paragraphIndex,
+		contentIndex: findContentIndexAtOffset(paragraph, start),
+		startOffset: start,
+		endOffset: end,
+		text: paragraphText.slice(start, end)
+	}));
+};
+const forEachParagraph = (blocks, visit) => {
+	let paragraphIndex = 0;
+	const walkBlocks = (items) => {
+		for (const block of items) {
+			if (isParagraph(block)) {
+				visit(block, paragraphIndex);
+				paragraphIndex++;
+				continue;
+			}
+			if (isTable(block)) {
+				walkTable(block);
+				continue;
+			}
+			if (isBlockSdt(block)) walkBlocks(block.content);
+		}
+	};
+	const walkTable = (table) => {
+		for (const row of table.rows) {
+			if (!isTableRow(row)) continue;
+			for (const cell of row.cells) if (isTableCell(cell)) walkBlocks(cell.content);
+		}
+	};
+	walkBlocks(blocks);
+};
+const getRunText = (run) => {
+	let text = "";
+	for (const item of run.content) if (item.type === "text") text += item.text;
+	else if (item.type === "tab") text += "	";
+	else if (item.type === "break" && item.breakType === "textWrapping") text += "\n";
+	return text;
+};
+const getHyperlinkText = (hyperlink) => {
+	let text = "";
+	for (const child of hyperlink.children) if (child.type === "run") text += getRunText(child);
+	return text;
+};
+const getParagraphContentText = (content) => {
+	if (content.type === "run") return getRunText(content);
+	if (content.type === "hyperlink") return getHyperlinkText(content);
+	if (content.type === "inlineSdt") return content.content.map(getParagraphContentText).join("");
+	if (content.type === "simpleField") return content.content.map((child) => child.type === "run" ? getRunText(child) : getHyperlinkText(child)).join("");
+	if (content.type === "complexField") return content.fieldResult.map(getRunText).join("");
+	return "";
+};
+const getParagraphPlainText = (paragraph) => paragraph.content.map(getParagraphContentText).join("");
+const findContentIndexAtOffset = (paragraph, offset) => {
+	let currentOffset = 0;
+	for (let contentIndex = 0; contentIndex < paragraph.content.length; contentIndex++) {
+		const item = paragraph.content[contentIndex];
+		if (!item) continue;
+		const itemLength = getParagraphContentText(item).length;
+		if (currentOffset + itemLength > offset) return contentIndex;
+		currentOffset += itemLength;
+	}
+	return Math.max(0, paragraph.content.length - 1);
+};
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isParagraph = (value) => isRecord(value) && value["type"] === "paragraph" && Array.isArray(value["content"]);
+const isTable = (value) => isRecord(value) && value["type"] === "table" && Array.isArray(value["rows"]);
+const isTableRow = (value) => isRecord(value) && Array.isArray(value["cells"]);
+const isTableCell = (value) => isRecord(value) && Array.isArray(value["content"]);
+const isBlockSdt = (value) => isRecord(value) && value["type"] === "blockSdt" && Array.isArray(value["content"]);
+//#endregion
+export { createDefaultFindOptions, createSearchPattern, escapeRegexString, findAllMatches, findInDocument, findInParagraph };

package/dist/utils/fontFamilyMerge.js

@@ -1,4 +1,11 @@
 //#region src/utils/fontFamilyMerge.ts
+const FONT_FAMILY_PAIRS = [
+	["ascii", "asciiTheme"],
+	["hAnsi", "hAnsiTheme"],
+	["eastAsia", "eastAsiaTheme"],
+	["cs", "csTheme"]
+];
+const isFontFamilyPairKey = (key) => key === "ascii" || key === "asciiTheme" || key === "hAnsi" || key === "hAnsiTheme" || key === "eastAsia" || key === "eastAsiaTheme" || key === "cs" || key === "csTheme";
 function mergeFontFamily(target, source) {
 	const result = {};
 	const src = source;
@@ -10,21 +17,12 @@ function mergeFontFamily(target, source) {
 		if (replacesAscii && (key === "ascii" || key === "asciiTheme") || replacesHAnsi && (key === "hAnsi" || key === "hAnsiTheme") || replacesEastAsia && (key === "eastAsia" || key === "eastAsiaTheme") || replacesCs && (key === "cs" || key === "csTheme")) continue;
 		result[key] = target[key];
 	}
-	const pairs = [
-		["ascii", "asciiTheme"],
-		["hAnsi", "hAnsiTheme"],
-		["eastAsia", "eastAsiaTheme"],
-		["cs", "csTheme"]
-	];
-	const pairKeys = /* @__PURE__ */ new Set();
-	for (const [explicit, theme] of pairs) {
-		pairKeys.add(explicit);
-		pairKeys.add(theme);
+	for (const [explicit, theme] of FONT_FAMILY_PAIRS) {
 		if (src[explicit] === void 0 && src[theme] === void 0) continue;
 		if (src[explicit] !== void 0) result[explicit] = src[explicit];
 		if (src[theme] !== void 0) result[theme] = src[theme];
 	}
-	for (const key of Object.keys(src)) if (!pairKeys.has(key) && src[key] !== void 0) result[key] = src[key];
+	for (const key of Object.keys(src)) if (!isFontFamilyPairKey(key) && src[key] !== void 0) result[key] = src[key];
 	return result;
 }
 //#endregion

package/dist/utils/fontLoader.js

@@ -17,8 +17,8 @@ let isLoadingAny = false;
 * this map is used for font availability checks and preloading.
 */
 const FONT_MAPPING = {
-	Aptos: "Source Sans 3",
-	"Aptos Display": "Source Sans 3",
+	Aptos: "Lato",
+	"Aptos Display": "Lato",
 	Calibri: "Carlito",
 	Cambria: "Caladea",
 	Arial: "Arimo",
@@ -40,6 +40,7 @@ const BUNDLED_FONTS = /* @__PURE__ */ new Set([
 	"Arimo",
 	"Tinos",
 	"Cousine",
+	"Lato",
 	"Source Sans 3",
 	"Calibri",
 	"Cambria",

package/dist/utils/fontResolver.js

@@ -65,11 +65,11 @@ const APTOS_MEASURED_LINE_HEIGHT = {
 */
 const FONT_MAPPINGS = {
 	aptos: {
-		googleFont: "Source Sans 3",
+		googleFont: "Lato",
 		category: "sans-serif",
 		fallbackStack: [
 			"Aptos",
-			"Source Sans 3",
+			"Lato",
 			"Arial",
 			"Helvetica",
 			"sans-serif"
@@ -77,11 +77,11 @@ const FONT_MAPPINGS = {
 		singleLineRatio: singleLineRatioOf(APTOS_MEASURED_LINE_HEIGHT)
 	},
 	"aptos display": {
-		googleFont: "Source Sans 3",
+		googleFont: "Lato",
 		category: "sans-serif",
 		fallbackStack: [
 			"Aptos Display",
-			"Source Sans 3",
+			"Lato",
 			"Arial",
 			"Helvetica",
 			"sans-serif"
@@ -242,6 +242,24 @@ const FONT_MAPPINGS = {
 			unitsPerEm: 2048
 		})
 	},
+	"segoe ui": {
+		googleFont: "Source Sans 3",
+		category: "sans-serif",
+		fallbackStack: [
+			"Segoe UI",
+			"Source Sans 3",
+			"Arial",
+			"Helvetica",
+			"sans-serif"
+		],
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 2210,
+			hheaDescent: -514,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
+	},
 	montserrat: {
 		googleFont: "Montserrat",
 		category: "sans-serif",

package/dist/utils/fontWeights.d.ts

@@ -1,4 +1,4 @@
 //#region src/utils/fontWeights.d.ts
-declare const DOCX_BOLD_FONT_WEIGHT = "800";
+declare const DOCX_BOLD_FONT_WEIGHT = "700";
 //#endregion
 export { DOCX_BOLD_FONT_WEIGHT };

package/dist/utils/fontWeights.js

@@ -1,4 +1,4 @@
 //#region src/utils/fontWeights.ts
-const DOCX_BOLD_FONT_WEIGHT = "800";
+const DOCX_BOLD_FONT_WEIGHT = "700";
 //#endregion
 export { DOCX_BOLD_FONT_WEIGHT };

package/dist/utils/headerFooter.js

@@ -156,7 +156,18 @@ const createEmptyHeaderFooter = (document, position, isFirstPage) => {
 	const sectionProps = pkg.document.finalSectionProperties;
 	if (!sectionProps) return null;
 	const hdrFtrType = isFirstPage ? "first" : "default";
-	const rId = `rId_new_${position}_${hdrFtrType}`;
+	const baseRId = `rId_new_${position}_${hdrFtrType}`;
+	const usedRIds = /* @__PURE__ */ new Set([
+		...pkg.headers?.keys() ?? [],
+		...pkg.footers?.keys() ?? [],
+		...pkg.relationships?.keys() ?? []
+	]);
+	let rId = baseRId;
+	let rIdSuffix = 2;
+	while (usedRIds.has(rId)) {
+		rId = `${baseRId}_${rIdSuffix}`;
+		rIdSuffix++;
+	}
 	const emptyHf = {
 		type: position,
 		hdrFtrType,
@@ -174,11 +185,23 @@ const createEmptyHeaderFooter = (document, position, isFirstPage) => {
 		type: hdrFtrType,
 		rId
 	};
+	const usedTargets = /* @__PURE__ */ new Set();
+	for (const relationship of pkg.relationships?.values() ?? []) if (relationship.target) usedTargets.add(relationship.target);
+	let targetNumber = 1;
+	while (usedTargets.has(`${position}${targetNumber}.xml`)) targetNumber++;
+	const relationshipType = position === "header" ? "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" : "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer";
+	const relationships = new Map(pkg.relationships);
+	relationships.set(rId, {
+		id: rId,
+		type: relationshipType,
+		target: `${position}${targetNumber}.xml`
+	});
 	return {
 		...document,
 		package: {
 			...pkg,
 			[mapKey]: newMap,
+			relationships,
 			document: {
 				...pkg.document,
 				finalSectionProperties: {

package/dist/utils/paragraphFormattingMerge.js

@@ -9,6 +9,7 @@ const PARAGRAPH_REPLACE_KEYS = [
 	"spaceAfter",
 	"lineSpacing",
 	"lineSpacingRule",
+	"snapToGrid",
 	"beforeAutospacing",
 	"afterAutospacing",
 	"spacingExplicit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.10.0",
+  "version": "0.12.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",