@maverickcer/env-cap 0.7.5 → 0.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/ADOPTION.md +12 -12
  2. package/AGENTS.md +85 -120
  3. package/CHANGELOG.md +36 -0
  4. package/CODE_REVIEW.md +5 -5
  5. package/CONTRIBUTING.md +5 -5
  6. package/GUIDE.md +42 -24
  7. package/README.md +52 -34
  8. package/RELEASING.md +78 -64
  9. package/SECURITY.md +15 -15
  10. package/VERSIONING.md +16 -15
  11. package/benchmarks/READING-BENCHMARKS.md +101 -85
  12. package/benchmarks/README.md +12 -9
  13. package/benchmarks/WRITING-BENCHMARKS.md +89 -79
  14. package/benchmarks/performance-buildtime/BENCHMARKS.md +20 -20
  15. package/benchmarks/performance-runtime/BENCHMARKS.md +107 -107
  16. package/dist/.dts/_ipc/build-fs.d.ts +3 -3
  17. package/dist/.dts/_ipc/build-fs.d.ts.map +1 -1
  18. package/dist/.dts/_ipc/display-path.d.ts +1 -1
  19. package/dist/.dts/_ipc/glob.d.ts +3 -2
  20. package/dist/.dts/_ipc/glob.d.ts.map +1 -1
  21. package/dist/.dts/_ipc/no-node-fs.d.ts +2 -2
  22. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +16 -16
  23. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  24. package/dist/.dts/_ipc/typescript.d.ts +4 -4
  25. package/dist/.dts/build/assemble-project.d.ts +14 -15
  26. package/dist/.dts/build/assemble-project.d.ts.map +1 -1
  27. package/dist/.dts/build/change-model.d.ts +14 -14
  28. package/dist/.dts/build/change-model.d.ts.map +1 -1
  29. package/dist/.dts/build/check-artifacts.d.ts +4 -4
  30. package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
  31. package/dist/.dts/build/citation-verification.d.ts +13 -14
  32. package/dist/.dts/build/citation-verification.d.ts.map +1 -1
  33. package/dist/.dts/build/compatibility.d.ts +24 -24
  34. package/dist/.dts/build/compatibility.d.ts.map +1 -1
  35. package/dist/.dts/build/contract-model.d.ts +10 -10
  36. package/dist/.dts/build/contract-model.d.ts.map +1 -1
  37. package/dist/.dts/build/deep-equal.d.ts +2 -2
  38. package/dist/.dts/build/deep-freeze.d.ts +2 -2
  39. package/dist/.dts/build/dependency-graph.d.ts +48 -55
  40. package/dist/.dts/build/dependency-graph.d.ts.map +1 -1
  41. package/dist/.dts/build/dependency-model.d.ts +18 -18
  42. package/dist/.dts/build/dependency-model.d.ts.map +1 -1
  43. package/dist/.dts/build/discover.d.ts +11 -11
  44. package/dist/.dts/build/discover.d.ts.map +1 -1
  45. package/dist/.dts/build/docs.d.ts +34 -38
  46. package/dist/.dts/build/docs.d.ts.map +1 -1
  47. package/dist/.dts/build/env-example.d.ts +13 -13
  48. package/dist/.dts/build/env-example.d.ts.map +1 -1
  49. package/dist/.dts/build/errors.d.ts +8 -8
  50. package/dist/.dts/build/evidence-cache.d.ts +23 -23
  51. package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
  52. package/dist/.dts/build/evidence-model.d.ts +3 -3
  53. package/dist/.dts/build/evidence-reference.d.ts +15 -15
  54. package/dist/.dts/build/evidence-reference.d.ts.map +1 -1
  55. package/dist/.dts/build/evidence-snapshot.d.ts +47 -53
  56. package/dist/.dts/build/evidence-snapshot.d.ts.map +1 -1
  57. package/dist/.dts/build/exclusive-group.d.ts +4 -4
  58. package/dist/.dts/build/exclusive-group.d.ts.map +1 -1
  59. package/dist/.dts/build/finding-model.d.ts +12 -12
  60. package/dist/.dts/build/finding-model.d.ts.map +1 -1
  61. package/dist/.dts/build/generate-documentation.d.ts +19 -19
  62. package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
  63. package/dist/.dts/build/generate-env-artifacts.d.ts +43 -43
  64. package/dist/.dts/build/generate-env-artifacts.d.ts.map +1 -1
  65. package/dist/.dts/build/generate-evidence.d.ts +19 -19
  66. package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
  67. package/dist/.dts/build/generate-manifest.d.ts +11 -12
  68. package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
  69. package/dist/.dts/build/generate-usage.d.ts +23 -24
  70. package/dist/.dts/build/generate-usage.d.ts.map +1 -1
  71. package/dist/.dts/build/generated-banner.d.ts +5 -5
  72. package/dist/.dts/build/governance-fields.d.ts +7 -7
  73. package/dist/.dts/build/humanize-key.d.ts +1 -1
  74. package/dist/.dts/build/humanize-key.d.ts.map +1 -1
  75. package/dist/.dts/build/index.d.ts +20 -36
  76. package/dist/.dts/build/index.d.ts.map +1 -1
  77. package/dist/.dts/build/lifecycle-model.d.ts +87 -85
  78. package/dist/.dts/build/lifecycle-model.d.ts.map +1 -1
  79. package/dist/.dts/build/link.d.ts +38 -39
  80. package/dist/.dts/build/link.d.ts.map +1 -1
  81. package/dist/.dts/build/literal-eval.d.ts +2 -2
  82. package/dist/.dts/build/literal-eval.d.ts.map +1 -1
  83. package/dist/.dts/build/live-expirations.d.ts +14 -13
  84. package/dist/.dts/build/live-expirations.d.ts.map +1 -1
  85. package/dist/.dts/build/manifest.d.ts +6 -6
  86. package/dist/.dts/build/map-utils.d.ts +4 -4
  87. package/dist/.dts/build/merge-documentation.d.ts +9 -8
  88. package/dist/.dts/build/merge-documentation.d.ts.map +1 -1
  89. package/dist/.dts/build/ownership-model.d.ts +14 -15
  90. package/dist/.dts/build/ownership-model.d.ts.map +1 -1
  91. package/dist/.dts/build/parse.d.ts +20 -21
  92. package/dist/.dts/build/parse.d.ts.map +1 -1
  93. package/dist/.dts/build/reference-projections.d.ts +36 -38
  94. package/dist/.dts/build/reference-projections.d.ts.map +1 -1
  95. package/dist/.dts/build/resolution/resolve-import.d.ts +18 -14
  96. package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
  97. package/dist/.dts/build/resolution/resolve-package-schema.d.ts +26 -26
  98. package/dist/.dts/build/resolution/resolve-package-schema.d.ts.map +1 -1
  99. package/dist/.dts/build/resolution/resolve-within-root.d.ts +9 -9
  100. package/dist/.dts/build/sarif.d.ts +5 -5
  101. package/dist/.dts/build/sarif.d.ts.map +1 -1
  102. package/dist/.dts/build/scan-dependencies.d.ts +17 -16
  103. package/dist/.dts/build/scan-dependencies.d.ts.map +1 -1
  104. package/dist/.dts/build/sort-by-identity.d.ts +1 -1
  105. package/dist/.dts/build/source-position.d.ts +13 -13
  106. package/dist/.dts/build/tool-version.d.ts +1 -1
  107. package/dist/.dts/build/usage-report.d.ts +19 -19
  108. package/dist/.dts/build/usage-report.d.ts.map +1 -1
  109. package/dist/.dts/eslint-plugin/index.d.ts +16 -5
  110. package/dist/.dts/eslint-plugin/index.d.ts.map +1 -1
  111. package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts +4 -4
  112. package/dist/.dts/evidence/define-projection.d.ts +15 -16
  113. package/dist/.dts/evidence/define-projection.d.ts.map +1 -1
  114. package/dist/.dts/evidence/index.d.ts +11 -15
  115. package/dist/.dts/evidence/index.d.ts.map +1 -1
  116. package/dist/.dts/helpers/index.d.ts +15 -18
  117. package/dist/.dts/helpers/index.d.ts.map +1 -1
  118. package/dist/.dts/helpers/validators.d.ts +2 -2
  119. package/dist/.dts/helpers/validators.d.ts.map +1 -1
  120. package/dist/.dts/node/index.d.ts +19 -0
  121. package/dist/.dts/node/index.d.ts.map +1 -1
  122. package/dist/.dts/runtime/create.d.ts +3 -3
  123. package/dist/.dts/runtime/document.d.ts +90 -99
  124. package/dist/.dts/runtime/document.d.ts.map +1 -1
  125. package/dist/.dts/runtime/errors.d.ts +5 -5
  126. package/dist/.dts/runtime/reset.d.ts +1 -1
  127. package/dist/.dts/runtime/types.d.ts +23 -24
  128. package/dist/.dts/runtime/types.d.ts.map +1 -1
  129. package/dist/.dts/runtime/validate.d.ts +1 -1
  130. package/dist/.dts7/_ipc/build-fs.d.ts +3 -3
  131. package/dist/.dts7/_ipc/build-fs.d.ts.map +1 -1
  132. package/dist/.dts7/_ipc/display-path.d.ts +1 -1
  133. package/dist/.dts7/_ipc/glob.d.ts +3 -2
  134. package/dist/.dts7/_ipc/glob.d.ts.map +1 -1
  135. package/dist/.dts7/_ipc/no-node-fs.d.ts +2 -2
  136. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts +16 -16
  137. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  138. package/dist/.dts7/_ipc/typescript.d.ts +4 -4
  139. package/dist/.dts7/build/assemble-project.d.ts +14 -15
  140. package/dist/.dts7/build/assemble-project.d.ts.map +1 -1
  141. package/dist/.dts7/build/change-model.d.ts +14 -14
  142. package/dist/.dts7/build/change-model.d.ts.map +1 -1
  143. package/dist/.dts7/build/check-artifacts.d.ts +4 -4
  144. package/dist/.dts7/build/check-artifacts.d.ts.map +1 -1
  145. package/dist/.dts7/build/citation-verification.d.ts +13 -14
  146. package/dist/.dts7/build/citation-verification.d.ts.map +1 -1
  147. package/dist/.dts7/build/compatibility.d.ts +24 -24
  148. package/dist/.dts7/build/compatibility.d.ts.map +1 -1
  149. package/dist/.dts7/build/contract-model.d.ts +10 -10
  150. package/dist/.dts7/build/contract-model.d.ts.map +1 -1
  151. package/dist/.dts7/build/deep-equal.d.ts +2 -2
  152. package/dist/.dts7/build/deep-freeze.d.ts +2 -2
  153. package/dist/.dts7/build/dependency-graph.d.ts +48 -55
  154. package/dist/.dts7/build/dependency-graph.d.ts.map +1 -1
  155. package/dist/.dts7/build/dependency-model.d.ts +18 -18
  156. package/dist/.dts7/build/dependency-model.d.ts.map +1 -1
  157. package/dist/.dts7/build/discover.d.ts +11 -11
  158. package/dist/.dts7/build/discover.d.ts.map +1 -1
  159. package/dist/.dts7/build/docs.d.ts +34 -38
  160. package/dist/.dts7/build/docs.d.ts.map +1 -1
  161. package/dist/.dts7/build/env-example.d.ts +13 -13
  162. package/dist/.dts7/build/env-example.d.ts.map +1 -1
  163. package/dist/.dts7/build/errors.d.ts +8 -8
  164. package/dist/.dts7/build/evidence-cache.d.ts +23 -23
  165. package/dist/.dts7/build/evidence-cache.d.ts.map +1 -1
  166. package/dist/.dts7/build/evidence-model.d.ts +3 -3
  167. package/dist/.dts7/build/evidence-reference.d.ts +15 -15
  168. package/dist/.dts7/build/evidence-reference.d.ts.map +1 -1
  169. package/dist/.dts7/build/evidence-snapshot.d.ts +47 -53
  170. package/dist/.dts7/build/evidence-snapshot.d.ts.map +1 -1
  171. package/dist/.dts7/build/exclusive-group.d.ts +4 -4
  172. package/dist/.dts7/build/exclusive-group.d.ts.map +1 -1
  173. package/dist/.dts7/build/finding-model.d.ts +12 -12
  174. package/dist/.dts7/build/finding-model.d.ts.map +1 -1
  175. package/dist/.dts7/build/generate-documentation.d.ts +19 -19
  176. package/dist/.dts7/build/generate-documentation.d.ts.map +1 -1
  177. package/dist/.dts7/build/generate-env-artifacts.d.ts +43 -43
  178. package/dist/.dts7/build/generate-env-artifacts.d.ts.map +1 -1
  179. package/dist/.dts7/build/generate-evidence.d.ts +19 -19
  180. package/dist/.dts7/build/generate-evidence.d.ts.map +1 -1
  181. package/dist/.dts7/build/generate-manifest.d.ts +11 -12
  182. package/dist/.dts7/build/generate-manifest.d.ts.map +1 -1
  183. package/dist/.dts7/build/generate-usage.d.ts +23 -24
  184. package/dist/.dts7/build/generate-usage.d.ts.map +1 -1
  185. package/dist/.dts7/build/generated-banner.d.ts +5 -5
  186. package/dist/.dts7/build/governance-fields.d.ts +7 -7
  187. package/dist/.dts7/build/humanize-key.d.ts +1 -1
  188. package/dist/.dts7/build/humanize-key.d.ts.map +1 -1
  189. package/dist/.dts7/build/index.d.ts +20 -36
  190. package/dist/.dts7/build/index.d.ts.map +1 -1
  191. package/dist/.dts7/build/lifecycle-model.d.ts +87 -85
  192. package/dist/.dts7/build/lifecycle-model.d.ts.map +1 -1
  193. package/dist/.dts7/build/link.d.ts +38 -39
  194. package/dist/.dts7/build/link.d.ts.map +1 -1
  195. package/dist/.dts7/build/literal-eval.d.ts +2 -2
  196. package/dist/.dts7/build/literal-eval.d.ts.map +1 -1
  197. package/dist/.dts7/build/live-expirations.d.ts +14 -13
  198. package/dist/.dts7/build/live-expirations.d.ts.map +1 -1
  199. package/dist/.dts7/build/manifest.d.ts +6 -6
  200. package/dist/.dts7/build/map-utils.d.ts +4 -4
  201. package/dist/.dts7/build/merge-documentation.d.ts +9 -8
  202. package/dist/.dts7/build/merge-documentation.d.ts.map +1 -1
  203. package/dist/.dts7/build/ownership-model.d.ts +14 -15
  204. package/dist/.dts7/build/ownership-model.d.ts.map +1 -1
  205. package/dist/.dts7/build/parse.d.ts +20 -21
  206. package/dist/.dts7/build/parse.d.ts.map +1 -1
  207. package/dist/.dts7/build/reference-projections.d.ts +36 -38
  208. package/dist/.dts7/build/reference-projections.d.ts.map +1 -1
  209. package/dist/.dts7/build/resolution/resolve-import.d.ts +18 -14
  210. package/dist/.dts7/build/resolution/resolve-import.d.ts.map +1 -1
  211. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts +26 -26
  212. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts.map +1 -1
  213. package/dist/.dts7/build/resolution/resolve-within-root.d.ts +9 -9
  214. package/dist/.dts7/build/sarif.d.ts +5 -5
  215. package/dist/.dts7/build/sarif.d.ts.map +1 -1
  216. package/dist/.dts7/build/scan-dependencies.d.ts +17 -16
  217. package/dist/.dts7/build/scan-dependencies.d.ts.map +1 -1
  218. package/dist/.dts7/build/sort-by-identity.d.ts +1 -1
  219. package/dist/.dts7/build/source-position.d.ts +13 -13
  220. package/dist/.dts7/build/tool-version.d.ts +1 -1
  221. package/dist/.dts7/build/usage-report.d.ts +19 -19
  222. package/dist/.dts7/build/usage-report.d.ts.map +1 -1
  223. package/dist/.dts7/eslint-plugin/index.d.ts +16 -5
  224. package/dist/.dts7/eslint-plugin/index.d.ts.map +1 -1
  225. package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts +4 -4
  226. package/dist/.dts7/evidence/define-projection.d.ts +15 -16
  227. package/dist/.dts7/evidence/define-projection.d.ts.map +1 -1
  228. package/dist/.dts7/evidence/index.d.ts +11 -15
  229. package/dist/.dts7/evidence/index.d.ts.map +1 -1
  230. package/dist/.dts7/helpers/index.d.ts +15 -18
  231. package/dist/.dts7/helpers/index.d.ts.map +1 -1
  232. package/dist/.dts7/helpers/validators.d.ts +2 -2
  233. package/dist/.dts7/helpers/validators.d.ts.map +1 -1
  234. package/dist/.dts7/node/index.d.ts +19 -0
  235. package/dist/.dts7/node/index.d.ts.map +1 -1
  236. package/dist/.dts7/runtime/create.d.ts +3 -3
  237. package/dist/.dts7/runtime/document.d.ts +90 -99
  238. package/dist/.dts7/runtime/document.d.ts.map +1 -1
  239. package/dist/.dts7/runtime/errors.d.ts +5 -5
  240. package/dist/.dts7/runtime/reset.d.ts +1 -1
  241. package/dist/.dts7/runtime/types.d.ts +23 -24
  242. package/dist/.dts7/runtime/types.d.ts.map +1 -1
  243. package/dist/.dts7/runtime/validate.d.ts +1 -1
  244. package/dist/{build-DNAYWD2B.js → build-33O5SDTC.js} +37 -39
  245. package/dist/build-33O5SDTC.js.map +1 -0
  246. package/dist/build.cjs +36 -38
  247. package/dist/build.cjs.map +1 -1
  248. package/dist/build.js +36 -38
  249. package/dist/build.js.map +1 -1
  250. package/dist/{chunk-HAGMVMN5.js → chunk-4D67AQFY.js} +2 -2
  251. package/dist/cli/index.js +29 -28
  252. package/dist/cli/index.js.map +1 -1
  253. package/dist/eslint-plugin/index.cjs.map +1 -1
  254. package/dist/eslint-plugin/index.js.map +1 -1
  255. package/dist/evidence.cjs +1 -1
  256. package/dist/evidence.cjs.map +1 -1
  257. package/dist/evidence.js +1 -1
  258. package/dist/evidence.js.map +1 -1
  259. package/dist/helpers.cjs +4 -4
  260. package/dist/helpers.cjs.map +1 -1
  261. package/dist/helpers.js +4 -4
  262. package/dist/helpers.js.map +1 -1
  263. package/dist/index.cjs.map +1 -1
  264. package/dist/index.js.map +1 -1
  265. package/examples/README.md +1 -1
  266. package/package.json +20 -13
  267. package/schemas/contract-model.schema.json +7 -7
  268. package/schemas/env-cap-report.schema.json +88 -88
  269. package/skills/env-cap/SKILL.md +12 -13
  270. package/skills/env-cap/references/api.md +1 -1
  271. package/specs/architecture.md +145 -120
  272. package/specs/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +9 -0
  273. package/specs/generated-artifacts.md +78 -70
  274. package/specs/migrations/README.md +6 -6
  275. package/specs/migrations/from-centralized-schema.md +1 -1
  276. package/specs/migrations/from-t3-env.md +9 -9
  277. package/PROMPT.md +0 -89
  278. package/dist/build-DNAYWD2B.js.map +0 -1
  279. /package/dist/{chunk-HAGMVMN5.js.map → chunk-4D67AQFY.js.map} +0 -0
