@photivra/engine 0.1.0

package/dist/simulation/poc-simulation.js

@@ -0,0 +1,449 @@
+// SPDX-License-Identifier: Apache-2.0
+import { calculateFieldOfView } from "../camera/field-of-view.js";
+import { calculateProjectedObjectSize } from "../camera/projected-object-size.js";
+import { InvalidScientificInputError, requirePositiveFinite } from "../core/validation.js";
+import { calculateExposureValue100 } from "../exposure/exposure.js";
+import { calculateProjectedMotionBlur } from "../motion/projected-motion.js";
+import { calculateIdealApertureGeometry } from "../optics/aperture.js";
+import { estimateEquivalentViewingCircleOfConfusion } from "../optics/circle-of-confusion.js";
+import { calculateAiryDisk } from "../optics/diffraction.js";
+import { calculateThinLensImageDistance } from "../optics/thin-lens.js";
+import { calculateDefocusCircle, calculateDepthOfField } from "../optics/depth-of-field.js";
+import { calculateCenteredCrop } from "../output/crop.js";
+import { calculateSubjectFramingCrop } from "../output/subject-framing-crop.js";
+import { calculatePixelPitch } from "../sensor/pixel-pitch.js";
+import { estimateCameraShakeBlur } from "../stabilization/camera-shake.js";
+function calculateCroppedFieldOfView(sensorWidthMm, sensorHeightMm, focalLengthMm, focusDistanceM, cropFactor) {
+    const diagonalMm = Math.hypot(sensorWidthMm, sensorHeightMm);
+    return {
+        horizontalDegrees: calculateFieldOfView({
+            focalLengthMm,
+            sensorDimensionMm: sensorWidthMm / cropFactor,
+            focusDistanceM
+        }).value.degrees,
+        verticalDegrees: calculateFieldOfView({
+            focalLengthMm,
+            sensorDimensionMm: sensorHeightMm / cropFactor,
+            focusDistanceM
+        }).value.degrees,
+        diagonalDegrees: calculateFieldOfView({
+            focalLengthMm,
+            sensorDimensionMm: diagonalMm / cropFactor,
+            focusDistanceM
+        }).value.degrees
+    };
+}
+function requireUniqueSampleIds(label, samples) {
+    if (samples === undefined) {
+        return;
+    }
+    const seen = new Set();
+    for (const sample of samples) {
+        const normalizedId = sample.id.trim();
+        if (normalizedId.length === 0) {
+            throw new InvalidScientificInputError(`${label}[].id must not be empty.`);
+        }
+        if (seen.has(normalizedId)) {
+            throw new InvalidScientificInputError(`${label}[].id values must be unique; duplicate: ${normalizedId}`);
+        }
+        seen.add(normalizedId);
+    }
+}
+/**
+ * Composes the validated POC calculations into a single renderer/agent-facing
+ * response without introducing any new photographic model.
+ *
+ * @param request Complete POC simulation request with explicit physical units.
+ * @returns Serializable POC metrics for one camera/scene configuration.
+ */
+export function simulatePocCamera(request) {
+    requirePositiveFinite("sensor.widthMm", request.sensor.widthMm);
+    requirePositiveFinite("sensor.heightMm", request.sensor.heightMm);
+    requirePositiveFinite("lens.focalLengthMm", request.lens.focalLengthMm);
+    requirePositiveFinite("lens.aperture", request.lens.aperture);
+    requirePositiveFinite("exposure.shutterSeconds", request.exposure.shutterSeconds);
+    requirePositiveFinite("exposure.iso", request.exposure.iso);
+    requirePositiveFinite("focus.focusDistanceM", request.focus.focusDistanceM);
+    const hasExplicitCircleOfConfusion = request.focus.circleOfConfusionMm !== undefined;
+    const hasEquivalentViewingCriterion = request.focus.equivalentViewingCircleOfConfusion !== undefined;
+    if (hasExplicitCircleOfConfusion === hasEquivalentViewingCriterion) {
+        throw new InvalidScientificInputError("Provide exactly one focus circle-of-confusion criterion.");
+    }
+    const equivalentViewingCircleOfConfusion = request.focus.equivalentViewingCircleOfConfusion === undefined
+        ? undefined
+        : estimateEquivalentViewingCircleOfConfusion({
+            sensorWidthMm: request.sensor.widthMm,
+            sensorHeightMm: request.sensor.heightMm,
+            ...request.focus.equivalentViewingCircleOfConfusion
+        });
+    const circleOfConfusionMm = equivalentViewingCircleOfConfusion?.value.circleOfConfusionMm ??
+        request.focus.circleOfConfusionMm;
+    if (circleOfConfusionMm === undefined) {
+        throw new InvalidScientificInputError("A focus circle-of-confusion criterion is required.");
+    }
+    requirePositiveFinite("focus.circleOfConfusionMm", circleOfConfusionMm);
+    requirePositiveFinite("crop.factor", request.crop.factor);
+    requirePositiveFinite("diffraction.wavelengthNm", request.diffraction.wavelengthNm);
+    requireUniqueSampleIds("defocusSamples", request.defocusSamples);
+    requireUniqueSampleIds("samplingSamples", request.samplingSamples);
+    requireUniqueSampleIds("motionSamples", request.motionSamples);
+    const projection = calculateThinLensImageDistance({
+        focalLengthMm: request.lens.focalLengthMm,
+        objectDistanceM: request.focus.focusDistanceM
+    });
+    const diagonalMm = Math.hypot(request.sensor.widthMm, request.sensor.heightMm);
+    const horizontalFov = calculateFieldOfView({
+        focalLengthMm: request.lens.focalLengthMm,
+        sensorDimensionMm: request.sensor.widthMm,
+        focusDistanceM: request.focus.focusDistanceM
+    });
+    const verticalFov = calculateFieldOfView({
+        focalLengthMm: request.lens.focalLengthMm,
+        sensorDimensionMm: request.sensor.heightMm,
+        focusDistanceM: request.focus.focusDistanceM
+    });
+    const diagonalFov = calculateFieldOfView({
+        focalLengthMm: request.lens.focalLengthMm,
+        sensorDimensionMm: diagonalMm,
+        focusDistanceM: request.focus.focusDistanceM
+    });
+    const pixelPitch = calculatePixelPitch({
+        sensorWidthMm: request.sensor.widthMm,
+        pixelWidth: request.sensor.pixelWidth
+    });
+    const crop = calculateCenteredCrop({
+        pixelWidth: request.sensor.pixelWidth,
+        pixelHeight: request.sensor.pixelHeight,
+        cropFactor: request.crop.factor
+    });
+    const cropFieldOfView = calculateCroppedFieldOfView(request.sensor.widthMm, request.sensor.heightMm, request.lens.focalLengthMm, request.focus.focusDistanceM, request.crop.factor);
+    const depthOfField = calculateDepthOfField({
+        focalLengthMm: request.lens.focalLengthMm,
+        aperture: request.lens.aperture,
+        focusDistanceM: request.focus.focusDistanceM,
+        circleOfConfusionMm
+    });
+    const diffraction = calculateAiryDisk({
+        aperture: request.lens.aperture,
+        wavelengthNm: request.diffraction.wavelengthNm
+    });
+    const motion = calculateProjectedMotionBlur({
+        focalLengthMm: request.lens.focalLengthMm,
+        shutterSeconds: request.exposure.shutterSeconds,
+        positionM: request.motion.positionM,
+        velocityMps: request.motion.velocityMps,
+        focusDistanceM: request.focus.focusDistanceM,
+        pixelPitchMicrometers: pixelPitch.value.micrometers
+    });
+    const exposureValue = calculateExposureValue100({
+        aperture: request.lens.aperture,
+        shutterSeconds: request.exposure.shutterSeconds
+    });
+    const subjectSampling = request.subject === undefined
+        ? undefined
+        : calculateProjectedObjectSize({
+            focalLengthMm: request.lens.focalLengthMm,
+            objectWidthM: request.subject.widthM,
+            objectHeightM: request.subject.heightM,
+            distanceM: request.subject.distanceM,
+            focusDistanceM: request.focus.focusDistanceM,
+            pixelPitchMicrometers: pixelPitch.value.micrometers
+        }).value;
+    const samplingSamples = request.samplingSamples === undefined
+        ? undefined
+        : request.samplingSamples.map((sample) => {
+            const projected = calculateProjectedObjectSize({
+                focalLengthMm: request.lens.focalLengthMm,
+                objectWidthM: sample.widthM,
+                objectHeightM: sample.heightM,
+                distanceM: sample.distanceM,
+                focusDistanceM: request.focus.focusDistanceM,
+                pixelPitchMicrometers: pixelPitch.value.micrometers
+            }).value;
+            return {
+                id: sample.id,
+                widthMm: projected.widthMm,
+                heightMm: projected.heightMm,
+                widthPixels: projected.widthPixels ?? 0,
+                heightPixels: projected.heightPixels ?? 0
+            };
+        });
+    const motionSamples = request.motionSamples === undefined
+        ? undefined
+        : request.motionSamples.map((sample) => {
+            const projected = calculateProjectedMotionBlur({
+                focalLengthMm: request.lens.focalLengthMm,
+                shutterSeconds: request.exposure.shutterSeconds,
+                positionM: sample.positionM,
+                velocityMps: sample.velocityMps,
+                focusDistanceM: request.focus.focusDistanceM,
+                pixelPitchMicrometers: pixelPitch.value.micrometers
+            });
+            return {
+                id: sample.id,
+                distanceMm: projected.value.distanceMm,
+                distancePixels: projected.value.distancePixels ?? 0,
+                deltaXMm: projected.value.deltaXMm,
+                deltaYMm: projected.value.deltaYMm,
+                deltaXPixels: projected.value.deltaXMm /
+                    (pixelPitch.value.micrometers / 1000),
+                deltaYPixels: projected.value.deltaYMm /
+                    (pixelPitch.value.micrometers / 1000)
+            };
+        });
+    const subjectCrop = request.subjectCrop === undefined || subjectSampling === undefined
+        ? undefined
+        : calculateSubjectFramingCrop({
+            pixelWidth: crop.value.pixelWidth,
+            pixelHeight: crop.value.pixelHeight,
+            subjectHeightPixels: subjectSampling.heightPixels ?? 0,
+            targetSubjectHeightFraction: request.subjectCrop.targetSubjectHeightFraction
+        }).value;
+    const totalSubjectCropFactor = subjectCrop === undefined
+        ? undefined
+        : request.crop.factor * subjectCrop.cropFactor;
+    const subjectCropFieldOfView = totalSubjectCropFactor === undefined
+        ? undefined
+        : calculateCroppedFieldOfView(request.sensor.widthMm, request.sensor.heightMm, request.lens.focalLengthMm, request.focus.focusDistanceM, totalSubjectCropFactor);
+    const cameraShake = request.cameraShake === undefined
+        ? undefined
+        : estimateCameraShakeBlur({
+            focalLengthMm: request.lens.focalLengthMm,
+            shutterSeconds: request.exposure.shutterSeconds,
+            angularVelocityRadPerSec: request.cameraShake.angularVelocityRadPerSec,
+            stabilizationStopsEquivalent: request.cameraShake.stabilizationStopsEquivalent,
+            focusDistanceM: request.focus.focusDistanceM,
+            pixelPitchMicrometers: pixelPitch.value.micrometers
+        });
+    const apertureShape = request.apertureShape === undefined
+        ? undefined
+        : calculateIdealApertureGeometry(request.apertureShape);
+    const diagnosticSubjectMotion = request.diagnostics?.subjectMotionSampleId === undefined
+        ? undefined
+        : motionSamples?.find((sample) => sample.id === request.diagnostics?.subjectMotionSampleId);
+    if (request.diagnostics?.subjectMotionSampleId !== undefined &&
+        diagnosticSubjectMotion === undefined) {
+        throw new InvalidScientificInputError(`Unknown diagnostics subjectMotionSampleId: ${request.diagnostics.subjectMotionSampleId}`);
+    }
+    const subjectDefocus = request.subject === undefined
+        ? undefined
+        : calculateDefocusCircle({
+            focalLengthMm: request.lens.focalLengthMm,
+            aperture: request.lens.aperture,
+            focusDistanceM: request.focus.focusDistanceM,
+            subjectDistanceM: request.subject.distanceM
+        }).value;
+    const primarySubjectDiagnostics = request.subject === undefined ||
+        subjectSampling === undefined ||
+        subjectDefocus === undefined
+        ? undefined
+        : {
+            subjectDistanceM: request.subject.distanceM,
+            samplingHeightPixels: subjectSampling.heightPixels ?? 0,
+            defocusDiameterPixels: subjectDefocus.diameterMm /
+                (pixelPitch.value.micrometers / 1000),
+            diffractionFirstZeroDiameterPixels: diffraction.value.firstZeroDiameterMicrometers /
+                pixelPitch.value.micrometers,
+            diffractionModel: diffraction.provenance.model,
+            ...(diagnosticSubjectMotion === undefined
+                ? {}
+                : {
+                    subjectMotion: {
+                        id: diagnosticSubjectMotion.id,
+                        distancePixels: diagnosticSubjectMotion.distancePixels
+                    }
+                }),
+            ...(cameraShake === undefined
+                ? {}
+                : {
+                    cameraShake: {
+                        stabilizedDistancePixels: cameraShake.value.stabilized.distancePixels ?? 0,
+                        provenanceKind: "approximation"
+                    }
+                }),
+            comparisonCaution: "Sampling, defocus diameter, diffraction diameter, motion path, and camera-shake path are different physical indicators and must not be directly summed into a sharpness score."
+        };
+    const defocusSamples = request.defocusSamples === undefined
+        ? undefined
+        : request.defocusSamples.map((sample) => {
+            requirePositiveFinite("defocusSamples[].distanceM", sample.distanceM);
+            const defocus = calculateDefocusCircle({
+                focalLengthMm: request.lens.focalLengthMm,
+                aperture: request.lens.aperture,
+                focusDistanceM: request.focus.focusDistanceM,
+                subjectDistanceM: sample.distanceM
+            });
+            return {
+                id: sample.id,
+                distanceM: sample.distanceM,
+                diameterMm: defocus.value.diameterMm,
+                diameterPixels: defocus.value.diameterMm /
+                    (pixelPitch.value.micrometers / 1000)
+            };
+        });
+    return {
+        apiVersion: "0.17.0",
+        projection: {
+            kind: "focus-aware-thin-lens",
+            focusDistanceM: request.focus.focusDistanceM,
+            imageDistanceMm: projection.value.imageDistanceMm,
+            infinityProjectionScale: projection.value.infinityProjectionScale,
+            provenance: projection.provenance
+        },
+        fieldOfView: {
+            horizontalDegrees: horizontalFov.value.degrees,
+            verticalDegrees: verticalFov.value.degrees,
+            diagonalDegrees: diagonalFov.value.degrees
+        },
+        sensor: {
+            pixelPitchMicrometers: pixelPitch.value.micrometers
+        },
+        crop: {
+            cropFactor: request.crop.factor,
+            ...crop.value,
+            effectiveFieldOfView: cropFieldOfView
+        },
+        focusCriterion: equivalentViewingCircleOfConfusion === undefined
+            ? {
+                source: "explicit",
+                circleOfConfusionMm
+            }
+            : {
+                source: "equivalent-viewing-approximation",
+                circleOfConfusionMm,
+                scaleFactor: equivalentViewingCircleOfConfusion.value.scaleFactor,
+                provenance: {
+                    kind: "approximation",
+                    model: equivalentViewingCircleOfConfusion.provenance.model,
+                    modelVersion: equivalentViewingCircleOfConfusion.provenance.modelVersion,
+                    ...(equivalentViewingCircleOfConfusion.provenance.assumptions ===
+                        undefined
+                        ? {}
+                        : {
+                            assumptions: equivalentViewingCircleOfConfusion.provenance.assumptions
+                        })
+                }
+            },
+        depthOfField: depthOfField.value,
+        diffraction: {
+            firstZeroDiameterMicrometers: diffraction.value.firstZeroDiameterMicrometers,
+            airyDiameterPixels: diffraction.value.firstZeroDiameterMicrometers /
+                pixelPitch.value.micrometers,
+            pupilModel: "ideal-circular",
+            provenance: diffraction.provenance
+        },
+        motion: {
+            distanceMm: motion.value.distanceMm,
+            distancePixels: motion.value.distancePixels ?? 0,
+            deltaXMm: motion.value.deltaXMm,
+            deltaYMm: motion.value.deltaYMm,
+            deltaXPixels: motion.value.deltaXMm / (pixelPitch.value.micrometers / 1000),
+            deltaYPixels: motion.value.deltaYMm / (pixelPitch.value.micrometers / 1000)
+        },
+        exposure: {
+            ev100: exposureValue.value,
+            iso: request.exposure.iso
+        },
+        ...(subjectSampling === undefined
+            ? {}
+            : {
+                subjectSampling: {
+                    widthMm: subjectSampling.widthMm,
+                    heightMm: subjectSampling.heightMm,
+                    widthPixels: subjectSampling.widthPixels ?? 0,
+                    heightPixels: subjectSampling.heightPixels ?? 0
+                }
+            }),
+        ...(defocusSamples === undefined ? {} : { defocusSamples }),
+        ...(samplingSamples === undefined ? {} : { samplingSamples }),
+        ...(motionSamples === undefined ? {} : { motionSamples }),
+        ...(subjectCrop === undefined ||
+            subjectCropFieldOfView === undefined ||
+            totalSubjectCropFactor === undefined
+            ? {}
+            : {
+                subjectCrop: {
+                    additionalCropFactor: subjectCrop.cropFactor,
+                    totalCropFactor: totalSubjectCropFactor,
+                    pixelWidth: subjectCrop.pixelWidth,
+                    pixelHeight: subjectCrop.pixelHeight,
+                    megapixels: subjectCrop.megapixels,
+                    subjectHeightFraction: subjectCrop.subjectHeightFraction,
+                    subjectClipped: subjectCrop.subjectClipped,
+                    additionalCropApplied: subjectCrop.cropped,
+                    effectiveFieldOfView: subjectCropFieldOfView
+                }
+            }),
+        ...(apertureShape === undefined
+            ? {}
+            : {
+                apertureShape: {
+                    ...apertureShape.value,
+                    provenance: apertureShape.provenance
+                }
+            }),
+        ...(primarySubjectDiagnostics === undefined
+            ? {}
+            : { primarySubjectDiagnostics }),
+        ...(cameraShake === undefined
+            ? {}
+            : {
+                cameraShake: {
+                    residualMotionFactor: cameraShake.value.residualMotionFactor,
+                    unstabilized: {
+                        deltaXmm: cameraShake.value.unstabilized.deltaXmm,
+                        deltaYmm: cameraShake.value.unstabilized.deltaYmm,
+                        distanceMm: cameraShake.value.unstabilized.distanceMm,
+                        distancePixels: cameraShake.value.unstabilized.distancePixels ?? 0,
+                        deltaXPixels: cameraShake.value.unstabilized.deltaXPixels ?? 0,
+                        deltaYPixels: cameraShake.value.unstabilized.deltaYPixels ?? 0
+                    },
+                    stabilized: {
+                        deltaXmm: cameraShake.value.stabilized.deltaXmm,
+                        deltaYmm: cameraShake.value.stabilized.deltaYmm,
+                        distanceMm: cameraShake.value.stabilized.distanceMm,
+                        distancePixels: cameraShake.value.stabilized.distancePixels ?? 0,
+                        deltaXPixels: cameraShake.value.stabilized.deltaXPixels ?? 0,
+                        deltaYPixels: cameraShake.value.stabilized.deltaYPixels ?? 0
+                    },
+                    provenance: {
+                        kind: "approximation",
+                        model: cameraShake.provenance.model,
+                        modelVersion: cameraShake.provenance.modelVersion,
+                        ...(cameraShake.provenance.assumptions === undefined
+                            ? {}
+                            : { assumptions: cameraShake.provenance.assumptions })
+                    }
+                }
+            }),
+        provenance: {
+            kind: equivalentViewingCircleOfConfusion !== undefined ||
+                cameraShake !== undefined
+                ? "mixed"
+                : "calculated",
+            components: {
+                projection: "calculated",
+                fieldOfView: "calculated",
+                crop: "calculated",
+                focusCriterion: equivalentViewingCircleOfConfusion === undefined
+                    ? "calculated"
+                    : "approximation",
+                depthOfField: "calculated",
+                diffraction: "calculated",
+                motion: "calculated",
+                exposure: "calculated",
+                ...(apertureShape === undefined
+                    ? {}
+                    : { apertureShape: "calculated" }),
+                ...(cameraShake === undefined
+                    ? {}
+                    : { cameraShake: "approximation" })
+            },
+            note: equivalentViewingCircleOfConfusion !== undefined ||
+                cameraShake !== undefined
+                ? "Mixed provenance: calculated analytical models plus explicitly labeled approximations."
+                : "Calculated from Photivra open-engine analytical models."
+        }
+    };
+}
+//# sourceMappingURL=poc-simulation.js.map

