@rchemist/listgrid 0.2.6

package/dist/listgrid/form/TagsInput/types.d.ts

@@ -0,0 +1,133 @@
+import { AdditionalColorType, ColorType, SizeType } from '../../common/type';
+/**
+ * 태그 아이템 인터페이스
+ * 각 태그의 고유 ID와 값을 포함합니다.
+ */
+export interface TagItem {
+    /** 태그의 고유 ID */
+    id: string;
+    /** 태그의 표시 값 */
+    value: string;
+    /** 태그의 색상 */
+    color?: ColorType | AdditionalColorType;
+}
+/**
+ * 태그 검증 결과 인터페이스
+ */
+export interface TagValidationResult {
+    /** 검증 통과 여부 */
+    valid: boolean;
+    /** 검증 실패 시 오류 메시지 */
+    message?: string;
+}
+/**
+ * TagsInput 컴포넌트의 Props 인터페이스
+ */
+export interface TagsInputProps {
+    /** 현재 선택된 태그들의 배열 */
+    value?: string[];
+    /** 태그 변경 시 호출되는 콜백 함수 */
+    onChange?: (value: string[]) => void;
+    /** 사용 가능한 태그 옵션들의 배열 */
+    data?: string[];
+    /** 태그 필터링 함수 */
+    filter?: (options: string[], search: string) => string[];
+    /** 최대 태그 개수 제한 */
+    maxTags?: number;
+    /** 최소 태그 개수 제한 */
+    minTags?: number;
+    /** 읽기 전용 모드 */
+    readOnly?: boolean;
+    /** 비활성화 모드 */
+    disabled?: boolean;
+    /** 필수 입력 여부 */
+    required?: boolean;
+    /** 입력 필드 크기 */
+    size?: SizeType;
+    /** 지울 수 있는지 여부 */
+    clearable?: boolean;
+    /** 플레이스홀더 텍스트 */
+    placeholder?: string;
+    /** 추가 CSS 클래스명 */
+    className?: string;
+    /** 루트 요소의 CSS 클래스명 */
+    classNames?: {
+        root?: string;
+        input?: string;
+        wrapper?: string;
+        tag?: string;
+        tagLabel?: string;
+        tagRemove?: string;
+        dropdown?: string;
+        dropdownItem?: string;
+        error?: string;
+    };
+    /** 태그 색상 함수 */
+    getTagColor?: (tagValue: string) => ColorType | AdditionalColorType;
+    /**
+     * 태그 추가 시 실시간 검증 콜백
+     * @param value - 추가하려는 태그 값
+     * @returns 검증 결과 (valid: true면 추가, false면 거부 및 오류 메시지 표시)
+     */
+    onValidateTag?: (value: string) => TagValidationResult | Promise<TagValidationResult>;
+}
+/**
+ * TagsInput Context 타입
+ * 하위 컴포넌트들이 공유하는 상태와 함수들을 정의합니다.
+ */
+export interface TagsInputContextType {
+    /** 현재 입력 중인 텍스트 */
+    inputValue: string;
+    /** 입력 텍스트 설정 함수 */
+    setInputValue: (value: string) => void;
+    /** 드롭다운 표시 여부 */
+    isDropdownOpen: boolean;
+    /** 드롭다운 표시/숨김 함수 */
+    setIsDropdownOpen: (open: boolean) => void;
+    /** 현재 선택된 드롭다운 아이템 인덱스 */
+    selectedIndex: number;
+    /** 선택된 드롭다운 아이템 인덱스 설정 함수 */
+    setSelectedIndex: (index: number) => void;
+    /** 필터링된 옵션들 */
+    filteredOptions: string[];
+    /** 태그 추가 함수 */
+    addTag: (tag: string) => void;
+    /** 태그 제거 함수 */
+    removeTag: (tagId: string) => void;
+    /** 입력 필드 포커스 함수 */
+    focusInput: () => void;
+}
+/**
+ * Tag 컴포넌트의 Props 인터페이스
+ */
+export interface TagProps {
+    /** 태그 아이템 */
+    tag: TagItem;
+    /** 태그 크기 */
+    size: SizeType;
+    /** 읽기 전용 모드 */
+    readOnly?: boolean;
+    /** 비활성화 모드 */
+    disabled?: boolean;
+    /** 추가 CSS 클래스명 */
+    className?: string;
+    /** 태그 라벨 CSS 클래스명 */
+    tagLabelClassName?: string;
+    /** 태그 제거 버튼 CSS 클래스명 */
+    tagRemoveClassName?: string;
+}
+/**
+ * TagsInputDropdown 컴포넌트의 Props 인터페이스
+ */
+export interface TagsInputDropdownProps {
+    /** 드롭다운에 표시할 옵션들 */
+    options: string[];
+    /** 현재 선택된 아이템 인덱스 */
+    selectedIndex: number;
+    /** 아이템 클릭 시 호출되는 콜백 함수 */
+    onItemClick: (option: string) => void;
+    /** 추가 CSS 클래스명 */
+    className?: string;
+    /** 드롭다운 아이템 CSS 클래스명 */
+    dropdownItemClassName?: string;
+}