@@ -1,12 +1,12 @@
1
1
  # env-cap: performance and cost report
2
2
 
3
- What does adopting this package add to latency, CPU, memory and compute spend -- and how does that grow with workload? Three views, from the whole to the part: **(1)** the end-to-end total, **(2)** every function on its own, **(3)** which functions make up the total. New to benchmarks? Read [READING-BENCHMARKS.md](../READING-BENCHMARKS.md) first.
3
+ What does adopting this package add to latency, CPU, memory and compute spend, and how does that grow with workload? Three views, from the whole to the part: **(1)** the end-to-end total, **(2)** every function on its own, **(3)** which functions make up the total. New to benchmarks? Read [READING-BENCHMARKS.md](../READING-BENCHMARKS.md) first.
4
4
 
5
5
  ## What adopting this package costs
6
6
 
7
7
  For a typical workload of **640 variables** per operation, routing the work through `env-cap` adds **187 µs** per operation compared with a bare-minimum baseline (**250% of the baseline**). Overall, it grows O(n) with workload size (measured exponent 0.76). At list prices that is on the order of **~$0.001 – $0.01 per million operations** of compute.
8
8
 
9
- > The relative figure and the growth class are the steadier ones: both come from the same run, so they depend far less on the machine than a time does, though runtime behaviour and contention on the runner still move them. The growth class is an empirical fit to the sizes tested, not a proof of asymptotic complexity. Dollar figures are **order-of-magnitude** estimates from published list prices on shared hardware (see _Cost model_ below) -- good for comparing one package with another, not for budgeting.
9
+ > The relative figure and the growth class are the steadier ones. Both come from the same run, so they depend far less on the machine than a time does. Runtime behaviour and contention on the runner still move them. The growth class is an empirical fit to the sizes tested, not a proof of asymptotic complexity. Dollar figures are **order-of-magnitude** estimates from published list prices on shared hardware (see _Cost model_ below). They show scale, not a budget.
10
10
 
