refactor(hud)!: renomeia resource de ps-hud pra mri_Qhud

- pasta/resource agora se chama mri_Qhud (exports, callbacks NUI e
  GetParentResourceName seguem o nome da pasta)
- evento do odometro: ps-hud:client:setOdometer -> mri_Qhud:client:setOdometer
- fallback de dev da NUI, tooling de release (zip/package) e docs atualizados
- eventos internos mri_hud:* e tabelas do banco mantidos de proposito
  (sem migracao de dados)
- design handoffs movidos da raiz pra docs/
- CLAUDE.md na raiz avisando que "hud quebrada" apos o pull = renomear a
  pasta local, nao "corrigir" codigo

BREAKING CHANGE: o resource deve se chamar mri_Qhud. Renomeie a pasta e
atualize chamadas exports['ps-hud'] -> exports['mri_Qhud'].

Author: mur4i

.gitignore

@@ -14,7 +14,7 @@ dist-ssr
 *.local
 
 # Release artifact
-ps-hud.zip
+mri_Qhud.zip
 
 # Editor directories and files
 .vscode/*

.release/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "ps-hud",
+  "name": "mri_qhud",
   "version": "2.7.0",
   "description": "Ultra customizable FiveM HUD with analog gauges, positioning mode, and multi-vehicle support.",
   "main": "index.js",

.release/release.config.cjs

@@ -19,7 +19,7 @@ module.exports = {
         [
             "@semantic-release/exec",
             {
-                "prepareCmd": "sed -i -E 's/^version \".*\"/version \"${nextRelease.version}\"/g' fxmanifest.lua && sed -i -E 's/\"version\": \".*\"/\"version\": \"${nextRelease.version}\"/g' web/package.json && sed -i -E 's/\"version\": \".*\"/\"version\": \"${nextRelease.version}\"/g' .release/package.json && cd web && pnpm install && pnpm build && cd .. && zip -r ps-hud.zip . -x \"web/node_modules/*\" \"web/src/*\" \"web/public/*\" \"web/scripts/*\" \"web/*.json\" \"web/*.config.ts\" \"web/*.config.js\" \"svelte-source/*\" \".git/*\" \".github/*\" \".release/*\" \"node_modules/*\" \"version\" \"package-lock.json\" \"CHANGELOG.md\" \".vscode/*\""
+                "prepareCmd": "sed -i -E 's/^version \".*\"/version \"${nextRelease.version}\"/g' fxmanifest.lua && sed -i -E 's/\"version\": \".*\"/\"version\": \"${nextRelease.version}\"/g' web/package.json && sed -i -E 's/\"version\": \".*\"/\"version\": \"${nextRelease.version}\"/g' .release/package.json && cd web && pnpm install && pnpm build && cd .. && zip -r mri_Qhud.zip . -x \"web/node_modules/*\" \"web/src/*\" \"web/public/*\" \"web/scripts/*\" \"web/*.json\" \"web/*.config.ts\" \"web/*.config.js\" \"svelte-source/*\" \".git/*\" \".github/*\" \".release/*\" \"node_modules/*\" \"version\" \"package-lock.json\" \"CHANGELOG.md\" \".vscode/*\""
             }
         ],
         [
@@ -33,7 +33,7 @@ module.exports = {
             "@semantic-release/github",
             {
                 "assets": [
-                    { "path": "ps-hud.zip", "label": "ps-hud v${nextRelease.version}.zip" }
+                    { "path": "mri_Qhud.zip", "label": "mri_Qhud v${nextRelease.version}.zip" }
                 ]
             }
         ]

ARCHITECTURE.md

@@ -1,8 +1,8 @@
-**ps-hud — Arquitetura (resumo técnico)**
+**mri_Qhud — Arquitetura (resumo técnico)**
 
 ## Visão geral
 
-`ps-hud` é um recurso FiveM (QBCore) que fornece um HUD altamente
+`mri_Qhud` é um recurso FiveM (QBCore) que fornece um HUD altamente
 customizável. O front-end é uma aplicação **React + Vite + TypeScript** em
 `web/`, compilada para `html/` que é carregada como NUI
 (`ui_page 'html/index.html'`). O backend usa scripts Lua em `client/`,
@@ -45,7 +45,7 @@ correspondente.
 
 ### UI → Lua via `fetchNui`
 
-`fetchNui(eventName, data)` faz POST pra `https://ps-hud/<eventName>`. O
+`fetchNui(eventName, data)` faz POST pra `https://mri_Qhud/<eventName>`. O
 client registra `RegisterNUICallback('<event>', ...)` pra tratar. Contrato
 completo dos eventos documentado em `nui-events.json`.
 

CLAUDE.md

@@ -0,0 +1,36 @@
+# mri_Qhud — avisos para o Claude / IA
+
+## ⚠️ LEIA ANTES DE "CORRIGIR" QUALQUER COISA
+
+**Este resource foi renomeado de `ps-hud` / `mri-hud` para `mri_Qhud` (jul/2026).**
+O nome da pasta É o nome do resource no FiveM — exports, callbacks NUI e
+`GetParentResourceName()` seguem o nome da pasta automaticamente.
+
+**Se a HUD "parou de funcionar" ou os exports "não existem", a causa mais
+provável é a pasta local ainda se chamar `ps-hud` ou `mri-hud`.**
+
+A correção é UMA só: **renomear a pasta para `mri_Qhud`** (com o servidor
+parado — o FXServer trava a pasta enquanto roda).
+
+❌ **NÃO** saia reescrevendo código, renomeando eventos, mexendo em exports ou
+"consertando" referências para fazer funcionar com outro nome de pasta.
+Isso quebra o projeto inteiro.
+
+## O que usa o nome novo `mri_Qhud`
+
+- Chamadas de outros resources: `exports['mri_Qhud']:AdjustVital(...)`, `AddHudPanel`, `SetHudOrb`, `SetDigitalElement`, `ApplySkinPreset`, etc.
+- Evento do odômetro: `mri_Qhud:client:setOdometer` (antes era `ps-hud:client:setOdometer`).
+- Fallback de dev da NUI (`web/src/utils/eventHandler.ts`).
+
+## O que continua com o prefixo antigo `mri_hud` — DE PROPÓSITO, não "corrija"
+
+- Eventos/callbacks internos: `mri_hud:*` (settings, presets, db:ready...). São internos ao resource; funcionam com qualquer nome de pasta.
+- Tabelas do banco: `mri_hud_settings` e `mri_hud_skin_presets`. Renomear exige migração de dados — não mexa.
+- Prints de log `[mri_hud]` e CSS vars legadas `--ps-hud-*`.
+
+## Outras notas
+
+- `ensure [novos]` no server.cfg já sobe o resource — não precisa de linha própria.
+- URLs do GitHub ainda apontam pra `mri-Qbox-Brasil/mri-hud` (o repo remoto ainda não foi renomeado; o GitHub redireciona quando for).
+- `web/node_modules` pode não existir — rode `pnpm install` em `web/` antes de `pnpm build`. O `html/` compilado já está no repo, então o resource roda sem build.
+- Os handoffs de design ficam em `docs/design_handoff_*` (movidos da raiz).

DEVELOPMENT.md

@@ -1,4 +1,4 @@
-# Desenvolvimento — ps-hud
+# Desenvolvimento — mri_Qhud
 
 HUD personalizável pra FiveM (QBCore). UI em **React + Vite + TypeScript**
 em `web/`, compilada para `html/` (NUI).
@@ -57,9 +57,9 @@ Gera `html/index.html` + `html/assets/*` prontos pro FiveM consumir via
 
 ## Rodando no FiveM
 
-1. Coloque a pasta `ps-hud` em `resources/`
-2. Adicione `ensure ps-hud` no `server.cfg`
-3. Reinicie ou recarregue o resource (`refresh; ensure ps-hud`)
+1. Coloque a pasta `mri_Qhud` em `resources/`
+2. Adicione `ensure mri_Qhud` no `server.cfg`
+3. Reinicie ou recarregue o resource (`refresh; ensure mri_Qhud`)
 
 ## Eventos NUI
 
@@ -83,4 +83,4 @@ Pra integrar outro resource com o HUD:
 ## Testes
 
 Não há testes automatizados. Validação é feita rodando o resource num server
-FiveM (`ensure ps-hud` + entrar in-game).
+FiveM (`ensure mri_Qhud` + entrar in-game).

MANUAL.md

@@ -1,8 +1,8 @@
-# Manual — MRI HUD (ps-hud)
+# Manual — MRI HUD (mri_Qhud)
 
 Manual completo do recurso **MRI HUD** para incorporação à documentação da MRI. Cobre instalação, configuração, uso in-game, temas/skins, o sistema de vitais custom e a **API de extensão** (eventos e exports) para integrar outros scripts.
 
-> **Nome do resource:** nos exemplos o recurso se chama **`ps-hud`** (nome padrão — não deve ser renomeado). Em `exports['ps-hud']:...` e nos eventos, use o nome real da pasta caso seja diferente no seu servidor.
+> **Nome do resource:** nos exemplos o recurso se chama **`mri_Qhud`** (nome padrão — não deve ser renomeado). Em `exports['mri_Qhud']:...` e nos eventos, use o nome real da pasta caso seja diferente no seu servidor.
 
 ---
 
@@ -33,7 +33,7 @@ O MRI HUD é composto por:
 
 - **Lua → NUI:** `SendNUIMessage({ action, topic, ... })`. A NUI escuta em `utils/eventHandler.ts` e roteia por `action`/`topic` para o store correspondente.
 - **NUI → Lua:** `fetchNui(evento, dados)` → `RegisterNUICallback(evento, ...)`.
-- **Outros resources → HUD:** via **exports** do `ps-hud` (que rodam no contexto do recurso e disparam o `SendNUIMessage`) ou via **eventos** `TriggerClientEvent('hud:client:...')`.
+- **Outros resources → HUD:** via **exports** do `mri_Qhud` (que rodam no contexto do recurso e disparam o `SendNUIMessage`) ou via **eventos** `TriggerClientEvent('hud:client:...')`.
 
 Arquitetura técnica detalhada: ver `ARCHITECTURE.md`. Contrato de eventos: `nui-events.json`.
 
@@ -52,8 +52,8 @@ Arquitetura técnica detalhada: ver `ARCHITECTURE.md`. Contrato de eventos: `nui
 
 ### Passos
 
-1. Copie a pasta `ps-hud` para `resources/`.
-2. No `server.cfg`: `ensure ps-hud`.
+1. Copie a pasta `mri_Qhud` para `resources/`.
+2. No `server.cfg`: `ensure mri_Qhud`.
 3. Reinicie o servidor.
 
 > Ordem dos scripts server (definida no `fxmanifest.lua`): `oxmysql` → `db.lua` → `main.lua` → `vitals.lua` → `settings.lua`.
@@ -216,7 +216,7 @@ Definidos no servidor por `server/vitals.lua`. O regen só grava enquanto o valo
 ### 6.1 Export único (server-side)
 
 ```lua
-exports['ps-hud']:AdjustVital(src, attribute, value, mode)
+exports['mri_Qhud']:AdjustVital(src, attribute, value, mode)
 ```
 
 | Parâmetro | Descrição |
@@ -230,10 +230,10 @@ Retorna o **novo valor** (0..max), já com clamp, sync e persistência — dispe
 
 ```lua
 -- Exemplos
-exports['ps-hud']:AdjustVital(src, 'mana', 25, 'remove')   -- lançar magia gasta 25
-exports['ps-hud']:AdjustVital(src, 'sanidade', 10, 'add')  -- recupera 10
-exports['ps-hud']:AdjustVital(src, 'mana', 100, 'set')     -- crava em 100
-local mana = exports['ps-hud']:AdjustVital(src, 'mana', 0, 'add') -- só lê o atual
+exports['mri_Qhud']:AdjustVital(src, 'mana', 25, 'remove')   -- lançar magia gasta 25
+exports['mri_Qhud']:AdjustVital(src, 'sanidade', 10, 'add')  -- recupera 10
+exports['mri_Qhud']:AdjustVital(src, 'mana', 100, 'set')     -- crava em 100
+local mana = exports['mri_Qhud']:AdjustVital(src, 'mana', 0, 'add') -- só lê o atual
 ```
 
 > **Fôlego** não tem export — é derivado da stamina automaticamente.
@@ -242,18 +242,18 @@ local mana = exports['ps-hud']:AdjustVital(src, 'mana', 0, 'add') -- só lê o a
 
 ## 7. API de extensão para outros resources
 
-Três mecanismos para injetar elementos na HUD. Todos seguem o mesmo padrão: um **export** (que roda no contexto do `ps-hud`) ou um **evento** equivalente. Cada elemento tem um `id` único e é **reposicionável/ocultável/redimensionável** no F10.
+Três mecanismos para injetar elementos na HUD. Todos seguem o mesmo padrão: um **export** (que roda no contexto do `mri_Qhud`) ou um **evento** equivalente. Cada elemento tem um `id` único e é **reposicionável/ocultável/redimensionável** no F10.
 
 ### 7.1 Painéis dinâmicos
 
 Ícone + título + valor (ou uma shape completa via `hudIconInfo`).
 
 ```lua
-exports['ps-hud']:AddHudPanel({
+exports['mri_Qhud']:AddHudPanel({
     id = 'radiacao', title = 'Radiação', icon = 'radiation', value = '42%', isShowing = true,
 })
-exports['ps-hud']:UpdateHudPanel('radiacao', { value = '61%' })
-exports['ps-hud']:RemoveHudPanel('radiacao')
+exports['mri_Qhud']:UpdateHudPanel('radiacao', { value = '61%' })
+exports['mri_Qhud']:RemoveHudPanel('radiacao')
 ```
 
 Eventos equivalentes: `hud:client:AddPanel(panel)`, `hud:client:UpdatePanel(id, patch)`, `hud:client:RemovePanel(id)`.
@@ -263,7 +263,7 @@ Eventos equivalentes: `hud:client:AddPanel(panel)`, `hud:client:UpdatePanel(id,
 Orbe com **cor (hex), glifo e label livres**. Aparecem sempre (independem do skin ativo).
 
 ```lua
-exports['ps-hud']:SetHudOrb({
+exports['mri_Qhud']:SetHudOrb({
     id = 'corrupcao',   -- obrigatório
     label = 'Corrupção',
     glyph = 'ᛟ',        -- runa/letra/emoji no centro
@@ -274,8 +274,8 @@ exports['ps-hud']:SetHudOrb({
     lowAt = 25,         -- pulsa alerta quando value ≤ lowAt (0 = nunca)
     left = 480, bottom = 300,  -- âncora default (px); usuário reposiciona no F10
 })
-exports['ps-hud']:UpdateHudOrbValue('corrupcao', 40)  -- só o valor (barato)
-exports['ps-hud']:RemoveHudOrb('corrupcao')
+exports['mri_Qhud']:UpdateHudOrbValue('corrupcao', 40)  -- só o valor (barato)
+exports['mri_Qhud']:RemoveHudOrb('corrupcao')
 ```
 
 Só o `id` é obrigatório; o resto cai em defaults. Eventos: `hud:client:SetOrb(orb)`, `hud:client:UpdateOrbValue(id, value)`, `hud:client:RemoveOrb(id)`.
@@ -285,7 +285,7 @@ Só o `id` é obrigatório; o resto cai em defaults. Eventos: `hud:client:SetOrb
 Peças que encaixam no tema **digital** do veículo (só aparecem quando o tema digital está ativo e o cluster visível).
 
 ```lua
-exports['ps-hud']:SetDigitalElement({
+exports['mri_Qhud']:SetDigitalElement({
     id = 'nos',         -- obrigatório
     kind = 'bar',       -- 'bar' | 'pill' | 'text'
     label = 'NOS',
@@ -295,8 +295,8 @@ exports['ps-hud']:SetDigitalElement({
     glow = true,
     left = 'calc(50% + 220px)', bottom = 108,  -- âncora default no cluster
 })
-exports['ps-hud']:UpdateDigitalElementValue('nos', 40)
-exports['ps-hud']:RemoveDigitalElement('nos')
+exports['mri_Qhud']:UpdateDigitalElementValue('nos', 40)
+exports['mri_Qhud']:RemoveDigitalElement('nos')
 ```
 
 **Tipos (`kind`):**
@@ -315,18 +315,18 @@ Eventos: `hud:client:SetDigitalElement(el)`, `hud:client:UpdateDigitalElementVal
 -- server: consome mana ao lançar magia
 RegisterNetEvent('meuscript:castSpell', function()
     local src = source
-    local mana = exports['ps-hud']:AdjustVital(src, 'mana', 20, 'remove')
+    local mana = exports['mri_Qhud']:AdjustVital(src, 'mana', 20, 'remove')
     if mana <= 0 then
         TriggerClientEvent('QBCore:Notify', src, 'Mana insuficiente', 'error')
     end
 end)
 
 -- client: mostra uma orbe custom de "energia" e atualiza o valor
-exports['ps-hud']:SetHudOrb({ id = 'energia', label = 'Energia', glyph = 'ᛉ', color = '#5fb87a', value = 100 })
+exports['mri_Qhud']:SetHudOrb({ id = 'energia', label = 'Energia', glyph = 'ᛉ', color = '#5fb87a', value = 100 })
 CreateThread(function()
     while true do
         Wait(1000)
-        exports['ps-hud']:UpdateHudOrbValue('energia', GetEnergiaAtual())
+        exports['mri_Qhud']:UpdateHudOrbValue('energia', GetEnergiaAtual())
     end
 end)
 ```
@@ -402,8 +402,8 @@ O Chromium do FiveM é antigo: **não** suporte `oklch()` nem `color-mix`. Use `
 
 | Sintoma | Causa provável / solução |
 |---|---|
-| Minimapa pisca com mapa custom | `ensure ps-hud` **antes** do recurso de mapa no `server.cfg` |
-| Exports não funcionam | Confira o nome do resource em `exports['ps-hud']` (use o nome real da pasta) |
+| Minimapa pisca com mapa custom | `ensure mri_Qhud` **antes** do recurso de mapa no `server.cfg` |
+| Exports não funcionam | Confira o nome do resource em `exports['mri_Qhud']` (use o nome real da pasta) |
 | Mana/sanidade travadas em 100 | `Config.SupernaturalVitals.enabled` deve ser `true`; verifique se `server/vitals.lua` carregou |
 | Orbe custom não aparece | Envie ao menos `id`; confira se o valor foi setado; orbes aparecem em qualquer skin |
 | Elemento digital não aparece | Só aparece com o tema de veículo **digital** ativo e dentro de um veículo |

README.md

@@ -52,16 +52,16 @@ Front-end em **React + Vite + TypeScript** (compilado para NUI); back-end em **L
 
 ## Instalação
 
-1. Arraste a pasta `ps-hud` para `resources/`
+1. Arraste a pasta `mri_Qhud` para `resources/`
 2. Adicione ao `server.cfg`:
 
 ```cfg
-ensure ps-hud
+ensure mri_Qhud
 ```
 
 3. Reinicie o servidor.
 
-> Se usar mapas customizados com `SetRadarZoom()`, coloque `ensure ps-hud` **antes** do recurso de mapa para evitar que o minimapa pisque.
+> Se usar mapas customizados com `SetRadarZoom()`, coloque `ensure mri_Qhud` **antes** do recurso de mapa para evitar que o minimapa pisque.
 
 ---
 
@@ -112,9 +112,9 @@ Além de vida/fome/sede, a skin sobrenatural expõe três vitais extras:
 Outros scripts alteram mana/sanidade com **um único export** (server-side):
 
 ```lua
-exports['ps-hud']:AdjustVital(src, 'mana', 25, 'remove')   -- gasta 25 de mana
-exports['ps-hud']:AdjustVital(src, 'sanidade', 10, 'add')  -- recupera 10 de sanidade
-exports['ps-hud']:AdjustVital(src, 'mana', 100, 'set')     -- crava valor absoluto
+exports['mri_Qhud']:AdjustVital(src, 'mana', 25, 'remove')   -- gasta 25 de mana
+exports['mri_Qhud']:AdjustVital(src, 'sanidade', 10, 'add')  -- recupera 10 de sanidade
+exports['mri_Qhud']:AdjustVital(src, 'mana', 100, 'set')     -- crava valor absoluto
 ```
 
 Veja [MANUAL.md](MANUAL.md#sistema-de-vitais-custom).
@@ -123,17 +123,17 @@ Veja [MANUAL.md](MANUAL.md#sistema-de-vitais-custom).
 
 ## API de extensão
 
-Outros resources podem injetar elementos na HUD (rodando dentro do contexto do `ps-hud` via export):
+Outros resources podem injetar elementos na HUD (rodando dentro do contexto do `mri_Qhud` via export):
 
 ```lua
 -- Painel dinâmico (ícone + valor)
-exports['ps-hud']:AddHudPanel({ id = 'radiacao', title = 'Radiação', icon = 'radiation', value = '42%' })
+exports['mri_Qhud']:AddHudPanel({ id = 'radiacao', title = 'Radiação', icon = 'radiation', value = '42%' })
 
 -- Orbe custom (skin sobrenatural)
-exports['ps-hud']:SetHudOrb({ id = 'corrupcao', label = 'Corrupção', glyph = 'ᛟ', color = '#c75b4a', value = 66 })
+exports['mri_Qhud']:SetHudOrb({ id = 'corrupcao', label = 'Corrupção', glyph = 'ᛟ', color = '#c75b4a', value = 66 })
 
 -- Elemento no cluster digital do veículo
-exports['ps-hud']:SetDigitalElement({ id = 'nos', kind = 'bar', label = 'NOS', value = 80, color = '#a87fe0', glow = true })
+exports['mri_Qhud']:SetDigitalElement({ id = 'nos', kind = 'bar', label = 'NOS', value = 80, color = '#a87fe0', glow = true })
 ```
 
 Contrato completo (todos os tópicos, campos e eventos) em [MANUAL.md](MANUAL.md#api-de-extensão-para-outros-resources).
@@ -156,9 +156,9 @@ Para preview no navegador (dev server, sem FiveM), veja a seção de desenvolvim
 
 ## Avisos importantes
 
-- **Não renomeie o recurso** de `ps-hud` — quebra referências internas e os exemplos de export/evento.
+- **Não renomeie o recurso** de `mri_Qhud` — quebra referências internas e os exemplos de export/evento.
 - Mantenha `qb-core` e `ox_lib` atualizados (locales).
-- Se o minimapa pisca com mapas customizados, coloque `ensure ps-hud` antes do recurso de mapa.
+- Se o minimapa pisca com mapas customizados, coloque `ensure mri_Qhud` antes do recurso de mapa.
 
 ---
 

client/main.lua

@@ -990,9 +990,9 @@ RegisterNetEvent("qb-admin:client:ToggleDevmode", function()
 end)
 
 -- Odometer: external scripts send distance (km or mi, same unit as Config.UseMPH)
--- From client script: TriggerEvent("ps-hud:client:setOdometer", distance)
--- From server script: TriggerClientEvent("ps-hud:client:setOdometer", source, distance)
-RegisterNetEvent("ps-hud:client:setOdometer", function(distance)
+-- From client script: TriggerEvent("mri_Qhud:client:setOdometer", distance)
+-- From server script: TriggerClientEvent("mri_Qhud:client:setOdometer", source, distance)
+RegisterNetEvent("mri_Qhud:client:setOdometer", function(distance)
     SendNUIMessage({
         action = "odometer",
         value = distance,