@visulima/string 1.0.5 → 1.2.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## @visulima/string [1.2.0](https://github.com/visulima/visulima/compare/@visulima/string@1.1.0...@visulima/string@1.2.0) (2025-05-07)
+
+### Features
+
+* added transliterate, slugify and replaceString ([#502](https://github.com/visulima/visulima/issues/502)) ([d2b1918](https://github.com/visulima/visulima/commit/d2b1918dd9ed87584ed3c05b11aceca581437c89))
+
+## @visulima/string [1.1.0](https://github.com/visulima/visulima/compare/@visulima/string@1.0.5...@visulima/string@1.1.0) (2025-05-04)
+
+### Features
+
+* **string:** enhance identifyCase function to support additional cases ([#501](https://github.com/visulima/visulima/issues/501)) ([8f8ecee](https://github.com/visulima/visulima/commit/8f8eceefef3f4ce332eb702979291a4db010256c))
+
 ## @visulima/string [1.0.5](https://github.com/visulima/visulima/compare/@visulima/string@1.0.4...@visulima/string@1.0.5) (2025-05-02)
 
 ### Bug Fixes

package/README.md

@@ -240,6 +240,75 @@ const customWrapped = wordWrap("Text with\u200Bzero-width characters and\u200Btr
 });
 ```
 
+### String Replacement with Ignore Ranges
+
+The `replaceString` function provides advanced string replacement capabilities, allowing multiple search/replace operations (using strings or RegExps) while respecting specified index ranges that should be ignored. It also handles match precedence correctly (earlier start index wins, then longer match wins if starts are identical) and ensures only the highest-priority, non-overlapping, non-ignored match is applied in any given segment.
+
+> **Note:** Use this function when you need fine-grained control over multiple replacements, especially when needing to ignore specific index ranges or handle complex overlapping matches with defined precedence rules. For simple, non-overlapping replacements without ignore ranges, native `String.prototype.replaceAll` might be sufficient.
+
+```typescript
+import replaceString from "@visulima/string/replace-string"; // Adjust import path if needed
+import type { IntervalArray, OptionReplaceArray } from "@visulima/string";
+
+// Basic Usage
+const source1 = "Replace AB and CD";
+const searches1: OptionReplaceArray = [
+    ["AB", "ab"],
+    ["CD", "cd"],
+];
+const result1 = replaceString(source1, searches1, []);
+// result1: "Replace ab and cd"
+
+// With Ignore Ranges
+const source2 = "Replace AB and ignore CD and replace XY";
+const searches2: OptionReplaceArray = [
+    ["AB", "ab"],
+    ["CD", "cd"], // This should be ignored by the range
+    ["XY", "xy"],
+];
+// Ignore indices 19-20 (targets "re" in "ignore")
+const ignoreRanges2: IntervalArray = [[19, 20]];
+const result2 = replaceString(source2, searches2, ignoreRanges2);
+// result2: "Replace ab and ignore cd and replace xy"
+// Note: "CD" is replaced because it doesn't overlap the ignore range [19, 20].
+
+// With Overlapping Matches (Longer match takes precedence)
+const source3 = "abcde";
+const searches3: OptionReplaceArray = [
+    ["abc", "123"], // Lower precedence
+    ["abcde", "54321"], // Higher precedence (longer)
+];
+const result3 = replaceString(source3, searches3, []);
+// result3: "54321"
+
+// With Overlapping Matches (Earlier start index takes precedence)
+const source4 = "ababab";
+const searches4: OptionReplaceArray = [
+    ["aba", "X"], // Starts at 0
+    ["bab", "Y"], // Starts at 1
+];
+const result4 = replaceString(source4, searches4, []);
+// result4: "Xbab" (Applies "X" at 0, which covers indices 0-2. Skips "Y" at 1. Appends rest.)
+
+// With Zero-Length Matches (e.g., inserting before each char)
+const source5 = "abc";
+const searches5: OptionReplaceArray = [[/(?=.)/g, "^"]]; // Lookahead for position before char
+const result5 = replaceString(source5, searches5, []);
+// result5: "^a^b^c"
+
+// Zero-Length Match at End
+const source6 = "abc";
+const searches6: OptionReplaceArray = [[/$/g, "$"]]; // Matches end of string
+const result6 = replaceString(source6, searches6, []);
+// result6: "abc$"
+
+// Using $& and $n replacements
+const source7 = "Firstname Lastname";
+const searches7: OptionReplaceArray = [[/(\w+)\s+(\w+)/, "$2, $1 ($& - Group 1: $1)"]];
+const result7 = replaceString(source7, searches7, []);
+// result7: "Lastname, Firstname (Firstname Lastname - Group 1: Firstname)"
+```
+
 ### String Splitting
 
 The `splitByCase` function is a powerful utility that splits strings based on various patterns:
@@ -838,6 +907,131 @@ The custom matcher provides detailed error messages when tests fail, showing:
 - Whether the visible content matches but the colors differ
 - Length information for both strings
 
+### `replaceString(source, searches, ignoreRanges?)`
+
+Replaces occurrences of search patterns within a string, respecting ignored ranges.
+This function is designed to handle overlapping matches and ignore ranges correctly.
+It prioritizes matches that start earlier and, for matches starting at the same position,
+prefers longer matches. Replacements within ignored ranges are skipped.
+
+**Parameters:**
+
+- `source`: The input string.
+- `searches`: An array of search pairs. Each pair can be:
+    - `[string | RegExp, string]`: A literal string or regex to search for, and its replacement string.
+      Regex flags like `g` (global) are respected.
+- `ignoreRanges?`: Optional. An array of `[start, end]` index pairs (inclusive) specifying ranges within the
+  `source` string that should be ignored during replacement.
+
+**Returns:**
+
+- `string`: The string with replacements applied, respecting ignore ranges.
+
+**Usage:**
+
+```typescript
+import { replaceString } from "@visulima/string";
+
+const text = "abc abc abc";
+const searches = [
+    [/a/g, "X"],
+    ["abc", "YYY"],
+];
+const ignoreRanges = [[4, 6]]; // Ignore the second "abc"
+
+const result = replaceString(text, searches, ignoreRanges);
+// result will be: "YYY abc YYY"
+// First 'abc' is replaced by 'YYY' (longer match takes precedence over 'X').
+// Second 'abc' is ignored.
+// Third 'abc' is replaced by 'YYY'.
+```
+
+### `transliterate(source, options?)`
+
+Performs transliteration of characters in a string based on an extensive character map and provided options. This function is useful for converting characters from one script to another (e.g., Latin with diacritics to basic Latin, Cyrillic to Latin) or for custom character replacements.
+
+**Parameters:**
+
+- `source: string`: The input string to transliterate.
+- `options?`: Optional `OptionsTransliterate` object:
+    - `fixChineseSpacing?: boolean`: If `true`, adds a space between transliterated Chinese Pinyin syllables. (Default: `true`).
+    - `ignore?: string[]`: An array of strings or characters to ignore during transliteration. These segments will be preserved in their original form. (Default: `[]`).
+    - `replaceBefore?: Array<[string | RegExp, string]> | Record<string, string>`: Custom replacement rules to apply _before_ the main character map transliteration. (Default: `[]`).
+    - `replaceAfter?: Array<[string | RegExp, string]> | Record<string, string>`: Custom replacement rules to apply _after_ the main character map transliteration. (Default: `[]`).
+    - `trim?: boolean`: If `true`, trims whitespace from the beginning and end of the result. (Default: `false`).
+    - `unknown?: string`: The character or string to use for characters that are not found in the character map and are not covered by other rules. (Default: `""` - removes unknown characters).
+
+**Returns:**
+
+- `string`: The transliterated string.
+
+**Usage:**
+
+```typescript
+import { transliterate } from "@visulima/string"; // Assuming named export from package root
+
+// Basic transliteration
+transliterate("Crème brûlée"); // Expected: 'Creme brulee'
+transliterate("你好世界"); // Expected: 'Ni Hao Shi Jie' (due to fixChineseSpacing: true)
+transliterate("你好世界", { fixChineseSpacing: false }); // Expected: 'NiHaoShiJie'
+
+// Using ignore
+transliterate("Don't change THIS, but change that.", { ignore: ["THIS"] });
+// Expected: 'Dont change THIS, but change that.'
+
+// Using replaceBefore
+transliterate("Replace C++ before map.", { replaceBefore: { "C++": "cpp" } });
+// Expected: 'Replace cpp before map.'
+
+// Using replaceAfter
+// Example: charmap turns é -> e, then replaceAfter turns e -> E
+transliterate("café", { replaceAfter: { e: "E" } });
+// Expected: 'cafE'
+
+// Handling unknown characters
+transliterate("a🚀b", { unknown: "[?]" }); // Expected: 'a[?]b'
+```
+
+### `slugify(input, options?)`
+
+Converts a string into a URL-friendly slug.
+
+It transliterates non-ASCII characters using the `transliterate` function (if enabled), optionally converts case, removes disallowed characters (replacing with separator), and collapses separators.
+
+**Parameters:**
+
+- `input`: The string to convert.
+- `options?`: Optional `SlugifyOptions` object:
+    - `allowedChars?: string`: Characters allowed in the slug. Others are replaced by `separator`. (Default: `"a-zA-Z0-9-_.~"`)
+    - `fixChineseSpacing?: boolean`: Passed to `transliterate`. Determines if a space is added between transliterated Chinese characters (default: `true`).
+    - `ignore?: string[]`: Passed to `transliterate`. Characters/strings to ignore during the initial transliteration phase (default: `[]`).
+    - `lowercase?: boolean`: Convert to lowercase. (Default: `true`). Cannot be true if `uppercase` is true.
+    - `replaceAfter?: OptionReplaceCombined`: Passed to `transliterate`. Search/replace pairs to apply _after_ the character map transliteration but _before_ slugification logic (default: `[]`).
+    - `replaceBefore?: OptionReplaceCombined`: Passed to `transliterate`. Search/replace pairs to apply _before_ any transliteration (default: `[]`).
+    - `separator?: string`: Custom separator. (Default: `"-"`).
+    - `transliterate?: boolean`: Whether to perform the initial transliteration of non-ASCII characters. If `false`, only case conversion and character filtering/replacement are performed on the input string. (Default: `true`).
+    - `unknown?: string`: Passed to `transliterate`. Character to use for unknown characters during transliteration (default: `""`).
+    - `uppercase?: boolean`: Convert to uppercase. (Default: `false`). Cannot be true if `lowercase` is true.
+
+**Returns:**
+
+- `string`: The generated slug.
+
+**Usage:**
+
+```typescript
+import { slugify } from "@visulima/string";
+
+slugify("你好 World!"); // 'ni-hao-world' (fixChineseSpacing=true by default)
+slugify("你好World!", { fixChineseSpacing: false }); // 'nihaoworld'
+slugify("Crème Brûlée"); // 'creme-brulee'
+slugify("foo & bar * baz"); // 'foo-bar-baz' (&, *, space are disallowed)
+slugify("FOO BAR", { lowercase: false, uppercase: true }); // 'FOO-BAR'
+slugify("foo bar baz", { separator: "_", allowedChars: "a-z_" }); // 'foo_bar_baz'
+slugify("Keep C++", { replaceBefore: { "C++": "cpp" } }); // 'keep-cpp'
+slugify("Keep !@#$", { allowedChars: "a-z!@$" }); // 'keep!@$'
+```
+
 ## Related
 
 - [change-case](https://github.com/blakeembrey/change-case) - Simple string case utilities
@@ -850,11 +1044,16 @@ The custom matcher provides detailed error messages when tests fail, showing:
 - [fast-string-truncated-width](https://github.com/fabiospampinato/fast-string-truncated-width) - Fast string truncated width
 - [ansi-truncate](https://github.com/fabiospampinato/ansi-truncate) - Truncate strings with ANSI escape codes
 - [string-ts](https://github.com/gustavoguichard/string-ts) - Strongly typed string functions
+- [@sindresorhus/slugify](https://github.com/sindresorhus/slugify) - Slugify a string
+- [slugify](https://github.com/simov/slugify) - Slugify a string
+- [@sindresorhus/transliterate](https://github.com/sindresorhus/transliterate) - Convert Unicode characters to Latin characters using transliteration
+- [transliteration](https://github.com/yf-hk/transliteration/tree/main) - UTF-8 to ASCII transliteration / slugify module for node.js, browser, Web Worker, React Native, Electron and CLI.
+- [unidecode](https://github.com/FGRibreau/node-unidecode) - 📃 ASCII transliterations of Unicode text
 
 ## Supported Node.js Versions
 
-Libraries in this ecosystem make the best effort to track [Node.js’ release schedule](https://github.com/nodejs/release#release-schedule).
-Here’s [a post on why we think this is important](https://medium.com/the-node-js-collection/maintainers-should-consider-following-node-js-release-schedule-ab08ed4de71a).
+Libraries in this ecosystem make the best effort to track [Node.js' release schedule](https://github.com/nodejs/release#release-schedule).
+Here's [a post on why we think this is important](https://medium.com/the-node-js-collection/maintainers-should-consider-following-node-js-release-schedule-ab08ed4de71a).
 
 ## Contributing
 

package/dist/case/camel-case.d.cts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, C as CamelCase } from '../packem_shared/types-D2-6p7t1.cjs';
-import '../packem_shared/types-BNbQJg02.cjs';
-import '../utils.cjs';
+import { C as CaseOptions, a as CamelCase } from '../packem_shared/types-C5Pk8B8Q.cjs';
+import '../packem_shared/types-DmfKbIaI.cjs';
+import '../packem_shared/lru-cache-B_t27XwI.cjs';
 
 declare const camelCase: <T extends string = string>(value?: T, options?: CaseOptions) => CamelCase<T>;
 

package/dist/case/camel-case.d.mts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, C as CamelCase } from '../packem_shared/types-BAd3WDHo.mjs';
-import '../packem_shared/types-BNbQJg02.mjs';
-import '../utils.mjs';
+import { C as CaseOptions, a as CamelCase } from '../packem_shared/types-_jqW_ZOt.mjs';
+import '../packem_shared/types-DmfKbIaI.mjs';
+import '../packem_shared/lru-cache-B_t27XwI.mjs';
 
 declare const camelCase: <T extends string = string>(value?: T, options?: CaseOptions) => CamelCase<T>;
 

package/dist/case/camel-case.d.ts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, C as CamelCase } from '../packem_shared/types-BttWSSIk.js';
-import '../packem_shared/types-BNbQJg02.js';
-import '../utils.js';
+import { C as CaseOptions, a as CamelCase } from '../packem_shared/types-DcGtApe2.js';
+import '../packem_shared/types-DmfKbIaI.js';
+import '../packem_shared/lru-cache-B_t27XwI.js';
 
 declare const camelCase: <T extends string = string>(value?: T, options?: CaseOptions) => CamelCase<T>;
 

package/dist/case/capital-case.d.cts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, a as CapitalCase } from '../packem_shared/types-D2-6p7t1.cjs';
-import '../packem_shared/types-BNbQJg02.cjs';
-import '../utils.cjs';
+import { C as CaseOptions, b as CapitalCase } from '../packem_shared/types-C5Pk8B8Q.cjs';
+import '../packem_shared/types-DmfKbIaI.cjs';
+import '../packem_shared/lru-cache-B_t27XwI.cjs';
 
 declare const capitalCase: <T extends string = string>(value?: T, options?: CaseOptions) => CapitalCase<T>;
 

package/dist/case/capital-case.d.mts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, a as CapitalCase } from '../packem_shared/types-BAd3WDHo.mjs';
-import '../packem_shared/types-BNbQJg02.mjs';
-import '../utils.mjs';
+import { C as CaseOptions, b as CapitalCase } from '../packem_shared/types-_jqW_ZOt.mjs';
+import '../packem_shared/types-DmfKbIaI.mjs';
+import '../packem_shared/lru-cache-B_t27XwI.mjs';
 
 declare const capitalCase: <T extends string = string>(value?: T, options?: CaseOptions) => CapitalCase<T>;
 

package/dist/case/capital-case.d.ts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, a as CapitalCase } from '../packem_shared/types-BttWSSIk.js';
-import '../packem_shared/types-BNbQJg02.js';
-import '../utils.js';
+import { C as CaseOptions, b as CapitalCase } from '../packem_shared/types-DcGtApe2.js';
+import '../packem_shared/types-DmfKbIaI.js';
+import '../packem_shared/lru-cache-B_t27XwI.js';
 
 declare const capitalCase: <T extends string = string>(value?: T, options?: CaseOptions) => CapitalCase<T>;
 

package/dist/case/constant-case.d.cts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, c as ConstantCase } from '../packem_shared/types-D2-6p7t1.cjs';
-import '../packem_shared/types-BNbQJg02.cjs';
-import '../utils.cjs';
+import { C as CaseOptions, c as ConstantCase } from '../packem_shared/types-C5Pk8B8Q.cjs';
+import '../packem_shared/types-DmfKbIaI.cjs';
+import '../packem_shared/lru-cache-B_t27XwI.cjs';
 
 declare const constantCase: <T extends string = string>(value?: T, options?: CaseOptions) => ConstantCase<T>;
 

package/dist/case/constant-case.d.mts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, c as ConstantCase } from '../packem_shared/types-BAd3WDHo.mjs';
-import '../packem_shared/types-BNbQJg02.mjs';
-import '../utils.mjs';
+import { C as CaseOptions, c as ConstantCase } from '../packem_shared/types-_jqW_ZOt.mjs';
+import '../packem_shared/types-DmfKbIaI.mjs';
+import '../packem_shared/lru-cache-B_t27XwI.mjs';
 
 declare const constantCase: <T extends string = string>(value?: T, options?: CaseOptions) => ConstantCase<T>;
 

package/dist/case/constant-case.d.ts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, c as ConstantCase } from '../packem_shared/types-BttWSSIk.js';
-import '../packem_shared/types-BNbQJg02.js';
-import '../utils.js';
+import { C as CaseOptions, c as ConstantCase } from '../packem_shared/types-DcGtApe2.js';
+import '../packem_shared/types-DmfKbIaI.js';
+import '../packem_shared/lru-cache-B_t27XwI.js';
 
 declare const constantCase: <T extends string = string>(value?: T, options?: CaseOptions) => ConstantCase<T>;
 

package/dist/case/dot-case.d.cts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, D as DotCase } from '../packem_shared/types-D2-6p7t1.cjs';
-import '../packem_shared/types-BNbQJg02.cjs';
-import '../utils.cjs';
+import { C as CaseOptions, D as DotCase } from '../packem_shared/types-C5Pk8B8Q.cjs';
+import '../packem_shared/types-DmfKbIaI.cjs';
+import '../packem_shared/lru-cache-B_t27XwI.cjs';
 
 declare const dotCase: <T extends string = string>(value?: T, options?: CaseOptions) => DotCase<T>;
 

package/dist/case/dot-case.d.mts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, D as DotCase } from '../packem_shared/types-BAd3WDHo.mjs';
-import '../packem_shared/types-BNbQJg02.mjs';
-import '../utils.mjs';
+import { C as CaseOptions, D as DotCase } from '../packem_shared/types-_jqW_ZOt.mjs';
+import '../packem_shared/types-DmfKbIaI.mjs';
+import '../packem_shared/lru-cache-B_t27XwI.mjs';
 
 declare const dotCase: <T extends string = string>(value?: T, options?: CaseOptions) => DotCase<T>;
 

package/dist/case/dot-case.d.ts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, D as DotCase } from '../packem_shared/types-BttWSSIk.js';
-import '../packem_shared/types-BNbQJg02.js';
-import '../utils.js';
+import { C as CaseOptions, D as DotCase } from '../packem_shared/types-DcGtApe2.js';
+import '../packem_shared/types-DmfKbIaI.js';
+import '../packem_shared/lru-cache-B_t27XwI.js';
 
 declare const dotCase: <T extends string = string>(value?: T, options?: CaseOptions) => DotCase<T>;
 

package/dist/case/flat-case.d.cts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, F as FlatCase } from '../packem_shared/types-D2-6p7t1.cjs';
-import '../packem_shared/types-BNbQJg02.cjs';
-import '../utils.cjs';
+import { C as CaseOptions, F as FlatCase } from '../packem_shared/types-C5Pk8B8Q.cjs';
+import '../packem_shared/types-DmfKbIaI.cjs';
+import '../packem_shared/lru-cache-B_t27XwI.cjs';
 
 declare const flatCase: <T extends string = string>(value?: T, options?: CaseOptions) => FlatCase<T>;
 

package/dist/case/flat-case.d.mts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, F as FlatCase } from '../packem_shared/types-BAd3WDHo.mjs';
-import '../packem_shared/types-BNbQJg02.mjs';
-import '../utils.mjs';
+import { C as CaseOptions, F as FlatCase } from '../packem_shared/types-_jqW_ZOt.mjs';
+import '../packem_shared/types-DmfKbIaI.mjs';
+import '../packem_shared/lru-cache-B_t27XwI.mjs';
 
 declare const flatCase: <T extends string = string>(value?: T, options?: CaseOptions) => FlatCase<T>;
 

package/dist/case/flat-case.d.ts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, F as FlatCase } from '../packem_shared/types-BttWSSIk.js';
-import '../packem_shared/types-BNbQJg02.js';
-import '../utils.js';
+import { C as CaseOptions, F as FlatCase } from '../packem_shared/types-DcGtApe2.js';
+import '../packem_shared/types-DmfKbIaI.js';
+import '../packem_shared/lru-cache-B_t27XwI.js';
 
 declare const flatCase: <T extends string = string>(value?: T, options?: CaseOptions) => FlatCase<T>;
 

package/dist/case/flip-case.d.cts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, d as FlipCase } from '../packem_shared/types-D2-6p7t1.cjs';
-import '../packem_shared/types-BNbQJg02.cjs';
-import '../utils.cjs';
+import { C as CaseOptions, d as FlipCase } from '../packem_shared/types-C5Pk8B8Q.cjs';
+import '../packem_shared/types-DmfKbIaI.cjs';
+import '../packem_shared/lru-cache-B_t27XwI.cjs';
 
 type FlipOptions = Omit<CaseOptions, "handleEmoji">;
 declare const flipCase: <T extends string = string>(value?: T, options?: FlipOptions) => FlipCase<T>;

package/dist/case/flip-case.d.mts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, d as FlipCase } from '../packem_shared/types-BAd3WDHo.mjs';
-import '../packem_shared/types-BNbQJg02.mjs';
-import '../utils.mjs';
+import { C as CaseOptions, d as FlipCase } from '../packem_shared/types-_jqW_ZOt.mjs';
+import '../packem_shared/types-DmfKbIaI.mjs';
+import '../packem_shared/lru-cache-B_t27XwI.mjs';
 
 type FlipOptions = Omit<CaseOptions, "handleEmoji">;
 declare const flipCase: <T extends string = string>(value?: T, options?: FlipOptions) => FlipCase<T>;

package/dist/case/flip-case.d.ts

@@ -1,6 +1,6 @@
-import { b as CaseOptions, d as FlipCase } from '../packem_shared/types-BttWSSIk.js';
-import '../packem_shared/types-BNbQJg02.js';
-import '../utils.js';
+import { C as CaseOptions, d as FlipCase } from '../packem_shared/types-DcGtApe2.js';
+import '../packem_shared/types-DmfKbIaI.js';
+import '../packem_shared/lru-cache-B_t27XwI.js';
 
 type FlipOptions = Omit<CaseOptions, "handleEmoji">;
 declare const flipCase: <T extends string = string>(value?: T, options?: FlipOptions) => FlipCase<T>;

package/dist/case/identify-case.cjs

@@ -2,28 +2,67 @@
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const IS_PASCAL_CASE = /^([A-Z][a-z]*)+$/;
+const CONTAINS_LETTER_CASE_INSENSITIVE = /[a-z]/i;
+const IS_UPPER_SNAKE_CASE = /^[A-Z0-9_]+$/;
+const IS_LOWER_SNAKE_CASE = /^[a-z0-9_]+$/;
+const IS_KEBAB_CASE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const IS_LOWERCASE_WITH_SPACE = /^[a-z ]+$/;
+const IS_UPPERCASE = /^[A-Z][A-Z0-9]*$/;
+const WHITESPACE_REGEX = /\s+/;
+const IS_NUMERIC = /^\d+$/;
+const IS_CAMEL_CASE_LIKE = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)+$/;
+const CONTAINS_PUNCTUATION_MID_WORD = /[.!?;:,](?!\s|$)/;
 const identifyCase = /* @__PURE__ */ __name((value) => {
-  if (typeof value !== "string" || !value) {
-    return "lower";
+  if (typeof value !== "string") {
+    throw new TypeError("Expected input to be a string");
+  }
+  if (!value) {
+    return "unknown";
+  }
+  if (!CONTAINS_LETTER_CASE_INSENSITIVE.test(value)) {
+    return "unknown";
   }
-  if (value === value.toLowerCase()) {
-    if (value.includes("_")) {
+  if (value.includes("_")) {
+    if (IS_UPPER_SNAKE_CASE.test(value)) {
+      return "upper_snake";
+    }
+    if (IS_LOWER_SNAKE_CASE.test(value)) {
       return "snake";
     }
-    if (value.includes("-")) {
+    return "mixed";
+  }
+  if (value.includes("-")) {
+    if (IS_KEBAB_CASE.test(value)) {
       return "kebab";
     }
+    return "mixed";
+  }
+  if (IS_LOWERCASE_WITH_SPACE.test(value)) {
     return "lower";
   }
-  if (value === value.toUpperCase()) {
+  if (IS_UPPERCASE.test(value)) {
     return "upper";
   }
-  if (/^[A-Z][a-z0-9]+(?:[A-Z][a-z0-9]+)*$/.test(value)) {
+  const words = value.split(WHITESPACE_REGEX);
+  if (words.length > 1 && words.every((word) => IS_PASCAL_CASE.test(word))) {
+    return "title";
+  }
+  if (words.length > 1 && IS_NUMERIC.test(words[0]) && IS_PASCAL_CASE.test(words[1])) {
+    return "title";
+  }
+  if (words.length > 1 && IS_PASCAL_CASE.test(words[0]) && /^[a-z]/.test(words[1])) {
+    return "sentence";
+  }
+  if (IS_PASCAL_CASE.test(value)) {
     return "pascal";
   }
-  if (/^[a-z0-9]+(?:[A-Z][a-z0-9]+)*$/.test(value)) {
+  if (IS_CAMEL_CASE_LIKE.test(value)) {
     return "camel";
   }
+  if (CONTAINS_PUNCTUATION_MID_WORD.test(value)) {
+    return "unknown";
+  }
   return "mixed";
 }, "identifyCase");
 

package/dist/case/identify-case.d.cts

@@ -1,6 +1,6 @@
-import { I as IdentifyCase } from '../packem_shared/types-D2-6p7t1.cjs';
-import '../packem_shared/types-BNbQJg02.cjs';
-import '../utils.cjs';
+import { I as IdentifyCase } from '../packem_shared/types-C5Pk8B8Q.cjs';
+import '../packem_shared/types-DmfKbIaI.cjs';
+import '../packem_shared/lru-cache-B_t27XwI.cjs';
 
 declare const identifyCase: <T extends string = string>(value?: T) => IdentifyCase<T>;
 

package/dist/case/identify-case.d.mts

@@ -1,6 +1,6 @@
-import { I as IdentifyCase } from '../packem_shared/types-BAd3WDHo.mjs';
-import '../packem_shared/types-BNbQJg02.mjs';
-import '../utils.mjs';
+import { I as IdentifyCase } from '../packem_shared/types-_jqW_ZOt.mjs';
+import '../packem_shared/types-DmfKbIaI.mjs';
+import '../packem_shared/lru-cache-B_t27XwI.mjs';
 
 declare const identifyCase: <T extends string = string>(value?: T) => IdentifyCase<T>;
 

package/dist/case/identify-case.d.ts

@@ -1,6 +1,6 @@
-import { I as IdentifyCase } from '../packem_shared/types-BttWSSIk.js';
-import '../packem_shared/types-BNbQJg02.js';
-import '../utils.js';
+import { I as IdentifyCase } from '../packem_shared/types-DcGtApe2.js';
+import '../packem_shared/types-DmfKbIaI.js';
+import '../packem_shared/lru-cache-B_t27XwI.js';
 
 declare const identifyCase: <T extends string = string>(value?: T) => IdentifyCase<T>;
 

package/dist/case/identify-case.mjs

@@ -1,27 +1,66 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const IS_PASCAL_CASE = /^([A-Z][a-z]*)+$/;
+const CONTAINS_LETTER_CASE_INSENSITIVE = /[a-z]/i;
+const IS_UPPER_SNAKE_CASE = /^[A-Z0-9_]+$/;
+const IS_LOWER_SNAKE_CASE = /^[a-z0-9_]+$/;
+const IS_KEBAB_CASE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const IS_LOWERCASE_WITH_SPACE = /^[a-z ]+$/;
+const IS_UPPERCASE = /^[A-Z][A-Z0-9]*$/;
+const WHITESPACE_REGEX = /\s+/;
+const IS_NUMERIC = /^\d+$/;
+const IS_CAMEL_CASE_LIKE = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)+$/;
+const CONTAINS_PUNCTUATION_MID_WORD = /[.!?;:,](?!\s|$)/;
 const identifyCase = /* @__PURE__ */ __name((value) => {
-  if (typeof value !== "string" || !value) {
-    return "lower";
+  if (typeof value !== "string") {
+    throw new TypeError("Expected input to be a string");
+  }
+  if (!value) {
+    return "unknown";
+  }
+  if (!CONTAINS_LETTER_CASE_INSENSITIVE.test(value)) {
+    return "unknown";
   }
-  if (value === value.toLowerCase()) {
-    if (value.includes("_")) {
+  if (value.includes("_")) {
+    if (IS_UPPER_SNAKE_CASE.test(value)) {
+      return "upper_snake";
+    }
+    if (IS_LOWER_SNAKE_CASE.test(value)) {
       return "snake";
     }
-    if (value.includes("-")) {
+    return "mixed";
+  }
+  if (value.includes("-")) {
+    if (IS_KEBAB_CASE.test(value)) {
       return "kebab";
     }
+    return "mixed";
+  }
+  if (IS_LOWERCASE_WITH_SPACE.test(value)) {
     return "lower";
   }
-  if (value === value.toUpperCase()) {
+  if (IS_UPPERCASE.test(value)) {
     return "upper";
   }
-  if (/^[A-Z][a-z0-9]+(?:[A-Z][a-z0-9]+)*$/.test(value)) {
+  const words = value.split(WHITESPACE_REGEX);
+  if (words.length > 1 && words.every((word) => IS_PASCAL_CASE.test(word))) {
+    return "title";
+  }
+  if (words.length > 1 && IS_NUMERIC.test(words[0]) && IS_PASCAL_CASE.test(words[1])) {
+    return "title";
+  }
+  if (words.length > 1 && IS_PASCAL_CASE.test(words[0]) && /^[a-z]/.test(words[1])) {
+    return "sentence";
+  }
+  if (IS_PASCAL_CASE.test(value)) {
     return "pascal";
   }
-  if (/^[a-z0-9]+(?:[A-Z][a-z0-9]+)*$/.test(value)) {
+  if (IS_CAMEL_CASE_LIKE.test(value)) {
     return "camel";
   }
+  if (CONTAINS_PUNCTUATION_MID_WORD.test(value)) {
+    return "unknown";
+  }
   return "mixed";
 }, "identifyCase");