@stacksjs/defaults 0.75.243 → 0.75.245

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

@@ -1,6 +1,6 @@
 ---
 name: stacks-dashboard
-description: Use when building or customizing the Stacks admin dashboard, including dashboard pages, model management views, analytics widgets, commerce dashboards, content management, settings panels, deployment monitoring, job/queue management, or the 414 built-in dashboard components. Covers the dashboard system at storage/framework/defaults/.
+description: Use when building or customizing the Stacks admin dashboard, including dashboard pages, model management views, analytics widgets, commerce dashboards, content management, settings panels, deployment monitoring, job/queue management, or the 413 built-in dashboard components. Covers the dashboard system at storage/framework/defaults/.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -8,7 +8,7 @@ allowed-tools: Read Edit Write Bash Grep Glob
 
 # Stacks Dashboard
 
-The Stacks admin dashboard provides a full-featured admin panel with 100+ route views, 414 components, and a multi-section layout.
+The Stacks admin dashboard provides a full-featured admin panel with 100+ route views, 413 components, and a multi-section layout.
 
 ## Key Paths
 - Dashboard components: `storage/framework/defaults/resources/components/Dashboard/`

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

@@ -21,7 +21,7 @@ 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) | 152 |
+| `@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/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/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 |
@@ -65,9 +65,9 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@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) | 16 |
 | `@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) | 63 |
+| `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 64 |
 | `@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) | 11 |
+| `@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/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 |
@@ -88,7 +88,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/socials` | [`stacks-socials`](../stacks-socials/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/socials/src/index.ts) | 17 |
 | `@stacksjs/storage` | [`stacks-storage`](../stacks-storage/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/storage/src/index.ts) | 42 |
 | `@stacksjs/strings` | [`stacks-strings`](../stacks-strings/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/strings/src/index.ts) | 7 |
-| `@stacksjs/testing` | [`stacks-testing`](../stacks-testing/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/index.ts) | 17 |
+| `@stacksjs/testing` | [`stacks-testing`](../stacks-testing/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/index.ts) | 18 |
 | `@stacksjs/tinker` | [`stacks-repl`](../stacks-repl/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/tinker/src/index.ts) | 1 |
 | `@stacksjs/tunnel` | [`stacks-tunnel`](../stacks-tunnel/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/tunnel/src/index.ts) | 1 |
 | `@stacksjs/types` | [`stacks-types`](../stacks-types/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/types/src/index.ts) | 2 |
