Skip to content

フリーフリックの判定・ガイド・テンプレート改善 / Refine Free Flick selection, guide and templates - #1306

Merged
KazumaProject merged 2 commits into
devfrom
codex/free-flick-refinements
Nov 13, 2026
Merged

KazumaProject merged 2 commits into
devfrom
codex/free-flick-refinements

Conversation

@KazumaProject

@KazumaProject KazumaProject commented Nov 13, 2026 •

Copy link
Copy Markdown
Owner

親PR / Parent: #1305 — dev → codex/sumire-popup-maps → codex/free-flick-refinements

日本語

フリーフリックでpopupの枠外へ動かしたときも、最寄りの文字を選択できるようにしました。専用設定にON/OFFを追加し、OFFでは従来どおり枠内だけ反応します。

  • 最寄り判定は初期状態でON。対象は文字ON、マップ切替OFF、戻るOFFで個別に変更できます。実際の枠内を優先し、枠外では角丸の輪郭までの物理距離で選びます。同距離は現在の選択、次に保存順を優先します。空の文字は最寄り候補から除きます。
  • タップは元キー全体です。指を置く位置によってpopupの基準は動きません。切替後の文字はそのまま離して入力でき、新しく選ばれた制御操作は一度離れてから入り直す必要があります。
  • 表示は「キー周辺」(既定)と「キー上部のガイド」。上部ガイドには二段フリックの寸法・カード・選択表示・キー上の矢印・丸い指位置マーカーを共用しました。自由配置の範囲はガイドへ一律に縮小し、マップを切り替えても投影位置を保ちます。操作の基準は元キーです。
  • 新旧Sumire設定、設定検索、popup表示設定から専用設定へ移動できます。名称をフリーフリックに統一し、日本語・英語の表示からTFBiを除きました。旧3段入力の保存値や動作は変換しません。
  • 新規設定には実際の12キーフリックのかな割り当てを使います。既存キーへの「テンプレートを適用」は確認後に下書きだけを変更し、取り消し・保存に対応します。既存マップと他キーは自動で置き換えません。設定画面へ移動して戻っても下書きを保持します。
  • v1マップJSON、free-popupスタイルID、既存の設定キーを保持します。操作中の設定・キー位置変更は入力を中止します。

English

Free Flick now supports nearest-popup selection outside configured bounds. A dedicated setting disables it to restore the previous inside-only behavior.

  • Nearest selection defaults to ON, with text ON and map switching / Back OFF independently. Direct hits win. Outside bounds, selection uses physical distance to the rounded edge, retaining the previous selection on ties before falling back to saved order. Empty text is excluded from nearest candidates.
  • The original full key remains the tap region and fixed origin regardless of the initial touch point. Text at a transition's arrival position can be released immediately; an arrival control requires exit and reentry.
  • Choose around-key popups (default) or an above-key guide. The compact guide shares the two-step guide dimensions, card, selection pills, original-key arrow and ring cursor. A common uniform projection preserves the custom layout across map changes; gestures remain relative to the original key.
  • Reach dedicated settings from modern/legacy Sumire settings, search and popup appearance settings. Visible Japanese/English labels use Free Flick and remove TFBi wording. Legacy three-stage saved values and runtime behavior are not converted.
  • New maps use the actual standard 12-key kana assignments. Applying the template to an existing key requires confirmation, modifies only the draft, supports undo, and takes effect after Save. Other keys and existing saved maps are not automatically replaced. Drafts survive visiting settings and returning.
  • Preserve v1 map JSON, the free-popup style ID and existing preference keys. Live settings or source-key geometry changes cancel the active gesture.

