npm - @illusions-lab/mdi - Versions diffs - 2.0.7 → 2.0.9 - Mend

@illusions-lab/mdi 2.0.7 → 2.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -1,3 +1,68 @@
+import { EpubExportOptions, EpubCover } from '@illusions-lab/mdi-to-epub';
+export { EpubCover, EpubExportOptions } from '@illusions-lab/mdi-to-epub';
+import { ExportProfile } from '@illusions-lab/mdi-export-profile';
+export { ExportProfile } from '@illusions-lab/mdi-export-profile';
+import { Root } from 'mdast';
+/**
+ * Options for a configured EPUB export.  The profile controls metadata,
+ * chapter splitting and typography; `cover` supplies the actual image data.
+ */
+type MdiEpubExportOptions = EpubExportOptions & {
+    /** Ergonomic aliases merged into `profile.metadata`. */
+    title?: string;
+    author?: string;
+    publisher?: string;
+    identifier?: string;
+    language?: string;
+    date?: string;
+    /** Ergonomic aliases merged into `profile.typesetting` and `profile.epub`. */
+    verticalWriting?: boolean;
+    fontFamily?: string;
+    /** Body type size in typographic points. */
+    fontSize?: number;
+    /** Baseline multiplier, for example 1.5 for one-and-a-half spacing. */
+    lineSpacing?: number;
+    textIndent?: number;
+    /** Use an ideographic-space-compatible first-line indent. */
+    fullwidthSpaceIndent?: boolean;
+    /** EPUB has no fixed pages; use `typographic` when overriding type metrics. */
+    gridMode?: "strict" | "typographic";
+    chapterSplitLevel?: "h1" | "h2" | "h3" | "none";
+    /** Shorthand for `cover: { data: coverImage, mediaType: coverMediaType }`. */
+    coverImage?: Uint8Array;
+    coverMediaType?: EpubCover["mediaType"];
+};
+/**
+ * Profile for a configured DOCX export, including page geometry and numbering.
+ */
+type MdiDocxExportProfile = ExportProfile & {
+    title?: string;
+    author?: string;
+    publisher?: string;
+    identifier?: string;
+    language?: string;
+    date?: string;
+    verticalWriting?: boolean;
+    fontFamily?: string;
+    /** Point size; requires a publication adapter that supports it. */
+    fontSize?: number;
+    /** Line-height multiplier; requires a publication adapter that supports it. */
+    lineSpacing?: number;
+    textIndent?: number;
+    pageSize?: NonNullable<ExportProfile["pagination"]>["pageSize"];
+    landscape?: boolean;
+    /** `strict` enforces the character/line grid; `typographic` prioritizes explicit type metrics. */
+    gridMode?: "strict" | "typographic";
+    charactersPerLine?: number;
+    linesPerPage?: number;
+    margins?: NonNullable<NonNullable<ExportProfile["pagination"]>["margins"]>;
+    /** Emit literal ideographic spaces for first-line indentation in DOCX. */
+    fullwidthSpaceIndent?: boolean;
+    showPageNumbers?: boolean;
+    pageNumberPosition?: NonNullable<NonNullable<ExportProfile["pagination"]>["pageNumbers"]>["position"];
+    pageNumberFormat?: NonNullable<NonNullable<ExportProfile["pagination"]>["pageNumbers"]>["format"];
+};
 /** MDI specification version implemented by this binding. */
 declare const MDI_SPEC_VERSION: "2.0";
 /** Version of the complete Rust-owned document IR. */
@@ -48,6 +113,27 @@ interface MdiDocument {
     frontmatter?: MdiFrontmatter;
     children: MdiNode[];
 }
