@optique/man 1.1.0-dev.2096 → 1.1.0-dev.2148

package/dist/cli.cjs

@@ -17,7 +17,7 @@ const node_url = require_man.__toESM(require("node:url"));
 
 //#region deno.json
 var name = "@optique/man";
-var version = "1.1.0-dev.2096+8eda4929";
+var version = "1.1.0-dev.2148+ab56ac96";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",
@@ -25,14 +25,17 @@ var exports$1 = {
 	"./man": "./src/man.ts",
 	"./cli": "./src/cli.ts"
 };
-var imports = { "tsx/esm/api": "npm:tsx@^4.21.0/esm/api" };
+var imports = {
+	"#src/": "./src/",
+	"tsx/esm/api": "npm:tsx@^4.21.0/esm/api"
+};
 var exclude = ["dist/", "tsdown.config.ts"];
 var tasks = {
 	"build": "pnpm build",
 	"test": "deno test",
 	"test:node": {
 		"dependencies": ["build"],
-		"command": "node --experimental-transform-types --test"
+		"command": "node --test"
 	},
 	"test:bun": {
 		"dependencies": ["build"],

package/dist/cli.js

@@ -17,7 +17,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 
 //#region deno.json
 var name = "@optique/man";
-var version = "1.1.0-dev.2096+8eda4929";
+var version = "1.1.0-dev.2148+ab56ac96";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",
@@ -25,14 +25,17 @@ var exports = {
 	"./man": "./src/man.ts",
 	"./cli": "./src/cli.ts"
 };
-var imports = { "tsx/esm/api": "npm:tsx@^4.21.0/esm/api" };
+var imports = {
+	"#src/": "./src/",
+	"tsx/esm/api": "npm:tsx@^4.21.0/esm/api"
+};
 var exclude = ["dist/", "tsdown.config.ts"];
 var tasks = {
 	"build": "pnpm build",
 	"test": "deno test",
 	"test:node": {
 		"dependencies": ["build"],
-		"command": "node --experimental-transform-types --test"
+		"command": "node --test"
 	},
 	"test:bun": {
 		"dependencies": ["build"],

package/dist/generator-I9cXlw1Z.d.cts

@@ -0,0 +1,161 @@
+import { ManPageOptions } from "./man-C3FUTPuQ.cjs";
+import { Mode, ModeValue, Parser } from "@optique/core/parser";
+import { Program } from "@optique/core/program";
+
+//#region src/generator.d.ts
+
+/**
+ * Options for generating a man page from a parser.
+ * Extends {@link ManPageOptions} with the same configuration.
+ * @since 0.10.0
+ */
+interface GenerateManPageOptions extends ManPageOptions {}
+/**
+ * Options for generating a man page from a {@link Program}.
+ *
+ * For Program inputs, `name`, `version`, `author`, `bugs`, `examples`,
+ * `brief`, `description`, and `footer` default to values from
+ * `program.metadata`.
+ * These fields are optional here and may be provided to override metadata.
+ *
+ * @since 0.10.0
+ */
+interface GenerateManPageProgramOptions extends Partial<Omit<ManPageOptions, "section">>, Pick<ManPageOptions, "section"> {}
+/**
+ * Generates a man page from a parser synchronously.
+ *
+ * This function extracts documentation from the parser's structure
+ * and formats it as a complete man page in roff format.
+ *
+ * @example
+ * ```typescript
+ * import { generateManPageSync } from "@optique/man";
+ * import { object, option, flag } from "@optique/core/primitives";
+ * import { string } from "@optique/core/valueparser";
+ *
+ * const parser = object({
+ *   verbose: flag("-v", "--verbose"),
+ *   config: option("-c", "--config", string()),
+ * });
+ *
+ * const manPage = generateManPageSync(parser, {
+ *   name: "myapp",
+ *   section: 1,
+ *   version: "1.0.0",
+ * });
+ *
+ * console.log(manPage);
+ * ```
+ *
+ * @param parserOrProgram The parser or program to generate documentation from.
+ * @param options The man page generation options.
+ * @returns The complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
+ * @since 0.10.0
+ */
+declare function generateManPageSync<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
+declare function generateManPageSync(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
+/**
+ * Generates a man page from a parser asynchronously.
+ *
+ * This function extracts documentation from the parser's structure
+ * and formats it as a complete man page in roff format. It supports
+ * both sync and async parsers.
+ *
+ * @example
+ * ```typescript
+ * import { generateManPageAsync } from "@optique/man";
+ * import { object, option } from "@optique/core/primitives";
+ * import { string } from "@optique/core/valueparser";
+ *
+ * const parser = object({
+ *   config: option("-c", "--config", string()),
+ * });
+ *
+ * const manPage = await generateManPageAsync(parser, {
+ *   name: "myapp",
+ *   section: 1,
+ * });
+ * ```
+ *
+ * @param parserOrProgram The parser or program to generate documentation from.
+ * @param options The man page generation options.
+ * @returns A promise that resolves to the complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
+ * @since 0.10.0
+ */
+declare function generateManPageAsync<M extends Mode, T>(program: Program<M, T>, options: GenerateManPageProgramOptions): Promise<string>;
+declare function generateManPageAsync<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
+/**
+ * Generates a man page from a parser or program.
+ *
+ * This function extracts documentation from the parser's structure
+ * and formats it as a complete man page in roff format.
+ *
+ * For sync parsers, it returns the man page directly.
+ * For async parsers, it returns a Promise that resolves to the man page.
+ *
+ * @example Parser-based API
+ * ```typescript
+ * import { generateManPage } from "@optique/man";
+ * import { object, option, flag } from "@optique/core/primitives";
+ * import { string, integer } from "@optique/core/valueparser";
+ * import { message } from "@optique/core/message";
+ *
+ * const parser = object({
+ *   verbose: flag("-v", "--verbose", {
+ *     description: message`Enable verbose output.`,
+ *   }),
+ *   port: option("-p", "--port", integer(), {
+ *     description: message`Port to listen on.`,
+ *   }),
+ * });
+ *
+ * const manPage = generateManPage(parser, {
+ *   name: "myapp",
+ *   section: 1,
+ *   version: "1.0.0",
+ *   date: new Date(),
+ *   author: message`Hong Minhee`,
+ * });
+ *
+ * // Write to file
+ * import { writeFileSync } from "node:fs";
+ * writeFileSync("myapp.1", manPage);
+ * ```
+ *
+ * @example Program-based API
+ * ```typescript
+ * import { generateManPage } from "@optique/man";
+ * import { defineProgram } from "@optique/core/program";
+ * import { object, flag } from "@optique/core/primitives";
+ * import { message } from "@optique/core/message";
+ *
+ * const prog = defineProgram({
+ *   parser: object({
+ *     verbose: flag("-v", "--verbose"),
+ *   }),
+ *   metadata: {
+ *     name: "myapp",
+ *     version: "1.0.0",
+ *     author: message`Hong Minhee`,
+ *   },
+ * });
+ *
+ * // Metadata is automatically extracted from the program
+ * const manPage = generateManPage(prog, { section: 1 });
+ * ```
+ *
+ * @param parserOrProgram The parser or program to generate documentation from.
+ * @param options The man page generation options.
+ * @returns The complete man page in roff format, or a Promise for async parsers.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
+ * @since 0.10.0
+ */
+declare function generateManPage<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
+declare function generateManPage<T>(program: Program<"async", T>, options: GenerateManPageProgramOptions): Promise<string>;
+declare function generateManPage(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
+declare function generateManPage(parser: Parser<"async", unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
+declare function generateManPage<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): ModeValue<M, string>;
+//#endregion
+export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator-MbR1I1SH.d.ts

@@ -0,0 +1,161 @@
+import { ManPageOptions } from "./man-CHYiSoI_.js";
+import { Program } from "@optique/core/program";
+import { Mode, ModeValue, Parser } from "@optique/core/parser";
+
+//#region src/generator.d.ts
+
+/**
+ * Options for generating a man page from a parser.
+ * Extends {@link ManPageOptions} with the same configuration.
+ * @since 0.10.0
+ */
+interface GenerateManPageOptions extends ManPageOptions {}
+/**
+ * Options for generating a man page from a {@link Program}.
+ *
+ * For Program inputs, `name`, `version`, `author`, `bugs`, `examples`,
+ * `brief`, `description`, and `footer` default to values from
+ * `program.metadata`.
+ * These fields are optional here and may be provided to override metadata.
+ *
+ * @since 0.10.0
+ */
+interface GenerateManPageProgramOptions extends Partial<Omit<ManPageOptions, "section">>, Pick<ManPageOptions, "section"> {}
+/**
+ * Generates a man page from a parser synchronously.
+ *
+ * This function extracts documentation from the parser's structure
+ * and formats it as a complete man page in roff format.
+ *
+ * @example
+ * ```typescript
+ * import { generateManPageSync } from "@optique/man";
+ * import { object, option, flag } from "@optique/core/primitives";
+ * import { string } from "@optique/core/valueparser";
+ *
+ * const parser = object({
+ *   verbose: flag("-v", "--verbose"),
+ *   config: option("-c", "--config", string()),
+ * });
+ *
+ * const manPage = generateManPageSync(parser, {
+ *   name: "myapp",
+ *   section: 1,
+ *   version: "1.0.0",
+ * });
+ *
+ * console.log(manPage);
+ * ```
+ *
+ * @param parserOrProgram The parser or program to generate documentation from.
+ * @param options The man page generation options.
+ * @returns The complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
+ * @since 0.10.0
+ */
+declare function generateManPageSync<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
+declare function generateManPageSync(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
+/**
+ * Generates a man page from a parser asynchronously.
+ *
+ * This function extracts documentation from the parser's structure
+ * and formats it as a complete man page in roff format. It supports
+ * both sync and async parsers.
+ *
+ * @example
+ * ```typescript
+ * import { generateManPageAsync } from "@optique/man";
+ * import { object, option } from "@optique/core/primitives";
+ * import { string } from "@optique/core/valueparser";
+ *
+ * const parser = object({
+ *   config: option("-c", "--config", string()),
+ * });
+ *
+ * const manPage = await generateManPageAsync(parser, {
+ *   name: "myapp",
+ *   section: 1,
+ * });
+ * ```
+ *
+ * @param parserOrProgram The parser or program to generate documentation from.
+ * @param options The man page generation options.
+ * @returns A promise that resolves to the complete man page in roff format.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
+ * @since 0.10.0
+ */
+declare function generateManPageAsync<M extends Mode, T>(program: Program<M, T>, options: GenerateManPageProgramOptions): Promise<string>;
+declare function generateManPageAsync<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
+/**
+ * Generates a man page from a parser or program.
+ *
+ * This function extracts documentation from the parser's structure
+ * and formats it as a complete man page in roff format.
+ *
+ * For sync parsers, it returns the man page directly.
+ * For async parsers, it returns a Promise that resolves to the man page.
+ *
+ * @example Parser-based API
+ * ```typescript
+ * import { generateManPage } from "@optique/man";
+ * import { object, option, flag } from "@optique/core/primitives";
+ * import { string, integer } from "@optique/core/valueparser";
+ * import { message } from "@optique/core/message";
+ *
+ * const parser = object({
+ *   verbose: flag("-v", "--verbose", {
+ *     description: message`Enable verbose output.`,
+ *   }),
+ *   port: option("-p", "--port", integer(), {
+ *     description: message`Port to listen on.`,
+ *   }),
+ * });
+ *
+ * const manPage = generateManPage(parser, {
+ *   name: "myapp",
+ *   section: 1,
+ *   version: "1.0.0",
+ *   date: new Date(),
+ *   author: message`Hong Minhee`,
+ * });
+ *
+ * // Write to file
+ * import { writeFileSync } from "node:fs";
+ * writeFileSync("myapp.1", manPage);
+ * ```
+ *
+ * @example Program-based API
+ * ```typescript
+ * import { generateManPage } from "@optique/man";
+ * import { defineProgram } from "@optique/core/program";
+ * import { object, flag } from "@optique/core/primitives";
+ * import { message } from "@optique/core/message";
+ *
+ * const prog = defineProgram({
+ *   parser: object({
+ *     verbose: flag("-v", "--verbose"),
+ *   }),
+ *   metadata: {
+ *     name: "myapp",
+ *     version: "1.0.0",
+ *     author: message`Hong Minhee`,
+ *   },
+ * });
+ *
+ * // Metadata is automatically extracted from the program
+ * const manPage = generateManPage(prog, { section: 1 });
+ * ```
+ *
+ * @param parserOrProgram The parser or program to generate documentation from.
+ * @param options The man page generation options.
+ * @returns The complete man page in roff format, or a Promise for async parsers.
+ * @throws {TypeError} If the input is not a valid Parser or Program.
+ * @since 0.10.0
+ */
+declare function generateManPage<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
+declare function generateManPage<T>(program: Program<"async", T>, options: GenerateManPageProgramOptions): Promise<string>;
+declare function generateManPage(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
+declare function generateManPage(parser: Parser<"async", unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
+declare function generateManPage<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): ModeValue<M, string>;
+//#endregion
+export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator.cjs

@@ -0,0 +1,7 @@
+require('./man-C44Q4VSc.cjs');
+require('./roff-C8MvQ2tL.cjs');
+const require_generator = require('./generator-CtkCu_MS.cjs');
+
+exports.generateManPage = require_generator.generateManPage;
+exports.generateManPageAsync = require_generator.generateManPageAsync;
+exports.generateManPageSync = require_generator.generateManPageSync;

package/dist/generator.d.cts

@@ -0,0 +1,3 @@
+import "./man-C3FUTPuQ.cjs";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-I9cXlw1Z.cjs";
+export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator.d.ts

@@ -0,0 +1,3 @@
+import "./man-CHYiSoI_.js";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-MbR1I1SH.js";
+export { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/generator.js

@@ -0,0 +1,5 @@
+import "./roff-Bh9bsH6u.js";
+import "./man-Cq0qfXg0.js";
+import { generateManPage, generateManPageAsync, generateManPageSync } from "./generator-DywTJCMH.js";
+
+export { generateManPage, generateManPageAsync, generateManPageSync };

package/dist/index.d.cts

@@ -1,162 +1,4 @@
-import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-Cc-M-Skg.cjs";
-import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-D0niZIHu.cjs";
-import { Mode, ModeValue, Parser } from "@optique/core/parser";
-import { Program } from "@optique/core/program";
-
-//#region src/generator.d.ts
-
-/**
- * Options for generating a man page from a parser.
- * Extends {@link ManPageOptions} with the same configuration.
- * @since 0.10.0
- */
-interface GenerateManPageOptions extends ManPageOptions {}
-/**
- * Options for generating a man page from a {@link Program}.
- *
- * For Program inputs, `name`, `version`, `author`, `bugs`, `examples`,
- * `brief`, `description`, and `footer` default to values from
- * `program.metadata`.
- * These fields are optional here and may be provided to override metadata.
- *
- * @since 0.10.0
- */
-interface GenerateManPageProgramOptions extends Partial<Omit<ManPageOptions, "section">>, Pick<ManPageOptions, "section"> {}
-/**
- * Generates a man page from a parser synchronously.
- *
- * This function extracts documentation from the parser's structure
- * and formats it as a complete man page in roff format.
- *
- * @example
- * ```typescript
- * import { generateManPageSync } from "@optique/man";
- * import { object, option, flag } from "@optique/core/primitives";
- * import { string } from "@optique/core/valueparser";
- *
- * const parser = object({
- *   verbose: flag("-v", "--verbose"),
- *   config: option("-c", "--config", string()),
- * });
- *
- * const manPage = generateManPageSync(parser, {
- *   name: "myapp",
- *   section: 1,
- *   version: "1.0.0",
- * });
- *
- * console.log(manPage);
- * ```
- *
- * @param parserOrProgram The parser or program to generate documentation from.
- * @param options The man page generation options.
- * @returns The complete man page in roff format.
- * @throws {TypeError} If the input is not a valid Parser or Program.
- * @since 0.10.0
- */
-declare function generateManPageSync<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
-declare function generateManPageSync(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
-/**
- * Generates a man page from a parser asynchronously.
- *
- * This function extracts documentation from the parser's structure
- * and formats it as a complete man page in roff format. It supports
- * both sync and async parsers.
- *
- * @example
- * ```typescript
- * import { generateManPageAsync } from "@optique/man";
- * import { object, option } from "@optique/core/primitives";
- * import { string } from "@optique/core/valueparser";
- *
- * const parser = object({
- *   config: option("-c", "--config", string()),
- * });
- *
- * const manPage = await generateManPageAsync(parser, {
- *   name: "myapp",
- *   section: 1,
- * });
- * ```
- *
- * @param parserOrProgram The parser or program to generate documentation from.
- * @param options The man page generation options.
- * @returns A promise that resolves to the complete man page in roff format.
- * @throws {TypeError} If the input is not a valid Parser or Program.
- * @since 0.10.0
- */
-declare function generateManPageAsync<M extends Mode, T>(program: Program<M, T>, options: GenerateManPageProgramOptions): Promise<string>;
-declare function generateManPageAsync<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
-/**
- * Generates a man page from a parser or program.
- *
- * This function extracts documentation from the parser's structure
- * and formats it as a complete man page in roff format.
- *
- * For sync parsers, it returns the man page directly.
- * For async parsers, it returns a Promise that resolves to the man page.
- *
- * @example Parser-based API
- * ```typescript
- * import { generateManPage } from "@optique/man";
- * import { object, option, flag } from "@optique/core/primitives";
- * import { string, integer } from "@optique/core/valueparser";
- * import { message } from "@optique/core/message";
- *
- * const parser = object({
- *   verbose: flag("-v", "--verbose", {
- *     description: message`Enable verbose output.`,
- *   }),
- *   port: option("-p", "--port", integer(), {
- *     description: message`Port to listen on.`,
- *   }),
- * });
- *
- * const manPage = generateManPage(parser, {
- *   name: "myapp",
- *   section: 1,
- *   version: "1.0.0",
- *   date: new Date(),
- *   author: message`Hong Minhee`,
- * });
- *
- * // Write to file
- * import { writeFileSync } from "node:fs";
- * writeFileSync("myapp.1", manPage);
- * ```
- *
- * @example Program-based API
- * ```typescript
- * import { generateManPage } from "@optique/man";
- * import { defineProgram } from "@optique/core/program";
- * import { object, flag } from "@optique/core/primitives";
- * import { message } from "@optique/core/message";
- *
- * const prog = defineProgram({
- *   parser: object({
- *     verbose: flag("-v", "--verbose"),
- *   }),
- *   metadata: {
- *     name: "myapp",
- *     version: "1.0.0",
- *     author: message`Hong Minhee`,
- *   },
- * });
- *
- * // Metadata is automatically extracted from the program
- * const manPage = generateManPage(prog, { section: 1 });
- * ```
- *
- * @param parserOrProgram The parser or program to generate documentation from.
- * @param options The man page generation options.
- * @returns The complete man page in roff format, or a Promise for async parsers.
- * @throws {TypeError} If the input is not a valid Parser or Program.
- * @since 0.10.0
- */
-declare function generateManPage<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
-declare function generateManPage<T>(program: Program<"async", T>, options: GenerateManPageProgramOptions): Promise<string>;
-declare function generateManPage(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
-declare function generateManPage(parser: Parser<"async", unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
-declare function generateManPage<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): ModeValue<M, string>;
-//#endregion
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-C3FUTPuQ.cjs";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-I9cXlw1Z.cjs";
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-Cpm_FJok.cjs";
 export { type GenerateManPageOptions, type GenerateManPageProgramOptions, type ManPageOptions, type RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/index.d.ts

@@ -1,162 +1,4 @@
-import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-BbJgRI8t.js";
-import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-C4QCIEKf.js";
-import { Program } from "@optique/core/program";
-import { Mode, ModeValue, Parser } from "@optique/core/parser";
-
-//#region src/generator.d.ts
-
-/**
- * Options for generating a man page from a parser.
- * Extends {@link ManPageOptions} with the same configuration.
- * @since 0.10.0
- */
-interface GenerateManPageOptions extends ManPageOptions {}
-/**
- * Options for generating a man page from a {@link Program}.
- *
- * For Program inputs, `name`, `version`, `author`, `bugs`, `examples`,
- * `brief`, `description`, and `footer` default to values from
- * `program.metadata`.
- * These fields are optional here and may be provided to override metadata.
- *
- * @since 0.10.0
- */
-interface GenerateManPageProgramOptions extends Partial<Omit<ManPageOptions, "section">>, Pick<ManPageOptions, "section"> {}
-/**
- * Generates a man page from a parser synchronously.
- *
- * This function extracts documentation from the parser's structure
- * and formats it as a complete man page in roff format.
- *
- * @example
- * ```typescript
- * import { generateManPageSync } from "@optique/man";
- * import { object, option, flag } from "@optique/core/primitives";
- * import { string } from "@optique/core/valueparser";
- *
- * const parser = object({
- *   verbose: flag("-v", "--verbose"),
- *   config: option("-c", "--config", string()),
- * });
- *
- * const manPage = generateManPageSync(parser, {
- *   name: "myapp",
- *   section: 1,
- *   version: "1.0.0",
- * });
- *
- * console.log(manPage);
- * ```
- *
- * @param parserOrProgram The parser or program to generate documentation from.
- * @param options The man page generation options.
- * @returns The complete man page in roff format.
- * @throws {TypeError} If the input is not a valid Parser or Program.
- * @since 0.10.0
- */
-declare function generateManPageSync<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
-declare function generateManPageSync(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
-/**
- * Generates a man page from a parser asynchronously.
- *
- * This function extracts documentation from the parser's structure
- * and formats it as a complete man page in roff format. It supports
- * both sync and async parsers.
- *
- * @example
- * ```typescript
- * import { generateManPageAsync } from "@optique/man";
- * import { object, option } from "@optique/core/primitives";
- * import { string } from "@optique/core/valueparser";
- *
- * const parser = object({
- *   config: option("-c", "--config", string()),
- * });
- *
- * const manPage = await generateManPageAsync(parser, {
- *   name: "myapp",
- *   section: 1,
- * });
- * ```
- *
- * @param parserOrProgram The parser or program to generate documentation from.
- * @param options The man page generation options.
- * @returns A promise that resolves to the complete man page in roff format.
- * @throws {TypeError} If the input is not a valid Parser or Program.
- * @since 0.10.0
- */
-declare function generateManPageAsync<M extends Mode, T>(program: Program<M, T>, options: GenerateManPageProgramOptions): Promise<string>;
-declare function generateManPageAsync<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
-/**
- * Generates a man page from a parser or program.
- *
- * This function extracts documentation from the parser's structure
- * and formats it as a complete man page in roff format.
- *
- * For sync parsers, it returns the man page directly.
- * For async parsers, it returns a Promise that resolves to the man page.
- *
- * @example Parser-based API
- * ```typescript
- * import { generateManPage } from "@optique/man";
- * import { object, option, flag } from "@optique/core/primitives";
- * import { string, integer } from "@optique/core/valueparser";
- * import { message } from "@optique/core/message";
- *
- * const parser = object({
- *   verbose: flag("-v", "--verbose", {
- *     description: message`Enable verbose output.`,
- *   }),
- *   port: option("-p", "--port", integer(), {
- *     description: message`Port to listen on.`,
- *   }),
- * });
- *
- * const manPage = generateManPage(parser, {
- *   name: "myapp",
- *   section: 1,
- *   version: "1.0.0",
- *   date: new Date(),
- *   author: message`Hong Minhee`,
- * });
- *
- * // Write to file
- * import { writeFileSync } from "node:fs";
- * writeFileSync("myapp.1", manPage);
- * ```
- *
- * @example Program-based API
- * ```typescript
- * import { generateManPage } from "@optique/man";
- * import { defineProgram } from "@optique/core/program";
- * import { object, flag } from "@optique/core/primitives";
- * import { message } from "@optique/core/message";
- *
- * const prog = defineProgram({
- *   parser: object({
- *     verbose: flag("-v", "--verbose"),
- *   }),
- *   metadata: {
- *     name: "myapp",
- *     version: "1.0.0",
- *     author: message`Hong Minhee`,
- *   },
- * });
- *
- * // Metadata is automatically extracted from the program
- * const manPage = generateManPage(prog, { section: 1 });
- * ```
- *
- * @param parserOrProgram The parser or program to generate documentation from.
- * @param options The man page generation options.
- * @returns The complete man page in roff format, or a Promise for async parsers.
- * @throws {TypeError} If the input is not a valid Parser or Program.
- * @since 0.10.0
- */
-declare function generateManPage<T>(program: Program<"sync", T>, options: GenerateManPageProgramOptions): string;
-declare function generateManPage<T>(program: Program<"async", T>, options: GenerateManPageProgramOptions): Promise<string>;
-declare function generateManPage(parser: Parser<"sync", unknown, unknown>, options: GenerateManPageOptions): string;
-declare function generateManPage(parser: Parser<"async", unknown, unknown>, options: GenerateManPageOptions): Promise<string>;
-declare function generateManPage<M extends Mode>(parser: Parser<M, unknown, unknown>, options: GenerateManPageOptions): ModeValue<M, string>;
-//#endregion
+import { ManPageOptions, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CHYiSoI_.js";
+import { GenerateManPageOptions, GenerateManPageProgramOptions, generateManPage, generateManPageAsync, generateManPageSync } from "./generator-MbR1I1SH.js";
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-DkJvVQ1o.js";
 export { type GenerateManPageOptions, type GenerateManPageProgramOptions, type ManPageOptions, type RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatDateForMan, formatDocPageAsMan, formatMessageAsRoff, formatUsageTermAsRoff, generateManPage, generateManPageAsync, generateManPageSync };

package/dist/{man-D0niZIHu.d.cts → man-C3FUTPuQ.d.cts}

@@ -1,5 +1,5 @@
-import { Message } from "@optique/core/message";
 import { DocPage, DocSection } from "@optique/core/doc";
+import { Message } from "@optique/core/message";
 import { UsageTerm } from "@optique/core/usage";
 
 //#region src/man.d.ts

package/dist/man.d.cts

@@ -1,2 +1,2 @@
-import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-D0niZIHu.cjs";
+import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-C3FUTPuQ.cjs";
 export { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/dist/man.d.ts

@@ -1,2 +1,2 @@
-import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-C4QCIEKf.js";
+import { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff } from "./man-CHYiSoI_.js";
 export { ManPageOptions, ManPageSection, formatDateForMan, formatDocPageAsMan, formatUsageTermAsRoff };

package/dist/roff.d.cts

@@ -1,2 +1,2 @@
-import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-Cc-M-Skg.cjs";
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-Cpm_FJok.cjs";
 export { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };

package/dist/roff.d.ts

@@ -1,2 +1,2 @@
-import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-BbJgRI8t.js";
+import { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff } from "./roff-DkJvVQ1o.js";
 export { RoffFormatOptions, escapeHyphens, escapeQuotedValue, escapeRequestArg, escapeRoff, formatMessageAsRoff };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/man",
-  "version": "1.1.0-dev.2096",
+  "version": "1.1.0-dev.2148",
   "description": "Man page generator for Optique CLI parsers",
   "keywords": [
     "CLI",
@@ -79,13 +79,19 @@
       "require": "./dist/cli.cjs"
     }
   },
+  "imports": {
+    "#src/*.ts": {
+      "node": "./dist/*.js",
+      "default": "./src/*.ts"
+    }
+  },
   "sideEffects": false,
   "bin": {
     "optique-man": "./dist/cli.js"
   },
   "dependencies": {
-    "@optique/run": "1.1.0-dev.2096+8eda4929",
-    "@optique/core": "1.1.0-dev.2096+8eda4929"
+    "@optique/core": "1.1.0-dev.2148+ab56ac96",
+    "@optique/run": "1.1.0-dev.2148+ab56ac96"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -96,9 +102,9 @@
   "scripts": {
     "build": "tsdown",
     "prepublish": "tsdown",
-    "test": "node --experimental-transform-types --test 'src/**/*.test.ts'",
+    "test": "node --test 'src/**/*.test.ts'",
     "test:bun": "bun test src/",
     "test:deno": "deno test",
-    "test-all": "tsdown && node --experimental-transform-types --test 'src/**/*.test.ts' && bun test src/ && deno test"
+    "test-all": "tsdown && node --test 'src/**/*.test.ts' && bun test src/ && deno test"
   }
 }