@visulima/string 1.0.4 → 1.1.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## @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
+
+* **string:** update string width calculations for ellipsis and control characters, remove ambiguousWidth ([bf8a2de](https://github.com/visulima/visulima/commit/bf8a2de06429a229b5bdb17cadd8239243a55e0d))
+
 ## @visulima/string [1.0.4](https://github.com/visulima/visulima/compare/@visulima/string@1.0.3...@visulima/string@1.0.4) (2025-05-01)
 
 ### Bug Fixes

package/README.md

@@ -447,7 +447,6 @@ getStringWidth("👨‍👩‍👧‍👦"); // => 2 (family emoji with ZWJ sequ
 ```typescript
 interface StringWidthOptions {
     ambiguousIsNarrow?: boolean; // Treat ambiguous-width characters as narrow
-    ambiguousWidth?: number; // Width of ambiguous-width characters (default: 1)
     ansiWidth?: number; // Width of ANSI escape sequences (default: 0)
     controlWidth?: number; // Width of control characters (default: 0)
     countAnsiEscapeCodes?: boolean; // Include ANSI escape codes in width (default: false)

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.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");
 

package/dist/get-string-truncated-width.cjs

@@ -82,6 +82,9 @@ const getCharType = /* @__PURE__ */ __name((codePoint) => {
   codePoint >= 12352 && codePoint <= 12543) {
     return "wide";
   }
+  if (codePoint === 8230) {
+    return "latin";
+  }
   return "other";
 }, "getCharType");
 const getCachedCharWidth = /* @__PURE__ */ __name((codePoint, config) => {
@@ -196,7 +199,6 @@ const getStringTruncatedWidth = /* @__PURE__ */ __name((input, options = {}) =>
       limit: options.limit ?? Number.POSITIVE_INFINITY
     },
     width: {
-      ambiguous: options.ambiguousWidth ?? 1,
       ambiguousIsNarrow: options.ambiguousIsNarrow ?? false,
       ansi: options.ansiWidth ?? 0,
       control: options.controlWidth ?? 0,
@@ -231,7 +233,6 @@ const getStringTruncatedWidth = /* @__PURE__ */ __name((input, options = {}) =>
             const strippedLinkText = linkText.replace(constants.RE_ANSI, "");
             const linkTextWidthResult = getStringTruncatedWidth(strippedLinkText, {
               ambiguousIsNarrow: config.width.ambiguousIsNarrow,
-              ambiguousWidth: config.width.ambiguous,
               ansiWidth: config.width.ansi,
               controlWidth: config.width.control,
               countAnsiEscapeCodes: false,

package/dist/get-string-truncated-width.d.cts

@@ -1,6 +1,5 @@
 interface StringTruncatedWidthOptions {
     ambiguousIsNarrow?: boolean;
-    ambiguousWidth?: number;
     ansiWidth?: number;
     controlWidth?: number;
     countAnsiEscapeCodes?: boolean;

package/dist/get-string-truncated-width.d.mts

@@ -1,6 +1,5 @@
 interface StringTruncatedWidthOptions {
     ambiguousIsNarrow?: boolean;
-    ambiguousWidth?: number;
     ansiWidth?: number;
     controlWidth?: number;
     countAnsiEscapeCodes?: boolean;

package/dist/get-string-truncated-width.d.ts

@@ -1,6 +1,5 @@
 interface StringTruncatedWidthOptions {
     ambiguousIsNarrow?: boolean;
-    ambiguousWidth?: number;
     ansiWidth?: number;
     controlWidth?: number;
     countAnsiEscapeCodes?: boolean;

package/dist/get-string-truncated-width.mjs

@@ -78,6 +78,9 @@ const getCharType = /* @__PURE__ */ __name((codePoint) => {
   codePoint >= 12352 && codePoint <= 12543) {
     return "wide";
   }
+  if (codePoint === 8230) {
+    return "latin";
+  }
   return "other";
 }, "getCharType");
 const getCachedCharWidth = /* @__PURE__ */ __name((codePoint, config) => {
@@ -192,7 +195,6 @@ const getStringTruncatedWidth = /* @__PURE__ */ __name((input, options = {}) =>
       limit: options.limit ?? Number.POSITIVE_INFINITY
     },
     width: {
-      ambiguous: options.ambiguousWidth ?? 1,
       ambiguousIsNarrow: options.ambiguousIsNarrow ?? false,
       ansi: options.ansiWidth ?? 0,
       control: options.controlWidth ?? 0,
@@ -227,7 +229,6 @@ const getStringTruncatedWidth = /* @__PURE__ */ __name((input, options = {}) =>
             const strippedLinkText = linkText.replace(RE_ANSI, "");
             const linkTextWidthResult = getStringTruncatedWidth(strippedLinkText, {
               ambiguousIsNarrow: config.width.ambiguousIsNarrow,
-              ambiguousWidth: config.width.ambiguous,
               ansiWidth: config.width.ansi,
               controlWidth: config.width.control,
               countAnsiEscapeCodes: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/string",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Functions for manipulating strings.",
   "keywords": [
     "visulima",