+/** A source-backed heading available to host navigation and chapter UIs. */
+interface MdiHeading {
+    depth: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Plain, source-order text. Inline MDI is represented by `node` as well. */
+    text: string;
+    span?: MdiSourceSpan;
+    /** The complete Rust-owned heading node, including inline children. */
+    node: MdiNode;
+}
+/** HTML output controls that do not alter MDI semantics. */
+interface MdiHtmlRenderOptions {
+    /** Return the semantic contents of `<body>` rather than a standalone page. */
+    bodyOnly?: boolean;
+}
+/** A parsed document retained with renderer output for UI diagnostics. */
+interface MdiRenderResult<T> {
+    output: T;
+    document: MdiDocument;
+    diagnostics: MdiDiagnostic[];
+    headings: MdiHeading[];
+}
 /**
  * Versioned result returned by the Rust parser.
  *
@@ -68,20 +154,79 @@ type MdiSyntaxDocument = MdiDocument;
  * language-neutral document IR. JavaScript performs no grammar work.
  */
 declare function parse(source: string): MdiSyntaxParseResult;
-/** Render complete `.mdi` source to standalone HTML in Rust. */
-declare function renderHtml(source: string): string;
+/** Render complete `.mdi` source to standalone semantic HTML in Rust. */
+declare function renderHtml(source: string, options?: MdiHtmlRenderOptions): string;
+/**
+ * Render HTML while retaining the Rust parser result that made the semantic
+ * decisions. Use this in editors: warnings and source spans remain available
+ * instead of being silently discarded, and `headings` can drive navigation or
+ * chapter controls without scraping generated HTML.
+ *
+ * The low-level Rust ABI currently accepts source for rendering, rather than a
+ * serializable IR handle. This helper therefore validates with the same Rust
+ * parser immediately before rendering and returns that exact parse result.
+ */
+declare function renderHtmlWithDiagnostics(source: string, options?: MdiHtmlRenderOptions): MdiRenderResult<string>;
+/**
+ * Parse once for a host workflow that needs stable diagnostics and source
+ * spans before selecting one of the renderer APIs. The returned document is
+ * Rust-owned IR and must not be mutated as an input to a renderer.
+ */
+declare function prepareRender(source: string): MdiSyntaxParseResult;
 /** Build a baseline EPUB 3 archive from complete source in Rust. */
 declare function renderEpub(source: string): Uint8Array;
+/**
+ * Build a profile-configured EPUB 3 archive. This overload is asynchronous
+ * because archive generation is performed by the Node.js publication adapter.
+ */
+declare function renderEpub(source: string, options: MdiEpubExportOptions): Promise<Uint8Array>;
+/** Build a baseline Rust EPUB while retaining diagnostics for an export UI. */
+declare function renderEpubWithDiagnostics(source: string): MdiRenderResult<Uint8Array>;
+declare function renderEpubWithDiagnostics(source: string, options: MdiEpubExportOptions): Promise<MdiRenderResult<Uint8Array>>;
 /** Build a baseline DOCX archive from complete source in Rust. */
 declare function renderDocx(source: string): Uint8Array;
+/**
+ * Build a profile-configured DOCX archive. This overload is asynchronous
+ * because archive generation is performed by the Node.js publication adapter.
+ */
+declare function renderDocx(source: string, profile: MdiDocxExportProfile): Promise<Uint8Array>;
+/** Build a baseline Rust DOCX while retaining diagnostics for an export UI. */
+declare function renderDocxWithDiagnostics(source: string): MdiRenderResult<Uint8Array>;
+declare function renderDocxWithDiagnostics(source: string, profile: MdiDocxExportProfile): Promise<MdiRenderResult<Uint8Array>>;
+/**
+ * Build a configured EPUB using the same profile schema as the dedicated
+ * publication adapters.  Unlike the one-argument {@link renderEpub}, this
+ * returns a Promise and supports cover art, metadata, chapters and vertical
+ * writing.
+ */
+declare function renderEpubWithProfile(source: string, options?: MdiEpubExportOptions): Promise<Uint8Array>;
+/**
+ * Build a configured DOCX using the shared print profile.  The profile
+ * supports metadata, writing mode, paper size, margins and page numbers.
+ */
+declare function renderDocxWithProfile(source: string, profile?: MdiDocxExportProfile): Promise<Uint8Array>;
+/**
+ * Map the Rust-owned IR to mdast for the publication adapters. This is a
+ * structural conversion only: all grammar decisions have already been made
+ * by {@link parse}, so it never reparses MDI source in JavaScript.
+ */
+/**
+ * Convert a Rust-owned MDI document IR into mdast for publication adapters.
+ * This performs no parsing and preserves the adapter node conventions.
+ */
+declare function toPublicationMdast(document: MdiDocument): Root;
 /** Parse and normalize complete `.mdi` source with Rust's serializer. */
 declare function serializeMdi(source: string): string;
 /** Render complete `.mdi` source to deterministic plain text in Rust. */
 declare function renderText(source: string): string;
