@photivra/engine 2.5.0 → 2.6.0

package/docs/api/output-print-plan.md

@@ -5,7 +5,11 @@ The package and root API versions are recorded once in [Navigation](../API_REFER
 ## calculatePrintPlan
 
 Finds the smallest file, at the exact native aspect ratio, that meets the declared sampling and lab constraints.
-The angular guidance is an approximate rule of thumb; the geometry itself is calculated exactly.
+The angular guidance is an approximate rule of thumb; the geometry itself is calculated exactly. A common criterion,
+one arcminute per pixel, is normal (20/20) visual acuity under optimal conditions: the minimum angle of resolution of an
+ideal eye is about 1 minute of arc, and 20/20 letters are built from elements that each subtend 1 arcmin (Z. Alomar, K. D. Bojikian, "Visual Acuity Testing in Adults", EyeWiki, American Academy of Ophthalmology,
+https://eyewiki.aao.org/Visual_Acuity_Testing_in_Adults, last edited June 16, 2026).
+Some viewers resolve finer detail and many resolve coarser, so it stays a rule of thumb, and the criterion is the caller's.
 It does not assess source detail, perceived quality, file writing or available resources.
 
 ```ts
@@ -18,6 +22,9 @@ This call is synchronous; any supplied provider must follow its explicit synchro
 
 Calculates the largest print size under the stated conditions. Lab constraints need individual plans,
 so this size query reports them as unsupported rather than ignoring them.
+As in `calculatePrintPlan`, an angular criterion is an approximate rule of thumb: one arcminute per pixel is normal
+(20/20) acuity under optimal conditions, which some viewers exceed and many do not (Z. Alomar, K. D. Bojikian, "Visual Acuity Testing in Adults", EyeWiki, American Academy of Ophthalmology,
+https://eyewiki.aao.org/Visual_Acuity_Testing_in_Adults, last edited June 16, 2026).
 
 ```ts
 export function calculatePrintSizeLimit(value: PrintSizeLimitInput): CalculationResult<PrintSizeLimit>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@photivra/engine",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "private": false,
   "description": "Scientific TypeScript engine for camera optics, exposure, focus, motion, sensor sampling, diffraction, and digital imaging calculations.",
   "type": "module",
@@ -108,7 +108,8 @@
     "typescript-eslint": "8.70.0",
     "vitest": "5.0.1",
     "@types/node": "24.13.6",
-    "@vitest/coverage-v8": "5.0.1"
+    "@vitest/coverage-v8": "5.0.1",
+    "rolldown": "1.2.9"
   },
   "keywords": [
     "photography",