Skip to content

Releases

v0.9.4

Choose a tag to compare

@github-actions github-actions released this 13 Nov 20:47
7b37986

Added

Spec 39 Typed filters wait for you to finish typing

  • A new hook, useST_DebouncedCallback(fn, wait), returns run, flush, cancel and isPending; it calls the latest fn, reads wait on 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 columnFilterDebounceMs and globalFilterDebounceMs and column option filterDebounceMs set the wait; the default is 500 ms for both, with or without manualFiltering (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.columnFilters rebuilt 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-table heading 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.tsx becomes context/ST_TableContext.tsx (tableContext, useTableContext, useSTContext, ST_TableProvider) and its factory createSTTableHook moves to hooks/createSTTableHook.ts; hooks/useST_Defaults.tsx becomes context/ST_DefaultsContext.tsx (ST_DefaultsContext, ST_DefaultsProvider, useST_Defaults). Every exported name is unchanged, so imports through index.ts keep 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 Date values (D81): equals, notEquals, greaterThan, greaterThanOrEqualTo, lessThan, lessThanOrEqualTo, between and betweenInclusive read a YYYY-MM-DD filter value as local midnight and compare by calendar day, an HH:mm value by time of day and a YYYY-MM-DDTHH:mm value 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-only YYYY-MM-DD string columns filter as before (three bases).
  • A column with filterVariant: 'date', 'datetime' or 'time' and no filterFn filters by equals (by day for a date) instead of fuzzy, which matched no Date row.
  • greaterThan, lessThan and 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 a filterFn matches 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-DD value as local midnight, compares by calendar day, and keeps its random lastLogin dates 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 *-range variants 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:check and the one in build) no longer runs out of memory at Node's default heap. The three library copies declare the same @tanstack/react-table feature 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 new types:bases checks 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 optional searchTitle frontmatter field (D71).

v0.9.3

Choose a tag to compare

@github-actions github-actions released this 12 Nov 21:57
9378b9f

Added

Spec 26 Home page Open Graph image

  • The home page has a social preview image: app/opengraph-image.tsx renders a 1200x630 PNG card like the docs cards, and Next.js adds og:image and twitter:image to / 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: SAMEORIGIN and Permissions-Policy: camera=(), microphone=(), geolocation=() (D57). No Content-Security-Policy yet.

Spec 25 JSON-LD structured data

  • The home page and every docs page carry Schema.org JSON-LD: / a WebSite and a SoftwareSourceCode, each docs page a TechArticle and a BreadcrumbList (Docs > section > page, absolute URLs), typed with schema-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>-prop style anchors, and hydrate into the interactive table with search, copy and pinning as before (D59). /docs/api/table-options HTML 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-autotable and recharts stay out of the home load (D59, D62).

Spec 33 Home title, hero line and description

  • The home page title and og:title read "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 shared siteDescription, read by the root layout, the home page metadata and JSON-LD, the OG image and the llms.txt summary (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 with pnpm -w registry:build, registry:items and registry:hosted and fails on a diff, naming each stale tracked file, such as apps/shadcn-table-docs/registry.json after 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/markdown or /llms.mdx/docs/.../content.md) now answers Vary: Accept and text/markdown; charset=utf-8, so a cache no longer hands Markdown to a browser or HTML to an agent (D58).
  • /llms.txt follows llmstxt.org: the # shadcn-table heading, 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.canonical to ./, so / and each docs page carry one <link rel="canonical"> with their own slash-less URL on NEXT_PUBLIC_SITE_URL. A path with a trailing slash answers 308 to the slash-less path; the PostHog proxy under /ingest keeps its slash (D53).

Fix D66 The docs proxy runs only on docs paths

  • The docs site's proxy.ts (Markdown delivery for Accept: text/markdown) runs only on docs paths instead of on every request, so pages, assets and the /ingest proxy 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:check read tsconfig.build.json (the preview build tsconfig.preview.json), which exclude the other build folders, so a stale .next or .next-preview folder 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 in document.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 zod as a dependency; nothing in it imports zod since 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.body like on Base UI and Radix (D80). React Aria showed the menu about 117 px off before.

Docs

Spec 31 Page frame and new pages

  • /docs redirects 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 item example-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

Choose a tag to compare

