ansuko 1.3.7 → 1.3.8

package/README.ja.md

@@ -229,7 +229,7 @@ extended.toPointGeoJson([139.7, 35.6])
 
 ### 型変換と検証
 
-- **`toNumber`** - カンマ・全角対応の数値パース、無効時は `null`
+- **`toNumber`** - カンマ・全角対応の数値パース、`toFixed` で丸め可、無効時は `null`
 - **`toBool`** - スマートな真偽値変換（"yes"/"no"/"true"/"false"/数値）、未検出時の動作を設定可能
 - **`boolIf`** - フォールバック付き安全な真偽値変換
 - **`isValidStr`** - 非空文字列検証

package/README.md

@@ -107,7 +107,7 @@ const value = _.equalsOr(a, b, defaultValue)  // null == undefined
 
 ### Type Conversion & Validation
 
-- **`toNumber`** - Parse numbers with comma/full-width support, returns `null` for invalid
+- **`toNumber`** - Parse numbers with comma/full-width support, optional `toFixed` rounding, returns `null` for invalid
 - **`toBool`** - Smart boolean conversion ("yes"/"no"/"true"/"false"/numbers) with configurable undetected handling
 - **`boolIf`** - Safe boolean conversion with fallback
 - **`isValidStr`** - Non-empty string validation

package/README.zh.md

@@ -104,7 +104,7 @@ const value = _.equalsOr(a, b, defaultValue)  // null == undefined
 
 ### 类型转换与验证
 
-- **`toNumber`** - 解析包含逗号、全角字符的数字，无效时返回null
+- **`toNumber`** - 解析包含逗号、全角字符的数字，可选 `toFixed` 四舍五入，无效时返回null
 - **`toBool`** - 智能布尔值转换（支持 "yes"/"no"/"true"/"false"/数字），可配置未检测到时的行为检测处理
 - **`boolIf`** - 带有回退机制的安全布尔值转换
 - **`isValidStr`** - 非空字符串验证

package/dist/index.d.ts

@@ -45,14 +45,17 @@ declare const hasOr: <T, E>(value: MaybeFunction<MaybePromise<T | null | undefin
 declare const isEmpty: (value: unknown) => boolean;
 /**
  * Converts a value to number (full-width and comma aware). Returns null when invalid.
+ * Optionally rounds using Number.toFixed when `toFixed` is provided.
  * @param value - Value to convert
+ * @param toFixed - Fraction digits to round to (uses Number.toFixed)
  * @returns number or null
  * @example toNumber('1,234.5') // 1234.5
+ * @example toNumber('1,234.56', 1) // 1234.6
  * @example toNumber('１２３') // 123
  * @example toNumber('abc') // null
  * @category Core Functions
  */
-declare const toNumber: (value: unknown) => number | null;
+declare const toNumber: (value: unknown, toFixed?: number) => number | null;
 /**
  * Converts various inputs to boolean. Numbers: 0 -> false, non-zero -> true.
  * Strings: 'true'|'t'|'y'|'yes'|'ok' -> true; 'false'|'f'|'n'|'no'|'ng' -> false.

package/dist/index.js

@@ -133,14 +133,17 @@ const isEmpty = (value) => {
 };
 /**
  * Converts a value to number (full-width and comma aware). Returns null when invalid.
+ * Optionally rounds using Number.toFixed when `toFixed` is provided.
  * @param value - Value to convert
+ * @param toFixed - Fraction digits to round to (uses Number.toFixed)
  * @returns number or null
  * @example toNumber('1,234.5') // 1234.5
+ * @example toNumber('1,234.56', 1) // 1234.6
  * @example toNumber('１２３') // 123
  * @example toNumber('abc') // null
  * @category Core Functions
  */
-const toNumber = (value) => {
+const toNumber = (value, toFixed) => {
     if (_.isNil(value)) {
         return null;
     }
@@ -157,7 +160,13 @@ const toNumber = (value) => {
     else {
         v = _.toNumber(v);
     }
-    return _.isNaN(v) ? null : v;
+    if (_.isNaN(v)) {
+        return null;
+    }
+    if (toFixed !== undefined) {
+        return parseFloat(v.toFixed(toFixed));
+    }
+    return v;
 };
 /**
  * Converts various inputs to boolean. Numbers: 0 -> false, non-zero -> true.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansuko",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "A modern JavaScript/TypeScript utility library that extends lodash with practical, intuitive behaviors. Fixes lodash quirks, adds Promise support, Japanese text processing, and GeoJSON utilities.",
   "keywords": [
     "lodash",