basalt-ui 1.41.0 → 2.0.1

package/dist/surfaces.js

@@ -3,8 +3,6 @@ const PLUGIN_RULE_ID_LIST = [
   "raw-size-literal",
   "card-inset",
   "chart-in-raw-surface",
-  "hand-rolled-plot",
-  "chart-legend-literal",
   "shadow-basalt-export",
   "hand-rolled-shell",
   "raw-scroll-container",
@@ -12,23 +10,21 @@ const PLUGIN_RULE_ID_LIST = [
   "control-outside-home",
   "bound-control-outside-home",
   "control-size-literal",
-  "page-bar-budget",
   "in-body-page-title",
   "responsive-twin",
   "search-literal-link",
   "use-search-from-literal",
-  "provider-above-router",
   "query-fn-unwrap",
-  "deprecated-export",
   "forms-field-key",
-  "visx-boundary",
-  "visx-tooltip",
+  "chart-engine-boundary",
+  "chart-host-single",
   "token-layer-boundary",
-  "agent-resume-guard",
   "agent-no-raw-usechat",
   "ai-sdk-major",
   "no-import-meta-env",
-  "raw-breakpoint"
+  "raw-breakpoint",
+  "no-dev-helper",
+  "route-view-transition"
 ];
 const v = (spec, message, extra) => ({
   spec,
@@ -85,28 +81,26 @@ const SURFACES = {
       "card-inset",
       "in-body-page-title",
       "raw-scroll-container",
-      "page-bar-budget",
       "shadow-basalt-export",
-      // The mount-order law, guarded as of 1.28.0 (F5) — same-file static ancestry, so `warn`.
-      // `deprecated-export` sits here too: the ledger it reads spans subpaths.
-      "provider-above-router",
-      "deprecated-export",
+      // Route transitions are `createBasaltRouter`'s `defaultViewTransition`; a React
+      // `<ViewTransition>` around `<Outlet>` is inert and fights it.
+      "route-view-transition",
+      // Dev-only `import()`s need a literal NODE_ENV gate to fold out of production (repo-local).
+      "no-dev-helper",
       // `import.meta.env` is a Vite-ism that fails outside a Vite build (SSR/server code, Node
       // scripts, tests) — process.env.NODE_ENV works everywhere basalt code runs. Repo-local,
       // scoped to all of src/**, one surface required by coverage (C2 consolidation).
       "no-import-meta-env"
     ],
-    // agent/rules/basalt-mantine.md — stated, not guarded. The other law that stood here gained
-    // `provider-above-router` at 1.28.0; this one has no AST form left to catch, because
+    // agent/rules/basalt-mantine.md — stated, not guarded. This law has no AST form to catch, because
     // `cssVariablesResolver` is now `Omit`ted from the accepted prop type and a hand-built
     // `createTheme` is a consumer's own call to make. (`duplicate-notifications-mount`, the
     // other 1.28.0 mount-order rule, retired — `BasaltNotifications` no longer exists.)
     advisoryLaws: [
       "no second cssVariablesResolver \u2014 don't hand-build createTheme or re-add the resolver basalt already installs"
     ],
-    description: "BasaltProvider, createBasaltTheme, BasaltShell + sidebar/mobile-nav/breadcrumbs, PageBar, PageAside, useSizeClass, useCoarsePointer, NavCountBadge, ThemeToggle, ThreadWorkspace + thread-chat components, WidgetHeader, dashboard composites (DeltaBadge, StatCard with threshold tone, EmptyState, QueryState/LoadingState/ErrorState, SettingsSection/SettingsRow/DangerZone), ConnectivityProvider/useConnectivity/ConnectivityIndicator (auto-mounted, C1: absorbed from the dropped ./connectivity), createBasaltQueryClient/unwrap/BasaltQueryDevtools (C1: absorbed from the dropped ./query), BasaltDevDock (C5: lazy Router/Query devtools + theme lab in one dock)",
+    description: "Wiring (`BasaltProvider`, `createBasaltTheme`, `createBasaltRouter`, `unwrap`), shell + nav (`BasaltShell`, `PageBar`, `PageAside`, `PageTitle`, `ThemeToggle`, `defineNav`/`navGroup`/`navTarget`/`flattenNav`, `useBasaltNav`, `useSizeClass`, `useCoarsePointer`), dashboard (`Section`, `WidgetHeader`, `StatCard`, `StatGroup`, `DeltaBadge`, `EmptyState`, `SettingsSection`/`SettingsRow`/`DangerZone`). Reaches no subpath-required peer.",
     optionalPeers: [
-      "react-markdown",
       "remark-gfm",
       "rehype-sanitize",
       "remend",
@@ -122,21 +116,17 @@ const SURFACES = {
     layer: "headless",
     rule: "charts",
     skill: ["basalt-charts"],
-    guardKinds: ["raw-hex", "raw-color-fn", "raw-visx-axis", "chart-missing-aria-label"],
-    pluginRules: [
-      "hand-rolled-plot",
-      "chart-legend-literal",
-      "chart-in-raw-surface",
-      "visx-boundary",
-      "visx-tooltip"
-    ],
-    description: "CartesianChart + visx chart primitives, kinds, sparklines, hooks, and token re-exports (Mantine-free)",
+    guardKinds: ["raw-hex", "raw-color-fn"],
+    pluginRules: ["chart-in-raw-surface", "chart-engine-boundary", "chart-host-single"],
+    description: "CartesianChart (the TanStack Charts rung), the Lines and Bars kinds, ChartCard and the shared chartCursor (Mantine-free; @tanstack/charts + d3-scale peers)",
+    optionalPeers: ["@tanstack/charts", "d3-scale"],
     globs: {
       shipped: ["**/charts/**"],
       repo: ["packages/basalt-ui/src/charts/**"]
     },
-    // The @visx/*-only-in-charts boundary is enforced by the `basalt/visx-boundary` oxlint plugin
-    // rule, and the Mantine-free boundary by `basalt/token-layer-boundary` (repo-local only — see
+    // The engine boundary (@visx/* banned, @tanstack/charts allowlisted) is enforced by the
+    // `basalt/chart-engine-boundary` oxlint plugin rule, `@tanstack/charts/react` by the
+    // repo-local `basalt/chart-host-single`, and the Mantine-free boundary by `basalt/token-layer-boundary` (repo-local only — see
     // that rule's file-header comment for why) — both configs/oxlint-plugin.js, not
     // no-restricted-imports.
     forbiddenImports: [],
@@ -180,12 +170,6 @@ const SURFACES = {
     // ./charts above and that rule's file-header comment for why).
     forbiddenImports: []
   },
-  "./theme-lab": {
-    kind: "tooling",
-    layer: "mantine-coupled",
-    description: "ThemeLabControls, applyOverrides, COLOR_GROUPS \u2014 a low-level inspector for the non-derived structural tokens; identity/color tuning lives in DeriveControls",
-    forbiddenImports: []
-  },
   "./vite": {
     kind: "tooling",
     layer: "build-tooling",
@@ -193,45 +177,16 @@ const SURFACES = {
     optionalPeers: ["vite-plugin-pwa"],
     forbiddenImports: []
   },
-  "./guard": {
-    kind: "tooling",
-    layer: "headless",
-    description: "checkSource, GUARD_RULES, Finding types \u2014 the headless theme-guard core",
-    globs: {
-      shipped: [],
-      repo: ["packages/basalt-ui/src/guard/**"]
-    },
-    // @visx/* ban dropped — `basalt/visx-boundary` now bans it universally outside charts.
-    forbiddenImports: [...MANTINE_BANS]
-  },
-  // 6th JS subpath
   "./format": {
     kind: "tooling",
     layer: "headless",
-    description: "money/percent/integer/compact/deltaPct/duration/durationClock/clock/relativeTime/weekday/km/kcal \u2014 Intl-backed, Mantine-free, React-free formatting; charts/utils/format.ts re-exports fmtCompact/fmtPercent/fmtCurrency/fmtInt/fmtAxisDate/fmtTooltipDate from here (C5 consolidation, one implementation)",
+    description: "integer/money/percent/durationClock/relativeTime/weekday/km/kcal \u2014 Intl-backed, Mantine-free, React-free formatting; the chart layer formats through the same implementation",
     globs: {
       shipped: [],
       repo: ["packages/basalt-ui/src/format/**"]
     },
     forbiddenImports: [...MANTINE_BANS]
   },
-  "./router-tanstack": {
-    kind: "doctrine",
-    layer: "headless",
-    rule: "state",
-    skill: ["basalt-app"],
-    guardKinds: [],
-    // Law C10 — a nav link's `search` and a reader's `from` are both this bridge's contract.
-    pluginRules: ["search-literal-link", "use-search-from-literal"],
-    description: "TanStack Router bridge: defineNav/navGroup/navTarget (one typed nav definition) + useNav (sections + mobileNav, spread onto BasaltShell) + useBasaltNav (active route) + useRouterBreadcrumbs + createSearchStore (typed URL > localStorage > fallback store over field.enum/multi/range/number/boolean/string; the deprecated createSearchParamStore/createMultiSearchParamStore wrappers were removed in 1.29.0, C1 consolidation)",
-    optionalPeers: ["@tanstack/react-router"],
-    globs: {
-      shipped: [],
-      repo: ["packages/basalt-ui/src/router-tanstack/**"]
-    },
-    // @visx/* ban dropped — `basalt/visx-boundary` now bans it universally outside charts.
-    forbiddenImports: [...MANTINE_BANS]
-  },
   "./forms": {
     kind: "doctrine",
     layer: "mantine-coupled",
@@ -243,21 +198,10 @@ const SURFACES = {
     // only stops resetting. `warn` through the 1.30.0 grace because it fires on what every
     // consumer ships today (`PLUGIN_RULE_GRACE`).
     pluginRules: ["forms-field-key"],
-    description: "Mantine form layer: useBasaltForm + inputProps/fieldKey (two calls \u2014 a spread `key` is a React 19 warning; the deprecated `field` alias for `inputProps` was removed in 1.29.0, C1 consolidation), useFormSubmit (submit state, decoded errors, server fieldErrors, focus-first-error, validateAsync), FormStateProvider disable propagation, useFieldArray, FormErrorSummary, useFormDraft with autosave (Standard Schema). The FormSection/FormRow/FormGroup/FormActions layout lives in ./controls (moved in 1.36.0) and useForm/schemaResolver come from @mantine/form; the six re-exports here were removed in 1.39.0",
+    description: "Mantine form layer: useBasaltForm + inputProps/fieldKey (two calls \u2014 a spread `key` is a React 19 warning), on @mantine/form",
     optionalPeers: ["@mantine/form"],
     forbiddenImports: []
   },
-  "./notifications": {
-    kind: "doctrine",
-    layer: "mantine-coupled",
-    rule: "batteries",
-    skill: ["basalt-app"],
-    guardKinds: [],
-    pluginRules: [],
-    description: "Mantine notifications: notify helpers, typed registry, persisted history, NotificationBell, NotificationCenter",
-    optionalPeers: ["@mantine/notifications"],
-    forbiddenImports: []
-  },
   "./commands": {
     kind: "doctrine",
     layer: "mantine-coupled",
@@ -265,71 +209,45 @@ const SURFACES = {
     skill: ["basalt-app"],
     guardKinds: [],
     pluginRules: [],
-    description: "typed command bus + overlay controller, toSpotlightActions, ShortcutsHelp, BasaltOverlays",
-    optionalPeers: ["@mantine/spotlight", "@mantine/modals", "@tanstack/react-hotkeys"],
+    description: "defineCommands (typed command bus), defineOverlays/overlays, setColorScheme, toggleSidebar, ShortcutsHelp, defineNotifications/emit/NotificationBell (folded in from ./notifications); BasaltProvider mounts Spotlight, Modals and Notifications",
+    optionalPeers: ["@tanstack/react-hotkeys"],
     forbiddenImports: []
   },
-  "./data/table": {
+  "./table": {
     kind: "doctrine",
     layer: "mantine-coupled",
     rule: "batteries",
     skill: ["basalt-design"],
     guardKinds: [],
     pluginRules: [],
-    description: "BasaltDataTable: a sortable data table over TanStack Table, rendered with Mantine (Mantine-rendered)",
+    description: "BasaltDataTable and createColumnHelper: a data table over TanStack Table v9, rendered with Mantine (renamed from ./data/table)",
     optionalPeers: ["@tanstack/react-table"],
     forbiddenImports: []
   },
-  "./data/virtual": {
-    kind: "doctrine",
-    layer: "mantine-coupled",
-    rule: "batteries",
-    skill: ["basalt-design"],
-    guardKinds: [],
-    pluginRules: [],
-    description: "BasaltVirtualList: a windowed virtual list over TanStack Virtual, rendered with Mantine (Mantine-rendered)",
-    optionalPeers: ["@tanstack/react-virtual"],
-    forbiddenImports: []
-  },
   "./agent": {
-    kind: "doctrine",
-    layer: "headless",
-    rule: "batteries",
-    skill: ["basalt-app"],
-    guardKinds: [],
-    // The three agent-chat correctness rules — they honour `basalt-agent-allow`, not `theme-allow`.
-    pluginRules: ["agent-resume-guard", "agent-no-raw-usechat", "ai-sdk-major"],
-    description: "Headless streaming-chat layer: useAgentStream, aiSdkTransport (recommended default) + edenTransport, isResumable/ResumableAgentTransport (stream-resumption seam), PartList, coalesceParts, the ForeignPart/definePartRenderers/narrowAgentPart open part-registry seam, plus the multi-thread createThreadsStore + useAgentThreadRuns + outcome-resolver seam (Mantine-free)",
-    optionalPeers: ["ai", "use-stick-to-bottom"],
-    globs: {
-      shipped: [],
-      repo: ["packages/basalt-ui/src/agent/**"]
-    },
-    // @visx/* ban dropped — `basalt/visx-boundary` now bans it universally outside charts.
-    forbiddenImports: [...MANTINE_BANS]
-  },
-  "./agent-chat": {
     kind: "doctrine",
     layer: "mantine-coupled",
     rule: "batteries",
     skill: ["basalt-app"],
     guardKinds: [],
-    pluginRules: [],
-    description: 'Mantine-styled thread-chat components over basalt-ui/agent: ThreadWorkspace, ThreadFeed (variant/renderRow), ThreadFeedRow (inline-expanding Slack row, lazily mounted + kept mounted), ThreadOutcomeCard, ThreadDetailPanel, Composer, ThreadTranscript (open part-renderer registry via its renderers/fallbackRenderer props, per-message MessageAffordances, groupConsecutive, and an optional virtualize/height windowing mode whose VirtualizeOptions carry overscan/estimateSize/initialScroll \u2014 a virtualized transcript opens scrolled to the newest message unless initialScroll is "start"), threadPartRenderers, ToolChip (Mantine-coupled). motion is required, not optional \u2014 ThreadFeed/ThreadDetailPanel import motion/react eagerly, so this subpath fails to resolve without it installed even though peerDependenciesMeta marks it optional (npm has no per-subpath optionality). remend is genuinely optional here \u2014 ThreadTranscript reaches it only through the lazy dynamic import() inside content/markdown.tsx, and @tanstack/react-virtual the same way through the lazy import() behind ThreadTranscript virtualize (absent peer degrades to an unwindowed, height-bound pane).',
+    // The agent-chat correctness rules — they honour `basalt-agent-allow`, not `theme-allow`.
+    pluginRules: ["agent-no-raw-usechat", "ai-sdk-major"],
+    description: "Streaming-chat surface: aiSdkTransport, useAgentThreadRuns, parseAgentPart, the open part-registry types, the consumer-owned thread contracts (AgentThread/ThreadsStore/ChatMessage), and the Mantine chat UI folded in from ./agent-chat (ThreadFeed, ThreadFeedRow, Composer, ToolChip). motion is subpath-required: the chat UI imports it eagerly",
     optionalPeers: [
       "ai",
+      "@ai-sdk/provider",
       "motion",
-      "remend",
       "use-stick-to-bottom",
-      "react-markdown",
-      "remark-gfm",
-      "shiki",
-      "@shikijs/langs",
-      "@shikijs/themes",
-      "beautiful-mermaid",
       "@tanstack/react-virtual"
     ],
-    forbiddenImports: []
+    // The chat UI (src/agent/chat/**) is Mantine-styled; the runtime beside it stays Mantine-free.
+    // `*` does not cross `/`, so the two globs below cover the runtime files and not chat/.
+    globs: {
+      shipped: [],
+      repo: ["packages/basalt-ui/src/agent/*.ts", "packages/basalt-ui/src/agent/*.tsx"]
+    },
+    // @visx/* ban dropped — `basalt/chart-engine-boundary` bans it everywhere.
+    forbiddenImports: [...MANTINE_BANS]
   },
   "./content": {
     kind: "doctrine",
@@ -338,7 +256,7 @@ const SURFACES = {
     skill: ["basalt-design"],
     guardKinds: [],
     pluginRules: [],
-    description: 'Prose (article/chat typography), CodeBlock (shiki, optional peer), Callout, TableOfContents, ReadingProgress, Markdown (react-markdown + remark-gfm, optional peers; `streaming` is a rendering mode ONLY \u2014 `contentTrust` is the independent security input, and any surface rendering agent/model output must pin `contentTrust="untrusted"`, the sole input to the image-origin allowlist; a `fenceRenderers` registry \u2014 settledOnly/FenceRenderer/FenceRenderers/FenceRenderContext; `sanitizeSchema`, an additions-only SanitizeSchemaExtension merged over BASALT_SANITIZE_SCHEMA via mergeSanitizeSchema; the remend streaming-repair pass is now a lazy optional peer), MermaidDiagram (beautiful-mermaid, optional peer), mdxComponents/createMdxComponents, ArticleLayout (docs-page frame), ArticleCard/ArticleGrid (overview cards), Article model (sortArticles/filterArticles/formatArticleDate), FilterSet/ViewTabs/MultiSelectFilter re-exported from ./controls (they replaced the controlled ArticleFilterBar), toArticleActions (Spotlight projector, @mantine/spotlight type-only), GuideLink/GuideDrawer (contextual-help drawer) \u2014 the content/prose surface',
+    description: 'Prose (article/chat typography), Callout, TableOfContents, Markdown (react-markdown + remark-gfm, optional peers; `streaming` is a rendering mode ONLY \u2014 `contentTrust` is the independent security input, and any surface rendering agent/model output must pin `contentTrust="untrusted"`, the sole input to the image-origin allowlist; `fenceRenderers` extends fenced-block rendering \u2014 settledOnly/FenceRenderer/FenceRenderers; `sanitizeSchema` is an additions-only SanitizeSchemaExtension merged over the default via mergeSanitizeSchema; shiki code blocks, beautiful-mermaid diagrams and the remend streaming repair load lazily from optional peers), ArticleLayout (docs-page frame), GuideLink (contextual-help link) \u2014 the content/prose surface',
     optionalPeers: [
       "shiki",
       "@shikijs/langs",
@@ -347,8 +265,7 @@ const SURFACES = {
       "react-markdown",
       "remark-gfm",
       "rehype-sanitize",
-      "remend",
-      "@mantine/spotlight"
+      "remend"
     ],
     forbiddenImports: []
   },
@@ -364,8 +281,8 @@ const SURFACES = {
     // `responsive-twin` all ship `error`; the two C1 placement rules are the grace entries in
     // `PLUGIN_RULE_GRACE`, both promoting at 1.30.0 — `control-outside-home` re-dated against the
     // wave-7 measurement, `bound-control-outside-home` new since 1.28.0 (ASIDE-SPEC G5: the basalt
-    // half of C1, where a bound control in a section body rendered as a stray pill). The budget
-    // rules live on `.` with `PageBar` itself.
+    // half of C1, where a bound control in a section body rendered as a stray pill). The action
+    // budgets are types now (`PageBarActions` / `SectionActions`, `controls/actions.tsx`).
     pluginRules: [
       "hand-rolled-filter",
       "control-outside-home",
@@ -418,7 +335,7 @@ const SURFACES = {
     guardKinds: [],
     pluginRules: [],
     description: "DateRangePicker \u2014 the @mantine/dates implementation of RangeFilter's customPicker seam. Its own subpath because @mantine/dates is an optional peer and basaltViteConfig pre-bundles the whole @mantine scope, so a consumer without the peer (linewatch) must never resolve it: nothing under src/controls may import it, statically or lazily (docs/CONTROLS-SPEC.md \xA73).",
-    optionalPeers: ["@mantine/dates"],
+    optionalPeers: ["@mantine/dates", "dayjs"],
     forbiddenImports: []
   },
   "./state": {
@@ -427,17 +344,23 @@ const SURFACES = {
     rule: "state",
     skill: ["basalt-design"],
     guardKinds: ["localstorage-theme"],
-    pluginRules: [],
-    description: "createPersistedState (versioned localStorage) + the store field vocabulary (field.enum/multi/range/number/boolean/string, FieldHandle, lanes) + createLocalStore, the router-free store \u2014 Mantine-free state primitives",
+    // Law C10 — a nav link's `search` and a reader's `from` are both the search store's contract
+    // (the store half of the former `./router-tanstack`).
+    pluginRules: ["search-literal-link", "use-search-from-literal"],
+    description: "field.enum/multi/range/number/boolean/string (the store field vocabulary), createSearchStore (typed URL > localStorage > fallback store), createLocalStore (the router-free store), createPersistedState (versioned localStorage)",
     optionalPeers: [],
     // Consumers import basalt-ui/state from node_modules (lint-ignored), so there is nothing to
     // enforce consumer-side, and a shipped **/state* glob would wrongly hit consumers' own
     // Mantine-using state files. Enforce basalt's own barrel AND its implementation files.
     globs: {
       shipped: [],
-      repo: ["packages/basalt-ui/src/state.ts", "packages/basalt-ui/src/state/**"]
+      repo: [
+        "packages/basalt-ui/src/state.ts",
+        "packages/basalt-ui/src/state/**",
+        "packages/basalt-ui/src/router-tanstack/search-store.ts"
+      ]
     },
-    // @visx/* ban dropped — `basalt/visx-boundary` now bans it universally outside charts.
+    // @visx/* ban dropped — `basalt/chart-engine-boundary` bans it everywhere.
     forbiddenImports: [...MANTINE_BANS]
   },
   // ── Non-JS published assets (ToolingSpec; not JS subpaths — check-coverage exempts these) ─────
@@ -447,24 +370,12 @@ const SURFACES = {
     description: "Mandatory CSS import (after the Mantine styles.layer.css bundles) \u2014 @layer basalt base styles, iOS input safety net, font stack",
     forbiddenImports: []
   },
-  "./tokens.css": {
-    kind: "tooling",
-    layer: "non-js-asset",
-    description: "Prebuilt --vx-* token stylesheet \u2014 the default buildPaletteCss() output as a plain file, for a consumer that has a bundler to resolve the subpath but no React and no Mantine; with no bundler, emit a file you own via `basalt-ui tokens:css`",
-    forbiddenImports: []
-  },
   "./configs/*": {
     kind: "tooling",
     layer: "non-js-asset",
     description: "Raw toolchain presets for consumer extends: oxlint.json (or the guards-only oxlint-basalt.json), oxfmt.json, tsconfig.*.json, lefthook.yml, check.yml",
     forbiddenImports: []
   },
-  "./llms.txt": {
-    kind: "tooling",
-    layer: "non-js-asset",
-    description: "Machine-readable surface map \u2014 one entry per published subpath with import specifier, description, layer, and optional peers",
-    forbiddenImports: []
-  },
   // ── #-prefixed synthetic surfaces (advisory rules + global ban layer; NOT export keys) ────────
   "#app": {
     // synthetic global app-wide ban layer — the src/**+app/** glob
@@ -481,9 +392,9 @@ const SURFACES = {
     pluginRules: ["query-fn-unwrap"],
     globs: {
       // Shipped is a catch-all (not just src/**+app/**) so consumer code under components/, lib/,
-      // features/, etc. is also covered. The @visx/*-only-in-charts and Mantine-free charts/tokens
+      // features/, etc. is also covered. The chart-engine and Mantine-free charts/tokens
       // boundaries used to live here too and need last-writer-wins EMIT_ORDER games against the
-      // narrower ./tokens/./charts overrides — they're now enforced by `basalt/visx-boundary` and
+      // narrower ./tokens/./charts overrides — they're now enforced by `basalt/chart-engine-boundary` and
       // `basalt/token-layer-boundary` (plugin rules, immune to that class of clobbering) instead,
       // so the bans left below (antd, framer-motion) are plain global bans with no narrower
       // override to out-order.

package/dist/{data → table}/data-table-state.d.ts

@@ -41,7 +41,7 @@ export type DataTableStateProps = {
     onColumnFiltersChange?: ((filters: ColumnFiltersState) => void) | undefined;
     initialPagination?: PaginationState | undefined;
     onPaginationChange?: ((pagination: PaginationState) => void) | undefined;
-    initialColumnPinning?: ColumnPinningState | undefined;
+    initialColumnPinning?: Partial<ColumnPinningState> | undefined;
     rowSelection?: RowSelectionState | undefined;
     onRowSelectionChange?: ((selection: RowSelectionState) => void) | undefined;
 };

package/dist/table/data-table-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-state.d.ts","sourceRoot":"","sources":["../../src/table/data-table-state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACR,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAM3E,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAa,CAAA;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAClC,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,SAAS,CAAC,EAAE,CAAA;IAClB,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;CAC1D,GAAG;IAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CA2BrE;AAuBD;oGACoG;AACpG,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACzC,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC/D,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,oBAAoB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC5D,qBAAqB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC3E,iBAAiB,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IAC/C,kBAAkB,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAA;IAC9D,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAC5C,oBAAoB,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;CAC5E,CAAA;AAED;;wCAEwC;AACxC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM;;yDAjCrD,IAAI;;wDAAJ,IAAI;;qEAAJ,IAAI;;+DAAJ,IAAI;;;;oCA4DtB,OAAO,CAAC,iBAAiB,CAAC;EAgCvC;AAED;;;0CAG0C;AAC1C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IACzC,KAAK,EAAE,OAAO,CAAA;CACf,CAcA;AAED;;2DAE2D;AAC3D,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC;;;;;uBAOjE,kBAAkB,CAAC,WAAW,CAAC;cAUrD"}

package/dist/{data → table}/data-table-state.js

@@ -67,9 +67,10 @@ function useDataTableState(props, defaultPageSize) {
     props.initialPagination ?? { pageIndex: 0, pageSize: defaultPageSize },
     props.onPaginationChange
   );
-  const [columnPinning, setColumnPinning] = useState(
-    props.initialColumnPinning ?? {}
-  );
+  const [columnPinning, setColumnPinning] = useState({
+    start: props.initialColumnPinning?.start ?? [],
+    end: props.initialColumnPinning?.end ?? []
+  });
   const [internalRowSelection, setInternalRowSelection] = useState({});
   const handleRowSelectionChange = useCallback(
     (updater) => {

package/dist/{data → table}/data-table.d.ts

@@ -1,40 +1,10 @@
 import type { MantineSpacing } from '@mantine/core';
-import type { ColumnDef, ColumnFiltersState, PaginationState, RowData, RowSelectionState, SortingState } from '@tanstack/react-table';
+import type { ColumnFiltersState, PaginationState, RowData, RowSelectionState, SortingState } from '@tanstack/react-table';
 import type { ReactNode } from 'react';
 import type { BasaltProps, SlotStylesProps } from '../common/props.js';
 import type { BarAction, SlotActions } from '../controls/actions.js';
 import type { QueryStateLike } from '../dashboard/query-state.js';
-/** Horizontal alignment of a column's header AND its cells. */
-export type DataTableAlign = 'left' | 'center' | 'right';
-/**
- * Alignment lives on the column def's `meta`, not on a parallel prop array, so it travels with the
- * column it describes and survives reordering.
- *
- * Declared as a module augmentation of TanStack's own `ColumnMeta` so `meta: { aling: 'right' }` is
- * a TYPE error (excess-property check on the object literal) rather than a silently ignored key —
- * and a wrong VALUE (`'end'`, `'centre'`) throws at render. A misspelled alignment that quietly
- * left-aligns a money column is the class of defect that looks correct in review.
- */
-declare module '@tanstack/react-table' {
-    interface ColumnMeta<TData extends RowData, TValue> {
-        align?: DataTableAlign;
-        /**
-         * Opt OUT of the automatic mono-numeral cell style. The table applies it whenever the cell's
-         * raw value is a number — which is right for a plain figure and wrong for a numeric accessor
-         * whose `cell` renders its own chrome (a coloured `Text`, a `Badge`, a sparkline), because the
-         * `<td>`'s mono font then overrides what the cell asked for.
-         */
-        numeral?: boolean;
-        /**
-         * Fold priority for the measured column fold (`docs/CONTROLS-SPEC.md` §2): once the
-         * table no longer fits its wrapper, the HIGHEST-numbered priority column folds first, moving
-         * into a per-row disclosure instead of forcing the table into horizontal scroll. Unset columns
-         * fall back to their declared position, so a bare `<BasaltDataTable data columns />` folds its
-         * LAST column first — nothing regresses with no `meta.priority` set anywhere. See `foldOrder`.
-         */
-        priority?: number;
-    }
-}
+import type { BasaltColumnDef } from './table-features.js';
 /** A single selectable option inside a {@link DataTableFacet}'s `EnumFilter`/`MultiSelectFilter` pill. */
 export type DataTableFacetOption = {
     /** The raw filter value, compared against the column's stringified cell value. */
@@ -48,7 +18,7 @@ export type DataTableFacetOption = {
  * synthetic/derived column id (no matching key on `T`) still type-checks. Defaults to `unknown` so
  * a bare `DataTableFacet[]` / `DataTableColumnPinning` (no type argument) keeps working exactly as
  * before. Shared by {@link DataTableFacet}'s `columnId` and {@link DataTableColumnPinning}'s
- * `left`/`right`.
+ * `start`/`end`.
  */
 export type DataTableColumnId<T = unknown> = Extract<keyof T, string> | (string & {});
 /**
@@ -74,13 +44,12 @@ export type DataTableFacet<T = unknown> = {
 };
 /**
  * Column ids pinned to each edge — the same `T`-derived id union as {@link DataTableFacet}'s
- * `columnId`, applied to TanStack's own `ColumnPinningState` shape (`{ left, right }`, each a bare
- * `string[]` unrelated to any row type). Structurally assignable to `ColumnPinningState`, so no
- * cast is needed where this flows into `useState<ColumnPinningState>`.
+ * `columnId`, applied to the `{ start, end }` shape. Not itself a TanStack `ColumnPinningState`: both edges are
+ * optional here, and `useDataTableState` normalises a missing edge to `[]` before the table sees it.
  */
 export type DataTableColumnPinning<T = unknown> = {
-    left?: DataTableColumnId<T>[];
-    right?: DataTableColumnId<T>[];
+    start?: DataTableColumnId<T>[];
+    end?: DataTableColumnId<T>[];
 };
 /**
  * The four boxes `BasaltDataTable` paints: `root` is the outer fragment's replacement wrapper,
@@ -102,11 +71,12 @@ export type BasaltDataTableSlot = 'root' | 'toolbar' | 'table' | 'footer';
  *   emptyState: <Text c="dimmed">No results found.</Text>,
  * }
  */
-export type BasaltDataTableProps<T> = BasaltProps & SlotStylesProps<BasaltDataTableSlot> & {
+export type BasaltDataTableProps<T extends RowData> = BasaltProps & SlotStylesProps<BasaltDataTableSlot> & {
     /**
-     * Optional heading rendered above the toolbar via `WidgetHeader tier="widget"`. `count` always
-     * reads `table.getRowCount()` (C11) — never a raw `data.length` — so it tracks the row model
-     * (post-filter/-pagination) rather than the unfiltered input.
+     * Optional heading rendered above the toolbar via `WidgetHeader tier="widget"`. The count tag
+     * beside it is automatic, not a prop (there is no `count`): it reads `table.getRowCount()` (C11)
+     * — never a raw `data.length` — so it tracks the row model (post-filter/-pagination) rather
+     * than the unfiltered input.
      */
     title?: string;
     /** Optional leading icon, forwarded to `WidgetHeader`. */
@@ -116,10 +86,10 @@ export type BasaltDataTableProps<T> = BasaltProps & SlotStylesProps<BasaltDataTa
     /** Row data array. */
     data: T[];
     /**
-     * Column definitions. Use `createColumnHelper<T>()` from `@tanstack/react-table`
+     * Column definitions. Use `createColumnHelper<T>()` from `basalt-ui/table`
      * for a typed accessor builder — `col.accessor('field', …)` columns sort by value.
      */
-    columns: ColumnDef<T, any>[];
+    columns: BasaltColumnDef<T>[];
     /**
      * Enable column sorting via clickable headers. Client-side — the rows in `data` are what get
      * reordered.
@@ -402,15 +372,15 @@ export type BasaltDataTableProps<T> = BasaltProps & SlotStylesProps<BasaltDataTa
     /** Total page count, when known. Only consulted under `manualPagination`; omit to derive it from `rowCount`/`pageSize`. */
     pageCount?: number;
     /**
-     * Enables sticky left/right column pinning — pinned columns stick to the edge with a panel
+     * Enables sticky start/end column pinning — pinned columns stick to the edge with a panel
      * background and a hairline shadow separator while the table scrolls horizontally. Pin columns
-     * via `initialColumnPinning` (`{ left: string[], right: string[] }`).
+     * via `initialColumnPinning` (`{ start: string[], end: string[] }`).
      * @default false
      * @example
-     * <BasaltDataTable data={rows} columns={columns} enablePinning initialColumnPinning={{ left: ['name'] }} />
+     * <BasaltDataTable data={rows} columns={columns} enablePinning initialColumnPinning={{ start: ['name'] }} />
      */
     enablePinning?: boolean;
-    /** Initial column-pinning state — which column ids stick to the left/right edge. */
+    /** Initial column-pinning state — which column ids stick to the start/end edge. */
     initialColumnPinning?: DataTableColumnPinning<T>;
     /**
      * Caps the scrolling body (px number or CSS length) so a long table cannot blow a card out
@@ -500,11 +470,20 @@ export type BasaltDataTableProps<T> = BasaltProps & SlotStylesProps<BasaltDataTa
  * width, once anything is folded — fit `room`. A candidate with no measured width yet (never
  * rendered) is skipped rather than folded blind, since folding it would remove the one place its
  * width could ever be read from.
+ *
+ * Every width is a rounded integer (`offsetWidth`, `clientWidth`), and a table that fills its
+ * wrapper stretches its columns to sum to `room` exactly — so the rounded sum lands up to half a
+ * pixel per column over it, and a table that fits folded a column on hydration (a server-painted
+ * table whose cells then moved). The fit check forgives that rounding and nothing more: half a
+ * pixel for each measured width (the foldable columns AND `fixedCount`, the pinned / non-hiding
+ * ones `overhead` sums), plus half a pixel for `room`'s own rounding (the `+ 1` in the slack).
  */
 export declare function planColumnFold(input: {
     room: number;
     toggleWidth: number;
     overhead: number;
+    /** How many columns `overhead` sums, for the rounding slack. */
+    fixedCount?: number;
     order: readonly string[];
     widths: ReadonlyMap<string, number>;
 }): ReadonlySet<string>;
@@ -533,5 +512,5 @@ export declare function planColumnFold(input: {
  *   emptyState={<Text c="dimmed">No users found.</Text>}
  * />
  */
-export declare function BasaltDataTable<T>(props: BasaltDataTableProps<T>): import("react").JSX.Element;
+export declare function BasaltDataTable<T extends RowData>(props: BasaltDataTableProps<T>): import("react").JSX.Element;
 //# sourceMappingURL=data-table.d.ts.map

package/dist/table/data-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.d.ts","sourceRoot":"","sources":["../../src/table/data-table.tsx"],"names":[],"mappings":"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"}