# Migração iconográfica — Phosphor

## Contrato

- fonte local: Phosphor 2.1, licença MIT;
- tamanhos de caixa: 16, 20, 24 e 32px;
- regular: padrão de interface; bold: ênfase; fill: seleção/estado ativo;
- monocromático por padrão; cor sempre herda `currentColor`;
- ícones decorativos usam `aria-hidden`; botões sem texto exigem `aria-label`;
- nenhuma correção por `top` ou `translateY`; alinhamento ocorre pela caixa do componente;
- nomes legados ficam em `data-icon` apenas para rastreabilidade da migração.

## De–para completo

| Semântica anterior | Phosphor | Usos rastreados | Observação |
|---|---|---:|---|
| `accessibility_new` | `ph-person-arms-spread` | 2 | Figura humana aberta; evita depender de um glyph específico de plataforma. |
| `add` | `ph-plus` | 7 | Equivalente semântico direto na família Phosphor. |
| `analytics` | `ph-chart-line-up` | 3 | Equivalente semântico direto na família Phosphor. |
| `arrow_back` | `ph-arrow-left` | 4 | Equivalente semântico direto na família Phosphor. |
| `arrow_forward` | `ph-arrow-right` | 17 | Equivalente semântico direto na família Phosphor. |
| `arrow_selector_tool` | `ph-cursor-click` | 1 | Equivalente semântico direto na família Phosphor. |
| `arrow_upward` | `ph-arrow-up` | 4 | Equivalente semântico direto na família Phosphor. |
| `article` | `ph-article` | 10 | Equivalente semântico direto na família Phosphor. |
| `attach_file` | `ph-paperclip` | 2 | Equivalente semântico direto na família Phosphor. |
| `book_2` | `ph-book-open-text` | 2 | Equivalente semântico direto na família Phosphor. |
| `cancel` | `ph-x-circle` | 9 | Equivalente semântico direto na família Phosphor. |
| `caret_double_left` | `ph-caret-double-left` | 0 | Caret Double Left comunica recolher em LTR e expandir em RTL. |
| `caret_double_right` | `ph-caret-double-right` | 0 | Caret Double Right comunica expandir em LTR e recolher em RTL. |
| `chat_bubble` | `ph-chat-circle` | 4 | Equivalente semântico direto na família Phosphor. |
| `check` | `ph-check` | 9 | Equivalente semântico direto na família Phosphor. |
| `check_circle` | `ph-check-circle` | 10 | Equivalente semântico direto na família Phosphor. |
| `close` | `ph-x` | 12 | Equivalente semântico direto na família Phosphor. |
| `content_copy` | `ph-copy` | 2 | Equivalente semântico direto na família Phosphor. |
| `dark_mode` | `ph-moon` | 8 | Equivalente semântico direto na família Phosphor. |
| `dehaze` | `ph-list` | 11 | List é a metáfora Phosphor mais próxima para navegação genérica. |
| `delete` | `ph-trash` | 2 | Equivalente semântico direto na família Phosphor. |
| `description` | `ph-file-text` | 1 | Equivalente semântico direto na família Phosphor. |
| `desktop_windows` | `ph-desktop` | 8 | Equivalente semântico direto na família Phosphor. |
| `domain` | `ph-buildings` | 0 | Equivalente semântico direto na família Phosphor. |
| `download` | `ph-download-simple` | 2 | Equivalente semântico direto na família Phosphor. |
| `edit` | `ph-pencil-simple` | 6 | Equivalente semântico direto na família Phosphor. |
| `error` | `ph-warning-circle` | 1 | Equivalente semântico direto na família Phosphor. |
| `explore` | `ph-compass` | 5 | Equivalente semântico direto na família Phosphor. |
| `favorite` | `ph-heart` | 15 | Equivalente semântico direto na família Phosphor. |
| `file_archive` | `ph-file-archive` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_audio` | `ph-file-audio` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_c` | `ph-file-c` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_c_sharp` | `ph-file-c-sharp` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_code` | `ph-file-code` | 1 | Equivalente semântico direto na família Phosphor. |
| `file_cpp` | `ph-file-cpp` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_css` | `ph-file-css` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_csv` | `ph-file-csv` | 1 | Equivalente semântico direto na família Phosphor. |
| `file_doc` | `ph-file-doc` | 2 | Equivalente semântico direto na família Phosphor. |
| `file_html` | `ph-file-html` | 1 | Equivalente semântico direto na família Phosphor. |
| `file_image` | `ph-file-image` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_jpg` | `ph-file-jpg` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_js` | `ph-file-js` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_json` | `ph-file-code` | 0 | Phosphor não possui file-json; File Code preserva o significado de arquivo estruturado. |
| `file_jsx` | `ph-file-jsx` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_md` | `ph-file-md` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_pdf` | `ph-file-pdf` | 3 | Equivalente semântico direto na família Phosphor. |
| `file_png` | `ph-file-png` | 1 | Equivalente semântico direto na família Phosphor. |
| `file_ppt` | `ph-file-ppt` | 3 | Equivalente semântico direto na família Phosphor. |
| `file_py` | `ph-file-py` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_rs` | `ph-file-rs` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_sql` | `ph-file-sql` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_svg` | `ph-file-svg` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_text` | `ph-file-text` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_ts` | `ph-file-ts` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_tsx` | `ph-file-tsx` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_txt` | `ph-file-txt` | 1 | Equivalente semântico direto na família Phosphor. |
| `file_video` | `ph-file-video` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_vue` | `ph-file-vue` | 0 | Equivalente semântico direto na família Phosphor. |
| `file_xls` | `ph-file-xls` | 3 | Equivalente semântico direto na família Phosphor. |
| `file_xml` | `ph-file-code` | 0 | Phosphor não possui file-xml; File Code preserva o significado de arquivo estruturado. |
| `file_zip` | `ph-file-zip` | 1 | Equivalente semântico direto na família Phosphor. |
| `filter_list` | `ph-funnel` | 1 | Equivalente semântico direto na família Phosphor. |
| `folder` | `ph-folder` | 4 | Equivalente semântico direto na família Phosphor. |
| `grid_view` | `ph-squares-four` | 13 | Squares Four preserva a metáfora de aplicação e catálogo. |
| `help` | `ph-question` | 2 | Equivalente semântico direto na família Phosphor. |
| `home` | `ph-house` | 11 | Equivalente semântico direto na família Phosphor. |
| `info` | `ph-info` | 5 | Equivalente semântico direto na família Phosphor. |
| `ink_eraser` | `ph-eraser` | 1 | Equivalente semântico direto na família Phosphor. |
| `keyboard_arrow_down` | `ph-caret-down` | 45 | Equivalente semântico direto na família Phosphor. |
| `language` | `ph-globe` | 1 | Equivalente semântico direto na família Phosphor. |
| `layers` | `ph-stack` | 20 | Stack preserva a metáfora de camadas do sistema. |
| `left_panel_close` | `ph-sidebar-simple` | 12 | Sidebar Simple Regular preserva a estrutura do painel e a mesma gramatura dos destinos do menu; abrir/recolher é comunicado por nome acessível e cursor. |
| `light_mode` | `ph-sun` | 8 | Equivalente semântico direto na família Phosphor. |
| `lightbulb` | `ph-lightbulb` | 2 | Equivalente semântico direto na família Phosphor. |
| `mic` | `ph-microphone` | 3 | Equivalente semântico direto na família Phosphor. |
| `more_horiz` | `ph-dots-three` | 10 | Equivalente semântico direto na família Phosphor. |
| `more_vert` | `ph-dots-three-vertical` | 1 | Equivalente semântico direto na família Phosphor. |
| `palette` | `ph-palette` | 11 | Equivalente semântico direto na família Phosphor. |
| `person` | `ph-user` | 1 | Equivalente semântico direto na família Phosphor. |
| `photo_camera` | `ph-camera` | 1 | Equivalente semântico direto na família Phosphor. |
| `picture_as_pdf` | `ph-file-pdf` | 2 | Equivalente semântico direto na família Phosphor. |
| `radio_button_checked` | `ph-radio-button` | 1 | Equivalente semântico direto na família Phosphor. |
| `radio_button_unchecked` | `ph-circle` | 1 | Equivalente semântico direto na família Phosphor. |
| `redo` | `ph-arrow-clockwise` | 4 | Equivalente semântico direto na família Phosphor. |
| `route` | `ph-path` | 10 | Path preserva fluxo, jornada e adoção. |
| `search` | `ph-magnifying-glass` | 24 | Equivalente semântico direto na família Phosphor. |
| `security` | `ph-shield` | 1 | Equivalente semântico direto na família Phosphor. |
| `settings` | `ph-gear-six` | 10 | Equivalente semântico direto na família Phosphor. |
| `share` | `ph-share-network` | 2 | Equivalente semântico direto na família Phosphor. |
| `slideshow` | `ph-presentation-chart` | 0 | Equivalente semântico direto na família Phosphor. |
| `smart_toy` | `ph-robot` | 2 | Robot fica reservado a agente ou IA, nunca a automação genérica. |
| `star` | `ph-star` | 1 | Equivalente semântico direto na família Phosphor. |
| `straighten` | `ph-ruler` | 4 | Equivalente semântico direto na família Phosphor. |
| `stylus_note` | `ph-pencil-line` | 1 | Equivalente semântico direto na família Phosphor. |
| `support_agent` | `ph-headset` | 2 | Equivalente semântico direto na família Phosphor. |
| `table_chart` | `ph-table` | 0 | Equivalente semântico direto na família Phosphor. |
| `toc` | `ph-list-bullets` | 1 | Equivalente semântico direto na família Phosphor. |
| `tune` | `ph-sliders-horizontal` | 2 | Equivalente semântico direto na família Phosphor. |
| `undo` | `ph-arrow-counter-clockwise` | 5 | Equivalente semântico direto na família Phosphor. |
| `upload` | `ph-upload-simple` | 3 | Equivalente semântico direto na família Phosphor. |
| `verified` | `ph-seal-check` | 14 | Seal Check preserva o estado verificado ou governado. |
| `visibility` | `ph-eye` | 3 | Equivalente semântico direto na família Phosphor. |
| `warning` | `ph-warning` | 4 | Equivalente semântico direto na família Phosphor. |
| `zoom_in` | `ph-magnifying-glass-plus` | 1 | Equivalente semântico direto na família Phosphor. |
| `zoom_out` | `ph-magnifying-glass-minus` | 1 | Equivalente semântico direto na família Phosphor. |

## Pesos instalados

| Papel | Classe | Fonte | Cobertura |
|---|---|---|---:|
| padrão | `ph` | Phosphor Regular | 101 ícones |
| ênfase | `ph-bold` | Phosphor Bold | 101 ícones |
| seleção | `ph-fill` | Phosphor Fill | 101 ícones |