@owp/core 2.5.45 → 2.5.48

package/dist/types/components/OwpDialog/OwpDialog.d.ts

@@ -1,30 +1,39 @@
 import { DialogContentProps, DialogProps } from '@mui/material';
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
+/**
+ * OWP 기본 Dialog props
+ */
 export interface OwpDialogProps extends Omit<DialogProps, 'title'> {
+    /** Dialog title 영역 */
     title?: ReactNode;
+    /** Dialog content 영역 */
     children?: ReactNode;
+    /** Content 위에 loading overlay 표시 여부 */
     loading?: boolean;
+    /** `alertdialog` role 적용 여부 */
     alertDialog?: boolean;
+    /** 확인 버튼 표시 여부 */
     canConfirm?: boolean;
+    /** 취소 버튼 표시 여부 */
     canCancel?: boolean;
+    /** 확인 버튼 문구. 기본값은 `Button.저장` 번역 key */
     confirmText?: string;
+    /** 취소 버튼 문구. 기본값은 confirm 가능 여부에 따라 취소/닫기 key */
     cancelText?: string;
+    /** Dialog root를 `form`으로 render하고 확인 button을 submit type으로 사용할지 여부 */
     useSubmit?: boolean;
+    /** 기본 액션 왼쪽에 노출할 추가 action 영역 */
     actions?: ReactNode;
+    /** DialogContent에 전달할 props */
     contentProps?: DialogContentProps;
+    /** 확인 button click handler. `useSubmit`이 true면 button click에서는 호출하지 않음 */
     onConfirm?: () => void;
+    /** 취소 button click handler. 없으면 `onClose`를 호출 */
     onCancel?: () => void;
 }
 /**
- * OwpDialog 컴포넌트
- * @param title 제목
- * @param children 하위 콘텐츠
- * @param loading 본문 로딩 여부
- * @param alertDialog alertdialog role 적용 여부
- * @param canCancel canCancel 값
- * @param canConfirm canConfirm 값
- * @param onConfirm onConfirm 핸들러
- * @param onCancel onCancel 핸들러
+ * OWP Dialog 기본 shell
+ * @param props title/content/action/loading 상태와 MUI Dialog 표시 속성
  */
 declare const OwpDialog: import("react").ForwardRefExoticComponent<Omit<OwpDialogProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 export { OwpDialog };

package/dist/types/components/OwpDialogsProvider/OwpDialogsContext.d.ts

@@ -1,4 +1,5 @@
 import type { DialogHook } from '@/types/OwpDialogTypes';
+/** OwpDialogsProvider에서 주입하는 alert/confirm dialog 제어 context */
 export declare const OwpDialogsContext: import("react").Context<DialogHook>;
 /**
  * OWP dialog context 접근

package/dist/types/components/OwpErrorStatusPage/OwpErrorStatusPage.d.ts

@@ -1,5 +1,13 @@
+/**
+ * Error status page props
+ */
 export type OwpErrorStatusPageProps = {
+    /** 사용자에게 표시할 오류 메시지 */
     message: string;
 };
+/**
+ * 오류 상태 메시지와 홈 이동 링크를 표시하는 status page
+ * @param props 표시할 오류 메시지
+ */
 declare function OwpErrorStatusPage({ message }: OwpErrorStatusPageProps): import("react/jsx-runtime").JSX.Element;
 export { OwpErrorStatusPage };

package/dist/types/components/OwpExportExcelButton/OwpExportExcelButton.d.ts

@@ -1,30 +1,48 @@
 import { type ButtonProps } from '@mui/material';
+/**
+ * Excel header cell 정의
+ */
 export type ExcelHeader = {
+    /** 값을 입력할 cell key. 예: `A1` */
     key?: string;
+    /** merge 대상 cell range. 예: `A1:C1` */
     range?: string;
+    /** header cell 표시 값 */
     value: string;
 };
+/**
+ * Excel data row를 cell 값으로 변환하는 mapper
+ */
 export type ExcelDataMapper = {
+    /** data row에서 값을 읽을 property key */
     key: string;
+    /** 이전 호환용 column span metadata */
     colSpan?: string;
+    /** 이전 호환용 row span metadata */
     rowSpan?: string;
+    /** cell 값 앞에 붙일 문자열 */
     prefix?: string;
+    /** cell 값 뒤에 붙일 문자열 */
     suffix?: string;
 };
