markdown-codec 3.1.1 → 4.0.0

package/dist/emit/inline.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
 import { ContentRun } from "document-schema.js";
 //#region src/emit/inline.d.ts
 interface InlineEmitContext {

package/dist/emit/inline.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
 import { ContentRun } from "document-schema.js";
 //#region src/emit/inline.d.ts
 interface InlineEmitContext {

package/dist/emit/table.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
 import { InlineEmitContext } from "./inline.cjs";
 import { ContentTable } from "document-schema.js";
 //#region src/emit/table.d.ts

package/dist/emit/table.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
 import { InlineEmitContext } from "./inline.js";
 import { ContentTable } from "document-schema.js";
 //#region src/emit/table.d.ts

package/dist/index.cjs

@@ -26,9 +26,12 @@ exports.QUOTE_STYLE_ID = require_shared_style_constants.QUOTE_STYLE_ID;
 exports.createNumIdMintState = require_shared_list_id.createNumIdMintState;
 exports.headingStyleId = require_shared_style_constants.headingStyleId;
 exports.markdownCodec = require_codec.markdownCodec;
+exports.markdownContentCodec = require_codec.markdownContentCodec;
 exports.mintListNumId = require_shared_list_id.mintListNumId;
 exports.mintedListType = require_shared_list_id.mintedListType;
 exports.parseHeadingStyleId = require_shared_style_constants.parseHeadingStyleId;
 exports.parseListNumId = require_shared_list_id.parseListNumId;
 exports.readMarkdown = require_read.readMarkdown;
+exports.readMarkdownContent = require_read.readMarkdownContent;
 exports.writeMarkdown = require_write.writeMarkdown;
+exports.writeMarkdownContent = require_write.writeMarkdownContent;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { a as MarkdownInputTooLargeError, c as MarkdownParseError, d as MarkdownWriteError, f as NOOP_MARKDOWN_DIAGNOSTIC_SINK, i as MarkdownDiagnosticSink, l as MarkdownUnbalancedConstructMarkersError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnsupportedDocumentKindError } from "./diagnostics-BuO5-SW1.cjs";
-import { MarkdownBytesSchema, markdownCodec } from "./codec.cjs";
+import { a as MarkdownInputTooLargeError, d as MarkdownUnsupportedDocumentKindError, f as MarkdownWriteError, i as MarkdownDiagnosticSink, l as MarkdownParseError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, p as NOOP_MARKDOWN_DIAGNOSTIC_SINK, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnbalancedConstructMarkersError } from "./diagnostics-BWK1iGy7.cjs";
+import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } from "./codec.cjs";
 import { n as MarkdownImageResolver, r as MarkdownResolvedImageBytes, t as MarkdownImageResolveContext } from "./image-C4KYmz_L.cjs";
 import { MarkdownBulletListMarker, MarkdownCodeFenceChar, MarkdownEmphasisMarker, MarkdownHeadingStyle, MarkdownLineEnding, MarkdownOrderedListDelimiter, MarkdownThematicBreakChar, ReadMarkdownOptions, WriteMarkdownOptions, WriteMarkdownStyleOptions } from "./options/options.cjs";
-import { ReadMarkdownResult, readMarkdown } from "./read.cjs";
-import { writeMarkdown } from "./write.cjs";
+import { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdownContent } from "./read.cjs";
+import { writeMarkdown, writeMarkdownContent } from "./write.cjs";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.cjs";
 import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.cjs";
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { a as MarkdownInputTooLargeError, c as MarkdownParseError, d as MarkdownWriteError, f as NOOP_MARKDOWN_DIAGNOSTIC_SINK, i as MarkdownDiagnosticSink, l as MarkdownUnbalancedConstructMarkersError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnsupportedDocumentKindError } from "./diagnostics-BuO5-SW1.js";
-import { MarkdownBytesSchema, markdownCodec } from "./codec.js";
+import { a as MarkdownInputTooLargeError, d as MarkdownUnsupportedDocumentKindError, f as MarkdownWriteError, i as MarkdownDiagnosticSink, l as MarkdownParseError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, p as NOOP_MARKDOWN_DIAGNOSTIC_SINK, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnbalancedConstructMarkersError } from "./diagnostics-BWK1iGy7.js";
+import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } from "./codec.js";
 import { n as MarkdownImageResolver, r as MarkdownResolvedImageBytes, t as MarkdownImageResolveContext } from "./image-Cm3hT5PS.js";
 import { MarkdownBulletListMarker, MarkdownCodeFenceChar, MarkdownEmphasisMarker, MarkdownHeadingStyle, MarkdownLineEnding, MarkdownOrderedListDelimiter, MarkdownThematicBreakChar, ReadMarkdownOptions, WriteMarkdownOptions, WriteMarkdownStyleOptions } from "./options/options.js";
