@stacksjs/defaults 0.75.250 → 0.75.253

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

@@ -88,6 +88,8 @@ Full-page screenshot at each breakpoint and a horizontal-overflow check:
 | Wide | 1920 | 1080 |
 
 Reports `horizontalOverflowPx` per breakpoint (0 = no overflow). Shots in `storage/framework/runtime/shots/responsive/`.
+Overflow is measured against the requested device width, so mobile Chrome's
+automatic viewport expansion cannot hide a page wider than the device.
 
 ### Monitor (console + network)
 ```bash
@@ -115,6 +117,8 @@ bun storage/framework/defaults/ai/skills/stacks-browse/scripts/browse.ts scenari
 ```
 
 Steps run in order within one isolated browser page, preserving reactive STX state and SPA navigation. Supported actions are `click`, `fill`, `focus`, `press`, `wait`, `evaluate`, and `assert`. Each step is a JSON object passed through a repeatable `--step` flag. Click and focus steps may include `text` to select the matching control from their CSS selector. They scroll matched controls into view before interacting, including controls inside horizontal overflow regions. Evaluate steps run a JavaScript expression in the isolated page and return its serialized value, which is useful for inspecting STX signals and DevTools state between interactions. The command reports every completed step, the final URL and page text, console messages, console exceptions, failed requests, and an optional screenshot. It exits nonzero when the scenario assertion, evaluation, browser console, or network fails.
+On a failed step, execution stops and the report retains its number and error,
+the completed steps, final page state and requested screenshot.
 Use `{"action":"assert","selector":"...","absent":true}` to verify that an element is missing or hidden after an interaction.
 Use `{"action":"assert","selector":"button","text":"Save","focused":true}` to verify keyboard focus and focus restoration.
 

package/ai/skills/stacks-browse/scripts/browse.ts

