feat(settings): add theme persistence across devices

Introduce a user-preferences module and database schema to sync theme
settings (theme, accent, radius, background, brightness) across devices.
Users can now enable theme sync to persist their customization choices.

Closes #146

packages/types/src/auth.ts

@@ -17,6 +17,7 @@ export type ProvisioningMethod = (typeof ProvisioningMethod)[keyof typeof Provis
 
 export interface UserSettings {
   syncReaderPreferences?: boolean;
+  syncThemePreferences?: boolean;
   statisticsConfig?: import("./statistics").StatisticsSettings;
   onboarding?: {
     tourCompleted?: boolean;

packages/types/src/entity-manager.ts

@@ -73,7 +73,7 @@ export interface DuplicateScanResponse {
   pageSize: number;
 }
 
-export type DuplicateScanState = 'idle' | 'computing' | 'done' | 'error';
+export type DuplicateScanState = "idle" | "computing" | "done" | "error";
 
 export interface DuplicateScanStatus {
   entityType: EntityType;

packages/types/src/index.ts

@@ -1,5 +1,6 @@
 export * from "./audit";
 export * from "./auth";
+export * from "./theme";
 export * from "./permissions";
 export * from "./content-filter";
 export * from "./metadata-preferences";

packages/types/src/pattern-resolver.ts

@@ -134,7 +134,10 @@ function normalizeResolverOptions(options?: PathResolverOptions): Required<PathR
 }
 
 function sanitizePathSegmentValue(value: string, replacementCharacter: "_" | "-"): string {
-  let sanitized = value.replace(INVALID_SEGMENT_CHARS_REGEX, replacementCharacter).trim().replace(/[. ]+$/g, "");
+  let sanitized = value
+    .replace(INVALID_SEGMENT_CHARS_REGEX, replacementCharacter)
+    .trim()
+    .replace(/[. ]+$/g, "");
   if (!sanitized || sanitized === "." || sanitized === "..") {
     sanitized = replacementCharacter;
   }

packages/types/src/theme.ts

@@ -0,0 +1,74 @@
+export const THEME_IDS = ["light", "dark"] as const;
+export type Theme = (typeof THEME_IDS)[number];
+
+export const ACCENT_IDS = [
+  "grey",
+  "rose",
+  "orange",
+  "amber",
+  "yellow",
+  "lime",
+  "green",
+  "emerald",
+  "teal",
+  "cyan",
+  "sky",
+  "blue",
+  "indigo",
+  "violet",
+  "fuchsia",
+  "pink",
+  "white",
+  "coral",
+  "peach",
+  "butter",
+  "lemon",
+  "celadon",
+  "sage",
+  "mint",
+  "seafoam",
+  "powder",
+  "mist",
+  "periwinkle",
+  "wisteria",
+  "lavender",
+  "orchid",
+  "blush",
+] as const;
+export type Accent = (typeof ACCENT_IDS)[number];
+
+export const RADIUS_IDS = ["sharp", "default", "rounded", "pill"] as const;
+export type Radius = (typeof RADIUS_IDS)[number];
+
+export const BACKGROUND_IDS = [
+  "none",
+  "dots",
+  "cross",
+  "terminal",
+  "millimeter",
+  "blueprint",
+  "brushed",
+  "scanlines",
+  "carbon",
+  "vinyl",
+  "perforated",
+  "aurora",
+  "horizon",
+  "glow",
+  "mesh",
+  "elevation",
+  "prism",
+  "spectrum",
+  "spectrum-x",
+  "spectrum-plus",
+  "eclipse",
+] as const;
+export type Background = (typeof BACKGROUND_IDS)[number];
+
+export interface ThemePreferences {
+  theme: Theme;
+  accent: Accent;
+  radius: Radius;
+  background: Background;
+  brightness: number;
+}