@liam-public/browser-react-cms 0.1.0 → 0.2.0

package/README.md

@@ -1,37 +1,59 @@
 # @liam-public/browser-react-cms
 
-Reusable CMS/admin **chrome** on top of `@liam-public/browser-react-ui` — the parts every
-admin app reinvents: a responsive app-shell, auth route-guards, and page primitives.
-
-## Exports
-
-- **`CmsLayout`** — responsive shell (desktop sidebar + mobile hamburger sheet) driven by a
-  `nav: NavItem[]` prop (`{ to, label, icon, end?, badge? }`), with `brand` and `headerRight`.
-- **`RequireAuth`** / **`RequireRole`** — route guards over `useAuth()` from
-  `@liam-public/browser-react-auth` (the guard `browser-react-auth` doesn't ship). `RequireAuth`
-  takes `onUnauthenticated` (e.g. trigger the OIDC redirect) + a `fallback`; `RequireRole` takes
-  `anyOf` roles + a `getRoles(user)` extractor.
-- **`PageHeader`**, **`PageStack`** — page title row + vertical section spacing.
-- **`DesktopOnly`/`MobileCards`/`MobileCard`/`MobileField`** — responsive table/card primitives.
-- **`LoadingSpinner`**, **`ConfirmDialog`** — common feedback components.
+Batteries-included CMS/admin framework on top of `@liam-public/browser-react-ui` (Tailwind v4 +
+Radix). Owns the cross-cutting concerns every admin app reinvents.
+
+## What's included
+
+| Area | Exports |
+| --- | --- |
+| **App shell** | `CmsLayout` (sidebar + mobile sheet, `nav`/`brand`/`headerRight`), `PageHeader`, `PageStack`, responsive `DesktopOnly`/`MobileCards`/`MobileCard`/`MobileField` |
+| **Auth & authz** | `RequireAuth`, `RequireRole` (over `browser-react-auth`); `AuthProvider`/`useAuth`/`createAuthenticatedFetch` re-exported |
+| **Dark / light mode** | `ThemeProvider`, `useTheme`, `ThemeToggle` + a `.dark` variant in `theme.css` |
+| **Notifications** | `ToastProvider`, `useToast()` (`toast`/`success`/`error`/`dismiss`) |
+| **Validation / forms** | `ResourceForm` + `useResourceForm` (Zod + react-hook-form), `TextField`, `TextareaField` |
+| **Data table + paging** | `DataTable` (column-driven, fed by `useList`), `Pagination` |
+| **Dashboards** | `StatCard`, `StatGrid`, `ChartCard` + re-exported recharts primitives |
+| **Analytics** | `AnalyticsProvider`, `useAnalytics`, `usePageViews`, `createBeaconAnalytics`/`createConsoleAnalytics` |
+| **i18n** | `createI18n`, `I18nProvider`, `useTranslation`, `LanguageSwitcher` |
+| **Date/number** | `formatDate`/`formatCurrency`/`formatNumber`/`formatPercentage`/`formatFileSize` (re-exported from `@liam-public/text`) |
+| **Feedback** | `LoadingSpinner`, `ConfirmDialog` |
 
 ## Setup
 
-Peer deps: `react`, `react-dom`, `react-router-dom`. Run Tailwind v4 in your app and import the
-theme once:
+Run Tailwind v4 in your app and import the theme once; peer deps are `react`, `react-dom`,
+`react-router-dom`, `react-hook-form`, `zod`, `@tanstack/react-query`.
 
 ```css
-/* app.css */
 @import '@liam-public/browser-react-cms/theme.css';
 ```
 
 ```tsx
-import { CmsLayout, RequireAuth } from '@liam-public/browser-react-cms'
-import { LayoutDashboard } from 'lucide-react'
-
-<RequireAuth onUnauthenticated={() => authClient.signInRedirect()}>
-  <CmsLayout brand="My App" nav={[{ to: '/', label: 'Dashboard', icon: LayoutDashboard, end: true }]}>
-    <Routes>…</Routes>
-  </CmsLayout>
-</RequireAuth>
+<ThemeProvider>
+  <ToastProvider>
+    <AnalyticsProvider adapter={createBeaconAnalytics({ endpoint: '/ingest/analytics', app: 'my-cms' })}>
+      <QueryClientProvider client={qc}>
+        <DataProviderProvider provider={dataProvider}>
+          <BrowserRouter>
+            <RequireAuth onUnauthenticated={() => authClient.signInRedirect()}>
+              <CmsLayout brand="My App" nav={nav} headerRight={<ThemeToggle />}>
+                <Routes>…</Routes>
+              </CmsLayout>
+            </RequireAuth>
+          </BrowserRouter>
+        </DataProviderProvider>
+      </QueryClientProvider>
+    </AnalyticsProvider>
+  </ToastProvider>
+</ThemeProvider>
+```
+
+A Zod-validated CRUD form:
+
+```tsx
+const schema = z.object({ name: z.string().min(1, 'Required'), url: z.string().url() })
+<ResourceForm schema={schema} defaultValues={{ name: '', url: '' }} onSubmit={save}>
+  <TextField name="name" label="Name" />
+  <TextField name="url" label="Feed URL" />
+</ResourceForm>
 ```

package/dist/index.d.ts

@@ -1,5 +1,13 @@
 import * as react from 'react';
 import { ReactNode, ComponentType } from 'react';
+import { FieldValues, DefaultValues, SubmitHandler, Path, UseFormReturn } from 'react-hook-form';
+import { ZodType } from 'zod';
+import { ListParams } from '@liam-public/browser-react-data';
+import { Resource, i18n } from 'i18next';
+export { AuthContextValue, AuthProvider, createAuthenticatedFetch, useAuth } from '@liam-public/browser-react-auth';
+export { LocalizedText, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercentage, isLocalizedText, selectText } from '@liam-public/text';
+export { Area, AreaChart, Bar, BarChart, CartesianGrid, Legend, Line, LineChart, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts';
+export { useTranslation } from 'react-i18next';
 
 /** A single sidebar navigation entry. `icon` is any lucide-react (or compatible) icon. */
 interface NavItem {
@@ -29,33 +37,6 @@ interface CmsLayoutProps {
  */
 declare function CmsLayout({ children, nav, brand, headerRight }: CmsLayoutProps): react.JSX.Element;
 
-interface RequireAuthProps {
-    readonly children: ReactNode;
-    /** Rendered while loading or when unauthenticated (defaults to a "Redirecting…" line). */
-    readonly fallback?: ReactNode;
-    /**
-     * Called once when the user is confirmed unauthenticated — e.g. trigger the OIDC
-     * redirect from `@liam-workspace/auth-client`, or navigate to `/login`.
-     */
-    readonly onUnauthenticated?: () => void;
-}
-/**
- * Gate that renders `children` only for an authenticated user. Wraps `useAuth()` from
- * `@liam-public/browser-react-auth`, filling the route-guard gap that package leaves open.
- */
-declare function RequireAuth({ children, fallback, onUnauthenticated }: RequireAuthProps): react.JSX.Element;
-interface RequireRoleProps {
-    readonly children: ReactNode;
-    /** The user is allowed if they hold ANY of these roles. */
-    readonly anyOf: readonly string[];
-    /** Extract the user's roles from the auth `user` object (shape is app-specific). */
-    readonly getRoles: (user: unknown) => readonly string[];
-    /** Rendered when the user lacks the required role(s). */
-    readonly fallback?: ReactNode;
-}
-/** Gate that additionally requires the authenticated user to hold one of `anyOf` roles. */
-declare function RequireRole({ children, anyOf, getRoles, fallback }: RequireRoleProps): react.JSX.Element;
-
 interface PageHeaderProps {
     readonly title: string;
     readonly action?: ReactNode;
@@ -108,4 +89,195 @@ interface ConfirmDialogProps {
 /** A modal confirm dialog with loading + error states. */
 declare function ConfirmDialog({ open, onOpenChange, title, description, onConfirm, loading, error, confirmLabel, destructive, }: ConfirmDialogProps): react.JSX.Element;
 
-export { CmsLayout, type CmsLayoutProps, ConfirmDialog, type ConfirmDialogProps, DesktopOnly, LoadingSpinner, type LoadingSpinnerProps, MobileCard, MobileCards, MobileField, type NavItem, PageHeader, type PageHeaderProps, PageStack, type PageStackProps, RequireAuth, type RequireAuthProps, RequireRole, type RequireRoleProps };
+interface RequireAuthProps {
+    readonly children: ReactNode;
+    /** Rendered while loading or when unauthenticated (defaults to a "Redirecting…" line). */
+    readonly fallback?: ReactNode;
+    /**
+     * Called once when the user is confirmed unauthenticated — e.g. trigger the OIDC
+     * redirect from `@liam-workspace/auth-client`, or navigate to `/login`.
+     */
+    readonly onUnauthenticated?: () => void;
+}
+/**
+ * Gate that renders `children` only for an authenticated user. Wraps `useAuth()` from
+ * `@liam-public/browser-react-auth`, filling the route-guard gap that package leaves open.
+ */
+declare function RequireAuth({ children, fallback, onUnauthenticated }: RequireAuthProps): react.JSX.Element;
+interface RequireRoleProps {
+    readonly children: ReactNode;
+    /** The user is allowed if they hold ANY of these roles. */
+    readonly anyOf: readonly string[];
+    /** Extract the user's roles from the auth `user` object (shape is app-specific). */
+    readonly getRoles: (user: unknown) => readonly string[];
+    /** Rendered when the user lacks the required role(s). */
+    readonly fallback?: ReactNode;
+}
+/** Gate that additionally requires the authenticated user to hold one of `anyOf` roles. */
+declare function RequireRole({ children, anyOf, getRoles, fallback }: RequireRoleProps): react.JSX.Element;
+
+type Theme = 'light' | 'dark' | 'system';
+interface ThemeContextValue {
+    readonly theme: Theme;
+    readonly resolved: 'light' | 'dark';
+    readonly setTheme: (theme: Theme) => void;
+    readonly toggle: () => void;
+}
+interface ThemeProviderProps {
+    readonly children: ReactNode;
+    readonly defaultTheme?: Theme;
+    readonly storageKey?: string;
+}
+/** Manages light/dark/system theme, persists the choice, and toggles `.dark` on `<html>`. */
+declare function ThemeProvider({ children, defaultTheme, storageKey, }: ThemeProviderProps): react.JSX.Element;
+declare function useTheme(): ThemeContextValue;
+/** A button that toggles light/dark. */
+declare function ThemeToggle(): react.JSX.Element;
+
+type ToastVariant = 'default' | 'success' | 'error';
+interface ToastOptions {
+    readonly title?: string;
+    readonly description?: string;
+    readonly variant?: ToastVariant;
+    /** Auto-dismiss after this many ms (default 5000; 0 disables). */
+    readonly duration?: number;
+}
+interface ToastContextValue {
+    toast: (options: ToastOptions) => number;
+    success: (title: string, description?: string) => number;
+    error: (title: string, description?: string) => number;
+    dismiss: (id: number) => void;
+}
+/** Wrap the app to enable `useToast()`. Renders the toast viewport itself. */
+declare function ToastProvider({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useToast(): ToastContextValue;
+
+/** A react-hook-form instance validated by a Zod schema. */
+declare function useResourceForm<T extends FieldValues>(schema: ZodType<T>, defaultValues?: DefaultValues<T>): UseFormReturn<T>;
+interface ResourceFormProps<T extends FieldValues> {
+    readonly schema: ZodType<T>;
+    readonly defaultValues?: DefaultValues<T>;
+    readonly onSubmit: SubmitHandler<T>;
+    readonly children: ReactNode;
+    readonly submitLabel?: string;
+    /** Optional extra footer content (e.g. a Cancel button) rendered next to Submit. */
+    readonly footer?: ReactNode;
+}
+/**
+ * A Zod-validated form. Wrap `<TextField>`/`<TextareaField>` (or any field using
+ * `useFormContext`) as children; submit is wired with validation + a disabled-while-submitting button.
+ */
+declare function ResourceForm<T extends FieldValues>({ schema, defaultValues, onSubmit, children, submitLabel, footer, }: ResourceFormProps<T>): react.JSX.Element;
+interface FieldProps<T extends FieldValues> {
+    readonly name: Path<T>;
+    readonly label: string;
+    readonly placeholder?: string;
+    readonly type?: string;
+}
+/** A labelled text input bound to the surrounding `ResourceForm` with inline validation errors. */
+declare function TextField<T extends FieldValues>({ name, label, placeholder, type }: FieldProps<T>): react.JSX.Element;
+/** A labelled textarea bound to the surrounding `ResourceForm`. */
+declare function TextareaField<T extends FieldValues>({ name, label, placeholder }: FieldProps<T>): react.JSX.Element;
+
+interface Column<T> {
+    /** Key into the row, used for the default cell value + as a React key. */
+    readonly key: string;
+    readonly header: string;
+    /** Custom cell renderer; defaults to `String(row[key])`. */
+    readonly render?: (row: T) => ReactNode;
+    readonly className?: string;
+}
+interface PaginationProps {
+    readonly page: number;
+    readonly pageCount: number;
+    readonly onPageChange: (page: number) => void;
+}
+/** Prev/next pager with a page indicator. */
+declare function Pagination({ page, pageCount, onPageChange }: PaginationProps): react.JSX.Element | null;
+interface DataTableProps<T> {
+    readonly resource: string;
+    readonly columns: readonly Column<T>[];
+    readonly pageSize?: number;
+    /** Extra list params (sort/filter) merged into each query. */
+    readonly params?: Omit<ListParams, 'page' | 'pageSize'>;
+    readonly emptyMessage?: string;
+}
+/**
+ * A paginated table for a resource, fed by `useList` from `@liam-public/browser-react-data`.
+ * Requires a `<DataProviderProvider>` + a `QueryClientProvider` above it.
+ */
+declare function DataTable<T extends Record<string, unknown>>({ resource, columns, pageSize, params, emptyMessage, }: DataTableProps<T>): react.JSX.Element;
+
+interface StatCardProps {
+    readonly label: string;
+    readonly value: ReactNode;
+    readonly icon?: ComponentType<{
+        className?: string;
+    }>;
+    readonly hint?: string;
+    readonly className?: string;
+}
+/** A KPI card: label, big value, optional icon + hint. */
+declare function StatCard({ label, value, icon: Icon, hint, className }: StatCardProps): react.JSX.Element;
+/** Responsive grid of KPI cards (1 / 2 / 4 columns). */
+declare function StatGrid({ children, columns }: {
+    children: ReactNode;
+    columns?: 2 | 3 | 4;
+}): react.JSX.Element;
+interface ChartCardProps {
+    readonly title: string;
+    readonly children: ReactNode;
+    readonly height?: number;
+    readonly action?: ReactNode;
+}
+/**
+ * A titled card sized for a chart. Put a recharts `<ResponsiveContainer>` (or any chart)
+ * inside; `recharts` is a dependency so apps don't need to install it separately.
+ */
+declare function ChartCard({ title, children, height, action }: ChartCardProps): react.JSX.Element;
+
+/** Pluggable analytics sink. Implement once (or use a provided adapter) and call from anywhere. */
+interface AnalyticsAdapter {
+    pageView(path: string): void;
+    track(event: string, props?: Record<string, unknown>): void;
+}
+declare function AnalyticsProvider({ adapter, children }: {
+    adapter: AnalyticsAdapter;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useAnalytics(): AnalyticsAdapter;
+/** Fire a `pageView` on every router path change. Mount once inside the Router + AnalyticsProvider. */
+declare function usePageViews(): void;
+/** A beacon adapter that POSTs events to an ingest endpoint (uses `sendBeacon` when available). */
+declare function createBeaconAnalytics(options: {
+    endpoint: string;
+    app?: string;
+}): AnalyticsAdapter;
+/** A console adapter for local development. */
+declare function createConsoleAnalytics(): AnalyticsAdapter;
+
+interface CreateI18nOptions {
+    /** i18next resource bundles: `{ en: { translation: {...} }, vi: { translation: {...} } }`. */
+    readonly resources: Resource;
+    readonly lng?: string;
+    readonly fallbackLng?: string;
+}
+/** Create a configured, isolated i18next instance for the CMS. */
+declare function createI18n(options: CreateI18nOptions): i18n;
+declare function I18nProvider({ i18n, children }: {
+    i18n: i18n;
+    children: ReactNode;
+}): react.JSX.Element;
+
+interface LanguageOption {
+    readonly code: string;
+    readonly label: string;
+}
+/** A dropdown that switches the active i18next language. */
+declare function LanguageSwitcher({ languages }: {
+    languages: readonly LanguageOption[];
+}): react.JSX.Element;
+
+export { type AnalyticsAdapter, AnalyticsProvider, ChartCard, type ChartCardProps, CmsLayout, type CmsLayoutProps, type Column, ConfirmDialog, type ConfirmDialogProps, type CreateI18nOptions, DataTable, type DataTableProps, DesktopOnly, I18nProvider, type LanguageOption, LanguageSwitcher, LoadingSpinner, type LoadingSpinnerProps, MobileCard, MobileCards, MobileField, type NavItem, PageHeader, type PageHeaderProps, PageStack, type PageStackProps, Pagination, type PaginationProps, RequireAuth, type RequireAuthProps, RequireRole, type RequireRoleProps, ResourceForm, type ResourceFormProps, StatCard, type StatCardProps, StatGrid, TextField, TextareaField, type Theme, type ThemeContextValue, ThemeProvider, type ThemeProviderProps, ThemeToggle, type ToastContextValue, type ToastOptions, ToastProvider, type ToastVariant, createBeaconAnalytics, createConsoleAnalytics, createI18n, useAnalytics, usePageViews, useResourceForm, useTheme, useToast };

package/dist/index.js

@@ -57,59 +57,33 @@ function CmsLayout({ children, nav, brand = "CMS", headerRight }) {
   ] });
 }
 
-// src/guards.tsx
-import { useEffect } from "react";
-import { useAuth } from "@liam-public/browser-react-auth";
-import { Fragment as Fragment2, jsx as jsx2 } from "react/jsx-runtime";
-function DefaultFallback({ message }) {
-  return /* @__PURE__ */ jsx2("div", { className: "flex h-screen items-center justify-center", children: /* @__PURE__ */ jsx2("p", { className: "text-sm text-muted-foreground", children: message }) });
-}
-function RequireAuth({ children, fallback, onUnauthenticated }) {
-  const { isAuthenticated, isLoading } = useAuth();
-  useEffect(() => {
-    if (!isLoading && !isAuthenticated) onUnauthenticated?.();
-  }, [isLoading, isAuthenticated, onUnauthenticated]);
-  if (isLoading) return /* @__PURE__ */ jsx2(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx2(DefaultFallback, { message: "Loading\u2026" }) });
-  if (!isAuthenticated) return /* @__PURE__ */ jsx2(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx2(DefaultFallback, { message: "Redirecting to sign in\u2026" }) });
-  return /* @__PURE__ */ jsx2(Fragment2, { children });
-}
-function RequireRole({ children, anyOf, getRoles, fallback }) {
-  const { user, isLoading, isAuthenticated } = useAuth();
-  if (isLoading) return /* @__PURE__ */ jsx2(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx2(DefaultFallback, { message: "Loading\u2026" }) });
-  if (!isAuthenticated) return /* @__PURE__ */ jsx2(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx2(DefaultFallback, { message: "Not signed in." }) });
-  const roles = getRoles(user);
-  const allowed = anyOf.some((r) => roles.includes(r));
-  if (!allowed) return /* @__PURE__ */ jsx2(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx2(DefaultFallback, { message: "You don't have access to this page." }) });
-  return /* @__PURE__ */ jsx2(Fragment2, { children });
-}
-
 // src/page.tsx
-import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function PageHeader({ title, action }) {
   return /* @__PURE__ */ jsxs2("div", { className: "flex items-center justify-between", children: [
-    /* @__PURE__ */ jsx3("h1", { className: "text-2xl font-bold", children: title }),
+    /* @__PURE__ */ jsx2("h1", { className: "text-2xl font-bold", children: title }),
     action
   ] });
 }
 function PageStack({ children, spacing = 6 }) {
-  return /* @__PURE__ */ jsx3("div", { className: spacing === 4 ? "space-y-4" : "space-y-6", children });
+  return /* @__PURE__ */ jsx2("div", { className: spacing === 4 ? "space-y-4" : "space-y-6", children });
 }
 
 // src/responsive-table.tsx
-import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 function DesktopOnly({ children }) {
-  return /* @__PURE__ */ jsx4("div", { className: "hidden md:block", children });
+  return /* @__PURE__ */ jsx3("div", { className: "hidden md:block", children });
 }
 function MobileCards({ children }) {
-  return /* @__PURE__ */ jsx4("div", { className: "flex flex-col gap-3 md:hidden", children });
+  return /* @__PURE__ */ jsx3("div", { className: "flex flex-col gap-3 md:hidden", children });
 }
 function MobileCard({ children }) {
-  return /* @__PURE__ */ jsx4("div", { className: "rounded-lg border bg-card p-3 text-sm", children });
+  return /* @__PURE__ */ jsx3("div", { className: "rounded-lg border bg-card p-3 text-sm", children });
 }
 function MobileField({ label, children }) {
   return /* @__PURE__ */ jsxs3("div", { className: "flex items-start justify-between gap-3 py-0.5", children: [
-    /* @__PURE__ */ jsx4("span", { className: "text-muted-foreground", children: label }),
-    /* @__PURE__ */ jsx4("span", { className: "text-right font-medium break-words", children })
+    /* @__PURE__ */ jsx3("span", { className: "text-muted-foreground", children: label }),
+    /* @__PURE__ */ jsx3("span", { className: "text-right font-medium break-words", children })
   ] });
 }
 
@@ -124,11 +98,11 @@ import {
   DialogHeader,
   DialogTitle
 } from "@liam-public/browser-react-ui";
-import { jsx as jsx5, jsxs as jsxs4 } from "react/jsx-runtime";
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function LoadingSpinner({ size = "md" }) {
   const padding = size === "lg" ? "py-16" : "py-8";
   const icon = size === "lg" ? "h-8 w-8" : "h-6 w-6";
-  return /* @__PURE__ */ jsx5("div", { className: `flex items-center justify-center ${padding}`, children: /* @__PURE__ */ jsx5(Loader2, { className: `${icon} animate-spin text-muted-foreground` }) });
+  return /* @__PURE__ */ jsx4("div", { className: `flex items-center justify-center ${padding}`, children: /* @__PURE__ */ jsx4(Loader2, { className: `${icon} animate-spin text-muted-foreground` }) });
 }
 function ConfirmDialog({
   open,
@@ -141,14 +115,14 @@ function ConfirmDialog({
   confirmLabel = "Confirm",
   destructive
 }) {
-  return /* @__PURE__ */ jsx5(Dialog, { open, onOpenChange, children: /* @__PURE__ */ jsxs4(DialogContent, { children: [
+  return /* @__PURE__ */ jsx4(Dialog, { open, onOpenChange, children: /* @__PURE__ */ jsxs4(DialogContent, { children: [
     /* @__PURE__ */ jsxs4(DialogHeader, { children: [
-      /* @__PURE__ */ jsx5(DialogTitle, { children: title }),
-      /* @__PURE__ */ jsx5(DialogDescription, { children: description })
+      /* @__PURE__ */ jsx4(DialogTitle, { children: title }),
+      /* @__PURE__ */ jsx4(DialogDescription, { children: description })
     ] }),
-    error && /* @__PURE__ */ jsx5("p", { className: "text-sm text-destructive", children: error }),
+    error && /* @__PURE__ */ jsx4("p", { className: "text-sm text-destructive", children: error }),
     /* @__PURE__ */ jsxs4(DialogFooter, { children: [
-      /* @__PURE__ */ jsx5(Button2, { variant: "outline", onClick: () => onOpenChange(false), disabled: loading, children: "Cancel" }),
+      /* @__PURE__ */ jsx4(Button2, { variant: "outline", onClick: () => onOpenChange(false), disabled: loading, children: "Cancel" }),
       /* @__PURE__ */ jsxs4(
         Button2,
         {
@@ -156,7 +130,7 @@ function ConfirmDialog({
           onClick: onConfirm,
           disabled: loading,
           children: [
-            loading && /* @__PURE__ */ jsx5(Loader2, { className: "h-4 w-4 animate-spin" }),
+            loading && /* @__PURE__ */ jsx4(Loader2, { className: "h-4 w-4 animate-spin" }),
             confirmLabel
           ]
         }
@@ -164,17 +138,494 @@ function ConfirmDialog({
     ] })
   ] }) });
 }
+
+// src/guards.tsx
+import { useEffect } from "react";
+import { useAuth } from "@liam-public/browser-react-auth";
+import { Fragment as Fragment2, jsx as jsx5 } from "react/jsx-runtime";
+function DefaultFallback({ message }) {
+  return /* @__PURE__ */ jsx5("div", { className: "flex h-screen items-center justify-center", children: /* @__PURE__ */ jsx5("p", { className: "text-sm text-muted-foreground", children: message }) });
+}
+function RequireAuth({ children, fallback, onUnauthenticated }) {
+  const { isAuthenticated, isLoading } = useAuth();
+  useEffect(() => {
+    if (!isLoading && !isAuthenticated) onUnauthenticated?.();
+  }, [isLoading, isAuthenticated, onUnauthenticated]);
+  if (isLoading) return /* @__PURE__ */ jsx5(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx5(DefaultFallback, { message: "Loading\u2026" }) });
+  if (!isAuthenticated) return /* @__PURE__ */ jsx5(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx5(DefaultFallback, { message: "Redirecting to sign in\u2026" }) });
+  return /* @__PURE__ */ jsx5(Fragment2, { children });
+}
+function RequireRole({ children, anyOf, getRoles, fallback }) {
+  const { user, isLoading, isAuthenticated } = useAuth();
+  if (isLoading) return /* @__PURE__ */ jsx5(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx5(DefaultFallback, { message: "Loading\u2026" }) });
+  if (!isAuthenticated) return /* @__PURE__ */ jsx5(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx5(DefaultFallback, { message: "Not signed in." }) });
+  const roles = getRoles(user);
+  const allowed = anyOf.some((r) => roles.includes(r));
+  if (!allowed) return /* @__PURE__ */ jsx5(Fragment2, { children: fallback ?? /* @__PURE__ */ jsx5(DefaultFallback, { message: "You don't have access to this page." }) });
+  return /* @__PURE__ */ jsx5(Fragment2, { children });
+}
+
+// src/theme.tsx
+import { createContext, useCallback, useContext, useEffect as useEffect2, useState as useState2 } from "react";
+import { Moon, Sun } from "lucide-react";
+import { Button as Button3 } from "@liam-public/browser-react-ui";
+import { jsx as jsx6 } from "react/jsx-runtime";
+var ThemeContext = createContext(null);
+function readStored(key) {
+  try {
+    return typeof localStorage !== "undefined" ? localStorage.getItem(key) : null;
+  } catch {
+    return null;
+  }
+}
+function writeStored(key, value) {
+  try {
+    if (typeof localStorage !== "undefined") localStorage.setItem(key, value);
+  } catch {
+  }
+}
+function prefersDark() {
+  return typeof window !== "undefined" && typeof window.matchMedia === "function" ? window.matchMedia("(prefers-color-scheme: dark)").matches : false;
+}
+function resolve(theme) {
+  return theme === "system" ? prefersDark() ? "dark" : "light" : theme;
+}
+function applyClass(resolved) {
+  if (typeof document !== "undefined") {
+    document.documentElement.classList.toggle("dark", resolved === "dark");
+  }
+}
+function ThemeProvider({
+  children,
+  defaultTheme = "system",
+  storageKey = "cms-theme"
+}) {
+  const [theme, setThemeState] = useState2(
+    () => readStored(storageKey) ?? defaultTheme
+  );
+  useEffect2(() => {
+    applyClass(resolve(theme));
+  }, [theme]);
+  useEffect2(() => {
+    if (theme !== "system" || typeof window === "undefined" || !window.matchMedia) return;
+    const mq = window.matchMedia("(prefers-color-scheme: dark)");
+    const onChange = () => applyClass(resolve("system"));
+    mq.addEventListener("change", onChange);
+    return () => mq.removeEventListener("change", onChange);
+  }, [theme]);
+  const setTheme = useCallback(
+    (next) => {
+      writeStored(storageKey, next);
+      setThemeState(next);
+    },
+    [storageKey]
+  );
+  const toggle = useCallback(() => {
+    setTheme(resolve(theme) === "dark" ? "light" : "dark");
+  }, [theme, setTheme]);
+  return /* @__PURE__ */ jsx6(ThemeContext.Provider, { value: { theme, resolved: resolve(theme), setTheme, toggle }, children });
+}
+function useTheme() {
+  const ctx = useContext(ThemeContext);
+  if (!ctx) throw new Error("useTheme must be used within a <ThemeProvider>");
+  return ctx;
+}
+function ThemeToggle() {
+  const { resolved, toggle } = useTheme();
+  return /* @__PURE__ */ jsx6(Button3, { variant: "ghost", size: "icon", onClick: toggle, "aria-label": "Toggle dark mode", children: resolved === "dark" ? /* @__PURE__ */ jsx6(Sun, { className: "h-5 w-5" }) : /* @__PURE__ */ jsx6(Moon, { className: "h-5 w-5" }) });
+}
+
+// src/toast.tsx
+import { createContext as createContext2, useCallback as useCallback2, useContext as useContext2, useRef, useState as useState3 } from "react";
+import { CheckCircle2, Info, X, XCircle } from "lucide-react";
+import { cn as cn2 } from "@liam-public/browser-react-ui";
+import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
+var ToastContext = createContext2(null);
+var ICONS = {
+  default: Info,
+  success: CheckCircle2,
+  error: XCircle
+};
+function ToastProvider({ children }) {
+  const [items, setItems] = useState3([]);
+  const seq = useRef(0);
+  const dismiss = useCallback2((id) => {
+    setItems((prev) => prev.filter((t) => t.id !== id));
+  }, []);
+  const toast = useCallback2(
+    (options) => {
+      const id = ++seq.current;
+      const item = { id, variant: options.variant ?? "default", ...options };
+      setItems((prev) => [...prev, item]);
+      const duration = options.duration ?? 5e3;
+      if (duration > 0) setTimeout(() => dismiss(id), duration);
+      return id;
+    },
+    [dismiss]
+  );
+  const success = useCallback2((title, description) => toast({ title, description, variant: "success" }), [toast]);
+  const error = useCallback2((title, description) => toast({ title, description, variant: "error" }), [toast]);
+  return /* @__PURE__ */ jsxs5(ToastContext.Provider, { value: { toast, success, error, dismiss }, children: [
+    children,
+    /* @__PURE__ */ jsx7("div", { className: "pointer-events-none fixed bottom-4 right-4 z-50 flex w-full max-w-sm flex-col gap-2", children: items.map((t) => {
+      const Icon = ICONS[t.variant];
+      return /* @__PURE__ */ jsxs5(
+        "div",
+        {
+          role: "status",
+          className: cn2(
+            "pointer-events-auto flex items-start gap-2 rounded-lg border bg-card p-3 text-sm shadow-lg",
+            t.variant === "error" && "border-destructive/40",
+            t.variant === "success" && "border-green-500/40"
+          ),
+          children: [
+            /* @__PURE__ */ jsx7(
+              Icon,
+              {
+                className: cn2(
+                  "mt-0.5 h-4 w-4 shrink-0",
+                  t.variant === "error" && "text-destructive",
+                  t.variant === "success" && "text-green-600",
+                  t.variant === "default" && "text-muted-foreground"
+                )
+              }
+            ),
+            /* @__PURE__ */ jsxs5("div", { className: "flex-1", children: [
+              t.title && /* @__PURE__ */ jsx7("p", { className: "font-medium", children: t.title }),
+              t.description && /* @__PURE__ */ jsx7("p", { className: "text-muted-foreground", children: t.description })
+            ] }),
+            /* @__PURE__ */ jsx7(
+              "button",
+              {
+                onClick: () => dismiss(t.id),
+                "aria-label": "Dismiss",
+                className: "text-muted-foreground hover:text-foreground",
+                children: /* @__PURE__ */ jsx7(X, { className: "h-4 w-4" })
+              }
+            )
+          ]
+        },
+        t.id
+      );
+    }) })
+  ] });
+}
+function useToast() {
+  const ctx = useContext2(ToastContext);
+  if (!ctx) throw new Error("useToast must be used within a <ToastProvider>");
+  return ctx;
+}
+
+// src/form.tsx
+import {
+  FormProvider,
+  useForm,
+  useFormContext
+} from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { Button as Button4, Input, Label } from "@liam-public/browser-react-ui";
+import { jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
+function useResourceForm(schema, defaultValues) {
+  return useForm({
+    // resolver generics across zod 3/4 are loose; the runtime validation is correct.
+    resolver: zodResolver(schema),
+    defaultValues
+  });
+}
+function ResourceForm({
+  schema,
+  defaultValues,
+  onSubmit,
+  children,
+  submitLabel = "Save",
+  footer
+}) {
+  const form = useResourceForm(schema, defaultValues);
+  return /* @__PURE__ */ jsx8(FormProvider, { ...form, children: /* @__PURE__ */ jsxs6("form", { onSubmit: form.handleSubmit(onSubmit), className: "space-y-4", children: [
+    children,
+    /* @__PURE__ */ jsxs6("div", { className: "flex items-center justify-end gap-2", children: [
+      footer,
+      /* @__PURE__ */ jsx8(Button4, { type: "submit", disabled: form.formState.isSubmitting, children: submitLabel })
+    ] })
+  ] }) });
+}
+function useFieldError(name) {
+  const {
+    formState: { errors }
+  } = useFormContext();
+  const err = errors[name];
+  return err?.message;
+}
+function TextField({ name, label, placeholder, type = "text" }) {
+  const { register } = useFormContext();
+  const error = useFieldError(name);
+  return /* @__PURE__ */ jsxs6("div", { className: "space-y-1.5", children: [
+    /* @__PURE__ */ jsx8(Label, { htmlFor: name, children: label }),
+    /* @__PURE__ */ jsx8(Input, { id: name, type, placeholder, "aria-invalid": !!error, ...register(name) }),
+    error && /* @__PURE__ */ jsx8("p", { className: "text-sm text-destructive", children: error })
+  ] });
+}
+function TextareaField({ name, label, placeholder }) {
+  const { register } = useFormContext();
+  const error = useFieldError(name);
+  return /* @__PURE__ */ jsxs6("div", { className: "space-y-1.5", children: [
+    /* @__PURE__ */ jsx8(Label, { htmlFor: name, children: label }),
+    /* @__PURE__ */ jsx8(
+      "textarea",
+      {
+        id: name,
+        placeholder,
+        "aria-invalid": !!error,
+        className: "flex min-h-20 w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50",
+        ...register(name)
+      }
+    ),
+    error && /* @__PURE__ */ jsx8("p", { className: "text-sm text-destructive", children: error })
+  ] });
+}
+
+// src/data-table.tsx
+import { useState as useState4 } from "react";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+import {
+  Button as Button5,
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow
+} from "@liam-public/browser-react-ui";
+import { useList } from "@liam-public/browser-react-data";
+import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
+function Pagination({ page, pageCount, onPageChange }) {
+  if (pageCount <= 1) return null;
+  return /* @__PURE__ */ jsxs7("div", { className: "flex items-center justify-end gap-2 pt-3 text-sm", children: [
+    /* @__PURE__ */ jsxs7("span", { className: "text-muted-foreground", children: [
+      "Page ",
+      page,
+      " of ",
+      pageCount
+    ] }),
+    /* @__PURE__ */ jsx9(Button5, { variant: "outline", size: "icon-sm", disabled: page <= 1, onClick: () => onPageChange(page - 1), "aria-label": "Previous page", children: /* @__PURE__ */ jsx9(ChevronLeft, { className: "h-4 w-4" }) }),
+    /* @__PURE__ */ jsx9(Button5, { variant: "outline", size: "icon-sm", disabled: page >= pageCount, onClick: () => onPageChange(page + 1), "aria-label": "Next page", children: /* @__PURE__ */ jsx9(ChevronRight, { className: "h-4 w-4" }) })
+  ] });
+}
+function DataTable({
+  resource,
+  columns,
+  pageSize = 20,
+  params,
+  emptyMessage = "No records."
+}) {
+  const [page, setPage] = useState4(1);
+  const { data, isLoading, isError, error } = useList(resource, { page, pageSize, ...params });
+  if (isLoading) return /* @__PURE__ */ jsx9(LoadingSpinner, {});
+  if (isError) return /* @__PURE__ */ jsx9("p", { className: "py-8 text-center text-sm text-destructive", children: error?.message ?? "Failed to load." });
+  const rows = data?.data ?? [];
+  const total = data?.total ?? 0;
+  const pageCount = Math.max(1, Math.ceil(total / pageSize));
+  if (rows.length === 0) {
+    return /* @__PURE__ */ jsx9("p", { className: "py-8 text-center text-sm text-muted-foreground", children: emptyMessage });
+  }
+  return /* @__PURE__ */ jsxs7("div", { children: [
+    /* @__PURE__ */ jsxs7(Table, { children: [
+      /* @__PURE__ */ jsx9(TableHeader, { children: /* @__PURE__ */ jsx9(TableRow, { children: columns.map((c) => /* @__PURE__ */ jsx9(TableHead, { className: c.className, children: c.header }, c.key)) }) }),
+      /* @__PURE__ */ jsx9(TableBody, { children: rows.map((row, i) => /* @__PURE__ */ jsx9(TableRow, { children: columns.map((c) => /* @__PURE__ */ jsx9(TableCell, { className: c.className, children: c.render ? c.render(row) : String(row[c.key] ?? "") }, c.key)) }, row.id ?? i)) })
+    ] }),
+    /* @__PURE__ */ jsx9(Pagination, { page, pageCount, onPageChange: setPage })
+  ] });
+}
+
+// src/dashboard.tsx
+import { Card, CardContent, CardHeader, CardTitle, cn as cn3 } from "@liam-public/browser-react-ui";
+import {
+  ResponsiveContainer,
+  LineChart,
+  Line,
+  BarChart,
+  Bar,
+  AreaChart,
+  Area,
+  XAxis,
+  YAxis,
+  CartesianGrid,
+  Tooltip,
+  Legend
+} from "recharts";
+import { jsx as jsx10, jsxs as jsxs8 } from "react/jsx-runtime";
+function StatCard({ label, value, icon: Icon, hint, className }) {
+  return /* @__PURE__ */ jsxs8(Card, { className, children: [
+    /* @__PURE__ */ jsxs8(CardHeader, { className: "flex flex-row items-center justify-between space-y-0 pb-2", children: [
+      /* @__PURE__ */ jsx10(CardTitle, { className: "text-sm font-medium text-muted-foreground", children: label }),
+      Icon && /* @__PURE__ */ jsx10(Icon, { className: "h-4 w-4 text-muted-foreground" })
+    ] }),
+    /* @__PURE__ */ jsxs8(CardContent, { children: [
+      /* @__PURE__ */ jsx10("div", { className: "text-2xl font-bold", children: value }),
+      hint && /* @__PURE__ */ jsx10("p", { className: "text-xs text-muted-foreground", children: hint })
+    ] })
+  ] });
+}
+function StatGrid({ children, columns = 4 }) {
+  const cols = columns === 2 ? "sm:grid-cols-2" : columns === 3 ? "sm:grid-cols-2 lg:grid-cols-3" : "sm:grid-cols-2 lg:grid-cols-4";
+  return /* @__PURE__ */ jsx10("div", { className: cn3("grid grid-cols-1 gap-4", cols), children });
+}
+function ChartCard({ title, children, height = 280, action }) {
+  return /* @__PURE__ */ jsxs8(Card, { children: [
+    /* @__PURE__ */ jsxs8(CardHeader, { className: "flex flex-row items-center justify-between space-y-0", children: [
+      /* @__PURE__ */ jsx10(CardTitle, { className: "text-base", children: title }),
+      action
+    ] }),
+    /* @__PURE__ */ jsx10(CardContent, { children: /* @__PURE__ */ jsx10("div", { style: { height }, children }) })
+  ] });
+}
+
+// src/analytics.tsx
+import { createContext as createContext3, useContext as useContext3, useEffect as useEffect3, useRef as useRef2 } from "react";
+import { useLocation } from "react-router-dom";
+import { jsx as jsx11 } from "react/jsx-runtime";
+var noop = { pageView: () => {
+}, track: () => {
+} };
+var AnalyticsContext = createContext3(noop);
+function AnalyticsProvider({ adapter, children }) {
+  return /* @__PURE__ */ jsx11(AnalyticsContext.Provider, { value: adapter, children });
+}
+function useAnalytics() {
+  return useContext3(AnalyticsContext);
+}
+function usePageViews() {
+  const analytics = useAnalytics();
+  const location = useLocation();
+  const last = useRef2("");
+  useEffect3(() => {
+    const path = location.pathname + location.search;
+    if (path !== last.current) {
+      last.current = path;
+      analytics.pageView(path);
+    }
+  }, [location, analytics]);
+}
+function createBeaconAnalytics(options) {
+  const send = (type, payload) => {
+    const body = JSON.stringify({ type, app: options.app, ts: (/* @__PURE__ */ new Date()).toISOString(), ...payload });
+    if (typeof navigator !== "undefined" && navigator.sendBeacon) {
+      navigator.sendBeacon(options.endpoint, new Blob([body], { type: "application/json" }));
+    } else if (typeof fetch !== "undefined") {
+      void fetch(options.endpoint, { method: "POST", headers: { "content-type": "application/json" }, body, keepalive: true });
+    }
+  };
+  return {
+    pageView: (path) => send("pageView", { path }),
+    track: (event, props) => send("track", { event, props })
+  };
+}
+function createConsoleAnalytics() {
+  return {
+    pageView: (path) => console.info("[analytics] pageView", path),
+    track: (event, props) => console.info("[analytics] track", event, props)
+  };
+}
+
+// src/i18n.tsx
+import i18next from "i18next";
+import { I18nextProvider, initReactI18next, useTranslation } from "react-i18next";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue
+} from "@liam-public/browser-react-ui";
+import { jsx as jsx12, jsxs as jsxs9 } from "react/jsx-runtime";
+function createI18n(options) {
+  const instance = i18next.createInstance();
+  void instance.use(initReactI18next).init({
+    resources: options.resources,
+    lng: options.lng ?? "en",
+    fallbackLng: options.fallbackLng ?? "en",
+    interpolation: { escapeValue: false }
+  });
+  return instance;
+}
+function I18nProvider({ i18n, children }) {
+  return /* @__PURE__ */ jsx12(I18nextProvider, { i18n, children });
+}
+function LanguageSwitcher({ languages }) {
+  const { i18n } = useTranslation();
+  return /* @__PURE__ */ jsxs9(Select, { value: i18n.language, onValueChange: (value) => void i18n.changeLanguage(value), children: [
+    /* @__PURE__ */ jsx12(SelectTrigger, { className: "w-36", children: /* @__PURE__ */ jsx12(SelectValue, {}) }),
+    /* @__PURE__ */ jsx12(SelectContent, { children: languages.map((l) => /* @__PURE__ */ jsx12(SelectItem, { value: l.code, children: l.label }, l.code)) })
+  ] });
+}
+
+// src/wire.ts
+import { AuthProvider, useAuth as useAuth2, createAuthenticatedFetch } from "@liam-public/browser-react-auth";
+import {
+  formatDate,
+  formatCurrency,
+  formatNumber,
+  formatPercentage,
+  formatFileSize,
+  selectText,
+  isLocalizedText
+} from "@liam-public/text";
 export {
+  AnalyticsProvider,
+  Area,
+  AreaChart,
+  AuthProvider,
+  Bar,
+  BarChart,
+  CartesianGrid,
+  ChartCard,
   CmsLayout,
   ConfirmDialog,
+  DataTable,
   DesktopOnly,
+  I18nProvider,
+  LanguageSwitcher,
+  Legend,
+  Line,
+  LineChart,
   LoadingSpinner,
   MobileCard,
   MobileCards,
   MobileField,
   PageHeader,
   PageStack,
+  Pagination,
   RequireAuth,
-  RequireRole
+  RequireRole,
+  ResourceForm,
+  ResponsiveContainer,
+  StatCard,
+  StatGrid,
+  TextField,
+  TextareaField,
+  ThemeProvider,
+  ThemeToggle,
+  ToastProvider,
+  Tooltip,
+  XAxis,
+  YAxis,
+  createAuthenticatedFetch,
+  createBeaconAnalytics,
+  createConsoleAnalytics,
+  createI18n,
+  formatCurrency,
+  formatDate,
+  formatFileSize,
+  formatNumber,
+  formatPercentage,
+  isLocalizedText,
+  selectText,
+  useAnalytics,
+  useAuth2 as useAuth,
+  usePageViews,
+  useResourceForm,
+  useTheme,
+  useToast,
+  useTranslation
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cms-layout.tsx","../src/guards.tsx","../src/page.tsx","../src/responsive-table.tsx","../src/feedback.tsx"],"sourcesContent":["import { useState } from 'react'\nimport type { ComponentType, ReactNode } from 'react'\nimport { NavLink } from 'react-router-dom'\nimport { Menu } from 'lucide-react'\nimport {\n  Button,\n  Separator,\n  Sheet,\n  SheetContent,\n  SheetTrigger,\n  cn,\n} from '@liam-public/browser-react-ui'\n\n/** A single sidebar navigation entry. `icon` is any lucide-react (or compatible) icon. */\nexport interface NavItem {\n  readonly to: string\n  readonly label: string\n  readonly icon: ComponentType<{ className?: string }>\n  /** Exact-match the route (e.g. for the index `/`). */\n  readonly end?: boolean\n  /** Optional trailing content, e.g. an alert count `<Badge>`. */\n  readonly badge?: ReactNode\n}\n\nfunction NavList({ nav, onNavigate }: { nav: readonly NavItem[]; onNavigate?: () => void }) {\n  return (\n    <>\n      {nav.map((item) => (\n        <NavLink\n          key={item.to}\n          to={item.to}\n          end={item.end}\n          onClick={onNavigate}\n          className={({ isActive }) =>\n            cn(\n              'flex items-center gap-2 rounded-md px-3 py-2 text-sm font-medium transition-colors hover:bg-accent',\n              isActive && 'bg-accent text-accent-foreground',\n            )\n          }\n        >\n          <item.icon className=\"h-4 w-4\" />\n          {item.label}\n          {item.badge != null && <span className=\"ml-auto\">{item.badge}</span>}\n        </NavLink>\n      ))}\n    </>\n  )\n}\n\nexport interface CmsLayoutProps {\n  readonly children: ReactNode\n  /** Sidebar navigation entries. */\n  readonly nav: readonly NavItem[]\n  /** Brand shown at the top of the sidebar (defaults to \"CMS\"). */\n  readonly brand?: ReactNode\n  /** Optional content for the top-right of the desktop header (e.g. a user menu). */\n  readonly headerRight?: ReactNode\n}\n\n/**\n * Responsive CMS app shell: a desktop sidebar (md+) and a mobile hamburger sheet,\n * with an active-link-aware nav driven entirely by the `nav` prop. Bring your own\n * router (`react-router-dom`) and Tailwind theme.\n */\nexport function CmsLayout({ children, nav, brand = 'CMS', headerRight }: CmsLayoutProps) {\n  const [open, setOpen] = useState(false)\n  return (\n    <div className=\"flex h-screen flex-col md:flex-row\">\n      {/* Mobile top bar (hidden at md+) */}\n      <header className=\"flex items-center gap-2 border-b p-3 md:hidden\">\n        <Sheet open={open} onOpenChange={setOpen}>\n          <SheetTrigger asChild>\n            <Button variant=\"ghost\" size=\"icon\" aria-label=\"Open menu\" className=\"h-11 w-11\">\n              <Menu className=\"h-5 w-5\" />\n            </Button>\n          </SheetTrigger>\n          <SheetContent side=\"left\" className=\"p-0\">\n            <div className=\"p-4 font-semibold text-lg\">{brand}</div>\n            <Separator />\n            <nav className=\"flex flex-col gap-1 p-2\">\n              <NavList nav={nav} onNavigate={() => setOpen(false)} />\n            </nav>\n          </SheetContent>\n        </Sheet>\n        <span className=\"font-semibold\">{brand}</span>\n      </header>\n\n      {/* Desktop sidebar (hidden below md) */}\n      <aside className=\"hidden md:flex w-56 border-r bg-muted/30 flex-col\">\n        <div className=\"p-4 font-semibold text-lg\">{brand}</div>\n        <Separator />\n        <nav className=\"flex flex-1 flex-col gap-1 p-2\">\n          <NavList nav={nav} />\n        </nav>\n      </aside>\n\n      <main className=\"flex-1 overflow-auto\">\n        {headerRight && (\n          <div className=\"hidden md:flex items-center justify-end border-b p-3\">{headerRight}</div>\n        )}\n        <div className=\"p-4 md:p-6\">{children}</div>\n      </main>\n    </div>\n  )\n}\n","import { useEffect } from 'react'\nimport type { ReactNode } from 'react'\nimport { useAuth } from '@liam-public/browser-react-auth'\n\nfunction DefaultFallback({ message }: { message: string }) {\n  return (\n    <div className=\"flex h-screen items-center justify-center\">\n      <p className=\"text-sm text-muted-foreground\">{message}</p>\n    </div>\n  )\n}\n\nexport interface RequireAuthProps {\n  readonly children: ReactNode\n  /** Rendered while loading or when unauthenticated (defaults to a \"Redirecting…\" line). */\n  readonly fallback?: ReactNode\n  /**\n   * Called once when the user is confirmed unauthenticated — e.g. trigger the OIDC\n   * redirect from `@liam-workspace/auth-client`, or navigate to `/login`.\n   */\n  readonly onUnauthenticated?: () => void\n}\n\n/**\n * Gate that renders `children` only for an authenticated user. Wraps `useAuth()` from\n * `@liam-public/browser-react-auth`, filling the route-guard gap that package leaves open.\n */\nexport function RequireAuth({ children, fallback, onUnauthenticated }: RequireAuthProps) {\n  const { isAuthenticated, isLoading } = useAuth()\n\n  useEffect(() => {\n    if (!isLoading && !isAuthenticated) onUnauthenticated?.()\n  }, [isLoading, isAuthenticated, onUnauthenticated])\n\n  if (isLoading) return <>{fallback ?? <DefaultFallback message=\"Loading…\" />}</>\n  if (!isAuthenticated) return <>{fallback ?? <DefaultFallback message=\"Redirecting to sign in…\" />}</>\n  return <>{children}</>\n}\n\nexport interface RequireRoleProps {\n  readonly children: ReactNode\n  /** The user is allowed if they hold ANY of these roles. */\n  readonly anyOf: readonly string[]\n  /** Extract the user's roles from the auth `user` object (shape is app-specific). */\n  readonly getRoles: (user: unknown) => readonly string[]\n  /** Rendered when the user lacks the required role(s). */\n  readonly fallback?: ReactNode\n}\n\n/** Gate that additionally requires the authenticated user to hold one of `anyOf` roles. */\nexport function RequireRole({ children, anyOf, getRoles, fallback }: RequireRoleProps) {\n  const { user, isLoading, isAuthenticated } = useAuth()\n  if (isLoading) return <>{fallback ?? <DefaultFallback message=\"Loading…\" />}</>\n  if (!isAuthenticated) return <>{fallback ?? <DefaultFallback message=\"Not signed in.\" />}</>\n  const roles = getRoles(user)\n  const allowed = anyOf.some((r) => roles.includes(r))\n  if (!allowed) return <>{fallback ?? <DefaultFallback message=\"You don't have access to this page.\" />}</>\n  return <>{children}</>\n}\n","import type { ReactNode } from 'react'\n\nexport interface PageHeaderProps {\n  readonly title: string\n  readonly action?: ReactNode\n}\n\n/** A page title row with an optional right-aligned action (e.g. a \"New\" button). */\nexport function PageHeader({ title, action }: PageHeaderProps) {\n  return (\n    <div className=\"flex items-center justify-between\">\n      <h1 className=\"text-2xl font-bold\">{title}</h1>\n      {action}\n    </div>\n  )\n}\n\nexport interface PageStackProps {\n  readonly children: ReactNode\n  readonly spacing?: 4 | 6\n}\n\n/** Vertical spacing container for page sections. */\nexport function PageStack({ children, spacing = 6 }: PageStackProps) {\n  return <div className={spacing === 4 ? 'space-y-4' : 'space-y-6'}>{children}</div>\n}\n","import type { ReactNode } from 'react'\n\n/** Renders children only at md and up (desktop table view). */\nexport function DesktopOnly({ children }: { children: ReactNode }) {\n  return <div className=\"hidden md:block\">{children}</div>\n}\n\n/** Renders children only below md (stacked-card view). */\nexport function MobileCards({ children }: { children: ReactNode }) {\n  return <div className=\"flex flex-col gap-3 md:hidden\">{children}</div>\n}\n\n/** A single stacked card used inside MobileCards. */\nexport function MobileCard({ children }: { children: ReactNode }) {\n  return <div className=\"rounded-lg border bg-card p-3 text-sm\">{children}</div>\n}\n\n/** A label/value line inside a MobileCard. */\nexport function MobileField({ label, children }: { label: string; children: ReactNode }) {\n  return (\n    <div className=\"flex items-start justify-between gap-3 py-0.5\">\n      <span className=\"text-muted-foreground\">{label}</span>\n      <span className=\"text-right font-medium break-words\">{children}</span>\n    </div>\n  )\n}\n","import { Loader2 } from 'lucide-react'\nimport {\n  Button,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n} from '@liam-public/browser-react-ui'\n\nexport interface LoadingSpinnerProps {\n  readonly size?: 'md' | 'lg'\n}\n\n/** Centered spinner for loading states. */\nexport function LoadingSpinner({ size = 'md' }: LoadingSpinnerProps) {\n  const padding = size === 'lg' ? 'py-16' : 'py-8'\n  const icon = size === 'lg' ? 'h-8 w-8' : 'h-6 w-6'\n  return (\n    <div className={`flex items-center justify-center ${padding}`}>\n      <Loader2 className={`${icon} animate-spin text-muted-foreground`} />\n    </div>\n  )\n}\n\nexport interface ConfirmDialogProps {\n  readonly open: boolean\n  readonly onOpenChange: (open: boolean) => void\n  readonly title: string\n  readonly description: string\n  readonly onConfirm: () => void\n  readonly loading?: boolean\n  readonly error?: string | null\n  /** Confirm-button label (defaults to \"Confirm\"). */\n  readonly confirmLabel?: string\n  /** Set true for destructive actions (red confirm button). */\n  readonly destructive?: boolean\n}\n\n/** A modal confirm dialog with loading + error states. */\nexport function ConfirmDialog({\n  open,\n  onOpenChange,\n  title,\n  description,\n  onConfirm,\n  loading,\n  error,\n  confirmLabel = 'Confirm',\n  destructive,\n}: ConfirmDialogProps) {\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange}>\n      <DialogContent>\n        <DialogHeader>\n          <DialogTitle>{title}</DialogTitle>\n          <DialogDescription>{description}</DialogDescription>\n        </DialogHeader>\n        {error && <p className=\"text-sm text-destructive\">{error}</p>}\n        <DialogFooter>\n          <Button variant=\"outline\" onClick={() => onOpenChange(false)} disabled={loading}>\n            Cancel\n          </Button>\n          <Button\n            variant={destructive ? 'destructive' : 'default'}\n            onClick={onConfirm}\n            disabled={loading}\n          >\n            {loading && <Loader2 className=\"h-4 w-4 animate-spin\" />}\n            {confirmLabel}\n          </Button>\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  )\n}\n"],"mappings":"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","names":["Fragment","jsx","jsx","jsxs","jsx","jsxs","Button","jsx","jsxs"]}
+{"version":3,"sources":["../src/cms-layout.tsx","../src/page.tsx","../src/responsive-table.tsx","../src/feedback.tsx","../src/guards.tsx","../src/theme.tsx","../src/toast.tsx","../src/form.tsx","../src/data-table.tsx","../src/dashboard.tsx","../src/analytics.tsx","../src/i18n.tsx","../src/wire.ts"],"sourcesContent":["import { useState } from 'react'\nimport type { ComponentType, ReactNode } from 'react'\nimport { NavLink } from 'react-router-dom'\nimport { Menu } from 'lucide-react'\nimport {\n  Button,\n  Separator,\n  Sheet,\n  SheetContent,\n  SheetTrigger,\n  cn,\n} from '@liam-public/browser-react-ui'\n\n/** A single sidebar navigation entry. `icon` is any lucide-react (or compatible) icon. */\nexport interface NavItem {\n  readonly to: string\n  readonly label: string\n  readonly icon: ComponentType<{ className?: string }>\n  /** Exact-match the route (e.g. for the index `/`). */\n  readonly end?: boolean\n  /** Optional trailing content, e.g. an alert count `<Badge>`. */\n  readonly badge?: ReactNode\n}\n\nfunction NavList({ nav, onNavigate }: { nav: readonly NavItem[]; onNavigate?: () => void }) {\n  return (\n    <>\n      {nav.map((item) => (\n        <NavLink\n          key={item.to}\n          to={item.to}\n          end={item.end}\n          onClick={onNavigate}\n          className={({ isActive }) =>\n            cn(\n              'flex items-center gap-2 rounded-md px-3 py-2 text-sm font-medium transition-colors hover:bg-accent',\n              isActive && 'bg-accent text-accent-foreground',\n            )\n          }\n        >\n          <item.icon className=\"h-4 w-4\" />\n          {item.label}\n          {item.badge != null && <span className=\"ml-auto\">{item.badge}</span>}\n        </NavLink>\n      ))}\n    </>\n  )\n}\n\nexport interface CmsLayoutProps {\n  readonly children: ReactNode\n  /** Sidebar navigation entries. */\n  readonly nav: readonly NavItem[]\n  /** Brand shown at the top of the sidebar (defaults to \"CMS\"). */\n  readonly brand?: ReactNode\n  /** Optional content for the top-right of the desktop header (e.g. a user menu). */\n  readonly headerRight?: ReactNode\n}\n\n/**\n * Responsive CMS app shell: a desktop sidebar (md+) and a mobile hamburger sheet,\n * with an active-link-aware nav driven entirely by the `nav` prop. Bring your own\n * router (`react-router-dom`) and Tailwind theme.\n */\nexport function CmsLayout({ children, nav, brand = 'CMS', headerRight }: CmsLayoutProps) {\n  const [open, setOpen] = useState(false)\n  return (\n    <div className=\"flex h-screen flex-col md:flex-row\">\n      {/* Mobile top bar (hidden at md+) */}\n      <header className=\"flex items-center gap-2 border-b p-3 md:hidden\">\n        <Sheet open={open} onOpenChange={setOpen}>\n          <SheetTrigger asChild>\n            <Button variant=\"ghost\" size=\"icon\" aria-label=\"Open menu\" className=\"h-11 w-11\">\n              <Menu className=\"h-5 w-5\" />\n            </Button>\n          </SheetTrigger>\n          <SheetContent side=\"left\" className=\"p-0\">\n            <div className=\"p-4 font-semibold text-lg\">{brand}</div>\n            <Separator />\n            <nav className=\"flex flex-col gap-1 p-2\">\n              <NavList nav={nav} onNavigate={() => setOpen(false)} />\n            </nav>\n          </SheetContent>\n        </Sheet>\n        <span className=\"font-semibold\">{brand}</span>\n      </header>\n\n      {/* Desktop sidebar (hidden below md) */}\n      <aside className=\"hidden md:flex w-56 border-r bg-muted/30 flex-col\">\n        <div className=\"p-4 font-semibold text-lg\">{brand}</div>\n        <Separator />\n        <nav className=\"flex flex-1 flex-col gap-1 p-2\">\n          <NavList nav={nav} />\n        </nav>\n      </aside>\n\n      <main className=\"flex-1 overflow-auto\">\n        {headerRight && (\n          <div className=\"hidden md:flex items-center justify-end border-b p-3\">{headerRight}</div>\n        )}\n        <div className=\"p-4 md:p-6\">{children}</div>\n      </main>\n    </div>\n  )\n}\n","import type { ReactNode } from 'react'\n\nexport interface PageHeaderProps {\n  readonly title: string\n  readonly action?: ReactNode\n}\n\n/** A page title row with an optional right-aligned action (e.g. a \"New\" button). */\nexport function PageHeader({ title, action }: PageHeaderProps) {\n  return (\n    <div className=\"flex items-center justify-between\">\n      <h1 className=\"text-2xl font-bold\">{title}</h1>\n      {action}\n    </div>\n  )\n}\n\nexport interface PageStackProps {\n  readonly children: ReactNode\n  readonly spacing?: 4 | 6\n}\n\n/** Vertical spacing container for page sections. */\nexport function PageStack({ children, spacing = 6 }: PageStackProps) {\n  return <div className={spacing === 4 ? 'space-y-4' : 'space-y-6'}>{children}</div>\n}\n","import type { ReactNode } from 'react'\n\n/** Renders children only at md and up (desktop table view). */\nexport function DesktopOnly({ children }: { children: ReactNode }) {\n  return <div className=\"hidden md:block\">{children}</div>\n}\n\n/** Renders children only below md (stacked-card view). */\nexport function MobileCards({ children }: { children: ReactNode }) {\n  return <div className=\"flex flex-col gap-3 md:hidden\">{children}</div>\n}\n\n/** A single stacked card used inside MobileCards. */\nexport function MobileCard({ children }: { children: ReactNode }) {\n  return <div className=\"rounded-lg border bg-card p-3 text-sm\">{children}</div>\n}\n\n/** A label/value line inside a MobileCard. */\nexport function MobileField({ label, children }: { label: string; children: ReactNode }) {\n  return (\n    <div className=\"flex items-start justify-between gap-3 py-0.5\">\n      <span className=\"text-muted-foreground\">{label}</span>\n      <span className=\"text-right font-medium break-words\">{children}</span>\n    </div>\n  )\n}\n","import { Loader2 } from 'lucide-react'\nimport {\n  Button,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n} from '@liam-public/browser-react-ui'\n\nexport interface LoadingSpinnerProps {\n  readonly size?: 'md' | 'lg'\n}\n\n/** Centered spinner for loading states. */\nexport function LoadingSpinner({ size = 'md' }: LoadingSpinnerProps) {\n  const padding = size === 'lg' ? 'py-16' : 'py-8'\n  const icon = size === 'lg' ? 'h-8 w-8' : 'h-6 w-6'\n  return (\n    <div className={`flex items-center justify-center ${padding}`}>\n      <Loader2 className={`${icon} animate-spin text-muted-foreground`} />\n    </div>\n  )\n}\n\nexport interface ConfirmDialogProps {\n  readonly open: boolean\n  readonly onOpenChange: (open: boolean) => void\n  readonly title: string\n  readonly description: string\n  readonly onConfirm: () => void\n  readonly loading?: boolean\n  readonly error?: string | null\n  /** Confirm-button label (defaults to \"Confirm\"). */\n  readonly confirmLabel?: string\n  /** Set true for destructive actions (red confirm button). */\n  readonly destructive?: boolean\n}\n\n/** A modal confirm dialog with loading + error states. */\nexport function ConfirmDialog({\n  open,\n  onOpenChange,\n  title,\n  description,\n  onConfirm,\n  loading,\n  error,\n  confirmLabel = 'Confirm',\n  destructive,\n}: ConfirmDialogProps) {\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange}>\n      <DialogContent>\n        <DialogHeader>\n          <DialogTitle>{title}</DialogTitle>\n          <DialogDescription>{description}</DialogDescription>\n        </DialogHeader>\n        {error && <p className=\"text-sm text-destructive\">{error}</p>}\n        <DialogFooter>\n          <Button variant=\"outline\" onClick={() => onOpenChange(false)} disabled={loading}>\n            Cancel\n          </Button>\n          <Button\n            variant={destructive ? 'destructive' : 'default'}\n            onClick={onConfirm}\n            disabled={loading}\n          >\n            {loading && <Loader2 className=\"h-4 w-4 animate-spin\" />}\n            {confirmLabel}\n          </Button>\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  )\n}\n","import { useEffect } from 'react'\nimport type { ReactNode } from 'react'\nimport { useAuth } from '@liam-public/browser-react-auth'\n\nfunction DefaultFallback({ message }: { message: string }) {\n  return (\n    <div className=\"flex h-screen items-center justify-center\">\n      <p className=\"text-sm text-muted-foreground\">{message}</p>\n    </div>\n  )\n}\n\nexport interface RequireAuthProps {\n  readonly children: ReactNode\n  /** Rendered while loading or when unauthenticated (defaults to a \"Redirecting…\" line). */\n  readonly fallback?: ReactNode\n  /**\n   * Called once when the user is confirmed unauthenticated — e.g. trigger the OIDC\n   * redirect from `@liam-workspace/auth-client`, or navigate to `/login`.\n   */\n  readonly onUnauthenticated?: () => void\n}\n\n/**\n * Gate that renders `children` only for an authenticated user. Wraps `useAuth()` from\n * `@liam-public/browser-react-auth`, filling the route-guard gap that package leaves open.\n */\nexport function RequireAuth({ children, fallback, onUnauthenticated }: RequireAuthProps) {\n  const { isAuthenticated, isLoading } = useAuth()\n\n  useEffect(() => {\n    if (!isLoading && !isAuthenticated) onUnauthenticated?.()\n  }, [isLoading, isAuthenticated, onUnauthenticated])\n\n  if (isLoading) return <>{fallback ?? <DefaultFallback message=\"Loading…\" />}</>\n  if (!isAuthenticated) return <>{fallback ?? <DefaultFallback message=\"Redirecting to sign in…\" />}</>\n  return <>{children}</>\n}\n\nexport interface RequireRoleProps {\n  readonly children: ReactNode\n  /** The user is allowed if they hold ANY of these roles. */\n  readonly anyOf: readonly string[]\n  /** Extract the user's roles from the auth `user` object (shape is app-specific). */\n  readonly getRoles: (user: unknown) => readonly string[]\n  /** Rendered when the user lacks the required role(s). */\n  readonly fallback?: ReactNode\n}\n\n/** Gate that additionally requires the authenticated user to hold one of `anyOf` roles. */\nexport function RequireRole({ children, anyOf, getRoles, fallback }: RequireRoleProps) {\n  const { user, isLoading, isAuthenticated } = useAuth()\n  if (isLoading) return <>{fallback ?? <DefaultFallback message=\"Loading…\" />}</>\n  if (!isAuthenticated) return <>{fallback ?? <DefaultFallback message=\"Not signed in.\" />}</>\n  const roles = getRoles(user)\n  const allowed = anyOf.some((r) => roles.includes(r))\n  if (!allowed) return <>{fallback ?? <DefaultFallback message=\"You don't have access to this page.\" />}</>\n  return <>{children}</>\n}\n","import { createContext, useCallback, useContext, useEffect, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { Moon, Sun } from 'lucide-react'\nimport { Button } from '@liam-public/browser-react-ui'\n\nexport type Theme = 'light' | 'dark' | 'system'\n\nexport interface ThemeContextValue {\n  readonly theme: Theme\n  readonly resolved: 'light' | 'dark'\n  readonly setTheme: (theme: Theme) => void\n  readonly toggle: () => void\n}\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null)\n\nfunction readStored(key: string): string | null {\n  try {\n    return typeof localStorage !== 'undefined' ? localStorage.getItem(key) : null\n  } catch {\n    return null // localStorage can throw (Safari private mode, stubbed/locked-down environments)\n  }\n}\n\nfunction writeStored(key: string, value: string): void {\n  try {\n    if (typeof localStorage !== 'undefined') localStorage.setItem(key, value)\n  } catch {\n    /* ignore — running without persistence is acceptable */\n  }\n}\n\nfunction prefersDark(): boolean {\n  return typeof window !== 'undefined' && typeof window.matchMedia === 'function'\n    ? window.matchMedia('(prefers-color-scheme: dark)').matches\n    : false\n}\n\nfunction resolve(theme: Theme): 'light' | 'dark' {\n  return theme === 'system' ? (prefersDark() ? 'dark' : 'light') : theme\n}\n\nfunction applyClass(resolved: 'light' | 'dark') {\n  if (typeof document !== 'undefined') {\n    document.documentElement.classList.toggle('dark', resolved === 'dark')\n  }\n}\n\nexport interface ThemeProviderProps {\n  readonly children: ReactNode\n  readonly defaultTheme?: Theme\n  readonly storageKey?: string\n}\n\n/** Manages light/dark/system theme, persists the choice, and toggles `.dark` on `<html>`. */\nexport function ThemeProvider({\n  children,\n  defaultTheme = 'system',\n  storageKey = 'cms-theme',\n}: ThemeProviderProps) {\n  const [theme, setThemeState] = useState<Theme>(\n    () => (readStored(storageKey) as Theme | null) ?? defaultTheme,\n  )\n\n  useEffect(() => {\n    applyClass(resolve(theme))\n  }, [theme])\n\n  // Track the OS preference while in `system` mode.\n  useEffect(() => {\n    if (theme !== 'system' || typeof window === 'undefined' || !window.matchMedia) return\n    const mq = window.matchMedia('(prefers-color-scheme: dark)')\n    const onChange = () => applyClass(resolve('system'))\n    mq.addEventListener('change', onChange)\n    return () => mq.removeEventListener('change', onChange)\n  }, [theme])\n\n  const setTheme = useCallback(\n    (next: Theme) => {\n      writeStored(storageKey, next)\n      setThemeState(next)\n    },\n    [storageKey],\n  )\n\n  const toggle = useCallback(() => {\n    setTheme(resolve(theme) === 'dark' ? 'light' : 'dark')\n  }, [theme, setTheme])\n\n  return (\n    <ThemeContext.Provider value={{ theme, resolved: resolve(theme), setTheme, toggle }}>\n      {children}\n    </ThemeContext.Provider>\n  )\n}\n\nexport function useTheme(): ThemeContextValue {\n  const ctx = useContext(ThemeContext)\n  if (!ctx) throw new Error('useTheme must be used within a <ThemeProvider>')\n  return ctx\n}\n\n/** A button that toggles light/dark. */\nexport function ThemeToggle() {\n  const { resolved, toggle } = useTheme()\n  return (\n    <Button variant=\"ghost\" size=\"icon\" onClick={toggle} aria-label=\"Toggle dark mode\">\n      {resolved === 'dark' ? <Sun className=\"h-5 w-5\" /> : <Moon className=\"h-5 w-5\" />}\n    </Button>\n  )\n}\n","import { createContext, useCallback, useContext, useRef, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { CheckCircle2, Info, X, XCircle } from 'lucide-react'\nimport { cn } from '@liam-public/browser-react-ui'\n\nexport type ToastVariant = 'default' | 'success' | 'error'\n\nexport interface ToastOptions {\n  readonly title?: string\n  readonly description?: string\n  readonly variant?: ToastVariant\n  /** Auto-dismiss after this many ms (default 5000; 0 disables). */\n  readonly duration?: number\n}\n\ninterface ToastItem extends ToastOptions {\n  readonly id: number\n  readonly variant: ToastVariant\n}\n\nexport interface ToastContextValue {\n  toast: (options: ToastOptions) => number\n  success: (title: string, description?: string) => number\n  error: (title: string, description?: string) => number\n  dismiss: (id: number) => void\n}\n\nconst ToastContext = createContext<ToastContextValue | null>(null)\n\nconst ICONS: Record<ToastVariant, typeof Info> = {\n  default: Info,\n  success: CheckCircle2,\n  error: XCircle,\n}\n\n/** Wrap the app to enable `useToast()`. Renders the toast viewport itself. */\nexport function ToastProvider({ children }: { children: ReactNode }) {\n  const [items, setItems] = useState<ToastItem[]>([])\n  const seq = useRef(0)\n\n  const dismiss = useCallback((id: number) => {\n    setItems((prev) => prev.filter((t) => t.id !== id))\n  }, [])\n\n  const toast = useCallback(\n    (options: ToastOptions) => {\n      const id = ++seq.current\n      const item: ToastItem = { id, variant: options.variant ?? 'default', ...options }\n      setItems((prev) => [...prev, item])\n      const duration = options.duration ?? 5000\n      if (duration > 0) setTimeout(() => dismiss(id), duration)\n      return id\n    },\n    [dismiss],\n  )\n\n  const success = useCallback((title: string, description?: string) => toast({ title, description, variant: 'success' }), [toast])\n  const error = useCallback((title: string, description?: string) => toast({ title, description, variant: 'error' }), [toast])\n\n  return (\n    <ToastContext.Provider value={{ toast, success, error, dismiss }}>\n      {children}\n      <div className=\"pointer-events-none fixed bottom-4 right-4 z-50 flex w-full max-w-sm flex-col gap-2\">\n        {items.map((t) => {\n          const Icon = ICONS[t.variant]\n          return (\n            <div\n              key={t.id}\n              role=\"status\"\n              className={cn(\n                'pointer-events-auto flex items-start gap-2 rounded-lg border bg-card p-3 text-sm shadow-lg',\n                t.variant === 'error' && 'border-destructive/40',\n                t.variant === 'success' && 'border-green-500/40',\n              )}\n            >\n              <Icon\n                className={cn(\n                  'mt-0.5 h-4 w-4 shrink-0',\n                  t.variant === 'error' && 'text-destructive',\n                  t.variant === 'success' && 'text-green-600',\n                  t.variant === 'default' && 'text-muted-foreground',\n                )}\n              />\n              <div className=\"flex-1\">\n                {t.title && <p className=\"font-medium\">{t.title}</p>}\n                {t.description && <p className=\"text-muted-foreground\">{t.description}</p>}\n              </div>\n              <button\n                onClick={() => dismiss(t.id)}\n                aria-label=\"Dismiss\"\n                className=\"text-muted-foreground hover:text-foreground\"\n              >\n                <X className=\"h-4 w-4\" />\n              </button>\n            </div>\n          )\n        })}\n      </div>\n    </ToastContext.Provider>\n  )\n}\n\nexport function useToast(): ToastContextValue {\n  const ctx = useContext(ToastContext)\n  if (!ctx) throw new Error('useToast must be used within a <ToastProvider>')\n  return ctx\n}\n","import type { ReactNode } from 'react'\nimport {\n  FormProvider,\n  useForm,\n  useFormContext,\n  type DefaultValues,\n  type FieldValues,\n  type Path,\n  type SubmitHandler,\n  type UseFormReturn,\n} from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { ZodType } from 'zod'\nimport { Button, Input, Label } from '@liam-public/browser-react-ui'\n\n/** A react-hook-form instance validated by a Zod schema. */\nexport function useResourceForm<T extends FieldValues>(\n  schema: ZodType<T>,\n  defaultValues?: DefaultValues<T>,\n): UseFormReturn<T> {\n  return useForm<T>({\n    // resolver generics across zod 3/4 are loose; the runtime validation is correct.\n    resolver: zodResolver(schema as never) as never,\n    defaultValues,\n  })\n}\n\nexport interface ResourceFormProps<T extends FieldValues> {\n  readonly schema: ZodType<T>\n  readonly defaultValues?: DefaultValues<T>\n  readonly onSubmit: SubmitHandler<T>\n  readonly children: ReactNode\n  readonly submitLabel?: string\n  /** Optional extra footer content (e.g. a Cancel button) rendered next to Submit. */\n  readonly footer?: ReactNode\n}\n\n/**\n * A Zod-validated form. Wrap `<TextField>`/`<TextareaField>` (or any field using\n * `useFormContext`) as children; submit is wired with validation + a disabled-while-submitting button.\n */\nexport function ResourceForm<T extends FieldValues>({\n  schema,\n  defaultValues,\n  onSubmit,\n  children,\n  submitLabel = 'Save',\n  footer,\n}: ResourceFormProps<T>) {\n  const form = useResourceForm<T>(schema, defaultValues)\n  return (\n    <FormProvider {...form}>\n      <form onSubmit={form.handleSubmit(onSubmit)} className=\"space-y-4\">\n        {children}\n        <div className=\"flex items-center justify-end gap-2\">\n          {footer}\n          <Button type=\"submit\" disabled={form.formState.isSubmitting}>\n            {submitLabel}\n          </Button>\n        </div>\n      </form>\n    </FormProvider>\n  )\n}\n\ninterface FieldProps<T extends FieldValues> {\n  readonly name: Path<T>\n  readonly label: string\n  readonly placeholder?: string\n  readonly type?: string\n}\n\nfunction useFieldError<T extends FieldValues>(name: Path<T>): string | undefined {\n  const {\n    formState: { errors },\n  } = useFormContext<T>()\n  const err = errors[name]\n  return err?.message as string | undefined\n}\n\n/** A labelled text input bound to the surrounding `ResourceForm` with inline validation errors. */\nexport function TextField<T extends FieldValues>({ name, label, placeholder, type = 'text' }: FieldProps<T>) {\n  const { register } = useFormContext<T>()\n  const error = useFieldError<T>(name)\n  return (\n    <div className=\"space-y-1.5\">\n      <Label htmlFor={name}>{label}</Label>\n      <Input id={name} type={type} placeholder={placeholder} aria-invalid={!!error} {...register(name)} />\n      {error && <p className=\"text-sm text-destructive\">{error}</p>}\n    </div>\n  )\n}\n\n/** A labelled textarea bound to the surrounding `ResourceForm`. */\nexport function TextareaField<T extends FieldValues>({ name, label, placeholder }: FieldProps<T>) {\n  const { register } = useFormContext<T>()\n  const error = useFieldError<T>(name)\n  return (\n    <div className=\"space-y-1.5\">\n      <Label htmlFor={name}>{label}</Label>\n      <textarea\n        id={name}\n        placeholder={placeholder}\n        aria-invalid={!!error}\n        className=\"flex min-h-20 w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50\"\n        {...register(name)}\n      />\n      {error && <p className=\"text-sm text-destructive\">{error}</p>}\n    </div>\n  )\n}\n","import { useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { ChevronLeft, ChevronRight } from 'lucide-react'\nimport {\n  Button,\n  Table,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableHeader,\n  TableRow,\n} from '@liam-public/browser-react-ui'\nimport { useList } from '@liam-public/browser-react-data'\nimport type { ListParams } from '@liam-public/browser-react-data'\nimport { LoadingSpinner } from './feedback.js'\n\nexport interface Column<T> {\n  /** Key into the row, used for the default cell value + as a React key. */\n  readonly key: string\n  readonly header: string\n  /** Custom cell renderer; defaults to `String(row[key])`. */\n  readonly render?: (row: T) => ReactNode\n  readonly className?: string\n}\n\nexport interface PaginationProps {\n  readonly page: number\n  readonly pageCount: number\n  readonly onPageChange: (page: number) => void\n}\n\n/** Prev/next pager with a page indicator. */\nexport function Pagination({ page, pageCount, onPageChange }: PaginationProps) {\n  if (pageCount <= 1) return null\n  return (\n    <div className=\"flex items-center justify-end gap-2 pt-3 text-sm\">\n      <span className=\"text-muted-foreground\">\n        Page {page} of {pageCount}\n      </span>\n      <Button variant=\"outline\" size=\"icon-sm\" disabled={page <= 1} onClick={() => onPageChange(page - 1)} aria-label=\"Previous page\">\n        <ChevronLeft className=\"h-4 w-4\" />\n      </Button>\n      <Button variant=\"outline\" size=\"icon-sm\" disabled={page >= pageCount} onClick={() => onPageChange(page + 1)} aria-label=\"Next page\">\n        <ChevronRight className=\"h-4 w-4\" />\n      </Button>\n    </div>\n  )\n}\n\nexport interface DataTableProps<T> {\n  readonly resource: string\n  readonly columns: readonly Column<T>[]\n  readonly pageSize?: number\n  /** Extra list params (sort/filter) merged into each query. */\n  readonly params?: Omit<ListParams, 'page' | 'pageSize'>\n  readonly emptyMessage?: string\n}\n\n/**\n * A paginated table for a resource, fed by `useList` from `@liam-public/browser-react-data`.\n * Requires a `<DataProviderProvider>` + a `QueryClientProvider` above it.\n */\nexport function DataTable<T extends Record<string, unknown>>({\n  resource,\n  columns,\n  pageSize = 20,\n  params,\n  emptyMessage = 'No records.',\n}: DataTableProps<T>) {\n  const [page, setPage] = useState(1)\n  const { data, isLoading, isError, error } = useList<T>(resource, { page, pageSize, ...params })\n\n  if (isLoading) return <LoadingSpinner />\n  if (isError) return <p className=\"py-8 text-center text-sm text-destructive\">{(error as Error)?.message ?? 'Failed to load.'}</p>\n\n  const rows = data?.data ?? []\n  const total = data?.total ?? 0\n  const pageCount = Math.max(1, Math.ceil(total / pageSize))\n\n  if (rows.length === 0) {\n    return <p className=\"py-8 text-center text-sm text-muted-foreground\">{emptyMessage}</p>\n  }\n\n  return (\n    <div>\n      <Table>\n        <TableHeader>\n          <TableRow>\n            {columns.map((c) => (\n              <TableHead key={c.key} className={c.className}>\n                {c.header}\n              </TableHead>\n            ))}\n          </TableRow>\n        </TableHeader>\n        <TableBody>\n          {rows.map((row, i) => (\n            <TableRow key={(row.id as string) ?? i}>\n              {columns.map((c) => (\n                <TableCell key={c.key} className={c.className}>\n                  {c.render ? c.render(row) : String(row[c.key] ?? '')}\n                </TableCell>\n              ))}\n            </TableRow>\n          ))}\n        </TableBody>\n      </Table>\n      <Pagination page={page} pageCount={pageCount} onPageChange={setPage} />\n    </div>\n  )\n}\n","import type { ComponentType, ReactNode } from 'react'\nimport { Card, CardContent, CardHeader, CardTitle, cn } from '@liam-public/browser-react-ui'\n\nexport interface StatCardProps {\n  readonly label: string\n  readonly value: ReactNode\n  readonly icon?: ComponentType<{ className?: string }>\n  readonly hint?: string\n  readonly className?: string\n}\n\n/** A KPI card: label, big value, optional icon + hint. */\nexport function StatCard({ label, value, icon: Icon, hint, className }: StatCardProps) {\n  return (\n    <Card className={className}>\n      <CardHeader className=\"flex flex-row items-center justify-between space-y-0 pb-2\">\n        <CardTitle className=\"text-sm font-medium text-muted-foreground\">{label}</CardTitle>\n        {Icon && <Icon className=\"h-4 w-4 text-muted-foreground\" />}\n      </CardHeader>\n      <CardContent>\n        <div className=\"text-2xl font-bold\">{value}</div>\n        {hint && <p className=\"text-xs text-muted-foreground\">{hint}</p>}\n      </CardContent>\n    </Card>\n  )\n}\n\n/** Responsive grid of KPI cards (1 / 2 / 4 columns). */\nexport function StatGrid({ children, columns = 4 }: { children: ReactNode; columns?: 2 | 3 | 4 }) {\n  const cols = columns === 2 ? 'sm:grid-cols-2' : columns === 3 ? 'sm:grid-cols-2 lg:grid-cols-3' : 'sm:grid-cols-2 lg:grid-cols-4'\n  return <div className={cn('grid grid-cols-1 gap-4', cols)}>{children}</div>\n}\n\nexport interface ChartCardProps {\n  readonly title: string\n  readonly children: ReactNode\n  readonly height?: number\n  readonly action?: ReactNode\n}\n\n/**\n * A titled card sized for a chart. Put a recharts `<ResponsiveContainer>` (or any chart)\n * inside; `recharts` is a dependency so apps don't need to install it separately.\n */\nexport function ChartCard({ title, children, height = 280, action }: ChartCardProps) {\n  return (\n    <Card>\n      <CardHeader className=\"flex flex-row items-center justify-between space-y-0\">\n        <CardTitle className=\"text-base\">{title}</CardTitle>\n        {action}\n      </CardHeader>\n      <CardContent>\n        <div style={{ height }}>{children}</div>\n      </CardContent>\n    </Card>\n  )\n}\n\nexport {\n  ResponsiveContainer,\n  LineChart,\n  Line,\n  BarChart,\n  Bar,\n  AreaChart,\n  Area,\n  XAxis,\n  YAxis,\n  CartesianGrid,\n  Tooltip,\n  Legend,\n} from 'recharts'\n","import { createContext, useContext, useEffect, useRef } from 'react'\nimport type { ReactNode } from 'react'\nimport { useLocation } from 'react-router-dom'\n\n/** Pluggable analytics sink. Implement once (or use a provided adapter) and call from anywhere. */\nexport interface AnalyticsAdapter {\n  pageView(path: string): void\n  track(event: string, props?: Record<string, unknown>): void\n}\n\nconst noop: AnalyticsAdapter = { pageView: () => {}, track: () => {} }\nconst AnalyticsContext = createContext<AnalyticsAdapter>(noop)\n\nexport function AnalyticsProvider({ adapter, children }: { adapter: AnalyticsAdapter; children: ReactNode }) {\n  return <AnalyticsContext.Provider value={adapter}>{children}</AnalyticsContext.Provider>\n}\n\nexport function useAnalytics(): AnalyticsAdapter {\n  return useContext(AnalyticsContext)\n}\n\n/** Fire a `pageView` on every router path change. Mount once inside the Router + AnalyticsProvider. */\nexport function usePageViews() {\n  const analytics = useAnalytics()\n  const location = useLocation()\n  const last = useRef<string>('')\n  useEffect(() => {\n    const path = location.pathname + location.search\n    if (path !== last.current) {\n      last.current = path\n      analytics.pageView(path)\n    }\n  }, [location, analytics])\n}\n\n/** A beacon adapter that POSTs events to an ingest endpoint (uses `sendBeacon` when available). */\nexport function createBeaconAnalytics(options: { endpoint: string; app?: string }): AnalyticsAdapter {\n  const send = (type: 'pageView' | 'track', payload: Record<string, unknown>) => {\n    const body = JSON.stringify({ type, app: options.app, ts: new Date().toISOString(), ...payload })\n    if (typeof navigator !== 'undefined' && navigator.sendBeacon) {\n      navigator.sendBeacon(options.endpoint, new Blob([body], { type: 'application/json' }))\n    } else if (typeof fetch !== 'undefined') {\n      void fetch(options.endpoint, { method: 'POST', headers: { 'content-type': 'application/json' }, body, keepalive: true })\n    }\n  }\n  return {\n    pageView: (path) => send('pageView', { path }),\n    track: (event, props) => send('track', { event, props }),\n  }\n}\n\n/** A console adapter for local development. */\nexport function createConsoleAnalytics(): AnalyticsAdapter {\n  return {\n    pageView: (path) => console.info('[analytics] pageView', path),\n    track: (event, props) => console.info('[analytics] track', event, props),\n  }\n}\n","import type { ReactNode } from 'react'\nimport i18next, { type i18n as I18nInstance, type Resource } from 'i18next'\nimport { I18nextProvider, initReactI18next, useTranslation } from 'react-i18next'\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from '@liam-public/browser-react-ui'\n\nexport interface CreateI18nOptions {\n  /** i18next resource bundles: `{ en: { translation: {...} }, vi: { translation: {...} } }`. */\n  readonly resources: Resource\n  readonly lng?: string\n  readonly fallbackLng?: string\n}\n\n/** Create a configured, isolated i18next instance for the CMS. */\nexport function createI18n(options: CreateI18nOptions): I18nInstance {\n  const instance = i18next.createInstance()\n  void instance.use(initReactI18next).init({\n    resources: options.resources,\n    lng: options.lng ?? 'en',\n    fallbackLng: options.fallbackLng ?? 'en',\n    interpolation: { escapeValue: false },\n  })\n  return instance\n}\n\nexport function I18nProvider({ i18n, children }: { i18n: I18nInstance; children: ReactNode }) {\n  return <I18nextProvider i18n={i18n}>{children}</I18nextProvider>\n}\n\nexport { useTranslation }\n\nexport interface LanguageOption {\n  readonly code: string\n  readonly label: string\n}\n\n/** A dropdown that switches the active i18next language. */\nexport function LanguageSwitcher({ languages }: { languages: readonly LanguageOption[] }) {\n  const { i18n } = useTranslation()\n  return (\n    <Select value={i18n.language} onValueChange={(value) => void i18n.changeLanguage(value)}>\n      <SelectTrigger className=\"w-36\">\n        <SelectValue />\n      </SelectTrigger>\n      <SelectContent>\n        {languages.map((l) => (\n          <SelectItem key={l.code} value={l.code}>\n            {l.label}\n          </SelectItem>\n        ))}\n      </SelectContent>\n    </Select>\n  )\n}\n","// \"Wire the existing\": re-export the already-solved cross-cutting pieces so a CMS app\n// gets auth + datetime/number formatting from this one package.\n\nexport { AuthProvider, useAuth, createAuthenticatedFetch } from '@liam-public/browser-react-auth'\nexport type { AuthContextValue } from '@liam-public/browser-react-auth'\n\nexport {\n  formatDate,\n  formatCurrency,\n  formatNumber,\n  formatPercentage,\n  formatFileSize,\n  selectText,\n  isLocalizedText,\n} from '@liam-public/text'\nexport type { LocalizedText } from '@liam-public/text'\n"],"mappings":"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","names":["jsx","jsxs","jsx","jsxs","Button","jsx","jsxs","Fragment","jsx","useEffect","useState","Button","jsx","createContext","useCallback","useContext","useState","cn","jsx","jsxs","Button","jsx","jsxs","useState","Button","jsx","jsxs","Button","useState","cn","jsx","jsxs","createContext","useContext","useEffect","useRef","jsx","jsx","jsxs","jsxs","jsx","useAuth"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@liam-public/browser-react-cms",
-  "version": "0.1.0",
-  "description": "Reusable CMS/admin chrome: responsive app-shell, auth route-guards, and page primitives, on Tailwind v4 + Radix.",
+  "version": "0.2.0",
+  "description": "Batteries-included CMS framework: app-shell, auth guards, dark mode, toasts, Zod forms, data-table + pagination, dashboards, analytics, and i18n, on Tailwind v4 + Radix.",
   "type": "module",
   "liamCompatibility": {
     "runtime": [
@@ -30,23 +30,35 @@
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "react-router-dom": "^7.0.0"
+    "react-hook-form": "^7.0.0",
+    "react-router-dom": "^7.0.0",
+    "zod": "^3.23.0 || ^4.0.0"
   },
   "dependencies": {
+    "@hookform/resolvers": "^5.0.0",
+    "i18next": "^25.0.0",
     "lucide-react": "^0.563.0",
+    "react-i18next": "^15.0.0",
+    "recharts": "^2.13.0",
     "@liam-public/browser-react-auth": "0.1.0",
+    "@liam-public/browser-react-data": "0.1.0",
+    "@liam-public/text": "0.1.0",
     "@liam-public/browser-react-ui": "0.1.0"
   },
   "devDependencies": {
+    "@tanstack/react-query": "^5.0.0",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "jsdom": "^27.0.1",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "react-router-dom": "^7.0.0"
+    "react-hook-form": "^7.53.0",
+    "react-router-dom": "^7.0.0",
+    "zod": "^4.0.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --sourcemap",

package/theme.css

@@ -1,32 +1,99 @@
 @import 'tailwindcss';
 
-@theme inline {
-  --color-background: oklch(1 0 0);
-  --color-foreground: oklch(0.145 0 0);
-  --color-card: oklch(1 0 0);
-  --color-card-foreground: oklch(0.145 0 0);
-  --color-popover: oklch(1 0 0);
-  --color-popover-foreground: oklch(0.145 0 0);
-  --color-primary: oklch(0.205 0 0);
-  --color-primary-foreground: oklch(0.985 0 0);
-  --color-secondary: oklch(0.97 0 0);
-  --color-secondary-foreground: oklch(0.205 0 0);
-  --color-muted: oklch(0.97 0 0);
-  --color-muted-foreground: oklch(0.556 0 0);
-  --color-accent: oklch(0.97 0 0);
-  --color-accent-foreground: oklch(0.205 0 0);
-  --color-destructive: oklch(0.577 0.245 27.325);
-  --color-destructive-foreground: oklch(0.577 0.245 27.325);
-  --color-border: oklch(0.922 0 0);
-  --color-input: oklch(0.922 0 0);
-  --color-ring: oklch(0.708 0 0);
+/* Enable `dark:` utilities driven by a `.dark` class on an ancestor (toggled by ThemeProvider). */
+@custom-variant dark (&:is(.dark *));
+
+:root {
   --radius: 0.625rem;
-  --color-sidebar: oklch(0.985 0 0);
-  --color-sidebar-foreground: oklch(0.145 0 0);
-  --color-sidebar-primary: oklch(0.205 0 0);
-  --color-sidebar-primary-foreground: oklch(0.985 0 0);
-  --color-sidebar-accent: oklch(0.97 0 0);
-  --color-sidebar-accent-foreground: oklch(0.205 0 0);
-  --color-sidebar-border: oklch(0.922 0 0);
-  --color-sidebar-ring: oklch(0.708 0 0);
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.922 0 0);
+  --sidebar-primary-foreground: oklch(0.205 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.556 0 0);
+}
+
+@theme inline {
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
 }