@adhisang/minecraft-modding-mcp 4.0.0 → 4.1.0

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 (174) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +36 -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 +97 -0
  47. package/dist/entry-tools/validate-project/cases/project-summary.js +346 -0
  48. package/dist/entry-tools/validate-project/internal.d.ts +135 -0
  49. package/dist/entry-tools/validate-project/internal.js +287 -0
  50. package/dist/entry-tools/validate-project-service.d.ts +63 -47
  51. package/dist/entry-tools/validate-project-service.js +12 -562
  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 +142 -1352
  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 +3 -144
  84. package/dist/mapping-service.js +19 -1201
  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 +110 -0
  100. package/dist/source/artifact-resolver.js +1174 -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 +505 -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 +21 -0
  134. package/dist/source/state.js +19 -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-service.d.ts +147 -170
  152. package/dist/source-service.js +67 -6116
  153. package/dist/stage-emitter.d.ts +13 -0
  154. package/dist/stage-emitter.js +30 -0
  155. package/dist/stdio-supervisor.d.ts +61 -0
  156. package/dist/stdio-supervisor.js +326 -9
  157. package/dist/tool-contract-manifest.d.ts +1 -1
  158. package/dist/tool-contract-manifest.js +23 -6
  159. package/dist/tool-guidance.d.ts +82 -0
  160. package/dist/tool-guidance.js +734 -0
  161. package/dist/tool-schema-registry.d.ts +16 -0
  162. package/dist/tool-schema-registry.js +37 -0
  163. package/dist/tool-schemas.d.ts +3518 -0
  164. package/dist/tool-schemas.js +813 -0
  165. package/dist/types.d.ts +36 -0
  166. package/dist/version-service.js +7 -6
  167. package/dist/workspace-context-cache.d.ts +32 -0
  168. package/dist/workspace-context-cache.js +66 -0
  169. package/dist/workspace-mapping-service.d.ts +16 -0
  170. package/dist/workspace-mapping-service.js +173 -1
  171. package/docs/README-ja.md +414 -0
  172. package/docs/examples.md +483 -0
  173. package/docs/tool-reference.md +459 -0
  174. package/package.json +3 -2
@@ -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;
@@ -188,8 +49,7 @@ export declare class MappingService {
188
49
  private loadMojangPairs;
189
50
  private loadTinyPairsFromLoom;
190
51
  private loadTinyPairsFromMaven;
191
- private parseTinyFromJar;
192
- private fetchYarnCoordinates;
52
+ private loaderDeps;
193
53
  private trimGraphCache;
194
54
  releaseGraphCacheEntry(version: string, sourcePriority?: MappingSourcePriority): void;
195
55
  private buildResolutionCacheKey;
@@ -205,4 +65,3 @@ export declare class MappingService {
205
65
  * @returns Path to the extracted Tiny v2 file
206
66
  */
207
67
  export declare function resolveTinyMappingFile(version: string, mapping: "intermediary" | "yarn", cacheDir: string, fetchFn?: typeof fetch): Promise<string>;
208
- export {};