@forinda/kickjs-cli 8.10.0 → 8.10.1

package/dist/fullstack-BlNhq-tI.mjs.map

@@ -0,0 +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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"}

package/dist/fullstack-Zk31eUT1.mjs

@@ -0,0 +1,99 @@
+/**
+ * @forinda/kickjs-cli v8.10.1
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import{a as e,d as t,f as n,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:
+  - 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(`
+  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   | What                                                              |
+| --------- | ----------------------------------------------------------------- |
+| \`server/\` | KickJS API (decorators, DI, \`kick dev\` with typegen watch)       |
+| \`web/\`    | Vite + React, typed against the API via \`@forinda/kickjs-client\` |
+
+## Develop
+
+\`\`\`bash
+${t} install
+${t===`pnpm`?`pnpm dev            # server (kick dev) + web (vite), in parallel`:`${t} run dev:server   # terminal 1\n${t} run dev:web      # terminal 2`}
+\`\`\`
+
+Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \`/api\`).
+
+From this root: \`${d(t,`test`)}\` (the server's tests), \`${d(t,`typecheck`)}\` (both packages),
+\`${d(t,`format`)}\` and \`${d(t,`build`)}\`. The \`kick\` CLI itself runs in \`server/\`, which holds
+\`kick.config.ts\`: \`cd server && ${u(t,`kick`)} typegen\`.
+
+## The type loop
+
+1. Server handlers **return** their payloads (\`return this.service.greet(...)\`).
+2. \`kick typegen\` emits \`server/.kickjs/types/kick__client.d.ts\` — the flat
+   route map with every response type resolved to a literal shape.
+3. \`web/tsconfig.json\` lists that file in \`types\`, so \`KickClientApi\` is
+   ambient — no import, no bridge file.
+4. \`web/src/api.ts\`'s \`createClient<KickClientApi.Api>\` types every call site.
+
+Because the map holds resolved types rather than references to controllers,
+\`web\` never compiles server source: no \`experimentalDecorators\`, no path
+aliases into \`server/src\`.
+
+Rename a field in \`server/src/modules/hello/hello.service.ts\` → \`web/src/App.tsx\`
+stops compiling. That's the point.
+
+### Keeping the map fresh
+
+\`server/.kickjs/types/kick__client.d.ts\` is generated, and \`web\` reads it as
+an ambient type package. Two things follow.
+
+**\`kick dev\` writes it at startup, not on save.** Resolving it builds a whole TypeScript
+program over the server, which is a build-step cost rather than a per-save one,
+so a renamed response field surfaces on the next \`kick typegen\` rather than on
+save. Everything else in \`.kickjs/types\` still updates on save. Add
+\`kick typegen --check\` to CI and a stale map fails the build.
+
+**It needs a compiler API.** TypeScript 7 ships none, so \`server\` depends on
+\`@typescript/typescript6\`. Remove it and typegen skips this one file, saying
+so; \`web\` then reports \`TS2688\` because the file it lists in \`types\` is gone.
+
+### The other way to wire it
+
+A \`types\` entry says "this is a global type package", which is what the map is,
+and it fails loudly when the file is missing. If you would rather it be quiet
+when absent — say, a repo where the map is not always generated — use
+\`include\` instead:
+
+\`\`\`json
+{ "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] }
+\`\`\`
+
+That tolerates the file not existing, at the cost of \`KickClientApi\` silently
+not resolving. Note \`types\` replaces TypeScript's automatic \`@types\`
+inclusion, so if you add entries there, list the ones you rely on too
+(\`"types": ["node", "../server/.kickjs/types/kick__client"]\`).
+
+Or skip the global entirely — the same file exports the type:
+
+\`\`\`ts
+import type { Api } from '../../server/.kickjs/types/kick__client'
+
+export const api = createClient<Api>({ baseUrl: '/api/v1' })
+\`\`\`
+
+Docs: https://kickjs.app/guide/typed-client.html
+`;if(n!==`vite`)return r;let i=r.indexOf(`## The type loop`);return`${r.slice(0,i).replace("Vite + React, typed against the API via `@forinda/kickjs-client`",`create-vite scaffold — unwired (see below)                       `).replace(" (Vite proxies `/api`)",``)}## Wiring web/ to the API
+
+\`web/\` is whatever create-vite scaffolded; nothing connects it to the API yet.
+Four steps — typed client, \`/api\` dev proxy, route-map types, \`src/api.ts\`:
+
+${h}
+`}export{_ as DEFAULT_VITE_TEMPLATE,g as VITE_TEMPLATES,y as initFullstackProject};

package/dist/index.d.mts.map

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

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.0
+ * @forinda/kickjs-cli v8.10.1
  *
  * 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-C-VSGhJ6.mjs";import{t as v}from"./project-D7x753R7.mjs";import{o as y,r as b}from"./config-B7ZUrOl6.mjs";import{t as x}from"./project-root-DO7MsZOq.mjs";import{n as S,t as C}from"./types-C2QNIHnD.mjs";export{C as KickPluginConflictError,a as TYPEGEN_OWNER_KEY,p as buildGeneratorContext,u as createTypegenDevWatcher,S as defineCliPlugin,b as defineConfig,g as defineDoctorCheck,f as defineDoctorExtension,h as defineGenerator,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,v 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-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};

package/dist/package-manager-BUDLqU4F.mjs

@@ -0,0 +1,12 @@
+/**
+ * @forinda/kickjs-cli v8.10.1
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import{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

package/dist/package-manager-BUDLqU4F.mjs.map

@@ -0,0 +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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"}

package/dist/package-manager-Bk2uiXkV.mjs

@@ -0,0 +1,11 @@
+/**
+ * @forinda/kickjs-cli v8.10.1
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import{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};

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

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

package/dist/{plugin-BpfANLIW.mjs → plugin-FOqPjQ0u.mjs}

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

package/dist/project-BBiJ64ya.mjs

@@ -0,0 +1,114 @@
+/**
+ * @forinda/kickjs-cli v8.10.1
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import{o as e,r as t,u as n}from"./config-CVuSVUvw.mjs";import{o as r,r as i}from"./package-manager-Bk2uiXkV.mjs";import{existsSync as a,readFileSync as o,readdirSync as s,statSync as c,writeFileSync as l}from"node:fs";import{dirname as u,join as d,posix as f,resolve as p,sep as m}from"node:path";import{fileURLToPath as h}from"node:url";import{execFile as g,execFileSync as _,execSync as v,spawnSync as y}from"node:child_process";import{promisify as b}from"node:util";import{randomBytes as x}from"node:crypto";import{parseSync as S}from"oxc-parser";const C=b(g),w=/[&|<>^"'`(){}[\];!%\r\n\\]/;function T(e,t,n=process.platform){if(n!==`win32`)return[e,t];if(w.test(e)||t.some(e=>w.test(e)))return null;let r=[e,...t].map(e=>e.includes(` `)?`"${e}"`:e).join(` `);return[process.env.ComSpec||`cmd.exe`,[`/d`,`/s`,`/c`,r]]}function E(e,t,n={}){let r=T(e,t);if(!r)return null;try{return _(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,stdio:[`ignore`,`pipe`,`ignore`],windowsHide:!0}).toString().trim()||null}catch{return null}}function D(e,t,n={}){let r=T(e,t);if(!r)throw Error(`Refusing to run '${e}': unsafe arguments`);_(r[0],r[1],{cwd:n.cwd,stdio:`inherit`,windowsHide:!0})}function O(e,t,n){v(e,{cwd:t,stdio:`inherit`,env:n?{...process.env,...n}:process.env})}function k(e,t,n){let r=y(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function A(e,t,n={}){let r=T(e,t);if(!r)return null;try{let{stdout:e}=await C(r[0],r[1],{encoding:`utf-8`,timeout:n.timeout??5e3,cwd:n.cwd,windowsHide:!0});return e.toString().trim()||null}catch{return null}}const j=u(h(import.meta.url)),M=[d(j,`..`,`templates`),d(j,`..`,`..`,`templates`)].find(e=>a(d(e,`base`)));function ee(e){return e.split(`/`).map(e=>e.startsWith(`_dot_`)?`.${e.slice(5)}`:e).join(`/`)}function N(e,t={}){let n=t.templatesDir??M,r=/* @__PURE__ */ new Map,i=[],l=[],u={},f=[],p={};for(let t of e){let e=d(n,t);if(!a(e))throw Error(`Unknown scaffold layer "${t}" (${e})`);let h=d(e,`feature.json`);if(a(h)){let e=JSON.parse(o(h,`utf-8`));i.push(...e.dependencies??[]),l.push(...e.devDependencies??[]),Object.assign(u,e.builds),f.push(...e.integrations??[]),Object.assign(p,e.scripts)}let g=d(e,`files`);if(a(g))for(let e of s(g,{recursive:!0,encoding:`utf-8`}).toSorted()){let t=d(g,e);if(!c(t).isFile())continue;let n=o(t,`utf-8`),i=ee(e.split(m).join(`/`));if(i.endsWith(`.append`)){let e=i.slice(0,-7);r.set(e,(r.get(e)??``)+n)}else r.set(i,n)}}f.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,te(t,f,g));return{files:r,dependencies:[...new Set(i)],devDependencies:[...new Set(l)],builds:u,integrations:f,scripts:p}}function P(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 F=/^([ \t]*)\/\/ @kick:([\w-]+)[ \t]*$/;function te(e,t,n=e=>e){let r=e.split(`
+`),i=new Set(r.map(e=>F.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=F.exec(r[e]);if(!t){o.push(r[e]);continue}let[,i,s]=t,c=s===`imports`?re(a.flatMap(e=>e.import?[e.import]:[])):a.filter(e=>e.slot===s&&e.code).map(e=>ne(`${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 ne(e,t){return e.split(`
+`).map(e=>e&&t+e).join(`
+`)}function re(e){let t=/* @__PURE__ */ new Map;for(let n of e){let e=t.get(n.from)??{names:[]};e.default??=n.default;for(let t of n.names??[])e.names.includes(t)||e.names.push(t);t.set(n.from,e)}return[...t].map(([e,{names:t,default:n}])=>{let r=`import ${[n,t.length?`{ ${t.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e}'`;return r.length<=100||t.length===0?r:`import ${n?`${n}, `:``}{\n${t.map(e=>`  ${e},`).join(`
+`)}\n} from '${e}'`})}function ie(e,t){let n=e[t];if(!n)throw Error(`generatePackageJson: missing resolved version for ${t}. Add it to SIBLING_PACKAGES or THIRD_PARTY_PACKAGES in generators/project.ts.`);return n}function ae(e,t){return Object.fromEntries(e.toSorted().map(e=>[e,ie(t,e)]))}function oe(e){try{let t=_(e,[`--version`],{encoding:`utf-8`,stdio:[`ignore`,`pipe`,`ignore`],timeout:1e4}).trim();return/^\d+\.\d+\.\d+$/.test(t)?`${e}@${t}`:void 0}catch{return}}function I(e){let t=e?.match(/@(\d+)\.(\d+)\./);return t?[Number(t[1]),Number(t[2])]:void 0}function L(e,t){let n=I(t)?.[0];return e===`yarn`&&n!==void 0&&n>=2?`nodeLinker: node-modules
+`:void 0}function se(e,t,n,r){return JSON.stringify({name:e,...r?{packageManager:r}:{},version:`0.0.0`,type:`module`,scripts:{dev:`kick dev`,build:`kick build`,start:`kick start`,test:`vitest run --passWithNoTests`,"build:netlify":`kick build && kick build:netlify`,"build:vercel":`kick build && kick build:vercel`,...n.scripts},dependencies:ae(n.dependencies,t),devDependencies:ae(n.devDependencies,t)},null,2)}function ce(e,t){let n=Object.entries(t);if(n.length===0)return e;let r=e===``?[]:e.replace(/\n$/,``).split(`
+`),i=e=>e.trim().replace(/^['"]|['"]$/g,``),a=e=>/^[\w-]+$/.test(e)?e:`'${e}'`,o=(e,t)=>{let n=r.findIndex(t=>t.replace(/\s+$/,``)===`${e}:`);if(n===-1){if(!t)return;r.length>0&&r[r.length-1]!==``&&r.push(``),r.push(`${e}:`),n=r.length-1}let i=n+1;for(let e=n+1;e<r.length&&/^(\s|$)/.test(r[e]);e++)r[e].trim()!==``&&(i=e+1);return{start:n,end:i}},s=[];for(let[e,t]of n){let{start:n,end:c}=o(`allowBuilds`,!0),l=r.slice(n+1,c).findIndex(t=>i(t.split(`:`)[0])===e),u=l===-1?void 0:/:\s*(true|false)\s*$/.exec(r[n+1+l]);if(u){s.push([e,u[1]===`true`]);continue}let d=`  ${a(e)}: ${t}`;l===-1?r.splice(c,0,d):r[n+1+l]=d,s.push([e,t])}let c=[`onlyBuiltDependencies`,`ignoredBuiltDependencies`];for(let[e,t]of s){if(c.some(t=>{let n=o(t,!1);return n!==void 0&&r.slice(n.start+1,n.end).some(t=>i(t.replace(/^\s*-/,``))===e)}))continue;let{end:n}=o(t?c[0]:c[1],!0);r.splice(n,0,`  - ${a(e)}`)}return`${r.join(`
+`)}\n`}const R=`node:22-slim`,z={pnpm:{lockfile:`pnpm-lock.yaml`,installFiles:[`pnpm-workspace.yaml`],install:`pnpm install --frozen-lockfile`,installProd:`pnpm install --prod --frozen-lockfile`,run:e=>`pnpm run ${e}`,image:R,setup:`RUN corepack enable`},npm:{lockfile:`package-lock.json`,installFiles:[],install:`npm ci`,installProd:`npm ci --omit=dev`,run:e=>`npm run ${e}`,image:R},yarn:{lockfile:`yarn.lock`,installFiles:[],install:`yarn install --frozen-lockfile`,installProd:`yarn install --production --frozen-lockfile`,run:e=>`yarn run ${e}`,image:R,setup:`RUN corepack enable`},bun:{lockfile:`bun.lock`,installFiles:[],install:`bun install --frozen-lockfile`,installProd:`bun install --production --frozen-lockfile`,run:e=>`bun run ${e}`,image:`oven/bun:1`}},B={lockfile:`yarn.lock`,installFiles:[`.yarnrc.yml`],install:`yarn install --immutable`,installProd:`yarn workspaces focus --all --production`,run:e=>`yarn run ${e}`,image:R,setup:`RUN corepack enable`},le={api:`docker run -p 3000:3000 <name>`,inertia:`docker run -p 3000:3000 -e SESSION_SECRET=<a long random string> <name>`,fullstack:`docker run -p 3000:3000 <name>`};function V(e,t,n,r){let[i=0,a=0]=I(r)??[],o=t===`yarn`&&i>=2?i>=4?B:{...B,installProd:B.install}:t===`bun`&&r&&(i<1||i===1&&a<2)?{...z.bun,lockfile:`bun.lockb`}:z[t],s=o.setup?`\n${o.setup}`:``,c=(e===`fullstack`?[`package.json`,o.lockfile,...o.installFiles,`server/package.json`,`web/package.json`]:[`package.json`,o.lockfile,...o.installFiles]).map(e=>`COPY ${e} ./${e.includes(`/`)?e.slice(0,e.lastIndexOf(`/`)+1):``}`).join(`
+`),l=`# syntax=docker/dockerfile:1
+# ${n} — the long-running server in one image.
+#
+#   docker build -t ${n} .
+#   ${le[e].replace(`<name>`,n)}
+#
+# Environment comes from the platform or \`docker run\`; .env files are not
+# copied into the image. The lockfile must be committed — installs are frozen.
+`;if(e===`fullstack`)return`${l}
+FROM ${o.image} AS base
+WORKDIR /app${s}
+
+# Production dependencies of every workspace member.
+FROM base AS deps
+${c}
+RUN ${o.installProd}
+# Hoisting may leave a member without its own node_modules; the runtime copies both.
+RUN mkdir -p node_modules server/node_modules
+
+# The server bundle and the built web app.
+FROM base AS build
+${c}
+RUN ${o.install}
+COPY . .
+RUN ${o.run(`build`)}
+
+FROM ${R}
+ENV NODE_ENV=production PORT=3000
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY --from=deps /app/server/node_modules ./server/node_modules
+COPY --from=build /app/package.json ./
+COPY --from=build /app/server/package.json ./server/
+COPY --from=build /app/server/dist ./server/dist
+# SpaAdapter serves ../web/dist relative to the server.
+COPY --from=build /app/web/dist ./web/dist
+WORKDIR /app/server
+USER node
+EXPOSE 3000
+CMD ["node", "dist/index.js"]
+`;let u=e===`inertia`?`# The server, the pages (dist/client) and the SSR bundle (dist/ssr).`:`# The server bundle.`;return`${l}
+FROM ${o.image} AS base
+WORKDIR /app${s}
+
+FROM base AS deps
+${c}
+RUN ${o.installProd}
+
+${u}
+FROM base AS build
+${c}
+RUN ${o.install}
+COPY . .
+RUN ${o.run(`build`)}
+
+FROM ${R}
+ENV NODE_ENV=production PORT=3000
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY --from=build /app/package.json ./
+COPY --from=build /app/dist ./dist
+USER node
+EXPOSE 3000
+CMD ["node", "dist/index.js"]
+`}function H(){return`${[`# Rebuilt inside the image.`,`**/node_modules`,`**/dist`,`**/.kickjs`,`# Secrets stay out of the image; pass them at run time.`,`**/.env`,`**/.env.*`,`!**/.env.example`,`# Platform and tooling output.`,`.netlify`,`.vercel`,`.git`,`**/coverage`,`*.log`].join(`
+`)}\n`}const ue={adapter:`adapters`,middleware:`middlewares`};function de(e,t,n=e=>e,r=`src/index.ts`){let i={source:e,added:[],present:[],manual:[]};for(let e of t){if(!e.slot||!e.code)continue;let t=ue[e.slot],a=n(e.code),o=me(a),s=S(r,i.source).program,c=t?fe(s):void 0;if(!c){i.manual.push({...e,code:a});continue}let l=c.properties.find(e=>e.type===`Property`&&(e.key?.name??e.key?.value)===t);if(l&&l.value.type!==`ArrayExpression`){i.manual.push({...e,code:a});continue}let u=o&&e.import?pe(s,e.import.from,o):o;l&&u&&i.source.slice(l.value.start,l.value.end).includes(`${u}(`)?i.present.push(o??U(a)):(i.source=l?he(i.source,l.value,a):ge(i.source,c,t,a),e.import&&(i.source=_e(i.source,e.import,r)),i.added.push(o??U(a)))}return i}function fe(e){let t,n=e=>{if(t||!e||typeof e!=`object`)return;if(Array.isArray(e))return e.forEach(n);let r=e;if(r.type===`CallExpression`&&r.callee?.type===`Identifier`&&r.callee.name===`bootstrap`&&r.arguments?.[0]?.type===`ObjectExpression`)t=r.arguments[0];else for(let e in r)n(r[e])};return n(e),t}function pe(e,t,n){for(let r of e.body)if(r.type===`ImportDeclaration`&&r.source.value===t)for(let e of r.specifiers){let t=e.imported?.name??e.imported?.value;if(e.type===`ImportSpecifier`&&t===n)return e.local.name}return n}function me(e){let t=e.split(`
+`).find(e=>e.trim()&&!e.trim().startsWith(`//`));return/^\s*([A-Za-z_$][\w$.]*)\s*\(/.exec(t??``)?.[1]}const U=e=>e.split(`
+`).find(e=>e.trim()&&!e.trim().startsWith(`//`))?.trim()??e,W=(e,t)=>/^[ \t]*/.exec(e.slice(e.lastIndexOf(`
+`,t-1)+1))[0],G=(e,t)=>e.split(`
+`).map(e=>e&&t+e).join(`
+`);function he(e,t,n){let r=t.elements.filter(Boolean),i=W(e,t.start);if(r.length===0){let r=G(`${n},`,`${i}  `);return`${e.slice(0,t.start)}[\n${r}\n${i}]${e.slice(t.end)}`}let a=r.at(-1),o=W(e,a.start),s=e.slice(a.end,t.end-1).match(/^\s*,/),c=s?a.end+s[0].length:a.end,l=`\n${G(`${n},`,o)}`;return s?e.slice(0,c)+l+e.slice(c):`${e.slice(0,c)},${l.replace(/,$/,``)}${e.slice(c)}`}function ge(e,t,n,r){let i=t.properties.at(-1),a=i?W(e,i.start):`${W(e,t.start)}  `,o=`${a}${n}: [\n${G(`${r},`,`${a}  `)}\n${a}],`;if(!i)return`${e.slice(0,t.start)}{\n${o}\n${W(e,t.start)}}${e.slice(t.end)}`;let s=e.slice(i.end,t.end-1).match(/^\s*,/),c=s?i.end+s[0].length:i.end;return`${e.slice(0,c)}${s?``:`,`}\n${o}${e.slice(c)}`}function _e(e,t,n=`src/index.ts`){let r=S(n,e).program.body.filter(e=>e.type===`ImportDeclaration`),i=r.find(e=>e.source.value===t.from&&e.importKind!==`type`&&e.specifiers.length>0&&!e.specifiers.some(e=>e.type===`ImportNamespaceSpecifier`)),a=t.names??[];if(i){let t=new Set(i.specifiers.map(e=>e.local?.name)),n=a.filter(e=>!t.has(e));if(n.length===0)return e;let r=i.specifiers.filter(e=>e.type===`ImportSpecifier`);if(r.length>0){let t=r.at(-1).end;return`${e.slice(0,t)}, ${n.join(`, `)}${e.slice(t)}`}let o=i.specifiers[0];return`${e.slice(0,o.end)}, { ${n.join(`, `)} }${e.slice(o.end)}`}let o=`import ${[t.default,a.length?`{ ${a.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${t.from}'`,s=r.at(-1);return s?`${e.slice(0,s.end)}\n${o}${e.slice(s.end)}`:`${o}\n${e}`}const ve={swagger:`feature-swagger`,devtools:`feature-devtools`,ws:`feature-ws`,queue:`feature-queue`,"queue:bullmq":`feature-queue`,storage:`feature-storage`};function ye(e){let t=[...new Set(e.map(e=>ve[e]).filter(Boolean))];return t.length>0?N(t):void 0}function be(e,t){return(t?[t]:[`src/index.ts`,`src/main.ts`]).find(t=>a(d(e,t)))}function xe(e,t){try{return _(`git`,[`status`,`--porcelain`,`--`,...t],{cwd:e,encoding:`utf-8`,stdio:[`ignore`,`pipe`,`ignore`]}).split(`
+`).filter(Boolean).map(e=>e.slice(3))}catch{return[]}}const K=/\.(?:[cm]?[jt]sx?)$/;function Se(e,t){return[...t].filter(([t,n])=>{let r=d(e,t);return K.test(t)&&a(r)&&o(r,`utf-8`)!==n}).map(([e])=>e)}async function Ce(e,t){let n=[];for(let[i,s]of t){let t=d(e,i);if(!a(t)){await r(t,s),n.push(i);continue}if(K.test(i))continue;let c=o(t,`utf-8`),l=new Set(c.split(`
+`).map(e=>q(e)??e)),u=s.split(`
+`).filter(e=>e.trim()&&!l.has(q(e)??e));if(u.length===0)continue;let f=c===``||c.endsWith(`
+`)?``:`
+`;await r(t,`${c}${f}${u.join(`
+`)}\n`),n.push(i)}return n}function we(e,t,n){let r=e.import?.from;if(!r?.startsWith(`.`))return!1;let i=f.join(f.dirname(t.replaceAll(`\\`,`/`)),r);return n.some(e=>e.replace(K,``)===i)}const q=e=>/^\s*([A-Za-z_][\w]*)\s*=/.exec(e)?.[1];async function Te(e,t,n){let i=d(e,t),a=o(i,`utf-8`),s=de(a,n,J(e),t);return s.source!==a&&await r(i,s.source),s}function J(e){let t=Ee(e),n={name:String(t.name??`app`),version:String(t.version??`0.0.0`)};return e=>e.replace(/\{\{(\w+)\}\}/g,(e,t)=>n[t]??e)}function Ee(e){try{return JSON.parse(o(d(e,`package.json`),`utf-8`))}catch{return{}}}function De(e){let t=e.flatMap(e=>e.import?[e.import]:[]).map(e=>`import ${[e.default,e.names?.length?`{ ${e.names.join(`, `)} }`:void 0].filter(Boolean).join(`, `)} from '${e.from}'`),n=e.map(e=>`${e.code},`);return[...t,``,`// in bootstrap({ adapters: [ ... ] }):`,...n].join(`
+`)}const Y={kickjs:{pkg:`@forinda/kickjs`,peers:[],enginePeers:!0,description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},zod:{pkg:`zod`,peers:[],description:`Zod schema validation (env, DTOs, OpenAPI) — wrap with fromZod()`},valibot:{pkg:`valibot`,peers:[],description:`Valibot schema validation — wrap with fromValibot()`},yup:{pkg:`yup`,peers:[],description:`Yup schema validation — wrap with fromYup()`},ai:{pkg:`@forinda/kickjs-ai`,peers:[`zod`],description:`AI toolkit — LLM providers, tool definitions from controllers`},storage:{pkg:`@forinda/kickjs-storage`,peers:[],description:`File storage — memory, disk, S3-compatible buckets, signed URLs`},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`,builds:{"@scarf/scarf":!0}},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},pg:{pkg:`@forinda/kickjs-db`,peers:[`pg`],typePeers:[`@types/pg`],description:`kick/db + PostgreSQL driver (use @forinda/kickjs-db/pg)`},sqlite:{pkg:`@forinda/kickjs-db`,peers:[`better-sqlite3`],builds:{"better-sqlite3":!0},typePeers:[`@types/better-sqlite3`],description:`kick/db + SQLite driver (use @forinda/kickjs-db/sqlite)`},mysql:{pkg:`@forinda/kickjs-db`,peers:[`mysql2`],description:`kick/db + MySQL driver (use @forinda/kickjs-db/mysql)`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`ws`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],builds:{"msgpackr-extract":!1},description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},"queue:redis-pubsub":{pkg:`@forinda/kickjs-queue`,peers:[`ioredis`],description:`Lightweight pub/sub via Redis (no persistence)`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/server`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}},Oe=Object.entries(Y).filter(([e,t])=>!t.core&&!t.deprecated&&!e.includes(`:`)&&![`pg`,`sqlite`,`mysql`,`zod`,`valibot`,`yup`].includes(e)).map(([e])=>e).join(`, `),ke={express:[`express`],fastify:[`fastify`,`@fastify/middie`,`serve-static`],h3:[`h3@^2`,`serve-static`]},Ae={express:{prod:`multer`,dev:`@types/multer`,note:`Express uploads use multer (memory/disk storage, ctx.file / ctx.files).`},fastify:{prod:`@fastify/multipart`,note:`Fastify uploads use @fastify/multipart (buffered into ctx.file / ctx.files).`},h3:{note:`h3 parses multipart natively (readMultipartFormData) — no driver to install.`}};function X(e){if(e!==void 0){if(e===`express`||e===`fastify`||e===`h3`)return e;throw Error(`Invalid --runtime '${String(e)}'. Expected express, fastify or h3.`)}}async function Z(e=process.cwd()){return(await je(e)).runtime}async function je(t=process.cwd()){let n=(await e(t))?.runtime;return n===`express`||n===`fastify`||n===`h3`?{runtime:n,candidates:[n],ambiguous:!1,fromConfig:!0}:{...Ne(t),fromConfig:!1}}const Me=[[`express`,`express`],[`fastify`,`fastify`],[`h3`,`h3`]];function Ne(e=process.cwd()){let t=Pe(`package.json`,e);if(!t)return{runtime:`express`,candidates:[],ambiguous:!1};let n={},r={};try{let e=JSON.parse(o(p(t,`package.json`),`utf-8`));n=e.dependencies??{},r=e.devDependencies??{}}catch{return{runtime:`express`,candidates:[],ambiguous:!1}}let i=Me.filter(([e])=>e in n).map(([,e])=>e),a=Me.filter(([e])=>e in r&&!(e in n)).map(([,e])=>e),s=[...i,...a];return i.length===1?{runtime:i[0],candidates:s,ambiguous:!1}:i.length===0&&a.length===1?{runtime:a[0],candidates:s,ambiguous:!1}:s.length===0?{runtime:`express`,candidates:s,ambiguous:!1}:{runtime:`express`,candidates:s,ambiguous:!0}}function Pe(e,t=process.cwd()){let n=t;for(;;){if(a(p(n,e)))return n;let t=u(n);if(t===n)return null;n=t}}function Fe(e=!1,t){let n=Object.entries(Y),r=Math.max(...n.map(([e])=>e.length)),i=n.filter(([,e])=>e.core),a=n.filter(([,e])=>!e.core),o=([e,n])=>{let i=e.padEnd(r+2),a=n.enginePeers?[...n.peers,...ke[t??`express`]]:n.peers,o=n.enginePeers?` [${t??`express`} engine]`:``,s=a.length?` (+ ${a.join(`, `)})${o}`:``,c=n.deprecated?` [DEPRECATED — ${n.deprecated}]`:``;return`    ${i} ${n.description}${s}${c}`};console.log(`
+  Core packages (always installed by \`kick new\`):
+`);for(let e of i)console.log(o(e));if(e){console.log(`
+  Optional packages (add as needed):
+`);for(let e of a)console.log(o(e))}else console.log(`\n  Plus ${a.length} optional packages (swagger, db, queue, …).`),console.log("  Run `kick add --list --all` for the full catalog.");console.log(`
+  Usage: kick add ai db swagger`),console.log(`         kick add queue:bullmq`),console.log(`         kick add upload   # installs the multipart driver for your runtime`),console.log()}const Ie={"@swc/core":!0,esbuild:!0};function Q(e,t,n){if(e===`pnpm`){let e=p(t,`pnpm-workspace.yaml`),r=a(e)?o(e,`utf-8`):``,i=ce(r,n);return i===r?void 0:(l(e,i),e)}if(e!==`npm`&&e!==`bun`)return;let r=p(t,`package.json`);if(!a(r))return;let i=JSON.parse(o(r,`utf-8`)),s=!1;if(e===`npm`){let e=i.allowScripts??{};for(let[t,r]of Object.entries(n))Object.keys(e).some(e=>e===t||e.startsWith(`${t}@`))||(e[t]=r,s=!0);i.allowScripts=e}else{let e=i.trustedDependencies??[];for(let[t,r]of Object.entries(n))r&&!e.includes(t)&&(e.push(t),s=!0);i.trustedDependencies=e}if(s)return l(r,`${JSON.stringify(i,null,2)}\n`),r}function Le(e){if(e===`pnpm`)return Pe(`pnpm-workspace.yaml`)??process.cwd();for(let e=process.cwd();;e=u(e)){try{if(JSON.parse(o(p(e,`package.json`),`utf-8`)).workspaces)return e}catch{}if(u(e)===e)return process.cwd()}}function $(e){return Object.assign({},...e.map(e=>Y[e]?.builds??{}))}function Re(e,t,n=`express`){let r=/* @__PURE__ */ new Set,i=/* @__PURE__ */ new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=Ae[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=Y[c];if(!e){a.push(c);continue}e.deprecated&&o.push(`'${c}' (${e.pkg}) is deprecated — ${e.deprecated}`);let l=t||e.dev?i:r;l.add(e.pkg);for(let t of e.peers)l.add(t);for(let t of e.typePeers??[])i.add(t);if(e.enginePeers){let e=ke[n];for(let t of e)l.add(t);s.push(`${c} (${n}): engine peers ${e.join(`, `)}`)}}return{prodDeps:[...r],devDeps:[...i],unknown:a,warnings:o,notices:s}}function ze(e){e.command(`list`).alias(`ls`).description(`List KickJS packages (core only; pair with --all for the full catalog)`).option(`--all`,`Include the full optional catalog`).option(`--runtime <engine>`,`HTTP engine to show peers for: express | fastify | h3`).action(async e=>{Fe(!!e.all,X(e.runtime)??await Z())})}function Be(e){e.command(`add [packages...]`).description(`Add KickJS packages with their required dependencies`).option(`--pm <manager>`,`Package manager override`).option(`-D, --dev`,`Install as dev dependency`).option(`--list`,`List packages (core only by default; pair with --all)`).option(`--runtime <engine>`,`HTTP engine for peer resolution: express | fastify | h3 (overrides kick.config.ts)`).option(`--all`,`When listing, include the full optional catalog`).option(`--no-wire`,`Install only — do not add adapters to the entry file or .env`).option(`--entry <file>`,`Entry file to wire (default: src/index.ts, then src/main.ts)`).option(`-f, --force`,`Wire even when the files it edits have uncommitted changes`).action(async(e,t)=>{if(t.list||e.length===0){Fe(!!t.all,X(t.runtime)??await Z());return}let{pm:n,source:r}=await i(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let o=X(t.runtime),s=await je(process.cwd()),c=o??s.runtime;if(!o&&s.ambiguous){console.error(`\n  Cannot tell which HTTP engine this app boots on: found ${s.candidates.join(`, `)} in package.json.\n\n  Installing engine peers for the wrong one is worse than not installing them, so:\n    • set \`runtime: '<engine>'\` in kick.config.ts (permanent, also fixes kick doctor), or\n    • pass --runtime <${s.candidates.join(`|`)}> for this command\n`),process.exitCode=1;return}let l=Re(e,!!t.dev,c),{unknown:u,warnings:d,notices:f}=l,{prodDeps:m,devDeps:h}=l,g=process.cwd();if(t.entry&&!a(p(g,t.entry))){console.error(`\n  --entry ${t.entry} does not exist.\n`),process.exitCode=1;return}let _=t.wire===!1?void 0:ye(e),y=_?be(g,t.entry):void 0;if(_){m=[.../* @__PURE__ */ new Set([...m,..._.dependencies])],h=[...new Set([...h,..._.devDependencies].filter(e=>!m.includes(e)))];let e=xe(g,[...y?[y]:[],..._.files.keys()]);if(e.length>0&&!t.force){console.error(`\n  ${e.join(`, `)} ${e.length===1?`has`:`have`} uncommitted changes, and kick add would edit ${e.length===1?`it`:`them`}.\n  Commit or stash first, pass --force to edit anyway, or --no-wire to install only.\n`),process.exitCode=1;return}}for(let e of d)console.warn(`\n  WARNING: ${e}`);for(let e of f)console.log(`\n  ${e}`);if(u.length>0&&(console.log(`\n  Unknown packages: ${u.join(`, `)}`),console.log(`  Run "kick add --list" to see available packages.
+`),m.length===0&&h.length===0))return;let b={...$(e),..._?.builds};if(Object.keys(b).length>0){let e=Q(n,Le(n),b);e&&console.log(`\n  Approved install scripts in ${e}`)}let x=!0;if(m.length>0){let e=m,t=`${n} add ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dependency(ies):`);for(let t of e)console.log(`    + ${t}`);console.log();try{v(t,{stdio:`inherit`})}catch{x=!1,console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(h.length>0){let e=h,t=`${n} add -D ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dev dependency(ies):`);for(let t of e)console.log(`    + ${t} (dev)`);console.log();try{v(t,{stdio:`inherit`})}catch{x=!1,console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(_){if(!x)console.log(`  Skipped wiring — the install did not finish.
+`);else{let e=Se(g,_.files);for(let e of await Ce(g,_.files))console.log(`  Updated ${e}`);let t=y?_.integrations.filter(t=>we(t,y,e)):[],n=_.integrations.filter(e=>!t.includes(e)),r=y?await Te(g,y,n):void 0;for(let e of r?.added??[])console.log(`  Added ${e} to ${y}`);for(let e of r?.present??[])console.log(`  ${e} is already in ${y}`);let i=J(g),a=r?r.manual:_.integrations.filter(e=>e.slot&&e.code).map(e=>({...e,code:i(e.code)}));if(e.length>0){let n=t.map(e=>({...e,code:i(e.code??``)}));console.log(`\n  ${e.join(`, `)} already exist${e.length===1?`s`:``} — left as ${e.length===1?`it is`:`they are`}. Merge in what the layer needs, then wire it yourself:
+`),console.log(`${De(n)}`.replace(/^/gm,`    `)),console.log()}a.length>0&&(console.log(`\n  ${y?`Could not find bootstrap({ adapters: [...] }) in ${y}`:`No entry file found`} — add this yourself:
+`),console.log(De(a).replace(/^/gm,`    `)),console.log())}}x?console.log(`  Done!
+`):(console.log(`  Finished with errors — the install above did not complete.
+`),process.exitCode=1)})}const Ve=u(h(import.meta.url));function He(e){return{kick:t(e,`kick`),runDev:n(e,`dev`),runBuild:n(e,`build`),runStart:n(e,`start`),runTest:n(e,`test`)}}const Ue=JSON.parse(o([d(Ve,`..`,`package.json`),d(Ve,`..`,`..`,`package.json`)].find(a),`utf-8`)),We=[`@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`],Ge={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 Ke(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 qe(e){return e===`@forinda/kickjs-cli`?`^${Ue.version}`:`latest`}async function Je(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 Ye(){let e=[...We.map(e=>({name:e,fallback:qe(e),cap:void 0})),...Object.entries(Ge).map(([e,t])=>({name:e,...t}))],t=Date.now()+2e4,n=await Je(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=Ke(await A(`npm`,r?[`view`,a,`version`,`--json`]:[`view`,a,`version`],{timeout:i}));return[e,o?`^${o}`:n]});return Object.fromEntries(n)}function Xe(e,t){let n=E(`npm`,[`view`,`${e}@${t}`,`version`],{timeout:2e4});return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}function Ze(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function Qe(e,t){let n=e=>Ze(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 $e(e,t,n){let r=E(`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 et(e){let{name:i,directory:o,packageManager:s=`pnpm`,template:c=`rest`,defaultRepo:l=`inmemory`,packages:u=[],schemaLib:f=`zod`,runtime:p=`express`}=e,m=o,h=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${i}\n`),e.versions||h(`Resolving package versions...`);let g=e.versions??await Ye(),_=Object.keys(g).filter(e=>g[e]===`latest`);if(_.length>0&&h(`WARNING: could not reach npm for ${_.join(`, `)} — pinned to 'latest'`),p!==`express`){if($e(`@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=Xe(r,`alpha`);e&&Qe(e,Ze(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 y=u.filter(e=>!a(d(M,`feature-${e}`)));y.length>0&&h(`WARNING: skipping unknown package(s): ${y.join(`, `)} — add them later with kick add`);let b=N([...nt({template:c,runtime:p,schemaLib:f,packages:u}),...e.platformConfig===!1?[]:[`host-config`],...e.extraLayers??[]],{vars:{name:i,version:Ue.version},extra:[{slot:`repo`,code:l===`inmemory`?`repo: 'inmemory'`:`repo: { name: '${l.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}' }`},...e.spaClientDir?[tt(e.spaClientDir)]:[]]}),S=e.platformConfig===!1?void 0:oe(s);await r(d(m,`package.json`),se(i,g,b,S));let C=L(s,S);C&&await r(d(m,`.yarnrc.yml`),C);let w=P(b.files,{name:i,template:c,runtime:p,packageManager:s,...He(s),netlifyPublish:c===`inertia`?`dist/client`:`dist/public`,templateLabel:{rest:`REST API`,minimal:`Minimal`,inertia:`Inertia (React)`}[c],sessionSecret:x(32).toString(`hex`),packages:[...b.dependencies,...b.devDependencies].filter(e=>e.startsWith(`@forinda/`)).map(e=>`- \`${e}\``).join(`
+`)});for(let[e,t]of w)await r(d(m,e),t);if(e.platformConfig!==!1){let e=c===`inertia`?`inertia`:`api`;await r(d(m,`Dockerfile`),V(e,s,i,S)),await r(d(m,`.dockerignore`),H())}let{generateAgentDocs:T}=await import(`./agent-docs-uEhHT_Tq.mjs`).then(e=>e.t);await T({outDir:m,name:i,pm:s,template:c,only:`all`,force:!0});let E={...Ie,...$(u),...b.builds};if(e.approveInstallScripts!==!1&&Q(s,m,E),e.installDeps){console.log(`\n  Installing dependencies with ${s}...\n`);try{v(`${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-D9opCn2d.mjs`).then(e=>e.n);await e({cwd:m,allowDuplicates:!0,silent:!0})}catch{}if(e.initGit)try{v(`git init`,{cwd:m,stdio:`pipe`}),v(`git branch -M main`,{cwd:m,stdio:`pipe`}),v(`git add -A`,{cwd:m,stdio:`pipe`}),v(`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 D=m!==process.cwd();h(`Next steps:`),D&&h(`  cd ${i}`),e.installDeps||h(`  ${s} install`);let O=t(s,`kick`),k={rest:`${O} g module user`,minimal:`# add your routes to src/index.ts`,inertia:`# pages: src/modules/pages + src/client/pages`};h(`  ${k[c]??k.rest}`),h(`  ${n(s,`dev`)}`);let A=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:`),A([[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:`),A([[`${O} g module <name>`,`REST module (controller, service, DTOs, repository)`],[`${O} g scaffold <n> <f..>`,`CRUD module from field definitions`],[`${O} g controller <name>`,`Standalone controller`],[`${O} g service <name>`,`@Service() class`],[`${O} g middleware <name>`,`Global connect-style middleware`],[`${O} g guard <name>`,`Route guard (auth, roles, etc.)`],[`${O} g adapter <name>`,`AppAdapter with lifecycle hooks`],[`${O} g dto <name>`,`DTO schema (Zod / Valibot / Yup)`],[`${O} g config`,`Generate kick.config.ts`]]),h(``),h(`Add packages:`),A([[`${O} add <pkg>`,`Install a KickJS package + peers`],[`${O} add --list`,`Show all available packages`]]),h(``),h(`Available: ${Oe}`),h(``),{builds:E}}function tt(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 nt(e){return[`base`,`template-${e.template}`,`runtime-${e.runtime}`,`schema-${e.schemaLib}`,...e.packages.filter(e=>a(d(M,`feature-${e}`))).map(e=>`feature-${e}`)]}export{O as _,Q as a,Z as c,oe as d,L as f,k as g,D as h,Ae as i,V as l,N as m,Ye as n,Be as o,P as p,Y as r,ze as s,et as t,H as u};