@crustjs/man 0.2.0 → 0.3.0

package/README.md

@@ -5,7 +5,7 @@ Generate mdoc(7) manual pages from Crust CLI definitions
 ## Install
 
 ```sh
-bun add -d @crustjs/man
+npm install -D @crustjs/man
 ```
 
 ## Documentation

package/dist/index.d.ts

@@ -6,8 +6,8 @@ interface ManOptions {
   readonly section?: number;
   /**
    * Installed command name used for the page title and filename. Defaults to
-   * the application name; set it when `crust build --name` or the npm bin key
-   * installs the CLI under a different name.
+   * the application name; set it when the npm bin key installs the CLI under a
+   * different name.
    */
   readonly name?: string;
 }

package/dist/index.js

@@ -1,7 +1,7 @@
-import { dirname, join } from "node:path";
 import { defineExtension, defineExtensionId } from "@crustjs/core";
 import { buildCommandDocumentation, formatDescription, sectionsFor } from "@crustjs/core/tooling";
 import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -19,22 +19,23 @@ const MAN = defineExtensionId("crust:man");
 /** Adds build-time mdoc generation for the application. */
 const man = defineExtension(MAN, (options = {}) => {
 	const section = options.section ?? 1;
-	return { async build({ snapshot, outDir }) {
-		const { writeManPage } = await Promise.resolve().then(() => write_man_page_exports);
+	return { async build({ snapshot }) {
+		const { renderManPageMdoc } = await Promise.resolve().then(() => mdoc_exports);
 		const name = options.name ?? snapshot.meta.name;
 		if (/[\\/]/.test(name)) throw new Error(`Manual name "${name}" must not contain path separators.`);
-		const outfile = join("man", `${name}.${section}`);
-		await writeManPage({
-			root: snapshot,
-			name,
-			section,
-			outfile: join(outDir, outfile)
-		});
-		return [outfile];
+		return [{
+			path: `man/${name}.${section}`,
+			content: renderManPageMdoc({
+				root: snapshot,
+				name,
+				section
+			})
+		}];
 	} };
 });
 //#endregion
 //#region src/mdoc.ts
+var mdoc_exports = /* @__PURE__ */ __exportAll({ renderManPageMdoc: () => renderManPageMdoc });
 function escapeMdocBodyLine(line) {
 	return /^[.']/.test(line) ? `\\&${line}` : line;
 }
@@ -149,7 +150,6 @@ function renderManPageMdoc(options) {
 }
 //#endregion
 //#region src/write-man-page.ts
-var write_man_page_exports = /* @__PURE__ */ __exportAll({ writeManPage: () => writeManPage });
 /** Render an mdoc(7) manual page from a Command Snapshot and write it to `outfile`. */
 async function writeManPage(options) {
 	const { root, name, outfile, section = 1, date } = options;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crustjs/man",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"description": "Generate mdoc(7) manual pages from Crust CLI definitions",
 	"type": "module",
 	"sideEffects": false,
@@ -45,13 +45,13 @@
 	},
 	"devDependencies": {
 		"@crustjs/config": "0.0.0",
-		"@crustjs/core": "0.2.0",
-		"@crustjs/extensions": "0.2.0",
-		"@crustjs/skills": "0.2.0",
+		"@crustjs/core": "0.3.0",
+		"@crustjs/extensions": "0.3.0",
+		"@crustjs/skills": "0.3.0",
 		"tsdown": "^0.23.0"
 	},
 	"peerDependencies": {
-		"@crustjs/core": "^0.2.0",
+		"@crustjs/core": "^0.3.0",
 		"typescript": "^7.0.0"
 	},
 	"peerDependenciesMeta": {
@@ -60,7 +60,7 @@
 		}
 	},
 	"engines": {
-		"bun": ">=1.3.14",
+		"bun": ">=1.4.0",
 		"node": ">=22",
 		"deno": ">=2.8"
 	}