politty 0.1.1 → 0.2.0

package/dist/docs/index.d.cts

@@ -1,8 +1,8 @@
-import { n as ResolvedFieldMeta, p as Example, s as AnyCommand, t as ExtractedFields } from "../schema-extractor-D-Eo7I77.cjs";
+import { n as ResolvedFieldMeta, p as Example, s as AnyCommand, t as ExtractedFields } from "../schema-extractor-CXeUTW_Z.cjs";
+import { z } from "zod";
 import * as fs from "node:fs";
 
 //#region src/executor/subcommand-router.d.ts
-
 /**
  * Resolve a lazy-loaded command (sync or async)
  *
@@ -178,6 +178,8 @@ interface ExamplesRenderOptions {
   withHeading?: boolean;
   /** Show execution output (default: true when results available) */
   showOutput?: boolean;
+  /** Command prefix to prepend to example commands (e.g., "my-cli config get") */
+  commandPrefix?: string;
 }
 /**
  * Examples render context
@@ -293,11 +295,8 @@ interface GenerateDocResult {
   success: boolean;
   /** File processing results */
   files: Array<{
-    /** File path */
-    path: string;
-    /** Status of this file */
-    status: "match" | "created" | "updated" | "diff";
-    /** Diff content (only when status is "diff") */
+    /** File path */path: string; /** Status of this file */
+    status: "match" | "created" | "updated" | "diff"; /** Diff content (only when status is "diff") */
     diff?: string | undefined;
   }>;
   /** Error message (when success is false) */
@@ -414,11 +413,8 @@ declare function createCommandRenderer(options?: DefaultRendererOptions): Render
  * Default renderers presets
  */
 declare const defaultRenderers: {
-  /** Standard command documentation */
-  command: (options?: DefaultRendererOptions) => RenderFunction;
-  /** Table style options (default) */
-  tableStyle: RenderFunction;
-  /** List style options */
+  /** Standard command documentation */command: (options?: DefaultRendererOptions) => RenderFunction; /** Table style options (default) */
+  tableStyle: RenderFunction; /** List style options */
   listStyle: RenderFunction;
 };
 //#endregion
@@ -496,5 +492,91 @@ declare function assertDocMatch(config: GenerateDocConfig): Promise<void>;
  */
 declare function initDocFile(config: Pick<GenerateDocConfig, "files"> | string, fileSystem?: DeleteFileFs): void;
 //#endregion
