@forinda/kickjs-cli 8.10.1 → 8.10.2

package/dist/{fullstack-BlNhq-tI.mjs → fullstack-BqYdhTDI.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.10.2
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,10 +8,10 @@
  *
  * @license MIT
  */
-import{o as e}from"./package-manager-BUDLqU4F.mjs";import{d as t,i as n}from"./config-BV6rXylg.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-fa9FRWXx.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-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:
   - 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-TdQs75ND.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-Cj5lp0gl.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(`
+`),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}
 
 Fullstack KickJS workspace — typed end to end.
@@ -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-BlNhq-tI.mjs.map
+//# sourceMappingURL=fullstack-BqYdhTDI.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"fullstack-BlNhq-tI.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":"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"}
+{"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":"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"}

package/dist/{fullstack-Zk31eUT1.mjs → fullstack-x16HfCRz.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.10.2
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,10 +8,10 @@
  *
  * @license MIT
  */
-import{a as e,d as t,f as n,h as r,l as i,m as a,n as o,p as s,t as c,u as l}from"./project-BBiJ64ya.mjs";import{r as u,u as d}from"./config-CVuSVUvw.mjs";import{o as f}from"./package-manager-Bk2uiXkV.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(d){let{name:g,directory:y,schemaLib:C=`zod`,runtime:w=`express`,packages:T=[],frontend:E=`kick`,viteTemplate:D=_}=d,O=[`pnpm`,`npm`,`yarn`,`bun`].includes(d.packageManager),k=O?d.packageManager:`pnpm`,A=y,j=e=>console.log(`  ${e}`);d.packageManager!==void 0&&!O&&j(`Warning: unknown package manager '${String(d.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${g}\n`),console.log(`  Resolving package versions...`);let M=await o(),N=await c({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);r(e,t,{cwd:A})}else await f(p(A,`web/package.json`),b(g,M));let P=t(k);await f(p(A,`package.json`),x(g,k,M[`@forinda/kickjs-cli`],P));let F=n(k,P);F&&await f(p(A,`.yarnrc.yml`),F),k===`pnpm`&&await f(p(A,`pnpm-workspace.yaml`),`packages:
+import{a as e,d as t,f as n,h as r,l as i,m as a,n as o,p as s,t as c,u as l}from"./project-TbTVQCnh.mjs";import{r as u,u as d}from"./config-Ck9aQVpE.mjs";import{o as f}from"./package-manager--IUl91nq.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(d){let{name:g,directory:y,schemaLib:C=`zod`,runtime:w=`express`,packages:T=[],frontend:E=`kick`,viteTemplate:D=_}=d,O=[`pnpm`,`npm`,`yarn`,`bun`].includes(d.packageManager),k=O?d.packageManager:`pnpm`,A=y,j=e=>console.log(`  ${e}`);d.packageManager!==void 0&&!O&&j(`Warning: unknown package manager '${String(d.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${g}\n`),console.log(`  Resolving package versions...`);let M=await o(),N=await c({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);r(e,t,{cwd:A})}else await f(p(A,`web/package.json`),b(g,M));let P=t(k);await f(p(A,`package.json`),x(g,k,M[`@forinda/kickjs-cli`],P));let F=n(k,P);F&&await f(p(A,`.yarnrc.yml`),F),k===`pnpm`&&await f(p(A,`pnpm-workspace.yaml`),`packages:
   - server
   - web
-`),e(k,A,N.builds);let I=[`fullstack-root`,...E===`vite`?[]:[`web-kick`]],L=s(a(I).files,{name:g,packageManager:k});for(let[e,t]of L)await f(p(A,e),t);await f(p(A,`README.md`),S(g,k,E)),await f(p(A,`Dockerfile`),i(`fullstack`,k,g,P)),await f(p(A,`.dockerignore`),l());let{generateAgentDocs:R}=await import(`./agent-docs-uEhHT_Tq.mjs`).then(e=>e.t);if(await R({outDir:A,name:g,pm:k,template:`fullstack`,only:`all`,force:!0}),d.installDeps){console.log(`\n  Installing workspace dependencies with ${k}...\n`);try{r(k,[`install`],{cwd:A})}catch{console.log(`\n  Warning: ${k} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-D9opCn2d.mjs`).then(e=>e.n);await e({cwd:p(A,`server`),allowDuplicates:!0,silent:!0})}catch{}if(d.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(`
+`),e(k,A,N.builds);let I=[`fullstack-root`,...E===`vite`?[]:[`web-kick`]],L=s(a(I).files,{name:g,packageManager:k});for(let[e,t]of L)await f(p(A,e),t);await f(p(A,`README.md`),S(g,k,E)),await f(p(A,`Dockerfile`),i(`fullstack`,k,g,P)),await f(p(A,`.dockerignore`),l());let{generateAgentDocs:R}=await import(`./agent-docs-As_KjQBC.mjs`).then(e=>e.t);if(await R({outDir:A,name:g,pm:k,template:`fullstack`,only:`all`,force:!0}),d.installDeps){console.log(`\n  Installing workspace dependencies with ${k}...\n`);try{r(k,[`install`],{cwd:A})}catch{console.log(`\n  Warning: ${k} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-DJQ6WBwr.mjs`).then(e=>e.n);await e({cwd:p(A,`server`),allowDuplicates:!0,silent:!0})}catch{}if(d.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}`),d.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 \`${u(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,n,r,i=t(n)){let a=n===`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 && ${n} run start`,"dev:server":`cd server && ${n} run dev`,"dev:web":`cd web && ${n} run dev`,build:`cd server && kick typegen && cd .. && ${n} run build:server && ${n} run build:web`,"build:netlify":`${n} run build && cd server && kick build:netlify`,"build:vercel":`${n} run build && cd server && kick build:vercel`,"build:server":`cd server && ${n} run build`,"build:web":`cd web && ${n} run build`,typecheck:`kick typecheck --cwd server && kick typecheck --cwd web`,test:`cd server && ${n} run test`,format:`cd server && kick format`};return`${JSON.stringify({name:e,private:!0,version:`0.0.0`,type:`module`,...i?{packageManager:i}:{},scripts:a,devDependencies:{"@forinda/kickjs-cli":r},workspaces:[`server`,`web`]},null,2)}\n`}function S(e,t,n=`kick`){let r=`# ${e}
 
 Fullstack KickJS workspace — typed end to end.

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.10.2
  *
  * 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-a-UkOZYd.mjs";import{r as v,s as y}from"./config-BV6rXylg.mjs";import{t as b}from"./project-fa9FRWXx.mjs";import{t as x}from"./project-root-BZ1wVwrr.mjs";import{n as S,t as C}from"./types-BqvSIAQz.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-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};