@github-actions github-actions released this 09 Nov 19:00
8feb794

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 on NEXT_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 /dev homepage variant index and the /dev/theme and /dev/theme/1 to /dev/theme/9 theming previews; they return 404. Their dev-only theme-demo components are deleted with them; git history keeps them.

v0.9.1

Choose a tag to compare

@github-actions github-actions released this 08 Nov 20:46
b0d53a1

Added

Spec 12 Stored view persists rows per page

  • persistViewSettings stores rows per page (D25): ST_StoredView gains pageSize?: number, saved on every page size change and applied at mount over initialState.pagination.pageSize, on the three bases. The page index is not stored, and a page index change alone writes nothing. A stored view without pageSize, or with one that is not a positive integer, keeps the initial page size. Reset view returns the page size to initialState. The view settings guide, the state management guide and the persistViewSettings API 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 PersistenceKeepsPageIndex play 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_DefaultsProvider and useST_Defaults, exported from the library index on all three bases (D27). The provider's icons prop (Partial<ST_Icons>) applies to every table below it: useST_TableOptions merges ST_Default_Icons, then the nearest provider's icons, then the table's own icons option, which still wins key by key. Nested providers merge over their parent; a table outside any provider behaves as before. The ST_Defaults type is added beside ST_Icons. Documented in the ST Components API page and the custom icons guide; the ProviderIconSet story 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 as components/ui-<base>/shadcn-table/icons/<set>.ts, loaded only once picked. @tabler/icons-react, @phosphor-icons/react, @hugeicons/react, @hugeicons/core-free-icons and @remixicon/react are 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()) runs tools/release/record-output.mjs, which prints the test/.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 output record; Typecheck, Storybook Tests and Docs E2E Tests output base, radix and aria, Installation E2E one output per scenario, each mirrored under workflow_call.outputs. PR Summary passes toJSON(needs) as NEEDS to pr-summary.mjs, whose new recordsFromNeeds reads every output (a local run without NEEDS still reads test/.out/). A failed leg's output still reaches the caller (GitHub run 42509826313). The test-out-* uploads of pr.yml, typecheck.yml, storybook-tests.yml and docs-e2e.yml and PR Summary's download go; installation-e2e.yml keeps 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), one Job | Result table 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 ## Unreleased counts by heading and the entry titles. Without ## Unreleased it 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 sets bumped when it is the chore: version <v> commit Prepare Release pushes as github-actions[bot] (D35). On that commit Typecheck, Storybook Tests, Docs E2E Tests and Installation E2E skip every matrix leg (a skip input 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/*.yml moves 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. No with: input changes; pnpm still comes from packageManager, and the jobs keep node-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: applyView sets the page size through setPagination instead of setPageSize, 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-view clears 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, decodeConfig and importPreset are 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 under components/ui-<base>/ is replaced by its hooked source from shadcn-ui/ui apps/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 the cn-* classes the style layers target and cn-menu-target for the menu color loop. The library copy in shadcn-table/ is unchanged. The docs E2E check of /docs/guides/view-settings picks a Style, Menu Color inverted and Menu Accent bold in 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 from P to Mod+Z (Cmd on macOS, Ctrl elsewhere), redo gains Mod+Shift+Z, and P is 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 a react-colorful hex 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, so Mod+Z returns to the value from before it opened. Typed values keep one undo step per change (A10), and an invalid value still applies nothing. react-colorful 5.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.mjs compiles each styles/style-<name>.css against the docs' Tailwind theme into public/styles/style-<name>.css (generated, git-ignored; run by predev and build, minified in build), 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 the style-<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/node is a new devDependency of the docs app.
  • Docs E2E: the perf budgets are 600 ms under --ci (F28).

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 08 Nov 17:34
2eeafde

Changed

Epic 01 Filtering

  • Filter modes are on by default (D4): enableColumnFilterModes defaults to true, so the mode picker shows in the chips, subheader and popover display modes without the flag; enableColumnFilterModes: false on 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 new arrIncludesNone filter fn) after its 14 modes; ST_Localization gains filterArrIncludesNone, filterArrIncludesSome reads "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-9 in place of pe-9, which lost to the shadcn trigger's pr-2.

Epic 02 Pagination

  • The pages footer, 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 2 on 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 width transitionend. Drags and every other width change stay instant; prefers-reduced-motion: reduce gets no transition.

