@stacksjs/defaults 0.75.40 → 0.75.41

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

@@ -214,8 +214,20 @@ buddy desktop:apple:init       # generate the reusable GitHub Actions caller
 buddy desktop:apple:doctor     # validate Apple tooling, identities, profile, and API key
 buddy desktop:apple:package    # build, sandbox, sign, and create a Store .pkg
 buddy desktop:apple:publish    # validate or upload the package to App Store Connect
+buddy desktop:probe            # measure what a Craft window offers interactive/game content
 ```
 
+`desktop:probe` opens a visible Craft window (not `--headless`, which stops
+requestAnimationFrame) and measures WebGL2/WebGPU, frame pacing under load,
+input and audio latency, the Gamepad API, fullscreen and pointer lock.
+`--browser[=Safari]` runs the same page in a browser for comparison, and
+`--record` writes the result into `storage/framework/core/desktop/src/probe/results/`,
+which `buddy docs:capabilities` publishes in `docs/features/capabilities.md`.
+Probes that need a real click or key press are recorded as
+`requires-interaction`, never as a number. Stacks ships no game engine,
+physics or asset pipeline; this only says what an engine someone else wrote
+would get.
+
 ## Mac App Store
 
 Run `buddy desktop:apple:init`, then configure the repository variables and

package/app/Actions/Payment/CreatePaymentIntentAction.ts

@@ -30,7 +30,7 @@ export default new Action({
     // method is `createPayment`: `user.paymentIntent()` never existed.
     const paymentIntent = await user.createPayment(Number(product.get('price')), {
       currency: 'usd',
-      payment_method_types: ['card'],
+      allowed_payment_method_types: ['card'],
     })
 
     return response.json(paymentIntent)

package/app/Actions/Payment/CreateSetupIntentAction.ts

@@ -17,7 +17,7 @@ export default new Action({
       return response.error(BILLING_NOT_ENABLED, 503)
 
     const setupIntent = await user.createSetupIntent({
-      payment_method_types: ['card', 'link', 'us_bank_account'],
+      allowed_payment_method_types: ['card', 'link', 'us_bank_account'],
     })
 
     return response.json(setupIntent)

package/ide/vscode/.vscode/settings.json

@@ -117,7 +117,7 @@
   // Stacks
   "typescript.preferGoToSourceDefinition": true,
   "files.associations": {
-    "buddy": "typescript",
+    "buddy": "shellscript",
     "*.stx": "html"
   },
   "editor.quickSuggestions": {

package/ide/vscode/README.md

@@ -1,36 +1,81 @@
-# Stacks VS Code Extension Pack
+# Stacks for VS Code
 
-A collection of extensions for an enhanced developer experience while working on Stacks projects.
+Build a Stacks app without leaving the editor. Start the dev server, preview it in VS Code's built-in Simple Browser, and run any `buddy` command from the Command Palette. The extension also installs a small pack of extensions that Stacks projects are configured for.
 
-_Please note, the Stacks framework auto-configures any extension that needs to be configured._
+The extension activates in workspaces that contain a `buddy` file or a `config/app.ts`.
 
-## Extensions Included
+## Commands
+
+Open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) and type `Stacks`.
+
+| Command | What it does |
+|---|---|
+| **Stacks: Open Preview** | Opens the running dev server in the Simple Browser, beside your editor. If nothing is running, it offers to start the dev server. |
+| **Stacks: Start Dev Server** | Runs `./buddy dev` in a terminal named `Stacks Dev` at the project root. Once the server is up, the preview opens in the Simple Browser. |
+| **Stacks: Run Buddy Command...** | Lists every command `./buddy list` knows, including your own in `app/Commands/`. Pick one, and if it takes arguments you are asked for them. You can also type a full command line, such as `migrate --diff` or `make:model Post`. The command runs in a terminal named `Stacks Buddy`. |
+
+The **Stacks** item in the status bar opens the preview.
+
+Every command runs the project's own `./buddy`, relative to the workspace root. A `buddy` on your `PATH` or in `node_modules/.bin` is never used, because that name can also belong to an unrelated tool, such as the `@buddysh/buddy` dependency bot.
+
+## Finding the preview URL
+
+When the extension starts the dev server, it reads the URL `buddy dev` prints in its ready banner (for example `App: https://stacks.localhost/dashboard`). That URL already accounts for a shifted port and the app's entry page.
+
+Otherwise it works the URL out the same way `buddy dev` does, from `.env`, `.env.local`, `.env.development` and `.env.development.local`:
+
+- The frontend listens on `PORT`, or `3000` if it is not set.
+- If `APP_URL` (default `stacks.localhost`) is not a localhost address, the app is served at `https://<APP_URL>` through the local HTTPS proxy. `STACKS_DEV_LOCALHOST=1` turns this off.
+- `APP_PATH`, or `appPath` in `config/app.ts`, is appended as the entry page.
+
+The extension checks that the frontend port is accepting connections before it opens anything. It uses the `https://` URL only when the proxy answers too, and falls back to `http://localhost:<PORT>` otherwise. In a remote window (SSH, WSL, Codespaces) localhost URLs are port-forwarded automatically.
+
+## Settings
+
+| Setting | Default | Description |
+|---|---|---|
+| `stacks.preview.url` | `""` | Always open this URL, e.g. `http://localhost:3000/dashboard`. Leave empty to detect it. |
+| `stacks.preview.preferLocalhost` | `false` | Preview `http://localhost:<PORT>` even when `APP_URL` is a pretty `https://` domain. Use this if the Simple Browser stays blank because the local certificate is not trusted. |
+| `stacks.devServer.args` | `[]` | Extra arguments for `./buddy dev`, e.g. `["frontend"]` or `["--site"]`. |
+| `stacks.devServer.openPreview` | `true` | Open the Simple Browser once the dev server is up, instead of letting `buddy dev` open your system browser. |
+| `stacks.statusBar.enabled` | `true` | Show the Stacks status bar item. |
+
+The extension also sets a few editor defaults for Stacks projects: `.stx` files use HTML language support, the `buddy` script is highlighted as a shell script, `npm.packageManager` is `bun`, Go to Definition prefers source files over `.d.ts`, and TypeScript uses the workspace version.
+
+## Included extensions
 
