[KazumaProject]

Refs #1296

実装スクリーンショット / Implemented UI

Lite Standard Debug・API 35 ARM64 エミュレーターの実編集画面（日本語）。コミット: 20c45783e。
Actual Japanese editor captured from the Lite Standard Debug app on an API 35 ARM64 emulator.

全体プレビュー / Overview	表示・入力の編集 / Key appearance and input
長押し候補の編集 / Long-press candidate editor	ダークテーマ / Dark theme

日本語

QWERTY 型キーの編集画面で、キーの表示・押下時の表示・実際に入力される文字の対応と、長押し候補の作り方が分かりにくい問題を改善します。設定を見た目と入力結果のプレビューで確認しながら編集できます。

• キーと押下表示を並べてプレビューし、タップで入力する文字を表示。プレビューまたは編集ボタンから表示・入力の編集欄を開けます。
• 長押し候補はポップアップの並びを再現したグリッドで選んで編集。変更は即時に反映し、「選んで離すと入力」する文字も表示します。
• 候補のない状態の案内、列数の ± 操作、選択マスの強調、空白化と削除の違いを追加。多列のグリッドはマスの操作サイズを保ったまま横スクロールできます。
• 通常と Shift / Caps Lock を切り替えて確認でき、自動大文字化のプレビューと専用設定の編集を区別。画面再作成後も編集中のレイヤー・候補・編集欄の開閉・未確定の列数を復元します。
• 日英の説明文と、表示文字省略時の案内・入力エラー表示を整備します。

検証

• 関連ユニットテスト 18 件成功（QWERTY 編集 6、既存レイアウト編集 9、既存キー検証 1、QWERTY バックアップ 2）。
• Lite Standard Debug のアプリ APK と計測テスト APK をビルド。
• API 35 / ARM64 エミュレーター・隔離したアプリ ID で、既存キーからの変更、UI によるキー表示・入力・押下表示・候補・空白位置・絵文字の設定、画面再作成後の候補選択復元、保存・DB 再読込を確認。
• 同じアプリの実編集画面を日本語・ライト／ダーク表示で撮影し、レイアウトを目視確認。
• 実機、他 API レベル、リリースビルド、IME 全入力モードの再検証は未実施です。

変更は編集 UI、日英リソース、直接関係するテストの 5 ファイルのみです。画像・APK・検証ログ・撮影用コードはコミットに含めません。

English

Improves the QWERTY key editor so users can see how the key label, pressed preview, tap output, and long-press alternatives relate before saving.

• Show the key and pressed appearance side by side with the tap result. Open the appearance/input fields from either preview or the edit button.
• Edit long-press alternatives directly in a popup-shaped grid, with immediate display updates and an explicit selection output.
• Add empty-state guidance, column steppers, a selected-cell highlight, and explanations of clearing versus removing a cell. Wide grids scroll horizontally while preserving usable touch targets.
• Preview normal and Shift/Caps Lock layers, explain automatic capitalization, and distinguish custom Shift editing. Restore the active layer, candidate selection, expanded editor, and unfinished column input after recreation.
• Provide Japanese and English guidance, display fallback explanations, and input validation.

Validation

• 18 related unit tests passed: QWERTY editor (6), existing layout editor (9), existing key validation (1), and QWERTY backup (2).
• Built Lite Standard Debug application and instrumentation APKs.
• On an isolated API 35 ARM64 emulator/application ID, exercised conversion of an existing key, UI edits to labels/output/pressed preview/candidates/blank positions/emoji, selection restoration after recreation, and saving/reloading through the database.
• Captured and visually checked the actual Japanese editor in light and dark mode.
• Physical devices, other Android APIs, release builds, and every IME input mode were not retested.

Only the editor UI, localized resources, and directly related tests are committed. Screenshots, APKs, logs, and capture-only code are kept outside the repository.