@photivra/engine 0.6.0 → 1.0.0

package/dist/optics/focus-breathing.js

@@ -1,4 +1,17 @@
 // SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Applies a caller-declared focus-breathing projection scale to the ideal Gaussian thin-lens
+ * projection for one focus state. Photivra does not infer the scale from focal length, focus distance,
+ * lens identity, or marketing data. A value of 1 exactly preserves the current thin-lens projection.
+ * This is a generic approximation of focus-dependent projection/magnification, not a calibrated
+ * real-lens model. The physical focal length remains authoritative and unchanged.
+ * Calculates one-axis field of view for the generic declared-scale focus- breathing projection and
+ * reports the corresponding ideal thin-lens FOV. A breathingProjectionScale of 1 reproduces the
+ * current focus-aware thin-lens field-of-view result exactly.
+ * @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";
 import { calculateThinLensImageDistance } from "./thin-lens.js";

package/dist/optics/focus-breathing.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus-breathing.js","sourceRoot":"","sources":["../../src/optics/focus-breathing.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,mBAAmB,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAyDhE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iCAAiC,CAC/C,KAA6C;IAE7C,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5D,qBAAqB,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9D,qBAAqB,CACnB,0BAA0B,EAC1B,KAAK,CAAC,wBAAwB,CAC/B,CAAC;IAEF,MAAM,QAAQ,GAAG,8BAA8B,CAAC;QAC9C,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,eAAe,EAAE,KAAK,CAAC,cAAc;KACtC,CAAC,CAAC;IACH,MAAM,yBAAyB,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC;IACjE,MAAM,6BAA6B,GACjC,yBAAyB,GAAG,KAAK,CAAC,wBAAwB,CAAC;IAC7D,MAAM,gBAAgB,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;IAErD,OAAO,mBAAmB,CACxB;QACE,qBAAqB,EAAE,KAAK,CAAC,aAAa;QAC1C,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,yBAAyB;QACzB,6BAA6B;QAC7B,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;QACxD,kBAAkB,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;QAChD,sBAAsB,EACpB,6BAA6B,GAAG,gBAAgB;KACnD,EACD,2CAA2C,EAC3C,OAAO,EACP;QACE,gGAAgG;QAChG,+FAA+F;QAC/F,iEAAiE;QACjE,2DAA2D;QAC3D,2JAA2J;KAC5J,CACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAA8C;IAE9C,qBAAqB,CAAC,mBAAmB,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAEpE,MAAM,UAAU,GAAG,iCAAiC,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,YAAY,GAChB,CAAC;QACD,IAAI,CAAC,IAAI,CACP,KAAK,CAAC,iBAAiB;YACrB,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,yBAAyB,CAAC,CACnD,CAAC;IACJ,MAAM,gBAAgB,GACpB,CAAC;QACD,IAAI,CAAC,IAAI,CACP,KAAK,CAAC,iBAAiB;YACrB,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,6BAA6B,CAAC,CACvD,CAAC;IACJ,MAAM,YAAY,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IACpD,MAAM,gBAAgB,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAE5D,OAAO,mBAAmB,CACxB;QACE,qBAAqB,EAAE,KAAK,CAAC,aAAa;QAC1C,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;QACxD,yBAAyB,EACvB,UAAU,CAAC,KAAK,CAAC,yBAAyB;QAC5C,6BAA6B,EAC3B,UAAU,CAAC,KAAK,CAAC,6BAA6B;QAChD,YAAY;QACZ,gBAAgB;QAChB,YAAY,EAAE,gBAAgB,GAAG,YAAY;KAC9C,EACD,8CAA8C,EAC9C,OAAO,EACP;QACE,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5C,sHAAsH;KACvH,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"focus-breathing.js","sourceRoot":"","sources":["../../src/optics/focus-breathing.ts"],"names":[],"mappings":"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"}

