@ehfuse/mui-form-controls 3.1.17 → 3.1.19

package/dist/components/NumberField.d.ts

@@ -24,6 +24,19 @@ export type NumberFieldProps = BaseNumberField.Root.Props & {
     thousandSeparator?: ThousandSeparatorProp;
     /** @default "default" — `stepper`는 [-] 값 [+] 가로 스테퍼 UI */
     variant?: NumberFieldVariant;
+    /**
+     * 값이 정확히 0일 때 입력칸을 빈칸으로 표시한다 (placeholder만 노출).
+     *
+     * 내부 값은 항상 숫자(0 포함)로 유지되므로 base-ui의 스피너 증감이 정상 동작한다
+     * (빈칸=0에서 ▲ → 1, 1에서 ▼ → 0=빈칸). 표시(렌더링)만 비우며,
+     * `onValueChange`로는 숫자 0이 그대로 전달된다. 포커스/입력 중에는 사용자가
+     * 타이핑한 값을 그대로 보여주고, 비포커스 상태에서만 0을 빈칸으로 표시한다.
+     *
+     * `default`·`stepper` 두 variant 모두에 적용된다.
+     * 0을 그대로 `0`으로 표시하려면 `clearWhenZero={false}`로 끈다.
+     * @default true
+     */
+    clearWhenZero?: boolean;
     /**
      * `variant="stepper"`일 때 가운데를 키패드·키보드로 직접 입력할지 여부.
      * @default false — Typography로 숫자만 표시 (장바구니 수량 UI 등)

package/dist/hooks/useNumberFieldLiveGrouping.d.ts

@@ -9,10 +9,16 @@
  */
 import * as React from "react";
 import { type ThousandSeparatorProp } from "../utils/number";
-export declare function useNumberFieldLiveGrouping({ thousandSeparator, locale, format, }: {
+export declare function useNumberFieldLiveGrouping({ thousandSeparator, locale, format, clearWhenZero, }: {
     thousandSeparator?: ThousandSeparatorProp;
     locale?: Intl.LocalesArgument;
     format?: Intl.NumberFormatOptions;
+    /**
+     * 값이 정확히 0이고 입력칸에 포커스가 없을 때 표시 문자열을 빈 문자열로 비운다.
+     * 내부 숫자 값(0)은 그대로 유지되므로 스피너 증감은 정상 동작한다.
+     * @default false
+     */
+    clearWhenZero?: boolean;
 }): {
     getDisplayValue: (baseInputValue: string) => string;
     syncBaseInputValue: (baseInputValue: string) => void;