Text Utilities

import { toTitleCase, slugify, truncate, compareStrings, expandAbbreviation, maskText, toCamelCase } from '@indodev/toolkit/text';
 
// Title Case
console.log(toTitleCase('laskar pelangi: kisah nyata'));
// 'Laskar Pelangi: Kisah Nyata'
 
// Slug
console.log(slugify('Baju Pria & Wanita'));
// 'baju-pria-dan-wanita'
 
// Truncate
console.log(truncate('Ini adalah text yang sangat panjang', 20));
// 'Ini adalah text...'
 
// Comparison
console.log(compareStrings('surabaya', 'SURABAYA'));
// true
 
// Abbreviation
console.log(expandAbbreviation('Jl. Sudirman No. 1'));
// 'Jalan Sudirman Nomor 1'
 
// Mask Text
console.log(maskText('08123456789', { pattern: 'middle', visibleStart: 4, visibleEnd: 3 }));
// '0812***6789'
 
// Case Converters
console.log(toCamelCase('hello-world'));
// 'helloWorld'
 
// Profanity Filter
console.log(profanityFilter('jangan bicara kasar anjing'));
// 'jangan bicara kasar ******'
 
// Stopwords Removal
console.log(removeStopwords('saya sedang makan nasi'));
// 'makan nasi'
 
// Normalization
console.log(toFormal('gw pen makan nih'));
// 'saya ingin makan ini'

function toTitleCase(text: string, options?: TitleCaseOptions): string;

// Basic usage
toTitleCase('buku panduan belajar di rumah');
// 'Buku Panduan Belajar di Rumah' (particle 'di' is lowercase)
 
// With acronyms
toTitleCase('laporan tahunan pt maju jaya');
// 'Laporan Tahunan PT Maju Jaya' ('PT' is recognized acronym)
 
// Sentences
toTitleCase('ibu pergi ke pasar');
// 'Ibu Pergi ke Pasar'

function expandAbbreviation(text: string, options?: ExpandOptions): string;

// Address expansion
expandAbbreviation('Jl. Merdeka No. 45');
// 'Jalan Merdeka Nomor 45'
 
// Title expansion
expandAbbreviation('Prof. Dr. Habibie');
// 'Profesor Doktor Habibie'
 
// Specific mode
expandAbbreviation('Dr. di Jl. Sudirman', { mode: 'address' });
// 'Dr. di Jalan Sudirman' (only expands address)

function contractAbbreviation(text: string, options?: ExpandOptions): string;

contractAbbreviation('Jalan Jenderal Sudirman');
// 'Jl. Jenderal Sudirman'
 
contractAbbreviation('Profesor Doktor');
// 'Prof. Dr.'

function toFormal(text: string): string;

toFormal('gw pen makan nih'); // 'saya ingin makan ini'
toFormal('aq msh di jln'); // 'saya masih di jalan'
toFormal('gpp bsk aja'); // 'tidak apa-apa besok saja'

function isAlay(text: string): boolean;

isAlay('4p4 k4b4r?'); // ✅ true
isAlay('Apa kabar?'); // ❌ false

function slugify(text: string, options?: SlugifyOptions): string;

// Basic usage
slugify('Cara Membuat Website');
// 'cara-membuat-website'
 
// Handling conjunctions
slugify('Pria & Wanita');
// 'pria-dan-wanita' (ampersand converted to 'dan')
 
slugify('Hitam/Putih');
// 'hitam-atau-putih' (slash converted to 'atau')
 
// Custom separator
slugify('Halo Dunia', { separator: '_' });
// 'halo_dunia'

function truncate(text: string, maxLength: number, options?: TruncateOptions): string;

const text = 'Ini adalah kalimat yang cukup panjang';
 
// Smart cut (word boundary)
truncate(text, 15);
// 'Ini adalah...'
 
// Custom ellipsis
truncate(text, 15, { ellipsis: '…' });
// 'Ini adalah…'
 
// Force cut (ignore word boundary)
truncate(text, 10, { wordBoundary: false });
// 'Ini adalah...' (might cut mid-word depending on length)

function extractWords(text: string, options?: ExtractOptions): string[];

extractWords('Anak-anak bermain bola!');
// ['Anak-anak', 'bermain', 'bola'] (keeps 'Anak-anak' together)
 
extractWords('Halo, apa kabar?', { lowercase: true });
// ['halo', 'apa', 'kabar']

function compareStrings(str1: string, str2: string, options?: CompareOptions): boolean;

interface CompareOptions {
  caseSensitive?: boolean; // default: false
  ignoreWhitespace?: boolean; // default: false
  ignoreAccents?: boolean; // default: false
}

// Case insensitive (default)
compareStrings('Jakarta', 'jakarta');
// true
 
// Ignore whitespace
compareStrings('  Surabaya  ', 'Surabaya', { ignoreWhitespace: true });
// true
 
// Ignore accents
compareStrings('Café', 'Cafe', { ignoreAccents: true });
// true

function similarity(str1: string, str2: string): number;

similarity('Jakarta', 'Jakarta'); // 1.0
similarity('Jakarta', 'Jakart'); // 0.85
similarity('Jakarta', 'Bandung'); // 0.14

function sanitize(text: string, options?: SanitizeOptions): string;

sanitize('  Halo   Dunia  '); // 'Halo Dunia'
sanitize('<b>Bold</b>', { stripHtml: true }); // 'Bold'