@@ -833,7 +833,9 @@ async function main() {
         const cdp = await openPage(session.port)
         const state = await gotoAndInstrument(cdp, url, { viewport: { w: bp.w, h: bp.h }, cookies, settleMs, scheme, reducedMotion: true })
         const overflow = await cdp.send('Runtime.evaluate', {
-          expression: 'document.body.scrollWidth > window.innerWidth ? document.body.scrollWidth - window.innerWidth : 0',
+          // Mobile Chrome may expand innerWidth to fit overflowing content.
+          // Compare the page with the requested device width, not that expansion.
+          expression: `Math.max(0, Math.max(document.body.scrollWidth, document.documentElement.scrollWidth) - ${bp.w})`,
           returnByValue: true,
         })
         const out = join(outDir, `${bp.device.toLowerCase().replace(/\s+/g, '-')}.png`)
@@ -914,8 +916,16 @@ async function main() {
         })()`,
       })
 
+      let scenarioFailed = false
       for (const step of steps) {
-        results.push(await runScenarioStep(cdp, step))
+        try {
+          results.push(await runScenarioStep(cdp, step))
+        }
+        catch (error) {
+          results.push({ action: step.action, ok: false, step: results.length + 1, error: error instanceof Error ? error.message : String(error) })
+          scenarioFailed = true
+          break
+        }
         if (step.action !== 'wait')
           await Bun.sleep(step.settle ?? 250)
       }
@@ -954,7 +964,7 @@ async function main() {
         consoleErrors: state.consoleErrors,
         failedRequests,
       }, null, 2))
-      if (state.consoleErrors.length || failedRequests.length)
+      if (scenarioFailed || state.consoleErrors.length || failedRequests.length)
         process.exitCode = 1
       state.dispose()
       cdp.close()
@@ -1022,7 +1032,7 @@ async function main() {
               expression: `(() => ({
               title: document.title,
               links: Array.from(document.querySelectorAll('a[href]')).map(link => link.href),
-              overflow: Math.max(0, document.body.scrollWidth - window.innerWidth),
+              overflow: Math.max(0, Math.max(document.body.scrollWidth, document.documentElement.scrollWidth) - ${crawlViewport.w}),
               layout: (() => {
                 const main = document.querySelector('[data-stx-content]')
                 return {
@@ -1031,7 +1041,7 @@ async function main() {
                   mainClientWidth: main?.clientWidth ?? null,
                   mainOverflowX: main ? getComputedStyle(main).overflowX : null,
                   mainScrollWidth: main?.scrollWidth ?? null,
-                  viewportWidth: window.innerWidth,
+                  viewportWidth: ${crawlViewport.w},
                 }
               })(),
               overflowing: Array.from(document.querySelectorAll('body *'))
@@ -1076,8 +1086,8 @@ async function main() {
                     ...(overflowContainer ? { overflowContainer } : {}),
                   }
                 })
-                .filter(item => item.width > 0 && (item.left < -1 || item.right > window.innerWidth + 1))
-                .sort((a, b) => Math.max(b.right - window.innerWidth, -b.left) - Math.max(a.right - window.innerWidth, -a.left))
+                .filter(item => item.width > 0 && (item.left < -1 || item.right > ${crawlViewport.w} + 1))
+                .sort((a, b) => Math.max(b.right - ${crawlViewport.w}, -b.left) - Math.max(a.right - ${crawlViewport.w}, -a.left))
                 .slice(0, 10),
             }))()`,
               returnByValue: true,

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

@@ -52,11 +52,18 @@ re-exported CacheLock contract and selected driver separately.
 and prefix. Clone-on-read/write is enabled by default.
 `createRedisCache(options?)` accepts URL or host/port/credentials/database/TLS
 plus TTL/prefix options. `createSingleStoreCache(options?)` exposes the
-experimental SQL-backed cache. `createCache(driver, options?)` selects one
-of memory, redis or singlestore.
-
-The `cache` export is the same memory instance as `memory`. Use an explicit
-Redis instance for application data that must be shared across processes.
+experimental SQL-backed cache. `createSqliteCache(options?)` keeps entries in
+a table of a SQLite file (`path`, `table`, `prefix`, `stdTTL`), so they outlive
+the process: use it for results that are expensive and safe to keep across
+deploys, pointing `path` at a file the deploy preserves (the app's own SQLite
+database works; the table is the driver's alone). `createCache(driver,
+options?)` selects one of memory, redis, singlestore or sqlite.
+
+The `cache` export is the driver `config/cache.ts` selects (`driver`, with
+`prefix` and `ttl` applied to the non-memory drivers), resolved on first use
+and once the app's config has loaded. With the default `driver: 'memory'` it
+answers from the `memory` instance itself. `cacheFromConfig(settings?)` builds
+the same choice explicitly; `resetConfiguredCache()` forgets it.
 The capability registry proves memory and a versioned Redis core/TTL contract;
 TLS/authenticated Redis deployments need separate provider evidence. SingleStore
 has no dedicated service conformance matrix. Source:
@@ -79,7 +86,8 @@ are distinct from StacksCache and auth's RateLimiter.
 ## Source and verification
 
 `storage/framework/core/cache/src/drivers/index.ts` is the facade/factory
-contract. `drivers/singlestore.ts` owns the experimental backend.
+contract. `drivers/singlestore.ts` owns the experimental backend and
+`drivers/sqlite.ts` the durable file-backed one (`sqlite-cache.test.ts`).
 Retained tests: `ttl.test.ts`, `getorset-timeout.test.ts`,
 `tagged-flush-race.test.ts`, `redis-contract.test.ts` and
 `cache-factory.test.ts` under `core/cache/tests/`.

package/ai/skills/stacks-composables/BROWSER.md

@@ -15,14 +15,24 @@ ambient browser manifest is a type declaration input, not this delivery map.
 3. Explicit application-module imports are bundled separately. Their bindings
    do not leak into another imported module or magically change Ref contracts.
 
-Installed STX 0.2.422 delivers `useForm`, `useIntersectionObserver`,
-`useMouse`, `useParallax`, and `useScroll` on demand. It eagerly supplies
-`useMediaQuery` and `usePreferredReducedMotion` through the runtime/compiler.
+Verified in STX 0.2.422: demand delivery for `useForm`, `useIntersectionObserver`,
+`useMouse`, `useParallax`, and `useScroll`. The runtime/compiler eagerly supplies
+`useMediaQuery` and `usePreferredReducedMotion`.
 An older installation must be checked against its own runtime and demand
 implementation rather than a newer docs list. Demand legacy helpers commonly
 expose getters, `get()`, `subscribe()`, and `stop()`. Their getters are not
 automatically signal-tracked template values.
 
+STX 0.2.628 adds demand-delivered `useAnimationFrame` for canvas and simulations.
+Imported TypeScript controllers use an explicit
+`import { useAnimationFrame } from '@stacksjs/stx/composables'` and declare
+`@stacksjs/stx` as a runtime dependency. This is a STX export, separate from
+the `@stacksjs/composables` Ref API.
+
+STX 0.2.631 keeps top-level mutable bindings live in template expressions,
+including controllers assigned in `onMount` by imported TypeScript code. Use
+signals for values whose changes should schedule rendering.
+
 ## Browser and module contracts differ
 
 | Name | STX client runtime | Explicit @stacksjs/composables |
@@ -35,6 +45,14 @@ automatically signal-tracked template values.
 
 ## Motion and observers
 
+`useAnimationFrame((delta, timestamp) => ...)` supplies milliseconds and returns
+`active`, `resume()`, `pause()` and permanent `stop()` controls. Hidden documents
+suspend the clock and resume with zero delta; subsequent deltas default to a
+100 ms ceiling. Use fixed simulation steps rather than tying production to
+frame count. Honor reduced motion when drawing decorative animation. Component
+destruction registers cleanup when available; controllers with their own
+disposal method call `stop()` there.
+
 Prefer CSS transitions or scroll-driven animation. Use the eager reduced-motion
 signal for anything beyond hover. Attach native browser observation in a mount
 hook and clean it up at component destruction:

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

@@ -21,9 +21,9 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/auth` | [`stacks-auth`](../stacks-auth/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/auth/src/index.ts) | 119 |
 | `@stacksjs/browser` | [`stacks-browser`](../stacks-browser/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/browser/src/index.ts) | 8 |
 | `@stacksjs/browser-extension` | [`stacks-browser-extension`](../stacks-browser-extension/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/browser-extension/src/index.ts) | 7 |
