@cenk1cenk2/md-printer 3.2.23 → 3.3.0

package/README.md

@@ -100,6 +100,8 @@ Markdown files take YAML front-matter. For YAML input the same keys are top-leve
 | `documentTitle`  | Document title.                                                                               |
 | `pdfOptions`     | Puppeteer [PDF options](https://pptr.dev/api/puppeteer.pdfoptions), merged over the defaults. |
 | `sign`            | Signing options, see [Signing](#signing).                                                     |
+| `attachments`     | PDFs merged into the output, see [Attachments and compression](#attachments-and-compression). |
+| `compress`        | `true` compresses the images of the whole output PDF, attachments included.                   |
 
 A template may carry a `settings.json` with defaults for its documents:
 
@@ -133,6 +135,29 @@ pdfOptions:
 - `continuous` is enabled when any of `--continuous`, front-matter or `settings.json` enables it.
 - The document title is `--title`, then `documentTitle`, then the `<title>` set by the template, then the input file name.
 
+## Attachments and compression
+
+PDF output can carry other PDFs, such as certificates or reference letters, and can be compressed.
+
+```yaml
+---
+compress: true
+attachments:
+  - file: ./assets/references/diploma.pdf
+    position: before
+  - file: https://example.com/certificate.pdf
+    position: 2
+    compress: true
+  - file: ./assets/references/letter.pdf
+---
+```
+
+- `file` is a path relative to the input file, confined to its directory like every other local asset, or an `http(s)` URL.
+- `position` is `before` the document, `after` it (the default) or a page number: the attachment starts at that page of the rendered document, so `2` places it between the first and the second page, and the page after the last one appends it. Page numbers always count pages of the rendered document, not of other attachments, and attachments sharing a position keep the order they are listed in.
+- `compress: true` on an attachment re-encodes its images, `compress: true` at the top level does the same for the whole output, attachments included. Images are scaled down to at most 2000px and stored as JPEG at quality 75 whenever that makes them smaller; masks and images with transparency keep their lossless encoding.
+- Attachments and compression are applied before signing, so a signature covers them. They are only supported for PDF output.
+- `--preview` rebuilds when a local attachment changes.
+
 ## Development
 
 ```sh
@@ -152,11 +177,14 @@ md-printer document.md out.pdf --preview --no-open
 
 ### Built-in templates
 
+Every built-in template is a package of its own, `@cenk1cenk2/md-printer-template-<name>`, published from the `templates/` directory of this repository. md-printer depends on all of them, so they install with it, and each one brings the fonts, icons and stylesheets it uses as its own dependencies.
+
 | Name        | Description                                                                                                    |
 | ----------- | -------------------------------------------------------------------------------------------------------------- |
 | `default`   | GitHub-flavoured Markdown styling with Montserrat. This is the default.                                        |
 | `kilic.dev` | Same styling with a logo in the header and a footer with title and page numbers.                               |
 | `invoice`   | Invoice from YAML data (`company`, `client`, `payment`, `items`, `currency`, `date`, `id`) and Markdown notes. Translations in `en` and `de`, a signature block when signing. See `test/invoice.md`. |
+| `cv`        | CV in the table layout of a classic Word CV, from front-matter (`name`, `suffix`, `title`, `tagline`, `photo`) and Markdown sections placed with the `::section`, `:::details` / `::detail` / `:::pair`, `:::entry`, `::::group` / `:::course`, `::skill`, `:::note` and `:::languages` / `::language` components. The PDF is tagged and has an outline, so screening tools read it as text. See `test/cv.md`. |
 | `mail`      | Plain content with no margin and Tailwind typography, meant for HTML output.                                   |
 
 ### Authoring a template
@@ -183,7 +211,11 @@ my-template/
 
 Set the document title with `<svelte:head><title>...</title></svelte:head>`.
 
-Styles that need Tailwind CSS v4 or package imports go into a `<style lang="postcss">` block in `Template.svelte` or any component it imports. These blocks are collected and compiled together, so they can `@import 'tailwindcss'` and use `@plugin`, `@theme` and utility classes. Plain `<style>` blocks stay scoped Svelte styles. `@import` of packages (for example `@fontsource/*`, `github-markdown-css`) resolves from the template directory first and also from md-printer's own dependencies, so the template does not need a `node_modules`. The selected highlight.js theme is always included. Local `url()` and image references are inlined as data URIs.
+Components may be written in TypeScript with `<script lang="ts">`, and `.ts` modules can be imported, as `./round.js` or `./round.ts`. Svelte strips the types of components, so only type annotations are allowed there, no enums or other TypeScript that emits code; `.ts` modules take full TypeScript. Types are not checked while rendering. The built-in templates are written this way.
+
+A template can bring its own dependencies: give the template directory a `package.json` and install it there, as the built-in templates do. Imports in components, `.ts` modules, `@import` in `<style lang="postcss">` and imported images such as `@fortawesome/fontawesome-free/svgs/solid/user.svg` resolve from the template's `node_modules` first and fall back to md-printer's own dependencies. md-printer does not install them for you; a missing one fails the build with the directory to install it in.
+
+Styles that need Tailwind CSS v4 or package imports go into a `<style lang="postcss">` block in `Template.svelte` or any component it imports. These blocks are collected and compiled together, so they can `@import 'tailwindcss'` and use `@plugin`, `@theme` and utility classes. Plain `<style>` blocks stay scoped Svelte styles. `@import` of packages (for example `@fontsource/*`, `github-markdown-css`) resolves from the template directory first and then from md-printer's own dependencies, which cover `tailwindcss` and the highlight.js themes. The selected highlight.js theme is always included. Local `url()` and image references are inlined as data URIs.
 
 Images are imported, which inlines them as data URIs:
 

package/dist/_virtual/{_@oxc-project_runtime@0.156.0 → _@oxc-project_runtime@0.157.0}/helpers/esm/decorate.mjs

@@ -1,4 +1,4 @@
-// \0@oxc-project+runtime@0.156.0/helpers/esm/decorate.js
+// \0@oxc-project+runtime@0.157.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/_virtual/{_@oxc-project_runtime@0.156.0 → _@oxc-project_runtime@0.157.0}/helpers/esm/decorateMetadata.mjs

@@ -1,4 +1,4 @@
-// \0@oxc-project+runtime@0.156.0/helpers/esm/decorateMetadata.js
+// \0@oxc-project+runtime@0.157.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }

package/dist/_virtual/{_@oxc-project_runtime@0.156.0 → _@oxc-project_runtime@0.157.0}/helpers/esm/decorateParam.mjs

@@ -1,4 +1,4 @@
-// \0@oxc-project+runtime@0.156.0/helpers/esm/decorateParam.js
+// \0@oxc-project+runtime@0.157.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);

package/dist/commands/index.mjs

@@ -1,7 +1,7 @@
 import { MdPrinterHandler } from "../modules/md-printer/md-printer.handler.mjs";
 import { MdPrinterModule } from "../modules/md-printer/md-printer.module.mjs";
 import { MdPrinterSchema } from "../modules/md-printer/md-printer.schema.mjs";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Args, Command, Flags, UseHandler } from "@cenk1cenk2/oclif-common";
 // src/commands/index.ts
 let MDPrinter = class MDPrinter extends Command {

package/dist/constants/attachment.constants.mjs

@@ -0,0 +1,7 @@
+// src/constants/attachment.constants.ts
+let AttachmentPosition = /* @__PURE__ */ function(AttachmentPosition) {
+	AttachmentPosition["BEFORE"] = "before";
+	AttachmentPosition["AFTER"] = "after";
+	return AttachmentPosition;
+}({});
+export { AttachmentPosition };

package/dist/constants/index.mjs

@@ -1,5 +1,6 @@
-import { ContextKey, DEFAULT_HIGHLIGHT_STYLE, DEFAULT_LANGUAGE, DEFAULT_PDF_OPTIONS, DEFAULT_TEMPLATE, DIRECTIVE_TAG, Directory, I18N_ACCEPTED_TYPES, MediaType, ModuleSpecifier, PAGE_BREAK_CLASS, PRINTER_MODULE_OPTIONS, RenderMode, TAILWIND_STYLE_LANG, TemplateFiles } from "./template.constants.mjs";
+import { AttachmentPosition } from "./attachment.constants.mjs";
+import { ContextKey, DEFAULT_HIGHLIGHT_STYLE, DEFAULT_LANGUAGE, DEFAULT_PDF_OPTIONS, DEFAULT_TEMPLATE, DIRECTIVE_TAG, Directory, I18N_ACCEPTED_TYPES, MediaType, ModuleSpecifier, PAGE_BREAK_CLASS, PRINTER_MODULE_OPTIONS, RenderMode, TAILWIND_STYLE_LANG, TEMPLATE_PACKAGE_PREFIX, TemplateFiles } from "./template.constants.mjs";
 import { InputFileType, OutputFileType } from "./file.constants.mjs";
 import { PreviewHost } from "./preview.constants.mjs";
 import { SignatureProvider } from "./signature.constants.mjs";
-export { ContextKey, DEFAULT_HIGHLIGHT_STYLE, DEFAULT_LANGUAGE, DEFAULT_PDF_OPTIONS, DEFAULT_TEMPLATE, DIRECTIVE_TAG, Directory, I18N_ACCEPTED_TYPES, InputFileType, MediaType, ModuleSpecifier, OutputFileType, PAGE_BREAK_CLASS, PRINTER_MODULE_OPTIONS, PreviewHost, RenderMode, SignatureProvider, TAILWIND_STYLE_LANG, TemplateFiles };
+export { AttachmentPosition, ContextKey, DEFAULT_HIGHLIGHT_STYLE, DEFAULT_LANGUAGE, DEFAULT_PDF_OPTIONS, DEFAULT_TEMPLATE, DIRECTIVE_TAG, Directory, I18N_ACCEPTED_TYPES, InputFileType, MediaType, ModuleSpecifier, OutputFileType, PAGE_BREAK_CLASS, PRINTER_MODULE_OPTIONS, PreviewHost, RenderMode, SignatureProvider, TAILWIND_STYLE_LANG, TEMPLATE_PACKAGE_PREFIX, TemplateFiles };

package/dist/constants/template.constants.mjs

@@ -15,8 +15,9 @@ let MediaType = /* @__PURE__ */ function(MediaType) {
 	MediaType["PRINT"] = "print";
 	return MediaType;
 }({});
+/** Built-in templates are packages named with this prefix, which md-printer depends on. */
+const TEMPLATE_PACKAGE_PREFIX = "@cenk1cenk2/md-printer-template-";
 let Directory = /* @__PURE__ */ function(Directory) {
-	Directory["TEMPLATES"] = "templates";
 	Directory["COMPONENTS"] = "components";
 	Directory["I18N"] = "i18n";
 	return Directory;
@@ -56,4 +57,4 @@ const DEFAULT_PDF_OPTIONS = {
 		left: "20mm"
 	}
 };
-export { ContextKey, DEFAULT_HIGHLIGHT_STYLE, DEFAULT_LANGUAGE, DEFAULT_PDF_OPTIONS, DEFAULT_TEMPLATE, DIRECTIVE_TAG, Directory, I18N_ACCEPTED_TYPES, MediaType, ModuleSpecifier, PAGE_BREAK_CLASS, PRINTER_MODULE_OPTIONS, RenderMode, TAILWIND_STYLE_LANG, TemplateFiles };
+export { ContextKey, DEFAULT_HIGHLIGHT_STYLE, DEFAULT_LANGUAGE, DEFAULT_PDF_OPTIONS, DEFAULT_TEMPLATE, DIRECTIVE_TAG, Directory, I18N_ACCEPTED_TYPES, MediaType, ModuleSpecifier, PAGE_BREAK_CLASS, PRINTER_MODULE_OPTIONS, RenderMode, TAILWIND_STYLE_LANG, TEMPLATE_PACKAGE_PREFIX, TemplateFiles };

package/dist/interfaces/attachment.interface.mjs

@@ -0,0 +1 @@
+export {};

package/dist/modules/md-printer/md-printer.handler.mjs

@@ -1,16 +1,16 @@
 import "../../services/index.mjs";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
 import { BrowserService } from "../../services/renderer/browser.service.mjs";
 import { PrinterService } from "../../services/printer.service.mjs";
 import { PreviewService } from "../../services/session/preview.service.mjs";
 import { SessionService } from "../../services/session/session.service.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { mkdir } from "fs/promises";
 import { dirname } from "path";
-import { LoggerService } from "@cenk1cenk2/oclif-common";
 import { text } from "stream/consumers";
 import writeFileAtomic from "write-file-atomic";
+import { LoggerService } from "@cenk1cenk2/oclif-common";
 // src/modules/md-printer/md-printer.handler.ts
 let MdPrinterHandler = class MdPrinterHandler {
 	logger;

package/dist/modules/md-printer/md-printer.module.mjs

@@ -1,7 +1,7 @@
 import { MdPrinterHandler } from "./md-printer.handler.mjs";
 import { PrinterModule } from "../../services/printer.module.mjs";
 import "../../services/index.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Module } from "@nestjs/common";
 import { CommandContext, LogLevels, LoggerModule, LogoModule } from "@cenk1cenk2/oclif-common";
 // src/modules/md-printer/md-printer.module.ts

package/dist/services/i18n.service.mjs

@@ -1,11 +1,11 @@
 import { I18N_ACCEPTED_TYPES } from "../constants/template.constants.mjs";
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { readdir } from "fs/promises";
-import i18next from "i18next";
 import { basename, extname, join } from "path";
 import { FileSystemService, ParserService } from "@cenk1cenk2/oclif-common";
+import i18next from "i18next";
 // src/services/i18n.service.ts
 let I18nService = class I18nService {
 	fs;

package/dist/services/index.mjs

@@ -1,5 +1,6 @@
 import { I18nService } from "./i18n.service.mjs";
 import { MarkdownService } from "./markdown.service.mjs";
+import { PdfService } from "./pdf/pdf.service.mjs";
 import { PrinterModule } from "./printer.module.mjs";
 import { PrinterService } from "./printer.service.mjs";
 import { IncompleteSignatureError, SignatureVerificationError, parseSignedData } from "./signature/cms.mjs";
@@ -12,4 +13,4 @@ import { PreviewService } from "./session/preview.service.mjs";
 import { SessionService } from "./session/session.service.mjs";
 import "./signature/index.mjs";
 import { TemplateService } from "./template/template.service.mjs";
-export { ATrustAdapter, BrowserService, I18nService, IncompleteSignatureError, MarkdownService, PreviewService, PrinterModule, PrinterService, RendererService, SessionService, SignatureAdapter, SignatureService, SignatureVerificationError, TemplateService, parseSignedData };
+export { ATrustAdapter, BrowserService, I18nService, IncompleteSignatureError, MarkdownService, PdfService, PreviewService, PrinterModule, PrinterService, RendererService, SessionService, SignatureAdapter, SignatureService, SignatureVerificationError, TemplateService, parseSignedData };

package/dist/services/markdown.service.mjs

@@ -1,5 +1,5 @@
 import { DIRECTIVE_TAG, PAGE_BREAK_CLASS } from "../constants/template.constants.mjs";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { toHtml } from "hast-util-to-html";
 import { all } from "lowlight";

package/dist/services/pdf/pdf.service.mjs

@@ -0,0 +1,124 @@
+import { resolveConfined } from "../template/assets.mjs";
+import "../../constants/attachment.constants.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
+import { Injectable } from "@nestjs/common";
+import { readFile } from "fs/promises";
+import { resolve } from "path";
+import { LoggerService } from "@cenk1cenk2/oclif-common";
+import * as mupdf from "mupdf";
+// src/services/pdf/pdf.service.ts
+var _PdfService;
+let PdfService = class PdfService {
+	static {
+		_PdfService = this;
+	}
+	logger;
+	static IMAGE_MAX_DIMENSION = 2e3;
+	static JPEG_QUALITY = 75;
+	constructor(logger) {
+		this.logger = logger;
+		this.logger.setup(this.constructor.name);
+	}
+	async process(pdf, options) {
+		if (!options.attachments.length && !options.compress) return {
+			pdf,
+			assets: []
+		};
+		const document = new mupdf.PDFDocument(pdf);
+		const pages = document.countPages();
+		const assets = [];
+		const loaded = await Promise.all(options.attachments.map(async (attachment) => {
+			const { content, path } = await this.load(attachment.file, options.directory);
+			if (path) assets.push(path);
+			return {
+				attachment,
+				document: this.open(attachment.file, content),
+				anchor: this.anchor(attachment, pages)
+			};
+		}));
+		for (const { attachment, document: source, anchor } of loaded.map((item, index) => ({
+			...item,
+			index
+		})).sort((a, b) => b.anchor - a.anchor || b.index - a.index)) {
+			if (attachment.compress && !options.compress) this.compress(source);
+			for (let page = 0; page < source.countPages(); page++) document.graftPage(anchor + page, source, page);
+			this.logger.debug("Attached %s with %d pages at page %d.", attachment.file, source.countPages(), anchor + 1);
+		}
+		if (options.compress) this.compress(document);
+		const output = Buffer.from(document.saveToBuffer(options.compress ? "garbage=compact,compress,compress-fonts" : "garbage=compact,compress").asUint8Array());
+		this.logger.debug("Processed PDF: %d bytes to %d bytes.", pdf.length, output.length);
+		return {
+			pdf: output,
+			assets
+		};
+	}
+	anchor(attachment, pages) {
+		if (attachment.position === "before") return 0;
+		if (typeof attachment.position !== "number") return pages;
+		if (attachment.position > pages + 1) throw new Error(`Attachment ${attachment.file} is placed at page ${attachment.position}, but the document has ${pages} pages.`);
+		return attachment.position - 1;
+	}
+	async load(file, directory) {
+		if (/^https?:\/\//.test(file)) {
+			const response = await fetch(file);
+			if (!response.ok) throw new Error(`Attachment can not be fetched: ${file}, ${response.status} ${response.statusText}`);
+			return { content: new Uint8Array(await response.arrayBuffer()) };
+		}
+		const path = await resolveConfined(resolve(directory, file), directory);
+		if (!path) throw new Error(`Attachment does not exist or is outside of the input directory: ${file}`);
+		return {
+			content: await readFile(path),
+			path
+		};
+	}
+	open(file, content) {
+		if (Buffer.from(content.subarray(0, 5)).toString() !== "%PDF-") throw new Error(`Attachment is not a PDF: ${file}`);
+		return new mupdf.PDFDocument(content);
+	}
+	/**
+	* Re-encodes the images of a document as JPEG, scaled down to fit a printed page, whenever that makes them smaller.
+	* Soft masks, stencil masks and images below 8 bits per component keep their lossless encoding.
+	*/
+	compress(document) {
+		const images = [];
+		const masks = /* @__PURE__ */ new Set();
+		for (let number = 1; number < document.countObjects(); number++) {
+			const object = document.newIndirect(number);
+			if (!object.isStream()) continue;
+			const subtype = object.get("Subtype");
+			if (!subtype.isName() || subtype.asName() !== "Image") continue;
+			const mask = object.get("SMask");
+			if (mask.isIndirect()) masks.add(mask.asIndirect());
+			images.push(object);
+		}
+		for (const object of images) {
+			if (masks.has(object.asIndirect()) || object.get("ImageMask").valueOf() === true) continue;
+			const image = document.loadImage(object);
+			if (image.getBitsPerComponent() < 8) continue;
+			let pixmap = image.toPixmap();
+			if (pixmap.getAlpha()) continue;
+			if (!pixmap.getColorSpace().isGray() && !pixmap.getColorSpace().isRGB()) pixmap = pixmap.convertToColorSpace(mupdf.ColorSpace.DeviceRGB);
+			const [width, height] = [pixmap.getWidth(), pixmap.getHeight()];
+			const scale = Math.min(1, _PdfService.IMAGE_MAX_DIMENSION / Math.max(width, height));
+			if (scale < 1) pixmap = pixmap.warp([
+				[0, 0],
+				[width, 0],
+				[width, height],
+				[0, height]
+			], Math.round(width * scale), Math.round(height * scale));
+			const jpeg = pixmap.asJPEG(_PdfService.JPEG_QUALITY);
+			if (jpeg.length >= object.readRawStream().length) continue;
+			object.writeRawStream(jpeg);
+			object.put("Filter", document.newName("DCTDecode"));
+			object.delete("DecodeParms");
+			object.delete("Decode");
+			object.put("Width", pixmap.getWidth());
+			object.put("Height", pixmap.getHeight());
+			object.put("BitsPerComponent", 8);
+			object.put("ColorSpace", document.newName(pixmap.getColorSpace().isGray() ? "DeviceGray" : "DeviceRGB"));
+		}
+	}
+};
+PdfService = _PdfService = __decorate([Injectable(), __decorateMetadata("design:paramtypes", [typeof LoggerService === "undefined" ? Object : LoggerService])], PdfService);
+export { PdfService };

package/dist/services/printer.module.mjs

@@ -1,5 +1,6 @@
 import { I18nService } from "./i18n.service.mjs";
 import { MarkdownService } from "./markdown.service.mjs";
+import { PdfService } from "./pdf/pdf.service.mjs";
 import { PrinterService } from "./printer.service.mjs";
 import { BrowserService } from "./renderer/browser.service.mjs";
 import { RendererService } from "./renderer/renderer.service.mjs";
@@ -9,7 +10,7 @@ import { ATrustAdapter } from "./signature/adapters/a-trust.adapter.mjs";
 import { SignatureService } from "./signature/signature.service.mjs";
 import { TemplateService } from "./template/template.service.mjs";
 import { PRINTER_MODULE_OPTIONS } from "../constants/template.constants.mjs";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { ConfigurableModuleBuilder, Module } from "@nestjs/common";
 import { FilesystemModule, JsonParser, ParserModule, YamlParser } from "@cenk1cenk2/oclif-common";
 // src/services/printer.module.ts
@@ -22,6 +23,7 @@ PrinterModule = __decorate([Module({
 		TemplateService,
 		BrowserService,
 		RendererService,
+		PdfService,
 		ATrustAdapter,
 		SignatureService,
 		PrinterService,

package/dist/services/printer.service.mjs

@@ -1,14 +1,16 @@
 import { I18nService } from "./i18n.service.mjs";
 import { MarkdownService } from "./markdown.service.mjs";
+import { PdfService } from "./pdf/pdf.service.mjs";
 import { RendererService } from "./renderer/renderer.service.mjs";
 import { SignatureVerificationError } from "./signature/cms.mjs";
 import { SignatureService } from "./signature/signature.service.mjs";
 import { inlineHtml } from "./template/assets.mjs";
 import { TemplateService } from "./template/template.service.mjs";
+import { AttachmentPosition } from "../constants/attachment.constants.mjs";
 import { DEFAULT_PDF_OPTIONS } from "../constants/template.constants.mjs";
 import { OutputFileType } from "../constants/file.constants.mjs";
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { basename, dirname, extname, join, resolve } from "path";
 import { ConfigService, FileSystemService, LoggerService } from "@cenk1cenk2/oclif-common";
@@ -23,8 +25,9 @@ let PrinterService = class PrinterService {
 	markdown;
 	template;
 	renderer;
+	pdf;
 	signature;
-	constructor(fs, logger, config, i18n, markdown, template, renderer, signature) {
+	constructor(fs, logger, config, i18n, markdown, template, renderer, pdf, signature) {
 		this.fs = fs;
 		this.logger = logger;
 		this.config = config;
@@ -32,6 +35,7 @@ let PrinterService = class PrinterService {
 		this.markdown = markdown;
 		this.template = template;
 		this.renderer = renderer;
+		this.pdf = pdf;
 		this.signature = signature;
 		this.logger.setup(this.constructor.name);
 	}
@@ -77,7 +81,9 @@ let PrinterService = class PrinterService {
 			highlight: settings.highlightStyle ?? "atom-one-dark",
 			pdf: this.pdfOptions(settings.pdfOptions, data.pdfOptions),
 			i18n: settings.i18n ?? {},
-			sign: this.signOptions(flags, settings.sign, data.sign)
+			sign: this.signOptions(flags, settings.sign, data.sign),
+			attachments: this.attachments(data.attachments),
+			compress: data.compress === true
 		};
 	}
 	bundle(options) {
@@ -115,6 +121,7 @@ let PrinterService = class PrinterService {
 	}
 	async output(ctx, document) {
 		if (ctx.options.output === "html") {
+			if (ctx.options.attachments.length || ctx.options.compress) throw new Error("Attachments and compression are only supported for PDF output.");
 			const { content, assets } = await inlineHtml(document.html, ctx.input.directory, { confined: true });
 			return {
 				content: Buffer.from(content),
@@ -127,9 +134,14 @@ let PrinterService = class PrinterService {
 			media: ctx.options.media,
 			continuous: ctx.options.continuous
 		});
+		const processed = await this.pdf.process(pdf, {
+			directory: ctx.input.directory,
+			attachments: ctx.options.attachments,
+			compress: ctx.options.compress
+		});
 		return {
-			content: pdf,
-			assets
+			content: processed.pdf,
+			assets: [...assets, ...processed.assets]
 		};
 	}
 	sign(ctx, pdf) {
@@ -146,6 +158,20 @@ let PrinterService = class PrinterService {
 			throw err;
 		});
 	}
+	attachments(value) {
+		if (value === void 0 || value === null) return [];
+		if (!Array.isArray(value)) throw new Error("Front-matter attachments must be a list of { file, position, compress }.");
+		return value.map((attachment, index) => {
+			if (typeof attachment?.file !== "string" || !attachment.file) throw new Error(`Attachment ${index + 1} needs a file path or URL.`);
+			const position = attachment.position ?? "after";
+			if (!Object.values(AttachmentPosition).includes(position) && !(Number.isInteger(position) && position >= 1)) throw new Error(`Attachment ${attachment.file} has an invalid position: ${position}, use ${Object.values(AttachmentPosition).join(", ")} or a page number.`);
+			return {
+				file: attachment.file,
+				position,
+				compress: attachment.compress === true
+			};
+		});
+	}
 	signOptions(flags, ...sources) {
 		return {
 			...Object.assign({}, ...sources),
@@ -176,6 +202,7 @@ PrinterService = __decorate([Injectable(), __decorateMetadata("design:paramtypes
 	typeof MarkdownService === "undefined" ? Object : MarkdownService,
 	typeof TemplateService === "undefined" ? Object : TemplateService,
 	typeof RendererService === "undefined" ? Object : RendererService,
+	typeof PdfService === "undefined" ? Object : PdfService,
 	typeof SignatureService === "undefined" ? Object : SignatureService
 ])], PrinterService);
 export { PrinterService };

package/dist/services/renderer/browser.service.mjs

@@ -1,8 +1,8 @@
 import { discoverBrowser } from "./browser.mjs";
 import { PRINTER_MODULE_OPTIONS } from "../../constants/template.constants.mjs";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorateParam from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateParam.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorateParam from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateParam.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Inject, Injectable } from "@nestjs/common";
 import { LoggerService } from "@cenk1cenk2/oclif-common";
 import puppeteer from "puppeteer-core";

package/dist/services/renderer/renderer.service.mjs

@@ -1,8 +1,8 @@
-import { BrowserService } from "./browser.service.mjs";
 import { mimeType, resolveConfined } from "../template/assets.mjs";
+import { BrowserService } from "./browser.service.mjs";
 import { PAGE_BREAK_CLASS } from "../../constants/template.constants.mjs";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { readFile } from "fs/promises";
 import { resolve } from "path";

package/dist/services/session/preview.service.mjs

@@ -2,8 +2,8 @@ import { isLoopbackRequest } from "../loopback.mjs";
 import { resolveConfined } from "../template/assets.mjs";
 import { TemplateService } from "../template/template.service.mjs";
 import "../../constants/file.constants.mjs";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { mkdtemp, rm } from "fs/promises";
 import { join } from "path";

package/dist/services/session/session.service.mjs

@@ -1,7 +1,7 @@
 import { PrinterService } from "../printer.service.mjs";
 import "../../constants/template.constants.mjs";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { dirname, join, resolve } from "path";
 import { LoggerService } from "@cenk1cenk2/oclif-common";

package/dist/services/signature/adapters/a-trust.adapter.mjs

@@ -4,8 +4,8 @@ import { BrowserService } from "../../renderer/browser.service.mjs";
 import { IncompleteSignatureError, parseSignedData } from "../cms.mjs";
 import { SignatureAdapter } from "../signature.adapter.mjs";
 import "../../../constants/signature.constants.mjs";
-import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { readFile } from "fs/promises";
 import { CommandContext, LoggerService } from "@cenk1cenk2/oclif-common";

package/dist/services/signature/signature.service.mjs

@@ -1,7 +1,7 @@
 import { ATrustAdapter } from "./adapters/a-trust.adapter.mjs";
 import { IncompleteSignatureError, SignatureVerificationError, parseSignedData } from "./cms.mjs";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { readFile } from "fs/promises";
 import { isAbsolute, join } from "path";

package/dist/services/template/assets.mjs

@@ -2,11 +2,11 @@ import { readFile, realpath } from "fs/promises";
 import { isAbsolute, relative, sep } from "path";
 import { toHtml } from "hast-util-to-html";
 import { visit } from "unist-util-visit";
-import { fileURLToPath, pathToFileURL } from "url";
 import { fromHtml } from "hast-util-from-html";
 import { transform, transformStyleAttribute } from "lightningcss";
 import mime from "mime";
 import { parseSrcset, stringifySrcset } from "srcset";
+import { fileURLToPath, pathToFileURL } from "url";
 // src/services/template/assets.ts
 const REFERENCES = {
 	img: ["src", "srcSet"],

package/dist/services/template/render.entry.ts

@@ -2,9 +2,9 @@ import Template from 'md-printer:template'
 import components from 'md-printer:template-components'
 import { render } from 'svelte/server'
 
+import Nodes from '../../components/Nodes.svelte'
 import Document from './Document.svelte'
 import Margin from './Margin.svelte'
-import Nodes from '../../components/Nodes.svelte'
 import type { DocumentShellProps, MarginShellProps, MarkdownNode, RenderedPart, TemplateProps } from '@interfaces'
 
 export { components }

package/dist/services/template/template.service.mjs

@@ -1,8 +1,8 @@
 import { inlineCss, inlineHtml } from "./assets.mjs";
 import { sveltePlugin } from "./svelte.plugin.mjs";
-import "../../constants/template.constants.mjs";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorateMetadata.mjs";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.156.0/helpers/esm/decorate.mjs";
+import { TEMPLATE_PACKAGE_PREFIX } from "../../constants/template.constants.mjs";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorateMetadata.mjs";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.mjs";
 import { Injectable } from "@nestjs/common";
 import { dirname, isAbsolute, join, resolve } from "path";
 import { FileSystemService } from "@cenk1cenk2/oclif-common";
@@ -47,7 +47,7 @@ let TemplateService = class TemplateService {
 	}
 	resolve(template) {
 		const path = template.replace(/^~(?=\/|$)/, homedir());
-		const directory = isAbsolute(path) || path.startsWith(".") || /[\\/]/.test(path) ? resolve(path) : join(_TemplateService.ROOT, "templates", path);
+		const directory = isAbsolute(path) || path.startsWith(".") || /[\\/]/.test(path) ? resolve(path) : this.builtin(path);
 		if (!this.fs.exists(join(directory, "Template.svelte"))) throw new Error(`Template does not exist, expected Template.svelte in: ${directory}`);
 		return directory;
 	}
@@ -108,11 +108,26 @@ let TemplateService = class TemplateService {
 			dependencies
 		};
 	}
+	/** A built-in template is a package of its own, so it brings its own fonts, icons and stylesheets as dependencies. */
+	builtin(name) {
+		const pkg = `${TEMPLATE_PACKAGE_PREFIX}${name}`;
+		try {
+			return dirname(this.require.resolve(`${pkg}/package.json`));
+		} catch {
+			throw new Error(`Template does not exist, expected the built-in template package ${pkg} or a path to a directory with Template.svelte.`);
+		}
+	}
 	async compile(input, template, stylesheets) {
 		const build = await rolldown({
 			input,
 			platform: "node",
-			logLevel: "silent",
+			logLevel: "warn",
+			onLog(_, log, handler) {
+				if (log.code === "UNRESOLVED_IMPORT") handler("error", {
+					...log,
+					message: `${log.message} Install it in the template directory: ${dirname(template)}`
+				});
+			},
 			plugins: [sveltePlugin({
 				template,
 				components: _TemplateService.COMPONENTS,

package/oclif.manifest.json

@@ -198,5 +198,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "3.2.23"
+  "version": "3.3.0"
 }