package/dist/simulation/poc-simulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poc-simulation.js","sourceRoot":"","sources":["../../src/simulation/poc-simulation.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,0CAA0C,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AA2E3E,SAAS,2BAA2B,CAClC,aAAqB,EACrB,cAAsB,EACtB,aAAqB,EACrB,cAAsB,EACtB,UAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC7D,OAAO;QACL,iBAAiB,EAAE,oBAAoB,CAAC;YACtC,aAAa;YACb,iBAAiB,EAAE,aAAa,GAAG,UAAU;YAC7C,cAAc;SACf,CAAC,CAAC,KAAK,CAAC,OAAO;QAChB,eAAe,EAAE,oBAAoB,CAAC;YACpC,aAAa;YACb,iBAAiB,EAAE,cAAc,GAAG,UAAU;YAC9C,cAAc;SACf,CAAC,CAAC,KAAK,CAAC,OAAO;QAChB,eAAe,EAAE,oBAAoB,CAAC;YACpC,aAAa;YACb,iBAAiB,EAAE,UAAU,GAAG,UAAU;YAC1C,cAAc;SACf,CAAC,CAAC,KAAK,CAAC,OAAO;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAa,EACb,OAA8C;IAE9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAA2B,CACnC,GAAG,KAAK,0BAA0B,CACnC,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,2BAA2B,CACnC,GAAG,KAAK,2CAA2C,YAAY,EAAE,CAClE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AA0LD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA6B;IAE7B,qBAAqB,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,qBAAqB,CAAC,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClE,qBAAqB,CAAC,oBAAoB,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxE,qBAAqB,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,qBAAqB,CACnB,yBAAyB,EACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAChC,CAAC;IACF,qBAAqB,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5D,qBAAqB,CAAC,sBAAsB,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAE5E,MAAM,4BAA4B,GAChC,OAAO,CAAC,KAAK,CAAC,mBAAmB,KAAK,SAAS,CAAC;IAClD,MAAM,6BAA6B,GACjC,OAAO,CAAC,KAAK,CAAC,kCAAkC,KAAK,SAAS,CAAC;IAEjE,IAAI,4BAA4B,KAAK,6BAA6B,EAAE,CAAC;QACnE,MAAM,IAAI,2BAA2B,CACnC,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,kCAAkC,GACtC,OAAO,CAAC,KAAK,CAAC,kCAAkC,KAAK,SAAS;QAC5D,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,0CAA0C,CAAC;YACzC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;YACrC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;YACvC,GAAG,OAAO,CAAC,KAAK,CAAC,kCAAkC;SACpD,CAAC,CAAC;IAET,MAAM,mBAAmB,GACvB,kCAAkC,EAAE,KAAK,CAAC,mBAAmB;QAC7D,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;IAEpC,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,2BAA2B,CACnC,oDAAoD,CACrD,CAAC;IACJ,CAAC;IACD,qBAAqB,CAAC,2BAA2B,EAAE,mBAAmB,CAAC,CAAC;IACxE,qBAAqB,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,qBAAqB,CACnB,0BAA0B,EAC1B,OAAO,CAAC,WAAW,CAAC,YAAY,CACjC,CAAC;IAEF,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,sBAAsB,CAAC,iBAAiB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnE,sBAAsB,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG,8BAA8B,CAAC;QAChD,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;QACzC,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;KAC9C,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,EACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CACxB,CAAC;IAEF,MAAM,aAAa,GAAG,oBAAoB,CAAC;QACzC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;QACzC,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;QACzC,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;KAC7C,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,oBAAoB,CAAC;QACvC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;QACzC,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;QAC1C,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;KAC7C,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,oBAAoB,CAAC;QACvC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;QACzC,iBAAiB,EAAE,UAAU;QAC7B,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;KAC7C,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,mBAAmB,CAAC;QACrC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;QACrC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;KACtC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,qBAAqB,CAAC;QACjC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;QACrC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;QACvC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;KAChC,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,2BAA2B,CACjD,OAAO,CAAC,MAAM,CAAC,OAAO,EACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,EACvB,OAAO,CAAC,IAAI,CAAC,aAAa,EAC1B,OAAO,CAAC,KAAK,CAAC,cAAc,EAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CACpB,CAAC;IAEF,MAAM,YAAY,GAAG,qBAAqB,CAAC;QACzC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;QACzC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;QAC/B,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;QAC5C,mBAAmB;KACpB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,iBAAiB,CAAC;QACpC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;QAC/B,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,YAAY;KAC/C,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,4BAA4B,CAAC;QAC1C,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;QACzC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc;QAC/C,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;QACnC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;QACvC,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;QAC5C,qBAAqB,EAAE,UAAU,CAAC,KAAK,CAAC,WAAW;KACpD,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,yBAAyB,CAAC;QAC9C,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;QAC/B,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc;KAChD,CAAC,CAAC;IAEH,MAAM,eAAe,GACnB,OAAO,CAAC,OAAO,KAAK,SAAS;QAC3B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,4BAA4B,CAAC;YAC3B,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;YACzC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;YACpC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;YACtC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;YACpC,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;YAC5C,qBAAqB,EAAE,UAAU,CAAC,KAAK,CAAC,WAAW;SACpD,CAAC,CAAC,KAAK,CAAC;IAEf,MAAM,eAAe,GACnB,OAAO,CAAC,eAAe,KAAK,SAAS;QACnC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACrC,MAAM,SAAS,GAAG,4BAA4B,CAAC;gBAC7C,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;gBACzC,YAAY,EAAE,MAAM,CAAC,MAAM;gBAC3B,aAAa,EAAE,MAAM,CAAC,OAAO;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;gBAC5C,qBAAqB,EAAE,UAAU,CAAC,KAAK,CAAC,WAAW;aACpD,CAAC,CAAC,KAAK,CAAC;YAET,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,OAAO,EAAE,SAAS,CAAC,OAAO;gBAC1B,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,CAAC;gBACvC,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,CAAC;aAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;IAET,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,KAAK,SAAS;QACjC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACnC,MAAM,SAAS,GAAG,4BAA4B,CAAC;gBAC7C,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;gBACzC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAC/C,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;gBAC5C,qBAAqB,EAAE,UAAU,CAAC,KAAK,CAAC,WAAW;aACpD,CAAC,CAAC;YAEH,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,UAAU;gBACtC,cAAc,EAAE,SAAS,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC;gBACnD,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ;gBAClC,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ;gBAClC,YAAY,EACV,SAAS,CAAC,KAAK,CAAC,QAAQ;oBACxB,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;gBACvC,YAAY,EACV,SAAS,CAAC,KAAK,CAAC,QAAQ;oBACxB,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;aACxC,CAAC;QACJ,CAAC,CAAC,CAAC;IAET,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS;QAChE,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,2BAA2B,CAAC;YAC1B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YACjC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;YACnC,mBAAmB,EAAE,eAAe,CAAC,YAAY,IAAI,CAAC;YACtD,2BAA2B,EACzB,OAAO,CAAC,WAAW,CAAC,2BAA2B;SAClD,CAAC,CAAC,KAAK,CAAC;IAEf,MAAM,sBAAsB,GAC1B,WAAW,KAAK,SAAS;QACvB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC;IACnD,MAAM,sBAAsB,GAC1B,sBAAsB,KAAK,SAAS;QAClC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,2BAA2B,CACzB,OAAO,CAAC,MAAM,CAAC,OAAO,EACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,EACvB,OAAO,CAAC,IAAI,CAAC,aAAa,EAC1B,OAAO,CAAC,KAAK,CAAC,cAAc,EAC5B,sBAAsB,CACvB,CAAC;IAER,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,KAAK,SAAS;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,uBAAuB,CAAC;YACtB,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;YACzC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc;YAC/C,wBAAwB,EACtB,OAAO,CAAC,WAAW,CAAC,wBAAwB;YAC9C,4BAA4B,EAC1B,OAAO,CAAC,WAAW,CAAC,4BAA4B;YAClD,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;YAC5C,qBAAqB,EAAE,UAAU,CAAC,KAAK,CAAC,WAAW;SACpD,CAAC,CAAC;IAET,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,KAAK,SAAS;QACjC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,8BAA8B,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5D,MAAM,uBAAuB,GAC3B,OAAO,CAAC,WAAW,EAAE,qBAAqB,KAAK,SAAS;QACtD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,aAAa,EAAE,IAAI,CACjB,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,qBAAqB,CAC3D,CAAC;IAER,IACE,OAAO,CAAC,WAAW,EAAE,qBAAqB,KAAK,SAAS;QACxD,uBAAuB,KAAK,SAAS,EACrC,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,8CAA8C,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,CAC1F,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAClB,OAAO,CAAC,OAAO,KAAK,SAAS;QAC3B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,sBAAsB,CAAC;YACrB,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;YACzC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;YAC/B,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;YAC5C,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;SAC5C,CAAC,CAAC,KAAK,CAAC;IAEf,MAAM,yBAAyB,GAC7B,OAAO,CAAC,OAAO,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,cAAc,KAAK,SAAS;QAC1B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACE,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;YAC3C,oBAAoB,EAAE,eAAe,CAAC,YAAY,IAAI,CAAC;YACvD,qBAAqB,EACnB,cAAc,CAAC,UAAU;gBACzB,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;YACvC,kCAAkC,EAChC,WAAW,CAAC,KAAK,CAAC,4BAA4B;gBAC9C,UAAU,CAAC,KAAK,CAAC,WAAW;YAC9B,gBAAgB,EAAE,WAAW,CAAC,UAAU,CAAC,KAAK;YAC9C,GAAG,CAAC,uBAAuB,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,aAAa,EAAE;wBACb,EAAE,EAAE,uBAAuB,CAAC,EAAE;wBAC9B,cAAc,EAAE,uBAAuB,CAAC,cAAc;qBACvD;iBACF,CAAC;YACN,GAAG,CAAC,WAAW,KAAK,SAAS;gBAC3B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,WAAW,EAAE;wBACX,wBAAwB,EACtB,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,IAAI,CAAC;wBAClD,cAAc,EAAE,eAAwB;qBACzC;iBACF,CAAC;YACN,iBAAiB,EACf,gLAAgL;SACnL,CAAC;IAER,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc,KAAK,SAAS;QAClC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACpC,qBAAqB,CACnB,4BAA4B,EAC5B,MAAM,CAAC,SAAS,CACjB,CAAC;YAEF,MAAM,OAAO,GAAG,sBAAsB,CAAC;gBACrC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa;gBACzC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;gBAC/B,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;gBAC5C,gBAAgB,EAAE,MAAM,CAAC,SAAS;aACnC,CAAC,CAAC;YAEH,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU;gBACpC,cAAc,EACZ,OAAO,CAAC,KAAK,CAAC,UAAU;oBACxB,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;aACxC,CAAC;QACJ,CAAC,CAAC,CAAC;IAET,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,uBAAuB;YAC7B,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;YAC5C,eAAe,EAAE,UAAU,CAAC,KAAK,CAAC,eAAe;YACjD,uBAAuB,EAAE,UAAU,CAAC,KAAK,CAAC,uBAAuB;YACjE,UAAU,EAAE,UAAU,CAAC,UAAU;SAClC;QACD,WAAW,EAAE;YACX,iBAAiB,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO;YAC9C,eAAe,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO;YAC1C,eAAe,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO;SAC3C;QACD,MAAM,EAAE;YACN,qBAAqB,EAAE,UAAU,CAAC,KAAK,CAAC,WAAW;SACpD;QACD,IAAI,EAAE;YACJ,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,oBAAoB,EAAE,eAAe;SACtC;QACD,cAAc,EACZ,kCAAkC,KAAK,SAAS;YAC9C,CAAC,CAAC;gBACE,MAAM,EAAE,UAAU;gBAClB,mBAAmB;aACpB;YACH,CAAC,CAAC;gBACE,MAAM,EAAE,kCAAkC;gBAC1C,mBAAmB;gBACnB,WAAW,EACT,kCAAkC,CAAC,KAAK,CAAC,WAAW;gBACtD,UAAU,EAAE;oBACV,IAAI,EAAE,eAAe;oBACrB,KAAK,EAAE,kCAAkC,CAAC,UAAU,CAAC,KAAK;oBAC1D,YAAY,EACV,kCAAkC,CAAC,UAAU,CAAC,YAAY;oBAC5D,GAAG,CAAC,kCAAkC,CAAC,UAAU,CAAC,WAAW;wBAC7D,SAAS;wBACP,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE,WAAW,EACT,kCAAkC,CAAC,UAAU,CAAC,WAAW;yBAC5D,CAAC;iBACP;aACF;QACP,YAAY,EAAE,YAAY,CAAC,KAAK;QAChC,WAAW,EAAE;YACX,4BAA4B,EAC1B,WAAW,CAAC,KAAK,CAAC,4BAA4B;YAChD,kBAAkB,EAChB,WAAW,CAAC,KAAK,CAAC,4BAA4B;gBAC9C,UAAU,CAAC,KAAK,CAAC,WAAW;YAC9B,UAAU,EAAE,gBAAgB;YAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;SACnC;QACD,MAAM,EAAE;YACN,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;YACnC,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC;YAChD,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;YAC/B,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;YAC/B,YAAY,EACV,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;YAC/D,YAAY,EACV,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;SAChE;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,aAAa,CAAC,KAAK;YAC1B,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG;SAC1B;QACD,GAAG,CAAC,eAAe,KAAK,SAAS;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,eAAe,EAAE;oBACf,OAAO,EAAE,eAAe,CAAC,OAAO;oBAChC,QAAQ,EAAE,eAAe,CAAC,QAAQ;oBAClC,WAAW,EAAE,eAAe,CAAC,WAAW,IAAI,CAAC;oBAC7C,YAAY,EAAE,eAAe,CAAC,YAAY,IAAI,CAAC;iBAChD;aACF,CAAC;QACN,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3D,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7D,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;QACzD,GAAG,CAAC,WAAW,KAAK,SAAS;YAC7B,sBAAsB,KAAK,SAAS;YACpC,sBAAsB,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,WAAW,EAAE;oBACX,oBAAoB,EAAE,WAAW,CAAC,UAAU;oBAC5C,eAAe,EAAE,sBAAsB;oBACvC,UAAU,EAAE,WAAW,CAAC,UAAU;oBAClC,WAAW,EAAE,WAAW,CAAC,WAAW;oBACpC,UAAU,EAAE,WAAW,CAAC,UAAU;oBAClC,qBAAqB,EAAE,WAAW,CAAC,qBAAqB;oBACxD,cAAc,EAAE,WAAW,CAAC,cAAc;oBAC1C,qBAAqB,EAAE,WAAW,CAAC,OAAO;oBAC1C,oBAAoB,EAAE,sBAAsB;iBAC7C;aACF,CAAC;QACN,GAAG,CAAC,aAAa,KAAK,SAAS;YAC7B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,aAAa,EAAE;oBACb,GAAG,aAAa,CAAC,KAAK;oBACtB,UAAU,EAAE,aAAa,CAAC,UAAU;iBACrC;aACF,CAAC;QACN,GAAG,CAAC,yBAAyB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,yBAAyB,EAAE,CAAC;QAClC,GAAG,CAAC,WAAW,KAAK,SAAS;YAC3B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,WAAW,EAAE;oBACX,oBAAoB,EAAE,WAAW,CAAC,KAAK,CAAC,oBAAoB;oBAC5D,YAAY,EAAE;wBACZ,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ;wBACjD,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ;wBACjD,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU;wBACrD,cAAc,EACZ,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,IAAI,CAAC;wBACpD,YAAY,EACV,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,IAAI,CAAC;wBAClD,YAAY,EACV,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,IAAI,CAAC;qBACnD;oBACD,UAAU,EAAE;wBACV,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ;wBAC/C,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ;wBAC/C,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;wBACnD,cAAc,EACZ,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,IAAI,CAAC;wBAClD,YAAY,EACV,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,IAAI,CAAC;wBAChD,YAAY,EACV,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,IAAI,CAAC;qBACjD;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,eAAe;wBACrB,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,KAAK;wBACnC,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,YAAY;wBACjD,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,KAAK,SAAS;4BAClD,CAAC,CAAC,EAAE;4BACJ,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;qBACzD;iBACF;aACF,CAAC;QACN,UAAU,EAAE;YACV,IAAI,EACF,kCAAkC,KAAK,SAAS;gBAChD,WAAW,KAAK,SAAS;gBACvB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,YAAY;YAClB,UAAU,EAAE;gBACV,UAAU,EAAE,YAAY;gBACxB,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,YAAY;gBAClB,cAAc,EACZ,kCAAkC,KAAK,SAAS;oBAC9C,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,eAAe;gBACrB,YAAY,EAAE,YAAY;gBAC1B,WAAW,EAAE,YAAY;gBACzB,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE,YAAY;gBACtB,GAAG,CAAC,aAAa,KAAK,SAAS;oBAC7B,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,aAAa,EAAE,YAAqB,EAAE,CAAC;gBAC7C,GAAG,CAAC,WAAW,KAAK,SAAS;oBAC3B,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,eAAwB,EAAE,CAAC;aAC/C;YACD,IAAI,EACF,kCAAkC,KAAK,SAAS;gBAChD,WAAW,KAAK,SAAS;gBACvB,CAAC,CAAC,wFAAwF;gBAC1F,CAAC,CAAC,yDAAyD;SAChE;KACF,CAAC;AACJ,CAAC"}

