@ehfuse/mui-form-controls 3.0.55 → 3.0.56

package/dist/types.d.ts

@@ -19,7 +19,6 @@ 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;
@@ -66,11 +65,6 @@ 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;
@@ -250,6 +244,7 @@ export type { SelectChangeEvent };
  */
 export type ValidatableTextFieldProps = {
     onValidationChange?: (isValid: boolean) => void;
+    /** 컴포넌트에 따라 유효성 실패 시 notched outline·라벨 등에 적용(미지정 시 theme error). */
     invalidBorderColor?: string;
 };
 export type SearchTextFieldProps = TextFieldProps & BaseTextFieldProps & {
@@ -370,11 +365,20 @@ 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, } from "./jumin";
+export { REGION_MAP, extractJuminInfo, validateJuminChecksum, validateJuminBirthDate, isJuminValueInvalidState, } from "./jumin";

package/dist/utils/jumin.d.ts

@@ -25,3 +25,9 @@ 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/dist/utils/outlinedFieldStyles.d.ts

@@ -0,0 +1,5 @@
+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>;

package/package.json

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