@adhisang/minecraft-modding-mcp 3.1.1 → 4.0.0

package/dist/mapping-pipeline-service.js

@@ -3,7 +3,9 @@ import { createError, ERROR_CODES } from "./errors.js";
  * Mapping pipeline for v0.3.
  * Current implementation enforces explicit guarantees:
  * - obfuscated: always pass-through
- * - mojang: requires source-backed artifact; decompile-only artifacts are rejected
+ * - mojang: requires source-backed artifacts on legacy obfuscated versions,
+ *   but unobfuscated runtime jars can pass through directly,
+ *   or binary-only artifacts may be remapped + decompiled when allowBinaryRemap=true
  */
 export function applyMappingPipeline(input) {
     const transformChain = [];
@@ -22,6 +24,20 @@ export function applyMappingPipeline(input) {
             transformChain
         };
     }
+    if (input.requestedMapping === "mojang" && input.runtimeNamesUnobfuscated) {
+        transformChain.push("mapping:mojang-runtime-unobfuscated");
+        if (input.resolved.isDecompiled) {
+            qualityFlags.push("decompiled");
+        }
+        else {
+            qualityFlags.push("source-backed");
+        }
+        return {
+            mappingApplied: "mojang",
+            qualityFlags,
+            transformChain
+        };
+    }
     if (input.requestedMapping !== "mojang" &&
         input.requestedMapping !== "intermediary" &&
         input.requestedMapping !== "yarn") {
@@ -36,6 +52,17 @@ export function applyMappingPipeline(input) {
     }
     const hasSource = Boolean(input.resolved.sourceJarPath);
     if (!hasSource) {
+        if (input.requestedMapping === "mojang" &&
+            input.allowBinaryRemap === true &&
+            Boolean(input.resolved.binaryJarPath)) {
+            transformChain.push("binary-remap:obf->mojang", "decompile:vineflower");
+            qualityFlags.push("binary-remapped", "decompiled");
+            return {
+                mappingApplied: "mojang",
+                qualityFlags,
+                transformChain
+            };
+        }
         throw createError({
             code: ERROR_CODES.MAPPING_NOT_APPLIED,
             message: `Requested ${input.requestedMapping} mapping cannot be guaranteed for this artifact because only decompile path is available.`,

package/dist/mapping-service.d.ts

@@ -62,6 +62,7 @@ export type FindMappingInput = {
     sourceMapping: SourceMapping;
     targetMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    projectPath?: string;
     disambiguation?: {
         ownerHint?: string;
         descriptorHint?: string;
@@ -74,6 +75,7 @@ export type EnsureMappingAvailableInput = {
     sourceMapping: SourceMapping;
     targetMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    projectPath?: string;
 };
 export type EnsureMappingAvailableOutput = {
     transformChain: string[];
@@ -88,6 +90,7 @@ export type ResolveMethodMappingExactInput = {
     sourceMapping: SourceMapping;
     targetMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    projectPath?: string;
     maxCandidates?: number;
 };
 export type ResolveMethodMappingExactOutput = SymbolResolutionOutput;
@@ -145,6 +148,16 @@ export declare class MappingService {
     private readonly fetchFn;
     private readonly graphCache;
     private readonly buildLocks;
+    private readonly resolutionCache;
+    private static readonly RESOLUTION_CACHE_MAX;
+    private static readonly RESOLUTION_CACHE_TTL_MS;
+    private resolutionCacheHits;
+    private resolutionCacheMisses;
+    get resolutionCacheStats(): {
+        hits: number;
+        misses: number;
+        size: number;
+    };
     constructor(config: Config, versionService?: VersionMappingsResolver, fetchFn?: typeof fetch);
     findMapping(input: FindMappingInput): Promise<FindMappingOutput>;
     ensureMappingAvailable(input: EnsureMappingAvailableInput): Promise<EnsureMappingAvailableOutput>;
@@ -153,6 +166,7 @@ export declare class MappingService {
     checkSymbolExists(input: SymbolExistenceInput): Promise<SymbolExistenceOutput>;
     private mapRecordBetweenMappings;
     private mapCandidatesAlongPath;
+    private projectMethodDescriptorToTarget;
     private provenanceForPath;
     /**
      * Probe the mapping graph health for a given version.
@@ -178,6 +192,8 @@ export declare class MappingService {
     private fetchYarnCoordinates;
     private trimGraphCache;
     releaseGraphCacheEntry(version: string, sourcePriority?: MappingSourcePriority): void;
+    private buildResolutionCacheKey;
+    private trimResolutionCache;
 }
 /**
  * Resolve and cache a Tiny v2 mapping file for the given Minecraft version.