@stll/folio-core 0.43.0 → 0.44.0

package/dist/style-sets/stellaStyle.js

@@ -1,3 +1,4 @@
+import { BUILT_IN_STYLE_NAME, builtInHeadingStyleName, builtInTableOfContentsStyleName } from "../docx/builtInStyles.js";
 import "./types.js";
 //#region src/style-sets/stellaStyle.ts
 const CLAUSE_NUMBERING_ID = 1;
@@ -43,7 +44,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "Normal",
 				type: "paragraph",
-				name: "Normal",
+				name: BUILT_IN_STYLE_NAME.normal,
 				default: true,
 				qFormat: true,
 				uiPriority: 0,
@@ -64,7 +65,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "DefaultParagraphFont",
 				type: "character",
-				name: "Default Paragraph Font",
+				name: BUILT_IN_STYLE_NAME.defaultParagraphFont,
 				default: true,
 				semiHidden: true,
 				unhideWhenUsed: true
@@ -72,7 +73,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "BodyText",
 				type: "paragraph",
-				name: "Body Text",
+				name: BUILT_IN_STYLE_NAME.bodyText,
 				basedOn: "Normal",
 				qFormat: true,
 				uiPriority: 1
@@ -80,7 +81,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "Title",
 				type: "paragraph",
-				name: "Title",
+				name: BUILT_IN_STYLE_NAME.title,
 				basedOn: "BodyText",
 				next: "BodyText",
 				qFormat: true,
@@ -109,7 +110,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "Subtitle",
 				type: "paragraph",
-				name: "Subtitle",
+				name: BUILT_IN_STYLE_NAME.subtitle,
 				basedOn: "Title",
 				next: "BodyText",
 				qFormat: true,
