fone-design-system_v2 1.0.99 → 1.0.101

package/dist/components/Dialog/Dialog.d.ts

@@ -1,31 +1,42 @@
 import { default as React } from 'react';
 import { DialogProps as MuiDialogProps, SxProps, Theme } from '@mui/material';
-interface DialogPropsBase extends Omit<MuiDialogProps, "onSubmit" | "getReset" | "title" | "content"> {
+declare const DIALOG_WIDTHS: {
+    readonly xs: "300px";
+    readonly sm: "480px";
+    readonly md: "600px";
+    readonly lg: "800px";
+    readonly xl: "1000px";
+};
+export type DialogSize = keyof typeof DIALOG_WIDTHS | "auto";
+export type DialogType = "info" | "success" | "warning" | "error" | "confirm";
+type DialogCloseReason = "backdropClick" | "escapeKeyDown";
+interface DialogPropsBase extends Omit<MuiDialogProps, "open" | "onClose" | "sx" | "children" | "scroll" | "fullScreen" | "content" | "title"> {
     /** 다이얼로그 열린 상태 */
     open: boolean;
-    /** 다이얼로그 확인 버튼 클릭 이벤트 핸들러 */
     /** 다이얼로그 닫기 이벤트 핸들러 */
-    onClose: () => void;
+    onClose: (event?: object, reason?: DialogCloseReason) => void;
     /** 다이얼로그 제목 */
-    title?: string | React.ReactNode;
+    title?: React.ReactNode;
     /** 다이얼로그 내용 */
-    content?: string | React.ReactNode;
+    content?: React.ReactNode;
     /** 다이얼로그 액션 버튼 */
     actions?: React.ReactNode;
     /** 최대 너비 */
-    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    size?: DialogSize;
     /** 전체 화면 여부 */
     fullScreen?: boolean;
     /** 스크롤 동작 */
     scroll?: "paper" | "body";
-    /** 스타일 속성 */
-    sx?: SxProps<Theme> | any;
+    /** 다이얼로그 Paper 스타일 */
+    sx?: SxProps<Theme>;
     /** 영역별 구분선 */
     dividers?: boolean;
     /** 액션 버튼 정렬 */
     actionsAlign?: "center" | "left" | "right";
     /** 자식노드 */
     children?: React.ReactNode;
+    /** 배경(backdrop) 클릭 닫기 방지 */
+    disableBackdropClose?: boolean;
 }
 export type DialogWithType = (DialogPropsBase & {
     type: "confirm";
@@ -34,13 +45,8 @@ export type DialogWithType = (DialogPropsBase & {
     type?: "info" | "success" | "warning" | "error";
     onOk?: never;
 });
-/** 모달 다이얼로그 컴포넌트
- *
- * 대체적으로 Provider로 사용되는 컴포넌트입니다.
- *
- */
 export declare const Dialog: {
-    ({ open, onClose, title, content, actions, fullScreen, scroll, size, type, onOk, dividers, actionsAlign, children, sx, ...props }: DialogWithType): import("react/jsx-runtime").JSX.Element;
+    ({ open, onClose, title, content, actions, fullScreen, scroll, size, type, onOk, dividers, actionsAlign, children, sx, disableBackdropClose, PaperProps: paperProps, ...props }: DialogWithType): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
 export {};

package/dist/components/Label/Label.d.ts

@@ -1,16 +1,29 @@
+import { FormLabelProps } from '@mui/material/FormLabel';
 import * as React from "react";
-export interface LabelProps {
-    htmlFor?: string;
-    title?: string;
+type LabelSize = "small" | "medium";
+export interface LabelProps extends Omit<FormLabelProps, "children" | "title" | "color" | "component"> {
+    /** 권장 표시 텍스트 */
+    label?: React.ReactNode;
+    /** label 대신 직접 children으로 넣고 싶을 때 */
     children?: React.ReactNode;
-    className?: string;
-    style?: React.CSSProperties;
-    size?: "small" | "medium";
+    /**
+     * 하위 호환용.
+     * 기존 코드에서 title을 표시 텍스트로 썼다면 그대로 동작하게 유지.
+     * 새 코드에서는 label 사용 권장.
+     */
+    title?: React.ReactNode;
+    size?: LabelSize;
     bold?: boolean;
+    /** 권장 텍스트 색상 prop */
+    textColor?: string;
+    /**
+     * 하위 호환용.
+     * 기존 color prop을 텍스트 색상으로 쓰던 코드 대응.
+     * 새 코드에서는 textColor 사용 권장.
+     */
     color?: string;
-    required?: boolean;
     requiredColor?: string;
     requiredAlign?: "left" | "right";
 }
-declare const Label: React.ForwardRefExoticComponent<LabelProps & React.RefAttributes<HTMLLabelElement>>;
+declare const Label: React.ForwardRefExoticComponent<Omit<LabelProps, "ref"> & React.RefAttributes<HTMLLabelElement>>;
 export default Label;

package/dist/components/NumberField/NumberField.d.ts

@@ -0,0 +1,34 @@
+import { TextField2Props } from '../TextField2';
+import * as React from "react";
+type NumberValue = number | null;
+type NumberFieldChangeEvent = React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>;
+type NumberFieldFocusEvent = React.FocusEvent<HTMLInputElement | HTMLTextAreaElement>;
+export interface NumberFieldProps extends Omit<TextField2Props, "value" | "defaultValue" | "onChange" | "type" | "multiline" | "rows" | "minRows" | "maxRows" | "inputProps"> {
+    /** 숫자 기준 controlled value */
+    value?: NumberValue;
+    /** 숫자 기준 uncontrolled defaultValue */
+    defaultValue?: NumberValue;
+    /** 원본 input change event */
+    onChange?: (event: NumberFieldChangeEvent) => void;
+    /** 입력 중 숫자값이 바뀔 때 호출 */
+    onValueChange?: (value: NumberValue, event: NumberFieldChangeEvent | NumberFieldFocusEvent) => void;
+    /** blur 후 최종 확정된 숫자값 */
+    onValueCommit?: (value: NumberValue, event: NumberFieldFocusEvent) => void;
+    /** blur 시 최소/최대 범위 보정용 */
+    min?: number;
+    max?: number;
+    /** blur 시 step 단위 반올림용 */
+    step?: number;
+    /** 소수 허용 여부 */
+    allowDecimal?: boolean;
+    /** 음수 허용 여부 */
+    allowNegative?: boolean;
+    /** blur 시 min/max 범위로 값 보정 여부 */
+    clampOnBlur?: boolean;
+    /** blur 시 step 기준 반올림 여부 */
+    snapToStepOnBlur?: boolean;
+    /** 실제 input element에 전달할 native props */
+    inputProps?: TextField2Props["inputProps"];
+}
+declare const NumberField: React.ForwardRefExoticComponent<Omit<NumberFieldProps, "ref"> & React.RefAttributes<HTMLInputElement | HTMLTextAreaElement>>;
+export default NumberField;

package/dist/components/NumberField/index.d.ts

@@ -0,0 +1,2 @@
+import { default as NumberField, NumberFieldProps } from './NumberField';
+export { NumberField, NumberFieldProps };

package/dist/components/OutlinedInput/OutlinedInput.d.ts

@@ -0,0 +1,5 @@
+import { OutlinedInputProps as MuiOutlinedInputProps } from '@mui/material';
+import * as React from "react";
+export type OutlinedInputProps = Omit<MuiOutlinedInputProps, "inputRef">;
+declare const OutlinedInput: React.ForwardRefExoticComponent<Omit<OutlinedInputProps, "ref"> & React.RefAttributes<HTMLInputElement | HTMLTextAreaElement>>;
+export default OutlinedInput;

package/dist/components/OutlinedInput/index.d.ts

@@ -0,0 +1,2 @@
+import { OutlinedInputProps, default as OutlinedInput } from './OutlinedInput';
+export { OutlinedInput, OutlinedInputProps };

package/dist/components/Select/index.d.ts

@@ -1,3 +1,2 @@
-import { RHFSelect2ControllerProps, default as RHFSelect2Controller } from './RHFSelect2Controller';
 import { default as Select, SelectProps } from './Select';
-export { Select, SelectProps, RHFSelect2ControllerProps, RHFSelect2Controller };
+export { Select, SelectProps };

package/dist/components/Table2/hooks/useElementHeight.d.ts

@@ -0,0 +1,11 @@
+import { RefCallback } from 'react';
+type Options = {
+    /** 0이 측정되면 직전 유효값을 유지할지 여부 */
+    keepLastNonZero?: boolean;
+};
+/**
+ * 요소 높이 추적 훅 (탭 전환/언마운트에도 안정)
+ * 반환: [callbackRef, height]
+ */
+declare function useElementHeight<T extends HTMLElement = HTMLDivElement>(opts?: Options): [RefCallback<T>, number];
+export default useElementHeight;

package/dist/components/TextArea/TextArea.d.ts

@@ -0,0 +1,12 @@
+import { TextField2Props } from '../TextField2';
+import * as React from "react";
+export interface TextAreaProps extends Omit<TextField2Props, "type" | "multiline"> {
+    /**
+     * resize 방향
+     * - none: 기본 autosize(minRows/maxRows) 사용
+     * - vertical/horizontal/both: root 박스를 직접 resize
+     */
+    resize?: "none" | "vertical" | "horizontal" | "both";
+}
+declare const TextArea: React.ForwardRefExoticComponent<Omit<TextAreaProps, "ref"> & React.RefAttributes<HTMLInputElement | HTMLTextAreaElement>>;
+export default TextArea;

package/dist/components/TextArea/index.d.ts

@@ -0,0 +1,2 @@
+import { default as TextArea, TextAreaProps } from './TextArea';
+export { TextArea, TextAreaProps };

package/dist/components/TextField2/TextField2.d.ts

@@ -1,34 +1,19 @@
-import { default as React, ChangeEventHandler, ReactNode } from 'react';
-import { OutlinedInputProps } from '@mui/material';
-export interface TextField2Props extends Omit<OutlinedInputProps, "onChange"> {
-    /** 입력 값(Controlled). 미지정 시 비제어로 동작 가능 */
-    value?: any;
-    /** 값 변경 핸들러. e.target.value로 현재 값 접근 */
-    onChange?: ChangeEventHandler<HTMLInputElement | HTMLTextAreaElement>;
-    /** 루트 FormControl에 부착할 className (스타일 훅용) */
+import { default as React } from 'react';
+import { FormHelperTextProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+import { LabelProps } from '../Label';
+import { OutlinedInputProps } from '../OutlinedInput';
+export interface TextField2Props extends Omit<OutlinedInputProps, "className" | "sx"> {
+    label?: React.ReactNode;
+    helperText?: React.ReactNode;
+    /** FormControl root */
     className?: string;
-    /** 비활성화 여부 */
-    disabled?: boolean;
-    /** 인풋 왼쪽 영역에 표시할 부가 요소 (예: 아이콘) */
-    startAdornment?: ReactNode;
-    /** 인풋 오른쪽 영역에 표시할 부가 요소 (예: 버튼) */
-    endAdornment?: ReactNode;
-    /** MUI 슬롯 전용 prop 전달용 (필요 시 내부 슬롯에 세부 옵션 전달) */
-    slotProps?: any;
-    /** MUI system `sx` 스타일 오버라이드 (루트 FormControl에 적용) */
-    sx?: any;
-    /** HTML input type (text, password, number 등) */
-    type?: string;
-    /** 읽기 전용 여부 */
-    readOnly?: boolean;
-    /** 필수 입력 여부(브라우저 기본 유효성에 사용) */
-    required?: boolean;
-    /** HTML id 속성 (label-for 연결 등) */
-    id?: string;
-    /** forwardRef로 외부에서 인풋에 접근하기 위한 ref
-     *  - 일반적으로 React.forwardRef 제네릭으로 처리하므로 props에 직접 넣지 않아도 됨
-     */
-    ref?: React.ForwardedRef<HTMLInputElement>;
+    sx?: SxProps<Theme>;
+    /** Input root */
+    inputClassName?: string;
+    inputSx?: SxProps<Theme>;
+    labelProps?: LabelProps;
+    helperTextProps?: FormHelperTextProps;
 }
-declare const TextField2: React.ForwardRefExoticComponent<Omit<TextField2Props, "ref"> & React.RefAttributes<HTMLInputElement>>;
+declare const TextField2: React.ForwardRefExoticComponent<Omit<TextField2Props, "ref"> & React.RefAttributes<HTMLInputElement | HTMLTextAreaElement>>;
 export default TextField2;

package/dist/components/TextField2/index.d.ts

@@ -1,3 +1,2 @@
-import { default as RHFTextField2Controller, RHFTextField2ControllerProps } from './RHFTextField2Controller';
 import { default as TextField2, TextField2Props } from './TextField2';
-export { TextField2, TextField2Props, RHFTextField2Controller, RHFTextField2ControllerProps, };
+export { TextField2, TextField2Props };