@dofek/training 0.1.0

package/dist/training-distribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-distribution.d.ts","sourceRoot":"","sources":["../src/training-distribution.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,aAAa,EAAE,WAAW,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAErF,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AASD,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,gBAAgB,EAAE,GACxB,qBAAqB,CA0BvB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CAuCvB"}

package/dist/training-distribution.js

@@ -0,0 +1,68 @@
+import { HEART_RATE_ZONES } from "@dofek/zones/zones";
+const INTENSITY_EXPLANATION = "A descriptive view of endurance training time across the Karvonen five-zone heart-rate model. It does not classify training polarization.";
+function roundedPercent(seconds, totalSeconds) {
+    return totalSeconds > 0 ? Math.round((seconds / totalSeconds) * 1000) / 10 : 0;
+}
+export function buildKarvonenIntensityDistribution(weeks) {
+    const zoneSeconds = [
+        weeks.reduce((sum, week) => sum + week.zone0, 0),
+        weeks.reduce((sum, week) => sum + week.zone1, 0),
+        weeks.reduce((sum, week) => sum + week.zone2, 0),
+        weeks.reduce((sum, week) => sum + week.zone3, 0),
+        weeks.reduce((sum, week) => sum + week.zone4, 0),
+        weeks.reduce((sum, week) => sum + week.zone5, 0),
+    ];
+    const totalSeconds = zoneSeconds.reduce((sum, seconds) => sum + seconds, 0);
+    return {
+        model: "karvonen-five-zone",
+        activityScope: "endurance",
+        totalSeconds,
+        zones: HEART_RATE_ZONES.map((zoneDefinition) => {
+            const seconds = zoneSeconds[zoneDefinition.zone] ?? 0;
+            return {
+                zone: zoneDefinition.zone,
+                label: zoneDefinition.label,
+                seconds,
+                percent: roundedPercent(seconds, totalSeconds),
+            };
+        }),
+        explanation: INTENSITY_EXPLANATION,
+    };
+}
+export function buildTreffPolarizationWeek(input) {
+    const totalSeconds = input.z1Seconds + input.z2Seconds + input.z3Seconds;
+    const zonePercentages = {
+        z1: roundedPercent(input.z1Seconds, totalSeconds),
+        z2: roundedPercent(input.z2Seconds, totalSeconds),
+        z3: roundedPercent(input.z3Seconds, totalSeconds),
+    };
+    if (input.polarizationIndex === null) {
+        return {
+            ...input,
+            totalSeconds,
+            zonePercentages,
+            status: "insufficient_data",
+            statusLabel: "Insufficient data",
+            explanation: "Polarization needs recorded cycling time in all three Treff heart-rate zones.",
+        };
+    }
+    if (input.polarizationIndex > 2) {
+        return {
+            ...input,
+            totalSeconds,
+            zonePercentages,
+            status: "polarized",
+            statusLabel: "Polarized",
+            explanation: "This cycling week is polarized: it has a Treff polarization index above 2.00.",
+        };
+    }
+    return {
+        ...input,
+        totalSeconds,
+        zonePercentages,
+        status: "not_polarized",
+        statusLabel: "Not polarized",
+        explanation: "This cycling week is not polarized because its Treff polarization index is 2.00 or lower.",
+    };
+}
+//# sourceMappingURL=training-distribution.js.map

package/dist/training-distribution.js.map

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

