@illusions-lab/mdi 2.0.11 → 2.0.13

package/README.md

@@ -62,11 +62,12 @@ unsupported version.
 
 ## Rendering
 
-Rendering starts from the same Rust IR. Canonical MDI, plain text, HTML, and
-the one-argument baseline EPUB/DOCX renderers execute in Rust and are exposed
-through this package. PDF uses Rust HTML as its input to a host layout adapter such as
-`@illusions-lab/mdi-to-pdf`; the adapter may control Chromium, but it never
-parses MDI or produces semantic HTML.
+Rendering starts from the same Rust IR. Canonical MDI, plain text, HTML, EPUB,
+and DOCX—including profile-configured EPUB and DOCX—execute in Rust and are
+exposed through this package. PDF uses Rust-prepared HTML, print CSS, page
+geometry, and header/footer data as input to a host such as
+`@illusions-lab/mdi-to-pdf`. The host launches Chromium, but it never parses
+MDI or decides publication settings.
 
 Browser WebAssembly cannot start Chromium. Browser code sends Rust-rendered
 HTML to a server or desktop host when it needs PDF output.
@@ -94,25 +95,28 @@ Rust-authoritative parser rather than accepting mutable JavaScript IR. This
 keeps the source spans and error codes predictable and prevents JavaScript from
 becoming a second syntax implementation.
 
-Configuration ownership is deliberately split: Rust owns MDI parsing and
-semantic HTML; publication profiles own EPUB/DOCX metadata and typesetting;
-the host owns Chromium/Electron, paper-printer integration, and application UI
-preferences. This keeps platform-specific pagination controls out of the
-parser and lets Electron supply its own PDF adapter.
+Configuration ownership is deliberately clear: Rust validates publication
+profiles and applies EPUB/DOCX metadata, typography, page geometry, and
+numbering. For PDF, Rust also prepares the print HTML and resolved page data;
+the host owns only Chromium/Electron process control, printer integration, and
+application UI preferences. This keeps layout behavior consistent without
+putting application concerns into the parser.
 
 ### Configured EPUB and DOCX
 
 For publication output, pass an export profile to the overloads (or use the
-explicit `WithProfile` functions). These Node.js-only async paths map the
-Rust-owned IR through the publication adapters and retain configuration for
-metadata, chapter splitting, vertical writing, font selection, paper size,
-margins, and page numbers. EPUB also accepts in-memory PNG or JPEG cover art.
+explicit `WithProfile` functions). The Promise-shaped API is retained for
+compatibility, while profile validation and archive generation both run in
+Rust. It supports metadata, chapter splitting, vertical writing, font
+selection, paper size, margins, and page numbers. EPUB also accepts in-memory
+PNG or JPEG cover art.
 
 ```ts
 import { renderDocxWithProfile, renderEpubWithProfile } from "@illusions-lab/mdi";
 
 const epub = await renderEpubWithProfile(source, {
   profile: {
+    layout: { system: "japanese-publisher" },
     metadata: { title: "Book", author: "Author" },
     typesetting: { writingMode: "vertical", fontFamily: "Noto Serif JP" },
     epub: { chapterSplitLevel: "h1" },
@@ -121,6 +125,7 @@ const epub = await renderEpubWithProfile(source, {
 });
 
 const docx = await renderDocxWithProfile(source, {
+  layout: { system: "word" },
   pagination: { pageSize: "A5", margins: { top: 12, bottom: 12, left: 14, right: 14 } },
 });
 ```

package/dist/{chunk-FA5R33XH.js → chunk-BF7UFCZO.js}

