markdown-codec 0.0.0 → 1.0.1

package/dist/diagnostics/diagnostics.d.ts

@@ -0,0 +1,2 @@
+import { a as MarkdownInputTooLargeError, c as MarkdownParseError, d as NOOP_MARKDOWN_DIAGNOSTIC_SINK, i as MarkdownDiagnosticSink, l as MarkdownUnsupportedDocumentKindError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownWriteError } from "../diagnostics-DmuWc7d8.js";
+export { MarkdownDiagnostic, MarkdownDiagnosticCodes, MarkdownDiagnosticSeverity, MarkdownDiagnosticSink, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };

package/dist/diagnostics/diagnostics.js

@@ -0,0 +1,77 @@
+//#region src/diagnostics/diagnostics.ts
+const NOOP_MARKDOWN_DIAGNOSTIC_SINK = () => {};
+const MarkdownDiagnosticCodes = {
+	UNCLOSED_FENCE: "md/unclosed-fence",
+	UNTERMINATED_HTML_BLOCK: "md/unterminated-html-block",
+	TABLE_CELL_COUNT_MISMATCH: "md/table-cell-count-mismatch",
+	DUPLICATE_LINK_REFERENCE: "md/duplicate-link-reference",
+	LIST_MARKER_TYPE_CONFLICT: "md/list-marker-type-conflict",
+	INVENTED_PAGE_GEOMETRY: "md/invented-page-geometry",
+	NESTED_EMPHASIS_FLATTENED: "md/nested-emphasis-flattened",
+	LINK_TITLE_DROPPED: "md/link-title-dropped",
+	CODE_BLOCK_INFO_STRING_DROPPED: "md/code-block-info-string-dropped",
+	BLOCKQUOTE_NESTED_DEPTH: "md/blockquote-nested-depth",
+	LIST_ITEM_BLOCK_UNLISTED: "md/list-item-block-unlisted",
+	LIST_ITEM_MULTI_BLOCK_FLATTENED: "md/list-item-multi-block-flattened",
+	IMAGE_UNRESOLVED: "md/image-unresolved",
+	RAW_HTML_PRESERVED_AS_TEXT: "md/raw-html-preserved-as-text",
+	RAW_HTML_DROPPED: "md/raw-html-dropped",
+	FRONT_MATTER_KEY_UNMAPPED: "md/front-matter-key-unmapped",
+	HEADING_LEVEL_CLAMPED: "md/heading-level-clamped",
+	ADJACENT_LINKS_MERGED: "md/adjacent-links-merged",
+	CODE_SPAN_AS_MONOSPACE_RUN: "md/code-span-as-monospace-run",
+	PARAGRAPH_INDENT_DROPPED: "md/paragraph-indent-dropped",
+	LIST_NUMID_FALLBACK: "md/list-numid-fallback",
+	TABLE_CELL_FORMATTING_DROPPED: "md/table-cell-formatting-dropped",
+	TABLE_CELL_MULTI_PARAGRAPH_JOINED: "md/table-cell-multi-paragraph-joined"
+};
+var MarkdownParseError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "MarkdownParseError";
+		this.code = code;
+	}
+};
+var MarkdownInvalidUtf8Error = class extends MarkdownParseError {
+	constructor(message = "input is not valid UTF-8") {
+		super("md/invalid-utf8", message);
+		this.name = "MarkdownInvalidUtf8Error";
+	}
+};
+var MarkdownInputTooLargeError = class extends MarkdownParseError {
+	maxInputBytes;
+	actualBytes;
+	constructor(maxInputBytes, actualBytes) {
+		super("md/input-too-large", `input is ${String(actualBytes)} bytes, exceeding the configured maximum of ${String(maxInputBytes)} bytes`);
+		this.name = "MarkdownInputTooLargeError";
+		this.maxInputBytes = maxInputBytes;
+		this.actualBytes = actualBytes;
+	}
+};
+var MarkdownNestingLimitExceededError = class extends MarkdownParseError {
+	maxNesting;
+	constructor(maxNesting) {
+		super("md/nesting-limit-exceeded", `block nesting exceeds the configured limit of ${String(maxNesting)}`);
+		this.name = "MarkdownNestingLimitExceededError";
+		this.maxNesting = maxNesting;
+	}
+};
+var MarkdownWriteError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "MarkdownWriteError";
+		this.code = code;
+	}
+};
+var MarkdownUnsupportedDocumentKindError = class extends MarkdownWriteError {
+	kind;
+	constructor(kind) {
+		super("md/write-side-not-wordprocessing", `writeMarkdown only supports a 'wordprocessing' ContentDocument, got '${kind}'`);
+		this.name = "MarkdownUnsupportedDocumentKindError";
+		this.kind = kind;
+	}
+};
+//#endregion
+export { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };

package/dist/diagnostics-DmuWc7d8.d.cts

@@ -0,0 +1,61 @@
+//#region src/diagnostics/diagnostics.d.ts
+type MarkdownDiagnosticSeverity = 'info' | 'warning';
+interface MarkdownDiagnostic {
+  readonly code: string;
+  readonly severity: MarkdownDiagnosticSeverity;
+  readonly message: string;
+  readonly line?: number;
+}
+type MarkdownDiagnosticSink = (diagnostic: MarkdownDiagnostic) => void;
+declare const NOOP_MARKDOWN_DIAGNOSTIC_SINK: MarkdownDiagnosticSink;
+declare const MarkdownDiagnosticCodes: {
+  readonly UNCLOSED_FENCE: "md/unclosed-fence";
+  readonly UNTERMINATED_HTML_BLOCK: "md/unterminated-html-block";
+  readonly TABLE_CELL_COUNT_MISMATCH: "md/table-cell-count-mismatch";
+  readonly DUPLICATE_LINK_REFERENCE: "md/duplicate-link-reference";
+  readonly LIST_MARKER_TYPE_CONFLICT: "md/list-marker-type-conflict";
+  readonly INVENTED_PAGE_GEOMETRY: "md/invented-page-geometry";
+  readonly NESTED_EMPHASIS_FLATTENED: "md/nested-emphasis-flattened";
+  readonly LINK_TITLE_DROPPED: "md/link-title-dropped";
+  readonly CODE_BLOCK_INFO_STRING_DROPPED: "md/code-block-info-string-dropped";
+  readonly BLOCKQUOTE_NESTED_DEPTH: "md/blockquote-nested-depth";
+  readonly LIST_ITEM_BLOCK_UNLISTED: "md/list-item-block-unlisted";
+  readonly LIST_ITEM_MULTI_BLOCK_FLATTENED: "md/list-item-multi-block-flattened";
+  readonly IMAGE_UNRESOLVED: "md/image-unresolved";
+  readonly RAW_HTML_PRESERVED_AS_TEXT: "md/raw-html-preserved-as-text";
+  readonly RAW_HTML_DROPPED: "md/raw-html-dropped";
+  readonly FRONT_MATTER_KEY_UNMAPPED: "md/front-matter-key-unmapped";
+  readonly HEADING_LEVEL_CLAMPED: "md/heading-level-clamped";
+  readonly ADJACENT_LINKS_MERGED: "md/adjacent-links-merged";
+  readonly CODE_SPAN_AS_MONOSPACE_RUN: "md/code-span-as-monospace-run";
+  readonly PARAGRAPH_INDENT_DROPPED: "md/paragraph-indent-dropped";
+  readonly LIST_NUMID_FALLBACK: "md/list-numid-fallback";
+  readonly TABLE_CELL_FORMATTING_DROPPED: "md/table-cell-formatting-dropped";
+  readonly TABLE_CELL_MULTI_PARAGRAPH_JOINED: "md/table-cell-multi-paragraph-joined";
+};
+declare class MarkdownParseError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class MarkdownInvalidUtf8Error extends MarkdownParseError {
+  constructor(message?: string);
+}
+declare class MarkdownInputTooLargeError extends MarkdownParseError {
+  readonly maxInputBytes: number;
+  readonly actualBytes: number;
+  constructor(maxInputBytes: number, actualBytes: number);
+}
+declare class MarkdownNestingLimitExceededError extends MarkdownParseError {
+  readonly maxNesting: number;
+  constructor(maxNesting: number);
+}
+declare class MarkdownWriteError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class MarkdownUnsupportedDocumentKindError extends MarkdownWriteError {
+  readonly kind: string;
+  constructor(kind: string);
+}
+//#endregion
+export { MarkdownInputTooLargeError as a, MarkdownParseError as c, NOOP_MARKDOWN_DIAGNOSTIC_SINK as d, MarkdownDiagnosticSink as i, MarkdownUnsupportedDocumentKindError as l, MarkdownDiagnosticCodes as n, MarkdownInvalidUtf8Error as o, MarkdownDiagnosticSeverity as r, MarkdownNestingLimitExceededError as s, MarkdownDiagnostic as t, MarkdownWriteError as u };

