@contractspec/module.learning-journey 3.7.16 → 3.7.18

package/dist/browser/engines/index.js

@@ -1,675 +1 @@
-// src/engines/srs.ts
-var DEFAULT_SRS_CONFIG = {
-  learningSteps: [1, 10],
-  graduatingInterval: 1,
-  easyInterval: 4,
-  relearningSteps: [10],
-  minEaseFactor: 1.3,
-  maxInterval: 365,
-  intervalModifier: 1,
-  newIntervalModifier: 0.5,
-  hardIntervalModifier: 1.2,
-  easyBonus: 1.3
-};
-
-class SRSEngine {
-  config;
-  constructor(config = {}) {
-    this.config = { ...DEFAULT_SRS_CONFIG, ...config };
-  }
-  calculateNextReview(state, rating, now = new Date) {
-    if (!state.isGraduated && !state.isRelearning) {
-      return this.handleLearningCard(state, rating, now);
-    }
-    if (state.isRelearning) {
-      return this.handleRelearningCard(state, rating, now);
-    }
-    return this.handleReviewCard(state, rating, now);
-  }
-  getInitialState() {
-    return {
-      interval: 0,
-      easeFactor: 2.5,
-      repetitions: 0,
-      learningStep: 0,
-      isGraduated: false,
-      isRelearning: false,
-      lapses: 0
-    };
-  }
-  isDue(nextReviewAt, now = new Date) {
-    return nextReviewAt <= now;
-  }
-  getOverdueDays(nextReviewAt, now = new Date) {
-    const diff = now.getTime() - nextReviewAt.getTime();
-    return Math.floor(diff / (1000 * 60 * 60 * 24));
-  }
-  handleLearningCard(state, rating, now) {
-    const steps = this.config.learningSteps;
-    let newStep = state.learningStep;
-    let isGraduated = false;
-    let interval = 0;
-    let nextReviewAt;
-    switch (rating) {
-      case "AGAIN":
-        newStep = 0;
-        interval = steps[0] ?? 1;
-        nextReviewAt = this.addMinutes(now, interval);
-        break;
-      case "HARD":
-        interval = steps[newStep] ?? steps[0] ?? 1;
-        nextReviewAt = this.addMinutes(now, interval);
-        break;
-      case "GOOD":
-        newStep++;
-        if (newStep >= steps.length) {
-          isGraduated = true;
-          interval = this.config.graduatingInterval;
-          nextReviewAt = this.addDays(now, interval);
-        } else {
-          interval = steps[newStep] ?? 10;
-          nextReviewAt = this.addMinutes(now, interval);
-        }
-        break;
-      case "EASY":
-        isGraduated = true;
-        interval = this.config.easyInterval;
-        nextReviewAt = this.addDays(now, interval);
-        break;
-    }
-    return {
-      interval: isGraduated ? interval : 0,
-      easeFactor: state.easeFactor,
-      repetitions: isGraduated ? 1 : 0,
-      nextReviewAt,
-      learningStep: newStep,
-      isGraduated,
-      isRelearning: false,
-      lapses: state.lapses
-    };
-  }
-  handleRelearningCard(state, rating, now) {
-    const steps = this.config.relearningSteps;
-    let newStep = state.learningStep;
-    let isRelearning = true;
-    let interval = 0;
-    let nextReviewAt;
-    switch (rating) {
-      case "AGAIN":
-        newStep = 0;
-        interval = steps[0] ?? 10;
-        nextReviewAt = this.addMinutes(now, interval);
-        break;
-      case "HARD":
-        interval = steps[newStep] ?? steps[0] ?? 10;
-        nextReviewAt = this.addMinutes(now, interval);
-        break;
-      case "GOOD":
-        newStep++;
-        if (newStep >= steps.length) {
-          isRelearning = false;
-          interval = Math.max(1, Math.floor(state.interval * this.config.newIntervalModifier));
-          nextReviewAt = this.addDays(now, interval);
-        } else {
-          interval = steps[newStep] ?? 10;
-          nextReviewAt = this.addMinutes(now, interval);
-        }
-        break;
-      case "EASY":
-        isRelearning = false;
-        interval = Math.max(1, Math.floor(state.interval * this.config.newIntervalModifier * 1.5));
-        nextReviewAt = this.addDays(now, interval);
-        break;
-    }
-    return {
-      interval: isRelearning ? state.interval : interval,
-      easeFactor: state.easeFactor,
-      repetitions: isRelearning ? state.repetitions : state.repetitions + 1,
-      nextReviewAt,
-      learningStep: newStep,
-      isGraduated: true,
-      isRelearning,
-      lapses: state.lapses
-    };
-  }
-  handleReviewCard(state, rating, now) {
-    let newInterval;
-    let newEaseFactor = state.easeFactor;
-    let repetitions = state.repetitions;
-    let isRelearning = false;
-    let learningStep = 0;
-    let lapses = state.lapses;
-    switch (rating) {
-      case "AGAIN":
-        lapses++;
-        isRelearning = true;
-        learningStep = 0;
-        newEaseFactor = Math.max(this.config.minEaseFactor, newEaseFactor - 0.2);
-        newInterval = state.interval;
-        return {
-          interval: newInterval,
-          easeFactor: newEaseFactor,
-          repetitions,
-          nextReviewAt: this.addMinutes(now, this.config.relearningSteps[0] ?? 10),
-          learningStep,
-          isGraduated: true,
-          isRelearning: true,
-          lapses
-        };
-      case "HARD":
-        newEaseFactor = Math.max(this.config.minEaseFactor, newEaseFactor - 0.15);
-        newInterval = Math.max(state.interval + 1, state.interval * this.config.hardIntervalModifier);
-        break;
-      case "GOOD":
-        newInterval = state.interval * newEaseFactor * this.config.intervalModifier;
-        repetitions++;
-        break;
-      case "EASY":
-        newEaseFactor = newEaseFactor + 0.15;
-        newInterval = state.interval * newEaseFactor * this.config.easyBonus * this.config.intervalModifier;
-        repetitions++;
-        break;
-    }
-    newInterval = Math.min(Math.round(newInterval), this.config.maxInterval);
-    newInterval = Math.max(1, newInterval);
-    return {
-      interval: newInterval,
-      easeFactor: newEaseFactor,
-      repetitions,
-      nextReviewAt: this.addDays(now, newInterval),
-      learningStep,
-      isGraduated: true,
-      isRelearning,
-      lapses
-    };
-  }
-  addMinutes(date, minutes) {
-    return new Date(date.getTime() + minutes * 60 * 1000);
-  }
-  addDays(date, days) {
-    return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
-  }
-}
-var srsEngine = new SRSEngine;
-
-// src/engines/streak.ts
-var DEFAULT_STREAK_CONFIG = {
-  timezone: "UTC",
-  freezesPerMonth: 2,
-  maxFreezes: 5,
-  gracePeriodHours: 4
-};
-
-class StreakEngine {
-  config;
-  constructor(config = {}) {
-    this.config = { ...DEFAULT_STREAK_CONFIG, ...config };
-  }
-  update(state, now = new Date) {
-    const todayDate = this.getDateString(now);
-    const result = {
-      state: { ...state },
-      streakMaintained: false,
-      streakLost: false,
-      freezeUsed: false,
-      newStreak: false,
-      daysMissed: 0
-    };
-    if (!state.lastActivityDate) {
-      result.state.currentStreak = 1;
-      result.state.longestStreak = Math.max(1, state.longestStreak);
-      result.state.lastActivityAt = now;
-      result.state.lastActivityDate = todayDate;
-      result.newStreak = true;
-      result.streakMaintained = true;
-      return result;
-    }
-    if (state.lastActivityDate === todayDate) {
-      result.state.lastActivityAt = now;
-      result.streakMaintained = true;
-      return result;
-    }
-    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
-    if (daysSinceActivity === 1) {
-      result.state.currentStreak = state.currentStreak + 1;
-      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
-      result.state.lastActivityAt = now;
-      result.state.lastActivityDate = todayDate;
-      result.streakMaintained = true;
-      return result;
-    }
-    result.daysMissed = daysSinceActivity - 1;
-    const freezesNeeded = result.daysMissed;
-    if (freezesNeeded <= state.freezesRemaining) {
-      result.state.freezesRemaining = state.freezesRemaining - freezesNeeded;
-      result.state.freezeUsedAt = now;
-      result.state.currentStreak = state.currentStreak + 1;
-      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
-      result.state.lastActivityAt = now;
-      result.state.lastActivityDate = todayDate;
-      result.freezeUsed = true;
-      result.streakMaintained = true;
-      return result;
-    }
-    result.streakLost = true;
-    result.state.currentStreak = 1;
-    result.state.lastActivityAt = now;
-    result.state.lastActivityDate = todayDate;
-    result.newStreak = true;
-    return result;
-  }
-  checkStatus(state, now = new Date) {
-    if (!state.lastActivityDate) {
-      return {
-        isActive: false,
-        willExpireAt: null,
-        canUseFreeze: false,
-        daysUntilExpiry: 0
-      };
-    }
-    const todayDate = this.getDateString(now);
-    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
-    if (daysSinceActivity === 0) {
-      const tomorrow = this.addDays(now, 1);
-      tomorrow.setHours(23, 59, 59, 999);
-      return {
-        isActive: true,
-        willExpireAt: tomorrow,
-        canUseFreeze: state.freezesRemaining > 0,
-        daysUntilExpiry: 1
-      };
-    }
-    if (daysSinceActivity === 1) {
-      const endOfDay = new Date(now);
-      endOfDay.setHours(23 + this.config.gracePeriodHours, 59, 59, 999);
-      return {
-        isActive: true,
-        willExpireAt: endOfDay,
-        canUseFreeze: state.freezesRemaining > 0,
-        daysUntilExpiry: 0
-      };
-    }
-    const missedDays = daysSinceActivity - 1;
-    return {
-      isActive: missedDays <= state.freezesRemaining,
-      willExpireAt: null,
-      canUseFreeze: missedDays <= state.freezesRemaining,
-      daysUntilExpiry: -missedDays
-    };
-  }
-  useFreeze(state, now = new Date) {
-    if (state.freezesRemaining <= 0) {
-      return null;
-    }
-    return {
-      ...state,
-      freezesRemaining: state.freezesRemaining - 1,
-      freezeUsedAt: now
-    };
-  }
-  awardMonthlyFreezes(state) {
-    return {
-      ...state,
-      freezesRemaining: Math.min(state.freezesRemaining + this.config.freezesPerMonth, this.config.maxFreezes)
-    };
-  }
-  getInitialState() {
-    return {
-      currentStreak: 0,
-      longestStreak: 0,
-      lastActivityAt: null,
-      lastActivityDate: null,
-      freezesRemaining: this.config.freezesPerMonth,
-      freezeUsedAt: null
-    };
-  }
-  getMilestones(currentStreak) {
-    const milestones = [3, 7, 14, 30, 60, 90, 180, 365, 500, 1000];
-    const achieved = milestones.filter((m) => currentStreak >= m);
-    const next = milestones.find((m) => currentStreak < m) ?? null;
-    return { achieved, next };
-  }
-  getDateString(date) {
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, "0");
-    const day = String(date.getDate()).padStart(2, "0");
-    return `${year}-${month}-${day}`;
-  }
-  getDaysBetween(dateStr1, dateStr2) {
-    const date1 = new Date(dateStr1);
-    const date2 = new Date(dateStr2);
-    const diffTime = date2.getTime() - date1.getTime();
-    return Math.floor(diffTime / (1000 * 60 * 60 * 24));
-  }
-  addDays(date, days) {
-    return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
-  }
-}
-var streakEngine = new StreakEngine;
-
-// src/i18n/catalogs/en.ts
-import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
-var enMessages = defineTranslation({
-  meta: {
-    key: "learning-journey.messages",
-    version: "1.0.0",
-    domain: "learning-journey",
-    description: "XP source labels for the learning-journey module",
-    owners: ["platform"],
-    stability: "experimental"
-  },
-  locale: "en",
-  fallback: "en",
-  messages: {
-    "xp.source.base": {
-      value: "Base",
-      description: "XP breakdown label for base XP"
-    },
-    "xp.source.scoreBonus": {
-      value: "Score Bonus",
-      description: "XP breakdown label for score-based bonus"
-    },
-    "xp.source.perfectScore": {
-      value: "Perfect Score",
-      description: "XP breakdown label for perfect score bonus"
-    },
-    "xp.source.firstAttempt": {
-      value: "First Attempt",
-      description: "XP breakdown label for first attempt bonus"
-    },
-    "xp.source.retryPenalty": {
-      value: "Retry Penalty",
-      description: "XP breakdown label for retry penalty"
-    },
-    "xp.source.streakBonus": {
-      value: "Streak Bonus",
-      description: "XP breakdown label for streak bonus"
-    }
-  }
-});
-
-// src/i18n/catalogs/es.ts
-import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
-var esMessages = defineTranslation2({
-  meta: {
-    key: "learning-journey.messages",
-    version: "1.0.0",
-    domain: "learning-journey",
-    description: "XP source labels (Spanish)",
-    owners: ["platform"],
-    stability: "experimental"
-  },
-  locale: "es",
-  fallback: "en",
-  messages: {
-    "xp.source.base": {
-      value: "Base",
-      description: "XP breakdown label for base XP"
-    },
-    "xp.source.scoreBonus": {
-      value: "Bonificación por puntuación",
-      description: "XP breakdown label for score-based bonus"
-    },
-    "xp.source.perfectScore": {
-      value: "Puntuación perfecta",
-      description: "XP breakdown label for perfect score bonus"
-    },
-    "xp.source.firstAttempt": {
-      value: "Primer intento",
-      description: "XP breakdown label for first attempt bonus"
-    },
-    "xp.source.retryPenalty": {
-      value: "Penalización por reintento",
-      description: "XP breakdown label for retry penalty"
-    },
-    "xp.source.streakBonus": {
-      value: "Bonificación por racha",
-      description: "XP breakdown label for streak bonus"
-    }
-  }
-});
-
-// src/i18n/catalogs/fr.ts
-import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
-var frMessages = defineTranslation3({
-  meta: {
-    key: "learning-journey.messages",
-    version: "1.0.0",
-    domain: "learning-journey",
-    description: "XP source labels (French)",
-    owners: ["platform"],
-    stability: "experimental"
-  },
-  locale: "fr",
-  fallback: "en",
-  messages: {
-    "xp.source.base": {
-      value: "Base",
-      description: "XP breakdown label for base XP"
-    },
-    "xp.source.scoreBonus": {
-      value: "Bonus de score",
-      description: "XP breakdown label for score-based bonus"
-    },
-    "xp.source.perfectScore": {
-      value: "Score parfait",
-      description: "XP breakdown label for perfect score bonus"
-    },
-    "xp.source.firstAttempt": {
-      value: "Premier essai",
-      description: "XP breakdown label for first attempt bonus"
-    },
-    "xp.source.retryPenalty": {
-      value: "Pénalité de réessai",
-      description: "XP breakdown label for retry penalty"
-    },
-    "xp.source.streakBonus": {
-      value: "Bonus de série",
-      description: "XP breakdown label for streak bonus"
-    }
-  }
-});
-
-// src/i18n/messages.ts
-import {
-  createI18nFactory
-} from "@contractspec/lib.contracts-spec/translations";
-var factory = createI18nFactory({
-  specKey: "learning-journey.messages",
-  catalogs: [enMessages, frMessages, esMessages]
-});
-var createLearningJourneyI18n = factory.create;
-var getDefaultI18n = factory.getDefault;
-var resetI18nRegistry = factory.resetRegistry;
-
-// 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
-};
-
-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 SOURCE_KEY_MAP = {
-  base: "xp.source.base",
-  score_bonus: "xp.source.scoreBonus",
-  perfect_score: "xp.source.perfectScore",
-  first_attempt: "xp.source.firstAttempt",
-  retry_penalty: "xp.source.retryPenalty",
-  streak_bonus: "xp.source.streakBonus"
-};
-function getXpSourceLabel(source, locale) {
-  const i18n = createLearningJourneyI18n(locale);
-  const i18nKey = SOURCE_KEY_MAP[source];
-  return i18nKey ? i18n.t(i18nKey) : source;
-}
-var xpEngine = new XPEngine;
-export {
-  xpEngine,
-  streakEngine,
-  srsEngine,
-  getXpSourceLabel,
-  XPEngine,
-  StreakEngine,
-  SRSEngine,
-  DEFAULT_XP_CONFIG,
-  DEFAULT_STREAK_CONFIG,
-  DEFAULT_SRS_CONFIG
-};
+var N={learningSteps:[1,10],graduatingInterval:1,easyInterval:4,relearningSteps:[10],minEaseFactor:1.3,maxInterval:365,intervalModifier:1,newIntervalModifier:0.5,hardIntervalModifier:1.2,easyBonus:1.3};class K{config;constructor(j={}){this.config={...N,...j}}calculateNextReview(j,Q,W=new Date){if(!j.isGraduated&&!j.isRelearning)return this.handleLearningCard(j,Q,W);if(j.isRelearning)return this.handleRelearningCard(j,Q,W);return this.handleReviewCard(j,Q,W)}getInitialState(){return{interval:0,easeFactor:2.5,repetitions:0,learningStep:0,isGraduated:!1,isRelearning:!1,lapses:0}}isDue(j,Q=new Date){return j<=Q}getOverdueDays(j,Q=new Date){let W=Q.getTime()-j.getTime();return Math.floor(W/86400000)}handleLearningCard(j,Q,W){let H=this.config.learningSteps,V=j.learningStep,Z=!1,$=0,J;switch(Q){case"AGAIN":V=0,$=H[0]??1,J=this.addMinutes(W,$);break;case"HARD":$=H[V]??H[0]??1,J=this.addMinutes(W,$);break;case"GOOD":if(V++,V>=H.length)Z=!0,$=this.config.graduatingInterval,J=this.addDays(W,$);else $=H[V]??10,J=this.addMinutes(W,$);break;case"EASY":Z=!0,$=this.config.easyInterval,J=this.addDays(W,$);break}return{interval:Z?$:0,easeFactor:j.easeFactor,repetitions:Z?1:0,nextReviewAt:J,learningStep:V,isGraduated:Z,isRelearning:!1,lapses:j.lapses}}handleRelearningCard(j,Q,W){let H=this.config.relearningSteps,V=j.learningStep,Z=!0,$=0,J;switch(Q){case"AGAIN":V=0,$=H[0]??10,J=this.addMinutes(W,$);break;case"HARD":$=H[V]??H[0]??10,J=this.addMinutes(W,$);break;case"GOOD":if(V++,V>=H.length)Z=!1,$=Math.max(1,Math.floor(j.interval*this.config.newIntervalModifier)),J=this.addDays(W,$);else $=H[V]??10,J=this.addMinutes(W,$);break;case"EASY":Z=!1,$=Math.max(1,Math.floor(j.interval*this.config.newIntervalModifier*1.5)),J=this.addDays(W,$);break}return{interval:Z?j.interval:$,easeFactor:j.easeFactor,repetitions:Z?j.repetitions:j.repetitions+1,nextReviewAt:J,learningStep:V,isGraduated:!0,isRelearning:Z,lapses:j.lapses}}handleReviewCard(j,Q,W){let H,V=j.easeFactor,Z=j.repetitions,$=!1,J=0,q=j.lapses;switch(Q){case"AGAIN":return q++,$=!0,J=0,V=Math.max(this.config.minEaseFactor,V-0.2),H=j.interval,{interval:H,easeFactor:V,repetitions:Z,nextReviewAt:this.addMinutes(W,this.config.relearningSteps[0]??10),learningStep:J,isGraduated:!0,isRelearning:!0,lapses:q};case"HARD":V=Math.max(this.config.minEaseFactor,V-0.15),H=Math.max(j.interval+1,j.interval*this.config.hardIntervalModifier);break;case"GOOD":H=j.interval*V*this.config.intervalModifier,Z++;break;case"EASY":V=V+0.15,H=j.interval*V*this.config.easyBonus*this.config.intervalModifier,Z++;break}return H=Math.min(Math.round(H),this.config.maxInterval),H=Math.max(1,H),{interval:H,easeFactor:V,repetitions:Z,nextReviewAt:this.addDays(W,H),learningStep:J,isGraduated:!0,isRelearning:$,lapses:q}}addMinutes(j,Q){return new Date(j.getTime()+Q*60*1000)}addDays(j,Q){return new Date(j.getTime()+Q*24*60*60*1000)}}var I=new K;var O={timezone:"UTC",freezesPerMonth:2,maxFreezes:5,gracePeriodHours:4};class h{config;constructor(j={}){this.config={...O,...j}}update(j,Q=new Date){let W=this.getDateString(Q),H={state:{...j},streakMaintained:!1,streakLost:!1,freezeUsed:!1,newStreak:!1,daysMissed:0};if(!j.lastActivityDate)return H.state.currentStreak=1,H.state.longestStreak=Math.max(1,j.longestStreak),H.state.lastActivityAt=Q,H.state.lastActivityDate=W,H.newStreak=!0,H.streakMaintained=!0,H;if(j.lastActivityDate===W)return H.state.lastActivityAt=Q,H.streakMaintained=!0,H;let V=this.getDaysBetween(j.lastActivityDate,W);if(V===1)return H.state.currentStreak=j.currentStreak+1,H.state.longestStreak=Math.max(H.state.currentStreak,j.longestStreak),H.state.lastActivityAt=Q,H.state.lastActivityDate=W,H.streakMaintained=!0,H;H.daysMissed=V-1;let Z=H.daysMissed;if(Z<=j.freezesRemaining)return H.state.freezesRemaining=j.freezesRemaining-Z,H.state.freezeUsedAt=Q,H.state.currentStreak=j.currentStreak+1,H.state.longestStreak=Math.max(H.state.currentStreak,j.longestStreak),H.state.lastActivityAt=Q,H.state.lastActivityDate=W,H.freezeUsed=!0,H.streakMaintained=!0,H;return H.streakLost=!0,H.state.currentStreak=1,H.state.lastActivityAt=Q,H.state.lastActivityDate=W,H.newStreak=!0,H}checkStatus(j,Q=new Date){if(!j.lastActivityDate)return{isActive:!1,willExpireAt:null,canUseFreeze:!1,daysUntilExpiry:0};let W=this.getDateString(Q),H=this.getDaysBetween(j.lastActivityDate,W);if(H===0){let Z=this.addDays(Q,1);return Z.setHours(23,59,59,999),{isActive:!0,willExpireAt:Z,canUseFreeze:j.freezesRemaining>0,daysUntilExpiry:1}}if(H===1){let Z=new Date(Q);return Z.setHours(23+this.config.gracePeriodHours,59,59,999),{isActive:!0,willExpireAt:Z,canUseFreeze:j.freezesRemaining>0,daysUntilExpiry:0}}let V=H-1;return{isActive:V<=j.freezesRemaining,willExpireAt:null,canUseFreeze:V<=j.freezesRemaining,daysUntilExpiry:-V}}useFreeze(j,Q=new Date){if(j.freezesRemaining<=0)return null;return{...j,freezesRemaining:j.freezesRemaining-1,freezeUsedAt:Q}}awardMonthlyFreezes(j){return{...j,freezesRemaining:Math.min(j.freezesRemaining+this.config.freezesPerMonth,this.config.maxFreezes)}}getInitialState(){return{currentStreak:0,longestStreak:0,lastActivityAt:null,lastActivityDate:null,freezesRemaining:this.config.freezesPerMonth,freezeUsedAt:null}}getMilestones(j){let Q=[3,7,14,30,60,90,180,365,500,1000],W=Q.filter((V)=>j>=V),H=Q.find((V)=>j<V)??null;return{achieved:W,next:H}}getDateString(j){let Q=j.getFullYear(),W=String(j.getMonth()+1).padStart(2,"0"),H=String(j.getDate()).padStart(2,"0");return`${Q}-${W}-${H}`}getDaysBetween(j,Q){let W=new Date(j),V=new Date(Q).getTime()-W.getTime();return Math.floor(V/86400000)}addDays(j,Q){return new Date(j.getTime()+Q*24*60*60*1000)}}var x=new h;import{defineTranslation as L}from"@contractspec/lib.contracts-spec/translations";var B=L({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels for the learning-journey module",owners:["platform"],stability:"experimental"},locale:"en",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Score Bonus",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Perfect Score",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"First Attempt",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"Retry Penalty",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Streak Bonus",description:"XP breakdown label for streak bonus"}}});import{defineTranslation as G}from"@contractspec/lib.contracts-spec/translations";var M=G({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels (Spanish)",owners:["platform"],stability:"experimental"},locale:"es",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Bonificación por puntuación",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Puntuación perfecta",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"Primer intento",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"Penalización por reintento",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Bonificación por racha",description:"XP breakdown label for streak bonus"}}});import{defineTranslation as T}from"@contractspec/lib.contracts-spec/translations";var U=T({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels (French)",owners:["platform"],stability:"experimental"},locale:"fr",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Bonus de score",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Score parfait",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"Premier essai",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"Pénalité de réessai",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Bonus de série",description:"XP breakdown label for streak bonus"}}});import{createI18nFactory as m}from"@contractspec/lib.contracts-spec/translations";var z=m({specKey:"learning-journey.messages",catalogs:[B,U,M]}),P=z.create,v=z.getDefault,d=z.resetRegistry;var Y={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};class C{config;constructor(j={}){this.config={...Y,...j,baseValues:{...Y.baseValues,...j.baseValues},scoreThresholds:j.scoreThresholds||Y.scoreThresholds,streakTiers:j.streakTiers||Y.streakTiers}}calculate(j){let Q=[],W=j.baseXp??this.config.baseValues[j.activity],H=W;if(Q.push({source:"base",amount:W}),j.score!==void 0){let V=this.getScoreMultiplier(j.score);if(V!==1){let Z=Math.round(W*(V-1));H+=Z,Q.push({source:"score_bonus",amount:Z,multiplier:V})}if(j.score===100){let Z=Math.round(W*(this.config.perfectScoreMultiplier-1));H+=Z,Q.push({source:"perfect_score",amount:Z,multiplier:this.config.perfectScoreMultiplier})}}if(j.attemptNumber===1&&!j.isRetry)H+=this.config.firstAttemptBonus,Q.push({source:"first_attempt",amount:this.config.firstAttemptBonus});if(j.isRetry){let V=Math.round(H*(1-this.config.retryPenalty));H-=V,Q.push({source:"retry_penalty",amount:-V,multiplier:this.config.retryPenalty})}if(j.currentStreak&&j.currentStreak>0){let V=this.getStreakBonus(j.currentStreak);if(V>0)H+=V,Q.push({source:"streak_bonus",amount:V})}if(W>0)H=Math.max(1,H);return{totalXp:Math.round(H),baseXp:W,breakdown:Q}}calculateStreakBonus(j){let Q=this.getStreakBonus(j);return{totalXp:Q,baseXp:Q,breakdown:[{source:"streak_bonus",amount:Q}]}}getXpForLevel(j){if(j<=1)return 0;return Math.round(100*Math.pow(j-1,1.5))}getLevelFromXp(j){let Q=1,W=this.getXpForLevel(Q+1);while(j>=W&&Q<1000)Q++,W=this.getXpForLevel(Q+1);let H=this.getXpForLevel(Q),V=this.getXpForLevel(Q+1);return{level:Q,xpInLevel:j-H,xpForNextLevel:V-H}}getScoreMultiplier(j){for(let Q of this.config.scoreThresholds)if(j>=Q.min)return Q.multiplier;return 1}getStreakBonus(j){for(let Q of this.config.streakTiers)if(j>=Q.days)return Q.bonus;return 0}}var _={base:"xp.source.base",score_bonus:"xp.source.scoreBonus",perfect_score:"xp.source.perfectScore",first_attempt:"xp.source.firstAttempt",retry_penalty:"xp.source.retryPenalty",streak_bonus:"xp.source.streakBonus"};function u(j,Q){let W=P(Q),H=_[j];return H?W.t(H):j}var w=new C;export{w as xpEngine,x as streakEngine,I as srsEngine,u as getXpSourceLabel,C as XPEngine,h as StreakEngine,K as SRSEngine,Y as DEFAULT_XP_CONFIG,O as DEFAULT_STREAK_CONFIG,N as DEFAULT_SRS_CONFIG};