-export { type ArgumentsRenderContext, type ArgumentsRenderFunction, COMMAND_MARKER_PREFIX, type CommandInfo, type DefaultRendererOptions, type DeleteFileFs, type ExampleCommandConfig, type ExampleConfig, type ExampleExecutionResult, type ExamplesRenderContext, type ExamplesRenderFunction, type ExamplesRenderOptions, type FileConfig, type FileMapping, type FormatterFunction, type GenerateDocConfig, type GenerateDocResult, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type SectionRenderFunction, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, commandEndMarker, commandStartMarker, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, initDocFile, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, writeFile };
+//#region src/docs/render-args.d.ts
+/**
+ * Args shape type (Record of string keys to Zod schemas)
+ * This matches the typical structure of `commonArgs`, `workspaceArgs`, etc.
+ */
+type ArgsShape = Record<string, z.ZodType>;
+/**
+ * Options for rendering args table
+ */
+type ArgsTableOptions = {
+  /** Columns to include in the table (default: all columns) */columns?: ("option" | "alias" | "description" | "default" | "env")[];
+};
+/**
+ * Render args definition as a markdown options table
+ *
+ * This function takes raw args definitions (like `commonArgs`) and
+ * renders them as a markdown table suitable for documentation.
+ *
+ * @example
+ * import { renderArgsTable } from "politty/docs";
+ * import { commonArgs, workspaceArgs } from "./args";
+ *
+ * const table = renderArgsTable({
+ *   ...commonArgs,
+ *   ...workspaceArgs,
+ * });
+ * // | Option | Alias | Description | Default |
+ * // |--------|-------|-------------|---------|
+ * // | `--env-file <ENV_FILE>` | `-e` | Path to environment file | - |
+ * // ...
+ *
+ * @param args - Args shape (Record of string keys to Zod schemas with arg() metadata)
+ * @param options - Rendering options
+ * @returns Rendered markdown table string
+ */
+declare function renderArgsTable(args: ArgsShape, options?: ArgsTableOptions): string;
+//#endregion
+//#region src/docs/render-index.d.ts
+/**
+ * Configuration for a command category
+ */
+type CommandCategory = {
+  /** Category title (e.g., "Application Commands") */title: string; /** Category description */
+  description: string; /** Command paths to include (parent commands will auto-expand to leaf commands) */
+  commands: string[]; /** Path to documentation file for links (e.g., "./cli/application.md") */
+  docPath: string;
+};
+/**
+ * Options for rendering command index
+ */
+type CommandIndexOptions = {
+  /** Base heading level (default: 3, which renders as ###) */headingLevel?: 1 | 2 | 3 | 4 | 5 | 6; /** Only include leaf commands (commands without subcommands). Default: true */
+  leafOnly?: boolean;
+};
+/**
+ * Render command index from categories
+ *
+ * Generates a category-based index of commands with links to documentation.
+ *
+ * @example
+ * const categories: CommandCategory[] = [
+ *   {
+ *     title: "Application Commands",
+ *     description: "Commands for managing applications.",
+ *     commands: ["init", "generate", "apply"],
+ *     docPath: "./cli/application.md",
+ *   },
+ * ];
+ *
+ * const index = await renderCommandIndex(mainCommand, categories);
+ * // ### [Application Commands](./cli/application.md)
+ * //
+ * // Commands for managing applications.
+ * //
+ * // | Command | Description |
+ * // |---------|-------------|
+ * // | [init](./cli/application.md#init) | Initialize a project |
+ * // ...
+ *
+ * @param command - Root command to extract command information from
+ * @param categories - Category definitions for grouping commands
+ * @param options - Rendering options
+ * @returns Rendered markdown string
+ */
+declare function renderCommandIndex(command: AnyCommand, categories: CommandCategory[], options?: CommandIndexOptions): Promise<string>;
+//#endregion
+export { type ArgsShape, type ArgsTableOptions, type ArgumentsRenderContext, type ArgumentsRenderFunction, COMMAND_MARKER_PREFIX, type CommandCategory, type CommandIndexOptions, type CommandInfo, type DefaultRendererOptions, type DeleteFileFs, type ExampleCommandConfig, type ExampleConfig, type ExampleExecutionResult, type ExamplesRenderContext, type ExamplesRenderFunction, type ExamplesRenderOptions, type FileConfig, type FileMapping, type FormatterFunction, type GenerateDocConfig, type GenerateDocResult, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type SectionRenderFunction, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, commandEndMarker, commandStartMarker, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, writeFile };
 //# sourceMappingURL=index.d.cts.map

package/dist/docs/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-args.ts","../../src/docs/render-index.ts"],"mappings":"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"}

package/dist/docs/index.d.ts

@@ -1,8 +1,8 @@
-import { n as ResolvedFieldMeta, p as Example, s as AnyCommand, t as ExtractedFields } from "../schema-extractor-kkajLb9E.js";
+import { n as ResolvedFieldMeta, p as Example, s as AnyCommand, t as ExtractedFields } from "../schema-extractor-Cl_D04BX.js";
+import { z } from "zod";
 import * as fs from "node:fs";
 
 //#region src/executor/subcommand-router.d.ts
-
 /**
  * Resolve a lazy-loaded command (sync or async)
  *
@@ -178,6 +178,8 @@ interface ExamplesRenderOptions {
   withHeading?: boolean;
   /** Show execution output (default: true when results available) */
   showOutput?: boolean;
+  /** Command prefix to prepend to example commands (e.g., "my-cli config get") */
+  commandPrefix?: string;
 }
 /**
  * Examples render context
@@ -293,11 +295,8 @@ interface GenerateDocResult {
   success: boolean;
   /** File processing results */
   files: Array<{
-    /** File path */
-    path: string;
-    /** Status of this file */
-    status: "match" | "created" | "updated" | "diff";
-    /** Diff content (only when status is "diff") */
+    /** File path */path: string; /** Status of this file */
+    status: "match" | "created" | "updated" | "diff"; /** Diff content (only when status is "diff") */
     diff?: string | undefined;
   }>;
   /** Error message (when success is false) */
@@ -414,11 +413,8 @@ declare function createCommandRenderer(options?: DefaultRendererOptions): Render
  * Default renderers presets
  */
 declare const defaultRenderers: {
-  /** Standard command documentation */
-  command: (options?: DefaultRendererOptions) => RenderFunction;
-  /** Table style options (default) */
-  tableStyle: RenderFunction;
-  /** List style options */
+  /** Standard command documentation */command: (options?: DefaultRendererOptions) => RenderFunction; /** Table style options (default) */
+  tableStyle: RenderFunction; /** List style options */
   listStyle: RenderFunction;
 };
 //#endregion
@@ -496,5 +492,91 @@ declare function assertDocMatch(config: GenerateDocConfig): Promise<void>;
  */
 declare function initDocFile(config: Pick<GenerateDocConfig, "files"> | string, fileSystem?: DeleteFileFs): void;
 //#endregion
