yargs-file-commands 0.0.19 → 1.0.1

package/README.md

@@ -2,6 +2,8 @@
 
 [![NPM Package][npm]][npm-url]
 [![NPM Downloads][npm-downloads]][npmtrends-url]
+[![Tests][tests-badge]][tests-url]
+[![Coverage][coverage-badge]][coverage-url]
 
 This Yargs helper function lets you define all your commands as individual files and their file names and directory structure defines via implication your nested command structure.
 
@@ -111,6 +113,52 @@ db health
 studio start
 ```
 
+### Alternative Type-Safe Command Definition
+
+YOu can also use this type-safe way to define commands using the `CommandModule` type from yargs directly. This is the preferred method as it provides better TypeScript support and catches potential errors at compile time rather than runtime:
+
+```ts
+import type { ArgumentsCamelCase, CommandModule } from 'yargs';
+
+type TriageArgs = {
+  owner: string;
+  repo: string;
+  issue: number;
+};
+
+export const command: CommandModule<object, TriageArgs> = {
+  command: 'triage <owner> <repo> <issue>',
+  describe: 'Triage a GitHub issue',
+  builder: {
+    owner: {
+      type: 'string',
+      description: 'GitHub repository owner',
+      demandOption: true
+    },
+    repo: {
+      type: 'string',
+      description: 'GitHub repository name',
+      demandOption: true
+    },
+    issue: {
+      type: 'number',
+      description: 'Issue number',
+      demandOption: true
+    }
+  },
+  handler: async (argv: ArgumentsCamelCase<TriageArgs>) => {
+    // Implementation
+  }
+};
+```
+
+This approach has several advantages:
+
+- Full TypeScript support with proper type inference
+- Compile-time checking of command structure
+- No risk of misspelling exports
+- Better IDE support with autocompletion
+
 ## Options
 
 The "fileCommands" method takes the following options:
@@ -141,25 +189,19 @@ If you want to contribute, just check out [this git project](https://github.com/
 
 ```sh
 # install dependencies
-npm install
+pnpm install
 
 # build everything
-npm run build
-
-# prettify
-npm run format
+pnpm run build
 
-# eslint
-npm run lint
+# biome
+pnpm run chec
 
-# build and run tests
-npm run test
+# tests
+pnpm vitest
 
 # clean everything, should be like doing a fresh git checkout of the repo.
-npm run clean
-
-# publish the npm package
-npm run publish
+pnpm clean
 
 # run example cli
 npx example-cli
@@ -171,3 +213,7 @@ Underneath the hood, we are using [NX](https://nx.dev) to manage the monorepo an
 [npm-url]: https://www.npmjs.com/package/yargs-file-commands
 [npm-downloads]: https://img.shields.io/npm/dw/yargs-file-commands
 [npmtrends-url]: https://www.npmtrends.com/yargs-file-commands
+[tests-badge]: https://github.com/bhouston/yargs-file-commands/workflows/Tests/badge.svg
+[tests-url]: https://github.com/bhouston/yargs-file-commands/actions/workflows/test.yml
+[coverage-badge]: https://codecov.io/gh/bhouston/yargs-file-commands/branch/main/graph/badge.svg
+[coverage-url]: https://codecov.io/gh/bhouston/yargs-file-commands

package/dist/index.js

@@ -1 +1,2 @@
 export * from './lib/fileCommands.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/lib/Command.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=Command.js.map

package/dist/lib/Command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../src/lib/Command.ts"],"names":[],"mappings":""}

package/dist/lib/buildSegmentTree.d.ts

@@ -38,6 +38,6 @@ export declare const buildSegmentTree: (commands: Command[]) => CommandTreeNode[
  * For leaf nodes, returns the actual command implementation.
  * For internal nodes, creates a parent command that manages subcommands.
  */
-export declare const createCommand: (treeNode: CommandTreeNode) => CommandModule;
+export declare const createCommand: (treeNode: CommandTreeNode) => CommandModule<{}, {}>;
 export declare const logCommandTree: (commands: CommandTreeNode[], level?: number) => void;
 export {};

package/dist/lib/buildSegmentTree.js

@@ -27,6 +27,9 @@ function insertIntoTree(treeNodes, command, depth) {
         return;
     }
     const currentSegmentName = command.segments[depth];
+    if (currentSegmentName === undefined) {
+        return;
+    }
     let currentSegment = treeNodes.find((s) => s.segmentName === currentSegmentName);
     // If this is the last segment, create a leaf node
     if (depth === command.segments.length - 1) {
@@ -34,7 +37,7 @@ function insertIntoTree(treeNodes, command, depth) {
             treeNodes.push({
                 type: 'leaf',
                 segmentName: currentSegmentName,
-                command
+                command,
             });
         }
         else if (currentSegment.type === 'internal') {
@@ -47,7 +50,7 @@ function insertIntoTree(treeNodes, command, depth) {
         currentSegment = {
             type: 'internal',
             segmentName: currentSegmentName,
-            children: []
+            children: [],
         };
         treeNodes.push(currentSegment);
     }
@@ -85,7 +88,7 @@ export const createCommand = (treeNode) => {
         },
         handler: async () => {
             // Internal nodes don't need handlers as they'll demand subcommands
-        }
+        },
     };
     return command;
 };
@@ -97,3 +100,4 @@ export const logCommandTree = (commands, level = 0) => {
         }
     });
 };
