@stll/folio-core 0.43.0 → 0.45.0

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/base64.d.ts

@@ -0,0 +1,36 @@
+//#region src/utils/base64.d.ts
+/**
+ * The package's one bytes-to-base64 encoder.
+ *
+ * Every call site that spelled this itself got a different answer to the same
+ * two questions, and one of them got the first question wrong:
+ *
+ * - `btoa(new TextDecoder("latin1").decode(bytes))` is not a binary string.
+ *   The Encoding standard maps the `latin1` label to windows-1252, so bytes
+ *   0x80-0x9F decode to characters outside Latin-1 and `btoa` throws
+ *   `InvalidCharacterError` on them. Ordinary image bytes contain those values,
+ *   so the browser path of that spelling fails on real input.
+ * - `String.fromCharCode(...chunk)` is correct but spreads a chunk's worth of
+ *   arguments per call, and the intermediate binary string is as large as the
+ *   input.
+ *
+ * Neither question has to be asked per call site, so it is asked here once.
+ * The runtime's own encoder answers it when the runtime has one, and the
+ * portable encoder below answers it when not; both produce canonical base64,
+ * so the choice is invisible in the output.
+ */
+/**
+ * Encode into exactly one intermediate buffer: ASCII codes are written into a
+ * single array and decoded once, so a megabyte-scale input leaves the output
+ * string and nothing else.
+ *
+ * Exported because the runtimes the tests run on all carry a native encoder,
+ * and the fallback is the branch the browsers that lack one take.
+ */
+declare const encodeBase64Portable: (bytes: Uint8Array) => string;
+/** Encode bytes as canonical, padded, standard-alphabet base64. */
+declare const bytesToBase64: (bytes: Uint8Array) => string;
+/** Encode bytes as a `data:` URL with the given media type. */
+declare const bytesToDataUrl: (bytes: Uint8Array, mimeType: string) => string;
+//#endregion
+export { bytesToBase64, bytesToDataUrl, encodeBase64Portable };

package/dist/utils/base64.js

@@ -0,0 +1,40 @@
+//#region src/utils/base64.ts
+const BASE64_CODES = Uint8Array.from("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", (character) => character.charCodeAt(0));
+const BASE64_PAD = 61;
+/**
+* Encode into exactly one intermediate buffer: ASCII codes are written into a
+* single array and decoded once, so a megabyte-scale input leaves the output
+* string and nothing else.
+*
+* Exported because the runtimes the tests run on all carry a native encoder,
+* and the fallback is the branch the browsers that lack one take.
+*/
+const encodeBase64Portable = (bytes) => {
+	const groups = Math.ceil(bytes.length / 3);
+	const encoded = new Uint8Array(groups * 4);
+	let read = 0;
+	let write = 0;
+	for (; read + 2 < bytes.length; read += 3) {
+		const triple = bytes[read] << 16 | bytes[read + 1] << 8 | bytes[read + 2];
+		encoded[write] = BASE64_CODES[triple >> 18 & 63];
+		encoded[write + 1] = BASE64_CODES[triple >> 12 & 63];
+		encoded[write + 2] = BASE64_CODES[triple >> 6 & 63];
+		encoded[write + 3] = BASE64_CODES[triple & 63];
+		write += 4;
+	}
+	const remaining = bytes.length - read;
+	if (remaining > 0) {
+		const tail = bytes[read] << 16 | (remaining === 2 ? bytes[read + 1] << 8 : 0);
+		encoded[write] = BASE64_CODES[tail >> 18 & 63];
+		encoded[write + 1] = BASE64_CODES[tail >> 12 & 63];
+		encoded[write + 2] = remaining === 2 ? BASE64_CODES[tail >> 6 & 63] : BASE64_PAD;
+		encoded[write + 3] = BASE64_PAD;
+	}
+	return new TextDecoder().decode(encoded);
+};
+/** Encode bytes as canonical, padded, standard-alphabet base64. */
+const bytesToBase64 = ("toBase64" in Uint8Array.prototype ? (bytes) => bytes.toBase64() : void 0) ?? encodeBase64Portable;
+/** Encode bytes as a `data:` URL with the given media type. */
+const bytesToDataUrl = (bytes, mimeType) => `data:${mimeType};base64,${bytesToBase64(bytes)}`;
+//#endregion
+export { bytesToBase64, bytesToDataUrl, encodeBase64Portable };

package/dist/utils/clipboard.js

