From 752f8f7d5c1e37f6f3261a9be359ac63c57c552d Mon Sep 17 00:00:00 2001
From: akadotsh <devakash256@gmail.com>
Date: Sat, 11 Apr 2026 14:37:16 +0530
Subject: [PATCH 1/3] fix: avoid showing "No README is available" while README
 is loading

---
 app/pages/package/[[org]]/[name].vue | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/app/pages/package/[[org]]/[name].vue b/app/pages/package/[[org]]/[name].vue
index bc10db6210..a5c75765f9 100644
--- a/app/pages/package/[[org]]/[name].vue
+++ b/app/pages/package/[[org]]/[name].vue
@@ -46,7 +46,7 @@ if (import.meta.server) {
 }
 
 // Fetch README for specific version if requested, otherwise latest
-const { data: readmeData } = useLazyFetch<ReadmeResponse>(
+const { data: readmeData, status: readmeStatus } = useLazyFetch<ReadmeResponse>(
   () => {
     const base = `/api/registry/readme/${packageName.value}`
     const version = resolvedVersion.value
@@ -1040,7 +1040,10 @@ const showSkeleton = shallowRef(false)
 
           <!-- eslint-disable vue/no-v-html -- HTML is sanitized server-side -->
           <Readme v-if="readmeData?.html" :html="readmeData.html" />
-          <p v-else class="text-fg-muted italic">
+          <p
+            v-else-if="readmeStatus === 'success' && !readmeData?.html"
+            class="text-fg-muted italic"
+          >
             {{ $t('package.readme.no_readme') }}
             <a
               v-if="repositoryUrl"

From 8bca677f5e10b204c37bff7fa4d2da9b30ecbddd Mon Sep 17 00:00:00 2001
From: akadotsh <devakash256@gmail.com>
Date: Mon, 13 Apr 2026 23:25:47 +0530
Subject: [PATCH 2/3] fix(package-readme): avoid premature empty state and add
 loading/error handling

---
 app/pages/package/[[org]]/[name].vue | 10 ++++++++++
 i18n/locales/ar.json                 |  3 ++-
 i18n/locales/az-AZ.json              |  3 ++-
 i18n/locales/bg-BG.json              |  3 ++-
 i18n/locales/bn-IN.json              |  3 ++-
 i18n/locales/cs-CZ.json              |  3 ++-
 i18n/locales/de.json                 |  3 ++-
 i18n/locales/en.json                 |  3 ++-
 i18n/locales/es-419.json             |  3 ++-
 i18n/locales/es.json                 |  3 ++-
 i18n/locales/fr-FR.json              |  3 ++-
 i18n/locales/hi-IN.json              |  3 ++-
 i18n/locales/hu-HU.json              |  3 ++-
 i18n/locales/id-ID.json              |  3 ++-
 i18n/locales/it-IT.json              |  3 ++-
 i18n/locales/ja-JP.json              |  3 ++-
 i18n/locales/kn-IN.json              |  3 ++-
 i18n/locales/mr-IN.json              |  3 ++-
 i18n/locales/nb-NO.json              |  3 ++-
 i18n/locales/ne-NP.json              |  3 ++-
 i18n/locales/pl-PL.json              |  3 ++-
 i18n/locales/pt-BR.json              |  3 ++-
 i18n/locales/ru-RU.json              |  3 ++-
 i18n/locales/sr-Latn-RS.json         |  3 ++-
 i18n/locales/ta-IN.json              |  3 ++-
 i18n/locales/te-IN.json              |  3 ++-
 i18n/locales/tr-TR.json              |  3 ++-
 i18n/locales/uk-UA.json              |  3 ++-
 i18n/locales/vi-VN.json              |  3 ++-
 i18n/locales/zh-CN.json              |  3 ++-
 i18n/locales/zh-TW.json              |  3 ++-
 31 files changed, 70 insertions(+), 30 deletions(-)

diff --git a/app/pages/package/[[org]]/[name].vue b/app/pages/package/[[org]]/[name].vue
index a5c75765f9..c0a28ed7ea 100644
--- a/app/pages/package/[[org]]/[name].vue
+++ b/app/pages/package/[[org]]/[name].vue
@@ -1040,6 +1040,16 @@ const showSkeleton = shallowRef(false)
 
           <!-- eslint-disable vue/no-v-html -- HTML is sanitized server-side -->
           <Readme v-if="readmeData?.html" :html="readmeData.html" />
+          <p
+            v-else-if="readmeStatus === 'pending'"
+            class="flex items-center gap-2 text-fg-subtle italic"
+          >
+            <span class="i-svg-spinners:ring-resize w-4 h-4" aria-hidden="true" />
+            <span>{{ $t('common.loading') }}…</span>
+          </p>
+          <p v-else-if="readmeStatus === 'error'" class="text-fg-muted italic">
+            {{ $t('package.readme.error_loading') }}
+          </p>
           <p
             v-else-if="readmeStatus === 'success' && !readmeData?.html"
             class="text-fg-muted italic"
diff --git a/i18n/locales/ar.json b/i18n/locales/ar.json
index 131d42deca..82427167e9 100644
--- a/i18n/locales/ar.json
+++ b/i18n/locales/ar.json
@@ -259,7 +259,8 @@
         "warning": "تحذير",
         "caution": "تنبيه"
       },
-      "copy_as_markdown": "نسخ README كـ Markdown"
+      "copy_as_markdown": "نسخ README كـ Markdown",
+      "error_loading": "فشل تحميل تفاصيل ملف README"
     },
     "provenance_section": {
       "title": "إثبات المصدر",
diff --git a/i18n/locales/az-AZ.json b/i18n/locales/az-AZ.json
index 48856ad81b..3575c22475 100644
--- a/i18n/locales/az-AZ.json
+++ b/i18n/locales/az-AZ.json
@@ -324,7 +324,8 @@
         "warning": "Xəbərdarlıq",
         "caution": "Diqqət"
       },
-      "copy_as_markdown": "README-ni Markdown olaraq kopyala"
+      "copy_as_markdown": "README-ni Markdown olaraq kopyala",
+      "error_loading": "README təfərrüatları yüklənə bilmədi"
     },
     "provenance_section": {
       "title": "Mənşə",
diff --git a/i18n/locales/bg-BG.json b/i18n/locales/bg-BG.json
index 41053f59bb..1f2e993b7b 100644
--- a/i18n/locales/bg-BG.json
+++ b/i18n/locales/bg-BG.json
@@ -287,7 +287,8 @@
         "warning": "Предупреждение",
         "caution": "Внимание"
       },
