pdf-smith 0.1.0

package/dist/server.cjs

@@ -0,0 +1,246 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/export.ts
+async function exportPDF(options) {
+  const { root, output, pageNumbers, pages } = options;
+  const outputPath = import_node_path.default.resolve(root, output ?? "./output.pdf");
+  import_node_fs.default.mkdirSync(import_node_path.default.dirname(outputPath), { recursive: true });
+  let playwright;
+  try {
+    playwright = await import("playwright");
+  } catch {
+    throw new Error(
+      "Playwright is required for PDF export. Install it with: npm install -D playwright && npx playwright install chromium"
+    );
+  }
+  const { startPreview: startPreview2 } = await Promise.resolve().then(() => (init_server(), server_exports));
+  const server = await startPreview2({ root, port: 0, pages, open: false });
+  const browser = await playwright.chromium.launch({ headless: true });
+  try {
+    const page = await browser.newPage();
+    await page.goto(server.url, { waitUntil: "networkidle" });
+    await page.waitForSelector("[data-pdf-smith-page]", { timeout: 3e4 });
+    const margin = { top: "0", bottom: "0", left: "0", right: "0" };
+    const pdfOptions = {
+      path: outputPath,
+      preferCSSPageSize: true,
+      printBackground: true,
+      margin
+    };
+    if (pageNumbers?.enabled) {
+      pdfOptions.displayHeaderFooter = true;
+      pdfOptions.headerTemplate = "<span></span>";
+      pdfOptions.footerTemplate = pageNumbers.template ?? '<div style="font-size:10px;text-align:center;width:100%;"><span class="pageNumber"></span> / <span class="totalPages"></span></div>';
+      margin.bottom = "40px";
+    }
+    await page.pdf(pdfOptions);
+  } finally {
+    await browser.close().catch(() => {
+    });
+    await server.close().catch(() => {
+    });
+  }
+  return { outputPath };
+}
+var import_node_fs, import_node_path;
+var init_export = __esm({
+  "src/export.ts"() {
+    "use strict";
+    import_node_fs = __toESM(require("fs"), 1);
+    import_node_path = __toESM(require("path"), 1);
+  }
+});
+
+// src/preview/preview-plugin.ts
+var preview_plugin_exports = {};
+__export(preview_plugin_exports, {
+  pdfSmithPreviewPlugin: () => pdfSmithPreviewPlugin
+});
+function pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob }) {
+  return {
+    name: "pdf-smith-preview",
+    configureServer(server) {
+      return () => {
+        server.middlewares.use((req, res, next) => {
+          if (req.url !== "/" && req.url !== "/index.html") {
+            next();
+            return;
+          }
+          const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <script type="module">
+import RefreshRuntime from "/@react-refresh"
+RefreshRuntime.injectIntoGlobalHook(window)
+window.$RefreshReg$ = () => {}
+window.$RefreshSig$ = () => (type) => type
+window.__vite_plugin_react_preamble_installed__ = true
+</script>
+  <script type="module" src="/@vite/client"></script>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>pdf-smith Preview</title>
+  <style>
+    @media print {
+      [data-pdf-smith-nav] { display: none !important; }
+      [data-pdf-smith-container] {
+        margin-left: 0 !important;
+        padding: 0 !important;
+        background: none !important;
+      }
+      [data-pdf-smith-container] > [data-pdf-smith-document] > div {
+        margin-bottom: 0 !important;
+      }
+      [data-pdf-smith-container] > [data-pdf-smith-document] > div > div:first-child {
+        display: none !important;
+      }
+    }
+  </style>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="/@fs/${pkgSrcDir}/preview/entry.tsx"></script>
+</body>
+</html>`;
+          res.setHeader("Content-Type", "text/html");
+          res.statusCode = 200;
+          res.end(html);
+        });
+      };
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_PAGES_ID) {
+        return RESOLVED_VIRTUAL_PAGES_ID;
+      }
+    },
+    load(id) {
+      if (id === RESOLVED_VIRTUAL_PAGES_ID) {
+        return `
+const modules = import.meta.glob('${pagesGlob}', { eager: true });
+
+export function getPages() {
+  const pages = {};
+  for (const [path, mod] of Object.entries(modules)) {
+    const name = path
+      .replace(/^\\/pages\\//, '')
+      .replace(/\\.[^.]+$/, '');
+    pages[name] = mod.default;
+  }
+  return pages;
+}
+`;
+      }
+    }
+  };
+}
+var VIRTUAL_PAGES_ID, RESOLVED_VIRTUAL_PAGES_ID;
+var init_preview_plugin = __esm({
+  "src/preview/preview-plugin.ts"() {
+    "use strict";
+    VIRTUAL_PAGES_ID = "virtual:pdf-smith-pages";
+    RESOLVED_VIRTUAL_PAGES_ID = `\0${VIRTUAL_PAGES_ID}`;
+  }
+});
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  exportPDF: () => exportPDF,
+  startPreview: () => startPreview
+});
+module.exports = __toCommonJS(server_exports);
+async function startPreview(options) {
+  const { root, port = 3e3, pages = "/pages/**/*.tsx", open = false } = options;
+  const { createServer } = await import("vite");
+  const react = (await import("@vitejs/plugin-react")).default;
+  const tailwindcss = (await import("@tailwindcss/vite")).default;
+  const { pdfSmithPreviewPlugin: pdfSmithPreviewPlugin2 } = await Promise.resolve().then(() => (init_preview_plugin(), preview_plugin_exports));
+  const currentDir = import_node_path2.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url));
+  const pkgRoot = import_node_path2.default.resolve(currentDir, "..");
+  const pkgSrcDir = import_node_path2.default.resolve(pkgRoot, "src");
+  const server = await createServer({
+    configFile: false,
+    appType: "custom",
+    root,
+    server: {
+      port,
+      strictPort: port !== 0,
+      open,
+      fs: {
+        allow: [root, pkgSrcDir, pkgRoot]
+      }
+    },
+    resolve: {
+      alias: {
+        "pdf-smith": import_node_path2.default.resolve(pkgSrcDir, "index.ts")
+      },
+      dedupe: ["react", "react-dom"]
+    },
+    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin2({ pkgSrcDir, pagesGlob: pages })],
+    optimizeDeps: {
+      include: ["react", "react-dom", "react-dom/client", "react/jsx-runtime"]
+    }
+  });
+  await server.listen();
+  if (port !== 0) {
+    server.printUrls();
+  }
+  const address = server.httpServer?.address();
+  const resolvedPort = address?.port ?? port;
+  const url = `http://localhost:${resolvedPort}`;
+  return {
+    close: async () => {
+      const httpServer = server.httpServer;
+      httpServer?.closeAllConnections?.();
+      await server.close();
+    },
+    port: resolvedPort,
+    url
+  };
+}
+var import_node_path2, import_node_url, import_meta;
+var init_server = __esm({
+  "src/server.ts"() {
+    import_node_path2 = __toESM(require("path"), 1);
+    import_node_url = require("url");
+    init_export();
+    import_meta = {};
+  }
+});
+init_server();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  exportPDF,
+  startPreview
+});
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/export.ts","../src/preview/preview-plugin.ts","../src/server.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport type { ExportOptions, ExportResult } from './export-types';\n\nexport async function exportPDF(options: ExportOptions): Promise<ExportResult> {\n  const { root, output, pageNumbers, pages } = options;\n  const outputPath = path.resolve(root, output ?? './output.pdf');\n\n  fs.mkdirSync(path.dirname(outputPath), { recursive: true });\n\n  let playwright: typeof import('playwright');\n  try {\n    playwright = await import('playwright');\n  } catch {\n    throw new Error(\n      'Playwright is required for PDF export. Install it with: npm install -D playwright && npx playwright install chromium',\n    );\n  }\n\n  const { startPreview } = await import('./server');\n  const server = await startPreview({ root, port: 0, pages, open: false });\n\n  const browser = await playwright.chromium.launch({ headless: true });\n  try {\n    const page = await browser.newPage();\n    await page.goto(server.url, { waitUntil: 'networkidle' });\n    await page.waitForSelector('[data-pdf-smith-page]', { timeout: 30_000 });\n\n    const margin = { top: '0', bottom: '0', left: '0', right: '0' };\n\n    const pdfOptions: Parameters<typeof page.pdf>[0] = {\n      path: outputPath,\n      preferCSSPageSize: true,\n      printBackground: true,\n      margin,\n    };\n\n    if (pageNumbers?.enabled) {\n      pdfOptions.displayHeaderFooter = true;\n      pdfOptions.headerTemplate = '<span></span>';\n      pdfOptions.footerTemplate =\n        pageNumbers.template ??\n        '<div style=\"font-size:10px;text-align:center;width:100%;\"><span class=\"pageNumber\"></span> / <span class=\"totalPages\"></span></div>';\n      margin.bottom = '40px';\n    }\n\n    await page.pdf(pdfOptions);\n  } finally {\n    await browser.close().catch(() => {});\n    await server.close().catch(() => {});\n  }\n\n  return { outputPath };\n}\n","import type { Plugin } from 'vite';\n\nconst VIRTUAL_PAGES_ID = 'virtual:pdf-smith-pages';\nconst RESOLVED_VIRTUAL_PAGES_ID = `\\0${VIRTUAL_PAGES_ID}`;\n\ninterface PreviewPluginOptions {\n  pkgSrcDir: string;\n  pagesGlob: string;\n}\n\nexport function pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob }: PreviewPluginOptions): Plugin {\n  return {\n    name: 'pdf-smith-preview',\n\n    configureServer(server) {\n      return () => {\n        server.middlewares.use((req, res, next) => {\n          if (req.url !== '/' && req.url !== '/index.html') {\n            next();\n            return;\n          }\n\n          const html = `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <script type=\"module\">\nimport RefreshRuntime from \"/@react-refresh\"\nRefreshRuntime.injectIntoGlobalHook(window)\nwindow.$RefreshReg$ = () => {}\nwindow.$RefreshSig$ = () => (type) => type\nwindow.__vite_plugin_react_preamble_installed__ = true\n</script>\n  <script type=\"module\" src=\"/@vite/client\"></script>\n  <meta charset=\"UTF-8\" />\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n  <title>pdf-smith Preview</title>\n  <style>\n    @media print {\n      [data-pdf-smith-nav] { display: none !important; }\n      [data-pdf-smith-container] {\n        margin-left: 0 !important;\n        padding: 0 !important;\n        background: none !important;\n      }\n      [data-pdf-smith-container] > [data-pdf-smith-document] > div {\n        margin-bottom: 0 !important;\n      }\n      [data-pdf-smith-container] > [data-pdf-smith-document] > div > div:first-child {\n        display: none !important;\n      }\n    }\n  </style>\n</head>\n<body>\n  <div id=\"root\"></div>\n  <script type=\"module\" src=\"/@fs/${pkgSrcDir}/preview/entry.tsx\"></script>\n</body>\n</html>`;\n\n          res.setHeader('Content-Type', 'text/html');\n          res.statusCode = 200;\n          res.end(html);\n        });\n      };\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_PAGES_ID) {\n        return RESOLVED_VIRTUAL_PAGES_ID;\n      }\n    },\n\n    load(id) {\n      if (id === RESOLVED_VIRTUAL_PAGES_ID) {\n        return `\nconst modules = import.meta.glob('${pagesGlob}', { eager: true });\n\nexport function getPages() {\n  const pages = {};\n  for (const [path, mod] of Object.entries(modules)) {\n    const name = path\n      .replace(/^\\\\/pages\\\\//, '')\n      .replace(/\\\\.[^.]+$/, '');\n    pages[name] = mod.default;\n  }\n  return pages;\n}\n`;\n      }\n    },\n  };\n}\n","import type { AddressInfo } from 'node:net';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport { exportPDF } from './export';\nexport type { ExportOptions, ExportResult } from './export-types';\nexport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport async function startPreview(options: PreviewOptions): Promise<PreviewServer> {\n  const { root, port = 3000, pages = '/pages/**/*.tsx', open = false } = options;\n\n  const { createServer } = await import('vite');\n  const react = (await import('@vitejs/plugin-react')).default;\n  const tailwindcss = (await import('@tailwindcss/vite')).default;\n  const { pdfSmithPreviewPlugin } = await import('./preview/preview-plugin');\n\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  const pkgRoot = path.resolve(currentDir, '..');\n  const pkgSrcDir = path.resolve(pkgRoot, 'src');\n\n  const server = await createServer({\n    configFile: false,\n    appType: 'custom',\n    root,\n    server: {\n      port,\n      strictPort: port !== 0,\n      open,\n      fs: {\n        allow: [root, pkgSrcDir, pkgRoot],\n      },\n    },\n    resolve: {\n      alias: {\n        'pdf-smith': path.resolve(pkgSrcDir, 'index.ts'),\n      },\n      dedupe: ['react', 'react-dom'],\n    },\n    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob: pages })],\n    optimizeDeps: {\n      include: ['react', 'react-dom', 'react-dom/client', 'react/jsx-runtime'],\n    },\n  });\n\n  await server.listen();\n\n  if (port !== 0) {\n    server.printUrls();\n  }\n\n  const address = server.httpServer?.address() as AddressInfo | null;\n  const resolvedPort = address?.port ?? port;\n  const url = `http://localhost:${resolvedPort}`;\n\n  return {\n    close: async () => {\n      const httpServer = server.httpServer as { closeAllConnections?: () => void } | null;\n      httpServer?.closeAllConnections?.();\n      await server.close();\n    },\n    port: resolvedPort,\n    url,\n  };\n}\n"],"mappings":"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","names":["path","fs","startPreview","pdfSmithPreviewPlugin","path","import_node_path"]}

