@indodev/toolkit 0.3.1 → 0.3.3

package/dist/text/index.d.cts

@@ -1,4 +1,202 @@
-export { C as CompareOptions, E as ExtractOptions, m as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, o as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, j as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../compare-CZadJMGl.cjs';
+import { M as MaskOptions } from '../compare-Ku_8OhuU.cjs';
+export { C as CompareOptions, E as ExtractOptions, m as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, o as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, j as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../compare-Ku_8OhuU.cjs';
+
+/**
+ * Mask sensitive text based on predefined patterns or custom configuration
+ *
+ * This function provides privacy-compliant data display by masking portions
+ * of text while keeping certain parts visible. Supports multiple masking
+ * patterns for different use cases.
+ *
+ * **Available Patterns:**
+ * - `all`: Masks all characters (preserves spaces)
+ * - `middle`: Keeps start and end characters visible, masks the middle
+ * - `email`: Keeps first 2 chars of local part and full domain visible
+ *
+ * @param text - The text to mask
+ * @param options - Masking configuration options
+ * @returns The masked text
+ *
+ * @example
+ * Mask all characters:
+ * ```typescript
+ * maskText('Budi Santoso', { pattern: 'all' })
+ * // → '**** *******'
+ *
+ * maskText('123456789', { pattern: 'all', maskChar: '#' })
+ * // → '#########'
+ * ```
+ *
+ * @example
+ * Mask middle portion:
+ * ```typescript
+ * maskText('08123456789', { pattern: 'middle', visibleStart: 4, visibleEnd: 3 })
+ * // → '0812****789'
+ *
+ * maskText('ABCDEF', { pattern: 'middle' })
+ * // → 'AB**EF' (defaults: visibleStart=2, visibleEnd=2)
+ * ```
+ *
+ * @example
+ * Mask email:
+ * ```typescript
+ * maskText('user@example.com', { pattern: 'email' })
+ * // → 'us**@example.com'
+ *
+ * maskText('a@test.com', { pattern: 'email' })
+ * // → 'a*@test.com'
+ * ```
+ *
+ * @example
+ * Edge cases:
+ * ```typescript
+ * maskText('')
+ * // → ''
+ *
+ * maskText('AB', { pattern: 'middle', visibleStart: 2, visibleEnd: 2 })
+ * // → '**' (string too short, mask all)
+ * ```
+ *
+ * @public
+ */
+declare function maskText(text: string, options?: MaskOptions): string;
+
+/**
+ * Convert text to camelCase
+ *
+ * Treats spaces, hyphens, and underscores as word boundaries.
+ * Strips all other special characters. First word is lowercase.
+ *
+ * @param text - The text to convert
+ * @returns camelCase string
+ *
+ * @example
+ * ```typescript
+ * toCamelCase('hello-world')
+ * // → 'helloWorld'
+ *
+ * toCamelCase('hello_world')
+ * // → 'helloWorld'
+ *
+ * toCamelCase('Hello World')
+ * // → 'helloWorld'
+ *
+ * toCamelCase('')
+ * // → ''
+ * ```
+ *
+ * @public
+ */
+declare function toCamelCase(text: string): string;
+/**
+ * Convert text to PascalCase
+ *
+ * Treats spaces, hyphens, and underscores as word boundaries.
+ * Strips all other special characters. Every word is capitalized.
+ *
+ * @param text - The text to convert
+ * @returns PascalCase string
+ *
+ * @example
+ * ```typescript
+ * toPascalCase('hello_world')
+ * // → 'HelloWorld'
+ *
+ * toPascalCase('hello-world')
+ * // → 'HelloWorld'
+ *
+ * toPascalCase('hello world')
+ * // → 'HelloWorld'
+ *
+ * toPascalCase('')
+ * // → ''
+ * ```
+ *
+ * @public
+ */
+declare function toPascalCase(text: string): string;
+/**
+ * Convert text to snake_case
+ *
+ * Treats spaces, hyphens, and camelCase boundaries as word separators.
+ * Strips all other special characters. All lowercase with underscores.
+ *
+ * @param text - The text to convert
+ * @returns snake_case string
+ *
+ * @example
+ * ```typescript
+ * toSnakeCase('helloWorld')
+ * // → 'hello_world'
+ *
+ * toSnakeCase('Hello-World')
+ * // → 'hello_world'
+ *
+ * toSnakeCase('Hello World')
+ * // → 'hello_world'
+ *
+ * toSnakeCase('')
+ * // → ''
+ * ```
+ *
+ * @public
+ */
+declare function toSnakeCase(text: string): string;
+
+/**
+ * Count the number of syllables in an Indonesian word
+ *
+ * Uses algorithm-based vowel counting with Indonesian dipthong awareness.
+ * Works for both Indonesian and English text.
+ *
+ * **Syllable Detection Rules:**
+ * - Each vowel group (a, i, u, e, o) counts as one syllable
+ * - Dipthongs (ai, au, oi) count as a single vowel sound
+ * - Silent 'e' at the end is handled
+ * - Minimum 1 syllable for any word with letters
+ *
+ * @param text - The word or text to count syllables in
+ * @returns The number of syllables
+ *
+ * @example
+ * Indonesian words:
+ * ```typescript
+ * countSyllables('buku')
+ * // → 2 (bu-ku)
+ *
+ * countSyllables('matahari')
+ * // → 4 (ma-ta-ha-ri)
+ *
+ * countSyllables('pulau')
+ * // → 2 (pu-lau, dipthong 'au' counts as one)
+ * ```
+ *
+ * @example
+ * English words:
+ * ```typescript
+ * countSyllables('hello')
+ * // → 2 (hel-lo)
+ *
+ * countSyllables('beautiful')
+ * // → 3 (beau-ti-ful)
+ * ```
+ *
+ * @example
+ * Edge cases:
+ * ```typescript
+ * countSyllables('')
+ * // → 0
+ *
+ * countSyllables('a')
+ * // → 1
+ *
+ * countSyllables('rhythm')
+ * // → 1 (no vowels, minimum 1)
+ * ```
+ *
+ * @public
+ */
+declare function countSyllables(text: string): number;
 
 /**
  * ============================================================================
@@ -281,4 +479,4 @@ declare const ACRONYMS: readonly ["DKI", "DIY", "TNI", "POLRI", "ABRI", "MPR", "
  */
 declare const ABBREVIATIONS: Record<string, string>;
 
-export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS };
+export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, MaskOptions, countSyllables, maskText, toCamelCase, toPascalCase, toSnakeCase };