-      "copy_as_markdown": "Копиране на README като Markdown"
+      "copy_as_markdown": "Копиране на README като Markdown",
+      "error_loading": "Неуспешно зареждане на детайлите за README"
     },
     "provenance_section": {
       "title": "Произход",
diff --git a/i18n/locales/bn-IN.json b/i18n/locales/bn-IN.json
index ff7cf7ee7f..20f9e17242 100644
--- a/i18n/locales/bn-IN.json
+++ b/i18n/locales/bn-IN.json
@@ -207,7 +207,8 @@
     "readme": {
       "title": "রিডমি",
       "no_readme": "README উপলব্ধ নেই।",
-      "callout": {}
+      "callout": {},
+      "error_loading": "README বিবরণ লোড করা যায়নি"
     },
     "provenance_section": {},
     "security_downgrade": {},
diff --git a/i18n/locales/cs-CZ.json b/i18n/locales/cs-CZ.json
index 2ca6c6e2fc..dfc3771396 100644
--- a/i18n/locales/cs-CZ.json
+++ b/i18n/locales/cs-CZ.json
@@ -480,7 +480,8 @@
         "warning": "Varování",
         "caution": "Upozornění"
       },
-      "copy_as_markdown": "Zkopírovat ČTI MĚ jako Markdown"
+      "copy_as_markdown": "Zkopírovat ČTI MĚ jako Markdown",
+      "error_loading": "Nepodařilo se načíst podrobnosti README"
     },
     "provenance_section": {
       "title": "Původ",
diff --git a/i18n/locales/de.json b/i18n/locales/de.json
index 42c71738f8..c1d1d86f08 100644
--- a/i18n/locales/de.json
+++ b/i18n/locales/de.json
@@ -363,7 +363,8 @@
         "warning": "Warnung",
         "caution": "Vorsicht"
       },