package/dist/server.d.cts

@@ -0,0 +1,33 @@
+interface PreviewOptions {
+    /** User's project root (absolute path) */
+    root: string;
+    /** Dev server port (default: 3000) */
+    port?: number;
+    pages?: string;
+    /** Auto-open browser (default: false) */
+    open?: boolean;
+}
+interface PreviewServer {
+    close(): Promise<void>;
+    port: number;
+    url: string;
+}
+
+interface ExportOptions {
+    root: string;
+    output?: string;
+    pageNumbers?: {
+        enabled: boolean;
+        template?: string;
+    };
+    pages?: string;
+}
+interface ExportResult {
+    outputPath: string;
+}
+
+declare function exportPDF(options: ExportOptions): Promise<ExportResult>;
+
+declare function startPreview(options: PreviewOptions): Promise<PreviewServer>;
+
+export { type ExportOptions, type ExportResult, type PreviewOptions, type PreviewServer, exportPDF, startPreview };

package/dist/server.d.ts

@@ -0,0 +1,33 @@
+interface PreviewOptions {
+    /** User's project root (absolute path) */
+    root: string;
+    /** Dev server port (default: 3000) */
+    port?: number;
+    pages?: string;
+    /** Auto-open browser (default: false) */
+    open?: boolean;
+}
+interface PreviewServer {
+    close(): Promise<void>;
+    port: number;
+    url: string;
+}
+
+interface ExportOptions {
+    root: string;
+    output?: string;
+    pageNumbers?: {
+        enabled: boolean;
+        template?: string;
+    };
+    pages?: string;
+}
+interface ExportResult {
+    outputPath: string;
+}
+
+declare function exportPDF(options: ExportOptions): Promise<ExportResult>;
+
+declare function startPreview(options: PreviewOptions): Promise<PreviewServer>;
+
+export { type ExportOptions, type ExportResult, type PreviewOptions, type PreviewServer, exportPDF, startPreview };

