@photivra/engine 0.6.0 → 1.0.1

package/dist/capture/release-sequence.d.ts

@@ -0,0 +1,120 @@
+import { type GenericExposureBracketAxis, type GenericReleaseCapabilityProfile } from "../equipment/release-capabilities.js";
+import type { ResolvedGenericEquipmentExposureCapabilities } from "../equipment/exposure-capabilities.js";
+import { type FocusPlane } from "../optics/focus-state.js";
+export declare const RELEASE_SEQUENCE_VERSION: "0.1.0";
+export type ReleaseAutomationState = "manual" | "locked" | "continuous";
+export interface ReleaseBaseCaptureState {
+    exposure: {
+        aperture: number;
+        shutterSeconds: number;
+        iso: number;
+    };
+    focus: FocusPlane;
+    whiteBalanceStateId?: string;
+    automation: {
+        ae: ReleaseAutomationState;
+        af: ReleaseAutomationState;
+        awb: ReleaseAutomationState;
+    };
+}
+export type ReleaseDrivePolicy = {
+    kind: "single";
+} | {
+    kind: "burst";
+    frameCount: number;
+} | {
+    kind: "self-timer";
+    delaySeconds: number;
+    frameCount: number;
+};
+export type ReleaseBracketPolicy = {
+    kind: "none";
+} | {
+    kind: "exposure";
+    axis: GenericExposureBracketAxis;
+    offsetsStops: readonly number[];
+} | {
+    kind: "focus";
+    focusStates: readonly FocusPlane[];
+};
+export interface ResolveReleaseSequenceInput {
+    sequenceId: string;
+    releaseRequestTimeSeconds: number;
+    sequenceSeedUint32: number;
+    drive: ReleaseDrivePolicy;
+    bracket: ReleaseBracketPolicy;
+    requestedCadenceFps?: number;
+    baseState: ReleaseBaseCaptureState;
+    releaseCapabilities: GenericReleaseCapabilityProfile;
+    exposureCapabilities: ResolvedGenericEquipmentExposureCapabilities;
+}
+export type ReleaseTimingConstraint = "requested-cadence" | "body-maximum-cadence" | "exposure-duration" | "minimum-inter-frame-gap";
+export interface ResolvedReleaseFrame {
+    sequenceId: string;
+    frameIndex: number;
+    releaseFrameId: string;
+    exposureStartTimeSeconds: number;
+    exposureEndTimeSeconds: number;
+    sceneTimeSecondsFromSequenceStart: number;
+    startIntervalFromPreviousSeconds: number | null;
+    timingConstraints: readonly ReleaseTimingConstraint[];
+    stochasticSeedUint32: number;
+    exposure: {
+        aperture: number;
+        shutterSeconds: number;
+        iso: number;
+    };
+    focus: FocusPlane;
+    exposureBracketOffsetStops?: number;
+    automation: ReleaseBaseCaptureState["automation"];
+    whiteBalanceStateId?: string;
+}
+export interface ResolvedReleaseSequence {
+    version: typeof RELEASE_SEQUENCE_VERSION;
+    sequenceId: string;
+    status: "scheduled";
+    releaseRequestTimeSeconds: number;
+    selfTimerDelaySeconds: number;
+    requestedCadenceFps: number | null;
+    capabilityMaximumCadenceFps: number;
+    minimumInterFrameGapSeconds: number;
+    requestedFrameCount: number;
+    actualFrameCount: number;
+    sequenceSeedUint32: number;
+    baseStateSnapshot: ReleaseBaseCaptureState;
+    frames: readonly ResolvedReleaseFrame[];
+    sensorCaptureModeOwnership: "separate-logical-capture-contract";
+    whiteBalanceBracketingPhysicalCaptures: false;
+    preReleaseCaptureModeled: false;
+    bufferMediaThermalSlowdownModeled: false;
+}
+export interface CancelReleaseSequenceInput {
+    sequence: ResolvedReleaseSequence;
+    completedFrameCount: number;
+    cancelledAtSeconds: number;
+}
+export interface CancelledReleaseSequence {
+    version: typeof RELEASE_SEQUENCE_VERSION;
+    sequenceId: string;
+    status: "cancelled";
+    cancelledAtSeconds: number;
+    completedFrameCount: number;
+    omittedFrameCount: number;
+    completedFrames: readonly ResolvedReleaseFrame[];
+    sourceSequenceFrameCount: number;
+    sourceSequenceUnmodified: true;
+}
+/**
+ * Resolves one deterministic logical still-release sequence.
+ *
+ * Sensor capture-mode internals remain separate. This function schedules
+ * logical exposures only and never uses render speed/frame rate as capture
+ * timing.
+ */
+export declare function resolveReleaseSequence(input: ResolveReleaseSequenceInput): ResolvedReleaseSequence;
+/**
+ * Produces an explicit cancelled sequence state without mutating the scheduled
+ * source sequence or leaving the completed/omitted frame boundary ambiguous.
+ */
+export declare function createCancelledReleaseSequence(input: CancelReleaseSequenceInput): CancelledReleaseSequence;
+//# sourceMappingURL=release-sequence.d.ts.map

