@contractspec/module.learning-journey 2.3.0 → 2.5.0

package/dist/engines/xp.js

@@ -1,4 +1,139 @@
 // @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/engines/xp.ts
 var DEFAULT_XP_CONFIG = {
   baseValues: {
@@ -164,9 +299,23 @@ 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;
 export {
   xpEngine,
+  getXpSourceLabel,
   XPEngine,
   DEFAULT_XP_CONFIG
 };

package/dist/entities/index.d.ts

@@ -92,6 +92,7 @@ export declare const learningJourneyEntities: (import("@contractspec/lib.schema"
     currentStreak: import("@contractspec/lib.schema").EntityScalarField;
     longestStreak: import("@contractspec/lib.schema").EntityScalarField;
     lastActivityAt: import("@contractspec/lib.schema").EntityScalarField;
+    locale: import("@contractspec/lib.schema").EntityScalarField;
     timezone: import("@contractspec/lib.schema").EntityScalarField;
     dailyGoalXp: import("@contractspec/lib.schema").EntityScalarField;
     reminderEnabled: import("@contractspec/lib.schema").EntityScalarField;

package/dist/entities/index.js

@@ -1192,6 +1192,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"

package/dist/entities/learner.d.ts

@@ -20,6 +20,7 @@ export declare const LearnerEntity: import("@contractspec/lib.schema").EntitySpe
     currentStreak: import("@contractspec/lib.schema").EntityScalarField;
     longestStreak: import("@contractspec/lib.schema").EntityScalarField;
     lastActivityAt: import("@contractspec/lib.schema").EntityScalarField;
+    locale: import("@contractspec/lib.schema").EntityScalarField;
     timezone: import("@contractspec/lib.schema").EntityScalarField;
     dailyGoalXp: import("@contractspec/lib.schema").EntityScalarField;
     reminderEnabled: import("@contractspec/lib.schema").EntityScalarField;
@@ -131,6 +132,7 @@ export declare const learnerEntities: (import("@contractspec/lib.schema").Entity
     currentStreak: import("@contractspec/lib.schema").EntityScalarField;
     longestStreak: import("@contractspec/lib.schema").EntityScalarField;
     lastActivityAt: import("@contractspec/lib.schema").EntityScalarField;
+    locale: import("@contractspec/lib.schema").EntityScalarField;
     timezone: import("@contractspec/lib.schema").EntityScalarField;
     dailyGoalXp: import("@contractspec/lib.schema").EntityScalarField;
     reminderEnabled: import("@contractspec/lib.schema").EntityScalarField;

package/dist/entities/learner.js

@@ -52,6 +52,10 @@ var LearnerEntity = defineEntity({
       isOptional: true,
       description: "Last learning activity"
     }),
+    locale: field.string({
+      isOptional: true,
+      description: 'Preferred locale for learning content (e.g. "en", "fr", "es")'
+    }),
     timezone: field.string({
       default: '"UTC"',
       description: "Learner timezone"

package/dist/i18n/catalogs/en.d.ts

@@ -0,0 +1,6 @@
+/**
+ * English (en) translation catalog for @contractspec/module.learning-journey.
+ *
+ * @module i18n/catalogs/en
+ */
+export declare const enMessages: import("@contractspec/lib.contracts-spec/translations").TranslationSpec;

package/dist/i18n/catalogs/en.js

@@ -0,0 +1,44 @@
+// @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"
+    }
+  }
+});
+export {
+  enMessages
+};

package/dist/i18n/catalogs/es.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Spanish (es) translation catalog for @contractspec/module.learning-journey.
+ *
+ * @module i18n/catalogs/es
+ */
+export declare const esMessages: import("@contractspec/lib.contracts-spec/translations").TranslationSpec;

package/dist/i18n/catalogs/es.js

@@ -0,0 +1,44 @@
+// @bun
+// src/i18n/catalogs/es.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation({
+  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"
+    }
+  }
+});
+export {
+  esMessages
+};

package/dist/i18n/catalogs/fr.d.ts

@@ -0,0 +1,6 @@
+/**
+ * French (fr) translation catalog for @contractspec/module.learning-journey.
+ *
+ * @module i18n/catalogs/fr
+ */
+export declare const frMessages: import("@contractspec/lib.contracts-spec/translations").TranslationSpec;

package/dist/i18n/catalogs/fr.js

@@ -0,0 +1,44 @@
+// @bun
+// src/i18n/catalogs/fr.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation({
+  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"
+    }
+  }
+});
+export {
+  frMessages
+};

package/dist/i18n/catalogs/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Translation catalog barrel exports.
+ *
+ * @module i18n/catalogs
+ */
+export { enMessages } from './en';
+export { frMessages } from './fr';
+export { esMessages } from './es';

package/dist/i18n/catalogs/index.js

@@ -0,0 +1,128 @@
+// @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"
+    }
+  }
+});
+export {
+  frMessages,
+  esMessages,
+  enMessages
+};

package/dist/i18n/i18n.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/i18n/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Internationalization (i18n) module for @contractspec/module.learning-journey.
+ *
+ * @module i18n
+ */
+export { createLearningJourneyI18n, getDefaultI18n, resetI18nRegistry, } from './messages';
+export type { LearningJourneyI18n } from './messages';
+export { resolveLocale, isSupportedLocale, DEFAULT_LOCALE, SUPPORTED_LOCALES, } from './locale';
+export type { SupportedLocale } from './locale';
+export { I18N_KEYS, XP_SOURCE_KEYS } from './keys';
+export type { LearningJourneyMessageKey } from './keys';
+export { enMessages } from './catalogs/en';
+export { frMessages } from './catalogs/fr';
+export { esMessages } from './catalogs/es';