package/dist/server.js

@@ -0,0 +1,104 @@
+// src/server.ts
+import path2 from "path";
+import { fileURLToPath } from "url";
+
+// src/export.ts
+import fs from "fs";
+import path from "path";
+async function exportPDF(options) {
+  const { root, output, pageNumbers, pages } = options;
+  const outputPath = path.resolve(root, output ?? "./output.pdf");
+  fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+  let playwright;
+  try {
+    playwright = await import("playwright");
+  } catch {
+    throw new Error(
+      "Playwright is required for PDF export. Install it with: npm install -D playwright && npx playwright install chromium"
+    );
+  }
+  const { startPreview: startPreview2 } = await import("./server.js");
+  const server = await startPreview2({ root, port: 0, pages, open: false });
+  const browser = await playwright.chromium.launch({ headless: true });
+  try {
+    const page = await browser.newPage();
+    await page.goto(server.url, { waitUntil: "networkidle" });
+    await page.waitForSelector("[data-pdf-smith-page]", { timeout: 3e4 });
+    const margin = { top: "0", bottom: "0", left: "0", right: "0" };
+    const pdfOptions = {
+      path: outputPath,
+      preferCSSPageSize: true,
+      printBackground: true,
+      margin
+    };
+    if (pageNumbers?.enabled) {
+      pdfOptions.displayHeaderFooter = true;
+      pdfOptions.headerTemplate = "<span></span>";
+      pdfOptions.footerTemplate = pageNumbers.template ?? '<div style="font-size:10px;text-align:center;width:100%;"><span class="pageNumber"></span> / <span class="totalPages"></span></div>';
+      margin.bottom = "40px";
+    }
+    await page.pdf(pdfOptions);
+  } finally {
+    await browser.close().catch(() => {
+    });
+    await server.close().catch(() => {
+    });
+  }
+  return { outputPath };
+}
+
+// src/server.ts
+async function startPreview(options) {
+  const { root, port = 3e3, pages = "/pages/**/*.tsx", open = false } = options;
+  const { createServer } = await import("vite");
+  const react = (await import("@vitejs/plugin-react")).default;
+  const tailwindcss = (await import("@tailwindcss/vite")).default;
+  const { pdfSmithPreviewPlugin } = await import("./preview-plugin-QWJEXDW2.js");
+  const currentDir = path2.dirname(fileURLToPath(import.meta.url));
+  const pkgRoot = path2.resolve(currentDir, "..");
+  const pkgSrcDir = path2.resolve(pkgRoot, "src");
+  const server = await createServer({
+    configFile: false,
+    appType: "custom",
+    root,
+    server: {
+      port,
+      strictPort: port !== 0,
+      open,
+      fs: {
+        allow: [root, pkgSrcDir, pkgRoot]
+      }
+    },
+    resolve: {
+      alias: {
+        "pdf-smith": path2.resolve(pkgSrcDir, "index.ts")
+      },
+      dedupe: ["react", "react-dom"]
+    },
+    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob: pages })],
+    optimizeDeps: {
+      include: ["react", "react-dom", "react-dom/client", "react/jsx-runtime"]
+    }
+  });
+  await server.listen();
+  if (port !== 0) {
+    server.printUrls();
+  }
+  const address = server.httpServer?.address();
+  const resolvedPort = address?.port ?? port;
+  const url = `http://localhost:${resolvedPort}`;
+  return {
+    close: async () => {
+      const httpServer = server.httpServer;
+      httpServer?.closeAllConnections?.();
+      await server.close();
+    },
+    port: resolvedPort,
+    url
+  };
+}
+export {
+  exportPDF,
+  startPreview
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/export.ts"],"sourcesContent":["import type { AddressInfo } from 'node:net';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport { exportPDF } from './export';\nexport type { ExportOptions, ExportResult } from './export-types';\nexport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport async function startPreview(options: PreviewOptions): Promise<PreviewServer> {\n  const { root, port = 3000, pages = '/pages/**/*.tsx', open = false } = options;\n\n  const { createServer } = await import('vite');\n  const react = (await import('@vitejs/plugin-react')).default;\n  const tailwindcss = (await import('@tailwindcss/vite')).default;\n  const { pdfSmithPreviewPlugin } = await import('./preview/preview-plugin');\n\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  const pkgRoot = path.resolve(currentDir, '..');\n  const pkgSrcDir = path.resolve(pkgRoot, 'src');\n\n  const server = await createServer({\n    configFile: false,\n    appType: 'custom',\n    root,\n    server: {\n      port,\n      strictPort: port !== 0,\n      open,\n      fs: {\n        allow: [root, pkgSrcDir, pkgRoot],\n      },\n    },\n    resolve: {\n      alias: {\n        'pdf-smith': path.resolve(pkgSrcDir, 'index.ts'),\n      },\n      dedupe: ['react', 'react-dom'],\n    },\n    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob: pages })],\n    optimizeDeps: {\n      include: ['react', 'react-dom', 'react-dom/client', 'react/jsx-runtime'],\n    },\n  });\n\n  await server.listen();\n\n  if (port !== 0) {\n    server.printUrls();\n  }\n\n  const address = server.httpServer?.address() as AddressInfo | null;\n  const resolvedPort = address?.port ?? port;\n  const url = `http://localhost:${resolvedPort}`;\n\n  return {\n    close: async () => {\n      const httpServer = server.httpServer as { closeAllConnections?: () => void } | null;\n      httpServer?.closeAllConnections?.();\n      await server.close();\n    },\n    port: resolvedPort,\n    url,\n  };\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { ExportOptions, ExportResult } from './export-types';\n\nexport async function exportPDF(options: ExportOptions): Promise<ExportResult> {\n  const { root, output, pageNumbers, pages } = options;\n  const outputPath = path.resolve(root, output ?? './output.pdf');\n\n  fs.mkdirSync(path.dirname(outputPath), { recursive: true });\n\n  let playwright: typeof import('playwright');\n  try {\n    playwright = await import('playwright');\n  } catch {\n    throw new Error(\n      'Playwright is required for PDF export. Install it with: npm install -D playwright && npx playwright install chromium',\n    );\n  }\n\n  const { startPreview } = await import('./server');\n  const server = await startPreview({ root, port: 0, pages, open: false });\n\n  const browser = await playwright.chromium.launch({ headless: true });\n  try {\n    const page = await browser.newPage();\n    await page.goto(server.url, { waitUntil: 'networkidle' });\n    await page.waitForSelector('[data-pdf-smith-page]', { timeout: 30_000 });\n\n    const margin = { top: '0', bottom: '0', left: '0', right: '0' };\n\n    const pdfOptions: Parameters<typeof page.pdf>[0] = {\n      path: outputPath,\n      preferCSSPageSize: true,\n      printBackground: true,\n      margin,\n    };\n\n    if (pageNumbers?.enabled) {\n      pdfOptions.displayHeaderFooter = true;\n      pdfOptions.headerTemplate = '<span></span>';\n      pdfOptions.footerTemplate =\n        pageNumbers.template ??\n        '<div style=\"font-size:10px;text-align:center;width:100%;\"><span class=\"pageNumber\"></span> / <span class=\"totalPages\"></span></div>';\n      margin.bottom = '40px';\n    }\n\n    await page.pdf(pdfOptions);\n  } finally {\n    await browser.close().catch(() => {});\n    await server.close().catch(() => {});\n  }\n\n  return { outputPath };\n}\n"],"mappings":"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","names":["path","startPreview","path"]}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "pdf-smith",
+  "version": "0.1.0",
+  "description": "Build beautiful PDFs with React components and Tailwind CSS",
+  "author": "Kareem Elbahrawy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kareemaly/pdf-smith.git",
+    "directory": "packages/pdf-smith"
+  },
+  "homepage": "https://github.com/kareemaly/pdf-smith",
+  "keywords": [
+    "pdf",
+    "react",
+    "tailwind",
+    "vite",
+    "playwright",
+    "pdf-generation",
+    "react-pdf"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src/preview/",
+    "src/index.ts",
+    "src/page.tsx",
+    "src/document.tsx",
+    "src/types.ts",
+    "src/constants.ts",
+    "src/styles.ts"
+  ],
+  "dependencies": {
+    "vite": "^7.0.0",
+    "@vitejs/plugin-react": "^5.0.0",
+    "@tailwindcss/vite": "^4.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.2.4",
+    "tsup": "^8.5.1"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "playwright": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "playwright": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,11 @@
+import type { PageDimensions, PageSizePreset } from './types';
+
+export const PAGE_SIZES: Record<PageSizePreset, PageDimensions> = {
+  A4: { width: 210, height: 297 },
+  Letter: { width: 215.9, height: 279.4 },
+  A3: { width: 297, height: 420 },
+};
+
+export const DEFAULT_PADDING = 0;
+
+export const DEFAULT_PAGE_SIZE: PageSizePreset = 'A4';

package/src/document.tsx

@@ -0,0 +1,15 @@
+import { PAGE_SIZES } from './constants';
+import { getDocumentStyleSheet } from './styles';
+import type { DocumentProps } from './types';
+
+export function Document({ children, className }: DocumentProps): React.ReactElement {
+  const styleSheet = getDocumentStyleSheet(PAGE_SIZES.A4);
+
+  return (
+    <div data-pdf-smith-document="" className={className}>
+      {/* biome-ignore lint/security/noDangerouslySetInnerHtml: trusted internal CSS */}
+      <style dangerouslySetInnerHTML={{ __html: styleSheet }} />
+      {children}
+    </div>
+  );
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+export { DEFAULT_PADDING, DEFAULT_PAGE_SIZE, PAGE_SIZES } from './constants';
+export { Document } from './document';
+export { Page } from './page';
+export type {
+  DocumentProps,
+  PageDimensions,
+  PagePadding,
+  PageProps,
+  PageSize,
+  PageSizePreset,
+} from './types';

package/src/page.tsx

@@ -0,0 +1,35 @@
+import { DEFAULT_PADDING, DEFAULT_PAGE_SIZE, PAGE_SIZES } from './constants';
+import { getPageStyle, resolvePadding } from './styles';
+import type { PageDimensions, PageProps, PageSize } from './types';
+
+function resolveSize(size: PageSize): PageDimensions {
+  if (typeof size === 'string') {
+    return PAGE_SIZES[size];
+  }
+  return size;
+}
+
+export function Page({
+  children,
+  className,
+  size = DEFAULT_PAGE_SIZE,
+  padding = DEFAULT_PADDING,
+  id,
+}: PageProps): React.ReactElement {
+  const dimensions = resolveSize(size);
+  const resolvedPadding = resolvePadding(padding);
+  const style = getPageStyle(dimensions, resolvedPadding);
+
+  return (
+    <div
+      data-pdf-smith-page=""
+      data-page-width={dimensions.width}
+      data-page-height={dimensions.height}
+      className={className}
+      id={id}
+      style={style}
+    >
+      {children}
+    </div>
+  );
+}

package/src/preview/app.tsx

@@ -0,0 +1,52 @@
+import { getPages } from 'virtual:pdf-smith-pages';
+import { useState } from 'react';
+import { Document } from '../document';
+import { Page } from '../page';
+import { Navigation } from './navigation';
+
+const containerStyle: React.CSSProperties = {
+  marginLeft: '240px',
+  minHeight: '100vh',
+  background: '#e8e8e8',
+  padding: '32px',
+  boxSizing: 'border-box',
+};
+
+const pageWrapperStyle: React.CSSProperties = {
+  marginBottom: '24px',
+};
+
+const pageLabelStyle: React.CSSProperties = {
+  fontFamily: 'system-ui, -apple-system, sans-serif',
+  fontSize: '12px',
+  color: '#666',
+  marginBottom: '8px',
+  marginLeft: 'auto',
+  marginRight: 'auto',
+  width: 'fit-content',
+};
+
+export function PreviewApp() {
+  const pages = getPages();
+  const [activePage, setActivePage] = useState<string | null>(null);
+
+  const visiblePages = activePage ? { [activePage]: pages[activePage] } : pages;
+
+  return (
+    <>
+      <Navigation pages={pages} activePage={activePage} onSelectPage={setActivePage} />
+      <div data-pdf-smith-container="" style={containerStyle}>
+        <Document>
+          {Object.entries(visiblePages).map(([name, PageComponent]) => (
+            <div key={name} style={pageWrapperStyle}>
+              <div style={pageLabelStyle}>{name}</div>
+              <Page>
+                <PageComponent />
+              </Page>
+            </div>
+          ))}
+        </Document>
+      </div>
+    </>
+  );
+}