orz-mdhtml 0.1.0

package/dist/browser-entry.js

@@ -0,0 +1,34 @@
+/**
+ * Browser entry for the orz-markdown renderer.
+ *
+ * esbuild bundles this (with orz-markdown + its deps) into a single IIFE,
+ * `dist/orzmd.browser.js`, which exposes `window.orzmd.render(src)`.
+ *
+ * Two consumers:
+ *   1. `--inline` generation embeds this bundle directly in each .md.html.
+ *   2. `--cdn` generation references a published copy on jsDelivr
+ *      (package `orz-mdhtml-browser`) so files stay small and the bundle
+ *      is browser-cached across documents.
+ */
+import { md } from 'orz-markdown';
+// Stamp every block element with its source line (`data-src-line`) so the
+// editor and preview can be scroll-synced. Uses markdown-it's token.map; only
+// affects this browser bundle's output (not orz-markdown core), and the
+// copy-as-markdown walker ignores the attribute.
+md.core.ruler.push('orz_src_line', function (state) {
+    const tokens = state.tokens;
+    for (let i = 0; i < tokens.length; i++) {
+        const t = tokens[i];
+        if (t.map && t.block && t.nesting !== -1 && !t.hidden) {
+            t.attrSet('data-src-line', String(t.map[0]));
+        }
+    }
+    return false;
+});
+window.orzmd = {
+    version: typeof __ORZMD_VERSION__ !== 'undefined' ? __ORZMD_VERSION__ : '0.0.0',
+    render(source) {
+        // markdownBasePath is omitted: filesystem includes don't resolve in-browser.
+        return md.render(source);
+    },
+};