11
11
  | Cost | Typical (640 variables) | Largest (10240 variables) |
12
12
  | --- | --- | --- |
@@ -25,7 +25,7 @@ Shows what a service pays at startup, per validation, for declaring its environm
25
25
  - **Baseline (no package):** A loop reads each of n values from a plain object and stores it in a result object -- no env-cap.
26
26
  - **With the package:** `validateEnv` checks the same n values against a contract of n variables with identity processors.
27
27
 
28
- Both sides use empty or minimal functions on purpose, so the difference is the package's own cost -- not the cost of the work an application would plug into it. Real applications add their own work on top; this is the floor the package imposes.
28
+ Both sides use empty or minimal functions on purpose. The difference is then the package's own cost, not the cost of the work an application would plug into it. Real applications add their own work on top; this is the floor the package imposes.
29
29
 
30
30
  **Variables that could change this result**
31
31
 
@@ -38,7 +38,7 @@ Both sides use empty or minimal functions on purpose, so the difference is the p
38
38
  | contract count | fixed at 1 | All variables live in one contract; splitting them across contracts adds a small constant per contract. |
39
39
  | validity | fixed at "every value valid" | The success path; failures add error-object construction and are cheaper to reach but costlier to report. |
40
40
 
41
- The baseline is an empty or minimal function, so it costs almost nothing and the _relative_ overhead can look enormous (shown as a multiple of the baseline). Read the absolute columns -- time, CPU and dollars added -- they are what a bill and a latency budget are made of.
41
+ The baseline is an empty or minimal function, so it costs almost nothing. The _relative_ overhead can then look enormous (shown as a multiple of the baseline). Read the absolute columns (time, CPU and dollars added): they are what a bill and a latency budget are made of.
42
42
 
43
43
  | variables | Baseline | With package | Added | Added vs baseline | Added CPU | Est. $ / 1M ops |
44
44
  | --- | --- | --- | --- | --- | --- | --- |
@@ -57,7 +57,7 @@ The baseline is an empty or minimal function, so it costs almost nothing and the
57
57
 
58
58
  ## 2. Function by function
59
59
 
60
- Every function the package exposes is measured on its own across the full size ladder, then its measured growth rate is compared with the big-O we documented for it. A function whose measured class **differs** from its documented one is the most useful thing in this report: either the documentation or the code is wrong.
60
+ Every function the package exposes is measured on its own across the full size ladder. Its measured growth rate is then compared with the big-O we documented for it. A function whose measured class **differs** from its documented one is the most useful thing in this report. Either the documentation or the code is wrong.
61
61
 
62
62
  | Function | Varies | Documented | Measured | Agreement | At 640 | At 10240 |
63
63
  | --- | --- | --- | --- | --- | --- | --- |
@@ -140,10 +140,10 @@ Every function the package exposes is measured on its own across the full size l
140
140
 
141
141
  **Deliberately not covered**
142
142
 
143
- - **warm module cache** -- A fresh process has no warm cache by definition.
144
- - **bundled loading** -- Measured through Node's native ESM loader; bundlers change module-evaluation cost and are application-specific.
143
+ - **warm module cache**: A fresh process has no warm cache by definition.
144
+ - **bundled loading**: Measured through Node's native ESM loader; bundlers change module-evaluation cost and are application-specific.
145
145
 
