resuml 1.2.6 → 1.3.0

package/dist/index.js

@@ -39,7 +39,7 @@ var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
   "node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
-    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
+    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
   }
 });
@@ -181,7 +181,7 @@ var require_brace_expansion = __commonJS({
         var isSequence = isNumericSequence || isAlphaSequence;
         var isOptions = m.body.indexOf(",") >= 0;
         if (!isSequence && !isOptions) {
-          if (m.post.match(/,.*\}/)) {
+          if (m.post.match(/,(?!,).*\}/)) {
             str = m.pre + "{" + m.body + escClose + m.post;
             return expand2(str);
           }
@@ -267,8 +267,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 init_cjs_shims();
 var import_commander = require("commander");
-var import_path2 = __toESM(require("path"));
-var import_fs5 = __toESM(require("fs"));
+var import_path3 = __toESM(require("path"));
+var import_fs7 = __toESM(require("fs"));
 var import_url = require("url");
 
 // src/commands/validate.ts
@@ -1012,7 +1012,7 @@ var path = {
 };
 var sep = defaultPlatform === "win32" ? path.win32.sep : path.posix.sep;
 minimatch.sep = sep;
-var GLOBSTAR = Symbol("globstar **");
+var GLOBSTAR = /* @__PURE__ */ Symbol("globstar **");
 minimatch.GLOBSTAR = GLOBSTAR;
 var qmark2 = "[^/]";
 var star2 = qmark2 + "*?";
@@ -1717,7 +1717,6 @@ if (typeof AC === "undefined") {
   };
 }
 var shouldWarn = (code) => !warned.has(code);
-var TYPE = Symbol("type");
 var isPosInt = (n) => n && n === Math.floor(n) && n > 0 && isFinite(n);
 var getUintArray = (max) => !isPosInt(max) ? null : max <= Math.pow(2, 8) ? Uint8Array : max <= Math.pow(2, 16) ? Uint16Array : max <= Math.pow(2, 32) ? Uint32Array : max <= Number.MAX_SAFE_INTEGER ? ZeroArray : null;
 var ZeroArray = class extends Array {
@@ -3062,37 +3061,37 @@ var isStream = (s) => !!s && typeof s === "object" && (s instanceof Minipass ||
 var isReadable = (s) => !!s && typeof s === "object" && s instanceof import_node_events.EventEmitter && typeof s.pipe === "function" && // node core Writable streams have a pipe() method, but it throws
 s.pipe !== import_node_stream.default.Writable.prototype.pipe;
 var isWritable = (s) => !!s && typeof s === "object" && s instanceof import_node_events.EventEmitter && typeof s.write === "function" && typeof s.end === "function";
-var EOF = Symbol("EOF");
-var MAYBE_EMIT_END = Symbol("maybeEmitEnd");
-var EMITTED_END = Symbol("emittedEnd");
-var EMITTING_END = Symbol("emittingEnd");
-var EMITTED_ERROR = Symbol("emittedError");
-var CLOSED = Symbol("closed");
-var READ = Symbol("read");
-var FLUSH = Symbol("flush");
-var FLUSHCHUNK = Symbol("flushChunk");
-var ENCODING = Symbol("encoding");
-var DECODER = Symbol("decoder");
-var FLOWING = Symbol("flowing");
-var PAUSED = Symbol("paused");
-var RESUME = Symbol("resume");
-var BUFFER = Symbol("buffer");
-var PIPES = Symbol("pipes");
-var BUFFERLENGTH = Symbol("bufferLength");
-var BUFFERPUSH = Symbol("bufferPush");
-var BUFFERSHIFT = Symbol("bufferShift");
-var OBJECTMODE = Symbol("objectMode");
-var DESTROYED = Symbol("destroyed");
-var ERROR = Symbol("error");
-var EMITDATA = Symbol("emitData");
-var EMITEND = Symbol("emitEnd");
-var EMITEND2 = Symbol("emitEnd2");
-var ASYNC = Symbol("async");
-var ABORT = Symbol("abort");
-var ABORTED = Symbol("aborted");
-var SIGNAL = Symbol("signal");
-var DATALISTENERS = Symbol("dataListeners");
-var DISCARDED = Symbol("discarded");
+var EOF = /* @__PURE__ */ Symbol("EOF");
+var MAYBE_EMIT_END = /* @__PURE__ */ Symbol("maybeEmitEnd");
+var EMITTED_END = /* @__PURE__ */ Symbol("emittedEnd");
+var EMITTING_END = /* @__PURE__ */ Symbol("emittingEnd");
+var EMITTED_ERROR = /* @__PURE__ */ Symbol("emittedError");
+var CLOSED = /* @__PURE__ */ Symbol("closed");
+var READ = /* @__PURE__ */ Symbol("read");
+var FLUSH = /* @__PURE__ */ Symbol("flush");
+var FLUSHCHUNK = /* @__PURE__ */ Symbol("flushChunk");
+var ENCODING = /* @__PURE__ */ Symbol("encoding");
+var DECODER = /* @__PURE__ */ Symbol("decoder");
+var FLOWING = /* @__PURE__ */ Symbol("flowing");
+var PAUSED = /* @__PURE__ */ Symbol("paused");
+var RESUME = /* @__PURE__ */ Symbol("resume");
+var BUFFER = /* @__PURE__ */ Symbol("buffer");
+var PIPES = /* @__PURE__ */ Symbol("pipes");
+var BUFFERLENGTH = /* @__PURE__ */ Symbol("bufferLength");
+var BUFFERPUSH = /* @__PURE__ */ Symbol("bufferPush");
+var BUFFERSHIFT = /* @__PURE__ */ Symbol("bufferShift");
+var OBJECTMODE = /* @__PURE__ */ Symbol("objectMode");
+var DESTROYED = /* @__PURE__ */ Symbol("destroyed");
+var ERROR = /* @__PURE__ */ Symbol("error");
+var EMITDATA = /* @__PURE__ */ Symbol("emitData");
+var EMITEND = /* @__PURE__ */ Symbol("emitEnd");
+var EMITEND2 = /* @__PURE__ */ Symbol("emitEnd2");
+var ASYNC = /* @__PURE__ */ Symbol("async");
+var ABORT = /* @__PURE__ */ Symbol("abort");
+var ABORTED = /* @__PURE__ */ Symbol("aborted");
+var SIGNAL = /* @__PURE__ */ Symbol("signal");
+var DATALISTENERS = /* @__PURE__ */ Symbol("dataListeners");
+var DISCARDED = /* @__PURE__ */ Symbol("discarded");
 var defer = (fn) => Promise.resolve().then(fn);
 var nodefer = (fn) => fn();
 var isEndish = (ev) => ev === "end" || ev === "finish" || ev === "prefinish";
@@ -4005,7 +4004,7 @@ var ChildrenCache = class extends LRUCache {
     });
   }
 };