+/** Render plain text without discarding Rust diagnostics and source spans. */
+declare function renderTextWithDiagnostics(source: string): MdiRenderResult<string>;
 type MdiTextFormat = "txt" | "txt-ruby" | "narou" | "kakuyomu" | "aozora";
 /** Render a named publication-text convention through Rust. */
 declare function renderTextFormat(source: string, format: MdiTextFormat, indentPrefix?: string): string;
+/** Render a named text format without discarding Rust diagnostics and spans. */
+declare function renderTextFormatWithDiagnostics(source: string, format: MdiTextFormat, indentPrefix?: string): MdiRenderResult<string>;
 /** @deprecated Use {@link parse}; it now parses the complete document. */
 declare const parseMdiSyntax: typeof parse;
-export { MDI_IR_VERSION, MDI_SPEC_VERSION, type MdiDiagnostic, type MdiDocument, type MdiFrontmatter, type MdiNode, type MdiParserCapabilities, type MdiRubyReading, type MdiSourceSpan, type MdiSyntaxDocument, type MdiSyntaxParseResult, type MdiTextFormat, parse, parseMdiSyntax, renderDocx, renderEpub, renderHtml, renderText, renderTextFormat, serializeMdi };
+export { MDI_IR_VERSION, MDI_SPEC_VERSION, type MdiDiagnostic, type MdiDocument, type MdiDocxExportProfile, type MdiEpubExportOptions, type MdiFrontmatter, type MdiHeading, type MdiHtmlRenderOptions, type MdiNode, type MdiParserCapabilities, type MdiRenderResult, type MdiRubyReading, type MdiSourceSpan, type MdiSyntaxDocument, type MdiSyntaxParseResult, type MdiTextFormat, parse, parseMdiSyntax, prepareRender, renderDocx, renderDocxWithDiagnostics, renderDocxWithProfile, renderEpub, renderEpubWithDiagnostics, renderEpubWithProfile, renderHtml, renderHtmlWithDiagnostics, renderText, renderTextFormat, renderTextFormatWithDiagnostics, renderTextWithDiagnostics, serializeMdi, toPublicationMdast };

package/dist/index.js CHANGED Viewed

