Files
autodoc/core/settings.js
T
Iisyourdad 2a602d7477 Add core domain layer: schema, store, sanitizer, placeholders, settings
- Folder-based GuideStore with atomic writes, trash/restore, duplicate,
  substep reparenting, folders/favorites, working-image crop/reset
- Allowlist HTML sanitizer applied on every store write
- Placeholder scopes (guide > global > system) and collection
- Persisted app settings with deep default merge
- 16 workflow tests exercising real on-disk round-trips

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-10 16:34:15 -05:00

95 lines
2.3 KiB
JavaScript

'use strict';
const path = require('node:path');
const { writeJsonSync, readJsonIfExists, deepClone } = require('./util');
const DEFAULT_SETTINGS = {
schemaVersion: 1,
appearance: 'system', // system | light | dark
language: 'en',
spellcheck: true,
capture: {
delayMs: 0,
mode: 'fullscreen', // fullscreen | window | region
includeCursor: true,
clickMarker: true,
clickMarkerColor: '#E5484D',
hotkeyCapture: 'CommandOrControl+Shift+1',
hotkeyPauseResume: 'CommandOrControl+Shift+2',
captureOutsideClicks: true,
confirmSimpleCapture: false,
},
editor: {
focusedViewDefaultForNewSteps: false,
autoTitleTemplate: '[[Mode]] capture [[Time]]',
},
exports: {
previewStepCount: 3,
openFolderAfterExport: true,
lastOutputDirs: {}, // format -> dir
},
library: {
sortBy: 'updatedAt',
},
backups: {
automatic: true,
keepLast: 10,
everyNSaves: 25,
},
};
class Settings {
constructor(settingsDir) {
this.file = path.join(settingsDir, 'app-settings.json');
this.globalPlaceholdersFile = path.join(settingsDir, 'placeholders.json');
this.data = this.load();
}
load() {
const stored = readJsonIfExists(this.file, {});
return mergeDeep(deepClone(DEFAULT_SETTINGS), stored);
}
save() {
writeJsonSync(this.file, this.data);
return this.data;
}
get(keyPath) {
return keyPath.split('.').reduce((o, k) => (o == null ? undefined : o[k]), this.data);
}
set(keyPath, value) {
const keys = keyPath.split('.');
let obj = this.data;
for (const k of keys.slice(0, -1)) {
if (typeof obj[k] !== 'object' || obj[k] === null) obj[k] = {};
obj = obj[k];
}
obj[keys[keys.length - 1]] = value;
return this.save();
}
getGlobalPlaceholders() {
return readJsonIfExists(this.globalPlaceholdersFile, {});
}
setGlobalPlaceholders(values) {
writeJsonSync(this.globalPlaceholdersFile, values);
return values;
}
}
function mergeDeep(base, extra) {
for (const [k, v] of Object.entries(extra || {})) {
if (v && typeof v === 'object' && !Array.isArray(v) && base[k] && typeof base[k] === 'object' && !Array.isArray(base[k])) {
mergeDeep(base[k], v);
} else {
base[k] = v;
}
}
return base;
}
module.exports = { Settings, DEFAULT_SETTINGS };