pretext-pdf 0.8.3 → 0.9.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+/**
+ * pretext-pdf CLI — JSON in, PDF out.
+ *
+ *   pretext-pdf doc.json out.pdf
+ *   pretext-pdf doc.json > out.pdf
+ *   cat doc.json | pretext-pdf > out.pdf
+ *   echo '{"content":[...]}' | pretext-pdf -o out.pdf
+ *
+ * Optional flags:
+ *   -o, --output <path>     Write PDF to path instead of stdout
+ *   -i, --input <path>      Read JSON from path instead of first positional
+ *   --markdown              Treat input as Markdown (requires `marked` peer dep)
+ *       --code-font <name>  Pair with --markdown to enable styled code blocks
+ *   -v, --version           Print pretext-pdf version
+ *   -h, --help              Print this help
+ *
+ * Exit codes:
+ *   0  success
+ *   1  user error (bad arguments, file not found, invalid JSON)
+ *   2  render error (validation, font, image, pagination etc.)
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const HELP = `pretext-pdf v${pkg.version} — JSON → PDF
+
+Usage:
+  pretext-pdf [<input.json>] [<output.pdf>]
+  pretext-pdf -i <input> -o <output>
+  cat doc.json | pretext-pdf > out.pdf
+
+Options:
+  -i, --input <path>     Read JSON (or Markdown with --markdown) from path
+  -o, --output <path>    Write PDF to path (default: stdout)
+      --markdown         Treat input as Markdown — converts via pretext-pdf/markdown
+      --code-font <name> With --markdown, font family for fenced code blocks
+  -v, --version          Print pretext-pdf version
+  -h, --help             Print this help
+
+Examples:
+  pretext-pdf doc.json invoice.pdf
+  echo '{"content":[{"type":"heading","level":1,"text":"Hi"}]}' | pretext-pdf > out.pdf
+  pretext-pdf --markdown --code-font 'Courier New' README.md docs.pdf
+`;
+function parseArgs(argv) {
+    const args = { markdown: false };
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '-h' || a === '--help')
+            return { exit: 0, message: HELP };
+        if (a === '-v' || a === '--version')
+            return { exit: 0, message: pkg.version };
+        if (a === '-i' || a === '--input') {
+            const next = argv[++i];
+            if (!next)
+                return { error: `${a} requires a path argument` };
+            args.inputPath = next;
+            continue;
+        }
+        if (a === '-o' || a === '--output') {
+            const next = argv[++i];
+            if (!next)
+                return { error: `${a} requires a path argument` };
+            args.outputPath = next;
+            continue;
+        }
+        if (a === '--markdown') {
+            args.markdown = true;
+            continue;
+        }
+        if (a === '--code-font') {
+            const next = argv[++i];
+            if (!next)
+                return { error: `${a} requires a font family argument` };
+            args.codeFont = next;
+            continue;
+        }
+        if (a.startsWith('-'))
+            return { error: `unknown option: ${a}` };
+        positional.push(a);
+    }
+    // Positional fallback: first positional is input, second is output
+    if (!args.inputPath && positional[0])
+        args.inputPath = positional[0];
+    if (!args.outputPath && positional[1])
+        args.outputPath = positional[1];
+    if (positional.length > 2)
+        return { error: `too many positional arguments (got ${positional.length}, max 2)` };
+    return args;
+}
+async function readInput(inputPath) {
+    if (inputPath) {
+        const abs = path.resolve(inputPath);
+        try {
+            return await fs.readFile(abs, 'utf-8');
+        }
+        catch (err) {
+            throw new CliError(`failed to read ${inputPath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // stdin
+    if (process.stdin.isTTY) {
+        throw new CliError('no input — pass a file path or pipe JSON to stdin. Run with -h for help.');
+    }
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+async function writeOutput(outputPath, bytes) {
+    if (outputPath) {
+        const abs = path.resolve(outputPath);
+        await fs.writeFile(abs, bytes);
+        return;
+    }
+    // stdout
+    if (process.stdout.isTTY) {
+        throw new CliError('refusing to write binary PDF to a TTY. Pass an output path or redirect (> out.pdf).');
+    }
+    await new Promise((resolve, reject) => {
+        process.stdout.write(Buffer.from(bytes), (err) => (err ? reject(err) : resolve()));
+    });
+}
+class CliError extends Error {
+}
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    if ('exit' in parsed) {
+        process.stdout.write(parsed.message + '\n');
+        return parsed.exit;
+    }
+    if ('error' in parsed) {
+        process.stderr.write(`pretext-pdf: ${parsed.error}\n\n${HELP}`);
+        return 1;
+    }
+    let raw;
+    try {
+        raw = await readInput(parsed.inputPath);
+    }
+    catch (err) {
+        process.stderr.write(`pretext-pdf: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+    // Build the PdfDocument. Either parse as JSON, or convert Markdown.
+    const { render } = await import('./index.js');
+    let doc;
+    if (parsed.markdown) {
+        let markdownToContent;
+        try {
+            ({ markdownToContent } = await import('./markdown.js'));
+        }
+        catch (err) {
+            process.stderr.write(`pretext-pdf: failed to load markdown converter: ${err instanceof Error ? err.message : String(err)}\n`);
+            return 2;
+        }
+        const opts = {};
+        if (parsed.codeFont)
+            opts.codeFontFamily = parsed.codeFont;
+        try {
+            const content = await markdownToContent(raw, opts);
+            doc = { content };
+        }
+        catch (err) {
+            process.stderr.write(`pretext-pdf: markdown conversion failed: ${err instanceof Error ? err.message : String(err)}\n`);
+            return 2;
+        }
+    }
+    else {
+        try {
+            doc = JSON.parse(raw);
+        }
+        catch (err) {
+            process.stderr.write(`pretext-pdf: invalid JSON in input: ${err instanceof Error ? err.message : String(err)}\n`);
+            return 1;
+        }
+    }
+    let pdf;
+    try {
+        pdf = await render(doc);
+    }
+    catch (err) {
+        const code = err?.code ?? 'RENDER_ERROR';
+        process.stderr.write(`pretext-pdf: ${code}: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 2;
+    }
+    try {
+        await writeOutput(parsed.outputPath, pdf);
+    }
+    catch (err) {
+        process.stderr.write(`pretext-pdf: failed to write output: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+    // Success: only print a confirmation when writing to a real file (not stdout).
+    if (parsed.outputPath && !process.env.PRETEXT_PDF_QUIET) {
+        process.stderr.write(`pretext-pdf: wrote ${pdf.byteLength} bytes to ${parsed.outputPath}\n`);
+    }
+    return 0;
+}
+main()
+    .then((code) => process.exit(code))
+    .catch((err) => {
+    process.stderr.write(`pretext-pdf: unexpected error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(2);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compat.d.ts

@@ -0,0 +1,120 @@
+/**
+ * pretext-pdf/compat — translate a pdfmake document descriptor into a
+ * pretext-pdf PdfDocument so existing pdfmake codebases can switch with
+ * a one-line change at the entry point.
+ *
+ *   import { fromPdfmake } from 'pretext-pdf/compat'
+ *   import { render } from 'pretext-pdf'
+ *
+ *   const pdfmakeDoc = { content: [...], styles: {...} }
+ *   const pdf = await render(fromPdfmake(pdfmakeDoc))
+ *
+ * What's translated:
+ *   - pageSize ('A4', 'LETTER', { width, height }), pageOrientation, pageMargins
+ *   - defaultStyle + styles map (style names referenced via { text, style: 'h1' })
+ *   - String content → paragraph
+ *   - { text }            → paragraph or rich-paragraph (depends on inline styling)
+ *   - { ul } / { ol }     → list (recursive)
+ *   - { table: {body, widths, headerRows} } → table
+ *   - { image }           → image
+ *   - { qr, fit }         → qr-code (requires the `qrcode` peer dep at render time)
+ *   - { pageBreak }       → page-break
+ *   - { stack }           → recurse children inline
+ *   - header / footer (string forms only — pdfmake function-style headers are not supported)
+ *
+ * What's NOT translated (skipped, optionally warns):
+ *   - { columns } — flattened into a stack with a console warning
+ *   - { canvas } — drawing primitives are unsupported
+ *   - Function-style headers/footers
+ *   - styles[name].marginX / marginY / decoration
+ *
+ * Heading detection:
+ *   By default style names like 'header', 'h1'..'h4', 'title', 'subheader' map
+ *   to pretext-pdf heading levels 1..4. Override with `options.headingMap`.
+ */
+import type { PdfDocument } from './types.js';
+/** A pdfmake-style document descriptor, stripped to the fields this shim handles. */
+export interface PdfmakeDocument {
+    content: PdfmakeNode | PdfmakeNode[];
+    styles?: Record<string, PdfmakeStyle>;
+    defaultStyle?: PdfmakeStyle;
+    pageSize?: string | {
+        width: number;
+        height: number;
+    };
+    pageOrientation?: 'portrait' | 'landscape';
+    pageMargins?: number | [number, number] | [number, number, number, number];
+    header?: string | {
+        text: string;
+        alignment?: PdfmakeStyle['alignment'];
+        fontSize?: number;
+        color?: string;
+    };
+    footer?: string | {
+        text: string;
+        alignment?: PdfmakeStyle['alignment'];
+        fontSize?: number;
+        color?: string;
+    };
+    info?: {
+        title?: string;
+        author?: string;
+        subject?: string;
+        keywords?: string;
+    };
+}
+export type PdfmakeNode = string | PdfmakeObjectNode;
+export interface PdfmakeObjectNode {
+    text?: string | PdfmakeNode | PdfmakeNode[];
+    style?: string | string[];
+    bold?: boolean;
+    italics?: boolean;
+    color?: string;
+    fontSize?: number;
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+    font?: string;
+    ul?: PdfmakeNode[];
+    ol?: PdfmakeNode[];
+    table?: {
+        body: PdfmakeNode[][];
+        widths?: Array<number | string>;
+        headerRows?: number;
+    };
+    image?: string;
+    width?: number | string;
+    height?: number;
+    qr?: string;
+    fit?: number | [number, number];
+    pageBreak?: 'before' | 'after';
+    stack?: PdfmakeNode[];
+    columns?: PdfmakeNode[];
+    link?: string;
+    canvas?: unknown[];
+}
+export interface PdfmakeStyle {
+    fontSize?: number;
+    bold?: boolean;
+    italics?: boolean;
+    color?: string;
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+    font?: string;
+}
+export interface CompatOptions {
+    /**
+     * Map of pdfmake style names to pretext-pdf heading levels (1–4).
+     * Default: { header: 1, h1: 1, title: 1, subheader: 2, h2: 2, h3: 3, h4: 4 }
+     * Pass `{}` to disable heading detection entirely (everything becomes paragraphs).
+     */
+    headingMap?: Record<string, 1 | 2 | 3 | 4>;
+    /**
+     * Called when a pdfmake feature is encountered that the shim doesn't translate
+     * (canvas, function-style headers, etc.). Default: log a one-time warning.
+     */
+    onUnsupported?: (feature: string) => void;
+}
+/**
+ * Translate a pdfmake document descriptor into a pretext-pdf PdfDocument.
+ * The result can be passed straight to `render()` from the main entry point.
+ */
+export declare function fromPdfmake(doc: PdfmakeDocument, options?: CompatOptions): PdfDocument;
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts.map

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