import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react'; import { __, _n, sprintf } from '@wordpress/i18n'; import { api } from '../api'; /** * The enterprise data grid: one table for every large dataset. * * Everything the server can do better, the server does — searching, sorting, * filtering, counting, paging. The browser only ever holds one page. This is * the design difference between this product and the WP-List-Tables the * incumbents still ship: a toolbar that reads like a sentence (search, filter * chips, live total), a header that sorts on click and says so, skeleton rows * while loading, honest empty/error states, and a footer that always tells you * where you are in the dataset. * * Drawn entirely from design tokens: correct in light, dark and RTL. */ /** Server list state — mirrors the ListQuery contract on the PHP side. */ export function useServerQuery(endpoint, { perPage = 50, orderby = '', order = 'desc', filters = {} } = {}) { const [state, setState] = useState({ page: 1, perPage, search: '', orderby, order, filters, }); const [rows, setRows] = useState(null); // null = loading, [] = empty const [total, setTotal] = useState(0); const [pages, setPages] = useState(0); const [error, setError] = useState(null); // One in-flight request wins: a stale slow response must not overwrite a // fresh fast one after rapid filter clicks. const seq = useRef(0); // Debounce only the search; page/sort/filter changes fetch immediately. const searchTimer = useRef(null); const [liveSearch, setLiveSearch] = useState(''); const fetchPage = useCallback(() => { const mine = ++seq.current; setError(null); const params = new URLSearchParams(); params.set('page', String(state.page)); params.set('per_page', String(state.perPage)); if (state.search) params.set('search', state.search); if (state.orderby) { params.set('orderby', state.orderby); params.set('order', state.order); } Object.entries(state.filters).forEach(([k, v]) => { if (v !== '' && v !== null && v !== undefined) params.set(k, String(v)); }); api .get(`${endpoint}?${params.toString()}`) .then((r) => { if (mine !== seq.current) return; setRows(r.items || []); setTotal(r.pagination?.total_items ?? (r.items || []).length); setPages(r.pagination?.total_pages ?? 1); }) .catch((e) => { if (mine !== seq.current) return; setError(e.message || __('Request failed', 'ai-rank-suite')); setRows([]); }); }, [endpoint, state]); useEffect(() => { fetchPage(); }, [fetchPage]); const setSearch = (value) => { setLiveSearch(value); window.clearTimeout(searchTimer.current); searchTimer.current = window.setTimeout(() => { setState((s) => ({ ...s, search: value, page: 1 })); }, 350); }; return { rows, total, pages, error, state, liveSearch, setSearch, setPage: (page) => setState((s) => ({ ...s, page })), setPerPage: (pp) => setState((s) => ({ ...s, perPage: pp, page: 1 })), sortBy: (col) => setState((s) => ({ ...s, orderby: col, order: s.orderby === col && s.order === 'desc' ? 'asc' : 'desc', page: 1, })), setFilter: (key, value) => setState((s) => ({ ...s, filters: { ...s.filters, [key]: value }, page: 1 })), resetFilters: () => setState((s) => ({ ...s, search: '', filters: {}, page: 1 })) || setLiveSearch(''), refresh: fetchPage, }; } function SortCaret({ dir }) { return ( ); } /** Shimmering placeholder rows while the server answers. */ function Skeleton({ columns, count = 8 }) { return Array.from({ length: count }, (_, i) => ( {columns.map((c) => ( ))} )); } /** * @param {object} props * @param {Array<{id:string,label:string,sortable?:boolean,num?:boolean,render?:Function,narrow?:'hide'}>} props.columns * @param {ReturnType} props.query The server query hook. * @param {Function} [props.rowKey] * @param {Function} [props.rowActions] Renders trailing action cell per row. * @param {object} [props.empty] { title, children, action, onAction } * @param {string} [props.searchPlaceholder] * @param {React.ReactNode} [props.toolbar] Extra toolbar content (filter chips). */ export default function DataGrid({ columns, query, rowKey = (r) => r.id, rowActions, empty, searchPlaceholder = 'Search…', toolbar }) { const { rows, total, pages, error, state, liveSearch, setSearch, setPage, setPerPage, sortBy, resetFilters, refresh } = query; const activeFilters = useMemo( () => Object.entries(state.filters).filter(([, v]) => v !== '' && v !== null && v !== undefined), [state.filters] ); const loading = rows === null; const from = total === 0 ? 0 : (state.page - 1) * state.perPage + 1; const to = Math.min(total, state.page * state.perPage); return (
setSearch(e.target.value)} aria-label={searchPlaceholder} />
{toolbar} {(activeFilters.length > 0 || state.search) && ( )} {loading ? '…' : sprintf(__('%s total', 'ai-rank-suite'), total.toLocaleString())}
{columns.map((c) => ( ))} {rowActions && {loading ? ( ) : error ? ( ) : rows.length === 0 ? ( ) : ( rows.map((row) => ( {columns.map((c) => ( ))} {rowActions && } )) )}
{c.sortable ? ( ) : ( c.label )} }
{error}
{empty?.title || __('Nothing here', 'ai-rank-suite')} {empty?.children && {empty.children}} {(activeFilters.length > 0 || state.search) && ( )}
{c.render ? c.render(row) : row[c.id]} {rowActions(row)}
{!loading && !error && total > 0 && (
{from.toLocaleString()}–{to.toLocaleString()} of {total.toLocaleString()}
{state.page} / {Math.max(1, pages)}
)}
); }