@forinda/kickjs-cli 8.5.0 → 8.6.1

package/dist/fs-DH9oxW0t.mjs

@@ -0,0 +1,11 @@
+/**
+ * @forinda/kickjs-cli v8.6.1
+ *
+ * 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{createRequire as e}from"node:module";import{existsSync as t}from"node:fs";import{dirname as n,extname as r,join as i}from"node:path";import{access as a,mkdir as o,readFile as s,writeFile as c}from"node:fs/promises";let l=!1;function u(e){l=e}const d=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.json`,`.md`]);async function f(e,t){l||(await o(n(e),{recursive:!0}),await c(e,t,`utf-8`),d.has(r(e))&&await h(e,t).catch(()=>{}))}let p;async function m(t){if(p!==void 0)return p;try{p=await import(e(i(t,`package.json`)).resolve(`oxfmt`))}catch{p=null}return p}async function h(e,t){let n=await m(process.cwd());if(!n)return;let r=await _(e);if(r===null)return;let i=await n.format(e,t,r);i.code!==t&&await c(e,i.code,`utf-8`)}const g=new Map;async function _(e){let r=n(e),a=r;if(g.has(a))return g.get(a);for(;;){let e=i(r,`.oxfmtrc.json`);if(t(e))try{let t=await s(e,`utf-8`),n=JSON.parse(t);return delete n.$schema,delete n.ignorePatterns,g.set(a,n),n}catch{return g.set(a,null),null}let o=n(r);if(o===r)return g.set(a,null),null;r=o}}async function v(e){try{return await a(e),!0}catch{return!1}}export{u as n,f as r,v as t};

package/dist/fs-Dz7zBXL4.mjs

@@ -0,0 +1,12 @@
+/**
+ * @forinda/kickjs-cli v8.6.1
+ *
+ * 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{createRequire as e}from"node:module";import{dirname as t,extname as n,join as r}from"node:path";import{existsSync as i}from"node:fs";import{access as a,mkdir as o,readFile as s,writeFile as c}from"node:fs/promises";let l=!1;function u(e){l=e}const d=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.json`,`.md`]);async function f(e,r){l||(await o(t(e),{recursive:!0}),await c(e,r,`utf-8`),d.has(n(e))&&await h(e,r).catch(()=>{}))}let p;async function m(t){if(p!==void 0)return p;try{p=await import(e(r(t,`package.json`)).resolve(`oxfmt`))}catch{p=null}return p}async function h(e,t){let n=await m(process.cwd());if(!n)return;let r=await _(e);if(r===null)return;let i=await n.format(e,t,r);i.code!==t&&await c(e,i.code,`utf-8`)}const g=new Map;async function _(e){let n=t(e),a=n;if(g.has(a))return g.get(a);for(;;){let e=r(n,`.oxfmtrc.json`);if(i(e))try{let t=await s(e,`utf-8`),n=JSON.parse(t);return delete n.$schema,delete n.ignorePatterns,g.set(a,n),n}catch{return g.set(a,null),null}let o=t(n);if(o===n)return g.set(a,null),null;n=o}}async function v(e){try{return await a(e),!0}catch{return!1}}export{u as n,f as r,v as t};
+//# sourceMappingURL=fs-Dz7zBXL4.mjs.map

package/dist/fs-Dz7zBXL4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-Dz7zBXL4.mjs","names":[],"sources":["../src/utils/fs.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; 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    _oxfmt = 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"],"mappings":";;;;;;;;;;8NAKA,IAAI,EAAU,GAId,SAAgB,EAAU,EAAwB,CAChD,EAAU,CACZ,CAYA,MAAM,EAAc,IAAI,IAAI,CAAC,MAAO,OAAQ,MAAO,OAAQ,OAAQ,OAAQ,QAAS,KAAK,CAAC,EAgB1F,eAAsB,EAAc,EAAkB,EAAgC,CAChF,IACJ,MAAM,EAAM,EAAQ,CAAQ,EAAG,CAAE,UAAW,EAAK,CAAC,EAClD,MAAM,EAAU,EAAU,EAAS,OAAO,EAC3B,EAAY,IAAI,EAAQ,CAAQ,CAAC,GAC9C,MAAM,EAAW,EAAU,CAAO,CAAC,CAAC,UAAY,CAIhD,CAAC,EAEL,CAeA,IAAI,EAGJ,eAAe,EAAa,EAA0C,CACpE,GAAI,IAAW,IAAA,GAAW,OAAO,EACjC,GAAI,CAGF,EAAU,MAAM,OAFJ,EAAc,EAAK,EAAK,cAAc,CAC9B,CAAC,CAAC,QAAQ,OACC,EACjC,MAAQ,CACN,EAAS,IACX,CACA,OAAO,CACT,CAEA,eAAe,EAAW,EAAkB,EAAgC,CAC1E,IAAM,EAAQ,MAAM,EAAa,QAAQ,IAAI,CAAC,EAC9C,GAAI,CAAC,EAAO,OAMZ,IAAM,EAAU,MAAM,EAAgB,CAAQ,EAC9C,GAAI,IAAY,KAAM,OACtB,IAAM,EAAS,MAAM,EAAM,OAAO,EAAU,EAAS,CAAO,EACxD,EAAO,OAAS,GACpB,MAAM,EAAU,EAAU,EAAO,KAAM,OAAO,CAChD,CAEA,MAAM,EAAoB,IAAI,IAS9B,eAAe,EAAgB,EAA2D,CACxF,IAAI,EAAM,EAAQ,CAAQ,EACpB,EAAW,EACjB,GAAI,EAAkB,IAAI,CAAQ,EAAG,OAAO,EAAkB,IAAI,CAAQ,EAC1E,OAAa,CACX,IAAM,EAAa,EAAK,EAAK,eAAe,EAC5C,GAAI,EAAW,CAAU,EACvB,GAAI,CACF,IAAM,EAAM,MAAM,EAAS,EAAY,OAAO,EACxC,EAAS,KAAK,MAAM,CAAG,EAO7B,OAHA,OAAO,EAAO,QACd,OAAO,EAAO,eACd,EAAkB,IAAI,EAAU,CAAM,EAC/B,CACT,MAAQ,CAEN,OADA,EAAkB,IAAI,EAAU,IAAI,EAC7B,IACT,CAEF,IAAM,EAAS,EAAQ,CAAG,EAC1B,GAAI,IAAW,EAEb,OADA,EAAkB,IAAI,EAAU,IAAI,EAC7B,KAET,EAAM,CACR,CACF,CAcA,eAAsB,EAAW,EAAoC,CACnE,GAAI,CAEF,OADA,MAAM,EAAO,CAAQ,EACd,EACT,MAAQ,CACN,MAAO,EACT,CACF"}

package/dist/fullstack-BKD9McZF.mjs

@@ -0,0 +1,96 @@
+/**
+ * @forinda/kickjs-cli v8.6.1
+ *
+ * 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{r as e}from"./fs-Dz7zBXL4.mjs";import{a as t,f as n,n as r,p as i,t as a,u as o}from"./project-BjxeGJBn.mjs";import{join as s}from"node:path";import{execFileSync as c}from"node:child_process";const l=`https://kickjs.app/guide/fullstack-frontend.html`,u=[{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`}],d=`react-ts`;function f(e,t,n=d){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 p(u){let{name:p,directory:_,schemaLib:v=`zod`,runtime:y=`express`,packages:b=[],frontend:x=`kick`,viteTemplate:S=d}=u,C=[`pnpm`,`npm`,`yarn`,`bun`].includes(u.packageManager),w=C?u.packageManager:`pnpm`,T=_,E=e=>console.log(`  ${e}`);u.packageManager!==void 0&&!C&&E(`Warning: unknown package manager '${String(u.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${p}\n`),console.log(`  Resolving package versions...`);let D=await r(),O=await a({name:`${p}-server`,directory:s(T,`server`),packageManager:w,template:`minimal`,schemaLib:v,runtime:y,packages:b,extraLayers:[`server-fullstack`],approveInstallScripts:!1,platformConfig:!1,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`,versions:D});if(x===`vite`){console.log(`\n  Handing web/ to create-vite (${S})...\n`);let[e,...t]=f(w,`web`,S);o(e,t,{cwd:T})}else await e(s(T,`web/package.json`),m(p,D));await e(s(T,`package.json`),h(p,w,D[`@forinda/kickjs-cli`])),w===`pnpm`&&await e(s(T,`pnpm-workspace.yaml`),`packages:
+  - server
+  - web
+`),t(w,T,O.builds);let k=[`fullstack-root`,...x===`vite`?[]:[`web-kick`]],A=n(i(k).files,{name:p,packageManager:w});for(let[t,n]of A)await e(s(T,t),n);await e(s(T,`README.md`),g(p,w,x));let{generateAgentDocs:j}=await import(`./agent-docs-BO_QMIkN.mjs`).then(e=>e.t);if(await j({outDir:T,name:p,pm:w,template:`fullstack`,only:`all`,force:!0}),u.installDeps){console.log(`\n  Installing workspace dependencies with ${w}...\n`);try{o(w,[`install`],{cwd:T})}catch{console.log(`\n  Warning: ${w} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-BOxA_1DU.mjs`).then(e=>e.n);await e({cwd:s(T,`server`),allowDuplicates:!0,silent:!0})}catch{}if(u.initGit)try{c(`git`,[`init`],{cwd:T,stdio:`pipe`}),c(`git`,[`branch`,`-M`,`main`],{cwd:T,stdio:`pipe`}),c(`git`,[`add`,`-A`],{cwd:T,stdio:`pipe`}),c(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:T,stdio:`pipe`}),E(`Git repository initialized`)}catch{E(`Warning: git init failed (git may not be installed)`)}console.log(`
+  Fullstack workspace scaffolded!`),console.log(),E(`Next steps:`),E(`  cd ${p}`),u.installDeps||E(`  ${w} install`),w===`pnpm`?E(`  pnpm dev            # runs server (kick dev) + web (vite) together`):(E(`  ${w} run dev:server   # terminal 1`),E(`  ${w} run dev:web      # terminal 2`)),E(``),x===`vite`?(E(`web/ is create-vite output, unwired. To type it against the API:`),E(`  ${l}`)):(E(`The web app calls the API through @forinda/kickjs-client —`),E(`edit server/src/modules/hello and watch web/src/App.tsx's types follow.`)),E(``)}function m(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 h(e,t,n){let r=t===`pnpm`?{dev:`pnpm --parallel -r run dev`,start:`pnpm --filter ./server run start`,"dev:server":`pnpm --filter ./server dev`,"dev:web":`pnpm --filter ./web dev`,build:`pnpm --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`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`cd server && ${t} exec kick typegen && cd .. && ${t} run build:server && ${t} run build:web`,"build:netlify":`${t} run build && cd server && ${t} exec kick build:netlify`,"build:vercel":`${t} run build && cd server && ${t} exec 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`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,scripts:r,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function g(e,t,n=`kick`){let r=`# ${e}
+
+Fullstack KickJS workspace — typed end to end.
+
+| Package   | What                                                              |
+| --------- | ----------------------------------------------------------------- |
+| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch)       |
+| \`web/\`    | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
+
+## Develop
+
+\`\`\`bash
+${t} install
+${t===`pnpm`?`pnpm dev            # server (kick dev) + web (vite), in parallel`:`${t} run dev:server   # terminal 1\n${t} run dev:web      # terminal 2`}
+\`\`\`
+
+Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
+
+## The type loop
+
+1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
+2. \`kick typegen\` emits \`server/.kickjs/types/kick__client.d.ts\` — the flat
+   route map with every response type resolved to a literal shape.
+3. \`web/tsconfig.json\` lists that file in \`types\`, so \`KickClientApi\` is
+   ambient — no import, no bridge file.
+4. \`web/src/api.ts\`'s \`createClient<KickClientApi.Api>\` types every call site.
+
+Because the map holds resolved types rather than references to controllers,
+\`web\` never compiles server source: no \`experimentalDecorators\`, no path
+aliases into \`server/src\`.
+
+Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
+stops compiling. That's the point.
+
+### Keeping the map fresh
+
+\`server/.kickjs/types/kick__client.d.ts\` is generated, and \`web\` reads it as
+an ambient type package. Two things follow.
+
+**It is not refreshed by \`kick dev\`.** Resolving it builds a whole TypeScript
+program over the server, which is a build-step cost rather than a per-save one,
+so a renamed response field surfaces on the next \`kick typegen\` rather than on
+save. Everything else in \`.kickjs/types\` still updates on save. Add
+\`kick typegen --check\` to CI and a stale map fails the build.
+
+**It needs a compiler API.** TypeScript 7 ships none, so \`server\` depends on
+\`@typescript/typescript6\`. Remove it and typegen skips this one file, saying
+so; \`web\` then reports \`TS2688\` because the file it lists in \`types\` is gone.
+
+### The other way to wire it
+
+A \`types\` entry says "this is a global type package", which is what the map is,
+and it fails loudly when the file is missing. If you would rather it be quiet
+when absent — say, a repo where the map is not always generated — use
+\`include\` instead:
+
+\`\`\`json
+{ "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] }
+\`\`\`
+
+That tolerates the file not existing, at the cost of \`KickClientApi\` silently
+not resolving. Note \`types\` replaces TypeScript's automatic \`@types\`
+inclusion, so if you add entries there, list the ones you rely on too
+(\`"types": ["node", "../server/.kickjs/types/kick__client"]\`).
+
+Or skip the global entirely — the same file exports the type:
+
+\`\`\`ts
+import type { Api } from '../../server/.kickjs/types/kick__client'
+
+export const api = createClient<Api>({ baseUrl: '/api/v1' })
+\`\`\`
+
+Docs: https://kickjs.app/guide/typed-client.html
+`;if(n!==`vite`)return r;let i=r.indexOf(`## The type loop`);return`${r.slice(0,i).replace("Vite + React, typed against the API via `@forinda/kickjs-client`",`create-vite scaffold — unwired (see below)                       `).replace(" (Vite proxies `/api`)",``)}## Wiring web/ to the API
+
+\`web/\` is whatever create-vite scaffolded; nothing connects it to the API yet.
+Four steps — typed client, \`/api\` dev proxy, route-map types, \`src/api.ts\`:
+
+${l}
+`}export{d as DEFAULT_VITE_TEMPLATE,u as VITE_TEMPLATES,p as initFullstackProject};
+//# sourceMappingURL=fullstack-BKD9McZF.mjs.map

package/dist/fullstack-BKD9McZF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullstack-BKD9McZF.mjs","names":[],"sources":["../src/generators/fullstack.ts"],"sourcesContent":["// `kick new --template fullstack` — a pnpm-workspace monorepo:\n//\n//   my-app/\n//     server/   KickJS API (the standard scaffold, minus its own git/install)\n//     web/      Vite + React frontend typed end-to-end via\n//               @forinda/kickjs-client + the server's generated KickRoutes.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, re-run by `kick dev`) emits\n// server/.kickjs/types/kick__client.d.ts → web tsconfig `types` (ambient)\n// side-effect-imports that file (type-only, erased at runtime) → the web\n// client calls `api.get('/hello')` with the handler's actual response type.\n\nimport { join } from 'node:path'\nimport { execFileSync } from 'node:child_process'\n\nimport { writeFileSafe } from '../utils/fs'\nimport { runCommand } from '../utils/shell'\nimport { initProject, resolveSiblingVersions } from './project'\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  await writeFileSafe(\n    join(dir, 'package.json'),\n    rootPackageJson(name, packageManager, versions['@forinda/kickjs-cli']),\n  )\n  // Only pnpm reads this file. npm / yarn / bun declare workspaces via the\n  // `workspaces` field in the root package.json instead — see rootPackageJson.\n  if (packageManager === 'pnpm') {\n    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\n  // Workspace-root agent docs (CLAUDE.md + .agents/) flavored for the\n  // fullstack layout — the server/ subdir keeps its own generated set.\n  const { generateAgentDocs } = await import('./agent-docs')\n  await generateAgentDocs({\n    outDir: dir,\n    name,\n    pm: packageManager,\n    template: 'fullstack',\n    only: 'all',\n    force: true,\n  })\n\n  // ── install (root — covers both workspace packages) ────────────────\n  if (options.installDeps) {\n    console.log(`\\n  Installing workspace dependencies with ${packageManager}...\\n`)\n    try {\n      // `runCommand`, not bare execFileSync — on Windows every package\n      // manager is a `.cmd` shim that execFileSync cannot spawn.\n      runCommand(packageManager, ['install'], { cwd: dir })\n    } catch {\n      console.log(`\\n  Warning: ${packageManager} install failed. Run it manually.`)\n    }\n  }\n\n  // ── typegen (server) so web's KickRoutes.Api resolves immediately ──\n  try {\n    const { runTypegen } = await import('../typegen')\n    await runTypegen({ cwd: join(dir, 'server'), allowDuplicates: true, silent: true })\n  } catch {\n    // Non-fatal — `kick dev` in server/ retries on boot.\n  }\n\n  // ── git (root) ──────────────────────────────────────────────────────\n  if (options.initGit) {\n    try {\n      execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['branch', '-M', 'main'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['add', '-A'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['commit', '-m', 'chore: initial commit from kick new (fullstack)'], {\n        cwd: dir,\n        stdio: 'pipe',\n      })\n      log('Git repository initialized')\n    } catch {\n      log('Warning: git init failed (git may not be installed)')\n    }\n  }\n\n  console.log('\\n  Fullstack workspace scaffolded!')\n  console.log()\n  log('Next steps:')\n  log(`  cd ${name}`)\n  if (!options.installDeps) log(`  ${packageManager} install`)\n  if (packageManager === 'pnpm') {\n    log('  pnpm dev            # runs server (kick dev) + web (vite) together')\n  } else {\n    log(`  ${packageManager} run dev:server   # terminal 1`)\n    log(`  ${packageManager} run dev:web      # terminal 2`)\n  }\n  log('')\n  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(\"edit server/src/modules/hello and watch 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\nfunction rootPackageJson(name: string, pm: string, cliVersion: string): string {\n  const scripts: Record<string, string> =\n    pm === 'pnpm'\n      ? {\n          dev: 'pnpm --parallel -r run dev',\n          // One origin: the server serves `web/dist` through SpaAdapter.\n          start: 'pnpm --filter ./server run start',\n          'dev:server': 'pnpm --filter ./server dev',\n          'dev:web': 'pnpm --filter ./web dev',\n          // 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        }\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.\n          build: `cd server && ${pm} exec kick typegen && cd .. && ${pm} run build:server && ${pm} run build:web`,\n          'build:netlify': `${pm} run build && cd server && ${pm} exec kick build:netlify`,\n          'build:vercel': `${pm} run build && cd server && ${pm} exec 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        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts,\n      // The CLI is a ROOT dependency so the bare `kick` in the scripts above\n      // resolves: package managers put `node_modules/.bin` on PATH for\n      // scripts, and the CLI otherwise lives only in `server/node_modules`.\n      devDependencies: { '@forinda/kickjs-cli': cliVersion },\n      workspaces: ['server', 'web'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\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\n## The type loop\n\n1. Server handlers **return** their payloads (\\`return this.service.greet(...)\\`).\n2. \\`kick typegen\\` emits \\`server/.kickjs/types/kick__client.d.ts\\` — the flat\n   route map with every response type resolved to a literal shape.\n3. \\`web/tsconfig.json\\` lists that file in \\`types\\`, so \\`KickClientApi\\` is\n   ambient — no import, no bridge file.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickClientApi.Api>\\` types every call site.\n\nBecause the map holds resolved types rather than references to controllers,\n\\`web\\` never compiles server source: no \\`experimentalDecorators\\`, no path\naliases into \\`server/src\\`.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\n### Keeping the map fresh\n\n\\`server/.kickjs/types/kick__client.d.ts\\` is generated, and \\`web\\` reads it as\nan ambient type package. Two things follow.\n\n**It is not refreshed by \\`kick dev\\`.** Resolving it builds a whole TypeScript\nprogram over the server, which is a build-step cost rather than a per-save one,\nso a renamed response field surfaces on the next \\`kick typegen\\` rather than on\nsave. Everything else in \\`.kickjs/types\\` still updates on save. Add\n\\`kick typegen --check\\` to CI and a stale map fails the build.\n\n**It needs a compiler API.** TypeScript 7 ships none, so \\`server\\` depends on\n\\`@typescript/typescript6\\`. Remove it and typegen skips this one file, saying\nso; \\`web\\` then reports \\`TS2688\\` because the file it lists in \\`types\\` is gone.\n\n### The other way to wire it\n\nA \\`types\\` entry says \"this is a global type package\", which is what the map is,\nand it fails loudly when the file is missing. If you would rather it be quiet\nwhen absent — say, a repo where the map is not always generated — use\n\\`include\\` instead:\n\n\\`\\`\\`json\n{ \"include\": [\"src\", \"../server/.kickjs/types/kick__client.d.ts\"] }\n\\`\\`\\`\n\nThat tolerates the file not existing, at the cost of \\`KickClientApi\\` silently\nnot resolving. Note \\`types\\` replaces TypeScript's automatic \\`@types\\`\ninclusion, so if you add entries there, list the ones you rely on too\n(\\`\"types\": [\"node\", \"../server/.kickjs/types/kick__client\"]\\`).\n\nOr skip the global entirely — the same file exports the type:\n\n\\`\\`\\`ts\nimport type { Api } from '../../server/.kickjs/types/kick__client'\n\nexport const api = createClient<Api>({ baseUrl: '/api/v1' })\n\\`\\`\\`\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n\n  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":"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"}

package/dist/fullstack-DQbVCW5U.mjs

@@ -0,0 +1,95 @@
+/**
+ * @forinda/kickjs-cli v8.6.1
+ *
+ * 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{a as e,d as t,f as n,n as r,t as i,u as a}from"./project-BAGDIkJa.mjs";import{r as o}from"./fs-DH9oxW0t.mjs";import{join as s}from"node:path";import{execFileSync as c}from"node:child_process";const l=`https://kickjs.app/guide/fullstack-frontend.html`,u=[{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`}],d=`react-ts`;function f(e,t,n=d){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 p(u){let{name:p,directory:_,schemaLib:v=`zod`,runtime:y=`express`,packages:b=[],frontend:x=`kick`,viteTemplate:S=d}=u,C=[`pnpm`,`npm`,`yarn`,`bun`].includes(u.packageManager),w=C?u.packageManager:`pnpm`,T=_,E=e=>console.log(`  ${e}`);u.packageManager!==void 0&&!C&&E(`Warning: unknown package manager '${String(u.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${p}\n`),console.log(`  Resolving package versions...`);let D=await r(),O=await i({name:`${p}-server`,directory:s(T,`server`),packageManager:w,template:`minimal`,schemaLib:v,runtime:y,packages:b,extraLayers:[`server-fullstack`],approveInstallScripts:!1,platformConfig:!1,initGit:!1,installDeps:!1,spaClientDir:`../web/dist`,versions:D});if(x===`vite`){console.log(`\n  Handing web/ to create-vite (${S})...\n`);let[e,...t]=f(w,`web`,S);n(e,t,{cwd:T})}else await o(s(T,`web/package.json`),m(p,D));await o(s(T,`package.json`),h(p,w,D[`@forinda/kickjs-cli`])),w===`pnpm`&&await o(s(T,`pnpm-workspace.yaml`),`packages:
+  - server
+  - web
+`),e(w,T,O.builds);let k=[`fullstack-root`,...x===`vite`?[]:[`web-kick`]],A=a(t(k).files,{name:p,packageManager:w});for(let[e,t]of A)await o(s(T,e),t);await o(s(T,`README.md`),g(p,w,x));let{generateAgentDocs:j}=await import(`./agent-docs-DTg4y5mT.mjs`).then(e=>e.t);if(await j({outDir:T,name:p,pm:w,template:`fullstack`,only:`all`,force:!0}),u.installDeps){console.log(`\n  Installing workspace dependencies with ${w}...\n`);try{n(w,[`install`],{cwd:T})}catch{console.log(`\n  Warning: ${w} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-Dss5L5p7.mjs`).then(e=>e.n);await e({cwd:s(T,`server`),allowDuplicates:!0,silent:!0})}catch{}if(u.initGit)try{c(`git`,[`init`],{cwd:T,stdio:`pipe`}),c(`git`,[`branch`,`-M`,`main`],{cwd:T,stdio:`pipe`}),c(`git`,[`add`,`-A`],{cwd:T,stdio:`pipe`}),c(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:T,stdio:`pipe`}),E(`Git repository initialized`)}catch{E(`Warning: git init failed (git may not be installed)`)}console.log(`
+  Fullstack workspace scaffolded!`),console.log(),E(`Next steps:`),E(`  cd ${p}`),u.installDeps||E(`  ${w} install`),w===`pnpm`?E(`  pnpm dev            # runs server (kick dev) + web (vite) together`):(E(`  ${w} run dev:server   # terminal 1`),E(`  ${w} run dev:web      # terminal 2`)),E(``),x===`vite`?(E(`web/ is create-vite output, unwired. To type it against the API:`),E(`  ${l}`)):(E(`The web app calls the API through @forinda/kickjs-client —`),E(`edit server/src/modules/hello and watch web/src/App.tsx's types follow.`)),E(``)}function m(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 h(e,t,n){let r=t===`pnpm`?{dev:`pnpm --parallel -r run dev`,start:`pnpm --filter ./server run start`,"dev:server":`pnpm --filter ./server dev`,"dev:web":`pnpm --filter ./web dev`,build:`pnpm --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`}:{start:`cd server && ${t} run start`,"dev:server":`cd server && ${t} run dev`,"dev:web":`cd web && ${t} run dev`,build:`cd server && ${t} exec kick typegen && cd .. && ${t} run build:server && ${t} run build:web`,"build:netlify":`${t} run build && cd server && ${t} exec kick build:netlify`,"build:vercel":`${t} run build && cd server && ${t} exec 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`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,scripts:r,devDependencies:{"@forinda/kickjs-cli":n},workspaces:[`server`,`web`]},null,2)}\n`}function g(e,t,n=`kick`){let r=`# ${e}
+
+Fullstack KickJS workspace — typed end to end.
+
+| Package   | What                                                              |
+| --------- | ----------------------------------------------------------------- |
+| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch)       |
+| \`web/\`    | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
+
+## Develop
+
+\`\`\`bash
+${t} install
+${t===`pnpm`?`pnpm dev            # server (kick dev) + web (vite), in parallel`:`${t} run dev:server   # terminal 1\n${t} run dev:web      # terminal 2`}
+\`\`\`
+
+Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
+
+## The type loop
+
+1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
+2. \`kick typegen\` emits \`server/.kickjs/types/kick__client.d.ts\` — the flat
+   route map with every response type resolved to a literal shape.
+3. \`web/tsconfig.json\` lists that file in \`types\`, so \`KickClientApi\` is
+   ambient — no import, no bridge file.
+4. \`web/src/api.ts\`'s \`createClient<KickClientApi.Api>\` types every call site.
+
+Because the map holds resolved types rather than references to controllers,
+\`web\` never compiles server source: no \`experimentalDecorators\`, no path
+aliases into \`server/src\`.
+
+Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
+stops compiling. That's the point.
+
+### Keeping the map fresh
+
+\`server/.kickjs/types/kick__client.d.ts\` is generated, and \`web\` reads it as
+an ambient type package. Two things follow.
+
+**It is not refreshed by \`kick dev\`.** Resolving it builds a whole TypeScript
+program over the server, which is a build-step cost rather than a per-save one,
+so a renamed response field surfaces on the next \`kick typegen\` rather than on
+save. Everything else in \`.kickjs/types\` still updates on save. Add
+\`kick typegen --check\` to CI and a stale map fails the build.
+
+**It needs a compiler API.** TypeScript 7 ships none, so \`server\` depends on
+\`@typescript/typescript6\`. Remove it and typegen skips this one file, saying
+so; \`web\` then reports \`TS2688\` because the file it lists in \`types\` is gone.
+
+### The other way to wire it
+
+A \`types\` entry says "this is a global type package", which is what the map is,
+and it fails loudly when the file is missing. If you would rather it be quiet
+when absent — say, a repo where the map is not always generated — use
+\`include\` instead:
+
+\`\`\`json
+{ "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] }
+\`\`\`
+
+That tolerates the file not existing, at the cost of \`KickClientApi\` silently
+not resolving. Note \`types\` replaces TypeScript's automatic \`@types\`
+inclusion, so if you add entries there, list the ones you rely on too
+(\`"types": ["node", "../server/.kickjs/types/kick__client"]\`).
+
+Or skip the global entirely — the same file exports the type:
+
+\`\`\`ts
+import type { Api } from '../../server/.kickjs/types/kick__client'
+
+export const api = createClient<Api>({ baseUrl: '/api/v1' })
+\`\`\`
+
+Docs: https://kickjs.app/guide/typed-client.html
+`;if(n!==`vite`)return r;let i=r.indexOf(`## The type loop`);return`${r.slice(0,i).replace("Vite + React, typed against the API via `@forinda/kickjs-client`",`create-vite scaffold — unwired (see below)                       `).replace(" (Vite proxies `/api`)",``)}## Wiring web/ to the API
+
+\`web/\` is whatever create-vite scaffolded; nothing connects it to the API yet.
+Four steps — typed client, \`/api\` dev proxy, route-map types, \`src/api.ts\`:
+
+${l}
+`}export{d as DEFAULT_VITE_TEMPLATE,u as VITE_TEMPLATES,p as initFullstackProject};

package/dist/index.d.mts

@@ -176,7 +176,7 @@ type RepoTypeConfig = BuiltinRepoType$1 | CustomRepoType;
  */
 type SchemaValidator = 'zod' | 'kickjs-schema' | false;
 /**
- * One entry in the typed `assetMap` config record (`assets-plan.md`).
+ * One entry in the typed `assetMap` config record.
  * Each entry names a source directory whose files become addressable
  * via the `assets.<name>.*` typed accessor at runtime.
  */
