Files
Lumotia/src/lib/stores/preferences.svelte.ts
Jake 3770815fbf
Some checks failed
check / cargo check (macos-latest) (push) Has been cancelled
check / cargo check (ubuntu-22.04) (push) Has been cancelled
check / cargo check (windows-latest) (push) Has been cancelled
check / svelte build + lint (push) Has been cancelled
agent: lumotia — v0.1 release-completion run
Closes the code-side v0.1 ship gate. All quality gates green:
cargo fmt/clippy/test (~327 tests), npm check (0/0), vitest 13/13,
scripts/dogfood-rebrand-drill.sh 8/8.

Phase F — first-run onboarding promoted to v0.1
- FirstRunPage with skip-to-main + failure recovery + event recording
- Six onboarding commands (record/list/has-completed + lumotia_events)
- Storage migration v17 (onboarding_events + lumotia_events tables)

UI hardening (in-scope items from v0.1-ui-hardening.md)
- StatusPill + PostCaptureCard components, 21st preview entry
- Sidebar recording-as-sacred-state (opacity + aria-disabled, reduced-motion)
- Settings 6-section regroup + Help section + Activation log + Privacy toggle
- Error-state copy sweep (DictationPage + SettingsPage, plain-language)
- Global :focus-visible rule, textarea outlines restored
- Ctrl+K / Ctrl+, / Escape bindings in +layout

LLM resilience
- rule_based_extract_tasks (regex-free imperative-verb extractor) +
  extract_tasks_with_fallback wrapper — task extraction never returns zero
- tokio::time::timeout(120s) wraps cleanup/tags/tasks commands

Release artefacts
- LICENSE (canonical AGPL-3.0), CHANGELOG (Keep-a-Changelog format)
- v0.1-release-notes, privacy-and-ai-use, install-warnings,
  tester-onboarding-kit, tester-acceptance-runbook, code-signing-setup,
  apple-silicon-rb08-runbook, virtual-audio-setup, v0.1-contrast-audit
- Workspace versioning + AGPL spdx; npm exact-pin (10 ranges removed)
- AppImage SHA-256 sidecar in build.yml
- README v0.1 section + Reporting-issues; canonical repo slug

Closure pass — items moved from human-required to code-complete
- KI-02 Linux idle inhibit: zbus 5 → org.freedesktop.login1.Manager.Inhibit
- KI-03 Windows sleep prevention: SetThreadExecutionState(ES_CONTINUOUS|...)
- acquire/release_idle_inhibit Tauri commands, wired in DictationPage
- Diagnostic-bundle frontend wire-up (Settings → Help button)
- WCAG-AA contrast fix via .btn-filled-text utility (no token changes)
- 8 destructive-action sites wrapped in plain-language confirm() guards
- KNOWN-ISSUES.md + v0.1-known-limitations.md updated (KI-02/03 fixed)

Scripts
- pre-tag-verify.sh, tag-day.sh, smoke-linux + driver
- parse-diagnostic-bundle.sh, parse-activation-log.py

Per-item audit trail: docs/release/v0.1-completion-status.md
Remaining: W-01…W-08 (signing certs, hardware probes, smoke matrix,
tester recruitment) — see docs/release/v0.1-known-limitations.md.
2026-05-15 06:59:08 +01:00

178 lines
6.4 KiB
TypeScript

