ui-optago 1.1.0 → 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
@@ -1,33 +1,21 @@
1
1
  <!--
2
- Selo "Desenvolvido por Óptago": versão escura
2
+ Selo "Desenvolvido por Óptago" — versão escura
3
3
  ===============================================
4
- Fonte canônica: pacote npm "ui-optago". Bloco padrão para colar em
5
- QUALQUER site desenvolvido pela Óptago com fundo escuro (ou sem
6
- tema definido). Autocontido: o <style> e o HTML abaixo não
7
- dependem de nenhuma variável, classe ou fonte já carregada pelo
8
- site hospedeiro.
4
+ Bloco padrão para colar em QUALQUER site desenvolvido pela Óptago
5
+ com fundo escuro (ou sem tema definido). Autocontido: o <style> e
6
+ o HTML abaixo não dependem de nenhuma variável, classe ou fonte já
7
+ carregada pelo site hospedeiro — só copiar e colar este arquivo
8
+ inteiro (ex. no rodapé) e funciona, independente da paleta do site.
9
9
 
10
10
  Existe também a versão clara: optago-credit-light.html. Escolha
11
11
  a que combina com o fundo onde o selo vai ficar.
12
12
 
13
- Uso via CDN (funciona em qualquer stack, sem precisar copiar nada):
14
- <div id="optago-credit"></div>
15
- <script>
16
- fetch('https://unpkg.com/ui-optago/optago-credit-dark.html')
17
- .then(r => r.text())
18
- .then(html => document.getElementById('optago-credit').innerHTML = html);
19
- </script>
20
- Em produção, fixe a versão para não sofrer quebras em atualizações:
21
- https://unpkg.com/ui-optago@1.1.0/optago-credit-dark.html
22
- Também funciona via jsDelivr:
23
- https://cdn.jsdelivr.net/npm/ui-optago/optago-credit-dark.html
24
-
25
- Uso local (CodeIgniter/PHP): copie o arquivo pro projeto e dê
26
- include no caminho local (sem tags PHP aqui dentro; este arquivo
27
- é incluído por outros, então nunca deve conter
28
- "menor-que interrogação php", ou ele se auto-inclui em loop). Em
29
- qualquer outro stack (HTML puro, WordPress, etc.), cole o conteúdo
30
- deste arquivo direto no template.
13
+ Uso em CodeIgniter/PHP: include APPPATH seguido de
14
+ "Views/partials/optago-credit-dark.html" (sem tags PHP aqui dentro
15
+ — este arquivo é incluído por outros, então nunca deve conter
16
+ "menor-que interrogação php", ou ele se auto-inclui em loop).
17
+ Em qualquer outro stack (HTML puro, WordPress, etc.), cole o
18
+ conteúdo deste arquivo direto no template.
31
19
  -->
32
20
  <style>
33
21
  @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@500;700&display=swap');
@@ -1,32 +1,21 @@
1
1
  <!--
2
- Selo "Desenvolvido por Óptago": versão clara
2
+ Selo "Desenvolvido por Óptago" — versão clara
3
3
  ==============================================
4
- Fonte canônica: pacote npm "ui-optago". Bloco padrão para colar em
5
- QUALQUER site desenvolvido pela Óptago com fundo claro. Autocontido:
6
- o <style> e o HTML abaixo não dependem de nenhuma variável, classe
7
- ou fonte já carregada pelo site hospedeiro.
4
+ Bloco padrão para colar em QUALQUER site desenvolvido pela Óptago
5
+ com fundo claro. Autocontido: o <style> e o HTML abaixo não
6
+ dependem de nenhuma variável, classe ou fonte já carregada pelo
7
+ site hospedeiro — só copiar e colar este arquivo inteiro (ex. no
8
+ rodapé) e funciona, independente da paleta do site.
8
9
 
9
10
  Existe também a versão escura: optago-credit-dark.html. Escolha
10
11
  a que combina com o fundo onde o selo vai ficar.
11
12
 