@@ -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: [152 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: [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.
 
 ### @stacksjs/build
 
@@ -633,7 +633,7 @@ Declared runtime exports: `Activity`, `AnalyticsEvent`, `Auction`, `AuctionItem`
 
 Local source modules: [src/auto-crud.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/auto-crud.ts), [src/batch-loader.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/batch-loader.ts), [src/db.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/db.ts), [src/define-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/define-model.ts), [src/extend-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/extend-model.ts), [src/gdpr/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/gdpr/index.ts), [src/generate-database-schema.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/generate-database-schema.ts), [src/locked-row.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/locked-row.ts), [src/messaging.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/messaging.ts), [src/model-types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/model-types.ts), [src/ownership.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/ownership.ts), [src/paginator-request.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/paginator-request.ts), [src/row-token.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/row-token.ts), [src/subquery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/subquery.ts), [src/traits/audit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/audit.ts), [src/traits/billable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/billable.ts), [src/traits/categorizable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/categorizable.ts), [src/traits/commentable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/commentable.ts), [src/traits/likeable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/likeable.ts), [src/traits/taggable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/taggable.ts), [src/transaction.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/transaction.ts), [src/types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/types.ts), [src/utils/encrypted.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/encrypted.ts), [src/utils/prunable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/prunable.ts).
 
-Evidence directory: [63 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [64 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/pagination
 
@@ -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`, `frameworkPath`, `frameworkRuntimePath`, `functionsPath`, `gitPath`, `healthPath`, `homeDir`, `inspectDefaultsProvenance`, `installedDefaultsVersion`, `isAbsolute`, `isCompiledBinary`, `jobsPath`, `join`, `langPath`, `layoutsPath`, `libraryPackagePath`, `libsEntriesPath`, `libsPath`, `lintPath`, `listenersPath`, `loggingPath`, `logsPath`, `mergeDirectoryInto`, `modelMetaPath`, `modelsPath`, `modulesPath`, `newsletterPath`, `normalize`, `notificationsPath`, `objectsPath`, `onboardingPath`, `ormPath`, `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`, `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`, `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`, `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: [11 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: [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.
 
 ### @stacksjs/payments
 
@@ -851,7 +851,7 @@ Read the entrypoint and package export map for re-exported or type-only surfaces
 
 Local source modules: [src/console.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/console.ts), [src/disposable-database.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/disposable-database.ts), [src/events.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/events.ts), [src/feature.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/feature.ts), [src/isolated.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/isolated.ts), [src/mail.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/mail.ts), [src/time.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/src/time.ts).
 
-Evidence directory: [17 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [18 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/testing/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/tinker
 

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

@@ -91,11 +91,28 @@ buildEnginePath()
 libsEntriesPath()
 frameworkPath()                    // ~/storage/framework
 corePath()                         // ~/storage/framework/core
-frameworkPath('defaults')          // ~/storage/framework/defaults
+frameworkPath('defaults')          // the defaults tree (see below)
 defaultsAppPath()
 defaultsResourcesPath()
+frameworkDefaultsRoot()            // where that tree actually is
+usesVendoredDefaults()             // true when it is a real directory
+linkPackagedDefaults()             // (re)create the link; boot calls it
 ```
 
+`storagePath('framework/defaults/...')` and `frameworkPath('defaults/...')`
+resolve to `storage/framework/defaults` only when that is a real, vendored
+directory (the framework checkout, an app made with `--vendor-defaults` or
+`buddy publish:defaults`). Otherwise they resolve to the installed
+`node_modules/@stacksjs/defaults`. A new app keeps a gitignored
+`storage/framework/defaults` link to the package for people and tools, but
+framework code resolves the package itself: a module loaded through a link
+created after the process started fails in Bun.
+
+In code and templates, import a default by package name,
+`@stacksjs/defaults/<path>.ts`. `storage/framework/tsconfig.app.json` maps that
+onto a vendored tree when there is one and falls back to the package, so it
+resolves in every layout; `~/storage/framework/defaults/...` does not.
+
 ### Relative Path Variants
 Only some helpers have relative modes. Inspect the selected signature rather
 than deriving a function name from another path helper:

package/app/Actions/Dashboard/DashboardHomeAction.ts

@@ -193,6 +193,12 @@ export default new Action({
       })
     }
 
-    return { stats, httpMetrics, services, activities, issues }
+    // Which feature-backed sections exist, so the home page does not offer a
+    // card for a section the sidebar has hidden and whose pages cannot load.
+    // `feature()` is server-side only, and this component runs on the client.
+    // See stacksjs/stacks#2928.
+    const sections = { commerce, content: feature('cms'), marketing: feature('marketing') }
+
+    return { stats, httpMetrics, services, activities, issues, sections }
   },
 })

package/app/Actions/Dashboard/Models/ModelsIndexAction.ts

@@ -2,6 +2,7 @@ import { Action } from '@stacksjs/actions/runtime'
 import { existsSync, readdirSync } from 'node:fs'
 import { join } from 'node:path'
 import process from 'node:process'
+import { frameworkDefaultsRoot } from '@stacksjs/path'
 import { countRows } from '../../../../resources/functions/dashboard/data'
 import { dashboardOperationalError, dashboardOperationalIssue } from '../dashboard-response'
 import { resolveDashboardModel } from '../../../../resources/functions/dashboard/model-access'
@@ -123,7 +124,7 @@ export default new Action({
   async handle() {
     const cwd = process.cwd()
     const userlandDir = join(cwd, 'app', 'Models')
-    const defaultsDir = join(cwd, 'storage/framework/defaults/app/Models')
+    const defaultsDir = join(frameworkDefaultsRoot(), 'app/Models')
 
     let userland: Array<Omit<DiscoveredModel, 'source'>>
     let defaults: Array<Omit<DiscoveredModel, 'source'>>

package/app/Actions/Dashboard/Search/GlobalSearchAction.ts

@@ -4,6 +4,7 @@ import { env } from '@stacksjs/env'
 import { readdirSync } from 'node:fs'
 import { basename, extname, join } from 'node:path'
 import process from 'node:process'
+import { frameworkDefaultsRoot } from '@stacksjs/path'
 import { resolveDashboardModel } from '../../../../resources/functions/dashboard/model-access'
 import { dashboardOperationalError } from '../dashboard-response'
 
@@ -114,7 +115,7 @@ function iconForModel(name: string): string {
 }
 
 async function loadSearchableModels(): Promise<SearchableModel[]> {
-  const defaultsRoot = join(process.cwd(), 'storage/framework/defaults/app/Models')
+  const defaultsRoot = join(frameworkDefaultsRoot(), 'app/Models')
   const userRoot = join(process.cwd(), 'app/Models')
   const merged = new Map<string, string>()
 

package/app/Actions/Dashboard/Source/source-inventory.ts

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, statSync } from 'node:fs'
 import { basename, join, relative } from 'node:path'
+import { frameworkDefaultsRoot } from '@stacksjs/path'
 
 export interface SourceInventoryItem {
   name: string
@@ -71,7 +72,7 @@ export function parseCommandSource(
 export async function discoverActionSources(projectRoot: string): Promise<SourceInventoryItem[]> {
   const roots: SourceRoot[] = [
     {
-      directory: join(projectRoot, 'storage/framework/defaults/app/Actions'),
+      directory: join(frameworkDefaultsRoot(projectRoot), 'app/Actions'),
       origin: 'Framework',
     },
     {

package/app/Models/QueryLog.ts

@@ -142,38 +142,48 @@ export default defineModel({
         rule: schema.string().max(255),
       },
     },
+    // `text`, all of these: an EXPLAIN plan, the tables a query touched and the
+    // suggestions made about it run past the varchar(255) Postgres enforces, and
+    // a log row that does not fit is dropped ("value too long for type character
+    // varying(255)") - losing exactly the slow queries this table exists for.
     tags: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     affected_tables: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     indexes_used: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     missing_indexes: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     explain_plan: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     optimization_suggestions: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },

package/functions/dashboard.ts

@@ -39,6 +39,11 @@ export interface DashboardIssue {
 }
 
 interface DashboardHomeResponse {
+  /**
+   * Which feature-backed sections the server has available, so the home page
+   * only offers cards for sections that exist. See stacksjs/stacks#2928.
+   */
+  sections?: Record<string, boolean>
   stats?: Array<{ label: string, value: string }>
   httpMetrics?: DashboardHttpMetric[]
   services?: SystemHealthItem[]
@@ -98,6 +103,7 @@ export async function fetchDashboardHome(): Promise<DashboardHomeResponse> {
 }
 
 export function useDashboard() {
+  const sections = ref<Record<string, boolean>>({})
   const stats = ref<DashboardStats[]>([])
   const httpMetrics = ref<DashboardHttpMetric[]>([])
   const recentActivity = ref<ActivityItem[]>([])
@@ -109,6 +115,7 @@ export function useDashboard() {
   async function fetchDashboardStats(timeRange = '7d') {
     void timeRange
     const data = await fetchDashboardHome()
+    sections.value = data.sections && typeof data.sections === 'object' ? data.sections : {}
     stats.value = normalizeStats(data.stats)
     issues.value = Array.isArray(data.issues) ? data.issues : []
   }
@@ -132,7 +139,8 @@ export function useDashboard() {
 
     try {
       const data = await fetchDashboardHome()
-      stats.value = normalizeStats(data.stats)
+      sections.value = data.sections && typeof data.sections === 'object' ? data.sections : {}
+    stats.value = normalizeStats(data.stats)
       httpMetrics.value = Array.isArray(data.httpMetrics) ? data.httpMetrics : []
       recentActivity.value = normalizeActivities(data.activities)
       systemHealth.value = Array.isArray(data.services) ? data.services : []
@@ -157,6 +165,7 @@ export function useDashboard() {
   }
 
   return {
+    sections,
     stats,
     httpMetrics,
     recentActivity,

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.243",
+  "version": "0.75.245",
   "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.243",
+  "version": "0.75.245",
   "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.243",
+    "@stacksjs/mobile": "0.75.245",
     "@stacksjs/sanitizer": "^0.2.534",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",

package/project/storage/framework/tsconfig.app.json

@@ -17,6 +17,14 @@
       "Middleware/*": ["../../app/Middleware/*"],
       "Models/*": ["../../app/Models/*"],
       "Notifications/*": ["../../app/Notifications/*"],
+      // The framework defaults by package name. Lands on this project's
+      // `storage/framework/defaults` when there is one (a framework checkout, a
+      // vendored app, or the link to node_modules), and falls back to the
+      // installed `@stacksjs/defaults` when the mapped file does not exist -
+      // Bun and tsc both try the package after a `paths` miss. So one
+      // specifier resolves in every layout, which `~/storage/framework/
+      // defaults/...` does not.
+      "@stacksjs/defaults/*": ["./defaults/*"],
       "~/*": ["../../*"],
       "@/*": ["../../resources/*"]
     }

package/resources/components/Dashboard/Analytics/WebAnalyticsDashboard.stx

@@ -208,11 +208,11 @@ import type {
   PageData,
   ReferrerData,
   TrafficDataPoint,
-} from '~/storage/framework/defaults/functions/analytics'
-import { fetchWebAnalytics } from '~/storage/framework/defaults/functions/analytics'
-import { pushToast } from '~/storage/framework/defaults/functions/toasts'
-import type { ChartCtor, ChartLike } from '~/storage/framework/defaults/views/dashboard/composables/useChart'
-import { useChart } from '~/storage/framework/defaults/views/dashboard/composables/useChart'
+} from '@stacksjs/defaults/functions/analytics.ts'
+import { fetchWebAnalytics } from '@stacksjs/defaults/functions/analytics.ts'
+import { pushToast } from '@stacksjs/defaults/functions/toasts.ts'
+import type { ChartCtor, ChartLike } from '@stacksjs/defaults/views/dashboard/composables/useChart.ts'
+import { useChart } from '@stacksjs/defaults/views/dashboard/composables/useChart.ts'
 
 const analyticsOverview = state<AnalyticsOverview>({
   realtimeVisitors: 0,

package/resources/components/Dashboard/Ci/CiDashboard.stx

@@ -7,8 +7,8 @@
   //
   // No <script server>, no window./document. reads - per #1838 the page
   // is pure presentation against the store.
-  import { useRole } from '~/storage/framework/defaults/views/dashboard/composables/useRole'
-  import { ciStore } from '~/storage/framework/defaults/views/dashboard/stores/ci'
+  import { useRole } from '@stacksjs/defaults/views/dashboard/composables/useRole.ts'
+  import { ciStore } from '@stacksjs/defaults/views/dashboard/stores/ci.ts'
 
   // Import the store definition directly so its typed setup and persistence
   // are part of this page's client bundle. A name-only useStore('ci') lookup

package/resources/components/Dashboard/Ci/CiRunHistoryDrawer.stx

@@ -1,5 +1,5 @@
 <script client>
-import { ciStore } from '~/storage/framework/defaults/views/dashboard/stores/ci'
+import { ciStore } from '@stacksjs/defaults/views/dashboard/stores/ci.ts'
 
 const ci = ciStore
 const target = derived(() => ci.drilldown())

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

@@ -1,3 +1,5 @@
+@import('../UI/Table')
+
 <script client>
 import { dashboardApi } from '../../../../functions/dashboard-api'
 import { pushToast } from '../../../../functions/toasts'
@@ -23,7 +25,6 @@ const authors = state<AuthorRecord[]>([])
 const assignedPostCount = state(0)
 const loading = state(true)
 const loadError = state('')
-const search = state('')
 const formOpen = state(false)
 const editingAuthor = state<AuthorRecord | null>(null)
 const saving = state(false)
@@ -44,10 +45,33 @@ function normalize(record: any): AuthorRecord {
   }
 }
 
-function visibleAuthors(): AuthorRecord[] {
-  const query = search().trim().toLowerCase()
-  return authors().filter(author => !query || [author.name, author.email, author.bio]
-    .some(value => value.toLowerCase().includes(query)))
+const COLUMNS = [
+  // Slotted: the cell is an avatar, or the author's initials when there is no
+  // image, with the name and email beside it.
+  { key: 'name', label: 'Author', sortable: true, slotted: true },
+  { key: 'postCount', label: 'Posts', type: 'number' as const, sortable: true, class: 'text-gray-500 dark:text-neutral-400' },
+  { key: 'createdAt', label: 'Created', type: 'date' as const, sortable: true, emptyText: 'Unknown', class: 'text-gray-500 dark:text-neutral-400' },
+]
+
+const ROW_ACTIONS = [
+  { action: 'edit', label: 'Edit author', icon: 'i-hugeicons-edit-02' },
+  { action: 'delete', label: 'Delete author', icon: 'i-hugeicons-delete-02', class: 'text-red-500' },
+]
+
+/**
+ * `UI/Table` owns the search. `initialsLabel` is computed per row rather than
+ * called from the slot, because a slot body reads the row through attribute
+ * bindings and keeping the derivation here is one less thing to depend on.
+ */
+function visibleAuthors(): Array<AuthorRecord & { initialsLabel: string }> {
+  return authors().map(author => ({ ...author, initialsLabel: initials(author.name) }))
+}
+
+function handleRowAction(payload: { action: string, row: AuthorRecord }): void {
+  if (payload.action === 'edit')
+    openEdit(payload.row)
+  else
+    openDelete(payload.row)
 }
 
 function initials(value: string): string {
@@ -55,15 +79,6 @@ function initials(value: string): string {
     .map(part => part[0]?.toUpperCase() || '').join('') || '?'
 }
 
-function formatDate(value: string): string {
-  if (!value)
-    return 'Unknown'
-  const date = new Date(value)
-  return Number.isNaN(date.getTime())
-    ? value
-    : new Intl.DateTimeFormat('en-US', { month: 'short', day: 'numeric', year: 'numeric' }).format(date)
-}
-
 async function loadAuthors(): Promise<void> {
   loading.set(true)
   loadError.set('')
@@ -185,12 +200,36 @@ onMount(() => {
   </section>
 
   <section class="overflow-hidden bg-white dark:bg-neutral-800 border border-gray-200 rounded-lg dark:border-neutral-700">
-    <div class="p-4 border-b border-gray-200 dark:border-neutral-700"><label><span class="sr-only">Search authors</span><input x-model="search" type="search" placeholder="Search authors" class="px-3 py-2 max-w-md w-full text-gray-900 text-sm dark:text-white bg-white dark:bg-neutral-900 border border-gray-300 rounded-md dark:border-neutral-700" /></label></div>
-    <div class="overflow-x-auto"><table class="min-w-full divide-gray-200 divide-y dark:divide-neutral-700"><thead class="bg-gray-50 dark:bg-neutral-900/50"><tr><th class="px-4 py-3 font-semibold text-gray-600 text-left text-xs dark:text-neutral-300">Author</th><th class="px-4 py-3 font-semibold text-gray-600 text-left text-xs dark:text-neutral-300">Posts</th><th class="px-4 py-3 font-semibold text-gray-600 text-left text-xs dark:text-neutral-300">Created</th><th class="px-4 py-3"><span class="sr-only">Actions</span></th></tr></thead><tbody class="divide-gray-200 divide-y dark:divide-neutral-700">
-      <template :if="loading()"><tr><td colspan="4" class="px-4 py-12 text-center text-gray-500 text-sm dark:text-neutral-400"><span class="inline-block mr-2 h-4 w-4 animate-spin i-hugeicons-loading-03"></span>Loading authors</td></tr></template>
-      <template :else-if="visibleAuthors().length === 0"><tr><td colspan="4" class="px-4 py-14 text-center"><span class="inline-block h-6 w-6 text-gray-400 i-hugeicons-user-group"></span><p class="mt-2 font-medium text-gray-900 text-sm dark:text-white">No authors found</p><p class="mt-1 text-gray-500 text-sm dark:text-neutral-400">Adjust the search or create an author.</p></td></tr></template>
-      <template :else><template :for="author in visibleAuthors()"><tr><td class="px-4 py-3"><div class="flex gap-3 items-center"><div class="flex overflow-hidden flex-shrink-0 items-center justify-center h-9 w-9 font-semibold text-blue-700 text-xs dark:text-blue-300 bg-blue-50 dark:bg-blue-950/50 rounded-full"><img :if="author.avatar" :src="author.avatar" :alt="author.name" class="object-cover h-full w-full" /><span :else>{{ initials(author.name) }}</span></div><div class="min-w-0"><p class="font-medium text-gray-900 text-sm truncate dark:text-white">{{ author.name }}</p><p class="text-gray-500 text-xs truncate dark:text-neutral-400">{{ author.email }}</p></div></div></td><td class="px-4 py-3 text-gray-500 text-sm dark:text-neutral-400">{{ author.postCount }}</td><td class="px-4 py-3 text-gray-500 text-sm dark:text-neutral-400">{{ formatDate(author.createdAt) }}</td><td class="px-4 py-3"><div class="flex justify-end"><Button variant="ghost" size="sm" iconOnly :ariaLabel="'Edit author ' + author.name" @click="openEdit(author)"><span class="block h-4 w-4 text-blue-500 i-hugeicons-edit-02"></span></Button><Button variant="ghost" size="sm" iconOnly :ariaLabel="'Delete author ' + author.name" @click="openDelete(author)"><span class="block h-4 w-4 text-red-500 i-hugeicons-delete-02"></span></Button></div></td></tr></template></template>
-    </tbody></table></div>
+    {{-- Slot bodies read the row through `x-text` and `:attr`; an
+         interpolation in slot content is preserved but not evaluated on the
+         installed stx. See stacksjs/stx#2095. --}}
+    <Table
+      :columns="COLUMNS"
+      :data="visibleAuthors()"
+      :loading="loading()"
+      :row-actions="ROW_ACTIONS"
+      action-label-key="name"
+      searchable
+      search-placeholder="Search authors"
+      paginated
+      :page-size="25"
+      empty-title="No authors found"
+      empty-description="Adjust the search or create an author."
+      @row-action="handleRowAction"
+    >
+      <template #cell="{ row }">
+        <div class="flex gap-3 items-center">
+          <div class="flex overflow-hidden flex-shrink-0 items-center justify-center h-9 w-9 font-semibold text-blue-700 text-xs dark:text-blue-300 bg-blue-50 dark:bg-blue-950/50 rounded-full">
+            <img :if="row.avatar" :src="row.avatar" :alt="row.name" class="object-cover h-full w-full" />
+            <span :else x-text="row.initialsLabel"></span>
+          </div>
+          <div class="min-w-0">
+            <p class="font-medium text-gray-900 text-sm truncate dark:text-white" x-text="row.name"></p>
+            <p class="text-gray-500 text-xs truncate dark:text-neutral-400" x-text="row.email"></p>
+          </div>
+        </div>
+      </template>
+    </Table>
   </section>
 </div>
 

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

@@ -202,8 +202,8 @@ defineClientPayload({ blogUrl })
 <script client>
 // Plain async transport for /api/dashboard/blog, which reads and writes the
 // markdown files in content/blog. It owns no state; the signals below do.
-import type { BlogPost, BlogPostDraft } from '~/storage/framework/defaults/functions/blog'
-import { deleteBlogPost, fetchBlogPost, fetchBlogPosts, saveBlogPost } from '~/storage/framework/defaults/functions/blog'
+import type { BlogPost, BlogPostDraft } from '@stacksjs/defaults/functions/blog.ts'
+import { deleteBlogPost, fetchBlogPost, fetchBlogPosts, saveBlogPost } from '@stacksjs/defaults/functions/blog.ts'
 
 const publicBlogBaseUrl = {{ blogUrl }}
 

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

@@ -1,8 +1,8 @@
 <script client>
 import { dashboardApi } from '../../../../functions/dashboard-api'
 import { pushToast } from '../../../../functions/toasts'
-import type { ChartCtor, ChartDataset, ChartLike, ChartOptions } from '~/storage/framework/defaults/views/dashboard/composables/useChart'
-import { useChart } from '~/storage/framework/defaults/views/dashboard/composables/useChart'
+import type { ChartCtor, ChartDataset, ChartLike, ChartOptions } from '@stacksjs/defaults/views/dashboard/composables/useChart.ts'
+import { useChart } from '@stacksjs/defaults/views/dashboard/composables/useChart.ts'
 
 interface ContentPostSummary {
   id: number