@photivra/engine 0.6.0 → 1.0.0

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

@@ -1 +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"}
+{"version":3,"file":"camera-shake.d.ts","sourceRoot":"","sources":["../../src/stabilization/camera-shake.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,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

@@ -1,4 +1,15 @@
 // SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * 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.
+ * @see docs/STABILIZATION.md for equations, coordinate/unit conventions, blockers and support limits.
+ */
 import { approximationResult } from "../core/calculation-result.js";
 import { InvalidScientificInputError, requirePositiveFinite } from "../core/validation.js";
 import { calculateThinLensImageDistance } from "../optics/thin-lens.js";

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

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

package/dist/stabilization/system.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Module boundary and integration notes.
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary. Generic
+ * stabilization evaluates declared angular disturbance with per-axis response, latency, limits and
+ * panning policy. Residual motion feeds the existing temporal mapping; no commercial IBIS/OIS
+ * calibration, arbitrary stop rating or inferred coordination is supplied.
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary. Generic
+ * stabilization evaluates declared angular disturbance with per-axis response, latency, limits and
+ * panning policy. Residual motion feeds the existing temporal mapping; no commercial IBIS/OIS
+ * calibration, arbitrary stop rating or inferred coordination is supplied.
+ * @see docs/STABILIZATION.md for equations, coordinate/unit conventions, blockers and support limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type EvidenceBackedFact, type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { RasterPoint } from "../output/capture-geometry.js";
+import type { ResolvedCaptureModeTiming } from "../sensor/capture-mode-timing.js";
+export declare const STABILIZATION_SYSTEM_PROFILE_SCHEMA_VERSION: "0.1.0";
+export declare const STABILIZATION_DISTURBANCE_TRAJECTORY_VERSION: "0.1.0";
+export type StabilizationRotationAxis = "pitch" | "yaw" | "roll";
+export type PhysicalStabilizationArchitecture = "off" | "sensor-shift" | "lens-optical" | "coordinated-physical";
+export type StabilizationCaptureKind = "still" | "video";
+export interface StabilizationAngularStateRad {
+    pitch: number;
+    yaw: number;
+    roll: number;
+}
+export interface StabilizationDisturbanceSample {
+    timeSecondsFromCaptureReference: number;
+    angularDisplacementRad: StabilizationAngularStateRad;
+}
+export interface StabilizationDisturbanceTrajectory {
+    version: typeof STABILIZATION_DISTURBANCE_TRAJECTORY_VERSION;
+    trajectoryId: string;
+    timeReference: "first-opening-boundary-phase";
+    samples: readonly StabilizationDisturbanceSample[];
+    initialAngularDisplacementIsZero: true;
+    cameraTranslationIncluded: false;
+    subjectMotionIncluded: false;
+    supportStateEncoded: false;
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+export interface StabilizationAxisResponseProfile {
+    axis: StabilizationRotationAxis;
+    correctionGain: EvidenceBackedFact<number>;
+    latencySeconds: EvidenceBackedFact<number>;
+    maximumCorrectionAngleRad: EvidenceBackedFact<number>;
+}
+export type StabilizationPanningPolicy = {
+    kind: "none";
+} | {
+    kind: "declared-axis-bypass";
+    axis: StabilizationRotationAxis;
+    evidence: readonly EvidenceProvenance[];
+};
+export interface StabilizationCoordinatedAllocation {
+    bodyFraction: number;
+    lensFraction: number;
+    evidence: readonly EvidenceProvenance[];
+    totalCorrectionAppliedOnce: true;
+}
+export interface StabilizationSystemProfile {
+    schemaVersion: typeof STABILIZATION_SYSTEM_PROFILE_SCHEMA_VERSION;
+    profileId: string;
+    profileVersion: string;
+    profileKind: "generic-synthetic";
+    scientificStatus: "approximation";
+    architecture: PhysicalStabilizationArchitecture;
+    captureKind: StabilizationCaptureKind;
+    axisResponses: readonly StabilizationAxisResponseProfile[];
+    panningPolicy: StabilizationPanningPolicy;
+    coordinatedAllocation?: StabilizationCoordinatedAllocation;
+    controlTransientModeled: false;
+    spontaneousDriftModeled: false;
+    cameraTranslationCorrectionModeled: false;
+    digitalStabilizationIncluded: false;
+    supportPolicyIncluded: false;
+    stopRatingUsedAsDynamicResponse: false;
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+export interface CalculateStabilizedRotationTrajectoryInput {
+    disturbance: StabilizationDisturbanceTrajectory;
+    profile: StabilizationSystemProfile;
+    captureKind: StabilizationCaptureKind;
+}
+export interface StabilizationAxisResolution {
+    axis: StabilizationRotationAxis;
+    disturbanceAngleRad: number;
+    delayedMeasuredAngleRad: number;
+    requestedCorrectionAngleRad: number;
+    appliedCorrectionAngleRad: number;
+    residualAngleRad: number;
+    correctionGain: number;
+    latencySeconds: number;
+    maximumCorrectionAngleRad: number;
+    bypassedForDeclaredPan: boolean;
+    correctionLimitReached: boolean;
+}
+export interface StabilizedRotationSample {
+    timeSecondsFromCaptureReference: number;
+    disturbanceAngularDisplacementRad: StabilizationAngularStateRad;
+    appliedCorrectionAngularDisplacementRad: StabilizationAngularStateRad;
+    residualAngularDisplacementRad: StabilizationAngularStateRad;
+    axes: readonly StabilizationAxisResolution[];
+}
+export interface StabilizedRotationTrajectory {
+    profileId: string;
+    profileVersion: string;
+    trajectoryId: string;
+    architecture: PhysicalStabilizationArchitecture;
+    captureKind: StabilizationCaptureKind;
+    timeReference: "first-opening-boundary-phase";
+    samples: readonly StabilizedRotationSample[];
+    correctionModel: "delayed-linear-image-equivalent-angular-response";
+    supportStateConsumed: false;
+    translationCorrectionModeled: false;
+    digitalStabilizationApplied: false;
+    digitalStabilizationOwnedBy: "downstream-geometric-correction-composition";
+    coordinatedCorrectionDoubleCounted: false;
+    zeroDisturbanceCanCreateMotion: false;
+}
+export interface CalculateStabilizedCaptureTemporalSamplesInput {
+    disturbance: StabilizationDisturbanceTrajectory;
+    profile: StabilizationSystemProfile;
+    captureKind: StabilizationCaptureKind;
+    timing: ResolvedCaptureModeTiming;
+    samplePointsNative: readonly RasterPoint[];
+    temporalSampleCount: number;
+}
+export interface StabilizedCaptureTemporalNode {
+    temporalSampleIndex: number;
+    localExposurePhase: number;
+    captureTimeSecondsFromReference: number;
+    normalizedTimeWeight: number;
+    timeMeasureSeconds: number;
+    stabilization: StabilizedRotationSample;
+}
+export interface StabilizedCaptureTemporalPoint {
+    destinationPointNative: RasterPoint;
+    localExposureWindow: {
+        startSecondsFromCaptureReference: number;
+        endSecondsFromCaptureReference: number;
+        durationSeconds: number;
+    };
+    nodes: readonly StabilizedCaptureTemporalNode[];
+}
+export interface StabilizedCaptureTemporalSamples {
+    profileId: string;
+    trajectoryId: string;
+    captureModeId: string;
+    timingProfileId: string;
+    captureKind: StabilizationCaptureKind;
+    architecture: PhysicalStabilizationArchitecture;
+    timeReference: "first-opening-boundary-phase";
+    quadratureScheme: "uniform-midpoint";
+    temporalSampleCount: number;
+    points: readonly StabilizedCaptureTemporalPoint[];
+    sensorReadoutTimingUsedAsExposureTiming: false;
+    supportStateConsumed: false;
+    translationCorrectionModeled: false;
+    digitalStabilizationApplied: false;
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Generic stabilization evaluates declared angular disturbance with per-axis response, latency, limits
+ * and panning policy. Residual motion feeds the existing temporal mapping; no commercial IBIS/OIS
+ * calibration, arbitrary stop rating or inferred coordination is supplied.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns StabilizationSystemProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function parseStabilizationSystemProfile(value: unknown): StabilizationSystemProfile;
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Generic stabilization evaluates declared angular disturbance with per-axis response, latency, limits
+ * and panning policy. Residual motion feeds the existing temporal mapping; no commercial IBIS/OIS
+ * calibration, arbitrary stop rating or inferred coordination is supplied.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns StabilizationDisturbanceTrajectory. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function parseStabilizationDisturbanceTrajectory(value: unknown): StabilizationDisturbanceTrajectory;
+/**
+ * Evaluate the declared generic per-axis controller against an explicit angular disturbance trajectory
+ * and return residual motion with latency/limit diagnostics.
+ *
+ * Generic stabilization evaluates declared angular disturbance with per-axis response, latency, limits
+ * and panning policy. Residual motion feeds the existing temporal mapping; no commercial IBIS/OIS
+ * calibration, arbitrary stop rating or inferred coordination is supplied.
+ * @param input - CalculateStabilizedRotationTrajectoryInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<StabilizedRotationTrajectory>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function calculateStabilizedRotationTrajectory(input: CalculateStabilizedRotationTrajectoryInput): CalculationResult<StabilizedRotationTrajectory>;
+/**
+ * Feed the residual stabilized rotation into the existing local-exposure temporal mapping without
+ * changing shutter timing or inventing a blur radius.
+ *
+ * Generic stabilization evaluates declared angular disturbance with per-axis response, latency, limits
+ * and panning policy. Residual motion feeds the existing temporal mapping; no commercial IBIS/OIS
+ * calibration, arbitrary stop rating or inferred coordination is supplied.
+ * @param input - CalculateStabilizedCaptureTemporalSamplesInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<StabilizedCaptureTemporalSamples>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function calculateStabilizedCaptureTemporalSamples(input: CalculateStabilizedCaptureTemporalSamplesInput): CalculationResult<StabilizedCaptureTemporalSamples>;
+//# sourceMappingURL=system.d.ts.map

package/dist/stabilization/system.d.ts.map

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