@@ -1,59 +1,42 @@
-// src/index.ts
 import {
-  parseMdiSyntaxJson,
-  renderHtml as renderHtmlFromRust,
-  renderEpub as renderEpubFromRust,
-  renderDocx as renderDocxFromRust,
-  renderText as renderTextFromRust,
-  renderTextFormat as renderTextFormatFromRust,
-  serializeMdi as serializeMdiFromRust
-} from "@illusions-lab/mdi-core";
-var MDI_SPEC_VERSION = "2.0";
-var MDI_IR_VERSION = "1.0";
-function parse(source) {
-  if (typeof source !== "string") throw new TypeError("source must be a string");
-  const result = JSON.parse(parseMdiSyntaxJson(source));
-  if (result.irVersion !== MDI_IR_VERSION) {
-    throw new Error(`Unsupported MDI IR version: ${String(result.irVersion)}`);
-  }
-  return result;
-}
-function renderHtml(source) {
-  if (typeof source !== "string") throw new TypeError("source must be a string");
-  return renderHtmlFromRust(source);
-}
-function renderEpub(source) {
-  if (typeof source !== "string") throw new TypeError("source must be a string");
-  return renderEpubFromRust(source);
-}
-function renderDocx(source) {
-  if (typeof source !== "string") throw new TypeError("source must be a string");
-  return renderDocxFromRust(source);
-}
-function serializeMdi(source) {
-  if (typeof source !== "string") throw new TypeError("source must be a string");
-  return serializeMdiFromRust(source);
-}
-function renderText(source) {
-  if (typeof source !== "string") throw new TypeError("source must be a string");
-  return renderTextFromRust(source);
-}
-function renderTextFormat(source, format, indentPrefix = "") {
-  if (typeof source !== "string" || typeof indentPrefix !== "string") {
-    throw new TypeError("source and indentPrefix must be strings");
-  }
-  return renderTextFormatFromRust(source, format, indentPrefix);
-}
-var parseMdiSyntax = parse;
+  MDI_IR_VERSION,
+  MDI_SPEC_VERSION,
+  parse,
+  parseMdiSyntax,
+  prepareRender,
+  renderDocx,
+  renderDocxWithDiagnostics,
+  renderDocxWithProfile,
+  renderEpub,
+  renderEpubWithDiagnostics,
+  renderEpubWithProfile,
+  renderHtml,
+  renderHtmlWithDiagnostics,
+  renderText,
+  renderTextFormat,
+  renderTextFormatWithDiagnostics,
+  renderTextWithDiagnostics,
+  serializeMdi,
+  toPublicationMdast
+} from "./chunk-FA5R33XH.js";
 export {
   MDI_IR_VERSION,
   MDI_SPEC_VERSION,
   parse,
   parseMdiSyntax,
+  prepareRender,
   renderDocx,
+  renderDocxWithDiagnostics,
+  renderDocxWithProfile,
   renderEpub,
+  renderEpubWithDiagnostics,
+  renderEpubWithProfile,
   renderHtml,
+  renderHtmlWithDiagnostics,
   renderText,
   renderTextFormat,
-  serializeMdi
+  renderTextFormatWithDiagnostics,
+  renderTextWithDiagnostics,
+  serializeMdi,
+  toPublicationMdast
 };

package/dist/node.cjs ADDED Viewed