package/dist/optics/focus-state.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Module boundary and integration notes.
+ * Parses an explicit focus-plane state from an untrusted JSON boundary. Missing/unknown focus is
+ * rejected rather than being interpreted as infinity.
+ * Calculates the ideal image-plane distance for an explicit focus state. Finite focus delegates to the
+ * existing Gaussian thin-lens calculation, so its numerical result and provenance are unchanged.
+ * Infinity focus resolves exactly to the nominal focal length with zero limiting magnification.
+ * @see docs/PHYSICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type ThinLensImageDistance } from "./thin-lens.js";
+/**
+ * Explicit ideal focus-plane state.
+ *
+ * Finite distance is the longitudinal object-plane distance from the ideal
+ * lens principal plane along the camera optical axis. Infinity is a semantic
+ * state and is never represented with JavaScript Infinity or a fabricated
+ * large distance.
+ */
+export type FocusPlane = {
+    kind: "finite";
+    distanceM: number;
+} | {
+    kind: "infinity";
+};
+export interface CalculateFocusPlaneImageDistanceInput {
+    /** Lens focal length in millimetres. */
+    focalLengthMm: number;
+    /** Explicit finite or infinity focus-plane state. */
+    focus: FocusPlane;
+}
+/**
+ * Parses an explicit focus-plane state from an untrusted JSON boundary.
+ *
+ * Missing/unknown focus is rejected rather than being interpreted as infinity.
+ */
+export declare function parseFocusPlane(value: unknown): FocusPlane;
+/**
+ * Calculates the ideal image-plane distance for an explicit focus state.
+ *
+ * Finite focus delegates to the existing Gaussian thin-lens calculation, so
+ * its numerical result and provenance are unchanged. Infinity focus resolves
+ * exactly to the nominal focal length with zero limiting magnification.
+ */
+export declare function calculateFocusPlaneImageDistance(input: CalculateFocusPlaneImageDistanceInput): CalculationResult<ThinLensImageDistance>;
+//# sourceMappingURL=focus-state.d.ts.map

package/dist/optics/focus-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-state.d.ts","sourceRoot":"","sources":["../../src/optics/focus-state.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEN,MAAM,WAAW,qCAAqC;IACpD,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,KAAK,EAAE,UAAU,CAAC;CACnB;AAeD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAiC1D;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,GAC3C,iBAAiB,CAAC,qBAAqB,CAAC,CA0B1C"}

package/dist/optics/focus-state.js

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses an explicit focus-plane state from an untrusted JSON boundary. Missing/unknown focus is
+ * rejected rather than being interpreted as infinity.
+ * Calculates the ideal image-plane distance for an explicit focus state. Finite focus delegates to the
+ * existing Gaussian thin-lens calculation, so its numerical result and provenance are unchanged.
+ * Infinity focus resolves exactly to the nominal focal length with zero limiting magnification.
+ * @see docs/PHYSICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { calculatedResult } from "../core/calculation-result.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { requirePositiveFinite } from "../core/validation.js";
+import { calculateThinLensImageDistance } from "./thin-lens.js";
+function requireRecord(value, path) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an object.");
+    }
+    return value;
+}
+/**
+ * Parses an explicit focus-plane state from an untrusted JSON boundary.
+ *
+ * Missing/unknown focus is rejected rather than being interpreted as infinity.
+ */
+export function parseFocusPlane(value) {
+    const record = requireRecord(value, "focusPlane");
+    if (record.kind === "infinity") {
+        if (record.distanceM !== undefined) {
+            throw new InvalidConfigurationError("focusPlane infinity state must not include distanceM.");
+        }
+        return {
+            kind: "infinity"
+        };
+    }
+    if (record.kind === "finite") {
+        if (typeof record.distanceM !== "number" ||
+            !Number.isFinite(record.distanceM) ||
+            record.distanceM <= 0) {
+            throw new InvalidConfigurationError("focusPlane.distanceM must be a finite number greater than zero.");
+        }
+        return {
+            kind: "finite",
+            distanceM: record.distanceM
+        };
+    }
+    throw new InvalidConfigurationError('focusPlane.kind must be "finite" or "infinity".');
+}
+/**
+ * Calculates the ideal image-plane distance for an explicit focus state.
+ *
+ * Finite focus delegates to the existing Gaussian thin-lens calculation, so
+ * its numerical result and provenance are unchanged. Infinity focus resolves
+ * exactly to the nominal focal length with zero limiting magnification.
+ */
+export function calculateFocusPlaneImageDistance(input) {
+    requirePositiveFinite("focalLengthMm", input.focalLengthMm);
+    const focus = parseFocusPlane(input.focus);
+    if (focus.kind === "finite") {
+        return calculateThinLensImageDistance({
+            focalLengthMm: input.focalLengthMm,
+            objectDistanceM: focus.distanceM
+        });
+    }
+    return calculatedResult({
+        imageDistanceMm: input.focalLengthMm,
+        magnification: 0,
+        infinityProjectionScale: 1
+    }, "ideal-infinity-focus-image-distance", "1.0.0", [
+        "Paraxial ideal-lens infinity-focus boundary",
+        "Image distance equals nominal focal length at optical infinity",
+        "Infinity is represented semantically rather than by a non-finite or fabricated distance"
+    ]);
+}
+//# sourceMappingURL=focus-state.js.map