package/dist/training-load.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Training stress calculator.
+ *
+ * Encapsulates Bannister TRIMP, hrTSS, power TSS, regression model building,
+ * and FTP estimation. Instance methods use personalized gender factor and
+ * exponent; static methods are parameter-independent.
+ */
+export interface ActivityRow {
+    id: string;
+    date: string;
+    duration_min: number;
+    avg_hr: number;
+    max_hr: number;
+    avg_power: number | null;
+    power_samples: number;
+    hr_samples: number;
+}
+export interface TssModelInfo {
+    type: "learned" | "generic";
+    pairedActivities: number;
+    r2: number | null;
+    ftp: number | null;
+}
+export declare class TrainingStressCalculator {
+    #private;
+    constructor(genderFactor?: number, exponent?: number);
+    /**
+     * Compute Bannister TRIMP for an activity.
+     *
+     * TRIMP = duration_minutes * deltaHR_ratio * genderFactor * e^(exponent * deltaHR_ratio)
+     *   where deltaHR_ratio = (avg_hr - resting_hr) / (max_hr - resting_hr)
+     */
+    computeTrimp(durationMin: number, avgHr: number, maxHr: number, restingHr: number): number;
+    /**
+     * Compute hrTSS using Bannister TRIMP normalized to 1hr at threshold.
+     * This is the fallback when no learned model is available.
+     */
+    computeHrTss(durationMin: number, avgHr: number, maxHr: number, restingHr: number): number;
+    /**
+     * Compute power-based TSS.
+     * TSS = (NP / FTP)^2 * duration_hours * 100
+     */
+    static computePowerTss(normalizedPower: number, ftp: number, durationMin: number): number;
+    /**
+     * Build a linear regression model: powerTss = slope * trimp + intercept.
+     * Returns null if insufficient data or poor fit.
+     */
+    static buildTssModel(paired: {
+        trimp: number;
+        powerTss: number;
+    }[]): {
+        slope: number;
+        intercept: number;
+        r2: number;
+    } | null;
+    /**
+     * Estimate FTP from activity data.
+     * Uses highest avg_power from activities >= 20 min duration, multiplied by 0.95.
+     *
+     * Intentionally uses avg_power rather than Normalized Power (NP).
+     * NP inflates power for interval workouts via 4th-power averaging,
+     * which produces unrealistically high FTP estimates from variable efforts.
+     */
+    static estimateFtp(activities: ActivityRow[]): number | null;
+}
+//# sourceMappingURL=training-load.d.ts.map

package/dist/training-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-load.d.ts","sourceRoot":"","sources":["../src/training-load.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAID,qBAAa,wBAAwB;;gBAIvB,YAAY,SAAO,EAAE,QAAQ,SAAO;IAKhD;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAS1F;;;OAGG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAgB1F;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAMzF;;;OAGG;IACH,MAAM,CAAC,aAAa,CAClB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,GAC5C;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAa1D;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI;CAQ7D"}

package/dist/training-load.js

