auto: A19S36 merge epic/web-core into kmc-test ↙️

HISTORY.md

@@ -1,5 +1,30 @@
 # Keyman Version History
 
+## 19.0.266 alpha 2026-08-13
+
+* chore(deps-dev): bump esbuild from 0.25.0 to 0.28.1 (#16095)
+* feat(web): add `keyman.versionInfo` API (#16351)
+* fix(web): cleanup `loaduserinterface` and `unloaduserinterface` events (#16353)
+* docs(web): deprecate unused and obsolete API endpoints and docs cleanup (#16354)
+* chore(common): cleanup and merge Preprocessor constants (#14360)
+
+## 19.0.265 alpha 2026-08-12
+
+* fix(core): make coherence check a debug assert (#16343)
+* feat(windows): honour Windows "metered connection" flag for downloading updates (#16099)
+
+## 19.0.264 alpha 2026-08-11
+
+* docs(android): update keyboardharness readme (#16220)
+* feat(android): design improvement for settings, add dark mode and tool menu (#15827)
+
+## 19.0.263 alpha 2026-08-10
+
+* chore(deps): bump tar from 7.5.11 to 7.5.22 in /developer/src/server/src/win32/trayicon/addon-src (#16282)
+* chore(deps): bump brace-expansion from 5.0.6 to 5.0.9 in /developer/src/server/src/win32/trayicon/addon-src (#16295)
+* refactor(web): improve naming of `_SetTargetDir` function (#16311)
+* docs(web): add language identifier to the code blocks of event docs (#16333)
+
 ## 19.0.262 alpha 2026-08-04
 
 * chore(web): fire `keyboardloaded` event only once per keyboard (#16297)

VERSION.md

@@ -1 +1 @@
-19.0.263
+19.0.267

android/KMAPro/kMAPro/src/main/AndroidManifest.xml

@@ -17,21 +17,22 @@
   https://support.google.com/googleplay/android-developer/answer/9214102#
   <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" /> -->
   <application
+    android:name=".KeymanApplication"
     android:allowBackup="true"
     android:hardwareAccelerated="true"
+    android:theme="@style/AppTheme"
     android:icon="@mipmap/ic_launcher"
     android:label="@string/app_name"
     android:resizeableActivity="false"
     android:usesCleartextTraffic="true"
-    android:theme="@style/AppTheme"
-    android:supportsRtl="true">
+    android:supportsRtl="true"
+     >
     <receiver android:name=".NetworkStateReceiver"
       android:exported="true">
       <intent-filter>
         <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
       </intent-filter>
     </receiver>
-
     <!--    see the events from this app in sentry.keyman.com dashboard -->
     <meta-data
       android:name="io.sentry.dsn" android:value="https://2f067e5571a74974b9e210ca76ca9607@o1005580.ingest.sentry.io/5983520" />
@@ -65,7 +66,7 @@
       android:exported="true"
       android:label="@string/app_name"
       android:resizeableActivity="false"
-      android:theme="@style/AppTheme.BrandedLaunch">
+      android:theme="@style/Theme.App.Starting">
       <intent-filter>
         <action android:name="android.intent.action.MAIN" />
 
@@ -241,23 +242,17 @@
       android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize"
       android:label="@string/app_name"
       android:launchMode="singleTask"
-      android:theme="@style/AppTheme.Light.Dialog"/>
-    <activity
-      android:name=".KeymanSettingsActivity"
-      android:label="@string/keyman_settings"
-      android:parentActivityName=".MainActivity"
-      android:launchMode="singleTask"
-      android:theme="@style/AppTheme.Base" />
+      android:theme="@style/AppTheme.Dialog"/>
     <activity
       android:name=".KeymanSettingsInstallActivity"
       android:label="@string/app_name"
-      android:parentActivityName=".KeymanSettingsActivity"
+      android:parentActivityName=".MainActivity"
       android:launchMode="singleTask"
       android:theme="@style/AppTheme.Base" />
     <activity
       android:name=".KeymanSettingsLocalizeActivity"
       android:label="@string/app_name"
-      android:parentActivityName=".KeymanSettingsActivity"
+      android:parentActivityName=".MainActivity"
       android:launchMode="singleTask"
       android:theme="@style/AppTheme.Base" />
     <activity
@@ -275,7 +270,7 @@
       android:name=".KeyboardSettingsActivity"
       android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize"
       android:label="@string/app_name"
-      android:theme="@style/AppTheme.Light.Dialog" />
+      android:theme="@style/AppTheme.Dialog" />
     <activity
       android:name=".SelectPackageActivity"
       android:label="@string/app_name"

android/KMAPro/kMAPro/src/main/assets/banner.html

@@ -1,8 +1,18 @@
 <!-- Custom banner theme -->
-<div style="background: white; width: 100%; height: 100%; position: absolute; left: 0; top: 0; display: flex">
+<style>
+  .keyman-banner { background: white; }
+  .keyman-banner.dark { background: #1e1e1e; }
+
+  .keyman-banner .logo-dark { display: none; }
+  .keyman-banner.dark .logo-light { display: none; }
+  .keyman-banner.dark .logo-dark { display: block; }
+</style>
+
+<div class="keyman-banner" style="width: 100%; height: 100%; position: absolute; left: 0; top: 0; display: flex">
 
   <!-- svg path is relative to assets/ folder -->
-  <img src="banner/keyman_banner.svg" style="height:60%; background: white; display: block; margin: auto 2%;">
+  <img class="logo-light" src="banner/keyman_banner.svg" style="height:60%; margin: auto 2%;">
+  <img class="logo-dark" src="banner/keyman_banner_dark.png" style="height:60%; margin: auto 2%;">
 
   <!-- Tri-color line -->
   <div style='height: 7%; left: 0; position: absolute; bottom: 0; width: 56%; background: #F68924'></div>

android/KMAPro/kMAPro/src/main/java/com/keyman/android/BannerController.java

@@ -13,7 +13,7 @@ public class BannerController {
   public static final String KM_BANNER_DIR = "banner";
   public static final String KM_BANNER_THEME_KEYMAN = "banner.html";
 
-  public static void setHTMLBanner(Context context, KMManager.KeyboardType keyboardType) {
+  public static void setHTMLBanner(Context context, KMManager.KeyboardType keyboardType, boolean isDarkMode) {
     if (keyboardType == KMManager.KeyboardType.KEYBOARD_TYPE_UNDEFINED) {
       return;
     }
@@ -22,6 +22,9 @@ public static void setHTMLBanner(Context context, KMManager.KeyboardType keyboar
 
     // Always use Keyman banner theme
     String contents = FileUtils.readContents(context, KM_BANNER_THEME_KEYMAN);
+    if (isDarkMode) {
+      contents = contents.replace("class=\"keyman-banner\"", "class=\"keyman-banner dark\"");
+    }
     KMManager.setHTMLBanner(keyboardType, contents);
     KMManager.setBanner(keyboardType, KMManager.BannerType.HTML);
     KMManager.showBanner(true);

android/KMAPro/kMAPro/src/main/java/com/keyman/android/SystemKeyboard.java

@@ -7,7 +7,7 @@
 import com.keyman.engine.util.DownloadFileUtils;
 import com.tavultesoft.kmapro.BuildConfig;
 import com.tavultesoft.kmapro.DefaultLanguageResource;
-import com.tavultesoft.kmapro.KeymanSettingsActivity;
+import com.tavultesoft.kmapro.KeymanSettingsKeys;
 import com.tavultesoft.kmapro.PreferencesManager;
 import com.keyman.engine.KMManager;
 import com.keyman.engine.KMManager.KeyboardType;
@@ -76,13 +76,13 @@ public void onCreate() {
     KMManager.setInputMethodService(this); // for HW interface
 
     SharedPreferences prefs = context.getSharedPreferences(context.getString(R.string.kma_prefs_name), Context.MODE_PRIVATE);
-    KMManager.SpacebarText spacebarText = KMManager.SpacebarText.fromString(prefs.getString(KeymanSettingsActivity.spacebarTextKey, KMManager.SpacebarText.LANGUAGE_KEYBOARD.toString()));
+    KMManager.SpacebarText spacebarText = KMManager.SpacebarText.fromString(prefs.getString(KeymanSettingsKeys.SPACEBAR_TEXT, KMManager.SpacebarText.LANGUAGE_KEYBOARD.toString()));
     KMManager.setSpacebarText(spacebarText);
 
     // Set the system keyboard HTML banner
-    BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM);
+    BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM, isDarkMode());
 
-    boolean mayHaveHapticFeedback = prefs.getBoolean(KeymanSettingsActivity.hapticFeedbackKey, false);
+    boolean mayHaveHapticFeedback = prefs.getBoolean(KeymanSettingsKeys.HAPTIC_FEEDBACK, false);
     KMManager.setHapticFeedback(mayHaveHapticFeedback);
 
     // Checking for updates should never be allowed to crash the keyboard.
@@ -176,7 +176,7 @@ public void onStartInput(EditorInfo attribute, boolean restarting) {
     if (KMManager.getPredictionsSuspended(KeyboardType.KEYBOARD_TYPE_SYSTEM)) {
       KMManager.setBannerOptions(false);
       // Set the system keyboard HTML banner
-      BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM);
+      BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM, isDarkMode());
     } else if (KMManager.isKeyboardLoaded(KeyboardType.KEYBOARD_TYPE_SYSTEM)){
       // Check if predictions needs to be re-enabled per Settings preference
       Keyboard kbInfo = KMManager.getCurrentKeyboardInfo(appContext);
@@ -282,15 +282,15 @@ public void onKeyboardLoaded(KeyboardType keyboardType) {
   @Override
   public void onKeyboardChanged(String newKeyboard) {
     // Refresh banner theme
-    BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM);
+    BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM, isDarkMode());
     KMManager.showSystemKeyboard();
     sendCurrentFontName();
   }
 
   @Override
   public void onKeyboardShown() {
     // Refresh banner theme
-    BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM);
+    BannerController.setHTMLBanner(this, KeyboardType.KEYBOARD_TYPE_SYSTEM, isDarkMode());
   }
 
   @Override
@@ -309,7 +309,7 @@ public boolean onEvaluateInputViewShown() {
 
     Context context = getApplicationContext();
     SharedPreferences prefs = context.getSharedPreferences(PreferencesManager.kma_prefs_name, Context.MODE_PRIVATE);
-    boolean showOSK = prefs.getBoolean(KeymanSettingsActivity.oskWithPhysicalKeyboardKey, false);
+    boolean showOSK = prefs.getBoolean(KeymanSettingsKeys.OSK_WITH_PHYSICAL_KEYBOARD, false);
     return showOSK;
   }
 
@@ -349,4 +349,8 @@ public boolean onKeyMultiple(int keyCode, int count, KeyEvent event) {
   public boolean onKeyLongPress(int keyCode, KeyEvent event) {
     return interpreter.onKeyLongPress(keyCode, event);
   }
+  private boolean isDarkMode() {
+    return (getResources().getConfiguration().uiMode &
+      Configuration.UI_MODE_NIGHT_MASK) == Configuration.UI_MODE_NIGHT_YES;
+  }
 }

android/KMAPro/kMAPro/src/main/java/com/tavultesoft/kmapro/GetStartedActivity.java

@@ -16,15 +16,15 @@
 import android.provider.Settings;
 import android.view.View;
 import android.view.Window;
-import android.view.inputmethod.InputMethodInfo;
+
 import android.view.inputmethod.InputMethodManager;
 import android.widget.AdapterView;
 import android.widget.CheckBox;
 import android.widget.CompoundButton;
 import android.widget.CompoundButton.OnCheckedChangeListener;
 import android.widget.ImageButton;
 import android.widget.ListView;
-import androidx.appcompat.app.AppCompatActivity;
+
 import android.content.Context;
 import android.content.Intent;
 import android.content.SharedPreferences;
@@ -36,14 +36,25 @@ public class GetStartedActivity extends BaseActivity {
   private static ArrayList<HashMap<String, String>> list = null;
   private static KMListAdapter listAdapter = null;
   protected static final String showGetStartedKey = "ShowGetStarted";
+  public static final String openDefaultKeyboardPickerOnlyKey = "OpenDefaultKeyboardPickerOnly";
   private final String iconKey = "icon";
   private final String textKey = "text";
   private final String isEnabledKey = "isEnabled";
+  private boolean openDefaultKeyboardPickerOnly = false;
+  private boolean didAutoOpenDefaultKeyboardPicker = false;
 
   @Override
   protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     supportRequestWindowFeature(Window.FEATURE_NO_TITLE);
+    openDefaultKeyboardPickerOnly = getIntent().getBooleanExtra(openDefaultKeyboardPickerOnlyKey, false);
+
+    if (openDefaultKeyboardPickerOnly) {
+      // Picker-only mode: intentionally skip rendering Get Started UI.
+      KMManager.dontCloseParentAppOnShowKeyboardPicker();
+      return;
+    }
+
     final Context context = this;
     setContentView(R.layout.get_started_list_layout);
 
@@ -161,20 +172,40 @@ protected void onResume() {
     super.onResume();
   }
 
-  @Override
-  protected void onPause() {
-    super.onPause();
-  }
-
   @Override
   public void onWindowFocusChanged(boolean hasFocus) {
     super.onWindowFocusChanged(hasFocus);
     if (hasFocus) {
+      if (openDefaultKeyboardPickerOnly) {
+
+        // When the user taps 'Set Default Keyboard' from the drawer,
+        // GetStartedActivity is launched in picker-only mode. But you
+        // can't open the system keyboard picker directly from a menu
+        // tap — it requires a window with focus. So we use
+        // onWindowFocusChanged as the trigger point: first focus opens
+        // the picker, and when the user dismisses it and focus returns
+        // to this activity, we call finish() to close it. The activity
+        // is essentially just a invisible bridge to show the system
+        // picker.
+
+        if (!didAutoOpenDefaultKeyboardPicker) {
+          didAutoOpenDefaultKeyboardPicker = true;
+          InputMethodManager imManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
+          if (imManager != null) {
+            imManager.showInputMethodPicker();
+          }
+        } else {
+          // Focus returned after the picker was dismissed, so close the host activity.
+          finish();
+        }
+        return;
+      }
+
       // Enumerated steps are replaced with checkboxes when the user completes a step
       String one = String.valueOf(R.drawable.ic_looks_one);
       String two = String.valueOf(R.drawable.ic_looks_two);
       String three = String.valueOf(R.drawable.ic_looks_three);
-      String checkbox_on = String.valueOf(android.R.drawable.checkbox_on_background);
+      String checkbox_on = String.valueOf(R.drawable.ic_checkbox);
       String info = String.valueOf(R.drawable.ic_info_outline);
 
       List<Keyboard> kbList = KMManager.getKeyboardsList(this);
@@ -208,4 +239,12 @@ public void onWindowFocusChanged(boolean hasFocus) {
       uncheckGetStartedIfComplete();
     }
   }
+
+  @Override
+  protected void onPause() {
+    super.onPause();
+    if (openDefaultKeyboardPickerOnly && didAutoOpenDefaultKeyboardPicker) {
+      finish();
+    }
+  }
 }

android/KMAPro/kMAPro/src/main/java/com/tavultesoft/kmapro/KMPBrowserActivity.java

@@ -81,7 +81,7 @@ protected void onCreate(Bundle savedInstanceState) {
     }
 
     setupEdgeToEdge(R.id.kmp_browser_layout);
-    setupStatusBarColors(R.color.complementary_5, android.R.color.white);
+    setupStatusBarColors(R.color.keyman_blue, android.R.color.white);
 
     webView = (WebView) findViewById(R.id.kmpBrowserWebView);
     webView.getSettings().setLayoutAlgorithm(WebSettings.LayoutAlgorithm.NORMAL);

android/KMAPro/kMAPro/src/main/java/com/tavultesoft/kmapro/KeyboardSettingsActivity.java

@@ -96,7 +96,7 @@ public void onCreate(Bundle savedInstanceState) {
     // Display notification to download update if available
     if (kbd.hasUpdateAvailable()) {
       hashMap.put(subtitleKey, context.getString(R.string.update_available, kbVersion));
-      icon = String.valueOf(R.drawable.ic_cloud_download);
+      icon = String.valueOf(R.drawable.ic_cloud_download_mode);
     }
     hashMap.put(iconKey, icon);
     infoList.add(hashMap);
@@ -105,7 +105,7 @@ public void onCreate(Bundle savedInstanceState) {
     hashMap = new HashMap<>();
     final String customHelpLink = kbd.getHelpLink();
     // Check if app declared FileProvider
-    icon = String.valueOf(R.drawable.ic_action_forward);
+    icon = String.valueOf(R.drawable.ic_action_forward_mode);
     // Don't show help link arrow if File Provider unavailable, or custom help doesn't exist
     if ( (customHelpLink != null && !FileProviderUtils.exists(context)) ||
          (customHelpLink == null && !packageID.equals(KMManager.KMDefault_UndefinedPackageID)) ) {

android/KMAPro/kMAPro/src/main/java/com/tavultesoft/kmapro/KeymanApplication.java

@@ -0,0 +1,25 @@
+/*
+ * Keyman is copyright (C) SIL Global. MIT License.
+ * 
+ * Created by MengchouChey on 2026-06-10
+ *            Internship Program, 9th Feb - 27th Apr 2026
+ * 
+ * This file is the Application class for Keyman, which is used to set the default night mode based on user preferences when the application starts.
+ * 
+ */
+package com.tavultesoft.kmapro;
+
+import android.app.Application;
+import android.content.SharedPreferences;
+
+import androidx.appcompat.app.AppCompatDelegate;
+
+public class KeymanApplication extends Application {
+  @Override
+  public void onCreate() {
+    SharedPreferences prefs = getSharedPreferences("settings", MODE_PRIVATE);
+    int mode = prefs.getInt("theme_mode", AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM);
+    AppCompatDelegate.setDefaultNightMode(mode);
+    super.onCreate();
+  }
+}