@xnlc/types: единый источник типов для Xneon Launcher Core

@xnlc:registry=https://git.xneon.org/api/packages/MAINER4IK/npm/

pnpm add -D @xnlc/types

import type {
  // Domain
  DbAccount, DbBuild, DbBuildLight,
  // Laby
  LabySkin, LabyCatalogPage,
  // Mod
  ModSearchResult, ModDetails,
  // IPC
  IpcInvokeMap, IpcEventMap, ElectronAPI,
  // Launch
  MinecraftLaunchParams, LaunchRequestOptions,
  // Worker
  WorkerLaunchPayload, WorkerMessage,
  // Server
  McServerInfo, McServerState, XnConnectState,
} from "@xnlc/types";

export interface IpcInvokeMap {
  "system:get-total-memory": { args: []; return: number }
  "auth:microsoft-login": { args: []; return: AuthPayload }
  "minecraft:launch": { args: [params: MinecraftLaunchParams]; return: { success: boolean; error?: string } }
  "mods:modrinth-search": { args: [query, contentType?, gameVersion?, modLoader?, sortBy?, page?, categories?]; return: ModSearchResponse }
  // ... и ~120+ каналов
}

export interface IpcEventMap {
  "minecraft:java-progress": JavaProgress
  "minecraft:download-progress": MinecraftProgress
  "minecraft:close": MinecraftCloseInfo
  "mc-server:log": { id: string; line: string }
  "mc-server:state-change": { id: string; state: McServerState }
  "mc-server:metrics": { id: string; metrics: McServerMetrics }
  "xn-connect:usage-updated": XnConnectUsage
  "xn-connect:state": { serverId: string; state: XnConnectState }
  "ai:stream-chunk": { requestId: string; content: string }
  "ai:stream-done": { requestId: string; fullText: string }
  "ai:stream-error": { requestId: string; error: string }
  "update:status": { status, version?, releaseDate?, releaseNotes?, error? }
  "update:progress": { percent, transferred, total }
  "content:download-progress": ContentDownloadProgress
  "cloud:upload-progress": { id, percent, stage: "zip" | "upload" }
  "import:progress": ImportProgress
  "stats:updated": {}
}

interface BuildLoaderRequirementIssue {
  fileName: string
  modName?: string
  modId?: string
  loaderId: string        // "minecraft", "fabric", "forge", ...
  requirement: string      // ">=1.20"
  buildLoaderVersion?: string
  satisfied: boolean
  reason?: string
}

interface BuildLoaderRequirementReport {
  loaderId: string
  loaderVersion?: string
  checked: number
  issues: BuildLoaderRequirementIssue[]
}

// renderer-процесс
async function searchMods(query: string) {
  // Полная типизация: аргументы и возвращаемое значение проверяются компилятором
  const response = await window.electronAPI.modsModrinthSearch(
    query,
    "mod",           // contentType
    "1.21.4",        // gameVersion
    "fabric",        // modLoader
    "relevance",     // sortBy
    1                // page
  );

  // response: ModSearchResponse
  response.hits.forEach((mod: ModSearchResult) => {
    console.log(mod.title, mod.downloads);
  });
}

// main-процесс
ipcMain.handle("mods:modrinth-search", async (_event, query, contentType, gameVersion, modLoader, sortBy, page) => {
  // query: string, contentType: ModContentType | undefined, ...
  // Все аргументы типизированы благодаря IpcInvokeMap
  return await modrinthClient.search(query, { contentType, gameVersion, modLoader, sortBy, page });
});