Align the keyboards, candidate surfaces and toolbar with the reference skin

[Slacker-LLC]

Summary

Each gap against the reference product this branch found, closed from its own skin files. Later passes in the branch took the key faces, the pressed colours, the launcher pages, the number page, the panel headers and the expanded page. docs/DECISIONS.md records every quoted value with its file and line.

• 26-key letter hints. Each letter key's hint now matches the reference key by key (English a=- s=/ d=: f=; …, and the full-width forms in Chinese mode); an up swipe still types the hint, and a long press now offers only the two letter cases (upper first), as the reference does. The comma key gained an up-swipe full stop.
• Key weights, the nine-key column and candidate spacing. A and L are half a letter wider (the reference's 15:10), and 分词/退格 follow the same ratio. The nine-key and stroke side column is now 删除 / 重输 / 发送 with the send key twice as tall; the separate 0 key is gone — the space bar carries a corner 0 and an up swipe types it, behind the same "up swipe digits" setting. Candidate items pad 8dp per side instead of 12dp.
• The nine-key reading rail. During composition the rail is now the same flat list the symbols use: one reading per row at one text size, a hairline between rows, and no state drawn on any item — the pre-edit says which reading is current. The list keeps the user's scroll position until the open digits change, instead of re-centring on every keystroke.
• The nine-key URL rail. In an address or e-mail field the rail lists the reference's own eight URL fragments (. / www. .com .cn http wap. ftp:, input_kbd_pinyin9.xml:11) and hides the ＋ editor cell, instead of the user's punctuation.
• The first candidate. Accent-coloured text at the medium weight with no background of its own (cls_option_first_canditem, style.xml:551-554), instead of bold black text on a filled key tile.
• Candidate order. A word whose reading covers every typed letter now outranks a candidate that only matched the settled part of the input: typing dang offers 当 / 党 / 档 first and dangdi offers 当地 first, instead of a fragment split (da + ng) carrying its settled-prefix words up the list.
• The expanded candidate page. It opens with 全部 / 单字 as one option group over the list (input_more_cand.xml:9-13; 单字 keeps single characters, 全部 is the page's default), the list sits in one rounded card (radius 11, 2 edge, cls_morecand_bk), and the backspace floats in that card's bottom-right corner at 25.2% by 20.2% of the list, rounding only that corner with the card's own radius (bkround="0,0,11,0"). Every cell is the same flat label with a hairline edge (cls_morecands_button): the skin gives the expanded list no first-item class, so no cell carries the accent tile. The corner key deletes one letter of the open composition and the page stays open on the shorter list.

The reference's left syllable list on the expanded page (FilterListLayout name="more_cand_filter_list", commented 音节过滤) is not in this change: the 26-key path has no syllable-fixing state yet, so the list would have nothing to filter by.

• The 26-key bottom row. It is now the reference's own seven keys — 123 / ，。 / ， / 空格 / 。 / 中/英 / 确定 — in the reference's own weights (style.xml:957-978), so the two symbol keys the skin marks visible="true" are there (input_kbd_pinyin26.xml:153,156) and no key borrows their room. Their label is the class's own text (full-width in Chinese, ASCII in English) and their uri_adapter_symbol gives / and . in an address or e-mail field. The English merged key now leads with the period and carries the comma in its corner, as the skin draws it (input_kbd_english26.xml:154-161), where our version had the two the other way round.

• The nine-key 1 cell. It is the reference's @# key (input_kbd_pinyin9.xml:23-28): the label names the symbols the key offers, a tap and an up swipe still type the digit, and a long press opens the reference's own seven-symbol bubble / - _ 1 @ # . instead of our invented @ # /. The nine-key board no longer carries a 分词 key: the reference has none — ButtonSplit text="分词" appears once in the whole skin, on the 26-key row (input_kbd_pinyin26.xml:92). The 26-key 分词 key also drops the invented corner mark and long-press popup its class never declares (cls_button_shift, style.xml:915-920).

• The candidate strip. It now carries the reference's own [4] 候选列表(308) [1] [3] 更多候选(40) [4] layout (input_toolbar_typing.xml:16-30): both end insets, the hairline split between the list and the expand key, the 3-unit gap ahead of it, and the expand key's transparent pill press shape (cls_cand_list_weight_no_speech 308, style.xml:530-534; cls_candidate_split filled with @color/canditem_split, style.xml:504-506; cls_btn_morecand over cls_bk_toolbar_button, style.xml:231-235). The key keeps its 48dp touch target, our own rule: the reference's box is 40 units.

• The idle toolbar. Its icons follow the reference's own row — clipboard, emoji, then the board selector (input_toolbar_idle.xml:21-25) — inside a strip that scrolls when they do not all fit, the strip's slack sitting in a spacer at its own end (toolbar_left_container with sliderenable="true" sliderstopslowdown="true", line 14; toolbar_right_spacer, line 34). 收起 stays its own button at the right, outside the strip (line 40). The tools the reference lists that this build does not ship (translate, 繁简, 单手, handwriting lookup) stay out of the row.

• The number / decimal page. It is now the reference's own number layout (input_kbd_number_from26.xml:5-42), the page its 26-key 123 key opens: the symbol rail over the return key on the left, three digit columns whose last cell is 符号 / 0 / ., and a delete / space / send column at the reference's weights 66 / 75 / 75 / 75 / 66, with send twice as tall as the keys above it. The old 3x3 grid over a 返回 / 空格 / 0 row and the @ key are gone — no number page declares one. In a phone field the symbol cell carries the dialer's # and the period cell its +, so *, + and # stay reachable.

• The stroke grid. The board's centre is the reference's 3x3 (input_kbd_stroke.xml:16-66): 一 丨 丿 / 丶 折 通配 / @# ：；, every cell with the skin's corner digit typed by an up swipe, the punctuation cells committing themselves and the @# cell opening the reference's own / - _ @ # . 7 list on a long press. The bottom row of the stroke and nine-key boards now takes the reference's 45.5 / 134 / 45.5.

• The symbol page's categories. They sit in one bottom strip beside the page's own return key, the row the reference gives them: the tab container is weighted 85 against that key's 13.1 (input_kbd_symbol.xml:44-47) and scrolls (cls_symbol_tab_container, style.xml:707-710), and each category is a transparent pill whose label darkens when it is current (cls_input_kbd_symbol_option, style.xml:715-724). The cells stay five to a row where the reference draws ten (input_kbd_symbol.xml:6-15): ten across a phone would put each cell under our 48dp touch target.

• The symbol page's 123 and backspace. They close the page's symbol row at the reference's own two ends (input_kbd_symbol.xml:31-41, weight 15 each against the seven cells' 70), which a five-a-row grid cannot give them, so they take the ends of the tab strip's row. Both keep our 48dp touch target and use actions this page family already has.

• The symbol history. The board's toolbar now lists the symbols the user has typed, in the row the reference keeps for it (input_toolbar_quickinput.xml:4-18, hidden until the board needs it): the candidate strip's own shape — a 4-unit lead inset, the scrolling list at weight 308, the hairline split, a 3-unit gap, the 40-unit close key and a 4-unit tail — with 36-unit cells over candidate-sized text in the candidate text colour and 4 units between cells (cls_history_symbollist_button, style.xml:1061-1070; cls_history_symbollist, style.xml:1055-1058). A tap commits through the same path the board's own cells use, so the list re-reads itself; the close key ends the strip for that visit while the board stays open, and a user who has typed no symbols sees the plain toolbar.

• The launcher pages' tile grid. The tools page and the keyboard switcher now draw the reference's own grid (input_settings.xml:13-45, input_switch_keyboard.xml:13-29; cls_settings_bk_adaptive, style.xml:616-619): a container 88.9% of the page wide with its own paddings, tiles filling their cells 4 columns by 2 rows with the grid capped at 192 units, and each tile a radius-14 face — setting_button_bk under it, setting_button_pushedbk while pressed, the theme colour when it is the chosen one — with its name in keybutton_text_3, white on the chosen tile (cls_settings_button, style.xml:626-647; values/colors.xml:15,87-93). Our own card colour stays, a tile never shrinks under the 48dp touch target (the page scrolls instead), and an entry list longer than a page takes a third row rather than the reference's page dots.

• The floating keyboard's tip. The reference meets the floating keyboard with a tip in the toolbar row (input_toolbar_tip.xml:44-49): one pill across the row (cls_toolbar_tip_container bkround="999" over keybutton_bk, style.xml:1273-1275) with its own 3.333% horizontal padding (style.xml:442), a 3.571% lead space (style.xml:1277), a left-aligned ellipsized label in keybutton_text (cls_toolbar_tip_label, style.xml:1265-1270) and one round close key as wide as it is tall, filled toolbar_tip_close_button_bk and pressed toolbar_tip_close_button_pushedbk — black 4%/14% light, white 7%/17% dark (style.xml:1307-1313; values/colors.xml:163-164). The row is ported with our own truthful wording, 轻点顶部把手可恢复默认键盘, because our floating keyboard docks again on a tap of its handle where the reference asks for a drag to the bottom edge. The close key settles the tip for that stay afloat and the next one shows it again; 收起 keeps its place and the tip gives the row back to candidates, associations and the symbol history whenever they have something to say.

• Our own clipboard and message suggestions. They now wear the reference's quick-input row (input_toolbar_quickinput.xml:36-51 for the clipboard, :20-32 for the message): the text at cand_font in canditem_text, left-aligned in a scrolling container, with the glyph that names where it came from riding above its right shoulder as a superscript — the text box inset 0.055/0.111 of the row (line 42), the glyph at the top edge at fi_toolbar_tip_superscript's 30 units against cand_font's 56 (style.xml:138, :83; lines 44-45) — and the row ends with the reference's own close key borrowed from cls_history_close_button through cls_btn_more_cand_button_adaptive (lines 48-49). Ours were filled key-coloured pills at the body size behind a back chevron, which no reference toolbar draws. The system's autofill chips keep the back control — they are the platform's own views in the same strip — and every row keeps our 48dp touch target.

• The pre-edit's own half of the page. The pinyin block now sits in a wrapper of at most half the page's width (maxwidth="halfMaxWidth", input_toolbar_typing.xml:6), with a 5-unit lead of its own under the row's 3-unit top inset (lines 5, 6) and the other half left to the empty control the reference keeps beside it (line 18). The string scrolls inside the cap, as the reference's own composition container does (sliderenable="true" over cls_comp_container, style.xml:575-577), and the block carries the container's own press tint while it is edited (comp_pushedbk — black 8% light, white 12% dark, values/colors.xml:84). Ours ran the full width of the row in portrait and stopped at a 160dp cap of our own making in landscape, with no press feedback at all.

• The pre-edit string. It is now the reference's two-part composition (cls_comp_half over cls_comp_right, style.xml:580-587): the syllables the user has fixed — the nine-key reading tapped in the rail — carry the accent, the unconverted tail keeps the key text colour, and both take comp_font's own size (style.xml:79). A divider the decoder inserted stays plain, because it is not a syllable the user chose.

• The key fills trade places on press. keybutton_pushed_bk is keybutton_func_bk — a white key presses to the grey key's colour — and keybutton_func_pushed_bk is keybutton_bk, so a grey key flashes white; the theme-coloured action key keeps its own pressed recipe (values/colors.xml:19-23, values/dark_colors.xml:18-22, cls_button_enter, style.xml:810-818). Each cap also carries the skin's one-unit shadow line under it (shadow_y_offset="1" over keybutton_white_shadow / keybutton_gray_shadow, black 30% light / 40% dark).

• Each pressed surface carries the colour its own class names. The candidate cells brighten to canditem_pushedbk (white light / white 8% dark), the expanded page's cells to morecands_button_pushedbk, the rail rows fill with the white key, the symbol-category tabs take one neutral pill with labels at 60% and 85%, the long-press bubble cells fill with the accent, and the corner marks, the idle toolbar's glyphs and the candidate split take their own named colours (cls_option_canditem, cls_vertical_symbol_list_button, cls_input_kbd_symbol_option, cls_fusiyin_bubble_button, style.xml:1025-1030, :715-724, :1135-1139; values/colors.xml:14,16-17,30,81-83).

• A face presses onto the page it lies on, not into its own shade. Every press colour the skin names for a tile or a toolbar key is the same recipe — black 6% light / white 4% dark over the ground (toolbar_idle_button_pushedbk, setting_button_pushedbk, values/colors.xml:45,89, values/dark_colors.xml:43,87) — so the tools and switcher tiles, the settings rows and the idle toolbar's keys sink toward their page on both skins, where a shade derived from the resting colour brightens them on the dark one.

• The launcher pages read their own classes. The chosen tile on the keyboard switcher keeps its card and colours its name and glyph with the accent (cls_settings_option_mode_switch_button declares no selected fill, only selectedtextcolor / ficon_textcolor_selected, style.xml:649-668), where the settings page's cls_settings_button fills it. The English board's 中/英 key answers in the accent (keyboard_current_english, cls_button_en2cn, style.xml:897-904), the direction the key points.

• The number page's return key wears the theme colour. cls_button_back_26key takes cls_button_back, whose cls_bk_theme_circle fills with theme_color and presses to the white key's own fill (style.xml:857-858, :838-843, :282-286). The label stays ours: the reference's is a private-use glyph of its icon font.

• The nine-key and stroke bottom rows are white, not grey, either side of the space bar. Both name cls_keyboard9_button_func_white_circle for 123 (input_kbd_pinyin9.xml:88, input_kbd_stroke.xml:70) and the same white circle under the 中/英 key's own colours (:98, :82), leaving only the 符号 key above them grey.

• The panel header's close key is the reference's own circle. Both pages the reference gives a header open with cld_toolbar_close_button: a circle filled toolbar_idle_button_bk (white 80% light / white 12% dark) pressing to toolbar_idle_button_pushedbk (black 6% / white 4%), its glyph in action_button_pushedtext — the button-glyph colour, not the idle toolbar's icon grey (input_settings.xml:5-8, input_switch_keyboard.xml:5-8, style.xml:266-273; values/colors.xml:38,43,45). It paints 40dp inside the 48dp touch target, where our old header drew a bare arrow that also fell into the tools page's tile-icon rule and took the accent.

• The expanded page wears the colours its own classes name. The list sheet is morecands_list_bk (white 40% light / 6% dark) edged at 2 units with morecands_list_border (black 6% / white 10%) and rounded 11, each cell repeating that border at 1 unit; the 全部 / 单字 group is morecands_filter_container_bk (black 4% / white 6%) with a white chosen chip on the light skin and black at 24% over the pill on the dark one, its label filter_button_selecttext and the other chip left at keybutton_text_2; the corner backspace takes morecands_backspace_bk and its pressed shade, this page's own opaque greys (style.xml:1141-1149, :1157-1166, :773-780; values/colors.xml:121-128). The chosen chip is one more face that sinks on the dark skin where ours brightened.

• Four classes are checked and left unported, with the reason recorded. cls_quickinput_button, cls_morecands_scroll and cls_keyboard_button_add_custom_symbol are declared but instantiated by no shipped layout, so they name no behaviour to port; cls_period_comma_fusiyin only repeats the 40% corner-mark colour our hint already carries.

Two side changes the alignment work needed: a debug build can coexist with a release install through openimeAppIdSuffix, and the two clipboard retention tests that assert an empty history now hold a precondition (this app must not be the active IME), plus the rail stress case types the 0 through the space bar's up swipe.

Affected areas

• Keyboard layout, insets, floating keyboard
• Build, tests or documents

Verification

• :app:testDebugUnitTest — 514 tests, 0 failed
• :app:lintDebug
• :app:assembleDebug
• :app:compileDebugAndroidTestKotlin
• git diff --check
• Instrumented suite on a local emulator — 159 tests, 3 skipped, 0 failed on emulator-5558 API 31, run after every batch in this branch; the per-keyboard volume run holds emulator-5556. CI covers API 26 / 29 / 31 / 34 as well.

The candidate-presentation instrumented test now asserts the expanded page's card and filter chips instead of the bare scrolling grid it used to be, the new floating-tip test covers the banner's own proportions, its close key settling the tip for the stay afloat, and the collect key staying reachable under it, and the new pre-edit test covers the half-page cap and the string staying inside it.

Test device, Android version and commands:

• CI: x86_64 emulators, API 26 / 29 / 31 / 34.
• ./gradlew :app:testDebugUnitTest :app:lintDebug :app:assembleDebug

Change log and version

• I added each user-visible change to [Unreleased] in CHANGELOG.md. Internal changes do not need an entry.
• I did not change VERSION. Only a release PR changes it. See docs/RELEASE.md.
• The PR title states the result. It becomes the commit title, and the description becomes the commit body.

Privacy and delivery

• The change has no passwords, clipboard content, recordings, device logs or personal paths.
• The change keeps the source and license of each model, dictionary and third-party file.
• If the change affects user data or settings formats, the description explains upgrade compatibility.

🤖 Generated with Claude Code