@stll/folio-core 0.42.0 → 0.43.0

package/dist/compat/eigenpal.d.ts

@@ -29,7 +29,7 @@ import { getFolioCaretViewportRect, getFolioSelectionViewportRect } from "../pag
 import { AICitationRange, createAICitationDecorationsPlugin, setAICitationsMeta, setActiveCitationMeta } from "../prosemirror/plugins/aiCitationDecorations.js";
 import { AnonymizationMatch, AnonymizationTerm, anonymizationDecorationsKey, getAnonymizationMatches, setAnonymizationTermsMeta } from "../prosemirror/plugins/anonymizationDecorations.js";
 import { DirectiveKind, DirectiveRange, getTemplateDirectives, scanDirectives } from "../prosemirror/plugins/templateDirectives.js";
-import { TemplatePreviewSpan, TemplatePreviewValue, TemplatePreviewValues, setTemplatePreviewValues } from "../prosemirror/plugins/templatePreviewValues.js";
+import { TemplatePreviewHiddenRange, TemplatePreviewSpan, TemplatePreviewValue, TemplatePreviewValues, setTemplatePreviewValues } from "../prosemirror/plugins/templatePreviewValues.js";
 import { TemplateSlashMenuKeyAction, TemplateSlashMenuState, clearTemplateSlashMenu, consumeTemplateSlashQuery, getTemplateSlashMenu, resetTemplateSlashQuery, templateSlashMenuKey } from "../prosemirror/plugins/templateSlashMenu.js";
 import { AcceptAutocompleteResult, AutocompleteSuggestionPluginOptions, AutocompleteSuggestionState, AutocompleteSuggestionStatus, AutocompleteTriggerCheck, AutocompleteTriggerOptions, AutocompleteTriggerSkipReason, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acceptAutocompleteWord, appendAutocompleteToken, autocompleteSuggestionKey, autocompleteSuggestionPlugin, clearAutocompleteSuggestion, finishAutocompleteSuggestion, getAutocompleteSuggestion, shouldTriggerAutocomplete, startAutocompleteSuggestion } from "../prosemirror/plugins/autocompleteSuggestion.js";
 import { ImageMeta, ImageRef, MarkdownOptions, MarkdownResult } from "../markdown/types.js";
@@ -40,4 +40,4 @@ import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled
 import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentPropertiesOptions, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type DocxDrawingClassification, type DrawingSafetyClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentPropertiesOptions, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type DocxDrawingClassification, type DrawingSafetyClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewHiddenRange, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/controller/layoutPipeline.d.ts

@@ -1,5 +1,5 @@
 import { document_d_exports } from "../types/document.js";
-import { TemplatePreviewEntry } from "../prosemirror/plugins/templatePreviewValues.js";
+import { TemplatePreviewEntry, TemplatePreviewHiddenRange } from "../prosemirror/plugins/templatePreviewValues.js";
 import { ColumnLayout, FlowBlock, FootnoteContent, HeaderFooterContent, Layout, Measure, PageHeaderFooterRefs, PageMargins } from "../layout-engine/types.js";
 import { LayoutRunReason } from "../layout-engine/layoutInstrumentation.js";
 import { DirtyRange } from "../paged-layout/incrementalMeasure.js";
@@ -73,6 +73,7 @@ type LayoutPipelineDeps<THfPMs> = {
    */
   pageRenderer?: PageRendererName;
   emptyTemplatePreviewEntries: readonly TemplatePreviewEntry[];
+  emptyTemplatePreviewHidden: readonly TemplatePreviewHiddenRange[];
 };
 declare function runLayoutPipeline<THfPMs>(deps: LayoutPipelineDeps<THfPMs>, state: EditorState, options?: LayoutRunOptions): LayoutOutcome;
 //#endregion

package/dist/controller/layoutPipeline.js

