@stacksjs/defaults 0.74.42 → 0.74.43

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

@@ -1,6 +1,6 @@
 ---
 name: stacks-actions
-description: Use when working with Stacks server actions - creating actions in app/Actions/, auto-generated API actions from the useApi model trait, the 80+ default framework actions (auth, dashboard, commerce, content, deployment, jobs), action request/response handling, or action registration. Covers @stacksjs/actions and storage/framework/defaults/app/Actions/.
+description: Use when working with Stacks server actions - creating actions in app/Actions/, auto-generated API actions from the useApi model trait, the 634 default framework actions (auth, dashboard, commerce, content, deployment, jobs), action request/response handling, or action registration. Covers @stacksjs/actions and storage/framework/defaults/app/Actions/.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
 allowed-tools: Read Edit Write Bash Grep Glob

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

@@ -8,7 +8,54 @@ allowed-tools: Read Edit Write Bash Grep Glob
 
 # Stacks Composables
 
-90+ reactive composables for STX templates. All are auto-imported in STX templates.
+154 reactive composables for STX templates. **27 of them are auto-imported**;
+the rest need an explicit import from `@stacksjs/composables`.
+
+`storage/framework/browser-auto-imports.json` is the authority, and it declares
+83 names in total, 27 of which are `use*`. This page said "All are auto-imported
+in STX templates", which is the same mistake `AGENTS.md` carries a scar about
+under "200+ composables": an agent reaching for a name on that authority writes
+a template that does not run, and reads the failure as a framework bug.
+
+## The 27 you can write bare in a template
+
+Everything else on this page needs an explicit import, and that is most of what
+the sections below list - `useCounter`, `useLocalStorage`, `useMouse`,
+`useScroll`, `useIntersectionObserver` and `usePreferredReducedMotion` among
+them, which are exactly the names `AGENTS.md` calls out for having been wrongly
+listed as free.
+
+No count of how many fall on each side, deliberately. That number is
+maintained by hand and moves whenever a name is added to any section on this
+page - it was wrong within one edit of being written. The list below is the
+whole of the free side; anything not on it is on the other.
+
+<!-- auto-imported:begin - checked against browser-auto-imports.json by
+     core/server/tests/composables-skill-auto-imports.test.ts. Both directions:
+     every name here must be in the manifest, and every `use*` in the manifest
+     must be here. Edit the manifest, not this list. -->
+
+`useAbs`, `useAuth`, `useAverage`, `useCeil`, `useClamp`, `useDark`,
+`useDateFormat`, `useFetch`, `useFloor`, `useForm`, `useGitStore`, `useMax`,
+`useMin`, `useNow`, `useOnline`, `usePaymentStore`, `usePrecision`,
+`usePreferredDark`, `useQueueStore`, `useRound`, `useScrollLock`, `useStorage`,
+`useSum`, `useTimeoutFn`, `useToggle`, `useTrunc`, `useUserStore`.
+
+<!-- auto-imported:end -->
+
+A name not on that list is imported:
+
+```ts
+import { useCounter } from '@stacksjs/composables'
+```
+
+**And the 27 are free only in the STX script entry.** The injection does not
+reach a TypeScript module that entry imports - bindings there do not leak into
+bundled module scope - so a `.ts` file beside your template imports every one
+of these explicitly, same as any other name. `AGENTS.md` states the same limit
+under Auto-imports. Referencing an uninjected name is a ReferenceError thrown
+before any binding applies, which takes the whole page down rather than
+degrading the one call.
 
 ## Key Path
 - Core package: `storage/framework/core/composables/src/`
@@ -153,7 +200,9 @@ isRef(val)           // type guard
 - `and`, `or`, `logicNot`, `logicOr`
 
 ## Gotchas
-- All composables are auto-imported in STX templates — no import needed
+- Only 27 of the 154 composables are auto-imported in STX templates. Check
+  `storage/framework/browser-auto-imports.json` before relying on a bare name;
+  everything else needs `import { … } from '@stacksjs/composables'`
 - NEVER use vanilla JS (`var`, `document.*`, `window.*`) in STX `<script>` tags
 - Only use stx-compatible code: signals, composables, directives
 - Auto-imports defined in `storage/framework/browser-auto-imports.json`

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

@@ -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, 399 components, and a multi-section layout.
+The Stacks admin dashboard provides a full-featured admin panel with 100+ route views, 400 components, and a multi-section layout.
 
 ## Key Paths
 - Dashboard components: `storage/framework/defaults/resources/components/Dashboard/`

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

@@ -12,7 +12,7 @@ allowed-tools: Read Edit Write Bash Grep Glob
 - Database package: `storage/framework/core/database/src/`
 - Configuration: `config/database.ts`
 - QB config: `config/query-builder.ts`
