politty 0.4.4 → 0.4.6

package/dist/docs/index.d.cts

@@ -1,5 +1,4 @@
-import "../arg-registry-BNoIwnNr.cjs";
-import { E as SubCommandValue, n as ResolvedFieldMeta, p as Example, s as AnyCommand, t as ExtractedFields } from "../schema-extractor-DFaAZzaY.cjs";
+import { O as SubCommandValue, c as AnyCommand, l as ArgsSchema, m as Example, n as ResolvedFieldMeta, t as ExtractedFields } from "../schema-extractor-CVf0J4An.cjs";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -93,6 +92,10 @@ interface CommandInfo {
   examples?: Example[] | undefined;
   /** Example execution results (populated when examples are executed) */
   exampleResults?: ExampleExecutionResult[] | undefined;
+  /** Path to root document file (for global options link generation) */
+  rootDocPath?: string | undefined;
+  /** Whether global options exist (for global options link generation) */
+  hasGlobalOptions?: boolean;
 }
 /**
  * Subcommand information
@@ -305,6 +308,35 @@ interface RootDocConfig {
   /** Index section rendering options */
   index?: CommandIndexOptions;
 }
+/**
+ * Root command customization for the root document.
+ * Controls the root document's title, description, header, and footer.
+ */
+interface RootCommandInfo {
+  /** Title (defaults to command.name) */
+  title?: string;
+  /** Description (defaults to command.description) */
+  description?: string;
+  /** Markdown placed after title/description */
+  header?: string;
+  /** Markdown placed at end of document */
+  footer?: string;
+}
+/**
+ * Path configuration for documentation output.
+ * Simpler alternative to FileMapping for common patterns.
+ *
+ * @example
+ * // All commands in one file
+ * path: "docs/CLI.md"
+ *
+ * // Split files: root + specific commands in separate files
+ * path: { root: "docs/CLI.md", commands: { "build": "docs/build.md" } }
+ */
+type PathConfig = string | {
+  root: string;
+  commands?: Record<string, string>;
+};
 /**
  * Per-file configuration with custom renderer
  */
@@ -317,6 +349,8 @@ interface FileConfig {
   title?: string;
   /** File description (added after title) */
   description?: string;
+  /** Skip subcommand expansion (commands are used as-is). @internal */
+  noExpand?: boolean;
 }
 /**
  * File mapping configuration
@@ -343,8 +377,15 @@ interface GenerateDocConfig {
    * Title and description are derived from `command.name` and `command.description`.
    */
   rootDoc?: RootDocConfig;
+  /**
+   * Path configuration (simpler alternative to files).
+   * Mutually exclusive with `files`.
+   */
+  path?: PathConfig;
   /** File output configuration (command path -> file mapping) */
-  files: FileMapping;
+  files?: FileMapping;
+  /** Root command customization (title, description, header, footer) */
+  rootInfo?: RootCommandInfo;
   /** Command paths to ignore (including their subcommands) */
   ignores?: string[];
   /** Default renderer options (used when render is not specified per file) */
@@ -359,6 +400,11 @@ interface GenerateDocConfig {
    * The full document structure is used to maintain cross-file links.
    */
   targetCommands?: string[];
+  /**
+   * Global args schema (runtime schema alternative).
+   * When provided, automatically derives `rootDoc.globalOptions` from this schema.
+   */
+  globalArgs?: ArgsSchema;
 }
 /**
  * generateDoc result
@@ -418,6 +464,18 @@ declare function globalOptionsStartMarker(): string;
  * Generate end marker for a global options section
  */
 declare function globalOptionsEndMarker(): string;
+/**
+ * Marker prefix for root header sections in generated documentation
+ */
+declare const ROOT_HEADER_MARKER_PREFIX = "politty:root-header";
+declare function rootHeaderStartMarker(): string;
+declare function rootHeaderEndMarker(): string;
+/**
+ * Marker prefix for root footer sections in generated documentation
+ */
+declare const ROOT_FOOTER_MARKER_PREFIX = "politty:root-footer";
+declare function rootFooterStartMarker(): string;
+declare function rootFooterEndMarker(): string;
 /**
  * Marker prefix for index sections in generated documentation
  * Format: <!-- politty:index:<scope>:start --> ... <!-- politty:index:<scope>:end -->
@@ -512,9 +570,6 @@ declare function renderSubcommandsTableFromArray(subcommands: SubCommandInfo[],
  * ```
  */
 declare function renderExamplesDefault(examples: Example[], results?: ExampleExecutionResult[], opts?: ExamplesRenderOptions): string;
