@contractspec/module.learning-journey 2.4.0 → 2.5.0

package/dist/browser/i18n/index.js

@@ -0,0 +1,169 @@
+// 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/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  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/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  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/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/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+
+// src/i18n/keys.ts
+var XP_SOURCE_KEYS = {
+  "xp.source.base": "xp.source.base",
+  "xp.source.scoreBonus": "xp.source.scoreBonus",
+  "xp.source.perfectScore": "xp.source.perfectScore",
+  "xp.source.firstAttempt": "xp.source.firstAttempt",
+  "xp.source.retryPenalty": "xp.source.retryPenalty",
+  "xp.source.streakBonus": "xp.source.streakBonus"
+};
+var I18N_KEYS = {
+  ...XP_SOURCE_KEYS
+};
+export {
+  resolveLocale,
+  resetI18nRegistry,
+  isSupportedLocale,
+  getDefaultI18n,
+  frMessages,
+  esMessages,
+  enMessages,
+  createLearningJourneyI18n,
+  XP_SOURCE_KEYS,
+  SUPPORTED_LOCALES,
+  I18N_KEYS,
+  DEFAULT_LOCALE
+};

package/dist/browser/i18n/keys.js

@@ -0,0 +1,16 @@
+// src/i18n/keys.ts
+var XP_SOURCE_KEYS = {
+  "xp.source.base": "xp.source.base",
+  "xp.source.scoreBonus": "xp.source.scoreBonus",
+  "xp.source.perfectScore": "xp.source.perfectScore",
+  "xp.source.firstAttempt": "xp.source.firstAttempt",
+  "xp.source.retryPenalty": "xp.source.retryPenalty",
+  "xp.source.streakBonus": "xp.source.streakBonus"
+};
+var I18N_KEYS = {
+  ...XP_SOURCE_KEYS
+};
+export {
+  XP_SOURCE_KEYS,
+  I18N_KEYS
+};

package/dist/browser/i18n/locale.js

@@ -0,0 +1,13 @@
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+export {
+  resolveLocale,
+  isSupportedLocale,
+  SUPPORTED_LOCALES,
+  DEFAULT_LOCALE
+};

package/dist/browser/i18n/messages.js

@@ -0,0 +1,139 @@
+// 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/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  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/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  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/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;
+export {
+  resetI18nRegistry,
+  getDefaultI18n,
+  createLearningJourneyI18n
+};

package/dist/browser/index.js

@@ -864,6 +864,141 @@ class SRSEngine {
 }
 var srsEngine = new SRSEngine;
 
+// 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/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  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/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  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/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: {
@@ -1029,6 +1164,19 @@ class XPEngine {
     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;
 
 // src/engines/streak.ts
@@ -2378,6 +2526,10 @@ var LearnerEntity = defineEntity5({
       isOptional: true,
       description: "Last learning activity"
     }),
+    locale: field5.string({
+      isOptional: true,
+      description: 'Preferred locale for learning content (e.g. "en", "fr", "es")'
+    }),
     timezone: field5.string({
       default: '"UTC"',
       description: "Learner timezone"
@@ -3721,6 +3873,7 @@ export {
   learningJourneyEntities,
   learnerEnums,
   learnerEntities,
+  getXpSourceLabel,
   gamificationEnums,
   gamificationEntities,
   flashcardEnums,

package/dist/engines/index.js

@@ -193,6 +193,141 @@ class SRSEngine {
 }
 var srsEngine = new SRSEngine;
 
+// 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/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  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\xE9nalit\xE9 de r\xE9essai",
+      description: "XP breakdown label for retry penalty"
+    },
+    "xp.source.streakBonus": {
+      value: "Bonus de s\xE9rie",
+      description: "XP breakdown label for streak bonus"
+    }
+  }
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  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\xF3n por puntuaci\xF3n",
+      description: "XP breakdown label for score-based bonus"
+    },
+    "xp.source.perfectScore": {
+      value: "Puntuaci\xF3n 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\xF3n por reintento",
+      description: "XP breakdown label for retry penalty"
+    },
+    "xp.source.streakBonus": {
+      value: "Bonificaci\xF3n por racha",
+      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: {
@@ -358,6 +493,19 @@ class XPEngine {
     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;
 
 // src/engines/streak.ts
@@ -518,6 +666,7 @@ export {
   xpEngine,
   streakEngine,
   srsEngine,
+  getXpSourceLabel,
   XPEngine,
   StreakEngine,
   SRSEngine,

package/dist/engines/xp.d.ts

@@ -87,6 +87,13 @@ export declare class XPEngine {
     private getScoreMultiplier;
     private getStreakBonus;
 }
+/**
+ * Get a localized display label for an XP breakdown source.
+ *
+ * @param source - The programmatic source key (e.g. `'base'`, `'streak_bonus'`).
+ * @param locale - Optional locale; defaults to English.
+ */
+export declare function getXpSourceLabel(source: string, locale?: string): string;
 /**
  * Default XP engine instance.
  */