@adhisang/minecraft-modding-mcp 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/CHANGELOG.md +61 -0
  2. package/README.md +40 -23
  3. package/dist/build-suggested-call.d.ts +29 -0
  4. package/dist/build-suggested-call.js +58 -0
  5. package/dist/cache-registry.d.ts +3 -1
  6. package/dist/cache-registry.js +50 -6
  7. package/dist/entry-tools/analyze-symbol-service.d.ts +16 -16
  8. package/dist/entry-tools/batch-class-members-service.d.ts +34 -0
  9. package/dist/entry-tools/batch-class-members-service.js +97 -0
  10. package/dist/entry-tools/batch-class-source-service.d.ts +37 -0
  11. package/dist/entry-tools/batch-class-source-service.js +100 -0
  12. package/dist/entry-tools/batch-mappings-service.d.ts +36 -0
  13. package/dist/entry-tools/batch-mappings-service.js +66 -0
  14. package/dist/entry-tools/batch-runner.d.ts +72 -0
  15. package/dist/entry-tools/batch-runner.js +90 -0
  16. package/dist/entry-tools/batch-symbol-exists-service.d.ts +46 -0
  17. package/dist/entry-tools/batch-symbol-exists-service.js +113 -0
  18. package/dist/entry-tools/compare-minecraft-service.d.ts +6 -6
  19. package/dist/entry-tools/inspect-minecraft/handlers/artifact.d.ts +5 -0
  20. package/dist/entry-tools/inspect-minecraft/handlers/artifact.js +83 -0
  21. package/dist/entry-tools/inspect-minecraft/handlers/class-members.d.ts +6 -0
  22. package/dist/entry-tools/inspect-minecraft/handlers/class-members.js +80 -0
  23. package/dist/entry-tools/inspect-minecraft/handlers/class-overview.d.ts +5 -0
  24. package/dist/entry-tools/inspect-minecraft/handlers/class-overview.js +248 -0
  25. package/dist/entry-tools/inspect-minecraft/handlers/class-source.d.ts +5 -0
  26. package/dist/entry-tools/inspect-minecraft/handlers/class-source.js +60 -0
  27. package/dist/entry-tools/inspect-minecraft/handlers/file.d.ts +5 -0
  28. package/dist/entry-tools/inspect-minecraft/handlers/file.js +54 -0
  29. package/dist/entry-tools/inspect-minecraft/handlers/list-files.d.ts +5 -0
  30. package/dist/entry-tools/inspect-minecraft/handlers/list-files.js +100 -0
  31. package/dist/entry-tools/inspect-minecraft/handlers/search.d.ts +5 -0
  32. package/dist/entry-tools/inspect-minecraft/handlers/search.js +155 -0
  33. package/dist/entry-tools/inspect-minecraft/handlers/versions.d.ts +6 -0
  34. package/dist/entry-tools/inspect-minecraft/handlers/versions.js +49 -0
  35. package/dist/entry-tools/inspect-minecraft/internal.d.ts +1042 -0
  36. package/dist/entry-tools/inspect-minecraft/internal.js +448 -0
  37. package/dist/entry-tools/inspect-minecraft-service.d.ts +193 -308
  38. package/dist/entry-tools/inspect-minecraft-service.js +20 -1244
  39. package/dist/entry-tools/manage-cache-service.d.ts +16 -16
  40. package/dist/entry-tools/validate-project/cases/access-transformer.d.ts +6 -0
  41. package/dist/entry-tools/validate-project/cases/access-transformer.js +106 -0
  42. package/dist/entry-tools/validate-project/cases/access-widener.d.ts +6 -0
  43. package/dist/entry-tools/validate-project/cases/access-widener.js +86 -0
  44. package/dist/entry-tools/validate-project/cases/mixin.d.ts +6 -0
  45. package/dist/entry-tools/validate-project/cases/mixin.js +90 -0
  46. package/dist/entry-tools/validate-project/cases/project-summary.d.ts +102 -0
  47. package/dist/entry-tools/validate-project/cases/project-summary.js +415 -0
  48. package/dist/entry-tools/validate-project/internal.d.ts +142 -0
  49. package/dist/entry-tools/validate-project/internal.js +303 -0
  50. package/dist/entry-tools/validate-project-service.d.ts +67 -47
  51. package/dist/entry-tools/validate-project-service.js +13 -563
  52. package/dist/entry-tools/verify-mixin-target-service.d.ts +133 -0
  53. package/dist/entry-tools/verify-mixin-target-service.js +323 -0
  54. package/dist/error-mapping.d.ts +40 -0
  55. package/dist/error-mapping.js +139 -0
  56. package/dist/errors.d.ts +6 -0
  57. package/dist/errors.js +6 -0
  58. package/dist/index.d.ts +2 -0
  59. package/dist/index.js +147 -1354
  60. package/dist/mapping/internal-types.d.ts +54 -0
  61. package/dist/mapping/internal-types.js +14 -0
  62. package/dist/mapping/loaders/mojang.d.ts +2 -0
  63. package/dist/mapping/loaders/mojang.js +64 -0
  64. package/dist/mapping/loaders/tiny-loom.d.ts +2 -0
  65. package/dist/mapping/loaders/tiny-loom.js +73 -0
  66. package/dist/mapping/loaders/tiny-maven.d.ts +2 -0
  67. package/dist/mapping/loaders/tiny-maven.js +104 -0
  68. package/dist/mapping/loaders/types.d.ts +14 -0
  69. package/dist/mapping/loaders/types.js +2 -0
  70. package/dist/mapping/lookup.d.ts +52 -0
  71. package/dist/mapping/lookup.js +496 -0
  72. package/dist/mapping/parsers/normalize.d.ts +10 -0
  73. package/dist/mapping/parsers/normalize.js +52 -0
  74. package/dist/mapping/parsers/proguard.d.ts +20 -0
  75. package/dist/mapping/parsers/proguard.js +138 -0
  76. package/dist/mapping/parsers/symbol-records.d.ts +27 -0
  77. package/dist/mapping/parsers/symbol-records.js +216 -0
  78. package/dist/mapping/parsers/tiny.d.ts +9 -0
  79. package/dist/mapping/parsers/tiny.js +96 -0
  80. package/dist/mapping/types.d.ts +147 -0
  81. package/dist/mapping/types.js +2 -0
  82. package/dist/mapping-pipeline-service.js +3 -2
  83. package/dist/mapping-service.d.ts +8 -145
  84. package/dist/mapping-service.js +30 -1207
  85. package/dist/mixin/access-validators.d.ts +9 -0
  86. package/dist/mixin/access-validators.js +257 -0
  87. package/dist/mixin/annotation-validators.d.ts +5 -0
  88. package/dist/mixin/annotation-validators.js +162 -0
  89. package/dist/mixin/helpers.d.ts +28 -0
  90. package/dist/mixin/helpers.js +315 -0
  91. package/dist/mixin/parsed-validator.d.ts +8 -0
  92. package/dist/mixin/parsed-validator.js +337 -0
  93. package/dist/mixin/types.d.ts +208 -0
  94. package/dist/mixin/types.js +28 -0
  95. package/dist/mixin-validator.d.ts +9 -201
  96. package/dist/mixin-validator.js +8 -1020
  97. package/dist/source/access-validate.d.ts +4 -0
  98. package/dist/source/access-validate.js +254 -0
  99. package/dist/source/artifact-resolver.d.ts +111 -0
  100. package/dist/source/artifact-resolver.js +1271 -0
  101. package/dist/source/cache-metrics.d.ts +26 -0
  102. package/dist/source/cache-metrics.js +172 -0
  103. package/dist/source/class-source/members-builder.d.ts +34 -0
  104. package/dist/source/class-source/members-builder.js +46 -0
  105. package/dist/source/class-source/snippet-builder.d.ts +19 -0
  106. package/dist/source/class-source/snippet-builder.js +46 -0
  107. package/dist/source/class-source-helpers.d.ts +34 -0
  108. package/dist/source/class-source-helpers.js +140 -0
  109. package/dist/source/class-source.d.ts +42 -0
  110. package/dist/source/class-source.js +883 -0
  111. package/dist/source/descriptor-utils.d.ts +6 -0
  112. package/dist/source/descriptor-utils.js +37 -0
  113. package/dist/source/file-access.d.ts +4 -0
  114. package/dist/source/file-access.js +102 -0
  115. package/dist/source/indexer.d.ts +82 -0
  116. package/dist/source/indexer.js +522 -0
  117. package/dist/source/lifecycle/diff-utils.d.ts +9 -0
  118. package/dist/source/lifecycle/diff-utils.js +107 -0
  119. package/dist/source/lifecycle/diff.d.ts +2 -0
  120. package/dist/source/lifecycle/diff.js +265 -0
  121. package/dist/source/lifecycle/mapping-helpers.d.ts +22 -0
  122. package/dist/source/lifecycle/mapping-helpers.js +327 -0
  123. package/dist/source/lifecycle/runtime-check.d.ts +2 -0
  124. package/dist/source/lifecycle/runtime-check.js +142 -0
  125. package/dist/source/lifecycle/trace.d.ts +2 -0
  126. package/dist/source/lifecycle/trace.js +231 -0
  127. package/dist/source/lifecycle.d.ts +4 -0
  128. package/dist/source/lifecycle.js +5 -0
  129. package/dist/source/search.d.ts +51 -0
  130. package/dist/source/search.js +676 -0
  131. package/dist/source/shared-utils.d.ts +6 -0
  132. package/dist/source/shared-utils.js +55 -0
  133. package/dist/source/state.d.ts +26 -0
  134. package/dist/source/state.js +24 -0
  135. package/dist/source/symbol-resolver.d.ts +3 -0
  136. package/dist/source/symbol-resolver.js +212 -0
  137. package/dist/source/validate-mixin/pipeline/mapping-health.d.ts +3 -0
  138. package/dist/source/validate-mixin/pipeline/mapping-health.js +41 -0
  139. package/dist/source/validate-mixin/pipeline/parse.d.ts +2 -0
  140. package/dist/source/validate-mixin/pipeline/parse.js +10 -0
  141. package/dist/source/validate-mixin/pipeline/resolve.d.ts +3 -0
  142. package/dist/source/validate-mixin/pipeline/resolve.js +78 -0
  143. package/dist/source/validate-mixin/pipeline/target-lookup.d.ts +6 -0
  144. package/dist/source/validate-mixin/pipeline/target-lookup.js +260 -0
  145. package/dist/source/validate-mixin/pipeline-context.d.ts +72 -0
  146. package/dist/source/validate-mixin/pipeline-context.js +93 -0
  147. package/dist/source/validate-mixin.d.ts +22 -0
  148. package/dist/source/validate-mixin.js +799 -0
  149. package/dist/source/workspace-target.d.ts +18 -0
  150. package/dist/source/workspace-target.js +305 -0
  151. package/dist/source-resolver.d.ts +1 -0
  152. package/dist/source-resolver.js +1 -1
  153. package/dist/source-service.d.ts +164 -170
  154. package/dist/source-service.js +70 -6116
  155. package/dist/stage-emitter.d.ts +13 -0
  156. package/dist/stage-emitter.js +30 -0
  157. package/dist/stdio-supervisor.d.ts +61 -0
  158. package/dist/stdio-supervisor.js +326 -9
  159. package/dist/tool-contract-manifest.d.ts +1 -1
  160. package/dist/tool-contract-manifest.js +23 -6
  161. package/dist/tool-guidance.d.ts +82 -0
  162. package/dist/tool-guidance.js +734 -0
  163. package/dist/tool-schema-registry.d.ts +16 -0
  164. package/dist/tool-schema-registry.js +37 -0
  165. package/dist/tool-schemas.d.ts +3518 -0
  166. package/dist/tool-schemas.js +813 -0
  167. package/dist/types.d.ts +36 -0
  168. package/dist/version-service.js +7 -6
  169. package/dist/workspace-context-cache.d.ts +32 -0
  170. package/dist/workspace-context-cache.js +66 -0
  171. package/dist/workspace-mapping-service.d.ts +16 -0
  172. package/dist/workspace-mapping-service.js +173 -1
  173. package/docs/README-ja.md +416 -0
  174. package/docs/examples.md +483 -0
  175. package/docs/tool-reference.md +462 -0
  176. package/package.json +17 -4
