politty 0.3.2 → 0.4.0

package/dist/docs/index.d.cts

@@ -385,18 +385,26 @@ type FormatterFunction = (content: string) => string | Promise<string>;
  */
 declare const UPDATE_GOLDEN_ENV = "POLITTY_DOCS_UPDATE";
 /**
- * Marker prefix for command sections in generated documentation
- * Format: <!-- politty:command:<path>:start --> ... <!-- politty:command:<path>:end -->
+ * All section types in rendering order
  */
-declare const COMMAND_MARKER_PREFIX = "politty:command";
+declare const SECTION_TYPES: readonly ["heading", "description", "usage", "arguments", "options", "subcommands", "examples", "notes"];
+/**
+ * Section types for command documentation markers
+ */
+type SectionType = (typeof SECTION_TYPES)[number];
+/**
+ * Marker prefix for command section markers in generated documentation
+ * Format: <!-- politty:command:<scope>:<type>:start --> ... <!-- politty:command:<scope>:<type>:end -->
+ */
+declare const SECTION_MARKER_PREFIX = "politty:command";
 /**
  * Generate start marker for a command section
  */
-declare function commandStartMarker(commandPath: string): string;
+declare function sectionStartMarker(type: SectionType, scope: string): string;
 /**
  * Generate end marker for a command section
  */
-declare function commandEndMarker(commandPath: string): string;
+declare function sectionEndMarker(type: SectionType, scope: string): string;
 /**
  * Marker prefix for global options sections in generated documentation
  * Format: <!-- politty:global-options:start --> ... <!-- politty:global-options:end -->
@@ -412,17 +420,17 @@ declare function globalOptionsStartMarker(): string;
 declare function globalOptionsEndMarker(): string;
 /**
  * Marker prefix for index sections in generated documentation
- * Format: <!-- politty:index:start --> ... <!-- politty:index:end -->
+ * Format: <!-- politty:index:<scope>:start --> ... <!-- politty:index:<scope>:end -->
  */
 declare const INDEX_MARKER_PREFIX = "politty:index";
 /**
  * Generate start marker for an index section
  */
-declare function indexStartMarker(): string;
+declare function indexStartMarker(scope: string): string;
 /**
  * Generate end marker for an index section
  */
-declare function indexEndMarker(): string;
+declare function indexEndMarker(scope: string): string;
 //#endregion
 //#region src/docs/default-renderers.d.ts
 /**
@@ -633,5 +641,5 @@ type CommandCategory = {
  */
 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, GLOBAL_OPTIONS_MARKER_PREFIX, type GenerateDocConfig, type GenerateDocResult, type HeadingLevel, INDEX_MARKER_PREFIX, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type RootDocConfig, 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, globalOptionsEndMarker, globalOptionsStartMarker, indexEndMarker, indexStartMarker, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, 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 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 };
 //# 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":"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"}
+{"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

@@ -385,18 +385,26 @@ type FormatterFunction = (content: string) => string | Promise<string>;
  */
 declare const UPDATE_GOLDEN_ENV = "POLITTY_DOCS_UPDATE";
 /**
- * Marker prefix for command sections in generated documentation
- * Format: <!-- politty:command:<path>:start --> ... <!-- politty:command:<path>:end -->
+ * All section types in rendering order
  */
-declare const COMMAND_MARKER_PREFIX = "politty:command";
+declare const SECTION_TYPES: readonly ["heading", "description", "usage", "arguments", "options", "subcommands", "examples", "notes"];
+/**
+ * Section types for command documentation markers
+ */
+type SectionType = (typeof SECTION_TYPES)[number];
+/**
+ * Marker prefix for command section markers in generated documentation
+ * Format: <!-- politty:command:<scope>:<type>:start --> ... <!-- politty:command:<scope>:<type>:end -->
+ */
+declare const SECTION_MARKER_PREFIX = "politty:command";
 /**
  * Generate start marker for a command section
  */
-declare function commandStartMarker(commandPath: string): string;
+declare function sectionStartMarker(type: SectionType, scope: string): string;
 /**
  * Generate end marker for a command section
  */
-declare function commandEndMarker(commandPath: string): string;
+declare function sectionEndMarker(type: SectionType, scope: string): string;
 /**
  * Marker prefix for global options sections in generated documentation
  * Format: <!-- politty:global-options:start --> ... <!-- politty:global-options:end -->
@@ -412,17 +420,17 @@ declare function globalOptionsStartMarker(): string;
 declare function globalOptionsEndMarker(): string;
 /**
  * Marker prefix for index sections in generated documentation
- * Format: <!-- politty:index:start --> ... <!-- politty:index:end -->
+ * Format: <!-- politty:index:<scope>:start --> ... <!-- politty:index:<scope>:end -->
  */
 declare const INDEX_MARKER_PREFIX = "politty:index";
 /**
  * Generate start marker for an index section
  */
-declare function indexStartMarker(): string;
+declare function indexStartMarker(scope: string): string;
 /**
  * Generate end marker for an index section
  */
-declare function indexEndMarker(): string;
+declare function indexEndMarker(scope: string): string;
 //#endregion
 //#region src/docs/default-renderers.d.ts
 /**
@@ -633,5 +641,5 @@ type CommandCategory = {
  */
 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, GLOBAL_OPTIONS_MARKER_PREFIX, type GenerateDocConfig, type GenerateDocResult, type HeadingLevel, INDEX_MARKER_PREFIX, type OptionsRenderContext, type OptionsRenderFunction, type RenderContentOptions, type RenderFunction, type RootDocConfig, 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, globalOptionsEndMarker, globalOptionsStartMarker, indexEndMarker, indexStartMarker, initDocFile, renderArgsTable, renderArgumentsList, renderArgumentsListFromArray, renderArgumentsTable, renderArgumentsTableFromArray, renderCommandIndex, renderExamplesDefault, renderOptionsList, renderOptionsListFromArray, renderOptionsTable, renderOptionsTableFromArray, renderSubcommandsTable, renderSubcommandsTableFromArray, renderUsage, resolveLazyCommand, 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 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 };
 //# 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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"}