@owp/core 2.5.47 → 2.5.49

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

@@ -1,14 +1,23 @@
 import { type OwpTreeGridLayoutConfig } from '../OwpTreeGrid';
 type TreeGridHeaderLayoutConfig = NonNullable<OwpTreeGridLayoutConfig['Header']>;
 type TreeGridSectionConfig = Record<string, unknown>;
+/** TreeGrid Header layout section key */
 export declare const TREE_GRID_HEADER_SECTION = "Header";
+/** TreeGrid Toolbar layout section key */
 export declare const TREE_GRID_TOOLBAR_SECTION = "Toolbar";
+/** TreeGrid Foot layout section key */
 export declare const TREE_GRID_FOOT_SECTION = "Foot";
+/** TreeGrid layout XML/JSON에서 sibling section을 연결하는 key */
 export declare const TREE_GRID_NEXT_SIBLING_KEY = "nextSibling";
+/** layoutConfig 적용 대상 section key 목록 */
 export declare const TREE_GRID_LAYOUT_SECTION_KEYS: readonly ["Header", "Toolbar", "Foot"];
+/** 기존 사용처 호환용 Header section alias */
 export declare const HEADER = "Header";
+/** 기존 사용처 호환용 Toolbar section alias */
 export declare const TOOLBAR = "Toolbar";
+/** 기존 사용처 호환용 Foot section alias */
 export declare const FOOTER = "Foot";
+/** 기존 사용처 호환용 nextSibling key alias */
 export declare const NEXT_SIBLING = "nextSibling";
 /**
  * applyTreeGridSubHeaderLayoutText 적용 함수
@@ -16,13 +25,16 @@ export declare const NEXT_SIBLING = "nextSibling";
  * @param headerLayout headerLayout 값
  */
 export declare const applyTreeGridSubHeaderLayoutText: (grid: TTGrid, headerLayout?: TreeGridHeaderLayoutConfig) => void;
+/** 기존 API 호환을 위해 유지하는 sub header layout 적용 alias */
 export declare const applySubHeaderLayoutTextToGrid: (grid: TTGrid, headerLayout?: TreeGridHeaderLayoutConfig) => void;
+/** 기존 API 호환을 위해 유지하는 sub header layout 변경 alias */
 export declare const changeSubHeaderLayoutTextByGrid: (grid: TTGrid, headerLayout?: TreeGridHeaderLayoutConfig) => void;
 /**
  * parseTreeGridXmlToJson 파싱 함수
  * @param xmlString XML 문자열
  */
 export declare const parseTreeGridXmlToJson: (xmlString?: string) => TreeGridSectionConfig[];
