@photivra/engine 1.0.1 → 1.2.0

package/docs/validation/print-detail-capabilities.json

@@ -0,0 +1,103 @@
+{
+  "ledgerVersion": "0.1.0",
+  "metricVersion": "0.1.0",
+  "protocolVersion": "0.1.0",
+  "engineCandidate": "1.1.0",
+  "humanReview": "pending",
+  "fullAssessmentAcceptance": "blocked",
+  "evidenceDomain": "owned-procedural-mathematical-reference-only",
+  "capabilities": [
+    {
+      "id": "regional-coherent-fundamental",
+      "status": "mathematically-validated",
+      "units": "relative-linear-luminance-and-dimensionless-modulation",
+      "reference": "finite-orthogonality-and-owned-discrete-convolution",
+      "test": "test/print-detail.test.ts",
+      "targetVersion": "analytic-sinusoid-0.1.0",
+      "backend": "repository-node-mathematics",
+      "acquisitionQualification": "unassessed",
+      "humanReview": "pending",
+      "actualBackendQualification": "unassessed"
+    },
+    {
+      "id": "print-region-angular-projection",
+      "status": "mathematically-validated",
+      "units": "mm-cycles-per-mm-and-reference-period-degrees",
+      "reference": "staged-capture-geometry-and-centered-period-angle",
+      "test": "test/print-detail.test.ts",
+      "acquisitionQualification": "unassessed",
+      "humanReview": "pending",
+      "actualBackendQualification": "unassessed"
+    },
+    {
+      "id": "captured-system-mtf-and-field-detail",
+      "status": "blocked",
+      "reason": "actual-target-acquisition-processing-registration-and-backend-evidence-required"
+    },
+    {
+      "id": "noise-tonal-clipping",
+      "status": "blocked",
+      "reason": "linear-source-ensemble-and-stage-qualified-protocol-required"
+    },
+    {
+      "id": "depth-occlusion-and-intentional-defocus",
+      "status": "blocked",
+      "reason": "visible-surface-depth-and-coordinate-registration-evidence-required"
+    },
+    {
+      "id": "directional-motion-attribution",
+      "status": "blocked",
+      "reason": "trajectory-and-temporal-accumulation-evidence-required"
+    },
+    {
+      "id": "aliasing-halos-compression-color",
+      "status": "blocked",
+      "reason": "independent-dimension-and-exact-source-stage-protocols-required"
+    },
+    {
+      "id": "perceived-quality-or-visibility",
+      "status": "blocked",
+      "reason": "qualified-perception-model-and-observer-luminance-contrast-domain-required"
+    },
+    {
+      "id": "printer-substrate-icc",
+      "status": "out-of-scope",
+      "reason": "separate-reviewed-contract-required"
+    },
+    {
+      "id": "overall-print-pass",
+      "status": "not-offered",
+      "reason": "no-universal-quality-score-or-verdict"
+    }
+  ],
+  "validation": {
+    "status": "passed-mathematical-domain-only",
+    "runtime": "v24.19.0",
+    "fullSuite": {
+      "files": 144,
+      "tests": 1701
+    },
+    "focusedTests": 48,
+    "sourceFilesSha256": {
+      "src/output/print-detail.ts": "1bf1c6032fabd944806eddad79c560c266bd7776b48b3c0964056c9da451be81",
+      "test/print-detail.test.ts": "c73b49bb6b3e1943ed7d0d3bfc443830ccab73aa0f34e88733293a555a58ce38",
+      "docs/PRINT_DETAIL_ASSESSMENT.md": "c0b7277f27a64d4b91205cc89161cb4e575229599ec4f4670631689592f101b5",
+      "docs/PRINT_DETAIL_VALIDATION.md": "6fdbaafd75a18608554702df8123c272d822a022239bcfce3881540503447fcb"
+    },
+    "numericTolerance": {
+      "absolute": 1e-10,
+      "domain": "owned-bounded-analytic-coefficients-and-relative-residuals"
+    },
+    "actualBackendQualification": "unassessed",
+    "acquiredSourceArtifact": "not-supplied",
+    "roi": "explicit-half-open-oriented-retained-region",
+    "sourceStages": [
+      "native-retained-linear",
+      "post-resampling-linear",
+      "post-encoding-decoded-linear"
+    ]
+  },
+  "recordScope": "historical mathematical-only qualification snapshot; retained values and source hashes describe that snapshot, not current candidate",
+  "supersededBy": "print-196-candidate-capabilities.json",
+  "currentEvidenceInventory": "print-196-candidate-evidence.json"
+}

