@photivra/engine 0.5.1 → 1.0.0

package/dist/sensor/local-exposure-binding.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Module boundary and integration notes.
+ * Binds one engine-produced sensor response-rate result to the local exposure window at the same
+ * color-sampling site. This first temporal binding supports only the explicit one-to-one
+ * native-effective-sample ↔ color-site relationship. A multi-site block binding proves contributor
+ * membership but does not prove each color site's sub-sample timing coordinate, so spatially varying
+ * shutter timing fails closed rather than inventing fractional positions. The result establishes
+ * timing only. It deliberately does not establish that the optical/electrical rate is stationary
+ * through the local exposure window, so rate×duration integration remains unauthorized.
+ * @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 { EvidenceProvenance } from "../core/evidence-provenance.js";
+import { type NativeEffectiveRasterColorSamplingBindingProfile } from "./capture-color-sampling-binding.js";
+import { type SensorColorSamplingProfile } from "./color-sampling.js";
+import type { SensorEqeElectronRate } from "./eqe-electron-rate.js";
+import { type CalculateCaptureExposureWindowsInput, type CaptureExposureWindowSample } from "./exposure-window.js";
+import type { SensorResponsivityPhotocurrent } from "./responsivity-photocurrent.js";
+export type SensorInstantaneousRateResult = SensorEqeElectronRate | SensorResponsivityPhotocurrent;
+export interface BindSensorRateToLocalExposureInput {
+    rate: SensorInstantaneousRateResult;
+    colorSamplingProfile: SensorColorSamplingProfile;
+    bindingProfile: NativeEffectiveRasterColorSamplingBindingProfile;
+    /**
+     * One capture/exposure event. samplePointsNative is owned by this binding
+     * function and therefore intentionally excluded.
+     */
+    exposureWindowInput: Omit<CalculateCaptureExposureWindowsInput, "samplePointsNative">;
+}
+export interface SensorRateLocalExposureBinding {
+    rateDomain: "eqe-electron-rate" | "responsivity-photocurrent";
+    rateIdentity: {
+        responseProfileId: string;
+        responseApplicationProfileId: string;
+        operatingRangeProfileId: string;
+        electricalApplicabilityProfileId?: string;
+    };
+    colorSamplingProfileId: string;
+    channelId: string;
+    site: {
+        x: number;
+        y: number;
+    };
+    bindingId: string;
+    bindingRelationship: "one-native-effective-sample-to-one-color-site";
+    timingCoordinateRule: "one-to-one-color-site-center-equals-native-effective-sample-center";
+    nativeRasterPoint: {
+        x: number;
+        y: number;
+    };
+    shutterMechanism: CalculateCaptureExposureWindowsInput["shutterMechanism"];
+    timeReference: "first-opening-boundary-phase";
+    localExposureWindow: CaptureExposureWindowSample;
+    localExposureDurationSeconds: number;
+    exposureEventMeaning: "single-capture-local-exposure-window";
+    nativeImageRasterBindingEstablished: true;
+    channelAtSiteValidated: true;
+    physicalPhotodiodeTimingRegistrationEstablished: false;
+    multiFrameSequenceBindingEstablished: false;
+    timeStationarityEstablished: false;
+    constantRateTemporalIntegrationAuthorized: false;
+    temporalIntegrationApplied: false;
+    componentEvidence: {
+        binding: readonly EvidenceProvenance[];
+        colorSamplingProfile: readonly EvidenceProvenance[];
+        nominalExposureDuration: readonly EvidenceProvenance[];
+        openingBoundary: readonly EvidenceProvenance[];
+        closingBoundary: readonly EvidenceProvenance[];
+    };
+}
+/**
+ * Binds one engine-produced sensor response-rate result to the local exposure
+ * window at the same color-sampling site.
+ *
+ * This first temporal binding supports only the explicit one-to-one
+ * native-effective-sample ↔ color-site relationship. A multi-site block
+ * binding proves contributor membership but does not prove each color site's
+ * sub-sample timing coordinate, so spatially varying shutter timing fails
+ * closed rather than inventing fractional positions.
+ *
+ * The result establishes timing only. It deliberately does not establish that
+ * the optical/electrical rate is stationary through the local exposure window,
+ * so rate×duration integration remains unauthorized.
+ */
+export declare function bindSensorRateToLocalExposure(input: BindSensorRateToLocalExposureInput): CalculationResult<SensorRateLocalExposureBinding>;
+//# sourceMappingURL=local-exposure-binding.d.ts.map

package/dist/sensor/local-exposure-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-exposure-binding.d.ts","sourceRoot":"","sources":["../../src/sensor/local-exposure-binding.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAEL,KAAK,gDAAgD,EACtD,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,oCAAoC,EACzC,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,8BAA8B,EAC/B,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,6BAA6B,GACrC,qBAAqB,GACrB,8BAA8B,CAAC;AAEnC,MAAM,WAAW,kCAAkC;IACjD,IAAI,EACF,6BAA6B,CAAC;IAChC,oBAAoB,EAClB,0BAA0B,CAAC;IAC7B,cAAc,EACZ,gDAAgD,CAAC;IACnD;;;OAGG;IACH,mBAAmB,EACjB,IAAI,CACF,oCAAoC,EACpC,oBAAoB,CACrB,CAAC;CACL;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EACN,mBAAmB,GACnB,2BAA2B,CAAC;IAChC,YAAY,EAAE;QACZ,iBAAiB,EAAE,MAAM,CAAC;QAC1B,4BAA4B,EAAE,MAAM,CAAC;QACrC,uBAAuB,EAAE,MAAM,CAAC;QAChC,gCAAgC,CAAC,EAAE,MAAM,CAAC;KAC3C,CAAC;IACF,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EACjB,+CAA+C,CAAC;IAClD,oBAAoB,EAClB,oEAAoE,CAAC;IACvE,iBAAiB,EAAE;QACjB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,gBAAgB,EACd,oCAAoC,CAAC,kBAAkB,CAAC,CAAC;IAC3D,aAAa,EACX,8BAA8B,CAAC;IACjC,mBAAmB,EACjB,2BAA2B,CAAC;IAC9B,4BAA4B,EAC1B,MAAM,CAAC;IACT,oBAAoB,EAClB,sCAAsC,CAAC;IACzC,mCAAmC,EAAE,IAAI,CAAC;IAC1C,sBAAsB,EAAE,IAAI,CAAC;IAC7B,+CAA+C,EAC7C,KAAK,CAAC;IACR,oCAAoC,EAClC,KAAK,CAAC;IACR,2BAA2B,EAAE,KAAK,CAAC;IACnC,yCAAyC,EACvC,KAAK,CAAC;IACR,0BAA0B,EAAE,KAAK,CAAC;IAClC,iBAAiB,EAAE;QACjB,OAAO,EACL,SAAS,kBAAkB,EAAE,CAAC;QAChC,oBAAoB,EAClB,SAAS,kBAAkB,EAAE,CAAC;QAChC,uBAAuB,EACrB,SAAS,kBAAkB,EAAE,CAAC;QAChC,eAAe,EACb,SAAS,kBAAkB,EAAE,CAAC;QAChC,eAAe,EACb,SAAS,kBAAkB,EAAE,CAAC;KACjC,CAAC;CACH;AAyGD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EACH,kCAAkC,GACnC,iBAAiB,CAAC,8BAA8B,CAAC,CAmMnD"}

package/dist/sensor/local-exposure-binding.js