-/**
- * Create command renderer with options
- */
 declare function createCommandRenderer(options?: DefaultRendererOptions): RenderFunction;
 /**
  * Default renderers presets
@@ -641,5 +696,5 @@ type CommandCategory = {
  */
 declare function renderCommandIndex(command: AnyCommand, categories: CommandCategory[], options?: CommandIndexOptions): Promise<string>;
 //#endregion
-export { type ArgsShape, type ArgsTableOptions, type ArgumentsRenderContext, type ArgumentsRenderFunction, 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, GLOBAL_OPTIONS_MARKER_PREFIX, type GenerateDocConfig, type GenerateDocResult, type HeadingLevel, INDEX_MARKER_PREFIX, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type RootDocConfig, SECTION_MARKER_PREFIX, SECTION_TYPES, type SectionRenderFunction, type SectionType, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, globalOptionsEndMarker, globalOptionsStartMarker, indexEndMarker, indexStartMarker, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, sectionEndMarker, sectionStartMarker, writeFile };
+export { type ArgsShape, type ArgsTableOptions, type ArgumentsRenderContext, type ArgumentsRenderFunction, 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, GLOBAL_OPTIONS_MARKER_PREFIX, type GenerateDocConfig, type GenerateDocResult, type HeadingLevel, INDEX_MARKER_PREFIX, type OptionsRenderContext, type OptionsRenderFunction, type PathConfig, ROOT_FOOTER_MARKER_PREFIX, ROOT_HEADER_MARKER_PREFIX, type RenderContentOptions, type RenderFunction, type RootCommandInfo, type RootDocConfig, SECTION_MARKER_PREFIX, SECTION_TYPES, type SectionRenderFunction, type SectionType, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, globalOptionsEndMarker, globalOptionsStartMarker, indexEndMarker, indexStartMarker, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, rootFooterEndMarker, rootFooterStartMarker, rootHeaderEndMarker, rootHeaderStartMarker, sectionEndMarker, sectionStartMarker, 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/render-args.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-index.ts"],"mappings":";;;;;;;;;;;AASA;iBAAsB,kBAAA,CAAmB,GAAA,EAAK,eAAA,GAAkB,OAAA,CAAQ,UAAA;;;;;;;KCD5D,SAAA,GAAY,MAAA,SAAe,CAAA,CAAE,OAAA;ADCzC;;;AAAA,KCIY,gBAAA;EDJ4D,6DCMtE,OAAA;AAAA;;;;;;;;;;;AAPF;;;;;;;;;AAKA;;;;iBAyCgB,eAAA,CAAgB,IAAA,EAAM,SAAA,EAAW,OAAA,GAAU,gBAAA;;;;KCjD/C,YAAA;;AFIZ;;KECY,mBAAA;EFDkC,4DEG5C,YAAA,GAAe,YAAA,EFH+C;EEK9D,QAAA;AAAA;;;;UAMe,WAAA;EFXiE;EEahF,IAAA;;EAEA,WAAA;;EAEA,eAAA;EDlBmB;ECoBnB,WAAA;EDpB4B;ECsB5B,KAAA;EDtBqC;ECwBrC,cAAA,EAAgB,iBAAA;EDxB8B;EC0B9C,OAAA,EAAS,iBAAA;EDrBC;ECuBV,WAAA,EAAa,cAAA;;EAEb,SAAA,EAAW,eAAA;EDvBJ;ECyBP,OAAA,EAAS,UAAA;EDcoB;ECZ7B,KAAA;EDYyE;ECVzE,QAAA;EDU8B;ECR9B,OAAA,GAAU,MAAA;EDQqC;ECN/C,QAAA,GAAW,OAAA;EDM8D;ECJzE,cAAA,GAAiB,sBAAA;AAAA;;AA7CnB;;UAmDiB,cAAA;EAnDO;EAqDtB,IAAA;EAhDU;EAkDV,WAAA;;EAEA,QAAA;AAAA;;;;UAMe,sBAAA;EAhDA;EAkDf,GAAA;;EAEA,IAAA;EAtCS;EAwCT,cAAA;EApCW;EAsCX,MAAA;EA9BU;EAgCV,MAAA;EA5BiB;EA8BjB,OAAA;AAAA;;;;;UAOe,oBAAA;EAvDf;EAyDA,IAAA,gBAAoB,OAAA;EAvDpB;EAyDA,OAAA,gBAAuB,OAAA;AAAA;;;;;;;;;;;;;KAeb,aAAA,GAAgB,MAAA,SAAe,oBAAA;;;AAlD3C;KAuDY,cAAA,IAAkB,IAAA,EAAM,WAAA;;;;;;;;KASxB,qBAAA,IAAyB,cAAA,UAAwB,IAAA,EAAM,WAAA;;;;UAKlD,oBAAA;EArDf;EAuDA,KAAA;EAnDA;EAqDA,WAAA;AAAA;;;AA1CF;UAgDiB,oBAAA;;EAEf,OAAA,EAAS,iBAAA;EAhDT;EAkDA,MAAA,GAAS,OAAA,EAAS,iBAAA,IAAqB,IAAA,GAAO,oBAAA;EAhD9C;EAkDA,OAAA;EAlD8B;EAoD9B,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,qBAAA,IAAyB,OAAA,EAAS,oBAAA;;;;UAK7B,sBAAA;EAvCS;EAyCxB,IAAA,EAAM,iBAAA;EAzC4B;EA2ClC,MAAA,GAAS,IAAA,EAAM,iBAAA,IAAqB,IAAA,GAAO,oBAAA;EAlCjC;EAoCV,OAAA;;EAEA,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,uBAAA,IAA2B,OAAA,EAAS,sBAAA;;;;UAK/B,wBAAA;EAxCoB;EA0CnC,eAAA;EAxCA;EA0CA,WAAA;AAAA;;;;UAMe,wBAAA;EApC+B;EAsC9C,WAAA,EAAa,cAAA;EAlCI;EAoCjB,MAAA,GAAS,WAAA,EAAa,cAAA,IAAkB,IAAA,GAAO,wBAAA;EA1C/C;EA4CA,OAAA;EA1CA;EA4CA,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,yBAAA,IAA6B,OAAA,EAAS,wBAAA;;;;UAKjC,qBAAA;EA/CE;EAiDjB,WAAA;EA/CU;EAiDV,UAAA;;EAEA,aAAA;AAAA;AA9CF;;;AAAA,UAoDiB,qBAAA;EAhDA;EAkDf,QAAA,EAAU,OAAA;EA9CJ;EAgDN,OAAA,GAAU,sBAAA;EAhDO;EAkDjB,MAAA,GACE,QAAA,EAAU,OAAA,IACV,OAAA,GAAU,sBAAA,IACV,IAAA,GAAO,qBAAA;EA3DH;EA8DN,OAAA;EA5De;EA8Df,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,sBAAA,IAA0B,OAAA,EAAS,qBAAA;;;;UAK9B,mBAAA;EAjEE;EAmEjB,OAAA;EAjEiC;EAmEjC,OAAA;EAnE8C;EAqE9C,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,oBAAA,IAAwB,OAAA,EAAS,mBAAA;;;;UAK5B,sBAAA;EA7DwB;EA+DvC,YAAA,GAAe,YAAA;EA7DF;EA+Db,WAAA;EA7D+C;EA+D/C,eAAA;EA3DiB;EA6DjB,wBAAA;EAnEA;EAqEA,iBAAA,GAAoB,oBAAA;EAnEpB;EAqEA,WAAA,GAAc,oBAAA;EArEL;EAuET,eAAA,GAAkB,uBAAA;EAvEsB;EAyExC,aAAA,GAAgB,qBAAA;EArEhB;EAuEA,iBAAA,GAAoB,yBAAA;EAvEH;EAyEjB,WAAA,GAAc,oBAAA;EAvEJ;EAyEV,YAAA,GAAe,oBAAA;;EAEf,cAAA,GAAiB,sBAAA;AAAA;AAtEnB;;;;AAAA,UA6EiB,aAAA;EAzEf;EA2EA,IAAA;EAzEa;;AAMf;;EAwEE,aAAA,GAAgB,SAAA;IAAc,IAAA,EAAM,SAAA;IAAW,OAAA,GAAU,gBAAA;EAAA;EAhE7C;EAkEZ,YAAA,GAAe,YAAA;EA5DT;EA8DN,KAAA,GAAQ,mBAAA;AAAA;;;;UAMO,UAAA;EA5Ef;EA8EA,QAAA;EA7EE;EA+EF,MAAA,GAAS,cAAA;EA9EP;EAgFF,KAAA;EA/EE;EAiFF,WAAA;AAAA;;;;AA1EF;;;;;AAKA;;;;KAoFY,WAAA,GAAc,MAAA,oBAA0B,UAAA;;;;UAKnC,iBAAA;EAnFE;EAqFjB,OAAA,EAAS,UAAA;EAnFqB;;;;AAKhC;EAoFE,OAAA,GAAU,aAAA;;EAEV,KAAA,EAAO,WAAA;EA5Ea;EA8EpB,OAAA;EA1EkB;EA4ElB,MAAA,GAAS,sBAAA;EAxEW;EA0EpB,SAAA,GAAY,iBAAA;EAtEG;EAwEf,QAAA,GAAW,aAAA;EAtE4B;;;;;EA4EvC,cAAA;AAAA;;;;UAMe,iBAAA;EA5Ff;EA8FA,OAAA;EA5FA;EA8FA,KAAA,EAAO,KAAA;IA5FP,gBA8FE,IAAA,UA5FF;IA8FE,MAAA,4CA5FF;IA8FE,IAAA;EAAA;EA5Fe;EA+FjB,KAAA;AAAA;AAxFF;;;;AAAA,KA+FY,iBAAA,IAAqB,OAAA,sBAA6B,OAAA;;;;cAKjD,iBAAA;;;;cAKA,aAAA;;;;KAcD,WAAA,WAAsB,aAAA;;;;;cAMrB,qBAAA;;AA5Gb;;iBAiHgB,kBAAA,CAAmB,IAAA,EAAM,WAAA,EAAa,KAAA;;;;iBAOtC,gBAAA,CAAiB,IAAA,EAAM,WAAA,EAAa,KAAA;;;;;cAQvC,4BAAA;;;;iBAKG,wBAAA,CAAA;AAzGhB;;;AAAA,iBAgHgB,sBAAA,CAAA;;;;;cAQH,mBAAA;;;;iBAKG,gBAAA,CAAiB,KAAA;;;;iBAOjB,cAAA,CAAe,KAAA;;;;;;iBCpZf,WAAA,CAAY,IAAA,EAAM,WAAA;;;;iBAyBlB,oBAAA,CAAqB,IAAA,EAAM,WAAA;;;;iBAqB3B,mBAAA,CAAoB,IAAA,EAAM,WAAA;;;;;;;;;AF9E1C;;;;;;iBE4JgB,kBAAA,CAAmB,IAAA,EAAM,WAAA;;;AFvJzC;;;;;AAyCA;;;;iBE8JgB,iBAAA,CAAkB,IAAA,EAAM,WAAA;;;;iBAqDxB,sBAAA,CAAuB,IAAA,EAAM,WAAA,EAAa,eAAA;;;;iBAwC1C,2BAAA,CAA4B,OAAA,EAAS,iBAAA;AD5SrD;;;AAAA,iBCoVgB,0BAAA,CAA2B,OAAA,EAAS,iBAAA;;AD/UpD;;iBCqWgB,6BAAA,CAA8B,IAAA,EAAM,iBAAA;;;;iBAqBpC,4BAAA,CAA6B,IAAA,EAAM,iBAAA;;;ADhXnD;iBCkYgB,+BAAA,CACd,WAAA,EAAa,cAAA,IACb,IAAA,EAAM,WAAA,EACN,eAAA;;;;;;;;;;;;;;;;iBAqDc,qBAAA,CACd,QAAA,EAAU,OAAA,IACV,OAAA,GAAU,sBAAA,IACV,IAAA,GAAO,qBAAA;;;;iBA8DO,qBAAA,CAAsB,OAAA,GAAS,sBAAA,GAA8B,cAAA;;;;cAsMhE,gBAAA;ED7qBX,yDC+qBoB,sBAAA,KAAsB,cAAA,ED7qB1C;8BAIA;;;;;;;;UExCe,aAAA;;EAEf,KAAA;EJCsC;EICtC,IAAA;EJD4C;EIG5C,UAAA;AAAA;;;;iBAMc,mBAAA,CAAoB,gBAAA,UAA0B,QAAA,WAAmB,aAAA;;;;iBA6BjE,UAAA,CAAW,QAAA,UAAkB,MAAA;;;;iBAsE7B,SAAA,CAAU,QAAA,UAAkB,OAAA;;;;UA4B3B,YAAA;EACf,UAAA,SAAmB,EAAA,CAAG,UAAA;EACtB,UAAA,SAAmB,EAAA,CAAG,UAAA;AAAA;;;;;;iBC3IF,gBAAA,CACpB,OAAA,EAAS,UAAA,EACT,QAAA,UACA,WAAA,cACC,OAAA,CAAQ,WAAA;ALHX;;;;AAAA,iBK0CsB,kBAAA,CACpB,OAAA,EAAS,UAAA,EACT,QAAA,YACC,OAAA,CAAQ,GAAA,SAAY,WAAA;;;;;;;AL7CvB;;;;;iBMIsB,eAAA,CACpB,QAAA,EAAU,OAAA,IACV,MAAA,EAAQ,oBAAA,EACR,WAAA,EAAa,UAAA,EACb,WAAA,cACC,OAAA,CAAQ,sBAAA;;;;;;iBCwoCW,WAAA,CAAY,MAAA,EAAQ,iBAAA,GAAoB,OAAA,CAAQ,iBAAA;APjpCtE;;;;AAAA,iBO6hDsB,cAAA,CAAe,MAAA,EAAQ,iBAAA,GAAoB,OAAA;;;;;;;;iBA6BjD,WAAA,CACd,MAAA,EAAQ,IAAA,CAAK,iBAAA,qBACb,UAAA,GAAa,YAAA;;;;;;KChjDH,eAAA;ERZU,oDQcpB,KAAA;EAEA,WAAA,URhBsE;EQkBtE,QAAA,YRlBqE;EQoBrE,OAAA;AAAA;;;;;;;;APrBF;;;;;;;;;AAKA;;;;;AAyCA;;;;;;;;;iBOuGsB,kBAAA,CACpB,OAAA,EAAS,UAAA,EACT,UAAA,EAAY,eAAA,IACZ,OAAA,GAAU,mBAAA,GACT,OAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.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-index.ts"],"mappings":"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"}

package/dist/docs/index.d.ts

@@ -1,5 +1,4 @@
-import "../arg-registry-BUUhZ7JR.js";
-import { E as SubCommandValue, n as ResolvedFieldMeta, p as Example, s as AnyCommand, t as ExtractedFields } from "../schema-extractor-n9288WJ6.js";
+import { O as SubCommandValue, c as AnyCommand, l as ArgsSchema, m as Example, n as ResolvedFieldMeta, t as ExtractedFields } from "../schema-extractor-C9APqeSL.js";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -93,6 +92,10 @@ interface CommandInfo {
   examples?: Example[] | undefined;
   /** Example execution results (populated when examples are executed) */
   exampleResults?: ExampleExecutionResult[] | undefined;
+  /** Path to root document file (for global options link generation) */
+  rootDocPath?: string | undefined;
+  /** Whether global options exist (for global options link generation) */
+  hasGlobalOptions?: boolean;
 }
 /**
  * Subcommand information
@@ -305,6 +308,35 @@ interface RootDocConfig {
   /** Index section rendering options */
   index?: CommandIndexOptions;
 }
