@kubb/plugin-ts 5.0.5 → 5.0.6

package/dist/index.d.ts

@@ -298,7 +298,6 @@ type EnumOptions$1 = {
    * site (`'inlineLiteral'`).
    *
    * @default 'asConst'
-   * @note In Kubb v5, 'inlineLiteral' becomes the default.
    */
   type?: 'literal' | 'inlineLiteral';
   /**

package/dist/index.js

@@ -2,7 +2,7 @@ import { n as __name, t as __exportAll } from "./rolldown-runtime-CthDji9g.js";
 import { createRequire } from "node:module";
 import { parserTs } from "@kubb/parser-ts";
 import { File, jsxRenderer } from "kubb/jsx";
-import { Resolver, ast, createResolver, defineGenerator, definePlugin, isStringType, syncSchemaRef } from "kubb/kit";
+import { Resolver, assertPluginOption, ast, createResolver, defineGenerator, definePlugin, isStringType, syncSchemaRef } from "kubb/kit";
 import { Fragment, jsx, jsxs } from "kubb/jsx/jsx-runtime";
 //#region ../../internals/utils/src/casing.ts
 /**
@@ -1317,7 +1317,7 @@ function buildPropertyJSDocComments(schema, optional) {
 		!isArray && meta && "min" in meta && meta.min !== void 0 ? `@minLength ${meta.min}` : null,
 		!isArray && meta && "max" in meta && meta.max !== void 0 ? `@maxLength ${meta.max}` : null,
 		meta && "pattern" in meta && meta.pattern ? `@pattern ${meta.pattern}` : null,
-		meta && "default" in meta && meta.default !== void 0 ? `@default ${"primitive" in meta && meta.primitive === "string" && typeof meta.default === "string" ? stringify(meta.default) : meta.default}` : null,
+		meta && "default" in meta && meta.default !== void 0 ? `@default ${"primitive" in meta && meta.primitive === "string" && typeof meta.default === "string" ? stringify(meta.default) : formatExample(meta.default)}` : null,
 		...exampleValues.map((example) => `@example ${formatExample(example)}`)
 	].filter(Boolean);
 	const typeTag = comments.length && meta && "primitive" in meta && meta.primitive ? [`@type ${meta.primitive}`, optional ?? isSchemaOptional(schema) ? " | undefined" : null].filter(Boolean).join("") : null;
@@ -1875,6 +1875,53 @@ const resolverTs = createResolver({
 * cross-plugin dependency references.
 */
 const pluginTsName = "plugin-ts";
+const allowedEnumTypes = [
+	"asConst",
+	"enum",
+	"constEnum",
+	"literal",
+	"inlineLiteral"
+];
+const allowedSyntaxTypes = ["type", "interface"];
+const allowedArrayTypes = ["array", "generic"];
+const allowedOptionalTypes = [
+	"questionToken",
+	"undefined",
+	"questionTokenAndUndefined"
+];
+/**
+* Throws when an enum-like option holds a value outside its allowed set. Options left out are skipped.
+*/
+function assertEnumLikeOptions({ prefix, options }) {
+	const checks = [
+		{
+			option: "enum.type",
+			value: options.enum?.type,
+			allowed: allowedEnumTypes
+		},
+		{
+			option: "syntaxType",
+			value: options.syntaxType,
+			allowed: allowedSyntaxTypes
+		},
+		{
+			option: "arrayType",
+			value: options.arrayType,
+			allowed: allowedArrayTypes
+		},
+		{
+			option: "optionalType",
+			value: options.optionalType,
+			allowed: allowedOptionalTypes
+		}
+	];
+	for (const { option, value, allowed } of checks) if (value !== void 0) assertPluginOption({
+		plugin: pluginTsName,
+		option: `${prefix}${option}`,
+		value,
+		allowed
+	});
+}
 /**
 * Generates TypeScript `type` aliases and `interface` declarations from an
 * OpenAPI spec. The foundation that every other Kubb plugin builds on:
@@ -1915,6 +1962,19 @@ const pluginTs = definePlugin((options) => {
 		name: pluginTsName,
 		options,
 		hooks: { "kubb:plugin:setup"(ctx) {
+			assertEnumLikeOptions({
+				prefix: "",
+				options: {
+					enum: resolvedEnum,
+					syntaxType,
+					arrayType,
+					optionalType
+				}
+			});
+			for (const [index, entry] of override.entries()) assertEnumLikeOptions({
+				prefix: `override[${index}].options.`,
+				options: entry.options
+			});
 			ctx.setOptions({
 				output,
 				exclude,