@stacksjs/defaults 0.75.25 → 0.75.26

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

@@ -113,6 +113,11 @@ await withNativeFeedback(() => saveActivity())
 The runtime is browser-safe. Craft-backed operations use the native bridge;
 supported web APIs provide fallback behavior outside a native host.
 
+For a run or ride, `createRouteRecorder({ location, onUpdate })` starts, pauses,
+resumes and stops the native recording, re-attaches to one that outlived the
+app (`attach()`), and reports live distance and pace from `routeStats(fixes)`,
+which ignores GPS drift, inaccurate fixes and the ground crossed during a pause.
+
 ## STX components
 
 - `<NativeAppShell>` applies iOS safe-area insets and reserves tab-bar space.

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

@@ -32,6 +32,28 @@ route.options('/users', handler)
 route.health()  // GET /health endpoint
 ```
 
+### Zero-allocation static responses
+
+Use `staticResponse()` only when the response is final at registration time and
+must bypass the request pipeline entirely:
+
+```typescript
+route.staticResponse('GET', '/ready', new Response('{"ready":true}', {
+  headers: { 'content-type': 'application/json' },
+}))
+```
+
+Bun serves that `Response` directly from its native route table. No handler,
+middleware, request ID, CSRF check or cookie, rate limit, request context,
+security or CORS header mutation, compression, or response formatting runs.
+Supply the final status, headers, and body bytes yourself.
+
+Static responses return the router, not a chainable route, so `.middleware()`,
+`.name()`, `.skipCsrf()`, `.requireCsrf()`, and `.rateLimit()` cannot be attached
+and silently bypassed. A static response inside a group with middleware or
+`apiResponse: true` throws during registration. Prefix-only groups are valid.
+Duplicate method and path registrations keep the first response.
+
 ### Chainable Methods
 ```typescript
 route.get('/admin', handler)

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.25",
+  "version": "0.75.26",
   "description": "A modern Stacks development environment.",
   "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.25",
+  "version": "0.75.26",
   "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.27",
-    "@stacksjs/mobile": "^0.75.25",
+    "@stacksjs/mobile": "^0.75.26",
     "@stacksjs/sanitizer": "^0.2.113",
     "ts-qr-codes": "^0.1.8"
   }

package/resources/components/NativeNetworkBanner.stx

@@ -1,22 +1,43 @@
 <script client>
-import { network } from '@stacksjs/mobile'
+import { lifecycle, network, whenNativeMobile } from '@stacksjs/mobile'
 import { onDestroy, onMount } from 'stx'
 
 const className = useReactiveProp<string>('class', '')
 const offlineLabel = useReactiveProp<string>('offlineLabel', 'You are offline. Changes will sync automatically.')
 const connected = state(true)
 let removeListener: (() => void) | null = null
+let removeLifecycle: (() => void) | null = null
 
 function applyStatus(status: { isConnected: boolean }): void {
   connected.set(status.isConnected)
 }
 
+// Asking can fail (the bridge not ready yet at launch, a request that timed
+// out): that is no answer, not "offline". Treating it as offline stuck the
+// banner on screen while everything was loading fine.
+function refresh(): void {
+  void network.getStatus().then(applyStatus).catch(() => {})
+}
+
 onMount(() => {
-  void network.getStatus().then(applyStatus).catch(() => connected.set(false))
+  refresh()
   removeListener = network.onChange(applyStatus)
+  // Once the native host is there, ask it; and again whenever the app comes
+  // back to the front, where a change may have gone by unseen.
+  void whenNativeMobile().then(native => native && refresh())
+  removeLifecycle = lifecycle.onStateChange((appState) => {
+    if (appState === 'active') refresh()
+  })
 })
 
-onDestroy(() => removeListener?.())
+// The webview's own view, for the moments the host has not spoken yet.
+useEventListener('online', () => connected.set(true))
+useEventListener('offline', () => refresh())
+
+onDestroy(() => {
+  removeListener?.()
+  removeLifecycle?.()
+})
 </script>
 
 <!--