diff --git a/apps/web/locales/cs.json b/apps/web/locales/cs.json index 6ad69152..d434ca64 100644 --- a/apps/web/locales/cs.json +++ b/apps/web/locales/cs.json @@ -352,7 +352,44 @@ "trayRemoveAria": "Odebrat {name}", "quickToggleShortAdd": "Porovnat", "quickToggleShortSelected": "Přidáno", - "quickToggleShortLimit": "Max. 4" + "quickToggleShortLimit": "Max. 4", + "preset_default": "Vyvážený výchozí", + "preset_gaming": "Hraní her a výdrž", + "preset_camera": "Fotoaparát a vlog", + "preset_endurance": "Výdrž a odolnost", + "preset_value": "Nejlepší cena / výkon", + "preset_media": "Filmy a zábava", + "preset_study_work": "Studium a poznámky", + "preset_office": "Kancelář a mobilita", + "preset_creator": "Programování a grafika", + "preset_fitness": "Sport a zdraví", + "preset_smart_daily": "Chytré funkce a nošení", + "preset_audiophile": "Audiofilský poslech", + "preset_commute_anc": "Cestování a ANC", + "preset_calls_work": "Schůzky a hovory", + "weightCrit_performance": "Výkon", + "weightCrit_camera": "Fotoaparát", + "weightCrit_battery": "Baterie a nabíjení", + "weightCrit_display": "Displej", + "weightCrit_design": "Design a zpracování", + "weightCrit_value": "Poměr cena / výkon", + "weightCrit_sound": "Kvalita zvuku", + "weightCrit_software": "Software a příslušenství", + "weightCrit_keyboard": "Klávesnice a touchpad", + "weightCrit_thermals": "Chlazení a hlučnost", + "weightCrit_health": "Sledování zdraví", + "weightCrit_apps": "Aplikace a konektivita", + "weightCrit_anc": "Potlačení hluku", + "weightCrit_comfort": "Pohodlí při nošení", + "weightCrit_calls": "Mikrofon a hovory", + "resetWeightsBtn": "Obnovit výchozí", + "normalizedWeightsPrefix": "Normalizované váhy (100 %):", + "officialRateScoreLabel": "Oficiální skóre Rate.vn", + "yourCustomScoreLabel": "Vaše vlastní skóre", + "officialScoreKeepNote": "Oficiální skóre Rate.vn zůstává beze změny vedle vašeho vlastního skóre.", + "customWinnerSummary": "Podle {preset}: vede {winner} ({score}/5, náskok +{delta})", + "customWinnerSingle": "Podle {preset}: vede {winner} ({score}/5)", + "customWinnerTie": "Podle {preset}: vedoucí modely mají shodné skóre ({score}/5)" }, "leaderboard": { "criteriaSourceExpert": "Hodnocení kritérií od recenzentů nebo expertů", @@ -450,7 +487,42 @@ "categoryTabsAria": "Vyberte kategorii", "shortCamera": "Foto", "shortAnc": "ANC", - "expertScoreShort": "Expert {score}/10" + "expertScoreShort": "Expert {score}/10", + "preset_default": "Vyvážený výchozí", + "preset_gaming": "Hraní her a výdrž", + "preset_camera": "Fotoaparát a vlog", + "preset_endurance": "Výdrž a odolnost", + "preset_value": "Nejlepší cena / výkon", + "preset_media": "Filmy a zábava", + "preset_study_work": "Studium a poznámky", + "preset_office": "Kancelář a mobilita", + "preset_creator": "Programování a grafika", + "preset_fitness": "Sport a zdraví", + "preset_smart_daily": "Chytré funkce a nošení", + "preset_audiophile": "Audiofilský poslech", + "preset_commute_anc": "Cestování a ANC", + "preset_calls_work": "Schůzky a hovory", + "weightCrit_performance": "Výkon", + "weightCrit_camera": "Fotoaparát", + "weightCrit_battery": "Baterie a nabíjení", + "weightCrit_display": "Displej", + "weightCrit_design": "Design a zpracování", + "weightCrit_value": "Poměr cena / výkon", + "weightCrit_sound": "Kvalita zvuku", + "weightCrit_software": "Software a příslušenství", + "weightCrit_keyboard": "Klávesnice a touchpad", + "weightCrit_thermals": "Chlazení a hlučnost", + "weightCrit_health": "Sledování zdraví", + "weightCrit_apps": "Aplikace a konektivita", + "weightCrit_anc": "Potlačení hluku", + "weightCrit_comfort": "Pohodlí při nošení", + "weightCrit_calls": "Mikrofon a hovory", + "customWeightsBtn": "Vlastní váhy", + "resetWeightsBtn": "Obnovit výchozí", + "normalizedWeightsPrefix": "Normalizované váhy (100 %):", + "officialRateScoreLabel": "Oficiální skóre Rate.vn", + "yourCustomScoreLabel": "Vaše vlastní skóre", + "officialScoreKeepNote": "Oficiální skóre Rate.vn zůstává na každém řádku beze změny." }, "reviews": { "reviewsShowMore": "Zobrazit {count, plural, one {# další recenzi} few {# další recenze} other {# dalších recenzí}}", diff --git a/apps/web/locales/en.json b/apps/web/locales/en.json index de00af66..14ed287d 100644 --- a/apps/web/locales/en.json +++ b/apps/web/locales/en.json @@ -352,7 +352,44 @@ "trayRemoveAria": "Remove {name}", "quickToggleShortAdd": "Compare", "quickToggleShortSelected": "Added", - "quickToggleShortLimit": "Max 4" + "quickToggleShortLimit": "Max 4", + "preset_default": "Balanced default", + "preset_gaming": "Gaming & battery", + "preset_camera": "Camera & creator", + "preset_endurance": "Endurance & durability", + "preset_value": "Value-first", + "preset_media": "Media & entertainment", + "preset_study_work": "Study & productivity", + "preset_office": "Office & portability", + "preset_creator": "Coding & creator", + "preset_fitness": "Fitness & health", + "preset_smart_daily": "Smart apps & daily wear", + "preset_audiophile": "Audiophile sound", + "preset_commute_anc": "ANC & commute", + "preset_calls_work": "Meetings & calls", + "weightCrit_performance": "Performance", + "weightCrit_camera": "Camera", + "weightCrit_battery": "Battery and charging", + "weightCrit_display": "Display", + "weightCrit_design": "Design and build", + "weightCrit_value": "Value for money", + "weightCrit_sound": "Sound quality", + "weightCrit_software": "Software and accessories", + "weightCrit_keyboard": "Keyboard and touchpad", + "weightCrit_thermals": "Thermals and noise", + "weightCrit_health": "Health tracking", + "weightCrit_apps": "Apps and connectivity", + "weightCrit_anc": "Noise cancelling", + "weightCrit_comfort": "Comfort", + "weightCrit_calls": "Microphone and calls", + "resetWeightsBtn": "Reset to default", + "normalizedWeightsPrefix": "Normalized weights (100%):", + "officialRateScoreLabel": "Rate.vn score", + "yourCustomScoreLabel": "Your custom score", + "officialScoreKeepNote": "The official Rate.vn score stays unchanged beside your custom score.", + "customWinnerSummary": "Under {preset}: {winner} leads ({score}/5, +{delta} ahead)", + "customWinnerSingle": "Under {preset}: {winner} leads ({score}/5)", + "customWinnerTie": "Under {preset}: leading models are tied ({score}/5)" }, "leaderboard": { "criteriaSourceExpert": "Criterion scores from reviewers or experts", @@ -450,7 +487,42 @@ "categoryTabsAria": "Choose a category", "shortCamera": "Camera", "shortAnc": "ANC", - "expertScoreShort": "Expert {score}/10" + "expertScoreShort": "Expert {score}/10", + "preset_default": "Balanced default", + "preset_gaming": "Gaming & battery", + "preset_camera": "Camera & creator", + "preset_endurance": "Endurance & durability", + "preset_value": "Value-first", + "preset_media": "Media & entertainment", + "preset_study_work": "Study & productivity", + "preset_office": "Office & portability", + "preset_creator": "Coding & creator", + "preset_fitness": "Fitness & health", + "preset_smart_daily": "Smart apps & daily wear", + "preset_audiophile": "Audiophile sound", + "preset_commute_anc": "ANC & commute", + "preset_calls_work": "Meetings & calls", + "weightCrit_performance": "Performance", + "weightCrit_camera": "Camera", + "weightCrit_battery": "Battery and charging", + "weightCrit_display": "Display", + "weightCrit_design": "Design and build", + "weightCrit_value": "Value for money", + "weightCrit_sound": "Sound quality", + "weightCrit_software": "Software and accessories", + "weightCrit_keyboard": "Keyboard and touchpad", + "weightCrit_thermals": "Thermals and noise", + "weightCrit_health": "Health tracking", + "weightCrit_apps": "Apps and connectivity", + "weightCrit_anc": "Noise cancelling", + "weightCrit_comfort": "Comfort", + "weightCrit_calls": "Microphone and calls", + "customWeightsBtn": "Custom weights", + "resetWeightsBtn": "Reset to default", + "normalizedWeightsPrefix": "Normalized weights (100%):", + "officialRateScoreLabel": "Rate.vn score", + "yourCustomScoreLabel": "Your custom score", + "officialScoreKeepNote": "The official Rate.vn score stays unchanged on every product row." }, "reviews": { "reviewsShowMore": "Show {count, plural, one {# more review} other {# more reviews}}", diff --git a/apps/web/locales/vi.json b/apps/web/locales/vi.json index e16f32ef..7f2a73e9 100644 --- a/apps/web/locales/vi.json +++ b/apps/web/locales/vi.json @@ -352,7 +352,44 @@ "trayRemoveAria": "Xóa {name}", "quickToggleShortAdd": "So sánh", "quickToggleShortSelected": "Đã chọn", - "quickToggleShortLimit": "Tối đa 4" + "quickToggleShortLimit": "Tối đa 4", + "preset_default": "Cân bằng mặc định", + "preset_gaming": "Cày game & pin trâu", + "preset_camera": "Nhiếp ảnh & quay vlog", + "preset_endurance": "Bền bỉ & thực dụng", + "preset_value": "Đáng tiền nhất (P/P)", + "preset_media": "Xem phim & giải trí", + "preset_study_work": "Học tập & ghi chú", + "preset_office": "Văn phòng & di động", + "preset_creator": "Lập trình & đồ họa nặng", + "preset_fitness": "Thể thao & sức khỏe", + "preset_smart_daily": "Đeo hằng ngày & tiện ích", + "preset_audiophile": "Nghe nhạc chuyên sâu", + "preset_commute_anc": "Đi làm & chống ồn ANC", + "preset_calls_work": "Họp online & đàm thoại", + "weightCrit_performance": "Hiệu năng", + "weightCrit_camera": "Camera", + "weightCrit_battery": "Pin và sạc", + "weightCrit_display": "Màn hình", + "weightCrit_design": "Thiết kế và độ bền", + "weightCrit_value": "Đáng tiền", + "weightCrit_sound": "Chất âm", + "weightCrit_software": "Phần mềm và phụ kiện", + "weightCrit_keyboard": "Bàn phím và touchpad", + "weightCrit_thermals": "Tản nhiệt và độ ồn", + "weightCrit_health": "Theo dõi sức khỏe", + "weightCrit_apps": "Ứng dụng và kết nối", + "weightCrit_anc": "Chống ồn", + "weightCrit_comfort": "Đeo thoải mái", + "weightCrit_calls": "Mic và gọi", + "resetWeightsBtn": "Đặt lại mặc định", + "normalizedWeightsPrefix": "Trọng số chuẩn hóa (100%):", + "officialRateScoreLabel": "Điểm chuẩn Rate.vn", + "yourCustomScoreLabel": "Điểm theo trọng số bạn chọn", + "officialScoreKeepNote": "Điểm chuẩn Rate.vn luôn giữ nguyên bên cạnh điểm theo trọng số bạn chọn.", + "customWinnerSummary": "Theo {preset}: {winner} dẫn đầu ({score}/5, hơn +{delta})", + "customWinnerSingle": "Theo {preset}: {winner} dẫn đầu ({score}/5)", + "customWinnerTie": "Theo {preset}: các mẫu dẫn đầu ngang điểm ({score}/5)" }, "leaderboard": { "criteriaSourceExpert": "Điểm tiêu chí từ người review hoặc chuyên gia", @@ -450,7 +487,42 @@ "categoryTabsAria": "Chọn ngành hàng", "shortCamera": "Camera", "shortAnc": "Chống ồn", - "expertScoreShort": "Chuyên gia {score}/10" + "expertScoreShort": "Chuyên gia {score}/10", + "preset_default": "Cân bằng mặc định", + "preset_gaming": "Cày game & pin trâu", + "preset_camera": "Nhiếp ảnh & quay vlog", + "preset_endurance": "Bền bỉ & thực dụng", + "preset_value": "Đáng tiền nhất (P/P)", + "preset_media": "Xem phim & giải trí", + "preset_study_work": "Học tập & ghi chú", + "preset_office": "Văn phòng & di động", + "preset_creator": "Lập trình & đồ họa nặng", + "preset_fitness": "Thể thao & sức khỏe", + "preset_smart_daily": "Đeo hằng ngày & tiện ích", + "preset_audiophile": "Nghe nhạc chuyên sâu", + "preset_commute_anc": "Đi làm & chống ồn ANC", + "preset_calls_work": "Họp online & đàm thoại", + "weightCrit_performance": "Hiệu năng", + "weightCrit_camera": "Camera", + "weightCrit_battery": "Pin và sạc", + "weightCrit_display": "Màn hình", + "weightCrit_design": "Thiết kế và độ bền", + "weightCrit_value": "Đáng tiền", + "weightCrit_sound": "Chất âm", + "weightCrit_software": "Phần mềm và phụ kiện", + "weightCrit_keyboard": "Bàn phím và touchpad", + "weightCrit_thermals": "Tản nhiệt và độ ồn", + "weightCrit_health": "Theo dõi sức khỏe", + "weightCrit_apps": "Ứng dụng và kết nối", + "weightCrit_anc": "Chống ồn", + "weightCrit_comfort": "Đeo thoải mái", + "weightCrit_calls": "Mic và gọi", + "customWeightsBtn": "Tùy chỉnh trọng số", + "resetWeightsBtn": "Đặt lại mặc định", + "normalizedWeightsPrefix": "Trọng số chuẩn hóa (100%):", + "officialRateScoreLabel": "Điểm chuẩn Rate.vn", + "yourCustomScoreLabel": "Điểm theo trọng số bạn chọn", + "officialScoreKeepNote": "Điểm chuẩn Rate.vn luôn giữ nguyên ở từng dòng sản phẩm." }, "reviews": { "reviewsShowMore": "Xem thêm {count} đánh giá", diff --git a/apps/web/src/components/compare/CompareWorkspace.tsx b/apps/web/src/components/compare/CompareWorkspace.tsx index 92b9cf08..36995470 100644 --- a/apps/web/src/components/compare/CompareWorkspace.tsx +++ b/apps/web/src/components/compare/CompareWorkspace.tsx @@ -1,12 +1,14 @@ 'use client'; import React, { + Suspense, useCallback, useEffect, useMemo, useRef, useState, } from 'react'; +import { useSearchParams } from 'next/navigation'; import { useTranslations } from 'next-intl'; import type { IconType } from 'react-icons'; import { @@ -35,8 +37,28 @@ import { getCategorySpecTemplate, specFieldApplies, type CategorySpecTemplate, + type RatingCriterionKey, type SpecGroupKey, + type UseCasePresetId, } from '@repo/shared-data/rules'; +import { + availableCategoryUseCasePresets, + computeCustomWeightedScore5, + defaultCategoryWeights, + extractCategoryCriteriaScores, + isDefaultCategoryWeights, + mergeUseCaseQueryIntoSearch, + normalizeCategoryWeights, + parseUseCaseWeightsFromParams, + resolveCategoryPreset, + resolveLocalizedPresetName, + sanitizeSliderWeight, + scoredCategoryCriteriaForProducts, + type ActiveWeightMode, + type CategoryCriterionWeights, + type CustomWeightedScoreResult, +} from '@/lib/use-case-weights'; +import UseCaseWeightBar from './UseCaseWeightBar'; import { type CanonicalCategorySlug, MAX_VALID_VND_PRICE, @@ -110,6 +132,7 @@ import { displayedScore5, formatRatingValue, formatScoreFixed, + roundScore, } from '@/lib/rating-display'; interface CompareWorkspaceProps { @@ -125,6 +148,9 @@ interface CompareWorkspaceProps { * first and the second summary is left out (DOS/Rate#1473). */ layout?: 'compare' | 'versus'; + initialWeightMode?: ActiveWeightMode; + initialCategoryWeights?: CategoryCriterionWeights; + initialShowWeightSliders?: boolean; } type CompareTranslator = ReturnType>; @@ -1847,6 +1873,31 @@ export function filterSpecGroupsForCategory( .filter((group) => group.rows.length > 0); } +function CompareUrlWeightsSync({ + categorySlug, + onSync, +}: { + readonly categorySlug: string; + readonly onSync: ( + cat: string, + rawPreset: string | null, + rawWeights: string | null + ) => void; +}) { + const searchParams = useSearchParams(); + const rawPreset = searchParams.get('preset'); + const rawWeights = searchParams.get('weights'); + const categorySlugRef = useRef(categorySlug); + useEffect(() => { + categorySlugRef.current = categorySlug; + }, [categorySlug]); + useEffect( + () => onSync(categorySlugRef.current, rawPreset, rawWeights), + [rawPreset, rawWeights, onSync] + ); + return null; +} + export default function CompareWorkspace({ initialProducts, catalogCandidates, @@ -1855,6 +1906,9 @@ export default function CompareWorkspace({ locale = 'vi', itemSlugBySlug, layout = 'compare', + initialWeightMode = 'default', + initialCategoryWeights, + initialShowWeightSliders = false, }: CompareWorkspaceProps) { const t = useTranslations('compare'); const router = useRouter(); @@ -1894,6 +1948,29 @@ export default function CompareWorkspace({ const [showDiffOnly, setShowDiffOnly] = useState(false); const [highlightWinners, setHighlightWinners] = useState(true); const [copiedLink, setCopiedLink] = useState(false); + const [weightMode, setWeightMode] = + useState(initialWeightMode); + const [categoryWeights, setCategoryWeights] = + useState(() => { + const cat = + initialProducts.length > 0 + ? getMasterProductCategorySlug(initialProducts[0]!) + : initialCategory; + if (initialCategoryWeights) { + return normalizeCategoryWeights(cat, initialCategoryWeights) + .sliderWeights; + } + if (initialWeightMode !== 'default' && initialWeightMode !== 'custom') { + return normalizeCategoryWeights( + cat, + resolveCategoryPreset(cat, initialWeightMode).weights + ).sliderWeights; + } + return defaultCategoryWeights(cat); + }); + const [showWeightSliders, setShowWeightSliders] = useState( + initialShowWeightSliders + ); const radarIndex = useDealRadarIndex(); // Every row, verdict and export reads the category's view of a product, // like the product page (DOS/Rate#1166). @@ -1902,6 +1979,168 @@ export default function CompareWorkspace({ storedProducts.map((p) => applyCategorySpecTemplate(activeCategory, p)), [storedProducts, activeCategory] ); + const scoredCompareCriteria = useMemo( + () => + scoredCategoryCriteriaForProducts( + activeCategory, + products.map((p) => ({ product: p })) + ), + [activeCategory, products] + ); + const availableComparePresets = useMemo( + () => + availableCategoryUseCasePresets(activeCategory, scoredCompareCriteria), + [activeCategory, scoredCompareCriteria] + ); + const canWeighCompare = + layout === 'compare' && + products.length >= 2 && + availableComparePresets.length > 0; + + const replaceCompareWeightQuery = useCallback( + ( + cat: CanonicalCategorySlug, + nextMode: ActiveWeightMode, + nextWeights: CategoryCriterionWeights, + available: readonly RatingCriterionKey[] + ) => { + if (typeof window === 'undefined' || layout !== 'compare') return; + const merged = + available.length > 0 + ? mergeUseCaseQueryIntoSearch( + window.location.search, + cat, + nextMode, + nextWeights, + available + ) + : mergeUseCaseQueryIntoSearch( + window.location.search, + cat, + 'default', + defaultCategoryWeights(cat), + [] + ); + window.history.replaceState( + null, + '', + `${window.location.pathname}${merged}` + ); + }, + [layout] + ); + + const handleCompareUrlWeightsSync = useCallback( + (cat: string, rawPreset: string | null, rawWeights: string | null) => { + const parsed = parseUseCaseWeightsFromParams(cat, { + preset: rawPreset ?? undefined, + weights: rawWeights ?? undefined, + }); + setWeightMode(parsed.mode); + setCategoryWeights(parsed.weights); + }, + [] + ); + + useEffect(() => { + if (layout !== 'compare') return; + if (!canWeighCompare) { + if (weightMode !== 'default' || showWeightSliders) { + const defaults = defaultCategoryWeights(activeCategory); + setWeightMode('default'); + setShowWeightSliders(false); + setCategoryWeights(defaults); + replaceCompareWeightQuery(activeCategory, 'default', defaults, []); + } + return; + } + if ( + weightMode !== 'default' && + (isDefaultCategoryWeights( + activeCategory, + weightMode, + categoryWeights, + scoredCompareCriteria + ) || + (weightMode !== 'custom' && + !availableComparePresets.some((p) => p.id === weightMode))) + ) { + const defaults = defaultCategoryWeights(activeCategory); + setWeightMode('default'); + setCategoryWeights(defaults); + replaceCompareWeightQuery( + activeCategory, + 'default', + defaults, + scoredCompareCriteria + ); + } + }, [ + layout, + canWeighCompare, + weightMode, + categoryWeights, + showWeightSliders, + activeCategory, + availableComparePresets, + scoredCompareCriteria, + replaceCompareWeightQuery, + ]); + + const handleSelectComparePreset = (presetId: UseCasePresetId) => { + const preset = resolveCategoryPreset(activeCategory, presetId); + const norm = normalizeCategoryWeights( + activeCategory, + preset.weights, + scoredCompareCriteria + ); + setWeightMode(preset.id); + setCategoryWeights(norm.sliderWeights); + replaceCompareWeightQuery( + activeCategory, + preset.id, + norm.sliderWeights, + scoredCompareCriteria + ); + }; + + const handleUpdateCompareWeight = (key: RatingCriterionKey, val: number) => { + const candidate: CategoryCriterionWeights = { + ...categoryWeights, + [key]: sanitizeSliderWeight(val, categoryWeights[key] ?? 0), + }; + const normalized = normalizeCategoryWeights( + activeCategory, + candidate, + scoredCompareCriteria + ); + const collapsesToDefault = + normalized.wasAllZeroReset || + isDefaultCategoryWeights( + activeCategory, + 'custom', + normalized.sliderWeights, + scoredCompareCriteria + ); + const nextMode: ActiveWeightMode = collapsesToDefault + ? 'default' + : 'custom'; + const nextWeights = collapsesToDefault + ? defaultCategoryWeights(activeCategory) + : normalized.sliderWeights; + setWeightMode(nextMode); + setCategoryWeights(nextWeights); + replaceCompareWeightQuery( + activeCategory, + nextMode, + nextWeights, + scoredCompareCriteria + ); + }; + + const handleResetCompareWeights = () => { + handleSelectComparePreset('default'); + }; // RATE_ITEM_MODEL on (the page passed a map): products the client added, // restored from the tray, or surfaced in Popular 1v1 Battles are read as // Items too, so 1v1 and product links name Canonical Items without a 308 @@ -2204,7 +2443,26 @@ export default function CompareWorkspace({ if (restored) { setActiveCategory(restored.activeCategory); setProducts(restored.products); - router.replace(`/compare?slugs=${restored.slugsCsv}`, { + let restoredQuery = `?slugs=${restored.slugsCsv}`; + if ( + typeof window !== 'undefined' && + layout === 'compare' && + restored.products.length >= 2 + ) { + const parsedRestored = parseUseCaseWeightsFromParams( + restored.activeCategory, + window.location.search + ); + setWeightMode(parsedRestored.mode); + setCategoryWeights(parsedRestored.weights); + restoredQuery = mergeUseCaseQueryIntoSearch( + restoredQuery, + restored.activeCategory, + parsedRestored.mode, + parsedRestored.weights + ); + } + router.replace(`/compare${restoredQuery}`, { scroll: false, }); return; @@ -2214,7 +2472,7 @@ export default function CompareWorkspace({ // Otherwise only show the page's defaults or a shared ?slugs= list: the // tray changes on the visitor's own edits (syncSelection), never on load, // so it does not follow them site-wide or lose what they saved (#714). - }, [hasExplicitSlugs, catalogCandidates, itemSlugBySlug, router]); + }, [hasExplicitSlugs, catalogCandidates, itemSlugBySlug, layout, router]); // Sync URL and localStorage tray whenever compared products change (always locked to 1 category) const syncSelection = ( @@ -2244,10 +2502,24 @@ export default function CompareWorkspace({ })) ); const slugsCsv = sameCategoryProducts.map((p) => p.slug).join(','); - const nextUrl = slugsCsv - ? `/compare?slugs=${slugsCsv}` - : `/compare?category=${targetCat}`; - router.replace(nextUrl, { scroll: false }); + const baseQuery = slugsCsv + ? `?slugs=${slugsCsv}` + : `?category=${targetCat}`; + let finalQuery = baseQuery; + if (targetCat !== activeCategory || sameCategoryProducts.length < 2) { + const nextDefaults = defaultCategoryWeights(targetCat); + setWeightMode('default'); + setCategoryWeights(nextDefaults); + setShowWeightSliders(false); + } else if (layout === 'compare') { + finalQuery = mergeUseCaseQueryIntoSearch( + baseQuery, + targetCat, + weightMode, + categoryWeights + ); + } + router.replace(`/compare${finalQuery}`, { scroll: false }); }; const handleSwitchCategoryTab = (nextCat: CanonicalCategorySlug) => { @@ -2716,6 +2988,83 @@ export default function CompareWorkspace({ activeReplaceIndex, }); + const hasActiveCompareWeights = + canWeighCompare && + !isDefaultCategoryWeights( + activeCategory, + weightMode, + categoryWeights, + scoredCompareCriteria + ); + + const customCompareScoresById = useMemo(() => { + const map = new Map(); + if (!hasActiveCompareWeights) return map; + for (const p of products) { + const critScores = extractCategoryCriteriaScores(p, activeCategory); + const res = computeCustomWeightedScore5( + activeCategory, + critScores, + categoryWeights, + { + onlyCriteria: scoredCompareCriteria, + officialScore5: getEffectiveRating(p), + product: p, + } + ); + map.set(p.id, res); + } + return map; + }, [ + hasActiveCompareWeights, + products, + activeCategory, + categoryWeights, + scoredCompareCriteria, + ]); + + const customCompareWinner = useMemo(() => { + if (!hasActiveCompareWeights) return null; + const scoredItems = products + .map((p) => ({ + product: p, + score5: customCompareScoresById.get(p.id)?.customScore5 ?? null, + })) + .filter( + (entry): entry is { product: MasterProduct; score5: number } => + entry.score5 !== null + ) + .sort((a, b) => b.score5 - a.score5); + if (scoredItems.length === 0) return null; + const top = scoredItems[0]!; + const runnerUp = scoredItems[1] ?? null; + const delta5 = runnerUp + ? roundScore(Math.max(0, top.score5 - runnerUp.score5), 2) + : null; + const isTie = runnerUp !== null && top.score5 === runnerUp.score5; + const winnerIds = new Set( + scoredItems + .filter((entry) => entry.score5 === top.score5) + .map((entry) => entry.product.id) + ); + return { + leadProduct: top.product, + leadScore5: top.score5, + delta5, + isTie, + scoredCount: scoredItems.length, + winnerIds, + }; + }, [hasActiveCompareWeights, products, customCompareScoresById]); + + const activeComparePresetTitle = resolveLocalizedPresetName( + activeCategory, + weightMode, + locale, + undefined, + t('customWeightsActive') + ); + const controlsBlock = ( <> {/* 5-Category Lock Switcher Bar */} @@ -3160,6 +3509,88 @@ export default function CompareWorkspace({ )} + + {/* RTINGS-style Use-Case Presets & Custom Weight Sliders (#1864) */} + {canWeighCompare && ( +
+ setShowWeightSliders((v) => !v)} + onSelectPreset={handleSelectComparePreset} + onUpdateWeight={handleUpdateCompareWeight} + onReset={handleResetCompareWeights} + locale={locale} + testIdPrefix="compare-weights" + copy={{ + groupLabel: t('useCaseLabel'), + customizeBtn: t('customWeightsBtn'), + customActiveBadge: t('customWeightsActive'), + resetBtn: t('resetWeightsBtn'), + normalizedSummaryPrefix: t('normalizedWeightsPrefix'), + officialKeepNote: t('officialScoreKeepNote'), + }} + /> + +
+ {hasActiveCompareWeights && customCompareWinner && ( +
+
+ + {t('yourCustomScoreLabel')} + + + {customCompareWinner.isTie + ? t('customWinnerTie', { + preset: activeComparePresetTitle, + score: formatRatingValue( + customCompareWinner.leadScore5, + locale, + 2 + ), + }) + : customCompareWinner.delta5 !== null && + customCompareWinner.scoredCount >= 2 + ? t('customWinnerSummary', { + preset: activeComparePresetTitle, + winner: customCompareWinner.leadProduct.name, + score: formatRatingValue( + customCompareWinner.leadScore5, + locale, + 2 + ), + delta: formatRatingValue( + customCompareWinner.delta5, + locale, + 2 + ), + }) + : t('customWinnerSingle', { + preset: activeComparePresetTitle, + winner: customCompareWinner.leadProduct.name, + score: formatRatingValue( + customCompareWinner.leadScore5, + locale, + 2 + ), + })} + +
+
+ )} +
+
+ )} ); @@ -3628,7 +4059,12 @@ export default function CompareWorkspace({ {/* Core Rating Badges First (Per DESIGN.md v3.0) */} -
+
+ {hasActiveCompareWeights && ( + + {t('officialRateScoreLabel')} + + )} + {hasActiveCompareWeights && + (() => { + const customEntry = customCompareScoresById.get( + p.id + ); + const customVal = + customEntry?.customScore5 ?? null; + const isCustomWinner = + highlightWinners && + customVal !== null && + customCompareWinner !== null && + !customCompareWinner.isTie && + customCompareWinner.scoredCount >= 2 && + customCompareWinner.winnerIds.has(p.id); + return ( +
+ {customVal !== null + ? `${t('yourCustomScoreLabel')}: ★ ${formatRatingValue(customVal, locale, 2)}/5` + : `${t('yourCustomScoreLabel')}: ${t('criterionNoData')}`} + {isCustomWinner && ( + + {t('bestBadge')} + + )} +
+ ); + })()} + {/* Neutral Reference Price */}
{t('referencePriceLabel')}{' '} @@ -3739,6 +4213,54 @@ export default function CompareWorkspace({ + {hasActiveCompareWeights && ( + + +
{t('yourCustomScoreLabel')}
+
+ {activeComparePresetTitle} +
+ + {products.map((p) => { + const customVal = + customCompareScoresById.get(p.id)?.customScore5 ?? null; + const isCustomWinner = + highlightWinners && + customVal !== null && + customCompareWinner !== null && + !customCompareWinner.isTie && + customCompareWinner.scoredCount >= 2 && + customCompareWinner.winnerIds.has(p.id); + return ( + + {customVal !== null + ? `★ ${formatRatingValue(customVal, locale, 2)} / 5` + : t('criterionNoData')} + {isCustomWinner && ( + + {t('bestBadge')} + + )} + + ); + })} + {products.length < MAX_COMPARE_ITEMS && ( + - + )} + + )} {t('radarRowMatrixTitle')} @@ -3919,6 +4441,12 @@ export default function CompareWorkspace({ return (
+ + + {controlsBlock} {popularBlock} {summaryBlock} diff --git a/apps/web/src/components/compare/UseCaseWeightBar.tsx b/apps/web/src/components/compare/UseCaseWeightBar.tsx new file mode 100644 index 00000000..c77d85a6 --- /dev/null +++ b/apps/web/src/components/compare/UseCaseWeightBar.tsx @@ -0,0 +1,302 @@ +'use client'; + +import React, { useId } from 'react'; +import { BsArrowCounterclockwise, BsSliders } from 'react-icons/bs'; +import { + getRatingCriteria, + getRatingCriterionLabel, + getRatingUseCasePresetLabel, + type RatingCriterionKey, + type UseCasePresetId, +} from '@repo/shared-data/rules'; +import { formatPercent } from '@/lib/locale-format'; +import { + availableCategoryUseCasePresets, + formatNormalizedWeightSummary, + isDefaultCategoryWeights, + normalizeCategoryWeights, + type ActiveWeightMode, + type CategoryCriterionWeights, +} from '@/lib/use-case-weights'; + +export interface UseCaseWeightBarCopy { + readonly groupLabel: string; + readonly customizeBtn: string; + readonly customActiveBadge: string; + readonly resetBtn: string; + readonly normalizedSummaryPrefix: string; + readonly officialKeepNote: string; + readonly presetLabels?: Readonly>>; + readonly criterionLabels?: Readonly< + Partial> + >; +} + +export interface UseCaseWeightBarProps { + readonly categorySlug: string; + readonly availableCriteria: readonly RatingCriterionKey[]; + readonly mode: ActiveWeightMode; + readonly weights: CategoryCriterionWeights; + readonly showSliders: boolean; + readonly onToggleSliders: () => void; + readonly onSelectPreset: (presetId: UseCasePresetId) => void; + readonly onUpdateWeight: (key: RatingCriterionKey, value: number) => void; + readonly onReset: () => void; + readonly copy: UseCaseWeightBarCopy; + readonly locale?: string; + readonly variant?: 'light' | 'dark'; + readonly groupLabelId?: string; + readonly slidersPanelId?: string; + readonly trailingActions?: React.ReactNode; + readonly testIdPrefix?: string; +} + +export default function UseCaseWeightBar({ + categorySlug, + availableCriteria, + mode, + weights, + showSliders, + onToggleSliders, + onSelectPreset, + onUpdateWeight, + onReset, + copy, + locale = 'vi', + variant = 'light', + groupLabelId: groupLabelIdProp, + slidersPanelId: slidersPanelIdProp, + trailingActions, + testIdPrefix = 'use-case-weights', +}: UseCaseWeightBarProps) { + const reactId = useId(); + const groupLabelId = groupLabelIdProp || `${reactId}-group-label`; + const slidersPanelId = slidersPanelIdProp || `${reactId}-sliders-panel`; + const isDark = variant === 'dark'; + + const presets = availableCategoryUseCasePresets( + categorySlug, + availableCriteria + ); + const criteria = getRatingCriteria(categorySlug); + const availableSet = new Set(availableCriteria); + const sliderCriteria = criteria.filter((c) => availableSet.has(c.key)); + if (presets.length === 0 || sliderCriteria.length === 0) { + return trailingActions ? ( +
+ {trailingActions} +
+ ) : null; + } + + const normalized = normalizeCategoryWeights( + categorySlug, + weights, + availableCriteria + ); + const isDefault = isDefaultCategoryWeights( + categorySlug, + mode, + weights, + availableCriteria + ); + const weightSummary = formatNormalizedWeightSummary( + categorySlug, + normalized.normalizedPercent, + locale, + copy.criterionLabels, + availableCriteria + ); + + const resolvePresetLabel = ( + presetId: UseCasePresetId, + fallbackObj: { label: { vi: string; en: string; cs: string } } + ) => { + const customText = + copy.presetLabels && + Object.prototype.hasOwnProperty.call(copy.presetLabels, presetId) + ? copy.presetLabels[presetId] + : undefined; + return customText && customText.trim() + ? customText + : getRatingUseCasePresetLabel(fallbackObj, locale); + }; + + const resolveCriterionText = ( + criterionKey: RatingCriterionKey, + fallbackObj: { label: { vi: string; en: string; cs: string } } + ) => { + const customText = + copy.criterionLabels && + Object.prototype.hasOwnProperty.call(copy.criterionLabels, criterionKey) + ? copy.criterionLabels[criterionKey] + : undefined; + return customText && customText.trim() + ? customText + : getRatingCriterionLabel(fallbackObj, locale); + }; + + return ( +
+
+
+ + {copy.groupLabel} + + + {presets.map((preset) => { + const isSelected = mode === preset.id; + const btnClass = isDark + ? isSelected + ? 'btn-primary fw-bold text-white' + : 'btn-outline-light' + : isSelected + ? 'btn-primary fw-semibold text-white shadow-sm' + : 'btn-outline-dark'; + return ( + + ); + })} + + + + {!isDefault && ( + + )} +
+ + {trailingActions && ( +
+ {trailingActions} +
+ )} +
+ + {(!isDefault || showSliders) && weightSummary && ( +
+ {copy.normalizedSummaryPrefix}{' '} + {weightSummary} + {!isDefault && copy.officialKeepNote ? ( + {` · ${copy.officialKeepNote}`} + ) : null} +
+ )} + + {showSliders && sliderCriteria.length > 0 && ( +
+
+ {sliderCriteria.map((criterion) => { + const sliderId = `${reactId}-slider-${criterion.key}`; + const labelText = resolveCriterionText(criterion.key, criterion); + const rawVal = normalized.sliderWeights[criterion.key] ?? 0; + const normPct = normalized.normalizedPercent[criterion.key] ?? 0; + return ( +
+
+ + + {formatPercent(normPct, locale)} + +
+ + onUpdateWeight(criterion.key, Number(e.target.value)) + } + className="form-range" + /> +
+ ); + })} +
+
+ )} +
+ ); +} diff --git a/apps/web/src/components/compare/VersusInteractiveScoreboard.tsx b/apps/web/src/components/compare/VersusInteractiveScoreboard.tsx index 94b63089..8e4ab67d 100644 --- a/apps/web/src/components/compare/VersusInteractiveScoreboard.tsx +++ b/apps/web/src/components/compare/VersusInteractiveScoreboard.tsx @@ -1,14 +1,47 @@ 'use client'; -import { useId, useMemo, useState } from 'react'; +import { + Suspense, + useCallback, + useEffect, + useId, + useMemo, + useState, +} from 'react'; +import { useSearchParams } from 'next/navigation'; import { useLocale, useTranslations } from 'next-intl'; -import { BsSliders } from 'react-icons/bs'; +import type { + RatingCriterionKey, + UseCasePresetId, +} from '@repo/shared-data/rules'; import { Link } from '@/lib/navigation'; import { MAX_VALID_VND_PRICE, comparePositiveMinPrices, } from '@/lib/rate-domain'; -import { sharedScoredCriteria } from '@/lib/leaderboard-engine'; +import { + CRITERION_RANK_WRITERS, + sharedScoredCriteria, +} from '@/lib/leaderboard-engine'; +import { + availableCategoryUseCasePresets, + computeCustomWeightedScore5, + defaultCategoryWeights, + extractCategoryCriteriaScores, + isDefaultCategoryWeights, + mergeUseCaseQueryIntoSearch, + normalizeCategoryWeights, + parseUseCaseWeightsFromParams, + resolveCategoryPreset, + resolveLocalizedPresetName, + sanitizeSliderWeight, + sharedCategoryCriteriaForPair, + toLegacyCriteriaWeights, + toLegacyVersusPersona, + type ActiveWeightMode, + type CategoryCriterionWeights, +} from '@/lib/use-case-weights'; +import UseCaseWeightBar from './UseCaseWeightBar'; import { getRadarSignal, RADAR_CSV_HEADERS, @@ -46,6 +79,7 @@ import { displayedScore5, formatRatingValue, formatScoreFixed, + roundScore, } from '@/lib/rating-display'; export { @@ -65,6 +99,9 @@ interface VersusInteractiveScoreboardProps { readonly scoreA: ScoredVersusItem; readonly scoreB: ScoredVersusItem; readonly locale?: string; + readonly initialWeightMode?: ActiveWeightMode; + readonly initialCategoryWeights?: CategoryCriterionWeights; + readonly initialShowSliders?: boolean; } export function sanitizeVersusExportSlug(value: unknown): string { @@ -199,16 +236,41 @@ export function formatVersusWeightedMarkdown( }; } +function VersusUrlWeightsSync({ + categorySlug, + onSync, +}: { + readonly categorySlug: string; + readonly onSync: ( + cat: string, + rawPreset: string | null, + rawWeights: string | null + ) => void; +}) { + const searchParams = useSearchParams(); + const rawPreset = searchParams.get('preset'); + const rawWeights = searchParams.get('weights'); + useEffect( + () => onSync(categorySlug, rawPreset, rawWeights), + [categorySlug, rawPreset, rawWeights, onSync] + ); + return null; +} + export default function VersusInteractiveScoreboard({ scoreA: firstScore, scoreB: secondScore, locale: localeProp, + initialWeightMode = 'default', + initialCategoryWeights, + initialShowSliders = false, }: VersusInteractiveScoreboardProps) { // A pair has one URL, its sides sorted (DOS/Rate#1367), so the swap button // swaps the two sides here instead of linking to the other order. const [swapped, setSwapped] = useState(false); const scoreA = swapped ? secondScore : firstScore; const scoreB = swapped ? firstScore : secondScore; + const catSlug = scoreA.categorySlug || 'smartphones'; const t = useTranslations('compare'); const tStars = useTranslations('starRating'); const hookLocale = useLocale(); @@ -218,26 +280,138 @@ export default function VersusInteractiveScoreboard({ score > 0 ? formatRatingValue(score, locale) : tStars('empty'); const useCaseLabelId = useId(); const slidersPanelId = useId(); - const [persona, setPersona] = useState('default'); - const [weights, setWeights] = useState( - PERSONA_WEIGHTS.default - ); - const [showSliders, setShowSliders] = useState(false); + const [weightMode, setWeightMode] = + useState(initialWeightMode); + const [categoryWeights, setCategoryWeights] = + useState(() => { + if (initialCategoryWeights) { + return normalizeCategoryWeights(catSlug, initialCategoryWeights) + .sliderWeights; + } + if (initialWeightMode !== 'default' && initialWeightMode !== 'custom') { + return normalizeCategoryWeights( + catSlug, + resolveCategoryPreset(catSlug, initialWeightMode).weights + ).sliderWeights; + } + return defaultCategoryWeights(catSlug); + }); + const [showSliders, setShowSliders] = useState(initialShowSliders); const [copiedVerdict, setCopiedVerdict] = useState(false); const radarIndex = useDealRadarIndex(); - const selectPersona = (next: Exclude) => { - setPersona(next); - setWeights(PERSONA_WEIGHTS[next]); + const catScoresA = useMemo( + () => + extractCategoryCriteriaScores( + scoreA.product, + catSlug, + CRITERION_RANK_WRITERS, + scoreA.rankCriteria + ), + [scoreA.product, scoreA.rankCriteria, catSlug] + ); + const catScoresB = useMemo( + () => + extractCategoryCriteriaScores( + scoreB.product, + catSlug, + CRITERION_RANK_WRITERS, + scoreB.rankCriteria + ), + [scoreB.product, scoreB.rankCriteria, catSlug] + ); + const sharedCategoryCriteria = useMemo( + () => sharedCategoryCriteriaForPair(catSlug, catScoresA, catScoresB), + [catSlug, catScoresA, catScoresB] + ); + + const replaceVersusQuery = useCallback( + ( + nextMode: ActiveWeightMode, + nextWeights: CategoryCriterionWeights, + available: readonly RatingCriterionKey[] + ) => { + if (typeof window === 'undefined') return; + const merged = + available.length > 0 + ? mergeUseCaseQueryIntoSearch( + window.location.search, + catSlug, + nextMode, + nextWeights, + available + ) + : mergeUseCaseQueryIntoSearch( + window.location.search, + catSlug, + 'default', + defaultCategoryWeights(catSlug), + [] + ); + window.history.replaceState( + null, + '', + `${window.location.pathname}${merged}` + ); + }, + [catSlug] + ); + + const handleUrlWeightsSync = useCallback( + (cat: string, rawPreset: string | null, rawWeights: string | null) => { + const parsed = parseUseCaseWeightsFromParams(cat, { + preset: rawPreset ?? undefined, + weights: rawWeights ?? undefined, + }); + setWeightMode(parsed.mode); + setCategoryWeights(parsed.weights); + }, + [] + ); + + const selectUseCasePreset = (presetId: UseCasePresetId) => { + const preset = resolveCategoryPreset(catSlug, presetId); + const norm = normalizeCategoryWeights( + catSlug, + preset.weights, + sharedCategoryCriteria + ); + setWeightMode(preset.id); + setCategoryWeights(norm.sliderWeights); + replaceVersusQuery(preset.id, norm.sliderWeights, sharedCategoryCriteria); }; - const updateWeight = (key: keyof CriteriaWeights, val: number) => { - setPersona('custom'); - const safeVal = Number.isFinite(val) ? Math.max(0, Math.min(100, val)) : 0; - setWeights((prev) => ({ - ...prev, - [key]: safeVal, - })); + const updateCategoryWeight = (key: RatingCriterionKey, val: number) => { + const candidate: CategoryCriterionWeights = { + ...categoryWeights, + [key]: sanitizeSliderWeight(val, categoryWeights[key] ?? 0), + }; + const normalized = normalizeCategoryWeights( + catSlug, + candidate, + sharedCategoryCriteria + ); + const collapsesToDefault = + normalized.wasAllZeroReset || + isDefaultCategoryWeights( + catSlug, + 'custom', + normalized.sliderWeights, + sharedCategoryCriteria + ); + const nextMode: ActiveWeightMode = collapsesToDefault + ? 'default' + : 'custom'; + const nextWeights = collapsesToDefault + ? defaultCategoryWeights(catSlug) + : normalized.sliderWeights; + setWeightMode(nextMode); + setCategoryWeights(nextWeights); + replaceVersusQuery(nextMode, nextWeights, sharedCategoryCriteria); + }; + + const resetVersusWeights = () => { + selectUseCasePreset('default'); }; const safeMinPriceA = resolveVersusScoreMinPriceVnd(scoreA); @@ -260,7 +434,85 @@ export default function VersusInteractiveScoreboard({ [scoreA.rankCriteria, scoreB.rankCriteria] ); const availablePersonas = versusAvailablePersonas(sharedCriteria); - const canWeigh = availablePersonas.length > 0; + const availableCategoryPresets = useMemo( + () => availableCategoryUseCasePresets(catSlug, sharedCategoryCriteria), + [catSlug, sharedCategoryCriteria] + ); + const canWeigh = + availablePersonas.length > 0 && availableCategoryPresets.length > 0; + + useEffect(() => { + if (!canWeigh) { + if (weightMode !== 'default' || showSliders) { + const defaults = defaultCategoryWeights(catSlug); + setWeightMode('default'); + setShowSliders(false); + setCategoryWeights(defaults); + replaceVersusQuery('default', defaults, []); + } + return; + } + if ( + weightMode !== 'default' && + (isDefaultCategoryWeights( + catSlug, + weightMode, + categoryWeights, + sharedCategoryCriteria + ) || + (weightMode !== 'custom' && + !availableCategoryPresets.some((p) => p.id === weightMode))) + ) { + const defaults = defaultCategoryWeights(catSlug); + setWeightMode('default'); + setCategoryWeights(defaults); + replaceVersusQuery('default', defaults, sharedCategoryCriteria); + } + }, [ + canWeigh, + weightMode, + categoryWeights, + showSliders, + catSlug, + availableCategoryPresets, + sharedCategoryCriteria, + replaceVersusQuery, + ]); + + const hasActiveCustomWeights = + canWeigh && + !isDefaultCategoryWeights( + catSlug, + weightMode, + categoryWeights, + sharedCategoryCriteria + ); + + const activePresetTitle = resolveLocalizedPresetName( + catSlug, + weightMode, + locale, + undefined, + t('customWeightsActive') + ); + + const persona: PersonaPresetKey = useMemo( + () => + hasActiveCustomWeights ? toLegacyVersusPersona(weightMode) : 'default', + [hasActiveCustomWeights, weightMode] + ); + const weights: CriteriaWeights = useMemo( + () => + !hasActiveCustomWeights + ? PERSONA_WEIGHTS.default + : toLegacyCriteriaWeights( + catSlug, + categoryWeights, + sharedCategoryCriteria + ), + [hasActiveCustomWeights, catSlug, categoryWeights, sharedCategoryCriteria] + ); + // The same result as GET /api/v1/rate/versus (DOS/Rate#1647): the final // winner by the overall stars as shown, whatever weights are picked; a // preset or custom weights only add their own lead, shown apart. @@ -362,10 +614,62 @@ export default function VersusInteractiveScoreboard({ photography: t('personaPhotography'), gaming: t('personaGaming'), endurance: t('personaEndurance'), + business: activePresetTitle, value_hunter: t('personaValueHunter'), custom: t('customWeightsActive'), + ...(hasActiveCustomWeights ? { [activePersona]: activePresetTitle } : {}), }; + const customWeightedPair = useMemo(() => { + if (!hasActiveCustomWeights) return null; + const resA = computeCustomWeightedScore5( + catSlug, + catScoresA, + categoryWeights, + { + onlyCriteria: sharedCategoryCriteria, + officialScore5: overallResult.finalA, + } + ); + const resB = computeCustomWeightedScore5( + catSlug, + catScoresB, + categoryWeights, + { + onlyCriteria: sharedCategoryCriteria, + officialScore5: overallResult.finalB, + } + ); + if (resA.customScore5 == null || resB.customScore5 == null) return null; + const isTie = resA.customScore5 === resB.customScore5; + const gap = roundScore(Math.abs(resA.customScore5 - resB.customScore5), 2); + const leadSide: 'A' | 'B' = + resA.customScore5 >= resB.customScore5 ? 'A' : 'B'; + const leadItem = leadSide === 'A' ? scoreA : scoreB; + const leadScore = leadSide === 'A' ? resA.customScore5 : resB.customScore5; + return { + scoreA5: resA.customScore5, + scoreB5: resB.customScore5, + isTie, + leadSide, + leadSlug: leadItem.slug, + leadName: leadItem.name, + leadScore5: leadScore, + delta5: gap, + }; + }, [ + hasActiveCustomWeights, + catSlug, + catScoresA, + catScoresB, + categoryWeights, + sharedCategoryCriteria, + overallResult.finalA, + overallResult.finalB, + scoreA, + scoreB, + ]); + const handleCopy1v1Markdown = async () => { if (typeof window === 'undefined') return; try { @@ -391,24 +695,51 @@ export default function VersusInteractiveScoreboard({ expertSourceTag: t('overallSourceExpertBadge'), } ); + const customMdBullet = customWeightedPair + ? `- **${sanitizeVersusMarkdownCell(t('yourCustomScoreLabel'))} (${sanitizeVersusMarkdownCell(activePresetTitle)}):** ${ + customWeightedPair.isTie + ? t('customWinnerTie', { + preset: sanitizeVersusMarkdownCell(activePresetTitle), + score: formatRatingValue( + customWeightedPair.leadScore5, + locale, + 2 + ), + }) + : t('customWinnerSummary', { + preset: sanitizeVersusMarkdownCell(activePresetTitle), + winner: sanitizeVersusMarkdownCell( + customWeightedPair.leadName + ), + score: formatRatingValue( + customWeightedPair.leadScore5, + locale, + 2 + ), + delta: formatRatingValue( + customWeightedPair.delta5, + locale, + 2 + ), + }) + }` + : personaLead + ? `- ${t( + personaLead.key, + personaLead.key === 'versusPersonaLead' + ? { + ...personaLead.values, + winner: sanitizeVersusMarkdownCell( + personaResult?.winner.name + ), + } + : personaLead.values + )}` + : null; const lines = [ `### ${t('md1v1Heading', { nameA: safeNameA, nameB: safeNameB })}`, summaryBullet, - ...(personaLead - ? [ - `- ${t( - personaLead.key, - personaLead.key === 'versusPersonaLead' - ? { - ...personaLead.values, - winner: sanitizeVersusMarkdownCell( - personaResult?.winner.name - ), - } - : personaLead.values - )}`, - ] - : []), + ...(customMdBullet ? [customMdBullet] : []), `- **${t('mdAuditUrl')}:** ${window.location.href}`, '', `| ${t('mdColCriterion')} | ${safeNameA} | ${safeNameB} | ${t('mdColAdvantage')} |`, @@ -477,17 +808,29 @@ export default function VersusInteractiveScoreboard({ '-', ], // The lead under the picked weights, apart from the overall row. - ...(personaResult + ...(customWeightedPair ? [ [ - personaLabels[activePersona] ?? personaLabels.custom, + `${t('yourCustomScoreLabel')} (${activePresetTitle})`, 100, - formatScoreFixed(displayedScore5(personaResult.finalA), 1), - formatScoreFixed(displayedScore5(personaResult.finalB), 1), - personaResult.tie ? t('mdRowTie') : personaResult.winner.name, + formatScoreFixed(customWeightedPair.scoreA5, 2), + formatScoreFixed(customWeightedPair.scoreB5, 2), + customWeightedPair.isTie + ? t('mdRowTie') + : customWeightedPair.leadName, ], ] - : []), + : personaResult + ? [ + [ + personaLabels[activePersona] ?? personaLabels.custom, + 100, + formatScoreFixed(displayedScore5(personaResult.finalA), 1), + formatScoreFixed(displayedScore5(personaResult.finalB), 1), + personaResult.tie ? t('mdRowTie') : personaResult.winner.name, + ], + ] + : []), ...criteriaRows.map((r) => [ r.label, activeWeights[r.key], @@ -574,6 +917,26 @@ export default function VersusInteractiveScoreboard({ versusSlug: `${safeSlugA}-vs-${safeSlugB}`, persona: activePersona, weights: activeWeights, + useCaseMode: weightMode, + categoryWeights: normalizeCategoryWeights( + catSlug, + categoryWeights, + sharedCategoryCriteria + ).normalizedPercent, + customWeightedResult: customWeightedPair + ? { + tie: customWeightedPair.isTie, + winnerSlug: customWeightedPair.isTie + ? null + : sanitizeVersusExportSlug(customWeightedPair.leadSlug), + winnerName: customWeightedPair.isTie + ? null + : customWeightedPair.leadName, + scoreA5: customWeightedPair.scoreA5, + scoreB5: customWeightedPair.scoreB5, + delta5: customWeightedPair.delta5, + } + : null, exportedAt: new Date().toISOString(), tie: overallResult.tie, winner: overallResult.tie @@ -652,8 +1015,52 @@ export default function VersusInteractiveScoreboard({ locale ); + const actionButtons = ( + <> + + + + + + ); + return ( <> + + + {/* The verdict names the final winner by the overall stars; the picked weights only add their own lead below (DOS/Rate#1647). */}

0 && ` ${t('versusVerdictExpertSource', { name: verdictExpertNames.join(', ') })}`} - {personaLead && ( + {personaLead && !customWeightedPair && ( {t(personaLead.key, personaLead.values)} )}

- {/* Top Action & Persona Filter Strip */} -
- {/* Presets expose the pressed one, not only its colour (DOS/Rate#1069). */} - {canWeigh ? ( -
- - {t('useCaseLabel')} - - {( - [ - { key: 'default', label: t('personaDefault') }, - { key: 'photography', label: t('personaPhotography') }, - { key: 'gaming', label: t('personaGaming') }, - { key: 'endurance', label: t('personaEndurance') }, - { key: 'value_hunter', label: t('personaValueHunter') }, - ] as const - ) - .filter((item) => availablePersonas.includes(item.key)) - .map((item) => ( - - ))} - -
- ) : ( - - )} - -
- - - - -
+ {/* Top Action & RTINGS-Style Category Use-Case Filter Strip (#1864) */} +
+ setShowSliders((prev) => !prev)} + onSelectPreset={selectUseCasePreset} + onUpdateWeight={updateCategoryWeight} + onReset={resetVersusWeights} + locale={locale} + variant="dark" + groupLabelId={useCaseLabelId} + slidersPanelId={slidersPanelId} + trailingActions={actionButtons} + testIdPrefix="versus-weights" + copy={{ + groupLabel: t('useCaseLabel'), + customizeBtn: t('customWeightsBtn'), + customActiveBadge: t('customWeightsActive'), + resetBtn: t('resetWeightsBtn'), + normalizedSummaryPrefix: t('normalizedWeightsPrefix'), + officialKeepNote: t('officialScoreKeepNote'), + }} + />
- {/* Interactive 5-Criteria Weight Sliders */} - {showSliders && canWeigh && ( -
-
- {criteriaRows - .filter((c) => sharedCriteria.includes(c.key)) - .map((c) => ( -
-
- {c.label} - - {formatPercent(activeWeights[c.key], locale)} - -
- - updateWeight(c.key, Number(e.target.value)) - } - className="form-range" - aria-label={c.label} - /> -
- ))} -
-
- )} - - {/* Dynamic 1v1 Winner Banner */} + {/* Dynamic 1v1 Official Winner Banner (#1531 D3) */}
{overallResult.tie ? t('tie1v1Badge') : t('leading1v1Badge')} + {hasActiveCustomWeights && ( + + {t('officialRateScoreLabel')}: + + )} {overallResult.tie ? ( {overallResult.bothScored @@ -863,6 +1168,57 @@ export default function VersusInteractiveScoreboard({
+ {/* Personalized Custom-Weight Score Callout (#1864, #1531 D3/D9) */} +
+ {customWeightedPair && ( +
+
+ + {t('yourCustomScoreLabel')} + + + {customWeightedPair.isTie + ? t('customWinnerTie', { + preset: activePresetTitle, + score: formatRatingValue( + customWeightedPair.leadScore5, + locale, + 2 + ), + }) + : t('customWinnerSummary', { + preset: activePresetTitle, + winner: customWeightedPair.leadName, + score: formatRatingValue( + customWeightedPair.leadScore5, + locale, + 2 + ), + delta: formatRatingValue( + customWeightedPair.delta5, + locale, + 2 + ), + })} + +
+
+ {scoreA.name}:{' '} + {formatRatingValue(customWeightedPair.scoreA5, locale, 2)}/5 •{' '} + {scoreB.name}:{' '} + {formatRatingValue(customWeightedPair.scoreB5, locale, 2)}/5 +
+
+ )} +
+ {/* Product Headers */}
diff --git a/apps/web/src/components/leaderboard/LeaderboardExplorer.tsx b/apps/web/src/components/leaderboard/LeaderboardExplorer.tsx index 8a0d794e..70fb3940 100644 --- a/apps/web/src/components/leaderboard/LeaderboardExplorer.tsx +++ b/apps/web/src/components/leaderboard/LeaderboardExplorer.tsx @@ -25,12 +25,29 @@ import { type LeaderboardPriceSegment, } from '@/lib/rate-domain'; import { + CRITERION_RANK_WRITERS, LEADERBOARD_SCORE_CRITERIA, displayedScore5, leaderboardCriteriaForCategory, - weightedCriteriaScore5, type LeaderboardCriteriaBreakdown, } from '@/lib/leaderboard-engine'; +import { + availableCategoryUseCasePresets, + computeCustomWeightedScore5, + defaultCategoryWeights, + extractCategoryCriteriaScores, + isDefaultCategoryWeights, + mergeUseCaseQueryIntoSearch, + normalizeCategoryWeights, + parseUseCaseWeightsFromParams, + resolveCategoryPreset, + resolveLocalizedPresetName, + sanitizeSliderWeight, + scoredCategoryCriteriaForProducts, + type ActiveWeightMode, + type CategoryCriterionWeights, +} from '@/lib/use-case-weights'; +import UseCaseWeightBar from '@/components/compare/UseCaseWeightBar'; import { getRadarSignal, radarCsvCells, @@ -45,7 +62,11 @@ import { useDealRadarIndex } from '@/components/radar/use-deal-radar'; import CompareQuickToggle from '@/components/compare/CompareQuickToggle'; import { escapeCsvCell } from '@/lib/csv-safe'; import type { KeySpecs } from '@repo/shared-data'; -import { applyCategorySpecTemplate } from '@repo/shared-data/rules'; +import { + applyCategorySpecTemplate, + type RatingCriterionKey, + type UseCasePresetId, +} from '@repo/shared-data/rules'; import { BsArrowLeftRight, BsAwardFill, @@ -62,7 +83,6 @@ import { BsPhone, BsSearch, BsShieldCheck, - BsSliders, BsSmartwatch, BsStarFill, BsTablet, @@ -71,11 +91,7 @@ import { } from 'react-icons/bs'; import ContentText from '@/components/elementary/ContentText'; import StarRating from '@/components/elementary/StarRating'; -import { - formatDecimal, - formatPercent, - formatPriceVnd, -} from '@/lib/locale-format'; +import { formatDecimal, formatPriceVnd } from '@/lib/locale-format'; import { displayRating, formatRatingValue, @@ -587,6 +603,10 @@ interface LeaderboardExplorerProps { readonly filteredReviewCounts?: FilteredReviewCountsByMaster; /** RATE_ITEM_MODEL on: variant slug to Item slug, for versus links. */ readonly itemSlugBySlug?: Readonly>; + readonly initialCategory?: CanonicalCategorySlug; + readonly initialWeightMode?: ActiveWeightMode; + readonly initialCustomWeights?: CategoryCriterionWeights; + readonly initialShowWeightSliders?: boolean; } interface RankedProductEntry { @@ -689,9 +709,15 @@ function computeProductScores( function TabFromUrl({ onCategory, onCriterion, + onWeightQuery, }: { readonly onCategory: (cat: CanonicalCategorySlug) => void; readonly onCriterion: (crit: LeaderboardCriterionKey) => void; + readonly onWeightQuery: ( + cat: CanonicalCategorySlug, + rawPreset: string | null, + rawWeights: string | null + ) => void; }) { const searchParams = useSearchParams(); // Normalized first, so the effects fire only when the effective tab @@ -699,8 +725,14 @@ function TabFromUrl({ // URL must not count as a category change (and reset the brand). const cat = normalizeLeaderboardCategory(searchParams.get('cat')); const crit = normalizeLeaderboardCriterion(searchParams.get('criterion')); + const rawPreset = searchParams.get('preset'); + const rawWeights = searchParams.get('weights'); useEffect(() => onCategory(cat), [cat, onCategory]); useEffect(() => onCriterion(crit), [crit, onCriterion]); + useEffect( + () => onWeightQuery(cat, rawPreset, rawWeights), + [cat, rawPreset, rawWeights, onWeightQuery] + ); return null; } @@ -710,6 +742,10 @@ export default function LeaderboardExplorer({ locale: localeProp, filteredReviewCounts, itemSlugBySlug, + initialCategory = 'smartphones', + initialWeightMode = 'default', + initialCustomWeights, + initialShowWeightSliders = false, }: LeaderboardExplorerProps) { const t = useTranslations('leaderboard'); const hookLocale = useLocale(); @@ -719,116 +755,62 @@ export default function LeaderboardExplorer({ const categoryTabs = useMemo(() => buildCategoryTabs(t), [t]); const [activeCategory, setActiveCategory] = - useState('smartphones'); + useState(initialCategory); const [activeCriterion, setActiveCriterion] = useState('combined'); - // Keeps the tab in the URL without a server round trip; Next syncs its - // router with the native history API. - const replaceTabUrl = ( - cat: CanonicalCategorySlug, - crit: LeaderboardCriterionKey - ) => { - window.history.replaceState( - null, - '', - `${window.location.pathname}?cat=${cat}&criterion=${crit}` - ); - }; const [priceSegment, setPriceSegment] = useState('all'); const [selectedBrand, setSelectedBrand] = useState('all'); const [searchQuery, setSearchQuery] = useState(''); - const [activePersona, setActivePersona] = - useState('none'); - const [showWeightSliders, setShowWeightSliders] = useState(false); - const [customWeights, setCustomWeights] = useState<{ - screen: number; - performance: number; - camera: number; - battery: number; - value: number; - }>({ - screen: 20, - performance: 20, - camera: 20, - battery: 20, - value: 20, - }); - - const applyPersonaPreset = ( - persona: - | 'none' - | 'photography' - | 'gaming' - | 'endurance' - | 'business' - | 'value_hunter' - ) => { - setActivePersona(persona); - if (persona === 'none') { - setCustomWeights({ - screen: 20, - performance: 20, - camera: 20, - battery: 20, - value: 20, - }); - return; - } - if (persona === 'photography') { - setCustomWeights({ - screen: 25, - performance: 15, - camera: 45, - battery: 10, - value: 5, - }); - } else if (persona === 'gaming') { - setCustomWeights({ - screen: 25, - performance: 45, - camera: 5, - battery: 20, - value: 5, - }); - } else if (persona === 'endurance') { - setCustomWeights({ - screen: 15, - performance: 15, - camera: 10, - battery: 45, - value: 15, - }); - } else if (persona === 'business') { - setCustomWeights({ - screen: 30, - performance: 25, - camera: 10, - battery: 25, - value: 10, - }); - } else if (persona === 'value_hunter') { - setCustomWeights({ - screen: 15, - performance: 20, - camera: 10, - battery: 15, - value: 40, - }); - } - }; + const [weightMode, setWeightMode] = + useState(initialWeightMode); + const [showWeightSliders, setShowWeightSliders] = useState( + initialShowWeightSliders + ); + const [customWeights, setCustomWeights] = useState( + () => + initialCustomWeights + ? normalizeCategoryWeights(initialCategory, initialCustomWeights) + .sliderWeights + : initialWeightMode !== 'default' && initialWeightMode !== 'custom' + ? normalizeCategoryWeights( + initialCategory, + resolveCategoryPreset(initialCategory, initialWeightMode).weights + ).sliderWeights + : defaultCategoryWeights(initialCategory) + ); - const updateSingleWeight = ( - key: 'screen' | 'performance' | 'camera' | 'battery' | 'value', - val: number - ) => { - setActivePersona('custom'); - setCustomWeights((prev) => ({ - ...prev, - [key]: sanitizeLeaderboardWeight(val, prev[key]), - })); - }; + // Keeps the tab and active non-default preset/weights in the URL without a + // server round trip; Next syncs its router with the native history API. + const replaceTabUrl = useCallback( + ( + cat: CanonicalCategorySlug, + crit: LeaderboardCriterionKey, + nextMode: ActiveWeightMode, + nextWeights: CategoryCriterionWeights, + available: readonly RatingCriterionKey[] + ) => { + if (typeof window === 'undefined') return; + const baseQuery = `?cat=${cat}&criterion=${crit}`; + const mergedQuery = + available.length > 0 + ? mergeUseCaseQueryIntoSearch( + baseQuery, + cat, + nextMode, + nextWeights, + available + ) + : baseQuery; + window.history.replaceState( + null, + '', + `${window.location.pathname}${mergedQuery}` + ); + }, + [] + ); const copy = useMemo( () => ({ @@ -837,6 +819,7 @@ export default function LeaderboardExplorer({ chooseCriterion: t('chooseCriterion'), personaTitle: t('personaTitle'), customizeWeightsBtn: t('customizeWeightsBtn'), + customWeightsBtn: t('customWeightsBtn'), personaLabels: { none: t('personaNone'), photography: t('personaPhotography'), @@ -846,6 +829,44 @@ export default function LeaderboardExplorer({ value_hunter: t('personaValueHunter'), custom: t('personaCustom'), }, + presetLabels: { + default: t('preset_default'), + gaming: t('preset_gaming'), + camera: t('preset_camera'), + endurance: t('preset_endurance'), + value: t('preset_value'), + media: t('preset_media'), + study_work: t('preset_study_work'), + office: t('preset_office'), + creator: t('preset_creator'), + fitness: t('preset_fitness'), + smart_daily: t('preset_smart_daily'), + audiophile: t('preset_audiophile'), + commute_anc: t('preset_commute_anc'), + calls_work: t('preset_calls_work'), + } satisfies Record, + weightCriterionLabels: { + performance: t('weightCrit_performance'), + camera: t('weightCrit_camera'), + battery: t('weightCrit_battery'), + display: t('weightCrit_display'), + design: t('weightCrit_design'), + value: t('weightCrit_value'), + sound: t('weightCrit_sound'), + software: t('weightCrit_software'), + keyboard: t('weightCrit_keyboard'), + thermals: t('weightCrit_thermals'), + health: t('weightCrit_health'), + apps: t('weightCrit_apps'), + anc: t('weightCrit_anc'), + comfort: t('weightCrit_comfort'), + calls: t('weightCrit_calls'), + } satisfies Partial>, + resetWeightsBtn: t('resetWeightsBtn'), + normalizedWeightsPrefix: t('normalizedWeightsPrefix'), + officialRateScoreLabel: t('officialRateScoreLabel'), + yourCustomScoreLabel: t('yourCustomScoreLabel'), + officialScoreKeepNote: t('officialScoreKeepNote'), compareTop3Btn: t('compareTop3Btn'), searchPlaceholder: t('searchPlaceholder'), allBrands: t('allBrands'), @@ -898,46 +919,114 @@ export default function LeaderboardExplorer({ // for. A criterion with none gets no tab, no weight and no row cell, not // an empty list (DOS/Rate#1553). A tab and a weight need a score past the // ranking threshold; a cell needs one past the display threshold (D9). - const { scoredCriteria, shownCriteria } = useMemo(() => { - const ranked = new Set(); - const shown = new Set(); - const own = leaderboardCriteriaForCategory(activeCategory); - for (const item of categoryProducts) { - const { criteria, rankCriteria } = computeProductScores( - item, - 'combined', - filteredReviewCounts - ); - for (const c of own) { - if ((criteria[c] ?? 0) > 0) shown.add(c); - if ((rankCriteria[c] ?? 0) > 0) ranked.add(c); + const { scoredCriteria, shownCriteria, scoredCategoryCriteria } = + useMemo(() => { + const ranked = new Set(); + const shown = new Set(); + const own = leaderboardCriteriaForCategory(activeCategory); + const baseEntries: Array<{ + product: ItemCatalogRow; + rankCriteria: LeaderboardCriteriaBreakdown; + }> = []; + for (const item of categoryProducts) { + const { criteria, rankCriteria } = computeProductScores( + item, + 'combined', + filteredReviewCounts + ); + baseEntries.push({ product: item, rankCriteria }); + for (const c of own) { + if ((criteria[c] ?? 0) > 0) shown.add(c); + if ((rankCriteria[c] ?? 0) > 0) ranked.add(c); + } } - if (ranked.size === own.length) break; - } - return { - scoredCriteria: own.filter((c) => ranked.has(c)), - shownCriteria: own.filter((c) => shown.has(c)), - }; - }, [activeCategory, categoryProducts, filteredReviewCounts]); - const hasScoredCriteria = scoredCriteria.length > 0; + return { + scoredCriteria: own.filter((c) => ranked.has(c)), + shownCriteria: own.filter((c) => shown.has(c)), + scoredCategoryCriteria: scoredCategoryCriteriaForProducts( + activeCategory, + baseEntries, + CRITERION_RANK_WRITERS + ), + }; + }, [activeCategory, categoryProducts, filteredReviewCounts]); + const hasScoredCriteria = scoredCategoryCriteria.length > 0; const hasShownCriteria = shownCriteria.length > 0; - // Only the weights of the category's own criteria count: a screen - // weight left over from phones does not empty the earbuds list. - const weightedCriteria = useMemo( - () => leaderboardCriteriaForCategory(activeCategory), - [activeCategory] - ); - const totalWeight = weightedCriteria.reduce( - (sum, c) => sum + customWeights[c], - 0 - ); - const hasActivePersonaWeights = activePersona !== 'none' && totalWeight > 0; - const activeScoreLabel = resolveLeaderboardActiveScoreLabel( - activePersona, - activeCriterion, - copy, - totalWeight - ); + + const applyPersonaPreset = (presetId: UseCasePresetId) => { + const preset = resolveCategoryPreset(activeCategory, presetId); + const norm = normalizeCategoryWeights( + activeCategory, + preset.weights, + scoredCategoryCriteria + ); + setWeightMode(preset.id); + setCustomWeights(norm.sliderWeights); + replaceTabUrl( + activeCategory, + activeCriterion, + preset.id, + norm.sliderWeights, + scoredCategoryCriteria + ); + }; + + const updateSingleWeight = (key: RatingCriterionKey, val: number) => { + const nextCandidate: CategoryCriterionWeights = { + ...customWeights, + [key]: sanitizeSliderWeight(val, customWeights[key] ?? 0), + }; + const normalized = normalizeCategoryWeights( + activeCategory, + nextCandidate, + scoredCategoryCriteria + ); + const collapsesToDefault = + normalized.wasAllZeroReset || + isDefaultCategoryWeights( + activeCategory, + 'custom', + normalized.sliderWeights, + scoredCategoryCriteria + ); + const nextMode: ActiveWeightMode = collapsesToDefault + ? 'default' + : 'custom'; + const nextWeights = collapsesToDefault + ? defaultCategoryWeights(activeCategory) + : normalized.sliderWeights; + setWeightMode(nextMode); + setCustomWeights(nextWeights); + replaceTabUrl( + activeCategory, + activeCriterion, + nextMode, + nextWeights, + scoredCategoryCriteria + ); + }; + + const resetCustomWeights = () => { + applyPersonaPreset('default'); + }; + + const hasActivePersonaWeights = + hasScoredCriteria && + !isDefaultCategoryWeights( + activeCategory, + weightMode, + customWeights, + scoredCategoryCriteria + ); + const activeScoreLabel = hasActivePersonaWeights + ? resolveLocalizedPresetName( + activeCategory, + weightMode, + locale, + undefined, + copy.personaLabels.custom + ) + : resolveLeaderboardActiveScoreLabel('none', activeCriterion, copy, 0); // The one rating shows at 1 decimal (D3); a persona's own weighted score // keeps 2, under the persona's name. const ratingView = @@ -1010,14 +1099,24 @@ export default function LeaderboardExplorer({ ? base.combinedScore5 > 0 : base.activeScore5 > 0) ) { - const weighted5 = weightedCriteriaScore5( - base.rankCriteria, + const catScores = extractCategoryCriteriaScores( + item, + activeCategory, + CRITERION_RANK_WRITERS, + base.rankCriteria + ); + const customRes = computeCustomWeightedScore5( + activeCategory, + catScores, customWeights, - weightedCriteria + { + onlyCriteria: scoredCategoryCriteria, + officialScore5: base.userScore5, + } ); return { ...base, - activeScore5: weighted5 ?? 0, + activeScore5: customRes.customScore5 ?? 0, }; } return base; @@ -1073,8 +1172,9 @@ export default function LeaderboardExplorer({ priceSegment, searchQuery, activeCriterion, + activeCategory, hasActivePersonaWeights, - weightedCriteria, + scoredCategoryCriteria, customWeights, filteredReviewCounts, ]); @@ -1241,7 +1341,7 @@ export default function LeaderboardExplorer({ source: 'Rate.vn JReviews Leaderboard', category: activeCategory, criterion: activeCriterion, - persona: activePersona, + persona: weightMode, exportedAt: new Date().toISOString(), count: rankedEntries.length, items: rankedEntries.map((entry, idx) => @@ -1265,20 +1365,26 @@ export default function LeaderboardExplorer({ const handleSelectCategory = (cat: CanonicalCategorySlug) => { const crit = criterionForCategory(cat, activeCriterion); + const nextDefaults = defaultCategoryWeights(cat); setActiveCategory(cat); setActiveCriterion(crit); setSelectedBrand('all'); - replaceTabUrl(cat, crit); + setWeightMode('default'); + setCustomWeights(nextDefaults); + replaceTabUrl(cat, crit, 'default', nextDefaults, []); }; const handleSelectCriterion = (crit: LeaderboardCriterionKey) => { + const nextDefaults = defaultCategoryWeights(activeCategory); setActiveCriterion(crit); - replaceTabUrl(activeCategory, crit); + setWeightMode('default'); + setCustomWeights(nextDefaults); + replaceTabUrl(activeCategory, crit, 'default', nextDefaults, []); }; // The page is cached with the default tab; TabFromUrl applies the URL's - // ?cat= and ?criterion= on load and on every later navigation, including - // a same-route link to plain /leaderboard (DOS/Rate#508). + // ?cat=, ?criterion=, ?preset=, and ?weights= on load and on every later + // navigation, including a same-route link to plain /leaderboard (DOS/Rate#508). const applyUrlCategory = useCallback((cat: CanonicalCategorySlug) => { setActiveCategory(cat); setSelectedBrand('all'); @@ -1286,6 +1392,21 @@ export default function LeaderboardExplorer({ const applyUrlCriterion = useCallback((crit: LeaderboardCriterionKey) => { setActiveCriterion(crit); }, []); + const applyUrlWeightQuery = useCallback( + ( + cat: CanonicalCategorySlug, + rawPreset: string | null, + rawWeights: string | null + ) => { + const parsed = parseUseCaseWeightsFromParams(cat, { + preset: rawPreset ?? undefined, + weights: rawWeights ?? undefined, + }); + setWeightMode(parsed.mode); + setCustomWeights(parsed.weights); + }, + [] + ); // A URL such as ?cat=earbuds&criterion=screen opens on the combined tab. // So does a criterion no product has a score for yet (DOS/Rate#1553). // Before paint, so an empty list never flashes, and the URL follows. @@ -1301,24 +1422,68 @@ export default function LeaderboardExplorer({ } if (crit === activeCriterion) return; setActiveCriterion(crit); - window.history.replaceState( - null, - '', - `${window.location.pathname}?cat=${activeCategory}&criterion=${crit}` + replaceTabUrl( + activeCategory, + crit, + weightMode, + customWeights, + scoredCategoryCriteria ); - }, [activeCategory, activeCriterion, scoredCriteria]); + }, [ + activeCategory, + activeCriterion, + scoredCriteria, + weightMode, + customWeights, + scoredCategoryCriteria, + replaceTabUrl, + ]); useEffect(() => { - if (hasScoredCriteria || activePersona === 'none') return; - setActivePersona('none'); - setShowWeightSliders(false); - setCustomWeights({ - screen: 20, - performance: 20, - camera: 20, - battery: 20, - value: 20, - }); - }, [hasScoredCriteria, activePersona]); + if (!hasScoredCriteria) { + if (weightMode !== 'default' || showWeightSliders) { + const defaults = defaultCategoryWeights(activeCategory); + setWeightMode('default'); + setShowWeightSliders(false); + setCustomWeights(defaults); + replaceTabUrl(activeCategory, activeCriterion, 'default', defaults, []); + } + return; + } + if ( + weightMode !== 'default' && + (isDefaultCategoryWeights( + activeCategory, + weightMode, + customWeights, + scoredCategoryCriteria + ) || + (weightMode !== 'custom' && + !availableCategoryUseCasePresets( + activeCategory, + scoredCategoryCriteria + ).some((p) => p.id === weightMode))) + ) { + const defaults = defaultCategoryWeights(activeCategory); + setWeightMode('default'); + setCustomWeights(defaults); + replaceTabUrl( + activeCategory, + activeCriterion, + 'default', + defaults, + scoredCategoryCriteria + ); + } + }, [ + hasScoredCriteria, + weightMode, + customWeights, + showWeightSliders, + activeCategory, + activeCriterion, + scoredCategoryCriteria, + replaceTabUrl, + ]); const allCriterionOptions: Array<{ key: LeaderboardCriterionKey; @@ -1380,6 +1545,7 @@ export default function LeaderboardExplorer({ {/* 1. Directory -> 5-Category Hierarchy & Criterion Control Panel */} @@ -1498,7 +1664,6 @@ export default function LeaderboardExplorer({ type="button" aria-pressed={isSelected && !hasActivePersonaWeights} onClick={() => { - setActivePersona('none'); handleSelectCriterion(opt.key); }} className={`btn btn-sm rounded-pill d-inline-flex align-items-center gap-2 px-3 py-2 ${ @@ -1515,122 +1680,33 @@ export default function LeaderboardExplorer({
- {/* 3. Smart Use-Case Persona Recommender & Custom 5-Criteria Weight Sliders (Issue #52) */} + {/* 3. RTINGS-Style Category Use-Case Presets & Normalized Weight Sliders (#1864) */} {hasScoredCriteria && (
-
-
- {copy.personaTitle} -
- -
- -
- {( - [ - 'none', - 'photography', - 'gaming', - 'endurance', - 'business', - 'value_hunter', - ] as const - ).map((presetKey) => { - const isSelected = activePersona === presetKey; - return ( - - ); - })} -
- - {showWeightSliders && ( -
-
- {( - [ - { key: 'screen', label: copy.critLabels.screen }, - { - key: 'performance', - label: copy.critLabels.performance, - }, - { key: 'camera', label: copy.critLabels.camera }, - { key: 'battery', label: copy.critLabels.battery }, - { key: 'value', label: copy.critLabels.value }, - ] as const - ) - .filter((slider) => scoredCriteria.includes(slider.key)) - .map((slider) => ( -
-
- {slider.label} - - {formatPercent(customWeights[slider.key], locale)} - -
- - updateSingleWeight( - slider.key, - Number(e.target.value) - ) - } - className="form-range" - aria-label={slider.label} - /> -
- ))} -
-
- )} + setShowWeightSliders((v) => !v)} + onSelectPreset={applyPersonaPreset} + onUpdateWeight={updateSingleWeight} + onReset={resetCustomWeights} + locale={locale} + variant="light" + groupLabelId="leaderboard-persona-label" + slidersPanelId="leaderboard-weight-sliders" + testIdPrefix="leaderboard-weights" + copy={{ + groupLabel: copy.personaTitle, + customizeBtn: copy.customWeightsBtn, + customActiveBadge: copy.personaLabels.custom, + resetBtn: copy.resetWeightsBtn, + normalizedSummaryPrefix: copy.normalizedWeightsPrefix, + officialKeepNote: copy.officialScoreKeepNote, + }} + />
)} @@ -1887,6 +1963,15 @@ export default function LeaderboardExplorer({ {rankLabel}
+ {hasActivePersonaWeights && ( +
+ {copy.yourCustomScoreLabel} +
+ )} -
+
+ {hasActivePersonaWeights && ( + + {copy.officialRateScoreLabel}: + + )}
-
+
+ {hasActivePersonaWeights && ( + + {copy.officialRateScoreLabel}: + + )}
-
{activeScoreLabel}
+
+ {hasActivePersonaWeights + ? `${copy.yourCustomScoreLabel} (${activeScoreLabel})` + : activeScoreLabel} +
acc + (v ?? 0), + 0 + ); + assert.equal(defaultSum, 100, `${cat} default weights sum to 100`); + + const presets = getRatingUseCasePresets(cat); + assert.ok(presets.length >= 4, `${cat} offers curated use-case presets`); + assert.equal(presets[0]?.id, 'default'); + for (const preset of presets) { + const resolved = resolveCategoryPreset(cat, preset.id); + assert.equal(resolved.id, preset.id); + const norm = normalizeCategoryWeights(cat, preset.weights); + assert.equal(norm.wasAllZeroReset, false); + const pctSum = Object.values(norm.normalizedPercent).reduce( + (acc, v) => acc + (v ?? 0), + 0 + ); + assert.equal( + pctSum, + 100, + `${cat}:${preset.id} normalized percent sums to 100` + ); + } + } + + // Friendly URL preset aliases & category-aware aliases + assert.equal( + resolveCategoryPreset('smartphones', 'photography').id, + 'camera' + ); + assert.equal(resolveCategoryPreset('smartphones', 'VLOG').id, 'camera'); + assert.equal(resolveCategoryPreset('earbuds', 'anc').id, 'commute_anc'); + assert.equal(resolveCategoryPreset('earbuds', 'music').id, 'audiophile'); + assert.equal(resolveCategoryPreset('laptops', 'business').id, 'office'); + assert.equal(resolveCategoryPreset('tablets', 'business').id, 'study_work'); + assert.equal( + resolveCategoryPreset('smartwatches', 'business').id, + 'smart_daily' + ); + + // Prototype-key & malformed preset guards + for (const badPreset of [ + '__proto__', + 'constructor', + 'prototype', + 'toString', + 'valueOf', + 'unknown_preset', + 'gaming;drop', + '', + ' ', + null, + undefined, + 42, + {}, + ]) { + assert.equal( + resolveCategoryPreset('smartphones', badPreset).id, + 'default', + `Unsafe preset ${String(badPreset)} falls back to default` + ); + } + + // 3. Slider clamping, Hare-Niemeyer exact 100% normalization & all-zero reset + assert.equal(sanitizeSliderWeight(-25, 10), 0); + assert.equal(sanitizeSliderWeight(180, 10), 100); + assert.equal(sanitizeSliderWeight('35.6', 0), 36); + assert.equal(sanitizeSliderWeight(Number.NaN, 15), 15); + assert.equal(sanitizeSliderWeight(Number.POSITIVE_INFINITY, 20), 20); + assert.equal(sanitizeSliderWeight('0x20', 12), 12); + assert.equal(sanitizeSliderWeight('25\u0000', 12), 12); + assert.equal(sanitizeSliderWeight({ valueOf: () => 50 }, 12), 12); + + const threeEqual = normalizeCategoryWeights('smartphones', { + performance: 10, + camera: 10, + battery: 10, + display: 0, + design: 0, + value: 0, + }); + assert.equal(threeEqual.wasAllZeroReset, false); + assert.equal(threeEqual.normalizedPercent.performance, 34); + assert.equal(threeEqual.normalizedPercent.camera, 33); + assert.equal(threeEqual.normalizedPercent.battery, 33); + assert.equal( + Object.values(threeEqual.normalizedPercent).reduce((a, b) => a + b, 0), + 100 + ); + + const allZero = normalizeCategoryWeights('laptops', { + performance: 0, + display: 0, + battery: 0, + keyboard: 0, + thermals: 0, + design: 0, + value: 0, + }); + assert.equal(allZero.wasAllZeroReset, true); + assert.deepEqual(allZero.sliderWeights, defaultCategoryWeights('laptops')); + assert.equal( + Object.values(allZero.normalizedPercent).reduce((a, b) => a + b, 0), + 100 + ); + + const protoPayload = JSON.parse( + '{"__proto__":{"polluted":true},"constructor":80,"toString":50,"valueOf":50}' + ) as Record; + const protoNormalized = normalizeCategoryWeights('smartphones', protoPayload); + assert.equal( + protoNormalized.wasAllZeroReset, + true, + 'Prototype keys alone do not count as active weights and reset to default' + ); + assert.equal( + ({} as Record).polluted, + undefined, + 'Object.prototype was never polluted' + ); + + // 4. URL query serialization, strict parsing & canonical-safe query merging + const customQuery = serializeWeightsParam('smartphones', { + camera: 60, + battery: 40, + }); + assert.equal(customQuery, 'camera:60,battery:40'); + const reparsed = parseWeightsParam('smartphones', customQuery); + assert.ok(reparsed); + assert.equal(reparsed.camera, 60); + assert.equal(reparsed.battery, 40); + assert.equal(reparsed.performance, 0); + + // Legacy screen key maps cleanly per category + assert.equal( + parseWeightsParam('smartphones', 'screen:50,battery:50')?.display, + 50 + ); + assert.equal(parseWeightsParam('earbuds', 'screen:50,battery:50')?.sound, 50); + + for (const invalidWeights of [ + '', + ' ', + 'camera:-20,battery:50', + 'camera:NaN,battery:50', + 'camera:Infinity,battery:50', + 'camera:999999,battery:10', + 'camera:101,battery:10', + 'camera:0x10,battery:20', + 'camera:0,battery:0', + '__proto__:50,camera:50', + 'constructor:50,camera:50', + 'toString:50,camera:50', + 'anc:50,battery:50', // anc is invalid on smartphones + 'camera:50:10', + 'camera:50,\u0000battery:50', + `camera:50,${'a'.repeat(300)}:50`, + ]) { + assert.equal( + parseWeightsParam('smartphones', invalidWeights), + null, + `Invalid weights param "${invalidWeights.slice(0, 40)}" must be rejected` + ); + const fallbackState = parseUseCaseWeightsFromParams('smartphones', { + weights: invalidWeights, + }); + assert.equal(fallbackState.mode, 'default'); + assert.deepEqual( + fallbackState.weights, + defaultCategoryWeights('smartphones') + ); + } + + const mergedPreset = mergeUseCaseQueryIntoSearch( + '?slugs=iphone-16,galaxy-s24', + 'smartphones', + 'gaming', + resolveCategoryPreset('smartphones', 'gaming').weights + ); + assert.equal(mergedPreset, '?slugs=iphone-16%2Cgalaxy-s24&preset=gaming'); + + const mergedCustom = mergeUseCaseQueryIntoSearch( + mergedPreset, + 'smartphones', + 'custom', + { camera: 70, battery: 30 } + ); + assert.equal( + mergedCustom, + '?slugs=iphone-16%2Cgalaxy-s24&weights=camera%3A70%2Cbattery%3A30' + ); + + const mergedReset = mergeUseCaseQueryIntoSearch( + mergedCustom, + 'smartphones', + 'default', + defaultCategoryWeights('smartphones') + ); + assert.equal( + mergedReset, + '?slugs=iphone-16%2Cgalaxy-s24', + 'Resetting to Balanced Default strips both preset and weights from URL' + ); + assert.equal( + isDefaultCategoryWeights( + 'smartphones', + 'custom', + defaultCategoryWeights('smartphones') + ), + true + ); + + // 5. Decimal rounding parity with weightedCriteriaScore5 & Design Rule #1531 D3/D9 + const parityScores = { + display: 4.15, + performance: 4.25, + camera: 4.35, + battery: 4.05, + value: 4.45, + design: null, + }; + const legacyParity = weightedCriteriaScore5( + { + screen: 4.15, + performance: 4.25, + camera: 4.35, + battery: 4.05, + value: 4.45, + }, + { + screen: 15, + performance: 40, + camera: 10, + battery: 25, + value: 10, + }, + ['screen', 'performance', 'camera', 'battery', 'value'] + ); + const customParity = computeCustomWeightedScore5( + 'smartphones', + parityScores, + { + display: 15, + performance: 40, + camera: 10, + battery: 25, + value: 10, + design: 0, + }, + { officialScore5: 4.6 } + ); + assert.equal(customParity.customScore5, legacyParity); + assert.equal(customParity.officialScore5, 4.6); + assert.equal(customParity.displayedOfficialScore5, 4.6); + assert.equal(customParity.ratedCriteriaCount, 5); + + // Partial criteria renormalize over rated criteria without inventing 0s + const partialRes = computeCustomWeightedScore5( + 'earbuds', + { + sound: 4.8, + anc: 4.2, + battery: null, + comfort: null, + calls: null, + value: null, + }, + resolveCategoryPreset('earbuds', 'audiophile').weights, + { officialScore5: 4.3 } + ); + // Audiophile puts sound:50, anc:10 among rated criteria => (4.8*50 + 4.2*10)/60 = 4.70 + assert.equal(partialRes.customScore5, 4.7); + assert.equal(partialRes.displayedCustomScore5, 4.7); + assert.equal(partialRes.ratedCriteriaCount, 2); + assert.equal(partialRes.officialScore5, 4.3); + + // Unrated product returns null customScore5 instead of fabricating a score + const unratedRes = computeCustomWeightedScore5( + 'earbuds', + { + sound: null, + anc: null, + battery: null, + comfort: null, + calls: null, + value: null, + }, + resolveCategoryPreset('earbuds', 'commute_anc').weights, + { officialScore5: 4.1 } + ); + assert.equal(unratedRes.customScore5, null); + assert.equal(unratedRes.displayedCustomScore5, null); + assert.equal(unratedRes.officialScore5, 4.1); + + // Winner flip between Camera preset and Gaming preset while official scores stay intact + const phoneCameraPro = { + slug: 'camera-pro', + category_slug: 'smartphones', + rating_score: 4.4, + authentic_review_count: 18, + criteria_scores: { + camera: { score: 4.9, writers: 12 }, + display: { score: 4.7, writers: 12 }, + performance: { score: 3.6, writers: 12 }, + battery: { score: 3.9, writers: 12 }, + design: { score: 4.5, writers: 12 }, + value: { score: 3.8, writers: 12 }, + }, + }; + const phoneGamingBeast = { + slug: 'gaming-beast', + category_slug: 'smartphones', + rating_score: 4.2, + authentic_review_count: 15, + criteria_scores: { + camera: { score: 3.6, writers: 10 }, + display: { score: 4.4, writers: 10 }, + performance: { score: 4.9, writers: 10 }, + battery: { score: 4.8, writers: 10 }, + design: { score: 4.0, writers: 10 }, + value: { score: 4.6, writers: 10 }, + }, + }; + const scoresCamPro = extractCategoryCriteriaScores( + phoneCameraPro as never, + 'smartphones' + ); + const scoresGameBeast = extractCategoryCriteriaScores( + phoneGamingBeast as never, + 'smartphones' + ); + const shared = sharedCategoryCriteriaForPair( + 'smartphones', + scoresCamPro, + scoresGameBeast + ); + assert.equal(shared.length, getRatingCriteria('smartphones').length); + assert.equal( + scoredCategoryCriteriaForProducts('smartphones', [ + { product: phoneCameraPro as never }, + ]).length, + 6 + ); + assert.equal( + availableCategoryUseCasePresets('smartphones', []).length, + 0, + 'No presets offered when zero criteria have scores (#1553/#1556)' + ); + + const camPresetWeights = resolveCategoryPreset( + 'smartphones', + 'camera' + ).weights; + const gamePresetWeights = resolveCategoryPreset( + 'smartphones', + 'gaming' + ).weights; + const camProOnCam = computeCustomWeightedScore5( + 'smartphones', + scoresCamPro, + camPresetWeights, + { product: phoneCameraPro as never } + ); + const gameBeastOnCam = computeCustomWeightedScore5( + 'smartphones', + scoresGameBeast, + camPresetWeights, + { product: phoneGamingBeast as never } + ); + assert.ok( + (camProOnCam.customScore5 ?? 0) > (gameBeastOnCam.customScore5 ?? 0) + ); + + const camProOnGame = computeCustomWeightedScore5( + 'smartphones', + scoresCamPro, + gamePresetWeights, + { product: phoneCameraPro as never } + ); + const gameBeastOnGame = computeCustomWeightedScore5( + 'smartphones', + scoresGameBeast, + gamePresetWeights, + { product: phoneGamingBeast as never } + ); + assert.ok( + (gameBeastOnGame.customScore5 ?? 0) > (camProOnGame.customScore5 ?? 0), + 'Switching to Gaming preset flips custom winner to gaming-beast' + ); + assert.equal(camProOnGame.officialScore5, 4.4); + assert.equal(gameBeastOnGame.officialScore5, 4.2); + + // Summary formatting & legacy bridges across locales + for (const locale of ['vi', 'en', 'cs'] as const) { + const summary = formatNormalizedWeightSummary( + 'earbuds', + normalizeCategoryWeights( + 'earbuds', + resolveCategoryPreset('earbuds', 'commute_anc').weights + ).normalizedPercent, + locale + ); + assert.ok(summary.length > 10); + assert.doesNotMatch(summary, /[\u2013\u2014]/); + } + const legacyEarbuds = toLegacyCriteriaWeights( + 'earbuds', + resolveCategoryPreset('earbuds', 'commute_anc').weights + ); + assert.equal( + legacyEarbuds.screen + + legacyEarbuds.performance + + legacyEarbuds.camera + + legacyEarbuds.battery + + legacyEarbuds.value, + 100 + ); + assert.equal(toLegacyVersusPersona('gaming'), 'gaming'); + assert.equal(toLegacyVersusPersona('commute_anc'), 'photography'); + assert.equal(toLegacyVersusPersona('custom'), 'custom'); + + // 6. Round-1 review regressions: duplicate query keys, foreign availableCriteria, + // explicit empty / outside-onlyCriteria null score, and URL round-trip parity + assert.equal(parseWeightsParam('smartphones', 'camera:50,camera:0'), null); + assert.equal(parseWeightsParam('smartphones', 'screen:50,display:0'), null); + assert.deepEqual( + defaultCategoryWeights(' LAPTOPS\u0000 '), + defaultCategoryWeights('laptops') + ); + assert.equal( + availableCategoryUseCasePresets('smartphones', ['anc']).length, + 0, + 'Foreign-only availableCriteria returns zero presets' + ); + assert.equal( + computeCustomWeightedScore5( + 'smartphones', + scoresCamPro, + { camera: 80, display: 20 }, + { onlyCriteria: [] } + ).customScore5, + null, + 'Explicit empty onlyCriteria returns null instead of scoring all criteria' + ); + assert.equal( + computeCustomWeightedScore5( + 'smartphones', + scoresCamPro, + { camera: 80, display: 20, performance: 0, battery: 0 }, + { onlyCriteria: ['performance', 'battery'] } + ).customScore5, + null, + 'Weights placed solely outside onlyCriteria return null instead of Balanced Default' + ); + + // Live vs serialized ?weights= round-trip parity (10/10/10 -> 34%/33%/33%) + const rawEqualThree = { + performance: 10, + camera: 10, + battery: 10, + display: 0, + design: 0, + value: 0, + }; + const roundTripScores = { + performance: 5.0, + camera: 4.0, + battery: 4.0, + display: 4.0, + design: 4.0, + value: 4.0, + }; + const liveThreeRes = computeCustomWeightedScore5( + 'smartphones', + roundTripScores, + rawEqualThree + ); + const encodedThree = serializeWeightsParam('smartphones', rawEqualThree); + assert.equal(encodedThree, 'performance:10,camera:10,battery:10'); + assert.equal(liveThreeRes.customScore5, 4.33); + const reloadedThreeRes = computeCustomWeightedScore5( + 'smartphones', + roundTripScores, + parseWeightsParam('smartphones', encodedThree) + ); + assert.equal( + liveThreeRes.customScore5, + reloadedThreeRes.customScore5, + 'Live custom score matches shared/reloaded ?weights= URL score exactly' + ); + + // Small positive slider weight (camera:1 alongside five 100s) is preserved in URL + const tinyCameraEncoded = serializeWeightsParam('smartphones', { + performance: 100, + camera: 1, + battery: 100, + display: 100, + design: 100, + value: 100, + }); + assert.match(tinyCameraEncoded, /\bcamera:1\b/); + + // Exact proportion comparison in isDefaultCategoryWeights + assert.equal( + isDefaultCategoryWeights('smartphones', 'custom', { + performance: 40, + camera: 40, + battery: 40, + display: 30, + design: 20, + value: 30, + }), + true, + 'Exact 2x multiple of smartphone default weights collapses cleanly to default' + ); + assert.equal( + isDefaultCategoryWeights('smartphones', 'custom', { + performance: 100, + camera: 99, + battery: 100, + display: 75, + design: 50, + value: 75, + }), + false, + 'Near-default weights with distinct exact proportions retain custom URL state' + ); +} + +console.log('✅ compare params & RTINGS use-case weights'); diff --git a/apps/web/src/lib/__tests__/leaderboard-criteria.test.ts b/apps/web/src/lib/__tests__/leaderboard-criteria.test.ts index c6b3ee23..8f62d50c 100644 --- a/apps/web/src/lib/__tests__/leaderboard-criteria.test.ts +++ b/apps/web/src/lib/__tests__/leaderboard-criteria.test.ts @@ -3224,3 +3224,596 @@ test('an all-bare leaderboard link records the published masters it represents', assert.equal(query.get('variant.acme'), 'acme-retail-1tb'); assert.equal(query.get('variant.peer'), 'peer-512gb'); }); + +test('RTINGS-style UseCaseWeightBar SSR, Official vs Custom Score parity & WCAG 2.1 AA a11y across vi/en/cs (#1864)', () => { + const IntlProvider = + NextIntlClientProvider as unknown as React.ComponentType<{ + locale: string; + messages: Record; + timeZone: string; + children?: React.ReactNode; + }>; + const stubRouter: AppRouterInstance = { + bfcacheId: '', + back: () => {}, + forward: () => {}, + refresh: () => {}, + push: () => {}, + replace: () => {}, + prefetch: () => {}, + }; + + const HTML_ENTITY_MAP: Readonly> = { + amp: '&', + quot: '"', + '#x27': "'", + '#39': "'", + lt: '<', + gt: '>', + }; + + const extractMarkupText = ( + fragment: string, + skipAriaHidden = false + ): string => { + const out: string[] = []; + let hiddenDepth = 0; + let i = 0; + while (i < fragment.length) { + if (fragment[i] === '<') { + let end = i + 1; + let quote: string | null = null; + while (end < fragment.length) { + const ch = fragment[end]!; + if (quote) { + if (ch === quote) quote = null; + } else if (ch === '"' || ch === "'") { + quote = ch; + } else if (ch === '>') { + break; + } + end += 1; + } + const tagInner = fragment.slice(i + 1, end).trim(); + const isClosing = tagInner.startsWith('/'); + const isSelfClosing = tagInner.endsWith('/'); + if (isClosing) { + if (hiddenDepth > 0) hiddenDepth -= 1; + } else if (hiddenDepth > 0) { + if (!isSelfClosing) hiddenDepth += 1; + } else if ( + skipAriaHidden && + /\baria-hidden\s*=\s*(?:"true"|'true')/i.test(tagInner) + ) { + if (!isSelfClosing) hiddenDepth = 1; + } + if (hiddenDepth === 0) out.push(' '); + i = end + 1; + continue; + } + if (hiddenDepth === 0) { + out.push(fragment[i]!); + } + i += 1; + } + return out + .join('') + .replace( + /&(amp|quot|#x27|#39|lt|gt);/g, + (full, key: string) => HTML_ENTITY_MAP[key] ?? full + ) + .replace(/\s+/g, ' ') + .trim(); + }; + + const assertAccessibleControls = (html: string, context: string) => { + assert.doesNotMatch( + html, + /[\u2013\u2014]|—|–/, + `${context}: zero em-dashes or en-dashes` + ); + + const rangeInputs = [ + ...html.matchAll(/]*type="range"[^>]*>/g), + ].map((m) => m[0]); + assert.ok( + rangeInputs.length >= 5, + `${context}: renders category criterion range sliders` + ); + for (const inputTag of rangeInputs) { + const idMatch = /\bid="([^"]+)"/.exec(inputTag); + assert.ok(idMatch?.[1], `${context}: range input must carry an id`); + const escapedId = idMatch[1].replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); + const labelRe = new RegExp( + `]*\\bfor="${escapedId}"[^>]*>([\\s\\S]*?)<\\/label>` + ); + const labelMatch = labelRe.exec(html); + assert.ok( + labelMatch && extractMarkupText(labelMatch[1] ?? '').length > 0, + `${context}: range input #${idMatch[1]} must have a non-empty