@owp/core 2.2.3 → 2.2.5

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

@@ -0,0 +1,42 @@
+import type { OwpSelectorBaseChangeEvent, OwpSelectorBaseProps } from '@/components/OwpSelectorBase/types';
+type OwpQuerySelectorItem = Record<string, unknown>;
+export interface OwpQuerySelectorAsyncSearch {
+    buildAllQuery?: () => Record<string, unknown>;
+    buildKeywordQuery: (keyword: string) => Record<string, unknown>;
+    buildSelectedQuery?: (selectedIds: string[]) => Record<string, unknown>;
+    debounceMs?: number;
+    minLength?: number;
+}
+type OwpQuerySelectorValueConfig = {
+    valueKey: string;
+    valueResolver?: (item: OwpQuerySelectorItem) => string;
+} | {
+    valueKey?: undefined;
+    valueResolver: (item: OwpQuerySelectorItem) => string;
+};
+type OwpQuerySelectorLabelConfig = {
+    labelKey: string;
+    labelResolver?: (item: OwpQuerySelectorItem) => string;
+} | {
+    labelKey?: undefined;
+    labelResolver: (item: OwpQuerySelectorItem) => string;
+};
+type OwpQuerySelectorSharedProps = Omit<OwpSelectorBaseProps, 'allOptions' | 'allValueMode' | 'disableClientFilter' | 'loading' | 'onChange' | 'options'> & {
+    apiUrl: string;
+    buildRequestQuery?: (query: Record<string, unknown>) => Record<string, unknown>;
+    filterOptions?: (items: OwpQuerySelectorItem[]) => OwpQuerySelectorItem[];
+    onChange?: (event: OwpSelectorBaseChangeEvent) => void;
+    query: Record<string, unknown>;
+    responseListKey?: string;
+};
+export type OwpQuerySelectorBaseProps = OwpQuerySelectorSharedProps & OwpQuerySelectorValueConfig & OwpQuerySelectorLabelConfig;
+export type OwpAutocompleteQuerySelectorProps = OwpQuerySelectorBaseProps & {
+    asyncSearch?: OwpQuerySelectorAsyncSearch;
+    selectorType: 'autocomplete';
+};
+export type OwpSelectQuerySelectorProps = OwpQuerySelectorBaseProps & {
+    asyncSearch?: never;
+    selectorType?: 'select';
+};
+export type OwpQuerySelectorProps = OwpAutocompleteQuerySelectorProps | OwpSelectQuerySelectorProps;
+export {};

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

