@ehfuse/mui-form-controls 3.0.57 → 3.0.59

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,16 +372,32 @@ export type JuminInfo = {
 };
 /**
  * 주민등록번호 텍스트 필드 타입
+ *
+ * **오류 표시(테두리·라벨)**: MUI `error`(TextField)와 emitChange와 동일한 내부 유효성(생일·13자·체크섬)을
+ * `finalError = Boolean(error) || (내부 실패)`로 병합한다. 내부 실패로 빨간 테두리는 마스킹 7자리·비마스킹 13자리가
+ * 모두 채워진 뒤에만 적용된다(입력 중에는 표시하지 않음). `error === true`이면 내부가 유효해도 항상 오류 스타일.
+ *
+ * `invalidBorderColor`(`ValidatableTextFieldProps`)는 `finalError`일 때
+ * notched outline·`InputLabel`에 적용(미지정 시 `theme.palette.error`). `helperText` 색은 MUI 기본.
+ *
+ * `showInvalidTooltip`이 `true`이면 `finalError`일 때 MUI `Tooltip`으로 안내 문구를 연다(오류가 해소되면 닫힌다).
+ * 툴팁은 `placement="top"`·`arrow`로 입력 영역(앵커)을 가리키는 화살표를 표시한다. 문구는 패키지 고정 한국어 문구를 쓴다.
+ *
+ * @see isJuminValueValid
+ * @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;
     fontFamily?: string;
     onChange?: (info: JuminInfo) => void;
+    /** `true`이면 유효하지 않을 때(`finalError`) 툴팁 표시를 허용한다. 기본 `false`. */
+    showInvalidTooltip?: boolean;
 };
 /**
  * 커스텀 도메인 정의 (아이콘 포함)

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, isJuminValueValid, isJuminValueInvalidState, sanitizeJuminFrontBirthDigits, canAppendJuminBirthDigit, maxDayForJuminFrontYyMm, } from "./jumin";

package/dist/utils/jumin.d.ts

@@ -25,3 +25,26 @@ export declare function validateJuminChecksum(numbers: string): boolean;
  * 주민등록번호 생년월일 유효성 검증
  */
 export declare function validateJuminBirthDate(numbers: string): boolean;
+/**
+ * 앞 6자리(YYMMDD)만 있을 때, 성별코드가 없어 세기를 모르므로 19xx·20xx 중
+ * 해당 월의 일수가 더 큰 값을 사용한다(윤년·평년 모두 반영).
+ */
+export declare function maxDayForJuminFrontYyMm(yy: string, mmStr: string): number;
+/** YYMMDD 앞부분(prefix 0~5자리)에 한 자리를 붙일 수 있는지 */
+export declare function canAppendJuminBirthDigit(prefix: string, digit: string): boolean;
+/**
+ * 주민번호 앞 6자리(YYMMDD)에서 월(01~12)·일(해당 월 최대 일수) 규칙을 만족하는
+ * 최대 접두만 남긴다. 붙여넣기·입력 필터에 사용한다.
+ */
+export declare function sanitizeJuminFrontBirthDigits(value: string): string;
+/**
+ * 마스킹 7자리·비마스킹 13자리가 모두 채워졌을 때 전체 값이 유효한지.
+ * (`JuminTextField`의 `emitChange`·`onValidationChange`와 동일 규칙)
+ */
+export declare function isJuminValueValid(fullValue: string, mask: boolean, validateChecksum: boolean): boolean;
+/**
+ * JuminTextField(emitChange)와 동일한 규칙으로, 현재 앞/뒤 숫자를 이었을 때
+ * 오류 UI(빨간 테두리)에 해당하는지. 값이 없으면 `false` (빨간 테두리 없음).
+ * 마스킹 7자리·비마스킹 13자리가 모두 채워진 뒤에만 내부 유효성 실패 시 `true`이다.
+ */
+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.57",
+    "version": "3.0.59",
     "description": "Material-UI form controls and text fields for complex forms",
     "private": false,
     "publishConfig": {