ui: Day 3 — global toast system + first error-toast wiring on DictationPage
THE PROBLEM (Codex review + architecture-review.md §1, §14):
Multiple critical paths discard errors silently — `let _ = insert_transcript(...)`,
`.catch(() => {})`, inline `error = ...` state that not every page surfaces. ND
users in particular need explicit feedback when something fails; silent
failure is worse than no feature.
SHIPPED:
src/lib/stores/toasts.svelte.js (new):
- Minimal in-house toast store (~80 lines, no svelte-french-toast dep)
- Severity → palette: info/success → moss, warn → signal, error → ember
- Auto-dismiss durations per severity (success 3s, info 4s, warn 6s,
error sticky)
- `invokeWithToast(invoke, command, args, errorTitle?)` helper wraps a
Tauri invoke and toasts on failure while still throwing for callers
that need to handle the error themselves
src/lib/components/ToastViewport.svelte (new):
- Reads from the toasts store
- Bottom-right stack, max-width clamp on small screens
- aria-live=polite + role=alert on error toasts (screen-reader friendly)
- Slide-in animation honours `html.reduce-motion` for the existing
preferences toggle
- Severity left-border in brand colours via existing CSS variables
src/routes/+layout.svelte:
- Mounts <ToastViewport /> once at the app root so toasts work from any
page or window
src/lib/pages/DictationPage.svelte:
- First error-toast wiring: failures starting recording now show a
sticky toast in addition to the inline `error` panel
- Replaces a previously easy-to-miss failure-mode
NEXT (Day 4 batch):
- Wire toasts into FilesPage, HistoryPage, SettingsPage, ModelDownloader
(all currently swallow errors)
- Add `add_transcript`, `list_transcripts`, `update_transcript` (closes the
long-standing TODO Codex flagged), `delete_transcript` Tauri commands
wrapping the existing storage layer
- Switch addToHistory to dual-write (localStorage + SQLite) so the
canonical store catches up with the actual transcript flow
- FTS5 transcripts_fts virtual table + search command
- Wrap multi-row writes (decompose_and_store) in DB transactions
This commit is contained in:
129
src/lib/components/ToastViewport.svelte
Normal file
129
src/lib/components/ToastViewport.svelte
Normal file
@@ -0,0 +1,129 @@
|
|||||||
|
<script>
|
||||||
|
// Renders the toast stack in the bottom-right of the viewport. Mount once
|
||||||
|
// at the app root (in +layout.svelte). Reads from the global toasts store.
|
||||||
|
//
|
||||||
|
// Severity colour mapping uses the brand palette via CSS variables already
|
||||||
|
// defined in app.css — no inline literals.
|
||||||
|
//
|
||||||
|
// Honours prefers-reduced-motion via the existing :root[data-reduce-motion]
|
||||||
|
// attribute that preferences.svelte.js sets.
|
||||||
|
import { toasts } from '$lib/stores/toasts.svelte.js';
|
||||||
|
import { X } from 'lucide-svelte';
|
||||||
|
|
||||||
|
function severityClass(severity) {
|
||||||
|
switch (severity) {
|
||||||
|
case 'success': return 'toast-success';
|
||||||
|
case 'info': return 'toast-info';
|
||||||
|
case 'warn': return 'toast-warn';
|
||||||
|
case 'error': return 'toast-error';
|
||||||
|
default: return 'toast-info';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<div class="toast-viewport" aria-live="polite" aria-atomic="false">
|
||||||
|
{#each toasts.items as toast (toast.id)}
|
||||||
|
<div
|
||||||
|
class="toast {severityClass(toast.severity)}"
|
||||||
|
role={toast.severity === 'error' ? 'alert' : 'status'}
|
||||||
|
>
|
||||||
|
<div class="toast-body">
|
||||||
|
<div class="toast-title">{toast.title}</div>
|
||||||
|
{#if toast.body}
|
||||||
|
<div class="toast-msg">{toast.body}</div>
|
||||||
|
{/if}
|
||||||
|
</div>
|
||||||
|
<button
|
||||||
|
class="toast-close"
|
||||||
|
aria-label="Dismiss"
|
||||||
|
onclick={() => toasts.dismiss(toast.id)}
|
||||||
|
type="button"
|
||||||
|
>
|
||||||
|
<X size={14} aria-hidden="true" />
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
{/each}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<style>
|
||||||
|
.toast-viewport {
|
||||||
|
position: fixed;
|
||||||
|
bottom: 1rem;
|
||||||
|
right: 1rem;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 0.5rem;
|
||||||
|
z-index: 9999;
|
||||||
|
max-width: min(28rem, calc(100vw - 2rem));
|
||||||
|
pointer-events: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toast {
|
||||||
|
pointer-events: auto;
|
||||||
|
display: flex;
|
||||||
|
align-items: flex-start;
|
||||||
|
gap: 0.75rem;
|
||||||
|
padding: 0.875rem 1rem;
|
||||||
|
border-radius: 0.5rem;
|
||||||
|
background: var(--surface, #1a1a1a);
|
||||||
|
color: var(--text, #fff);
|
||||||
|
border-left: 3px solid var(--moss, #4a7a4a);
|
||||||
|
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.25);
|
||||||
|
/* Slide in from right; honours reduce-motion via the existing class
|
||||||
|
that preferences.svelte.js applies to <html>. */
|
||||||
|
animation: toast-slide-in 200ms cubic-bezier(0.2, 0.8, 0.2, 1);
|
||||||
|
}
|
||||||
|
:global(html.reduce-motion) .toast { animation: none; }
|
||||||
|
|
||||||
|
@keyframes toast-slide-in {
|
||||||
|
from { transform: translateX(100%); opacity: 0; }
|
||||||
|
to { transform: translateX(0); opacity: 1; }
|
||||||
|
}
|
||||||
|
|
||||||
|
.toast-info { border-left-color: var(--moss, #4a7a4a); }
|
||||||
|
.toast-success { border-left-color: var(--moss, #4a7a4a); }
|
||||||
|
.toast-warn { border-left-color: var(--signal, #d4a017); }
|
||||||
|
.toast-error { border-left-color: var(--ember, #c87144); }
|
||||||
|
|
||||||
|
.toast-body {
|
||||||
|
flex: 1;
|
||||||
|
min-width: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toast-title {
|
||||||
|
font-weight: 600;
|
||||||
|
font-size: 0.9375rem;
|
||||||
|
line-height: 1.4;
|
||||||
|
word-wrap: break-word;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toast-msg {
|
||||||
|
margin-top: 0.25rem;
|
||||||
|
font-size: 0.875rem;
|
||||||
|
line-height: 1.5;
|
||||||
|
color: var(--text-muted, rgba(255, 255, 255, 0.7));
|
||||||
|
word-wrap: break-word;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toast-close {
|
||||||
|
flex-shrink: 0;
|
||||||
|
background: transparent;
|
||||||
|
border: none;
|
||||||
|
color: var(--text-muted, rgba(255, 255, 255, 0.6));
|
||||||
|
cursor: pointer;
|
||||||
|
padding: 0.25rem;
|
||||||
|
border-radius: 0.25rem;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
transition: background 100ms, color 100ms;
|
||||||
|
}
|
||||||
|
.toast-close:hover {
|
||||||
|
background: rgba(255, 255, 255, 0.08);
|
||||||
|
color: var(--text, #fff);
|
||||||
|
}
|
||||||
|
.toast-close:focus-visible {
|
||||||
|
outline: 2px solid var(--ember, #c87144);
|
||||||
|
outline-offset: 2px;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
@@ -2,6 +2,7 @@
|
|||||||
import { onMount, onDestroy } from "svelte";
|
import { onMount, onDestroy } from "svelte";
|
||||||
import { Channel, invoke } from "@tauri-apps/api/core";
|
import { Channel, invoke } from "@tauri-apps/api/core";
|
||||||
import { page, settings, templates, profiles, addToHistory, addTask, tasks } from "$lib/stores/page.svelte.js";
|
import { page, settings, templates, profiles, addToHistory, addTask, tasks } from "$lib/stores/page.svelte.js";
|
||||||
|
import { toasts } from "$lib/stores/toasts.svelte.js";
|
||||||
import Card from "$lib/components/Card.svelte";
|
import Card from "$lib/components/Card.svelte";
|
||||||
import ModelDownloader from "$lib/components/ModelDownloader.svelte";
|
import ModelDownloader from "$lib/components/ModelDownloader.svelte";
|
||||||
import { exportTranscript } from "$lib/utils/export.js";
|
import { exportTranscript } from "$lib/utils/export.js";
|
||||||
@@ -342,6 +343,10 @@
|
|||||||
timerInterval = setInterval(updateTimer, 1000);
|
timerInterval = setInterval(updateTimer, 1000);
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
error = typeof err === "string" ? err : err?.message || "Microphone error";
|
error = typeof err === "string" ? err : err?.message || "Microphone error";
|
||||||
|
// Surface the failure as a sticky error toast so it does not get
|
||||||
|
// swallowed if the inline `error` panel is not visible.
|
||||||
|
// (Day 3 of the upgrade plan)
|
||||||
|
toasts.error("Could not start recording", error);
|
||||||
page.status = "Error";
|
page.status = "Error";
|
||||||
page.statusColor = "#e87171";
|
page.statusColor = "#e87171";
|
||||||
cleanup();
|
cleanup();
|
||||||
|
|||||||
83
src/lib/stores/toasts.svelte.js
Normal file
83
src/lib/stores/toasts.svelte.js
Normal file
@@ -0,0 +1,83 @@
|
|||||||
|
// Minimal toast store. Roll-our-own (no svelte-french-toast etc) so Kon
|
||||||
|
// stays lean. Toasts auto-dismiss after `duration` ms unless duration is 0
|
||||||
|
// (sticky) or unless the user clicks the close button.
|
||||||
|
//
|
||||||
|
// Severity → colour:
|
||||||
|
// info → moss (informational, default 4s)
|
||||||
|
// success → moss (operation succeeded, default 3s)
|
||||||
|
// warn → signal (degraded but not failed, default 6s)
|
||||||
|
// error → ember (operation failed, sticky until dismissed)
|
||||||
|
//
|
||||||
|
// Usage from a component:
|
||||||
|
// import { toasts } from '$lib/stores/toasts.svelte.js';
|
||||||
|
// toasts.error('Could not start recording', 'Selected microphone disappeared.');
|
||||||
|
// toasts.success('Saved');
|
||||||
|
|
||||||
|
let nextId = 1;
|
||||||
|
|
||||||
|
function defaultDuration(severity) {
|
||||||
|
switch (severity) {
|
||||||
|
case 'success': return 3000;
|
||||||
|
case 'info': return 4000;
|
||||||
|
case 'warn': return 6000;
|
||||||
|
case 'error': return 0; // sticky
|
||||||
|
default: return 4000;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function createToastsStore() {
|
||||||
|
// $state requires a class field or top-level let in Svelte 5; we expose
|
||||||
|
// `items` via a getter on the singleton.
|
||||||
|
let items = $state([]);
|
||||||
|
|
||||||
|
function show(severity, title, body) {
|
||||||
|
const id = nextId++;
|
||||||
|
const duration = defaultDuration(severity);
|
||||||
|
const toast = { id, severity, title, body: body ?? '', duration };
|
||||||
|
items.push(toast);
|
||||||
|
if (duration > 0) {
|
||||||
|
setTimeout(() => dismiss(id), duration);
|
||||||
|
}
|
||||||
|
return id;
|
||||||
|
}
|
||||||
|
|
||||||
|
function dismiss(id) {
|
||||||
|
const ix = items.findIndex(t => t.id === id);
|
||||||
|
if (ix >= 0) items.splice(ix, 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
function dismissAll() {
|
||||||
|
items.length = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
get items() { return items; },
|
||||||
|
info: (title, body) => show('info', title, body),
|
||||||
|
success: (title, body) => show('success', title, body),
|
||||||
|
warn: (title, body) => show('warn', title, body),
|
||||||
|
error: (title, body) => show('error', title, body),
|
||||||
|
dismiss,
|
||||||
|
dismissAll,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export const toasts = createToastsStore();
|
||||||
|
|
||||||
|
// Helper: wrap a Tauri invoke and toast on failure. Returns the result on
|
||||||
|
// success, throws on failure (so callers that need to handle the error
|
||||||
|
// can still try/catch).
|
||||||
|
//
|
||||||
|
// import { invoke } from '@tauri-apps/api/core';
|
||||||
|
// import { invokeWithToast } from '$lib/stores/toasts.svelte.js';
|
||||||
|
// const result = await invokeWithToast('start_native_capture', { deviceName });
|
||||||
|
//
|
||||||
|
// Optional `errorTitle` overrides the default ("Action failed").
|
||||||
|
export async function invokeWithToast(invokeFn, command, args, errorTitle) {
|
||||||
|
try {
|
||||||
|
return await invokeFn(command, args);
|
||||||
|
} catch (err) {
|
||||||
|
const msg = typeof err === 'string' ? err : (err?.message ?? String(err));
|
||||||
|
toasts.error(errorTitle ?? 'Action failed', msg);
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -5,14 +5,17 @@
|
|||||||
import Sidebar from "$lib/Sidebar.svelte";
|
import Sidebar from "$lib/Sidebar.svelte";
|
||||||
import TaskSidebar from "$lib/components/TaskSidebar.svelte";
|
import TaskSidebar from "$lib/components/TaskSidebar.svelte";
|
||||||
import Titlebar from "$lib/components/Titlebar.svelte";
|
import Titlebar from "$lib/components/Titlebar.svelte";
|
||||||
|
import ToastViewport from "$lib/components/ToastViewport.svelte";
|
||||||
import { page, settings, saveSettings } from "$lib/stores/page.svelte.js";
|
import { page, settings, saveSettings } from "$lib/stores/page.svelte.js";
|
||||||
import { getPreferences, updatePreferences } from "$lib/stores/preferences.svelte.js";
|
import { getPreferences, updatePreferences } from "$lib/stores/preferences.svelte.js";
|
||||||
|
import { hasTauriRuntime } from "$lib/utils/runtime.js";
|
||||||
|
|
||||||
import { page as sveltePage } from "$app/stores";
|
import { page as sveltePage } from "$app/stores";
|
||||||
|
|
||||||
let { children } = $props();
|
let { children } = $props();
|
||||||
|
|
||||||
const prefs = getPreferences();
|
const prefs = getPreferences();
|
||||||
|
const tauriRuntimeAvailable = hasTauriRuntime();
|
||||||
|
|
||||||
|
|
||||||
// Detect secondary windows (float, viewer) — they use +layout@.svelte
|
// Detect secondary windows (float, viewer) — they use +layout@.svelte
|
||||||
@@ -49,6 +52,10 @@
|
|||||||
let hotkeyBackend = $state("unknown"); // "evdev" | "tauri" | "unavailable"
|
let hotkeyBackend = $state("unknown"); // "evdev" | "tauri" | "unavailable"
|
||||||
|
|
||||||
async function initHotkeyBackend() {
|
async function initHotkeyBackend() {
|
||||||
|
if (!tauriRuntimeAvailable) {
|
||||||
|
hotkeyBackend = "unavailable";
|
||||||
|
return;
|
||||||
|
}
|
||||||
try {
|
try {
|
||||||
const isWayland = await invoke("is_wayland_session");
|
const isWayland = await invoke("is_wayland_session");
|
||||||
if (isWayland) {
|
if (isWayland) {
|
||||||
@@ -73,6 +80,7 @@
|
|||||||
}
|
}
|
||||||
|
|
||||||
async function registerGlobalHotkey(hotkey) {
|
async function registerGlobalHotkey(hotkey) {
|
||||||
|
if (!tauriRuntimeAvailable) return;
|
||||||
if (hotkeyBackend === "unknown") return; // not yet initialised
|
if (hotkeyBackend === "unknown") return; // not yet initialised
|
||||||
|
|
||||||
try {
|
try {
|
||||||
@@ -106,6 +114,7 @@
|
|||||||
// Listen for evdev hotkey events from the Rust backend
|
// Listen for evdev hotkey events from the Rust backend
|
||||||
let unlistenEvdev = null;
|
let unlistenEvdev = null;
|
||||||
async function setupEvdevListener() {
|
async function setupEvdevListener() {
|
||||||
|
if (!tauriRuntimeAvailable) return;
|
||||||
const { listen } = await import("@tauri-apps/api/event");
|
const { listen } = await import("@tauri-apps/api/event");
|
||||||
unlistenEvdev = await listen("kon:hotkey-pressed", () => {
|
unlistenEvdev = await listen("kon:hotkey-pressed", () => {
|
||||||
if (page.current !== "dictation") page.current = "dictation";
|
if (page.current !== "dictation") page.current = "dictation";
|
||||||
@@ -161,6 +170,11 @@
|
|||||||
handleResize();
|
handleResize();
|
||||||
window.addEventListener("resize", handleResize);
|
window.addEventListener("resize", handleResize);
|
||||||
|
|
||||||
|
if (!tauriRuntimeAvailable) {
|
||||||
|
hotkeyBackend = "unavailable";
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
// Detect and initialise the correct hotkey backend
|
// Detect and initialise the correct hotkey backend
|
||||||
await initHotkeyBackend();
|
await initHotkeyBackend();
|
||||||
|
|
||||||
@@ -177,6 +191,9 @@
|
|||||||
|
|
||||||
onDestroy(() => {
|
onDestroy(() => {
|
||||||
window.removeEventListener("resize", handleResize);
|
window.removeEventListener("resize", handleResize);
|
||||||
|
if (!tauriRuntimeAvailable) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
if (hotkeyBackend === "evdev") {
|
if (hotkeyBackend === "evdev") {
|
||||||
invoke("stop_evdev_hotkey").catch(() => {});
|
invoke("stop_evdev_hotkey").catch(() => {});
|
||||||
} else if (hotkeyBackend === "tauri" && registeredHotkey) {
|
} else if (hotkeyBackend === "tauri" && registeredHotkey) {
|
||||||
@@ -220,3 +237,8 @@
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
{/if}
|
{/if}
|
||||||
|
|
||||||
|
<!-- Global toast viewport. Mounted once at the app root so any component
|
||||||
|
can call toasts.error(...), toasts.success(...) etc and have it render
|
||||||
|
in the bottom-right of the viewport. (Day 3 of the upgrade plan) -->
|
||||||
|
<ToastViewport />
|
||||||
|
|||||||
Reference in New Issue
Block a user