@@ -1,147 +1,8 @@
1
1
  import type { Config, MappingSourcePriority, SourceMapping } from "./types.js";
2
2
  import { VersionService } from "./version-service.js";
3
- type MappingLookupSource = "loom-cache" | "maven" | "mojang-client-mappings";
4
- type MappingSymbolKind = "class" | "field" | "method";
3
+ import type { ClassApiMatrixInput, ClassApiMatrixOutput, EnsureMappingAvailableInput, EnsureMappingAvailableOutput, FindMappingInput, FindMappingOutput, ResolveMethodMappingExactInput, ResolveMethodMappingExactOutput, SymbolExistenceInput, SymbolExistenceOutput } from "./mapping/types.js";
4
+ export type { ClassApiMatrixEntry, ClassApiMatrixInput, ClassApiMatrixKind, ClassApiMatrixOutput, ClassApiMatrixRow, EnsureMappingAvailableInput, EnsureMappingAvailableOutput, FindMappingInput, FindMappingOutput, MappingLookupCandidate, MappingLookupProvenance, MappingMatchKind, ResolveMethodMappingExactInput, ResolveMethodMappingExactOutput, SymbolExistenceInput, SymbolExistenceOutput, SymbolQueryInput, SymbolQueryKind, SymbolReference, SymbolResolutionOutput, SymbolResolutionStatus } from "./mapping/types.js";
5
5
  type VersionMappingsResolver = Pick<VersionService, "resolveVersionMappings">;
