@forinda/kickjs-cli 6.15.1 → 7.0.0

package/dist/fullstack-5paK85Qh.mjs

@@ -0,0 +1,190 @@
+/**
+ * @forinda/kickjs-cli v7.0.0
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import{l as e}from"./project-docs-C64R8KF2.mjs";import{l as t,n,t as r}from"./project-RMuxqw1k.mjs";import{join as i}from"node:path";import{execFileSync as a}from"node:child_process";async function o(o){let{name:_,directory:v,schemaLib:y=`zod`,runtime:b=`express`}=o,x=[`pnpm`,`npm`,`yarn`,`bun`].includes(o.packageManager),S=x?o.packageManager:`pnpm`,C=v,w=e=>console.log(`  ${e}`);o.packageManager!==void 0&&!x&&w(`Warning: unknown package manager '${String(o.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${_}\n`),await r({name:`${_}-server`,directory:i(C,`server`),packageManager:S,template:`minimal`,schemaLib:y,runtime:b,withClientMap:!0,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`});let T=await n(),E=T[`@forinda/kickjs-client`]??`^0.1.0`;await e(i(C,`web/package.json`),s(_,E)),await e(i(C,`web/vite.config.ts`),c()),await e(i(C,`web/tsconfig.json`),l()),await e(i(C,`web/index.html`),u(_)),await e(i(C,`web/src/main.tsx`),d()),await e(i(C,`web/src/App.tsx`),f()),await e(i(C,`web/src/api.ts`),p()),await e(i(C,`package.json`),m(_,S,T[`@forinda/kickjs-cli`])),S===`pnpm`&&await e(i(C,`pnpm-workspace.yaml`),`packages:
+  - server
+  - web
+
+allowBuilds:
+  '@swc/core': true
+  esbuild: true
+`),await e(i(C,`.gitignore`),h()),await e(i(C,`README.md`),g(_,S));let{generateAgentDocs:D}=await import(`./agent-docs-ziibOmI4.mjs`).then(e=>e.t);if(await D({outDir:C,name:_,pm:S,template:`fullstack`,only:`all`,force:!0}),o.installDeps){console.log(`\n  Installing workspace dependencies with ${S}...\n`);try{t(S,[`install`],{cwd:C})}catch{console.log(`\n  Warning: ${S} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-ID6CHFZr.mjs`).then(e=>e.n);await e({cwd:i(C,`server`),allowDuplicates:!0,silent:!0})}catch{}if(o.initGit)try{a(`git`,[`init`],{cwd:C,stdio:`pipe`}),a(`git`,[`branch`,`-M`,`main`],{cwd:C,stdio:`pipe`}),a(`git`,[`add`,`-A`],{cwd:C,stdio:`pipe`}),a(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:C,stdio:`pipe`}),w(`Git repository initialized`)}catch{w(`Warning: git init failed (git may not be installed)`)}console.log(`
+  Fullstack workspace scaffolded!`),console.log(),w(`Next steps:`),w(`  cd ${_}`),o.installDeps||w(`  ${S} install`),S===`pnpm`?w(`  pnpm dev            # runs server (kick dev) + web (vite) together`):(w(`  ${S} run dev:server   # terminal 1`),w(`  ${S} run dev:web      # terminal 2`)),w(``),w(`The web app calls the API through @forinda/kickjs-client —`),w(`edit server/src/modules/hello and watch web/src/App.tsx's types follow.`),w(``)}function s(e,t){return`${JSON.stringify({name:`${e}-web`,private:!0,version:`0.0.0`,type:`module`,scripts:{dev:`vite`,build:`tsc --noEmit && vite build`,preview:`vite preview`,typecheck:`tsc --noEmit`},dependencies:{"@forinda/kickjs-client":t,react:`^19.0.0`,"react-dom":`^19.0.0`},devDependencies:{"@types/react":`^19.0.0`,"@types/react-dom":`^19.0.0`,"@vitejs/plugin-react":`^5.0.0`,typescript:`^5.9.0`,vite:`^7.0.0`}},null,2)}\n`}function c(){return`import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    // The KickJS server (kick dev) listens on 3000; the client's baseUrl is
+    // the relative '/api/v1', so the browser hits Vite and Vite forwards.
+    proxy: {
+      '/api': 'http://localhost:3000',
+    },
+  },
+})
+`}function l(){return`${JSON.stringify({compilerOptions:{target:`ES2022`,lib:[`ES2022`,`DOM`,`DOM.Iterable`],module:`ESNext`,moduleResolution:`bundler`,jsx:`react-jsx`,strict:!0,skipLibCheck:!0,noEmit:!0,isolatedModules:!0,types:[`../server/.kickjs/types/kick__client`]},include:[`src`]},null,2)}\n`}function u(e){return`<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${e}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"><\/script>
+  </body>
+</html>
+`}function d(){return`import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { App } from './App'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)
+`}function f(){return`import { useEffect, useState } from 'react'
+import { api } from './api'
+
+// The response types below are INFERRED from the server's handlers —
+// change server/src/modules/hello/hello.service.ts and these types follow on
+// the next \`kick typegen\`. Not under \`kick dev\`: resolving the client map
+// builds a whole TypeScript program, so it is a build step, not a per-save one.
+type Greeting = Awaited<ReturnType<typeof fetchGreeting>>
+
+function fetchGreeting() {
+  return api.get('/hello')
+}
+
+export function App() {
+  const [greeting, setGreeting] = useState<Greeting | null>(null)
+  const [health, setHealth] = useState<string>('checking…')
+
+  useEffect(() => {
+    fetchGreeting().then(setGreeting).catch(console.error)
+    api
+      .get('/hello/health')
+      .then((h) => setHealth(h.status))
+      .catch(() => setHealth('down'))
+  }, [])
+
+  return (
+    <main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>
+      <h1>KickJS fullstack</h1>
+      <p>
+        <strong>{greeting?.message ?? 'loading…'}</strong>
+      </p>
+      <p>
+        Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}
+        <code>{health}</code>
+      </p>
+      <p style={{ color: '#666' }}>
+        This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape
+        <code> HelloService.greet()</code> produces. Rename a field on the server and this file
+        stops compiling.
+      </p>
+    </main>
+  )
+}
+`}function p(){return`import { createClient } from '@forinda/kickjs-client'
+
+// KickClientApi is ambient — the resolved route map from
+// server/.kickjs/types/kick__client.d.ts, wired in tsconfig's \`types\`. Every
+// response type is a literal shape, so nothing from the server's source graph
+// enters this program.
+//
+// Keys are module-mount-relative paths; the bootstrap-level '/api/v1' prefix
+// lives here in baseUrl, and the Vite dev proxy forwards it to the KickJS
+// server.
+//
+// Prefer an explicit import? The same file exports the type:
+//   import type { Api } from '../../server/.kickjs/types/kick__client'
+export const api = createClient<KickClientApi.Api>({ baseUrl: '/api/v1' })
+`}function m(e,t,n){let r=t===`pnpm`?{dev:`pnpm --parallel -r run dev`,start:`pnpm --filter ./server run start`,"dev:server":`pnpm --filter ./server dev`,"dev:web":`pnpm --filter ./web dev`,build:`pnpm -r run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`${t} run build:server && ${t} run build:web`,"build:server":`cd server && ${t} run build`,"build:web":`cd web && ${t} run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,scripts:r,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function h(){return`node_modules/
+dist/
+.env
+*.log
+.DS_Store
+`}function g(e,t){return`# ${e}
+
+Fullstack KickJS workspace — typed end to end.
+
+| Package   | What                                                              |
+| --------- | ----------------------------------------------------------------- |
+| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch)       |
+| \`web/\`    | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
+
+## Develop
+
+\`\`\`bash
+${t} install
+${t===`pnpm`?`pnpm dev            # server (kick dev) + web (vite), in parallel`:`${t} run dev:server   # terminal 1\n${t} run dev:web      # terminal 2`}
+\`\`\`
+
+Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
+
+## The type loop
+
+1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
+2. \`kick typegen\` emits \`server/.kickjs/types/kick__client.d.ts\` — the flat
+   route map with every response type resolved to a literal shape.
+3. \`web/tsconfig.json\` lists that file in \`types\`, so \`KickClientApi\` is
+   ambient — no import, no bridge file.
+4. \`web/src/api.ts\`'s \`createClient<KickClientApi.Api>\` types every call site.
+
+Because the map holds resolved types rather than references to controllers,
+\`web\` never compiles server source: no \`experimentalDecorators\`, no path
+aliases into \`server/src\`.
+
+Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
+stops compiling. That's the point.
+
+### Keeping the map fresh
+
+\`server/.kickjs/types/kick__client.d.ts\` is generated, and \`web\` reads it as
+an ambient type package. Two things follow.
+
+**It is not refreshed by \`kick dev\`.** Resolving it builds a whole TypeScript
+program over the server, which is a build-step cost rather than a per-save one,
+so a renamed response field surfaces on the next \`kick typegen\` rather than on
+save. Everything else in \`.kickjs/types\` still updates on save. Add
+\`kick typegen --check\` to CI and a stale map fails the build.
+
+**It needs a compiler API.** TypeScript 7 ships none, so \`server\` depends on
+\`@typescript/typescript6\`. Remove it and typegen skips this one file, saying
+so; \`web\` then reports \`TS2688\` because the file it lists in \`types\` is gone.
+
+### The other way to wire it
+
+A \`types\` entry says "this is a global type package", which is what the map is,
+and it fails loudly when the file is missing. If you would rather it be quiet
+when absent — say, a repo where the map is not always generated — use
+\`include\` instead:
+
+\`\`\`json
+{ "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] }
+\`\`\`
+
+That tolerates the file not existing, at the cost of \`KickClientApi\` silently
+not resolving. Note \`types\` replaces TypeScript's automatic \`@types\`
+inclusion, so if you add entries there, list the ones you rely on too
+(\`"types": ["node", "../server/.kickjs/types/kick__client"]\`).
+
+Or skip the global entirely — the same file exports the type:
+
+\`\`\`ts
+import type { Api } from '../../server/.kickjs/types/kick__client'
+
+export const api = createClient<Api>({ baseUrl: '/api/v1' })
+\`\`\`
+
+Docs: https://kickjs.app/guide/typed-client.html
+`}export{o as initFullstackProject};
+//# sourceMappingURL=fullstack-5paK85Qh.mjs.map

package/dist/fullstack-5paK85Qh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullstack-5paK85Qh.mjs","names":[],"sources":["../src/generators/fullstack.ts"],"sourcesContent":["// `kick new --template fullstack` — a pnpm-workspace monorepo:\n//\n//   my-app/\n//     server/   KickJS API (the standard scaffold, minus its own git/install)\n//     web/      Vite + React frontend typed end-to-end via\n//               @forinda/kickjs-client + the server's generated KickRoutes.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, re-run by `kick dev`) emits\n// server/.kickjs/types/kick__client.d.ts → web tsconfig `types` (ambient)\n// side-effect-imports that file (type-only, erased at runtime) → the web\n// client calls `api.get('/hello')` with the handler's actual response type.\n\nimport { join } from 'node:path'\nimport { execFileSync } from 'node:child_process'\n\nimport { writeFileSafe } from '../utils/fs'\nimport { runCommand } from '../utils/shell'\nimport { initProject, resolveSiblingVersions } from './project'\n\nexport interface InitFullstackOptions {\n  name: string\n  directory: string\n  packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n  initGit?: boolean\n  installDeps?: boolean\n  schemaLib?: 'zod' | 'valibot' | 'yup'\n  runtime?: 'express' | 'fastify' | 'h3'\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n  const { name, directory, schemaLib = 'zod', runtime = 'express' } = options\n  // `--pm` arrives as a free CLI string — allowlist before it reaches a\n  // process invocation (execFileSync takes an argv array, no shell, but a\n  // bogus binary name is still a confusing failure).\n  const pmValid = (['pnpm', 'npm', 'yarn', 'bun'] as const).includes(\n    options.packageManager as never,\n  )\n  const packageManager = pmValid\n    ? (options.packageManager as 'pnpm' | 'npm' | 'yarn' | 'bun')\n    : 'pnpm'\n  const dir = directory\n  const log = (msg: string) => console.log(`  ${msg}`)\n  if (options.packageManager !== undefined && !pmValid) {\n    log(\n      `Warning: unknown package manager '${String(options.packageManager)}' — falling back to pnpm.`,\n    )\n  }\n\n  console.log(`\\n  Creating fullstack KickJS workspace: ${name}\\n`)\n\n  // ── server/ — the standard scaffold, deferred install/git ──────────\n  await initProject({\n    name: `${name}-server`,\n    directory: join(dir, 'server'),\n    packageManager,\n    template: 'minimal',\n    schemaLib,\n    runtime,\n    // web/ reads the resolved route map from the ambient KickClientApi\n    // namespace, which needs the TS 7 compiler API to produce.\n    withClientMap: true,\n    // Root owns install + git so the lockfile/commit cover the workspace.\n    initGit: false,\n    installDeps: false,\n    // Production single-origin serving. `web/` builds to `web/dist`, and\n    // nothing served it before — `pnpm build` produced a frontend the API had\n    // no way to hand out, so every deploy needed a hand-wired static host or\n    // a second process. The adapter is inert until `../web/dist` exists, so\n    // `dev` (Vite serves the client and proxies /api here) is untouched.\n    spaClientDir: '../web/dist',\n  })\n\n  // ── web/ — Vite + React, typed client ──────────────────────────────\n  const versions = await resolveSiblingVersions()\n  const clientVersion = versions['@forinda/kickjs-client'] ?? '^0.1.0'\n\n  await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, clientVersion))\n  await writeFileSafe(join(dir, 'web/vite.config.ts'), webViteConfig())\n  await writeFileSafe(join(dir, 'web/tsconfig.json'), webTsConfig())\n  await writeFileSafe(join(dir, 'web/index.html'), webIndexHtml(name))\n  await writeFileSafe(join(dir, 'web/src/main.tsx'), webMain())\n  await writeFileSafe(join(dir, 'web/src/App.tsx'), webApp())\n  await writeFileSafe(join(dir, 'web/src/api.ts'), webApi())\n\n  // ── workspace root ──────────────────────────────────────────────────\n  await writeFileSafe(\n    join(dir, 'package.json'),\n    rootPackageJson(name, packageManager, versions['@forinda/kickjs-cli']),\n  )\n  // Only pnpm reads this file. npm / yarn / bun declare workspaces via the\n  // `workspaces` field in the root package.json instead — see rootPackageJson.\n  if (packageManager === 'pnpm') {\n    // `allowBuilds` is answered here, not left to pnpm. This scaffold installs\n    // non-interactively, so pnpm cannot prompt — it writes\n    // `'@swc/core': set this to true or false` and then refuses to run ANY\n    // script with ERR_PNPM_IGNORED_BUILDS, leaving a fresh project unable to\n    // run `pnpm typecheck` or `pnpm dev` until someone edits this file.\n    //\n    // Both are build tools this template chose: swc compiles the decorators,\n    // esbuild is Vite's. Approving their install scripts is the same decision\n    // as depending on them.\n    await writeFileSafe(\n      join(dir, 'pnpm-workspace.yaml'),\n      `packages:\\n  - server\\n  - web\\n\\nallowBuilds:\\n  '@swc/core': true\\n  esbuild: true\\n`,\n    )\n  }\n  await writeFileSafe(join(dir, '.gitignore'), rootGitignore())\n  await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager))\n\n  // Workspace-root agent docs (CLAUDE.md + .agents/) flavored for the\n  // fullstack layout — the server/ subdir keeps its own generated set.\n  const { generateAgentDocs } = await import('./agent-docs')\n  await generateAgentDocs({\n    outDir: dir,\n    name,\n    pm: packageManager,\n    template: 'fullstack',\n    only: 'all',\n    force: true,\n  })\n\n  // ── install (root — covers both workspace packages) ────────────────\n  if (options.installDeps) {\n    console.log(`\\n  Installing workspace dependencies with ${packageManager}...\\n`)\n    try {\n      // `runCommand`, not bare execFileSync — on Windows every package\n      // manager is a `.cmd` shim that execFileSync cannot spawn.\n      runCommand(packageManager, ['install'], { cwd: dir })\n    } catch {\n      console.log(`\\n  Warning: ${packageManager} install failed. Run it manually.`)\n    }\n  }\n\n  // ── typegen (server) so web's KickRoutes.Api resolves immediately ──\n  try {\n    const { runTypegen } = await import('../typegen')\n    await runTypegen({ cwd: join(dir, 'server'), allowDuplicates: true, silent: true })\n  } catch {\n    // Non-fatal — `kick dev` in server/ retries on boot.\n  }\n\n  // ── git (root) ──────────────────────────────────────────────────────\n  if (options.initGit) {\n    try {\n      execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['branch', '-M', 'main'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['add', '-A'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['commit', '-m', 'chore: initial commit from kick new (fullstack)'], {\n        cwd: dir,\n        stdio: 'pipe',\n      })\n      log('Git repository initialized')\n    } catch {\n      log('Warning: git init failed (git may not be installed)')\n    }\n  }\n\n  console.log('\\n  Fullstack workspace scaffolded!')\n  console.log()\n  log('Next steps:')\n  log(`  cd ${name}`)\n  if (!options.installDeps) log(`  ${packageManager} install`)\n  if (packageManager === 'pnpm') {\n    log('  pnpm dev            # runs server (kick dev) + web (vite) together')\n  } else {\n    log(`  ${packageManager} run dev:server   # terminal 1`)\n    log(`  ${packageManager} run dev:web      # terminal 2`)\n  }\n  log('')\n  log('The web app calls the API through @forinda/kickjs-client —')\n  log(\"edit server/src/modules/hello and watch web/src/App.tsx's types follow.\")\n  log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, clientVersion: string): string {\n  return `${JSON.stringify(\n    {\n      name: `${name}-web`,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts: {\n        dev: 'vite',\n        build: 'tsc --noEmit && vite build',\n        preview: 'vite preview',\n        typecheck: 'tsc --noEmit',\n      },\n      dependencies: {\n        '@forinda/kickjs-client': clientVersion,\n        react: '^19.0.0',\n        'react-dom': '^19.0.0',\n      },\n      devDependencies: {\n        '@types/react': '^19.0.0',\n        '@types/react-dom': '^19.0.0',\n        '@vitejs/plugin-react': '^5.0.0',\n        typescript: '^5.9.0',\n        vite: '^7.0.0',\n      },\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction webViteConfig(): string {\n  return `import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n  plugins: [react()],\n  server: {\n    // The KickJS server (kick dev) listens on 3000; the client's baseUrl is\n    // the relative '/api/v1', so the browser hits Vite and Vite forwards.\n    proxy: {\n      '/api': 'http://localhost:3000',\n    },\n  },\n})\n`\n}\n\nexport function webTsConfig(): string {\n  return `${JSON.stringify(\n    {\n      compilerOptions: {\n        target: 'ES2022',\n        lib: ['ES2022', 'DOM', 'DOM.Iterable'],\n        module: 'ESNext',\n        moduleResolution: 'bundler',\n        jsx: 'react-jsx',\n        strict: true,\n        skipLibCheck: true,\n        noEmit: true,\n        isolatedModules: true,\n        // The resolved client route map, as an ambient global type package —\n        // the same mechanism as \"node\" or \"vitest/globals\". It makes\n        // `KickClientApi.Api` available with no import and no bridge file.\n        //\n        // Note this is a `types` ENTRY, not an `include`: the map is a global\n        // type package, not source of this app. It also means the file must\n        // exist — `kick new` runs typegen for you, and `kick typegen` in\n        // server/ refreshes it. (An `include` entry tolerates the file being\n        // absent; a `types` entry reports TS2688, which is the louder and\n        // more useful failure for something the app depends on.)\n        //\n        // No `experimentalDecorators` here: unlike the ambient\n        // `KickRoutes.Api` bridge, this map carries no reference to the\n        // server's decorated controller sources.\n        types: ['../server/.kickjs/types/kick__client'],\n      },\n      include: ['src'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction webIndexHtml(name: string): string {\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>${name}</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script type=\"module\" src=\"/src/main.tsx\"></script>\n  </body>\n</html>\n`\n}\n\nfunction webMain(): string {\n  return `import { StrictMode } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport { App } from './App'\n\ncreateRoot(document.getElementById('root')!).render(\n  <StrictMode>\n    <App />\n  </StrictMode>,\n)\n`\n}\n\nfunction webApp(): string {\n  return `import { useEffect, useState } from 'react'\nimport { api } from './api'\n\n// The response types below are INFERRED from the server's handlers —\n// change server/src/modules/hello/hello.service.ts and these types follow on\n// the next \\`kick typegen\\`. Not under \\`kick dev\\`: resolving the client map\n// builds a whole TypeScript program, so it is a build step, not a per-save one.\ntype Greeting = Awaited<ReturnType<typeof fetchGreeting>>\n\nfunction fetchGreeting() {\n  return api.get('/hello')\n}\n\nexport function App() {\n  const [greeting, setGreeting] = useState<Greeting | null>(null)\n  const [health, setHealth] = useState<string>('checking…')\n\n  useEffect(() => {\n    fetchGreeting().then(setGreeting).catch(console.error)\n    api\n      .get('/hello/health')\n      .then((h) => setHealth(h.status))\n      .catch(() => setHealth('down'))\n  }, [])\n\n  return (\n    <main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>\n      <h1>KickJS fullstack</h1>\n      <p>\n        <strong>{greeting?.message ?? 'loading…'}</strong>\n      </p>\n      <p>\n        Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}\n        <code>{health}</code>\n      </p>\n      <p style={{ color: '#666' }}>\n        This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape\n        <code> HelloService.greet()</code> produces. Rename a field on the server and this file\n        stops compiling.\n      </p>\n    </main>\n  )\n}\n`\n}\n\nexport function webApi(): string {\n  return `import { createClient } from '@forinda/kickjs-client'\n\n// KickClientApi is ambient — the resolved route map from\n// server/.kickjs/types/kick__client.d.ts, wired in tsconfig's \\`types\\`. Every\n// response type is a literal shape, so nothing from the server's source graph\n// enters this program.\n//\n// Keys are module-mount-relative paths; the bootstrap-level '/api/v1' prefix\n// lives here in baseUrl, and the Vite dev proxy forwards it to the KickJS\n// server.\n//\n// Prefer an explicit import? The same file exports the type:\n//   import type { Api } from '../../server/.kickjs/types/kick__client'\nexport const api = createClient<KickClientApi.Api>({ baseUrl: '/api/v1' })\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(name: string, pm: string, cliVersion: string): string {\n  const scripts: Record<string, string> =\n    pm === 'pnpm'\n      ? {\n          dev: 'pnpm --parallel -r run dev',\n          // One origin: the server serves `web/dist` through SpaAdapter.\n          start: 'pnpm --filter ./server run start',\n          'dev:server': 'pnpm --filter ./server dev',\n          'dev:web': 'pnpm --filter ./web dev',\n          build: 'pnpm -r run build',\n          // No `npx`: the binary is `kick` but the package is\n          // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n          // falls back to the REGISTRY — where `kick` is an unrelated\n          // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n          // so this script would pass without type-checking anything.\n          //\n          // Every package manager puts `node_modules/.bin` on PATH for\n          // scripts, so the bare name resolves locally, and a missing install\n          // fails loudly instead of fetching a stranger.\n          typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n        }\n      : {\n          // cd-based scripts — the one form npm, yarn (classic AND berry),\n          // and bun all run identically; workspace-filter flags differ per\n          // manager (--workspace vs `yarn workspace <name>` vs --filter).\n          start: `cd server && ${pm} run start`,\n          'dev:server': `cd server && ${pm} run dev`,\n          'dev:web': `cd web && ${pm} run dev`,\n          build: `${pm} run build:server && ${pm} run build:web`,\n          'build:server': `cd server && ${pm} run build`,\n          'build:web': `cd web && ${pm} run build`,\n          // No `npx`: the binary is `kick` but the package is\n          // `@forinda/kickjs-cli`, so npx cannot map one to the other and\n          // falls back to the REGISTRY — where `kick` is an unrelated\n          // AngularJS scaffolder. It runs, prints its own help, and exits 0,\n          // so this script would pass without type-checking anything.\n          //\n          // Every package manager puts `node_modules/.bin` on PATH for\n          // scripts, so the bare name resolves locally, and a missing install\n          // fails loudly instead of fetching a stranger.\n          typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web',\n        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts,\n      // The CLI is a ROOT dependency so the bare `kick` in the scripts above\n      // resolves: package managers put `node_modules/.bin` on PATH for\n      // scripts, and the CLI otherwise lives only in `server/node_modules`.\n      devDependencies: { '@forinda/kickjs-cli': cliVersion },\n      workspaces: ['server', 'web'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction rootGitignore(): string {\n  return `node_modules/\ndist/\n.env\n*.log\n.DS_Store\n`\n}\n\nfunction rootReadme(name: string, pm: string): string {\n  return `# ${name}\n\nFullstack KickJS workspace — typed end to end.\n\n| Package   | What                                                              |\n| --------- | ----------------------------------------------------------------- |\n| \\`server/\\` | KickJS API (decorators, DI, \\`kick dev\\` with typegen watch)       |\n| \\`web/\\`    | Vite + React, typed against the API via \\`@forinda/kickjs-client\\` |\n\n## Develop\n\n\\`\\`\\`bash\n${pm} install\n${pm === 'pnpm' ? 'pnpm dev            # server (kick dev) + web (vite), in parallel' : `${pm} run dev:server   # terminal 1\\n${pm} run dev:web      # terminal 2`}\n\\`\\`\\`\n\nServer: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \\`/api\\`).\n\n## The type loop\n\n1. Server handlers **return** their payloads (\\`return this.service.greet(...)\\`).\n2. \\`kick typegen\\` emits \\`server/.kickjs/types/kick__client.d.ts\\` — the flat\n   route map with every response type resolved to a literal shape.\n3. \\`web/tsconfig.json\\` lists that file in \\`types\\`, so \\`KickClientApi\\` is\n   ambient — no import, no bridge file.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickClientApi.Api>\\` types every call site.\n\nBecause the map holds resolved types rather than references to controllers,\n\\`web\\` never compiles server source: no \\`experimentalDecorators\\`, no path\naliases into \\`server/src\\`.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\n### Keeping the map fresh\n\n\\`server/.kickjs/types/kick__client.d.ts\\` is generated, and \\`web\\` reads it as\nan ambient type package. Two things follow.\n\n**It is not refreshed by \\`kick dev\\`.** Resolving it builds a whole TypeScript\nprogram over the server, which is a build-step cost rather than a per-save one,\nso a renamed response field surfaces on the next \\`kick typegen\\` rather than on\nsave. Everything else in \\`.kickjs/types\\` still updates on save. Add\n\\`kick typegen --check\\` to CI and a stale map fails the build.\n\n**It needs a compiler API.** TypeScript 7 ships none, so \\`server\\` depends on\n\\`@typescript/typescript6\\`. Remove it and typegen skips this one file, saying\nso; \\`web\\` then reports \\`TS2688\\` because the file it lists in \\`types\\` is gone.\n\n### The other way to wire it\n\nA \\`types\\` entry says \"this is a global type package\", which is what the map is,\nand it fails loudly when the file is missing. If you would rather it be quiet\nwhen absent — say, a repo where the map is not always generated — use\n\\`include\\` instead:\n\n\\`\\`\\`json\n{ \"include\": [\"src\", \"../server/.kickjs/types/kick__client.d.ts\"] }\n\\`\\`\\`\n\nThat tolerates the file not existing, at the cost of \\`KickClientApi\\` silently\nnot resolving. Note \\`types\\` replaces TypeScript's automatic \\`@types\\`\ninclusion, so if you add entries there, list the ones you rely on too\n(\\`\"types\": [\"node\", \"../server/.kickjs/types/kick__client\"]\\`).\n\nOr skip the global entirely — the same file exports the type:\n\n\\`\\`\\`ts\nimport type { Api } from '../../server/.kickjs/types/kick__client'\n\nexport const api = createClient<Api>({ baseUrl: '/api/v1' })\n\\`\\`\\`\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n}\n"],"mappings":"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"}

package/dist/fullstack-DccMBr2Y.mjs

@@ -0,0 +1,189 @@
+/**
+ * @forinda/kickjs-cli v7.0.0
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import{l as e,n as t,t as n}from"./project-ZXTSFnxa.mjs";import{l as r}from"./project-docs-OH_dzRY0.mjs";import{join as i}from"node:path";import{execFileSync as a}from"node:child_process";async function o(o){let{name:_,directory:v,schemaLib:y=`zod`,runtime:b=`express`}=o,x=[`pnpm`,`npm`,`yarn`,`bun`].includes(o.packageManager),S=x?o.packageManager:`pnpm`,C=v,w=e=>console.log(`  ${e}`);o.packageManager!==void 0&&!x&&w(`Warning: unknown package manager '${String(o.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${_}\n`),await n({name:`${_}-server`,directory:i(C,`server`),packageManager:S,template:`minimal`,schemaLib:y,runtime:b,withClientMap:!0,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`});let T=await t(),E=T[`@forinda/kickjs-client`]??`^0.1.0`;await r(i(C,`web/package.json`),s(_,E)),await r(i(C,`web/vite.config.ts`),c()),await r(i(C,`web/tsconfig.json`),l()),await r(i(C,`web/index.html`),u(_)),await r(i(C,`web/src/main.tsx`),d()),await r(i(C,`web/src/App.tsx`),f()),await r(i(C,`web/src/api.ts`),p()),await r(i(C,`package.json`),m(_,S,T[`@forinda/kickjs-cli`])),S===`pnpm`&&await r(i(C,`pnpm-workspace.yaml`),`packages:
+  - server
+  - web
+
+allowBuilds:
+  '@swc/core': true
+  esbuild: true
+`),await r(i(C,`.gitignore`),h()),await r(i(C,`README.md`),g(_,S));let{generateAgentDocs:D}=await import(`./agent-docs-CskjGFT3.mjs`).then(e=>e.t);if(await D({outDir:C,name:_,pm:S,template:`fullstack`,only:`all`,force:!0}),o.installDeps){console.log(`\n  Installing workspace dependencies with ${S}...\n`);try{e(S,[`install`],{cwd:C})}catch{console.log(`\n  Warning: ${S} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-_JlS_scO.mjs`).then(e=>e.n);await e({cwd:i(C,`server`),allowDuplicates:!0,silent:!0})}catch{}if(o.initGit)try{a(`git`,[`init`],{cwd:C,stdio:`pipe`}),a(`git`,[`branch`,`-M`,`main`],{cwd:C,stdio:`pipe`}),a(`git`,[`add`,`-A`],{cwd:C,stdio:`pipe`}),a(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:C,stdio:`pipe`}),w(`Git repository initialized`)}catch{w(`Warning: git init failed (git may not be installed)`)}console.log(`
+  Fullstack workspace scaffolded!`),console.log(),w(`Next steps:`),w(`  cd ${_}`),o.installDeps||w(`  ${S} install`),S===`pnpm`?w(`  pnpm dev            # runs server (kick dev) + web (vite) together`):(w(`  ${S} run dev:server   # terminal 1`),w(`  ${S} run dev:web      # terminal 2`)),w(``),w(`The web app calls the API through @forinda/kickjs-client —`),w(`edit server/src/modules/hello and watch web/src/App.tsx's types follow.`),w(``)}function s(e,t){return`${JSON.stringify({name:`${e}-web`,private:!0,version:`0.0.0`,type:`module`,scripts:{dev:`vite`,build:`tsc --noEmit && vite build`,preview:`vite preview`,typecheck:`tsc --noEmit`},dependencies:{"@forinda/kickjs-client":t,react:`^19.0.0`,"react-dom":`^19.0.0`},devDependencies:{"@types/react":`^19.0.0`,"@types/react-dom":`^19.0.0`,"@vitejs/plugin-react":`^5.0.0`,typescript:`^5.9.0`,vite:`^7.0.0`}},null,2)}\n`}function c(){return`import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    // The KickJS server (kick dev) listens on 3000; the client's baseUrl is
+    // the relative '/api/v1', so the browser hits Vite and Vite forwards.
+    proxy: {
+      '/api': 'http://localhost:3000',
+    },
+  },
+})
+`}function l(){return`${JSON.stringify({compilerOptions:{target:`ES2022`,lib:[`ES2022`,`DOM`,`DOM.Iterable`],module:`ESNext`,moduleResolution:`bundler`,jsx:`react-jsx`,strict:!0,skipLibCheck:!0,noEmit:!0,isolatedModules:!0,types:[`../server/.kickjs/types/kick__client`]},include:[`src`]},null,2)}\n`}function u(e){return`<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${e}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"><\/script>
+  </body>
+</html>
+`}function d(){return`import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { App } from './App'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)
+`}function f(){return`import { useEffect, useState } from 'react'
+import { api } from './api'
+
+// The response types below are INFERRED from the server's handlers —
+// change server/src/modules/hello/hello.service.ts and these types follow on
+// the next \`kick typegen\`. Not under \`kick dev\`: resolving the client map
+// builds a whole TypeScript program, so it is a build step, not a per-save one.
+type Greeting = Awaited<ReturnType<typeof fetchGreeting>>
+
+function fetchGreeting() {
+  return api.get('/hello')
+}
+
+export function App() {
+  const [greeting, setGreeting] = useState<Greeting | null>(null)
+  const [health, setHealth] = useState<string>('checking…')
+
+  useEffect(() => {
+    fetchGreeting().then(setGreeting).catch(console.error)
+    api
+      .get('/hello/health')
+      .then((h) => setHealth(h.status))
+      .catch(() => setHealth('down'))
+  }, [])
+
+  return (
+    <main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>
+      <h1>KickJS fullstack</h1>
+      <p>
+        <strong>{greeting?.message ?? 'loading…'}</strong>
+      </p>
+      <p>
+        Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}
+        <code>{health}</code>
+      </p>
+      <p style={{ color: '#666' }}>
+        This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape
+        <code> HelloService.greet()</code> produces. Rename a field on the server and this file
+        stops compiling.
+      </p>
+    </main>
+  )
+}
+`}function p(){return`import { createClient } from '@forinda/kickjs-client'
+
+// KickClientApi is ambient — the resolved route map from
+// server/.kickjs/types/kick__client.d.ts, wired in tsconfig's \`types\`. Every
+// response type is a literal shape, so nothing from the server's source graph
+// enters this program.
+//
+// Keys are module-mount-relative paths; the bootstrap-level '/api/v1' prefix
+// lives here in baseUrl, and the Vite dev proxy forwards it to the KickJS
+// server.
+//
+// Prefer an explicit import? The same file exports the type:
+//   import type { Api } from '../../server/.kickjs/types/kick__client'
+export const api = createClient<KickClientApi.Api>({ baseUrl: '/api/v1' })
+`}function m(e,t,n){let r=t===`pnpm`?{dev:`pnpm --parallel -r run dev`,start:`pnpm --filter ./server run start`,"dev:server":`pnpm --filter ./server dev`,"dev:web":`pnpm --filter ./web dev`,build:`pnpm -r run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`${t} run build:server && ${t} run build:web`,"build:server":`cd server && ${t} run build`,"build:web":`cd web && ${t} run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,scripts:r,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function h(){return`node_modules/
+dist/
+.env
+*.log
+.DS_Store
+`}function g(e,t){return`# ${e}
+
+Fullstack KickJS workspace — typed end to end.
+
+| Package   | What                                                              |
+| --------- | ----------------------------------------------------------------- |
+| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch)       |
+| \`web/\`    | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
+
+## Develop
+
+\`\`\`bash
+${t} install
+${t===`pnpm`?`pnpm dev            # server (kick dev) + web (vite), in parallel`:`${t} run dev:server   # terminal 1\n${t} run dev:web      # terminal 2`}
+\`\`\`
+
+Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
+
+## The type loop
+
+1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
+2. \`kick typegen\` emits \`server/.kickjs/types/kick__client.d.ts\` — the flat
+   route map with every response type resolved to a literal shape.
+3. \`web/tsconfig.json\` lists that file in \`types\`, so \`KickClientApi\` is
+   ambient — no import, no bridge file.
+4. \`web/src/api.ts\`'s \`createClient<KickClientApi.Api>\` types every call site.
+
+Because the map holds resolved types rather than references to controllers,
+\`web\` never compiles server source: no \`experimentalDecorators\`, no path
+aliases into \`server/src\`.
+
+Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
+stops compiling. That's the point.
+
+### Keeping the map fresh
+
+\`server/.kickjs/types/kick__client.d.ts\` is generated, and \`web\` reads it as
+an ambient type package. Two things follow.
+
+**It is not refreshed by \`kick dev\`.** Resolving it builds a whole TypeScript
+program over the server, which is a build-step cost rather than a per-save one,
+so a renamed response field surfaces on the next \`kick typegen\` rather than on
+save. Everything else in \`.kickjs/types\` still updates on save. Add
+\`kick typegen --check\` to CI and a stale map fails the build.
+
+**It needs a compiler API.** TypeScript 7 ships none, so \`server\` depends on
+\`@typescript/typescript6\`. Remove it and typegen skips this one file, saying
+so; \`web\` then reports \`TS2688\` because the file it lists in \`types\` is gone.
+
+### The other way to wire it
+
+A \`types\` entry says "this is a global type package", which is what the map is,
+and it fails loudly when the file is missing. If you would rather it be quiet
+when absent — say, a repo where the map is not always generated — use
+\`include\` instead:
+
+\`\`\`json
+{ "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] }
+\`\`\`
+
+That tolerates the file not existing, at the cost of \`KickClientApi\` silently
+not resolving. Note \`types\` replaces TypeScript's automatic \`@types\`
+inclusion, so if you add entries there, list the ones you rely on too
+(\`"types": ["node", "../server/.kickjs/types/kick__client"]\`).
+
+Or skip the global entirely — the same file exports the type:
+
+\`\`\`ts
+import type { Api } from '../../server/.kickjs/types/kick__client'
+
+export const api = createClient<Api>({ baseUrl: '/api/v1' })
+\`\`\`
+
+Docs: https://kickjs.app/guide/typed-client.html
+`}export{o as initFullstackProject};

package/dist/index.d.mts

@@ -148,11 +148,14 @@ type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
 /**
  * Built-in repository type with first-class code generation support.
  *
- * Only `inmemory` remains built-in (zero-dep, framework-owned). The
- * `prisma` and `drizzle` ORM presets are **deprecated** — they now
- * scaffold a generic custom-repository stub like any other name (see
- * {@link DEPRECATED_REPO_TYPES}). Bring your own DB by passing a name:
- * `repo: { name: 'postgres' }`.
+ * Only `inmemory` is built in — zero-dependency and framework-owned.
+ *
+ * There are deliberately no ORM presets. A repository shaped to Prisma or
+ * Drizzle is that library's interface, not KickJS's, and a generator for it is
+ * a promise to track someone else's API across versions. Any other name
+ * scaffolds a generic custom-repository stub you own, passed as an object
+ * because `RepoTypeConfig` is `BuiltinRepoType | CustomRepoType` and the
+ * builtin side is `'inmemory'` alone: `repo: { name: 'postgres' }`.
  */
 type BuiltinRepoType$1 = 'inmemory';
 /** Custom repository type — generates a stub with TODO markers */
