@contractspec/module.learning-journey 1.57.0 → 1.58.0

package/dist/engines/xp.d.ts

@@ -1,97 +1,94 @@
-//#region src/engines/xp.d.ts
 /**
  * XP (Experience Points) Engine
  *
  * Calculates XP rewards for various learning activities.
  */
-type XPActivityType = 'lesson_complete' | 'quiz_pass' | 'quiz_perfect' | 'flashcard_review' | 'course_complete' | 'module_complete' | 'streak_bonus' | 'achievement_unlock' | 'daily_goal_complete' | 'first_lesson' | 'onboarding_step' | 'onboarding_complete';
-interface XPCalculationInput {
-  /** Type of activity */
-  activity: XPActivityType;
-  /** Base XP for the activity (from content config) */
-  baseXp?: number;
-  /** Score achieved (0-100) for scored activities */
-  score?: number;
-  /** Current streak (for streak bonuses) */
-  currentStreak?: number;
-  /** Time spent in seconds */
-  timeSpent?: number;
-  /** Attempt number (for quizzes) */
-  attemptNumber?: number;
-  /** Whether this is a retry */
-  isRetry?: boolean;
+export type XPActivityType = 'lesson_complete' | 'quiz_pass' | 'quiz_perfect' | 'flashcard_review' | 'course_complete' | 'module_complete' | 'streak_bonus' | 'achievement_unlock' | 'daily_goal_complete' | 'first_lesson' | 'onboarding_step' | 'onboarding_complete';
+export interface XPCalculationInput {
+    /** Type of activity */
+    activity: XPActivityType;
+    /** Base XP for the activity (from content config) */
+    baseXp?: number;
+    /** Score achieved (0-100) for scored activities */
+    score?: number;
+    /** Current streak (for streak bonuses) */
+    currentStreak?: number;
+    /** Time spent in seconds */
+    timeSpent?: number;
+    /** Attempt number (for quizzes) */
+    attemptNumber?: number;
+    /** Whether this is a retry */
+    isRetry?: boolean;
 }
-interface XPResult {
-  /** Total XP earned */
-  totalXp: number;
-  /** Base XP before bonuses */
-  baseXp: number;
-  /** Breakdown of XP sources */
-  breakdown: XPBreakdown[];
+export interface XPResult {
+    /** Total XP earned */
+    totalXp: number;
+    /** Base XP before bonuses */
+    baseXp: number;
+    /** Breakdown of XP sources */
+    breakdown: XPBreakdown[];
 }
-interface XPBreakdown {
-  /** Source of XP */
-  source: string;
-  /** XP amount */
-  amount: number;
-  /** Multiplier applied */
-  multiplier?: number;
+export interface XPBreakdown {
+    /** Source of XP */
+    source: string;
+    /** XP amount */
+    amount: number;
+    /** Multiplier applied */
+    multiplier?: number;
 }
-interface XPConfig {
-  /** Base XP values for each activity */
-  baseValues: Record<XPActivityType, number>;
-  /** Score thresholds for bonus XP */
-  scoreThresholds: {
-    min: number;
-    multiplier: number;
-  }[];
-  /** Streak bonus tiers */
-  streakTiers: {
-    days: number;
-    bonus: number;
-  }[];
-  /** Perfect score bonus multiplier */
-  perfectScoreMultiplier: number;
-  /** First attempt bonus */
-  firstAttemptBonus: number;
-  /** Retry penalty multiplier */
-  retryPenalty: number;
-  /** Speed bonus (complete under expected time) */
-  speedBonusMultiplier: number;
-  /** Speed bonus threshold (percentage of expected time) */
-  speedBonusThreshold: number;
+export interface XPConfig {
+    /** Base XP values for each activity */
+    baseValues: Record<XPActivityType, number>;
+    /** Score thresholds for bonus XP */
+    scoreThresholds: {
+        min: number;
+        multiplier: number;
+    }[];
+    /** Streak bonus tiers */
+    streakTiers: {
+        days: number;
+        bonus: number;
+    }[];
+    /** Perfect score bonus multiplier */
+    perfectScoreMultiplier: number;
+    /** First attempt bonus */
+    firstAttemptBonus: number;
+    /** Retry penalty multiplier */
+    retryPenalty: number;
+    /** Speed bonus (complete under expected time) */
+    speedBonusMultiplier: number;
+    /** Speed bonus threshold (percentage of expected time) */
+    speedBonusThreshold: number;
 }
-declare const DEFAULT_XP_CONFIG: XPConfig;
-declare class XPEngine {
-  private config;
-  constructor(config?: Partial<XPConfig>);
-  /**
-   * Calculate XP for an activity.
-   */
-  calculate(input: XPCalculationInput): XPResult;
-  /**
-   * Calculate streak bonus XP.
-   */
-  calculateStreakBonus(currentStreak: number): XPResult;
-  /**
-   * Calculate XP needed for a level.
-   */
-  getXpForLevel(level: number): number;
-  /**
-   * Get level from total XP.
-   */
-  getLevelFromXp(totalXp: number): {
-    level: number;
-    xpInLevel: number;
-    xpForNextLevel: number;
-  };
-  private getScoreMultiplier;
-  private getStreakBonus;
+export declare const DEFAULT_XP_CONFIG: XPConfig;
+export declare class XPEngine {
+    private config;
+    constructor(config?: Partial<XPConfig>);
+    /**
+     * Calculate XP for an activity.
+     */
+    calculate(input: XPCalculationInput): XPResult;
+    /**
+     * Calculate streak bonus XP.
+     */
+    calculateStreakBonus(currentStreak: number): XPResult;
+    /**
+     * Calculate XP needed for a level.
+     */
+    getXpForLevel(level: number): number;
+    /**
+     * Get level from total XP.
+     */
+    getLevelFromXp(totalXp: number): {
+        level: number;
+        xpInLevel: number;
+        xpForNextLevel: number;
+    };
+    private getScoreMultiplier;
+    private getStreakBonus;
 }
 /**
  * Default XP engine instance.
  */
-declare const xpEngine: XPEngine;
-//#endregion
-export { DEFAULT_XP_CONFIG, XPActivityType, XPBreakdown, XPCalculationInput, XPConfig, XPEngine, XPResult, xpEngine };
+export declare const xpEngine: XPEngine;
 //# sourceMappingURL=xp.d.ts.map

package/dist/engines/xp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xp.d.ts","names":[],"sources":["../../src/engines/xp.ts"],"mappings":";;AAQA;;;;KAAY,cAAA;AAAA,UAcK,kBAAA;EAAkB;EAEjC,QAAA,EAAU,cAAA;EAAc;EAExB,MAAA;EAFU;EAIV,KAAA;EAAA;EAEA,aAAA;EAEA;EAAA,SAAA;EAIA;EAFA,aAAA;EAEO;EAAP,OAAA;AAAA;AAAA,UAGe,QAAA;EAMO;EAJtB,OAAA;EAEA;EAAA,MAAA;EAEW;EAAX,SAAA,EAAW,WAAA;AAAA;AAAA,UAGI,WAAA;EAAW;EAE1B,MAAA;EAF0B;EAI1B,MAAA;EAAA;EAEA,UAAA;AAAA;AAAA,UAGe,QAAA;EAAA;EAEf,UAAA,EAAY,MAAA,CAAO,cAAA;;EAEnB,eAAA;IAAmB,GAAA;IAAa,UAAA;EAAA;EAAhC;EAEA,WAAA;IAAe,IAAA;IAAc,KAAA;EAAA;EAAA;EAE7B,sBAAA;EAEA;EAAA,iBAAA;EAIA;EAFA,YAAA;EAImB;EAFnB,oBAAA;EAOW;EALX,mBAAA;AAAA;AAAA,cAKW,iBAAA,EAAmB,QAAA;AAAA,cAyCnB,QAAA;EAAA,QACH,MAAA;cAEI,MAAA,GAAQ,OAAA,CAAQ,QAAA;;;;EAc5B,SAAA,CAAU,KAAA,EAAO,kBAAA,GAAqB,QAAA;EAAA;;;EAsFtC,oBAAA,CAAqB,aAAA,WAAwB,QAAA;EAtGrC;;;EAuHR,aAAA,CAAc,KAAA;EArHF;;;EAkIZ,cAAA,CAAe,OAAA;IACb,KAAA;IACA,SAAA;IACA,cAAA;EAAA;EAAA,QAsBM,kBAAA;EAAA,QASA,cAAA;AAAA;;;;cAaG,QAAA,EAAQ,QAAA"}
+{"version":3,"file":"xp.d.ts","sourceRoot":"","sources":["../../src/engines/xp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,oBAAoB,GACpB,qBAAqB,GACrB,cAAc,GACd,iBAAiB,GACjB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3C,oCAAoC;IACpC,eAAe,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,yBAAyB;IACzB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,qCAAqC;IACrC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAID,eAAO,MAAM,iBAAiB,EAAE,QAqC/B,CAAC;AAIF,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,GAAE,OAAO,CAAC,QAAQ,CAAM;IAW1C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ;IAmF9C;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ;IAcrD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUpC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;QAC/B,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB;IAqBD,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,cAAc;CAQvB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,UAAiB,CAAC"}

package/dist/engines/xp.js

@@ -1,213 +1,172 @@
-//#region src/engines/xp.ts
-const DEFAULT_XP_CONFIG = {
-	baseValues: {
-		lesson_complete: 10,
-		quiz_pass: 20,
-		quiz_perfect: 50,
-		flashcard_review: 1,
-		course_complete: 200,
-		module_complete: 50,
-		streak_bonus: 5,
-		achievement_unlock: 0,
-		daily_goal_complete: 15,
-		first_lesson: 25,
-		onboarding_step: 5,
-		onboarding_complete: 50
-	},
-	scoreThresholds: [
-		{
-			min: 90,
-			multiplier: 1.5
-		},
-		{
-			min: 80,
-			multiplier: 1.25
-		},
-		{
-			min: 70,
-			multiplier: 1
-		},
-		{
-			min: 60,
-			multiplier: .75
-		},
-		{
-			min: 0,
-			multiplier: .5
-		}
-	],
-	streakTiers: [
-		{
-			days: 365,
-			bonus: 50
-		},
-		{
-			days: 180,
-			bonus: 30
-		},
-		{
-			days: 90,
-			bonus: 20
-		},
-		{
-			days: 30,
-			bonus: 15
-		},
-		{
-			days: 14,
-			bonus: 10
-		},
-		{
-			days: 7,
-			bonus: 5
-		},
-		{
-			days: 3,
-			bonus: 2
-		},
-		{
-			days: 1,
-			bonus: 0
-		}
-	],
-	perfectScoreMultiplier: 1.5,
-	firstAttemptBonus: 10,
-	retryPenalty: .5,
-	speedBonusMultiplier: 1.2,
-	speedBonusThreshold: .8
+// @bun
+// src/engines/xp.ts
+var DEFAULT_XP_CONFIG = {
+  baseValues: {
+    lesson_complete: 10,
+    quiz_pass: 20,
+    quiz_perfect: 50,
+    flashcard_review: 1,
+    course_complete: 200,
+    module_complete: 50,
+    streak_bonus: 5,
+    achievement_unlock: 0,
+    daily_goal_complete: 15,
+    first_lesson: 25,
+    onboarding_step: 5,
+    onboarding_complete: 50
+  },
+  scoreThresholds: [
+    { min: 90, multiplier: 1.5 },
+    { min: 80, multiplier: 1.25 },
+    { min: 70, multiplier: 1 },
+    { min: 60, multiplier: 0.75 },
+    { min: 0, multiplier: 0.5 }
+  ],
+  streakTiers: [
+    { days: 365, bonus: 50 },
+    { days: 180, bonus: 30 },
+    { days: 90, bonus: 20 },
+    { days: 30, bonus: 15 },
+    { days: 14, bonus: 10 },
+    { days: 7, bonus: 5 },
+    { days: 3, bonus: 2 },
+    { days: 1, bonus: 0 }
+  ],
+  perfectScoreMultiplier: 1.5,
+  firstAttemptBonus: 10,
+  retryPenalty: 0.5,
+  speedBonusMultiplier: 1.2,
+  speedBonusThreshold: 0.8
 };
-var XPEngine = class {
-	config;
-	constructor(config = {}) {
-		this.config = {
-			...DEFAULT_XP_CONFIG,
-			...config,
-			baseValues: {
-				...DEFAULT_XP_CONFIG.baseValues,
-				...config.baseValues
-			},
-			scoreThresholds: config.scoreThresholds || DEFAULT_XP_CONFIG.scoreThresholds,
-			streakTiers: config.streakTiers || DEFAULT_XP_CONFIG.streakTiers
-		};
-	}
-	/**
-	* Calculate XP for an activity.
-	*/
-	calculate(input) {
-		const breakdown = [];
-		const baseXp = input.baseXp ?? this.config.baseValues[input.activity];
-		let totalXp = baseXp;
-		breakdown.push({
-			source: "base",
-			amount: baseXp
-		});
-		if (input.score !== void 0) {
-			const scoreMultiplier = this.getScoreMultiplier(input.score);
-			if (scoreMultiplier !== 1) {
-				const scoreBonus = Math.round(baseXp * (scoreMultiplier - 1));
-				totalXp += scoreBonus;
-				breakdown.push({
-					source: "score_bonus",
-					amount: scoreBonus,
-					multiplier: scoreMultiplier
-				});
-			}
-			if (input.score === 100) {
-				const perfectBonus = Math.round(baseXp * (this.config.perfectScoreMultiplier - 1));
-				totalXp += perfectBonus;
-				breakdown.push({
-					source: "perfect_score",
-					amount: perfectBonus,
-					multiplier: this.config.perfectScoreMultiplier
-				});
-			}
-		}
-		if (input.attemptNumber === 1 && !input.isRetry) {
-			totalXp += this.config.firstAttemptBonus;
-			breakdown.push({
-				source: "first_attempt",
-				amount: this.config.firstAttemptBonus
-			});
-		}
-		if (input.isRetry) {
-			const penalty = Math.round(totalXp * (1 - this.config.retryPenalty));
-			totalXp -= penalty;
-			breakdown.push({
-				source: "retry_penalty",
-				amount: -penalty,
-				multiplier: this.config.retryPenalty
-			});
-		}
-		if (input.currentStreak && input.currentStreak > 0) {
-			const streakBonus = this.getStreakBonus(input.currentStreak);
-			if (streakBonus > 0) {
-				totalXp += streakBonus;
-				breakdown.push({
-					source: "streak_bonus",
-					amount: streakBonus
-				});
-			}
-		}
-		if (baseXp > 0) totalXp = Math.max(1, totalXp);
-		return {
-			totalXp: Math.round(totalXp),
-			baseXp,
-			breakdown
-		};
-	}
-	/**
-	* Calculate streak bonus XP.
-	*/
-	calculateStreakBonus(currentStreak) {
-		const bonus = this.getStreakBonus(currentStreak);
-		return {
-			totalXp: bonus,
-			baseXp: bonus,
-			breakdown: [{
-				source: "streak_bonus",
-				amount: bonus
-			}]
-		};
-	}
-	/**
-	* Calculate XP needed for a level.
-	*/
-	getXpForLevel(level) {
-		if (level <= 1) return 0;
-		return Math.round(100 * Math.pow(level - 1, 1.5));
-	}
-	/**
-	* Get level from total XP.
-	*/
-	getLevelFromXp(totalXp) {
-		let level = 1;
-		let xpRequired = this.getXpForLevel(level + 1);
-		while (totalXp >= xpRequired && level < 1e3) {
-			level++;
-			xpRequired = this.getXpForLevel(level + 1);
-		}
-		const xpForCurrentLevel = this.getXpForLevel(level);
-		const xpForNextLevel = this.getXpForLevel(level + 1);
-		return {
-			level,
-			xpInLevel: totalXp - xpForCurrentLevel,
-			xpForNextLevel: xpForNextLevel - xpForCurrentLevel
-		};
-	}
-	getScoreMultiplier(score) {
-		for (const threshold of this.config.scoreThresholds) if (score >= threshold.min) return threshold.multiplier;
-		return 1;
-	}
-	getStreakBonus(streak) {
-		for (const tier of this.config.streakTiers) if (streak >= tier.days) return tier.bonus;
-		return 0;
-	}
-};
-/**
-* Default XP engine instance.
-*/
-const xpEngine = new XPEngine();
 
-//#endregion
-export { DEFAULT_XP_CONFIG, XPEngine, xpEngine };
-//# sourceMappingURL=xp.js.map
+class XPEngine {
+  config;
+  constructor(config = {}) {
+    this.config = {
+      ...DEFAULT_XP_CONFIG,
+      ...config,
+      baseValues: { ...DEFAULT_XP_CONFIG.baseValues, ...config.baseValues },
+      scoreThresholds: config.scoreThresholds || DEFAULT_XP_CONFIG.scoreThresholds,
+      streakTiers: config.streakTiers || DEFAULT_XP_CONFIG.streakTiers
+    };
+  }
+  calculate(input) {
+    const breakdown = [];
+    const baseXp = input.baseXp ?? this.config.baseValues[input.activity];
+    let totalXp = baseXp;
+    breakdown.push({
+      source: "base",
+      amount: baseXp
+    });
+    if (input.score !== undefined) {
+      const scoreMultiplier = this.getScoreMultiplier(input.score);
+      if (scoreMultiplier !== 1) {
+        const scoreBonus = Math.round(baseXp * (scoreMultiplier - 1));
+        totalXp += scoreBonus;
+        breakdown.push({
+          source: "score_bonus",
+          amount: scoreBonus,
+          multiplier: scoreMultiplier
+        });
+      }
+      if (input.score === 100) {
+        const perfectBonus = Math.round(baseXp * (this.config.perfectScoreMultiplier - 1));
+        totalXp += perfectBonus;
+        breakdown.push({
+          source: "perfect_score",
+          amount: perfectBonus,
+          multiplier: this.config.perfectScoreMultiplier
+        });
+      }
+    }
+    if (input.attemptNumber === 1 && !input.isRetry) {
+      totalXp += this.config.firstAttemptBonus;
+      breakdown.push({
+        source: "first_attempt",
+        amount: this.config.firstAttemptBonus
+      });
+    }
+    if (input.isRetry) {
+      const penalty = Math.round(totalXp * (1 - this.config.retryPenalty));
+      totalXp -= penalty;
+      breakdown.push({
+        source: "retry_penalty",
+        amount: -penalty,
+        multiplier: this.config.retryPenalty
+      });
+    }
+    if (input.currentStreak && input.currentStreak > 0) {
+      const streakBonus = this.getStreakBonus(input.currentStreak);
+      if (streakBonus > 0) {
+        totalXp += streakBonus;
+        breakdown.push({
+          source: "streak_bonus",
+          amount: streakBonus
+        });
+      }
+    }
+    if (baseXp > 0) {
+      totalXp = Math.max(1, totalXp);
+    }
+    return {
+      totalXp: Math.round(totalXp),
+      baseXp,
+      breakdown
+    };
+  }
+  calculateStreakBonus(currentStreak) {
+    const bonus = this.getStreakBonus(currentStreak);
+    return {
+      totalXp: bonus,
+      baseXp: bonus,
+      breakdown: [
+        {
+          source: "streak_bonus",
+          amount: bonus
+        }
+      ]
+    };
+  }
+  getXpForLevel(level) {
+    if (level <= 1)
+      return 0;
+    return Math.round(100 * Math.pow(level - 1, 1.5));
+  }
+  getLevelFromXp(totalXp) {
+    let level = 1;
+    let xpRequired = this.getXpForLevel(level + 1);
+    while (totalXp >= xpRequired && level < 1000) {
+      level++;
+      xpRequired = this.getXpForLevel(level + 1);
+    }
+    const xpForCurrentLevel = this.getXpForLevel(level);
+    const xpForNextLevel = this.getXpForLevel(level + 1);
+    return {
+      level,
+      xpInLevel: totalXp - xpForCurrentLevel,
+      xpForNextLevel: xpForNextLevel - xpForCurrentLevel
+    };
+  }
+  getScoreMultiplier(score) {
+    for (const threshold of this.config.scoreThresholds) {
+      if (score >= threshold.min) {
+        return threshold.multiplier;
+      }
+    }
+    return 1;
+  }
+  getStreakBonus(streak) {
+    for (const tier of this.config.streakTiers) {
+      if (streak >= tier.days) {
+        return tier.bonus;
+      }
+    }
+    return 0;
+  }
+}
+var xpEngine = new XPEngine;
+export {
+  xpEngine,
+  XPEngine,
+  DEFAULT_XP_CONFIG
+};