@alcyone-labs/arg-parser 2.14.2 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +20 -127
  2. package/dist/config/plugins/index.d.ts +36 -4
  3. package/dist/config/plugins/index.d.ts.map +1 -1
  4. package/dist/core/ArgParser.d.ts +124 -464
  5. package/dist/core/ArgParser.d.ts.map +1 -1
  6. package/dist/core/FlagManager.d.ts +36 -136
  7. package/dist/core/FlagManager.d.ts.map +1 -1
  8. package/dist/core/PromptManager.d.ts +42 -91
  9. package/dist/core/PromptManager.d.ts.map +1 -1
  10. package/dist/core/log-path-utils.d.ts +28 -36
  11. package/dist/core/log-path-utils.d.ts.map +1 -1
  12. package/dist/core/types.d.ts +83 -592
  13. package/dist/core/types.d.ts.map +1 -1
  14. package/dist/index.cjs +599 -9658
  15. package/dist/index.cjs.map +1 -1
  16. package/dist/index.d.ts +26 -15
  17. package/dist/index.d.ts.map +1 -1
  18. package/dist/index.min.mjs +615 -8224
  19. package/dist/index.min.mjs.map +1 -1
  20. package/dist/index.mjs +581 -8881
  21. package/dist/index.mjs.map +1 -1
  22. package/dist/plugin/types.d.ts +121 -0
  23. package/dist/plugin/types.d.ts.map +1 -0
  24. package/dist/utils/debug-utils.d.ts +4 -26
  25. package/dist/utils/debug-utils.d.ts.map +1 -1
  26. package/package.json +12 -73
  27. package/dist/assets/.dxtignore.template +0 -37
  28. package/dist/assets/logo_1_small.jpg +0 -0
  29. package/dist/config/ConfigurationManager.d.ts +0 -82
  30. package/dist/config/ConfigurationManager.d.ts.map +0 -1
  31. package/dist/config/plugins/ConfigPlugin.d.ts +0 -60
  32. package/dist/config/plugins/ConfigPlugin.d.ts.map +0 -1
  33. package/dist/config/plugins/ConfigPluginRegistry.d.ts +0 -72
  34. package/dist/config/plugins/ConfigPluginRegistry.d.ts.map +0 -1
  35. package/dist/config/plugins/TomlConfigPlugin.d.ts +0 -30
  36. package/dist/config/plugins/TomlConfigPlugin.d.ts.map +0 -1
  37. package/dist/config/plugins/YamlConfigPlugin.d.ts +0 -29
  38. package/dist/config/plugins/YamlConfigPlugin.d.ts.map +0 -1
  39. package/dist/core/ArgParserBase.d.ts +0 -319
  40. package/dist/core/ArgParserBase.d.ts.map +0 -1
  41. package/dist/core/dxt-path-resolver.d.ts +0 -100
  42. package/dist/core/dxt-path-resolver.d.ts.map +0 -1
  43. package/dist/dxt/DxtGenerator-testUtils.d.ts +0 -22
  44. package/dist/dxt/DxtGenerator-testUtils.d.ts.map +0 -1
  45. package/dist/dxt/DxtGenerator.d.ts +0 -120
  46. package/dist/dxt/DxtGenerator.d.ts.map +0 -1
  47. package/dist/mcp/ArgParserMcp.d.ts +0 -21
  48. package/dist/mcp/ArgParserMcp.d.ts.map +0 -1
  49. package/dist/mcp/mcp-integration.d.ts +0 -86
  50. package/dist/mcp/mcp-integration.d.ts.map +0 -1
  51. package/dist/mcp/mcp-lifecycle.d.ts +0 -163
  52. package/dist/mcp/mcp-lifecycle.d.ts.map +0 -1
  53. package/dist/mcp/mcp-notifications.d.ts +0 -132
  54. package/dist/mcp/mcp-notifications.d.ts.map +0 -1
  55. package/dist/mcp/mcp-prompts.d.ts +0 -132
  56. package/dist/mcp/mcp-prompts.d.ts.map +0 -1
  57. package/dist/mcp/mcp-protocol-versions.d.ts +0 -150
  58. package/dist/mcp/mcp-protocol-versions.d.ts.map +0 -1
  59. package/dist/mcp/mcp-resources.d.ts +0 -133
  60. package/dist/mcp/mcp-resources.d.ts.map +0 -1
  61. package/dist/mcp/mcp-utils.d.ts +0 -20
  62. package/dist/mcp/mcp-utils.d.ts.map +0 -1
  63. package/dist/mcp/zod-compatibility.d.ts +0 -74
  64. package/dist/mcp/zod-compatibility.d.ts.map +0 -1
  65. package/dist/testing/fuzzy-test-cli.d.ts +0 -5
  66. package/dist/testing/fuzzy-test-cli.d.ts.map +0 -1
  67. package/dist/testing/fuzzy-tester.d.ts +0 -101
  68. package/dist/testing/fuzzy-tester.d.ts.map +0 -1
  69. package/dist/tui/index.d.ts +0 -281
  70. package/dist/tui/types.d.ts +0 -60
  71. package/dist/tui/types.d.ts.map +0 -1
  72. package/dist/tui.cjs +0 -1060
  73. package/dist/tui.cjs.map +0 -1
  74. package/dist/tui.mjs +0 -967
  75. package/dist/tui.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"ArgParser.d.ts","sourceRoot":"","sources":["../../src/core/ArgParser.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ArgParser.d.ts","sourceRoot":"","sources":["../../src/core/ArgParser.ts"],"names":[],"mappings":"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"}
