deep-case-crafter 0.0.2

package/dist/utils/stringFormatters/camelToPascalCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a camelCase string to PascalCase
+ * Core transformation function without special character handling
+ *
+ * @param str - The camelCase string to convert
+ * @returns The PascalCase transformed string
+ *
+ * @example
+ * ```typescript
+ * camelToPascalCase('helloWorld') // => 'HelloWorld'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function camelToPascalCase(str: string): string;
+//# sourceMappingURL=camelToPascalCase.d.ts.map

package/dist/utils/stringFormatters/camelToPascalCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelToPascalCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/camelToPascalCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/utils/stringFormatters/camelToPascalCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=camelToPascalCase.test.d.ts.map

package/dist/utils/stringFormatters/camelToPascalCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelToPascalCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/camelToPascalCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/camelToSnakeCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a camelCase string to snake_case
+ * Core transformation function without special character handling
+ *
+ * @param str - The camelCase string to convert
+ * @returns The snake_case transformed string
+ *
+ * @example
+ * ```typescript
+ * camelToSnakeCase('helloWorld') // => 'hello_world'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function camelToSnakeCase(str: string): string;
+//# sourceMappingURL=camelToSnakeCase.d.ts.map

package/dist/utils/stringFormatters/camelToSnakeCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelToSnakeCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/camelToSnakeCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU5D"}

package/dist/utils/stringFormatters/camelToSnakeCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=camelToSnakeCase.test.d.ts.map

package/dist/utils/stringFormatters/camelToSnakeCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelToSnakeCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/camelToSnakeCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/kebabToCamelCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a kebab-case string to camelCase
+ * Core transformation function without special character handling
+ *
+ * @param str - The kebab-case string to convert
+ * @returns The camelCase transformed string
+ *
+ * @example
+ * ```typescript
+ * kebabToCamelCase('hello-world') // => 'helloWorld'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function kebabToCamelCase(str: string): string;
+//# sourceMappingURL=kebabToCamelCase.d.ts.map

package/dist/utils/stringFormatters/kebabToCamelCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabToCamelCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/kebabToCamelCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5D"}

package/dist/utils/stringFormatters/kebabToCamelCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kebabToCamelCase.test.d.ts.map

package/dist/utils/stringFormatters/kebabToCamelCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabToCamelCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/kebabToCamelCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/kebabToPascalCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a kebab-case string to PascalCase
+ * Core transformation function without special character handling
+ *
+ * @param str - The kebab-case string to convert
+ * @returns The PascalCase transformed string
+ *
+ * @example
+ * ```typescript
+ * kebabToPascalCase('hello-world') // => 'HelloWorld'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function kebabToPascalCase(str: string): string;
+//# sourceMappingURL=kebabToPascalCase.d.ts.map

package/dist/utils/stringFormatters/kebabToPascalCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabToPascalCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/kebabToPascalCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7D"}

package/dist/utils/stringFormatters/kebabToPascalCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kebabToPascalCase.test.d.ts.map

package/dist/utils/stringFormatters/kebabToPascalCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabToPascalCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/kebabToPascalCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/kebabToSnakeCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a kebab-case string to snake_case
+ * Core transformation function without special character handling
+ *
+ * @param str - The kebab-case string to convert
+ * @returns The snake_case transformed string
+ *
+ * @example
+ * ```typescript
+ * kebabToSnakeCase('hello-world') // => 'hello_world'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function kebabToSnakeCase(str: string): string;
+//# sourceMappingURL=kebabToSnakeCase.d.ts.map

package/dist/utils/stringFormatters/kebabToSnakeCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabToSnakeCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/kebabToSnakeCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/stringFormatters/kebabToSnakeCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kebabToSnakeCase.test.d.ts.map

package/dist/utils/stringFormatters/kebabToSnakeCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabToSnakeCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/kebabToSnakeCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/pascalToCamelCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a PascalCase string to camelCase
+ * Core transformation function without special character handling
+ *
+ * @param str - The PascalCase string to convert
+ * @returns The camelCase transformed string
+ *
+ * @example
+ * ```typescript
+ * pascalToCamelCase('HelloWorld') // => 'helloWorld'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function pascalToCamelCase(str: string): string;
+//# sourceMappingURL=pascalToCamelCase.d.ts.map

package/dist/utils/stringFormatters/pascalToCamelCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalToCamelCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/pascalToCamelCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/utils/stringFormatters/pascalToCamelCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pascalToCamelCase.test.d.ts.map

