@ehfuse/mui-form-controls 3.1.16 → 3.1.18

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";

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 { clampNumberToRange, formatNumber, formatNumberFieldDisplay, 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,15 +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): string;
+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.16",
+    "version": "3.1.18",
     "description": "Material-UI form controls and text fields for complex forms",
     "private": false,
     "publishConfig": {

package/dist/SwitchField.d.ts

@@ -1,10 +0,0 @@
-/**
- * SwitchField.tsx
- *
- * @license MIT
- * @copyright 2025 김영진 (Kim Young Jin)
- * @author 김영진 (ehfuse@gmail.com)
- */
-import React from "react";
-import type { SwitchFieldProps } from "./types";
-export declare const SwitchField: React.ForwardRefExoticComponent<Omit<SwitchFieldProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/ToggleButtonGroupField.d.ts

@@ -1,10 +0,0 @@
-/**
- * ToggleButtonGroupField.tsx
- *
- * @license MIT
- * @copyright 2025 김영진 (Kim Young Jin)
- * @author 김영진 (ehfuse@gmail.com)
- */
-import React from "react";
-import type { ToggleButtonGroupFieldProps } from "./types";
-export declare const ToggleButtonGroupField: React.ForwardRefExoticComponent<Omit<ToggleButtonGroupFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/devDebug.d.ts

@@ -1,35 +0,0 @@
-/**
- * 패키지 전역 개발용 콘솔 로그 스위치.
- * 앱 진입 시 `setMuiFormControlsDebug(true)` 한 번이면
- * DateTextField / TimeTextField / DateTimeTextField 등에서 value 동기화 로그가 출력된다.
- * 필드가 많으면 `nameIncludes` / `nameMatch`, 컴포넌트만 골라서는 `scopes`로 범위를 줄일 수 있다.
- *
- * @license MIT
- */
-/** value 동기화 로그를 낼 수 있는 컴포넌트 scope (muiFormControlsDevLog 첫 인자와 동일) */
-export type MuiFormControlsDebugScope = "DateTextField" | "TimeTextField" | "DateTimeTextField";
-export type MuiFormControlsDebugOptions = {
-    /** `name` prop에 이 부분 문자열이 있을 때만 로그 (여러 필드일 때 노이즈 감소) */
-    nameIncludes?: string;
-    /** `name` prop이 이 정규식과 맞을 때만 로그 */
-    nameMatch?: RegExp;
-    /**
-     * 한 개 이상이면 **이 컴포넌트(scope)에서만** 로그.
-     * 생략 또는 빈 배열이면 scope 제한 없음(이름 필터만 적용).
-     */
-    scopes?: MuiFormControlsDebugScope[];
-};
-/**
- * @param enabled 로그 출력 여부
- * @param options `scopes` / `nameIncludes` / `nameMatch`로 범위 축소 (조건은 AND)
- */
-export declare function setMuiFormControlsDebug(enabled: boolean, options?: MuiFormControlsDebugOptions): void;
-export declare function getMuiFormControlsDebug(): boolean;
-export declare function getMuiFormControlsDebugOptions(): Readonly<MuiFormControlsDebugOptions & {
-    enabled: boolean;
-}>;
-/**
- * 컴포넌트 내부 전용.
- * @param scope 예: "DateTextField"
- */
-export declare function muiFormControlsDevLog(scope: string, payload: Record<string, unknown>): void;

package/dist/utils/outlinedFieldStyles.d.ts

@@ -1,5 +0,0 @@
-import type { SxProps, Theme } from "@mui/material/styles";
-export declare const CLOSED_OUTLINED_BORDER_COLOR = "rgba(0, 0, 0, 0.23)";
-export declare const CLOSED_OUTLINED_LABEL_COLOR = "rgba(0, 0, 0, 0.6)";
-export declare const outlinedFieldFocusToneSx: SxProps<Theme>;
-export declare const outlinedFieldReadonlyToneSx: SxProps<Theme>;