+/**
+ * 배열 데이터를 Excel 파일로 내보내는 버튼 props
+ */
 interface OwpExportDataToExcelButtonProps<T> extends ButtonProps {
+    /** Excel 상단 header cell 목록 */
     header: ExcelHeader[];
+    /** data row를 column 순서대로 매핑하는 설정 */
     mapper: ExcelDataMapper[];
+    /** Excel row로 추가할 데이터 배열 */
     data?: T;
+    /** 버튼 표시 문구 */
     title?: string;
+    /** 다운로드 파일명과 worksheet 이름 기준 값 */
     exportName?: string;
 }
 /**
- * OwpExportDataToExcelButton 컴포넌트
- * @param header 헤더 정보
- * @param mapper 엑셀 매핑 정보
- * @param data 데이터
- * @param exportName 다운로드 파일명
- * @param title 제목
+ * header/mapper 설정으로 배열 데이터를 Excel 파일로 다운로드하는 버튼
+ * @param props Excel header, data mapper, row 데이터, 파일명, MUI Button 표시 속성
  */
 export declare function OwpExportDataToExcelButton<T>({ header, mapper, data, exportName, title, loading, loadingPosition, onClick, ...restProps }: OwpExportDataToExcelButtonProps<T>): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/OwpFieldHelperText/OwpFieldHelperText.d.ts

@@ -1,7 +1,12 @@
 import type { FormHelperTextProps } from '@mui/material/FormHelperText';
 import type { ReactNode } from 'react';
+/**
+ * 입력 필드 helper text props
+ */
 export interface OwpFieldHelperTextProps extends Omit<FormHelperTextProps, 'children'> {
+    /** helper text 내용 */
     children?: ReactNode;
+    /** 내용 앞에 필수 표시 `(*)`를 함께 노출할지 여부 */
     required?: boolean;
 }
 /**

package/dist/types/components/OwpFilePickerButton/OwpFilePickerButton.d.ts

@@ -1,19 +1,26 @@
 import { type ButtonProps } from '@mui/material/Button';
 import { type ChangeEvent, type ReactNode } from 'react';
+/**
+ * 숨김 file input을 포함하는 Button 전용 props
+ */
 export interface OwpFilePickerButtonOwnProps {
+    /** 다중 파일 선택 허용 여부 */
     multiple?: boolean;
+    /** file input accept 속성. 기본값은 image MIME 목록 */
     accept?: string;
+    /** 버튼 children으로 표시할 제목 */
     title?: ReactNode;
+    /** 파일 선택 완료 시 호출되는 input change handler */
     onChange?: (evt: ChangeEvent<HTMLInputElement>) => void;
+    /** 파일 선택 dialog 취소 시 호출되는 cancel event handler */
     onCancel?: (evt: Event) => void;
 }