@@ -1,174 +1,74 @@
1
- import type { IFlag, ProcessedFlag } from "./types";
2
1
  /**
3
- * Options for FlagManager configuration.
2
+ * FlagManager - Manages flag definitions and collision detection
3
+ *
4
+ * This class handles the registration, storage, and retrieval of CLI flags.
5
+ * It provides collision detection to prevent duplicate flag definitions.
4
6
  */
7
+ import { type IFlag, type ProcessedFlag } from "./types";
5
8
  export interface FlagManagerOptions {
6
- /** Whether to throw an error when a flag with a duplicate name is added. If false, a warning is logged and the duplicate is skipped. @default false */
9
+ /** Throw an error if a flag is added more than once */
7
10
  throwForDuplicateFlags?: boolean;
8
- /**
9
- * Whether to detect and report collisions between flag option strings (e.g., two flags both using `-f` or `--file`).
10
- * When enabled, adding a flag with an option string that conflicts with an existing flag will trigger a warning or error.
11
- * @default true
12
- */
13
- detectOptionCollisions?: boolean;
14
- /**
15
- * Whether to throw an error when flag option collisions are detected.
16
- * If false, a warning is logged but the flag is still added.
17
- * Only applies when detectOptionCollisions is true.
18
- * @default false
19
- */
20
- throwForOptionCollisions?: boolean;
21
11
  }
22
- /**
23
- * Represents a collision between flag option strings.
24
- */
25
12
  export interface FlagOptionCollision {
26
- /** The option string that collides (e.g., "-f" or "--file") */
13
+ flagName: string;
27
14
  option: string;
28
- /** The name of the flag that was already registered with this option */
29
15
  existingFlagName: string;
30
- /** The name of the flag being added that causes the collision */
31
- newFlagName: string;
32
16
  }
33
17
  /**
34
- * Manages flag definitions and detects collisions between flag names and option strings.
35
- *
36
- * @example
37
- * ```typescript
38
- * const manager = new FlagManager({
39
- * throwForDuplicateFlags: true,
40
- * detectOptionCollisions: true,
41
- * throwForOptionCollisions: true
42
- * });
43
- *
44
- * manager.addFlag({
45
- * name: "file",
46
- * options: ["-f", "--file"],
47
- * type: "string"
48
- * });
49
- *
50
- * // This will throw because "-f" is already used:
51
- * manager.addFlag({
52
- * name: "force",
53
- * options: ["-f", "--force"],
54
- * type: "boolean"
55
- * });
56
- * ```
18
+ * Manages flag definitions for an ArgParser instance
57
19
  */
