@checkstack/theme-frontend 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,88 @@
+# @checkstack/theme-frontend
+
+## 0.0.2
+
+### Patch Changes
+
+- d20d274: Initial release of all @checkstack packages. Rebranded from Checkmate to Checkstack with new npm organization @checkstack and domain checkstack.dev.
+- Updated dependencies [d20d274]
+  - @checkstack/auth-frontend@0.0.2
+  - @checkstack/common@0.0.2
+  - @checkstack/frontend-api@0.0.2
+  - @checkstack/theme-common@0.0.2
+  - @checkstack/ui@0.0.2
+
+## 0.1.4
+
+### Patch Changes
+
+- ae33df2: Move command palette from dashboard to centered navbar position
+
+  - Converted `command-frontend` into a plugin with `NavbarCenterSlot` extension
+  - Added compact `NavbarSearch` component with responsive search trigger
+  - Moved `SearchDialog` from dashboard-frontend to command-frontend
+  - Keyboard shortcut (⌘K / Ctrl+K) now works on every page
+  - Renamed navbar slots for clarity:
+    - `NavbarSlot` → `NavbarRightSlot`
+    - `NavbarMainSlot` → `NavbarLeftSlot`
+    - Added new `NavbarCenterSlot` for centered content
+
+- Updated dependencies [52231ef]
+- Updated dependencies [b0124ef]
+- Updated dependencies [54cc787]
+- Updated dependencies [a65e002]
+- Updated dependencies [ae33df2]
+- Updated dependencies [a65e002]
+- Updated dependencies [32ea706]
+  - @checkstack/auth-frontend@0.3.0
+  - @checkstack/ui@0.1.2
+  - @checkstack/common@0.2.0
+  - @checkstack/frontend-api@0.1.0
+  - @checkstack/theme-common@0.0.3
+
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies [1bf71bb]
+  - @checkstack/auth-frontend@0.2.1
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [e26c08e]
+  - @checkstack/auth-frontend@0.2.0
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [0f8cc7d]
+  - @checkstack/frontend-api@0.0.3
+  - @checkstack/auth-frontend@0.1.1
+  - @checkstack/ui@0.1.1
+
+## 0.1.0
+
+### Minor Changes
+
+- d673ab4: Add theme persistence for non-logged-in users via local storage
+
+  - Added `NavbarThemeToggle` component that shows a Sun/Moon button in the navbar for non-logged-in users
+  - Added `ThemeSynchronizer` component that loads theme from backend for logged-in users on page load
+  - Theme is now applied immediately on page load for logged-in users (no need to open user menu first)
+  - Non-logged-in users can now toggle theme, which persists in local storage
+  - Logged-in user's backend-saved theme takes precedence over local storage
+
+### Patch Changes
+
+- Updated dependencies [eff5b4e]
+- Updated dependencies [ffc28f6]
+- Updated dependencies [32f2535]
+- Updated dependencies [b354ab3]
+  - @checkstack/ui@0.1.0
+  - @checkstack/common@0.1.0
+  - @checkstack/auth-frontend@0.1.0
+  - @checkstack/frontend-api@0.0.2
+  - @checkstack/theme-common@0.0.2

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@checkstack/theme-frontend",
+  "version": "0.0.2",
+  "type": "module",
+  "main": "src/index.tsx",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "bun run lint:code",
+    "lint:code": "eslint . --max-warnings 0"
+  },
+  "dependencies": {
+    "@checkstack/theme-common": "workspace:*",
+    "@checkstack/frontend-api": "workspace:*",
+    "@checkstack/auth-frontend": "workspace:*",
+    "@checkstack/common": "workspace:*",
+    "@checkstack/ui": "workspace:*",
+    "react": "^18.2.0",
+    "lucide-react": "^0.344.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/react": "^18.2.0",
+    "@checkstack/tsconfig": "workspace:*",
+    "@checkstack/scripts": "workspace:*"
+  }
+}

package/src/components/NavbarThemeToggle.tsx

