ui-optago 1.2.1 → 1.2.3

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/README.md CHANGED
@@ -65,7 +65,7 @@ Bloco pronto para o rodapé de qualquer site feito pela Óptago, mesmo sites que
65
65
  </script>
66
66
  ```
67
67
 
68
- Fixe a versão em produção: `https://unpkg.com/ui-optago@1.2.1/optago-credit-dark.html` (troque `dark` por `light` conforme o caso). Também funciona via jsDelivr: `https://cdn.jsdelivr.net/npm/ui-optago/optago-credit-dark.html`.
68
+ Fixe a versão em produção: `https://unpkg.com/ui-optago@1.2.3/optago-credit-dark.html` (troque `dark` por `light` conforme o caso). Também funciona via jsDelivr: `https://cdn.jsdelivr.net/npm/ui-optago/optago-credit-dark.html`.
69
69
 
70
70
  **Ou copie o arquivo direto** para o seu projeto e sirva/inclua localmente (ex. `include` no PHP, import estático, etc.); cada arquivo já vem com essas instruções comentadas no topo.
71
71
 
@@ -134,6 +134,14 @@ OptagoUI.openModal('#meuModal');
134
134
  OptagoUI.closeModal('#meuModal');
135
135
  OptagoUI.setTheme('light'); // 'dark' | 'light'
136
136
  OptagoUI.toggleSidebar();
137
+ OptagoUI.customize({ accent: '#FF6B00', radius: '6px' }); // sobrescreve tokens (--op-*) em runtime
138
+
139
+ // Tour guiado (carrega driver.js do CDN sob demanda, já com tema Óptago)
140
+ OptagoUI.tour([
141
+ { element: '#meu-elemento', popover: { title: 'Passo 1', description: 'Texto explicativo.' } },
142
+ { element: '#outro', popover: { title: 'Passo 2', description: 'Continue aqui.' } },
143
+ { popover: { title: 'Pronto!', description: 'Tour concluído.' } } // sem element = modal central
144
+ ]).then(d => { /* instância driver.js, opcional */ });
137
145
 
138
146
  // Tabela avançada (carrega o Tabulator do CDN sob demanda, já com tema Óptago)
