@stll/folio-core 0.62.0 → 0.63.0

package/dist/utils/headerFooter.d.ts

@@ -1,12 +1,12 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/utils/headerFooter.d.ts
-type HeaderFooterPosition = "header" | "footer";
+export type HeaderFooterPosition = "header" | "footer";
 /**
  * The resolved header/footer slots for the active document, plus the
  * relationship ids that save/remove must target (the *displayed* slot's rId,
  * not necessarily `finalSectionProperties`).
  */
-type HeaderFooterResolution = {
+export type HeaderFooterResolution = {
   headerContent: document_d_exports.HeaderFooter | null;
   footerContent: document_d_exports.HeaderFooter | null;
   firstPageHeaderContent: document_d_exports.HeaderFooter | null;
@@ -21,21 +21,21 @@ type HeaderFooterResolution = {
  * Resolve the header/footer content (and the active relationship ids) for a
  * parsed package. Returns the empty resolution when no package is loaded.
  */
-declare const resolveHeaderFooterContent: (pkg: document_d_exports.DocxPackage | undefined) => HeaderFooterResolution;
+export declare const resolveHeaderFooterContent: (pkg: document_d_exports.DocxPackage | undefined) => HeaderFooterResolution;
 /**
  * The section properties that drive the rendered chrome, with `titlePg` merged
  * in when title-page mode was inferred from header/footer references.
  */
-declare const resolveEffectiveSectionProperties: (documentBody: document_d_exports.DocumentBody | undefined, hasTitlePg: boolean) => document_d_exports.SectionProperties | undefined;
+export declare const resolveEffectiveSectionProperties: (documentBody: document_d_exports.DocumentBody | undefined, hasTitlePg: boolean) => document_d_exports.SectionProperties | undefined;
 /** Pick the relationship id for the slot a save/remove targets. */
-declare const pickActiveHeaderFooterRId: (resolution: HeaderFooterResolution, position: HeaderFooterPosition, isFirstPage: boolean) => string | null;
+export declare const pickActiveHeaderFooterRId: (resolution: HeaderFooterResolution, position: HeaderFooterPosition, isFirstPage: boolean) => string | null;
 /**
  * Build a Document with a fresh empty header/footer for the given slot, wired
  * into `finalSectionProperties` via a new reference. Returns null when the
  * document has no final section properties to attach the reference to.
  */
-declare const createEmptyHeaderFooter: (document: document_d_exports.Document, position: HeaderFooterPosition, isFirstPage: boolean) => document_d_exports.Document | null;
-type SaveHeaderFooterArgs = {
+export declare const createEmptyHeaderFooter: (document: document_d_exports.Document, position: HeaderFooterPosition, isFirstPage: boolean) => document_d_exports.Document | null;
+export type SaveHeaderFooterArgs = {
   document: document_d_exports.Document;
   position: HeaderFooterPosition;
   isFirstPage: boolean;
@@ -50,8 +50,8 @@ type SaveHeaderFooterArgs = {
  * Document untouched so undo can step back to the pre-edit state. Returns null
  * when the target header/footer cannot be found.
  */
-declare const saveHeaderFooterContent: ({ document, position, isFirstPage, activeRId, blocks }: SaveHeaderFooterArgs) => document_d_exports.Document | null;
-type RemoveHeaderFooterArgs = {
+export declare const saveHeaderFooterContent: ({ document, position, isFirstPage, activeRId, blocks }: SaveHeaderFooterArgs) => document_d_exports.Document | null;
+export type RemoveHeaderFooterArgs = {
   document: document_d_exports.Document;
   position: HeaderFooterPosition;
   /** The relationship id the displayed slot resolves to (`pickActiveHeaderFooterRId`). */
@@ -61,6 +61,5 @@ type RemoveHeaderFooterArgs = {
  * Remove a header/footer and drop its reference from every section that points
  * at it, returning the new Document.
  */
-declare const removeHeaderFooter: ({ document, position, activeRId }: RemoveHeaderFooterArgs) => document_d_exports.Document;
-//#endregion
-export { HeaderFooterPosition, HeaderFooterResolution, RemoveHeaderFooterArgs, SaveHeaderFooterArgs, createEmptyHeaderFooter, pickActiveHeaderFooterRId, removeHeaderFooter, resolveEffectiveSectionProperties, resolveHeaderFooterContent, saveHeaderFooterContent };
+export declare const removeHeaderFooter: ({ document, position, activeRId }: RemoveHeaderFooterArgs) => document_d_exports.Document;
+//#endregion

package/dist/utils/headerFooter.js

@@ -1,5 +1,15 @@
 import { clearHeaderFooterVerbatimXml } from "../docx/headerFooterVerbatim.js";
 //#region src/utils/headerFooter.ts
+/**
+* Header/footer document-model operations, extracted from the React
+* `useHeaderFooterEditor` hook. Pure functions over the folio `Document`
+* model: resolving which header/footer renders for each slot, and building the
+* new `Document` produced by creating, saving, or removing a header/footer.
+*
+* ProseMirror stays in the adapter: the save path serialises the live hidden
+* header/footer PM doc to `BlockContent[]` (`proseDocToBlocks`) and passes the
+* blocks in here.
+*/
 const EMPTY_RESOLUTION = {
 	headerContent: null,
 	footerContent: null,

package/dist/utils/headingCollector.d.ts

@@ -4,7 +4,7 @@ import { Node } from "prosemirror-model";
 /**
  * Information about a heading found in the document.
  */
-type HeadingInfo = {
+export type HeadingInfo = {
   /** The text content of the heading */
   text: string;
   /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */
@@ -23,6 +23,5 @@ type HeadingInfo = {
  * `Nadpis1` or `berschrift1` resolves through its name rather than falling out
  * of the outline.
  */
-declare function collectHeadings(doc: Node, styles: BuiltInStyleIndex): HeadingInfo[];
-//#endregion
-export { HeadingInfo, collectHeadings };
+export declare function collectHeadings(doc: Node, styles: BuiltInStyleIndex): HeadingInfo[];
+//#endregion

package/dist/utils/hexId.d.ts

@@ -14,7 +14,7 @@
  * to survive both Word ("Document Recovery — Table Properties") and
  * strict OOXML validators.
  */
-declare const MAX_HEX_ID_EXCLUSIVE = 2147483647;
+export declare const MAX_HEX_ID_EXCLUSIVE = 2147483647;
 /**
  * OOXML `ST_LongHexNumber` shape: exactly 8 hex digits (`xsd:hexBinary`,
  * length 4 bytes). `w14:paraId` / `w14:textId` / comment `paraId` /
@@ -22,9 +22,9 @@ declare const MAX_HEX_ID_EXCLUSIVE = 2147483647;
  * is not a real Word id — it must not be trusted as one (e.g. echoed
  * unescaped into serialized XML attributes).
  */
-declare const HEX_ID_PATTERN: RegExp;
+export declare const HEX_ID_PATTERN: RegExp;
 /** Whether `value` is a well-formed 8-hex-digit OOXML long-hex id. */
-declare const isValidHexId: (value: string | undefined | null) => boolean;
+export declare const isValidHexId: (value: string | undefined | null) => boolean;
 /**
  * Random 8-char uppercase hex id, matching Microsoft's `w14:paraId`
  * extension format (also reused for comment `paraId` / `durableId`).
@@ -35,7 +35,7 @@ declare const isValidHexId: (value: string | undefined | null) => boolean;
  * Uses `Math.random()` rather than `crypto.randomUUID()` so the
  * generator works in non-secure contexts (file://, web workers).
  */
-declare const generateHexId: () => string;
+export declare const generateHexId: () => string;
 /**
  * Deterministic 8-char uppercase hex id (FNV-1a over `seed`), `< 0x7FFFFFFF`.
  * Re-deriving from the same seed mints the same id, so content/position-derived
@@ -45,6 +45,5 @@ declare const generateHexId: () => string;
  * sentinel, and remapping only that one (already invalid) output keeps every
  * previously shipped deterministic id unchanged.
  */
-declare const deterministicHexId: (seed: string) => string;
-//#endregion
-export { HEX_ID_PATTERN, MAX_HEX_ID_EXCLUSIVE, deterministicHexId, generateHexId, isValidHexId };
+export declare const deterministicHexId: (seed: string) => string;
+//#endregion

package/dist/utils/hexId.js

@@ -35,7 +35,7 @@ const isValidHexId = (value) => typeof value === "string" && HEX_ID_PATTERN.test
 * Uses `Math.random()` rather than `crypto.randomUUID()` so the
 * generator works in non-secure contexts (file://, web workers).
 */
-const generateHexId = () => (Math.floor(Math.random() * (MAX_HEX_ID_EXCLUSIVE - 1)) + 1).toString(16).toUpperCase().padStart(8, "0");
+const generateHexId = () => (Math.floor(Math.random() * 2147483646) + 1).toString(16).toUpperCase().padStart(8, "0");
 /**
 * Deterministic 8-char uppercase hex id (FNV-1a over `seed`), `< 0x7FFFFFFF`.
 * Re-deriving from the same seed mints the same id, so content/position-derived

package/dist/utils/horizontalScale.d.ts

@@ -5,7 +5,7 @@
  * The OOXML value is bounded from 0% through 600%. Missing or malformed
  * values use the document default (100%) and stay absent in the model.
  */
-declare function normalizeHorizontalScalePercent(horizontalScale: number | null | undefined): number | undefined;
+export declare function normalizeHorizontalScalePercent(horizontalScale: number | null | undefined): number | undefined;
 /**
  * Parse the lexical forms accepted by OOXML `ST_TextScale`.
  *
@@ -13,8 +13,8 @@ declare function normalizeHorizontalScalePercent(horizontalScale: number | null
  * unsigned decimal grammar defined by `ST_TextScalePercent`. Surrounding
  * whitespace is ignored, but an empty value or partial numeric prefix is not.
  */
-declare function parseHorizontalScalePercent(horizontalScale: string | null | undefined): number | undefined;
-declare function getHorizontalScaleFactor(horizontalScale: number | null | undefined): number;
+export declare function parseHorizontalScalePercent(horizontalScale: string | null | undefined): number | undefined;
+export declare function getHorizontalScaleFactor(horizontalScale: number | null | undefined): number;
 /**
  * Quantize an in-range model value for OOXML's integer-only representation.
  *
@@ -23,6 +23,5 @@ declare function getHorizontalScaleFactor(horizontalScale: number | null | undef
  * preserving the existing integer-attribute contract without emitting an
  * invalid fractional value.
  */
-declare function roundHorizontalScalePercentForSerialization(horizontalScale: number | null | undefined): number | undefined;
-//#endregion
-export { getHorizontalScaleFactor, normalizeHorizontalScalePercent, parseHorizontalScalePercent, roundHorizontalScalePercentForSerialization };
+export declare function roundHorizontalScalePercentForSerialization(horizontalScale: number | null | undefined): number | undefined;
+//#endregion

package/dist/utils/htmlComments.d.ts

@@ -12,6 +12,5 @@
  *
  * Both comment strippers resolve the terminator here so the two cannot drift.
  */
-declare const htmlCommentEnd: (html: string, start: number) => number | null;
-//#endregion
-export { htmlCommentEnd };
+export declare const htmlCommentEnd: (html: string, start: number) => number | null;
+//#endregion

package/dist/utils/imageLuminance.d.ts

@@ -1,15 +1,14 @@
 //#region src/utils/imageLuminance.d.ts
-type ImageLuminance = {
+export type ImageLuminance = {
   brightness?: number | null;
   contrast?: number | null;
 };
 /** Clamp a finite percentage to the range accepted by DrawingML `a:lum`. */
-declare const normalizeImageLuminancePercent: (value: number) => number;
+export declare const normalizeImageLuminancePercent: (value: number) => number;
 /**
  * Convert DrawingML brightness and contrast percentages into Word's single
  * linear per-channel transfer, expressed as CSS filters without an
  * intermediate clamp changing the result.
  */
-declare const imageLuminanceFilter: ({ brightness, contrast }: ImageLuminance) => string | undefined;
-//#endregion
-export { ImageLuminance, imageLuminanceFilter, normalizeImageLuminancePercent };
+export declare const imageLuminanceFilter: ({ brightness, contrast }: ImageLuminance) => string | undefined;
+//#endregion

package/dist/utils/imageResize.d.ts

@@ -0,0 +1,18 @@
+//#region src/utils/imageResize.d.ts
+declare const IMAGE_RESIZE_HANDLE_VALUES: readonly ["nw", "ne", "se", "sw", "n", "s", "e", "w"];
+export type ImageResizeHandle = (typeof IMAGE_RESIZE_HANDLE_VALUES)[number];
+export declare const IMAGE_RESIZE_HANDLES: readonly ImageResizeHandle[];
+type ImageResizeOptions = {
+  handle: ImageResizeHandle;
+  deltaX: number;
+  deltaY: number;
+  startWidth: number;
+  startHeight: number;
+  aspect: "locked" | "free";
+};
+export declare const calculateResizedImageDimensions: ({ handle, deltaX, deltaY, startWidth, startHeight, aspect }: ImageResizeOptions) => {
+  width: number;
+  height: number;
+};
+//#endregion
+export {};

package/dist/utils/imageResize.js

@@ -0,0 +1,37 @@
+const IMAGE_RESIZE_HANDLES = [
+	"nw",
+	"ne",
+	"se",
+	"sw",
+	"n",
+	"s",
+	"e",
+	"w"
+];
+const MIN_IMAGE_PX = 20;
+const MAX_IMAGE_PX = 2e3;
+const calculateResizedImageDimensions = ({ handle, deltaX, deltaY, startWidth, startHeight, aspect }) => {
+	const drivesWidth = handle.includes("w") || handle.includes("e");
+	const drivesHeight = handle.includes("n") || handle.includes("s");
+	const signX = handle.includes("w") ? -1 : 1;
+	const signY = handle.includes("n") ? -1 : 1;
+	if (drivesWidth && drivesHeight && aspect === "locked") {
+		const scaleX = startWidth > 0 ? (startWidth + deltaX * signX) / startWidth : 1;
+		const scaleY = startHeight > 0 ? (startHeight + deltaY * signY) / startHeight : 1;
+		const desiredScale = Math.abs(scaleX - 1) > Math.abs(scaleY - 1) ? scaleX : scaleY;
+		const minScale = Math.max(startWidth > 0 ? MIN_IMAGE_PX / startWidth : 0, startHeight > 0 ? MIN_IMAGE_PX / startHeight : 0);
+		const maxScale = Math.min(startWidth > 0 ? MAX_IMAGE_PX / startWidth : Infinity, startHeight > 0 ? MAX_IMAGE_PX / startHeight : Infinity);
+		const scale = Math.min(maxScale, Math.max(minScale, desiredScale));
+		return {
+			width: startWidth * scale,
+			height: startHeight * scale
+		};
+	}
+	const clamp = (dimension) => Math.max(MIN_IMAGE_PX, Math.min(MAX_IMAGE_PX, dimension));
+	return {
+		width: drivesWidth ? clamp(startWidth + deltaX * signX) : startWidth,
+		height: drivesHeight ? clamp(startHeight + deltaY * signY) : startHeight
+	};
+};
+//#endregion
+export { IMAGE_RESIZE_HANDLES, calculateResizedImageDimensions };

package/dist/utils/imageValidation.d.ts

@@ -1,5 +1,4 @@
 //#region src/utils/imageValidation.d.ts
-declare function isAllowedImageMimeType(mimeType: string): boolean;
-declare function isSafeImageFile(file: File): Promise<boolean>;
-//#endregion
-export { isAllowedImageMimeType, isSafeImageFile };
+export declare function isAllowedImageMimeType(mimeType: string): boolean;
+export declare function isSafeImageFile(file: File): Promise<boolean>;
+//#endregion

package/dist/utils/imageValidation.js

@@ -1,5 +1,5 @@
 //#region src/utils/imageValidation.ts
-const MAX_INSERTED_IMAGE_BYTES = 10 * 1024 * 1024;
+const MAX_INSERTED_IMAGE_BYTES = 10485760;
 const ALLOWED_IMAGE_MIME_TYPES = /* @__PURE__ */ new Set([
 	"image/png",
 	"image/jpeg",

package/dist/utils/joiningTypes.gen.d.ts

@@ -15,12 +15,11 @@
  * which is why it is by far the largest table.
  */
 /** Joining_Type D, L or C: connects to the FOLLOWING character. */
-declare const JOINS_FORWARD_RANGES: readonly number[];
+export declare const JOINS_FORWARD_RANGES: readonly number[];
 /** Joining_Type D, R or C: connects to the PRECEDING character. */
-declare const JOINS_BACKWARD_RANGES: readonly number[];
+export declare const JOINS_BACKWARD_RANGES: readonly number[];
 /** Joining_Type T: transparent, skipped when looking for a joining neighbour. */
-declare const JOINING_TRANSPARENT_RANGES: readonly number[];
+export declare const JOINING_TRANSPARENT_RANGES: readonly number[];
 /** Joining_Type D, L or R: a cursive letter. Gates the whole joining path. */
-declare const JOINING_LETTER_RANGES: readonly number[];
-//#endregion
-export { JOINING_LETTER_RANGES, JOINING_TRANSPARENT_RANGES, JOINS_BACKWARD_RANGES, JOINS_FORWARD_RANGES };
+export declare const JOINING_LETTER_RANGES: readonly number[];
+//#endregion

package/dist/utils/mergeDocumentContent.d.ts

@@ -23,6 +23,5 @@ import { document_d_exports } from "../types/document.js";
  * const bytes = await createDocx(merged);
  * ```
  */
-declare function mergeDocumentContent(target: document_d_exports.Document, source: document_d_exports.Document): document_d_exports.Document;
-//#endregion
-export { mergeDocumentContent };
+export declare function mergeDocumentContent(target: document_d_exports.Document, source: document_d_exports.Document): document_d_exports.Document;
+//#endregion

package/dist/utils/mergeDocumentContent.js

@@ -3,6 +3,13 @@ import { paragraphNumberingReferenceId } from "../docx/numberingReference.js";
 import { cloneParagraphWithoutPropertySource } from "../docx/paragraphPropertySource.js";
 //#region src/utils/mergeDocumentContent.ts
 /**
+* Merge Document Content Utility
+*
+* Composes two documents by appending one document's body content onto
+* another's, renumbering any list numbering the source carries so it can
+* never collide with numbering the target already defines.
+*/
+/**
 * Append `source`'s body content onto `target`'s. Both documents keep their
 * own identity — this returns a new `Document`; neither argument is mutated.
 *

package/dist/utils/noteReferenceLabels.d.ts

@@ -13,17 +13,17 @@
  * endnote's token carries an `e` so the two sequences never collide
  * (`[^1]` is footnote 1, `[^e1]` is endnote 1).
  */
-type NoteReferenceKind = "footnote" | "endnote";
+export type NoteReferenceKind = "footnote" | "endnote";
 /** The bare token: `1` for footnote 1, `e1` for endnote 1. */
-declare const noteReferenceToken: (kind: NoteReferenceKind, displayNumber: number) => string;
+export declare const noteReferenceToken: (kind: NoteReferenceKind, displayNumber: number) => string;
 /** The marker a text reader shows in the line: `[^1]`, `[^e1]`. */
-declare const noteReferenceMarker: (kind: NoteReferenceKind, displayNumber: number) => string;
-type NoteReferenceNumber = {
+export declare const noteReferenceMarker: (kind: NoteReferenceKind, displayNumber: number) => string;
+export type NoteReferenceNumber = {
   displayNumber: number;
   /** Whether this is the note's first reference in reading order. */
   first: boolean;
 };
-type NoteReferenceNumbering = {
+export type NoteReferenceNumbering = {
   /** Number one reference, in reading order. */
   next: (kind: NoteReferenceKind, noteId: string | number) => NoteReferenceNumber;
 };
@@ -31,6 +31,5 @@ type NoteReferenceNumbering = {
  * A reading-order numbering: each note takes the next number of its kind the
  * first time it is referenced, and a repeated reference reuses it.
  */
-declare const createNoteReferenceNumbering: () => NoteReferenceNumbering;
-//#endregion
-export { NoteReferenceKind, NoteReferenceNumber, NoteReferenceNumbering, createNoteReferenceNumbering, noteReferenceMarker, noteReferenceToken };
+export declare const createNoteReferenceNumbering: () => NoteReferenceNumbering;
+//#endregion

package/dist/utils/ooxmlSymbol.d.ts

@@ -1,4 +1,6 @@
 //#region src/utils/ooxmlSymbol.d.ts
-declare const decodeOoxmlSymbolCharacter: (value: string) => string | null;
-//#endregion
-export { decodeOoxmlSymbolCharacter };
+export declare const isOoxmlSymbolFont: (font: string) => boolean;
+export declare const lookupOoxmlSymbolUnicodeTwin: (codePoint: number) => string | undefined;
+export declare const decodeOoxmlSymbolCharacter: (value: string) => string | null;
+export declare const displayOoxmlSymbolCharacter: (font: string, value: string) => string | null;
+//#endregion

package/dist/utils/ooxmlSymbol.js

@@ -1,5 +1,55 @@
 import { isOoxmlSymbolCharacter } from "@stll/docx-core/model";
 //#region src/utils/ooxmlSymbol.ts
+const SYMBOL_BULLET_MAP = /* @__PURE__ */ new Map([
+	[183, "•"],
+	[111, "○"],
+	[167, "■"],
+	[252, "✓"],
+	[110, "■"],
+	[113, "○"],
+	[117, "◆"],
+	[118, "❖"],
+	[168, "✓"],
+	[251, "✓"],
+	[254, "✓"],
+	[61623, "•"],
+	[61550, "■"],
+	[61551, "○"],
+	[61607, "■"],
+	[61692, "✓"],
+	[8226, "•"],
+	[9679, "●"],
+	[9675, "○"],
+	[9632, "■"],
+	[9633, "□"],
+	[9670, "◆"],
+	[9671, "◇"],
+	[8211, "–"],
+	[8212, "—"],
+	[62, ">"],
+	[45, "-"]
+]);
+const SYMBOL_FONT_NAMES = /* @__PURE__ */ new Set([
+	"symbol",
+	"wingdings",
+	"wingdings 2",
+	"wingdings 3",
+	"webdings"
+]);
+const SYMBOL_DISPLAY_TWIN_CODES = /* @__PURE__ */ new Map([["symbol", /* @__PURE__ */ new Set([61623])], ["wingdings", /* @__PURE__ */ new Set([
+	61550,
+	61551,
+	61607,
+	61692
+])]]);
+const isOoxmlSymbolFont = (font) => SYMBOL_FONT_NAMES.has(font.trim().toLowerCase());
+const lookupOoxmlSymbolUnicodeTwin = (codePoint) => SYMBOL_BULLET_MAP.get(codePoint);
 const decodeOoxmlSymbolCharacter = (value) => isOoxmlSymbolCharacter(value) ? String.fromCodePoint(Number.parseInt(value, 16)) : null;
+const displayOoxmlSymbolCharacter = (font, value) => {
+	if (!isOoxmlSymbolCharacter(value)) return null;
+	const codePoint = Number.parseInt(value, 16);
+	if (!SYMBOL_DISPLAY_TWIN_CODES.get(font.trim().toLowerCase())?.has(codePoint)) return decodeOoxmlSymbolCharacter(value);
+	return lookupOoxmlSymbolUnicodeTwin(codePoint) ?? decodeOoxmlSymbolCharacter(value);
+};
 //#endregion
-export { decodeOoxmlSymbolCharacter };
+export { decodeOoxmlSymbolCharacter, displayOoxmlSymbolCharacter, isOoxmlSymbolFont, lookupOoxmlSymbolUnicodeTwin };

package/dist/utils/outlineDepth.d.ts

@@ -1,9 +1,8 @@
 import { HeadingInfo } from "./headingCollector.js";
 //#region src/utils/outlineDepth.d.ts
 /** Maximum heading depth displayed in the document outline. */
-type OutlineDepth = 2 | 3 | "all";
-declare const DEFAULT_OUTLINE_DEPTH = 2;
+export type OutlineDepth = 2 | 3 | "all";
+export declare const DEFAULT_OUTLINE_DEPTH = 2;
 /** Filter headings for the outline without changing their document order. */
-declare const filterHeadingsByDepth: (headings: readonly HeadingInfo[], depth: OutlineDepth) => HeadingInfo[];
-//#endregion
-export { DEFAULT_OUTLINE_DEPTH, OutlineDepth, filterHeadingsByDepth };
+export declare const filterHeadingsByDepth: (headings: readonly HeadingInfo[], depth: OutlineDepth) => HeadingInfo[];
+//#endregion

package/dist/utils/paragraphBaseDirection.d.ts

@@ -1,6 +1,5 @@
 import { ParagraphBlock } from "../layout-engine/types.js";
 //#region src/utils/paragraphBaseDirection.d.ts
 /** Resolve the paragraph direction used by both measurement and painting. */
-declare const isRtlParagraph: (block: ParagraphBlock) => boolean;
-//#endregion
-export { isRtlParagraph };
+export declare const isRtlParagraph: (block: ParagraphBlock) => boolean;
+//#endregion

package/dist/utils/paragraphBaseDirection.js

@@ -6,7 +6,8 @@ const isRtlParagraph = (block) => {
 	if (block.attrs?.bidi !== void 0) return block.attrs.bidi;
 	const runs = block.runs.filter(isDirectionalTextRun);
 	if (!runs.some(({ rtl }) => rtl === true)) return false;
-	return detectBaseDirection(runs.map((run) => run.kind === "text" ? run.text : run.fallback ?? "").join("")) !== "ltr";
+	const text = runs.map((run) => run.kind === "text" ? run.text : run.fallback ?? "").join("");
+	return detectBaseDirection(text) !== "ltr";
 };
 //#endregion
 export { isRtlParagraph };

package/dist/utils/paragraphFormattingMerge.d.ts

@@ -9,8 +9,8 @@ import { document_d_exports } from "../types/document.js";
  * clear entry also lets the tab calculator suppress an automatic stop at the
  * same position.
  */
-declare function mergeParagraphTabStops(inherited: document_d_exports.TabStop[] | undefined, direct: document_d_exports.TabStop[]): document_d_exports.TabStop[];
-declare function mergeParagraphTabStops(inherited: document_d_exports.TabStop[] | undefined, direct: document_d_exports.TabStop[] | undefined): document_d_exports.TabStop[] | undefined;
+export declare function mergeParagraphTabStops(inherited: document_d_exports.TabStop[] | undefined, direct: document_d_exports.TabStop[]): document_d_exports.TabStop[];
+export declare function mergeParagraphTabStops(inherited: document_d_exports.TabStop[] | undefined, direct: document_d_exports.TabStop[] | undefined): document_d_exports.TabStop[] | undefined;
 /**
  * Merge paragraph properties for OOXML style cascade resolution.
  *
@@ -19,6 +19,5 @@ declare function mergeParagraphTabStops(inherited: document_d_exports.TabStop[]
  * tabs merge by position; paragraph mark `w:rPr` uses the run-formatting
  * merge rules.
  */
-declare function mergeParagraphFormatting(target: document_d_exports.ParagraphFormatting | undefined, source: document_d_exports.ParagraphFormatting | undefined): document_d_exports.ParagraphFormatting | undefined;
-//#endregion
-export { mergeParagraphFormatting, mergeParagraphTabStops };
+export declare function mergeParagraphFormatting(target: document_d_exports.ParagraphFormatting | undefined, source: document_d_exports.ParagraphFormatting | undefined): document_d_exports.ParagraphFormatting | undefined;
+//#endregion

package/dist/utils/paragraphFormattingMerge.js

@@ -5,6 +5,8 @@ const PARAGRAPH_REPLACE_KEYS = [
 	"alignment",
 	"bidi",
 	"kinsoku",
+	"autoSpaceDE",
+	"autoSpaceDN",
 	"overflowPunctuation",
 	"spaceBefore",
 	"spaceAfter",

package/dist/utils/paragraphFrame.d.ts

@@ -0,0 +1,20 @@
+import { ParagraphBlock, TextBoxBlock } from "../layout-engine/types.js";
+//#region src/utils/paragraphFrame.d.ts
+export type ParagraphFrame = {
+  width?: number;
+  height?: number;
+  hSpace?: number;
+  vSpace?: number;
+  hAnchor?: "text" | "margin" | "page";
+  vAnchor?: "text" | "margin" | "page";
+  x?: number;
+  y?: number;
+  xAlign?: "left" | "center" | "right" | "inside" | "outside";
+  yAlign?: "top" | "center" | "bottom" | "inside" | "outside" | "inline";
+  wrap?: "around" | "auto" | "none" | "notBeside" | "through" | "tight";
+};
+export declare const setParagraphFrame: (block: ParagraphBlock, frame: ParagraphFrame) => void;
+export declare const getParagraphFrame: (block: ParagraphBlock) => ParagraphFrame | undefined;
+export declare const markParagraphFrameTextBox: (block: TextBoxBlock) => void;
+export declare const isParagraphFrameTextBox: (block: TextBoxBlock) => boolean;
+//#endregion

package/dist/utils/paragraphFrame.js

@@ -0,0 +1,13 @@
+//#region src/utils/paragraphFrame.ts
+const paragraphFrames = /* @__PURE__ */ new WeakMap();
+const paragraphFrameTextBoxes = /* @__PURE__ */ new WeakSet();
+const setParagraphFrame = (block, frame) => {
+	paragraphFrames.set(block, frame);
+};
+const getParagraphFrame = (block) => paragraphFrames.get(block);
+const markParagraphFrameTextBox = (block) => {
+	paragraphFrameTextBoxes.add(block);
+};
+const isParagraphFrameTextBox = (block) => paragraphFrameTextBoxes.has(block);
+//#endregion
+export { getParagraphFrame, isParagraphFrameTextBox, markParagraphFrameTextBox, setParagraphFrame };