@alcyone-labs/arg-parser 1.0.0 → 1.1.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 (76) hide show
  1. package/README.md +844 -45
  2. package/dist/examples/fuzzy-demo.d.ts +8 -0
  3. package/dist/examples/fuzzy-demo.d.ts.map +1 -0
  4. package/dist/examples/fuzzy-test-example.d.ts +8 -0
  5. package/dist/examples/fuzzy-test-example.d.ts.map +1 -0
  6. package/dist/examples/fzf-search-cli.d.ts +8 -0
  7. package/dist/examples/fzf-search-cli.d.ts.map +1 -0
  8. package/dist/examples/getting-started.d.ts +27 -0
  9. package/dist/examples/getting-started.d.ts.map +1 -0
  10. package/dist/examples/mcp-preset-transports.d.ts +19 -0
  11. package/dist/examples/mcp-preset-transports.d.ts.map +1 -0
  12. package/dist/examples/simple-cli.d.ts +26 -0
  13. package/dist/examples/simple-cli.d.ts.map +1 -0
  14. package/dist/examples/v1.1.0-showcase.d.ts +16 -0
  15. package/dist/examples/v1.1.0-showcase.d.ts.map +1 -0
  16. package/dist/examples/with-env-example.d.ts +3 -0
  17. package/dist/examples/with-env-example.d.ts.map +1 -0
  18. package/dist/index-6G9StDO_.js +6445 -0
  19. package/dist/index-6G9StDO_.js.map +1 -0
  20. package/dist/index-CqU7Fj3C.cjs +6444 -0
  21. package/dist/index-CqU7Fj3C.cjs.map +1 -0
  22. package/dist/index-Dx_q1msW.js +4682 -0
  23. package/dist/index-Dx_q1msW.js.map +1 -0
  24. package/dist/index.cjs +1704 -60
  25. package/dist/index.cjs.map +1 -1
  26. package/dist/index.min.mjs +1628 -484
  27. package/dist/index.min.mjs.map +1 -1
  28. package/dist/index.mjs +1660 -59
  29. package/dist/index.mjs.map +1 -1
  30. package/dist/src/ArgParser.d.ts +156 -0
  31. package/dist/src/ArgParser.d.ts.map +1 -0
  32. package/dist/{ArgParser.d.ts → src/ArgParserBase.d.ts} +20 -13
  33. package/dist/src/ArgParserBase.d.ts.map +1 -0
  34. package/dist/{FlagManager.d.ts → src/FlagManager.d.ts} +1 -1
  35. package/dist/src/FlagManager.d.ts.map +1 -0
  36. package/dist/src/fuzzy-test-cli.d.ts +5 -0
  37. package/dist/src/fuzzy-test-cli.d.ts.map +1 -0
  38. package/dist/src/fuzzy-tester.d.ts +101 -0
  39. package/dist/src/fuzzy-tester.d.ts.map +1 -0
  40. package/dist/src/index.d.ts +7 -0
  41. package/dist/src/index.d.ts.map +1 -0
  42. package/dist/src/mcp-integration.d.ts +31 -0
  43. package/dist/src/mcp-integration.d.ts.map +1 -0
  44. package/dist/src/types.d.ts +154 -0
  45. package/dist/src/types.d.ts.map +1 -0
  46. package/dist/sse-B5Jf_YpG.cjs +121 -0
  47. package/dist/sse-B5Jf_YpG.cjs.map +1 -0
  48. package/dist/sse-BDL3h2Ll.js +121 -0
  49. package/dist/sse-BDL3h2Ll.js.map +1 -0
  50. package/dist/sse-DSjLfGFo.js +107 -0
  51. package/dist/sse-DSjLfGFo.js.map +1 -0
  52. package/dist/stdio-Cf19UQO7.js +70 -0
  53. package/dist/stdio-Cf19UQO7.js.map +1 -0
  54. package/dist/stdio-DESvSONI.cjs +94 -0
  55. package/dist/stdio-DESvSONI.cjs.map +1 -0
  56. package/dist/stdio-DLOResWr.js +94 -0
  57. package/dist/stdio-DLOResWr.js.map +1 -0
  58. package/dist/streamableHttp-DXIdDSbF.js +342 -0
  59. package/dist/streamableHttp-DXIdDSbF.js.map +1 -0
  60. package/dist/streamableHttp-DsXlAnqJ.cjs +456 -0
  61. package/dist/streamableHttp-DsXlAnqJ.cjs.map +1 -0
  62. package/dist/streamableHttp-Vd4Qsgko.js +456 -0
  63. package/dist/streamableHttp-Vd4Qsgko.js.map +1 -0
  64. package/dist/types-DSxPEImy.cjs +943 -0
  65. package/dist/types-DSxPEImy.cjs.map +1 -0
  66. package/dist/types-DdsPVLQ5.js +846 -0
  67. package/dist/types-DdsPVLQ5.js.map +1 -0
  68. package/dist/types-DpK81FWv.js +944 -0
  69. package/dist/types-DpK81FWv.js.map +1 -0
  70. package/package.json +18 -7
  71. package/dist/ArgParser.d.ts.map +0 -1
  72. package/dist/FlagManager.d.ts.map +0 -1
  73. package/dist/index.d.ts +0 -2
  74. package/dist/index.d.ts.map +0 -1
  75. package/dist/types.d.ts +0 -91
  76. package/dist/types.d.ts.map +0 -1
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bun
2
+ import { ArgParser } from '../src/ArgParser';
3
+ declare const demoParser: ArgParser<{
4
+ action: string;
5
+ processed: boolean;
6
+ }>;
7
+ export default demoParser;
8
+ //# sourceMappingURL=fuzzy-demo.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzy-demo.d.ts","sourceRoot":"","sources":["../../examples/fuzzy-demo.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,QAAA,MAAM,UAAU;;;EA8Cd,CAAC;AAwCH,eAAe,UAAU,CAAC"}
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bun
2
+ import { ArgParser } from "../src/ArgParser";
3
+ declare const exampleParser: ArgParser<{
4
+ action: string;
5
+ args: any;
6
+ }>;
7
+ export default exampleParser;
8
+ //# sourceMappingURL=fuzzy-test-example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzy-test-example.d.ts","sourceRoot":"","sources":["../../examples/fuzzy-test-example.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,QAAA,MAAM,aAAa;;;EAsLjB,CAAC;AA+DH,eAAe,aAAa,CAAC"}
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bun
2
+ export interface IFzfSearchResult {
3
+ files: string[];
4
+ error?: string;
5
+ commandExecuted?: string;
6
+ stderrOutput?: string;
7
+ }
8
+ //# sourceMappingURL=fzf-search-cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fzf-search-cli.d.ts","sourceRoot":"","sources":["../../examples/fzf-search-cli.ts"],"names":[],"mappings":";AAUA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
@@ -0,0 +1,27 @@
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * Getting Started with ArgParser
4
+ *
5
+ * This is a complete, executable CLI that demonstrates the most common ArgParser patterns.
6
+ * It's a file processing tool that showcases:
7
+ * - Basic flags (string, number, boolean, array)
8
+ * - Sub-commands with their own flags
9
+ * - MCP server integration
10
+ * - Modern best practices
11
+ *
12
+ * Usage:
13
+ * bun examples/getting-started.ts --input file.txt --output result.txt
14
+ * bun examples/getting-started.ts convert --input file.txt --format json
15
+ * bun examples/getting-started.ts serve # Start MCP server
16
+ * bun examples/getting-started.ts --help
17
+ */
18
+ import { ArgParser } from "../src";
19
+ declare const cli: ArgParser<{
20
+ success: boolean;
21
+ processed: any;
22
+ output: any;
23
+ format: any;
24
+ tags: any;
25
+ }>;
26
+ export default cli;
27
+ //# sourceMappingURL=getting-started.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../examples/getting-started.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,QAAA,MAAM,GAAG;;;;;;EAoKP,CAAC;AAGH,eAAe,GAAG,CAAC"}
@@ -0,0 +1,19 @@
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * Example: MCP Preset Transport Configuration
4
+ *
5
+ * This example demonstrates how to configure preset MCP transports
6
+ * that will be used when no CLI transport flags are provided.
7
+ *
8
+ * Usage:
9
+ * bun examples/mcp-preset-transports.ts --input "Hello World"
10
+ * bun examples/mcp-preset-transports.ts serve # Uses preset transports
11
+ * bun examples/mcp-preset-transports.ts serve --transport sse --port 4000 # Overrides presets
12
+ */
13
+ import { ArgParser } from "../src";
14
+ import type { McpTransportConfig } from "../src";
15
+ declare const defaultTransports: McpTransportConfig[];
16
+ declare const cli: ArgParser<any>;
17
+ declare const cliWithSinglePreset: ArgParser<any>;
18
+ export { cli, cliWithSinglePreset, defaultTransports };
19
+ //# sourceMappingURL=mcp-preset-transports.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-preset-transports.d.ts","sourceRoot":"","sources":["../../examples/mcp-preset-transports.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAGjD,QAAA,MAAM,iBAAiB,EAAE,kBAAkB,EAI1C,CAAC;AAGF,QAAA,MAAM,GAAG,gBA2EP,CAAC;AAGH,QAAA,MAAM,mBAAmB,gBAyBvB,CAAC;AAsBH,OAAO,EAAE,GAAG,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC"}
@@ -0,0 +1,26 @@
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * Simple CLI Example - demonstrates basic ArgParser usage
4
+ *
5
+ * This example shows how to create a simple CLI tool with:
6
+ * - Basic flags with different types
7
+ * - Mandatory and optional flags
8
+ * - Default values
9
+ * - Enum validation
10
+ * - Help generation
11
+ *
12
+ * Usage:
13
+ * bun examples/simple-cli.ts --env production --port 8080 --verbose
14
+ * bun examples/simple-cli.ts --help
15
+ */
16
+ import { ArgParser } from "../src";
17
+ declare const parser: ArgParser<{
18
+ success: boolean;
19
+ environment: any;
20
+ port: any;
21
+ verbose: any;
22
+ files: any;
23
+ output: any;
24
+ }>;
25
+ export default parser;
26
+ //# sourceMappingURL=simple-cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simple-cli.d.ts","sourceRoot":"","sources":["../../examples/simple-cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,QAAA,MAAM,MAAM;;;;;;;EA6EV,CAAC;AAGH,eAAe,MAAM,CAAC"}
@@ -0,0 +1,16 @@
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * ArgParser v1.1.0 Feature Showcase - File Search & Processing Tool
4
+ *
5
+ * This example demonstrates all the new features in version 1.1.0 with REAL functionality:
6
+ * 1. System flags (--s-*): --s-debug, --s-debug-print, --s-with-env, --s-save-to-env
7
+ * 2. Environment variable loading from multiple file formats (.env, .yaml, .json, .toml)
8
+ * 3. Configuration export to multiple file formats
9
+ * 4. MCP server integration with multiple transport types
10
+ * 5. Enhanced error handling and validation
11
+ * 6. Real file search using fzf and file processing capabilities
12
+ */
13
+ import { ArgParser } from "../src";
14
+ declare const cli: ArgParser<any>;
15
+ export default cli;
16
+ //# sourceMappingURL=v1.1.0-showcase.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"v1.1.0-showcase.d.ts","sourceRoot":"","sources":["../../examples/v1.1.0-showcase.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AA0HnC,QAAA,MAAM,GAAG,gBAoQP,CAAA;AAIF,eAAe,GAAG,CAAC"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env bun
2
+ export {};
3
+ //# sourceMappingURL=with-env-example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-env-example.d.ts","sourceRoot":"","sources":["../../examples/with-env-example.ts"],"names":[],"mappings":""}