btrc-hub/frontend/src/pages/help/HelpChangesPage.tsx

import { useQuery } from '@tanstack/react-query'
import { useMemo } from 'react'
import { Helmet } from 'react-helmet-async'
import { useSearchParams } from 'react-router-dom'

import PrefetchLink from '@/components/PrefetchLink'
import PageTitle from '@/components/common/PageTitle'
import Pagination from '@/components/common/Pagination'
import MainArea from '@/components/layout/MainArea'
import { SITE_TITLE } from '@/config'
import { getHelpChanges, helpEditionDate } from '@/lib/help'
import { localeLanguage } from '@/lib/locales'
import { useLocale } from '@/lib/useLocale'
import { useUITranslation } from '@/lib/useUITranslation'
import { helpKeys } from '@/lib/queryKeys'
import { LIST_LIMIT_OPTIONS } from '@/lib/settings'
import { localisedDateString } from '@/lib/utils'

import type { FC } from 'react'


const HelpChangesPage: FC = () => {
  const { message, label } = useUITranslation ('help')
  const locale = useLocale ()
  const language = localeLanguage (locale)
  const [searchParams, setSearchParams] = useSearchParams ()
  const identifier = searchParams.get ('identifier') ?? ''
  const pageValue = searchParams.get ('page') ?? '1'
  const pageNumber = Number (pageValue)
  const requestedPage =
      (/^[1-9]\d*$/.test (pageValue) && Number.isSafeInteger (pageNumber))
      ? pageNumber : 1
  const limit = LIST_LIMIT_OPTIONS.find (
      value => String (value) === searchParams.get ('limit')) ?? 20
  const { data: changes = [], isLoading, error } = useQuery ({
      queryKey: helpKeys.changes (language),
      queryFn: () => getHelpChanges (language),
      select: entries => entries.filter (entry => entry.language === language),
      staleTime: Infinity })

  const results = useMemo (() => identifier
      ? changes.filter (entry => entry.identifier === identifier)
      : changes, [changes, identifier])
  const totalPages = Math.ceil (results.length / limit)
  const page = requestedPage <= Math.max (1, totalPages) ? requestedPage : 1
  const pageResults = results.slice ((page - 1) * limit, page * limit)

  const handleLimit = (value: string) => {
    const next = new URLSearchParams (searchParams)
    next.set ('limit', value)
    next.set ('page', '1')
    setSearchParams (next)
  }

  return (
      <MainArea className="min-w-0 max-w-full">
	<Helmet>
	  <title>{message ('history').text} | {SITE_TITLE}</title>
	</Helmet>
	<div className="flex flex-wrap items-center justify-between gap-3">
	  <PageTitle>{label ('history')}</PageTitle>
	  <label className="flex items-center gap-2 text-xs text-muted-foreground">
	    <span>{label ('common:countLabel')}</span>
	    <select value={limit} onChange={ev => handleLimit (ev.target.value)}
		className="rounded border border-border bg-background px-2 py-1 text-sm
			   text-foreground">
	      {LIST_LIMIT_OPTIONS.map (value => (
		  <option key={value} value={value}>{value}</option>))}
	    </select>
	  </label>
	</div>

	{isLoading
	 ? <p className="mt-4">{label ('shared:messages.loading')}</p>
	 : (error
	    ? <p className="mt-4 text-red-600" role="alert">{label ('common:fetchError')}</p>
	    : (
		<div className="mt-4">
		  <div className="min-w-0 max-w-full overflow-x-auto">
		    <table className="table-auto w-full min-w-[900px] whitespace-nowrap
				      border-collapse">
		      <thead className="border-b-2 border-black dark:border-white">
			<tr>
			  <th className="p-2 text-left">{label ('shared:actions.diff')}</th>
			  <th className="p-2 text-left">{label ('shared:labels.title')}</th>
			  <th className="p-2 text-left">{label ('effectiveSince')}</th>
			</tr>
		      </thead>
		      <tbody>
			{pageResults.map (entry => {
			  const path = `/help/${ encodeURIComponent (entry.identifier) }`
			  const diffQuery = new URLSearchParams ({
			      from: entry.pred ?? '', to: entry.edition })
			  const diffTo = `${ path }/diff?${ diffQuery.toString () }`
			  const updatedAt = helpEditionDate (entry.edition)

			  return (
			      <tr key={`${ entry.identifier }/${ entry.edition }`}
				  className="even:bg-gray-100 text-gray-900
					     dark:even:bg-gray-700 dark:text-gray-100">
				<td className="p-2">
				  {entry.pred != null && (
				      <PrefetchLink to={diffTo}>
					{label ('shared:actions.diff')}
				      </PrefetchLink>)}
				</td>
				<td className="p-2">
				  <PrefetchLink to={`${ path }?edition=${ entry.edition }`}>
				    {entry.title}
				  </PrefetchLink>
				</td>
				<td className="p-2">
				  {updatedAt != null && localisedDateString (updatedAt, locale, 'hour')}
				</td>
			      </tr>)
			})}
		      </tbody>
		    </table>
		  </div>
		  {totalPages > 0 && <Pagination page={page} totalPages={totalPages}/>}
		</div>))}
      </MainArea>)
}


export default HelpChangesPage