package/dist/listgrid/form/TagsInput/types.js

@@ -0,0 +1 @@
+export {};

package/dist/listgrid/form/Type.d.ts

@@ -0,0 +1,50 @@
+import { AdditionalColorType, ColorType } from '../common/type';
+import { SearchForm } from './SearchForm';
+export interface SelectOption {
+    label?: string;
+    listLabel?: string;
+    value: any;
+    color?: ColorType | AdditionalColorType;
+    /**
+     * 이 옵션값이 현재 필드의 값일 때 필드를 읽기 전용으로 설정할지 여부.
+     * true이면 해당 값이 선택되었을 때 변경이 불가능합니다.
+     */
+    readonly?: boolean;
+    /**
+     * 이 옵션값에서 전이 가능한 대상 옵션 값 목록.
+     * 이 값이 설정되면 현재 옵션에서 targets 배열에 포함된 값으로만 변경할 수 있습니다.
+     * 이 값이 없으면 모든 옵션으로 변경 가능합니다.
+     */
+    targets?: string[];
+}
+export type MinMaxLimit = {
+    min?: number;
+    max?: number;
+};
+export type MinMaxStringLimit = {
+    min?: string;
+    max?: string;
+};
+export type EntityWithId = {
+    id?: string | bigint;
+    [key: string]: any;
+};
+export declare class PageResult {
+    list: EntityWithId[];
+    totalCount: number;
+    totalPage: number;
+    searchForm: SearchForm;
+    errors?: string[];
+    constructor(props: {
+        list: EntityWithId[];
+        totalCount: number;
+        totalPage: number;
+        searchForm: SearchForm;
+    });
+    static createEmptyResult(searchForm?: SearchForm): PageResult;
+    withErrors(...errors: string[]): this;
+    static fetchListData(url: string, searchForm: SearchForm, extensionOptions?: {
+        entityFormName?: string;
+        extensionPoint?: string;
+    }, serverProxy?: boolean): Promise<PageResult>;
+}

package/dist/listgrid/form/Type.js

