1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
"use client";
import {
createContext,
useCallback,
useContext,
useMemo,
useState,
} from "react";
import {
ReaderSettingsProvider as BaseReaderSettingsProvider,
useReaderSettingsContext,
} from "@karakeep/shared-react/hooks/reader-settings";
import {
ReaderSettings,
ReaderSettingsPartial,
} from "@karakeep/shared/types/readers";
const LOCAL_STORAGE_KEY = "karakeep-reader-settings";
function getLocalOverridesFromStorage(): ReaderSettingsPartial {
if (typeof window === "undefined") return {};
try {
const stored = localStorage.getItem(LOCAL_STORAGE_KEY);
return stored ? JSON.parse(stored) : {};
} catch {
return {};
}
}
function saveLocalOverridesToStorage(overrides: ReaderSettingsPartial): void {
if (typeof window === "undefined") return;
localStorage.setItem(LOCAL_STORAGE_KEY, JSON.stringify(overrides));
}
// Session overrides context - web-specific feature for live preview
interface SessionOverridesContextValue {
sessionOverrides: ReaderSettingsPartial;
setSessionOverrides: React.Dispatch<
React.SetStateAction<ReaderSettingsPartial>
>;
}
const SessionOverridesContext =
createContext<SessionOverridesContextValue | null>(null);
export function ReaderSettingsProvider({
children,
}: {
children: React.ReactNode;
}) {
const [sessionOverrides, setSessionOverrides] =
useState<ReaderSettingsPartial>({});
const sessionValue = useMemo(
() => ({
sessionOverrides,
setSessionOverrides,
}),
[sessionOverrides],
);
// Memoize callbacks to prevent unnecessary re-renders
const getLocalOverrides = useCallback(getLocalOverridesFromStorage, []);
const saveLocalOverrides = useCallback(saveLocalOverridesToStorage, []);
const onClearSessionOverrides = useCallback(() => {
setSessionOverrides({});
}, []);
return (
<BaseReaderSettingsProvider
getLocalOverrides={getLocalOverrides}
saveLocalOverrides={saveLocalOverrides}
sessionOverrides={sessionOverrides}
onClearSessionOverrides={onClearSessionOverrides}
>
<SessionOverridesContext.Provider value={sessionValue}>
{children}
</SessionOverridesContext.Provider>
</BaseReaderSettingsProvider>
);
}
export function useReaderSettings() {
const sessionContext = useContext(SessionOverridesContext);
if (!sessionContext) {
throw new Error(
"useReaderSettings must be used within a ReaderSettingsProvider",
);
}
const { sessionOverrides, setSessionOverrides } = sessionContext;
const baseSettings = useReaderSettingsContext();
// Update session override (live preview, not persisted)
const updateSession = useCallback(
(updates: ReaderSettingsPartial) => {
setSessionOverrides((prev) => ({ ...prev, ...updates }));
},
[setSessionOverrides],
);
// Clear all session overrides
const clearSession = useCallback(() => {
setSessionOverrides({});
}, [setSessionOverrides]);
// Save current settings to local storage (this device only)
const saveToDevice = useCallback(() => {
const newLocalOverrides = {
...baseSettings.localOverrides,
...sessionOverrides,
};
baseSettings.setLocalOverrides(newLocalOverrides);
saveLocalOverridesToStorage(newLocalOverrides);
setSessionOverrides({});
}, [baseSettings, sessionOverrides, setSessionOverrides]);
// Clear a single local override
const clearLocalOverride = useCallback(
(key: keyof ReaderSettings) => {
baseSettings.clearLocal(key);
},
[baseSettings],
);
// Check if there are unsaved session changes
const hasSessionChanges = Object.keys(sessionOverrides).length > 0;
return {
// Current effective settings (what should be displayed)
settings: baseSettings.settings,
// Raw values for UI indicators
serverSettings: baseSettings.serverDefaults,
localOverrides: baseSettings.localOverrides,
sessionOverrides,
// State indicators
hasSessionChanges,
hasLocalOverrides: baseSettings.hasLocalOverrides,
isSaving: baseSettings.isSaving,
// Actions
updateSession,
clearSession,
saveToDevice,
clearLocalOverrides: baseSettings.clearAllLocal,
clearLocalOverride,
saveToServer: baseSettings.saveAsDefault,
updateServerSetting: baseSettings.saveAsDefault,
clearServerDefaults: baseSettings.clearAllDefaults,
};
}
|
