@ehfuse/mui-form-controls 3.3.15 → 3.4.1

package/dist/FormControlsConfig.d.ts

@@ -2,7 +2,8 @@
  * FormControlsConfig.tsx
  *
  * 앱 전체에 걸 기본값 — 날짜·시간 칸마다 prop 을 달지 않고 한 곳에서 켠다.
- * 지금은 `pickerCentered`(달력·시간 선택을 칸 옆 팝오버 대신 화면 가운데 창으로) 하나다.
+ * `pickerCentered`(달력·시간 선택을 칸 옆 팝오버 대신 화면 가운데 창으로)와
+ * `timePickerVariant`(시간을 숫자 목록 대신 [오전/오후][시][분] 바퀴로 고르기 — 휴대폰 터치용)가 있다.
  * 휴대폰에서는 칸 바로 아래 뜨는 팝오버가 화면 끝에 걸리거나 키보드·하단 막대에 가려 쓰기 불편해서,
  * 앱이 좁은 화면일 때만 `<FormControlsConfigProvider pickerCentered>` 로 감싸 쓰게 한다.
  * 칸에 `pickerCentered` 를 직접 주면 그 값이 이긴다. Provider 가 없으면 예전 동작(팝오버) 그대로다.
@@ -15,10 +16,15 @@ import { type ReactNode } from "react";
 /** 앱 전체 기본값. */
 export interface FormControlsConfig {
     pickerCentered?: boolean;
+    timePickerVariant?: TimePickerVariant;
 }