@@ -1,4 +1,4 @@
-import { IconProps } from '@mui/material';
+import { type IconProps } from '@mui/material';
 import type { HTMLAttributes, ReactNode } from 'react';
 interface OwpSectionProps {
     className?: string;
@@ -19,6 +19,8 @@ interface OwpSectionProps {
  * @param disableTitleIcon disableTitleIcon 값
  * @param headerProps headerProps props
  * @param usePageTitle usePageTitle 값
+ * @param leftSlot leftSlot 값
+ * @param centerSlot centerSlot 값
  * @param actions 액션 영역
  */
 declare const OwpSection: ({ className, title, disableTitleIcon, headerProps, usePageTitle, actions, leftSlot, centerSlot, children, iconSize, }: OwpSectionProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/components/OwpSelectorBase/OwpSelectorAutocomplete.d.ts

@@ -0,0 +1,11 @@
+import type { OwpSelectorBaseHookResult, OwpSelectorBaseProps } from './types';
+interface OwpSelectorAutocompleteProps {
+    hookResult: OwpSelectorBaseHookResult;
+    props: OwpSelectorBaseProps;
+}
+/**
+ * Autocomplete 기반 공통 선택기
+ * @param props Autocomplete 렌더링 props
+ */
+export declare const OwpSelectorAutocomplete: ({ hookResult, props }: OwpSelectorAutocompleteProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,6 @@
+import type { OwpSelectorBaseProps } from './types';
+/**
+ * 공통 선택기 베이스
+ * @param props 공통 선택기 props
+ */
+export declare const OwpSelectorBase: (props: OwpSelectorBaseProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/components/OwpSelectorBase/OwpSelectorSelect.d.ts

@@ -0,0 +1,11 @@
+import type { OwpSelectorBaseHookResult, OwpSelectorBaseProps } from './types';
+interface OwpSelectorSelectProps {
+    hookResult: OwpSelectorBaseHookResult;
+    props: OwpSelectorBaseProps;
+}
+/**
+ * Select 기반 공통 선택기
+ * @param props Select 렌더링 props
+ */
+export declare const OwpSelectorSelect: ({ hookResult, props }: OwpSelectorSelectProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/OwpSelectorBase/hooks/useOwpSelectorBase.d.ts

@@ -0,0 +1,6 @@
+import { type OwpSelectorBaseHookResult, type OwpSelectorBaseProps } from '../types';
+/**
+ * 공통 선택기 상태 훅
+ * @param props 공통 선택기 props
+ */
+export declare const useOwpSelectorBase: ({ allOptions, allValueMode, defaultValue, disableAllValueItem, multiple, name, onChange, options, value, }: OwpSelectorBaseProps) => OwpSelectorBaseHookResult;

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

@@ -0,0 +1 @@
+export type { OwpSelectorAllValueMode, OwpSelectorBaseChangeEvent, OwpSelectorBaseHookResult, OwpSelectorBaseOption, OwpSelectorBaseProps, OwpSelectorEmptyValueMode, OwpSelectorType, } from './types';

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

@@ -0,0 +1,59 @@
+import type { ReactNode } from 'react';
+import type { SelectProps, TextFieldProps } from '@mui/material';
+export type OwpSelectorType = 'select' | 'autocomplete';
+export type OwpSelectorAllValueMode = 'empty' | 'joined';
+export type OwpSelectorEmptyValueMode = 'all' | 'none';
+export interface OwpSelectorBaseOption<T = unknown> {
+    value: string;
+    label: ReactNode;
+    raw?: T;
+    disabled?: boolean;
+}
+export interface OwpSelectorBaseChangeEvent {
+    target: {
+        name: string;
+        value: string;
+    };
+}
+export interface OwpSelectorBaseProps {
+    options: OwpSelectorBaseOption[];
+    allOptions?: OwpSelectorBaseOption[];
+    selectorType?: OwpSelectorType;
+    allValueMode?: OwpSelectorAllValueMode;
+    defaultValue?: string;
+    disableAllValueItem?: boolean;
+    disabled?: boolean;
+    disableClientFilter?: boolean;
+    error?: boolean;
+    fullWidth?: boolean;
+    helperText?: ReactNode;
+    label?: ReactNode;
+    loading?: boolean;
+    loadingText?: ReactNode;
+    multiple?: boolean;
+    name?: string;
+    noOptionsText?: ReactNode;
+    onChange?: (event: OwpSelectorBaseChangeEvent) => void;
+    placeholder?: string;
+    required?: boolean;
+    value?: string;
+    className?: string;
+    textFieldProps?: Omit<TextFieldProps, 'defaultValue' | 'error' | 'fullWidth' | 'helperText' | 'label' | 'onChange' | 'required' | 'value'>;
+    selectProps?: Omit<SelectProps<string>, 'defaultValue' | 'displayEmpty' | 'error' | 'fullWidth' | 'label' | 'multiple' | 'onChange' | 'required' | 'value'>;
+    autocompleteInputValue?: string;
+    onAutocompleteInputChange?: (nextInputValue: string, reason: string) => void;
+}
+export interface OwpSelectorBaseHookResult {
+    allOption: OwpSelectorBaseOption<null>;
+    allValue: string;
+    isAllSelected: boolean;
+    resolvedOptions: OwpSelectorBaseOption[];
+    selectedOption: OwpSelectorBaseOption | null;
+    selectedOptions: OwpSelectorBaseOption[];
+    selectedValueList: string[];
+    clearSelection: () => void;
+    restoreAllSelection: () => void;
+    selectAll: () => void;
+    selectMultipleValues: (nextSelectedValueList: string[]) => void;
+    selectSingleValue: (nextValue: string) => void;
+}

package/dist/types/components/OwpSelectorBase/utils/index.d.ts

@@ -0,0 +1 @@
+export { createSelectorChangeEvent, getSelectorAllToken, isSelectorAllOption, joinSelectorValue, mergeSelectorOptions, splitSelectorValue, } from './querySelectorUtils';

package/dist/types/components/OwpSelectorBase/utils/querySelectorUtils.d.ts

@@ -0,0 +1,31 @@
+import type { OwpSelectorBaseChangeEvent, OwpSelectorBaseOption } from '../types';
+/**
+ * 전체 선택 토큰 반환
+ */
+export declare const getSelectorAllToken: () => string;
+/**
+ * 선택 값 문자열 분리
+ * @param value 원본 선택 값
+ */
+export declare const splitSelectorValue: (value?: string) => string[];
+/**
+ * 선택 값 문자열 결합
+ * @param valueList 선택 값 목록
+ */
+export declare const joinSelectorValue: (valueList: string[]) => string;
+/**
+ * 선택 변경 이벤트 생성
+ * @param name 필드 이름
+ * @param value 선택 값
+ */
+export declare const createSelectorChangeEvent: (name: string | undefined, value: string) => OwpSelectorBaseChangeEvent;
+/**
+ * 선택 옵션 목록 병합
+ * @param optionGroups 옵션 그룹 목록
+ */
+export declare const mergeSelectorOptions: <T = unknown>(...optionGroups: Array<OwpSelectorBaseOption<T>[] | undefined>) => OwpSelectorBaseOption<T>[];
+/**
+ * 선택 옵션 값 포함 여부 확인
+ * @param option 선택 옵션
+ */
+export declare const isSelectorAllOption: (option: OwpSelectorBaseOption) => boolean;

package/dist/types/hooks/index.d.ts

@@ -8,6 +8,7 @@ export * from './useCurrentUser';
 export * from './useCurrentUserId';
 export * from './useDebounce';
 export * from './useDeepCompareEffect';
+export * from './useHeaderWrapState';
 export * from './useInitApp';
 export * from './useInitCommonCodes';
 export * from './useNavigation';

package/dist/types/hooks/useHeaderWrapState.d.ts

@@ -0,0 +1,14 @@
+import { type RefObject } from 'react';
+type HeaderWrapState = {
+    containerRef: RefObject<HTMLDivElement | null>;
+    titleRef: RefObject<HTMLDivElement | null>;
+    slotsRef: RefObject<HTMLDivElement | null>;
+    actionsRef: RefObject<HTMLDivElement | null>;
+    isWrapped: boolean;
+};
+/**
+ * 헤더 한 줄 배치 가능 여부 계산 훅
+ * @param deps 측정 재실행 의존성
+ */
+declare const useHeaderWrapState: (deps?: unknown[]) => HeaderWrapState;
+export { useHeaderWrapState };

package/dist/types/index.d.ts

@@ -25,6 +25,7 @@ export * from './components/OwpPageBreadcrumb';
 export * from './components/OwpPageContent';
 export * from './components/OwpPageLockLoading';
 export * from './components/OwpPageTitle';
+export * from './components/OwpQuerySelector';
 export * from './components/OwpPicker/OwpDatePicker';
 export * from './components/OwpPicker/OwpDateRangePicker';
 export * from './components/OwpPicker/OwpTimePicker';

package/package.json

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