@stacksjs/defaults 0.75.255 → 0.75.256

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

@@ -11,7 +11,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | Package | Task guidance | Source entry | Retained tests |
 |---|---|---|---|
 | `@stacksjs/action-runner` | [`stacks-actions`](../stacks-actions/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/action-runner/src/index.ts) | 1 |
-| `@stacksjs/actions` | [`stacks-actions`](../stacks-actions/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/index.ts) | 75 |
+| `@stacksjs/actions` | [`stacks-actions`](../stacks-actions/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/index.ts) | 76 |
 | `@stacksjs/ai` | [`stacks-ai`](../stacks-ai/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/ai/src/index.ts) | 17 |
 | `@stacksjs/alias` | [`stacks-alias`](../stacks-alias/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/alias/src/index.ts) | 1 |
 | `@stacksjs/analytics` | [`stacks-analytics`](../stacks-analytics/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/analytics/src/index.ts) | 6 |
@@ -37,7 +37,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/cron` | [`stacks-cron`](../stacks-cron/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cron/src/index.ts) | 4 |
 | `@stacksjs/database` | [`stacks-database`](../stacks-database/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/index.ts) | 125 |
 | `@stacksjs/datetime` | [`stacks-datetime`](../stacks-datetime/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/datetime/src/index.ts) | 13 |
-| `@stacksjs/defaults` | [`stacks-build`](../stacks-build/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/defaults/package.json) | 1 |
+| `@stacksjs/defaults` | [`stacks-build`](../stacks-build/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/defaults/package.json) | 2 |
 | `@stacksjs/deploy` | [`stacks-deploy`](../stacks-deploy/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/deploy/package.json) | 1 |
 | `@stacksjs/desktop-build` | [`stacks-desktop`](../stacks-desktop/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/desktop/src/index.ts) | 12 |
 | `@stacksjs/development` | [`stacks-development`](../stacks-development/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/development/package.json) | 1 |
@@ -67,7 +67,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/objects` | [`stacks-objects`](../stacks-objects/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/objects/src/index.ts) | 4 |
 | `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 65 |
 | `@stacksjs/pagination` | [`stacks-pagination`](../stacks-pagination/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/pagination/src/index.ts) | 0 |
-| `@stacksjs/path` | [`stacks-path`](../stacks-path/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/index.ts) | 12 |
+| `@stacksjs/path` | [`stacks-path`](../stacks-path/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/index.ts) | 13 |
 | `@stacksjs/payments` | [`stacks-payments`](../stacks-payments/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/payments/src/index.ts) | 28 |
 | `@stacksjs/push` | [`stacks-push`](../stacks-push/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/push/src/index.ts) | 6 |
 | `@stacksjs/query-builder` | [`stacks-query-builder`](../stacks-query-builder/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/query-builder/src/index.ts) | 6 |
@@ -115,11 +115,11 @@ Evidence directory: [1 retained tests](https://github.com/stacksjs/stacks/blob/m
 
 Guidance: [`stacks-actions`](../stacks-actions/SKILL.md). Source: [storage/framework/core/actions/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/index.ts).
 
-Declared runtime exports: `BlogAdminError`, `DEFAULT_IOS_DEPENDENCIES`, `DEFAULT_STX_LINT_CONFIG`, `IosToolchainError`, `XCODE_NOTE`, `blogSlugify`, `createComponent`, `createDatabase`, `createFactory`, `createFunction`, `createLanguage`, `createMail`, `createMiddleware`, `createMigration`, `createModel`, `createNotification`, `createPage`, `deleteBlogPost`, `describeDanglingRouteActions`, `describeGitHubRelease`, `discoverPackages`, `ensureDiscoveredPackages`, `findDanglingRouteActions`, `formatProject`, `getBlogPost`, `installStack`, `isDryRunActive`, `lintFix`, `lintProject`, `listBlogPosts`, `listStacks`, `loadIosDependencies`, `loadStxLintConfig`, `makeAction`, `makeCertificate`, `makeCommand`, `makeComponent`, `makeDatabase`, `makeFunction`, `makeJob`, `makeLanguage`, `makeMail`, `makeNotification`, `makePage`, `makePolicy`, `makeQueueTable`, `makeResource`, `makeStack`, `measureDefaultsDrift`, `pantryExecutable`, `pantryInstallArgs`, `parseFields`, `parseGitHubRemote`, `publishGitHubRelease`, `resolveXcodegen`, `runAdd`, `runCommit`, `runMake`, `runStxLint`, `saveBlogPost`, `scaffoldCrud`, `setDryRun`, `summarizeStructureChanges`, `uninstallStack`, `xcodeDeveloperDir`.
+Declared runtime exports: `BlogAdminError`, `DEFAULT_IOS_DEPENDENCIES`, `DEFAULT_STX_LINT_CONFIG`, `IosToolchainError`, `XCODE_NOTE`, `blogSlugify`, `createComponent`, `createDatabase`, `createFactory`, `createFunction`, `createLanguage`, `createMail`, `createMiddleware`, `createMigration`, `createModel`, `createNotification`, `createPage`, `deleteBlogPost`, `describeDanglingRouteActions`, `describeGitHubRelease`, `discoverPackages`, `ensureDiscoveredPackages`, `findDanglingRouteActions`, `formatProject`, `getBlogPost`, `installStack`, `isDryRunActive`, `lintFix`, `lintProject`, `listBlogPosts`, `listStacks`, `loadIosDependencies`, `loadStxLintConfig`, `makeAction`, `makeCertificate`, `makeCommand`, `makeComponent`, `makeDatabase`, `makeFunction`, `makeJob`, `makeLanguage`, `makeMail`, `makeNotification`, `makePage`, `makePolicy`, `makeQueueTable`, `makeResource`, `makeStack`, `measureDefaultsDrift`, `pantryExecutable`, `pantryInstallArgs`, `parseFields`, `parseGitHubRemote`, `publishGitHubRelease`, `resolveStxSource`, `resolveXcodegen`, `runAdd`, `runCommit`, `runMake`, `runStxLint`, `saveBlogPost`, `scaffoldCrud`, `setDryRun`, `summarizeStructureChanges`, `uninstallStack`, `xcodeDeveloperDir`.
 
-Local source modules: [src/action.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/action.ts), [src/add.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/add.ts), [src/blog-admin.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/blog-admin.ts), [src/build/ios-toolchain.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/build/ios-toolchain.ts), [src/commit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/commit.ts), [src/dev/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/dev/index.ts), [src/discover-packages.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/discover-packages.ts), [src/generate/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/generate/index.ts), [src/github-release.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/github-release.ts), [src/helpers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/helpers/index.ts), [src/library/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/library/index.ts), [src/lint/lint.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/lint/lint.ts), [src/lint/stx-gate.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/lint/stx-gate.ts), [src/make-command.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-command.ts), [src/make-job.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-job.ts), [src/make-policy.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-policy.ts), [src/make-resource.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-resource.ts), [src/make.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make.ts), [src/scaffold-crud.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/scaffold-crud.ts), [src/setup/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/setup/index.ts), [src/stacks.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/stacks.ts), [src/upgrade/package-project.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/upgrade/package-project.ts), [src/upgrade/route-actions.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/upgrade/route-actions.ts).
+Local source modules: [src/action.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/action.ts), [src/add.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/add.ts), [src/blog-admin.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/blog-admin.ts), [src/build/ios-toolchain.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/build/ios-toolchain.ts), [src/commit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/commit.ts), [src/dev/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/dev/index.ts), [src/discover-packages.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/discover-packages.ts), [src/generate/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/generate/index.ts), [src/github-release.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/github-release.ts), [src/helpers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/helpers/index.ts), [src/library/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/library/index.ts), [src/lint/lint.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/lint/lint.ts), [src/lint/stx-gate.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/lint/stx-gate.ts), [src/make-command.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-command.ts), [src/make-job.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-job.ts), [src/make-policy.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-policy.ts), [src/make-resource.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-resource.ts), [src/make.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make.ts), [src/scaffold-crud.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/scaffold-crud.ts), [src/setup/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/setup/index.ts), [src/stacks.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/stacks.ts), [src/stx-source.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/stx-source.ts), [src/upgrade/package-project.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/upgrade/package-project.ts), [src/upgrade/route-actions.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/upgrade/route-actions.ts).
 
-Evidence directory: [75 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [76 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/ai
 
@@ -369,7 +369,7 @@ Guidance: [`stacks-build`](../stacks-build/SKILL.md). Source: [storage/framework
 
 Read the entrypoint and package export map for re-exported or type-only surfaces.
 
-Evidence directory: [1 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/defaults/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [2 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/defaults/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/deploy
 
@@ -645,11 +645,11 @@ Declared runtime exports: `isCursorPaginator`, `isPaginator`, `isSimplePaginator
 
 Guidance: [`stacks-path`](../stacks-path/SKILL.md). Source: [storage/framework/core/path/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/index.ts).
 