package/dist/capture/release-sequence.d.ts.map

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

package/dist/capture/release-sequence.js

@@ -0,0 +1,446 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Resolves one deterministic logical still-release sequence. Sensor capture-mode internals remain
+ * separate. This function schedules logical exposures only and never uses render speed/frame rate as
+ * capture timing.
+ * Produces an explicit cancelled sequence state without mutating the scheduled source sequence or
+ * leaving the completed/omitted frame boundary ambiguous.
+ * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { InvalidScientificInputError } from "../core/validation.js";
+import { parseGenericReleaseCapabilityProfile } from "../equipment/release-capabilities.js";
+import { parseFocusPlane } from "../optics/focus-state.js";
+export const RELEASE_SEQUENCE_VERSION = "0.1.0";
+function requireNonEmptyString(value, path) {
+    if (typeof value !== "string" ||
+        value.trim().length === 0) {
+        throw new InvalidScientificInputError(path + " must be a non-empty string.");
+    }
+    return value.trim();
+}
+function requireFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value)) {
+        throw new InvalidScientificInputError(path + " must be finite.");
+    }
+    return value;
+}
+function requireNonNegativeFinite(value, path) {
+    const parsed = requireFinite(value, path);
+    if (parsed < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be greater than or equal to zero.");
+    }
+    return parsed;
+}
+function requirePositiveFinite(value, path) {
+    const parsed = requireFinite(value, path);
+    if (parsed <= 0) {
+        throw new InvalidScientificInputError(path +
+            " must be greater than zero.");
+    }
+    return parsed;
+}
+function requirePositiveSafeInteger(value, path) {
+    if (!Number.isSafeInteger(value) ||
+        value <= 0) {
+        throw new InvalidScientificInputError(path +
+            " must be a positive safe integer.");
+    }
+    return value;
+}
+function requireUint32(value, path) {
+    if (!Number.isSafeInteger(value) ||
+        value < 0 ||
+        value > 0xffff_ffff) {
+        throw new InvalidScientificInputError(path +
+            " must be an unsigned 32-bit integer.");
+    }
+    return value;
+}
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Object.isFrozen(value)) {
+        return value;
+    }
+    Object.freeze(value);
+    for (const child of Object.values(value)) {
+        deepFreeze(child);
+    }
+    return value;
+}
+function hashFrameSeed(sequenceSeedUint32, frameIndex) {
+    let hash = 0x811c9dc5;
+    const text = sequenceSeedUint32.toString(10) +
+        ":" +
+        frameIndex.toString(10);
+    for (let index = 0; index < text.length; index += 1) {
+        hash ^= text.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return hash >>> 0;
+}
+function includesDriveMode(capabilities, drive) {
+    return capabilities
+        .supportedDriveModes
+        .value.includes(drive);
+}
+function driveFrameCount(drive) {
+    if (drive.kind === "single") {
+        return 1;
+    }
+    return requirePositiveSafeInteger(drive.frameCount, "drive.frameCount");
+}
+function bracketFrameCount(bracket) {
+    if (bracket.kind === "none") {
+        return null;
+    }
+    const count = bracket.kind === "exposure"
+        ? bracket.offsetsStops.length
+        : bracket.focusStates.length;
+    if (count <= 0) {
+        throw new InvalidScientificInputError("Bracket sequences must contain at least one frame.");
+    }
+    return count;
+}
+function resolveFrameCount(drive, bracket) {
+    const driveCount = driveFrameCount(drive);
+    const bracketCount = bracketFrameCount(bracket);
+    if (bracketCount === null) {
+        return driveCount;
+    }
+    if (drive.kind === "burst") {
+        throw new InvalidScientificInputError("Schema 0.1.0 does not combine burst drive with bracketing; choose one multi-frame policy explicitly.");
+    }
+    if (drive.kind === "self-timer" &&
+        driveCount !== bracketCount) {
+        throw new InvalidScientificInputError("Self-timer frameCount must match the bracket frame count.");
+    }
+    return bracketCount;
+}
+function validateGridSetting(value, minimum, maximum, grid, path) {
+    if (!Number.isFinite(value) ||
+        value < minimum ||
+        value > maximum) {
+        throw new InvalidScientificInputError(path +
+            " lies outside the resolved equipment capability range.");
+    }
+    if (grid.kind ===
+        "discrete-values" &&
+        !grid.values.some((candidate) => Math.abs(candidate - value) <=
+            Math.max(1, Math.abs(value)) *
+                1e-12)) {
+        throw new InvalidScientificInputError(path +
+            " is not present in the resolved equipment setting grid.");
+    }
+}
+function validateExposure(exposure, capabilities, path) {
+    validateGridSetting(exposure.aperture, capabilities.aperture
+        .widestAvailableFNumber, capabilities.aperture
+        .narrowestAvailableFNumber, capabilities.aperture
+        .settingGrid, path + ".aperture");
+    validateGridSetting(exposure.shutterSeconds, capabilities.shutter
+        .minimumSeconds, capabilities.shutter
+        .maximumSeconds, capabilities.shutter
+        .settingGrid, path + ".shutterSeconds");
+    validateGridSetting(exposure.iso, capabilities.iso.minimum, capabilities.iso.maximum, capabilities.iso.settingGrid, path + ".iso");
+}
+function resolveExposureBracket(base, axis, offsetStops) {
+    requireFinite(offsetStops, "bracket.offsetsStops[]");
+    if (axis === "shutter") {
+        return {
+            ...base,
+            shutterSeconds: base.shutterSeconds *
+                Math.pow(2, offsetStops)
+        };
+    }
+    if (axis === "iso") {
+        return {
+            ...base,
+            iso: base.iso *
+                Math.pow(2, offsetStops)
+        };
+    }
+    return {
+        ...base,
+        aperture: base.aperture /
+            Math.pow(2, offsetStops / 2)
+    };
+}
+function resolveFrameState(input, frameIndex) {
+    if (input.bracket.kind === "none") {
+        return {
+            exposure: cloneJson(input.baseState.exposure),
+            focus: parseFocusPlane(input.baseState.focus)
+        };
+    }
+    if (input.bracket.kind ===
+        "exposure") {
+        const offset = input.bracket
+            .offsetsStops[frameIndex];
+        if (offset === undefined) {
+            throw new InvalidScientificInputError("Exposure bracket frame index is out of range.");
+        }
+        return {
+            exposure: resolveExposureBracket(input.baseState.exposure, input.bracket.axis, offset),
+            focus: parseFocusPlane(input.baseState.focus),
+            exposureBracketOffsetStops: offset
+        };
+    }
+    const focus = input.bracket
+        .focusStates[frameIndex];
+    if (focus === undefined) {
+        throw new InvalidScientificInputError("Focus bracket frame index is out of range.");
+    }
+    return {
+        exposure: cloneJson(input.baseState.exposure),
+        focus: parseFocusPlane(focus)
+    };
+}
+function validateBracketSupport(input, capabilities) {
+    if (input.bracket.kind ===
+        "exposure") {
+        if (capabilities
+            .exposureBracketing
+            .availability.value !==
+            "supported") {
+            throw new InvalidScientificInputError("Exposure bracketing is not supported by the selected release capability profile.");
+        }
+        if (!capabilities
+            .exposureBracketing
+            .supportedAxes
+            .includes(input.bracket.axis)) {
+            throw new InvalidScientificInputError("The selected exposure-bracket axis is not supported by the release capability profile.");
+        }
+    }
+    if (input.bracket.kind ===
+        "focus" &&
+        capabilities
+            .focusBracketing
+            .availability.value !==
+            "supported") {
+        throw new InvalidScientificInputError("Focus bracketing is not supported by the selected release capability profile.");
+    }
+}
+function resolveSelfTimerDelay(drive) {
+    if (drive.kind !== "self-timer") {
+        return 0;
+    }
+    return requireNonNegativeFinite(drive.delaySeconds, "drive.delaySeconds");
+}
+function resolveRequestedCadence(frameCount, requestedCadenceFps) {
+    if (frameCount <= 1) {
+        if (requestedCadenceFps !==
+            undefined) {
+            requirePositiveFinite(requestedCadenceFps, "requestedCadenceFps");
+        }
+        return null;
+    }
+    if (requestedCadenceFps ===
+        undefined) {
+        throw new InvalidScientificInputError("requestedCadenceFps is required for a multi-frame physical sequence.");
+    }
+    return requirePositiveFinite(requestedCadenceFps, "requestedCadenceFps");
+}
+function intervalForPreviousFrame(previousFrame, requestedCadenceFps, capabilities) {
+    const requested = 1 / requestedCadenceFps;
+    const capability = 1 /
+        capabilities
+            .maximumCadenceFps.value;
+    const exposure = previousFrame
+        .exposure.shutterSeconds;
+    const gap = capabilities
+        .minimumInterFrameGapSeconds
+        .value;
+    const physical = exposure + gap;
+    const seconds = Math.max(requested, capability, physical);
+    const tolerance = Math.max(1, seconds) *
+        1e-12;
+    const constraints = [];
+    if (Math.abs(seconds - requested) <= tolerance) {
+        constraints.push("requested-cadence");
+    }
+    if (Math.abs(seconds - capability) <= tolerance) {
+        constraints.push("body-maximum-cadence");
+    }
+    if (Math.abs(seconds - physical) <= tolerance) {
+        constraints.push("exposure-duration");
+        if (gap > 0) {
+            constraints.push("minimum-inter-frame-gap");
+        }
+    }
+    return {
+        seconds,
+        constraints
+    };
+}
+/**
+ * Resolves one deterministic logical still-release sequence.
+ *
+ * Sensor capture-mode internals remain separate. This function schedules
+ * logical exposures only and never uses render speed/frame rate as capture
+ * timing.
+ */
+export function resolveReleaseSequence(input) {
+    const sequenceId = requireNonEmptyString(input.sequenceId, "sequenceId");
+    const releaseRequestTime = requireFinite(input
+        .releaseRequestTimeSeconds, "releaseRequestTimeSeconds");
+    const sequenceSeed = requireUint32(input.sequenceSeedUint32, "sequenceSeedUint32");
+    const releaseCapabilities = parseGenericReleaseCapabilityProfile(input.releaseCapabilities);
+    if (!includesDriveMode(releaseCapabilities, input.drive.kind)) {
+        throw new InvalidScientificInputError("The selected drive mode is not supported by the release capability profile.");
+    }
+    validateBracketSupport(input, releaseCapabilities);
+    const frameCount = resolveFrameCount(input.drive, input.bracket);
+    if (frameCount >
+        releaseCapabilities
+            .maximumLogicalFramesPerSequence
+            .value) {
+        throw new InvalidScientificInputError("Requested sequence frame count exceeds the release capability profile.");
+    }
+    const requestedCadenceFps = resolveRequestedCadence(frameCount, input.requestedCadenceFps);
+    const selfTimerDelay = resolveSelfTimerDelay(input.drive);
+    const baseState = {
+        exposure: cloneJson(input.baseState.exposure),
+        focus: parseFocusPlane(input.baseState.focus),
+        automation: cloneJson(input.baseState.automation),
+        ...(input.baseState
+            .whiteBalanceStateId ===
+            undefined
+            ? {}
+            : {
+                whiteBalanceStateId: requireNonEmptyString(input.baseState
+                    .whiteBalanceStateId, "baseState.whiteBalanceStateId")
+            })
+    };
+    validateExposure(baseState.exposure, input.exposureCapabilities, "baseState.exposure");
+    const frames = [];
+    for (let frameIndex = 0; frameIndex < frameCount; frameIndex += 1) {
+        const state = resolveFrameState(input, frameIndex);
+        validateExposure(state.exposure, input.exposureCapabilities, "frames[" +
+            frameIndex +
+            "].exposure");
+        let exposureStartTimeSeconds;
+        let startInterval = null;
+        let timingConstraints = [];
+        if (frameIndex === 0) {
+            exposureStartTimeSeconds =
+                releaseRequestTime +
+                    selfTimerDelay;
+        }
+        else {
+            const previous = frames[frameIndex - 1];
+            if (requestedCadenceFps ===
+                null) {
+                throw new InvalidScientificInputError("Multi-frame sequence lost its requested cadence.");
+            }
+            const interval = intervalForPreviousFrame(previous, requestedCadenceFps, releaseCapabilities);
+            startInterval =
+                interval.seconds;
+            timingConstraints =
+                interval.constraints;
+            exposureStartTimeSeconds =
+                previous
+                    .exposureStartTimeSeconds +
+                    interval.seconds;
+        }
+        const exposureEndTimeSeconds = exposureStartTimeSeconds +
+            state.exposure
+                .shutterSeconds;
+        if (!Number.isFinite(exposureStartTimeSeconds) ||
+            !Number.isFinite(exposureEndTimeSeconds)) {
+            throw new InvalidScientificInputError("Resolved release-sequence timing must remain finite.");
+        }
+        frames.push({
+            sequenceId,
+            frameIndex,
+            releaseFrameId: sequenceId +
+                ":frame:" +
+                frameIndex,
+            exposureStartTimeSeconds,
+            exposureEndTimeSeconds,
+            sceneTimeSecondsFromSequenceStart: exposureStartTimeSeconds -
+                releaseRequestTime,
+            startIntervalFromPreviousSeconds: startInterval,
+            timingConstraints,
+            stochasticSeedUint32: hashFrameSeed(sequenceSeed, frameIndex),
+            exposure: cloneJson(state.exposure),
+            focus: cloneJson(state.focus),
+            ...(state
+                .exposureBracketOffsetStops ===
+                undefined
+                ? {}
+                : {
+                    exposureBracketOffsetStops: state
+                        .exposureBracketOffsetStops
+                }),
+            automation: cloneJson(baseState.automation),
+            ...(baseState
+                .whiteBalanceStateId ===
+                undefined
+                ? {}
+                : {
+                    whiteBalanceStateId: baseState
+                        .whiteBalanceStateId
+                })
+        });
+    }
+    const sequence = {
+        version: RELEASE_SEQUENCE_VERSION,
+        sequenceId,
+        status: "scheduled",
+        releaseRequestTimeSeconds: releaseRequestTime,
+        selfTimerDelaySeconds: selfTimerDelay,
+        requestedCadenceFps,
+        capabilityMaximumCadenceFps: releaseCapabilities
+            .maximumCadenceFps.value,
+        minimumInterFrameGapSeconds: releaseCapabilities
+            .minimumInterFrameGapSeconds
+            .value,
+        requestedFrameCount: frameCount,
+        actualFrameCount: frames.length,
+        sequenceSeedUint32: sequenceSeed,
+        baseStateSnapshot: baseState,
+        frames,
+        sensorCaptureModeOwnership: "separate-logical-capture-contract",
+        whiteBalanceBracketingPhysicalCaptures: false,
+        preReleaseCaptureModeled: false,
+        bufferMediaThermalSlowdownModeled: false
+    };
+    return deepFreeze(cloneJson(sequence));
+}
+/**
+ * Produces an explicit cancelled sequence state without mutating the scheduled
+ * source sequence or leaving the completed/omitted frame boundary ambiguous.
+ */
+export function createCancelledReleaseSequence(input) {
+    const count = requireNonNegativeFinite(input.completedFrameCount, "completedFrameCount");
+    if (!Number.isSafeInteger(count)) {
+        throw new InvalidScientificInputError("completedFrameCount must be a safe integer.");
+    }
+    if (count >
+        input.sequence.frames.length) {
+        throw new InvalidScientificInputError("completedFrameCount must not exceed the source sequence frame count.");
+    }
+    const cancelledAt = requireFinite(input.cancelledAtSeconds, "cancelledAtSeconds");
+    const result = {
+        version: RELEASE_SEQUENCE_VERSION,
+        sequenceId: input.sequence.sequenceId,
+        status: "cancelled",
+        cancelledAtSeconds: cancelledAt,
+        completedFrameCount: count,
+        omittedFrameCount: input.sequence.frames.length -
+            count,
+        completedFrames: cloneJson(input.sequence.frames.slice(0, count)),
+        sourceSequenceFrameCount: input.sequence.frames.length,
+        sourceSequenceUnmodified: true
+    };
+    return deepFreeze(cloneJson(result));
+}
+//# sourceMappingURL=release-sequence.js.map

package/dist/capture/release-sequence.js.map

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

package/dist/capture/sensor-raw-frame.d.ts

@@ -0,0 +1,34 @@
+import { type SimulatedCapture } from "./simulated-capture.js";
+import { type SensorColorSamplingProfile } from "../sensor/color-sampling.js";
+import { type CaptureModeProfile } from "../sensor/capture-mode.js";
+import { type NativeEffectiveRasterColorSamplingBindingProfile } from "../sensor/capture-color-sampling-binding.js";
+import { type SensorRawCaptureSample } from "../sensor/raw-reconstruction.js";
+export declare const SENSOR_RAW_FRAME_SCHEMA_VERSION: "0.1.0";
+/** Declared attachment of #14 native CFA samples to a committed photographic capture. */
+export interface SensorRawFrameInput {
+    frameId: string;
+    capture: SimulatedCapture;
+    modeId: string;
+    captureModeProfile: CaptureModeProfile;
+    colorSamplingProfile: SensorColorSamplingProfile;
+    bindingProfile: NativeEffectiveRasterColorSamplingBindingProfile;
+    containerBitDepth: 16;
+    /** Exactly one sample per full native site, row-major; no processed RGB masking. */
+    samples: readonly SensorRawCaptureSample[];
+}
+/** Immutable RAW attachment. Structural validation does not prove producer truth or DNG compatibility. */
+export interface SensorRawFrame extends SensorRawFrameInput {
+    schemaVersion: typeof SENSOR_RAW_FRAME_SCHEMA_VERSION;
+    sampleDomain: "native-cfa-raw-code";
+    sampleOrder: "native-row-major";
+    producerBinding: "caller-declared-capture-attachment";
+    reconstructionApplied: false;
+    renderingApplied: false;
+    nativePixelWidth: number;
+    nativePixelHeight: number;
+}
+/** Validates dense bounded native coverage and exact CFA/mode/site/code identity, without IO. */
+export declare function parseSensorRawFrameInput(value: unknown): SensorRawFrameInput;
+/** Commits native RAW samples and capture metadata; no demosaic, WB, tone or format packing. */
+export declare function createSensorRawFrame(input: SensorRawFrameInput): SensorRawFrame;
+//# sourceMappingURL=sensor-raw-frame.d.ts.map

package/dist/capture/sensor-raw-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensor-raw-frame.d.ts","sourceRoot":"","sources":["../../src/capture/sensor-raw-frame.ts"],"names":[],"mappings":"AAeA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAmC,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC/G,OAAO,EAA2B,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EACL,KAAK,gDAAgD,EAAE,MAAM,6CAA6C,CAAC;AAC7G,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,eAAO,MAAM,+BAA+B,EAAG,OAAgB,CAAC;AAChE,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,oBAAoB,EAAE,0BAA0B,CAAC;IACjD,cAAc,EAAE,gDAAgD,CAAC;IACjE,iBAAiB,EAAE,EAAE,CAAC;IACtB,oFAAoF;IACpF,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC5C;AACD,0GAA0G;AAC1G,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,aAAa,EAAE,OAAO,+BAA+B,CAAC;IACtD,YAAY,EAAE,qBAAqB,CAAC;IACpC,WAAW,EAAE,kBAAkB,CAAC;IAChC,eAAe,EAAE,oCAAoC,CAAC;IACtD,qBAAqB,EAAE,KAAK,CAAC;IAC7B,gBAAgB,EAAE,KAAK,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAgDD,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA8B5E;AACD,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAQ/E"}