chore: TSDocs for Translation Module (#14280)

* tsdocs for translation module

* fixes

packages/modules/translation/src/models/locale.ts

@@ -3,8 +3,14 @@ import { model } from "@medusajs/framework/utils"
 const Locale = model
   .define("locale", {
     id: model.id({ prefix: "loc" }).primaryKey(),
-    code: model.text().searchable(), // BCP 47 language tag, e.g., "en-US", "da-DK"
-    name: model.text().searchable(), // Human-readable name, e.g., "English (US)", "Danish"
+    /**
+     * The BCP 47 language tag code of the locale (e.g., "en-US", "da-DK").
+     */
+    code: model.text().searchable(),
+    /**
+     * The human-readable name of the locale (e.g., "English (US)", "Danish").
+     */
+    name: model.text().searchable(),
   })
   .indexes([
     {

packages/modules/translation/src/models/translation.ts

@@ -3,11 +3,37 @@ import { model } from "@medusajs/framework/utils"
 const Translation = model
   .define("translation", {
     id: model.id({ prefix: "trans" }).primaryKey(),
+    /**
+     * The ID of the entity that the translation belongs to. For example, the ID of a product or a product variant.
+     */
     reference_id: model.text().searchable(),
-    reference: model.text().searchable(), // e.g., "product", "product_variant", "product_category"
-    locale_code: model.text().searchable(), // BCP 47 language tag, e.g., "en-US", "da-DK"
+    /**
+     * The name of the table that the translation belongs to. For example, "product" or "product_variant".
+     */
+    reference: model.text().searchable(),
+    /**
+     * The BCP 47 language tag code of the locale
+     * 
+     * @example
+     * "en-US"
+     */
+    locale_code: model.text().searchable(),
+    /**
+     * The translations of the entity.
+     * The object's keys are the field names of the entity, and its value is the translated value.
+     * 
+     * @example
+     * {
+     *   "title": "Product Title",
+     *   "description": "Product Description",
+     * }
+     */
     translations: model.json(),
-    translated_field_count: model.number().default(0), // Precomputed count of translated fields for performance
+    /**
+     * Precomputed count of translated fields of a resource.
+     * Useful for optimization purposes.
+     */
+    translated_field_count: model.number().default(0),
   })
   .indexes([
     {