From 4a01cebca6157152e1d039a8a145f893d69e71fa Mon Sep 17 00:00:00 2001
From: sudacode <suda@sudacode.com>
Date: Thu, 19 Mar 2026 23:48:37 -0700
Subject: [PATCH] feat(stats): rename all token display text to words

Replace every user-facing "token(s)" label, tooltip, and message in the
stats UI with "words" so the terminology is consistent and friendlier
(e.g. "Words Seen", "word occurrences", "3.4 / 100 words", "Words Today").

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 stats/src/components/anime/AnimeOverviewStats.tsx  |  8 ++++----
 stats/src/components/anime/EpisodeDetail.tsx       |  2 +-
 stats/src/components/library/MediaHeader.tsx       |  4 ++--
 stats/src/components/overview/RecentSessions.tsx   |  6 +++---
 stats/src/components/overview/TrackingSnapshot.tsx |  6 +++---
 stats/src/components/sessions/SessionDetail.tsx    | 10 +++++-----
 stats/src/components/sessions/SessionRow.tsx       |  2 +-
 stats/src/lib/yomitan-lookup.ts                    |  4 ++--
 8 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/stats/src/components/anime/AnimeOverviewStats.tsx b/stats/src/components/anime/AnimeOverviewStats.tsx
index f4c8fc9..434a6a0 100644
--- a/stats/src/components/anime/AnimeOverviewStats.tsx
+++ b/stats/src/components/anime/AnimeOverviewStats.tsx
@@ -68,10 +68,10 @@ export function AnimeOverviewStats({ detail, knownWordsSummary }: AnimeOverviewS
           tooltip="Number of completed episodes for this anime"
         />
         <Metric
-          label="Tokens Seen"
+          label="Words Seen"
           value={formatNumber(detail.totalTokensSeen)}
           color="text-ctp-mauve"
-          tooltip="Total token occurrences across all sessions"
+          tooltip="Total word occurrences across all sessions"
         />
       </div>
 
@@ -94,7 +94,7 @@ export function AnimeOverviewStats({ detail, knownWordsSummary }: AnimeOverviewS
             label="Lookup Rate"
             value={lookupRate.shortValue}
             color="text-ctp-sapphire"
-            tooltip="Yomitan lookups per 100 tokens seen"
+            tooltip="Yomitan lookups per 100 words seen"
           />
         ) : (
           <Metric
@@ -116,7 +116,7 @@ export function AnimeOverviewStats({ detail, knownWordsSummary }: AnimeOverviewS
             label="Known Words"
             value="—"
             color="text-ctp-overlay2"
-            tooltip="No token data available yet"
+            tooltip="No word data available yet"
           />
         )}
       </div>
diff --git a/stats/src/components/anime/EpisodeDetail.tsx b/stats/src/components/anime/EpisodeDetail.tsx
index cac0820..5415f6c 100644
--- a/stats/src/components/anime/EpisodeDetail.tsx
+++ b/stats/src/components/anime/EpisodeDetail.tsx
@@ -86,7 +86,7 @@ export function EpisodeDetail({ videoId, onSessionDeleted }: EpisodeDetailProps)
                 <span className="text-ctp-blue">{formatDuration(s.activeWatchedMs)}</span>
                 <span className="text-ctp-cards-mined">{formatNumber(s.cardsMined)} cards</span>
                 <span className="text-ctp-peach">
-                  {formatNumber(getSessionDisplayWordCount(s))} tokens
+                  {formatNumber(getSessionDisplayWordCount(s))} words
                 </span>
                 <span className="text-ctp-green">{formatNumber(s.knownWordsSeen)} known words</span>
                 <button
diff --git a/stats/src/components/library/MediaHeader.tsx b/stats/src/components/library/MediaHeader.tsx
index 5ce1319..34391d1 100644
--- a/stats/src/components/library/MediaHeader.tsx
+++ b/stats/src/components/library/MediaHeader.tsx
@@ -62,7 +62,7 @@ export function MediaHeader({ detail, initialKnownWordsSummary = null }: MediaHe
           </div>
           <div>
             <div className="text-ctp-mauve font-medium">{formatNumber(detail.totalTokensSeen)}</div>
-            <div className="text-xs text-ctp-overlay2">token occurrences</div>
+            <div className="text-xs text-ctp-overlay2">word occurrences</div>
           </div>
           <div>
             <div className="text-ctp-lavender font-medium">
@@ -95,7 +95,7 @@ export function MediaHeader({ detail, initialKnownWordsSummary = null }: MediaHe
           ) : (
             <div>
               <div className="text-ctp-peach font-medium">{formatPercent(knownTokenRate)}</div>
-              <div className="text-xs text-ctp-overlay2">known token match rate</div>
+              <div className="text-xs text-ctp-overlay2">known word match rate</div>
             </div>
           )}
           <div>
diff --git a/stats/src/components/overview/RecentSessions.tsx b/stats/src/components/overview/RecentSessions.tsx
index c4e6033..92a3244 100644
--- a/stats/src/components/overview/RecentSessions.tsx
+++ b/stats/src/components/overview/RecentSessions.tsx
@@ -174,7 +174,7 @@ function SessionItem({
             <div className="text-ctp-mauve font-medium font-mono tabular-nums">
               {formatNumber(displayWordCount)}
             </div>
-            <div className="text-ctp-overlay2">tokens</div>
+            <div className="text-ctp-overlay2">words</div>
           </div>
           <div>
             <div className="text-ctp-green font-medium font-mono tabular-nums">
@@ -265,7 +265,7 @@ function AnimeGroupRow({
               <div className="text-ctp-mauve font-medium font-mono tabular-nums">
                 {formatNumber(group.totalWords)}
               </div>
-              <div className="text-ctp-overlay2">tokens</div>
+              <div className="text-ctp-overlay2">words</div>
             </div>
             <div>
               <div className="text-ctp-green font-medium font-mono tabular-nums">
@@ -340,7 +340,7 @@ function AnimeGroupRow({
                       <div className="text-ctp-mauve font-medium font-mono tabular-nums">
                         {formatNumber(getSessionDisplayWordCount(s))}
                       </div>
-                      <div className="text-ctp-overlay2">tokens</div>
+                      <div className="text-ctp-overlay2">words</div>
                     </div>
                     <div>
                       <div className="text-ctp-green font-medium font-mono tabular-nums">
diff --git a/stats/src/components/overview/TrackingSnapshot.tsx b/stats/src/components/overview/TrackingSnapshot.tsx
index e887d85..dd8bde0 100644
--- a/stats/src/components/overview/TrackingSnapshot.tsx
+++ b/stats/src/components/overview/TrackingSnapshot.tsx
@@ -95,7 +95,7 @@ export function TrackingSnapshot({
             </div>
           </div>
         </Tooltip>
-        <Tooltip text="Lifetime Yomitan lookups normalized by total tokens seen">
+        <Tooltip text="Lifetime Yomitan lookups normalized by total words seen">
           <div className="rounded-lg bg-ctp-surface1/60 p-3">
             <div className="text-xs uppercase tracking-wide text-ctp-overlay2">Lookup Rate</div>
             <div className="mt-1 text-xl font-semibold font-mono tabular-nums text-ctp-flamingo">
@@ -103,9 +103,9 @@ export function TrackingSnapshot({
             </div>
           </div>
         </Tooltip>
-        <Tooltip text="Total token occurrences encountered in today's sessions">
+        <Tooltip text="Total word occurrences encountered in today's sessions">
           <div className="rounded-lg bg-ctp-surface1/60 p-3">
-            <div className="text-xs uppercase tracking-wide text-ctp-overlay2">Tokens Today</div>
+            <div className="text-xs uppercase tracking-wide text-ctp-overlay2">Words Today</div>
             <div className="mt-1 text-xl font-semibold font-mono tabular-nums text-ctp-sky">
               {formatNumber(summary.todayTokens)}
             </div>
diff --git a/stats/src/components/sessions/SessionDetail.tsx b/stats/src/components/sessions/SessionDetail.tsx
index fdf8499..2eb0263 100644
--- a/stats/src/components/sessions/SessionDetail.tsx
+++ b/stats/src/components/sessions/SessionDetail.tsx
@@ -333,7 +333,7 @@ function RatioView({
   }
 
   if (chartData.length === 0) {
-    return <div className="text-ctp-overlay2 text-xs p-2">No token data for this session.</div>;
+    return <div className="text-ctp-overlay2 text-xs p-2">No word data for this session.</div>;
   }
 
   const tsMin = chartData[0]!.tsMs;
@@ -522,7 +522,7 @@ function RatioView({
 
       {/* ── Bottom: Token accumulation sparkline ── */}
       <div className="flex items-center gap-2 border-t border-ctp-surface1 pt-1">
-        <span className="text-[9px] text-ctp-overlay0 whitespace-nowrap">total tokens</span>
+        <span className="text-[9px] text-ctp-overlay0 whitespace-nowrap">total words</span>
         <div className="flex-1 h-[28px]">
           <ResponsiveContainer width="100%" height={28}>
             <LineChart data={sparkData}>
@@ -608,7 +608,7 @@ function FallbackView({
   }
 
   if (chartData.length === 0) {
-    return <div className="text-ctp-overlay2 text-xs p-2">No token data for this session.</div>;
+    return <div className="text-ctp-overlay2 text-xs p-2">No word data for this session.</div>;
   }
 
   const tsMin = chartData[0]!.tsMs;
@@ -654,7 +654,7 @@ function FallbackView({
             <Tooltip
               contentStyle={tooltipStyle}
               labelFormatter={formatTime}
-              formatter={(value: number) => [`${value.toLocaleString()}`, 'Total tokens']}
+              formatter={(value: number) => [`${value.toLocaleString()}`, 'Total words']}
             />
 
             {pauseRegions.map((r, i) => (
@@ -711,7 +711,7 @@ function FallbackView({
               strokeWidth={1.5}
               dot={false}
               activeDot={{ r: 3, fill: '#8aadf4', stroke: '#1e2030', strokeWidth: 1 }}
-              name="Total tokens"
+              name="Total words"
               type="monotone"
               isAnimationActive={false}
             />
diff --git a/stats/src/components/sessions/SessionRow.tsx b/stats/src/components/sessions/SessionRow.tsx
index 1d4d503..b3aaea9 100644
--- a/stats/src/components/sessions/SessionRow.tsx
+++ b/stats/src/components/sessions/SessionRow.tsx
@@ -96,7 +96,7 @@ export function SessionRow({
             <div className="text-ctp-mauve font-medium font-mono tabular-nums">
               {formatNumber(displayWordCount)}
             </div>
-            <div className="text-ctp-overlay2">tokens</div>
+            <div className="text-ctp-overlay2">words</div>
           </div>
           <div>
             <div className="text-ctp-green font-medium font-mono tabular-nums">
diff --git a/stats/src/lib/yomitan-lookup.ts b/stats/src/lib/yomitan-lookup.ts
index db8e769..e2e120a 100644
--- a/stats/src/lib/yomitan-lookup.ts
+++ b/stats/src/lib/yomitan-lookup.ts
@@ -15,8 +15,8 @@ export function buildLookupRateDisplay(
   }
   const per100 = ((Math.max(0, yomitanLookupCount) / tokensSeen) * 100).toFixed(1);
   return {
-    shortValue: `${per100} / 100 tokens`,
-    longValue: `${per100} lookups per 100 tokens`,
+    shortValue: `${per100} / 100 words`,
+    longValue: `${per100} lookups per 100 words`,
   };
 }