Vencord/src/api/settings.ts

119 lines
4.5 KiB
TypeScript
Raw Normal View History

2022-08-31 02:07:16 +00:00
import plugins from "plugins";
import IpcEvents from "../utils/IpcEvents";
2022-08-31 18:47:07 +00:00
import { React } from "../webpack/common";
import { mergeDefaults } from "../utils/misc";
2022-08-31 02:07:16 +00:00
2022-10-11 19:48:28 +00:00
export interface Settings {
2022-09-30 22:42:50 +00:00
notifyAboutUpdates: boolean;
useQuickCss: boolean;
2022-10-11 19:48:28 +00:00
enableReactDevtools: boolean;
2022-08-31 02:07:16 +00:00
plugins: {
[plugin: string]: {
enabled: boolean;
[setting: string]: any;
};
};
}
const DefaultSettings: Settings = {
2022-09-30 22:42:50 +00:00
notifyAboutUpdates: true,
useQuickCss: true,
2022-10-11 19:48:28 +00:00
enableReactDevtools: false,
2022-08-31 02:07:16 +00:00
plugins: {}
2022-09-30 22:42:50 +00:00
};
2022-08-31 02:07:16 +00:00
for (const plugin in plugins) {
DefaultSettings.plugins[plugin] = {
enabled: plugins[plugin].required ?? false
2022-08-31 02:07:16 +00:00
};
}
try {
var settings = JSON.parse(VencordNative.ipc.sendSync(IpcEvents.GET_SETTINGS)) as Settings;
for (const key in DefaultSettings) {
settings[key] ??= DefaultSettings[key];
}
mergeDefaults(settings, DefaultSettings);
} catch (err) {
console.error("Corrupt settings file. ", err);
var settings = mergeDefaults({} as Settings, DefaultSettings);
}
2022-09-03 16:01:06 +00:00
type SubscriptionCallback = ((newValue: any, path: string) => void) & { _path?: string; };
const subscriptions = new Set<SubscriptionCallback>();
2022-08-31 02:07:16 +00:00
function makeProxy(settings: Settings, root = settings, path = ""): Settings {
2022-08-31 02:07:16 +00:00
return new Proxy(settings, {
get(target, p: string) {
2022-08-31 02:07:16 +00:00
const v = target[p];
if (typeof v === "object" && !Array.isArray(v) && v !== null)
return makeProxy(v, root, `${path}${path && "."}${p}`);
2022-08-31 02:07:16 +00:00
return v;
},
set(target, p: string, v) {
2022-08-31 02:07:16 +00:00
if (target[p] === v) return true;
target[p] = v;
const setPath = `${path}${path && "."}${p}`;
2022-08-31 02:07:16 +00:00
for (const subscription of subscriptions) {
if (!subscription._path || subscription._path === setPath) {
2022-09-03 16:01:06 +00:00
subscription(v, setPath);
}
2022-08-31 02:07:16 +00:00
}
VencordNative.ipc.invoke(IpcEvents.SET_SETTINGS, JSON.stringify(root, null, 4));
2022-08-31 02:07:16 +00:00
return true;
}
});
}
/**
* Same as {@link Settings} but unproxied. You should treat this as readonly,
* as modifying properties on this will not save to disk or call settings
* listeners.
*/
export const PlainSettings = settings;
2022-08-31 02:07:16 +00:00
/**
* A smart settings object. Altering props automagically saves
* the updated settings to disk.
* This recursively proxies objects. If you need the object non proxied, use {@link PlainSettings}
2022-08-31 02:07:16 +00:00
*/
export const Settings = makeProxy(settings);
/**
* Settings hook for React components. Returns a smart settings
* object that automagically triggers a rerender if any properties
* are altered
* @returns Settings
*/
export function useSettings() {
2022-09-30 22:42:50 +00:00
const [, forceUpdate] = React.useReducer(() => ({}), {});
2022-08-31 02:07:16 +00:00
React.useEffect(() => {
subscriptions.add(forceUpdate);
return () => void subscriptions.delete(forceUpdate);
}, []);
return Settings;
}
// Resolves a possibly nested prop in the form of "some.nested.prop" to type of T.some.nested.prop
type ResolvePropDeep<T, P> = P extends "" ? T :
P extends `${infer Pre}.${infer Suf}` ?
Pre extends keyof T ? ResolvePropDeep<T[Pre], Suf> : never : P extends keyof T ? T[P] : never;
2022-09-03 16:01:06 +00:00
/**
* Add a settings listener that will be invoked whenever the desired setting is updated
* @param path Path to the setting that you want to watch, for example "plugins.Unindent.enabled" will fire your callback
* whenever Unindent is toggled. Pass an empty string to get notified for all changes
* @param onUpdate Callback function whenever a setting matching path is updated. It gets passed the new value and the path
* to the updated setting. This path will be the same as your path argument, unless it was an empty string.
2022-09-16 20:59:34 +00:00
*
2022-09-03 16:01:06 +00:00
* @example addSettingsListener("", (newValue, path) => console.log(`${path} is now ${newValue}`))
* addSettingsListener("plugins.Unindent.enabled", v => console.log("Unindent is now", v ? "enabled" : "disabled"))
*/
export function addSettingsListener<Path extends keyof Settings>(path: Path, onUpdate: (newValue: Settings[Path], path: Path) => void): void;
export function addSettingsListener<Path extends string>(path: Path, onUpdate: (newValue: Path extends "" ? any : ResolvePropDeep<Settings, Path>, path: Path extends "" ? string : Path) => void): void;
export function addSettingsListener(path: string, onUpdate: (newValue: any, path: string) => void) {
(onUpdate as SubscriptionCallback)._path = path;
subscriptions.add(onUpdate);
2022-09-03 16:01:06 +00:00
}