@povio/openapi-codegen-cli 3.3.0 → 3.3.1

package/README.md

@@ -8,6 +8,8 @@
 
 Axios is required when using the Axios transport (the default) or the `/axios` entry point. Projects using the native transport can omit Axios: generate with `--restClient native` and import `NativeRestClient` from `@povio/openapi-codegen-cli/native`. The root exports remain available for compatibility and support tree-shaking in consumer bundles. For direct runtime imports without bundling, use `/native` and `/errors` to avoid loading the Axios client. The `/axios` entry point is also available for Axios-specific imports. CLI-only usage and the `/generator`, `/tiny`, `/vite`, and `/metro` entry points do not require Axios.
 
+ACL features require `@casl/ability@^7.1.1` and `@casl/react@^7.1.0`. When migrating to CASL 7, regenerate the client so `AppAbility` uses `Ability` instead of `PureAbility`, and update any handwritten CASL types. The runtime continues to use `createMongoAbility` for condition matching. CASL 7 treats empty conditions (`{}`) as matching everything. The `Can` helper keeps its `use` tuple and `(isAllowed, ability)` render callback.
+
 Use this tool to generate code (Zod schemas, TypeScript types, API definitions, and React queries) from an OpenAPI v3 specification. API definitions use a REST client wrapper with either Axios or the native transport. React queries are generated in alignment with our code standards, without the need for explicit types.
 
 The tool partially leverages code from [openapi-zod-client](https://github.com/astahmer/openapi-zod-client) repository.
@@ -36,6 +38,10 @@ export default {
 };
 ```
 
+## JSDoc generation
+
+JSDoc comments are omitted by default while schemas, inferred types, and runtime behavior are preserved. Set `generateJsDoc: true` in your generator configuration or pass `--generateJsDoc` to include comments. This applies to both TypeScript and native generation. Combine with `modelsOnly: true` if you only want model files.
+
 ## Lazy schemas
 
 With `tsNamespaces` enabled, every schema of a models namespace is built the moment the module is imported, even when the importer only needs one of them. Set `lazySchemas: true` (or pass `--lazySchemas`) to build each schema on first access instead:
@@ -125,6 +131,7 @@ bunx openapi-codegen generate --config my-config.ts
   --tsPath                            (Requires `--importPath` to be 'ts') Typescript import path (default: '@/data')
   --removeOperationPrefixEndingWith   Remove operation name prefixes that end with the specified string (default: 'Controller_')
   --compileSchemas                    Eagerly compile non-recursive Zod schemas (default: false)
+  --generateJsDoc                     Emit JSDoc comments (default: false; enable with --generateJsDoc)
   --lazySchemas                       Build namespace model schemas on first access instead of at import; requires `--tsNamespaces` (default: false)
   --extractEnums                      Extract enums into separate Zod schemas (default: true)
   --modelsInCommon                    Keep all schema declarations in defaultTag models and emit per-module proxy exports (default: false)

package/dist/acl.d.mts

@@ -1,11 +1,11 @@
 import { a as ErrorHandler } from "./error-handling-LPEPQV1V.mjs";
-import { PropsWithChildren } from "react";
-import { AbilityTuple, PureAbility, RawRuleOf, Subject } from "@casl/ability";
+import { PropsWithChildren, ReactNode } from "react";
+import { Ability, AbilityTuple, RawRuleOf, Subject } from "@casl/ability";
 import { PackRule } from "@casl/ability/extra";
-import { BoundCanProps } from "@casl/react";
+import { CanProps } from "@casl/react";
 //#region src/lib/acl/appAbility.types.d.ts
 type AppAbilities = AbilityTuple<string, Subject>;
-type AppAbility = PureAbility<AppAbilities>;
+type AppAbility = Ability<AppAbilities>;
 //#endregion
 //#region src/lib/acl/ability.context.d.ts
 declare namespace AbilityContext {
@@ -16,7 +16,7 @@ declare namespace AbilityContext {
     } | null;
   }
   export const Provider: ({ children }: PropsWithChildren<ProviderProps>) => import("react").JSX.Element;
-  export const useAbility: <TAppAbilities extends AppAbilities = AppAbilities>() => PureAbility<TAppAbilities>;
+  export const useAbility: <TAppAbilities extends AppAbilities = AppAbilities>() => Ability<TAppAbilities>;
   export {};
 }
 //#endregion
@@ -28,11 +28,11 @@ interface AclGuardProps<TAppAbilities extends AppAbilities = AppAbilities> {
 declare const createAclGuard: <TAppAbilities extends AppAbilities = AppAbilities>() => ({ canUse, redirectTo, children }: PropsWithChildren<AclGuardProps<TAppAbilities>>) => import("react").ReactNode;
 //#endregion
 //#region src/lib/acl/Can.d.ts
-type CanAbility = PureAbility<AbilityTuple<AppAbilities[0], AppAbilities[1]>>;
-type CanProps<TAppAbilities extends AppAbilities = AppAbilities> = {
+type CanProps$1<TAppAbilities extends AppAbilities = AppAbilities> = {
   use: TAppAbilities;
-} & Omit<BoundCanProps<CanAbility>, "do" | "I" | "on" | "a" | "an" | "this">;
-declare const Can: <TAppAbilities extends AppAbilities = AppAbilities>({ use, ...props }: CanProps<TAppAbilities>) => import("react").JSX.Element;
+  children: ReactNode | ((isAllowed: boolean, ability: AppAbility) => ReactNode);
+} & Omit<CanProps<AppAbility>, "do" | "I" | "on" | "a" | "an" | "this" | "children">;
+declare const Can: <TAppAbilities extends AppAbilities = AppAbilities>({ use, children, ...props }: CanProps$1<TAppAbilities>) => import("react").JSX.Element;
 //#endregion
 //#region src/lib/acl/useAclCheck.d.ts
 interface UseAclCheckProps {

package/dist/acl.mjs

@@ -5,7 +5,7 @@ import { createContext, useCallback, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 import { AbilityBuilder, createMongoAbility } from "@casl/ability";
 import { unpackRules } from "@casl/ability/extra";
-import { createContextualCan, useAbility } from "@casl/react";
+import { AbilityProvider, Can as Can$1, useAbility } from "@casl/react";
 //#region src/lib/acl/ability.context.tsx
 let AbilityContext;
 (function(_AbilityContext) {
@@ -27,11 +27,14 @@ let AbilityContext;
 		}, [user]);
 		return /* @__PURE__ */ jsx(Context.Provider, {
 			value: ability,
-			children
+			children: /* @__PURE__ */ jsx(AbilityProvider, {
+				value: ability,
+				children
+			})
 		});
 	};
 	_AbilityContext.useAbility = () => {
-		return useAbility(Context);
+		return useAbility();
 	};
 })(AbilityContext || (AbilityContext = {}));
 //#endregion
@@ -47,13 +50,13 @@ const createAclGuard = () => ({ canUse, redirectTo = "/", children }) => {
 };
 //#endregion
 //#region src/lib/acl/Can.tsx
-const ContextualCan = createContextualCan(AbilityContext.Consumer);
-const Can = ({ use, ...props }) => {
+const Can = ({ use, children, ...props }) => {
 	const [action, subject] = use;
-	return /* @__PURE__ */ jsx(ContextualCan, {
+	return /* @__PURE__ */ jsx(Can$1, {
 		...props,
 		do: action,
-		on: subject
+		on: subject,
+		children: typeof children === "function" ? ({ isAllowed, ability }) => props.passThrough || isAllowed ? children(isAllowed, ability) : null : children
 	});
 };
 //#endregion

package/dist/{config-FD2Y872S.d.mts → config-BYiBd1QI.d.mts}

@@ -1,4 +1,4 @@
-import { t as GenerateOptions } from "./options-rz2bcsaN.mjs";
+import { t as GenerateOptions } from "./options-DH-fAG0w.mjs";
 //#region src/generators/types/config.d.ts
 type OpenAPICodegenConfig = Partial<GenerateOptions>;
 //#endregion

package/dist/{generate.runner-CLK1FoLT.mjs → generate.runner-CxlaA4c5.mjs}

@@ -495,6 +495,7 @@ const DEFAULT_GENERATE_OPTIONS = {
 	standalone: false,
 	compileSchemas: false,
 	lazySchemas: false,
+	generateJsDoc: false,
 	schemaSuffix: SCHEMA_SUFFIX,
 	enumSuffix: ENUM_SUFFIX,
 	modelsInCommon: false,
@@ -1578,7 +1579,7 @@ async function runGenerate({ fileConfig, params, formatGeneratedFile, profiler =
 			const nativeFiles = generateFilesFromNativeOpenAPI(nativeInput.source, nativeInput.yaml, config);
 			if (nativeFiles) return nativeFiles;
 		}
-		const { generateCodeFromOpenAPIDoc } = await import("./generateCodeFromOpenAPIDoc-CDyGSv2w.mjs").then((n) => n.n);
+		const { generateCodeFromOpenAPIDoc } = await import("./generateCodeFromOpenAPIDoc-CmN4bFjv.mjs").then((n) => n.n);
 		return generateCodeFromOpenAPIDoc(openApiDoc, config, profiler, {
 			source: nativeInput.source,
 			yaml: nativeInput.yaml

package/dist/{generate.utils-BSDYGp-0.cjs → generate.utils-SfgYwPe7.cjs}

@@ -105,6 +105,7 @@ const DEFAULT_GENERATE_OPTIONS = {
 	standalone: false,
 	compileSchemas: false,
 	lazySchemas: false,
+	generateJsDoc: false,
 	schemaSuffix: SCHEMA_SUFFIX,
 	enumSuffix: ENUM_SUFFIX,
 	modelsInCommon: false,

package/dist/{generateCodeFromOpenAPIDoc-CDyGSv2w.mjs → generateCodeFromOpenAPIDoc-CmN4bFjv.mjs}

@@ -1,5 +1,5 @@
-import { r as getZodSchemaRefs, t as getDataFromOpenAPIDoc } from "./getDataFromOpenAPIDoc-DYiCTWno.mjs";
-import { $ as getImportedAbilityFunctionName, A as getEndpointsImports, An as NATIVE_RESPONSE_TYPE, At as APP_REST_CLIENT_NAME, B as getPrefetchInfiniteQueryName, Bt as NATIVE_PACKAGE_IMPORT_PATH, C as getAppRestClientImportPath, Cn as ZOD_IMPORT, D as getTagFileName, Dn as AXIOS_REQUEST_CONFIG_TYPE, Dt as isEnumZodSchema, E as getQueryTypesImportPath, En as AXIOS_REQUEST_CONFIG_NAME, F as mergeImports, Ft as QUERY_MODULE_ENUM, G as getAbilityConditionType, H as getQueryName, Ht as getNamespaceName, I as getImportedInfiniteQueryName, In as shouldInlineEndpointsForTag, It as QUERY_OPTIONS_TYPES, J as getAbilityFunctionName, K as getAbilityConditionsTypes, L as getImportedQueryName, Ln as camelToSpaceSeparated, Lt as ZOD_EXTENDED, M as getInfiniteQueriesImports, Mt as DOMAIN_ERRORS_FILE, N as getModelsImports, Nn as getEndpointTag, Nt as MUTATION_EFFECTS, O as getTagImportPath, Ot as isNamedZodSchema, P as getQueriesImports, Pt as QUERY_MODULES_FILE, Q as getAppAbilitiesType, R as getInfiniteQueryName, Rn as capitalize, Rt as AXIOS_PACKAGE_IMPORT_PATH, T as getQueryModulesImportPath, Tn as AXIOS_IMPORT, U as getQueryOptionsName, V as getPrefetchQueryName, Vn as kebabToCamel, Vt as REST_PACKAGE_IMPORT_PATH, W as getAbilityAction, Wn as Profiler, X as getAbilitySubjectTypes, Y as getAbilitySubject, Z as getAclData, Zt as isParamMediaTypeAllowed, _ as hasEndpointConfig, _t as isReadAllEndpoint, an as wrapWithQuotesIfNeeded, at as getZodSchemaInferedTypeName, b as requiresBody, bt as invalidVariableNameCharactersToCamel, c as getDestructuredVariables, cn as isReferenceObject, ct as getSchemaDescriptions, d as isQuery, dt as DEFAULT_GENERATE_OPTIONS, et as hasAbilityConditions, f as getEndpointBody, fn as ANY_SCHEMA, ft as getPathSegments, g as getImportedEndpointName, gt as isPathSegmentParam, h as getEndpointPath, ht as isDeleteEndpoint, i as shouldUseNativeCodegen, it as getZodSchemaDescription, j as getImportPath, jn as getRequestConfigTypeName, jt as BUILDERS_UTILS, k as getAclImports, kn as JSON_APPLICATION_FORMAT, kt as APP_REST_CLIENT_FILE, l as isInfiniteQuery, ln as isSchemaObject, m as getEndpointName, mt as isCreateEndpoint, nt as getImportedZodSchemaInferedTypeName, o as getOutputFileName, ot as getZodSchemaPropertyDescriptions, p as getEndpointConfig, pt as isBulkDeleteEndpoint, q as getAbilityDescription, r as compileNativeData, rt as getImportedZodSchemaName, st as getZodSchemaType, tt as renderAclCheckCall, u as isMutation, ut as getUniqueArray, v as mapEndpointParamsToFunctionParams, vt as isReadEndpoint, w as getFileNameWithExtension, wn as AXIOS_DEFAULT_IMPORT_NAME, y as renderMediaUploadMutationBody, yt as isUpdateEndpoint, z as getInfiniteQueryOptionsName, zt as CONFIG_PACKAGE_IMPORT_PATH } from "./generate.runner-CLK1FoLT.mjs";
+import { r as getZodSchemaRefs, t as getDataFromOpenAPIDoc } from "./getDataFromOpenAPIDoc-DzeHecv2.mjs";
+import { $ as getImportedAbilityFunctionName, A as getEndpointsImports, An as NATIVE_RESPONSE_TYPE, At as APP_REST_CLIENT_NAME, B as getPrefetchInfiniteQueryName, Bt as NATIVE_PACKAGE_IMPORT_PATH, C as getAppRestClientImportPath, Cn as ZOD_IMPORT, D as getTagFileName, Dn as AXIOS_REQUEST_CONFIG_TYPE, Dt as isEnumZodSchema, E as getQueryTypesImportPath, En as AXIOS_REQUEST_CONFIG_NAME, F as mergeImports, Ft as QUERY_MODULE_ENUM, G as getAbilityConditionType, H as getQueryName, Ht as getNamespaceName, I as getImportedInfiniteQueryName, In as shouldInlineEndpointsForTag, It as QUERY_OPTIONS_TYPES, J as getAbilityFunctionName, K as getAbilityConditionsTypes, L as getImportedQueryName, Ln as camelToSpaceSeparated, Lt as ZOD_EXTENDED, M as getInfiniteQueriesImports, Mt as DOMAIN_ERRORS_FILE, N as getModelsImports, Nn as getEndpointTag, Nt as MUTATION_EFFECTS, O as getTagImportPath, Ot as isNamedZodSchema, P as getQueriesImports, Pt as QUERY_MODULES_FILE, Q as getAppAbilitiesType, R as getInfiniteQueryName, Rn as capitalize, Rt as AXIOS_PACKAGE_IMPORT_PATH, T as getQueryModulesImportPath, Tn as AXIOS_IMPORT, U as getQueryOptionsName, V as getPrefetchQueryName, Vn as kebabToCamel, Vt as REST_PACKAGE_IMPORT_PATH, W as getAbilityAction, Wn as Profiler, X as getAbilitySubjectTypes, Y as getAbilitySubject, Z as getAclData, Zt as isParamMediaTypeAllowed, _ as hasEndpointConfig, _t as isReadAllEndpoint, an as wrapWithQuotesIfNeeded, at as getZodSchemaInferedTypeName, b as requiresBody, bt as invalidVariableNameCharactersToCamel, c as getDestructuredVariables, cn as isReferenceObject, ct as getSchemaDescriptions, d as isQuery, dt as DEFAULT_GENERATE_OPTIONS, et as hasAbilityConditions, f as getEndpointBody, fn as ANY_SCHEMA, ft as getPathSegments, g as getImportedEndpointName, gt as isPathSegmentParam, h as getEndpointPath, ht as isDeleteEndpoint, i as shouldUseNativeCodegen, it as getZodSchemaDescription, j as getImportPath, jn as getRequestConfigTypeName, jt as BUILDERS_UTILS, k as getAclImports, kn as JSON_APPLICATION_FORMAT, kt as APP_REST_CLIENT_FILE, l as isInfiniteQuery, ln as isSchemaObject, m as getEndpointName, mt as isCreateEndpoint, nt as getImportedZodSchemaInferedTypeName, o as getOutputFileName, ot as getZodSchemaPropertyDescriptions, p as getEndpointConfig, pt as isBulkDeleteEndpoint, q as getAbilityDescription, r as compileNativeData, rt as getImportedZodSchemaName, st as getZodSchemaType, tt as renderAclCheckCall, u as isMutation, ut as getUniqueArray, v as mapEndpointParamsToFunctionParams, vt as isReadEndpoint, w as getFileNameWithExtension, wn as AXIOS_DEFAULT_IMPORT_NAME, y as renderMediaUploadMutationBody, yt as isUpdateEndpoint, z as getInfiniteQueryOptionsName, zt as CONFIG_PACKAGE_IMPORT_PATH } from "./generate.runner-CxlaA4c5.mjs";
 import "node:module";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
@@ -22,7 +22,7 @@ const ACL_APP_ABILITIES = "AppAbilities";
 const ACL_CHECK_HOOK = "useAclCheck";
 const CASL_ABILITY_BINDING = {
 	abilityTuple: "AbilityTuple",
-	pureAbility: "PureAbility",
+	ability: "Ability",
 	forcedSubject: "ForcedSubject",
 	subjectType: "Subject",
 	subject: "subject"
@@ -30,7 +30,7 @@ const CASL_ABILITY_BINDING = {
 const CASL_ABILITY_IMPORT = {
 	bindings: [
 		CASL_ABILITY_BINDING.abilityTuple,
-		CASL_ABILITY_BINDING.pureAbility,
+		CASL_ABILITY_BINDING.ability,
 		CASL_ABILITY_BINDING.forcedSubject,
 		CASL_ABILITY_BINDING.subjectType,
 		CASL_ABILITY_BINDING.subject
@@ -89,7 +89,7 @@ function generateAppAcl({ resolver, data }) {
 	const caslAbilityTupleImport = {
 		bindings: [],
 		typeBindings: [
-			CASL_ABILITY_BINDING.pureAbility,
+			CASL_ABILITY_BINDING.ability,
 			CASL_ABILITY_BINDING.abilityTuple,
 			...!appAbilitiesType ? [CASL_ABILITY_BINDING.subjectType] : [],
 			...hasAdditionalAbilityImports ? [CASL_ABILITY_BINDING.forcedSubject] : []
@@ -106,7 +106,7 @@ function generateAppAcl({ resolver, data }) {
 		for (const [action, subjects] of Object.entries(appAbilitiesType)) lines.push(`| ${CASL_ABILITY_BINDING.abilityTuple}<"${action}", ${subjects.join(" | ")}>`);
 	} else lines.push(`export type ${ACL_APP_ABILITIES} = ${CASL_ABILITY_BINDING.abilityTuple}<string, ${CASL_ABILITY_BINDING.subjectType}>;`);
 	lines.push("");
-	lines.push(`export type AppAbility = PureAbility<${ACL_APP_ABILITIES}>;`);
+	lines.push(`export type AppAbility = ${CASL_ABILITY_BINDING.ability}<${ACL_APP_ABILITIES}>;`);
 	return lines.join("\n");
 }
 function renderImport$4(importData) {
@@ -154,12 +154,14 @@ function renderAbilityFunction({ resolver, endpoint }) {
 	const hasConditions = hasAbilityConditions(endpoint);
 	const lines = [];
 	const abilityQuery = endpoint.method === "get" ? endpoint.mediaDownload ? `\`${getQueryName(endpoint)}\` query or \`${getQueryName(endpoint, true)}\` mutation` : `\`${getQueryName(endpoint)}\` query` : `\`${getQueryName(endpoint)}\` mutation`;
-	lines.push("/**");
-	lines.push(` * Use for ${abilityQuery} ability. ${hasConditions ? "For global ability, omit the object parameter." : ""}${getAbilityDescription(endpoint) ? "" : ""}`);
-	if (getAbilityDescription(endpoint)) lines.push(` * @description ${getAbilityDescription(endpoint)}`);
-	if (hasConditions) for (const propertyType of abilityConditionsTypes) lines.push(` * @param { ${renderConditionType(resolver, endpoint, propertyType)} } object.${propertyType.name} ${propertyType.name} from ${propertyType.info}`);
-	lines.push(` * @returns { AbilityTuple } An ability tuple indicating the user's ability to use ${abilityQuery}`);
-	lines.push(" */");
+	if (resolver.options.generateJsDoc === true) {
+		lines.push("/**");
+		lines.push(` * Use for ${abilityQuery} ability. ${hasConditions ? "For global ability, omit the object parameter." : ""}${getAbilityDescription(endpoint) ? "" : ""}`);
+		if (getAbilityDescription(endpoint)) lines.push(` * @description ${getAbilityDescription(endpoint)}`);
+		if (hasConditions) for (const propertyType of abilityConditionsTypes) lines.push(` * @param { ${renderConditionType(resolver, endpoint, propertyType)} } object.${propertyType.name} ${propertyType.name} from ${propertyType.info}`);
+		lines.push(` * @returns { AbilityTuple } An ability tuple indicating the user's ability to use ${abilityQuery}`);
+		lines.push(" */");
+	}
 	lines.push(`export const ${getAbilityFunctionName(endpoint)} = (`);
 	if (hasConditions) lines.push(`  object?: { ${abilityConditionsTypes.map((propertyType) => `${propertyType.name}${propertyType.required ? "" : "?"}: ${renderConditionType(resolver, endpoint, propertyType)}, `).join("")} } `);
 	lines.push(") => [");
@@ -925,7 +927,7 @@ function generateModels({ resolver, data, tag }) {
 		options: resolver.options
 	})} {`);
 	for (const [name, zodSchema] of Object.entries(zodSchemasData)) {
-		lines.push(renderModelJsDocs({
+		if (resolver.options.generateJsDoc === true) lines.push(renderModelJsDocs({
 			name,
 			zodSchema,
 			tag,
@@ -958,7 +960,7 @@ function renderLazyModels({ resolver, tag, zodSchemasData, lines }) {
 		const typeAnnotation = zodSchema.isCircular ? `: () => z.ZodObject<z.ZodRawShape> & z.ZodType<${namespace}.${inferredTypeName}>` : "";
 		const schemaCode = resolver.options.compileSchemas && !zodSchema.isCircular ? `z.compile(${zodSchema.code})` : zodSchema.code;
 		lines.push(`const ${name}${typeAnnotation} = once(() => ${callLazySchemaReferences(schemaCode, schemaNames)});`);
-		members.push(...indent(renderModelJsDocs({
+		if (resolver.options.generateJsDoc === true) members.push(...indent(renderModelJsDocs({
 			name,
 			zodSchema,
 			tag,
@@ -1108,6 +1110,7 @@ function renderImport$1(importData) {
 	return `import${importData.typeOnly ? " type" : ""} ${names} from "${importData.from}";`;
 }
 function renderModelJsDocs({ name, zodSchema, tag, resolver }) {
+	if (resolver.options.generateJsDoc !== true) return "";
 	const lines = [
 		`/** `,
 		` * ${name} `,
@@ -1451,6 +1454,7 @@ function addAsteriskAfterNewLine(str) {
 	return str.replace(/\n/g, "\n *");
 }
 function renderQueryJsDocs({ resolver, endpoint, mode, tag }) {
+	if (resolver.options.generateJsDoc !== true) return "";
 	const lines = ["/** "];
 	if (mode === "infiniteQuery") lines.push(` * Infinite query \`${getInfiniteQueryName(endpoint)}${endpoint.summary ? "" : ""}`);
 	else if (mode === "query") lines.push(` * Query \`${getQueryName(endpoint)}\`${endpoint.summary && endpoint.mediaDownload ? " - recommended when file should be cached" : ""}`);
@@ -1642,7 +1646,7 @@ function renderQuery({ resolver, endpoint, inlineEndpoints }) {
 	const requestConfig = `{ ${hasAxiosRequestConfig ? `...${AXIOS_REQUEST_CONFIG_NAME}, ` : ""}allowInvalidResponseData: queryConfig.allowInvalidResponseData }`;
 	const queryOptionsArgs = `${resolvedEndpointArgs ? `{ ${resolvedEndpointArgs} }, ` : ""}${requestConfig}`;
 	const lines = [];
-	lines.push(renderQueryJsDocs({
+	if (resolver.options.generateJsDoc === true) lines.push(renderQueryJsDocs({
 		resolver,
 		endpoint,
 		mode: "query",
@@ -1712,7 +1716,7 @@ function renderMutation({ resolver, endpoint, inlineEndpoints, precomputed }) {
 	const pathParamFirstArg = isScoped ? `{ ${scopePathParams.map((p) => p.name).join(", ")} }: { ${scopePathParams.map((p) => `${p.name}: ${p.type}`).join("; ")} }, ` : "";
 	const mutationOptionsTypeArg = isScoped ? nonPathMutationVariablesType ? `, { ${nonPathMutationVariablesType} }` : "" : `, { ${mutationVariablesType} }`;
 	const lines = [];
-	lines.push(renderQueryJsDocs({
+	if (resolver.options.generateJsDoc === true) lines.push(renderQueryJsDocs({
 		resolver,
 		endpoint,
 		mode: "mutation",
@@ -1831,7 +1835,7 @@ function renderInfiniteQuery({ resolver, endpoint, inlineEndpoints }) {
 	const queryOptionsArgs = `${resolvedEndpointArgsWithoutPage ? `{ ${resolvedEndpointArgsWithoutPage} }, ` : ""}${requestConfig}`;
 	const hasQueryFnOverride = hasAclCheck;
 	const lines = [];
-	lines.push(renderQueryJsDocs({
+	if (resolver.options.generateJsDoc === true) lines.push(renderQueryJsDocs({
 		resolver,
 		endpoint,
 		mode: "infiniteQuery",
@@ -1903,7 +1907,7 @@ function generateDomainErrors({ resolver, data }) {
 			const sb = String(b.code);
 			return sa < sb ? -1 : sa > sb ? 1 : 0;
 		}).map(({ code, name, description }) => {
-			const comment = description ? `  /** ${description} */\n  ` : "  ";
+			const comment = resolver.options.generateJsDoc === true && description ? `  /** ${description} */\n  ` : "  ";
 			const key = name ?? (typeof code === "string" ? code : `ERROR_${code}`);
 			if (!VALID_IDENTIFIER.test(key)) throw new Error(`Domain error code "${code}" produces an invalid identifier "${key}". Use the 'name' field on @ApiDomainErrorResponse to provide a valid identifier.`);
 			return `${comment}${key}: ${typeof code === "string" ? `"${code}"` : String(code)}`;

package/dist/{generateCodeFromOpenAPIDoc-BypeVKIE.cjs → generateCodeFromOpenAPIDoc-Dv-hqKhh.cjs}

@@ -1,4 +1,4 @@
-const require_generate_utils = require("./generate.utils-BSDYGp-0.cjs");
+const require_generate_utils = require("./generate.utils-SfgYwPe7.cjs");
 //#region src/generators/const/acl.const.ts
 const ACL_APP_ABILITY_FILE = {
 	fileName: "acl/app.ability",
@@ -8,7 +8,7 @@ const ACL_APP_ABILITIES = "AppAbilities";
 const ACL_CHECK_HOOK = "useAclCheck";
 const CASL_ABILITY_BINDING = {
 	abilityTuple: "AbilityTuple",
-	pureAbility: "PureAbility",
+	ability: "Ability",
 	forcedSubject: "ForcedSubject",
 	subjectType: "Subject",
 	subject: "subject"
@@ -16,7 +16,7 @@ const CASL_ABILITY_BINDING = {
 const CASL_ABILITY_IMPORT = {
 	bindings: [
 		CASL_ABILITY_BINDING.abilityTuple,
-		CASL_ABILITY_BINDING.pureAbility,
+		CASL_ABILITY_BINDING.ability,
 		CASL_ABILITY_BINDING.forcedSubject,
 		CASL_ABILITY_BINDING.subjectType,
 		CASL_ABILITY_BINDING.subject
@@ -2072,7 +2072,7 @@ function generateAppAcl({ resolver, data }) {
 	const caslAbilityTupleImport = {
 		bindings: [],
 		typeBindings: [
-			CASL_ABILITY_BINDING.pureAbility,
+			CASL_ABILITY_BINDING.ability,
 			CASL_ABILITY_BINDING.abilityTuple,
 			...!appAbilitiesType ? [CASL_ABILITY_BINDING.subjectType] : [],
 			...hasAdditionalAbilityImports ? [CASL_ABILITY_BINDING.forcedSubject] : []
@@ -2089,7 +2089,7 @@ function generateAppAcl({ resolver, data }) {
 		for (const [action, subjects] of Object.entries(appAbilitiesType)) lines.push(`| ${CASL_ABILITY_BINDING.abilityTuple}<"${action}", ${subjects.join(" | ")}>`);
 	} else lines.push(`export type ${ACL_APP_ABILITIES} = ${CASL_ABILITY_BINDING.abilityTuple}<string, ${CASL_ABILITY_BINDING.subjectType}>;`);
 	lines.push("");
-	lines.push(`export type AppAbility = PureAbility<${ACL_APP_ABILITIES}>;`);
+	lines.push(`export type AppAbility = ${CASL_ABILITY_BINDING.ability}<${ACL_APP_ABILITIES}>;`);
 	return lines.join("\n");
 }
 function renderImport$4(importData) {
@@ -2137,12 +2137,14 @@ function renderAbilityFunction({ resolver, endpoint }) {
 	const hasConditions = require_generate_utils.hasAbilityConditions(endpoint);
 	const lines = [];
 	const abilityQuery = endpoint.method === "get" ? endpoint.mediaDownload ? `\`${require_generate_utils.getQueryName(endpoint)}\` query or \`${require_generate_utils.getQueryName(endpoint, true)}\` mutation` : `\`${require_generate_utils.getQueryName(endpoint)}\` query` : `\`${require_generate_utils.getQueryName(endpoint)}\` mutation`;
-	lines.push("/**");
-	lines.push(` * Use for ${abilityQuery} ability. ${hasConditions ? "For global ability, omit the object parameter." : ""}${require_generate_utils.getAbilityDescription(endpoint) ? "" : ""}`);
-	if (require_generate_utils.getAbilityDescription(endpoint)) lines.push(` * @description ${require_generate_utils.getAbilityDescription(endpoint)}`);
-	if (hasConditions) for (const propertyType of abilityConditionsTypes) lines.push(` * @param { ${renderConditionType(resolver, endpoint, propertyType)} } object.${propertyType.name} ${propertyType.name} from ${propertyType.info}`);
-	lines.push(` * @returns { AbilityTuple } An ability tuple indicating the user's ability to use ${abilityQuery}`);
-	lines.push(" */");
+	if (resolver.options.generateJsDoc === true) {
+		lines.push("/**");
+		lines.push(` * Use for ${abilityQuery} ability. ${hasConditions ? "For global ability, omit the object parameter." : ""}${require_generate_utils.getAbilityDescription(endpoint) ? "" : ""}`);
+		if (require_generate_utils.getAbilityDescription(endpoint)) lines.push(` * @description ${require_generate_utils.getAbilityDescription(endpoint)}`);
+		if (hasConditions) for (const propertyType of abilityConditionsTypes) lines.push(` * @param { ${renderConditionType(resolver, endpoint, propertyType)} } object.${propertyType.name} ${propertyType.name} from ${propertyType.info}`);
+		lines.push(` * @returns { AbilityTuple } An ability tuple indicating the user's ability to use ${abilityQuery}`);
+		lines.push(" */");
+	}
 	lines.push(`export const ${require_generate_utils.getAbilityFunctionName(endpoint)} = (`);
 	if (hasConditions) lines.push(`  object?: { ${abilityConditionsTypes.map((propertyType) => `${propertyType.name}${propertyType.required ? "" : "?"}: ${renderConditionType(resolver, endpoint, propertyType)}, `).join("")} } `);
 	lines.push(") => [");
@@ -2908,7 +2910,7 @@ function generateModels({ resolver, data, tag }) {
 		options: resolver.options
 	})} {`);
 	for (const [name, zodSchema] of Object.entries(zodSchemasData)) {
-		lines.push(renderModelJsDocs({
+		if (resolver.options.generateJsDoc === true) lines.push(renderModelJsDocs({
 			name,
 			zodSchema,
 			tag,
@@ -2941,7 +2943,7 @@ function renderLazyModels({ resolver, tag, zodSchemasData, lines }) {
 		const typeAnnotation = zodSchema.isCircular ? `: () => z.ZodObject<z.ZodRawShape> & z.ZodType<${namespace}.${inferredTypeName}>` : "";
 		const schemaCode = resolver.options.compileSchemas && !zodSchema.isCircular ? `z.compile(${zodSchema.code})` : zodSchema.code;
 		lines.push(`const ${name}${typeAnnotation} = once(() => ${callLazySchemaReferences(schemaCode, schemaNames)});`);
-		members.push(...indent(renderModelJsDocs({
+		if (resolver.options.generateJsDoc === true) members.push(...indent(renderModelJsDocs({
 			name,
 			zodSchema,
 			tag,
@@ -3091,6 +3093,7 @@ function renderImport$1(importData) {
 	return `import${importData.typeOnly ? " type" : ""} ${names} from "${importData.from}";`;
 }
 function renderModelJsDocs({ name, zodSchema, tag, resolver }) {
+	if (resolver.options.generateJsDoc !== true) return "";
 	const lines = [
 		`/** `,
 		` * ${name} `,
@@ -3434,6 +3437,7 @@ function addAsteriskAfterNewLine(str) {
 	return str.replace(/\n/g, "\n *");
 }
 function renderQueryJsDocs({ resolver, endpoint, mode, tag }) {
+	if (resolver.options.generateJsDoc !== true) return "";
 	const lines = ["/** "];
 	if (mode === "infiniteQuery") lines.push(` * Infinite query \`${require_generate_utils.getInfiniteQueryName(endpoint)}${endpoint.summary ? "" : ""}`);
 	else if (mode === "query") lines.push(` * Query \`${require_generate_utils.getQueryName(endpoint)}\`${endpoint.summary && endpoint.mediaDownload ? " - recommended when file should be cached" : ""}`);
@@ -3625,7 +3629,7 @@ function renderQuery({ resolver, endpoint, inlineEndpoints }) {
 	const requestConfig = `{ ${hasAxiosRequestConfig ? `...${require_generate_utils.AXIOS_REQUEST_CONFIG_NAME}, ` : ""}allowInvalidResponseData: queryConfig.allowInvalidResponseData }`;
 	const queryOptionsArgs = `${resolvedEndpointArgs ? `{ ${resolvedEndpointArgs} }, ` : ""}${requestConfig}`;
 	const lines = [];
-	lines.push(renderQueryJsDocs({
+	if (resolver.options.generateJsDoc === true) lines.push(renderQueryJsDocs({
 		resolver,
 		endpoint,
 		mode: "query",
@@ -3695,7 +3699,7 @@ function renderMutation({ resolver, endpoint, inlineEndpoints, precomputed }) {
 	const pathParamFirstArg = isScoped ? `{ ${scopePathParams.map((p) => p.name).join(", ")} }: { ${scopePathParams.map((p) => `${p.name}: ${p.type}`).join("; ")} }, ` : "";
 	const mutationOptionsTypeArg = isScoped ? nonPathMutationVariablesType ? `, { ${nonPathMutationVariablesType} }` : "" : `, { ${mutationVariablesType} }`;
 	const lines = [];
-	lines.push(renderQueryJsDocs({
+	if (resolver.options.generateJsDoc === true) lines.push(renderQueryJsDocs({
 		resolver,
 		endpoint,
 		mode: "mutation",
@@ -3814,7 +3818,7 @@ function renderInfiniteQuery({ resolver, endpoint, inlineEndpoints }) {
 	const queryOptionsArgs = `${resolvedEndpointArgsWithoutPage ? `{ ${resolvedEndpointArgsWithoutPage} }, ` : ""}${requestConfig}`;
 	const hasQueryFnOverride = hasAclCheck;
 	const lines = [];
-	lines.push(renderQueryJsDocs({
+	if (resolver.options.generateJsDoc === true) lines.push(renderQueryJsDocs({
 		resolver,
 		endpoint,
 		mode: "infiniteQuery",
@@ -3886,7 +3890,7 @@ function generateDomainErrors({ resolver, data }) {
 			const sb = String(b.code);
 			return sa < sb ? -1 : sa > sb ? 1 : 0;
 		}).map(({ code, name, description }) => {
-			const comment = description ? `  /** ${description} */\n  ` : "  ";
+			const comment = resolver.options.generateJsDoc === true && description ? `  /** ${description} */\n  ` : "  ";
 			const key = name ?? (typeof code === "string" ? code : `ERROR_${code}`);
 			if (!VALID_IDENTIFIER.test(key)) throw new Error(`Domain error code "${code}" produces an invalid identifier "${key}". Use the 'name' field on @ApiDomainErrorResponse to provide a valid identifier.`);
 			return `${comment}${key}: ${typeof code === "string" ? `"${code}"` : String(code)}`;

package/dist/generator.d.mts

@@ -1,4 +1,4 @@
-import { n as GenerateFileData, t as GenerateOptions } from "./options-rz2bcsaN.mjs";
+import { n as GenerateFileData, t as GenerateOptions } from "./options-DH-fAG0w.mjs";
 import { OpenAPIV3 } from "openapi-types";
 //#region src/generators/types/metadata.d.ts
 interface GenerateParams {

package/dist/generator.mjs

@@ -1,6 +1,6 @@
-import { t as generateCodeFromOpenAPIDoc } from "./generateCodeFromOpenAPIDoc-CDyGSv2w.mjs";
-import { t as getDataFromOpenAPIDoc } from "./getDataFromOpenAPIDoc-DYiCTWno.mjs";
-import { H as getQueryName, Ht as getNamespaceName, Mn as formatTag, O as getTagImportPath, S as getTsTypeBase, Xt as isMediaTypeAllowed, Zt as isParamMediaTypeAllowed, bt as invalidVariableNameCharactersToCamel, d as isQuery, dt as DEFAULT_GENERATE_OPTIONS, t as getOpenApiDoc, u as isMutation, x as getSchemaTsMetaType } from "./generate.runner-CLK1FoLT.mjs";
+import { t as generateCodeFromOpenAPIDoc } from "./generateCodeFromOpenAPIDoc-CmN4bFjv.mjs";
+import { t as getDataFromOpenAPIDoc } from "./getDataFromOpenAPIDoc-DzeHecv2.mjs";
+import { H as getQueryName, Ht as getNamespaceName, Mn as formatTag, O as getTagImportPath, S as getTsTypeBase, Xt as isMediaTypeAllowed, Zt as isParamMediaTypeAllowed, bt as invalidVariableNameCharactersToCamel, d as isQuery, dt as DEFAULT_GENERATE_OPTIONS, t as getOpenApiDoc, u as isMutation, x as getSchemaTsMetaType } from "./generate.runner-CxlaA4c5.mjs";
 //#region src/generators/core/getMetadataFromOpenAPIDoc.ts
 async function getMetadataFromOpenAPIDoc(openApiDoc, options) {
 	const { resolver, data } = await getDataFromOpenAPIDoc(openApiDoc, options);

package/dist/{getDataFromOpenAPIDoc-DYiCTWno.mjs → getDataFromOpenAPIDoc-DzeHecv2.mjs}

@@ -1,4 +1,4 @@
-import { $t as isPrimitiveType, Bn as getMostCommonAdjacentCombinationSplit, Ct as getParamZodSchemaName, Et as getZodSchemaOperationName, Fn as isTagIncluded, Gt as getParameterEnumNames, Hn as removeWord, Ht as getNamespaceName, Jt as isErrorStatus, Kt as getSchemaNameByRef, Mn as formatTag, Nn as getEndpointTag, On as BODY_PARAMETER_NAME, Ot as isNamedZodSchema, Pn as getOperationTag, Qt as isPathExcluded, Rn as capitalize, Sn as VOID_SCHEMA, St as getEnumZodSchemaName, Tt as getZodSchemaName, Un as snakeToCamel, Ut as autocorrectRef, Wn as Profiler, Wt as escapeControlCharacters, Xt as isMediaTypeAllowed, Yt as isMainResponseStatus, Zt as isParamMediaTypeAllowed, _n as INT_SCHEMA, an as wrapWithQuotesIfNeeded, bn as URL_SCHEMA, bt as invalidVariableNameCharactersToCamel, cn as isReferenceObject, d as isQuery, dn as ALLOWED_PATH_IN, en as isSortingParameterObject, fn as ANY_SCHEMA, gn as ENUM_SCHEMA, hn as EMAIL_SCHEMA, in as unwrapQuotesIfNeeded, kn as JSON_APPLICATION_FORMAT, ln as isSchemaObject, lt as iterateSchema, mn as DATETIME_SCHEMA, nn as pathToVariableName, on as inferRequiredSchema, pn as BLOB_SCHEMA, qt as getSchemaRef, rn as replaceHyphenatedPath, s as pick, sn as isArraySchemaObject, tn as pathParamToVariableName, un as ALLOWED_METHODS, ut as getUniqueArray, vn as NUMBER_SCHEMA, wt as getResponseZodSchemaName, xn as UUID_SCHEMA, xt as getBodyZodSchemaName, yn as STRING_SCHEMA, zn as decapitalize } from "./generate.runner-CLK1FoLT.mjs";
+import { $t as isPrimitiveType, Bn as getMostCommonAdjacentCombinationSplit, Ct as getParamZodSchemaName, Et as getZodSchemaOperationName, Fn as isTagIncluded, Gt as getParameterEnumNames, Hn as removeWord, Ht as getNamespaceName, Jt as isErrorStatus, Kt as getSchemaNameByRef, Mn as formatTag, Nn as getEndpointTag, On as BODY_PARAMETER_NAME, Ot as isNamedZodSchema, Pn as getOperationTag, Qt as isPathExcluded, Rn as capitalize, Sn as VOID_SCHEMA, St as getEnumZodSchemaName, Tt as getZodSchemaName, Un as snakeToCamel, Ut as autocorrectRef, Wn as Profiler, Wt as escapeControlCharacters, Xt as isMediaTypeAllowed, Yt as isMainResponseStatus, Zt as isParamMediaTypeAllowed, _n as INT_SCHEMA, an as wrapWithQuotesIfNeeded, bn as URL_SCHEMA, bt as invalidVariableNameCharactersToCamel, cn as isReferenceObject, d as isQuery, dn as ALLOWED_PATH_IN, en as isSortingParameterObject, fn as ANY_SCHEMA, gn as ENUM_SCHEMA, hn as EMAIL_SCHEMA, in as unwrapQuotesIfNeeded, kn as JSON_APPLICATION_FORMAT, ln as isSchemaObject, lt as iterateSchema, mn as DATETIME_SCHEMA, nn as pathToVariableName, on as inferRequiredSchema, pn as BLOB_SCHEMA, qt as getSchemaRef, rn as replaceHyphenatedPath, s as pick, sn as isArraySchemaObject, tn as pathParamToVariableName, un as ALLOWED_METHODS, ut as getUniqueArray, vn as NUMBER_SCHEMA, wt as getResponseZodSchemaName, xn as UUID_SCHEMA, xt as getBodyZodSchemaName, yn as STRING_SCHEMA, zn as decapitalize } from "./generate.runner-CxlaA4c5.mjs";
 //#region src/generators/const/validation.const.ts
 const HTTP_STATUS_CODES = {
 	"100": "Continue",

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { a as RestClient, i as Response, n as RequestConfig, o as RestIntercepto
 import { n as useWorkspaceContext, r as OpenApiRouter, t as OpenApiWorkspaceContext } from "./workspace.context-isVY9ves.mjs";
 import { i as QueryModule, n as InvalidationMapFunc, r as OpenApiQueryConfig, t as InvalidationMap } from "./queryConfig.context-CRJOgf19.mjs";
 import { t as RestUtils } from "./rest.utils-DpiFIdhF.mjs";
-import { t as OpenAPICodegenConfig } from "./config-FD2Y872S.mjs";
+import { t as OpenAPICodegenConfig } from "./config-BYiBd1QI.mjs";
 import { d as TransportResponse, l as TransportRequest, n as HttpError, p as UploadProgress, u as TransportRequestConfig } from "./rest-transport.types-DM5-qyOJ.mjs";
 import { n as NativeRestInterceptor, r as NativeRestClient, t as NativeInterceptor } from "./native-rest-interceptor-PgziZt1f.mjs";
 import { a as AppQueryOptions, i as AppMutationOptions, n as useMutationEffects, r as AppInfiniteQueryOptions, t as MutationEffectsOptions } from "./useMutationEffects-DIdL8tlx.mjs";

package/dist/metro.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_generate_utils = require("./generate.utils-BSDYGp-0.cjs");
+const require_generate_utils = require("./generate.utils-SfgYwPe7.cjs");
 let fs = require("fs");
 fs = require_generate_utils.__toESM(fs, 1);
 let path = require("path");
@@ -103,7 +103,7 @@ async function runGenerate({ fileConfig, params, formatGeneratedFile, profiler =
 			const nativeFiles = generateFilesFromNativeOpenAPI(nativeInput.source, nativeInput.yaml, config);
 			if (nativeFiles) return nativeFiles;
 		}
-		const { generateCodeFromOpenAPIDoc } = await Promise.resolve().then(() => require("./generateCodeFromOpenAPIDoc-BypeVKIE.cjs"));
+		const { generateCodeFromOpenAPIDoc } = await Promise.resolve().then(() => require("./generateCodeFromOpenAPIDoc-Dv-hqKhh.cjs"));
 		return generateCodeFromOpenAPIDoc(openApiDoc, config, profiler, {
 			source: nativeInput.source,
 			yaml: nativeInput.yaml

package/dist/metro.d.mts

@@ -1,6 +1,6 @@
-import { r as GenerateFileFormatter } from "./options-rz2bcsaN.mjs";
-import { t as OpenAPICodegenConfig } from "./config-FD2Y872S.mjs";
-import { d as GenerateOpenApiFile, m as GenerateOpenApiSpec, n as TinyOpenApiSpecModuleConfig } from "./openapi-source.runner-Bje-tMOV.mjs";
+import { r as GenerateFileFormatter } from "./options-DH-fAG0w.mjs";
+import { t as OpenAPICodegenConfig } from "./config-BYiBd1QI.mjs";
+import { d as GenerateOpenApiFile, m as GenerateOpenApiSpec, n as TinyOpenApiSpecModuleConfig } from "./openapi-source.runner-lmK-P6HE.mjs";
 import { IncomingMessage, ServerResponse } from "http";
 //#region src/metro/openapi-codegen.plugin.d.ts
 type OpenApiCodegenMetroConfig = OpenAPICodegenConfig & {

package/dist/metro.mjs

@@ -1,4 +1,4 @@
-import { t as createOpenApiCodegenRunner } from "./openapi-codegen.runner-DUqQD2B5.mjs";
+import { t as createOpenApiCodegenRunner } from "./openapi-codegen.runner-DDd4AXRT.mjs";
 import { i as normalizeWatchFolders, r as isTinyOpenApiFakeMode, t as createTinyOpenApiSourceRunner } from "./openapi-source.runner-DPUNTduQ.mjs";
 import fs from "fs";
 import path from "path";

package/dist/{openapi-codegen.runner-DUqQD2B5.mjs → openapi-codegen.runner-DDd4AXRT.mjs}

@@ -1,4 +1,4 @@
-import { Wn as Profiler, n as runGenerate } from "./generate.runner-CLK1FoLT.mjs";
+import { Wn as Profiler, n as runGenerate } from "./generate.runner-CxlaA4c5.mjs";
 import path from "path";
 //#region src/plugins/openapi-codegen.runner.ts
 function createOpenApiCodegenRunner(config, options = {}) {

package/dist/{openapi-source.runner-Bje-tMOV.d.mts → openapi-source.runner-lmK-P6HE.d.mts}

@@ -1,4 +1,4 @@
-import { t as OpenAPICodegenConfig } from "./config-FD2Y872S.mjs";
+import { t as OpenAPICodegenConfig } from "./config-BYiBd1QI.mjs";
 //#region src/tiny/openapi.d.ts
 interface GenerateOpenApiFileOptions {
   argv?: readonly string[];

package/dist/{options-rz2bcsaN.d.mts → options-DH-fAG0w.d.mts}

@@ -19,6 +19,8 @@ interface ZodGenerateOptions {
   compileSchemas?: boolean;
   /** Build namespace model schemas on first access instead of at import. Requires tsNamespaces. */
   lazySchemas?: boolean;
+  /** Emit JSDoc comments in generated code. Defaults to false. */
+  generateJsDoc?: boolean;
   schemaSuffix: string;
   enumSuffix: string;
   modelsInCommon?: boolean;

package/dist/sh.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
-import { i as VALIDATION_ERROR_TYPE_TITLE, n as groupByType, t as getDataFromOpenAPIDoc } from "./getDataFromOpenAPIDoc-DYiCTWno.mjs";
-import { D as getTagFileName, Wn as Profiler, a as resolveConfig, n as runGenerate, o as getOutputFileName, t as getOpenApiDoc } from "./generate.runner-CLK1FoLT.mjs";
+import { i as VALIDATION_ERROR_TYPE_TITLE, n as groupByType, t as getDataFromOpenAPIDoc } from "./getDataFromOpenAPIDoc-DzeHecv2.mjs";
+import { D as getTagFileName, Wn as Profiler, a as resolveConfig, n as runGenerate, o as getOutputFileName, t as getOpenApiDoc } from "./generate.runner-CxlaA4c5.mjs";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { styleText } from "node:util";
@@ -31,7 +31,7 @@ function logBanner(message) {
 * Fetch the version from package.json
 */
 function getVersion() {
-	return "3.3.0";
+	return "3.3.1";
 }
 //#endregion
 //#region src/helpers/yargs.helper.ts
@@ -266,6 +266,7 @@ var GenerateOptions = class {
 	importPath;
 	compileSchemas;
 	lazySchemas;
+	generateJsDoc;
 	extractEnums;
 	modelsInCommon;
 	modelsInModules;
@@ -333,6 +334,10 @@ __decorate([YargOption({
 	envAlias: "lazySchemas",
 	type: "boolean"
 }), __decorateMetadata("design:type", Boolean)], GenerateOptions.prototype, "lazySchemas", void 0);
+__decorate([YargOption({
+	envAlias: "generateJsDoc",
+	type: "boolean"
+}), __decorateMetadata("design:type", Boolean)], GenerateOptions.prototype, "generateJsDoc", void 0);
 __decorate([YargOption({
 	envAlias: "extractEnums",
 	type: "boolean"

package/dist/tiny.d.mts

@@ -1,2 +1,2 @@
-import { $ as getModuleOpenApiTag, A as collectApiModelSchemaExports, At as toOpenAPI30Document, B as collectReachableModelSchemas, C as applyEnumExtensions, Ct as procedureSchemaName, D as applyRobodevModuleExtensions, Dt as schemaExportName, E as applyParameterExtensions, Et as schemaComponentRef, F as collectExtraSchemas, G as findComponentEnumNames, H as compactTagName, I as collectModelSchemaExports, J as generateOpenApiFile, K as findEnumNames, L as collectModuleModelSchemaExports, M as collectContractSchemas, Mt as toOpenAPIAclRule, N as collectDbTableModelSchemaExport, Nt as toPascalCase, O as applyRobodevUserRolesExtension, Ot as sharedSchemaExportName, P as collectDbTableModelSchemaExports, Pt as visitZodSchema, Q as getModuleOpenApiController, R as collectOperationMeta, S as addContractSchema, St as operationKey, T as applyPaginatedItemSchemas, Tt as routeHasPathParameters, U as createModelSchemaNameGetter, V as collectSchemaRegistryRoots, W as defineOpenApiSchemas, X as getContractProcedureData, Y as getComponentSchemas, Z as getDerivedOperationId, _ as OpenApiSchemaRegistry, _t as namedControllerActionSchema, a as isTinyOpenApiFakeMode, at as getProcedureInputSchemaRole, b as TinyOpenApiUserRole, bt as namedOpenApiResponseSchema, c as AnyContractRouter, ct as isContractProcedure, d as GenerateOpenApiFile, dt as isObject, et as getObjectPropertySchema, f as GenerateOpenApiFileOptions, ft as isProcedureMeta, g as JsonObject, gt as namedControllerActionInputDtoSchema, h as GenerateTinyOpenApiFileOptions, ht as modelSchemaNameEntries, i as getLocalInputPath, it as getPaginatedItemSchema, j as collectContractSchemaRoots, jt as toOpenAPI30Schema, k as asStringArray, kt as stripNoContentResponseBodies, l as AnySchema, lt as isNullSchema, m as GenerateOpenApiSpec, mt as modelSchemaExportName, nt as getOperationAction, o as normalizeWatchFolders, ot as getRobodevModuleRoles, p as GenerateOpenApiFileResult, pt as isZodSchema, q as generateORPCOpenAPISpec, r as createTinyOpenApiSourceRunner, rt as getOperationController, s as AclRule, st as getStringEnumValues, t as TinyOpenApiSourceRunnerConfig, tt as getOpenApiSchemaName, u as GenerateORPCOpenAPISpecOptions, ut as isNullableOnlySchema, v as ProcedureMeta, vt as namedOpenApiOutputSchema, w as applyOperationMeta, wt as resolveOpenApiOutputPath, x as ZodSchema, xt as namedOpenApiSchema, y as TinyOpenApiModule, yt as namedOpenApiRequestSchema, z as collectOperationTags } from "./openapi-source.runner-Bje-tMOV.mjs";
+import { $ as getModuleOpenApiTag, A as collectApiModelSchemaExports, At as toOpenAPI30Document, B as collectReachableModelSchemas, C as applyEnumExtensions, Ct as procedureSchemaName, D as applyRobodevModuleExtensions, Dt as schemaExportName, E as applyParameterExtensions, Et as schemaComponentRef, F as collectExtraSchemas, G as findComponentEnumNames, H as compactTagName, I as collectModelSchemaExports, J as generateOpenApiFile, K as findEnumNames, L as collectModuleModelSchemaExports, M as collectContractSchemas, Mt as toOpenAPIAclRule, N as collectDbTableModelSchemaExport, Nt as toPascalCase, O as applyRobodevUserRolesExtension, Ot as sharedSchemaExportName, P as collectDbTableModelSchemaExports, Pt as visitZodSchema, Q as getModuleOpenApiController, R as collectOperationMeta, S as addContractSchema, St as operationKey, T as applyPaginatedItemSchemas, Tt as routeHasPathParameters, U as createModelSchemaNameGetter, V as collectSchemaRegistryRoots, W as defineOpenApiSchemas, X as getContractProcedureData, Y as getComponentSchemas, Z as getDerivedOperationId, _ as OpenApiSchemaRegistry, _t as namedControllerActionSchema, a as isTinyOpenApiFakeMode, at as getProcedureInputSchemaRole, b as TinyOpenApiUserRole, bt as namedOpenApiResponseSchema, c as AnyContractRouter, ct as isContractProcedure, d as GenerateOpenApiFile, dt as isObject, et as getObjectPropertySchema, f as GenerateOpenApiFileOptions, ft as isProcedureMeta, g as JsonObject, gt as namedControllerActionInputDtoSchema, h as GenerateTinyOpenApiFileOptions, ht as modelSchemaNameEntries, i as getLocalInputPath, it as getPaginatedItemSchema, j as collectContractSchemaRoots, jt as toOpenAPI30Schema, k as asStringArray, kt as stripNoContentResponseBodies, l as AnySchema, lt as isNullSchema, m as GenerateOpenApiSpec, mt as modelSchemaExportName, nt as getOperationAction, o as normalizeWatchFolders, ot as getRobodevModuleRoles, p as GenerateOpenApiFileResult, pt as isZodSchema, q as generateORPCOpenAPISpec, r as createTinyOpenApiSourceRunner, rt as getOperationController, s as AclRule, st as getStringEnumValues, t as TinyOpenApiSourceRunnerConfig, tt as getOpenApiSchemaName, u as GenerateORPCOpenAPISpecOptions, ut as isNullableOnlySchema, v as ProcedureMeta, vt as namedOpenApiOutputSchema, w as applyOperationMeta, wt as resolveOpenApiOutputPath, x as ZodSchema, xt as namedOpenApiSchema, y as TinyOpenApiModule, yt as namedOpenApiRequestSchema, z as collectOperationTags } from "./openapi-source.runner-lmK-P6HE.mjs";
 export { AclRule, AnyContractRouter, AnySchema, GenerateORPCOpenAPISpecOptions, GenerateOpenApiFile, GenerateOpenApiFileOptions, GenerateOpenApiFileResult, GenerateOpenApiSpec, GenerateTinyOpenApiFileOptions, JsonObject, OpenApiSchemaRegistry, ProcedureMeta, TinyOpenApiModule, type TinyOpenApiSourceRunnerConfig, TinyOpenApiUserRole, ZodSchema, addContractSchema, applyEnumExtensions, applyOperationMeta, applyPaginatedItemSchemas, applyParameterExtensions, applyRobodevModuleExtensions, applyRobodevUserRolesExtension, asStringArray, collectApiModelSchemaExports, collectContractSchemaRoots, collectContractSchemas, collectDbTableModelSchemaExport, collectDbTableModelSchemaExports, collectExtraSchemas, collectModelSchemaExports, collectModuleModelSchemaExports, collectOperationMeta, collectOperationTags, collectReachableModelSchemas, collectSchemaRegistryRoots, compactTagName, createModelSchemaNameGetter, createTinyOpenApiSourceRunner, defineOpenApiSchemas, findComponentEnumNames, findEnumNames, generateORPCOpenAPISpec, generateOpenApiFile, getComponentSchemas, getContractProcedureData, getDerivedOperationId, getModuleOpenApiController, getModuleOpenApiTag, getObjectPropertySchema, getOpenApiSchemaName, getOperationAction, getOperationController, getPaginatedItemSchema, getProcedureInputSchemaRole, getRobodevModuleRoles, getStringEnumValues, getLocalInputPath as getTinyOpenApiLocalInputPath, isContractProcedure, isNullSchema, isNullableOnlySchema, isObject, isProcedureMeta, isTinyOpenApiFakeMode, isZodSchema, modelSchemaExportName, modelSchemaNameEntries, namedControllerActionInputDtoSchema, namedControllerActionSchema, namedOpenApiOutputSchema, namedOpenApiRequestSchema, namedOpenApiResponseSchema, namedOpenApiSchema, normalizeWatchFolders as normalizeTinyOpenApiWatchFolders, operationKey, procedureSchemaName, resolveOpenApiOutputPath, routeHasPathParameters, schemaComponentRef, schemaExportName, sharedSchemaExportName, stripNoContentResponseBodies, toOpenAPI30Document, toOpenAPI30Schema, toOpenAPIAclRule, toPascalCase, visitZodSchema };

package/dist/vite.d.mts

@@ -1,6 +1,6 @@
-import { r as GenerateFileFormatter } from "./options-rz2bcsaN.mjs";
-import { t as OpenAPICodegenConfig } from "./config-FD2Y872S.mjs";
-import { d as GenerateOpenApiFile, m as GenerateOpenApiSpec, n as TinyOpenApiSpecModuleConfig } from "./openapi-source.runner-Bje-tMOV.mjs";
+import { r as GenerateFileFormatter } from "./options-DH-fAG0w.mjs";
+import { t as OpenAPICodegenConfig } from "./config-BYiBd1QI.mjs";
+import { d as GenerateOpenApiFile, m as GenerateOpenApiSpec, n as TinyOpenApiSpecModuleConfig } from "./openapi-source.runner-lmK-P6HE.mjs";
 import { Plugin, PluginOption } from "vite";
 //#region src/plugins/openapi-codegen.runner.d.ts
 type OpenApiCodegenPluginConfig = OpenAPICodegenConfig & {

package/dist/vite.mjs

@@ -1,4 +1,4 @@
-import { t as createOpenApiCodegenRunner } from "./openapi-codegen.runner-DUqQD2B5.mjs";
+import { t as createOpenApiCodegenRunner } from "./openapi-codegen.runner-DDd4AXRT.mjs";
 import { i as normalizeWatchFolders, r as isTinyOpenApiFakeMode, t as createTinyOpenApiSourceRunner } from "./openapi-source.runner-DPUNTduQ.mjs";
 import path from "path";
 //#region src/vite/openapi-codegen.plugin.ts

package/package.json

@@ -125,13 +125,14 @@
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@casl/ability": "6.8.0",
-    "@casl/react": "5.0.1",
+    "@casl/ability": "7.1.1",
+    "@casl/react": "7.1.0",
     "@tanstack/react-query": "~5.90.21",
     "@types/bun": "1.4.1",
     "@types/node": "^25.3.0",
     "@types/prompt-sync": "^4.2.3",
     "@types/react": "^19.2.14",
+    "@types/react-test-renderer": "^19.1.0",
     "@types/yargs": "^17.0.35",
     "@vitejs/plugin-react": "^5.1.4",
     "axios": "^1.13.1",
@@ -140,6 +141,7 @@
     "oxlint": "1.50.0",
     "oxlint-tsgolint": "^0.15.0",
     "react": "^19.2.4",
+    "react-test-renderer": "19.2.4",
     "tsdown": "^0.22.14",
     "tsx": "^4.21.0",
     "type-fest": "^5.4.4",
@@ -150,8 +152,8 @@
     "zod": "^4.5.0"
   },
   "peerDependencies": {
-    "@casl/ability": "^6.7.3",
-    "@casl/react": "^5.0.0",
+    "@casl/ability": "^7.1.1",
+    "@casl/react": "^7.1.0",
     "@tanstack/react-query": "^5.90.21",
     "axios": "^1.13.1",
     "i18next": "^25.8.11",
@@ -187,5 +189,5 @@
     "node": ">= 18"
   },
   "packageManager": "bun@1.4.1",
-  "version": "3.3.0"
+  "version": "3.3.1"
 }