@rchemist/listgrid 0.2.6

package/dist/listgrid/components/list/themes/variants/subCollectionTheme.js

@@ -0,0 +1,101 @@
+/**
+ * 서브콜렉션용 ListGrid 테마 변형 — 중립 버전.
+ *
+ * 부모 폼 내부에 삽입되는 테이블의 컴팩트한 스타일. 기본 테마 위에
+ * `rcm-*` scoped 클래스만 활용해 헤더 숨김/테두리 축소를 덮어씁니다.
+ */
+export const subCollectionListGridTheme = {
+    panel: {
+        container: 'rcm-panel rcm-panel-muted rcm-panel-compact',
+        mainEntity: '',
+        subCollection: '',
+        default: '',
+    },
+    header: {
+        container: 'rcm-visually-hidden',
+        titleWrapper: '',
+        titleText: '',
+        buttonGroup: '',
+    },
+    subCollectionButtons: {
+        container: 'rcm-action-bar-end',
+        buttonGroup: 'rcm-row rcm-gap-sm',
+        addButton: 'rcm-button',
+        deleteButton: 'rcm-button',
+        actionButton: 'rcm-button',
+    },
+    searchBar: {
+        container: 'rcm-listgrid-searchbar',
+        innerWrapper: '',
+        layoutWrapper: 'rcm-row-between rcm-gap-sm',
+    },
+    searchInput: {
+        container: 'rcm-row',
+        input: 'rcm-field-input',
+        icon: 'rcm-listgrid-search-icon',
+        button: 'rcm-button',
+        clearButton: 'rcm-listgrid-search-clear',
+    },
+    searchBarActions: {
+        container: 'rcm-row rcm-gap-sm',
+        pageSizeSelect: 'rcm-field-input',
+        filterButton: 'rcm-button',
+        fieldSelectorButton: 'rcm-button',
+        advancedSearchButton: 'rcm-button',
+    },
+    table: {
+        responsiveWrapper: 'rcm-skeleton-table-wrapper',
+        container: 'rcm-scroll-y',
+        table: 'rcm-table',
+        thead: 'rcm-listgrid-thead',
+        headerRow: '',
+        tbody: '',
+        contentWrapper: 'rcm-scroll-y',
+    },
+    headerCell: {
+        cell: 'rcm-text-xs rcm-text-muted',
+        sortable: 'rcm-cursor-pointer',
+        sorted: 'rcm-text-emphasis',
+        sortIcon: '',
+        filterIcon: 'rcm-cursor-pointer rcm-text-muted',
+        checkboxCell: '',
+        dragHandleCell: '',
+        openNewWindowCell: '',
+        selectCell: '',
+    },
+    row: {
+        row: '',
+        hover: 'rcm-listgrid-row-hover',
+        selected: 'rcm-listgrid-row-selected',
+        even: '',
+        odd: '',
+        dragging: 'rcm-listgrid-row-dragging',
+        clickable: 'rcm-cursor-pointer',
+    },
+    cell: {
+        cell: 'rcm-text-sm',
+        checkboxCell: 'rcm-skeleton-td-checkbox',
+        numberCell: 'rcm-text-xs rcm-text-muted',
+        dragHandleCell: 'rcm-cursor-pointer',
+        openNewWindowCell: '',
+        selectCell: '',
+        dataCell: '',
+    },
+    empty: {
+        container: 'rcm-listgrid-empty',
+        message: 'rcm-text-muted rcm-text-sm',
+        icon: 'rcm-text-muted',
+    },
+    pagination: {
+        container: 'rcm-listgrid-pagination',
+        wrapper: '',
+    },
+    checkbox: {
+        container: 'rcm-row-center',
+        input: 'rcm-cursor-pointer',
+        selectAll: '',
+        item: '',
+        checked: '',
+        indeterminate: '',
+    },
+};

package/dist/listgrid/components/list/types/ListGridHeader.types.d.ts

