ui-optago 1.1.1 → 1.2.0

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,6 +1,6 @@
1
1
  {
2
2
  "name": "ui-optago",
3
- "version": "1.1.1",
3
+ "version": "1.2.0",
4
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
5
  "author": "Óptago <cowork@optago.com.br> (https://optago.com.br)",
6
6
  "license": "MIT",
@@ -21,7 +21,9 @@
21
21
  "files": [
22
22
  "ui-optago.css",
23
23
  "ui-optago.js",
24
- "ui-optago.html",
24
+ "index.html",
25
+ "favicon.ico",
26
+ "llms.txt",
25
27
  "optago-credit-dark.html",
26
28
  "optago-credit-light.html"
27
29
  ]
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.0
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
  /* ----------------------------------------------------------------------------
@@ -221,11 +223,12 @@ html.light :focus-visible {
221
223
  display: flex;
222
224
  flex-direction: column;
223
225
  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;
226
+ /* Sem overflow:clip aqui (era o comportamento antigo): isso cortava
227
+ qualquer coisa que vazasse do header/footer, incluindo tooltips
228
+ (data-op-tip) de botões perto da sidebar — a borda direita da
229
+ .op-app-body é exatamente onde a sidebar começa. A contenção do
230
+ .op-glow (pra não tornar o documento rolável) agora é feita dentro
231
+ do .op-main, que é onde o glow realmente é usado. */
229
232
  }
230
233
 
231
234
  /* Header */
@@ -239,11 +242,9 @@ html.light :focus-visible {
239
242
  gap: 1rem;
240
243
  padding: 0 1.25rem;
241
244
  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);
245
+ background: var(--op-panel);
245
246
  box-shadow: 0 8px 24px -12px rgba(0,0,0,.5);
246
- z-index: 30;
247
+ z-index: 30; /* precisa ficar abaixo da .op-sidebar (50) no mobile, pra o drawer cobrir o header ao abrir */
247
248
  }
248
249
  /* filete de brilho verde-lima sob o header */
249
250
  .op-header::after {
@@ -286,6 +287,7 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
286
287
  .op-main {
287
288
  flex: 1;
288
289
  overflow-y: auto;
290
+ overflow-x: clip; /* contém .op-glow (evita que vaze e torne a página rolável) */
289
291
  padding: 1.5rem;
290
292
  scroll-behavior: smooth;
291
293
  position: relative;
@@ -293,6 +295,16 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
293
295
  }
294
296
  @media (min-width: 1024px) { .op-main { padding: 1.75rem 2rem; } }
295
297
 
298
+ /* header/footer ficam acima da sidebar por padrão (55 > 50): evita que um
299
+ tooltip (data-op-tip) de um botão do header/footer fique preso no contexto
300
+ de empilhamento do header/footer e acabe renderizado atrás da sidebar,
301
+ mesmo com z-index nominal maior que o dela. Isso valia só a partir de
302
+ 1024px antes, mas o mesmo corte acontecia em qualquer largura abaixo
303
+ disso enquanto a sidebar ainda não é o drawer mobile aberto — por isso
304
+ agora é incondicional. Quando a sidebar VIRA o drawer mobile (.is-open),
305
+ ela sobe pra 60 e volta a cobrir o header normalmente. */
306
+ .op-header, .op-footer { z-index: 55; }
307
+
296
308
  .op-container { max-width: 1100px; margin: 0 auto; }
297
309
 
298
310
  /* Footer */
@@ -309,7 +321,7 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
309
321
  font-family: var(--op-font-mono);
310
322
  font-size: 11px;
311
323
  color: var(--op-muted);
312
- z-index: 30;
324
+ z-index: 30; /* mesmo motivo do .op-header */
313
325
  }
314
326
 
