ui-optago 1.1.1 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/llms.txt ADDED
@@ -0,0 +1,192 @@
1
+ # UI Óptago
2
+
3
+ > Design system em CSS puro + JavaScript vanilla (sem build, sem dependências de framework) da Óptago. Todas as classes usam o prefixo `op-`, estados usam `is-` (`is-open`, `is-active`, `is-error`...), e a maior parte dos comportamentos interativos liga sozinha via atributos `data-op-*`, sem precisar escrever JS. API global em `window.OptagoUI`. Versão atual: `1.2.0`.
4
+
5
+ Este arquivo é a referência otimizada para agentes de IA/LLMs que forem gerar HTML usando esta biblioteca. Para a documentação em prosa (humanos), veja [README.md](README.md). Para ver todos os componentes renderizados com exemplo de código, veja [index.html](index.html) (showcase).
6
+
7
+ ## Instalação (escolha uma)
8
+
9
+ CDN, versão fixa (recomendado em produção, sem definir versão especifica ele estará sempre na versão mais atual da biblioteca):
10
+
11
+ ```html
12
+ <link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.0/ui-optago.css">
13
+ <script src="https://unpkg.com/ui-optago@1.2.0/ui-optago.js"></script>
14
+ ```
15
+
16
+ npm:
17
+
18
+ ```bash
19
+ npm install ui-optago
20
+ ```
21
+ ```html
22
+ <link rel="stylesheet" href="node_modules/ui-optago/ui-optago.css">
23
+ <script src="node_modules/ui-optago/ui-optago.js"></script>
24
+ ```
25
+
26
+ Arquivos locais: copie `ui-optago.css` e `ui-optago.js` para o projeto e sirva localmente.
27
+
28
+ ## Regras que um agente NÃO pode quebrar
29
+
30
+ 1. **Sempre incluir os dois arquivos juntos**: `ui-optago.css` E `ui-optago.js`. O JS não é opcional: ele aplica o tema salvo, injeta fontes/ícones e liga todos os `data-op-*`. Sem ele, os componentes ficam sem interatividade e sem tema.
31
+ 2. **NUNCA usar `defer` ou `async` no `<script>` do `ui-optago.js`, nem movê-lo pro fim do `<body>`.** Ele precisa rodar antes do primeiro paint pra aplicar a classe `light`/tema no `<html>` e evitar flash de tema errado (FOUC). Carregue no `<head>`, na ordem: `<link>` do CSS primeiro, depois `<script>` do JS.
32
+ 3. **Todo elemento raiz da página precisa da estrutura de app shell** (`body.op-app` > `.op-app-body` + `aside.op-sidebar`) se for usar header/sidebar fixos; ver seção "Layout" abaixo. Componentes isolados (um card, um modal, um formulário) NÃO precisam do app shell, funcionam soltos em qualquer página.
33
+ 4. **A sidebar (`.op-sidebar`) fica à DIREITA da tela**, não à esquerda. É fixa, colapsa para só ícones no desktop (clique em `[data-op-sidebar-toggle]`) e vira drawer no mobile (`[data-op-sidebar-mobile]`). Por padrão ela inicia **colapsada** (só ícones); o estado escolhido pelo usuário fica salvo em `localStorage`.
34
+ 5. **Não hardcode cores em `style=""` nos componentes.** Use as classes de variante (`op-btn-danger`, `op-alert-warning`...) ou, se precisar de cor customizada, sobrescreva os tokens `--op-*` (ver seção Tokens). Isso garante que o componente continue correto nos dois temas.
35
+ 6. **`op-btn-primary` e `op-btn-secondary` têm cor FIXA, igual nos dois temas** (não seguem a variável `--op-primary`, que muda por tema e é usada só internamente por outros componentes como checkbox/switch/paginação). Primário = sempre verde-lima `#C0FF6B` com texto preto. Secundário = sempre cinza-chumbo `#656565` com texto branco. Não tente "corrigir" isso pra usar `var(--op-primary)`, é proposital.
36
+ 7. **Tema claro/escuro é controlado só pela classe `light` no `<html>`**, aplicada automaticamente pelo JS (lê cookie/`localStorage`, senão `prefers-color-scheme`). Não escreva lógica própria de tema; use `OptagoUI.setTheme('light'|'dark')` se precisar forçar via JS.
37
+ 10. **Tema compartilhado entre subdomínios**: adicione `data-op-theme-domain` no `<script>` da lib (ex.: `<script src="ui-optago.js" data-op-theme-domain=".seusite.com"></script>`) e o tema passa a ser salvo num cookie com esse `Domain`, em vez de só `localStorage`. Assim, `app1.seusite.com` e `app2.seusite.com` compartilham a mesma escolha de tema automaticamente. Sem esse atributo, o comportamento continua sendo só `localStorage` (por app, isolado). O valor precisa começar com `.` e ser um domínio de verdade que a página atual pertence (não use domínios de terceiros).
38
+ 8. **Ícones**: a lib usa Phosphor Icons (`<i class="ph ph-nome-do-icone"></i>`), injetado automaticamente via CDN pelo JS. Não precisa adicionar `<link>`/`<script>` do Phosphor manualmente.
39
+ 9. **Fontes**: Chakra Petch (títulos, `--op-font-display`), Inter (corpo, `--op-font-sans`), JetBrains Mono (mono/labels/botões, `--op-font-mono`), injetadas automaticamente via Google Fonts pelo JS.
40
+
41
+ ## Layout obrigatório (app shell)
42
+
43
+ Use isto quando a página precisar de header + sidebar fixos (painel administrativo, dashboard, showcase):
44
+
45
+ ```html
46
+ <body class="op-app">
47
+ <div class="op-app-body">
48
+ <header class="op-header">...</header>
49
+ <main class="op-main">CONTEÚDO ROLÁVEL AQUI</main>
50
+ <footer class="op-footer">...</footer>
51
+ </div>
52
+ <aside class="op-sidebar">
53
+ <div class="op-sidebar-header">...<button data-op-sidebar-toggle><i class="ph ph-sidebar-simple"></i></button></div>
54
+ <nav class="op-sidebar-nav">
55
+ <a class="op-nav-item" href="#secao">
56
+ <i class="ph ph-palette"></i>
57
+ <span class="op-nav-text">Título</span>
58
+ <span class="op-nav-tooltip">Título</span>
59
+ </a>
60
+ </nav>
61
+ </aside>
62
+ </body>
63
+ ```
64
+
65
+ Só `.op-main` rola (scroll interno). Header, footer e sidebar são fixos. `.op-nav-item.is-active` marca o item ativo (pílula preenchida com a cor de marca, igual nos dois temas).
66
+
67
+ ## Catálogo de componentes (classes `op-*`)
68
+
69
+ | Grupo | Classes |
70
+ |---|---|
71
+ | Botões | `op-btn` + `op-btn-primary` (verde-lima fixo) / `op-btn-secondary` (cinza-chumbo fixo) / `op-btn-success` / `op-btn-danger` / `op-btn-warning` / `op-btn-info` / `op-btn-cyan`; ghosts: `op-btn-ghost`, `op-btn-ghost-info/success/danger/warning/cyan`; tamanhos `op-btn-sm`/`op-btn-lg`; `op-btn-icon` (só ícone); `op-btn-group` (agrupa vários `.op-btn` colados); estado `is-loading`; `disabled` ou `is-disabled` |
72
+ | Badges | `op-badge` + `op-badge-brand/info/success/warning/danger/cyan`, `op-badge-pill` (arredondado total), `op-dot` (bolinha de status, some com `op-dot-pulse` pra pulsar) |
73
+ | Alertas | `op-alert` + `op-alert-info/success/warning/danger`; filhos: `op-alert-title`, `op-alert-text`, `op-alert-close` (com `data-op-dismiss`) |
74
+ | Formulários | `op-field` (wrapper), `op-label` (+ `<span class="req">` pro asterisco obrigatório), `op-input`/`op-select`/`op-textarea`, `op-help` (+ `is-error`/`is-success`), `op-check` (checkbox/radio customizado), `op-switch` (toggle), `op-range` (slider), `op-input-icon` (input com ícone à esquerda), `op-input-group` + `op-input-addon` (prefixo/sufixo), `[data-op-reveal]` + `op-reveal-btn` (mostrar/ocultar senha), `op-combobox` (input com busca/filtro de opções, ver seção própria abaixo); estados `is-error`/`is-success` nos inputs; tamanhos `op-input-xs`/`op-input-sm`/`op-input-lg` em `op-input`, `op-select` e `op-textarea` (sem modificador = tamanho normal, o padrão) |
75
+ | Tabelas | `op-table` (+ `op-table-hover`, `op-table-striped`) para tabela HTML simples; `OptagoUI.tabulator()` para tabela avançada (ordenação/paginação) com tema Óptago aplicado |
76
+ | Cards | `op-card`, `op-card-hover` (efeito hover), `op-card-title`, `op-card-text`, `op-stat` (cartão de KPI/métrica) |
77
+ | Feedback | `op-progress` + `op-progress-bar` (+ `is-info/success/warning/danger`), `op-spinner` (+ `op-spinner-sm/lg`, `op-spinner-dots`), `op-skeleton` (+ `-thumb`/`-title`/`-btn`/`-badge`/`-row`), toasts (via JS, não classe direta) |
78
+ | Navegação | `op-tabs` (sublinhado) / `op-tabs-pills` (pílulas) / `op-tabs-vertical` + `op-tabs-col` (vertical, tipo settings-page); todas usam `.op-tab` + `.op-tab.is-active` (pílula preenchida com cor de marca) e `.op-tab-panel.is-active`; `op-accordion` (usa `<details>` nativo); `op-breadcrumb`; `op-pagination` + `op-page.is-active`; `op-dropdown` + `op-menu` (abre alinhado à esquerda do gatilho por padrão; use `op-menu-end` se precisar abrir alinhado à direita) |
79
+ | Overlays | `op-modal` (+ `op-modal-drawer` lateral, `op-modal-centered` sem header, `op-modal-sm`/`op-modal-lg`); tooltip 100% CSS via atributo `data-op-tip="texto"` (+ variante `op-tip-bottom`) |
80
+ | Tela de carregamento | `OptagoUI.showLoading('mensagem')` / `OptagoUI.hideLoading()`, ou `data-op-loading-form` no `<form>` pra acionar sozinho no submit; overlay full-screen com blur, criado e destruído automaticamente pelo JS |
81
+ | Extras | `op-timeline` (marcadores octogonais; some `op-timeline-horizontal` junto pra virar linha do tempo horizontal, itens em coluna), `op-glow` (+ `-sm`/`-lg`/`-strong`/`-info`/`-cyan`, manchas desfocadas de fundo; precisa de um ancestral `position:relative`), `op-avatar` (+ `-sm`/`-lg`, `-ring`), `op-avatar-group` |
82
+ | Layout/utilitários | `op-row` (flex wrap), `op-stack` (flex column), `op-grid-2/3/4` (grid responsivo), `op-mobile-only`, `op-text-muted`/`op-text-accent`/`op-text-mono`/`op-text-sm`/`op-text-xs`, `op-mt-1..4`/`op-mb-1..4` |
83
+
84
+ ## Combobox (input com busca)
85
+
86
+ Estrutura obrigatória (o JS liga sozinho via `data-op-*`, não precisa de mais nada):
87
+
88
+ ```html
89
+ <div class="op-combobox" data-op-combobox>
90
+ <input class="op-input" data-op-combobox-input type="text" placeholder="Buscar..." autocomplete="off">
91
+ <div class="op-combobox-menu" data-op-combobox-menu>
92
+ <button type="button" class="op-combobox-option" data-op-combobox-option data-value="br">Brasil</button>
93
+ <button type="button" class="op-combobox-option" data-op-combobox-option data-value="pt">Portugal</button>
94
+ <div class="op-combobox-empty" hidden>Nenhum resultado</div>
95
+ </div>
96
+ </div>
97
+ ```
98
+
99
+ Abre no foco do input, filtra as opções pelo texto digitado (case-insensitive), navega com seta pra cima/baixo, seleciona com clique ou Enter, fecha com ESC/clique fora. Ao selecionar: o `<input>` recebe o texto da opção, e o `data-value` da opção escolhida fica disponível em `elementoComCombobox.dataset.value`. Dispara um evento `change` no input ao selecionar, pra quem quiser ouvir. Não cria `<select>`/`<option>` nativos, é só `<div>`/`<button>`; se precisar enviar o valor num `<form>` tradicional, leia `dataset.value` no submit ou espelhe num `<input type="hidden">`.
100
+
101
+ ## Atributos `data-op-*` (comportamento sem escrever JS)
102
+
103
+ | Atributo | Ação |
104
+ |---|---|
105
+ | `data-op-theme-toggle` | Alterna tema claro/escuro no elemento clicado (persiste em `localStorage`) |
106
+ | `data-op-sidebar-toggle` | Colapsa/expande a sidebar (desktop) |
107
+ | `data-op-sidebar-mobile` | Abre/fecha a sidebar como drawer (mobile) |
108
+ | `data-op-modal-open="#id"` | Abre o modal com esse id |
109
+ | `data-op-modal-close` | Fecha o modal ancestral (ESC e clique no backdrop também fecham) |
110
+ | `data-op-tab="nome"` | Botão de aba; use `data-op-tab-group="grupo"` no container pai quando houver mais de um grupo de tabs na mesma página |
111
+ | `data-op-tab-panel="nome"` | Painel correspondente a `data-op-tab="nome"` |
112
+ | `data-op-dropdown-toggle` | Abre/fecha o `.op-dropdown` ancestral mais próximo |
113
+ | `data-op-dismiss` | Remove o `.op-alert` (ou o pai direto) com animação |
114
+ | `data-op-tip="texto"` | Tooltip em CSS puro no elemento (hover) |
115
+ | `data-op-copy="#seletor"` | Copia o HTML do elemento alvo pro clipboard |
116
+ | `data-op-code="#seletor"` | Mostra/esconde um bloco `<pre>` com o código-fonte do elemento alvo |
117
+ | `data-op-loading-form` | No `<form>`: mostra a tela de carregamento sozinho ao submeter |
118
+ | `data-op-loading-message="texto"` | Mensagem customizada pro `data-op-loading-form` (padrão: "Carregando...") |
119
+ | `data-op-reveal` (no wrapper) + `data-op-reveal-toggle` (no botão dentro) | Mostrar/ocultar senha; o wrapper envolve o `<input type="password">` e o botão |
120
+ | `data-op-toast='[{"type":"success","message":"Oi"}]'` | Dispara toast(s) a partir de flash messages vindas do servidor, sem `<script>` inline (funciona sob CSP estrito). Aceita um objeto único ou array. Campos: `type` (`success`/`error`/`warning`/`info`), `message`, `duration` (ms, opcional) |
121
+ | `data-op-version` | Elemento cujo texto é substituído pela versão da lib (ex.: `v1.2.0`) no carregamento |
122
+ | `data-op-combobox` (wrapper) + `data-op-combobox-input` + `data-op-combobox-menu` + `data-op-combobox-option` | Combobox com busca/filtro; ver seção "Combobox" acima pra estrutura completa |
123
+
124
+ ## API JavaScript (`window.OptagoUI`)
125
+
126
+ ```js
127
+ OptagoUI.toast(mensagem, tipo, duracaoMs); // tipo: 'success' | 'error' | 'warning' | 'info' (padrão 'info'); duração padrão 4000ms
128
+ // toast pausa o contador ao passar o mouse ou focar nele, e mostra barra de progresso
129
+ OptagoUI.openModal('#idDoModal');
130
+ OptagoUI.closeModal('#idDoModal');
131
+ OptagoUI.setTheme('light'); // 'dark' | 'light', também persiste em localStorage
132
+ OptagoUI.toggleTheme();
133
+ OptagoUI.toggleSidebar(); // desktop: colapsa/expande; mobile: chama toggleSidebarMobile()
134
+ OptagoUI.toggleSidebarMobile();
135
+ OptagoUI.closeSidebarMobile();
136
+ OptagoUI.showLoading('Salvando...'); // mostra overlay de carregamento full-screen; mensagem opcional
137
+ OptagoUI.hideLoading();
138
+ OptagoUI.copyHTML('#seletor', botaoOpcional); // usado internamente por data-op-copy
139
+ OptagoUI.toggleCode('#seletor', botao); // usado internamente por data-op-code
140
+ OptagoUI.version; // string, ex. "1.2.0"
141
+
142
+ // Tabela avançada: carrega Tabulator via CDN sob demanda, já com tema Óptago aplicado
143
+ OptagoUI.tabulator('#minhaTabela', {
144
+ layout: 'fitColumns',
145
+ pagination: true,
146
+ data: [...],
147
+ columns: [...]
148
+ }).then(instanciaTabulator => { /* ... */ });
149
+ ```
150
+
151
+ ## Tokens CSS (design tokens, sobrescrevíveis)
152
+
153
+ Sobrescreva no seu próprio CSS, depois de importar `ui-optago.css`:
154
+
155
+ ```css
156
+ :root {
157
+ --op-accent: #C0FF6B; /* verde-lima, cor primária da marca */
158
+ --op-cyan: #6BE0FF; /* ciano, cor secundária da marca */
159
+ --op-info: #3B82F6;
160
+ --op-success: #10B981;
161
+ --op-warning: #F59E0B;
162
+ --op-danger: #EF4444;
163
+ --op-radius: 12px; /* --op-radius-sm: 8px, --op-radius-lg: 16px */
164
+ /* superfícies (mudam por tema, não sobrescreva sem pensar nos dois): */
165
+ /* --op-bg, --op-panel, --op-panel-2, --op-panel-3, --op-border, --op-border-2, --op-text, --op-strong, --op-muted */
166
+ }
167
+ ```
168
+
169
+ Tema escuro é o `:root` (padrão). Tema claro redefine as mesmas variáveis dentro de `html.light { ... }`, aplicado automaticamente pelo JS.
170
+
171
+ ## Selo "Desenvolvido por Óptago"
172
+
173
+ Para rodapé de QUALQUER site da Óptago, mesmo sites que não usam o resto da lib. Dois arquivos autocontidos (não dependem de `ui-optago.css`/`.js`): `optago-credit-dark.html` (fundos escuros/neutros) e `optago-credit-light.html` (fundos claros).
174
+
175
+ ```html
176
+ <div id="optago-credit"></div>
177
+ <script>
178
+ fetch('https://unpkg.com/ui-optago@1.2.0/optago-credit-dark.html')
179
+ .then(r => r.text())
180
+ .then(html => document.getElementById('optago-credit').innerHTML = html);
181
+ </script>
182
+ ```
183
+
184
+ Ou copie o arquivo direto pro projeto e inclua localmente (`include` no PHP, import estático etc.).
185
+
186
+ ## Arquivos do pacote
187
+
188
+ - `ui-optago.css`, `ui-optago.js`: a lib em si (obrigatórios, sempre os dois juntos)
189
+ - `optago-credit-dark.html`, `optago-credit-light.html`: selo de rodapé, independentes da lib
190
+ - `index.html`: showcase com todos os componentes renderizados e botão "Copiar" pra cada exemplo
191
+ - `README.md`: documentação em prosa para humanos
192
+ - `llms.txt`: este arquivo
package/package.json CHANGED
@@ -1,28 +1,30 @@
1
- {
2
- "name": "ui-optago",
3
- "version": "1.1.1",
4
- "description": "Design System Óptago: componentes UI em CSS puro + JS vanilla, com tema claro/escuro, verde-lima (#C0FF6B) e app shell com sidebar colapsável.",
5
- "author": "Óptago <cowork@optago.com.br> (https://optago.com.br)",
6
- "license": "MIT",
7
- "homepage": "https://optago.com.br",
8
- "keywords": [
9
- "design-system",
10
- "ui",
11
- "css",
12
- "components",
13
- "dark-mode",
14
- "vanilla-js",
15
- "optago"
16
- ],
17
- "main": "ui-optago.js",
18
- "style": "ui-optago.css",
19
- "unpkg": "ui-optago.js",
20
- "jsdelivr": "ui-optago.js",
21
- "files": [
22
- "ui-optago.css",
23
- "ui-optago.js",
24
- "ui-optago.html",
25
- "optago-credit-dark.html",
26
- "optago-credit-light.html"
27
- ]
28
- }
1
+ {
2
+ "name": "ui-optago",
3
+ "version": "1.2.1",
4
+ "description": "Design System Óptago: componentes UI em CSS puro + JS vanilla, com tema claro/escuro, verde-lima (#C0FF6B) e app shell com sidebar colapsável.",
5
+ "author": "Óptago <cowork@optago.com.br> (https://optago.com.br)",
6
+ "license": "MIT",
7
+ "homepage": "https://optago.com.br",
8
+ "keywords": [
9
+ "design-system",
10
+ "ui",
11
+ "css",
12
+ "components",
13
+ "dark-mode",
14
+ "vanilla-js",
15
+ "optago"
16
+ ],
17
+ "main": "ui-optago.js",
18
+ "style": "ui-optago.css",
19
+ "unpkg": "ui-optago.js",
20
+ "jsdelivr": "ui-optago.js",
21
+ "files": [
22
+ "ui-optago.css",
23
+ "ui-optago.js",
24
+ "index.html",
25
+ "favicon.ico",
26
+ "llms.txt",
27
+ "optago-credit-dark.html",
28
+ "optago-credit-light.html"
29
+ ]
30
+ }
package/ui-optago.css CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ============================================================================
2
- UI ÓPTAGO: Design System v1.1.0
2
+ UI ÓPTAGO: Design System v1.2.1
3
3
  CSS puro, sem dependências. Tema escuro por padrão.
