convpdf 0.2.0

package/dist/src/styles/github.css

@@ -0,0 +1,118 @@
+pre code.hljs {
+  display: block;
+  overflow-x: auto;
+  padding: 1em
+}
+code.hljs {
+  padding: 3px 5px
+}
+/*!
+  Theme: GitHub
+  Description: Light theme as seen on github.com
+  Author: github.com
+  Maintainer: @Hirse
+  Updated: 2021-05-15
+
+  Outdated base version: https://github.com/primer/github-syntax-light
+  Current colors taken from GitHub's CSS
+*/
+.hljs {
+  color: #24292e;
+  background: #ffffff
+}
+.hljs-doctag,
+.hljs-keyword,
+.hljs-meta .hljs-keyword,
+.hljs-template-tag,
+.hljs-template-variable,
+.hljs-type,
+.hljs-variable.language_ {
+  /* prettylights-syntax-keyword */
+  color: #d73a49
+}
+.hljs-title,
+.hljs-title.class_,
+.hljs-title.class_.inherited__,
+.hljs-title.function_ {
+  /* prettylights-syntax-entity */
+  color: #6f42c1
+}
+.hljs-attr,
+.hljs-attribute,
+.hljs-literal,
+.hljs-meta,
+.hljs-number,
+.hljs-operator,
+.hljs-variable,
+.hljs-selector-attr,
+.hljs-selector-class,
+.hljs-selector-id {
+  /* prettylights-syntax-constant */
+  color: #005cc5
+}
+.hljs-regexp,
+.hljs-string,
+.hljs-meta .hljs-string {
+  /* prettylights-syntax-string */
+  color: #032f62
+}
+.hljs-built_in,
+.hljs-symbol {
+  /* prettylights-syntax-variable */
+  color: #e36209
+}
+.hljs-comment,
+.hljs-code,
+.hljs-formula {
+  /* prettylights-syntax-comment */
+  color: #6a737d
+}
+.hljs-name,
+.hljs-quote,
+.hljs-selector-tag,
+.hljs-selector-pseudo {
+  /* prettylights-syntax-entity-tag */
+  color: #22863a
+}
+.hljs-subst {
+  /* prettylights-syntax-storage-modifier-import */
+  color: #24292e
+}
+.hljs-section {
+  /* prettylights-syntax-markup-heading */
+  color: #005cc5;
+  font-weight: bold
+}
+.hljs-bullet {
+  /* prettylights-syntax-markup-list */
+  color: #735c0f
+}
+.hljs-emphasis {
+  /* prettylights-syntax-markup-italic */
+  color: #24292e;
+  font-style: italic
+}
+.hljs-strong {
+  /* prettylights-syntax-markup-bold */
+  color: #24292e;
+  font-weight: bold
+}
+.hljs-addition {
+  /* prettylights-syntax-markup-inserted */
+  color: #22863a;
+  background-color: #f0fff4
+}
+.hljs-deletion {
+  /* prettylights-syntax-markup-deleted */
+  color: #b31d28;
+  background-color: #ffeef0
+}
+.hljs-char.escape_,
+.hljs-link,
+.hljs-params,
+.hljs-property,
+.hljs-punctuation,
+.hljs-tag {
+  /* purposely ignored */
+  
+}

package/dist/src/types.d.ts

