@ehfuse/mui-form-controls 3.0.57 → 3.0.58

package/dist/types.d.ts

@@ -250,6 +250,7 @@ export type { SelectChangeEvent };
  */
 export type ValidatableTextFieldProps = {
     onValidationChange?: (isValid: boolean) => void;
+    /** 컴포넌트에 따라 유효성 실패 시 notched outline·라벨 등에 적용(미지정 시 theme error). */
     invalidBorderColor?: string;
 };
 export type SearchTextFieldProps = TextFieldProps & BaseTextFieldProps & {
@@ -371,11 +372,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/package.json

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