Repository navigation
Releases
Releases · anindosarker/shadcn-table
v0.9.4
Added
Spec 39 Typed filters wait for you to finish typing
- A new hook,
useST_DebouncedCallback(fn, wait), returnsrun,flush,cancelandisPending; it calls the latestfn, readswaiton each call and flushes a pending call on unmount. Typed column filters (text, number, autocomplete, each range end) and the global search use it (D88). - Table options
columnFilterDebounceMsandglobalFilterDebounceMsand column optionfilterDebounceMsset the wait; the default is 500 ms for both, with or withoutmanualFiltering(was 200 ms, 400 ms for filters and 250 ms, 500 ms for search) (D88). - Enter and blur apply a typed filter or search at once. The field's clear button, Clear filters, Remove filter, the column menu clear, a stored view, the search clear button, Escape and closing the search drop the pending call, so a cleared filter no longer comes back (D88).
- Date, datetime and time filters apply a complete value: a typed value applies on Enter, blur or when its chip editor closes, a value picked in the native picker at once, never a half-typed year (D88).
- A controlled
state.columnFiltersrebuilt on every parent render (equal content, new array) no longer drops a typed filter inside the wait. - The chips mode editor focuses its input once when it opens, not on every table change: typing Min and then clicking Max no longer moves focus back to Min.
- Select and multi-select filters apply the picked value at once instead of after a 1 ms timer.
Changed
Spec 45 Filter Mode caption gap
- The "Filter Mode: " caption under a filter input sits 6 px below it instead of 3 px (
mt-1.5), in the text field, the range fields and the range slider on the three bases (D85).
Spec 49 Home hero wording
- The home hero line above the
shadcn-tableheading reads "The open-source shadcn data table for React, built on TanStack Table." and the sentence below it reads "A production-ready data table library built with TanStack Table and shadcn/ui. Sorting, filtering, pagination, grouping, pinning, virtualization, and more, all built in." (D90). The heading, the title tag and the meta description are unchanged.
Fix D91
- The table context and the defaults context move to a
context/folder, one file per context (three bases).hooks/stTableHook.tsxbecomescontext/ST_TableContext.tsx(tableContext,useTableContext,useSTContext,ST_TableProvider) and its factorycreateSTTableHookmoves tohooks/createSTTableHook.ts;hooks/useST_Defaults.tsxbecomescontext/ST_DefaultsContext.tsx(ST_DefaultsContext,ST_DefaultsProvider,useST_Defaults). Every exported name is unchanged, so imports throughindex.tskeep working; an import from one of the old file paths moves to the new one. A project that installed the library through the shadcn CLI keeps its two old files after an update until it deletes them.
Fixed
Spec 40 Date filter compare
- Date, datetime and time filters now work on columns that hold
Datevalues (D81):equals,notEquals,greaterThan,greaterThanOrEqualTo,lessThan,lessThanOrEqualTo,betweenandbetweenInclusiveread aYYYY-MM-DDfilter value as local midnight and compare by calendar day, anHH:mmvalue by time of day and aYYYY-MM-DDTHH:mmvalue to the minute (to the second when the value has seconds). Before, they compared the filter string with the date's text form, so "greater than" kept every row and "less than" none. A string row value holding a full ISO date and time (2025-11-02T14:15:00.000Z) compares the same way, as a date. Filter values stay strings; number columns and date-onlyYYYY-MM-DDstring columns filter as before (three bases). - A column with
filterVariant: 'date','datetime'or'time'and nofilterFnfilters byequals(by day for a date) instead offuzzy, which matched noDaterow. greaterThan,lessThanand the other comparison modes on a column of ISO date-time strings (2025-11-02T14:15:00.000Z) now compare dates by local day, time or minute instead of comparing text; a date column of such strings without afilterFnmatches by day instead of by prefix.
Spec 40 React Query route dates
- The React Query example's Last Login filter shows only matching rows in every mode it offers (D81). The example now offers the eight date comparison modes and sends the chosen mode with each filter; its mock route compares by that mode (it always kept later dates before), reads a
YYYY-MM-DDvalue as local midnight, compares by calendar day, and keeps its randomlastLogindates for the life of the server instead of drawing new ones on every request (three bases).
Spec 41 Range filter editors fit and accept input
- In the chips mode, the value editor of a time, date or datetime range (the
*-rangevariants or a between mode) is 308 px wide instead of 260 px, so both Min and Max fields and their picker icons lie inside it (capped at the viewport width less 1 rem); every other filter keeps the 260 px editor (D86, three bases). Typing into both fields applies the range on Enter or blur since spec 39.
Spec 42 React Aria multi-select filter opens on click
- On React Aria a click into the multi-select filter's input opens its option list, as on Base UI and Radix; before, only ArrowDown or the chevron opened it (D82).
Spec 43 Escape closes the filter editor after a select pick
- After a value is picked in a select filter, one Escape closes the chips mode value editor on Base UI and React Aria, as on Radix; an Escape while a select or combobox list is open closes only the list (D83).
Spec 44 React Aria select filter chevron
- On React Aria the select filter's chevron sits at the right end of its input instead of right after the placeholder (D87).
Fix Q76
- The docs app's type check (
types:checkand the one inbuild) no longer runs out of memory at Node's default heap. The three library copies declare the same@tanstack/react-tablefeature maps, so in one program every copy's types were compared with the first copy's (21.7M instantiations, about 4.3 GB of heap against a 4.2 GB limit). The build's program now holds the app and the radix copy; the newtypes:baseschecks the base and aria copies with their examples, one copy per program as an install has it (14.4M instantiations, peak heap about 1.9 GB). The same files are checked as before.
Docs
Spec 46 Live demo with ten columns
- The live demo on the Introduction and Usage pages has ten columns (D84): First Name, Last Name, Email, City, State, Department, Age, Salary, Joined, Status. Department has a select filter and Salary a range filter shown in US dollars; the four filters of before work as they did. At the docs content width the table scrolls sideways, so pinning, hiding and reordering have columns to act on; no column is pinned by default (three bases).
Spec 47 Comparison page
- A Comparison page, last in Getting Started, compares shadcn-table with TanStack Table, the shadcn/ui data-table recipe, Material React Table and AG Grid; every cell is sourced from the project's own docs or repository, and the page
<title>names the compared libraries through the new optionalsearchTitlefrontmatter field (D71).
v0.9.3
Added
Spec 26 Home page Open Graph image
- The home page has a social preview image:
app/opengraph-image.tsxrenders a 1200x630 PNG card like the docs cards, and Next.js addsog:imageandtwitter:imageto/from it (D55).
Spec 28 Security response headers
- Every response of the docs site carries
X-Content-Type-Options: nosniff,Referrer-Policy: strict-origin-when-cross-origin,X-Frame-Options: SAMEORIGINandPermissions-Policy: camera=(), microphone=(), geolocation=()(D57). NoContent-Security-Policyyet.
Spec 25 JSON-LD structured data
- The home page and every docs page carry Schema.org JSON-LD:
/aWebSiteand aSoftwareSourceCode, each docs page aTechArticleand aBreadcrumbList(Docs > section > page, absolute URLs), typed withschema-dts(D54).
Changed
Spec 30 API page payload
- The API option tables (table, column and state options; table, column, row and cell instance APIs, and their subsets on the guide pages) render a light HTML table first, name, type and description per option with the
<name>-propstyle anchors, and hydrate into the interactive table with search, copy and pinning as before (D59)./docs/api/table-optionsHTML drops from 1.94 MB to 268 KB.
Spec 30 Home JavaScript
- The home page loads less JavaScript: the nav and hero links prefetch the docs on hover, touch or focus instead of as soon as they show, so the docs route's scripts no longer download with the home page. Lighthouse (desktop) script transfer for
/drops from 711 KB to 580 KB;jspdf,jspdf-autotableandrechartsstay out of the home load (D59, D62).
Spec 33 Home title, hero line and description
- The home page title and
og:titleread "shadcn-table: React Data Table for shadcn/ui and TanStack"; docs page titles keep<page> | shadcn-table. The hero line says "The open-source React data table for shadcn/ui, built on TanStack Table."; the H1 stays "shadcn-table" (D73). - The search description of
/(description,og:description,twitter:description) reads "Open-source React data table for shadcn/ui, built on TanStack Table. Sorting, filtering, pagination, grouping, pinning. Installs as source via shadcn CLI." (D73). It is one sharedsiteDescription, read by the root layout, the home page metadata and JSON-LD, the OG image and thellms.txtsummary (D76).
Spec 34 posthog-js loads after hydration
- Analytics load after the page is interactive: posthog-js is fetched in its own chunk on the first idle moment or interaction, and events raised before that are queued and sent on init. The home page's first script load drops from 421 KB to 317 KB (Lighthouse desktop, before the deferred loads) (D70).
Spec 35 Example sources are read per example
- Docs builds no longer trace the whole examples tree: the example generator writes each base's code-view sources to one file, read from a fixed path, so the build's "file pattern matches 10568 files" warning is gone. The code view shows the same files (D69).
Spec 36 validate-repo fails on a stale generated registry
- The repository check (
pnpm test validate-repo, run by CI) regenerates the registries withpnpm -w registry:build,registry:itemsandregistry:hostedand fails on a diff, naming each stale tracked file, such asapps/shadcn-table-docs/registry.jsonafter an example description changed without a regeneration (D68).
Fixed
Spec 29 Markdown delivery and llms.txt shape
- A docs page served as Markdown (
Accept: text/markdownor/llms.mdx/docs/.../content.md) now answersVary: Acceptandtext/markdown; charset=utf-8, so a cache no longer hands Markdown to a browser or HTML to an agent (D58). /llms.txtfollows llmstxt.org: the# shadcn-tableheading, a one-line summary, then one section per docs folder (Getting Started, API Reference, Quick Examples, Guides) with a link and description per page, on absolute URLs (D58)./llms-full.txt, the per-page Markdown and the "Copy page" button carry plain Markdown: MDX imports, JSX components and frontmatter are gone; headings, prose, component prose (a callout body) and code blocks stay (D58).
Spec 24 Canonical URLs and trailing-slash redirect
- Every docs site page names its canonical URL: the root metadata sets
alternates.canonicalto./, so/and each docs page carry one<link rel="canonical">with their own slash-less URL onNEXT_PUBLIC_SITE_URL. A path with a trailing slash answers 308 to the slash-less path; the PostHog proxy under/ingestkeeps its slash (D53).
Fix D66 The docs proxy runs only on docs paths
- The docs site's
proxy.ts(Markdown delivery forAccept: text/markdown) runs only on docs paths instead of on every request, so pages, assets and the/ingestproxy no longer pass through it; a docs URL still answers Markdown to an agent (D66).
Fix Docs build type check
- The docs builds and
types:checkreadtsconfig.build.json(the preview buildtsconfig.preview.json), which exclude the other build folders, so a stale.nextor.next-previewfolder naming deleted routes can no longer fail them.
Fix D77 Filter mode menu position in the popover filter
- With
columnFilterDisplayMode: 'popover'on Base UI and Radix, the filter mode menu opens next to its "Change filter mode" button instead of several hundred pixels away; the menu's anchor renders indocument.body, out of the popover's transformed positioner. React Aria was already right (D77).
Fix D79 Docs app drops the unused zod dependency
- The docs app no longer lists
zodas a dependency; nothing in it importszodsince spec 32 removed the page byline (D79).
Fix D80 Filter mode menu opened during the popover animation
- A click on "Change filter mode" while the filter popover still animates in now opens the menu next to the button: the menu's anchor is measured again when an animation around it ends, and on React Aria it renders in
document.bodylike on Base UI and Radix (D80). React Aria showed the menu about 117 px off before.
Docs
Spec 31 Page frame and new pages
/docsredirects permanently (308) to the Introduction, and the sidebar's last entry links the changelog (D60).- New guide: "TanStack Table with shadcn/ui", last under Fundamentals (D60, D72).
- The Introduction shows the install command and the basic example; the getting-started pages have new descriptions (D60).
Spec 32 Docs wording
- Inherited typos fixed on six pages: the Detail Panel, Lazy Detail Panel and Lazy Sub Rows example descriptions, and the Column Ordering, Editing and Column Size guides (D74).
Fix D78 Richer live demo on Usage and Introduction
- New example
live-demo(registry itemexample-live-demo, all three bases): 20 members with text filters on First Name and Last Name, a select filter on State, a range filter on Age, a date filter on Joined and a multi-select filter on Status (D78). - The Usage page's Live Example and the Introduction's demo show it in place of the Basic Example; the tutorial steps and the Basic Example itself are unchanged (D78).
v0.9.2
Added
Spec 21 Sitemap and robots for the docs site
- The docs site serves
/sitemap.xml(the home page and every docs page, absolute URLs onNEXT_PUBLIC_SITE_URL) and/robots.txt(allow all, disallow/ingest/and/r/, sitemap URL) from Next.js metadata routes (D50).
Removed
Spec 22 Remove the /dev preview routes
- The docs site no longer serves the
/devhomepage variant index and the/dev/themeand/dev/theme/1to/dev/theme/9theming previews; they return 404. Their dev-only theme-demo components are deleted with them; git history keeps them.
v0.9.1
Added
Spec 12 Stored view persists rows per page
persistViewSettingsstores rows per page (D25):ST_StoredViewgainspageSize?: number, saved on every page size change and applied at mount overinitialState.pagination.pageSize, on the three bases. The page index is not stored, and a page index change alone writes nothing. A stored view withoutpageSize, or with one that is not a positive integer, keeps the initial page size. Reset view returns the page size toinitialState. The view settings guide, the state management guide and thepersistViewSettingsAPI entry list the new field.- A restored rows per page keeps the initial page index instead of remapping it to keep the top row (F22).
- The
PersistenceKeepsPageIndexplay covers it: a table on its third page with a stored rows per page remounts on the third page (D33).
Spec 14 ST_DefaultsProvider; the docs icon library select
- New:
ST_DefaultsProvideranduseST_Defaults, exported from the library index on all three bases (D27). The provider'siconsprop (Partial<ST_Icons>) applies to every table below it:useST_TableOptionsmergesST_Default_Icons, then the nearest provider'sicons, then the table's owniconsoption, which still wins key by key. Nested providers merge over their parent; a table outside any provider behaves as before. TheST_Defaultstype is added besideST_Icons. Documented in the ST Components API page and the custom icons guide; theProviderIconSetstory covers it. - Docs: the theme panel's Icon Library select is enabled and offers Lucide, Tabler, Phosphor, Hugeicons and Remix Icon. A pick switches the icons of every example table (the home demo and the docs examples, all three base copies), persists with the rest of the theme config, and Reset returns to Lucide; Random keeps the current icon set. The docs chrome stays Lucide.
pnpm lib:install <base>also installs the four icon set maps ascomponents/ui-<base>/shadcn-table/icons/<set>.ts, loaded only once picked.@tabler/icons-react,@phosphor-icons/react,@hugeicons/react,@hugeicons/core-free-iconsand@remixicon/reactare new dependencies of the docs app.
Changed
Spec 19 PR Summary reads job outputs
- Every test job hands its record to PR Summary as a job output instead of the artifact
test-out-<job>(D38): a last step (if: always()) runstools/release/record-output.mjs, which prints thetest/.out/record as one line<key>=<JSON>with at most five errors of 400 characters each, appended to$GITHUB_OUTPUT. Lint, Validate Repo and Validate PR outputrecord; Typecheck, Storybook Tests and Docs E2E Tests outputbase,radixandaria, Installation E2E one output per scenario, each mirrored underworkflow_call.outputs. PR Summary passestoJSON(needs)asNEEDStopr-summary.mjs, whose newrecordsFromNeedsreads every output (a local run withoutNEEDSstill readstest/.out/). A failed leg's output still reaches the caller (GitHub run 42509826313). Thetest-out-*uploads ofpr.yml,typecheck.yml,storybook-tests.ymlanddocs-e2e.ymland PR Summary's download go;installation-e2e.ymlkeeps its upload, which carries the captures of the reference refresh.
Spec 18 PR Summary: grouped table, failures, changelog
- The sticky PR Summary comment (
tools/release/pr-summary.mjs) is a grouped table (D37): the PR title, one line with the release label, the run link and the status (all green, jobs failed or skipped), oneJob | Resulttable with a bold group row per matrix job and its bases or scenarios under it, a collapsed block listing every error line of the failed jobs, and a changelog section with the## Unreleasedcounts by heading and the entry titles. Without## Unreleasedit reads the top version section. The Prepare Release row of the draft is left out: the comment is written before that job runs. - On a label event the rows of the other jobs and the failures block are kept; the title, the status line, the Validate PR row and the changelog section are rebuilt.
Spec 16 CI: test jobs skip the version bump commit
- A new first job of
pr.yml,head, reads the pull request's head commit and setsbumpedwhen it is thechore: version <v>commit Prepare Release pushes asgithub-actions[bot](D35). On that commit Typecheck, Storybook Tests, Docs E2E Tests and Installation E2E skip every matrix leg (askipinput on the four called workflows), Lint and Validate Repo skip, Validate PR and PR Summary still run, and Prepare Release is skipped with its needs, so the bump push runs no second test pass and prompts nobody. Any other head runs every job as before.
Spec 17 CI: Node 24 action majors
- Every
uses:in.github/workflows/*.ymlmoves to the major that runs on Node 24 (D36):actions/checkout@v7,actions/setup-node@v7,actions/upload-artifact@v7,actions/download-artifact@v8,actions/cache@v6,pnpm/action-setup@v6. Nowith:input changes; pnpm still comes frompackageManager, and the jobs keepnode-version: 22. The "Node.js 20 is deprecated" annotations of each run go away.
Fixed
Fix F22 Restoring a stored rows per page remaps the page index
- A stored rows per page restored at mount keeps the initial page index:
applyViewsets the page size throughsetPaginationinstead ofsetPageSize, which remapped the page index to keep the top row (three bases).
Docs
Spec 11 Persistent view example: ten rows
- The persistent view example opens at 10 rows per page instead of 50 on every base (D24, F14); the stored view still does not keep the page size. The docs E2E check of
/docs/examples/persistent-viewclears the stored view, reloads and asserts 10 body rows and a rows-per-page select reading 10.
Spec 08 Theme panel: Copy and Import removed
- The theme panel drops the Copy menu (Copy CSS, Copy preset code) and the Import popover (D21); the toolbar row keeps Undo and Redo, the Presets row Random and the preset select.
encodeConfig,decodeConfigandimportPresetare gone; Random still picks from create's curated presets half the time.
Spec 13 Docs parts carry the design-system hooks
- Style, Menu Color and Menu Accent in the docs theme panel now reach the docs parts (D26).
pnpm lib:install <base>gains a second phase: every shadcn part it installs undercomponents/ui-<base>/is replaced by its hooked source from shadcn-ui/uiapps/v4/registry/bases/<base>/ui/at a pinned commit (SHADCN_UI_SHA), with the imports pointed at the docs folders and each icon placeholder turned into its Lucide icon, so the parts carry thecn-*classes the style layers target andcn-menu-targetfor the menu color loop. The library copy inshadcn-table/is unchanged. The docs E2E check of/docs/guides/view-settingspicks a Style, Menu Colorinvertedand Menu Accentboldin the theme panel and reads the open menu.
Spec 09 Theme panel: shortcut row, Mod+Z undo
- One row under the theme panel's header holds Reset (
Shift+R), Undo (Mod+Z), Redo (Mod+Shift+Z), Random (R) and Next preset (C) (D22): icon buttons named by their label, each with a tooltip carrying the label and its key, since the labeled buttons do not fit the 360 px panel. The header keeps the title and the close button, the Presets row the preset select. Undo moves fromPtoMod+Z(Cmd on macOS, Ctrl elsewhere), redo gainsMod+Shift+Z, andPis no longer bound.
Spec 10 Theme panel: color picker
- Each token swatch in the theme panel's Colors tab is a button (
Pick <token>) that opens a popover with areact-colorfulhex picker above a copy of the token's text field (D23, F13). Dragging writes the token live as hex; closing the popover records one undo step, soMod+Zreturns to the value from before it opened. Typed values keep one undo step per change (A10), and an invalid value still applies nothing.react-colorful5.8.1 is a new dependency of the docs app.
Spec 15 Docs: one style sheet per style, loaded on demand
- Docs: the root stylesheet no longer carries the eight theme styles (D29).
lib/build-styles.mjscompiles eachstyles/style-<name>.cssagainst the docs' Tailwind theme intopublic/styles/style-<name>.css(generated, git-ignored; run bypredevandbuild, minified inbuild), and every page links only the active style's sheet: the pre-paint script links the stored or default style render-blocking, and a style change loads the new sheet before it switches thestyle-<name>class. The root stylesheet of/drops from about 2.8 MB to 337 KB; opening the theme panel and toggling light and dark stay under 300 ms of long tasks.@tailwindcss/nodeis a new devDependency of the docs app. - Docs E2E: the perf budgets are 600 ms under --ci (F28).
v0.9.0
Changed
Epic 01 Filtering
- Filter modes are on by default (D4):
enableColumnFilterModesdefaults totrue, so the mode picker shows in the chips, subheader and popover display modes without the flag;enableColumnFilterModes: falseon the table or a column hides it. Material React Table defaults it off; this is a deliberate deviation. The mode lists stay as they were: every mode for text, autocomplete, select, date, datetime and time, the two between modes for the range variants, none for range-slider and checkbox. A chip now names the mode ("Status fuzzy: Done"). - A multi-select filter offers Includes any (
arrIncludesSome, still the default), Includes all (arrIncludesAll) and Excludes (the newarrIncludesNonefilter fn) after its 14 modes;ST_LocalizationgainsfilterArrIncludesNone,filterArrIncludesSomereads "Includes any", and every locale carries the three labels. - Removing a filter chip, or "Clear filters", puts the column back on its initial filter mode instead of the first mode of its list, so a multi-select or select column keeps its default fn.
- Fixed (D1, F1): a select filter with a value shows its chevron left of the clear button instead of under it; the trigger takes
ltr:pr-9 rtl:pl-9in place ofpe-9, which lost to the shadcn trigger'spr-2.
Epic 02 Pagination
- The
pagesfooter, the default, shows the row range between Rows per page and the page buttons (D6):1-10 of 200, localized, following the filtered count,1-2 of 2on one page. paginationDisplayMode: 'default'is renamed'compact', with no alias (D6): the option type is'compact' | 'custom' | 'pages'and'default'is a type error. The stories, the pagination guide, the API entry and the alternate-pagination example name the compact footer'compact', and the pagination story names drop "Default" (D7).
Epic 03 Resize animation
- A column size reset animates (D5): the double click on the resize handle and the Reset column size menu item mark the table with
data-size-resetting, the header and body cells transition their width back to the default in 200 ms ease-out, and the mark clears on the widthtransitionend. Drags and every other width change stay instant;prefers-reduced-motion: reducegets no transition.
Spec 05 Release approval
- The version bump waits for the owner's approval (D3): the release PR's
prepare-releasejob runs in the GitHub Environmentrelease, whose one required reviewer is the owner, so Prepare Release shows "Waiting for review" until the owner approves the deployment; a rejected review fails the job and pushes nothing. Every otherpr.ymljob stays automatic.
Fixed
Spec 06 Storybook reset
- The deployed Storybook resets each story after its play (D8, F6): the static builds run the play with the Interactions panel logging every step, then remount the story in its initial state; Rerun runs the play and resets again.
storybook dev, vitest and a failing play keep the end state.pnpm test storybook-staticchecks it on a local static build or, with--url, on the deployed site.
Fix F3
- Anchored menus keep their position while they close:
useST_MenuAnchor.tskeeps the last measured anchor box through the exit animation instead of dropping to (0,0), so the filter mode menu no longer jumps the subheader filter row as it fades (three bases).
Fix F11 Dev server clean
- The docs dev server loads
/,/docsand the example pages without errors (D20, F11): the theme panel formats its kbd hints only in the browser, so TanStack Hotkeys no longer warns about a server-formatted label, and the search dialog renders only in the browser, so a theme panel opened before hydration ends no longer causes anaria-hiddenhydration mismatch on the home page.
Docs
Spec 04 Theme customizer
- The palette button in the docs and home navs opens a theme customizer panel on the right (D2) in place of the six-preset dropdown: Copy (theme CSS or preset code), Undo, Redo, Mode, Style, Icon Library, Base Color, Theme, Menu Color, Menu Accent, Presets (Import a preset code, Random, Default plus 42 tweakcn palettes) and the tabs Colors (per-token editing for the current mode), Typography and Other.
- A fresh visitor sees the Emerald look as the
Defaultpreset; a stored choice (st-design-systemin localStorage) applies before first paint and is dropped after 2 days. The oldst-themekey is removed. - Shortcuts through TanStack Hotkeys, each shown as a kbd hint:
Rshuffle,Shift+Rreset,Canother color preset,Pundo; off while typing or while the search dialog is open. - The home theme demo cycles six palettes through the design system. The six
themes/*.cssfiles,lib/theme-presets.tsandcomponents/theme-preset-switcher.tsxare gone.
v0.8.2
Changed
Epic 08 release run
- Validate Production runs the 28 HTTP checks on the deployed site only; the live Docs E2E pass per base is gone (D92): the PR run already ran Docs E2E on the same commit, and the live pass took 26 of the 32 minutes of the 0.8.1 release run.
v0.8.1
Changed
Spec 07.1 gate step
- The release gate is a step of
install.yml(D78): a Next.js app per base (nextjs-base,nextjs-radix,nextjs-ariarows) runspackages/shadcn-table/test/release/gate.mjs(Playwright) againstnext devof the gate pages: zero console warnings and errors, the persisted view marked before first paint and restored, the RTL pinned header and resize handle. - The two default captures per base are compared with the references under
packages/shadcn-table/test/release/reference/bypixelmatch(at most 500 differing pixels); the captures, any diff image andresult.jsonupload as thegate-<base>artifact (D79).install.ymlgains aworkflow_dispatchtrigger to refresh the references.
Spec 07.1 version bump
- One pull request per release,
devintomaster(D83): its last check,version bump (release:prepare), runsscripts/release/prepare.mjs(pnpm release:prepare) once every other job is green, bumps bothpackage.jsonfiles, renames## Unreleasedto the version and the date and commitschore: version <v>todev;release impactreads the labels live, takesmasterPRs fromdevonly and passes the bumped head. release.ymlruns once, on the merge: theversionjob,scripts/release/version-pr.mjsand therelease/nextbranch are gone;decidechooses release or nothing.
Epic 08 Test runner and tests
- One test runner (D85):
pnpm test <name>runs a test fromtest/<name>/(typecheck,lint,storybook-tests,docs-e2e,validate-repo,installation-e2e,validate-pr,validate-production), per base or per scenario, with--list,--all,--changed,--base,--scenarioand--ci; every run ends with one summary line and a JSON record undertest/.out/. - The checks move without changing their assertions:
check-bases,check-iconsandcheck-tailwindbecomevalidate-repo(withshadcn registry validateand the tool unit tests),check-pages.mjsandpage-checks/becomedocs-e2e(it builds and serves the docs on a free agent port without--url), the release smoke becomesvalidate-production, the install shell ofinstall.ymlbecomesinstallation-e2ewith the release gate as its browser phase and the six reference captures undertest/installation-e2e/fixtures/reference/. - The registry scripts move to
tools/registry/, the release scripts totools/release/(decide.mjsischeck-release.mjs,prepare.mjsisprepare-release.mjs), the two previews merge intotools/preview.mjs, and the docsinstall.mjsandexample-map.mjsmove toapps/shadcn-table-docs/lib/.scripts/,packages/shadcn-table/scripts/,packages/shadcn-table/test/andapps/shadcn-table-docs/scripts/are gone, withcheck-aria-warnings.mjsandcheck-storybook.mjs; the rootcheck:*andrelease:preparescripts are removed. playwright,pixelmatchandpngjsare root devDependencies (the package keepsplaywright); the packagestorybook:buildwritesstorybook-static/version.txt, and the Vercel Storybook build runs it.
Epic 08 Tools and workflows
pr.ymlruns twenty-one jobs (D86, D87):Typecheck,Storybook TestsandDocs E2E Testsper base,Lint,Validate Repo,Installation E2Eper scenario andValidate PR, eachpnpm test <name> --ciwith its records uploaded astest-out-<job>;PR Summaryrewrites one sticky comment per PR from those records (the version line, the changelog counts, one line per job, the run link);version-bumpisPrepare Release.install.ymlis folded intoInstallation E2Eand deleted; aworkflow_dispatchwithinstallation-e2e-onlyruns the seven install jobs with--no-diffand uploads the captures.release.ymlruns four jobs:Check Release,Verify Deployment(waits until www and storybook serve the version on/version.txt, then tags),Validate Production(pnpm test validate-production) andPublish Release; the post-merge install jobs are gone.- New tools
tools/release/verify-deployment.mjs,publish-release.mjsandpr-summary.mjs(withpr-summary.test.mjs); the PR template namespnpm test --changed.
Epic 08 Docs and process
CONTRIBUTING.md,coding-standards.md,planning-guidelines.mdand the registry and docs READMEs nametest/,tools/andpnpm test <name>with the CI job names (D88).- Docs E2E page lists follow the docs sections (D89):
getting-started,api,guides,examplesundertest/docs-e2e/lib/, every page once;pnpm test docs-e2e --section <name>runs one. pr.ymlisPR checkswith nine jobs, the four matrices as called workflows (typecheck.yml,storybook-tests.yml,docs-e2e.yml,installation-e2e.yml), check contexts such asTypecheck / Typecheck (base); runs are namedPR checks: <PR title>orPR checks: all,release.ymlisRelease(D90).- Docs E2E runs four browser contexts per section and CI caches the Next build and Chromium, installed without
--with-deps(D91).
v0.8.0
Added
Row drop slide (D57)
- D57: a row drop inside one table slides the rows into their new places and flashes the dropped row with the column drop highlight (
useST_RowFlip); a drop into another table, reduced motion, row virtualization and more than 200 rows skip the slide.
Spec 01
- Options, none with a default:
enableViewSettings,enableSortPopover,enableScrollButtons,enableCellOverflowTooltip,persistViewSettings,nonce,showClearSearchButton,showColumnDragHandle,showSortIndex;columnFilterDisplayModeaccepts'chips'. - Column options:
icon(the column-type icon before the header label) andoverflowTooltip. - Icon keys, with a glyph in the Lucide, Tabler, Phosphor, Hugeicons and Remix editions:
AddIcon,ArrowUpwardIcon,DeleteIcon,GridLinesAllIcon,GridLinesColumnsIcon,GridLinesNoneIcon,GridLinesRowsIcon,LockIcon,PushPinOffIcon,RowNumbersOffIcon,RowNumbersOnIcon,SettingsIcon,SingleLineIcon,StickyHeaderOffIcon,StickyHeaderOnIcon,StripedOffIcon,StripedOnIcon,SwapVertIcon,WrapTextIcon; the grid line glyphs ship asST_GridLinesAllIcon,ST_GridLinesRowsIconandST_GridLinesColumnsIcon. - Localization keys, optional, English only (other locales fall back to English): column menu
sortAscending,sortDescending,filter,pinToStart,pinToEnd,fixedPosition,fixed,hideThisColumn,columnMenu,sortedAscending,sortedDescending; filter chipsaddFilter,filterBy,noColumns,removeFilter,deleteAllFilters,clearFilters,backToColumns,isEmpty,isNotEmpty,showColumnToEditFilter,rangeSummary,yes,no,beforeValue,afterValue; sort editorsort,sortBy,ascending,descending,dragToReorder,removeSortOn,addSort,deleteSort,sortsCount; view settingsviewSettings,columns,density,wrapCellText,singleLineCells,gridLines,stickyHeader,alternatingRowColors,pinToToolbar,unpinFromToolbar,resetView,columnsShown,gridLinesNone,gridLinesRows,gridLinesColumns,gridLinesAll,densityCompact,densityComfortable,densitySpacious; scroll cuesscrollLeft,scrollRight. - State slices:
viewSettings(setViewSettings,resetViewSettings,onViewSettingsChange),filterChips(setFilterChips,onFilterChipsChange) andcolumnFlipPending(setColumnFlipPending);table.refs.tableRefpoints at the<table>. - Helpers:
getST_ColumnDropTargetProps,isColumnDragCancelledandapplyColumnReorderfor column drags; the view storage functionsgetViewSettingsKey,readStoredView,writeStoredView,removeStoredView,subscribeStoredView,getStoredViewSnapshot,getServerSnapshotandescapeForScript. - A column drag ended with Escape or dropped outside the table no longer reorders the columns, from the header grip and from the columns menu.
- The sticky header scroll box height reads
--st-sticky-max-heightwhen the table root sets it.
Spec 02
- The top toolbar sits above the table frame; the frame (
rounded-md border bg-background shadow) holds the scroll box and the bottom toolbar with no inner padding, also in full screen, which now pads the window instead of stripping the frame.stTableLayoutProps.classNamerestores the old box. - Body rows are 40, 48 and 56 px tall at compact, comfortable and spacious with
px-2,px-3andpx-4cell padding; rows are split by hairlines, none under the last row, andviewSettings.gridLinesdraws column lines; hover tints the whole row evenly. The bottom toolbar's top edge is the same hairline; the empty row is 96 px, muted, not italic. - The table root declares the tint tokens
--st-stripe,--st-hover,--st-selectedand--st-edge-shadowwith dark twins; rows and pinned cells read them, and an ancestor orstTableLayoutProps.classNameoverrides them. Pinned inner-edge cells cast the edge shadow towards the scrolling columns. - With
layoutMode: 'grid'data columns share the spare width in proportion to their sizes, while display and pinned columns keep their width; past the frame every column keeps its set width and the table scrolls sideways. Display columns default togrow: false; the row actions column is 48 px with a visually hidden header label and moves through the columns menu (displayColumnDefOptions['st-row-actions']sets it back). enableScrollButtons: trueshows hover chevrons in the header row on a side with hidden columns; a click scrolls 80 percent of the unpinned width.useST_HorizontalOverflowandST_ScrollButtonsare exported for custom layouts.enableCellOverflowTooltip: truetruncates plain text cells on one line and shows the full value in a tooltip only when it is cut off;viewSettings.wrapTextshows the text in full;columnDef.overflowTooltipsets it per column;ST_OverflowTextis exported for custom cells.- The sticky header box caps at
var(--st-sticky-max-height, 70vh)when the header is sticky by choice (enableStickyHeaderorviewSettings.stickyHeader); a header forced sticky by row virtualization keeps the full-height rule. - With
persistViewSettingson, a server-rendered table renders one inline script (with thenonceoption) that marks the rootdata-st-view-pendingandaria-busybefore first paint when a stored view differs from the defaults; the body shows a skeleton bar while marked. Nothing is rendered with persistence off.
Spec 03
- Header look: no band, a medium-weight muted label, the column
iconbefore it, a full-opacity chevron at the end and a static sort arrow only while sorted; 40 px at every density, a hairline between columns only when grid lines arecolumnsorall; the header row shadow and the 0.97 opacity are gone. - The header label and the chevron open the same column menu, a second click on the chevron closes it, and a label click never sorts.
- The column menu lists only what applies, in order: Sort ascending, Sort descending, Clear sort; Filter, Clear filter; Pin to start, Pin to end, Unpin, Reset column size, Group by, Fixed position (disabled, locked columns); Hide. The active sort direction is the one disabled item, and sorting from the menu stacks onto the other columns' sorts. Show all columns leaves the menu (the columns menu has it).
- The resize handle is a full-height hairline: invisible at rest, lit while the pointer is over the header, primary while resizing, reset on double-click; a resize never starts a column drag.
- Columns drag by the header cell where they can be dragged; the grip renders only with
showColumnDragHandle. While a column drags, the other headers slide aside to open a gap and the dragged header sits in it, faded with a dashed outline; on drop the body slides to catch up and the moved column highlights; Escape or a drop outside slides the headers back. Reduced motion keeps the static dashed feedback and the highlight. Near the inner edges of the unpinned area the table scrolls sideways. - Locked columns (
enableColumnOrdering: false) show striped "Fixed" headers only while another column drags. ST_ColumnActionMenuandST_FilterOptionMenuaccept atriggerelement with optionalopen/onOpenChangebesideanchorEl/setAnchorEl, which are now optional.- New exports:
useST_ColumnFlip,useST_DragAutoScroll,ST_TableHeadCellLockedOverlay,getST_ColumnDragHandlers.
Spec 04
- Filter chips (
columnFilterDisplayMode: 'chips'): one chip per filtered column with its icon, label, mode and value; the toolbar filter button and "+ Filter" open a searchable column picker that swaps in place to the value editor (back button, 150 ms glide); Filter in a column menu opens the editor on the header cell; "Clear filters" clears every value and chip.columnFilterDisplayMode: 'subheader'keeps the filter row. - Sort editor (
enableSortPopover): the toolbar Sort button opens a column picker, then the editor with one row per rule (drag to reorder, column, direction, remove), "Add sort" and "Delete sort"; a sort chip before the filter chips opens it.enableSortPopover: falsekeeps today's toolbar. - View settings (
enableViewSettings): one panel for Columns, Density, Wrap cell text, Grid lines, Sticky header, Alternating row colors and Row numbers, each with a pin that places it in the toolbar as an icon button (Columns and Density pinned by default), and "Reset view".enableViewSettings: falsekeeps the columns and density buttons. useST_ViewPersistence, mounted withpersistViewSettings: the view settings, pins, density, column visibility, order and pinning are saved tolocalStorageon every change and applied once after hydration; "Reset view" deletes the stored view.- The search toggle is never disabled: open, one click clears the search and closes the field; the field's inline clear button renders only with
showClearSearchButton: true. ST_ShowHideColumnsMenuandST_RowActionMenutake atriggerelement (withopenandonOpenChange) besideanchorEl; the columns and row action buttons open their menus from it, so focus returns through the primitive.- A drop in the columns menu slides header and body together and highlights the moved column.
- Exports:
ST_FilterChips,ST_FilterEditor,ST_FilterPickerButton,ST_ColumnPicker,ST_SortPopover,ST_ViewSettingsButton,ST_ViewSettingsItems,useST_PopupResize,useST_ViewPersistenceand the filter summary helpers.
Changed
View settings icons (D75)
- Lucide defaults for the view settings: grid lines
Frame,Equal,Equalrotated andSquare; ColumnsColumns3Cog; densityListChevronsDownUp, mirroredListIndentDecrease,ListChevronsUpDown.
Edition icons (06.6)
- The Tabler, Phosphor, Remix and Hugeicons editions take their own icons for grid lines, Columns and density (D77): Tabler
IconFrame,IconEqual,IconEqualrotated,IconTableOptions; PhosphorHashStraightIcon, `Equa...
v0.7.4
Fixed
- Single-row selection is one radio group per table: arrow keys move between rows and screen readers announce the row count.
- The loading state is localizable (
localization.loading); every progress bar carries it as its label.
v0.7.3
Fixed
- The row select checkbox is centred in its cell and the select-all checkbox sits on the header line, the same in every base.