@owp/core 1.5.1 → 1.6.0

package/dist/types/components/OwpCommonCode/OwpCommonCodeRadioGroup.d.ts

@@ -0,0 +1,16 @@
+import { CommonCode } from '@/utils/CommonCodeUtils';
+import { FormControlProps, RadioGroupProps } from '@mui/material';
+export type OwpCommonCodeRadioGroupProps = FormControlProps & RadioGroupProps & {
+    codeId: string;
+    description?: string;
+    useValueKeyDescription?: boolean;
+    label?: string;
+    helperText?: string;
+    filterOptions?: (commonCode: CommonCode) => boolean;
+};
+/**
+ * 공통코드 목록을 기반으로 라디오 그룹을 렌더링합니다.
+ * @param props 공통코드 라디오 그룹 props
+ */
+export declare const OwpCommonCodeRadioGroup: ({ codeId, description, label, fullWidth, defaultValue, useValueKeyDescription, required, error, helperText, filterOptions, ...commonCodeProps }: OwpCommonCodeRadioGroupProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommonCodeRadioGroup: ({ codeId, description, label, fullWidth, defaultValue, useValueKeyDescription, required, error, helperText, filterOptions, ...commonCodeProps }: OwpCommonCodeRadioGroupProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/components/OwpCommonCode/OwpCommonCodeSelector.d.ts

@@ -0,0 +1,16 @@
+import { CommonCode } from '@/utils/CommonCodeUtils';
+import { SelectProps } from '@mui/material';
+export type OwpCommonCodeSelectorProps = SelectProps<string> & {
+    codeId: string;
+    description?: string;
+    useValueKeyDescription?: boolean;
+    disableAllValueItem?: boolean;
+    helperText?: string;
+    filterOptions?: (commonCode: CommonCode) => boolean;
+};
+/**
+ * 공통코드 목록을 기반으로 단일/다중 선택 Select를 제공합니다.
+ * @param props 공통코드 선택기 props
+ */
+export declare const OwpCommonCodeSelector: (props: OwpCommonCodeSelectorProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommonCodeSelector: (props: OwpCommonCodeSelectorProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/components/OwpCommonCode/index.d.ts

@@ -0,0 +1,4 @@
+export { OwpCommonCodeSelector, CommonCodeSelector } from './OwpCommonCodeSelector';
+export type { OwpCommonCodeSelectorProps } from './OwpCommonCodeSelector';
+export { OwpCommonCodeRadioGroup, CommonCodeRadioGroup } from './OwpCommonCodeRadioGroup';
+export type { OwpCommonCodeRadioGroupProps } from './OwpCommonCodeRadioGroup';

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

@@ -1,10 +1,11 @@
 import { LoadingButtonProps } from '@mui/lab/LoadingButton';
-import { ChangeEvent } from 'react';
-interface OwpFileUploadButtonProps {
+import { type ChangeEvent, type ReactNode } from 'react';
+export interface OwpFileUploadButtonOwnProps {
     multiple?: boolean;
     accept?: string;
-    title?: string;
+    title?: ReactNode;
     onChange?: (evt: ChangeEvent<HTMLInputElement>) => void;
+    onCancel?: (evt: Event) => void;
 }
-export declare function OwpFileUploadButton({ title, multiple, onChange, accept, ...restProps }: OwpFileUploadButtonProps & LoadingButtonProps): import("react/jsx-runtime").JSX.Element;
-export {};
+export type OwpFileUploadButtonProps = OwpFileUploadButtonOwnProps & Omit<LoadingButtonProps, 'title'>;
+export declare function OwpFileUploadButton({ title, multiple, onChange, onCancel, accept, ...restProps }: OwpFileUploadButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,14 +1,13 @@
 import type { IconButtonProps } from '@mui/material/IconButton';
 import type { SxProps, Theme } from '@mui/material/styles';
 import type { ReactNode } from 'react';
+import { exportTreeGridToExcelById } from '../../utils/treeGridUtil';
+import { type OwpFileUploadButtonProps } from '../OwpFileUploadButton/OwpFileUploadButton';
 export type OwpMoreButtonActionColor = NonNullable<IconButtonProps['color']> | string;
-export type OwpMoreButtonAction = {
+type OwpMoreButtonActionBase = {
     icon?: ReactNode;
     color?: OwpMoreButtonActionColor;
-    label: ReactNode;
-    onClick: (args: {
-        close: () => void;
-    }) => void;
+    label?: ReactNode;
     labelProps?: {
         className?: string;
         sx?: SxProps<Theme>;
@@ -18,6 +17,24 @@ export type OwpMoreButtonAction = {
         sx?: SxProps<Theme>;
     };
 };
+export type OwpMoreButtonClickAction = OwpMoreButtonActionBase & {
+    type?: 'button';
+    onClick: (args: {
+        close: () => void;
+    }) => void;
+};
+export type OwpMoreButtonFileUploadAction = OwpMoreButtonActionBase & {
+    type: 'fileUpload';
+    fileUploadProps?: Omit<OwpFileUploadButtonProps, 'title' | 'onChange' | 'onCancel'> & {
+        onChange?: OwpFileUploadButtonProps['onChange'];
+        onCancel?: OwpFileUploadButtonProps['onCancel'];
+    };
+};
+export type OwpMoreButtonTreeGridExportExcelAction = OwpMoreButtonActionBase & {
+    type: 'treeGridExportExcel';
+    exportExcelArgs: Parameters<typeof exportTreeGridToExcelById>;
+};
+export type OwpMoreButtonAction = OwpMoreButtonClickAction | OwpMoreButtonFileUploadAction | OwpMoreButtonTreeGridExportExcelAction;
 export type OwpMoreActionsButtonProps = {
     actions: OwpMoreButtonAction[];
     open?: boolean;
@@ -29,3 +46,4 @@ export type OwpMoreActionsButtonProps = {
     actionsSx?: SxProps<Theme>;
 };
 export declare const OwpMoreActionsButton: ({ actions, open: openProp, defaultOpen, onOpenChange, disabled, className, containerSx, actionsSx, }: OwpMoreActionsButtonProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/default-settings/OwpDefaultSettings.d.ts

@@ -382,10 +382,17 @@ export declare const defaultThemeOptions: {
                     fontSize: string;
                     transform: string;
                     '&.Mui-focused': {};
-                    '&.MuiInputLabel-shrink': {
-                        backgroundColor: string;
-                        padding: string;
+                    '&.MuiInputLabel-outlined.MuiInputLabel-shrink': {
                         lineHeight: number;
+                        zIndex: number;
+                        '&::before': {
+                            content: string;
+                            position: string;
+                            inset: string;
+                            backgroundColor: string;
+                            borderRadius: number;
+                            zIndex: number;
+                        };
                     };
                 };
             };
@@ -502,9 +509,13 @@ export declare const defaultThemeOptions: {
         MuiFormControl: {
             styleOverrides: {
                 root: {
-                    '& .MuiInputLabel-shrink + .MuiInputBase-root .MuiOutlinedInput-notchedOutline legend': {
+                    '& .MuiInputLabel-outlined.MuiInputLabel-shrink:not(:empty) + .MuiOutlinedInput-root .MuiOutlinedInput-notchedOutline legend': {
+                        fontSize: string;
                         maxWidth: string;
-                        padding: string;
+                    };
+                    '& .MuiInputLabel-outlined.MuiInputLabel-shrink:not(:empty) + .MuiOutlinedInput-root .MuiOutlinedInput-notchedOutline legend > span:not(.notranslate)': {
+                        paddingLeft: string;
+                        paddingRight: string;
                     };
                 };
             };

package/dist/types/index.d.ts

@@ -22,6 +22,7 @@ export * from './utils/barcodeUtil';
 export * from './utils/CommonCodeUtils';
 export * from './utils/ErrorBoundary';
 export * from './utils/excelUtil';
+export * from './utils/getFormDefaultValues';
 export * from './utils/OwpUtils';
 export * from './utils/qrCodeUtil';
 export * from './utils/treeGridExportExcelUtil';
@@ -35,6 +36,7 @@ export * from './components/OwpBarcodeInput/OwpBarcodeInputField';
 export * from './components/OwpButtonDelete';
 export * from './components/OwpButtonSave';
 export * from './components/OwpCommonDialog';
+export * from './components/OwpCommonCode';
 export * from './components/OwpDialog';
 export * from './components/OwpExportExcelButton/OwpExportExcelButton';
 export * from './components/OwpFileUploadButton/OwpFileUploadButton';

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

@@ -11,7 +11,17 @@ export interface CommonCode {
 export interface CommonCodeRes {
     resultData?: Array<CommonCode>;
 }
-export declare const transformGridEnumByCommonCodeList: (commonCodeListData?: Array<CommonCode> | undefined, fieldKey?: string) => {
-    [x: string]: string;
-};
+type TreeGridEnumAttributeMap = Record<string, string>;
+/**
+ * 공통코드 목록을 TreeGrid Enum 속성 객체로 변환합니다.
+ * @param commonCodeListData 공통코드 목록
+ * @param fieldKey TreeGrid 컬럼 필드 키
+ */
+export declare const transformGridEnumByCommonCodeList: (commonCodeListData?: Array<CommonCode> | undefined, fieldKey?: string) => TreeGridEnumAttributeMap;
+/**
+ * 공통코드 목록을 그룹 ID 기준으로 묶습니다.
+ * @param commonCodeList 공통코드 목록
+ */
 export declare const transformCommonCodeBasedOnGroupId: (commonCodeList: Array<CommonCode>) => Record<string, CommonCode[]>;
+export declare const buildTreeGridEnumAttributesByCommonCodeList: (commonCodeListData?: Array<CommonCode> | undefined, fieldKey?: string) => TreeGridEnumAttributeMap;
+export {};

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

@@ -0,0 +1,6 @@
+/**
+ * 초기값 객체에서 폼 기본값 키와 일치하는 값만 추려 병합합니다.
+ * @param defaultValues 폼 기본값
+ * @param initialValues 서버/외부에서 전달된 초기값
+ */
+export declare const getFormDefaultValues: <T extends Record<string, unknown>>(defaultValues: T, initialValues?: object) => T;

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

@@ -1,36 +1,127 @@
+type TreeGridInsertPosition = 'above' | 'below' | 'top' | 'last';
+type TreeGridAddRowOptions<T> = {
+    canSelect?: boolean;
+    insertPosition?: TreeGridInsertPosition;
+    parent?: TRow & T;
+    anchorRow?: TRow & T;
+    initialValues?: T;
+};
+type TreeGridColumnVisibilityOptions = {
+    targetKey: string;
+    canVisible: boolean;
+};
+type TreeGridHighlightTargetOption = {
+    row: TRow;
+    col: string;
+};
 export declare const TREEGRID_WARNING_CELL_COLOR = "#f44336";
 export declare const TREEGRID_INPUT_CELL_COLOR = "#ffd6a8";
 export declare const TREEGRID_CELL_HIGHLIGHT_CLASS = "text-white text-xl font-semibold";
 export declare const TREEGRID_CELL_HIGHLIGHT_COLOR = "#ff8904";
+/**
+ * TreeGrid 인스턴스를 ID로 조회합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ */
 export declare const getGridById: (gridId: string) => TTGrid;
-export declare const getDataRowsById: <T>(gridId: string) => any[] | T;
-export declare const reloadBodyById: (gridId: string, rows: any) => void;
+/**
+ * TreeGrid의 데이터 행 목록을 조회합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ */
+export declare const getDataRowsById: <T>(gridId: string) => T;
+/**
+ * TreeGrid Body 데이터를 교체한 뒤 다시 로드합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ * @param rows 새로 반영할 행 데이터
+ */
+export declare const reloadBodyById: (gridId: string, rows: unknown) => void;
 /**
  * 행을 특정 위치에 추가
  * @param gridId TreeGrid 인스턴스 ID
- * @param options.canSelect 행 삽입 위치
- * @param options.parent
- * @param options.anchorRow above/below용 기준 row
+ * @param options.canSelect 행 선택 가능 여부
+ * @param options.parent 부모 행
+ * @param options.anchorRow above/below용 기준 행
  * @param options.insertPosition 행 삽입 위치
  * @param options.initialValues 신규 행 초기값
  */
-export declare const addRowById: <T>(gridId: string, options?: {
-    canSelect?: boolean;
-    insertPosition?: "above" | "below" | "top" | "last";
-    parent?: TRow & T;
-    anchorRow?: TRow & T;
-    initialValues?: T;
-}) => void;
+export declare const addRowById: <T>(gridId: string, options?: TreeGridAddRowOptions<T>) => void;
+/**
+ * TreeGrid의 추가/수정된 데이터 행을 조회합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ */
 export declare const getChangedDataRowsById: <T>(gridId: string) => {
-    [k: string]: Partial<{}>[];
+    added: T[];
+    changed: T[];
 };
+/**
+ * TreeGrid 데이터를 엑셀로 내보냅니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ * @param title 다운로드 파일명
+ */
 export declare const exportExcelById: (gridId: string, title?: string) => void;
+/**
+ * TreeGrid에서 현재 선택된 행 목록을 조회합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ */
 export declare const getSelectedRowsById: <T>(gridId: string) => any[] | T;
-export declare const changeVisibleCellByGridId: (gridId: string, options: {
-    targetKey: string;
-    canVisible: boolean;
-}) => void;
-export declare const setHighlightTargetCellByGridId: (gridId: string, targetOption: {
-    row: TRow;
-    col: string;
-}) => void;
+/**
+ * TreeGrid 컬럼의 표시 여부를 변경합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ * @param options.targetKey 표시 상태를 변경할 컬럼 키
+ * @param options.canVisible 컬럼 표시 여부
+ */
+export declare const changeVisibleCellByGridId: (gridId: string, options: TreeGridColumnVisibilityOptions) => void;
+/**
+ * 특정 셀에 강조 스타일을 적용합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ * @param targetOption.row 강조할 대상 행
+ * @param targetOption.col 강조할 대상 컬럼
+ */
+export declare const setHighlightTargetCellByGridId: (gridId: string, targetOption: TreeGridHighlightTargetOption) => void;
+/**
+ * TreeGrid의 현재 선택 상태를 모두 해제합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ */
+export declare const resetGridSelection: (gridId: string) => void;
+/**
+ * 여러 TreeGrid의 선택 상태를 모두 해제합니다.
+ * @param gridIds TreeGrid 인스턴스 ID 목록
+ */
+export declare const resetGridsSelection: (gridIds: string[]) => void;
+/**
+ * TreeGrid의 변경 사항과 선택 상태를 모두 초기화합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ */
+export declare const resetGridChanges: (gridId: string) => void;
+/**
+ * 여러 TreeGrid의 변경 사항과 선택 상태를 모두 초기화합니다.
+ * @param gridIds TreeGrid 인스턴스 ID 목록
+ */
+export declare const resetGridsChanges: (gridIds: string[]) => void;
+/**
+ * TreeGrid 컬럼을 Enum 타입으로 설정하고 옵션 목록을 반영합니다.
+ * @param gridId TreeGrid 인스턴스 ID
+ * @param columnName Enum을 적용할 컬럼명
+ * @param options Enum 옵션 목록
+ * @param valueKey Enum 값으로 사용할 필드명
+ * @param labelKeys Enum 라벨로 사용할 필드 우선순위 목록
+ */
+export declare const setGridEnum: <T extends object>(gridId: string, columnName: string, options: T[] | undefined, valueKey: keyof T & string, labelKeys: Array<keyof T & string>) => void;
+/** 권장 네이밍 별칭 */
+export declare const getTreeGridById: (gridId: string) => TTGrid;
+export declare const getTreeGridDataRowsById: <T>(gridId: string) => T;
+export declare const reloadTreeGridBodyById: (gridId: string, rows: unknown) => void;
+export declare const addTreeGridRowById: <T>(gridId: string, options?: TreeGridAddRowOptions<T>) => void;
+export declare const getTreeGridRowChangesById: <T>(gridId: string) => {
+    added: T[];
+    changed: T[];
+};
+export declare const exportTreeGridToExcelById: (gridId: string, title?: string) => void;
+export declare const getTreeGridSelectedRowsById: <T>(gridId: string) => any[] | T;
+export declare const setTreeGridColumnVisibilityById: (gridId: string, options: TreeGridColumnVisibilityOptions) => void;
+export declare const highlightTreeGridCellById: (gridId: string, targetOption: TreeGridHighlightTargetOption) => void;
+export declare const resetTreeGridSelectionById: (gridId: string) => void;
+export declare const resetTreeGridSelectionsByIds: (gridIds: string[]) => void;
+export declare const resetTreeGridChangesById: (gridId: string) => void;
+export declare const resetTreeGridChangesByIds: (gridIds: string[]) => void;
+export declare const setTreeGridColumnEnumOptionsById: <T extends object>(gridId: string, columnName: string, options: T[] | undefined, valueKey: keyof T & string, labelKeys: Array<keyof T & string>) => void;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@owp/core",
   "private": false,
-  "version": "1.5.1",
+  "version": "1.6.0",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",