@kubb/core 5.0.0-beta.109 → 5.0.0-beta.110

package/dist/mocks.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { $ as PluginFactoryOptions, Ht as AdapterFactoryOptions, I as KubbDriver, M as Generator, R as Parser, Vt as Adapter, q as NormalizedPlugin, r as Config } from "./types-TqpVzVtY.js";
+import { $ as PluginFactoryOptions, Ht as AdapterFactoryOptions, I as KubbDriver, M as Generator, R as Parser, Vt as Adapter, q as NormalizedPlugin, r as Config } from "./types-Ba5Mo-G8.js";
 import { FileNode, InputMeta, Macro, OperationNode, SchemaNode } from "@kubb/ast";
 //#region src/mocks.d.ts
 /**

package/dist/{types-TqpVzVtY.d.ts → types-Ba5Mo-G8.d.ts}

@@ -1291,7 +1291,7 @@ type Output = {
    * - `'file'` writes everything into a single file. The `path` must include the file extension.
    * - `'directory'` writes one file per operation or schema under `path`.
    *
-   * @default 'file'
+   * Defaults to `'file'` when `path` carries an extension and `'directory'` when it does not.
    */
   mode?: OutputMode;
   /**
@@ -1334,9 +1334,13 @@ type Group = {
 };
 /**
  * Couples `output.mode` with the plugin's `group` option at the type level.
- * - `mode: 'file'` (or no mode) forbids `group` (a single file has nothing to group).
- * - `mode: 'directory'` allows an optional `group` to organize files into
- *   per-group subdirectories.
+ * - An explicit `mode: 'file'` forbids `group` (a single file has nothing to group).
+ * - Omitting `mode`, or setting it to `'directory'`, allows an optional `group`.
+ *
+ * `mode` is normally inferred from `output.path` (an extension means `'file'`, anything
+ * else `'directory'`), so `group` rarely needs `mode` spelled out alongside it. Set
+ * `mode: 'directory'` explicitly only to override that inference, such as a directory
+ * name that carries a dot (`path: 'clients.v2'`).
  *
  * Intersect into a plugin's `Options` type instead of declaring `output` and
  * `group` directly, since `mode` lives inside `output` while `group` is its sibling.
@@ -1351,14 +1355,14 @@ type Group = {
  */
 type OutputOptions<TOutput extends Output = Output> = {
   output?: TOutput & {
-    mode?: 'file';
+    mode?: 'directory';
   };
-  group?: never;
+  group?: Group;
 } | {
-  output: TOutput & {
-    mode: 'directory';
+  output?: TOutput & {
+    mode: 'file';
   };
-  group?: Group;
+  group?: never;
 };
 type ByTag = {
   /**
@@ -3009,4 +3013,4 @@ type BuildOutput = {
 };
 //#endregion
 export { PluginFactoryOptions as $, Kubb$1 as A, DiagnosticDoc as At, Exclude$1 as B, Hookable as Bt, KubbWarnContext as C, Reporter as Ct, CreateKubbOptions as D, createReporter as Dt, UserConfig as E, UserReporter as Et, NodeCache as F, PerformanceDiagnostic as Ft, KubbPluginSetupContext as G, Group as H, AdapterFactoryOptions as Ht, KubbDriver as I, ProblemCode as It, Output as J, KubbPluginStartContext as K, FileManagerHooks as L, ProblemDiagnostic as Lt, Generator as M, DiagnosticLocation as Mt, GeneratorContext as N, DiagnosticSeverity as Nt, GenerateOptions as O, logLevel as Ot, defineGenerator as P, Diagnostics as Pt, Plugin as Q, Parser as R, SerializedDiagnostic as Rt, KubbSuccessContext as S, GenerationResult as St, PostGenerateCommand as T, ReporterName as Tt, Include as U, AdapterSource as Ut, Filter as V, Adapter as Vt, KubbPluginEndContext as W, createAdapter as Wt, OutputOptions as X, OutputMode as Y, Override as Z, KubbHookStartContext as _, Renderer as _t, KubbBuildEndContext as a, ResolveBannerFile as at, KubbLifecycleStartContext as b, Storage as bt, KubbErrorContext as c, ResolveOptionsContext as ct, KubbFilesProcessingStartContext as d, ResolverDefault as dt, PluginName as et, KubbFilesProcessingUpdateContext as f, ResolverFile as ft, KubbHookLineContext as g, ResolverPathParams as gt, KubbHookEndContext as h, ResolverPatch as ht, Input as i, ResolveBannerContext as it, createKubb as j, DiagnosticKind as jt, GenerateResult as k, Diagnostic as kt, KubbFileProcessingUpdate as l, ResolvePathOptions as lt, KubbGenerationStartContext as m, ResolverFilePathParams as mt, CLIOptions as n, definePlugin as nt, KubbBuildStartContext as o, ResolveFileOptions as ot, KubbGenerationEndContext as p, ResolverFileParams as pt, NormalizedPlugin as q, Config as r, BannerMeta as rt, KubbDiagnosticContext as s, ResolveImportsOptions as st, BuildOutput as t, ResolvePluginOptions as tt, KubbFilesProcessingEndContext as u, Resolver as ut, KubbHooks as v, RendererFactory as vt, PossibleConfig as w, ReporterContext as wt, KubbPluginsEndContext as x, createStorage as xt, KubbInfoContext as y, createRenderer as yt, defineParser as z, UpdateDiagnostic as zt };
-//# sourceMappingURL=types-TqpVzVtY.d.ts.map
+//# sourceMappingURL=types-Ba5Mo-G8.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-beta.109",
+  "version": "5.0.0-beta.110",
   "description": "Core engine for Kubb. Provides the plugin driver, file manager and build orchestration used by every Kubb plugin.",
   "keywords": [
     "code-generator",
@@ -55,7 +55,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/ast": "5.0.0-beta.109"
+    "@kubb/ast": "5.0.0-beta.110"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0"