@cenk1cenk2/md-printer 3.4.0 → 3.5.0

package/README.md

@@ -93,7 +93,7 @@ Markdown files take YAML front-matter. For YAML input the same keys are top-leve
 | Key               | Description                                                                                   |
 | ----------------- | --------------------------------------------------------------------------------------------- |
 | `template`        | Built-in template name, path to a template directory or an object, see [Template sources](#template-sources). |
-| `dest`            | Output file, relative to the current directory, not to the input file.                        |
+| `dest`            | Output file, relative to the current directory, not to the input file. Also an object, see [Output destination](#output-destination). |
 | `outputFiletype` | `pdf` (default) or `html`.                                                                    |
 | `language`        | Language for template translations.                                                           |
 | `continuous`      | `true` renders one page per part, each as tall as its content, split only at page breaks.     |
@@ -128,6 +128,19 @@ pdfOptions:
 ---
 ```
 
+### Output destination
+
+`dest` is a file path, or an object that splits it into a `directory` and a `filename`. Both keys are optional: `directory` defaults to the current directory and `filename` to `<input name>.<pdf|html>`, so a document can pick a folder and keep its own name. Without an input file (stdin) the object needs a `filename`.
+
+```yaml
+---
+dest:
+  directory: ./out
+---
+```
+
+`document.md` with the front-matter above is written to `./out/document.pdf`. The output argument still wins over `dest` in either form.
+
 ### Precedence
 
 - General: flags > front-matter > template `settings.json` > defaults. `pdfOptions` are merged key by key in the order defaults, `settings.json`, front-matter.

package/dist/services/printer.schema.mjs

@@ -0,0 +1,7 @@
+import { z } from "zod";
+// src/services/printer.schema.ts
+const DestSchema = z.strictObject({
+	directory: z.string().min(1).optional(),
+	filename: z.string().min(1).optional()
+}, { error: (issue) => issue.code === "invalid_type" ? "Use a string or an object with a directory and a filename." : void 0 });
+export { DestSchema };

package/dist/services/printer.service.mjs

@@ -1,6 +1,7 @@
 import { I18nService } from "./i18n.service.mjs";
 import { MarkdownService } from "./markdown.service.mjs";
 import { PdfService } from "./pdf/pdf.service.mjs";
+import { DestSchema } from "./printer.schema.mjs";
 import { RendererService } from "./renderer/renderer.service.mjs";
 import { SignatureVerificationError } from "./signature/cms.mjs";
 import { SignatureService } from "./signature/signature.service.mjs";
@@ -13,7 +14,7 @@ import { OutputFileType } from "../constants/file.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 { basename, dirname, extname, resolve } from "path";
+import { basename, dirname, extname, join, resolve } from "path";
 import { ConfigService, FileSystemService, LoggerService } from "@cenk1cenk2/oclif-common";
 import { cloneDeep, mergeWith, uniq } from "es-toolkit";
 import { parse } from "yaml";
@@ -70,7 +71,7 @@ let PrinterService = class PrinterService {
 		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);
+		const dest = flags.stdout ? void 0 : flags.output ?? this.dest(data.dest, input.file && `${basename(input.file, extname(input.file))}.${output}`);
 		return {
 			template,
 			files,
@@ -175,6 +176,14 @@ let PrinterService = class PrinterService {
 		if (!success) throw new Error(`Template is invalid: ${issues(error)}`);
 		return data;
 	}
+	dest(value, filename) {
+		if (value === void 0 || value === null) return filename;
+		if (typeof value === "string") return value;
+		const { success, data, error } = DestSchema.safeParse(value);
+		if (!success) throw new Error(`Dest is invalid: ${issues(error)}`);
+		if (!data.filename && !filename) throw new Error("Dest needs a filename when there is no input file to name the output after.");
+		return join(data.directory ?? ".", data.filename ?? filename);
+	}
 	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 }.");

package/oclif.manifest.json

@@ -212,5 +212,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "3.4.0"
+  "version": "3.5.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cenk1cenk2/md-printer",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "Render markdown or yaml through Svelte templates into PDF or HTML with Puppeteer.",
   "type": "module",
   "repository": {
@@ -54,8 +54,8 @@
     "@cenk1cenk2/md-printer-template-invoice": "^1.0.0",
     "@cenk1cenk2/md-printer-template-kilic.dev": "1.1.0",
     "@cenk1cenk2/md-printer-template-mail": "1.1.0",
-    "@cenk1cenk2/oclif-common": "^8.0.2",
-    "@listr2/manager": "^4.3.3",
+    "@cenk1cenk2/oclif-common": "^8.0.4",
+    "@listr2/manager": "^4.3.4",
     "@nestjs/common": "^12.3.2",
     "@oclif/core": "^5.1.11",
     "@oclif/plugin-help": "^7.0.6",
@@ -75,7 +75,7 @@
     "highlight.js": "^11.12.0",
     "i18next": "^26.7.1",
     "lightningcss": "^1.33.0",
-    "listr2": "^11.4.0",
+    "listr2": "^11.4.1",
     "lowlight": "^3.3.0",
     "mime": "^4.1.2",
     "mupdf": "^1.28.1",