@@ -0,0 +1,95 @@
+import { SearchForm } from './SearchForm';
+import { callExternalHttpRequest } from '../misc';
+import { isTrue } from '../utils/BooleanUtil';
+import { signOut } from '../auth/SessionProvider';
+import { showConfirm } from '../message';
+export class PageResult {
+    constructor(props) {
+        this.list = [];
+        this.searchForm = new SearchForm();
+        this.list = props.list;
+        this.totalCount = props.totalCount;
+        this.totalPage = props.totalPage;
+        this.searchForm = props.searchForm;
+    }
+    static createEmptyResult(searchForm) {
+        return new PageResult({
+            list: [],
+            totalCount: 0,
+            totalPage: 0,
+            searchForm: searchForm || new SearchForm(),
+        });
+    }
+    withErrors(...errors) {
+        this.errors = errors;
+        return this;
+    }
+    static async fetchListData(url, searchForm, extensionOptions, serverProxy = true) {
+        // 정적 빌드 시 cookies 사용으로 인한 오류 방지
+        try {
+            /**
+             * 만약 serverSide가 true 라면 넘어 온 url 을 파라미터로 포함해 내부 프록시 api 를 호출하고 그 결과를 response 로 받는다.
+             */
+            const response = await callExternalHttpRequest({
+                url: url,
+                method: 'POST',
+                formData: searchForm,
+                ...(extensionOptions?.entityFormName !== undefined
+                    ? { entityFormName: extensionOptions.entityFormName }
+                    : {}),
+                ...(extensionOptions?.extensionPoint !== undefined
+                    ? { extensionPoint: extensionOptions.extensionPoint }
+                    : {}),
+                serverProxy: serverProxy,
+            });
+            if (response.isError()) {
+                if (response.error === 'Failed to fetch' &&
+                    response.status === 500 &&
+                    typeof window !== 'undefined') {
+                    await showConfirm({
+                        title: '세션이 만료되었습니다.',
+                        message: '서비스를 이용하려면 다시 로그인해야 합니다.',
+                        confirmButtonText: '다시 로그인 하기',
+                        cancelButtonText: '',
+                        onConfirm: async () => {
+                            await signOut();
+                        },
+                    });
+                }
+                if (response.entityError) {
+                    return PageResult.createEmptyResult(searchForm).withErrors(response.entityError.error.message ?? '데이터 로딩 중 오류가 발생했습니다.');
+                }
+                return PageResult.createEmptyResult(searchForm).withErrors(response.error ?? '데이터 로딩 중 오류가 발생했습니다.');
+            }
+            const newSearchForm = SearchForm.deserialize(response.data.searchForm);
+            if (searchForm.hasPreservedFilters()) {
+                searchForm.getPreservedFilters().forEach((filter) => {
+                    if (isTrue(filter.remove)) {
+                        newSearchForm.removeFilter(filter.name);
+                    }
+                    else if (isTrue(filter.excludePreserve)) {
+                        // TODO: Preserve exclusion logic
+                    }
+                    else {
+                        newSearchForm.handleAndFilter(filter.name, filter.value, filter.op);
+                    }
+                });
+            }
+            // list 또는 content 필드 확인
+            const listData = response.data.list || response.data.content || [];
+            const responseList = listData.map((item) => ({
+                ...item,
+                id: String(item.id), // id를 문자열로 강제 변환
+            }));
+            return new PageResult({
+                list: responseList,
+                totalCount: response.data.totalCount,
+                totalPage: response.data.totalPage,
+                searchForm: newSearchForm,
+            });
+        }
+        catch (error) {
+            return PageResult.createEmptyResult(searchForm).withErrors('데이터 로딩 중 오류가 발생했습니다.');
+        }
+    }
+}

package/dist/listgrid/index.d.ts