@@ -131,7 +132,10 @@ const createStellaStyleSet = () => ({
 				next: "Recital",
 				qFormat: true,
 				uiPriority: 5,
-				pPr: { keepNext: true },
+				pPr: {
+					keepNext: true,
+					outlineLevel: 0
+				},
 				rPr: { bold: true }
 			},
 			{
@@ -179,7 +183,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "ListParagraph",
 				type: "paragraph",
-				name: "List Paragraph",
+				name: BUILT_IN_STYLE_NAME.listParagraph,
 				basedOn: "BodyText",
 				qFormat: true,
 				uiPriority: 31,
@@ -208,13 +212,14 @@ const createStellaStyleSet = () => ({
 				pPr: {
 					pageBreakBefore: true,
 					keepNext: true,
-					spaceAfter: 240
+					spaceAfter: 240,
+					outlineLevel: 0
 				}
 			},
 			{
 				styleId: "FootnoteText",
 				type: "paragraph",
-				name: "Footnote Text",
+				name: BUILT_IN_STYLE_NAME.footnoteText,
 				basedOn: "Normal",
 				link: "FootnoteTextChar",
 				semiHidden: true,
@@ -229,7 +234,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "FootnoteTextChar",
 				type: "character",
-				name: "Footnote Text Char",
+				name: BUILT_IN_STYLE_NAME.footnoteTextChar,
 				basedOn: "DefaultParagraphFont",
 				link: "FootnoteText",
 				semiHidden: true,
@@ -243,7 +248,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "FootnoteReference",
 				type: "character",
-				name: "Footnote Reference",
+				name: BUILT_IN_STYLE_NAME.footnoteReference,
 				basedOn: "DefaultParagraphFont",
 				semiHidden: true,
 				unhideWhenUsed: true,
@@ -253,7 +258,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "EndnoteText",
 				type: "paragraph",
-				name: "Endnote Text",
+				name: BUILT_IN_STYLE_NAME.endnoteText,
 				basedOn: "Normal",
 				link: "EndnoteTextChar",
 				semiHidden: true,
@@ -268,7 +273,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "EndnoteTextChar",
 				type: "character",
-				name: "Endnote Text Char",
+				name: BUILT_IN_STYLE_NAME.endnoteTextChar,
 				basedOn: "DefaultParagraphFont",
 				link: "EndnoteText",
 				semiHidden: true,
@@ -282,7 +287,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "EndnoteReference",
 				type: "character",
-				name: "Endnote Reference",
+				name: BUILT_IN_STYLE_NAME.endnoteReference,
 				basedOn: "DefaultParagraphFont",
 				semiHidden: true,
 				unhideWhenUsed: true,
@@ -292,7 +297,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "Footer",
 				type: "paragraph",
-				name: "Footer",
+				name: BUILT_IN_STYLE_NAME.footer,
 				basedOn: "Normal",
 				pPr: {
 					alignment: "right",
@@ -307,7 +312,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "Hyperlink",
 				type: "character",
-				name: "Hyperlink",
+				name: BUILT_IN_STYLE_NAME.hyperlink,
 				basedOn: "DefaultParagraphFont",
 				unhideWhenUsed: true,
 				uiPriority: 99,
@@ -319,7 +324,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "TableNormal",
 				type: "table",
-				name: "Normal Table",
+				name: BUILT_IN_STYLE_NAME.normalTable,
 				default: true,
 				semiHidden: true,
 				unhideWhenUsed: true,
@@ -328,7 +333,7 @@ const createStellaStyleSet = () => ({
 			{
 				styleId: "TableGrid",
 				type: "table",
-				name: "Table Grid",
+				name: BUILT_IN_STYLE_NAME.tableGrid,
 				basedOn: "TableNormal",
 				qFormat: true,
 				uiPriority: 59,
@@ -399,37 +404,37 @@ const createHeadingStyles = () => {
 	return [
 		{
 			styleId: "Heading1",
-			name: "heading 1",
+			name: builtInHeadingStyleName(0),
 			fontSize: 28,
 			spaceBefore: 360
 		},
 		{
 			styleId: "Heading2",
-			name: "heading 2",
+			name: builtInHeadingStyleName(1),
 			fontSize: 24,
 			spaceBefore: 240
 		},
 		{
 			styleId: "Heading3",
-			name: "heading 3",
+			name: builtInHeadingStyleName(2),
 			fontSize: 22,
 			spaceBefore: 240
 		},
 		{
 			styleId: "Heading4",
-			name: "heading 4",
+			name: builtInHeadingStyleName(3),
 			fontSize: 20,
 			spaceBefore: 120
 		},
 		{
 			styleId: "Heading5",
-			name: "heading 5",
+			name: builtInHeadingStyleName(4),
 			fontSize: 20,
 			spaceBefore: 120
 		},
 		{
 			styleId: "Heading6",
-			name: "heading 6",
+			name: builtInHeadingStyleName(5),
 			fontSize: 20,
 			spaceBefore: 120
 		}
@@ -457,32 +462,33 @@ const createHeadingStyles = () => {
 };
 /** `TOCHeading` plus `TOC1`..`TOC3`, the styles a `TOC \o "1-3"` field fills. */
 const createTableOfContentsStyles = () => {
-	return [{
-		styleId: "TOCHeading",
-		type: "paragraph",
-		name: "TOC Heading",
-		basedOn: "Heading1",
-		next: "BodyText",
-		unhideWhenUsed: true,
-		uiPriority: 39,
-		pPr: { outlineLevel: 9 }
-	}, ...[
+	const levels = [
 		{
 			styleId: "TOC1",
-			name: "toc 1",
+			name: builtInTableOfContentsStyleName(1),
 			indent: 0
 		},
 		{
 			styleId: "TOC2",
-			name: "toc 2",
+			name: builtInTableOfContentsStyleName(2),
 			indent: 220
 		},
 		{
 			styleId: "TOC3",
-			name: "toc 3",
+			name: builtInTableOfContentsStyleName(3),
 			indent: 440
 		}
-	].map(({ styleId, name, indent }) => ({
+	];
+	return [{
+		styleId: "TOCHeading",
+		type: "paragraph",
+		name: BUILT_IN_STYLE_NAME.tocHeading,
+		basedOn: "Heading1",
+		next: "BodyText",
+		unhideWhenUsed: true,
+		uiPriority: 39,
+		pPr: { outlineLevel: 9 }
+	}, ...levels.map(({ styleId, name, indent }) => ({
 		styleId,
 		type: "paragraph",
 		name,
@@ -548,7 +554,8 @@ const createClauseStyles = () => {
 					ilvl: level
 				},
 				keepNext: level < 2,
-				spaceBefore: clauseSpaceBefore(level)
+				spaceBefore: clauseSpaceBefore(level),
+				outlineLevel: level === 0 ? 0 : 9
 			}
 		};
 		if (bold) return Object.assign(style, { rPr: { bold: true } });

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

@@ -0,0 +1,19 @@
+import { DocumentStyleSet } from "./types.js";
+import { ParseContext } from "../docx/parseContext.js";
+//#region src/style-sets/styleSetNormalization.d.ts
+/** The codes this normalisation is reported under, owned here, not at the caller. */
+declare const DUPLICATE_STYLE_ID_WARNING: "style-set-duplicate-style-id";
+declare const INITIAL_PARAGRAPH_STYLE_WARNING: "style-set-initial-style-missing";
+declare const UNNUMBERED_STYLE_SET_STYLE_WARNING: "unnumbered-style";
+/** The part a style-set normalisation names: the set itself, not a package. */
+declare const STYLE_SET_PART = "style-set";
+/**
+ * A normalised copy of the set, leaving the caller's value untouched.
+ *
+ * The version is the one thing still refused rather than repaired: a value
+ * folio has no reader for is programmer misuse, not a document defect, and
+ * guessing at its meaning would be worse than saying so.
+ */
+declare const normalizeDocumentStyleSet: (styleSet: DocumentStyleSet, context?: ParseContext) => DocumentStyleSet;
+//#endregion
+export { DUPLICATE_STYLE_ID_WARNING, INITIAL_PARAGRAPH_STYLE_WARNING, STYLE_SET_PART, UNNUMBERED_STYLE_SET_STYLE_WARNING, normalizeDocumentStyleSet };

package/dist/style-sets/styleSetNormalization.js

@@ -0,0 +1,99 @@
+import { mintDefaultParagraphStyle, resolveDefaultParagraphStyle } from "../docx/defaultParagraphStyle.js";
+import { getCachedNumberingMap } from "../docx/numberingParser.js";
+import { normalizeStyleNumberingReferences } from "../docx/numberingReferenceNormalization.js";
+import "./types.js";
+import { panic } from "better-result";
+import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
+//#region src/style-sets/styleSetNormalization.ts
+/**
+* The boundary an external `DocumentStyleSet` crosses to become a document.
+*
+* A style set is portable by design: hosts persist one as JSON, ship it
+* between workspaces, and hand it back months later. That makes it untrusted
+* input on the same footing as a `.docx`, and it can carry the same defects a
+* package can: a style numbering the set never defines, two styles under one
+* id, an initial paragraph style that is not in the set. A set written before
+* folio learned to normalise those still carries them.
+*
+* So it is normalised here, once, on the way in, through the same owners the
+* parser and the extractor use, rather than at a third call site with its own
+* rules. `createEmptyDocument` is the only door, so this is the only place
+* that has to run.
+*
+* `DOCUMENT_STYLE_SET_VERSION` does not move: the shape is unchanged and a v1
+* value is still a v1 value. What changed is that folio repairs one instead of
+* trusting it.
+*/
+/** The codes this normalisation is reported under, owned here, not at the caller. */
+const DUPLICATE_STYLE_ID_WARNING = PARSE_WARNING_CODES.styleSetDuplicateStyleId;
+const INITIAL_PARAGRAPH_STYLE_WARNING = PARSE_WARNING_CODES.styleSetInitialStyleMissing;
+const UNNUMBERED_STYLE_SET_STYLE_WARNING = PARSE_WARNING_CODES.unnumberedStyle;
+/** The part a style-set normalisation names: the set itself, not a package. */
+const STYLE_SET_PART = "style-set";
+/**
+* A normalised copy of the set, leaving the caller's value untouched.
+*
+* The version is the one thing still refused rather than repaired: a value
+* folio has no reader for is programmer misuse, not a document defect, and
+* guessing at its meaning would be worse than saying so.
+*/
+const normalizeDocumentStyleSet = (styleSet, context) => {
+	if (styleSet.version !== 1) return panic(`Unsupported document style set version: ${String(styleSet.version)}`);
+	if (styleSet.name.trim().length === 0) return panic("Document style set name cannot be empty");
+	const scoped = context?.scoped({ part: STYLE_SET_PART });
+	const normalized = structuredClone(styleSet);
+	const styles = dropDuplicateStyleIds(normalized.styles.styles, scoped);
+	normalized.styles.styles = styles;
+	const unnumbered = normalizeStyleNumberingReferences({
+		styles,
+		numbering: normalized.numbering ? getCachedNumberingMap(normalized.numbering) : void 0
+	});
+	for (const styleId of unnumbered.unnumberedStyleIds) scoped?.warn({
+		code: UNNUMBERED_STYLE_SET_STYLE_WARNING,
+		value: styleId,
+		at: `style "${styleId}"`
+	});
+	normalized.initialParagraphStyleId = resolveInitialParagraphStyleId({
+		styles,
+		requested: styleSet.initialParagraphStyleId,
+		hasDocDefaults: normalized.styles.docDefaults !== void 0,
+		context: scoped
+	});
+	return normalized;
+};
+const dropDuplicateStyleIds = (styles, context) => {
+	const seen = /* @__PURE__ */ new Set();
+	const kept = [];
+	for (const style of styles) {
+		if (seen.has(style.styleId)) {
+			context?.warn({
+				code: DUPLICATE_STYLE_ID_WARNING,
+				value: style.styleId,
+				at: `style "${style.styleId}"`
+			});
+			continue;
+		}
+		seen.add(style.styleId);
+		kept.push(style);
+	}
+	return kept;
+};
+const resolveInitialParagraphStyleId = ({ styles, requested, hasDocDefaults, context }) => {
+	if (styles.find((style) => style.styleId === requested && style.type === "paragraph")) return requested;
+	const replacement = resolveDefaultParagraphStyle(styles) ?? (() => {
+		const minted = mintDefaultParagraphStyle({
+			takenStyleIds: new Set(styles.map((style) => style.styleId)),
+			hasDocDefaults
+		});
+		styles.push(minted);
+		return minted;
+	})();
+	context?.warn({
+		code: INITIAL_PARAGRAPH_STYLE_WARNING,
+		value: requested,
+		at: `style "${replacement.styleId}"`
+	});
+	return replacement.styleId;
+};
+//#endregion
+export { DUPLICATE_STYLE_ID_WARNING, INITIAL_PARAGRAPH_STYLE_WARNING, STYLE_SET_PART, UNNUMBERED_STYLE_SET_STYLE_WARNING, normalizeDocumentStyleSet };

package/dist/types/content.d.ts

@@ -1,2 +1,2 @@
-import { BlockContent, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DocumentBody, DrawingContent, DrawingRawXmlMode, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeGeometryAdjustment, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, TrackedRunContent, VerticalAlign } from "@stll/docx-core/model";
-export type { BlockContent, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DocumentBody, DrawingContent, DrawingRawXmlMode, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeGeometryAdjustment, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, TrackedRunContent, VerticalAlign };
+import { BlockContent, BlockRangeMarkerCapture, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DisplacedByCustomXml, DocumentBody, DrawingContent, DrawingRawXmlMode, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeGeometryAdjustment, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, TrackedRunContent, VerticalAlign } from "@stll/docx-core/model";
+export type { BlockContent, BlockRangeMarkerCapture, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DisplacedByCustomXml, DocumentBody, DrawingContent, DrawingRawXmlMode, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeGeometryAdjustment, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, TrackedRunContent, VerticalAlign };

package/dist/utils/createDocument.js

@@ -1,3 +1,8 @@
+import { BUILT_IN_STYLE_NAME, builtInHeadingStyleName } from "../docx/builtInStyles.js";
+import "../docx/defaultParagraphStyle.js";
+import { createParseWarningCollector } from "../docx/parseContext.js";
+import { formatParseWarnings } from "../docx/parseWarningMessage.js";
+import { STYLE_SET_PART, normalizeDocumentStyleSet } from "../style-sets/styleSetNormalization.js";
 import "../style-sets/types.js";
 import { panic } from "better-result";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
@@ -12,13 +17,17 @@ import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 *
 * Font sizes are in half-points (e.g., 22 = 11pt, 40 = 20pt)
 * Colors are RGB hex without # prefix
+*
+* Each style carries the built-in `w:name` it stands for, which is how every
+* consumer recognises it (`docx/builtInStyles.ts`), and the headings carry
+* `w:outlineLvl` so a Word TOC field and the navigation pane list them.
 */
 function getDefaultStyles() {
 	return [
 		{
 			styleId: "Normal",
 			type: "paragraph",
-			name: "Normal",
+			name: BUILT_IN_STYLE_NAME.normal,
 			default: true,
 			qFormat: true,
 			uiPriority: 0,
@@ -34,7 +43,7 @@ function getDefaultStyles() {
 		{
 			styleId: "Title",
 			type: "paragraph",
-			name: "Title",
+			name: BUILT_IN_STYLE_NAME.title,
 			basedOn: "Normal",
 			next: "Normal",
 			qFormat: true,
@@ -52,7 +61,7 @@ function getDefaultStyles() {
 		{
 			styleId: "Subtitle",
 			type: "paragraph",
-			name: "Subtitle",
+			name: BUILT_IN_STYLE_NAME.subtitle,
 			basedOn: "Normal",
 			next: "Normal",
 			qFormat: true,
@@ -70,7 +79,7 @@ function getDefaultStyles() {
 		{
 			styleId: "Heading1",
 			type: "paragraph",
-			name: "Heading 1",
+			name: builtInHeadingStyleName(0),
 			basedOn: "Normal",
 			next: "Normal",
 			qFormat: true,
@@ -86,13 +95,14 @@ function getDefaultStyles() {
 			pPr: {
 				spaceBefore: 400,
 				spaceAfter: 120,
-				lineSpacing: 240
+				lineSpacing: 240,
+				outlineLevel: 0
 			}
 		},
 		{
 			styleId: "Heading2",
 			type: "paragraph",
-			name: "Heading 2",
+			name: builtInHeadingStyleName(1),
 			basedOn: "Normal",
 			next: "Normal",
 			qFormat: true,
@@ -108,13 +118,14 @@ function getDefaultStyles() {
 			pPr: {
 				spaceBefore: 360,
 				spaceAfter: 80,
-				lineSpacing: 240
+				lineSpacing: 240,
+				outlineLevel: 1
 			}
 		},
 		{
 			styleId: "Heading3",
 			type: "paragraph",
-			name: "Heading 3",
+			name: builtInHeadingStyleName(2),
 			basedOn: "Normal",
 			next: "Normal",
 			qFormat: true,
@@ -130,13 +141,14 @@ function getDefaultStyles() {
 			pPr: {
 				spaceBefore: 320,
 				spaceAfter: 80,
-				lineSpacing: 240
+				lineSpacing: 240,
+				outlineLevel: 2
 			}
 		},
 		{
 			styleId: "Heading4",
 			type: "paragraph",
-			name: "Heading 4",
+			name: builtInHeadingStyleName(3),
 			basedOn: "Normal",
 			next: "Normal",
 			qFormat: true,
@@ -152,6 +164,121 @@ function getDefaultStyles() {
 			pPr: {
 				spaceBefore: 280,
 				spaceAfter: 80,
+				lineSpacing: 240,
+				outlineLevel: 3
+			}
+		},
+		{
+			styleId: "Heading5",
+			type: "paragraph",
+			name: builtInHeadingStyleName(4),
+			basedOn: "Normal",
+			next: "Normal",
+			qFormat: true,
+			uiPriority: 9,
+			rPr: {
+				fontSize: 22,
+				bold: true,
+				fontFamily: {
+					ascii: "Arial",
+					hAnsi: "Arial"
+				}
+			},
+			pPr: {
+				spaceBefore: 240,
+				spaceAfter: 80,
+				lineSpacing: 240,
+				outlineLevel: 4
+			}
+		},
+		{
+			styleId: "Heading6",
+			type: "paragraph",
+			name: builtInHeadingStyleName(5),
+			basedOn: "Normal",
+			next: "Normal",
+			qFormat: true,
+			uiPriority: 9,
+			rPr: {
+				fontSize: 22,
+				bold: true,
+				color: { rgb: "595959" },
+				fontFamily: {
+					ascii: "Arial",
+					hAnsi: "Arial"
+				}
+			},
+			pPr: {
+				spaceBefore: 240,
+				spaceAfter: 80,
+				lineSpacing: 240,
+				outlineLevel: 5
+			}
+		},
+		{
+			styleId: "TableNormal",
+			type: "table",
+			name: BUILT_IN_STYLE_NAME.normalTable,
+			uiPriority: 99,
+			semiHidden: true,
+			unhideWhenUsed: true
+		},
+		{
+			styleId: "TableGrid",
+			type: "table",
+			name: BUILT_IN_STYLE_NAME.tableGrid,
+			basedOn: "TableNormal",
+			uiPriority: 39,
+			tblPr: { borders: {
+				top: {
+					style: "single",
+					size: 4,
+					space: 0
+				},
+				bottom: {
+					style: "single",
+					size: 4,
+					space: 0
+				},
+				left: {
+					style: "single",
+					size: 4,
+					space: 0
+				},
+				right: {
+					style: "single",
+					size: 4,
+					space: 0
+				},
+				insideH: {
+					style: "single",
+					size: 4,
+					space: 0
+				},
+				insideV: {
+					style: "single",
+					size: 4,
+					space: 0
+				}
+			} }
+		},
+		{
+			styleId: "Quote",
+			type: "paragraph",
+			name: BUILT_IN_STYLE_NAME.quote,
+			basedOn: "Normal",
+			next: "Normal",
+			qFormat: true,
+			uiPriority: 29,
+			rPr: {
+				italic: true,
+				color: { rgb: "404040" }
+			},
+			pPr: {
+				indentLeft: 720,
+				indentRight: 720,
+				spaceBefore: 160,
+				spaceAfter: 160,
 				lineSpacing: 240
 			}
 		}
@@ -203,9 +330,10 @@ function getDefaultSectionProperties() {
 * ```
 */
 function createEmptyDocument(options = {}) {
-	const styleSet = options.preset?.styleSet ?? options.styleSet;
-	validateDocumentStyleSet(styleSet);
+	const suppliedStyleSet = options.preset?.styleSet ?? options.styleSet;
 	if (options.preset?.version !== void 0 && options.preset.version !== 1) return panic(`Unsupported document preset version: ${options.preset.version}`);
+	const { context: styleSetContext, warnings: styleSetWarnings } = createParseWarningCollector(STYLE_SET_PART);
+	const styleSet = suppliedStyleSet === void 0 ? void 0 : normalizeDocumentStyleSet(suppliedStyleSet, styleSetContext);
 	const sectionProps = structuredClone(options.preset?.sectionProperties ?? getDefaultSectionProperties());
 	if (options.pageWidth !== void 0) sectionProps.pageWidth = Math.round(options.pageWidth);
 	if (options.pageHeight !== void 0) sectionProps.pageHeight = Math.round(options.pageHeight);
@@ -253,18 +381,15 @@ function createEmptyDocument(options = {}) {
 	if (styleSet?.theme) docxPackage.theme = structuredClone(styleSet.theme);
 	if (styleSet?.fontTable) docxPackage.fontTable = structuredClone(styleSet.fontTable);
 	if (styleSet?.settings) docxPackage.settings = structuredClone(styleSet.settings);
-	return {
+	const parseWarnings = styleSetWarnings();
+	const document = {
 		package: docxPackage,
 		templateVariables: [],
-		warnings: []
+		warnings: formatParseWarnings(parseWarnings)
 	};
+	if (parseWarnings.length > 0) document.parseWarnings = parseWarnings;
+	return document;
 }
-const validateDocumentStyleSet = (styleSet) => {
-	if (!styleSet) return;
-	if (styleSet.version !== 1) return panic(`Unsupported document style set version: ${styleSet.version}`);
-	if (styleSet.name.trim().length === 0) return panic("Document style set name cannot be empty");
-	if (styleSet.styles.styles.find((style) => style.styleId === styleSet.initialParagraphStyleId)?.type !== "paragraph") return panic(`Initial paragraph style "${styleSet.initialParagraphStyleId}" is missing from style set "${styleSet.name}"`);
-};
 /**
 * Create a document with a single paragraph containing the given text
 *

package/dist/utils/headingCollector.d.ts

@@ -1,3 +1,4 @@
+import { BuiltInStyleIndex } from "../docx/builtInStyles.js";
 import { Node } from "prosemirror-model";
 //#region src/utils/headingCollector.d.ts
 /**
@@ -14,12 +15,14 @@ type HeadingInfo = {
   pageNumber?: number | null;
 };
 /**
- * Collect all headings from a ProseMirror document.
+ * Collect all headings from a ProseMirror document, in document order.
  *
- * Detection logic:
- * 1. Check `outlineLevel` attr (set by OOXML parsing or style resolution)
- * 2. Fallback to `styleId` matching /^[Hh]eading(\d)$/
+ * Classification is {@link resolveHeadingLevel}'s: the paragraph's effective
+ * outline level, else the style's built-in `w:name`. Pass the open document's
+ * index (`styleResolver.builtInStyles`) so a localized style id such as
+ * `Nadpis1` or `berschrift1` resolves through its name rather than falling out
+ * of the outline.
  */
-declare function collectHeadings(doc: Node): HeadingInfo[];
+declare function collectHeadings(doc: Node, styles: BuiltInStyleIndex): HeadingInfo[];
 //#endregion
 export { HeadingInfo, collectHeadings };