@vectoriox/iox-ui 5.50.0 → 5.52.0

package/src/harness-core/rank.ts

@@ -5,6 +5,7 @@ import type { AnimateId } from '@vectoriox/iox-ui/design-core';
 
 import { AvoidRule, BUSINESS_TYPES, BusinessType, isLookRule, LookRule, userAvoidRule } from './business-types';
 import { lookMatches, presetLook } from './look';
+import { AnalysisLocale } from './site-analysis';
 
 /**
  * Which styles suit a business, best first (AI plan rev 3 §3f, H3) — Design ▸ Look's order. Pure and
@@ -45,6 +46,8 @@ export interface RankedPreset {
     reasonKind: RankReason;
     /** In English, from the contract (the UI may localise `reasonKind` + `sharedMoods` instead). */
     reason: string;
+    /** A good fit's reason in Hebrew (the contract has Hebrew for good fits; `presetReason` picks). */
+    reasonHe?: string;
     sharedMoods: MoodId[];
     /** Catalogue position — ties keep it. */
     order: number;
@@ -113,10 +116,23 @@ export function rankStylePresets(
             : goodAt >= 0 && type ? [RankReason.GoodFit, type.good[goodAt].reason]
             : sharedMoods.length ? [RankReason.SharedMoods, moodsLine(sharedMoods)]
             : [RankReason.None, ''];
-        return { id: preset.id, fit, score, reasonKind, reason, sharedMoods, order };
+        const reasonHe = reasonKind === RankReason.GoodFit && type ? type.good[goodAt].reasonHe : undefined;
+        return { id: preset.id, fit, score, reasonKind, reason, ...(reasonHe ? { reasonHe } : {}), sharedMoods, order };
     }).sort((a, b) => b.score - a.score || a.order - b.order);
 }
 
+/**
+ * The line a style's card shows (its title): why it sits where it does, else what the style is — in the studio's
+ * language where the contract has it. Decided 2026-10-25: good fits and descriptions have Hebrew (the name stays a
+ * proper name); a type's or the owner's advice and the shared-moods line are English in the contract yet.
+ */
+export function presetReason(ranked: RankedPreset, preset: StylePreset | undefined, locale: string | null | undefined): string {
+    const hebrew = locale === AnalysisLocale.He;
+    if (hebrew && ranked.reasonKind === RankReason.GoodFit && ranked.reasonHe) return ranked.reasonHe;
+    if (ranked.reason) return ranked.reason;
+    return (hebrew ? preset?.blurbHe : preset?.blurb) ?? '';
+}
+
 // ── References: a reading of pictures or a site, as style (plan §3k, R4) ─────────────────────────────────
 export enum StyleReadSourceKind {
     Image = 'image',