@masumdev/markforge 0.2.5 → 0.3.0

package/dist/{chunk-NGC2ZAWZ.mjs → chunk-HKB4CSPZ.mjs}

@@ -32,7 +32,7 @@ try {
   }
 } catch {
 }
-var FALLBACK_VERSION = "0.2.2";
+var FALLBACK_VERSION = "0.3.0";
 function readVersionFromPackageJson(fromDir) {
   let currentDir = fromDir;
   for (let i = 0; i < 6; i++) {

package/dist/cli.mjs

@@ -9,7 +9,7 @@ try {
 } catch {}
 import {
   MARKFORGE_VERSION
-} from "./chunk-NGC2ZAWZ.mjs";
+} from "./chunk-HKB4CSPZ.mjs";
 import "./chunk-YZHGBG4N.mjs";
 
 // src/cli.tsx
@@ -57,7 +57,7 @@ async function main() {
   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-GNRUPFM7.mjs"),
+    import("./App-AM2CWXHJ.mjs"),
     import("./loadConfig-PD6ENMAM.mjs")
   ]);
   const { config: fileConfig } = await loadConfig(

package/dist/index.d.mts

@@ -165,6 +165,79 @@ interface DocumentMetadata {
     coverPage?: boolean;
     [key: string]: unknown;
 }
+type SignatureAlign = "left" | "center" | "right" | "space-between";
+type SignatureStyle = "line" | "box" | "clean";
+interface SignatureItem {
+    /**
+     * Title or sign-off label above signature (e.g. "Prepared by", "Approved by", "Acknowledged by").
+     */
+    title?: string;
+    /**
+     * Signatory person name (supports metadata tokens like {author}, {company}).
+     */
+    name: string;
+    /**
+     * Signatory job title, role, or department (e.g. "Lead System Architect", "Chief Technology Officer").
+     */
+    role?: string;
+    /**
+     * Signature date string or template (e.g. "2026-08-29", "{date}", or true for auto-formatted current date).
+     */
+    date?: string | boolean;
+    /**
+     * Optional signature image path, URL, or Base64 data URI (stamp, digital seal, or handwritten signature).
+     */
+    image?: string;
+    /**
+     * Height reserved for physical handwriting signature (e.g. 60, "60px", "1.5cm").
+     * @default 60
+     */
+    signatureHeight?: number | string;
+}
+interface SignatureBlockConfig {
+    /**
+     * List of 1 to 4 signature slots.
+     */
+    items: SignatureItem[];
+    /**
+     * Horizontal alignment of the signature block.
+     * @default "right" for 1 item, "space-between" for >= 2 items
+     */
+    align?: SignatureAlign;
+    /**
+     * Visual layout style of the signature block:
+     * - "line": Traditional signature with a horizontal separator line above name.
+     * - "box": Formal bordered rectangular approval card.
+     * - "clean": Minimalist blank vertical space without borders.
+     * @default "line"
+     */
+    style?: SignatureStyle;
+    /**
+     * Border or divider line color.
+     * @default "#CBD5E1"
+     */
+    borderColor?: string;
+    /**
+     * Color of the signature title / label.
+     * @default "#64748B"
+     */
+    titleColor?: string;
+    /**
+     * Color of the signatory name.
+     * @default "#0F172A"
+     */
+    nameColor?: string;
+    /**
+     * Color of the role and date text.
+     * @default "#64748B"
+     */
+    roleColor?: string;
+    /**
+     * Vertical spacing before the signature block (e.g. "2.5rem", 480).
+     * @default "2.5rem"
+     */
+    spacingBefore?: number | string;
+}
 /**
  * Document visual & layout options (theme, orientation, margins, headers, footers, etc.).
  */
@@ -201,6 +274,11 @@ interface DocumentLayoutConfig {
      * @default false
      */
     toc?: boolean;
+    /**
+     * Document signature and approval block at the bottom of the document.
+     * Supports 1-4 signature items, flexible alignment, and multiple styles ("line", "box", "clean").
+     */
+    signatures?: SignatureBlockConfig | SignatureItem[];
     /**
      * Optional watermark configuration to display across pages.
      * @default false
@@ -454,12 +532,13 @@ declare function generateThemeCss(theme?: MarkforgeTheme): string;
  */
 declare function defineConfig(config: MarkforgeConfig): MarkforgeConfig;
 
-declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css" | "margins" | "header" | "footer" | "watermark" | "metadata" | "syntaxTheme">> & {
+declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css" | "margins" | "header" | "footer" | "watermark" | "metadata" | "syntaxTheme" | "signatures">> & {
     outputDir?: string;
     css?: string | string[];
     margins?: MarkforgeConfig["margins"];
     header?: MarkforgeConfig["header"];
     footer?: MarkforgeConfig["footer"];
+    signatures?: MarkforgeConfig["signatures"];
     watermark?: string;
     metadata?: MarkforgeConfig["metadata"];
     syntaxTheme?: string;
@@ -515,6 +594,25 @@ interface NormalizedHeaderFooter {
     divider: boolean;
     dividerColor: string;
 }
+interface NormalizedSignatureItem {
+    title?: string;
+    name: string;
+    role?: string;
+    date?: string;
+    image?: string;
+    signatureHeight: number;
+}
+interface NormalizedSignatureBlock {
+    items: NormalizedSignatureItem[];
+    align: SignatureAlign;
+    style: SignatureStyle;
+    borderColor: string;
+    titleColor: string;
+    nameColor: string;
+    roleColor: string;
+    spacingBefore: string;
+    spacingBeforeTwip: number;
+}
 interface ResolvedDocumentConfig {
     title: string;
     subtitle?: string;
@@ -534,6 +632,7 @@ interface ResolvedDocumentConfig {
     header?: NormalizedHeaderFooter;
     footer?: NormalizedHeaderFooter;
     toc: boolean;
+    signatures?: NormalizedSignatureBlock;
     watermark?: NormalizedWatermark;
     css: string[];
     embedImages: boolean;
@@ -577,6 +676,10 @@ declare function normalizeHeaderFooter(raw: HeaderFooterItem | undefined, meta:
     date?: string;
     company?: string;
 }): NormalizedHeaderFooter | undefined;
+/**
+ * Normalizes signature and approval block configuration.
+ */
+declare function normalizeSignatures(raw?: SignatureBlockConfig | SignatureItem[], meta?: Record<string, unknown>): NormalizedSignatureBlock | undefined;
 /**
  * Centralized Single Source of Truth for resolving document configuration.
  * Priority hierarchy: Frontmatter metadata > Project Config File / User Config > DEFAULT_CONFIG
@@ -593,4 +696,4 @@ declare const MARKFORGE_VERSION: string;
  */
 declare function getMarkforgeVersion(fromDir?: string): string;
 
-export { type CompilationResult, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedWatermark, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument, renderInlinesToHtml, renderMermaidToPng, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, tokenizeCodeLine };
+export { type CompilationResult, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedSignatureBlock, type NormalizedSignatureItem, type NormalizedWatermark, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, type SignatureAlign, type SignatureBlockConfig, type SignatureItem, type SignatureStyle, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeSignatures, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument, renderInlinesToHtml, renderMermaidToPng, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, tokenizeCodeLine };

package/dist/index.d.ts

@@ -165,6 +165,79 @@ interface DocumentMetadata {
     coverPage?: boolean;
     [key: string]: unknown;
 }
+type SignatureAlign = "left" | "center" | "right" | "space-between";
+type SignatureStyle = "line" | "box" | "clean";
+interface SignatureItem {
+    /**
+     * Title or sign-off label above signature (e.g. "Prepared by", "Approved by", "Acknowledged by").
+     */
+    title?: string;
+    /**
+     * Signatory person name (supports metadata tokens like {author}, {company}).
+     */
+    name: string;
+    /**
+     * Signatory job title, role, or department (e.g. "Lead System Architect", "Chief Technology Officer").
+     */
+    role?: string;
+    /**
+     * Signature date string or template (e.g. "2026-08-29", "{date}", or true for auto-formatted current date).
+     */
+    date?: string | boolean;
+    /**
+     * Optional signature image path, URL, or Base64 data URI (stamp, digital seal, or handwritten signature).
+     */
+    image?: string;
+    /**
+     * Height reserved for physical handwriting signature (e.g. 60, "60px", "1.5cm").
+     * @default 60
+     */
+    signatureHeight?: number | string;
+}
+interface SignatureBlockConfig {
+    /**
+     * List of 1 to 4 signature slots.
+     */
+    items: SignatureItem[];
+    /**
+     * Horizontal alignment of the signature block.
+     * @default "right" for 1 item, "space-between" for >= 2 items
+     */
+    align?: SignatureAlign;
+    /**
+     * Visual layout style of the signature block:
+     * - "line": Traditional signature with a horizontal separator line above name.
+     * - "box": Formal bordered rectangular approval card.
+     * - "clean": Minimalist blank vertical space without borders.
+     * @default "line"
+     */
+    style?: SignatureStyle;
+    /**
+     * Border or divider line color.
+     * @default "#CBD5E1"
+     */
+    borderColor?: string;
+    /**
+     * Color of the signature title / label.
+     * @default "#64748B"
+     */
+    titleColor?: string;
+    /**
+     * Color of the signatory name.
+     * @default "#0F172A"
+     */
+    nameColor?: string;
+    /**
+     * Color of the role and date text.
+     * @default "#64748B"
+     */
+    roleColor?: string;
+    /**
+     * Vertical spacing before the signature block (e.g. "2.5rem", 480).
+     * @default "2.5rem"
+     */
+    spacingBefore?: number | string;
+}
 /**
  * Document visual & layout options (theme, orientation, margins, headers, footers, etc.).
  */
@@ -201,6 +274,11 @@ interface DocumentLayoutConfig {
      * @default false
      */
     toc?: boolean;
+    /**
+     * Document signature and approval block at the bottom of the document.
+     * Supports 1-4 signature items, flexible alignment, and multiple styles ("line", "box", "clean").
+     */
+    signatures?: SignatureBlockConfig | SignatureItem[];
     /**
      * Optional watermark configuration to display across pages.
      * @default false
@@ -454,12 +532,13 @@ declare function generateThemeCss(theme?: MarkforgeTheme): string;
  */
 declare function defineConfig(config: MarkforgeConfig): MarkforgeConfig;
 
-declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css" | "margins" | "header" | "footer" | "watermark" | "metadata" | "syntaxTheme">> & {
+declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css" | "margins" | "header" | "footer" | "watermark" | "metadata" | "syntaxTheme" | "signatures">> & {
     outputDir?: string;
     css?: string | string[];
     margins?: MarkforgeConfig["margins"];
     header?: MarkforgeConfig["header"];
     footer?: MarkforgeConfig["footer"];
+    signatures?: MarkforgeConfig["signatures"];
     watermark?: string;
     metadata?: MarkforgeConfig["metadata"];
     syntaxTheme?: string;
@@ -515,6 +594,25 @@ interface NormalizedHeaderFooter {
     divider: boolean;
     dividerColor: string;
 }
+interface NormalizedSignatureItem {
+    title?: string;
+    name: string;
+    role?: string;
+    date?: string;
+    image?: string;
+    signatureHeight: number;
+}
+interface NormalizedSignatureBlock {
+    items: NormalizedSignatureItem[];
+    align: SignatureAlign;
+    style: SignatureStyle;
+    borderColor: string;
+    titleColor: string;
+    nameColor: string;
+    roleColor: string;
+    spacingBefore: string;
+    spacingBeforeTwip: number;
+}
 interface ResolvedDocumentConfig {
     title: string;
     subtitle?: string;
@@ -534,6 +632,7 @@ interface ResolvedDocumentConfig {
     header?: NormalizedHeaderFooter;
     footer?: NormalizedHeaderFooter;
     toc: boolean;
+    signatures?: NormalizedSignatureBlock;
     watermark?: NormalizedWatermark;
     css: string[];
     embedImages: boolean;
@@ -577,6 +676,10 @@ declare function normalizeHeaderFooter(raw: HeaderFooterItem | undefined, meta:
     date?: string;
     company?: string;
 }): NormalizedHeaderFooter | undefined;
+/**
+ * Normalizes signature and approval block configuration.
+ */
+declare function normalizeSignatures(raw?: SignatureBlockConfig | SignatureItem[], meta?: Record<string, unknown>): NormalizedSignatureBlock | undefined;
 /**
  * Centralized Single Source of Truth for resolving document configuration.
  * Priority hierarchy: Frontmatter metadata > Project Config File / User Config > DEFAULT_CONFIG
@@ -593,4 +696,4 @@ declare const MARKFORGE_VERSION: string;
  */
 declare function getMarkforgeVersion(fromDir?: string): string;
 
-export { type CompilationResult, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedWatermark, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument, renderInlinesToHtml, renderMermaidToPng, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, tokenizeCodeLine };
+export { type CompilationResult, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedSignatureBlock, type NormalizedSignatureItem, type NormalizedWatermark, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, type SignatureAlign, type SignatureBlockConfig, type SignatureItem, type SignatureStyle, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeSignatures, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument, renderInlinesToHtml, renderMermaidToPng, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, tokenizeCodeLine };