@masumdev/markforge 0.2.3 → 0.2.4

package/README.md

@@ -165,43 +165,133 @@ footer:
 
 ---
 
-## ⚙️ Configuration (`markforge.config.ts`)
+## ⚙️ Configuration Reference
+
+MarkForge automatically discovers configuration files starting from the input file's directory up to the workspace root, or via the `-c, --config <path>` CLI flag.
+
+### 1. TypeScript (`markforge.config.ts`)
 
 ```typescript
 import { defineConfig } from "@masumdev/markforge";
 
 export default defineConfig({
+  // Output formats: "docx" | "pdf" | "html"
   to: ["docx", "pdf", "html"],
   outputDir: "./dist/documents",
-  theme: "default",
-  orientation: "portrait",
-  paperSize: "A4",
+
+  // Theme: "default" | "academic" | "github" | "corporate" | "minimal" | "dracula"
+  theme: "academic",
+
+  // Custom CSS stylesheet(s) to inject
+  css: ["./styles/custom.css"],
+
+  // Page layout & dimensions
+  orientation: "portrait", // "portrait" | "landscape"
+  paperSize: "A4",         // "A4" | "Letter" | "Legal" | "A3" | "A5"
   margins: {
     top: "2.5cm",
     bottom: "2.5cm",
     left: "3cm",
     right: "3cm",
   },
+
+  // Multi-zone header & footer (supports tokens: {title}, {author}, {version}, {date}, {page}, {pages})
   header: {
-    left: "My Organization",
+    left: "Enterprise Architecture",
     center: "{title}",
     right: "v{version}",
   },
   footer: {
-    left: "Confidential",
+    left: "Confidential — Internal Use Only",
     right: "Page {page} of {pages}",
   },
-  toc: true,
-  embedImages: true,
-  watermark: {
-    enabled: false,       // disabled by default — enable to add branding
-    text: "DRAFT",
-    opacity: 0.07,
-    position: "diagonal",
+
+  // Document features
+  toc: true,                 // Auto-generate Table of Contents
+  embedImages: true,         // Embed/inline all images as Base64 data URIs
+  bundleHtml: true,          // Self-contained HTML with embedded styles and scripts
+  syntaxTheme: "github-dark", // "github-dark" | "github-light" | "dracula" | "monokai" | "nord"
+
+  // Diagonal page watermark
+  watermark: "CONFIDENTIAL",
+
+  // Default document metadata
+  metadata: {
+    title: "System Architecture Specification",
+    author: "Ma'sum",
+    version: "1.0.0",
+    company: "My Organization",
   },
+
+  // Server & watch options
+  watch: false,
+  serve: false,
+  port: 4000,
+  open: false,
 });
 ```
 
