md-tech-pdf 0.1.0

package/dist/renderer/mermaid-executor.js

@@ -0,0 +1,99 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { DiagramRenderError } from './error.js';
+/**
+ * Resolves the path to the mmdc script or binary.
+ */
+export function resolveMmdcPath() {
+    const require = createRequire(import.meta.url);
+    try {
+        const entryPath = require.resolve('@mermaid-js/mermaid-cli');
+        const pkgDir = path.dirname(entryPath);
+        const cliScriptPath = path.join(pkgDir, 'cli.js');
+        if (fs.existsSync(cliScriptPath)) {
+            return {
+                command: process.execPath,
+                argsPrefix: [cliScriptPath],
+            };
+        }
+    }
+    catch {
+        // Continue to fallback
+    }
+    // Check local node_modules/.bin/mmdc
+    const localBin = path.resolve(process.cwd(), 'node_modules/.bin/mmdc');
+    if (fs.existsSync(localBin)) {
+        return {
+            command: localBin,
+            argsPrefix: [],
+        };
+    }
+    // Fallback to globally/locally installed binary name in PATH
+    return {
+        command: 'mmdc',
+        argsPrefix: [],
+    };
+}
+/**
+ * Executes Mermaid CLI via stdin/stdout streams entirely in memory.
+ */
+export async function executeMermaidCli(source, options) {
+    const { command, argsPrefix } = resolveMmdcPath();
+    const args = [...argsPrefix, '-i', '-', '-o', '-', '-e', 'svg', '-q'];
+    if (options?.theme) {
+        args.push('-t', options.theme);
+    }
+    if (options?.backgroundColor) {
+        args.push('-b', options.backgroundColor);
+    }
+    return new Promise((resolve, reject) => {
+        let stdoutBuffer = '';
+        let stderrBuffer = '';
+        const child = spawn(command, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+            },
+        });
+        child.stdout.setEncoding('utf-8');
+        child.stderr.setEncoding('utf-8');
+        child.stdout.on('data', (chunk) => {
+            stdoutBuffer += chunk;
+        });
+        child.stderr.on('data', (chunk) => {
+            stderrBuffer += chunk;
+        });
+        child.on('error', (err) => {
+            reject(new DiagramRenderError(`Failed to launch Mermaid CLI process: ${err.message}`, {
+                cause: err,
+            }));
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                const trimmed = stdoutBuffer.trim();
+                if (trimmed.includes('<svg')) {
+                    resolve(trimmed);
+                }
+                else {
+                    reject(new DiagramRenderError(`Mermaid CLI succeeded but output did not contain valid SVG: "${trimmed}"`));
+                }
+            }
+            else {
+                const errorMsg = stderrBuffer.trim() || `Process exited with code ${code}`;
+                reject(new DiagramRenderError(`Failed to render Mermaid diagram: ${errorMsg}`, {
+                    cause: new Error(errorMsg),
+                }));
+            }
+        });
+        try {
+            child.stdin.write(source);
+            child.stdin.end();
+        }
+        catch (writeErr) {
+            reject(new DiagramRenderError(`Failed to write to Mermaid CLI stdin: ${writeErr instanceof Error ? writeErr.message : String(writeErr)}`, { cause: writeErr }));
+        }
+    });
+}
+//# sourceMappingURL=mermaid-executor.js.map

package/dist/renderer/mermaid-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-executor.js","sourceRoot":"","sources":["../../src/renderer/mermaid-executor.ts"],"names":[],"mappings":"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"}

package/dist/renderer/mermaid-renderer.d.ts