-Declared runtime exports: `DEFAULTS_SYNC_MARKER`, `actionRunnerPath`, `actionsPath`, `aiPath`, `aliasPath`, `analyticsPath`, `appPath`, `applyRuntimeDirectoryEnv`, `arraysPath`, `assetsPath`, `authPath`, `basename`, `browserPath`, `buddyPath`, `buildEnginePath`, `buildPath`, `builtUserActionsPath`, `cachePath`, `chartsPath`, `chatPath`, `cliPath`, `cloudPath`, `cloudStatePath`, `collectionsPath`, `commandsPath`, `componentsPath`, `configPath`, `coreApiPath`, `coreEnvPath`, `corePath`, `coreStoragePath`, `customElementsDataPath`, `databasePath`, `datetimePath`, `defaultsAppPath`, `defaultsPackagePath`, `defaultsResourcesPath`, `delimiter`, `desktopPath`, `developmentPath`, `dirname`, `dnsPath`, `docsPath`, `emailPath`, `ensureRuntimeDirectories`, `enumsPath`, `errorHandlingPath`, `eslintPluginPath`, `eventsPath`, `examplesPath`, `extname`, `fakerPath`, `featureFlagsPath`, `featuresPath`, `findProjectPath`, `frameworkCloudPath`, `frameworkDefaultsRoot`, `frameworkPath`, `frameworkRuntimePath`, `functionsPath`, `gitPath`, `healthPath`, `homeDir`, `inspectDefaultsProvenance`, `installedDefaultsVersion`, `isAbsolute`, `isCompiledBinary`, `isInstalledDefaultsRoot`, `jobsPath`, `join`, `langPath`, `layoutsPath`, `libraryPackagePath`, `libsEntriesPath`, `libsPath`, `linkPackagedDefaults`, `lintPath`, `listenersPath`, `loggingPath`, `logsPath`, `mergeDirectoryInto`, `modelMetaPath`, `modelsPath`, `modulesPath`, `newsletterPath`, `normalize`, `notificationsPath`, `objectsPath`, `onboardingPath`, `ormPath`, `packagedDefaultsRoot`, `paginationPath`, `path`, `pathPath`, `paymentsPath`, `projectConfigPath`, `projectPath`, `publicPath`, `pushPath`, `queryBuilderPath`, `queuePath`, `realtimePath`, `relative`, `relativeActionsPath`, `replPath`, `resolve`, `resolveModulePath`, `resolveUserLibBase`, `resourcesPath`, `routerPath`, `routesPath`, `runtimeDirectoryEnv`, `runtimePath`, `schedulerPath`, `scriptsPath`, `searchEnginePath`, `securityPath`, `sep`, `serverPath`, `serverlessPath`, `settingsPath`, `shellPath`, `siteConfigPath`, `skillsPath`, `slugPath`, `smsPath`, `socialsPath`, `stacksBackupPath`, `stacksLockPath`, `stacksPath`, `storagePath`, `storesPath`, `stringsPath`, `stxPath`, `testingPath`, `testsPath`, `tinkerPath`, `toNamespacedPath`, `typesPath`, `uiPath`, `userActionsPath`, `userComponentsPath`, `userControllersPath`, `userDatabasePath`, `userEmailsPath`, `userEventsPath`, `userFunctionsPath`, `userJobsPath`, `userLibsPath`, `userListenersPath`, `userMailPath`, `userMiddlewarePath`, `userMigrationsPath`, `userModelsPath`, `userNotificationsPath`, `userServerPath`, `userViewsPath`, `usesVendoredDefaults`, `utilsPath`, `validationPath`, `viewsPath`.
+Declared runtime exports: `DEFAULTS_SYNC_MARKER`, `actionRunnerPath`, `actionsPath`, `aiPath`, `aliasPath`, `analyticsPath`, `appPath`, `applyRuntimeDirectoryEnv`, `arraysPath`, `assetsPath`, `authPath`, `basename`, `browserPath`, `buddyPath`, `buildEnginePath`, `buildPath`, `builtUserActionsPath`, `cachePath`, `chartsPath`, `chatPath`, `cliPath`, `cloudPath`, `cloudStatePath`, `collectionsPath`, `commandsPath`, `componentsPath`, `configPath`, `coreApiPath`, `coreEnvPath`, `corePath`, `coreStoragePath`, `customElementsDataPath`, `databasePath`, `datetimePath`, `defaultsAppPath`, `defaultsPackagePath`, `defaultsPath`, `defaultsResourcesPath`, `delimiter`, `desktopPath`, `developmentPath`, `dirname`, `dnsPath`, `docsPath`, `emailPath`, `ensureRuntimeDirectories`, `enumsPath`, `errorHandlingPath`, `eslintPluginPath`, `eventsPath`, `examplesPath`, `extname`, `fakerPath`, `featureFlagsPath`, `featuresPath`, `findProjectPath`, `frameworkCloudPath`, `frameworkDefaultsRoot`, `frameworkPath`, `frameworkRuntimePath`, `functionsPath`, `gitPath`, `healthPath`, `homeDir`, `inspectDefaultsProvenance`, `installedDefaultsVersion`, `isAbsolute`, `isCompiledBinary`, `isInstalledDefaultsRoot`, `jobsPath`, `join`, `langPath`, `layoutsPath`, `libraryPackagePath`, `libsEntriesPath`, `libsPath`, `linkPackagedDefaults`, `lintPath`, `listenersPath`, `loggingPath`, `logsPath`, `mergeDirectoryInto`, `modelMetaPath`, `modelsPath`, `modulesPath`, `newsletterPath`, `normalize`, `notificationsPath`, `objectsPath`, `onboardingPath`, `ormPath`, `packagedDefaultsRoot`, `paginationPath`, `path`, `pathPath`, `paymentsPath`, `projectConfigPath`, `projectPath`, `publicPath`, `pushPath`, `queryBuilderPath`, `queuePath`, `realtimePath`, `relative`, `relativeActionsPath`, `replPath`, `resolve`, `resolveModulePath`, `resolveUserLibBase`, `resourcesPath`, `routerPath`, `routesPath`, `runtimeDirectoryEnv`, `runtimePath`, `schedulerPath`, `scriptsPath`, `searchEnginePath`, `securityPath`, `sep`, `serverPath`, `serverlessPath`, `settingsPath`, `shellPath`, `siteConfigPath`, `skillsPath`, `slugPath`, `smsPath`, `socialsPath`, `stacksBackupPath`, `stacksLockPath`, `stacksPath`, `storagePath`, `storesPath`, `stringsPath`, `stxPath`, `testingPath`, `testsPath`, `tinkerPath`, `toNamespacedPath`, `typesPath`, `uiPath`, `userActionsPath`, `userComponentsPath`, `userControllersPath`, `userDatabasePath`, `userEmailsPath`, `userEventsPath`, `userFunctionsPath`, `userJobsPath`, `userLibsPath`, `userListenersPath`, `userMailPath`, `userMiddlewarePath`, `userMigrationsPath`, `userModelsPath`, `userNotificationsPath`, `userServerPath`, `userViewsPath`, `usesVendoredDefaults`, `utilsPath`, `validationPath`, `viewsPath`.
 
 Local source modules: [src/module-resolution.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/module-resolution.ts), [src/project.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/project.ts).
 
