refactor(types): rename i18n field to translations

Update core type system to use 'translations' instead of 'i18n' for
better semantic clarity and consistency with schema definitions.

- Rename ManifestI18n to ManifestTranslations
- Update all type interfaces to use translations field
- Update manifest-i18n utility functions and documentation
- Update search functionality to reference translations

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ericyangpan

src/lib/manifest-i18n.ts

@@ -1,12 +1,12 @@
 import { defaultLocale, type Locale } from '@/i18n/config'
 
 /**
- * Interface for manifest items with i18n support
+ * Interface for manifest items with translations support
  */
-export interface ManifestItemWithI18n {
+export interface ManifestItemWithTranslations {
   description?: string
   name?: string
-  i18n?: {
+  translations?: {
     [locale: string]: {
       description?: string
       name?: string
@@ -18,12 +18,12 @@ export interface ManifestItemWithI18n {
 
 /**
  * Get localized field from a manifest item
- * @param item - The manifest item with potential i18n translations
+ * @param item - The manifest item with potential translations
  * @param field - The field name to translate (e.g., 'description', 'name')
  * @param locale - The target locale (e.g., 'en', 'zh-Hans')
  * @returns The localized value or the original value if translation not found
  */
-export function getLocalizedField<T extends ManifestItemWithI18n>(
+export function getLocalizedField<T extends ManifestItemWithTranslations>(
   item: T,
   field: keyof T,
   locale: Locale
@@ -33,8 +33,8 @@ export function getLocalizedField<T extends ManifestItemWithI18n>(
     return item[field] as string
   }
 
-  // Check if i18n translations exist for this locale
-  const translation = item.i18n?.[locale]
+  // Check if translations exist for this locale
+  const translation = item.translations?.[locale]
   if (translation && field in translation && translation[field as string]) {
     return translation[field as string] as string
   }
@@ -45,7 +45,7 @@ export function getLocalizedField<T extends ManifestItemWithI18n>(
 
 /**
  * Apply localization to a manifest item
- * @param item - The manifest item with potential i18n translations
+ * @param item - The manifest item with potential translations
  * @param locale - The target locale (e.g., 'en', 'zh-Hans')
  * @param fields - Array of field names to localize (default: ['description'])
  * @returns A new object with localized fields
@@ -63,14 +63,14 @@ export function localizeManifestItem<T extends Record<string, unknown>>(
   // Create a new object with localized fields
   const localizedItem = { ...item }
 
-  // Check if item has i18n translations
-  const i18nData = item.i18n as Record<string, Record<string, string>> | undefined
-  if (!i18nData || !i18nData[locale]) {
+  // Check if item has translations
+  const translationsData = item.translations as Record<string, Record<string, string>> | undefined
+  if (!translationsData || !translationsData[locale]) {
     return item
   }
 
   // Apply translations for requested fields
-  const translations = i18nData[locale]
+  const translations = translationsData[locale]
   for (const field of fields) {
     const fieldStr = String(field)
     if (fieldStr in translations && translations[fieldStr]) {
@@ -83,7 +83,7 @@ export function localizeManifestItem<T extends Record<string, unknown>>(
 
 /**
  * Apply localization to an array of manifest items
- * @param items - Array of manifest items with potential i18n translations
+ * @param items - Array of manifest items with potential translations
  * @param locale - The target locale (e.g., 'en', 'zh-Hans')
  * @param fields - Array of field names to localize (default: ['description'])
  * @returns A new array with localized items

src/lib/search.ts

@@ -40,23 +40,23 @@ export interface SearchResult {
  * Get localized name from manifest with fallback to default name
  */
 function getLocalizedName(
-  item: { name: string; i18n?: { [locale: string]: { name?: string } } },
+  item: { name: string; translations?: { [locale: string]: { name?: string } } },
   locale?: string
 ): string {
-  if (locale && item.i18n?.[locale]?.name) {
-    return item.i18n[locale].name
+  if (locale && item.translations?.[locale]?.name) {
+    return item.translations[locale].name
   }
   return item.name
 }
 
 /**
- * Check if query matches item name (supports i18n)
+ * Check if query matches item name (supports translations)
  */
 function matchesQuery(
   item: {
     name: string
     description: string
-    i18n?: { [locale: string]: { name?: string; description?: string } }
+    translations?: { [locale: string]: { name?: string; description?: string } }
   },
   query: string
 ): boolean {
@@ -65,9 +65,9 @@ function matchesQuery(
   // Search in default name only
   if (item.name.toLowerCase().includes(lowerQuery)) return true
 
-  // Search in i18n translations (name only)
-  if (item.i18n) {
-    for (const translation of Object.values(item.i18n)) {
+  // Search in translations (name only)
+  if (item.translations) {
+    for (const translation of Object.values(item.translations)) {
       if (translation.name?.toLowerCase().includes(lowerQuery)) return true
     }
   }

src/types/manifests.ts

@@ -21,9 +21,10 @@ export interface ManifestEntity {
   id: string
   name: string
   description: string
-  i18n?: ManifestI18n
-  websiteUrl?: string
-  docsUrl?: string
+  translations: ManifestTranslations
+  verified: boolean
+  websiteUrl: string
+  docsUrl?: string | null
 }
 
 /**
@@ -33,6 +34,7 @@ export interface ManifestEntity {
  */
 export interface ManifestVendorEntity extends ManifestEntity {
   vendor: string
+  docsUrl: string | null // Override: required in vendor-entity schema
 }
 
 /**
@@ -48,7 +50,7 @@ export interface ManifestApp extends ManifestEntity {
  * Internationalization translations
  * Based on: /manifests/$schemas/ref/translations.schema.json
  */
-export interface ManifestI18n {
+export interface ManifestTranslations {
   [locale: string]: {
     name?: string
     title?: string
@@ -198,7 +200,7 @@ export interface ManifestBaseProduct extends ManifestVendorEntity {
   latestVersion: string
   githubUrl: string | null
   license: string // SPDX License Identifier or 'Proprietary'
-  pricing?: ManifestPricingTier[]
+  pricing: ManifestPricingTier[]
   resourceUrls: ManifestResourceUrls
   communityUrls: ManifestCommunityUrls
   relatedProducts: ManifestRelatedProduct[]
@@ -220,14 +222,10 @@ export interface ManifestIDE extends ManifestVendorEntity {
   communityUrls: ManifestCommunityUrls
   relatedProducts: ManifestRelatedProduct[]
   platforms: ManifestPlatformElement[]
-  websiteUrl?: string
-  docsUrl?: string
-  i18n?: ManifestI18n
   // Legacy fields that may exist in data
   cli?: string | null
   install?: string | null
   launch?: string | null
-  verified?: boolean
 }
 
 /**
@@ -244,14 +242,10 @@ export interface ManifestCLI extends ManifestVendorEntity {
   communityUrls: ManifestCommunityUrls
   relatedProducts: ManifestRelatedProduct[]
   platforms: ManifestPlatformElement[]
-  websiteUrl?: string
-  docsUrl?: string
-  i18n?: ManifestI18n
   // Legacy fields that may exist in data
   ide?: string | null
   install?: string | null
   launch?: string | null
-  verified?: boolean
 }
 
 /**
@@ -264,8 +258,6 @@ export interface ManifestExtension extends ManifestApp {
   type: 'cli' | 'ide'
   extends: string // Type of extension
   latestVersion: string
-  websiteUrl?: string
-  docsUrl?: string
   license: string
   pricing: ManifestPricingTier[]
   resourceUrls: ManifestResourceUrls
@@ -298,8 +290,8 @@ export interface ManifestModel {
   vendor: string
   id: string
   description: string
-  i18n?: ManifestI18n
-  websiteUrl?: string | null
+  translations: ManifestTranslations
+  websiteUrl: string | null
   docsUrl?: string | null
   verified?: boolean
   size: string | null
@@ -325,7 +317,7 @@ export interface ManifestModel {
  * Extends: ManifestVendorEntity
  */
 export interface ManifestProvider extends ManifestVendorEntity {
-  verified?: boolean
+  // verified is inherited from ManifestVendorEntity -> ManifestEntity (required boolean)
   type?: string
   applyKeyUrl?: string
   platformUrls?: {
@@ -362,7 +354,7 @@ export interface ManifestCollection {
   title: string
   description: string
   extractedDate: string
-  i18n?: {
+  translations?: {
     [locale: string]: {
       title?: string
       description?: string