@@ -0,0 +1,25 @@
+import type { DiagramRenderer, DiagramRenderOptions } from './diagram-renderer.js';
+export interface MermaidRendererOptions {
+    defaultTheme?: string;
+    defaultBackgroundColor?: string;
+}
+/**
+ * Renders Mermaid diagram source code into SVG vector markup.
+ * Note: PDF layout options (width, height, fit, align) are decoupled
+ * and must be handled downstream by the HTML/CSS layout renderer.
+ */
+export declare class MermaidRenderer implements DiagramRenderer {
+    private readonly defaultTheme?;
+    private readonly defaultBackgroundColor?;
+    constructor(options?: MermaidRendererOptions);
+    /**
+     * Converts Mermaid diagram definition source code into an SVG string.
+     *
+     * @param source Mermaid diagram definition text
+     * @param options Optional diagram render options (e.g. theme, background)
+     * @returns Pure vector SVG string
+     * @throws DiagramRenderError on empty input or syntax/rendering errors
+     */
+    render(source: string, options?: DiagramRenderOptions): Promise<string>;
+}
+//# sourceMappingURL=mermaid-renderer.d.ts.map

package/dist/renderer/mermaid-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-renderer.d.ts","sourceRoot":"","sources":["../../src/renderer/mermaid-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAInF,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAS;gBAErC,OAAO,CAAC,EAAE,sBAAsB;IAK5C;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAe9E"}

package/dist/renderer/mermaid-renderer.js

@@ -0,0 +1,35 @@
+import { DiagramRenderError } from './error.js';
+import { executeMermaidCli } from './mermaid-executor.js';
+/**
+ * Renders Mermaid diagram source code into SVG vector markup.
+ * Note: PDF layout options (width, height, fit, align) are decoupled
+ * and must be handled downstream by the HTML/CSS layout renderer.
+ */
+export class MermaidRenderer {
+    defaultTheme;
+    defaultBackgroundColor;
+    constructor(options) {
+        this.defaultTheme = options?.defaultTheme;
+        this.defaultBackgroundColor = options?.defaultBackgroundColor;
+    }
+    /**
+     * Converts Mermaid diagram definition source code into an SVG string.
+     *
+     * @param source Mermaid diagram definition text
+     * @param options Optional diagram render options (e.g. theme, background)
+     * @returns Pure vector SVG string
+     * @throws DiagramRenderError on empty input or syntax/rendering errors
+     */
+    async render(source, options) {
+        if (!source || source.trim() === '') {
+            throw new DiagramRenderError('Failed to render Mermaid diagram: Source is empty or whitespace only.');
+        }
+        const theme = options?.theme ?? this.defaultTheme;
+        const backgroundColor = options?.backgroundColor ?? this.defaultBackgroundColor;
+        return executeMermaidCli(source, {
+            theme,
+            backgroundColor,
+        });
+    }
+}
+//# sourceMappingURL=mermaid-renderer.js.map

package/dist/renderer/mermaid-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-renderer.js","sourceRoot":"","sources":["../../src/renderer/mermaid-renderer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAO1D;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACT,YAAY,CAAU;IACtB,sBAAsB,CAAU;IAEjD,YAAY,OAAgC;QAC1C,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;QAC1C,IAAI,CAAC,sBAAsB,GAAG,OAAO,EAAE,sBAAsB,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,OAA8B;QACzD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,kBAAkB,CAC1B,uEAAuE,CACxE,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAClD,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,IAAI,CAAC,sBAAsB,CAAC;QAEhF,OAAO,iBAAiB,CAAC,MAAM,EAAE;YAC/B,KAAK;YACL,eAAe;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/renderer/plantuml-executor.d.ts

@@ -0,0 +1,11 @@
+export interface ExecutePlantUmlOptions {
+    jarPath: string;
+    javaPath?: string;
+    timeoutMs?: number;
+}
+/**
+ * Executes the PlantUML CLI in pipe mode to render a PlantUML definition into SVG.
+ * Does not use temporary files; uses stdin and stdout streams.
+ */
+export declare function executePlantUml(source: string, options: ExecutePlantUmlOptions): Promise<string>;
+//# sourceMappingURL=plantuml-executor.d.ts.map

package/dist/renderer/plantuml-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plantuml-executor.d.ts","sourceRoot":"","sources":["../../src/renderer/plantuml-executor.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA0HjB"}

package/dist/renderer/plantuml-executor.js

