ui-optago 1.2.4 → 2.0.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/CHANGELOG.md ADDED
@@ -0,0 +1,159 @@
1
+ # Changelog
2
+
3
+ Mudanças relevantes para quem usa a biblioteca. As versões seguem o que está publicado no npm.
4
+
5
+ ## 2.0.0
6
+
7
+ Versão maior: o visual muda (Aurora), a biblioteca ganha gráficos com Chart.js, aparência personalizável, tela de abertura, o manual em páginas e seis modelos de tela novos. Veja “Mudanças que podem afetar quem já usa” no fim desta versão. A licença é a MIT (veja abaixo).
8
+
9
+ ### Visual: Aurora
10
+
11
+ - Painéis que ficam no fluxo da página (card, tabela, accordion, header, footer, sidebar) passam a ser translúcidos, sobre um fundo com duas luzes da marca (verde-lima e ciano) que se movem devagar.
12
+ - Cantos mais amplos: `--op-radius-sm`, `--op-radius` e `--op-radius-lg` passam de 8, 12 e 16px para 12, 18 e 24px. Novo token `--op-radius-pill`.
13
+ - Botões, badges, abas e paginação em pílula.
14
+ - Card com hover: sobe e ganha borda em degradê e um clarão no canto. Ícone do card redondo, com degradê.
15
+ - Número do KPI (`op-stat-value`) e barra de progresso padrão em degradê.
16
+ - Abas (`op-tabs`) deixam de ser sublinhadas e viram pílulas suaves.
17
+ - Accordion abre e fecha animando a altura, em CSS puro.
18
+ - Accordion: respiro entre o título e o texto; o item aberto fica com o título na cor de destaque.
19
+ - As cores da marca e as semânticas não mudaram.
20
+
21
+ ### Acessibilidade (meta: WCAG 2.2 AA)
22
+
23
+ - Foco do teclado com cor sólida e contraste de pelo menos 3:1 nos dois temas.
24
+ - Modal: o foco entra no diálogo ao abrir, fica preso dentro dele e volta para quem abriu ao fechar. A lib completa `role="dialog"`, `aria-modal` e `aria-labelledby`.
25
+ - Abas: papéis `tablist`, `tab` e `tabpanel`, `aria-selected`, e navegação por setas, Home e End.
26
+ - Dropdown: `aria-expanded` no gatilho, setas entre os itens, ESC devolve o foco ao gatilho.
27
+ - Combobox: padrão ARIA completo (`combobox`, `listbox`, `option`, `aria-activedescendant`).
28
+ - Sidebar: os itens mantêm o nome quando ela está recolhida; o drawer fechado no celular sai da ordem do Tab; o item ativo recebe `aria-current`; os botões de abrir e recolher informam `aria-expanded`.
29
+ - Tooltips (`data-op-tip` e os da sidebar) aparecem também com o foco do teclado, e ESC os esconde.
30
+ - Toasts: região nomeada; erro usa `role="alert"` e os demais, `role="status"`.
31
+ - Botões da lib que só têm ícone recebem um nome acessível quando o autor não definiu um; ícones ficam ocultos do leitor de tela.
32
+ - Contraste: `--op-muted` ficou mais legível nos dois temas; botões sólidos de sucesso, perigo e info passam a ter texto escuro (antes, branco com contraste entre 2,5:1 e 3,8:1); novo token `--op-field-border` para o contorno de campos; novos tokens `--op-*-text` para cores semânticas usadas como texto.
33
+ - `aria-invalid="true"` recebe o mesmo estilo de `.is-error`.
34
+ - Tamanho da fonte base em `rem` (acompanha a preferência do navegador).
35
+ - Com um modal aberto, o resto da página fica inerte (não recebe foco nem é lido pelo leitor de tela).
36
+ - Suporte a `prefers-contrast: more` (painéis opacos, bordas mais fortes) e ao modo de cores forçadas do Windows.
37
+ - Paginação: a página ativa recebe `aria-current="page"`.
38
+ - Novo `OptagoUI.refresh()` para aplicar o mesmo tratamento a HTML inserido dinamicamente.
39
+ - Novas classes `op-skip-link` e `op-sr-only`.
40
+ - Suporte a `prefers-reduced-transparency`: painéis opacos e sem desfoque de fundo.
41
+ - Links do rodapé (`op-footer`) com pelo menos 24px de altura.
42
+ - Com `prefers-contrast: more`, os painéis opacos passam a valer também no tema claro.
43
+ - Checkbox, switch e `op-card-link` passam a ter pelo menos 24px de altura como alvo de clique.
44
+ - Página sem o app shell (login, erro) volta a rolar: antes o `<html>` ficava sempre com a rolagem cortada.
45
+ - Showcase: “Ver código” e “Copiar” mostram o HTML como foi escrito, sem os atributos que a lib acrescenta em tempo de execução.
46
+
47
+ ### Movimento
48
+
49
+ - Novo atributo `data-op-motion-toggle` e novas funções `OptagoUI.setMotion()` e `OptagoUI.toggleMotion()` para pausar as animações decorativas. A escolha fica em `localStorage`.
50
+ - `prefers-reduced-motion` agora para de fato as animações infinitas (antes só encurtava a duração). Indicadores de carregamento continuam girando.
51
+ - Corrigido: ao clicar em um item da sidebar, o destaque pulava de item em item enquanto a página rolava.
52
+ - Sidebar acompanha a página: quando o item ativo muda ao rolar e sai da parte visível do menu, a sidebar rola até ele (centralizando; sem animação quando elas estão pausadas). Vale para qualquer `.op-sidebar` com itens `href="#..."`, e não mexe enquanto a pessoa rola o próprio menu.
53
+
54
+ ### Microinterações
55
+
56
+ - Hover: ícones dos botões e da sidebar reagem, o botão primário ganha um brilho que o cruza, avatares e paginação sobem, a linha da tabela ganha um marcador lateral, a seta do dropdown gira ao abrir.
57
+ - Entradas: barra de progresso, ícone de alertas e toasts, aba ativa e fundo do modal.
58
+ - Novas classes `op-reveal` (entrada ao rolar, em CSS puro), `op-stagger` (entrada em cascata) e `op-text-gradient`.
59
+ - Os efeitos de hover só valem onde existe ponteiro (`hover: hover`); em tela de toque eles não ficam presos depois do toque.
60
+
61
+ ### Celular e toque
62
+
63
+ - Modal mais compacto em telas de até 640px, com os botões do rodapé dividindo a largura.
64
+ - Campos com fonte de 16px no celular (evita o zoom automático do iOS ao focar).
65
+ - Alvos de toque maiores em `pointer: coarse`: botões, paginação, itens de menu, checkbox, switch e botões de fechar.
66
+ - Abas rolam de lado sem barra de rolagem; espaçamentos menores em telas estreitas.
67
+ - Suporte a áreas seguras (entalhe e barra de gestos) com `viewport-fit=cover`.
68
+ - Nova classe `op-btn-block`.
69
+
70
+ ### Desempenho
71
+
72
+ - Nenhum `transition: all` (eram 12): cada componente transiciona só o que muda.
73
+ - Hover de botões e cards anima só `transform` e `opacity`; a sombra de hover fica em um pseudo-elemento.
74
+ - O switch anima por `transform` (antes, `left`); o link do card, também (antes, `gap`).
75
+ - `op-glow` usa degradê radial em vez de `filter: blur(110px)`.
76
+
77
+ ### Segurança e privacidade
78
+
79
+ - Ícones Phosphor: a lib insere direto as folhas de estilo, na versão fixa 2.1.2. Antes carregava um script de terceiros sem versão.
80
+ - Tabulator fixado em 6.3.1 (antes, faixa 6.3) e driver.js em 1.14.0 (antes, sempre a versão mais recente).
81
+ - Novos atributos no `<script>` da lib para não carregar nada de terceiros ou carregar menos: `data-op-assets`, `data-op-fonts` e `data-op-icons`.
82
+ - O README passa a listar o que a lib carrega de terceiros e o que guarda no navegador.
83
+ - Ícones, Tabulator e o CSS do driver.js passam a ser carregados com verificação de integridade (SRI).
84
+ - O editor de texto vem com o envio de estatísticas de uso desligado.
85
+
86
+ ### Novos recursos
87
+
88
+ - **Busca no menu:** a sidebar ganha um campo que filtra os itens pelo nome e por `data-op-desc` (descrição que não aparece na tela). Desligue com `data-op-search="off"`.
89
+ - **Valores sensíveis:** `data-op-sensitive` no valor e `data-op-privacy-toggle` no botão; `OptagoUI.setPrivacy()` e `OptagoUI.togglePrivacy()`. Oculto, o valor aparece como um borrão de tamanho fixo.
90
+ - **Submenu na sidebar:** `op-nav-group` sobre `<details>`, integrado à busca do menu.
91
+ - **Cabeçalho de página** (`op-page-header`) e **lista de definição** (`op-dl`).
92
+ - **Etapas:** `op-steps` e o assistente `data-op-wizard`.
93
+ - **Chips, chips selecionáveis e campo de tags** (`op-chip`, `op-chip-check`, `data-op-tags`).
94
+ - **Controle segmentado e cartões de opção** (`op-segmented`, `op-option`), sobre radio e checkbox nativos.
95
+ - **Upload de arquivo** (`op-upload`), sobre `<input type="file">`.
96
+ - **Máscaras de campo** (`data-op-format`): CPF, CNPJ, telefone, CEP, data, moeda e padrões próprios.
97
+ - **Período de datas** (`data-op-date-range`).
98
+ - **Código de verificação** (`op-otp` + `data-op-otp`): uma casa por dígito, com cursor na casa atual, sobre um único campo (colar, preenchimento automático por SMS e leitor de tela continuam funcionando). Evento `op:otp-complete`.
99
+ - **Popover** (`op-popover`), sobre a API nativa do navegador.
100
+ - **Copiar** (`data-op-clipboard`) e **paleta de comandos** (Ctrl+K, `OptagoUI.commands()`).
101
+ - **Tabela de trabalho:** barra de ferramentas (`op-toolbar`), filtro (`data-op-table-filter`), seleção de linhas com ações em lote (`data-op-table-select`, `op-bulk-bar`) e `op-table-stack`, que transforma as linhas em cartões no celular.
102
+ - **Validação de formulário** (`data-op-validate`, `OptagoUI.validate()`): usa as regras do HTML, marca os campos e monta um resumo de erros com link para cada campo. **Barra de ações fixa** (`op-action-bar`).
103
+ - **Campos extras:** numérico com − e + (`data-op-number`), combobox de seleção múltipla (`data-op-multiple`), avaliação por estrelas (`op-rating`), força da senha (`data-op-strength`) e contador de caracteres (`data-op-counter`).
104
+ - **Notificações** (`data-op-notify`) e **menu de conta** (`op-account-btn`, `op-menu-header`).
105
+ - **Banner de página** (`op-banner`) e **consentimento de cookies** (`op-consent`), que lembram a resposta com `data-op-banner-id`; evento `op:banner-dismiss`.
106
+ - **Sessão expirando** (`OptagoUI.sessionWarning()`) e **aviso de conexão** (`data-op-offline`, `OptagoUI.setOffline()`).
107
+ - **Navegação inferior para celular** (`op-bottom-nav`) e **modo compacto** (`data-op-density-toggle`, `OptagoUI.setDensity()`).
108
+ - **Kanban** (`data-op-kanban`): arrastar, botões em cada cartão ou Alt + seta. **Calendário do mês** (`data-op-calendar`). **Galeria com visualizador** (`data-op-gallery`). **Árvore** (`op-tree`). **Bloco de código** com botão de copiar (`op-code`).
109
+ - `auditoria.html`: página do repositório que confere nomes acessíveis, rótulos, ids, títulos, contraste, tamanho dos alvos e rolagem lateral de uma página do projeto, nos dois temas e em duas larguras.
110
+ - Arquivo `LICENSE` (MIT, como já declarado no `package.json`).
111
+ - **Idioma:** todos os textos da biblioteca saem de um dicionário trocável por `OptagoUI.locale()` ou por `<script type="application/json" data-op-locale>`. O formato é o do CodeIgniter 4 (`{0}`, `{nome}`, plural ICU); vêm prontos os arquivos `codeigniter/Language/` e `locales/` em pt-BR e en. Novo `OptagoUI.t()`.
112
+ - **Editor de texto** (`data-op-editor`, `OptagoUI.editor()`): Toast UI Editor 3.2.2 carregado sob demanda, com saída em HTML e em Markdown.
113
+ - **Tema do sistema:** `OptagoUI.setTheme('system')` e botões `data-op-theme`. Sem escolha salva, a página acompanha o sistema operacional, inclusive quando ele muda com a página aberta. Evento `op:theme-change`.
114
+ - **Toast** com botão de ação (`{ action }`), duração `0` (fica até fechar) e `OptagoUI.toast.promise()`.
115
+ - **Tabela nativa:** ordenação por coluna (`data-op-sort`), cabeçalho fixo (`op-table-sticky`) e linha de detalhe (`data-op-row-toggle`).
116
+ - **HTML inserido depois do carregamento** é tratado sozinho (MutationObserver); `OptagoUI.refresh()` deixa de ser necessário. Desligue com `data-op-observe="off"`.
117
+ - **Alterações não salvas** (`data-op-unsaved`, `OptagoUI.setDirty()`).
118
+ - **Campos repetíveis** (`data-op-repeater`), **faixa com duas alças** (`data-op-range-dual`) e **lista de transferência** (`data-op-transfer`).
119
+ - **Texto:** `op-prose`, `op-truncate`, `op-clamp-2/3` e “ver mais” (`data-op-more`).
120
+ - **Lista de itens** (`op-list`), **filtros ativos** (`op-filter-bar`) e **páginas de resultado** (`op-result`).
121
+ - **Carrossel** (`data-op-carousel`), **menu de contexto** (`data-op-context-menu`) e **painéis redimensionáveis** (`data-op-split`).
122
+ - **Botão dividido** (`op-btn-split`), **botão flutuante** (`op-fab`) e **voltar ao topo** (`data-op-back-top`).
123
+ - **Atalhos de teclado:** `OptagoUI.shortcuts()` e a lista aberta com `?`.
124
+ - **Blocos de site:** `op-hero`, `op-pricing` e `op-site-footer`.
125
+ - **Impressão:** só o conteúdo, no tema claro; `op-no-print` e `op-print-only`.
126
+ - **Modelos de tela** em `exemplos/`: painel, lista com detalhe, configurações e página de site.
127
+ - **SEO do manual:** título e descrição próprios em cada página, canonical, `hreflang`, `rel="prev"` e `rel="next"`, Open Graph e Twitter Cards, dados estruturados (schema.org: Organization, WebSite, SoftwareSourceCode, TechArticle e BreadcrumbList), trilha de navegação visível, `sitemap.xml` e `robots.txt`, tudo gerado por `npm run gerar` a partir de `capitulos/capitulos.json`. `npm run verificar` confere títulos, descrições, canonical, um `<h1>` por página, JSON-LD, sitemap e robots.
128
+ - **Licença MIT** explicitada: `LICENSE`, seção no `README`, seção "Licença" no manual (Sobre o projeto), cabeçalhos em `ui-optago.css` e `ui-optago.js` e link no rodapé do manual.
129
+ - **Manual em páginas:** o `index.html` é o resumo (números, primeiros passos, capítulos e modelos de tela) e cada um dos 11 capítulos tem a sua página em `capitulos/`, com “quando usar” e “cuidados” em cada componente. O menu lista todas as seções e leva à página certa. `capitulos/capitulos.json` é a fonte do menu, do índice de cada capítulo, do rodapé de navegação e do resumo; `npm run gerar` mantém tudo em dia e `npm run verificar` confere os links internos.
130
+ - `ui-optago.d.ts` (tipos), `ui-optago.layer.css` (a lib dentro de `@layer optago`) e `tokens.json`.
131
+ - `scripts/gerar.mjs` (arquivos de idioma e tokens) e `scripts/verificar.mjs` (sintaxe, arquivos gerados e auditoria de acessibilidade em navegador sem janela), este último também no GitHub Actions.
132
+ - **Páginas prontas:** login e erro (`op-center-page`, `op-auth-card`, `op-error-page`).
133
+ - `OptagoUI.announce()` para avisos a leitores de tela.
134
+ - `OptagoUI.confirm()` e `data-op-confirm` para confirmar ações destrutivas.
135
+ - `op-empty` para estados vazio e indisponível.
136
+ - **Gráficos:** `OptagoUI.chart(alvo, configuração)` e o atributo `data-op-chart` em um `<canvas>` (`bar`, `line`, `area`, `doughnut`, `pie`, `radar`, `polar`). O Chart.js 4.6.1 vem do CDN sob demanda, com integridade (SRI). Seis cores de série (tokens `--op-series-1` a `6`), fontes, cantos, legenda e dica seguem o tema, e o gráfico troca de cor sozinho quando o tema muda. Dataset sem cor recebe a da série; a configuração que você passar vence. Sem `aria-label`, a lib escreve um com os números. Novo `op-chart-canvas` (pai com altura própria, em três tamanhos). Só carrega se a página usar.
137
+ - **Tela de abertura e logo animado:** `op-splash` (logo com reflexo, mensagem e barra de espera; sem texto de marca por padrão, e `data-op-splash-brand` ou `{ brand }` escreve o nome do seu sistema) cobre a página enquanto ela carrega, por marcação (`data-op-splash`, some ao carregar; `data-op-splash-min` define o tempo mínimo) ou por código (`OptagoUI.splash.show()` e `.hide()`). A div pode ir vazia: a lib monta o conteúdo no instante em que ela aparece. Cinco variações (`data-op-splash-variant`: `ripple`, `draw` com o contorno traçado, `orbit`, `counter` com porcentagem e `minimal`) e três saídas (`data-op-splash-exit`: `fade`, `up` e `iris`, que fecha em octógono). `OptagoUI.splash.progress()` controla o contador. Some sozinha depois de 10 s mesmo que o script falhe. O `op-logo-loader` (o octógono da marca girando e emitindo ondas, em três tamanhos) também pode ser usado sozinho. Com as animações pausadas, o logo continua girando, sem as ondas.
138
+ - **Duas cores da marca, com nomes de papel:** `--op-main` (principal) e `--op-secondary` (secundária), cada uma com `-hover`, `-ink` e `-text`. Os nomes antigos `--op-accent` e `--op-cyan` viraram apelidos deles e continuam funcionando em qualquer CSS que já os use. `OptagoUI.customize()` e `OptagoUI.appearance()` aceitam `main`/`secondary` e também `accent`/`cyan`, e o atributo `data-op-accent` vale como `data-op-main`. As classes `op-btn-cyan`, `op-badge-cyan` e `op-glow-cyan` mantêm o nome e seguem a cor secundária. O tema claro ganhou os tokens `--op-light-main-text`, `--op-light-secondary-text`, `--op-light-grad-1` e `-2`, `--op-light-aurora-1` e `-2`, `--op-light-series-1` e `-2`.
139
+ - **Aparência e personalização:** nove atributos no `<html>` trocam grupos de tokens sem CSS: `data-op-main` e `data-op-secondary` (lime, cyan, blue, violet, rose, orange, teal, yellow, graphite), `data-op-radius`, `data-op-shape` (botões em pílula, arredondados ou retos), `data-op-font`, `data-op-text` (tamanho do texto), `data-op-width` (largura do conteúdo, novo token `--op-container-w`), `data-op-aurora` e `data-op-surface`. `OptagoUI.appearance()` lê e aplica as opções e guarda a escolha no navegador; `OptagoUI.resetAppearance()` volta ao que a página definiu; evento `op:appearance-change`. `appearance({ tokens })` guarda qualquer token (`all`, `dark` ou `light`).
140
+ - **Painel Personalizar e editor de tokens:** `OptagoUI.customizer.open()` ou `data-op-customizer-open` abre uma gaveta com tema, cor principal e cor secundária (amostras e cor livre), cantos, formato dos botões, fonte, tamanho do texto, largura, luzes de fundo, painéis, modo compacto, animações e o editor com todos os tokens (cores de estado, superfícies e texto, cantos, fontes e dimensões do layout). Restaurar padrão e Copiar código (atributos do `<html>`, chamada de cor livre e CSS dos tokens). O mesmo editor serve em qualquer página com `<div data-op-token-editor></div>`. Textos traduzíveis (`custom.*`).
141
+ - **Cor livre:** `OptagoUI.customize({ main: '#FF6B00', secondary: '#7C3AED' })` (e `appearance`) calcula o hover, a cor do texto sobre ela e a versão do tema claro (texto, degradê, luzes e série, com 4,5:1 de contraste). O brilho `--op-glow` passa a seguir a cor principal.
142
+ - **Página de login igual à do login único:** `op-auth-page`, `op-auth-glows`, `op-auth-theme`, `op-auth-footer`, `op-auth-divider` e `op-auth-social` (modelo em `exemplos/login.html`).
143
+ - **Seis modelos de tela novos** em `exemplos/`: relatórios (com Chart.js), tarefas (kanban), agenda, perfil, assinatura e login. O menu lateral de todos os modelos passou a listar os dez.
144
+
145
+ ### Mudanças que podem afetar quem já usa
146
+
147
+ - O visual muda sem alterar nenhuma classe. CSS próprio que dependia dos cantos, das abas sublinhadas ou de painéis opacos pode precisar de ajuste.
148
+ - `body::before` e `body::after` agora são usados pela lib (fundo aurora).
149
+ - `.op-card` passa a ter `position: relative`.
150
+ - Botões sólidos (exceto os com `data-op-tip`) e `.op-dot-pulse` passam a usar o pseudo-elemento `::after`.
151
+ - ESC fecha uma camada por vez (antes fechava todos os modais abertos de uma vez).
152
+ - `op-modal-drawer` agora abre pela esquerda. Para manter o lado direito, some `op-modal-drawer-end`.
153
+ - O tema deixa de ser gravado no primeiro carregamento: quem nunca escolheu um tema passa a acompanhar o sistema operacional.
154
+ - `OptagoUI.toast()` continua aceitando a duração como terceiro argumento, e agora também um objeto de opções.
155
+ - Ao imprimir, a página sai sempre no tema claro e sem o app shell.
156
+ - `OptagoUI.showLoading()` mostra o logo animado da Óptago no lugar do spinner.
157
+ - O botão "Pausar ou retomar animações" saiu do cabeçalho do manual e dos modelos de tela. A função continua (`data-op-motion-toggle`, `OptagoUI.setMotion()`), e o painel Personalizar traz a opção "Pausar animações".
158
+ - Sidebar: o nome do item quebra em mais de uma linha quando não cabe (por exemplo, “Acessibilidade e preferências”), em vez de estourar a largura. Recolhida, nada muda.
159
+ - `<a class="op-card">` perde o sublinhado e a cor de link do navegador; o título segue a cor do texto e ganha a de destaque no hover.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Óptago
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.