@illusions-lab/mdi 2.0.16 → 2.0.18

package/README.md

@@ -25,6 +25,25 @@ console.log(result.document);
 console.log(result.diagnostics);
 ```
 
+### Browser initialization
+
+Browser applications must initialize the Rust WebAssembly module once before
+using the otherwise synchronous APIs. Repeated calls return the same pending
+initialization and are safe during hot reload or shared application startup:
+
+```ts
+import { initializeMdi, parse, serializeMdi } from "@illusions-lab/mdi";
+
+await initializeMdi();
+const parsed = parse("{東京|とうきょう} ^12^");
+const canonical = serializeMdi("{東京|とうきょう} ^12^");
+```
+
+Vite and other browser-condition-aware bundlers select the web loader and emit
+its WASM asset automatically. Node.js keeps its existing eager, synchronous
+WASM loading behavior; `initializeMdi()` resolves immediately there, so shared
+startup code can call it in both environments.
+
 ## What the binding does
 
 The package has deliberately narrow responsibilities:

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

@@ -1,19 +1,27 @@
 // src/index.ts
-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
-} from "@illusions-lab/mdi-core";
-import {
-  requireLayoutSystem
-} from "@illusions-lab/mdi-export-profile";
+import * as mdiCore from "@illusions-lab/mdi-core";
 import { parse as parseYaml } from "yaml";
+var {
+  parseMdiSyntaxJson,
+  renderHtml: renderHtmlFromRust,
+  renderEpub: renderEpubFromRust,
+  renderEpubWithProfile: renderEpubWithProfileFromRust,
+  renderDocx: renderDocxFromRust,
+  renderDocxWithProfile: renderDocxWithProfileFromRust,
+  renderText: renderTextFromRust,
+  renderTextFormat: renderTextFormatFromRust,
+  resolveExportProfileJson: resolveExportProfileJsonFromRust,
+  serializeMdi: serializeMdiFromRust
+} = mdiCore;
+function initializeMdi() {
+  return mdiCore.initializeMdiCore();
+}
+function requireLayoutSystem(profile) {
+  if (!profile || typeof profile !== "object" || Array.isArray(profile)) {
+    throw new Error("Export profile must be an object");
+  }
+  resolveExportProfileJsonFromRust(JSON.stringify(profile), void 0, true);
+}
 var MDI_SPEC_VERSION = "2.0";
 var MDI_IR_VERSION = "1.0";
 function parse(source) {
@@ -355,6 +363,7 @@ function renderTextFormatWithDiagnostics(source, format, indentPrefix = "") {
 var parseMdiSyntax = parse;
 
 export {
+  initializeMdi,
   MDI_SPEC_VERSION,
   MDI_IR_VERSION,
   parse,

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "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)
@@ -15,6 +17,14 @@ 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
@@ -22,6 +32,7 @@ var index_exports = {};
 __export(index_exports, {
   MDI_IR_VERSION: () => MDI_IR_VERSION,
   MDI_SPEC_VERSION: () => MDI_SPEC_VERSION,
+  initializeMdi: () => initializeMdi,
   parse: () => parse,
   parseMdiSyntax: () => parseMdiSyntax,
   prepareRender: () => prepareRender,
@@ -41,14 +52,34 @@ __export(index_exports, {
   toPublicationMdast: () => toPublicationMdast
 });
 module.exports = __toCommonJS(index_exports);
-var import_mdi_core = require("@illusions-lab/mdi-core");
-var import_mdi_export_profile = require("@illusions-lab/mdi-export-profile");
+var mdiCore = __toESM(require("@illusions-lab/mdi-core"), 1);
 var import_yaml = require("yaml");
+var {
+  parseMdiSyntaxJson,
+  renderHtml: renderHtmlFromRust,
+  renderEpub: renderEpubFromRust,
+  renderEpubWithProfile: renderEpubWithProfileFromRust,
+  renderDocx: renderDocxFromRust,
+  renderDocxWithProfile: renderDocxWithProfileFromRust,
+  renderText: renderTextFromRust,
+  renderTextFormat: renderTextFormatFromRust,
+  resolveExportProfileJson: resolveExportProfileJsonFromRust,
+  serializeMdi: serializeMdiFromRust
+} = mdiCore;
+function initializeMdi() {
+  return mdiCore.initializeMdiCore();
+}
+function requireLayoutSystem(profile) {
+  if (!profile || typeof profile !== "object" || Array.isArray(profile)) {
+    throw new Error("Export profile must be an object");
+  }
+  resolveExportProfileJsonFromRust(JSON.stringify(profile), void 0, true);
+}
 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((0, import_mdi_core.parseMdiSyntaxJson)(source));
+  const result = JSON.parse(parseMdiSyntaxJson(source));
   if (result.irVersion !== MDI_IR_VERSION) {
     throw new Error(`Unsupported MDI IR version: ${String(result.irVersion)}`);
   }
@@ -57,7 +88,7 @@ function parse(source) {
 function renderHtml(source, options) {
   assertSource(source);
   assertHtmlOptions(options);
-  const html = (0, import_mdi_core.renderHtml)(source);
+  const html = renderHtmlFromRust(source);
   return options?.bodyOnly ? htmlBody(html) : html;
 }
 function renderHtmlWithDiagnostics(source, options) {
@@ -74,7 +105,7 @@ function renderEpub(source, options) {
     assertEpubOptions(options);
     return renderEpubWithProfile(source, options);
   }
-  return (0, import_mdi_core.renderEpub)(source);
+  return renderEpubFromRust(source);
 }
 function renderEpubWithDiagnostics(source, options) {
   return options === void 0 ? renderWithDiagnostics(source, () => renderEpub(source)) : renderWithDiagnosticsAsync(source, () => renderEpub(source, options));
@@ -85,7 +116,7 @@ function renderDocx(source, profile) {
     assertPlainObject(profile, "profile");
     return renderDocxWithProfile(source, profile);
   }
-  return (0, import_mdi_core.renderDocx)(source);
+  return renderDocxFromRust(source);
 }
 function renderDocxWithDiagnostics(source, profile) {
   return profile === void 0 ? renderWithDiagnostics(source, () => renderDocx(source)) : renderWithDiagnosticsAsync(source, () => renderDocx(source, profile));
@@ -94,9 +125,9 @@ async function renderEpubWithProfile(source, options = {}) {
   assertSource(source);
   assertEpubOptions(options);
   const normalized = normalizeEpubOptions(options);
-  (0, import_mdi_export_profile.requireLayoutSystem)(normalized.profile);
+  requireLayoutSystem(normalized.profile);
   const cover = normalized.cover;
-  return (0, import_mdi_core.renderEpubWithProfile)(
+  return renderEpubWithProfileFromRust(
     source,
     JSON.stringify(normalized.profile),
     cover?.data ?? new Uint8Array(),
@@ -107,8 +138,8 @@ async function renderDocxWithProfile(source, profile = {}) {
   assertSource(source);
   assertPlainObject(profile, "profile");
   const normalized = normalizeDocxProfile(profile);
-  (0, import_mdi_export_profile.requireLayoutSystem)(normalized);
-  return (0, import_mdi_core.renderDocxWithProfile)(source, JSON.stringify(normalized));
+  requireLayoutSystem(normalized);
+  return renderDocxWithProfileFromRust(source, JSON.stringify(normalized));
 }
 function toPublicationMdast(document) {
   const children = document.children.map(toPublicationMdastNode);
@@ -364,11 +395,11 @@ function defined(value) {
 }
 function serializeMdi(source) {
   if (typeof source !== "string") throw new TypeError("source must be a string");
-  return (0, import_mdi_core.serializeMdi)(source);
+  return serializeMdiFromRust(source);
 }
 function renderText(source) {
   if (typeof source !== "string") throw new TypeError("source must be a string");
-  return (0, import_mdi_core.renderText)(source);
+  return renderTextFromRust(source);
 }
 function renderTextWithDiagnostics(source) {
   return renderWithDiagnostics(source, () => renderText(source));
@@ -377,7 +408,7 @@ function renderTextFormat(source, format, indentPrefix = "") {
   if (typeof source !== "string" || typeof indentPrefix !== "string") {
     throw new TypeError("source and indentPrefix must be strings");
   }
-  return (0, import_mdi_core.renderTextFormat)(source, format, indentPrefix);
+  return renderTextFormatFromRust(source, format, indentPrefix);
 }
 function renderTextFormatWithDiagnostics(source, format, indentPrefix = "") {
   return renderWithDiagnostics(source, () => renderTextFormat(source, format, indentPrefix));
@@ -387,6 +418,7 @@ var parseMdiSyntax = parse;
 0 && (module.exports = {
   MDI_IR_VERSION,
   MDI_SPEC_VERSION,
+  initializeMdi,
   parse,
   parseMdiSyntax,
   prepareRender,

package/dist/index.d.cts

@@ -4,6 +4,15 @@ import { ExportProfile } from '@illusions-lab/mdi-export-profile';
 export { ExportProfile } from '@illusions-lab/mdi-export-profile';
 import { Root } from 'mdast';
 
+/**
+ * Initialize the shared MDI core runtime exactly once.
+ *
+ * Browser applications must await this before calling the synchronous parse
+ * or serialization APIs. In Node.js the WASM binding is loaded eagerly, so
+ * this remains a harmless resolved promise for portable application setup.
+ */
+declare function initializeMdi(): Promise<void>;
+
 /**
  * Options for a configured EPUB export.  The profile controls metadata,
  * chapter splitting and typography; `cover` supplies the actual image data.
@@ -239,4 +248,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 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 };
+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, initializeMdi, parse, parseMdiSyntax, prepareRender, renderDocx, renderDocxWithDiagnostics, renderDocxWithProfile, renderEpub, renderEpubWithDiagnostics, renderEpubWithProfile, renderHtml, renderHtmlWithDiagnostics, renderText, renderTextFormat, renderTextFormatWithDiagnostics, renderTextWithDiagnostics, serializeMdi, toPublicationMdast };

package/dist/index.d.ts

@@ -4,6 +4,15 @@ import { ExportProfile } from '@illusions-lab/mdi-export-profile';
 export { ExportProfile } from '@illusions-lab/mdi-export-profile';
 import { Root } from 'mdast';
 
+/**
+ * Initialize the shared MDI core runtime exactly once.
+ *
+ * Browser applications must await this before calling the synchronous parse
+ * or serialization APIs. In Node.js the WASM binding is loaded eagerly, so
+ * this remains a harmless resolved promise for portable application setup.
+ */
+declare function initializeMdi(): Promise<void>;
+
 /**
  * Options for a configured EPUB export.  The profile controls metadata,
  * chapter splitting and typography; `cover` supplies the actual image data.
@@ -239,4 +248,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 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 };
+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, initializeMdi, parse, parseMdiSyntax, prepareRender, renderDocx, renderDocxWithDiagnostics, renderDocxWithProfile, renderEpub, renderEpubWithDiagnostics, renderEpubWithProfile, renderHtml, renderHtmlWithDiagnostics, renderText, renderTextFormat, renderTextFormatWithDiagnostics, renderTextWithDiagnostics, serializeMdi, toPublicationMdast };

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
   MDI_IR_VERSION,
   MDI_SPEC_VERSION,
+  initializeMdi,
   parse,
   parseMdiSyntax,
   prepareRender,
@@ -18,10 +19,11 @@ import {
   renderTextWithDiagnostics,
   serializeMdi,
   toPublicationMdast
-} from "./chunk-BF7UFCZO.js";
+} from "./chunk-WEJ62HS6.js";
 export {
   MDI_IR_VERSION,
   MDI_SPEC_VERSION,
+  initializeMdi,
   parse,
   parseMdiSyntax,
   prepareRender,

package/dist/node.cjs

@@ -1,7 +1,9 @@
 "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)
@@ -15,6 +17,14 @@ 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/node.ts
@@ -28,13 +38,24 @@ __export(node_exports, {
 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 mdiCore = __toESM(require("@illusions-lab/mdi-core"), 1);
 var import_yaml = require("yaml");
+var {
+  parseMdiSyntaxJson,
+  renderHtml: renderHtmlFromRust,
+  renderEpub: renderEpubFromRust,
+  renderEpubWithProfile: renderEpubWithProfileFromRust,
+  renderDocx: renderDocxFromRust,
+  renderDocxWithProfile: renderDocxWithProfileFromRust,
+  renderText: renderTextFromRust,
+  renderTextFormat: renderTextFormatFromRust,
+  resolveExportProfileJson: resolveExportProfileJsonFromRust,
+  serializeMdi: serializeMdiFromRust
+} = mdiCore;
 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));
+  const result = JSON.parse(parseMdiSyntaxJson(source));
   if (result.irVersion !== MDI_IR_VERSION) {
     throw new Error(`Unsupported MDI IR version: ${String(result.irVersion)}`);
   }
@@ -43,7 +64,7 @@ function parse(source) {
 function renderHtml(source, options) {
   assertSource(source);
   assertHtmlOptions(options);
-  const html = (0, import_mdi_core.renderHtml)(source);
+  const html = renderHtmlFromRust(source);
   return options?.bodyOnly ? htmlBody(html) : html;
 }
 function assertSource(source) {
@@ -68,10 +89,10 @@ function assertPlainObject(value, label) {
 }
 
 // src/node.ts
-var import_mdi_export_profile2 = require("@illusions-lab/mdi-export-profile");
+var import_mdi_export_profile = 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);
+  if (profile !== void 0) (0, import_mdi_export_profile.requireLayoutSystem)(profile);
   const writingMode = parse(source).document.frontmatter?.entries.find(
     (entry) => entry.key === "writing-mode" || entry.key === "writingMode"
   )?.value;
@@ -83,7 +104,7 @@ function preparePdfExport(source, profile) {
 }
 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);
+  if (profile !== void 0) (0, import_mdi_export_profile.requireLayoutSystem)(profile);
   const parsed = parse(source);
   const writingMode = parsed.document.frontmatter?.entries.find(
     (entry) => entry.key === "writing-mode" || entry.key === "writingMode"

package/dist/node.js

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

package/package.json

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