@@ -580,7 +580,7 @@ interface KickConfig {
     outDir?: string;
   };
   /**
-   * Typed, addressable assets — see `assets-plan.md`. Each entry maps
+   * Typed, addressable assets — see https://kickjs.app/guide/asset-manager. Each entry maps
    * a logical namespace name to a source directory. The build pipeline
    * auto-derives the necessary copy step + emits a manifest at
    * `dist/.kickjs-assets.json`; the runtime exposes
@@ -705,23 +705,6 @@ interface KickConfig {
 export declare function defineConfig(config: KickConfig): KickConfig;
 /** Schema library a generated schema file is written against. */
 type SchemaLib$1 = 'zod' | 'valibot' | 'yup';
-/**
- * Load `kick.config.*` starting from `startDir` and walking up toward
- * the filesystem root until a config file is found. Returns `null`
- * when no config exists anywhere on the way up.
- *
- * Walking up means adopters can run `kick <cmd>` from any subdirectory
- * (e.g. `src/modules/users/`) and still pick up the project's config —
- * before this change a nested-cwd invocation silently saw `null` and
- * fell back to framework defaults.
- *
- * TypeScript configs (`.ts`) are loaded via `jiti` when available;
- * `.js` / `.mjs` use native `import()`; `.json` uses `JSON.parse`. The
- * jiti import is dynamic + best-effort: if the dep is missing we
- * surface a warning telling the adopter how to install it, instead of
- * silently dropping the config (which is what the previous bare-catch
- * did).
- */
 export declare function loadKickConfig(startDir: string): Promise<KickConfig | null>;
 //#endregion
 //#region src/generators/templates/types.d.ts
