@cenk1cenk2/md-printer 3.2.24 → 3.4.0

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

@@ -1,10 +1,10 @@
 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";
@@ -34,6 +34,8 @@ let MdPrinterHandler = class MdPrinterHandler {
 			outputFiletype: flags["output-filetype"],
 			stdout: flags.stdout,
 			template: flags.template,
+			templateType: flags["template-type"],
+			templateDirectory: flags["template-directory"],
 			title: flags.title,
 			language: flags.language,
 			continuous: flags.continuous,

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/modules/md-printer/md-printer.schema.mjs

@@ -1,6 +1,7 @@
 import { InputFileType, OutputFileType } from "../../constants/file.constants.mjs";
 import { PreviewHost } from "../../constants/preview.constants.mjs";
 import { SignatureProvider } from "../../constants/signature.constants.mjs";
+import "../../constants/template.constants.mjs";
 import { z } from "zod";
 // src/modules/md-printer/md-printer.schema.ts
 const MdPrinterSchema = z.object({
@@ -9,7 +10,9 @@ const MdPrinterSchema = z.object({
 		["input-filetype"]: z.enum(InputFileType).optional().describe("Input file type. Detected from the file extension, markdown for stdin and unknown extensions."),
 		["output-filetype"]: z.enum(OutputFileType).optional().describe("Output file type, defaults to pdf. Overwrites the one defined in front-matter."),
 		stdout: z.boolean().default(false).describe("Write the output to stdout instead of a file."),
-		template: z.string().optional().describe("Built-in template name or path to a template directory, defaults to \"default\". Overwrites the one defined in front-matter."),
+		template: z.string().optional().describe("Built-in template name or path to a template directory, defaults to \"default\", read as --template-type when given. Overwrites the one defined in front-matter."),
+		["template-type"]: z.string().optional().describe("How to read --template, one of builtin, package or directory, like the type of the object form in front-matter."),
+		["template-directory"]: z.string().optional().describe("Directory inside the package to use as the template, only valid with --template-type package."),
 		title: z.string().optional().describe("Document title. Overwrites the one defined in front-matter or the template."),
 		language: z.string().optional().describe("Language for template translations. Overwrites the one defined in front-matter and template settings."),
 		browser: z.string().optional().describe("Browser executable used for printing. Discovered automatically when omitted (Brave, Chrome, Chromium, Edge)."),
@@ -35,6 +38,14 @@ const MdPrinterSchema = z.object({
 		code: "custom",
 		message: "Reading from --stdin takes only the output file argument."
 	});
+	if (flags["template-type"] && !flags.template) ctx.addIssue({
+		code: "custom",
+		message: "--template-type needs --template to read."
+	});
+	if (flags["template-directory"] !== void 0 && flags["template-type"] !== "package") ctx.addIssue({
+		code: "custom",
+		message: "--template-directory is only valid with --template-type package."
+	});
 	if (flags.stdout && flags.preview) ctx.addIssue({
 		code: "custom",
 		message: "Writing to stdout is not supported with --preview."

package/dist/services/i18n.service.mjs

@@ -1,6 +1,6 @@
 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 { basename, extname, join } from "path";
@@ -14,14 +14,16 @@ let I18nService = class I18nService {
 		this.fs = fs;
 		this.parser = parser;
 	}
-	async load(directory, options) {
+	/** Loads the folders in order, a key of a later folder replacing the same key of an earlier one while nested keys merge. */
+	async load(directories, options) {
 		const instance = i18next.createInstance();
 		await instance.init({
 			lng: options.language,
 			fallbackLng: options.fallback ?? options.language ?? "en",
-			resources: this.fs.exists(directory) ? await this.resources(directory) : {},
+			resources: {},
 			interpolation: { escapeValue: false }
 		});
+		for (const directory of directories.filter((directory) => this.fs.exists(directory))) for (const [language, { translation }] of Object.entries(await this.resources(directory))) instance.addResourceBundle(language, "translation", translation, true, true);
 		return instance.getFixedT(options.language);
 	}
 	async resources(directory) {

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,16 +1,19 @@
 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 { TemplateSourceSchema, issues } from "./template/template.schema.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 { basename, dirname, extname, resolve } from "path";
 import { ConfigService, FileSystemService, LoggerService } from "@cenk1cenk2/oclif-common";
 import { cloneDeep, mergeWith, uniq } from "es-toolkit";
 import { parse } from "yaml";
@@ -23,8 +26,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 +36,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);
 	}
@@ -61,13 +66,14 @@ let PrinterService = class PrinterService {
 	}
 	async options(flags, input) {
 		const { data } = input;
-		const template = this.template.resolve(flags.template ?? data.template ?? "default");
-		const settings = await this.template.settings(template);
+		const source = this.templateSource(this.templateFlags(flags) ?? data.template) ?? "default";
+		const { directory: template, settings, files } = await this.template.resolve(source, input.directory);
 		const output = flags.outputFiletype ?? data.outputFiletype ?? "pdf";
 		if (!Object.values(OutputFileType).includes(output)) throw new Error(`Output file type is not supported: ${output}, use one of ${Object.values(OutputFileType).join(", ")}.`);
 		const dest = flags.stdout ? void 0 : flags.output ?? data.dest ?? (input.file ? `${basename(input.file, extname(input.file))}.${output}` : void 0);
 		return {
 			template,
+			files,
 			output,
 			dest: dest && resolve(dest),
 			title: flags.title ?? data.documentTitle,
@@ -77,11 +83,13 @@ 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) {
-		return this.template.bundle(options.template);
+		return this.template.bundle(options.files);
 	}
 	/**
 	* Resolves the signing time and the visible signature description, which the template renders before the document is signed.
@@ -98,7 +106,7 @@ let PrinterService = class PrinterService {
 		const { input, options } = ctx;
 		const document = await this.template.render(options.template, bundle, {
 			data: input.data,
-			t: await this.i18n.load(join(options.template, "i18n"), {
+			t: await this.i18n.load(options.files.i18n, {
 				...options.i18n,
 				language: options.language
 			}),
@@ -115,6 +123,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 +136,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 +160,35 @@ let PrinterService = class PrinterService {
 			throw err;
 		});
 	}
+	templateFlags({ template, templateType, templateDirectory }) {
+		if (!templateType) return template;
+		return {
+			type: templateType,
+			[templateType === "directory" ? "path" : "name"]: template,
+			...templateDirectory !== void 0 && { directory: templateDirectory }
+		};
+	}
+	templateSource(value) {
+		if (value === void 0 || value === null) return;
+		if (typeof value === "string") return value;
+		const { success, data, error } = TemplateSourceSchema.safeParse(value);
+		if (!success) throw new Error(`Template is invalid: ${issues(error)}`);
+		return data;
+	}
+	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 +219,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,10 +1,11 @@
 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";
+import { isEqual } from "es-toolkit";
 import { EventEmitter } from "events";
 import { watch } from "chokidar";
 import { debounce } from "perfect-debounce";
@@ -53,7 +54,7 @@ let SessionService = class SessionService extends EventEmitter {
 		const file = resolve(path);
 		if (this.ignored.has(file)) return;
 		this.logger.debug("Changed: %s", file);
-		if (this.modules.has(file) || this.bundle && dirname(file) === join(this.bundle.template, "components")) this.bundle = void 0;
+		if (this.modules.has(file) || this.bundle?.files.components.includes(dirname(file))) this.bundle = void 0;
 		this.build();
 	}
 	async run() {
@@ -62,18 +63,17 @@ let SessionService = class SessionService extends EventEmitter {
 		try {
 			const input = await this.printer.input(this.flags);
 			const options = await this.printer.options(this.flags, input);
-			const template = join(options.template, "Template.svelte");
-			this.modules.add(template);
+			const { files } = options;
+			this.modules = /* @__PURE__ */ new Set([...this.modules, files.template]);
 			this.watch([
 				input.file,
-				template,
+				files.template,
+				...files.candidates,
 				join(options.template, "settings.json"),
-				join(options.template, "i18n"),
-				join(options.template, "components"),
 				options.sign.certificate && resolve(options.sign.certificate)
 			]);
-			if (this.bundle?.template !== options.template) this.bundle = {
-				template: options.template,
+			if (!isEqual(this.bundle?.files, files)) this.bundle = {
+				files,
 				bundle: this.printer.bundle(options)
 			};
 			const cached = this.bundle;
@@ -82,7 +82,7 @@ let SessionService = class SessionService extends EventEmitter {
 				throw err;
 			});
 			if (this.bundle !== cached) return;
-			this.modules = /* @__PURE__ */ new Set([template, ...bundle.modules]);
+			this.modules = /* @__PURE__ */ new Set([files.template, ...bundle.modules]);
 			this.watch(bundle.modules);
 			const ctx = {
 				input,

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

@@ -1,13 +1,17 @@
+import modules from 'md-printer:extension'
 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 }
+// a CommonJS module also comes with module.exports as the default
+const extension = Object.fromEntries(modules.flatMap((module) => Object.entries(module).filter(([name]) => name !== 'default')))
+
+export { components, extension }
 
 /**
  * Entry of every template bundle, compiled at runtime together with the template it renders.

package/dist/services/template/svelte.plugin.mjs

@@ -1,7 +1,7 @@
 import { dataUri, isInlinableAsset } from "./assets.mjs";
 import "../../constants/template.constants.mjs";
 import { readFile, readdir } from "fs/promises";
-import { basename, dirname, extname, join } from "path";
+import { basename, extname, join } from "path";
 import { pathToFileURL } from "url";
 import { existsSync } from "fs";
 import { createRequire } from "module";
@@ -10,9 +10,10 @@ import { compile, preprocess } from "svelte/compiler";
 /**
 * `svelte` resolves to md-printer's copy, since templates can live outside any `node_modules`. `<style lang="postcss">` blocks are collected
 * instead of compiled per component, so the template's stylesheet goes through Tailwind once. `md-printer:template-components` maps the shared
-* components and the template's `components/*.svelte` by name, the template's winning.
+* components and the `*.svelte` files of the template's components directory by name, the template's winning. `md-printer:extension` is the extension module of the
+* template, or an empty module without one.
 */
-function sveltePlugin({ template, components, root, stylesheets }) {
+function sveltePlugin({ template, components, templateComponents, root, stylesheets, extension }) {
 	const require = createRequire(root);
 	return {
 		name: "md-printer:svelte",
@@ -20,6 +21,7 @@ function sveltePlugin({ template, components, root, stylesheets }) {
 			if (id === "md-printer:template") return template;
 			if (id === "@cenk1cenk2/md-printer/components") return components;
 			if (id === "md-printer:template-components") return `\0${id}`;
+			if (id === "md-printer:extension") return `\0${id}`;
 			if (id === "svelte" || id.startsWith("svelte/")) return {
 				id: pathToFileURL(require.resolve(id)).href,
 				external: true
@@ -28,15 +30,18 @@ function sveltePlugin({ template, components, root, stylesheets }) {
 		},
 		async load(id) {
 			if (id === `\0md-printer:template-components`) {
-				const directory = join(dirname(template), "components");
-				const files = existsSync(directory) ? (await readdir(directory)).filter((file) => extname(file) === ".svelte").sort() : [];
+				const files = (await Promise.all((templateComponents ?? []).map(async (folder) => existsSync(folder) ? (await readdir(folder)).filter((file) => extname(file) === ".svelte").sort().map((file) => join(folder, file)) : []))).flat();
 				return [
 					`import * as shared from ${JSON.stringify("@cenk1cenk2/md-printer/components")}`,
-					...files.map((file, index) => `import $${index} from ${JSON.stringify(join(directory, file))}`),
-					"const { Markdown, ...builtins } = shared",
+					...files.map((file, index) => `import $${index} from ${JSON.stringify(file)}`),
+					"const { Markdown, getExtension, ...builtins } = shared",
 					`export default { ...builtins, ${files.map((file, index) => `${JSON.stringify(basename(file, ".svelte"))}: $${index}`).join(", ")} }`
 				].join("\n");
 			}
+			if (id === `\0md-printer:extension`) {
+				const modules = extension ?? [];
+				return [...modules.map((file, index) => `import * as $${index} from ${JSON.stringify(file)}`), `export default [${modules.map((_, index) => `$${index}`).join(", ")}]`].join("\n");
+			}
 			if (!isInlinableAsset(id)) return null;
 			return `export default ${JSON.stringify(dataUri(id, await readFile(id)))}`;
 		},