ui-optago 1.2.2 → 1.2.4

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.
Files changed (6) hide show
  1. package/README.md +197 -178
  2. package/index.html +1799 -1474
  3. package/llms.txt +18 -7
  4. package/package.json +1 -1
  5. package/ui-optago.css +2453 -2295
  6. package/ui-optago.js +897 -805
package/llms.txt CHANGED
@@ -1,6 +1,6 @@
1
1
  # UI Óptago
2
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`.
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.4`.
4
4
 
5
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
6
 
@@ -9,8 +9,8 @@ Este arquivo é a referência otimizada para agentes de IA/LLMs que forem gerar
9
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
10
 
11
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>
12
+ <link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.4/ui-optago.css">
13
+ <script src="https://unpkg.com/ui-optago@1.2.4/ui-optago.js"></script>
14
14
  ```
15
15
 
16
16
  npm:
@@ -79,7 +79,7 @@ Só `.op-main` rola (scroll interno). Header, footer e sidebar são fixos. `.op-
79
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
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
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` |
82
+ | Layout/utilitários | `op-row` (flex wrap), `op-stack` (flex column), `op-grid-2/3/4` (grid responsivo), `op-mobile-only` (visível SÓ abaixo de 1024px, ex.: hambúrguer que abre o drawer) e `op-desktop-only` (o inverso: some abaixo de 1024px, ex.: badge de versão no header; mesmo corte da sidebar; ambas com `!important`), `op-text-muted`/`op-text-accent`/`op-text-mono`/`op-text-sm`/`op-text-xs`, `op-mt-1..4`/`op-mb-1..4` |
83
83
 
84
84
  ## Combobox (input com busca)
85
85
 
@@ -118,7 +118,7 @@ Abre no foco do input, filtra as opções pelo texto digitado (case-insensitive)
118
118
  | `data-op-loading-message="texto"` | Mensagem customizada pro `data-op-loading-form` (padrão: "Carregando...") |
119
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
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 |
121
+ | `data-op-version` | Elemento cujo texto é substituído pela versão da lib (ex.: `v1.2.4`) no carregamento |
122
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
123
 
124
124
  ## API JavaScript (`window.OptagoUI`)
@@ -130,6 +130,8 @@ OptagoUI.openModal('#idDoModal');
130
130
  OptagoUI.closeModal('#idDoModal');
131
131
  OptagoUI.setTheme('light'); // 'dark' | 'light', também persiste em localStorage
132
132
  OptagoUI.toggleTheme();
133
+ OptagoUI.customize({ accent: '#FF6B00', radius: '6px' }); // sobrescreve tokens (--op-*) em runtime;
134
+ // chave sem prefixo vira --op-<chave>, ou passe o nome completo (ex. '--op-accent')
133
135
  OptagoUI.toggleSidebar(); // desktop: colapsa/expande; mobile: chama toggleSidebarMobile()
134
136
  OptagoUI.toggleSidebarMobile();
135
137
  OptagoUI.closeSidebarMobile();
@@ -137,7 +139,16 @@ OptagoUI.showLoading('Salvando...'); // mostra overlay de carregamento f
137
139
  OptagoUI.hideLoading();
138
140
  OptagoUI.copyHTML('#seletor', botaoOpcional); // usado internamente por data-op-copy
139
141
  OptagoUI.toggleCode('#seletor', botao); // usado internamente por data-op-code
140
- OptagoUI.version; // string, ex. "1.2.0"
142
+ OptagoUI.version; // string, ex. "1.2.4"
143
+
144
+ // Tour guiado: carrega driver.js via CDN sob demanda, já com tema Óptago aplicado
145
+ // Cada step: { element: '#seletor', popover: { title: 'Título', description: 'Texto' } }
146
+ // Step sem `element` vira modal genérico centralizado.
147
+ // Qualquer opção nativa do driver.js é aceita no segundo argumento (options).
148
+ OptagoUI.tour([
149
+ { element: '#meu-el', popover: { title: 'Passo 1', description: 'Explicação.' } },
150
+ { popover: { title: 'Fim', description: 'Tour concluído.' } }
151
+ ]).then(instanciaDriver => { /* ... */ });
141
152
 
142
153
  // Tabela avançada: carrega Tabulator via CDN sob demanda, já com tema Óptago aplicado
143
154
  OptagoUI.tabulator('#minhaTabela', {
@@ -175,7 +186,7 @@ Para rodapé de QUALQUER site da Óptago, mesmo sites que não usam o resto da l
175
186
  ```html
176
187
  <div id="optago-credit"></div>
177
188
  <script>
178
- fetch('https://unpkg.com/ui-optago@1.2.0/optago-credit-dark.html')
189
+ fetch('https://unpkg.com/ui-optago@1.2.4/optago-credit-dark.html')
179
190
  .then(r => r.text())
180
191
  .then(html => document.getElementById('optago-credit').innerHTML = html);
181
192
  </script>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ui-optago",
3
- "version": "1.2.2",
3
+ "version": "1.2.4",
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",