@@ -1,5 +1,6 @@
 import { htmlCommentEnd } from "./htmlComments.js";
 import { stripXmlDeclarations } from "./stripXmlDeclarations.js";
+import { sanitizeXmlCharacters } from "@stll/docx-core";
 import createDOMPurify from "dompurify";
 //#region src/utils/clipboard.ts
 /**
@@ -567,7 +568,7 @@ function createTextRun(text, formatting) {
 		...formatting !== void 0 ? { formatting } : {},
 		content: [{
 			type: "text",
-			text
+			text: sanitizeXmlCharacters(text)
 		}]
 	};
 }

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 };

package/dist/utils/headingCollector.js

@@ -1,34 +1,32 @@
+import { resolveHeadingLevel } from "../docx/builtInStyles.js";
 //#region src/utils/headingCollector.ts
 /**
-* 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.
 */
-function collectHeadings(doc) {
+function collectHeadings(doc, styles) {
 	const headings = [];
 	doc.descendants((node, pos) => {
-		if (node.type.name === "paragraph") {
-			const level = node.attrs["outlineLevel"];
-			const styleId = node.attrs["styleId"];
-			let effectiveLevel = level;
-			if (effectiveLevel === null && styleId) {
-				const match = /^[Hh]eading(?<level>\d)$/u.exec(styleId);
-				if (match) effectiveLevel = Number.parseInt(match.groups["level"], 10) - 1;
-			}
-			if (effectiveLevel !== null && effectiveLevel >= 0 && effectiveLevel <= 8) {
-				let text = "";
-				node.forEach((child) => {
-					if (child.isText) text += child.text || "";
-				});
-				if (text.trim()) headings.push({
-					text: text.trim(),
-					level: effectiveLevel,
-					pmPos: pos
-				});
-			}
-		}
+		if (node.type.name !== "paragraph") return;
+		const level = resolveHeadingLevel({
+			outlineLevel: node.attrs["outlineLevel"],
+			styleId: node.attrs["styleId"]
+		}, styles);
+		if (level === void 0) return;
+		let text = "";
+		node.forEach((child) => {
+			if (child.isText) text += child.text || "";
+		});
+		if (text.trim()) headings.push({
+			text: text.trim(),
+			level,
+			pmPos: pos
+		});
 	});
 	return headings;
 }

package/dist/utils/tableOfContentsStyle.js

@@ -1,6 +1,13 @@
+import { normalizeStyleName } from "../docx/builtInStyles.js";
 //#region src/utils/tableOfContentsStyle.ts
 const TABLE_OF_CONTENTS_STYLE_ID = /^TOC(?<level>\d*)$/iu;
-const TABLE_OF_CONTENTS_STYLE_NAME = /^toc\s+(?<level>\d+)$/iu;
+/**
+* Against an already-normalised name, so the same tolerance applies here as in
+* `builtInStyles.ts`: the corpus carries `toc 1`, `TOC 1` and even `TOC  1`
+* with a double space, and a producer that drops the space entirely would
+* otherwise fall out.
+*/
+const TABLE_OF_CONTENTS_STYLE_NAME = /^toc(?<level>\d+)$/u;
 const parsedLevel = (match) => {
 	if (!match) return;
 	const rawLevel = match.groups?.["level"];
@@ -9,6 +16,6 @@ const parsedLevel = (match) => {
 	return Number.isSafeInteger(level) && level > 0 ? level : void 0;
 };
 /** Resolve a built-in TOC entry style without relying on its localized style id. */
-const tableOfContentsStyleLevel = ({ styleId, styleName }) => parsedLevel(TABLE_OF_CONTENTS_STYLE_ID.exec(styleId ?? "")) ?? parsedLevel(TABLE_OF_CONTENTS_STYLE_NAME.exec(styleName ?? ""));
+const tableOfContentsStyleLevel = ({ styleId, styleName }) => parsedLevel(TABLE_OF_CONTENTS_STYLE_ID.exec(styleId ?? "")) ?? parsedLevel(TABLE_OF_CONTENTS_STYLE_NAME.exec(normalizeStyleName(styleName ?? "")));
 //#endregion
 export { tableOfContentsStyleLevel };

package/dist/utils/units.d.ts

@@ -48,6 +48,15 @@ declare function emuToPixels(emu: number | undefined | null): number;
  * floating-point drift (e.g. 52 px → 495299.99999999994) out of the document.
  */
 declare function pixelsToEmu(px: number): number;
+/**
+ * Convert EMUs to pixels for a stroke width.
+ *
+ * Strokes are sub-pixel, so unlike a box size they keep two decimals rather
+ * than rounding to whole pixels. The projection is still lossy: a consumer that
+ * has to write the document's own number back carries the authored EMU beside
+ * the pixels rather than converting these back.
+ */
+declare function emuToStrokePixels(emu: number): number;
 /**
  * Convert EMUs to twips. Twips are integer-typed in OOXML; round here.
  */
@@ -96,4 +105,4 @@ declare function clamp(value: number, min: number, max: number): number;
  */
 declare function formatPx(px: number): string;
 //#endregion
-export { AUTO_PARAGRAPH_SPACING_PX, PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels };
+export { AUTO_PARAGRAPH_SPACING_PX, PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToStrokePixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels };

package/dist/utils/units.js

@@ -68,6 +68,17 @@ function pixelsToEmu(px) {
 	return Math.round(px / 96 * EMUS_PER_INCH);
 }
 /**
+* Convert EMUs to pixels for a stroke width.
+*
+* Strokes are sub-pixel, so unlike a box size they keep two decimals rather
+* than rounding to whole pixels. The projection is still lossy: a consumer that
+* has to write the document's own number back carries the authored EMU beside
+* the pixels rather than converting these back.
+*/
+function emuToStrokePixels(emu) {
+	return roundPixels(emu / EMUS_PER_INCH * 96);
+}
+/**
 * Convert EMUs to twips. Twips are integer-typed in OOXML; round here.
 */
 function emuToTwips(emu) {
@@ -136,4 +147,4 @@ function formatPx(px) {
 	return `${roundPixels(px)}px`;
 }
 //#endregion
-export { AUTO_PARAGRAPH_SPACING_PX, PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels };
+export { AUTO_PARAGRAPH_SPACING_PX, PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToStrokePixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels };

package/dist/utils/urlSecurity.d.ts

@@ -2,6 +2,12 @@ import { sanitizeExternalUrl } from "@stll/docx-core";
 //#region src/utils/urlSecurity.d.ts
 declare function normalizeUserUrl(rawUrl: string): string;
 declare function isAllowedUserUrl(rawUrl: string): boolean;
-declare function sanitizeLinkTarget(target: string | undefined): string;
+type AnchorTargetAttrs = {
+  target: string;
+  rel: string;
+};
+declare function anchorTargetAttrs(authoredFrame: string | undefined): AnchorTargetAttrs;
+/** `window.open` features carrying the same guarantees as {@link ANCHOR_REL}. */
+declare function windowFeaturesFor({ rel }: AnchorTargetAttrs): string;
 //#endregion
-export { isAllowedUserUrl, normalizeUserUrl, sanitizeExternalUrl, sanitizeLinkTarget };
+export { AnchorTargetAttrs, anchorTargetAttrs, isAllowedUserUrl, normalizeUserUrl, sanitizeExternalUrl, windowFeaturesFor };

package/dist/utils/urlSecurity.js

@@ -23,8 +23,26 @@ function normalizeUserUrl(rawUrl) {
 function isAllowedUserUrl(rawUrl) {
 	return normalizeUserUrl(rawUrl) !== "";
 }
-function sanitizeLinkTarget(target) {
-	return target && ALLOWED_TARGETS.has(target) ? target : "_blank";
+/**
+* The `target` and `rel` one authored frame may produce on a DOM anchor.
+*
+* A `w:tgtFrame` is a frame name, and a named frame addresses another browsing
+* context: honouring an arbitrary one would let a document reach a frame it did
+* not create. Every anchor and every navigation folio produces goes through
+* here, so the clamp and the `rel` that must accompany `_blank` are decided
+* once. The authored name itself stays in the model and is written back on
+* save; clamping it at parse rewrote the document.
+*/
+const ANCHOR_REL = "noopener noreferrer";
+function anchorTargetAttrs(authoredFrame) {
+	return {
+		target: authoredFrame && ALLOWED_TARGETS.has(authoredFrame) ? authoredFrame : "_blank",
+		rel: ANCHOR_REL
+	};
+}
+/** `window.open` features carrying the same guarantees as {@link ANCHOR_REL}. */
+function windowFeaturesFor({ rel }) {
+	return rel.replaceAll(" ", ",");
 }
 function findFirstPathSeparatorIndex(value) {
 	return [
@@ -44,4 +62,4 @@ function startsWithPortSuffix(value) {
 	return index > 0 && (index === value.length || "/?#".includes(value[index]));
 }
 //#endregion
-export { isAllowedUserUrl, normalizeUserUrl, sanitizeExternalUrl, sanitizeLinkTarget };
+export { anchorTargetAttrs, isAllowedUserUrl, normalizeUserUrl, sanitizeExternalUrl, windowFeaturesFor };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.43.0",
+  "version": "0.45.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",
@@ -121,7 +121,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.21.0",
+    "@stll/docx-core": "^0.23.0",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": ">=0.4.0 <1.0.0",
     "better-result": "3.0.1",

package/dist/docx/textWhitespace.d.ts

@@ -1,4 +0,0 @@
-//#region src/docx/textWhitespace.d.ts
-declare const requiresXmlSpacePreserve: (text: string) => boolean;
-//#endregion
-export { requiresXmlSpacePreserve };

package/dist/docx/textWhitespace.js

@@ -1,4 +0,0 @@
-//#region src/docx/textWhitespace.ts
-const requiresXmlSpacePreserve = (text) => text.startsWith(" ") || text.endsWith(" ") || text.includes("  ");
-//#endregion
-export { requiresXmlSpacePreserve };

package/dist/layout-bridge/engine/tableWidthUtils.d.ts

@@ -1,6 +0,0 @@
-import { document_d_exports } from "../../types/document.js";
-//#region src/layout-bridge/engine/tableWidthUtils.d.ts
-declare function resolveTableWidthPx(width: number | undefined, widthType: document_d_exports.TableWidthType | undefined, containerWidth: number): number | undefined;
-declare function normalizeTableColumnWidths(widths: number[], columnCount: number, targetWidth: number): number[];
-//#endregion
-export { normalizeTableColumnWidths, resolveTableWidthPx };

package/dist/layout-bridge/engine/tableWidthUtils.js

@@ -1,25 +0,0 @@
-//#region src/layout-bridge/engine/tableWidthUtils.ts
-const TWIPS_PER_INCH = 1440;
-const PX_PER_INCH = 96;
-const PCT_DENOMINATOR = 5e3;
-const twipsToPixels = (twips) => twips / TWIPS_PER_INCH * PX_PER_INCH;
-function resolveTableWidthPx(width, widthType, containerWidth) {
-	if (width === void 0 || width <= 0) return;
-	if (widthType === "dxa") return twipsToPixels(width);
-	if (widthType === "pct") return width / PCT_DENOMINATOR * containerWidth;
-}
-function normalizeTableColumnWidths(widths, columnCount, targetWidth) {
-	if (columnCount <= 0) return [];
-	if (widths.length === 0) return Array.from({ length: columnCount }, () => targetWidth / columnCount);
-	const normalized = widths.slice(0, columnCount);
-	const positives = normalized.filter((width) => width > 0);
-	const fallback = positives.length > 0 ? positives.reduce((sum, width) => sum + width, 0) / positives.length : targetWidth / columnCount;
-	while (normalized.length < columnCount) normalized.push(fallback);
-	let fixedTotal = 0;
-	for (const width of normalized) if (width > 0) fixedTotal += width;
-	const missingCount = normalized.filter((width) => width <= 0).length;
-	const missingWidth = missingCount > 0 ? Math.max(0, targetWidth - fixedTotal) / missingCount : 0;
-	return normalized.map((width) => width > 0 ? width : missingWidth);
-}
-//#endregion
-export { normalizeTableColumnWidths, resolveTableWidthPx };

package/dist/markdown/headings.d.ts

@@ -1,13 +0,0 @@
-//#region src/markdown/headings.d.ts
-/**
- * Heading-style detection from a paragraph style id. Ported from eigenpal
- * `agent/text-utils` (PR #595) so the markdown exporter stays self-contained
- * (folio has no `agent/text-utils` module). Word's built-in heading styles are
- * `Heading1`…`Heading9` (and localised aliases that still contain "heading").
- */
-/** True when the style id denotes a Word heading style. */
-declare function isHeadingStyle(styleId?: string): boolean;
-/** Extract the 1-based heading level from a style id, or undefined. */
-declare function parseHeadingLevel(styleId?: string): number | undefined;
-//#endregion
-export { isHeadingStyle, parseHeadingLevel };