siftlode/frontend/src/components/Channels.tsx

import { useEffect, useMemo, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { qk } from "../lib/queryKeys";
import { Ban, Eye, EyeOff, History, LayoutGrid, Pencil, RefreshCw, Table, X } from "lucide-react";
import ExcludedChannelList from "./ExcludedChannelList";
import { api, NO_TAG_SENTINEL, type ManagedChannel } from "../lib/api";
import { Sparkles } from "lucide-react";
import { notifyYouTubeActionError } from "../lib/youtubeErrors";
import { accountKey, LS } from "../lib/storage";
import { buildChannelColumns, applySyncFilter } from "./channelColumns";
import { notify } from "../lib/notifications";
import Tooltip from "./ui/Tooltip";
import DataTable from "./ui/DataTable";
import Tabs, { type TabDef } from "./ui/Tabs";
import ChannelLayoutGrid from "./ChannelLayoutGrid";
import { LoadingState, StateMessage } from "./ui/QueryState";
import { useChannelTagActions } from "../lib/useChannelTagActions";
import { useTagSuggestions } from "./useTagSuggestions";
import { useChannelPriority } from "../lib/useChannelPriority";
import ViewSwitcher, { type ViewOption } from "./ViewSwitcher";
import ColumnSortControl from "./ui/ColumnSortControl";
import FilterChipGroup from "./ui/FilterChipGroup";
import TagFilterChips, { type FilterChip } from "./TagFilterChips";
import ActionMenu, { type ActionMenuItem } from "./ui/ActionMenu";
import ChannelStatsPopover from "./ChannelStatsPopover";
import Pager from "./ui/Pager";
import { CHANNEL_LAYOUTS, type ChannelLayout } from "../lib/channelLayout";
import { sortRows } from "../lib/columnSort";
import { filterRows } from "./ui/tableHeader";
import { useCardPager } from "../lib/useCardPager";
import { PageToolbar } from "./ui/PageShell";
import ChannelDiscovery from "./ChannelDiscovery";
import TagManager from "./TagManager";
import { useConfirm } from "./ConfirmProvider";
import { useChannelLayout, useChannels, useChannelsActions } from "./ChannelsProvider";
import { useNavigationActions } from "./NavigationProvider";
import { useFeedFilters, useFeedFiltersActions } from "./FeedFiltersProvider";
import { useWizard } from "./WizardProvider";
import { useMe } from "../lib/useMe";

export type ChannelsView = "subscribed" | "discovery" | "hidden" | "blocked";

// The top sync chips are a controlled view over the subscribed table's `sync` column filter (shared
// via ChannelsProvider): each chip writes `filters.sync`, using the SAME vocab + predicate as the
// Sync column funnel (channelColumns.tsx) so the two can't drift. "" = all (isActive treats it as
// off). fullySynced = recent_synced && backfill_done (matches the cell's own "fully synced" badge).
const SYNC_CHIPS: { value: string; labelKey: string }[] = [
  { value: "", labelKey: "channels.filters.all" },
  { value: "needsFull", labelKey: "channels.filters.needsFull" },
  { value: "fully", labelKey: "channels.filters.fullySynced" },
];

const LAYOUT_ICON: Record<ChannelLayout, typeof Table> = {
  table: Table,
  cards: LayoutGrid,
};

export default function Channels() {
  const me = useMe();
  const canWrite = me.can_write;
  const isAdmin = me.role === "admin";
  // "Connect YouTube" onboarding lives in WizardProvider (a notify action / a mutation-error CTA).
  const { openWizard: onOpenWizard } = useWizard();
  // The manager's name filter, status chip, active tab, reset token, and focus-channel intent live
  // in ChannelsProvider (shared with the header search box + the cross-module "focus this channel"
  // callers); this page is their primary editor.
  const {
    search,
    filters,
    view,
    sort,
    filtersResetToken,
    focusName: focusChannelName,
    focusToken: focusChannelToken,
  } = useChannels();
  const layout = useChannelLayout();
  const {
    setSearch,
    setFilters,
    setView,
    setLayout,
    setSort,
    focusChannel: onFocusChannel,
  } = useChannelsActions();
  const { openChannel: onViewChannel, setPage } = useNavigationActions();
  const feedFilters = useFeedFilters();
  const { setFilters: setFeedFilters } = useFeedFiltersActions();
  const { t } = useTranslation();
  const qc = useQueryClient();
  const confirm = useConfirm();

  // Clicking a tag chip filters the feed by that tag and jumps there. Internalised (was an App
  // callback) now that Channels reads the feed filters + navigation straight from their providers.
  const onFilterByTag = (tagId: number, name: string) => {
    setFeedFilters({ ...feedFilters, tags: [tagId], channelIds: [] });
    setPage("feed");
    notify({ level: "info", message: t("channels.notify.filteredByTag", { name }) });
  };

  const channelsQuery = useQuery({ queryKey: qk.channels(), queryFn: api.channels });
  const tagsQuery = useQuery({ queryKey: qk.tags(), queryFn: api.tags });
  const statusQuery = useQuery({ queryKey: qk.myStatus(), queryFn: api.myStatus });
  const blockedQuery = useQuery({ queryKey: qk.blockedChannels(), queryFn: api.blockedChannels });
  const [tagManagerOpen, setTagManagerOpen] = useState(false);
  const unblock = useMutation({
    mutationFn: (id: string) => api.unblockChannel(id),
    onSuccess: () => {
      qc.invalidateQueries({ queryKey: qk.blockedChannels() });
      qc.invalidateQueries({ queryKey: qk.feed() });
    },
  });

  const invalidate = () => {
    qc.invalidateQueries({ queryKey: qk.channels() });
    qc.invalidateQueries({ queryKey: qk.tags() });
    qc.invalidateQueries({ queryKey: qk.myStatus() });
    // FB2: syncing subscriptions can change the feed immediately — newly-followed channels may
    // already have videos in the shared catalog, so refresh the feed too (not just the manager).
    qc.invalidateQueries({ queryKey: qk.feed() });
    qc.invalidateQueries({ queryKey: qk.feedSummary() });
  };

  const userTags = (tagsQuery.data ?? []).filter((t) => !t.system);

  const patch = useMutation({
    mutationFn: (v: {
      id: string;
      body: { priority?: number; hidden?: boolean; deep_requested?: boolean };
    }) => api.updateChannel(v.id, v.body),
    // Requesting full history may have just pulled in a channel's recent uploads, so
    // refresh the per-user status and feed too — not only the channel list.
    onSuccess: () => {
      qc.invalidateQueries({ queryKey: qk.channels() });
      qc.invalidateQueries({ queryKey: qk.myStatus() });
      qc.invalidateQueries({ queryKey: qk.feed() });
      qc.invalidateQueries({ queryKey: qk.feedSummary() });
    },
  });
  // Priority is updated optimistically in place and NOT re-sorted/refetched, so the list doesn't
  // jump (the server list is priority-sorted; refetching would reorder rows and lose your scroll
  // position). The new order takes effect next time the page loads. Press-and-hold is debounced +
  // flushed on unmount by the shared hook (same flow the channel detail page uses).
  const { setPriority, bumpPriority } = useChannelPriority({
    read: (id) =>
      qc.getQueryData<ManagedChannel[]>(qk.channels())?.find((c) => c.id === id)?.priority,
    optimistic: (id, next) =>
      qc.setQueryData<ManagedChannel[]>(qk.channels(), (old) =>
        (old ?? []).map((ch) => (ch.id === id ? { ...ch, priority: next } : ch)),
      ),
    onError: () => qc.invalidateQueries({ queryKey: qk.channels() }),
  });

  // Tagging is updated optimistically in place (no refetch of the whole channel list, which
  // made the toggle feel ~2s slow); only revert by refetching if the server call fails. The
  // attach/detach + create-and-attach flow is shared with the channel detail page.
  const { toggleTag, createAndAttachTag } = useChannelTagActions({
    optimisticToggle: (id, tagId, attach) =>
      qc.setQueryData<ManagedChannel[]>(qk.channels(), (old) =>
        (old ?? []).map((ch) =>
          ch.id === id
            ? {
                ...ch,
                tag_ids: attach ? [...ch.tag_ids, tagId] : ch.tag_ids.filter((x) => x !== tagId),
              }
            : ch,
        ),
      ),
    // Keep the channel DETAIL cache in step with the manager list (the detail page reads its tags
    // from qk.channel(id)); mirrors the detail page invalidating the manager list on its side. Also
    // recompute suggestions: a channel that just gained/lost a user tag changes the untagged set and
    // the learned pattern (E8·S4).
    onSuccess: (id) => {
      qc.invalidateQueries({ queryKey: qk.channel(id) });
      qc.invalidateQueries({ queryKey: qk.tagSuggestions() });
    },
    // A failed attach/detach reverts the optimistic change by refetching the list. Also refetch
    // suggestions: acceptSuggestion optimistically dropped the channel from that cache, and on
    // failure the tag never actually attached — so the server still suggests it and the ghost chips
    // must come back rather than leaving an empty cell (honest states). Surface the write failure too.
    onError: () => {
      qc.invalidateQueries({ queryKey: qk.channels() });
      qc.invalidateQueries({ queryKey: qk.tagSuggestions() });
      notify({ level: "error", message: t("channels.tags.updateFailed") });
    },
  });
  // --- Suggested tags (E8·S4): learned from the user's own manual-tag pattern, shown as accept/dismiss
  // ghost chips on untagged channels. Dismissal is session-only (an accepted suggestion self-clears —
  // the channel becomes tagged and the server drops it; a dismissed one just hides until reload). The
  // /tags/suggestions query, the session dismiss set, and the optimistic accept/dismiss/bulk logic all
  // live in useTagSuggestions so they can be unit-tested apart from this component.
  const {
    suggestionsFor,
    dismissSuggestion,
    acceptSuggestion,
    visibleSuggestions,
    highConfidence,
    acceptAllHighConfidence,
  } = useTagSuggestions({ tags: tagsQuery.data ?? [], toggleTag });

  const syncSubs = useMutation({
    mutationFn: () => api.syncSubscriptions(),
    onSuccess: (r: { subscriptions?: number }) => {
      invalidate();
      notify({
        level: "success",
        message: t("channels.notify.synced", { count: r.subscriptions ?? 0 }),
      });
    },
    onError: (e) => notifyYouTubeActionError(e, t("channels.notify.syncFailed"), onOpenWizard),
  });
  const unsubscribe = useMutation({
    mutationFn: (v: { id: string; name: string }) => api.unsubscribeChannel(v.id),
    onSuccess: (_d, v) => {
      qc.invalidateQueries({ queryKey: qk.channels() });
      qc.invalidateQueries({ queryKey: qk.myStatus() });
      notify({ level: "success", message: t("channels.notify.unsubscribed", { name: v.name }) });
    },
    onError: (e) =>
      notifyYouTubeActionError(e, t("channels.notify.unsubscribeFailed"), onOpenWizard),
  });
  const resetBackfill = useMutation({
    mutationFn: (v: { id: string; name: string }) => api.resetChannelBackfill(v.id),
    onSuccess: (_d, v) => {
      qc.invalidateQueries({ queryKey: qk.channels() });
      qc.invalidateQueries({ queryKey: qk.myStatus() });
      notify({ level: "success", message: t("channels.notify.resetDone", { name: v.name }) });
    },
    onError: (e) => notifyYouTubeActionError(e, t("channels.notify.resetFailed"), onOpenWizard),
  });
  const deepAll = useMutation({
    mutationFn: () => api.deepAll(true),
    onSuccess: (r: { updated?: number }) => {
      qc.invalidateQueries({ queryKey: qk.channels() });
      qc.invalidateQueries({ queryKey: qk.myStatus() });
      notify({
        level: "success",
        message: t("channels.notify.fullHistoryRequested", { count: r.updated ?? 0 }),
      });
    },
    onError: (e) =>
      notifyYouTubeActionError(e, t("channels.notify.fullHistoryFailed"), onOpenWizard),
  });

  // The tag-chip row is a controlled view over the Tags COLUMN filter (`filters.tags`, a string[] of
  // tag ids), the same way the sync chips drive `filters.sync` — so the top chips and the Tags column
  // funnel share ONE state and stay in sync (bidirectional). Toggling a chip rewrites `filters.tags`;
  // filterRows / DataTable then applies it. Channel-name search stays separate (the shared top box).
  const tagFilter = Array.isArray(filters.tags) ? filters.tags : [];
  // Picking a real tag drops the "No tag" sentinel (item B) — they're mutually exclusive, as in the feed.
  const toggleTagFilter = (tagId: number) => {
    const id = String(tagId);
    const base = tagFilter.filter((x) => x !== NO_TAG_SENTINEL);
    const next = base.includes(id) ? base.filter((x) => x !== id) : [...base, id];
    setFilters({ ...filters, tags: next });
  };
  // The "No tag" chip: filter the table to channels you haven't personally tagged yet. Exclusive with
  // real tag chips (clicking it drops them); the Tags column's test reads the sentinel (channelColumns).
  const noTagOn = tagFilter.includes(NO_TAG_SENTINEL);
  const toggleNoTagFilter = () =>
    setFilters({ ...filters, tags: noTagOn ? [] : [NO_TAG_SENTINEL] });
  // The tag-filter chips (user tags + the "No tag" sentinel), fed to TagFilterChips which folds any
  // overflow into a "+N" pill so the row stays one line and the trailing "…" actions can't wrap.
  const tagFilterChips: FilterChip[] = [
    ...userTags.map((tg) => ({
      key: `t${tg.id}`,
      label: tg.name,
      active: tagFilter.includes(String(tg.id)),
      onToggle: () => toggleTagFilter(tg.id),
    })),
    {
      key: NO_TAG_SENTINEL,
      label: t("channels.tags.noTag"),
      active: noTagOn,
      onToggle: toggleNoTagFilter,
    },
  ];
  // A focus-channel intent (header "without full history" / tag manager) seeds the search box.
  useEffect(() => {
    if (focusChannelName) setSearch(focusChannelName);
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [focusChannelToken]);
  // The header's reset intent clears the search box (skip the initial mount); the tag chips ride in
  // `filters.tags`, which goToFullHistory already clears by setting a fresh map.
  const resetRef = useRef(filtersResetToken);
  useEffect(() => {
    if (filtersResetToken === resetRef.current) return;
    resetRef.current = filtersResetToken;
    setSearch("");
  }, [filtersResetToken]);

  // Tag/priority/text filters stay controlled COLUMN filters (`filters.tags` etc.) shared by the top
  // chips, the column funnels and the cards. The sync-status filter (`filters.sync`) is no longer a
  // column — R14 retired the Sync column and folded its status into a ✓ charm on Stored — so it's
  // applied as a pre-filter (`applySyncFilter`) over the rows fed to BOTH the table and the cards,
  // still driven by the same top chips. Hidden channels have their own tab (excluded here). Only the
  // name search filters at this step; the remaining column funnels run in DataTable / filterRows below.
  const hiddenChannels = (channelsQuery.data ?? []).filter((c) => c.hidden);
  const channels = (channelsQuery.data ?? []).filter((c) => !c.hidden);
  const q = search.trim().toLowerCase();
  const visibleChannels = channels.filter(
    (c) => !q || `${c.title ?? ""} ${c.handle ?? ""}`.toLowerCase().includes(q),
  );
  // Sync-status pre-filter (top chips → `filters.sync`), applied before the table/cards see the rows.
  // (Inline, not memoised: `visibleChannels` is a fresh array each render, so a useMemo keyed on it
  // could never hit its cache — and applySyncFilter is a cheap single pass anyway.)
  const syncedChannels = applySyncFilter(visibleChannels, filters.sync);
  const s = statusQuery.data;

  const onView = (c: ManagedChannel) =>
    onViewChannel(c.id, c.title ?? t("channels.row.thisChannel"));
  const onUnsub = async (c: ManagedChannel) => {
    const ok = await confirm({
      title: t("channels.row.unsubscribeOnYoutube"),
      message: t("channels.confirmUnsubscribe", { name: c.title ?? c.id }),
      confirmLabel: t("channels.row.unsubscribeOnYoutube"),
      danger: true,
    });
    if (ok) unsubscribe.mutate({ id: c.id, name: c.title ?? c.id });
  };
  const onReset = async (c: ManagedChannel) => {
    const ok = await confirm({
      title: t("channels.row.backfillThis"),
      message: t("channels.confirmReset", { name: c.title ?? c.id }),
      confirmLabel: t("channels.row.backfillThis"),
    });
    if (ok) resetBackfill.mutate({ id: c.id, name: c.title ?? c.id });
  };

  // Distinct priority levels present in the catalog → the priority column's filter options.
  const prioOptions = [...new Set((channelsQuery.data ?? []).map((c) => c.priority))]
    .sort((a, b) => b - a)
    .map((p) => ({ value: String(p), label: String(p) }));

  const columns = buildChannelColumns({
    t,
    isAdmin,
    canWrite,
    prioOptions,
    userTags,
    bumpPriority,
    setPriority,
    onHide: (c) => patch.mutate({ id: c.id, body: { hidden: !c.hidden } }),
    onDeep: (c) => patch.mutate({ id: c.id, body: { deep_requested: !c.deep_requested } }),
    onReset,
    onUnsub,
    onView,
    toggleTag,
    createAndAttachTag,
    onFilterByTag,
    suggestionsFor,
    onAcceptSuggestion: acceptSuggestion,
    onDismissSuggestion: dismissSuggestion,
  });

  // Status chips sit in the table's controls row (next to paging) — compact and close to
  // where they act.
  const syncFilter = typeof filters.sync === "string" ? filters.sync : "";
  const statusChips = (
    <FilterChipGroup
      ariaLabel={t("channels.filters.syncLabel")}
      className="flex flex-wrap items-center gap-1.5"
      options={SYNC_CHIPS.map((c) => ({ value: c.value, label: t(c.labelKey) }))}
      value={syncFilter}
      onChange={(sync) => setFilters({ ...filters, sync })}
    />
  );

  // The catalog-wide stats collapse into a compact "Stats" hover chip (right of the tab row, subscribed
  // only) instead of a crowded inline row.
  const statsBlock = s ? <ChannelStatsPopover status={s} /> : null;

  // Catalog-wide, occasional actions — tucked into a shared ⋯ overflow menu so they stop crowding the
  // tags row. Pending mutations keep the item visible but disabled, with a spinning icon.
  const catalogActions: ActionMenuItem[] = [
    {
      id: "sync",
      label: t("channels.syncSubscriptions"),
      title: t("channels.syncSubscriptionsHint"),
      icon: <RefreshCw className={`h-4 w-4 ${syncSubs.isPending ? "animate-spin" : ""}`} />,
      onSelect: () => syncSubs.mutate(),
      disabled: syncSubs.isPending,
    },
    {
      id: "backfill",
      label: t("channels.backfillEverything"),
      title: t("channels.backfillEverythingHint"),
      icon: <History className={`h-4 w-4 ${deepAll.isPending ? "animate-pulse" : ""}`} />,
      onSelect: () => deepAll.mutate(),
      disabled: deepAll.isPending,
    },
  ];
  const actionButtons = (
    <ActionMenu ariaLabel={t("channels.actionsLabel")} items={catalogActions} />
  );

  // Table / cards density — shared by the subscribed + discovery tables (blocked is a chip list, no
  // layout to switch). Rides the same generic ViewSwitcher the feed uses.
  const layoutOptions: ViewOption<ChannelLayout>[] = CHANNEL_LAYOUTS.map((id) => ({
    id,
    label: t("channels.layout." + id),
    icon: LAYOUT_ICON[id],
  }));
  const layoutSwitcher = (
    <ViewSwitcher
      value={layout}
      options={layoutOptions}
      onChange={setLayout}
      label={t("channels.layoutLabel")}
      labelClassName="hidden lg:inline"
    />
  );
  const hasLayout = view === "subscribed" || view === "discovery";
  // In cards there are no column headers to sort by, so a dropdown drives the SAME shared sort state
  // the table header uses (table ↔ cards stay in sync). Table mode keeps the header clicks.
  const sortControl = (
    <ColumnSortControl
      columns={columns}
      sort={sort}
      onChange={setSort}
      label={t("channels.sort.label")}
      defaultLabel={t("channels.sort.default")}
      ascLabel={t("channels.sort.asc")}
      descLabel={t("channels.sort.desc")}
    />
  );
  // The card layout paginates like the table (a page of cards + a pager), rather than one long
  // infinite scroll. Slice the sorted rows; the Pager reports page/size changes.
  // Only computed for cards: in table mode DataTable sorts and slices internally, so doing it here
  // too would copy+sort the whole ~300-row array on every render for a result nothing reads.
  const isCards = layout === "cards";
  // Cards have no column headers, so apply the shared column filters (sync + any funnel set in table
  // mode) here via the exported predicate — the same filterRows DataTable runs internally — then sort.
  const sortedChannels = isCards
    ? sortRows(filterRows(syncedChannels, columns, filters), columns, sort)
    : syncedChannels;
  const {
    paged: pagedCards,
    pagerProps,
    resetPage,
  } = useCardPager(sortedChannels, LS.channelCardSize, isCards);
  // Changing what you're looking at starts over at the first page, the way DataTable resets its own
  // page on a filter/sort change. Deliberately NOT keyed on the row count: the qk.channels() query
  // refetches on window focus and after every sync, so a catalogue that merely gained a channel would
  // otherwise yank you off page 7 for something you didn't do — a list that shrank past your page is
  // handled by the hook's clamp instead.
  useEffect(() => {
    resetPage();
  }, [filters, search, sort, resetPage]);
  const cardPager = <Pager {...pagerProps} />;

  const viewTabs: TabDef[] = useMemo(
    () =>
      (["subscribed", "discovery", "hidden", "blocked"] as ChannelsView[]).map((v) => ({
        id: v,
        label: t(`channels.tabs.${v}`),
      })),
    [t],
  );
  const tabs = (
    <div className="px-4 pt-2 max-w-384 mx-auto flex items-center justify-between gap-4 flex-wrap">
      <Tabs
        tabs={viewTabs}
        active={view}
        onChange={(id) => setView(id as ChannelsView)}
        className="flex flex-wrap items-center gap-1"
      />
      <div className="flex items-center gap-3">
        {view === "subscribed" && statsBlock}
        {view === "subscribed" && layout === "cards" && sortControl}
        {hasLayout && layoutSwitcher}
      </div>
    </div>
  );

  return (
    <>
      {/* The tab bar is always fixed chrome (it portals into the shell's fixed band, so it never
        scrolls and doesn't jump between tabs). On Subscriptions the stats/description/tags ride
        with it, and the status-chip + pager row lands just below (DataTable's controlsInBand). */}
      <PageToolbar>
        {tabs}
        {view === "subscribed" && (
          <div className="px-4 pt-2 pb-2 max-w-384 mx-auto">
            {/* One non-wrapping row: the TAGS editor trigger (left) + the tag-filter chip lane (folds
          overflow into "+N") + Clear, then the catalog "…" actions pinned right. It never wraps, so the
          "…" menu always stays on the first line. Channel-name search lives in the shared top SearchBar. */}
            <div className="flex items-center gap-2 min-w-0">
              {/* The "TAGS" label IS the tags-editor trigger (pencil), replacing the separate
                  "Manage tags" button; the tooltip explains what tags are + that it's clickable. */}
              <Tooltip hint={t("channels.tags.yourTagsHint")}>
                <button
                  onClick={() => setTagManagerOpen(true)}
                  className="shrink-0 inline-flex items-center gap-1.5 rounded-lg border border-border px-2 py-1 text-xs uppercase tracking-wide text-muted transition hover:border-accent hover:text-accent"
                >
                  <Pencil className="h-3 w-3" />
                  {t("channels.tags.label")}
                </button>
              </Tooltip>
              <TagFilterChips chips={tagFilterChips} className="flex-1" />
              {tagFilter.length > 0 && (
                <button
                  onClick={() => setFilters({ ...filters, tags: [] })}
                  className="shrink-0 text-xs px-2 py-1 text-muted hover:text-accent transition"
                >
                  {t("datatable.clear")}
                </button>
              )}
              {/* Suggested-tags affordance (E8·S4): a sparkle count of the visible suggestions, with a
                  one-click bulk-accept for the high-confidence ones. The per-row ghost chips handle the
                  rest. Hidden when there's nothing to suggest. */}
              {visibleSuggestions.length > 0 && (
                <div className="shrink-0 flex items-center gap-1.5">
                  <Tooltip hint={t("channels.tags.suggestionsHint")}>
                    <span className="inline-flex items-center gap-1 rounded-lg border border-dashed border-accent/50 px-2 py-1 text-xs text-accent/90">
                      <Sparkles className="h-3 w-3" />
                      {t("channels.tags.suggestionsCount", { count: visibleSuggestions.length })}
                    </span>
                  </Tooltip>
                  {highConfidence.length > 0 && (
                    <button
                      onClick={acceptAllHighConfidence}
                      className="text-xs px-2 py-1 rounded-lg border border-border text-muted hover:border-accent hover:text-accent transition"
                    >
                      {t("channels.tags.acceptAllHigh", { count: highConfidence.length })}
                    </button>
                  )}
                </div>
              )}
              <div className="shrink-0">{actionButtons}</div>
            </div>
          </div>
        )}
        {/* In table mode the status chips + pager ride in DataTable's own in-band controls row. The card
        layout has no such row, so surface the same status chips (left) and its pager (right) here. */}
        {view === "subscribed" && layout === "cards" && (
          <div className="px-4 pb-2 max-w-384 mx-auto flex items-center justify-between gap-3 flex-wrap">
            {statusChips}
            {cardPager}
          </div>
        )}
      </PageToolbar>
      {tagManagerOpen && (
        <TagManager onClose={() => setTagManagerOpen(false)} onFocusChannel={onFocusChannel} />
      )}

      {view === "discovery" ? (
        <ChannelDiscovery
          canWrite={canWrite}
          search={search}
          onOpenWizard={onOpenWizard}
          onViewChannel={onViewChannel}
        />
      ) : view === "blocked" ? (
        /* Blocked channels — videos from these are hidden everywhere and dropped from live search. */
        <div className="px-4 pb-4 pt-3 max-w-384 mx-auto">
          <ExcludedChannelList
            channels={blockedQuery.data ?? []}
            icon={<Ban className="w-4 h-4 text-muted" />}
            title={t("channels.blocked.title")}
            hint={t("channels.blocked.hint")}
            emptyText={t("channels.blocked.empty")}
            actionLabel={t("channel.unblock")}
            actionIcon={<X className="w-3.5 h-3.5" />}
            onAction={(id) => unblock.mutate(id)}
            onView={(c) => onViewChannel(c.id, c.title ?? t("channels.row.thisChannel"))}
          />
        </div>
      ) : view === "hidden" ? (
        /* Hidden channels — kept out of the Mine feed but still in the shared Library; managed here
           instead of dimmed in the subscribed table. Same card grid as Blocked (ExcludedChannelList). */
        <div className="px-4 pb-4 pt-3 max-w-384 mx-auto">
          <ExcludedChannelList
            channels={hiddenChannels}
            icon={<EyeOff className="w-4 h-4 text-muted" />}
            title={t("channels.hidden.title")}
            hint={t("channels.hidden.hint")}
            emptyText={t("channels.hidden.empty")}
            actionLabel={t("channels.hidden.unhide")}
            actionIcon={<Eye className="w-3.5 h-3.5" />}
            onAction={(id) => patch.mutate({ id, body: { hidden: false } })}
            onView={(c) => onViewChannel(c.id, c.title ?? t("channels.row.thisChannel"))}
          />
        </div>
      ) : (
        /* No top padding: the sticky header sits flush at the scroller top so it doesn't shift when
         `position: sticky` engages on the first scroll (the band's controls row above gives the
         visual gap). */
        <div className="px-4 pb-4 max-w-384 mx-auto">
          {/* Channel table — only the rows scroll; the header row is sticky, and the controls row
            (status chips + pager) rides in the fixed band right above it (controlsInBand). The
            card layout swaps the table for a virtualized grid over the same rows (its pager and
            status chips ride in the fixed band above instead). */}
          {channelsQuery.isError && !channelsQuery.data ? (
            <StateMessage tone="error" onRetry={() => channelsQuery.refetch()}>
              {t("common.loadError")}
            </StateMessage>
          ) : channelsQuery.isLoading ? (
            <LoadingState label={t("channels.loading")} />
          ) : layout === "table" ? (
            <DataTable
              rows={syncedChannels}
              columns={columns}
              rowKey={(c) => c.id}
              persistKey={accountKey(LS.channelsTable) ?? undefined}
              controlsPosition="both"
              controlsLeading={statusChips}
              controlsInBand
              controlsBandClassName="px-4 max-w-384 mx-auto"
              sort={sort}
              onSortChange={setSort}
              filters={filters}
              onFiltersChange={setFilters}
              fixedLayout
              emptyText={t("channels.empty")}
            />
          ) : (
            <ChannelLayoutGrid
              rows={pagedCards}
              columns={columns}
              rowKey={(c) => c.id}
              leadKey="priority"
              aboutKey="about"
              actionsKey="actions"
              emptyText={t("channels.empty")}
            />
          )}
        </div>
      )}
    </>
  );
}