4
4
  Para tema claro: adicione a classe "light" ao <html> (o ui-optago.js
5
5
  gerencia isso automaticamente via localStorage).
@@ -78,10 +78,10 @@
78
78
 
79
79
  /* Superfícies: TEMA CLARO */
80
80
  html.light {
81
- --op-bg: #DBE1E8;
82
- --op-panel: #E2E7ED;
83
- --op-panel-2: #D9E0E7;
84
- --op-panel-3: #D1D9E1;
81
+ --op-bg: #DDE3EA;
82
+ --op-panel: #EDF1F5;
83
+ --op-panel-2: #D5DCE4;
84
+ --op-panel-3: #CDD5DE;
85
85
  --op-border: #D6DEE7;
86
86
  --op-border-2: #BDC9D8;
87
87
  --op-text: #334155;
@@ -101,12 +101,14 @@ html.light {
101
101
  color-scheme: light;
102
102
  }
103
103
 
104
- /* Fundo do tema claro: gradiente suave com um toque de verde-lima no topo */
104
+ /* Fundo do tema claro: gradiente suave com um toque de verde-lima no topo.
105
+ Baseado em --op-bg (não em hex fixo) e propositalmente mais escuro que
106
+ --op-panel, pra telas (fundo) não ficarem parecidas com cards (painel). */
105
107
  html.light body {
106
108
  background:
107
109
  radial-gradient(900px 420px at 75% -10%, rgba(192,255,107,.20) 0%, transparent 60%),
108
110
  radial-gradient(700px 380px at 10% 110%, rgba(192,255,107,.10) 0%, transparent 60%),
109
- linear-gradient(180deg, #E7ECF2 0%, #DEE5EC 100%);
111
+ linear-gradient(180deg, var(--op-bg) 0%, color-mix(in srgb, var(--op-bg) 85%, black) 100%);
110
112
  }
111
113
 
112
114
  /* ----------------------------------------------------------------------------
@@ -175,15 +177,36 @@ html.light :focus-visible {
175
177
  outline-color: color-mix(in srgb, var(--op-info) 70%, transparent);
176
178
  }
177
179
 
178
- /* Scrollbar */
179
- ::-webkit-scrollbar { width: 8px; height: 8px; }
180
+ /* Scrollbar própria (Chromium/WebKit: Chrome, Edge, Safari, Opera) - fina,
181
+ trilho invisível, "polegar" em pílula que fica sutil em repouso e assume
182
+ a cor de marca (verde-lima) ao passar o mouse, pra ter identidade própria
183
+ em vez do scrollbar cinza genérico do navegador. `border: transparent` +
184
+ `background-clip: padding-box` (em vez de pintar a borda com --op-bg
185
+ direto) deixa o "respiro" ao redor do polegar de verdade transparente,
186
+ então funciona igual dentro de qualquer container (modal, card, sidebar)
187
+ mesmo quando o fundo por trás não é exatamente --op-bg. */
188
+ ::-webkit-scrollbar { width: 10px; height: 10px; }
180
189
  ::-webkit-scrollbar-track { background: transparent; }
181
190
  ::-webkit-scrollbar-thumb {
182
- background: var(--op-border);
191
+ background: var(--op-border-2);
183
192
  border-radius: 10px;
184
- border: 2px solid var(--op-bg);
193
+ border: 2px solid transparent;
194
+ background-clip: padding-box;
195
+ transition: background-color .15s var(--op-ease);
196
+ }
197
+ ::-webkit-scrollbar-thumb:hover {
198
+ background: color-mix(in srgb, var(--op-accent) 55%, var(--op-muted));
199
+ background-clip: padding-box;
185
200
  }
186
- ::-webkit-scrollbar-thumb:hover { background: var(--op-muted); }
201
+ ::-webkit-scrollbar-corner { background: transparent; }
202
+
203
+ /* Firefox: única customização que o navegador permite (sem raio/hover
204
+ próprios) - ainda assim fica fino e na paleta certa em vez do padrão do
205
+ SO. `*` (não só html/body) porque scrollbar-width/-color NÃO herdam pros
206
+ containers internos com overflow próprio (.op-main, .op-sidebar-nav,
207
+ modais, tabelas com scroll horizontal etc.) do mesmo jeito que o
208
+ ::-webkit-scrollbar acima já cobre globalmente. */
209
+ * { scrollbar-width: thin; scrollbar-color: var(--op-border-2) transparent; }
187
210
 
188
211
  /* Octógono da marca */
189
212
  .op-oct { -webkit-clip-path: var(--op-oct); clip-path: var(--op-oct); }
@@ -207,6 +230,16 @@ html.light :focus-visible {
207
230
  <aside class="op-sidebar" id="opSidebar">...</aside>
208
231
  </body>
209
232
  ---------------------------------------------------------------------------- */
233
+ /* overflow:hidden só em .op-app (= <body>) não basta pra impedir scroll de
234
+ verdade: sem restrição também em <html>, o navegador ainda enxerga o
235
+ tamanho de layout NÃO cortado do documento (scrollWidth/scrollHeight de
236
+ `document.documentElement`) - isso inclui a .op-sidebar mobile fora da
237
+ tela (position:fixed + translateX(100%), que desloca sua caixa pra fora
238
+ do viewport mas ainda soma no tamanho de layout). Resultado: um espaço
239
+ "fantasma" que normalmente fica invisível mas pode ficar alcançável (scroll
240
+ por toque em iOS Safari, roda do mouse em alguns casos, etc), revelando um
241
+ vão em branco abaixo do rodapé com o cabeçalho fora de vista. */
242
+ html { overflow: hidden; overflow: clip; }
210
243
  .op-app {
211
244
  display: flex;
212
245
  height: 100vh;
@@ -221,11 +254,12 @@ html.light :focus-visible {
221
254
  display: flex;
222
255
  flex-direction: column;
223
256
  position: relative;
224
- /* "clip" impede que .op-glow (ou qualquer filho absoluto) vaze para fora e
225
- torne o documento rolável: sem isso, clicar em âncoras rola o viewport
226
- e esconde o header. Nota: overflow no <body> é propagado ao viewport
227
- pelo navegador, então o clip do .op-app sozinho não resolve. */
228
- overflow: clip;
257
+ /* Sem overflow:clip aqui (era o comportamento antigo): isso cortava
258
+ qualquer coisa que vazasse do header/footer, incluindo tooltips
259
+ (data-op-tip) de botões perto da sidebar — a borda direita da
260
+ .op-app-body é exatamente onde a sidebar começa. A contenção do
261
+ .op-glow (pra não tornar o documento rolável) agora é feita dentro
262
+ do .op-main, que é onde o glow realmente é usado. */
229
263
  }
230
264
 
231
265
  /* Header */
@@ -239,11 +273,9 @@ html.light :focus-visible {
239
273
  gap: 1rem;
240
274
  padding: 0 1.25rem;
241
275
  border-bottom: 1px solid var(--op-border);
242
- background: color-mix(in srgb, var(--op-panel) 85%, transparent);
243
- backdrop-filter: blur(12px);
244
- -webkit-backdrop-filter: blur(12px);
276
+ background: var(--op-panel);
245
277
  box-shadow: 0 8px 24px -12px rgba(0,0,0,.5);
246
- z-index: 30;
278
+ z-index: 30; /* precisa ficar abaixo da .op-sidebar (50) no mobile, pra o drawer cobrir o header ao abrir */
247
279
  }
248
280
  /* filete de brilho verde-lima sob o header */
249
281
  .op-header::after {
@@ -286,6 +318,7 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
286
318
  .op-main {
287
319
  flex: 1;
288
320
  overflow-y: auto;
321
+ overflow-x: clip; /* contém .op-glow (evita que vaze e torne a página rolável) */
289
322
  padding: 1.5rem;
290
323
  scroll-behavior: smooth;
291
324
  position: relative;
@@ -293,7 +326,23 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
293
326
  }
294
327
  @media (min-width: 1024px) { .op-main { padding: 1.75rem 2rem; } }
295
328
 
329
+ /* header/footer ficam acima da sidebar por padrão (55 > 50): evita que um
330
+ tooltip (data-op-tip) de um botão do header/footer fique preso no contexto
331
+ de empilhamento do header/footer e acabe renderizado atrás da sidebar,
332
+ mesmo com z-index nominal maior que o dela. Isso valia só a partir de
333
+ 1024px antes, mas o mesmo corte acontecia em qualquer largura abaixo
334
+ disso enquanto a sidebar ainda não é o drawer mobile aberto — por isso
335
+ agora é incondicional. Quando a sidebar VIRA o drawer mobile (.is-open),
336
+ ela sobe pra 60 e volta a cobrir o header normalmente. */
337
+ .op-header, .op-footer { z-index: 55; }
338
+
339
+ /* 1100px é bom pra tela pequena/média (mantém linha de leitura curta), mas
340
+ sobra espaço em branco demais nas laterais em monitor grande. Alarga em
341
+ dois degraus pra telas maiores em vez de deixar fixo ou 100% fluido (que
342
+ deixaria tabelas/formulários exagerados numa tela ultra-wide). */
296
343
  .op-container { max-width: 1100px; margin: 0 auto; }
344
+ @media (min-width: 1440px) { .op-container { max-width: 1320px; } }
345
+ @media (min-width: 1800px) { .op-container { max-width: 1600px; } }
297
346
 
298
347
  /* Footer */
299
348
  .op-footer {
@@ -309,12 +358,18 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
309
358
  font-family: var(--op-font-mono);
310
359
  font-size: 11px;
311
360
  color: var(--op-muted);
312
- z-index: 30;
361
+ z-index: 30; /* mesmo motivo do .op-header */
313
362
  }
314
363
 
315
364
  /* ----------------------------------------------------------------------------
316
365
  4. SIDEBAR (direita, colapsável)
317
366
  ---------------------------------------------------------------------------- */
367
+ /* Suprime a transição de width/transform só durante o carregamento inicial
368
+ da página (classe "op-preload" no <html>, ver ui-optago.js) - o JS só
369
+ consegue aplicar o estado salvo (colapsada ou não) depois que este
370
+ elemento existir no DOM, e sem isso essa aplicação inicial ficaria
371
+ animada como se fosse um toggle manual do usuário. */
372
+ html.op-preload .op-sidebar { transition: none !important; }
318
373
  .op-sidebar {
319
374
  width: var(--op-sidebar-w);
320
375
  flex-shrink: 0;
@@ -455,7 +510,7 @@ html.light .op-nav-item:hover { color: #000000; }
455
510
  transform: translateX(100%);
456
511
  box-shadow: var(--op-shadow-lg);
457
512
  }
458
- .op-sidebar.is-open { transform: translateX(0); }
513
+ .op-sidebar.is-open { transform: translateX(0); z-index: 60; }
459
514
  .op-sidebar.is-collapsed { width: var(--op-sidebar-w); } /* colapso só no desktop */
460
515
  .op-sidebar.is-collapsed .op-nav-text,
461
516
  .op-sidebar.is-collapsed .op-sidebar-label,
@@ -526,7 +581,10 @@ html.light .op-nav-item:hover { color: #000000; }
526
581
  .op-btn-secondary:hover { background: #767676; border-color: #767676; }
527
582
 
528
583
  /* Ghost (fundo suave) */
529
- .op-btn-ghost { background: transparent; color: var(--op-text); }
584
+ /* Sempre com um contorno sutil (--op-border-2) - sem cor de fundo nenhuma,
585
+ um .op-btn-ghost fica praticamente invisível sobre fundos claros/neutros,
586
+ sem nenhuma affordance de que é clicável até passar o mouse. */
587
+ .op-btn-ghost { background: transparent; color: var(--op-text); border-color: var(--op-border-2); }
530
588
  .op-btn-ghost:hover { background: color-mix(in srgb, var(--op-strong) 7%, transparent); color: var(--op-strong); }
531
589
 
532
590
  .op-btn-ghost-info { background: color-mix(in srgb, var(--op-info) 12%, transparent); color: color-mix(in srgb, var(--op-info) 70%, var(--op-strong)); }
@@ -644,25 +702,28 @@ html.light .op-badge-cyan { color: #0E7490; }
644
702
  }
645
703
  .op-alert-close:hover { opacity: 1; }
646
704
 
647
- .op-alert-info { background: color-mix(in srgb, var(--op-info) 16%, transparent); border-color: color-mix(in srgb, var(--op-info) 35%, transparent); }
705
+ .op-alert-info { background: color-mix(in srgb, var(--op-info) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-info) 45%, transparent); }
648
706
  .op-alert-info > i, .op-alert-info .op-alert-title { color: color-mix(in srgb, var(--op-info) 65%, var(--op-strong)); }
649
- .op-alert-success { background: color-mix(in srgb, var(--op-success) 16%, transparent); border-color: color-mix(in srgb, var(--op-success) 35%, transparent); }
707
+ .op-alert-success { background: color-mix(in srgb, var(--op-success) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-success) 45%, transparent); }
650
708
  .op-alert-success > i, .op-alert-success .op-alert-title { color: color-mix(in srgb, var(--op-success) 65%, var(--op-strong)); }
651
- .op-alert-warning { background: color-mix(in srgb, var(--op-warning) 16%, transparent); border-color: color-mix(in srgb, var(--op-warning) 35%, transparent); }
709
+ .op-alert-warning { background: color-mix(in srgb, var(--op-warning) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-warning) 45%, transparent); }
652
710
  .op-alert-warning > i, .op-alert-warning .op-alert-title { color: color-mix(in srgb, var(--op-warning) 65%, var(--op-strong)); }
653
- .op-alert-danger { background: color-mix(in srgb, var(--op-danger) 16%, transparent); border-color: color-mix(in srgb, var(--op-danger) 35%, transparent); }
711
+ .op-alert-danger { background: color-mix(in srgb, var(--op-danger) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-danger) 45%, transparent); }
654
712
  .op-alert-danger > i, .op-alert-danger .op-alert-title { color: color-mix(in srgb, var(--op-danger) 65%, var(--op-strong)); }
655
713
 
656
- /* Modo claro: fundo mais saturado e texto/ícone numa variante mais escura
657
- da cor semântica (em vez do tom vivo, que perde contraste em fundo claro). */
658
- html.light .op-alert-info { background: color-mix(in srgb, var(--op-info) 22%, transparent); border-color: color-mix(in srgb, var(--op-info) 45%, transparent); }
659
- html.light .op-alert-info > i, html.light .op-alert-info .op-alert-title { color: color-mix(in srgb, var(--op-info) 70%, black); }
660
- html.light .op-alert-success { background: color-mix(in srgb, var(--op-success) 22%, transparent); border-color: color-mix(in srgb, var(--op-success) 45%, transparent); }
661
- html.light .op-alert-success > i, html.light .op-alert-success .op-alert-title { color: color-mix(in srgb, var(--op-success) 70%, black); }
662
- html.light .op-alert-warning { background: color-mix(in srgb, var(--op-warning) 22%, transparent); border-color: color-mix(in srgb, var(--op-warning) 45%, transparent); }
663
- html.light .op-alert-warning > i, html.light .op-alert-warning .op-alert-title { color: color-mix(in srgb, var(--op-warning) 70%, black); }
664
- html.light .op-alert-danger { background: color-mix(in srgb, var(--op-danger) 22%, transparent); border-color: color-mix(in srgb, var(--op-danger) 45%, transparent); }
665
- html.light .op-alert-danger > i, html.light .op-alert-danger .op-alert-title { color: color-mix(in srgb, var(--op-danger) 70%, black); }
714
+ /* Modo claro: fundo mais saturado e opaco (misturado com --op-panel-2 em vez de
715
+ transparent, senão a cor de fundo da página vaza e o alerta fica "aguado") e
716
+ texto/ícone numa variante mais escura da cor semântica (em vez do tom vivo,
717
+ que perde contraste em fundo claro). Pedido explícito de cor mais forte no
718
+ claro (2026-08-14): percentuais aumentados de 34/55/70% pra 46/68/78%. */
719
+ html.light .op-alert-info { background: color-mix(in srgb, var(--op-info) 46%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-info) 68%, transparent); }
720
+ html.light .op-alert-info > i, html.light .op-alert-info .op-alert-title { color: color-mix(in srgb, var(--op-info) 78%, black); }
721
+ html.light .op-alert-success { background: color-mix(in srgb, var(--op-success) 46%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-success) 68%, transparent); }
722
+ html.light .op-alert-success > i, html.light .op-alert-success .op-alert-title { color: color-mix(in srgb, var(--op-success) 78%, black); }
723
+ html.light .op-alert-warning { background: color-mix(in srgb, var(--op-warning) 46%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-warning) 68%, transparent); }
724
+ html.light .op-alert-warning > i, html.light .op-alert-warning .op-alert-title { color: color-mix(in srgb, var(--op-warning) 78%, black); }
725
+ html.light .op-alert-danger { background: color-mix(in srgb, var(--op-danger) 46%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-danger) 68%, transparent); }
726
+ html.light .op-alert-danger > i, html.light .op-alert-danger .op-alert-title { color: color-mix(in srgb, var(--op-danger) 78%, black); }
666
727
 