-var setAsCwd = Symbol("PathScurry setAsCwd");
+var setAsCwd = /* @__PURE__ */ Symbol("PathScurry setAsCwd");
 var PathBase = class {
   /**
    * the basename of this path
@@ -4191,12 +4190,12 @@ var PathBase = class {
   /**
    * Get the Path object referenced by the string path, resolved from this Path
    */
-  resolve(path6) {
-    if (!path6) {
+  resolve(path8) {
+    if (!path8) {
       return this;
     }
-    const rootPath = this.getRootString(path6);
-    const dir = path6.substring(rootPath.length);
+    const rootPath = this.getRootString(path8);
+    const dir = path8.substring(rootPath.length);
     const dirParts = dir.split(this.splitSep);
     const result = rootPath ? this.getRoot(rootPath).#resolveParts(dirParts) : this.#resolveParts(dirParts);
     return result;
@@ -4948,8 +4947,8 @@ var PathWin32 = class _PathWin32 extends PathBase {
   /**
    * @internal
    */
-  getRootString(path6) {
-    return import_node_path.win32.parse(path6).root;
+  getRootString(path8) {
+    return import_node_path.win32.parse(path8).root;
   }
   /**
    * @internal
@@ -4995,8 +4994,8 @@ var PathPosix = class _PathPosix extends PathBase {
   /**
    * @internal
    */
-  getRootString(path6) {
-    return path6.startsWith("/") ? "/" : "";
+  getRootString(path8) {
+    return path8.startsWith("/") ? "/" : "";
   }
   /**
    * @internal
@@ -5045,8 +5044,8 @@ var PathScurryBase = class {
    *
    * @internal
    */
-  constructor(cwd = process.cwd(), pathImpl, sep2, { nocase, childrenCacheSize = 16 * 1024, fs: fs7 = defaultFS } = {}) {
-    this.#fs = fsFromOption(fs7);
+  constructor(cwd = process.cwd(), pathImpl, sep2, { nocase, childrenCacheSize = 16 * 1024, fs: fs9 = defaultFS } = {}) {
+    this.#fs = fsFromOption(fs9);
     if (cwd instanceof URL || cwd.startsWith("file://")) {
       cwd = (0, import_node_url.fileURLToPath)(cwd);
     }
@@ -5085,11 +5084,11 @@ var PathScurryBase = class {
   /**
    * Get the depth of a provided path, string, or the cwd
    */
-  depth(path6 = this.cwd) {
-    if (typeof path6 === "string") {
-      path6 = this.cwd.resolve(path6);
+  depth(path8 = this.cwd) {
+    if (typeof path8 === "string") {
+      path8 = this.cwd.resolve(path8);
     }
-    return path6.depth();
+    return path8.depth();
   }
   /**
    * Return the cache of child entries.  Exposed so subclasses can create
@@ -5576,9 +5575,9 @@ var PathScurryBase = class {
     process2();
     return results;
   }
-  chdir(path6 = this.cwd) {
+  chdir(path8 = this.cwd) {
     const oldCwd = this.cwd;
-    this.cwd = typeof path6 === "string" ? this.cwd.resolve(path6) : path6;
+    this.cwd = typeof path8 === "string" ? this.cwd.resolve(path8) : path8;
     this.cwd[setAsCwd](oldCwd);
   }
 };
@@ -5604,8 +5603,8 @@ var PathScurryWin32 = class extends PathScurryBase {
   /**
    * @internal
    */
-  newRoot(fs7) {
-    return new PathWin32(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs7 });
+  newRoot(fs9) {
+    return new PathWin32(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs9 });
   }
   /**
    * Return true if the provided path string is an absolute path
@@ -5633,8 +5632,8 @@ var PathScurryPosix = class extends PathScurryBase {
   /**
    * @internal
    */
-  newRoot(fs7) {
-    return new PathPosix(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs7 });
+  newRoot(fs9) {
+    return new PathPosix(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs9 });
   }
   /**
    * Return true if the provided path string is an absolute path
@@ -5940,8 +5939,8 @@ var MatchRecord = class {
   }
   // match, absolute, ifdir
   entries() {
-    return [...this.store.entries()].map(([path6, n]) => [
-      path6,
+    return [...this.store.entries()].map(([path8, n]) => [
+      path8,
       !!(n & 2),
       !!(n & 1)
     ]);
@@ -6146,9 +6145,9 @@ var GlobUtil = class {
   signal;
   maxDepth;
   includeChildMatches;
-  constructor(patterns, path6, opts) {
+  constructor(patterns, path8, opts) {
     this.patterns = patterns;
-    this.path = path6;
+    this.path = path8;
     this.opts = opts;
     this.#sep = !opts.posix && opts.platform === "win32" ? "\\" : "/";
     this.includeChildMatches = opts.includeChildMatches !== false;
@@ -6167,11 +6166,11 @@ var GlobUtil = class {
       });
     }
   }
-  #ignored(path6) {
-    return this.seen.has(path6) || !!this.#ignore?.ignored?.(path6);
+  #ignored(path8) {
+    return this.seen.has(path8) || !!this.#ignore?.ignored?.(path8);
   }
-  #childrenIgnored(path6) {
-    return !!this.#ignore?.childrenIgnored?.(path6);
+  #childrenIgnored(path8) {
+    return !!this.#ignore?.childrenIgnored?.(path8);
   }
   // backpressure mechanism
   pause() {
@@ -6386,8 +6385,8 @@ var GlobUtil = class {
 };
 var GlobWalker = class extends GlobUtil {
   matches = /* @__PURE__ */ new Set();
-  constructor(patterns, path6, opts) {
-    super(patterns, path6, opts);
+  constructor(patterns, path8, opts) {
+    super(patterns, path8, opts);
   }
   matchEmit(e) {
     this.matches.add(e);
@@ -6424,8 +6423,8 @@ var GlobWalker = class extends GlobUtil {
 };
 var GlobStream = class extends GlobUtil {
   results;
-  constructor(patterns, path6, opts) {
-    super(patterns, path6, opts);
+  constructor(patterns, path8, opts) {
+    super(patterns, path8, opts);
     this.results = new Minipass({
       signal: this.signal,
       objectMode: true
@@ -6795,8 +6794,8 @@ function handleCommandError(error, command, debug = false) {
     if (debug) {
       console.error("\nValidation failed with the following errors:");
       errors.forEach((err, index) => {
-        const path6 = err.instancePath || "root";
-        console.error(`${index + 1}. Path: ${path6}`);
+        const path8 = err.instancePath || "root";
+        console.error(`${index + 1}. Path: ${path8}`);
         console.error(`   Error: ${err.message || "Unknown validation error"}`);
         if (err.params) {
           console.error(`   Params: ${JSON.stringify(err.params)}`);
@@ -6806,8 +6805,8 @@ function handleCommandError(error, command, debug = false) {
       console.error("\nSome validation errors were found:");
       const maxErrors = 5;
       errors.slice(0, maxErrors).forEach((err, index) => {
-        const path6 = err.instancePath || "root";
-        console.error(`${index + 1}. Field: ${path6}`);
+        const path8 = err.instancePath || "root";
+        console.error(`${index + 1}. Field: ${path8}`);
         console.error(`   Error: ${err.message || "Unknown validation error"}`);
       });
       if (errors.length > maxErrors) {
@@ -6824,15 +6823,15 @@ function handleCommandError(error, command, debug = false) {
 
 // src/commands/validate.ts
 async function validateAction(options) {
-  const chalk3 = (await import("chalk")).default;
-  console.log(chalk3.blue("Starting resuml validate..."));
+  const chalk6 = (await import("chalk")).default;
+  console.log(chalk6.blue("Starting resuml validate..."));
   try {
     const inputPath = options.resume;
     const { yamlContents } = await loadResumeFiles(inputPath);
-    console.log(chalk3.blue("Validating resume data..."));
+    console.log(chalk6.blue("Validating resume data..."));
     try {
       await processResumeData(yamlContents);
-      console.log(chalk3.green("\u2713 Resume data is valid against the schema!"));
+      console.log(chalk6.green("\u2713 Resume data is valid against the schema!"));
     } catch (error) {
       handleCommandError(error, "validate", options.debug);
       return;
@@ -6846,17 +6845,17 @@ async function validateAction(options) {
 init_cjs_shims();
 var import_fs2 = __toESM(require("fs"));
 async function toJsonAction(options) {
-  const chalk3 = (await import("chalk")).default;
-  console.log(chalk3.blue("Starting resuml tojson..."));
+  const chalk6 = (await import("chalk")).default;
+  console.log(chalk6.blue("Starting resuml tojson..."));
   try {
     const inputPath = options.resume;
     const { yamlContents } = await loadResumeFiles(inputPath);
-    console.log(chalk3.blue("Processing and validating data..."));
+    console.log(chalk6.blue("Processing and validating data..."));
     const resumeData = await processResumeData(yamlContents);
-    console.log(chalk3.green("Processing and validation successful!"));
+    console.log(chalk6.green("Processing and validation successful!"));
     const jsonOutput = JSON.stringify(resumeData, null, 2);
     import_fs2.default.writeFileSync(options.output, jsonOutput, "utf8");
-    console.log(chalk3.green(`Successfully wrote output to ${options.output}`));
+    console.log(chalk6.green(`Successfully wrote output to ${options.output}`));
   } catch (error) {
     handleCommandError(error, "tojson", options.debug);
   }
@@ -7059,6 +7058,363 @@ async function startDevServer(port) {
   });
 }
 
+// src/commands/init.ts
+init_cjs_shims();
+var import_fs5 = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
+var import_readline = __toESM(require("readline"));
+var import_chalk3 = __toESM(require("chalk"));
+function createReadlineInterface() {
+  return import_readline.default.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+}
+function ask(rl, question, defaultValue) {
+  const prompt = defaultValue ? `${question} (${defaultValue}): ` : `${question}: `;
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => {
+      resolve(answer.trim() || defaultValue || "");
+    });
+  });
+}
+function generateResumeYaml(name, email, label) {
+  return `# =============================================================================
+# Resume - Generated by resuml
+# Documentation: https://github.com/phoinixi/resuml
+# Schema: https://jsonresume.org/schema/
+# =============================================================================
+
+# --- Basic Information ---
+basics:
+  name: '${name}'
+  label: '${label}'
+  # image: 'https://example.com/photo.jpg'
+  email: '${email}'
+  # phone: '+1-555-123-4567'
+  # url: 'https://yourwebsite.com'
+  summary: >-
+    Write a short professional summary here.
+    This supports multi-line strings in YAML.
+  location:
+    # address: '123 Main Street'
+    # postalCode: '12345'
+    city: 'Your City'
+    countryCode: 'US'
+    # region: 'Your State'
+  profiles:
+    - network: 'LinkedIn'
+      username: 'your-username'
+      url: 'https://linkedin.com/in/your-username'
+    - network: 'GitHub'
+      username: 'your-username'
+      url: 'https://github.com/your-username'
+
+# --- Work Experience ---
+work:
+  - name: 'Company Name'
+    position: 'Job Title'
+    url: 'https://company.com'
+    startDate: '2020-01-01'
+    # endDate: '2023-12-31'  # Omit for current position
+    summary: 'Brief description of your role and responsibilities.'
+    highlights:
+      - 'Key achievement or responsibility'
+      - 'Another notable accomplishment'
+
+# --- Education ---
+education:
+  - institution: 'University Name'
+    url: 'https://university.edu'
+    area: 'Field of Study'
+    studyType: 'Bachelor of Science'
+    startDate: '2014-09-01'
+    endDate: '2018-06-01'
+    # score: '3.8'
+    courses:
+      - 'Relevant Course 1'
+      - 'Relevant Course 2'
+
+# --- Skills ---
+skills:
+  - name: 'Programming Languages'
+    level: 'Expert'
+    keywords:
+      - 'JavaScript'
+      - 'TypeScript'
+      - 'Python'
+  - name: 'Frameworks'
+    level: 'Advanced'
+    keywords:
+      - 'React'
+      - 'Node.js'
+
+# --- Projects ---
+# projects:
+#   - name: 'Project Name'
+#     description: 'Brief project description'
+#     highlights:
+#       - 'Key feature or result'
+#     keywords:
+#       - 'Technology Used'
+#     startDate: '2023-01-01'
+#     endDate: '2023-06-30'
+#     url: 'https://github.com/you/project'
+#     roles:
+#       - 'Developer'
+#     type: 'application'
+
+# --- Languages ---
+# languages:
+#   - language: 'English'
+#     fluency: 'Native speaker'
+#   - language: 'Spanish'
+#     fluency: 'Professional working proficiency'
+
+# --- Interests ---
+# interests:
+#   - name: 'Open Source'
+#     keywords:
+#       - 'Contributing'
+#       - 'Community'
+
+# --- References ---
+# references:
+#   - name: 'Jane Smith'
+#     reference: 'It was a pleasure working with...'
+
+# --- Awards ---
+# awards:
+#   - title: 'Award Name'
+#     date: '2023-01-01'
+#     awarder: 'Organization'
+#     summary: 'Description of the award'
+
+# --- Certificates ---
+# certificates:
+#   - name: 'Certificate Name'
+#     date: '2023-01-01'
+#     issuer: 'Issuing Organization'
+#     url: 'https://example.com/cert'
+
+# --- Publications ---
+# publications:
+#   - name: 'Publication Title'
+#     publisher: 'Publisher'
+#     releaseDate: '2023-01-01'
+#     url: 'https://example.com/publication'
+#     summary: 'Brief description'
+
+# --- Volunteer ---
+# volunteers:
+#   - organization: 'Organization Name'
+#     position: 'Volunteer Role'
+#     url: 'https://organization.com'
+#     startDate: '2022-01-01'
+#     summary: 'Description of volunteer work'
+#     highlights:
+#       - 'Notable contribution'
+`;
+}
+async function initAction(options) {
+  const outputPath = options.output || "resume.yaml";
+  const fullPath = import_path2.default.resolve(outputPath);
+  const rl = createReadlineInterface();
+  try {
+    if (import_fs5.default.existsSync(fullPath)) {
+      const overwrite = await ask(
+        rl,
+        `${import_chalk3.default.yellow("\u26A0")}  ${outputPath} already exists. Overwrite? (y/N)`,
+        "N"
+      );
+      if (overwrite.toLowerCase() !== "y") {
+        console.log(import_chalk3.default.blue("Aborted. No files were changed."));
+        return;
+      }
+    }
+    console.log(import_chalk3.default.blue("\n\u{1F4DD} Let's set up your resume!\n"));
+    const name = await ask(rl, "Your full name", "John Doe");
+    const email = await ask(rl, "Email address", "john@example.com");
+    const label = await ask(rl, "Professional title/label", "Software Engineer");
+    const yaml = generateResumeYaml(name, email, label);
+    import_fs5.default.mkdirSync(import_path2.default.dirname(fullPath), { recursive: true });
+    import_fs5.default.writeFileSync(fullPath, yaml, "utf8");
+    console.log(import_chalk3.default.green(`
+\u2705 Created ${outputPath}`));
+    console.log(import_chalk3.default.blue("\nNext steps:"));
+    console.log(`  1. Edit ${outputPath} to fill in your details`);
+    console.log("  2. Run " + import_chalk3.default.cyan("resuml validate --resume " + outputPath));
+    console.log("  3. Run " + import_chalk3.default.cyan("resuml render --resume " + outputPath + " --theme stackoverflow"));
+  } finally {
+    rl.close();
+  }
+}
+
+// src/commands/pdf.ts
+init_cjs_shims();
+var import_fs6 = __toESM(require("fs"));
+var import_node_path4 = __toESM(require("path"));
+var import_chalk4 = __toESM(require("chalk"));
+async function loadPuppeteer() {
+  try {
+    const puppeteer = await import("puppeteer");
+    return puppeteer.default || puppeteer;
+  } catch {
+    throw new Error(
+      `Puppeteer is required for PDF export but is not installed.
+Install it with: ${import_chalk4.default.cyan("npm install puppeteer")}
+Or for a smaller download: ${import_chalk4.default.cyan("npm install puppeteer-core")}`
+    );
+  }
+}
+function parseMargin(margin) {
+  const defaultMargin = { top: "10mm", right: "10mm", bottom: "10mm", left: "10mm" };
+  if (!margin) return defaultMargin;
+  const parts = margin.split(",").map((s) => s.trim());
+  if (parts.length === 1) {
+    return { top: parts[0], right: parts[0], bottom: parts[0], left: parts[0] };
+  }
+  if (parts.length === 2) {
+    return { top: parts[0], right: parts[1], bottom: parts[0], left: parts[1] };
+  }
+  if (parts.length === 4) {
+    return { top: parts[0], right: parts[1], bottom: parts[2], left: parts[3] };
+  }
+  return defaultMargin;
+}
+async function pdfAction(options) {
+  if (!options.theme) {
+    throw new Error(
+      "--theme option is required. Please specify a theme name (e.g., stackoverflow, react)."
+    );
+  }
+  console.log(import_chalk4.default.blue("Starting resuml PDF export..."));
+  try {
+    const inputPath = options.resume;
+    const { yamlContents } = await loadResumeFiles(inputPath);
+    console.log(import_chalk4.default.blue("Processing and validating resume data..."));
+    const resumeData = await processResumeData(yamlContents);
+    console.log(import_chalk4.default.green("Resume data processing and validation successful!"));
+    const theme = await loadTheme(options.theme);
+    const htmlOutput = await theme.render(resumeData, {
+      locale: options.language
+    });
+    console.log(import_chalk4.default.blue("Loading Puppeteer..."));
+    const puppeteer = await loadPuppeteer();
+    const outputPath = options.output || "resume.pdf";
+    const format = options.format === "Letter" ? "Letter" : "A4";
+    const margin = parseMargin(options.margin);
+    console.log(import_chalk4.default.blue(`Generating PDF (${format} format)...`));
+    const browser = await puppeteer.launch({ headless: true });
+    try {
+      const page = await browser.newPage();
+      await page.setContent(htmlOutput, { waitUntil: "networkidle0" });
+      const pdfBuffer = await page.pdf({
+        format,
+        margin,
+        printBackground: true,
+        preferCSSPageSize: true
+      });
+      import_fs6.default.mkdirSync(import_node_path4.default.dirname(import_node_path4.default.resolve(outputPath)), { recursive: true });
+      import_fs6.default.writeFileSync(outputPath, pdfBuffer);
+      console.log(import_chalk4.default.green(`\u2705 Successfully generated ${outputPath}`));
+    } finally {
+      await browser.close();
+    }
+  } catch (error) {
+    handleCommandError(error, "pdf", options.debug);
+  }
+}
+
+// src/commands/themes.ts
+init_cjs_shims();
+var import_chalk5 = __toESM(require("chalk"));
+var import_child_process2 = require("child_process");
+var import_module2 = require("module");
+var KNOWN_THEMES = [
+  { name: "stackoverflow", pkg: "jsonresume-theme-stackoverflow", description: "Stack Overflow inspired theme" },
+  { name: "elegant", pkg: "jsonresume-theme-elegant", description: "Elegant and professional" },
+  { name: "react", pkg: "jsonresume-theme-react", description: "Built with React components" },
+  { name: "even", pkg: "jsonresume-theme-even", description: "Clean and minimal" },
+  { name: "kendall", pkg: "jsonresume-theme-kendall", description: "Simple and clean layout" },
+  { name: "macchiato", pkg: "jsonresume-theme-macchiato", description: "Beautiful and modern" },
+  { name: "flat", pkg: "jsonresume-theme-flat", description: "Flat design theme" },
+  { name: "class", pkg: "jsonresume-theme-class", description: "Classic professional look" },
+  { name: "short", pkg: "jsonresume-theme-short", description: "Compact single-page resume" },
+  { name: "spartan", pkg: "jsonresume-theme-spartan", description: "Minimalist Spartan design" },
+  { name: "paper", pkg: "jsonresume-theme-paper", description: "Paper-like clean design" },
+  { name: "onepage", pkg: "jsonresume-theme-onepage", description: "One page resume layout" }
+];
+function isThemeInstalled(pkg) {
+  try {
+    const require3 = (0, import_module2.createRequire)(process.cwd() + "/");
+    require3.resolve(pkg);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getInstalledVersion(pkg) {
+  try {
+    const require3 = (0, import_module2.createRequire)(process.cwd() + "/");
+    const pkgJson = require3(`${pkg}/package.json`);
+    return pkgJson.version || null;
+  } catch {
+    return null;
+  }
+}
+function listThemes() {
+  console.log(import_chalk5.default.blue("\n\u{1F4E6} Compatible JSON Resume Themes\n"));
+  const nameWidth = 16;
+  const pkgWidth = 38;
+  console.log(
+    `  ${"Status".padEnd(10)}${"Name".padEnd(nameWidth)}${"Package".padEnd(pkgWidth)}Description`
+  );
+  console.log(`  ${"\u2500".repeat(10)}${"\u2500".repeat(nameWidth)}${"\u2500".repeat(pkgWidth)}${"\u2500".repeat(30)}`);
+  for (const theme of KNOWN_THEMES) {
+    const installed = isThemeInstalled(theme.pkg);
+    const version = installed ? getInstalledVersion(theme.pkg) : null;
+    const status = installed ? import_chalk5.default.green(`\u2713 ${version || "yes"}`.padEnd(10)) : import_chalk5.default.yellow("not installed".substring(0, 10).padEnd(10));
+    console.log(
+      `  ${status}${theme.name.padEnd(nameWidth)}${import_chalk5.default.blue(theme.pkg.padEnd(pkgWidth))}${theme.description}`
+    );
+  }
+  console.log(import_chalk5.default.blue("\nInstall a theme:"));
+  console.log(`  ${import_chalk5.default.cyan("resuml themes --install <name>")}`);
+  console.log(`  ${import_chalk5.default.cyan("resuml themes --install stackoverflow")}
+`);
+  console.log(
+    import_chalk5.default.blue("Browse all themes: ") + "https://www.npmjs.com/search?q=jsonresume-theme\n"
+  );
+}
+function installTheme2(name) {
+  const known = KNOWN_THEMES.find((t) => t.name === name);
+  const pkg = known ? known.pkg : name.startsWith("jsonresume-theme-") ? name : `jsonresume-theme-${name}`;
+  console.log(import_chalk5.default.blue(`
+\u{1F4E6} Installing ${pkg}...
+`));
+  try {
+    (0, import_child_process2.execSync)(`npm install ${pkg}`, { stdio: "inherit" });
+    console.log(import_chalk5.default.green(`
+\u2705 Successfully installed ${pkg}`));
+    console.log(import_chalk5.default.blue(`
+Use it with: ${import_chalk5.default.cyan(`resuml render --theme ${known?.name || name}`)}
+`));
+  } catch {
+    console.error(import_chalk5.default.red(`
+\u274C Failed to install ${pkg}`));
+    console.error(import_chalk5.default.yellow(`Make sure the package exists: https://www.npmjs.com/package/${pkg}
+`));
+  }
+}
+async function themesAction(options) {
+  if (options.install) {
+    installTheme2(options.install);
+  } else {
+    listThemes();
+  }
+}
+
 // src/utils/themeRender.ts
 var themeRender_exports = {};
 __export(themeRender_exports, {
@@ -7113,12 +7469,12 @@ function injectCss(html, css) {
 }
 
 // src/index.ts
-var currentDir = import_path2.default.dirname((0, import_url.fileURLToPath)(importMetaUrl));
+var currentDir = import_path3.default.dirname((0, import_url.fileURLToPath)(importMetaUrl));
 function getCliVersion() {
-  const packageJsonPath = import_path2.default.resolve(currentDir, "../package.json");
-  if (import_fs5.default.existsSync(packageJsonPath)) {
+  const packageJsonPath = import_path3.default.resolve(currentDir, "../package.json");
+  if (import_fs7.default.existsSync(packageJsonPath)) {
     try {
-      const packageJson = JSON.parse(import_fs5.default.readFileSync(packageJsonPath, "utf8"));
+      const packageJson = JSON.parse(import_fs7.default.readFileSync(packageJsonPath, "utf8"));
       return packageJson.version || "0.0.0";
     } catch {
       return "0.0.0";
@@ -7132,6 +7488,9 @@ program.command("validate").description("Validates resume data against the schem
 program.command("tojson").description("Converts YAML resume data to JSON format.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-o, --output <file>", "Output JSON file path.", "resume.json").option("--debug", "Show detailed validation and processing information.").action(toJsonAction);
 program.command("render").description("Renders the resume data using a specified theme.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-t, --theme <name>", "Theme name (e.g., stackoverflow, react).").option("-o, --output <file>", "Output HTML file path (defaults to resume.html).").option("--language <code>", "Language code for localization.", "en").option("--debug", "Show detailed validation and processing information.").action(renderAction);
 program.command("dev").description("Start development server with hot-reload.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-t, --theme <name>", "Theme name (e.g., stackoverflow, react).").option("--port <number>", "Port for development server.", "3000").option("--language <code>", "Language code for localization.", "en").option("--debug", "Show detailed validation and processing information.").action(devAction);
+program.command("init").description("Scaffold a starter resume.yaml file with all sections.").option("-o, --output <file>", "Output YAML file path.", "resume.yaml").action(initAction);
+program.command("pdf").description("Export resume as PDF using Puppeteer.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-t, --theme <name>", "Theme name (e.g., stackoverflow, react).").option("-o, --output <file>", "Output PDF file path.", "resume.pdf").option("--language <code>", "Language code for localization.", "en").option("--format <size>", "Page format: A4 or Letter.", "A4").option("--margin <values>", 'Page margins (e.g., "10mm" or "10mm,15mm,10mm,15mm").').option("--debug", "Show detailed validation and processing information.").action(pdfAction);
+program.command("themes").description("List available JSON Resume themes and install them.").option("--install <name>", "Install a theme by name (e.g., stackoverflow, elegant).").action(themesAction);
 if (process.env.NODE_ENV !== "test") {
   (async () => {
     try {