function removeAccents(text: string): string;

removeAccents('Café'); // 'Cafe'
removeAccents('Àpropos'); // 'Apropos'

function maskText(text: string, options?: MaskOptions): string;

interface MaskOptions {
  pattern?: 'all' | 'middle' | 'email';
  maskChar?: string;       // default: '*'
  visibleStart?: number;   // default: 2
  visibleEnd?: number;     // default: 2
}

// Mask all characters (preserves spaces)
maskText('Budi Santoso', { pattern: 'all' });
// '**** *******'
 
// Mask middle portion
maskText('08123456789', { pattern: 'middle', visibleStart: 4, visibleEnd: 3 });
// '0812****789'
 
// Mask email (keeps first 2 chars of local part + domain)
maskText('user@example.com', { pattern: 'email' });
// 'us**@example.com'
 
// Custom mask character
maskText('123456789', { pattern: 'all', maskChar: '#' });
// '#########'

function toCamelCase(text: string): string;

toCamelCase('hello-world');     // 'helloWorld'
toCamelCase('hello_world');     // 'helloWorld'
toCamelCase('Hello World');     // 'helloWorld'
toCamelCase('helloWorld');      // 'helloWorld'

function toPascalCase(text: string): string;

toPascalCase('hello_world');    // 'HelloWorld'
toPascalCase('hello-world');    // 'HelloWorld'
toPascalCase('hello world');    // 'HelloWorld'

function toSnakeCase(text: string): string;

toSnakeCase('helloWorld');      // 'hello_world'
toSnakeCase('Hello-World');     // 'hello_world'
toSnakeCase('Hello World');     // 'hello_world'

function countSyllables(text: string): number;

// Indonesian words
countSyllables('buku');         // 2 (bu-ku)
countSyllables('matahari');     // 4 (ma-ta-ha-ri)
countSyllables('pulau');        // 2 (pu-lau, dipthong 'au')
 
// English words
countSyllables('hello');        // 2 (hel-lo)
countSyllables('beautiful');    // 3 (beau-ti-ful)
 
// Edge cases
countSyllables('');             // 0
countSyllables('a');            // 1
countSyllables('rhythm');       // 1 (no vowels, minimum 1)

function profanityFilter(text: string, options?: FilterOptions): string;

profanityFilter('jangan bicara kasar anjing');
// 'jangan bicara kasar ******'
 
profanityFilter('kasar banget asu', { replacement: '---' });
// 'kasar banget ---'

function removeStopwords(text: string, language?: 'id' | 'en' | 'both'): string;

removeStopwords('saya sedang makan nasi');
// 'makan nasi'
 
removeStopwords('this is a book', 'en');
// 'book'

export interface TitleCaseOptions {
  /**
   * If true, keeps original casing for words not in the exception list.
   * @default false
   */
  preserveOriginal?: boolean;
}

export interface SlugifyOptions {
  /**
   * Separator character (e.g. '-', '_')
   * @default '-'
   */
  separator?: string;
  /**
   * Convert 'and' -> 'dan', '/' -> 'atau'
   * @default true
   */
  convertConjunctions?: boolean;
}

export interface TruncateOptions {
  /**
   * String to append when text is truncated.
   * @default '...'
   */
  ellipsis?: string;
  /**
   * Respect word boundaries (avoid cutting mid-word).
   * @default true
   */
  wordBoundary?: boolean;
}

export interface ExtractOptions {
  /**
   * Convert words to lowercase.
   * @default false
   */
  lowercase?: boolean;
  /**
   * remove punctuation marks.
   * @default true
   */
  removePunctuation?: boolean;
  /**
   * Minimum length of words to extract.
   * @default 1
   */
  minLength?: number;
}

export interface CompareOptions {
  /**
   * Perform case-sensitive comparison.
   * @default false
   */
  caseSensitive?: boolean;
  /**
   * Ignore leading/trailing whitespace.
   * @default false
   */
  ignoreWhitespace?: boolean;
  /**
   * Ignore diacritics/accents.
   * @default false
   */
  ignoreAccents?: boolean;
}

import { compareStrings } from '@indodev/toolkit/text';
 
function searchItems(items: string[], query: string) {
  return items.filter((item) =>
    compareStrings(item, query, {
      caseSensitive: false,
      ignoreWhitespace: true,
    })
  );
}

import { slugify } from '@indodev/toolkit/text';
 
function createBlogPostUrl(title: string) {
  const customSlug = slugify(title, {
    separator: '-',
    lowercase: true, // Ensure everything is lowercase for URLs
  });
  return `/blog/${customSlug}`;
}

import { toTitleCase, expandAbbreviation } from '@indodev/toolkit/text';
 
function formatAddress(rawAddress: string) {
  // 1. Expand abbreviations (Jl., Gg., No.)
  const expanded = expandAbbreviation(rawAddress, { mode: 'address' });
 
  // 2. Fix casing (Jalan Mawar Melati)
  return toTitleCase(expanded);
}
 
console.log(formatAddress('jl. mawar melati no. 5'));
// 'Jalan Mawar Melati Nomor 5'

const cleanInput = sanitize(userInput, { stripHtml: true });

const baseSlug = slugify(title);
let finalSlug = baseSlug;
let counter = 1;
while (await db.slugExists(finalSlug)) {
  finalSlug = `${baseSlug}-${counter++}`;
}