-      "copy_as_markdown": "README als Markdown kopieren"
+      "copy_as_markdown": "README als Markdown kopieren",
+      "error_loading": "Fehler beim Laden der README-Details"
     },
     "provenance_section": {
       "title": "Herkunftsnachweis",
diff --git a/i18n/locales/en.json b/i18n/locales/en.json
index a142d1ab54..4548a81931 100644
--- a/i18n/locales/en.json
+++ b/i18n/locales/en.json
@@ -480,7 +480,8 @@
         "warning": "Warning",
         "caution": "Caution"
       },
-      "copy_as_markdown": "Copy README as Markdown"
+      "copy_as_markdown": "Copy README as Markdown",
+      "error_loading": "Failed to load README details"
     },
     "provenance_section": {
       "title": "Provenance",
diff --git a/i18n/locales/es-419.json b/i18n/locales/es-419.json
index aff49a7df8..0981a846ce 100644
--- a/i18n/locales/es-419.json
+++ b/i18n/locales/es-419.json
@@ -47,7 +47,8 @@
   },
   "package": {
     "readme": {
-      "title": "Léame"
+      "title": "Léame",
+      "error_loading": "Error al cargar los detalles del README"
     },
     "access": {
       "grant_button": "otorgar",
diff --git a/i18n/locales/es.json b/i18n/locales/es.json
index 7955c16958..5674de80f8 100644
--- a/i18n/locales/es.json
+++ b/i18n/locales/es.json
@@ -364,7 +364,8 @@
         "warning": "Advertencia",
         "caution": "Precaución"
       },
-      "copy_as_markdown": "Copiar README como Markdown"
+      "copy_as_markdown": "Copiar README como Markdown",
+      "error_loading": "Error al cargar los detalles del README"
     },
     "provenance_section": {
       "title": "Procedencia",
diff --git a/i18n/locales/fr-FR.json b/i18n/locales/fr-FR.json
index b37ecd2bc5..d970c96e4c 100644
--- a/i18n/locales/fr-FR.json
+++ b/i18n/locales/fr-FR.json
@@ -478,7 +478,8 @@
         "warning": "Avertissement",
         "caution": "Attention"
       },
-      "copy_as_markdown": "Copier le README en markdown"
+      "copy_as_markdown": "Copier le README en markdown",
+      "error_loading": "Échec du chargement des détails du README"
     },
     "provenance_section": {
       "title": "Provenance",
diff --git a/i18n/locales/hi-IN.json b/i18n/locales/hi-IN.json
index 8091162535..823dd5f957 100644
--- a/i18n/locales/hi-IN.json
+++ b/i18n/locales/hi-IN.json
@@ -349,7 +349,8 @@
         "warning": "चेतावनी",
         "caution": "सावधानी"
       },
-      "copy_as_markdown": "README को Markdown के रूप में कॉपी करें"
+      "copy_as_markdown": "README को Markdown के रूप में कॉपी करें",
+      "error_loading": "README विवरण लोड नहीं हो सके"
     },
     "provenance_section": {
       "title": "प्रोवेनेंस",
diff --git a/i18n/locales/hu-HU.json b/i18n/locales/hu-HU.json
index 0a0b19980c..c7d15dc3e3 100644
--- a/i18n/locales/hu-HU.json
+++ b/i18n/locales/hu-HU.json
@@ -287,7 +287,8 @@
         "warning": "Figyelmeztetés",
         "caution": "Óvatosság"
       },
