ruby_everywhere 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0afe4b448a6f964a0b013d31762aac332b71682717c04d25194271d9d1c92b67
-  data.tar.gz: '039d951d08c4d3be2d8a22c4de5a862d5dc1ca9635b978f989d4ba56807da148'
+  metadata.gz: f8b84ded1729bc011133caca7923d38ef48fc832193bd960228332b04d299717
+  data.tar.gz: 52164a6c960be3ff61ebd969ca037df1c23c8843fa00f89a570f043814f68805
 SHA512:
-  metadata.gz: 2656b49706209ee27c7aeb0410ea9ebff73ee833f58df43b9d51ceb2049b2e7540436b561e4a301fa89e6afb87c48056d1b0556598982cfaafb4367be55f8266
-  data.tar.gz: aca89fa867ba1aa8a1053e0d2324e358a02d9dd94e19129d984ca593e9598d3f031c91d95077b037fcb86a3a11d04535a0b70695f4eb3443ea7548f825617d83
+  metadata.gz: 37ee8e1843a575bc4678fd47c56d23d8108dd33af708a06e8317b32179837bb951e8cd396dfca8acb6ec3b84942bee9bd9b5089a8d853c57150fcabe1a651633
+  data.tar.gz: 442223b8697ab79c0bb7f0d63379cef3bc8453203707d2d4f7c835c85f60253049fb68d54f499c0f1d2b87dda4b3988b5042ef3b40457c0f31de380da1f5db8d

data/README.md

@@ -7,19 +7,19 @@
 RubyEverywhere takes a Rails (or Sinatra, or Hanami) app and gives it a native
 life on the platforms your users are already on:
 