+/**
+ * File picker button props
+ */
 export type OwpFilePickerButtonProps = OwpFilePickerButtonOwnProps & Omit<ButtonProps, 'title' | 'onChange' | 'onCancel'>;
 /**
- * OwpFilePickerButton 컴포넌트
- * @param title 제목
- * @param multiple multiple 값
- * @param onChange onChange 핸들러
- * @param onCancel onCancel 핸들러
- * @param accept accept 값
+ * MUI Button 클릭으로 숨김 file input을 여는 file picker
+ * @param props file input accept/multiple 설정, change/cancel handler, Button 표시 속성
  */
 export declare function OwpFilePickerButton({ title, multiple, onChange, onCancel, accept, ...restProps }: OwpFilePickerButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/OwpHidden/OwpHidden.d.ts

@@ -1,15 +1,27 @@
 import { type ReactNode } from 'react';
+/** Breakpoint별 숨김 조건을 선언하는 OwpHidden 속성 */
 export interface OwpHiddenProps {
+    /** 조건에 걸리지 않을 때 render할 콘텐츠 */
     children?: ReactNode;
+    /** `xs` 이상 viewport에서 숨김 */
     xsUp?: boolean;
+    /** `sm` 이상 viewport에서 숨김 */
     smUp?: boolean;
+    /** `md` 이상 viewport에서 숨김 */
     mdUp?: boolean;
+    /** `lg` 이상 viewport에서 숨김 */
     lgUp?: boolean;
+    /** `xl` 이상 viewport에서 숨김 */
     xlUp?: boolean;
+    /** `xs` 이하 viewport에서 숨김 */
     xsDown?: boolean;
+    /** `sm` 이하 viewport에서 숨김 */
     smDown?: boolean;
+    /** `md` 이하 viewport에서 숨김 */
     mdDown?: boolean;
+    /** `lg` 이하 viewport에서 숨김 */
     lgDown?: boolean;
+    /** `xl` 이하 viewport에서 숨김 */
     xlDown?: boolean;
 }
 /**

package/dist/types/components/OwpLanguageSwitcherSelect/OwpLanguageSwitcherSelect.d.ts

@@ -1,6 +1,7 @@
 import { SelectProps } from '@mui/material/Select';
 /**
- * The language switcher.
+ * OWP language 목록으로 i18next 언어와 전역 current language를 변경하는 Select
+ * @param props MUI Select 표시 속성과 변경 후 router refresh 여부
  */
 export declare function OwpLanguageSwitcherSelect({ label, fullWidth, canRefresh, ...restSelectProps }: Omit<SelectProps, 'value' | 'onChange'> & {
     canRefresh?: boolean;

package/dist/types/components/OwpLayout/OwpLayout.d.ts

@@ -2,10 +2,18 @@ import { themeLayoutsType } from '@/layout/themeLayouts';
 import type { OwpSettingsConfigType } from '@/types/OwpSettingsTypes';
 import { type ReactNode } from 'react';
 import { RouteMatch, RouteObject } from 'react-router-dom';
+/**
+ * Route object에 OWP layout settings/auth metadata를 더한 타입
+ */
 export type OwpRouteObjectType = RouteObject & {
+    /** route 진입 시 적용할 OWP settings override */
     settings?: OwpSettingsConfigType;
+    /** route 권한 metadata */
     auth?: string[] | [] | null | undefined;
 };
+/**
+ * React Router match 결과에 OWP route metadata 타입을 반영한 타입
+ */
 export type OwpRouteMatchType = RouteMatch & {
     route: OwpRouteObjectType;
 };
@@ -14,10 +22,8 @@ type OwpLayoutProps = {
     children?: ReactNode;
 };
 /**
- * OwpLayout
- * React frontend component in a React project that is used for layouting the user interface. The component
- * handles generating user interface settings related to current routes, merged with default settings, and uses
- * the new settings to generate layouts.
+ * 현재 route settings를 기본 settings와 병합해 선택된 theme layout을 render하는 shell
+ * @param props layout registry와 route outlet children
  */
 declare function OwpLayout(props: OwpLayoutProps): import("react/jsx-runtime").JSX.Element | import("react/jsx-runtime").JSX.Element[];
 export { OwpLayout };

package/dist/types/components/OwpLoading/OwpLoading.d.ts

@@ -1,9 +1,15 @@
+/**
+ * 중앙 loading indicator props
+ */
 export type OwpLoadingProps = {
+    /** indicator 표시 전 대기 시간(ms) */
     delay?: number;
+    /** root element 추가 className */
     className?: string;
 };
 /**
- * Centered loading indicator with optional delay
+ * 선택적 delay 이후 중앙 LinearProgress를 표시하는 loading indicator
+ * @param props 표시 지연 시간과 root className
  */
 declare function OwpLoading(props: OwpLoadingProps): import("react/jsx-runtime").JSX.Element;
 export { OwpLoading };

package/dist/types/components/OwpMoreActionsButton/OwpMoreActionsButton.d.ts

@@ -3,6 +3,9 @@ import type { SxProps, Theme } from '@mui/material/styles';
 import type { ReactNode } from 'react';
 import { exportTreeGridToExcelById } from '../../utils/treeGridUtil';
 import { type OwpFilePickerButtonProps } from '../OwpFilePickerButton/OwpFilePickerButton';
+/**
+ * More action 항목에 사용할 MUI palette color 또는 custom color 문자열
+ */
 export type OwpMoreButtonActionColor = NonNullable<IconButtonProps['color']> | string;
 type OwpMoreButtonActionBase = {
     icon?: ReactNode;
@@ -17,42 +20,66 @@ type OwpMoreButtonActionBase = {
         sx?: SxProps<Theme>;
     };
 };
+/**
+ * 일반 클릭 action 설정
+ */
 export type OwpMoreButtonClickAction = OwpMoreButtonActionBase & {
+    /** action 종류. 생략하면 일반 button action */
     type?: 'button';
+    /** 메뉴 항목 클릭 시 호출되는 handler */
     onClick: (args: {
         close: () => void;
     }) => void;
 };
+/**
+ * 파일 업로드 action 설정
+ */
 export type OwpMoreButtonFileUploadAction = OwpMoreButtonActionBase & {
+    /** file picker action 식별자 */
     type: 'fileUpload';
+    /** 내부 `OwpFilePickerButton`에 전달할 props */
     fileUploadProps?: Omit<OwpFilePickerButtonProps, 'title' | 'onChange' | 'onCancel'> & {
         onChange?: OwpFilePickerButtonProps['onChange'];
         onCancel?: OwpFilePickerButtonProps['onCancel'];
     };
 };
+/**
+ * TreeGrid Excel export action 설정
+ */
 export type OwpMoreButtonTreeGridExportExcelAction = OwpMoreButtonActionBase & {
+    /** TreeGrid Excel export action 식별자 */
     type: 'treeGridExportExcel';
+    /** `exportTreeGridToExcelById`에 그대로 전달할 인자 */
     exportExcelArgs: Parameters<typeof exportTreeGridToExcelById>;
 };
+/**
+ * More actions menu에서 지원하는 action union
+ */
 export type OwpMoreButtonAction = OwpMoreButtonClickAction | OwpMoreButtonFileUploadAction | OwpMoreButtonTreeGridExportExcelAction;
+/**
+ * More actions icon button props
+ */
 export type OwpMoreActionsButtonProps = {
+    /** 메뉴에 표시할 action 목록 */
     actions: OwpMoreButtonAction[];
+    /** controlled open 상태 */
     open?: boolean;
+    /** uncontrolled 초기 open 상태 */
     defaultOpen?: boolean;
+    /** open 상태 변경 시 호출되는 handler */
     onOpenChange?: (open: boolean) => void;
+    /** icon button 비활성화 여부 */
     disabled?: boolean;
+    /** icon button 추가 className */
     className?: string;
+    /** icon button sx */
     containerSx?: SxProps<Theme>;
+    /** Menu root sx */
     actionsSx?: SxProps<Theme>;
 };
 /**
- * OwpMoreActionsButton 컴포넌트
- * @param actions 액션 영역
- * @param openProp openProp 값
- * @param defaultOpen defaultOpen 값
- * @param onOpenChange onOpenChange 핸들러
- * @param disabled disabled 값
- * @param className CSS 클래스명
+ * More icon 클릭으로 action menu를 표시하는 버튼
+ * @param props action 목록, controlled open 상태, button/menu 스타일 옵션
  */
 export declare const OwpMoreActionsButton: ({ actions, open: openProp, defaultOpen, onOpenChange, disabled, className, containerSx, actionsSx, }: OwpMoreActionsButtonProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/OwpNavLinkAdapter/OwpNavLinkAdapter.d.ts

@@ -1,16 +1,21 @@
-import { CSSProperties, ReactNode } from 'react';
-import { NavLinkProps } from 'react-router-dom';
+import { type CSSProperties, type ReactNode } from 'react';
+import { type NavLinkProps } from 'react-router-dom';
+/** React Router NavLink에 active class/style 계약을 추가한 adapter 속성 */
 export type OwpNavLinkAdapterProps = NavLinkProps & {
+    /** route match 상태일 때 추가할 className */
     activeClassName?: string;
+    /** route match 상태일 때 병합할 inline style */
     activeStyle?: CSSProperties;
+    /** link 내부에 표시할 콘텐츠 */
     children?: ReactNode;
 };
-/**
- * OwpNavLinkAdapter 네비게이션 링크 어댑터 컴포넌트
- */
+/** React Router NavLink 활성 상태를 className/style로 병합하는 adapter */
 declare const OwpNavLinkAdapter: import("react").ForwardRefExoticComponent<NavLinkProps & {
+    /** route match 상태일 때 추가할 className */
     activeClassName?: string;
+    /** route match 상태일 때 병합할 inline style */
     activeStyle?: CSSProperties;
+    /** link 내부에 표시할 콘텐츠 */
     children?: ReactNode;
 } & import("react").RefAttributes<HTMLAnchorElement>>;
 export default OwpNavLinkAdapter;

package/dist/types/components/OwpNumberField/OwpNumberField.d.ts

@@ -1,9 +1,9 @@
 import { TextFieldProps } from '@mui/material';
 /**
- * OwpNumberField 컴포넌트
- * @param className CSS 클래스명
- * @param inputAlign inputAlign 값
- * @param ref input 참조
+ * react-number-format과 MUI TextField를 연결한 숫자 입력 field
+ * @param className root className
+ * @param inputAlign 내부 input text align
+ * @param ref 내부 input element 참조
  */
 declare const OwpNumberField: import("react").ForwardRefExoticComponent<import("react-number-format/types/types").InternalNumberFormatBase & {
     thousandSeparator?: boolean | string;

package/dist/types/components/OwpOptionSelector/OwpOptionSelector.d.ts

@@ -1,26 +1,43 @@
 import type { OwpSelectorValueTextAlign } from '@/components/OwpSelectorBase/types';
 import { type SelectChangeEvent, type SelectProps } from '@mui/material';
 import { type ReactNode } from 'react';
+/**
+ * 정적 option selector 항목
+ */
 export interface OwpOptionSelectorOption {
+    /** 선택 값 */
     value: string;
+    /** 화면에 표시할 option label */
     label: ReactNode;
+    /** option 비활성화 여부 */
     disabled?: boolean;
 }
+/**
+ * 정적 option 배열을 사용하는 Select props
+ */
 export interface OwpOptionSelectorProps extends Omit<SelectProps<string>, 'defaultValue' | 'multiple' | 'onChange' | 'renderValue' | 'value'> {
+    /** selector label */
     label?: string;
+    /** uncontrolled 초기 선택 값 */
     defaultValue?: string;
+    /** TextField 하단 helper text */
     helperText?: string;
+    /** 다중 선택 모드 사용 여부 */
     multiple?: boolean;
+    /** 선택 값 변경 시 호출되는 MUI Select change handler */
     onChange?: (event: SelectChangeEvent<string>, child: ReactNode) => void;
+    /** selector option 목록 */
     options: OwpOptionSelectorOption[];
+    /** 전체 option 표시 여부 */
     showAllOption?: boolean;
+    /** controlled 선택 값 */
     value?: string;
     /** 단일 선택 값 텍스트 정렬 */
     valueTextAlign?: OwpSelectorValueTextAlign;
 }
 /**
- * 옵션 선택기
- * @param props 옵션 선택기 props
+ * 정적 option 배열을 `OwpSelectorBase` select 모드로 표시하는 selector
+ * @param props option 배열, 선택 값, Select 표시 옵션
  */
 declare const OwpOptionSelector: ({ className, defaultValue, error, fullWidth, helperText, label, multiple, onChange, options, required, showAllOption, value, valueTextAlign, ...selectProps }: OwpOptionSelectorProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpOptionSelector };

package/dist/types/components/OwpPageBreadcrumb/OwpPageBreadcrumb.d.ts

@@ -1,6 +1,14 @@
 import { BreadcrumbsProps } from '@mui/material/Breadcrumbs';
+/**
+ * Navigation tree 기반 breadcrumb props
+ */
 export type PageBreadcrumbProps = BreadcrumbsProps & {
+    /** breadcrumb root 추가 className */
     className?: string;
 };
+/**
+ * 현재 route와 navigation tree를 기준으로 홈 버튼과 breadcrumb trail을 표시
+ * @param props MUI Breadcrumbs 표시 속성
+ */
 declare function PageBreadcrumb(props: PageBreadcrumbProps): import("react/jsx-runtime").JSX.Element;
 export default PageBreadcrumb;

package/dist/types/components/OwpPageCarded/OwpPageCarded.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from 'react';
 /**
- * Props for the OwpPageCarded component.
+ * OwpPageCarded props
  */
 type OwpPageCardedProps = {
     className?: string;
@@ -19,9 +19,7 @@ type OwpPageCardedProps = {
     leftSidebarOnClose?: () => void;
     fillContentHeight?: boolean;
 };
-/**
- * OwpPageCarded 컴포넌트
- */
+/** header, content, 좌우 sidebar를 조합하는 carded page layout */
 declare const OwpPageCarded: import("react").NamedExoticComponent<OwpPageCardedProps & import("react").RefAttributes<{
     toggleLeftSidebar: (T: boolean) => void;
     toggleRightSidebar: (T: boolean) => void;

package/dist/types/components/OwpPageCarded/internal/OwpPageCardedHeader.d.ts

@@ -1,11 +1,11 @@
-import { ReactNode } from 'react';
+import type { ReactNode } from 'react';
 interface OwpPageCardedHeaderProps {
     className?: string;
     header?: ReactNode;
 }
 /**
- * OwpPageCardedHeader 컴포넌트
- * @param props 컴포넌트 props
+ * OwpPageCarded 상단 header 영역 wrapper
+ * @param props header node와 root className
  */
 declare function OwpPageCardedHeader(props: OwpPageCardedHeaderProps): import("react/jsx-runtime").JSX.Element;
 export { OwpPageCardedHeader };

package/dist/types/components/OwpPageCarded/internal/OwpPageCardedSidebar.d.ts

@@ -1,5 +1,5 @@
 import { type SwipeableDrawerProps } from '@mui/material/SwipeableDrawer';
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 /**
  * Props for the OwpPageCardedSidebar component.
  */

package/dist/types/components/OwpPageCarded/internal/OwpPageCardedSidebarContent.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import type { ReactNode } from 'react';
 /**
  * Props for the OwpPageCardedSidebarContent component.
  */

package/dist/types/components/OwpPageContent/OwpPageContent.d.ts

@@ -8,13 +8,13 @@ interface OwpPageContentProps {
     loading?: boolean;
 }
 /**
- * OwpPageContent 컴포넌트
- * @param title 제목
- * @param leftSlot leftSlot 값
- * @param centerSlot centerSlot 값
- * @param actions 액션 영역
- * @param children 하위 콘텐츠
- * @param loading 로딩 상태
+ * page header와 body 영역을 분리해 sticky title/action bar를 구성
+ * @param title header title 영역
+ * @param leftSlot title 왼쪽에 배치할 보조 콘텐츠
+ * @param centerSlot title 중앙에 배치할 보조 콘텐츠
+ * @param actions header 오른쪽 action 영역
+ * @param children body 콘텐츠
+ * @param loading title 영역 loading 표시 여부
  */
 declare const OwpPageContent: ({ title, leftSlot, centerSlot, actions, children, loading, }: OwpPageContentProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpPageContent };

package/dist/types/components/OwpPageLockLoading/OwpPageLockLoading.d.ts

@@ -1,11 +1,15 @@
+/**
+ * 페이지 상호작용을 막는 loading overlay props
+ */
 export interface OwpPageLockLoadingProps {
+    /** Backdrop 표시 여부 */
     loading?: boolean;
+    /** progress 아래 표시할 문구 */
     title?: string;
 }
 /**
- * OwpPageLockLoading 컴포넌트
- * @param loading 로딩 여부
- * @param title 제목
+ * 화면 전체 Backdrop으로 페이지 조작을 잠그는 loading overlay
+ * @param props Backdrop 표시 여부와 안내 문구
  */
 declare const OwpPageLockLoading: ({ loading, title }: OwpPageLockLoadingProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpPageLockLoading };

package/dist/types/components/OwpPageSkeleton/OwpPageSkeleton.d.ts

@@ -1,4 +1,4 @@
-import type { OwpPageSkeletonSpec } from '@/contexts/OwpAppProvider';
+import type { OwpPageSkeletonSpec } from '@/contexts/OwpAppContext';
 type OwpPageSkeletonProps = {
     spec: OwpPageSkeletonSpec;
 };

package/dist/types/components/OwpPageTitle/OwpPageTitle.d.ts

@@ -1,18 +1,22 @@
 import type { ReactNode } from 'react';
+/**
+ * Page title header props
+ */
 interface OwpPageTitleProps {
+    /** 페이지 제목 */
     title?: ReactNode;
+    /** 제목 오른쪽 첫 번째 slot */
     leftSlot?: ReactNode;
+    /** 중앙 slot */
     centerSlot?: ReactNode;
+    /** 우측 action 영역 */
     actions?: ReactNode;
+    /** title icon 대신 progress 표시 여부 */
     loading?: boolean;
 }
 /**
- * OwpPageTitle 컴포넌트
- * @param title 제목
- * @param leftSlot leftSlot 값
- * @param centerSlot centerSlot 값
- * @param actions 액션 영역
- * @param loading 로딩 상태
+ * 페이지 제목, 보조 slot, action 영역을 wrapping 상태에 맞춰 배치하는 header
+ * @param props title, slot, action, loading 상태
  */
 declare const OwpPageTitle: ({ title, leftSlot, centerSlot, actions, loading }: OwpPageTitleProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpPageTitle };

package/dist/types/components/OwpPicker/OwpDatePicker.d.ts

@@ -1,34 +1,41 @@
 import { type TextFieldProps } from '@mui/material';
 import { type DatePickerProps } from 'react-datepicker';
+/**
+ * DatePicker에서 허용하는 외부 value 타입
+ */
 export type DatePickerValue = string | Date;
 interface OwnProps {
+    /** root className */
     className?: string;
+    /** 입력 label */
     label?: string;
+    /** TextField variant */
     variant?: TextFieldProps['variant'];
+    /** TextField sx */
     sx?: TextFieldProps['sx'];
+    /** 선택된 날짜/시간 값. 문자열은 picker mode별 formatter 기준으로 파싱 */
     value?: DatePickerValue;
+    /** time picker에서 오전/오후 표시 사용 여부 */
     useAmPm?: boolean;
+    /** clear 버튼 표시 여부 */
     clearable?: boolean;
+    /** 오늘 이후 날짜 비활성화 여부 */
     disableFuture?: boolean;
+    /** 월 선택 picker 사용 여부 */
     showMonthPicker?: boolean;
+    /** calendar에 week number 표시 여부 */
     showWeekNumbers?: boolean;
+    /** 입력 필드 전체 너비 사용 여부 */
     fullWidth?: boolean;
+    /** 선택/clear 시 formatter 문자열 또는 Date 값을 전달하는 handler */
     onChange?: (value?: DatePickerValue) => void;
+    /** custom input으로 쓰는 TextField props */
     textFieldProps?: Omit<TextFieldProps, 'value' | 'defaultValue' | 'onChange'>;
 }
 type OwpDatePickerProps = OwnProps & DatePickerProps;
 /**
- * OwpDatePicker 컴포넌트
- * @param className CSS 클래스명
- * @param label 입력 라벨
- * @param variant variant 값
- * @param sx sx 값
- * @param value 현재 값
- * @param useAmPm 오전/오후 포맷 사용 여부
- * @param clearable 초기화 가능 여부
- * @param disableFuture 미래 날짜 비활성화 여부
- * @param showWeekNumbers 캘린더 주차 표시 여부
- * @param onChange onChange 핸들러
+ * `react-datepicker` 기반 OWP DatePicker
+ * @param props picker mode별 value formatter, clear/future 제어, TextField 표시 옵션
  */
 declare const OwpDatePicker: ({ className, label, variant, sx, value, useAmPm, onChange, fullWidth, showYearPicker, showMonthPicker, showTimeSelect, showTimeSelectOnly, showTimeInput, showWeekNumbers, textFieldProps, clearable, disableFuture, popperClassName: popperClassNameProp, popperContainer: popperContainerProp, ...datePickerProps }: OwpDatePickerProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpDatePicker };