@ehfuse/mui-form-controls 3.0.56 → 3.0.57

package/dist/types.d.ts

@@ -19,6 +19,7 @@ import type { ButtonGroupProps as MuiButtonGroupProps } from "@mui/material/Butt
 import type { StepperProps as MuiStepperProps } from "@mui/material/Stepper";
 import type { SelectProps as MuiSelectProps, SelectChangeEvent } from "@mui/material/Select";
 import type { FormControlProps } from "@mui/material/FormControl";
+import type { InputLabelProps } from "@mui/material/InputLabel";
 import type { InputBaseComponentProps } from "@mui/material/InputBase";
 import type { TextFieldProps as MuiBaseTextFieldProps } from "@mui/material/TextField";
 export type TextFieldProps = MuiTextFieldProps;
@@ -65,6 +66,11 @@ export type TextAreaProps = BaseTextFieldProps & {
     sx?: SxProps<Theme>;
     inputProps?: React.TextareaHTMLAttributes<HTMLTextAreaElement>;
     inputRef?: React.Ref<HTMLTextAreaElement>;
+    slotProps?: {
+        root?: Partial<FormControlProps>;
+        inputLabel?: Partial<InputLabelProps>;
+        htmlInput?: React.TextareaHTMLAttributes<HTMLTextAreaElement>;
+    };
 };
 export type CheckboxProps = Omit<MuiCheckboxProps, "checked" | "onChange" | "form"> & BaseTextFieldProps & LongPressToggleProps & {
     name?: string;
@@ -244,7 +250,6 @@ export type { SelectChangeEvent };
  */
 export type ValidatableTextFieldProps = {
     onValidationChange?: (isValid: boolean) => void;
-    /** 컴포넌트에 따라 유효성 실패 시 notched outline·라벨 등에 적용(미지정 시 theme error). */
     invalidBorderColor?: string;
 };
 export type SearchTextFieldProps = TextFieldProps & BaseTextFieldProps & {
@@ -293,6 +298,7 @@ export type PasswordValidationResult = {
 };
 export type PasswordTextFieldProps = Omit<TextFieldProps, "type"> & BaseTextFieldProps & Omit<ValidatableTextFieldProps, "onValidationChange"> & {
     showToggle?: boolean;
+    preventAutoFill?: boolean;
     validationRules?: PasswordValidationRules;
     onValidationChange?: (result: PasswordValidationResult) => void;
 };
@@ -365,20 +371,11 @@ export type JuminInfo = {
 };
 /**
  * 주민등록번호 텍스트 필드 타입
- *
- * **오류 표시(테두리·라벨)**: MUI `error`(TextField)와 emitChange와 동일한 내부 유효성(생일·13자·체크섬)을
- * `finalError = Boolean(error) || (내부 실패)`로 병합한다. `error === true`이면 내부가 유효해도 항상 오류 스타일.
- *
- * `invalidBorderColor`(`ValidatableTextFieldProps`)는 `finalError`일 때
- * notched outline·`InputLabel`에 적용(미지정 시 `theme.palette.error`). `helperText` 색은 MUI 기본.
- *
- * @see isJuminValueInvalidState
  */
 export type JuminTextFieldProps = Omit<TextFieldProps, "type" | "onChange" | "value"> & BaseTextFieldProps & ValidatableTextFieldProps & {
     value?: string;
     mask?: boolean;
     maskColor?: string;
-    /** `false`이면 13자리에서 체크섬 검사 생략(비마스킹만). */
     validateChecksum?: boolean;
     fontSize?: string | number;
     fontColor?: string;

package/dist/utils/index.d.ts

@@ -14,4 +14,4 @@ export { DEFAULT_SPECIAL_CHARS, DEFAULT_PASSWORD_VALIDATION_RULES, validatePassw
 export { validateBusinessNumber } from "./biznum";
 export { validateCardNumber, detectCardBrand } from "./card";
 export type { CardBrand } from "./card";
-export { REGION_MAP, extractJuminInfo, validateJuminChecksum, validateJuminBirthDate, isJuminValueInvalidState, } from "./jumin";
+export { REGION_MAP, extractJuminInfo, validateJuminChecksum, validateJuminBirthDate, } from "./jumin";

package/dist/utils/jumin.d.ts

@@ -25,9 +25,3 @@ export declare function validateJuminChecksum(numbers: string): boolean;
  * 주민등록번호 생년월일 유효성 검증
  */
 export declare function validateJuminBirthDate(numbers: string): boolean;
-/**
- * JuminTextField(emitChange)와 동일한 규칙으로, 현재 앞/뒤 숫자를 이었을 때
- * 오류 UI(빨간 테두리)에 해당하는지. 값이 없으면 `false` (빨간 테두리 없음).
- * 부분 입력 중에도 (기존 동작) 오류로 처리된다.
- */
-export declare function isJuminValueInvalidState(fullValue: string, mask: boolean, validateChecksum: boolean): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ehfuse/mui-form-controls",
-    "version": "3.0.56",
+    "version": "3.0.57",
     "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>;