146
- **Measured: O(log n)** (exponent 0.59, 10 sizes) -- 🟡 close (neighbouring class).
146
+ **Measured: O(log n)** (exponent 0.59, 10 sizes): 🟡 close (neighbouring class).
147
147
 
148
148
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
149
149
  | --- | --- | --- | --- | --- | --- |
@@ -210,7 +210,7 @@ Every function the package exposes is measured on its own across the full size l
210
210
 
211
211
  **In the end-to-end run:** This is the end-to-end operation itself.
212
212
 
213
- **Measured: O(n)** (exponent 0.77, 10 sizes) -- ✅ matches.
213
+ **Measured: O(n)** (exponent 0.77, 10 sizes): ✅ matches.
214
214
 
215
215
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
216
216
  | --- | --- | --- | --- | --- | --- |
@@ -250,7 +250,7 @@ How many variables each contract declares (ten in the main sweep). With the tota
250
250
 
251
251
  **Deliberately not covered**
252
252
 
253
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
253
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
254
254
 
255
255
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
256
256
  | --- | --- | --- | --- | --- | --- |
@@ -284,9 +284,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
284
284
 
285
285
  **Deliberately not covered**
286
286
 
287
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
287
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
288
288
 
289
- **Measured: O(n)** (exponent 1.10, 10 sizes) -- ✅ matches.
289
+ **Measured: O(n)** (exponent 1.10, 10 sizes): ✅ matches.
290
290
 
291
291
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
292
292
  | --- | --- | --- | --- | --- | --- |
@@ -320,9 +320,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
320
320
 
321
321
  **Deliberately not covered**
322
322
 
323
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
323
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
324
324
 
325
- **Measured: O(n)** (exponent 0.95, 10 sizes) -- ✅ matches.
325
+ **Measured: O(n)** (exponent 0.95, 10 sizes): ✅ matches.
326
326
 
327
327
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
328
328
  | --- | --- | --- | --- | --- | --- |
@@ -356,9 +356,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
356
356
 
357
357
  **Deliberately not covered**
358
358
 
359
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
359
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
360
360
 
361
- **Measured: O(n)** (exponent 0.86, 10 sizes) -- ✅ matches.
361
+ **Measured: O(n)** (exponent 0.86, 10 sizes): ✅ matches.
362
362
 
363
363
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
364
364
  | --- | --- | --- | --- | --- | --- |
@@ -392,9 +392,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
392
392
 
393
393
  **Deliberately not covered**
394
394
 
395
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
395
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
396
396
 
397
- **Measured: O(n log n)** (exponent 1.60, 10 sizes) -- 🟡 close (neighbouring class).
397
+ **Measured: O(n log n)** (exponent 1.60, 10 sizes): 🟡 close (neighbouring class).
398
398
 
399
399
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
400
400
  | --- | --- | --- | --- | --- | --- |
@@ -428,9 +428,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
428
428
 
429
429
  **Deliberately not covered**
430
430
 
431
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
431
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
432
432
 
433
- **Measured: O(1)** (exponent -0.01, 10 sizes) -- ✅ matches.
433
+ **Measured: O(1)** (exponent -0.01, 10 sizes): ✅ matches.
434
434
 
435
435
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
436
436
  | --- | --- | --- | --- | --- | --- |
@@ -464,9 +464,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
464
464
 
465
465
  **Deliberately not covered**
466
466
 
467
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
467
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
468
468
 
469
- **Measured: O(1)** (exponent -0.00, 10 sizes) -- ✅ matches.
469
+ **Measured: O(1)** (exponent -0.00, 10 sizes): ✅ matches.
470
470
 
471
471
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
472
472
  | --- | --- | --- | --- | --- | --- |
@@ -500,9 +500,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
500
500
 
501
501
  **Deliberately not covered**
502
502
 
503
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
503
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
504
504
 
505
- **Measured: O(1)** (exponent -0.02, 10 sizes) -- ✅ matches.
505
+ **Measured: O(1)** (exponent -0.02, 10 sizes): ✅ matches.
506
506
 
507
507
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
508
508
  | --- | --- | --- | --- | --- | --- |
@@ -536,9 +536,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
536
536
 
537
537
  **Deliberately not covered**
538
538
 
539
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
539
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
540
540
 
541
- **Measured: O(n)** (exponent 0.69, 10 sizes) -- ✅ matches.
541
+ **Measured: O(n)** (exponent 0.69, 10 sizes): ✅ matches.
542
542
 
543
543
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
544
544
  | --- | --- | --- | --- | --- | --- |
@@ -572,9 +572,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
572
572
 
573
573
  **Deliberately not covered**
574
574
 
575
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
575
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
576
576
 
577
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
577
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
578
578
 
579
579
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
580
580
  | --- | --- | --- | --- | --- | --- |
@@ -608,9 +608,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
608
608
 
609
609
  **Deliberately not covered**
610
610
 
611
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
611
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
612
612
 
613
- **Measured: O(n)** (exponent 0.77, 10 sizes) -- ✅ matches.
613
+ **Measured: O(n)** (exponent 0.77, 10 sizes): ✅ matches.
614
614
 
615
615
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
616
616
  | --- | --- | --- | --- | --- | --- |
@@ -644,9 +644,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
644
644
 
645
645
  **Deliberately not covered**
646
646
 
647
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
647
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
648
648
 
649
- **Measured: O(1)** (exponent -0.02, 10 sizes) -- ✅ matches.
649
+ **Measured: O(1)** (exponent -0.02, 10 sizes): ✅ matches.
650
650
 
651
651
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
652
652
  | --- | --- | --- | --- | --- | --- |
@@ -680,9 +680,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
680
680
 
681
681
  **Deliberately not covered**
682
682
 
683
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
683
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
684
684
 
685
- **Measured: O(log n)** (exponent 0.61, 10 sizes) -- 🟡 close (neighbouring class).
685
+ **Measured: O(log n)** (exponent 0.61, 10 sizes): 🟡 close (neighbouring class).
686
686
 
