ruby_everywhere 0.1.15 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63effa5f5f00816aa20ada48ca9e1d29fd016dc98b294da2bc0c7d8e1e09d853
-  data.tar.gz: 9f998859661f637feac481d87de6964de030b45fdf197b0c4f72286a1f80fb63
+  metadata.gz: 0bb96376a66f4202388542212bc1d03b2dea1bb6519ccc4a8339cc1b3cda3e43
+  data.tar.gz: be5f8b69e0157a93dfc1837445faa8f4e6326678741b88ddd76c9bff0521ddf5
 SHA512:
-  metadata.gz: 86c4032c3973f6e85dcfbb4e8e203f30acd41639c261fc1df07e43dd1c9ee31f681eb445c2a4197d656ec3e96c3b7de94ddd22bd9e3e60ac8ad392038229d0bc
-  data.tar.gz: cc951a4ebdc8ecefffee7d418a871fe4e50fd74b676810a522792d0463aebb638307c7aaed124c2699f9b153f4e74ec8201907731a1049a43d8b8caa68c6c7ac
+  metadata.gz: 29c23a79521c57f81a0881e663debc4e2c9a505a424dbe8b615c1a1c5eccba3d93c1dfd7ee0281ea04c8121d2c4ba6ec4c0de8276453ab5ca0d348d6d8afdf00
+  data.tar.gz: 7a626876bb0820701922e23990541e149360b35246b2456be3b2d5f7729743f2c5e3772d6e9e2d94d7ea898b85d6e528ff5e9ad85e919653357463073cfbdcea

data/bridge/README.md

@@ -35,8 +35,58 @@ Everywhere.visit("/settings")        // Turbo.visit with location fallback
 
 Everywhere.clipboard.write(text)     // Promise<void>
 Everywhere.clipboard.read()          // Promise<string | null>
+
+Everywhere.haptics.impact("medium")  // real haptics in the mobile shell;
+Everywhere.haptics.notification("success") // Vibration API in browsers, no-op elsewhere
+Everywhere.haptics.selection()
+
+Everywhere.badge.set(3)              // app icon badge (mobile / installed PWAs)
+Everywhere.badge.clear()
+Everywhere.badge.setTab("/inbox", 3) // native tab bar badge (mobile)
+Everywhere.badge.clearTab("/inbox")
+
+Everywhere.permissions.query("camera")   // Promise<{name, status}>
+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
+
+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
+// 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.
+```
+
+### Multi-instance apps
+
+Apps whose users pick a server — one hosted platform, 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:
+
+```js
+Everywhere.instance.supported        // true in a shell built with remote.instances
+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
+// 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
+picking an instance means on the web.
+
+Declarative forms need no JS: elements with `data-everywhere-haptic`
+(`"light"`, `"impact:heavy"`, `"notification:error"`, `"selection"`) play on
+tap, and `<meta name="everywhere:badge">` / `<meta name="everywhere:tab-badge">`
+tags (the `everywhere_badge` / `everywhere_tab_badge` Rails helpers) are
+applied on every Turbo visit.
+
 ### Auto-updates
 
 Inside the desktop shell, apps with an update feed configured can check,
@@ -69,8 +119,13 @@ In a plain browser tab the updates API is inert: `check()` resolves
   clipboard, shell events, and auto-updates are native.
 - **browser** — honest web fallbacks: the Notification API, `window.confirm`,
   `navigator.clipboard`, DOM CustomEvents.
-- **mobile** — Hotwire Native detection is live; behavior currently falls back
-  to the browser adapter until the bridge-component adapter lands.
+- **mobile** — Hotwire Native (iOS shell). `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
+  package). `confirm()`/clipboard use the browser fallbacks, which are native
+  in a WKWebView anyway. Everything degrades to browser behavior outside the
+  shell.
 
 ## License