package/dist/text/index.d.ts

@@ -1,4 +1,202 @@
-export { C as CompareOptions, E as ExtractOptions, m as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, o as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, j as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../compare-CZadJMGl.js';
+import { M as MaskOptions } from '../compare-Ku_8OhuU.js';
+export { C as CompareOptions, E as ExtractOptions, m as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, o as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, j as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../compare-Ku_8OhuU.js';
+
+/**
+ * Mask sensitive text based on predefined patterns or custom configuration
+ *
+ * This function provides privacy-compliant data display by masking portions
+ * of text while keeping certain parts visible. Supports multiple masking
+ * patterns for different use cases.
+ *
+ * **Available Patterns:**
+ * - `all`: Masks all characters (preserves spaces)
+ * - `middle`: Keeps start and end characters visible, masks the middle
+ * - `email`: Keeps first 2 chars of local part and full domain visible
+ *
+ * @param text - The text to mask
+ * @param options - Masking configuration options
+ * @returns The masked text
+ *
+ * @example
+ * Mask all characters:
+ * ```typescript
+ * maskText('Budi Santoso', { pattern: 'all' })
+ * // → '**** *******'
+ *
+ * maskText('123456789', { pattern: 'all', maskChar: '#' })
+ * // → '#########'
+ * ```
+ *
+ * @example
+ * Mask middle portion:
+ * ```typescript
+ * maskText('08123456789', { pattern: 'middle', visibleStart: 4, visibleEnd: 3 })
+ * // → '0812****789'
+ *
+ * maskText('ABCDEF', { pattern: 'middle' })
+ * // → 'AB**EF' (defaults: visibleStart=2, visibleEnd=2)
+ * ```
+ *
+ * @example
+ * Mask email:
+ * ```typescript
+ * maskText('user@example.com', { pattern: 'email' })
+ * // → 'us**@example.com'
+ *
+ * maskText('a@test.com', { pattern: 'email' })
+ * // → 'a*@test.com'
+ * ```
+ *
+ * @example
+ * Edge cases:
+ * ```typescript
+ * maskText('')
+ * // → ''
+ *
+ * maskText('AB', { pattern: 'middle', visibleStart: 2, visibleEnd: 2 })
+ * // → '**' (string too short, mask all)
+ * ```
+ *
+ * @public
+ */
+declare function maskText(text: string, options?: MaskOptions): string;
+
+/**
+ * Convert text to camelCase
+ *
+ * Treats spaces, hyphens, and underscores as word boundaries.
+ * Strips all other special characters. First word is lowercase.
+ *
+ * @param text - The text to convert
+ * @returns camelCase string
+ *
+ * @example
+ * ```typescript
+ * toCamelCase('hello-world')
+ * // → 'helloWorld'
+ *
+ * toCamelCase('hello_world')
+ * // → 'helloWorld'
+ *
+ * toCamelCase('Hello World')
+ * // → 'helloWorld'
+ *
+ * toCamelCase('')
+ * // → ''
+ * ```
+ *
+ * @public
+ */
+declare function toCamelCase(text: string): string;
+/**
+ * Convert text to PascalCase
+ *
+ * Treats spaces, hyphens, and underscores as word boundaries.
+ * Strips all other special characters. Every word is capitalized.
+ *
+ * @param text - The text to convert
+ * @returns PascalCase string
+ *
+ * @example
+ * ```typescript
+ * toPascalCase('hello_world')
+ * // → 'HelloWorld'
+ *
+ * toPascalCase('hello-world')
+ * // → 'HelloWorld'
+ *
+ * toPascalCase('hello world')
+ * // → 'HelloWorld'
+ *
+ * toPascalCase('')
+ * // → ''
+ * ```
+ *
+ * @public
+ */
+declare function toPascalCase(text: string): string;
+/**
+ * Convert text to snake_case
+ *
+ * Treats spaces, hyphens, and camelCase boundaries as word separators.
+ * Strips all other special characters. All lowercase with underscores.
+ *
+ * @param text - The text to convert
+ * @returns snake_case string
+ *
+ * @example
+ * ```typescript
+ * toSnakeCase('helloWorld')
+ * // → 'hello_world'
+ *
+ * toSnakeCase('Hello-World')
+ * // → 'hello_world'
+ *
+ * toSnakeCase('Hello World')
+ * // → 'hello_world'
+ *
+ * toSnakeCase('')
+ * // → ''
+ * ```
+ *
+ * @public
+ */
+declare function toSnakeCase(text: string): string;
+
+/**
+ * Count the number of syllables in an Indonesian word
+ *
+ * Uses algorithm-based vowel counting with Indonesian dipthong awareness.
+ * Works for both Indonesian and English text.
+ *
+ * **Syllable Detection Rules:**
+ * - Each vowel group (a, i, u, e, o) counts as one syllable
+ * - Dipthongs (ai, au, oi) count as a single vowel sound
+ * - Silent 'e' at the end is handled
+ * - Minimum 1 syllable for any word with letters
+ *
+ * @param text - The word or text to count syllables in
+ * @returns The number of syllables
+ *
+ * @example
+ * Indonesian words:
+ * ```typescript
+ * countSyllables('buku')
+ * // → 2 (bu-ku)
+ *
+ * countSyllables('matahari')
+ * // → 4 (ma-ta-ha-ri)
+ *
+ * countSyllables('pulau')
+ * // → 2 (pu-lau, dipthong 'au' counts as one)
+ * ```
+ *
+ * @example
+ * English words:
+ * ```typescript
+ * countSyllables('hello')
+ * // → 2 (hel-lo)
+ *
+ * countSyllables('beautiful')
+ * // → 3 (beau-ti-ful)
+ * ```
+ *
+ * @example
+ * Edge cases:
+ * ```typescript
+ * countSyllables('')
+ * // → 0
+ *
+ * countSyllables('a')
+ * // → 1
+ *
+ * countSyllables('rhythm')
+ * // → 1 (no vowels, minimum 1)
+ * ```
+ *
+ * @public
+ */
+declare function countSyllables(text: string): number;
 
 /**
  * ============================================================================
@@ -281,4 +479,4 @@ declare const ACRONYMS: readonly ["DKI", "DIY", "TNI", "POLRI", "ABRI", "MPR", "
  */
 declare const ABBREVIATIONS: Record<string, string>;
 
-export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS };
+export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, MaskOptions, countSyllables, maskText, toCamelCase, toPascalCase, toSnakeCase };

