@akii09/pdfx-cli 0.1.4 → 0.1.6

package/dist/index.js

@@ -492,8 +492,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path11, errorMaps, issueData } = params;
-  const fullPath = [...path11, ...issueData.path || []];
+  const { data, path: path12, errorMaps, issueData } = params;
+  const fullPath = [...path12, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -609,11 +609,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path11, key) {
+  constructor(parent, value, path12, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path11;
+    this._path = path12;
     this._key = key;
   }
   get path() {
@@ -4148,13 +4148,16 @@ var configSchema = external_exports.object({
   registry: external_exports.string().url("registry must be a valid URL"),
   theme: external_exports.string().min(1).optional(),
   /** Directory where templates are installed. Defaults to ./src/templates/pdfx */
-  templateDir: external_exports.string().min(1).optional()
+  templateDir: external_exports.string().min(1).optional(),
+  /** Directory where blocks are installed. Defaults to ./src/blocks/pdfx */
+  blockDir: external_exports.string().min(1).optional()
 });
 var registryFileTypes = [
   "registry:component",
   "registry:lib",
   "registry:style",
-  "registry:template"
+  "registry:template",
+  "registry:block"
 ];
 var registryFileSchema = external_exports.object({
   path: external_exports.string().min(1),
@@ -5089,13 +5092,339 @@ async function add(components, options = {}) {
   }
 }
 
-// src/commands/diff.ts
-import fs4 from "fs";
+// src/commands/block.ts
 import path4 from "path";
 import chalk2 from "chalk";
 import ora2 from "ora";
-var FETCH_TIMEOUT_MS = 1e4;
-async function diff(components) {
+import prompts2 from "prompts";
+
+// src/constants.ts
+var DEFAULTS = {
+  REGISTRY_URL: "https://pdfx.akashpise.dev/r",
+  SCHEMA_URL: "https://pdfx.akashpise.dev/schema.json",
+  COMPONENT_DIR: "./src/components/pdfx",
+  THEME_FILE: "./src/lib/pdfx-theme.ts",
+  TEMPLATE_DIR: "./src/templates/pdfx",
+  BLOCK_DIR: "./src/blocks/pdfx"
+};
+var REGISTRY_SUBPATHS = {
+  TEMPLATES: "templates"
+};
+
+// src/commands/block.ts
+function readConfig2(configPath) {
+  const raw = readJsonFile(configPath);
+  const result = configSchema.safeParse(raw);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => i.message).join(", ");
+    throw new ConfigError(
+      `Invalid pdfx.json: ${issues}`,
+      `Fix the config or re-run ${chalk2.cyan("pdfx init")}`
+    );
+  }
+  return result.data;
+}
+async function fetchBlock(name, registryUrl) {
+  const url = `${registryUrl}/${REGISTRY_SUBPATHS.TEMPLATES}/${name}.json`;
+  let response;
+  try {
+    response = await fetch(url, { signal: AbortSignal.timeout(1e4) });
+  } catch (err) {
+    const isTimeout = err instanceof Error && err.name === "TimeoutError";
+    throw new NetworkError(
+      isTimeout ? "Registry request timed out" : `Could not reach ${registryUrl}`
+    );
+  }
+  if (!response.ok) {
+    throw new RegistryError(
+      response.status === 404 ? `Block "${name}" not found in registry` : `Registry returned HTTP ${response.status}`
+    );
+  }
+  let data;
+  try {
+    data = await response.json();
+  } catch {
+    throw new RegistryError(`Invalid response for "${name}": not valid JSON`);
+  }
+  const result = registryItemSchema.safeParse(data);
+  if (!result.success) {
+    throw new RegistryError(
+      `Invalid registry entry for "${name}": ${result.error.issues[0]?.message}`
+    );
+  }
+  return result.data;
+}
+async function fetchComponent2(name, registryUrl) {
+  const url = `${registryUrl}/${name}.json`;
+  let response;
+  try {
+    response = await fetch(url, { signal: AbortSignal.timeout(1e4) });
+  } catch (err) {
+    const isTimeout = err instanceof Error && err.name === "TimeoutError";
+    throw new NetworkError(
+      isTimeout ? "Registry request timed out" : `Could not reach ${registryUrl}`
+    );
+  }
+  if (!response.ok) {
+    throw new RegistryError(
+      response.status === 404 ? `Component "${name}" not found in registry` : `Registry returned HTTP ${response.status}`
+    );
+  }
+  let data;
+  try {
+    data = await response.json();
+  } catch {
+    throw new RegistryError(`Invalid response for "${name}": not valid JSON`);
+  }
+  const result = registryItemSchema.safeParse(data);
+  if (!result.success) {
+    throw new RegistryError(
+      `Invalid registry entry for "${name}": ${result.error.issues[0]?.message}`
+    );
+  }
+  return result.data;
+}
+function resolveBlockImports(content, blockName, config) {
+  const cwd = process.cwd();
+  const blockSubdir = path4.resolve(cwd, config.blockDir ?? DEFAULTS.BLOCK_DIR, blockName);
+  let result = content.replace(
+    /from '\.\.\/\.\.\/components\/pdfx\/([a-z][a-z0-9-]*)\/pdfx-([a-z][a-z0-9-]*)'/g,
+    (_match, componentName) => {
+      const absCompFile = path4.resolve(
+        cwd,
+        config.componentDir,
+        componentName,
+        `pdfx-${componentName}`
+      );
+      let rel = path4.relative(blockSubdir, absCompFile);
+      if (!rel.startsWith(".")) rel = `./${rel}`;
+      return `from '${rel}'`;
+    }
+  );
+  if (config.theme) {
+    const absThemePath = path4.resolve(cwd, config.theme).replace(/\.tsx?$/, "");
+    let relTheme = path4.relative(blockSubdir, absThemePath);
+    if (!relTheme.startsWith(".")) relTheme = `./${relTheme}`;
+    const absContextPath = path4.join(
+      path4.dirname(path4.resolve(cwd, config.theme)),
+      "pdfx-theme-context"
+    );
+    let relContext = path4.relative(blockSubdir, absContextPath);
+    if (!relContext.startsWith(".")) relContext = `./${relContext}`;
+    result = result.replace(/from '\.\.\/\.\.\/lib\/pdfx-theme'/g, `from '${relTheme}'`);
+    result = result.replace(/from '\.\.\/\.\.\/lib\/pdfx-theme-context'/g, `from '${relContext}'`);
+  }
+  return result;
+}
+async function resolveConflict(fileName, currentDecision) {
+  if (currentDecision === "overwrite-all") return "overwrite-all";
+  const { action } = await prompts2({
+    type: "select",
+    name: "action",
+    message: `${chalk2.yellow(fileName)} already exists. What would you like to do?`,
+    choices: [
+      { title: "Skip", value: "skip", description: "Keep the existing file unchanged" },
+      { title: "Overwrite", value: "overwrite", description: "Replace this file only" },
+      {
+        title: "Overwrite all",
+        value: "overwrite-all",
+        description: "Replace all conflicting files"
+      }
+    ],
+    initial: 0
+  });
+  if (!action) throw new ValidationError("Cancelled by user");
+  return action;
+}
+async function ensurePeerComponents(block, config, force) {
+  const installedPeers = [];
+  const peerWarnings = [];
+  if (!block.peerComponents || block.peerComponents.length === 0) {
+    return { installedPeers, peerWarnings };
+  }
+  const componentBaseDir = path4.resolve(process.cwd(), config.componentDir);
+  for (const componentName of block.peerComponents) {
+    const componentDir = path4.join(componentBaseDir, componentName);
+    const expectedMain = path4.join(componentDir, `pdfx-${componentName}.tsx`);
+    if (checkFileExists(componentDir)) {
+      if (!checkFileExists(expectedMain)) {
+        peerWarnings.push(
+          `${componentName}: directory exists but expected file missing (${path4.basename(expectedMain)})`
+        );
+      } else {
+        peerWarnings.push(
+          `${componentName}: already exists, skipped install (use "pdfx diff ${componentName}" to verify freshness)`
+        );
+      }
+      continue;
+    }
+    const component = await fetchComponent2(componentName, config.registry);
+    ensureDir(componentDir);
+    const componentRelDir = path4.join(config.componentDir, component.name);
+    for (const file of component.files) {
+      const fileName = path4.basename(file.path);
+      const filePath = safePath(componentDir, fileName);
+      let content = file.content;
+      if (config.theme && (content.includes("pdfx-theme") || content.includes("pdfx-theme-context"))) {
+        content = resolveThemeImport(componentRelDir, config.theme, content);
+      }
+      if (checkFileExists(filePath) && !force) {
+        peerWarnings.push(
+          `${componentName}: skipped writing ${fileName} because it already exists (use --force to overwrite)`
+        );
+        continue;
+      }
+      writeFile(filePath, content);
+    }
+    installedPeers.push(componentName);
+  }
+  return { installedPeers, peerWarnings };
+}
+async function installBlock(name, config, force) {
+  const block = await fetchBlock(name, config.registry);
+  const peerResult = await ensurePeerComponents(block, config, force);
+  const blockBaseDir = path4.resolve(process.cwd(), config.blockDir ?? DEFAULTS.BLOCK_DIR);
+  const blockDir = path4.join(blockBaseDir, block.name);
+  ensureDir(blockDir);
+  const filesToWrite = [];
+  for (const file of block.files) {
+    const fileName = path4.basename(file.path);
+    const filePath = safePath(blockDir, fileName);
+    let content = file.content;
+    if (/\.(tsx?|jsx?)$/.test(fileName) && content.includes("../../")) {
+      content = resolveBlockImports(content, block.name, config);
+    }
+    filesToWrite.push({ filePath, content });
+  }
+  if (!force) {
+    let globalDecision = null;
+    const resolved = [];
+    for (const file of filesToWrite) {
+      if (checkFileExists(file.filePath)) {
+        const decision = await resolveConflict(path4.basename(file.filePath), globalDecision);
+        if (decision === "overwrite-all") {
+          globalDecision = "overwrite-all";
+        }
+        resolved.push({ ...file, skip: decision === "skip" });
+      } else {
+        resolved.push({ ...file, skip: false });
+      }
+    }
+    for (const file of resolved) {
+      if (!file.skip) {
+        writeFile(file.filePath, file.content);
+      } else {
+        console.log(chalk2.dim(`  skipped ${path4.basename(file.filePath)}`));
+      }
+    }
+  } else {
+    for (const file of filesToWrite) {
+      writeFile(file.filePath, file.content);
+    }
+  }
+  if (block.peerComponents && block.peerComponents.length > 0) {
+    const componentBaseDir = path4.resolve(process.cwd(), config.componentDir);
+    const missing = [];
+    for (const comp of block.peerComponents) {
+      const compDir = path4.join(componentBaseDir, comp);
+      if (!checkFileExists(compDir)) {
+        missing.push(comp);
+      }
+    }
+    if (missing.length > 0) {
+      console.log();
+      console.log(chalk2.yellow("  Missing peer components:"));
+      for (const comp of missing) {
+        console.log(chalk2.dim(`    ${comp}  \u2192  run: ${chalk2.cyan(`pdfx add ${comp}`)}`));
+      }
+    }
+  }
+  if (config.theme) {
+    const absThemePath = path4.resolve(process.cwd(), config.theme);
+    const contextPath = path4.join(path4.dirname(absThemePath), "pdfx-theme-context.tsx");
+    if (!checkFileExists(contextPath)) {
+      ensureDir(path4.dirname(contextPath));
+      writeFile(contextPath, generateThemeContextFile());
+    }
+  }
+  return peerResult;
+}
+async function blockAdd(names, options = {}) {
+  const configPath = path4.join(process.cwd(), "pdfx.json");
+  if (!checkFileExists(configPath)) {
+    console.error(chalk2.red("Error: pdfx.json not found"));
+    console.log(chalk2.yellow("Run: pdfx init"));
+    process.exit(1);
+  }
+  let config;
+  try {
+    config = readConfig2(configPath);
+  } catch (error) {
+    if (error instanceof ConfigError) {
+      console.error(chalk2.red(error.message));
+      if (error.suggestion) console.log(chalk2.yellow(`  Hint: ${error.suggestion}`));
+    } else {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(chalk2.red(message));
+    }
+    process.exit(1);
+  }
+  const force = options.force ?? false;
+  const failed = [];
+  for (const blockName of names) {
+    const nameResult = componentNameSchema.safeParse(blockName);
+    if (!nameResult.success) {
+      console.error(chalk2.red(`Invalid block name: "${blockName}"`));
+      console.log(
+        chalk2.dim('  Names must be lowercase alphanumeric with hyphens (e.g., "invoice-classic")')
+      );
+      failed.push(blockName);
+      continue;
+    }
+    const spinner = ora2(`Adding block ${blockName}...`).start();
+    try {
+      const result = await installBlock(blockName, config, force);
+      spinner.succeed(`Added block ${chalk2.cyan(blockName)}`);
+      if (result.installedPeers.length > 0) {
+        console.log(
+          chalk2.green(`  Installed required components: ${result.installedPeers.join(", ")}`)
+        );
+      }
+      for (const warning of result.peerWarnings) {
+        console.log(chalk2.yellow(`  Warning: ${warning}`));
+      }
+    } catch (error) {
+      if (error instanceof ValidationError && error.message.includes("Cancelled")) {
+        spinner.info("Cancelled");
+        process.exit(0);
+      } else if (error instanceof NetworkError || error instanceof RegistryError || error instanceof ValidationError) {
+        spinner.fail(error.message);
+        if (error.suggestion) {
+          console.log(chalk2.dim(`  Hint: ${error.suggestion}`));
+        }
+      } else {
+        spinner.fail(`Failed to add block ${blockName}`);
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(chalk2.dim(`  ${message}`));
+      }
+      failed.push(blockName);
+    }
+  }
+  console.log();
+  if (failed.length > 0) {
+    console.log(chalk2.yellow(`Failed: ${failed.join(", ")}`));
+  }
+  if (failed.length < names.length) {
+    const resolvedDir = path4.resolve(process.cwd(), config.blockDir ?? DEFAULTS.BLOCK_DIR);
+    console.log(chalk2.green("Done!"));
+    console.log(chalk2.dim(`Blocks installed to: ${resolvedDir}
+`));
+  }
+  if (failed.length > 0) {
+    process.exit(1);
+  }
+}
+async function blockList() {
   const configPath = path4.join(process.cwd(), "pdfx.json");
   if (!checkFileExists(configPath)) {
     console.error(chalk2.red("Error: pdfx.json not found"));
@@ -5109,14 +5438,85 @@ async function diff(components) {
     process.exit(1);
   }
   const config = configResult.data;
-  const targetDir = path4.resolve(process.cwd(), config.componentDir);
+  const spinner = ora2("Fetching block list...").start();
+  try {
+    let response;
+    try {
+      response = await fetch(`${config.registry}/index.json`, {
+        signal: AbortSignal.timeout(1e4)
+      });
+    } catch (err) {
+      const isTimeout = err instanceof Error && err.name === "TimeoutError";
+      throw new NetworkError(
+        isTimeout ? "Registry request timed out" : `Could not reach ${config.registry}`
+      );
+    }
+    if (!response.ok) {
+      throw new RegistryError(`Registry returned HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    const result = registrySchema.safeParse(data);
+    if (!result.success) {
+      throw new RegistryError("Invalid registry format");
+    }
+    spinner.stop();
+    const blocks = result.data.items.filter((item) => item.type === "registry:block");
+    if (blocks.length === 0) {
+      console.log(chalk2.dim("\n  No blocks available in the registry.\n"));
+      return;
+    }
+    const blockBaseDir = path4.resolve(process.cwd(), config.blockDir ?? DEFAULTS.BLOCK_DIR);
+    console.log(chalk2.bold(`
+  Available Blocks (${blocks.length})
+`));
+    for (const item of blocks) {
+      const blockDir = path4.join(blockBaseDir, item.name);
+      const installed = checkFileExists(blockDir);
+      const status = installed ? chalk2.green("[installed]") : chalk2.dim("[not installed]");
+      console.log(`  ${chalk2.cyan(item.name.padEnd(22))} ${item.description ?? ""}`);
+      console.log(`  ${"".padEnd(22)} ${status}`);
+      if (item.peerComponents && item.peerComponents.length > 0) {
+        console.log(chalk2.dim(`  ${"".padEnd(22)} requires: ${item.peerComponents.join(", ")}`));
+      }
+      console.log();
+    }
+    console.log(chalk2.dim(`  Install with: ${chalk2.cyan("pdfx block add <block-name>")}
+`));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    spinner.fail(message);
+    process.exit(1);
+  }
+}
+
+// src/commands/diff.ts
+import fs4 from "fs";
+import path5 from "path";
+import chalk3 from "chalk";
+import ora3 from "ora";
+var FETCH_TIMEOUT_MS = 1e4;
+async function diff(components) {
+  const configPath = path5.join(process.cwd(), "pdfx.json");
+  if (!checkFileExists(configPath)) {
+    console.error(chalk3.red("Error: pdfx.json not found"));
+    console.log(chalk3.yellow("Run: pdfx init"));
+    process.exit(1);
+  }
+  const raw = readJsonFile(configPath);
+  const configResult = configSchema.safeParse(raw);
+  if (!configResult.success) {
+    console.error(chalk3.red("Invalid pdfx.json"));
+    process.exit(1);
+  }
+  const config = configResult.data;
+  const targetDir = path5.resolve(process.cwd(), config.componentDir);
   for (const componentName of components) {
     const nameResult = componentNameSchema.safeParse(componentName);
     if (!nameResult.success) {
-      console.error(chalk2.red(`Invalid component name: "${componentName}"`));
+      console.error(chalk3.red(`Invalid component name: "${componentName}"`));
       continue;
     }
-    const spinner = ora2(`Comparing ${componentName}...`).start();
+    const spinner = ora3(`Comparing ${componentName}...`).start();
     try {
       let response;
       try {
@@ -5127,8 +5527,8 @@ async function diff(components) {
         const isTimeout = err instanceof Error && err.name === "TimeoutError";
         throw new NetworkError(
           isTimeout ? `Registry request timed out after 10 seconds.
-  ${chalk2.dim("Check your internet connection or try again later.")}` : `Could not reach registry at ${config.registry}
-  ${chalk2.dim("Verify the URL is correct and you have internet access.")}`
+  ${chalk3.dim("Check your internet connection or try again later.")}` : `Could not reach registry at ${config.registry}
+  ${chalk3.dim("Verify the URL is correct and you have internet access.")}`
         );
       }
       if (!response.ok) {
@@ -5143,32 +5543,32 @@ async function diff(components) {
       }
       const component = result.data;
       spinner.stop();
-      const componentSubDir = path4.join(targetDir, component.name);
+      const componentSubDir = path5.join(targetDir, component.name);
       for (const file of component.files) {
-        const fileName = path4.basename(file.path);
+        const fileName = path5.basename(file.path);
         const localPath = safePath(componentSubDir, fileName);
         if (!checkFileExists(localPath)) {
-          console.log(chalk2.yellow(`  ${fileName}: not installed locally`));
+          console.log(chalk3.yellow(`  ${fileName}: not installed locally`));
           continue;
         }
         const localContent = fs4.readFileSync(localPath, "utf-8");
         const registryContent = config.theme && (file.content.includes("pdfx-theme") || file.content.includes("pdfx-theme-context")) ? resolveThemeImport(
-          path4.join(config.componentDir, component.name),
+          path5.join(config.componentDir, component.name),
           config.theme,
           file.content
         ) : file.content;
         if (localContent === registryContent) {
-          console.log(chalk2.green(`  ${fileName}: up to date`));
+          console.log(chalk3.green(`  ${fileName}: up to date`));
         } else {
-          console.log(chalk2.yellow(`  ${fileName}: differs from registry`));
+          console.log(chalk3.yellow(`  ${fileName}: differs from registry`));
           const localLines = localContent.split("\n");
           const registryLines = registryContent.split("\n");
           const lineDiff = localLines.length - registryLines.length;
-          console.log(chalk2.dim(`    Local: ${localLines.length} lines`));
-          console.log(chalk2.dim(`    Registry: ${registryLines.length} lines`));
+          console.log(chalk3.dim(`    Local: ${localLines.length} lines`));
+          console.log(chalk3.dim(`    Registry: ${registryLines.length} lines`));
           if (lineDiff !== 0) {
             const diffText = lineDiff > 0 ? `${Math.abs(lineDiff)} line${Math.abs(lineDiff) > 1 ? "s" : ""} added locally` : `${Math.abs(lineDiff)} line${Math.abs(lineDiff) > 1 ? "s" : ""} removed locally`;
-            console.log(chalk2.dim(`    \u2192 ${diffText}`));
+            console.log(chalk3.dim(`    \u2192 ${diffText}`));
           }
         }
       }
@@ -5182,32 +5582,20 @@ async function diff(components) {
 
 // src/commands/init.ts
 import fs7 from "fs";
-import path7 from "path";
-import chalk5 from "chalk";
-import ora4 from "ora";
-import prompts3 from "prompts";
-
-// src/constants.ts
-var DEFAULTS = {
-  REGISTRY_URL: "https://pdfx.akashpise.dev/r",
-  SCHEMA_URL: "https://pdfx.akashpise.dev/schema.json",
-  COMPONENT_DIR: "./src/components/pdfx",
-  THEME_FILE: "./src/lib/pdfx-theme.ts",
-  TEMPLATE_DIR: "./src/templates/pdfx"
-};
-var REGISTRY_SUBPATHS = {
-  TEMPLATES: "templates"
-};
+import path8 from "path";
+import chalk6 from "chalk";
+import ora5 from "ora";
+import prompts4 from "prompts";
 
 // src/utils/install-dependencies.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import { execa } from "execa";
-import ora3 from "ora";
-import prompts2 from "prompts";
+import ora4 from "ora";
+import prompts3 from "prompts";
 
 // src/utils/package-manager.ts
 import fs5 from "fs";
-import path5 from "path";
+import path6 from "path";
 var PACKAGE_MANAGERS = {
   pnpm: {
     name: "pnpm",
@@ -5234,7 +5622,7 @@ function detectPackageManager(cwd = process.cwd()) {
   const managers = ["pnpm", "yarn", "bun", "npm"];
   for (const manager of managers) {
     const info = PACKAGE_MANAGERS[manager];
-    const lockfilePath = path5.join(cwd, info.lockfile);
+    const lockfilePath = path6.join(cwd, info.lockfile);
     if (fs5.existsSync(lockfilePath)) {
       return info;
     }
@@ -5258,10 +5646,10 @@ async function promptAndInstallReactPdf(validation, cwd = process.cwd()) {
   const pm = detectPackageManager(cwd);
   const packageName = "@react-pdf/renderer";
   const installCmd = getInstallCommand(pm.name, [packageName]);
-  console.log(chalk3.yellow("\n  \u26A0 @react-pdf/renderer is required but not installed\n"));
-  console.log(chalk3.dim(`    This command will run: ${installCmd}
+  console.log(chalk4.yellow("\n  \u26A0 @react-pdf/renderer is required but not installed\n"));
+  console.log(chalk4.dim(`    This command will run: ${installCmd}
 `));
-  const { shouldInstall } = await prompts2({
+  const { shouldInstall } = await prompts3({
     type: "confirm",
     name: "shouldInstall",
     message: "Install @react-pdf/renderer now?",
@@ -5271,10 +5659,10 @@ async function promptAndInstallReactPdf(validation, cwd = process.cwd()) {
     return {
       success: false,
       message: `Installation cancelled. Please install manually:
-  ${chalk3.cyan(installCmd)}`
+  ${chalk4.cyan(installCmd)}`
     };
   }
-  const spinner = ora3("Installing @react-pdf/renderer...").start();
+  const spinner = ora4("Installing @react-pdf/renderer...").start();
   try {
     await execa(pm.name, ["add", packageName], {
       cwd,
@@ -5291,7 +5679,7 @@ async function promptAndInstallReactPdf(validation, cwd = process.cwd()) {
     return {
       success: false,
       message: `Installation failed: ${message}
-  Try manually: ${chalk3.cyan(installCmd)}`
+  Try manually: ${chalk4.cyan(installCmd)}`
     };
   }
 }
@@ -5299,7 +5687,7 @@ async function ensureReactPdfRenderer(validation, cwd = process.cwd()) {
   if (!validation.installed) {
     const result = await promptAndInstallReactPdf(validation, cwd);
     if (!result.success) {
-      console.error(chalk3.red(`
+      console.error(chalk4.red(`
   ${result.message}
 `));
       return false;
@@ -5308,10 +5696,10 @@ async function ensureReactPdfRenderer(validation, cwd = process.cwd()) {
   }
   if (!validation.valid) {
     console.log(
-      chalk3.yellow(
+      chalk4.yellow(
         `
   \u26A0 ${validation.message}
-  ${chalk3.dim("\u2192")} You may encounter compatibility issues
+  ${chalk4.dim("\u2192")} You may encounter compatibility issues
 `
       )
     );
@@ -5320,13 +5708,13 @@ async function ensureReactPdfRenderer(validation, cwd = process.cwd()) {
 }
 
 // src/utils/pre-flight.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 
 // src/utils/environment-validator.ts
 import fs6 from "fs";
-import path6 from "path";
+import path7 from "path";
 function validatePackageJson(cwd = process.cwd()) {
-  const pkgPath = path6.join(cwd, "package.json");
+  const pkgPath = path7.join(cwd, "package.json");
   const exists = fs6.existsSync(pkgPath);
   return {
     valid: exists,
@@ -5335,7 +5723,7 @@ function validatePackageJson(cwd = process.cwd()) {
   };
 }
 function validateReactProject(cwd = process.cwd()) {
-  const pkgPath = path6.join(cwd, "package.json");
+  const pkgPath = path7.join(cwd, "package.json");
   if (!fs6.existsSync(pkgPath)) {
     return {
       valid: false,
@@ -5362,7 +5750,7 @@ function validateReactProject(cwd = process.cwd()) {
   }
 }
 function validatePdfxConfig(cwd = process.cwd()) {
-  const configPath = path6.join(cwd, "pdfx.json");
+  const configPath = path7.join(cwd, "pdfx.json");
   const exists = fs6.existsSync(configPath);
   return {
     valid: true,
@@ -5387,43 +5775,43 @@ function runPreFlightChecks(cwd = process.cwd()) {
   if (!environment.hasPackageJson.valid) {
     blockingErrors.push(
       `${environment.hasPackageJson.message}
-  ${chalk4.dim("\u2192")} ${environment.hasPackageJson.fixCommand}`
+  ${chalk5.dim("\u2192")} ${environment.hasPackageJson.fixCommand}`
     );
   } else if (!environment.isReactProject.valid) {
     blockingErrors.push(
       `${environment.isReactProject.message}
-  ${chalk4.dim("\u2192")} ${environment.isReactProject.fixCommand}`
+  ${chalk5.dim("\u2192")} ${environment.isReactProject.fixCommand}`
     );
   } else {
     if (!dependencies.react.valid && dependencies.react.installed) {
       warnings.push(
         `${dependencies.react.message}
-  ${chalk4.dim("\u2192")} Current: ${dependencies.react.currentVersion}, Required: ${dependencies.react.requiredVersion}`
+  ${chalk5.dim("\u2192")} Current: ${dependencies.react.currentVersion}, Required: ${dependencies.react.requiredVersion}`
       );
     } else if (!dependencies.react.installed) {
       blockingErrors.push(
         `${dependencies.react.message}
-  ${chalk4.dim("\u2192")} Install React: npm install react react-dom`
+  ${chalk5.dim("\u2192")} Install React: npm install react react-dom`
       );
     }
   }
   if (!dependencies.nodeJs.valid) {
     blockingErrors.push(
       `${dependencies.nodeJs.message}
-  ${chalk4.dim("\u2192")} Current: ${dependencies.nodeJs.currentVersion}, Required: ${dependencies.nodeJs.requiredVersion}
-  ${chalk4.dim("\u2192")} Visit https://nodejs.org to upgrade`
+  ${chalk5.dim("\u2192")} Current: ${dependencies.nodeJs.currentVersion}, Required: ${dependencies.nodeJs.requiredVersion}
+  ${chalk5.dim("\u2192")} Visit https://nodejs.org to upgrade`
     );
   }
   if (dependencies.reactPdfRenderer.installed && !dependencies.reactPdfRenderer.valid) {
     warnings.push(
       `${dependencies.reactPdfRenderer.message}
-  ${chalk4.dim("\u2192")} Consider upgrading: npm install @react-pdf/renderer@latest`
+  ${chalk5.dim("\u2192")} Consider upgrading: npm install @react-pdf/renderer@latest`
     );
   }
   if (dependencies.typescript && !dependencies.typescript.valid) {
     warnings.push(
       `${dependencies.typescript.message}
-  ${chalk4.dim("\u2192")} Install types: npm install -D @types/react-pdf`
+  ${chalk5.dim("\u2192")} Install types: npm install -D @types/react-pdf`
     );
   }
   return {
@@ -5435,58 +5823,58 @@ function runPreFlightChecks(cwd = process.cwd()) {
   };
 }
 function displayPreFlightResults(result) {
-  console.log(chalk4.bold("\n  Pre-flight Checks:\n"));
+  console.log(chalk5.bold("\n  Pre-flight Checks:\n"));
   if (result.blockingErrors.length > 0) {
-    console.log(chalk4.red("  \u2717 Blocking Issues:\n"));
+    console.log(chalk5.red("  \u2717 Blocking Issues:\n"));
     for (const error of result.blockingErrors) {
-      console.log(chalk4.red(`    \u2022 ${error}
+      console.log(chalk5.red(`    \u2022 ${error}
 `));
     }
   }
   if (result.warnings.length > 0) {
-    console.log(chalk4.yellow("  \u26A0 Warnings:\n"));
+    console.log(chalk5.yellow("  \u26A0 Warnings:\n"));
     for (const warning of result.warnings) {
-      console.log(chalk4.yellow(`    \u2022 ${warning}
+      console.log(chalk5.yellow(`    \u2022 ${warning}
 `));
     }
   }
   if (result.blockingErrors.length === 0 && result.warnings.length === 0) {
-    console.log(chalk4.green("  \u2713 All checks passed!\n"));
+    console.log(chalk5.green("  \u2713 All checks passed!\n"));
   }
 }
 
 // src/commands/init.ts
 async function init() {
-  console.log(chalk5.bold.cyan("\n  Welcome to the pdfx cli\n"));
+  console.log(chalk6.bold.cyan("\n  Welcome to the pdfx cli\n"));
   const preFlightResult = runPreFlightChecks();
   displayPreFlightResults(preFlightResult);
   if (!preFlightResult.canProceed) {
     console.error(
-      chalk5.red("\n  Cannot proceed due to blocking issues. Please fix them and try again.\n")
+      chalk6.red("\n  Cannot proceed due to blocking issues. Please fix them and try again.\n")
     );
     process.exit(1);
   }
   const hasReactPdf = await ensureReactPdfRenderer(preFlightResult.dependencies.reactPdfRenderer);
   if (!hasReactPdf) {
     console.error(
-      chalk5.red("\n  @react-pdf/renderer is required. Please install it and try again.\n")
+      chalk6.red("\n  @react-pdf/renderer is required. Please install it and try again.\n")
     );
     process.exit(1);
   }
-  const existingConfig = path7.join(process.cwd(), "pdfx.json");
+  const existingConfig = path8.join(process.cwd(), "pdfx.json");
   if (fs7.existsSync(existingConfig)) {
-    const { overwrite } = await prompts3({
+    const { overwrite } = await prompts4({
       type: "confirm",
       name: "overwrite",
       message: "pdfx.json already exists. Overwrite?",
       initial: false
     });
     if (!overwrite) {
-      console.log(chalk5.yellow("Init cancelled \u2014 existing config preserved."));
+      console.log(chalk6.yellow("Init cancelled \u2014 existing config preserved."));
       return;
     }
   }
-  const answers = await prompts3(
+  const answers = await prompts4(
     [
       {
         type: "text",
@@ -5497,7 +5885,7 @@ async function init() {
           if (!value || value.trim().length === 0) {
             return "Component directory is required";
           }
-          if (path7.isAbsolute(value)) {
+          if (path8.isAbsolute(value)) {
             return "Please use a relative path (e.g., ./src/components/pdfx)";
           }
           if (!value.startsWith(".")) {
@@ -5506,6 +5894,24 @@ async function init() {
           return true;
         }
       },
+      {
+        type: "text",
+        name: "blockDir",
+        message: "Where should we install blocks?",
+        initial: DEFAULTS.BLOCK_DIR,
+        validate: (value) => {
+          if (!value || value.trim().length === 0) {
+            return "Block directory is required";
+          }
+          if (path8.isAbsolute(value)) {
+            return "Please use a relative path (e.g., ./src/blocks/pdfx)";
+          }
+          if (!value.startsWith(".")) {
+            return "Path should start with ./ or ../ (e.g., ./src/blocks/pdfx)";
+          }
+          return true;
+        }
+      },
       {
         type: "text",
         name: "registry",
@@ -5550,7 +5956,7 @@ async function init() {
           if (!value || value.trim().length === 0) {
             return "Theme path is required";
           }
-          if (path7.isAbsolute(value)) {
+          if (path8.isAbsolute(value)) {
             return "Please use a relative path (e.g., ./src/lib/pdfx-theme.ts)";
           }
           if (!value.endsWith(".ts") && !value.endsWith(".tsx")) {
@@ -5562,68 +5968,71 @@ async function init() {
     ],
     {
       onCancel: () => {
-        console.log(chalk5.yellow("\nSetup cancelled."));
+        console.log(chalk6.yellow("\nSetup cancelled."));
         process.exit(0);
       }
     }
   );
   if (!answers.componentDir || !answers.registry) {
-    console.error(chalk5.red("Missing required fields. Run pdfx init again."));
+    console.error(chalk6.red("Missing required fields. Run pdfx init again."));
     process.exit(1);
   }
   const config = {
     $schema: DEFAULTS.SCHEMA_URL,
     componentDir: answers.componentDir,
     registry: answers.registry,
-    theme: answers.themePath || DEFAULTS.THEME_FILE
+    theme: answers.themePath || DEFAULTS.THEME_FILE,
+    blockDir: answers.blockDir || DEFAULTS.BLOCK_DIR
   };
   const validation = configSchema.safeParse(config);
   if (!validation.success) {
     const issues = validation.error.issues.map((i) => i.message).join(", ");
-    console.error(chalk5.red(`Invalid configuration: ${issues}`));
+    console.error(chalk6.red(`Invalid configuration: ${issues}`));
     process.exit(1);
   }
-  const spinner = ora4("Creating config and theme files...").start();
+  const spinner = ora5("Creating config and theme files...").start();
   try {
-    const componentDirPath = path7.resolve(process.cwd(), answers.componentDir);
+    const componentDirPath = path8.resolve(process.cwd(), answers.componentDir);
     ensureDir(componentDirPath);
-    fs7.writeFileSync(path7.join(process.cwd(), "pdfx.json"), JSON.stringify(config, null, 2));
+    fs7.writeFileSync(path8.join(process.cwd(), "pdfx.json"), JSON.stringify(config, null, 2));
     const presetName = answers.themePreset || "professional";
     const preset = themePresets[presetName];
-    const themePath = path7.resolve(process.cwd(), config.theme);
-    ensureDir(path7.dirname(themePath));
+    const themePath = path8.resolve(process.cwd(), config.theme);
+    ensureDir(path8.dirname(themePath));
     fs7.writeFileSync(themePath, generateThemeFile(preset), "utf-8");
-    const contextPath = path7.join(path7.dirname(themePath), "pdfx-theme-context.tsx");
+    const contextPath = path8.join(path8.dirname(themePath), "pdfx-theme-context.tsx");
     fs7.writeFileSync(contextPath, generateThemeContextFile(), "utf-8");
     spinner.succeed(`Created pdfx.json + ${config.theme} (${presetName} theme)`);
-    console.log(chalk5.green("\nSuccess! You can now run:"));
-    console.log(chalk5.cyan("  pdfx add heading"));
-    console.log(chalk5.dim(`
-  Components: ${path7.resolve(process.cwd(), answers.componentDir)}`));
-    console.log(chalk5.dim(`  Theme: ${path7.resolve(process.cwd(), config.theme)}
+    console.log(chalk6.green("\nSuccess! You can now run:"));
+    console.log(chalk6.cyan("  pdfx add heading"));
+    console.log(chalk6.cyan("  pdfx block add invoice-classic"));
+    console.log(chalk6.dim(`
+  Components: ${path8.resolve(process.cwd(), answers.componentDir)}`));
+    console.log(chalk6.dim(`  Blocks: ${path8.resolve(process.cwd(), config.blockDir)}`));
+    console.log(chalk6.dim(`  Theme: ${path8.resolve(process.cwd(), config.theme)}
 `));
   } catch (error) {
     spinner.fail("Failed to create config");
     const message = error instanceof Error ? error.message : String(error);
-    console.error(chalk5.dim(`  ${message}`));
+    console.error(chalk6.dim(`  ${message}`));
     process.exit(1);
   }
 }
 
 // src/commands/list.ts
-import path8 from "path";
-import chalk6 from "chalk";
-import ora5 from "ora";
+import path9 from "path";
+import chalk7 from "chalk";
+import ora6 from "ora";
 var FETCH_TIMEOUT_MS2 = 1e4;
 async function list() {
-  const configPath = path8.join(process.cwd(), "pdfx.json");
+  const configPath = path9.join(process.cwd(), "pdfx.json");
   let config;
   let hasLocalProject = false;
   if (checkFileExists(configPath)) {
     const raw = readJsonFile(configPath);
     const configResult = configSchema.safeParse(raw);
     if (!configResult.success) {
-      console.error(chalk6.red("Invalid pdfx.json"));
+      console.error(chalk7.red("Invalid pdfx.json"));
       process.exit(1);
     }
     config = configResult.data;
@@ -5634,9 +6043,9 @@ async function list() {
       componentDir: "./src/components/pdfx",
       theme: "./src/lib/pdfx-theme.ts"
     };
-    console.log(chalk6.dim("No pdfx.json found. Listing components from default registry.\n"));
+    console.log(chalk7.dim("No pdfx.json found. Listing from default registry.\n"));
   }
-  const spinner = ora5("Fetching component list...").start();
+  const spinner = ora6("Fetching registry...").start();
   try {
     let response;
     try {
@@ -5647,8 +6056,8 @@ async function list() {
       const isTimeout = err instanceof Error && err.name === "TimeoutError";
       throw new NetworkError(
         isTimeout ? `Registry request timed out after 10 seconds.
-  ${chalk6.dim("Check your internet connection or try again later.")}` : `Could not reach registry at ${config.registry}
-  ${chalk6.dim("Verify the URL is correct and you have internet access.")}`
+  ${chalk7.dim("Check your internet connection or try again later.")}` : `Could not reach registry at ${config.registry}
+  ${chalk7.dim("Verify the URL is correct and you have internet access.")}`
       );
     }
     if (!response.ok) {
@@ -5661,23 +6070,62 @@ async function list() {
     }
     spinner.stop();
     const components = result.data.items.filter((item) => item.type === "registry:ui");
-    console.log(chalk6.bold(`
-  Available Components (${components.length})
-`));
+    const templates = result.data.items.filter((item) => item.type === "registry:template");
+    const blocks = result.data.items.filter((item) => item.type === "registry:block");
+    const componentBaseDir = path9.resolve(process.cwd(), config.componentDir);
+    const templateBaseDir = path9.resolve(process.cwd(), config.templateDir ?? "./src/templates");
+    console.log(chalk7.bold(`
+  Components (${components.length})`));
+    console.log(chalk7.dim("  Install with: pdfx add <component>\n"));
     for (const item of components) {
+      const componentSubDir = path9.join(componentBaseDir, item.name);
+      const localPath = safePath(componentSubDir, `pdfx-${item.name}.tsx`);
+      const installed = hasLocalProject && checkFileExists(localPath);
+      const status = installed ? chalk7.green("[installed]") : chalk7.dim("[not installed]");
+      console.log(`  ${chalk7.cyan(item.name.padEnd(20))} ${item.description}`);
       if (hasLocalProject) {
-        const targetDir = path8.resolve(process.cwd(), config.componentDir);
-        const componentSubDir = path8.join(targetDir, item.name);
-        const localPath = safePath(componentSubDir, `pdfx-${item.name}.tsx`);
-        const installed = checkFileExists(localPath);
-        const status = installed ? chalk6.green("[installed]") : chalk6.dim("[not installed]");
-        console.log(`  ${chalk6.cyan(item.name.padEnd(20))} ${item.description}`);
         console.log(`  ${"".padEnd(20)} ${status}`);
-      } else {
-        console.log(`  ${chalk6.cyan(item.name.padEnd(20))} ${item.description}`);
       }
       console.log();
     }
+    console.log(chalk7.bold(`  Templates (${templates.length})`));
+    console.log(chalk7.dim("  Data-driven. Install with: pdfx template add <template>\n"));
+    for (const item of templates) {
+      const templateDir = path9.join(templateBaseDir, item.name);
+      const installed = hasLocalProject && checkFileExists(templateDir);
+      const status = installed ? chalk7.green("[installed]") : chalk7.dim("[not installed]");
+      console.log(`  ${chalk7.cyan(item.name.padEnd(22))} ${item.description ?? ""}`);
+      if (hasLocalProject) {
+        console.log(`  ${"".padEnd(22)} ${status}`);
+      }
+      console.log();
+    }
+    console.log(chalk7.bold(`  Blocks (${blocks.length})`));
+    console.log(chalk7.dim("  Copy-paste designs. Install with: pdfx block add <block>\n"));
+    for (const item of blocks) {
+      const blockDir = path9.join(templateBaseDir, item.name);
+      const installed = hasLocalProject && checkFileExists(blockDir);
+      const status = installed ? chalk7.green("[installed]") : chalk7.dim("[not installed]");
+      console.log(`  ${chalk7.cyan(item.name.padEnd(22))} ${item.description ?? ""}`);
+      if (hasLocalProject) {
+        console.log(`  ${"".padEnd(22)} ${status}`);
+      }
+      if (item.peerComponents && item.peerComponents.length > 0) {
+        console.log(chalk7.dim(`  ${"".padEnd(22)} requires: ${item.peerComponents.join(", ")}`));
+      }
+      console.log();
+    }
+    console.log(chalk7.dim("  Quick Start:"));
+    console.log(
+      chalk7.dim(`    pdfx add heading table            ${chalk7.dim("# Add components")}`)
+    );
+    console.log(
+      chalk7.dim(`    pdfx template add invoice-template ${chalk7.dim("# Add data-driven template")}`)
+    );
+    console.log(
+      chalk7.dim(`    pdfx block add invoice-classic    ${chalk7.dim("# Add copy-paste block")}`)
+    );
+    console.log();
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     spinner.fail(message);
@@ -5686,18 +6134,18 @@ async function list() {
 }
 
 // src/commands/template.ts
-import path9 from "path";
-import chalk7 from "chalk";
-import ora6 from "ora";
-import prompts4 from "prompts";
-function readConfig2(configPath) {
+import path10 from "path";
+import chalk8 from "chalk";
+import ora7 from "ora";
+import prompts5 from "prompts";
+function readConfig3(configPath) {
   const raw = readJsonFile(configPath);
   const result = configSchema.safeParse(raw);
   if (!result.success) {
     const issues = result.error.issues.map((i) => i.message).join(", ");
     throw new ConfigError(
       `Invalid pdfx.json: ${issues}`,
-      `Fix the config or re-run ${chalk7.cyan("pdfx init")}`
+      `Fix the config or re-run ${chalk8.cyan("pdfx init")}`
     );
   }
   return result.data;
@@ -5732,7 +6180,7 @@ async function fetchTemplate(name, registryUrl) {
   }
   return result.data;
 }
-async function fetchComponent2(name, registryUrl) {
+async function fetchComponent3(name, registryUrl) {
   const url = `${registryUrl}/${name}.json`;
   let response;
   try {
@@ -5764,7 +6212,7 @@ async function fetchComponent2(name, registryUrl) {
 }
 function resolveTemplateImports(content, templateName, config) {
   const cwd = process.cwd();
-  const templateSubdir = path9.resolve(
+  const templateSubdir = path10.resolve(
     cwd,
     config.templateDir ?? DEFAULTS.TEMPLATE_DIR,
     templateName
@@ -5772,38 +6220,38 @@ function resolveTemplateImports(content, templateName, config) {
   let result = content.replace(
     /from '\.\.\/\.\.\/components\/pdfx\/([a-z][a-z0-9-]*)\/pdfx-([a-z][a-z0-9-]*)'/g,
     (_match, componentName) => {
-      const absCompFile = path9.resolve(
+      const absCompFile = path10.resolve(
         cwd,
         config.componentDir,
         componentName,
         `pdfx-${componentName}`
       );
-      let rel = path9.relative(templateSubdir, absCompFile);
+      let rel = path10.relative(templateSubdir, absCompFile);
       if (!rel.startsWith(".")) rel = `./${rel}`;
       return `from '${rel}'`;
     }
   );
   if (config.theme) {
-    const absThemePath = path9.resolve(cwd, config.theme).replace(/\.tsx?$/, "");
-    let relTheme = path9.relative(templateSubdir, absThemePath);
+    const absThemePath = path10.resolve(cwd, config.theme).replace(/\.tsx?$/, "");
+    let relTheme = path10.relative(templateSubdir, absThemePath);
     if (!relTheme.startsWith(".")) relTheme = `./${relTheme}`;
-    const absContextPath = path9.join(
-      path9.dirname(path9.resolve(cwd, config.theme)),
+    const absContextPath = path10.join(
+      path10.dirname(path10.resolve(cwd, config.theme)),
       "pdfx-theme-context"
     );
-    let relContext = path9.relative(templateSubdir, absContextPath);
+    let relContext = path10.relative(templateSubdir, absContextPath);
     if (!relContext.startsWith(".")) relContext = `./${relContext}`;
     result = result.replace(/from '\.\.\/\.\.\/lib\/pdfx-theme'/g, `from '${relTheme}'`);
     result = result.replace(/from '\.\.\/\.\.\/lib\/pdfx-theme-context'/g, `from '${relContext}'`);
   }
   return result;
 }
-async function resolveConflict(fileName, currentDecision) {
+async function resolveConflict2(fileName, currentDecision) {
   if (currentDecision === "overwrite-all") return "overwrite-all";
-  const { action } = await prompts4({
+  const { action } = await prompts5({
     type: "select",
     name: "action",
-    message: `${chalk7.yellow(fileName)} already exists. What would you like to do?`,
+    message: `${chalk8.yellow(fileName)} already exists. What would you like to do?`,
     choices: [
       { title: "Skip", value: "skip", description: "Keep the existing file unchanged" },
       { title: "Overwrite", value: "overwrite", description: "Replace this file only" },
@@ -5818,20 +6266,20 @@ async function resolveConflict(fileName, currentDecision) {
   if (!action) throw new ValidationError("Cancelled by user");
   return action;
 }
-async function ensurePeerComponents(template, config, force) {
+async function ensurePeerComponents2(template, config, force) {
   const installedPeers = [];
   const peerWarnings = [];
   if (!template.peerComponents || template.peerComponents.length === 0) {
     return { installedPeers, peerWarnings };
   }
-  const componentBaseDir = path9.resolve(process.cwd(), config.componentDir);
+  const componentBaseDir = path10.resolve(process.cwd(), config.componentDir);
   for (const componentName of template.peerComponents) {
-    const componentDir = path9.join(componentBaseDir, componentName);
-    const expectedMain = path9.join(componentDir, `pdfx-${componentName}.tsx`);
+    const componentDir = path10.join(componentBaseDir, componentName);
+    const expectedMain = path10.join(componentDir, `pdfx-${componentName}.tsx`);
     if (checkFileExists(componentDir)) {
       if (!checkFileExists(expectedMain)) {
         peerWarnings.push(
-          `${componentName}: directory exists but expected file missing (${path9.basename(expectedMain)})`
+          `${componentName}: directory exists but expected file missing (${path10.basename(expectedMain)})`
         );
       } else {
         peerWarnings.push(
@@ -5840,11 +6288,11 @@ async function ensurePeerComponents(template, config, force) {
       }
       continue;
     }
-    const component = await fetchComponent2(componentName, config.registry);
+    const component = await fetchComponent3(componentName, config.registry);
     ensureDir(componentDir);
-    const componentRelDir = path9.join(config.componentDir, component.name);
+    const componentRelDir = path10.join(config.componentDir, component.name);
     for (const file of component.files) {
-      const fileName = path9.basename(file.path);
+      const fileName = path10.basename(file.path);
       const filePath = safePath(componentDir, fileName);
       let content = file.content;
       if (config.theme && (content.includes("pdfx-theme") || content.includes("pdfx-theme-context"))) {
@@ -5864,13 +6312,13 @@ async function ensurePeerComponents(template, config, force) {
 }
 async function installTemplate(name, config, force) {
   const template = await fetchTemplate(name, config.registry);
-  const peerResult = await ensurePeerComponents(template, config, force);
-  const templateBaseDir = path9.resolve(process.cwd(), config.templateDir ?? DEFAULTS.TEMPLATE_DIR);
-  const templateDir = path9.join(templateBaseDir, template.name);
+  const peerResult = await ensurePeerComponents2(template, config, force);
+  const templateBaseDir = path10.resolve(process.cwd(), config.templateDir ?? DEFAULTS.TEMPLATE_DIR);
+  const templateDir = path10.join(templateBaseDir, template.name);
   ensureDir(templateDir);
   const filesToWrite = [];
   for (const file of template.files) {
-    const fileName = path9.basename(file.path);
+    const fileName = path10.basename(file.path);
     const filePath = safePath(templateDir, fileName);
     let content = file.content;
     if (/\.(tsx?|jsx?)$/.test(fileName) && content.includes("../../")) {
@@ -5883,7 +6331,7 @@ async function installTemplate(name, config, force) {
     const resolved = [];
     for (const file of filesToWrite) {
       if (checkFileExists(file.filePath)) {
-        const decision = await resolveConflict(path9.basename(file.filePath), globalDecision);
+        const decision = await resolveConflict2(path10.basename(file.filePath), globalDecision);
         if (decision === "overwrite-all") {
           globalDecision = "overwrite-all";
         }
@@ -5896,7 +6344,7 @@ async function installTemplate(name, config, force) {
       if (!file.skip) {
         writeFile(file.filePath, file.content);
       } else {
-        console.log(chalk7.dim(`  skipped ${path9.basename(file.filePath)}`));
+        console.log(chalk8.dim(`  skipped ${path10.basename(file.filePath)}`));
       }
     }
   } else {
@@ -5905,49 +6353,49 @@ async function installTemplate(name, config, force) {
     }
   }
   if (template.peerComponents && template.peerComponents.length > 0) {
-    const componentBaseDir = path9.resolve(process.cwd(), config.componentDir);
+    const componentBaseDir = path10.resolve(process.cwd(), config.componentDir);
     const missing = [];
     for (const comp of template.peerComponents) {
-      const compDir = path9.join(componentBaseDir, comp);
+      const compDir = path10.join(componentBaseDir, comp);
       if (!checkFileExists(compDir)) {
         missing.push(comp);
       }
     }
     if (missing.length > 0) {
       console.log();
-      console.log(chalk7.yellow("  Missing peer components:"));
+      console.log(chalk8.yellow("  Missing peer components:"));
       for (const comp of missing) {
-        console.log(chalk7.dim(`    ${comp}  \u2192  run: ${chalk7.cyan(`pdfx add ${comp}`)}`));
+        console.log(chalk8.dim(`    ${comp}  \u2192  run: ${chalk8.cyan(`pdfx add ${comp}`)}`));
       }
     }
   }
   if (config.theme) {
-    const absThemePath = path9.resolve(process.cwd(), config.theme);
-    const contextPath = path9.join(path9.dirname(absThemePath), "pdfx-theme-context.tsx");
+    const absThemePath = path10.resolve(process.cwd(), config.theme);
+    const contextPath = path10.join(path10.dirname(absThemePath), "pdfx-theme-context.tsx");
     if (!checkFileExists(contextPath)) {
-      ensureDir(path9.dirname(contextPath));
+      ensureDir(path10.dirname(contextPath));
       writeFile(contextPath, generateThemeContextFile());
     }
   }
   return peerResult;
 }
 async function templateAdd(names, options = {}) {
-  const configPath = path9.join(process.cwd(), "pdfx.json");
+  const configPath = path10.join(process.cwd(), "pdfx.json");
   if (!checkFileExists(configPath)) {
-    console.error(chalk7.red("Error: pdfx.json not found"));
-    console.log(chalk7.yellow("Run: pdfx init"));
+    console.error(chalk8.red("Error: pdfx.json not found"));
+    console.log(chalk8.yellow("Run: pdfx init"));
     process.exit(1);
   }
   let config;
   try {
-    config = readConfig2(configPath);
+    config = readConfig3(configPath);
   } catch (error) {
     if (error instanceof ConfigError) {
-      console.error(chalk7.red(error.message));
-      if (error.suggestion) console.log(chalk7.yellow(`  Hint: ${error.suggestion}`));
+      console.error(chalk8.red(error.message));
+      if (error.suggestion) console.log(chalk8.yellow(`  Hint: ${error.suggestion}`));
     } else {
       const message = error instanceof Error ? error.message : String(error);
-      console.error(chalk7.red(message));
+      console.error(chalk8.red(message));
     }
     process.exit(1);
   }
@@ -5956,24 +6404,24 @@ async function templateAdd(names, options = {}) {
   for (const templateName of names) {
     const nameResult = componentNameSchema.safeParse(templateName);
     if (!nameResult.success) {
-      console.error(chalk7.red(`Invalid template name: "${templateName}"`));
+      console.error(chalk8.red(`Invalid template name: "${templateName}"`));
       console.log(
-        chalk7.dim('  Names must be lowercase alphanumeric with hyphens (e.g., "invoice-classic")')
+        chalk8.dim('  Names must be lowercase alphanumeric with hyphens (e.g., "invoice-classic")')
       );
       failed.push(templateName);
       continue;
     }
-    const spinner = ora6(`Adding template ${templateName}...`).start();
+    const spinner = ora7(`Adding template ${templateName}...`).start();
     try {
       const result = await installTemplate(templateName, config, force);
-      spinner.succeed(`Added template ${chalk7.cyan(templateName)}`);
+      spinner.succeed(`Added template ${chalk8.cyan(templateName)}`);
       if (result.installedPeers.length > 0) {
         console.log(
-          chalk7.green(`  Installed required components: ${result.installedPeers.join(", ")}`)
+          chalk8.green(`  Installed required components: ${result.installedPeers.join(", ")}`)
         );
       }
       for (const warning of result.peerWarnings) {
-        console.log(chalk7.yellow(`  Warning: ${warning}`));
+        console.log(chalk8.yellow(`  Warning: ${warning}`));
       }
     } catch (error) {
       if (error instanceof ValidationError && error.message.includes("Cancelled")) {
@@ -5982,24 +6430,24 @@ async function templateAdd(names, options = {}) {
       } else if (error instanceof NetworkError || error instanceof RegistryError || error instanceof ValidationError) {
         spinner.fail(error.message);
         if (error.suggestion) {
-          console.log(chalk7.dim(`  Hint: ${error.suggestion}`));
+          console.log(chalk8.dim(`  Hint: ${error.suggestion}`));
         }
       } else {
         spinner.fail(`Failed to add template ${templateName}`);
         const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk7.dim(`  ${message}`));
+        console.error(chalk8.dim(`  ${message}`));
       }
       failed.push(templateName);
     }
   }
   console.log();
   if (failed.length > 0) {
-    console.log(chalk7.yellow(`Failed: ${failed.join(", ")}`));
+    console.log(chalk8.yellow(`Failed: ${failed.join(", ")}`));
   }
   if (failed.length < names.length) {
-    const resolvedDir = path9.resolve(process.cwd(), config.templateDir ?? DEFAULTS.TEMPLATE_DIR);
-    console.log(chalk7.green("Done!"));
-    console.log(chalk7.dim(`Templates installed to: ${resolvedDir}
+    const resolvedDir = path10.resolve(process.cwd(), config.templateDir ?? DEFAULTS.TEMPLATE_DIR);
+    console.log(chalk8.green("Done!"));
+    console.log(chalk8.dim(`Templates installed to: ${resolvedDir}
 `));
   }
   if (failed.length > 0) {
@@ -6007,20 +6455,20 @@ async function templateAdd(names, options = {}) {
   }
 }
 async function templateList() {
-  const configPath = path9.join(process.cwd(), "pdfx.json");
+  const configPath = path10.join(process.cwd(), "pdfx.json");
   if (!checkFileExists(configPath)) {
-    console.error(chalk7.red("Error: pdfx.json not found"));
-    console.log(chalk7.yellow("Run: pdfx init"));
+    console.error(chalk8.red("Error: pdfx.json not found"));
+    console.log(chalk8.yellow("Run: pdfx init"));
     process.exit(1);
   }
   const raw = readJsonFile(configPath);
   const configResult = configSchema.safeParse(raw);
   if (!configResult.success) {
-    console.error(chalk7.red("Invalid pdfx.json"));
+    console.error(chalk8.red("Invalid pdfx.json"));
     process.exit(1);
   }
   const config = configResult.data;
-  const spinner = ora6("Fetching template list...").start();
+  const spinner = ora7("Fetching template list...").start();
   try {
     let response;
     try {
@@ -6044,28 +6492,28 @@ async function templateList() {
     spinner.stop();
     const templates = result.data.items.filter((item) => item.type === "registry:template");
     if (templates.length === 0) {
-      console.log(chalk7.dim("\n  No templates available in the registry.\n"));
+      console.log(chalk8.dim("\n  No templates available in the registry.\n"));
       return;
     }
-    const templateBaseDir = path9.resolve(
+    const templateBaseDir = path10.resolve(
       process.cwd(),
       config.templateDir ?? DEFAULTS.TEMPLATE_DIR
     );
-    console.log(chalk7.bold(`
+    console.log(chalk8.bold(`
   Available Templates (${templates.length})
 `));
     for (const item of templates) {
-      const templateDir = path9.join(templateBaseDir, item.name);
+      const templateDir = path10.join(templateBaseDir, item.name);
       const installed = checkFileExists(templateDir);
-      const status = installed ? chalk7.green("[installed]") : chalk7.dim("[not installed]");
-      console.log(`  ${chalk7.cyan(item.name.padEnd(22))} ${item.description ?? ""}`);
+      const status = installed ? chalk8.green("[installed]") : chalk8.dim("[not installed]");
+      console.log(`  ${chalk8.cyan(item.name.padEnd(22))} ${item.description ?? ""}`);
       console.log(`  ${"".padEnd(22)} ${status}`);
       if (item.peerComponents && item.peerComponents.length > 0) {
-        console.log(chalk7.dim(`  ${"".padEnd(22)} requires: ${item.peerComponents.join(", ")}`));
+        console.log(chalk8.dim(`  ${"".padEnd(22)} requires: ${item.peerComponents.join(", ")}`));
       }
       console.log();
     }
-    console.log(chalk7.dim(`  Install with: ${chalk7.cyan("pdfx template add <template-name>")}
+    console.log(chalk8.dim(`  Install with: ${chalk8.cyan("pdfx template add <template-name>")}
 `));
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -6076,22 +6524,22 @@ async function templateList() {
 
 // src/commands/theme.ts
 import fs8 from "fs";
-import path10 from "path";
-import chalk8 from "chalk";
-import ora7 from "ora";
-import prompts5 from "prompts";
+import path11 from "path";
+import chalk9 from "chalk";
+import ora8 from "ora";
+import prompts6 from "prompts";
 import ts from "typescript";
 async function themeInit() {
-  const configPath = path10.join(process.cwd(), "pdfx.json");
+  const configPath = path11.join(process.cwd(), "pdfx.json");
   if (!fs8.existsSync(configPath)) {
-    console.error(chalk8.red("\nError: pdfx.json not found"));
-    console.log(chalk8.yellow("\n  PDFx is not initialized in this project.\n"));
-    console.log(chalk8.cyan("  Run: pdfx init"));
-    console.log(chalk8.dim("  This will set up your project configuration and theme.\n"));
+    console.error(chalk9.red("\nError: pdfx.json not found"));
+    console.log(chalk9.yellow("\n  PDFx is not initialized in this project.\n"));
+    console.log(chalk9.cyan("  Run: pdfx init"));
+    console.log(chalk9.dim("  This will set up your project configuration and theme.\n"));
     process.exit(1);
   }
-  console.log(chalk8.bold.cyan("\n  PDFx Theme Setup\n"));
-  const answers = await prompts5(
+  console.log(chalk9.bold.cyan("\n  PDFx Theme Setup\n"));
+  const answers = await prompts6(
     [
       {
         type: "select",
@@ -6125,27 +6573,27 @@ async function themeInit() {
     ],
     {
       onCancel: () => {
-        console.log(chalk8.yellow("\nTheme setup cancelled."));
+        console.log(chalk9.yellow("\nTheme setup cancelled."));
         process.exit(0);
       }
     }
   );
   if (!answers.preset || !answers.themePath) {
-    console.error(chalk8.red("Missing required fields."));
+    console.error(chalk9.red("Missing required fields."));
     process.exit(1);
   }
   const presetName = answers.preset;
   const themePath = answers.themePath;
   const preset = themePresets[presetName];
-  const spinner = ora7(`Scaffolding ${presetName} theme...`).start();
+  const spinner = ora8(`Scaffolding ${presetName} theme...`).start();
   try {
-    const absThemePath = path10.resolve(process.cwd(), themePath);
-    ensureDir(path10.dirname(absThemePath));
+    const absThemePath = path11.resolve(process.cwd(), themePath);
+    ensureDir(path11.dirname(absThemePath));
     fs8.writeFileSync(absThemePath, generateThemeFile(preset), "utf-8");
-    const contextPath = path10.join(path10.dirname(absThemePath), "pdfx-theme-context.tsx");
+    const contextPath = path11.join(path11.dirname(absThemePath), "pdfx-theme-context.tsx");
     fs8.writeFileSync(contextPath, generateThemeContextFile(), "utf-8");
     spinner.succeed(`Created ${themePath} with ${presetName} theme`);
-    const configPath2 = path10.join(process.cwd(), "pdfx.json");
+    const configPath2 = path11.join(process.cwd(), "pdfx.json");
     if (fs8.existsSync(configPath2)) {
       try {
         const rawConfig = readJsonFile(configPath2);
@@ -6153,19 +6601,19 @@ async function themeInit() {
         if (result.success) {
           const updatedConfig = { ...result.data, theme: themePath };
           fs8.writeFileSync(configPath2, JSON.stringify(updatedConfig, null, 2), "utf-8");
-          console.log(chalk8.green("  Updated pdfx.json with theme path"));
+          console.log(chalk9.green("  Updated pdfx.json with theme path"));
         }
       } catch {
-        console.log(chalk8.yellow('  Could not update pdfx.json \u2014 add "theme" field manually'));
+        console.log(chalk9.yellow('  Could not update pdfx.json \u2014 add "theme" field manually'));
       }
     }
-    console.log(chalk8.dim(`
+    console.log(chalk9.dim(`
   Edit ${themePath} to customize your theme.
 `));
   } catch (error) {
     spinner.fail("Failed to create theme file");
     const message = error instanceof Error ? error.message : String(error);
-    console.error(chalk8.dim(`  ${message}`));
+    console.error(chalk9.dim(`  ${message}`));
     process.exit(1);
   }
 }
@@ -6173,56 +6621,56 @@ async function themeSwitch(presetName) {
   const resolvedPreset = presetName === "default" ? "professional" : presetName;
   const validPresets = Object.keys(themePresets);
   if (!validPresets.includes(resolvedPreset)) {
-    console.error(chalk8.red(`\u2716 Invalid theme preset: "${presetName}"`));
-    console.log(chalk8.dim(`  Available presets: ${validPresets.join(", ")}, default
+    console.error(chalk9.red(`\u2716 Invalid theme preset: "${presetName}"`));
+    console.log(chalk9.dim(`  Available presets: ${validPresets.join(", ")}, default
 `));
-    console.log(chalk8.dim("  Usage: pdfx theme switch <preset>"));
+    console.log(chalk9.dim("  Usage: pdfx theme switch <preset>"));
     process.exit(1);
   }
   const validatedPreset = resolvedPreset;
-  const configPath = path10.join(process.cwd(), "pdfx.json");
+  const configPath = path11.join(process.cwd(), "pdfx.json");
   if (!fs8.existsSync(configPath)) {
-    console.error(chalk8.red('No pdfx.json found. Run "pdfx init" first.'));
+    console.error(chalk9.red('No pdfx.json found. Run "pdfx init" first.'));
     process.exit(1);
   }
   const rawConfig = readJsonFile(configPath);
   const result = configSchema.safeParse(rawConfig);
   if (!result.success) {
-    console.error(chalk8.red("Invalid pdfx.json configuration."));
+    console.error(chalk9.red("Invalid pdfx.json configuration."));
     process.exit(1);
   }
   const config = result.data;
   if (!config.theme) {
     console.error(
-      chalk8.red('No theme path in pdfx.json. Run "pdfx theme init" to set up theming.')
+      chalk9.red('No theme path in pdfx.json. Run "pdfx theme init" to set up theming.')
     );
     process.exit(1);
   }
-  const answer = await prompts5({
+  const answer = await prompts6({
     type: "confirm",
     name: "confirm",
     message: `This will overwrite ${config.theme} with the ${validatedPreset} preset. Continue?`,
     initial: false
   });
   if (!answer.confirm) {
-    console.log(chalk8.yellow("Cancelled."));
+    console.log(chalk9.yellow("Cancelled."));
     return;
   }
-  const spinner = ora7(`Switching to ${validatedPreset} theme...`).start();
+  const spinner = ora8(`Switching to ${validatedPreset} theme...`).start();
   try {
     const preset = themePresets[validatedPreset];
-    const absThemePath = path10.resolve(process.cwd(), config.theme);
+    const absThemePath = path11.resolve(process.cwd(), config.theme);
     fs8.writeFileSync(absThemePath, generateThemeFile(preset), "utf-8");
-    const contextPath = path10.join(path10.dirname(absThemePath), "pdfx-theme-context.tsx");
+    const contextPath = path11.join(path11.dirname(absThemePath), "pdfx-theme-context.tsx");
     if (!fs8.existsSync(contextPath)) {
-      ensureDir(path10.dirname(contextPath));
+      ensureDir(path11.dirname(contextPath));
       fs8.writeFileSync(contextPath, generateThemeContextFile(), "utf-8");
     }
     spinner.succeed(`Switched to ${validatedPreset} theme`);
   } catch (error) {
     spinner.fail("Failed to switch theme");
     const message = error instanceof Error ? error.message : String(error);
-    console.error(chalk8.dim(`  ${message}`));
+    console.error(chalk9.dim(`  ${message}`));
     process.exit(1);
   }
 }
@@ -6290,48 +6738,48 @@ function parseThemeObject(themePath) {
   throw new Error("No exported `theme` object found.");
 }
 async function themeValidate() {
-  const configPath = path10.join(process.cwd(), "pdfx.json");
+  const configPath = path11.join(process.cwd(), "pdfx.json");
   if (!fs8.existsSync(configPath)) {
-    console.error(chalk8.red('No pdfx.json found. Run "pdfx init" first.'));
+    console.error(chalk9.red('No pdfx.json found. Run "pdfx init" first.'));
     process.exit(1);
   }
   const rawConfig = readJsonFile(configPath);
   const configResult = configSchema.safeParse(rawConfig);
   if (!configResult.success) {
-    console.error(chalk8.red("Invalid pdfx.json configuration."));
+    console.error(chalk9.red("Invalid pdfx.json configuration."));
     process.exit(1);
   }
   if (!configResult.data.theme) {
     console.error(
-      chalk8.red('No theme path in pdfx.json. Run "pdfx theme init" to set up theming.')
+      chalk9.red('No theme path in pdfx.json. Run "pdfx theme init" to set up theming.')
     );
     process.exit(1);
   }
-  const absThemePath = path10.resolve(process.cwd(), configResult.data.theme);
+  const absThemePath = path11.resolve(process.cwd(), configResult.data.theme);
   if (!fs8.existsSync(absThemePath)) {
-    console.error(chalk8.red(`Theme file not found: ${configResult.data.theme}`));
+    console.error(chalk9.red(`Theme file not found: ${configResult.data.theme}`));
     process.exit(1);
   }
-  const spinner = ora7("Validating theme file...").start();
+  const spinner = ora8("Validating theme file...").start();
   try {
     const parsedTheme = parseThemeObject(absThemePath);
     const result = themeSchema.safeParse(parsedTheme);
     if (!result.success) {
-      const issues = result.error.issues.map((issue) => `  \u2192 ${chalk8.yellow(issue.path.join("."))}: ${issue.message}`).join("\n");
+      const issues = result.error.issues.map((issue) => `  \u2192 ${chalk9.yellow(issue.path.join("."))}: ${issue.message}`).join("\n");
       spinner.fail("Theme validation failed");
-      console.log(chalk8.red("\n  Missing or invalid fields:\n"));
+      console.log(chalk9.red("\n  Missing or invalid fields:\n"));
       console.log(issues);
-      console.log(chalk8.dim("\n  Fix these fields in your theme file and run validate again.\n"));
+      console.log(chalk9.dim("\n  Fix these fields in your theme file and run validate again.\n"));
       process.exit(1);
     }
     spinner.succeed("Theme file is valid");
-    console.log(chalk8.dim(`
+    console.log(chalk9.dim(`
   Validated: ${configResult.data.theme}
 `));
   } catch (error) {
     spinner.fail("Failed to validate theme");
     const message = error instanceof Error ? error.message : String(error);
-    console.error(chalk8.dim(`  ${message}`));
+    console.error(chalk9.dim(`  ${message}`));
     process.exit(1);
   }
 }
@@ -6361,4 +6809,7 @@ themeCmd.command("validate").description("Validate your theme file").action(them
 var templateCmd = program.command("template").description("Manage PDF templates");
 templateCmd.command("add <templates...>").description("Add a template to your project").option("-f, --force", "Overwrite existing files without prompting").action((templates, options) => templateAdd(templates, options));
 templateCmd.command("list").description("List available templates from registry").action(templateList);
+var blockCmd = program.command("block").description("Manage PDF blocks (copy-paste designs)");
+blockCmd.command("add <blocks...>").description("Add a block to your project").option("-f, --force", "Overwrite existing files without prompting").action((blocks, options) => blockAdd(blocks, options));
+blockCmd.command("list").description("List available blocks from registry").action(blockList);
 program.parse();