+//# sourceMappingURL=buildSegmentTree.js.map

package/dist/lib/buildSegmentTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSegmentTree.js","sourceRoot":"","sources":["../../src/lib/buildSegmentTree.ts"],"names":[],"mappings":"AA0BA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAmB,EAAqB,EAAE,CAAC;IAC1E,MAAM,aAAa,GAAsB,EAAE,CAAC;IAE5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,cAAc,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,aAAa,CAAC;AAAA,CACtB,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,SAA4B,EAAE,OAAgB,EAAE,KAAa,EAAQ;IAC3F,wDAAwD;IACxD,IAAI,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IACD,IAAI,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,kBAAkB,CAAC,CAAC;IAEjF,kDAAkD;IAClD,IAAI,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,kBAAkB;gBAC/B,OAAO;aACR,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,cAAc,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,aAAa,kBAAkB,sCAAsC,IAAI,CAAC,SAAS,CACjF,cAAc,CACf,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAC/B,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,gDAAgD;IAChD,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QAC3B,cAAc,GAAG;YACf,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,kBAAkB;YAC/B,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,cAAc,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,aAAa,kBAAkB,sCAAsC,IAAI,CAAC,SAAS,CACjF,cAAc,CACf,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAChC,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,cAAc,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAAA,CAC7D;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAyB,EAAiB,EAAE,CAAC;IACzE,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC;IAClC,mEAAmE;IACnE,MAAM,OAAO,GAAkB;QAC7B,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,GAAG,IAAI,WAAW;QAC5B,OAAO,EAAE,CAAC,KAAW,EAAQ,EAAE,CAAC;YAC9B,6CAA6C;YAC7C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACtE,+CAA+C;YAC/C,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,sBAAsB,IAAI,aAAa,CAAC,CAAC;YAEhE,OAAO,KAAK,CAAC;QAAA,CACd;QACD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;YACnB,mEAAmE;QAD/C,CAErB;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AAAA,CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAA2B,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC;IACxE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAChC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;IAAA,CACF,CAAC,CAAC;AAAA,CACJ,CAAC"}

package/dist/lib/buildSegmentTree.test.js