@@ -3,7 +3,9 @@ import {
   parseMdiSyntaxJson,
   renderHtml as renderHtmlFromRust,
   renderEpub as renderEpubFromRust,
+  renderEpubWithProfile as renderEpubWithProfileFromRust,
   renderDocx as renderDocxFromRust,
+  renderDocxWithProfile as renderDocxWithProfileFromRust,
   renderText as renderTextFromRust,
   renderTextFormat as renderTextFormatFromRust,
   serializeMdi as serializeMdiFromRust
@@ -61,30 +63,22 @@ function renderDocxWithDiagnostics(source, profile) {
 async function renderEpubWithProfile(source, options = {}) {
   assertSource(source);
   assertEpubOptions(options);
-  const { mdiToEpub } = await import("@illusions-lab/mdi-to-epub");
   const normalized = normalizeEpubOptions(options);
   requireLayoutSystem(normalized.profile);
-  return mdiToEpub(toPublicationMdast(parse(source).document), normalized);
+  const cover = normalized.cover;
+  return renderEpubWithProfileFromRust(
+    source,
+    JSON.stringify(normalized.profile),
+    cover?.data ?? new Uint8Array(),
+    cover?.mediaType
+  );
 }
 async function renderDocxWithProfile(source, profile = {}) {
   assertSource(source);
   assertPlainObject(profile, "profile");
-  prepareNodeDocxImport();
-  const { mdiToDocx } = await import("@illusions-lab/mdi-to-docx");
   const normalized = normalizeDocxProfile(profile);
   requireLayoutSystem(normalized);
-  return mdiToDocx(toPublicationMdast(parse(source).document), normalized);
-}
-function prepareNodeDocxImport() {
-  const nodeProcess = globalThis.process;
-  if (nodeProcess?.release?.name === "node" && !nodeProcess.execArgv?.some((argument) => argument.startsWith("--localstorage-file="))) {
-    const descriptor = Object.getOwnPropertyDescriptor(globalThis, "localStorage");
-    if (descriptor?.configurable && descriptor.get)
-      Object.defineProperty(globalThis, "localStorage", {
-        value: void 0,
-        configurable: true
-      });
-  }
+  return renderDocxWithProfileFromRust(source, JSON.stringify(normalized));
 }
 function toPublicationMdast(document) {
   const children = document.children.map(toPublicationMdastNode);

package/dist/index.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -103,30 +93,22 @@ function renderDocxWithDiagnostics(source, profile) {
 async function renderEpubWithProfile(source, options = {}) {
   assertSource(source);
   assertEpubOptions(options);
-  const { mdiToEpub } = await import("@illusions-lab/mdi-to-epub");
   const normalized = normalizeEpubOptions(options);
   (0, import_mdi_export_profile.requireLayoutSystem)(normalized.profile);
-  return mdiToEpub(toPublicationMdast(parse(source).document), normalized);
+  const cover = normalized.cover;
+  return (0, import_mdi_core.renderEpubWithProfile)(
+    source,
+    JSON.stringify(normalized.profile),
+    cover?.data ?? new Uint8Array(),
+    cover?.mediaType
+  );
 }
 async function renderDocxWithProfile(source, profile = {}) {
   assertSource(source);
   assertPlainObject(profile, "profile");
-  prepareNodeDocxImport();
-  const { mdiToDocx } = await import("@illusions-lab/mdi-to-docx");
   const normalized = normalizeDocxProfile(profile);
   (0, import_mdi_export_profile.requireLayoutSystem)(normalized);
-  return mdiToDocx(toPublicationMdast(parse(source).document), normalized);
-}
-function prepareNodeDocxImport() {
-  const nodeProcess = globalThis.process;
-  if (nodeProcess?.release?.name === "node" && !nodeProcess.execArgv?.some((argument) => argument.startsWith("--localstorage-file="))) {
-    const descriptor = Object.getOwnPropertyDescriptor(globalThis, "localStorage");
-    if (descriptor?.configurable && descriptor.get)
-      Object.defineProperty(globalThis, "localStorage", {
-        value: void 0,
-        configurable: true
-      });
-  }
+  return (0, import_mdi_core.renderDocxWithProfile)(source, JSON.stringify(normalized));
 }
 function toPublicationMdast(document) {
   const children = document.children.map(toPublicationMdastNode);

package/dist/index.d.cts

@@ -45,9 +45,9 @@ type MdiDocxExportProfile = ExportProfile & {
     date?: string;
     verticalWriting?: boolean;
     fontFamily?: string;
-    /** Point size; requires a publication adapter that supports it. */
+    /** Body type size in typographic points. */
     fontSize?: number;
-    /** Line-height multiplier; requires a publication adapter that supports it. */
+    /** Baseline multiplier, for example 1.5 for one-and-a-half spacing. */
     lineSpacing?: number;
     textIndent?: number;
     pageSize?: NonNullable<ExportProfile["pagination"]>["pageSize"];
@@ -113,6 +113,21 @@ interface MdiDocument {
     frontmatter?: MdiFrontmatter;
     children: MdiNode[];
 }
+/** Resolved front matter attached to mdast compatibility roots. */
+interface MdiPublicationFrontmatter {
+    mdi: string;
+    title?: string;
+    author?: string;
+    lang: string;
+    date?: string;
+    writingMode: "horizontal" | "vertical";
+    pageProgression: "ltr" | "rtl";
+}
+interface MdiPublicationRoot extends Root {
+    data?: Root["data"] & {
+        frontmatter?: MdiPublicationFrontmatter;
+    };
+}
 /** A source-backed heading available to host navigation and chapter UIs. */
 interface MdiHeading {
     depth: 1 | 2 | 3 | 4 | 5 | 6;
@@ -177,7 +192,7 @@ declare function prepareRender(source: string): MdiSyntaxParseResult;
 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.
+ * for backward compatibility; validation and archive generation run in Rust.
  */
 declare function renderEpub(source: string, options: MdiEpubExportOptions): Promise<Uint8Array>;
 /** Build a baseline Rust EPUB while retaining diagnostics for an export UI. */
@@ -187,34 +202,29 @@ declare function renderEpubWithDiagnostics(source: string, options: MdiEpubExpor
 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.
+ * for backward compatibility; validation and OOXML generation run in Rust.
  */
 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.
+ * Build a configured EPUB in Rust. Unlike the one-argument
+ * {@link renderEpub}, this returns a Promise for API compatibility 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
+ * Build a configured DOCX in Rust 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.
+ * Convert a Rust-owned MDI document IR into mdast for unified compatibility
+ * workflows. This performs no parsing and preserves the established mdast
+ * node conventions.
  */
-declare function toPublicationMdast(document: MdiDocument): Root;
+declare function toPublicationMdast(document: MdiDocument): MdiPublicationRoot;
 /** 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. */
@@ -229,4 +239,4 @@ declare function renderTextFormatWithDiagnostics(source: string, format: MdiText
 /** @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 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 };
+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 MdiPublicationFrontmatter, type MdiPublicationRoot, 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.d.ts

@@ -45,9 +45,9 @@ type MdiDocxExportProfile = ExportProfile & {
     date?: string;
     verticalWriting?: boolean;
     fontFamily?: string;
-    /** Point size; requires a publication adapter that supports it. */
+    /** Body type size in typographic points. */
     fontSize?: number;
-    /** Line-height multiplier; requires a publication adapter that supports it. */
+    /** Baseline multiplier, for example 1.5 for one-and-a-half spacing. */
     lineSpacing?: number;
     textIndent?: number;
     pageSize?: NonNullable<ExportProfile["pagination"]>["pageSize"];
@@ -113,6 +113,21 @@ interface MdiDocument {
     frontmatter?: MdiFrontmatter;
     children: MdiNode[];
 }
+/** Resolved front matter attached to mdast compatibility roots. */
+interface MdiPublicationFrontmatter {
+    mdi: string;
+    title?: string;
+    author?: string;
+    lang: string;
+    date?: string;
+    writingMode: "horizontal" | "vertical";
+    pageProgression: "ltr" | "rtl";
+}
+interface MdiPublicationRoot extends Root {
+    data?: Root["data"] & {
+        frontmatter?: MdiPublicationFrontmatter;
+    };
+}
 /** A source-backed heading available to host navigation and chapter UIs. */
 interface MdiHeading {
     depth: 1 | 2 | 3 | 4 | 5 | 6;
@@ -177,7 +192,7 @@ declare function prepareRender(source: string): MdiSyntaxParseResult;
 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.
+ * for backward compatibility; validation and archive generation run in Rust.
  */
 declare function renderEpub(source: string, options: MdiEpubExportOptions): Promise<Uint8Array>;
 /** Build a baseline Rust EPUB while retaining diagnostics for an export UI. */
@@ -187,34 +202,29 @@ declare function renderEpubWithDiagnostics(source: string, options: MdiEpubExpor
 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.
+ * for backward compatibility; validation and OOXML generation run in Rust.
  */
 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.
+ * Build a configured EPUB in Rust. Unlike the one-argument
+ * {@link renderEpub}, this returns a Promise for API compatibility 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
+ * Build a configured DOCX in Rust 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.
+ * Convert a Rust-owned MDI document IR into mdast for unified compatibility
+ * workflows. This performs no parsing and preserves the established mdast
+ * node conventions.
  */
-declare function toPublicationMdast(document: MdiDocument): Root;
+declare function toPublicationMdast(document: MdiDocument): MdiPublicationRoot;
 /** 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. */
@@ -229,4 +239,4 @@ declare function renderTextFormatWithDiagnostics(source: string, format: MdiText
 /** @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 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 };
+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 MdiPublicationFrontmatter, type MdiPublicationRoot, 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

@@ -18,7 +18,7 @@ import {
   renderTextWithDiagnostics,
   serializeMdi,
   toPublicationMdast
-} from "./chunk-FA5R33XH.js";
+} from "./chunk-BF7UFCZO.js";
 export {
   MDI_IR_VERSION,
   MDI_SPEC_VERSION,

package/dist/node.js

@@ -1,7 +1,7 @@
 import {
   parse,
   renderHtml
-} from "./chunk-FA5R33XH.js";
+} from "./chunk-BF7UFCZO.js";
 
 // src/node.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illusions-lab/mdi",
-  "version": "2.0.11",
+  "version": "2.0.13",
   "description": "Thin JavaScript binding for the Rust-authoritative MDI parser",
   "license": "MIT",
   "repository": {
@@ -32,10 +32,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@illusions-lab/mdi-core": "^2.0.11",
-    "@illusions-lab/mdi-export-profile": "^2.0.0",
-    "@illusions-lab/mdi-to-docx": "^2.0.17",
-    "@illusions-lab/mdi-to-epub": "^2.0.18",
+    "@illusions-lab/mdi-core": "^2.0.13",
+    "@illusions-lab/mdi-export-profile": "^2.0.18",
+    "@illusions-lab/mdi-to-epub": "^2.0.28",
     "@types/mdast": "^4.0.0",
     "yaml": "^2.0.0"
   },