58
20
  export declare class FlagManager {
59
- #private;
21
+ private flags;
22
+ private optionToFlagMap;
23
+ private options;
24
+ constructor(options?: FlagManagerOptions, initialFlags?: readonly IFlag[]);
60
25
  /**
61
- * Creates a new FlagManager instance.
62
- *
63
- * @param options - Configuration options for the manager
64
- * @param initialFlags - Optional array of flags to add immediately
26
+ * Add a single flag
65
27
  */
66
- constructor(options?: FlagManagerOptions, initialFlags?: readonly IFlag[]);
28
+ addFlag(flag: IFlag): void;
67
29
  /**
68
- * Converts a raw IFlag to a ProcessedFlag with resolved types.
69
- *
70
- * @param flag - The flag definition to process
71
- * @returns The processed flag with resolved types
72
- * @internal
30
+ * Add multiple flags
73
31
  */
74
- static _safeFlag(flag: IFlag): ProcessedFlag;
32
+ addFlags(flags: readonly IFlag[]): void;
75
33
  /**
76
- * Adds a flag to the manager.
77
- *
78
- * Detects name collisions (if throwForDuplicateFlags is true) and
79
- * option string collisions (if detectOptionCollisions is true).
80
- *
81
- * @param flag - The flag definition to add
82
- * @returns The FlagManager instance for chaining
83
- * @throws {Error} If throwForDuplicateFlags is true and a flag with the same name exists
84
- * @throws {Error} If throwForOptionCollisions is true and option collisions are detected
85
- *
86
- * @example
87
- * ```typescript
88
- * manager.addFlag({
89
- * name: "verbose",
90
- * options: ["-v", "--verbose"],
91
- * type: "boolean",
92
- * description: "Enable verbose output"
93
- * });
94
- * ```
34
+ * Remove a flag by name
95
35
  */
96
- addFlag(flag: IFlag): this;
36
+ removeFlag(name: string): boolean;
97
37
  /**
98
- * Sets a processed flag for inheritance from a parent parser.
99
- * This bypasses collision detection since inherited flags are intentional.
100
- *
101
- * @param processedFlag - The processed flag to add
102
- * @returns The FlagManager instance for chaining
103
- * @internal
38
+ * Check if a flag exists
104
39
  */
105
- _setProcessedFlagForInheritance(processedFlag: ProcessedFlag): this;
40
+ hasFlag(name: string): boolean;
106
41
  /**
107
- * Adds multiple flags to the manager.
108
- *
109
- * @param flags - Array of flag definitions to add
110
- * @returns The FlagManager instance for chaining
42
+ * Get a flag by name
111
43
  */
112
- addFlags(flags: readonly IFlag[]): this;
44
+ getFlag(name: string): ProcessedFlag | undefined;
113
45
  /**
114
- * Checks if a flag with the given name exists.
115
- *
116
- * @param name - The flag name to check
117
- * @returns True if the flag exists, false otherwise
46
+ * Get all flags as an array
118
47
  */
119
- hasFlag(name: string): boolean;
48
+ getAllFlags(): ProcessedFlag[];
120
49
  /**
121
- * Removes a flag by name.
122
- *
123
- * @param name - The name of the flag to remove
124
- * @returns True if the flag was removed, false if it didn't exist
50
+ * Get all flag names
125
51
  */
126
- removeFlag(name: string): boolean;
52
+ getFlagNames(): string[];
127
53
  /**
128
- * Gets a flag by name.
129
- *
130
- * @param name - The name of the flag to retrieve
131
- * @returns The flag definition, or undefined if not found
54
+ * Find flag by option
132
55
  */
133
- getFlag(name: string): ProcessedFlag | undefined;
56
+ findFlagByOption(option: string): ProcessedFlag | undefined;
134
57
  /**
135
- * Gets all registered flags.
136
- *
137
- * @returns An array of all registered flags
58
+ * Process a raw flag into a ProcessedFlag
138
59
  */
139
- get flags(): ProcessedFlag[];
60
+ private processFlag;
140
61
  /**
141
- * Gets all registered flag names.
142
- *
143
- * @returns An array of all flag names
62
+ * Internal method to set a processed flag directly (for inheritance)
144
63
  */
145
- get flagNames(): string[];
64
+ _setProcessedFlagForInheritance(flag: ProcessedFlag): void;
146
65
  /**
147
- * Gets all registered option strings and their associated flag names.
148
- *
149
- * @returns A map of option strings to flag names
66
+ * Clear all flags
150
67
  */
151
- get optionMappings(): ReadonlyMap<string, string>;
68
+ clear(): void;
152
69
  /**
153
- * Gets all collisions between the given flag and existing flags.
154
- * Useful for pre-validation before adding a flag.
155
- *
156
- * @param flag - The flag to check for collisions
157
- * @returns An array of detected collisions, empty if none
158
- *
159
- * @example
160
- * ```typescript
161
- * const collisions = manager.getCollisionsForFlag({
162
- * name: "force",
163
- * options: ["-f", "--force"],
164
- * type: "boolean"
165
- * });
166
- *
167
- * if (collisions.length > 0) {
168
- * console.log("Collisions detected:", collisions);
169
- * }
170
- * ```
70
+ * Get collision report
171
71
  */
172
- getCollisionsForFlag(flag: IFlag): FlagOptionCollision[];
72
+ getCollisions(): FlagOptionCollision[];
173
73
  }
