Merge pull request #11105 from keymanapp/chore/merge-beta-to-master-b…

…17s4

chore(common): Merge beta to master for Sprint B17S4

HISTORY.md

@@ -48,6 +48,53 @@
 * chore(common): move to 18.0 alpha (#10713)
 * chore: move to 18.0 alpha
 
+## 17.0.296 beta 2024-03-27
+
+* fix(developer): in model compiler, give correct key to shorter prefix words when a longer, higher-frequency word is also present (#11074)
+* fix(oem/fv/android): Only add default keyboard if no keyboards exist (#11080)
+*  (#11068)
+* chore(android): Update crowdin strings for Mon (#11089)
+* chore(android): Update crowdin strings for Khmer (#11090)
+
+## 17.0.295 beta 2024-03-26
+
+* docs(developer): add help site links (#10939)
+* chore(common): Update keymanweb-osk.ttf to 4.1 (#11035)
+* feat(linux): Start dbus if not running (#10863)
+
+## 17.0.294 beta 2024-03-25
+
+* chore(android,windows): Update crowdin strings for French (#11063)
+* chore(common): Fix missing entries in HISTORY.md (#11064)
+* fix(developer): catch sharing violation when saving mru (#11047)
+* fix(developer): capture alt shortcuts in LDML keyboard debugger (#11049)
+* fix(developer): correct path for kmc sourcemaps in sentry upload (#11051)
+
+## 17.0.293 beta 2024-03-22
+
+* chore(oem/fv): Update keyboard versions in keyboards.csv (#11013)
+* fix(developer): suppress emission of new empty fields in package editor (#11009)
+* fix(developer): return after calling await exitProcess (#11016)
+* chore(core): refresh API docs for 17.0 (#10986)
+
+## 17.0.292 beta 2024-03-21
+
+* fix(developer): remove unused keyboard info compiler messages (#10991)
+* fix(developer): font file meta data is invalid error (#10995)
+
+## 17.0.291 beta 2024-03-20
+
+* chore(mac): clean up code obsoleted by core (#10877)
+* fix(linux): Replace deprecated `pkg_resources` module with `packaging.version` (#10860)
+
+## 17.0.290 beta 2024-03-19
+
+* fix(ios): Sync selection range for long contexts (#10956)
+
+## 17.0.289 beta 2024-03-16
+
+* fix(common): add unit test for --debug flag for builder (#10974)
+
 ## 17.0.288 beta 2024-03-13
 
 * test(developer): kmc keyboard info compiler messages unit tests (#10848)
@@ -84,9 +131,9 @@
 
 * fix(android): fixes context-change detection for repeated-char cases (#10873)
 * fix(developer): search-term quote replacement was not global (#10934)
-*  (#10913)
+* chore(common): Update ldml out of techpreview (#10913)
 * fix(developer): fix for errant \uXXXX error (#10946)
-*  (#10948)
+* fix(developer): suppport loose match for CompilerEvents (#10948)
 * refactor(oem/fv/android): Install fallback keyboard (#10907)
 * refactor(android/app): Move storage permission checks (#10904)
 * fix(common): missing script exec bit (#10951)
@@ -126,7 +173,7 @@
 ## 17.0.278 beta 2024-02-28
 
 * docs(linux): Updated whatsnew for Keyman for Linux 17 (#10858)
-*  (#10869)
+* fix(web): Save context state on reset (#10869)
 * chore(android/engine): Reduce toast notifications after installations (#10868)
 * fix(android/engine): Check selection indexes (#10857)
 
@@ -148,7 +195,7 @@
 
 ## 17.0.275 beta 2024-02-23
 
-*  (#10791)
+* chore(core): Update sample ldml keyboard (#10791)
 * fix(developer): publish keymancore-1.dll symbols (#10797)
 * fix(developer): improve uploading of sourcemaps to sentry (#10798)
 * fix(android/engine): Fix how keyboard picker menu exits (#10806)
@@ -183,7 +230,7 @@
 * fix(core): fix output append logic in any_group::apply_transform (#10758)
 * fix(android): Match phone suggestion banner styling on tablet (#10760)
 * docs(mac): Document What's New for version 17.0 (#10764)
-*  (#10773)
+* fix(developer): Rename missing variables in tests (#10773)
 * chore(developer): reduce WARN_TouchLayoutUsesUnsupportedGesturesDownlevel to HINT (#10766)
 * fix(developer): prevent renaming of new project types in New Project dialog (#10767)
 * fix(developer): return an error code if build-test-data fails (#10765)
@@ -201,14 +248,14 @@
 * fix(web): sticky special-key highlighting (#10729)
 * fix(web): disables modipress for layer-switch keys with subkeys (#10745)
 * fix(web): missing null-guard for hardware keystrokes without active Keyman keyboard (#10740)
-* docs(ios): what's new in 17.0 (#10748)
+* docs(ios): add what's new in 17.0 (#10748)
 * fix(web): handling of page-elements focused before engine initialization (#10744)
 * fix(ios): multitap consistency after new-lines (#10728)
 * docs(common): Update website README (#10738)
 
 ## 17.0.270 beta 2024-02-17
 
-*  (#10735)
+* fix(core): Update more tests and fix ldml_transforms (#10735)
 
 ## 17.0.269 beta 2024-02-15
 

android/KMAPro/kMAPro/src/main/res/values-fr-rFR/strings.xml

@@ -53,6 +53,7 @@
   <string name="request_storage_permission" comment="Request storage permission to access keyboard packages">    Pour installer des packages du clavier, autoriser Keyman à lire le stockage externe.</string>
   <!-- Context: Android Storage Permission -->
   <string name="storage_permission_denied" comment="Keyboard package installation may fail since Android storage permission not granted">    La demande de permission de stockage a été refusée. Peut ne pas installer le package clavier</string>
+  <string name="storage_permission_denied2" comment="Keyboard package installation failed. Recommend install from local file">    Storage permission request failed. Try Keyman Settings - Install from local file</string>
   <!-- Context: Keyman Settings menu -->
   <string name="keyman_settings" comment="Settings menu title">Paramètres</string>
   <!-- Context: Keyman Settings menu -->

android/KMAPro/kMAPro/src/main/res/values-km-rKH/strings.xml

@@ -53,6 +53,7 @@
   <string name="request_storage_permission" comment="Request storage permission to access keyboard packages">    ដើម្បី​ដំឡើង​កញ្ចប់​ក្ដារ​ចុច សូម​អនុញ្ញាត​ឱ្យ Keyman មាន​សិទ្ធិ​អាន​ឧបករណ៍​ផ្ទុក​ខាង​ក្រៅ។</string>
   <!-- Context: Android Storage Permission -->
   <string name="storage_permission_denied" comment="Keyboard package installation may fail since Android storage permission not granted">សំណើ​សុំ​សិទ្ធិ​ចូល​ប្រើ​ឧបករណ៍​ផ្ទុក​ត្រូវ​បាន​បដិសេធ។ អាច​បរាជ័យ​ក្នុង​ការដំឡើង​កញ្ចប់​ក្ដារចុច</string>
+  <string name="storage_permission_denied2" comment="Keyboard package installation failed. Recommend install from local file">សំណើ​សុំ​សិទ្ធិ​ចូល​ប្រើ​ឧបករណ៍​ផ្ទុក​ត្រូវ​បានបរាជ័យ។ សូមទៅកាន់ការកំណត់ Keyman - ដំឡើង​ពី​​​ឧបករណ៍នេះ</string>
   <!-- Context: Keyman Settings menu -->
   <string name="keyman_settings" comment="Settings menu title">ការ​កំណត់</string>
   <!-- Context: Keyman Settings menu -->

android/KMAPro/kMAPro/src/main/res/values-mnw-rMM/strings.xml

@@ -53,6 +53,7 @@
   <string name="request_storage_permission" comment="Request storage permission to access keyboard packages">သွက်ဂွံစုတ်ပက်ကေကဳဗုဒ်ဂမၠိုၚ်ကီု, သွက်ဂွံဗှ်အရာမစွံပ္တန်လဝ်မ္ၚးတအ်မာန်ကီုဂှ် ပံက်ကဵုအခေါၚ် ကဳမာန်ညိ</string>
   <!-- Context: Android Storage Permission -->
   <string name="storage_permission_denied" comment="Keyboard package installation may fail since Android storage permission not granted">အခေါၚ်သွက်ဂွံစွံပ္တန်ဂှ် တးပါဲလဝ်ရ။ သွက်ဂွံစုတ်ပက်ကုက်ကဳဗုဒ်လေဝ် လီုအာမာန်ရ။</string>
+  <string name="storage_permission_denied2" comment="Keyboard package installation failed. Recommend install from local file">ကေတ်အခေါၚ် ဒၞါဲဂိုၚ်စွံဟွံအံၚ်ဇၞး။ စမ်ရံၚ်ဒၞါဲပလေဝ်ပလေတ်ကဳမာန် - ပ္တိုန်စုတ်နူဝှါၚ် လဵုဂေဝ်</string>
   <!-- Context: Keyman Settings menu -->
   <string name="keyman_settings" comment="Settings menu title">ဒၞါဲပလေဝ်နာနာ</string>
   <!-- Context: Keyman Settings menu -->

android/KMEA/app/src/main/res/values-fr-rFR/strings.xml

@@ -107,7 +107,7 @@
     <string name="dictionary_download_start_in_background" comment="Notification that a dictionary download has started">Le téléchargement du dictionnaire a commencé en arrière-plan</string>
     <!-- Context: Background download messages-->
     <string name="dictionary_download_is_running_in_background" comment="Notification that a dictionary download is still running">Le dictionnaire sélectionné est déjà en cours de téléchargement ; veuillez réessayer dans un instant !</string>
-    <!-- Context: Background download messages-->
+    <!-- Context: Background download messages. Removed in Keyman 17-->
     <string name="dictionary_download_finished" comment="Notification that a dictionary download has finished">Téléchargement du dictionnaire terminé.</string>
     <!-- Context: Background download messages -->
     <string name="download_failed" comment="Notification that a download failed">Échec du téléchargement</string>
@@ -119,7 +119,7 @@
     <string name="update_check_current" comment="Notification that all resources are up to date">"Toutes les ressources sont à jour !"</string>
     <!-- Context: General Updates -->
     <string name="update_failed" comment="Notification that a resource update failed">Une ou plusieurs ressources n\'ont pas pu être mises à jour !</string>
-    <!-- Context: General Updates -->
+    <!-- Context: General Updates. Removed in Keyman 17 -->
     <string name="update_success" comment="Notification that a resource update successfully updated">Ressources mises à jour avec succès !</string>
     <!-- Context: Model Info -->
     <string name="model_version" comment="Title for a dictionary version">Version du dictionnaire</string>

android/KMEA/app/src/main/res/values-km-rKH/strings.xml

@@ -105,7 +105,7 @@
     <string name="dictionary_download_start_in_background" comment="Notification that a dictionary download has started">ការទាញយកបញ្ជី​ពាក្យបាន​ចាប់ផ្ដើម​ក្នុង​ផ្ទៃ​ខាងក្រោយ</string>
     <!-- Context: Background download messages-->
     <string name="dictionary_download_is_running_in_background" comment="Notification that a dictionary download is still running">បញ្ជី​ពាក្យ​ដែល​បាន​ជ្រើសរើស​នេះ​កំពុង​ទាញយកហើយ សូម​ព្យាយាម​ម្ដងទៀត​ក្នុង​ពេល​ឆាប់ៗ នេះ!</string>
-    <!-- Context: Background download messages-->
+    <!-- Context: Background download messages. Removed in Keyman 17-->
     <string name="dictionary_download_finished" comment="Notification that a dictionary download has finished">ការទាញយកបញ្ជី​ពាក្យបាន​ចប់​សព្វគ្រប់​ហើយ!</string>
     <!-- Context: Background download messages -->
     <string name="download_failed" comment="Notification that a download failed">ការទាញយកបានបរាជ័យ</string>
@@ -117,7 +117,7 @@
     <string name="update_check_current" comment="Notification that all resources are up to date">"ធនធានទាំង​អស់​គឺ​ថ្មី​បំផុត​ហើយ!"</string>
     <!-- Context: General Updates -->
     <string name="update_failed" comment="Notification that a resource update failed">ធនធាន​មួយ​ឬ​ច្រើន​បាន​បរាជ័យ​ក្នុង​ការអាប់ដេត!</string>
-    <!-- Context: General Updates -->
+    <!-- Context: General Updates. Removed in Keyman 17 -->
     <string name="update_success" comment="Notification that a resource update successfully updated">បាន​អាប់ដេត​ធនធាននានា​ដោយ​ជោគជ័យ!</string>
     <!-- Context: Model Info -->
     <string name="model_version" comment="Title for a dictionary version">ជំនាន់​របស់បញ្ជី​ពាក្យ</string>

android/KMEA/app/src/main/res/values-mnw-rMM/strings.xml

@@ -105,7 +105,7 @@
     <string name="dictionary_download_start_in_background" comment="Notification that a dictionary download has started">ပွမဂြဲ​ဂၠောၚ်ဖျေံဒၟံၚ် အဘိဓာန်ဂှ် ​ဍေံပ္တံလဝ်ပ္ဍဲလက်ကရဴတေံ</string>
     <!-- Context: Background download messages-->
     <string name="dictionary_download_is_running_in_background" comment="Notification that a dictionary download is still running">အဘိဓာန်ရုဲစှ်လဝ်ဂှ် အဃောဂၠောၚ်ဂြဲ​ဖျေံဒၟံၚ်ရောင်။ မၚ်မွဲချိုန်ခဏတုဲ ဆက်ဂစာန်ပၠန်ညိ!</string>
-    <!-- Context: Background download messages-->
+    <!-- Context: Background download messages. Removed in Keyman 17-->
     <string name="dictionary_download_finished" comment="Notification that a dictionary download has finished">​​​​ဂၠောၚ်ဂြဲဖျေံအဘိဓာန်အာစိုပ်ဒတုဲ။</string>
     <!-- Context: Background download messages -->
     <string name="download_failed" comment="Notification that a download failed">​တံၚ်ဂြဲဖျေံဟွံအံၚ်ဇၞး</string>
@@ -117,7 +117,7 @@
     <string name="update_check_current" comment="Notification that all resources are up to date">"တံရိုဟ်ဖအိုတ်ဂှ် ဒှ်တၟိရ!"</string>
     <!-- Context: General Updates -->
     <string name="update_failed" comment="Notification that a resource update failed">သၠုၚ်ပ္တိုန်ကဆံၚ် တံရိုဟ် မွဲဟွံသေၚ်မွဲ ဟွံအံၚ်ဇၞး!</string>
-    <!-- Context: General Updates -->
+    <!-- Context: General Updates. Removed in Keyman 17 -->
     <string name="update_success" comment="Notification that a resource update successfully updated">သမၠုၚ်ပ္တိုန်ကဆံၚ်တံရိုဟ်အံၚ်ဇၞး!</string>
     <!-- Context: Model Info -->
     <string name="model_version" comment="Title for a dictionary version">ပါယှေန်အဘိဓာန်</string>

common/windows/delphi/packages/PackageInfo.pas

@@ -1857,7 +1857,8 @@ procedure TPackage.DoSaveXML(ARoot: IXMLNode);
   Keyboards.SaveXML(ARoot);
   if LexicalModels.Count > 0 then
     LexicalModels.SaveXML(ARoot);
-  RelatedPackages.SaveXML(ARoot);
+  if RelatedPackages.Count > 0 then
+    RelatedPackages.SaveXML(ARoot);
 end;
 
 procedure TPackage.SaveIni;
@@ -2742,6 +2743,9 @@ procedure TPackageKeyboardExampleList.SaveXML(ARoot: IXMLNode);
   j: Integer;
   AExample: IXMLNode;
 begin
+  if Count = 0 then
+    Exit;
+
   AExamples := ARoot.AddChild(SXML_PackageKeyboard_Examples);
   for j := 0 to Count - 1 do
   begin

core/doc/markdown_files/index.md

@@ -59,3 +59,14 @@ Caps Lock.
 ### Namespace
 
 All calls, types and enums are prefixed with the namespace identifier `km_core_`
+
+### Changes from 16.0
+
+* The namespace identifier has changed from `km_kbp_` to `km_core_`.
+* Most context APIs are now private, and `km_core_context_set_if_needed` is the
+  primary context function. Private APIs are available in
+  `keyman_core_api_context.h`.
+* The action queue APIs are now private and deprecated. Instead, use
+  `km_core_state_get_actions`. Private APIs are available in
+  `keyman_core_api_actions.h`.
+* Debug APIs are available in `keyman_core_api_debug.h`.