@owp/core 2.5.47 → 2.5.49

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

@@ -1,18 +1,23 @@
 import { CacheProvider } from '@emotion/react';
 import { type Theme } from '@mui/material/styles';
-import { ComponentProps, ReactNode } from 'react';
+import { type ComponentProps, type ReactNode } from 'react';
 type OwpCacheProviderProps = Omit<ComponentProps<typeof CacheProvider>, 'children'>;
+/**
+ * OWP style provider props
+ */
 export interface OwpStyleProviderProps {
+    /** theme boundary 내부에 render할 children */
     children?: ReactNode;
+    /** 직접 적용할 MUI theme. 생략 시 store main theme 사용 */
     theme?: Theme;
+    /** document body class와 app-level global style 적용 여부 */
     root?: boolean;
+    /** Emotion CacheProvider props. `value`가 없으면 CacheProvider를 생략 */
     cacheProviderProps?: OwpCacheProviderProps;
 }
 /**
- * CacheProvider, theme composition
- * @param theme MUI theme 객체. 미지정 시 store main theme 사용
- * @param root 글로벌 스타일 적용 여부
- * @param cacheProviderProps CacheProvider 옵션
+ * OWP app 전역 MUI theme, Emotion cache, global style을 제공하는 provider
+ * @param props 직접 theme 또는 store fallback theme, root global style 여부, CacheProvider 설정
  */
 export declare function OwpStyleProvider(props: OwpStyleProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import type { OwpLoadingProps } from '@/components/OwpLoading/OwpLoading';
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 type OwpSuspenseProps = {
     loadingProps?: OwpLoadingProps;
     children: ReactNode;

package/dist/types/components/OwpTable/OwpDataTable.d.ts

@@ -43,18 +43,18 @@ type OwpDataTableBlurEvent = Record<string, unknown> & {
     };
 };
 /**
- * OwpDataTable 컴포넌트
- * @param className CSS 클래스명
- * @param sx sx 값
- * @param headSx headSx 값
- * @param headCells headCells 값
- * @param rows 행 데이터 목록
- * @param selected selected 값
- * @param canTableRadiusZero 테이블 radius 0 사용 여부
- * @param canUseTableRadius 테이블 radius 사용 여부
+ * checkbox selection, order by, total count row를 제공하는 data table
+ * @param className root table className
+ * @param sx root table sx
+ * @param headSx header row/cell sx
+ * @param headCells header cell 정의 목록
+ * @param rows body row 데이터 목록
+ * @param selected 선택된 row 목록
+ * @param canTableRadiusZero table radius 0 강제 여부
+ * @param canUseTableRadius table radius token 적용 여부
  * @param canUseTreeGridStyle TreeGrid 스타일 사용 여부
- * @param tableBorderRadius 테이블 radius 값
- * @param fixedRowCount 고정 row 수
+ * @param tableBorderRadius table radius token 또는 CSS length 값
+ * @param fixedRowCount 최소 높이를 유지할 body row 수
  */
 export declare function OwpDataTable<T extends Row = Row>({ className, sx, headSx, headCells, rows, selected, canCheckbox, canTotalCountRow, canSelectingSingle, canUseOrderBy, canTableRadiusZero, canUseTableRadius, canUseTreeGridStyle, tableBorderRadius, fixedRowCount, onSelect, onBlur, }: OwpDataTableProps<T>): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/OwpTable/OwpFieldTable.d.ts

@@ -38,20 +38,20 @@ interface OwpFieldTableProps {
     tableBorderRadius?: string | number;
 }
 /**
- * OwpFieldTable 컴포넌트
- * @param layout layout 값
- * @param titleWidth titleWidth 값
- * @param titleSx titleSx 값
- * @param treeGridTitleCellSx TreeGrid title cell sx 값
- * @param cellSx cellSx 값
- * @param data 데이터
- * @param colGroupSlot colGroupSlot 값
- * @param className className 값
- * @param tableLayout tableLayout 값
- * @param canTableRadiusZero 테이블 radius 0 사용 여부
- * @param canUseTableRadius 테이블 radius 사용 여부
+ * label/value field layout을 table 형태로 render
+ * @param layout row/column별 field cell 정의
+ * @param titleWidth title cell 너비
+ * @param titleSx title cell sx
+ * @param treeGridTitleCellSx TreeGrid 스타일 모드 title cell sx
+ * @param cellSx value cell sx
+ * @param data field value를 조회할 row data
+ * @param colGroupSlot custom colgroup 영역
+ * @param className root table className
+ * @param tableLayout CSS table-layout 값
+ * @param canTableRadiusZero table radius 0 강제 여부
+ * @param canUseTableRadius table radius token 적용 여부
  * @param canUseTreeGridStyle TreeGrid 스타일 사용 여부
- * @param tableBorderRadius 테이블 radius 값
+ * @param tableBorderRadius table radius token 또는 CSS length 값
  */
 export declare function OwpFieldTable({ layout, titleWidth, titleSx, treeGridTitleCellSx, cellSx, data, colGroupSlot, className, tableLayout, canTableRadiusZero, canUseTableRadius, canUseTreeGridStyle, tableBorderRadius, }: OwpFieldTableProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -8,15 +8,15 @@ interface OwpTableProps<T> extends Omit<OwpTableBaseProps, 'children'> {
     totalCount?: number;
 }
 /**
- * OwpTable 컴포넌트
+ * header map과 row data로 단순 display table을 구성
  * @param canTotalCountRow 전체 row 수 표시 여부
- * @param canTableRadiusZero 테이블 radius 0 사용 여부
- * @param canUseTableRadius 테이블 radius 사용 여부
+ * @param canTableRadiusZero table radius 0 강제 여부
+ * @param canUseTableRadius table radius token 적용 여부
  * @param canUseTreeGridStyle TreeGrid 스타일 사용 여부
- * @param headers headers 값
- * @param rows 행 데이터 목록
- * @param tableBorderRadius 테이블 radius 값
- * @param totalCount 전체 row 수
+ * @param headers header label map 또는 header row 목록
+ * @param rows body row 데이터 목록
+ * @param tableBorderRadius table radius token 또는 CSS length 값
+ * @param totalCount 외부에서 계산한 전체 row 수
  */
 export declare function OwpTable<T>({ canTotalCountRow, headers, rows, totalCount, ...restTableProps }: OwpTableProps<T>): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/OwpTable/internal/OwpTableBase.d.ts

@@ -3,28 +3,41 @@ import { type OwpResolvedTableThemeConfigType } from '@/constants/tableTheme';
 import { type TableProps } from '@mui/material/Table';
 import { type TableContainerProps } from '@mui/material/TableContainer';
 import { type ReactNode } from 'react';
+/** OWP table shell과 TreeGrid 스타일 호환 모드를 제어하는 속성 */
 export interface OwpTableBaseProps extends TableProps {
+    /** body row가 container 높이를 채우도록 stretch 적용 여부 */
     canBodyFullHeight?: boolean;
+    /** table/container radius를 0으로 강제할지 여부 */
     canTableRadiusZero?: boolean;
+    /** table radius token 적용 여부 */
     canUseTableRadius?: boolean;
+    /** TreeGrid와 동일한 border/typography 스타일 사용 여부 */
     canUseTreeGridStyle?: boolean;
+    /** 외부 TableContainer 속성 */
     containerProps?: TableContainerProps;
+    /** TableContainer 아래에 배치할 footer 영역 */
     footerSlot?: ReactNode;
+    /** resolved table theme override */
     tableTheme?: OwpResolvedTableThemeConfigType;
+    /** CSS table-layout 값 */
     tableLayout?: 'auto' | 'fixed';
+    /** table radius token 또는 CSS length 값 */
     tableBorderRadius?: string | number;
+    /** TreeGrid 스타일 모드에서 사용할 resolved grid theme */
     treeGridTheme?: OwpResolvedGridThemeConfigType;
+    /** 접근성/디버깅용 table title */
     title?: string;
+    /** table section/content */
     children: ReactNode;
 }
 /**
- * OWP Table 기반 컨테이너
+ * OWP Table 기반 container
  * @param canBodyFullHeight body full height 사용 여부
  * @param canTableRadiusZero 테이블 radius 0 사용 여부
  * @param canUseTableRadius 테이블 radius 사용 여부
  * @param canUseTreeGridStyle TreeGrid 스타일 사용 여부
  * @param children 하위 콘텐츠
- * @param containerProps containerProps props
+ * @param containerProps TableContainer 부가 속성
  * @param footerSlot footer 영역
  * @param tableLayout tableLayout 값
  * @param tableBorderRadius 테이블 radius 값

package/dist/types/components/OwpTable/internal/defaultTableStyle.d.ts

@@ -1,5 +1,12 @@
 import type { OwpResolvedTableThemeConfigType } from '@/constants/tableTheme';
+/** Default table header background fallback color */
 export declare const DEFAULT_TABLE_HEADER_BACKGROUND_COLOR = "#f5f5f5";
+/**
+ * 기본 table border 색상
+ * @param mode palette mode
+ */
+export declare const getDefaultTableBorderColor: (mode?: string) => "rgba(241,245,249,.12)" | "#e2e8f0";
+/** OwpTableBase에서 사용하는 table theme 기본 resolved token */
 export declare const defaultStyledTableTheme: {
     borderColor: string;
     header: {
@@ -39,6 +46,7 @@ export declare const getDefaultTableHeaderLabelSx: (tableTheme: OwpResolvedTable
     readonly fontSize: string | number;
     readonly fontWeight: string | number;
 };
+/** sort label이 header color를 상속하도록 고정하는 sx */
 export declare const defaultTableSortLabelSx: {
     readonly '&.MuiTableSortLabel-root': {
         readonly color: "inherit";

package/dist/types/components/OwpTable/internal/treeGridTableStyle.d.ts

@@ -1,9 +1,12 @@
 import type { OwpResolvedGridThemeConfigType } from '@/constants/gridTheme';
+/** TreeGrid 스타일 table header border 색상 */
 export declare const TREEGRID_TABLE_HEADER_BORDER_COLOR = "#6F7F94";
+/** TreeGrid 스타일 table body border 색상 */
 export declare const TREEGRID_TABLE_BODY_BORDER_COLOR = "#CDD8E4";
+/** TreeGrid 스타일 table font family stack */
 export declare const TREEGRID_TABLE_FONT_FAMILY_STACK: string;
 /**
- * TreeGrid 컨테이너 색상 매핑
+ * TreeGrid container 색상 mapping
  * @param treeGridTheme Grid theme 값
  */
 export declare const getTreeGridContainerSx: (treeGridTheme: OwpResolvedGridThemeConfigType) => {

package/dist/types/components/OwpTabs/OwpTab.d.ts

@@ -1,6 +1,4 @@
-/**
- * OwpTab 컴포넌트
- */
+/** ripple을 제거하고 OWP tab height/spacing을 고정한 MUI Tab variant */
 declare const OwpTab: import("@emotion/styled").StyledComponent<import("@mui/material").TabOwnProps & Omit<import("@mui/material").ButtonBaseOwnProps, "classes"> & import("@mui/material/OverridableComponent").CommonProps & Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "style" | "action" | "disabled" | "className" | "classes" | "children" | "sx" | "label" | "tabIndex" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableFocusRipple" | "value" | "icon" | "wrapped" | "iconPosition"> & {
     component?: React.ElementType | undefined;
 } & import("@mui/system").MUIStyledCommonProps<import("@mui/material").Theme>, {}, {}>;

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

@@ -1,6 +1,4 @@
-/**
- * OwpTabs 컴포넌트
- */
+/** scroll button 없이 full-width indicator를 사용하는 OWP Tabs wrapper */
 declare const OwpTabs: import("@emotion/styled").StyledComponent<import("@mui/material").TabsOwnProps & import("@mui/material/OverridableComponent").CommonProps & Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "style" | "action" | "className" | "classes" | "children" | "sx" | "variant" | "aria-label" | "aria-labelledby" | "onChange" | "slots" | "slotProps" | "value" | "orientation" | "allowScrollButtonsMobile" | "centered" | "indicatorColor" | "ScrollButtonComponent" | "scrollButtons" | "selectionFollowsFocus" | "TabIndicatorProps" | "TabScrollButtonProps" | "textColor" | "visibleScrollbar"> & {
     component?: React.ElementType | undefined;
 } & import("@mui/system").MUIStyledCommonProps<import("@mui/material").Theme>, {}, {}>;

package/dist/types/components/OwpTextField/OwpTextMaskField.d.ts

@@ -2,11 +2,16 @@ import type { FormControlProps } from '@mui/material/FormControl';
 import type { InputProps as MuiInputProps } from '@mui/material/Input';
 import { type ReactNode } from 'react';
 import { type Definitions, type FactoryOpts } from 'imask';
+/**
+ * IMask accept event를 MUI TextField change 형태로 정규화한 event
+ */
 export type OwpTextMaskFieldChangeEvent = {
+    /** MUI input change와 호환되는 target name/value */
     target: {
         name: string;
         value: string;
     };
+    /** mask 문자를 제거한 원본 값 */
     unmaskedValue: string;
 };
 type TextMaskValue = FactoryOpts['mask'];
@@ -23,10 +28,8 @@ type OwpTextMaskFieldProps = Omit<MuiInputProps, 'onChange' | 'inputComponent'>
     onChange: CustomProps['onMaskChange'];
 };
 /**
- * 마스크 텍스트 입력 필드
- * @param mask 입력 마스크 정의
- * @param definitions 사용자 정의 마스크 정의
- * @param onChange 마스크 변경 이벤트 핸들러
+ * IMask 기반 입력 제한을 MUI Input/FormControl 형태로 제공하는 필드
+ * @param props mask 정의, 사용자 definitions, value/defaultValue, label/helper text, change handler
  */
 export declare function OwpTextMaskField({ className, sx, id: idProp, name, label, value, defaultValue, color, onChange, error, helperText, mask, definitions, variant, fullWidth, disabled, required, size, placeholder, autoFocus, inputProps, inputRef, ...inputBaseProps }: OwpTextMaskFieldProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -5,31 +5,79 @@ type TreeGridLayoutScalarValue = string | number;
 type TreeGridNestedLayoutFields = Record<string, TreeGridLayoutScalarValue>;
 type TreeGridLayoutFields = Record<string, TreeGridLayoutScalarValue | TreeGridNestedLayoutFields>;
 type TreeGridSectionFields = Record<string, TreeGridLayoutScalarValue>;
+/**
+ * TreeGrid XML/JSON layout override 구조
+ */
 export interface OwpTreeGridLayout {
+    /** Header section override */
     Header?: TreeGridLayoutFields;
+    /** Toolbar section override */
     Toolbar?: TreeGridSectionFields;
+    /** Foot section override */
     Foot?: TreeGridSectionFields;
 }
+/**
+ * `OwpTreeGridLayout` 호환 alias
+ */
 export type OwpTreeGridLayoutConfig = OwpTreeGridLayout;
+/**
+ * 기존 `header` prop 호환용 layout config alias
+ */
 export type THeader = OwpTreeGridLayoutConfig;
+/**
+ * TreeGrid body data 입력 타입
+ */
 export type OwpTreeGridBodyData<T> = Record<string, never> | [] | undefined | T[];
+/**
+ * `OwpTreeGridBodyData` 호환 alias
+ */
 export type OwpTreeGridData<T> = OwpTreeGridBodyData<T>;
+/**
+ * 기존 `data` prop 호환용 body data alias
+ */
 export type TData<T> = OwpTreeGridBodyData<T>;
+/**
+ * TreeGrid row 객체와 app row data를 합친 모델
+ */
 export type OwpTreeGridRowModel<T> = TRow & T;
+/**
+ * `onSelect`에서 반환하는 선택 row 목록
+ */
 export type OwpTreeGridSelectedRows<T> = OwpTreeGridRowModel<T>[];
+/**
+ * TreeGrid `SuppressCfg` 설정 값
+ */
 export type OwpTreeGridSuppressCfg = 0 | 1 | 2 | 3 | 4;
+/**
+ * OWP wrapper에서 비활성화할 수 있는 TreeGrid animation key
+ */
 export type OwpTreeGridDisabledAnimation = 'addRow' | 'deleteRow' | 'selectRow';
+/**
+ * DatePicker editor column별 기준 날짜 옵션
+ */
 export interface OwpTreeGridDatePickerEditorColumnOption {
+    /** 연도 picker 기준 연도 값 */
     baseYear?: string;
+    /** 월 picker 기준 연월 값 */
     baseYearMonth?: string;
 }
+/**
+ * TreeGrid cell을 OWP DatePicker editor로 편집하기 위한 설정
+ */
 export interface OwpTreeGridDatePickerEditorConfig {
+    /** DatePicker editor 활성화 여부 */
     enabled?: boolean;
+    /** DatePicker editor를 적용할 column key 목록 */
     columns?: readonly string[];
+    /** editor input 직접 입력 허용 여부 */
     allowInput?: boolean;
+    /** column별 DatePicker 기준 날짜 옵션 */
     columnOptions?: Record<string, OwpTreeGridDatePickerEditorColumnOption>;
+    /** 날짜와 시간을 함께 입력하는 input 표시 여부 */
     showTimeInput?: boolean;
+    /** time select UI 표시 여부 */
     showTimeSelect?: boolean;
+    /** time select minute interval */
     timeIntervals?: number;
 }
 type OwpTreeGridSelectHandler<T> = (selectedRows: OwpTreeGridSelectedRows<T>) => void;
@@ -41,62 +89,90 @@ type OwpTreeGridRowClickHandler<T> = (grid: TGrid, row: OwpTreeGridRowModel<T>,
 type OwpTreeGridSaveHandler<T> = (grid: TGrid, row: OwpTreeGridRowModel<T>, autoupdate: boolean | number) => void;
 type OwpTreeGridCellValue = unknown;
 type OwpTreeGridAfterValueChangedHandler<T> = (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string, value: OwpTreeGridCellValue) => void;
+/**
+ * OWP TreeGrid wrapper props
+ */
 export interface OwpTreeGridProps<T> {
+    /** TreeGrid DOM id와 instance id */
     id: string;
+    /** TreeGrid root className */
     className?: string;
+    /** wrapper container inline style */
     containerStyle?: CSSProperties;
+    /** wrapper container className */
     containerClassName?: string;
+    /** Toolbar row 배경색 override */
     toolbarRowBackgroundColor?: CSSProperties['backgroundColor'];
+    /** TreeGrid layout XML URL */
     layoutUrl?: string;
+    /** TreeGrid layout XML 문자열 */
     layoutData?: string;
+    /** OWP wrapper에서 비활성화할 animation key 목록 */
     disabledAnimations?: readonly OwpTreeGridDisabledAnimation[];
+    /** TreeGrid data XML/JSON URL */
     dataUrl?: string;
+    /** XML layout에 병합할 Header/Toolbar/Foot override */
     layoutOverrides?: OwpTreeGridLayoutConfig;
+    /** TreeGrid body data 배열. 빈 객체/빈 배열/undefined는 빈 데이터로 처리 */
     data?: OwpTreeGridBodyData<T>;
+    /** TreeGrid host element inline style */
     style?: CSSProperties;
+    /** TreeGrid 높이 */
     height?: string | number;
+    /** TreeGrid 너비 */
     width?: string | number;
+    /** OWP table radius style 적용 여부 */
     canUseTableRadius?: boolean;
+    /** OWP table radius style 값 */
     tableBorderRadius?: string | number;
+    /** TreeGrid `SuppressCfg` 값 */
     suppressCfg?: OwpTreeGridSuppressCfg;
+    /** Toolbar에 전체 건수 formula 표시 여부 */
     showToolbarTotalCount?: boolean;
+    /** 그룹 header 하위 sort button 숨김 여부 */
     hideChildHeaderSortButtons?: boolean;
+    /** 선택 row 반환 범위 */
     selectionScope?: OwpTreeGridSelectionScope;
+    /** `dataUrl` 기반 데이터 로딩 사용 여부 */
     useDataUrl?: boolean;
+    /** 선택 row 변경 시 호출. `selectionScope` 처리 후 row 목록 전달 */
     onSelect?: OwpTreeGridSelectHandler<T>;
+    /** row 추가 직후 호출 */
     onRowAdd?: OwpTreeGridRowAddHandler<T>;
+    /** row delete 처리 직후 호출 */
     onRowDelete?: OwpTreeGridRowDeleteHandler<T>;
+    /** row undelete 처리 직후 호출 */
     onRowUndelete?: OwpTreeGridRowUndeleteHandler<T>;
+    /** cell 값 변경 후 호출되는 이전 호환 handler */
     onRowChange?: OwpTreeGridAfterValueChangedHandler<T>;
+    /** TreeGrid button cell 클릭 시 호출 */
     onClickButton?: OwpTreeGridButtonClickHandler<T>;
+    /** TreeGrid instance 초기화 완료 시 호출 */
     onReady?: (grid: TGrid) => void;
+    /** TreeGrid row 클릭 시 호출 */
     onRowClick?: OwpTreeGridRowClickHandler<T>;
+    /** TreeGrid save event 발생 시 호출 */
     onSave?: OwpTreeGridSaveHandler<T>;
+    /** cell 값 변경 후 호출 */
     onAfterValueChanged?: OwpTreeGridAfterValueChangedHandler<T>;
+    /** DatePicker editor 설정 */
     datePickerEditor?: OwpTreeGridDatePickerEditorConfig;
+    /** 편집 가능 cell highlight 표시 여부 */
     highlightEditableCells?: boolean;
+    /** 변경된 cell highlight 표시 여부 */
     highlightChangedCells?: boolean;
+    /** delete 상태 row 편집 가능 여부를 TreeGrid 상태와 동기화할지 여부 */
     syncDeletedRowCanEdit?: boolean;
+    /** delete 상태 row 제거 전 confirm dialog 표시 여부 */
     confirmDeletedRowRemoval?: boolean;
+    /** 외부 loading 상태 */
     loading?: boolean;
+    /** loading overlay 표시 여부 */
     showLoading?: boolean;
 }
 /**
- * OwpTreeGrid 컴포넌트
- * @param id 식별자
- * @param containerStyle containerStyle 값
- * @param containerClassName containerClassName 값
- * @param toolbarRowBackgroundColor 하단 Toolbar row 배경색
- * @param className CSS 클래스명
- * @param style 스타일 객체
- * @param height height 값
- * @param canUseTableRadius TreeGrid 내부 테이블 radius 사용 여부
- * @param tableBorderRadius TreeGrid 내부 테이블 radius 값
- * @param suppressCfg TreeGrid client 설정 저장/로드 억제값
- * @param showToolbarTotalCount Toolbar 전체 건수 기본 formula 표시 여부
- * @param hideChildHeaderSortButtons 그룹 헤더 하위 sort 버튼 숨김 여부
- * @param selectionScope 선택 행 반환 범위
- * @param disabledAnimations 비활성화할 TreeGrid 애니메이션 의미 키 목록
+ * OWP theme, layout override, data binding, selection, overlay 처리를 포함한 TreeGrid wrapper
+ * @param props TreeGrid id/layout/data, event handlers, selection scope, style와 loading 설정
  */
 declare const OwpTreeGrid: <T>({ id, containerStyle, containerClassName, toolbarRowBackgroundColor, className, style, height, width, canUseTableRadius, tableBorderRadius, suppressCfg, showToolbarTotalCount, hideChildHeaderSortButtons, selectionScope, layoutUrl, layoutData, disabledAnimations, dataUrl, layoutOverrides, data, useDataUrl, onSelect, onRowClick, onRowAdd, onRowDelete, onRowUndelete, onRowChange, onClickButton, onSave, onReady, onAfterValueChanged, datePickerEditor, highlightEditableCells, highlightChangedCells, syncDeletedRowCanEdit, confirmDeletedRowRemoval, loading, showLoading, }: OwpTreeGridProps<T>) => import("react/jsx-runtime").JSX.Element;
 export { OwpTreeGrid };

package/dist/types/components/OwpTreeGrid/OwpTreeGridToolbar.d.ts

@@ -1,8 +1,15 @@
-import { FormGroupProps } from '@mui/material';
+import { type FormGroupProps } from '@mui/material';
+/**
+ * TreeGrid column visibility toolbar props
+ */
 interface OwpTreeGridToolbarProps {
+    /** 대상 TreeGrid instance id */
     gridId: string;
+    /** header visibility checkbox 영역 표시 여부 */
     canVisibleHeaderFilter?: boolean;
+    /** toolbar option 목록 */
     options?: {
+        /** 표시/숨김을 제어할 header column 목록 */
         header?: Array<{
             label: string;
             name: string;
@@ -11,10 +18,8 @@ interface OwpTreeGridToolbarProps {
     };
 }
 /**
- * OwpTreeGridToolbar 컴포넌트
- * @param gridId TreeGrid 인스턴스 ID
- * @param canVisibleHeaderFilter canVisibleHeaderFilter 값
- * @param options options 값
+ * TreeGrid header column 표시 여부를 checkbox로 제어하는 toolbar
+ * @param props TreeGrid id, header option 목록, MUI FormGroup 표시 속성
  */
 declare const OwpTreeGridToolbar: ({ gridId, canVisibleHeaderFilter, options, className, ...formGroupProps }: OwpTreeGridToolbarProps & FormGroupProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpTreeGridToolbar };

package/dist/types/components/OwpTreeGrid/TreeGrid.d.ts

@@ -1,6 +1,6 @@
-import { CSSProperties } from 'react';
+import { type CSSProperties } from 'react';
 type LayoutDef = {
-    Cfg: any;
+    Cfg: Record<string, unknown>;
     Def?: TRow;
     LeftCols?: TCol[];
     Cols: TCol[];
@@ -8,18 +8,22 @@ type LayoutDef = {
     Head?: TRow[];
     Body?: TRow[];
 };
+/**
+ * 레거시 TreeGrid 직접 생성 wrapper props
+ */
 interface TreeGridProps {
+    /** TreeGrid DOM id와 instance id */
     id: string;
+    /** wrapper className */
     className?: string;
+    /** wrapper inline style */
     style?: CSSProperties;
+    /** TreeGrid layout definition 객체 */
     layoutDef: LayoutDef;
 }
 /**
- * 레거시 TreeGrid 래퍼
- * @param id 식별자
- * @param className CSS 클래스명
- * @param style 스타일 객체
-  * @param layoutDef 레이아웃 정의
+ * layout definition 객체로 TreeGrid instance를 생성/갱신하는 레거시 wrapper
+ * @param props TreeGrid id, wrapper style, layout definition
  */
 export declare const TreeGrid: ({ id, className, style, layoutDef }: TreeGridProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/OwpTreeGrid/internal/OwpTreeGridErrorTooltip.d.ts

@@ -1,11 +1,15 @@
+/** TreeGrid error tooltip을 표시할 anchor와 메시지 상태 */
 export type OwpTreeGridErrorTooltipState = {
+    /** tooltip을 붙일 cell/editor DOM 요소 */
     anchorEl: HTMLElement;
+    /** 동일 cell tooltip 중복 갱신 방지용 key */
     key: string;
+    /** tooltip 본문 메시지 */
     message: string;
 };
 /**
- * OwpTreeGrid Error tooltip 표시 컴포넌트
- * @param tooltip tooltip 표시 상태
+ * TreeGrid cell error 메시지를 anchor 기준 fixed Popper tooltip으로 표시
+ * @param tooltip anchor와 메시지를 담은 tooltip 상태
  */
 export declare const OwpTreeGridErrorTooltip: ({ tooltip, }: {
     tooltip: OwpTreeGridErrorTooltipState | null;

package/dist/types/components/OwpTreeGrid/internal/OwpTreeGridScrollLoadingOverlay.d.ts

@@ -0,0 +1,10 @@
+import { type OwpTreeGridOverlayFrame } from './hooks/useOwpTreeGridOverlayFrame';
+type OwpTreeGridScrollLoadingOverlayProps = {
+    visible: boolean;
+    overlayFrame: OwpTreeGridOverlayFrame;
+};
+/**
+ * TreeGrid scroll rendering overlay
+ */
+declare const OwpTreeGridScrollLoadingOverlay: ({ visible, overlayFrame, }: OwpTreeGridScrollLoadingOverlayProps) => import("react/jsx-runtime").JSX.Element;
+export { OwpTreeGridScrollLoadingOverlay };

package/dist/types/components/OwpTreeGrid/internal/hooks/useOwpTreeGridAddedRowBoxOverlay.d.ts

@@ -1,9 +1,15 @@
 import { type RefObject } from 'react';
+/** TreeGrid 신규 행 강조 box overlay의 위치와 크기 */
 export type TreeGridAddedRowBoxFrame = {
+    /** overlay key로 사용하는 row ID */
     id: string;
+    /** container 기준 left offset(px) */
     left: number;
+    /** container 기준 top offset(px) */
     top: number;
+    /** overlay width(px) */
     width: number;
+    /** overlay height(px) */
     height: number;
 };
 type UseOwpTreeGridAddedRowBoxOverlayInput = {

package/dist/types/components/OwpTreeGrid/internal/hooks/useOwpTreeGridErrorTooltip.d.ts

@@ -1,14 +1,21 @@
 import { type ReactNode } from 'react';
+/** TreeGrid error tooltip 표시 요청 payload */
 export type OwpTreeGridErrorTooltipShowParams = {
+    /** tooltip anchor로 사용할 cell/editor DOM 요소 */
     anchorEl: HTMLElement;
+    /** error가 속한 TreeGrid row */
     row: TRow;
+    /** error가 속한 TreeGrid column name */
     col: string;
+    /** tooltip에 표시할 error 메시지 */
     message: string;
 };
+/** TreeGrid error tooltip 표시 callback */
 export type OwpTreeGridErrorTooltipShowHandler = (params: OwpTreeGridErrorTooltipShowParams) => void;
+/** TreeGrid error tooltip 숨김 callback */
 export type OwpTreeGridErrorTooltipHideHandler = () => void;
 /**
- * OwpTreeGrid Error tooltip 상태 훅
+ * OwpTreeGrid Error tooltip 상태 Hook
  */
 export declare const useOwpTreeGridErrorTooltip: () => {
     errorTooltipElement: ReactNode;

package/dist/types/components/OwpTreeGrid/internal/hooks/useOwpTreeGridOverlayFrame.d.ts

@@ -1,8 +1,13 @@
 import { type RefObject } from 'react';
+/** TreeGrid loading/no-data overlay가 덮을 frame */
 export type OwpTreeGridOverlayFrame = {
+    /** container 기준 left offset(px) */
     left: number;
+    /** container 기준 top offset(px) */
     top: number;
+    /** overlay width(px) */
     width: number;
+    /** overlay height(px) */
     height: number;
 };
 type UseOwpTreeGridOverlayFrameInput = {
@@ -11,7 +16,9 @@ type UseOwpTreeGridOverlayFrameInput = {
     treeGridInstanceRef: RefObject<TGrid>;
     debugId?: string;
 };
+/** TreeGrid no-data overlay가 grid 내부 UI 위에 위치하도록 하는 z-index */
 export declare const TREE_GRID_NO_DATA_OVERLAY_Z_INDEX = 2147483646;
+/** loading overlay가 no-data overlay보다 위에 위치하도록 하는 z-index */
 export declare const TREE_GRID_LOADING_OVERLAY_Z_INDEX = 2147483647;
 /**
  * TreeGrid overlay frame hook

package/dist/types/components/OwpTreeGrid/internal/hooks/useOwpTreeGridScrollRenderLoading.d.ts

@@ -0,0 +1,14 @@
+import { type RefObject } from 'react';
+import { type OwpTreeGridOverlayFrame } from './useOwpTreeGridOverlayFrame';
+type UseOwpTreeGridScrollRenderLoadingInput = {
+    containerRef: RefObject<HTMLDivElement | null>;
+    treeGridInstanceRef: RefObject<TGrid>;
+    enabled: boolean;
+    resetKey?: unknown;
+};
+/**
+ * TreeGrid scroll 후 실제 DOM 공백 frame
+ * @param input TreeGrid refs, 활성 조건, reset key
+ */
+declare const useOwpTreeGridScrollRenderLoading: ({ containerRef, treeGridInstanceRef, enabled, resetKey, }: UseOwpTreeGridScrollRenderLoadingInput) => OwpTreeGridOverlayFrame;
+export { useOwpTreeGridScrollRenderLoading };