feat: add AniList character dictionary sync

src/config/config.test.ts

@@ -19,6 +19,11 @@ test('loads defaults when config is missing', () => {
   assert.equal(config.ankiConnect.behavior.autoUpdateNewCards, true);
   assert.deepEqual(config.ankiConnect.tags, ['SubMiner']);
   assert.equal(config.anilist.enabled, false);
+  assert.equal(config.anilist.characterDictionary.enabled, false);
+  assert.equal(config.anilist.characterDictionary.refreshTtlHours, 168);
+  assert.equal(config.anilist.characterDictionary.maxLoaded, 3);
+  assert.equal(config.anilist.characterDictionary.evictionPolicy, 'delete');
+  assert.equal(config.anilist.characterDictionary.profileScope, 'all');
   assert.equal(config.jellyfin.remoteControlEnabled, true);
   assert.equal(config.jellyfin.remoteControlAutoConnect, true);
   assert.equal(config.jellyfin.autoAnnounce, false);
@@ -298,6 +303,39 @@ test('parses anilist.enabled and warns for invalid value', () => {
   assert.equal(service.getConfig().anilist.enabled, true);
 });
 
+test('parses anilist.characterDictionary config with clamping and enum validation', () => {
+  const dir = makeTempDir();
+  fs.writeFileSync(
+    path.join(dir, 'config.jsonc'),
+    `{
+      "anilist": {
+        "characterDictionary": {
+          "enabled": true,
+          "refreshTtlHours": 0,
+          "maxLoaded": 1000,
+          "evictionPolicy": "remove",
+          "profileScope": "everywhere"
+        }
+      }
+    }`,
+    'utf-8',
+  );
+
+  const service = new ConfigService(dir);
+  const config = service.getConfig();
+  const warnings = service.getWarnings();
+
+  assert.equal(config.anilist.characterDictionary.enabled, true);
+  assert.equal(config.anilist.characterDictionary.refreshTtlHours, 1);
+  assert.equal(config.anilist.characterDictionary.maxLoaded, 20);
+  assert.equal(config.anilist.characterDictionary.evictionPolicy, 'delete');
+  assert.equal(config.anilist.characterDictionary.profileScope, 'all');
+  assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.refreshTtlHours'));
+  assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.maxLoaded'));
+  assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.evictionPolicy'));
+  assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.profileScope'));
+});
+
 test('parses jellyfin remote control fields', () => {
   const dir = makeTempDir();
   fs.writeFileSync(
@@ -1292,6 +1330,7 @@ test('template generator includes known keys', () => {
   assert.match(output, /"discordPresence":/);
   assert.match(output, /"startupWarmups":/);
   assert.match(output, /"youtubeSubgen":/);
+  assert.match(output, /"characterDictionary":\s*\{/);
   assert.match(output, /"preserveLineBreaks": false/);
   assert.match(output, /"nPlusOne"\s*:\s*\{/);
   assert.match(output, /"nPlusOne": "#c6a0f6"/);

src/config/definitions/defaults-integrations.ts

@@ -86,6 +86,13 @@ export const INTEGRATIONS_DEFAULT_CONFIG: Pick<
   anilist: {
     enabled: false,
     accessToken: '',
+    characterDictionary: {
+      enabled: false,
+      refreshTtlHours: 168,
+      maxLoaded: 3,
+      evictionPolicy: 'delete',
+      profileScope: 'all',
+    },
   },
   jellyfin: {
     enabled: false,

src/config/definitions/domain-registry.test.ts

@@ -22,6 +22,7 @@ test('config option registry includes critical paths and has unique entries', ()
     'subtitleStyle.enableJlpt',
     'subtitleStyle.autoPauseVideoOnYomitanPopup',
     'ankiConnect.enabled',
+    'anilist.characterDictionary.enabled',
     'immersionTracking.enabled',
   ]) {
     assert.ok(paths.includes(requiredPath), `missing config path: ${requiredPath}`);

src/config/definitions/options-integrations.ts

@@ -135,6 +135,39 @@ export function buildIntegrationConfigOptionRegistry(
       description:
         'Optional explicit AniList access token override; leave empty to use locally stored token from setup.',
     },
+    {
+      path: 'anilist.characterDictionary.enabled',
+      kind: 'boolean',
+      defaultValue: defaultConfig.anilist.characterDictionary.enabled,
+      description:
+        'Enable automatic Yomitan character dictionary sync for currently watched AniList media.',
+    },
+    {
+      path: 'anilist.characterDictionary.refreshTtlHours',
+      kind: 'number',
+      defaultValue: defaultConfig.anilist.characterDictionary.refreshTtlHours,
+      description: 'TTL in hours before refreshing the currently watched media dictionary.',
+    },
+    {
+      path: 'anilist.characterDictionary.maxLoaded',
+      kind: 'number',
+      defaultValue: defaultConfig.anilist.characterDictionary.maxLoaded,
+      description: 'Maximum number of auto-synced AniList dictionaries kept loaded at once.',
+    },
+    {
+      path: 'anilist.characterDictionary.evictionPolicy',
+      kind: 'enum',
+      enumValues: ['disable', 'delete'],
+      defaultValue: defaultConfig.anilist.characterDictionary.evictionPolicy,
+      description: 'Eviction behavior when maxLoaded is exceeded.',
+    },
+    {
+      path: 'anilist.characterDictionary.profileScope',
+      kind: 'enum',
+      enumValues: ['all', 'active'],
+      defaultValue: defaultConfig.anilist.characterDictionary.profileScope,
+      description: 'Yomitan profile scope for dictionary enable/disable updates.',
+    },
     {
       path: 'jellyfin.enabled',
       kind: 'boolean',

src/config/definitions/template-sections.ts

@@ -104,7 +104,11 @@ const INTEGRATION_TEMPLATE_SECTIONS: ConfigTemplateSection[] = [
   },
   {
     title: 'Anilist',
-    description: ['Anilist API credentials and update behavior.'],
+    description: [
+      'Anilist API credentials and update behavior.',
+      'Includes optional auto-sync for per-media character dictionaries in bundled Yomitan.',
+      'Character dictionaries are keyed by AniList media ID (no season/franchise merge).',
+    ],
     key: 'anilist',
   },
   {

src/config/resolve/integrations.ts

@@ -23,6 +23,115 @@ export function applyIntegrationConfig(context: ResolveContext): void {
         'Expected string.',
       );
     }
+
+    if (isObject(src.anilist.characterDictionary)) {
+      const characterDictionary = src.anilist.characterDictionary;
+
+      const dictionaryEnabled = asBoolean(characterDictionary.enabled);
+      if (dictionaryEnabled !== undefined) {
+        resolved.anilist.characterDictionary.enabled = dictionaryEnabled;
+      } else if (characterDictionary.enabled !== undefined) {
+        warn(
+          'anilist.characterDictionary.enabled',
+          characterDictionary.enabled,
+          resolved.anilist.characterDictionary.enabled,
+          'Expected boolean.',
+        );
+      }
+
+      const refreshTtlHours = asNumber(characterDictionary.refreshTtlHours);
+      if (refreshTtlHours !== undefined) {
+        const normalized = Math.min(24 * 365, Math.max(1, Math.floor(refreshTtlHours)));
+        if (normalized !== refreshTtlHours) {
+          warn(
+            'anilist.characterDictionary.refreshTtlHours',
+            characterDictionary.refreshTtlHours,
+            normalized,
+            'Out of range; clamped to 1..8760 hours.',
+          );
+        }
+        resolved.anilist.characterDictionary.refreshTtlHours = normalized;
+      } else if (characterDictionary.refreshTtlHours !== undefined) {
+        warn(
+          'anilist.characterDictionary.refreshTtlHours',
+          characterDictionary.refreshTtlHours,
+          resolved.anilist.characterDictionary.refreshTtlHours,
+          'Expected number.',
+        );
+      }
+
+      const maxLoaded = asNumber(characterDictionary.maxLoaded);
+      if (maxLoaded !== undefined) {
+        const normalized = Math.min(20, Math.max(1, Math.floor(maxLoaded)));
+        if (normalized !== maxLoaded) {
+          warn(
+            'anilist.characterDictionary.maxLoaded',
+            characterDictionary.maxLoaded,
+            normalized,
+            'Out of range; clamped to 1..20.',
+          );
+        }
+        resolved.anilist.characterDictionary.maxLoaded = normalized;
+      } else if (characterDictionary.maxLoaded !== undefined) {
+        warn(
+          'anilist.characterDictionary.maxLoaded',
+          characterDictionary.maxLoaded,
+          resolved.anilist.characterDictionary.maxLoaded,
+          'Expected number.',
+        );
+      }
+
+      const evictionPolicyRaw = asString(characterDictionary.evictionPolicy);
+      if (evictionPolicyRaw !== undefined) {
+        const evictionPolicy = evictionPolicyRaw.trim().toLowerCase();
+        if (evictionPolicy === 'disable' || evictionPolicy === 'delete') {
+          resolved.anilist.characterDictionary.evictionPolicy = evictionPolicy;
+        } else {
+          warn(
+            'anilist.characterDictionary.evictionPolicy',
+            characterDictionary.evictionPolicy,
+            resolved.anilist.characterDictionary.evictionPolicy,
+            "Expected one of: 'disable', 'delete'.",
+          );
+        }
+      } else if (characterDictionary.evictionPolicy !== undefined) {
+        warn(
+          'anilist.characterDictionary.evictionPolicy',
+          characterDictionary.evictionPolicy,
+          resolved.anilist.characterDictionary.evictionPolicy,
+          'Expected string.',
+        );
+      }
+
+      const profileScopeRaw = asString(characterDictionary.profileScope);
+      if (profileScopeRaw !== undefined) {
+        const profileScope = profileScopeRaw.trim().toLowerCase();
+        if (profileScope === 'all' || profileScope === 'active') {
+          resolved.anilist.characterDictionary.profileScope = profileScope;
+        } else {
+          warn(
+            'anilist.characterDictionary.profileScope',
+            characterDictionary.profileScope,
+            resolved.anilist.characterDictionary.profileScope,
+            "Expected one of: 'all', 'active'.",
+          );
+        }
+      } else if (characterDictionary.profileScope !== undefined) {
+        warn(
+          'anilist.characterDictionary.profileScope',
+          characterDictionary.profileScope,
+          resolved.anilist.characterDictionary.profileScope,
+          'Expected string.',
+        );
+      }
+    } else if (src.anilist.characterDictionary !== undefined) {
+      warn(
+        'anilist.characterDictionary',
+        src.anilist.characterDictionary,
+        resolved.anilist.characterDictionary,
+        'Expected object.',
+      );
+    }
   }
 
   if (isObject(src.jellyfin)) {

src/config/resolve/jellyfin.test.ts

@@ -62,3 +62,31 @@ test('discordPresence invalid values warn and keep defaults', () => {
   assert.ok(warnedPaths.includes('discordPresence.updateIntervalMs'));
   assert.ok(warnedPaths.includes('discordPresence.debounceMs'));
 });
+
+test('anilist character dictionary fields are parsed, clamped, and enum-validated', () => {
+  const { context, warnings } = createResolveContext({
+    anilist: {
+      characterDictionary: {
+        enabled: true,
+        refreshTtlHours: 0,
+        maxLoaded: 99,
+        evictionPolicy: 'purge' as never,
+        profileScope: 'global' as never,
+      },
+    },
+  });
+
+  applyIntegrationConfig(context);
+
+  assert.equal(context.resolved.anilist.characterDictionary.enabled, true);
+  assert.equal(context.resolved.anilist.characterDictionary.refreshTtlHours, 1);
+  assert.equal(context.resolved.anilist.characterDictionary.maxLoaded, 20);
+  assert.equal(context.resolved.anilist.characterDictionary.evictionPolicy, 'delete');
+  assert.equal(context.resolved.anilist.characterDictionary.profileScope, 'all');
+
+  const warnedPaths = warnings.map((warning) => warning.path);
+  assert.ok(warnedPaths.includes('anilist.characterDictionary.refreshTtlHours'));
+  assert.ok(warnedPaths.includes('anilist.characterDictionary.maxLoaded'));
+  assert.ok(warnedPaths.includes('anilist.characterDictionary.evictionPolicy'));
+  assert.ok(warnedPaths.includes('anilist.characterDictionary.profileScope'));
+});