687
687
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
688
688
  | --- | --- | --- | --- | --- | --- |
@@ -716,9 +716,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
716
716
 
717
717
  **Deliberately not covered**
718
718
 
719
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
719
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
720
720
 
721
- **Measured: O(n)** (exponent 0.75, 10 sizes) -- ✅ matches.
721
+ **Measured: O(n)** (exponent 0.75, 10 sizes): ✅ matches.
722
722
 
723
723
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
724
724
  | --- | --- | --- | --- | --- | --- |
@@ -752,9 +752,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
752
752
 
753
753
  **Deliberately not covered**
754
754
 
755
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
755
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
756
756
 
757
- **Measured: O(n)** (exponent 0.89, 10 sizes) -- ✅ matches.
757
+ **Measured: O(n)** (exponent 0.89, 10 sizes): ✅ matches.
758
758
 
759
759
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
760
760
  | --- | --- | --- | --- | --- | --- |
@@ -788,9 +788,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
788
788
 
789
789
  **Deliberately not covered**
790
790
 
791
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
791
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
792
792
 
793
- **Measured: O(1)** (exponent -0.01, 10 sizes) -- ✅ matches.
793
+ **Measured: O(1)** (exponent -0.01, 10 sizes): ✅ matches.
794
794
 
795
795
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
796
796
  | --- | --- | --- | --- | --- | --- |
@@ -824,9 +824,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
824
824
 
825
825
  **Deliberately not covered**
826
826
 
827
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
827
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
828
828
 
829
- **Measured: O(n)** (exponent 0.97, 10 sizes) -- ✅ matches.
829
+ **Measured: O(n)** (exponent 0.97, 10 sizes): ✅ matches.
830
830
 
831
831
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
832
832
  | --- | --- | --- | --- | --- | --- |
@@ -860,9 +860,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
860
860
 
861
861
  **Deliberately not covered**
862
862
 
863
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
863
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
864
864
 
865
- **Measured: O(n)** (exponent 0.99, 10 sizes) -- ✅ matches.
865
+ **Measured: O(n)** (exponent 0.99, 10 sizes): ✅ matches.
866
866
 
867
867
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
868
868
  | --- | --- | --- | --- | --- | --- |
@@ -896,9 +896,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
896
896
 
897
897
  **Deliberately not covered**
898
898
 
899
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
899
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
900
900
 
901
- **Measured: O(1)** (exponent 0.01, 10 sizes) -- ✅ matches.
901
+ **Measured: O(1)** (exponent 0.01, 10 sizes): ✅ matches.
902
902
 
903
903
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
904
904
  | --- | --- | --- | --- | --- | --- |
@@ -932,9 +932,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
932
932
 
933
933
  **Deliberately not covered**
934
934
 
935
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
935
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
936
936
 
937
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
937
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
938
938
 
939
939
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
940
940
  | --- | --- | --- | --- | --- | --- |
@@ -968,9 +968,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
968
968
 
969
969
  **Deliberately not covered**
970
970
 
971
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
971
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
972
972
 
973
- **Measured: O(n)** (exponent 0.68, 10 sizes) -- ✅ matches.
973
+ **Measured: O(n)** (exponent 0.68, 10 sizes): ✅ matches.
974
974
 
975
975
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
976
976
  | --- | --- | --- | --- | --- | --- |
@@ -1004,9 +1004,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1004
1004
 
1005
1005
  **Deliberately not covered**
1006
1006
 
1007
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1007
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1008
1008
 
1009
- **Measured: O(1)** (exponent 0.02, 10 sizes) -- ✅ matches.
1009
+ **Measured: O(1)** (exponent 0.02, 10 sizes): ✅ matches.
1010
1010
 
1011
1011
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1012
1012
  | --- | --- | --- | --- | --- | --- |
@@ -1040,9 +1040,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1040
1040
 
1041
1041
  **Deliberately not covered**
1042
1042
 
1043
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1043
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1044
1044
 
1045
- **Measured: O(1)** (exponent 0.01, 10 sizes) -- ✅ matches.
1045
+ **Measured: O(1)** (exponent 0.01, 10 sizes): ✅ matches.
1046
1046
 
1047
1047
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1048
1048
  | --- | --- | --- | --- | --- | --- |
@@ -1076,9 +1076,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1076
1076
 
1077
1077
  **Deliberately not covered**
1078
1078
 
1079
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1079
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1080
1080
 
1081
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
1081
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
1082
1082
 
1083
1083
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1084
1084
  | --- | --- | --- | --- | --- | --- |
@@ -1112,9 +1112,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1112
1112
 
1113
1113
  **Deliberately not covered**
1114
1114
 
1115
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1115
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1116
1116
 
1117
- **Measured: O(1)** (exponent 0.15, 10 sizes) -- ✅ matches.
1117
+ **Measured: O(1)** (exponent 0.15, 10 sizes): ✅ matches.
1118
1118
 
1119
1119
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1120
1120
  | --- | --- | --- | --- | --- | --- |
@@ -1148,9 +1148,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1148
1148
 
1149
1149
  **Deliberately not covered**
1150
1150
 
1151
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1151
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1152
1152
 
1153
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
1153
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
1154
1154
 
1155
1155
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1156
1156
  | --- | --- | --- | --- | --- | --- |
@@ -1184,9 +1184,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1184
1184
 
1185
1185
  **Deliberately not covered**
1186
1186
 
1187
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1187
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1188
1188
 
1189
- **Measured: O(1)** (exponent -0.01, 10 sizes) -- ✅ matches.
1189
+ **Measured: O(1)** (exponent -0.01, 10 sizes): ✅ matches.
1190
1190
 
1191
1191
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1192
1192
  | --- | --- | --- | --- | --- | --- |
@@ -1220,9 +1220,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1220
1220
 
1221
1221
  **Deliberately not covered**
1222
1222
 
1223
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1223
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1224
1224
 
1225
- **Measured: O(n)** (exponent 0.71, 10 sizes) -- ✅ matches.
1225
+ **Measured: O(n)** (exponent 0.71, 10 sizes): ✅ matches.
1226
1226
 
1227
1227
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1228
1228
  | --- | --- | --- | --- | --- | --- |
@@ -1256,9 +1256,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1256
1256
 
1257
1257
  **Deliberately not covered**
