kreftjs 0.0.7-beta → 0.0.9-beta

package/templates/app/README.md

@@ -22,12 +22,12 @@ Your project cleanly isolates client-side UI (`frontend/`) from server-side busi
 ```text
 ├── frontend/                  # Public client application (the only folder served to browsers)
 │   ├── index.html             # HTML entry, auth store, router & app bootstrap
-│   ├── App.kreftjs              # Root reactive shell
-│   ├── routes/web.kreftjs       # Client-side routes (Dashboard, Users, Profile, Auth)
-│   ├── layouts/               # app.kreftjs (authenticated shell) & guest.kreftjs (auth pages)
+│   ├── App.kreft              # Root reactive shell
+│   ├── routes/web.kreft       # Client-side routes (Dashboard, Users, Profile, Auth)
+│   ├── layouts/               # app.kreft (authenticated shell) & guest.kreft (auth pages)
 │   ├── pages/                 # Route views (Home, Dashboard, Users, Profile, auth/*)
-│   ├── components/            # Reusable widgets (Field.kreftjs, StatCard.kreftjs, profile/*)
-│   ├── errors/                # Custom HTTP error views (404.kreftjs, 500.kreftjs, ErrorMonitor.kreftjs)
+│   ├── components/            # Reusable widgets (Field.kreft, StatCard.kreft, profile/*)
+│   ├── errors/                # Custom HTTP error views (404.kreft, 500.kreft, ErrorMonitor.kreft)
 │   ├── docs/                  # Built-in copy of the documentation (at /docs); the pages link to PUBLIC_DOCS_URL, http://kreftjs.com
 │   └── ui.css                 # Design system tokens & component styles
 │
@@ -50,7 +50,7 @@ Your project cleanly isolates client-side UI (`frontend/`) from server-side busi
 Generate full-stack features from the terminal:
 
 ```bash
-# Generate Model + Migration + Factory + Seeder + Controller + .kreftjs Page + Route:
+# Generate Model + Migration + Factory + Seeder + Controller + .kreft Page + Route:
 kreft make:model Post --all
 
 # Or pick specific layers (-m migration, -f factory, -s seeder, -c controller, -p page, -r route):
@@ -65,7 +65,7 @@ kreft make:observer PostObserver --model Post
 kreft make:middleware EnsureSubscribed
 kreft make:job ProcessWebhook
 kreft make:mail InvoiceReady
-kreft make:routes billing        # Creates frontend/routes/billing.kreftjs & backend/routes/billing.js
+kreft make:routes billing        # Creates frontend/routes/billing.kreft & backend/routes/billing.js
 
 # Database & inspection tools:
 kreftjs db:migrate                 # Run pending migrations
@@ -77,12 +77,12 @@ kreft tinker                     # Interactive REPL with your Models, DB, Cache
 
 ---
 
-## Writing `.kreftjs` Components
+## Writing `.kreft` Components
 