667
728
  /* ----------------------------------------------------------------------------
668
729
  8. FORMULÁRIOS
@@ -1312,7 +1373,12 @@ html.light .op-spinner-dots span { background: var(--op-primary); }
1312
1373
  z-index: 80;
1313
1374
  opacity: 0;
1314
1375
  visibility: hidden;
1315
- transform: translateY(-6px) scale(.98);
1376
+ /* --op-menu-shift: correção horizontal calculada em JS (ui-optago.js,
1377
+ toggle de .op-dropdown-toggle) quando o menu abriria vazando pra fora
1378
+ da tela perto de qualquer borda - soma ao transform de abertura/
1379
+ fechamento em vez de substituí-lo, então a animação continua intacta. */
1380
+ --op-menu-shift: 0px;
1381
+ transform: translateY(-6px) scale(.98) translateX(var(--op-menu-shift));
1316
1382
  transform-origin: top left;
1317
1383
  transition: all .2s var(--op-spring);
1318
1384
  }
@@ -1320,7 +1386,7 @@ html.light .op-spinner-dots span { background: var(--op-primary); }
1320
1386
  .op-dropdown.is-open .op-menu {
1321
1387
  opacity: 1;
1322
1388
  visibility: visible;
1323
- transform: translateY(0) scale(1);
1389
+ transform: translateY(0) scale(1) translateX(var(--op-menu-shift));
1324
1390
  }