1258
1258
 
1259
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1259
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1260
1260
 
1261
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
1261
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
1262
1262
 
1263
1263
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1264
1264
  | --- | --- | --- | --- | --- | --- |
@@ -1292,9 +1292,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1292
1292
 
1293
1293
  **Deliberately not covered**
1294
1294
 
1295
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1295
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1296
1296
 
1297
- **Measured: O(1)** (exponent -0.00, 10 sizes) -- ✅ matches.
1297
+ **Measured: O(1)** (exponent -0.00, 10 sizes): ✅ matches.
1298
1298
 
1299
1299
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1300
1300
  | --- | --- | --- | --- | --- | --- |
@@ -1328,9 +1328,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1328
1328
 
1329
1329
  **Deliberately not covered**
1330
1330
 
1331
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1331
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1332
1332
 
1333
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
1333
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
1334
1334
 
1335
1335
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1336
1336
  | --- | --- | --- | --- | --- | --- |
@@ -1364,9 +1364,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1364
1364
 
1365
1365
  **Deliberately not covered**
1366
1366
 
1367
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1367
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1368
1368
 
1369
- **Measured: O(1)** (exponent -0.00, 10 sizes) -- ✅ matches.
1369
+ **Measured: O(1)** (exponent -0.00, 10 sizes): ✅ matches.
1370
1370
 
1371
1371
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1372
1372
  | --- | --- | --- | --- | --- | --- |
@@ -1400,9 +1400,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1400
1400
 
1401
1401
  **Deliberately not covered**
1402
1402
 
1403
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1403
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1404
1404
 
1405
- **Measured: O(1)** (exponent -0.01, 10 sizes) -- ✅ matches.
1405
+ **Measured: O(1)** (exponent -0.01, 10 sizes): ✅ matches.
1406
1406
 
1407
1407
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1408
1408
  | --- | --- | --- | --- | --- | --- |
@@ -1436,7 +1436,7 @@ How many variables each contract declares (ten in the main sweep). With the tota
1436
1436
 
1437
1437
  **Deliberately not covered**
1438
1438
 
1439
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1439
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1440
1440
 
1441
1441
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1442
1442
  | --- | --- | --- | --- | --- | --- |
@@ -1470,9 +1470,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1470
1470
 
1471
1471
  **Deliberately not covered**
1472
1472
 
1473
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1473
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1474
1474
 
1475
- **Measured: O(1)** (exponent -0.00, 10 sizes) -- ✅ matches.
1475
+ **Measured: O(1)** (exponent -0.00, 10 sizes): ✅ matches.
1476
1476
 
1477
1477
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1478
1478
  | --- | --- | --- | --- | --- | --- |
@@ -1506,9 +1506,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1506
1506
 
1507
1507
  **Deliberately not covered**
1508
1508
 
1509
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1509
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1510
1510
 
1511
- **Measured: O(1)** (exponent -0.05, 10 sizes) -- ✅ matches.
1511
+ **Measured: O(1)** (exponent -0.05, 10 sizes): ✅ matches.
1512
1512
 
1513
1513
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1514
1514
  | --- | --- | --- | --- | --- | --- |
@@ -1542,9 +1542,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1542
1542
 
1543
1543
  **Deliberately not covered**
1544
1544
 
1545
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1545
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1546
1546
 
1547
- **Measured: O(n)** (exponent 0.82, 10 sizes) -- ✅ matches.
1547
+ **Measured: O(n)** (exponent 0.82, 10 sizes): ✅ matches.
1548
1548
 
1549
1549
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1550
1550
  | --- | --- | --- | --- | --- | --- |
@@ -1578,9 +1578,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1578
1578
 
1579
1579
  **Deliberately not covered**
1580
1580
 
1581
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1581
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1582
1582
 
1583
- **Measured: O(1)** (exponent -0.00, 10 sizes) -- ✅ matches.
1583
+ **Measured: O(1)** (exponent -0.00, 10 sizes): ✅ matches.
1584
1584
 
1585
1585
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1586
1586
  | --- | --- | --- | --- | --- | --- |
@@ -1614,9 +1614,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1614
1614
 
1615
1615
  **Deliberately not covered**
1616
1616
 
1617
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1617
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1618
1618
 
1619
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
1619
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
1620
1620
 
1621
1621
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1622
1622
  | --- | --- | --- | --- | --- | --- |
@@ -1650,9 +1650,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1650
1650
 
1651
1651
  **Deliberately not covered**
1652
1652
 
1653
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1653
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1654
1654
 
1655
- **Measured: O(1)** (exponent 0.01, 10 sizes) -- ✅ matches.
1655
+ **Measured: O(1)** (exponent 0.01, 10 sizes): ✅ matches.
1656
1656
 
1657
1657
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1658
1658
  | --- | --- | --- | --- | --- | --- |
@@ -1686,9 +1686,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1686
1686
 
1687
1687
  **Deliberately not covered**
1688
1688
 
1689
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1689
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1690
1690
 
1691
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
1691
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
1692
1692
 
1693
1693
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1694
1694
  | --- | --- | --- | --- | --- | --- |
@@ -1722,9 +1722,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1722
1722
 
1723
1723
  **Deliberately not covered**
1724
1724
 
1725
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1725
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1726
1726
 
1727
- **Measured: O(1)** (exponent -0.01, 10 sizes) -- ✅ matches.
1727
+ **Measured: O(1)** (exponent -0.01, 10 sizes): ✅ matches.
1728
1728
 
1729
1729
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1730
1730
  | --- | --- | --- | --- | --- | --- |
@@ -1758,9 +1758,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1758
1758
 
1759
1759
  **Deliberately not covered**
1760
1760
 
1761
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1761
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1762
1762
 
1763
- **Measured: O(1)** (exponent 0.00, 10 sizes) -- ✅ matches.
1763
+ **Measured: O(1)** (exponent 0.00, 10 sizes): ✅ matches.
1764
1764
 
1765
1765
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1766
1766
  | --- | --- | --- | --- | --- | --- |
@@ -1794,9 +1794,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1794
1794
 
1795
1795
  **Deliberately not covered**
1796
1796
 
1797
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1797
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1798
1798
 
