# API map of the "Dropdown pickers" family: old path to new path and setter renames. # Filled in by the family track; the codemods and the app scan read it. family = "Dropdown pickers" new_module = "craft_ui::pickers" # One entry per public type: `old` is the path an app calls today, `new` the path after migration. # `status` is "pending", "same" (path unchanged), "moved", "replaced" (use `note`) or "removed". [[type]] name = "Select" old = "craft_ui::controls::select::Select" new = "craft_ui::pickers::Select" status = "moved" note = "A `Component` shown with `Show::show`; the output is `EditResponse`. `Select::new(label, Bind, &[Entry])`: the options are `Entry` values (`Entry::new(value, label).icon(..).enabled(..)`, `Entry::separator()`), and the value comes back from the binding, never an index. The popup is `List::options` on `Overlay::dropdown()` and focus stays on the field." [[type]] name = "SelectOption" old = "craft_ui::controls::select::SelectOption" new = "" status = "replaced" note = "Use `craft_ui::contract::Entry`: `Entry::new(value, label)`." [[type]] name = "SelectStyle" old = "craft_ui::controls::select::SelectStyle" new = "craft_ui::pickers::SelectStyle" status = "moved" note = "A `ComponentStyle` built from the tokens; the legacy `SelectStyle::style(tokens, size)` and its public fields are gone." [[type]] name = "SelectText" old = "craft_ui::controls::preview_select::SelectText" new = "" status = "removed" note = "Not ported. A select shows its face text always; a preview-only select needs a thumb painter (`Select::decorate`) and a face without text, which the contract does not offer yet." [[type]] name = "LineStyle" old = "craft_ui::controls::preview_select::LineStyle" new = "" status = "removed" note = "A stroke-style value of the host's own: show its preview in a row with `Select::decorate` and `ListRow::thumb`." [[type]] name = "LineWeights" old = "craft_ui::controls::preview_select::LineWeights" new = "" status = "removed" note = "Goes with `LineStyle`: the host's thumb painter owns the weights." [[type]] name = "paint_line_style" old = "craft_ui::controls::preview_select::paint_line_style" new = "" status = "removed" note = "The host paints a line preview inside the thumb painter of `Select::decorate`." [[type]] name = "Shortcut" old = "craft_ui::controls::option_list::Shortcut" new = "" status = "removed" note = "The option-list row helpers (`paint_row`, `Shortcut`, `Leading`) are the option look of `ListRow::option()`; a shortcut text is `ListRow::trailing(..)` from `Select::decorate`." [[type]] name = "ComboBox" old = "craft_ui::controls::combo_box::ComboBox" new = "craft_ui::pickers::ComboBox" status = "moved" note = "`ComboBox::new(label, Bind::bound(&mut text), &options)` with `options: &[Entry]` in place of `new(id_salt, label, &text).options(..)`; output `EditResponse`. The text is the value; filtering, the list and its keys are the component's own. The deprecated `craft_ui::combo::ComboBox` (the egui fork, `show_ui`, `show_index` and the other `show_*` entry points) has no counterpart: a list of fixed choices is `Select`, a text field with options is this `ComboBox`." [[type]] name = "TreePicker" old = "craft_ui::controls::tree_picker::TreePicker" new = "craft_ui::pickers::TreePicker" status = "moved" note = "`TreePicker::new(label, Bind::bound(&mut album), &entries)`; the value is `Option` in a `Bind`, output `EditResponse>`. The closed field is a `SelectFace`. The popup has no search field: the list's type-ahead jumps to a visible row, and `tree_search` and `tree_path` go." [[type]] name = "Autocomplete" old = "craft_ui::controls::autocomplete::Autocomplete" new = "" status = "replaced" note = "`TextField::complete(completer)`: the text adapter owns the popup, the list keys, Tab and Escape. A `Suggestion` is a `Completion` (label, text to insert); `take_keys` and `AutocompleteKeys` go. A completion list anchored to something that is not a text field has no counterpart." [[type]] name = "DatePicker" old = "craft_ui::controls::date::DatePicker" new = "craft_ui::pickers::DatePicker" status = "moved" note = "A `Component` shown with `Show::show`: a text part (typed dates through `DateCodec`) and a calendar button that opens a popover. The output is `EditResponse>`; the value comes from the binding." [[type]] name = "IconPicker" old = "craft_ui::controls::icon_picker::IconPicker" new = "craft_ui::pickers::IconPicker" status = "moved" note = "A pattern over `TextField::search` and `TileGrid`, shown with its own `show(ui) -> IconPickerOutput`. `IconPicker::new(label, Bind>, &[IconPickerGroup])`; each item names its icon." [[type]] name = "ComboState" old = "craft_ui::controls::combo_box::ComboState" new = "" status = "removed" note = "Internal state of the legacy combo box (open flag, typing run, restore text). The text adapter keeps the typing run and the dropdown keeps the open state." [[type]] name = "Matches" old = "craft_ui::controls::combo_box::Matches" new = "" status = "removed" note = "Internal to the legacy combo box. `ComboBox` applies the same rule itself: options starting with the typed text first, then those containing it, ignoring case and surrounding spaces." [[type]] name = "Menu" old = "craft_ui::combo::Menu" new = "" status = "removed" note = "The deprecated egui-fork popup menu (`show_ui`, `show_rows_with_header` and the other `show_*` entry points). A value menu is `Menu::entries`; a value picker is `Select` or `ComboBox`." [[type]] name = "TreeEntry" old = "craft_ui::controls::tree_picker::TreeEntry" new = "craft_ui::pickers::TreeEntry" status = "moved" note = "Built with `TreeEntry::new(key, name)` or `TreeEntry::folder(key, name)` (names are `impl Into