feat(macos): configuration window + curl-backed macOS updater (#71)

src/types/settings.ts

@@ -0,0 +1,80 @@
+import type { ConfigValidationWarning } from './config';
+
+export type ConfigSettingsCategory =
+  | 'viewing'
+  | 'mining-anki'
+  | 'playback-sources'
+  | 'input'
+  | 'integrations'
+  | 'tracking-app'
+  | 'advanced';
+
+export type ConfigSettingsControl =
+  | 'boolean'
+  | 'number'
+  | 'text'
+  | 'textarea'
+  | 'select'
+  | 'color'
+  | 'string-list'
+  | 'json'
+  | 'secret';
+
+export type ConfigSettingsRestartBehavior = 'hot-reload' | 'restart';
+
+export interface ConfigSettingsField {
+  id: string;
+  label: string;
+  description: string;
+  configPath: string;
+  category: ConfigSettingsCategory;
+  section: string;
+  control: ConfigSettingsControl;
+  defaultValue: unknown;
+  enumValues?: readonly string[];
+  restartBehavior: ConfigSettingsRestartBehavior;
+  advanced?: boolean;
+  secret?: boolean;
+  legacyHidden?: boolean;
+}
+
+export type ConfigSettingsSnapshotValue = unknown;
+
+export interface ConfigSettingsSnapshot {
+  configPath: string;
+  fields: ConfigSettingsField[];
+  values: Record<string, ConfigSettingsSnapshotValue>;
+  warnings: ConfigValidationWarning[];
+}
+
+export type ConfigSettingsPatchOperation =
+  | {
+      op: 'set';
+      path: string;
+      value: unknown;
+    }
+  | {
+      op: 'reset';
+      path: string;
+    };
+
+export interface ConfigSettingsPatch {
+  operations: ConfigSettingsPatchOperation[];
+}
+
+export interface ConfigSettingsSaveResult {
+  ok: boolean;
+  snapshot?: ConfigSettingsSnapshot;
+  warnings?: ConfigValidationWarning[];
+  error?: string;
+  hotReloadFields: string[];
+  restartRequiredFields: string[];
+  restartRequiredSections?: string[];
+}
+
+export interface ConfigSettingsAPI {
+  getSnapshot(): Promise<ConfigSettingsSnapshot>;
+  savePatch(patch: ConfigSettingsPatch): Promise<ConfigSettingsSaveResult>;
+  openSettingsFile(): Promise<boolean>;
+  openSettingsWindow(): Promise<boolean>;
+}