-import { ReadMarkdownResult, readMarkdown } from "./read.js";
-import { writeMarkdown } from "./write.js";
+import { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdownContent } from "./read.js";
+import { writeMarkdown, writeMarkdownContent } from "./write.js";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.js";
 import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "./diagnostics/diagnostics.js";
 import { createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.js";
 import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
-import { readMarkdown } from "./read.js";
-import { writeMarkdown } from "./write.js";
-import { MarkdownBytesSchema, markdownCodec } from "./codec.js";
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, MarkdownBytesSchema, MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };
+import { readMarkdown, readMarkdownContent } from "./read.js";
+import { writeMarkdown, writeMarkdownContent } from "./write.js";
+import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } from "./codec.js";
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, MarkdownBytesSchema, MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/lower/front-matter.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/lower/front-matter.d.ts
 interface FrontMatterResult {

package/dist/lower/front-matter.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/lower/front-matter.d.ts
 interface FrontMatterResult {

package/dist/lower/inline.d.cts

@@ -1,5 +1,5 @@
 import { v as MarkdownInlineNode } from "../ast-8XCbjRQT.cjs";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
 import { ContentRun } from "document-schema.js";
 //#region src/lower/inline.d.ts
 interface InlineLowerContext {

package/dist/lower/inline.d.ts

@@ -1,5 +1,5 @@
 import { v as MarkdownInlineNode } from "../ast-8XCbjRQT.js";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
 import { ContentRun } from "document-schema.js";
 //#region src/lower/inline.d.ts
 interface InlineLowerContext {

package/dist/options/options.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
 import { n as MarkdownImageResolver } from "../image-C4KYmz_L.cjs";
 import { Margins, PageSize } from "document-schema.js";
 //#region src/options/options.d.ts

package/dist/options/options.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
 import { n as MarkdownImageResolver } from "../image-Cm3hT5PS.js";
 import { Margins, PageSize } from "document-schema.js";
 //#region src/options/options.d.ts

package/dist/read.cjs

@@ -1,7 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_lower_lower = require("./lower/lower.cjs");
+let document_schema_js = require("document-schema.js");
 //#region src/read.ts
 function readMarkdown(text, options = {}) {
+	const { document, diagnostics } = readMarkdownContent(text, options);
+	return {
+		documentPackage: (0, document_schema_js.assemblePackage)(document),
+		diagnostics
+	};
+}
+function readMarkdownContent(text, options = {}) {
 	options.signal?.throwIfAborted();
 	const diagnostics = [];
 	const callerSink = options.sink;
@@ -18,3 +26,4 @@ function readMarkdown(text, options = {}) {
 }
 //#endregion
 exports.readMarkdown = readMarkdown;
+exports.readMarkdownContent = readMarkdownContent;

package/dist/read.d.cts

@@ -1,11 +1,16 @@
-import { t as MarkdownDiagnostic } from "./diagnostics-BuO5-SW1.cjs";
+import { t as MarkdownDiagnostic } from "./diagnostics-BWK1iGy7.cjs";
 import { ReadMarkdownOptions } from "./options/options.cjs";
-import { ContentDocument } from "document-schema.js";
+import { ContentDocument, DocumentPackage } from "document-schema.js";
 //#region src/read.d.ts
 interface ReadMarkdownResult {
+  readonly documentPackage: DocumentPackage;
+  readonly diagnostics: readonly MarkdownDiagnostic[];
+}
+interface ReadMarkdownContentResult {
   readonly document: ContentDocument;
   readonly diagnostics: readonly MarkdownDiagnostic[];
 }
 declare function readMarkdown(text: string, options?: ReadMarkdownOptions): ReadMarkdownResult;
+declare function readMarkdownContent(text: string, options?: ReadMarkdownOptions): ReadMarkdownContentResult;
 //#endregion
-export { ReadMarkdownResult, readMarkdown };
+export { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdownContent };

package/dist/read.d.ts

@@ -1,11 +1,16 @@
-import { t as MarkdownDiagnostic } from "./diagnostics-BuO5-SW1.js";
+import { t as MarkdownDiagnostic } from "./diagnostics-BWK1iGy7.js";
 import { ReadMarkdownOptions } from "./options/options.js";
-import { ContentDocument } from "document-schema.js";
+import { ContentDocument, DocumentPackage } from "document-schema.js";
 //#region src/read.d.ts
 interface ReadMarkdownResult {
+  readonly documentPackage: DocumentPackage;
+  readonly diagnostics: readonly MarkdownDiagnostic[];
+}
+interface ReadMarkdownContentResult {
   readonly document: ContentDocument;
   readonly diagnostics: readonly MarkdownDiagnostic[];
 }
 declare function readMarkdown(text: string, options?: ReadMarkdownOptions): ReadMarkdownResult;
+declare function readMarkdownContent(text: string, options?: ReadMarkdownOptions): ReadMarkdownContentResult;
 //#endregion
-export { ReadMarkdownResult, readMarkdown };
+export { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdownContent };

package/dist/read.js

@@ -1,6 +1,14 @@
 import { lowerMarkdown } from "./lower/lower.js";
+import { assemblePackage } from "document-schema.js";
 //#region src/read.ts
 function readMarkdown(text, options = {}) {
+	const { document, diagnostics } = readMarkdownContent(text, options);
+	return {
+		documentPackage: assemblePackage(document),
+		diagnostics
+	};
+}
+function readMarkdownContent(text, options = {}) {
 	options.signal?.throwIfAborted();
 	const diagnostics = [];
 	const callerSink = options.sink;
@@ -16,4 +24,4 @@ function readMarkdown(text, options = {}) {
 	};
 }
 //#endregion
-export { readMarkdown };
+export { readMarkdown, readMarkdownContent };

package/dist/write.cjs

@@ -1,9 +1,41 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_diagnostics_diagnostics = require("./diagnostics/diagnostics.cjs");
 const require_emit_emit = require("./emit/emit.cjs");
+let document_schema_js = require("document-schema.js");
 //#region src/write.ts
-function writeMarkdown(document, options = {}) {
+function reportDroppedPackageTables(documentPackage, sink) {
+	const tables = [
+		["definitions", documentPackage.definitions !== void 0 && Object.keys(documentPackage.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],
+		["pages", documentPackage.pages !== void 0 && documentPackage.pages.length > 0]
+	];
+	for (const [name, present] of tables) {
+		if (!present) continue;
+		sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.PACKAGE_TABLE_DROPPED,
+			severity: "info",
+			message: `the package's own "${name}" table has no markdown representation; flattenPackage's envelope carries forward only metadata and symbolTable, so "${name}" is dropped rather than rendered`
+		});
+	}
+}
+function writeMarkdown(documentPackage, options = {}) {
+	options.signal?.throwIfAborted();
+	if (documentPackage.kind !== "wordprocessing") throw new require_diagnostics_diagnostics.MarkdownUnsupportedDocumentKindError(documentPackage.kind);
+	reportDroppedPackageTables(documentPackage, options.sink ?? require_diagnostics_diagnostics.NOOP_MARKDOWN_DIAGNOSTIC_SINK);
+	let flattened;
+	try {
+		flattened = (0, document_schema_js.flattenPackage)(documentPackage);
+	} catch (error) {
+		throw new require_diagnostics_diagnostics.MarkdownPackageFlattenError(error);
+	}
+	return writeMarkdownContent(flattened, options);
+}
+function writeMarkdownContent(document, options = {}) {
 	options.signal?.throwIfAborted();
 	return require_emit_emit.emitMarkdown(document, options);
 }
 //#endregion
 exports.writeMarkdown = writeMarkdown;
+exports.writeMarkdownContent = writeMarkdownContent;

package/dist/write.d.cts

@@ -1,6 +1,7 @@
 import { WriteMarkdownOptions } from "./options/options.cjs";
-import { ContentDocument } from "document-schema.js";
+import { ContentDocument, DocumentPackage } from "document-schema.js";
 //#region src/write.d.ts
-declare function writeMarkdown(document: ContentDocument, options?: WriteMarkdownOptions): string;
+declare function writeMarkdown(documentPackage: DocumentPackage, options?: WriteMarkdownOptions): string;
+declare function writeMarkdownContent(document: ContentDocument, options?: WriteMarkdownOptions): string;
 //#endregion
-export { writeMarkdown };
+export { writeMarkdown, writeMarkdownContent };

package/dist/write.d.ts

@@ -1,6 +1,7 @@
 import { WriteMarkdownOptions } from "./options/options.js";
-import { ContentDocument } from "document-schema.js";
+import { ContentDocument, DocumentPackage } from "document-schema.js";
 //#region src/write.d.ts
-declare function writeMarkdown(document: ContentDocument, options?: WriteMarkdownOptions): string;
+declare function writeMarkdown(documentPackage: DocumentPackage, options?: WriteMarkdownOptions): string;
+declare function writeMarkdownContent(document: ContentDocument, options?: WriteMarkdownOptions): string;
 //#endregion
-export { writeMarkdown };
+export { writeMarkdown, writeMarkdownContent };

package/dist/write.js

@@ -1,8 +1,39 @@
+import { MarkdownDiagnosticCodes, MarkdownPackageFlattenError, MarkdownUnsupportedDocumentKindError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "./diagnostics/diagnostics.js";
 import { emitMarkdown } from "./emit/emit.js";
+import { flattenPackage } from "document-schema.js";
 //#region src/write.ts
-function writeMarkdown(document, options = {}) {
+function reportDroppedPackageTables(documentPackage, sink) {
+	const tables = [
+		["definitions", documentPackage.definitions !== void 0 && Object.keys(documentPackage.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],
+		["pages", documentPackage.pages !== void 0 && documentPackage.pages.length > 0]
+	];
+	for (const [name, present] of tables) {
+		if (!present) continue;
+		sink({
+			code: MarkdownDiagnosticCodes.PACKAGE_TABLE_DROPPED,
+			severity: "info",
+			message: `the package's own "${name}" table has no markdown representation; flattenPackage's envelope carries forward only metadata and symbolTable, so "${name}" is dropped rather than rendered`
+		});
+	}
+}
+function writeMarkdown(documentPackage, options = {}) {
+	options.signal?.throwIfAborted();
+	if (documentPackage.kind !== "wordprocessing") throw new MarkdownUnsupportedDocumentKindError(documentPackage.kind);
+	reportDroppedPackageTables(documentPackage, options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK);
+	let flattened;
+	try {
+		flattened = flattenPackage(documentPackage);
+	} catch (error) {
+		throw new MarkdownPackageFlattenError(error);
+	}
+	return writeMarkdownContent(flattened, options);
+}
+function writeMarkdownContent(document, options = {}) {
 	options.signal?.throwIfAborted();
 	return emitMarkdown(document, options);
 }
 //#endregion
-export { writeMarkdown };
+export { writeMarkdown, writeMarkdownContent };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "markdown-codec",
-  "version": "3.1.1",
-  "description": "Hand-written CommonMark+GFM <-> ContentDocument codec, built on document-schema.js",
+  "version": "4.0.0",
+  "description": "Hand-written CommonMark+GFM <-> DocumentPackage codec, built on document-schema.js",
   "type": "module",
   "repository": {
     "type": "git",