検証 / Validation

  • 関連単体テスト 28件成功 / 28 focused unit tests passed: selection, rounded-edge distance, ties, per-action options, transition reentry, 12-key mappings, v1 persistence, template drafts/undo, backup/preferences, shared guide rendering and dimensions.
  • Pixel 6実機 / API 37: 通常6件、上部ガイド1件、フローティング上部ガイド1件、横画面上部ガイド1件、すべて成功。 API 35 emulator: same 9 instrumented checks passed. Tests exercise native settings/search/editor, activity recreation, unsaved draft retention, actual IME/InputConnection output, fixed origin, immediate text, Back, live options and geometry cancellation.
  • Lite Standard Debug app/test APK builds, Full Standard Debug Kotlin compilation and diff checks passed. Device tests use the isolated .popuptest application ID. Full APK/Release builds, other physical devices and extended usability testing remain unverified.
  • コミットは必要なコード・リソース・直接関連するテストのみです。撮影コード・画像・動画・APK・ログはリポジトリ外に保存しています。 Media, capture-only tooling, APKs and logs are kept outside the repository.

実機の動画 / Device videos

Pixel 6の実アプリをOSの画面録画で撮影しています。入力先は検証用テキスト欄です。ば行・★・戻るを含むマップは機能説明用に作成したサンプルで、初期テンプレートには含みません。
Native OS recordings of the actual Pixel 6 implementation. Input uses a dedicated test text field. The voiced-map / ★ / Back layout is a custom demonstration sample, not part of the default template.

二段フリック → フリーフリックの比較 / Two-step → Free Flick

free-flick-two-step-comparison.mp4

設定・表示プレビュー・テンプレートと取り消し / Settings, preview, template and undo

free-flick-settings-template.mp4

実IME:最寄りOFF/ON・上部ガイド・切替・戻る / Real IME: nearest OFF/ON, guide, switch and Back

free-flick-input-guide.mp4

フローティングで同じ操作 / Same operations while floating

free-flick-floating-guide.mp4

説明用スクリーンショット33枚 / 33 annotated implementation screenshots

Pixel 6 / API 37。各画像は外部添付です。画像を開くと元の解像度で確認できます。
Captured on Pixel 6 / API 37; open an external attachment for the original resolution.

二段フリックと共通のデザイン / Shared two-step appearance

二段フリック:タップ中のガイド / Two-step: tap guide フリーフリック:タップ中のガイド / Free Flick: tap guide
二段フリック:タップ中のガイド / Two-step: tap guide フリーフリック:タップ中のガイド / Free Flick: tap guide
二段フリック:左フリックと矢印・丸いマーカー / Two-step: left arrow and ring cursor フリーフリック:同じ寸法・描画部品で左フリック / Free Flick: shared dimensions, arrow and ring
二段フリック:左フリックと矢印・丸いマーカー / Two-step: left arrow and ring cursor フリーフリック:同じ寸法・描画部品で左フリック / Free Flick: shared dimensions, arrow and ring

設定への入口と名称 / Settings routes and naming

従来のSumire設定:入力スタイルの直下 / Legacy Sumire: below input style 新設定:検索から専用設定へ / Modern settings: searchable dedicated screen
従来のSumire設定:入力スタイルの直下 / Legacy Sumire: below input style 新設定:検索から専用設定へ / Modern settings: searchable dedicated screen
popup設定:2段とフリーフリックの入口 / Popup settings: two-step and Free Flick entries TFBi表記をなくした開始位置・表示位置 / Readable start-position and presentation labels
popup設定:2段とフリーフリックの入口 / Popup settings: two-step and Free Flick entries TFBi表記をなくした開始位置・表示位置 / Readable start-position and presentation labels

判定オプションと表示プレビュー / Detection options and preview

初期値:最寄りON、文字ON、切替・戻るOFF / Defaults: nearest and text ON, controls OFF 最寄りOFF:個別設定も無効表示、値は保持 / Master OFF: dependent controls disabled, values retained
初期値:最寄りON、文字ON、切替・戻るOFF / Defaults: nearest and text ON, controls OFF 最寄りOFF:個別設定も無効表示、値は保持 / Master OFF: dependent controls disabled, values retained
文字・マップ切替・戻るを個別に指定 / Independently enable text, switch and Back キー周辺とキー上部ガイドを選択 / Choose around-key or above-key presentation
文字・マップ切替・戻るを個別に指定 / Independently enable text, switch and Back キー周辺とキー上部ガイドを選択 / Choose around-key or above-key presentation
元キーから操作:コンパクトなガイドと矢印・指位置 / Gesture from original key: compact guide, arrow and cursor 離指後:プレビューの入力結果 / Preview result after release
元キーから操作:コンパクトなガイドと矢印・指位置 / Gesture from original key: compact guide, arrow and cursor 離指後:プレビューの入力結果 / Preview result after release