-      "copy_as_markdown": "README másolása Markdownként"
+      "copy_as_markdown": "README másolása Markdownként",
+      "error_loading": "Nem sikerült betölteni a README részleteit"
     },
     "provenance_section": {
       "title": "Eredet",
diff --git a/i18n/locales/id-ID.json b/i18n/locales/id-ID.json
index cfc0a7c451..e646fb78fa 100644
--- a/i18n/locales/id-ID.json
+++ b/i18n/locales/id-ID.json
@@ -364,7 +364,8 @@
         "warning": "Peringatan",
         "caution": "Perhatian"
       },
-      "copy_as_markdown": "Salin README sebagai Markdown"
+      "copy_as_markdown": "Salin README sebagai Markdown",
+      "error_loading": "Gagal memuat detail README"
     },
     "provenance_section": {
       "title": "Provenans",
diff --git a/i18n/locales/it-IT.json b/i18n/locales/it-IT.json
index 8335afc24d..84bd630351 100644
--- a/i18n/locales/it-IT.json
+++ b/i18n/locales/it-IT.json
@@ -265,7 +265,8 @@
         "warning": "Avvertenza",
         "caution": "Cautela"
       },
-      "copy_as_markdown": "Copia README come Markdown"
+      "copy_as_markdown": "Copia README come Markdown",
+      "error_loading": "Imposible cargar los detalles del README"
     },
     "provenance_section": {
       "title": "Provenienza",
diff --git a/i18n/locales/ja-JP.json b/i18n/locales/ja-JP.json
index 2d21d1fb99..0e6bdb4168 100644
--- a/i18n/locales/ja-JP.json
+++ b/i18n/locales/ja-JP.json
@@ -334,7 +334,8 @@
         "warning": "警告",
         "caution": "注意"
       },
-      "copy_as_markdown": "READMEをMarkdownとしてコピーする"
+      "copy_as_markdown": "READMEをMarkdownとしてコピーする",
+      "error_loading": "READMEの詳細の読み込みに失敗しました"
     },
     "provenance_section": {
       "title": "Provenance",
diff --git a/i18n/locales/kn-IN.json b/i18n/locales/kn-IN.json
index a78955fe25..1347a60972 100644
--- a/i18n/locales/kn-IN.json
+++ b/i18n/locales/kn-IN.json
@@ -208,7 +208,8 @@
     "readme": {
       "title": "ರೀಡ್‌ಮಿ",
       "no_readme": "README ಲಭ್ಯವಿಲ್ಲ.",
-      "callout": {}
+      "callout": {},
+      "error_loading": "README ವಿವರಗಳನ್ನು ಲೋಡ್ ಮಾಡಲು ವಿಫಲವಾಗಿದೆ"
     },
     "provenance_section": {},
     "security_downgrade": {},
diff --git a/i18n/locales/mr-IN.json b/i18n/locales/mr-IN.json
index dd8ee3d746..8688c73c66 100644
--- a/i18n/locales/mr-IN.json
+++ b/i18n/locales/mr-IN.json
@@ -333,7 +333,8 @@
         "warning": "इशारा",
         "caution": "सावधान"
       },
-      "copy_as_markdown": "README Markdown म्हणून कॉपी करा"
+      "copy_as_markdown": "README Markdown म्हणून कॉपी करा",
+      "error_loading": "README तपशील लोड करण्यात अयशस्वी"
     },
     "provenance_section": {
       "title": "प्रोव्हनन्स",
diff --git a/i18n/locales/nb-NO.json b/i18n/locales/nb-NO.json
index 3e90970e59..f0767a5470 100644
--- a/i18n/locales/nb-NO.json
+++ b/i18n/locales/nb-NO.json
@@ -480,7 +480,8 @@
         "warning": "Advarsel",
         "caution": "Forsiktig"
       },
