0.2.0 — 2026-11-21
Design v3 (paleta Crepúsculo, app em tela cheia, templates de página), API da vitrine completa, ícones Hugeicons sob demanda (mix ledger_ui.icons), skill do Claude Code (mix ledger_ui.gen.skill), movimento dos overlays e gráficos responsivos.
A API da vitrine vira real
- Os nomes que a vitrine usa e faltavam são componentes de verdade (mesmos attrs e slots do componente de que
são apelido, então
__components__/0, os avisos de compilação e a skill os enxergam):progress_bar,number_stepper,range_slider,radio(um radio ou um grupo) eradio_choice,cover_card,sheet,menu,typography,command_palette_dialog,date_time_picker,empty_state_card,rich_text_editor,comment_editor,icon_rail,shell_floating; econtainer,inline_empty,tree(a árvore como dado) esub_nav, novos.list/1não existe de propósito (é o do CoreComponents); a vitrine fica comdescription_list. use LedgerUI, only: [...]eexcept: [...](nomes ounome: aridade), para quem tem um CoreComponents combutton,input,table,header,icon,modal...; um nome desconhecido derruba a compilação. README e moduledoc explicam.- Slots que faltavam:
:triggeremdropdown,action_menu,filter_menu,context_menuetooltip(neste, otrigger="click"e ocontent="..."em forma de texto passam porrest),:titleemmodaledrawer(otitle="..."continua valendo),:actionsemmodal,:itememaccordion,:optionemsegmented,:iteme:viewemsidebar. - Attrs que faltavam:
logo name/context;alert title/descriptioneaccentsem valor;status_toaststatus/title/action;divider label;tabs :tab active;modal show;drawer floating;icon_button color/shapee as variantes dobutton;bar_chart data;calendar month;color_pickerswatches;date_picker range;password_input strength;scrollspy target;theme_picker current;time_picker step;timer seconds;step_group steps/current;trace spans;timeline items;ai_tool_trace steps;conversation_list current;sidebar workspace;tree_item icon="nome";context_menu placement;illustration color;variantcomo apelido dolayout/shapeemdescription_list,form_sectionepagination;navbar variant="canvas". test/support/vitrine_code_known.exsó guarda artefatos do gerador (modificadores do canvas escritos comovariant=,<.chip>com prop de outro componente) e a decisão dolist, cada um com o motivo.
Design v3: paleta Crepúsculo, app em tela cheia e vitrine v2
- Paleta
crepusculo(<html data-palette="crepusculo">, tokens claro/escuro noledger.css):theme_pickera lista (themes/0ganha "Crepúsculo"), o hook guarda a escolha emlocalStorage["ledger-palette"](lê a chave antigaledger-theme) etheme_script/1a aplica antes da primeira pintura.LedgerUIetheme_switchdocumentam modo e paleta como duas chaves independentes. app_shell full(lu-app full: tela cheia, sem moldura); oapp/1dos templates usalu-app full.button icon="nome": o ícone antes do rótulo (iconcontinua aceitandotruepara o botão quadrado só de ícone);stat_itemaceitadelta,hint,goal,sparkedelta_tone;aura motioné apelido demode.- Showcase: seletor de paleta no topo e página "Temas" como na vitrine v2 (
data-paletteno<html>,lu-palette), os templates aceitam?palette=crepusculo,/templates/paleta(quadroTCrepPaleta) e/templates/tabela-app("Pedidos · interativa"); o índice/templateslista os dat/index.jsonna mesma ordem e com os mesmos títulos, mais o grupo Crepúsculo. Paridade com os quadrosTCrep*e comdesign/vitrine/t/*.html; o painel agora é comparado fora do gráfico de linha. - Vitrine v2: as seções "Referência visual" saíram (os exemplos foram renumerados),
retired.jsondeixou de existir e os demos "Referência visual" do canvas não viram extras.test/vitrine_code_test.exscompila o HEEx de cada seção contra a biblioteca; as que ainda não compilam estão emtest/support/vitrine_code_known.ex, com o motivo.
Gaveta e modal: movimento e dados do exemplo
- Gaveta/modal (
layout="page"e hookLedgerUI.Overlay) com o movimento da vitrine: fundo .22s, gaveta .32s, modal opacidade .2s + transform .28s, curvacubic-bezier(.2,.8,.2,1)nos dois sentidos. A gaveta da página não deslizava porque o foco rolava o.lu-app(overflow: hidden); agora éoverflow: clip. - Showcase
/templates/tabela: cada pedido tem seus itens, desconto, histórico e passos coerentes com a linha da tabela;?pedido=etabela-gavetacomeçam sem seleção.
Ícones e skill
mix ledger_ui.icons(get,sync,search,update): baixa os ícones Hugeicons Stroke Rounded que a app usa paraconfig :ledger_ui, :icons_path(commit fixado,.hugeicons.json,LICENSE.md), convertidos para o formato do kit.<.icon>os lê deLedgerUI.Icons(:persistent_term, recarrega ao achar a pasta alterada); embutidos vencem.- Skill do Claude Code:
mix ledger_ui.gen.skillemix ledger_ui.installescrevem.claude/skills/ledger-ui/(SKILL.md+references/<componente>.md) a partir do pacote instalado; o compilador opt-in:ledger_ui_skilla regenera quando a versão muda (não faz nada em:prod).
Integração
use LedgerUIimporta só function components e os helpers documentados (show_toast/2,dismiss_alert/0...); os helpers internos (Chart.num/1,money/1...) não vazam mais. Teste:use_imports_test.exs.- Uma só paisagem:
Illustration.summit/1(svg.lu-summit, tokens--hero-*, attrtone);hero_summit/1eauth_art/1delegam a ela. - Novos:
button canvas(lu-btn),number_input canvas,segmented stretch/role,checkbox style(vai nolabel). - Showcase: as seções do vitrine que o canvas aposentou saem da página; as demais são renumeradas a partir de 01.
Templates
- Showcase: seção "16 · Templates" (
/templates) com nove telas LiveView do canvas (auth, painel, tabela de pedidos com gaveta e modal) e teste de paridade contra os quadros. auth_page/1eauth_art/1(telalu-auth);bulk_bar variant="float"(lu-bulkfloat);draweremodalcomlayout="page"(sobreposição controlada pelo LiveView; o modal vira<form>comphx-submit/phx-change).line_chart sub_delta;alertcomcolor/variantnulos;checkbox size={nil};otp_input autofocusmarca a primeira caixa vazia (on); a rosca mostra45%em vez de45.0%;label_asidedos campos fica numa linha com o rótulo (lu-row).
0.1.0 — 2026-11-20
Primeira versão do Ledger UI: function components para Phoenix LiveView com o visual do canvas "Ledger UI · Componentes" (claro e escuro).
Componentes
- 140 componentes em 15 grupos, 110 módulos (
use LedgerUIimporta todos): fundamentos, ações, formulários (texto, seleção, datas e valores), exibição, métricas e gráficos, tabelas, fluxo de trabalho, feedback, navegação, sobreposições, estrutura e shell, temas e marca, IA. - API dos function components conforme os guias do design system (
design/system/components). - Formulários aceitam
field={@form[:x]}; listas e tabelas aceitam@streams.
Arquitetura
- Classes resolvidas em compilação (
@stylespor módulo),data-part, prefixo globalkeep-. - CSS do canvas sem alterações (
ledger.css) e complementoledger_ui.csspara controles reais, estados de overlay e classes extras. Sem Tailwind. - JS como módulo ES (
ledger_ui.esm.js) exportando{Hooks, DOM}: 58 hooksLedgerUI.*eDOM.onBeforeElUpdatedpara preservar estado do cliente entre patches. - Ícones Hugeicons renderizados no servidor; gráficos em SVG no servidor; ARIA no HTML do servidor.
- Abrir/fechar overlays com
Phoenix.LiveView.JS(LedgerUI.open/close/toggle), sem ida ao servidor.
Vitrine
showcase/: app LiveView que replica a vitrine do kit (mix phx.server, porta 4100), com exemplos em HEEx e teste de paridade contra o canvas (mix test test/parity_test.exs).