@stll/folio-core 0.63.1 → 0.64.1

package/dist/utils/outlineHeadings.js

@@ -0,0 +1,42 @@
+import { findPageIndexContainingPmPos } from "../layout-engine/pmPageIndex.js";
+// src/utils/outlineHeadings.ts
+const sameHeading = (a, b) => Object.values({
+	id: a.id === b.id,
+	text: a.text === b.text,
+	level: a.level === b.level,
+	pmPos: a.pmPos === b.pmPos,
+	pageNumber: (a.pageNumber ?? null) === (b.pageNumber ?? null)
+}).every(Boolean);
+const layoutPageNumber = (layout, pmPos) => {
+	const pageIndex = findPageIndexContainingPmPos(layout, pmPos);
+	return pageIndex === null ? null : layout.pages[pageIndex]?.number ?? null;
+};
+/**
+* The outline's headings with page numbers from `layout`.
+*
+* A heading the layout does not place keeps the page number it last had under
+* the same id, so the outline never shows a transient blank while a layout is
+* pending. An unchanged entry is returned as its previous object and an
+* unchanged list as the previous array, so consumers can skip work by identity.
+*/
+const resolveOutlineHeadings = ({ collected, layout, previous }) => {
+	const previousById = new Map(previous.map((heading) => [heading.id, heading]));
+	let changed = collected.length !== previous.length;
+	const next = [];
+	for (const [index, heading] of collected.entries()) {
+		const before = previousById.get(heading.id);
+		const pageNumber = (layout && layoutPageNumber(layout, heading.pmPos)) ?? before?.pageNumber ?? null;
+		const resolved = {
+			id: heading.id,
+			text: heading.text,
+			level: heading.level,
+			pmPos: heading.pmPos,
+			pageNumber
+		};
+		const kept = before && sameHeading(before, resolved) ? before : resolved;
+		if (kept !== previous[index]) changed = true;
+		next.push(kept);
+	}
+	return changed ? next : previous;
+};
+export { resolveOutlineHeadings };

package/dist/utils/paragraphBaseDirection.d.ts

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

package/dist/utils/paragraphBaseDirection.js

@@ -1,5 +1,5 @@
 import { detectBaseDirection } from "./baseDirection.js";