@@ -0,0 +1,89 @@
+/**
+ * Training stress calculator.
+ *
+ * Encapsulates Bannister TRIMP, hrTSS, power TSS, regression model building,
+ * and FTP estimation. Instance methods use personalized gender factor and
+ * exponent; static methods are parameter-independent.
+ */
+import { linearRegression } from "./power-analysis.js";
+// ── TrainingStressCalculator ─────────────────────────────────────────
+export class TrainingStressCalculator {
+    #genderFactor;
+    #exponent;
+    constructor(genderFactor = 0.64, exponent = 1.92) {
+        this.#genderFactor = genderFactor;
+        this.#exponent = exponent;
+    }
+    /**
+     * Compute Bannister TRIMP for an activity.
+     *
+     * TRIMP = duration_minutes * deltaHR_ratio * genderFactor * e^(exponent * deltaHR_ratio)
+     *   where deltaHR_ratio = (avg_hr - resting_hr) / (max_hr - resting_hr)
+     */
+    computeTrimp(durationMin, avgHr, maxHr, restingHr) {
+        if (maxHr <= restingHr || durationMin <= 0)
+            return 0;
+        const deltaHrRatio = (avgHr - restingHr) / (maxHr - restingHr);
+        if (deltaHrRatio <= 0)
+            return 0;
+        return (durationMin * deltaHrRatio * this.#genderFactor * Math.exp(this.#exponent * deltaHrRatio));
+    }
+    /**
+     * Compute hrTSS using Bannister TRIMP normalized to 1hr at threshold.
+     * This is the fallback when no learned model is available.
+     */
+    computeHrTss(durationMin, avgHr, maxHr, restingHr) {
+        const trimp = this.computeTrimp(durationMin, avgHr, maxHr, restingHr);
+        if (trimp === 0)
+            return 0;
+        // Threshold HR at 85% of max HR
+        const thresholdDeltaRatio = 0.85;
+        const trimpOneHourAtThreshold = 60 *
+            thresholdDeltaRatio *
+            this.#genderFactor *
+            Math.exp(this.#exponent * thresholdDeltaRatio);
+        if (trimpOneHourAtThreshold === 0)
+            return 0;
+        return (trimp / trimpOneHourAtThreshold) * 100;
+    }
+    /**
+     * Compute power-based TSS.
+     * TSS = (NP / FTP)^2 * duration_hours * 100
+     */
+    static computePowerTss(normalizedPower, ftp, durationMin) {
+        if (ftp <= 0 || durationMin <= 0 || normalizedPower <= 0)
+            return 0;
+        const intensityFactor = normalizedPower / ftp;
+        return intensityFactor ** 2 * (durationMin / 60) * 100;
+    }
+    /**
+     * Build a linear regression model: powerTss = slope * trimp + intercept.
+     * Returns null if insufficient data or poor fit.
+     */
+    static buildTssModel(paired) {
+        if (paired.length < 10)
+            return null;
+        const xs = paired.map((point) => point.trimp);
+        const ys = paired.map((point) => point.powerTss);
+        const result = linearRegression(xs, ys);
+        if (result.r2 < 0.3 || result.slope <= 0)
+            return null;
+        return result;
+    }
+    /**
+     * Estimate FTP from activity data.
+     * Uses highest avg_power from activities >= 20 min duration, multiplied by 0.95.
+     *
+     * Intentionally uses avg_power rather than Normalized Power (NP).
+     * NP inflates power for interval workouts via 4th-power averaging,
+     * which produces unrealistically high FTP estimates from variable efforts.
+     */
+    static estimateFtp(activities) {
+        const qualifying = activities.filter((act) => act.avg_power != null && act.avg_power > 0 && act.duration_min >= 20);
+        if (qualifying.length === 0)
+            return null;
+        const bestPower = Math.max(...qualifying.map((act) => Number(act.avg_power)));
+        return Math.round(bestPower * 0.95);
+    }
+}
+//# sourceMappingURL=training-load.js.map

package/dist/training-load.js.map

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

package/dist/training.d.ts

@@ -0,0 +1,61 @@
+export declare const OTHER_ACTIVITY_TYPE = "__other__";
+/**
+ * Superset of all valid internal activity types across all providers.
+ * Providers map their domain-specific types to one of these canonical values.
+ */
+export declare const CANONICAL_ACTIVITY_TYPES: readonly ["cycling", "road_cycling", "mountain_biking", "gravel_cycling", "indoor_cycling", "virtual_cycling", "e_bike_cycling", "cyclocross", "track_cycling", "bmx", "running", "swimming", "walking", "hiking", "strength", "strength_training", "functional_strength", "yoga", "pilates", "elliptical", "rowing", "skiing", "skating", "climbing", "cardio", "hiit", "cross_training", "trail_running", "stair_climbing", "stairmaster", "stretching", "dance", "martial_arts", "tennis", "basketball", "soccer", "golf", "ice_hockey", "snowboarding", "rock_climbing", "surfing", "kayaking", "functional_fitness", "bootcamp", "boxing", "core", "aqua_fitness", "circuit_training", "group_exercise", "triathlon", "dancing", "american_football", "archery", "australian_football", "badminton", "baseball", "bowling", "cricket", "curling", "equestrian", "fencing", "fishing", "gymnastics", "handball", "hockey", "hunting", "lacrosse", "mind_and_body", "mixed_cardio", "paddle_sports", "play", "preparation_and_recovery", "racquetball", "rugby", "sailing", "snow_sports", "softball", "squash", "table_tennis", "track_and_field", "volleyball", "water_fitness", "water_polo", "water_sports", "wrestling", "barre", "core_training", "flexibility", "jump_rope", "kickboxing", "stairs", "step_training", "wheelchair_walk", "wheelchair_run", "tai_chi", "mixed_metabolic_cardio", "hand_cycling", "disc_sports", "fitness_gaming", "cardio_dance", "social_dance", "paddle_racquet", "cooldown", "transition", "underwater_diving", "cross_country_skiing", "downhill_skiing", "breathwork", "meditation", "paddleboarding", "snowshoeing", "pickleball", "padel", "football", "multisport", "disc_golf", "skydiving", "paragliding", "diving", "snorkeling", "navigation", "geocaching", "paddling", "gym", "open_water_swimming", "other"];
+export type CanonicalActivityType = (typeof CANONICAL_ACTIVITY_TYPES)[number];
+/**
+ * All canonical activity types considered "cycling" for consolidated views.
+ * Individual activities show the specific subtype, but aggregated views
+ * (weekly volume, PMC, cycling page) treat them as one sport.
+ */
+export declare const CYCLING_ACTIVITY_TYPES: readonly ["cycling", "road_cycling", "mountain_biking", "gravel_cycling", "indoor_cycling", "virtual_cycling", "e_bike_cycling", "cyclocross", "track_cycling", "bmx", "hand_cycling"];
+export type CyclingActivityType = (typeof CYCLING_ACTIVITY_TYPES)[number];
+/** Check whether an activity type is a cycling variant. */
+export declare function isCyclingActivity(activityType: string): activityType is CyclingActivityType;
+/** Cadence unit for display based on activity type. */
+export declare function cadenceUnit(activityType: string): "rpm" | "steps/min";
+/** Y-axis label for cadence charts. */
+export declare function cadenceAxisLabel(activityType: string): string;
+/**
+ * Creates a mapping function from provider-specific types to canonical types.
+ * Unknown provider types default to "other".
+ */
+export declare function createActivityTypeMapper<K extends string | number>(providerMappings: Record<K, CanonicalActivityType>): (providerType: K) => CanonicalActivityType;
+/** Strava sport_type → canonical activity type */
+export declare const STRAVA_ACTIVITY_TYPE_MAP: Record<string, CanonicalActivityType>;
+/** Wahoo workout_type_id (numeric) → canonical activity type */
+export declare const WAHOO_WORKOUT_TYPE_MAP: Record<number, CanonicalActivityType>;
+/** Polar sport (lowercased) → canonical activity type */
+export declare const POLAR_SPORT_MAP: Record<string, CanonicalActivityType>;
+/** Garmin activityType → canonical activity type */
+export declare const GARMIN_ACTIVITY_TYPE_MAP: Record<string, CanonicalActivityType>;
+/** Oura activity (lowercased) → canonical activity type */
+export declare const OURA_ACTIVITY_TYPE_MAP: Record<string, CanonicalActivityType>;
+/** RideWithGPS activity_type → canonical activity type */
+export declare const RIDE_WITH_GPS_ACTIVITY_TYPE_MAP: Record<string, CanonicalActivityType>;
+/** Apple Health HKWorkoutActivityType → normalized lowercase name */
+export declare const APPLE_HEALTH_WORKOUT_TYPE_MAP: Record<string, CanonicalActivityType>;
+export interface WeeklyVolumeChartRow {
+    week: string;
+    activity_type: string;
+    count: number;
+    hours: number;
+}
+export interface DailyLoadRow {
+    date: string;
+    dailyLoad: number;
+}
+export type VerticalAscentActivityTypeGroup = "road_cycling" | "mountain_biking" | "gravel_cycling" | "other_cycling";
+export declare function formatActivityTypeLabel(activityType: string): string;
+export declare function getVerticalAscentActivityTypeGroup(activityType: string): VerticalAscentActivityTypeGroup;
+export declare function formatVerticalAscentActivityTypeGroupLabel(activityTypeGroup: VerticalAscentActivityTypeGroup): string;
+export declare function collapseWeeklyVolumeActivityTypes(rows: WeeklyVolumeChartRow[], maxLegendItems?: number): WeeklyVolumeChartRow[];
+/**
+ * Pick the daily load row to display in "current strain" UI.
+ * Always returns the latest (most recent) row so the dashboard reflects the
+ * current day's rolling workload state.
+ */
+export declare function selectRecentDailyLoad<T extends DailyLoadRow>(rows: T[]): T | null;
+//# sourceMappingURL=training.d.ts.map

package/dist/training.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training.d.ts","sourceRoot":"","sources":["../src/training.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAM/C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,swDAiI3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM9E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,wLAYzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,mBAAmB,CAE3F;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAErE;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAUD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAChE,gBAAgB,EAAE,MAAM,CAAC,CAAC,EAAE,qBAAqB,CAAC,GACjD,CAAC,YAAY,EAAE,CAAC,KAAK,qBAAqB,CAI5C;AAMD,kDAAkD;AAClD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA2B1E,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAexE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA2CjE,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA4B1E,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAgBxE,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAkBjF,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAoF/E,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAgCD,MAAM,MAAM,+BAA+B,GACvC,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,CAAC;AA8BpB,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,MAAM,GACnB,+BAA+B,CAMjC;AAED,wBAAgB,0CAA0C,CACxD,iBAAiB,EAAE,+BAA+B,GACjD,MAAM,CAER;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,oBAAoB,EAAE,EAC5B,cAAc,SAAI,GACjB,oBAAoB,EAAE,CAgDxB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAGjF"}