Perkenalan @wahyunf/string-utils - Package NPM untuk Manipulasi String

Saya dengan senang hati memperkenalkan package NPM terbaru saya, @wahyunf/string-utils, sebuah koleksi utilitas JavaScript yang dirancang untuk memudahkan manipulasi string dalam proyek Anda.

Apa itu @wahyunf/string-utils?

@wahyunf/string-utils adalah package NPM yang menyediakan berbagai fungsi utilitas untuk manipulasi string dalam JavaScript/TypeScript. Package ini dibuat untuk menyederhanakan pekerjaan sehari-hari developer dalam menangani operasi string yang umum digunakan.

Fitur Utama

Package ini menyediakan berbagai fungsi utilitas yang dapat membantu Anda dalam:

1. Transformasi Kasus

• capitalizeFirstLetter: Mengubah huruf pertama dari string menjadi huruf besar
• toCamelCase: Mengonversi string menjadi format camelCase
• toSnakeCase: Mengonversi string menjadi format snake_case
• toKebabCase: Mengonversi string menjadi format kebab-case
• toPascalCase: Mengonversi string menjadi format PascalCase

2. Manipulasi String

• reverseString: Membalik urutan karakter dalam string
• truncateString: Memotong string hingga panjang tertentu dan menambahkan elipsis jika diperlukan
• removeWhitespace: Menghapus semua spasi dari string
• removeSpecialCharacters: Menghapus karakter khusus dari string

3. Validasi String

• isValidString: Memastikan input adalah string yang valid
• isEmpty: Mengecek apakah string kosong atau tidak

4. Normalisasi String

• normalizeString: Menghapus spasi berlebih dan menormalkan string
• slugify: Mengonversi string menjadi format URL-friendly

Instalasi

Untuk mulai menggunakan @wahyunf/string-utils, instal package ini melalui npm:

npm install @wahyunf/string-utils

Atau jika Anda menggunakan yarn:

yarn add @wahyunf/string-utils

Penggunaan

Berikut adalah contoh penggunaan beberapa fungsi yang tersedia:

Import Package

// ES6 Modules
import { 
  capitalizeFirstLetter, 
  toCamelCase, 
  toSnakeCase,
  reverseString,
  truncateString 
} from '@wahyunf/string-utils';

// CommonJS
const stringUtils = require('@wahyunf/string-utils');

Contoh Penggunaan

const text = "hello world";

// Capitalize first letter
console.log(capitalizeFirstLetter(text)); 
// Output: "Hello world"

// Convert to camelCase
console.log(toCamelCase(text)); 
// Output: "helloWorld"

// Convert to snake_case
console.log(toSnakeCase(text)); 
// Output: "hello_world"

// Convert to kebab-case
console.log(toKebabCase(text)); 
// Output: "hello-world"

// Reverse string
console.log(reverseString(text)); 
// Output: "dlrow olleh"

// Truncate string
console.log(truncateString(text, 5)); 
// Output: "hello..."

Contoh Penggunaan dalam Proyek Real

import { toCamelCase, toSnakeCase } from '@wahyunf/string-utils';

// Mengonversi nama field dari database ke format camelCase untuk frontend
const dbField = "user_name";
const frontendField = toCamelCase(dbField); // "userName"

// Mengonversi nama komponen ke format kebab-case untuk URL
const componentName = "UserProfile";
const routePath = toKebabCase(componentName); // "user-profile"

Keunggulan Package

1. Ringan dan Tanpa Ketergantungan

Package ini dikembangkan tanpa ketergantungan eksternal, memastikan performa optimal dan ukuran yang kecil. Ini membuat aplikasi Anda tetap ringan dan cepat.

2. Mudah Digunakan

API yang sederhana dan intuitif memudahkan integrasi ke dalam proyek Anda. Tidak perlu mempelajari dokumentasi yang kompleks, cukup import dan gunakan.

3. TypeScript Support

Package ini dilengkapi dengan definisi TypeScript, sehingga Anda mendapatkan autocomplete dan type checking yang lengkap saat menggunakan TypeScript.

4. Kompatibilitas Luas

Dapat digunakan dalam berbagai lingkungan JavaScript, termasuk:

• Node.js
• Browser (dengan bundler seperti Webpack, Vite, atau Rollup)
• React, Vue, Angular, dan framework lainnya

5. Open Source

Package ini bersifat open source dan tersedia di GitHub, sehingga Anda dapat berkontribusi atau melihat source code-nya.

Kapan Menggunakan Package Ini?

Package ini sangat berguna ketika Anda:

• Mengonversi format string: Saat perlu mengubah format string dari satu konvensi ke konvensi lain (camelCase, snake_case, kebab-case, dll)
• Memproses input pengguna: Saat perlu memvalidasi atau menormalkan input dari pengguna
• Membangun API: Saat perlu mengonversi nama field antara frontend dan backend
• Mengembangkan aplikasi web: Saat perlu memanipulasi string untuk URL, slug, atau format lainnya

Kontribusi

Saya mengundang Anda untuk berkontribusi dalam pengembangan package ini. Jika Anda memiliki:

• Saran fitur baru: Ide untuk menambahkan fungsi utilitas baru
• Bug report: Jika menemukan bug atau masalah
• Improvement: Saran untuk meningkatkan performa atau kualitas code

Silakan ajukan issue atau pull request di repositori GitHub.

Kesimpulan

@wahyunf/string-utils adalah package yang dirancang untuk menyederhanakan manipulasi string dalam proyek JavaScript/TypeScript Anda. Dengan berbagai fungsi utilitas yang tersedia, Anda dapat menghemat waktu dan mengurangi boilerplate code dalam proyek Anda.

Package ini terus dikembangkan dan diperbarui untuk memberikan pengalaman terbaik bagi developer. Jika Anda tertarik untuk menggunakan atau berkontribusi, silakan kunjungi:

• NPM: https://www.npmjs.com/package/@wahyunf/string-utils
• GitHub: https://github.com/wahyunf/string-utils

Dengan @wahyunf/string-utils, manipulasi string menjadi lebih mudah dan efisien. Selamat mencoba!