315
327
  /* ----------------------------------------------------------------------------
@@ -455,7 +467,7 @@ html.light .op-nav-item:hover { color: #000000; }
455
467
  transform: translateX(100%);
456
468
  box-shadow: var(--op-shadow-lg);
457
469
  }
458
- .op-sidebar.is-open { transform: translateX(0); }
470
+ .op-sidebar.is-open { transform: translateX(0); z-index: 60; }
459
471
  .op-sidebar.is-collapsed { width: var(--op-sidebar-w); } /* colapso só no desktop */
460
472
  .op-sidebar.is-collapsed .op-nav-text,
461
473
  .op-sidebar.is-collapsed .op-sidebar-label,
@@ -644,24 +656,26 @@ html.light .op-badge-cyan { color: #0E7490; }
644
656
  }
645
657
  .op-alert-close:hover { opacity: 1; }
646
658
 
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); }
659
+ .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
660
  .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); }
661
+ .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
662
  .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); }
663
+ .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
664
  .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); }
665
+ .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
666
  .op-alert-danger > i, .op-alert-danger .op-alert-title { color: color-mix(in srgb, var(--op-danger) 65%, var(--op-strong)); }
655
667
 
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); }
668
+ /* Modo claro: fundo mais saturado e opaco (misturado com --op-panel-2 em vez de
669
+ transparent, senão a cor de fundo da página vaza e o alerta fica "aguado") e
670
+ texto/ícone numa variante mais escura da cor semântica (em vez do tom vivo,
671
+ que perde contraste em fundo claro). */
672
+ html.light .op-alert-info { background: color-mix(in srgb, var(--op-info) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-info) 55%, transparent); }
659
673
  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); }
674
+ html.light .op-alert-success { background: color-mix(in srgb, var(--op-success) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-success) 55%, transparent); }
661
675
  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); }
676
+ html.light .op-alert-warning { background: color-mix(in srgb, var(--op-warning) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-warning) 55%, transparent); }
663
677
  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); }
678
+ html.light .op-alert-danger { background: color-mix(in srgb, var(--op-danger) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-danger) 55%, transparent); }
665
679
  html.light .op-alert-danger > i, html.light .op-alert-danger .op-alert-title { color: color-mix(in srgb, var(--op-danger) 70%, black); }
666
680
 
