string-kit-js/README.md

[](https://www.npmjs.com/package/string-kit-js) [](https://opensource.org/licenses/MIT)

# string-kit-js
[![npm version](https://img.shields.io/npm/v/string-kit-js.svg)](https://www.npmjs.com/package/string-kit-js)
[![License](https://img.shields.io/npm/l/string-kit-js.svg)](https://opensource.org/licenses/MIT)


Simple string utility functions for JavaScript/Node.js

## Install
```bash
npm install string-kit-js
```

## Usage
```bash
const {
  isBlank,
  isNotBlank,
  isEmpty,
  isNotEmpty,
  equals,
  equalsIgnoreCase,
  contains,
  startsWith,
  endsWith,
  toUpper,
  toLower,
  capitalize,
  ...
} = require("string-kit-js");

// ===== Check blank =====
console.log("isBlank(null)            ->", isBlank(null));       // true
console.log('isBlank("   ")           ->', isBlank("   "));      // true
console.log('isNotBlank("abc")        ->', isNotBlank("abc"));   // true

// ===== Empty check =====
console.log('isEmpty("")              ->', isEmpty(""));         // true
console.log('isNotEmpty("abc")        ->', isNotEmpty("abc"));   // true

// ===== Equals =====
console.log('equals("a", "a")         ->', equals("a", "a"));    // true
console.log('equalsIgnoreCase("abc", "ABC") ->', equalsIgnoreCase("abc", "ABC")); // true

// ===== String contains =====
console.log('contains("hello world", "world") ->', contains("hello world", "world")); // true
console.log('startsWith("hello", "he") ->', startsWith("hello", "he")); // true
console.log('endsWith("hello", "lo")   ->', endsWith("hello", "lo"));   // true

// ===== Transform =====
console.log('toUpper("hello")         ->', toUpper("hello"));    // "HELLO"
console.log('toLower("WORLD")         ->', toLower("WORLD"));    // "world"
console.log('capitalize("hello")      ->', capitalize("hello")); // "Hello"

// ===== Default value =====
console.log('defaultIfBlank("   ", "default")  ->', defaultIfBlank("   ", "default")); // "default"
console.log('defaultIfEmpty("", "fallback")    ->', defaultIfEmpty("", "fallback"));   // "fallback"

// ===== Substring helpers =====
console.log('substringBefore("abc:def", ":")   ->', substringBefore("abc:def", ":"));  // "abc"
console.log('substringAfter("abc:def", ":")    ->', substringAfter("abc:def", ":"));   // "def"

```