139
147
  OptagoUI.tabulator('#minhaTabela', {
@@ -161,6 +169,16 @@ Personalize sobrescrevendo as variáveis no seu próprio CSS:
161
169
  }
162
170
  ```
163
171
 
172
+ Ou em runtime via JS (ex.: cor por tenant/cliente vinda de uma API), sem precisar de `<style>` próprio:
173
+
174
+ ```js
175
+ OptagoUI.customize({ accent: '#FF6B00', cyan: '#00B8D9', radius: '6px' });
176
+ // nomes curtos viram --op-*, mas o nome completo também funciona:
177
+ OptagoUI.customize({ '--op-accent': '#FF6B00' });
178
+ ```
179
+
180
+ Lista completa de tokens e exemplos ao vivo: seção **Customizando** do [showcase](index.html#customizando).
181
+
164
182
  Tema claro = classe `light` no `<html>` (gerenciada automaticamente pelo JS).
165
183
 
166
184
  ### Tema compartilhado entre subdomínios
package/index.html CHANGED
@@ -122,8 +122,8 @@
122
122
  <div class="op-demo-preview">
123
123
  <p class="op-alert-title">Usar via CDN</p>
124
124
  <p class="op-alert-text op-mb-1">Sem baixar nada, adicione as duas linhas ao <code>&lt;head&gt;</code>:</p>
125
- <pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;">&lt;link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.1/ui-optago.css"&gt;
126
- &lt;script src="https://unpkg.com/ui-optago@1.2.1/ui-optago.js"&gt;&lt;/script&gt;</pre>
125
+ <pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;">&lt;link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.3/ui-optago.css"&gt;
126
+ &lt;script src="https://unpkg.com/ui-optago@1.2.3/ui-optago.js"&gt;&lt;/script&gt;</pre>
127
127
  </div>
128
128
  </div>
129
129
  </section>
@@ -1133,7 +1133,298 @@ OptagoUI.tabulator('#minhaTabela', {
1133
1133
  </div>
1134
1134
  </section>
1135
1135
 
1136
- <!-- ==================== 20. SELO "DESENVOLVIDO POR ÓPTAGO" ==================== -->
1136
+ <!-- ==================== 20. CUSTOMIZANDO ==================== -->
1137
+ <section id="customizando" class="op-mb-4" style="scroll-margin-top:1rem;">
1138
+ <div class="op-section-head">
1139
+ <i class="ph ph-sliders"></i>
1140
+ <h2>Customizando</h2>
1141
+ </div>
1142
+ <p class="op-text-muted op-mb-2">
1143
+ Toda a aparência (cores, raio de borda, sombras, fontes, dimensões do app shell...) vive em
1144
+ variáveis CSS (tokens) declaradas no <code>:root</code> de <code>ui-optago.css</code>. Não
1145
+ precisa editar o arquivo da lib: sobrescreva só as variáveis que quiser, depois de carregá-la.
1146
+ </p>
1147
+
1148
+ <div class="op-grid-2 op-mb-2">
1149
+ <div class="op-card">
1150
+ <h3 class="op-mb-1" style="font-size:.9375rem;"><i class="ph ph-code"></i> Via CSS</h3>
1151
+ <p class="op-text-muted op-text-sm op-mb-1">Fixo, definido no seu CSS. Ideal pra marca própria de um sistema inteiro.</p>
1152
+ <pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;">&lt;style&gt;
1153
+ :root {
1154
+ --op-accent: #FF6B00;
1155
+ --op-cyan: #00B8D9;
1156
+ --op-radius: 6px;
1157
+ }
1158
+ &lt;/style&gt;</pre>
1159
+ </div>
1160
+ <div class="op-card">
1161
+ <h3 class="op-mb-1" style="font-size:.9375rem;"><i class="ph ph-lightning"></i> Via JS (runtime)</h3>
1162
+ <p class="op-text-muted op-text-sm op-mb-1"><code>OptagoUI.customize()</code>: dinâmico, ex. cor por tenant/cliente vinda de uma API.</p>
1163
+ <pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;">OptagoUI.customize({
1164
+ accent: '#FF6B00', // vira --op-accent
1165
+ cyan: '#00B8D9',
1166
+ '--op-radius': '6px' // nome completo também funciona
1167
+ });</pre>
1168
+ </div>
1169
+ </div>
1170
+
1171
+ <div class="op-demo">
1172
+ <div class="op-demo-preview" style="display:flex; flex-wrap:wrap; align-items:flex-end; gap:1.5rem;">
1173
+ <div class="op-field" style="margin:0;">
1174
+ <label class="op-label" for="custom-accent">Verde-lima (--op-accent)</label>
1175
+ <input type="color" id="custom-accent" value="#C0FF6B" style="width:64px; height:36px; padding:2px; border:1px solid var(--op-border); border-radius:var(--op-radius-sm); background:none; cursor:pointer;">
1176
+ </div>
1177
+ <div class="op-field" style="margin:0;">
1178
+ <label class="op-label" for="custom-cyan">Ciano (--op-cyan)</label>
1179
+ <input type="color" id="custom-cyan" value="#6BE0FF" style="width:64px; height:36px; padding:2px; border:1px solid var(--op-border); border-radius:var(--op-radius-sm); background:none; cursor:pointer;">
1180
+ </div>
1181
+ <div class="op-field" style="margin:0; min-width:180px;">
1182
+ <label class="op-label" for="custom-radius">Raio (--op-radius)</label>
1183
+ <input class="op-range" type="range" id="custom-radius" min="0" max="24" value="12">
1184
+ </div>
1185
+ <button class="op-btn op-btn-ghost op-btn-sm" id="custom-reset"><i class="ph ph-arrow-counter-clockwise"></i> Restaurar</button>
1186
+ </div>
1187
+ <div class="op-demo-bar">
1188
+ <span class="op-text-muted op-text-xs"><i class="ph ph-cursor-click"></i> Ao vivo: repare nos botões primários da página inteira ao mudar as cores acima.</span>
1189
+ </div>
1190
+ </div>
1191
+ <script>
1192
+ (function () {
1193
+ var accent = document.getElementById('custom-accent');
1194
+ var cyan = document.getElementById('custom-cyan');
1195
+ var radius = document.getElementById('custom-radius');
1196
+ var reset = document.getElementById('custom-reset');
1197
+ accent.addEventListener('input', function () { OptagoUI.customize({ accent: accent.value, 'accent-hover': accent.value }); });
1198
+ cyan.addEventListener('input', function () { OptagoUI.customize({ cyan: cyan.value }); });
1199
+ radius.addEventListener('input', function () { OptagoUI.customize({ radius: radius.value + 'px' }); });
1200
+ reset.addEventListener('click', function () {
1201
+ ['--op-accent', '--op-accent-hover', '--op-cyan', '--op-radius'].forEach(function (p) {
1202
+ document.documentElement.style.removeProperty(p);
1203
+ });
1204
+ accent.value = '#C0FF6B'; cyan.value = '#6BE0FF'; radius.value = 12;
1205
+ });
1206
+ })();
1207
+ </script>
1208
+
1209
+ <h3 class="op-mt-3 op-mb-1" style="font-size:1rem;">Principais tokens</h3>
1210
+ <div class="op-table-wrap">
1211
+ <table class="op-table op-table-hover op-mb-2">
1212
+ <thead><tr><th>Variável</th><th>Padrão (escuro)</th><th>O que muda</th></tr></thead>
1213
+ <tbody>
1214
+ <tr><td><code>--op-accent</code></td><td>#C0FF6B</td><td>Cor de marca: botão primário, foco, glow</td></tr>
1215
+ <tr><td><code>--op-cyan</code></td><td>#6BE0FF</td><td>Cor secundária: detalhes, badges cyan</td></tr>
1216
+ <tr><td><code>--op-info / -success / -warning / -danger</code></td><td>azul / verde / laranja / vermelho</td><td>Cores semânticas (badges, alerts, toasts)</td></tr>
1217
+ <tr><td><code>--op-bg / -panel / -panel-2 / -panel-3</code></td><td>tons de preto</td><td>Superfícies: fundo da página, cards, sidebar</td></tr>
1218
+ <tr><td><code>--op-text / -strong / -muted</code></td><td>tons de cinza</td><td>Texto padrão, texto em destaque, texto apagado</td></tr>
1219
+ <tr><td><code>--op-radius-sm / -radius / -radius-lg</code></td><td>8px / 12px / 16px</td><td>Arredondamento de botões, cards, inputs...</td></tr>
1220
+ <tr><td><code>--op-font-display / -sans / -mono</code></td><td>Chakra Petch / Inter / JetBrains Mono</td><td>Títulos, texto corrido, dados técnicos</td></tr>
1221
+ <tr><td><code>--op-header-h / -footer-h / -sidebar-w</code></td><td>56px / 42px / 260px</td><td>Dimensões do app shell</td></tr>
1222
+ </tbody>
1223
+ </table>
1224
+ </div>
1225
+ <p class="op-text-muted op-text-xs" style="margin:0;">
1226
+ Lista completa: seção <strong>1. TOKENS</strong> no topo de <code>ui-optago.css</code>. O tema
1227
+ claro redefine boa parte desses tokens dentro de <code>html.light { ... }</code> — pra
1228
+ customizar só o modo claro (ou só o escuro), sobrescreva dentro do seletor correspondente.
1229
+ </p>
1230
+ </section>
1231
+
1232
+ <!-- ==================== 21. TOUR GUIADO ==================== -->
1233
+ <section id="tour" class="op-mb-4" style="scroll-margin-top:1rem;">
1234
+ <div class="op-section-head">
1235
+ <i class="ph ph-signpost"></i>
1236
+ <h2>Tour Guiado</h2>
1237
+ </div>
1238
+
1239
+ <p style="color:var(--op-muted); margin-bottom:1.5rem; max-width:640px;">
1240
+ Integração com <strong style="color:var(--op-text);">driver.js</strong> via
1241
+ <code>OptagoUI.tour(steps, options?)</code>. A biblioteca é carregada do CDN
1242
+ sob demanda (só quando o tour for iniciado) e o popover já sai estilizado com o
1243
+ tema Óptago — escuro e claro, sem nenhuma configuração extra.
1244
+ </p>
1245
+
1246
+ <!-- Demo ao vivo -->
1247
+ <div class="op-card" style="margin-bottom:1.5rem; padding:1.25rem;">
1248
+ <div style="display:flex; align-items:center; gap:.75rem; flex-wrap:wrap;">
1249
+ <button id="btn-tour-demo" class="op-btn op-btn-primary" onclick="iniciarTourDemo()">
1250
+ <i class="ph ph-play"></i> Iniciar tour de exemplo
1251
+ </button>
1252
+ <span style="color:var(--op-muted); font-size:.875rem;">
1253
+ Percorre as principais seções desta documentação.
1254
+ </span>
1255
+ </div>
1256
+ </div>
1257
+
1258
+ <!-- Como usar -->
1259
+ <div class="op-grid-2" style="gap:1rem; margin-bottom:1.5rem;">
1260
+ <div class="op-card" style="padding:1.25rem;">
1261
+ <h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">
1262
+ <i class="ph ph-code" style="color:var(--op-accent);"></i> Uso básico
1263
+ </h3>
1264
+ <pre style="background:var(--op-panel-3); border-radius:var(--op-radius-sm); padding:1rem; font-size:.8125rem; overflow-x:auto; margin:0;"><code>OptagoUI.tour([
1265
+ {
1266
+ element: '#meu-elemento',
1267
+ popover: {
1268
+ title: 'Bem-vindo!',
1269
+ description: 'Este é o ponto de partida.',
1270
+ }
1271
+ },
1272
+ {
1273
+ element: '#outro-elemento',
1274
+ popover: {
1275
+ title: 'Passo 2',
1276
+ description: 'Continue por aqui.',
1277
+ }
1278
+ },
1279
+ // step sem element = modal centralizado
1280
+ {
1281
+ popover: {
1282
+ title: 'Pronto!',
1283
+ description: 'Tour concluído com sucesso.',
1284
+ }
1285
+ }
1286
+ ]).then(function(d) {
1287
+ // d = instância driver.js (opcional)
1288
+ });</code></pre>
1289
+ </div>
1290
+ <div class="op-card" style="padding:1.25rem;">
1291
+ <h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">
1292
+ <i class="ph ph-sliders" style="color:var(--op-accent);"></i> Opções
1293
+ </h3>
1294
+ <pre style="background:var(--op-panel-3); border-radius:var(--op-radius-sm); padding:1rem; font-size:.8125rem; overflow-x:auto; margin:0;"><code>OptagoUI.tour(steps, {
1295
+ // Padrões já configurados pelo OptagoUI:
1296
+ animate: true,
1297
+ smoothScroll: true,
1298
+ showProgress: true,
1299
+ progressText: '{{current}} de {{total}}',
1300
+ nextBtnText: 'Próximo →',
1301
+ prevBtnText: '← Anterior',
1302
+ doneBtnText: 'Concluir',
1303
+
1304
+ // Qualquer opção nativa do driver.js:
1305
+ allowClose: true, // fecha com ESC/clique no overlay
1306
+ onDestroyed: function() {
1307
+ console.log('tour encerrado');
1308
+ }
1309
+ });</code></pre>
1310
+ <p style="font-size:.8125rem; color:var(--op-muted); margin-top:.75rem; margin-bottom:0;">
1311
+ Todas as opções nativas do
1312
+ <a href="https://driverjs.com/docs/configuration" target="_blank" rel="noopener" style="color:var(--op-accent);">driver.js</a>
1313
+ são aceitas e passadas diretamente à instância.
1314
+ </p>
1315
+ </div>
1316
+ </div>
1317
+
1318
+ <!-- Tabela de referência dos steps -->
1319
+ <h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">Estrutura de um step</h3>
1320
+ <div style="overflow-x:auto; margin-bottom:1.5rem;">
1321
+ <table class="op-table op-table-hover" style="font-size:.875rem;">
1322
+ <thead>
1323
+ <tr><th>Propriedade</th><th>Tipo</th><th>Descrição</th></tr>
1324
+ </thead>
1325
+ <tbody>
1326
+ <tr><td><code>element</code></td><td>string</td><td>Seletor CSS do elemento a destacar (omita para um modal genérico centralizado)</td></tr>
1327
+ <tr><td><code>popover.title</code></td><td>string</td><td>Título do popover (aceita HTML)</td></tr>
1328
+ <tr><td><code>popover.description</code></td><td>string</td><td>Corpo do popover (aceita HTML)</td></tr>
1329
+ <tr><td><code>popover.side</code></td><td>string</td><td>Lado de abertura: <code>top</code> <code>bottom</code> <code>left</code> <code>right</code> (padrão: automático)</td></tr>
1330
+ <tr><td><code>popover.align</code></td><td>string</td><td>Alinhamento: <code>start</code> <code>center</code> <code>end</code></td></tr>
1331
+ <tr><td><code>onHighlightStarted</code></td><td>function</td><td>Callback antes de destacar o elemento</td></tr>
1332
+ <tr><td><code>onHighlighted</code></td><td>function</td><td>Callback após destacar o elemento</td></tr>
1333
+ <tr><td><code>onDeselected</code></td><td>function</td><td>Callback ao sair do step</td></tr>
1334
+ </tbody>
1335
+ </table>
1336
+ </div>
1337
+
1338
+ <!-- Destaque simples de um elemento -->
1339
+ <h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">Destaque avulso (sem tour)</h3>
1340
+ <p style="color:var(--op-muted); font-size:.875rem; margin-bottom:.75rem;">
1341
+ Para destacar um único elemento sem navegar por steps, passe um array de um único step.
1342
+ O driver.js também expõe <code>highlight()</code> nativamente se você precisar da instância.
1343
+ </p>
1344
+ <pre style="background:var(--op-panel-3); border-radius:var(--op-radius-sm); padding:1rem; font-size:.8125rem; overflow-x:auto; margin-bottom:1.5rem;"><code>OptagoUI.tour([
1345
+ {
1346
+ element: '#meu-campo',
1347
+ popover: { title: 'Atenção', description: 'Preencha este campo.' }
1348
+ }
1349
+ ]);</code></pre>
1350
+ </section>
1351
+
1352
+ <script>
1353
+ function iniciarTourDemo() {
1354
+ OptagoUI.tour([
1355
+ {
1356
+ popover: {
1357
+ title: '<i class="ph ph-hand-waving"></i> Bem-vindo à UI Óptago!',
1358
+ description: 'Este tour percorre os principais componentes do design system. Use os botões abaixo para navegar.'
1359
+ }
1360
+ },
1361
+ {
1362
+ element: '#botoes',
1363
+ popover: {
1364
+ title: '<i class="ph ph-cursor-click"></i> Botões',
1365
+ description: 'Variações de estilo, tamanho e estado — incluindo <code>is-loading</code> para ações assíncronas.',
1366
+ side: 'top'
1367
+ }
1368
+ },
1369
+ {
1370
+ element: '#formularios',
1371
+ popover: {
1372
+ title: '<i class="ph ph-text-aa"></i> Formulários',
1373
+ description: 'Inputs, selects, switches, ranges e estados de validação (<code>is-error</code>, <code>is-success</code>).',
1374
+ side: 'top'
1375
+ }
1376
+ },
1377
+ {
1378
+ element: '#alertas',
1379
+ popover: {
1380
+ title: '<i class="ph ph-warning"></i> Alertas',
1381
+ description: 'Quatro variantes semânticas (info, success, warning, danger) com fundo sólido em ambos os temas.',
1382
+ side: 'top'
1383
+ }
1384
+ },
1385
+ {
1386
+ element: '#toasts',
1387
+ popover: {
1388
+ title: '<i class="ph ph-bell-ringing"></i> Toasts',
1389
+ description: 'Notificações temporárias disparadas via <code>OptagoUI.toast(msg, tipo)</code>.',
1390
+ side: 'top'
1391
+ }
1392
+ },
1393
+ {
1394
+ element: '#modais',
1395
+ popover: {
1396
+ title: '<i class="ph ph-square-half"></i> Modais',
1397
+ description: 'Diálogos com tamanhos (sm/lg), drawer lateral e animação de entrada/saída.',
1398
+ side: 'top'
1399
+ }
1400
+ },
1401
+ {
1402
+ element: '#customizando',
1403
+ popover: {
1404
+ title: '<i class="ph ph-sliders"></i> Customizando',
1405
+ description: 'Sobreponha qualquer token com <code>OptagoUI.customize()</code> — ideal para cor por sistema ou tenant vinda de uma API.',
1406
+ side: 'top'
1407
+ }
1408
+ },
1409
+ {
1410
+ element: '#tour',
1411
+ popover: {
1412
+ title: '<i class="ph ph-signpost"></i> Tour Guiado',
1413
+ description: 'É aqui que você está! <code>OptagoUI.tour(steps)</code> carrega o driver.js sob demanda e já aplica o tema Óptago.',
1414
+ side: 'top'
1415
+ }
1416
+ },
1417
+ {
1418
+ popover: {
1419
+ title: '<i class="ph ph-check-circle"></i> Tour concluído!',
1420
+ description: 'Esses são os componentes principais. Explore o restante da documentação à vontade.'
1421
+ }
1422
+ }
1423
+ ]);
1424
+ }
1425
+ </script>
1426
+
1427
+ <!-- ==================== 22. SELO "DESENVOLVIDO POR ÓPTAGO" ==================== -->
1137
1428
  <section id="creditos" class="op-mb-4" style="scroll-margin-top:1rem; position:relative;">
1138
1429
  <!-- Perto do fim da página, lado direito, cor info pra variar
1139
1430
  (mesmo padrão de cor secundária já usado no rodapé do topo). -->
@@ -1167,7 +1458,7 @@ OptagoUI.tabulator('#minhaTabela', {
1167
1458
  <pre class="op-demo-code is-visible" id="d-creditos" style="margin-top:.75rem; border:1px solid var(--op-border); border-radius:var(--op-radius-sm);">&lt;!-- Via CDN, sem copiar nada: --&gt;
1168
1459
  &lt;div id="optago-credit"&gt;&lt;/div&gt;
1169
1460
  &lt;script&gt;
1170
- fetch('https://unpkg.com/ui-optago@1.2.1/optago-credit-dark.html')
1461
+ fetch('https://unpkg.com/ui-optago@1.2.3/optago-credit-dark.html')
1171
1462
  .then(r =&gt; r.text())
1172
1463
  .then(html =&gt; document.getElementById('optago-credit').innerHTML = html);
1173
1464
  &lt;/script&gt;
@@ -1189,7 +1480,7 @@ OptagoUI.tabulator('#minhaTabela', {
1189
1480
  </script>
1190
1481
  </section>
1191
1482
 
1192
- <!-- ==================== 21. SOBRE A ÓPTAGO ==================== -->
1483
+ <!-- ==================== 22. SOBRE A ÓPTAGO ==================== -->
1193
1484
  <section id="sobre" class="op-mb-4" style="scroll-margin-top:1rem;">
1194
1485
  <div class="op-section-head">
1195
1486
  <i class="ph ph-buildings"></i>
@@ -1280,6 +1571,8 @@ OptagoUI.tabulator('#minhaTabela', {
1280
1571
  <a class="op-nav-item" href="#carregamento"><i class="ph ph-circle-notch"></i><span class="op-nav-text">Carregamento</span><span class="op-nav-tooltip">Carregamento</span></a>
1281
1572
  <a class="op-nav-item" href="#modais"><i class="ph ph-app-window"></i><span class="op-nav-text">Modais</span><span class="op-nav-tooltip">Modais</span></a>
1282
1573
  <a class="op-nav-item" href="#layout"><i class="ph ph-layout"></i><span class="op-nav-text">Layout</span><span class="op-nav-tooltip">Layout</span></a>
1574
+ <a class="op-nav-item" href="#customizando"><i class="ph ph-sliders"></i><span class="op-nav-text">Customizando</span><span class="op-nav-tooltip">Customizando</span></a>
1575
+ <a class="op-nav-item" href="#tour"><i class="ph ph-signpost"></i><span class="op-nav-text">Tour Guiado</span><span class="op-nav-tooltip">Tour Guiado</span></a>
1283
1576
  <a class="op-nav-item" href="#creditos"><i class="ph ph-seal-check"></i><span class="op-nav-text">Créditos</span><span class="op-nav-tooltip">Créditos</span></a>
1284
1577
  <a class="op-nav-item" href="#sobre"><i class="ph ph-buildings"></i><span class="op-nav-text">Sobre</span><span class="op-nav-tooltip">Sobre</span></a>
1285
1578
  </nav>
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.3`.
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.3/ui-optago.css">
13
+ <script src="https://unpkg.com/ui-optago@1.2.3/ui-optago.js"></script>
14
14
  ```
15
15
 
16
16
  npm:
@@ -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.3`) 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.3"
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.3/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.1",
3
+ "version": "1.2.3",
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",
package/ui-optago.css CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ============================================================================
2
- UI ÓPTAGO: Design System v1.2.1
2
+ UI ÓPTAGO: Design System v1.2.3
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).
@@ -420,7 +420,13 @@ html.op-preload .op-sidebar { transition: none !important; }
420
420
  align-items: center;
