@react-hive/honey-utils 3.15.0 → 3.16.0

package/dist/index.dev.cjs

@@ -2451,6 +2451,89 @@ __webpack_require__.r(__webpack_exports__);
 const camelToWords = (input) => input.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
 
 
+/***/ }),
+
+/***/ "./src/string/find-char-indices.ts":
+/*!*****************************************!*\
+  !*** ./src/string/find-char-indices.ts ***!
+  \*****************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   findCharIndices: () => (/* binding */ findCharIndices)
+/* harmony export */ });
+/**
+ * Finds all zero-based indices where a given single character occurs in a string.
+ *
+ * The string is scanned once from start to end and each matching character position is collected.
+ *
+ * ⚠️ Character comparison is performed at the UTF-16 code unit level
+ * (`String.charCodeAt`), not by Unicode grapheme clusters.
+ *
+ * @param inputString - The string to scan.
+ * @param targetChar - A single character to search for.
+ *
+ * @returns An array of zero-based indices for each occurrence of `targetChar`.
+ *  Returns an empty array if no matches are found.
+ */
+const findCharIndices = (inputString, targetChar) => {
+    if (inputString.length === 0) {
+        return [];
+    }
+    const targetCode = targetChar.charCodeAt(0);
+    const indices = [];
+    for (let i = 0; i < inputString.length; i++) {
+        if (inputString.charCodeAt(i) === targetCode) {
+            indices.push(i);
+        }
+    }
+    return indices;
+};
+
+
+/***/ }),
+
+/***/ "./src/string/for-each-char.ts":
+/*!*************************************!*\
+  !*** ./src/string/for-each-char.ts ***!
+  \*************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   forEachChar: () => (/* binding */ forEachChar)
+/* harmony export */ });
+/**
+ * Iterates over each character of a string and invokes a callback for each one.
+ *
+ * Iteration is performed over UTF-16 code units (not Unicode grapheme clusters).
+ * Characters may be conditionally skipped using an optional predicate.
+ *
+ * @param input - The string to iterate over.
+ * @param onChar - Invoked for each character that is not skipped.
+ * @param shouldSkipChar - Optional predicate; returning `true` skips the character.
+ */
+const forEachChar = (input, onChar, shouldSkipChar) => {
+    if (input.length === 0) {
+        return;
+    }
+    const length = input.length;
+    for (let charIndex = 0; charIndex < length; charIndex++) {
+        const char = input[charIndex];
+        const context = {
+            charIndex,
+            prevChar: charIndex > 0 ? input[charIndex - 1] : null,
+            nextChar: charIndex < length - 1 ? input[charIndex + 1] : null,
+        };
+        if (shouldSkipChar?.(char, context)) {
+            continue;
+        }
+        onChar(char, context);
+    }
+};
+
+
 /***/ }),
 
 /***/ "./src/string/index.ts":
@@ -2463,6 +2546,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   camelToDashCase: () => (/* reexport safe */ _camel_to_dash_case__WEBPACK_IMPORTED_MODULE_2__.camelToDashCase),
 /* harmony export */   camelToWords: () => (/* reexport safe */ _camel_to_words__WEBPACK_IMPORTED_MODULE_3__.camelToWords),
+/* harmony export */   findCharIndices: () => (/* reexport safe */ _find_char_indices__WEBPACK_IMPORTED_MODULE_7__.findCharIndices),
+/* harmony export */   forEachChar: () => (/* reexport safe */ _for_each_char__WEBPACK_IMPORTED_MODULE_8__.forEachChar),
 /* harmony export */   isNilOrEmptyString: () => (/* reexport safe */ _is_nil_or_empty_string__WEBPACK_IMPORTED_MODULE_5__.isNilOrEmptyString),
 /* harmony export */   isString: () => (/* reexport safe */ _is_string__WEBPACK_IMPORTED_MODULE_0__.isString),
 /* harmony export */   parseFileName: () => (/* reexport safe */ _parse_file_name__WEBPACK_IMPORTED_MODULE_6__.parseFileName),
@@ -2476,6 +2561,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _split_string_into_words__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./split-string-into-words */ "./src/string/split-string-into-words.ts");
 /* harmony import */ var _is_nil_or_empty_string__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./is-nil-or-empty-string */ "./src/string/is-nil-or-empty-string.ts");
 /* harmony import */ var _parse_file_name__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./parse-file-name */ "./src/string/parse-file-name.ts");
+/* harmony import */ var _find_char_indices__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./find-char-indices */ "./src/string/find-char-indices.ts");
+/* harmony import */ var _for_each_char__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./for-each-char */ "./src/string/for-each-char.ts");
+
+
 
 
 
@@ -2717,6 +2806,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   filterParallel: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.filterParallel),
 /* harmony export */   filterSequential: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.filterSequential),
 /* harmony export */   findAsync: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.findAsync),
+/* harmony export */   findCharIndices: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_1__.findCharIndices),
+/* harmony export */   forEachChar: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_1__.forEachChar),
 /* harmony export */   getDOMRectIntersectionRatio: () => (/* reexport safe */ _intersection__WEBPACK_IMPORTED_MODULE_10__.getDOMRectIntersectionRatio),
 /* harmony export */   getElementOffsetRect: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.getElementOffsetRect),
 /* harmony export */   getFocusableHtmlElements: () => (/* reexport safe */ _a11y__WEBPACK_IMPORTED_MODULE_11__.getFocusableHtmlElements),