@@ -0,0 +1,214 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Binds one engine-produced sensor response-rate result to the local exposure window at the same
+ * color-sampling site. This first temporal binding supports only the explicit one-to-one
+ * native-effective-sample ↔ color-site relationship. A multi-site block binding proves contributor
+ * membership but does not prove each color site's sub-sample timing coordinate, so spatially varying
+ * shutter timing fails closed rather than inventing fractional positions. The result establishes
+ * timing only. It deliberately does not establish that the optical/electrical rate is stationary
+ * through the local exposure window, so rate×duration integration remains unauthorized.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { resolveNativeEffectiveRasterColorSamplingBinding } from "./capture-color-sampling-binding.js";
+import { resolveColorSamplingSite } from "./color-sampling.js";
+import { calculateCaptureExposureWindows } from "./exposure-window.js";
+function requireSite(rate) {
+    if (rate.site === undefined ||
+        typeof rate.site !== "object" ||
+        rate.site === null ||
+        !Number.isSafeInteger(rate.site.x) ||
+        rate.site.x < 0 ||
+        !Number.isSafeInteger(rate.site.y) ||
+        rate.site.y < 0) {
+        throw new InvalidScientificInputError("rate.site must be present as a non-negative safe-integer color-sampling-site index.");
+    }
+    return {
+        x: rate.site.x,
+        y: rate.site.y
+    };
+}
+function validateRateBoundary(rate) {
+    if (rate.sourceResponseKind ===
+        "effective-spectral-responsivity") {
+        const current = rate;
+        if (current.currentCalculated !==
+            true ||
+            current.chargeCalculated !==
+                false ||
+            current.temporalIntegrationApplied !==
+                false ||
+            current.exposureDurationApplied !==
+                false ||
+            current.detectorBandwidthModeled !==
+                false ||
+            current.temporalResponseModel !==
+                "quasi-static-steady-state-only") {
+            throw new InvalidScientificInputError("A/W rate must remain a quasi-static pre-temporal photocurrent result.");
+        }
+        return "responsivity-photocurrent";
+    }
+    const eqe = rate;
+    if (eqe.electronRateCalculated !== true ||
+        eqe.photonRateCalculated !== true ||
+        eqe.electronCountCalculated !==
+            false ||
+        eqe.photonCountCalculated !==
+            false ||
+        eqe.temporalIntegrationApplied !==
+            false ||
+        eqe.exposureDurationApplied !==
+            false) {
+        throw new InvalidScientificInputError("EQE rate must remain a pre-temporal photon/electron-rate result.");
+    }
+    return "eqe-electron-rate";
+}
+function boundaryEvidence(boundary) {
+    if (boundary.schedule.kind ===
+        "simultaneous") {
+        return [];
+    }
+    return [
+        ...boundary.schedule.directionNative
+            .evidence,
+        ...boundary.schedule
+            .traversalDurationSeconds.evidence
+    ];
+}
+/**
+ * Binds one engine-produced sensor response-rate result to the local exposure
+ * window at the same color-sampling site.
+ *
+ * This first temporal binding supports only the explicit one-to-one
+ * native-effective-sample ↔ color-site relationship. A multi-site block
+ * binding proves contributor membership but does not prove each color site's
+ * sub-sample timing coordinate, so spatially varying shutter timing fails
+ * closed rather than inventing fractional positions.
+ *
+ * The result establishes timing only. It deliberately does not establish that
+ * the optical/electrical rate is stationary through the local exposure window,
+ * so rate×duration integration remains unauthorized.
+ */
+export function bindSensorRateToLocalExposure(input) {
+    const rateDomain = validateRateBoundary(input.rate);
+    const site = requireSite(input.rate);
+    const binding = resolveNativeEffectiveRasterColorSamplingBinding({
+        nativeRaster: input.exposureWindowInput
+            .nativeRaster,
+        colorSamplingProfile: input.colorSamplingProfile,
+        bindingProfile: input.bindingProfile
+    });
+    if (binding.colorSamplingProfileId !==
+        input.rate
+            .colorSamplingProfileId) {
+        throw new InvalidScientificInputError("Color-sampling binding must reference the same colorSamplingProfileId as the rate result.");
+    }
+    if (binding.relationship
+        .sitesPerNativeSampleX !== 1 ||
+        binding.relationship
+            .sitesPerNativeSampleY !== 1) {
+        throw new InvalidScientificInputError("Local exposure timing currently requires a one-to-one color-site/native-effective-sample binding; multi-site blocks lack explicit sub-sample timing registration.");
+    }
+    if (site.x >=
+        binding.colorSamplingSiteGrid
+            .widthSites ||
+        site.y >=
+            binding.colorSamplingSiteGrid
+                .heightSites) {
+        throw new InvalidScientificInputError("rate.site is outside the color-sampling site grid established by the binding.");
+    }
+    const resolvedSite = resolveColorSamplingSite({
+        profile: input.colorSamplingProfile,
+        site
+    });
+    if (resolvedSite.mapping.channelId !==
+        input.rate.channelId) {
+        throw new InvalidScientificInputError("The rate channelId does not match the color-sampling channel assigned to rate.site.");
+    }
+    const nativeRasterPoint = {
+        x: site.x + 0.5,
+        y: site.y + 0.5
+    };
+    const windows = calculateCaptureExposureWindows({
+        ...input.exposureWindowInput,
+        samplePointsNative: [
+            nativeRasterPoint
+        ]
+    }).value;
+    const localExposureWindow = windows.samples[0];
+    if (localExposureWindow === undefined ||
+        localExposureWindow
+            .pointNative.x !==
+            nativeRasterPoint.x ||
+        localExposureWindow
+            .pointNative.y !==
+            nativeRasterPoint.y ||
+        !Number.isFinite(localExposureWindow
+            .localExposureDurationSeconds) ||
+        localExposureWindow
+            .localExposureDurationSeconds <= 0) {
+        throw new InvalidScientificInputError("Exposure-window resolution did not return a valid local sample for the bound sensor site.");
+    }
+    return approximationResult({
+        rateDomain,
+        rateIdentity: {
+            responseProfileId: input.rate.responseProfileId,
+            responseApplicationProfileId: input.rate
+                .responseApplicationProfileId,
+            operatingRangeProfileId: input.rate
+                .operatingRangeProfileId,
+            ...(rateDomain ===
+                "responsivity-photocurrent"
+                ? {
+                    electricalApplicabilityProfileId: input.rate
+                        .electricalApplicabilityProfileId
+                }
+                : {})
+        },
+        colorSamplingProfileId: input.rate
+            .colorSamplingProfileId,
+        channelId: input.rate.channelId,
+        site,
+        bindingId: binding.bindingId,
+        bindingRelationship: "one-native-effective-sample-to-one-color-site",
+        timingCoordinateRule: "one-to-one-color-site-center-equals-native-effective-sample-center",
+        nativeRasterPoint,
+        shutterMechanism: windows.shutterMechanism,
+        timeReference: windows.timeReference,
+        localExposureWindow,
+        localExposureDurationSeconds: localExposureWindow
+            .localExposureDurationSeconds,
+        exposureEventMeaning: "single-capture-local-exposure-window",
+        nativeImageRasterBindingEstablished: true,
+        channelAtSiteValidated: true,
+        physicalPhotodiodeTimingRegistrationEstablished: false,
+        multiFrameSequenceBindingEstablished: false,
+        timeStationarityEstablished: false,
+        constantRateTemporalIntegrationAuthorized: false,
+        temporalIntegrationApplied: false,
+        componentEvidence: {
+            binding: binding.componentEvidence
+                .binding,
+            colorSamplingProfile: binding.componentEvidence
+                .colorSamplingProfile,
+            nominalExposureDuration: windows
+                .nominalExposureDurationSeconds
+                .evidence,
+            openingBoundary: boundaryEvidence(windows.opening),
+            closingBoundary: boundaryEvidence(windows.closing)
+        }
+    }, "sensor-rate-local-exposure-binding", "1.0.0", [
+        "The rate's abstract color-sampling site is mapped to the center of the same-index native effective sample only because an explicit one-to-one shared-top-left binding is present.",
+        "Multi-site-per-native-sample relationships are blocked because contributor membership does not establish individual color-site timing coordinates.",
+        "The mapped timing coordinate is a native-effective-raster timing coordinate; it does not establish a physical photodiode timing registration.",
+        "The exposure schedule is recomputed from the evidence-backed opening/closing timing declarations at the bound point rather than accepting an arbitrary precomputed local duration.",
+        "The color-sampling channel at the exact site must match the response-rate channel.",
+        "The result represents one local exposure event only; multi-frame/pixel-shift sequence timing and combination remain outside this contract.",
+        "This binding does not establish that the optical/electron/current rate is constant through the exposure. Motion, flicker, flash, time-varying illumination/vignetting and detector transients require a time-dependent integrand.",
+        "Temporal integration, accumulated charge, saturation, noise, ADC/RAW conversion and reconstruction are not performed."
+    ]);
+}
+//# sourceMappingURL=local-exposure-binding.js.map