package/dist/stabilization/camera-shake.d.ts

@@ -0,0 +1,41 @@
+import { type CalculationResult } from "../core/calculation-result.js";
+export interface EstimateCameraShakeBlurInput {
+    focalLengthMm: number;
+    shutterSeconds: number;
+    angularVelocityRadPerSec: {
+        yaw: number;
+        pitch: number;
+    };
+    stabilizationStopsEquivalent: number;
+    /** Optional focus distance in metres for focus-aware sensor-plane projection. */
+    focusDistanceM?: number;
+    pixelPitchMicrometers?: number;
+}
+export interface CameraShakeBlurSample {
+    deltaXmm: number;
+    deltaYmm: number;
+    distanceMm: number;
+    distancePixels?: number;
+    deltaXPixels?: number;
+    deltaYPixels?: number;
+}
+export interface CameraShakeEstimate {
+    residualMotionFactor: number;
+    projectionDistanceMm: number;
+    unstabilized: CameraShakeBlurSample;
+    stabilized: CameraShakeBlurSample;
+}
+/**
+ * Estimates sensor-plane blur from a controlled constant-angular-velocity
+ * handheld shake profile, with optional equivalent stabilization attenuation.
+ *
+ * With focusDistanceM supplied, angular motion is projected using the same
+ * ideal thin-lens sensor-plane distance as the other focus-aware projection
+ * primitives; otherwise nominal focal length preserves the prior approximation.
+ *
+ * The optical projection is physically calculated, but mapping a stabilization
+ * rating in stops to residual angular motion by 2^-stops is an educational
+ * approximation. It is not a CIPA DC-011 measurement or a real-camera rating.
+ */
+export declare function estimateCameraShakeBlur(input: EstimateCameraShakeBlurInput): CalculationResult<CameraShakeEstimate>;
+//# sourceMappingURL=camera-shake.d.ts.map