1325
1391
  .op-menu-item {
1326
1392
  display: flex;
@@ -1374,7 +1440,17 @@ html.light .op-spinner-dots span { background: var(--op-primary); }
1374
1440
  font-weight: 700;
1375
1441
  padding: .375rem .75rem;
1376
1442
  border-radius: var(--op-radius-sm);
1377
- white-space: nowrap;
1443
+ /* width:max-content (em vez de auto) é o que faz o balão medir o texto
1444
+ de verdade antes de decidir se quebra linha - sem isso, o algoritmo de
1445
+ shrink-to-fit padrão do CSS pra width:auto num elemento absolute com
1446
+ left:50%+translate (sem right definido) subestima a largura disponível
1447
+ e quebra QUALQUER texto com mais de uma palavra, mesmo cabendo fácil
1448
+ dentro do max-width. max-width continua sendo o teto real pra textos
1449
+ genuinamente longos. */
1450
+ width: max-content;
1451
+ max-width: min(220px, 90vw);
1452
+ white-space: normal;
1453
+ text-align: center;
1378
1454
  box-shadow: var(--op-shadow);
1379
1455
  opacity: 0;
1380
1456
  visibility: hidden;
@@ -1403,6 +1479,14 @@ html.light .op-spinner-dots span { background: var(--op-primary); }
1403
1479
  transform: translateY(0);
1404
1480
  }