+/**
+ * Root command customization for the root document.
+ * Controls the root document's title, description, header, and footer.
+ */
+interface RootCommandInfo {
+  /** Title (defaults to command.name) */
+  title?: string;
+  /** Description (defaults to command.description) */
+  description?: string;
+  /** Markdown placed after title/description */
+  header?: string;
+  /** Markdown placed at end of document */
+  footer?: string;
+}
+/**
+ * Path configuration for documentation output.
+ * Simpler alternative to FileMapping for common patterns.
+ *
+ * @example
+ * // All commands in one file
+ * path: "docs/CLI.md"
+ *
+ * // Split files: root + specific commands in separate files
+ * path: { root: "docs/CLI.md", commands: { "build": "docs/build.md" } }
+ */
+type PathConfig = string | {
+  root: string;
+  commands?: Record<string, string>;
+};
 /**
  * Per-file configuration with custom renderer
  */
@@ -317,6 +349,8 @@ interface FileConfig {
   title?: string;
   /** File description (added after title) */
   description?: string;
+  /** Skip subcommand expansion (commands are used as-is). @internal */
+  noExpand?: boolean;
 }
 /**
  * File mapping configuration
@@ -343,8 +377,15 @@ interface GenerateDocConfig {
    * Title and description are derived from `command.name` and `command.description`.
    */
   rootDoc?: RootDocConfig;