package/dist/stabilization/camera-shake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-shake.d.ts","sourceRoot":"","sources":["../../src/stabilization/camera-shake.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAOvC,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE;QACxB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,4BAA4B,EAAE,MAAM,CAAC;IACrC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,qBAAqB,CAAC;IACpC,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAiCD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,iBAAiB,CAAC,mBAAmB,CAAC,CA4ExC"}

package/dist/stabilization/camera-shake.js

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: Apache-2.0
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError, requirePositiveFinite } from "../core/validation.js";
+import { calculateThinLensImageDistance } from "../optics/thin-lens.js";
+function requireFinite(name, value) {
+    if (!Number.isFinite(value)) {
+        throw new InvalidScientificInputError(`${name} must be finite.`);
+    }
+}
+function projectAngularDisplacement(projectionDistanceMm, yawRad, pitchRad, pixelPitchMicrometers) {
+    const deltaXmm = projectionDistanceMm * Math.tan(yawRad);
+    const deltaYmm = projectionDistanceMm * Math.tan(pitchRad);
+    const distanceMm = Math.hypot(deltaXmm, deltaYmm);
+    if (pixelPitchMicrometers === undefined) {
+        return { deltaXmm, deltaYmm, distanceMm };
+    }
+    const pitchMm = pixelPitchMicrometers / 1000;
+    return {
+        deltaXmm,
+        deltaYmm,
+        distanceMm,
+        distancePixels: distanceMm / pitchMm,
+        deltaXPixels: deltaXmm / pitchMm,
+        deltaYPixels: deltaYmm / pitchMm
+    };
+}
+/**
+ * Estimates sensor-plane blur from a controlled constant-angular-velocity
+ * handheld shake profile, with optional equivalent stabilization attenuation.
+ *
+ * With focusDistanceM supplied, angular motion is projected using the same
+ * ideal thin-lens sensor-plane distance as the other focus-aware projection
+ * primitives; otherwise nominal focal length preserves the prior approximation.
+ *
+ * The optical projection is physically calculated, but mapping a stabilization
+ * rating in stops to residual angular motion by 2^-stops is an educational
+ * approximation. It is not a CIPA DC-011 measurement or a real-camera rating.
+ */
+export function estimateCameraShakeBlur(input) {
+    requirePositiveFinite("focalLengthMm", input.focalLengthMm);
+    requirePositiveFinite("shutterSeconds", input.shutterSeconds);
+    requireFinite("angularVelocityRadPerSec.yaw", input.angularVelocityRadPerSec.yaw);
+    requireFinite("angularVelocityRadPerSec.pitch", input.angularVelocityRadPerSec.pitch);
+    if (!Number.isFinite(input.stabilizationStopsEquivalent) ||
+        input.stabilizationStopsEquivalent < 0) {
+        throw new InvalidScientificInputError("stabilizationStopsEquivalent must be finite and greater than or equal to zero.");
+    }
+    if (input.pixelPitchMicrometers !== undefined) {
+        requirePositiveFinite("pixelPitchMicrometers", input.pixelPitchMicrometers);
+    }
+    const focusProjection = input.focusDistanceM === undefined
+        ? undefined
+        : calculateThinLensImageDistance({
+            focalLengthMm: input.focalLengthMm,
+            objectDistanceM: input.focusDistanceM
+        });
+    const projectionDistanceMm = focusProjection?.value.imageDistanceMm ?? input.focalLengthMm;
+    const yawRad = input.angularVelocityRadPerSec.yaw * input.shutterSeconds;
+    const pitchRad = input.angularVelocityRadPerSec.pitch * input.shutterSeconds;
+    const residualMotionFactor = 2 ** -input.stabilizationStopsEquivalent;
+    return approximationResult({
+        residualMotionFactor,
+        projectionDistanceMm,
+        unstabilized: projectAngularDisplacement(projectionDistanceMm, yawRad, pitchRad, input.pixelPitchMicrometers),
+        stabilized: projectAngularDisplacement(projectionDistanceMm, yawRad * residualMotionFactor, pitchRad * residualMotionFactor, input.pixelPitchMicrometers)
+    }, focusProjection === undefined
+        ? "constant-angular-velocity-stabilization-equivalent"
+        : "focus-aware-constant-angular-velocity-stabilization-equivalent", "1.0.0", [
+        "Camera rotation is constant during the exposure",
+        focusProjection === undefined
+            ? "Nominal focal length is used as the infinity-focus projection distance"
+            : "Thin-lens image distance for the selected focus plane is used as the projection distance",
+        "Yaw and pitch are treated independently",
+        "Equivalent stabilization stops attenuate angular displacement by 2^-stops",
+        "This is not a CIPA DC-011 compliance measurement",
+        "Roll, translation, subject motion, and stabilization limits are not modeled"
+    ]);
+}
+//# sourceMappingURL=camera-shake.js.map