@@ -0,0 +1,35 @@
+import { SearchForm } from '../../../form/SearchForm';
+import { EntityForm } from '../../../config/EntityForm';
+import { DataTransferConfig } from '../../../transfer/Type';
+import { ReactNode } from 'react';
+import { SelectionOptions } from './ViewListGrid.types';
+import { Session } from '../../../auth/types';
+export interface ListGridHeaderProps extends ListGridHeaderButtonProps {
+    buttons?: ((props: ListGridHeaderButtonProps) => Promise<ReactNode>)[];
+    supportPriority: boolean;
+    setManagePriority: () => void;
+    cacheable?: boolean;
+    addNew?: boolean;
+    selectionOptions?: SelectionOptions;
+    rows?: any[];
+    readonly?: boolean;
+}
+export interface ListGridHeaderButtonProps {
+    deleteItems: () => void;
+    refresh: () => void;
+    title: string;
+    hideTitle?: boolean;
+    enableHandleData: boolean;
+    router: any;
+    path: any;
+    activeTrashIcon: boolean;
+    searchForm: SearchForm;
+    dataTransferConfig?: DataTransferConfig;
+    isSubCollection?: boolean;
+    entityForm: EntityForm;
+    session?: Session;
+    setErrors: (errors: string[]) => void;
+    setNotifications: (notifications: string[]) => void;
+    checkedItems?: string[];
+}
+export declare const useServerSideCache: boolean;

package/dist/listgrid/components/list/types/ListGridHeader.types.js

@@ -0,0 +1,3 @@
+import { isTrue } from '../../../utils/BooleanUtil';
+import { getRuntimeConfig } from '../../../config/RuntimeConfig';
+export const useServerSideCache = isTrue(getRuntimeConfig().useServerSideCache, true);

package/dist/listgrid/components/list/types/RowItem.types.d.ts

@@ -0,0 +1,57 @@
+import { EntityForm } from '../../../config/EntityForm';
+import { ReactNode } from 'react';
+import { ListableFormField } from '../../fields/abstract';
+import { ItemCheckable, OpenInNewWindowOptions, SelectionOptions, ViewFieldManageable } from './ViewListGrid.types';
+import { Session } from '../../../auth/types';
+/** Inline expansion state for SubCollection */
+export interface InlineExpansionState {
+    expandedItems: string[];
+    isExpanded: (id: string) => boolean;
+    toggleExpansion: (id: string) => void;
+    collapseItem: (id: string) => void;
+    canExpand: boolean;
+    setManagedId: (value: any) => void;
+}
+export interface ViewRowItemProps extends AbstractRowItemProps, ItemCheckable {
+    session?: Session;
+    /** 관리자 권한 여부 (부모에서 계산하여 전달) */
+    isAdmin?: boolean;
+    isSubCollection: boolean;
+    list: any[];
+    enableCheckItem: boolean;
+    managePriority: boolean;
+    startNumber: number;
+    onDrag?: (idList: string[]) => void;
+    useAccordion?: {
+        render: (item: any, refresh: () => void) => Promise<ReactNode | null | undefined>;
+    };
+    sortRowsPriority?: (rows: any[]) => Promise<void>;
+    messages?: {
+        noData?: string;
+    };
+    viewMode: 'popup' | 'page';
+    selectionOptions?: SelectionOptions;
+    showCheckboxInput?: boolean;
+    /** 새창 열기 버튼 옵션 */
+    openInNewWindow?: OpenInNewWindowOptions;
+    /** SubCollection 인라인 확장 상태 (depth <= maxInlineDepth일 때 사용) */
+    inlineExpansion?: InlineExpansionState;
+    /** SubCollection mappedBy 필드 (부모 참조 필드) - ViewEntityForm에서 자동 숨김 처리 */
+    mappedBy?: string;
+    /** 인라인/상세 뷰에서 수정 불가 여부 (readonly 또는 modifyOnView: false일 때 true) */
+    inlineViewReadonly?: boolean;
+}
+export interface AbstractRowItemProps extends ViewFieldManageable {
+    fields: ListableFormField<any>[];
+    router: any;
+    path: any;
+    entityForm: EntityForm;
+    onSelect?: (item: any, setManagedId?: (value: any) => void, clearFilterAndSort?: () => void) => void;
+    onRefresh?: () => void;
+}
+export interface RowItemProps extends AbstractRowItemProps {
+    clickAccordion?: () => void;
+    item: any;
+    index: number;
+    viewMode: 'popup' | 'page';
+}