package/dist/cli.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * orz-mdhtml — generate a self-contained, editable .md.html from a .md file.
+ *
+ * Usage:
+ *   orz-mdhtml <input.md> [options]
+ *
+ * Options:
+ *   -o, --out <file>      output path (default: <input>.md.html)
+ *   --theme <name>        orz-markdown theme (default: light-academic-1)
+ *   --cdn                 reference the renderer from jsDelivr (default; small files)
+ *   --inline              embed the renderer bundle in the file (larger, no renderer fetch)
+ *   --title <text>        document <title> (default: input filename)
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { basename, extname, dirname, resolve, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+import { randomUUID } from 'node:crypto';
+import { getBrowserRuntimeScript } from 'orz-markdown/runtime';
+import { buildHtml } from './template.js';
+/** orz-markdown's bundled themes (CDN-loaded), with light/dark scheme. */
+const THEME_DEFS = [
+    { id: 'light-academic-1', name: 'Academic I', scheme: 'light' },
+    { id: 'light-academic-2', name: 'Academic II', scheme: 'light' },
+    { id: 'light-neat-1', name: 'Neat I', scheme: 'light' },
+    { id: 'light-neat-2', name: 'Neat II', scheme: 'light' },
+    { id: 'light-playful-1', name: 'Playful I', scheme: 'light' },
+    { id: 'light-playful-2', name: 'Playful II', scheme: 'light' },
+    { id: 'beige-decent-1', name: 'Decent I', scheme: 'light' },
+    { id: 'beige-decent-2', name: 'Decent II', scheme: 'light' },
+    { id: 'dark-elegant-1', name: 'Elegant I', scheme: 'dark' },
+    { id: 'dark-elegant-2', name: 'Elegant II', scheme: 'dark' },
+];
+const CDN = {
+    hl: 'https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0',
+    cm: 'https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16',
+};
+const require = createRequire(import.meta.url);
+/** orz-markdown's `exports` hides ./package.json, so find it by walking up. */
+function orzVersionOf() {
+    let dir = dirname(require.resolve('orz-markdown'));
+    while (!existsSync(join(dir, 'package.json')))
+        dir = dirname(dir);
+    return JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')).version;
+}
+const orzVersion = orzVersionOf();
+const HERE = dirname(fileURLToPath(import.meta.url));
+/** orz-mdhtml's own version — pins the renderer bundle + version check. */
+function selfVersionOf() {
+    for (const p of [join(HERE, '..', 'package.json'), join(HERE, '..', '..', 'package.json')]) {
+        try {
+            const j = JSON.parse(readFileSync(p, 'utf8'));
+            if (j.name === 'orz-mdhtml' && j.version)
+                return j.version;
+        }
+        catch {
+            /* keep looking */
+        }
+    }
+    return '0.0.0';
+}
+const selfVersion = selfVersionOf();
+// assets/ sits next to dist/ when published, and next to src/ in dev.
+function findAsset(name) {
+    for (const p of [join(HERE, '..', 'assets', name), join(HERE, '..', '..', 'assets', name)]) {
+        if (existsSync(p))
+            return p;
+    }
+    throw new Error(`asset not found: ${name}`);
+}
+function parseArgs(argv) {
+    const a = { theme: 'light-academic-1', delivery: 'cdn' };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '-o' || arg === '--out')
+            a.out = argv[++i];
+        else if (arg === '--theme')
+            a.theme = argv[++i];
+        else if (arg === '--inline')
+            a.delivery = 'inline';
+        else if (arg === '--cdn')
+            a.delivery = 'cdn';
+        else if (arg === '--title')
+            a.title = argv[++i];
+        else if (!arg.startsWith('-'))
+            a.input = arg;
+    }
+    return a;
+}
+function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (!args.input) {
+        console.error('Usage: orz-mdhtml <input.md> [-o out] [--theme name] [--inline|--cdn]');
+        process.exit(1);
+    }
+    const inputPath = resolve(args.input);
+    const source = readFileSync(inputPath, 'utf8');
+    const base = basename(inputPath, extname(inputPath));
+    const outPath = args.out ? resolve(args.out) : join(dirname(inputPath), `${base}.md.html`);
+    const appJs = readFileSync(findAsset('app.js'), 'utf8');
+    const themeBase = `https://cdn.jsdelivr.net/npm/orz-markdown@${orzVersion}/themes`;
+    const themes = THEME_DEFS.map((t) => ({ ...t, href: `${themeBase}/${t.id}.css` }));
+    const defaultTheme = themes.some((t) => t.id === args.theme) ? args.theme : themes[0].id;
+    // Renderer delivery.
+    let renderer;
+    if (args.delivery === 'inline') {
+        // dist/cli.js (published) → sibling; src/cli.ts (dev) → ../dist.
+        const bundlePath = [
+            join(HERE, 'orzmd.browser.js'),
+            join(HERE, '..', 'dist', 'orzmd.browser.js'),
+        ].find(existsSync);
+        if (!bundlePath) {
+            console.error('Inline mode needs the browser bundle. Run: npm run bundle');
+            process.exit(1);
+        }
+        renderer = { mode: 'inline', js: readFileSync(bundlePath, 'utf8') };
+    }
+    else {
+        renderer = {
+            mode: 'cdn',
+            src: `https://cdn.jsdelivr.net/npm/orz-mdhtml-browser@${selfVersion}/orzmd.browser.js`,
+        };
+    }
+    const html = buildHtml({
+        source,
+        title: args.title ?? base,
+        filename: base,
+        docId: randomUUID(),
+        rendererVersion: selfVersion,
+        appJs,
+        runtimeScript: getBrowserRuntimeScript(),
+        renderer,
+        versionManifest: 'https://data.jsdelivr.com/v1/packages/npm/orz-mdhtml-browser/resolved',
+        defaultTheme,
+        themes,
+        frame: {
+            katexCss: 'https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css',
+            hljsLightCss: `${CDN.hl}/styles/github.min.css`,
+            hljsDarkCss: `${CDN.hl}/styles/atom-one-dark.min.css`,
+            hljsJs: `${CDN.hl}/highlight.min.js`,
+            mermaidJs: 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js',
+        },
+        editorLibs: {
+            codemirrorCss: `${CDN.cm}/codemirror.min.css`,
+            codemirrorLightThemeCss: `${CDN.cm}/theme/eclipse.min.css`,
+            codemirrorDarkThemeCss: `${CDN.cm}/theme/material-darker.min.css`,
+            codemirrorJs: `${CDN.cm}/codemirror.min.js`,
+            codemirrorMarkdownJs: `${CDN.cm}/mode/markdown/markdown.min.js`,
+            codemirrorContinuelistJs: `${CDN.cm}/addon/edit/continuelist.min.js`,
+            splitJs: 'https://cdnjs.cloudflare.com/ajax/libs/split.js/1.6.5/split.min.js',
+            morphdomJs: 'https://cdn.jsdelivr.net/npm/morphdom@2.7.4/dist/morphdom-umd.min.js',
+        },
+    });
+    writeFileSync(outPath, html, 'utf8');
+    console.log(`Wrote ${outPath} (${args.delivery}, theme: ${defaultTheme})`);
+}
+main();