@@ -100,7 +100,7 @@ function attachAuthoredMarginsToLayoutPages(layout, options) {
 	} : layout;
 }
 function runLayoutPipeline(deps, state, options = {}) {
-	const { contentWidth, columns, pageSize, margins, pageGap, showMarginGuides, marginGuideColor, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, documentFontsAreLoaded, buildFootnoteRenderItems, describeInvalidHighlightMarks, pageRenderer = PAGE_RENDERER.legacy, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES } = deps;
+	const { contentWidth, columns, pageSize, margins, pageGap, showMarginGuides, marginGuideColor, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, documentFontsAreLoaded, buildFootnoteRenderItems, describeInvalidHighlightMarks, pageRenderer = PAGE_RENDERER.legacy, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES, emptyTemplatePreviewHidden: EMPTY_TEMPLATE_PREVIEW_HIDDEN } = deps;
 	let outcome = {};
 	let pendingArtifacts;
 	let pendingTemplatePreview;
@@ -144,13 +144,16 @@ function runLayoutPipeline(deps, state, options = {}) {
 		}, state.doc.content, state.doc.marks) : state.doc, flowOpts);
 		const previewState = templatePreviewValuesKey.getState(state);
 		const previewEntries = previewState?.entries ?? EMPTY_TEMPLATE_PREVIEW_ENTRIES;
+		const previewHidden = previewState?.hidden ?? EMPTY_TEMPLATE_PREVIEW_HIDDEN;
 		const previewMode = previewState?.preview?.mode ?? "plain";
