Filter table with client side selection

[BrettJephson]

Choosing an option in a tab or a select button now narrows any table or card grid whose Select column offers it. For example, a Platform column follows a macOS tab; a Status column is left alone.

Matching is on the option's label, slugified the way tab titles are, so a table and the tabs beside it agree. Most recent wins when a column offers several active options.

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 0a2bd12

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-k3v2pkd85-gitbook.vercel.app	✅
Cloudflare	https://3a2a1abe-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-k3v2pkd85-gitbook.vercel.app/url/gitbook.com/docs	https://3a2a1abe-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-k3v2pkd85-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://3a2a1abe-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2-cloudflare (Inspect)	👍 Approved by Brett Jephson	2 changed, 2 ignored	Sep 21, 2026, 1:03 PM
customers-v2-vercel (Inspect)	👍 Approved by Brett Jephson	2 changed, 3 ignored	Sep 21, 2026, 1:01 PM
v2-cloudflare (Inspect)	👍 Approved by Brett Jephson	5 changed, 1 ignored	Sep 21, 2026, 1:04 PM
v2-vercel (Inspect)	👍 Approved by Brett Jephson	1 changed, 1 ignored	Sep 21, 2026, 1:04 PM

[github-actions]

Style invalidation on a large API reference

Elements restyled by opening one popup on the Snyk API reference. A share near or above 100% means the insertion restyles the whole document.

interaction	restyled	page	share	budget
openapi-select	8	10,804	0.1%	25%	✅
search	631	10,804	5.8%	125%	✅

[BrettJephson]

Blocker found in review — must fix before this leaves draft.

The slug filter can narrow a table with no visible indication and no way to clear it. shouldShowTableSearch is searchOverride ?? (recordCount >= 7 && viewType === 'grid'), so the filter controls are absent in three common cases:

• cards view — always, by default
• grid tables under 7 rows
• any table where the author set search: false

In those cases a reader sees fewer rows than the author wrote, with nothing saying why. I had argued earlier that "the tab that set the slug is the control" — that's wrong: the tab is often on a different page, so the reader arrives at an already-narrowed table with no nearby control at all.

Second half, and the sharper one: the reader's own filter change is component state while the slug is in localStorage, so a reload always reasserts the slug filter. The reader can't override it durably.

Proposed fix: show a "Filtered to macOS · Clear" affordance whenever the slug filter is active, independent of the search bar, and have Clear call the store's existing deactivate(slug) so the override persists without new storage.

[BrettJephson]

Blocker addressed in 4604ff4.

• A TableSelectionFilter notice renders independently of the search bar — "Filtered to macOS" with a Clear — so cards, short grids and search: false tables get it too. That was the whole invisible-filter class, not just the cards case.
• Clear calls the store's deactivate, not local state. The selection is what persists, so dropping it there is what stops the filter returning on the next load. It is site-wide by design: a tab elsewhere on the page reverts to its default too.
• The applying effect now reconciles against the columns it narrowed last instead of only ever adding, so a new selection — or a clear — undoes the previous one. Without that, clearing left the old filter applied.

New translation key table_filtered_by_selection added across all 39 language files, per the existing convention.

This also answers the earlier note about mirroring the store into state: the effect now synchronises with an external store and reconciles its own previous writes, which is the sanctioned use rather than mirroring a derived value.

Still open from the original list: the brief unfiltered paint before the filter applies. Tabs avoid it with pre-paint CSS; rows have no equivalent yet.