package/dist/optics/focus-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-state.js","sourceRoot":"","sources":["../../src/optics/focus-state.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;GASG;AAEH,OAAO,EACL,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,8BAA8B,EAE/B,MAAM,gBAAgB,CAAC;AA0BxB,SAAS,aAAa,CAAC,KAAc,EAAE,IAAY;IACjD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qBAAqB,CAC7B,CAAC;IACJ,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAElD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,yBAAyB,CACjC,uDAAuD,CACxD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,UAAU;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IACE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;YAClC,MAAM,CAAC,SAAS,IAAI,CAAC,EACrB,CAAC;YACD,MAAM,IAAI,yBAAyB,CACjC,iEAAiE,CAClE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,yBAAyB,CACjC,iDAAiD,CAClD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAA4C;IAE5C,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,8BAA8B,CAAC;YACpC,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,eAAe,EAAE,KAAK,CAAC,SAAS;SACjC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,gBAAgB,CACrB;QACE,eAAe,EAAE,KAAK,CAAC,aAAa;QACpC,aAAa,EAAE,CAAC;QAChB,uBAAuB,EAAE,CAAC;KAC3B,EACD,qCAAqC,EACrC,OAAO,EACP;QACE,6CAA6C;QAC7C,gEAAgE;QAChE,yFAAyF;KAC1F,CACF,CAAC;AACJ,CAAC"}

package/dist/optics/front-of-lens-filter.d.ts

