@photivra/engine 0.6.0 → 1.0.0

package/dist/optics/aperture.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Module boundary and integration notes.
+ * Calculates ideal regular-polygon aperture geometry and the corresponding straight-edge
+ * diffraction-ray directions. This models only geometry/symmetry. It does not calculate diffraction
+ * intensity, wavelength-dependent star length, blade curvature, lens aberrations, coatings, or sensor
+ * blooming.
+ * @see docs/PHYSICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
 import { type CalculationResult } from "../core/calculation-result.js";
 export interface CalculateIdealApertureInput {
     /** Number of straight diaphragm blades/sides. Must be from 3 through 1024. */

package/dist/optics/aperture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aperture.d.ts","sourceRoot":"","sources":["../../src/optics/aperture.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAQvC,MAAM,WAAW,2BAA2B;IAC1C,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,kDAAkD;IAClD,kBAAkB,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAOD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,2BAA2B,GACjC,iBAAiB,CAAC,qBAAqB,CAAC,CAoE1C"}
+{"version":3,"file":"aperture.d.ts","sourceRoot":"","sources":["../../src/optics/aperture.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAQvC,MAAM,WAAW,2BAA2B;IAC1C,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,kDAAkD;IAClD,kBAAkB,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAOD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,2BAA2B,GACjC,iBAAiB,CAAC,qBAAqB,CAAC,CAoE1C"}

package/dist/optics/aperture.js

@@ -1,4 +1,13 @@
 // SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Calculates ideal regular-polygon aperture geometry and the corresponding straight-edge
+ * diffraction-ray directions. This models only geometry/symmetry. It does not calculate diffraction
+ * intensity, wavelength-dependent star length, blade curvature, lens aberrations, coatings, or sensor
+ * blooming.
+ * @see docs/PHYSICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
 import { calculatedResult } from "../core/calculation-result.js";
 import { InvalidScientificInputError, requirePositiveInteger } from "../core/validation.js";
 const MAX_IDEAL_APERTURE_BLADES = 1024;

package/dist/optics/aperture.js.map

@@ -1 +1 @@
-{"version":3,"file":"aperture.js","sourceRoot":"","sources":["../../src/optics/aperture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aperture.js","sourceRoot":"","sources":["../../src/optics/aperture.ts"],"names":[],"mappings":"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"}

package/dist/optics/circle-of-confusion.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Module boundary and integration notes.
+ * Estimates a circle-of-confusion criterion for equivalent final viewing by scaling a caller-supplied
+ * reference criterion in proportion to sensor diagonal. This is a viewing/acceptability convention,
+ * not a physical blur threshold.
+ * @see docs/PHYSICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
 import { type CalculationResult } from "../core/calculation-result.js";
 export interface EstimateEquivalentViewingCircleOfConfusionInput {
     sensorWidthMm: number;

package/dist/optics/circle-of-confusion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"circle-of-confusion.d.ts","sourceRoot":"","sources":["../../src/optics/circle-of-confusion.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,+CAA+C;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,4BAA4B,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,+CAA+C,GACrD,iBAAiB,CAAC,kCAAkC,CAAC,CA2CvD"}
+{"version":3,"file":"circle-of-confusion.d.ts","sourceRoot":"","sources":["../../src/optics/circle-of-confusion.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,+CAA+C;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,4BAA4B,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,+CAA+C,GACrD,iBAAiB,CAAC,kCAAkC,CAAC,CA2CvD"}

package/dist/optics/circle-of-confusion.js

@@ -1,4 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Estimates a circle-of-confusion criterion for equivalent final viewing by scaling a caller-supplied
+ * reference criterion in proportion to sensor diagonal. This is a viewing/acceptability convention,
+ * not a physical blur threshold.
+ * @see docs/PHYSICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
 import { approximationResult } from "../core/calculation-result.js";
 import { requirePositiveFinite } from "../core/validation.js";
 /**

package/dist/optics/circle-of-confusion.js.map

@@ -1 +1 @@
-{"version":3,"file":"circle-of-confusion.js","sourceRoot":"","sources":["../../src/optics/circle-of-confusion.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,mBAAmB,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAiB9D;;;;;;GAMG;AACH,MAAM,UAAU,0CAA0C,CACxD,KAAsD;IAEtD,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5D,qBAAqB,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9D,qBAAqB,CACnB,wBAAwB,EACxB,KAAK,CAAC,sBAAsB,CAC7B,CAAC;IACF,qBAAqB,CACnB,yBAAyB,EACzB,KAAK,CAAC,uBAAuB,CAC9B,CAAC;IACF,qBAAqB,CACnB,8BAA8B,EAC9B,KAAK,CAAC,4BAA4B,CACnC,CAAC;IAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CACjC,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,cAAc,CACrB,CAAC;IACF,MAAM,yBAAyB,GAAG,IAAI,CAAC,KAAK,CAC1C,KAAK,CAAC,sBAAsB,EAC5B,KAAK,CAAC,uBAAuB,CAC9B,CAAC;IACF,MAAM,WAAW,GAAG,gBAAgB,GAAG,yBAAyB,CAAC;IAEjE,OAAO,mBAAmB,CACxB;QACE,mBAAmB,EACjB,KAAK,CAAC,4BAA4B,GAAG,WAAW;QAClD,gBAAgB;QAChB,yBAAyB;QACzB,WAAW;KACZ,EACD,wCAAwC,EACxC,OAAO,EACP;QACE,iFAAiF;QACjF,wEAAwE;QACxE,qEAAqE;QACrE,yEAAyE;KAC1E,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"circle-of-confusion.js","sourceRoot":"","sources":["../../src/optics/circle-of-confusion.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;GAOG;AAEH,OAAO,EACL,mBAAmB,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAiB9D;;;;;;GAMG;AACH,MAAM,UAAU,0CAA0C,CACxD,KAAsD;IAEtD,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5D,qBAAqB,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9D,qBAAqB,CACnB,wBAAwB,EACxB,KAAK,CAAC,sBAAsB,CAC7B,CAAC;IACF,qBAAqB,CACnB,yBAAyB,EACzB,KAAK,CAAC,uBAAuB,CAC9B,CAAC;IACF,qBAAqB,CACnB,8BAA8B,EAC9B,KAAK,CAAC,4BAA4B,CACnC,CAAC;IAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CACjC,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,cAAc,CACrB,CAAC;IACF,MAAM,yBAAyB,GAAG,IAAI,CAAC,KAAK,CAC1C,KAAK,CAAC,sBAAsB,EAC5B,KAAK,CAAC,uBAAuB,CAC9B,CAAC;IACF,MAAM,WAAW,GAAG,gBAAgB,GAAG,yBAAyB,CAAC;IAEjE,OAAO,mBAAmB,CACxB;QACE,mBAAmB,EACjB,KAAK,CAAC,4BAA4B,GAAG,WAAW;QAClD,gBAAgB;QAChB,yBAAyB;QACzB,WAAW;KACZ,EACD,wCAAwC,EACxC,OAAO,EACP;QACE,iFAAiF;QACjF,wEAAwE;QACxE,qEAAqE;QACrE,yEAAyE;KAC1E,CACF,CAAC;AACJ,CAAC"}

package/dist/optics/complex-pupil-psf.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Module boundary and integration notes.
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary. Complex pupil
+ * evaluation sums declared amplitude and phase on a bounded regular pupil grid. PSF shape is
+ * normalized separately from pupil throughput; coherent phase, pupil energy and spectral/field
+ * applicability cannot be replaced by a scalar blur radius. Numeric profiles require owned or
+ * reusable-data provenance.
+ * Evaluate a declared complex pupil with explicit amplitude/phase and sampling support; normalize PSF
+ * shape and retain pupil throughput as a separate quantity. Complex pupil evaluation sums declared
+ * amplitude and phase on a bounded regular pupil grid. PSF shape is normalized separately from pupil
+ * throughput; coherent phase, pupil energy and spectral/field applicability cannot be replaced by a
+ * scalar blur radius. Numeric profiles require owned or reusable-data provenance.
+ * @see docs/PSF_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import { type FocusPlane } from "./focus-state.js";
+import type { LensPsfKernel, LensPsfScientificStatus, LensPsfUncertainty } from "./lens-psf-profile.js";
+export declare const LENS_COMPLEX_PUPIL_PROFILE_SCHEMA_VERSION: "0.1.0";
+export interface LensComplexPupilGrid {
+    widthSamples: number;
+    heightSamples: number;
+    pupilSamplePitchMmX: number;
+    pupilSamplePitchMmY: number;
+    centerSampleX: number;
+    centerSampleY: number;
+    relativeAmplitude: readonly number[];
+    opticalPathDifferenceMicrometers: readonly number[];
+}
+export interface LensComplexPupilProfile {
+    schemaVersion: typeof LENS_COMPLEX_PUPIL_PROFILE_SCHEMA_VERSION;
+    profileId: string;
+    profileVersion: string;
+    scientificStatus: LensPsfScientificStatus;
+    opticalDomain: "lens-primary-optical-path-only";
+    representation: "complex-pupil-amplitude-plus-opd";
+    pupilCoordinateSystem: "pupil-plane-metric-aligned-to-image-plane";
+    imageFieldAxes: "+X right, +Y up";
+    amplitudeMeaning: "relative-complex-pupil-amplitude-shape";
+    wavefrontMeaning: "optical-path-difference-micrometers";
+    throughputOwnership: "separate-relative-pupil-throughput-factor";
+    kernelEnergyNormalization: "unit-energy-shape";
+    propagationModel: "scalar-fraunhofer-discrete-reference";
+    context: {
+        focalLengthMm: number;
+        focus: FocusPlane;
+        apertureFNumber: number;
+        fieldPointMm: {
+            x: number;
+            y: number;
+        };
+        wavelengthNm: number;
+        signedDefocusImagePlaneMicrometers: number;
+    };
+    responseIncludes: {
+        diffraction: true;
+        aberration: boolean;
+        defocus: boolean;
+        pupilClippingShape: boolean;
+    };
+    relativePupilThroughputFactor: number;
+    grid: LensComplexPupilGrid;
+    sensorOpticalStackIncluded: false;
+    sensorSamplingIncluded: false;
+    reconstructionIncluded: false;
+    strayLightIncluded: false;
+    evidence: readonly EvidenceProvenance[];
+    uncertainty: LensPsfUncertainty;
+    limitations: readonly string[];
+}
+export interface CalculateLensComplexPupilPsfInput {
+    profile: LensComplexPupilProfile;
+}
+export interface LensComplexPupilPsf {
+    profileId: string;
+    profileVersion: string;
+    scientificStatus: LensPsfScientificStatus;
+    context: LensComplexPupilProfile["context"];
+    kernel: LensPsfKernel;
+    relativePupilThroughputFactor: number;
+    throughputOwnership: "separate-relative-pupil-throughput-factor";
+    diffractionAndAberrationJointlyEvaluated: true;
+    pupilClippingShapeIncluded: boolean;
+    pupilClippingThroughputAppliedToKernel: false;
+    scalarFraunhoferReference: true;
+    full2dOrientationPreserved: true;
+    geometricDistortionModified: false;
+    lateralChromaticPositionShiftApplied: false;
+    sensorOpticalStackIncluded: false;
+    sensorSamplingIncluded: false;
+    reconstructionIncluded: false;
+    strayLightIncluded: false;
+    scalarSharpnessScoreProduced: false;
+    componentEvidence: {
+        pupilProfile: readonly EvidenceProvenance[];
+    };
+    uncertainty: LensPsfUncertainty;
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Complex pupil evaluation sums declared amplitude and phase on a bounded regular pupil grid. PSF
+ * shape is normalized separately from pupil throughput; coherent phase, pupil energy and
+ * spectral/field applicability cannot be replaced by a scalar blur radius. Numeric profiles require
+ * owned or reusable-data provenance.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns LensComplexPupilProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function parseLensComplexPupilProfile(value: unknown): LensComplexPupilProfile;
+/**
+ * Evaluate a declared complex pupil with explicit amplitude/phase and sampling support; normalize PSF
+ * shape and retain pupil throughput as a separate quantity.
+ *
+ * Complex pupil evaluation sums declared amplitude and phase on a bounded regular pupil grid. PSF
+ * shape is normalized separately from pupil throughput; coherent phase, pupil energy and
+ * spectral/field applicability cannot be replaced by a scalar blur radius. Numeric profiles require
+ * owned or reusable-data provenance.
+ * @param input - CalculateLensComplexPupilPsfInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<LensComplexPupilPsf>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function calculateLensComplexPupilPsf(input: CalculateLensComplexPupilPsfInput): CalculationResult<LensComplexPupilPsf>;
+//# sourceMappingURL=complex-pupil-psf.d.ts.map

package/dist/optics/complex-pupil-psf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex-pupil-psf.d.ts","sourceRoot":"","sources":["../../src/optics/complex-pupil-psf.ts"],"names":[],"mappings":"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"}