@photivra/engine 0.5.1 → 1.0.0

package/dist/sensor/raw-reconstruction.js.map

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

package/dist/sensor/readout-exposure-linkage.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Module boundary and integration notes.
+ * Assesses an explicitly declared relationship between rolling sensor readout spatial phase and one or
+ * more electronic exposure-boundary scans. This contract is deliberately weaker than temporal
+ * synchronization. It can establish that two schedules traverse the same native spatial phase ordering
+ * (or its reverse), but it does not establish when sensor data readout occurs relative to exposure
+ * start/end. The total capture data-readout duration is preserved diagnostically and is never used to
+ * validate the relationship. Different rolling-readout spatial skew and exposure-boundary traversal
+ * durations are allowed; their ratio is reported without implying a shared clock origin.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { type CalculationProvenance, type CalculationResult } from "../core/calculation-result.js";
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { RasterPoint, RasterRect } from "../output/capture-geometry.js";
+import { type ExposureBoundarySchedule, type SourcedCaptureTimingSeconds } from "./exposure-window.js";
+import { type CaptureShutterMechanism, type NativeSensorReadoutScanDirection, type SensorReadoutTimingDeclaration, type SourcedSensorTimingSeconds } from "./readout-timing.js";
+import type { NativeImageRaster } from "./sensor-geometry.js";
+export type ReadoutExposureBoundaryId = "opening" | "closing";
+export type ReadoutExposureSpatialPhaseOrientation = "same" | "reversed";
+export interface ReadoutExposureBoundarySpatialLink {
+    boundary: ReadoutExposureBoundaryId;
+    /**
+     * Relationship between normalized rolling-readout scan phase and the
+     * selected electronic exposure-boundary scan phase.
+     *
+     * "same": boundary normalized phase = readout normalized phase.
+     * "reversed": boundary normalized phase = 1 - readout normalized phase.
+     *
+     * This does not establish absolute temporal synchronization.
+     */
+    phaseOrientation: ReadoutExposureSpatialPhaseOrientation;
+    /**
+     * Evidence supporting the relationship itself.
+     *
+     * The readout direction/timing and exposure-boundary direction/timing retain
+     * their own separate evidence.
+     */
+    evidence: readonly EvidenceProvenance[];
+}
+export type ReadoutExposureTimingLinkageDeclaration = {
+    /**
+     * Photivra asserts no readout↔exposure relationship for this capture.
+     * This is not evidence that the physical processes are independent.
+     */
+    kind: "unlinked";
+    links?: never;
+} | {
+    /**
+     * One or more exposure boundaries are explicitly related to rolling
+     * readout by normalized native-sensor spatial phase.
+     */
+    kind: "spatial-phase-linked";
+    links: readonly ReadoutExposureBoundarySpatialLink[];
+};
+export interface AssessReadoutExposureTimingLinkageInput {
+    nativeRaster: NativeImageRaster;
+    activeCaptureRect?: RasterRect;
+    shutterMechanism: CaptureShutterMechanism;
+    readout: SensorReadoutTimingDeclaration;
+    nominalExposureDurationSeconds: SourcedCaptureTimingSeconds;
+    opening: ExposureBoundarySchedule;
+    closing: ExposureBoundarySchedule;
+    linkage: ReadoutExposureTimingLinkageDeclaration;
+    samplePointsNative?: readonly RasterPoint[];
+}
+export interface ReadoutExposureBoundarySpatialLinkAssessment {
+    boundary: ReadoutExposureBoundaryId;
+    boundaryActuator: "electronic";
+    phaseOrientation: ReadoutExposureSpatialPhaseOrientation;
+    normalizedPhaseRelationship: "boundary-phase-equals-readout-phase" | "boundary-phase-equals-one-minus-readout-phase";
+    relationshipEvidence: readonly EvidenceProvenance[];
+    readoutDirectionNative: NativeSensorReadoutScanDirection;
+    boundaryDirectionNative: NativeSensorReadoutScanDirection;
+    /**
+     * First-to-last rolling sensor spatial sampling skew.
+     */
+    readoutSpatialSamplingSkewSeconds: SourcedSensorTimingSeconds;
+    /**
+     * First-to-last exposure-boundary traversal duration.
+     */
+    boundaryTraversalDurationSeconds: SourcedCaptureTimingSeconds;
+    /**
+     * Derived descriptive ratio only. A value of 1 does not prove temporal
+     * synchronization or a common clock origin.
+     */
+    boundaryTraversalToReadoutSpatialSkewRatio: number;
+    absoluteTemporalAlignment: "not-established";
+}
+export interface ReadoutExposureTimingLinkageAssessment {
+    linkageKind: ReadoutExposureTimingLinkageDeclaration["kind"];
+    relationshipMeaning: "no-readout-exposure-relationship-asserted" | "normalized-spatial-phase-relationship-asserted";
+    readoutMode: "rolling" | "global";
+    shutterMechanism: CaptureShutterMechanism;
+    activeCaptureRect: RasterRect;
+    absoluteTemporalAlignment: "not-established";
+    /**
+     * Capture data-readout duration is preserved for diagnostics but is not used
+     * to validate any exposure-boundary linkage.
+     */
+    captureReadoutDurationSeconds: SourcedSensorTimingSeconds;
+    links: readonly ReadoutExposureBoundarySpatialLinkAssessment[];
+    componentProvenance: {
+        sensorReadout: CalculationProvenance;
+        exposureWindows: CalculationProvenance;
+    };
+}
+/**
+ * Assesses an explicitly declared relationship between rolling sensor readout
+ * spatial phase and one or more electronic exposure-boundary scans.
+ *
+ * This contract is deliberately weaker than temporal synchronization. It can
+ * establish that two schedules traverse the same native spatial phase ordering
+ * (or its reverse), but it does not establish when sensor data readout occurs
+ * relative to exposure start/end.
+ *
+ * The total capture data-readout duration is preserved diagnostically and is
+ * never used to validate the relationship. Different rolling-readout spatial
+ * skew and exposure-boundary traversal durations are allowed; their ratio is
+ * reported without implying a shared clock origin.
+ */
+export declare function assessReadoutExposureTimingLinkage(input: AssessReadoutExposureTimingLinkageInput): CalculationResult<ReadoutExposureTimingLinkageAssessment>;
+//# sourceMappingURL=readout-exposure-linkage.d.ts.map