// src/lib/stores/preferences.svelte.js
import { invoke } from "@tauri-apps/api/core";
import { emit } from "@tauri-apps/api/event";
import { getCurrentWindow } from "@tauri-apps/api/window";
import type { AccessibilityPreferences, Preferences } from "$lib/types/app";
import { errorMessage } from "$lib/utils/errors.js";
import { toasts } from "./toasts.svelte.ts";
export const PREFERENCES_CHANGED_EVENT = "lumotia:preferences-changed";
type FontFamilies = Record<AccessibilityPreferences["fontFamily"], string>;
function currentWindowLabel() {
try {
return getCurrentWindow().label;
} catch {
return null;
}
}
function broadcastPreferences(prefs: Preferences) {
const source = currentWindowLabel();
if (source === null) return;
// Fire-and-forget — cross-window sync must never block the local apply path.
emit(PREFERENCES_CHANGED_EVENT, { source, prefs: JSON.parse(JSON.stringify(prefs)) })
.catch(() => {});
}
const DEFAULTS: Preferences = {
theme: "dark",
zone: "default",
recordActivationEvents: true,
accessibility: {
fontFamily: "lexend",
fontSize: 16,
letterSpacing: 0,
lineHeight: 1.5,
transcriptSize: 16,
bionicReading: false,
reduceMotion: "system",
},
};
const FONT_FAMILIES: FontFamilies = {
lexend: "'Lexend', system-ui, sans-serif",
atkinson: "'Atkinson Hyperlegible Next', system-ui, sans-serif",
opendyslexic: "'OpenDyslexic', system-ui, sans-serif",
};
function readFromDOM(): Preferences {
const el = document.documentElement;
return {
theme: (el.dataset.theme || DEFAULTS.theme) as Preferences["theme"],
zone: el.dataset.zone || DEFAULTS.zone,
recordActivationEvents: el.dataset.recordActivationEvents !== "false",
accessibility: {
fontFamily: (el.dataset.fontFamily || DEFAULTS.accessibility.fontFamily) as AccessibilityPreferences["fontFamily"],
fontSize: parseFloat(el.style.getPropertyValue('--font-size-body')) || DEFAULTS.accessibility.fontSize,
letterSpacing: parseFloat(el.style.getPropertyValue('--letter-spacing-body')) || DEFAULTS.accessibility.letterSpacing,
lineHeight: parseFloat(el.style.getPropertyValue('--line-height-body')) || DEFAULTS.accessibility.lineHeight,
transcriptSize: DEFAULTS.accessibility.transcriptSize,
bionicReading: el.dataset.bionicReading === "true",
reduceMotion: (el.dataset.reduceMotion || DEFAULTS.accessibility.reduceMotion) as AccessibilityPreferences["reduceMotion"],
},
};
}
function applyToDOM(prefs: Preferences) {
const el = document.documentElement;
// Theme — resolve 'system' to actual value
el.dataset.theme = prefs.theme === "system"
? (window.matchMedia("(prefers-color-scheme: light)").matches ? "light" : "dark")
: prefs.theme;
// Zone
if (prefs.zone === "default") {
delete el.dataset.zone;
} else {
el.dataset.zone = prefs.zone;
}
// recordActivationEvents — persisted via save_preferences, mirrored to DOM for readFromDOM
el.dataset.recordActivationEvents = String(prefs.recordActivationEvents);
// Accessibility — inline styles for highest specificity
const a = prefs.accessibility;
el.style.setProperty('--font-family-body', FONT_FAMILIES[a.fontFamily] || FONT_FAMILIES.lexend);
el.style.setProperty('--font-size-body', `${a.fontSize}px`);
el.style.setProperty('--letter-spacing-body', `${a.letterSpacing}em`);
el.style.setProperty('--line-height-body', String(a.lineHeight));
el.dataset.bionicReading = String(a.bionicReading);
el.dataset.fontFamily = a.fontFamily;
// Reduce motion — three-value resolution
const motionReduced = a.reduceMotion === "on"
|| (a.reduceMotion === "system" && window.matchMedia("(prefers-reduced-motion: reduce)").matches);
if (motionReduced) {
el.dataset.reduceMotion = "true";
} else {
delete el.dataset.reduceMotion;
}
}
let saveTimeout: ReturnType<typeof setTimeout> | undefined;
// Show the failure toast at most once per process so a stuck SQLite path
// doesn't spam the user every time they nudge a slider.
let saveFailureToastShown = false;
function persistToSQLite(prefs: Preferences) {
clearTimeout(saveTimeout);
saveTimeout = setTimeout(async () => {
try {
await invoke("save_preferences", { preferences: JSON.stringify(prefs) });
saveFailureToastShown = false;
} catch (e) {
console.error("Failed to save preferences:", e);
if (!saveFailureToastShown) {
toasts.warn(
"Could not save preferences",
`${errorMessage(e)}. Your changes still apply for this session.`,
);
saveFailureToastShown = true;
}
}
}, 500);
}
// Export as const so it is never reassigned — consumers hold a stable reference
// and mutations are tracked by Svelte 5's deep reactivity.
export const preferences = $state(readFromDOM());
// Ensure data-theme and zone attributes are always present on the DOM, even
// when there is no Tauri webview injection script (e.g. browser dev mode).
if (typeof window !== 'undefined') {
applyToDOM(preferences);
}
/** @deprecated Use `preferences` directly — kept for backwards compatibility */
export function getPreferences() {
return preferences;
}
export function updatePreferences(updates: Partial<Preferences>) {
Object.assign(preferences, updates);
applyToDOM(preferences);
persistToSQLite(preferences);
broadcastPreferences(preferences);
}
export function updateAccessibility(updates: Partial<AccessibilityPreferences>) {
Object.assign(preferences.accessibility, updates);
applyToDOM(preferences);
persistToSQLite(preferences);
broadcastPreferences(preferences);
}
// Apply preferences received from another Tauri window. Mutates local state
// and DOM only — never persists or re-broadcasts, so there is no echo loop.
export function applyExternalPreferences(prefs: Partial<Preferences> | null | undefined) {
if (!prefs || typeof prefs !== "object") return;
Object.assign(preferences, prefs);
if (prefs.accessibility) {
Object.assign(preferences.accessibility, prefs.accessibility);
}
applyToDOM(preferences);
}
// Re-resolve when OS preferences change
if (typeof window !== "undefined") {
window.matchMedia("(prefers-color-scheme: light)").addEventListener("change", () => {
if (preferences.theme === "system") applyToDOM(preferences);
});
window.matchMedia("(prefers-reduced-motion: reduce)").addEventListener("change", () => {
if (preferences.accessibility.reduceMotion === "system") applyToDOM(preferences);
});
}