Anki maturity-based known-word highlighting (#172)

src/types/anki.ts

@@ -82,6 +82,8 @@ export interface AnkiConnectConfig {
   };
   knownWords?: {
     highlightEnabled?: boolean;
+    maturityEnabled?: boolean;
+    matureThresholdDays?: number;
     refreshMinutes?: number;
     addMinedWordsImmediately?: boolean;
     matchMode?: NPlusOneMatchMode;

src/types/config.ts

@@ -254,6 +254,8 @@ export interface ResolvedConfig {
     };
     knownWords: {
       highlightEnabled: boolean;
+      maturityEnabled: boolean;
+      matureThresholdDays: number;
       refreshMinutes: number;
       addMinedWordsImmediately: boolean;
       matchMode: NPlusOneMatchMode;

src/types/runtime-options.ts

@@ -1,6 +1,7 @@
 export type RuntimeOptionId =
   | 'anki.autoUpdateNewCards'
   | 'subtitle.annotation.knownWords.highlightEnabled'
+  | 'subtitle.annotation.knownWords.maturityEnabled'
   | 'subtitle.annotation.nPlusOne'
   | 'subtitle.annotation.jlpt'
   | 'subtitle.annotation.frequency'

src/types/subtitle.ts

@@ -39,6 +39,8 @@ export interface MergedToken {
   pos3?: string;
   isMerged: boolean;
   isKnown: boolean;
+  /** Anki card maturity for a known token; unset when tier data is unavailable. */
+  knownMaturity?: KnownWordMaturityTier;
   isNPlusOneTarget: boolean;
   /**
    * Text Yomitan had no dictionary entry for (e.g. ぅ～ elongation runs,
@@ -61,6 +63,9 @@ export type FrequencyDictionaryLookup = (term: string) => number | null;
 
 export type JlptLevel = 'N1' | 'N2' | 'N3' | 'N4' | 'N5';
 
+/** Anki card maturity tier for a known word, most mature card wins. */
+export type KnownWordMaturityTier = 'new' | 'learning' | 'young' | 'mature';
+
 export interface SubtitlePosition {
   yPercent: number;
 }
@@ -112,6 +117,12 @@ export interface SubtitleStyleConfig {
   backgroundColor?: string;
   nPlusOneColor?: string;
   knownWordColor?: string;
+  knownWordMaturityColors?: {
+    new: string;
+    learning: string;
+    young: string;
+    mature: string;
+  };
   jlptColors?: {
     N1: string;
     N2: string;