-Every `.kreftjs` file combines reactive state, actions, `<view>`, and optional `<style scoped>`:
+Every `.kreft` file combines reactive state, actions, `<view>`, and optional `<style scoped>`:
 
 ```html
-<!-- frontend/pages/Posts.kreftjs -->
+<!-- frontend/pages/Posts.kreft -->
 state title = ''
 load posts = api.get('/api/posts')
 

package/templates/app/_env.example

@@ -8,7 +8,7 @@ APP_KEY=
 # Where the app runs: links in emails start with this
 APP_URL=http://localhost:8000
 
-# Only values that start with PUBLIC_ also reach the browser: {env.PUBLIC_APP_NAME} in any .kreftjs file.
+# Only values that start with PUBLIC_ also reach the browser: {env.PUBLIC_APP_NAME} in any .kreft file.
 # Never put a password or a secret key in a PUBLIC_ value.
 PUBLIC_APP_NAME="${APP_NAME}"
 # Where the "Documentation" links of the pages go
@@ -54,7 +54,7 @@ SESSION_EXPIRE_ON_CLOSE=false
 SESSION_DRIVER=file
 
 # Frontend Inactivity Timer in minutes (auto-redirect to /login after inactivity)
-# Values starting with PUBLIC_ are sent to the browser and readable as {env.PUBLIC_...} in .kreftjs files
+# Values starting with PUBLIC_ are sent to the browser and readable as {env.PUBLIC_...} in .kreft files
 PUBLIC_SESSION_TIMEOUT=15
 PUBLIC_SESSION_WARNING=2
 

package/templates/app/_vscode/settings.json

@@ -1,8 +1,9 @@
 {
   "files.associations": {
-    "*.kreftjs": "kreft"
+    "*.kreft": "kreftjs",
+    "*.kreftjs": "kreftjs"
   },
-  "[kreft]": {
+  "[kreftjs]": {
     "editor.defaultFormatter": "kreft.kreftjs",
     "editor.formatOnSave": true
   }

package/templates/app/backend/app/Http/Controllers/Admin/DashboardController.js

@@ -1,7 +1,7 @@
 const User = require('../../../Models/User')
 const PersonalAccessToken = require('../../../Models/PersonalAccessToken')
 
-// GET /api/admin/stats   (frontend/pages/Dashboard.kreftjs)
+// GET /api/admin/stats   (frontend/pages/Dashboard.kreft)
 class DashboardController {
   async index(req) {
     if (!req.user || !req.user.is_admin) {
@@ -25,7 +25,7 @@ class DashboardController {
     }
   }
 
-  // GET /api/admin/me   (frontend/pages/Profile.kreftjs)
+  // GET /api/admin/me   (frontend/pages/Profile.kreft)
   async me(req) {
     return { user: req.user, devices: await PersonalAccessToken.where('user_id', req.user.id).count() }
   }

package/templates/app/backend/app/Http/Controllers/Admin/UserController.js

@@ -5,7 +5,7 @@ const PersonalAccessToken = require('../../../Models/PersonalAccessToken')
 // the roles a user can have ('role:editor' in the routes); add your own
 const ROLES = ['user', 'editor']
 
-// /api/admin/users   (frontend/pages/Users.kreftjs)
+// /api/admin/users   (frontend/pages/Users.kreft)
 class UserController {
   // GET /api/admin/users?q=ali&page=2
   async index(req) {

package/templates/app/backend/app/Http/Controllers/Auth/ApiTokenController.js

@@ -4,7 +4,7 @@ const PersonalAccessToken = require('../../../Models/PersonalAccessToken')
 // What an API token may do: change this list for your app. 'abilities:posts:write' in a route checks it.
 const ABILITIES = ['read', 'create', 'update', 'delete']
 
-// API tokens for scripts and other apps (pages/Profile.kreftjs → API tokens), like Jetstream / Sanctum
+// API tokens for scripts and other apps (pages/Profile.kreft → API tokens), like Jetstream / Sanctum
 class ApiTokenController {
   // GET /api/user/tokens
   async index(req) {

package/templates/app/backend/app/Http/Controllers/Auth/AuthenticatedSessionController.js

@@ -8,7 +8,7 @@ const LoginRequest = require('../../Requests/Auth/LoginRequest')
 const { signIn, signOut, pendingTwoFactor } = require('../../../Auth/Session')
 
 class AuthenticatedSessionController {
-  // POST /api/login  { email, password, remember }   (pages/auth/Login.kreftjs)
+  // POST /api/login  { email, password, remember }   (pages/auth/Login.kreft)
   // with two-factor on, the answer is { two_factor: true } and the code goes to /api/two-factor-challenge
   async store(req) {
     const data = await LoginRequest.validate(req)

package/templates/app/backend/app/Http/Controllers/Auth/ConfirmablePasswordController.js

@@ -1,7 +1,7 @@
 const { Hash, ValidationError } = require('kreftjs/server')
 
 class ConfirmablePasswordController {
-  // POST /api/confirm-password   (pages/auth/ConfirmPassword.kreftjs): opens 'password.confirm' routes for 3 hours
+  // POST /api/confirm-password   (pages/auth/ConfirmPassword.kreft): opens 'password.confirm' routes for 3 hours
   async store(req) {
     const { password } = await req.validate({ password: 'required' })
     if (!Hash.check(password, req.user.password)) throw new ValidationError({ password: ['The password is incorrect.'] })

package/templates/app/backend/app/Http/Controllers/Auth/EmailVerificationController.js

@@ -2,7 +2,7 @@ const { Hash, Url, abort, same } = require('kreftjs/server')
 const User = require('../../../Models/User')
 
 class EmailVerificationController {
-  // POST /api/email/verification-notification: send the link again (pages/auth/VerifyEmail.kreftjs)
+  // POST /api/email/verification-notification: send the link again (pages/auth/VerifyEmail.kreft)
   async send(req) {
     if (req.user.hasVerifiedEmail()) return { message: 'Your email address is already verified.' }
     await req.user.sendEmailVerificationNotification()

package/templates/app/backend/app/Http/Controllers/Auth/NewPasswordController.js

@@ -5,7 +5,7 @@ const PersonalAccessToken = require('../../../Models/PersonalAccessToken')
 const MINUTES = 60 // how long a reset link works
 
 class NewPasswordController {
-  // POST /api/reset-password   (pages/auth/ResetPassword.kreftjs)
+  // POST /api/reset-password   (pages/auth/ResetPassword.kreft)
   async store(req) {
     const data = await req.validate({
       token: 'required',

package/templates/app/backend/app/Http/Controllers/Auth/PasswordResetLinkController.js

@@ -2,7 +2,7 @@ const { DB, Hash, Str } = require('kreftjs/server')
 const User = require('../../../Models/User')
 
 class PasswordResetLinkController {
-  // POST /api/forgot-password   (pages/auth/ForgotPassword.kreftjs)
+  // POST /api/forgot-password   (pages/auth/ForgotPassword.kreft)
   async store(req) {
     const { email } = await req.validate({ email: 'required|email' })
     const user = await User.where('email', email.toLowerCase()).first()

package/templates/app/backend/app/Http/Controllers/Auth/RegisteredUserController.js

@@ -3,7 +3,7 @@ const User = require('../../../Models/User')
 const { signIn } = require('../../../Auth/Session')
 
 class RegisteredUserController {
-  // POST /api/register   (pages/auth/Register.kreftjs)
+  // POST /api/register   (pages/auth/Register.kreft)
   async store(req) {
     const data = await req.validate({
       name: 'required|string|max:255',

package/templates/app/backend/app/Http/Controllers/Auth/SessionController.js

@@ -1,7 +1,7 @@
 const { noContent, abort } = require('kreftjs/server')
 const PersonalAccessToken = require('../../../Models/PersonalAccessToken')
 
-// The devices signed in to this account (pages/Profile.kreftjs → Browser sessions)
+// The devices signed in to this account (pages/Profile.kreft → Browser sessions)
 class SessionController {
   ensureSession(req) {
     if (req.accessToken && req.accessToken.type !== 'session' && !req.accessToken.can('*')) {

package/templates/app/backend/app/Http/Controllers/Auth/TwoFactorController.js

@@ -1,6 +1,6 @@
 const { Crypt, TOTP, QR, ValidationError, abort, noContent } = require('kreftjs/server')
 
-// Two-factor authentication with an authenticator app (pages/Profile.kreftjs → Two-factor authentication)
+// Two-factor authentication with an authenticator app (pages/Profile.kreft → Two-factor authentication)
 class TwoFactorController {
   ensureSession(req) {
     if (req.accessToken && req.accessToken.type !== 'session' && !req.accessToken.can('*')) {

package/templates/app/backend/app/Http/Controllers/ProfileController.js

@@ -1,7 +1,7 @@
 const { Hash, ValidationError, noContent, abort } = require('kreftjs/server')
 const PersonalAccessToken = require('../../Models/PersonalAccessToken')
 
-// pages/Profile.kreftjs
+// pages/Profile.kreft
 class ProfileController {
   // GET /api/user: who is signed in
   async show(req) {

package/templates/app/backend/app/Http/Middleware/RequirePassword.js

@@ -1,5 +1,5 @@
 // 'password.confirm' in the routes: the user typed their password again in the last 3 hours
-// (pages/auth/ConfirmPassword.kreftjs). Otherwise the answer is 423 and the app asks for it.
+// (pages/auth/ConfirmPassword.kreft). Otherwise the answer is 423 and the app asks for it.
 const { abort } = require('kreftjs/server')
 
 const TIMEOUT = Number(process.env.PASSWORD_TIMEOUT || 10800) // seconds

package/templates/app/frontend/{App.kreftjs → App.kreft}

@@ -1,4 +1,4 @@
-<!-- The app: the page for the current route, inside its layout (layouts/app.kreftjs) -->
+<!-- The app: the page for the current route, inside its layout (layouts/app.kreft) -->
 <view>
   <kreft-view k-animate.after="fade"></kreft-view>
 </view>

package/templates/app/frontend/components/profile/{ApiTokens.kreftjs → ApiTokens.kreft}

@@ -1,4 +1,4 @@
-<!-- API tokens: for scripts and other apps (Authorization: Bearer …). pages/Profile.kreftjs, /api/user/tokens -->
+<!-- API tokens: for scripts and other apps (Authorization: Bearer …). pages/Profile.kreft, /api/user/tokens -->
 load tokens = api.get('/api/user/tokens')
 state name = ''
 state chosen = ['read']

package/templates/app/frontend/components/profile/{Sessions.kreftjs → Sessions.kreft}

@@ -1,4 +1,4 @@
-<!-- Browser sessions: the devices signed in to this account (pages/Profile.kreftjs, /api/user/sessions) -->
+<!-- Browser sessions: the devices signed in to this account (pages/Profile.kreft, /api/user/sessions) -->
 load sessions = api.get('/api/user/sessions')
 state problem = ''
 

package/templates/app/frontend/components/profile/{TwoFactor.kreftjs → TwoFactor.kreft}

@@ -1,4 +1,4 @@
-<!-- Two-factor authentication: a code from an authenticator app after the password (pages/Profile.kreftjs).
+<!-- Two-factor authentication: a code from an authenticator app after the password (pages/Profile.kreft).
      /api/user/two-factor… in backend/routes/auth.js. Turning it on, off, and the recovery codes ask for the
      password first (the app goes to /confirm-password and comes back). -->
 state setup = null           // { qr, secret } while turning it on

package/templates/app/frontend/errors/{ErrorMonitor.kreftjs → ErrorMonitor.kreft}

@@ -1,5 +1,5 @@
 <!--
-  ErrorMonitor.kreftjs — Native Kreft Error Inspector & Diagnostic Component
+  ErrorMonitor.kreft — Native Kreft Error Inspector & Diagnostic Component
   Built with Kreft's own geometric design system (ui.css tokens, dark/light theme aware, 1px borders, terminal code view).
 -->
 prop error = null
@@ -92,7 +92,7 @@ state docs = (Kreftjs.env.PUBLIC_DOCS_URL || 'http://kreftjs.com').replace(/\/+$
         <div class="badges">
           <span class="badge danger-badge">HTTP {status}</span>
           <span class="badge solid">{currentTitle}</span>
-          <span class="badge">Kreft {Kreftjs.version || '0.0.7-beta'}</span>
+          <span class="badge">Kreft {Kreftjs.version || '0.0.9-beta'}</span>
         </div>
         <div class="actions">
           <button class="sm" @click={copyReport}>{copied ? 'Copied Markdown' : 'Copy Report'}</button>
@@ -189,7 +189,7 @@ state docs = (Kreftjs.env.PUBLIC_DOCS_URL || 'http://kreftjs.com').replace(/\/+$
         <h3>Kreft Runtime</h3>
         <table>
           <tbody>
-            <tr><th>Engine</th><td><code>Kreft v{Kreftjs.version || '0.0.7-beta'}</code></td></tr>
+            <tr><th>Engine</th><td><code>Kreft v{Kreftjs.version || '0.0.9-beta'}</code></td></tr>
             <tr><th>Sanitizer</th><td><code>Active (cleanHtml / SafeHtml)</code></td></tr>
             <tr><th>Environment</th><td><code>development (APP_DEBUG=true)</code></td></tr>
           </tbody>

package/templates/app/frontend/index.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <!-- where the app lives: routes and .kreftjs paths start here -->
+  <!-- where the app lives: routes and .kreft paths start here -->
   <base href="/">
   <title>My Kreft app</title>
   <link rel="preconnect" href="https://fonts.googleapis.com">
@@ -31,9 +31,9 @@
     }, { saved: ['user'] })
 
     const router = Kreftjs.router({
-      routes: ['routes/web.kreftjs'], // the pages are in routes/web.kreftjs; add more files: kreft make:routes admin
-      layout: 'app',              // every page goes inside layouts/app.kreftjs…
-      errors: 'errors',           // error pages: errors/404.kreftjs for unknown addresses, abort(403) → errors/403.kreftjs
+      routes: ['routes/web.kreft'], // the pages are in routes/web.kreft; add more files: kreft make:routes admin
+      layout: 'app',              // every page goes inside layouts/app.kreft…
+      errors: 'errors',           // error pages: errors/404.kreft for unknown addresses, abort(403) → errors/403.kreft
       // the names routes use in .middleware(…): return an address to send the visitor there instead
       middleware: {
         auth: (to) => (auth.user ? true : '/login?redirect=' + encodeURIComponent(to.fullPath)),
@@ -68,10 +68,10 @@
       )
     }
 
-    Kreftjs.app('App.kreftjs')
-      .component('Field', 'components/Field.kreftjs')
-      .component('StatCard', 'components/StatCard.kreftjs')
-      .component('Counter', 'tests/components/Counter.kreftjs')
+    Kreftjs.app('App.kreft')
+      .component('Field', 'components/Field.kreft')
+      .component('StatCard', 'components/StatCard.kreft')
+      .component('Counter', 'tests/components/Counter.kreft')
       .use(router)
       .mount('#app')
   </script>

package/templates/app/frontend/kreftjs.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Kreft 0.0.7-beta
+// Type definitions for Kreft 0.0.9-beta
 // Use from TypeScript or for editor hints in plain JavaScript (// @ts-check).
 
 export interface Signal<T> { value: T }
@@ -212,7 +212,7 @@ export interface ComponentDef {
   destroyed?(): void
   [key: string]: any
 }
-/** A component: an object, an init function, a lazy() loader or the address of a .kreftjs file */
+/** A component: an object, an init function, a lazy() loader or the address of a .kreft file */
 export type Component = ComponentDef | ((props: any, ctx: Context) => object | void) | LazyComponent | string
 export interface LazyComponent { __loader: () => Promise<any> }
 
@@ -248,7 +248,7 @@ export interface RouteRecord {
   guard?: Guard
   /** Child routes, shown in the page's own <kreft-view> */
   children?: RouteRecord[]
-  /** The layout for this route and its children: 'admin' → layouts/admin.kreftjs, a .kreftjs path, a component, or false for none */
+  /** The layout for this route and its children: 'admin' → layouts/admin.kreft, a .kreft path, a component, or false for none */
   layout?: string | Component | false
 }
 export interface Route {
@@ -266,7 +266,7 @@ export type RouteTarget = string | { path?: string; name?: string; params?: Reco
 export type Guard = (to: Route, from: Route) => boolean | void | RouteTarget | Promise<boolean | void | RouteTarget>
 export interface Router {
   readonly route: Route
-  /** shows errors/<status>.kreftjs for this address: abort(403, 'Only the owner can see this.') */
+  /** shows errors/<status>.kreft for this address: abort(403, 'Only the owner can see this.') */
   abort(status?: number, message?: string): void
   readonly routes: RouteRecord[]
   go(to: RouteTarget | number): Promise<void> | void
@@ -282,7 +282,7 @@ export interface Router {
   ready(): Promise<void>
   install(app: App): void
 }
-/** routes/web.kreftjs: `Route` is there without an import */
+/** routes/web.kreft: `Route` is there without an import */
 export interface RouteEntry {
   name(name: string): RouteEntry
   title(title: string): RouteEntry
@@ -307,7 +307,7 @@ export interface RouteGroup {
   group(fn: (route: RouteFile) => void): RouteFile
 }
 export interface RouteFile {
-  /** a page: Route.view('/posts/:id', 'pages/Post.kreftjs') — :id reaches the page as a prop */
+  /** a page: Route.view('/posts/:id', 'pages/Post.kreft') — :id reaches the page as a prop */
   view(path: string, component: string | Component): RouteEntry
   get(path: string, component: string | Component): RouteEntry
   redirect(from: string, to: string): void
@@ -325,25 +325,25 @@ export interface RouteFile {
 export type RouteMiddleware = (to: Route, from: Route, ...args: string[]) => boolean | string | object | void | Promise<boolean | string | object | void>
 
 export interface RouterOptions {
-  /** route objects, or route files: 'routes/web.kreftjs' / ['routes/web.kreftjs', 'routes/admin.kreftjs'] (both can be mixed) */
+  /** route objects, or route files: 'routes/web.kreft' / ['routes/web.kreft', 'routes/admin.kreft'] (both can be mixed) */
   routes: RouteRecord[] | string | (string | RouteRecord)[]
   /** the names routes use in .middleware(…): { auth: (to) => auth.token ? true : '/login' } */
   middleware?: Record<string, RouteMiddleware>
   mode?: 'history' | 'hash'
   base?: string
   scrollToTop?: boolean
-  /** The layout every page goes in: 'app' → layouts/app.kreftjs (a page's `layout x`, or a route's `layout`, wins) */
+  /** The layout every page goes in: 'app' → layouts/app.kreft (a page's `layout x`, or a route's `layout`, wins) */
   layout?: string | Component | false
-  /** Names for layouts that live elsewhere: { admin: 'views/AdminShell.kreftjs' } */
+  /** Names for layouts that live elsewhere: { admin: 'views/AdminShell.kreft' } */
   layouts?: Record<string, string | Component>
-  /** The folder with the error pages (errors/404.kreftjs, 403, 500…): unknown addresses show 404.kreftjs, abort(…) the others */
+  /** The folder with the error pages (errors/404.kreft, 403, 500…): unknown addresses show 404.kreft, abort(…) the others */
   errors?: string | boolean
 }
 
 /* ---------------- Kreft ---------------- */
 export interface KreftStatic {
   readonly version: string
-  /** PUBLIC_ values from .env (also `env` in .kreftjs files). Never secrets: those stay in server code */
+  /** PUBLIC_ values from .env (also `env` in .kreft files). Never secrets: those stay in server code */
   readonly env: Readonly<Record<string, string>>
   /** true when running inside an Electron desktop window */
   readonly isElectron: boolean
@@ -354,15 +354,13 @@ export interface KreftStatic {
   __makeDef(parts: any, values?: any): ComponentDef
   __registerDef(path: string, def: any): any
   __hotDef(id: string, newDef: any): boolean
-  /** the error page for this address: abort(404), abort(403, 'Only the owner can see this.') (also `abort` in .kreftjs files) */
+  /** the error page for this address: abort(404), abort(403, 'Only the owner can see this.') (also `abort` in .kreft files) */
   abort(status?: number, message?: string): void
   app(root?: Component, props?: Record<string, any>): App
   lazy(loader: () => Promise<any>): LazyComponent
   load(url: string): Promise<ComponentDef>
-  /** Compiles the text of a .kreftjs file into a component */
+  /** Compiles the text of a .kreft file into a component */
   compile(source: string, url?: string): Promise<ComponentDef>
-  /** @deprecated the Som.js name of `compile` */
-  compileSom(source: string, url?: string): Promise<ComponentDef>
   /** Strips TypeScript type annotations, interfaces, type aliases and enums from source code while preserving line numbers */
   stripTypeScript(source: string): string
   /** The template engine: a view and data → an HTML string */
@@ -552,28 +550,18 @@ declare global {
   var Kreftjs: KreftStatic
   /** the shorter name of `Kreftjs` */
   var Kreft: KreftStatic
-  /** @deprecated the Som.js name of `Kreftjs` */
-  var Som: KreftStatic
   interface Window {
     kreftDesktop?: DesktopBridge
-    /** @deprecated the Som.js name of `kreftDesktop` */
-    somDesktop?: DesktopBridge
   }
 }
 
-declare module '*.kreftjs' {
-  const component: import('./kreftjs.js').ComponentDef
-  export default component
-}
-
-// files from older projects (.kreft, then Som.js's .som)
 declare module '*.kreft' {
   const component: import('./kreftjs.js').ComponentDef
   export default component
 }
 
-declare module '*.som' {
+// files from the 0.0.x betas (.kreftjs)
+declare module '*.kreftjs' {
   const component: import('./kreftjs.js').ComponentDef
   export default component
 }
-