package/dist/utils/stringFormatters/pascalToCamelCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalToCamelCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/pascalToCamelCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/pascalToKebabCase.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts a PascalCase string to kebab-case
+ * Core transformation function without special character handling
+ *
+ * @param str - The PascalCase string to convert
+ * @returns The kebab-case transformed string
+ *
+ * @example
+ * ```typescript
+ * pascalToKebabCase('HelloWorld') // => 'hello-world'
+ * pascalToKebabCase('HTTPResponse') // => 'http-response'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function pascalToKebabCase(str: string): string;
+//# sourceMappingURL=pascalToKebabCase.d.ts.map

package/dist/utils/stringFormatters/pascalToKebabCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalToKebabCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/pascalToKebabCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa7D"}

package/dist/utils/stringFormatters/pascalToKebabCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pascalToKebabCase.test.d.ts.map

package/dist/utils/stringFormatters/pascalToKebabCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalToKebabCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/pascalToKebabCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/pascalToSnakeCase.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts a PascalCase string to snake_case
+ * Core transformation function without special character handling
+ *
+ * @param str - The PascalCase string to convert
+ * @returns The snake_case transformed string
+ *
+ * @example
+ * ```typescript
+ * pascalToSnakeCase('HelloWorld') // => 'hello_world'
+ * pascalToSnakeCase('HTTPResponse') // => 'http_response'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function pascalToSnakeCase(str: string): string;
+//# sourceMappingURL=pascalToSnakeCase.d.ts.map

package/dist/utils/stringFormatters/pascalToSnakeCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalToSnakeCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/pascalToSnakeCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa7D"}

package/dist/utils/stringFormatters/pascalToSnakeCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pascalToSnakeCase.test.d.ts.map

package/dist/utils/stringFormatters/pascalToSnakeCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalToSnakeCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/pascalToSnakeCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/snakeToCamelCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a snake_case string to camelCase
+ * Core transformation function without special character handling
+ *
+ * @param str - The snake_case string to convert
+ * @returns The camelCase transformed string
+ *
+ * @example
+ * ```typescript
+ * snakeToCamelCase('hello_world') // => 'helloWorld'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function snakeToCamelCase(str: string): string;
+//# sourceMappingURL=snakeToCamelCase.d.ts.map

package/dist/utils/stringFormatters/snakeToCamelCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeToCamelCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/snakeToCamelCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5D"}

package/dist/utils/stringFormatters/snakeToCamelCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snakeToCamelCase.test.d.ts.map

package/dist/utils/stringFormatters/snakeToCamelCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeToCamelCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/snakeToCamelCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/snakeToKebabCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a snake_case string to kebab-case
+ * Core transformation function without special character handling
+ *
+ * @param str - The snake_case string to convert
+ * @returns The kebab-case transformed string
+ *
+ * @example
+ * ```typescript
+ * snakeToKebabCase('hello_world') // => 'hello-world'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function snakeToKebabCase(str: string): string;
+//# sourceMappingURL=snakeToKebabCase.d.ts.map

package/dist/utils/stringFormatters/snakeToKebabCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeToKebabCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/snakeToKebabCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/stringFormatters/snakeToKebabCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snakeToKebabCase.test.d.ts.map

package/dist/utils/stringFormatters/snakeToKebabCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeToKebabCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/snakeToKebabCase.test.ts"],"names":[],"mappings":""}

package/dist/utils/stringFormatters/snakeToPascalCase.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a snake_case string to PascalCase
+ * Core transformation function without special character handling
+ *
+ * @param str - The snake_case string to convert
+ * @returns The PascalCase transformed string
+ *
+ * @example
+ * ```typescript
+ * snakeToPascalCase('hello_world') // => 'HelloWorld'
+ * ```
+ * @internal This function is for internal use by the library
+ */
+export default function snakeToPascalCase(str: string): string;
+//# sourceMappingURL=snakeToPascalCase.d.ts.map

package/dist/utils/stringFormatters/snakeToPascalCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeToPascalCase.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/snakeToPascalCase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7D"}

package/dist/utils/stringFormatters/snakeToPascalCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snakeToPascalCase.test.d.ts.map

package/dist/utils/stringFormatters/snakeToPascalCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeToPascalCase.test.d.ts","sourceRoot":"","sources":["../../../src/utils/stringFormatters/snakeToPascalCase.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "deep-case-crafter",
+  "version": "0.0.2",
+  "description": "Transform deeply nested object, array, Map, and Set keys between common case formats while preserving TypeScript type safety",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "import": "./dist/index.esm.js",
+    "require": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gyrgy/deep-case-crafter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gyrgy/deep-case-crafter/issues"
+  },
+  "homepage": "https://github.com/gyrgy/deep-case-crafter#readme",
+  "author": "gyrgy",
+  "license": "MIT",
+  "private": false,
+  "scripts": {
+    "build": "rollup -c",
+    "prepare": "husky",
+    "test": "jest",
+    "test-coverage": "npm test -- --coverage",
+    "tsc": "tsc --noEmit",
+    "lint": "eslint --ext .js,.jsx,.ts,.tsx src/ --fix --max-warnings=0 --no-cache",
+    "format": "prettier --write \"src/**/*.{js,jsx,ts,tsx,json,md}\"",
+    "benchmark": "tsx benchmark/*.benchmark.ts"
+  },
+  "devDependencies": {
+    "@types/benchmark": "2.1.5",
+    "benchmark": "2.1.4",
+    "@eslint/js": "9.21.0",
+    "@rollup/plugin-commonjs": "28.0.2",
+    "@rollup/plugin-node-resolve": "16.0.0",
+    "@rollup/plugin-terser": "0.4.4",
+    "@rollup/plugin-typescript": "12.1.2",
+    "@types/jest": "29.5.12",
+    "@types/node": "20.14.11",
+    "eslint": "9.21.0",
+    "eslint-config-prettier": "10.0.1",
+    "eslint-plugin-prettier": "5.2.3",
+    "globals": "16.0.0",
+    "husky": "9.1.7",
+    "lint-staged": "15.4.3",
+    "jest": "29.7.0",
+    "rollup": "4.28.1",
+    "rollup-plugin-peer-deps-external": "2.2.4",
+    "rollup-plugin-visualizer": "5.12.0",
+    "ts-jest": "29.2.3",
+    "tslib": "2.8.1",
+    "typescript": "5.7.2",
+    "typescript-eslint": "8.24.1",
+    "tsx": "4.19.3"
+  }
+}