@@ -0,0 +1,114 @@
+import { type EvidenceBackedFact, type EvidenceProvenance } from "../core/evidence-provenance.js";
+import { type SpectralWavelengthBasis } from "../core/spectral.js";
+export declare const FRONT_OF_LENS_FILTER_PROFILE_SCHEMA_VERSION: "0.1.0";
+export type FrontOfLensFilterScientificStatus = "calibrated" | "approximation";
+export type FrontOfLensFilterUncertainty = {
+    kind: "relative";
+    fraction: number;
+    basis: string;
+} | {
+    kind: "not-quantified";
+    limitation: string;
+};
+export interface FrontOfLensFilterSpectralSample {
+    wavelengthNanometers: number;
+    linearTransmissionFactor: number;
+}
+export type FrontOfLensFilterTransmissionModel = {
+    kind: "neutral-linear-transmission";
+    linearTransmissionFactor: EvidenceBackedFact<number>;
+} | {
+    kind: "neutral-optical-density";
+    opticalDensityBase10: EvidenceBackedFact<number>;
+} | {
+    kind: "spectral-transmission";
+    samples: EvidenceBackedFact<readonly FrontOfLensFilterSpectralSample[]>;
+};
+export interface FrontOfLensFilterProfile {
+    schemaVersion: typeof FRONT_OF_LENS_FILTER_PROFILE_SCHEMA_VERSION;
+    filterId: string;
+    profileVersion: string;
+    identityScope: "photivra-generic-unbranded";
+    position: "front-of-lens";
+    scientificStatus: FrontOfLensFilterScientificStatus;
+    wavelengthBasis: Exclude<SpectralWavelengthBasis, "unspecified">;
+    wavelengthRangeNanometers: {
+        minimum: number;
+        maximum: number;
+    };
+    transmission: FrontOfLensFilterTransmissionModel;
+    uncertainty: FrontOfLensFilterUncertainty;
+    polarizationModeled: false;
+    wavelengthChangingBehaviorModeled: false;
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+export interface ResolveFrontOfLensFilterTransmissionInput {
+    profile: FrontOfLensFilterProfile;
+    wavelengthNanometers: number;
+    wavelengthBasis: Exclude<SpectralWavelengthBasis, "unspecified">;
+}
+export interface ResolvedFrontOfLensFilterTransmission {
+    schemaVersion: typeof FRONT_OF_LENS_FILTER_PROFILE_SCHEMA_VERSION;
+    filterId: string;
+    profileVersion: string;
+    identityScope: "photivra-generic-unbranded";
+    position: "front-of-lens";
+    scientificStatus: FrontOfLensFilterScientificStatus;
+    wavelengthNanometers: number;
+    wavelengthBasis: Exclude<SpectralWavelengthBasis, "unspecified">;
+    transmissionKind: FrontOfLensFilterTransmissionModel["kind"];
+    linearTransmissionFactor: number;
+    attenuationStops: number;
+    opticalDensityBase10: number;
+    polarizationModeled: false;
+    wavelengthChangingBehaviorModeled: false;
+    lensTransmissionIncluded: false;
+    sensorOpticalStackIncluded: false;
+    fieldThroughputIncluded: false;
+    uncertainty: FrontOfLensFilterUncertainty;
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+export interface ComposeFrontOfLensFilterTransmissionInput {
+    filters: readonly FrontOfLensFilterProfile[];
+    wavelengthNanometers: number;
+    wavelengthBasis: Exclude<SpectralWavelengthBasis, "unspecified">;
+}
+export interface ComposedFrontOfLensFilterTransmission {
+    schemaVersion: typeof FRONT_OF_LENS_FILTER_PROFILE_SCHEMA_VERSION;
+    wavelengthNanometers: number;
+    wavelengthBasis: Exclude<SpectralWavelengthBasis, "unspecified">;
+    appliedFilterCount: number;
+    components: readonly ResolvedFrontOfLensFilterTransmission[];
+    combinedLinearTransmissionFactor: number;
+    combinedAttenuationStops: number;
+    scientificStatus: FrontOfLensFilterScientificStatus;
+    uncertaintyPropagation: "not-propagated";
+    uncertaintyLimitation: string;
+    compositionModel: "independent-multiplicative-unpolarized-transmission-no-inter-filter-reflections";
+    polarizationModeled: false;
+    wavelengthChangingBehaviorModeled: false;
+    lensTransmissionIncluded: false;
+    sensorOpticalStackIncluded: false;
+    fieldThroughputIncluded: false;
+}
+/**
+ * Parses one generic front-of-lens transmission filter.
+ *
+ * Schema 0.1.0 is explicitly unbranded and unpolarized. It models only
+ * passive transmission placed before the lens. Reflections between stacked
+ * filters, polarization, flare/ghosting and wavelength-changing behavior are
+ * outside this contract.
+ */
+export declare function parseFrontOfLensFilterProfile(value: unknown): FrontOfLensFilterProfile;
+/**
+ * Resolves one passive filter at one wavelength.
+ */
+export declare function resolveFrontOfLensFilterTransmission(input: ResolveFrontOfLensFilterTransmissionInput): ResolvedFrontOfLensFilterTransmission;
+/**
+ * Composes multiple passive front-of-lens filters multiplicatively at one
+ * wavelength while preserving each component's identity.
+ */
+export declare function composeFrontOfLensFilterTransmission(input: ComposeFrontOfLensFilterTransmissionInput): ComposedFrontOfLensFilterTransmission;
+//# sourceMappingURL=front-of-lens-filter.d.ts.map

package/dist/optics/front-of-lens-filter.d.ts.map

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