@ehfuse/mui-form-controls 3.0.59 → 3.0.61

package/dist/types.d.ts

@@ -7,6 +7,7 @@
  */
 import * as React from "react";
 import type { TextFieldProps as MuiTextFieldProps } from "@mui/material/TextField";
+import type { ChipProps } from "@mui/material/Chip";
 import type { SxProps, Theme } from "@mui/material/styles";
 import type { CheckboxProps as MuiCheckboxProps } from "@mui/material/Checkbox";
 import type { SwitchProps as MuiSwitchProps } from "@mui/material/Switch";
@@ -271,6 +272,38 @@ export type ClearTextFieldProps = TextFieldProps & BaseTextFieldProps & {
     spellCheck?: boolean;
     onClear?: () => void;
 };
+export type TagsTextFieldProps = Omit<TextFieldProps, "value" | "defaultValue" | "onChange" | "type" | "select" | "multiline"> & BaseTextFieldProps & {
+    value?: string[];
+    defaultValue?: string[];
+    onChange?: (value: string[]) => void;
+    separators?: string[];
+    allowDuplicates?: boolean;
+    maxTags?: number;
+    chipProps?: Partial<ChipProps>;
+    chipsSx?: SxProps<Theme>;
+    deleteIconSx?: SxProps<Theme>;
+    draggable?: boolean;
+    spaceToConfirm?: boolean;
+    backspaceToDelete?: boolean;
+    showDeleteIcon?: boolean;
+    /**
+     * X 클릭 직전. `false`를 반환하면 삭제를 진행하지 않음(동기 가드·모달 전 차단 등).
+     * `onDelete`가 없을 때만 기본 삭제와 조합됨.
+     */
+    onDeleteBefore?: (event: React.SyntheticEvent, tag: string, index: number) => boolean | void;
+    /**
+     * X 클릭 시 호출. 지정하면 **기본 삭제는 하지 않으며** 이 콜백만 실행됨.
+     * 모달 확인 후 `onChange`/`form.setFormValue`로 배열에서 제거하면 됨.
+     * 지정하지 않으면 내부에서 태그를 제거한 뒤 `onChange`만 호출함.
+     */
+    onDelete?: (event: React.SyntheticEvent, tag: string, index: number) => void;
+    /**
+     * 태그 칩 본문 클릭 시(삭제 아이콘 제외). 상세 모달·라우팅 등에 사용.
+     * `chipProps.onClick`이 있으면 먼저 호출한 뒤, `event.defaultPrevented`가 아니면 이 콜백을 호출함.
+     * `draggable`이 true이면 짧은 클릭과 드래그가 겹칠 수 있음(센서는 기본 5px 이동 후 드래그).
+     */
+    onTagClick?: (event: React.MouseEvent, tag: string, index: number) => void;
+};
 /**
  * 비밀번호 유효성 검사 규칙
  */

package/dist/utils/date.d.ts

@@ -112,3 +112,34 @@ export declare function buildDateOutputValue(formattedValue: string, format: Dat
  * Date 객체에서 포맷에 맞는 숫자 문자열 생성
  */
 export declare function dateToNumbers(date: Date, format: DateFormat): string;
+export type ParsedPasteDateTime = {
+    dateDisplay: string;
+    hour: string;
+    minute: string;
+    second: string;
+    /** 연도 없는 날짜 포맷에서 ISO 등으로 연도를 알 수 있을 때 */
+    internalYear?: number | null;
+};
+/**
+ * DateTimeTextField용: 클립보드 텍스트가 현재 날짜·시간 포맷과 호환되면 파싱 결과를 반환한다.
+ * AM/PM 없는 시간은 24시간 해석 후 12시간 표시로 변환한다.
+ */
+export declare function tryParsePastedDateTimeClipboard(raw: string, dateFormat: DateFormat, _dateTimeFormat: DateTimeFormat, options: {
+    hasSecond: boolean;
+    is12Hour: boolean;
+    minDateTime?: Date;
+    maxDateTime?: Date;
+    minTime?: string;
+    maxTime?: string;
+}): ParsedPasteDateTime | null;
+export type ParsedPasteDateOnly = {
+    display: string;
+    internalYear?: number | null;
+};
+/**
+ * DateTextField용: "YYYY-MM-DD" 또는 "YYYY-MM-DD HH:mm" 등에서 날짜만 파싱
+ */
+export declare function tryParsePastedDateClipboard(raw: string, dateFormat: DateFormat, options: {
+    minDate?: Date;
+    maxDate?: Date;
+}): ParsedPasteDateOnly | null;

package/dist/utils/index.d.ts

@@ -5,7 +5,8 @@
  * @copyright 2025 김영진 (Kim Young Jin)
  * @author 김영진 (ehfuse@gmail.com)
  */
-export { isLeapYear, getDaysInMonth, getSeparator, formatDate, getMaxLength, getCompleteLength, parseDateParts, validateDate, parseToDate, clampDateValue, extractDateFormat, hasSecondField, constrainDateNumbers, formatDateValue, formatToPlaceholder, getSegmentRange, hasYearInFormat, has2DigitYear, convertYY2YYYY, parseDateWithInternalYear, buildDateOutputValue, dateToNumbers, } from "./date";
+export { isLeapYear, getDaysInMonth, getSeparator, formatDate, getMaxLength, getCompleteLength, parseDateParts, validateDate, parseToDate, clampDateValue, extractDateFormat, hasSecondField, constrainDateNumbers, formatDateValue, formatToPlaceholder, getSegmentRange, hasYearInFormat, has2DigitYear, convertYY2YYYY, parseDateWithInternalYear, buildDateOutputValue, dateToNumbers, tryParsePastedDateTimeClipboard, tryParsePastedDateClipboard, } from "./date";
+export type { ParsedPasteDateTime, ParsedPasteDateOnly } from "./date";
 export { getTimeFieldCount, is12HourFormat, validateTime, clampTimeValue, } from "./time";
 export { formatNumber, parseNumber } from "./number";
 export { DEFAULT_EMAIL_DOMAINS, validateEmail } from "./email";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ehfuse/mui-form-controls",
-    "version": "3.0.59",
+    "version": "3.0.61",
     "description": "Material-UI form controls and text fields for complex forms",
     "private": false,
     "publishConfig": {
@@ -86,5 +86,11 @@
         "react-daum-postcode": {
             "optional": true
         }
+    },
+    "dependencies": {
+        "@dnd-kit/core": "^6.3.1",
+        "@dnd-kit/modifiers": "^9.0.0",
+        "@dnd-kit/sortable": "^10.0.0",
+        "@dnd-kit/utilities": "^3.2.2"
     }
 }