package/dist/sensor/readout-exposure-linkage.d.ts.map

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

package/dist/sensor/readout-exposure-linkage.js

@@ -0,0 +1,222 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Assesses an explicitly declared relationship between rolling sensor readout spatial phase and one or
+ * more electronic exposure-boundary scans. This contract is deliberately weaker than temporal
+ * synchronization. It can establish that two schedules traverse the same native spatial phase ordering
+ * (or its reverse), but it does not establish when sensor data readout occurs relative to exposure
+ * start/end. The total capture data-readout duration is preserved diagnostically and is never used to
+ * validate the relationship. Different rolling-readout spatial skew and exposure-boundary traversal
+ * durations are allowed; their ratio is reported without implying a shared clock origin.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { approximationResult } from "../core/calculation-result.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { calculateCaptureExposureWindows } from "./exposure-window.js";
+import { calculateSensorReadoutTiming } from "./readout-timing.js";
+const BOUNDARIES = new Set([
+    "opening",
+    "closing"
+]);
+const PHASE_ORIENTATIONS = new Set([
+    "same",
+    "reversed"
+]);
+function requireRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new InvalidScientificInputError(path + " must be an object.");
+    }
+    return value;
+}
+function parseSpatialLink(value, path) {
+    const record = requireRecord(value, path);
+    if (typeof record.boundary !== "string" ||
+        !BOUNDARIES.has(record.boundary)) {
+        throw new InvalidScientificInputError(path + ".boundary is invalid.");
+    }
+    if (typeof record.phaseOrientation !== "string" ||
+        !PHASE_ORIENTATIONS.has(record.phaseOrientation)) {
+        throw new InvalidScientificInputError(path + ".phaseOrientation is invalid.");
+    }
+    return {
+        boundary: record.boundary,
+        phaseOrientation: record.phaseOrientation,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseLinkageDeclaration(value) {
+    const record = requireRecord(value, "linkage");
+    if (record.kind === "unlinked") {
+        if (record.links !== undefined) {
+            throw new InvalidScientificInputError("linkage.links must be omitted when linkage.kind is unlinked.");
+        }
+        return { kind: "unlinked" };
+    }
+    if (record.kind !== "spatial-phase-linked") {
+        throw new InvalidScientificInputError("linkage.kind is invalid.");
+    }
+    if (!Array.isArray(record.links) || record.links.length === 0) {
+        throw new InvalidScientificInputError("linkage.links must be a non-empty array for spatial-phase-linked linkage.");
+    }
+    const links = record.links.map((entry, index) => parseSpatialLink(entry, "linkage.links[" + index + "]"));
+    const seen = new Set();
+    for (const link of links) {
+        if (seen.has(link.boundary)) {
+            throw new InvalidScientificInputError("linkage.links must not contain duplicate boundary links.");
+        }
+        seen.add(link.boundary);
+    }
+    return {
+        kind: "spatial-phase-linked",
+        links
+    };
+}
+function oppositeDirection(direction) {
+    switch (direction) {
+        case "top-to-bottom":
+            return "bottom-to-top";
+        case "bottom-to-top":
+            return "top-to-bottom";
+        case "left-to-right":
+            return "right-to-left";
+        case "right-to-left":
+            return "left-to-right";
+    }
+}
+function expectedBoundaryDirection(readoutDirection, phaseOrientation) {
+    return phaseOrientation === "same"
+        ? readoutDirection
+        : oppositeDirection(readoutDirection);
+}
+/**
+ * Assesses an explicitly declared relationship between rolling sensor readout
+ * spatial phase and one or more electronic exposure-boundary scans.
+ *
+ * This contract is deliberately weaker than temporal synchronization. It can
+ * establish that two schedules traverse the same native spatial phase ordering
+ * (or its reverse), but it does not establish when sensor data readout occurs
+ * relative to exposure start/end.
+ *
+ * The total capture data-readout duration is preserved diagnostically and is
+ * never used to validate the relationship. Different rolling-readout spatial
+ * skew and exposure-boundary traversal durations are allowed; their ratio is
+ * reported without implying a shared clock origin.
+ */
+export function assessReadoutExposureTimingLinkage(input) {
+    const linkage = parseLinkageDeclaration(input.linkage);
+    const sensorReadout = calculateSensorReadoutTiming({
+        nativeRaster: input.nativeRaster,
+        ...(input.activeCaptureRect === undefined
+            ? {}
+            : { activeCaptureRect: input.activeCaptureRect }),
+        shutterMechanism: input.shutterMechanism,
+        readout: input.readout,
+        ...(input.samplePointsNative === undefined
+            ? {}
+            : { samplePointsNative: input.samplePointsNative })
+    });
+    const exposureWindows = calculateCaptureExposureWindows({
+        nativeRaster: input.nativeRaster,
+        ...(input.activeCaptureRect === undefined
+            ? {}
+            : { activeCaptureRect: input.activeCaptureRect }),
+        shutterMechanism: input.shutterMechanism,
+        nominalExposureDurationSeconds: input.nominalExposureDurationSeconds,
+        opening: input.opening,
+        closing: input.closing,
+        ...(input.samplePointsNative === undefined
+            ? {}
+            : { samplePointsNative: input.samplePointsNative })
+    });
+    if (linkage.kind === "unlinked") {
+        return approximationResult({
+            linkageKind: "unlinked",
+            relationshipMeaning: "no-readout-exposure-relationship-asserted",
+            readoutMode: sensorReadout.value.readoutMode,
+            shutterMechanism: input.shutterMechanism,
+            activeCaptureRect: {
+                ...sensorReadout.value.activeCaptureRect
+            },
+            absoluteTemporalAlignment: "not-established",
+            captureReadoutDurationSeconds: sensorReadout.value.captureReadoutDurationSeconds,
+            links: [],
+            componentProvenance: {
+                sensorReadout: sensorReadout.provenance,
+                exposureWindows: exposureWindows.provenance
+            }
+        }, "readout-exposure-spatial-linkage", "1.0.0", [
+            "Unlinked means Photivra asserts no readout-to-exposure relationship for this capture; it does not prove the physical processes are independent.",
+            "Sensor data-readout timing and exposure-window timing retain independent provenance and semantics.",
+            "Absolute temporal alignment between data readout and exposure boundaries is not established."
+        ]);
+    }
+    const readoutScan = sensorReadout.value.scan;
+    if (readoutScan === null) {
+        throw new InvalidScientificInputError("spatial-phase-linked linkage requires rolling sensor readout with a spatial scan.");
+    }
+    const assessments = linkage.links.map((link) => {
+        const boundary = link.boundary === "opening"
+            ? exposureWindows.value.opening
+            : exposureWindows.value.closing;
+        if (boundary.actuator !== "electronic") {
+            throw new InvalidScientificInputError("A readout spatial-phase link may target only an electronic exposure boundary.");
+        }
+        if (boundary.schedule.kind !==
+            "uniform-linear-native-scan") {
+            throw new InvalidScientificInputError("A readout spatial-phase link requires the selected exposure boundary to use a uniform-linear native scan.");
+        }
+        const readoutDirection = readoutScan.directionNative.value;
+        const boundaryDirection = boundary.schedule.directionNative.value;
+        const expectedDirection = expectedBoundaryDirection(readoutDirection, link.phaseOrientation);
+        if (boundaryDirection !== expectedDirection) {
+            throw new InvalidScientificInputError("Declared readout/exposure spatial phase orientation contradicts the readout and exposure-boundary scan directions.");
+        }
+        const readoutSpatialSamplingSkewSeconds = readoutScan.spatialSamplingSkewSeconds;
+        const boundaryTraversalDurationSeconds = boundary.schedule.traversalDurationSeconds;
+        return {
+            boundary: link.boundary,
+            boundaryActuator: "electronic",
+            phaseOrientation: link.phaseOrientation,
+            normalizedPhaseRelationship: link.phaseOrientation === "same"
+                ? "boundary-phase-equals-readout-phase"
+                : "boundary-phase-equals-one-minus-readout-phase",
+            relationshipEvidence: link.evidence,
+            readoutDirectionNative: readoutDirection,
+            boundaryDirectionNative: boundaryDirection,
+            readoutSpatialSamplingSkewSeconds,
+            boundaryTraversalDurationSeconds,
+            boundaryTraversalToReadoutSpatialSkewRatio: boundaryTraversalDurationSeconds.value /
+                readoutSpatialSamplingSkewSeconds.value,
+            absoluteTemporalAlignment: "not-established"
+        };
+    });
+    return approximationResult({
+        linkageKind: "spatial-phase-linked",
+        relationshipMeaning: "normalized-spatial-phase-relationship-asserted",
+        readoutMode: sensorReadout.value.readoutMode,
+        shutterMechanism: input.shutterMechanism,
+        activeCaptureRect: {
+            ...sensorReadout.value.activeCaptureRect
+        },
+        absoluteTemporalAlignment: "not-established",
+        captureReadoutDurationSeconds: sensorReadout.value.captureReadoutDurationSeconds,
+        links: assessments,
+        componentProvenance: {
+            sensorReadout: sensorReadout.provenance,
+            exposureWindows: exposureWindows.provenance
+        }
+    }, "readout-exposure-spatial-linkage", "1.0.0", [
+        "The linkage establishes normalized native-sensor spatial phase/order only, not absolute temporal synchronization.",
+        "Every asserted boundary link carries evidence separate from the evidence for the underlying readout and exposure timing facts.",
+        "Only electronic exposure boundaries may be linked to rolling sensor readout spatial phase.",
+        "Same phase orientation requires matching native scan direction; reversed phase orientation requires the exact opposite direction on the same native axis.",
+        "Rolling readout spatial skew and exposure-boundary traversal duration may differ; their ratio is descriptive and does not establish a common clock origin.",
+        "Capture data-readout duration is not used to validate exposure-boundary timing linkage.",
+        "Active capture, native coordinate semantics and shutter mechanism are shared because both component schedules are resolved from the same input.",
+        "Sensor readout and exposure-window component provenance remain visible; linkage does not upgrade either component to calibrated status.",
+        "No camera-specific timing relationship is inferred from shutter mechanism, sensor architecture metadata, output resolution or adjacent specifications."
+    ]);
+}
+//# sourceMappingURL=readout-exposure-linkage.js.map

package/dist/sensor/readout-exposure-linkage.js.map

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

package/dist/sensor/readout-timing.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Module boundary and integration notes.
+ * Resolves a capture-specific native sensor readout scan schedule. Rolling readout uses a
+ * uniform-linear single-axis approximation across the declared active capture. The caller supplies the
+ * spatial timing span explicitly; it is never inferred from total data-readout duration, active crop
+ * dimensions, native raster density, output resolution, sensor architecture metadata, or shutter
+ * mechanism. Global readout has no spatial phase skew in this model even when a non-zero data-readout
+ * duration is declared. This foundation does not define local exposure start/end times, mechanical
+ * curtain travel, EFCS curtain behavior, rolling-shutter image distortion, flash/flicker interactions,
+ * or motion integration.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type EvidenceBackedFact } from "../core/evidence-provenance.js";
+import type { RasterPoint, RasterRect } from "../output/capture-geometry.js";
+import type { NativeImageRaster } from "./sensor-geometry.js";
+import type { SensorReadoutArchitecture } from "./architecture.js";
+/**
+ * Readout architecture selected for one capture.
+ *
+ * This reuses the architecture vocabulary but is not a hardware-capability
+ * assertion. SensorArchitectureProfile.readoutCapabilities remains descriptive
+ * metadata and is not consulted automatically.
+ */
+export type SensorReadoutMode = SensorReadoutArchitecture;
+export type NativeSensorReadoutScanDirection = "top-to-bottom" | "bottom-to-top" | "left-to-right" | "right-to-left";
+export type CaptureShutterMechanism = "mechanical" | "electronic-first-curtain" | "electronic";
+/**
+ * Evidence-backed timing value with an explicit seconds unit.
+ */
+export interface SourcedSensorTimingSeconds extends EvidenceBackedFact<number> {
+    unit: "s";
+}
+export type SourcedSensorReadoutFact<T> = EvidenceBackedFact<T>;
+export interface GlobalSensorReadoutTimingDeclaration {
+    readoutMode: "global";
+    /**
+     * Capture-specific sensor data-readout duration.
+     *
+     * This is deliberately not interpreted as spatial exposure/readout skew.
+     */
+    captureReadoutDurationSeconds: SourcedSensorTimingSeconds;
+    scanDirectionNative?: never;
+    spatialSamplingSkewSeconds?: never;
+}
+export interface RollingSensorReadoutTimingDeclaration {
+    readoutMode: "rolling";
+    /**
+     * Capture-specific sensor data-readout duration.
+     *
+     * This fact is retained independently from spatial sampling skew because
+     * published/declared readout duration and the spatial timing span need not be
+     * treated as the same quantity.
+     */
+    captureReadoutDurationSeconds: SourcedSensorTimingSeconds;
+    /**
+     * Native-sensor scan direction for the selected capture mode.
+     */
+    scanDirectionNative: SourcedSensorReadoutFact<NativeSensorReadoutScanDirection>;
+    /**
+     * Time difference between the first and last spatial scan positions in the
+     * uniform-linear timing approximation.
+     */
+    spatialSamplingSkewSeconds: SourcedSensorTimingSeconds;
+}
+export type SensorReadoutTimingDeclaration = GlobalSensorReadoutTimingDeclaration | RollingSensorReadoutTimingDeclaration;
+export interface CalculateSensorReadoutTimingInput {
+    nativeRaster: NativeImageRaster;
+    /**
+     * Active capture rectangle in invariant native raster coordinates.
+     *
+     * Defaults to the complete native raster. Timing is never inferred by
+     * scaling a full-frame value to this rectangle.
+     */
+    activeCaptureRect?: RasterRect;
+    /**
+     * Selected shutter mechanism for the capture.
+     *
+     * It is reported independently and does not modify the sensor timing
+     * schedule in this foundation.
+     */
+    shutterMechanism: CaptureShutterMechanism;
+    readout: SensorReadoutTimingDeclaration;
+    /**
+     * Optional continuous native raster edge-coordinate points for timing
+     * diagnostics. Pixel centers may be represented with +0.5 offsets.
+     */
+    samplePointsNative?: readonly RasterPoint[];
+}
+export interface SensorReadoutTimingSample {
+    pointNative: RasterPoint;
+    normalizedScanPosition: number | null;
+    /**
+     * Relative native-sensor readout phase in seconds.
+     *
+     * Zero is the first spatial scan position. This is not automatically an
+     * exposure-start time or shutter-curtain time.
+     */
+    readoutPhaseOffsetSeconds: number;
+}
+export interface SensorReadoutTiming {
+    readoutMode: SensorReadoutMode;
+    shutterMechanism: CaptureShutterMechanism;
+    nativeRaster: NativeImageRaster;
+    activeCaptureRect: RasterRect;
+    captureReadoutDurationSeconds: SourcedSensorTimingSeconds;
+    maximumSpatialSamplingSkewSeconds: number;
+    scan: {
+        pattern: "uniform-linear-single-axis";
+        directionNative: SourcedSensorReadoutFact<NativeSensorReadoutScanDirection>;
+        unitVectorNative: {
+            x: number;
+            y: number;
+        };
+        spatialSamplingSkewSeconds: SourcedSensorTimingSeconds;
+    } | null;
+    samples: readonly SensorReadoutTimingSample[];
+}
+/**
+ * Resolves a capture-specific native sensor readout scan schedule.
+ *
+ * Rolling readout uses a uniform-linear single-axis approximation across the
+ * declared active capture. The caller supplies the spatial timing span
+ * explicitly; it is never inferred from total data-readout duration, active
+ * crop dimensions, native raster density, output resolution, sensor
+ * architecture metadata, or shutter mechanism.
+ *
+ * Global readout has no spatial phase skew in this model even when a non-zero
+ * data-readout duration is declared.
+ *
+ * This foundation does not define local exposure start/end times, mechanical
+ * curtain travel, EFCS curtain behavior, rolling-shutter image distortion,
+ * flash/flicker interactions, or motion integration.
+ */
+export declare function calculateSensorReadoutTiming(input: CalculateSensorReadoutTimingInput): CalculationResult<SensorReadoutTiming>;
+//# sourceMappingURL=readout-timing.d.ts.map

package/dist/sensor/readout-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readout-timing.d.ts","sourceRoot":"","sources":["../../src/sensor/readout-timing.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE1D,MAAM,MAAM,gCAAgC,GACxC,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,MAAM,uBAAuB,GAC/B,YAAY,GACZ,0BAA0B,GAC1B,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,0BACf,SAAQ,kBAAkB,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,GAAG,CAAC;CACX;AAED,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,oCAAoC;IACnD,WAAW,EAAE,QAAQ,CAAC;IACtB;;;;OAIG;IACH,6BAA6B,EAAE,0BAA0B,CAAC;IAC1D,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B,0BAA0B,CAAC,EAAE,KAAK,CAAC;CACpC;AAED,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,SAAS,CAAC;IACvB;;;;;;OAMG;IACH,6BAA6B,EAAE,0BAA0B,CAAC;IAC1D;;OAEG;IACH,mBAAmB,EAAE,wBAAwB,CAAC,gCAAgC,CAAC,CAAC;IAChF;;;OAGG;IACH,0BAA0B,EAAE,0BAA0B,CAAC;CACxD;AAED,MAAM,MAAM,8BAA8B,GACtC,oCAAoC,GACpC,qCAAqC,CAAC;AAE1C,MAAM,WAAW,iCAAiC;IAChD,YAAY,EAAE,iBAAiB,CAAC;IAChC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B;;;;;OAKG;IACH,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,OAAO,EAAE,8BAA8B,CAAC;IACxC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,WAAW,CAAC;IACzB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;OAKG;IACH,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,YAAY,EAAE,iBAAiB,CAAC;IAChC,iBAAiB,EAAE,UAAU,CAAC;IAC9B,6BAA6B,EAAE,0BAA0B,CAAC;IAC1D,iCAAiC,EAAE,MAAM,CAAC;IAC1C,IAAI,EACA;QACE,OAAO,EAAE,4BAA4B,CAAC;QACtC,eAAe,EAAE,wBAAwB,CAAC,gCAAgC,CAAC,CAAC;QAC5E,gBAAgB,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,0BAA0B,EAAE,0BAA0B,CAAC;KACxD,GACD,IAAI,CAAC;IACT,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC/C;AAkPD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,GACvC,iBAAiB,CAAC,mBAAmB,CAAC,CAmFxC"}