@cosmicdrift/kumiko-dev-server 0.145.0 → 0.146.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.145.0",
+  "version": "0.146.0",
   "description": "Development server bootstrap for Kumiko apps. Bundles the client, mints dev-JWTs, injects the resolved AppSchema, and seeds an admin. Not for production.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -58,8 +58,8 @@
     "kumiko-schema-check": "./bin/kumiko-schema-check.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.145.0",
-    "@cosmicdrift/kumiko-framework": "0.145.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.146.0",
+    "@cosmicdrift/kumiko-framework": "0.146.0",
     "ts-morph": "^28.0.0"
   },
   "publishConfig": {

package/src/__tests__/scaffold-app.test.ts

@@ -115,7 +115,10 @@ describe("scaffoldApp", () => {
     expect(client).toContain("createKumikoApp");
     expect(client).toContain("emailPasswordClient");
     expect(client).toContain("DefaultAppShell");
-    expect(client).toContain("shell: DefaultAppShell");
+    expect(client).toContain("shell: AppShell");
+    expect(client).toContain("function AppShell(");
+    expect(client).toContain("brand={<span");
+    expect(client).toContain(">my-shop</span>");
     expect(client).toContain('from "@cosmicdrift/kumiko-renderer-web"');
     expect(client).toContain('from "@cosmicdrift/kumiko-bundled-features/auth-email-password/web"');
   });

package/src/scaffold-app.ts

@@ -121,7 +121,7 @@ export async function scaffoldApp(options: ScaffoldAppOptions): Promise<Scaffold
   write(join(destination, "bin", "kumiko.ts"), renderBinKumiko());
   files.push("bin/kumiko.ts");
 
-  write(join(destination, "src", "client.tsx"), renderClient());
+  write(join(destination, "src", "client.tsx"), renderClient(options.name));
   files.push("src/client.tsx");
 
   write(join(destination, "src", "styles.css"), renderStylesCss());
@@ -184,6 +184,8 @@ function renderPackageJson(name: string, version: string): string {
       devDependencies: {
         "@biomejs/biome": "^2.4.15",
         "@tailwindcss/cli": "^4.3.0",
+        "@types/react": "^19.2.0",
+        "@types/react-dom": "^19.2.0",
         "bun-types": "^1.3.14",
         tailwindcss: "^4.3.0",
         typescript: "^6.0.3",
@@ -385,14 +387,14 @@ function renderRunConfig(features?: ReadonlyArray<ScaffoldFeatureEntry>): string
   sf.insertText(
     0,
     [
-      "// Single source of truth für die Feature-Komposition deiner App.",
-      "// config/user/tenant/auth-email-password werden via",
-      "// composeFeatures(includeBundled:true) automatisch ergänzt wenn",
-      "// runProdApp mit `auth: {…}` aufgerufen wird (siehe bin/main.ts).",
+      "// Single source of truth for your app's feature composition.",
+      "// config/user/tenant/auth-email-password are added automatically",
+      "// via composeFeatures(includeBundled:true) when runProdApp is called",
+      "// with `auth: {…}` (see bin/main.ts).",
       "//",
-      "// Neue features hinzufügen:",
-      "//   - bunx @cosmicdrift/kumiko-cli add feature <name>  (DX-2, automatisch)",
-      "//   - oder: hand-edit + import unten ergänzen",
+      "// Add new features:",
+      "//   - bunx @cosmicdrift/kumiko-cli add feature <name>  (DX-2, automatic)",
+      "//   - or: hand-edit + add the import below",
       "",
       "",
     ].join("\n"),
@@ -493,9 +495,9 @@ function renderMain(appName: string): string {
     [
       "// Production-bootstrap. KUMIKO_DRY_RUN_ENV=boot exits after",
       "// composeFeatures + validateBoot + createRegistry without DB/Redis-connect",
-      "// (siehe @cosmicdrift/kumiko-dev-server runProdApp). Echter Dev-Boot",
-      "// passiert via `bunx kumiko dev` (in-repo dev-tool) mit Docker-stack — DX-1.0 deckt nur",
-      "// den boot-mode-Pfad ab; `kumiko dev` kommt in einer späteren DX-Phase.",
+      "// (see @cosmicdrift/kumiko-dev-server runProdApp). The real dev boot",
+      "// runs via `bunx kumiko dev` (in-repo dev-tool) with a Docker stack — DX-1.0",
+      "// only covers the boot-mode path; `kumiko dev` lands in a later DX phase.",
       "",
       "",
     ].join("\n"),
@@ -570,12 +572,12 @@ function renderDev(appName: string): string {
   sf.insertText(
     0,
     [
-      "// Dev-bootstrap. `bun --watch bin/dev.ts` (siehe package.json scripts.dev)",
-      "// startet einen full-featured Dev-Server mit Auto-Reload bei Code-Änderungen.",
-      "// setupTestStack legt fehlende Entity-Tabellen automatisch an — neues",
-      "// r.entity(...) in einem Feature führt beim nächsten Reboot zu CREATE TABLE,",
-      "// kein manuelles `kumiko schema apply` nötig (das gilt nur für Prod).",
-      "// Persistent-DB via KUMIKO_DEV_DB_NAME (.env) damit Admin + Daten Reboots überleben.",
+      "// Dev bootstrap. `bun --watch bin/dev.ts` (see package.json scripts.dev)",
+      "// starts a full-featured dev server with auto-reload on code changes.",
+      "// setupTestStack creates missing entity tables automatically — a new",
+      "// r.entity(...) in a feature becomes a CREATE TABLE on the next reboot,",
+      "// no manual `kumiko schema apply` needed (that's prod-only).",
+      "// Persistent DB via KUMIKO_DEV_DB_NAME (.env) so admin + data survive reboots.",
       "",
       "",
     ].join("\n"),
@@ -584,26 +586,37 @@ function renderDev(appName: string): string {
   return sf.getFullText();
 }
 
-function renderClient(): string {
+function renderClient(appName: string): string {
   return [
-    "// Browser-Entry. runDevApp's clientEntry-Option bundlet diese Datei zu",
-    "// /client.js und das Default-HTML lädt sie. createKumikoApp liest das",
-    "// Schema aus dem window-globalen (das injectSchema im dev-server setzt)",
-    "// und mountet die Routen.",
+    "// Browser entry. runDevApp's clientEntry option bundles this file to",
+    "// /client.js and the default HTML loads it. createKumikoApp reads the",
+    "// schema from the window global (injectSchema in the dev-server sets it)",
+    "// and mounts the routes.",
     "//",
-    "// DefaultAppShell liefert die Sidebar + Topbar — ohne `shell` rendert",
-    "// createKumikoApp das aktive Screen ohne Layout-Wrapper (= nach Login",
-    "// nur ein nackter Banner statt der App). emailPasswordClient() bringt",
-    "// Login-Screen + Session-Provider — ohne ihn bliebe /login leer.",
+    "// AppShell wraps DefaultAppShell to supply `brand` — createKumikoApp's",
+    "// shell option only injects schema + children. Without `shell` the",
+    "// active screen renders with no layout wrapper (a bare banner after",
+    "// login instead of the app). emailPasswordClient() brings the login",
+    "// screen + session provider — without it /login stays empty.",
     "//",
-    "// Neue Client-Plugins (z.B. notificationsClient()) hier in clientFeatures",
-    "// hinzu — symmetrisch zu APP_FEATURES auf der Server-Seite.",
+    "// Add new client plugins (e.g. notificationsClient()) to clientFeatures",
+    "// here — symmetric to APP_FEATURES on the server side.",
     "",
     'import { emailPasswordClient } from "@cosmicdrift/kumiko-bundled-features/auth-email-password/web";',
-    'import { createKumikoApp, DefaultAppShell } from "@cosmicdrift/kumiko-renderer-web";',
+    'import { type AppSchema, createKumikoApp, DefaultAppShell } from "@cosmicdrift/kumiko-renderer-web";',
+    'import type { ReactNode } from "react";',
+    "",
+    "function AppShell({ children, schema }: { children: ReactNode; schema: AppSchema }): ReactNode {",
+    "  return (",
+    // html-ok: appName is kebab-validated (a-z/0-9/-); this is generated .tsx source, not runtime HTML.
+    `    <DefaultAppShell brand={<span className="font-semibold tracking-tight">${appName}</span>} schema={schema}>`,
+    "      {children}",
+    "    </DefaultAppShell>",
+    "  );",
+    "}",
     "",
     "createKumikoApp({",
-    "  shell: DefaultAppShell,",
+    "  shell: AppShell,",
     "  clientFeatures: [emailPasswordClient()],",
     "});",
     "",
@@ -612,10 +625,10 @@ function renderClient(): string {
 
 function renderEnvExample(appName: string): string {
   const devDb = `${appName.replace(/-/g, "_")}_dev`;
-  return `# bun dev (runDevApp → setupTestStack) braucht TEST_DATABASE_URL.
-# Production (bun bin/main.ts → runProdApp) braucht DATABASE_URL.
-# Beide zeigen im Default auf denselben lokalen Postgres — runDevApp legt
-# darunter eine eigene "<KUMIKO_DEV_DB_NAME>"-Datenbank an.
+  return `# bun dev (runDevApp → setupTestStack) needs TEST_DATABASE_URL.
+# Production (bun bin/main.ts → runProdApp) needs DATABASE_URL.
+# Both default to the same local Postgres — runDevApp creates its own
+# "<KUMIKO_DEV_DB_NAME>" database underneath.
 TEST_DATABASE_URL=postgres://postgres:postgres@127.0.0.1:5432/postgres
 DATABASE_URL=postgres://postgres:postgres@127.0.0.1:5432/app
 REDIS_URL=redis://127.0.0.1:6379
@@ -627,9 +640,9 @@ JWT_SECRET=change-me-min-32-chars-change-me-min-32
 # Generate with: openssl rand -base64 32
 KUMIKO_SECRETS_MASTER_KEY_V1=
 
-# Dev-only: persistente DB für \`bun dev\`. Ohne diesen Var startet jeder Reboot
-# eine frische kumiko_test_<random>-DB → Admin-Login + Daten weg bei jedem Edit.
-# Mit Var bleibt die DB zwischen Reboots erhalten (Schema-Pushes sind idempotent).
+# Dev-only: persistent DB for \`bun dev\`. Without this var every reboot starts
+# a fresh kumiko_test_<random> DB → admin login + data gone on every edit.
+# With it the DB persists across reboots (schema pushes are idempotent).
 KUMIKO_DEV_DB_NAME=${devDb}
 `;
 }
@@ -789,7 +802,7 @@ function renderBinKumiko(): string {
     "const [, , cmd, ...rest] = Bun.argv;",
     'if (cmd !== "schema") {',
     "  // biome-ignore lint/suspicious/noConsole: CLI output is the feature.",
-    '  console.error("\\n  Unbekannt: kumiko " + (cmd ?? "") + " — nur \'kumiko schema <sub>\' im Standalone-Bundle.\\n");',
+    '  console.error("\\n  Unknown: kumiko " + (cmd ?? "") + " — only \'kumiko schema <sub>\' in the standalone bundle.\\n");',
     "  process.exit(1);",
     "}",
     "",