-- Migrations: `database/migrations/` (96+ migration files, `.sql` format)
+- Migrations: `database/migrations/` (228 migration files, `.sql` format)
 - QB state: `.qb/`
 - ORM: `storage/framework/orm/`
 

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

@@ -1,6 +1,6 @@
 ---
 name: stacks-migrations
-description: Use when working with database migrations in a Stacks application - creating migration files, running migrations, fresh migration (drop + recreate), seeding after migration, migration file naming conventions, or the 96+ built-in migration files. For the database API itself (queries, connections, SQL helpers), see stacks-database.
+description: Use when working with database migrations in a Stacks application - creating migration files, running migrations, fresh migration (drop + recreate), seeding after migration, migration file naming conventions, or the 228 built-in migration files. For the database API itself (queries, connections, SQL helpers), see stacks-database.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript, SQLite >= 3.47.2
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -119,6 +119,6 @@ The framework includes migrations for all built-in models:
 - Do not commit a second snapshot under `.qb/`; that indicates a missing `snapshotDir` configuration
 - If a generated SQLite migration rebuilds tables, test it against a copy of the current database and run `PRAGMA integrity_check` plus `PRAGMA foreign_key_check`
 - `--seed` flag after `migrate:fresh` seeds the database with factory data
-- 96+ migration files exist by default for all framework models
+- 228 migration files exist by default for all framework models
 - SQLite >= 3.47.2 is required (system requirement)
 - For the database API (queries, connections), see the `stacks-database` skill

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

@@ -1,6 +1,6 @@
 ---
 name: stacks-models
-description: Use when working with data models in Stacks - the defineModel() API, model attributes with validation and factories, relationships (hasOne/hasMany/belongsTo/belongsToMany), traits (useAuth, useUuid, useTimestamps, useSearch, useApi, billable, taggable, categorizable, commentable, likeable, observe), computed properties (get/set), model generation, and the 50+ built-in framework models. Covers model definitions and storage/framework/defaults/app/Models/.
+description: Use when working with data models in Stacks - the defineModel() API, model attributes with validation and factories, relationships (hasOne/hasMany/belongsTo/belongsToMany), traits (useAuth, useUuid, useTimestamps, useSearch, useApi, billable, taggable, categorizable, commentable, likeable, observe), computed properties (get/set), model generation, and the 102 built-in framework models. Covers model definitions and storage/framework/defaults/app/Models/.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript, SQLite >= 3.47.2
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -262,7 +262,21 @@ A model with no `useSeeder` trait is never seeded. Auth and OAuth models are
 skipped on a non-fresh database so re-seeding cannot invalidate live sessions -
 pass `--allow-protected` to override.
 
-## All 62 built-in models by category
+## Built-in models by category
+
+The ones below are worth knowing by name. They are a selection, not the set:
+`storage/framework/defaults/app/Models/` holds 102, and that directory is the
+authority. This section said "All 62 built-in models by category" while
+listing fewer than that against 102 on disk, so an agent reading to the end
+had no way to tell it was short.
+
+No count of what this section itself lists, deliberately - that number is
+maintained by hand, drifts the moment anyone adds a bullet, and is the same
+habit that produced the "All 62". The total above is pinned by
+`buddy docs:agent-counts`.
+
+Run `find storage/framework/defaults/app/Models -name '*.ts'` for the full
+list, or `buddy list` for what a given project resolves.
 
 ### Users & Auth
 - **User** — name, email, password | traits: useAuth(passkey), useUuid, useTimestamps, useSocials(github) | hasOne: Subscriber, Driver, Author | hasMany: PersonalAccessToken, Customer

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

@@ -1,6 +1,6 @@
 ---
 name: stacks-orm
-description: Use when working with the Stacks ORM - defining models with defineModel(), model relationships (hasOne, hasMany, belongsTo, belongsToMany, morphOne, hasManyThrough), attributes, traits, factories, computed properties, query building, transactions, or the 50+ built-in models. Covers @stacksjs/orm, storage/framework/orm/, and storage/framework/defaults/app/Models/.
+description: Use when working with the Stacks ORM - defining models with defineModel(), model relationships (hasOne, hasMany, belongsTo, belongsToMany, morphOne, hasManyThrough), attributes, traits, factories, computed properties, query building, transactions, or the 102 built-in models. Covers @stacksjs/orm, storage/framework/orm/, and storage/framework/defaults/app/Models/.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript, SQLite >= 3.47.2
 allowed-tools: Read Edit Write Bash Grep Glob

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.74.42",
+  "version": "0.74.43",
   "description": "A modern Stacks development environment.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.74.42",
+  "version": "0.74.43",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -55,7 +55,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.27",
-    "@stacksjs/mobile": "^0.74.42",
+    "@stacksjs/mobile": "^0.74.43",
     "@stacksjs/sanitizer": "^0.2.113",
     "ts-qr-codes": "^0.1.8"
   }