package/docs/validation/print-detail-jpeg-evidence.json

@@ -0,0 +1,116 @@
+{
+  "evidenceVersion": "0.1.0",
+  "metricVersion": "0.1.0",
+  "engineCandidate": "1.1.0",
+  "parentCommit": "12f304f087d5cbe41266e2a81be2d6a1d521e692",
+  "humanReview": "pending",
+  "fullAssessmentAcceptance": "blocked",
+  "capability": "bounded-neutral-paired-export-jpeg-regional-diagnostic",
+  "status": "passed-bounded-paired-export-jpeg-execution-only",
+  "sourceQualification": "owned-post-adc-code-target-not-physical-acquisition",
+  "backend": "public-paired-export-plus-recorded-independent-Pillow-readback",
+  "decoder": {
+    "Pillow": "12.3.0",
+    "libjpegApiVersion": "6.2",
+    "libjpegTurboVersion": "3.1.4.1",
+    "Python": "3.12.14"
+  },
+  "nodeCI": "regenerates-exact-JPEG-bytes-and-consumes-committed-independent-decode; does-not-execute-Pillow",
+  "runtime": "v24.19.0",
+  "focusedTests": 13,
+  "sourceFilesSha256": {
+    "test/helpers/print-detail-jpeg-fixture.ts": "a1294537251c4feba4ae2c462a040730778fb7e776258d8d2cbc66c501a68b82",
+    "test/print-detail-jpeg-integration.test.ts": "b9c946560a2ae5e39a30c88cbea2b4422b4712b02e98f0a8ee0133102d847a34",
+    "scripts/generate-print-detail-jpeg.ts": "eb112d5259e558826691737770b08819b2128782f6a3434393416c90d12871aa",
+    "scripts/generate-print-detail-jpeg.mjs": "c4eeb2c124ec082c4007eeebc74e74c17a42c9225bf944596bd95777a886aa8c",
+    "scripts/tsconfig.print-jpeg.json": "116c879efe79b8b870bfa407ba3bcdffaefb37ab33755c436a7c3eca77260fcd",
+    "scripts/verify-print-detail-jpeg.py": "38afb7daf89859e5e68fe38850a12a0c1899a891dc9fe4acb296c5d6acd65927",
+    "src/capture/photographic-export.ts": "3c0ea2bfd5081447c42e6ffa6f0c9d0f2ea63b0bf170580f4ff739b594d1088e",
+    "src/capture/export-jpeg.ts": "04228e0ee48a07ce04f5d1fbc4836825a384932c5c9c25a96d432e3971a0c866",
+    "src/capture/raw-frame-reconstruction.ts": "de0734375b00dbb375e98dd9aabae88d36f1cec1adfc3812949ff1c27fd13a3d",
+    "src/color/sensor-color-development.ts": "a7b315b44c6b61942a0818ab1b5ea9d2232b720f83339a2307052d222b914897",
+    "src/output/sdr-rendering.ts": "38abc70438d3abf7a05cb50a2fe5a688d04f94b843fff4ba4d4cea760d0d1f47",
+    "src/output/print-detail.ts": "1bf1c6032fabd944806eddad79c560c266bd7776b48b3c0964056c9da451be81",
+    "docs/PRINT_DETAIL_JPEG_EVIDENCE.md": "d6f9bd340011f063d7e9d2de26073fbb02015ebe8878274c355dbf157035c6f9",
+    "test/fixtures/print-detail/jpeg/export-manifest.json": "2ab550758af1217cec245b22104f2f157fc1b5b98023e11b983cd8b51b6f99cc",
+    "test/fixtures/print-detail/jpeg/independent-reference.json": "fbde5ef5cb776cf41e199553961cf174caec2a7fb768dad0743722e21e8f9571",
+    "test/fixtures/print-detail/jpeg/landscape-inverted-q1.jpg": "6facaed0b2346ad2d1bb7836edb2243954a2590f4c245c524da9b5fd483dee1c",
+    "test/fixtures/print-detail/jpeg/landscape-inverted-q32.jpg": "17304b75010277d30aac7df86bef8b9a87d7c0ad709fe7f8cd81f66c0e43a3b3",
+    "test/fixtures/print-detail/jpeg/landscape-q1.jpg": "10675e622d2ff5e5a389d90205eeaf94c9c41b546d138457900b1acd215570d7",
+    "test/fixtures/print-detail/jpeg/landscape-q32.jpg": "7fa1a655a8278b0da95c0c03201dba8a3d7d2c1bca4a1e199ec1def205eaafe9",
+    "test/fixtures/print-detail/jpeg/portrait-clockwise-q1.jpg": "6505e7e1fdcd33801cffebbfcde24de4dcc15f7972279198f6c73b9649060de7",
+    "test/fixtures/print-detail/jpeg/portrait-clockwise-q32.jpg": "fed3a716eb5c5ace307b571fbc78cfdc0ca7fdc4055c3e1c8c7fe7fcded01b8a",
+    "test/fixtures/print-detail/jpeg/portrait-counter-clockwise-q1.jpg": "7f1aa1dfc9f0ba1ecec8db2f22b15c9b1362f3d00b28aa082e440d47dfe5f887",
+    "test/fixtures/print-detail/jpeg/portrait-counter-clockwise-q32.jpg": "38af5cfadb9b88c38c2072963f529db24a4672edf92d60e64b80d86dcefa8889"
+  },
+  "envelope": {
+    "nativeRaster": [
+      20,
+      16
+    ],
+    "orientations": 4,
+    "quantizationSteps": [
+      1,
+      32
+    ],
+    "subsampling": "444",
+    "roiOrigin": [
+      2,
+      2
+    ],
+    "roiLandscape": [
+      16,
+      8
+    ],
+    "roiPortrait": [
+      8,
+      16
+    ],
+    "source": "neutral-post-ADC-two-sample-held-quarter-grating",
+    "decoderPolicy": "RGB-neutral-only-sRGB-inverse-transfer",
+    "referenceModulation": ".5*cos(pi/8)",
+    "sourceMean": "384/959",
+    "sampleToleranceAbsolute": 1e-12,
+    "measurementToleranceAbsolute": 1e-10,
+    "pixelAndArtifactIdentity": "exact-bytes-and-sha256"
+  },
+  "unqualified": [
+    "human-scientific-source-review",
+    "optical-source-acquisition-and-calibration",
+    "actual-UI-GPU-and-device",
+    "native-resolution-production",
+    "warp-resampling",
+    "colored-luminance-and-ICC",
+    "other-codecs-and-decoder-variants",
+    "captured-system-MTF",
+    "depth-and-occlusion",
+    "noise-aliasing-halos-compression-quality-metrics",
+    "observer-perception",
+    "printer-substrate"
+  ],
+  "fullSuite": {
+    "files": 146,
+    "tests": 1723
+  },
+  "coverage": {
+    "lines": 91.84,
+    "statements": 91.87,
+    "functions": 99.62,
+    "branches": 88.27
+  },
+  "independentChecks": [
+    "Pillow-exact-JPEG-decode",
+    "neutral-source-preencode-and-registration-truth",
+    "source-fundamental-identity",
+    "Python-independent-decoded-coefficients",
+    "separate-directory-byte-for-byte-reproduction"
+  ],
+  "localReleaseGates": [
+    "check",
+    "coverage",
+    "build",
+    "pack:check",
+    "docs:check",
+    "release:consumer-check"
+  ]
+}