+  /**
+   * Path configuration (simpler alternative to files).
+   * Mutually exclusive with `files`.
+   */
+  path?: PathConfig;
   /** File output configuration (command path -> file mapping) */
-  files: FileMapping;
+  files?: FileMapping;
+  /** Root command customization (title, description, header, footer) */
+  rootInfo?: RootCommandInfo;
   /** Command paths to ignore (including their subcommands) */
   ignores?: string[];
   /** Default renderer options (used when render is not specified per file) */
@@ -359,6 +400,11 @@ interface GenerateDocConfig {
    * The full document structure is used to maintain cross-file links.
    */
   targetCommands?: string[];
+  /**
+   * Global args schema (runtime schema alternative).
+   * When provided, automatically derives `rootDoc.globalOptions` from this schema.
+   */
+  globalArgs?: ArgsSchema;
 }
 /**
  * generateDoc result
@@ -418,6 +464,18 @@ declare function globalOptionsStartMarker(): string;
  * Generate end marker for a global options section
  */
 declare function globalOptionsEndMarker(): string;
+/**
+ * Marker prefix for root header sections in generated documentation
+ */
+declare const ROOT_HEADER_MARKER_PREFIX = "politty:root-header";
+declare function rootHeaderStartMarker(): string;
+declare function rootHeaderEndMarker(): string;
+/**
+ * Marker prefix for root footer sections in generated documentation
+ */
+declare const ROOT_FOOTER_MARKER_PREFIX = "politty:root-footer";
+declare function rootFooterStartMarker(): string;
+declare function rootFooterEndMarker(): string;
 /**
  * Marker prefix for index sections in generated documentation
  * Format: <!-- politty:index:<scope>:start --> ... <!-- politty:index:<scope>:end -->
@@ -512,9 +570,6 @@ declare function renderSubcommandsTableFromArray(subcommands: SubCommandInfo[],
  * ```
  */
 declare function renderExamplesDefault(examples: Example[], results?: ExampleExecutionResult[], opts?: ExamplesRenderOptions): string;
