@ehfuse/mui-form-controls 3.1.15 → 3.1.17

package/dist/types.d.ts

@@ -356,7 +356,8 @@ export type PhoneTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldPr
  * 숫자 텍스트 필드 타입
  */
 export type NumberTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & {
-    thousandSeparator?: boolean;
+    /** `false` 끔 · `true`/`undefined` 콤마(`,`) · `string` 구분 문자 지정 (예: `"."`, `" "`) */
+    thousandSeparator?: boolean | string;
     decimalLength?: number;
     decimalFixed?: boolean;
     textAlign?: "left" | "center" | "right";
@@ -529,6 +530,11 @@ export type BizNumTextFieldProps = Omit<TextFieldProps, "type" | "value"> & Base
     fontColor?: string;
     fontFamily?: string;
 };
+/** CardNumTextField ref — `focus()`는 이어 쓸 위치로, `blur()`는 포커스 해제 */
+export type CardNumTextFieldHandle = {
+    focus: () => void;
+    blur: () => void;
+};
 /**
  * 카드번호 텍스트 필드 타입
  */

package/dist/utils/index.d.ts

@@ -8,7 +8,8 @@
 export { isLeapYear, getDaysInMonth, getSeparator, formatDate, getMaxLength, getCompleteLength, parseDateParts, validateDate, parseToDate, clampDateValue, extractDateFormat, hasSecondField, constrainDateNumbers, formatDateValue, formatToPlaceholder, getSegmentRange, hasYearInFormat, has2DigitYear, convertYY2YYYY, parseDateWithInternalYear, buildDateOutputValue, dateToNumbers, tryParsePastedDateTimeClipboard, tryParsePastedDateClipboard, } from "./date";
 export type { ParsedPasteDateTime, ParsedPasteDateOnly } from "./date";
 export { getTimeFieldCount, is12HourFormat, validateTime, clampTimeValue, } from "./time";
-export { formatNumber, parseNumber } from "./number";
+export { clampNumberToRange, formatNumber, formatNumberFieldDisplay, isThousandGroupingEnabled, parseNumber, resolveThousandSeparator, stripGroupingFromInput, } from "./number";
+export type { ResolvedThousandSeparator, ThousandSeparatorProp, } from "./number";
 export { DEFAULT_EMAIL_DOMAINS, validateEmail } from "./email";
 export { formatPhoneNumber, getPhoneMaxLength } from "./phone";
 export { DEFAULT_SPECIAL_CHARS, DEFAULT_PASSWORD_VALIDATION_RULES, validatePassword, } from "./password";

package/dist/utils/number.d.ts

@@ -5,11 +5,43 @@
  * @copyright 2025 김영진 (Kim Young Jin)
  * @author 김영진 (ehfuse@gmail.com)
  */
+/** `false` 끔 · `true`/`undefined` 기본 그룹 · `string` 구분 문자 직접 지정 */
+export type ThousandSeparatorProp = boolean | string | undefined;
+export type ResolvedThousandSeparator = {
+    enabled: false;
+} | {
+    enabled: true;
+    kind: "intl";
+} | {
+    enabled: true;
+    kind: "char";
+    char: string;
+};
+/**
+ * thousandSeparator 해석
+ * @param intlWhenTrue `true`/`undefined`일 때 Intl 그룹(NumberField), 아니면 `,`(NumberTextField)
+ */
+export declare function resolveThousandSeparator(value: ThousandSeparatorProp, options?: {
+    intlWhenTrue?: boolean;
+}): ResolvedThousandSeparator;
+export declare function isThousandGroupingEnabled(value: ThousandSeparatorProp, options?: {
+    intlWhenTrue?: boolean;
+}): boolean;
+/** 표시 문자열에서 천 단위 구분 문자 제거 */
+export declare function stripGroupingFromInput(value: string, thousandSeparator: ThousandSeparatorProp, options?: {
+    intlWhenTrue?: boolean;
+}): string;
 /**
  * 숫자 포맷팅 함수
  */
-export declare function formatNumber(value: string, thousandSeparator: boolean, decimalLength?: number): string;
+export declare function formatNumber(value: string, thousandSeparator: ThousandSeparatorProp, decimalLength?: number): string;
 /**
  * 표시 값에서 실제 숫자 값 추출
  */
-export declare function parseNumber(displayValue: string): string;
+export declare function parseNumber(displayValue: string, thousandSeparator?: ThousandSeparatorProp): string;
+/** min/max 범위로 숫자 값 보정 (경계 미지정 시 해당 방향은 보정하지 않음) */
+export declare function clampNumberToRange(value: number | null | undefined, min?: number, max?: number): number | null;
+/** NumberField 입력란에 표시할 포맷 문자열 */
+export declare function formatNumberFieldDisplay(value: number, locale?: Intl.LocalesArgument, format?: Intl.NumberFormatOptions, thousandSeparator?: ThousandSeparatorProp, options?: {
+    intlWhenTrue?: boolean;
+}): string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ehfuse/mui-form-controls",
-    "version": "3.1.15",
+    "version": "3.1.17",
     "description": "Material-UI form controls and text fields for complex forms",
     "private": false,
     "publishConfig": {