@@ -0,0 +1,40 @@
+import type { Tokens } from 'marked';
+export declare const PAPER_FORMATS: readonly ["Letter", "Legal", "Tabloid", "Ledger", "A0", "A1", "A2", "A3", "A4", "A5", "A6"];
+export type PaperFormat = (typeof PAPER_FORMATS)[number];
+export type PaperFormatInput = PaperFormat | Lowercase<PaperFormat>;
+export interface RendererOptions {
+    margin?: string;
+    format?: PaperFormatInput;
+    toc?: boolean;
+    tocDepth?: number;
+    math?: boolean;
+    customCss?: string | null;
+    template?: string | null;
+    headerTemplate?: string | null;
+    footerTemplate?: string | null;
+    basePath?: string;
+    title?: string;
+}
+export interface Frontmatter {
+    title?: string;
+    toc?: boolean;
+    tocDepth?: number;
+    [key: string]: unknown;
+}
+export interface FrontmatterParseResult {
+    data: Frontmatter;
+    content: string;
+    warnings: string[];
+}
+export interface TocHeading {
+    level: number;
+    text: string;
+    id: string;
+}
+export type CustomToken = Tokens.Generic & {
+    id?: string;
+    tokens?: CustomToken[];
+    depth?: number;
+    text?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,eAAO,MAAM,aAAa,6FAYhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,GAAG;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/src/types.js

@@ -0,0 +1,14 @@
+export const PAPER_FORMATS = [
+    'Letter',
+    'Legal',
+    'Tabloid',
+    'Ledger',
+    'A0',
+    'A1',
+    'A2',
+    'A3',
+    'A4',
+    'A5',
+    'A6'
+];
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACI,CAAC"}

package/dist/src/utils/html.d.ts

@@ -0,0 +1,3 @@
+export declare const escapeHtml: (value: string) => string;
+export declare const sanitizeHref: (href: string) => string;
+//# sourceMappingURL=html.d.ts.map

package/dist/src/utils/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../src/utils/html.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MACyB,CAAC;AAErE,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAW3C,CAAC"}

package/dist/src/utils/html.js

@@ -0,0 +1,24 @@
+const HTML_ESCAPE_MAP = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;'
+};
+export const escapeHtml = (value) => value.replace(/[&<>"']/g, (char) => HTML_ESCAPE_MAP[char] ?? char);
+export const sanitizeHref = (href) => {
+    const trimmed = href.trim();
+    if (!trimmed)
+        return '#';
+    if (trimmed.startsWith('#'))
+        return trimmed;
+    // Allow relative links and common safe protocols only.
+    if (/^(\/|\.\/|\.\.\/)/.test(trimmed))
+        return trimmed;
+    if (/^(https?:|mailto:|tel:|file:)/i.test(trimmed))
+        return trimmed;
+    if (!/^[a-z][a-z\d+\-.]*:/i.test(trimmed))
+        return trimmed;
+    return '#';
+};
+//# sourceMappingURL=html.js.map

package/dist/src/utils/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../src/utils/html.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAA2B;IAC9C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAClD,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,CAAC;IACzB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAE5C,uDAAuD;IACvD,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACtD,IAAI,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACnE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE1D,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/src/utils/validation.d.ts

@@ -0,0 +1,6 @@
+import type { PDFMargin } from 'puppeteer';
+import { type PaperFormat } from '../types.js';
+export declare const parseMargin: (rawMargin?: string) => PDFMargin;
+export declare const normalizePaperFormat: (input?: string) => PaperFormat;
+export declare const normalizeTocDepth: (input?: number) => number;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAO9D,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,KAAG,SAkChD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,WASrD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MASlD,CAAC"}

package/dist/src/utils/validation.js

@@ -0,0 +1,49 @@
+import { PAPER_FORMATS } from '../types.js';
+const VALID_MARGIN = /^\d*\.?\d+(px|in|cm|mm|pc|pt)?$/i;
+const FORMAT_LOOKUP = new Map(PAPER_FORMATS.map((value) => [value.toLowerCase(), value]));
+export const parseMargin = (rawMargin) => {
+    const margin = rawMargin?.trim() || '20mm';
+    const parts = margin.split(/\s+/).filter(Boolean);
+    if (parts.length < 1 || parts.length > 4) {
+        throw new Error(`Invalid margin value "${rawMargin}". Use 1 to 4 CSS length values, e.g. "20mm" or "10mm 12mm".`);
+    }
+    for (const part of parts) {
+        if (!VALID_MARGIN.test(part)) {
+            throw new Error(`Invalid margin token "${part}". Expected numeric value with optional unit (mm, cm, in, px, pt, pc).`);
+        }
+    }
+    if (parts.length === 1) {
+        const [all] = parts;
+        return { top: all, right: all, bottom: all, left: all };
+    }
+    if (parts.length === 2) {
+        const [vertical, horizontal] = parts;
+        return { top: vertical, right: horizontal, bottom: vertical, left: horizontal };
+    }
+    if (parts.length === 3) {
+        const [top, horizontal, bottom] = parts;
+        return { top, right: horizontal, bottom, left: horizontal };
+    }
+    const [top, right, bottom, left] = parts;
+    return { top, right, bottom, left };
+};
+export const normalizePaperFormat = (input) => {
+    const value = input?.trim() || 'A4';
+    const normalized = FORMAT_LOOKUP.get(value.toLowerCase());
+    if (!normalized) {
+        throw new Error(`Invalid paper format "${value}". Allowed formats: ${PAPER_FORMATS.join(', ')}.`);
+    }
+    return normalized;
+};
+export const normalizeTocDepth = (input) => {
+    if (input === undefined)
+        return 6;
+    if (!Number.isInteger(input)) {
+        throw new Error(`Invalid TOC depth "${String(input)}". Expected an integer from 1 to 6.`);
+    }
+    if (input < 1 || input > 6) {
+        throw new Error(`Invalid TOC depth "${input}". Expected a value between 1 and 6.`);
+    }
+    return input;
+};
+//# sourceMappingURL=validation.js.map

package/dist/src/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAE9D,MAAM,YAAY,GAAG,kCAAkC,CAAC;AACxD,MAAM,aAAa,GAAqC,IAAI,GAAG,CAC7D,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC,CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAkB,EAAa,EAAE;IAC3D,MAAM,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,8DAA8D,CACjG,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,wEAAwE,CACtG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;QACrC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAClF,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QACxC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IACzC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAe,EAAE;IAClE,MAAM,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;IACpC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,uBAAuB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAU,EAAE;IAC1D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,sCAAsC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "convpdf",
+  "version": "0.2.0",
+  "license": "MIT",
+  "description": "Convert Markdown to high-quality PDF",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "convpdf": "./dist/bin/convpdf.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/src/renderer.js",
+      "types": "./dist/src/renderer.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "markdown",
+    "pdf",
+    "converter",
+    "puppeteer",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mohamed-chs/convpdf.git"
+  },
+  "homepage": "https://github.com/mohamed-chs/convpdf#readme",
+  "scripts": {
+    "clean": "node scripts/clean.mjs",
+    "typecheck": "tsc -p tsconfig.json",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/copy-styles.mjs",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit.test.ts",
+    "test:cli": "vitest run tests/cli.test.ts",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "ci": "npm run typecheck && npm run lint && npm run format:check && npm run build && npm test",
+    "release": "bash scripts/release.sh",
+    "release:dry-run": "bash scripts/release-dry-run.sh",
+    "prepublishOnly": "npm run ci",
+    "dev": "tsx bin/convpdf.ts"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "github-slugger": "^2.0.0",
+    "glob": "^13.0.2",
+    "highlight.js": "^11.11.1",
+    "js-yaml": "^4.1.1",
+    "marked": "^17.0.1",
+    "marked-footnote": "^1.4.0",
+    "marked-gfm-heading-id": "^4.1.3",
+    "marked-highlight": "^2.2.3",
+    "puppeteer": "^24.37.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.2.3",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.3.0",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.55.0",
+    "vitest": "^4.0.18"
+  }
+}