@@ -1,7 +1,6 @@
-import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
-import { buildSegmentTree } from './buildSegmentTree.js';
-describe('buildSegmentTree', async () => {
+import { describe, expect, it, vi } from 'vitest';
+import { buildSegmentTree, createCommand, logCommandTree } from './buildSegmentTree.js';
+describe('buildSegmentTree', () => {
     it('should build correct tree structure', () => {
         const commands = [
             {
@@ -12,8 +11,8 @@ describe('buildSegmentTree', async () => {
                     describe: 'Migration command',
                     handler: async () => {
                         // Test handler
-                    }
-                }
+                    },
+                },
             },
             {
                 fullPath: '/commands/db/health.js',
@@ -23,28 +22,29 @@ describe('buildSegmentTree', async () => {
                     describe: 'Health command',
                     handler: async () => {
                         // Test handler
-                    }
-                }
-            }
+                    },
+                },
+            },
         ];
         const tree = buildSegmentTree(commands);
-        assert.equal(tree.length, 1, 'Should have one root node');
+        expect(tree.length).toBe(1);
         const rootNode = tree[0];
-        assert(rootNode, 'Root node should exist');
-        assert.equal(rootNode.segmentName, 'db', 'Root node should be "db"');
-        assert.equal(rootNode.type, 'internal', 'Root node should be internal type');
+        expect(rootNode).toBeDefined();
+        if (!rootNode) {
+            throw new Error('Root node should exist');
+        }
+        expect(rootNode.segmentName).toBe('db');
+        expect(rootNode.type).toBe('internal');
         if (rootNode.type !== 'internal') {
             throw new Error('Expected internal node');
         }
-        assert.equal(rootNode.children.length, 2, 'Should have two child nodes');
-        const childSegments = rootNode.children
-            .map((child) => child.segmentName)
-            .sort();
-        assert.deepEqual(childSegments, ['health', 'migration'], 'Should have "health" and "migration" sub-commands');
+        expect(rootNode.children.length).toBe(2);
+        const childSegments = rootNode.children.map((child) => child.segmentName).sort();
+        expect(childSegments).toEqual(['health', 'migration']);
     });
     it('should handle empty input', () => {
         const tree = buildSegmentTree([]);
-        assert.equal(tree.length, 0, 'Should return empty array for empty input');
+        expect(tree.length).toBe(0);
     });
     it('should handle single command', () => {
         const commands = [
@@ -56,15 +56,268 @@ describe('buildSegmentTree', async () => {
                     describe: 'Test command',
                     handler: async () => {
                         // Test handler
-                    }
-                }
-            }
+                    },
+                },
+            },
         ];
         const tree = buildSegmentTree(commands);
-        assert.equal(tree.length, 1, 'Should have one node');
+        expect(tree.length).toBe(1);
         const node = tree[0];