667
681
  /* ----------------------------------------------------------------------------
@@ -1374,7 +1388,9 @@ html.light .op-spinner-dots span { background: var(--op-primary); }
1374
1388
  font-weight: 700;
1375
1389
  padding: .375rem .75rem;
1376
1390
  border-radius: var(--op-radius-sm);
1377
- white-space: nowrap;
1391
+ max-width: min(220px, 90vw);
1392
+ white-space: normal;
1393
+ text-align: center;
1378
1394
  box-shadow: var(--op-shadow);
1379
1395
  opacity: 0;
1380
1396
  visibility: hidden;
@@ -1832,6 +1848,7 @@ html.light .op-glow-strong { opacity: .55; }
1832
1848
  justify-content: center;
1833
1849
  font-size: 2rem;
1834
1850
  margin-bottom: 1rem;
1851
+ animation: op-icon-pop .5s var(--op-spring);
1835
1852
  }
1836
1853
  .op-modal-icon.is-success { background: color-mix(in srgb, var(--op-success) 15%, transparent); color: var(--op-success); }
1837
1854
  .op-modal-icon.is-danger { background: color-mix(in srgb, var(--op-danger) 15%, transparent); color: var(--op-danger); }
@@ -1839,6 +1856,12 @@ html.light .op-glow-strong { opacity: .55; }
1839
1856
  .op-modal-icon.is-brand { background: color-mix(in srgb, var(--op-accent) 14%, transparent); color: var(--op-accent); }
1840
1857
  html.light .op-modal-icon.is-brand { color: #3F6212; }
1841
1858
 
1859
+ @keyframes op-icon-pop {
1860
+ 0% { transform: scale(0) rotate(-20deg); opacity: 0; }
1861
+ 60% { transform: scale(1.15) rotate(4deg); opacity: 1; }
1862
+ 100% { transform: scale(1) rotate(0deg); }
1863
+ }
1864
+
1842
1865
  @keyframes op-drawer-in {
1843
1866
  from { transform: translateX(100%); }
1844
1867
  to { transform: translateX(0); }
package/ui-optago.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ============================================================================
2
- UI ÓPTAGO: Design System v1.1.0 (JavaScript)
2
+ UI ÓPTAGO: Design System v1.2.0 (JavaScript)
3
3
  Sem dependências de build. Carregue no <head> SEM defer para evitar
4
4
  flash de tema errado (FOUC):
5
5
 
@@ -31,6 +31,15 @@
31
31
  partir de flash messages do servidor,
32
32
  sem precisar de <script> inline (CSP-safe)
33
33
 
34
+ Tema compartilhado entre subdomínios: adicione data-op-theme-domain no
35
+ próprio <script src="ui-optago.js"> pra o tema virar cookie em vez de só
36
+ localStorage, e todo app sob esse domínio (ex.: app1.seusite.com,
37
+ app2.seusite.com) passa a enxergar a mesma escolha de tema:
38
+
39
+ <script src="ui-optago.js" data-op-theme-domain=".seusite.com"></script>
40
+
41
+ Sem esse atributo, o tema continua só em localStorage (por app, como antes).
42
+
34
43
  API global: OptagoUI.toast(msg, tipo, ms) · OptagoUI.openModal(sel)
35
44
  OptagoUI.closeModal(sel) · OptagoUI.setTheme('dark'|'light')
36
45
  OptagoUI.showLoading(msg) · OptagoUI.hideLoading()
@@ -42,7 +51,7 @@
42
51
 
43
52
  // Fonte única da versão exibida no badge do header e no rodapé
44
53
  // (elementos com o atributo data-op-version). Atualize só aqui.
45
- var VERSION = '1.1.1';
54
+ var VERSION = '1.2.0';
46
55
  OptagoUI.version = VERSION;
47
56
 
48
57
  /* --------------------------------------------------------------------------
@@ -50,8 +59,26 @@
50
59
  -------------------------------------------------------------------------- */
51
60
  var THEME_KEY = 'op-theme';
52
61
 
62
+ // document.currentScript só é confiável em scripts síncronos (sem defer/
63
+ // async), que é exatamente como esta lib precisa ser carregada mesmo.
64
+ var THEME_DOMAIN = (function () {
65
+ var s = document.currentScript;
66
+ return (s && s.getAttribute('data-op-theme-domain')) || null;
67
+ })();
68
+
69
+ function readCookie(name) {
70
+ var m = document.cookie.match(new RegExp('(?:^|; )' + name + '=([^;]*)'));
71
+ return m ? decodeURIComponent(m[1]) : null;
72
+ }
73
+
74
+ function writeCookie(name, value) {
75
+ var attrs = 'path=/; max-age=31536000; SameSite=Lax; domain=' + THEME_DOMAIN;
76
+ if (window.location.protocol === 'https:') attrs += '; Secure';
77
+ document.cookie = name + '=' + encodeURIComponent(value) + '; ' + attrs;
78
+ }
79
+
53
80
  function currentTheme() {
54
- var saved = localStorage.getItem(THEME_KEY);
81
+ var saved = (THEME_DOMAIN && readCookie(THEME_KEY)) || localStorage.getItem(THEME_KEY);
55
82
  if (saved === 'light' || saved === 'dark') return saved;
56
83
  return window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
57
84
  }
@@ -59,6 +86,7 @@
59
86
  OptagoUI.setTheme = function (theme) {
60
87
  document.documentElement.classList.toggle('light', theme === 'light');
61
88
  localStorage.setItem(THEME_KEY, theme);
89
+ if (THEME_DOMAIN) writeCookie(THEME_KEY, theme);
62
90
  document.querySelectorAll('[data-op-theme-toggle]').forEach(function (btn) {
63
91
  var moon = btn.querySelector('.op-icon-moon');
64
92
  var sun = btn.querySelector('.op-icon-sun');