@rian8337/osu-difficulty-calculator 4.0.0-beta.2 → 4.0.0-beta.21

package/typings/index.d.ts

@@ -1,4 +1,4 @@
-import { MapStats, Mod, PlaceableHitObject, Modes, Beatmap, HitObject, Accuracy } from '@rian8337/osu-base';
+import { Mod, PlaceableHitObject, Modes, Beatmap, DifficultyStatisticsCalculatorResult, Accuracy } from '@rian8337/osu-base';
 
 /**
  * An evaluator for calculating aim skill.
@@ -20,16 +20,6 @@ declare abstract class AimEvaluator {
     protected static calculateAcuteAngleBonus(angle: number): number;
 }
 
-/**
- * The base of calculation options.
- */
-interface CalculationOptions {
-    /**
-     * Custom map statistics to apply custom speed multiplier as well as old statistics.
-     */
-    stats?: MapStats;
-}
-
 /**
  * Holds data that can be used to calculate performance points.
  */
@@ -68,6 +58,10 @@ interface DifficultyAttributes {
      * A value closer to 0 indicates most of aim difficulty is contributed by sliders.
      */
     sliderFactor: number;
+    /**
+     * The overall clock rate that was applied to the beatmap.
+     */
+    clockRate: number;
     /**
      * The perceived approach rate inclusive of rate-adjusting mods (DT/HT/etc).
      *
@@ -94,20 +88,34 @@ interface DifficultyAttributes {
     spinnerCount: number;
 }
 
+/**
+ * Represents difficulty attributes that can be cached.
+ */
+type CacheableDifficultyAttributes<T extends DifficultyAttributes> = Omit<T, "mods"> & {
+    /**
+     * The mods which were applied to the beatmap.
+     */
+    mods: string;
+};
+
 /**
  * Represents options for difficulty calculation.
  */
-interface DifficultyCalculationOptions extends CalculationOptions {
+interface DifficultyCalculationOptions {
     /**
      * The modifications to apply.
      */
-    mods?: Mod[];
+    readonly mods?: Mod[];
+    /**
+     * The custom speed multiplier to apply. Defaults to 1.
+     */
+    readonly customSpeedMultiplier?: number;
 }
 
 /**
- * Represents an osu!standard hit object with difficulty calculation values.
+ * Represents a hit object with difficulty calculation values.
  */
-declare class DifficultyHitObject {
+declare abstract class DifficultyHitObject {
     /**
      * The underlying hitobject.
      */
@@ -117,19 +125,7 @@ declare class DifficultyHitObject {
      *
      * This is one less than the actual index of the hitobject in the beatmap.
      */
-    index: number;
-    /**
-     * The preempt time of the hitobject.
-     */
-    baseTimePreempt: number;
-    /**
-     * Adjusted preempt time of the hitobject, taking speed multiplier into account.
-     */
-    timePreempt: number;
-    /**
-     * The fade in time of the hitobject.
-     */
-    timeFadeIn: number;
+    readonly index: number;
     /**
      * The aim strain generated by the hitobject if sliders are considered.
      */
@@ -138,41 +134,10 @@ declare class DifficultyHitObject {
      * The aim strain generated by the hitobject if sliders are not considered.
      */
     aimStrainWithoutSliders: number;
-    /**
-     * The tap strain generated by the hitobject.
-     *
-     * This is also used for osu!standard as opposed to "speed strain".
-     */
-    tapStrain: number;
-    /**
-     * The tap strain generated by the hitobject if `strainTime` isn't modified by
-     * OD. This is used in three-finger detection.
-     */
-    originalTapStrain: number;
     /**
      * The rhythm multiplier generated by the hitobject. This is used to alter tap strain.
      */
     rhythmMultiplier: number;
-    /**
-     * The rhythm strain generated by the hitobject.
-     */
-    rhythmStrain: number;
-    /**
-     * The flashlight strain generated by the hitobject if sliders are considered.
-     */
-    flashlightStrainWithSliders: number;
-    /**
-     * The flashlight strain generated by the hitobject if sliders are not considered.
-     */
-    flashlightStrainWithoutSliders: number;
-    /**
-     * The visual strain generated by the hitobject if sliders are considered.
-     */
-    visualStrainWithSliders: number;
-    /**
-     * The visual strain generated by the hitobject if sliders are not considered.
-     */
-    visualStrainWithoutSliders: number;
     /**
      * The normalized distance from the "lazy" end position of the previous hitobject to the start position of this hitobject.
      *
@@ -213,42 +178,48 @@ declare class DifficultyHitObject {
     /**
      * The amount of milliseconds elapsed between this hitobject and the last hitobject.
      */
-    deltaTime: number;
+    readonly deltaTime: number;
     /**
      * The amount of milliseconds elapsed since the start time of the previous hitobject, with a minimum of 25ms.
      */
-    strainTime: number;
+    readonly strainTime: number;
     /**
      * Adjusted start time of the hitobject, taking speed multiplier into account.
      */
-    startTime: number;
+    readonly startTime: number;
     /**
      * Adjusted end time of the hitobject, taking speed multiplier into account.
      */
-    endTime: number;
+    readonly endTime: number;
     /**
-     * The note density of the hitobject.
+     * Other hitobjects in the beatmap, including this hitobject.
      */
-    noteDensity: number;
+    protected readonly hitObjects: readonly DifficultyHitObject[];
+    protected abstract readonly mode: Modes;
+    protected readonly normalizedRadius = 50;
+    protected readonly maximumSliderRadius: number;
+    protected readonly assumedSliderRadius: number;
+    protected readonly minDeltaTime = 25;
+    private readonly lastObject;
+    private readonly lastLastObject;
     /**
-     * The overlapping factor of the hitobject.
+     * Note: You **must** call `computeProperties` at some point due to how TypeScript handles
+     * overridden properties (see [this](https://github.com/microsoft/TypeScript/issues/1617) GitHub issue).
      *
-     * This is used to scale visual skill.
-     */
-    overlappingFactor: number;
-    /**
-     * Adjusted velocity of the hitobject, taking speed multiplier into account.
-     */
-    velocity: number;
-    /**
-     * Other hitobjects in the beatmap, including this hitobject.
+     * @param object The underlying hitobject.
+     * @param lastObject The hitobject before this hitobject.
+     * @param lastLastObject The hitobject before the last hitobject.
+     * @param difficultyHitObjects All difficulty hitobjects in the processed beatmap.
+     * @param clockRate The clock rate of the beatmap.
      */
-    private readonly hitObjects;
+    protected constructor(object: PlaceableHitObject, lastObject: PlaceableHitObject | null, lastLastObject: PlaceableHitObject | null, difficultyHitObjects: readonly DifficultyHitObject[], clockRate: number);
     /**
-     * @param object The underlying hitobject.
-     * @param hitObjects All difficulty hitobjects in the processed beatmap.
+     * Computes the properties of this hitobject.
+     *
+     * @param clockRate The clock rate of the beatmap.
+     * @param hitObjects The hitobjects in the beatmap.
      */
-    constructor(object: PlaceableHitObject, hitObjects: DifficultyHitObject[]);
+    computeProperties(clockRate: number, hitObjects: readonly PlaceableHitObject[]): void;
     /**
      * Gets the difficulty hitobject at a specific index with respect to the current
      * difficulty hitobject's index.
@@ -259,7 +230,7 @@ declare class DifficultyHitObject {
      * @returns The difficulty hitobject at the index with respect to the current
      * difficulty hitobject's index, `null` if the index is out of range.
      */
-    previous(backwardsIndex: number): DifficultyHitObject | null;
+    previous(backwardsIndex: number): this | null;
     /**
      * Gets the difficulty hitobject at a specific index with respect to the current
      * difficulty hitobject's index.
@@ -270,26 +241,41 @@ declare class DifficultyHitObject {
      * @returns The difficulty hitobject at the index with respect to the current
      * difficulty hitobject's index, `null` if the index is out of range.
      */
-    next(forwardsIndex: number): DifficultyHitObject | null;
+    next(forwardsIndex: number): this | null;
     /**
      * Calculates the opacity of the hitobject at a given time.
      *
      * @param time The time to calculate the hitobject's opacity at.
      * @param isHidden Whether Hidden mod is used.
-     * @param mode The gamemode to calculate the opacity for.
      * @returns The opacity of the hitobject at the given time.
      */
-    opacityAt(time: number, isHidden: boolean, mode: Modes): number;
+    opacityAt(time: number, isHidden: boolean): number;
+    protected abstract get scalingFactor(): number;
+    protected setDistances(clockRate: number): void;
+    private calculateSliderCursorPosition;
+    private getEndCursorPosition;
+}
+
+/**
+ * Represents the strain peaks of various calculated difficulties.
+ */
+interface StrainPeaks {
     /**
-     * Determines whether this hitobject is considered overlapping with the hitobject before it.
-     *
-     * Keep in mind that "overlapping" in this case is overlapping to the point where both hitobjects
-     * can be hit with just a single tap in osu!droid.
-     *
-     * @param considerDistance Whether to consider the distance between both hitobjects.
-     * @returns Whether the hitobject is considered overlapping.
+     * The strain peaks of aim difficulty if sliders are considered.
      */
-    isOverlapping(considerDistance: boolean): boolean;
+    aimWithSliders: number[];
+    /**
+     * The strain peaks of aim difficulty if sliders are not considered.
+     */
+    aimWithoutSliders: number[];
+    /**
+     * The strain peaks of speed difficulty.
+     */
+    speed: number[];
+    /**
+     * The strain peaks of flashlight difficulty.
+     */
+    flashlight: number[];
 }
 
 /**
@@ -316,103 +302,9 @@ declare abstract class Skill {
 }
 
 /**
- * Used to processes strain values of difficulty hitobjects, keep track of strain levels caused by the processed objects
- * and to calculate a final difficulty value representing the difficulty of hitting all the processed objects.
+ * The base of a difficulty calculator.
  */
-declare abstract class StrainSkill extends Skill {
-    /**
-     * The strain of currently calculated hitobject.
-     */
-    protected currentStrain: number;
-    /**
-     * The current section's strain peak.
-     */
-    protected currentSectionPeak: number;
-    /**
-     * Strain peaks are stored here.
-     */
-    readonly strainPeaks: number[];
-    /**
-     * The number of sections with the highest strains, which the peak strain reductions will apply to.
-     * This is done in order to decrease their impact on the overall difficulty of the map for this skill.
-     */
-    protected abstract readonly reducedSectionCount: number;
-    /**
-     * The baseline multiplier applied to the section with the biggest strain.
-     */
-    protected abstract readonly reducedSectionBaseline: number;
-    /**
-     * Strain values are multiplied by this number for the given skill. Used to balance the value of different skills between each other.
-     */
-    protected abstract readonly skillMultiplier: number;
-    /**
-     * Determines how quickly strain decays for the given skill.
-     *
-     * For example, a value of 0.15 indicates that strain decays to 15% of its original value in one second.
-     */
-    protected abstract readonly strainDecayBase: number;
-    private readonly sectionLength;
-    private currentSectionEnd;
-    private isFirstObject;
-    /**
-     * Calculates the strain value of a hitobject and stores the value in it. This value is affected by previously processed objects.
-     *
-     * @param current The hitobject to process.
-     */
-    process(current: DifficultyHitObject): void;
-    /**
-     * Saves the current peak strain level to the list of strain peaks, which will be used to calculate an overall difficulty.
-     */
-    saveCurrentPeak(): void;
-    /**
-     * Calculates strain decay for a specified time frame.
-     *
-     * @param ms The time frame to calculate.
-     */
-    protected strainDecay(ms: number): number;
-    /**
-     * Calculates the strain value at a hitobject.
-     */
-    protected abstract strainValueAt(current: DifficultyHitObject): number;
-    /**
-     * Saves the current strain to a hitobject.
-     */
-    protected abstract saveToHitObject(current: DifficultyHitObject): void;
-    /**
-     * Sets the initial strain level for a new section.
-     *
-     * @param offset The beginning of the new section in milliseconds, adjusted by speed multiplier.
-     * @param current The current hitobject.
-     */
-    private startNewSectionFrom;
-}
-
-/**
- * Represents the strain peaks of various calculated difficulties.
- */
-interface StrainPeaks {
-    /**
-     * The strain peaks of aim difficulty if sliders are considered.
-     */
-    aimWithSliders: number[];
-    /**
-     * The strain peaks of aim difficulty if sliders are not considered.
-     */
-    aimWithoutSliders: number[];
-    /**
-     * The strain peaks of speed difficulty.
-     */
-    speed: number[];
-    /**
-     * The strain peaks of flashlight difficulty.
-     */
-    flashlight: number[];
-}
-
-/**
- * The base of difficulty calculators.
- */
-declare abstract class DifficultyCalculator {
+declare abstract class DifficultyCalculator<THitObject extends DifficultyHitObject, TAttributes extends DifficultyAttributes> {
     /**
      * The calculated beatmap.
      */
@@ -420,7 +312,7 @@ declare abstract class DifficultyCalculator {
     /**
      * The difficulty objects of the beatmap.
      */
-    readonly objects: DifficultyHitObject[];
+    readonly objects: THitObject[];
     /**
      * The modifications applied.
      */
@@ -428,20 +320,23 @@ declare abstract class DifficultyCalculator {
     /**
      * The total star rating of the beatmap.
      */
-    total: number;
+    get total(): number;
     /**
-     * The map statistics of the beatmap after modifications are applied.
+     * The difficulty statistics of the beatmap after modifications are applied.
      */
-    stats: MapStats;
+    difficultyStatistics: DifficultyStatisticsCalculatorResult<number, number, number, number>;
     /**
      * The strain peaks of various calculated difficulties.
      */
     readonly strainPeaks: StrainPeaks;
     /**
-     * Holds data that can be used to calculate performance points.
+     * The difficulty attributes that can be used to calculate performance points.
+     */
+    abstract readonly attributes: TAttributes;
+    /**
+     * The difficulty attributes that can be cached. It can also be used to calculate performance points.
      */
-    abstract readonly attributes: DifficultyAttributes;
-    protected readonly sectionLength: number;
+    abstract get cacheableAttributes(): CacheableDifficultyAttributes<TAttributes>;
     protected abstract readonly difficultyMultiplier: number;
     protected abstract readonly mode: Modes;
     /**
@@ -468,14 +363,23 @@ declare abstract class DifficultyCalculator {
     calculate(options?: DifficultyCalculationOptions): this;
     /**
      * Generates difficulty hitobjects for this calculator.
+     *
+     * @param convertedBeatmap The beatmap to generate difficulty hitobjects from.
      */
-    generateDifficultyHitObjects(): void;
+    protected abstract generateDifficultyHitObjects(convertedBeatmap: Beatmap): THitObject[];
+    /**
+     * Computes the difficulty statistics of the original beatmap with respect to the used options.
+     *
+     * @param options The options to use for the difficulty statistics calculation.
+     * @returns The computed difficulty statistics.
+     */
+    protected abstract computeDifficultyStatistics(options?: DifficultyCalculationOptions): DifficultyStatisticsCalculatorResult<number, number, number, number>;
     /**
      * Calculates the skills provided.
      *
      * @param skills The skills to calculate.
      */
-    protected calculateSkills(...skills: StrainSkill[]): void;
+    protected calculateSkills(...skills: Skill[]): void;
     /**
      * Calculates the total star rating of the beatmap and stores it in this instance.
      */
@@ -491,7 +395,7 @@ declare abstract class DifficultyCalculator {
     /**
      * Creates skills to be calculated.
      */
-    protected abstract createSkills(): StrainSkill[];
+    protected abstract createSkills(): Skill[];
     /**
      * Populates the stored difficulty attributes with necessary data.
      */
@@ -511,120 +415,237 @@ declare abstract class DifficultyCalculator {
 }
 
 /**
- * A converter used to convert normal hitobjects into difficulty hitobjects.
+ * Represents a slider that is considered difficult.
+ *
+ * This structure is a part of difficulty attributes and can be cached.
  */
-declare class DifficultyHitObjectCreator {
+interface DifficultSlider {
     /**
-     * The threshold for small circle buff for osu!droid.
+     * The index of the slider in the beatmap.
      */
-    private readonly DROID_CIRCLESIZE_BUFF_THRESHOLD;
+    readonly index: number;
     /**
-     * The threshold for small circle buff for osu!standard.
+     * The difficulty rating of this slider compared to other sliders, based on the velocity of the slider.
+     *
+     * A value closer to 1 indicates that this slider is more difficult compared to most sliders.
+     *
+     * A value closer to 0 indicates that this slider is easier compared to most sliders.
      */
-    private readonly PC_CIRCLESIZE_BUFF_THRESHOLD;
+    readonly difficultyRating: number;
+}
+
+/**
+ * Used to processes strain values of difficulty hitobjects, keep track of strain levels caused by the processed objects
+ * and to calculate a final difficulty value representing the difficulty of hitting all the processed objects.
+ */
+declare abstract class StrainSkill extends Skill {
     /**
-     * The gamemode this creator is creating for.
+     * Strain peaks are stored here.
      */
-    private mode;
+    readonly strainPeaks: number[];
     /**
-     * The base normalized radius of hitobjects.
+     * The number of sections with the highest strains, which the peak strain reductions will apply to.
+     * This is done in order to decrease their impact on the overall difficulty of the map for this skill.
      */
-    private readonly normalizedRadius;
-    private maximumSliderRadius;
-    private readonly assumedSliderRadius;
-    private readonly minDeltaTime;
+    protected abstract readonly reducedSectionCount: number;
     /**
-     * Generates difficulty hitobjects for difficulty calculation.
+     * The baseline multiplier applied to the section with the biggest strain.
      */
-    generateDifficultyObjects(params: {
-        objects: readonly HitObject[];
-        circleSize: number;
-        mods: Mod[];
-        speedMultiplier: number;
-        mode: Modes;
-        preempt?: number;
-    }): DifficultyHitObject[];
+    protected abstract readonly reducedSectionBaseline: number;
     /**
-     * Calculates a slider's cursor position.
+     * Determines how quickly strain decays for the given skill.
+     *
+     * For example, a value of 0.15 indicates that strain decays to 15% of its original value in one second.
      */
-    private calculateSliderCursorPosition;
+    protected abstract readonly strainDecayBase: number;
+    private readonly sectionLength;
+    private currentStrain;
+    private currentSectionPeak;
+    private currentSectionEnd;
+    process(current: DifficultyHitObject): void;
+    /**
+     * Saves the current peak strain level to the list of strain peaks, which will be used to calculate an overall difficulty.
+     */
+    saveCurrentPeak(): void;
+    /**
+     * Calculates strain decay for a specified time frame.
+     *
+     * @param ms The time frame to calculate.
+     */
+    protected strainDecay(ms: number): number;
+    /**
+     * Calculates the starting time of a strain section at an object.
+     *
+     * @param current The object at which the strain section starts.
+     * @returns The start time of the strain section.
+     */
+    protected calculateCurrentSectionStart(current: DifficultyHitObject): number;
+    /**
+     * Calculates the strain value at a hitobject.
+     *
+     * @param current The hitobject to calculate.
+     */
+    protected abstract strainValueAt(current: DifficultyHitObject): number;
+    /**
+     * Saves the current strain to a hitobject.
+     */
+    protected abstract saveToHitObject(current: DifficultyHitObject): void;
+    /**
+     * Retrieves the peak strain at a point in time.
+     *
+     * @param time The time to retrieve the peak strain at.
+     * @param current The current hit object.
+     * @returns The peak strain.
+     */
+    protected abstract calculateInitialStrain(time: number, current: DifficultyHitObject): number;
+    /**
+     * Sets the initial strain level for a new section.
+     *
+     * @param time The beginning of the new section in milliseconds.
+     * @param current The current hitobject.
+     */
+    private startNewSectionFrom;
+}
+
+/**
+ * Used to processes strain values of difficulty hitobjects, keep track of strain levels caused by the processed objects
+ * and to calculate a final difficulty value representing the difficulty of hitting all the processed objects.
+ */
+declare abstract class DroidSkill extends StrainSkill {
+    /**
+     * The bonus multiplier that is given for a sequence of notes of equal difficulty.
+     */
+    protected abstract readonly starsPerDouble: number;
+    protected readonly _objectStrains: number[];
+    /**
+     * The strains of hitobjects.
+     */
+    get objectStrains(): readonly number[];
+    /**
+     * Returns the number of strains weighed against the top strain.
+     *
+     * The result is scaled by clock rate as it affects the total number of strains.
+     */
+    countDifficultStrains(): number;
+    process(current: DifficultyHitObject): void;
+    difficultyValue(): number;
+    /**
+     * Gets the strain of a hitobject.
+     *
+     * @param current The hitobject to get the strain from.
+     * @returns The strain of the hitobject.
+     */
+    protected abstract getObjectStrain(current: DifficultyHitObject): number;
+    protected calculateCurrentSectionStart(current: DifficultyHitObject): number;
+}
+
+/**
+ * Represents an osu!droid hit object with difficulty calculation values.
+ */
+declare class DroidDifficultyHitObject extends DifficultyHitObject {
+    /**
+     * The tap strain generated by the hitobject.
+     */
+    tapStrain: number;
+    /**
+     * The tap strain generated by the hitobject if `strainTime` isn't modified by
+     * OD. This is used in three-finger detection.
+     */
+    originalTapStrain: number;
+    /**
+     * The rhythm strain generated by the hitobject.
+     */
+    rhythmStrain: number;
+    /**
+     * The flashlight strain generated by the hitobject if sliders are considered.
+     */
+    flashlightStrainWithSliders: number;
+    /**
+     * The flashlight strain generated by the hitobject if sliders are not considered.
+     */
+    flashlightStrainWithoutSliders: number;
+    /**
+     * The visual strain generated by the hitobject if sliders are considered.
+     */
+    visualStrainWithSliders: number;
+    /**
+     * The visual strain generated by the hitobject if sliders are not considered.
+     */
+    visualStrainWithoutSliders: number;
+    /**
+     * The note density of the hitobject.
+     */
+    noteDensity: number;
     /**
-     * Gets the scaling factor of a radius.
+     * The overlapping factor of the hitobject.
      *
-     * @param radius The radius to get the scaling factor from.
+     * This is used to scale visual skill.
      */
-    private getScalingFactor;
+    overlappingFactor: number;
     /**
-     * Returns the end cursor position of a hitobject.
+     * Adjusted preempt time of the hitobject, taking speed multiplier into account.
      */
-    private getEndCursorPosition;
-    private applyToOverlappingFactor;
-}
-
-/**
- * Represents a slider that is considered difficult.
- *
- * This structure is a part of difficulty attributes and can be cached.
- */
-interface DifficultSlider {
+    readonly timePreempt: number;
+    private readonly radiusBuffThreshold;
+    protected readonly mode = Modes.droid;
+    protected readonly maximumSliderRadius: number;
+    protected get scalingFactor(): number;
     /**
-     * The index of the slider in the beatmap.
+     * Note: You **must** call `computeProperties` at some point due to how TypeScript handles
+     * overridden properties (see [this](https://github.com/microsoft/TypeScript/issues/1617) GitHub issue).
+     *
+     * @param object The underlying hitobject.
+     * @param lastObject The hitobject before this hitobject.
+     * @param lastLastObject The hitobject before the last hitobject.
+     * @param difficultyHitObjects All difficulty hitobjects in the processed beatmap.
+     * @param clockRate The clock rate of the beatmap.
+     * @param isForceAR Whether force AR is enabled.
      */
-    readonly index: number;
+    constructor(object: PlaceableHitObject, lastObject: PlaceableHitObject | null, lastLastObject: PlaceableHitObject | null, difficultyHitObjects: readonly DifficultyHitObject[], clockRate: number, isForceAR: boolean);
+    computeProperties(clockRate: number, hitObjects: readonly PlaceableHitObject[]): void;
     /**
-     * The difficulty rating of this slider compared to other sliders, based on the velocity of the slider.
+     * Determines whether this hitobject is considered overlapping with the hitobject before it.
      *
-     * A value closer to 1 indicates that this slider is more difficult compared to most sliders.
+     * Keep in mind that "overlapping" in this case is overlapping to the point where both hitobjects
+     * can be hit with just a single tap in osu!droid.
      *
-     * A value closer to 0 indicates that this slider is easier compared to most sliders.
-     */
-    readonly difficultyRating: number;
-}
-
-/**
- * Used to processes strain values of difficulty hitobjects, keep track of strain levels caused by the processed objects
- * and to calculate a final difficulty value representing the difficulty of hitting all the processed objects.
- */
-declare abstract class DroidSkill extends StrainSkill {
-    /**
-     * The bonus multiplier that is given for a sequence of notes of equal difficulty.
+     * @param considerDistance Whether to consider the distance between both hitobjects.
+     * @returns Whether the hitobject is considered overlapping.
      */
-    protected abstract readonly starsPerDouble: number;
-    difficultyValue(): number;
+    isOverlapping(considerDistance: boolean): boolean;
+    private setVisuals;
+    private applyToOverlappingFactor;
 }
 
 /**
  * Represents the skill required to correctly aim at every object in the map with a uniform CircleSize and normalized distances.
  */
 declare class DroidAim extends DroidSkill {
-    protected readonly skillMultiplier: number;
-    protected readonly strainDecayBase: number;
-    protected readonly reducedSectionCount: number;
-    protected readonly reducedSectionBaseline: number;
-    protected readonly starsPerDouble: number;
+    protected readonly strainDecayBase = 0.15;
+    protected readonly reducedSectionCount = 10;
+    protected readonly reducedSectionBaseline = 0.75;
+    protected readonly starsPerDouble = 1.05;
+    private readonly skillMultiplier;
     private readonly withSliders;
+    private currentAimStrain;
     constructor(mods: Mod[], withSliders: boolean);
-    /**
-     * @param current The hitobject to calculate.
-     */
-    protected strainValueAt(current: DifficultyHitObject): number;
+    protected strainValueAt(current: DroidDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: DroidDifficultyHitObject): number;
+    protected getObjectStrain(): number;
     /**
      * @param current The hitobject to save to.
      */
-    protected saveToHitObject(current: DifficultyHitObject): void;
+    protected saveToHitObject(current: DroidDifficultyHitObject): void;
 }
 
 /**
  * An evaluator for calculating osu!droid Aim skill.
  */
 declare abstract class DroidAimEvaluator extends AimEvaluator {
-    protected static readonly wideAngleMultiplier: number;
-    protected static readonly sliderMultiplier: number;
-    protected static readonly velocityChangeMultiplier: number;
-    /**
-     * Spacing threshold for a single hitobject spacing.
-     */
-    private static readonly SINGLE_SPACING_THRESHOLD;
+    protected static readonly wideAngleMultiplier = 1.65;
+    protected static readonly sliderMultiplier = 1.5;
+    protected static readonly velocityChangeMultiplier = 0.85;
+    private static readonly singleSpacingThreshold;
     private static readonly minSpeedBonus;
     /**
      * Evaluates the difficulty of aiming the current object, based on:
@@ -637,15 +658,15 @@ declare abstract class DroidAimEvaluator extends AimEvaluator {
      * @param current The current object.
      * @param withSliders Whether to take slider difficulty into account.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, withSliders: boolean): number;
+    static evaluateDifficultyOf(current: DroidDifficultyHitObject, withSliders: boolean): number;
     /**
-     * Calculates the aim strain of a hitobject.
+     * Calculates the snap aim strain of a hitobject.
      */
-    private static aimStrainOf;
+    private static snapAimStrainOf;
     /**
-     * Calculates the movement strain of a hitobject.
+     * Calculates the flow aim strain of a hitobject.
      */
-    private static movementStrainOf;
+    private static flowAimStrainOf;
 }
 
 /**
@@ -664,6 +685,44 @@ interface DroidDifficultyAttributes extends DifficultyAttributes {
      * The difficulty corresponding to the visual skill.
      */
     visualDifficulty: number;
+    /**
+     * The amount of strains that are considered difficult with respect to the aim skill.
+     */
+    aimDifficultStrainCount: number;
+    /**
+     * The amount of strains that are considered difficult with respect to the tap skill.
+     */
+    tapDifficultStrainCount: number;
+    /**
+     * The amount of strains that are considered difficult with respect to the flashlight skill.
+     */
+    flashlightDifficultStrainCount: number;
+    /**
+     * The amount of strains that are considered difficult with respect to the visual skill.
+     */
+    visualDifficultStrainCount: number;
+    /**
+     * The average delta time of speed objects.
+     */
+    averageSpeedDeltaTime: number;
+    /**
+     * Describes how much of tap difficulty is contributed by notes that are "vibroable".
+     *
+     * A value closer to 1 indicates most of tap difficulty is contributed by notes that are not "vibroable".
+     *
+     * A value closer to 0 indicates most of tap difficulty is contributed by notes that are "vibroable".
+     */
+    vibroFactor: number;
+}
+
+/**
+ * Represents options for osu!droid difficulty calculation.
+ */
+interface DroidDifficultyCalculationOptions extends DifficultyCalculationOptions {
+    /**
+     * Whether to calculate for old statistics (1.6.7 and older). Defaults to `false`.
+     */
+    readonly oldStatistics?: boolean;
 }
 
 /**
@@ -689,6 +748,10 @@ interface HighStrainSection {
  * as doing some analysis using the replay of a score.
  */
 interface ExtendedDroidDifficultyAttributes extends DroidDifficultyAttributes {
+    /**
+     * The mode of the difficulty calculation.
+     */
+    mode: "live";
     /**
      * Possible sections at which the player can use three fingers on.
      */
@@ -724,36 +787,37 @@ interface ExtendedDroidDifficultyAttributes extends DroidDifficultyAttributes {
 /**
  * A difficulty calculator for osu!droid gamemode.
  */
-declare class DroidDifficultyCalculator extends DifficultyCalculator {
+declare class DroidDifficultyCalculator extends DifficultyCalculator<DroidDifficultyHitObject, DroidDifficultyAttributes> {
     /**
      * The aim star rating of the beatmap.
      */
-    aim: number;
+    get aim(): number;
     /**
      * The tap star rating of the beatmap.
      */
-    tap: number;
+    get tap(): number;
     /**
      * The rhythm star rating of the beatmap.
      */
-    rhythm: number;
+    get rhythm(): number;
     /**
      * The flashlight star rating of the beatmap.
      */
-    flashlight: number;
+    get flashlight(): number;
     /**
      * The visual star rating of the beatmap.
      */
-    visual: number;
+    get visual(): number;
     /**
      * The strain threshold to start detecting for possible three-fingered section.
      *
      * Increasing this number will result in less sections being flagged.
      */
-    static readonly threeFingerStrainThreshold: number;
+    static readonly threeFingerStrainThreshold = 175;
     readonly attributes: ExtendedDroidDifficultyAttributes;
-    protected readonly difficultyMultiplier: number;
-    protected readonly mode: Modes;
+    get cacheableAttributes(): CacheableDifficultyAttributes<DroidDifficultyAttributes>;
+    protected readonly difficultyMultiplier = 0.18;
+    protected readonly mode = Modes.droid;
     /**
      * Calculates the aim star rating of the beatmap and stores it in this instance.
      */
@@ -776,13 +840,9 @@ declare class DroidDifficultyCalculator extends DifficultyCalculator {
     calculateVisual(): void;
     calculateTotal(): void;
     calculateAll(): void;
-    /**
-     * Returns a string representative of the class.
-     */
     toString(): string;
-    /**
-     * Creates skills to be calculated.
-     */
+    protected generateDifficultyHitObjects(convertedBeatmap: Beatmap): DroidDifficultyHitObject[];
+    protected computeDifficultyStatistics(options?: DroidDifficultyCalculationOptions): DifficultyStatisticsCalculatorResult<number, number, number, number>;
     protected createSkills(): DroidSkill[];
     /**
      * Called after aim skill calculation.
@@ -798,21 +858,14 @@ declare class DroidDifficultyCalculator extends DifficultyCalculator {
     /**
      * Called after tap skill calculation.
      *
-     * @param tapSkill The tap skill.
+     * @param tapSkillCheese The tap skill that considers cheesing.
+     * @param tapSkillVibro The tap skill that considers vibro.
      */
     private postCalculateTap;
     /**
-     * Calculates speed-related attributes.
-     */
-    private calculateSpeedAttributes;
-    /**
-     * Calculates the sum of strains for possible three-fingered sections.
-     *
-     * @param firstObjectIndex The index of the first object in the section.
-     * @param lastObjectIndex The index of the last object in the section.
-     * @returns The summed strain of the section.
+     * Calculates tap-related attributes.
      */
-    private calculateThreeFingerSummedStrain;
+    private calculateTapAttributes;
     /**
      * Called after rhythm skill calculation.
      *
@@ -839,19 +892,20 @@ declare class DroidDifficultyCalculator extends DifficultyCalculator {
  * Represents the skill required to memorize and hit every object in a beatmap with the Flashlight mod enabled.
  */
 declare class DroidFlashlight extends DroidSkill {
-    protected readonly skillMultiplier: number;
-    protected readonly strainDecayBase: number;
-    protected readonly reducedSectionCount: number;
-    protected readonly reducedSectionBaseline: number;
-    protected readonly starsPerDouble: number;
+    protected readonly strainDecayBase = 0.15;
+    protected readonly reducedSectionCount = 0;
+    protected readonly reducedSectionBaseline = 1;
+    protected readonly starsPerDouble = 1.06;
+    private readonly skillMultiplier;
     private readonly isHidden;
     private readonly withSliders;
+    private currentFlashlightStrain;
     constructor(mods: Mod[], withSliders: boolean);
-    /**
-     * @param current The hitobject to calculate.
-     */
-    protected strainValueAt(current: DifficultyHitObject): number;
-    protected saveToHitObject(current: DifficultyHitObject): void;
+    protected strainValueAt(current: DroidDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: DifficultyHitObject): number;
+    protected getObjectStrain(): number;
+    protected saveToHitObject(current: DroidDifficultyHitObject): void;
+    difficultyValue(): number;
 }
 
 /**
@@ -884,7 +938,7 @@ declare abstract class DroidFlashlightEvaluator extends FlashlightEvaluator {
      * @param isHiddenMod Whether the Hidden mod is enabled.
      * @param withSliders Whether to take slider difficulty into account.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, isHiddenMod: boolean, withSliders: boolean): number;
+    static evaluateDifficultyOf(current: DroidDifficultyHitObject, isHiddenMod: boolean, withSliders: boolean): number;
 }
 
 /**
@@ -924,7 +978,7 @@ interface PerformanceCalculationOptions {
 /**
  * The base class of performance calculators.
  */
-declare abstract class PerformanceCalculator {
+declare abstract class PerformanceCalculator<T extends DifficultyAttributes> {
     /**
      * The overall performance value.
      */
@@ -936,7 +990,7 @@ declare abstract class PerformanceCalculator {
     /**
      * The difficulty attributes that is being calculated.
      */
-    abstract readonly difficultyAttributes: DifficultyAttributes;
+    readonly difficultyAttributes: T;
     /**
      * Penalty for combo breaks.
      */
@@ -959,6 +1013,10 @@ declare abstract class PerformanceCalculator {
      * Nerf factor used for nerfing beatmaps with very likely dropped sliderends.
      */
     protected sliderNerfFactor: number;
+    /**
+     * @param difficultyAttributes The difficulty attributes to calculate.
+     */
+    constructor(difficultyAttributes: T | CacheableDifficultyAttributes<T>);
     /**
      * Calculates the performance points of the beatmap.
      *
@@ -978,7 +1036,7 @@ declare abstract class PerformanceCalculator {
     /**
      * Calculates the total performance value of the beatmap and stores it in this instance.
      */
-    protected abstract calculateTotalValue(): void;
+    protected abstract calculateTotalValue(): number;
     /**
      * The total hits that can be done in the beatmap.
      */
@@ -1001,12 +1059,19 @@ declare abstract class PerformanceCalculator {
      * Calculates the amount of misses + sliderbreaks from combo.
      */
     private calculateEffectiveMissCount;
+    /**
+     * Determines whether an attribute is a cacheable attribute.
+     *
+     * @param attributes The attributes to check.
+     * @returns Whether the attributes are cacheable.
+     */
+    private isCacheableAttribute;
 }
 
 /**
  * A performance points calculator that calculates performance points for osu!droid gamemode.
  */
-declare class DroidPerformanceCalculator extends PerformanceCalculator {
+declare class DroidPerformanceCalculator extends PerformanceCalculator<DroidDifficultyAttributes> {
     /**
      * The aim performance value.
      */
@@ -1059,19 +1124,14 @@ declare class DroidPerformanceCalculator extends PerformanceCalculator {
      * Can be properly obtained by analyzing the replay associated with the score.
      */
     get visualSliderCheesePenalty(): number;
-    readonly difficultyAttributes: DroidDifficultyAttributes;
     protected finalMultiplier: number;
-    protected readonly mode: Modes;
+    protected readonly mode = Modes.droid;
     private _aimSliderCheesePenalty;
     private _flashlightSliderCheesePenalty;
     private _visualSliderCheesePenalty;
     private _tapPenalty;
     private _deviation;
     private _tapDeviation;
-    /**
-     * @param difficultyAttributes The difficulty attributes to calculate.
-     */
-    constructor(difficultyAttributes: DroidDifficultyAttributes);
     /**
      * Applies a tap penalty value to this calculator.
      *
@@ -1105,7 +1165,7 @@ declare class DroidPerformanceCalculator extends PerformanceCalculator {
      */
     applyVisualSliderCheesePenalty(value: number): void;
     protected calculateValues(): void;
-    protected calculateTotalValue(): void;
+    protected calculateTotalValue(): number;
     protected handleOptions(options?: PerformanceCalculationOptions): void;
     /**
      * Calculates the aim performance value of the beatmap.
@@ -1127,6 +1187,27 @@ declare class DroidPerformanceCalculator extends PerformanceCalculator {
      * Calculates the visual performance value of the beatmap.
      */
     private calculateVisualValue;
+    /**
+     * Calculates a strain-based miss penalty.
+     *
+     * Strain-based miss penalty assumes that a player will miss on the hardest parts of a map,
+     * so we use the amount of relatively difficult sections to adjust miss penalty
+     * to make it more punishing on maps with lower amount of hard sections.
+     */
+    private calculateStrainBasedMissPenalty;
+    /**
+     * The object-based proportional miss penalty.
+     */
+    private get proportionalMissPenalty();
+    /**
+     * Calculates the object-based length scaling based on the deviation of a player for a full
+     * combo in this beatmap, taking retries into account.
+     *
+     * @param objectCount The amount of objects to be considered. Defaults to the amount of
+     * objects in this beatmap.
+     * @param punishForMemorization Whether to punish the deviation for memorization. Defaults to `false`.
+     */
+    private calculateDeviationBasedLengthScaling;
     /**
      * Estimates the player's tap deviation based on the OD, number of circles and sliders,
      * and number of 300s, 100s, 50s, and misses, assuming the player's mean hit error is 0.
@@ -1156,16 +1237,18 @@ declare class DroidPerformanceCalculator extends PerformanceCalculator {
  * Represents the skill required to properly follow a beatmap's rhythm.
  */
 declare class DroidRhythm extends DroidSkill {
-    protected readonly skillMultiplier: number;
-    protected readonly reducedSectionCount: number;
-    protected readonly reducedSectionBaseline: number;
-    protected readonly strainDecayBase: number;
-    protected readonly starsPerDouble: number;
-    private currentRhythm;
+    protected readonly reducedSectionCount = 5;
+    protected readonly reducedSectionBaseline = 0.75;
+    protected readonly strainDecayBase = 0.3;
+    protected readonly starsPerDouble = 1.75;
+    private currentRhythmStrain;
+    private currentRhythmMultiplier;
     private readonly hitWindow;
     constructor(mods: Mod[], overallDifficulty: number);
-    protected strainValueAt(current: DifficultyHitObject): number;
-    protected saveToHitObject(current: DifficultyHitObject): void;
+    protected strainValueAt(current: DroidDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: DroidDifficultyHitObject): number;
+    protected getObjectStrain(): number;
+    protected saveToHitObject(current: DroidDifficultyHitObject): void;
 }
 
 /**
@@ -1189,30 +1272,44 @@ declare abstract class DroidRhythmEvaluator extends RhythmEvaluator {
      * @param current The current object.
      * @param greatWindow The great hit window of the current object.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, greatWindow: number): number;
+    static evaluateDifficultyOf(current: DroidDifficultyHitObject, greatWindow: number): number;
 }
 
 /**
  * Represents the skill required to press keys or tap with regards to keeping up with the speed at which objects need to be hit.
  */
 declare class DroidTap extends DroidSkill {
-    protected readonly skillMultiplier: number;
-    protected readonly reducedSectionCount: number;
-    protected readonly reducedSectionBaseline: number;
-    protected readonly strainDecayBase: number;
-    protected readonly starsPerDouble: number;
+    protected readonly reducedSectionCount = 10;
+    protected readonly reducedSectionBaseline = 0.75;
+    protected readonly strainDecayBase = 0.3;
+    protected readonly starsPerDouble = 1.1;
     private currentTapStrain;
-    private currentOriginalTapStrain;
+    private currentRhythmMultiplier;
+    private readonly skillMultiplier;
     private readonly greatWindow;
-    constructor(mods: Mod[], overallDifficulty: number);
+    private readonly considerCheesability;
+    private readonly strainTimeCap?;
+    private readonly _objectDeltaTimes;
     /**
-     * @param current The hitobject to calculate.
+     * The delta time of hitobjects.
      */
-    protected strainValueAt(current: DifficultyHitObject): number;
+    get objectDeltaTimes(): readonly number[];
+    constructor(mods: Mod[], overallDifficulty: number, considerCheesability: boolean, strainTimeCap?: number);
+    /**
+     * The amount of notes that are relevant to the difficulty.
+     */
+    relevantNoteCount(): number;
+    /**
+     * The delta time relevant to the difficulty.
+     */
+    relevantDeltaTime(): number;
+    protected strainValueAt(current: DroidDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: DroidDifficultyHitObject): number;
+    protected getObjectStrain(): number;
     /**
      * @param current The hitobject to save to.
      */
-    protected saveToHitObject(current: DifficultyHitObject): void;
+    protected saveToHitObject(current: DroidDifficultyHitObject): void;
 }
 
 /**
@@ -1233,33 +1330,39 @@ declare abstract class DroidTapEvaluator extends SpeedEvaluator {
      *
      * - time between pressing the previous and current object,
      * - distance between those objects,
-     * - and how easily they can be cheesed.
+     * - how easily they can be cheesed,
+     * - and the strain time cap.
      *
      * @param current The current object.
      * @param greatWindow The great hit window of the current object.
      * @param considerCheesability Whether to consider cheesability.
+     * @param strainTimeCap The strain time to cap the object's strain time to.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, greatWindow: number, considerCheesability: boolean): number;
+    static evaluateDifficultyOf(current: DroidDifficultyHitObject, greatWindow: number, considerCheesability: boolean, strainTimeCap?: number): number;
 }
 
 /**
  * Represents the skill required to read every object in the map.
  */
 declare class DroidVisual extends DroidSkill {
-    protected readonly starsPerDouble: number;
-    protected readonly reducedSectionCount: number;
-    protected readonly reducedSectionBaseline: number;
-    protected readonly skillMultiplier: number;
-    protected readonly strainDecayBase: number;
+    protected readonly starsPerDouble = 1.025;
+    protected readonly reducedSectionCount = 10;
+    protected readonly reducedSectionBaseline = 0.75;
+    protected readonly strainDecayBase = 0.1;
     private readonly isHidden;
     private readonly withSliders;
+    private currentVisualStrain;
+    private currentRhythmMultiplier;
+    private readonly skillMultiplier;
     constructor(mods: Mod[], withSliders: boolean);
-    protected strainValueAt(current: DifficultyHitObject): number;
-    protected saveToHitObject(current: DifficultyHitObject): void;
+    protected strainValueAt(current: DroidDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: DroidDifficultyHitObject): number;
+    protected getObjectStrain(): number;
+    protected saveToHitObject(current: DroidDifficultyHitObject): void;
 }
 
 /**
- * An evaluator for calculating osu!droid Visual skill.
+ * An evaluator for calculating osu!droid visual skill.
  */
 declare abstract class DroidVisualEvaluator {
     /**
@@ -1277,7 +1380,7 @@ declare abstract class DroidVisualEvaluator {
      * @param isHiddenMod Whether the Hidden mod is enabled.
      * @param withSliders Whether to take slider difficulty into account.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, isHiddenMod: boolean, withSliders: boolean): number;
+    static evaluateDifficultyOf(current: DroidDifficultyHitObject, isHiddenMod: boolean, withSliders: boolean): number;
 }
 
 /**
@@ -1302,6 +1405,72 @@ declare abstract class OsuSkill extends StrainSkill {
     difficultyValue(): number;
 }
 
+/**
+ * Represents an osu!standard hit object with difficulty calculation values.
+ */
+declare class OsuDifficultyHitObject extends DifficultyHitObject {
+    /**
+     * The speed strain generated by the hitobject.
+     */
+    speedStrain: number;
+    /**
+     * The flashlight strain generated by this hitobject.
+     */
+    flashlightStrain: number;
+    private readonly radiusBuffThreshold;
+    protected readonly mode = Modes.osu;
+    protected get scalingFactor(): number;
+    /**
+     * Note: You **must** call `computeProperties` at some point due to how TypeScript handles
+     * overridden properties (see [this](https://github.com/microsoft/TypeScript/issues/1617) GitHub issue).
+     *
+     * @param object The underlying hitobject.
+     * @param lastObject The hitobject before this hitobject.
+     * @param lastLastObject The hitobject before the last hitobject.
+     * @param difficultyHitObjects All difficulty hitobjects in the processed beatmap.
+     * @param clockRate The clock rate of the beatmap.
+     */
+    constructor(object: PlaceableHitObject, lastObject: PlaceableHitObject | null, lastLastObject: PlaceableHitObject | null, difficultyHitObjects: readonly DifficultyHitObject[], clockRate: number);
+}
+
+/**
+ * Represents the skill required to correctly aim at every object in the map with a uniform CircleSize and normalized distances.
+ */
+declare class OsuAim extends OsuSkill {
+    protected readonly strainDecayBase: number;
+    protected readonly reducedSectionCount: number;
+    protected readonly reducedSectionBaseline: number;
+    protected readonly decayWeight: number;
+    private currentAimStrain;
+    private readonly skillMultiplier;
+    private readonly withSliders;
+    constructor(mods: Mod[], withSliders: boolean);
+    protected strainValueAt(current: OsuDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: OsuDifficultyHitObject): number;
+    /**
+     * @param current The hitobject to save to.
+     */
+    protected saveToHitObject(current: OsuDifficultyHitObject): void;
+}
+
+/**
+ * An evaluator for calculating osu!standard Aim skill.
+ */
+declare abstract class OsuAimEvaluator extends AimEvaluator {
+    /**
+     * Evaluates the difficulty of aiming the current object, based on:
+     *
+     * - cursor velocity to the current object,
+     * - angle difficulty,
+     * - sharp velocity increases,
+     * - and slider difficulty.
+     *
+     * @param current The current object.
+     * @param withSliders Whether to take slider difficulty into account.
+     */
+    static evaluateDifficultyOf(current: OsuDifficultyHitObject, withSliders: boolean): number;
+}
+
 /**
  * Holds data that can be used to calculate osu!standard performance points.
  */
@@ -1315,22 +1484,23 @@ interface OsuDifficultyAttributes extends DifficultyAttributes {
 /**
  * A difficulty calculator for osu!standard gamemode.
  */
-declare class OsuDifficultyCalculator extends DifficultyCalculator {
+declare class OsuDifficultyCalculator extends DifficultyCalculator<OsuDifficultyHitObject, OsuDifficultyAttributes> {
     /**
      * The aim star rating of the beatmap.
      */
-    aim: number;
+    get aim(): number;
     /**
      * The speed star rating of the beatmap.
      */
-    speed: number;
+    get speed(): number;
     /**
      * The flashlight star rating of the beatmap.
      */
-    flashlight: number;
+    get flashlight(): number;
     readonly attributes: OsuDifficultyAttributes;
-    protected readonly difficultyMultiplier: number;
-    protected readonly mode: Modes;
+    get cacheableAttributes(): CacheableDifficultyAttributes<OsuDifficultyAttributes>;
+    protected readonly difficultyMultiplier = 0.0675;
+    protected readonly mode = Modes.osu;
     /**
      * Calculates the aim star rating of the beatmap and stores it in this instance.
      */
@@ -1345,13 +1515,9 @@ declare class OsuDifficultyCalculator extends DifficultyCalculator {
     calculateFlashlight(): void;
     calculateTotal(): void;
     calculateAll(): void;
-    /**
-     * Returns a string representative of the class.
-     */
     toString(): string;
-    /**
-     * Creates skills to be calculated.
-     */
+    protected generateDifficultyHitObjects(convertedBeatmap: Beatmap): OsuDifficultyHitObject[];
+    protected computeDifficultyStatistics(options?: DifficultyCalculationOptions): DifficultyStatisticsCalculatorResult<number, number, number, number>;
     protected createSkills(): OsuSkill[];
     /**
      * Called after aim skill calculation.
@@ -1378,87 +1544,21 @@ declare class OsuDifficultyCalculator extends DifficultyCalculator {
     private postCalculateFlashlight;
 }
 
-/**
- * A difficulty calculator that calculates for both osu!droid and osu!standard gamemode.
- */
-declare class MapStars {
-    /**
-     * The osu!droid difficulty calculator of the beatmap.
-     */
-    readonly droid: DroidDifficultyCalculator;
-    /**
-     * The osu!standard difficulty calculator of the beatmap.
-     */
-    readonly osu: OsuDifficultyCalculator;
-    /**
-     * Constructs this instance and calculates the given beatmap's osu!droid and osu!standard difficulty.
-     *
-     * @param beatmap The beatmap to calculate.
-     * @param options Options for the difficulty calculation.
-     */
-    constructor(beatmap: Beatmap, options?: DifficultyCalculationOptions);
-    /**
-     * Returns a string representative of the class.
-     */
-    toString(): string;
-}
-
-/**
- * Represents the skill required to correctly aim at every object in the map with a uniform CircleSize and normalized distances.
- */
-declare class OsuAim extends OsuSkill {
-    protected readonly skillMultiplier: number;
-    protected readonly strainDecayBase: number;
-    protected readonly reducedSectionCount: number;
-    protected readonly reducedSectionBaseline: number;
-    protected readonly difficultyMultiplier: number;
-    protected readonly decayWeight: number;
-    private readonly withSliders;
-    constructor(mods: Mod[], withSliders: boolean);
-    /**
-     * @param current The hitobject to calculate.
-     */
-    protected strainValueAt(current: DifficultyHitObject): number;
-    /**
-     * @param current The hitobject to save to.
-     */
-    protected saveToHitObject(current: DifficultyHitObject): void;
-}
-
-/**
- * An evaluator for calculating osu!standard Aim skill.
- */
-declare abstract class OsuAimEvaluator extends AimEvaluator {
-    /**
-     * Evaluates the difficulty of aiming the current object, based on:
-     *
-     * - cursor velocity to the current object,
-     * - angle difficulty,
-     * - sharp velocity increases,
-     * - and slider difficulty.
-     *
-     * @param current The current object.
-     * @param withSliders Whether to take slider difficulty into account.
-     */
-    static evaluateDifficultyOf(current: DifficultyHitObject, withSliders: boolean): number;
-}
-
 /**
  * Represents the skill required to memorize and hit every object in a beatmap with the Flashlight mod enabled.
  */
 declare class OsuFlashlight extends OsuSkill {
-    protected readonly skillMultiplier: number;
     protected readonly strainDecayBase: number;
     protected readonly reducedSectionCount: number;
     protected readonly reducedSectionBaseline: number;
     protected readonly decayWeight: number;
+    private currentFlashlightStrain;
+    private readonly skillMultiplier;
     private readonly isHidden;
     constructor(mods: Mod[]);
-    /**
-     * @param current The hitobject to calculate.
-     */
-    protected strainValueAt(current: DifficultyHitObject): number;
-    protected saveToHitObject(current: DifficultyHitObject): void;
+    protected strainValueAt(current: OsuDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: OsuDifficultyHitObject): number;
+    protected saveToHitObject(current: OsuDifficultyHitObject): void;
 }
 
 /**
@@ -1477,13 +1577,13 @@ declare abstract class OsuFlashlightEvaluator extends FlashlightEvaluator {
      * @param current The current object.
      * @param isHiddenMod Whether the Hidden mod is enabled.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, isHiddenMod: boolean): number;
+    static evaluateDifficultyOf(current: OsuDifficultyHitObject, isHiddenMod: boolean): number;
 }
 
 /**
  * A performance points calculator that calculates performance points for osu!standard gamemode.
  */
-declare class OsuPerformanceCalculator extends PerformanceCalculator {
+declare class OsuPerformanceCalculator extends PerformanceCalculator<OsuDifficultyAttributes> {
     /**
      * The aim performance value.
      */
@@ -1500,15 +1600,10 @@ declare class OsuPerformanceCalculator extends PerformanceCalculator {
      * The flashlight performance value.
      */
     flashlight: number;
-    readonly difficultyAttributes: OsuDifficultyAttributes;
     protected finalMultiplier: number;
     protected readonly mode: Modes;
-    /**
-     * @param difficultyAttributes The difficulty attributes to calculate.
-     */
-    constructor(difficultyAttributes: OsuDifficultyAttributes);
     protected calculateValues(): void;
-    protected calculateTotalValue(): void;
+    protected calculateTotalValue(): number;
     /**
      * Calculates the aim performance value of the beatmap.
      */
@@ -1539,31 +1634,32 @@ declare abstract class OsuRhythmEvaluator extends RhythmEvaluator {
      * @param current The current object.
      * @param greatWindow The great hit window of the current object.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, greatWindow: number): number;
+    static evaluateDifficultyOf(current: OsuDifficultyHitObject, greatWindow: number): number;
 }
 
 /**
  * Represents the skill required to press keys or tap with regards to keeping up with the speed at which objects need to be hit.
  */
 declare class OsuSpeed extends OsuSkill {
-    protected readonly skillMultiplier: number;
-    protected readonly strainDecayBase: number;
-    protected readonly reducedSectionCount: number;
-    protected readonly reducedSectionBaseline: number;
-    protected readonly difficultyMultiplier: number;
-    protected readonly decayWeight: number;
+    protected readonly strainDecayBase = 0.3;
+    protected readonly reducedSectionCount = 5;
+    protected readonly reducedSectionBaseline = 0.75;
+    protected readonly difficultyMultiplier = 1.04;
+    protected readonly decayWeight = 0.9;
     private currentSpeedStrain;
     private currentRhythm;
+    private readonly skillMultiplier;
     private readonly greatWindow;
-    constructor(mods: Mod[], greatWindow: number);
+    constructor(mods: Mod[], overallDifficulty: number);
     /**
      * @param current The hitobject to calculate.
      */
-    protected strainValueAt(current: DifficultyHitObject): number;
+    protected strainValueAt(current: OsuDifficultyHitObject): number;
+    protected calculateInitialStrain(time: number, current: OsuDifficultyHitObject): number;
     /**
      * @param current The hitobject to save to.
      */
-    protected saveToHitObject(current: DifficultyHitObject): void;
+    protected saveToHitObject(current: OsuDifficultyHitObject): void;
 }
 
 /**
@@ -1584,7 +1680,7 @@ declare abstract class OsuSpeedEvaluator extends SpeedEvaluator {
      * @param current The current object.
      * @param greatWindow The great hit window of the current object.
      */
-    static evaluateDifficultyOf(current: DifficultyHitObject, greatWindow: number): number;
+    static evaluateDifficultyOf(current: OsuDifficultyHitObject, greatWindow: number): number;
 }
 
-export { AimEvaluator, CalculationOptions, DifficultSlider, DifficultyAttributes, DifficultyCalculationOptions, DifficultyCalculator, DifficultyHitObject, DifficultyHitObjectCreator, DroidAim, DroidAimEvaluator, DroidDifficultyAttributes, DroidDifficultyCalculator, DroidFlashlight, DroidFlashlightEvaluator, DroidPerformanceCalculator, DroidRhythm, DroidRhythmEvaluator, DroidTap, DroidTapEvaluator, DroidVisual, DroidVisualEvaluator, ExtendedDroidDifficultyAttributes, FlashlightEvaluator, HighStrainSection, MapStars, OsuAim, OsuAimEvaluator, OsuDifficultyAttributes, OsuDifficultyCalculator, OsuFlashlight, OsuFlashlightEvaluator, OsuPerformanceCalculator, OsuRhythmEvaluator, OsuSpeed, OsuSpeedEvaluator, PerformanceCalculationOptions, PerformanceCalculator, RhythmEvaluator, SpeedEvaluator, StrainPeaks };
+export { AimEvaluator, type CacheableDifficultyAttributes, type DifficultSlider, type DifficultyAttributes, type DifficultyCalculationOptions, DifficultyCalculator, DifficultyHitObject, DroidAim, DroidAimEvaluator, type DroidDifficultyAttributes, type DroidDifficultyCalculationOptions, DroidDifficultyCalculator, DroidDifficultyHitObject, DroidFlashlight, DroidFlashlightEvaluator, DroidPerformanceCalculator, DroidRhythm, DroidRhythmEvaluator, DroidTap, DroidTapEvaluator, DroidVisual, DroidVisualEvaluator, type ExtendedDroidDifficultyAttributes, FlashlightEvaluator, type HighStrainSection, OsuAim, OsuAimEvaluator, type OsuDifficultyAttributes, OsuDifficultyCalculator, OsuDifficultyHitObject, OsuFlashlight, OsuFlashlightEvaluator, OsuPerformanceCalculator, OsuRhythmEvaluator, OsuSpeed, OsuSpeedEvaluator, type PerformanceCalculationOptions, PerformanceCalculator, RhythmEvaluator, SpeedEvaluator, type StrainPeaks };