package/dist/diagnostics-DmuWc7d8.d.ts

@@ -0,0 +1,61 @@
+//#region src/diagnostics/diagnostics.d.ts
+type MarkdownDiagnosticSeverity = 'info' | 'warning';
+interface MarkdownDiagnostic {
+  readonly code: string;
+  readonly severity: MarkdownDiagnosticSeverity;
+  readonly message: string;
+  readonly line?: number;
+}
+type MarkdownDiagnosticSink = (diagnostic: MarkdownDiagnostic) => void;
+declare const NOOP_MARKDOWN_DIAGNOSTIC_SINK: MarkdownDiagnosticSink;
+declare const MarkdownDiagnosticCodes: {
+  readonly UNCLOSED_FENCE: "md/unclosed-fence";
+  readonly UNTERMINATED_HTML_BLOCK: "md/unterminated-html-block";
+  readonly TABLE_CELL_COUNT_MISMATCH: "md/table-cell-count-mismatch";
+  readonly DUPLICATE_LINK_REFERENCE: "md/duplicate-link-reference";
+  readonly LIST_MARKER_TYPE_CONFLICT: "md/list-marker-type-conflict";
+  readonly INVENTED_PAGE_GEOMETRY: "md/invented-page-geometry";
+  readonly NESTED_EMPHASIS_FLATTENED: "md/nested-emphasis-flattened";
+  readonly LINK_TITLE_DROPPED: "md/link-title-dropped";
+  readonly CODE_BLOCK_INFO_STRING_DROPPED: "md/code-block-info-string-dropped";
+  readonly BLOCKQUOTE_NESTED_DEPTH: "md/blockquote-nested-depth";
+  readonly LIST_ITEM_BLOCK_UNLISTED: "md/list-item-block-unlisted";
+  readonly LIST_ITEM_MULTI_BLOCK_FLATTENED: "md/list-item-multi-block-flattened";
+  readonly IMAGE_UNRESOLVED: "md/image-unresolved";
+  readonly RAW_HTML_PRESERVED_AS_TEXT: "md/raw-html-preserved-as-text";
+  readonly RAW_HTML_DROPPED: "md/raw-html-dropped";
+  readonly FRONT_MATTER_KEY_UNMAPPED: "md/front-matter-key-unmapped";
+  readonly HEADING_LEVEL_CLAMPED: "md/heading-level-clamped";
+  readonly ADJACENT_LINKS_MERGED: "md/adjacent-links-merged";
+  readonly CODE_SPAN_AS_MONOSPACE_RUN: "md/code-span-as-monospace-run";
+  readonly PARAGRAPH_INDENT_DROPPED: "md/paragraph-indent-dropped";
+  readonly LIST_NUMID_FALLBACK: "md/list-numid-fallback";
+  readonly TABLE_CELL_FORMATTING_DROPPED: "md/table-cell-formatting-dropped";
+  readonly TABLE_CELL_MULTI_PARAGRAPH_JOINED: "md/table-cell-multi-paragraph-joined";
+};
+declare class MarkdownParseError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class MarkdownInvalidUtf8Error extends MarkdownParseError {
+  constructor(message?: string);
+}
+declare class MarkdownInputTooLargeError extends MarkdownParseError {
+  readonly maxInputBytes: number;
+  readonly actualBytes: number;
+  constructor(maxInputBytes: number, actualBytes: number);
+}
+declare class MarkdownNestingLimitExceededError extends MarkdownParseError {
+  readonly maxNesting: number;
+  constructor(maxNesting: number);
+}
+declare class MarkdownWriteError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class MarkdownUnsupportedDocumentKindError extends MarkdownWriteError {
+  readonly kind: string;
+  constructor(kind: string);
+}
+//#endregion
+export { MarkdownInputTooLargeError as a, MarkdownParseError as c, NOOP_MARKDOWN_DIAGNOSTIC_SINK as d, MarkdownDiagnosticSink as i, MarkdownUnsupportedDocumentKindError as l, MarkdownDiagnosticCodes as n, MarkdownInvalidUtf8Error as o, MarkdownDiagnosticSeverity as r, MarkdownNestingLimitExceededError as s, MarkdownDiagnostic as t, MarkdownWriteError as u };

package/dist/emit/emit.cjs