-//#region src/utils/paragraphBaseDirection.ts
+// src/utils/paragraphBaseDirection.ts
 const isDirectionalTextRun = (run) => run.kind === "text" || run.kind === "field";
 /** Resolve the paragraph direction used by both measurement and painting. */
 const isRtlParagraph = (block) => {
@@ -9,5 +9,4 @@ const isRtlParagraph = (block) => {
 	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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/utils/paragraphFormattingMerge.d.ts
 /**
  * Merge custom tab stops across OOXML paragraph-property layers.
  *
@@ -19,5 +18,4 @@ export declare function mergeParagraphTabStops(inherited: document_d_exports.Tab
  * tabs merge by position; paragraph mark `w:rPr` uses the run-formatting
  * merge rules.
  */
-export declare function mergeParagraphFormatting(target: document_d_exports.ParagraphFormatting | undefined, source: document_d_exports.ParagraphFormatting | undefined): document_d_exports.ParagraphFormatting | undefined;
-//#endregion
+export declare function mergeParagraphFormatting(target: document_d_exports.ParagraphFormatting | undefined, source: document_d_exports.ParagraphFormatting | undefined): document_d_exports.ParagraphFormatting | undefined;

package/dist/utils/paragraphFormattingMerge.js

@@ -1,6 +1,6 @@
 import { mergeTextFormatting } from "./textFormattingMerge.js";
 import { mergeParagraphNumbering } from "@stll/docx-core/model";
-//#region src/utils/paragraphFormattingMerge.ts
+// src/utils/paragraphFormattingMerge.ts
 const PARAGRAPH_REPLACE_KEYS = [
 	"alignment",
 	"bidi",
@@ -98,5 +98,4 @@ function mergeParagraphFormatting(target, source) {
 	if (source.tabs !== void 0) result.tabs = mergeParagraphTabStops(result.tabs, source.tabs);
 	return result;
 }
-//#endregion
 export { mergeParagraphFormatting, mergeParagraphTabStops };

package/dist/utils/paragraphFrame.d.ts

@@ -1,5 +1,4 @@
 import { ParagraphBlock, TextBoxBlock } from "../layout-engine/types.js";
-//#region src/utils/paragraphFrame.d.ts
 export type ParagraphFrame = {
   width?: number;
   height?: number;
@@ -16,5 +15,4 @@ export type ParagraphFrame = {
 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
+export declare const isParagraphFrameTextBox: (block: TextBoxBlock) => boolean;

package/dist/utils/paragraphFrame.js

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

package/dist/utils/paragraphInlineLayout.d.ts

@@ -1,5 +1,4 @@
 import { ImageRun, MeasuredLine, Page, ParagraphAttrs, ParagraphBlock, ParagraphFragment } from "../layout-engine/types.js";
-//#region src/utils/paragraphInlineLayout.d.ts
 type ParagraphAlignment = NonNullable<ParagraphAttrs["alignment"]>;
 export type HorizontalClipViewport = {
   left: number;
@@ -107,5 +106,4 @@ export type PhysicalParagraphInlineLayout = {
 };
 /** Resolve logical OOXML paragraph sides into physical inline geometry. */
 export declare const resolvePhysicalParagraphInlineLayout: (block: ParagraphBlock) => PhysicalParagraphInlineLayout;
-//#endregion
 export {};

package/dist/utils/paragraphInlineLayout.js

@@ -4,7 +4,7 @@ import { isRtlParagraph } from "./paragraphBaseDirection.js";
 import { getParagraphFrame } from "./paragraphFrame.js";
 import { inlineImageBoundingBox } from "./rotationBoundingBox.js";
 import { panic } from "better-result";
-//#region src/utils/paragraphInlineLayout.ts
+// src/utils/paragraphInlineLayout.ts
 const intersectHorizontalClipViewports = (first, second) => {
 	if (first === void 0) return second;
 	const left = Math.max(first.left, second.left);
@@ -184,5 +184,4 @@ const resolvePhysicalParagraphInlineLayout = (block) => {
 		isRtl
 	};
 };
-//#endregion
 export { columnPictureClipViewportForColumn, columnPictureClipViewportForFragment, inlinePictureClipInsets, inlinePictureVisibleBounds, intersectHorizontalClipViewports, isInlinePictureRun, pageHorizontalColumns, paragraphHasInlinePicture, paragraphImageOnlyRun, paragraphInlinePictureViewport, resolveImageLineAlign, resolveParagraphLineAlignment, resolveParagraphLineGeometry, resolveParagraphLineGeometryForBlock, resolvePhysicalParagraphInlineLayout };

package/dist/utils/replaceText.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/utils/replaceText.d.ts
 type ReplaceRange = {
   start: {
     paragraphIndex: number;
@@ -12,5 +11,4 @@ type ReplaceRange = {
 };
 /** Replace text within a range in the document. Returns a new document. */
 export declare function replaceTextInDocument(doc: document_d_exports.Document, range: ReplaceRange, text: string, formatting?: document_d_exports.TextFormatting): document_d_exports.Document;
-//#endregion
 export {};

package/dist/utils/replaceText.js

@@ -1,7 +1,7 @@
 import { cloneDocumentWithParagraphPropertySources } from "../docx/paragraphPropertySource.js";
 import { getFindParagraphText } from "./findReplace.js";
 import { panic } from "better-result";
-//#region src/utils/replaceText.ts
+// src/utils/replaceText.ts
 /**
 * Lightweight text replacement on the document model.
 * Used by find & replace. Operates immutably.
@@ -207,5 +207,4 @@ const replaceTextInParagraph = ({ paragraph, startOffset, endOffset, text, forma
 		...formatting ? { formatting } : {}
 	});
 };
-//#endregion
 export { replaceTextInDocument };

package/dist/utils/rotationBoundingBox.d.ts

@@ -1,5 +1,4 @@
 import { ImageRun } from "../layout-engine/types.js";
-//#region src/utils/rotationBoundingBox.d.ts
 export type BoundingBox = {
   width: number;
   height: number;
@@ -10,5 +9,4 @@ export declare function hasHorizontalFlip(transform: string | undefined): boolea
 /** Whether a DrawingML/CSS transform reflects around the horizontal centre line. */
 export declare function hasVerticalFlip(transform: string | undefined): boolean;
 export declare function rotatedBoundingBox(w: number, h: number, deg: number): BoundingBox;
-export declare function inlineImageBoundingBox(run: ImageRun): BoundingBox;
-//#endregion
+export declare function inlineImageBoundingBox(run: ImageRun): BoundingBox;

package/dist/utils/rotationBoundingBox.js

@@ -1,4 +1,4 @@
-//#region src/utils/rotationBoundingBox.ts
+// src/utils/rotationBoundingBox.ts
 function parseRotationDegrees(transform) {
 	if (!transform) return 0;
 	const match = /rotate\(\s*(?<degrees>[-\d.]+)\s*deg\s*\)/iu.exec(transform);
@@ -40,5 +40,4 @@ function inlineImageBoundingBox(run) {
 	};
 	return rotatedBoundingBox(run.width, run.height, rotation);
 }
-//#endregion
 export { hasHorizontalFlip, hasVerticalFlip, inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };

package/dist/utils/sanitizeImageSrc.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/sanitizeImageSrc.d.ts
 /**
  * Keep painted image sources local to bytes the host already owns.
  *
@@ -16,5 +15,4 @@ export declare function sanitizeImageSrc(src: string | null | undefined): string
  * Structural parameter type so painter unit tests (which fake the DOM) can
  * exercise it without an `HTMLImageElement`.
  */
-export declare function applySanitizedImageSrc(imgEl: Pick<HTMLImageElement, "src">, src: string | null | undefined): void;
-//#endregion
+export declare function applySanitizedImageSrc(imgEl: Pick<HTMLImageElement, "src">, src: string | null | undefined): void;

package/dist/utils/sanitizeImageSrc.js

@@ -1,4 +1,4 @@
-//#region src/utils/sanitizeImageSrc.ts
+// src/utils/sanitizeImageSrc.ts
 /**
 * Keep painted image sources local to bytes the host already owns.
 *
@@ -26,5 +26,4 @@ function applySanitizedImageSrc(imgEl, src) {
 	const safeSrc = sanitizeImageSrc(src);
 	if (safeSrc !== void 0) imgEl.src = safeSrc;
 }
-//#endregion
 export { applySanitizedImageSrc, sanitizeImageSrc };

package/dist/utils/scriptSegments.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/scriptSegments.d.ts
 /**
  * Script segmentation for per-character font selection.
  *
@@ -121,5 +120,4 @@ export declare function hasHAnsiSlotText(text: string, options?: {
  * fonts. Empty input yields no segments; single-class input yields one.
  * `eastAsiaHint` is the run's effective `w:hint="eastAsia"`.
  */
-export declare function segmentByScript(text: string, options?: ScriptSegmentationOptions): ScriptSegment[];
-//#endregion
+export declare function segmentByScript(text: string, options?: ScriptSegmentationOptions): ScriptSegment[];

package/dist/utils/scriptSegments.js

@@ -1,4 +1,4 @@
-//#region src/utils/scriptSegments.ts
+// src/utils/scriptSegments.ts
 /**
 * Script segmentation for per-character font selection.
 *
@@ -168,5 +168,4 @@ function segmentByScript(text, options = {}) {
 	});
 	return segments;
 }
-//#endregion
 export { SCRIPT_CLASS, eastAsiaHintApplies, hasCjk, hasComplexScript, hasDistinctHAnsiFont, hasEastAsiaSlotText, hasHAnsiSlotText, hasRightToLeft, isCjkCodePoint, isComplexScriptCodePoint, isEastAsiaHintCodePoint, isHAnsiCodePoint, isRightToLeftCodePoint, scriptClassOf, segmentByScript };

package/dist/utils/stripXmlDeclarations.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/stripXmlDeclarations.d.ts
 /**
  * Remove complete `<?xml ...?>` declarations from attacker-controlled clipboard HTML.
  *
@@ -6,5 +5,4 @@
  * when many `<?xml` openers appear with no closing `>`. An unterminated opener
  * is preserved verbatim (same as the regex, which never matched it).
  */
-export declare function stripXmlDeclarations(html: string): string;
-//#endregion
+export declare function stripXmlDeclarations(html: string): string;

package/dist/utils/stripXmlDeclarations.js

@@ -1,4 +1,4 @@
-//#region src/utils/stripXmlDeclarations.ts
+// src/utils/stripXmlDeclarations.ts
 /**
 * Remove complete `<?xml ...?>` declarations from attacker-controlled clipboard HTML.
 *
@@ -31,5 +31,4 @@ function stripXmlDeclarations(html) {
 	}
 	return chunks.join("");
 }
-//#endregion
 export { stripXmlDeclarations };

package/dist/utils/tableOfContentsStyle.d.ts

@@ -1,9 +1,7 @@
-//#region src/utils/tableOfContentsStyle.d.ts
 type TableOfContentsStyleIdentity = {
   styleId: string | undefined;
   styleName?: string;
 };
 /** Resolve a built-in TOC entry style without relying on its localized style id. */
 export declare const tableOfContentsStyleLevel: ({ styleId, styleName }: TableOfContentsStyleIdentity) => number | undefined;
-//#endregion
 export {};

package/dist/utils/tableOfContentsStyle.js

@@ -1,5 +1,5 @@
 import { normalizeStyleName } from "../docx/builtInStyles.js";
-//#region src/utils/tableOfContentsStyle.ts
+// src/utils/tableOfContentsStyle.ts
 const TABLE_OF_CONTENTS_STYLE_ID = /^TOC(?<level>\d*)$/iu;
 /**
 * Against an already-normalised name, so the same tolerance applies here as in
@@ -17,5 +17,4 @@ const parsedLevel = (match) => {
 };
 /** 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(normalizeStyleName(styleName ?? "")));
-//#endregion
 export { tableOfContentsStyleLevel };

package/dist/utils/tableOperations.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/utils/tableOperations.d.ts
 export type TablePropertiesCommand = {
   width?: number | null;
   widthType?: document_d_exports.TableWidthType | null;
@@ -84,5 +83,4 @@ export declare const deleteRow: (table: document_d_exports.Table, rowIndex: numb
 export declare const addColumn: (table: document_d_exports.Table, atIndex: number, position?: "before" | "after") => document_d_exports.Table;
 export declare const deleteColumn: (table: document_d_exports.Table, columnIndex: number) => document_d_exports.Table;
 export declare const mergeCells: (table: document_d_exports.Table, selection: TableSelection) => document_d_exports.Table;
-export declare const splitCell: (table: document_d_exports.Table, rowIndex: number, columnIndex: number) => document_d_exports.Table;
-//#endregion
+export declare const splitCell: (table: document_d_exports.Table, rowIndex: number, columnIndex: number) => document_d_exports.Table;

package/dist/utils/tableOperations.js

@@ -1,6 +1,6 @@
 import { TABLE_JUSTIFICATION_VALUES } from "../types/documentEnumValues.js";
 import { finalizeParagraphFormatting } from "@stll/docx-core/model";
-//#region src/utils/tableOperations.ts
+// src/utils/tableOperations.ts
 /**
 * Table model operations — framework-agnostic types and pure functions over the
 * folio document model's `Table`, `TableRow`, and `TableCell` shapes.
@@ -271,5 +271,4 @@ const splitCell = (table, rowIndex, columnIndex) => {
 		rows: newRows
 	};
 };
-//#endregion
 export { TABLE_PROPERTY_JUSTIFICATIONS, addColumn, addRow, createTableContext, deleteColumn, deleteRow, getCellAt, getColumnCount, mergeCells, splitCell, toTablePropertyJustification };

package/dist/utils/tablePlacement.d.ts

@@ -1,6 +1,4 @@
 import { TableAlignment } from "../types/formatting.js";
-//#region src/utils/tablePlacement.d.ts
 export type PhysicalTableAlignment = "left" | "center" | "right";
 /** Resolve an OOXML table placement to a physical inline alignment. */
-export declare const resolveTablePlacementAlignment: (placement: TableAlignment, rightToLeft: boolean) => PhysicalTableAlignment;
-//#endregion
+export declare const resolveTablePlacementAlignment: (placement: TableAlignment, rightToLeft: boolean) => PhysicalTableAlignment;

package/dist/utils/tablePlacement.js

@@ -1,4 +1,4 @@
-//#region src/utils/tablePlacement.ts
+// src/utils/tablePlacement.ts
 /** Resolve an OOXML table placement to a physical inline alignment. */
 const resolveTablePlacementAlignment = (placement, rightToLeft) => {
 	switch (placement) {
@@ -10,5 +10,4 @@ const resolveTablePlacementAlignment = (placement, rightToLeft) => {
 		default: return placement;
 	}
 };
-//#endregion
 export { resolveTablePlacementAlignment };

package/dist/utils/textAdvanceGapsDom.d.ts

@@ -1,8 +1,6 @@
-//#region src/utils/textAdvanceGapsDom.d.ts
 type TextAdvanceGap = {
   readonly offset: number;
   readonly advancePx: number;
 };
 export declare const applyTextAdvanceGaps: (host: HTMLElement, gaps: readonly TextAdvanceGap[]) => void;
-//#endregion
 export {};

package/dist/utils/textAdvanceGapsDom.js

@@ -1,4 +1,4 @@
-//#region src/utils/textAdvanceGapsDom.ts
+// src/utils/textAdvanceGapsDom.ts
 const applyTextAdvanceGaps = (host, gaps) => {
 	host.style.textAutospace = "no-autospace";
 	if (gaps.length === 0) return;
@@ -45,5 +45,4 @@ const applyTextAdvanceGaps = (host, gaps) => {
 		sourceOffset = end;
 	}
 };
-//#endregion
 export { applyTextAdvanceGaps };

package/dist/utils/textDirectionFlow.d.ts

@@ -1,5 +1,4 @@
 import { TextDirection } from "@stll/docx-core/model";
-//#region src/utils/textDirectionFlow.d.ts
 export type TextFlowCss = {
   /** `horizontal-tb` needs no declaration; the others are written out. */
   writingMode: "horizontal-tb" | "vertical-lr" | "vertical-rl";
@@ -10,5 +9,4 @@ export type TextFlowCss = {
   rotateDegrees?: 180;
 };
 /** The CSS a `w:textDirection` token renders as, through the flow it names. */
-export declare const textFlowCss: (direction: TextDirection) => TextFlowCss;
-//#endregion
+export declare const textFlowCss: (direction: TextDirection) => TextFlowCss;

package/dist/utils/textDirectionFlow.js

@@ -1,5 +1,5 @@
 import { TEXT_DIRECTION_FLOW_BY_TOKEN } from "@stll/docx-core/model";
-//#region src/utils/textDirectionFlow.ts
+// src/utils/textDirectionFlow.ts
 /**
 * The CSS one `w:textDirection` flow renders as.
 *
@@ -34,5 +34,4 @@ const TEXT_FLOW_CSS = {
 };
 /** The CSS a `w:textDirection` token renders as, through the flow it names. */
 const textFlowCss = (direction) => TEXT_FLOW_CSS[TEXT_DIRECTION_FLOW_BY_TOKEN[direction]];
-//#endregion
 export { textFlowCss };

package/dist/utils/textFormattingMerge.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/utils/textFormattingMerge.d.ts
 export declare const STYLE_TOGGLE_KEYS: readonly ["bold", "boldCs", "italic", "italicCs", "allCaps", "emboss", "imprint", "outline", "shadow", "smallCaps", "strike", "hidden"];
 /**
  * Merge one style's own run-formatting declarations onto its already-resolved
@@ -22,5 +21,4 @@ export declare const STYLE_TOGGLE_KEYS: readonly ["bold", "boldCs", "italic", "i
  * it has no place in this function.
  */
 export declare function mergeStyleTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
-export declare function mergeTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
-//#endregion
+export declare function mergeTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;

package/dist/utils/textFormattingMerge.js

@@ -1,5 +1,5 @@
 import { mergeFontFamily } from "./fontFamilyMerge.js";
-//#region src/utils/textFormattingMerge.ts
+// src/utils/textFormattingMerge.ts
 const STYLE_TOGGLE_KEYS = [
 	"bold",
 	"boldCs",
@@ -76,5 +76,4 @@ function mergeTextFormatting(target, source) {
 	}
 	return result;
 }
-//#endregion
 export { STYLE_TOGGLE_KEYS, mergeStyleTextFormatting, mergeTextFormatting };

package/dist/utils/tiffConverter.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/tiffConverter.d.ts
 /**
  * Budget shared by every TIFF in one package. The per-image cap bounds a single
  * decode; without a running total a package of many large TIFFs still adds up.
@@ -13,5 +12,4 @@ export type ConvertedTiff = {
   /** Pixels decoded, so callers can draw down a package-wide budget. */
   pixels: number;
 };
-export declare function convertTiffToPngDataUrl(tiffData: ArrayBuffer, maxPixels?: number): Promise<ConvertedTiff | null>;
-//#endregion
+export declare function convertTiffToPngDataUrl(tiffData: ArrayBuffer, maxPixels?: number): Promise<ConvertedTiff | null>;

package/dist/utils/tiffConverter.js

@@ -1,5 +1,5 @@
 import { base64ToBytes } from "./textEncoding.js";
-//#region src/utils/tiffConverter.ts
+// src/utils/tiffConverter.ts
 /**
 * TIFF to PNG Converter
 *
@@ -85,5 +85,4 @@ function dataUrlToArrayBuffer(dataUrl) {
 		return null;
 	}
 }
-//#endregion
 export { MAX_PACKAGE_TIFF_PIXELS, convertTiffToPngDataUrl, isTiffMimeType };

package/dist/utils/trailingText.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/trailingText.d.ts
 /**
  * Linear scans over the end of a text run. Layout calls these on every
  * measure and paint pass, and run text can be arbitrarily long, so they
@@ -17,5 +16,4 @@ export type TrailingToken = {
  * follows it, or return undefined when the text has no non-whitespace
  * character.
  */
-export declare function splitTrailingToken(text: string): TrailingToken | undefined;
-//#endregion
+export declare function splitTrailingToken(text: string): TrailingToken | undefined;

package/dist/utils/trailingText.js

@@ -1,4 +1,4 @@
-//#region src/utils/trailingText.ts
+// src/utils/trailingText.ts
 /**
 * Linear scans over the end of a text run. Layout calls these on every
 * measure and paint pass, and run text can be arbitrarily long, so they
@@ -28,5 +28,4 @@ function splitTrailingToken(text) {
 		separator: text.slice(tokenEnd)
 	};
 }
-//#endregion
 export { splitTrailingToken, trailingSpaceStart };

package/dist/utils/units.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/units.d.ts
 /**
  * Unit Conversion Utilities - Convert OOXML units to CSS/pixels
  *
@@ -103,5 +102,4 @@ export declare function clamp(value: number, min: number, max: number): number;
 /**
  * Format a pixel value as CSS string
  */
-export declare function formatPx(px: number): string;
-//#endregion
+export declare function formatPx(px: number): string;

package/dist/utils/units.js

@@ -1,4 +1,4 @@
-//#region src/utils/units.ts
+// src/utils/units.ts
 /**
 * Unit Conversion Utilities - Convert OOXML units to CSS/pixels
 *
@@ -146,5 +146,4 @@ function clamp(value, min, max) {
 function formatPx(px) {
 	return `${roundPixels(px)}px`;
 }
-//#endregion
 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

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

package/dist/utils/urlSecurity.js

@@ -1,5 +1,5 @@
 import { sanitizeExternalUrl } from "@stll/docx-core";
-//#region src/utils/urlSecurity.ts
+// src/utils/urlSecurity.ts
 const ALLOWED_TARGETS = /* @__PURE__ */ new Set([
 	"_blank",
 	"_self",
@@ -62,5 +62,4 @@ function startsWithPortSuffix(value) {
 	}
 	return index > 0 && (index === value.length || "/?#".includes(value[index]));
 }
-//#endregion
 export { anchorTargetAttrs, isAllowedUserUrl, normalizeUserUrl, sanitizeExternalUrl, windowFeaturesFor };

package/dist/utils/zoom.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/zoom.d.ts
 /**
  * Canonical zoom limits shared by every folio adapter (React, Vue, ...).
  *
@@ -16,5 +15,4 @@ export declare const ZOOM_MIN = 0.25;
 /** Maximum reachable zoom level (400%). */
 export declare const ZOOM_MAX = 4;
 /** Step applied per zoom-in / zoom-out action and per keyboard shortcut. */
-export declare const ZOOM_STEP = 0.1;
-//#endregion
+export declare const ZOOM_STEP = 0.1;

package/dist/utils/zoom.js

@@ -1,4 +1,4 @@
-//#region src/utils/zoom.ts
+// src/utils/zoom.ts
 /**
 * Canonical zoom limits shared by every folio adapter (React, Vue, ...).
 *
@@ -17,5 +17,4 @@ const ZOOM_MIN = .25;
 const ZOOM_MAX = 4;
 /** Step applied per zoom-in / zoom-out action and per keyboard shortcut. */
 const ZOOM_STEP = .1;
-//#endregion
 export { ZOOM_MAX, ZOOM_MIN, ZOOM_STEP };

package/dist/version-comparison.d.ts

@@ -4,7 +4,6 @@ import { FolioDocumentStoryHandle } from "./ai-edits/headless.js";
 import { FolioContentAlignedBlockEvent } from "./compare/content-alignment.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FolioDocumentMetadataProperty, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform } from "./docx/metadataPrivacy.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/version-comparison.d.ts
 /** One word-level diff segment within a `modified` block. Mirrors {@link WordDiffSegment}. */
 export type FolioVersionDiffSegment = WordDiffSegment;
 /** Independently selectable comparison scopes. */
@@ -165,5 +164,4 @@ export declare const applyFolioVersionDiffPrivacy: (diff: FolioVersionDiff, opti
  * detection.
  */
 export declare const compareDocxVersions: (base: ArrayBuffer, revised: ArrayBuffer, options?: FolioCompareDocxVersionsOptions) => Promise<FolioVersionDiff>;
-//#endregion
 export { FOLIO_DOCUMENT_METADATA_PROPERTIES, type FolioDocumentMetadataProperty };

package/dist/version-comparison.js

@@ -5,7 +5,7 @@ import { FolioContentInlinePresentationProjectionError, compareAlignedFolioConte
 import { pairFolioDocumentStories } from "./document-stories.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM, isFolioDocumentPrivacyTransform } from "./docx/metadataPrivacy.js";
 import { TaggedError, panic } from "better-result";
-//#region src/version-comparison.ts
+// src/version-comparison.ts
 /**
 * Document version-diff engine: compare two `.docx` buffers block by block
 * and produce a structured, LLM-summarizable diff.
@@ -493,5 +493,4 @@ const compareDocxVersions = async (base, revised, options = {}) => {
 	};
 	return options.privacy ? applyFolioVersionDiffPrivacy(diff, options.privacy) : diff;
 };
-//#endregion
 export { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, InvalidFolioVersionComparisonOptionsError, alignFolioBlocks, applyFolioVersionDiffPrivacy, compareDocxVersions, exceedsLcsBudget, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope };

package/dist/watermark/index.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/watermark/index.d.ts
 /**
  * Whether `target` is safe to save as a watermark picture's external image
  * relationship. A watermark dialog lets an author type an arbitrary string

package/dist/watermark/index.js

@@ -1,6 +1,6 @@
 import { isEmptyParagraph } from "../docx/paragraphParser.js";
 import { cloneParagraphWithPropertySource } from "../docx/paragraphPropertySource.js";
-//#region src/watermark/index.ts
+// src/watermark/index.ts
 /**
 * Headless API for the document watermark.
 *
@@ -180,5 +180,4 @@ function ensureWatermarkHeaderCoverage(doc, watermark) {
 		}
 	};
 }
-//#endregion
 export { ensureWatermarkHeaderCoverage, getDocumentWatermark, isAllowedExternalWatermarkImageUrl, setDocumentWatermark };