@@ -0,0 +1,47 @@
+import { Moon, Sun } from "lucide-react";
+import { useApi } from "@checkstack/frontend-api";
+import { authApiRef } from "@checkstack/auth-frontend/api";
+import { Button, useTheme } from "@checkstack/ui";
+
+/**
+ * Navbar theme toggle button for non-logged-in users.
+ *
+ * Shows a Sun/Moon icon button that toggles between light and dark themes.
+ * Only renders when user is NOT logged in (logged-in users use the toggle in UserMenu).
+ *
+ * Theme changes are saved to local storage via ThemeProvider.
+ */
+export const NavbarThemeToggle = () => {
+  const { theme, setTheme } = useTheme();
+  const authApi = useApi(authApiRef);
+  const { data: session, isPending } = authApi.useSession();
+
+  // Don't render while loading session
+  if (isPending) {
+    return;
+  }
+
+  // Don't render for logged-in users (they use UserMenu toggle)
+  if (session?.user) {
+    return;
+  }
+
+  const isDark = theme === "dark";
+
+  const handleToggle = () => {
+    const newTheme = isDark ? "light" : "dark";
+    setTheme(newTheme);
+  };
+
+  return (
+    <Button
+      variant="ghost"
+      size="icon"
+      onClick={handleToggle}
+      aria-label={isDark ? "Switch to light mode" : "Switch to dark mode"}
+      className="rounded-full"
+    >
+      {isDark ? <Sun className="h-5 w-5" /> : <Moon className="h-5 w-5" />}
+    </Button>
+  );
+};

package/src/components/ThemeSynchronizer.tsx

@@ -0,0 +1,68 @@
+import { useEffect, useRef } from "react";
+import { useApi, rpcApiRef } from "@checkstack/frontend-api";
+import { authApiRef } from "@checkstack/auth-frontend/api";
+import { useTheme } from "@checkstack/ui";
+import { ThemeApi } from "@checkstack/theme-common";
+
+/**
+ * Headless component that synchronizes theme on app initialization.
+ *
+ * - For logged-in users: fetches theme from backend and applies it
+ * - For non-logged-in users: theme is already read from local storage by ThemeProvider
+ * - Also syncs backend theme to local storage for continuity when logging out
+ *
+ * Must be rendered early in the app (e.g., via NavbarRightSlot) to ensure theme
+ * is applied before the user sees the page.
+ */
+export const ThemeSynchronizer = () => {
+  const { setTheme } = useTheme();
+  const authApi = useApi(authApiRef);
+  const rpcApi = useApi(rpcApiRef);
+  const themeClient = rpcApi.forPlugin(ThemeApi);
+  const { data: session, isPending } = authApi.useSession();
+
+  // Track if we've already synced for this session to avoid repeated API calls
+  const hasSyncedRef = useRef(false);
+  const lastUserIdRef = useRef<string | undefined>(undefined);
+
+  useEffect(() => {
+    // Wait for session to load
+    if (isPending) {
+      return;
+    }
+
+    const currentUserId = session?.user?.id ?? undefined;
+
+    // Reset sync state when user changes (login/logout)
+    if (currentUserId !== lastUserIdRef.current) {
+      hasSyncedRef.current = false;
+      lastUserIdRef.current = currentUserId;
+    }
+
+    // Only sync once per session
+    if (hasSyncedRef.current) {
+      return;
+    }
+
+    // For logged-in users, fetch theme from backend
+    if (session?.user) {
+      themeClient
+        .getTheme()
+        .then(({ theme }) => {
+          setTheme(theme);
+          hasSyncedRef.current = true;
+        })
+        .catch((error) => {
+          console.error("Failed to sync theme from backend:", error);
+          hasSyncedRef.current = true; // Still mark as synced to prevent retry loops
+        });
+    } else {
+      // For non-logged-in users, local storage theme is already applied
+      // by ThemeProvider, so nothing to do
+      hasSyncedRef.current = true;
+    }
+  }, [session, isPending, setTheme, themeClient]);
+
+  // Headless component - renders nothing
+  return <></>;
+};