-      "copy_as_markdown": "Kopier README som Markdown"
+      "copy_as_markdown": "Kopier README som Markdown",
+      "error_loading": "Kunne ikke laste inn README-detaljer"
     },
     "provenance_section": {
       "title": "Opprinnelse",
diff --git a/i18n/locales/ne-NP.json b/i18n/locales/ne-NP.json
index 0d16b488c4..832e9e8077 100644
--- a/i18n/locales/ne-NP.json
+++ b/i18n/locales/ne-NP.json
@@ -194,7 +194,8 @@
     "readme": {
       "title": "README",
       "no_readme": "README उपलब्ध छैन।",
-      "callout": {}
+      "callout": {},
+      "error_loading": "README विवरण लोड गर्न असफल"
     },
     "provenance_section": {},
     "security_downgrade": {},
diff --git a/i18n/locales/pl-PL.json b/i18n/locales/pl-PL.json
index c2b59412df..505b1bc5da 100644
--- a/i18n/locales/pl-PL.json
+++ b/i18n/locales/pl-PL.json
@@ -334,7 +334,8 @@
         "warning": "Uwaga",
         "caution": "Ostrożnie"
       },
-      "copy_as_markdown": "Skopiuj README jako Markdown"
+      "copy_as_markdown": "Skopiuj README jako Markdown",
+      "error_loading": "Nie udało się załadować szczegółów README"
     },
     "provenance_section": {
       "title": "Pochodzenie",
diff --git a/i18n/locales/pt-BR.json b/i18n/locales/pt-BR.json
index ff5a248825..6392259ce7 100644
--- a/i18n/locales/pt-BR.json
+++ b/i18n/locales/pt-BR.json
@@ -337,7 +337,8 @@
         "warning": "Aviso",
         "caution": "Cuidado"
       },
-      "copy_as_markdown": "Copiar README como Markdown"
+      "copy_as_markdown": "Copiar README como Markdown",
+      "error_loading": "Falha ao carregar detalhes do README"
     },
     "provenance_section": {
       "title": "Proveniência",
diff --git a/i18n/locales/ru-RU.json b/i18n/locales/ru-RU.json
index 55f96fa0cc..f5033f9f48 100644
--- a/i18n/locales/ru-RU.json
+++ b/i18n/locales/ru-RU.json
@@ -480,7 +480,8 @@
         "warning": "Предупреждение",
         "caution": "Внимание"
       },
-      "copy_as_markdown": "Скопировать README как Markdown"
+      "copy_as_markdown": "Скопировать README как Markdown",
+      "error_loading": "Не удалось загрузить сведения README"
     },
     "provenance_section": {
       "title": "Происхождение",
diff --git a/i18n/locales/sr-Latn-RS.json b/i18n/locales/sr-Latn-RS.json
index ee5f0cb0c3..a0e841cc28 100644
--- a/i18n/locales/sr-Latn-RS.json
+++ b/i18n/locales/sr-Latn-RS.json
@@ -364,7 +364,8 @@
         "warning": "Upozorenje",
         "caution": "Oprez"
       },
-      "copy_as_markdown": "Kopirajte README kao Markdown"
+      "copy_as_markdown": "Kopirajte README kao Markdown",
+      "error_loading": "Neuspešno učitavanje README detalja"
     },
     "provenance_section": {
       "title": "Poreklo",
diff --git a/i18n/locales/ta-IN.json b/i18n/locales/ta-IN.json
index 96a41eb17d..66470c0cb5 100644
--- a/i18n/locales/ta-IN.json
+++ b/i18n/locales/ta-IN.json
@@ -256,7 +256,8 @@
         "warning": "எச்சரிக்கை",
         "caution": "கவனம்"
       },
-      "copy_as_markdown": "README-ஐ Markdown ஆக நகலெடு"
+      "copy_as_markdown": "README-ஐ Markdown ஆக நகலெடு",
+      "error_loading": "README விவரங்களை ஏற்ற முடியவில்லை"
     },
     "provenance_section": {
       "title": "மூலநிலை",
diff --git a/i18n/locales/te-IN.json b/i18n/locales/te-IN.json
index ab580f63b4..644f6022e5 100644
--- a/i18n/locales/te-IN.json
+++ b/i18n/locales/te-IN.json
@@ -208,7 +208,8 @@
     "readme": {
       "title": "రీడ్మీ",
       "no_readme": "README అందుబాటులో లేదు.",
-      "callout": {}
+      "callout": {},
+      "error_loading": "README వివరాలను లోడ్ చేయడం విఫలమైంది"
     },
     "provenance_section": {},
     "security_downgrade": {},
diff --git a/i18n/locales/tr-TR.json b/i18n/locales/tr-TR.json
index 8d686950a3..8cdb79344b 100644
--- a/i18n/locales/tr-TR.json
+++ b/i18n/locales/tr-TR.json
@@ -324,7 +324,8 @@
         "warning": "Uyarı",
         "caution": "Dikkat"
       },