package/dist/listgrid/components/list/types/RowItem.types.js

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

package/dist/listgrid/components/list/types/SubCollectionButtons.type.d.ts

@@ -0,0 +1,29 @@
+import { SearchForm } from '../../../form/SearchForm';
+import { EntityForm } from '../../../config/EntityForm';
+import { CreateUpdateOptions } from './ViewListGrid.types';
+export interface SubCollectionBaseButtonProps {
+    add?: boolean;
+    delete?: boolean;
+    activeTrashIcon: boolean;
+    deleteItems: () => void;
+    mappedBy?: string;
+    mappedValue?: any;
+    collectionName?: string;
+    createOrUpdate?: CreateUpdateOptions;
+    setErrors: (errors: string[]) => void;
+    setNotifications: (notifications: string[]) => void;
+    entityForm: EntityForm;
+    onRefresh: () => void;
+    parentId: any;
+    checkedItems?: string[];
+    onChangeSearchForm: (searchForm: SearchForm, reset?: boolean, resetPage?: boolean) => void;
+    searchForm: SearchForm;
+    totalCount: number;
+}
+export interface SubCollectionButtonsProps extends SubCollectionBaseButtonProps {
+    buttons?: ((props: SubCollectionBaseButtonProps) => React.ReactNode)[];
+    supportPriority: boolean;
+    setManagePriority: () => void;
+    cacheable?: boolean;
+    rows?: any[];
+}

package/dist/listgrid/components/list/types/SubCollectionButtons.type.js

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

package/dist/listgrid/components/list/types/ViewListGrid.types.d.ts

