@sia.soul/sia-react-ui 0.1.94 → 0.1.95

package/dist/index.cjs

@@ -11691,6 +11691,8 @@ var InputNumber = (0, import_react44.forwardRef)(function InputNumber2({
   max,
   step = 1,
   precision,
+  formatter,
+  parser,
   size: sizeProp,
   status = "default",
   prefix,
@@ -11711,10 +11713,14 @@ var InputNumber = (0, import_react44.forwardRef)(function InputNumber2({
   const inputId = id ?? fallbackId;
   const localRef = (0, import_react44.useRef)(null);
   const [currentValue, setCurrentValue] = useControllableState({ value, defaultValue, onChange });
-  const [text, setText] = (0, import_react44.useState)(() => formatValue(currentValue, precision));
+  const displayValue = (next) => {
+    const plain = formatValue(next, precision);
+    return plain && formatter ? formatter(plain) : plain;
+  };
+  const [text, setText] = (0, import_react44.useState)(() => displayValue(currentValue));
   (0, import_react44.useEffect)(() => {
-    setText(formatValue(currentValue, precision));
-  }, [currentValue, precision]);
+    setText(displayValue(currentValue));
+  }, [currentValue, precision, formatter]);
   function setRef(node) {
     localRef.current = node;
     if (typeof forwardedRef === "function") forwardedRef(node);
@@ -11733,19 +11739,33 @@ var InputNumber = (0, import_react44.forwardRef)(function InputNumber2({
       setCurrentValue(null);
       return;
     }
-    const parsed = Number(rawText);
+    let parsed;
+    try {
+      const value2 = parser ? parser(rawText) : rawText;
+      if (typeof value2 === "string" && value2.trim() === "") {
+        setText("");
+        setCurrentValue(null);
+        return;
+      }
+      parsed = Number(value2);
+    } catch {
+      setText(displayValue(currentValue));
+      return;
+    }
     if (!Number.isFinite(parsed)) {
-      setText(formatValue(currentValue, precision));
+      setText(displayValue(currentValue));
       return;
     }
     const nextValue = normalize(parsed);
-    setText(formatValue(nextValue, precision));
+    setText(displayValue(nextValue));
     setCurrentValue(nextValue);
   }
   function changeBy(direction) {
     if (disabled || readOnly) return;
     const baseValue = currentValue ?? 0;
-    commit(String(baseValue + step * direction));
+    const nextValue = normalize(baseValue + step * direction);
+    setText(displayValue(nextValue));
+    setCurrentValue(nextValue);
     localRef.current?.focus();
   }
   function handleBlur(event) {

package/dist/index.d.cts

@@ -1652,6 +1652,16 @@ interface InputNumberProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "
     step?: number;
     /** 固定小数位数 */
     precision?: number;
+    /**
+     * 将已提交的数值转换为显示文本，例如千分位或货币符号；输入过程中保留原始草稿，失焦、回车、步进及外部 value 更新后格式化。
+     * 参数为应用 precision 后的十进制文本，空值为空字符串；应返回显示文本，并与 parser 配套。未指定时显示普通十进制文本。
+     */
+    formatter?: (value: string) => string;
+    /**
+     * 失焦或回车时将输入文本解析为数字或数字字符串；无效值或抛出异常时恢复当前值，不触发 onChange。
+     * 空输入或解析为空字符串提交 null；未指定时使用 Number 转换。步进使用数值计算，不经过 parser。
+     */
+    parser?: (text: string) => number | string;
     /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
     size?: ControlSize;
     /**

package/dist/index.d.ts

@@ -1652,6 +1652,16 @@ interface InputNumberProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "
     step?: number;
     /** 固定小数位数 */
     precision?: number;
+    /**
+     * 将已提交的数值转换为显示文本，例如千分位或货币符号；输入过程中保留原始草稿，失焦、回车、步进及外部 value 更新后格式化。
+     * 参数为应用 precision 后的十进制文本，空值为空字符串；应返回显示文本，并与 parser 配套。未指定时显示普通十进制文本。
+     */
+    formatter?: (value: string) => string;
+    /**
+     * 失焦或回车时将输入文本解析为数字或数字字符串；无效值或抛出异常时恢复当前值，不触发 onChange。
+     * 空输入或解析为空字符串提交 null；未指定时使用 Number 转换。步进使用数值计算，不经过 parser。
+     */
+    parser?: (text: string) => number | string;
     /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
     size?: ControlSize;
     /**

package/dist/index.js

@@ -4199,6 +4199,8 @@ var InputNumber = forwardRef4(function InputNumber2({
   max,
   step = 1,
   precision,
+  formatter,
+  parser,
   size: sizeProp,
   status = "default",
   prefix,
@@ -4219,10 +4221,14 @@ var InputNumber = forwardRef4(function InputNumber2({
   const inputId = id ?? fallbackId;
   const localRef = useRef11(null);
   const [currentValue, setCurrentValue] = useControllableState({ value, defaultValue, onChange });
-  const [text, setText] = useState13(() => formatValue(currentValue, precision));
+  const displayValue = (next) => {
+    const plain = formatValue(next, precision);
+    return plain && formatter ? formatter(plain) : plain;
+  };
+  const [text, setText] = useState13(() => displayValue(currentValue));
   useEffect9(() => {
-    setText(formatValue(currentValue, precision));
-  }, [currentValue, precision]);
+    setText(displayValue(currentValue));
+  }, [currentValue, precision, formatter]);
   function setRef(node) {
     localRef.current = node;
     if (typeof forwardedRef === "function") forwardedRef(node);
@@ -4241,19 +4247,33 @@ var InputNumber = forwardRef4(function InputNumber2({
       setCurrentValue(null);
       return;
     }
-    const parsed = Number(rawText);
+    let parsed;
+    try {
+      const value2 = parser ? parser(rawText) : rawText;
+      if (typeof value2 === "string" && value2.trim() === "") {
+        setText("");
+        setCurrentValue(null);
+        return;
+      }
+      parsed = Number(value2);
+    } catch {
+      setText(displayValue(currentValue));
+      return;
+    }
     if (!Number.isFinite(parsed)) {
-      setText(formatValue(currentValue, precision));
+      setText(displayValue(currentValue));
       return;
     }
     const nextValue = normalize(parsed);
-    setText(formatValue(nextValue, precision));
+    setText(displayValue(nextValue));
     setCurrentValue(nextValue);
   }
   function changeBy(direction) {
     if (disabled || readOnly) return;
     const baseValue = currentValue ?? 0;
-    commit(String(baseValue + step * direction));
+    const nextValue = normalize(baseValue + step * direction);
+    setText(displayValue(nextValue));
+    setCurrentValue(nextValue);
     localRef.current?.focus();
   }
   function handleBlur(event) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sia.soul/sia-react-ui",
-  "version": "0.1.94",
+  "version": "0.1.95",
   "description": "Sia Design components and tokens for React",
   "publishConfig": {
     "access": "public",