+/** 시간 고르는 방식 — "list" 숫자 목록(기본) · "wheel" [오전/오후][시][분] 바퀴. */
+export type TimePickerVariant = "list" | "wheel";
 /** 앱 전체 기본값을 건다. */
 export declare function FormControlsConfigProvider({ children, ...config }: FormControlsConfig & {
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** 칸 값이 있으면 그것을, 없으면 앱 기본값을 쓴다(날짜·시간 칸 안에서 부른다). */
 export declare function usePickerCentered(own: boolean | undefined): boolean;
+/** 시간 고르는 방식 — 칸 값 → 앱 기본값 → "list"(예전 동작) 순. */
+export declare function useTimePickerVariant(own: TimePickerVariant | undefined): TimePickerVariant;

package/dist/MonthTextField.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MonthTextField.tsx — 년월 입력칸. 값은 "YYYY-MM", 칸을 벗어나면 "2026년 11월" 로 보이고, 달력은 월만 고른다.
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export declare const MonthTextField: import("react").ForwardRefExoticComponent<Omit<import("./types").PeriodTextFieldProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/PeriodTextField.d.ts

@@ -0,0 +1,26 @@
+/**
+ * PeriodTextField.tsx — 년월(MonthTextField) · 년도(YearTextField) 입력칸의 공용 바탕
+ *
+ * 값은 "YYYY-MM"(년월) · "YYYY"(년도) 문자열로 주고받는다.
+ * - 칸을 벗어나 있으면 "2026년 11월" · "2026년" 처럼 읽기 좋은 글로 보인다(displayFormat 으로 바꾼다).
+ * - 칸을 누르면 숫자로 친다("2026-11" · "2026") — 칸을 벗어날 때 완성된 값이면 알리고, 덜 쳤으면 이전 값으로 돌린다.
+ * - 달력 아이콘은 월만(년도만) 고르는 달력을 연다(@ehfuse/mui-datetime-picker 의 monthOnly · yearOnly).
+ *
+ * DateTextField 의 format="YYYY-MM" 는 날짜 칸이라 달력이 날짜를 고르게 했고 표시도 숫자뿐이었다 — 달 · 해만 다루는 칸을 따로 둔다.
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+import React from "react";
+export type PeriodMode = "month" | "year";
+/** 년월 · 년도 칸 — readonly/disabled 는 읽기 좋은 글 박스로, form 이 있으면 form 에 묶는다. */
+export declare const PeriodTextField: React.ForwardRefExoticComponent<Omit<Omit<import("./types").TextFieldProps, "type"> & import("./types").BaseTextFieldProps & {
+    displayFormat?: (year: number, month: number) => string;
+    minDate?: Date;
+    maxDate?: Date;
+    calendarIcon?: boolean;
+    pickerCentered?: boolean;
+} & {
+    mode: PeriodMode;
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/YearTextField.d.ts

@@ -0,0 +1,8 @@
+/**
+ * YearTextField.tsx — 년도 입력칸. 값은 "YYYY", 칸을 벗어나면 "2026년" 으로 보이고, 달력은 년도만 고른다.
+ *
+ * @license MIT
+ * @copyright 2025 김영진 (Kim Young Jin)
+ * @author 김영진 (ehfuse@gmail.com)
+ */
+export declare const YearTextField: import("react").ForwardRefExoticComponent<Omit<import("./types").PeriodTextFieldProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/index.d.ts

@@ -5,8 +5,8 @@
  * @copyright 2025 김영진 (Kim Young Jin)
  * @author 김영진 (ehfuse@gmail.com)
  */
-export { FormControlsConfigProvider, usePickerCentered } from "./FormControlsConfig";
-export type { FormControlsConfig } from "./FormControlsConfig";
+export { FormControlsConfigProvider, usePickerCentered, useTimePickerVariant } from "./FormControlsConfig";
+export type { FormControlsConfig, TimePickerVariant } from "./FormControlsConfig";
 export { SearchTextField } from "./SearchTextField";
 export { ClearTextField } from "./ClearTextField";
 export { TagsTextField } from "./TagsTextField";
@@ -36,6 +36,8 @@ export { isJuminValueValid, isJuminValueInvalidState, sanitizeJuminFrontBirthDig
 export { VerificationCodeTextField } from "./VerificationCodeTextField";
 export { EmailTextField } from "./EmailTextField";
 export { DateTextField } from "./DateTextField";
+export { MonthTextField } from "./MonthTextField";
+export { YearTextField } from "./YearTextField";
 export { TimeTextField } from "./TimeTextField";
 export { DateTimeTextField } from "./DateTimeTextField";
 export { BizNumTextField } from "./BizNumTextField";
@@ -49,4 +51,4 @@ export { ReadonlyDisplay } from "./components/ReadonlyDisplay";
 export type { ReadonlyDisplayProps } from "./components/ReadonlyDisplay";
 export { ReadonlyField, shouldRenderReadonlyBox, } from "./components/ReadonlyField";
 export { CardIcon, VisaIcon, MastercardIcon, AmexIcon, JcbIcon, DinersIcon, DiscoverIcon, UnionPayIcon, BcIcon, } from "./icons";
-export type { SearchTextFieldProps, ClearTextFieldProps, TagsTextFieldProps, PasswordTextFieldProps, TextFieldProps, TextAreaProps, CheckboxProps, SwitchProps, RadioGroupProps, RadioOption, DateRangeProps, SliderProps, RatingProps, ToggleButtonProps, ToggleButtonGroupProps, ToggleButtonGroupOption, ButtonGroupProps, StepperProps, AutocompleteProps, AutocompleteOption, SelectProps, SelectOption, LabelSelectProps, LabelSelectOption, AddressTextFieldProps, DaumPostcodeData, PasswordValidationRules, PasswordValidationResult, PhoneTextFieldProps, PhoneFormat, NumberTextFieldProps, JuminTextFieldProps, JuminInfo, VerificationCodeTextFieldProps, VerificationCodeType, EmailTextFieldProps, CustomDomain, DateTextFieldProps, DateFormat, TimeTextFieldProps, TimeFormat, DateTimeTextFieldProps, DateTimeFormat, BizNumTextFieldProps, CorpNumTextFieldProps, CardNumTextFieldProps, CardNumTextFieldHandle, BankAccountTextFieldProps, BankAccountVerifyRequest, BankAccountVerifyResult, BankAccountVerifyStatus, SelectChangeEvent, } from "./types";
+export type { SearchTextFieldProps, ClearTextFieldProps, TagsTextFieldProps, PasswordTextFieldProps, TextFieldProps, TextAreaProps, CheckboxProps, SwitchProps, RadioGroupProps, RadioOption, DateRangeProps, SliderProps, RatingProps, ToggleButtonProps, ToggleButtonGroupProps, ToggleButtonGroupOption, ButtonGroupProps, StepperProps, AutocompleteProps, AutocompleteOption, SelectProps, SelectOption, LabelSelectProps, LabelSelectOption, AddressTextFieldProps, DaumPostcodeData, PasswordValidationRules, PasswordValidationResult, PhoneTextFieldProps, PhoneFormat, NumberTextFieldProps, JuminTextFieldProps, JuminInfo, VerificationCodeTextFieldProps, VerificationCodeType, EmailTextFieldProps, CustomDomain, DateTextFieldProps, MonthTextFieldProps, YearTextFieldProps, PeriodTextFieldProps, DateFormat, TimeTextFieldProps, TimeFormat, DateTimeTextFieldProps, DateTimeFormat, BizNumTextFieldProps, CorpNumTextFieldProps, CardNumTextFieldProps, CardNumTextFieldHandle, BankAccountTextFieldProps, BankAccountVerifyRequest, BankAccountVerifyResult, BankAccountVerifyStatus, SelectChangeEvent, } from "./types";