package/dist/sensor/local-exposure-binding.js.map

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

package/dist/sensor/optical-stack.d.ts

@@ -0,0 +1,132 @@
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+export type SensorOpticalStackComponentRole = "cover-glass" | "infrared-cut" | "ultraviolet-cut" | "anti-reflection" | "birefringent-low-pass" | "wave-plate" | "other-optical-filter";
+export interface SensorOpticalStackComponent {
+    componentId: string;
+    /**
+     * Roles may be combined because one physical element can provide multiple
+     * optical/filter functions.
+     */
+    roles: readonly SensorOpticalStackComponentRole[];
+    evidence: readonly EvidenceProvenance[];
+}
+export interface SensorMicrolensDeclaration {
+    presence: "present" | "absent";
+    evidence: readonly EvidenceProvenance[];
+    /**
+     * Presence alone does not establish an angular, spectral, fill-factor, or
+     * collection-efficiency model.
+     */
+    opticalEffectModel: "unresolved";
+}
+export interface AntiAliasingPointSplitComponent {
+    /**
+     * Native sensor physical offset from the nominal landing point.
+     * +X right, +Y down. Units: micrometres.
+     */
+    offsetMicrometers: {
+        x: number;
+        y: number;
+    };
+    /**
+     * Dimensionless normalized spatial weight. Point-splitting kernels describe
+     * spatial redistribution only; total stack throughput is outside this field.
+     */
+    normalizedWeight: number;
+}
+export type SensorEffectiveAntiAliasingSpatialResponse = {
+    /**
+     * Documented absence/cancellation of intentional anti-aliasing spatial
+     * splitting. This does not mean the whole sensor stack is optically
+     * identity.
+     */
+    kind: "absent";
+    evidence: readonly EvidenceProvenance[];
+} | {
+    /**
+     * An effective anti-aliasing response is known to exist, but its spatial
+     * response is not defensibly specified.
+     */
+    kind: "present-unresolved";
+    evidence: readonly EvidenceProvenance[];
+} | {
+    /**
+     * Generic normalized point-splitting approximation in native sensor
+     * physical coordinates.
+     */
+    kind: "normalized-point-splitting-kernel";
+    evidence: readonly EvidenceProvenance[];
+    coordinateSystem: "native-sensor-physical";
+    scope: "field-wavelength-polarization-invariant-approximation";
+    components: readonly AntiAliasingPointSplitComponent[];
+};
+export interface SensorOpticalStackProfile {
+    schemaVersion: "0.1.0";
+    profileId: string;
+    evidence: readonly EvidenceProvenance[];
+    /**
+     * Ordered from incident-light side toward the sensor.
+     *
+     * These components are descriptive metadata only. Their presence does not
+     * create transmission, focus-shift, aberration, or spectral effects.
+     */
+    orderedComponents?: readonly SensorOpticalStackComponent[];
+    /**
+     * Omitted means unknown/unasserted.
+     *
+     * This is intentionally separate from physical component presence so a
+     * stack can contain low-pass-related hardware while its net effective
+     * anti-aliasing response is absent/cancelled.
+     */
+    effectiveAntiAliasingSpatialResponse?: SensorEffectiveAntiAliasingSpatialResponse;
+    /**
+     * Omitted means unknown/unasserted.
+     */
+    microlens?: SensorMicrolensDeclaration;
+}
+export interface ResolvedAntiAliasingSpatialKernel {
+    profileId: string;
+    effectiveResponse: "absent" | "normalized-point-splitting-kernel";
+    coordinateSystem: "native-sensor-physical";
+    components: readonly AntiAliasingPointSplitComponent[];
+    normalizedWeightSum: number;
+    throughputIncluded: false;
+    spectralTransmissionIncluded: false;
+    fieldDependenceIncluded: false;
+    wavelengthDependenceIncluded: false;
+    polarizationDependenceIncluded: false;
+    microlensResponseIncluded: false;
+    coverFilterStackEffectsIncluded: false;
+    wholeSensorOpticalStackResponse: false;
+    provenance: {
+        profile: readonly EvidenceProvenance[];
+        antiAliasingResponse: readonly EvidenceProvenance[];
+    };
+}
+/**
+ * Parses descriptive sensor optical-stack metadata plus an optional explicitly
+ * declared effective anti-aliasing spatial response.
+ *
+ * Unknown facts are omitted instead of inferred. Physical component presence
+ * is intentionally separate from effective anti-aliasing response so the
+ * schema can represent cancellation/neutralization designs without claiming
+ * the physical assembly is absent.
+ *
+ * Cover/filter-stack and microlens presence do not create optical effects in
+ * schema 0.1.0. Thickness, refractive index, spectral transmission, angular
+ * acceptance, focus shift and microlens collection behavior require later
+ * explicit models/calibration.
+ */
+export declare function parseSensorOpticalStackProfile(value: unknown): SensorOpticalStackProfile;
+/**
+ * Resolves only the effective anti-aliasing spatial kernel.
+ *
+ * This is not a whole optical-stack PSF. Cover/filter transmission, refraction,
+ * microlens behavior, field/wavelength/polarization dependence, and total
+ * throughput remain excluded.
+ *
+ * A documented absent effective anti-aliasing response resolves to an identity
+ * component at zero offset. An unknown response (field omitted) or a
+ * present-but-unresolved response fails closed.
+ */
+export declare function resolveAntiAliasingSpatialKernel(profileInput: SensorOpticalStackProfile): ResolvedAntiAliasingSpatialKernel;
+//# sourceMappingURL=optical-stack.d.ts.map