-		if (previewEntries.length > 0) newBlocks = applyTemplatePreviewToBlocks(newBlocks, {
+		if (previewEntries.length > 0 || previewHidden.length > 0) newBlocks = applyTemplatePreviewToBlocks(newBlocks, {
 			entries: previewEntries,
+			hidden: previewHidden,
 			mode: previewMode
 		});
 		pendingTemplatePreview = {
 			entries: previewEntries,
+			hidden: previewHidden,
 			mode: previewMode
 		};
 		outcome.blocks = newBlocks;

package/dist/controller/layoutSession.d.ts

@@ -1,4 +1,4 @@
-import { TemplatePreviewEntry, TemplatePreviewValues } from "../prosemirror/plugins/templatePreviewValues.js";
+import { TemplatePreviewEntry, TemplatePreviewHiddenRange, TemplatePreviewValues } from "../prosemirror/plugins/templatePreviewValues.js";
 import { FlowBlock, Measure } from "../layout-engine/types.js";
 import { EditorState } from "prosemirror-state";
 //#region src/controller/layoutSession.d.ts
@@ -9,6 +9,7 @@ type LayoutArtifacts = {
 };
 type LayoutTemplatePreview = {
   entries: readonly TemplatePreviewEntry[];
+  hidden: readonly TemplatePreviewHiddenRange[];
   mode: TemplatePreviewValues["mode"];
 };
 type LayoutSession = {

package/dist/controller/layoutSession.js

@@ -6,6 +6,7 @@ const createLayoutSession = () => ({
 	usedLoadedFonts: false,
 	lastTemplatePreview: {
 		entries: [],
+		hidden: [],
 		mode: "plain"
 	}
 });

package/dist/docx/blockContentParser.js

@@ -1,6 +1,7 @@
 import { parseBookmarkEnd, parseBookmarkStart } from "./bookmarkParser.js";
 import { appendBookmarkMarkerToLastParagraphInBlocks, prependBookmarkMarkersToFirstParagraphInBlocks } from "./bookmarkPlacement.js";
 import { convertBulletToUnicode } from "./bulletMarkers.js";
+import { isNumberingReference } from "./numberingReference.js";
 import { formatOoxmlCounter } from "./ooxmlCounterFormatter.js";
 import { parseParagraph } from "./paragraphParser.js";
 import { enrichParagraphTextBoxes } from "./paragraphTextBoxEnrichment.js";
@@ -18,7 +19,7 @@ const computeListMarker = (paragraph, { numbering, listCounters, abstractCounter
 		return;
 	}
 	const { numId, level } = listRendering;
-	if (numId === 0) {
+	if (!isNumberingReference(numId)) {
 		previousList.abstractNumId = null;
 		previousList.fromStyle = false;
 		previousList.numId = null;

package/dist/docx/commentIdNormalization.d.ts

@@ -0,0 +1,8 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/commentIdNormalization.d.ts
+type NormalizeCommentIdsResult = {
+  droppedDuplicateComments: number;
+};
+declare const normalizeCommentIds: (comments: document_d_exports.Comment[]) => NormalizeCommentIdsResult;
+//#endregion
+export { NormalizeCommentIdsResult, normalizeCommentIds };

package/dist/docx/commentIdNormalization.js

@@ -0,0 +1,16 @@
+//#region src/docx/commentIdNormalization.ts
+const normalizeCommentIds = (comments) => {
+	const seen = /* @__PURE__ */ new Set();
+	let kept = 0;
+	for (const comment of comments) {
+		if (seen.has(comment.id)) continue;
+		seen.add(comment.id);
+		comments[kept] = comment;
+		kept += 1;
+	}
+	const droppedDuplicateComments = comments.length - kept;
+	comments.length = kept;
+	return { droppedDuplicateComments };
+};
+//#endregion
+export { normalizeCommentIds };

package/dist/docx/defaultParagraphStyle.d.ts

@@ -0,0 +1,22 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/defaultParagraphStyle.d.ts
+/** The name Word's built-in default paragraph style always carries in the file. */
+declare const BUILT_IN_DEFAULT_PARAGRAPH_STYLE_NAME = "Normal";
+/** The id English Word gives it, kept as the last resort for the reverse case. */
+declare const BUILT_IN_DEFAULT_PARAGRAPH_STYLE_ID = "Normal";
+/**
+ * The formatting Word's default template gives Normal: 8pt (160 twips) after
+ * spacing, 1.08x line spacing.
+ *
+ * A package that declares neither a default paragraph style nor `w:docDefaults`
+ * renders as though it declared this, so anything that mints the missing
+ * default has to mint the formatting with it.
+ */
+declare const BUILT_IN_DEFAULT_PARAGRAPH_FORMATTING: {
+  spaceAfter: number;
+  lineSpacing: number;
+  lineSpacingRule: "auto";
+};
+declare const resolveDefaultParagraphStyle: (styles: Iterable<document_d_exports.Style>) => document_d_exports.Style | undefined;
+//#endregion
+export { BUILT_IN_DEFAULT_PARAGRAPH_FORMATTING, BUILT_IN_DEFAULT_PARAGRAPH_STYLE_ID, BUILT_IN_DEFAULT_PARAGRAPH_STYLE_NAME, resolveDefaultParagraphStyle };

package/dist/docx/defaultParagraphStyle.js

@@ -0,0 +1,32 @@
+//#region src/docx/defaultParagraphStyle.ts
+/** The name Word's built-in default paragraph style always carries in the file. */
+const BUILT_IN_DEFAULT_PARAGRAPH_STYLE_NAME = "Normal";
+/** The id English Word gives it, kept as the last resort for the reverse case. */
+const BUILT_IN_DEFAULT_PARAGRAPH_STYLE_ID = "Normal";
+/**
+* The formatting Word's default template gives Normal: 8pt (160 twips) after
+* spacing, 1.08x line spacing.
+*
+* A package that declares neither a default paragraph style nor `w:docDefaults`
+* renders as though it declared this, so anything that mints the missing
+* default has to mint the formatting with it.
+*/
+const BUILT_IN_DEFAULT_PARAGRAPH_FORMATTING = {
+	spaceAfter: 160,
+	lineSpacing: 259,
+	lineSpacingRule: "auto"
+};
+const resolveDefaultParagraphStyle = (styles) => {
+	let flagged;
+	let namedBuiltIn;
+	let idBuiltIn;
+	for (const style of styles) {
+		if (style.type !== "paragraph") continue;
+		if (style.default) flagged = style;
+		if (namedBuiltIn === void 0 && style.name === "Normal") namedBuiltIn = style;
+		if (idBuiltIn === void 0 && style.styleId === "Normal") idBuiltIn = style;
+	}
+	return flagged ?? namedBuiltIn ?? idBuiltIn;
+};
+//#endregion
+export { BUILT_IN_DEFAULT_PARAGRAPH_FORMATTING, BUILT_IN_DEFAULT_PARAGRAPH_STYLE_ID, BUILT_IN_DEFAULT_PARAGRAPH_STYLE_NAME, resolveDefaultParagraphStyle };

package/dist/docx/footnoteParser.js

@@ -78,6 +78,7 @@ function parseFootnotes(footnotesXml, styles = null, theme = null, numbering = n
 	const footnoteElements = findChildren(rootElement, "w", "footnote");
 	for (const fnEl of footnoteElements) {
 		const footnote = parseFootnote(fnEl, styles, theme, numbering, rels, media);
+		if (byId.has(footnote.id)) continue;
 		byId.set(footnote.id, footnote);
 		footnotes.push(footnote);
 	}
@@ -138,6 +139,7 @@ function parseEndnotes(endnotesXml, styles = null, theme = null, numbering = nul
 	const endnoteElements = findChildren(rootElement, "w", "endnote");
 	for (const enEl of endnoteElements) {
 		const endnote = parseEndnote(enEl, styles, theme, numbering, rels, media);
+		if (byId.has(endnote.id)) continue;
 		byId.set(endnote.id, endnote);
 		endnotes.push(endnote);
 	}

package/dist/docx/headerFooterRefParser.d.ts

@@ -1,6 +1,17 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
 //#region src/docx/headerFooterRefParser.d.ts
+/**
+ * Read a `w:type` attribute as one of ECMA-376's three `ST_HdrFtr` values.
+ *
+ * The enumeration is `even`, `default` and `first` (17.18.36); `default` is
+ * the odd-page header, which is why a producer writing `odd` means the same
+ * thing. Word opens such a package, so anything outside the enumeration reads
+ * as the default the schema itself defaults to. Everything that compares
+ * header/footer reference types has to read them through here, or a
+ * normalisation at this boundary looks like a lost reference downstream.
+ */
+declare function parseHeaderFooterType(typeAttr: string | null): document_d_exports.HeaderFooterType;
 /**
  * Parse a header reference from sectPr (w:headerReference)
  */
@@ -18,4 +29,4 @@ declare function parseHeaderReferences(sectPr: XmlElement): document_d_exports.H
  */
 declare function parseFooterReferences(sectPr: XmlElement): document_d_exports.FooterReference[];
 //#endregion
-export { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences };
+export { parseFooterReference, parseFooterReferences, parseHeaderFooterType, parseHeaderReference, parseHeaderReferences };

package/dist/docx/headerFooterRefParser.js

@@ -1,7 +1,14 @@
 import { findChildren, getAttribute } from "./xmlParser.js";
 //#region src/docx/headerFooterRefParser.ts
 /**
-* Parse header type attribute
+* Read a `w:type` attribute as one of ECMA-376's three `ST_HdrFtr` values.
+*
+* The enumeration is `even`, `default` and `first` (17.18.36); `default` is
+* the odd-page header, which is why a producer writing `odd` means the same
+* thing. Word opens such a package, so anything outside the enumeration reads
+* as the default the schema itself defaults to. Everything that compares
+* header/footer reference types has to read them through here, or a
+* normalisation at this boundary looks like a lost reference downstream.
 */
 function parseHeaderFooterType(typeAttr) {
 	switch (typeAttr) {
@@ -49,4 +56,4 @@ function parseFooterReferences(sectPr) {
 	return refs;
 }
 //#endregion
-export { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences };
+export { parseFooterReference, parseFooterReferences, parseHeaderFooterType, parseHeaderReference, parseHeaderReferences };

package/dist/docx/numberingParser.js

@@ -1,3 +1,4 @@
+import { isNumberingReference } from "./numberingReference.js";
 import { formatOoxmlCounter, padDecimal } from "./ooxmlCounterFormatter.js";
 import { LevelSuffixSchema, narrowEnum } from "./parserEnums.js";
 import { parseRunProperties } from "./runParser.js";
@@ -529,7 +530,7 @@ function createNumberingMap(definitions) {
 */
 function computeListRendering(numPr, numbering) {
 	const { numId, ilvl = 0 } = numPr;
-	if (numId === void 0 || numId === 0) return null;
+	if (!isNumberingReference(numId)) return null;
 	const level = numbering.getLevel(numId, ilvl);
 	if (!level) return null;
 	const levelNumFmts = [];

package/dist/docx/numberingReference.d.ts

@@ -0,0 +1,21 @@
+//#region src/docx/numberingReference.d.ts
+/**
+ * The reserved `w:numId` value that means "no numbering".
+ *
+ * ECMA-376 (17.9.18 `numId`, 17.9.19 `numPr`) reserves 0: it names no `w:num`,
+ * it switches numbering off, and on a style it cancels the numbering the style
+ * would otherwise inherit through `w:basedOn` (Word writes it on, for example,
+ * a heading-based style that must not be numbered). It must therefore survive a
+ * round trip: dropping the `w:numPr` would hand the numbering back.
+ */
+declare const NO_NUMBERING_NUM_ID = 0;
+/**
+ * Whether a `w:numId` names a numbering definition to resolve.
+ *
+ * Every lookup or validation against `numbering.nums` goes through this: an
+ * absent id has nothing to resolve, and {@link NO_NUMBERING_NUM_ID} is the
+ * "none" sentinel, never a dangling reference.
+ */
+declare const isNumberingReference: (numId: number | undefined) => numId is number;
+//#endregion
+export { NO_NUMBERING_NUM_ID, isNumberingReference };

package/dist/docx/numberingReference.js

@@ -0,0 +1,21 @@
+//#region src/docx/numberingReference.ts
+/**
+* The reserved `w:numId` value that means "no numbering".
+*
+* ECMA-376 (17.9.18 `numId`, 17.9.19 `numPr`) reserves 0: it names no `w:num`,
+* it switches numbering off, and on a style it cancels the numbering the style
+* would otherwise inherit through `w:basedOn` (Word writes it on, for example,
+* a heading-based style that must not be numbered). It must therefore survive a
+* round trip: dropping the `w:numPr` would hand the numbering back.
+*/
+const NO_NUMBERING_NUM_ID = 0;
+/**
+* Whether a `w:numId` names a numbering definition to resolve.
+*
+* Every lookup or validation against `numbering.nums` goes through this: an
+* absent id has nothing to resolve, and {@link NO_NUMBERING_NUM_ID} is the
+* "none" sentinel, never a dangling reference.
+*/
+const isNumberingReference = (numId) => numId !== void 0 && numId !== 0;
+//#endregion
+export { NO_NUMBERING_NUM_ID, isNumberingReference };

package/dist/docx/numberingReferenceNormalization.d.ts

@@ -10,8 +10,17 @@ type NormalizeNumberingReferencesInput = {
   endnotes?: readonly document_d_exports.Endnote[];
 };
 type NormalizeNumberingReferencesResult = {
-  removedMissingNumberingReferences: number;
+  unnumberedDanglingReferences: number;
 };
 declare const normalizeNumberingReferences: ({ documentBody, numbering, headers, footers, footnotes, endnotes }: NormalizeNumberingReferencesInput) => NormalizeNumberingReferencesResult;
+type NormalizeStyleNumberingReferencesInput = {
+  styles: readonly document_d_exports.Style[];
+  numbering: NumberingMap | undefined;
+};
+type NormalizeStyleNumberingReferencesResult = {
+  /** Style ids whose dangling reference became the "no numbering" sentinel. */
+  unnumberedStyleIds: string[];
+};
+declare const normalizeStyleNumberingReferences: ({ styles, numbering }: NormalizeStyleNumberingReferencesInput) => NormalizeStyleNumberingReferencesResult;
 //#endregion
-export { normalizeNumberingReferences };
+export { normalizeNumberingReferences, normalizeStyleNumberingReferences };

package/dist/docx/numberingReferenceNormalization.js

@@ -1,7 +1,18 @@
+import { isNumberingReference } from "./numberingReference.js";
 import { visitDocxParagraphs } from "./paragraphTraversal.js";
 //#region src/docx/numberingReferenceNormalization.ts
+/**
+* Whether a `w:numId` still reaches a level definition: a `w:num` that names a
+* `w:abstractNum` the numbering part defines. Both hops can dangle, and a
+* `w:num` with no `w:abstractNum` numbers nothing just as a missing one does.
+*/
+const resolvesNumbering = (numId, numbering) => {
+	if (!numbering) return false;
+	const abstractNumId = numbering.getAbstractNumId(numId);
+	return abstractNumId !== null && numbering.getAbstract(abstractNumId) !== null;
+};
 const normalizeNumberingReferences = ({ documentBody, numbering, headers, footers, footnotes, endnotes }) => {
-	let removedMissingNumberingReferences = 0;
+	let unnumberedDanglingReferences = 0;
 	visitDocxParagraphs({
 		documentBody,
 		headers,
@@ -9,14 +20,26 @@ const normalizeNumberingReferences = ({ documentBody, numbering, headers, footer
 		footnotes,
 		endnotes
 	}, (paragraph) => {
-		const numId = paragraph.formatting?.numPr?.numId;
-		if (numId !== void 0 && numId !== 0 && !numbering.hasNumbering(numId)) {
-			delete paragraph.formatting?.numPr;
-			delete paragraph.listRendering;
-			removedMissingNumberingReferences += 1;
-		}
+		const formatting = paragraph.formatting;
+		const numId = formatting?.numPr?.numId;
+		if (!formatting || !isNumberingReference(numId) || resolvesNumbering(numId, numbering)) return;
+		formatting.numPr = { numId: 0 };
+		delete formatting.numPrFromStyle;
+		delete paragraph.listRendering;
+		unnumberedDanglingReferences += 1;
 	});
-	return { removedMissingNumberingReferences };
+	return { unnumberedDanglingReferences };
+};
+const normalizeStyleNumberingReferences = ({ styles, numbering }) => {
+	const unnumberedStyleIds = [];
+	for (const style of styles) {
+		const pPr = style.pPr;
+		const numId = pPr?.numPr?.numId;
+		if (!pPr || !isNumberingReference(numId) || resolvesNumbering(numId, numbering)) continue;
+		pPr.numPr = { numId: 0 };
+		unnumberedStyleIds.push(style.styleId);
+	}
+	return { unnumberedStyleIds };
 };
 //#endregion
-export { normalizeNumberingReferences };
+export { normalizeNumberingReferences, normalizeStyleNumberingReferences };

package/dist/docx/paragraphParser.js

@@ -4,6 +4,7 @@ import { parseBookmarkEnd as parseBookmarkEnd$1, parseBookmarkStart as parseBook
 import { parseFieldType } from "./fieldParser.js";
 import { parseHyperlink as parseHyperlink$1, parseHyperlinkChild } from "./hyperlinkParser.js";
 import { markerFormattingFromLevel, numberingLevelHasMarkerSlot } from "./numberingParser.js";
+import { isNumberingReference } from "./numberingReference.js";
 import { paraIdInRange } from "./paraIdRangeNormalization.js";
 import { assignParagraphPropertySource } from "./paragraphPropertySource.js";
 import { BorderStyleSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, TabLeaderSchema, TabStopAlignmentSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
@@ -1114,7 +1115,7 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 	}
 	if (effectiveNumPr && numbering) {
 		const { numId, ilvl = 0 } = effectiveNumPr;
-		if (numId !== void 0 && numId !== 0) {
+		if (isNumberingReference(numId)) {
 			const level = numbering.getLevel(numId, ilvl);
 			if (level) {
 				const levelNumFmts = [];
@@ -1310,7 +1311,7 @@ function isEmptyParagraph(paragraph) {
 * @returns true if paragraph has numbering properties
 */
 function isListItem(paragraph) {
-	return paragraph.formatting?.numPr !== void 0 && paragraph.formatting.numPr.numId !== void 0 && paragraph.formatting.numPr.numId !== 0;
+	return isNumberingReference(paragraph.formatting?.numPr?.numId);
 }
 /**
 * Get the list level of a paragraph (0-8)

package/dist/docx/parser.js

@@ -1,6 +1,7 @@
 import { toArrayBuffer } from "../utils/docxInput.js";
 import { loadFontsWithMapping } from "../utils/fontLoader.js";
 import { MAX_PACKAGE_TIFF_PIXELS, convertTiffToPngDataUrl, isTiffMimeType } from "../utils/tiffConverter.js";
+import { normalizeCommentIds } from "./commentIdNormalization.js";
 import { parseComments } from "./commentParser.js";
 import { normalizeCommentReferences } from "./commentReferenceNormalization.js";
 import { detectDocxConformanceClass } from "./conformance.js";
@@ -17,7 +18,7 @@ import { extractMetafileRaster, isMetafileMimeType } from "./metafileRaster.js";
 import { renderEmfSvg } from "./metafileSvg.js";
 import { DocxModelValidationError, formatDocumentModelIssues, validateFolioDocumentModel } from "./modelValidation.js";
 import { parseNumbering } from "./numberingParser.js";
-import { normalizeNumberingReferences } from "./numberingReferenceNormalization.js";
+import { normalizeNumberingReferences, normalizeStyleNumberingReferences } from "./numberingReferenceNormalization.js";
 import { assignDocumentParagraphPropertySourceContract } from "./paragraphPropertySource.js";
 import { RELATIONSHIP_TYPES, parseRelationships, resolveRelativePath } from "./relsParser.js";
 import { normalizeRenderedPageBreakHints } from "./renderedPageBreakNormalization.js";
@@ -137,6 +138,8 @@ async function parseDocx(input, options = {}) {
 		} else onProgress("Skipping footnotes/endnotes", 75);
 		onProgress("Parsing comments...", 75);
 		const comments = timeStage("comments", () => parseComments(raw.commentsXml, styles, theme, rels, media, raw.commentsExtensibleXml, raw.commentsExtendedXml));
+		const commentIdNormalization = normalizeCommentIds(comments);
+		if (commentIdNormalization.droppedDuplicateComments > 0) warnings.push(`Dropped ${commentIdNormalization.droppedDuplicateComments} comment(s) repeating a w:id another comment already defines.`);
 		if (comments.length > 0) documentBody.comments = comments;
 		normalizeDrawingIds({
 			documentBody,
@@ -179,7 +182,12 @@ async function parseDocx(input, options = {}) {
 			...footnotes !== void 0 ? { footnotes } : {},
 			...endnotes !== void 0 ? { endnotes } : {}
 		});
-		if (numberingReferenceNormalization.removedMissingNumberingReferences > 0) warnings.push(`Removed ${numberingReferenceNormalization.removedMissingNumberingReferences} numbering reference(s) whose numbering definitions are missing.`);
+		if (numberingReferenceNormalization.unnumberedDanglingReferences > 0) warnings.push(`Unnumbered ${numberingReferenceNormalization.unnumberedDanglingReferences} paragraph(s) whose numbering definitions are missing.`);
+		const styleNumberingNormalization = normalizeStyleNumberingReferences({
+			styles: styleDefinitions?.styles ?? [],
+			numbering
+		});
+		for (const styleId of styleNumberingNormalization.unnumberedStyleIds) warnings.push(`Unnumbered style "${styleId}" whose numbering definition is missing.`);
 		const trackedMoveRangeNormalization = normalizeTrackedMoveRanges({
 			documentBody,
 			...headers !== void 0 ? { headers } : {},

package/dist/docx/rezip.js

@@ -7,9 +7,11 @@ import { applyReplyThreadMarkers } from "./commentReplyMarkers.js";
 import { normalizeDrawingIds } from "./drawingIdNormalization.js";
 import { rebindDrawingImageRelationship } from "./drawingRelationships.js";
 import { parseEndnotes, parseFootnotes } from "./footnoteParser.js";
+import { parseHeaderFooterType } from "./headerFooterRefParser.js";
 import { assertValidFolioDocumentModel } from "./modelValidation.js";
 import { isNewDataUrlDrawing } from "./newImage.js";
 import { parseNumbering } from "./numberingParser.js";
+import { isNumberingReference } from "./numberingReference.js";
 import { isUnsafePackagePath, reconcilePackageReferences, removeUnsafeEntries } from "./packageParts.js";
 import { normalizeParaIdRangeInXmlParts } from "./paraIdRangeNormalization.js";
 import { RELATIONSHIP_TYPES, parseRelationships, resolveRelativePath } from "./relsParser.js";
@@ -113,7 +115,7 @@ const extractHeaderFooterReferences = (xml) => {
 			const rId = getAttributeByNamespaceUri(node, OFFICE_RELATIONSHIP_NAMESPACE_URIS, "id");
 			if (rId) references.push({
 				element,
-				type: getAttributeByNamespaceUri(node, WORDPROCESSINGML_NAMESPACE_URIS, "type") ?? "default",
+				type: parseHeaderFooterType(getAttributeByNamespaceUri(node, WORDPROCESSINGML_NAMESPACE_URIS, "type")),
 				rId
 			});
 		}
@@ -1684,17 +1686,32 @@ const createDocumentSeedZip = async (doc, properties) => {
 };
 const relationshipXml = (id, type, target) => `<Relationship Id="rId${id}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/${type}" Target="${target}"/>`;
 const overrideXml = (partName, contentType) => `<Override PartName="${partName}" ContentType="${contentType}"/>`;
+/**
+* A package this build assembles from a Document must define the numbering its
+* styles name: Word reads a styles.xml reference nothing resolves as no
+* numbering at all, silently dropping the style's list.
+*
+* The panic is an invariant over Folio's own output, not input validation. A
+* source file can carry a dangling style reference, and it never arrives here:
+* `normalizeStyleNumberingReferences` rewrites one to the "no numbering"
+* sentinel at every boundary that mints a Document from user styles (`parseDocx`
+* and the style-set extraction entry points). What reaches this point is what
+* Folio itself put in the model, so a miss is a defect in Folio.
+*/
 const assertStyleNumberingReferences = (doc) => {
 	const referenced = /* @__PURE__ */ new Set();
 	for (const style of doc.package.styles?.styles ?? []) {
 		const numId = style.pPr?.numPr?.numId;
-		if (numId !== void 0) referenced.add(numId);
+		if (isNumberingReference(numId)) referenced.add(numId);
 	}
 	if (referenced.size === 0) return;
-	const available = new Set(doc.package.numbering?.nums.map((numbering) => numbering.numId) ?? []);
-	for (const numId of referenced) if (!available.has(numId)) panic(`Style references missing numbering definition ${numId}`);
+	const available = new Map(doc.package.numbering?.nums.map((numbering) => [numbering.numId, numbering]) ?? []);
 	const availableAbstract = new Set(doc.package.numbering?.abstractNums.map((numbering) => numbering.abstractNumId) ?? []);
-	for (const numbering of doc.package.numbering?.nums ?? []) if (!availableAbstract.has(numbering.abstractNumId)) panic(`Numbering definition ${numbering.numId} references missing abstract numbering`);
+	for (const numId of referenced) {
+		const numbering = available.get(numId);
+		if (!numbering) panic(`Style references missing numbering definition ${numId}`);
+		if (!availableAbstract.has(numbering.abstractNumId)) panic(`Numbering definition ${numbering.numId} references missing abstract numbering`);
+	}
 };
 //#endregion
 export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, hasUnmaterializedInlineResources, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };

package/dist/docx/server/createBilingualDocument.js

@@ -1,4 +1,5 @@
 import { deterministicHexId } from "../../utils/hexId.js";
+import { isNumberingReference } from "../numberingReference.js";
 import { getParagraphText } from "../paragraphParser.js";
 import { cloneParagraphWithoutPropertySource } from "../paragraphPropertySource.js";
 import { getRunText } from "../runParser.js";
@@ -257,7 +258,7 @@ const resolveInheritedOutlineLevel = (style, styleById) => {
 /** The numbering a paragraph renders with: direct `numPr`, else the style chain's. */
 const effectiveNumPr = (paragraph, styleById) => {
 	const direct = paragraph.formatting?.numPr;
-	if (direct?.numId !== void 0) return direct.numId === 0 ? void 0 : direct;
+	if (direct?.numId !== void 0) return isNumberingReference(direct.numId) ? direct : void 0;
 	const styleId = paragraph.formatting?.styleId;
 	return styleId ? styleNumPr(styleById.get(styleId), styleById) : void 0;
 };
@@ -267,7 +268,7 @@ const styleNumPr = (style, styleById) => {
 	while (current && !seen.has(current.styleId)) {
 		seen.add(current.styleId);
 		const numPr = current.pPr?.numPr;
-		if (numPr?.numId !== void 0) return numPr.numId === 0 ? void 0 : numPr;
+		if (numPr?.numId !== void 0) return isNumberingReference(numPr.numId) ? numPr : void 0;
 		current = current.basedOn ? styleById.get(current.basedOn) : void 0;
 	}
 };
@@ -396,11 +397,11 @@ const cloneParagraphForTarget = (paragraph, targetParaId, styleCloner, cloner, b
 	const nextFormatting = formatting && {
 		...formatting,
 		...formatting.styleId !== void 0 && { styleId: styleCloner.styleIdFor(formatting.styleId) },
-		...formatting.numPr?.numId !== void 0 && formatting.numPr.numId !== 0 && { numPr: {
+		...formatting.numPr !== void 0 && isNumberingReference(formatting.numPr.numId) && { numPr: {
 			...formatting.numPr,
 			numId: cloner.cloneNumId(formatting.numPr.numId)
 		} },
-		...formatting.numPrFromStyle?.numId !== void 0 && formatting.numPrFromStyle.numId !== 0 && { numPrFromStyle: {
+		...formatting.numPrFromStyle !== void 0 && isNumberingReference(formatting.numPrFromStyle.numId) && { numPrFromStyle: {
 			...formatting.numPrFromStyle,
 			numId: cloner.cloneNumId(formatting.numPrFromStyle.numId)
 		} }

package/dist/docx/styleParser.js

@@ -2,6 +2,7 @@ import { isValidHexColor } from "../utils/colorResolver.js";
 import { parseHorizontalScalePercent } from "../utils/horizontalScale.js";
 import { mergeParagraphFormatting } from "../utils/paragraphFormattingMerge.js";
 import { mergeStyleTextFormatting } from "../utils/textFormattingMerge.js";
+import { resolveDefaultParagraphStyle } from "./defaultParagraphStyle.js";
 import { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FontHintSchema, FontThemeSchema, HighlightColorSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
 import { resolveThemeFontRef } from "./themeParser.js";
 import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
@@ -916,8 +917,7 @@ function getResolvedStyle(styleId, styleMap) {
 * Get the default paragraph style
 */
 function getDefaultParagraphStyle(styleMap) {
-	for (const style of styleMap.values()) if (style.type === "paragraph" && style.default) return style;
-	return styleMap.get("Normal");
+	return resolveDefaultParagraphStyle(styleMap.values());
 }
 /**
 * Get the default character style