@@ -324,6 +327,24 @@ interface TypegenConfig {
    * not a strict registry.
    */
   disable?: string[];
+  /**
+   * Generate `.kickjs/types/kick__client.d.ts`, the self-contained route map
+   * a frontend consumes without compiling the server.
+   *
+   * Producing it means building a whole TypeScript program over the server —
+   * measured at 1.1 GB and ~7.6s on a 1,940-route app, against ~130ms for
+   * every other typegen plugin combined. An API with no frontend should not
+   * pay that for a file nothing reads, so this is not on for everyone.
+   *
+   * Off unless set. `kick new --template fullstack` writes `true`, since its
+   * web app reads the map; anything else opts in here.
+   *
+   * A map already on disk does NOT turn this on — that would put the switch
+   * somewhere nobody looks. It does get a warning, since a map left to rot is
+   * how a frontend ends up type-checking against routes the server no longer
+   * serves.
+   */
+  client?: boolean;
 }
 /** Module generation settings — controls how `kick g module` produces code */
 interface ModuleConfig {
@@ -332,18 +353,19 @@ interface ModuleConfig {
   /**
    * Default repository implementation for generators.
    *
-   * Built-in types (string): `'drizzle'`, `'inmemory'`, `'prisma'`
+   * Built-in type (string): `'inmemory'`. Any other name scaffolds a
+   * custom-repository stub — see {@link BuiltinRepoType}.
    * — generate fully working repository code.
    *
    * Custom types (object): `{ name: 'typeorm' }`
    * — generate a stub repository with TODO markers.
    *
    * @example
-   * repo: 'prisma'                // built-in
+   * repo: { name: 'postgres' }    // custom stub
    * repo: { name: 'typeorm' }     // custom
    */
   repo?: RepoTypeConfig;
-  /** Schema output directory (e.g. 'src/db/schema' for Drizzle, 'prisma/' for Prisma) */
+  /** Schema output directory (e.g. 'src/db/schema') */
   schemaDir?: string;
   /**
    * Whether to pluralize module names in generated code.
@@ -351,16 +373,6 @@ interface ModuleConfig {
    * When false, it creates `src/modules/user/` and uses singular names throughout.
    */
   pluralize?: boolean;
-  /**
-   * Import path for the Prisma generated client in `--repo prisma` templates.
-   * Must resolve within `src/` for path alias compatibility.
-   *
-   * @default '@prisma/client' (Prisma 5/6)
-   * @example
-   * prismaClientPath: '@/generated/prisma/client'  // Prisma 7+
-   * prismaClientPath: './generated/prisma/client'   // relative
-   */
-  prismaClientPath?: string;
   /**
    * Module declaration style emitted by `kick g module` and the
    * project scaffold.
@@ -398,9 +410,9 @@ interface KickConfig {
    * @example
    * modules: {
    *   dir: 'src/modules',
-   *   repo: 'prisma',
+   *   repo: 'postgres',
    *   pluralize: false,
-   *   schemaDir: 'prisma/',
+   *   schemaDir: 'src/db/schema',
    * }
    */
   modules?: ModuleConfig;
@@ -663,8 +675,6 @@ interface GenerateModuleOptions {
   dryRun?: boolean;
   /** When false, skip pluralization — use singular names for folders, routes, and classes */
   pluralize?: boolean;
-  /** Prisma client import path (default: '@prisma/client', Prisma 7+: '@/generated/prisma/client') */
-  prismaClientPath?: string;
   /**
    * DI-token scope prefix substituted into emitted `createToken<T>()`
    * literals. Resolved by the orchestrating command from
@@ -673,6 +683,8 @@ interface GenerateModuleOptions {
    * without a config in tests/fixtures.
    */
   tokenScope?: string;
+  /** Project depends on @forinda/kickjs-swagger — gates @ApiTags emission. */
+  swagger?: boolean;
   /**
    * Module declaration style — `'define'` (factory, default) or
    * `'class'` (legacy). Resolved by the orchestrating command from
@@ -788,6 +800,8 @@ interface InitProjectOptions {
   runtime?: 'express' | 'fastify' | 'h3';
   /** Wire `SpaAdapter` at this clientDir (fullstack template). */
   spaClientDir?: string;
+  /** Pin the compiler API + generate the client route map (fullstack). */
+  withClientMap?: boolean;
 }
 /** Scaffold a new KickJS project */
 declare function initProject(options: InitProjectOptions): Promise<void>;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/commands/add.ts","../src/commands/doctor.ts","../src/plugin/types.ts","../src/config.ts","../src/generators/templates/types.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/utils/project-root.ts","../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/typegen/token-conventions.ts","../src/typegen/index.ts","../src/typegen/run-plugins.ts","../src/asset-manager/build.ts","../src/typegen/dev-watcher.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":";;;;KA4OY;;;;;;;;;;;;;;;;;;;UCjNK;EACf;EACA;;;;;;;EAOA;;;;;;EAMA,SAAS;;UAGM;;EAEf;EACA;;EAEA;;EAEA;;KAGU,eACV,KAAK,kBACF,eAAe,wBAAwB,QAAQ,eAAe;;;;;;UAOlD;;EAEf,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqCK,sBAAsB,KAAK,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;iBA0B7C,kBAAkB,OAAO,cAAc;;;;KChG3C,uBAAuB,uBAAoB;;KAG3C,gBAAgB,gBAAa;;;;UC7BxB;;EAEf;;EAEA;;;;;;;;;EASA;;EAEA;;;KAIU;;KAGA;;;;;;;;;;KAaA;;UA2BK;EACf;;;KAIU,iBAAiB,oBAAkB;;;;;;;;;;;KAYnC;;;;;;UAOK;;;;;;;EAOf;;;;;;;EAOA;;;;;;EAMA;;;;;;;;;;;;;;;;;;;;;;EAsBA;;;;;;;;;;;;;;;;;;;;;;;;UAyBe;;;;;EAKf;;;;;EAKA;;EAEA;;;;;;;EAOA;;;;;;;EAOA,0BAA0B;;;UAIX;;;;;EAKf;;;;;EAKA;;;;;;;;;;;;;EAaA,kBAAkB;;;;;;;;;;EAUlB;;;;;;;;;;;;;;;;;;EAkBA;;;UAIe;;EAEf;;;;;;;;;;;;;;EAcA,OAAO;;EAEP;;;;;;EAMA;;;;;;;;;;EAUA;;;;;;;;;;;;;;;;;;;;EAoBA;;;UAIe;;;;;;;;EAQf,UAAU;;;;;;;;;;;;EAYV,UAAU;;;;;;;;;;;;;;;;EAgBV,iBAAiB;;;;;;;;;;;;;;;;;EAkBjB;;;;;;;;;;;;;;;;;;;EAoBA;;;;;;;;;;;;;;EAeA,WAAW;IAAiB;IAAa;;;;;;;;;;;;;EAYzC;;;;;;;IAOE;;;;;;;;;;;;;;;;;;;;;;;EAuBF,WAAW,eAAe;;;;;;;;;;;;EAY1B,UAAU;;;;EAIV;;;;;;;;;IASE;;;;;;;EAOF,KAAK;;EAEL,WAAW;;;;;;;;;;;;;;EAcX,UAAU;;EAEV;IACE;IACA;IACA;IACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCF,SA7CU;;;iBAiDI,aAAa,QAAQ,aAAa;;;;;;;;;;;;;;;;;;iBA2G5B,eAAe,mBAAmB,QAAQ;;;;;;;;;;;;;;;;;;;KC9mBpD;;;KCJA;KACA,WAAW;UASb;EACR;EACA;EACA;EACA;EACA,OAAO;EACP;EACA;EACA,UAAU;EACV;;EAEA;;EAEA;;;;;;;;EAQA;;;;;;EAMA,QAAQ;;;;;;;;;iBAUY,eAAe,SAAS,wBAAwB;;;UCvD5D;EACR;EACA;;;;;;;;;;;;;iBAcoB,gBAAgB,SAAS,yBAAyB;;;UCd9D;EACR;EACA;EACA;EACA;EACA,UAAU;EACV;;;;;;;;EAQA,UAAU;;iBAGU,mBAAmB,SAAS,4BAA4B;;;UCjBpE;EACR;EACA;EACA;EACA;EACA,UAAU;EACV;;iBAGoB,cAAc,SAAS,uBAAuB;;;UCT1D;EACR;EACA;EACA;EACA;EACA,UAAU;EACV;;iBAGoB,gBAAgB,SAAS,yBAAyB;;;UCT9D;EACR;EACA;EACA;EACA;EACA,UAAU;EACV;;iBAGoB,mBAAmB,SAAS,4BAA4B;;;UCTpE;EACR;EACA;EACA;EACA;EACA,UAAU;EACV;;iBAGoB,YAAY,SAAS,qBAAqB;;;KCwK3D;KACA;UAEK;EACR;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA;;EAEA,YAAY;;EAEZ;;EAEA;;;iBAIoB,YAAY,SAAS,qBAAqB;;;;;;;;;;;;;;;;;;iBCxLhD,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCcnB;KASD,wBAAwB;;UAGnB;;EAEf;;EAEA,WAAW;;EAEX;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;EAQA;EACA;EACA;;;;;;;EAOA,YAAY;EACZ,aAAa;EACb,cAAc;;;;;;;EAOd,iBAAiB;;EAEjB;;EAEA;;;;;;EAMA;;;;;;;;EAQA;;;;;;;;EAQA,oBAAoB;;;;;;;EAOpB;;;UAqBe;;EAEf;;;;;EAKA;;;UAIe;;EAEf;;;;;;EAMA;;;UAIe;;EAEf;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA,SAAS;;;;;;;;;UAUM;;EAEf;;EAEA;;;;;;;;;;;UAYe;;EAEf;;EAEA;;EAEA;;EAEA;;;;;;;;;UAUe;;EAEf;;;;;;;;;;;;EAYA;;EAEA;;EAEA;;;;;;;UAQe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;;UAUe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,WAAW;;;UAII;EACf,SAAS;EACT,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,YAAY;;EAEZ,KAAK;;EAEL,oBAAoB;;EAEpB,eAAe;;EAEf,aAAa;;;;;;EAMb,iBAAiB;;;UAIF;;EAEf;;EAEA;;EAEA;;EAEA;;;;;;;;EAQA;;;;;;;;EAQA;;;UAy/Ce;;EAEf;;EAEA;;;;UC/0De;EACf,KAAK;EACL,KAAK;EACL,MAAM;;UAGS;EACf;EACA,QAAQ;;;EAGR,SAAS,aAAa,kBAAkB,QAAQ;;EAEhD,UAAU,iBAAiB,mBAAmB;;;;;;;;;;;;;;;;;EAiB9C,cAAc,MAAM,cAAc,QAAQ;EAC1C,KAAK;;;;;;;EAOL;;UAGe;;EAEf;;EAEA;;;;;;;;;;;;;;;EAeA;;;;;EAKA,SAAS,KAAK,iBAAiB;;UAGhB;EACf;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;iBAqDc,cAAc,MAAM,gBAAgB;;;UCjGnC;EACf;EACA;EACA;EACA;EACA;;;;;;;;;UCAe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA;;EAEA;;EAEA;;;;;;;EAOA;;;;;;EAMA;;;;;;;;EAQA;;;;;;;EAOA;;;;;;;EAOA;;;;;;;EAOA,WAAW,eAAe;;;;;;;;;;EAU1B;;;;;;;EAOA,eAAe;;;;;;;;;;;iBAkCK,WAAW,OAAM,oBAAyB;EAC9D,MAAM;EACN,QAAQ;;EAER,eAAe;;;;;;;;;;;;;;;;;iBAiOK,sBACpB,gBACA,wBAAwB,uBACxB,kBACC;;;UCjXc;EACf;;EAEA,QAAQ;;EAER;;EAEA;;;;;;EAMA,eAAe;;EAEf;;iBAGoB,qBACpB,MAAM,8BACL,QAAQ;;;;cC9BE;;UAGI;EACf,gBAAgB;;;;;;;;;;EAUhB,SAAS;;UAGM;;EAEf;;;;;;;EAOA;;EAEA;;;UAIe;EACf;EACA;EACA;;;;;;EAMA;;;UAIe;EACf;EACA,SAAS;;EAET,UAAU;;;;;;;;;;;;;iBAcU,YACpB,QAAQ,mBACR,MAAM,qBACL,QAAQ;;;;;;;;cCrDE;KAED;;UAGK;EACf,mBAAmB;EACnB,6BAA6B;EAC7B,8BAA8B;EAC9B,oBAAoB;;UAGL;EACf;;EAEA,QAAQ;;;;;EAKR,cAAc;;;;;;EAMd;;EAEA;;EAEA,WAAW;;UAGI;;EAEf,iBAAiB,OAAO,mBAAmB;;;;;EAK3C;;;;;;EAMA;;EAEA;;iBAGc,wBAAwB,MAAM,2BAA2B;;;;;;;;UC3ExD;EACf;EACA,MAAM;;;;;;;UAQS;EACf,YAAY;;EAEZ;;;;;EAKA,QAAQ;IAAQ;IAAgB;;;;;;;;;;;iBCblB,sBAAsB;EACpC;EACA;EACA,QAAQ;EACR;EACA;;;;;;;EAOA;EACA;IACE;;;;iBC5BY,aAAa;;iBAOb,YAAY;;iBAMZ,YAAY;;;;;;iBAYZ,UAAU"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/commands/add.ts","../src/commands/doctor.ts","../src/plugin/types.ts","../src/config.ts","../src/generators/templates/types.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/utils/project-root.ts","../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/typegen/token-conventions.ts","../src/typegen/index.ts","../src/typegen/run-plugins.ts","../src/asset-manager/build.ts","../src/typegen/dev-watcher.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v6.15.1
+ * @forinda/kickjs-cli v7.0.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{F as e,N as t,P as n,c as r,d as i,f as a,g as o,h as s,j as c,l,m as u,n as d,o as f,p,s as m,t as h,v as g,x as _}from"./doctor-CHB6rl5Q.mjs";import{t as v}from"./project-mSo3W3zE.mjs";import{i as y,r as b}from"./config-CKBLLO-j.mjs";import{t as x}from"./project-root-Aq5DOz-j.mjs";import{n as S,t as C}from"./types-BQOKyLP8.mjs";export{C as KickPluginConflictError,r as TYPEGEN_OWNER_KEY,f as buildGeneratorContext,l as createTypegenDevWatcher,S as defineCliPlugin,b as defineConfig,h as defineDoctorCheck,d as defineDoctorExtension,m as defineGenerator,i as defineTypegen,x as findProjectRoot,g as generateAdapter,p as generateController,a as generateDto,s as generateGuard,o as generateMiddleware,_ as generateModule,u as generateService,v as initProject,y as loadKickConfig,c as pluralize,t as toCamelCase,n as toKebabCase,e as toPascalCase};
+import{F as e,I as t,M as n,P as r,S as i,_ as a,c as o,d as s,g as c,h as l,l as u,m as d,n as f,o as p,p as m,s as h,t as g,y as _}from"./doctor-DOcvYGMG.mjs";import{t as v}from"./project-RMuxqw1k.mjs";import{a as y,r as b}from"./config-Cq-quG7q.mjs";import{t as x}from"./project-root-D8FOMFdT.mjs";import{n as S,t as C}from"./types-DYDvLhqy.mjs";export{C as KickPluginConflictError,o as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,b as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,s as defineTypegen,x as findProjectRoot,_ as generateAdapter,d as generateController,m as generateDto,c as generateGuard,a as generateMiddleware,i as generateModule,l as generateService,v as initProject,y as loadKickConfig,n as pluralize,r as toCamelCase,e as toKebabCase,t as toPascalCase};

package/dist/{plugin-Y-IVgvlu.mjs → plugin-BXf1bhiA.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v6.15.1
+ * @forinda/kickjs-cli v7.0.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-Pz0cqJu0.mjs";import{KickPluginConflictError as t,defineCliPlugin as n}from"@forinda/kickjs-cli-kit";function r(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r;if(n)r={generators:d,...n};else{let{findProjectRoot:e}=await import(`./project-root-CAM62woQ.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:d}}for(let n of e)n.register&&await n.register(t,r)}}}var i=e({mergeCliPlugins:()=>r});export{r as n,n as r,i as t};
+import{t as e}from"./rolldown-runtime-BaQcsmMo.mjs";import{KickPluginConflictError as t,defineCliPlugin as n}from"@forinda/kickjs-cli-kit";function r(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r;if(n)r={generators:d,...n};else{let{findProjectRoot:e}=await import(`./project-root-BMn6XJ0F.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:d}}for(let n of e)n.register&&await n.register(t,r)}}}var i=e({mergeCliPlugins:()=>r});export{r as n,n as r,i as t};