@hey-api/openapi-ts 0.91.0 → 0.92.0

package/dist/{init-kvO44gnv.mjs → init-DlaW5Djq.mjs}

@@ -140,6 +140,7 @@ function getOutput(userConfig) {
 	const output = valueToObject({
 		defaultValue: {
 			clean: true,
+			entryFile: true,
 			fileName: {
 				case: "preserve",
 				name: "{{name}}",
@@ -147,7 +148,6 @@ function getOutput(userConfig) {
 			},
 			format: null,
 			header: "// This file is auto-generated by @hey-api/openapi-ts",
-			indexFile: true,
 			lint: null,
 			path: "",
 			postProcess: [],
@@ -395,12 +395,12 @@ function getTypedConfig(plugin) {
 
 //#endregion
 //#region src/plugins/@hey-api/client-core/utils.ts
-const getClientBaseUrlKey = (config) => {
+function getClientBaseUrlKey(config) {
 	const client = getClientPlugin(config);
 	if (client.name === "@hey-api/client-axios" || client.name === "@hey-api/client-nuxt") return "baseURL";
 	return "baseUrl";
-};
-const getClientPlugin = (config) => {
+}
+function getClientPlugin(config) {
 	for (const name of config.pluginOrder) {
 		const plugin = config.plugins[name];
 		if (plugin?.tags?.includes("client")) return plugin;
@@ -409,7 +409,7 @@ const getClientPlugin = (config) => {
 		config: { name: "" },
 		name: ""
 	};
-};
+}
 
 //#endregion
 //#region src/ts-dsl/base.ts
@@ -587,6 +587,10 @@ var PrefixTsDsl = class extends Mixed$51 {
 		super.analyze(ctx$1);
 		ctx$1.analyze(this._expr);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Sets the operand (the expression being prefixed). */
 	expr(expr) {
 		this._expr = expr;
@@ -608,10 +612,20 @@ var PrefixTsDsl = class extends Mixed$51 {
 		return this;
 	}
 	toAst() {
-		if (!this._expr) throw new Error("Missing expression for prefix unary expression");
-		if (!this._op) throw new Error("Missing operator for prefix unary expression");
+		this.$validate();
 		return ts.factory.createPrefixUnaryExpression(this._op, this.$node(this._expr));
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Prefix unary expression missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._expr) missing.push(".expr()");
+		if (!this._op) missing.push("operator (e.g., .not(), .neg())");
+		return missing;
+	}
 };
 
 //#endregion
@@ -876,7 +890,7 @@ const safePropName = (name) => {
 const safeName = (name, reserved$1) => {
 	let sanitized = "";
 	let index;
-	const first = name[0];
+	const first = name[0] ?? "";
 	regexp.illegalStartCharacters.lastIndex = 0;
 	if (regexp.illegalStartCharacters.test(first)) {
 		sanitized += "_";
@@ -886,7 +900,7 @@ const safeName = (name, reserved$1) => {
 		index = 1;
 	}
 	while (index < name.length) {
-		const char = name[index];
+		const char = name[index] ?? "";
 		sanitized += /^[\u200c\u200d\p{ID_Continue}]$/u.test(char) ? char : "_";
 		index += 1;
 	}
@@ -1451,9 +1465,23 @@ var TokenTsDsl = class extends TsDsl {
 		return this.kind(ts.SyntaxKind.DotDotDotToken);
 	}
 	toAst() {
-		if (!this._kind) throw new Error(`Token missing \`.kind(kind)\``);
+		this.$validate();
 		return ts.factory.createToken(this._kind);
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Token missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._kind) missing.push(".kind()");
+		return missing;
+	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 };
 
 //#endregion
@@ -1535,6 +1563,10 @@ var TypeAttrTsDsl = class extends Mixed$47 {
 		ctx$1.analyze(this._base);
 		ctx$1.analyze(this._right);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	base(base) {
 		if (isRef(base)) this._base = base;
 		else this._base = base ? ref(base) : void 0;
@@ -1545,11 +1577,22 @@ var TypeAttrTsDsl = class extends Mixed$47 {
 		return this;
 	}
 	toAst() {
-		if (!this._base) throw new Error("TypeAttrTsDsl: missing base for qualified name");
+		this.$validate();
 		const left = this.$node(this._base);
 		if (!ts.isEntityName(left)) throw new Error("TypeAttrTsDsl: base must be an EntityName");
 		return ts.factory.createQualifiedName(left, this.$node(this._right));
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Type attribute missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._base) missing.push(".base()");
+		if (!this._right) missing.push(".right()");
+		return missing;
+	}
 };
 
 //#endregion
@@ -1571,15 +1614,29 @@ var TypeExprTsDsl = class extends Mixed$46 {
 		super.analyze(ctx$1);
 		ctx$1.analyze(this._exprInput);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Accesses a nested type (e.g. `Foo.Bar`). */
 	attr(right) {
 		this._exprInput = isNode(right) ? ref(right.base(this._exprInput)) : ref(new TypeAttrTsDsl(this._exprInput, right));
 		return this;
 	}
 	toAst() {
-		if (!this._exprInput) throw new Error("TypeExpr must have an expression");
+		this.$validate();
 		return ts.factory.createTypeReferenceNode(this.$type(this._exprInput), this.$generics());
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Type expression missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._exprInput) missing.push("name or .attr()");
+		return missing;
+	}
 };
 f.type.expr.set((...args) => new TypeExprTsDsl(...args));
 
@@ -1672,6 +1729,10 @@ var PatternTsDsl = class extends Mixed$43 {
 	analyze(ctx$1) {
 		super.analyze(ctx$1);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Defines an array pattern (e.g. `[a, b, c]`). */
 	array(...props) {
 		this.pattern = {
@@ -1698,7 +1759,7 @@ var PatternTsDsl = class extends Mixed$43 {
 		return this;
 	}
 	toAst() {
-		if (!this.pattern) throw new Error("PatternTsDsl requires object() or array() pattern");
+		this.$validate();
 		if (this.pattern.kind === "object") {
 			const elements = Object.entries(this.pattern.values).map(([key, alias]) => key === alias ? ts.factory.createBindingElement(void 0, void 0, key, void 0) : ts.factory.createBindingElement(void 0, key, alias, void 0));
 			const spread = this.createSpread();
@@ -1713,6 +1774,16 @@ var PatternTsDsl = class extends Mixed$43 {
 		}
 		throw new Error("PatternTsDsl requires object() or array() pattern");
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Binding pattern missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this.pattern) missing.push(".array() or .object()");
+		return missing;
+	}
 	createSpread() {
 		return this._spread ? ts.factory.createBindingElement(this.$node(new TokenTsDsl().spread()), void 0, this.$node(new IdTsDsl(this._spread))) : void 0;
 	}
@@ -1771,15 +1842,28 @@ var ParamTsDsl = class extends Mixed$42 {
 		ctx$1.analyze(this.name);
 		ctx$1.analyze(this._type);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Sets the parameter type. */
 	type(type) {
 		this._type = type instanceof TypeTsDsl ? type : new TypeExprTsDsl(type);
 		return this;
 	}
 	toAst() {
-		const name = this.$pattern() || this.name.toString();
-		if (!name) throw new Error("Param must have either a name or a destructuring pattern");
-		return ts.factory.createParameterDeclaration(this.$decorators(), void 0, name, this._optional ? this.$node(new TokenTsDsl().optional()) : void 0, this.$type(this._type), this.$value());
+		this.$validate();
+		return ts.factory.createParameterDeclaration(this.$decorators(), void 0, this.$pattern() ?? this.name.toString(), this._optional ? this.$node(new TokenTsDsl().optional()) : void 0, this.$type(this._type), this.$value());
+	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Parameter missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this.$pattern() && !this.name.toString()) missing.push("name or pattern (.array()/.object())");
+		return missing;
 	}
 };
 
@@ -2094,6 +2178,10 @@ var ImplFuncTsDsl = class extends Mixed$35 {
 			ctx$1.popScope();
 		}
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Switches the function to an arrow function form. */
 	arrow() {
 		this.mode = "arrow";
@@ -2110,9 +2198,9 @@ var ImplFuncTsDsl = class extends Mixed$35 {
 		return this;
 	}
 	toAst() {
+		this.$validate();
 		const body = this.$node(new BlockTsDsl(...this._do).pretty());
 		if (this.mode === "decl") {
-			if (!this.name.toString()) throw new Error("Function declaration requires a name");
 			const node$1 = ts.factory.createFunctionDeclaration([...this.$decorators(), ...this.modifiers], void 0, this.$node(this.name), this.$generics(), this.$params(), this.$returns(), body);
 			return this.$docs(node$1);
 		}
@@ -2123,6 +2211,16 @@ var ImplFuncTsDsl = class extends Mixed$35 {
 		const node = ts.factory.createArrowFunction(this.modifiers, this.$generics(), this.$params(), this.$returns(), void 0, body.statements.length === 1 && ts.isReturnStatement(body.statements[0]) && body.statements[0].expression ? body.statements[0].expression : body);
 		return this.$docs(node);
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Function ${this.mode} missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (this.mode === "decl" && !this.name.toString()) missing.push("name");
+		return missing;
+	}
 };
 const FuncTsDsl = ImplFuncTsDsl;
 
@@ -2288,6 +2386,10 @@ var BinaryTsDsl = class extends Mixed$30 {
 		ctx$1.analyze(this._base);
 		ctx$1.analyze(this._expr);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Logical AND — `this && expr` */
 	and(expr) {
 		return this.opAndExpr("&&", expr);
@@ -2357,12 +2459,21 @@ var BinaryTsDsl = class extends Mixed$30 {
 		return this.opAndExpr("*", expr);
 	}
 	toAst() {
-		if (!this._op) throw new Error("BinaryTsDsl: missing operator");
-		const expr = this.$node(this._expr);
-		if (!expr) throw new Error("BinaryTsDsl: missing right-hand expression");
+		this.$validate();
 		const base = this.$node(this._base);
 		const operator = typeof this._op === "string" ? this.opToToken(this._op) : this._op;
-		return ts.factory.createBinaryExpression(base, operator, expr);
+		return ts.factory.createBinaryExpression(base, operator, this.$node(this._expr));
+	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Binary expression missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._op) missing.push("operator (e.g., .eq(), .plus())");
+		if (!this._expr) missing.push("right-hand expression");
+		return missing;
 	}
 	/** Sets the binary operator and right-hand operand for this expression. */
 	opAndExpr(op, expr) {
@@ -2886,6 +2997,10 @@ var TernaryTsDsl = class extends Mixed$20 {
 		ctx$1.analyze(this._then);
 		ctx$1.analyze(this._else);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	condition(condition) {
 		this._condition = condition;
 		return this;
@@ -2899,11 +3014,21 @@ var TernaryTsDsl = class extends Mixed$20 {
 		return this;
 	}
 	toAst() {
-		if (!this._condition) throw new Error("Missing condition in ternary");
-		if (!this._then) throw new Error("Missing then expression in ternary");
-		if (!this._else) throw new Error("Missing else expression in ternary");
+		this.$validate();
 		return ts.factory.createConditionalExpression(this.$node(this._condition), void 0, this.$node(this._then), void 0, this.$node(this._else));
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Ternary expression missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._condition) missing.push(".condition()");
+		if (!this._then) missing.push(".do()");
+		if (!this._else) missing.push(".otherwise()");
+		return missing;
+	}
 };
 
 //#endregion
@@ -2981,6 +3106,10 @@ var IfTsDsl = class extends Mixed$18 {
 			}
 		}
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	condition(condition) {
 		this._condition = condition;
 		return this;
@@ -2990,10 +3119,20 @@ var IfTsDsl = class extends Mixed$18 {
 		return this;
 	}
 	toAst() {
-		if (!this._condition) throw new Error("Missing condition in if");
-		if (!this._do) throw new Error("Missing then block in if");
+		this.$validate();
 		return ts.factory.createIfStatement(this.$node(this._condition), this.$node(new BlockTsDsl(...this._do).pretty()), this._else ? this.$node(new BlockTsDsl(...this._else).pretty()) : void 0);
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`If statement missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._condition) missing.push(".condition()");
+		if (this._do.length === 0) missing.push(".do()");
+		return missing;
+	}
 };
 
 //#endregion
@@ -3088,6 +3227,10 @@ var TryTsDsl = class extends Mixed$15 {
 			}
 		}
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	catch(...items) {
 		this._catch = items;
 		return this;
@@ -3105,10 +3248,20 @@ var TryTsDsl = class extends Mixed$15 {
 		return this;
 	}
 	toAst() {
-		if (!this._try?.length) throw new Error("Missing try block");
+		this.$validate();
 		const catchParam = this._catchArg ? this.$node(this._catchArg) : void 0;
 		return ts.factory.createTryStatement(this.$node(new BlockTsDsl(...this._try).pretty()), ts.factory.createCatchClause(catchParam ? ts.factory.createVariableDeclaration(catchParam) : void 0, this.$node(new BlockTsDsl(...this._catch ?? []).pretty())), this._finally ? this.$node(new BlockTsDsl(...this._finally).pretty()) : void 0);
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Try statement missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._try || this._try.length === 0) missing.push(".try()");
+		return missing;
+	}
 };
 
 //#endregion
@@ -3129,6 +3282,10 @@ var VarTsDsl = class extends Mixed$14 {
 		ctx$1.analyze(this.name);
 		ctx$1.analyze(this._type);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	const() {
 		this.kind = ts.NodeFlags.Const;
 		return this;
@@ -3147,11 +3304,20 @@ var VarTsDsl = class extends Mixed$14 {
 		return this;
 	}
 	toAst() {
-		const name = this.$pattern() ?? this.$node(this.name);
-		if (!name) throw new Error("Var must have either a name or a destructuring pattern");
-		const node = ts.factory.createVariableStatement(this.modifiers, ts.factory.createVariableDeclarationList([ts.factory.createVariableDeclaration(name, void 0, this.$type(this._type), this.$value())], this.kind));
+		this.$validate();
+		const node = ts.factory.createVariableStatement(this.modifiers, ts.factory.createVariableDeclarationList([ts.factory.createVariableDeclaration(this.$pattern() ?? this.$node(this.name), void 0, this.$type(this._type), this.$value())], this.kind));
 		return this.$docs(this.$hint(node));
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Variable declaration missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this.$pattern() && !this.name.toString()) missing.push("name or pattern (.array()/.object())");
+		return missing;
+	}
 };
 
 //#endregion
@@ -3173,16 +3339,31 @@ var TypeAliasTsDsl = class extends Mixed$13 {
 		ctx$1.analyze(this.name);
 		ctx$1.analyze(this.value);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Sets the type expression on the right-hand side of `= ...`. */
 	type(node) {
 		this.value = node;
 		return this;
 	}
 	toAst() {
-		if (!this.value) throw new Error(`Type alias '${this.name.toString()}' is missing a type definition`);
+		this.$validate();
 		const node = ts.factory.createTypeAliasDeclaration(this.modifiers, this.$node(this.name), this.$generics(), this.$type(this.value));
 		return this.$docs(node);
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		const name = this.name.toString();
+		throw new Error(`Type alias${name ? ` "${name}"` : ""} missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this.value) missing.push(".type()");
+		return missing;
+	}
 };
 
 //#endregion
@@ -3317,17 +3498,32 @@ var TypePropTsDsl = class extends Mixed$9 {
 		super.analyze(ctx$1);
 		ctx$1.analyze(this._type);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	/** Sets the property type. */
 	type(type) {
 		this._type = ref(type);
 		return this;
 	}
 	toAst() {
+		this.$validate();
 		const name = this.name.toString();
-		if (!this._type || !name) throw new Error(`Type not specified for property '${name}'`);
 		const node = ts.factory.createPropertySignature(this.modifiers, this.$node(safePropName(name)), this._optional ? this.$node(new TokenTsDsl().optional()) : void 0, this.$type(this._type));
 		return this.$docs(node);
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		const name = this.name.toString();
+		throw new Error(`Type property${name ? ` "${name}"` : ""} missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (!this._type) missing.push(".type()");
+		return missing;
+	}
 };
 
 //#endregion
@@ -3424,12 +3620,25 @@ var TypeFuncTsDsl = class extends Mixed$6 {
 	analyze(ctx$1) {
 		super.analyze(ctx$1);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	toAst() {
-		const returns = this.$returns();
-		if (returns === void 0) throw new Error("Missing return type in function type DSL");
-		const node = ts.factory.createFunctionTypeNode(this.$generics(), this.$params(), returns);
+		this.$validate();
+		const node = ts.factory.createFunctionTypeNode(this.$generics(), this.$params(), this.$returns());
 		return this.$docs(node);
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Function type missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (this.$returns() === void 0) missing.push(".returns()");
+		return missing;
+	}
 };
 
 //#endregion
@@ -3450,6 +3659,10 @@ var TypeIdxTsDsl = class extends Mixed$5 {
 		ctx$1.analyze(this._base);
 		ctx$1.analyze(this._index);
 	}
+	/** Returns true when all required builder calls are present. */
+	get isValid() {
+		return this.missingRequiredCalls().length === 0;
+	}
 	base(base) {
 		this._base = base;
 		return this;
@@ -3459,8 +3672,20 @@ var TypeIdxTsDsl = class extends Mixed$5 {
 		return this;
 	}
 	toAst() {
+		this.$validate();
 		return ts.factory.createIndexedAccessTypeNode(this.$type(this._base), this.$type(this._index));
 	}
+	$validate() {
+		const missing = this.missingRequiredCalls();
+		if (missing.length === 0) return;
+		throw new Error(`Indexed access type missing ${missing.join(" and ")}`);
+	}
+	missingRequiredCalls() {
+		const missing = [];
+		if (this._base === void 0) missing.push(".base()");
+		if (this._index === void 0) missing.push(".index()");
+		return missing;
+	}
 };
 f.type.idx.set((...args) => new TypeIdxTsDsl(...args));
 
@@ -3751,7 +3976,7 @@ function astToString(node) {
 		return result;
 	}
 }
-const moduleSortKey = ({ file, fromFile, preferFileExtension, root }) => {
+function moduleSortKey({ file, fromFile, preferFileExtension, root }) {
 	const filePath = file.finalPath.split(path.sep).join("/");
 	let modulePath = fromFile.finalPath.split(path.sep).join("/");
 	if (fromFile.external && !path.isAbsolute(modulePath)) return [
@@ -3781,7 +4006,7 @@ const moduleSortKey = ({ file, fromFile, preferFileExtension, root }) => {
 		parentCount,
 		modulePath
 	];
-};
+}
 
 //#endregion
 //#region src/ts-dsl/utils/render.ts
@@ -4472,8 +4697,8 @@ function isInstance(plugin) {
 	return config.container === "class" && config.methods === "instance" && config.strategy !== "flat";
 }
 function attachComment$1(args) {
-	const { node, operation } = args;
-	return node.$if(createOperationComment(operation), (n, v) => n.doc(v));
+	const { node, operation, plugin } = args;
+	return node.$if(plugin.config.comments && createOperationComment(operation), (n, v) => n.doc(v));
 }
 function createShellMeta(node) {
 	return {
@@ -4614,7 +4839,8 @@ function toNode(model, plugin) {
 			}));
 			node$1 = attachComment$1({
 				node: node$1,
-				operation
+				operation,
+				plugin
 			});
 			nodes$1.push(node$1);
 			exampleIntent(node$1, operation, plugin);
@@ -4634,7 +4860,8 @@ function toNode(model, plugin) {
 			const method = implementFn({
 				node: $.method(createFnSymbol(plugin, item), (m) => attachComment$1({
 					node: m,
-					operation
+					operation,
+					plugin
 				}).public().static(!isAngularClient && !isInstance(plugin))),
 				operation,
 				plugin
@@ -4694,8 +4921,8 @@ function hasOperationSse({ operation }) {
 //#region src/plugins/@angular/common/shared/node.ts
 const source = globalThis.Symbol("@angular/common");
 function attachComment(args) {
-	const { node, operation } = args;
-	return node.$if(createOperationComment(operation), (n, v) => n.doc(v));
+	const { node, operation, plugin } = args;
+	return node.$if(plugin.config.comments && createOperationComment(operation), (n, v) => n.doc(v));
 }
 function createHttpRequestFnMeta(operation) {
 	return {
@@ -4841,7 +5068,8 @@ function toHttpRequestNode(model, plugin) {
 			}));
 			node$1 = attachComment({
 				node: node$1,
-				operation
+				operation,
+				plugin
 			});
 			nodes$1.push(node$1);
 		}
@@ -4858,7 +5086,8 @@ function toHttpRequestNode(model, plugin) {
 		node.do(implementHttpRequestFn({
 			node: $.method(createHttpRequestFnSymbol(plugin, item), (m) => attachComment({
 				node: m,
-				operation
+				operation,
+				plugin
 			}).public()),
 			operation,
 			plugin
@@ -4887,7 +5116,8 @@ function toHttpResourceNode(model, plugin) {
 			}));
 			node$1 = attachComment({
 				node: node$1,
-				operation
+				operation,
+				plugin
 			});
 			nodes$1.push(node$1);
 		}
@@ -4904,7 +5134,8 @@ function toHttpResourceNode(model, plugin) {
 		node.do(implementHttpResourceFn({
 			node: $.method(createHttpResourceFnSymbol(plugin, item), (m) => attachComment({
 				node: m,
-				operation
+				operation,
+				plugin
 			}).public()),
 			operation,
 			plugin
@@ -5005,7 +5236,10 @@ const handler$11 = ({ plugin }) => {
 //#endregion
 //#region src/plugins/@angular/common/config.ts
 const defaultConfig$23 = {
-	config: { exportFromIndex: false },
+	config: {
+		comments: true,
+		includeInEntry: false
+	},
 	dependencies: ["@hey-api/client-angular", "@hey-api/sdk"],
 	handler: handler$11,
 	name: "@angular/common",
@@ -5032,7 +5266,7 @@ const defaultConfig$22 = {
 	api: new Api$4(),
 	config: {
 		case: "camelCase",
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	handler: () => {},
 	name: "@faker-js/faker",
@@ -5063,7 +5297,7 @@ const defineConfig$22 = definePluginConfig(defaultConfig$22);
 const clientDefaultConfig = {
 	baseUrl: true,
 	bundle: true,
-	exportFromIndex: false
+	includeInEntry: false
 };
 const clientDefaultMeta = {
 	dependencies: ["@hey-api/typescript"],
@@ -5075,22 +5309,48 @@ const clientDefaultMeta = {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 /**
+* Dev mode: 'src' appears after 'dist' (or dist doesn't exist), and 'generate' follows 'src'
+*/
+function isDevMode() {
+	const normalized = __dirname.split(path.sep);
+	const srcIndex = normalized.lastIndexOf("src");
+	const distIndex = normalized.lastIndexOf("dist");
+	return srcIndex !== -1 && srcIndex > distIndex && srcIndex === normalized.length - 2 && normalized[srcIndex + 1] === "generate";
+}
+/**
+* Returns paths to client bundle files based on execution context
+*/
+function getClientBundlePaths(pluginName) {
+	const clientName = pluginName.slice(16);
+	if (isDevMode()) {
+		const pluginsDir = path.resolve(__dirname, "..", "plugins", "@hey-api");
+		return {
+			clientPath: path.resolve(pluginsDir, `client-${clientName}`, "bundle"),
+			corePath: path.resolve(pluginsDir, "client-core", "bundle")
+		};
+	}
+	return {
+		clientPath: path.resolve(__dirname, "clients", clientName),
+		corePath: path.resolve(__dirname, "clients", "core")
+	};
+}
+/**
 * Returns absolute path to the client folder. This is hard-coded for now.
 */
-const clientFolderAbsolutePath = (config) => {
+function clientFolderAbsolutePath(config) {
 	const client = getClientPlugin(config);
 	if ("bundle" in client.config && client.config.bundle) {
 		const renamed = config._FRAGILE_CLIENT_BUNDLE_RENAMED;
 		return path.resolve(config.output.path, "client", `${renamed?.get("index") ?? "index"}.ts`);
 	}
 	return client.name;
-};
+}
 /**
 * Recursively copies files and directories.
 * This is a PnP-compatible alternative to fs.cpSync that works with Yarn PnP's
 * virtualized filesystem.
 */
-const copyRecursivePnP = (src, dest) => {
+function copyRecursivePnP(src, dest) {
 	if (fs.statSync(src).isDirectory()) {
 		if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
 		const files = fs.readdirSync(src);
@@ -5099,8 +5359,8 @@ const copyRecursivePnP = (src, dest) => {
 		const content = fs.readFileSync(src);
 		fs.writeFileSync(dest, content);
 	}
-};
-const renameFile = ({ filePath, project, renamed }) => {
+}
+function renameFile({ filePath, project, renamed }) {
 	const extension = path.extname(filePath);
 	const name = path.basename(filePath, extension);
 	const renamedName = project.fileName?.(name) || name;
@@ -5109,9 +5369,13 @@ const renameFile = ({ filePath, project, renamed }) => {
 		fs.renameSync(filePath, path.resolve(outputPath, `${renamedName}${extension}`));
 		renamed.set(name, renamedName);
 	}
-};
-const replaceImports = ({ filePath, meta, renamed }) => {
+}
+function replaceImports({ filePath, isDevMode: isDevMode$1, meta, renamed }) {
 	let content = fs.readFileSync(filePath, "utf8");
+	if (isDevMode$1) {
+		content = content.replace(/from\s+['"]\.\.\/\.\.\/client-core\/bundle\//g, "from '../core/");
+		content = content.replace(/from\s+['"]\.\.\/\.\.\/client-core\/bundle['"]/g, "from '../core'");
+	}
 	content = content.replace(/from\s+['"](\.\.?\/[^'"]*?)['"]/g, (match, importPath) => {
 		const importIndex = match.indexOf(importPath);
 		const extension = path.extname(importPath);
@@ -5124,20 +5388,21 @@ const replaceImports = ({ filePath, meta, renamed }) => {
 
 ${content}`;
 	fs.writeFileSync(filePath, content, "utf8");
-};
+}
 /**
 * Creates a `client` folder containing the same modules as the client package.
 */
-const generateClientBundle = ({ meta, outputPath, plugin, project }) => {
+function generateClientBundle({ meta, outputPath, plugin, project }) {
 	const renamed = /* @__PURE__ */ new Map();
+	const devMode = isDevMode();
 	if (plugin.name.startsWith("@hey-api/client-")) {
+		const { clientPath, corePath } = getClientBundlePaths(plugin.name);
 		const coreOutputPath = path.resolve(outputPath, "core");
 		ensureDirSync(coreOutputPath);
-		copyRecursivePnP(path.resolve(__dirname, "clients", "core"), coreOutputPath);
+		copyRecursivePnP(corePath, coreOutputPath);
 		const clientOutputPath = path.resolve(outputPath, "client");
 		ensureDirSync(clientOutputPath);
-		const clientDistFolderName = plugin.name.slice(16);
-		copyRecursivePnP(path.resolve(__dirname, "clients", clientDistFolderName), clientOutputPath);
+		copyRecursivePnP(clientPath, clientOutputPath);
 		if (project) {
 			const copiedCoreFiles = fs.readdirSync(coreOutputPath);
 			for (const file of copiedCoreFiles) renameFile({
@@ -5155,12 +5420,14 @@ const generateClientBundle = ({ meta, outputPath, plugin, project }) => {
 		const coreFiles = fs.readdirSync(coreOutputPath);
 		for (const file of coreFiles) replaceImports({
 			filePath: path.resolve(coreOutputPath, file),
+			isDevMode: devMode,
 			meta,
 			renamed
 		});
 		const clientFiles = fs.readdirSync(clientOutputPath);
 		for (const file of clientFiles) replaceImports({
 			filePath: path.resolve(clientOutputPath, file),
+			isDevMode: devMode,
 			meta,
 			renamed
 		});
@@ -5183,7 +5450,7 @@ const generateClientBundle = ({ meta, outputPath, plugin, project }) => {
 	const dirPath = path.resolve(outputPath, "client");
 	ensureDirSync(dirPath);
 	for (const file of distFiles) fs.copyFileSync(path.resolve(clientDistPath, file), path.resolve(dirPath, file));
-};
+}
 
 //#endregion
 //#region src/plugins/@hey-api/client-core/client.ts
@@ -5626,7 +5893,7 @@ const handler$10 = ({ plugin }) => {
 //#region src/plugins/@hey-api/schemas/config.ts
 const defaultConfig$14 = {
 	config: {
-		exportFromIndex: false,
+		includeInEntry: false,
 		nameBuilder: (name) => `${name}Schema`,
 		type: "json"
 	},
@@ -5936,7 +6203,8 @@ const defaultConfig$13 = {
 	config: {
 		auth: true,
 		client: true,
-		exportFromIndex: true,
+		comments: true,
+		includeInEntry: true,
 		paramsStructure: "grouped",
 		responseStyle: "fields",
 		transformer: false,
@@ -6156,7 +6424,7 @@ const defaultConfig$12 = {
 	config: {
 		bigInt: true,
 		dates: true,
-		exportFromIndex: false,
+		includeInEntry: false,
 		transformers: [],
 		typeTransformers: []
 	},
@@ -6257,10 +6525,10 @@ const exportType = ({ plugin, schema, state, type }) => {
 				tags: fromRef(state.tags),
 				tool: "typescript"
 			} });
-			const objectNode = $.const(symbolObject).export().$if(createSchemaComment(schema), (c, v) => c.doc(v)).assign($.object(...enumObject.obj.map((item) => $.prop({
+			const objectNode = $.const(symbolObject).export().$if(plugin.config.comments && createSchemaComment(schema), (c, v) => c.doc(v)).assign($.object(...enumObject.obj.map((item) => $.prop({
 				kind: "prop",
 				name: item.key
-			}).$if(createSchemaComment(item.schema), (p, v) => p.doc(v)).value($.fromValue(item.schema.const)))).as("const"));
+			}).$if(plugin.config.comments && createSchemaComment(item.schema), (p, v) => p.doc(v)).value($.fromValue(item.schema.const)))).as("const"));
 			plugin.node(objectNode);
 			const symbol$1 = plugin.symbol(applyNaming(refToName($ref), plugin.config.definitions), { meta: {
 				category: "type",
@@ -6270,7 +6538,7 @@ const exportType = ({ plugin, schema, state, type }) => {
 				tags: fromRef(state.tags),
 				tool: "typescript"
 			} });
-			const node$1 = $.type.alias(symbol$1).export().$if(createSchemaComment(schema), (t, v) => t.doc(v)).type($.type(symbol$1).idx($.type(symbol$1).typeofType().keyof()).typeofType());
+			const node$1 = $.type.alias(symbol$1).export().$if(plugin.config.comments && createSchemaComment(schema), (t, v) => t.doc(v)).type($.type(symbol$1).idx($.type(symbol$1).typeofType().keyof()).typeofType());
 			plugin.node(node$1);
 			return;
 		} else if (plugin.config.enums.mode === "typescript" || plugin.config.enums.mode === "typescript-const") {
@@ -6283,7 +6551,7 @@ const exportType = ({ plugin, schema, state, type }) => {
 					tags: fromRef(state.tags),
 					tool: "typescript"
 				} });
-				const enumNode = $.enum(symbol$1).export().$if(createSchemaComment(schema), (e, v) => e.doc(v)).const(plugin.config.enums.mode === "typescript-const").members(...enumObject.obj.map((item) => $.member(item.key).$if(createSchemaComment(item.schema), (m, v) => m.doc(v)).value($.fromValue(item.schema.const))));
+				const enumNode = $.enum(symbol$1).export().$if(plugin.config.comments && createSchemaComment(schema), (e, v) => e.doc(v)).const(plugin.config.enums.mode === "typescript-const").members(...enumObject.obj.map((item) => $.member(item.key).$if(plugin.config.comments && createSchemaComment(item.schema), (m, v) => m.doc(v)).value($.fromValue(item.schema.const))));
 				plugin.node(enumNode);
 				return;
 			}
@@ -6297,7 +6565,7 @@ const exportType = ({ plugin, schema, state, type }) => {
 		tags: fromRef(state.tags),
 		tool: "typescript"
 	} });
-	const node = $.type.alias(symbol).export().$if(createSchemaComment(schema), (t, v) => t.doc(v)).type(type);
+	const node = $.type.alias(symbol).export().$if(plugin.config.comments && createSchemaComment(schema), (t, v) => t.doc(v)).type(type);
 	plugin.node(node);
 };
 
@@ -6457,7 +6725,7 @@ const operationToDataType = ({ operation, plugin, state }) => {
 			tags: fromRef(state.tags),
 			tool: "typescript"
 		} });
-		const node$1 = $.type.alias(symbolWebhookPayload).export().$if(createSchemaComment(operation.body.schema), (t, v) => t.doc(v)).type(irSchemaToAst$5({
+		const node$1 = $.type.alias(symbolWebhookPayload).export().$if(plugin.config.comments && createSchemaComment(operation.body.schema), (t, v) => t.doc(v)).type(irSchemaToAst$5({
 			plugin,
 			schema: operation.body.schema,
 			state
@@ -6591,7 +6859,7 @@ const objectToAst$5 = ({ plugin, schema, state }) => {
 			}
 		});
 		const isRequired = required.includes(name);
-		shape.prop(name, (p) => p.$if(createSchemaComment(property), (p$1, v) => p$1.doc(v)).readonly(property.accessScope === "read").required(isRequired).type(propertyType));
+		shape.prop(name, (p) => p.$if(plugin.config.comments && createSchemaComment(property), (p$1, v) => p$1.doc(v)).readonly(property.accessScope === "read").required(isRequired).type(propertyType));
 		indexSchemas.push(property);
 		if (!isRequired) hasOptionalProperties = true;
 	}
@@ -6926,7 +7194,8 @@ const defaultConfig$11 = {
 	api: new Api$3(),
 	config: {
 		case: "PascalCase",
-		exportFromIndex: true,
+		comments: true,
+		includeInEntry: true,
 		topType: "unknown"
 	},
 	handler: handler$7,
@@ -7298,7 +7567,7 @@ const defaultConfig$10 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	dependencies: ["@hey-api/typescript", "@hey-api/sdk"],
 	handler: handler$6,
@@ -7752,7 +8021,7 @@ const defaultConfig$9 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	dependencies: ["@hey-api/sdk", "@hey-api/typescript"],
 	handler: handler$5,
@@ -7839,7 +8108,7 @@ const defaultConfig$8 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	dependencies: ["@hey-api/sdk", "@hey-api/typescript"],
 	handler: handler$5,
@@ -7955,7 +8224,7 @@ const defaultConfig$7 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	dependencies: ["@hey-api/sdk", "@hey-api/typescript"],
 	handler: handler$5,
@@ -8042,7 +8311,7 @@ const defaultConfig$6 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	dependencies: ["@hey-api/sdk", "@hey-api/typescript"],
 	handler: handler$5,
@@ -8129,7 +8398,7 @@ const defaultConfig$5 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	dependencies: ["@hey-api/sdk", "@hey-api/typescript"],
 	handler: handler$5,
@@ -8621,7 +8890,7 @@ const defaultConfig$4 = {
 	config: {
 		case: "PascalCase",
 		comments: true,
-		exportFromIndex: false,
+		includeInEntry: false,
 		metadata: false
 	},
 	handler: handler$4,
@@ -8884,7 +9153,7 @@ const handler$3 = ({ plugin }) => {
 //#endregion
 //#region src/plugins/fastify/config.ts
 const defaultConfig$3 = {
-	config: { exportFromIndex: false },
+	config: { includeInEntry: false },
 	dependencies: ["@hey-api/typescript"],
 	handler: handler$3,
 	name: "fastify"
@@ -8944,7 +9213,7 @@ const defaultConfig$2 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false
+		includeInEntry: false
 	},
 	dependencies: ["@hey-api/sdk", "@hey-api/typescript"],
 	handler: handler$2,
@@ -10364,7 +10633,7 @@ const defaultConfig$1 = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false,
+		includeInEntry: false,
 		metadata: false
 	},
 	handler: handler$1,
@@ -13150,7 +13419,7 @@ const defaultConfig = {
 	config: {
 		case: "camelCase",
 		comments: true,
-		exportFromIndex: false,
+		includeInEntry: false,
 		metadata: false
 	},
 	handler,
@@ -13560,4 +13829,4 @@ async function resolveJobs({ logger, userConfigs }) {
 
 //#endregion
 export { postProcessors as _, clientDefaultConfig as a, TypeScriptRenderer as c, reserved as d, keywords as f, getTypedConfig as g, getClientPlugin as h, generateClientBundle as i, TsDslContext as l, TsDsl as m, defaultPlugins as n, clientDefaultMeta as o, regexp as p, clientPluginHandler as r, $ as s, resolveJobs as t, ctx as u };
-//# sourceMappingURL=init-kvO44gnv.mjs.map
+//# sourceMappingURL=init-DlaW5Djq.mjs.map