Rename to argv and apply inflektTree

Author: NorOldBurden

packages/inflekt/README.md

@@ -39,6 +39,7 @@ import {
   toFieldName,
   toQueryName,
   inflektTree,
+  camelizeArgv,
 } from 'inflekt';
 
 // Basic singularization/pluralization
@@ -74,6 +75,11 @@ const apiResponse = {
 };
 inflektTree(apiResponse, (key) => camelize(key, true));
 // Result: { userName: 'John', orderItems: [{ itemId: 1, productName: 'Widget' }] }
+
+// CLI argument transformation (kebab-case to camelCase)
+const argv = { 'schema-file': 'test.graphql', 'dry-run': true, _: [] };
+camelizeArgv(argv);
+// Result: { schemaFile: 'test.graphql', dryRun: true, _: [] }
 ```
 
 ## API
@@ -104,6 +110,10 @@ inflektTree(apiResponse, (key) => camelize(key, true));
 
 - `inflektTree(obj, transformer, options?)` - Recursively transform all property names in an object tree
 
+### CLI Argument Utilities
+
+- `camelizeArgv(argv)` - Transform CLI argument keys (kebab-case/snake_case) to camelCase, preserving minimist internals
+
 ## Deep Object Key Transformation
 
 The `inflektTree` function recursively transforms all property names in an object tree using any transformer function. This is useful for converting API responses between naming conventions.
@@ -180,6 +190,40 @@ const result3 = inflektTree(deepObject, (key) => camelize(key, true), {
 - Returns primitives unchanged
 - Works with any transformer function
 
+## CLI Argument Transformation
+
+The `camelizeArgv` function is a specialized utility for transforming CLI argument objects (typically from minimist or similar parsers) from kebab-case or snake_case to camelCase.
+
+### Usage
+
+```typescript
+import { camelizeArgv } from 'inflekt';
+
+// Transform CLI arguments
+const argv = {
+  'schema-file': 'test.graphql',
+  'dry-run': true,
+  output_dir: 'dist',
+  _: ['arg1', 'arg2']
+};
+
+const parsedArgv = camelizeArgv(argv);
+// Result:
+// {
+//   schemaFile: 'test.graphql',
+//   dryRun: true,
+//   outputDir: 'dist',
+//   _: ['arg1', 'arg2']
+// }
+```
+
+### Features
+
+- Transforms kebab-case and snake_case keys to camelCase
+- Only transforms top-level keys (preserves nested object structure)
+- Preserves minimist internal keys (`_` and keys starting with `_`)
+- Built on top of `inflektTree` for consistency
+
 ## Latin Suffix Overrides
 
 This library handles Latin plural suffixes differently than the standard `inflection` package to match PostGraphile's behavior:

packages/inflekt/__tests__/argv.test.ts

@@ -0,0 +1,133 @@
+import { camelizeArgv } from '../src/argv';
+
+describe('camelizeArgv', () => {
+  it('should convert kebab-case keys to camelCase', () => {
+    const argv = {
+      'schema-file': 'test.graphql',
+      'dry-run': true,
+      output: 'dist'
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      schemaFile: 'test.graphql',
+      dryRun: true,
+      output: 'dist'
+    });
+  });
+
+  it('should convert snake_case keys to camelCase', () => {
+    const argv = {
+      schema_file: 'test.graphql',
+      dry_run: true,
+      output_dir: 'dist'
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      schemaFile: 'test.graphql',
+      dryRun: true,
+      outputDir: 'dist'
+    });
+  });
+
+  it('should preserve minimist internal _ key', () => {
+    const argv = {
+      'schema-file': 'test.graphql',
+      _: ['arg1', 'arg2']
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      schemaFile: 'test.graphql',
+      _: ['arg1', 'arg2']
+    });
+  });
+
+  it('should skip keys starting with underscore', () => {
+    const argv = {
+      'schema-file': 'test.graphql',
+      _private: 'secret',
+      _internal_flag: true
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      schemaFile: 'test.graphql',
+      _private: 'secret',
+      _internal_flag: true
+    });
+  });
+
+  it('should only transform top-level keys', () => {
+    const argv = {
+      'schema-file': 'test.graphql',
+      config: {
+        'nested-key': 'value',
+        another_nested: 'data'
+      }
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      schemaFile: 'test.graphql',
+      config: {
+        'nested-key': 'value',
+        another_nested: 'data'
+      }
+    });
+  });
+
+  it('should handle arrays in values', () => {
+    const argv = {
+      'include-files': ['file1.ts', 'file2.ts'],
+      _: [] as string[]
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      includeFiles: ['file1.ts', 'file2.ts'],
+      _: []
+    });
+  });
+
+  it('should handle mixed kebab-case and snake_case', () => {
+    const argv = {
+      'schema-file': 'test.graphql',
+      output_dir: 'dist',
+      'dry-run': true,
+      verbose_mode: false
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      schemaFile: 'test.graphql',
+      outputDir: 'dist',
+      dryRun: true,
+      verboseMode: false
+    });
+  });
+
+  it('should preserve already camelCase keys', () => {
+    const argv = {
+      schemaFile: 'test.graphql',
+      dryRun: true,
+      _: [] as string[]
+    };
+    
+    const result = camelizeArgv(argv);
+    
+    expect(result).toEqual({
+      schemaFile: 'test.graphql',
+      dryRun: true,
+      _: []
+    });
+  });
+});

packages/inflekt/src/argv.ts

@@ -0,0 +1,29 @@
+/**
+ * Object key transformation utilities for CLI arguments and other use cases
+ */
+
+import { camelize } from 'inflection';
+import { inflektTree } from './transform-keys';
+
+const isTopLevel = (_key: string, path: string[]) => path.length === 0;
+
+/**
+ * Camelize argv keys (typically from minimist or similar CLI parsers)
+ * Transforms kebab-case and snake_case keys to camelCase at the top level only.
+ * Skips minimist internal keys like '_' and keys starting with '_'.
+ *
+ * @param argv - Parsed CLI arguments object
+ * @returns New object with camelCase keys
+ *
+ * @example
+ * const argv = { 'schema-file': 'test.graphql', 'dry-run': true, _: [] };
+ * const parsedArgv = camelizeArgv(argv);
+ * // Result: { schemaFile: 'test.graphql', dryRun: true, _: [] }
+ */
+export const camelizeArgv = (argv: Record<string, any>) =>
+  inflektTree(argv, (key) => camelize(key, true), {
+    skip: (key, path) =>
+      !isTopLevel(key, path) ||
+      key === '_' ||
+      key.startsWith('_')
+  });

packages/inflekt/src/index.ts

@@ -9,3 +9,4 @@ export * from './pluralize';
 export * from './case';
 export * from './naming';
 export * from './transform-keys';
+export * from './argv';