package/dist/{package-manager-Bk2uiXkV.mjs → package-manager--IUl91nq.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.10.2
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{o as e,t}from"./config-CVuSVUvw.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{_=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);return o?{pm:o,source:`lockfile`}:{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};
+import{o as e,t}from"./config-Ck9aQVpE.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{_=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);return o?{pm:o,source:`lockfile`}:{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-BUDLqU4F.mjs → package-manager-DBmD5nSr.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.10.2
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import{s as e,t}from"./config-BV6rXylg.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{_=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);return o?{pm:o,source:`lockfile`}:{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-BUDLqU4F.mjs.map
+import{s as e,t}from"./config-CsOfUFfq.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{_=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);return o?{pm:o,source:`lockfile`}:{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-DBmD5nSr.mjs.map

package/dist/{package-manager-BUDLqU4F.mjs.map → package-manager-DBmD5nSr.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"package-manager-BUDLqU4F.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","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; 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","/**\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 = 'flag' | 'config' | 'package.json' | 'lockfile' | '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. `'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  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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"}
+{"version":3,"file":"package-manager-DBmD5nSr.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","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; 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","/**\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 = 'flag' | 'config' | 'package.json' | 'lockfile' | '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. `'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  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-FOqPjQ0u.mjs → plugin-Dh0LYWl5.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.10.2
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-D8pytGn4.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-BMpUTIbO.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-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};

package/dist/{plugin-DDENlsHw.mjs → plugin-HazJu53p.mjs}

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

package/dist/{project-fa9FRWXx.mjs → project-C98JovY4.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.10.2
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import{o as e,r as t}from"./package-manager-BUDLqU4F.mjs";import{d as n,i as r,s as i}from"./config-BV6rXylg.mjs";import{dirname as a,join as o,posix as s,resolve as c,sep as l}from"node:path";import{existsSync as u,readFileSync as d,readdirSync as f,statSync as p,writeFileSync as m}from"node:fs";import{execFile as h,execFileSync as g,execSync as _,spawnSync as v}from"node:child_process";import{randomBytes as y}from"node:crypto";import{fileURLToPath as b}from"node:url";import{promisify as x}from"node:util";import{parseSync as S}from"oxc-parser";const C=a(b(import.meta.url)),w=[o(C,`..`,`templates`),o(C,`..`,`..`,`templates`)].find(e=>u(o(e,`base`)));function T(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function E(e,t={}){let n=t.templatesDir??w,r=/* @__PURE__ */ new Map,i=[],a=[],s={},c=[],m={};for(let t of e){let e=o(n,t);if(!u(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let h=o(e,`feature.json`);if(u(h)){let e=JSON.parse(d(h,`utf-8`));i.push(...e.dependencies??[]),a.push(...e.devDependencies??[]),Object.assign(s,e.builds),c.push(...e.integrations??[]),Object.assign(m,e.scripts)}let g=o(e,`files`);if(u(g))for(let e of f(g,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=o(g,e);if(!p(t).isFile())continue;let n=d(t,`utf-8`),i=T(e.split(l).join(`/`));if(i.endsWith(`.append`)){let e=i.slice(0,-7);r.set(e,(r.get(e)??``)+n)}else r.set(i,n)}}c.push(...t.extra??[]);let h=t.vars??{},g=e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>h[t]??e);for(let[e,t]of r)t.includes(`// @kick:`)&&r.set(e,O(t,c,g));return{files:r,dependencies:[...new Set(i)],devDependencies:[...new Set(a)],builds:s,integrations:c,scripts:m}}function ee(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 D=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function O(e,t,n=e=>e){let r=e.split(`
+import{o as e,r as t}from"./package-manager-DBmD5nSr.mjs";import{d as n,i as r,s as i}from"./config-CsOfUFfq.mjs";import{dirname as a,join as o,posix as s,resolve as c,sep as l}from"node:path";import{existsSync as u,readFileSync as d,readdirSync as f,statSync as p,writeFileSync as m}from"node:fs";import{execFile as h,execFileSync as g,execSync as _,spawnSync as v}from"node:child_process";import{randomBytes as y}from"node:crypto";import{fileURLToPath as b}from"node:url";import{promisify as x}from"node:util";import{parseSync as S}from"oxc-parser";const C=a(b(import.meta.url)),w=[o(C,`..`,`templates`),o(C,`..`,`..`,`templates`)].find(e=>u(o(e,`base`)));function T(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function E(e,t={}){let n=t.templatesDir??w,r=/* @__PURE__ */ new Map,i=[],a=[],s={},c=[],m={};for(let t of e){let e=o(n,t);if(!u(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let h=o(e,`feature.json`);if(u(h)){let e=JSON.parse(d(h,`utf-8`));i.push(...e.dependencies??[]),a.push(...e.devDependencies??[]),Object.assign(s,e.builds),c.push(...e.integrations??[]),Object.assign(m,e.scripts)}let g=o(e,`files`);if(u(g))for(let e of f(g,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=o(g,e);if(!p(t).isFile())continue;let n=d(t,`utf-8`),i=T(e.split(l).join(`/`));if(i.endsWith(`.append`)){let e=i.slice(0,-7);r.set(e,(r.get(e)??``)+n)}else r.set(i,n)}}c.push(...t.extra??[]);let h=t.vars??{},g=e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>h[t]??e);for(let[e,t]of r)t.includes(`// @kick:`)&&r.set(e,O(t,c,g));return{files:r,dependencies:[...new Set(i)],devDependencies:[...new Set(a)],builds:s,integrations:c,scripts:m}}function ee(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 D=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function O(e,t,n=e=>e){let r=e.split(`
 `),i=new Set(r.map(e=>D.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=D.exec(r[e]);if(!t){o.push(r[e]);continue}let[,i,s]=t,c=s===`imports`?A(a.flatMap(e=>e.import?[e.import]:[])):a.filter(e=>e.slot===s&&e.code).map(e=>k(`${n(e.code)},`,i));c.length>0?o.push(...c):o.at(-1)?.trimEnd().endsWith(`[`)&&r[e+1]?.trim().startsWith(`]`)&&(o.pop(),e++)}return o.join(`
 `)}function k(e,t){return e.split(`
 `).map(e=>e&&t+e).join(`
@@ -106,10 +106,10 @@ CMD ["node", "dist/index.js"]
 `),console.log(q(a).replace(/^/gm,`    `)),console.log())}}x?console.log(`  Done!
 `):(console.log(`  Finished with errors — the install above did not complete.
 `),process.exitCode=1)})}const Be=a(b(import.meta.url));function Ve(e){return{kick:r(e,`kick`),runDev:n(e,`dev`),runBuild:n(e,`build`),runStart:n(e,`start`),runTest:n(e,`test`)}}const He=JSON.parse(d([o(Be,`..`,`package.json`),o(Be,`..`,`..`,`package.json`)].find(u),`utf-8`)),Ue=[`@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`,`@forinda/kickjs-inertia`,`@forinda/kickjs-storage`],We={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`},"@inertiajs/react":{fallback:`^3.9.0`,cap:`^3`},"@inertiajs/core":{fallback:`^3.9.0`,cap:`^3`},"@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:`^2.0.2`,cap:`^2`},"serve-static":{fallback:`^2.2.0`,cap:`^2`},zod:{fallback:`^4.3.6`,cap:`^4`},valibot:{fallback:`^1.4.1`,cap:`^1`},"@valibot/to-json-schema":{fallback:`^1.8.0`,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 Ge(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 Ke(e){return e===`@forinda/kickjs-cli`?`^${He.version}`:`latest`}async function qe(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 Je(){let e=[...Ue.map(e=>({name:e,fallback:Ke(e),cap:void 0})),...Object.entries(We).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await qe(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=Ge(await ue(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Ye(e,t){let n=B(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function Xe(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function Ze(e,t){let n=e=>Xe(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 Qe(e,t,n){let r=B(`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 $e(t){let{name:i,directory:a,packageManager:s=`pnpm`,template:c=`rest`,defaultRepo:l=`inmemory`,packages:d=[],schemaLib:f=`zod`,runtime:p=`express`}=t,m=a,h=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${i}\n`),t.versions||h(`Resolving package versions...`);let g=t.versions??await Je(),v=Object.keys(g).filter(e=>g[e]===`latest`);if(v.length>0&&h(`WARNING: could not reach npm for ${v.join(`, `)} — pinned to 'latest'`),p!==`express`){if(Qe(`@forinda/kickjs`,`latest`,`./${p}`))h(`Using @forinda/kickjs@latest (stable ships the ${p} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Ye(r,`alpha`);e&&Ze(e,Xe(g[r]))&&(g[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}h(n?`Using the alpha channel for the ${p} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${p} runtime subpath may be missing. After install, run: ${s} add @forinda/kickjs@alpha`)}}let b=d.filter(e=>!u(o(w,`feature-${e}`)));b.length>0&&h(`WARNING: skipping unknown package(s): ${b.join(`, `)} — add them later with kick add`);let x=E([...tt({template:c,runtime:p,schemaLib:f,packages:d}),...t.platformConfig===!1?[]:[`host-config`],...t.extraLayers??[]],{vars:{name:i,version:He.version},extra:[{slot:`repo`,code:l===`inmemory`?`repo: 'inmemory'`:`repo: { name: '${l.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}' }`},...t.spaClientDir?[et(t.spaClientDir)]:[]]}),S=t.platformConfig===!1?void 0:N(s);await e(o(m,`package.json`),te(i,g,x,S));let C=F(s,S);C&&await e(o(m,`.yarnrc.yml`),C);let T=ee(x.files,{name:i,template:c,runtime:p,packageManager:s,...Ve(s),netlifyPublish:c===`inertia`?`dist/client`:`dist/public`,templateLabel:{rest:`REST API`,minimal:`Minimal`,inertia:`Inertia (React)`}[c],sessionSecret:y(32).toString(`hex`),packages:[...x.dependencies,...x.devDependencies].filter(e=>e.startsWith(`@forinda/`)).map(e=>`- \`${e}\``).join(`
-`)});for(let[t,n]of T)await e(o(m,t),n);if(t.platformConfig!==!1){let t=c===`inertia`?`inertia`:`api`;await e(o(m,`Dockerfile`),ie(t,s,i,S)),await e(o(m,`.dockerignore`),ae())}let{generateAgentDocs:D}=await import(`./agent-docs-TdQs75ND.mjs`).then(e=>e.t);await D({outDir:m,name:i,pm:s,template:c,only:`all`,force:!0});let O={...Pe,...Ie(d),...x.builds};if(t.approveInstallScripts!==!1&&$(s,m,O),t.installDeps){console.log(`\n  Installing dependencies with ${s}...\n`);try{_(`${s} install`,{cwd:m,stdio:`inherit`}),console.log(`
-  Dependencies installed successfully!`)}catch{console.log(`\n  Warning: ${s} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-Cj5lp0gl.mjs`).then(e=>e.n);await e({cwd:m,allowDuplicates:!0,silent:!0})}catch{}if(t.initGit)try{_(`git init`,{cwd:m,stdio:`pipe`}),_(`git branch -M main`,{cwd:m,stdio:`pipe`}),_(`git add -A`,{cwd:m,stdio:`pipe`}),_(`git commit -m "chore: initial commit from kick new"`,{cwd:m,stdio:`pipe`}),h(`Git repository initialized`)}catch{h(`Warning: git init failed (git may not be installed)`)}console.log(`
+`)});for(let[t,n]of T)await e(o(m,t),n);if(t.platformConfig!==!1){let t=c===`inertia`?`inertia`:`api`;await e(o(m,`Dockerfile`),ie(t,s,i,S)),await e(o(m,`.dockerignore`),ae())}let{generateAgentDocs:D}=await import(`./agent-docs-ZgfnGL-j.mjs`).then(e=>e.t);await D({outDir:m,name:i,pm:s,template:c,only:`all`,force:!0});let O={...Pe,...Ie(d),...x.builds};if(t.approveInstallScripts!==!1&&$(s,m,O),t.installDeps){console.log(`\n  Installing dependencies with ${s}...\n`);try{_(`${s} install`,{cwd:m,stdio:`inherit`}),console.log(`
+  Dependencies installed successfully!`)}catch{console.log(`\n  Warning: ${s} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-DSaawXaQ.mjs`).then(e=>e.n);await e({cwd:m,allowDuplicates:!0,silent:!0})}catch{}if(t.initGit)try{_(`git init`,{cwd:m,stdio:`pipe`}),_(`git branch -M main`,{cwd:m,stdio:`pipe`}),_(`git add -A`,{cwd:m,stdio:`pipe`}),_(`git commit -m "chore: initial commit from kick new"`,{cwd:m,stdio:`pipe`}),h(`Git repository initialized`)}catch{h(`Warning: git init failed (git may not be installed)`)}console.log(`
   Project scaffolded successfully!`),console.log();let k=m!==process.cwd();h(`Next steps:`),k&&h(`  cd ${i}`),t.installDeps||h(`  ${s} install`);let A=r(s,`kick`),j={rest:`${A} g module user`,minimal:`# add your routes to src/index.ts`,inertia:`# pages: src/modules/pages + src/client/pages`};h(`  ${j[c]??j.rest}`),h(`  ${n(s,`dev`)}`);let M=e=>{let t=Math.max(...e.map(([e])=>e.length))+2;for(let[n,r]of e)h(`  ${n.padEnd(t)}${r}`)};return h(``),h(`Commands:`),M([[n(s,`dev`),`Start dev server with Vite HMR`],[n(s,`build`),`Production build via Vite`],[n(s,`start`),`Run production build`]]),h(``),h(`Generators:`),M([[`${A} g module <name>`,`REST module (controller, service, DTOs, repository)`],[`${A} g scaffold <n> <f..>`,`CRUD module from field definitions`],[`${A} g controller <name>`,`Standalone controller`],[`${A} g service <name>`,`@Service() class`],[`${A} g middleware <name>`,`Global connect-style middleware`],[`${A} g guard <name>`,`Route guard (auth, roles, etc.)`],[`${A} g adapter <name>`,`AppAdapter with lifecycle hooks`],[`${A} g dto <name>`,`DTO schema (Zod / Valibot / Yup)`],[`${A} g config`,`Generate kick.config.ts`]]),h(``),h(`Add packages:`),M([[`${A} add <pkg>`,`Install a KickJS package + peers`],[`${A} add --list`,`Show all available packages`]]),h(``),h(`Available: ${Oe}`),h(``),{builds:O}}function et(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 tt(e){return[`base`,`template-${e.template}`,`runtime-${e.runtime}`,`schema-${e.schemaLib}`,...e.packages.filter(e=>u(o(w,`feature-${e}`))).map(e=>`feature-${e}`)]}export{$ as a,Q as c,ie as d,ae as f,E as g,ee as h,X as i,ce as l,F as m,Je as n,ze as o,N as p,J as r,Re as s,$e as t,le as u};
-//# sourceMappingURL=project-fa9FRWXx.mjs.map
+//# sourceMappingURL=project-C98JovY4.mjs.map