{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "pages-request-queue",
  "title": "Request queue page",
  "description": "The requests against the register's request entity: a holder's own requests, or the full queue a reviewer or other staff role sees, filterable by stage and cursor-paged.",
  "dependencies": [
    "@registrystack/app-runtime@~0.43.0-next.0"
  ],
  "registryDependencies": [
    "@registrystack/pages-record",
    "@registrystack/pages-content",
    "@registrystack/pages-register-routes",
    "@registrystack/lib-queue-parts",
    "@registrystack/lib-tab-memory",
    "@registrystack/lib-format",
    "@registrystack/shell-empty-state",
    "@registrystack/shell-error-panel",
    "@registrystack/shell-live-announcer",
    "@registrystack/shell-loading",
    "@registrystack/shell-page-heading",
    "@registrystack/shell-routing",
    "@registrystack/shell-status-badge",
    "@registrystack/shell-content",
    "@registrystack/lib-content"
  ],
  "files": [
    {
      "path": "pages/request-queue-page.tsx",
      "content": "import { useEffect } from \"react\";\nimport {\n  unavailableError,\n  type EntityModel,\n  type RecordView,\n  type RequestState,\n} from \"@registrystack/app-runtime\";\nimport { useAuthority, useRecords } from \"@registrystack/app-runtime/react\";\nimport { EmptyState } from \"@/blocks/shell/empty-state\";\nimport { ErrorPanel } from \"@/blocks/shell/error-panel\";\nimport { LiveAnnouncer, useAnnouncement } from \"@/blocks/shell/live-announcer\";\nimport { Loading } from \"@/blocks/shell/loading\";\nimport { PageHeading } from \"@/blocks/shell/page-heading\";\nimport { navigate, splitRoute, useRoute } from \"@/blocks/shell/routing\";\nimport { StatusBadge } from \"@/blocks/shell/status-badge\";\nimport { useShellContent } from \"@/blocks/shell/shell-content\";\nimport {\n  listTitle,\n  usePagesContent,\n  type PagesContent,\n} from \"@/blocks/pages/pages-content\";\nimport { useRegisterRoutes } from \"@/blocks/pages/register-routes\";\nimport {\n  defaultListRequest,\n  listableRequests,\n  recordPath,\n  recordTitle,\n  useRegister,\n  type RegisterEntities,\n} from \"@/blocks/pages/record\";\nimport {\n  DEFAULT_SIZE,\n  QueueFilterBar,\n  QueueFilterChips,\n  QueuePager,\n  QueueResultCount,\n  QueueTable,\n  parseView,\n  writeView,\n  type ActiveFilter,\n  type QueueColumn,\n  type QueueView,\n} from \"@/blocks/lib/queue-parts\";\nimport { tabCursors, useTabCursors } from \"@/blocks/lib/tab-memory\";\nimport { useBlockContent, useLocale } from \"@/blocks/lib/content\";\nimport { fill, listOf } from \"@/blocks/lib/format\";\n\n/**\n * The request queue: a holder's own requests, or the full list a reviewer or\n * other staff role sees. Its filter bar, chips, range sentence, table and\n * pager are the reusable parts in queue-parts.tsx; what stays here is what\n * belongs to this list: its route, its columns and the cursor stack this tab\n * remembers.\n */\n\n/**\n * Tab memory for the queue, not persistence. The app remounts a page on every\n * route change (the router keys the page element by the full hash), so the\n * cursor stack behind Previous, which must survive a URL this page writes\n * itself, cannot live in component state and lives here instead.\n */\nconst queueCursors = (request: string) =>\n  tabCursors(`request-queue.cursors.${request}`);\n\n/** A queue view that keeps a non-default request kind in its query string. */\nfunction requestQueueView(\n  entities: RegisterEntities,\n  path: string,\n  request: string,\n  view: QueueView,\n): string {\n  const route = writeView(path, view);\n  if (defaultListRequest(entities)?.id === request) return route;\n  const split = splitRoute(route);\n  split.query.set(\"request\", request);\n  const query = split.query.toString();\n  return `${split.path}${query ? `?${query}` : \"\"}`;\n}\n\n/** Derived, never stored: who must act before this request can progress. */\nfunction waitingOn(state: string, pages: PagesContent): string {\n  if (state === \"submitted\" || state === \"approved\")\n    return pages.waitingOnOffice;\n  if (state === \"changes-requested\" || state === \"approval-expired\")\n    return pages.waitingOnSubject;\n  return \"—\";\n}\n\n/** The session's requests; which entity they are comes from the model. */\nexport function RequestQueuePage() {\n  const register = useRegister();\n  const shell = useShellContent();\n  const { query } = splitRoute(useRoute());\n  if (register.isPending) return <Loading />;\n  if (register.error)\n    return (\n      <ErrorPanel\n        error={register.error}\n        retry={() => void register.refetch()}\n      />\n    );\n  const entities = register.entities;\n  const listed = entities ? listableRequests(entities) : [];\n  const named = query.get(\"request\");\n  const request = named\n    ? listed.find((item) => item.id === named)\n    : entities && defaultListRequest(entities);\n  if (!entities || !request)\n    return <ErrorPanel error={unavailableError(shell.unavailable)} />;\n  return <RequestQueue entities={entities} request={request} />;\n}\n\nfunction RequestQueue({\n  entities,\n  request,\n}: {\n  entities: RegisterEntities;\n  request: EntityModel;\n}) {\n  const shell = useShellContent();\n  const pages = usePagesContent();\n  const block = useBlockContent();\n  const locale = useLocale();\n  const routes = useRegisterRoutes();\n  const session = useAuthority();\n  const listed = listableRequests(entities);\n  const writeQueueView = (next: QueueView) =>\n    requestQueueView(entities, routes.requests, request.id, next);\n  // Parse once per render. No filter, size, cursor or page state is held in\n  // React state alongside the URL; every change writes the hash, and the hash\n  // alone decides what is fetched and rendered.\n  const view = parseView(splitRoute(useRoute()).query);\n  const [announcement, announce] = useAnnouncement();\n  // Host contract: a cursor continuation carries its filter server-side, and\n  // the host refuses any parameter sent alongside it. With no cursor, the\n  // filter and page size are sent instead.\n  const query = useRecords(\n    request.id,\n    view.cursor\n      ? { cursor: view.cursor }\n      : {\n          state: (view.state || undefined) as RequestState | undefined,\n          size: view.size,\n        },\n  );\n\n  const cursors = useTabCursors(queueCursors(request.id), view);\n  const previousEntry = cursors.previous;\n\n  // A cursor the host no longer holds (a restarted session lost the cursor\n  // store) is recovered from, not reported: go back to the first page of the\n  // same view, keeping the filter and page size.\n  const recovering = Boolean(view.cursor) && query.cursorExpired;\n  useEffect(() => {\n    if (!recovering) return;\n    cursors.restart();\n    announce(pages.queueRecoveredAnnouncement);\n    navigate(writeQueueView({ ...view, cursor: undefined, page: 1 }));\n    // The announcement names the recovery once; navigation then reloads.\n  }, [recovering]);\n\n  // One polite live region carries every queue announcement. The result count\n  // is restated whenever the loaded result set changes, so applying, removing\n  // or clearing a filter says how many requests remain.\n  useEffect(() => {\n    if (query.data)\n      announce(\n        fill(\n          pages.resultCountAnnouncement,\n          { count: query.data.items.length },\n          locale,\n        ),\n      );\n  }, [query.data, announce, pages, locale]);\n\n  // The stage filter offers the states the model says the host can filter by,\n  // never a hard-coded list, in the content's words where it has them. It\n  // comes from the model, so it stays mounted while another view loads.\n  const stageOptions = (request.request?.filterableStates ?? []).map((value) => ({\n    value,\n    label: shell.stateLabels[value] ?? request.request?.stateLabels[value],\n  }));\n\n  const items = query.data?.items ?? [];\n  const start = (view.page - 1) * view.size + 1;\n  // No total is available for this list, so the caption and the count line\n  // never invent one.\n  const holder = session.holder;\n  const captionText = `${\n    holder ? pages.holderQueueCaption : pages.queueCaption\n  } ${pages.defaultOrderNote}`;\n  // A list with nothing in it says why in the words of whoever reads it.\n  const emptyList =\n    session.decidesRequests\n      ? { title: pages.queueEmptyTitle, body: pages.queueEmptyBody }\n      : holder\n        ? {\n            title: pages.holderQueueEmptyTitle,\n            body: pages.holderQueueEmptyBody,\n          }\n        : { title: pages.requestsEmptyTitle, body: pages.requestsEmptyBody };\n  const activeFilters: ActiveFilter[] =\n    view.state === \"\"\n      ? []\n      : [\n          {\n            name: \"state\",\n            label: fill(\n              block.labelled,\n              {\n                label: pages.stageFilterLabel,\n                value:\n                  stageOptions.find((option) => option.value === view.state)\n                    ?.label ?? view.state,\n              },\n              locale,\n            ),\n          },\n        ];\n\n  /** Changing a filter or the page size restarts from the first page. */\n  function firstPage(change: { state?: string; size?: number }) {\n    const next: QueueView = {\n      state: change.state ?? view.state,\n      size: change.size ?? view.size,\n      cursor: undefined,\n      page: 1,\n    };\n    cursors.restart();\n    navigate(writeQueueView(next));\n  }\n  function nextPage(cursor: string) {\n    cursors.next(cursor, view.page + 1);\n    navigate(writeQueueView({ ...view, cursor, page: view.page + 1 }));\n  }\n  const previousHref = writeQueueView({\n    ...view,\n    cursor: previousEntry?.cursor,\n    page: previousEntry?.page ?? 1,\n  });\n\n  const nextCursor = query.data?.nextCursor;\n  // The reference is the row header and its link is the row's only action;\n  // request and record identifiers never reach the screen.\n  const columns: QueueColumn<RecordView>[] = [\n    {\n      key: \"reference\",\n      header: pages.referenceColumn,\n      rowHeader: true,\n      cell: (record) => {\n        const named = recordTitle(request, record, locale);\n        const title = named?.trim() ? named : pages.unnamedRequest;\n        const path = recordPath(routes, entities, record.entity, record.id);\n        return path ? (\n          <a className=\"row-link\" href={`#${path}`}>\n            {title}\n          </a>\n        ) : (\n          title\n        );\n      },\n    },\n    {\n      key: \"state\",\n      header: pages.stageFilterLabel,\n      cell: (record) =>\n        record.request && (\n          <StatusBadge\n            state={record.request.state}\n            served={request.request?.stateLabels[record.request.state]}\n          />\n        ),\n    },\n    {\n      key: \"waiting-on\",\n      header: pages.waitingOnColumn,\n      cell: (record) => waitingOn(record.request?.state ?? \"\", pages),\n    },\n  ];\n  return (\n    <>\n      <PageHeading\n        title={\n          session.decidesRequests\n            ? pages.queueTitle\n            : listTitle(\n                pages,\n                holder ? \"holderRequestsTitle\" : \"requestListTitle\",\n                request.pluralLabel,\n              )\n        }\n        description={\n          session.decidesRequests\n            ? pages.queueDescription\n            : pages.requestsDescription\n        }\n      />\n      {listed.length > 1 && (\n        <nav aria-label={pages.requestKindsLabel}>\n          <ul className=\"value-list\">\n            {listed.map((item) => (\n              <li key={item.id}>\n                <a\n                  href={`#${requestQueueView(\n                    entities,\n                    routes.requests,\n                    item.id,\n                    { state: \"\", size: DEFAULT_SIZE, page: 1 },\n                  )}`}\n                  aria-current={item.id === request.id ? \"page\" : undefined}\n                >\n                  {item.pluralLabel}\n                </a>\n              </li>\n            ))}\n          </ul>\n        </nav>\n      )}\n      <LiveAnnouncer message={announcement} />\n      {stageOptions.length > 0 && (\n        <QueueFilterBar\n          id=\"queue-state-filter\"\n          name=\"state\"\n          label={pages.stageFilterLabel}\n          value={view.state}\n          anyLabel={pages.allStates}\n          options={stageOptions}\n          onApply={(state) => firstPage({ state })}\n        />\n      )}\n      <QueueFilterChips\n        filters={activeFilters}\n        onRemove={() => firstPage({ state: \"\" })}\n        clearHref={writeQueueView({\n          state: \"\",\n          size: view.size,\n          cursor: undefined,\n          page: 1,\n        })}\n      />\n      <QueueResultCount start={start} count={items.length} />\n      {query.error && !recovering ? (\n        <ErrorPanel error={query.error} retry={() => void query.refetch()} />\n      ) : !query.data ? (\n        <QueueTable\n          caption={captionText}\n          columns={columns}\n          rows={[]}\n          rowKey={(record) => record.id}\n          loading\n        />\n      ) : items.length === 0 ? (\n        activeFilters.length > 0 ? (\n          <EmptyState\n            title={fill(\n              pages.queueFilteredEmptyTitle,\n              {\n                filters: listOf(\n                  activeFilters.map((filter) => filter.label),\n                  locale,\n                ),\n              },\n              locale,\n            )}\n          >\n            {pages.queueFilteredEmptyBody}\n          </EmptyState>\n        ) : (\n          <EmptyState title={emptyList.title}>{emptyList.body}</EmptyState>\n        )\n      ) : (\n        <QueueTable\n          caption={captionText}\n          columns={columns}\n          rows={items}\n          rowKey={(record) => record.id}\n        />\n      )}\n      {query.data && items.length > 0 && (\n        <QueuePager\n          previousHref={previousEntry ? previousHref : undefined}\n          onPrevious={cursors.back}\n          nextHref={\n            nextCursor\n              ? writeQueueView({\n                  ...view,\n                  cursor: nextCursor,\n                  page: view.page + 1,\n                })\n              : undefined\n          }\n          onNext={nextCursor ? () => nextPage(nextCursor) : undefined}\n          sizeId=\"queue-page-size\"\n          size={view.size}\n          onSize={(size) => firstPage({ size })}\n        />\n      )}\n    </>\n  );\n}\n",
      "type": "registry:block",
      "target": "@components/pages/request-queue-page.tsx"
    }
  ],
  "type": "registry:block"
}