12
- Uso via CDN (funciona em qualquer stack, sem precisar copiar nada):
13
- <div id="optago-credit"></div>
14
- <script>
15
- fetch('https://unpkg.com/ui-optago/optago-credit-light.html')
16
- .then(r => r.text())
17
- .then(html => document.getElementById('optago-credit').innerHTML = html);
18
- </script>
19
- Em produção, fixe a versão para não sofrer quebras em atualizações:
20
- https://unpkg.com/ui-optago@1.1.0/optago-credit-light.html
21
- Também funciona via jsDelivr:
22
- https://cdn.jsdelivr.net/npm/ui-optago/optago-credit-light.html
23
-
24
- Uso local (CodeIgniter/PHP): copie o arquivo pro projeto e dê
25
- include no caminho local (sem tags PHP aqui dentro; este arquivo
26
- é incluído por outros, então nunca deve conter
27
- "menor-que interrogação php", ou ele se auto-inclui em loop). Em
28
- qualquer outro stack (HTML puro, WordPress, etc.), cole o conteúdo
29
- deste arquivo direto no template.
13
+ Uso em CodeIgniter/PHP: include APPPATH seguido de
14
+ "Views/partials/optago-credit-light.html" (sem tags PHP aqui
15
+ dentro — este arquivo é incluído por outros, então nunca deve
16
+ conter "menor-que interrogação php", ou ele se auto-inclui em
17
+ loop). Em qualquer outro stack (HTML puro, WordPress, etc.), cole
18
+ o conteúdo deste arquivo direto no template.
30
19
  -->
31
20
  <style>
32
21
  @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@500;700&display=swap');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ui-optago",
3
- "version": "1.1.0",
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: #E3E9F0;
82
- --op-panel: #EEF1F5;
83
- --op-panel-2: #E6EAF0;
84
- --op-panel-3: #DEE3EA;
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
  /* ----------------------------------------------------------------------------
@@ -717,6 +731,25 @@ html.light .op-input:focus, html.light .op-select:focus, html.light .op-textarea
717
731
  cursor: pointer;
718
732
  }
719
733
 
734
+ /* Tamanhos: o padrão acima (sem modificador) é o tamanho normal.
735
+ op-input-xs < op-input-sm < (normal) < op-input-lg */
736
+ .op-input-xs, .op-select-xs, .op-textarea-xs {
737
+ padding: .3125rem .625rem;
738
+ font-size: .75rem;
739
+ border-radius: 6px;
740
+ }
741
+ .op-select-xs { padding-right: 1.875rem; background-position: right .625rem center; background-size: 10px; }
742
+ .op-input-sm, .op-select-sm, .op-textarea-sm {
743
+ padding: .5rem .75rem;
744
+ font-size: .8125rem;
745
+ }
746
+ .op-select-sm { padding-right: 2.125rem; background-position: right .75rem center; }
747
+ .op-input-lg, .op-select-lg, .op-textarea-lg {
748
+ padding: .875rem 1.125rem;
749
+ font-size: 1rem;
750
+ }
751
+ .op-select-lg { padding-right: 2.75rem; background-position: right 1rem center; background-size: 14px; }
752
+
720
753
  /* Estados de validação */
