@forinda/kickjs-cli 8.10.2 → 8.12.0

package/dist/{fullstack-BqYdhTDI.mjs → fullstack-XhuwRQEb.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.2
+ * @forinda/kickjs-cli v8.12.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,11 +8,11 @@
  *
  * @license MIT
  */
-import{o as e}from"./package-manager-DBmD5nSr.mjs";import{d as t,i as n}from"./config-CsOfUFfq.mjs";import{a as r,d as i,f as a,g as o,h as s,l as c,m as l,n as u,p as d,t as f}from"./project-C98JovY4.mjs";import{join as p}from"node:path";import{execFileSync as m}from"node:child_process";const h=`https://kickjs.app/guide/fullstack-frontend.html`,g=[{value:`react-ts`,label:`React`},{value:`react-compiler-ts`,label:`React + Compiler`},{value:`vue-ts`,label:`Vue`},{value:`svelte-ts`,label:`Svelte`},{value:`solid-ts`,label:`Solid`},{value:`preact-ts`,label:`Preact`},{value:`lit-ts`,label:`Lit`},{value:`qwik-ts`,label:`Qwik`},{value:`vanilla-ts`,label:`Vanilla`}],_=`react-ts`;function v(e,t,n=_){let r=[`--template`,n,`--no-interactive`,`--no-immediate`];return e===`yarn`||e===`bun`?[e,`create`,`vite`,t,...r]:e===`npm`?[e,`create`,`vite@latest`,t,`--`,...r]:[e,`create`,`vite@latest`,t,...r]}async function y(t){let{name:g,directory:y,schemaLib:C=`zod`,runtime:w=`express`,packages:T=[],frontend:E=`kick`,viteTemplate:D=_}=t,O=[`pnpm`,`npm`,`yarn`,`bun`].includes(t.packageManager),k=O?t.packageManager:`pnpm`,A=y,j=e=>console.log(`  ${e}`);t.packageManager!==void 0&&!O&&j(`Warning: unknown package manager '${String(t.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${g}\n`),console.log(`  Resolving package versions...`);let M=await u(),N=await f({name:`${g}-server`,directory:p(A,`server`),packageManager:k,template:`minimal`,schemaLib:C,runtime:w,packages:T,extraLayers:[`server-fullstack`],approveInstallScripts:!1,platformConfig:!1,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`,versions:M});if(E===`vite`){console.log(`\n  Handing web/ to create-vite (${D})...\n`);let[e,...t]=v(k,`web`,D);c(e,t,{cwd:A})}else await e(p(A,`web/package.json`),b(g,M));let P=d(k);await e(p(A,`package.json`),x(g,k,M[`@forinda/kickjs-cli`],P));let F=l(k,P);F&&await e(p(A,`.yarnrc.yml`),F),k===`pnpm`&&await e(p(A,`pnpm-workspace.yaml`),`packages:
+import{o as e}from"./package-manager-DvXi-NGm.mjs";import{i as t,p as n}from"./config-DbnBakh8.mjs";import{a as r,d as i,f as a,g as o,h as s,l as c,m as l,n as u,p as d,t as f}from"./project-BN1DnrN3.mjs";import{join as p}from"node:path";import{execFileSync as m}from"node:child_process";const h=`https://kickjs.app/guide/fullstack-frontend.html`,g=[{value:`react-ts`,label:`React`},{value:`react-compiler-ts`,label:`React + Compiler`},{value:`vue-ts`,label:`Vue`},{value:`svelte-ts`,label:`Svelte`},{value:`solid-ts`,label:`Solid`},{value:`preact-ts`,label:`Preact`},{value:`lit-ts`,label:`Lit`},{value:`qwik-ts`,label:`Qwik`},{value:`vanilla-ts`,label:`Vanilla`}],_=`react-ts`;function v(e,t,n=_){let r=[`--template`,n,`--no-interactive`,`--no-immediate`];return e===`yarn`||e===`bun`?[e,`create`,`vite`,t,...r]:e===`npm`?[e,`create`,`vite@latest`,t,`--`,...r]:[e,`create`,`vite@latest`,t,...r]}async function y(n){let{name:g,directory:y,schemaLib:C=`zod`,runtime:w=`express`,packages:T=[],frontend:E=`kick`,viteTemplate:D=_}=n,O=[`pnpm`,`npm`,`yarn`,`bun`].includes(n.packageManager),k=O?n.packageManager:`pnpm`,A=y,j=e=>console.log(`  ${e}`);n.packageManager!==void 0&&!O&&j(`Warning: unknown package manager '${String(n.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${g}\n`),console.log(`  Resolving package versions...`);let M=await u(),N=await f({name:`${g}-server`,directory:p(A,`server`),packageManager:k,template:`minimal`,schemaLib:C,runtime:w,packages:T,extraLayers:[`server-fullstack`],approveInstallScripts:!1,platformConfig:!1,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`,versions:M});if(E===`vite`){console.log(`\n  Handing web/ to create-vite (${D})...\n`);let[e,...t]=v(k,`web`,D);c(e,t,{cwd:A})}else await e(p(A,`web/package.json`),b(g,M));let P=d(k);await e(p(A,`package.json`),x(g,k,M[`@forinda/kickjs-cli`],P));let F=l(k,P);F&&await e(p(A,`.yarnrc.yml`),F),k===`pnpm`&&await e(p(A,`pnpm-workspace.yaml`),`packages:
   - server
   - web
-`),r(k,A,N.builds);let I=[`fullstack-root`,...E===`vite`?[]:[`web-kick`]],L=s(o(I).files,{name:g,packageManager:k});for(let[t,n]of L)await e(p(A,t),n);await e(p(A,`README.md`),S(g,k,E)),await e(p(A,`Dockerfile`),i(`fullstack`,k,g,P)),await e(p(A,`.dockerignore`),a());let{generateAgentDocs:R}=await import(`./agent-docs-ZgfnGL-j.mjs`).then(e=>e.t);if(await R({outDir:A,name:g,pm:k,template:`fullstack`,only:`all`,force:!0}),t.installDeps){console.log(`\n  Installing workspace dependencies with ${k}...\n`);try{c(k,[`install`],{cwd:A})}catch{console.log(`\n  Warning: ${k} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-DSaawXaQ.mjs`).then(e=>e.n);await e({cwd:p(A,`server`),allowDuplicates:!0,silent:!0})}catch{}if(t.initGit)try{m(`git`,[`init`],{cwd:A,stdio:`pipe`}),m(`git`,[`branch`,`-M`,`main`],{cwd:A,stdio:`pipe`}),m(`git`,[`add`,`-A`],{cwd:A,stdio:`pipe`}),m(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:A,stdio:`pipe`}),j(`Git repository initialized`)}catch{j(`Warning: git init failed (git may not be installed)`)}console.log(`
-  Fullstack workspace scaffolded!`),console.log(),j(`Next steps:`),j(`  cd ${g}`),t.installDeps||j(`  ${k} install`),k===`pnpm`?j(`  pnpm dev            # runs server (kick dev) + web (vite) together`):(j(`  ${k} run dev:server   # terminal 1`),j(`  ${k} run dev:web      # terminal 2`)),j(``),E===`vite`?(j(`web/ is create-vite output, unwired. To type it against the API:`),j(`  ${h}`)):(j(`The web app calls the API through @forinda/kickjs-client —`),j(`edit server/src/modules/hello, run \`${n(k,`kick`)} typegen\` in server/, and`),j(`web/src/App.tsx's types follow.`)),j(``)}function b(e,t){let n=e=>t[e]??`latest`;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":n(`@forinda/kickjs-client`),react:n(`react`),"react-dom":n(`react-dom`)},devDependencies:{"@types/react":n(`@types/react`),"@types/react-dom":n(`@types/react-dom`),"@vitejs/plugin-react":n(`@vitejs/plugin-react`),typescript:n(`typescript`),vite:n(`vite`)}},null,2)}\n`}function x(e,t,n,r=d(t)){let i=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 --filter ./server exec kick typegen && pnpm -r run build`,"build:netlify":`pnpm build && pnpm --filter ./server exec kick build:netlify`,"build:vercel":`pnpm build && pnpm --filter ./server exec kick build:vercel`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`,test:`pnpm --filter ./server test`,format:`cd server && kick format`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`cd server && kick typegen && cd .. && ${t} run build:server && ${t} run build:web`,"build:netlify":`${t} run build && cd server && kick build:netlify`,"build:vercel":`${t} run build && cd server && kick build:vercel`,"build:server":`cd server && ${t} run build`,"build:web":`cd web && ${t} run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`,test:`cd server && ${t} run test`,format:`cd server && kick format`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,...r?{packageManager:r}:{},scripts:i,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function S(e,r,i=`kick`){let a=`# ${e}
+`),r(k,A,N.builds);let I=[`fullstack-root`,...E===`vite`?[]:[`web-kick`]],L=s(o(I).files,{name:g,packageManager:k});for(let[t,n]of L)await e(p(A,t),n);await e(p(A,`README.md`),S(g,k,E)),await e(p(A,`Dockerfile`),i(`fullstack`,k,g,P)),await e(p(A,`.dockerignore`),a());let{generateAgentDocs:R}=await import(`./agent-docs-ykxoPqXX.mjs`).then(e=>e.t);if(await R({outDir:A,name:g,pm:k,template:`fullstack`,only:`all`,force:!0}),n.installDeps){console.log(`\n  Installing workspace dependencies with ${k}...\n`);try{c(k,[`install`],{cwd:A})}catch{console.log(`\n  Warning: ${k} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-AGdhxyRc.mjs`).then(e=>e.n);await e({cwd:p(A,`server`),allowDuplicates:!0,silent:!0})}catch{}if(n.initGit)try{m(`git`,[`init`],{cwd:A,stdio:`pipe`}),m(`git`,[`branch`,`-M`,`main`],{cwd:A,stdio:`pipe`}),m(`git`,[`add`,`-A`],{cwd:A,stdio:`pipe`}),m(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:A,stdio:`pipe`}),j(`Git repository initialized`)}catch{j(`Warning: git init failed (git may not be installed)`)}console.log(`
+  Fullstack workspace scaffolded!`),console.log(),j(`Next steps:`),j(`  cd ${g}`),n.installDeps||j(`  ${k} install`),k===`pnpm`?j(`  pnpm dev            # runs server (kick dev) + web (vite) together`):(j(`  ${k} run dev:server   # terminal 1`),j(`  ${k} run dev:web      # terminal 2`)),j(``),E===`vite`?(j(`web/ is create-vite output, unwired. To type it against the API:`),j(`  ${h}`)):(j(`The web app calls the API through @forinda/kickjs-client —`),j(`edit server/src/modules/hello, run \`${t(k,`kick`)} typegen\` in server/, and`),j(`web/src/App.tsx's types follow.`)),j(``)}function b(e,t){let n=e=>t[e]??`latest`;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":n(`@forinda/kickjs-client`),react:n(`react`),"react-dom":n(`react-dom`)},devDependencies:{"@types/react":n(`@types/react`),"@types/react-dom":n(`@types/react-dom`),"@vitejs/plugin-react":n(`@vitejs/plugin-react`),typescript:n(`typescript`),vite:n(`vite`)}},null,2)}\n`}function x(e,t,n,r=d(t)){let i=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 --filter ./server exec kick typegen && pnpm -r run build`,"build:netlify":`pnpm build && pnpm --filter ./server exec kick build:netlify`,"build:vercel":`pnpm build && pnpm --filter ./server exec kick build:vercel`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web --no-typegen`,test:`pnpm --filter ./server test`,format:`cd server && kick format`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`cd server && kick typegen && cd .. && ${t} run build:server && ${t} run build:web`,"build:netlify":`${t} run build && cd server && kick build:netlify`,"build:vercel":`${t} run build && cd server && kick build:vercel`,"build:server":`cd server && ${t} run build`,"build:web":`cd web && ${t} run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web --no-typegen`,test:`cd server && ${t} run test`,format:`cd server && kick format`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,...r?{packageManager:r}:{},scripts:i,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function S(e,r,i=`kick`){let a=`# ${e}
 
 Fullstack KickJS workspace — typed end to end.
 
@@ -30,9 +30,9 @@ ${r===`pnpm`?`pnpm dev            # server (kick dev) + web (vite), in parallel`
 
 Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
 
-From this root: \`${t(r,`test`)}\` (the server's tests), \`${t(r,`typecheck`)}\` (both packages),
-\`${t(r,`format`)}\` and \`${t(r,`build`)}\`. The \`kick\` CLI itself runs in \`server/\`, which holds
-\`kick.config.ts\`: \`cd server && ${n(r,`kick`)} typegen\`.
+From this root: \`${n(r,`test`)}\` (the server's tests), \`${n(r,`typecheck`)}\` (both packages),
+\`${n(r,`format`)}\` and \`${n(r,`build`)}\`. The \`kick\` CLI itself runs in \`server/\`, which holds
+\`kick.config.ts\`: \`cd server && ${t(r,`kick`)} typegen\`.
 
 ## The type loop
 
@@ -97,4 +97,4 @@ Four steps — typed client, \`/api\` dev proxy, route-map types, \`src/api.ts\`
 
 ${h}
 `}export{_ as DEFAULT_VITE_TEMPLATE,g as VITE_TEMPLATES,y as initFullstackProject};
-//# sourceMappingURL=fullstack-BqYdhTDI.mjs.map
+//# sourceMappingURL=fullstack-XhuwRQEb.mjs.map

package/dist/{fullstack-BqYdhTDI.mjs.map → fullstack-XhuwRQEb.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"fullstack-BqYdhTDI.mjs","names":["writeFileSafe","runScript","execBin","approveInstallScripts","generateDockerfile","generateDockerignore","renderLayers","fillVars","runCommand","yarnrc","resolveSiblingVersions","packageManagerSpec","initProject","FRONTEND_WIRING_URL","VITE_TEMPLATES","DEFAULT_VITE_TEMPLATE","createViteCommand","flags","template","pm","dir","initFullstackProject","options","pmValid","packageManager","directory","log","msg","name","versions","server","join","frontend","viteTemplate","file","args","webPackageJson","pmSpec","rootPackageJson","yarnConfig","layers","files","path","contents","rootReadme","n","generateAgentDocs","runTypegen","execFileSync","dep","pkg","scripts","cliVersion","readme","typeLoop"],"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 KickClientApi.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, then by the root `build` script and `kick dev` startup — not on save) 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 { execBin, runScript, type PackageManager } from '../config'\nimport { packageManagerSpec, yarnrc } from './templates/project-config'\nimport { generateDockerfile, generateDockerignore } from './templates/docker'\nimport { runCommand } from '../utils/shell'\nimport { initProject, resolveSiblingVersions } from './project'\nimport { approveInstallScripts } from '../commands/add'\nimport { fillVars, renderLayers } from '../scaffold/overlay'\n\n/** Wiring a frontend we did not scaffold: typed client, proxy, route types. */\nexport const FRONTEND_WIRING_URL = 'https://kickjs.app/guide/fullstack-frontend.html'\n\n/**\n * create-vite's TypeScript templates, in the order it lists them. Only the\n * `-ts` half: the wiring is typed — the route map is a `.d.ts` and the client\n * is `createClient<KickClientApi.Api>` — so a JavaScript template would leave\n * the reader following a guide that cannot apply.\n */\nexport const VITE_TEMPLATES = [\n  { value: 'react-ts', label: 'React' },\n  { value: 'react-compiler-ts', label: 'React + Compiler' },\n  { value: 'vue-ts', label: 'Vue' },\n  { value: 'svelte-ts', label: 'Svelte' },\n  { value: 'solid-ts', label: 'Solid' },\n  { value: 'preact-ts', label: 'Preact' },\n  { value: 'lit-ts', label: 'Lit' },\n  { value: 'qwik-ts', label: 'Qwik' },\n  { value: 'vanilla-ts', label: 'Vanilla' },\n] as const\n\nexport const DEFAULT_VITE_TEMPLATE = 'react-ts'\n\n/**\n * How each package manager runs create-vite, with the framework decided here\n * rather than by its prompts:\n *\n * - `--template` picks a TypeScript template, so the wiring guide applies;\n * - `--no-interactive` means it never waits for input (CI, `--yes`);\n * - `--no-immediate` stops it installing and launching a dev server — the\n *   workspace install happens once, at the root, after this returns.\n */\nexport function createViteCommand(\n  pm: 'pnpm' | 'npm' | 'yarn' | 'bun',\n  dir: string,\n  template: string = DEFAULT_VITE_TEMPLATE,\n): string[] {\n  const flags = ['--template', template, '--no-interactive', '--no-immediate']\n  // yarn and bun resolve `create vite` to create-vite themselves; npm and pnpm\n  // take the versioned package name, and npm needs `--` before the flags or it\n  // eats them itself.\n  if (pm === 'yarn' || pm === 'bun') return [pm, 'create', 'vite', dir, ...flags]\n  if (pm === 'npm') return [pm, 'create', 'vite@latest', dir, '--', ...flags]\n  return [pm, 'create', 'vite@latest', dir, ...flags]\n}\n\nexport interface InitFullstackOptions {\n  name: string\n  directory: string\n  packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n  /**\n   * Who scaffolds `web/`. `'kick'` writes the wired React app (typed client,\n   * dev proxy, route-map types). `'vite'` hands the directory to\n   * `create-vite` and wires nothing — you pick the framework, and the guide\n   * at {@link FRONTEND_WIRING_URL} covers connecting it.\n   */\n  frontend?: 'kick' | 'vite'\n  /** create-vite template for `frontend: 'vite'`. Default `react-ts`. */\n  viteTemplate?: string\n  initGit?: boolean\n  installDeps?: boolean\n  schemaLib?: 'zod' | 'valibot' | 'yup'\n  runtime?: 'express' | 'fastify' | 'h3'\n  /** Optional packages (`--packages`), wired into the server like a plain scaffold. */\n  packages?: string[]\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n  const {\n    name,\n    directory,\n    schemaLib = 'zod',\n    runtime = 'express',\n    packages = [],\n    frontend = 'kick',\n    viteTemplate = DEFAULT_VITE_TEMPLATE,\n  } = 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  // One map for both packages: the workspace shares a toolchain, so server/\n  // and web/ must not end up on different vite or TypeScript majors.\n  console.log('  Resolving package versions...')\n  const versions = await resolveSiblingVersions()\n\n  // ── server/ — the standard scaffold, deferred install/git ──────────\n  const server = await initProject({\n    name: `${name}-server`,\n    directory: join(dir, 'server'),\n    packageManager,\n    template: 'minimal',\n    schemaLib,\n    runtime,\n    packages,\n    // The client route map web/ reads (with the compiler API it needs), and a\n    // strict port — web/vite.config.ts proxies /api to it, so moving to\n    // another port would silently reach the wrong process.\n    extraLayers: ['server-fullstack'],\n    // server/ is a workspace member; the root records the approvals.\n    approveInstallScripts: false,\n    // netlify.toml / vercel.json live at the workspace root, written below.\n    platformConfig: false,\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    versions,\n  })\n\n  // ── web/ — either our wired React app, or whatever create-vite makes ──\n  if (frontend === 'vite') {\n    // create-vite scaffolds it with the chosen TypeScript template. Nothing\n    // is patched afterwards: a scaffold we didn't write is not ours to\n    // rewrite, and the wiring is four steps in the guide.\n    console.log(`\\n  Handing web/ to create-vite (${viteTemplate})...\\n`)\n    const [file, ...args] = createViteCommand(packageManager, 'web', viteTemplate)\n    runCommand(file!, args, { cwd: dir })\n  } else {\n    // The wired React app (typed client, dev proxy, route-map types): its\n    // package.json here, its files from the web-kick layer below.\n    await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, versions))\n  }\n\n  // ── workspace root ──────────────────────────────────────────────────\n  const pmSpec = packageManagerSpec(packageManager)\n  await writeFileSafe(\n    join(dir, 'package.json'),\n    rootPackageJson(name, packageManager, versions['@forinda/kickjs-cli'], pmSpec),\n  )\n  const yarnConfig = yarnrc(packageManager, pmSpec)\n  if (yarnConfig) await writeFileSafe(join(dir, '.yarnrc.yml'), yarnConfig)\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    await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), 'packages:\\n  - server\\n  - web\\n')\n  }\n  // Before install, at the root every package manager reads them from.\n  approveInstallScripts(packageManager, dir, server.builds)\n  // .gitignore, and netlify.toml / vercel.json at the root both platforms\n  // build from; plus the kick web app's files under web/.\n  const layers = ['fullstack-root', ...(frontend === 'vite' ? [] : ['web-kick'])]\n  const files = fillVars(renderLayers(layers).files, { name, packageManager })\n  for (const [path, contents] of files) {\n    await writeFileSafe(join(dir, path), contents)\n  }\n  await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager, frontend))\n  await writeFileSafe(\n    join(dir, 'Dockerfile'),\n    generateDockerfile('fullstack', packageManager, name, pmSpec),\n  )\n  await writeFileSafe(join(dir, '.dockerignore'), generateDockerignore())\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 KickClientApi.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 typegen` in server/ (or the root `build`) writes it later.\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  if (frontend === 'vite') {\n    // Nothing in web/ knows about the API yet — say so, and say where the\n    // four wiring steps live rather than half-wiring someone else's scaffold.\n    log('web/ is create-vite output, unwired. To type it against the API:')\n    log(`  ${FRONTEND_WIRING_URL}`)\n  } else {\n    log('The web app calls the API through @forinda/kickjs-client —')\n    log(\n      `edit server/src/modules/hello, run \\`${execBin(packageManager, 'kick')} typegen\\` in server/, and`,\n    )\n    log(\"web/src/App.tsx's types follow.\")\n  }\n  log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, versions: Record<string, string>): string {\n  // Every range here is resolved at scaffold time — see THIRD_PARTY_PACKAGES.\n  const dep = (pkg: string) => versions[pkg] ?? 'latest'\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': dep('@forinda/kickjs-client'),\n        react: dep('react'),\n        'react-dom': dep('react-dom'),\n      },\n      devDependencies: {\n        '@types/react': dep('@types/react'),\n        '@types/react-dom': dep('@types/react-dom'),\n        '@vitejs/plugin-react': dep('@vitejs/plugin-react'),\n        // Same majors as the server package: one workspace, one toolchain.\n        typescript: dep('typescript'),\n        vite: dep('vite'),\n      },\n    },\n    null,\n    2,\n  )}\\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nexport function rootPackageJson(\n  name: string,\n  pm: string,\n  cliVersion: string,\n  pmSpec = packageManagerSpec(pm),\n): 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          // Typegen first: web's `tsc` reads server/.kickjs/types, which is\n          // git-ignored, so a fresh clone (CI, Netlify, Vercel) has none and\n          // `pnpm -r run build` races the two packages anyway.\n          build: 'pnpm --filter ./server exec kick typegen && pnpm -r run build',\n          'build:netlify': 'pnpm build && pnpm --filter ./server exec kick build:netlify',\n          'build:vercel': 'pnpm build && pnpm --filter ./server exec kick build:vercel',\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          test: 'pnpm --filter ./server test',\n          // The server's own `format` command (kick.config.ts).\n          format: 'cd server && kick format',\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          // Typegen first — see the pnpm branch above. A bare `kick`, not\n          // `<pm> exec kick` (`bun exec` runs a shell string): the root depends\n          // on the CLI, so scripts have it on PATH — see `typecheck` below.\n          build: `cd server && kick typegen && cd .. && ${pm} run build:server && ${pm} run build:web`,\n          'build:netlify': `${pm} run build && cd server && kick build:netlify`,\n          'build:vercel': `${pm} run build && cd server && kick build:vercel`,\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          test: `cd server && ${pm} run test`,\n          // The server's own `format` command (kick.config.ts).\n          format: 'cd server && kick format',\n        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      ...(pmSpec ? { packageManager: pmSpec } : {}),\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\nexport function rootReadme(name: string, pm: string, frontend: 'kick' | 'vite' = 'kick'): string {\n  const readme = `# ${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\nFrom this root: \\`${runScript(pm as PackageManager, 'test')}\\` (the server's tests), \\`${runScript(pm as PackageManager, 'typecheck')}\\` (both packages),\n\\`${runScript(pm as PackageManager, 'format')}\\` and \\`${runScript(pm as PackageManager, 'build')}\\`. The \\`kick\\` CLI itself runs in \\`server/\\`, which holds\n\\`kick.config.ts\\`: \\`cd server && ${execBin(pm as PackageManager, 'kick')} typegen\\`.\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**\\`kick dev\\` writes it at startup, not on save.** 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  if (frontend !== 'vite') return readme\n\n  // create-vite's output is not ours to describe: it has no typed client, no\n  // proxy and no route-map types until the reader wires them. Everything from\n  // \"The type loop\" on is about files that do not exist in that scaffold.\n  const typeLoop = readme.indexOf('## The type loop')\n  return `${readme\n    .slice(0, typeLoop)\n    .replace(\n      'Vite + React, typed against the API via `@forinda/kickjs-client`',\n      'create-vite scaffold — unwired (see below)                       ',\n    )\n    .replace(' (Vite proxies `/api`)', '')}## Wiring web/ to the API\n\n\\`web/\\` is whatever create-vite scaffolded; nothing connects it to the API yet.\nFour steps — typed client, \\`/api\\` dev proxy, route-map types, \\`src/api.ts\\`:\n\n${FRONTEND_WIRING_URL}\n`\n}\n"],"mappings":";;;;;;;;;;iSA0BA,MAAaa,EAAsB,mDAQtBC,EAAiB,CAC5B,CAAE,MAAO,WAAY,MAAO,OAAQ,EACpC,CAAE,MAAO,oBAAqB,MAAO,kBAAmB,EACxD,CAAE,MAAO,SAAU,MAAO,KAAM,EAChC,CAAE,MAAO,YAAa,MAAO,QAAS,EACtC,CAAE,MAAO,WAAY,MAAO,OAAQ,EACpC,CAAE,MAAO,YAAa,MAAO,QAAS,EACtC,CAAE,MAAO,SAAU,MAAO,KAAM,EAChC,CAAE,MAAO,UAAW,MAAO,MAAO,EAClC,CAAE,MAAO,aAAc,MAAO,SAAU,CAC1C,EAEaC,EAAwB,WAWrC,SAAgBC,EACd,EACA,EACA,EAAmBD,EACT,CACV,IAAME,EAAQ,CAAC,aAAcC,EAAU,mBAAoB,gBAAgB,EAM3E,OAFIC,IAAO,QAAUA,IAAO,MAAc,CAACA,EAAI,SAAU,OAAQC,EAAK,GAAGH,CAAK,EAC1EE,IAAO,MAAc,CAACA,EAAI,SAAU,cAAeC,EAAK,KAAM,GAAGH,CAAK,EACnE,CAACE,EAAI,SAAU,cAAeC,EAAK,GAAGH,CAAK,CACpD,CAuBA,eAAsBI,EAAqB,EAA8C,CACvF,GAAM,CACJ,OACA,YACA,YAAY,MACZ,UAAU,UACV,WAAW,CAAC,EACZ,WAAW,OACX,eAAeN,GACbO,EAIEC,EAAW,CAAC,OAAQ,MAAO,OAAQ,KAAK,CAAC,CAAW,SACxDD,EAAQ,cACV,EACME,EAAiBD,EAClBD,EAAQ,eACT,OACEF,EAAMK,EACNC,EAAO,GAAgB,QAAQ,IAAI,KAAKC,GAAK,EAC/CL,EAAQ,iBAAmB,IAAA,IAAa,CAACC,GAC3CG,EACE,qCAAqC,OAAOJ,EAAQ,cAAc,EAAE,0BACtE,EAGF,QAAQ,IAAI,4CAA4CM,EAAK,GAAG,EAIhE,QAAQ,IAAI,iCAAiC,EAC7C,IAAMC,EAAW,MAAMnB,EAAuB,EAGxCoB,EAAS,MAAMlB,EAAY,CAC/B,KAAM,GAAGgB,EAAK,SACd,UAAWG,EAAKX,EAAK,QAAQ,EAC7B,iBACA,SAAU,UACV,YACA,UACA,WAIA,YAAa,CAAC,kBAAkB,EAEhC,sBAAuB,GAEvB,eAAgB,GAEhB,QAAS,GACT,YAAa,GAMb,aAAc,cACd,UACF,CAAC,EAGD,GAAIY,IAAa,OAAQ,CAIvB,QAAQ,IAAI,oCAAoCC,EAAa,OAAO,EACpE,GAAM,CAACC,EAAM,GAAGC,GAAQnB,EAAkBQ,EAAgB,MAAOS,CAAY,EAC7EzB,EAAW0B,EAAOC,EAAM,CAAE,IAAKf,CAAI,CAAC,CACtC,MAGE,MAAMpB,EAAc+B,EAAKX,EAAK,kBAAkB,EAAGgB,EAAeR,EAAMC,CAAQ,CAAC,EAInF,IAAMQ,EAAS1B,EAAmBa,CAAc,EAChD,MAAMxB,EACJ+B,EAAKX,EAAK,cAAc,EACxBkB,EAAgBV,EAAMJ,EAAgBK,EAAS,uBAAwBQ,CAAM,CAC/E,EACA,IAAME,EAAa9B,EAAOe,EAAgBa,CAAM,EAC5CE,GAAY,MAAMvC,EAAc+B,EAAKX,EAAK,aAAa,EAAGmB,CAAU,EAGpEf,IAAmB,QACrB,MAAMxB,EAAc+B,EAAKX,EAAK,qBAAqB,EAAG;;;CAAkC,EAG1FjB,EAAsBqB,EAAgBJ,EAAKU,EAAO,MAAM,EAGxD,IAAMU,EAAS,CAAC,iBAAkB,GAAIR,IAAa,OAAS,CAAC,EAAI,CAAC,UAAU,CAAE,EACxES,EAAQlC,EAASD,EAAakC,CAAM,CAAC,CAAC,MAAO,CAAE,OAAM,gBAAe,CAAC,EAC3E,IAAK,GAAM,CAACE,EAAMC,KAAaF,EAC7B,MAAMzC,EAAc+B,EAAKX,EAAKsB,CAAI,EAAGC,CAAQ,EAE/C,MAAM3C,EAAc+B,EAAKX,EAAK,WAAW,EAAGwB,EAAWhB,EAAMJ,EAAgBQ,CAAQ,CAAC,EACtF,MAAMhC,EACJ+B,EAAKX,EAAK,YAAY,EACtBhB,EAAmB,YAAaoB,EAAgBI,EAAMS,CAAM,CAC9D,EACA,MAAMrC,EAAc+B,EAAKX,EAAK,eAAe,EAAGf,EAAqB,CAAC,EAItE,GAAM,CAAE,qBAAsB,MAAM,OAAO,4BAAe,CAAA,KAAA,GAAAwC,EAAA,CAAA,EAW1D,GAVA,MAAMC,EAAkB,CACtB,OAAQ1B,EACR,OACA,GAAII,EACJ,SAAU,YACV,KAAM,MACN,MAAO,EACT,CAAC,EAGGF,EAAQ,YAAa,CACvB,QAAQ,IAAI,8CAA8CE,EAAe,MAAM,EAC/E,GAAI,CAGFhB,EAAWgB,EAAgB,CAAC,SAAS,EAAG,CAAE,IAAKJ,CAAI,CAAC,CACtD,MAAQ,CACN,QAAQ,IAAI,gBAAgBI,EAAe,kCAAkC,CAC/E,CACF,CAGA,GAAI,CACF,GAAM,CAAE,cAAe,MAAM,OAAO,yBAAa,CAAA,KAAA,GAAAqB,EAAA,CAAA,EACjD,MAAME,EAAW,CAAE,IAAKhB,EAAKX,EAAK,QAAQ,EAAG,gBAAiB,GAAM,OAAQ,EAAK,CAAC,CACpF,MAAQ,CAER,CAGA,GAAIE,EAAQ,QACV,GAAI,CACF0B,EAAa,MAAO,CAAC,MAAM,EAAG,CAAE,IAAK5B,EAAK,MAAO,MAAO,CAAC,EACzD4B,EAAa,MAAO,CAAC,SAAU,KAAM,MAAM,EAAG,CAAE,IAAK5B,EAAK,MAAO,MAAO,CAAC,EACzE4B,EAAa,MAAO,CAAC,MAAO,IAAI,EAAG,CAAE,IAAK5B,EAAK,MAAO,MAAO,CAAC,EAC9D4B,EAAa,MAAO,CAAC,SAAU,KAAM,iDAAiD,EAAG,CACvF,IAAK5B,EACL,MAAO,MACT,CAAC,EACDM,EAAI,4BAA4B,CAClC,MAAQ,CACNA,EAAI,qDAAqD,CAC3D,CAGF,QAAQ,IAAI;kCAAqC,EACjD,QAAQ,IAAI,EACZA,EAAI,aAAa,EACjBA,EAAI,QAAQE,GAAM,EACbN,EAAQ,aAAaI,EAAI,KAAKF,EAAe,SAAS,EACvDA,IAAmB,OACrBE,EAAI,sEAAsE,GAE1EA,EAAI,KAAKF,EAAe,+BAA+B,EACvDE,EAAI,KAAKF,EAAe,+BAA+B,GAEzDE,EAAI,EAAE,EACFM,IAAa,QAGfN,EAAI,kEAAkE,EACtEA,EAAI,KAAKb,GAAqB,IAE9Ba,EAAI,4DAA4D,EAChEA,EACE,wCAAwCxB,EAAQsB,EAAgB,MAAM,EAAE,2BAC1E,EACAE,EAAI,iCAAiC,GAEvCA,EAAI,EAAE,CACR,CAIA,SAASU,EAAe,EAAc,EAA0C,CAE9E,IAAMa,EAAO,GAAgBpB,EAASqB,IAAQ,SAC9C,MAAO,GAAG,KAAK,UACb,CACE,KAAM,GAAGtB,EAAK,MACd,QAAS,GACT,QAAS,QACT,KAAM,SACN,QAAS,CACP,IAAK,OACL,MAAO,6BACP,QAAS,eACT,UAAW,cACb,EACA,aAAc,CACZ,yBAA0BqB,EAAI,wBAAwB,EACtD,MAAOA,EAAI,OAAO,EAClB,YAAaA,EAAI,WAAW,CAC9B,EACA,gBAAiB,CACf,eAAgBA,EAAI,cAAc,EAClC,mBAAoBA,EAAI,kBAAkB,EAC1C,uBAAwBA,EAAI,sBAAsB,EAElD,WAAYA,EAAI,YAAY,EAC5B,KAAMA,EAAI,MAAM,CAClB,CACF,EACA,KACA,CACF,EAAE,GACJ,CAIA,SAAgBX,EACd,EACA,EACA,EACA,EAAS3B,EAAmBQ,CAAE,EACtB,CACR,IAAMgC,EACJhC,IAAO,OACH,CACE,IAAK,6BAEL,MAAO,mCACP,aAAc,6BACd,UAAW,0BAIX,MAAO,gEACP,gBAAiB,+DACjB,eAAgB,8DAUhB,UAAW,0DACX,KAAM,8BAEN,OAAQ,0BACV,EACA,CAIE,MAAO,gBAAgBA,EAAG,YAC1B,aAAc,gBAAgBA,EAAG,UACjC,UAAW,aAAaA,EAAG,UAI3B,MAAO,yCAAyCA,EAAG,uBAAuBA,EAAG,gBAC7E,gBAAiB,GAAGA,EAAG,+CACvB,eAAgB,GAAGA,EAAG,8CACtB,eAAgB,gBAAgBA,EAAG,YACnC,YAAa,aAAaA,EAAG,YAU7B,UAAW,0DACX,KAAM,gBAAgBA,EAAG,WAEzB,OAAQ,0BACV,EACN,MAAO,GAAG,KAAK,UACb,CACE,OACA,QAAS,GACT,QAAS,QACT,KAAM,SACN,GAAIkB,EAAS,CAAE,eAAgBA,CAAO,EAAI,CAAC,EAC3C,UAIA,gBAAiB,CAAE,sBAAuBe,CAAW,EACrD,WAAY,CAAC,SAAU,KAAK,CAC9B,EACA,KACA,CACF,EAAE,GACJ,CAEA,SAAgBR,EAAW,EAAc,EAAY,EAA4B,OAAgB,CAC/F,IAAMS,EAAS,KAAKzB,EAAK;;;;;;;;;;;;EAYzBT,EAAG;EACHA,IAAO,OAAS,oEAAsE,GAAGA,EAAG,kCAAkCA,EAAG,gCAAgC;;;;;oBAK/IlB,EAAUkB,EAAsB,MAAM,EAAE,6BAA6BlB,EAAUkB,EAAsB,WAAW,EAAE;IAClIlB,EAAUkB,EAAsB,QAAQ,EAAE,WAAWlB,EAAUkB,EAAsB,OAAO,EAAE;qCAC7DjB,EAAQiB,EAAsB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DzE,GAAIa,IAAa,OAAQ,OAAOqB,EAKhC,IAAMC,EAAWD,EAAO,QAAQ,kBAAkB,EAClD,MAAO,GAAGA,EACP,MAAM,EAAGC,CAAQ,CAAC,CAClB,QACC,mEACA,mEACF,CAAC,CACA,QAAQ,yBAA0B,EAAE,EAAE;;;;;EAKzCzC,EAAoB;CAEtB"}
+{"version":3,"file":"fullstack-XhuwRQEb.mjs","names":["writeFileSafe","execBin","runScript","approveInstallScripts","generateDockerfile","generateDockerignore","renderLayers","fillVars","runCommand","yarnrc","resolveSiblingVersions","packageManagerSpec","initProject","FRONTEND_WIRING_URL","VITE_TEMPLATES","DEFAULT_VITE_TEMPLATE","createViteCommand","flags","template","pm","dir","initFullstackProject","options","pmValid","packageManager","directory","log","msg","name","versions","server","join","frontend","viteTemplate","file","args","webPackageJson","pmSpec","rootPackageJson","yarnConfig","layers","files","path","contents","rootReadme","n","generateAgentDocs","runTypegen","execFileSync","dep","pkg","scripts","cliVersion","readme","typeLoop"],"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 KickClientApi.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, then by the root `build` script and `kick dev` startup — not on save) 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 { execBin, runScript, type PackageManager } from '../config'\nimport { packageManagerSpec, yarnrc } from './templates/project-config'\nimport { generateDockerfile, generateDockerignore } from './templates/docker'\nimport { runCommand } from '../utils/shell'\nimport { initProject, resolveSiblingVersions } from './project'\nimport { approveInstallScripts } from '../commands/add'\nimport { fillVars, renderLayers } from '../scaffold/overlay'\n\n/** Wiring a frontend we did not scaffold: typed client, proxy, route types. */\nexport const FRONTEND_WIRING_URL = 'https://kickjs.app/guide/fullstack-frontend.html'\n\n/**\n * create-vite's TypeScript templates, in the order it lists them. Only the\n * `-ts` half: the wiring is typed — the route map is a `.d.ts` and the client\n * is `createClient<KickClientApi.Api>` — so a JavaScript template would leave\n * the reader following a guide that cannot apply.\n */\nexport const VITE_TEMPLATES = [\n  { value: 'react-ts', label: 'React' },\n  { value: 'react-compiler-ts', label: 'React + Compiler' },\n  { value: 'vue-ts', label: 'Vue' },\n  { value: 'svelte-ts', label: 'Svelte' },\n  { value: 'solid-ts', label: 'Solid' },\n  { value: 'preact-ts', label: 'Preact' },\n  { value: 'lit-ts', label: 'Lit' },\n  { value: 'qwik-ts', label: 'Qwik' },\n  { value: 'vanilla-ts', label: 'Vanilla' },\n] as const\n\nexport const DEFAULT_VITE_TEMPLATE = 'react-ts'\n\n/**\n * How each package manager runs create-vite, with the framework decided here\n * rather than by its prompts:\n *\n * - `--template` picks a TypeScript template, so the wiring guide applies;\n * - `--no-interactive` means it never waits for input (CI, `--yes`);\n * - `--no-immediate` stops it installing and launching a dev server — the\n *   workspace install happens once, at the root, after this returns.\n */\nexport function createViteCommand(\n  pm: 'pnpm' | 'npm' | 'yarn' | 'bun',\n  dir: string,\n  template: string = DEFAULT_VITE_TEMPLATE,\n): string[] {\n  const flags = ['--template', template, '--no-interactive', '--no-immediate']\n  // yarn and bun resolve `create vite` to create-vite themselves; npm and pnpm\n  // take the versioned package name, and npm needs `--` before the flags or it\n  // eats them itself.\n  if (pm === 'yarn' || pm === 'bun') return [pm, 'create', 'vite', dir, ...flags]\n  if (pm === 'npm') return [pm, 'create', 'vite@latest', dir, '--', ...flags]\n  return [pm, 'create', 'vite@latest', dir, ...flags]\n}\n\nexport interface InitFullstackOptions {\n  name: string\n  directory: string\n  packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n  /**\n   * Who scaffolds `web/`. `'kick'` writes the wired React app (typed client,\n   * dev proxy, route-map types). `'vite'` hands the directory to\n   * `create-vite` and wires nothing — you pick the framework, and the guide\n   * at {@link FRONTEND_WIRING_URL} covers connecting it.\n   */\n  frontend?: 'kick' | 'vite'\n  /** create-vite template for `frontend: 'vite'`. Default `react-ts`. */\n  viteTemplate?: string\n  initGit?: boolean\n  installDeps?: boolean\n  schemaLib?: 'zod' | 'valibot' | 'yup'\n  runtime?: 'express' | 'fastify' | 'h3'\n  /** Optional packages (`--packages`), wired into the server like a plain scaffold. */\n  packages?: string[]\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n  const {\n    name,\n    directory,\n    schemaLib = 'zod',\n    runtime = 'express',\n    packages = [],\n    frontend = 'kick',\n    viteTemplate = DEFAULT_VITE_TEMPLATE,\n  } = 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  // One map for both packages: the workspace shares a toolchain, so server/\n  // and web/ must not end up on different vite or TypeScript majors.\n  console.log('  Resolving package versions...')\n  const versions = await resolveSiblingVersions()\n\n  // ── server/ — the standard scaffold, deferred install/git ──────────\n  const server = await initProject({\n    name: `${name}-server`,\n    directory: join(dir, 'server'),\n    packageManager,\n    template: 'minimal',\n    schemaLib,\n    runtime,\n    packages,\n    // The client route map web/ reads (with the compiler API it needs), and a\n    // strict port — web/vite.config.ts proxies /api to it, so moving to\n    // another port would silently reach the wrong process.\n    extraLayers: ['server-fullstack'],\n    // server/ is a workspace member; the root records the approvals.\n    approveInstallScripts: false,\n    // netlify.toml / vercel.json live at the workspace root, written below.\n    platformConfig: false,\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    versions,\n  })\n\n  // ── web/ — either our wired React app, or whatever create-vite makes ──\n  if (frontend === 'vite') {\n    // create-vite scaffolds it with the chosen TypeScript template. Nothing\n    // is patched afterwards: a scaffold we didn't write is not ours to\n    // rewrite, and the wiring is four steps in the guide.\n    console.log(`\\n  Handing web/ to create-vite (${viteTemplate})...\\n`)\n    const [file, ...args] = createViteCommand(packageManager, 'web', viteTemplate)\n    runCommand(file!, args, { cwd: dir })\n  } else {\n    // The wired React app (typed client, dev proxy, route-map types): its\n    // package.json here, its files from the web-kick layer below.\n    await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, versions))\n  }\n\n  // ── workspace root ──────────────────────────────────────────────────\n  const pmSpec = packageManagerSpec(packageManager)\n  await writeFileSafe(\n    join(dir, 'package.json'),\n    rootPackageJson(name, packageManager, versions['@forinda/kickjs-cli'], pmSpec),\n  )\n  const yarnConfig = yarnrc(packageManager, pmSpec)\n  if (yarnConfig) await writeFileSafe(join(dir, '.yarnrc.yml'), yarnConfig)\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    await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), 'packages:\\n  - server\\n  - web\\n')\n  }\n  // Before install, at the root every package manager reads them from.\n  approveInstallScripts(packageManager, dir, server.builds)\n  // .gitignore, and netlify.toml / vercel.json at the root both platforms\n  // build from; plus the kick web app's files under web/.\n  const layers = ['fullstack-root', ...(frontend === 'vite' ? [] : ['web-kick'])]\n  const files = fillVars(renderLayers(layers).files, { name, packageManager })\n  for (const [path, contents] of files) {\n    await writeFileSafe(join(dir, path), contents)\n  }\n  await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager, frontend))\n  await writeFileSafe(\n    join(dir, 'Dockerfile'),\n    generateDockerfile('fullstack', packageManager, name, pmSpec),\n  )\n  await writeFileSafe(join(dir, '.dockerignore'), generateDockerignore())\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 KickClientApi.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 typegen` in server/ (or the root `build`) writes it later.\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  if (frontend === 'vite') {\n    // Nothing in web/ knows about the API yet — say so, and say where the\n    // four wiring steps live rather than half-wiring someone else's scaffold.\n    log('web/ is create-vite output, unwired. To type it against the API:')\n    log(`  ${FRONTEND_WIRING_URL}`)\n  } else {\n    log('The web app calls the API through @forinda/kickjs-client —')\n    log(\n      `edit server/src/modules/hello, run \\`${execBin(packageManager, 'kick')} typegen\\` in server/, and`,\n    )\n    log(\"web/src/App.tsx's types follow.\")\n  }\n  log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, versions: Record<string, string>): string {\n  // Every range here is resolved at scaffold time — see THIRD_PARTY_PACKAGES.\n  const dep = (pkg: string) => versions[pkg] ?? 'latest'\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': dep('@forinda/kickjs-client'),\n        react: dep('react'),\n        'react-dom': dep('react-dom'),\n      },\n      devDependencies: {\n        '@types/react': dep('@types/react'),\n        '@types/react-dom': dep('@types/react-dom'),\n        '@vitejs/plugin-react': dep('@vitejs/plugin-react'),\n        // Same majors as the server package: one workspace, one toolchain.\n        typescript: dep('typescript'),\n        vite: dep('vite'),\n      },\n    },\n    null,\n    2,\n  )}\\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nexport function rootPackageJson(\n  name: string,\n  pm: string,\n  cliVersion: string,\n  pmSpec = packageManagerSpec(pm),\n): 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          // Typegen first: web's `tsc` reads server/.kickjs/types, which is\n          // git-ignored, so a fresh clone (CI, Netlify, Vercel) has none and\n          // `pnpm -r run build` races the two packages anyway.\n          build: 'pnpm --filter ./server exec kick typegen && pnpm -r run build',\n          'build:netlify': 'pnpm build && pnpm --filter ./server exec kick build:netlify',\n          'build:vercel': 'pnpm build && pnpm --filter ./server exec kick build:vercel',\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          //\n          // `--no-typegen` for web: it has no kick project to generate types\n          // for (it reads the server's), and typegen there left a stray\n          // web/.kickjs behind.\n          typecheck: 'kick typecheck --cwd server && kick typecheck --cwd web --no-typegen',\n          test: 'pnpm --filter ./server test',\n          // The server's own `format` command (kick.config.ts).\n          format: 'cd server && kick format',\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          // Typegen first — see the pnpm branch above. A bare `kick`, not\n          // `<pm> exec kick` (`bun exec` runs a shell string): the root depends\n          // on the CLI, so scripts have it on PATH — see `typecheck` below.\n          build: `cd server && kick typegen && cd .. && ${pm} run build:server && ${pm} run build:web`,\n          'build:netlify': `${pm} run build && cd server && kick build:netlify`,\n          'build:vercel': `${pm} run build && cd server && kick build:vercel`,\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 --no-typegen',\n          test: `cd server && ${pm} run test`,\n          // The server's own `format` command (kick.config.ts).\n          format: 'cd server && kick format',\n        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      ...(pmSpec ? { packageManager: pmSpec } : {}),\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\nexport function rootReadme(name: string, pm: string, frontend: 'kick' | 'vite' = 'kick'): string {\n  const readme = `# ${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\nFrom this root: \\`${runScript(pm as PackageManager, 'test')}\\` (the server's tests), \\`${runScript(pm as PackageManager, 'typecheck')}\\` (both packages),\n\\`${runScript(pm as PackageManager, 'format')}\\` and \\`${runScript(pm as PackageManager, 'build')}\\`. The \\`kick\\` CLI itself runs in \\`server/\\`, which holds\n\\`kick.config.ts\\`: \\`cd server && ${execBin(pm as PackageManager, 'kick')} typegen\\`.\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**\\`kick dev\\` writes it at startup, not on save.** 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  if (frontend !== 'vite') return readme\n\n  // create-vite's output is not ours to describe: it has no typed client, no\n  // proxy and no route-map types until the reader wires them. Everything from\n  // \"The type loop\" on is about files that do not exist in that scaffold.\n  const typeLoop = readme.indexOf('## The type loop')\n  return `${readme\n    .slice(0, typeLoop)\n    .replace(\n      'Vite + React, typed against the API via `@forinda/kickjs-client`',\n      'create-vite scaffold — unwired (see below)                       ',\n    )\n    .replace(' (Vite proxies `/api`)', '')}## Wiring web/ to the API\n\n\\`web/\\` is whatever create-vite scaffolded; nothing connects it to the API yet.\nFour steps — typed client, \\`/api\\` dev proxy, route-map types, \\`src/api.ts\\`:\n\n${FRONTEND_WIRING_URL}\n`\n}\n"],"mappings":";;;;;;;;;;iSA0BA,MAAaa,EAAsB,mDAQtBC,EAAiB,CAC5B,CAAE,MAAO,WAAY,MAAO,OAAQ,EACpC,CAAE,MAAO,oBAAqB,MAAO,kBAAmB,EACxD,CAAE,MAAO,SAAU,MAAO,KAAM,EAChC,CAAE,MAAO,YAAa,MAAO,QAAS,EACtC,CAAE,MAAO,WAAY,MAAO,OAAQ,EACpC,CAAE,MAAO,YAAa,MAAO,QAAS,EACtC,CAAE,MAAO,SAAU,MAAO,KAAM,EAChC,CAAE,MAAO,UAAW,MAAO,MAAO,EAClC,CAAE,MAAO,aAAc,MAAO,SAAU,CAC1C,EAEaC,EAAwB,WAWrC,SAAgBC,EACd,EACA,EACA,EAAmBD,EACT,CACV,IAAME,EAAQ,CAAC,aAAcC,EAAU,mBAAoB,gBAAgB,EAM3E,OAFIC,IAAO,QAAUA,IAAO,MAAc,CAACA,EAAI,SAAU,OAAQC,EAAK,GAAGH,CAAK,EAC1EE,IAAO,MAAc,CAACA,EAAI,SAAU,cAAeC,EAAK,KAAM,GAAGH,CAAK,EACnE,CAACE,EAAI,SAAU,cAAeC,EAAK,GAAGH,CAAK,CACpD,CAuBA,eAAsBI,EAAqB,EAA8C,CACvF,GAAM,CACJ,OACA,YACA,YAAY,MACZ,UAAU,UACV,WAAW,CAAC,EACZ,WAAW,OACX,eAAeN,GACbO,EAIEC,EAAW,CAAC,OAAQ,MAAO,OAAQ,KAAK,CAAC,CAAW,SACxDD,EAAQ,cACV,EACME,EAAiBD,EAClBD,EAAQ,eACT,OACEF,EAAMK,EACNC,EAAO,GAAgB,QAAQ,IAAI,KAAKC,GAAK,EAC/CL,EAAQ,iBAAmB,IAAA,IAAa,CAACC,GAC3CG,EACE,qCAAqC,OAAOJ,EAAQ,cAAc,EAAE,0BACtE,EAGF,QAAQ,IAAI,4CAA4CM,EAAK,GAAG,EAIhE,QAAQ,IAAI,iCAAiC,EAC7C,IAAMC,EAAW,MAAMnB,EAAuB,EAGxCoB,EAAS,MAAMlB,EAAY,CAC/B,KAAM,GAAGgB,EAAK,SACd,UAAWG,EAAKX,EAAK,QAAQ,EAC7B,iBACA,SAAU,UACV,YACA,UACA,WAIA,YAAa,CAAC,kBAAkB,EAEhC,sBAAuB,GAEvB,eAAgB,GAEhB,QAAS,GACT,YAAa,GAMb,aAAc,cACd,UACF,CAAC,EAGD,GAAIY,IAAa,OAAQ,CAIvB,QAAQ,IAAI,oCAAoCC,EAAa,OAAO,EACpE,GAAM,CAACC,EAAM,GAAGC,GAAQnB,EAAkBQ,EAAgB,MAAOS,CAAY,EAC7EzB,EAAW0B,EAAOC,EAAM,CAAE,IAAKf,CAAI,CAAC,CACtC,MAGE,MAAMpB,EAAc+B,EAAKX,EAAK,kBAAkB,EAAGgB,EAAeR,EAAMC,CAAQ,CAAC,EAInF,IAAMQ,EAAS1B,EAAmBa,CAAc,EAChD,MAAMxB,EACJ+B,EAAKX,EAAK,cAAc,EACxBkB,EAAgBV,EAAMJ,EAAgBK,EAAS,uBAAwBQ,CAAM,CAC/E,EACA,IAAME,EAAa9B,EAAOe,EAAgBa,CAAM,EAC5CE,GAAY,MAAMvC,EAAc+B,EAAKX,EAAK,aAAa,EAAGmB,CAAU,EAGpEf,IAAmB,QACrB,MAAMxB,EAAc+B,EAAKX,EAAK,qBAAqB,EAAG;;;CAAkC,EAG1FjB,EAAsBqB,EAAgBJ,EAAKU,EAAO,MAAM,EAGxD,IAAMU,EAAS,CAAC,iBAAkB,GAAIR,IAAa,OAAS,CAAC,EAAI,CAAC,UAAU,CAAE,EACxES,EAAQlC,EAASD,EAAakC,CAAM,CAAC,CAAC,MAAO,CAAE,OAAM,gBAAe,CAAC,EAC3E,IAAK,GAAM,CAACE,EAAMC,KAAaF,EAC7B,MAAMzC,EAAc+B,EAAKX,EAAKsB,CAAI,EAAGC,CAAQ,EAE/C,MAAM3C,EAAc+B,EAAKX,EAAK,WAAW,EAAGwB,EAAWhB,EAAMJ,EAAgBQ,CAAQ,CAAC,EACtF,MAAMhC,EACJ+B,EAAKX,EAAK,YAAY,EACtBhB,EAAmB,YAAaoB,EAAgBI,EAAMS,CAAM,CAC9D,EACA,MAAMrC,EAAc+B,EAAKX,EAAK,eAAe,EAAGf,EAAqB,CAAC,EAItE,GAAM,CAAE,qBAAsB,MAAM,OAAO,4BAAe,CAAA,KAAA,GAAAwC,EAAA,CAAA,EAW1D,GAVA,MAAMC,EAAkB,CACtB,OAAQ1B,EACR,OACA,GAAII,EACJ,SAAU,YACV,KAAM,MACN,MAAO,EACT,CAAC,EAGGF,EAAQ,YAAa,CACvB,QAAQ,IAAI,8CAA8CE,EAAe,MAAM,EAC/E,GAAI,CAGFhB,EAAWgB,EAAgB,CAAC,SAAS,EAAG,CAAE,IAAKJ,CAAI,CAAC,CACtD,MAAQ,CACN,QAAQ,IAAI,gBAAgBI,EAAe,kCAAkC,CAC/E,CACF,CAGA,GAAI,CACF,GAAM,CAAE,cAAe,MAAM,OAAO,yBAAa,CAAA,KAAA,GAAAqB,EAAA,CAAA,EACjD,MAAME,EAAW,CAAE,IAAKhB,EAAKX,EAAK,QAAQ,EAAG,gBAAiB,GAAM,OAAQ,EAAK,CAAC,CACpF,MAAQ,CAER,CAGA,GAAIE,EAAQ,QACV,GAAI,CACF0B,EAAa,MAAO,CAAC,MAAM,EAAG,CAAE,IAAK5B,EAAK,MAAO,MAAO,CAAC,EACzD4B,EAAa,MAAO,CAAC,SAAU,KAAM,MAAM,EAAG,CAAE,IAAK5B,EAAK,MAAO,MAAO,CAAC,EACzE4B,EAAa,MAAO,CAAC,MAAO,IAAI,EAAG,CAAE,IAAK5B,EAAK,MAAO,MAAO,CAAC,EAC9D4B,EAAa,MAAO,CAAC,SAAU,KAAM,iDAAiD,EAAG,CACvF,IAAK5B,EACL,MAAO,MACT,CAAC,EACDM,EAAI,4BAA4B,CAClC,MAAQ,CACNA,EAAI,qDAAqD,CAC3D,CAGF,QAAQ,IAAI;kCAAqC,EACjD,QAAQ,IAAI,EACZA,EAAI,aAAa,EACjBA,EAAI,QAAQE,GAAM,EACbN,EAAQ,aAAaI,EAAI,KAAKF,EAAe,SAAS,EACvDA,IAAmB,OACrBE,EAAI,sEAAsE,GAE1EA,EAAI,KAAKF,EAAe,+BAA+B,EACvDE,EAAI,KAAKF,EAAe,+BAA+B,GAEzDE,EAAI,EAAE,EACFM,IAAa,QAGfN,EAAI,kEAAkE,EACtEA,EAAI,KAAKb,GAAqB,IAE9Ba,EAAI,4DAA4D,EAChEA,EACE,wCAAwCzB,EAAQuB,EAAgB,MAAM,EAAE,2BAC1E,EACAE,EAAI,iCAAiC,GAEvCA,EAAI,EAAE,CACR,CAIA,SAASU,EAAe,EAAc,EAA0C,CAE9E,IAAMa,EAAO,GAAgBpB,EAASqB,IAAQ,SAC9C,MAAO,GAAG,KAAK,UACb,CACE,KAAM,GAAGtB,EAAK,MACd,QAAS,GACT,QAAS,QACT,KAAM,SACN,QAAS,CACP,IAAK,OACL,MAAO,6BACP,QAAS,eACT,UAAW,cACb,EACA,aAAc,CACZ,yBAA0BqB,EAAI,wBAAwB,EACtD,MAAOA,EAAI,OAAO,EAClB,YAAaA,EAAI,WAAW,CAC9B,EACA,gBAAiB,CACf,eAAgBA,EAAI,cAAc,EAClC,mBAAoBA,EAAI,kBAAkB,EAC1C,uBAAwBA,EAAI,sBAAsB,EAElD,WAAYA,EAAI,YAAY,EAC5B,KAAMA,EAAI,MAAM,CAClB,CACF,EACA,KACA,CACF,EAAE,GACJ,CAIA,SAAgBX,EACd,EACA,EACA,EACA,EAAS3B,EAAmBQ,CAAE,EACtB,CACR,IAAMgC,EACJhC,IAAO,OACH,CACE,IAAK,6BAEL,MAAO,mCACP,aAAc,6BACd,UAAW,0BAIX,MAAO,gEACP,gBAAiB,+DACjB,eAAgB,8DAchB,UAAW,uEACX,KAAM,8BAEN,OAAQ,0BACV,EACA,CAIE,MAAO,gBAAgBA,EAAG,YAC1B,aAAc,gBAAgBA,EAAG,UACjC,UAAW,aAAaA,EAAG,UAI3B,MAAO,yCAAyCA,EAAG,uBAAuBA,EAAG,gBAC7E,gBAAiB,GAAGA,EAAG,+CACvB,eAAgB,GAAGA,EAAG,8CACtB,eAAgB,gBAAgBA,EAAG,YACnC,YAAa,aAAaA,EAAG,YAU7B,UAAW,uEACX,KAAM,gBAAgBA,EAAG,WAEzB,OAAQ,0BACV,EACN,MAAO,GAAG,KAAK,UACb,CACE,OACA,QAAS,GACT,QAAS,QACT,KAAM,SACN,GAAIkB,EAAS,CAAE,eAAgBA,CAAO,EAAI,CAAC,EAC3C,UAIA,gBAAiB,CAAE,sBAAuBe,CAAW,EACrD,WAAY,CAAC,SAAU,KAAK,CAC9B,EACA,KACA,CACF,EAAE,GACJ,CAEA,SAAgBR,EAAW,EAAc,EAAY,EAA4B,OAAgB,CAC/F,IAAMS,EAAS,KAAKzB,EAAK;;;;;;;;;;;;EAYzBT,EAAG;EACHA,IAAO,OAAS,oEAAsE,GAAGA,EAAG,kCAAkCA,EAAG,gCAAgC;;;;;oBAK/IjB,EAAUiB,EAAsB,MAAM,EAAE,6BAA6BjB,EAAUiB,EAAsB,WAAW,EAAE;IAClIjB,EAAUiB,EAAsB,QAAQ,EAAE,WAAWjB,EAAUiB,EAAsB,OAAO,EAAE;qCAC7DlB,EAAQkB,EAAsB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DzE,GAAIa,IAAa,OAAQ,OAAOqB,EAKhC,IAAMC,EAAWD,EAAO,QAAQ,kBAAkB,EAClD,MAAO,GAAGA,EACP,MAAM,EAAGC,CAAQ,CAAC,CAClB,QACC,mEACA,mEACF,CAAC,CACA,QAAQ,yBAA0B,EAAE,EAAE;;;;;EAKzCzC,EAAoB;CAEtB"}

package/dist/index.d.mts

@@ -141,8 +141,11 @@ interface KickCommandDefinition {
   /** Optional aliases (e.g. ['migrate'] for 'db:migrate') */
   aliases?: string[];
 }
-/** Project pattern — controls what generators produce and which deps are installed */
-type ProjectPattern = 'rest' | 'minimal';
+/**
+ * Project pattern — controls what generators produce and which deps are installed.
+ * `kick new` writes the template name here; an `inertia` app generates `rest` modules.
+ */
+type ProjectPattern = 'rest' | 'minimal' | 'inertia';
 /** Package manager used for `kick add` and other dep-installing commands */
 type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
 /**
@@ -399,11 +402,19 @@ interface ModuleConfig {
   /** Schema output directory (e.g. 'src/db/schema') */
   schemaDir?: string;
   /**
-   * Whether to pluralize module names in generated code.
-   * When true (default), `kick g module user` creates `src/modules/users/`.
-   * When false, it creates `src/modules/user/` and uses singular names throughout.
+   * Whether to pluralize module folder and file names.
+   * When false (default), `kick g module user` creates `src/modules/user/` and
+   * uses the name as typed throughout. When true, it creates `src/modules/users/`.
+   * The route path is controlled separately by {@link ModuleConfig.pluralizeRoutes}.
    */
   pluralize?: boolean;
+  /**
+   * Whether the generated route path is the plural of the name. Default `true`:
+   * `kick g module task` mounts at `/tasks`, `user-profile` at `/user-profiles`;
+   * uncountables stay (`auth` → `/auth`). Set `false` to mount at the name as
+   * typed (`/task`). `--pluralize-routes` / `--no-pluralize-routes` override it.
+   */
+  pluralizeRoutes?: boolean;
   /**
    * Module declaration style emitted by `kick g module` and the
    * project scaffold.
@@ -480,6 +491,7 @@ interface KickConfig {
    * `--pattern` overrides it per call.
    * - 'rest' — flat module: controller, service, DTOs, repository (default)
    * - 'minimal' — controller + module only
+   * - 'inertia' — written by `kick new -t inertia`; modules generate as 'rest'
    */
   pattern?: ProjectPattern;
   /**
@@ -743,8 +755,10 @@ interface GenerateModuleOptions {
   force?: boolean;
   pattern?: ProjectPattern;
   dryRun?: boolean;
-  /** When false, skip pluralization — use singular names for folders, routes, and classes */
+  /** When true, pluralize the folder, file and class names (`users/`). Default false. */
   pluralize?: boolean;
+  /** When false, mount at the name as typed (`/user`) instead of its plural. Default true. */
+  pluralizeRoutes?: boolean;
   /**
    * DI-token scope prefix substituted into emitted `createToken<T>()`
    * literals. Resolved by the orchestrating command from
@@ -763,6 +777,8 @@ interface GenerateModuleOptions {
    * imports would not resolve and the generated file could not compile.
    */
   testHarness?: boolean;
+  /** Module generated tests import from — see `testImportSource`. */
+  testImport?: string;
   /**
    * Module declaration style — `'define'` (factory, default) or
    * `'class'` (legacy). Resolved by the orchestrating command from
@@ -1077,6 +1093,12 @@ interface SchemaRef {
    * statically determined (the generator falls back to `unknown`).
    */
   source: string | null;
+  /**
+   * Declared in the controller file but not exported: the generated
+   * types can't import it, so `source` is `null` and typegen says to
+   * export it.
+   */
+  unexported?: true;
 }
 /** A `createToken<T>('name')` call discovered in source */
 interface DiscoveredToken {
@@ -1479,7 +1501,7 @@ interface RunTypegenOptions {
 declare function runTypegen(opts?: RunTypegenOptions): Promise<{
   scan: ScanResult;
   result: GenerateResult;
-  /** Token convention warnings — empty when every literal matches §22.2. */
+  /** Token convention warnings — empty when every literal matches `<scope>/<area>/<key>`. */
   tokenWarnings: TokenConventionWarning[];
 }>;
 /**

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":["KitCliPluginContext","KitCliPlugin","BuiltinRepoType","_$__commands_doctor0.DoctorExtension","SchemaLib","SchemaLib","SchemaLib"],"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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"}
+{"version":3,"file":"index.d.mts","names":["KitCliPluginContext","KitCliPlugin","BuiltinRepoType","_$__commands_doctor0.DoctorExtension","SchemaLib","SchemaLib","SchemaLib"],"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 v8.10.2
+ * @forinda/kickjs-cli v8.12.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{C as e,F as t,N as n,P as r,_ as i,c as a,d as o,g as s,h as c,j 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-DGWvBOvj.mjs";import{r as v,s as y}from"./config-CsOfUFfq.mjs";import{t as b}from"./project-C98JovY4.mjs";import{t as x}from"./project-root-DlgCWwc_.mjs";import{n as S,t as C}from"./types-CtrnAiNl.mjs";export{C as KickPluginConflictError,a as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,v as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,o as defineTypegen,x as findProjectRoot,_ as generateAdapter,d as generateController,m as generateDto,s as generateGuard,i as generateMiddleware,e as generateModule,c as generateService,b as initProject,y as loadKickConfig,l as pluralize,n as toCamelCase,r as toKebabCase,t as toPascalCase};
+import{C as e,F as t,N as n,P as r,_ as i,c as a,d as o,g as s,h as c,j 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-rEbeoAoO.mjs";import{r as v,s as y}from"./config-DbnBakh8.mjs";import{t as b}from"./project-BN1DnrN3.mjs";import{t as x}from"./project-root-FMt83NHV.mjs";import{n as S,t as C}from"./types-B5dY2mTz.mjs";export{C as KickPluginConflictError,a as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,v as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,o as defineTypegen,x as findProjectRoot,_ as generateAdapter,d as generateController,m as generateDto,s as generateGuard,i as generateMiddleware,e as generateModule,c as generateService,b as initProject,y as loadKickConfig,l as pluralize,n as toCamelCase,r as toKebabCase,t as toPascalCase};

package/dist/package-manager-C8ekNwsa.mjs

@@ -0,0 +1,11 @@
+/**
+ * @forinda/kickjs-cli v8.12.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{o as e,t}from"./config-DMFwBdWg.mjs";import{createRequire as n}from"node:module";import{existsSync as r,readFileSync as i}from"node:fs";import{dirname as a,extname as o,join as s,resolve as c}from"node:path";import{access as l,mkdir as u,readFile as d,writeFile as f}from"node:fs/promises";let p=!1;function m(e){p=e}const h=/* @__PURE__ */ new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.json`,`.md`]);async function g(e,t){p||(await u(a(e),{recursive:!0}),await f(e,t,`utf-8`),h.has(o(e))&&await y(e,t).catch(()=>{}))}let _;async function v(e){if(_!==void 0)return _;try{_=await import(n(s(e,`package.json`)).resolve(`oxfmt`))}catch{_=await import(`oxfmt`).catch(()=>null)}return _}async function y(e,t){let n=await v(process.cwd());if(!n)return;let r=await x(e);if(r===null)return;let i=await n.format(e,t,r);i.code!==t&&await f(e,i.code,`utf-8`)}const b=/* @__PURE__ */ new Map;async function x(e){let t=a(e),n=t;if(b.has(n))return b.get(n);for(;;){let e=s(t,`.oxfmtrc.json`);if(r(e))try{let t=await d(e,`utf-8`),r=JSON.parse(t);return delete r.$schema,delete r.ignorePatterns,b.set(n,r),r}catch{return b.set(n,null),null}let i=a(t);if(i===t)return b.set(n,null),null;t=i}}async function S(e){try{return await l(e),!0}catch{return!1}}const C=[[`pnpm-lock.yaml`,`pnpm`],[`yarn.lock`,`yarn`],[`bun.lock`,`bun`],[`bun.lockb`,`bun`],[`package-lock.json`,`npm`]];function w(e){for(let t=e;;t=a(t)){let e=C.find(([e])=>r(c(t,e)));if(e)return e[1];if(a(t)===t)return null}}function T(e){let n=e;for(;n;){let e=c(n,`package.json`);if(r(e))try{let n=JSON.parse(i(e,`utf-8`)).packageManager;if(typeof n==`string`){let e=n.split(`@`)[0];if(t.includes(e))return e}}catch{}let o=a(n);if(o===n)return null;n=o}return null}async function E(n,r=process.cwd()){if(n&&t.includes(n))return{pm:n,source:`flag`};let i=await e(r);if(i?.packageManager&&t.includes(i.packageManager))return{pm:i.packageManager,source:`config`};let a=T(r);if(a)return{pm:a,source:`package.json`};let o=w(r);if(o)return{pm:o,source:`lockfile`};let s=process.env.npm_config_user_agent?.split(`/`)[0];return s&&t.includes(s)?{pm:s,source:`user-agent`}:{pm:`npm`,source:`default`}}async function D(e,t=process.cwd()){let{pm:n}=await E(e,t);return n}function O(e=process.cwd()){return T(e)??w(e)??`npm`}export{m as a,S as i,D as n,g as o,E as r,O as t};

package/dist/package-manager-DvXi-NGm.mjs

@@ -0,0 +1,12 @@
+/**
+ * @forinda/kickjs-cli v8.12.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{s as e,t}from"./config-DbnBakh8.mjs";import{createRequire as n}from"node:module";import{dirname as r,extname as i,join as a,resolve as o}from"node:path";import{existsSync as s,readFileSync as c}from"node:fs";import{access as l,mkdir as u,readFile as d,writeFile as f}from"node:fs/promises";let p=!1;function m(e){p=e}const h=/* @__PURE__ */ new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.json`,`.md`]);async function g(e,t){p||(await u(r(e),{recursive:!0}),await f(e,t,`utf-8`),h.has(i(e))&&await y(e,t).catch(()=>{}))}let _;async function v(e){if(_!==void 0)return _;try{_=await import(n(a(e,`package.json`)).resolve(`oxfmt`))}catch{_=await import(`oxfmt`).catch(()=>null)}return _}async function y(e,t){let n=await v(process.cwd());if(!n)return;let r=await x(e);if(r===null)return;let i=await n.format(e,t,r);i.code!==t&&await f(e,i.code,`utf-8`)}const b=/* @__PURE__ */ new Map;async function x(e){let t=r(e),n=t;if(b.has(n))return b.get(n);for(;;){let e=a(t,`.oxfmtrc.json`);if(s(e))try{let t=await d(e,`utf-8`),r=JSON.parse(t);return delete r.$schema,delete r.ignorePatterns,b.set(n,r),r}catch{return b.set(n,null),null}let i=r(t);if(i===t)return b.set(n,null),null;t=i}}async function S(e){try{return await l(e),!0}catch{return!1}}const C=[[`pnpm-lock.yaml`,`pnpm`],[`yarn.lock`,`yarn`],[`bun.lock`,`bun`],[`bun.lockb`,`bun`],[`package-lock.json`,`npm`]];function w(e){for(let t=e;;t=r(t)){let e=C.find(([e])=>s(o(t,e)));if(e)return e[1];if(r(t)===t)return null}}function T(e){let n=e;for(;n;){let e=o(n,`package.json`);if(s(e))try{let n=JSON.parse(c(e,`utf-8`)).packageManager;if(typeof n==`string`){let e=n.split(`@`)[0];if(t.includes(e))return e}}catch{}let i=r(n);if(i===n)return null;n=i}return null}async function E(n,r=process.cwd()){if(n&&t.includes(n))return{pm:n,source:`flag`};let i=await e(r);if(i?.packageManager&&t.includes(i.packageManager))return{pm:i.packageManager,source:`config`};let a=T(r);if(a)return{pm:a,source:`package.json`};let o=w(r);if(o)return{pm:o,source:`lockfile`};let s=process.env.npm_config_user_agent?.split(`/`)[0];return s&&t.includes(s)?{pm:s,source:`user-agent`}:{pm:`npm`,source:`default`}}async function D(e,t=process.cwd()){let{pm:n}=await E(e,t);return n}function O(e=process.cwd()){return T(e)??w(e)??`npm`}export{m as a,S as i,D as n,g as o,E as r,O as t};
+//# sourceMappingURL=package-manager-DvXi-NGm.mjs.map

package/dist/package-manager-DvXi-NGm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager-DvXi-NGm.mjs","names":["loadKickConfig","_dryRun","setDryRun","enabled","FORMATTABLE","writeFileSafe","mkdir","dirname","filePath","writeFile","content","extname","formatFile","_oxfmt","resolveOxfmt","createRequire","join","cwd","oxfmt","options","loadOxfmtConfig","result","_oxfmtConfigCache","dir","startDir","configPath","existsSync","raw","readFile","parsed","\"$schema\"","parent","fileExists","access","LOCKFILES","detectFromLockfile","fromDir","hit","file","resolve","packageManagerFromPackageJson","pkgPath","field","readFileSync","name","PACKAGE_MANAGERS","resolvePackageManagerWithSource","flagPm","config","fromPkg","fromLock","fromAgent","resolvePackageManager","pm","detectPackageManager"],"sources":["../src/utils/fs.ts","../src/utils/package-manager.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { writeFile, mkdir, access, readFile } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { dirname, extname, join } from 'node:path'\n\nlet _dryRun = false\nlet _format = true\n\n/** Enable/disable dry run mode globally for all writeFileSafe calls */\nexport function setDryRun(enabled: boolean): void {\n  _dryRun = enabled\n}\n\n/**\n * Toggle oxfmt post-write formatting. Defaults to enabled — generators\n * always emit formatted output unless the caller opts out (rare; useful\n * for tests that want byte-stable assertions against raw template strings).\n */\nexport function setFormatOnWrite(enabled: boolean): void {\n  _format = enabled\n}\n\n/** Extensions oxfmt can format. Anything else is written verbatim. */\nconst FORMATTABLE = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json', '.md'])\n\n/**\n * Write a file, creating parent directories if needed.\n *\n * After write, runs oxfmt against the file when:\n *   - format-on-write is enabled (default)\n *   - the extension is in {@link FORMATTABLE}\n *   - oxfmt resolves from the user's project (or our own cwd)\n *\n * Failures (missing oxfmt, unparseable source, formatter crash) are\n * swallowed silently — formatting is a polish step, not a correctness\n * gate. The pre-commit hook still catches anything we couldn't format.\n *\n * Skips writing entirely in dry run mode.\n */\nexport async function writeFileSafe(filePath: string, content: string): Promise<void> {\n  if (_dryRun) return\n  await mkdir(dirname(filePath), { recursive: true })\n  await writeFile(filePath, content, 'utf-8')\n  if (_format && FORMATTABLE.has(extname(filePath))) {\n    await formatFile(filePath, content).catch(() => {\n      // Formatter missing or unparseable source — leave the unformatted\n      // file in place. Pre-commit hook will catch shipping-blocker\n      // formatting issues.\n    })\n  }\n}\n\ninterface OxfmtFormatResult {\n  code: string\n  errors: unknown[]\n}\n\ninterface OxfmtModule {\n  format(\n    fileName: string,\n    sourceText: string,\n    options?: Record<string, unknown>,\n  ): Promise<OxfmtFormatResult>\n}\n\nlet _oxfmt: OxfmtModule | null | undefined = undefined\n\n/** Resolve oxfmt from the user's project, else the CLI's own; cache the result (or null) for the process. */\nasync function resolveOxfmt(cwd: string): Promise<OxfmtModule | null> {\n  if (_oxfmt !== undefined) return _oxfmt\n  try {\n    const req = createRequire(join(cwd, 'package.json'))\n    const oxfmtPath = req.resolve('oxfmt')\n    _oxfmt = (await import(oxfmtPath)) as OxfmtModule\n  } catch {\n    // Not installed in the project — `vp migrate` removes it, Vite+ bundles\n    // its own. Fall back to the copy the CLI depends on.\n    _oxfmt = (await import('oxfmt').catch(() => null)) as OxfmtModule | null\n  }\n  return _oxfmt\n}\n\nasync function formatFile(filePath: string, content: string): Promise<void> {\n  const oxfmt = await resolveOxfmt(process.cwd())\n  if (!oxfmt) return\n  // The CLI binary auto-discovers `.oxfmtrc.json`, but the JS API\n  // does NOT — we walk up from the file being formatted so adopters'\n  // workspace config drives the output. Skip formatting entirely\n  // when no config is found (matches the old prettier failure mode:\n  // raw templates already follow project conventions).\n  const options = await loadOxfmtConfig(filePath)\n  if (options === null) return\n  const result = await oxfmt.format(filePath, content, options)\n  if (result.code === content) return\n  await writeFile(filePath, result.code, 'utf-8')\n}\n\nconst _oxfmtConfigCache = new Map<string, Record<string, unknown> | null>()\n\n/**\n * Walk up from `filePath`'s directory looking for `.oxfmtrc.json`.\n * Returns `null` when no config is found anywhere on the path —\n * generators then leave the raw template alone (which already\n * follows project conventions). Cached per starting directory so\n * the walk is one-shot per generator run.\n */\nasync function loadOxfmtConfig(filePath: string): Promise<Record<string, unknown> | null> {\n  let dir = dirname(filePath)\n  const startDir = dir\n  if (_oxfmtConfigCache.has(startDir)) return _oxfmtConfigCache.get(startDir)!\n  while (true) {\n    const configPath = join(dir, '.oxfmtrc.json')\n    if (existsSync(configPath)) {\n      try {\n        const raw = await readFile(configPath, 'utf-8')\n        const parsed = JSON.parse(raw) as Record<string, unknown>\n        // The `$schema` and `ignorePatterns` fields are runner-only —\n        // strip before passing to format() so it doesn't reject them\n        // as unknown options.\n        delete parsed['$schema']\n        delete parsed.ignorePatterns\n        _oxfmtConfigCache.set(startDir, parsed)\n        return parsed\n      } catch {\n        _oxfmtConfigCache.set(startDir, null)\n        return null\n      }\n    }\n    const parent = dirname(dir)\n    if (parent === dir) {\n      _oxfmtConfigCache.set(startDir, null)\n      return null\n    }\n    dir = parent\n  }\n}\n\n/** Reset cached oxfmt resolution. Tests use this; production code shouldn't. */\nexport function clearFormatCache(): void {\n  _oxfmt = undefined\n  _oxfmtConfigCache.clear()\n}\n\n/** Ensure a directory exists */\nexport async function ensureDirectory(dir: string): Promise<void> {\n  await mkdir(dir, { recursive: true })\n}\n\n/** Check if a file exists */\nexport async function fileExists(filePath: string): Promise<boolean> {\n  try {\n    await access(filePath)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/** Read a JSON file */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function readJsonFile<T = any>(filePath: string): Promise<T> {\n  const content = await readFile(filePath, 'utf-8')\n  return JSON.parse(content)\n}\n","/**\n * Which package manager a project uses — for installing (`kick add`) and for\n * the commands the CLI prints.\n */\nimport { existsSync, readFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { loadKickConfig, PACKAGE_MANAGERS, type PackageManager } from '../config'\n\nconst LOCKFILES: [string, PackageManager][] = [\n  ['pnpm-lock.yaml', 'pnpm'],\n  ['yarn.lock', 'yarn'],\n  ['bun.lock', 'bun'],\n  ['bun.lockb', 'bun'],\n  ['package-lock.json', 'npm'],\n]\n\n/** The package manager of the nearest folder up from `fromDir` holding a lockfile. */\nfunction detectFromLockfile(fromDir: string): PackageManager | null {\n  for (let dir = fromDir; ; dir = dirname(dir)) {\n    const hit = LOCKFILES.find(([file]) => existsSync(resolve(dir, file)))\n    if (hit) return hit[1]\n    if (dirname(dir) === dir) return null\n  }\n}\n\n/**\n * Read `packageManager` from the nearest ancestor `package.json` that\n * declares the field (corepack convention: `\"pnpm@10.0.0\"`). Climbs so\n * monorepo sub-packages inherit the workspace pm even when their own\n * package.json omits the field.\n */\nfunction packageManagerFromPackageJson(fromDir: string): PackageManager | null {\n  let dir: string | null = fromDir\n  while (dir) {\n    const pkgPath = resolve(dir, 'package.json')\n    if (existsSync(pkgPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))\n        const field: unknown = pkg.packageManager\n        if (typeof field === 'string') {\n          const name = field.split('@')[0] as PackageManager\n          if (PACKAGE_MANAGERS.includes(name)) return name\n        }\n      } catch {\n        // ignore — keep climbing\n      }\n    }\n    const parent = dirname(dir)\n    if (parent === dir) return null\n    dir = parent\n  }\n  return null\n}\n\nexport type PackageManagerSource =\n  | 'flag'\n  | 'config'\n  | 'package.json'\n  | 'lockfile'\n  | 'user-agent'\n  | 'default'\n\n/**\n * Resolve which package manager to use, in priority order:\n * 1. `--pm` CLI flag\n * 2. `packageManager` in kick.config\n * 3. `packageManager` in nearest ancestor package.json (corepack)\n * 4. The nearest ancestor folder's lockfile\n * 5. The package manager that launched the CLI (`npm_config_user_agent`)\n * 6. `'npm'` fallback\n *\n * Returns the chosen pm plus the source for callers that want to log\n * the resolution path.\n */\nexport async function resolvePackageManagerWithSource(\n  flagPm: string | undefined,\n  fromDir = process.cwd(),\n): Promise<{ pm: PackageManager; source: PackageManagerSource }> {\n  if (flagPm && PACKAGE_MANAGERS.includes(flagPm as PackageManager)) {\n    return { pm: flagPm as PackageManager, source: 'flag' }\n  }\n\n  const config = await loadKickConfig(fromDir)\n  if (config?.packageManager && PACKAGE_MANAGERS.includes(config.packageManager)) {\n    return { pm: config.packageManager, source: 'config' }\n  }\n\n  const fromPkg = packageManagerFromPackageJson(fromDir)\n  if (fromPkg) return { pm: fromPkg, source: 'package.json' }\n\n  const fromLock = detectFromLockfile(fromDir)\n  if (fromLock) return { pm: fromLock, source: 'lockfile' }\n\n  // Outside any project: the one that launched the CLI (`pnpm dlx`, `bunx`,\n  // `yarn dlx`, `npx`) — e.g. `pnpm dlx @forinda/kickjs-cli new app --yes`.\n  const fromAgent = process.env.npm_config_user_agent?.split('/')[0] as PackageManager | undefined\n  if (fromAgent && PACKAGE_MANAGERS.includes(fromAgent)) {\n    return { pm: fromAgent, source: 'user-agent' }\n  }\n\n  return { pm: 'npm', source: 'default' }\n}\n\n/** Convenience wrapper for callers that don't care about the source. */\nexport async function resolvePackageManager(\n  flagPm: string | undefined,\n  fromDir = process.cwd(),\n): Promise<PackageManager> {\n  const { pm } = await resolvePackageManagerWithSource(flagPm, fromDir)\n  return pm\n}\n\n/**\n * The project's package manager without reading kick.config — for messages\n * printed from synchronous code: `packageManager`, then the lockfile, then npm.\n */\nexport function detectPackageManager(fromDir = process.cwd()): PackageManager {\n  return packageManagerFromPackageJson(fromDir) ?? detectFromLockfile(fromDir) ?? 'npm'\n}\n"],"mappings":"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"}

package/dist/{plugin-HazJu53p.mjs → plugin--9hxxgsD.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.2
+ * @forinda/kickjs-cli v8.12.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import"./types-CtrnAiNl.mjs";export{r as mergeCliPlugins}from"./run-plugins-Dx-QENlm.mjs";
+import"./types-B5dY2mTz.mjs";export{r as mergeCliPlugins}from"./run-plugins-9tjbMqS6.mjs";

package/dist/{plugin-Dh0LYWl5.mjs → plugin-CvlUt9NG.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.2
+ * @forinda/kickjs-cli v8.12.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-7c5UUG6D.mjs";import{KickPluginConflictError as t,defineCliPlugin as n}from"@forinda/kickjs-cli-kit";function r(e,n=[]){let r=/* @__PURE__ */ 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=/* @__PURE__ */ 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=/* @__PURE__ */ 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=/* @__PURE__ */ 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-DGKTJDH3.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=/* @__PURE__ */ e({mergeCliPlugins:()=>r});export{r as n,n as r,i as t};
+import{t as e}from"./rolldown-runtime-C4d34LEE.mjs";import{KickPluginConflictError as t,defineCliPlugin as n}from"@forinda/kickjs-cli-kit";function r(e,n=[]){let r=/* @__PURE__ */ 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=/* @__PURE__ */ 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=/* @__PURE__ */ 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=/* @__PURE__ */ 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-BXmtd-te.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=/* @__PURE__ */ e({mergeCliPlugins:()=>r});export{r as n,n as r,i as t};