-/**
- * Create command renderer with options
- */
 declare function createCommandRenderer(options?: DefaultRendererOptions): RenderFunction;
 /**
  * Default renderers presets
@@ -641,5 +696,5 @@ type CommandCategory = {
  */
 declare function renderCommandIndex(command: AnyCommand, categories: CommandCategory[], options?: CommandIndexOptions): Promise<string>;
 //#endregion
-export { type ArgsShape, type ArgsTableOptions, type ArgumentsRenderContext, type ArgumentsRenderFunction, 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, GLOBAL_OPTIONS_MARKER_PREFIX, type GenerateDocConfig, type GenerateDocResult, type HeadingLevel, INDEX_MARKER_PREFIX, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type RootDocConfig, SECTION_MARKER_PREFIX, SECTION_TYPES, type SectionRenderFunction, type SectionType, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, globalOptionsEndMarker, globalOptionsStartMarker, indexEndMarker, indexStartMarker, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, sectionEndMarker, sectionStartMarker, writeFile };
+export { type ArgsShape, type ArgsTableOptions, type ArgumentsRenderContext, type ArgumentsRenderFunction, 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, GLOBAL_OPTIONS_MARKER_PREFIX, type GenerateDocConfig, type GenerateDocResult, type HeadingLevel, INDEX_MARKER_PREFIX, type OptionsRenderContext, type OptionsRenderFunction, type PathConfig, ROOT_FOOTER_MARKER_PREFIX, ROOT_HEADER_MARKER_PREFIX, type RenderContentOptions, type RenderFunction, type RootCommandInfo, type RootDocConfig, SECTION_MARKER_PREFIX, SECTION_TYPES, type SectionRenderFunction, type SectionType, type SimpleRenderContext, type SimpleRenderFunction, type SubCommandInfo, type SubcommandsRenderContext, type SubcommandsRenderFunction, type SubcommandsRenderOptions, UPDATE_GOLDEN_ENV, assertDocMatch, buildCommandInfo, collectAllCommands, compareWithExisting, createCommandRenderer, defaultRenderers, executeExamples, formatDiff, generateDoc, globalOptionsEndMarker, globalOptionsStartMarker, indexEndMarker, indexStartMarker, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, rootFooterEndMarker, rootFooterStartMarker, rootHeaderEndMarker, rootHeaderStartMarker, sectionEndMarker, sectionStartMarker, 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/render-args.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-index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.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-index.ts"],"mappings":"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"}