421
421
  gap: .75rem;
422
422
  padding: .625rem .75rem;
423
- border: 1px solid transparent;
423
+ /* Borda sutil sempre visível (não só transparent até o hover) - mesma
424
+ lógica do ajuste do .op-btn-ghost: sem contorno nenhum em repouso, o
425
+ item fica sem nenhuma affordance de que é clicável antes de passar o
426
+ mouse. Mesma --op-border-2 usada no :hover (--op-border sozinha ficou
427
+ fraca demais em repouso); a diferença de :hover continua vindo do
428
+ background com tingimento, não da borda. */
429
+ border: 1px solid var(--op-border-2);
424
430
  border-radius: var(--op-radius);
425
431
  color: var(--op-text);
426
432
  text-decoration: none;
@@ -507,11 +513,12 @@ html.light .op-nav-item:hover { color: #000000; }
507
513
  .op-sidebar {
508
514
  position: fixed;
509
515
  top: 0; right: 0; bottom: 0;
516
+ width: 100%; /* drawer ocupa a tela toda no mobile, mais fácil de tocar */
510
517
  transform: translateX(100%);
511
518
  box-shadow: var(--op-shadow-lg);
512
519
  }
513
520
  .op-sidebar.is-open { transform: translateX(0); z-index: 60; }
514
- .op-sidebar.is-collapsed { width: var(--op-sidebar-w); } /* colapso só no desktop */
521
+ .op-sidebar.is-collapsed { width: 100%; } /* colapso (só ícones) é coisa de desktop */
515
522
  .op-sidebar.is-collapsed .op-nav-text,
516
523
  .op-sidebar.is-collapsed .op-sidebar-label,
517
524
  .op-sidebar.is-collapsed .op-sidebar-header-text { display: block; }
@@ -728,7 +735,17 @@ html.light .op-alert-danger > i, html.light .op-alert-danger .op-alert-title {
728
735
  /* ----------------------------------------------------------------------------
729
736
  8. FORMULÁRIOS
730
737
  ---------------------------------------------------------------------------- */
731
- .op-field { display: flex; flex-direction: column; gap: .375rem; }
738
+ .op-field { display: flex; flex-direction: column; gap: .375rem; margin-bottom: 1rem; }
739
+ .op-field:last-child { margin-bottom: 0; }
740
+ /* Dentro de containers que já controlam o espaçamento entre filhos via gap
741
+ (grid/stack/row), o margin-bottom do field somaria ao gap e dobraria o
742
+ espaço — zera aqui pra quem usa esses containers não precisar lutar contra
743
+ a margem. Fora deles (fields soltos, um embaixo do outro), o margin-bottom
744
+ é o que evita o label do próximo field colar no input do anterior. */
745
+ .op-row > .op-field, .op-stack > .op-field,
746
+ .op-grid-2 > .op-field, .op-grid-3 > .op-field, .op-grid-4 > .op-field {
747
+ margin-bottom: 0;
748
+ }
732
749
 
733
750
  .op-label {
734
751
  font-family: var(--op-font-mono);
@@ -2281,6 +2298,88 @@ html.light .op-text-accent { color: #3F6212; }
2281
2298
  to { opacity: 0; transform: scale(.95) translateY(12px); }
2282
2299
  }
2283
2300
 
2301
+ /* ----------------------------------------------------------------------------
2302
+ Tour Guiado (driver.js) — sobreposição de tema Óptago
2303
+ A classe .op-tour-popover é passada em popoverClass para o driver.
2304
+ Usa .driver-popover.op-tour-popover (dupla classe) para vencer os estilos
2305
+ base do driver.js quando ambos têm a mesma posição na cascata.
2306
+ Os tokens CSS já mudam automaticamente com html.light — sem precisar de
2307
+ seletores separados por tema para cor de texto/fundo/borda.
2308
+ ---------------------------------------------------------------------------- */
2309
+ .driver-popover.op-tour-popover {
2310
+ background: var(--op-panel-2);
2311
+ border: 1px solid var(--op-border-2);
2312
+ border-radius: var(--op-radius);
2313
+ color: var(--op-text);
2314
+ font-family: var(--op-font-sans), system-ui, sans-serif;
2315
+ box-shadow: var(--op-shadow-lg);
2316
+ padding: 1.25rem 1.25rem 1rem;
2317
+ max-width: 340px;
2318
+ min-width: 240px;
2319
+ }
2320
+ .driver-popover.op-tour-popover .driver-popover-title {
2321
+ font-family: var(--op-font-display), system-ui, sans-serif;
2322
+ font-size: 1rem;
2323
+ font-weight: 600;
2324
+ color: var(--op-strong);
2325
+ margin-bottom: .375rem;
2326
+ }
2327
+ .driver-popover.op-tour-popover .driver-popover-description {
2328
+ font-size: .875rem;
2329
+ line-height: 1.55;
2330
+ color: var(--op-muted);
2331
+ }
2332
+ .driver-popover.op-tour-popover .driver-popover-progress-text {
2333
+ font-size: .75rem;
2334
+ color: var(--op-muted);
2335
+ }
2336
+ .driver-popover.op-tour-popover .driver-popover-navigation-btns {
2337
+ gap: .5rem;
2338
+ }
2339
+ .driver-popover.op-tour-popover .driver-popover-prev-btn,
2340
+ .driver-popover.op-tour-popover .driver-popover-next-btn,
2341
+ .driver-popover.op-tour-popover .driver-popover-close-btn {
2342
+ background: transparent;
2343
+ border: 1px solid var(--op-border-2);
2344
+ border-radius: var(--op-radius-sm);
2345
+ color: var(--op-text);
2346
+ font-family: var(--op-font-sans), system-ui, sans-serif;
2347
+ font-size: .8125rem;
2348
+ font-weight: 500;
2349
+ padding: .3125rem .75rem;
2350
+ cursor: pointer;
2351
+ text-shadow: none;
2352
+ transition: background .15s, color .15s, border-color .15s;
2353
+ }
2354
+ .driver-popover.op-tour-popover .driver-popover-prev-btn:hover,
2355
+ .driver-popover.op-tour-popover .driver-popover-close-btn:hover {
2356
+ background: var(--op-panel-3);
2357
+ border-color: var(--op-border-2);
2358
+ color: var(--op-text);
2359
+ }
2360
+ .driver-popover.op-tour-popover .driver-popover-next-btn {
2361
+ background: var(--op-accent);
2362
+ border-color: var(--op-accent);
2363
+ color: var(--op-accent-ink);
2364
+ text-shadow: none;
2365
+ }
2366
+ .driver-popover.op-tour-popover .driver-popover-next-btn:hover {
2367
+ background: var(--op-accent-hover);
2368
+ border-color: var(--op-accent-hover);
2369
+ color: var(--op-accent-ink);
2370
+ }
2371
+ /* setas do popover */
2372
+ .driver-popover.op-tour-popover .driver-popover-arrow-side-left { border-right-color: var(--op-border-2); }
2373
+ .driver-popover.op-tour-popover .driver-popover-arrow-side-right { border-left-color: var(--op-border-2); }
2374
+ .driver-popover.op-tour-popover .driver-popover-arrow-side-top { border-bottom-color: var(--op-panel-2); }
2375
+ .driver-popover.op-tour-popover .driver-popover-arrow-side-bottom { border-top-color: var(--op-panel-2); }
2376
+
2377
+ /* elemento destacado: outline na cor de acento */
2378
+ .driver-active-element {
2379
+ outline: 2px solid var(--op-accent) !important;
2380
+ outline-offset: 2px !important;
2381
+ }
2382
+
2284
2383
  @media (prefers-reduced-motion: reduce) {
2285
2384
  *, *::before, *::after {
2286
2385
  animation-duration: .01ms !important;
package/ui-optago.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ============================================================================
2
- UI ÓPTAGO: Design System v1.2.1 (JavaScript)
2
+ UI ÓPTAGO: Design System v1.2.3 (JavaScript)
3
3
  Sem dependências de build. Carregue no <head> SEM defer para evitar
4
4
  flash de tema errado (FOUC):
5
5
 
@@ -51,9 +51,15 @@
51
51
 
52
52
  // Fonte única da versão exibida no badge do header e no rodapé
53
53
  // (elementos com o atributo data-op-version). Atualize só aqui.
54
- var VERSION = '1.2.1';
54
+ var VERSION = '1.2.3';
55
55
  OptagoUI.version = VERSION;
56
56
 
57
+ console.log(
58
+ '%c Óptago UI %c v' + VERSION + ' ',
59
+ 'background:#0a0a0a;color:#C0FF6B;font-weight:700;padding:3px 8px;border-radius:4px 0 0 4px;font-family:"JetBrains Mono",monospace;font-size:12px;',
60
+ 'background:#C0FF6B;color:#0a0a0a;font-weight:700;padding:3px 8px;border-radius:0 4px 4px 0;font-family:"JetBrains Mono",monospace;font-size:12px;'
61
+ );
62
+
57
63
  /* --------------------------------------------------------------------------
58
64
  1. TEMA: aplicado imediatamente (antes do primeiro paint)
59
65
  -------------------------------------------------------------------------- */
@@ -99,6 +105,17 @@
99
105
  OptagoUI.setTheme(document.documentElement.classList.contains('light') ? 'dark' : 'light');
100
106
  };
101
107
 
108
+ // Sobrescreve tokens (--op-*) em runtime, ex.: OptagoUI.customize({ accent: '#FF6B00' })
109
+ // ou OptagoUI.customize({ '--op-radius': '4px' }) com o nome completo da variável.
110
+ // Útil pra marca por sistema/tenant sem precisar de um <style> próprio.
111
+ OptagoUI.customize = function (tokens) {
112
+ var root = document.documentElement.style;
113
+ Object.keys(tokens || {}).forEach(function (name) {
114
+ var prop = name.indexOf('--') === 0 ? name : '--op-' + name;
115
+ root.setProperty(prop, tokens[name]);
116
+ });
117
+ };
118
+
102
119
  // Aplica já, sem esperar o DOM (evita FOUC)
103
120
  document.documentElement.classList.toggle('light', currentTheme() === 'light');
104
121
 
@@ -330,7 +347,61 @@
330
347
  };
331
348
 
332
349
  /* --------------------------------------------------------------------------
333
- 5c. TELA DE CARREGAMENTO: overlay em tela cheia
350
+ 5c. TOUR GUIADO (driver.js)
351
+ Carrega a biblioteca do CDN sob demanda e aplica o tema Óptago.
352
+ Uso: OptagoUI.tour(steps, options?) → Promise<instância driver>
353
+
354
+ Cada step: { element: '#seletor', popover: { title: 'Título', description: 'Texto' } }
355
+ O step sem `element` vira um modal genérico centralizado.
356
+ -------------------------------------------------------------------------- */
357
+ var DRIVER_CSS = 'https://cdn.jsdelivr.net/npm/driver.js/dist/driver.css';
358
+ var DRIVER_ESM = 'https://esm.run/driver.js';
359
+
360
+ OptagoUI.tour = function (steps, options) {
361
+ if (!document.getElementById('op-driver-css')) {
362
+ var css = document.createElement('link');
363
+ css.id = 'op-driver-css';
364
+ css.rel = 'stylesheet';
365
+ css.href = DRIVER_CSS;
366
+ // Inserido ANTES do ui-optago.css para que nosso CSS venha depois na
367
+ // cascata e vença os estilos base do driver.js com a mesma especificidade.
368
+ var ownCss = document.querySelector('link[href*="ui-optago.css"]');
369
+ if (ownCss && ownCss.parentNode) {
370
+ ownCss.parentNode.insertBefore(css, ownCss);
371
+ } else {
372
+ document.head.prepend(css);
373
+ }
374
+ }
375
+
376
+ return import(DRIVER_ESM).then(function (mod) {
377
+ var driverFn = mod.driver || mod.default;
378
+ var isLight = document.documentElement.classList.contains('light');
379
+ var defaults = {
380
+ animate: true,
381
+ smoothScroll: true,
382
+ showProgress: true,
383
+ progressText: '{{current}} de {{total}}',
384
+ nextBtnText: 'Próximo →',
385
+ prevBtnText: '← Anterior',
386
+ doneBtnText: 'Concluir',
387
+ popoverClass: 'op-tour-popover',
388
+ overlayColor: isLight ? '#0F172A' : '#000000',
389
+ overlayOpacity: isLight ? 0.5 : 0.75
390
+ };
391
+ var merged = {};
392
+ Object.keys(defaults).forEach(function (k) { merged[k] = defaults[k]; });
393
+ Object.keys(options || {}).forEach(function (k) { merged[k] = options[k]; });
394
+ merged.steps = steps;
395
+ var d = driverFn(merged);
396
+ d.drive();
397
+ return d;
398
+ }).catch(function (err) {
399
+ throw new Error('driver.js: falha ao carregar via CDN. ' + (err && err.message || ''));
400
+ });
401
+ };
402
+
403
+ /* --------------------------------------------------------------------------
404
+ 5d. TELA DE CARREGAMENTO: overlay em tela cheia
334
405
  Uso: OptagoUI.showLoading('Salvando...') ... OptagoUI.hideLoading()
335
406
  ou data-op-loading-form no <form> para acionar sozinho no submit.
336
407
  -------------------------------------------------------------------------- */
@@ -454,13 +525,26 @@
454
525
  if (!menu) return;
455
526
 
456
527
  menu.style.removeProperty('--op-menu-shift');
457
- var rect = menu.getBoundingClientRect();
458
- // margem folgada (não só 8px) porque a medição acontece durante a
459
- // transição de abertura (scale(.98) -> scale(1)) - o retângulo final
460
- // real pode ficar uns px maior que o medido aqui.
528
+
529
+ // offsetLeft/offsetWidth são medidas de LAYOUT puras, nunca afetadas
530
+ // por transform - ao contrário de menu.getBoundingClientRect(), que
531
+ // reflete o transform da animação de abrir/fechar (scale/translateY/
532
+ // translateX) em tempo real. Numa 2ª+ abertura, uma transição CSS ainda
533
+ // ativa tem prioridade de cascata sobre QUALQUER valor (mesmo inline),
534
+ // então nem forçar transform:none temporariamente adianta: o
535
+ // getBoundingClientRect() continuava capturando o --op-menu-shift
536
+ // residual da abertura anterior, cortando o menu. Medindo via
537
+ // offsetLeft/offsetWidth (relativos ao .op-dropdown, que não anima)
538
+ // a conta fica sempre exata, em qualquer abertura, sem precisar tocar
539
+ // em transition nem em transform e sem atrapalhar a animação de
540
+ // entrada.
541
+ var ddRect = dd.getBoundingClientRect();
542
+ var left = ddRect.left + menu.offsetLeft;
543
+ var right = left + menu.offsetWidth;
544
+
461
545
  var margem = 12;
462
- var vazaDireita = rect.right - (window.innerWidth - margem);
463
- var vazaEsquerda = margem - rect.left;
546
+ var vazaDireita = right - (window.innerWidth - margem);
547
+ var vazaEsquerda = margem - left;
464
548
 
465
549
  if (vazaDireita > 0) {
466
550
  menu.style.setProperty('--op-menu-shift', (-vazaDireita) + 'px');