-        assert(node, 'Node should exist');
-        assert.equal(node.segmentName, 'test', 'Should have correct segment');
-        assert.equal(node.type, 'leaf', 'Should be a leaf node');
+        expect(node).toBeDefined();
+        if (!node) {
+            throw new Error('Node should exist');
+        }
+        expect(node.segmentName).toBe('test');
+        expect(node.type).toBe('leaf');
+    });
+    it('should throw error when directory conflicts with command name (directory first)', () => {
+        const commands = [
+            {
+                fullPath: '/commands/db/migration/command.js',
+                segments: ['db', 'migration'],
+                commandModule: {
+                    command: 'migration',
+                    describe: 'Migration command',
+                    handler: async () => { },
+                },
+            },
+            {
+                fullPath: '/commands/db.js',
+                segments: ['db'],
+                commandModule: {
+                    command: 'db',
+                    describe: 'DB command',
+                    handler: async () => { },
+                },
+            },
+        ];
+        expect(() => buildSegmentTree(commands)).toThrow(/Conflict: db is both a directory and a command/);
+    });
+    it('should throw error when directory conflicts with command name (command first)', () => {
+        const commands = [
+            {
+                fullPath: '/commands/db.js',
+                segments: ['db'],
+                commandModule: {
+                    command: 'db',
+                    describe: 'DB command',
+                    handler: async () => { },
+                },
+            },
+            {
+                fullPath: '/commands/db/migration/command.js',
+                segments: ['db', 'migration'],
+                commandModule: {
+                    command: 'migration',
+                    describe: 'Migration command',
+                    handler: async () => { },
+                },
+            },
+        ];
+        expect(() => buildSegmentTree(commands)).toThrow(/Conflict: db is both a directory and a command/);
+    });
+    it('should handle multiple root commands', () => {
+        const commands = [
+            {
+                fullPath: '/commands/hello.ts',
+                segments: ['hello'],
+                commandModule: {
+                    command: 'hello',
+                    describe: 'Hello command',
+                    handler: async () => { },
+                },
+            },
+            {
+                fullPath: '/commands/world.ts',
+                segments: ['world'],
+                commandModule: {
+                    command: 'world',
+                    describe: 'World command',
+                    handler: async () => { },
+                },
+            },
+        ];
+        const tree = buildSegmentTree(commands);
+        expect(tree.length).toBe(2);
+        expect(tree.map((n) => n.segmentName).sort()).toEqual(['hello', 'world']);
+    });
+    it('should handle nested commands at different depths', () => {
+        const commands = [
+            {
+                fullPath: '/commands/a/b/c.ts',
+                segments: ['a', 'b', 'c'],
+                commandModule: {
+                    command: 'c',
+                    describe: 'C command',
+                    handler: async () => { },
+                },
+            },
+            {
+                fullPath: '/commands/a/d.ts',
+                segments: ['a', 'd'],
+                commandModule: {
+                    command: 'd',
+                    describe: 'D command',
+                    handler: async () => { },
+                },
+            },
+        ];
+        const tree = buildSegmentTree(commands);
+        expect(tree.length).toBe(1);
+        expect(tree[0]?.segmentName).toBe('a');
+        if (tree[0]?.type === 'internal') {
+            expect(tree[0].children.length).toBe(2);
+            const childNames = tree[0].children.map((c) => c.segmentName).sort();
+            expect(childNames).toEqual(['b', 'd']);
+            const bNode = tree[0].children.find((c) => c.segmentName === 'b');
+            if (bNode?.type === 'internal') {
+                expect(bNode.children.length).toBe(1);
+                expect(bNode.children[0]?.segmentName).toBe('c');
+                expect(bNode.children[0]?.type).toBe('leaf');
+            }
+        }
+    });
+});
+describe('createCommand', () => {
+    it('should create command module from leaf node', () => {
+        const command = {
+            fullPath: '/commands/test.ts',
+            segments: ['test'],
+            commandModule: {
+                command: 'test',
+                describe: 'Test command',
+                handler: async () => {
+                    // Test handler
+                },
+            },
+        };
+        const treeNode = {
+            type: 'leaf',
+            segmentName: 'test',
+            command,
+        };
+        const commandModule = createCommand(treeNode);
+        expect(commandModule.command).toBe('test');
+        expect(commandModule.describe).toBe('Test command');
+        expect(commandModule.handler).toBe(command.commandModule.handler);
+    });
+    it('should create command module from internal node with children', () => {
+        const childCommand = {
+            fullPath: '/commands/db/health.ts',
+            segments: ['db', 'health'],
+            commandModule: {
+                command: 'health',
+                describe: 'Health check',
+                handler: async () => { },
+            },
+        };
+        const childTreeNode = {
+            type: 'leaf',
+            segmentName: 'health',
+            command: childCommand,
+        };
+        const internalTreeNode = {
+            type: 'internal',
+            segmentName: 'db',
+            children: [childTreeNode],
+        };
+        const commandModule = createCommand(internalTreeNode);
+        expect(commandModule.command).toBe('db');
+        expect(commandModule.describe).toBe('db commands');
+        expect(commandModule.builder).toBeDefined();
+        expect(commandModule.handler).toBeDefined();
+    });
+    it('should create nested command structure with builder', () => {
+        const healthCommand = {
+            fullPath: '/commands/db/health.ts',
+            segments: ['db', 'health'],
+            commandModule: {
+                command: 'health',
+                describe: 'Health check',
+                handler: async () => { },
+            },
+        };
+        const migrationCommand = {
+            fullPath: '/commands/db/migration.ts',
+            segments: ['db', 'migration'],
+            commandModule: {
+                command: 'migration',
+                describe: 'Migration',
+                handler: async () => { },
+            },
+        };
+        const tree = buildSegmentTree([healthCommand, migrationCommand]);
+        const dbNode = tree[0];
+        if (!dbNode || dbNode.type !== 'internal') {
+            throw new Error('Expected internal node');
+        }
+        const commandModule = createCommand(dbNode);
+        expect(commandModule.command).toBe('db');
+        expect(commandModule.builder).toBeDefined();
+        // Test the builder function
+        if (commandModule.builder && typeof commandModule.builder === 'function') {
+            const mockYargs = {
+                command: vi.fn().mockReturnThis(),
+                demandCommand: vi.fn().mockReturnThis(),
+            };
+            commandModule.builder(mockYargs);
+            expect(mockYargs.command).toHaveBeenCalledTimes(1);
+            expect(mockYargs.demandCommand).toHaveBeenCalledWith(1, 'You must specify a db subcommand');
+        }
+    });
+});
+describe('logCommandTree', () => {
+    it('should log command tree structure', () => {
+        const consoleSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        const commands = [
+            {
+                fullPath: '/commands/db/health.ts',
+                segments: ['db', 'health'],
+                commandModule: {
+                    command: 'health',
+                    describe: 'Health',
+                    handler: async () => { },
+                },
+            },
+            {
+                fullPath: '/commands/hello.ts',
+                segments: ['hello'],
+                commandModule: {
+                    command: 'hello',
+                    describe: 'Hello',
+                    handler: async () => { },
+                },
+            },
+        ];
+        const tree = buildSegmentTree(commands);
+        logCommandTree(tree);
+        expect(consoleSpy).toHaveBeenCalled();
+        const calls = consoleSpy.mock.calls.map((call) => call[0]);
+        expect(calls.some((call) => call.includes('db'))).toBe(true);
+        expect(calls.some((call) => call.includes('health'))).toBe(true);
+        expect(calls.some((call) => call.includes('hello'))).toBe(true);
+        consoleSpy.mockRestore();
+    });
+    it('should log command tree with correct indentation levels', () => {
+        const consoleSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        const commands = [
+            {
+                fullPath: '/commands/a/b/c.ts',
+                segments: ['a', 'b', 'c'],
+                commandModule: {
+                    command: 'c',
+                    describe: 'C',
+                    handler: async () => { },
+                },
+            },
+        ];
+        const tree = buildSegmentTree(commands);
+        logCommandTree(tree, 2);
+        expect(consoleSpy).toHaveBeenCalled();
+        const calls = consoleSpy.mock.calls.map((call) => call[0]);
+        // Check for indentation (initial level 2 = 4 spaces, then children add more)
+        expect(calls.length).toBeGreaterThan(0);
+        consoleSpy.mockRestore();
     });
 });
