@contractspec/module.learning-journey 2.3.0 → 2.5.0

package/dist/i18n/index.js

@@ -0,0 +1,170 @@
+// @bun
+// 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/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/i18n/keys.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Typed message keys for the learning-journey i18n system.
+ *
+ * Keys cover XP breakdown source labels shown in UIs.
+ *
+ * @module i18n/keys
+ */
+export declare const XP_SOURCE_KEYS: {
+    readonly 'xp.source.base': "xp.source.base";
+    readonly 'xp.source.scoreBonus': "xp.source.scoreBonus";
+    readonly 'xp.source.perfectScore': "xp.source.perfectScore";
+    readonly 'xp.source.firstAttempt': "xp.source.firstAttempt";
+    readonly 'xp.source.retryPenalty': "xp.source.retryPenalty";
+    readonly 'xp.source.streakBonus': "xp.source.streakBonus";
+};
+export declare const I18N_KEYS: {
+    readonly 'xp.source.base': "xp.source.base";
+    readonly 'xp.source.scoreBonus': "xp.source.scoreBonus";
+    readonly 'xp.source.perfectScore': "xp.source.perfectScore";
+    readonly 'xp.source.firstAttempt': "xp.source.firstAttempt";
+    readonly 'xp.source.retryPenalty': "xp.source.retryPenalty";
+    readonly 'xp.source.streakBonus': "xp.source.streakBonus";
+};
+/** Union type of all valid learning-journey i18n keys */
+export type LearningJourneyMessageKey = keyof typeof I18N_KEYS;

package/dist/i18n/keys.js

@@ -0,0 +1,17 @@
+// @bun
+// 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/i18n/locale.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Locale utilities for the learning-journey package.
+ *
+ * Re-exported from the shared i18n factory in contracts-spec.
+ *
+ * @module i18n/locale
+ */
+export { DEFAULT_LOCALE, SUPPORTED_LOCALES, resolveLocale, isSupportedLocale, type SupportedLocale, } from '@contractspec/lib.contracts-spec/translations';

package/dist/i18n/locale.js

@@ -0,0 +1,14 @@
+// @bun
+// 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/i18n/messages.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Translation helper for the learning-journey package.
+ * @module i18n/messages
+ */
+import { type I18nInstance } from '@contractspec/lib.contracts-spec/translations';
+import type { LearningJourneyMessageKey } from './keys';
+/** I18n instance type for the learning-journey package. */
+export type LearningJourneyI18n = I18nInstance<LearningJourneyMessageKey>;
+/** Create an i18n instance for a given locale. */
+export declare const createLearningJourneyI18n: (optionsLocale?: string, runtimeLocale?: string) => I18nInstance<"xp.source.base" | "xp.source.scoreBonus" | "xp.source.perfectScore" | "xp.source.firstAttempt" | "xp.source.retryPenalty" | "xp.source.streakBonus">;
+/** Create a default (English) i18n instance. */
+export declare const getDefaultI18n: () => I18nInstance<"xp.source.base" | "xp.source.scoreBonus" | "xp.source.perfectScore" | "xp.source.firstAttempt" | "xp.source.retryPenalty" | "xp.source.streakBonus">;
+/** Reset the shared registry (useful for testing). @internal */
+export declare const resetI18nRegistry: () => void;

package/dist/i18n/messages.js

@@ -0,0 +1,140 @@
+// @bun
+// 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;
+export {
+  resetI18nRegistry,
+  getDefaultI18n,
+  createLearningJourneyI18n
+};

package/dist/index.js

@@ -865,6 +865,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: {
@@ -1030,6 +1165,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
@@ -2379,6 +2527,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"
@@ -3722,6 +3874,7 @@ export {
   learningJourneyEntities,
   learnerEnums,
   learnerEntities,
+  getXpSourceLabel,
   gamificationEnums,
   gamificationEntities,
   flashcardEnums,