@@ -0,0 +1,160 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+// src/node.ts
+var node_exports = {};
+__export(node_exports, {
+  preparePdfExport: () => preparePdfExport,
+  preparePdfExportWithDiagnostics: () => preparePdfExportWithDiagnostics,
+  renderPdfWithChromium: () => renderPdfWithChromium,
+  renderPdfWithChromiumWithDiagnostics: () => renderPdfWithChromiumWithDiagnostics
+});
+module.exports = __toCommonJS(node_exports);
+// src/index.ts
+var import_mdi_core = require("@illusions-lab/mdi-core");
+var import_mdi_export_profile = require("@illusions-lab/mdi-export-profile");
+var import_yaml = require("yaml");
+var MDI_IR_VERSION = "1.0";
+function parse(source) {
+  if (typeof source !== "string") throw new TypeError("source must be a string");
+  const result = JSON.parse((0, import_mdi_core.parseMdiSyntaxJson)(source));
+  if (result.irVersion !== MDI_IR_VERSION) {
+    throw new Error(`Unsupported MDI IR version: ${String(result.irVersion)}`);
+  }
+  return result;
+}
+function renderHtml(source, options) {
+  assertSource(source);
+  assertHtmlOptions(options);
+  const html = (0, import_mdi_core.renderHtml)(source);
+  return options?.bodyOnly ? htmlBody(html) : html;
+}
+function assertSource(source) {
+  if (typeof source !== "string") throw new TypeError("source must be a string");
+}
+function assertHtmlOptions(options) {
+  if (options === void 0) return;
+  assertPlainObject(options, "options");
+  if (options.bodyOnly !== void 0 && typeof options.bodyOnly !== "boolean") {
+    throw new TypeError("options.bodyOnly must be a boolean");
+  }
+}
+function htmlBody(html) {
+  const match = /<body(?:\s[^>]*)?>([\s\S]*)<\/body>/i.exec(html);
+  if (!match) throw new Error("Rust HTML renderer returned a document without a body");
+  return match[1];
+}
+function assertPlainObject(value, label) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new TypeError(`${label} must be an object`);
+  }
+}
+// src/node.ts
+var import_mdi_export_profile2 = require("@illusions-lab/mdi-export-profile");
+function preparePdfExport(source, profile) {
+  if (typeof source !== "string") throw new TypeError("source must be a string");
+  if (profile !== void 0) (0, import_mdi_export_profile2.requireLayoutSystem)(profile);
+  const writingMode = parse(source).document.frontmatter?.entries.find(
+    (entry) => entry.key === "writing-mode" || entry.key === "writingMode"
+  )?.value;
+  return {
+    html: renderHtml(source),
+    profile,
+    sourceWritingMode: writingMode === "vertical" || writingMode === "horizontal" ? writingMode : void 0
+  };
+}
+function preparePdfExportWithDiagnostics(source, profile) {
+  if (typeof source !== "string") throw new TypeError("source must be a string");
+  if (profile !== void 0) (0, import_mdi_export_profile2.requireLayoutSystem)(profile);
+  const parsed = parse(source);
+  const writingMode = parsed.document.frontmatter?.entries.find(
+    (entry) => entry.key === "writing-mode" || entry.key === "writingMode"
+  )?.value;
+  return {
+    output: {
+      html: renderHtml(source),
+      profile,
+      sourceWritingMode: writingMode === "vertical" || writingMode === "horizontal" ? writingMode : void 0
+    },
+    document: parsed.document,
+    diagnostics: parsed.diagnostics,
+    headings: headingsFromDocument(parsed.document)
+  };
+}
+async function renderPdfWithChromium(source, profile, adapter) {
+  const request = preparePdfExport(source, profile);
+  const chromiumAdapter = adapter ?? await loadPlaywrightPdfAdapter();
+  return chromiumAdapter.renderHtmlToPdf(
+    request.html,
+    request.profile,
+    request.sourceWritingMode
+  );
+}
+async function renderPdfWithChromiumWithDiagnostics(source, profile, adapter) {
+  const prepared = preparePdfExportWithDiagnostics(source, profile);
+  const chromiumAdapter = adapter ?? await loadPlaywrightPdfAdapter();
+  return {
+    ...prepared,
+    output: await chromiumAdapter.renderHtmlToPdf(
+      prepared.output.html,
+      prepared.output.profile,
+      prepared.output.sourceWritingMode
+    )
+  };
+}
+function headingsFromDocument(document) {
+  const headings = [];
+  const visit = (nodes) => {
+    for (const node of nodes) {
+      if (node.type === "heading" && isHeadingDepth(node.depth)) {
+        headings.push({ depth: node.depth, text: plainText(node), span: node.span, node });
+      }
+      if (node.children) visit(node.children);
+    }
+  };
+  visit(document.children);
+  return headings;
+}
+function isHeadingDepth(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 6;
+}
+function plainText(node) {
+  if (node.type === "ruby" && typeof node.base === "string") return node.base;
+  return (typeof node.value === "string" ? node.value : "") + (node.children?.map(plainText).join("") ?? "");
+}
+async function loadPlaywrightPdfAdapter() {
+  const packageName = "@illusions-lab/mdi-to-pdf";
+  try {
+    return await import(packageName);
+  } catch (error) {
+    throw new Error(
+      "PDF export needs @illusions-lab/mdi-to-pdf, or pass an Electron-compatible adapter to renderPdfWithChromium().",
+      { cause: error }
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  preparePdfExport,
+  preparePdfExportWithDiagnostics,
+  renderPdfWithChromium,
+  renderPdfWithChromiumWithDiagnostics
+});

package/dist/node.d.cts ADDED Viewed

@@ -0,0 +1,41 @@
+import { MdiRenderResult } from './index.cjs';
+import { ExportProfile } from '@illusions-lab/mdi-export-profile';
+export { ExportProfile } from '@illusions-lab/mdi-export-profile';
+import '@illusions-lab/mdi-to-epub';
+import 'mdast';
+/** A Chromium-capable adapter which turns complete HTML into a PDF. */
+interface MdiPdfChromiumAdapter {
+    renderHtmlToPdf(html: string, profile?: ExportProfile, sourceWritingMode?: unknown): Promise<Uint8Array>;
+}
+/**
+ * The explicit hand-off from Rust MDI rendering to a browser print engine.
+ * Page geometry, fonts, and pagination are browser-layout concerns, so the
+ * profile is kept separate from the MDI document IR.
+ */
+interface MdiPdfExportRequest {
+    html: string;
+    profile?: ExportProfile;
+    sourceWritingMode?: "vertical" | "horizontal";
+}
+/**
+ * Render MDI to Rust-owned HTML and prepare a Chromium PDF request.
+ *
+ * This browser-safe helper does not load Playwright or launch Chromium.
+ * Electron callers may print the returned HTML with their own BrowserWindow.
+ */
+declare function preparePdfExport(source: string, profile?: ExportProfile): MdiPdfExportRequest;
+/**
+ * Prepare a PDF export without losing the Rust diagnostics, source spans, or
+ * source-order headings that a host UI needs to present before printing.
+ */
+declare function preparePdfExportWithDiagnostics(source: string, profile?: ExportProfile): MdiRenderResult<MdiPdfExportRequest>;
+/**
+ * Print MDI through Chromium. The default Playwright adapter is loaded only
+ * by this Node-only entry point; Electron can supply its own adapter.
+ */
+declare function renderPdfWithChromium(source: string, profile?: ExportProfile, adapter?: MdiPdfChromiumAdapter): Promise<Uint8Array>;
+/** Print through Chromium while retaining the Rust parse result for host UIs. */
+declare function renderPdfWithChromiumWithDiagnostics(source: string, profile?: ExportProfile, adapter?: MdiPdfChromiumAdapter): Promise<MdiRenderResult<Uint8Array>>;
+export { type MdiPdfChromiumAdapter, type MdiPdfExportRequest, preparePdfExport, preparePdfExportWithDiagnostics, renderPdfWithChromium, renderPdfWithChromiumWithDiagnostics };

package/dist/node.d.ts ADDED Viewed

@@ -0,0 +1,41 @@
+import { MdiRenderResult } from './index.js';
+import { ExportProfile } from '@illusions-lab/mdi-export-profile';
+export { ExportProfile } from '@illusions-lab/mdi-export-profile';
+import '@illusions-lab/mdi-to-epub';
+import 'mdast';
+/** A Chromium-capable adapter which turns complete HTML into a PDF. */
+interface MdiPdfChromiumAdapter {
+    renderHtmlToPdf(html: string, profile?: ExportProfile, sourceWritingMode?: unknown): Promise<Uint8Array>;
+}
+/**
+ * The explicit hand-off from Rust MDI rendering to a browser print engine.
+ * Page geometry, fonts, and pagination are browser-layout concerns, so the
+ * profile is kept separate from the MDI document IR.
+ */
+interface MdiPdfExportRequest {
+    html: string;
+    profile?: ExportProfile;
+    sourceWritingMode?: "vertical" | "horizontal";
+}
+/**
+ * Render MDI to Rust-owned HTML and prepare a Chromium PDF request.
+ *
+ * This browser-safe helper does not load Playwright or launch Chromium.
+ * Electron callers may print the returned HTML with their own BrowserWindow.
+ */
+declare function preparePdfExport(source: string, profile?: ExportProfile): MdiPdfExportRequest;
+/**
+ * Prepare a PDF export without losing the Rust diagnostics, source spans, or
+ * source-order headings that a host UI needs to present before printing.
+ */
+declare function preparePdfExportWithDiagnostics(source: string, profile?: ExportProfile): MdiRenderResult<MdiPdfExportRequest>;
+/**
+ * Print MDI through Chromium. The default Playwright adapter is loaded only
+ * by this Node-only entry point; Electron can supply its own adapter.
+ */
+declare function renderPdfWithChromium(source: string, profile?: ExportProfile, adapter?: MdiPdfChromiumAdapter): Promise<Uint8Array>;
+/** Print through Chromium while retaining the Rust parse result for host UIs. */
+declare function renderPdfWithChromiumWithDiagnostics(source: string, profile?: ExportProfile, adapter?: MdiPdfChromiumAdapter): Promise<MdiRenderResult<Uint8Array>>;
+export { type MdiPdfChromiumAdapter, type MdiPdfExportRequest, preparePdfExport, preparePdfExportWithDiagnostics, renderPdfWithChromium, renderPdfWithChromiumWithDiagnostics };

package/dist/node.js ADDED Viewed

@@ -0,0 +1,97 @@
+import {
+  parse,
+  renderHtml
+} from "./chunk-FA5R33XH.js";
+// src/node.ts
+import {
+  requireLayoutSystem
+} from "@illusions-lab/mdi-export-profile";
+function preparePdfExport(source, profile) {
+  if (typeof source !== "string") throw new TypeError("source must be a string");
+  if (profile !== void 0) requireLayoutSystem(profile);
+  const writingMode = parse(source).document.frontmatter?.entries.find(
+    (entry) => entry.key === "writing-mode" || entry.key === "writingMode"
+  )?.value;
+  return {
+    html: renderHtml(source),
+    profile,
+    sourceWritingMode: writingMode === "vertical" || writingMode === "horizontal" ? writingMode : void 0
+  };
+}
+function preparePdfExportWithDiagnostics(source, profile) {
+  if (typeof source !== "string") throw new TypeError("source must be a string");
+  if (profile !== void 0) requireLayoutSystem(profile);
+  const parsed = parse(source);
+  const writingMode = parsed.document.frontmatter?.entries.find(
+    (entry) => entry.key === "writing-mode" || entry.key === "writingMode"
+  )?.value;
+  return {
+    output: {
+      html: renderHtml(source),
+      profile,
+      sourceWritingMode: writingMode === "vertical" || writingMode === "horizontal" ? writingMode : void 0
+    },
+    document: parsed.document,
+    diagnostics: parsed.diagnostics,
+    headings: headingsFromDocument(parsed.document)
+  };
+}
+async function renderPdfWithChromium(source, profile, adapter) {
+  const request = preparePdfExport(source, profile);
+  const chromiumAdapter = adapter ?? await loadPlaywrightPdfAdapter();
+  return chromiumAdapter.renderHtmlToPdf(
+    request.html,
+    request.profile,
+    request.sourceWritingMode
+  );
+}
+async function renderPdfWithChromiumWithDiagnostics(source, profile, adapter) {
+  const prepared = preparePdfExportWithDiagnostics(source, profile);
+  const chromiumAdapter = adapter ?? await loadPlaywrightPdfAdapter();
+  return {
+    ...prepared,
+    output: await chromiumAdapter.renderHtmlToPdf(
+      prepared.output.html,
+      prepared.output.profile,
+      prepared.output.sourceWritingMode
+    )
+  };
+}
+function headingsFromDocument(document) {
+  const headings = [];
+  const visit = (nodes) => {
+    for (const node of nodes) {
+      if (node.type === "heading" && isHeadingDepth(node.depth)) {
+        headings.push({ depth: node.depth, text: plainText(node), span: node.span, node });
+      }
+      if (node.children) visit(node.children);
+    }
+  };
+  visit(document.children);
+  return headings;
+}
+function isHeadingDepth(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 6;
+}
+function plainText(node) {
+  if (node.type === "ruby" && typeof node.base === "string") return node.base;
+  return (typeof node.value === "string" ? node.value : "") + (node.children?.map(plainText).join("") ?? "");
+}
+async function loadPlaywrightPdfAdapter() {
+  const packageName = "@illusions-lab/mdi-to-pdf";
+  try {
+    return await import(packageName);
+  } catch (error) {
+    throw new Error(
+      "PDF export needs @illusions-lab/mdi-to-pdf, or pass an Electron-compatible adapter to renderPdfWithChromium().",
+      { cause: error }
+    );
+  }
+}
+export {
+  preparePdfExport,
+  preparePdfExportWithDiagnostics,
+  renderPdfWithChromium,
+  renderPdfWithChromiumWithDiagnostics
+};