-- **Desktop** — a [Tauri](https://tauri.app)-based shell. In *local* mode your
+- **Desktop**: a [Tauri](https://tauri.app)-based shell. In *local* mode your
   whole app is pressed into a single-file binary with
   [Tebako](https://github.com/tamatebako/tebako) and runs on-device, no Ruby
   install required; in *remote* mode the shell is a thin native wrapper around
   your deployed app.
-- **iOS** — a [Hotwire Native](https://native.hotwired.dev) shell with a real
+- **iOS**: a [Hotwire Native](https://native.hotwired.dev) shell with a real
   tab bar, nav-bar buttons, menus, action sheets, notifications, haptics,
   biometrics, deep links, and native sign-in.
-- **Android** — a feature-for-feature Hotwire Native Android port of the same
+- **Android**: a feature-for-feature Hotwire Native Android port of the same
   shell, stamped from the same `config/everywhere.yml`.
 
 One config file, one CLI, one JavaScript API. The web app stays the source of
-truth — most of what you'd normally rebuild natively (tabs, routes, menus,
+truth, so most of what you'd normally rebuild natively (tabs, routes, menus,
 badges) deploys with your Rails app rather than through an app-store review.
 
 ## Install
@@ -28,7 +28,7 @@ badges) deploys with your Rails app rather than through an app-store review.
 gem install ruby_everywhere
 ```
 
-This gives you two equivalent executables — `every` and `rbe` — plus the
+This gives you two equivalent executables, `every` and `rbe`, plus the
 packaging toolchain (the `rbe-tebako` fork) as a dependency.
 
 Or add it to your app's Gemfile, which also wires up the Rails engine (bridge
@@ -40,13 +40,13 @@ gem "ruby_everywhere"
 
 Requires Ruby >= 3.2.
 
-**The gem is free, and it always will be.** Everything here — the CLI, the
-desktop shell, both mobile shells, the bridge — is MIT licensed and yours to
+**The gem is free, and it always will be.** Everything here (the CLI, the
+desktop shell, both mobile shells, the bridge) is MIT licensed and yours to
 use, forever, with no account and no key. Local builds run on a Mac today
 (pressing, code signing, Xcode and the Android SDK all want a macOS host).
 If you don't own one, or you'd rather not keep a build toolchain healthy, the
 [RubyEverywhere Platform](https://rubyeverywhere.com) is a paid service coming
-soon that runs the exact same builds for you — see
+soon that runs the exact same builds for you. See
 [Hosted builds](#hosted-builds) below. It's a convenience, never a gate: nothing
 in this gem is held back for it.
 
@@ -71,14 +71,14 @@ every build --ios      # build the iOS shell
 every build --android  # build the APK/AAB
 ```
 
-`every install` is idempotent — it adds `config/everywhere.yml`, a boot stub,
+`every install` is idempotent: it adds `config/everywhere.yml`, a boot stub,
 and the framework-specific config tweaks it needs, and skips anything already
 in place. For Rails it does the surgery for you; for Sinatra and Hanami it
 vendors the bridge and prints the remaining wiring rather than guessing at your
 boot files.
 
-Working with an AI coding agent? `--agents` writes an `AGENTS.md` — the format
-Claude Code, Cursor, Copilot and Codex all read — covering the view helpers
+Working with an AI coding agent? `--agents` writes an `AGENTS.md`, the format
+Claude Code, Cursor, Copilot and Codex all read, covering the view helpers
 (`native_app?`, `everywhere_nav_button`, `everywhere_fab`, the menus and badges),
 `config/everywhere.yml`, the bridge API, and the `every` commands, so an agent
 reaches for the right helper instead of hand-rolling markup. It's framework- and
@@ -91,7 +91,7 @@ re-running refreshes our section and leaves your own notes alone.
 the native shells at it, so the edit-refresh loop is untouched Rails.
 
 It keeps a dock pinned to the bottom of the terminal showing what each target is
-doing, while the logs scroll normally above it — ordinary scrollback, so you can
+doing, while the logs scroll normally above it: ordinary scrollback, so you can
 still scroll up and search a backtrace:
 
 ```
@@ -104,7 +104,7 @@ ios  │ ▸ compiling Swift sources
 
 Every target runs on its own thread, so builds happen in parallel and the keys
 keep working while one is going. A build that fails marks that target red and
-leaves everything else — the dev server included — running; fix the error and
+leaves everything else running, the dev server included; fix the error and
 press the key again. `r` restarts just the dev server, `?` expands the full key
 list, and each line is tagged with the source that printed it once more than one
 thing is talking.
@@ -115,7 +115,7 @@ lines instead.
 ## Configuration
 
 Everything per-app lives in `config/everywhere.yml`. The native shell templates
-are frozen — the CLI stamps a copy per app and only ever writes the identity,
+are frozen: the CLI stamps a copy per app and only ever writes the identity,
 config, icon, and color files, so a shell upgrade never collides with your app.
 
 ```yaml
@@ -175,9 +175,9 @@ updates:                           # self-hosted, signed auto-updates
 ```
 
 Also supported: `auth:` (native OAuth sign-in with a callback scheme),
-`deep_linking:` (universal links / App Links — the gem serves the
+`deep_linking:` (universal links / App Links, where the gem serves the
 `apple-app-site-association` and `assetlinks.json` files for you), and
-`native:` for "supernative" extensions — Swift you keep in your app repo under
+`native:` for "supernative" extensions: Swift you keep in your app repo under
 `native/ios/` that `every build` compiles into the shell, including SwiftUI
 screens, bridge components, a custom splash, and pinned SPM packages.
 
@@ -213,11 +213,11 @@ Images the desktop shell itself draws live in `native/desktop/assets/`, using th
 same `<name>[@2x|@3x][~dark].png` filenames the mobile assets folders use.
 Name one `tray` (or `tray-template` for a macOS template image) and it becomes
 the menu-bar icon; a custom `splash:` can reference the rest as
-`assets/logo.png`. These are for the shell, not your pages — images your HTML
+`assets/logo.png`. These are for the shell, not your pages. Images your HTML
 references should keep coming from the asset pipeline.
 
 `window:` shapes the desktop frame. `title_bar: overlay` is the macOS look where
-the traffic lights float over your page and there's no title text — pair it with
+the traffic lights float over your page and there's no title text; pair it with
 the `.everywhere-titlebar-inset` class from `everywhere/native.css`, which
 reserves exactly the space they sit in. `frameless` removes the system chrome
 altogether; the page then draws its own bar and drives the buttons through
@@ -231,7 +231,7 @@ there keep their clicks. `window.drag_height: 0` hands that back to you.
 Tabs and path rules ship two ways from that one source: baked into the app
 bundle for offline/first launch, and served live from
 `/everywhere/{ios,android}_v1.json`, so changing them deploys with your web app.
-`Everywhere.tabs` lets you build the tab bar per request — feature flags, plan
+`Everywhere.tabs` lets you build the tab bar per request: feature flags, plan
 tiers, roles, anything your app can answer while serving a request:
 
 ```ruby
@@ -251,12 +251,12 @@ end
 
 The context carries `platform` (`"ios"`/`"android"`), `current_user`, and
 `session`/`cookies` normalized across Rails and Rack. `ctx.tab("Admin")` pulls in
-a tab declared `visible: false` in `everywhere.yml` — declared so the build
+a tab declared `visible: false` in `everywhere.yml`, declared so the build
 validates its icon, hidden so nothing ships it until this block says otherwise.
 
 ## The JavaScript bridge
 
-The gem ships `@rubyeverywhere/bridge` — one API for the browser, the desktop
+The gem ships `@rubyeverywhere/bridge`: one API for the browser, the desktop
 shell, and the mobile shells. Rails apps get it served and importmap-pinned
 automatically; Sinatra and Hanami get it vendored to `public/bridge.js`.
 
@@ -276,7 +276,7 @@ Everywhere.updates.check()
 Everywhere.window.close()    // desktop, for a page-drawn title bar
 ```
 
-Everything degrades gracefully — the same page works in a plain browser tab and
+Everything degrades gracefully, and the same page works in a plain browser tab and
 gains native powers inside the app. See
 [`bridge/README.md`](bridge/README.md) for the full surface.
 
@@ -300,11 +300,11 @@ Plus `native_app?`, `native_platform`, `everywhere_badge`,
 
 | Command | What it does |
 | --- | --- |
-| `every install` | Prepare an app (boot stub, `config/everywhere.yml`, config tweaks) — `--local`, `--agents` |
-| `every doctor` | Check the toolchain — Tebako, Rust, brew deps, Xcode, Android SDK/JDK |
+| `every install` | Prepare an app (boot stub, `config/everywhere.yml`, config tweaks); `--local`, `--agents` |
+| `every doctor` | Check the toolchain: Tebako, Rust, brew deps, Xcode, Android SDK/JDK |
 | `every dev` | Dev server with native shells on demand (`--desktop --ios --android --mobile --browser`) |
 | `every logs` | Stream shell logs from the Simulator or Android device |
-| `every build` | Package natively — desktop, `--ios`, or `--android` |
+| `every build` | Package natively: desktop, `--ios`, or `--android` |
 | `every icon` | Generate `.icns` / `.ico` / Linux icons from a source PNG |
 | `every release` | Sign, notarize, staple, and emit a `release.json` receipt |
 | `every updates keygen` | Generate a minisign-compatible update-signing keypair |
@@ -335,8 +335,8 @@ check, install, and switch channels at runtime via `Everywhere.updates`.
 ## Hosted builds
 
 Don't have a Mac, or want iOS and Android built without babysitting Xcode, the
-Android SDK, and a signing setup? The **RubyEverywhere Platform** — a paid
-service, coming soon — runs the same builds on managed machines and hands back
+Android SDK, and a signing setup? The **RubyEverywhere Platform**, a paid
+service coming soon, runs the same builds on managed machines and hands back
 the artifacts. The CLI already speaks to it:
 
 ```sh
@@ -344,7 +344,7 @@ every platform login
 every platform build --target ios-arm64,android-arm64
 ```
 
-Same gem, same `config/everywhere.yml`, same output — you're paying for the
+Same gem, same `config/everywhere.yml`, same output. You're paying for the
 build machines and the toolchain upkeep, not for features. The gem stays free
 and complete on its own.
 
@@ -353,14 +353,14 @@ and complete on its own.
 ```
 lib/everywhere/          the CLI, config, builders, and Rails engine
 exe/every, exe/rbe       the executables
-bridge/                  @rubyeverywhere/bridge — the JS half
+bridge/                  @rubyeverywhere/bridge, the JS half
 support/desktop/         the Tauri desktop shell template
 support/mobile/ios/      the Hotwire Native iOS shell template
 support/mobile/android/  the Hotwire Native Android shell template
 support/agents/          the AGENTS.md guide `every install --agents` writes
 ```
 
-The shell templates have their own READMEs documenting the freeze rules — what
+The shell templates have their own READMEs documenting the freeze rules: what
 the CLI stamps per app and what it must never touch:
 [iOS](support/mobile/ios/README.md) · [Android](support/mobile/android/README.md).
 

data/bridge/README.md

@@ -1,7 +1,7 @@
 # @rubyeverywhere/bridge
 
-One API for the browser, the RubyEverywhere desktop shell, and (soon) Hotwire
-Native mobile apps — the JavaScript half of [RubyEverywhere](https://rubyeverywhere.com).
+One API for the browser, the RubyEverywhere desktop shell, and the Hotwire
+Native iOS and Android shells: the JavaScript half of [RubyEverywhere](https://rubyeverywhere.com).
 
 App code writes to this surface only; platform differences live in adapters
 inside the package. Everything degrades gracefully: the same page works in a
@@ -33,7 +33,7 @@ Everywhere.confirm("Sure?")          // Promise<boolean>, native dialog when pos
 Everywhere.on("menu", handler)       // shell events; returns an unsubscribe fn
 Everywhere.visit("/settings")        // Turbo.visit with location fallback
 
-Everywhere.menu({ title, items })    // Promise<item | null> — native action
+Everywhere.menu({ title, items })    // Promise<item | null>, native action
                                      // sheet in the shell, a styled bottom
                                      // sheet everywhere else. items:
                                      // [{ title, id?, style?, disabled? }]
@@ -55,25 +55,25 @@ Everywhere.permissions.request("camera") // prompts when possible
 Everywhere.permissions.openSettings()    // for the denied dead-end (iOS asks once)
 // status: "granted" | "denied" | "prompt" | "undeclared" | "unsupported"
 // mobile permissions must be declared in everywhere.yml (camera/location
-// declarations carry the usage string iOS shows) — undeclared never prompts
+// declarations carry the usage string iOS shows); undeclared never prompts
 
-Everywhere.storage.get("key")        // Promise<any | null> — device-local settings
+Everywhere.storage.get("key")        // Promise<any | null>, device-local settings
 Everywhere.storage.set("key", value) // Promise<boolean>; any JSON value round-trips
 Everywhere.storage.remove("key")     // Promise<boolean>
-Everywhere.storage.clear()           // Promise<boolean> — clears app keys only
+Everywhere.storage.clear()           // Promise<boolean>, clears app keys only
 // UserDefaults in the mobile shell (survives web view resets and cache
 // clears, unlike localStorage); localStorage-backed in browsers and the
-// desktop shell. Settings, not secrets — tokens go in biometrics.credential.
+// desktop shell. Settings, not secrets: tokens go in biometrics.credential.
 ```
 
 ### Native chrome (nav bar buttons, menus, action sheets)
 
 Tag ordinary markup, and inside the mobile shell the bridge lifts it into real
-native controls — a nav-bar button, a pull-down / overflow menu, or an action
+native controls: a nav-bar button, a pull-down / overflow menu, or an action
 sheet. Tapping the native control just `.click()`s the element it mirrors, so a
 link navigates, a submit submits, and behavior stays defined once in the DOM. In
 a browser the same markup is the plain HTML it already is. No JavaScript, no
-Stimulus — CSP-safe.
+Stimulus, so it clears CSP.
 
 ```html
 <!-- becomes a nav-bar button (right side); icons are per-platform like tabs -->
@@ -103,7 +103,7 @@ Stimulus — CSP-safe.
 </div>
 ```
 
-Rails ships helpers that emit exactly this — `everywhere_nav_button`,
+Rails ships helpers that emit exactly this: `everywhere_nav_button`,
 `everywhere_submit_button`, `everywhere_nav_menu` / `everywhere_menu_item`,
 `everywhere_menu`, and `everywhere_fab` (a floating action button). Include
 `everywhere/native.css` for the FAB, the action-sheet fallback, and the
@@ -111,7 +111,7 @@ safe-area utilities.
 
 ### Multi-instance apps
 
-Apps whose users pick a server — one hosted platform, many instances — opt in
+Apps whose users pick a server, one hosted platform with many instances, opt in
 with `remote.instances: true` in `everywhere.yml`. The mobile shell then boots
 into `remote.url` (your hosted picker page) until that page picks an instance:
 
@@ -120,13 +120,13 @@ Everywhere.instance.supported        // true in a shell built with remote.instan
 Everywhere.instance.current          // active instance URL, or null (= built-in root)
 
 Everywhere.instance.set("https://acme.example.com")
-// validates, persists, and fully resets the app onto the instance — every
+// validates, persists, and fully resets the app onto the instance. Every
 // later launch boots straight there. {to: "/path"} lands somewhere specific.
 
 Everywhere.instance.clear()          // back to the picker (and resets again)
 ```
 
-In a plain browser `set()` simply navigates to the URL — going there is what
+In a plain browser `set()` navigates to the URL: going there is what
 picking an instance means on the web.
 
 Declarative forms need no JS: elements with `data-everywhere-haptic`
@@ -150,18 +150,18 @@ The payload arrives in Rust as a `serde_json::Value` and whatever the command
 returns comes back as the resolved value; a command that returns `Err` rejects
 with its own message.
 
-Unlike the rest of the bridge this does **not** degrade — there's no web
+Unlike the rest of the bridge this does **not** degrade; there's no web
 equivalent for "talk to a serial port", so off the desktop it rejects rather
 than resolving something untrue. Gate on `Everywhere.desktop.supported`.
 
 Under the hood this is an event round-trip, not Tauri's `invoke`: a
 RubyEverywhere page is always served over http, and Tauri v2 refuses `invoke`
-from any http origin — including the packaged app's own localhost server.
+from any http origin, including the packaged app's own localhost server.
 
 ### Window controls
 
-Desktop apps that draw their own title bar — `window.title_bar: overlay` or
-`frameless` in `everywhere.yml` — drive the window from the page:
+Desktop apps that draw their own title bar (`window.title_bar: overlay` or
+`frameless` in `everywhere.yml`) drive the window from the page:
 
 ```js
 Everywhere.window.supported           // true in the desktop shell
@@ -181,7 +181,7 @@ supplies its own.
 
 **Dragging works out of the box.** With no system title bar left to grab, the
 shell makes the top 28px of the page drag the window, and double-click there
-zooms it — no markup required. Buttons, links and inputs in that strip keep
+zooms it, with no markup required. Buttons, links and inputs in that strip keep
 their clicks:
 
 ```html
@@ -232,16 +232,16 @@ In a plain browser tab the updates API is inert: `check()` resolves
 
 ## Platforms
 
-- **desktop** — the Tauri-based RubyEverywhere shell. Notifications, dialogs,
+- **desktop**: the Tauri-based RubyEverywhere shell. Notifications, dialogs,
   clipboard, shell events, window controls, and auto-updates are native.
-- **browser** — honest web fallbacks: the Notification API, `window.confirm`,
+- **browser**: honest web fallbacks: the Notification API, `window.confirm`,
   `navigator.clipboard`, DOM CustomEvents.
-- **mobile** — Hotwire Native (iOS shell). `notify()` delivers a native local
+- **mobile**: the Hotwire Native iOS and Android shells. `notify()` delivers a native local
   notification via the shell's `everywhere--notification` bridge component
   (web-bridge handshake is installed automatically unless the app already
-  loads `@hotwired/hotwire-native-bridge` — first one wins, like the official
+  loads `@hotwired/hotwire-native-bridge`; first one wins, like the official
   package). `confirm()`/clipboard use the browser fallbacks, which are native
-  in a WKWebView anyway. Everything degrades to browser behavior outside the
+  in the web view anyway. Everything degrades to browser behavior outside the
   shell.
 
 ## License

data/lib/everywhere/android_resources.rb

@@ -100,10 +100,10 @@ module Everywhere
         relative = relative(path, source)
         case File.extname(path).downcase
         when ".svg", ".pdf"
-          "#{relative}: Android has no runtime SVG or PDF renderer — export a PNG, or convert it to " \
+          "#{relative}: Android has no runtime SVG or PDF renderer. Export a PNG, or convert it to " \
             "a VectorDrawable (Android Studio: right-click res → New → Vector Asset) and ship the .xml"
         else
-          "#{relative}: unsupported image type — use #{EXTENSIONS.join(", ")}"
+          "#{relative}: unsupported image type. Use #{EXTENSIONS.join(", ")}"
         end
       end
 
@@ -116,7 +116,7 @@ module Everywhere
         # resource name may — so it would otherwise fail with a naming error
         # that says nothing about what the author actually tried to do.
         if stem.end_with?(".9")
-          errors << "#{relative}: nine-patch drawables aren't supported yet — ship a plain #{extension} " \
+          errors << "#{relative}: nine-patch drawables aren't supported yet. Ship a plain #{extension} " \
                     "(or a VectorDrawable .xml, which stretches without one)"
           return nil
         end
@@ -124,23 +124,23 @@ module Everywhere
         name, scale, dark = parse(stem)
 
         unless name.match?(VALID_NAME)
-          errors << "#{relative}: #{name.inspect} isn't a usable Android resource name — use lowercase " \
+          errors << "#{relative}: #{name.inspect} isn't a usable Android resource name. Use lowercase " \
                     "letters, digits and _, starting with a letter (#{suggestion(name).inspect} would " \
                     "work). Unlike iOS, Android has no room for capitals, hyphens or dots here"
           return nil
         end
         if JAVA_KEYWORDS.include?(name)
-          errors << "#{relative}: #{name.inspect} is a Java keyword, so it can't name a field on R — " \
+          errors << "#{relative}: #{name.inspect} is a Java keyword, so it can't name a field on R. " \
                     "rename it (#{"#{name}_image".inspect})"
           return nil
         end
         if RESERVED.include?(name)
-          errors << "#{relative}: #{name} is reserved by the shell (launcher icon and tab placeholder) — " \
+          errors << "#{relative}: #{name} is reserved by the shell (launcher icon and tab placeholder). " \
                     "rename it"
           return nil
         end
         if scale && VECTOR.include?(extension)
-          errors << "#{relative}: an XML drawable is scale-free — drop the @#{scale} suffix"
+          errors << "#{relative}: an XML drawable is scale-free. Drop the @#{scale} suffix"
           return nil
         end
 
@@ -190,11 +190,11 @@ module Everywhere
           dirs = group.map { |variant| variant[:source_dir] }.uniq
           if dirs.length > 1
             listed = dirs.map { |dir| dir == "." ? "assets/" : "assets/#{dir}/" }.join(" and ")
-            errors << "#{name}: same asset name in #{listed} — res/ is flat, so both would become " \
+            errors << "#{name}: same asset name in #{listed}. res/ is flat, so both would become " \
                       "R.drawable.#{name}. Rename one"
           end
           if group.map { |variant| variant[:vector] }.uniq.length > 1
-            errors << "#{name}: mixes an XML drawable with bitmaps — pick one per asset"
+            errors << "#{name}: mixes an XML drawable with bitmaps. Pick one per asset"
           end
 
           # Same destination directory and same name: aapt2 sees two files

data/lib/everywhere/android_sdk.rb

@@ -98,7 +98,7 @@ module Everywhere
     end
 
     def sdk_root!
-      sdk_root or UI.die!("no Android SDK — install Android Studio (it provisions the SDK, adb, " \
+      sdk_root or UI.die!("no Android SDK. Install Android Studio (it provisions the SDK, adb, " \
                           "the emulator and a JDK in one go), or point ANDROID_HOME at an " \
                           "existing SDK; looked in #{expected_sdk_root}")
     end
@@ -115,22 +115,22 @@ module Everywhere
     def emulator = sdk_tool("emulator", "emulator")
 
     def adb!
-      adb or UI.die!("no adb under #{sdk_root!} — #{install_hint("platform-tools")}")
+      adb or UI.die!("no adb under #{sdk_root!}: #{install_hint("platform-tools")}")
     end
 
     def emulator!
-      emulator or UI.die!("no Android emulator under #{sdk_root!} — #{install_hint("emulator")}")
+      emulator or UI.die!("no Android emulator under #{sdk_root!}: #{install_hint("emulator")}")
     end
 
     def sdkmanager = cmdline_tool("sdkmanager")
     def avdmanager = cmdline_tool("avdmanager")
 
     def sdkmanager!
-      sdkmanager or UI.die!("no sdkmanager under #{sdk_root!} — #{cmdline_tools_hint}")
+      sdkmanager or UI.die!("no sdkmanager under #{sdk_root!}: #{cmdline_tools_hint}")
     end
 
     def avdmanager!
-      avdmanager or UI.die!("no avdmanager under #{sdk_root!} — #{cmdline_tools_hint}")
+      avdmanager or UI.die!("no avdmanager under #{sdk_root!}: #{cmdline_tools_hint}")
     end
 
     # Whether this SDK can install anything at all. Worth asking on its own,
@@ -237,12 +237,12 @@ module Everywhere
     # where the message can name the cause.
     def java_home!(minimum: MINIMUM_JDK)
       home = java_home or
-        UI.die!("no JDK — install Android Studio (it bundles one at #{STUDIO_JBR.first}) " \
+        UI.die!("no JDK. Install Android Studio (it bundles one at #{STUDIO_JBR.first}) " \
                 "or set JAVA_HOME to a JDK #{minimum} or newer")
       version = java_version
       return home if version.nil? || version >= minimum
 
-      UI.die!("#{home} is JDK #{version}; the Android Gradle Plugin needs #{minimum} or newer — " \
+      UI.die!("#{home} is JDK #{version}; the Android Gradle Plugin needs #{minimum} or newer. " \
               "set JAVA_HOME to a JDK #{minimum}+, or install Android Studio and use its bundled runtime")
     end
 
@@ -321,7 +321,7 @@ module Everywhere
 
       package = "platforms;#{platform_name(api)}"
       UI.die!("the Android SDK has no #{package} (installed: " \
-              "#{installed_platforms.empty? ? "none" : installed_platforms.join(", ")}) — " \
+              "#{installed_platforms.empty? ? "none" : installed_platforms.join(", ")}). " \
               "#{install_hint(package)}")
     end
 
@@ -347,7 +347,7 @@ module Everywhere
       found = avds
       return found if found.any?
 
-      UI.die!("no Android virtual devices — #{create_avd_hint}")
+      UI.die!("no Android virtual devices. #{create_avd_hint}")
     end
 
     # How to get a bootable AVD. The GUI route comes first because a machine

data/lib/everywhere/asset_catalog.rb

@@ -57,15 +57,15 @@ module Everywhere
         images, other = files.partition { |path| EXTENSIONS.include?(File.extname(path).downcase) }
 
         other.each do |path|
-          errors << "#{relative(path, source)}: unsupported image type — use #{EXTENSIONS.join(", ")}"
+          errors << "#{relative(path, source)}: unsupported image type. Use #{EXTENSIONS.join(", ")}"
         end
         variants = images.filter_map { |path| variant(path, source, errors) }
 
         sets = variants.group_by { |v| v[:name] }.map do |name, group|
           dirs = group.map { |v| v[:dir] }.uniq
           if dirs.length > 1
-            errors << "#{name}: same asset name in #{dirs.map { |d| d == "." ? "assets/" : "assets/#{d}/" }.join(" and ")} " \
-                      "— names are global in the catalog, so rename one"
+            errors << "#{name}: same asset name in #{dirs.map { |d| d == "." ? "assets/" : "assets/#{d}/" }.join(" and ")}. " \
+                      "Names are global in the catalog, so rename one"
           end
           errors.concat(slot_errors(name, group))
           { name: name, dir: dirs.first, variants: group }
@@ -80,16 +80,16 @@ module Everywhere
         name, scale, dark = parse(File.basename(path, File.extname(path)))
 
         unless name.match?(VALID_NAME)
-          errors << "#{relative}: #{name.inspect} isn't a usable asset name — " \
+          errors << "#{relative}: #{name.inspect} isn't a usable asset name. " \
                     "use letters, digits, _, - and ."
           return nil
         end
         if RESERVED.include?(name)
-          errors << "#{relative}: #{name} is reserved (stamped from config/everywhere.yml) — rename it"
+          errors << "#{relative}: #{name} is reserved (stamped from config/everywhere.yml). Rename it"
           return nil
         end
         if scale && VECTOR.include?(extension)
-          errors << "#{relative}: vector assets are scale-free — drop the @#{scale} suffix"
+          errors << "#{relative}: vector assets are scale-free. Drop the @#{scale} suffix"
           return nil
         end
 
@@ -117,7 +117,7 @@ module Everywhere
       def slot_errors(name, group)
         errors = []
         if group.map { |v| v[:vector] }.uniq.length > 1
-          errors << "#{name}: mixes vector and raster files — pick one per asset"
+          errors << "#{name}: mixes vector and raster files. Pick one per asset"
         end
         group.group_by { |v| [v[:scale], v[:dark]] }.each_value do |clash|
           next if clash.length < 2

data/lib/everywhere/blake2b.rb

@@ -90,7 +90,7 @@ module Everywhere
       @warned_fallback = true
       require_relative "ui"
       mb = (File.size(path) / 1024.0 / 1024.0).round(1)
-      Everywhere::UI.warn("this Ruby's OpenSSL has no BLAKE2b512 — hashing #{mb}MB in pure Ruby " \
+      Everywhere::UI.warn("this Ruby's OpenSSL has no BLAKE2b512, so hashing #{mb}MB in pure Ruby " \
                           "(slow, and the file is read into memory)")
     end
 

data/lib/everywhere/boot.rb

@@ -88,7 +88,7 @@ module Everywhere
       ENV[key] or raise Error, app_data_hint("#{key} is unset")
     end
 
-    def app_data_hint(reason) = "can't work out where to keep app data (#{reason}) — " \
+    def app_data_hint(reason) = "can't work out where to keep app data (#{reason}). " \
                                 "set NATIVE_APPDATA (or HOME / APPDATA)"
 
     def prepare_app_data