feat: add AniList character dictionary sync

launcher/config/args-normalizer.ts

@@ -1,4 +1,5 @@
 import fs from 'node:fs';
+import path from 'node:path';
 import { fail } from '../log.js';
 import type {
   Args,
@@ -68,6 +69,27 @@ function parseBackend(value: string): Backend {
   fail(`Invalid backend: ${value} (must be auto, hyprland, x11, or macos)`);
 }
 
+function parseDictionaryTarget(value: string): string {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    fail('Dictionary target path is required.');
+  }
+  if (isUrlTarget(trimmed)) {
+    fail('Dictionary target must be a local file or directory path, not a URL.');
+  }
+  const resolved = path.resolve(resolvePathMaybe(trimmed));
+  let stat: fs.Stats | null = null;
+  try {
+    stat = fs.statSync(resolved);
+  } catch {
+    stat = null;
+  }
+  if (!stat || (!stat.isFile() && !stat.isDirectory())) {
+    fail(`Dictionary target path must be an existing file or directory: ${trimmed}`);
+  }
+  return resolved;
+}
+
 export function createDefaultArgs(launcherConfig: LauncherYoutubeSubgenConfig): Args {
   const envMode = (process.env.SUBMINER_YT_SUBGEN_MODE || '').toLowerCase();
   const defaultMode: YoutubeSubgenMode =
@@ -114,6 +136,7 @@ export function createDefaultArgs(launcherConfig: LauncherYoutubeSubgenConfig):
     jellyfinLogout: false,
     jellyfinPlay: false,
     jellyfinDiscovery: false,
+    dictionary: false,
     doctor: false,
     configPath: false,
     configShow: false,
@@ -170,6 +193,10 @@ export function applyRootOptionsToArgs(
 }
 
 export function applyInvocationsToArgs(parsed: Args, invocations: CliInvocations): void {
+  if (invocations.dictionaryTriggered) parsed.dictionary = true;
+  if (invocations.dictionaryTarget) {
+    parsed.dictionaryTarget = parseDictionaryTarget(invocations.dictionaryTarget);
+  }
   if (invocations.doctorTriggered) parsed.doctor = true;
   if (invocations.texthookerTriggered) parsed.texthookerOnly = true;
 
@@ -230,6 +257,10 @@ export function applyInvocationsToArgs(parsed: Args, invocations: CliInvocations
     if (invocations.ytInvocation.target) ensureTarget(invocations.ytInvocation.target, parsed);
   }
 
+  if (invocations.dictionaryLogLevel) {
+    parsed.logLevel = parseLogLevel(invocations.dictionaryLogLevel);
+  }
+
   if (invocations.doctorLogLevel) parsed.logLevel = parseLogLevel(invocations.doctorLogLevel);
   if (invocations.texthookerLogLevel)
     parsed.logLevel = parseLogLevel(invocations.texthookerLogLevel);

launcher/config/cli-parser-builder.ts

@@ -36,6 +36,9 @@ export interface CliInvocations {
   configInvocation: CommandActionInvocation | null;
   mpvInvocation: CommandActionInvocation | null;
   appInvocation: { appArgs: string[] } | null;
+  dictionaryTriggered: boolean;
+  dictionaryTarget: string | null;
+  dictionaryLogLevel: string | null;
   doctorTriggered: boolean;
   doctorLogLevel: string | null;
   texthookerTriggered: boolean;
@@ -81,6 +84,8 @@ function getTopLevelCommand(argv: string[]): { name: string; index: number } | n
     'doctor',
     'config',
     'mpv',
+    'dictionary',
+    'dict',
     'texthooker',
     'app',
     'bin',
@@ -128,6 +133,9 @@ export function parseCliPrograms(
   let configInvocation: CommandActionInvocation | null = null;
   let mpvInvocation: CommandActionInvocation | null = null;
   let appInvocation: { appArgs: string[] } | null = null;
+  let dictionaryTriggered = false;
+  let dictionaryTarget: string | null = null;
+  let dictionaryLogLevel: string | null = null;
   let doctorLogLevel: string | null = null;
   let texthookerLogLevel: string | null = null;
   let doctorTriggered = false;
@@ -214,6 +222,18 @@ export function parseCliPrograms(
       };
     });
 
+  commandProgram
+    .command('dictionary')
+    .alias('dict')
+    .description('Generate character dictionary ZIP from a file or directory target')
+    .argument('<target>', 'Video file path or anime directory path')
+    .option('--log-level <level>', 'Log level')
+    .action((target: string, options: Record<string, unknown>) => {
+      dictionaryTriggered = true;
+      dictionaryTarget = target;
+      dictionaryLogLevel = typeof options.logLevel === 'string' ? options.logLevel : null;
+    });
+
   commandProgram
     .command('doctor')
     .description('Run dependency and environment checks')
@@ -289,6 +309,9 @@ export function parseCliPrograms(
       configInvocation,
       mpvInvocation,
       appInvocation,
+      dictionaryTriggered,
+      dictionaryTarget,
+      dictionaryLogLevel,
       doctorTriggered,
       doctorLogLevel,
       texthookerTriggered,