@stacksjs/defaults 0.75.153 → 0.75.155

package/ai/skills/stacks-mobile/SKILL.md

@@ -201,6 +201,70 @@ every render would put a record straight back the moment they left it. Donating
 the same record twice is free, so an effect over the record is the natural call
 site.
 
+## Heart-rate strap (Bluetooth)
+
+`heartRate` reads a Bluetooth heart-rate strap (Polar, Garmin, Wahoo), or a
+watch broadcasting its heart rate, through the standard Heart Rate Service.
+`scan` finds straps nearby (`onDevice` hears each), `connect(id)` subscribes
+to its readings (`onReading`: bpm and RR intervals, about once a second) and
+remembers it, so `reconnect()` finds it next time without a scan; a strap that
+drops out is asked for again until `disconnect()`. `startRecording()` keeps
+every reading natively, screen locked or app closed, until `stopRecording()`
+hands them back. iOS only, behind `capabilities.heartRate` (which adds the
+`bluetooth-central` background mode); Bluetooth needs no network.
+
+```ts
+import { createRouteRecorder, heartRate, location } from '@stacksjs/mobile'
+
+const stop = heartRate.onDevice(device => list.push(device)) // { id, name, rssi }
+await heartRate.scan({ timeout: 15 })        // can show iOS's Bluetooth prompt
+await heartRate.connect(list[0].id)          // rejects TIMEOUT while still asking
+heartRate.onReading(reading => show(reading.bpm))
+
+// With a route: the strap records with it, and each fix gets its heart rate.
+const recorder = createRouteRecorder({ location, heartRate })
+await recorder.start()
+const fixes = await recorder.stop()          // fixes[i].heartRate
+const samples = recorder.heartRate           // every reading: { timestamp, bpm, rr? }
+```
+
+Without a route, record it on its own (`heartRate.startRecording()` /
+`stopRecording()`), and `attachHeartRate(fixes, samples)` pairs readings
+with fixes recorded separately. In a browser and on Android `isAvailable()` is
+false, the state says `available: false` and nothing fires. Word iOS's prompt
+with `ios.usageDescriptions.NSBluetoothAlwaysUsageDescription`.
+
+## Apple Music (now playing)
+
+`music` shows what the Music app is playing (title, artist, album, a small
+artwork data URL, duration, position, playback state) and steers it: `play`,
+`pause`, `togglePlayPause`, `skipToNext` and `skipToPrevious`, which restarts
+the song a few seconds in, like the Music app's own button. Changes arrive
+from native as they happen, so a page never polls. iOS only, behind
+`capabilities.appleMusic`; music control is local to the phone, so it works
+offline.
+
+```ts
+import { music } from '@stacksjs/mobile'
+
+// From the person's tap, never on load: iOS shows its prompt the first time.
+if (await music.requestAuthorization() === 'authorized') {
+  render(await music.getNowPlaying())
+  const stop = music.onChange(render) // observes while anyone listens
+  await music.togglePlayPause()
+}
+```
+
+Only Apple Music: iOS gives no app the controls of another player, Spotify
+included, so while one plays the song fields are null and `otherAudioPlaying`
+is true; say so rather than show controls that do nothing. Nothing is read
+before access is allowed (`authorization` is `notDetermined`, `denied` or
+`restricted` until then). In a browser and on Android `isAvailable()` is false,
+every call answers `{ available: false }` and `onChange` never fires. Word the
+prompt with `ios.usageDescriptions.NSAppleMusicUsageDescription`. The
+simulator's Music app has nothing to play; launch a simulator build with
+`-CraftFakeMusicPlayer YES` for three made-up songs that play and skip.
+
 ## Runtime API
 
 ```ts

package/ai/skills/stacks-native/CATALOG.md

@@ -60,7 +60,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/image` | [`stacks-image`](../stacks-image/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/image/src/index.ts) | 2 |
 | `@stacksjs/lint` | [`stacks-lint`](../stacks-lint/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/lint/src/index.ts) | 3 |
 | `@stacksjs/logging` | [`stacks-logging`](../stacks-logging/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/logging/src/index.ts) | 14 |
-| `@stacksjs/mobile` | [`stacks-mobile`](../stacks-mobile/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/index.ts) | 13 |
+| `@stacksjs/mobile` | [`stacks-mobile`](../stacks-mobile/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/index.ts) | 15 |
 | `@stacksjs/model-meta` | [`stacks-models`](../stacks-models/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/model-meta/src/index.ts) | 1 |
 | `@stacksjs/newsletter` | [`stacks-newsletter`](../stacks-newsletter/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/newsletter/src/index.ts) | 7 |
 | `@stacksjs/notifications` | [`stacks-notifications`](../stacks-notifications/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/index.ts) | 14 |
@@ -579,11 +579,11 @@ Evidence directory: [14 retained tests](https://github.com/stacksjs/stacks/blob/
 
 Guidance: [`stacks-mobile`](../stacks-mobile/SKILL.md). Source: [storage/framework/core/mobile/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/index.ts).
 
-Declared runtime exports: `appReview`, `biometrics`, `brightness`, `camera`, `deepLinks`, `device`, `getNativeMobileBridge`, `haptics`, `health`, `isNativeMobile`, `keepAwake`, `lifecycle`, `liveActivities`, `location`, `mobile`, `network`, `normalizeDeepLinkURL`, `notifications`, `onMobileReady`, `permissions`, `pushNotifications`, `secureStorage`, `share`, `snapshots`, `speech`, `splash`, `watchConnectivity`, `whenNativeMobile`, `withNativeFeedback`.
+Declared runtime exports: `appReview`, `biometrics`, `brightness`, `camera`, `deepLinks`, `device`, `getNativeMobileBridge`, `haptics`, `health`, `heartRate`, `isNativeMobile`, `keepAwake`, `lifecycle`, `liveActivities`, `location`, `mobile`, `music`, `network`, `normalizeDeepLinkURL`, `notifications`, `onMobileReady`, `permissions`, `pushNotifications`, `secureStorage`, `share`, `snapshots`, `speech`, `splash`, `watchConnectivity`, `whenNativeMobile`, `withNativeFeedback`.
 
 Local source modules: [src/bridge.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/bridge.ts), [src/controls.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/controls.ts), [src/events.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/events.ts), [src/gestures.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/gestures.ts), [src/indoor.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/indoor.ts), [src/native.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/native.ts), [src/navigation.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/navigation.ts), [src/refresh-control.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/refresh-control.ts), [src/route.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/route.ts), [src/session-clock.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/session-clock.ts), [src/sheet-gesture.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/sheet-gesture.ts), [src/sheets.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/sheets.ts), [src/shell.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/shell.ts), [src/spotlight.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/spotlight.ts), [src/tab-bar.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/tab-bar.ts), [src/types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/types.ts).
 
-Evidence directory: [13 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [15 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/model-meta
 

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.153",
+  "version": "0.75.155",
   "description": "Stacks, built into VS Code: stx templates, pickier linting and formatting, encrypted env files, the dev server preview and every buddy command. No other extensions required.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.153",
+  "version": "0.75.155",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -55,7 +55,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "0.75.153",
+    "@stacksjs/mobile": "0.75.155",
     "@stacksjs/sanitizer": "^0.2.483",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",