@photivra/engine 0.5.1 → 1.0.0

package/dist/sensor/capture-color-sampling-binding.js

@@ -0,0 +1,437 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses the explicit relationship between the canonical native effective image raster and the
+ * separate native sensor color-sampling-site lattice. This first binding supports only regular
+ * rectangular site blocks with a shared native top-left anchor. Irregular mappings, sparse exceptions
+ * and mode-specific declared-effective rasters require later explicit contracts.
+ * Validates and resolves the sensor-level binding between NativeImageRaster and an exact
+ * monochrome/periodic color-sampling topology. Matching dimensions are never treated as proof of a 1:1
+ * relationship. The relationship exists only because the caller supplied this evidence-backed binding
+ * profile.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError, requirePositiveInteger } from "../core/validation.js";
+import { resolveCaptureMode } from "./capture-mode.js";
+import { parseSensorColorSamplingProfile } from "./color-sampling.js";
+function requireRecord(value, path) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an object.");
+    }
+    return value;
+}
+function requireNonEmptyString(value, path) {
+    if (typeof value !== "string" ||
+        value.trim().length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty string.");
+    }
+    return value;
+}
+function requirePositiveSafeInteger(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value <= 0) {
+        throw new InvalidConfigurationError(path + " must be a positive safe integer.");
+    }
+    return value;
+}
+function parseBoundNativeRaster(value) {
+    const nativeRaster = requireRecord(value, "colorSamplingBinding.nativeRaster");
+    const pixelWidth = requirePositiveSafeInteger(nativeRaster.pixelWidth, "colorSamplingBinding.nativeRaster.pixelWidth");
+    const pixelHeight = requirePositiveSafeInteger(nativeRaster.pixelHeight, "colorSamplingBinding.nativeRaster.pixelHeight");
+    if (!Number.isSafeInteger(pixelWidth * pixelHeight)) {
+        throw new InvalidConfigurationError("colorSamplingBinding.nativeRaster total image-sample count must be a safe integer.");
+    }
+    return {
+        pixelWidth,
+        pixelHeight
+    };
+}
+function safeProduct(values, path) {
+    let result = 1;
+    for (const value of values) {
+        result *= value;
+        if (!Number.isSafeInteger(result)) {
+            throw new InvalidScientificInputError(path + " must remain a safe integer.");
+        }
+    }
+    return result;
+}
+function validateNativeRaster(raster) {
+    requirePositiveInteger("nativeRaster.pixelWidth", raster.pixelWidth);
+    requirePositiveInteger("nativeRaster.pixelHeight", raster.pixelHeight);
+    safeProduct([raster.pixelWidth, raster.pixelHeight], "nativeRaster total image-sample count");
+}
+function requireFullFrameSampleIndex(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be a non-negative safe integer full-frame mode sample index.");
+    }
+    return value;
+}
+/**
+ * Parses the explicit relationship between the canonical native effective image
+ * raster and the separate native sensor color-sampling-site lattice.
+ *
+ * This first binding supports only regular rectangular site blocks with a
+ * shared native top-left anchor. Irregular mappings, sparse exceptions and
+ * mode-specific declared-effective rasters require later explicit contracts.
+ */
+export function parseNativeEffectiveRasterColorSamplingBindingProfile(value) {
+    const profile = requireRecord(value, "colorSamplingBinding");
+    if (profile.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('colorSamplingBinding.schemaVersion must be "0.1.0".');
+    }
+    const relationship = requireRecord(profile.relationship, "colorSamplingBinding.relationship");
+    if (relationship.kind !==
+        "regular-native-effective-sample-blocks") {
+        throw new InvalidConfigurationError("colorSamplingBinding.relationship.kind is invalid.");
+    }
+    if (relationship.anchor !==
+        "shared-native-top-left") {
+        throw new InvalidConfigurationError('colorSamplingBinding.relationship.anchor must be "shared-native-top-left".');
+    }
+    return {
+        schemaVersion: "0.1.0",
+        bindingId: requireNonEmptyString(profile.bindingId, "colorSamplingBinding.bindingId"),
+        colorSamplingProfileId: requireNonEmptyString(profile.colorSamplingProfileId, "colorSamplingBinding.colorSamplingProfileId"),
+        nativeRaster: parseBoundNativeRaster(profile.nativeRaster),
+        evidence: parseEvidenceList(profile.evidence, "colorSamplingBinding.evidence"),
+        relationship: {
+            kind: "regular-native-effective-sample-blocks",
+            sitesPerNativeSampleX: requirePositiveSafeInteger(relationship.sitesPerNativeSampleX, "colorSamplingBinding.relationship.sitesPerNativeSampleX"),
+            sitesPerNativeSampleY: requirePositiveSafeInteger(relationship.sitesPerNativeSampleY, "colorSamplingBinding.relationship.sitesPerNativeSampleY"),
+            anchor: "shared-native-top-left"
+        }
+    };
+}
+/**
+ * Validates and resolves the sensor-level binding between NativeImageRaster and
+ * an exact monochrome/periodic color-sampling topology.
+ *
+ * Matching dimensions are never treated as proof of a 1:1 relationship. The
+ * relationship exists only because the caller supplied this evidence-backed
+ * binding profile.
+ */
+export function resolveNativeEffectiveRasterColorSamplingBinding(input) {
+    validateNativeRaster(input.nativeRaster);
+    const colorSamplingProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
+    const bindingProfile = parseNativeEffectiveRasterColorSamplingBindingProfile(input.bindingProfile);
+    if (bindingProfile.colorSamplingProfileId !==
+        colorSamplingProfile.profileId) {
+        throw new InvalidScientificInputError("Binding colorSamplingProfileId must match colorSamplingProfile.profileId.");
+    }
+    if (bindingProfile.nativeRaster.pixelWidth !==
+        input.nativeRaster.pixelWidth ||
+        bindingProfile.nativeRaster.pixelHeight !==
+            input.nativeRaster.pixelHeight) {
+        throw new InvalidScientificInputError("Binding nativeRaster must exactly match the supplied canonical native effective raster.");
+    }
+    if (colorSamplingProfile.layout.kind === "layered") {
+        throw new InvalidScientificInputError("Layered color sampling cannot be bound to NativeImageRaster until its per-layer spatial sampling relationship is explicitly modeled.");
+    }
+    if (colorSamplingProfile.coordinateSystem !==
+        "native-sensor-color-sampling-site-index") {
+        throw new InvalidScientificInputError("Resolvable color sampling binding requires the native sensor color-sampling-site coordinate system.");
+    }
+    const widthSites = safeProduct([
+        input.nativeRaster.pixelWidth,
+        bindingProfile.relationship
+            .sitesPerNativeSampleX
+    ], "color-sampling site-grid width");
+    const heightSites = safeProduct([
+        input.nativeRaster.pixelHeight,
+        bindingProfile.relationship
+            .sitesPerNativeSampleY
+    ], "color-sampling site-grid height");
+    const totalColorSamplingSites = safeProduct([widthSites, heightSites], "color-sampling site-grid total site count");
+    const oneToOne = bindingProfile.relationship
+        .sitesPerNativeSampleX === 1 &&
+        bindingProfile.relationship
+            .sitesPerNativeSampleY === 1;
+    return {
+        bindingId: bindingProfile.bindingId,
+        colorSamplingProfileId: bindingProfile.colorSamplingProfileId,
+        nativeRaster: {
+            ...input.nativeRaster
+        },
+        relationshipMeaning: oneToOne
+            ? "one-native-effective-sample-to-one-color-site"
+            : "one-native-effective-sample-to-rectangular-color-site-block",
+        relationship: {
+            ...bindingProfile.relationship
+        },
+        colorSamplingSiteGrid: {
+            widthSites,
+            heightSites
+        },
+        totalColorSamplingSites,
+        nativeImageRasterBindingEstablished: true,
+        physicalPhotodiodeBindingEstablished: false,
+        physicalPhotodiodeCountInference: "not-permitted",
+        spectralResponseEstablished: false,
+        componentEvidence: {
+            binding: bindingProfile.evidence,
+            colorSamplingProfile: colorSamplingProfile.evidence
+        }
+    };
+}
+function countResidueInRange(start, length, period, residue) {
+    const startResidue = start % period;
+    const delta = (residue - startResidue + period) %
+        period;
+    if (delta >= length) {
+        return 0;
+    }
+    return (1 +
+        Math.floor((length - 1 - delta) / period));
+}
+function channelCountsForSiteRect(profile, rect) {
+    const totalSites = safeProduct([rect.width, rect.height], "color-sampling contributor site count");
+    if (profile.layout.kind === "layered") {
+        throw new InvalidScientificInputError("Layered color sampling does not have resolvable site contributors in schema 0.1.0.");
+    }
+    if (profile.layout.kind === "monochrome") {
+        return [
+            {
+                channelId: profile.layout.channelId,
+                siteCount: totalSites
+            }
+        ];
+    }
+    const counts = new Map();
+    for (let tileY = 0; tileY < profile.layout.repeatHeightSites; tileY += 1) {
+        const countY = countResidueInRange(rect.y, rect.height, profile.layout.repeatHeightSites, tileY);
+        if (countY === 0) {
+            continue;
+        }
+        for (let tileX = 0; tileX < profile.layout.repeatWidthSites; tileX += 1) {
+            const countX = countResidueInRange(rect.x, rect.width, profile.layout.repeatWidthSites, tileX);
+            if (countX === 0) {
+                continue;
+            }
+            const tileIndex = tileY *
+                profile.layout.repeatWidthSites +
+                tileX;
+            const channelId = profile.layout.siteChannelIds[tileIndex];
+            if (channelId === undefined) {
+                throw new InvalidScientificInputError("Periodic color-sampling tile resolution failed while calculating contributor counts.");
+            }
+            const siteCount = safeProduct([countX, countY], "per-channel contributor site count");
+            const prior = counts.get(channelId) ?? 0;
+            const next = prior + siteCount;
+            if (!Number.isSafeInteger(next)) {
+                throw new InvalidScientificInputError("Per-channel contributor site count must remain a safe integer.");
+            }
+            counts.set(channelId, next);
+        }
+    }
+    const result = Array.from(counts, ([channelId, siteCount]) => ({
+        channelId,
+        siteCount
+    }));
+    const countedTotal = result.reduce((sum, entry) => sum + entry.siteCount, 0);
+    if (countedTotal !== totalSites) {
+        throw new InvalidScientificInputError("Color-sampling contributor channel counts do not cover the complete contributor site rectangle.");
+    }
+    return result;
+}
+/**
+ * Resolves which color-sampling sites form the pre-reconstruction structural source region for one selected
+ * capture-mode effective sample.
+ *
+ * The mode sample index is always absolute in the selected mode's full-frame
+ * per-frame raster. The API intentionally does not accept crop-local indices,
+ * preventing active-crop origins from silently resetting CFA phase.
+ *
+ * For grouped-native-sample modes, the returned site rectangle covers all
+ * native effective samples in the declared regular group. This is a structural
+ * pre-reconstruction association only: the engine reports channel-site counts
+ * but never claims complete downstream digital-pixel dependency or invents
+ * signal-combination weights, sum/average semantics, spectral response, or
+ * photon/electron values.
+ *
+ * Declared-effective-raster modes fail closed because #68 explicitly says
+ * their relationship to the native effective grid is not safely expressible as
+ * simple integer grouping.
+ *
+ * Inter-frame sensor shifts are preserved as capture-mode metadata only. The
+ * sensor and CFA move together, so those offsets do not change site channel
+ * assignment; their optical-registration effect belongs to a later spatial
+ * sampling/image-formation contract.
+ */
+export function resolveCaptureModeColorSamplingContributors(input) {
+    const colorSamplingProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
+    const binding = resolveNativeEffectiveRasterColorSamplingBinding({
+        nativeRaster: input.nativeRaster,
+        colorSamplingProfile,
+        bindingProfile: input.bindingProfile
+    });
+    const captureMode = resolveCaptureMode({
+        nativeRaster: input.nativeRaster,
+        profile: input.captureModeProfile,
+        modeId: input.modeId
+    });
+    if (!captureMode.dependencies.includes("color-sampling-model")) {
+        throw new InvalidScientificInputError("Selected capture mode must declare the color-sampling-model dependency before color-site contributors can be resolved.");
+    }
+    const modeX = requireFullFrameSampleIndex(input.modeSampleIndexFullFrame.x, "modeSampleIndexFullFrame.x");
+    const modeY = requireFullFrameSampleIndex(input.modeSampleIndexFullFrame.y, "modeSampleIndexFullFrame.y");
+    if (captureMode.perFrameSampling.kind ===
+        "declared-effective-raster") {
+        throw new InvalidScientificInputError("declared-effective-raster capture modes require a separate mode-specific color-site binding; no relationship may be inferred from raster dimensions alone.");
+    }
+    const modeSampleRaster = captureMode.perFrameSampling.raster;
+    if (modeX >= modeSampleRaster.pixelWidth ||
+        modeY >= modeSampleRaster.pixelHeight) {
+        throw new InvalidScientificInputError("modeSampleIndexFullFrame must lie within the selected mode's full-frame per-frame sampling raster.");
+    }
+    let nativeEffectiveSampleRect;
+    let grouping;
+    if (captureMode.perFrameSampling.kind ===
+        "native-effective-raster") {
+        if (input.groupedSamplingAnchor !== undefined) {
+            throw new InvalidScientificInputError("groupedSamplingAnchor must be omitted for native-effective-raster capture modes.");
+        }
+        nativeEffectiveSampleRect = {
+            x: modeX,
+            y: modeY,
+            width: 1,
+            height: 1
+        };
+        grouping = null;
+    }
+    else {
+        if (input.groupedSamplingAnchor === undefined ||
+            input.groupedSamplingAnchor.anchor !==
+                "native-effective-raster-top-left") {
+            throw new InvalidScientificInputError("grouped-native-samples capture modes require an explicit native-effective-raster-top-left grouping anchor declaration.");
+        }
+        const groupingAnchorEvidence = parseEvidenceList(input.groupedSamplingAnchor.evidence, "groupedSamplingAnchor.evidence");
+        const groupWidth = captureMode.perFrameSampling
+            .groupWidthSamples.value;
+        const groupHeight = captureMode.perFrameSampling
+            .groupHeightSamples.value;
+        nativeEffectiveSampleRect = {
+            x: safeProduct([modeX, groupWidth], "native effective sample rectangle x"),
+            y: safeProduct([modeY, groupHeight], "native effective sample rectangle y"),
+            width: groupWidth,
+            height: groupHeight
+        };
+        grouping = {
+            groupWidthSamples: captureMode.perFrameSampling
+                .groupWidthSamples,
+            groupHeightSamples: captureMode.perFrameSampling
+                .groupHeightSamples,
+            ...(captureMode.perFrameSampling
+                .combinationDomain === undefined
+                ? {}
+                : {
+                    combinationDomain: captureMode.perFrameSampling
+                        .combinationDomain
+                }),
+            anchor: "native-effective-raster-top-left",
+            anchorEvidence: groupingAnchorEvidence
+        };
+    }
+    const sitesPerNativeX = binding.relationship
+        .sitesPerNativeSampleX;
+    const sitesPerNativeY = binding.relationship
+        .sitesPerNativeSampleY;
+    const colorSamplingSiteRect = {
+        x: safeProduct([
+            nativeEffectiveSampleRect.x,
+            sitesPerNativeX
+        ], "color-sampling contributor rectangle x"),
+        y: safeProduct([
+            nativeEffectiveSampleRect.y,
+            sitesPerNativeY
+        ], "color-sampling contributor rectangle y"),
+        width: safeProduct([
+            nativeEffectiveSampleRect.width,
+            sitesPerNativeX
+        ], "color-sampling contributor rectangle width"),
+        height: safeProduct([
+            nativeEffectiveSampleRect.height,
+            sitesPerNativeY
+        ], "color-sampling contributor rectangle height")
+    };
+    if (colorSamplingSiteRect.x +
+        colorSamplingSiteRect.width >
+        binding.colorSamplingSiteGrid.widthSites ||
+        colorSamplingSiteRect.y +
+            colorSamplingSiteRect.height >
+            binding.colorSamplingSiteGrid.heightSites) {
+        throw new InvalidScientificInputError("Resolved color-sampling contributor rectangle exceeds the bound color-site grid.");
+    }
+    const totalContributorSites = safeProduct([
+        colorSamplingSiteRect.width,
+        colorSamplingSiteRect.height
+    ], "total contributor site count");
+    const channelSiteCounts = channelCountsForSiteRect(colorSamplingProfile, colorSamplingSiteRect);
+    const firstChannel = channelSiteCounts[0];
+    if (firstChannel === undefined) {
+        throw new InvalidScientificInputError("Resolved structural source region must contain at least one color-sampling channel.");
+    }
+    const channelComposition = channelSiteCounts.length === 1
+        ? {
+            kind: "single-channel",
+            channelId: firstChannel.channelId
+        }
+        : {
+            kind: "mixed-channels",
+            channelIds: channelSiteCounts.map((entry) => entry.channelId)
+        };
+    return {
+        modeId: captureMode.modeId,
+        colorSamplingProfileId: colorSamplingProfile.profileId,
+        modeSampleCoordinateSystem: "capture-mode-full-frame-effective-sample-index",
+        modeSampleIndexFullFrame: {
+            x: modeX,
+            y: modeY
+        },
+        modeSampleRaster: {
+            ...modeSampleRaster
+        },
+        modeSamplingKind: captureMode.perFrameSampling.kind,
+        nativeEffectiveSampleRect,
+        colorSamplingSiteRect,
+        colorSamplingSiteGrid: {
+            ...binding.colorSamplingSiteGrid
+        },
+        totalContributorSites,
+        channelSiteCounts,
+        channelComposition,
+        grouping,
+        ...(captureMode
+            .interFrameSensorOffsetsNativeSamples ===
+            undefined
+            ? {}
+            : {
+                interFrameSensorOffsetsNativeSamples: captureMode
+                    .interFrameSensorOffsetsNativeSamples
+            }),
+        sensorShiftChangesColorSiteAssignment: false,
+        sensorShiftOpticalRegistration: "outside-this-contract",
+        structuralSourceStage: "pre-reconstruction",
+        completeDownstreamPixelDependencyEstablished: false,
+        signalCombinationWeightingEstablished: false,
+        spectralResponseEstablished: false,
+        physicalPhotodiodeBindingEstablished: false,
+        physicalPhotodiodeCountInference: "not-permitted",
+        componentEvidence: {
+            binding: binding.componentEvidence.binding,
+            colorSamplingProfile: binding.componentEvidence
+                .colorSamplingProfile,
+            captureMode: captureMode.modeEvidence
+        }
+    };
+}
+//# sourceMappingURL=capture-color-sampling-binding.js.map