-      "copy_as_markdown": "README'yi Markdown olarak kopyala"
+      "copy_as_markdown": "README'yi Markdown olarak kopyala",
+      "error_loading": "README ayrıntıları yüklenemedi"
     },
     "provenance_section": {
       "title": "Köken",
diff --git a/i18n/locales/uk-UA.json b/i18n/locales/uk-UA.json
index 41417d1893..0b44354a06 100644
--- a/i18n/locales/uk-UA.json
+++ b/i18n/locales/uk-UA.json
@@ -364,7 +364,8 @@
         "warning": "Попередження",
         "caution": "Увага"
       },
-      "copy_as_markdown": "Скопіювати файл README як Markdown"
+      "copy_as_markdown": "Скопіювати файл README як Markdown",
+      "error_loading": "Не вдалося завантажити деталі README"
     },
     "provenance_section": {
       "title": "Походження",
diff --git a/i18n/locales/vi-VN.json b/i18n/locales/vi-VN.json
index 8eb5694da7..f22e472e78 100644
--- a/i18n/locales/vi-VN.json
+++ b/i18n/locales/vi-VN.json
@@ -364,7 +364,8 @@
         "warning": "Cảnh báo",
         "caution": "Thận trọng"
       },
-      "copy_as_markdown": "Sao chép README dạng Markdown"
+      "copy_as_markdown": "Sao chép README dạng Markdown",
+      "error_loading": "Không thể tải chi tiết README"
     },
     "provenance_section": {
       "title": "Provenance",
diff --git a/i18n/locales/zh-CN.json b/i18n/locales/zh-CN.json
index 4d3f405c1a..035c867f37 100644
--- a/i18n/locales/zh-CN.json
+++ b/i18n/locales/zh-CN.json
@@ -478,7 +478,8 @@
         "warning": "警告",
         "caution": "当心"
       },
-      "copy_as_markdown": "复制为 Markdown"
+      "copy_as_markdown": "复制为 Markdown",
+      "error_loading": "加载 README 详情失败"
     },
     "provenance_section": {
       "title": "来源",
diff --git a/i18n/locales/zh-TW.json b/i18n/locales/zh-TW.json
index 5ea5a9109c..4a045959fb 100644
--- a/i18n/locales/zh-TW.json
+++ b/i18n/locales/zh-TW.json
@@ -477,7 +477,8 @@
         "warning": "警告",
         "caution": "小心"
       },
-      "copy_as_markdown": "複製 README 為 Markdown 格式"
+      "copy_as_markdown": "複製 README 為 Markdown 格式",
+      "error_loading": "載入 README 詳情失敗"
     },
     "provenance_section": {
       "title": "來源",

From 8133aa6a9c99bb3cf2c1fe1ecfe4ea709c0e086e Mon Sep 17 00:00:00 2001
From: akadotsh <devakash256@gmail.com>
Date: Mon, 13 Apr 2026 23:29:14 +0530
Subject: [PATCH 3/3] chore(i18n): update schema for readme error_loading key

---
 i18n/schema.json | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/i18n/schema.json b/i18n/schema.json
index b3ccd57f64..949fc687c9 100644
--- a/i18n/schema.json
+++ b/i18n/schema.json
@@ -1446,6 +1446,9 @@
             },
             "copy_as_markdown": {
               "type": "string"
+            },
+            "error_loading": {
+              "type": "string"
             }
           },
           "additionalProperties": false