create-apexjs 0.6.2 → 0.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-apexjs",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "Scaffold a new Apex JS app",
   "type": "module",
   "license": "MIT",

package/templates/default/AGENTS.md

@@ -20,6 +20,7 @@ an MCP tool**. This file tells you (the agent) how to work here effectively.
 apex make page dashboard          # pages/dashboard.alpine (a route → /dashboard)
 apex make component Card          # components/Card.alpine  (<Card /> in templates)
 apex make component ui/Navbar     # group in a folder → components/ui/Navbar.alpine (<UiNavbar />)
+apex make client                  # app.client.ts — register Alpine plugins/directives/magics
 apex make model Post title:string body:string   # models/Post.ts → migration + REST + MCP CRUD
 apex make api webhooks            # server/api/webhooks.ts (defineApexRoute; also an MCP tool)
 apex make service Billing         # services/BillingService.ts
@@ -32,7 +33,7 @@ apex check                        # type-check (tsc --noEmit; fast with the nati
 apex build --preset vercel        # build + Vercel config (also: netlify, docker); then deploy
 apex test                         # run Vitest
 ```
-`apex make <kind> …` kinds: `page component api service store layout middleware test model migration auth`.
+`apex make <kind> …` kinds: `page component api service store layout middleware test model migration auth client`.
 
 ## Project structure
 ```
@@ -48,18 +49,22 @@ locales/*.json      i18n catalogs. (from `apex extend i18n`)
 services/*.ts       Business logic (classes). Keep routes thin; delegate here.
 stores/*.ts         Global SSR-safe state ($store.x).
 composables/*.ts    Reusable client logic (useX) for <script client>.
+app.client.ts       Optional. Default-exports (Alpine) => {…}, run BEFORE Alpine.start() —
+                     register Alpine plugins ($persist, x-intersect, x-mask…), directives, magics.
 shared/*.ts         Types shared by server + client.
 tests/*.test.ts     Vitest. createTestApp boots the whole app in-process.
 ```
 
 ## The `.alpine` single-file component
+`.alpine` is **TypeScript-only** — `<script>` blocks are always TS; `lang` is optional
+(a `lang="js"` is a parse error).
 ```alpine
-<script server lang="ts">
+<script server>
   // Runs on the server. loader() data becomes the page's x-data (real HTML first).
   export function loader() { return { title: 'Hello' } }
   export function head() { return { title: 'Hello' } }   // SEO
 </script>
-<script client lang="ts">
+<script client>
   // Optional client-only logic; import composables here.
 </script>
 <template x-data>

package/templates/default/pages/about.alpine

@@ -1,4 +1,4 @@
-<script server lang="ts">
+<script server>
   export function loader() {
     return {}
   }

package/templates/default/pages/blog/[slug].alpine

@@ -1,4 +1,4 @@
-<script server lang="ts">
+<script server>
   import { PostService } from '../../services/PostService'
 
   const posts = new PostService()

package/templates/default/pages/blog/index.alpine

@@ -1,4 +1,4 @@
-<script server lang="ts">
+<script server>
   import { PostService } from '../../services/PostService'
 
   const posts = new PostService()

package/templates/default/pages/index.alpine

@@ -1,4 +1,4 @@
-<script server lang="ts">
+<script server>
   import { PostService } from '../services/PostService'
 
   const posts = new PostService()

package/templates/features/auth/pages/account.alpine

@@ -1,4 +1,4 @@
-<script server lang="ts">
+<script server>
   // The user resolved by server/auth.ts is seeded into locals — so the page
   // renders the signed-in state on the SERVER, no flash of "logged out".
   export function loader({ locals }: { locals: Record<string, unknown> }) {

package/templates/features/data/pages/guestbook.alpine

@@ -1,4 +1,4 @@
-<script server lang="ts">
+<script server>
   import { handle } from '../db/index.js'
 
   // Runs on the server: reads straight from the database, so the message list is

package/templates/features/i18n/pages/hello.alpine

@@ -1,4 +1,4 @@
-<script server lang="ts">
+<script server>
   // locals.t and locals.locale are injected by the i18n runtime once i18n is
   // declared in apex.config.ts. Translation happens on the server, so the HTML
   // arrives already localized — great for SEO.