+//# sourceMappingURL=buildSegmentTree.test.js.map

package/dist/lib/buildSegmentTree.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSegmentTree.test.js","sourceRoot":"","sources":["../../src/lib/buildSegmentTree.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/fileCommands.d.ts

@@ -1,3 +1,4 @@
+import type { CommandModule } from 'yargs';
 import { type ScanDirectoryOptions } from './scanDirectory.js';
 /**
  * Configuration options for file-based command generation
@@ -30,4 +31,4 @@ export declare const DefaultFileCommandsOptions: Required<FileCommandsOptions>;
  * 3. Build a tree structure based on file paths
  * 4. Convert the tree into a command hierarchy
  */
-export declare const fileCommands: (options: FileCommandsOptions) => Promise<import("yargs").CommandModule<{}, {}>[]>;
+export declare const fileCommands: (options: FileCommandsOptions) => Promise<CommandModule<{}, {}>[]>;

package/dist/lib/fileCommands.js

@@ -1,4 +1,4 @@
-import path from 'path';
+import path from 'node:path';
 import { buildSegmentTree, createCommand, logCommandTree } from './buildSegmentTree.js';
 import { importCommandFromFile } from './importCommand.js';
 import { scanDirectory } from './scanDirectory.js';
@@ -13,17 +13,19 @@ export const DefaultFileCommandsOptions = {
     commandDirs: [],
     /** Default file extensions to process */
     extensions: ['.js', '.ts'],
-    /** Default patterns to ignore when scanning directories */
+    /** Default patterns to ignore when scanning directories.
+     * Note: System files (files starting with '.') are ALWAYS ignored regardless of these patterns.
+     * These defaults can be overridden by providing your own ignorePatterns.
+     */
     ignorePatterns: [
-        /^[.|_].*/, // Hidden files and underscore files
         /\.(?:test|spec)\.[jt]s$/, // Test files
         /__(?:test|spec)__/, // Test directories
-        /\.d\.ts$/ // TypeScript declaration files
+        /\.d\.ts$/, // TypeScript declaration files
     ],
     /** Default logging level */
     logLevel: 'info',
     /** Default log prefix */
-    logPrefix: '  '
+    logPrefix: '  ',
 };
 /**
  * Generates a command tree structure from files in specified directories
@@ -45,7 +47,7 @@ export const DefaultFileCommandsOptions = {
 export const fileCommands = async (options) => {
     const fullOptions = {
         ...DefaultFileCommandsOptions,
-        ...options
+        ...options,
     };
     // validate extensions have dots in them
     if (fullOptions.extensions.some((ext) => !ext.startsWith('.'))) {
@@ -61,29 +63,44 @@ export const fileCommands = async (options) => {
         throw new Error(`Command directories must be absolute paths: ${nonAbsoluteDirs.join(', ')}`);
     }
     const commands = [];
-    for (const commandDir of fullOptions.commandDirs) {
+    // Process all command directories in parallel
+    const directoryResults = await Promise.all(fullOptions.commandDirs.map(async (commandDir) => {
         const fullPath = path.resolve(commandDir);
         if (fullOptions.logLevel === 'debug') {
             console.debug(`Scanning directory for commands: ${fullPath}`);
         }
         const filePaths = await scanDirectory(commandDir, commandDir, fullOptions);
+        return { commandDir, filePaths };
+    }));
+    if (fullOptions.logLevel === 'debug') {
+        console.debug(`Importing found commands:`);
+    }
+    // Process all files in parallel
+    const fileResults = await Promise.all(directoryResults.flatMap(({ commandDir, filePaths }) => filePaths.map(async (filePath) => {
+        const localPath = path.relative(commandDir, filePath);
+        const segments = segmentPath(filePath, commandDir);
+        // Remove extension (last segment) if there are multiple segments
+        // If there's only one segment, it means the file has no name (e.g., .js)
+        if (segments.length > 1) {
+            segments.pop(); // remove extension.
+        }
+        else if (segments.length === 0) {
+            throw new Error(`No segments found for file: ${filePath}`);
+        }
         if (fullOptions.logLevel === 'debug') {
-            console.debug(`Importing found commands:`);
+            console.debug(`  ${localPath} - importing command module`);
         }
-        for (const filePath of filePaths) {
-            const localPath = path.relative(commandDir, filePath);
-            const segments = segmentPath(filePath, commandDir);
-            segments.pop(); // remove extension.
-            if (fullOptions.logLevel === 'debug') {
-                console.debug(`  ${localPath} - importing command module`);
-            }
-            commands.push({
-                fullPath: filePath,
-                segments,
-                commandModule: await importCommandFromFile(filePath, segments[segments.length - 1], fullOptions)
-            });
+        const lastSegment = segments[segments.length - 1];
+        if (lastSegment === undefined) {
+            throw new Error(`No segments found for file: ${filePath}`);
         }
-    }
+        return {
+            fullPath: filePath,
+            segments,
+            commandModule: await importCommandFromFile(filePath, lastSegment, fullOptions),
+        };
+    })));
+    commands.push(...fileResults);
     // check if no commands were found
     if (commands.length === 0) {
         throw new Error(`No commands found in specified directories: ${fullOptions.commandDirs.join(', ')}`);
@@ -96,3 +113,4 @@ export const fileCommands = async (options) => {
     const rootCommands = commandRootNodes.map((node) => createCommand(node));
     return rootCommands;
 };
+//# sourceMappingURL=fileCommands.js.map

package/dist/lib/fileCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileCommands.js","sourceRoot":"","sources":["../../src/lib/fileCommands.ts"],"names":[],"mappings":"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"}