Spec 05 Release approval

  • The version bump waits for the owner's approval (D3): the release PR's prepare-release job runs in the GitHub Environment release, 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 other pr.yml job 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-static checks 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.ts keeps 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 /, /docs and 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 an aria-hidden hydration 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 Default preset; a stored choice (st-design-system in localStorage) applies before first paint and is dropped after 2 days. The old st-theme key is removed.
  • Shortcuts through TanStack Hotkeys, each shown as a kbd hint: R shuffle, Shift+R reset, C another color preset, P undo; off while typing or while the search dialog is open.
  • The home theme demo cycles six palettes through the design system. The six themes/*.css files, lib/theme-presets.ts and components/theme-preset-switcher.tsx are gone.

v0.8.2

Choose a tag to compare

@github-actions github-actions released this 06 Nov 20:10
08ca5ba

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

Choose a tag to compare

@github-actions github-actions released this 06 Nov 18:26
b01bbe7

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-aria rows) runs packages/shadcn-table/test/release/gate.mjs (Playwright) against next dev of 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/ by pixelmatch (at most 500 differing pixels); the captures, any diff image and result.json upload as the gate-<base> artifact (D79). install.yml gains a workflow_dispatch trigger to refresh the references.

Spec 07.1 version bump

  • One pull request per release, dev into master (D83): its last check, version bump (release:prepare), runs scripts/release/prepare.mjs (pnpm release:prepare) once every other job is green, bumps both package.json files, renames ## Unreleased to the version and the date and commits chore: version <v> to dev; release impact reads the labels live, takes master PRs from dev only and passes the bumped head.
  • release.yml runs once, on the merge: the version job, scripts/release/version-pr.mjs and the release/next branch are gone; decide chooses release or nothing.

Epic 08 Test runner and tests

  • One test runner (D85): pnpm test <name> runs a test from test/<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, --scenario and --ci; every run ends with one summary line and a JSON record under test/.out/.
  • The checks move without changing their assertions: check-bases, check-icons and check-tailwind become validate-repo (with shadcn registry validate and the tool unit tests), check-pages.mjs and page-checks/ become docs-e2e (it builds and serves the docs on a free agent port without --url), the release smoke becomes validate-production, the install shell of install.yml becomes installation-e2e with the release gate as its browser phase and the six reference captures under test/installation-e2e/fixtures/reference/.
  • The registry scripts move to tools/registry/, the release scripts to tools/release/ (decide.mjs is check-release.mjs, prepare.mjs is prepare-release.mjs), the two previews merge into tools/preview.mjs, and the docs install.mjs and example-map.mjs move to apps/shadcn-table-docs/lib/. scripts/, packages/shadcn-table/scripts/, packages/shadcn-table/test/ and apps/shadcn-table-docs/scripts/ are gone, with check-aria-warnings.mjs and check-storybook.mjs; the root check:* and release:prepare scripts are removed.
  • playwright, pixelmatch and pngjs are root devDependencies (the package keeps playwright); the package storybook:build writes storybook-static/version.txt, and the Vercel Storybook build runs it.

Epic 08 Tools and workflows

  • pr.yml runs twenty-one jobs (D86, D87): Typecheck, Storybook Tests and Docs E2E Tests per base, Lint, Validate Repo, Installation E2E per scenario and Validate PR, each pnpm test <name> --ci with its records uploaded as test-out-<job>; PR Summary rewrites one sticky comment per PR from those records (the version line, the changelog counts, one line per job, the run link); version-bump is Prepare Release. install.yml is folded into Installation E2E and deleted; a workflow_dispatch with installation-e2e-only runs the seven install jobs with --no-diff and uploads the captures.
  • release.yml runs 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) and Publish Release; the post-merge install jobs are gone.
  • New tools tools/release/verify-deployment.mjs, publish-release.mjs and pr-summary.mjs (with pr-summary.test.mjs); the PR template names pnpm test --changed.

Epic 08 Docs and process

  • CONTRIBUTING.md, coding-standards.md, planning-guidelines.md and the registry and docs READMEs name test/, tools/ and pnpm test <name> with the CI job names (D88).
  • Docs E2E page lists follow the docs sections (D89): getting-started, api, guides, examples under test/docs-e2e/lib/, every page once; pnpm test docs-e2e --section <name> runs one.
  • pr.yml is PR checks with nine jobs, the four matrices as called workflows (typecheck.yml, storybook-tests.yml, docs-e2e.yml, installation-e2e.yml), check contexts such as Typecheck / Typecheck (base); runs are named PR checks: <PR title> or PR checks: all, release.yml is Release (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

Choose a tag to compare

@github-actions github-actions released this 05 Nov 21:37
eb5eb26

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; columnFilterDisplayMode accepts 'chips'.
  • Column options: icon (the column-type icon before the header label) and overflowTooltip.
  • 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 as ST_GridLinesAllIcon, ST_GridLinesRowsIcon and ST_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 chips addFilter, filterBy, noColumns, removeFilter, deleteAllFilters, clearFilters, backToColumns, isEmpty, isNotEmpty, showColumnToEditFilter, rangeSummary, yes, no, beforeValue, afterValue; sort editor sort, sortBy, ascending, descending, dragToReorder, removeSortOn, addSort, deleteSort, sortsCount; view settings viewSettings, columns, density, wrapCellText, singleLineCells, gridLines, stickyHeader, alternatingRowColors, pinToToolbar, unpinFromToolbar, resetView, columnsShown, gridLinesNone, gridLinesRows, gridLinesColumns, gridLinesAll, densityCompact, densityComfortable, densitySpacious; scroll cues scrollLeft, scrollRight.
  • State slices: viewSettings (setViewSettings, resetViewSettings, onViewSettingsChange), filterChips (setFilterChips, onFilterChipsChange) and columnFlipPending (setColumnFlipPending); table.refs.tableRef points at the <table>.
  • Helpers: getST_ColumnDropTargetProps, isColumnDragCancelled and applyColumnReorder for column drags; the view storage functions getViewSettingsKey, readStoredView, writeStoredView, removeStoredView, subscribeStoredView, getStoredViewSnapshot, getServerSnapshot and escapeForScript.
  • 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-height when 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.className restores the old box.
  • Body rows are 40, 48 and 56 px tall at compact, comfortable and spacious with px-2, px-3 and px-4 cell padding; rows are split by hairlines, none under the last row, and viewSettings.gridLines draws 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-selected and --st-edge-shadow with dark twins; rows and pinned cells read them, and an ancestor or stTableLayoutProps.className overrides 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 to grow: 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: true shows hover chevrons in the header row on a side with hidden columns; a click scrolls 80 percent of the unpinned width. useST_HorizontalOverflow and ST_ScrollButtons are exported for custom layouts.
  • enableCellOverflowTooltip: true truncates plain text cells on one line and shows the full value in a tooltip only when it is cut off; viewSettings.wrapText shows the text in full; columnDef.overflowTooltip sets it per column; ST_OverflowText is exported for custom cells.
  • The sticky header box caps at var(--st-sticky-max-height, 70vh) when the header is sticky by choice (enableStickyHeader or viewSettings.stickyHeader); a header forced sticky by row virtualization keeps the full-height rule.
  • With persistViewSettings on, a server-rendered table renders one inline script (with the nonce option) that marks the root data-st-view-pending and aria-busy before 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 icon before 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 are columns or all; 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_ColumnActionMenu and ST_FilterOptionMenu accept a trigger element with optional open / onOpenChange beside anchorEl / 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: false keeps 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: false keeps the columns and density buttons.
  • useST_ViewPersistence, mounted with persistViewSettings: the view settings, pins, density, column visibility, order and pinning are saved to localStorage on 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_ShowHideColumnsMenu and ST_RowActionMenu take a trigger element (with open and onOpenChange) beside anchorEl; 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_ViewPersistence and the filter summary helpers.

Changed

View settings icons (D75)

  • Lucide defaults for the view settings: grid lines Frame, Equal, Equal rotated and Square; Columns Columns3Cog; density ListChevronsDownUp, mirrored ListIndentDecrease, 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, IconEqual rotated, IconTableOptions; Phosphor HashStraightIcon, `Equa...
Read more

v0.7.4

Choose a tag to compare

@github-actions github-actions released this 03 Nov 12:25
daf309c

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

Choose a tag to compare

@github-actions github-actions released this 02 Nov 19:03
3a67720

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.