@@ -0,0 +1,100 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs/promises';
+import { DiagramRenderError } from './error.js';
+const DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * Executes the PlantUML CLI in pipe mode to render a PlantUML definition into SVG.
+ * Does not use temporary files; uses stdin and stdout streams.
+ */
+export async function executePlantUml(source, options) {
+    const { jarPath, javaPath = 'java', timeoutMs = DEFAULT_TIMEOUT_MS } = options;
+    // 1. Verify jarPath exists
+    try {
+        const jarStat = await fs.stat(jarPath);
+        if (!jarStat.isFile()) {
+            throw new DiagramRenderError(`PlantUML jar was not found: ${jarPath}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof DiagramRenderError) {
+            throw err;
+        }
+        throw new DiagramRenderError(`PlantUML jar was not found: ${jarPath}`, { cause: err });
+    }
+    // 2. Launch Java process with pipe mode
+    return new Promise((resolve, reject) => {
+        let childProcess;
+        try {
+            childProcess = spawn(javaPath, ['-Dfile.encoding=UTF-8', '-jar', jarPath, '-charset', 'UTF-8', '-tsvg', '-pipe'], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch (err) {
+            return reject(new DiagramRenderError(`Failed to start PlantUML. Java executable was not found: ${javaPath}`, { cause: err }));
+        }
+        let stdoutData = '';
+        let stderrData = '';
+        let isTimedOut = false;
+        const timer = setTimeout(() => {
+            isTimedOut = true;
+            childProcess.kill('SIGTERM');
+            reject(new DiagramRenderError(`PlantUML rendering timed out after ${timeoutMs}ms.`));
+        }, timeoutMs);
+        childProcess.stdout.setEncoding('utf-8');
+        childProcess.stdout.on('data', (chunk) => {
+            stdoutData += chunk;
+        });
+        childProcess.stderr.setEncoding('utf-8');
+        childProcess.stderr.on('data', (chunk) => {
+            stderrData += chunk;
+        });
+        childProcess.on('error', (err) => {
+            clearTimeout(timer);
+            if (err.code === 'ENOENT') {
+                reject(new DiagramRenderError(`Failed to start PlantUML. Java executable was not found: ${javaPath}`, { cause: err }));
+            }
+            else {
+                reject(new DiagramRenderError(`PlantUML process encountered an error: ${err.message}`, {
+                    cause: err,
+                }));
+            }
+        });
+        childProcess.on('close', (code) => {
+            clearTimeout(timer);
+            if (isTimedOut) {
+                return;
+            }
+            if (code !== 0) {
+                const errorDetails = stderrData.trim() || `Process exited with code ${code}`;
+                return reject(new DiagramRenderError(`PlantUML rendering failed: ${errorDetails}`, {
+                    cause: {
+                        exitCode: code,
+                        stderr: stderrData,
+                        stdout: stdoutData,
+                    },
+                }));
+            }
+            // Validate SVG output
+            if (!stdoutData.includes('<svg')) {
+                return reject(new DiagramRenderError('PlantUML output did not contain valid SVG markup.', {
+                    cause: {
+                        stdout: stdoutData,
+                        stderr: stderrData,
+                    },
+                }));
+            }
+            resolve(stdoutData.trim());
+        });
+        // Write source to stdin and close the stream
+        childProcess.stdin.on('error', (err) => {
+            // Avoid unhandled stream error if child process dies early
+            clearTimeout(timer);
+            reject(new DiagramRenderError(`Failed to write to PlantUML stdin: ${err}`, {
+                cause: err,
+            }));
+        });
+        childProcess.stdin.write(source, 'utf-8');
+        childProcess.stdin.end();
+    });
+}
+//# sourceMappingURL=plantuml-executor.js.map

package/dist/renderer/plantuml-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plantuml-executor.js","sourceRoot":"","sources":["../../src/renderer/plantuml-executor.ts"],"names":[],"mappings":"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"}

package/dist/renderer/plantuml-renderer.d.ts

@@ -0,0 +1,26 @@
+import type { DiagramRenderer, DiagramRenderOptions } from './diagram-renderer.js';
+export interface PlantUmlRendererOptions {
+    jarPath?: string;
+    javaPath?: string;
+    timeoutMs?: number;
+}
+/**
+ * Renders PlantUML diagram source code into SVG vector markup
+ * using a local Java process and plantuml.jar.
+ */
+export declare class PlantUmlRenderer implements DiagramRenderer {
+    private readonly jarPath?;
+    private readonly javaPath;
+    private readonly timeoutMs?;
+    constructor(options?: PlantUmlRendererOptions);
+    /**
+     * Converts PlantUML diagram definition source code into an SVG string.
+     *
+     * @param source PlantUML diagram definition text (typically includes @startuml ... @enduml)
+     * @param _options Optional diagram render options
+     * @returns Pure vector SVG string
+     * @throws DiagramRenderError on empty input, missing jar/java, or syntax/rendering errors
+     */
+    render(source: string, _options?: DiagramRenderOptions): Promise<string>;
+}
+//# sourceMappingURL=plantuml-renderer.d.ts.map

package/dist/renderer/plantuml-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plantuml-renderer.d.ts","sourceRoot":"","sources":["../../src/renderer/plantuml-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAInF,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAExB,OAAO,CAAC,EAAE,uBAAuB;IAM7C;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAmB/E"}

package/dist/renderer/plantuml-renderer.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { DiagramRenderError } from './error.js';
+import { executePlantUml } from './plantuml-executor.js';
+/**
+ * Common default paths where PlantUML jar might reside.
+ */
+const KNOWN_JAR_CANDIDATES = [
+    '/usr/local/opt/plantuml/libexec/plantuml.jar',
+    '/usr/share/plantuml/plantuml.jar',
+    '/opt/homebrew/opt/plantuml/libexec/plantuml.jar',
+];
+/**
+ * Common default paths where Java executable might reside on macOS / Unix.
+ */
+const KNOWN_JAVA_CANDIDATES = [
+    '/usr/local/opt/openjdk/bin/java',
+    '/opt/homebrew/opt/openjdk/bin/java',
+];
+function resolveDefaultJavaPath() {
+    if (process.env.PLANTUML_JAVA_PATH) {
+        return process.env.PLANTUML_JAVA_PATH;
+    }
+    if (process.env.JAVA_HOME) {
+        const javaBin = path.join(process.env.JAVA_HOME, 'bin', 'java');
+        if (fs.existsSync(javaBin)) {
+            return javaBin;
+        }
+    }
+    for (const candidate of KNOWN_JAVA_CANDIDATES) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return 'java';
+}
+function resolveDefaultJarPath() {
+    if (process.env.PLANTUML_JAR_PATH) {
+        return process.env.PLANTUML_JAR_PATH;
+    }
+    // Check Cursor extension path if present
+    const homeDir = process.env.HOME;
+    if (homeDir) {
+        const cursorCandidate = path.join(homeDir, '.cursor/extensions/jebbs.plantuml-2.18.1/plantuml.jar');
+        if (fs.existsSync(cursorCandidate)) {
+            return cursorCandidate;
+        }
+        const vscodeCandidate = path.join(homeDir, '.vscode/extensions/jebbs.plantuml-2.18.1/plantuml.jar');
+        if (fs.existsSync(vscodeCandidate)) {
+            return vscodeCandidate;
+        }
+    }
+    for (const candidate of KNOWN_JAR_CANDIDATES) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+/**
+ * Renders PlantUML diagram source code into SVG vector markup
+ * using a local Java process and plantuml.jar.
+ */
+export class PlantUmlRenderer {
+    jarPath;
+    javaPath;
+    timeoutMs;
+    constructor(options) {
+        this.jarPath = options?.jarPath ?? resolveDefaultJarPath();
+        this.javaPath = options?.javaPath ?? resolveDefaultJavaPath();
+        this.timeoutMs = options?.timeoutMs;
+    }
+    /**
+     * Converts PlantUML diagram definition source code into an SVG string.
+     *
+     * @param source PlantUML diagram definition text (typically includes @startuml ... @enduml)
+     * @param _options Optional diagram render options
+     * @returns Pure vector SVG string
+     * @throws DiagramRenderError on empty input, missing jar/java, or syntax/rendering errors
+     */
+    async render(source, _options) {
+        if (!source || source.trim() === '') {
+            throw new DiagramRenderError('Failed to render PlantUML diagram: Source is empty or whitespace only.');
+        }
+        if (!this.jarPath) {
+            throw new DiagramRenderError('PlantUML jar path is not configured. Please specify jarPath in PlantUmlRendererOptions or set PLANTUML_JAR_PATH.');
+        }
+        return executePlantUml(source, {
+            jarPath: this.jarPath,
+            javaPath: this.javaPath,
+            timeoutMs: this.timeoutMs,
+        });
+    }
+}
+//# sourceMappingURL=plantuml-renderer.js.map

package/dist/renderer/plantuml-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plantuml-renderer.js","sourceRoot":"","sources":["../../src/renderer/plantuml-renderer.ts"],"names":[],"mappings":"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"}

package/dist/types/diagram.d.ts

@@ -0,0 +1,34 @@
+export type DiagramType = 'mermaid' | 'plantuml';
+export type DiagramFit = 'contain' | 'fill';
+export type DiagramAlign = 'left' | 'center' | 'right';
+/**
+ * Raw diagram options parsed directly from block fence attributes.
+ * Properties are undefined if not explicitly specified.
+ */
+export interface RawDiagramOptions {
+    width?: string;
+    height?: string;
+    fit?: DiagramFit;
+    align?: DiagramAlign;
+}
+/**
+ * Resolved diagram options after merging defaults and document-level options.
+ */
+export interface ResolvedDiagramOptions {
+    width?: string;
+    height?: string;
+    fit: DiagramFit;
+    align: DiagramAlign;
+}
+/**
+ * Backward compatibility alias for ResolvedDiagramOptions.
+ */
+export type DiagramOptions = ResolvedDiagramOptions;
+export interface DiagramBlock {
+    type: DiagramType;
+    source: string;
+    options: ResolvedDiagramOptions;
+    rawOptions?: RawDiagramOptions;
+    line?: number;
+}
+//# sourceMappingURL=diagram.d.ts.map

package/dist/types/diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.d.ts","sourceRoot":"","sources":["../../src/types/diagram.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,sBAAsB,CAAC;IAChC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/diagram.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagram.js.map

package/dist/types/diagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.js","sourceRoot":"","sources":["../../src/types/diagram.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "md-tech-pdf",
+  "version": "0.1.0",
+  "description": "Technical document PDF generator from Markdown with flexible diagram layout",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "md-tech-pdf": "dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.ja.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ikaruga-tech/md-tech-pdf.git"
+  },
+  "homepage": "https://github.com/ikaruga-tech/md-tech-pdf#readme",
+  "bugs": {
+    "url": "https://github.com/ikaruga-tech/md-tech-pdf/issues"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli/index.js",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "dev:cli": "tsx src/cli/index.ts",
+    "dev:mermaid": "tsx tools/test-mermaid.ts",
+    "dev:html": "tsx tools/test-html.ts",
+    "dev:pdf": "tsx tools/test-pdf.ts",
+    "dev:plantuml": "tsx tools/test-plantuml.ts"
+  },
+  "keywords": [
+    "markdown",
+    "pdf",
+    "technical-writing",
+    "diagrams",
+    "mermaid",
+    "plantuml",
+    "cli"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/markdown-it": "^14.2.0",
+    "@types/node": "^26.5.0",
+    "eslint": "^10.10.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^5.0.0"
+  },
+  "dependencies": {
+    "@mermaid-js/mermaid-cli": "^11.17.0",
+    "commander": "^15.0.0",
+    "markdown-it": "^15.0.1",
+    "playwright": "^1.63.0",
+    "yaml": "^2.9.0"
+  }
+}