+### 2. JSON with `$schema` (`markforge.config.json`)
+
+Adding `$schema` enables **instant autocompletion and validation** in VS Code, WebStorm, and other IDEs:
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/masumdev/react-native-library/main/packages/markforge/schema.json",
+  "to": ["docx", "pdf", "html"],
+  "outputDir": "./dist/documents",
+  "theme": "academic",
+  "orientation": "portrait",
+  "paperSize": "A4",
+  "margins": {
+    "top": "2.5cm",
+    "bottom": "2.5cm",
+    "left": "3cm",
+    "right": "3cm"
+  },
+  "header": {
+    "left": "Enterprise Architecture",
+    "right": "{title}"
+  },
+  "footer": {
+    "left": "Confidential",
+    "right": "Page {page} of {pages}"
+  },
+  "toc": true,
+  "embedImages": true,
+  "syntaxTheme": "github-dark",
+  "watermark": "CONFIDENTIAL"
+}
+```
+
+### 3. YAML (`markforge.config.yaml` / `.markforgerc.yaml`)
+
+```yaml
+to:
+  - docx
+  - pdf
+  - html
+outputDir: ./dist/documents
+theme: academic
+orientation: portrait
+paperSize: A4
+margins:
+  top: 2.5cm
+  bottom: 2.5cm
+  left: 3cm
+  right: 3cm
+header:
+  left: Enterprise Architecture
+  right: "{title}"
+footer:
+  left: Confidential
+  right: "Page {page} of {pages}"
+toc: true
+embedImages: true
+watermark: CONFIDENTIAL
+```
+
+
 ---
 
 ## 💻 Programmatic API

package/dist/{App-DKCNXX3Z.mjs → App-IJVCGBJM.mjs}

@@ -12,7 +12,7 @@ import {
 } from "./chunk-NGC2ZAWZ.mjs";
 import {
   DEFAULT_CONFIG
-} from "./chunk-ASXSHC6H.mjs";
+} from "./chunk-IYGPJIK5.mjs";
 import "./chunk-YZHGBG4N.mjs";
 
 // src/ui/App.tsx

package/dist/chunk-IYGPJIK5.mjs

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+try {
+  if (typeof globalThis !== "undefined" && (!globalThis.localStorage || typeof globalThis.localStorage.getItem !== "function")) {
+    Object.defineProperty(globalThis, "localStorage", {
+      value: { getItem: () => null, setItem: () => {}, removeItem: () => {}, clear: () => {}, key: () => null, length: 0 },
+      configurable: true, writable: true,
+    });
+  }
+} catch {}
+import {
+  __require
+} from "./chunk-YZHGBG4N.mjs";
+
+// src/config/loadConfig.ts
+import * as fs from "fs";
+import * as path from "path";
+import { pathToFileURL } from "url";
+import * as YAML from "yaml";
+var DEFAULT_CONFIG_FILENAMES = [
+  "markforge.config.json",
+  ".markforgerc.json",
+  "markforge.config.yaml",
+  "markforge.config.yml",
+  ".markforgerc.yaml",
+  ".markforgerc.yml",
+  ".markforgerc",
+  "markforge.config.ts",
+  "markforge.config.js",
+  "markforge.config.mjs",
+  "markforge.config.cjs"
+];
+var DEFAULT_CONFIG = {
+  to: ["docx", "pdf"],
+  outputDir: void 0,
+  theme: "default",
+  css: void 0,
+  orientation: "portrait",
+  paperSize: "A4",
+  margins: {
+    top: "2.5cm",
+    bottom: "2.5cm",
+    left: "2.5cm",
+    right: "2.5cm"
+  },
+  header: void 0,
+  footer: {
+    right: "Page {page} of {pages}"
+  },
+  toc: false,
+  watermark: void 0,
+  embedImages: true,
+  metadata: void 0,
+  watch: false,
+  serve: false,
+  port: 4e3,
+  open: false,
+  bundleHtml: true,
+  syntaxTheme: "github-dark"
+};
+function discoverConfigFile(startDir) {
+  const dirsToCheck = [];
+  let curr = path.resolve(startDir);
+  while (curr) {
+    dirsToCheck.push(curr);
+    const parent = path.dirname(curr);
+    if (parent === curr) break;
+    curr = parent;
+  }
+  const cwd = path.resolve(process.cwd());
+  if (!dirsToCheck.includes(cwd)) {
+    dirsToCheck.push(cwd);
+  }
+  for (const dir of dirsToCheck) {
+    for (const filename of DEFAULT_CONFIG_FILENAMES) {
+      const candidate = path.join(dir, filename);
+      if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+        return candidate;
+      }
+    }
+  }
+  return null;
+}
+async function loadConfig(customPath, startDir = process.cwd()) {
+  let resolvedPath = null;
+  if (customPath) {
+    resolvedPath = path.isAbsolute(customPath) ? customPath : path.resolve(process.cwd(), customPath);
+    if (!fs.existsSync(resolvedPath)) {
+      const altPath = path.resolve(startDir, customPath);
+      if (fs.existsSync(altPath)) {
+        resolvedPath = altPath;
+      } else {
+        throw new Error(`Configuration file not found: ${resolvedPath}`);
+      }
+    }
+  } else {
+    resolvedPath = discoverConfigFile(startDir);
+  }
+  if (!resolvedPath) {
+    return {
+      config: { ...DEFAULT_CONFIG },
+      configPath: null
+    };
+  }
+  const ext = path.extname(resolvedPath).toLowerCase();
+  let userConfig = {};
+  try {
+    if (ext === ".json" || ext === "" || resolvedPath.endsWith(".markforgerc")) {
+      const raw = fs.readFileSync(resolvedPath, "utf-8").trim();
+      try {
+        userConfig = JSON.parse(raw);
+      } catch {
+        userConfig = YAML.parse(raw) || {};
+      }
+    } else if (ext === ".yaml" || ext === ".yml") {
+      const raw = fs.readFileSync(resolvedPath, "utf-8");
+      userConfig = YAML.parse(raw) || {};
+    } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
+      try {
+        const fileUrl = `${pathToFileURL(resolvedPath).href}?t=${Date.now()}`;
+        const mod = await import(fileUrl);
+        const rawExport = mod.default ?? mod.config ?? mod;
+        userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+      } catch (importErr) {
+        try {
+          const mod = __require(resolvedPath);
+          const rawExport = mod.default ?? mod.config ?? mod;
+          userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+        } catch {
+          throw importErr;
+        }
+      }
+    }
+  } catch (err) {
+    throw new Error(
+      `Failed to parse configuration file at ${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (userConfig && typeof userConfig === "object" && "$schema" in userConfig) {
+    delete userConfig.$schema;
+  }
+  const parsedConfig = userConfig;
+  const mergedConfig = {
+    ...DEFAULT_CONFIG,
+    ...parsedConfig,
+    margins: {
+      ...DEFAULT_CONFIG.margins,
+      ...parsedConfig.margins || {}
+    },
+    header: parsedConfig.header !== void 0 ? parsedConfig.header : DEFAULT_CONFIG.header,
+    footer: parsedConfig.footer !== void 0 ? parsedConfig.footer : DEFAULT_CONFIG.footer,
+    metadata: {
+      ...DEFAULT_CONFIG.metadata || {},
+      ...parsedConfig.metadata || {}
+    }
+  };
+  return {
+    config: mergedConfig,
+    configPath: resolvedPath
+  };
+}
+
+export {
+  DEFAULT_CONFIG,
+  loadConfig
+};