6
- export type MappingMatchKind = "exact" | "normalized" | "simple-name";
7
- export type MappingLookupCandidate = {
8
- symbol: string;
9
- matchKind: MappingMatchKind;
10
- confidence: number;
11
- kind: MappingSymbolKind;
12
- owner?: string;
13
- name: string;
14
- descriptor?: string;
15
- };
16
- export type MappingLookupProvenance = {
17
- source: MappingLookupSource;
18
- mappingArtifact: string;
19
- version: string;
20
- priority: MappingSourcePriority;
21
- };
22
- export type SymbolQueryKind = MappingSymbolKind;
23
- export type SymbolQueryInput = {
24
- kind: SymbolQueryKind;
25
- name: string;
26
- owner?: string;
27
- descriptor?: string;
28
- };
29
- export type SymbolReference = {
30
- kind: SymbolQueryKind;
31
- name: string;
32
- owner?: string;
33
- descriptor?: string;
34
- symbol: string;
35
- };
36
- export type SymbolResolutionStatus = "resolved" | "not_found" | "ambiguous" | "mapping_unavailable";
37
- export type SymbolResolutionOutput = {
38
- querySymbol: SymbolReference;
39
- mappingContext: {
40
- version: string;
41
- sourceMapping: SourceMapping;
42
- targetMapping?: SourceMapping;
43
- sourcePriorityApplied: MappingSourcePriority;
44
- };
45
- resolved: boolean;
46
- status: SymbolResolutionStatus;
47
- resolvedSymbol?: SymbolReference;
48
- candidates: Array<SymbolReference & Pick<MappingLookupCandidate, "matchKind" | "confidence">>;
49
- candidateCount: number;
50
- candidatesTruncated?: boolean;
51
- warnings: string[];
52
- provenance?: MappingLookupProvenance;
53
- ambiguityReasons?: string[];
54
- };
55
- export type FindMappingInput = {
56
- version: string;
57
- kind: SymbolQueryKind;
58
- name: string;
59
- owner?: string;
60
- descriptor?: string;
61
- signatureMode?: "exact" | "name-only";
62
- sourceMapping: SourceMapping;
63
- targetMapping: SourceMapping;
64
- sourcePriority?: MappingSourcePriority;
65
- projectPath?: string;
66
- disambiguation?: {
67
- ownerHint?: string;
68
- descriptorHint?: string;
69
- };
70
- maxCandidates?: number;
71
- };
72
- export type FindMappingOutput = SymbolResolutionOutput;
73
- export type EnsureMappingAvailableInput = {
74
- version: string;
75
- sourceMapping: SourceMapping;
76
- targetMapping: SourceMapping;
77
- sourcePriority?: MappingSourcePriority;
78
- projectPath?: string;
79
- };
80
- export type EnsureMappingAvailableOutput = {
81
- transformChain: string[];
82
- warnings: string[];
83
- provenance?: MappingLookupProvenance;
84
- };
85
- export type ResolveMethodMappingExactInput = {
86
- version: string;
87
- name: string;
88
- owner: string;
89
- descriptor: string;
90
- sourceMapping: SourceMapping;
91
- targetMapping: SourceMapping;
92
- sourcePriority?: MappingSourcePriority;
93
- projectPath?: string;
94
- maxCandidates?: number;
95
- };
96
- export type ResolveMethodMappingExactOutput = SymbolResolutionOutput;
97
- export type ClassApiMatrixKind = "class" | "field" | "method";
98
- export type ClassApiMatrixInput = {
99
- version: string;
100
- className: string;
101
- classNameMapping: SourceMapping;
102
- sourcePriority?: MappingSourcePriority;
103
- includeKinds?: ClassApiMatrixKind[];
104
- maxRows?: number;
105
- };
106
- export type ClassApiMatrixEntry = {
107
- symbol: string;
108
- owner?: string;
109
- name: string;
110
- descriptor?: string;
111
- };
112
- export type ClassApiMatrixRow = {
113
- kind: ClassApiMatrixKind;
114
- descriptor?: string;
115
- obfuscated?: ClassApiMatrixEntry;
116
- mojang?: ClassApiMatrixEntry;
117
- intermediary?: ClassApiMatrixEntry;
118
- yarn?: ClassApiMatrixEntry;
119
- completeness: boolean;
120
- };
121
- export type ClassApiMatrixOutput = {
122
- version: string;
123
- className: string;
124
- classNameMapping: SourceMapping;
125
- classIdentity: Partial<Record<SourceMapping, string>>;
126
- rows: ClassApiMatrixRow[];
127
- rowCount: number;
128
- rowsTruncated?: boolean;
129
- warnings: string[];
130
- ambiguousRowCount?: number;
131
- };
132
- export type SymbolExistenceInput = {
133
- version: string;
134
- kind: SymbolQueryKind;
135
- name: string;
136
- owner?: string;
137
- descriptor?: string;
138
- sourceMapping: SourceMapping;
139
- sourcePriority?: MappingSourcePriority;
140
- nameMode?: "fqcn" | "auto";
141
- signatureMode?: "exact" | "name-only";
142
- maxCandidates?: number;
143
- };
144
- export type SymbolExistenceOutput = SymbolResolutionOutput;
145
6
  export declare class MappingService {
146
7
  private readonly config;
147
8
  private readonly versionService;
@@ -170,7 +31,11 @@ export declare class MappingService {
170
31
  private provenanceForPath;
171
32
  /**
172
33
  * Probe the mapping graph health for a given version.
173
- * Returns availability of mojang mappings, tiny mappings, and member remap paths.
34
+ *
35
+ * `tinyMappingsAvailable` reports whether Tiny is sufficient for the
36
+ * request: `true` when Tiny is not required (obfuscated/mojang) or is
37
+ * loaded, `false` only when intermediary/yarn was requested and Tiny is
38
+ * unavailable.
174
39
  */
175
40
  checkMappingHealth(input: {
176
41
  version: string;
@@ -188,8 +53,7 @@ export declare class MappingService {
188
53
  private loadMojangPairs;
189
54
  private loadTinyPairsFromLoom;
190
55
  private loadTinyPairsFromMaven;
191
- private parseTinyFromJar;
192
- private fetchYarnCoordinates;
56
+ private loaderDeps;
193
57
  private trimGraphCache;
194
58
  releaseGraphCacheEntry(version: string, sourcePriority?: MappingSourcePriority): void;
195
59
  private buildResolutionCacheKey;
@@ -205,4 +69,3 @@ export declare class MappingService {
205
69
  * @returns Path to the extracted Tiny v2 file
206
70
  */
207
71
  export declare function resolveTinyMappingFile(version: string, mapping: "intermediary" | "yarn", cacheDir: string, fetchFn?: typeof fetch): Promise<string>;
208
- export {};