-- Built-in HTML language support for `.stx` templates
-- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - Editor integration for the Pickier configuration
-- [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) - Markdown linting
-- [Goto Definition Alias](https://marketplace.visualstudio.com/items?itemName=antfu.goto-definition-alias) - Allows jumping to the definition of an aliased import
-- [NPM Intellisense](https://marketplace.visualstudio.com/items?itemName=christian-kohler.npm-intellisense) - Auto-completes package imports
 - [Bun for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=oven.bun-vscode) - Bun runtime and test integration
-- [Dotenvx](https://marketplace.visualstudio.com/items?itemName=dotenv.dotenvx-vscode) - Encrypted environment file support
-- [Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) - Simple source code spell checker for your code
+- [Dotenvx](https://marketplace.visualstudio.com/items?itemName=dotenv.dotenvx-vscode) - encrypted environment file support
+- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - editor integration for the project's lint rules
+- [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) - Markdown linting
+- [shell-format](https://marketplace.visualstudio.com/items?itemName=foxundermoon.shell-format) - shell script and Dockerfile formatting
+- [Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) - spell checking with the Stacks dictionary
+- [Total TypeScript Error Translator](https://marketplace.visualstudio.com/items?itemName=mattpocock.ts-error-translator) - plain-English TypeScript errors
+- [Prettify TypeScript](https://marketplace.visualstudio.com/items?itemName=mylesmurphy.prettify-ts) - readable type hovers
+- [Twoslash Query Comments](https://marketplace.visualstudio.com/items?itemName=Orta.vscode-twoslash-queries) - inline `// ^?` type queries
+- [AWS Toolkit](https://marketplace.visualstudio.com/items?itemName=amazonwebservices.aws-toolkit-vscode) - the AWS resources `buddy deploy` creates
 
-## Contributing
+Some extensions were dropped from the pack because VS Code now does the same thing itself:
 
-We welcome contributions to this extension pack.
+- **Goto Definition Alias**: built-in **Go to Source Definition**, which this extension enables by default.
+- **npm Intellisense**: TypeScript's built-in package import completions.
+- **DotENV**: VS Code's built-in `dotenv` language highlights `.env` and `.env.*` files.
+- **Gremlins**: built-in Unicode highlighting (`editor.unicodeHighlight.*`) flags invisible and confusable characters.
 
-## Local Usage
+## Development
 
 ```bash
-bun run package
-code --install-extension vscode-stacks-0.70.160.vsix
+bun run build      # bundle src/ into dist/extension.js
+bun test ./tests   # unit tests for URL detection, `buddy list` parsing and the commands
+bun run typecheck
+bun run package    # build and create a .vsix
+code --install-extension vscode-stacks-<version>.vsix
 ```
 
-_If you would like to add an extension, please open an issue or start a Discussion first 🙏🏼._
+The extension has no runtime dependencies. It is published automatically by the Stacks release workflow, and `vscode:prepublish` builds `dist/` first.
 
-## Relevant Links
+## Relevant links
 
 - [GitHub](https://github.com/stacksjs/stacks)
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=stacks.vscode-stacks)
-
-**Enjoy!**
+- [IDE setup guide](https://stacksjs.com/docs/bootcamp/how-to/ide-setup)

package/ide/vscode/package.json

@@ -2,8 +2,8 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.40",
-  "description": "A modern Stacks development environment.",
+  "version": "0.75.41",
+  "description": "Develop Stacks apps without leaving VS Code: preview the dev server in the Simple Browser, start it, and run any buddy command.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",
   "sponsor": {
@@ -21,35 +21,129 @@
   "keywords": [
     "stacks",
     "stacksjs",
-    "extension pack",
-    "stacks extension collection"
+    "buddy",
+    "preview",
+    "simple browser",
+    "dev server",
+    "extension pack"
   ],
   "categories": [
-    "Extension Packs"
+    "Extension Packs",
+    "Other"
   ],
   "icon": "logo.png",
+  "main": "./dist/extension.js",
   "files": [
     ".vscode/extensions.json",
     ".vscode/settings.json",
     ".vscode/stacks.code-snippets",
+    "dist/extension.js",
     "LICENSE.md",
+    "README.md",
     "logo.png"
   ],
   "engines": {
     "vscode": "^1.109.5"
   },
+  "extensionKind": [
+    "workspace"
+  ],
+  "activationEvents": [
+    "workspaceContains:buddy",
+    "workspaceContains:config/app.ts"
+  ],
+  "capabilities": {
+    "untrustedWorkspaces": {
+      "supported": false,
+      "description": "The Stacks commands run the workspace's own ./buddy script, so they need a trusted workspace."
+    },
+    "virtualWorkspaces": false
+  },
   "scripts": {
-    "package": "bunx --bun vsce package",
-    "release": "bunx --bun vsce publish"
+    "build": "bun build ./src/extension.ts --outdir dist --target node --format cjs --external vscode",
+    "vscode:prepublish": "bun run build",
+    "test": "bun test ./tests",
+    "typecheck": "bun x --bun tsc --noEmit -p tsconfig.json",
+    "package": "bunx --bun vsce package --no-dependencies",
+    "release": "bunx --bun vsce publish --no-dependencies"
   },
   "galleryBanner": {
     "color": "#d7e4f5",
     "theme": "light"
   },
   "contributes": {
+    "commands": [
+      {
+        "command": "stacks.openPreview",
+        "title": "Open Preview",
+        "category": "Stacks",
+        "icon": "$(globe)"
+      },
+      {
+        "command": "stacks.startDevServer",
+        "title": "Start Dev Server",
+        "category": "Stacks",
+        "icon": "$(play)"
+      },
+      {
+        "command": "stacks.runBuddyCommand",
+        "title": "Run Buddy Command...",
+        "category": "Stacks",
+        "icon": "$(terminal)"
+      }
+    ],
+    "menus": {
+      "commandPalette": [
+        {
+          "command": "stacks.openPreview",
+          "when": "stacks.isProject"
+        },
+        {
+          "command": "stacks.startDevServer",
+          "when": "stacks.isProject"
+        },
+        {
+          "command": "stacks.runBuddyCommand",
+          "when": "stacks.isProject"
+        }
+      ]
+    },
+    "configuration": {
+      "title": "Stacks",
+      "properties": {
+        "stacks.preview.url": {
+          "type": "string",
+          "default": "",
+          "markdownDescription": "URL `Stacks: Open Preview` always opens, e.g. `http://localhost:3000/dashboard`. Leave empty to find the running dev server the way `./buddy dev` picks its URL (`APP_URL`, `PORT`, `APP_PATH`)."
+        },
+        "stacks.preview.preferLocalhost": {
+          "type": "boolean",
+          "default": false,
+          "markdownDescription": "Preview `http://localhost:<PORT>` even when `APP_URL` gives the app a pretty `https://` domain. Useful when the local certificate is not trusted, which leaves the Simple Browser blank."
+        },
+        "stacks.devServer.args": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "markdownDescription": "Extra arguments for `./buddy dev`, e.g. `[\"frontend\"]` or `[\"--site\"]`. They are passed to the shell as written."
+        },
+        "stacks.devServer.openPreview": {
+          "type": "boolean",
+          "default": true,
+          "markdownDescription": "Open the preview in the Simple Browser once `Stacks: Start Dev Server` is up, instead of letting `./buddy dev` open the system browser."
+        },
+        "stacks.statusBar.enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show the Stacks item in the status bar, which opens the preview."
+        }
+      }
+    },
     "configurationDefaults": {
       "files.associations": {
-        "buddy": "typescript",
+        "buddy": "shellscript",
         "*.stx": "html"
       },
       "npm.packageManager": "bun",
@@ -60,15 +154,11 @@
   "extensionPack": [
     "dotenv.dotenvx-vscode",
     "amazonwebservices.aws-toolkit-vscode",
-    "antfu.goto-alias",
     "dbaeumer.vscode-eslint",
-    "christian-kohler.npm-intellisense",
     "davidanson.vscode-markdownlint",
     "foxundermoon.shell-format",
     "mattpocock.ts-error-translator",
-    "mikestead.dotenv",
     "mylesmurphy.prettify-ts",
-    "nhoizey.gremlins",
     "Orta.vscode-twoslash-queries",
     "oven.bun-vscode",
     "streetsidesoftware.code-spell-checker"

package/ide/vscode/src/extension.ts

@@ -0,0 +1,59 @@
+/**
+ * The extension entry VS Code loads (`main` in package.json, bundled to
+ * dist/extension.js). It only wires the real machine into the controller in
+ * ./stacks.ts; the behavior lives there and in ./project.ts.
+ */
+import type { Host } from './stacks'
+import { execFile } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { connect } from 'node:net'
+import * as vscode from 'vscode'
+import { createStacksExtension } from './stacks'
+
+const PROBE_TIMEOUT_MS = 500
+
+const host: Host = {
+  exists: path => existsSync(path),
+
+  read(path) {
+    try {
+      return readFileSync(path, 'utf8')
+    }
+    catch {
+      return undefined
+    }
+  },
+
+  exec(file, args, cwd) {
+    return new Promise((resolve, reject) => {
+      execFile(file, args, {
+        cwd,
+        timeout: 60_000,
+        maxBuffer: 32 * 1024 * 1024,
+        env: { ...process.env, NO_COLOR: '1', FORCE_COLOR: '0' },
+      }, (error, stdout) => error ? reject(error) : resolve(String(stdout)))
+    })
+  },
+
+  probe(hostname, port) {
+    return new Promise((resolve) => {
+      const socket = connect({ host: hostname, port })
+      const finish = (open: boolean) => {
+        socket.destroy()
+        resolve(open)
+      }
+
+      socket.setTimeout(PROBE_TIMEOUT_MS)
+      socket.once('connect', () => finish(true))
+      socket.once('timeout', () => finish(false))
+      socket.once('error', () => finish(false))
+    })
+  },
+
+  sleep: ms => new Promise(resolve => setTimeout(resolve, ms)),
+}
+
+const extension = createStacksExtension(vscode, host)
+
+export const activate = extension.activate
+export const deactivate = extension.deactivate