@insanedev2478/tstoolset 1.3.0 → 1.4.0

package/README.md

@@ -1,9 +1,9 @@
-# 🧰 **tstoolset**  
+# 🧰 **tstoolset**
+
 **Open-source**, **Zero‑runtime** TypeScript **utility types** for cleaner, safer, more expressive code. <br>
 ![npm version](https://img.shields.io/npm/v/@insanedev2478/tstoolset)
 ![license](https://img.shields.io/github/license/vedanshshetti/tstoolset)
 
-
 ---
 
 ## 🚀 Installation
@@ -23,12 +23,15 @@ npm install @insanedev2478/tstoolset
 - Exact object enforcement with `Exact<T>`
 - Safe assertion helper: `convert<T>(x)`
 - Zero runtime cost — pure TypeScript
+- Object schema merger with `Merge<A, B>`
+- snake_case to camelCase conversion with `CamelCase<string>`
 
 ---
 
 ## 📦 Usage
 
 ### **Primitive & container helpers**
+
 ```ts
 import type { String, Obj, Arr } from "@insanedev2478/tstoolset";
 
@@ -37,24 +40,40 @@ type Tags = Arr<String>;
 ```
 
 ### **Exact object enforcement**
+
 ```ts
 import type { Exact } from "@insanedev2478/tstoolset";
 
 type User = { id: string };
-const u: Exact<User> = { id: "123" };      // ok
-const x: Exact<User> = { id: "123", a: 1 } // ❌ extra key
+const u: Exact<User> = { id: "123" }; // ok
+const x: Exact<User> = { id: "123", a: 1 }; // ❌ extra key
 ```
 
-### **snake_case to camelCase**
+### snake_case to camelCase 🔁
+
 ```ts
 import type { CamelCase } from "@insanedev2478/tstoolset";
+import { convertToCamelCase } from "@insanedev2478/tstoolset";
 
-type User = { id: string };
-const u: Exact<User> = { id: "123" };      // ok
-const x: Exact<User> = { id: "123", a: 1 } // ❌ extra key
+// Type-level examples:
+type A = CamelCase<"snake_case">; // 'snakeCase'
+type B = CamelCase<"multi_part_name">; // 'multiPartName'
+type C = CamelCase<"alreadyCamel">; // 'alreadyCamel'
+
+// Using a literal (type-level):
+const s = "hello_world" as const;
+type S = CamelCase<typeof s>; // 'helloWorld'
+
+// Runtime helper `convertToCamelCase` preserves the typed relationship when used with literal types
+const r = convertToCamelCase(s); // 'helloWorld' (type: CamelCase<typeof s>)
+
+// It also handles dashes and spaces, and collapses multiple separators:
+const r2 = convertToCamelCase("multi-part name" as const); // 'multiPartName'
+const r3 = convertToCamelCase("alreadyCamel" as const); // 'alreadyCamel'
 ```
 
 ### **Nominal typing**
+
 ```ts
 import type { Brand } from "@insanedev2478/tstoolset";
 
@@ -64,20 +83,21 @@ const id: UserId = "abc" as UserId;
 ```
 
 ### **Merge**
+
 ```ts
 import type { Merge } from "@insanedev2478/tstoolset";
 type A = { id: string; name: string };
 type B = { id: number; admin: boolean };
 
 const merged: Merge<A, B> = {
-  id: 123,        // overridden by B
+  id: 123, // overridden by B
   name: "John",
-  admin: true
+  admin: true,
 };
-
 ```
 
 ### **UUID & Email template types**
+
 ```ts
 import type { UUIDV4, TrustableEmail } from "@insanedev2478/tstoolset";
 
@@ -86,6 +106,7 @@ const email: TrustableEmail = "user@gmail.com";
 ```
 
 ### **Safe converter**
+
 ```ts
 import { convert } from "@insanedev2478/tstoolset";
 
@@ -98,13 +119,14 @@ const fn = convert<(...args: any[]) => void>(() => {});
 
 - Deep utilities (`DeepPartial`, `DeepReadonly`, `DeepRequired`)
 - JSON‑safe types (`JsonValue`, `JsonObject`)
-- String manipulation types (`CamelCase`, `KebabCase`)
+- String manipulation types (`KebabCase`, `snake-case`)
 - Schema‑style helpers
 - More branded primitives
 
 ---
 
 ## 🤝 Contributing
+
 I am still a 6th grader, so new releases will only be on weekends, but <br>
 issues, ideas, and PRs are welcome — this project is growing fast and feedback helps shape the toolkit.
 

package/dist/index.d.ts

@@ -27,9 +27,10 @@ export type Brand<T, Name> = T & {
     [brand]: Name;
 };
 type ConvertableTypes = Primitive | Obj | Arr | Func | TrustableEmail | UUIDV4;
-export declare function convert<T extends ConvertableTypes>(x: unknown): T;
 export type Merge<A, B> = {
     [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;
 };
-export type CamelCase<S extends string> = S extends `${infer Head}_${infer Tail}` ? `${Head}${CamelCase<Capitalize<Tail>>}` : S;
+export type CamelCase<S extends string> = S extends `${infer Head}_${infer Tail}` ? `${Head}${CamelCase<Capitalize<Tail>>}` : S extends `${infer Head}-${infer Tail}` ? `${Head}${CamelCase<Capitalize<Tail>>}` : S extends `${infer Head} ${infer Tail}` ? `${Head}${CamelCase<Capitalize<Tail>>}` : S;
+export declare function convert<T extends ConvertableTypes>(x: unknown): T;
+export declare function convertToCamelCase<S extends string>(str: S): CamelCase<S>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insanedev2478/tstoolset",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Collection of handy TypeScript types, ranging from primitives like numbers all the way to UUIDs and Email Addresses. ",
   "license": "MIT",
   "type": "module",
@@ -16,8 +16,7 @@
   ],
   "scripts": {
     "build": "tsc --emitDeclarationOnly --declaration --outDir dist ./src/index.ts",
-    "prepublishOnly": "npm run build",
-    "github:commit": "git add . && git commit -m \"Added new script to package.json\""
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "typescript",