markdown-codec 4.0.14 → 4.1.0

package/dist/write.js

@@ -1,10 +1,28 @@
 import { MarkdownDiagnosticCodes, MarkdownPackageFlattenError, MarkdownUnsupportedDocumentKindError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "./diagnostics/diagnostics.js";
+import { emitFrontMatter } from "./emit/front-matter.js";
+import { escapeLinkDestination, renderLinkTitle } from "./emit/inline.js";
 import { emitMarkdown } from "./emit/emit.js";
 import { flattenPackage } from "document-schema.js";
 //#region src/write.ts
-function reportDroppedPackageTables(documentPackage, sink) {
+function renderLinkDefinition(label, entry) {
+	const destination = entry.destination;
+	const title = entry.title;
+	if (typeof destination !== "string") return;
+	if (title !== void 0 && typeof title !== "string") return;
+	return `[${label}]: ${escapeLinkDestination(destination)}${title === void 0 ? "" : ` "${renderLinkTitle(title)}"`}`;
+}
+function renderLinkDefinitions(definitions) {
+	const lines = [];
+	for (const [label, entry] of Object.entries(definitions)) {
+		const line = renderLinkDefinition(label, entry);
+		if (line !== void 0) lines.push(line);
+	}
+	return lines.length > 0 ? lines.join("\n") : void 0;
+}
+function reportDroppedPackageTables(documentPackage, definitionsRendered, sink) {
+	const definitions = documentPackage.definitions;
 	const tables = [
-		["definitions", documentPackage.definitions !== void 0 && Object.keys(documentPackage.definitions).length > 0],
+		["definitions", definitions !== void 0 && !definitionsRendered && Object.keys(definitions).length > 0],
 		["layers", documentPackage.layers !== void 0 && Object.keys(documentPackage.layers).length > 0],
 		["attachments", documentPackage.attachments !== void 0 && Object.keys(documentPackage.attachments).length > 0],
 		["destinations", documentPackage.destinations !== void 0 && Object.keys(documentPackage.destinations).length > 0],
@@ -22,14 +40,23 @@ function reportDroppedPackageTables(documentPackage, sink) {
 function writeMarkdown(documentPackage, options = {}) {
 	options.signal?.throwIfAborted();
 	if (documentPackage.kind !== "wordprocessing") throw new MarkdownUnsupportedDocumentKindError(documentPackage.kind);
-	reportDroppedPackageTables(documentPackage, options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK);
+	const sink = options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK;
+	const definitionsBlock = documentPackage.definitions === void 0 ? void 0 : renderLinkDefinitions(documentPackage.definitions);
+	reportDroppedPackageTables(documentPackage, definitionsBlock !== void 0, sink);
 	let flattened;
 	try {
 		flattened = flattenPackage(documentPackage);
 	} catch (error) {
 		throw new MarkdownPackageFlattenError(error);
 	}
-	return writeMarkdownContent(flattened, options);
+	const body = writeMarkdownContent(flattened, {
+		...options,
+		frontMatter: false
+	});
+	const frontMatterResidue = documentPackage.source?.frontmatter;
+	const frontMatter = options.frontMatter === true ? frontMatterResidue?.format === "markdown" ? frontMatterResidue.xml : emitFrontMatter(flattened.metadata) : void 0;
+	const withFrontMatter = frontMatter === void 0 ? body : `${frontMatter}\n\n${body}`;
+	return definitionsBlock === void 0 ? withFrontMatter : withFrontMatter.length > 0 ? `${withFrontMatter}\n\n${definitionsBlock}` : definitionsBlock;
 }
 function writeMarkdownContent(document, options = {}) {
 	options.signal?.throwIfAborted();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdown-codec",
-  "version": "4.0.14",
+  "version": "4.1.0",
   "description": "Hand-written CommonMark+GFM <-> DocumentPackage codec, built on document-schema.js",
   "type": "module",
   "repository": {
@@ -81,7 +81,7 @@
   "license": "MIT",
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "document-schema.js": "^4.6.0",
+    "document-schema.js": "^4.8.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/dist/link-Dv4kxVjk.d.cts

@@ -1,18 +0,0 @@
-//#region src/inline/link.d.ts
-interface LinkReferenceDefinition {
-  readonly destination: string;
-  readonly title?: string;
-}
-type LinkReferenceMap = ReadonlyMap<string, LinkReferenceDefinition>;
-declare function normalizeLinkLabel(labelWithBrackets: string): string;
-declare function matchLinkLabel(text: string, start: number): number;
-interface ParsedSpan {
-  readonly value: string;
-  readonly end: number;
-}
-declare function parseLinkDestination(text: string, start: number): ParsedSpan | undefined;
-declare function parseLinkTitle(text: string, start: number): ParsedSpan | undefined;
-declare function skipInlineWhitespace(text: string, start: number): number;
-declare function isBlankRemainderOfLine(text: string, start: number): boolean;
-//#endregion
-export { matchLinkLabel as a, parseLinkTitle as c, isBlankRemainderOfLine as i, skipInlineWhitespace as l, LinkReferenceMap as n, normalizeLinkLabel as o, ParsedSpan as r, parseLinkDestination as s, LinkReferenceDefinition as t };

package/dist/link-Dv4kxVjk.d.ts

@@ -1,18 +0,0 @@
-//#region src/inline/link.d.ts
-interface LinkReferenceDefinition {
-  readonly destination: string;
-  readonly title?: string;
-}
-type LinkReferenceMap = ReadonlyMap<string, LinkReferenceDefinition>;
-declare function normalizeLinkLabel(labelWithBrackets: string): string;
-declare function matchLinkLabel(text: string, start: number): number;
-interface ParsedSpan {
-  readonly value: string;
-  readonly end: number;
-}
-declare function parseLinkDestination(text: string, start: number): ParsedSpan | undefined;
-declare function parseLinkTitle(text: string, start: number): ParsedSpan | undefined;
-declare function skipInlineWhitespace(text: string, start: number): number;
-declare function isBlankRemainderOfLine(text: string, start: number): boolean;
-//#endregion
-export { matchLinkLabel as a, parseLinkTitle as c, isBlankRemainderOfLine as i, skipInlineWhitespace as l, LinkReferenceMap as n, normalizeLinkLabel as o, ParsedSpan as r, parseLinkDestination as s, LinkReferenceDefinition as t };