721
754
  .op-input.is-error, .op-select.is-error, .op-textarea.is-error {
722
755
  border-color: var(--op-danger);
@@ -882,6 +915,71 @@ html.light .op-switch input:checked::before { background: #fff; }
882
915
  html.light .op-range::-webkit-slider-thumb { background: var(--op-primary); }
883
916
  .op-range::-webkit-slider-thumb:hover { transform: scale(1.2); }
884
917
 
918
+ /* Combobox: input de texto que filtra uma lista de opções (autocomplete).
919
+ Uso: <div class="op-combobox" data-op-combobox>
920
+ <input class="op-input" data-op-combobox-input ...>
921
+ <div class="op-combobox-menu" data-op-combobox-menu>
922
+ <button class="op-combobox-option" data-op-combobox-option data-value="br">Brasil</button>
923
+ ...
924
+ <div class="op-combobox-empty" hidden>Nenhum resultado</div>
925
+ </div>
926
+ </div>
927
+ O JS filtra as opções ao digitar, abre no foco, navega com as setas e
928
+ fecha com ESC/clique fora (mesmo padrão do .op-dropdown). */
929
+ .op-combobox { position: relative; }
930
+ .op-combobox-menu {
931
+ position: absolute;
932
+ top: calc(100% + 8px);
933
+ left: 0;
934
+ right: 0;
935
+ max-height: 260px;
936
+ overflow-y: auto;
937
+ background: var(--op-panel);
938
+ border: 1px solid var(--op-border-2);
939
+ border-radius: var(--op-radius);
940
+ box-shadow: var(--op-shadow-lg);
941
+ padding: .375rem;
942
+ z-index: 80;
943
+ opacity: 0;
944
+ visibility: hidden;
945
+ transform: translateY(-6px) scale(.98);
946
+ transform-origin: top;
947
+ transition: all .2s var(--op-spring);
948
+ }
949
+ .op-combobox.is-open .op-combobox-menu {
950
+ opacity: 1;
951
+ visibility: visible;
952
+ transform: translateY(0) scale(1);
953
+ }
954
+ .op-combobox-option {
955
+ display: flex;
956
+ align-items: center;
957
+ width: 100%;
958
+ padding: .5625rem .75rem;
959
+ background: none;
960
+ border: 0;
961
+ border-radius: var(--op-radius-sm);
962
+ color: var(--op-text);
963
+ font-family: var(--op-font-sans);
964
+ font-size: .8125rem;
965
+ text-align: left;
966
+ cursor: pointer;
967
+ transition: background .15s, color .15s;
968
+ }
969
+ .op-combobox-option:hover,
970
+ .op-combobox-option.is-active {
971
+ background: color-mix(in srgb, var(--op-strong) 6%, transparent);
972
+ color: var(--op-strong);
973
+ }
974
+ .op-combobox-option.is-selected { color: var(--op-accent); font-weight: 700; }
975
+ html.light .op-combobox-option.is-selected { color: #3F6212; }
976
+ .op-combobox-option[hidden] { display: none; }
977
+ .op-combobox-empty {
978
+ padding: .625rem .75rem;
979
+ color: var(--op-muted);
980
+ font-size: .8125rem;
981
+ }
982
+
885
983
  /* ----------------------------------------------------------------------------
886
984
  9. TABELAS
887
985
  ---------------------------------------------------------------------------- */
@@ -1290,7 +1388,9 @@ html.light .op-spinner-dots span { background: var(--op-primary); }
1290
1388
  font-weight: 700;
1291
1389
  padding: .375rem .75rem;
1292
1390
  border-radius: var(--op-radius-sm);
1293
- white-space: nowrap;
1391
+ max-width: min(220px, 90vw);
1392
+ white-space: normal;
1393
+ text-align: center;
1294
1394
  box-shadow: var(--op-shadow);
1295
1395
  opacity: 0;
1296
1396
  visibility: hidden;
@@ -1748,6 +1848,7 @@ html.light .op-glow-strong { opacity: .55; }
1748
1848
  justify-content: center;
1749
1849
  font-size: 2rem;
1750
1850
  margin-bottom: 1rem;
1851
+ animation: op-icon-pop .5s var(--op-spring);
1751
1852
  }
1752
1853
  .op-modal-icon.is-success { background: color-mix(in srgb, var(--op-success) 15%, transparent); color: var(--op-success); }
1753
1854
  .op-modal-icon.is-danger { background: color-mix(in srgb, var(--op-danger) 15%, transparent); color: var(--op-danger); }
@@ -1755,6 +1856,12 @@ html.light .op-glow-strong { opacity: .55; }
1755
1856
  .op-modal-icon.is-brand { background: color-mix(in srgb, var(--op-accent) 14%, transparent); color: var(--op-accent); }
1756
1857
  html.light .op-modal-icon.is-brand { color: #3F6212; }
1757
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
+
1758
1865
  @keyframes op-drawer-in {
1759
1866
  from { transform: translateX(100%); }
1760
1867
  to { transform: translateX(0); }
@@ -1866,6 +1973,34 @@ html.light .op-modal-icon.is-brand { color: #3F6212; }
1866
1973
  }
1867
1974
  .op-timeline-text { font-size: .8125rem; color: var(--op-muted); margin: 0; line-height: 1.6; }
1868
1975
 
1976
+ /* Timeline horizontal: adicione .op-timeline-horizontal junto com .op-timeline
1977
+ no mesmo <ul>. Os itens viram colunas, com o marcador acima do texto. */
1978
+ .op-timeline.op-timeline-horizontal {
1979
+ display: flex;
1980
+ list-style: none;
1981
+ margin: 0;
1982
+ padding: 0;
1983
+ gap: 1.5rem;
1984
+ overflow-x: auto;
1985
+ }
1986
+ .op-timeline.op-timeline-horizontal::before {
1987
+ left: 0;
1988
+ right: 0;
1989
+ top: 7px;
1990
+ bottom: auto;
1991
+ height: 2px;
1992
+ width: auto;
1993
+ }
1994
+ .op-timeline-horizontal .op-timeline-item {
1995
+ flex: 1;
1996
+ min-width: 170px;
1997
+ padding-bottom: 0;
1998
+ padding-top: 2rem;
1999
+ text-align: center;
2000
+ }
2001
+ .op-timeline-horizontal .op-timeline-marker { left: 50%; top: 0; translate: -50% 0; }
2002
+ .op-timeline-horizontal .op-timeline-title { justify-content: center; }
2003
+
1869
2004
  /* ----------------------------------------------------------------------------
1870
2005
  20g. TABULATOR: tema Óptago
1871
2006
  Aplicado quando a tabela é criada via OptagoUI.tabulator() (o JS injeta o