12キーテンプレート / Standard 12-key template

保存済みマップの例:適用前 / Example saved map before replacement 確認:選択キーの全マップを下書きで置換 / Confirm replacing all maps of the selected key in the draft
保存済みマップの例:適用前 / Example saved map before replacement 確認:選択キーの全マップを下書きで置換 / Confirm replacing all maps of the selected key in the draft
適用後:は・ひ・ふ・へ・ほの通常配置 / Applied: standard は/ひ/ふ/へ/ほ arrangement 取り消し:適用前のマップを復元 / Undo restores the previous maps
適用後:は・ひ・ふ・へ・ほの通常配置 / Applied: standard は/ひ/ふ/へ/ほ arrangement 取り消し:適用前のマップを復元 / Undo restores the previous maps
保存:選択キーにテンプレートを反映 / Save applies the selected key template
保存:選択キーにテンプレートを反映 / Save applies the selected key template

枠外での最寄り判定 / Nearest selection outside bounds

OFF:キー右端と右popupの隙間では選択なし / OFF: no selection in the gap to the right 設定から最寄り判定をON / Enable nearest selection in settings
OFF:キー右端と右popupの隙間では選択なし / OFF: no selection in the gap to the right 設定から最寄り判定をON / Enable nearest selection in settings
ON:同じ隙間で最寄りの「へ」を選択 / ON: same gap selects nearest へ その位置で離し「へ」を実IMEで入力 / Release there to enter へ through the real IME
ON:同じ隙間で最寄りの「へ」を選択 / ON: same gap selects nearest へ その位置で離し「へ」を実IMEで入力 / Release there to enter へ through the real IME

上部ガイドでの文字・切替・戻る / Text, switch and Back in the guide

左へ動かす:ひを選択、キー上の矢印とガイド内カーソル / Move left: select ひ with arrow and ring ば行へ切替:到着位置の★を選択 / Switch to custom voiced map: ★ at arrival
左へ動かす:ひを選択、キー上の矢印とガイド内カーソル / Move left: select ひ with arrow and ring ば行へ切替:到着位置の★を選択 / Switch to custom voiced map: ★ at arrival
入り直さず離して★を入力 / Release immediately to enter ★ 戻る操作後:通常マップへ復帰 / Root map restored after Back
入り直さず離して★を入力 / Release immediately to enter ★ 戻る操作後:通常マップへ復帰 / Root map restored after Back
元キーへ戻って離し「は」を入力 / Return to the original key and release to enter は
元キーへ戻って離し「は」を入力 / Return to the original key and release to enter は

フローティングでの同じ操作 / Same operations while floating

左へフリック:文字選択と矢印・カーソル / Floating: text selection, arrow and cursor カスタムマップへ切替し★を選択 / Floating: switch and select ★
左へフリック:文字選択と矢印・カーソル / Floating: text selection, arrow and cursor カスタムマップへ切替し★を選択 / Floating: switch and select ★
離指して★を入力 / Floating: release to enter ★ 戻る操作で通常マップに復帰 / Floating: Back restores the root map
離指して★を入力 / Floating: release to enter ★ 戻る操作で通常マップに復帰 / Floating: Back restores the root map
元キーで離し「は」を入力 / Floating: release on the key to enter は
元キーで離し「は」を入力 / Floating: release on the key to enter は

@KazumaProject
KazumaProject merged commit 9e21949 into dev Nov 13, 2026
1 check passed
@KazumaProject
KazumaProject deleted the codex/free-flick-refinements branch November 13, 2026 17:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant