@photivra/engine 0.1.0

package/dist/output/subject-framing-crop.d.ts

@@ -0,0 +1,36 @@
+import { type CalculationResult } from "../core/calculation-result.js";
+export interface CalculateSubjectFramingCropInput {
+    /** Source image width in pixels. */
+    pixelWidth: number;
+    /** Source image height in pixels. */
+    pixelHeight: number;
+    /** Projected subject height in source-image pixels. */
+    subjectHeightPixels: number;
+    /** Desired subject height as a fraction of output frame height, >0 and <=1. */
+    targetSubjectHeightFraction: number;
+}
+export interface SubjectFramingCrop {
+    cropFactor: number;
+    pixelWidth: number;
+    pixelHeight: number;
+    megapixels: number;
+    /**
+     * Actual subject height divided by cropped frame height.
+     * Values greater than 1 mean the subject is taller than the output frame.
+     */
+    subjectHeightFraction: number;
+    /** Whether the projected subject exceeds the cropped frame height. */
+    subjectClipped: boolean;
+    /** Whether achieving the target required an additional crop. */
+    cropped: boolean;
+}
+/**
+ * Calculates the same-aspect-ratio crop needed for a subject to occupy a
+ * requested fraction of frame height.
+ *
+ * This calculation assumes a centered/positionable crop with enough spatial
+ * margin around the subject. It does not validate subject position against
+ * image edges.
+ */
+export declare function calculateSubjectFramingCrop(input: CalculateSubjectFramingCropInput): CalculationResult<SubjectFramingCrop>;
+//# sourceMappingURL=subject-framing-crop.d.ts.map

package/dist/output/subject-framing-crop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-framing-crop.d.ts","sourceRoot":"","sources":["../../src/output/subject-framing-crop.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAOvC,MAAM,WAAW,gCAAgC;IAC/C,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,cAAc,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,iBAAiB,CAAC,kBAAkB,CAAC,CAoDvC"}

package/dist/output/subject-framing-crop.js

@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: Apache-2.0
+import { calculatedResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError, requirePositiveFinite, requirePositiveInteger } from "../core/validation.js";
+/**
+ * Calculates the same-aspect-ratio crop needed for a subject to occupy a
+ * requested fraction of frame height.
+ *
+ * This calculation assumes a centered/positionable crop with enough spatial
+ * margin around the subject. It does not validate subject position against
+ * image edges.
+ */
+export function calculateSubjectFramingCrop(input) {
+    requirePositiveInteger("pixelWidth", input.pixelWidth);
+    requirePositiveInteger("pixelHeight", input.pixelHeight);
+    requirePositiveFinite("subjectHeightPixels", input.subjectHeightPixels);
+    requirePositiveFinite("targetSubjectHeightFraction", input.targetSubjectHeightFraction);
+    if (input.targetSubjectHeightFraction > 1) {
+        throw new InvalidScientificInputError("targetSubjectHeightFraction must be less than or equal to 1.");
+    }
+    const requestedCropHeight = input.subjectHeightPixels / input.targetSubjectHeightFraction;
+    const cropFactor = requestedCropHeight >= input.pixelHeight
+        ? 1
+        : input.pixelHeight / requestedCropHeight;
+    const pixelHeight = Math.max(1, Math.floor(input.pixelHeight / cropFactor));
+    const pixelWidth = Math.max(1, Math.floor(input.pixelWidth / cropFactor));
+    const subjectHeightFraction = input.subjectHeightPixels / pixelHeight;
+    return calculatedResult({
+        cropFactor,
+        pixelWidth,
+        pixelHeight,
+        megapixels: (pixelWidth * pixelHeight) / 1_000_000,
+        subjectHeightFraction,
+        subjectClipped: subjectHeightFraction > 1,
+        cropped: cropFactor > 1
+    }, "subject-height-framing-crop", "1.0.0", [
+        "Original aspect ratio is preserved",
+        "Crop can be positioned around the subject",
+        "Subject edge/margin constraints are not modeled",
+        "subjectHeightFraction may exceed 1 when the subject is clipped by frame height"
+    ]);
+}
+//# sourceMappingURL=subject-framing-crop.js.map

package/dist/output/subject-framing-crop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-framing-crop.js","sourceRoot":"","sources":["../../src/output/subject-framing-crop.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AA6B/B;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAuC;IAEvC,sBAAsB,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACvD,sBAAsB,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACzD,qBAAqB,CAAC,qBAAqB,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACxE,qBAAqB,CACnB,6BAA6B,EAC7B,KAAK,CAAC,2BAA2B,CAClC,CAAC;IAEF,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,2BAA2B,CACnC,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,mBAAmB,GACvB,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,2BAA2B,CAAC;IAChE,MAAM,UAAU,GACd,mBAAmB,IAAI,KAAK,CAAC,WAAW;QACtC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,mBAAmB,CAAC;IAE9C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,CAAC,EACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC,CAC3C,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACzB,CAAC,EACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,CAC1C,CAAC;IACF,MAAM,qBAAqB,GACzB,KAAK,CAAC,mBAAmB,GAAG,WAAW,CAAC;IAE1C,OAAO,gBAAgB,CACrB;QACE,UAAU;QACV,UAAU;QACV,WAAW;QACX,UAAU,EAAE,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,SAAS;QAClD,qBAAqB;QACrB,cAAc,EAAE,qBAAqB,GAAG,CAAC;QACzC,OAAO,EAAE,UAAU,GAAG,CAAC;KACxB,EACD,6BAA6B,EAC7B,OAAO,EACP;QACE,oCAAoC;QACpC,2CAA2C;QAC3C,iDAAiD;QACjD,gFAAgF;KACjF,CACF,CAAC;AACJ,CAAC"}

package/dist/schema/camera.d.ts

@@ -0,0 +1,34 @@
+export interface SensorConfiguration {
+    widthMm: number;
+    heightMm: number;
+    pixelWidth: number;
+    pixelHeight: number;
+}
+export interface LensConfiguration {
+    focalLengthMm: number;
+    aperture: number;
+}
+export interface ExposureConfiguration {
+    shutterSeconds: number;
+    iso: number;
+}
+export interface FocusConfiguration {
+    focusDistanceM: number;
+}
+export type CameraSupport = "handheld" | "braced" | "monopod" | "tripod";
+export interface StabilizationConfiguration {
+    bodyEnabled: boolean;
+    lensEnabled: boolean;
+    support: CameraSupport;
+}
+/**
+ * Renderer-independent camera configuration consumed by simulation modules.
+ */
+export interface CameraConfiguration {
+    sensor: SensorConfiguration;
+    lens: LensConfiguration;
+    exposure: ExposureConfiguration;
+    focus: FocusConfiguration;
+    stabilization?: StabilizationConfiguration;
+}
+//# sourceMappingURL=camera.d.ts.map

package/dist/schema/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../src/schema/camera.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,CAAC,EAAE,0BAA0B,CAAC;CAC5C"}

package/dist/schema/camera.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=camera.js.map

package/dist/schema/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../src/schema/camera.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/dist/schema/scene.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Three-dimensional value in scene/world coordinates.
+ */
+export interface Vector3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Describes how scene-linear image values relate to physical light.
+ */
+export type SceneRadiometry = {
+    /**
+     * Relative linear values preserve light ratios but are not absolutely
+     * calibrated for photon-count calculations.
+     */
+    kind: "relative-linear";
+    referenceValue: number;
+} | {
+    /**
+     * Scene package includes an absolute luminance anchor that can support
+     * calibrated photometric exposure work. Luminance alone is not
+     * sufficient to derive photon counts; photon simulation additionally
+     * requires defensible spectral and optical calibration.
+     */
+    kind: "absolute-luminance";
+    referenceValue: number;
+    referenceLuminanceCdM2: number;
+};
+/**
+ * Motion attached to an independently controllable scene object or region.
+ */
+export interface SceneMotion {
+    /** World-space linear velocity in metres per second. */
+    linearVelocityMps: Vector3;
+    /** Optional world-space angular velocity in radians per second. */
+    angularVelocityRadPerSec?: Vector3;
+}
+/**
+ * Semantic object/region within a curated synthetic scene.
+ */
+export interface SceneObject {
+    id: string;
+    label?: string;
+    /** Representative distance from the camera origin in metres. */
+    distanceM: number;
+    motion?: SceneMotion;
+    tags?: readonly string[];
+}
+/**
+ * Capabilities intentionally advertised by a scene package.
+ */
+export type SceneCapability = "scene-linear-rgb" | "metric-depth" | "segmentation" | "occlusion-layers" | "motion-vectors" | "focus-targets" | "multi-resolution-layers" | "absolute-radiometry";
+/**
+ * Versioned, renderer-independent description of a curated synthetic scene.
+ *
+ * Asset locations are intentionally not part of this scientific schema;
+ * callers may bind the metadata to their own asset systems separately.
+ */
+export interface SceneDefinition {
+    schemaVersion: string;
+    id: string;
+    version: string;
+    radiometry: SceneRadiometry;
+    capabilities: readonly SceneCapability[];
+    objects: readonly SceneObject[];
+    focusTargetIds?: readonly string[];
+}
+//# sourceMappingURL=scene.d.ts.map

package/dist/schema/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/schema/scene.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IACE;;;OAGG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB,GACD;IACE;;;;;OAKG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,yBAAyB,GACzB,qBAAqB,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACzC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC"}

package/dist/schema/scene.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=scene.js.map

package/dist/schema/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../src/schema/scene.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/dist/schema/validation.d.ts

@@ -0,0 +1,25 @@
+import type { CameraConfiguration } from "./camera.js";
+import type { SceneDefinition } from "./scene.js";
+/**
+ * Error thrown when external configuration data does not match a public
+ * runtime schema.
+ */
+export declare class InvalidConfigurationError extends TypeError {
+    readonly code = "INVALID_CONFIGURATION";
+    constructor(message: string);
+}
+/**
+ * Parses and validates an untrusted camera configuration.
+ *
+ * @param value Unknown external data.
+ * @returns The original value narrowed to CameraConfiguration.
+ */
+export declare function parseCameraConfiguration(value: unknown): CameraConfiguration;
+/**
+ * Parses and validates an untrusted renderer-independent scene definition.
+ *
+ * @param value Unknown external data.
+ * @returns The original value narrowed to SceneDefinition.
+ */
+export declare function parseSceneDefinition(value: unknown): SceneDefinition;
+//# sourceMappingURL=validation.d.ts.map

package/dist/schema/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/schema/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,YAAY,CAAC;AAsBpB;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,SAAS;IACtD,QAAQ,CAAC,IAAI,2BAA2B;gBAE5B,OAAO,EAAE,MAAM;CAI5B;AAkGD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,mBAAmB,CAwCrB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAuFpE"}

package/dist/schema/validation.js

@@ -0,0 +1,180 @@
+// SPDX-License-Identifier: Apache-2.0
+const CAMERA_SUPPORTS = new Set([
+    "handheld",
+    "braced",
+    "monopod",
+    "tripod"
+]);
+const SCENE_CAPABILITIES = new Set([
+    "scene-linear-rgb",
+    "metric-depth",
+    "segmentation",
+    "occlusion-layers",
+    "motion-vectors",
+    "focus-targets",
+    "multi-resolution-layers",
+    "absolute-radiometry"
+]);
+/**
+ * Error thrown when external configuration data does not match a public
+ * runtime schema.
+ */
+export class InvalidConfigurationError extends TypeError {
+    code = "INVALID_CONFIGURATION";
+    constructor(message) {
+        super(message);
+        this.name = "InvalidConfigurationError";
+    }
+}
+function requireRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new InvalidConfigurationError(`${path} must be an object.`);
+    }
+    return value;
+}
+function requireString(record, key, path) {
+    const value = record[key];
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new InvalidConfigurationError(`${path}.${key} must be a non-empty string.`);
+    }
+    return value;
+}
+function requireBoolean(record, key, path) {
+    const value = record[key];
+    if (typeof value !== "boolean") {
+        throw new InvalidConfigurationError(`${path}.${key} must be a boolean.`);
+    }
+    return value;
+}
+function requirePositiveNumber(record, key, path) {
+    const value = record[key];
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        throw new InvalidConfigurationError(`${path}.${key} must be a finite number greater than zero.`);
+    }
+    return value;
+}
+function requirePositiveIntegerValue(record, key, path) {
+    const value = record[key];
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new InvalidConfigurationError(`${path}.${key} must be a positive safe integer.`);
+    }
+    return value;
+}
+function assertVector3(value, path) {
+    const vector = requireRecord(value, path);
+    for (const component of ["x", "y", "z"]) {
+        const coordinate = vector[component];
+        if (typeof coordinate !== "number" || !Number.isFinite(coordinate)) {
+            throw new InvalidConfigurationError(`${path}.${component} must be a finite number.`);
+        }
+    }
+}
+function assertStringArray(value, path) {
+    if (!Array.isArray(value) ||
+        value.some((entry) => typeof entry !== "string" || entry.trim().length === 0)) {
+        throw new InvalidConfigurationError(`${path} must be an array of non-empty strings.`);
+    }
+    return value;
+}
+function assertUniqueStrings(values, path) {
+    const normalized = values.map((value) => value.trim());
+    if (new Set(normalized).size !== normalized.length) {
+        throw new InvalidConfigurationError(`${path} must not contain duplicates.`);
+    }
+}
+/**
+ * Parses and validates an untrusted camera configuration.
+ *
+ * @param value Unknown external data.
+ * @returns The original value narrowed to CameraConfiguration.
+ */
+export function parseCameraConfiguration(value) {
+    const camera = requireRecord(value, "camera");
+    const sensor = requireRecord(camera.sensor, "camera.sensor");
+    requirePositiveNumber(sensor, "widthMm", "camera.sensor");
+    requirePositiveNumber(sensor, "heightMm", "camera.sensor");
+    requirePositiveIntegerValue(sensor, "pixelWidth", "camera.sensor");
+    requirePositiveIntegerValue(sensor, "pixelHeight", "camera.sensor");
+    const lens = requireRecord(camera.lens, "camera.lens");
+    requirePositiveNumber(lens, "focalLengthMm", "camera.lens");
+    requirePositiveNumber(lens, "aperture", "camera.lens");
+    const exposure = requireRecord(camera.exposure, "camera.exposure");
+    requirePositiveNumber(exposure, "shutterSeconds", "camera.exposure");
+    requirePositiveNumber(exposure, "iso", "camera.exposure");
+    const focus = requireRecord(camera.focus, "camera.focus");
+    requirePositiveNumber(focus, "focusDistanceM", "camera.focus");
+    if (camera.stabilization !== undefined) {
+        const stabilization = requireRecord(camera.stabilization, "camera.stabilization");
+        requireBoolean(stabilization, "bodyEnabled", "camera.stabilization");
+        requireBoolean(stabilization, "lensEnabled", "camera.stabilization");
+        const support = requireString(stabilization, "support", "camera.stabilization");
+        if (!CAMERA_SUPPORTS.has(support)) {
+            throw new InvalidConfigurationError("camera.stabilization.support is invalid.");
+        }
+    }
+    return value;
+}
+/**
+ * Parses and validates an untrusted renderer-independent scene definition.
+ *
+ * @param value Unknown external data.
+ * @returns The original value narrowed to SceneDefinition.
+ */
+export function parseSceneDefinition(value) {
+    const scene = requireRecord(value, "scene");
+    requireString(scene, "schemaVersion", "scene");
+    requireString(scene, "id", "scene");
+    requireString(scene, "version", "scene");
+    const radiometry = requireRecord(scene.radiometry, "scene.radiometry");
+    const radiometryKind = requireString(radiometry, "kind", "scene.radiometry");
+    requirePositiveNumber(radiometry, "referenceValue", "scene.radiometry");
+    if (radiometryKind === "absolute-luminance") {
+        requirePositiveNumber(radiometry, "referenceLuminanceCdM2", "scene.radiometry");
+    }
+    else if (radiometryKind !== "relative-linear") {
+        throw new InvalidConfigurationError("scene.radiometry.kind is invalid.");
+    }
+    const capabilities = assertStringArray(scene.capabilities, "scene.capabilities");
+    assertUniqueStrings(capabilities, "scene.capabilities");
+    for (const capability of capabilities) {
+        if (!SCENE_CAPABILITIES.has(capability)) {
+            throw new InvalidConfigurationError(`Unknown scene capability: ${capability}`);
+        }
+    }
+    if (!Array.isArray(scene.objects)) {
+        throw new InvalidConfigurationError("scene.objects must be an array.");
+    }
+    const objectIds = [];
+    scene.objects.forEach((objectValue, index) => {
+        const path = `scene.objects[${index}]`;
+        const object = requireRecord(objectValue, path);
+        objectIds.push(requireString(object, "id", path));
+        requirePositiveNumber(object, "distanceM", path);
+        if (object.label !== undefined && typeof object.label !== "string") {
+            throw new InvalidConfigurationError(`${path}.label must be a string.`);
+        }
+        if (object.tags !== undefined) {
+            assertStringArray(object.tags, `${path}.tags`);
+        }
+        if (object.motion !== undefined) {
+            const motion = requireRecord(object.motion, `${path}.motion`);
+            assertVector3(motion.linearVelocityMps, `${path}.motion.linearVelocityMps`);
+            if (motion.angularVelocityRadPerSec !== undefined) {
+                assertVector3(motion.angularVelocityRadPerSec, `${path}.motion.angularVelocityRadPerSec`);
+            }
+        }
+    });
+    assertUniqueStrings(objectIds, "scene.objects[].id");
+    if (scene.focusTargetIds !== undefined) {
+        const focusTargetIds = assertStringArray(scene.focusTargetIds, "scene.focusTargetIds");
+        assertUniqueStrings(focusTargetIds, "scene.focusTargetIds");
+        const knownIds = new Set(objectIds);
+        for (const focusTargetId of focusTargetIds) {
+            if (!knownIds.has(focusTargetId)) {
+                throw new InvalidConfigurationError(`Unknown scene focus target: ${focusTargetId}`);
+            }
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=validation.js.map

package/dist/schema/validation.js.map

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

package/dist/sensor/pixel-pitch.d.ts

@@ -0,0 +1,21 @@
+import { type CalculationResult } from "../core/calculation-result.js";
+export interface CalculatePixelPitchInput {
+    /** Physical sensor width in millimetres. */
+    sensorWidthMm: number;
+    /** Horizontal active pixel count. */
+    pixelWidth: number;
+}
+export interface PixelPitch {
+    /** Horizontal pixel pitch in micrometres. */
+    micrometers: number;
+    /** Horizontal pixel pitch in millimetres. */
+    millimeters: number;
+}
+/**
+ * Calculates horizontal pixel pitch from active sensor width and pixel count.
+ *
+ * @param input Sensor width and horizontal active pixel count.
+ * @returns Pixel pitch.
+ */
+export declare function calculatePixelPitch(input: CalculatePixelPitchInput): CalculationResult<PixelPitch>;
+//# sourceMappingURL=pixel-pitch.d.ts.map

package/dist/sensor/pixel-pitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-pitch.d.ts","sourceRoot":"","sources":["../../src/sensor/pixel-pitch.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAMvC,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,iBAAiB,CAAC,UAAU,CAAC,CAc/B"}

package/dist/sensor/pixel-pitch.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: Apache-2.0
+import { calculatedResult } from "../core/calculation-result.js";
+import { requirePositiveFinite, requirePositiveInteger } from "../core/validation.js";
+/**
+ * Calculates horizontal pixel pitch from active sensor width and pixel count.
+ *
+ * @param input Sensor width and horizontal active pixel count.
+ * @returns Pixel pitch.
+ */
+export function calculatePixelPitch(input) {
+    requirePositiveFinite("sensorWidthMm", input.sensorWidthMm);
+    requirePositiveInteger("pixelWidth", input.pixelWidth);
+    const millimeters = input.sensorWidthMm / input.pixelWidth;
+    return calculatedResult({
+        millimeters,
+        micrometers: millimeters * 1000
+    }, "pixel-pitch", "1.0.0");
+}
+//# sourceMappingURL=pixel-pitch.js.map

package/dist/sensor/pixel-pitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-pitch.js","sourceRoot":"","sources":["../../src/sensor/pixel-pitch.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAgB/B;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA+B;IAE/B,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5D,sBAAsB,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAEvD,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,UAAU,CAAC;IAE3D,OAAO,gBAAgB,CACrB;QACE,WAAW;QACX,WAAW,EAAE,WAAW,GAAG,IAAI;KAChC,EACD,aAAa,EACb,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/sensor/signal-noise.d.ts

@@ -0,0 +1,37 @@
+import { type CalculationResult } from "../core/calculation-result.js";
+export interface CalculatePhotoelectronsInput {
+    /** Mean photons incident on the photosite/measurement region. */
+    incidentPhotons: number;
+    /** Quantum efficiency from 0 to 1 inclusive. */
+    quantumEfficiency: number;
+}
+/**
+ * Converts mean incident photon count to mean photoelectron count.
+ *
+ * This is an expectation value; the stochastic shot-noise realization is not
+ * generated by this deterministic calculation.
+ */
+export declare function calculatePhotoelectrons(input: CalculatePhotoelectronsInput): CalculationResult<number>;
+export interface CalculateSignalToNoiseInput {
+    /** Mean signal in electrons. */
+    signalElectrons: number;
+    /** RMS read noise in electrons. */
+    readNoiseElectrons: number;
+}
+export interface SignalToNoise {
+    shotNoiseStdElectrons: number;
+    combinedNoiseStdElectrons: number;
+    snrLinear: number;
+    /** Null when the signal is zero because -Infinity dB is not JSON-safe. */
+    snrDb: number | null;
+}
+/**
+ * Calculates expected SNR from Poisson shot noise and independent RMS read
+ * noise.
+ *
+ * Variances are combined as signalElectrons + readNoiseElectrons^2.
+ * Dark current, fixed-pattern noise, quantization, clipping, and downstream
+ * processing are intentionally outside this primitive.
+ */
+export declare function calculateSignalToNoise(input: CalculateSignalToNoiseInput): CalculationResult<SignalToNoise>;
+//# sourceMappingURL=signal-noise.d.ts.map

package/dist/sensor/signal-noise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-noise.d.ts","sourceRoot":"","sources":["../../src/sensor/signal-noise.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAWvC,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,iBAAiB,CAAC,MAAM,CAAC,CAmB3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,iBAAiB,CAAC,aAAa,CAAC,CA8BlC"}

package/dist/sensor/signal-noise.js

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: Apache-2.0
+import { calculatedResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+function requireNonNegativeFinite(name, value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new InvalidScientificInputError(`${name} must be a finite number greater than or equal to zero.`);
+    }
+}
+/**
+ * Converts mean incident photon count to mean photoelectron count.
+ *
+ * This is an expectation value; the stochastic shot-noise realization is not
+ * generated by this deterministic calculation.
+ */
+export function calculatePhotoelectrons(input) {
+    requireNonNegativeFinite("incidentPhotons", input.incidentPhotons);
+    if (!Number.isFinite(input.quantumEfficiency) ||
+        input.quantumEfficiency < 0 ||
+        input.quantumEfficiency > 1) {
+        throw new InvalidScientificInputError("quantumEfficiency must be a finite number from 0 through 1.");
+    }
+    return calculatedResult(input.incidentPhotons * input.quantumEfficiency, "mean-photoelectron-conversion", "1.0.0", ["Quantum efficiency is supplied by the caller"]);
+}
+/**
+ * Calculates expected SNR from Poisson shot noise and independent RMS read
+ * noise.
+ *
+ * Variances are combined as signalElectrons + readNoiseElectrons^2.
+ * Dark current, fixed-pattern noise, quantization, clipping, and downstream
+ * processing are intentionally outside this primitive.
+ */
+export function calculateSignalToNoise(input) {
+    requireNonNegativeFinite("signalElectrons", input.signalElectrons);
+    requireNonNegativeFinite("readNoiseElectrons", input.readNoiseElectrons);
+    const shotNoiseStdElectrons = Math.sqrt(input.signalElectrons);
+    const combinedNoiseStdElectrons = Math.sqrt(input.signalElectrons +
+        input.readNoiseElectrons * input.readNoiseElectrons);
+    const snrLinear = combinedNoiseStdElectrons === 0
+        ? 0
+        : input.signalElectrons / combinedNoiseStdElectrons;
+    const snrDb = snrLinear === 0 ? null : 20 * Math.log10(snrLinear);
+    return calculatedResult({
+        shotNoiseStdElectrons,
+        combinedNoiseStdElectrons,
+        snrLinear,
+        snrDb
+    }, "poisson-shot-plus-read-noise-snr", "1.0.0", [
+        "Photon shot noise is Poisson",
+        "Read noise is supplied as independent RMS electrons",
+        "Dark current and fixed-pattern noise are not included"
+    ]);
+}
+//# sourceMappingURL=signal-noise.js.map

package/dist/sensor/signal-noise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-noise.js","sourceRoot":"","sources":["../../src/sensor/signal-noise.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,SAAS,wBAAwB,CAAC,IAAY,EAAE,KAAa;IAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,2BAA2B,CACnC,GAAG,IAAI,yDAAyD,CACjE,CAAC;IACJ,CAAC;AACH,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAmC;IAEnC,wBAAwB,CAAC,iBAAiB,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAEnE,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC;QACzC,KAAK,CAAC,iBAAiB,GAAG,CAAC;QAC3B,KAAK,CAAC,iBAAiB,GAAG,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,CACrB,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,iBAAiB,EAC/C,+BAA+B,EAC/B,OAAO,EACP,CAAC,8CAA8C,CAAC,CACjD,CAAC;AACJ,CAAC;AAiBD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAkC;IAElC,wBAAwB,CAAC,iBAAiB,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACnE,wBAAwB,CAAC,oBAAoB,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAEzE,MAAM,qBAAqB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/D,MAAM,yBAAyB,GAAG,IAAI,CAAC,IAAI,CACzC,KAAK,CAAC,eAAe;QACnB,KAAK,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CACtD,CAAC;IACF,MAAM,SAAS,GACb,yBAAyB,KAAK,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,KAAK,CAAC,eAAe,GAAG,yBAAyB,CAAC;IACxD,MAAM,KAAK,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAElE,OAAO,gBAAgB,CACrB;QACE,qBAAqB;QACrB,yBAAyB;QACzB,SAAS;QACT,KAAK;KACN,EACD,kCAAkC,EAClC,OAAO,EACP;QACE,8BAA8B;QAC9B,qDAAqD;QACrD,uDAAuD;KACxD,CACF,CAAC;AACJ,CAAC"}