@masumdev/markforge 0.2.3 → 0.2.5

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.5",
   "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",
@@ -27,73 +27,266 @@
     },
     "outputDir": {
       "type": "string",
-      "description": "Output directory for compiled documents"
+      "description": "Output directory where compiled documents will be saved"
     },
     "theme": {
-      "type": "string",
-      "description": "Visual document theme",
-      "enum": ["default", "academic", "github", "corporate", "minimal", "dracula"],
-      "default": "default"
-    },
-    "css": {
-      "description": "Custom CSS stylesheet(s) to inject",
+      "description": "Visual document theme (preset 'corporate' or custom ThemeProps object)",
       "oneOf": [
-        { "type": "string" },
-        { "type": "array", "items": { "type": "string" } }
-      ]
+        {
+          "type": "string",
+          "enum": ["corporate", "default"]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "primaryColor": { "type": "string" },
+            "primaryDark": { "type": "string" },
+            "primaryLight": { "type": "string" },
+            "backgroundColor": { "type": "string" },
+            "textColor": { "type": "string" },
+            "textMuted": { "type": "string" },
+            "borderColor": { "type": "string" },
+            "cardBackground": { "type": "string" },
+            "codeBackground": { "type": "string" },
+            "codeText": { "type": "string" },
+            "fontFamily": { "type": "string" },
+            "fontMono": { "type": "string" },
+            "customCss": { "type": "string" }
+          },
+          "additionalProperties": false
+        }
+      ],
+      "default": "corporate"
     },
     "orientation": {
       "type": "string",
+      "description": "Page orientation for PDF and DOCX",
       "enum": ["portrait", "landscape"],
       "default": "portrait"
     },
     "paperSize": {
       "type": "string",
+      "description": "Standard physical paper size",
       "enum": ["A4", "Letter", "Legal", "A3", "A5"],
       "default": "A4"
     },
     "margins": {
       "type": "object",
+      "description": "Document page 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": "Running header template across document pages (supports {title}, {subtitle}, {author}, {version}, {date}, {company})",
       "properties": {
-        "left": { "type": "string" },
-        "center": { "type": "string" },
-        "right": { "type": "string" }
-      }
+        "left": {
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "object",
+              "properties": {
+                "text": { "type": "string" },
+                "color": { "type": "string" },
+                "fontSize": { "type": "number" },
+                "fontFamily": { "type": "string" },
+                "bold": { "type": "boolean" },
+                "italic": { "type": "boolean" }
+              },
+              "required": ["text"],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "center": {
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "object",
+              "properties": {
+                "text": { "type": "string" },
+                "color": { "type": "string" },
+                "fontSize": { "type": "number" },
+                "fontFamily": { "type": "string" },
+                "bold": { "type": "boolean" },
+                "italic": { "type": "boolean" }
+              },
+              "required": ["text"],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "right": {
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "object",
+              "properties": {
+                "text": { "type": "string" },
+                "color": { "type": "string" },
+                "fontSize": { "type": "number" },
+                "fontFamily": { "type": "string" },
+                "bold": { "type": "boolean" },
+                "italic": { "type": "boolean" }
+              },
+              "required": ["text"],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "divider": { "type": "boolean" },
+        "dividerColor": { "type": "string" },
+        "font": { "type": "string" },
+        "size": { "type": "number" },
+        "color": { "type": "string" }
+      },
+      "additionalProperties": false
     },
     "footer": {
       "type": "object",
+      "description": "Running footer template across document pages (supports {page}, {pages}, {title}, {author}, {date})",
       "properties": {
-        "left": { "type": "string" },
-        "center": { "type": "string" },
-        "right": { "type": "string" }
-      }
+        "left": {
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "object",
+              "properties": {
+                "text": { "type": "string" },
+                "color": { "type": "string" },
+                "fontSize": { "type": "number" },
+                "fontFamily": { "type": "string" },
+                "bold": { "type": "boolean" },
+                "italic": { "type": "boolean" }
+              },
+              "required": ["text"],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "center": {
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "object",
+              "properties": {
+                "text": { "type": "string" },
+                "color": { "type": "string" },
+                "fontSize": { "type": "number" },
+                "fontFamily": { "type": "string" },
+                "bold": { "type": "boolean" },
+                "italic": { "type": "boolean" }
+              },
+              "required": ["text"],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "right": {
+          "oneOf": [
+            { "type": "string" },
+            {
+              "type": "object",
+              "properties": {
+                "text": { "type": "string" },
+                "color": { "type": "string" },
+                "fontSize": { "type": "number" },
+                "fontFamily": { "type": "string" },
+                "bold": { "type": "boolean" },
+                "italic": { "type": "boolean" }
+              },
+              "required": ["text"],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "divider": { "type": "boolean" },
+        "dividerColor": { "type": "string" },
+        "font": { "type": "string" },
+        "size": { "type": "number" },
+        "color": { "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": {
+      "description": "Watermark configuration across document pages (string or WatermarkOptions object)",
+      "oneOf": [
+        { "type": "string" },
+        { "type": "boolean" },
+        {
+          "type": "object",
+          "properties": {
+            "text": { "type": "string" },
+            "color": { "type": "string" },
+            "opacity": { "type": "number" },
+            "fontSize": { "type": "number" },
+            "rotate": { "type": "number" },
+            "position": {
+              "type": "string",
+              "enum": ["diagonal", "center", "top-right", "bottom-right"]
+            }
+          },
+          "required": ["text"],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "css": {
+      "description": "Custom CSS stylesheet path(s) to inject into the document",
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ]
+    },
+    "syntaxTheme": {
       "type": "string",
-      "description": "Watermark text across pages"
+      "description": "Code block syntax highlighting color theme",
+      "enum": ["github-dark", "github-light", "dracula", "monokai", "nord"],
+      "default": "github-dark"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Default document metadata dictionary (used as fallback if not in markdown frontmatter)",
+      "properties": {
+        "title": { "type": "string" },
+        "subtitle": { "type": "string" },
+        "author": {
+          "oneOf": [
+            { "type": "string" },
+            { "type": "array", "items": { "type": "string" } }
+          ]
+        },
+        "date": { "type": "string" },
+        "version": { "type": "string" },
+        "company": { "type": "string" },
+        "lang": { "type": "string" },
+        "coverPage": { "type": "boolean" }
+      },
+      "additionalProperties": true
     },
     "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
     },
     "watch": {
       "type": "boolean",
-      "description": "Watch mode for hot compilation",
+      "description": "Watch mode for re-compilation on source file changes",
       "default": false
     },
     "serve": {
@@ -108,7 +301,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
-};