Merge branch 'master' into limit-combinations

Author: RobinTail

CHANGELOG.md

@@ -28,6 +28,11 @@ const schema = z.object({
 // ...and 59 more
 ```
 
+### v27.2.5
+
+- Reduced memory footprint at runtime: deferred population of well-known headers to Documentation;
+- Faster header lookup in Documentation generator (only when `headers` enabled in `inputSources`).
+
 ### v27.2.4
 
 - Fixed performance regression since v24.0.0:

express-zod-api/bench/headers-lookup.bench.ts

@@ -0,0 +1,16 @@
+import { bench } from "vitest";
+import { getWellKnownHeaders } from "../src/well-known-headers";
+
+const target = "x-frame-options";
+
+describe("Array.includes vs Set.has for well-known headers lookup", () => {
+  const headersArray = Array.from(getWellKnownHeaders());
+
+  bench("Array.includes", () => {
+    headersArray.includes(target);
+  });
+
+  bench("Set.has", () => {
+    getWellKnownHeaders().has(target);
+  });
+});

express-zod-api/bench/queue-ops.bench.ts

@@ -45,7 +45,7 @@ import { ezRawBrand } from "./raw-schema";
 import { FirstPartyKind } from "./schema-walker";
 import { Security } from "./security";
 import { ezUploadBrand } from "./upload-schema";
-import wellKnownHeaders from "./well-known-headers";
+import { getWellKnownHeaders } from "./well-known-headers";
 
 interface ReqResCommons {
   makeRef: (
@@ -272,7 +272,7 @@ export const defaultIsHeader = (
 ): name is `x-${string}` =>
   familiar?.has(name) ||
   name.startsWith("x-") ||
-  wellKnownHeaders.includes(name);
+  getWellKnownHeaders().has(name);
 
 export const depictRequestParams = ({
   path,