-| `@stacksjs/buddy` | [`stacks-buddy`](../stacks-buddy/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/buddy/src/index.ts) | 153 |
+| `@stacksjs/buddy` | [`stacks-buddy`](../stacks-buddy/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/buddy/src/index.ts) | 154 |
 | `@stacksjs/build` | [`stacks-build`](../stacks-build/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/build/src/index.ts) | 2 |
-| `@stacksjs/cache` | [`stacks-cache`](../stacks-cache/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cache/src/index.ts) | 11 |
+| `@stacksjs/cache` | [`stacks-cache`](../stacks-cache/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cache/src/index.ts) | 13 |
 | `@stacksjs/calendar-api` | [`stacks-calendar`](../stacks-calendar/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/calendar-api/src/index.ts) | 2 |
 | `@stacksjs/charts` | [`stacks-charts`](../stacks-charts/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/charts/src/index.ts) | 3 |
 | `@stacksjs/chat` | [`stacks-chat`](../stacks-chat/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/chat/src/index.ts) | 5 |
@@ -215,7 +215,7 @@ Read the entrypoint and package export map for re-exported or type-only surfaces
 
 Local source modules: [src/commands/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/buddy/src/commands/index.ts).
 
-Evidence directory: [153 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/buddy/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [154 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/buddy/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/build
 
@@ -233,7 +233,7 @@ Read the entrypoint and package export map for re-exported or type-only surfaces
 
 Local source modules: [src/drivers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cache/src/drivers/index.ts), [src/key.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cache/src/key.ts).
 
-Evidence directory: [11 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cache/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [13 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cache/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/calendar-api
 

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.250",
+  "version": "0.75.253",
   "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.250",
+  "version": "0.75.253",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -44,7 +44,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "0.75.250",
+    "@stacksjs/mobile": "0.75.253",
     "@stacksjs/sanitizer": "^0.2.534",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",

package/project/storage/framework/types/traits.d.ts

@@ -1,230 +0,0 @@
-import { Request } from '../core/router/src/request'
-
-interface ValidationRule {
-  validate: (value: unknown) => { valid: boolean, errors?: Array<{ message: string }> }
-}
-
-interface ValidationField {
-    rule: ValidationRule
-    message: Record<string, string>
-  }
-
-interface CustomAttributes {
-    [key: string]: ValidationField
-  }
-
-interface RequestDataMigrations {
-      name: string
-      timestamp: string
-    
-    }
-export interface MigrationsRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataMigrations
-      name: string
-      timestamp: string
-    
-    }
-
-interface RequestDataPasswordResets {
-      email: string
-      token: string
-      created_at: string
-    
-    }
-export interface PasswordResetsRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataPasswordResets
-      email: string
-      token: string
-      created_at: string
-    
-    }
-
-interface RequestDataPasskeys {
-      id: number
-      cred_public_key: string
-      user_id: number
-      webauthn_user_id: string
-      counter: number
-      credential_type: string
-      device_type: string
-      backup_eligible: boolean
-      backup_status: boolean
-      transports: string
-      created_at: string
-      updated_at: string
-      last_used_at: string
-    
-    }
-export interface PasskeysRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataPasskeys
-      id: number
-      cred_public_key: string
-      user_id: number
-      webauthn_user_id: string
-      counter: number
-      credential_type: string
-      device_type: string
-      backup_eligible: boolean
-      backup_status: boolean
-      transports: string
-      created_at: string
-      updated_at: string
-      last_used_at: string
-    
-    }
-
-interface RequestDataCommentables {
-      id: number
-      title: string
-      body: string
-      status: string
-      approved_at: number | null
-      rejected_at: number | null
-      commentables_id: number
-      commentables_type: string
-      user_id: number | null
-      created_at: string
-      updated_at: string | null
-    
-    }
-export interface CommentablesRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataCommentables
-      id: number
-      title: string
-      body: string
-      status: string
-      approved_at: number | null
-      rejected_at: number | null
-      commentables_id: number
-      commentables_type: string
-      user_id: number | null
-      created_at: string
-      updated_at: string | null
-    
-    }
-
-interface RequestDataCommentableUpvotes {
-      id: number
-      user_id: number
-      upvoteable_id: number
-      upvoteable_type: string
-      created_at: string
-    
-    }
-export interface CommentableUpvotesRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataCommentableUpvotes
-      id: number
-      user_id: number
-      upvoteable_id: number
-      upvoteable_type: string
-      created_at: string
-    
-    }
-
-interface RequestDataCategorizable {
-      id: number
-      name: string
-      slug: string
-      description: string
-      is_active: boolean
-      categorizable_type: string
-      created_at: string
-      updated_at: string
-    
-    }
-export interface CategorizableRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataCategorizable
-      id: number
-      name: string
-      slug: string
-      description: string
-      is_active: boolean
-      categorizable_type: string
-      created_at: string
-      updated_at: string
-    
-    }
-
-interface RequestDataTaggable {
-      id: number
-      name: string
-      slug: string
-      description: string
-      is_active: boolean
-      taggable_type: string
-      created_at: string
-      updated_at: string
-    
-    }
-export interface TaggableRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataTaggable
-      id: number
-      name: string
-      slug: string
-      description: string
-      is_active: boolean
-      taggable_type: string
-      created_at: string
-      updated_at: string
-    
-    }
-
-interface RequestDataTaggableModels {
-      id: number
-      tag_id: number
-      taggable_id: number
-      taggable_type: string
-      created_at: string
-      updated_at: string | null
-    
-    }
-export interface TaggableModelsRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataTaggableModels
-      id: number
-      tag_id: number
-      taggable_id: number
-      taggable_type: string
-      created_at: string
-      updated_at: string | null
-    
-    }
-
-interface RequestDataCategorizableModels {
-      id: number
-      category_id: number
-      categorizable_id: number
-      categorizable_type: string
-      created_at: string
-      updated_at: string | null
-    
-    }
-export interface CategorizableModelsRequestType extends Request {
-      validate(attributes?: CustomAttributes): void
-      get: <T = string>(element: string, defaultValue?: T) => T
-      all(): RequestDataCategorizableModels
-      id: number
-      category_id: number
-      categorizable_id: number
-      categorizable_type: string
-      created_at: string
-      updated_at: string | null
-    
-    }
-
-export type TraitRequest = MigrationsRequestType | PasswordResetsRequestType | PasskeysRequestType | CommentablesRequestType | CommentableUpvotesRequestType | CategorizableRequestType | TaggableRequestType | TaggableModelsRequestType | CategorizableModelsRequestType