kyd-shared-badge 0.3.94 → 0.3.96

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kyd-shared-badge",
-  "version": "0.3.94",
+  "version": "0.3.96",
   "private": false,
   "main": "./src/index.ts",
   "module": "./src/index.ts",

package/src/SharedBadgeDisplay.tsx

@@ -288,7 +288,7 @@ const SharedBadgeDisplay = ({ badgeData, chatProps, headless }: { badgeData: Pub
         <Reveal headless={isHeadless}>
           <div className={'kyd-avoid-break'}>
             <h4 className={'text-2xl font-semibold mb-3'} style={{ color: 'var(--text-main)' }}>Skills Footprint</h4>
-            <SkillsBubble skillsCategoryRadar={graphInsights?.skillsCategoryRadar} headless={isHeadless} />
+            <SkillsBubble skillsCategoryRadar={graphInsights?.skillsCategoryRadar} headless={isHeadless} skillsByCategory={assessmentResult?.graph_insights?.skillsByCategory} skillsMeta={assessmentResult?.graph_insights?.skillsMeta} />
           </div>
         </Reveal>
         <div className={'pt-6 text-sm text-center'} style={{ color: 'var(--text-secondary)' }}>

package/src/components/SkillsBubble.tsx

@@ -4,6 +4,8 @@ import React, { useMemo, useRef, useState, useEffect } from 'react';
 import { BubbleChart } from '@knowyourdeveloper/react-bubble-chart';
 import '@knowyourdeveloper/react-bubble-chart/style.css';
 import { green1, green2, green3, green4, green5 } from '../colors';
+import { ProviderIcon } from '../utils/provider';
+import { providers } from '../types';
 
 type SkillsRadarPoint = {
   axis: string;
@@ -47,23 +49,14 @@ const TooltipBox = ({ state }: { state: HoverTooltipState }) => {
   );
 };
 
-const pickGreenByExperience = (experience: number): string => {
-  const exp = Math.max(0, Math.min(100, Number(experience || 0)));
-  if (exp >= 80) return green1;
-  if (exp >= 60) return green2;
-  if (exp >= 40) return green3;
-  if (exp >= 20) return green4;
-  return green5;
-};
 
-export default function SkillsBubble({ skillsCategoryRadar, skillsByCategory, headless }: { skillsCategoryRadar?: SkillsRadarPoint[]; skillsByCategory?: Record<string, string[]>; headless?: boolean }) {
+export default function SkillsBubble({ skillsCategoryRadar, skillsByCategory, skillsMeta, headless }: { skillsCategoryRadar?: SkillsRadarPoint[]; skillsByCategory?: Record<string, string[]>; skillsMeta?: Record<string, { presence?: 'certified' | 'observed' | 'self-reported'; years?: number; sources?: string[] }>; headless?: boolean }) {
   const hasRadar = !!(skillsCategoryRadar && skillsCategoryRadar.length > 0);
   const skillsRadarLimited = (skillsCategoryRadar || []).slice(0, 24);
   const containerRef = useRef<HTMLDivElement>(null);
   const legendRef = useRef<HTMLDivElement>(null);
   const [legendTooltip, setLegendTooltip] = useState<HoverTooltipState>(null);
   const [activeCategory, setActiveCategory] = useState<string | null>(null);
-
   useEffect(() => {
     if (typeof window !== 'undefined') {
       const id = window.setTimeout(() => {
@@ -73,6 +66,23 @@ export default function SkillsBubble({ skillsCategoryRadar, skillsByCategory, he
     }
   }, []);
 
+  // Tooltip helpers for legend/columns area
+  const computeTooltipPosition = (target: HTMLElement) => {
+    const host = legendRef.current;
+    if (!host) return { x: 0, y: 0 };
+    const rect = target.getBoundingClientRect();
+    const hostRect = host.getBoundingClientRect();
+    const x = rect.left - hostRect.left;
+    const y = rect.bottom - hostRect.top + 6;
+    return { x, y };
+  };
+  const showLegendTooltipAt = (target: EventTarget | null, title: string, body?: string) => {
+    if (!(target instanceof HTMLElement)) return;
+    const { x, y } = computeTooltipPosition(target);
+    setLegendTooltip({ visible: true, x, y, title, body });
+  };
+  const hideLegendTooltip = () => setLegendTooltip(null);
+
   // ratio drives size: average of observed/self_reported/certified
   const bubbles = useMemo(() => {
     const seriesAvg = (d: SkillsRadarPoint): number => {
@@ -128,23 +138,144 @@ export default function SkillsBubble({ skillsCategoryRadar, skillsByCategory, he
   const skillsGrid = useMemo(() => {
     const cat = activeCategory || '';
     const list = (skillsByCategory && cat in (skillsByCategory || {})) ? (skillsByCategory?.[cat] || []) : [];
-    const items = list.slice(0, 10);
+    // Enrich with meta and sort by years desc
+    const enriched = list.map((name) => {
+      const meta = skillsMeta?.[name] || {};
+      const sources = Array.isArray((meta as any).sources) ? (meta as any).sources as string[] : [];
+      return { name, years: Number(meta.years || 0), presence: (meta.presence as string) || '', sources };
+    }).sort((a, b) => b.years - a.years || a.name.localeCompare(b.name));
+    const items = enriched.slice(0, 10);
     const overflow = list.length - items.length;
-    const display: string[] = [];
-    for (let i = 0; i < Math.min(9, items.length); i++) display.push(items[i]);
+    const display: Array<{ label: string; years?: number; presence?: string; sources?: string[] } | ''> = [];
+    for (let i = 0; i < Math.min(9, items.length); i++) {
+      const it = items[i];
+      const label = it.name ? `${it.name}` : '';
+      display.push({ label, years: it.years, presence: it.presence, sources: it.sources });
+    }
     if (list.length > 10) {
-      display.push(`Others (${overflow})`);
+      // Aggregate years and sources for remaining datapoints beyond the top 10
+      const remaining = enriched.slice(10);
+      const aggregatedYears = remaining.reduce((sum, it) => sum + Number(it.years || 0), 0);
+      const aggregatedSourcesSet = new Set<string>();
+      for (const it of remaining) {
+        if (Array.isArray(it.sources)) {
+          for (const src of it.sources) aggregatedSourcesSet.add(String(src));
+        }
+      }
+      const aggregatedSources = Array.from(aggregatedSourcesSet);
+      display.push({ label: `Others (${overflow})`, years: aggregatedYears, sources: aggregatedSources });
     } else if (items.length >= 10) {
-      display.push(items[9]);
+      const it = items[9];
+      display.push({ label: it?.name || '', years: it?.years, presence: it?.presence, sources: it?.sources });
     } else {
-      if (items.length > 9) display.push(items[9]);
+      if (items.length > 9) {
+        const it = items[9];
+        display.push({ label: it?.name || '', years: it?.years, presence: it?.presence, sources: it?.sources });
+      }
     }
     while (display.length < 10) display.push('');
     return display;
-  }, [activeCategory, skillsByCategory]);
+  }, [activeCategory, skillsByCategory, skillsMeta]);
+
+  // Compute category percent share (by ratio) for header display
+  const categoryPercentMap = useMemo(() => {
+    const total = bubbles.reduce((sum, b) => sum + (b.data?.ratio || 0), 0);
+    const map: Record<string, number> = {};
+    for (const b of bubbles) {
+      const p = total > 0 ? Math.round(((b.data?.ratio || 0) / total) * 100) : 0;
+      map[b.label] = p;
+    }
+    return map;
+  }, [bubbles]);
+
+  const presenceColor = (presence?: string) => {
+    const p = String(presence || '').toLowerCase();
+    if (p === 'self-reported') return green5;
+    if (p === 'observed') return green3;
+    if (p === 'certified') return green1;
+    return 'var(--icon-button-secondary)';
+  };
+
+  const presenceTooltipCopy = (presence?: string): { title: string; body: string } => {
+    const p = String(presence || '').toLowerCase();
+    if (p === 'self-reported') return { title: 'Self-reported', body: 'Claims (bios, profiles, resumes).' };
+    if (p === 'observed') return { title: 'Observed', body: 'Evidence directly from code and repos.' };
+    if (p === 'certified') return { title: 'Certified', body: 'Verified by credential issuers.' };
+    return { title: 'Info', body: '' };
+  };
+
+  const leftColumnGrid = useMemo(() => (skillsGrid || []).slice(0, 5), [skillsGrid]);
+  const rightColumnGrid = useMemo(() => (skillsGrid || []).slice(5, 10), [skillsGrid]);
 
   if (!hasRadar) return null;
 
+  const columnComponent = (entry: { label: string; years?: number; presence?: string; sources?: string[] } | '', idx: number, isLeft: boolean) => {
+    return (
+      <div key={idx} className="flex items-stretch justify-between gap-3 min-w-0">
+        <div className="flex flex-col min-w-0 justify-center">
+          <div className="flex items-center gap-2 min-w-0 text-lg text-[var(--text-main)]">
+            <span className={'inline-block h-2 w-2 rounded-full'} style={{ backgroundColor: entry ? 'var(--icon-button-secondary)' : 'transparent', flexShrink: 0 }} />
+            <span className="shrink-0 opacity-70">{idx + (isLeft ? 1 : 6)}.</span>
+            {entry && typeof entry !== 'string' ? (
+              <span className="truncate" title={entry.label}>{entry.label}</span>
+            ) : (
+              <span className="truncate">{typeof entry === 'string' ? entry : '\u00A0'}</span>
+            )}
+          </div>
+          <span className="text-xs text-[var(--text-secondary)] flex flex-wrap items-center gap-1">
+            <span
+              className="underline decoration-dotted underline-offset-2 cursor-help"
+              onMouseEnter={(e) => showLegendTooltipAt(e.currentTarget, 'Sources', 'The source where we observed this skill.')}
+              onMouseLeave={hideLegendTooltip}
+            >
+              Sources
+            </span>:
+            {Array.isArray((entry as any).sources) && (entry as any).sources.length > 0 ? (
+              (() => {
+                const sourceProviders: string[] = ((entry as any).sources as string[]).map((src: string) => {
+                  const str = String(src);
+                  let provider = str.split(':')[0] || '';
+                  if (!provider || provider === str) {
+                    // If split(':')[0] didn't find a delimiter or provider (i.e., no ':'), try split('.')
+                    provider = str.split('.')[0] || '';
+                  }
+                  return provider.toLowerCase();
+                });
+                const uniqueProviders = Array.from(new Set<string>(sourceProviders));
+                const filteredProviders = uniqueProviders.filter((provider) =>
+                  providers.includes(provider.toLowerCase())
+                );
+                return filteredProviders.map((provider) => (
+                  <ProviderIcon key={provider} name={provider} />
+                ));
+              })()
+            ) : null}
+          </span>
+        </div>
+        {entry && typeof entry !== 'string' ? (
+          <div className="flex flex-col items-end leading-tight h-full justify-between text-base">
+            {entry.years ? <span className="whitespace-nowrap text-[var(--text-main)]">{`${entry.years} Years`}</span> : <span className="opacity-0 whitespace-nowrap text-[var(--text-main)]">0 Years</span>}
+            {entry.presence ? (
+              <div className="flex items-center gap-1">
+                <span className="inline-block h-2 w-2 rounded-full text-sm" style={{ background: presenceColor(entry.presence) }} />
+                <span
+                  className="whitespace-nowrap text-sm underline decoration-dotted underline-offset-2 cursor-help"
+                  onMouseEnter={(e) => {
+                    const copy = presenceTooltipCopy(entry.presence);
+                    showLegendTooltipAt(e.currentTarget, copy.title, copy.body);
+                  }}
+                  onMouseLeave={hideLegendTooltip}
+                >
+                  {entry.presence}
+                </span>
+              </div>
+            ) : <span className="opacity-0 whitespace-nowrap">.</span>}
+          </div>
+        ) : null}
+      </div>
+    )
+  }
+
   return (
     <div className={'kyd-avoid-break'}>
       <div ref={containerRef} style={{ width: '100%', height: 340, position: 'relative' }}>
@@ -199,64 +330,46 @@ export default function SkillsBubble({ skillsCategoryRadar, skillsByCategory, he
               (node as HTMLElement).style.color = 'var(--text-main)';
               (node as HTMLElement).style.pointerEvents = 'none';
 
-              const header = document.createElement('div');
-              header.className = 'mb-1';
               const title = document.createElement('div');
               title.className = 'font-medium';
               title.style.color = 'var(--text-main)';
               title.textContent = String(d.displayText || d._id || '');
-              header.appendChild(title);
-
-              const content = document.createElement('div');
-              content.className = 'space-y-1';
-              const ratio = Number(d.value || 0);
-              const experience = Number(d.colorValue || 0);
-
-              const row1 = document.createElement('div');
-              row1.className = 'flex items-center justify-between gap-3';
-              const row1Left = document.createElement('span');
-              row1Left.style.color = 'var(--text-secondary)';
-              row1Left.textContent = 'Ratio';
-              const row1Right = document.createElement('span');
-              row1Right.className = 'font-medium';
-              row1Right.style.color = 'var(--text-main)';
-              row1Right.textContent = `${ratio}%`;
-              row1.appendChild(row1Left);
-              row1.appendChild(row1Right);
-
-              const row2 = document.createElement('div');
-              row2.className = 'flex items-center justify-between gap-3';
-              const row2Left = document.createElement('span');
-              row2Left.style.color = 'var(--text-secondary)';
-              row2Left.textContent = 'Experience';
-              const row2Right = document.createElement('span');
-              row2Right.className = 'font-medium';
-              row2Right.style.color = 'var(--text-main)';
-              row2Right.textContent = String(experience);
-              row2.appendChild(row2Left);
-              row2.appendChild(row2Right);
-
-              content.appendChild(row1);
-              content.appendChild(row2);
-
-              node.appendChild(header);
-              node.appendChild(content);
+              node.appendChild(title);
             } catch {}
           }}
         />
       </div>
-      <div className={'mt-3'}>
+      <div className='mt-8'>
         <div ref={legendRef} className={'kyd-avoid-break'} style={{ position: 'relative', breakInside: 'avoid', pageBreakInside: 'avoid' as unknown as undefined }}>
           <div className="mb-2 text-xs font-medium" style={{ color: 'var(--text-main)' }}>
-            {activeCategory ? `Category: ${activeCategory}` : 'Category'}
+            
+            {activeCategory ? (
+              <span
+                className="ml-1 underline decoration-dotted underline-offset-2 cursor-help"
+                onMouseEnter={(e) =>
+                  showLegendTooltipAt(
+                    e.currentTarget,
+                    'Category share',
+                    'Percent = how focused you are in this category vs others (combined signals).'
+                  )
+                }
+                onMouseLeave={hideLegendTooltip}
+              >
+                <span>{activeCategory ? `Category: ${activeCategory}` : 'Category'}</span> {`• ${categoryPercentMap[activeCategory] ?? 0}%`}
+              </span>
+            ) : null}
           </div>
-          <div className="grid grid-cols-2 gap-x-4 gap-y-1 text-xs" style={{ color: 'var(--text-secondary)', height: 160 }}>
-            {skillsGrid.map((label, idx) => (
-              <div key={idx} className="flex items-center gap-2 min-w-0">
-                <span className={'inline-block h-2 w-2 rounded-full'} style={{ backgroundColor: label ? 'var(--icon-button-secondary)' : 'transparent', flexShrink: 0 }} />
-                <span className="truncate" title={label}>{label || '\u00A0'}</span>
-              </div>
-            ))}
+          <div className="grid grid-cols-2 gap-x-4 text-xs" style={{ color: 'var(--text-secondary)', minHeight: 250 }}>
+            <div className="grid gap-2">
+              {leftColumnGrid.map((entry, idx) => (
+                columnComponent(entry, idx, true)
+              ))}
+            </div>
+            <div className="grid gap-2">
+              {rightColumnGrid.map((entry, idx) => (
+                columnComponent(entry, idx, false)
+              ))}
+            </div>
           </div>
           {!headless && <TooltipBox state={legendTooltip} />}
         </div>

package/src/types.ts

@@ -1,3 +1,20 @@
+export const providers = [
+  'github',
+  'gitlab',
+  'credly',
+  'fiverr',
+  'kaggle',
+  'google_scholar',
+  'stackoverflow',
+  'linkedin',
+  'toptal',
+  'coursera',
+  'udemy',
+]
+
+export type ProviderNames = typeof providers;
+
+
 export type Provider = {
   id: string;
   name: string;
@@ -383,6 +400,8 @@ export interface GraphInsightsPayload {
   }>;
   // New: mapping of category -> list of skills contributing to that category
   skillsByCategory?: Record<string, string[]>;
+  // New: per-skill metadata used by UI (e.g., presence label, experience years)
+  skillsMeta?: Record<string, { presence?: 'certified' | 'observed' | 'self-reported'; years?: number; sources?: string[] }>; 
   // New: Flattened list of business rule selections (for appendix)
   business_rules_all?: Array<{
     provider: string;