@cupcodev/ui 1.3.0 → 2.0.0

package/README.md

@@ -54,6 +54,7 @@ Importante:
 - `styles.css` agora ja vem compilado para uso direto no app consumidor.
 - `styles/global.css` nao deve ser usado isoladamente, porque nao inclui os tokens.
 - `styles/base.css` e o entrypoint seguro para tema/tokens quando voce nao quer carregar o pacote visual completo.
+- Politica de cor: use `cupcode-hover`/`--cc-hover-overlay` (`#975ab6` a `30%`) para hover/interacao e reserve `cupcode-pink` para destaques fortes (ex.: badges).
 
 ### Config de runtime (env no app consumidor)
 
@@ -63,6 +64,7 @@ Para componentes que dependem de env em runtime (chat/supabase/telescup), config
 import { setCupcodeRuntimeEnv } from "@cupcodev/ui";
 
 setCupcodeRuntimeEnv({
+  VITE_APP_VERSION: import.meta.env.VITE_APP_VERSION,
   VITE_SUPABASE_URL: import.meta.env.VITE_SUPABASE_URL,
   VITE_SUPABASE_ANON_KEY: import.meta.env.VITE_SUPABASE_ANON_KEY,
   VITE_TELESCUP_BASE_URL: import.meta.env.VITE_TELESCUP_BASE_URL,
@@ -70,6 +72,21 @@ setCupcodeRuntimeEnv({
 });
 ```
 
+Para manter a versão do menu do usuário sincronizada com o `package.json` do app consumidor, injete `VITE_APP_VERSION` via Vite:
+
+```ts
+// vite.config.ts
+import packageJson from "./package.json" with { type: "json" };
+
+export default defineConfig({
+  define: {
+    "import.meta.env.VITE_APP_VERSION": JSON.stringify(packageJson.version),
+  },
+});
+```
+
+`UserMenuCupcode` (e `MainNavbar`) aceitam `appVersion` para override explícito. Sem prop, o menu resolve a versão via runtime env pelas chaves exportadas em `CUPCODE_APP_VERSION_ENV_KEYS`.
+
 Observação:
 - Ao instalar/atualizar `@cupcodev/ui`, o pacote exibe esse lembrete no `postinstall`.
 - Se o projeto usa `npm install --ignore-scripts`, esse aviso não aparece; nesse caso, aplique a configuração manualmente.