package/dist/sensor/optical-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optical-stack.d.ts","sourceRoot":"","sources":["../../src/sensor/optical-stack.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAKxC,MAAM,MAAM,+BAA+B,GACvC,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,GACvB,YAAY,GACZ,sBAAsB,CAAC;AAE3B,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAClD,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC;;;OAGG;IACH,kBAAkB,EAAE,YAAY,CAAC;CAClC;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,iBAAiB,EAAE;QACjB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,0CAA0C,GAClD;IACE;;;;OAIG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,mCAAmC,CAAC;IAC1C,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,KAAK,EACH,uDAAuD,CAAC;IAC1D,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;CACxD,CAAC;AAEN,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC3D;;;;;;OAMG;IACH,oCAAoC,CAAC,EAAE,0CAA0C,CAAC;IAClF;;OAEG;IACH,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EACb,QAAQ,GACR,mCAAmC,CAAC;IACxC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,KAAK,CAAC;IAC1B,4BAA4B,EAAE,KAAK,CAAC;IACpC,uBAAuB,EAAE,KAAK,CAAC;IAC/B,4BAA4B,EAAE,KAAK,CAAC;IACpC,8BAA8B,EAAE,KAAK,CAAC;IACtC,yBAAyB,EAAE,KAAK,CAAC;IACjC,+BAA+B,EAAE,KAAK,CAAC;IACvC,+BAA+B,EAAE,KAAK,CAAC;IACvC,UAAU,EAAE;QACV,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACvC,oBAAoB,EAAE,SAAS,kBAAkB,EAAE,CAAC;KACrD,CAAC;CACH;AA0TD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,yBAAyB,CAuE3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,yBAAyB,GACtC,iCAAiC,CAyFnC"}