+/** 기존 API 호환을 위해 유지하는 XML layout parser alias */
 export declare const convertXmlToJson: (xmlString?: string) => TreeGridSectionConfig[];
 /**
  * applyTreeGridLayoutToGrid 적용 함수

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

@@ -2,6 +2,7 @@ import { type Dispatch, type RefObject, type SetStateAction } from 'react';
 import type { OwpTreeGridBodyData, OwpTreeGridDisabledAnimation, OwpTreeGridLayoutConfig, OwpTreeGridProps, OwpTreeGridRowModel, OwpTreeGridSuppressCfg } from '../OwpTreeGrid';
 import type { OwpTreeGridErrorTooltipHideHandler, OwpTreeGridErrorTooltipShowHandler } from './hooks/useOwpTreeGridErrorTooltip';
 import { type OwpTreeGridSelectionScope } from './treeGridSelection';
+/** TreeGrid binding loading indicator 최소 노출 시간(ms) */
 export declare const TREE_GRID_BINDING_LOADING_MIN_VISIBLE_MS = 300;
 type TreeGridInitializationInput<T> = {
     id: string;
@@ -23,41 +24,75 @@ type TreeGridInternalCellClickHandler<T> = (grid: TGrid, row: OwpTreeGridRowMode
 type TreeGridInternalButtonClickHandler<T> = (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string, event: Event) => boolean | number | undefined;
 type TreeGridInternalKeyDownHandler = (grid: TGrid, key: string, event: Event, name: string, prefix: string) => boolean | number | undefined;
 type TreeGridInternalStartEditHandler<T> = (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string) => boolean | number | undefined;
+/** TreeGrid runtime에 연결되는 public/internal event handler 모음 */
 export type TreeGridEventHandlers<T> = Pick<OwpTreeGridProps<T>, 'onSelect' | 'onRowClick' | 'onRowAdd' | 'onRowDelete' | 'onRowUndelete' | 'onRowChange' | 'onClickButton' | 'onSave' | 'onReady' | 'onAfterValueChanged'> & {
+    /** 삭제 취소/복원 직전 row 처리 방식을 결정하는 callback */
     onBeforeRowUndelete?: TreeGridBeforeRowUndeleteHandler<T>;
+    /** TreeGrid button click 기본 처리 전 internal callback */
     onInternalButtonClick?: TreeGridInternalButtonClickHandler<T>;
+    /** TreeGrid cell click 기본 처리 전 internal callback */
     onInternalCellClick?: TreeGridInternalCellClickHandler<T>;
+    /** TreeGrid keydown 기본 처리 전 internal callback */
     onInternalKeyDown?: TreeGridInternalKeyDownHandler;
+    /** TreeGrid edit 시작 전 internal callback */
     onInternalStartEdit?: TreeGridInternalStartEditHandler<T>;
 };
+/** TreeGrid event binding과 runtime sync에 필요한 mutable ref 집합 */
 export type TreeGridEventBindingOptions<T> = Pick<OwpTreeGridProps<T>, 'id'> & {
+    /** 최신 event handler snapshot */
     latestEventHandlersRef: RefObject<TreeGridEventHandlers<T>>;
+    /** layout에서 enter 동작을 명시했는지 여부 */
     layoutHasExplicitEnterModeRef: RefObject<boolean>;
+    /** editable cell highlight 활성 상태 */
     highlightEditableCellsRef: RefObject<boolean>;
+    /** changed cell highlight 활성 상태 */
     highlightChangedCellsRef: RefObject<boolean>;
+    /** 삭제 row 편집 가능 상태 동기화 여부 */
     syncDeletedRowCanEditRef: RefObject<boolean>;
+    /** editable cell background RGB numeric value */
     editableCellBackgroundColorValueRef: RefObject<number | undefined>;
+    /** 변경 cell 배경색 */
     changedCellBackgroundColorRef: RefObject<string>;
+    /** focus cell 배경색 */
     focusedCellBackgroundColorRef: RefObject<string>;
+    /** 선택 cell 배경색 */
     selectedCellBackgroundColorRef: RefObject<string>;
+    /** hover cell 배경색 */
     hoverCellBackgroundColorRef: RefObject<string>;
+    /** 변경 감지 기준 cell 값 저장소 */
     changedCellBaselineRef: RefObject<TreeGridCellBaselineMap>;
+    /** TreeGrid instance ref */
     treeGridInstanceRef: RefObject<TGrid>;
+    /** TreeGrid 초기화 시작 시각 */
     treeGridInitStartedAtRef: RefObject<number | null>;
+    /** 최신 layout override */
     latestLayoutOverridesRef: RefObject<OwpTreeGridLayoutConfig | undefined>;
+    /** 최신 toolbar total count formula */
     latestToolbarTotalCountFormulaRef: RefObject<string | undefined>;
+    /** 최신 SuppressCfg override */
     latestSuppressCfgRef: RefObject<OwpTreeGridSuppressCfg | undefined>;
+    /** child header sort button 숨김 여부 */
     latestHideChildHeaderSortButtonsRef: RefObject<boolean>;
+    /** 최신 row selection scope */
     latestSelectionScopeRef: RefObject<OwpTreeGridSelectionScope | undefined>;
+    /** 최신 disabled animation 목록 */
     latestDisabledAnimationsRef: RefObject<readonly OwpTreeGridDisabledAnimation[] | undefined>;
+    /** grid에 이미 적용한 layout override */
     appliedLayoutOverridesRef: RefObject<OwpTreeGridLayoutConfig | undefined>;
+    /** grid에 이미 적용한 body data prop */
     appliedBodyDataPropRef: RefObject<OwpTreeGridBodyData<T>>;
+    /** 초기 layout 적용 완료 여부 */
     hasAppliedInitialLayoutRef: RefObject<boolean>;
+    /** 표시 가능한 data row 존재 여부 동기화 callback */
     syncHasDisplayDataRows: (grid: TGrid | null) => void;
+    /** TreeGrid ready 상태 setter */
     setIsTreeGridReady: Dispatch<SetStateAction<boolean>>;
+    /** error tooltip 표시 callback */
     showErrorTooltip: OwpTreeGridErrorTooltipShowHandler;
+    /** error tooltip 숨김 callback */
     hideErrorTooltip: OwpTreeGridErrorTooltipHideHandler;
 };
+/** changed cell highlight 비교를 위한 row/column별 baseline value 저장소 */
 export type TreeGridCellBaselineMap = WeakMap<TRow, Map<string, string>>;
 /**
  * TreeGrid 레이아웃 Enter 동작 명시 여부
@@ -132,12 +167,12 @@ export declare const hasTreeGridDisplayDataRows: (grid: TGrid | null) => boolean
  * TreeGrid Body 데이터 교체 후 재로드
  * @param grid TreeGrid 인스턴스
  * @param bodyData 새 Body 데이터
- * @param onReloadFinish 재로드 완료 콜백
+ * @param onReloadFinish reload 완료 callback
  */
 export declare const replaceTreeGridBodyData: <T>(grid: TGrid, bodyData: OwpTreeGridBodyData<T>, onReloadFinish?: (code: number) => void) => void;
 /**
- * TreeGrid 이벤트 바인딩
- * @param options 이벤트 바인딩 옵션
+ * TreeGrid event binding
+ * @param options event binding option
  */
 export declare const bindTreeGridEvents: <T>({ id, latestEventHandlersRef, layoutHasExplicitEnterModeRef, highlightEditableCellsRef, highlightChangedCellsRef, syncDeletedRowCanEditRef, editableCellBackgroundColorValueRef, changedCellBackgroundColorRef, focusedCellBackgroundColorRef, selectedCellBackgroundColorRef, hoverCellBackgroundColorRef, changedCellBaselineRef, treeGridInstanceRef, treeGridInitStartedAtRef, latestLayoutOverridesRef, latestToolbarTotalCountFormulaRef, latestSuppressCfgRef, latestHideChildHeaderSortButtonsRef, latestSelectionScopeRef, latestDisabledAnimationsRef, appliedLayoutOverridesRef, appliedBodyDataPropRef, hasAppliedInitialLayoutRef, syncHasDisplayDataRows, setIsTreeGridReady, showErrorTooltip, hideErrorTooltip, }: TreeGridEventBindingOptions<T>) => void;
 export {};

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

@@ -1,12 +1,21 @@
+/**
+ * TreeGrid 선택 row 반환 범위
+ */
 export type OwpTreeGridSelectionScope = 'native' | 'panelRowSpan';
+/**
+ * 선택 row 목록 계산 옵션
+ */
 export type OwpTreeGridSelectedRowsResolveOptions = {
+    /** 선택 row 반환 범위 */
     selectionScope?: OwpTreeGridSelectionScope;
+    /** `selectionScope`와 별개로 Panel row span 묶음 row를 포함할지 여부 */
     includePanelRowSpanRows?: boolean;
 };
 /**
- * TreeGrid 선택 행 Panel row span 범위 확장
+ * TreeGrid 선택 row 목록을 Panel row span 범위까지 확장
  * @param grid TreeGrid 인스턴스
  * @param selectedRows TreeGrid 선택 행 목록
  * @param options 선택 행 반환 범위 옵션
+ * @returns 선택 row 목록. `panelRowSpan` 범위에서는 같은 Panel span의 표시 row를 중복 없이 포함
  */
 export declare const resolveTreeGridSelectedRows: <T>(grid: TGrid, selectedRows: Array<TRow & T>, options?: OwpTreeGridSelectedRowsResolveOptions) => (TRow & T)[];

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

@@ -3,22 +3,38 @@ import type { OwpGridThemeConfigType } from '@/types/OwpGridThemeTypes';
 import type { CSSProperties } from 'react';
 type TreeGridThemeCssVariableName = '--owp-tree-grid-body-background-color' | '--owp-tree-grid-body-color' | '--owp-tree-grid-body-fill-background-color' | '--owp-tree-grid-row-background-color' | '--owp-tree-grid-row-solid-background-color' | '--owp-tree-grid-toolbar-row-background-color' | '--owp-tree-grid-header-background-color' | '--owp-tree-grid-header-color' | '--owp-tree-grid-header-font-size' | '--owp-tree-grid-header-font-weight' | '--owp-tree-grid-header-height' | '--owp-tree-grid-cell-font-size' | '--owp-tree-grid-hover-row-background-color' | '--owp-tree-grid-hover-row-border-color' | '--owp-tree-grid-selected-cell-background-color' | '--owp-tree-grid-selected-row-background-color' | '--owp-tree-grid-focused-row-background-color' | '--owp-tree-grid-focused-row-border-color' | '--owp-tree-grid-hover-cell-background-color' | '--owp-tree-grid-hover-cell-border-color' | '--owp-tree-grid-focused-cell-background-color' | '--owp-tree-grid-focused-cell-border-color' | '--owp-tree-grid-editing-cell-border-color' | '--owp-tree-grid-error-cell-border-color' | '--owp-tree-grid-focused-cell-rect-background-color' | '--owp-tree-grid-changed-background-color' | '--owp-tree-grid-changed-text-color' | '--owp-tree-grid-changed-font-weight' | '--owp-tree-grid-added-row-box-color' | '--owp-tree-grid-table-border-radius';
 type TreeGridLayoutDimensionValue = string | number;
+type TreeGridThemeStyleValue = CSSProperties | Record<string, CSSProperties>;
+type TreeGridThemeStyleMap = Record<string, TreeGridThemeStyleValue>;
+/** TreeGrid theme CSS variable을 담는 wrapper inline style */
 export type TreeGridThemeContainerStyle = CSSProperties & Partial<Record<TreeGridThemeCssVariableName, string>>;
+/** TreeGrid theme variable scope wrapper class */
 export declare const TREE_GRID_THEME_WRAPPER_CLASS = "owp-tree-grid-theme";
+/** table radius override scope class */
 export declare const TREE_GRID_THEME_TABLE_RADIUS_CLASS = "owp-tree-grid-table-radius";
+/** panel checkbox select cell marker class */
 export declare const TREE_GRID_PANEL_CHECKBOX_SELECT_CLASS = "owp-tree-grid-panel-checkbox-select";
+/** header panel select-all checked marker class */
 export declare const TREE_GRID_SELECT_ALL_CHECKED_CLASS = "owp-tree-grid-select-all-checked";
+/** header panel select-all indeterminate marker class */
 export declare const TREE_GRID_SELECT_ALL_INDETERMINATE_CLASS = "owp-tree-grid-select-all-indeterminate";
+/** header panel select-all unchecked marker class */
 export declare const TREE_GRID_SELECT_ALL_UNCHECKED_CLASS = "owp-tree-grid-select-all-unchecked";
+/** 선택된 changed cell marker class */
 export declare const TREE_GRID_SELECTED_CHANGED_CELL_CLASS = "owp-tree-grid-selected-changed-cell";
+/** error cell marker class */
 export declare const TREE_GRID_ERROR_CELL_CLASS = "owp-tree-grid-error-cell";
+/** 신규 행 box overlay 대상 cell marker class */
 export declare const TREE_GRID_ADDED_ROW_BOX_CELL_CLASS = "owp-tree-grid-added-row-box-cell";
+/** 신규 행 box overlay 시작 cell marker class */
 export declare const TREE_GRID_ADDED_ROW_BOX_START_CLASS = "owp-tree-grid-added-row-box-start";
+/** 신규 행 box overlay 끝 cell marker class */
 export declare const TREE_GRID_ADDED_ROW_BOX_END_CLASS = "owp-tree-grid-added-row-box-end";
+/** TreeGrid vendor CSS class prefix 목록 */
 export declare const TREE_GRID_STYLE_PREFIXES: readonly ["TS", "TW", "TB", "TM", "TT", "CF", "CL", "CO", "CG", "CB", "CQ", "CE", "CS", "CR", "CP", "CC"];
-export declare const treeGridThemeStyles: Record<string, CSSProperties>;
+/** TreeGrid vendor DOM selector에 주입하는 OWP theme style map */
+export declare const treeGridThemeStyles: TreeGridThemeStyleMap;
 /**
- * TreeGrid theme CSS 변수 컨테이너 스타일 생성
+ * TreeGrid theme CSS variable container style 생성
  * @param input Grid theme 입력값
  */
 export declare const createTreeGridThemeContainerStyle: ({ width, height, treeGridTheme, gridThemeConfig, containerStyle, tableBorderRadius, }: {

package/dist/types/components/OwpTreeGrid/internal/utils/perf.d.ts

@@ -1,3 +1,4 @@
+/** TreeGrid perf 로그를 활성화하는 window flag key */
 export declare const TREE_GRID_PERF_FLAG = "__OWP_TREE_GRID_PERF__";
 /**
  * TreeGrid 성능 계측 활성 여부
@@ -10,20 +11,20 @@ export declare const getTreeGridPerfTimestamp: () => number;
 /**
  * TreeGrid 성능 계측 카운트 로그
  * @param gridId TreeGrid 인스턴스 ID
- * @param label 계측 라벨
+ * @param label 계측 label
  */
 export declare const countTreeGridPerf: (gridId: string, label: string) => void;
 /**
  * TreeGrid 성능 계측 디버그 로그
  * @param gridId TreeGrid 인스턴스 ID
- * @param label 계측 라벨
+ * @param label 계측 label
  * @param payload 부가 정보
  */
 export declare const logTreeGridPerf: (gridId: string, label: string, payload?: Record<string, unknown>) => void;
 /**
  * TreeGrid 성능 계측 측정 로그
  * @param gridId TreeGrid 인스턴스 ID
- * @param label 계측 라벨
+ * @param label 계측 label
  * @param startedAt 시작 시각
  * @param payload 부가 정보
  */

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

@@ -1,12 +1,16 @@
 import { type ButtonProps } from '@mui/material';
+/**
+ * TreeGrid Excel export button props
+ */
 export interface OwpTreeGridExportExcelButtonProps extends ButtonProps {
+    /** Excel로 내보낼 TreeGrid instance id */
     gridId: string;
+    /** 다운로드 파일명. 생략 시 `gridId` 사용 */
     exportName?: string;
 }
 /**
- * TreeGrid 엑셀 내보내기 버튼
- * @param gridId TreeGrid 인스턴스 ID
- * @param exportName 다운로드 파일명
+ * 지정한 TreeGrid instance를 Excel 파일로 다운로드하는 버튼
+ * @param props TreeGrid id, 파일명, MUI Button 표시 속성
  */
 declare const OwpTreeGridExportExcelButton: ({ gridId, exportName, children, loading, loadingPosition, onClick, ...buttonProps }: OwpTreeGridExportExcelButtonProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpTreeGridExportExcelButton };

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

@@ -1,13 +1,17 @@
 import { type ButtonProps } from '@mui/material';
 import { type ReactNode } from 'react';
+/**
+ * TreeGrid 변경 초기화 button props
+ */
 export interface OwpTreeGridResetChangesButtonProps extends ButtonProps {
+    /** 변경 사항을 초기화할 TreeGrid instance id */
     gridId: string;
+    /** confirm dialog title override */
     confirmTitle?: ReactNode | string;
 }
 /**
- * TreeGrid 변경 사항 초기화 버튼
- * @param gridId TreeGrid 인스턴스 ID
- * @param confirmTitle 확인 대화상자 제목
+ * confirm 후 지정한 TreeGrid instance의 변경 상태를 초기화하는 버튼
+ * @param props TreeGrid id, confirm title, MUI Button 표시 속성
  */
 declare const OwpTreeGridResetChangesButton: ({ gridId, confirmTitle, children, onClick, ...buttonProps }: OwpTreeGridResetChangesButtonProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpTreeGridResetChangesButton };

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

@@ -1,16 +1,17 @@
 import { type OwpOptionSelectorProps } from '@/components/OwpOptionSelector';
 import { type ReactNode } from 'react';
+/**
+ * Y/N 고정 option selector props
+ */
 export interface OwpYesNoSelectorProps extends Omit<OwpOptionSelectorProps, 'options'> {
+    /** `Y` option label */
     yesLabel?: ReactNode;
+    /** `N` option label */
     noLabel?: ReactNode;
 }
 /**
- * Y/N 선택 Select
- * @param label 입력 라벨
- * @param helperText 하단 안내 문구
- * @param yesLabel Y 항목 라벨
- * @param noLabel N 항목 라벨
- * @param showAllOption 전체 옵션 노출 여부
+ * `Y`와 `N` 두 값을 고정 option으로 제공하는 selector
+ * @param props Y/N label override와 `OwpOptionSelector` 표시 옵션
  */
 declare const OwpYesNoSelector: ({ yesLabel, noLabel, ...optionSelectorProps }: OwpYesNoSelectorProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpYesNoSelector };

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

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 interface OwpZoomImageSliderProps {
     className?: string;
     imageHeight?: number;
@@ -8,13 +8,13 @@ interface OwpZoomImageSliderProps {
     imageList?: string[];
 }
 /**
- * OwpZoomImageSlider 컴포넌트
- * @param className CSS 클래스명
- * @param imageHeight imageHeight 값
- * @param title 제목
- * @param rightActions rightActions 값
- * @param isScannerPositionRight isScannerPositionRight 값
- * @param imageList imageList 목록
+ * 이미지 목록을 이전/다음으로 이동하며 확대 보기 영역에 표시
+ * @param className root className
+ * @param imageHeight 확대 이미지 영역 높이
+ * @param title header title 영역
+ * @param rightActions header 오른쪽 action 영역
+ * @param isScannerPositionRight scanner overlay 오른쪽 배치 여부
+ * @param imageList 표시할 image URL 목록
  */
 declare const OwpZoomImageSlider: ({ className, imageHeight, title, rightActions, isScannerPositionRight, imageList, }: OwpZoomImageSliderProps) => import("react/jsx-runtime").JSX.Element;
 export { OwpZoomImageSlider };

package/dist/types/configs/defaultConfig.d.ts

@@ -1,6 +1,9 @@
 import type { OwpSettingsConfigType, OwpThemesType } from '@/types/OwpSettingsTypes';
 import { type ThemeOptions } from '@mui/material/styles';
 import { PartialDeep } from 'type-fest';
+/**
+ * OWP snackbar variant별 기본 색상
+ */
 export declare const defaultSnackbarTheme: {
     default: {
         backgroundColor: string;
@@ -34,28 +37,30 @@ export declare function getDefaultLayout(style?: string): OwpSettingsConfigType[
  */
 export declare function getDefaultThemeSettings(themesConfig?: PartialDeep<OwpThemesType>): OwpSettingsConfigType['theme'];
 /**
- * The defaultSettings object defines the default settings for the Owp application.
+ * OWP app 기본 settings
  */
 export declare const defaultSettings: OwpSettingsConfigType;
 /**
- * The getParsedQuerySettings function parses the query string to retrieve the default settings for the Owp application.
- * It returns a OwpSettingsConfigType object that can be used to configure the application.
+ * URL query string의 `defaultSettings` 값을 OWP settings override로 파싱
+ * @returns query 값이 없거나 객체가 아니면 빈 객체
  */
 export declare function getParsedQuerySettings(): {};
 /**
  * 기본 settings와 신규 settings 병합
  * @param _defaultSettings 기준 settings
  * @param _newSettings 신규 settings
+ * @returns layout style 변경 시 layout config 기본값을 재계산한 settings
  */
 export declare function generateSettings(_defaultSettings: OwpSettingsConfigType, _newSettings: PartialDeep<OwpSettingsConfigType>): OwpSettingsConfigType;
 /**
  * 앱 초기 settings 생성
  * @param settingsConfig 앱 settings override
  * @param themesConfig 앱 theme 설정
+ * @returns default settings, theme config, query override를 병합한 초기 settings
  */
 export declare function createInitialOwpSettings(settingsConfig?: PartialDeep<OwpSettingsConfigType>, themesConfig?: PartialDeep<OwpThemesType>): OwpSettingsConfigType;
 /**
- * The defaultThemeOptions object defines the default options for the MUI theme.
+ * OWP MUI theme 기본 component 옵션
  */
 export declare const defaultThemeOptions: {
     typography: {
@@ -438,7 +443,7 @@ export declare const defaultThemeOptions: {
     };
 };
 /**
- * The mustHaveThemeOptions object defines the options that must be present in the MUI theme.
+ * OWP MUI theme에 항상 포함할 필수 옵션
  */
 export declare const mustHaveThemeOptions: {
     typography: {
@@ -453,7 +458,7 @@ export declare const mustHaveThemeOptions: {
     };
 };
 /**
- * The defaultThemes object defines the default themes for the application.
+ * OWP 기본 theme preset map
  */
 export declare const defaultThemes: {
     default: {
@@ -550,7 +555,8 @@ export declare const defaultThemes: {
     };
 };
 /**
- * The extendThemeWithMixins function extends the theme with mixins.
+ * MUI theme 기준 border mixin set 생성
+ * @param obj MUI theme options
  */
 export declare function extendThemeWithMixins(obj: ThemeOptions): {
     border: (width?: number) => {

package/dist/types/configs/layoutConfig.d.ts

@@ -96,5 +96,6 @@ declare const LayoutConfig: {
         };
     };
 };
+/** LayoutConfig.defaults에서 파생한 기본 layout 설정 타입 */
 export type LayoutConfigDefaultsType = (typeof LayoutConfig)['defaults'];
 export default LayoutConfig;

package/dist/types/constants/excel.d.ts

@@ -3,10 +3,28 @@ type ExcelCellFont = ExcelJS.Cell['font'];
 type ExcelCellAlignment = ExcelJS.Cell['alignment'];
 type ExcelCellFill = ExcelJS.Cell['fill'];
 type ExcelCellBorder = ExcelJS.Cell['border'];
+/**
+ * Excel cell 기본 가운데 정렬
+ */
 export declare const DEFAULT_CELL_ALIGNMENT: ExcelCellAlignment;
+/**
+ * Excel cell 기본 줄바꿈 가운데 정렬
+ */
 export declare const DEFAULT_WRAP_CELL_ALIGNMENT: ExcelCellAlignment;
+/**
+ * Excel header cell 기본 font
+ */
 export declare const DEFAULT_HEADER_FONT: ExcelCellFont;
+/**
+ * Excel value cell 기본 font
+ */
 export declare const DEFAULT_VALUE_FONT: ExcelCellFont;
+/**
+ * Excel cell 기본 thin border
+ */
 export declare const DEFAULT_THIN_BORDER: ExcelCellBorder;
+/**
+ * Excel header cell 기본 fill
+ */
 export declare const DEFAULT_HEADER_FILL: ExcelCellFill;
 export {};

package/dist/types/constants/gridTheme.d.ts

@@ -1,5 +1,7 @@
 import type { OwpGridThemeConfigType } from '@/types/OwpGridThemeTypes';
+/** Grid theme option과 기본값을 모두 병합한 resolved token 구조 */
 export type OwpResolvedGridThemeConfigType = {
+    /** TreeGrid header 영역 색상/typography/height */
     header: {
         backgroundColor: string;
         color: string;
@@ -7,18 +9,22 @@ export type OwpResolvedGridThemeConfigType = {
         fontWeight: number | string;
         height: number | string;
     };
+    /** TreeGrid body surface 색상 */
     body: {
         backgroundColor: string;
         color: string;
         fillBackgroundColor: string;
     };
+    /** TreeGrid row 기본 배경 token */
     row: {
         backgroundColor: string;
         solidBackgroundColor: string;
     };
+    /** TreeGrid cell typography token */
     cell: {
         fontSize: number | string;
     };
+    /** hover/selected/focused/editing/error 상태별 cell/row token */
     state: {
         hoverRowBackgroundColor: string;
         hoverRowBorderColor: string;
@@ -34,15 +40,18 @@ export type OwpResolvedGridThemeConfigType = {
         errorCellBorderColor: string;
         focusedCellRectBackgroundColor: string;
     };
+    /** editable cell 표시 token */
     editable: {
         backgroundColor: string;
     };
+    /** changed cell highlight token */
     changed: {
         backgroundColor: string;
         color: string;
         fontWeight: number | string;
     };
 };
+/** OWP Grid theme 기본 resolved token */
 export declare const defaultOwpGridTheme: {
     header: {
         backgroundColor: string;
@@ -88,7 +97,7 @@ export declare const defaultOwpGridTheme: {
     };
 };
 /**
- * Grid theme 토큰 기본값 병합
+ * Grid theme token 기본값 병합
  * @param gridTheme 앱 theme grid 설정
  */
 export declare const resolveOwpGridTheme: (gridTheme?: OwpGridThemeConfigType | null) => OwpResolvedGridThemeConfigType;

package/dist/types/constants/language.d.ts

@@ -1 +1,4 @@
+/**
+ * OWP language fallback 우선순위
+ */
 export declare const FALLBACK_LANGUAGE_LIST: string[];

package/dist/types/constants/localStorageKeys.d.ts

@@ -1,9 +1,15 @@
 /**
- * 로컬 스토리지 키 목록
+ * 인증과 언어 설정에 사용하는 localStorage key map
  */
 export declare const LOCAL_STORAGE_KEYS: {
     readonly accessToken: "jwt_access_token";
     readonly currentLanguage: "CurrentLanguage";
 };
+/**
+ * JWT access token localStorage key
+ */
 export declare const STORAGE_ACCESS_TOKEN_KEY: "jwt_access_token";
+/**
+ * 현재 language localStorage key
+ */
 export declare const CURRENT_LANGUAGE: "CurrentLanguage";

package/dist/types/constants/storageKeys.d.ts

@@ -1,5 +1,5 @@
 /**
- * 스토리지 키 목록
+ * OWP state persistence에 사용하는 storage key map
  */
 export declare const STORAGE_KEYS: {
     readonly commonCodeList: "commonCodeList";

package/dist/types/constants/table.d.ts

@@ -1 +1,4 @@
+/**
+ * OWP table 기본 border radius
+ */
 export declare const DEFAULT_TABLE_RADIUS = "0.5rem";

package/dist/types/constants/tableTheme.d.ts

@@ -1,20 +1,24 @@
 import type { OwpTableVariantThemeConfigType } from '@/types/OwpTableThemeTypes';
+/** Table theme option과 fallback을 모두 병합한 resolved token 구조 */
 export type OwpResolvedTableThemeConfigType = {
+    /** table border color */
     borderColor: string;
+    /** header cell 색상/typography token */
     header: {
         backgroundColor: string;
         color: string;
         fontSize: number | string;
         fontWeight: number | string;
     };
+    /** body cell 색상/typography token */
     cell: {
         backgroundColor?: string;
         fontSize: number | string;
     };
 };
 /**
- * Table theme 토큰 기본값 병합
+ * Table theme token 기본값 병합
  * @param tableTheme 앱 theme table 설정
- * @param fallbackTheme 컴포넌트 기본값
+ * @param fallbackTheme 기본 resolved table theme
  */
 export declare const resolveOwpTableTheme: (tableTheme: OwpTableVariantThemeConfigType | null | undefined, fallbackTheme: OwpResolvedTableThemeConfigType) => OwpResolvedTableThemeConfigType;

package/dist/types/constants/treeGrid.d.ts

@@ -1,25 +1,41 @@
+/** TreeGrid warning cell 표시 색상 */
 export declare const TREEGRID_WARNING_CELL_COLOR = "#f44336";
+/** TreeGrid 입력 가능 cell 표시 색상 */
 export declare const TREEGRID_INPUT_CELL_COLOR = "#ffe0b2";
+/** TreeGrid 신규 행 배경색 */
 export declare const TREEGRID_ADDED_ROW_BACKGROUND_COLOR = "#D7FFD7";
+/** TreeGrid error cell border 색상 */
 export declare const TREEGRID_ERROR_CELL_BORDER_COLOR = "#c00000";
+/** TreeGrid 변경 cell className */
 export declare const TREEGRID_CELL_CHANGED_CLASS = "OwpTreeGridChangedCell";
+/** TreeGrid highlight cell 배경색 */
 export declare const TREEGRID_CELL_HIGHLIGHT_COLOR = "#ffa726";
+/** TreeGrid highlight cell 텍스트 색상 */
 export declare const TREEGRID_CELL_HIGHLIGHT_TEXT_COLOR = "#ffffff";
+/** TreeGrid highlight cell font weight */
 export declare const TREEGRID_CELL_HIGHLIGHT_FONT_WEIGHT = 600;
+/** TreeGrid font face family name */
 export declare const TREEGRID_FONT_FAMILY = "RobotoLight";
+/** TreeGrid wrapper font family stack */
 export declare const TREEGRID_FONT_FAMILY_STACK: string;
 /** TreeGrid 자산 base path 조회 */
 export declare const getTreeGridAssetBasePath: () => string;
-/** TreeGrid 자산 URL 생성 */
+/**
+ * TreeGrid 자산 URL 생성
+ * @param assetPath base path 아래 자산 경로
+ */
 export declare const resolveTreeGridAssetUrl: (assetPath: string) => string;
-/** TreeGrid 다국어 리소스 URL 조회 */
+/**
+ * TreeGrid i18n resource URL 조회
+ * @param languageId OWP language id
+ */
 export declare const getTreeGridTextResourceUrl: (languageId: string) => string;
 /**
  * TreeGrid 색상 문자열 숫자 변환
  * @param color CSS 색상 문자열
  */
 export declare const resolveTreeGridColorNumber: (color?: string | null) => number;
-/** TreeGrid 폰트 face 스타일 조회 */
+/** TreeGrid font-face global style 객체 조회 */
 export declare const getTreeGridFontFaceStyles: () => {
     '@font-face': Record<string, string>;
 };