-export { type ArgumentsRenderContext, type ArgumentsRenderFunction, COMMAND_MARKER_PREFIX, type CommandInfo, type DefaultRendererOptions, type DeleteFileFs, type ExampleCommandConfig, type ExampleConfig, type ExampleExecutionResult, type ExamplesRenderContext, type ExamplesRenderFunction, type ExamplesRenderOptions, type FileConfig, type FileMapping, type FormatterFunction, type GenerateDocConfig, type GenerateDocResult, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type SectionRenderFunction, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, commandEndMarker, commandStartMarker, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, initDocFile, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, writeFile };
+//#region src/docs/render-args.d.ts
+/**
+ * Args shape type (Record of string keys to Zod schemas)
+ * This matches the typical structure of `commonArgs`, `workspaceArgs`, etc.
+ */
+type ArgsShape = Record<string, z.ZodType>;
+/**
+ * Options for rendering args table
+ */
+type ArgsTableOptions = {
+  /** Columns to include in the table (default: all columns) */columns?: ("option" | "alias" | "description" | "default" | "env")[];
+};
+/**
+ * Render args definition as a markdown options table
+ *
+ * This function takes raw args definitions (like `commonArgs`) and
+ * renders them as a markdown table suitable for documentation.
+ *
+ * @example
+ * import { renderArgsTable } from "politty/docs";
+ * import { commonArgs, workspaceArgs } from "./args";
+ *
+ * const table = renderArgsTable({
+ *   ...commonArgs,
+ *   ...workspaceArgs,
+ * });
+ * // | Option | Alias | Description | Default |
+ * // |--------|-------|-------------|---------|
+ * // | `--env-file <ENV_FILE>` | `-e` | Path to environment file | - |
+ * // ...
+ *
+ * @param args - Args shape (Record of string keys to Zod schemas with arg() metadata)
+ * @param options - Rendering options
+ * @returns Rendered markdown table string
+ */
+declare function renderArgsTable(args: ArgsShape, options?: ArgsTableOptions): string;
+//#endregion
+//#region src/docs/render-index.d.ts
+/**
+ * Configuration for a command category
+ */
+type CommandCategory = {
+  /** Category title (e.g., "Application Commands") */title: string; /** Category description */
+  description: string; /** Command paths to include (parent commands will auto-expand to leaf commands) */
+  commands: string[]; /** Path to documentation file for links (e.g., "./cli/application.md") */
+  docPath: string;
+};
+/**
+ * Options for rendering command index
+ */
+type CommandIndexOptions = {
+  /** Base heading level (default: 3, which renders as ###) */headingLevel?: 1 | 2 | 3 | 4 | 5 | 6; /** Only include leaf commands (commands without subcommands). Default: true */
+  leafOnly?: boolean;
+};
+/**
+ * Render command index from categories
+ *
+ * Generates a category-based index of commands with links to documentation.
+ *
+ * @example
+ * const categories: CommandCategory[] = [
+ *   {
+ *     title: "Application Commands",
+ *     description: "Commands for managing applications.",
+ *     commands: ["init", "generate", "apply"],
+ *     docPath: "./cli/application.md",
+ *   },
+ * ];
+ *
+ * const index = await renderCommandIndex(mainCommand, categories);
+ * // ### [Application Commands](./cli/application.md)
+ * //
+ * // Commands for managing applications.
+ * //
+ * // | Command | Description |
+ * // |---------|-------------|
+ * // | [init](./cli/application.md#init) | Initialize a project |
+ * // ...
+ *
+ * @param command - Root command to extract command information from
+ * @param categories - Category definitions for grouping commands
+ * @param options - Rendering options
+ * @returns Rendered markdown string
+ */
+declare function renderCommandIndex(command: AnyCommand, categories: CommandCategory[], options?: CommandIndexOptions): Promise<string>;
+//#endregion
+export { type ArgsShape, type ArgsTableOptions, type ArgumentsRenderContext, type ArgumentsRenderFunction, COMMAND_MARKER_PREFIX, type CommandCategory, type CommandIndexOptions, type CommandInfo, type DefaultRendererOptions, type DeleteFileFs, type ExampleCommandConfig, type ExampleConfig, type ExampleExecutionResult, type ExamplesRenderContext, type ExamplesRenderFunction, type ExamplesRenderOptions, type FileConfig, type FileMapping, type FormatterFunction, type GenerateDocConfig, type GenerateDocResult, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type SectionRenderFunction, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, commandEndMarker, commandStartMarker, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, writeFile };
 //# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-args.ts","../../src/docs/render-index.ts"],"mappings":"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"}