1405
1481
 
1482
+ /* Alinhamento automático perto da borda da tela (classes aplicadas em JS,
1483
+ ui-optago.js, no mouseover de qualquer [data-op-tip] - ver
1484
+ ajustarAlinhamentoTooltip()). Só muda o balão (::after); a setinha
1485
+ (::before) continua centralizada no próprio gatilho, então sempre aponta
1486
+ certo pra ele independente de pra qual lado o balão se estendeu. */
1487
+ [data-op-tip].op-tip-align-start::after { left: 0; translate: 0 0; }
1488
+ [data-op-tip].op-tip-align-end::after { left: auto; right: 0; translate: 0 0; }
1489
+
1406
1490
  /* Variante: tooltip abaixo do elemento (para itens colados no topo da tela) */
1407
1491
  .op-tip-bottom::after {
1408
1492
  bottom: auto;
@@ -1625,6 +1709,19 @@ html.light .op-modal { background: rgba(15,23,42,.5); }
1625
1709
  .op-toast-danger { border-color: color-mix(in srgb, var(--op-danger) 35%, var(--op-border)); }
1626
1710
  .op-toast-danger .op-toast-icon { background: color-mix(in srgb, var(--op-danger) 15%, transparent); color: var(--op-danger); border-color: color-mix(in srgb, var(--op-danger) 30%, transparent); }
1627
1711
 
1712
+ /* Modo claro: o toast usa só borda fina + ícone colorido no tema escuro
1713
+ (funciona bem lá, o fundo escuro já contrasta), mas em fundo claro isso
1714
+ fica "aguado" quase indistinguível de um toast neutro - ganha o mesmo
1715
+ tratamento de fundo saturado que .op-alert já usa (2026-08-14). */
1716
+ html.light .op-toast-info { background: color-mix(in srgb, var(--op-info) 22%, var(--op-panel)); border-color: color-mix(in srgb, var(--op-info) 55%, transparent); }
1717
+ html.light .op-toast-info .op-toast-icon { background: color-mix(in srgb, var(--op-info) 30%, transparent); color: color-mix(in srgb, var(--op-info) 78%, black); border-color: color-mix(in srgb, var(--op-info) 50%, transparent); }
1718
+ html.light .op-toast-success { background: color-mix(in srgb, var(--op-success) 22%, var(--op-panel)); border-color: color-mix(in srgb, var(--op-success) 55%, transparent); }
1719
+ html.light .op-toast-success .op-toast-icon { background: color-mix(in srgb, var(--op-success) 30%, transparent); color: color-mix(in srgb, var(--op-success) 78%, black); border-color: color-mix(in srgb, var(--op-success) 50%, transparent); }
1720
+ html.light .op-toast-warning { background: color-mix(in srgb, var(--op-warning) 24%, var(--op-panel)); border-color: color-mix(in srgb, var(--op-warning) 55%, transparent); }
1721
+ html.light .op-toast-warning .op-toast-icon { background: color-mix(in srgb, var(--op-warning) 32%, transparent); color: color-mix(in srgb, var(--op-warning) 78%, black); border-color: color-mix(in srgb, var(--op-warning) 50%, transparent); }
1722
+ html.light .op-toast-danger { background: color-mix(in srgb, var(--op-danger) 22%, var(--op-panel)); border-color: color-mix(in srgb, var(--op-danger) 55%, transparent); }
1723
+ html.light .op-toast-danger .op-toast-icon { background: color-mix(in srgb, var(--op-danger) 30%, transparent); color: color-mix(in srgb, var(--op-danger) 78%, black); border-color: color-mix(in srgb, var(--op-danger) 50%, transparent); }
1724
+
1628
1725
  /* Barra de progresso: indica quanto falta para o toast fechar sozinho.
1629
1726
  O JS anima a largura via transition (não @keyframes) para poder
1630
1727
  congelar no ponto exato e retomar dali quando o mouse sai. */
@@ -1832,6 +1929,7 @@ html.light .op-glow-strong { opacity: .55; }
1832
1929
  justify-content: center;
1833
1930
  font-size: 2rem;
1834
1931
  margin-bottom: 1rem;
1932
+ animation: op-icon-pop .5s var(--op-spring);
1835
1933
  }
1836
1934
  .op-modal-icon.is-success { background: color-mix(in srgb, var(--op-success) 15%, transparent); color: var(--op-success); }
1837
1935
  .op-modal-icon.is-danger { background: color-mix(in srgb, var(--op-danger) 15%, transparent); color: var(--op-danger); }
@@ -1839,6 +1937,12 @@ html.light .op-glow-strong { opacity: .55; }
1839
1937
  .op-modal-icon.is-brand { background: color-mix(in srgb, var(--op-accent) 14%, transparent); color: var(--op-accent); }
1840
1938
  html.light .op-modal-icon.is-brand { color: #3F6212; }
1841
1939
 
1940
+ @keyframes op-icon-pop {
1941
+ 0% { transform: scale(0) rotate(-20deg); opacity: 0; }
1942
+ 60% { transform: scale(1.15) rotate(4deg); opacity: 1; }
1943
+ 100% { transform: scale(1) rotate(0deg); }
1944
+ }
1945
+
1842
1946
  @keyframes op-drawer-in {
1843
1947
  from { transform: translateX(100%); }
1844
1948
  to { transform: translateX(0); }