@forinda/kickjs-cli 5.1.0 → 5.2.1

package/dist/index.d.mts

@@ -1,6 +1,206 @@
 
 import { Command } from "commander";
 
+//#region src/typegen/scanner.d.ts
+/**
+ * Static scanner for KickJS decorated classes and DI tokens.
+ *
+ * Walks `src/**\/*.ts` (excluding tests and node_modules) and extracts:
+ *
+ * - Decorated classes (`@Service`, `@Controller`, `@Repository`, etc.)
+ * - `createToken<T>('name')` definitions
+ * - `@Inject('literal')` calls
+ *
+ * The output feeds the type generator, which emits `.kickjs/types/*.d.ts`
+ * files used by the user's tsc to make `container.resolve()` and module
+ * discovery type-safe.
+ *
+ * This is intentionally regex-based (not AST-based) to avoid the
+ * ts-morph / typescript compiler dependency. Pattern from
+ * `packages/vite/src/module-discovery.ts` which already uses regex
+ * to detect `*.module.ts` exports.
+ *
+ * ## Collision detection
+ *
+ * Two classes with the same name across different files is a collision.
+ * The scanner records all collisions in `ScanResult.collisions` so the
+ * caller (generator) can decide whether to hard-error or auto-namespace.
+ *
+ * @module @forinda/kickjs-cli/typegen/scanner
+ */
+/** Decorators that mark a class as DI-managed */
+declare const DECORATOR_NAMES: readonly ["Service", "Controller", "Repository", "Injectable", "Component", "Module"];
+type DecoratorName = (typeof DECORATOR_NAMES)[number];
+/** A single discovered decorated class */
+interface DiscoveredClass {
+  /** Class name (e.g., 'UserService') */
+  className: string;
+  /** Decorator that marked it (e.g., 'Service') */
+  decorator: DecoratorName;
+  /** Absolute file path */
+  filePath: string;
+  /** Path relative to scan root, with forward slashes */
+  relativePath: string;
+  /** True if exported as `default` */
+  isDefault: boolean;
+}
+/** A single route handler discovered on a controller class */
+interface DiscoveredRoute {
+  /** Owning controller class name (e.g. 'UserController') */
+  controller: string;
+  /** Handler method name on the controller (e.g. 'getUser') */
+  method: string;
+  /** HTTP verb (uppercase) */
+  httpMethod: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  /** Route path including parameter placeholders (e.g. '/:id/posts/:postId') */
+  path: string;
+  /** URL path parameter names extracted from `:placeholder` segments */
+  pathParams: string[];
+  /**
+   * Whitelisted query field names extracted from `@ApiQueryParams({...})`.
+   * `null` means no `@ApiQueryParams` was found on this method (so the
+   * generator emits an unconstrained `query` shape). An empty array means
+   * the decorator existed but no fields could be statically extracted
+   * (e.g. an opaque imported config).
+   */
+  queryFilterable: string[] | null;
+  querySortable: string[] | null;
+  querySearchable: string[] | null;
+  /**
+   * Schema identifiers referenced from the route decorator's second arg
+   * (e.g. `@Post('/', { body: createTaskSchema })`). `null` means no
+   * such reference; the value carries the identifier and the resolved
+   * import source (relative module path) if known.
+   */
+  bodySchema: SchemaRef | null;
+  querySchema: SchemaRef | null;
+  paramsSchema: SchemaRef | null;
+  /** Absolute file path of the controller */
+  filePath: string;
+  /** Path relative to scan root, with forward slashes */
+  relativePath: string;
+}
+/** A statically-resolved schema identifier reference */
+interface SchemaRef {
+  /** The identifier as written (e.g. `createTaskSchema`) */
+  identifier: string;
+  /**
+   * Resolved module specifier (relative path or bare module name) where
+   * the identifier is defined. `null` means the source could not be
+   * statically determined (the generator falls back to `unknown`).
+   */
+  source: string | null;
+}
+/** A `createToken<T>('name')` call discovered in source */
+interface DiscoveredToken {
+  /** The literal string passed to `createToken()` */
+  name: string;
+  /** The const variable name on the LHS, if any */
+  variable: string | null;
+  /** Absolute file path */
+  filePath: string;
+  /** Path relative to scan root, with forward slashes */
+  relativePath: string;
+}
+/** An `@Inject('literal')` call discovered in source */
+interface DiscoveredInject {
+  /** The literal string passed to `@Inject()` */
+  name: string;
+  /** Absolute file path */
+  filePath: string;
+  /** Path relative to scan root, with forward slashes */
+  relativePath: string;
+}
+/** A name collision — same class name in two or more files */
+interface ClassCollision {
+  /** The colliding class name */
+  className: string;
+  /** All files declaring the class */
+  classes: DiscoveredClass[];
+}
+/**
+ * Information about a discovered env schema file. The typegen
+ * generator uses this to emit a `KickEnv` + `NodeJS.ProcessEnv`
+ * augmentation that flows through to `@Value` and `process.env`.
+ *
+ * `null` means no env file was found at the configured location.
+ */
+interface DiscoveredEnv {
+  /** Absolute path to the env schema file */
+  filePath: string;
+  /** Path relative to scan root, with forward slashes */
+  relativePath: string;
+}
+/**
+ * A plugin or adapter discovered in source — either via `defineAdapter({ name })`
+ * / `definePlugin({ name })` calls, or via a class that `implements AppAdapter`
+ * and declares a string-literal `name` field.
+ *
+ * The `name` here is the literal string passed to the framework (the value
+ * `dependsOn` references), NOT the symbol on the LHS. `defineAdapter` lets
+ * authors choose any name they want; the symbol is irrelevant at runtime.
+ */
+interface DiscoveredPluginOrAdapter {
+  /** Whether this is a plugin (`definePlugin`) or adapter (`defineAdapter` / class) */
+  kind: 'plugin' | 'adapter';
+  /** The string literal passed as `name` (the value `dependsOn` references) */
+  name: string;
+  /** Absolute file path */
+  filePath: string;
+  /** Path relative to scan root, with forward slashes */
+  relativePath: string;
+}
+/**
+ * A `defineAugmentation('Name', meta)` call discovered in source. Plugins
+ * call this to advertise an augmentable interface so the typegen can list
+ * every augmentation surface in one generated file.
+ */
+interface DiscoveredAugmentation {
+  /** The literal string passed as the first arg to `defineAugmentation` */
+  name: string;
+  /** Optional `description` extracted from the second-arg object literal */
+  description: string | null;
+  /** Optional `example` extracted from the second-arg object literal */
+  example: string | null;
+  /** Absolute file path */
+  filePath: string;
+  /** Path relative to scan root, with forward slashes */
+  relativePath: string;
+}
+/** Aggregated scanner output */
+interface ScanResult {
+  classes: DiscoveredClass[];
+  routes: DiscoveredRoute[];
+  tokens: DiscoveredToken[];
+  injects: DiscoveredInject[];
+  collisions: ClassCollision[];
+  /** Discovered env schema file (or null if none found at the configured path) */
+  env: DiscoveredEnv | null;
+  /** Plugins/adapters discovered via `defineAdapter`/`definePlugin`/`implements AppAdapter` */
+  pluginsAndAdapters: DiscoveredPluginOrAdapter[];
+  /** Augmentation interfaces declared via `defineAugmentation('Name', meta)` */
+  augmentations: DiscoveredAugmentation[];
+}
+/** Options for the scanner */
+interface ScanOptions {
+  /** Root directory to scan (e.g., absolute path to `src`) */
+  root: string;
+  /** Project root used to compute relative paths (e.g., process.cwd()) */
+  cwd: string;
+  /** Glob-like extensions to scan */
+  extensions?: string[];
+  /** Substrings that exclude a path (matched against relative path) */
+  exclude?: string[];
+  /**
+   * Path to the env schema file, relative to `cwd`. Defaults to
+   * `'src/env.ts'`. The file must contain a `defineEnv(...)` call
+   * with a default export for the typegen to emit a typed `KickEnv`
+   * augmentation. If the file does not exist or doesn't match the
+   * expected shape, env typing is skipped silently.
+   */
+  envFile?: string;
+}
+//#endregion
 //#region src/typegen/plugin.d.ts
 interface TypegenLogger {
   info(msg: string): void;
@@ -15,13 +215,45 @@ interface TypegenContext {
   importTs<T = unknown>(absPath: string): Promise<T>;
   /** Write under `cwd`. Caller passes a relPath (e.g. `.kickjs/types/foo.d.ts`). */
   writeFile(relPath: string, contents: string): Promise<void>;
+  /**
+   * Run `scanProject` once per typegen pass, memoizing the result so
+   * multiple plugins (`kick/routes`, `kick/env`, future adopter plugins)
+   * share a single fs walk + AST extraction.
+   *
+   * The runner uses an order-independent cache key derived from the
+   * resolved options (`root`, `cwd`, `extensions`, `exclude`, `envFile`)
+   * — semantically equal options hit the cache regardless of how the
+   * caller built the literal. (We deliberately don't `JSON.stringify`
+   * the options for caching since that would be sensitive to property
+   * insertion order.) Plugins that don't need scanner data can ignore
+   * this method entirely.
+   *
+   * Implementation lives in the runner so test harnesses can inject
+   * a stub scanner; plugins only see the function.
+   */
+  getScanResult(opts: ScanOptions): Promise<ScanResult>;
   log: TypegenLogger;
 }
 interface TypegenPlugin {
-  /** Stable id — used as filename: `.kickjs/types/${id}.d.ts` (slashes → `__`). */
+  /** Stable id — used as filename: `.kickjs/types/${id}<outExtension>` (slashes → `__`). */
   id: string;
   /** Glob patterns the Vite watcher subscribes to; change → re-run this plugin. */
   inputs: string[];
+  /**
+   * Output filename extension. Default `.d.ts` — the right choice for
+   * pure module-augmentation plugins (kick/db, kick/assets) since
+   * declaration files don't need the runtime-import dance.
+   *
+   * `kick/routes` overrides to `.ts` because it emits hoisted
+   * `import type {...} from '...'` lines at the top of the file. Inline
+   * `import('...').X` references inside `.d.ts` silently degrade to
+   * `unknown` under `moduleResolution: 'bundler'`; emitting `.ts`
+   * sidesteps that quirk and gets full type resolution.
+   *
+   * Adopter-supplied plugins should leave this unset unless they hit
+   * the same hoisted-import constraint.
+   */
+  outExtension?: string;
   /**
    * Return the augmentation source (without banner — runner prepends).
    * Return null to skip emission (e.g. no schema file present).
@@ -263,6 +495,28 @@ interface AssetMapEntry {
    * selective by design (unlike `copyDirs` which copies everything).
    */
   glob?: string;
+  /**
+   * How file extensions feed into manifest keys. Default `'auto'`.
+   *
+   * - `'strip'` — drop the extension. `pages/index.pug` →
+   *   `'pages/index'`. Two siblings with the same basename collide;
+   *   last-walk-order wins, others are silently dropped. Opt-in
+   *   only — kept for backward compatibility with projects that
+   *   relied on this contract.
+   * - `'with-extension'` — keep every extension on every key. Best
+   *   when the namespace holds extension siblings (`index.pug` +
+   *   `index.html` + `index.css` in `src/pages/`); every file
+   *   reaches the manifest under its full path.
+   * - `'auto'` — strip when basenames are unique, keep extensions
+   *   on collision groups. Singleton files keep their short key;
+   *   `pages/index.{pug,html,css}` becomes
+   *   `pages/index.pug` / `pages/index.html` / `pages/index.css`.
+   *   No data loss; non-colliding namespaces stay on the short
+   *   keys they had before.
+   *
+   * @default 'auto'
+   */
+  keys?: 'auto' | 'strip' | 'with-extension';
 }
 /** Typegen settings — controls .kickjs/types/* generation */
 interface TypegenConfig {
@@ -393,6 +647,25 @@ interface KickConfig {
    * packageManager: 'pnpm'
    */
   packageManager?: PackageManager;
+  /**
+   * DI token scope prefix used by code generators. Every scaffolded
+   * `createToken<T>('<scope>/<area>/<key>')` substitutes this string
+   * for `<scope>`. Generators emit org-scoped tokens out of the box
+   * so adopter projects pass `kick-lint`'s `token-reserved-prefix`
+   * rule (which forbids the reserved `kick/` prefix on third-party
+   * code) without manual rename.
+   *
+   * Resolution order (highest first):
+   * 1. This field, when set
+   * 2. `package.json` `name` field — `@scope/pkg` → `'scope'`,
+   *    bare `pkg` → `'pkg'`
+   * 3. Fallback `'app'`
+   *
+   * @example
+   * tokenScope: 'mycorp'
+   * // → createToken<...>('mycorp/users/repository')
+   */
+  tokenScope?: string;
   /**
    * Directories to copy to dist/ after build.
    * Useful for EJS templates, email templates, static assets, etc.
@@ -510,6 +783,14 @@ interface GenerateModuleOptions {
   pluralize?: boolean;
   /** Prisma client import path (default: '@prisma/client', Prisma 7+: '@/generated/prisma/client') */
   prismaClientPath?: string;
+  /**
+   * DI-token scope prefix substituted into emitted `createToken<T>()`
+   * literals. Resolved by the orchestrating command from
+   * `kick.config.ts > tokenScope` or the project's package.json.
+   * Falls back to `'app'` when not set so the generator can be called
+   * without a config in tests/fixtures.
+   */
+  tokenScope?: string;
 }
 /**
  * Generate a module — structure depends on the project pattern.

package/dist/index.d.mts.map

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

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.1.0
+ * @forinda/kickjs-cli v5.2.1
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import { _ as pluralize, a as initProject, b as toKebabCase, d as generateService, f as generateGuard, h as generateModule, i as defineGenerator, l as generateDto, m as generateAdapter, p as generateMiddleware, r as buildGeneratorContext, u as generateController, x as toPascalCase, y as toCamelCase } from "./generator-extension-CYY-RI21.mjs";
-import { i as loadKickConfig, r as defineConfig } from "./config-C_LQNClP.mjs";
-import { n as defineCliPlugin, t as KickPluginConflictError } from "./types-BBUo1vXh.mjs";
+import { _ as pluralize, a as initProject, b as toKebabCase, d as generateService, f as generateGuard, h as generateModule, i as defineGenerator, l as generateDto, m as generateAdapter, p as generateMiddleware, r as buildGeneratorContext, u as generateController, x as toPascalCase, y as toCamelCase } from "./generator-extension-C-HwKvFf.mjs";
+import { i as loadKickConfig, r as defineConfig } from "./config-CRi3zCxk.mjs";
+import { n as defineCliPlugin, t as KickPluginConflictError } from "./types-CU89yUxU.mjs";
 export { KickPluginConflictError, buildGeneratorContext, defineCliPlugin, defineConfig, defineGenerator, generateAdapter, generateController, generateDto, generateGuard, generateMiddleware, generateModule, generateService, initProject, loadKickConfig, pluralize, toCamelCase, toKebabCase, toPascalCase };

package/dist/{plugin-D8K5fG-O.mjs → plugin-DfomEcef.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.1.0
+ * @forinda/kickjs-cli v5.2.1
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,8 +8,8 @@
  *
  * @license MIT
  */
-import { t as __exportAll } from "./rolldown-runtime-BM29JyaJ.mjs";
-import { t as KickPluginConflictError } from "./types-BBUo1vXh.mjs";
+import { t as __exportAll } from "./rolldown-runtime-CV_zlh2d.mjs";
+import { t as KickPluginConflictError } from "./types-CU89yUxU.mjs";
 //#region src/plugin/merge.ts
 function mergeCliPlugins(plugins, adopterCommands = []) {
 	const seenPluginNames = /* @__PURE__ */ new Map();
@@ -68,4 +68,4 @@ var plugin_exports = /* @__PURE__ */ __exportAll({ mergeCliPlugins: () => mergeC
 //#endregion
 export { mergeCliPlugins as n, plugin_exports as t };
 
-//# sourceMappingURL=plugin-D8K5fG-O.mjs.map
+//# sourceMappingURL=plugin-DfomEcef.mjs.map

package/dist/{plugin-D8K5fG-O.mjs.map → plugin-DfomEcef.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"plugin-D8K5fG-O.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":";;;;;;;;;;;;;AA4CA,SAAgB,gBACd,SACA,kBAAoD,EAAE,EACvC;CAEf,MAAM,kCAAkB,IAAI,KAAqB;AACjD,MAAK,MAAM,KAAK,SAAS;EACvB,MAAM,SAAS,gBAAgB,IAAI,EAAE,KAAK,IAAI,KAAK;AACnD,kBAAgB,IAAI,EAAE,MAAM,MAAM;AAClC,MAAI,UAAU,EACZ,OAAM,IAAI,wBAAwB,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC;;CAIzE,MAAM,gCAAgB,IAAI,KAAqB;CAC/C,MAAM,iBAA0C,EAAE;AAClD,MAAK,MAAM,KAAK,QACd,MAAK,MAAM,OAAO,EAAE,YAAY,EAAE,EAAE;EAClC,MAAM,QAAQ,cAAc,IAAI,IAAI,KAAK;AACzC,MAAI,MACF,OAAM,IAAI,wBAAwB,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;AAEzE,gBAAc,IAAI,IAAI,MAAM,EAAE,KAAK;AACnC,iBAAe,KAAK,IAAI;;CAI5B,MAAM,eAAe,IAAI,IAAI,gBAAgB,KAAK,MAAM,EAAE,KAAK,CAAC;CAEhE,MAAM,WAAW,CAAC,GADK,eAAe,QAAQ,MAAM,CAAC,aAAa,IAAI,EAAE,KAAK,CAAC,EACzC,GAAG,gBAAgB;CAExD,MAAM,gCAAgB,IAAI,KAAqB;CAC/C,MAAM,WAA4B,EAAE;AACpC,MAAK,MAAM,KAAK,QACd,MAAK,MAAM,MAAM,EAAE,YAAY,EAAE,EAAE;EACjC,MAAM,QAAQ,cAAc,IAAI,GAAG,GAAG;AACtC,MAAI,MACF,OAAM,IAAI,wBAAwB,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;AAEtE,gBAAc,IAAI,GAAG,IAAI,EAAE,KAAK;AAChC,WAAS,KAAK,GAAG;;CAIrB,MAAM,kCAAkB,IAAI,KAAqB;CACjD,MAAM,aAAoC,EAAE;AAC5C,MAAK,MAAM,KAAK,QACd,MAAK,MAAM,QAAQ,EAAE,cAAc,EAAE,EAAE;EACrC,MAAM,QAAQ,gBAAgB,IAAI,KAAK,KAAK;AAC5C,MAAI,MACF,OAAM,IAAI,wBAAwB,aAAa,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;AAE5E,kBAAgB,IAAI,KAAK,MAAM,EAAE,KAAK;AACtC,aAAW,KAAK;GAAE,QAAQ,EAAE;GAAY;GAA8B,CAAC;;CAI3E,MAAM,WAAW,OAAO,SAAkB,QAA8C;EACtF,MAAM,WAAiC,OAAO;GAC5C,KAAK,QAAQ,KAAK;GAClB,QAAQ;GACR,WAAW;GACZ;AACD,OAAK,MAAM,KAAK,QACd,KAAI,EAAE,SAAU,OAAM,EAAE,SAAS,SAAS,SAAS;;AAIvD,QAAO;EAAE;EAAU;EAAU;EAAY;EAAU"}
+{"version":3,"file":"plugin-DfomEcef.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":";;;;;;;;;;;;;AA4CA,SAAgB,gBACd,SACA,kBAAoD,EAAE,EACvC;CAEf,MAAM,kCAAkB,IAAI,KAAqB;AACjD,MAAK,MAAM,KAAK,SAAS;EACvB,MAAM,SAAS,gBAAgB,IAAI,EAAE,KAAK,IAAI,KAAK;AACnD,kBAAgB,IAAI,EAAE,MAAM,MAAM;AAClC,MAAI,UAAU,EACZ,OAAM,IAAI,wBAAwB,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC;;CAIzE,MAAM,gCAAgB,IAAI,KAAqB;CAC/C,MAAM,iBAA0C,EAAE;AAClD,MAAK,MAAM,KAAK,QACd,MAAK,MAAM,OAAO,EAAE,YAAY,EAAE,EAAE;EAClC,MAAM,QAAQ,cAAc,IAAI,IAAI,KAAK;AACzC,MAAI,MACF,OAAM,IAAI,wBAAwB,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;AAEzE,gBAAc,IAAI,IAAI,MAAM,EAAE,KAAK;AACnC,iBAAe,KAAK,IAAI;;CAI5B,MAAM,eAAe,IAAI,IAAI,gBAAgB,KAAK,MAAM,EAAE,KAAK,CAAC;CAEhE,MAAM,WAAW,CAAC,GADK,eAAe,QAAQ,MAAM,CAAC,aAAa,IAAI,EAAE,KAAK,CAAC,EACzC,GAAG,gBAAgB;CAExD,MAAM,gCAAgB,IAAI,KAAqB;CAC/C,MAAM,WAA4B,EAAE;AACpC,MAAK,MAAM,KAAK,QACd,MAAK,MAAM,MAAM,EAAE,YAAY,EAAE,EAAE;EACjC,MAAM,QAAQ,cAAc,IAAI,GAAG,GAAG;AACtC,MAAI,MACF,OAAM,IAAI,wBAAwB,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;AAEtE,gBAAc,IAAI,GAAG,IAAI,EAAE,KAAK;AAChC,WAAS,KAAK,GAAG;;CAIrB,MAAM,kCAAkB,IAAI,KAAqB;CACjD,MAAM,aAAoC,EAAE;AAC5C,MAAK,MAAM,KAAK,QACd,MAAK,MAAM,QAAQ,EAAE,cAAc,EAAE,EAAE;EACrC,MAAM,QAAQ,gBAAgB,IAAI,KAAK,KAAK;AAC5C,MAAI,MACF,OAAM,IAAI,wBAAwB,aAAa,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;AAE5E,kBAAgB,IAAI,KAAK,MAAM,EAAE,KAAK;AACtC,aAAW,KAAK;GAAE,QAAQ,EAAE;GAAY;GAA8B,CAAC;;CAI3E,MAAM,WAAW,OAAO,SAAkB,QAA8C;EACtF,MAAM,WAAiC,OAAO;GAC5C,KAAK,QAAQ,KAAK;GAClB,QAAQ;GACR,WAAW;GACZ;AACD,OAAK,MAAM,KAAK,QACd,KAAI,EAAE,SAAU,OAAM,EAAE,SAAS,SAAS,SAAS;;AAIvD,QAAO;EAAE;EAAU;EAAU;EAAY;EAAU"}

package/dist/{plugin-Bgfg7qMk.mjs → plugin-b7ig7Uxv.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.1.0
+ * @forinda/kickjs-cli v5.2.1
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import { t as __exportAll } from "./rolldown-runtime-BM29JyaJ.mjs";
+import { t as __exportAll } from "./rolldown-runtime-CV_zlh2d.mjs";
 //#region src/plugin/types.ts
 /** Identity helper — exists for type inference + parity with definePlugin. */
 function defineCliPlugin(p) {

package/dist/{rolldown-runtime-BM29JyaJ.mjs → rolldown-runtime-CV_zlh2d.mjs}

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

package/dist/{run-plugins-BXvMFPhJ.mjs → run-plugins-D9abb5Nx.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.1.0
+ * @forinda/kickjs-cli v5.2.1
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import { n as applyDisableFilter, t as runAllPluginTypegens } from "./builtins-caRjFvKz.mjs";
+import { n as applyDisableFilter, t as runAllPluginTypegens } from "./builtins-B0dptoXq.mjs";
 export { applyDisableFilter, runAllPluginTypegens };