@@ -903,10 +886,11 @@ interface InitProjectOptions {
   runtime?: 'express' | 'fastify' | 'h3';
   /** Wire `SpaAdapter` at this clientDir (fullstack template). */
   spaClientDir?: string;
-  /** Pin the compiler API + generate the client route map (fullstack). */
-  withClientMap?: boolean;
-  /** Fail `kick dev` when its port is taken instead of moving (fullstack's /api proxy needs the port). */
-  strictPort?: boolean;
+  /**
+   * Layers rendered after the selection's — `server-fullstack` for the
+   * fullstack workspace's server (strict port, client route map, TS 6 pin).
+   */
+  extraLayers?: string[];
   /**
    * Record install-script approvals for the package manager (pnpm-workspace.yaml,
    * or package.json for npm/bun). Default true; false when the project is a
@@ -927,7 +911,14 @@ interface InitProjectOptions {
   versions?: Record<string, string>;
 }
 /** Scaffold a new KickJS project */
-export declare function initProject(options: InitProjectOptions): Promise<void>;
+/**
+ * Scaffold a project. Returns the install-script answers it needs, so a
+ * caller that installs from elsewhere (the fullstack workspace root) can
+ * record them there.
+ */
+export declare function initProject(options: InitProjectOptions): Promise<{
+  builds: Record<string, boolean>;
+}>;
 //#endregion
 //#region src/utils/project-root.d.ts
 /**

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/commands/add.ts","../src/commands/doctor.ts","../src/plugin/types.ts","../src/config.ts","../src/generators/templates/types.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/utils/project-root.ts","../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/typegen/token-conventions.ts","../src/typegen/index.ts","../src/typegen/run-plugins.ts","../src/asset-manager/build.ts","../src/typegen/dev-watcher.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/commands/add.ts","../src/commands/doctor.ts","../src/plugin/types.ts","../src/config.ts","../src/generators/templates/types.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/utils/project-root.ts","../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/typegen/token-conventions.ts","../src/typegen/index.ts","../src/typegen/run-plugins.ts","../src/asset-manager/build.ts","../src/typegen/dev-watcher.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.5.0
+ * @forinda/kickjs-cli v8.6.1
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{A as e,M as t,N as n,P as r,S as i,_ as a,c as o,d as s,g as c,h as l,l as u,m as d,n as f,o as p,p as m,s as h,t as g,y as _}from"./doctor-Df6zCPr5.mjs";import{t as v}from"./project-DdYD7xPw.mjs";import{o as y,r as b}from"./config-BUYf44lU.mjs";import{t as x}from"./project-root-BzyIWFlH.mjs";import{n as S,t as C}from"./types-dUiZnaWm.mjs";export{C as KickPluginConflictError,o as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,b as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,s as defineTypegen,x as findProjectRoot,_ as generateAdapter,d as generateController,m as generateDto,c as generateGuard,a as generateMiddleware,i as generateModule,l as generateService,v as initProject,y as loadKickConfig,e as pluralize,t as toCamelCase,n as toKebabCase,r as toPascalCase};
+import{A as e,M as t,N as n,P as r,S as i,_ as a,c as o,d as s,g as c,h as l,l as u,m as d,n as f,o as p,p as m,s as h,t as g,y as _}from"./doctor-p4bjILiU.mjs";import{t as v}from"./project-BjxeGJBn.mjs";import{o as y,r as b}from"./config-BoXFaObA.mjs";import{t as x}from"./project-root-D8VclnwB.mjs";import{n as S,t as C}from"./types-Dudqvbd1.mjs";export{C as KickPluginConflictError,o as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,b as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,s as defineTypegen,x as findProjectRoot,_ as generateAdapter,d as generateController,m as generateDto,c as generateGuard,a as generateMiddleware,i as generateModule,l as generateService,v as initProject,y as loadKickConfig,e as pluralize,t as toCamelCase,n as toKebabCase,r as toPascalCase};

package/dist/{plugin-B8fmVbk8.mjs → plugin-Aof9UWs7.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.5.0
+ * @forinda/kickjs-cli v8.6.1
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import"./types-dUiZnaWm.mjs";import{r as e}from"./run-plugins-ByRyAAZe.mjs";export{e as mergeCliPlugins};
+import"./types-Dudqvbd1.mjs";import{r as e}from"./run-plugins-DCVSqa5a.mjs";export{e as mergeCliPlugins};

package/dist/{plugin-B-mP0jvi.mjs → plugin-B-kr8WAU.mjs}

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

package/dist/project-BAGDIkJa.mjs

@@ -0,0 +1,45 @@
+/**
+ * @forinda/kickjs-cli v8.6.1
+ *
+ * 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{a as e,t}from"./config-Bz1suLYz.mjs";import{r as n}from"./fs-DH9oxW0t.mjs";import{existsSync as r,readFileSync as i,readdirSync as a,statSync as o,writeFileSync as s}from"node:fs";import{dirname as c,join as l,resolve as u,sep as d}from"node:path";import{fileURLToPath as f}from"node:url";import{execFile as p,execFileSync as m,execSync as h,spawnSync as g}from"node:child_process";import{promisify as _}from"node:util";import{parseSync as v}from"oxc-parser";const y=_(p),b=/[&|<>^"'`(){}[\];!%\r\n\\]/;function x(e,t,n=process.platform){if(n!==`win32`)return[e,t];if(b.test(e)||t.some(e=>b.test(e)))return null;let r=[e,...t].map(e=>e.includes(` `)?`"${e}"`:e).join(` `);return[process.env.ComSpec||`cmd.exe`,[`/d`,`/s`,`/c`,r]]}function S(e,t,n={}){let r=x(e,t);if(!r)return null;try{return m(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,stdio:[`ignore`,`pipe`,`ignore`],windowsHide:!0}).toString().trim()||null}catch{return null}}function C(e,t,n={}){let r=x(e,t);if(!r)throw Error(`Refusing to run '${e}': unsafe arguments`);m(r[0],r[1],{cwd:n.cwd,stdio:`inherit`,windowsHide:!0})}function ee(e,t,n){h(e,{cwd:t,stdio:`inherit`,env:n?{...process.env,...n}:process.env})}function te(e,t,n){let r=g(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function ne(e,t,n={}){let r=x(e,t);if(!r)return null;try{let{stdout:e}=await y(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,windowsHide:!0});return e.toString().trim()||null}catch{return null}}const w=c(f(import.meta.url)),T=[l(w,`..`,`templates`),l(w,`..`,`..`,`templates`)].find(e=>r(l(e,`base`)));function re(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function E(e,t={}){let n=t.templatesDir??T,s=new Map,c=[],u=[],f={},p=[];for(let t of e){let e=l(n,t);if(!r(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let m=l(e,`feature.json`);if(r(m)){let e=JSON.parse(i(m,`utf-8`));c.push(...e.dependencies??[]),u.push(...e.devDependencies??[]),Object.assign(f,e.builds),p.push(...e.integrations??[])}let h=l(e,`files`);if(r(h))for(let e of a(h,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=l(h,e);if(!o(t).isFile())continue;let n=i(t,`utf-8`),r=re(e.split(d).join(`/`));if(r.endsWith(`.append`)){let e=r.slice(0,-7);s.set(e,(s.get(e)??``)+n)}else s.set(r,n)}}p.push(...t.extra??[]);let m=t.vars??{},h=e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>m[t]??e);for(let[e,t]of s)t.includes(`// @kick:`)&&s.set(e,ie(t,p,h));return{files:s,dependencies:[...new Set(c)],devDependencies:[...new Set(u)],builds:f,integrations:p}}function D(e,t){let n=e=>e.replace(/\{\{(\w+)\}\}/g,(e,n)=>n in t?t[n]:e);return new Map([...e].map(([e,t])=>[e,n(t)]))}const O=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function ie(e,t,n=e=>e){let r=e.split(`
+`),i=new Set(r.map(e=>O.exec(e)?.[2]).filter(Boolean)),a=t.filter(e=>!e.slot||i.has(e.slot)),o=[];for(let e=0;e<r.length;e++){let t=O.exec(r[e]);if(!t){o.push(r[e]);continue}let[,i,s]=t,c=s===`imports`?oe(a.flatMap(e=>e.import?[e.import]:[])):a.filter(e=>e.slot===s&&e.code).map(e=>ae(`${n(e.code)},`,i));if(c.length>0){o.push(...c);continue}o.at(-1)?.trimEnd().endsWith(`[`)&&r[e+1]?.trim().startsWith(`]`)&&(o.pop(),e++)}return o.join(`
+`)}function ae(e,t){return e.split(`
+`).map(e=>e&&t+e).join(`
+`)}function oe(e){let t=new Map;for(let n of e){let e=t.get(n.from)??{names:[]};e.default??=n.default;for(let t of n.names??[])e.names.includes(t)||e.names.push(t);t.set(n.from,e)}return[...t].map(([e,{names:t,default:n}])=>{let r=`import ${[n,t.length?`{ ${t.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e}'`;return r.length<=100||t.length===0?r:`import ${n?`${n}, `:``}{\n${t.map(e=>`  ${e},`).join(`
+`)}\n} from '${e}'`})}function se(e,t){let n=e[t];if(!n)throw Error(`generatePackageJson: missing resolved version for ${t}. Add it to SIBLING_PACKAGES or THIRD_PARTY_PACKAGES in generators/project.ts.`);return n}function k(e,t){return Object.fromEntries(e.toSorted().map(e=>[e,se(t,e)]))}function ce(e,t,n){return JSON.stringify({name:e,version:`0.0.0`,type:`module`,scripts:{dev:`kick dev`,build:`kick build`,start:`kick start`,test:`vitest run`,"build:netlify":`kick build && kick build:netlify`,"build:vercel":`kick build && kick build:vercel`},dependencies:k(n.dependencies,t),devDependencies:k(n.devDependencies,t)},null,2)}function le(e,t){let n=Object.entries(t);if(n.length===0)return e;let r=e===``?[]:e.replace(/\n$/,``).split(`
+`),i=e=>e.trim().replace(/^['"]|['"]$/g,``),a=e=>/^[\w-]+$/.test(e)?e:`'${e}'`,o=(e,t)=>{let n=r.findIndex(t=>t.replace(/\s+$/,``)===`${e}:`);if(n===-1){if(!t)return;r.length>0&&r[r.length-1]!==``&&r.push(``),r.push(`${e}:`),n=r.length-1}let i=n+1;for(let e=n+1;e<r.length&&/^(\s|$)/.test(r[e]);e++)r[e].trim()!==``&&(i=e+1);return{start:n,end:i}},s=[];for(let[e,t]of n){let{start:n,end:c}=o(`allowBuilds`,!0),l=r.slice(n+1,c).findIndex(t=>i(t.split(`:`)[0])===e),u=l===-1?void 0:/:\s*(true|false)\s*$/.exec(r[n+1+l]);if(u){s.push([e,u[1]===`true`]);continue}let d=`  ${a(e)}: ${t}`;l===-1?r.splice(c,0,d):r[n+1+l]=d,s.push([e,t])}let c=[`onlyBuiltDependencies`,`ignoredBuiltDependencies`];for(let[e,t]of s){if(c.some(t=>{let n=o(t,!1);return n!==void 0&&r.slice(n.start+1,n.end).some(t=>i(t.replace(/^\s*-/,``))===e)}))continue;let{end:n}=o(t?c[0]:c[1],!0);r.splice(n,0,`  - ${a(e)}`)}return`${r.join(`
+`)}\n`}const ue={adapter:`adapters`,middleware:`middlewares`};function de(e,t,n=e=>e,r=`src/index.ts`){let i={source:e,added:[],present:[],manual:[]};for(let e of t){if(!e.slot||!e.code)continue;let t=ue[e.slot],a=n(e.code),o=me(a),s=v(r,i.source).program,c=t?fe(s):void 0;if(!c){i.manual.push({...e,code:a});continue}let l=c.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t);if(l&&l.value.type!==`ArrayExpression`){i.manual.push({...e,code:a});continue}let u=o&&e.import?pe(s,e.import.from,o):o;if(l&&u&&i.source.slice(l.value.start,l.value.end).includes(`${u}(`)){i.present.push(o??A(a));continue}i.source=l?he(i.source,l.value,a):ge(i.source,c,t,a),e.import&&(i.source=_e(i.source,e.import,r)),i.added.push(o??A(a))}return i}function fe(e){let t,n=e=>{if(t||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(n);let r=e;if(r.type===`CallExpression`&&r.callee?.type===`Identifier`&&r.callee.name===`bootstrap`&&r.arguments?.[0]?.type===`ObjectExpression`){t=r.arguments[0];return}for(let e in r)n(r[e])};return n(e),t}function pe(e,t,n){for(let r of e.body)if(r.type===`ImportDeclaration`&&r.source.value===t)for(let e of r.specifiers){let t=e.imported?.name??e.imported?.value;if(e.type===`ImportSpecifier`&&t===n)return e.local.name}return n}function me(e){let t=e.split(`
+`).find(e=>e.trim()&&!e.trim().startsWith(`//`));return/^\s*([A-Za-z_$][\w$.]*)\s*\(/.exec(t??``)?.[1]}const A=e=>e.split(`
+`).find(e=>e.trim()&&!e.trim().startsWith(`//`))?.trim()??e,j=(e,t)=>/^[ \t]*/.exec(e.slice(e.lastIndexOf(`
+`,t-1)+1))[0],M=(e,t)=>e.split(`
+`).map(e=>e&&t+e).join(`
+`);function he(e,t,n){let r=t.elements.filter(Boolean),i=j(e,t.start);if(r.length===0){let r=M(`${n},`,`${i}  `);return`${e.slice(0,t.start)}[\n${r}\n${i}]${e.slice(t.end)}`}let a=r.at(-1),o=j(e,a.start),s=e.slice(a.end,t.end-1).match(/^\s*,/),c=s?a.end+s[0].length:a.end,l=`\n${M(`${n},`,o)}`;return s?e.slice(0,c)+l+e.slice(c):`${e.slice(0,c)},${l.replace(/,$/,``)}${e.slice(c)}`}function ge(e,t,n,r){let i=t.properties.at(-1),a=i?j(e,i.start):`${j(e,t.start)}  `,o=`${a}${n}: [\n${M(`${r},`,`${a}  `)}\n${a}],`;if(!i)return`${e.slice(0,t.start)}{\n${o}\n${j(e,t.start)}}${e.slice(t.end)}`;let s=e.slice(i.end,t.end-1).match(/^\s*,/),c=s?i.end+s[0].length:i.end;return`${e.slice(0,c)}${s?``:`,`}\n${o}${e.slice(c)}`}function _e(e,t,n=`src/index.ts`){let r=v(n,e).program.body.filter(e=>e.type===`ImportDeclaration`),i=r.find(e=>e.source.value===t.from&&e.importKind!==`type`&&e.specifiers.length>0&&!e.specifiers.some(e=>e.type===`ImportNamespaceSpecifier`)),a=t.names??[];if(i){let t=new Set(i.specifiers.map(e=>e.local?.name)),n=a.filter(e=>!t.has(e));if(n.length===0)return e;let r=i.specifiers.filter(e=>e.type===`ImportSpecifier`);if(r.length>0){let t=r.at(-1).end;return`${e.slice(0,t)}, ${n.join(`, `)}${e.slice(t)}`}let o=i.specifiers[0];return`${e.slice(0,o.end)}, { ${n.join(`, `)} }${e.slice(o.end)}`}let o=`import ${[t.default,a.length?`{ ${a.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${t.from}'`,s=r.at(-1);return s?`${e.slice(0,s.end)}\n${o}${e.slice(s.end)}`:`${o}\n${e}`}const ve={swagger:`feature-swagger`,devtools:`feature-devtools`,ws:`feature-ws`,queue:`feature-queue`,"queue:bullmq":`feature-queue`};function ye(e){let t=[...new Set(e.map(e=>ve[e]).filter(Boolean))];return t.length>0?E(t):void 0}function N(e,t){return(t?[t]:[`src/index.ts`,`src/main.ts`]).find(t=>r(l(e,t)))}function P(e,t){try{return m(`git`,[`status`,`--porcelain`,`--`,...t],{cwd:e,encoding:`utf-8`,stdio:[`ignore`,`pipe`,`ignore`]}).split(`
+`).filter(Boolean).map(e=>e.slice(3))}catch{return[]}}async function be(e,t){let a=[];for(let[o,s]of t){let t=l(e,o);if(!r(t)){await n(t,s),a.push(o);continue}let c=i(t,`utf-8`),u=new Set(c.split(`
+`).map(e=>F(e)??e)),d=s.split(`
+`).filter(e=>e.trim()&&!u.has(F(e)??e));if(d.length===0)continue;let f=c===``||c.endsWith(`
+`)?``:`
+`;await n(t,`${c}${f}${d.join(`
+`)}\n`),a.push(o)}return a}const F=e=>/^\s*([A-Za-z_][\w]*)\s*=/.exec(e)?.[1];async function xe(e,t,r){let a=l(e,t),o=i(a,`utf-8`),s=de(o,r,I(e),t);return s.source!==o&&await n(a,s.source),s}function I(e){let t=Se(e),n={name:String(t.name??`app`),version:String(t.version??`0.0.0`)};return e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>n[t]??e)}function Se(e){try{return JSON.parse(i(l(e,`package.json`),`utf-8`))}catch{return{}}}function Ce(e){let t=e.flatMap(e=>e.import?[e.import]:[]).map(e=>`import ${[e.default,e.names?.length?`{ ${e.names.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e.from}'`),n=e.map(e=>`${e.code},`);return[...t,``,`// in bootstrap({ adapters: [ ... ] }):`,...n].join(`
+`)}const L={kickjs:{pkg:`@forinda/kickjs`,peers:[],enginePeers:!0,description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},zod:{pkg:`zod`,peers:[],description:`Zod schema validation (env, DTOs, OpenAPI) — wrap with fromZod()`},valibot:{pkg:`valibot`,peers:[],description:`Valibot schema validation — wrap with fromValibot()`},yup:{pkg:`yup`,peers:[],description:`Yup schema validation — wrap with fromYup()`},ai:{pkg:`@forinda/kickjs-ai`,peers:[`zod`],description:`AI toolkit — LLM providers, tool definitions from controllers`},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`,builds:{"@scarf/scarf":!0}},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},pg:{pkg:`@forinda/kickjs-db`,peers:[`pg`],description:`kick/db + PostgreSQL driver (use @forinda/kickjs-db/pg)`},sqlite:{pkg:`@forinda/kickjs-db`,peers:[`better-sqlite3`],description:`kick/db + SQLite driver (use @forinda/kickjs-db/sqlite)`},mysql:{pkg:`@forinda/kickjs-db`,peers:[`mysql2`],description:`kick/db + MySQL driver (use @forinda/kickjs-db/mysql)`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`ws`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],builds:{"msgpackr-extract":!1},description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/sdk`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}},we=Object.entries(L).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),R={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3`,`serve-static`]},z={express:{prod:`multer`,dev:`@types/multer`,note:`Express uploads use multer (memory/disk storage, ctx.file / ctx.files).`},fastify:{prod:`@fastify/multipart`,note:`Fastify uploads use @fastify/multipart (buffered into ctx.file / ctx.files).`},h3:{note:`h3 parses multipart natively (readMultipartFormData) — no driver to install.`}};function B(e){if(e!==void 0){if(e===`express`||e===`fastify`||e===`h3`)return e;throw Error(`Invalid --runtime '${String(e)}'. Expected express, fastify or h3.`)}}async function V(e=process.cwd()){return(await H(e)).runtime}async function H(t=process.cwd()){let n=(await e(t))?.runtime;return n===`express`||n===`fastify`||n===`h3`?{runtime:n,candidates:[n],ambiguous:!1,fromConfig:!0}:{...Te(t),fromConfig:!1}}const U=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function Te(e=process.cwd()){let t=W(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(i(u(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let a=U.filter(([e])=>e in n).map(([,e])=>e),o=U.filter(([e])=>e in r&&!(e in n)).map(([,e])=>e),s=[...a,...o];return a.length===1?{runtime:a[0],candidates:s,ambiguous:!1}:a.length===0&&o.length===1?{runtime:o[0],candidates:s,ambiguous:!1}:s.length===0?{runtime:`express`,candidates:s,ambiguous:!1}:{runtime:`express`,candidates:s,ambiguous:!0}}function W(e,t=process.cwd()){let n=t;for(;;){if(r(u(n,e)))return n;let t=c(n);if(t===n)return null;n=t}}function Ee(){return W(`pnpm-lock.yaml`)?`pnpm`:W(`yarn.lock`)?`yarn`:W(`bun.lockb`)||W(`bun.lock`)?`bun`:W(`package-lock.json`)?`npm`:null}function De(){let e=process.cwd();for(;e;){let n=u(e,`package.json`);if(r(n))try{let e=JSON.parse(i(n,`utf-8`)).packageManager;if(typeof e==`string`){let n=e.split(`@`)[0];if(t.includes(n))return n}}catch{}let a=c(e);if(a===e)return null;e=a}return null}async function G(n){if(n&&t.includes(n))return{pm:n,source:`flag`};let r=await e(process.cwd());if(r?.packageManager&&t.includes(r.packageManager))return{pm:r.packageManager,source:`config`};let i=De();if(i)return{pm:i,source:`package.json`};let a=Ee();return a?{pm:a,source:`lockfile`}:{pm:`npm`,source:`default`}}async function Oe(e){let{pm:t}=await G(e);return t}function K(e=!1,t){let n=Object.entries(L),r=Math.max(...n.map(([e])=>e.length)),i=n.filter(([,e])=>e.core),a=n.filter(([,e])=>!e.core),o=([e,n])=>{let i=e.padEnd(r+2),a=n.enginePeers?[...n.peers,...R[t??`express`]]:n.peers,o=n.enginePeers?` [${t??`express`} engine]`:``,s=a.length?` (+ ${a.join(`, `)})${o}`:``,c=n.deprecated?` [DEPRECATED — ${n.deprecated}]`:``;return`    ${i} ${n.description}${s}${c}`};console.log(`
+  Core packages (always installed by \`kick new\`):
+`);for(let e of i)console.log(o(e));if(e){console.log(`
+  Optional packages (add as needed):
+`);for(let e of a)console.log(o(e))}else console.log(`\n  Plus ${a.length} optional packages (swagger, db, queue, …).`),console.log("  Run `kick add --list --all` for the full catalog.");console.log(`
+  Usage: kick add ai db swagger`),console.log(`         kick add queue:bullmq`),console.log(`         kick add upload   # installs the multipart driver for your runtime`),console.log()}const ke={"@swc/core":!0,esbuild:!0};function q(e,t,n){if(e===`pnpm`){let e=u(t,`pnpm-workspace.yaml`),a=r(e)?i(e,`utf-8`):``,o=le(a,n);return o===a?void 0:(s(e,o),e)}if(e!==`npm`&&e!==`bun`)return;let a=u(t,`package.json`);if(!r(a))return;let o=JSON.parse(i(a,`utf-8`)),c=!1;if(e===`npm`){let e=o.allowScripts??{};for(let[t,r]of Object.entries(n))Object.keys(e).some(e=>e===t||e.startsWith(`${t}@`))||(e[t]=r,c=!0);o.allowScripts=e}else{let e=o.trustedDependencies??[];for(let[t,r]of Object.entries(n))r&&!e.includes(t)&&(e.push(t),c=!0);o.trustedDependencies=e}if(c)return s(a,`${JSON.stringify(o,null,2)}\n`),a}function Ae(e){if(e===`pnpm`)return W(`pnpm-workspace.yaml`)??process.cwd();for(let e=process.cwd();;e=c(e)){try{if(JSON.parse(i(u(e,`package.json`),`utf-8`)).workspaces)return e}catch{}if(c(e)===e)return process.cwd()}}function J(e){return Object.assign({},...e.map(e=>L[e]?.builds??{}))}function je(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=z[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=L[c];if(!e){a.push(c);continue}e.deprecated&&o.push(`'${c}' (${e.pkg}) is deprecated — ${e.deprecated}`);let l=t||e.dev?i:r;l.add(e.pkg);for(let t of e.peers)l.add(t);if(e.enginePeers){let e=R[n];for(let t of e)l.add(t);s.push(`${c} (${n}): engine peers ${e.join(`, `)}`)}}return{prodDeps:[...r],devDeps:[...i],unknown:a,warnings:o,notices:s}}function Me(e){e.command(`list`).alias(`ls`).description(`List KickJS packages (core only; pair with --all for the full catalog)`).option(`--all`,`Include the full optional catalog`).option(`--runtime <engine>`,`HTTP engine to show peers for: express | fastify | h3`).action(async e=>{K(!!e.all,B(e.runtime)??await V())})}function Ne(e){e.command(`add [packages...]`).description(`Add KickJS packages with their required dependencies`).option(`--pm <manager>`,`Package manager override`).option(`-D, --dev`,`Install as dev dependency`).option(`--list`,`List packages (core only by default; pair with --all)`).option(`--runtime <engine>`,`HTTP engine for peer resolution: express | fastify | h3 (overrides kick.config.ts)`).option(`--all`,`When listing, include the full optional catalog`).option(`--no-wire`,`Install only — do not add adapters to the entry file or .env`).option(`--entry <file>`,`Entry file to wire (default: src/index.ts, then src/main.ts)`).option(`-f, --force`,`Wire even when the files it edits have uncommitted changes`).action(async(e,t)=>{if(t.list||e.length===0){K(!!t.all,B(t.runtime)??await V());return}let{pm:n,source:i}=await G(t.pm);console.log(`\n  Using ${n} (resolved from ${i})`);let a=B(t.runtime),o=await H(process.cwd()),s=a??o.runtime;if(!a&&o.ambiguous){console.error(`\n  Cannot tell which HTTP engine this app boots on: found ${o.candidates.join(`, `)} in package.json.\n\n  Installing engine peers for the wrong one is worse than not installing them, so:\n    • set \`runtime: '<engine>'\` in kick.config.ts (permanent, also fixes kick doctor), or\n    • pass --runtime <${o.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let c=je(e,!!t.dev,s),{unknown:l,warnings:d,notices:f}=c,{prodDeps:p,devDeps:m}=c,g=process.cwd();if(t.entry&&!r(u(g,t.entry))){console.error(`\n  --entry ${t.entry} does not exist.\n`),process.exitCode=1;return}let _=t.wire===!1?void 0:ye(e),v=_?N(g,t.entry):void 0;if(_){p=[...new Set([...p,..._.dependencies])],m=[...new Set([...m,..._.devDependencies].filter(e=>!p.includes(e)))];let e=P(g,[...v?[v]:[],..._.files.keys()]);if(e.length>0&&!t.force){console.error(`\n  ${e.join(`, `)} ${e.length===1?`has`:`have`} uncommitted changes, and kick add would edit ${e.length===1?`it`:`them`}.\n  Commit or stash first, pass --force to edit anyway, or --no-wire to install only.\n`),process.exitCode=1;return}}for(let e of d)console.warn(`\n  WARNING: ${e}`);for(let e of f)console.log(`\n  ${e}`);if(l.length>0&&(console.log(`\n  Unknown packages: ${l.join(`, `)}`),console.log(`  Run "kick add --list" to see available packages.
+`),p.length===0&&m.length===0))return;let y={...J(e),..._?.builds};if(Object.keys(y).length>0){let e=q(n,Ae(n),y);e&&console.log(`\n  Approved install scripts in ${e}`)}let b=!0;if(p.length>0){let e=p,t=`${n} add ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dependency(ies):`);for(let t of e)console.log(`    + ${t}`);console.log();try{h(t,{stdio:`inherit`})}catch{b=!1,console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(m.length>0){let e=m,t=`${n} add -D ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dev dependency(ies):`);for(let t of e)console.log(`    + ${t} (dev)`);console.log();try{h(t,{stdio:`inherit`})}catch{b=!1,console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(_){if(!b)console.log(`  Skipped wiring — the install did not finish.
+`);else{for(let e of await be(g,_.files))console.log(`  Updated ${e}`);let e=v?await xe(g,v,_.integrations):void 0;for(let t of e?.added??[])console.log(`  Added ${t} to ${v}`);for(let t of e?.present??[])console.log(`  ${t} is already in ${v}`);let t=I(g),n=e?e.manual:_.integrations.filter(e=>e.slot&&e.code).map(e=>({...e,code:t(e.code)}));n.length>0&&(console.log(`\n  ${v?`Could not find bootstrap({ adapters: [...] }) in ${v}`:`No entry file found`} — add this yourself:
+`),console.log(Ce(n).replace(/^/gm,`    `)),console.log())}}console.log(`  Done!
+`)})}const Y=c(f(import.meta.url)),X=JSON.parse(i([l(Y,`..`,`package.json`),l(Y,`..`,`..`,`package.json`)].find(r),`utf-8`)),Pe=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-schema`,`@forinda/kickjs-vite`,`@forinda/kickjs-swagger`,`@forinda/kickjs-ws`,`@forinda/kickjs-queue`,`@forinda/kickjs-devtools`,`@forinda/kickjs-testing`,`@forinda/kickjs-client`],Fe={react:{fallback:`^19.0.0`},"react-dom":{fallback:`^19.0.0`},"@types/react":{fallback:`^19.0.0`},"@types/react-dom":{fallback:`^19.0.0`},"@vitejs/plugin-react":{fallback:`^5.0.0`},"@types/node":{fallback:`^25.0.0`},"@types/supertest":{fallback:`^7.2.1`},supertest:{fallback:`^7.2.2`},vitest:{fallback:`^4.1.2`},"@swc/core":{fallback:`^1.15.21`},"unplugin-swc":{fallback:`^1.5.9`},oxfmt:{fallback:`^0.65.0`},oxlint:{fallback:`^1.80.0`},dotenv:{fallback:`^17.3.1`,cap:`^17`},"reflect-metadata":{fallback:`^0.2.2`},vite:{fallback:`^8.0.3`,cap:`^8`},typescript:{fallback:`^7.0.2`,cap:`^7`},"@typescript/typescript6":{fallback:`^6.0.2`,cap:`^6`},express:{fallback:`^5.1.0`,cap:`^5`},"@types/express":{fallback:`^5.0.6`,cap:`^5`},fastify:{fallback:`^5.0.0`,cap:`^5`},"@fastify/middie":{fallback:`^9.0.0`,cap:`^9`},h3:{fallback:`^1.0.0`,cap:`^1`},"serve-static":{fallback:`^2.2.0`,cap:`^2`},zod:{fallback:`^4.3.6`,cap:`^4`},valibot:{fallback:`^1.4.1`,cap:`^1`},yup:{fallback:`^1.7.1`,cap:`^1`},ws:{fallback:`^8.18.0`,cap:`^8`},bullmq:{fallback:`^5.0.0`,cap:`^5`},ioredis:{fallback:`^5.0.0`,cap:`^5`}};function Ie(e){if(!e)return null;let t=e.trim();if(/^\d+\.\d+\.\d+/.test(t))return t.split(/\s/)[0];try{let e=JSON.parse(t),n=(Array.isArray(e)?e:[e]).filter(e=>typeof e==`string`);return n.length>0?n[n.length-1]:null}catch{return null}}function Le(e){return e===`@forinda/kickjs-cli`?`^${X.version}`:`latest`}async function Re(e,t,n){let r=Array.from({length:e.length}),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let t=i++;r[t]=await n(e[t])}});return await Promise.all(a),r}async function Z(){let e=[...Pe.map(e=>({name:e,fallback:Le(e),cap:void 0})),...Object.entries(Fe).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await Re(e,8,async({name:e,fallback:n,cap:r})=>{let i=t-Date.now();if(i<=0)return[e,n];let a=r?`${e}@${r}`:e,o=Ie(await ne(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Q(e,t){let n=S(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function ze(e,t){let n=e=>$(e).split(`-`)[0].split(`.`).map(e=>Number.parseInt(e,10)||0),[r=0,i=0,a=0]=n(e),[o=0,s=0,c=0]=n(t);return r===o?i===s?a>=c:i>s:r>o}function Be(e,t,n){let r=S(`npm`,[`view`,`${e}@${t}`,`exports`,`--json`],{timeout:2e4});if(!r)return!1;try{let e=JSON.parse(r);return Object.prototype.hasOwnProperty.call(e,n)}catch{return!1}}async function Ve(e){let{name:t,directory:i,packageManager:a=`pnpm`,template:o=`rest`,defaultRepo:s=`inmemory`,packages:c=[],schemaLib:u=`zod`,runtime:d=`express`}=e,f=i,p=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${t}\n`),e.versions||p(`Resolving package versions...`);let m=e.versions??await Z(),g=Object.keys(m).filter(e=>m[e]===`latest`);if(g.length>0&&p(`WARNING: could not reach npm for ${g.join(`, `)} — pinned to 'latest'`),d!==`express`){if(Be(`@forinda/kickjs`,`latest`,`./${d}`))p(`Using @forinda/kickjs@latest (stable ships the ${d} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Q(r,`alpha`);e&&ze(e,$(m[r]))&&(m[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}p(n?`Using the alpha channel for the ${d} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${d} runtime subpath may be missing. After install, run: ${a} add @forinda/kickjs@alpha`)}}let _=c.filter(e=>!r(l(T,`feature-${e}`)));_.length>0&&p(`WARNING: skipping unknown package(s): ${_.join(`, `)} — add them later with kick add`);let v=E([...Ue({template:o,runtime:d,schemaLib:u,packages:c}),...e.platformConfig===!1?[]:[`host-config`],...e.extraLayers??[]],{vars:{name:t,version:X.version},extra:[{slot:`repo`,code:s===`inmemory`?`repo: 'inmemory'`:`repo: { name: '${s.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}' }`},...e.spaClientDir?[He(e.spaClientDir)]:[]]});await n(l(f,`package.json`),ce(t,m,v));let y=D(v.files,{name:t,template:o,runtime:d,packageManager:a,templateLabel:o===`rest`?`REST API`:`Minimal`,packages:[...v.dependencies,...v.devDependencies].filter(e=>e.startsWith(`@forinda/`)).map(e=>`- \`${e}\``).join(`
+`)});for(let[e,t]of y)await n(l(f,e),t);let{generateAgentDocs:b}=await import(`./agent-docs-DTg4y5mT.mjs`).then(e=>e.t);await b({outDir:f,name:t,pm:a,template:o,only:`all`,force:!0});let x={...ke,...J(c),...v.builds};if(e.approveInstallScripts!==!1&&q(a,f,x),e.installDeps){console.log(`\n  Installing dependencies with ${a}...\n`);try{h(`${a} install`,{cwd:f,stdio:`inherit`}),console.log(`
+  Dependencies installed successfully!`)}catch{console.log(`\n  Warning: ${a} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-Dss5L5p7.mjs`).then(e=>e.n);await e({cwd:f,allowDuplicates:!0,silent:!0})}catch{}if(e.initGit)try{h(`git init`,{cwd:f,stdio:`pipe`}),h(`git branch -M main`,{cwd:f,stdio:`pipe`}),h(`git add -A`,{cwd:f,stdio:`pipe`}),h(`git commit -m "chore: initial commit from kick new"`,{cwd:f,stdio:`pipe`}),p(`Git repository initialized`)}catch{p(`Warning: git init failed (git may not be installed)`)}console.log(`
+  Project scaffolded successfully!`),console.log();let S=f!==process.cwd();p(`Next steps:`),S&&p(`  cd ${t}`),e.installDeps||p(`  ${a} install`);let C={rest:`kick g module user`,minimal:`# add your routes to src/index.ts`};return p(`  ${C[o]??C.rest}`),p(`  kick dev`),p(``),p(`Commands:`),p(`  kick dev                  Start dev server with Vite HMR`),p(`  kick build                Production build via Vite`),p(`  kick start                Run production build`),p(``),p(`Generators:`),p(`  kick g module <name>      REST module (controller, service, DTOs, repository)`),p(`  kick g scaffold <n> <f..> CRUD module from field definitions`),p(`  kick g controller <name>  Standalone controller`),p(`  kick g service <name>     @Service() class`),p(`  kick g middleware <name>   Global connect-style middleware`),p(`  kick g guard <name>       Route guard (auth, roles, etc.)`),p(`  kick g adapter <name>     AppAdapter with lifecycle hooks`),p(`  kick g dto <name>         DTO schema (Zod / Valibot / Yup)`),p(`  kick g config             Generate kick.config.ts`),p(``),p(`Add packages:`),p(`  kick add <pkg>            Install a KickJS package + peers`),p(`  kick add --list           Show all available packages`),p(``),p(`Available: ${we}`),p(``),{builds:x}}function He(e){return{import:{from:`@forinda/kickjs/spa`,names:[`SpaAdapter`]},slot:`adapter`,code:`// Serves the built frontend from this origin in production.
+// Inert until the client build exists, so \`kick dev\` (where Vite
+// serves the client and proxies /api here) is unaffected.
+SpaAdapter({ clientDir: ${JSON.stringify(e)} })`}}function Ue(e){return[`base`,`template-${e.template}`,`runtime-${e.runtime}`,`schema-${e.schemaLib}`,...e.packages.filter(e=>r(l(T,`feature-${e}`))).map(e=>`feature-${e}`)]}export{q as a,V as c,E as d,C as f,z as i,Oe as l,ee as m,Z as n,Ne as o,te as p,L as r,Me as s,Ve as t,D as u};