package/dist/text/index.js

@@ -1700,6 +1700,111 @@ function similarity(str1, str2) {
   return 1 - distance / maxLength;
 }
 
-export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, capitalize, compareStrings, contractAbbreviation, expandAbbreviation, extractWords, isAlay, normalizeWhitespace, profanityFilter, removeAccents, removeStopwords, sanitize, similarity, slugify, toFormal, toSentenceCase, toTitleCase, truncate };
+// src/text/mask.ts
+function maskText(text, options) {
+  if (!text) return text;
+  const {
+    pattern = "middle",
+    maskChar = "*",
+    visibleStart = 2,
+    visibleEnd = 2
+  } = options || {};
+  switch (pattern) {
+    case "all":
+      return maskAll(text, maskChar);
+    case "email":
+      return maskEmail(text, maskChar);
+    case "middle":
+    default:
+      return maskMiddle(text, maskChar, visibleStart, visibleEnd);
+  }
+}
+function maskAll(text, maskChar) {
+  return text.split("").map((char) => char === " " ? " " : maskChar).join("");
+}
+function maskMiddle(text, maskChar, visibleStart, visibleEnd) {
+  const length = text.length;
+  const totalVisible = visibleStart + visibleEnd;
+  if (length < totalVisible) {
+    return maskChar.repeat(length);
+  }
+  const start = text.slice(0, visibleStart);
+  const middle = maskChar.repeat(length - totalVisible);
+  const end = text.slice(length - visibleEnd);
+  return start + middle + end;
+}
+function maskEmail(text, maskChar) {
+  const atIndex = text.indexOf("@");
+  if (atIndex === -1) {
+    return maskMiddle(text, maskChar, 2, 0);
+  }
+  const localPart = text.slice(0, atIndex);
+  const domain = text.slice(atIndex);
+  if (localPart.length <= 2) {
+    const maskedLocal2 = localPart + maskChar.repeat(Math.max(0, 2 - localPart.length));
+    return maskedLocal2 + domain;
+  }
+  const visibleLocal = localPart.slice(0, 2);
+  const maskedLocal = visibleLocal + maskChar.repeat(localPart.length - 2);
+  return maskedLocal + domain;
+}
+
+// src/text/case-converters.ts
+function toCamelCase(text) {
+  if (!text) return text;
+  const words = extractWords2(text);
+  if (words.length === 0) return "";
+  return words.map((word, index) => {
+    if (index === 0) return word.toLowerCase();
+    return capitalizeFirst(word);
+  }).join("");
+}
+function toPascalCase(text) {
+  if (!text) return text;
+  const words = extractWords2(text);
+  return words.map((word) => capitalizeFirst(word)).join("");
+}
+function toSnakeCase(text) {
+  if (!text) return text;
+  const words = extractWords2(text);
+  return words.map((word) => word.toLowerCase()).join("_");
+}
+function extractWords2(text) {
+  const parts = text.split(/[\s\-_]+/);
+  const words = [];
+  for (const part of parts) {
+    const camelWords = part.split(/(?=[A-Z])/);
+    for (const word of camelWords) {
+      const cleaned = word.replace(/[^a-zA-Z0-9]/g, "");
+      if (cleaned) {
+        words.push(cleaned);
+      }
+    }
+  }
+  return words;
+}
+function capitalizeFirst(word) {
+  if (!word) return word;
+  return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+}
+
+// src/text/syllable.ts
+function countSyllables(text) {
+  if (!text) return 0;
+  const cleaned = text.toLowerCase().replace(/[^a-z]/g, "");
+  if (!cleaned) return 0;
+  const withDipthongs = cleaned.replace(/ai/g, "\xE6").replace(/au/g, "\u0153").replace(/oi/g, "\xF8");
+  const vowelGroups = withDipthongs.match(/[aiueoæœø]+/g);
+  if (!vowelGroups) {
+    return cleaned.length > 0 ? 1 : 0;
+  }
+  let count = vowelGroups.length;
+  if (cleaned.endsWith("e") && count > 1) {
+    count -= 1;
+  }
+  return Math.max(1, count);
+}
+
+export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, capitalize, compareStrings, contractAbbreviation, countSyllables, expandAbbreviation, extractWords, isAlay, maskText, normalizeWhitespace, profanityFilter, removeAccents, removeStopwords, sanitize, similarity, slugify, toCamelCase, toFormal, toPascalCase, toSentenceCase, toSnakeCase, toTitleCase, truncate };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map