@rebasepro/admin 0.0.1-canary.4f204c2

package/src/components/EntityCollectionTable/EntityCollectionTable.tsx

@@ -0,0 +1,385 @@
+import type { AdditionalFieldDelegate } from "@rebasepro/types";
+import React, { useCallback, useMemo, useRef } from "react";
+import { CollectionSize, Entity, RebaseContext, User } from "@rebasepro/types";
+import { PropertyTableCell } from "./PropertyTableCell";
+import { ErrorBoundary } from "@rebasepro/ui";
+import { useRebaseContext, useLargeLayout } from "@rebasepro/core";
+import { CellRendererParams, VirtualTableColumn } from "@rebasepro/ui";
+import { EntityCollectionRowActions } from "./EntityCollectionRowActions";
+import { CollectionTableToolbar } from "./internal/CollectionTableToolbar";
+import { EntityCollectionTableProps } from "./EntityCollectionTableProps";
+import { EntityTableCell } from "./internal/EntityTableCell";
+import { CustomFieldValidator } from "../../form/validation";
+import { renderSkeletonText } from "../../preview";
+import { propertiesToColumns } from "./column_utils";
+import { ErrorView } from "@rebasepro/core";
+import { SelectableTable } from "../SelectableTable/SelectableTable";
+import { cls } from "@rebasepro/ui";
+import { getRowHeight } from "@rebasepro/core";
+import { getValueInPath } from "@rebasepro/utils";
+
+/**
+ * This component is in charge of rendering a collection table with a high
+ * degree of customization.
+ *
+ * This component is used internally by {@link EntityCollectionView} and
+ * {@link useReferenceDialog}
+ *
+ * Please note that you only need to use this component if you are building
+ * a custom view. If you just need to create a default view you can do it
+ * exclusively with config options.
+ *
+ * If you want to bind a {@link EntityCollection} to a table with the default
+ * options you see in collections in the top level navigation, you can
+ * check {@link EntityCollectionView}.
+ *
+ * The data displayed in the table is managed by a {@link EntityTableController}.
+ * You can build the default, bound to a path in the driver, by using the hook
+ * {@link useDataTableController}
+ *
+ * @see EntityCollectionTableProps
+ * @see EntityCollectionView
+ * @see VirtualTable
+ * @group Components
+ */
+export const EntityCollectionTable = function EntityCollectionTable<M extends Record<string, unknown> = any, USER extends User = any>
+    ({
+        className,
+        style,
+        forceFilter,
+        actionsStart,
+        actions,
+        viewModeToggle,
+        title,
+        tableRowActionsBuilder,
+        uniqueFieldValidator,
+        getPropertyFor,
+        onValueChange,
+        selectionController,
+        highlightedEntities,
+        onEntityClick,
+        onColumnResize,
+        initialScroll,
+        onScroll,
+        onSizeChanged,
+
+        hoverRow = true,
+        inlineEditing = false,
+        additionalFields,
+        displayedColumnIds,
+        defaultSize,
+        properties,
+        tableController,
+        filterable = true,
+        sortable = true,
+        endAdornment,
+        AddColumnComponent,
+        AdditionalHeaderWidget,
+        additionalIDHeaderWidget,
+        emptyComponent,
+        getIdColumnWidth,
+        enablePopupIcon,
+        openEntityMode = "side_panel",
+        onColumnsOrderChange,
+        hideToolbar = false
+    }: EntityCollectionTableProps<M>) {
+
+    const ref = useRef<HTMLDivElement>(null);
+
+    const largeLayout = useLargeLayout();
+    const selectedEntities = useMemo(() => {
+        return (selectionController?.selectedEntities?.length > 0 ? selectionController?.selectedEntities : highlightedEntities)?.filter(Boolean);
+    }, [selectionController?.selectedEntities, highlightedEntities]);
+
+    const context: RebaseContext<USER> = useRebaseContext<USER>();
+
+    const [size, setSize] = React.useState<CollectionSize>(defaultSize ?? "m");
+
+    // Sync internal size with defaultSize prop when it changes
+    React.useEffect(() => {
+        if (defaultSize) {
+            setSize(defaultSize);
+        }
+    }, [defaultSize]);
+
+    const updateSize = useCallback((size: CollectionSize) => {
+        if (onSizeChanged)
+            onSizeChanged(size);
+        setSize(size);
+    }, []);
+
+    const onTextSearch = useCallback((newSearchString?: string) => tableController.setSearchString?.(newSearchString), []);
+
+    const additionalFieldsMap: Record<string, AdditionalFieldDelegate<M, USER>> = useMemo(() => {
+        return (additionalFields
+            ? additionalFields
+                .map((aC) => ({ [aC.key]: aC as AdditionalFieldDelegate<M, any> }))
+                .reduce((a, b) => ({ ...a,
+...b }), {})
+            : {}) as Record<string, AdditionalFieldDelegate<M, USER>>;
+    }, [additionalFields]);
+
+    const customFieldValidator: CustomFieldValidator | undefined = uniqueFieldValidator;
+
+    const propertyCellRenderer = useCallback(({
+        column,
+        columnIndex,
+        rowData,
+        rowIndex,
+        sortableNodeRef,
+        sortableStyle,
+        sortableAttributes,
+        isDragging,
+        isDraggable,
+        frozen
+    }: CellRendererParams<any>) => {
+
+        const entity: Entity<M> = rowData;
+
+        const propertyKey = column.key;
+
+        let disabled = column.custom?.disabled;
+        const property = getPropertyFor?.({
+            propertyKey,
+            entity
+        }) ?? column.custom.resolvedProperty;
+        if (!property?.disabled) {
+            disabled = false;
+        }
+
+        if (!property) {
+            return null;
+        }
+
+        return (
+            <ErrorBoundary>
+                {entity
+                    ? <PropertyTableCell
+                        key={`property_table_cell_${entity.id}_${propertyKey}`}
+                        readonly={!inlineEditing}
+                        align={column.align ?? "left"}
+                        propertyKey={propertyKey as string}
+                        property={property}
+                        value={entity?.values ? getValueInPath(entity.values, propertyKey) : undefined}
+                        customFieldValidator={customFieldValidator}
+                        columnIndex={columnIndex}
+                        width={column.width}
+                        height={getRowHeight(size)}
+                        entity={entity}
+                        disabled={disabled}
+                        enablePopupIcon={enablePopupIcon}
+                        path={entity.path}
+                        sortableNodeRef={sortableNodeRef}
+                        sortableStyle={sortableStyle}
+                        sortableAttributes={sortableAttributes}
+                        isDragging={isDragging}
+                        isDraggable={isDraggable}
+                        frozen={frozen}/>
+                    : renderSkeletonText()
+                }
+            </ErrorBoundary>);
+
+    }, [getPropertyFor, customFieldValidator, inlineEditing, enablePopupIcon, size]);
+
+    const additionalCellRenderer = useCallback(({
+        column,
+        rowData,
+        width,
+        sortableNodeRef,
+        sortableStyle,
+        sortableAttributes,
+        isDragging,
+        isDraggable,
+        frozen
+    }: CellRendererParams<any>) => {
+
+        const entity: Entity<M> = rowData;
+
+        const additionalField = additionalFieldsMap[column.key as string];
+        const value = additionalField.dependencies
+            ? Object.entries(entity.values)
+                .filter(([key, value]) => additionalField.dependencies!.includes(key as Extract<keyof M, string>))
+                .reduce((a, b) => ({ ...a,
+...b }), {})
+            : entity;
+
+        const Builder = additionalField.Builder;
+        if (!Builder && !additionalField.value) {
+            throw new Error("When using additional fields you need to provide a Builder or a value");
+        }
+
+        const child: React.ReactNode = Builder
+            ? <Builder entity={entity} context={context}/>
+            : <>
+                {additionalField.value?.({
+                    entity,
+                    context: context as unknown as RebaseContext
+                })?.toString()}
+            </>;
+
+        return (
+            <EntityTableCell
+                key={`additional_table_cell_${entity.id}_${column.key}`}
+                width={width}
+                size={size}
+                value={value}
+                selected={false}
+                disabled={true}
+                align={"left"}
+                allowScroll={false}
+                showExpandIcon={false}
+                disabledTooltip={"This column can't be edited directly"}
+                sortableNodeRef={sortableNodeRef}
+                sortableStyle={sortableStyle}
+                sortableAttributes={sortableAttributes}
+                isDragging={isDragging}
+                isDraggable={isDraggable}
+                frozen={frozen}
+            >
+                <ErrorBoundary>
+                    {child}
+                </ErrorBoundary>
+            </EntityTableCell>
+        );
+
+    }, [size]);
+
+    const collectionColumns: VirtualTableColumn[] = useMemo(() => {
+        const columnsResult: VirtualTableColumn[] = propertiesToColumns({
+            properties,
+            sortable,
+            forceFilter,
+            AdditionalHeaderWidget
+        });
+
+        // Get keys from property columns to filter out duplicate additional fields
+        const propertyColumnKeys = new Set(columnsResult.map(col => col.key));
+
+        const additionalTableColumns: VirtualTableColumn[] = additionalFields
+            // Filter out additional fields whose key already exists in property columns
+            ? additionalFields
+                .filter((additionalField) => !propertyColumnKeys.has(additionalField.key))
+                .map((additionalField) =>
+                ({
+                    key: additionalField.key,
+                    align: "left",
+                    sortable: false,
+                    title: additionalField.name,
+                    width: additionalField.width ?? 200
+                }))
+            : [];
+        return [...columnsResult, ...additionalTableColumns];
+    }, [properties, sortable, forceFilter, AdditionalHeaderWidget, additionalFields]);
+
+    const idColumn: VirtualTableColumn = useMemo(() => ({
+        key: "id_ewcfedcswdf3",
+        width: getIdColumnWidth?.() ?? (largeLayout ? 140 : 120),
+        title: "ID",
+        resizable: false,
+        frozen: largeLayout,
+        headerAlign: "center",
+        align: "center",
+        AdditionalHeaderWidget: () => additionalIDHeaderWidget
+    }), [getIdColumnWidth, largeLayout, additionalIDHeaderWidget]);
+
+    const columns: VirtualTableColumn[] = useMemo(() => [
+        idColumn,
+        ...(displayedColumnIds
+            ? displayedColumnIds
+                .map((p) => {
+                    return collectionColumns.find(c => c.key === p.key);
+                }).filter(Boolean)
+            : collectionColumns) as VirtualTableColumn[]
+    ], [idColumn, displayedColumnIds, collectionColumns]);
+
+    const cellRenderer = useCallback((props: CellRendererParams<any>) => {
+        const column = props.column;
+        const columns = props.columns;
+        const columnKey = column.key;
+
+        try {
+            if (props.columnIndex === 0) {
+                if (tableRowActionsBuilder)
+                    return tableRowActionsBuilder({
+                        entity: props.rowData,
+                        size,
+                        width: column.width,
+                        frozen: column.frozen
+                    });
+                else
+                    return <EntityCollectionRowActions entity={props.rowData}
+                        width={column.width}
+                        frozen={column.frozen}
+                        isSelected={false}
+                        size={size}
+                        openEntityMode={openEntityMode}
+                        sortableNodeRef={props.sortableNodeRef}
+                        sortableStyle={props.sortableStyle}
+                        sortableAttributes={props.sortableAttributes}
+                        isDragging={props.isDragging}
+                        isDraggable={props.isDraggable}/>;
+            } else if (additionalFieldsMap[columnKey]) {
+                return additionalCellRenderer(props);
+            } else if (props.columnIndex < columns.length + 1) {
+                return propertyCellRenderer(props);
+            } else {
+                throw Error("Internal: columns not mapped properly");
+            }
+        } catch (e: unknown) {
+            console.error("Error rendering cell", e);
+            return <EntityTableCell
+                size={size}
+                width={column.width}
+                savedTimestamp={undefined}
+                value={null}
+                align={"left"}
+                fullHeight={false}
+                disabled={true}
+                sortableNodeRef={props.sortableNodeRef}
+                sortableStyle={props.sortableStyle}
+                sortableAttributes={props.sortableAttributes}
+                isDragging={props.isDragging}
+                isDraggable={props.isDraggable}
+                frozen={props.frozen}>
+                <ErrorView error={e instanceof Error ? e : new Error(String(e))}/>
+            </EntityTableCell>;
+        }
+    }, [tableRowActionsBuilder, additionalCellRenderer, propertyCellRenderer, size]);
+
+    return (
+
+        <div ref={ref}
+            style={style}
+            className={cls("h-full w-full flex flex-col bg-white dark:bg-surface-800", className)}>
+
+            {!hideToolbar && <CollectionTableToolbar
+                onTextSearch={onTextSearch}
+                title={title}
+                actionsStart={actionsStart}
+                actions={actions}
+                viewModeToggle={viewModeToggle}
+                loading={tableController.dataLoading}/>}
+
+            <SelectableTable columns={columns}
+                size={size}
+                inlineEditing={inlineEditing}
+                cellRenderer={cellRenderer}
+                onEntityClick={onEntityClick}
+                highlightedRow={useCallback((entity: Entity<M>) => Boolean(selectedEntities?.find(e => e.id === entity.id && e.path === entity.path)), [selectedEntities])}
+                tableController={tableController}
+                onValueChange={onValueChange}
+                initialScroll={initialScroll}
+                onScroll={onScroll}
+                onColumnResize={onColumnResize}
+                hoverRow={hoverRow}
+                filterable={filterable}
+                emptyComponent={emptyComponent}
+                endAdornment={endAdornment}
+                AddColumnComponent={AddColumnComponent}
+                onColumnsOrderChange={onColumnsOrderChange}
+                extraData={useMemo(() => ({ selectedEntityIds: selectedEntities?.map(e => e.id) }), [selectedEntities])}/>
+
+        </div>
+    );
+
+};