package/dist/cli.mjs

@@ -45,7 +45,7 @@ process.on("warning", (w) => {
 });
 async function main() {
   const program = new Command();
-  program.name("markforge").description("Modern Markdown & MDX multi-format publishing engine & CLI (DOCX, PDF, HTML, Images)").version(MARKFORGE_VERSION, "-V, --version", "Output current markforge version").argument("[input-file]", "Markdown or MDX source file to compile", "README.md").option("-t, --to <formats>", "Target formats to compile to (comma-separated: docx,pdf,html)", "docx,pdf").option("-o, --output <dir>", "Output directory for generated documents").option("--theme <theme>", "Built-in theme name (default, academic, github, corporate, minimal)").option("--css <path...>", "Custom CSS stylesheet(s) to inject").option("-c, --config <path>", "Path to custom markforge configuration file").option("--toc", "Force Table of Contents generation").option("-w, --watch", "Watch input file for changes and recompile", false).option("-s, --serve [port]", "Start local HTTP preview server", false).option("-O, --open", "Open compiled document in default browser", false);
+  program.name("markforge").description("Modern Markdown & MDX multi-format publishing engine & CLI (DOCX, PDF, HTML, Images)").version(MARKFORGE_VERSION, "-V, --version", "Output current markforge version").argument("[input-file]", "Markdown or MDX source file to compile", "README.md").option("-t, --to <formats>", "Target formats to compile to (comma-separated: docx,pdf,html)").option("-o, --output <dir>", "Output directory for generated documents").option("--theme <theme>", "Built-in theme name (default, academic, github, corporate, minimal)").option("--css <path...>", "Custom CSS stylesheet(s) to inject").option("-c, --config <path>", "Path to custom markforge configuration file").option("--toc", "Force Table of Contents generation").option("-w, --watch", "Watch input file for changes and recompile", false).option("-s, --serve [port]", "Start local HTTP preview server", false).option("-O, --open", "Open compiled document in default browser", false);
   program.parse(process.argv);
   const options = program.opts();
   const inputArg = program.args[0] || "README.md";
@@ -54,16 +54,19 @@ async function main() {
     console.error(`[ERROR] File not found: ${resolvedInputPath}`);
     process.exit(1);
   }
-  const rawFormats = (options.to || "docx,pdf").split(",").map((f) => f.trim().toLowerCase()).filter(Boolean);
+  const cliFormats = options.to ? options.to.split(",").map((f) => f.trim().toLowerCase()).filter(Boolean) : void 0;
   const [{ render }, { App }, { loadConfig }] = await Promise.all([
     import("ink"),
-    import("./App-DKCNXX3Z.mjs"),
-    import("./loadConfig-T4ZV6YY2.mjs")
+    import("./App-IJVCGBJM.mjs"),
+    import("./loadConfig-PD6ENMAM.mjs")
   ]);
-  const fileConfig = await loadConfig(options.config, path.dirname(resolvedInputPath));
+  const { config: fileConfig } = await loadConfig(
+    options.config,
+    path.dirname(resolvedInputPath)
+  );
   const mergedConfig = {
     ...fileConfig,
-    to: rawFormats.length > 0 ? rawFormats : fileConfig.to ?? ["docx", "pdf"],
+    to: cliFormats && cliFormats.length > 0 ? cliFormats : fileConfig.to ?? ["docx", "pdf"],
     ...options.output ? { outputDir: options.output } : {},
     ...options.theme ? { theme: options.theme } : {},
     ...options.css ? { css: options.css } : {},

package/dist/index.d.mts

@@ -333,7 +333,7 @@ declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css"
 /**
  * Resolves and loads markforge configuration from disk.
  */
-declare function loadConfig(customPath?: string, cwd?: string): Promise<{
+declare function loadConfig(customPath?: string, startDir?: string): Promise<{
     config: MarkforgeConfig;
     configPath: string | null;
 }>;

package/dist/index.d.ts

@@ -333,7 +333,7 @@ declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css"
 /**
  * Resolves and loads markforge configuration from disk.
  */
-declare function loadConfig(customPath?: string, cwd?: string): Promise<{
+declare function loadConfig(customPath?: string, startDir?: string): Promise<{
     config: MarkforgeConfig;
     configPath: string | null;
 }>;

package/dist/index.js

@@ -2302,21 +2302,43 @@ var DEFAULT_CONFIG = {
   bundleHtml: true,
   syntaxTheme: "github-dark"
 };
-async function loadConfig(customPath, cwd = process.cwd()) {
+function discoverConfigFile(startDir) {
+  const dirsToCheck = [];
+  let curr = path5.resolve(startDir);
+  while (curr) {
+    dirsToCheck.push(curr);
+    const parent = path5.dirname(curr);
+    if (parent === curr) break;
+    curr = parent;
+  }
+  const cwd = path5.resolve(process.cwd());
+  if (!dirsToCheck.includes(cwd)) {
+    dirsToCheck.push(cwd);
+  }
+  for (const dir of dirsToCheck) {
+    for (const filename of DEFAULT_CONFIG_FILENAMES) {
+      const candidate = path5.join(dir, filename);
+      if (fs5.existsSync(candidate) && fs5.statSync(candidate).isFile()) {
+        return candidate;
+      }
+    }
+  }
+  return null;
+}
+async function loadConfig(customPath, startDir = process.cwd()) {
   let resolvedPath = null;
   if (customPath) {
-    resolvedPath = path5.isAbsolute(customPath) ? customPath : path5.resolve(cwd, customPath);
+    resolvedPath = path5.isAbsolute(customPath) ? customPath : path5.resolve(process.cwd(), customPath);
     if (!fs5.existsSync(resolvedPath)) {
-      throw new Error(`Configuration file not found: ${resolvedPath}`);
-    }
-  } else {
-    for (const filename of DEFAULT_CONFIG_FILENAMES) {
-      const candidate = path5.resolve(cwd, filename);
-      if (fs5.existsSync(candidate)) {
-        resolvedPath = candidate;
-        break;
+      const altPath = path5.resolve(startDir, customPath);
+      if (fs5.existsSync(altPath)) {
+        resolvedPath = altPath;
+      } else {
+        throw new Error(`Configuration file not found: ${resolvedPath}`);
       }
     }
+  } else {
+    resolvedPath = discoverConfigFile(startDir);
   }
   if (!resolvedPath) {
     return {
@@ -2326,32 +2348,55 @@ async function loadConfig(customPath, cwd = process.cwd()) {
   }
   const ext = path5.extname(resolvedPath).toLowerCase();
   let userConfig = {};
-  if (ext === ".json" || resolvedPath.endsWith(".markforgerc")) {
-    const raw = fs5.readFileSync(resolvedPath, "utf-8");
-    userConfig = JSON.parse(raw);
-  } else if (ext === ".yaml" || ext === ".yml") {
-    const raw = fs5.readFileSync(resolvedPath, "utf-8");
-    userConfig = YAML.parse(raw);
-  } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
-    try {
-      const fileUrl = (0, import_node_url3.pathToFileURL)(resolvedPath).href;
-      const mod = await import(fileUrl);
-      userConfig = mod.default || mod;
-    } catch {
-      const required = require(resolvedPath);
-      userConfig = required.default || required;
+  try {
+    if (ext === ".json" || ext === "" || resolvedPath.endsWith(".markforgerc")) {
+      const raw = fs5.readFileSync(resolvedPath, "utf-8").trim();
+      try {
+        userConfig = JSON.parse(raw);
+      } catch {
+        userConfig = YAML.parse(raw) || {};
+      }
+    } else if (ext === ".yaml" || ext === ".yml") {
+      const raw = fs5.readFileSync(resolvedPath, "utf-8");
+      userConfig = YAML.parse(raw) || {};
+    } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
+      try {
+        const fileUrl = `${(0, import_node_url3.pathToFileURL)(resolvedPath).href}?t=${Date.now()}`;
+        const mod = await import(fileUrl);
+        const rawExport = mod.default ?? mod.config ?? mod;
+        userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+      } catch (importErr) {
+        try {
+          const mod = require(resolvedPath);
+          const rawExport = mod.default ?? mod.config ?? mod;
+          userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+        } catch {
+          throw importErr;
+        }
+      }
     }
+  } catch (err) {
+    throw new Error(
+      `Failed to parse configuration file at ${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (userConfig && typeof userConfig === "object" && "$schema" in userConfig) {
+    delete userConfig.$schema;
   }
+  const parsedConfig = userConfig;
   const mergedConfig = {
     ...DEFAULT_CONFIG,
-    ...userConfig,
+    ...parsedConfig,
     margins: {
       ...DEFAULT_CONFIG.margins,
-      ...userConfig.margins
+      ...parsedConfig.margins || {}
     },
-    header: userConfig.header || DEFAULT_CONFIG.header,
-    footer: userConfig.footer || DEFAULT_CONFIG.footer,
-    metadata: userConfig.metadata
+    header: parsedConfig.header !== void 0 ? parsedConfig.header : DEFAULT_CONFIG.header,
+    footer: parsedConfig.footer !== void 0 ? parsedConfig.footer : DEFAULT_CONFIG.footer,
+    metadata: {
+      ...DEFAULT_CONFIG.metadata || {},
+      ...parsedConfig.metadata || {}
+    }
   };
   return {
     config: mergedConfig,

package/dist/index.mjs

@@ -2267,21 +2267,43 @@ var DEFAULT_CONFIG = {
   bundleHtml: true,
   syntaxTheme: "github-dark"
 };
-async function loadConfig(customPath, cwd = process.cwd()) {
+function discoverConfigFile(startDir) {
+  const dirsToCheck = [];
+  let curr = path5.resolve(startDir);
+  while (curr) {
+    dirsToCheck.push(curr);
+    const parent = path5.dirname(curr);
+    if (parent === curr) break;
+    curr = parent;
+  }
+  const cwd = path5.resolve(process.cwd());
+  if (!dirsToCheck.includes(cwd)) {
+    dirsToCheck.push(cwd);
+  }
+  for (const dir of dirsToCheck) {
+    for (const filename of DEFAULT_CONFIG_FILENAMES) {
+      const candidate = path5.join(dir, filename);
+      if (fs5.existsSync(candidate) && fs5.statSync(candidate).isFile()) {
+        return candidate;
+      }
+    }
+  }
+  return null;
+}
+async function loadConfig(customPath, startDir = process.cwd()) {
   let resolvedPath = null;
   if (customPath) {
-    resolvedPath = path5.isAbsolute(customPath) ? customPath : path5.resolve(cwd, customPath);
+    resolvedPath = path5.isAbsolute(customPath) ? customPath : path5.resolve(process.cwd(), customPath);
     if (!fs5.existsSync(resolvedPath)) {
-      throw new Error(`Configuration file not found: ${resolvedPath}`);
-    }
-  } else {
-    for (const filename of DEFAULT_CONFIG_FILENAMES) {
-      const candidate = path5.resolve(cwd, filename);
-      if (fs5.existsSync(candidate)) {
-        resolvedPath = candidate;
-        break;
+      const altPath = path5.resolve(startDir, customPath);
+      if (fs5.existsSync(altPath)) {
+        resolvedPath = altPath;
+      } else {
+        throw new Error(`Configuration file not found: ${resolvedPath}`);
       }
     }
+  } else {
+    resolvedPath = discoverConfigFile(startDir);
   }
   if (!resolvedPath) {
     return {
@@ -2291,32 +2313,55 @@ async function loadConfig(customPath, cwd = process.cwd()) {
   }
   const ext = path5.extname(resolvedPath).toLowerCase();
   let userConfig = {};
-  if (ext === ".json" || resolvedPath.endsWith(".markforgerc")) {
-    const raw = fs5.readFileSync(resolvedPath, "utf-8");
-    userConfig = JSON.parse(raw);
-  } else if (ext === ".yaml" || ext === ".yml") {
-    const raw = fs5.readFileSync(resolvedPath, "utf-8");
-    userConfig = YAML.parse(raw);
-  } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
-    try {
-      const fileUrl = pathToFileURL3(resolvedPath).href;
-      const mod = await import(fileUrl);
-      userConfig = mod.default || mod;
-    } catch {
-      const required = __require(resolvedPath);
-      userConfig = required.default || required;
+  try {
+    if (ext === ".json" || ext === "" || resolvedPath.endsWith(".markforgerc")) {
+      const raw = fs5.readFileSync(resolvedPath, "utf-8").trim();
+      try {
+        userConfig = JSON.parse(raw);
+      } catch {
+        userConfig = YAML.parse(raw) || {};
+      }
+    } else if (ext === ".yaml" || ext === ".yml") {
+      const raw = fs5.readFileSync(resolvedPath, "utf-8");
+      userConfig = YAML.parse(raw) || {};
+    } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
+      try {
+        const fileUrl = `${pathToFileURL3(resolvedPath).href}?t=${Date.now()}`;
+        const mod = await import(fileUrl);
+        const rawExport = mod.default ?? mod.config ?? mod;
+        userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+      } catch (importErr) {
+        try {
+          const mod = __require(resolvedPath);
+          const rawExport = mod.default ?? mod.config ?? mod;
+          userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+        } catch {
+          throw importErr;
+        }
+      }
     }
+  } catch (err) {
+    throw new Error(
+      `Failed to parse configuration file at ${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (userConfig && typeof userConfig === "object" && "$schema" in userConfig) {
+    delete userConfig.$schema;
   }
+  const parsedConfig = userConfig;
   const mergedConfig = {
     ...DEFAULT_CONFIG,
-    ...userConfig,
+    ...parsedConfig,
     margins: {
       ...DEFAULT_CONFIG.margins,
-      ...userConfig.margins
+      ...parsedConfig.margins || {}
     },
-    header: userConfig.header || DEFAULT_CONFIG.header,
-    footer: userConfig.footer || DEFAULT_CONFIG.footer,
-    metadata: userConfig.metadata
+    header: parsedConfig.header !== void 0 ? parsedConfig.header : DEFAULT_CONFIG.header,
+    footer: parsedConfig.footer !== void 0 ? parsedConfig.footer : DEFAULT_CONFIG.footer,
+    metadata: {
+      ...DEFAULT_CONFIG.metadata || {},
+      ...parsedConfig.metadata || {}
+    }
   };
   return {
     config: mergedConfig,

package/dist/{loadConfig-T4ZV6YY2.mjs → loadConfig-PD6ENMAM.mjs}

@@ -10,7 +10,7 @@ try {
 import {
   DEFAULT_CONFIG,
   loadConfig
-} from "./chunk-ASXSHC6H.mjs";
+} from "./chunk-IYGPJIK5.mjs";
 import "./chunk-YZHGBG4N.mjs";
 export {
   DEFAULT_CONFIG,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masumdev/markforge",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Modern, high-performance Markdown & MDX multi-format document publishing engine and CLI (DOCX, PDF, HTML, and Images) with embedded HTML/CSS, image inliner, and Ink terminal UI.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/schema.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "MarkforgeConfig",
-  "description": "Configuration schema for @masumdev/markforge Markdown & MDX document publishing engine",
+  "description": "Type-safe configuration schema for @masumdev/markforge Markdown & MDX document publishing engine",
   "type": "object",
   "properties": {
     "$schema": {
       "type": "string",
-      "description": "JSON schema reference URI"
+      "description": "JSON Schema reference URI for IDE autocompletion and validation"
     },
     "to": {
-      "description": "Target formats to compile markdown to",
+      "description": "Target formats to compile markdown to (docx, pdf, html, png)",
       "oneOf": [
         {
           "type": "string",
@@ -31,12 +31,12 @@
     },
     "theme": {
       "type": "string",
-      "description": "Visual document theme",
+      "description": "Visual document theme name",
       "enum": ["default", "academic", "github", "corporate", "minimal", "dracula"],
       "default": "default"
     },
     "css": {
-      "description": "Custom CSS stylesheet(s) to inject",
+      "description": "Custom CSS stylesheet path(s) to inject",
       "oneOf": [
         { "type": "string" },
         { "type": "array", "items": { "type": "string" } }
@@ -44,56 +44,87 @@
     },
     "orientation": {
       "type": "string",
+      "description": "Page orientation for PDF and DOCX",
       "enum": ["portrait", "landscape"],
       "default": "portrait"
     },
     "paperSize": {
       "type": "string",
+      "description": "Physical page size",
       "enum": ["A4", "Letter", "Legal", "A3", "A5"],
       "default": "A4"
     },
     "margins": {
       "type": "object",
+      "description": "Document margins (supports units like '2.5cm', '1in', '20mm', or pt numbers)",
       "properties": {
         "top": { "type": ["string", "number"] },
         "bottom": { "type": ["string", "number"] },
         "left": { "type": ["string", "number"] },
         "right": { "type": ["string", "number"] }
-      }
+      },
+      "additionalProperties": false
     },
     "header": {
       "type": "object",
+      "description": "Header text across pages",
       "properties": {
         "left": { "type": "string" },
         "center": { "type": "string" },
         "right": { "type": "string" }
-      }
+      },
+      "additionalProperties": false
     },
     "footer": {
       "type": "object",
+      "description": "Footer text across pages (supports {page} and {pages} variables)",
       "properties": {
         "left": { "type": "string" },
         "center": { "type": "string" },
         "right": { "type": "string" }
-      }
+      },
+      "additionalProperties": false
     },
     "toc": {
       "type": "boolean",
-      "description": "Auto-generate Table of Contents",
+      "description": "Auto-generate Table of Contents with page references",
       "default": false
     },
     "watermark": {
       "type": "string",
-      "description": "Watermark text across pages"
+      "description": "Diagonal watermark text across document pages"
     },
     "embedImages": {
       "type": "boolean",
-      "description": "Whether to inline/embed all images",
+      "description": "Whether to inline/embed all images as Base64 in outputs",
       "default": true
     },
+    "bundleHtml": {
+      "type": "boolean",
+      "description": "Produce self-contained HTML with embedded styles and scripts",
+      "default": true
+    },
+    "syntaxTheme": {
+      "type": "string",
+      "description": "Code block syntax highlighting color scheme",
+      "enum": ["github-dark", "github-light", "dracula", "monokai", "nord"],
+      "default": "github-dark"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Document frontmatter metadata defaults",
+      "properties": {
+        "title": { "type": "string" },
+        "author": { "type": "string" },
+        "date": { "type": "string" },
+        "version": { "type": "string" },
+        "company": { "type": "string" }
+      },
+      "additionalProperties": true
+    },
     "watch": {
       "type": "boolean",
-      "description": "Watch mode for hot compilation",
+      "description": "Watch mode for re-compilation on source file changes",
       "default": false
     },
     "serve": {
@@ -108,7 +139,7 @@
     },
     "open": {
       "type": "boolean",
-      "description": "Open document in browser on compile",
+      "description": "Automatically open document in browser on compile",
       "default": false
     }
   },

package/dist/chunk-ASXSHC6H.mjs

@@ -1,120 +0,0 @@
-#!/usr/bin/env node
-try {
-  if (typeof globalThis !== "undefined" && (!globalThis.localStorage || typeof globalThis.localStorage.getItem !== "function")) {
-    Object.defineProperty(globalThis, "localStorage", {
-      value: { getItem: () => null, setItem: () => {}, removeItem: () => {}, clear: () => {}, key: () => null, length: 0 },
-      configurable: true, writable: true,
-    });
-  }
-} catch {}
-import {
-  __require
-} from "./chunk-YZHGBG4N.mjs";
-
-// src/config/loadConfig.ts
-import * as fs from "fs";
-import * as path from "path";
-import { pathToFileURL } from "url";
-import * as YAML from "yaml";
-var DEFAULT_CONFIG_FILENAMES = [
-  "markforge.config.json",
-  ".markforgerc.json",
-  "markforge.config.yaml",
-  "markforge.config.yml",
-  ".markforgerc.yaml",
-  ".markforgerc.yml",
-  ".markforgerc",
-  "markforge.config.ts",
-  "markforge.config.js",
-  "markforge.config.mjs",
-  "markforge.config.cjs"
-];
-var DEFAULT_CONFIG = {
-  to: ["docx", "pdf"],
-  outputDir: void 0,
-  theme: "default",
-  css: void 0,
-  orientation: "portrait",
-  paperSize: "A4",
-  margins: {
-    top: "2.5cm",
-    bottom: "2.5cm",
-    left: "2.5cm",
-    right: "2.5cm"
-  },
-  header: void 0,
-  footer: {
-    right: "Page {page} of {pages}"
-  },
-  toc: false,
-  watermark: void 0,
-  embedImages: true,
-  metadata: void 0,
-  watch: false,
-  serve: false,
-  port: 4e3,
-  open: false,
-  bundleHtml: true,
-  syntaxTheme: "github-dark"
-};
-async function loadConfig(customPath, cwd = process.cwd()) {
-  let resolvedPath = null;
-  if (customPath) {
-    resolvedPath = path.isAbsolute(customPath) ? customPath : path.resolve(cwd, customPath);
-    if (!fs.existsSync(resolvedPath)) {
-      throw new Error(`Configuration file not found: ${resolvedPath}`);
-    }
-  } else {
-    for (const filename of DEFAULT_CONFIG_FILENAMES) {
-      const candidate = path.resolve(cwd, filename);
-      if (fs.existsSync(candidate)) {
-        resolvedPath = candidate;
-        break;
-      }
-    }
-  }
-  if (!resolvedPath) {
-    return {
-      config: { ...DEFAULT_CONFIG },
-      configPath: null
-    };
-  }
-  const ext = path.extname(resolvedPath).toLowerCase();
-  let userConfig = {};
-  if (ext === ".json" || resolvedPath.endsWith(".markforgerc")) {
-    const raw = fs.readFileSync(resolvedPath, "utf-8");
-    userConfig = JSON.parse(raw);
-  } else if (ext === ".yaml" || ext === ".yml") {
-    const raw = fs.readFileSync(resolvedPath, "utf-8");
-    userConfig = YAML.parse(raw);
-  } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
-    try {
-      const fileUrl = pathToFileURL(resolvedPath).href;
-      const mod = await import(fileUrl);
-      userConfig = mod.default || mod;
-    } catch {
-      const required = __require(resolvedPath);
-      userConfig = required.default || required;
-    }
-  }
-  const mergedConfig = {
-    ...DEFAULT_CONFIG,
-    ...userConfig,
-    margins: {
-      ...DEFAULT_CONFIG.margins,
-      ...userConfig.margins
-    },
-    header: userConfig.header || DEFAULT_CONFIG.header,
-    footer: userConfig.footer || DEFAULT_CONFIG.footer,
-    metadata: userConfig.metadata
-  };
-  return {
-    config: mergedConfig,
-    configPath: resolvedPath
-  };
-}
-
-export {
-  DEFAULT_CONFIG,
-  loadConfig
-};