package/dist/stabilization/camera-shake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-shake.js","sourceRoot":"","sources":["../../src/stabilization/camera-shake.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,mBAAmB,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AA+BxE,SAAS,aAAa,CAAC,IAAY,EAAE,KAAa;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,2BAA2B,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CACjC,oBAA4B,EAC5B,MAAc,EACd,QAAgB,EAChB,qBAA8B;IAE9B,MAAM,QAAQ,GAAG,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAElD,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,OAAO,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAC7C,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,cAAc,EAAE,UAAU,GAAG,OAAO;QACpC,YAAY,EAAE,QAAQ,GAAG,OAAO;QAChC,YAAY,EAAE,QAAQ,GAAG,OAAO;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAmC;IAEnC,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5D,qBAAqB,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9D,aAAa,CACX,8BAA8B,EAC9B,KAAK,CAAC,wBAAwB,CAAC,GAAG,CACnC,CAAC;IACF,aAAa,CACX,gCAAgC,EAChC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CACrC,CAAC;IAEF,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,4BAA4B,CAAC;QACpD,KAAK,CAAC,4BAA4B,GAAG,CAAC,EACtC,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,qBAAqB,KAAK,SAAS,EAAE,CAAC;QAC9C,qBAAqB,CACnB,uBAAuB,EACvB,KAAK,CAAC,qBAAqB,CAC5B,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GACnB,KAAK,CAAC,cAAc,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,8BAA8B,CAAC;YAC7B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,eAAe,EAAE,KAAK,CAAC,cAAc;SACtC,CAAC,CAAC;IACT,MAAM,oBAAoB,GACxB,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,aAAa,CAAC;IAChE,MAAM,MAAM,GACV,KAAK,CAAC,wBAAwB,CAAC,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC;IAC5D,MAAM,QAAQ,GACZ,KAAK,CAAC,wBAAwB,CAAC,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC;IAC9D,MAAM,oBAAoB,GACxB,CAAC,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC;IAE3C,OAAO,mBAAmB,CACxB;QACE,oBAAoB;QACpB,oBAAoB;QACpB,YAAY,EAAE,0BAA0B,CACtC,oBAAoB,EACpB,MAAM,EACN,QAAQ,EACR,KAAK,CAAC,qBAAqB,CAC5B;QACD,UAAU,EAAE,0BAA0B,CACpC,oBAAoB,EACpB,MAAM,GAAG,oBAAoB,EAC7B,QAAQ,GAAG,oBAAoB,EAC/B,KAAK,CAAC,qBAAqB,CAC5B;KACF,EACD,eAAe,KAAK,SAAS;QAC3B,CAAC,CAAC,oDAAoD;QACtD,CAAC,CAAC,gEAAgE,EACpE,OAAO,EACP;QACE,iDAAiD;QACjD,eAAe,KAAK,SAAS;YAC3B,CAAC,CAAC,wEAAwE;YAC1E,CAAC,CAAC,0FAA0F;QAC9F,yCAAyC;QACzC,2EAA2E;QAC3E,kDAAkD;QAClD,6EAA6E;KAC9E,CACF,CAAC;AACJ,CAAC"}