package/src/components/EntityCollectionTable/EntityCollectionTableProps.tsx

@@ -0,0 +1,171 @@
+import type { Properties } from "@rebasepro/types";
+import type { AdditionalFieldDelegate } from "@rebasepro/types";
+import type { Property } from "@rebasepro/types";
+import React from "react";
+import { CollectionSize, Entity, EntityTableController, FilterValues, SelectionController, User } from "@rebasepro/types";
+import { OnCellValueChange, OnColumnResizeParams, UniqueFieldValidator } from "@rebasepro/core";
+import { VirtualTableColumn } from "@rebasepro/ui";
+
+/**
+ * @group Collection components
+ */
+export type EntityCollectionTableProps<M extends Record<string, unknown>,
+    USER extends User = User> = {
+
+        className?: string;
+
+        style?: React.CSSProperties;
+
+        /**
+         * Display these entities as selected
+         */
+        selectionController: SelectionController<M>;
+
+        /**
+         * List of entities that will be displayed as selected;
+         */
+        highlightedEntities?: Entity<M>[];
+
+        /**
+         * Override the title in the toolbar
+         */
+        title?: React.ReactNode;
+
+        /**
+         * Additional component that renders actions such as buttons in the
+         * collection toolbar, displayed on the left side
+         */
+        actionsStart?: React.ReactNode;
+
+        /**
+         * Callback when a cell value changes.
+         */
+        onValueChange?: OnCellValueChange<any, M>;
+
+        uniqueFieldValidator?: UniqueFieldValidator;
+
+        /**
+         * Builder for creating the buttons in each row
+         * @param entity
+         * @param size
+         */
+        tableRowActionsBuilder?: (params: {
+            entity: Entity<M>,
+            size: CollectionSize,
+            width: number,
+            frozen?: boolean
+        }) => React.ReactNode;
+
+        /**
+         * Callback when anywhere on the table is clicked
+         */
+        onEntityClick?(entity: Entity<M>): void;
+
+        /**
+         * Callback when a column is resized
+         */
+        onColumnResize?(params: OnColumnResizeParams): void;
+
+        /**
+         * Initial scroll position
+         */
+        initialScroll?: number;
+
+        /**
+         * Callback when the table is scrolled
+         * @param props
+         */
+        onScroll?: (props: {
+            scrollDirection: "forward" | "backward",
+            scrollOffset: number,
+            scrollUpdateWasRequested: boolean
+        }) => void;
+
+        /**
+         * Callback when the selected size of the table is changed
+         */
+        onSizeChanged?(size: CollectionSize): void;
+
+        /**
+         * Should apply a different style to a row when hovering
+         */
+        hoverRow?: boolean;
+
+        /**
+         * Additional component that renders actions such as buttons in the
+         * collection toolbar, displayed on the right side
+         */
+        actions?: React.ReactNode;
+
+        /**
+         * View mode toggle button, positioned left of the search bar.
+         */
+        viewModeToggle?: React.ReactNode;
+
+        /**
+         * Controller holding the logic for the table
+         * {@link useDataTableController}
+         * {@link EntityTableController}
+         */
+        tableController: EntityTableController<M>;
+
+        displayedColumnIds?: PropertyColumnConfig[];
+
+        forceFilter?: FilterValues<Extract<keyof M, string>>;
+
+        inlineEditing?: boolean;
+
+        additionalFields?: AdditionalFieldDelegate<M, USER>[];
+
+        defaultSize?: CollectionSize;
+
+        properties: Properties;
+
+        getPropertyFor?: (props: GetPropertyForProps<M>) => Property | null;
+
+        filterable?: boolean;
+
+        sortable?: boolean;
+
+        endAdornment?: React.ReactNode;
+
+        AdditionalHeaderWidget?: React.ComponentType<{
+            property: Property,
+            propertyKey: string,
+            onHover: boolean,
+        }>;
+
+        AddColumnComponent?: React.ComponentType;
+
+        additionalIDHeaderWidget?: React.ReactNode;
+
+        emptyComponent?: React.ReactNode;
+
+        getIdColumnWidth?: () => number;
+
+
+        enablePopupIcon: boolean;
+
+        openEntityMode?: "side_panel" | "full_screen" | "split";
+
+        /**
+         * Callback when columns are reordered via drag-and-drop
+         */
+        onColumnsOrderChange?: (columns: VirtualTableColumn[]) => void;
+
+        /**
+         * If true, the internal toolbar will not be rendered.
+         * Used when the parent component renders its own toolbar.
+         */
+        hideToolbar?: boolean;
+    };
+
+export type GetPropertyForProps<M extends Record<string, unknown>> = {
+    propertyKey: string,
+    entity: Entity<M>
+};
+
+export type PropertyColumnConfig = {
+    key: string,
+    disabled?: boolean,
+};