44
55### v27.4.0
66
7- - Introduced ` maxCombinations ` setting for Documentation generator:
8- - Limits cartesian product when generating examples by combining each property's own examples;
9- - Set to ` 0 ` to disable product but keep concatenations ;
10- - Default is ` Infinity ` , but may change to reasonable number in v28 to avoid too many combinations;
7+ - Introduced ` limits ` option for Documentation generator with two nested settings :
8+ - ` examples ` — caps the cartesian product when combining each property's own examples;
9+ - ` security ` — caps the cartesian product of security schemas combinations (must be at least 1) ;
10+ - Both default to ` Infinity ` , but will be changed to a reasonable number in v28 to avoid too many combinations;
1111 - Example: 6 props with 2 examples each → cartesian product makes 2^6 = 64 request examples:
1212
1313``` ts
@@ -19,7 +19,7 @@ const schema = z.object({
1919 active: z .boolean ().example (true ).example (false ),
2020 tags: z .array (z .string ()).example ([" vip" ]).example ([" new" , " promo" ]),
2121});
22- // First 5:
22+ // First 5 of 64 cartesian combinations :
2323// { id: 1, name: "john", age: 18, role: "user", active: true, tags: ["vip"] },
2424// { id: 1, name: "john", age: 18, role: "user", active: true, tags: ["new", "promo"] },
2525// { id: 1, name: "john", age: 18, role: "user", active: false, tags: ["vip"] },
0 commit comments