@owp/core 2.5.27 → 2.5.29

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

@@ -9,6 +9,21 @@ export declare const mergeSx: (...styles: Array<SxProps<Theme> | undefined | fal
  * @param value radius 값
  */
 export declare const toTableRadiusCssValue: (value: number | string) => string;
+/**
+ * table row helper text 콘텐츠 높이 보정 sx
+ * @param contentSelector 셀 콘텐츠 selector
+ */
+export declare const getTableHelperTextContentSx: (contentSelector: string) => {
+    readonly [x: string]: {
+        readonly content: "\"\"";
+        readonly display: "block";
+        readonly height: "calc(0.75rem * 1.66 + 3px)";
+    } | {
+        readonly display: "none";
+        readonly content?: undefined;
+        readonly height?: undefined;
+    };
+};
 /**
  * table row helper text 높이 보정 sx
  * @param contentClassName 셀 콘텐츠 className

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

@@ -15,6 +15,8 @@ export type OwpTreeGridData<T> = OwpTreeGridBodyData<T>;
 export type TData<T> = OwpTreeGridBodyData<T>;
 export type OwpTreeGridRowModel<T> = TRow & T;
 export type OwpTreeGridSelectedRows<T> = OwpTreeGridRowModel<T>[];
+export type OwpTreeGridSuppressCfg = 0 | 1 | 2 | 3 | 4;
+export type OwpTreeGridDisabledAnimation = 'addRow' | 'deleteRow' | 'selectRow';
 export interface OwpTreeGridDatePickerEditorColumnOption {
     baseYear?: string;
     baseYearMonth?: string;
@@ -45,6 +47,7 @@ export interface OwpTreeGridProps<T> {
     toolbarRowBackgroundColor?: CSSProperties['backgroundColor'];
     layoutUrl?: string;
     layoutData?: string;
+    disabledAnimations?: readonly OwpTreeGridDisabledAnimation[];
     dataUrl?: string;
     layoutOverrides?: OwpTreeGridLayoutConfig;
     data?: OwpTreeGridBodyData<T>;
@@ -53,6 +56,9 @@ export interface OwpTreeGridProps<T> {
     width?: string | number;
     canUseTableRadius?: boolean;
     tableBorderRadius?: string | number;
+    suppressCfg?: OwpTreeGridSuppressCfg;
+    showToolbarTotalCount?: boolean;
+    hideChildHeaderSortButtons?: boolean;
     useDataUrl?: boolean;
     onSelect?: OwpTreeGridSelectHandler<T>;
     onRowAdd?: OwpTreeGridRowAddHandler<T>;
@@ -83,6 +89,10 @@ export interface OwpTreeGridProps<T> {
  * @param height height 값
  * @param canUseTableRadius TreeGrid 내부 테이블 radius 사용 여부
  * @param tableBorderRadius TreeGrid 내부 테이블 radius 값
+ * @param suppressCfg TreeGrid client 설정 저장/로드 억제값
+ * @param showToolbarTotalCount Toolbar 전체 건수 기본 formula 표시 여부
+ * @param hideChildHeaderSortButtons 그룹 헤더 하위 sort 버튼 숨김 여부
+ * @param disabledAnimations 비활성화할 TreeGrid 애니메이션 의미 키 목록
  */
-declare const OwpTreeGrid: <T>({ id, containerStyle, containerClassName, toolbarRowBackgroundColor, className, style, height, width, canUseTableRadius, tableBorderRadius, layoutUrl, layoutData, 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;
+declare const OwpTreeGrid: <T>({ id, containerStyle, containerClassName, toolbarRowBackgroundColor, className, style, height, width, canUseTableRadius, tableBorderRadius, suppressCfg, showToolbarTotalCount, hideChildHeaderSortButtons, 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/internal/hooks/useOwpTreeGridDatePickerEditor.d.ts

@@ -1,17 +1,20 @@
 import { type RefObject } from 'react';
 import type { OwpTreeGridDatePickerEditorConfig, OwpTreeGridRowModel } from '../../OwpTreeGrid';
+type OwpTreeGridDatePickerEditorValueChangeOptions = {
+    highlightRefresh?: boolean;
+};
 interface UseOwpTreeGridDatePickerEditorParams<T> {
     config?: OwpTreeGridDatePickerEditorConfig;
     treeGridInstanceRef: RefObject<TGrid>;
     isTreeGridReady: boolean;
-    onValueChange?: (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string, value: string) => void;
+    onValueChange?: (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string, value: string, options?: OwpTreeGridDatePickerEditorValueChangeOptions) => void;
 }
 /** OwpTreeGrid Date 셀 React DatePicker editor */
 export declare const useOwpTreeGridDatePickerEditor: <T>({ config, treeGridInstanceRef, isTreeGridReady, onValueChange, }: UseOwpTreeGridDatePickerEditorParams<T>) => {
     datePickerEditorElement: import("react/jsx-runtime").JSX.Element;
     handleDatePickerEditorButtonClick: (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string, event: Event) => 1;
     handleDatePickerEditorCellClick: (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string, _x: number, _y: number, event: Event) => 1;
-    handleDatePickerEditorKeyDown: (grid: TGrid, key: string, event: Event) => 1;
+    handleDatePickerEditorKeyDown: (grid: TGrid, key: string, event: Event, name?: string) => 1;
     handleDatePickerEditorStartEdit: (grid: TGrid, row: OwpTreeGridRowModel<T>, col: string) => true;
 };
 export {};

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

@@ -1,10 +1,13 @@
 import { type Dispatch, type RefObject, type SetStateAction } from 'react';
-import type { OwpTreeGridBodyData, OwpTreeGridLayoutConfig, OwpTreeGridProps, OwpTreeGridRowModel } from '../OwpTreeGrid';
+import type { OwpTreeGridBodyData, OwpTreeGridDisabledAnimation, OwpTreeGridLayoutConfig, OwpTreeGridProps, OwpTreeGridRowModel, OwpTreeGridSuppressCfg } from '../OwpTreeGrid';
 export declare const TREE_GRID_BINDING_LOADING_MIN_VISIBLE_MS = 300;
 type TreeGridInitializationInput<T> = {
     id: string;
     layoutUrl?: string;
     layoutData?: string;
+    toolbarTotalCountFormula?: string;
+    suppressCfg?: OwpTreeGridSuppressCfg;
+    disabledAnimations?: readonly OwpTreeGridDisabledAnimation[];
     dataUrl?: string;
     bodyData: OwpTreeGridBodyData<T>;
     useDataUrl?: boolean;
@@ -33,12 +36,17 @@ export type TreeGridEventBindingOptions<T> = Pick<OwpTreeGridProps<T>, 'id'> & {
     syncDeletedRowCanEditRef: RefObject<boolean>;
     editableCellBackgroundColorValueRef: RefObject<number | undefined>;
     changedCellBackgroundColorRef: RefObject<string>;
+    focusedCellBackgroundColorRef: RefObject<string>;
     selectedCellBackgroundColorRef: RefObject<string>;
     hoverCellBackgroundColorRef: RefObject<string>;
     changedCellBaselineRef: RefObject<TreeGridCellBaselineMap>;
     treeGridInstanceRef: RefObject<TGrid>;
     treeGridInitStartedAtRef: RefObject<number | null>;
     latestLayoutOverridesRef: RefObject<OwpTreeGridLayoutConfig | undefined>;
+    latestToolbarTotalCountFormulaRef: RefObject<string | undefined>;
+    latestSuppressCfgRef: RefObject<OwpTreeGridSuppressCfg | undefined>;
+    latestHideChildHeaderSortButtonsRef: RefObject<boolean>;
+    latestDisabledAnimationsRef: RefObject<readonly OwpTreeGridDisabledAnimation[] | undefined>;
     appliedLayoutOverridesRef: RefObject<OwpTreeGridLayoutConfig | undefined>;
     appliedBodyDataPropRef: RefObject<OwpTreeGridBodyData<T>>;
     hasAppliedInitialLayoutRef: RefObject<boolean>;
@@ -55,7 +63,7 @@ export declare const hasTreeGridExplicitEnterMode: (layoutData?: string) => bool
  * TreeGrid 초기화 옵션 생성
  * @param input 초기화 입력값
  */
-export declare const buildTreeGridInitializationOptions: <T>({ id, layoutUrl, layoutData, dataUrl, bodyData, useDataUrl, width, height, languageId, }: TreeGridInitializationInput<T>) => {
+export declare const buildTreeGridInitializationOptions: <T>({ id, layoutUrl, layoutData, toolbarTotalCountFormula, suppressCfg, disabledAnimations, dataUrl, bodyData, useDataUrl, width, height, languageId, }: TreeGridInitializationInput<T>) => {
     id: string;
     Layout: {
         Data: string;
@@ -99,14 +107,16 @@ export declare const captureTreeGridChangeBaselines: (grid: TGrid | null | undef
  * @param col 대상 컬럼
  * @param backgroundColor 변경 하이라이트 배경색
  * @param baselineMap 셀 기준값 저장소
+ * @param highlightRefresh 하이라이트 적용 후 셀 refresh 여부
  */
-export declare const syncTreeGridChangedCellHighlight: ({ gridId, grid, row, col, backgroundColor, baselineMap, }: {
+export declare const syncTreeGridChangedCellHighlight: ({ gridId, grid, row, col, backgroundColor, baselineMap, highlightRefresh, }: {
     gridId: string;
     grid: TGrid;
     row: TRow;
     col: string;
     backgroundColor: string;
     baselineMap: TreeGridCellBaselineMap;
+    highlightRefresh?: boolean;
 }) => void;
 /**
  * TreeGrid 표시 데이터 행 존재 여부
@@ -124,5 +134,5 @@ export declare const replaceTreeGridBodyData: <T>(grid: TGrid, bodyData: OwpTree
  * TreeGrid 이벤트 바인딩
  * @param options 이벤트 바인딩 옵션
  */
-export declare const bindTreeGridEvents: <T>({ id, latestEventHandlersRef, layoutHasExplicitEnterModeRef, highlightEditableCellsRef, highlightChangedCellsRef, syncDeletedRowCanEditRef, editableCellBackgroundColorValueRef, changedCellBackgroundColorRef, selectedCellBackgroundColorRef, hoverCellBackgroundColorRef, changedCellBaselineRef, treeGridInstanceRef, treeGridInitStartedAtRef, latestLayoutOverridesRef, appliedLayoutOverridesRef, appliedBodyDataPropRef, hasAppliedInitialLayoutRef, syncHasDisplayDataRows, setIsTreeGridReady, }: TreeGridEventBindingOptions<T>) => void;
+export declare const bindTreeGridEvents: <T>({ id, latestEventHandlersRef, layoutHasExplicitEnterModeRef, highlightEditableCellsRef, highlightChangedCellsRef, syncDeletedRowCanEditRef, editableCellBackgroundColorValueRef, changedCellBackgroundColorRef, focusedCellBackgroundColorRef, selectedCellBackgroundColorRef, hoverCellBackgroundColorRef, changedCellBaselineRef, treeGridInstanceRef, treeGridInitStartedAtRef, latestLayoutOverridesRef, latestToolbarTotalCountFormulaRef, latestSuppressCfgRef, latestHideChildHeaderSortButtonsRef, latestDisabledAnimationsRef, appliedLayoutOverridesRef, appliedBodyDataPropRef, hasAppliedInitialLayoutRef, syncHasDisplayDataRows, setIsTreeGridReady, }: TreeGridEventBindingOptions<T>) => void;
 export {};

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

@@ -10,6 +10,7 @@ export declare const TREE_GRID_PANEL_CHECKBOX_SELECT_CLASS = "owp-tree-grid-pane
 export declare const TREE_GRID_SELECT_ALL_CHECKED_CLASS = "owp-tree-grid-select-all-checked";
 export declare const TREE_GRID_SELECT_ALL_INDETERMINATE_CLASS = "owp-tree-grid-select-all-indeterminate";
 export declare const TREE_GRID_SELECT_ALL_UNCHECKED_CLASS = "owp-tree-grid-select-all-unchecked";
+export declare const TREE_GRID_SELECTED_CHANGED_CELL_CLASS = "owp-tree-grid-selected-changed-cell";
 export declare const treeGridThemeStyles: Record<string, CSSProperties>;
 /**
  * TreeGrid theme CSS 변수 컨테이너 스타일 생성

package/dist/types/index.d.ts

@@ -15,7 +15,6 @@ export * from './components/OwpFieldHelperText';
 export * from './components/OwpFilePickerButton/OwpFilePickerButton';
 export * from './components/OwpLayout';
 export * from './components/OwpLoading';
-export * from './components/OwpMrtTable';
 export * from './components/OwpMoreActionsButton/OwpMoreActionsButton';
 export * from './components/OwpNumberField';
 export * from './components/OwpOptionSelector';

package/dist/types/utils/treeGridUtil.d.ts

@@ -7,6 +7,7 @@ type TreeGridAddRowOptions<T> = {
     parent?: TRow & T;
     anchorRow?: TRow & T;
     initialValues?: T;
+    editableColumns?: readonly string[];
 };
 type TreeGridColumnVisibilityOptions = {
     targetKey: string;
@@ -16,6 +17,7 @@ type TreeGridHighlightTargetOption = {
     row: TRow;
     col: string;
     backgroundColor?: string;
+    refresh?: boolean;
 };
 /**
  * addTreeGridRowById 생성 행 여부
@@ -82,6 +84,7 @@ export declare const reloadTreeGridBodyById: (gridId: string, rows: unknown) =>
  * @param options.anchorRow above/below용 기준 행
  * @param options.insertPosition 행 삽입 위치
  * @param options.initialValues 신규 행 초기값
+ * @param options.editableColumns 신규 행 셀 단위 편집 가능 컬럼
  */
 export declare const addTreeGridRowById: <T>(gridId: string, options?: TreeGridAddRowOptions<T>) => void;
 /**
@@ -115,6 +118,7 @@ export declare const setTreeGridColumnVisibilityById: (gridId: string, options:
  * @param gridId TreeGrid 인스턴스 ID
  * @param targetOption.row 강조할 대상 행
  * @param targetOption.col 강조할 대상 컬럼
+ * @param targetOption.refresh 강조 적용 후 셀 refresh 여부
  */
 export declare const highlightTreeGridCellById: (gridId: string, targetOption: TreeGridHighlightTargetOption) => void;
 /**