@@ -0,0 +1,152 @@
+import { ColorType } from '../../../common/type';
+import { FilterItem, SearchForm } from '../../../form/SearchForm';
+import { PageResult } from '../../../form/Type';
+import { EntityFormActionResult } from '../../../config/Config';
+import { EntityForm } from '../../../config/EntityForm';
+import { ListGrid, SubCollectionProps } from '../../../config/ListGrid';
+import { ListableFormField } from '../../fields/abstract';
+import { ListGridHeaderButtonProps } from './ListGridHeader.types';
+import { ReactNode } from 'react';
+import { Session } from '../../../auth/types';
+export declare const searchFormHashKey: string;
+export interface SelectionActionButton {
+    label: string | ((checkedItems: string[]) => string);
+    onClick: (entityForm: EntityForm, checkedItems: string[]) => Promise<void>;
+    color?: ColorType;
+    outline?: boolean;
+    className?: string;
+    icon?: ReactNode;
+    show?: boolean | ((checkedItems: string[]) => boolean);
+    confirmMessage?: string | ((checkedItems: string[]) => string);
+    canExecute?: (checkedItems: string[]) => boolean;
+}
+export interface SelectionOptions {
+    enabled?: boolean | ((entityForm: EntityForm) => boolean);
+    selectableFilter?: (item: any) => boolean;
+    onSelectionChange?: (checkedItems: string[], allItems: any[]) => void;
+    maxSelection?: number;
+    minSelection?: number;
+    validateSelection?: (checkedItems: string[]) => {
+        valid: boolean;
+        message?: string;
+    };
+    actions?: SelectionActionButton[];
+    deleteButton?: {
+        show?: boolean | ((checkedItems: string[]) => boolean);
+        label?: string | ((checkedItems: string[]) => string);
+        confirmMessage?: string | ((checkedItems: string[]) => string);
+        className?: string;
+        icon?: ReactNode;
+    } | false;
+}
+export interface ViewListGridOptionProps {
+    hideTitle?: boolean;
+    onDragPriority?: {
+        support: boolean;
+        onModify?: (changed: Map<string, number>) => Promise<void>;
+    };
+    onDrag?: (idList: string[]) => void;
+    useAccordion?: {
+        render: (item: any, router: any) => Promise<ReactNode | null | undefined>;
+    };
+    readonly?: boolean;
+    subCollection?: SubCollectionProps;
+    onSelect?: (item: any, setManagedId: (value: any) => void) => void;
+    manyToOne?: {
+        onSelect: (item: any, setManagedId: (value: any) => void) => void;
+    };
+    popup?: boolean;
+    filterable?: boolean;
+    sortable?: boolean;
+    createOrUpdate?: CreateUpdateOptions;
+    delete?: {
+        onDelete?: (entityForm: EntityForm, rows: any[], checkedItems: string[]) => Promise<EntityFormActionResult>;
+        postDelete?: (entityForm: EntityForm, rows: any[], checkedItems: string[]) => Promise<void>;
+    };
+    selection?: SelectionOptions;
+    filters?: (entityForm: EntityForm) => Promise<{
+        condition?: 'AND' | 'OR';
+        items: FilterItem[];
+    }[]>;
+    fields?: ListableFormField<any>[];
+    onFetched?: PostFetchListData;
+    headerButtons?: ((props: ListGridHeaderButtonProps) => Promise<ReactNode>)[];
+    cacheable?: boolean;
+    messages?: {
+        noData?: string;
+    };
+    topContent?: (parentId: string, searchForm?: SearchForm) => ReactNode;
+    defaultPageSize?: number;
+    hidePageSize?: boolean;
+    hidePagination?: boolean;
+    hideAdvancedSearch?: boolean;
+    /**
+     * 새창 열기 버튼 설정
+     * 활성화 시 각 행의 오른쪽에 새창으로 열기 버튼이 표시됩니다.
+     */
+    openInNewWindow?: OpenInNewWindowOptions;
+    /**
+     * URL 동기화 설정
+     * 페이징, 검색, 필터, 정렬 상태를 URL 쿼리 파라미터와 동기화
+     * - true: 기본 옵션으로 활성화
+     * - false: 비활성화
+     * - UrlSyncOptions: 세부 옵션 지정
+     * 기본값: 메인 엔티티(subCollection이 아닌)에서 자동 활성화
+     */
+    urlSync?: UrlSyncOptions | boolean;
+}
+/**
+ * 새창 열기 옵션 인터페이스
+ */
+export interface OpenInNewWindowOptions {
+    /** 활성화 여부 (기본값: false) */
+    enabled: boolean;
+    /** 버튼 툴팁 텍스트 */
+    tooltip?: string;
+    /** 새창 크기 설정 */
+    windowFeatures?: {
+        width?: number;
+        height?: number;
+    };
+    /** 행별 표시 여부 필터 (특정 조건의 항목만 새창 버튼 표시) */
+    showFilter?: (item: any) => boolean;
+}
+/**
+ * URL 동기화 옵션 인터페이스
+ * ListGrid의 페이징, 검색, 필터, 정렬 상태를 URL과 동기화
+ */
+export interface UrlSyncOptions {
+    /** URL 동기화 활성화 여부 (기본값: isMainEntity일 때 true) */
+    enabled?: boolean;
+    /** 필터를 URL에 포함할지 여부 (기본값: true) */
+    includeFilters?: boolean;
+    /** 정렬을 URL에 포함할지 여부 (기본값: true) */
+    includeSort?: boolean;
+    /** 페이지 크기를 URL에 포함할지 여부 (기본값: false) */
+    includePageSize?: boolean;
+    /** sessionStorage 폴백 사용 여부 (기본값: true) */
+    sessionStorageFallback?: boolean;
+}
+export type PostFetchListData = (pageResult: PageResult) => Promise<PageResult>;
+export interface ViewListGridProps {
+    listGrid: ListGrid;
+    parentId?: string;
+    options?: ViewListGridOptionProps;
+    title?: string;
+    viewMode?: 'popup' | 'page';
+    session?: Session;
+}
+export interface CreateUpdateOptions {
+    addNew?: boolean;
+    modal?: boolean;
+    onSave?: (entityForm: EntityForm) => Promise<void>;
+    onClose?: () => void;
+}
+export interface ViewFieldManageable {
+    viewFields: string[];
+    setViewFields?: (viewFields: string[]) => void;
+}
+export interface ItemCheckable {
+    checkedItems: any[];
+    setCheckedItems?: (itemIds: any[]) => void;
+}

package/dist/listgrid/components/list/types/ViewListGrid.types.js

@@ -0,0 +1,2 @@
+import { getRuntimeConfig } from '../../../config/RuntimeConfig';
+export const searchFormHashKey = getRuntimeConfig().searchFormHashKey;