basalt-ui 1.41.0 → 2.0.0

package/agent/templates/__root.tpl

@@ -1,30 +1,23 @@
 /**
- * TanStack Router root route — wires QueryClient into the router context so
- * loader functions and components can call `Route.useRouteContext()`.
+ * TanStack Router root route. `BasaltRouterContext` types the context `createBasaltRouter` fills
+ * (the QueryClient); extend it for your own context and pass the value to
+ * `createBasaltRouter({ routeTree, context })`.
  *
  * Scaffold written by `basalt-ui init`. This file is yours — `basalt-ui sync` will not overwrite it.
  */
 import { Outlet, createRootRouteWithContext } from '@tanstack/react-router'
-import type { QueryClient } from '@tanstack/react-query'
-
 import { BasaltShell } from 'basalt-ui'
+import type { BasaltRouterContext } from 'basalt-ui'
+import { NAV } from '../lib/nav'
 
-type RouterContext = {
-  queryClient: QueryClient
-}
-
-export const Route = createRootRouteWithContext<RouterContext>()({
+export const Route = createRootRouteWithContext<BasaltRouterContext>()({
   component: RootComponent,
 })
 
-function RootComponent() {
+// Exported: react/only-export-components flags a non-exported component in a file that exports `Route`.
+export function RootComponent() {
   return (
-    <BasaltShell
-      brand={{ name: '{{APP_NAME}}' }}
-      sections={[
-        // { label: 'Section', items: [{ label: 'Page', to: '/page', icon: <Icon /> }] }
-      ]}
-    >
+    <BasaltShell brand={{ name: '{{APP_NAME}}' }} nav={NAV}>
       <Outlet />
     </BasaltShell>
   )

package/agent/templates/main.tpl

@@ -0,0 +1,21 @@
+/**
+ * The 2.0 entry (V2-SPEC § 2). `defineNav` rejects every call until the `Register` augmentation below
+ * exists, so `src/lib/nav.tsx` fails `tsc` without this file. `basalt-ui/styles.css` already pulls in
+ * the Mantine layers; do not import them separately.
+ *
+ * Scaffold written by `basalt-ui init`. This file is yours — `basalt-ui sync` will not overwrite it.
+ */
+import 'basalt-ui/styles.css'
+import { createRoot } from 'react-dom/client'
+import { BasaltProvider, createBasaltRouter } from 'basalt-ui'
+import { routeTree } from './routeTree.gen'
+
+const router = createBasaltRouter({ routeTree })
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: typeof router
+  }
+}
+
+createRoot(document.getElementById('root')!).render(<BasaltProvider router={router} />)

package/agent/templates/nav.tpl

@@ -0,0 +1,18 @@
+/**
+ * The app's ONE navigation definition — `BasaltShell nav={NAV}` derives the desktop sidebar, the
+ * mobile bar and the breadcrumb from it. Keep it a LEAF module: it must never import
+ * `routeTree.gen` or `routes/__root.tsx`, so palettes and redirects can import it without closing a
+ * cycle.
+ *
+ * Scaffold written by `basalt-ui init`. This file is yours — `basalt-ui sync` will not overwrite it.
+ */
+import { linkOptions } from '@tanstack/react-router'
+import { defineNav, navGroup } from 'basalt-ui'
+
+export const NAV = defineNav({
+  groups: [
+    navGroup({ id: 'main', label: 'Main' }, [
+      { id: 'home', label: 'Home', link: linkOptions({ to: '/' }) },
+    ]),
+  ],
+})

package/configs/oxlint-basalt.json

@@ -5,29 +5,23 @@
     "basalt/raw-size-literal": "error",
     "basalt/card-inset": "error",
     "basalt/chart-in-raw-surface": "error",
-    "basalt/hand-rolled-plot": "error",
-    "basalt/chart-legend-literal": "error",
-    "basalt/shadow-basalt-export": "warn",
+    "basalt/shadow-basalt-export": "error",
     "basalt/hand-rolled-shell": "error",
     "basalt/raw-scroll-container": "error",
     "basalt/hand-rolled-filter": "error",
     "basalt/control-outside-home": "error",
     "basalt/bound-control-outside-home": "error",
     "basalt/control-size-literal": "error",
-    "basalt/page-bar-budget": "error",
     "basalt/in-body-page-title": "error",
     "basalt/responsive-twin": "error",
     "basalt/search-literal-link": "error",
     "basalt/use-search-from-literal": "error",
-    "basalt/provider-above-router": "error",
     "basalt/query-fn-unwrap": "error",
-    "basalt/deprecated-export": "warn",
     "basalt/forms-field-key": "error",
-    "basalt/visx-boundary": "error",
-    "basalt/visx-tooltip": "error",
-    "basalt/agent-resume-guard": "error",
+    "basalt/chart-engine-boundary": "error",
     "basalt/agent-no-raw-usechat": "error",
     "basalt/ai-sdk-major": "error",
-    "basalt/raw-breakpoint": "error"
+    "basalt/raw-breakpoint": "error",
+    "basalt/route-view-transition": "error"
   }
 }