package/readme.md

@@ -0,0 +1,121 @@
+# DeepCaseCrafter
+
+Transform deeply nested object, array, Map, and Set keys between common case formats while preserving TypeScript type safety.
+
+## Features
+
+- 🚀 Supports transformations between `snake_case`, `camelCase`, `PascalCase`, and `kebab-case`.
+- 🔄 Recursively transforms deeply nested objects, arrays, Maps, and Sets.
+- ✅ Preserves TypeScript type inference for precise auto-completion.
+- 🔍 Detects preserved keys (those starting with special characters or numbers, containing `--` or `__`).
+- ⚡ Customizable recursion depth (defaults to 3).
+- 🔥 Optimized for performance with minimal overhead.
+- 📦 Lightweight bundle size (~27.33 KB).
+
+## Installation
+
+```bash
+npm install deep-case-crafter
+```
+
+## Usage
+
+### Transforming an Object
+
+```typescript
+import transform from 'deep-case-crafter';
+
+const input = { user_id: 1, first_name: 'John' };
+const result = transform(input, { targetCase: 'camel', sourceCase: 'snake' });
+
+console.log(result);
+// Output: { userId: 1, firstName: 'John' }
+```
+
+### Transforming Deeply Nested Data
+
+```typescript
+const nestedInput = {
+  user_info: { first_name: 'John', last_name: 'Doe' },
+  posts: [{ post_id: 1, post_title: 'Hello' }],
+};
+
+const transformed = transform(nestedInput, { targetCase: 'camel' });
+
+// Output:
+// {
+//   userInfo: { firstName: 'John', lastName: 'Doe' },
+//   posts: [{ postId: 1, postTitle: 'Hello' }]
+// }
+```
+
+### Transforming a Map
+
+```typescript
+const mapInput = new Map([
+  ['user_id', 1],
+  ['first_name', 'John'],
+]);
+
+const result = transform(mapInput, {
+  targetCase: 'camel',
+  sourceCase: 'snake',
+});
+
+console.log(result.get('userId')); // 1
+console.log(result.get('firstName')); // 'John'
+```
+
+### Transforming a Set
+
+```typescript
+const setInput = new Set(['user_id', 'first_name']);
+const result = transform(setInput, {
+  targetCase: 'camel',
+  sourceCase: 'snake',
+});
+
+console.log(result); // Set { 'userId', 'firstName' }
+```
+
+## API
+
+### `transform(data, options)`
+
+- **data**: The data structure to transform (`object`, `array`, `Map`, or `Set`).
+- **options**:
+  - `targetCase` (optional): `'camel' | 'snake' | 'pascal' | 'kebab'` **defaults** to `'camel'`
+  - `sourceCase` (optional): Specify the source case for better type inference.
+  - `depth` (optional): Specify recursion depth (default is 3).
+
+### Preserved Keys
+
+Keys are automatically preserved (not transformed) if:
+
+- They start with a special character or number.
+- They contain `__` or `--`.
+- Numbers at the end are allowed.
+
+### Case Detection
+
+- Runtime case detection is **always** performed for each key.
+- Specifying `sourceCase` enhances TypeScript type inference but does not influence runtime detection.
+
+## Performance Considerations
+
+- **Default Depth**: 3 levels deep to avoid unnecessary processing.
+- **Custom Depth**: Set `depth` to control recursion. Use `Infinity` for full recursion.
+- **Lightweight**: The bundle size is approximately **27.33 KB**.
+- **Benchmarks**: Transform Deep Object (Depth 5, Width 10) x 361,538 ops/sec ±0.12% (91 runs sampled)
+  Fastest is Transform Deep Object (Depth 5, Width 10)
+
+## Contribution
+
+1. Fork the repository.
+2. Create a new branch.
+3. Commit your changes.
+4. Submit a pull request.
+
+## License
+
+MIT