174
74
  //# sourceMappingURL=FlagManager.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"FlagManager.d.ts","sourceRoot":"","sources":["../../src/core/FlagManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uJAAuJ;IACvJ,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAW;;IAOtB;;;;;OAKG;gBACS,OAAO,GAAE,kBAAuB,EAAE,YAAY,GAAE,SAAS,KAAK,EAAO;IAOjF;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,aAAa;IAgF5C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAwC1B;;;;;;;OAOG;IACH,+BAA+B,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IASnE;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI;IAOvC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYjC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD;;;;OAIG;IACH,IAAI,KAAK,IAAI,aAAa,EAAE,CAE3B;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAED;;;;OAIG;IACH,IAAI,cAAc,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAEhD;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,CAAC,IAAI,EAAE,KAAK,GAAG,mBAAmB,EAAE;CAIzD"}
1
+ {"version":3,"file":"FlagManager.d.ts","sourceRoot":"","sources":["../../src/core/FlagManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,GAAE,kBAAuB,EAAE,YAAY,GAAE,SAAS,KAAK,EAAO;IAYjF;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IA6B1B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI;IAMvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYjC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE;IAI9B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAM3D;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,+BAA+B,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAO1D;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,aAAa,IAAI,mBAAmB,EAAE;CAoBvC"}
@@ -1,113 +1,64 @@
1
- import type { IHandlerContext, IPromptableFlag, PromptFieldConfig, PromptWhen } from "./types";
2
1
  /**
3
- * Options for creating a PromptManager instance.
2
+ * PromptManager - Manages interactive prompts with @clack/prompts
3
+ *
4
+ * This class handles the collection and execution of interactive prompts
5
+ * for CLI applications.
4
6
  */
7
+ import type { IHandlerContext, IPromptableFlag } from "./types";
5
8
  export interface PromptManagerOptions {
6
- /** The current handler context, used for passing to prompt functions */
7
- context: IHandlerContext;
8
- /** Called when user cancels (Ctrl+C) during prompts */
9
- onCancel?: (ctx: IHandlerContext) => void | Promise<void>;
9
+ /** Default prompt sequence offset */
10
+ sequenceOffset?: number;
10
11
  }
11
12
  /**
12
- * Result of executing interactive prompts.
13
- */
14
- export interface PromptResult {
15
- /** Whether the prompts were completed successfully */
16
- success: boolean;
17
- /** The collected answers (flag name -> value) */
18
- answers: Record<string, any>;
19
- /** Whether the user cancelled */
20
- cancelled: boolean;
21
- }
22
- /**
23
- * Manages interactive prompts using @clack/prompts.
24
- *
25
- * This class handles:
26
- * - Collecting promptable flags and sorting them by sequence
27
- * - Executing prompts in order with @clack/prompts
28
- * - Validation and re-prompt loops
29
- * - User cancellation (Ctrl+C)
30
- * - TTY detection
31
- * - Automatic defaultValue fallback
32
- * - Select all/none toggle for multiselect
33
- * - Conditional prompt skipping
34
- *
35
- * @example
36
- * ```typescript
37
- * const promptManager = new PromptManager({
38
- * context: handlerContext,
39
- * onCancel: () => console.log("Cancelled")
40
- * });
41
- *
42
- * const result = await promptManager.executePrompts([
43
- * { flag: envFlag, name: "environment" },
44
- * { flag: versionFlag, name: "version" }
45
- * ]);
46
- *
47
- * if (result.success) {
48
- * console.log("Answers:", result.answers);
49
- * }
50
- * ```
13
+ * Manages interactive prompts for an ArgParser instance
51
14
  */
52
15
  export declare class PromptManager {
53
- #private;
16
+ private promptableFlags;
17
+ private _options;
18
+ constructor(options?: PromptManagerOptions);
19
+ get sequenceOffset(): number;
54
20
  /**
55
- * Creates a new PromptManager instance.
56
- *
57
- * @param options - Configuration options
21
+ * Register a promptable flag
58
22
  */
59
- constructor(options: PromptManagerOptions);
23
+ registerPromptableFlag(flag: IPromptableFlag): void;
60
24
  /**
61
- * Checks if the current environment supports interactive prompts.
62
- * Returns false in non-TTY environments (CI, pipes, etc.).
25
+ * Unregister a promptable flag
63
26
  */
64
- static isInteractiveEnvironment(): boolean;
27
+ unregisterPromptableFlag(name: string): boolean;
65
28
  /**
66
- * Determines if interactive mode should be triggered based on promptWhen condition.
67
- *
68
- * @param promptWhen - The condition to check
69
- * @param flags - The promptable flags to check
70
- * @param args - The current parsed args
71
- * @returns True if interactive mode should be triggered
29
+ * Check if a flag has a prompt
72
30
  */
73
- static shouldTriggerInteractive(promptWhen: PromptWhen, flags: Array<{
74
- flag: IPromptableFlag;
75
- name: string;
76
- }>, args: Record<string, any>): boolean;
31
+ hasPrompt(name: string): boolean;
77
32
  /**
78
- * Sorts flags by their prompt sequence.
79
- * Falls back to array order if promptSequence is not specified.
80
- * Ties are broken by array order.
81
- *
82
- * @param flags - Array of flags to sort
83
- * @returns Sorted array of flags
33
+ * Get all promptable flags sorted by sequence
84
34
  */
85
- static sortFlagsBySequence(flags: Array<{
86
- flag: IPromptableFlag;
87
- name: string;
88
- index: number;
89
- }>): Array<{
90
- flag: IPromptableFlag;
91
- name: string;
92
- index: number;
93
- }>;
35
+ getPromptableFlags(): IPromptableFlag[];
94
36
  /**
95
- * Gets the initial value for a prompt, falling back to flag's defaultValue.
37
+ * Execute prompts for missing flags
96
38
  *
97
- * @param config - The prompt configuration
98
- * @param flag - The flag definition
99
- * @returns The initial value to use
39
+ * This is a placeholder implementation. The actual implementation
40
+ * would integrate with @clack/prompts.
100
41
  */
101
- static getInitialValue(config: PromptFieldConfig, flag: IPromptableFlag): any;
42
+ executePrompts(context: IHandlerContext, missingFlagNames: string[]): Promise<PromptResult>;
102
43
  /**
103
- * Executes all prompts in sequence.
104
- *
105
- * @param flags - Array of promptable flags with their names
106
- * @returns The result of the prompt execution
44
+ * Clear all registered flags
107
45
  */
108
- executePrompts(flags: Array<{
109
- flag: IPromptableFlag;
110
- name: string;
111
- }>): Promise<PromptResult>;
46
+ clear(): void;
47
+ }
48
+ /**
49
+ * Result of executing prompts
50
+ */
51
+ export interface PromptResult {
52
+ /** Collected answers */
53
+ answers: Record<string, any>;
54
+ /** Individual prompt results */
55
+ results: Array<{
56
+ flagName: string;
57
+ success: boolean;
58
+ value?: any;
59
+ error?: string;
60
+ }>;
61
+ /** Whether the user cancelled */
62
+ cancelled: boolean;
112
63
  }
113
64
  //# sourceMappingURL=PromptManager.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"PromptManager.d.ts","sourceRoot":"","sources":["../../src/core/PromptManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,OAAO,EAAE,eAAe,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAa;;IAIxB;;;;OAIG;gBACS,OAAO,EAAE,oBAAoB;IAKzC;;;OAGG;IACH,MAAM,CAAC,wBAAwB,IAAI,OAAO;IAQ1C;;;;;;;OAOG;IACH,MAAM,CAAC,wBAAwB,CAC7B,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EACrD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO;IAsBV;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CACxB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GACnE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAchE;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe,GAAG,GAAG;IAc7E;;;;;OAKG;IACG,cAAc,CAClB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GACpD,OAAO,CAAC,YAAY,CAAC;CAqLzB"}
1
+ {"version":3,"file":"PromptManager.d.ts","sourceRoot":"","sources":["../../src/core/PromptManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,OAAO,GAAE,oBAAyB;IAO9C,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAInD;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/C;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAQvC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,EAAE,eAAe,EACxB,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,YAAY,CAAC;IAoCxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,gCAAgC;IAChC,OAAO,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB"}
@@ -1,59 +1,51 @@
1
1
  /**
2
- * Configuration object for log path with explicit relative base
2
+ * Log path utilities for ArgParser
3
+ *
4
+ * Provides flexible path resolution for log files, supporting
5
+ * relative paths (to entry point or cwd), absolute paths, and
6
+ * configuration objects.
7
+ */
8
+ /**
9
+ * Log path can be a simple string or a configuration object
10
+ */
11
+ export type LogPath = string | LogPathConfig;
12
+ /**
13
+ * Configuration for log path resolution
3
14
  */
4
15
  export interface LogPathConfig {
5
- /** The log file path */
16
+ /** The path string */
6
17
  path: string;
7
- /** What the path should be relative to */
18
+ /** How to resolve the path */
8
19
  relativeTo?: "entry" | "cwd" | "absolute";
9
- /** Manual base path override (used with relativeTo: 'absolute') */
20
+ /** Optional base path for 'entry' resolution */
10
21
  basePath?: string;
11
22
  }
12
23
  /**
13
- * Log path can be a simple string or a configuration object
14
- */
15
- export type LogPath = string | LogPathConfig;
16
- /**
17
- * Attempts to detect the entry point script using multiple methods
18
- * @returns The detected entry point path or null if detection fails
24
+ * Detect the entry point of the application
19
25
  */
20
- export declare function detectEntryPoint(): string | null;
26
+ export declare function detectEntryPoint(): string;
21
27
  /**
22
- * Helper to get entry point from import.meta.url when in ES module context
23
- * @param importMetaUrl The import.meta.url value
24
- * @returns The file path
28
+ * Get entry point from import.meta.url
25
29
  */
26
30
  export declare function getEntryPointFromImportMeta(importMetaUrl: string): string;
27
31
  /**
28
- * Resolves a log path configuration to an absolute file path
29
- * @param logPath The log path configuration (string or object)
30
- * @param fallbackEntryPoint Optional fallback entry point if detection fails
31
- * @returns Absolute path to the log file
32
+ * Resolve a log path to an absolute path
32
33
  */
33
- export declare function resolveLogPath(logPath: LogPath, fallbackEntryPoint?: string): string;
34
+ export declare function resolveLogPath(logPath: LogPath): string;
34
35
  /**
35
- * Creates a log path configuration for entry-point relative logging
36
- * @param path The relative path from the entry point
37
- * @returns LogPathConfig object
36
+ * Create a path relative to the entry point
38
37
  */
39
- export declare function entryRelative(path: string): LogPathConfig;
38
+ export declare function entryRelative(subPath: string): string;
40
39
  /**
41
- * Creates a log path configuration for process.cwd() relative logging
42
- * @param path The relative path from process.cwd()
43
- * @returns LogPathConfig object
40
+ * Create a path relative to the current working directory
44
41
  */
45
- export declare function cwdRelative(path: string): LogPathConfig;
42
+ export declare function cwdRelative(subPath: string): string;
46
43
  /**
47
- * Creates a log path configuration for absolute path logging
48
- * @param path The absolute path or relative path
49
- * @param basePath Optional base path to resolve relative paths against
50
- * @returns LogPathConfig object
44
+ * Create an absolute path
51
45
  */
52
- export declare function absolutePath(path: string, basePath?: string): LogPathConfig;
46
+ export declare function absolutePath(pathStr: string): string;
53
47
  /**
54
- * Utility to help migrate from old relative-to-cwd behavior
55
- * @param path The path that was previously relative to cwd
56
- * @returns String with explicit cwd: prefix
48
+ * Legacy cwd-relative path (for backward compatibility)
57
49
  */
58
- export declare function legacyCwdPath(path: string): string;
50
+ export declare function legacyCwdPath(subPath: string): string;
59
51
  //# sourceMappingURL=log-path-utils.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"log-path-utils.d.ts","sourceRoot":"","sources":["../../src/core/log-path-utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAsBhD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMzE;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAiFpF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}
1
+ {"version":3,"file":"log-path-utils.d.ts","sourceRoot":"","sources":["../../src/core/log-path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;IAC1C,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAsCvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}