@visulima/string 3.0.0-alpha.3 → 3.0.0-alpha.5

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## @visulima/string [3.0.0-alpha.5](https://github.com/visulima/visulima/compare/@visulima/string@3.0.0-alpha.4...@visulima/string@3.0.0-alpha.5) (2025-12-27)
+
+### Bug Fixes
+
+* **string:** update package files ([ca22f2e](https://github.com/visulima/visulima/commit/ca22f2efdd044ae20d421f729d185e1e93747cd8))
+
+
+### Dependencies
+
+* **@visulima/colorize:** upgraded to 2.0.0-alpha.4
+
+## @visulima/string [3.0.0-alpha.4](https://github.com/visulima/visulima/compare/@visulima/string@3.0.0-alpha.3...@visulima/string@3.0.0-alpha.4) (2025-12-13)
+
+### Features
+
+* add string analysis functions for counting occurrences and detecting text direction ([de84ab0](https://github.com/visulima/visulima/commit/de84ab072e36d3fc834dd8d971db46fd62be249a))
+
+### Miscellaneous Chores
+
+* fixed project.json names and schema path ([964722f](https://github.com/visulima/visulima/commit/964722f691db205c7edb9aa6db29e849a647500b))
+
 ## @visulima/string [3.0.0-alpha.3](https://github.com/visulima/visulima/compare/@visulima/string@3.0.0-alpha.2...@visulima/string@3.0.0-alpha.3) (2025-12-11)
 
 ### Bug Fixes

package/README.md

@@ -59,6 +59,10 @@
     - Handles template literals and string inputs
     - Normalizes newlines across platforms
     - Configurable trimming behavior
+- **String Analysis**:
+    - `countOccurrences`: Count occurrences of a substring in a string
+    - `direction`: Detect text direction (left-to-right, right-to-left, or neutral)
+    - Unicode-aware and handles multi-byte characters
 - **String Width Calculation**:
     - `getStringWidth`: Calculate visual width of strings with Unicode support
     - `getStringTruncatedWidth`: Width calculation with smart truncation
@@ -392,6 +396,42 @@ splitByCase("🎉HappyBirthday🎂", {
 // ['🎉', 'Happy', 'Birthday', '🎂']
 ```
 
+### String Analysis
+
+The `countOccurrences` function counts how many times a substring appears in a string, with full Unicode support:
+
+```typescript
+import { countOccurrences } from "@visulima/string";
+
+// Basic counting
+countOccurrences("foo", "o"); // 2
+countOccurrences("fo fooo fo", "o"); // 5
+
+// Unicode support
+countOccurrences("a🤔b🤔c", "🤔"); // 2
+
+// Empty string handling
+countOccurrences("", "f"); // 0
+```
+
+The `direction` function detects text direction for internationalization:
+
+```typescript
+import { direction } from "@visulima/string";
+
+// Left-to-right languages
+direction("english"); // 'ltr'
+direction("Hello World"); // 'ltr'
+
+// Right-to-left languages
+direction("الجملة"); // 'rtl' (Arabic)
+direction("נ"); // 'rtl' (Hebrew)
+
+// Neutral (numbers, symbols, empty)
+direction("123"); // 'neutral'
+direction(""); // 'neutral'
+```
+
 ### Case Conversion Functions
 
 #### camelCase

package/dist/index.d.ts

@@ -36,6 +36,10 @@ export { WordSimilaritySortOptions, wordSimilaritySort } from './word-similarity
 export { WordWrapOptions, WrapMode, wordWrap } from './word-wrap.js';
 import './packem_shared/lru-cache-B_t27XwI.js';
 
+declare const countOccurrences: (value: string, substring: string) => number;
+
+declare const direction: (value: string) => "rtl" | "ltr" | "neutral";
+
 declare const excerpt: (html: string, limit: number, options?: ExcerptOptions) => string;
 type ExcerptOptions = Omit<TruncateOptions, "position">;
 
@@ -48,5 +52,5 @@ declare const replaceString: (source: string, searches: OptionReplaceArray, igno
 
 declare const transliterate: (source: string, options?: OptionsTransliterate) => string;
 
-export { IntervalArray, OptionReplaceArray, OptionsTransliterate, TruncateOptions, closest, closestN, distance, excerpt, replaceString, transliterate };
+export { IntervalArray, OptionReplaceArray, OptionsTransliterate, TruncateOptions, closest, closestN, countOccurrences, direction, distance, excerpt, replaceString, transliterate };
 export type { ExcerptOptions };

package/dist/index.js

@@ -21,6 +21,8 @@ export { default as upperFirst } from './case/upper-first.js';
 export { default as joinSegments } from './packem_shared/joinSegments-B4H6oZ9b.js';
 export { closestString } from './closest-string.js';
 export { compareSimilarity } from './compare-similarity.js';
+export { countOccurrences } from './packem_shared/countOccurrences-CS9XprQN.js';
+export { direction } from './packem_shared/direction-BVhR8MOQ.js';
 export { excerpt } from './packem_shared/excerpt-GvmR4ESb.js';
 export { getStringTruncatedWidth } from './get-string-truncated-width.js';
 export { getStringWidth } from './get-string-width.js';

package/dist/packem_shared/countOccurrences-CS9XprQN.js

@@ -0,0 +1,22 @@
+const countOccurrences = (value, substring) => {
+  const source = String(value);
+  if (typeof substring !== "string") {
+    throw new TypeError("Expected character");
+  }
+  if (substring.length === 0) {
+    throw new TypeError("Expected non-empty substring");
+  }
+  let count = 0;
+  let index = source.indexOf(substring);
+  while (index !== -1) {
+    count++;
+    const nextIndex = index + substring.length;
+    if (nextIndex <= index) {
+      break;
+    }
+    index = source.indexOf(substring, nextIndex);
+  }
+  return count;
+};
+
+export { countOccurrences };

package/dist/packem_shared/direction-BVhR8MOQ.js

@@ -0,0 +1,10 @@
+const rtlRange = "֑-߿יִ-﷽ﹰ-ﻼ";
+const ltrRange = "A-Za-zÀ-ÖØ-öø-ʸ̀-֐ࠀ-῿‎Ⰰ-﬜︀-﹯﻽-￿";
+const rtl = new RegExp("^[^" + ltrRange + "]*[" + rtlRange + "]");
+const ltr = new RegExp("^[^" + rtlRange + "]*[" + ltrRange + "]");
+const direction = (value) => {
+  const source = String(value || "");
+  return rtl.test(source) ? "rtl" : ltr.test(source) ? "ltr" : "neutral";
+};
+
+export { direction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/string",
-  "version": "3.0.0-alpha.3",
+  "version": "3.0.0-alpha.5",
   "description": "Functions for manipulating strings.",
   "keywords": [
     "visulima",