package/src/components/ThemeToggleMenuItem.tsx

@@ -0,0 +1,69 @@
+import { useEffect, useState } from "react";
+import { Moon, Sun } from "lucide-react";
+import { Toggle, useTheme, useToast } from "@checkstack/ui";
+import { useApi, rpcApiRef } from "@checkstack/frontend-api";
+import { ThemeApi } from "@checkstack/theme-common";
+
+/**
+ * Theme toggle menu item for logged-in users (displayed in UserMenu).
+ *
+ * Saves theme to both backend (for persistence across devices) and
+ * local storage (for continuity when logging out).
+ *
+ * Theme initialization is handled by ThemeSynchronizer component.
+ */
+export const ThemeToggleMenuItem = () => {
+  const { theme, setTheme } = useTheme();
+  const rpcApi = useApi(rpcApiRef);
+  const themeClient = rpcApi.forPlugin(ThemeApi);
+
+  const [saving, setSaving] = useState(false);
+  const [isDark, setIsDark] = useState(theme === "dark");
+  const toast = useToast();
+
+  // Update local state when theme changes (e.g., from ThemeSynchronizer)
+  useEffect(() => {
+    setIsDark(theme === "dark");
+  }, [theme]);
+
+  const handleToggle = async (checked: boolean) => {
+    const newTheme = checked ? "dark" : "light";
+
+    // Update UI immediately
+    setIsDark(checked);
+    setTheme(newTheme); // Also updates local storage via ThemeProvider
+
+    // Save to backend
+    setSaving(true);
+    try {
+      await themeClient.setTheme({ theme: newTheme });
+    } catch (error) {
+      const message =
+        error instanceof Error
+          ? error.message
+          : "Failed to save theme preference";
+      toast.error(message);
+      console.error("Failed to save theme preference:", error);
+      // Revert on error
+      setIsDark(!checked);
+      setTheme(checked ? "light" : "dark");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return (
+    <div className="flex items-center justify-between w-full px-4 py-2 text-sm text-popover-foreground">
+      <div className="flex items-center gap-2">
+        {isDark ? <Moon className="h-4 w-4" /> : <Sun className="h-4 w-4" />}
+        <span>Dark Mode</span>
+      </div>
+      <Toggle
+        checked={isDark}
+        onCheckedChange={handleToggle}
+        disabled={saving}
+        aria-label="Toggle dark mode"
+      />
+    </div>
+  );
+};

package/src/index.tsx

@@ -0,0 +1,34 @@
+import {
+  createFrontendPlugin,
+  NavbarRightSlot,
+  UserMenuItemsBottomSlot,
+} from "@checkstack/frontend-api";
+import { pluginMetadata } from "@checkstack/theme-common";
+import { ThemeToggleMenuItem } from "./components/ThemeToggleMenuItem";
+import { ThemeSynchronizer } from "./components/ThemeSynchronizer";
+import { NavbarThemeToggle } from "./components/NavbarThemeToggle";
+
+export const themePlugin = createFrontendPlugin({
+  metadata: pluginMetadata,
+  routes: [],
+  extensions: [
+    // Theme toggle in user menu (for logged-in users)
+    {
+      id: "theme.user-menu.toggle",
+      slot: UserMenuItemsBottomSlot,
+      component: ThemeToggleMenuItem,
+    },
+    // Theme synchronizer - headless component that syncs theme from backend on load
+    {
+      id: "theme.navbar.synchronizer",
+      slot: NavbarRightSlot,
+      component: ThemeSynchronizer,
+    },
+    // Theme toggle button in navbar (for non-logged-in users)
+    {
+      id: "theme.navbar.toggle",
+      slot: NavbarRightSlot,
+      component: NavbarThemeToggle,
+    },
+  ],
+});

package/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "@checkstack/tsconfig/frontend.json",
+  "include": [
+    "src"
+  ]
+}