inflekt

Author: pyramation

packages/inflection/README.md

@@ -1,11 +1,26 @@
-# @interweb/inflection
-
-Inflection utilities for pluralization and singularization with PostGraphile-compatible Latin suffix handling.
+# inflekt
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" height="250">
+  <br />
+    <strong>smart pluralization and inflection for the modern web</strong>
+  <br />
+  <br />
+  Inflection utilities for pluralization and singularization with PostGraphile-compatible Latin suffix handling
+  <br />
+  <br />
+  <a href="https://github.com/constructive-io/dev-utils/actions/workflows/ci.yml">
+    <img height="20" src="https://github.com/constructive-io/dev-utils/actions/workflows/ci.yml/badge.svg" />
+  </a>
+  <a href="https://github.com/constructive-io/dev-utils/blob/main/LICENSE">
+    <img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/>
+  </a>
+</p>
 
 ## Installation
 
 ```bash
-npm install @interweb/inflection
+npm install inflekt
 ```
 
 ## Usage
@@ -19,9 +34,16 @@ import {
   distinctPluralize,
   lcFirst,
   ucFirst,
+  camelize,
+  underscore,
+  toPascalCase,
+  toCamelCase,
+  toSnakeCase,
+  toKebabCase,
+  toConstantCase,
   toFieldName,
   toQueryName,
-} from '@interweb/inflection';
+} from 'inflekt';
 
 // Basic singularization/pluralization
 singularize('Users');     // 'User'
@@ -36,10 +58,22 @@ singularize('Media');     // 'Medium'
 singularizeLast('UserProfiles');  // 'UserProfile'
 pluralizeLast('UserProfile');     // 'UserProfiles'
 
-// Case transformations
+// First character case transformations
 lcFirst('UserProfile');   // 'userProfile'
 ucFirst('userProfile');   // 'UserProfile'
 
+// Snake case / camel case conversions
+camelize('user_profile');       // 'UserProfile'
+camelize('user_profile', true); // 'userProfile'
+underscore('UserProfile');      // 'user_profile'
+
+// Full case transformations (re-exported from komoji)
+toPascalCase('hello-world');      // 'HelloWorld'
+toCamelCase('hello-world');       // 'helloWorld'
+toSnakeCase('helloWorld');        // 'hello_world'
+toKebabCase('HelloWorld');        // 'hello-world'
+toConstantCase('helloWorld');     // 'HELLO_WORLD'
+
 // GraphQL naming helpers
 toFieldName('Users');     // 'user'
 toQueryName('User');      // 'users'
@@ -60,7 +94,14 @@ toQueryName('User');      // 'users'
 
 - `lcFirst(str)` - Convert first character to lowercase (PascalCase to camelCase)
 - `ucFirst(str)` - Convert first character to uppercase (camelCase to PascalCase)
+- `camelize(str, lowFirstLetter?)` - Convert snake_case to PascalCase (or camelCase if lowFirstLetter is true)
+- `underscore(str)` - Convert PascalCase/camelCase to snake_case
 - `fixCapitalisedPlural(str)` - Fix capitalized S after numbers (e.g., `Table1S` -> `Table1s`)
+- `toPascalCase(str)` - Convert to PascalCase (re-exported from komoji)
+- `toCamelCase(str)` - Convert to camelCase (re-exported from komoji)
+- `toSnakeCase(str)` - Convert to snake_case (re-exported from komoji)
+- `toKebabCase(str)` - Convert to kebab-case (re-exported from komoji)
+- `toConstantCase(str)` - Convert to CONSTANT_CASE (re-exported from komoji)
 
 ### Naming Helpers
 

packages/inflection/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@interweb/inflection",
+  "name": "inflekt",
   "version": "0.0.1",
   "description": "Inflection utilities for pluralization and singularization with PostGraphile-compatible Latin suffix handling",
   "author": "Constructive <developers@constructive.io>",
@@ -26,6 +26,7 @@
     "url": "https://github.com/constructive-io/dev-utils"
   },
   "keywords": [
+    "inflekt",
     "inflection",
     "pluralize",
     "singularize",
@@ -40,6 +41,7 @@
     "makage": "0.1.8"
   },
   "dependencies": {
-    "inflection": "^3.0.0"
+    "inflection": "^3.0.0",
+    "komoji": "workspace:^"
   }
 }

packages/inflection/src/case.ts

@@ -1,7 +1,13 @@
 /**
  * Case transformation utilities
  */
-import * as inflection from 'inflection';
+export {
+  toPascalCase,
+  toCamelCase,
+  toSnakeCase,
+  toKebabCase,
+  toConstantCase,
+} from 'komoji';
 
 /**
  * Convert PascalCase to camelCase (lowercase first character)
@@ -11,25 +17,6 @@ export function lcFirst(str: string): string {
   return str.charAt(0).toLowerCase() + str.slice(1);
 }
 
-/**
- * Convert a string to camelCase
- * @param str - The string to convert
- * @param lowFirstLetter - If true, the first letter will be lowercase (default: false)
- * @example camelize("user_profile") -> "UserProfile"
- * @example camelize("user_profile", true) -> "userProfile"
- */
-export function camelize(str: string, lowFirstLetter?: boolean): string {
-  return inflection.camelize(str, lowFirstLetter);
-}
-
-/**
- * Convert a camelCase or PascalCase string to snake_case
- * @example underscore("UserProfile") -> "user_profile"
- */
-export function underscore(str: string): string {
-  return inflection.underscore(str);
-}
-
 /**
  * Convert camelCase to PascalCase (uppercase first character)
  * @example "userProfile" -> "UserProfile"
@@ -46,3 +33,34 @@ export function ucFirst(str: string): string {
 export function fixCapitalisedPlural(str: string): string {
   return str.replace(/[0-9]S(?=[A-Z]|$)/g, (match) => match.toLowerCase());
 }
+
+/**
+ * Convert snake_case to PascalCase (or camelCase if lowFirstLetter is true)
+ * @param str - The snake_case string to convert
+ * @param lowFirstLetter - If true, returns camelCase instead of PascalCase
+ * @example camelize('user_profile') -> 'UserProfile'
+ * @example camelize('user_profile', true) -> 'userProfile'
+ */
+export function camelize(str: string, lowFirstLetter?: boolean): string {
+  const result = str
+    .split('_')
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join('');
+
+  if (lowFirstLetter) {
+    return lcFirst(result);
+  }
+  return result;
+}
+
+/**
+ * Convert PascalCase or camelCase to snake_case
+ * @example underscore('UserProfile') -> 'user_profile'
+ * @example underscore('userProfile') -> 'user_profile'
+ */
+export function underscore(str: string): string {
+  return str
+    .replace(/([A-Z])/g, '_$1')
+    .replace(/^_/, '')
+    .toLowerCase();
+}