package/dist/sensor/capture-color-sampling-binding.js.map

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

package/dist/sensor/capture-mode-timing.d.ts

@@ -0,0 +1,63 @@
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { RasterPoint, RasterRect } from "../output/capture-geometry.js";
+import { type CaptureExposureWindows, type ExposureBoundarySchedule, type SourcedCaptureTimingSeconds } from "./exposure-window.js";
+import type { ResolvedCaptureMode } from "./capture-mode.js";
+import { type CaptureShutterMechanism, type SensorReadoutTiming, type SensorReadoutTimingDeclaration } from "./readout-timing.js";
+import type { NativeImageRaster } from "./sensor-geometry.js";
+export declare const CAPTURE_MODE_TIMING_PROFILE_SCHEMA_VERSION: "0.1.0";
+export interface CaptureModeTimingProfile {
+    schemaVersion: typeof CAPTURE_MODE_TIMING_PROFILE_SCHEMA_VERSION;
+    profileId: string;
+    profileVersion: string;
+    captureModeId: string;
+    scientificStatus: "approximation";
+    scheduleFamily: "global-or-uniform-linear-native-scan";
+    shutterMechanism: CaptureShutterMechanism;
+    opening: ExposureBoundarySchedule;
+    closing: ExposureBoundarySchedule;
+    readout: SensorReadoutTimingDeclaration;
+    nonUniformScheduleModeled: false;
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+export interface ResolveCaptureModeTimingInput {
+    captureMode: ResolvedCaptureMode;
+    timingProfile: CaptureModeTimingProfile;
+    nominalExposureDurationSeconds: SourcedCaptureTimingSeconds;
+    activeCaptureRect?: RasterRect;
+    samplePointsNative?: readonly RasterPoint[];
+}
+export interface ResolvedCaptureModeTiming {
+    schemaVersion: typeof CAPTURE_MODE_TIMING_PROFILE_SCHEMA_VERSION;
+    timingProfileId: string;
+    timingProfileVersion: string;
+    captureModeId: string;
+    captureModeTimingIdentity: "exact-mode-and-profile";
+    nativeRaster: NativeImageRaster;
+    modeDeclaresTimingDependency: boolean;
+    scheduleFamily: "global-or-uniform-linear-native-scan";
+    exposureWindows: CaptureExposureWindows;
+    readoutTiming: SensorReadoutTiming;
+    timeReference: "first-opening-boundary-phase";
+    readoutExposureSynchronization: "not-assumed";
+    nonUniformScheduleModeled: false;
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+/**
+ * Parses timing facts that are explicitly bound to one exact capture mode.
+ *
+ * Schema 0.1.0 intentionally admits only the timing schedule families already
+ * owned by #12: simultaneous/global or uniform-linear native scans. Unsupported
+ * non-uniform/segmented schedules fail closed instead of being approximated.
+ */
+export declare function parseCaptureModeTimingProfile(value: unknown): CaptureModeTimingProfile;
+/**
+ * Resolves the authoritative exposure/readout timing for one exact capture
+ * mode and timing-profile identity.
+ *
+ * Readout timing remains distinct from exposure-boundary timing. No absolute
+ * readout/exposure synchronization is inferred.
+ */
+export declare function resolveCaptureModeTiming(input: ResolveCaptureModeTimingInput): ResolvedCaptureModeTiming;
+//# sourceMappingURL=capture-mode-timing.d.ts.map

package/dist/sensor/capture-mode-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-mode-timing.d.ts","sourceRoot":"","sources":["../../src/sensor/capture-mode-timing.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACX,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAE7B,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EAGpC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,0CAA0C,EACrD,OAAgB,CAAC;AAEnB,MAAM,WAAW,wBAAwB;IACvC,aAAa,EACX,OAAO,0CAA0C,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,eAAe,CAAC;IAClC,cAAc,EACZ,sCAAsC,CAAC;IACzC,gBAAgB,EACd,uBAAuB,CAAC;IAC1B,OAAO,EACL,wBAAwB,CAAC;IAC3B,OAAO,EACL,wBAAwB,CAAC;IAC3B,OAAO,EACL,8BAA8B,CAAC;IACjC,yBAAyB,EAAE,KAAK,CAAC;IACjC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EACT,mBAAmB,CAAC;IACtB,aAAa,EACX,wBAAwB,CAAC;IAC3B,8BAA8B,EAC5B,2BAA2B,CAAC;IAC9B,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,kBAAkB,CAAC,EACjB,SAAS,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EACX,OAAO,0CAA0C,CAAC;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB,EACvB,wBAAwB,CAAC;IAC3B,YAAY,EAAE,iBAAiB,CAAC;IAChC,4BAA4B,EAC1B,OAAO,CAAC;IACV,cAAc,EACZ,sCAAsC,CAAC;IACzC,eAAe,EACb,sBAAsB,CAAC;IACzB,aAAa,EACX,mBAAmB,CAAC;IACtB,aAAa,EACX,8BAA8B,CAAC;IACjC,8BAA8B,EAC5B,aAAa,CAAC;IAChB,yBAAyB,EAAE,KAAK,CAAC;IACjC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AA+PD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,wBAAwB,CAyG1B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EACH,6BAA6B,GAC9B,yBAAyB,CAuG3B"}