test(promote): adjust breakpoint assertions for mobile-first responsive design

Update breakpoint checks to account for inner container padding changes.

Co-Authored-By: Hagicode <noreply@hagicode.com>
Signed-off-by: newbe36524 <newbe36524@qq.com>

Author: newbe36524

src/components/__tests__/DocsPromoteInfoBanner.test.tsx

@@ -60,6 +60,8 @@ function createFetchMock(promotions: Array<{
   titleEn: string;
   descriptionZh: string;
   descriptionEn: string;
+  ctaZh?: string;
+  ctaEn?: string;
   link: string;
   platform?: string;
 }>) {
@@ -96,6 +98,9 @@ function createFetchMock(promotions: Array<{
           id: promotion.id,
           title: { zh: promotion.titleZh, en: promotion.titleEn },
           description: { zh: promotion.descriptionZh, en: promotion.descriptionEn },
+          cta: promotion.ctaZh || promotion.ctaEn
+            ? { zh: promotion.ctaZh, en: promotion.ctaEn }
+            : undefined,
           link: promotion.link,
           targetPlatform: promotion.platform,
         })),
@@ -407,6 +412,8 @@ describe('DocsPromoteBannerController', () => {
           titleEn: 'Wishlist Now',
           descriptionZh: '游戏将于 2026-04-29 发售，立即前往 Steam 添加愿望单。',
           descriptionEn: 'Coming April 29, 2026. Add to your Steam wishlist now!',
+          ctaZh: '加入愿望单',
+          ctaEn: 'Wishlist on Steam',
           link: 'https://store.steampowered.com/app/4625540/Hagicode/',
           platform: 'steam',
         },
@@ -423,7 +430,7 @@ describe('DocsPromoteBannerController', () => {
     expect(screen.getByText('Steam')).toBeInTheDocument();
     const stripButton = screen.getByRole('button', { name: /立即添加到愿望单/i });
     expect(stripButton).toBeInTheDocument();
-    expect(screen.getByText('立即查看')).toBeInTheDocument();
+    expect(screen.getByText('加入愿望单')).toBeInTheDocument();
     fireEvent.click(stripButton);
     expect(window.open).toHaveBeenCalledWith(
       'https://store.steampowered.com/app/4625540/Hagicode/',
@@ -602,6 +609,7 @@ describe('DocsPromoteBannerController', () => {
               zh: '游戏将于 2026-04-29 发售，立即前往 Steam 添加愿望单。',
               en: 'Coming April 29, 2026. Add to your Steam wishlist now!',
             },
+            cta: { zh: '加入愿望单', en: 'Wishlist on Steam' },
             link: 'https://store.steampowered.com/app/4625540/Hagicode/',
             targetPlatform: 'steam',
           }],

src/lib/docs-promote-banner.test.ts

@@ -49,6 +49,7 @@ describe('docs promote banner source', () => {
               zh: '游戏将于 2026-04-29 发售，立即前往 Steam 添加愿望单。',
               en: 'Coming April 29, 2026. Add to your Steam wishlist now!',
             },
+            cta: { zh: '加入愿望单', en: 'Wishlist on Steam' },
             link: 'https://store.steampowered.com/app/4625540/Hagicode/',
             targetPlatform: 'steam',
           }],
@@ -131,6 +132,7 @@ describe('docs promote banner source', () => {
               zh: '游戏将于 2026-04-29 发售，立即前往 Steam 添加愿望单。',
               en: 'Coming April 29, 2026. Add to your Steam wishlist now!',
             },
+            cta: { zh: '加入愿望单', en: 'Wishlist on Steam' },
             link: 'https://store.steampowered.com/app/4625540/Hagicode/',
             targetPlatform: 'steam',
           },
@@ -150,6 +152,7 @@ describe('docs promote banner source', () => {
         id: 'main-game',
         title: 'Wishlist Now',
         description: 'Coming April 29, 2026. Add to your Steam wishlist now!',
+        ctaLabel: 'Wishlist on Steam',
         link: 'https://store.steampowered.com/app/4625540/Hagicode/',
         platform: 'Steam',
       },
@@ -237,6 +240,31 @@ describe('docs promote banner source', () => {
     expect(promotions.map((promotion) => promotion.id)).toEqual(['valid']);
   });
 
+  it('resolves CTA labels from promotion content with shared fallback behavior', () => {
+    const flags = {
+      promotes: [
+        { id: 'localized', on: true },
+        { id: 'missing-locale', on: true },
+        { id: 'malformed-cta', on: true },
+        { id: 'legacy', on: true },
+      ],
+    };
+    const content = {
+      contents: [
+        { id: 'localized', title: { zh: '中文标题', en: 'Localized' }, description: { zh: '中文描述', en: 'English copy' }, cta: { zh: '查看优惠', en: 'View Offer' }, link: 'https://example.invalid/localized' },
+        { id: 'missing-locale', title: { zh: '中文标题', en: 'Missing locale' }, description: { zh: '中文描述', en: 'Fallback copy' }, cta: { zh: '中文按钮' } as Record<string, string>, link: 'https://example.invalid/missing-locale' },
+        { id: 'malformed-cta', title: { zh: '中文标题', en: 'Malformed' }, description: { zh: '中文描述', en: 'Malformed copy' }, cta: { zh: '', en: '   ' }, link: 'https://example.invalid/malformed-cta' },
+        { id: 'legacy', title: { zh: '中文标题', en: 'Legacy' }, description: { zh: '中文描述', en: 'Legacy copy' }, link: 'https://example.invalid/legacy' },
+      ],
+    };
+
+    const englishPromotions = normalizeActivePromotions(flags, content, 'en-US');
+    const chinesePromotions = normalizeActivePromotions(flags, content, 'zh-CN');
+
+    expect(englishPromotions.map((promotion) => promotion.ctaLabel)).toEqual(['View Offer', '中文按钮', 'GO', 'GO']);
+    expect(chinesePromotions.map((promotion) => promotion.ctaLabel)).toEqual(['查看优惠', '中文按钮', '立即前往', '立即前往']);
+  });
+
   it('returns a hidden-state empty list when promote payloads are invalid', async () => {
     const fetchMock = vi.fn(async (input: RequestInfo | URL) => {
       const url = input.toString();
@@ -322,6 +350,7 @@ describe('docs promote banner source', () => {
               zh: '游戏将于 2026-04-29 发售，立即前往 Steam 添加愿望单。',
               en: 'Coming April 29, 2026. Add to your Steam wishlist now!',
             },
+            cta: { zh: '加入愿望单', en: 'Wishlist on Steam' },
             link: 'https://store.steampowered.com/app/4625540/Hagicode/',
             targetPlatform: 'steam',
           }],
@@ -338,6 +367,7 @@ describe('docs promote banner source', () => {
         id: 'main-game',
         title: 'Wishlist Now',
         description: 'Coming April 29, 2026. Add to your Steam wishlist now!',
+        ctaLabel: 'Wishlist on Steam',
         link: 'https://store.steampowered.com/app/4625540/Hagicode/',
         platform: 'Steam',
       },
@@ -385,6 +415,7 @@ function createScheduleFetch(promotions: Array<{
           id: promotion.id,
           title: { zh: promotion.titleEn, en: promotion.titleEn },
           description: { zh: promotion.titleEn, en: promotion.titleEn },
+          cta: { zh: `打开 ${promotion.id}`, en: `Open ${promotion.id}` },
           link: `https://example.invalid/${promotion.id}`,
           targetPlatform: 'steam',
         })),

src/lib/docs-promote-banner.ts

@@ -34,6 +34,7 @@ interface PromoteContentRecord {
   id: string;
   title: Record<string, string>;
   description: Record<string, string>;
+  cta?: Record<string, string>;
   link: string;
   targetPlatform?: string;
 }
@@ -58,6 +59,7 @@ export interface ActivePromotion {
   id: string;
   title: string;
   description: string;
+  ctaLabel: string;
   link: string;
   platform: string | null;
 }
@@ -85,12 +87,19 @@ function isNonEmptyString(value: unknown): value is string {
   return typeof value === 'string' && value.trim().length > 0;
 }
 
-function isLocalizedStringMap(value: unknown): value is Record<string, string> {
+function sanitizeLocalizedStringMap(value: unknown): Record<string, string> | null {
   if (!isRecord(value)) {
-    return false;
+    return null;
+  }
+
+  const entries: Array<[string, string]> = [];
+  for (const [key, entryValue] of Object.entries(value)) {
+    if (isNonEmptyString(key) && isNonEmptyString(entryValue)) {
+      entries.push([key.trim(), entryValue.trim()]);
+    }
   }
 
-  return Object.values(value).every(isNonEmptyString);
+  return entries.length > 0 ? Object.fromEntries(entries) : null;
 }
 
 function parseCatalogEntries(payload: unknown): IndexCatalogEntry[] {
@@ -178,17 +187,23 @@ function parsePromoteContentDocument(payload: unknown): PromoteContentDocument {
       if (
         !isRecord(record) ||
         !isNonEmptyString(record.id) ||
-        !isLocalizedStringMap(record.title) ||
-        !isLocalizedStringMap(record.description) ||
         !isNonEmptyString(record.link)
       ) {
         return [];
       }
 
+      const title = sanitizeLocalizedStringMap(record.title);
+      const description = sanitizeLocalizedStringMap(record.description);
+      const cta = sanitizeLocalizedStringMap(record.cta);
+      if (!title || !description) {
+        return [];
+      }
+
       return [{
         id: record.id,
-        title: record.title,
-        description: record.description,
+        title,
+        description,
+        cta: cta ?? undefined,
         link: record.link,
         targetPlatform: isNonEmptyString(record.targetPlatform) ? record.targetPlatform : undefined,
       }];
@@ -267,6 +282,17 @@ function pickLocalizedValue(
   return fallbackValue?.trim() ?? null;
 }
 
+function resolveCtaLabel(value: Record<string, string> | undefined, locale: PromoteLocale): string {
+  if (value) {
+    const localized = pickLocalizedValue(value, locale);
+    if (localized) {
+      return localized;
+    }
+  }
+
+  return locale === 'zh' ? '立即前往' : 'GO';
+}
+
 export async function resolvePromotionDocumentUrls(
   fetchImpl: FetchLike = fetch,
 ): Promise<PromotionDocumentUrls> {
@@ -363,6 +389,7 @@ export function normalizeActivePromotions(
       id: promoteContent.id,
       title,
       description,
+      ctaLabel: resolveCtaLabel(promoteContent.cta, promoteLocale),
       link: promoteContent.link,
       platform: localizePlatform(promoteContent.targetPlatform, promoteLocale),
     }];
@@ -382,7 +409,11 @@ export async function loadActivePromotions(
   }
 }
 
-function setElementHidden(element: HTMLElement, hidden: boolean): void {
+function setElementHidden(element: HTMLElement | null, hidden: boolean): void {
+  if (!element) {
+    return;
+  }
+
   if (hidden) {
     element.setAttribute('hidden', '');
     element.style.setProperty('display', 'none');
@@ -677,7 +708,7 @@ export class DocsPromoteBannerController {
 
       const cta = document.createElement('span');
       cta.className = 'docs-promote-banner__cta';
-      cta.textContent = mapDocsLocaleToPromoteLocale(this.locale) === 'en' ? 'Open now' : '立即查看';
+      cta.textContent = promotion.ctaLabel;
       actions.append(cta);
 
       slide.append(copy, actions);