@stll/folio-core 0.0.1-placeholder.0 → 0.1.1

package/dist/markdown/renderTable.js

@@ -0,0 +1,229 @@
+import { pushWarning } from "./internals.js";
+import { escapeTableCell } from "./escape.js";
+import { registerImage } from "./images.js";
+import { renderParagraph } from "./renderParagraph.js";
+//#region src/markdown/renderTable.ts
+/** Render a `Table` as markdown. Picks GFM vs HTML based on cell features. */
+function renderTable(ctx, pkg, table) {
+	const { rows } = table;
+	if (!rows.length) return "";
+	if (needsHtmlFallback(rows)) return renderHtmlTable(ctx, pkg, rows, true);
+	return renderGfmTable(ctx, pkg, rows, true);
+}
+function needsHtmlFallback(rows) {
+	for (const row of rows) for (const cell of row.cells) {
+		if ((cell.formatting?.gridSpan ?? 1) > 1) return true;
+		if (cell.formatting?.vMerge) return true;
+		if (cell.content.some((b) => b.type === "table")) return true;
+	}
+	return false;
+}
+function renderGfmTable(ctx, pkg, rows, firstRowIsHeader) {
+	const cellTexts = rows.map((row) => renderGfmRow(ctx, pkg, row));
+	let maxCols = 0;
+	for (const cells of cellTexts) if (cells.length > maxCols) maxCols = cells.length;
+	if (!maxCols) return "";
+	const padded = cellTexts.map((row) => {
+		const filled = row.slice();
+		while (filled.length < maxCols) filled.push("");
+		return filled;
+	});
+	const separator = `| ${Array.from({ length: maxCols }, () => "---").join(" | ")} |`;
+	const lines = [];
+	if (firstRowIsHeader) {
+		const [header, ...body] = padded;
+		if (header) lines.push(toRowLine(header));
+		lines.push(separator);
+		for (const row of body) lines.push(toRowLine(row));
+	} else {
+		lines.push(`| ${Array.from({ length: maxCols }, () => "").join(" | ")} |`);
+		lines.push(separator);
+		for (const row of padded) lines.push(toRowLine(row));
+	}
+	return lines.join("\n");
+}
+function toRowLine(cells) {
+	return `| ${cells.join(" | ")} |`;
+}
+function renderGfmRow(ctx, pkg, row) {
+	const out = [];
+	for (const cell of row.cells) out.push(renderGfmCell(ctx, pkg, cell));
+	return out;
+}
+function renderGfmCell(ctx, pkg, cell) {
+	const blocks = [];
+	for (const item of cell.content) if (item.type === "paragraph") {
+		const md = renderParagraph(ctx, pkg, item);
+		if (md.trim()) blocks.push(md);
+	}
+	return escapeTableCell(blocks.join("\n"));
+}
+function renderHtmlTable(ctx, pkg, rows, firstRowIsHeader) {
+	const out = ["<table>"];
+	for (const [rowIdx, row] of rows.entries()) {
+		const tag = firstRowIsHeader && rowIdx === 0 ? "th" : "td";
+		out.push("  <tr>");
+		let gridCol = 0;
+		for (const cell of row.cells) {
+			const colspan = cell.formatting?.gridSpan ?? 1;
+			if (cell.formatting?.vMerge !== "continue") {
+				const rowspan = countRowSpan(rows, rowIdx, gridCol, colspan);
+				const attrs = [];
+				if (colspan > 1) attrs.push(`colspan="${colspan}"`);
+				if (rowspan > 1) attrs.push(`rowspan="${rowspan}"`);
+				const attrStr = attrs.length ? ` ${attrs.join(" ")}` : "";
+				out.push(`    <${tag}${attrStr}>${renderHtmlCell(ctx, pkg, cell)}</${tag}>`);
+			}
+			gridCol += colspan;
+		}
+		out.push("  </tr>");
+	}
+	out.push("</table>");
+	return out.join("\n");
+}
+/**
+* Count how many rows beyond `rowIdx` have a `vMerge: "continue"` cell aligned
+* to the same grid column as the anchor. Cells are indexed by array position,
+* but vertical merges align on the visual grid column, so a horizontal merge
+* (`gridSpan > 1`) above shifts array indices — we walk by cumulative gridSpan.
+*/
+function countRowSpan(rows, rowIdx, gridCol, colspan) {
+	let span = 1;
+	for (let r = rowIdx + 1; r < rows.length; r++) {
+		const row = rows[r];
+		if (!row) break;
+		const target = cellAtGridColumn(row, gridCol);
+		if (target && target.formatting?.vMerge === "continue" && (target.formatting.gridSpan ?? 1) === colspan) span += 1;
+		else break;
+	}
+	return span;
+}
+function cellAtGridColumn(row, gridCol) {
+	let col = 0;
+	for (const cell of row.cells) {
+		if (col === gridCol) return cell;
+		col += cell.formatting?.gridSpan ?? 1;
+		if (col > gridCol) return;
+	}
+}
+function renderHtmlCell(ctx, pkg, cell) {
+	const parts = [];
+	for (const item of cell.content) if (item.type === "paragraph") {
+		const inner = renderHtmlInline(ctx, pkg, item.content, item.paraId);
+		if (inner) parts.push(inner);
+	} else {
+		const nested = renderHtmlTable(ctx, pkg, item.rows, true);
+		if (nested) parts.push(nested);
+	}
+	return parts.join("<br>");
+}
+function escapeHtml(text) {
+	return text.replace(/&/gu, "&amp;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;").replace(/"/gu, "&quot;");
+}
+function renderHtmlInline(ctx, pkg, content, paraId) {
+	let out = "";
+	for (const item of content) switch (item.type) {
+		case "run":
+			out += renderHtmlRun(ctx, pkg, item, paraId);
+			break;
+		case "hyperlink":
+			out += renderHtmlHyperlink(ctx, pkg, item, paraId);
+			break;
+		case "insertion":
+		case "moveTo": {
+			const inner = renderHtmlChildren(ctx, pkg, item.content, paraId);
+			out += ctx.opts.trackedChanges === "annotate" ? `<ins>${inner}</ins>` : inner;
+			break;
+		}
+		case "deletion":
+		case "moveFrom":
+			if (ctx.opts.trackedChanges === "annotate") out += `<del>${renderHtmlChildren(ctx, pkg, item.content, paraId)}</del>`;
+			break;
+		case "simpleField":
+		case "complexField": {
+			const runs = item.type === "simpleField" ? item.content : item.fieldResult;
+			out += renderHtmlChildren(ctx, pkg, runs, paraId);
+			break;
+		}
+		case "inlineSdt":
+			out += renderHtmlInline(ctx, pkg, item.content, paraId);
+			break;
+		case "mathEquation":
+			if (item.plainText) out += escapeHtml(item.plainText);
+			break;
+		default: break;
+	}
+	return out;
+}
+function renderHtmlChildren(ctx, pkg, children, paraId) {
+	return children.map((c) => c.type === "run" ? renderHtmlRun(ctx, pkg, c, paraId) : renderHtmlHyperlink(ctx, pkg, c, paraId)).join("");
+}
+function renderHtmlRun(ctx, pkg, run, paraId) {
+	if (run.formatting?.hidden) return "";
+	let text = "";
+	for (const item of run.content) switch (item.type) {
+		case "text":
+			text += escapeHtml(item.text);
+			break;
+		case "tab":
+			text += "&emsp;";
+			break;
+		case "break":
+			text += "<br>";
+			break;
+		case "symbol":
+			text += escapeHtml(item.char);
+			break;
+		case "noBreakHyphen":
+			text += "&#8209;";
+			break;
+		case "softHyphen": break;
+		case "drawing": {
+			const ref = pkg?.relationships?.get(item.image.rId);
+			const media = ref ? pkg?.media?.get(ref.target) : void 0;
+			if (media) {
+				const reg = registerImage(ctx, media, item.image, paraId);
+				const alt = reg.alt ? escapeHtml(reg.alt) : "";
+				text += `<img src="${escapeHtml(reg.virtualPath)}" alt="${alt}">`;
+				break;
+			}
+			if (item.image.src) {
+				const alt = escapeHtml(item.image.alt ?? item.image.title ?? item.image.filename ?? "");
+				text += `<img src="${escapeHtml(item.image.src)}" alt="${alt}">`;
+				break;
+			}
+			pushWarning(ctx, `image rId=${item.image.rId} not resolvable`);
+			break;
+		}
+		case "footnoteRef":
+		case "endnoteRef": {
+			if (ctx.opts.footnotes === "strip") break;
+			const markerNumber = ctx.footnoteRefs.length + 1;
+			ctx.footnoteRefs.push({
+				refId: item.id,
+				markerNumber,
+				kind: item.type === "endnoteRef" ? "endnote" : "footnote"
+			});
+			text += `<sup>[${markerNumber}]</sup>`;
+			break;
+		}
+		default: break;
+	}
+	if (!text) return "";
+	const f = run.formatting;
+	if (!f) return text;
+	if (f.bold) text = `<strong>${text}</strong>`;
+	if (f.italic) text = `<em>${text}</em>`;
+	if (f.strike) text = `<s>${text}</s>`;
+	if (f.underline?.style && f.underline.style !== "none") text = `<u>${text}</u>`;
+	return text;
+}
+function renderHtmlHyperlink(ctx, pkg, link, paraId) {
+	const inner = link.children.filter((c) => c.type === "run").map((r) => renderHtmlRun(ctx, pkg, r, paraId)).join("");
+	if (!inner) return "";
+	const href = link.href ?? (link.anchor ? `#${link.anchor}` : "");
+	if (!href) return inner;
+	return `<a href="${escapeHtml(href)}">${inner}</a>`;
+}
+//#endregion
+export { renderTable };

package/dist/markdown/trailers.d.ts

@@ -0,0 +1,13 @@
+import { document_d_exports } from "../types/document.js";
+import { RenderContext } from "./types.js";
+
+//#region src/markdown/trailers.d.ts
+/**
+ * Append footnote definitions, the hyperlink reference list (for
+ * `hyperlinks: "reference"`), and the comments sidecar block (for
+ * `comments: "sidecar"`). Each section is emitted only when its corresponding
+ * refs accumulator has entries.
+ */
+declare function appendTrailers(ctx: RenderContext, doc: document_d_exports.Document, body: string): string;
+//#endregion
+export { appendTrailers };

package/dist/markdown/trailers.js

@@ -0,0 +1,54 @@
+import { escapeLinkUrl } from "./escape.js";
+import { renderBlocks } from "./renderBlock.js";
+//#region src/markdown/trailers.ts
+/**
+* Append footnote definitions, the hyperlink reference list (for
+* `hyperlinks: "reference"`), and the comments sidecar block (for
+* `comments: "sidecar"`). Each section is emitted only when its corresponding
+* refs accumulator has entries.
+*/
+function appendTrailers(ctx, doc, body) {
+	const sections = body.trim() ? [body] : [];
+	if (ctx.footnoteRefs.length > 0) {
+		const refs = ctx.footnoteRefs.map(({ refId, markerNumber, kind }) => {
+			const note = kind === "endnote" ? doc.package.endnotes?.find((n) => n.id === refId) : doc.package.footnotes?.find((f) => f.id === refId);
+			return `[^${markerNumber}]: ${note ? noteText(ctx, doc, note) : ""}`;
+		});
+		sections.push(refs.join("\n"));
+	}
+	if (ctx.opts.hyperlinks === "reference" && ctx.hyperlinkRefs.length > 0) sections.push(ctx.hyperlinkRefs.map(({ href, refNumber }) => `[${refNumber}]: ${escapeLinkUrl(href)}`).join("\n"));
+	if (ctx.opts.comments === "sidecar" && ctx.commentRefs.length > 0) {
+		const lines = ["## Comments"];
+		for (const { commentId, markerNumber } of ctx.commentRefs) {
+			const c = doc.package.document.comments?.find((cm) => cm.id === commentId);
+			const author = c?.author ? `${c.author}: ` : "";
+			const text = c ? commentText(c) : "";
+			lines.push(`[^c${markerNumber}]: ${author}${text}`);
+		}
+		sections.push(lines.join("\n"));
+	}
+	return sections.join("\n\n");
+}
+function noteText(ctx, doc, note) {
+	return renderBlocks(ctx, doc.package, note.content).replace(/\n+/gu, " ").trim();
+}
+function commentText(comment) {
+	return comment.content.map((p) => inlineText(p.content)).join(" ").trim();
+}
+function runText(run) {
+	return run.content.map((x) => x.type === "text" ? x.text : "").join("");
+}
+/** Flatten paragraph inline content to plain text, recursing through wrappers. */
+function inlineText(content) {
+	let out = "";
+	for (const item of content) if (item.type === "run") out += runText(item);
+	else if (item.type === "hyperlink") {
+		for (const child of item.children) if (child.type === "run") out += runText(child);
+	} else if (item.type === "simpleField") out += inlineText(item.content);
+	else if (item.type === "complexField") out += inlineText(item.fieldResult);
+	else if (item.type === "insertion" || item.type === "deletion" || item.type === "moveFrom" || item.type === "moveTo") out += inlineText(item.content);
+	else if (item.type === "inlineSdt") out += inlineText(item.content);
+	return out;
+}
+//#endregion
+export { appendTrailers };

package/dist/markdown/types.d.ts

@@ -0,0 +1,118 @@
+//#region src/markdown/types.d.ts
+/**
+ * Types for the DOCX-document → Markdown converter (ported from eigenpal
+ * /docx-editor PR #595). This is folio's v1 surface: the synchronous,
+ * continuous (non-paged) `toMarkdown(Document)` path. The paged + async +
+ * image-handler variants from upstream are not ported (skills bodies have no
+ * images today); they can be added later if needed.
+ */
+/**
+ * Metadata describing a single image registration. Owned by the markdown
+ * module so its public surface is independent of the docx model's drawing
+ * types.
+ */
+type ImageMeta = {
+  /** `paraId` of the containing paragraph, when the source paragraph has one. */paraId?: string | undefined; /** 1-based ordinal in registration order. Unique per render call. */
+  index: number; /** Path inside the DOCX zip (e.g. `word/media/image1.png`). */
+  originalPath: string; /** MIME type (`image/png`, `image/jpeg`, …). */
+  mimeType: string; /** Alt text from the drawing, when present. */
+  alt?: string | undefined;
+};
+/** Full registration record for an image, keyed by `virtualPath`. */
+type ImageRef = {
+  /** Raw bytes as exposed by the DOCX parser. */data: Uint8Array; /** Base64-encoded contents, without the `data:` prefix. */
+  base64: string; /** `data:<mime>;base64,<base64>` URL. */
+  dataUrl: string; /** The path that appears inside the markdown's `![alt](…)` reference. */
+  virtualPath: string;
+} & ImageMeta;
+/**
+ * Options for {@link toMarkdown}. The clean-markdown preset skills use is
+ * `{ annotations: "strip", trackedChanges: "clean", comments: "strip",
+ * hyperlinks: "inline", footnotes: "strip" }`.
+ */
+type MarkdownOptions = {
+  /**
+   * How to encode constructs markdown can't express natively (comments,
+   * tracked changes).
+   * - `"html"` (default): emit `<ins>`, `<del>`, `<comment>` tags.
+   * - `"pandoc"`: Pandoc-flavoured bracketed spans (`[text]{.ins}`).
+   * - `"strip"`: drop the wrapper, keep the visible text.
+   */
+  annotations?: "html" | "pandoc" | "strip";
+  /**
+   * Word tracked changes (`w:ins`, `w:del`, `w:moveFrom`, `w:moveTo`).
+   * - `"annotate"` (default): preserve via the `annotations` wrapper.
+   * - `"clean"`: flatten — insertions become text, deletions vanish.
+   */
+  trackedChanges?: "clean" | "annotate";
+  /**
+   * Word margin comments.
+   * - `"inline"` (default): wrap the commented text via `annotations`.
+   * - `"strip"`: ignore comments entirely.
+   * - `"sidecar"`: inline marker + a `## Comments` trailer section.
+   */
+  comments?: "strip" | "inline" | "sidecar";
+  /**
+   * Hyperlink rendering.
+   * - `"inline"` (default): `[text](https://url)`.
+   * - `"reference"`: `[text][N]` + a reference list trailer.
+   */
+  hyperlinks?: "inline" | "reference";
+  /**
+   * Footnote/endnote references. Folio addition over upstream #595 (which
+   * always emitted `[^N]` markers + a definitions trailer).
+   * - `"keep"` (default): `[^N]` markers + a definitions trailer.
+   * - `"strip"`: drop footnote markers and their definitions entirely.
+   */
+  footnotes?: "keep" | "strip";
+  /**
+   * Receives the {@link ImageMeta} for each image and returns the virtual path
+   * placed inside the markdown's `![alt](virtualPath)` reference. Defaults to
+   * `./images/{paraId}-img{n}.{ext}` (or `./images/img{n}.{ext}`).
+   */
+  imagePath?: (info: ImageMeta) => string;
+};
+/** Result of a render, when the caller needs images/warnings as well as text. */
+type MarkdownResult = {
+  /** The full rendered markdown string. */markdown: string; /** Every image referenced in `markdown`, keyed by its virtual path. */
+  images: Map<string, ImageRef>; /** Non-fatal diagnostics; recurring messages are deduped. */
+  warnings: string[];
+};
+/** Resolved option values with defaults applied. Used internally. */
+type ResolvedOptions = {
+  annotations: "html" | "pandoc" | "strip";
+  trackedChanges: "clean" | "annotate";
+  comments: "strip" | "inline" | "sidecar";
+  hyperlinks: "inline" | "reference";
+  footnotes: "keep" | "strip";
+  imagePath?: ((info: ImageMeta) => string) | undefined;
+};
+/**
+ * Internal rendering context threaded through every render call. Aggregates
+ * side-channel output: image map, warnings, and footnote/comment/hyperlink
+ * reference lists. Exported only so the split renderer files share the shape.
+ */
+type RenderContext = {
+  opts: ResolvedOptions; /** Accumulated images keyed by virtual path. */
+  images: Map<string, ImageRef>; /** Same images keyed by source `MediaFile.path` for dedupe on re-reference. */
+  imagesByPath: Map<string, ImageRef>; /** Diagnostics accumulator. */
+  warnings: string[]; /** Footnote/endnote refs collected during this render, in document order. */
+  footnoteRefs: {
+    refId: number;
+    markerNumber: number;
+    kind: "footnote" | "endnote";
+  }[]; /** Comment refs collected during this render (sidecar mode only). */
+  commentRefs: {
+    commentId: number;
+    markerNumber: number;
+  }[]; /** Hyperlink refs collected during this render (reference mode only). */
+  hyperlinkRefs: {
+    href: string;
+    refNumber: number;
+  }[]; /** 1-based counter for default virtual paths. */
+  imageCounter: number; /** Live list counters per numId, for resolving `%N` marker templates. */
+  listCounters: Map<number, number[]>; /** `numId:level` pairs already seen, so a start override applies once. */
+  listSeenLevels: Set<string>;
+};
+//#endregion
+export { ImageMeta, ImageRef, MarkdownOptions, MarkdownResult, RenderContext, ResolvedOptions };

package/dist/model.d.ts

@@ -0,0 +1,13 @@
+import { document_d_exports } from "./types/document.js";
+import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
+import { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIASES, OUTLINE_STYLE_CSS_ALIAS_VALUES, OutlineStyleAttr, OutlineStyleCssAlias, PARAGRAPH_ALIGNMENT_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES } from "./types/documentEnumValues.js";
+import { types_d_exports } from "./layout-engine/types.js";
+import { measureTypes_d_exports } from "./layout-engine/measure/measureTypes.js";
+export * from "@stll/docx-core/model";
+
+//#region src/model.d.ts
+declare namespace model_d_exports {
+  export { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, DeriveBlockIdInput, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, FolioBlockId, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, types_d_exports as Layout, measureTypes_d_exports as Measure, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIASES, OUTLINE_STYLE_CSS_ALIAS_VALUES, OutlineStyleAttr, OutlineStyleCssAlias, PARAGRAPH_ALIGNMENT_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isFolioBlockId, isSequentialFolioBlockId };
+}
+//#endregion
+export { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, DeriveBlockIdInput, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, FolioBlockId, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, types_d_exports as Layout, type measureTypes_d_exports as Measure, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIASES, OUTLINE_STYLE_CSS_ALIAS_VALUES, OutlineStyleAttr, OutlineStyleCssAlias, PARAGRAPH_ALIGNMENT_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isFolioBlockId, isSequentialFolioBlockId };

package/dist/model.js

@@ -0,0 +1,4 @@
+import { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIASES, OUTLINE_STYLE_CSS_ALIAS_VALUES, PARAGRAPH_ALIGNMENT_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES } from "./types/documentEnumValues.js";
+import { deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
+import { types_exports } from "./layout-engine/types.js";
+export { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, types_exports as Layout, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIASES, OUTLINE_STYLE_CSS_ALIAS_VALUES, PARAGRAPH_ALIGNMENT_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isFolioBlockId, isSequentialFolioBlockId };

package/dist/paged-layout/LayoutSelectionGate.d.ts

@@ -0,0 +1,80 @@
+//#region src/paged-layout/LayoutSelectionGate.d.ts
+/**
+ * Layout Selection Gate
+ *
+ * Guards selection rendering until layout is up-to-date.
+ * Uses sequenced versioning to prevent stale cursor positions.
+ */
+type RenderCallback = () => void;
+/**
+ * LayoutSelectionGate coordinates the timing between document edits and
+ * layout reflow so that selection overlays are only painted against
+ * current DOM geometry.
+ *
+ * Workflow:
+ * 1. Document changes → setStateSeq(++seq)
+ * 2. Layout starts → onLayoutStart()
+ * 3. Layout completes → onLayoutComplete(seq)
+ * 4. Selection update requested → requestRender()
+ * 5. If safe → callback is called
+ */
+declare class LayoutSelectionGate {
+  #private;
+  /**
+   * Set the document state sequence (call when document changes).
+   * This should be called on every ProseMirror transaction that changes the doc.
+   */
+  setStateSeq(seq: number): void;
+  /**
+   * Increment document state sequence (convenience method).
+   * Returns the new sequence value.
+   */
+  incrementStateSeq(): number;
+  /**
+   * Get current document state sequence.
+   */
+  getStateSeq(): number;
+  /**
+   * Get current layout render sequence.
+   */
+  getRenderSeq(): number;
+  /**
+   * Called when layout computation starts.
+   */
+  onLayoutStart(): void;
+  /**
+   * Called when layout computation and DOM painting completes.
+   * @param seq - The document state sequence that was just painted
+   */
+  onLayoutComplete(seq: number): void;
+  /**
+   * Check if it's safe to render selection.
+   * Safe when: layout is not updating AND render sequence >= state sequence
+   */
+  isSafeToRender(): boolean;
+  /**
+   * Request a selection render. Will be executed when safe.
+   * If already safe, executes immediately.
+   */
+  requestRender(): void;
+  /**
+   * Register a callback to be called on render events.
+   */
+  onRender(callback: RenderCallback): () => void;
+  /**
+   * Reset the gate state (useful for testing or document reload).
+   */
+  reset(): void;
+  /**
+   * Get debug info about current state.
+   */
+  getDebugInfo(): {
+    stateSeq: number;
+    renderSeq: number;
+    layoutUpdating: boolean;
+    hasPendingRender: boolean;
+    isSafe: boolean;
+  };
+}
+//#endregion
+export { LayoutSelectionGate };

package/dist/paged-layout/LayoutSelectionGate.js

@@ -0,0 +1,131 @@
+//#region src/paged-layout/LayoutSelectionGate.ts
+/**
+* LayoutSelectionGate coordinates the timing between document edits and
+* layout reflow so that selection overlays are only painted against
+* current DOM geometry.
+*
+* Workflow:
+* 1. Document changes → setStateSeq(++seq)
+* 2. Layout starts → onLayoutStart()
+* 3. Layout completes → onLayoutComplete(seq)
+* 4. Selection update requested → requestRender()
+* 5. If safe → callback is called
+*/
+var LayoutSelectionGate = class {
+	/** Current document state sequence */
+	#stateSeq = 0;
+	/** Last painted layout sequence */
+	#renderSeq = 0;
+	/** Whether layout is currently being computed/painted */
+	#layoutUpdating = false;
+	/** Pending render callback */
+	#pendingRender = null;
+	/** Registered render callbacks */
+	#renderCallbacks = /* @__PURE__ */ new Set();
+	/**
+	* Set the document state sequence (call when document changes).
+	* This should be called on every ProseMirror transaction that changes the doc.
+	*/
+	setStateSeq(seq) {
+		this.#stateSeq = seq;
+	}
+	/**
+	* Increment document state sequence (convenience method).
+	* Returns the new sequence value.
+	*/
+	incrementStateSeq() {
+		return ++this.#stateSeq;
+	}
+	/**
+	* Get current document state sequence.
+	*/
+	getStateSeq() {
+		return this.#stateSeq;
+	}
+	/**
+	* Get current layout render sequence.
+	*/
+	getRenderSeq() {
+		return this.#renderSeq;
+	}
+	/**
+	* Called when layout computation starts.
+	*/
+	onLayoutStart() {
+		this.#layoutUpdating = true;
+	}
+	/**
+	* Called when layout computation and DOM painting completes.
+	* @param seq - The document state sequence that was just painted
+	*/
+	onLayoutComplete(seq) {
+		this.#renderSeq = seq;
+		this.#layoutUpdating = false;
+		this.#tryRender();
+	}
+	/**
+	* Check if it's safe to render selection.
+	* Safe when: layout is not updating AND render sequence >= state sequence
+	*/
+	isSafeToRender() {
+		return !this.#layoutUpdating && this.#renderSeq >= this.#stateSeq;
+	}
+	/**
+	* Request a selection render. Will be executed when safe.
+	* If already safe, executes immediately.
+	*/
+	requestRender() {
+		if (this.isSafeToRender()) this.#executeRender();
+		else this.#pendingRender = () => this.#executeRender();
+	}
+	/**
+	* Register a callback to be called on render events.
+	*/
+	onRender(callback) {
+		this.#renderCallbacks.add(callback);
+		return () => {
+			this.#renderCallbacks.delete(callback);
+		};
+	}
+	/**
+	* Try to execute pending render if safe.
+	*/
+	#tryRender() {
+		if (this.#pendingRender && this.isSafeToRender()) {
+			const render = this.#pendingRender;
+			this.#pendingRender = null;
+			render();
+		}
+	}
+	/**
+	* Execute all registered render callbacks.
+	*/
+	#executeRender() {
+		for (const callback of this.#renderCallbacks) try {
+			callback();
+		} catch {}
+	}
+	/**
+	* Reset the gate state (useful for testing or document reload).
+	*/
+	reset() {
+		this.#stateSeq = 0;
+		this.#renderSeq = 0;
+		this.#layoutUpdating = false;
+		this.#pendingRender = null;
+	}
+	/**
+	* Get debug info about current state.
+	*/
+	getDebugInfo() {
+		return {
+			stateSeq: this.#stateSeq,
+			renderSeq: this.#renderSeq,
+			layoutUpdating: this.#layoutUpdating,
+			hasPendingRender: this.#pendingRender !== null,
+			isSafe: this.isSafeToRender()
+		};
+	}
+};
+//#endregion
+export { LayoutSelectionGate };