package/docs/validation/print-detail-sdr-evidence.json

@@ -0,0 +1,81 @@
+{
+  "evidenceVersion": "0.1.0",
+  "metricVersion": "0.1.0",
+  "engineCandidate": "1.1.0",
+  "parentCommit": "cfa179f054cdda92edd77dd51f98473cd6923b0c",
+  "humanReview": "pending",
+  "fullAssessmentAcceptance": "blocked",
+  "capability": "bounded-neutral-capture-sdr-regional-diagnostic-integration",
+  "status": "passed-bounded-execution-only",
+  "sourceQualification": "owned-committed-procedural-target-only",
+  "backend": "repository-node-capture-sdr-adapter-and-test-only-code-readback",
+  "referenceBackend": "Python 3.12.14 standard library; independent three-level identities",
+  "runtime": "v24.19.0",
+  "focusedTests": 9,
+  "sourceFilesSha256": {
+    "test/print-detail-sdr-integration.test.ts": "130160c9aa6b720030b49581a95c3d565e91a0aff99fa615123920fa1b7843f4",
+    "test/fixtures/print-detail/quarter-grating.json": "0270a44168e574157067615c957a199355ac600be7a536663ab4769f59f860b9",
+    "test/fixtures/print-detail/sdr-reference.json": "b65f1a8c2ce0b8f3b799946a0ec94110fe9623c6348d156e31d6e41729208c30",
+    "test/fixtures/print-detail/generate_reference.py": "75571a248d1ff091017546547179de4087e49391d8318f290ff301703c2f8e37",
+    "src/capture/simulated-capture.ts": "5777dd52b91aad794a8a8b03abea834218b96e845328e1ceae67fd6903fab52d",
+    "src/output/capture-sdr.ts": "ab3856286d670fef117a5925a78a7de5bf58f75349f2c2076c93597b6c10162c",
+    "src/output/sdr-rendering.ts": "38abc70438d3abf7a05cb50a2fe5a688d04f94b843fff4ba4d4cea760d0d1f47",
+    "src/output/print-detail.ts": "1bf1c6032fabd944806eddad79c560c266bd7776b48b3c0964056c9da451be81",
+    "docs/PRINT_DETAIL_SDR_EVIDENCE.md": "c95a7529b5864a81c3caed7041e0a4a27dd769bbadfa1eb3b97b03762a9525ea"
+  },
+  "envelope": {
+    "nativeRaster": [
+      16,
+      12
+    ],
+    "orientations": 4,
+    "bitDepths": [
+      8,
+      16
+    ],
+    "roi": {
+      "x": 2,
+      "y": 2,
+      "width": 8,
+      "height": 8
+    },
+    "tone": "identity",
+    "renderingExposureEv": 0,
+    "gamut": "reject-out-of-range",
+    "targetModulation": 0.5,
+    "absoluteDecodedAndCoefficientTolerance": 1e-12,
+    "artifactIdentity": "exact-source-json-rgb-float64-le-and-code-uint16-le-sha256"
+  },
+  "unqualified": [
+    "human-scientific-source-review",
+    "actual-ui-renderer-and-device",
+    "RAW-environment-acquisition",
+    "native-resolution-production",
+    "warp-resampling",
+    "color-transform-and-nonneutral-luminance",
+    "JPEG-and-other-file-codecs",
+    "capture-system-MTF",
+    "depth-and-occlusion",
+    "noise-clipping-and-artifact-metrics",
+    "perceived-quality",
+    "printer-substrate"
+  ],
+  "fullSuite": {
+    "files": 145,
+    "tests": 1710
+  },
+  "localReleaseGates": [
+    "check",
+    "coverage",
+    "build",
+    "pack:check",
+    "docs:check",
+    "release:consumer-check"
+  ],
+  "coverage": {
+    "lines": 91.84,
+    "statements": 91.87,
+    "functions": 99.62,
+    "branches": 88.27
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@photivra/engine",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "private": false,
   "description": "Scientific TypeScript engine for camera optics, exposure, focus, motion, sensor sampling, diffraction, and digital imaging calculations.",
   "type": "module",