@@ -0,0 +1,205 @@
+export { ViewListGridWrapper } from './view/ViewListGridWrapper';
+export { ViewEntityFormWrapper } from './view/ViewEntityFormWrapper';
+export { AuthProvider, useSession, useAuth, hasAnyRole, registerSignOut, signOut } from './auth';
+export type { Session, SessionUser, AuthContextValue, AuthProviderProps } from './auth';
+export { UIProvider, useUI } from './ui';
+export type { UIComponents, UIProviderProps } from './ui';
+export { GlobalModalManager } from './ui';
+export { configureMessages, showAlert, showConfirm, showError, showSuccess, showToast, openToast, clearAllToasts, } from './message';
+export type { MessageServices } from './message';
+export { configureLoading, useLoadingStore } from './loading';
+export type { LoadingStore } from './loading';
+export { useModalManagerStore, configureOverlayZIndex, getOverlayZIndex, POPOVER_Z_INDEX, } from './store';
+export type { ModalOptions } from './store';
+export { registerSmsHistoryField, createSmsHistoryField } from './extensions/FieldExtensions';
+export { configureRuntime, getRuntimeConfig } from './config/RuntimeConfig';
+export type { RuntimeConfig } from './config/RuntimeConfig';
+export { configureTranslator, getTranslation } from './utils/i18n';
+export type { Translator, TranslatorI18n, TranslatorFactory } from './utils/i18n';
+export { registerMenuPermissionChecker, checkAdminMenuPermission, DEFAULT_MENU_ALIAS, } from './menu';
+export type { MenuPermissionChecker, MenuPermissionCheckArgs } from './menu';
+export { RouterProvider, useRouter, usePathname, useParams, useSearchParams, Link } from './router';
+export type { RouterServices, RouterApi, RouterLinkProps, RouterProviderProps } from './router';
+export { UrlStateProvider, useQueryStates, createParser, parseAsString } from './urlState';
+export type { UrlStateServices, UrlParser, UrlStateSetOptions, QueryStatesSetter, UrlStateProviderProps, } from './urlState';
+export { configureApiClient, callExternalHttpRequest, getExternalApiData, getExternalApiDataWithError, ResponseData, createResponseData, } from './api';
+export type { ApiClient, ApiRequestOptions, ApiMethod, IEntityError, IEntityErrorBody, } from './api';
+export { RegexAlias, RegexEmailAddress, RegexLowerEnglishNumber, RegexPasswordNormal, RegexPhoneNumber, RegexTelephoneNumber, RegexUrlBody, fDate, fDateTime, fToNow, getFormattedTime, formatPrice, isEmpty, isEquals, isEqualsIgnoreCase, isEqualCollection, isPositive, normalizeUrl, removeTrailingSeparator, parse, getLocalStorageItem, setLocalStorageItem, getSessionStorageObject, setSessionStorageItem, ASSET_SERVER_URL, configureAssetServerUrl, getAccessableAssetUrl, removeAssetServerPrefix, getDefinedDates, } from './misc';
+export type { DefinedDateType } from './misc';
+export { ViewListGrid } from './components/list/ViewListGrid';
+export { ViewEntityForm } from './components/form/ViewEntityForm';
+export { FieldRenderer } from './components/form/FieldRenderer';
+export { SearchForm, getQueryConditionTypes, getQueryConditionValueType, getQueryConditionHelpText, } from './form/SearchForm';
+export type { FilterItem, SearchValue, SearchValueConfig, Direction, QueryConditionType, QueryConditionValueType, } from './form/SearchForm';
+export { PageResult } from './form/Type';
+export type { SelectOption, MinMaxLimit, MinMaxStringLimit, EntityWithId } from './form/Type';
+export type { XrefMappingValue } from './components/fields/view/XrefMappingView';
+export * from './config/Config';
+export * from './config/ListGrid';
+export * from './config/EntityItem';
+export * from './config/EntityField';
+export * from './config/EntityForm';
+export * from './config/EntityTab';
+export * from './config/EntityFieldGroup';
+export * from './config/EntityFormTypes';
+export * from './config/EntityFormMethod';
+export * from './config/CommonType';
+export * from './config/OnChangeEntityForm';
+export * from './config/AdvancedSearchOpenCache';
+export * from './config/ListGridViewFieldCache';
+export { ListGridHeader } from './components/list/ListGridHeader';
+export { RowItem } from './components/list/RowItem';
+export { QuickSearchBar } from './components/list/QuickSearchBar';
+export { AdvancedSearchForm } from './components/list/AdvancedSearchForm';
+export { AdvancedSearchFormV2 } from './components/list/AdvancedSearchFormV2';
+export { MemoizedFilterField } from './components/list/ui/MemoizedFilterField';
+export { FieldSelector } from './components/list/ui/FieldSelector';
+export { ViewFieldSelector } from './components/list/ViewFieldSelector';
+export { SubCollectionButtons } from './components/list/SubCollectionButtons';
+export { ViewFieldGroup } from './components/form/ViewFieldGroup';
+export { ViewTab } from './components/form/ViewTab';
+export { ViewTabPanel } from './components/form/ViewTabPanel';
+export { SubCollectionRenderer } from './components/form/SubCollectionRenderer';
+export { StringField } from './components/fields/StringField';
+export { NumberField } from './components/fields/NumberField';
+export { BooleanField } from './components/fields/BooleanField';
+export { SelectField } from './components/fields/SelectField';
+export { MultiSelectField } from './components/fields/MultiSelectField';
+export type { MultiSelectFieldProps } from './components/fields/MultiSelectField';
+export { DateField } from './components/fields/DateField';
+export { DatetimeField } from './components/fields/DatetimeField';
+export { TimeField } from './components/fields/TimeField';
+export { YearField } from './components/fields/YearField';
+export { MonthField } from './components/fields/MonthField';
+export { TextareaField } from './components/fields/TextareaField';
+export { HtmlField } from './components/fields/HtmlField';
+export { MarkdownField } from './components/fields/MarkdownField';
+export { EmailField } from './components/fields/EmailField';
+export { PasswordField } from './components/fields/PasswordField';
+export { TelephoneNumberField } from './components/fields/TelephoneNumberField';
+export { PhoneNumberField } from './components/fields/PhoneNumberField';
+export { FileField } from './components/fields/FileField';
+export { ImageField } from './components/fields/ImageField';
+export { MultipleAssetField } from './components/fields/MultipleAssetField';
+export { ColorField } from './components/fields/ColorField';
+export { ColorPresetField } from './components/fields/ColorPresetField';
+export type { StatusReason, StatusChangeReason, StatusChangeValidation, ImmediateChangeProps, } from './components/fields/SelectField';
+export { ManyToOneField, getManyToOneEntityValue } from './components/fields/ManyToOneField';
+export { MappedJoinField } from './components/fields/MappedJoinField';
+export { XrefMappingField } from './components/fields/XrefMappingField';
+export { XrefPriceMappingField } from './components/fields/XrefPriceMappingField';
+export { XrefPreferMappingField } from './components/fields/XrefPreferMappingField';
+export { XrefAvailableDateMappingField } from './components/fields/XrefAvailableDateMappingField';
+export { CheckboxField } from './components/fields/CheckboxField';
+export { TagField } from './components/fields/TagField';
+export { BirthdayField } from './components/fields/BirthdayField';
+export { LinkField } from './components/fields/LinkField';
+export { QrField } from './components/fields/QrField';
+export { MessageViewField } from './components/fields/MessageViewField';
+export { ProfileField } from './components/fields/ProfileField';
+export { InlineMapField } from './components/fields/InlineMapField';
+export { CustomOptionField } from './components/fields/CustomOptionField';
+export { RuleField } from './components/fields/RuleField';
+export { SelectFieldRenderer } from './components/fields/SelectFieldRenderer';
+export { applyFullAddressFields as ApplyFullAddressFields } from './components/fields/ApplyFullAddressFields';
+export { ContentAssetField } from './components/fields/contentasset/ContentAssetField';
+export { ContentAssetItem } from './components/fields/contentasset/ContentAssetItem';
+export { AddressFieldView } from './components/fields/address/AddressFieldView';
+export { AddressMapField } from './components/fields/address/AddressMapField';
+export { PostCodeSelector } from './components/fields/address/PostCodeSelector';
+export { KakaoMap } from './components/fields/address/KakaoMap';
+export { RuleFieldView } from './components/fields/rule/RuleFieldView';
+export { RuleBasedFieldsView as RuleBasedFieldView } from './components/fields/rule/RuleBasedFieldView';
+export { RuleFieldRenderer } from './components/fields/rule/RuleFieldRenderer';
+export { RuleBasedSelector } from './components/fields/rule/RuleBasedSelector';
+export { RuleCondition } from './components/fields/rule/RuleCondition';
+export { ManyToOneView } from './components/fields/view/ManyToOneView';
+export { ManyToOneListView } from './components/fields/view/ManyToOneListView';
+export { TreeSelectView } from './components/fields/view/TreeSelectView';
+export { LinkFieldView } from './components/fields/view/LinkFieldView';
+export { XrefMappingView } from './components/fields/view/XrefMappingView';
+export { XrefPriceMappingView as XrefPiceMappingView } from './components/fields/view/XrefPiceMappingView';
+export { XrefPreferMappingView } from './components/fields/view/XrefPreferMappingView';
+export { XrefPriorityMappingView } from './components/fields/view/XrefPriorityMappingView';
+export { XrefAvailableDateMappingView } from './components/fields/view/XrefAvailableDateMappingView';
+export { MultipleAssetUpload } from './components/fields/view/MultipleAssetUpload';
+export { FormField } from './components/fields/abstract/FormField';
+export { ListableFormField } from './components/fields/abstract/ListableFormField';
+export { OptionalField } from './components/fields/abstract/OptionalField';
+export { AbstractManyToOneField } from './components/fields/abstract/AbstractManyToOneField';
+export { AbstractDateField } from './components/fields/abstract/AbstractDateField';
+export { CheckButtonValidationField } from './components/fields/abstract/CheckButtonValidationField';
+export { DatetimeFilter } from './components/fields/filter/DatetimeFilter';
+export { NumberFilter } from './components/fields/filter/NumberFilter';
+export * from './components/fields/Preset';
+export { StatusChangeReasonModal } from './components/fields/StatusChangeReasonModal';
+export * from './components/helper/FieldRendererHelper';
+export { ShowNotifications } from './components/helper/ShowNotifications';
+export { RevisionField } from './components/revision/RevisionField';
+export { ApiSpecificationButton } from './components/api/ApiSpecificationButton';
+export { ViewApiSpecification } from './components/api/ViewApiSpecification';
+export { DataExporter } from './transfer/DataExporter';
+export { DataExportProcessor } from './transfer/DataExportProcessor';
+export { default as DynamicDataImporter } from './transfer/DynamicDataImporter';
+export { DataImportResultView } from './transfer/DataImportResultView';
+export { DataImportDescription } from './transfer/DataImportDescription';
+export { DataImportSample } from './transfer/DataImportSample';
+export { DataImporter } from './transfer/DataImporter';
+export { DataImportProcessor } from './transfer/DataImportProcessor';
+export * from './transfer/DataExportService';
+export * from './transfer/Type';
+export * from './transfer/Provider/ExcelProvider';
+export * from './validations/Validation';
+export * from './validations/RequiredValidation';
+export * from './validations/EmailValidation';
+export * from './validations/CustomValidation';
+export * from './validations/RegexValidation';
+export * from './validations/RegexFormularValidation';
+export * from './validations/MinMaxNumberValidation';
+export * from './validations/TelephoneNumberValidation';
+export * from './validations/PhoneNumberValidation';
+export * from './validations/PasswordValidation';
+export * from './validations/StringValidation';
+export * from './validations/IpAddressValidation';
+export * from './extensions/EntityFormExtension.types';
+export * from './components/form/types/ViewEntityForm.types';
+export * from './components/form/types/ViewEntityFormAlerts.types';
+export * from './components/form/types/ViewEntityFormButtons.types';
+export * from './components/list/types/ViewListGrid.types';
+export * from './components/list/types/ViewListGridTheme.types';
+export * from './components/list/types/ListGridHeader.types';
+export * from './components/list/types/RowItem.types';
+export * from './components/list/types/SubCollectionButtons.type';
+export * from './components/api/Type';
+export * from './components/fields/rule/Type';
+export * from './components/fields/contentasset/types';
+export * from './components/list/context/ListGridThemeContext';
+export * from './components/list/themes';
+export * from './components/form/hooks/useEntityFormSave';
+export * from './components/form/hooks/useEntityFormInitializer';
+export * from './components/form/hooks/useAlertManager';
+export * from './components/form/hooks/useEntityFormTitle';
+export * from './components/form/hooks/useEntityFormLogic';
+export * from './components/list/hooks/useListGridLogic';
+export * from './components/list/hooks/useListGridHeader';
+export * from './components/list/hooks/useQuickSearchBar';
+export * from './components/fields/contentasset/hooks/useContentAsset';
+export * from './components/fields/abstract/FormField';
+export * from './components/fields/abstract/ListableFormField';
+export * from './components/fields/abstract/OptionalField';
+export type { AbstractManyToOneFieldProps, CardViewConfig, SelectBoxViewConfig, } from './components/fields/abstract/AbstractManyToOneField';
+export type { AbstractDateFieldProps } from './components/fields/abstract/AbstractDateField';
+export * from './components/fields/ApplyFullAddressFields';
+export * from './components/fields/CustomOptionField';
+export * from './components/fields/view/CardManyToOneView';
+export * from './components/form/context/EntityFormThemeContext';
+export * from './components/form/types/ViewEntityFormTheme.types';
+export * from './config/SubCollectionField';
+export * from './config/CardSubCollectionField';
+export * from './config/TableSubCollectionField';
+export * from './config/EntityFormButton';
+export * from './config/InlineSubCollectionField';
+export * from './transfer/DynamicDataImporter';
+export * from './transfer/ExcelPasswordField';
+export * from './utils/cn';
+export * from './utils/classNames';