md-tech-pdf 0.1.0

package/README.md

@@ -0,0 +1,315 @@
+# md-tech-pdf
+
+English | [日本語](./README.ja.md)
+
+An open-source technical document PDF generator from Markdown with flexible, print-oriented diagram layout and vector typography.
+
+Unlike conventional Markdown-to-PDF converters that treat diagrams as fixed raster images or apply crude page scaling, **md-tech-pdf** renders Mermaid and PlantUML diagrams as crisp vector SVGs with independent width and height control, custom aspect ratio fitting (`fit=contain` / `fill`), and alignment (`left` / `center` / `right`).
+
+While future editor integrations (such as a VS Code extension) are planned, the core PDF generation engine is architected as an independent, decoupled library suitable for automated documentation pipelines and CLI workflows.
+
+---
+
+## Features
+
+- **Markdown to High-Quality Vector PDF**: Precise rendering engine built on headless Playwright Chromium.
+- **Mermaid & PlantUML Support**: Inline vector SVG rendering for flowcharts, sequence diagrams, architecture maps, and class diagrams.
+- **Independent Diagram Sizing**: Precise control over diagram `width` and `height` using real-world physical units (`mm`, `cm`, `in`) or digital units (`px`, `pt`, `%`).
+- **Flexible Aspect Ratio & Alignment**: Choose between `fit=contain` (maintain aspect ratio) and `fit=fill`, aligned to `left`, `center`, or `right`.
+- **YAML Front Matter**: Configure page format (A4), orientation (portrait/landscape), margins, fonts, and default diagram settings per document.
+- **Font Customization**:
+  - Local OS font support for body text (`family`) and code blocks (`codeFamily`).
+  - Google Fonts integration via the CSS2 API with automatic loading completion detection.
+- **Print-Ready Layout Optimizations**: Orphan heading prevention (`break-inside: avoid`), automated wrapping for long code lines, and multi-column table styling.
+- **Developer-Friendly CLI**: Simple command-line interface with custom output paths, automatic directory creation, and versioning.
+
+---
+
+## Requirements
+
+- **Node.js**: `>= 20.0.0`
+- **Playwright / Chromium**: Required for PDF rendering (installed automatically with project dependencies).
+- **Java Runtime & PlantUML JAR**: Required **only** if you render PlantUML diagrams. If you only use Mermaid diagrams, Java is **not** required.
+- **Internet Connection**: Required **only** if downloading Google Fonts at compilation time (automatically falls back to system fonts when offline).
+
+---
+
+## Installation
+
+Install globally via npm or pnpm to use the CLI command:
+
+```bash
+# Using npm
+npm install -g md-tech-pdf
+
+# Using pnpm
+pnpm add -g md-tech-pdf
+```
+
+Alternatively, run directly without global installation using `npx`:
+
+```bash
+npx md-tech-pdf document.md -o output.pdf
+```
+
+---
+
+## Quick Start & CLI Usage
+
+### Basic Conversion
+
+Convert a Markdown file to PDF. When omitted, the output file will be created in the same directory as the source Markdown file:
+
+```bash
+# Generates document.pdf in the current directory
+md-tech-pdf document.md
+```
+
+### Specifying Output Path
+
+Use `-o` or `--output` to define the destination file path. Non-existent directories are created automatically:
+
+```bash
+md-tech-pdf document.md -o output.pdf
+
+# Auto-creates the build/ directory if missing
+md-tech-pdf docs/architecture.md -o build/architecture.pdf
+```
+
+### Help and Version
+
+```bash
+# Show command-line help
+md-tech-pdf --help
+md-tech-pdf -h
+
+# Show version number
+md-tech-pdf --version
+md-tech-pdf -v
+```
+
+---
+
+## Document Configuration & Diagrams
+
+### YAML Front Matter
+
+Place Front Matter at the top of your Markdown document to customize PDF page margins, default diagram sizing, and typography:
+
+```yaml
+---
+pdf:
+  format: A4
+  landscape: false
+  margin:
+    top: 20mm
+    right: 20mm
+    bottom: 20mm
+    left: 20mm
+
+diagram:
+  width: 120mm
+  height: 70mm
+  fit: contain
+  align: center
+
+style:
+  font:
+    family: 'Noto Sans JP'
+    codeFamily: 'Roboto Mono'
+    google:
+      families:
+        - name: 'Noto Sans JP'
+          weights: [400, 500, 700]
+        - name: 'Roboto Mono'
+          weights: [400, 700]
+---
+# System Architecture Specification
+```
+
+### Diagram Layout Options
+
+You can customize individual diagram blocks using curly brace attributes `{...}` following the code block language identifier:
+
+- `width`: Target width (supported units: `mm`, `cm`, `in`, `px`, `pt`, `%`).
+- `height`: Target height (supported units: `mm`, `cm`, `in`, `px`, `pt`, `%`).
+- `fit`: Scaling behavior (`contain` to preserve aspect ratio, or `fill` to stretch).
+- `align`: Horizontal position (`left`, `center`, or `right`).
+
+### Mermaid Diagrams
+
+Specify `mermaid` as the code fence identifier. Diagrams are rendered as scalable vector SVGs directly embedded in the HTML:
+
+````markdown
+```mermaid {width=140mm align=center}
+graph TD
+  Client[Client] --> API[API Gateway]
+  API --> DB[(Database)]
+```
+````
+
+### PlantUML Diagrams
+
+Specify `plantuml` as the code fence identifier. Rendering is executed locally via your system's Java runtime, ensuring confidential architecture designs are **never** transmitted to third-party PlantUML cloud servers:
+
+````markdown
+```plantuml {width=100mm align=center}
+@startuml
+actor User
+participant Server
+User -> Server: Request
+Server --> User: Response
+@enduml
+```
+````
+
+> **Note on PlantUML Prerequisites**:
+> PlantUML requires a **Java runtime** and a local **PlantUML .jar file**. If necessary, specify custom paths in Front Matter:
+>
+> ```yaml
+> plantuml:
+>   javaPath: '/usr/bin/java'
+>   jarPath: '/path/to/plantuml.jar'
+> ```
+
+### Font Configuration (style.font)
+
+Configure document body text (`family`) and code block typography (`codeFamily`).
+
+#### 1. Local OS Fonts
+
+Use system fonts installed on the host machine. Fast, lightweight, and offline-compatible:
+
+```yaml
+style:
+  font:
+    family: 'Hiragino Sans'
+    codeFamily: 'Menlo'
+```
+
+- Standard `sans-serif` is automatically appended to body text as a fallback.
+- Standard `monospace` is automatically appended to code blocks (`code`, `pre`) as a fallback.
+
+#### 2. Google Fonts
+
+Download web fonts dynamically at build time using the Google Fonts CSS2 API:
+
+```yaml
+style:
+  font:
+    family: 'Noto Sans JP'
+    codeFamily: 'Roboto Mono'
+    google:
+      families:
+        - name: 'Noto Sans JP'
+          weights: [400, 500, 700]
+        - name: 'Roboto Mono'
+          weights: [400, 700]
+```
+
+- Supported weights: `100, 200, 300, 400, 500, 600, 700, 800, 900`.
+- The generator waits for `document.fonts.ready` before rendering PDF pages.
+- If offline or on network failure, rendering gracefully falls back to system fonts.
+
+---
+
+## Examples
+
+Explore sample Markdown documents and configuration patterns in the [examples/](./examples/) directory:
+
+- [examples/real-world/system-design.md](./examples/real-world/system-design.md): A comprehensive system design document with Mermaid, PlantUML, custom fonts, and multi-column tables.
+- [examples/frontmatter-test.md](./examples/frontmatter-test.md): Document-level margin and layout settings.
+- [examples/mermaid-test.md](./examples/mermaid-test.md): Various Mermaid chart types and sizing attributes.
+- [examples/plantuml-test.md](./examples/plantuml-test.md): PlantUML sequence and component diagrams.
+
+---
+
+## Architecture Overview
+
+**md-tech-pdf** enforces a strict separation of concerns between client interfaces (CLI, future extensions) and the core conversion engine.
+
+```text
++---------------------------------------+
+|             Client Layer              |
+|  +----------------+ +---------------+ |
+|  |      CLI       | |  VSCode Ext   | |
+|  |  (src/cli)     | |   (Future)    | |
+|  +-------+--------+ +-------+-------+ |
++----------|------------------|---------+
+           | (thin wrapper)   |
+           v                  v
++---------------------------------------+
+|              Core Layer               |
+|            (src/index.ts)             |
+|  - Markdown Parser                    |
+|  - Diagram Engine (Mermaid/PlantUML)  |
+|  - Layout Engine & PDF Generator      |
++---------------------------------------+
+```
+
+- **CLI (`src/cli/index.ts`)**: Thin command-line wrapper handling argument parsing and calling the Core API.
+- **Core (`src/index.ts`)**: Standalone library handling document parsing, diagram execution, layout generation, and Playwright PDF printing.
+
+---
+
+## Development
+
+### Prerequisites
+
+- Node.js `>= 20.0.0`
+- pnpm `>= 9.0.0`
+
+### Setup
+
+```bash
+# Install dependencies
+pnpm install
+```
+
+### Scripts
+
+```bash
+# Compile TypeScript to dist/
+pnpm build
+
+# Run unit and integration tests with Vitest
+pnpm test
+
+# Run ESLint static analysis
+pnpm lint
+
+# Check code formatting with Prettier
+pnpm format:check
+
+# Format codebase with Prettier
+pnpm format
+```
+
+---
+
+## Known Limitations
+
+Current known limitations in the v0.1.0 release:
+
+1. **Table Header Pagination (`<thead>`)**: Table headers do not repeat at the top of subsequent pages when a large table breaks across page boundaries.
+2. **Pre-Diagram Whitespace for Tall Diagrams**: Very tall diagrams (>150mm) are moved to the next page to avoid cross-page diagram clipping (`break-inside: avoid`), which may leave whitespace at the bottom of the preceding page.
+3. **PlantUML System Dependencies**: Rendering PlantUML requires a local Java runtime and PlantUML JAR file (Mermaid has no Java dependencies).
+4. **Google Fonts Network Dependency**: Downloading Google Fonts requires an active internet connection at compilation time (falls back to local system fonts if unavailable).
+
+---
+
+## Changelog
+
+Detailed release notes and version history are documented in [CHANGELOG.md](./CHANGELOG.md).
+
+---
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and contribution guidelines. By participating, you agree to abide by our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+---
+
+## License
+
+This project is licensed under the [Apache License 2.0](./LICENSE).