1799
- **Measured: O(1)** (exponent -0.00, 10 sizes) -- ✅ matches.
1799
+ **Measured: O(1)** (exponent -0.00, 10 sizes): ✅ matches.
1800
1800
 
1801
1801
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1802
1802
  | --- | --- | --- | --- | --- | --- |
@@ -1830,9 +1830,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1830
1830
 
1831
1831
  **Deliberately not covered**
1832
1832
 
1833
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1833
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1834
1834
 
1835
- **Measured: O(n log n)** (exponent 1.32, 10 sizes) -- 🟡 close (neighbouring class).
1835
+ **Measured: O(n log n)** (exponent 1.32, 10 sizes): 🟡 close (neighbouring class).
1836
1836
 
1837
1837
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1838
1838
  | --- | --- | --- | --- | --- | --- |
@@ -1866,9 +1866,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1866
1866
 
1867
1867
  **Deliberately not covered**
1868
1868
 
1869
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1869
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1870
1870
 
1871
- **Measured: O(log n)** (exponent 0.62, 10 sizes) -- 🟡 close (neighbouring class).
1871
+ **Measured: O(log n)** (exponent 0.62, 10 sizes): 🟡 close (neighbouring class).
1872
1872
 
1873
1873
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1874
1874
  | --- | --- | --- | --- | --- | --- |
@@ -1902,9 +1902,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1902
1902
 
1903
1903
  **Deliberately not covered**
1904
1904
 
1905
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1905
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1906
1906
 
1907
- **Measured: O(1)** (exponent 0.04, 10 sizes) -- ✅ matches.
1907
+ **Measured: O(1)** (exponent 0.04, 10 sizes): ✅ matches.
1908
1908
 
1909
1909
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1910
1910
  | --- | --- | --- | --- | --- | --- |
@@ -1938,9 +1938,9 @@ How many variables each contract declares (ten in the main sweep). With the tota
1938
1938
 
1939
1939
  **Deliberately not covered**
1940
1940
 
1941
- - **locale and timezone** -- The helper's cost does not depend on the process locale or timezone for the inputs measured.
1941
+ - **locale and timezone**: The helper's cost does not depend on the process locale or timezone for the inputs measured.
1942
1942
 
1943
- **Measured: O(1)** (exponent -0.00, 10 sizes) -- ✅ matches.
1943
+ **Measured: O(1)** (exponent -0.00, 10 sizes): ✅ matches.
1944
1944
 
1945
1945
  | variables | Median | p95 | CPU (median) | Heap Δ | Ops/s |
1946
1946
  | --- | --- | --- | --- | --- | --- |
@@ -1957,7 +1957,7 @@ How many variables each contract declares (ten in the main sweep). With the tota
1957
1957
 
1958
1958
  ## 3. What makes up one end-to-end operation
1959
1959
 
1960
- Each function's measured cost is multiplied by how many times one end-to-end operation calls it. A function measured on its own includes everything it calls, so where one attributed function calls another, the nested time is subtracted from the caller (its _exclusive_ time): every moment of the operation belongs to at most one row. Shares are measured against the whole operation with the package, a figure measured directly -- not against the _added_ time, which is the small difference of two noisy medians. They are estimates (each function was measured separately); the remainder is shown as _unattributed_.
1960
+ Each function's measured cost is multiplied by how many times one end-to-end operation calls it. A function measured on its own includes everything it calls. So where one attributed function calls another, the nested time is subtracted from the caller (its _exclusive_ time). Every moment of the operation then belongs to at most one row. Shares are measured against the whole operation with the package, a figure measured directly. They are not measured against the _added_ time, which is the small difference of two noisy medians. They are estimates (each function was measured separately); the remainder is shown as _unattributed_.
1961
1961
 
1962
1962
  **At 640 variables** (whole operation: 262 µs)
1963
1963
 
@@ -1975,14 +1975,14 @@ Each function's measured cost is multiplied by how many times one end-to-end ope
1975
1975
 
1976
1976
  ## Cost model
1977
1977
 
1978
- Estimates use two bracketing price shapes: **low** = CPU-priced compute ($0.040 per vCPU-hour, billed on CPU time) and **high** = duration-and-memory-priced functions ($0.000017 per GB-second, billed on wall time, at least 128 MB reserved). Both are rounded list prices and change over time; override them in `benchmark.config.json` → `costRates` to match your platform and negotiated pricing.
1978
+ Estimates use two bracketing price shapes. **Low** is CPU-priced compute ($0.040 per vCPU-hour, billed on CPU time). **High** is duration-and-memory-priced functions ($0.000017 per GB-second, billed on wall time, at least 128 MB reserved). Both are rounded list prices and change over time; override them in `benchmark.config.json` → `costRates` to match your platform and negotiated pricing.
1979
1979
 
1980
1980
  ## Environment and method
1981
1981
 
1982
1982
  - Run: `2026-10-02T00:44:24.130Z` → `2026-10-02T00:45:43.444Z` (79 s), ci
1983
1983
  - Machine: AMD EPYC 9V45 96-Core Processor, 4 logical core(s) (2 physical), 15990 MB RAM, linux/x64, Node v22.23.3, GitHub Actions
1984
1984
  - Git: `77acd16d0d0b13e9c162061da6d6f7d739436547` on `chore/no-minify-no-dist-urls` (uncommitted changes)
1985
- - Sizes: 20, 40, 80, 160, 320, 640, 1280, 2560, 5120, 10240 variables -- One environment variable declared in a contract and validated at startup. 640 is a large but realistic service: a few dozen contracts of around ten variables each.
1985
+ - Sizes: 20, 40, 80, 160, 320, 640, 1280, 2560, 5120, 10240 variables: One environment variable declared in a contract and validated at startup. 640 is a large but realistic service: a few dozen contracts of around ten variables each.
1986
1986
 
1987
- **Do not compare these numbers with another machine's, another day's, or another package's.** They exist to show how _this_ package's cost changes between runs on comparable hardware and how it scales with size. See [READING-BENCHMARKS.md](../READING-BENCHMARKS.md).
1987
+ **Do not compare these numbers with another machine's, another day's, or another package's.** They show how _this_ package's cost changes between runs on comparable hardware, and how it scales with size. See [READING-BENCHMARKS.md](../READING-BENCHMARKS.md).
1988
1988