@forinda/kickjs-cli 5.5.1 → 5.7.0

package/dist/index.d.mts

@@ -290,6 +290,30 @@ interface TypegenPluginResult {
   status: 'written' | 'unchanged' | 'skipped';
   outFile?: string;
 }
+/**
+ * Identity factory for {@link TypegenPlugin}. Returns the spec verbatim.
+ * Exists for type inference and forward-compatibility — future
+ * fields can be added with defaults without breaking adopters.
+ *
+ * Mirrors {@link defineGenerator} ergonomics. Use at the call site so
+ * the plugin's `generate(ctx)` body gets a fully-typed `ctx` without
+ * an explicit annotation:
+ *
+ * @example
+ * ```ts
+ * import { defineTypegen } from '@forinda/kickjs-cli'
+ *
+ * export const drizzleTypegen = defineTypegen({
+ *   id: 'drizzle',
+ *   inputs: ['src/db/schema.ts'],
+ *   async generate(ctx) {
+ *     const schema = await ctx.importTs(`${ctx.cwd}/src/db/schema.ts`)
+ *     return `// declare module …`
+ *   },
+ * })
+ * ```
+ */
+declare function defineTypegen(spec: TypegenPlugin): TypegenPlugin;
 //#endregion
 //#region src/generator-extension/define.d.ts
 /**
@@ -336,7 +360,7 @@ interface TypegenPluginResult {
  * generators without rewriting their templates.
  */
 interface GeneratorContext {
-  /** Raw name passed on the command line (`kick g resolver UserPost` → `'UserPost'`). */
+  /** Raw name passed on the command line (`kick g drizzle-typegen UserPost` → `'UserPost'`). */
   name: string;
   /** PascalCase form (`UserPost`). */
   pascal: string;
@@ -428,6 +452,35 @@ interface GeneratorSpec {
  */
 declare function defineGenerator(spec: GeneratorSpec): GeneratorSpec;
 //#endregion
+//#region src/generator-extension/discover.d.ts
+/**
+ * One row in the discovered registry. `source` is the npm package name
+ * the generator came from — surfaced in error messages so adopters can
+ * see which plugin owns a given generator.
+ */
+interface DiscoveredGenerator {
+  source: string;
+  spec: GeneratorSpec;
+}
+/**
+ * Plugin discovery result, kept around even when no generators were
+ * registered so callers can distinguish "no plugins installed" from
+ * "no plugins matched the requested name."
+ */
+interface DiscoveryResult {
+  generators: DiscoveredGenerator[];
+  /** Packages whose `kickjs.generators` was loaded successfully. */
+  loaded: string[];
+  /**
+   * Packages we tried to load but failed — typically a missing entry
+   * file or a default export that wasn't an array of GeneratorSpec.
+   */
+  failed: Array<{
+    source: string;
+    reason: string;
+  }>;
+}
+//#endregion
 //#region src/plugin/types.d.ts
 /**
  * Runtime context handed to `register()` — saves callbacks from
@@ -439,6 +492,18 @@ interface KickCliPluginContext {
   /** Resolved kick.config.ts (null if the project has none). */
   config: KickConfig | null;
   log: (msg: string) => void;
+  /**
+   * Plugin-shipped generators merged from built-ins + adopter
+   * `kick.config.ts > plugins[]`. Populated by `mergeCliPlugins` and
+   * threaded through so `register()` callbacks (notably
+   * `kick/generate`) can register each plugin generator as a real
+   * Commander subcommand — without that, plugin generators only fire
+   * via the bare-action dispatch and are invisible to `kick g --help`.
+   *
+   * Optional so light test harnesses that call `plugin.register(program)`
+   * directly (no merge step) stay unaffected.
+   */
+  generators?: DiscoveredGenerator[];
 }
 interface KickCliPlugin {
   /** Stable identifier — used in error messages on conflict + de-dup. */
@@ -864,8 +929,24 @@ interface KickConfig {
 }
 /** Helper to define a type-safe kick.config.ts */
 declare function defineConfig(config: KickConfig): KickConfig;
-/** Load kick.config.* from the project root */
-declare function loadKickConfig(cwd: string): Promise<KickConfig | null>;
+/**
+ * Load `kick.config.*` starting from `startDir` and walking up toward
+ * the filesystem root until a config file is found. Returns `null`
+ * when no config exists anywhere on the way up.
+ *
+ * Walking up means adopters can run `kick <cmd>` from any subdirectory
+ * (e.g. `src/modules/users/`) and still pick up the project's config —
+ * before this change a nested-cwd invocation silently saw `null` and
+ * fell back to framework defaults.
+ *
+ * TypeScript configs (`.ts`) are loaded via `jiti` when available;
+ * `.js` / `.mjs` use native `import()`; `.json` uses `JSON.parse`. The
+ * jiti import is dynamic + best-effort: if the dep is missing we
+ * surface a warning telling the adopter how to install it, instead of
+ * silently dropping the config (which is what the previous bare-catch
+ * did).
+ */
+declare function loadKickConfig(startDir: string): Promise<KickConfig | null>;
 //#endregion
 //#region src/generators/templates/types.d.ts
 /**
@@ -1017,34 +1098,23 @@ interface InitProjectOptions {
 /** Scaffold a new KickJS project */
 declare function initProject(options: InitProjectOptions): Promise<void>;
 //#endregion
-//#region src/generator-extension/discover.d.ts
-/**
- * One row in the discovered registry. `source` is the npm package name
- * the generator came from — surfaced in error messages so adopters can
- * see which plugin owns a given generator.
- */
-interface DiscoveredGenerator {
-  source: string;
-  spec: GeneratorSpec;
-}
+//#region src/utils/project-root.d.ts
 /**
- * Plugin discovery result, kept around even when no generators were
- * registered so callers can distinguish "no plugins installed" from
- * "no plugins matched the requested name."
+ * Walk up from `startDir` looking for the project root. A directory
+ * counts as the root when it contains any of:
+ * - `kick.config.{ts,js,mjs,json}` (strongest signal)
+ * - `package.json` (fallback when no config file exists yet)
+ *
+ * Returns the absolute path of the first matching directory, or
+ * `startDir` itself when nothing was found (no surprises — callers
+ * that didn't find a config still get a reasonable cwd).
+ *
+ * `kick.config.*` wins over `package.json` when both appear at
+ * different levels, so adopters running `kick typegen` from `src/`
+ * land on the project root that owns the config, not on the nearest
+ * workspace package boundary in a monorepo.
  */
-interface DiscoveryResult {
-  generators: DiscoveredGenerator[];
-  /** Packages whose `kickjs.generators` was loaded successfully. */
-  loaded: string[];
-  /**
-   * Packages we tried to load but failed — typically a missing entry
-   * file or a default export that wasn't an array of GeneratorSpec.
-   */
-  failed: Array<{
-    source: string;
-    reason: string;
-  }>;
-}
+declare function findProjectRoot(startDir?: string): string;
 //#endregion
 //#region src/generator-extension/context.d.ts
 /**
@@ -1076,5 +1146,5 @@ declare function toKebabCase(name: string): string;
  */
 declare function pluralize(name: string): string;
 //#endregion
-export { type DiscoveredGenerator, type DiscoveryResult, type GeneratorArg, type GeneratorContext, type GeneratorFile, type GeneratorFlag, type GeneratorSpec, type KickCliPlugin, type KickCliPluginContext, type KickCommandDefinition, type KickConfig, type KickDbConfigBlock, KickPluginConflictError, type TypegenContext, type TypegenPlugin, type TypegenPluginResult, buildGeneratorContext, defineCliPlugin, defineConfig, defineGenerator, generateAdapter, generateController, generateDto, generateGuard, generateMiddleware, generateModule, generateService, initProject, loadKickConfig, pluralize, toCamelCase, toKebabCase, toPascalCase };
+export { type DiscoveredGenerator, type DiscoveryResult, type GeneratorArg, type GeneratorContext, type GeneratorFile, type GeneratorFlag, type GeneratorSpec, type KickCliPlugin, type KickCliPluginContext, type KickCommandDefinition, type KickConfig, type KickDbConfigBlock, KickPluginConflictError, type TypegenContext, type TypegenPlugin, type TypegenPluginResult, buildGeneratorContext, defineCliPlugin, defineConfig, defineGenerator, defineTypegen, findProjectRoot, generateAdapter, generateController, generateDto, generateGuard, generateMiddleware, generateModule, generateService, initProject, loadKickConfig, pluralize, toCamelCase, toKebabCase, toPascalCase };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/generator-extension/define.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/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/typegen/scanner.ts","../src/typegen/plugin.ts","../src/generator-extension/define.ts","../src/generator-extension/discover.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/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.5.1
+ * @forinda/kickjs-cli v5.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,5 @@
  *
  * @license MIT
  */
-import{C as e,S as t,_ as n,a as r,b as i,d as a,f as o,i as s,l as c,m as l,p as u,r as d,u as f,w as p}from"./generator-extension-m04pTdQi.mjs";import{i as m,r as h}from"./config-Buzo7RE1.mjs";import{n as g,t as _}from"./types-RTdCiPdS.mjs";export{_ as KickPluginConflictError,d as buildGeneratorContext,g as defineCliPlugin,h as defineConfig,s as defineGenerator,l as generateAdapter,f as generateController,c as generateDto,o as generateGuard,u as generateMiddleware,n as generateModule,a as generateService,r as initProject,m as loadKickConfig,i as pluralize,t as toCamelCase,e as toKebabCase,p as toPascalCase};
+import{E as e,S as t,T as n,a as r,d as i,f as a,g as o,h as s,i as c,m as l,p as u,r as d,w as f,y as p}from"./generator-extension-Cd2DU_XX.mjs";import{i as m,r as h}from"./config-BQUzGk6m.mjs";import{t as g}from"./project-root-Dsxhm7OL.mjs";import{n as _,t as v}from"./types-Du3p7CZ5.mjs";function y(e){return e}export{v as KickPluginConflictError,d as buildGeneratorContext,_ as defineCliPlugin,h as defineConfig,c as defineGenerator,y as defineTypegen,g as findProjectRoot,o as generateAdapter,a as generateController,i as generateDto,l as generateGuard,s as generateMiddleware,p as generateModule,u as generateService,r as initProject,m as loadKickConfig,t as pluralize,f as toCamelCase,n as toKebabCase,e as toPascalCase};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/typegen/plugin.ts"],"sourcesContent":["// TypegenPlugin contract — M2.B-T7.\n//\n// Each plugin owns a single `.kickjs/types/<id>.d.ts` file. The runner\n// invokes `generate(ctx)` per plugin, prepends a banner, writes only on\n// content change, and surfaces drift in --check mode (CI gate).\n//\n// Built-in plugins (kick/routes, kick/env, kick/assets, kick/db) live under\n// `./builtin`. Adopters register additional plugins via kick.config.ts.\n\nimport type { KickConfig } from '../config'\nimport type { ScanOptions, ScanResult } from './scanner'\n\nexport interface TypegenLogger {\n  info(msg: string): void\n  warn(msg: string): void\n  error(msg: string): void\n}\n\nexport interface TypegenContext {\n  cwd: string\n  config: KickConfig\n  /** Dynamic-import a TS module (Node loader). Used by plugins that need to\n   * read the adopter's schema / route map / asset registry at generate time. */\n  importTs<T = unknown>(absPath: string): Promise<T>\n  /** Write under `cwd`. Caller passes a relPath (e.g. `.kickjs/types/foo.d.ts`). */\n  writeFile(relPath: string, contents: string): Promise<void>\n  /**\n   * Run `scanProject` once per typegen pass, memoizing the result so\n   * multiple plugins (`kick/routes`, `kick/env`, future adopter plugins)\n   * share a single fs walk + AST extraction.\n   *\n   * The runner uses an order-independent cache key derived from the\n   * resolved options (`root`, `cwd`, `extensions`, `exclude`, `envFile`)\n   * — semantically equal options hit the cache regardless of how the\n   * caller built the literal. (We deliberately don't `JSON.stringify`\n   * the options for caching since that would be sensitive to property\n   * insertion order.) Plugins that don't need scanner data can ignore\n   * this method entirely.\n   *\n   * Implementation lives in the runner so test harnesses can inject\n   * a stub scanner; plugins only see the function.\n   */\n  getScanResult(opts: ScanOptions): Promise<ScanResult>\n  log: TypegenLogger\n}\n\nexport interface TypegenPlugin {\n  /** Stable id — used as filename: `.kickjs/types/${id}<outExtension>` (slashes → `__`). */\n  id: string\n  /** Glob patterns the Vite watcher subscribes to; change → re-run this plugin. */\n  inputs: string[]\n  /**\n   * Output filename extension. Default `.d.ts` — the right choice for\n   * pure module-augmentation plugins (kick/db, kick/assets) since\n   * declaration files don't need the runtime-import dance.\n   *\n   * `kick/routes` overrides to `.ts` because it emits hoisted\n   * `import type {...} from '...'` lines at the top of the file. Inline\n   * `import('...').X` references inside `.d.ts` silently degrade to\n   * `unknown` under `moduleResolution: 'bundler'`; emitting `.ts`\n   * sidesteps that quirk and gets full type resolution.\n   *\n   * Adopter-supplied plugins should leave this unset unless they hit\n   * the same hoisted-import constraint.\n   */\n  outExtension?: string\n  /**\n   * Return the augmentation source (without banner — runner prepends).\n   * Return null to skip emission (e.g. no schema file present).\n   */\n  generate(ctx: TypegenContext): Promise<string | null>\n}\n\nexport interface TypegenPluginResult {\n  id: string\n  status: 'written' | 'unchanged' | 'skipped'\n  outFile?: string\n}\n\n/**\n * Identity factory for {@link TypegenPlugin}. Returns the spec verbatim.\n * Exists for type inference and forward-compatibility — future\n * fields can be added with defaults without breaking adopters.\n *\n * Mirrors {@link defineGenerator} ergonomics. Use at the call site so\n * the plugin's `generate(ctx)` body gets a fully-typed `ctx` without\n * an explicit annotation:\n *\n * @example\n * ```ts\n * import { defineTypegen } from '@forinda/kickjs-cli'\n *\n * export const drizzleTypegen = defineTypegen({\n *   id: 'drizzle',\n *   inputs: ['src/db/schema.ts'],\n *   async generate(ctx) {\n *     const schema = await ctx.importTs(`${ctx.cwd}/src/db/schema.ts`)\n *     return `// declare module …`\n *   },\n * })\n * ```\n */\nexport function defineTypegen(spec: TypegenPlugin): TypegenPlugin {\n  return spec\n}\n"],"mappings":";;;;;;;;;;mSAsGA,SAAgB,EAAc,EAAoC,CAChE,OAAO,CACT"}

package/dist/{plugin-BnIpCxAe.mjs → plugin-B6ANfh7O.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.5.1
+ * @forinda/kickjs-cli v5.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-Dnwyy6jt.mjs";import{t}from"./types-RTdCiPdS.mjs";function n(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r=n??{cwd:process.cwd(),config:null,log:()=>{}};for(let n of e)n.register&&await n.register(t,r)}}}var r=e({mergeCliPlugins:()=>n});export{n,r as t};
-//# sourceMappingURL=plugin-BnIpCxAe.mjs.map
+import{t as e}from"./rolldown-runtime-jjtMmVBF.mjs";import{t}from"./types-Du3p7CZ5.mjs";function n(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r=n?{generators:d,...n}:{cwd:process.cwd(),config:null,log:()=>{},generators:d};for(let n of e)n.register&&await n.register(t,r)}}}var r=e({mergeCliPlugins:()=>n});export{n,r as t};
+//# sourceMappingURL=plugin-B6ANfh7O.mjs.map

package/dist/{plugin-BnIpCxAe.mjs.map → plugin-B6ANfh7O.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"plugin-BnIpCxAe.mjs","names":[],"sources":["../src/plugin/merge.ts","../src/plugin/index.ts"],"sourcesContent":["// Plugin → unified registry merge.\n//\n// Resolution rules (per the v1 spec + dogfood pivot):\n//   - duplicate plugin `name` across the input array → conflict error.\n//     Catches the double-install case (built-in shipped twice, or\n//     adopter requiring the same plugin twice).\n//   - plugin commands appear first in the merged list, then adopter\n//     commands; adopter `commands` of the same name override the\n//     plugin entry (filter pass).\n//   - duplicate command name across two plugins → conflict error\n//     listing both plugin names. Adopter overriding a plugin is\n//     allowed and not an error.\n//   - duplicate typegen id across two plugins → same error. Typegens\n//     have no adopter override path; only plugins contribute them.\n//   - register() functions are collected in input order; the caller\n//     invokes each one against the same Command program. They have no\n//     id-level conflict surface — owners are responsible for picking\n//     non-colliding command names inside their own register().\n//   - plugin order = array order. No implicit precedence rules.\n\nimport type { Command } from 'commander'\n\nimport type { KickCommandDefinition } from '../config'\nimport type { TypegenPlugin } from '../typegen/plugin'\nimport type { GeneratorSpec } from '../generator-extension/define'\nimport type { DiscoveredGenerator } from '../generator-extension/discover'\nimport { KickPluginConflictError, type KickCliPlugin, type KickCliPluginContext } from './types'\n\nexport interface MergedPlugins {\n  commands: KickCommandDefinition[]\n  typegens: TypegenPlugin[]\n  /** DiscoveredGenerator shape so this list slots into the existing\n   * dispatch path next to package.json-discovered entries. `source`\n   * carries the plugin name for error attribution. */\n  generators: DiscoveredGenerator[]\n  /**\n   * Apply every plugin's register() in input order. ctx is optional so\n   * tests + lightweight callers can invoke `register(program)` without\n   * constructing a full context; it falls back to cwd=process.cwd(),\n   * config=null, log=no-op.\n   */\n  register: (program: Command, ctx?: KickCliPluginContext) => Promise<void>\n}\n\nexport function mergeCliPlugins(\n  plugins: readonly KickCliPlugin[],\n  adopterCommands: readonly KickCommandDefinition[] = [],\n): MergedPlugins {\n  // Plugin-name dedup — catches double-install.\n  const seenPluginNames = new Map<string, number>()\n  for (const p of plugins) {\n    const count = (seenPluginNames.get(p.name) ?? 0) + 1\n    seenPluginNames.set(p.name, count)\n    if (count === 2) {\n      throw new KickPluginConflictError('plugin', p.name, [p.name, p.name])\n    }\n  }\n\n  const commandOwners = new Map<string, string>()\n  const pluginCommands: KickCommandDefinition[] = []\n  for (const p of plugins) {\n    for (const cmd of p.commands ?? []) {\n      const prior = commandOwners.get(cmd.name)\n      if (prior) {\n        throw new KickPluginConflictError('command', cmd.name, [prior, p.name])\n      }\n      commandOwners.set(cmd.name, p.name)\n      pluginCommands.push(cmd)\n    }\n  }\n\n  const adopterNames = new Set(adopterCommands.map((c) => c.name))\n  const filteredPlugin = pluginCommands.filter((c) => !adopterNames.has(c.name))\n  const commands = [...filteredPlugin, ...adopterCommands]\n\n  const typegenOwners = new Map<string, string>()\n  const typegens: TypegenPlugin[] = []\n  for (const p of plugins) {\n    for (const tg of p.typegens ?? []) {\n      const prior = typegenOwners.get(tg.id)\n      if (prior) {\n        throw new KickPluginConflictError('typegen', tg.id, [prior, p.name])\n      }\n      typegenOwners.set(tg.id, p.name)\n      typegens.push(tg)\n    }\n  }\n\n  const generatorOwners = new Map<string, string>()\n  const generators: DiscoveredGenerator[] = []\n  for (const p of plugins) {\n    for (const spec of p.generators ?? []) {\n      const prior = generatorOwners.get(spec.name)\n      if (prior) {\n        throw new KickPluginConflictError('generator', spec.name, [prior, p.name])\n      }\n      generatorOwners.set(spec.name, p.name)\n      generators.push({ source: p.name, spec: spec satisfies GeneratorSpec })\n    }\n  }\n\n  const register = async (program: Command, ctx?: KickCliPluginContext): Promise<void> => {\n    const resolved: KickCliPluginContext = ctx ?? {\n      cwd: process.cwd(),\n      config: null,\n      log: () => {},\n    }\n    for (const p of plugins) {\n      if (p.register) await p.register(program, resolved)\n    }\n  }\n\n  return { commands, typegens, generators, register }\n}\n","// Barrel intentionally omits `./builtins` — that module top-level-imports\n// every register*Command, which pulls heavy modules (project scaffolders,\n// fs reads at import time) into the graph. Importers that need the\n// builtin list go through `./plugin/builtins` directly; tests + adopter\n// plugins consuming only the contract types import from here.\n\nexport type { KickCliPlugin } from './types'\nexport { defineCliPlugin, KickPluginConflictError } from './types'\nexport { mergeCliPlugins, type MergedPlugins } from './merge'\n"],"mappings":";;;;;;;;;;wFA4CA,SAAgB,EACd,EACA,EAAoD,EAAE,CACvC,CAEf,IAAM,EAAkB,IAAI,IAC5B,IAAK,IAAM,KAAK,EAAS,CACvB,IAAM,GAAS,EAAgB,IAAI,EAAE,KAAK,EAAI,GAAK,EAEnD,GADA,EAAgB,IAAI,EAAE,KAAM,EAAM,CAC9B,IAAU,EACZ,MAAM,IAAI,EAAwB,SAAU,EAAE,KAAM,CAAC,EAAE,KAAM,EAAE,KAAK,CAAC,CAIzE,IAAM,EAAgB,IAAI,IACpB,EAA0C,EAAE,CAClD,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAO,EAAE,UAAY,EAAE,CAAE,CAClC,IAAM,EAAQ,EAAc,IAAI,EAAI,KAAK,CACzC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAI,KAAM,CAAC,EAAO,EAAE,KAAK,CAAC,CAEzE,EAAc,IAAI,EAAI,KAAM,EAAE,KAAK,CACnC,EAAe,KAAK,EAAI,CAI5B,IAAM,EAAe,IAAI,IAAI,EAAgB,IAAK,GAAM,EAAE,KAAK,CAAC,CAE1D,EAAW,CAAC,GADK,EAAe,OAAQ,GAAM,CAAC,EAAa,IAAI,EAAE,KAAK,CAC1C,CAAE,GAAG,EAAgB,CAElD,EAAgB,IAAI,IACpB,EAA4B,EAAE,CACpC,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAM,EAAE,UAAY,EAAE,CAAE,CACjC,IAAM,EAAQ,EAAc,IAAI,EAAG,GAAG,CACtC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAG,GAAI,CAAC,EAAO,EAAE,KAAK,CAAC,CAEtE,EAAc,IAAI,EAAG,GAAI,EAAE,KAAK,CAChC,EAAS,KAAK,EAAG,CAIrB,IAAM,EAAkB,IAAI,IACtB,EAAoC,EAAE,CAC5C,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAQ,EAAE,YAAc,EAAE,CAAE,CACrC,IAAM,EAAQ,EAAgB,IAAI,EAAK,KAAK,CAC5C,GAAI,EACF,MAAM,IAAI,EAAwB,YAAa,EAAK,KAAM,CAAC,EAAO,EAAE,KAAK,CAAC,CAE5E,EAAgB,IAAI,EAAK,KAAM,EAAE,KAAK,CACtC,EAAW,KAAK,CAAE,OAAQ,EAAE,KAAY,OAA8B,CAAC,CAe3E,MAAO,CAAE,WAAU,WAAU,aAAY,eAXjB,EAAkB,IAA8C,CACtF,IAAM,EAAiC,GAAO,CAC5C,IAAK,QAAQ,KAAK,CAClB,OAAQ,KACR,QAAW,GACZ,CACD,IAAK,IAAM,KAAK,EACV,EAAE,UAAU,MAAM,EAAE,SAAS,EAAS,EAAS,EAIJ"}
+{"version":3,"file":"plugin-B6ANfh7O.mjs","names":[],"sources":["../src/plugin/merge.ts","../src/plugin/index.ts"],"sourcesContent":["// Plugin → unified registry merge.\n//\n// Resolution rules (per the v1 spec + dogfood pivot):\n//   - duplicate plugin `name` across the input array → conflict error.\n//     Catches the double-install case (built-in shipped twice, or\n//     adopter requiring the same plugin twice).\n//   - plugin commands appear first in the merged list, then adopter\n//     commands; adopter `commands` of the same name override the\n//     plugin entry (filter pass).\n//   - duplicate command name across two plugins → conflict error\n//     listing both plugin names. Adopter overriding a plugin is\n//     allowed and not an error.\n//   - duplicate typegen id across two plugins → same error. Typegens\n//     have no adopter override path; only plugins contribute them.\n//   - register() functions are collected in input order; the caller\n//     invokes each one against the same Command program. They have no\n//     id-level conflict surface — owners are responsible for picking\n//     non-colliding command names inside their own register().\n//   - plugin order = array order. No implicit precedence rules.\n\nimport type { Command } from 'commander'\n\nimport type { KickCommandDefinition } from '../config'\nimport type { TypegenPlugin } from '../typegen/plugin'\nimport type { GeneratorSpec } from '../generator-extension/define'\nimport type { DiscoveredGenerator } from '../generator-extension/discover'\nimport { KickPluginConflictError, type KickCliPlugin, type KickCliPluginContext } from './types'\n\nexport interface MergedPlugins {\n  commands: KickCommandDefinition[]\n  typegens: TypegenPlugin[]\n  /** DiscoveredGenerator shape so this list slots into the existing\n   * dispatch path next to package.json-discovered entries. `source`\n   * carries the plugin name for error attribution. */\n  generators: DiscoveredGenerator[]\n  /**\n   * Apply every plugin's register() in input order. ctx is optional so\n   * tests + lightweight callers can invoke `register(program)` without\n   * constructing a full context; it falls back to cwd=process.cwd(),\n   * config=null, log=no-op.\n   */\n  register: (program: Command, ctx?: KickCliPluginContext) => Promise<void>\n}\n\nexport function mergeCliPlugins(\n  plugins: readonly KickCliPlugin[],\n  adopterCommands: readonly KickCommandDefinition[] = [],\n): MergedPlugins {\n  // Plugin-name dedup — catches double-install.\n  const seenPluginNames = new Map<string, number>()\n  for (const p of plugins) {\n    const count = (seenPluginNames.get(p.name) ?? 0) + 1\n    seenPluginNames.set(p.name, count)\n    if (count === 2) {\n      throw new KickPluginConflictError('plugin', p.name, [p.name, p.name])\n    }\n  }\n\n  const commandOwners = new Map<string, string>()\n  const pluginCommands: KickCommandDefinition[] = []\n  for (const p of plugins) {\n    for (const cmd of p.commands ?? []) {\n      const prior = commandOwners.get(cmd.name)\n      if (prior) {\n        throw new KickPluginConflictError('command', cmd.name, [prior, p.name])\n      }\n      commandOwners.set(cmd.name, p.name)\n      pluginCommands.push(cmd)\n    }\n  }\n\n  const adopterNames = new Set(adopterCommands.map((c) => c.name))\n  const filteredPlugin = pluginCommands.filter((c) => !adopterNames.has(c.name))\n  const commands = [...filteredPlugin, ...adopterCommands]\n\n  const typegenOwners = new Map<string, string>()\n  const typegens: TypegenPlugin[] = []\n  for (const p of plugins) {\n    for (const tg of p.typegens ?? []) {\n      const prior = typegenOwners.get(tg.id)\n      if (prior) {\n        throw new KickPluginConflictError('typegen', tg.id, [prior, p.name])\n      }\n      typegenOwners.set(tg.id, p.name)\n      typegens.push(tg)\n    }\n  }\n\n  const generatorOwners = new Map<string, string>()\n  const generators: DiscoveredGenerator[] = []\n  for (const p of plugins) {\n    for (const spec of p.generators ?? []) {\n      const prior = generatorOwners.get(spec.name)\n      if (prior) {\n        throw new KickPluginConflictError('generator', spec.name, [prior, p.name])\n      }\n      generatorOwners.set(spec.name, p.name)\n      generators.push({ source: p.name, spec: spec satisfies GeneratorSpec })\n    }\n  }\n\n  const register = async (program: Command, ctx?: KickCliPluginContext): Promise<void> => {\n    // Default ctx if caller didn't provide one (tests, scripts). Thread\n    // `generators` through so the `kick/generate` built-in can register\n    // each plugin generator as a real Commander subcommand. Caller-\n    // supplied ctx wins for every field — including `generators`, in\n    // case a test fixture wants to inject a different set.\n    const resolved: KickCliPluginContext = ctx\n      ? { generators, ...ctx }\n      : { cwd: process.cwd(), config: null, log: () => {}, generators }\n    for (const p of plugins) {\n      if (p.register) await p.register(program, resolved)\n    }\n  }\n\n  return { commands, typegens, generators, register }\n}\n","// Barrel intentionally omits `./builtins` — that module top-level-imports\n// every register*Command, which pulls heavy modules (project scaffolders,\n// fs reads at import time) into the graph. Importers that need the\n// builtin list go through `./plugin/builtins` directly; tests + adopter\n// plugins consuming only the contract types import from here.\n\nexport type { KickCliPlugin } from './types'\nexport { defineCliPlugin, KickPluginConflictError } from './types'\nexport { mergeCliPlugins, type MergedPlugins } from './merge'\n"],"mappings":";;;;;;;;;;wFA4CA,SAAgB,EACd,EACA,EAAoD,CAAC,EACtC,CAEf,IAAM,EAAkB,IAAI,IAC5B,IAAK,IAAM,KAAK,EAAS,CACvB,IAAM,GAAS,EAAgB,IAAI,EAAE,IAAI,GAAK,GAAK,EAEnD,GADA,EAAgB,IAAI,EAAE,KAAM,CAAK,EAC7B,IAAU,EACZ,MAAM,IAAI,EAAwB,SAAU,EAAE,KAAM,CAAC,EAAE,KAAM,EAAE,IAAI,CAAC,CAExE,CAEA,IAAM,EAAgB,IAAI,IACpB,EAA0C,CAAC,EACjD,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAO,EAAE,UAAY,CAAC,EAAG,CAClC,IAAM,EAAQ,EAAc,IAAI,EAAI,IAAI,EACxC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAI,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAExE,EAAc,IAAI,EAAI,KAAM,EAAE,IAAI,EAClC,EAAe,KAAK,CAAG,CACzB,CAGF,IAAM,EAAe,IAAI,IAAI,EAAgB,IAAK,GAAM,EAAE,IAAI,CAAC,EAEzD,EAAW,CAAC,GADK,EAAe,OAAQ,GAAM,CAAC,EAAa,IAAI,EAAE,IAAI,CAC1C,EAAG,GAAG,CAAe,EAEjD,EAAgB,IAAI,IACpB,EAA4B,CAAC,EACnC,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAM,EAAE,UAAY,CAAC,EAAG,CACjC,IAAM,EAAQ,EAAc,IAAI,EAAG,EAAE,EACrC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAG,GAAI,CAAC,EAAO,EAAE,IAAI,CAAC,EAErE,EAAc,IAAI,EAAG,GAAI,EAAE,IAAI,EAC/B,EAAS,KAAK,CAAE,CAClB,CAGF,IAAM,EAAkB,IAAI,IACtB,EAAoC,CAAC,EAC3C,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAQ,EAAE,YAAc,CAAC,EAAG,CACrC,IAAM,EAAQ,EAAgB,IAAI,EAAK,IAAI,EAC3C,GAAI,EACF,MAAM,IAAI,EAAwB,YAAa,EAAK,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAE3E,EAAgB,IAAI,EAAK,KAAM,EAAE,IAAI,EACrC,EAAW,KAAK,CAAE,OAAQ,EAAE,KAAY,MAA6B,CAAC,CACxE,CAiBF,MAAO,CAAE,WAAU,WAAU,aAAY,eAdjB,EAAkB,IAA8C,CAMtF,IAAM,EAAiC,EACnC,CAAE,aAAY,GAAG,CAAI,EACrB,CAAE,IAAK,QAAQ,IAAI,EAAG,OAAQ,KAAM,QAAW,CAAC,EAAG,YAAW,EAClE,IAAK,IAAM,KAAK,EACV,EAAE,UAAU,MAAM,EAAE,SAAS,EAAS,CAAQ,CAEtD,CAEkD,CACpD"}

package/dist/project-root-Dsxhm7OL.mjs

@@ -0,0 +1,12 @@
+/**
+ * @forinda/kickjs-cli v5.7.0
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import{t as e}from"./rolldown-runtime-jjtMmVBF.mjs";import{dirname as t,parse as n,resolve as r}from"node:path";import{existsSync as i}from"node:fs";var a=e({findProjectRoot:()=>s});const o=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];function s(e=process.cwd()){let a=r(e),{root:s}=n(a),c=null,l=a;for(;;){for(let e of o)if(i(r(l,e)))return l;if(c===null&&i(r(l,`package.json`))&&(c=l),l===s)break;let e=t(l);if(e===l)break;l=e}return c??a}export{a as n,s as t};
+//# sourceMappingURL=project-root-Dsxhm7OL.mjs.map

package/dist/project-root-Dsxhm7OL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root-Dsxhm7OL.mjs","names":[],"sources":["../src/utils/project-root.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { dirname, parse, resolve } from 'node:path'\n\nconst CONFIG_FILENAMES = ['kick.config.ts', 'kick.config.js', 'kick.config.mjs', 'kick.config.json']\n\n/**\n * Walk up from `startDir` looking for the project root. A directory\n * counts as the root when it contains any of:\n * - `kick.config.{ts,js,mjs,json}` (strongest signal)\n * - `package.json` (fallback when no config file exists yet)\n *\n * Returns the absolute path of the first matching directory, or\n * `startDir` itself when nothing was found (no surprises — callers\n * that didn't find a config still get a reasonable cwd).\n *\n * `kick.config.*` wins over `package.json` when both appear at\n * different levels, so adopters running `kick typegen` from `src/`\n * land on the project root that owns the config, not on the nearest\n * workspace package boundary in a monorepo.\n */\nexport function findProjectRoot(startDir: string = process.cwd()): string {\n  const start = resolve(startDir)\n  const { root: fsRoot } = parse(start)\n\n  let firstPackageJson: string | null = null\n  let cursor = start\n  while (true) {\n    for (const name of CONFIG_FILENAMES) {\n      if (existsSync(resolve(cursor, name))) return cursor\n    }\n    if (firstPackageJson === null && existsSync(resolve(cursor, 'package.json'))) {\n      firstPackageJson = cursor\n    }\n    if (cursor === fsRoot) break\n    const parent = dirname(cursor)\n    if (parent === cursor) break\n    cursor = parent\n  }\n\n  return firstPackageJson ?? start\n}\n"],"mappings":";;;;;;;;;;sLAGA,MAAM,EAAmB,CAAC,iBAAkB,iBAAkB,kBAAmB,kBAAkB,EAiBnG,SAAgB,EAAgB,EAAmB,QAAQ,IAAI,EAAW,CACxE,IAAM,EAAQ,EAAQ,CAAQ,EACxB,CAAE,KAAM,GAAW,EAAM,CAAK,EAEhC,EAAkC,KAClC,EAAS,EACb,OAAa,CACX,IAAK,IAAM,KAAQ,EACjB,GAAI,EAAW,EAAQ,EAAQ,CAAI,CAAC,EAAG,OAAO,EAKhD,GAHI,IAAqB,MAAQ,EAAW,EAAQ,EAAQ,cAAc,CAAC,IACzE,EAAmB,GAEjB,IAAW,EAAQ,MACvB,IAAM,EAAS,EAAQ,CAAM,EAC7B,GAAI,IAAW,EAAQ,MACvB,EAAS,CACX,CAEA,OAAO,GAAoB,CAC7B"}

package/dist/{rolldown-runtime-Dnwyy6jt.mjs → rolldown-runtime-jjtMmVBF.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.5.1
+ * @forinda/kickjs-cli v5.7.0
  *
  * Copyright (c) Felix Orinda
  *