package/dist/cli/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * md-tech-pdf CLI Entrypoint
+ * This layer parses CLI arguments, validates options, and delegates to the Core converter API.
+ * Business logic and rendering algorithms must NOT be placed here.
+ */
+import { Command } from 'commander';
+export declare function createCliCommand(): Command;
+export declare function runCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,wBAAgB,gBAAgB,IAAI,OAAO,CA2D1C;AAED,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}

package/dist/cli/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * md-tech-pdf CLI Entrypoint
+ * This layer parses CLI arguments, validates options, and delegates to the Core converter API.
+ * Business logic and rendering algorithms must NOT be placed here.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { convertMarkdownToPdf, resolveOutputPath } from '../core/converter.js';
+function getPackageVersion() {
+    try {
+        const currentDir = path.dirname(fileURLToPath(import.meta.url));
+        const packageJsonPath = path.resolve(currentDir, '../../package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            const content = fs.readFileSync(packageJsonPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            return pkg.version ?? '0.1.0';
+        }
+    }
+    catch {
+        // Fallback if package.json cannot be read
+    }
+    return '0.1.0';
+}
+export function createCliCommand() {
+    const program = new Command();
+    program
+        .name('md-tech-pdf')
+        .description('Technical document PDF generator from Markdown with flexible diagram layout')
+        .version(getPackageVersion(), '-v, --version')
+        .argument('[input]', 'Path to the input Markdown document')
+        .option('-o, --output <path>', 'Destination path for the output PDF document')
+        .helpOption('-h, --help', 'Display help for command')
+        .action(async (input, options) => {
+        if (!input || input.trim() === '') {
+            console.error('Error: Input file is required.');
+            process.exit(1);
+        }
+        const inputPath = input.trim();
+        const outputPath = resolveOutputPath(inputPath, options.output);
+        const displayInput = path.isAbsolute(inputPath)
+            ? path.relative(process.cwd(), inputPath) || inputPath
+            : inputPath;
+        const displayOutput = path.isAbsolute(outputPath)
+            ? path.relative(process.cwd(), outputPath) || outputPath
+            : outputPath;
+        console.log('md-tech-pdf');
+        console.log('');
+        console.log('Input:');
+        console.log(`  ${displayInput}`);
+        console.log('');
+        console.log('Output:');
+        console.log(`  ${displayOutput}`);
+        console.log('');
+        try {
+            await convertMarkdownToPdf(inputPath, {
+                output: options.output,
+                onProgress: (event) => {
+                    console.log(event.message);
+                },
+            });
+            console.log('');
+            console.log('Done.');
+        }
+        catch (err) {
+            console.error('');
+            if (err instanceof Error) {
+                console.error(`Error: ${err.message}`);
+                if (err.cause && err.cause instanceof Error && err.cause.message !== err.message) {
+                    console.error(`Reason: ${err.cause.message}`);
+                }
+            }
+            else {
+                console.error(`Error: ${String(err)}`);
+            }
+            process.exit(1);
+        }
+    });
+    return program;
+}
+export async function runCli(argv = process.argv) {
+    const program = createCliCommand();
+    await program.parseAsync(argv);
+}
+const isDirectExecution = process.argv[1]?.endsWith('/cli/index.js') ||
+    process.argv[1]?.endsWith('/cli/index.ts') ||
+    process.argv[1]?.endsWith('/md-tech-pdf');
+if (isDirectExecution) {
+    runCli().catch((err) => {
+        console.error('Unexpected CLI error:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QACvE,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,OAAO,CAAC,iBAAiB,EAAE,EAAE,eAAe,CAAC;SAC7C,QAAQ,CAAC,SAAS,EAAE,qCAAqC,CAAC;SAC1D,MAAM,CAAC,qBAAqB,EAAE,8CAA8C,CAAC;SAC7E,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,OAA4B,EAAE,EAAE;QACxE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,IAAI,SAAS;YACtD,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAC/C,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,IAAI,UAAU;YACxD,CAAC,CAAC,UAAU,CAAC;QAEf,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC;YACH,MAAM,oBAAoB,CAAC,SAAS,EAAE;gBACpC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;oBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC7B,CAAC;aACF,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvC,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;oBACjF,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAiB,OAAO,CAAC,IAAI;IACxD,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,iBAAiB,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE5C,IAAI,iBAAiB,EAAE,CAAC;IACtB,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC9B,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/config/config-resolver.d.ts

@@ -0,0 +1,19 @@
+import type { PdfOptions } from '../pdf/types.js';
+import type { RawDiagramOptions, ResolvedDiagramOptions } from '../types/diagram.js';
+import { type DiagramDefaultOptions, type PdfDocumentOptions } from './document-options.js';
+/**
+ * Resolves diagram options following the strict precedence hierarchy:
+ * 1. Code block individual attribute (RawDiagramOptions)
+ * 2. Document Front Matter (DiagramDefaultOptions)
+ * 3. Application default (DiagramDefaultOptions)
+ * 4. Built-in system default (fit: 'contain', align: 'center')
+ */
+export declare function resolveDiagramOptions(raw: RawDiagramOptions, docDefault?: DiagramDefaultOptions, appDefault?: DiagramDefaultOptions): ResolvedDiagramOptions;
+/**
+ * Resolves PDF rendering options following the precedence hierarchy:
+ * 1. Application-level options (e.g. CLI flag / API argument)
+ * 2. Document Front Matter (PdfDocumentOptions)
+ * 3. Built-in system default (A4, portrait, 15mm margins, printBackground: true)
+ */
+export declare function resolvePdfOptions(docPdf?: PdfDocumentOptions, appPdf?: PdfOptions): PdfOptions;
+//# sourceMappingURL=config-resolver.d.ts.map

package/dist/config/config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-resolver.d.ts","sourceRoot":"","sources":["../../src/config/config-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,UAAU,CAAC,EAAE,qBAAqB,EAClC,UAAU,CAAC,EAAE,qBAAqB,GACjC,sBAAsB,CAaxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,CAY9F"}

package/dist/config/config-resolver.js

@@ -0,0 +1,41 @@
+import { DEFAULT_PDF_OPTIONS } from '../pdf/default-options.js';
+import { BUILTIN_DEFAULT_DIAGRAM_OPTIONS, } from './document-options.js';
+/**
+ * Resolves diagram options following the strict precedence hierarchy:
+ * 1. Code block individual attribute (RawDiagramOptions)
+ * 2. Document Front Matter (DiagramDefaultOptions)
+ * 3. Application default (DiagramDefaultOptions)
+ * 4. Built-in system default (fit: 'contain', align: 'center')
+ */
+export function resolveDiagramOptions(raw, docDefault, appDefault) {
+    const width = raw.width ?? docDefault?.width ?? appDefault?.width ?? undefined;
+    const height = raw.height ?? docDefault?.height ?? appDefault?.height ?? undefined;
+    const fit = raw.fit ?? docDefault?.fit ?? appDefault?.fit ?? BUILTIN_DEFAULT_DIAGRAM_OPTIONS.fit;
+    const align = raw.align ?? docDefault?.align ?? appDefault?.align ?? BUILTIN_DEFAULT_DIAGRAM_OPTIONS.align;
+    return {
+        width,
+        height,
+        fit,
+        align,
+    };
+}
+/**
+ * Resolves PDF rendering options following the precedence hierarchy:
+ * 1. Application-level options (e.g. CLI flag / API argument)
+ * 2. Document Front Matter (PdfDocumentOptions)
+ * 3. Built-in system default (A4, portrait, 15mm margins, printBackground: true)
+ */
+export function resolvePdfOptions(docPdf, appPdf) {
+    return {
+        format: appPdf?.format ?? docPdf?.format ?? DEFAULT_PDF_OPTIONS.format,
+        landscape: appPdf?.landscape ?? docPdf?.landscape ?? DEFAULT_PDF_OPTIONS.landscape,
+        printBackground: appPdf?.printBackground ?? DEFAULT_PDF_OPTIONS.printBackground,
+        margin: {
+            top: appPdf?.margin?.top ?? docPdf?.margin?.top ?? DEFAULT_PDF_OPTIONS.margin.top,
+            right: appPdf?.margin?.right ?? docPdf?.margin?.right ?? DEFAULT_PDF_OPTIONS.margin.right,
+            bottom: appPdf?.margin?.bottom ?? docPdf?.margin?.bottom ?? DEFAULT_PDF_OPTIONS.margin.bottom,
+            left: appPdf?.margin?.left ?? docPdf?.margin?.left ?? DEFAULT_PDF_OPTIONS.margin.left,
+        },
+    };
+}
+//# sourceMappingURL=config-resolver.js.map

package/dist/config/config-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-resolver.js","sourceRoot":"","sources":["../../src/config/config-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EACL,+BAA+B,GAGhC,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAsB,EACtB,UAAkC,EAClC,UAAkC;IAElC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,UAAU,EAAE,KAAK,IAAI,UAAU,EAAE,KAAK,IAAI,SAAS,CAAC;IAC/E,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,UAAU,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,IAAI,SAAS,CAAC;IACnF,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,UAAU,EAAE,GAAG,IAAI,UAAU,EAAE,GAAG,IAAI,+BAA+B,CAAC,GAAG,CAAC;IACjG,MAAM,KAAK,GACT,GAAG,CAAC,KAAK,IAAI,UAAU,EAAE,KAAK,IAAI,UAAU,EAAE,KAAK,IAAI,+BAA+B,CAAC,KAAK,CAAC;IAE/F,OAAO;QACL,KAAK;QACL,MAAM;QACN,GAAG;QACH,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA2B,EAAE,MAAmB;IAChF,OAAO;QACL,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM;QACtE,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,MAAM,EAAE,SAAS,IAAI,mBAAmB,CAAC,SAAS;QAClF,eAAe,EAAE,MAAM,EAAE,eAAe,IAAI,mBAAmB,CAAC,eAAe;QAC/E,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,GAAG;YACjF,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,mBAAmB,CAAC,MAAM,CAAC,KAAK;YACzF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,MAAM;YAC7F,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI;SACtF;KACF,CAAC;AACJ,CAAC"}

package/dist/config/document-options.d.ts

@@ -0,0 +1,52 @@
+import type { DiagramAlign, DiagramFit, ResolvedDiagramOptions } from '../types/diagram.js';
+export interface PdfMarginOptions {
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+}
+export interface PdfDocumentOptions {
+    format?: 'A4';
+    landscape?: boolean;
+    margin?: PdfMarginOptions;
+}
+export interface DiagramDefaultOptions {
+    width?: string;
+    height?: string;
+    fit?: DiagramFit;
+    align?: DiagramAlign;
+}
+export interface MermaidDocumentOptions {
+    theme?: string;
+}
+export interface PlantUmlDocumentOptions {
+    javaPath?: string;
+    jarPath?: string;
+}
+export interface GoogleFontFamily {
+    name: string;
+    weights?: number[];
+}
+export interface GoogleFontsOptions {
+    families: GoogleFontFamily[];
+}
+export interface FontOptions {
+    family?: string;
+    codeFamily?: string;
+    google?: GoogleFontsOptions;
+}
+export interface StyleDocumentOptions {
+    font?: FontOptions;
+}
+export interface DocumentOptions {
+    pdf?: PdfDocumentOptions;
+    diagram?: DiagramDefaultOptions;
+    mermaid?: MermaidDocumentOptions;
+    plantuml?: PlantUmlDocumentOptions;
+    style?: StyleDocumentOptions;
+}
+/**
+ * Built-in default options for diagrams.
+ */
+export declare const BUILTIN_DEFAULT_DIAGRAM_OPTIONS: Readonly<ResolvedDiagramOptions>;
+//# sourceMappingURL=document-options.d.ts.map

package/dist/config/document-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-options.d.ts","sourceRoot":"","sources":["../../src/config/document-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,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,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,sBAAsB,CAG5E,CAAC"}

package/dist/config/document-options.js

@@ -0,0 +1,8 @@
+/**
+ * Built-in default options for diagrams.
+ */
+export const BUILTIN_DEFAULT_DIAGRAM_OPTIONS = {
+    fit: 'contain',
+    align: 'center',
+};
+//# sourceMappingURL=document-options.js.map

package/dist/config/document-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-options.js","sourceRoot":"","sources":["../../src/config/document-options.ts"],"names":[],"mappings":"AA0DA;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAqC;IAC/E,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,QAAQ;CAChB,CAAC"}

package/dist/config/error.d.ts

@@ -0,0 +1,12 @@
+export interface FrontMatterErrorOptions {
+    path?: string;
+    cause?: unknown;
+}
+/**
+ * Thrown when YAML Front Matter has syntax errors or invalid configuration values.
+ */
+export declare class FrontMatterError extends Error {
+    readonly path?: string;
+    constructor(message: string, options?: FrontMatterErrorOptions);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/config/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/config/error.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;CAK/D"}

package/dist/config/error.js

@@ -0,0 +1,12 @@
+/**
+ * Thrown when YAML Front Matter has syntax errors or invalid configuration values.
+ */
+export class FrontMatterError extends Error {
+    path;
+    constructor(message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'FrontMatterError';
+        this.path = options?.path;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/config/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/config/error.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzB,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/config/frontmatter-parser.d.ts

@@ -0,0 +1,16 @@
+import type { DocumentOptions } from './document-options.js';
+export interface ParsedFrontMatter {
+    content: string;
+    options: DocumentOptions;
+    rawFrontMatter?: string;
+}
+/**
+ * Extracts and validates YAML Front Matter from Markdown source text.
+ * Strips the Front Matter block from the returned content.
+ *
+ * @param source Raw Markdown document text
+ * @returns Parsed content and validated DocumentOptions
+ * @throws {FrontMatterError} On YAML syntax errors or invalid configuration values
+ */
+export declare function parseFrontMatter(source: string): ParsedFrontMatter;
+//# sourceMappingURL=frontmatter-parser.d.ts.map

package/dist/config/frontmatter-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.d.ts","sourceRoot":"","sources":["../../src/config/frontmatter-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,eAAe,EAQhB,MAAM,uBAAuB,CAAC;AAgU/B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAqElE"}