@@ -0,0 +1,228 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../defaults/defaults.cjs");
+const require_diagnostics_diagnostics = require("../diagnostics/diagnostics.cjs");
+const require_shared_list_id = require("../shared/list-id.cjs");
+const require_shared_style_constants = require("../shared/style-constants.cjs");
+const require_emit_front_matter = require("./front-matter.cjs");
+const require_emit_inline = require("./inline.cjs");
+const require_emit_image = require("./image.cjs");
+const require_emit_table = require("./table.cjs");
+//#region src/emit/emit.ts
+const MAX_SETEXT_LEVEL = 2;
+const SETEXT_LEVEL_1_CHAR = "=";
+const SETEXT_LEVEL_2_CHAR = "-";
+const MIN_SETEXT_UNDERLINE_LENGTH = 1;
+function renderSetextHeading(level, text) {
+	const underlineChar = level === 1 ? SETEXT_LEVEL_1_CHAR : SETEXT_LEVEL_2_CHAR;
+	const firstLine = text.split("\n")[0] ?? "";
+	return `${text}\n${underlineChar.repeat(Math.max(MIN_SETEXT_UNDERLINE_LENGTH, firstLine.length))}`;
+}
+const MIN_CODE_FENCE_LENGTH = 3;
+function longestRunLength(text, char) {
+	let longest = 0;
+	let current = 0;
+	for (const candidate of text) if (candidate === char) {
+		current += 1;
+		longest = Math.max(longest, current);
+	} else current = 0;
+	return longest;
+}
+function codeFenceFor(literal, fenceChar) {
+	return fenceChar.repeat(Math.max(MIN_CODE_FENCE_LENGTH, longestRunLength(literal, fenceChar) + 1));
+}
+const QUOTABLE_STYLE_IDS = /* @__PURE__ */ new Set([
+	require_shared_style_constants.QUOTE_STYLE_ID,
+	require_shared_style_constants.CODE_BLOCK_STYLE_ID,
+	require_shared_style_constants.HORIZONTAL_RULE_STYLE_ID,
+	require_shared_style_constants.HTML_PREFORMATTED_STYLE_ID
+]);
+function isQuotableStyle(styleId) {
+	if (styleId === void 0) return false;
+	return QUOTABLE_STYLE_IDS.has(styleId) || require_shared_style_constants.parseHeadingStyleId(styleId) !== void 0;
+}
+function quoteDepthOf(paragraph) {
+	if (paragraph.indentLeftPt === void 0 || paragraph.indentLeftPt <= 0) return 0;
+	return Math.max(1, Math.round(paragraph.indentLeftPt / 36));
+}
+function renderParagraphBody(paragraph, context) {
+	if (paragraph.styleId === "HorizontalRule") return context.thematicBreakChar.repeat(3);
+	if (paragraph.styleId === "CodeBlock") {
+		const literal = paragraph.runs.map((run) => run.text).join("");
+		const fence = codeFenceFor(literal, context.codeFenceChar);
+		return literal.length === 0 ? `${fence}\n${fence}` : `${fence}\n${literal}\n${fence}`;
+	}
+	if (paragraph.styleId === "HTMLPreformatted") return paragraph.runs.map((run) => run.text).join("");
+	const headingLevel = paragraph.styleId === void 0 ? void 0 : require_shared_style_constants.parseHeadingStyleId(paragraph.styleId);
+	if (headingLevel !== void 0) {
+		let level = headingLevel;
+		if (level > 6) {
+			context.sink({
+				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.HEADING_LEVEL_CLAMPED,
+				severity: "info",
+				message: `heading level ${String(level)} exceeds ATX's own six-"#" ceiling and is clamped to ${String(6)}`
+			});
+			level = 6;
+		}
+		const text = require_emit_inline.emitRuns(paragraph.runs, context);
+		if (context.headingStyle === "setext" && level <= MAX_SETEXT_LEVEL) return renderSetextHeading(level, text);
+		return `${"#".repeat(level)} ${text}`;
+	}
+	return require_emit_inline.emitRuns(paragraph.runs, context);
+}
+function renderParagraph(paragraph, context) {
+	const body = renderParagraphBody(paragraph, context);
+	const depth = quoteDepthOf(paragraph);
+	if (depth === 0) return body;
+	if (!isQuotableStyle(paragraph.styleId)) {
+		context.sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.PARAGRAPH_INDENT_DROPPED,
+			severity: "info",
+			message: `paragraph carries indentLeftPt (${String(paragraph.indentLeftPt)}pt) with no styleId this package recognises as quotable; the indent has no other markdown representation and is dropped`
+		});
+		return body;
+	}
+	const prefix = "> ".repeat(depth);
+	return body.split("\n").map((line) => `${prefix}${line}`).join("\n");
+}
+function renderTopLevelBlock(block, context) {
+	switch (block.kind) {
+		case "paragraph": return renderParagraph(block, context);
+		case "table": return require_emit_table.emitTable(block, context);
+		case "image": return require_emit_image.emitImage(block, context.embedImages);
+		case "pageBreak":
+		case "embeddedObject": return "";
+	}
+}
+function listInfoFor(numId, context) {
+	const info = require_shared_list_id.parseListNumId(numId);
+	if (info === void 0 && !context.reportedFallbackNumIds.has(numId)) {
+		context.reportedFallbackNumIds.add(numId);
+		context.sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.LIST_NUMID_FALLBACK,
+			severity: "info",
+			message: `numId "${numId}" was not minted by this package's own src/lower and falls back to an ordinary, tight, non-task bullet list`
+		});
+	}
+	return info;
+}
+function checkboxPrefixFor(item) {
+	const first = item.runs[0];
+	if (first === void 0) return;
+	if (first.text.startsWith(`☒ `)) return "[x] ";
+	if (first.text.startsWith(`☐ `)) return "[ ] ";
+}
+function stripCheckboxRun(item, checkboxPrefix) {
+	if (checkboxPrefix === void 0) return item;
+	const first = item.runs[0];
+	const glyphPrefix = checkboxPrefix === "[x] " ? `☒ ` : `☐ `;
+	if (!first?.text.startsWith(glyphPrefix)) return item;
+	const strippedText = first.text.slice(glyphPrefix.length);
+	const runs = strippedText.length === 0 ? item.runs.slice(1) : [{
+		...first,
+		text: strippedText
+	}, ...item.runs.slice(1)];
+	return {
+		...item,
+		runs
+	};
+}
+function renderListItemMarker(numId, info, item, context) {
+	const checkboxText = (info?.task === true ? checkboxPrefixFor(item) : void 0) ?? "";
+	if (info?.type === "ordered") {
+		const next = context.orderedCounters.get(numId) ?? info.start ?? 1;
+		context.orderedCounters.set(numId, next + 1);
+		const bare = `${String(next)}${context.orderedDelimiter} `;
+		return {
+			full: `${bare}${checkboxText}`,
+			bareLength: bare.length
+		};
+	}
+	const bare = `${context.bulletMarker} `;
+	return {
+		full: `${bare}${checkboxText}`,
+		bareLength: bare.length
+	};
+}
+function renderListRegion(items, context) {
+	const parts = [];
+	let index = 0;
+	while (index < items.length) {
+		const item = items[index];
+		if (item?.list === void 0) break;
+		const { numId, level } = item.list;
+		const info = listInfoFor(numId, context);
+		let lookahead = index + 1;
+		while (lookahead < items.length && (items[lookahead]?.list?.level ?? -1) > level) lookahead += 1;
+		const nestedItems = items.slice(index + 1, lookahead);
+		const checkboxPrefix = info?.task === true ? checkboxPrefixFor(item) : void 0;
+		const marker = renderListItemMarker(numId, info, item, context);
+		const bodyLines = renderParagraphBody(stripCheckboxRun(item, checkboxPrefix), context).split("\n");
+		const indent = " ".repeat(marker.bareLength);
+		const [firstLine = "", ...restLines] = bodyLines;
+		let text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
+		if (nestedItems.length > 0) {
+			const nested = renderListRegion(nestedItems, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+			text += `\n${nested}`;
+		}
+		parts.push({
+			numId,
+			text
+		});
+		index = lookahead;
+	}
+	let out = "";
+	for (const [partIndex, part] of parts.entries()) {
+		if (partIndex > 0) {
+			const previous = parts[partIndex - 1];
+			const sameList = previous.numId === part.numId;
+			const loose = sameList && (require_shared_list_id.parseListNumId(previous.numId)?.loose ?? false);
+			out += sameList && !loose ? "\n" : "\n\n";
+		}
+		out += part.text;
+	}
+	return out;
+}
+function emitBlocks(blocks, context) {
+	const parts = [];
+	let index = 0;
+	while (index < blocks.length) {
+		const block = blocks[index];
+		if (block === void 0) break;
+		if (block.kind === "paragraph" && block.list !== void 0) {
+			const region = [];
+			let end = index;
+			for (let candidate = blocks[end]; candidate?.kind === "paragraph" && candidate.list !== void 0; candidate = blocks[end]) {
+				region.push(candidate);
+				end += 1;
+			}
+			parts.push(renderListRegion(region, context));
+			index = end;
+			continue;
+		}
+		const rendered = renderTopLevelBlock(block, context);
+		if (rendered.length > 0) parts.push(rendered);
+		index += 1;
+	}
+	return parts.join("\n\n");
+}
+function emitMarkdown(document, options = {}) {
+	if (document.kind !== "wordprocessing") throw new require_diagnostics_diagnostics.MarkdownUnsupportedDocumentKindError(document.kind);
+	const context = {
+		sink: options.sink ?? require_diagnostics_diagnostics.NOOP_MARKDOWN_DIAGNOSTIC_SINK,
+		emphasisMarker: options.emphasisMarker ?? "_",
+		bulletMarker: options.bulletListMarker ?? "-",
+		orderedDelimiter: options.orderedListDelimiter ?? ".",
+		codeFenceChar: options.codeFenceChar ?? "`",
+		thematicBreakChar: options.thematicBreakChar ?? "-",
+		headingStyle: options.headingStyle ?? "atx",
+		embedImages: options.images ?? true,
+		orderedCounters: /* @__PURE__ */ new Map(),
+		reportedFallbackNumIds: /* @__PURE__ */ new Set()
+	};
+	const body = document.sections.map((section) => emitBlocks(section.blocks, context)).join("\n\n");
+	const frontMatter = options.frontMatter === true ? require_emit_front_matter.emitFrontMatter(document.metadata) : void 0;
+	const text = frontMatter === void 0 ? body : `${frontMatter}\n\n${body}`;
+	return (options.lineEnding ?? "lf") === "crlf" ? text.replaceAll("\n", "\r\n") : text;
+}
+//#endregion
+exports.emitMarkdown = emitMarkdown;

package/dist/emit/emit.d.cts

@@ -0,0 +1,6 @@
+import { WriteMarkdownOptions } from "../options/options.cjs";
+import { ContentDocument } from "document-schema.js";
+//#region src/emit/emit.d.ts
+declare function emitMarkdown(document: ContentDocument, options?: WriteMarkdownOptions): string;
+//#endregion
+export { emitMarkdown };

package/dist/emit/emit.d.ts

@@ -0,0 +1,6 @@
+import { WriteMarkdownOptions } from "../options/options.js";
+import { ContentDocument } from "document-schema.js";
+//#region src/emit/emit.d.ts
+declare function emitMarkdown(document: ContentDocument, options?: WriteMarkdownOptions): string;
+//#endregion
+export { emitMarkdown };

package/dist/emit/emit.js

@@ -0,0 +1,227 @@
+import "../defaults/defaults.js";
+import { MarkdownDiagnosticCodes, MarkdownUnsupportedDocumentKindError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "../diagnostics/diagnostics.js";
+import { parseListNumId } from "../shared/list-id.js";
+import { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, QUOTE_STYLE_ID, parseHeadingStyleId } from "../shared/style-constants.js";
+import { emitFrontMatter } from "./front-matter.js";
+import { emitRuns } from "./inline.js";
+import { emitImage } from "./image.js";
+import { emitTable } from "./table.js";
+//#region src/emit/emit.ts
+const MAX_SETEXT_LEVEL = 2;
+const SETEXT_LEVEL_1_CHAR = "=";
+const SETEXT_LEVEL_2_CHAR = "-";
+const MIN_SETEXT_UNDERLINE_LENGTH = 1;
+function renderSetextHeading(level, text) {
+	const underlineChar = level === 1 ? SETEXT_LEVEL_1_CHAR : SETEXT_LEVEL_2_CHAR;
+	const firstLine = text.split("\n")[0] ?? "";
+	return `${text}\n${underlineChar.repeat(Math.max(MIN_SETEXT_UNDERLINE_LENGTH, firstLine.length))}`;
+}
+const MIN_CODE_FENCE_LENGTH = 3;
+function longestRunLength(text, char) {
+	let longest = 0;
+	let current = 0;
+	for (const candidate of text) if (candidate === char) {
+		current += 1;
+		longest = Math.max(longest, current);
+	} else current = 0;
+	return longest;
+}
+function codeFenceFor(literal, fenceChar) {
+	return fenceChar.repeat(Math.max(MIN_CODE_FENCE_LENGTH, longestRunLength(literal, fenceChar) + 1));
+}
+const QUOTABLE_STYLE_IDS = /* @__PURE__ */ new Set([
+	QUOTE_STYLE_ID,
+	CODE_BLOCK_STYLE_ID,
+	HORIZONTAL_RULE_STYLE_ID,
+	HTML_PREFORMATTED_STYLE_ID
+]);
+function isQuotableStyle(styleId) {
+	if (styleId === void 0) return false;
+	return QUOTABLE_STYLE_IDS.has(styleId) || parseHeadingStyleId(styleId) !== void 0;
+}
+function quoteDepthOf(paragraph) {
+	if (paragraph.indentLeftPt === void 0 || paragraph.indentLeftPt <= 0) return 0;
+	return Math.max(1, Math.round(paragraph.indentLeftPt / 36));
+}
+function renderParagraphBody(paragraph, context) {
+	if (paragraph.styleId === "HorizontalRule") return context.thematicBreakChar.repeat(3);
+	if (paragraph.styleId === "CodeBlock") {
+		const literal = paragraph.runs.map((run) => run.text).join("");
+		const fence = codeFenceFor(literal, context.codeFenceChar);
+		return literal.length === 0 ? `${fence}\n${fence}` : `${fence}\n${literal}\n${fence}`;
+	}
+	if (paragraph.styleId === "HTMLPreformatted") return paragraph.runs.map((run) => run.text).join("");
+	const headingLevel = paragraph.styleId === void 0 ? void 0 : parseHeadingStyleId(paragraph.styleId);
+	if (headingLevel !== void 0) {
+		let level = headingLevel;
+		if (level > 6) {
+			context.sink({
+				code: MarkdownDiagnosticCodes.HEADING_LEVEL_CLAMPED,
+				severity: "info",
+				message: `heading level ${String(level)} exceeds ATX's own six-"#" ceiling and is clamped to ${String(6)}`
+			});
+			level = 6;
+		}
+		const text = emitRuns(paragraph.runs, context);
+		if (context.headingStyle === "setext" && level <= MAX_SETEXT_LEVEL) return renderSetextHeading(level, text);
+		return `${"#".repeat(level)} ${text}`;
+	}
+	return emitRuns(paragraph.runs, context);
+}
+function renderParagraph(paragraph, context) {
+	const body = renderParagraphBody(paragraph, context);
+	const depth = quoteDepthOf(paragraph);
+	if (depth === 0) return body;
+	if (!isQuotableStyle(paragraph.styleId)) {
+		context.sink({
+			code: MarkdownDiagnosticCodes.PARAGRAPH_INDENT_DROPPED,
+			severity: "info",
+			message: `paragraph carries indentLeftPt (${String(paragraph.indentLeftPt)}pt) with no styleId this package recognises as quotable; the indent has no other markdown representation and is dropped`
+		});
+		return body;
+	}
+	const prefix = "> ".repeat(depth);
+	return body.split("\n").map((line) => `${prefix}${line}`).join("\n");
+}
+function renderTopLevelBlock(block, context) {
+	switch (block.kind) {
+		case "paragraph": return renderParagraph(block, context);
+		case "table": return emitTable(block, context);
+		case "image": return emitImage(block, context.embedImages);
+		case "pageBreak":
+		case "embeddedObject": return "";
+	}
+}
+function listInfoFor(numId, context) {
+	const info = parseListNumId(numId);
+	if (info === void 0 && !context.reportedFallbackNumIds.has(numId)) {
+		context.reportedFallbackNumIds.add(numId);
+		context.sink({
+			code: MarkdownDiagnosticCodes.LIST_NUMID_FALLBACK,
+			severity: "info",
+			message: `numId "${numId}" was not minted by this package's own src/lower and falls back to an ordinary, tight, non-task bullet list`
+		});
+	}
+	return info;
+}
+function checkboxPrefixFor(item) {
+	const first = item.runs[0];
+	if (first === void 0) return;
+	if (first.text.startsWith(`☒ `)) return "[x] ";
+	if (first.text.startsWith(`☐ `)) return "[ ] ";
+}
+function stripCheckboxRun(item, checkboxPrefix) {
+	if (checkboxPrefix === void 0) return item;
+	const first = item.runs[0];
+	const glyphPrefix = checkboxPrefix === "[x] " ? `☒ ` : `☐ `;
+	if (!first?.text.startsWith(glyphPrefix)) return item;
+	const strippedText = first.text.slice(glyphPrefix.length);
+	const runs = strippedText.length === 0 ? item.runs.slice(1) : [{
+		...first,
+		text: strippedText
+	}, ...item.runs.slice(1)];
+	return {
+		...item,
+		runs
+	};
+}
+function renderListItemMarker(numId, info, item, context) {
+	const checkboxText = (info?.task === true ? checkboxPrefixFor(item) : void 0) ?? "";
+	if (info?.type === "ordered") {
+		const next = context.orderedCounters.get(numId) ?? info.start ?? 1;
+		context.orderedCounters.set(numId, next + 1);
+		const bare = `${String(next)}${context.orderedDelimiter} `;
+		return {
+			full: `${bare}${checkboxText}`,
+			bareLength: bare.length
+		};
+	}
+	const bare = `${context.bulletMarker} `;
+	return {
+		full: `${bare}${checkboxText}`,
+		bareLength: bare.length
+	};
+}
+function renderListRegion(items, context) {
+	const parts = [];
+	let index = 0;
+	while (index < items.length) {
+		const item = items[index];
+		if (item?.list === void 0) break;
+		const { numId, level } = item.list;
+		const info = listInfoFor(numId, context);
+		let lookahead = index + 1;
+		while (lookahead < items.length && (items[lookahead]?.list?.level ?? -1) > level) lookahead += 1;
+		const nestedItems = items.slice(index + 1, lookahead);
+		const checkboxPrefix = info?.task === true ? checkboxPrefixFor(item) : void 0;
+		const marker = renderListItemMarker(numId, info, item, context);
+		const bodyLines = renderParagraphBody(stripCheckboxRun(item, checkboxPrefix), context).split("\n");
+		const indent = " ".repeat(marker.bareLength);
+		const [firstLine = "", ...restLines] = bodyLines;
+		let text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
+		if (nestedItems.length > 0) {
+			const nested = renderListRegion(nestedItems, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+			text += `\n${nested}`;
+		}
+		parts.push({
+			numId,
+			text
+		});
+		index = lookahead;
+	}
+	let out = "";
+	for (const [partIndex, part] of parts.entries()) {
+		if (partIndex > 0) {
+			const previous = parts[partIndex - 1];
+			const sameList = previous.numId === part.numId;
+			const loose = sameList && (parseListNumId(previous.numId)?.loose ?? false);
+			out += sameList && !loose ? "\n" : "\n\n";
+		}
+		out += part.text;
+	}
+	return out;
+}
+function emitBlocks(blocks, context) {
+	const parts = [];
+	let index = 0;
+	while (index < blocks.length) {
+		const block = blocks[index];
+		if (block === void 0) break;
+		if (block.kind === "paragraph" && block.list !== void 0) {
+			const region = [];
+			let end = index;
+			for (let candidate = blocks[end]; candidate?.kind === "paragraph" && candidate.list !== void 0; candidate = blocks[end]) {
+				region.push(candidate);
+				end += 1;
+			}
+			parts.push(renderListRegion(region, context));
+			index = end;
+			continue;
+		}
+		const rendered = renderTopLevelBlock(block, context);
+		if (rendered.length > 0) parts.push(rendered);
+		index += 1;
+	}
+	return parts.join("\n\n");
+}
+function emitMarkdown(document, options = {}) {
+	if (document.kind !== "wordprocessing") throw new MarkdownUnsupportedDocumentKindError(document.kind);
+	const context = {
+		sink: options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK,
+		emphasisMarker: options.emphasisMarker ?? "_",
+		bulletMarker: options.bulletListMarker ?? "-",
+		orderedDelimiter: options.orderedListDelimiter ?? ".",
+		codeFenceChar: options.codeFenceChar ?? "`",
+		thematicBreakChar: options.thematicBreakChar ?? "-",
+		headingStyle: options.headingStyle ?? "atx",
+		embedImages: options.images ?? true,
+		orderedCounters: /* @__PURE__ */ new Map(),
+		reportedFallbackNumIds: /* @__PURE__ */ new Set()
+	};
+	const body = document.sections.map((section) => emitBlocks(section.blocks, context)).join("\n\n");
+	const frontMatter = options.frontMatter === true ? emitFrontMatter(document.metadata) : void 0;
+	const text = frontMatter === void 0 ? body : `${frontMatter}\n\n${body}`;
+	return (options.lineEnding ?? "lf") === "crlf" ? text.replaceAll("\n", "\r\n") : text;
+}
+//#endregion
+export { emitMarkdown };