-Evidence directory: [12 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/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/path/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/payments
 

package/functions/api.ts

@@ -9,6 +9,55 @@ import { useAuth } from './auth'
 
 const baseUrl = resolveApiBaseUrl()
 
+/**
+ * Where this client is allowed to send a request from.
+ *
+ * `resolveApiBaseUrl()` answers with the relative `/api` when there is no
+ * `window.location` and no injected `__STACKS_API_URL__`, which is the honest
+ * answer for a browser bundle and deliberate (stacksjs/stacks#2421). `fetch`
+ * cannot use it: off the DOM there is no origin to resolve a relative URL
+ * against, so every verb below would reach `ERR_INVALID_URL` after building
+ * its headers, reading the auth token and serialising its body.
+ *
+ * That failure arrived as a bare `TypeError: fetch() URL is invalid` in a dev
+ * server log while the page still returned 200, which is how a dashboard
+ * template calling `post()` by accident during server-side rendering went
+ * unnoticed (stacksjs/stacks#2944). It is also only an accident that nothing
+ * was sent: with `__STACKS_API_URL__` injected for a split-origin deployment
+ * the URL is absolute, and the same mistake issues a real mutating request
+ * while a page renders.
+ *
+ * So refuse first, by name, before any of that work happens. This client is
+ * for the browser; server-side code has the ORM and the actions.
+ */
+function requestUrl(endpoint: string): string {
+  if (/^https?:\/\//i.test(baseUrl))
+    return `${baseUrl}${endpoint}`
+
+  throw new DashboardApiEnvironmentError(endpoint)
+}
+
+/**
+ * Thrown when a dashboard API verb is called where it cannot send a request.
+ *
+ * Named rather than generic: the thing worth knowing is which endpoint was
+ * about to be called from the wrong place, and the stack alone does not say
+ * so once the evaluator that called it is several frames of template
+ * machinery deep.
+ */
+export class DashboardApiEnvironmentError extends Error {
+  readonly endpoint: string
+
+  constructor(endpoint: string) {
+    super(
+      `The dashboard API client cannot request "${endpoint}" here: it needs an absolute base URL and resolved "${baseUrl}". `
+      + `This client runs in the browser. Server-side code should use the ORM or an action instead.`,
+    )
+    this.name = 'DashboardApiEnvironmentError'
+    this.endpoint = endpoint
+  }
+}
+
 export interface ApiResponse<T> {
   data: T
   message?: string
@@ -55,7 +104,7 @@ async function handleResponse<T>(response: Response): Promise<T> {
  * GET request
  */
 export async function get<T>(endpoint: string): Promise<T> {
-  const response = await fetch(`${baseUrl}${endpoint}`, {
+  const response = await fetch(requestUrl(endpoint), {
     method: 'GET',
     headers: createHeaders(),
   })
@@ -67,7 +116,7 @@ export async function get<T>(endpoint: string): Promise<T> {
  * POST request
  */
 export async function post<T>(endpoint: string, body?: unknown): Promise<T> {
-  const response = await fetch(`${baseUrl}${endpoint}`, {
+  const response = await fetch(requestUrl(endpoint), {
     method: 'POST',
     headers: createHeaders(),
     body: body ? JSON.stringify(body) : undefined,
@@ -80,7 +129,7 @@ export async function post<T>(endpoint: string, body?: unknown): Promise<T> {
  * PUT request
  */
 export async function put<T>(endpoint: string, body?: unknown): Promise<T> {
-  const response = await fetch(`${baseUrl}${endpoint}`, {
+  const response = await fetch(requestUrl(endpoint), {
     method: 'PUT',
     headers: createHeaders(),
     body: body ? JSON.stringify(body) : undefined,
@@ -93,7 +142,7 @@ export async function put<T>(endpoint: string, body?: unknown): Promise<T> {
  * PATCH request
  */
 export async function patch<T>(endpoint: string, body?: unknown): Promise<T> {
-  const response = await fetch(`${baseUrl}${endpoint}`, {
+  const response = await fetch(requestUrl(endpoint), {
     method: 'PATCH',
     headers: createHeaders(),
     body: body ? JSON.stringify(body) : undefined,
@@ -106,7 +155,7 @@ export async function patch<T>(endpoint: string, body?: unknown): Promise<T> {
  * DELETE request
  */
 export async function del<T>(endpoint: string): Promise<T> {
-  const response = await fetch(`${baseUrl}${endpoint}`, {
+  const response = await fetch(requestUrl(endpoint), {
     method: 'DELETE',
     headers: createHeaders(),
   })

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.255",
+  "version": "0.75.256",
   "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.255",
+  "version": "0.75.256",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -24,6 +24,7 @@
     "ide",
     "lang",
     "routes",
+    "scaffold",
     "stores",
     "styles",
     "types",
@@ -44,7 +45,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "0.75.255",
+    "@stacksjs/mobile": "0.75.256",
     "@stacksjs/sanitizer": "^0.2.534",
     "@stacksjs/stx": "^0.2.631",
     "@xterm/addon-fit": "^0.11.0",

package/resources/components/Dashboard/Content/BlogPostEditorDialog.stx

@@ -24,7 +24,11 @@ interface BlogPostDraft {
 }
 
 const open = useReactiveProp('open', false)
-const post = useReactiveProp('post', null as BlogPostRecord | null)
+// Named `editing`, not `post`, while still reading the `post` prop.
+// A bare `post` in a `{{ … }}` interpolation is resolved server-side
+// against module and global scope, where it finds the dashboard API
+// client's own `post()` and calls it mid-render (stacksjs/stacks#2944).
+const editing = useReactiveProp('post', null as BlogPostRecord | null)
 const loadedBody = useReactiveProp('loadedBody', '')
 const bodyLoading = useReactiveProp('bodyLoading', false)
 const bodyLoadFailed = useReactiveProp('bodyLoadFailed', false)
@@ -54,13 +58,13 @@ function slugify(input: string): string {
 const suggestedSlug = derived(() => slugify(title()))
 const wordCount = derived(() => body().split(/\s+/).filter(Boolean).length)
 const readingTime = derived(() => Math.max(1, Math.round(wordCount() / 200)))
-const dialogTitle = derived(() => post() ? 'Edit post' : 'New post')
-const actionLabel = derived(() => post() ? 'Save post' : 'Create post')
+const dialogTitle = derived(() => editing() ? 'Edit post' : 'New post')
+const actionLabel = derived(() => editing() ? 'Save post' : 'Create post')
 
 effect(() => {
   const isOpen = open()
   if (isOpen && !wasOpen) {
-    const record = post()
+    const record = editing()
     activeSlug = record?.slug || ''
     title.set(record?.title || '')
     slug.set(record?.slug || '')
@@ -76,7 +80,7 @@ effect(() => {
 })
 
 effect(() => {
-  if (open() && post()?.slug === activeSlug && !bodyLoading())
+  if (open() && editing()?.slug === activeSlug && !bodyLoading())
     body.set(loadedBody())
 })
 

package/resources/components/Dashboard/Content/PostEditorDialog.stx

@@ -28,7 +28,11 @@ interface PostDraft {
 }
 
 const open = useReactiveProp('open', false)
-const post = useReactiveProp('post', null as PostRecord | null)
+// Named `editing`, not `post`, while still reading the `post` prop.
+// A bare `post` in a `{{ … }}` interpolation is resolved server-side
+// against module and global scope, where it finds the dashboard API
+// client's own `post()` and calls it mid-render (stacksjs/stacks#2944).
+const editing = useReactiveProp('post', null as PostRecord | null)
 const categories = useReactiveProp('categories', [] as OptionRecord[])
 const tags = useReactiveProp('tags', [] as OptionRecord[])
 const authors = useReactiveProp('authors', [] as AuthorRecord[])
@@ -49,7 +53,7 @@ let wasOpen = false
 effect(() => {
   const isOpen = open()
   if (isOpen && !wasOpen) {
-    const record = post()
+    const record = editing()
     title.set(record?.title || '')
     excerpt.set(record?.excerpt || '')
     content.set(record?.content || '')
@@ -93,7 +97,7 @@ function submit(): void {
 
 <Modal
   :isOpen="open()"
-  :title="post() ? 'Edit post' : 'New post'"
+  :title="editing() ? 'Edit post' : 'New post'"
   description="Content, ownership, and taxonomies are persisted together."
   size="xl"
   :closable="!busy()"
@@ -169,7 +173,7 @@ function submit(): void {
     <div class="flex gap-2 justify-end w-full">
       <Button :disabled="busy()" variant="secondary" @click="close">Cancel</Button>
       <Button type="submit" form="post-editor-form" :disabled="!valid()" :loading="busy()">
-        {{ post() ? 'Save changes' : 'Create post' }}
+        {{ editing() ? 'Save changes' : 'Create post' }}
       </Button>
     </div>
   </template>

package/resources/functions/dashboard/data.ts

@@ -17,123 +17,110 @@
  */
 
 import { existsSync } from 'node:fs'
-import { basename, dirname, resolve } from 'node:path'
-
-let projectRootCache: string | null = null
-
-const VENDORED_DEFAULTS_PREFIX = 'storage/framework/defaults/'
-let defaultsRootCache: string | null = null
+import { basename, resolve } from 'node:path'
+import { defaultsPath, projectPath } from '@stacksjs/path'
 
 /**
- * The framework defaults tree: `storage/framework/defaults` in a project that
- * vendors it, `node_modules/@stacksjs/defaults` in one that does not. Counted
- * from this file first, which is inside that tree in both layouts; the project
- * root is the fallback for a copy that was bundled somewhere else.
+ * The project root, and where the defaults tree is, both from
+ * `@stacksjs/path`.
+ *
+ * This file used to hand-roll the walk, explicitly to avoid importing the
+ * path package, which was recorded as having "its own evaluation graph" that
+ * "would slow page renders". Measured rather than inherited: importing
+ * `@stacksjs/path` in this checkout costs 1.5-2.7ms, once per process because
+ * the module cache holds it, not once per render. `preloader.ts` next door
+ * already imports it.
+ *
+ * The walk also had to go, independently of cost. It anchored on a directory
+ * containing `storage/framework/defaults`, which is the one directory
+ * stacksjs/stacks#2941 is removing: in a project resolving its defaults from
+ * `node_modules`, the walk would find no anchor and fall through to
+ * `process.cwd()`, which is right only by luck.
  */
-function defaultsRoot(): string {
-  if (defaultsRootCache) return defaultsRootCache
-  const own = resolve(dirname(new URL(import.meta.url).pathname), '../../..')
-  const candidates = [
-    own,
-    resolve(projectRoot(), 'storage/framework/defaults'),
-    resolve(projectRoot(), 'node_modules/@stacksjs/defaults'),
-  ]
-  defaultsRootCache = candidates.find(candidate => existsSync(resolve(candidate, 'app/Models'))) ?? candidates[1]!
-  return defaultsRootCache
-}
-
 function projectRoot(): string {
-  if (projectRootCache) return projectRootCache
-  // Walk up from this file location to find the project root (the dir
-  // that contains `storage/framework`). This mirrors what
-  // `@stacksjs/path` does, but without pulling in the path package
-  // (which has its own evaluation graph and would slow page renders).
-  let dir = dirname(new URL(import.meta.url).pathname)
-  for (let i = 0; i < 12; i++) {
-    if (existsSync(resolve(dir, 'storage/framework'))) {
-      projectRootCache = dir
-      return dir
-    }
-    const parent = dirname(dir)
-    if (parent === dir) break
-    dir = parent
-  }
-  // Fall back to cwd — STX serves run from the project root.
-  projectRootCache = process.cwd()
-  return projectRootCache
+  return projectPath()
 }
 
 /**
- * Fast-path map of common model names to relative paths. The first existing
- * file wins, and user overrides always take priority over framework defaults.
- * A cached filesystem index below covers newly-added and nested models so
- * this map is an optimization rather than a correctness requirement.
+ * Fast-path map of common model names to the two places they can live:
+ * `[path under the project, path under the defaults tree]`.
+ *
+ * The first existing file wins, and user overrides always take priority over
+ * framework defaults. A cached filesystem index below covers newly-added and
+ * nested models, so this map is an optimization rather than a correctness
+ * requirement.
+ *
+ * The second element is relative to the defaults tree rather than to the
+ * project, because that tree is not always inside the project: it is
+ * `storage/framework/defaults` when the project vendors a current copy and the
+ * installed `@stacksjs/defaults` otherwise (stacksjs/stacks#2941). Fifty-five
+ * rows used to spell `storage/framework/defaults/` out by hand.
  */
-const MODEL_PATHS: Record<string, string[]> = {
+const MODEL_PATHS: Record<string, [string, string]> = {
   // Auth / core
-  User: ['app/Models/User.ts', 'storage/framework/defaults/app/Models/User.ts'],
-  Team: ['app/Models/Team.ts', 'storage/framework/defaults/app/Models/Team.ts'],
-  Subscriber: ['app/Models/Subscriber.ts', 'storage/framework/defaults/app/Models/Subscriber.ts'],
-  SubscriberEmail: ['app/Models/SubscriberEmail.ts', 'storage/framework/defaults/app/Models/SubscriberEmail.ts'],
-  Subscription: ['app/Models/Subscription.ts', 'storage/framework/defaults/app/Models/Subscription.ts'],
+  User: ['app/Models/User.ts', 'app/Models/User.ts'],
+  Team: ['app/Models/Team.ts', 'app/Models/Team.ts'],
+  Subscriber: ['app/Models/Subscriber.ts', 'app/Models/Subscriber.ts'],
+  SubscriberEmail: ['app/Models/SubscriberEmail.ts', 'app/Models/SubscriberEmail.ts'],
+  Subscription: ['app/Models/Subscription.ts', 'app/Models/Subscription.ts'],
 
   // Content
-  Post: ['app/Models/Post.ts', 'storage/framework/defaults/app/Models/Content/Post.ts'],
-  Page: ['app/Models/Page.ts', 'storage/framework/defaults/app/Models/Content/Page.ts'],
-  Author: ['app/Models/Author.ts', 'storage/framework/defaults/app/Models/Content/Author.ts'],
-  Comment: ['app/Models/Comment.ts', 'storage/framework/defaults/app/Models/Comment.ts'],
-  Tag: ['app/Models/Tag.ts', 'storage/framework/defaults/app/Models/Tag.ts'],
-  Category: ['app/Models/Category.ts', 'storage/framework/defaults/app/Models/commerce/Category.ts'],
+  Post: ['app/Models/Post.ts', 'app/Models/Content/Post.ts'],
+  Page: ['app/Models/Page.ts', 'app/Models/Content/Page.ts'],
+  Author: ['app/Models/Author.ts', 'app/Models/Content/Author.ts'],
+  Comment: ['app/Models/Comment.ts', 'app/Models/Comment.ts'],
+  Tag: ['app/Models/Tag.ts', 'app/Models/Tag.ts'],
+  Category: ['app/Models/Category.ts', 'app/Models/commerce/Category.ts'],
 
   // App / operations
-  Activity: ['app/Models/Activity.ts', 'storage/framework/defaults/app/Models/Activity.ts'],
-  Deployment: ['app/Models/Deployment.ts', 'storage/framework/defaults/app/Models/Deployment.ts'],
-  Release: ['app/Models/Release.ts', 'storage/framework/defaults/app/Models/Release.ts'],
-  Notification: ['app/Models/Notification.ts', 'storage/framework/defaults/app/Models/Notification.ts'],
-  Job: ['app/Models/Job.ts', 'storage/framework/defaults/app/Models/Job.ts'],
-  FailedJob: ['app/Models/FailedJob.ts', 'storage/framework/defaults/app/Models/FailedJob.ts'],
-  Log: ['app/Models/Log.ts', 'storage/framework/defaults/app/Models/Log.ts'],
-  Request: ['app/Models/Request.ts', 'storage/framework/defaults/app/Models/Request.ts'],
-  Error: ['app/Models/Error.ts', 'storage/framework/defaults/app/Models/Error.ts'],
-  Websocket: ['app/Models/Websocket.ts', 'storage/framework/defaults/app/Models/realtime/Websocket.ts'],
+  Activity: ['app/Models/Activity.ts', 'app/Models/Activity.ts'],
+  Deployment: ['app/Models/Deployment.ts', 'app/Models/Deployment.ts'],
+  Release: ['app/Models/Release.ts', 'app/Models/Release.ts'],
+  Notification: ['app/Models/Notification.ts', 'app/Models/Notification.ts'],
+  Job: ['app/Models/Job.ts', 'app/Models/Job.ts'],
+  FailedJob: ['app/Models/FailedJob.ts', 'app/Models/FailedJob.ts'],
+  Log: ['app/Models/Log.ts', 'app/Models/Log.ts'],
+  Request: ['app/Models/Request.ts', 'app/Models/Request.ts'],
+  Error: ['app/Models/Error.ts', 'app/Models/Error.ts'],
+  Websocket: ['app/Models/Websocket.ts', 'app/Models/realtime/Websocket.ts'],
 
   // Marketing
-  Campaign: ['app/Models/Campaign.ts', 'storage/framework/defaults/app/Models/Campaign.ts'],
-  EmailList: ['app/Models/EmailList.ts', 'storage/framework/defaults/app/Models/EmailList.ts'],
-  SocialPost: ['app/Models/SocialPost.ts', 'storage/framework/defaults/app/Models/SocialPost.ts'],
+  Campaign: ['app/Models/Campaign.ts', 'app/Models/Campaign.ts'],
+  EmailList: ['app/Models/EmailList.ts', 'app/Models/EmailList.ts'],
+  SocialPost: ['app/Models/SocialPost.ts', 'app/Models/SocialPost.ts'],
 
   // Commerce
-  Order: ['app/Models/Order.ts', 'storage/framework/defaults/app/Models/commerce/Order.ts'],
-  OrderItem: ['app/Models/OrderItem.ts', 'storage/framework/defaults/app/Models/commerce/OrderItem.ts'],
-  Cart: ['app/Models/Cart.ts', 'storage/framework/defaults/app/Models/commerce/Cart.ts'],
-  CartItem: ['app/Models/CartItem.ts', 'storage/framework/defaults/app/Models/commerce/CartItem.ts'],
-  Customer: ['app/Models/Customer.ts', 'storage/framework/defaults/app/Models/commerce/Customer.ts'],
-  Product: ['app/Models/Product.ts', 'storage/framework/defaults/app/Models/commerce/Product.ts'],
-  ProductVariant: ['app/Models/ProductVariant.ts', 'storage/framework/defaults/app/Models/commerce/ProductVariant.ts'],
-  ProductUnit: ['app/Models/ProductUnit.ts', 'storage/framework/defaults/app/Models/commerce/ProductUnit.ts'],
-  Manufacturer: ['app/Models/Manufacturer.ts', 'storage/framework/defaults/app/Models/commerce/Manufacturer.ts'],
-  Coupon: ['app/Models/Coupon.ts', 'storage/framework/defaults/app/Models/commerce/Coupon.ts'],
-  GiftCard: ['app/Models/GiftCard.ts', 'storage/framework/defaults/app/Models/commerce/GiftCard.ts'],
-  LicenseKey: ['app/Models/LicenseKey.ts', 'storage/framework/defaults/app/Models/commerce/LicenseKey.ts'],
-  Review: ['app/Models/Review.ts', 'storage/framework/defaults/app/Models/commerce/Review.ts'],
-  Receipt: ['app/Models/Receipt.ts', 'storage/framework/defaults/app/Models/commerce/Receipt.ts'],
-  PrintDevice: ['app/Models/PrintDevice.ts', 'storage/framework/defaults/app/Models/commerce/PrintDevice.ts'],
-  ShippingMethod: ['app/Models/ShippingMethod.ts', 'storage/framework/defaults/app/Models/commerce/ShippingMethod.ts'],
-  ShippingRate: ['app/Models/ShippingRate.ts', 'storage/framework/defaults/app/Models/commerce/ShippingRate.ts'],
-  ShippingZone: ['app/Models/ShippingZone.ts', 'storage/framework/defaults/app/Models/commerce/ShippingZone.ts'],
-  DeliveryRoute: ['app/Models/DeliveryRoute.ts', 'storage/framework/defaults/app/Models/commerce/DeliveryRoute.ts'],
-  DigitalDelivery: ['app/Models/DigitalDelivery.ts', 'storage/framework/defaults/app/Models/commerce/DigitalDelivery.ts'],
-  Courier: ['app/Models/Courier.ts', 'storage/framework/defaults/app/Models/commerce/Courier.ts'],
-  TaxRate: ['app/Models/TaxRate.ts', 'storage/framework/defaults/app/Models/commerce/TaxRate.ts'],
-  WaitlistProduct: ['app/Models/WaitlistProduct.ts', 'storage/framework/defaults/app/Models/commerce/WaitlistProduct.ts'],
-  WaitlistRestaurant: ['app/Models/WaitlistRestaurant.ts', 'storage/framework/defaults/app/Models/commerce/WaitlistRestaurant.ts'],
-  LoyaltyPoint: ['app/Models/LoyaltyPoint.ts', 'storage/framework/defaults/app/Models/commerce/LoyaltyPoint.ts'],
-  LoyaltyReward: ['app/Models/LoyaltyReward.ts', 'storage/framework/defaults/app/Models/commerce/LoyaltyReward.ts'],
-  Payment: ['app/Models/Payment.ts', 'storage/framework/defaults/app/Models/commerce/Payment.ts'],
-  PaymentMethod: ['app/Models/PaymentMethod.ts', 'storage/framework/defaults/app/Models/PaymentMethod.ts'],
-  PaymentProduct: ['app/Models/PaymentProduct.ts', 'storage/framework/defaults/app/Models/PaymentProduct.ts'],
-  PaymentTransaction: ['app/Models/PaymentTransaction.ts', 'storage/framework/defaults/app/Models/PaymentTransaction.ts'],
-  Transaction: ['app/Models/Transaction.ts', 'storage/framework/defaults/app/Models/commerce/Transaction.ts'],
+  Order: ['app/Models/Order.ts', 'app/Models/commerce/Order.ts'],
+  OrderItem: ['app/Models/OrderItem.ts', 'app/Models/commerce/OrderItem.ts'],
+  Cart: ['app/Models/Cart.ts', 'app/Models/commerce/Cart.ts'],
+  CartItem: ['app/Models/CartItem.ts', 'app/Models/commerce/CartItem.ts'],
+  Customer: ['app/Models/Customer.ts', 'app/Models/commerce/Customer.ts'],
+  Product: ['app/Models/Product.ts', 'app/Models/commerce/Product.ts'],
+  ProductVariant: ['app/Models/ProductVariant.ts', 'app/Models/commerce/ProductVariant.ts'],
+  ProductUnit: ['app/Models/ProductUnit.ts', 'app/Models/commerce/ProductUnit.ts'],
+  Manufacturer: ['app/Models/Manufacturer.ts', 'app/Models/commerce/Manufacturer.ts'],
+  Coupon: ['app/Models/Coupon.ts', 'app/Models/commerce/Coupon.ts'],
+  GiftCard: ['app/Models/GiftCard.ts', 'app/Models/commerce/GiftCard.ts'],
+  LicenseKey: ['app/Models/LicenseKey.ts', 'app/Models/commerce/LicenseKey.ts'],
+  Review: ['app/Models/Review.ts', 'app/Models/commerce/Review.ts'],
+  Receipt: ['app/Models/Receipt.ts', 'app/Models/commerce/Receipt.ts'],
+  PrintDevice: ['app/Models/PrintDevice.ts', 'app/Models/commerce/PrintDevice.ts'],
+  ShippingMethod: ['app/Models/ShippingMethod.ts', 'app/Models/commerce/ShippingMethod.ts'],
+  ShippingRate: ['app/Models/ShippingRate.ts', 'app/Models/commerce/ShippingRate.ts'],
+  ShippingZone: ['app/Models/ShippingZone.ts', 'app/Models/commerce/ShippingZone.ts'],
+  DeliveryRoute: ['app/Models/DeliveryRoute.ts', 'app/Models/commerce/DeliveryRoute.ts'],
+  DigitalDelivery: ['app/Models/DigitalDelivery.ts', 'app/Models/commerce/DigitalDelivery.ts'],
+  Courier: ['app/Models/Courier.ts', 'app/Models/commerce/Courier.ts'],
+  TaxRate: ['app/Models/TaxRate.ts', 'app/Models/commerce/TaxRate.ts'],
+  WaitlistProduct: ['app/Models/WaitlistProduct.ts', 'app/Models/commerce/WaitlistProduct.ts'],
+  WaitlistRestaurant: ['app/Models/WaitlistRestaurant.ts', 'app/Models/commerce/WaitlistRestaurant.ts'],
+  LoyaltyPoint: ['app/Models/LoyaltyPoint.ts', 'app/Models/commerce/LoyaltyPoint.ts'],
+  LoyaltyReward: ['app/Models/LoyaltyReward.ts', 'app/Models/commerce/LoyaltyReward.ts'],
+  Payment: ['app/Models/Payment.ts', 'app/Models/commerce/Payment.ts'],
+  PaymentMethod: ['app/Models/PaymentMethod.ts', 'app/Models/PaymentMethod.ts'],
+  PaymentProduct: ['app/Models/PaymentProduct.ts', 'app/Models/PaymentProduct.ts'],
+  PaymentTransaction: ['app/Models/PaymentTransaction.ts', 'app/Models/PaymentTransaction.ts'],
+  Transaction: ['app/Models/Transaction.ts', 'app/Models/commerce/Transaction.ts'],
 }
 
 const modelCache = new Map<string, any>()
@@ -153,7 +140,7 @@ async function discoverModelPaths(): Promise<Map<string, string[]>> {
     const paths = new Map<string, string[]>()
     const modelRoots = [
       resolve(root, 'app/Models'),
-      resolve(defaultsRoot(), 'app/Models'),
+      defaultsPath('app/Models'),
     ]
 
     for (const modelsRoot of modelRoots) {
@@ -178,11 +165,11 @@ async function discoverModelPaths(): Promise<Map<string, string[]>> {
 }
 
 async function modelCandidatePaths(name: string): Promise<string[]> {
-  const root = projectRoot()
   const discovered = (await discoverModelPaths()).get(name) ?? []
-  const explicit = (MODEL_PATHS[name] ?? []).map(path => path.startsWith(VENDORED_DEFAULTS_PREFIX)
-    ? resolve(defaultsRoot(), path.slice(VENDORED_DEFAULTS_PREFIX.length))
-    : resolve(root, path))
+  const entry = MODEL_PATHS[name]
+  const explicit = entry
+    ? [resolve(projectRoot(), entry[0]), defaultsPath(entry[1])]
+    : []
   return [...new Set([...discovered, ...explicit])]
 }
 

package/resources/functions/dashboard/sidebar.ts

@@ -111,15 +111,41 @@ interface NavItem {
 }
 
 /**
- * Pull the discovered-models manifest `buddy dev:dashboard` writes into the
- * project's runtime state.
- * Returns the default empty payload when the file is absent (fresh project
+ * Where `buddy dev --dashboard` writes the discovered-models manifest, and
+ * where this reads it: under `storage/framework/runtime/`, which `.gitignore`
+ * covers.
+ */
+export const DISCOVERED_MANIFEST_PATH = 'storage/framework/runtime/dashboard/.discovered-models.json'
+
+/**
+ * Where it used to be written, inside the vendored framework tree.
+ *
+ * Read as a fallback rather than dropped, because an app that upgrades does
+ * not get a new manifest until its next `buddy dev --dashboard` - and without
+ * this it would render an empty sidebar until then. New writes only ever go
+ * to the path above.
+ */
+export const LEGACY_DISCOVERED_MANIFEST_PATH = 'storage/framework/defaults/views/dashboard/.discovered-models.json'
+
+/** The first of the two manifest paths that exists, or null when neither does. */
+function discoveredManifestPath(cwd: string): string | null {
+  for (const rel of [DISCOVERED_MANIFEST_PATH, LEGACY_DISCOVERED_MANIFEST_PATH]) {
+    const candidate = resolve(cwd, rel)
+    if (existsSync(candidate))
+      return candidate
+  }
+  return null
+}
+
+/**
+ * Pull the discovered-models manifest written by the dashboard dev server.
+ * Returns the default empty payload when neither path has one (fresh project
  * before the first dashboard run regenerates it).
  */
 export function loadDiscoveredManifest(
-  manifestPath = resolve(process.cwd(), 'storage/framework/runtime/dashboard/discovered-models.json'),
+  manifestPath = discoveredManifestPath(process.cwd()),
 ): DiscoveredManifest {
-  if (!existsSync(manifestPath))
+  if (manifestPath === null || !existsSync(manifestPath))
     return { models: [], sections: defaultToggles(), nav: [] }
 
   try {