@photivra/engine 0.5.1 → 1.0.0

package/dist/sensor/capture-mode.js

@@ -0,0 +1,447 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses a capture-mode profile without inferring sensor physics from output resolution or marketing
+ * mode names. The profile is intentionally orthogonal: acquisition frame sequence, per-frame sampling,
+ * optional inter-frame sensor shift, reconstruction stages, processed raster and downstream
+ * dependencies are independent axes.
+ * Resolves one capture mode against the selected sensor's native effective image-sampling raster.
+ * Resolution changes do not mutate physical sensor geometry. The returned processed raster is
+ * pre-output geometry and must not be used to infer crop factor, field of view or physical photosite
+ * count.
+ * @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";
+const COMBINATION_DOMAINS = new Set([
+    "charge-domain",
+    "pre-conversion-analog",
+    "post-conversion-digital"
+]);
+const RECONSTRUCTION_STAGES = new Set([
+    "remosaic",
+    "pixel-shift-combination",
+    "multi-frame-computational-combination"
+]);
+const DEPENDENCIES = new Set([
+    "color-sampling-model",
+    "mode-specific-readout-timing",
+    "radiometric-calibration",
+    "inter-frame-registration"
+]);
+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 requirePositiveSafeIntegerValue(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value <= 0) {
+        throw new InvalidConfigurationError(path + " must be a positive safe integer.");
+    }
+    return value;
+}
+function parseIntegerFact(value, path) {
+    const record = requireRecord(value, path);
+    return {
+        value: requirePositiveSafeIntegerValue(record.value, path + ".value"),
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseRasterDimensions(value, path) {
+    const record = requireRecord(value, path);
+    const pixelWidth = requirePositiveSafeIntegerValue(record.pixelWidth, path + ".pixelWidth");
+    const pixelHeight = requirePositiveSafeIntegerValue(record.pixelHeight, path + ".pixelHeight");
+    const total = pixelWidth * pixelHeight;
+    if (!Number.isSafeInteger(total)) {
+        throw new InvalidConfigurationError(path + " total sample count must be a safe integer.");
+    }
+    return { pixelWidth, pixelHeight };
+}
+function parseRasterFact(value, path) {
+    const record = requireRecord(value, path);
+    return {
+        value: parseRasterDimensions(record.value, path + ".value"),
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseCombinationDomainFact(value, path) {
+    const record = requireRecord(value, path);
+    if (typeof record.value !== "string" ||
+        !COMBINATION_DOMAINS.has(record.value)) {
+        throw new InvalidConfigurationError(path + ".value is invalid.");
+    }
+    return {
+        value: record.value,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseAcquisition(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "single-frame") {
+        if (record.frameCount !== undefined ||
+            record.minimumFrameCount !== undefined ||
+            record.maximumFrameCount !== undefined ||
+            record.evidence !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " single-frame acquisition must omit frame-count and evidence fields.");
+        }
+        return { kind: "single-frame" };
+    }
+    if (record.kind === "fixed-multi-frame") {
+        if (record.minimumFrameCount !== undefined ||
+            record.maximumFrameCount !== undefined ||
+            record.evidence !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " fixed-multi-frame acquisition must use frameCount only.");
+        }
+        const frameCount = parseIntegerFact(record.frameCount, path + ".frameCount");
+        if (frameCount.value < 2) {
+            throw new InvalidConfigurationError(path +
+                ".frameCount.value must be at least 2 for fixed-multi-frame acquisition.");
+        }
+        return {
+            kind: "fixed-multi-frame",
+            frameCount
+        };
+    }
+    if (record.kind === "variable-multi-frame") {
+        if (record.frameCount !== undefined) {
+            throw new InvalidConfigurationError(path +
+                ".frameCount must be omitted for variable-multi-frame acquisition.");
+        }
+        const evidence = parseEvidenceList(record.evidence, path + ".evidence");
+        const minimumFrameCount = record.minimumFrameCount === undefined
+            ? undefined
+            : parseIntegerFact(record.minimumFrameCount, path + ".minimumFrameCount");
+        const maximumFrameCount = record.maximumFrameCount === undefined
+            ? undefined
+            : parseIntegerFact(record.maximumFrameCount, path + ".maximumFrameCount");
+        if (minimumFrameCount !== undefined &&
+            minimumFrameCount.value < 2) {
+            throw new InvalidConfigurationError(path +
+                ".minimumFrameCount.value must be at least 2 for variable-multi-frame acquisition.");
+        }
+        if (maximumFrameCount !== undefined &&
+            maximumFrameCount.value < 2) {
+            throw new InvalidConfigurationError(path +
+                ".maximumFrameCount.value must be at least 2 for variable-multi-frame acquisition.");
+        }
+        if (minimumFrameCount !== undefined &&
+            maximumFrameCount !== undefined &&
+            minimumFrameCount.value > maximumFrameCount.value) {
+            throw new InvalidConfigurationError(path +
+                ".minimumFrameCount.value must not exceed maximumFrameCount.value.");
+        }
+        return {
+            kind: "variable-multi-frame",
+            evidence,
+            ...(minimumFrameCount === undefined
+                ? {}
+                : { minimumFrameCount }),
+            ...(maximumFrameCount === undefined
+                ? {}
+                : { maximumFrameCount })
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+function parsePerFrameSampling(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "native-effective-raster") {
+        if (record.groupWidthSamples !== undefined ||
+            record.groupHeightSamples !== undefined ||
+            record.combinationDomain !== undefined ||
+            record.raster !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " native-effective-raster sampling must omit grouping/raster fields.");
+        }
+        return { kind: "native-effective-raster" };
+    }
+    if (record.kind === "grouped-native-samples") {
+        if (record.raster !== undefined) {
+            throw new InvalidConfigurationError(path +
+                ".raster must be omitted for grouped-native-samples sampling.");
+        }
+        return {
+            kind: "grouped-native-samples",
+            groupWidthSamples: parseIntegerFact(record.groupWidthSamples, path + ".groupWidthSamples"),
+            groupHeightSamples: parseIntegerFact(record.groupHeightSamples, path + ".groupHeightSamples"),
+            ...(record.combinationDomain === undefined
+                ? {}
+                : {
+                    combinationDomain: parseCombinationDomainFact(record.combinationDomain, path + ".combinationDomain")
+                })
+        };
+    }
+    if (record.kind === "declared-effective-raster") {
+        if (record.groupWidthSamples !== undefined ||
+            record.groupHeightSamples !== undefined ||
+            record.combinationDomain !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " declared-effective-raster sampling must omit grouping fields.");
+        }
+        return {
+            kind: "declared-effective-raster",
+            raster: parseRasterFact(record.raster, path + ".raster")
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+function parseOffsetsFact(value, path) {
+    const record = requireRecord(value, path);
+    if (!Array.isArray(record.value) ||
+        record.value.length === 0) {
+        throw new InvalidConfigurationError(path + ".value must be a non-empty array.");
+    }
+    const offsets = record.value.map((entry, index) => {
+        const item = requireRecord(entry, path + ".value[" + index + "]");
+        if (typeof item.x !== "number" ||
+            !Number.isFinite(item.x) ||
+            typeof item.y !== "number" ||
+            !Number.isFinite(item.y)) {
+            throw new InvalidConfigurationError(path +
+                ".value[" +
+                index +
+                "] x/y must be finite numbers.");
+        }
+        return {
+            x: item.x,
+            y: item.y
+        };
+    });
+    return {
+        value: offsets,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseReconstructionStages(value, path) {
+    if (!Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an array.");
+    }
+    const stages = value.map((entry, index) => {
+        const record = requireRecord(entry, path + "[" + index + "]");
+        if (typeof record.value !== "string" ||
+            !RECONSTRUCTION_STAGES.has(record.value)) {
+            throw new InvalidConfigurationError(path + "[" + index + "].value is invalid.");
+        }
+        return {
+            value: record.value,
+            evidence: parseEvidenceList(record.evidence, path + "[" + index + "].evidence")
+        };
+    });
+    const values = stages.map((stage) => stage.value);
+    if (new Set(values).size !== values.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicate stages.");
+    }
+    return stages;
+}
+function parseDependencies(value, path) {
+    if (!Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an array.");
+    }
+    const dependencies = value.map((entry, index) => {
+        if (typeof entry !== "string" ||
+            !DEPENDENCIES.has(entry)) {
+            throw new InvalidConfigurationError(path + "[" + index + "] is invalid.");
+        }
+        return entry;
+    });
+    if (new Set(dependencies).size !== dependencies.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicates.");
+    }
+    return dependencies;
+}
+function parseModeDefinition(value, path) {
+    const record = requireRecord(value, path);
+    const modeId = requireNonEmptyString(record.modeId, path + ".modeId");
+    const acquisition = parseAcquisition(record.acquisition, path + ".acquisition");
+    const interFrameSensorOffsetsNativeSamples = record.interFrameSensorOffsetsNativeSamples === undefined
+        ? undefined
+        : parseOffsetsFact(record.interFrameSensorOffsetsNativeSamples, path + ".interFrameSensorOffsetsNativeSamples");
+    if (interFrameSensorOffsetsNativeSamples !== undefined &&
+        acquisition.kind !== "fixed-multi-frame") {
+        throw new InvalidConfigurationError(path +
+            ".interFrameSensorOffsetsNativeSamples is supported only for fixed-multi-frame acquisition.");
+    }
+    if (interFrameSensorOffsetsNativeSamples !== undefined &&
+        acquisition.kind === "fixed-multi-frame" &&
+        interFrameSensorOffsetsNativeSamples.value.length !==
+            acquisition.frameCount.value) {
+        throw new InvalidConfigurationError(path +
+            ".interFrameSensorOffsetsNativeSamples.value length must equal acquisition.frameCount.value.");
+    }
+    return {
+        modeId,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence"),
+        acquisition,
+        perFrameSampling: parsePerFrameSampling(record.perFrameSampling, path + ".perFrameSampling"),
+        ...(interFrameSensorOffsetsNativeSamples === undefined
+            ? {}
+            : { interFrameSensorOffsetsNativeSamples }),
+        reconstructionStages: record.reconstructionStages === undefined
+            ? []
+            : parseReconstructionStages(record.reconstructionStages, path + ".reconstructionStages"),
+        processedImageRaster: parseRasterFact(record.processedImageRaster, path + ".processedImageRaster"),
+        dependencies: record.dependencies === undefined
+            ? []
+            : parseDependencies(record.dependencies, path + ".dependencies")
+    };
+}
+/**
+ * Parses a capture-mode profile without inferring sensor physics from output
+ * resolution or marketing mode names.
+ *
+ * The profile is intentionally orthogonal: acquisition frame sequence,
+ * per-frame sampling, optional inter-frame sensor shift, reconstruction stages,
+ * processed raster and downstream dependencies are independent axes.
+ */
+export function parseCaptureModeProfile(value) {
+    const profile = requireRecord(value, "captureModes");
+    if (profile.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('captureModes.schemaVersion must be "0.1.0".');
+    }
+    if (!Array.isArray(profile.modes) ||
+        profile.modes.length === 0) {
+        throw new InvalidConfigurationError("captureModes.modes must be a non-empty array.");
+    }
+    const modes = profile.modes.map((mode, index) => parseModeDefinition(mode, "captureModes.modes[" + index + "]"));
+    const ids = modes.map((mode) => mode.modeId);
+    if (new Set(ids).size !== ids.length) {
+        throw new InvalidConfigurationError("captureModes.modes must not contain duplicate modeId values.");
+    }
+    return {
+        schemaVersion: "0.1.0",
+        modes
+    };
+}
+function validateNativeRaster(raster) {
+    requirePositiveInteger("nativeRaster.pixelWidth", raster.pixelWidth);
+    requirePositiveInteger("nativeRaster.pixelHeight", raster.pixelHeight);
+    const total = raster.pixelWidth * raster.pixelHeight;
+    if (!Number.isSafeInteger(total)) {
+        throw new InvalidScientificInputError("nativeRaster total image-sample count must be a safe integer.");
+    }
+}
+function resolvePerFrameSampling(sampling, nativeRaster) {
+    if (sampling.kind === "native-effective-raster") {
+        return {
+            kind: "native-effective-raster",
+            raster: { ...nativeRaster }
+        };
+    }
+    if (sampling.kind === "declared-effective-raster") {
+        return {
+            kind: "declared-effective-raster",
+            raster: {
+                value: { ...sampling.raster.value },
+                evidence: sampling.raster.evidence
+            }
+        };
+    }
+    const groupWidth = sampling.groupWidthSamples.value;
+    const groupHeight = sampling.groupHeightSamples.value;
+    if (nativeRaster.pixelWidth % groupWidth !== 0 ||
+        nativeRaster.pixelHeight % groupHeight !== 0) {
+        throw new InvalidScientificInputError("Grouped native sampling requires nativeRaster dimensions to be exactly divisible by the declared grouping factors.");
+    }
+    return {
+        kind: "grouped-native-samples",
+        raster: {
+            pixelWidth: nativeRaster.pixelWidth / groupWidth,
+            pixelHeight: nativeRaster.pixelHeight / groupHeight
+        },
+        groupWidthSamples: sampling.groupWidthSamples,
+        groupHeightSamples: sampling.groupHeightSamples,
+        ...(sampling.combinationDomain === undefined
+            ? {}
+            : {
+                combinationDomain: sampling.combinationDomain
+            })
+    };
+}
+/**
+ * Resolves one capture mode against the selected sensor's native effective
+ * image-sampling raster.
+ *
+ * Resolution changes do not mutate physical sensor geometry. The returned
+ * processed raster is pre-output geometry and must not be used to infer crop
+ * factor, field of view or physical photosite count.
+ */
+export function resolveCaptureMode(input) {
+    validateNativeRaster(input.nativeRaster);
+    if (typeof input.modeId !== "string" ||
+        input.modeId.trim().length === 0) {
+        throw new InvalidScientificInputError("modeId must be a non-empty string.");
+    }
+    const profile = parseCaptureModeProfile(input.profile);
+    const mode = profile.modes.find((candidate) => candidate.modeId === input.modeId);
+    if (mode === undefined) {
+        throw new InvalidScientificInputError("modeId does not exist in the supplied capture-mode profile.");
+    }
+    const processedTotal = mode.processedImageRaster.value.pixelWidth *
+        mode.processedImageRaster.value.pixelHeight;
+    if (!Number.isSafeInteger(processedTotal)) {
+        throw new InvalidScientificInputError("processedImageRaster total image-sample count must be a safe integer.");
+    }
+    const acquisition = mode.acquisition.kind === "single-frame"
+        ? {
+            kind: "single-frame",
+            frameCount: 1
+        }
+        : mode.acquisition.kind === "fixed-multi-frame"
+            ? {
+                kind: "fixed-multi-frame",
+                frameCount: mode.acquisition.frameCount
+            }
+            : {
+                kind: "variable-multi-frame",
+                evidence: mode.acquisition.evidence,
+                ...(mode.acquisition.minimumFrameCount === undefined
+                    ? {}
+                    : {
+                        minimumFrameCount: mode.acquisition.minimumFrameCount
+                    }),
+                ...(mode.acquisition.maximumFrameCount === undefined
+                    ? {}
+                    : {
+                        maximumFrameCount: mode.acquisition.maximumFrameCount
+                    })
+            };
+    return {
+        modeId: mode.modeId,
+        modeEvidence: mode.evidence,
+        nativeRaster: { ...input.nativeRaster },
+        nativeRasterSemantic: "effective-image-sampling-grid-not-photosite-count",
+        acquisition,
+        perFrameSampling: resolvePerFrameSampling(mode.perFrameSampling, input.nativeRaster),
+        ...(mode.interFrameSensorOffsetsNativeSamples === undefined
+            ? {}
+            : {
+                interFrameSensorOffsetsNativeSamples: mode.interFrameSensorOffsetsNativeSamples
+            }),
+        reconstructionStages: mode.reconstructionStages ?? [],
+        processedImageRaster: {
+            value: {
+                ...mode.processedImageRaster.value
+            },
+            evidence: mode.processedImageRaster.evidence
+        },
+        processedImageMegapixels: processedTotal / 1_000_000,
+        dependencies: mode.dependencies ?? [],
+        physicalSensorGeometryMutation: false,
+        photositeCountInference: "not-permitted-from-native-or-processed-raster",
+        finalOutputRasterOwnership: "downstream-capture-output-geometry"
+    };
+}
+//# sourceMappingURL=capture-mode.js.map

package/dist/sensor/capture-mode.js.map

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

package/dist/sensor/color-sampling.d.ts

@@ -0,0 +1,133 @@
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+export type NativeColorSamplingSiteCoordinateSystem = "native-sensor-color-sampling-site-index";
+export type SensorColorSamplingProfileCoordinateSystem = NativeColorSamplingSiteCoordinateSystem | "native-sensor-layered-spatial-relationship-not-resolved";
+export interface NativeColorSamplingSiteIndex {
+    /**
+     * Zero-based integer site index from the native sensor's left edge.
+     *
+     * This is an abstract color-sampling-site lattice index. It is not a
+     * NativeImageRaster coordinate and does not assert one site = one physical
+     * photodiode.
+     */
+    x: number;
+    /**
+     * Zero-based integer site index from the native sensor's top edge.
+     *
+     * +Y points downward in native sensor-facing coordinates.
+     */
+    y: number;
+}
+export interface MonochromeColorSamplingLayout {
+    kind: "monochrome";
+    /**
+     * Semantic measurement-channel identifier only. It is not a spectral
+     * response curve, wavelength, colorimetric primary, or calibration.
+     */
+    channelId: string;
+}
+export interface PeriodicMosaicColorSamplingLayout {
+    kind: "periodic-mosaic";
+    /**
+     * Number of color-sampling sites in one horizontal repeat period.
+     */
+    repeatWidthSites: number;
+    /**
+     * Number of color-sampling sites in one vertical repeat period.
+     */
+    repeatHeightSites: number;
+    /**
+     * Row-major semantic channel IDs for one repeating tile.
+     *
+     * Length must equal repeatWidthSites × repeatHeightSites.
+     */
+    siteChannelIds: readonly string[];
+    /**
+     * The repeat tile is anchored at native sensor sampling-site index (0, 0).
+     *
+     * Active crops and physical orientation must not silently reset this phase.
+     */
+    anchor: "native-sensor-top-left-site";
+}
+export interface LayeredColorSamplingLayout {
+    kind: "layered";
+    /**
+     * Semantic layer/channel identifiers only. They do not define spectral
+     * response, depth ordering, spatial sampling density, or registration.
+     */
+    layerChannelIds: readonly string[];
+    /**
+     * The first layered representation is deliberately structural only because
+     * real layered sensors may use unequal per-layer spatial sampling.
+     */
+    spatialSamplingRelationship: "not-resolved";
+}
+export type SensorColorSamplingLayout = MonochromeColorSamplingLayout | PeriodicMosaicColorSamplingLayout | LayeredColorSamplingLayout;
+export interface SensorColorSamplingProfile {
+    schemaVersion: "0.1.0";
+    profileId: string;
+    /**
+     * Evidence supporting this exact topology declaration.
+     *
+     * Descriptive architecture-family metadata remains a separate contract.
+     */
+    evidence: readonly EvidenceProvenance[];
+    coordinateSystem: SensorColorSamplingProfileCoordinateSystem;
+    layout: SensorColorSamplingLayout;
+}
+export interface ResolveColorSamplingSiteInput {
+    profile: SensorColorSamplingProfile;
+    site: NativeColorSamplingSiteIndex;
+}
+export interface ResolvedColorSamplingSite {
+    profileId: string;
+    coordinateSystem: NativeColorSamplingSiteCoordinateSystem;
+    site: NativeColorSamplingSiteIndex;
+    mapping: {
+        kind: "monochrome";
+        channelId: string;
+    } | {
+        kind: "periodic-mosaic";
+        channelId: string;
+        repeatCoordinate: {
+            x: number;
+            y: number;
+        };
+        repeatWidthSites: number;
+        repeatHeightSites: number;
+    };
+    /**
+     * Explicit scientific boundaries for downstream consumers.
+     */
+    spectralResponseEstablished: false;
+    nativeImageRasterBindingEstablished: false;
+    physicalPhotodiodeBindingEstablished: false;
+}
+/**
+ * Parses an exact color-sampling topology declaration without binding it to
+ * NativeImageRaster, physical photodiodes, spectral response, or a
+ * manufacturer-specific family enum.
+ *
+ * Periodic mosaics use an abstract native sensor color-sampling-site lattice
+ * with zero-based integer indices, top-left origin, +X right and +Y down.
+ * The repeat phase is anchored to the sensor lattice, so later active crops or
+ * orientation transforms must preserve the original native site indices.
+ *
+ * Layered layouts are structural-only in this first contract because real
+ * layered sensors may use unequal spatial sampling density/registration across
+ * layers. No per-site layered resolver is exposed until that relationship is
+ * modeled explicitly.
+ */
+export declare function parseSensorColorSamplingProfile(value: unknown): SensorColorSamplingProfile;
+/**
+ * Resolves the semantic measurement-channel assignment at one abstract native
+ * sensor color-sampling-site index for monochrome or periodic-mosaic layouts.
+ *
+ * This API intentionally has no NativeImageRaster input. A later explicit
+ * binding must establish how a selected capture mode's effective raster maps
+ * to this color-sampling-site lattice before RAW/CFA sampling can be simulated.
+ *
+ * Layered layouts fail closed because their per-layer spatial relationship is
+ * not resolved by the first structural contract.
+ */
+export declare function resolveColorSamplingSite(input: ResolveColorSamplingSiteInput): ResolvedColorSamplingSite;
+//# sourceMappingURL=color-sampling.d.ts.map

package/dist/sensor/color-sampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-sampling.d.ts","sourceRoot":"","sources":["../../src/sensor/color-sampling.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAKxC,MAAM,MAAM,uCAAuC,GACjD,yCAAyC,CAAC;AAE5C,MAAM,MAAM,0CAA0C,GAClD,uCAAuC,GACvC,yDAAyD,CAAC;AAE9D,MAAM,WAAW,4BAA4B;IAC3C;;;;;;OAMG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;;;OAIG;IACH,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,iBAAiB,CAAC;IACxB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC;;;;OAIG;IACH,MAAM,EAAE,6BAA6B,CAAC;CACvC;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,SAAS,CAAC;IAChB;;;OAGG;IACH,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;OAGG;IACH,2BAA2B,EAAE,cAAc,CAAC;CAC7C;AAED,MAAM,MAAM,yBAAyB,GACjC,6BAA6B,GAC7B,iCAAiC,GACjC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,gBAAgB,EAAE,0CAA0C,CAAC;IAC7D,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,0BAA0B,CAAC;IACpC,IAAI,EAAE,4BAA4B,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,uCAAuC,CAAC;IAC1D,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EACH;QACE,IAAI,EAAE,YAAY,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,GACD;QACE,IAAI,EAAE,iBAAiB,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE;YAChB,CAAC,EAAE,MAAM,CAAC;YACV,CAAC,EAAE,MAAM,CAAC;SACX,CAAC;QACF,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACN;;OAEG;IACH,2BAA2B,EAAE,KAAK,CAAC;IACnC,mCAAmC,EAAE,KAAK,CAAC;IAC3C,oCAAoC,EAAE,KAAK,CAAC;CAC7C;AA2ND;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,0BAA0B,CA4C5B;AAmBD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,yBAAyB,CAwF3B"}