| name | rust-tauri-svelte |
| description | Padrões e templates ATUAIS para este app desktop — Tauri 2 + Svelte 5 (runes) + TypeScript, backend Rust. Use ao criar/editar comandos Tauri, eventos, estado (AppState), stores Svelte, ou qualquer ponte Rust↔frontend. Substitui a skill bundlada anthropic-skills:rust-tauri-svelte, que é de Tauri 1 / Svelte 4 (desatualizada). |
Rust + Tauri 2 + Svelte 5 (this repo)
Versões reais: Tauri 2, Svelte 5 (runes), TypeScript strict, Rust 2021.
Regras do projeto e armadilhas específicas: ver AGENTS.md.
Quando usar
- Criar/editar comandos Tauri, eventos, ou
AppState.
- Stores Svelte / estado compartilhado no frontend.
- Qualquer integração Rust ↔ frontend (invoke, eventos, diálogos).
Princípios
- Rust:
Result<T, E> + ?; sem unsafe sem justificativa em comentário;
conversões checadas (u32::try_from) em entrada externa (nunca as que
trunca/faz wrap silencioso).
- Tauri: comando
async para I/O ou CPU pesado (use spawn_blocking);
State<'_, AppState> para estado; eventos para empurrar Rust → frontend.
- Svelte 5: runes (
$state / $derived / $props / $effect), stores
em *.svelte.ts, tipos TypeScript reais (não JSDoc), onclick (não
on:click), $props() (não export let).
⚠️ APIs corretas (a skill bundlada está ERRADA nestes pontos — Tauri 1)
| ❌ Antigo (Tauri 1 / Svelte 4) | ✅ Atual (este repo) |
|---|
@tauri-apps/api/tauri (invoke) | @tauri-apps/api/core |
@tauri-apps/api/dialog | plugin @tauri-apps/plugin-dialog |
app.emit_all(...) | app.emit(...) (trait tauri::Emitter) |
app.get_window(...) | app.get_webview_window(...) |
tauri.conf.json → allowlist | capabilities (src-tauri/capabilities/*.json) |
generate_handler! em main.rs | em lib.rs run() (mobile-ready) |
stores .js + JSDoc | *.svelte.ts + runes + TS |
Arquitetura deste repo (feature-based)
- Backend:
src-tauri/src/features/<domínio>/{parsers,commands}; estado
global em state.rs (AppState com parking_lot::RwLock + DashMap /
LRUCache, não tokio::RwLock). Comandos registrados em lib.rs.
- Frontend:
src/lib/pages, src/lib/components, src/stores/*.svelte.ts,
src/services; chamadas via wrapper src/utils/invoke.ts com nomes de
comando de src/commands.ts (CommandName).
Templates (carregar sob demanda)
- Tauri 2 — commands, state, events, errors, atomic writes
- Svelte 5 — runes, stores, invoke wrapper, eventos, diálogos
- Config — Cargo.toml, capabilities, tauri.conf.json
Checklist de validação
[RUST / TAURI 2]
□ Result<T, E> + ? (sem unwrap em comando)?
□ try_from (não `as`) para inteiros vindos de I/O/JSON/Lua?
□ async + spawn_blocking para trabalho pesado?
□ Estado via State<'_, AppState> (parking_lot/DashMap)?
□ Comando registrado em lib.rs generate_handler!?
□ Eventos com trait Emitter (app.emit), payload Serialize?
□ Escrita "sobre arquivo do usuário" usa core::fs_util::write_atomic?
[SVELTE 5 / TS]
□ invoke via src/utils/invoke.ts (import de @tauri-apps/api/core)?
□ Runes ($state/$derived/$props), store em *.svelte.ts?
□ $effect com cleanup (return) para listeners de evento?
□ tsc --noEmit limpo?
[ARQUITETURA]
□ Lógica no módulo de feature certo (parsers vs commands)?
□ Sem APIs de Tauri 1 (allowlist, /api/tauri, emit_all)?
