@mml-io/esbuild-plugin-mml

An esbuild plugin that bundles JavaScript/React sources into HTML documents for MML. Supports mml: import prefix for discovering and bundling additional documents.

Installation

npm install --save-dev @mml-io/esbuild-plugin-mml

Usage

import { build } from "esbuild";
import { mml } from "@mml-io/esbuild-plugin-mml";

build({
  entryPoints: [
    "mml:src/playground/index.tsx",  // MML document
    "src/playground.ts"              // World config
  ],
  outdir: "build",
  outbase: "src",
  bundle: true,
  plugins: [mml()],
});

Options

| Option | Type | Description | Default | |-------------------|-----------|---------------------------------------|-----------| | verbose | boolean | Enable logging | false | | pathPrefix | string | Prefix for import path rewrites | ws:/// | | assetDir | string | Asset output directory | assets | | assetPrefix | string | Asset URL prefix | / | | stripHtmlExtension| boolean | Remove .html from output URLs | false |

TypeScript Support

Add these type definitions for custom import syntax:

declare module "*.html" {
  const value: string;
  export default value;
}

declare module "mml:*" {
  const value: string;
  export default value;
}