Repository navigation
iOS: Czech keyboard, and custom words for typing - #2205
Merged
Merged
Conversation
…ip keeps to the sentence's language
A TestFlight tester (build 56, iPhone 17 Pro Max): "I use Czech and English
languages. But it isn't easy to switch between the languages, and
autocomplete suggests English words in Czech too."
Adds KeyboardLanguage.czech ("cs", Čeština), as Polish (#2143) and Greek
(#2184) were added. It matches the standard Czech layout and the system
keyboard's observed long-press options, as the iOS 27.2 simulator's own Czech
keyboard shows them (every letter, 123 and #+= key held for about 3 s with a
real touch, the callout read from the accessibility tree, the
keyboard-provenance survey and converter as since #2140; screenshots checked):
- Rows ("QWERTZ – Czech/Slovak", Apple's default): qwertzuiop / asdfghjkl´ /
yxcvbnmˇ. Rows 1 and 2 are ten keys edge to edge, row 3 starts under s, and
shift and delete are a letter wide.
- Layouts (#2172): Apple's Add New Keyboard › Czech offers only "QWERTZ –
Czech/Slovak" and "QWERTY – Czech/Slovak" (read through accessibility), so
Czech offers .own ("QWERTZ – Čeština") and .qwerty ("QWERTY – Čeština"),
which is its own rows with Z and Y swapped, both keys kept, as the system
QWERTY variant's keys read.
- The ´ (U+00B4) and ˇ (U+02C7) keys are not dead keys. Observed in Messages
with real touches, every letter followed by each key: each accents the
letter right before it, ´ -> á ć é í ĺ ń ó ŕ ś ú ý ź, ˇ -> č ď ě ľ ň ř š ť ž
and ů after u; capitals too (A´ -> Á, Cˇ -> Č); after anything else (aˇ,
x´, á´, a space, nothing) the key types itself; delete then removes the
accented letter whole. A held ˇ offers ˚, which makes ů and å. CzechTyping
holds these rules; FullKeyboardEngine dispatches Greek's and Czech's
through typeLayoutRules (the file stays under the 1,500-line cap).
- letterHolds: e ě é ê è ę ë ē ė; r ř ŕ; t ť; z ż ź ž; u ú ů û ü ù ū;
i í î ï ì į ī; o ó ô ö ò õ œ ø ō; a á à ą â ä æ ã å ā; s š ß ś; d ď;
l ł ľ ĺ; y ý ÿ; c č ç ć; n ň ñ ń; ˇ ˚. Nothing on ´ or any other key.
Callouts are laid out as the system's (AccentCatalog.arrangement, e.g.
ě e é …). 123/#+= pages and every symbol hold are English's (& § read too).
Autocorrect uses iOS's cs dictionary through the dictionary engine (no typing
model). Missing háčky and čárky are the cheapest fix, however many, as Polish
diacritics are (0.15 plus 0.05 each further one): "cesky" -> "český",
"prilis" -> "příliš". Czech has Latin letters, so it pairs with English for
bilingual autocorrect (#2186), and #2143's any-word partner guard applies.
cs/cs-CZ picks the layout automatically, the space bar says "Čeština", Hex's
next-word lists get Czech entries, and snapshot scenes take
--keyboard-layout cs.
Sentence language in the strip: with two languages the strip interleaved
both languages' candidates whatever the words before were, so a Czech
sentence always showed an English word in a slot. Now a sentence that leans
one language (languageLean, as autocorrect already uses) gets only that
language's candidates, even where it has none: live in Messages, the
simulator's Czech dictionary completed nothing for "ku" after "Příliš
žluťoučký", and English filled the strip with "kurtosis" and "kudos". With no
words before, both languages' in turn, as before. Autocorrect itself is unchanged (#2186: an
English typo in a mixed French sentence is still fixed; a stricter rule broke
testTheFrenchKeyboardFixesEnglishTyposWithEnglishBesideIt, so it was dropped).
Dictation: cs-CZ goes through Apple Speech, never Parakeet (English-only).
macOS 27.2.1 lists cs-CZ for DictationTranscriber only; say -v Zuzana clips
came back with every háček and čárka, numbers as digits ("10 min.", "19:30")
and no punctuation. Dictation follows the keyboard's language (#2164), and
Apple's Settings offers "Add to English (US) Keyboard" for Czech, as for
French; Hex keeps Czech on its own keys beside English, as it does French.
Live (iPhone 17 Pro simulator, Hex's keyboard in Messages, real HID touches):
typed "Příliš žluťoučký kůň" with ´, ˇ and a held ˚.
Verified (iPhone 17 Pro simulator, iOS 27.2, Mac Studio): KeyboardLayoutTests,
FullKeyboardEngineTests, AutocorrectEngineTests, DictationControllerTests and
TranscriptCleanupTests pass (with new Czech cases: rows, layouts, holds,
arrangements, automatic pick, partner, typing "Příliš žluťoučký kůň" through
´ ˇ and a held ˚, the marks' fallbacks, capitals and delete, missing-diacritic
fixes on a stub dictionary, the strip's language order, cs-CZ from
DictationTranscriber, Polished/Casual/Lowercase), and the full HEXMobile
suite passes with the custom-words change on top, rebased on origin/dev
68f18a3 (619 tests, 1 skipped, 0 failures). Rebased onto #2192 (no
clearPendingUndo before a mark's accent, as GreekTyping) and #2199 (Czech's
inputModeLanguage is cs-CZ).
…e strip, and no added capitals in the strip
A TestFlight tester (build 56): "Feat req: custom dictionary for uncommon
programmer slang. Also, even with auto-capitalization off, many suggested
words are capitalized."
What reached the full keyboard before: iOS's text replacements and Contacts
names (requestSupplementaryLexicon -> loadLexicon: a replacement whose phrase
is its shortcut counts as a word). Hex's own custom vocabulary
(CustomVocabularySettings, Settings › Dictation) was dictation only; nothing
in the keys read it.
Custom words (AutocorrectEngine+Vocabulary, setVocabulary):
- The keyboard reads CustomVocabularySettings.terms (the one list dictation
spells with), whether or not dictation's switch is on, at open and on each
settings sync; a bilingual partner gets the same list.
- Its words, and each word of a phrase, join your own words (lexiconTerms):
never autocorrected away, no spelling guesses for them, a different case
put right on space ("github" -> "GitHub"), completed in the strip before
the dictionary's words ("kub" -> "kubectl"), and Swipe typing reads them
(ownWords) and the Spatial decoder (userWords) knows them.
- Settings › Keyboard › Vocabulary (with the full keyboard): how many words,
and a page with the same editor as Dictation's, its footer saying how to
add from the keys. Dictation's editor is unchanged.
- In the keys: hold the strip's left slot (the word you typed) and the strip
offers "Add to vocabulary" in the notice shape (title, "Never
autocorrected", chip). The chip saves it to the App Group and uses it at
once; typing dismisses it. A capital only the sentence's start gave the
word ("Nginx" opening a message) is left out. Without Full Access the
keyboard can't write the App Group, so the word lasts the session.
- New strings with zh-Hans: Vocabulary, its row's two details (one plural),
the page footer, Add to vocabulary, Never autocorrected.
Capitals with Auto-capitalization off, checked on origin/dev (a0a7da5) with
a throwaway test: autocorrect itself was right (#2173: "mondy" -> "monday"),
but the strip still offered "Mandy" (a guess iOS knows capitalised), "I'd"
for "id" (suggest-only contractions), and "Monday" as a completion of "mon".
Now, with it off and nothing typed in capitals, the strip lowercases every
candidate that isn't your own spelling (a vocabulary word, Contacts name,
text replacement, kept word or learned fix), and drops one that becomes what
you typed. Unchanged: sentence and clause starters, which keep "I" and "I'm"
(#2135, testSentenceStartersAndNextWordsFillAllThreeSlots), next words (the
model is lowercase), swipe readings (#2173's swipeCased), and a capital you
typed. AutocorrectEngine stays under the 1,500-line cap: the strip rule,
withoutStrayCapital and previousWord moved, unchanged, to the case-matching
file (AutocorrectEngine+Distance).
Verified (iPhone 17 Pro simulator, iOS 27.2, Mac Studio):
- Full HEXMobile suite, rebased on origin/dev 68f18a3: 619 tests, 1
skipped, 0 failures, with new
AutocorrectEngineTests.testVocabularyWordsAreKeptSpelledYourWayAndCompleted,
testAutoCapitalizationOffSuggestsNoCapitals and
FullKeyboardEngineTests.testSwipeTypesYourVocabularyWords ("kubectl" isn't
swiped before it is in the list, is after).
- Live, Hex's keyboard in Messages with real touches: typed "Nginx" at a
message's start, held the left slot ("nginx" offered), tapped Add to
vocabulary (the App Group then held "nginx" in customVocabulary.terms);
"ngi" then offered "nginx" in the strip, picked it, and "nginx " stayed as
typed. The same with "kubectl" before the rebase.
Settings › Keyboard showed "Vocabulary, 3 words autocorrect keeps and
suggests" and its page, in English and zh-Hans.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two TestFlight requests (build 56).
1. Czech keyboard (bc8adad): KeyboardLanguage.czech (Čeština). It matches the standard Czech layout and the system keyboard's observed long-press options: QWERTZ with the ´ and ˇ keys, and Apple's QWERTY – Czech/Slovak variant (#2172). Every key was held with a real touch on the iOS 27.2 simulator. ´ and ˇ accent the letter before them, as the system keyboard does (observed in Messages). Missing háčky and čárky are a cheap autocorrect edit. Dictation in cs-CZ goes through Apple Speech. With two languages, the strip only offers words in the language the sentence is in, so no English completions show in a Czech sentence.
2. Custom words for typing (65dbfd8): Hex's vocabulary list now reaches the full keyboard. Its words are never autocorrected away, are spelled your way, are completed in the strip, and can be swiped. Edit the list in Settings › Keyboard › Vocabulary, or hold a typed word in the strip and tap Add to vocabulary. zh-Hans strings included. With Auto-capitalization off, the strip no longer offers capitals you didn't type ("Mandy", "I'd", "Monday").
The commit messages have the full details, the observations and how each part was verified.
Verified: xcodebuild test, 619 tests, 1 skipped, 0 failures (iPhone 17 Pro simulator, iOS 27.2); generic iOS build with CODE_SIGNING_ALLOWED=NO succeeds. Live in Messages with Hex's keyboard: typed "Příliš žluťoučký kůň", and added and typed a custom word.