@ehfuse/mui-form-controls 1.0.0

package/dist/utils/jumin.d.ts

@@ -0,0 +1,27 @@
+/**
+ * jumin.ts - 주민등록번호 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { JuminInfo } from "../types";
+/**
+ * 주민번호 뒷자리 2~3번째 숫자로 지역 추출
+ * (2020년 10월 이후 출생자는 랜덤 부여로 의미 없음)
+ */
+export declare const REGION_MAP: Record<string, string>;
+/**
+ * 주민번호에서 정보 추출
+ */
+export declare function extractJuminInfo(value: string): Omit<JuminInfo, "isValid">;
+/**
+ * 주민등록번호 체크섬 검증
+ * - 13자리 각 숫자에 가중치 [2,3,4,5,6,7,8,9,2,3,4,5]를 곱하여 합산
+ * - (11 - (합계 % 11)) % 10 === 마지막 자리
+ */
+export declare function validateJuminChecksum(numbers: string): boolean;
+/**
+ * 주민등록번호 생년월일 유효성 검증
+ */
+export declare function validateJuminBirthDate(numbers: string): boolean;

package/dist/utils/number.d.ts

@@ -0,0 +1,15 @@
+/**
+ * number.ts - 숫자 포맷팅 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+/**
+ * 숫자 포맷팅 함수
+ */
+export declare function formatNumber(value: string, thousandSeparator: boolean, decimalLength?: number): string;
+/**
+ * 표시 값에서 실제 숫자 값 추출
+ */
+export declare function parseNumber(displayValue: string): string;

package/dist/utils/password.d.ts

@@ -0,0 +1,17 @@
+/**
+ * password.ts - 비밀번호 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { PasswordValidationRules, PasswordValidationResult } from "../types";
+export declare const DEFAULT_SPECIAL_CHARS = "!@#$%^&*()_+-=[]{}|;:,.<>?";
+/**
+ * 기본 유효성 검사 규칙
+ */
+export declare const DEFAULT_PASSWORD_VALIDATION_RULES: PasswordValidationRules;
+/**
+ * 비밀번호 유효성 검사 함수
+ */
+export declare function validatePassword(value: string, rules: PasswordValidationRules): PasswordValidationResult;

package/dist/utils/phone.d.ts

@@ -0,0 +1,17 @@
+/**
+ * phone.ts - 전화번호 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { PhoneFormat } from "../types";
+/**
+ * 전화번호 자동 포맷팅 함수
+ * 입력된 번호를 보고 자동으로 포맷 판단
+ */
+export declare function formatPhoneNumber(value: string, customFormat?: PhoneFormat): string;
+/**
+ * 입력된 번호에 따른 최대 길이 계산
+ */
+export declare function getPhoneMaxLength(numbers: string): number;

package/dist/utils/time.d.ts

@@ -0,0 +1,27 @@
+/**
+ * time.ts - 시간 관련 유틸리티 함수
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import type { TimeFormat } from "../types";
+/**
+ * 포맷에 따른 필드 개수 (2: 시:분, 3: 시:분:초)
+ */
+export declare function getTimeFieldCount(format: TimeFormat): number;
+/**
+ * 12시간 형식인지 확인
+ */
+export declare function is12HourFormat(format: string): boolean;
+/**
+ * 시간 유효성 검사
+ * @param formatOrIs12Hour - TimeFormat 문자열 또는 12시간제 여부 boolean
+ */
+export declare function validateTime(hour: string, minute: string, second: string, formatOrIs12Hour: TimeFormat | boolean, minTime?: string, maxTime?: string): boolean;
+/**
+ * 시간 값 제한 (시/분/초)
+ * - 24시간 형식에서 24 이상을 입력하면 24를 빼서 변환 (24→00, 25→01, 26→02, ...)
+ * - 첫 자리가 범위 초과 시 앞에 0을 붙여서 두 자리로 변환
+ */
+export declare function clampTimeValue(value: string, type: "hour" | "minute" | "second", is12Hour?: boolean): string;

package/package.json

@@ -0,0 +1,78 @@
+{
+    "name": "@ehfuse/mui-form-controls",
+    "version": "1.0.0",
+    "description": "Material-UI form controls and text fields for complex forms",
+    "private": false,
+    "publishConfig": {
+        "access": "restricted"
+    },
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "node build.mjs",
+        "build:types": "tsc --emitDeclarationOnly",
+        "prepublishOnly": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ehfuse/mui-form-controls.git"
+    },
+    "keywords": [
+        "react",
+        "mui",
+        "material-ui",
+        "form",
+        "controls",
+        "textfield",
+        "textarea",
+        "select",
+        "autocomplete",
+        "checkbox",
+        "switch",
+        "radio",
+        "slider",
+        "search",
+        "password",
+        "clear-button",
+        "input"
+    ],
+    "author": "김영진 (Kim Young Jin) <ehfuse@gmail.com>",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/ehfuse/mui-form-controls/issues"
+    },
+    "homepage": "https://github.com/ehfuse/mui-form-controls#readme",
+    "devDependencies": {
+        "@ehfuse/alerts": "^1.0.0",
+        "@ehfuse/overlay-scrollbar": "^1.5.12",
+        "@types/react": "^19.2.7",
+        "@types/react-daum-postcode": "^1.3.4",
+        "@types/react-dom": "^19.2.3",
+        "esbuild": "^0.27.0",
+        "typescript": "^5.9.3"
+    },
+    "peerDependencies": {
+        "@ehfuse/alerts": "^1.0.0",
+        "@ehfuse/forma": "^3.1.0",
+        "@ehfuse/mui-datetime-picker": "^1.0.8",
+        "@ehfuse/overlay-scrollbar": "^1.5.0",
+        "@emotion/react": "^11.0.0",
+        "@emotion/styled": "^11.0.0",
+        "@mui/icons-material": "^5.0.0 || ^6.0.0 || ^7.0.0",
+        "@mui/material": "^5.0.0 || ^6.0.0 || ^7.0.0",
+        "react": "^18.0.0 || ^19.0.0",
+        "react-daum-postcode": "^3.0.0",
+        "react-dom": "^18.0.0 || ^19.0.0"
+    }
+}