@nestia/sdk 12.0.0-dev.20260601.1 → 12.0.0-dev.20260612.2

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 (209) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +93 -93
  3. package/assets/bundle/api/HttpError.ts +1 -1
  4. package/assets/bundle/api/IConnection.ts +1 -1
  5. package/assets/bundle/api/Primitive.ts +1 -1
  6. package/assets/bundle/api/Resolved.ts +1 -1
  7. package/assets/bundle/api/index.ts +4 -4
  8. package/assets/bundle/api/module.ts +6 -6
  9. package/assets/bundle/distribute/README.md +37 -37
  10. package/assets/bundle/distribute/package.json +28 -28
  11. package/assets/bundle/distribute/tsconfig.json +109 -109
  12. package/assets/bundle/e2e/index.ts +42 -42
  13. package/assets/config/nestia.config.ts +97 -97
  14. package/lib/NestiaSdkApplication.js +29 -7
  15. package/lib/NestiaSdkApplication.js.map +1 -1
  16. package/lib/NestiaSwaggerComposer.js +21 -13
  17. package/lib/NestiaSwaggerComposer.js.map +1 -1
  18. package/lib/analyses/AccessorAnalyzer.d.ts +4 -1
  19. package/lib/analyses/AccessorAnalyzer.js.map +1 -1
  20. package/lib/analyses/ConfigAnalyzer.js +1 -1
  21. package/lib/analyses/PathAnalyzer.d.ts +18 -3
  22. package/lib/analyses/PathAnalyzer.js +32 -0
  23. package/lib/analyses/PathAnalyzer.js.map +1 -1
  24. package/lib/analyses/ReflectControllerAnalyzer.js +3 -2
  25. package/lib/analyses/ReflectControllerAnalyzer.js.map +1 -1
  26. package/lib/analyses/ReflectHttpOperationAnalyzer.d.ts +1 -1
  27. package/lib/analyses/ReflectHttpOperationAnalyzer.js +1 -1
  28. package/lib/analyses/ReflectHttpOperationAnalyzer.js.map +1 -1
  29. package/lib/analyses/ReflectHttpOperationResponseAnalyzer.d.ts +1 -1
  30. package/lib/analyses/ReflectHttpOperationResponseAnalyzer.js +53 -20
  31. package/lib/analyses/ReflectHttpOperationResponseAnalyzer.js.map +1 -1
  32. package/lib/analyses/ReflectMcpOperationAnalyzer.d.ts +14 -0
  33. package/lib/analyses/ReflectMcpOperationAnalyzer.js +79 -0
  34. package/lib/analyses/ReflectMcpOperationAnalyzer.js.map +1 -0
  35. package/lib/analyses/TypedMcpRouteAnalyzer.d.ts +9 -0
  36. package/lib/analyses/TypedMcpRouteAnalyzer.js +31 -0
  37. package/lib/analyses/TypedMcpRouteAnalyzer.js.map +1 -0
  38. package/lib/executable/internal/NestiaConfigLoader.js +5 -1
  39. package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
  40. package/lib/executable/internal/NestiaSdkCommand.js +30 -14
  41. package/lib/executable/internal/NestiaSdkCommand.js.map +1 -1
  42. package/lib/executable/internal/NestiaSdkWatcher.d.ts +10 -0
  43. package/lib/executable/internal/NestiaSdkWatcher.js +322 -0
  44. package/lib/executable/internal/NestiaSdkWatcher.js.map +1 -0
  45. package/lib/executable/sdk.js +12 -12
  46. package/lib/executable/sdk.js.map +1 -1
  47. package/lib/generates/CloneGenerator.js +4 -2
  48. package/lib/generates/CloneGenerator.js.map +1 -1
  49. package/lib/generates/SdkGenerator.js +50 -1
  50. package/lib/generates/SdkGenerator.js.map +1 -1
  51. package/lib/generates/SwaggerGenerator.js +18 -2
  52. package/lib/generates/SwaggerGenerator.js.map +1 -1
  53. package/lib/generates/internal/E2eFileProgrammer.js +3 -1
  54. package/lib/generates/internal/E2eFileProgrammer.js.map +1 -1
  55. package/lib/generates/internal/ImportDictionary.d.ts +1 -0
  56. package/lib/generates/internal/ImportDictionary.js +9 -4
  57. package/lib/generates/internal/ImportDictionary.js.map +1 -1
  58. package/lib/generates/internal/SdkAliasCollection.d.ts +2 -0
  59. package/lib/generates/internal/SdkAliasCollection.js +11 -2
  60. package/lib/generates/internal/SdkAliasCollection.js.map +1 -1
  61. package/lib/generates/internal/SdkDistributionComposer.d.ts +1 -0
  62. package/lib/generates/internal/SdkDistributionComposer.js +3 -0
  63. package/lib/generates/internal/SdkDistributionComposer.js.map +1 -1
  64. package/lib/generates/internal/SdkFileProgrammer.js +4 -1
  65. package/lib/generates/internal/SdkFileProgrammer.js.map +1 -1
  66. package/lib/generates/internal/SdkHttpCloneReferencer.d.ts +1 -1
  67. package/lib/generates/internal/SdkHttpCloneReferencer.js +42 -9
  68. package/lib/generates/internal/SdkHttpCloneReferencer.js.map +1 -1
  69. package/lib/generates/internal/SdkHttpFunctionProgrammer.js +3 -4
  70. package/lib/generates/internal/SdkHttpFunctionProgrammer.js.map +1 -1
  71. package/lib/generates/internal/SdkHttpNamespaceProgrammer.js +2 -1
  72. package/lib/generates/internal/SdkHttpNamespaceProgrammer.js.map +1 -1
  73. package/lib/generates/internal/SdkHttpSimulationProgrammer.js +6 -3
  74. package/lib/generates/internal/SdkHttpSimulationProgrammer.js.map +1 -1
  75. package/lib/generates/internal/SdkMcpRouteProgrammer.d.ts +15 -0
  76. package/lib/generates/internal/SdkMcpRouteProgrammer.js +148 -0
  77. package/lib/generates/internal/SdkMcpRouteProgrammer.js.map +1 -0
  78. package/lib/generates/internal/SdkRouteDirectory.d.ts +2 -1
  79. package/lib/generates/internal/SdkRouteDirectory.js.map +1 -1
  80. package/lib/generates/internal/SdkWebSocketCloneProgrammer.d.ts +6 -0
  81. package/lib/generates/internal/SdkWebSocketCloneProgrammer.js +283 -0
  82. package/lib/generates/internal/SdkWebSocketCloneProgrammer.js.map +1 -0
  83. package/lib/generates/internal/SdkWebSocketRouteProgrammer.js +11 -9
  84. package/lib/generates/internal/SdkWebSocketRouteProgrammer.js.map +1 -1
  85. package/lib/generates/internal/SwaggerOperationParameterComposer.js +10 -2
  86. package/lib/generates/internal/SwaggerOperationParameterComposer.js.map +1 -1
  87. package/lib/generates/internal/SwaggerOperationResponseComposer.d.ts +1 -1
  88. package/lib/generates/internal/SwaggerOperationResponseComposer.js +6 -1
  89. package/lib/generates/internal/SwaggerOperationResponseComposer.js.map +1 -1
  90. package/lib/generates/internal/SwaggerReadonlyArrayEmender.d.ts +9 -0
  91. package/lib/generates/internal/SwaggerReadonlyArrayEmender.js +174 -0
  92. package/lib/generates/internal/SwaggerReadonlyArrayEmender.js.map +1 -0
  93. package/lib/structures/INestiaSdkInput.d.ts +9 -2
  94. package/lib/structures/IReflectController.d.ts +2 -1
  95. package/lib/structures/IReflectHttpOperationSuccess.d.ts +4 -2
  96. package/lib/structures/IReflectMcpOperation.d.ts +35 -0
  97. package/lib/structures/IReflectMcpOperation.js +3 -0
  98. package/lib/structures/IReflectMcpOperation.js.map +1 -0
  99. package/lib/structures/IReflectMcpOperationParameter.d.ts +19 -0
  100. package/lib/structures/IReflectMcpOperationParameter.js +3 -0
  101. package/lib/structures/IReflectMcpOperationParameter.js.map +1 -0
  102. package/lib/structures/ITypedApplication.d.ts +2 -1
  103. package/lib/structures/ITypedHttpRouteSuccess.d.ts +3 -1
  104. package/lib/structures/ITypedMcpRoute.d.ts +31 -0
  105. package/lib/structures/ITypedMcpRoute.js +3 -0
  106. package/lib/structures/ITypedMcpRoute.js.map +1 -0
  107. package/lib/utils/HttpResponseContentTypeUtil.d.ts +5 -0
  108. package/lib/utils/HttpResponseContentTypeUtil.js +22 -0
  109. package/lib/utils/HttpResponseContentTypeUtil.js.map +1 -0
  110. package/native/go.mod +52 -52
  111. package/native/go.sum +84 -54
  112. package/native/sdk/register.go +322 -165
  113. package/native/sdk/sdk.go +17 -17
  114. package/native/sdk/sdk_metadata_json.go +327 -327
  115. package/native/sdk/sdk_transform.go +1879 -1549
  116. package/package.json +11 -9
  117. package/src/INestiaConfig.ts +267 -267
  118. package/src/NestiaSdkApplication.ts +39 -8
  119. package/src/NestiaSwaggerComposer.ts +153 -142
  120. package/src/analyses/AccessorAnalyzer.ts +64 -67
  121. package/src/analyses/ConfigAnalyzer.ts +330 -330
  122. package/src/analyses/ImportAnalyzer.ts +92 -92
  123. package/src/analyses/PathAnalyzer.ts +130 -69
  124. package/src/analyses/ReflectControllerAnalyzer.ts +112 -105
  125. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  126. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +90 -90
  127. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +350 -350
  128. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +163 -130
  129. package/src/analyses/ReflectMcpOperationAnalyzer.ts +124 -0
  130. package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
  131. package/src/analyses/SecurityAnalyzer.ts +25 -25
  132. package/src/analyses/TypedMcpRouteAnalyzer.ts +34 -0
  133. package/src/decorators/OperationMetadata.ts +29 -29
  134. package/src/executable/internal/CommandParser.ts +15 -15
  135. package/src/executable/internal/NestiaConfigLoader.ts +451 -446
  136. package/src/executable/internal/NestiaSdkCommand.ts +124 -106
  137. package/src/executable/internal/NestiaSdkWatcher.ts +342 -0
  138. package/src/executable/sdk.ts +90 -88
  139. package/src/generates/CloneGenerator.ts +73 -66
  140. package/src/generates/E2eGenerator.ts +32 -32
  141. package/src/generates/SdkGenerator.ts +176 -118
  142. package/src/generates/SwaggerGenerator.ts +342 -310
  143. package/src/generates/internal/E2eFileProgrammer.ts +240 -233
  144. package/src/generates/internal/FilePrinter.ts +65 -65
  145. package/src/generates/internal/ImportDictionary.ts +209 -204
  146. package/src/generates/internal/SdkAliasCollection.ts +274 -261
  147. package/src/generates/internal/SdkDistributionComposer.ts +123 -116
  148. package/src/generates/internal/SdkFileProgrammer.ts +116 -112
  149. package/src/generates/internal/SdkHttpCloneProgrammer.ts +126 -126
  150. package/src/generates/internal/SdkHttpCloneReferencer.ts +131 -77
  151. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +301 -301
  152. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +520 -510
  153. package/src/generates/internal/SdkHttpParameterProgrammer.ts +165 -165
  154. package/src/generates/internal/SdkHttpRouteProgrammer.ts +109 -109
  155. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +331 -314
  156. package/src/generates/internal/SdkImportWizard.ts +62 -62
  157. package/src/generates/internal/SdkMcpRouteProgrammer.ts +452 -0
  158. package/src/generates/internal/SdkRouteDirectory.ts +21 -18
  159. package/src/generates/internal/SdkTypeTagProgrammer.ts +114 -114
  160. package/src/generates/internal/SdkWebSocketCloneProgrammer.ts +319 -0
  161. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +389 -389
  162. package/src/generates/internal/SdkWebSocketParameterProgrammer.ts +89 -89
  163. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +331 -323
  164. package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
  165. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  166. package/src/generates/internal/SwaggerOperationParameterComposer.ts +175 -162
  167. package/src/generates/internal/SwaggerOperationResponseComposer.ts +115 -110
  168. package/src/generates/internal/SwaggerReadonlyArrayEmender.ts +262 -0
  169. package/src/index.ts +4 -4
  170. package/src/internal/legacy.ts +492 -492
  171. package/src/module.ts +4 -4
  172. package/src/structures/INestiaProject.ts +10 -10
  173. package/src/structures/INestiaSdkInput.ts +27 -20
  174. package/src/structures/IOperationMetadata.ts +41 -41
  175. package/src/structures/IReflectController.ts +18 -15
  176. package/src/structures/IReflectHttpOperation.ts +26 -26
  177. package/src/structures/IReflectHttpOperationException.ts +18 -18
  178. package/src/structures/IReflectHttpOperationParameter.ts +79 -79
  179. package/src/structures/IReflectHttpOperationSuccess.ts +18 -21
  180. package/src/structures/IReflectImport.ts +6 -6
  181. package/src/structures/IReflectMcpOperation.ts +38 -0
  182. package/src/structures/IReflectMcpOperationParameter.ts +27 -0
  183. package/src/structures/IReflectOperationError.ts +26 -26
  184. package/src/structures/IReflectType.ts +4 -4
  185. package/src/structures/IReflectWebSocketOperation.ts +17 -17
  186. package/src/structures/ITypedApplication.ts +12 -11
  187. package/src/structures/ITypedHttpRoute.ts +41 -41
  188. package/src/structures/ITypedHttpRouteException.ts +15 -15
  189. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  190. package/src/structures/ITypedHttpRouteSuccess.ts +18 -22
  191. package/src/structures/ITypedMcpRoute.ts +33 -0
  192. package/src/structures/ITypedWebSocketRoute.ts +24 -24
  193. package/src/structures/ITypedWebSocketRouteParameter.ts +3 -3
  194. package/src/transform.ts +59 -59
  195. package/src/typings/get-function-location.d.ts +7 -7
  196. package/src/utils/ArrayUtil.ts +26 -26
  197. package/src/utils/EmittedJavaScriptPatcher.ts +88 -88
  198. package/src/utils/FileRetriever.ts +22 -22
  199. package/src/utils/HttpResponseContentTypeUtil.ts +30 -0
  200. package/src/utils/MapUtil.ts +14 -14
  201. package/src/utils/PathUtil.ts +10 -10
  202. package/src/utils/SourceFinder.ts +63 -63
  203. package/src/utils/StringUtil.ts +17 -17
  204. package/src/utils/TsConfigReader.ts +108 -108
  205. package/src/utils/TtscExecutor.ts +68 -68
  206. package/src/utils/VersioningStrategy.ts +28 -28
  207. package/src/validators/HttpHeadersValidator.ts +11 -11
  208. package/src/validators/HttpQueryValidator.ts +11 -11
  209. package/src/validators/TextPlainValidator.ts +17 -17
@@ -1,204 +1,209 @@
1
- import { Node, TypeScriptFactory } from "@nestia/factory";
2
- import path from "path";
3
- import { HashMap, TreeSet, hash } from "tstl";
4
-
5
- import { ImportAnalyzer } from "../../analyses/ImportAnalyzer";
6
- import { IReflectImport } from "../../structures/IReflectImport";
7
- import { FilePrinter } from "./FilePrinter";
8
-
9
- export class ImportDictionary {
10
- private readonly components_: HashMap<ICompositeKey, ICompositeValue> =
11
- new HashMap(
12
- (key) => hash(key.file, key.declaration, key.asterisk, key.default),
13
- (a, b) =>
14
- a.file === b.file &&
15
- a.declaration === b.declaration &&
16
- a.asterisk === b.asterisk &&
17
- a.default === b.default,
18
- );
19
-
20
- public constructor(public readonly file: string) {}
21
-
22
- public empty(): boolean {
23
- return this.components_.empty();
24
- }
25
-
26
- public declarations(imports: IReflectImport[]): void {
27
- imports = ImportAnalyzer.merge(imports);
28
- for (const imp of imports) {
29
- if (imp.asterisk !== null)
30
- this.internal({
31
- type: "asterisk",
32
- file: imp.file,
33
- name: imp.asterisk,
34
- declaration: true,
35
- });
36
- if (imp.default !== null)
37
- this.internal({
38
- type: "default",
39
- file: imp.file,
40
- name: imp.default,
41
- declaration: true,
42
- });
43
- for (const elem of imp.elements) {
44
- if (elem === "WebSocketAcceptor") continue;
45
- this.internal({
46
- type: "element",
47
- file: imp.file,
48
- name: elem,
49
- declaration: true,
50
- });
51
- }
52
- }
53
- }
54
-
55
- public external(props: ImportDictionary.IProps): string {
56
- const file: string = `node_modules/${props.file}`;
57
- return this.internal({
58
- ...props,
59
- file,
60
- });
61
- }
62
-
63
- public internal(props: ImportDictionary.IProps): string {
64
- const file: string = normalize(trimSourceExtension(props.file));
65
- const key: ICompositeKey = {
66
- file: file,
67
- declaration: props.declaration,
68
- asterisk: props.type === "asterisk" ? props.name : null,
69
- default: props.type === "default" ? props.name : null,
70
- };
71
- const value: ICompositeValue = this.components_.take(key, () => ({
72
- ...key,
73
- elements: new TreeSet<string>(),
74
- }));
75
- if (props.type === "element") value.elements.insert(props.name);
76
- return props.name;
77
- }
78
-
79
- public toStatements(outDir: string): Node[] {
80
- outDir = path.resolve(outDir);
81
-
82
- const external: Node[] = [];
83
- const internal: Node[] = [];
84
- const locator = (str: string) => {
85
- const location: string = path
86
- .relative(outDir, str)
87
- .split(path.sep)
88
- .join("/");
89
- const index: number = location.lastIndexOf(NODE_MODULES);
90
- return index === -1
91
- ? location.startsWith("..")
92
- ? location
93
- : `./${location}`
94
- : location.substring(index + NODE_MODULES.length);
95
- };
96
- const enroll =
97
- (filter: (str: string) => boolean) => (container: Node[]) => {
98
- const compositions: ICompositeValue[] = this.components_
99
- .toJSON()
100
- .filter((c) => filter(c.second.file))
101
- .map(
102
- (e) =>
103
- ({
104
- ...e.second,
105
- file: locator(e.second.file),
106
- }) satisfies ICompositeValue,
107
- )
108
- .sort((a, b) => a.file.localeCompare(b.file));
109
- for (const c of compositions)
110
- container.push(
111
- TypeScriptFactory.createImportDeclaration(
112
- undefined,
113
- this.toImportClaude(c),
114
- TypeScriptFactory.createStringLiteral(c.file),
115
- undefined,
116
- ),
117
- );
118
- };
119
-
120
- enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
121
- enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
122
- return [
123
- ...external,
124
- ...(external.length && internal.length ? [FilePrinter.enter()] : []),
125
- ...internal,
126
- ];
127
- }
128
-
129
- private toImportClaude(c: ICompositeValue): Node {
130
- if (c.asterisk !== null)
131
- return TypeScriptFactory.createImportClause(
132
- c.declaration,
133
- undefined,
134
- TypeScriptFactory.createNamespaceImport(
135
- TypeScriptFactory.createIdentifier(c.asterisk),
136
- ),
137
- );
138
- return TypeScriptFactory.createImportClause(
139
- c.declaration,
140
- c.default !== null
141
- ? TypeScriptFactory.createIdentifier(c.default)
142
- : undefined,
143
- c.elements.size() !== 0
144
- ? TypeScriptFactory.createNamedImports(
145
- Array.from(c.elements).map((elem) =>
146
- TypeScriptFactory.createImportSpecifier(
147
- false,
148
- undefined,
149
- TypeScriptFactory.createIdentifier(elem),
150
- ),
151
- ),
152
- )
153
- : undefined,
154
- );
155
- }
156
- }
157
- export namespace ImportDictionary {
158
- export interface IProps {
159
- type: "default" | "element" | "asterisk";
160
- file: string;
161
- name: string;
162
- declaration: boolean;
163
- }
164
- }
165
-
166
- interface ICompositeKey {
167
- file: string;
168
- declaration: boolean;
169
- asterisk: string | null;
170
- default: string | null;
171
- }
172
- interface ICompositeValue extends ICompositeKey {
173
- elements: TreeSet<string>;
174
- }
175
-
176
- const NODE_MODULES = "node_modules/";
177
- const SOURCE_EXTENSIONS: string[] = [
178
- ".d.mts",
179
- ".d.cts",
180
- ".d.ts",
181
- ".mts",
182
- ".cts",
183
- ".tsx",
184
- ".ts",
185
- ".mjs",
186
- ".cjs",
187
- ".jsx",
188
- ".js",
189
- ];
190
-
191
- const normalize = (file: string): string => {
192
- file = path.resolve(file);
193
- if (file.includes(`node_modules${path.sep}`))
194
- file =
195
- "node_modules/" +
196
- file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
197
- return file;
198
- };
199
-
200
- const trimSourceExtension = (file: string): string => {
201
- for (const ext of SOURCE_EXTENSIONS)
202
- if (file.endsWith(ext)) return file.substring(0, file.length - ext.length);
203
- return file;
204
- };
1
+ import { Node, TypeScriptFactory } from "@nestia/factory";
2
+ import path from "path";
3
+ import { HashMap, TreeMap, hash } from "tstl";
4
+
5
+ import { ImportAnalyzer } from "../../analyses/ImportAnalyzer";
6
+ import { IReflectImport } from "../../structures/IReflectImport";
7
+ import { FilePrinter } from "./FilePrinter";
8
+
9
+ export class ImportDictionary {
10
+ private readonly components_: HashMap<ICompositeKey, ICompositeValue> =
11
+ new HashMap(
12
+ (key) => hash(key.file, key.declaration, key.asterisk, key.default),
13
+ (a, b) =>
14
+ a.file === b.file &&
15
+ a.declaration === b.declaration &&
16
+ a.asterisk === b.asterisk &&
17
+ a.default === b.default,
18
+ );
19
+
20
+ public constructor(public readonly file: string) {}
21
+
22
+ public empty(): boolean {
23
+ return this.components_.empty();
24
+ }
25
+
26
+ public declarations(imports: IReflectImport[]): void {
27
+ imports = ImportAnalyzer.merge(imports);
28
+ for (const imp of imports) {
29
+ if (imp.asterisk !== null)
30
+ this.internal({
31
+ type: "asterisk",
32
+ file: imp.file,
33
+ name: imp.asterisk,
34
+ declaration: true,
35
+ });
36
+ if (imp.default !== null)
37
+ this.internal({
38
+ type: "default",
39
+ file: imp.file,
40
+ name: imp.default,
41
+ declaration: true,
42
+ });
43
+ for (const elem of imp.elements) {
44
+ if (elem === "WebSocketAcceptor") continue;
45
+ this.internal({
46
+ type: "element",
47
+ file: imp.file,
48
+ name: elem,
49
+ declaration: true,
50
+ });
51
+ }
52
+ }
53
+ }
54
+
55
+ public external(props: ImportDictionary.IProps): string {
56
+ const file: string = `node_modules/${props.file}`;
57
+ return this.internal({
58
+ ...props,
59
+ file,
60
+ });
61
+ }
62
+
63
+ public internal(props: ImportDictionary.IProps): string {
64
+ const file: string = normalize(trimSourceExtension(props.file));
65
+ const key: ICompositeKey = {
66
+ file: file,
67
+ declaration: props.declaration,
68
+ asterisk: props.type === "asterisk" ? props.name : null,
69
+ default: props.type === "default" ? props.name : null,
70
+ };
71
+ const value: ICompositeValue = this.components_.take(key, () => ({
72
+ ...key,
73
+ elements: new TreeMap<string, string | null>(),
74
+ }));
75
+ if (props.type === "element")
76
+ value.elements.set(props.name, props.alias ?? null);
77
+ return props.type === "element" ? (props.alias ?? props.name) : props.name;
78
+ }
79
+
80
+ public toStatements(outDir: string): Node[] {
81
+ outDir = path.resolve(outDir);
82
+
83
+ const external: Node[] = [];
84
+ const internal: Node[] = [];
85
+ const locator = (str: string) => {
86
+ const location: string = path
87
+ .relative(outDir, str)
88
+ .split(path.sep)
89
+ .join("/");
90
+ const index: number = location.lastIndexOf(NODE_MODULES);
91
+ return index === -1
92
+ ? location.startsWith("..")
93
+ ? location
94
+ : `./${location}`
95
+ : location.substring(index + NODE_MODULES.length);
96
+ };
97
+ const enroll =
98
+ (filter: (str: string) => boolean) => (container: Node[]) => {
99
+ const compositions: ICompositeValue[] = this.components_
100
+ .toJSON()
101
+ .filter((c) => filter(c.second.file))
102
+ .map(
103
+ (e) =>
104
+ ({
105
+ ...e.second,
106
+ file: locator(e.second.file),
107
+ }) satisfies ICompositeValue,
108
+ )
109
+ .sort((a, b) => a.file.localeCompare(b.file));
110
+ for (const c of compositions)
111
+ container.push(
112
+ TypeScriptFactory.createImportDeclaration(
113
+ undefined,
114
+ this.toImportClaude(c),
115
+ TypeScriptFactory.createStringLiteral(c.file),
116
+ undefined,
117
+ ),
118
+ );
119
+ };
120
+
121
+ enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
122
+ enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
123
+ return [
124
+ ...external,
125
+ ...(external.length && internal.length ? [FilePrinter.enter()] : []),
126
+ ...internal,
127
+ ];
128
+ }
129
+
130
+ private toImportClaude(c: ICompositeValue): Node {
131
+ if (c.asterisk !== null)
132
+ return TypeScriptFactory.createImportClause(
133
+ c.declaration,
134
+ undefined,
135
+ TypeScriptFactory.createNamespaceImport(
136
+ TypeScriptFactory.createIdentifier(c.asterisk),
137
+ ),
138
+ );
139
+ return TypeScriptFactory.createImportClause(
140
+ c.declaration,
141
+ c.default !== null
142
+ ? TypeScriptFactory.createIdentifier(c.default)
143
+ : undefined,
144
+ c.elements.size() !== 0
145
+ ? TypeScriptFactory.createNamedImports(
146
+ Array.from(c.elements).map(({ first: name, second: alias }) =>
147
+ TypeScriptFactory.createImportSpecifier(
148
+ c.declaration,
149
+ alias !== null
150
+ ? TypeScriptFactory.createIdentifier(name)
151
+ : undefined,
152
+ TypeScriptFactory.createIdentifier(alias ?? name),
153
+ ),
154
+ ),
155
+ )
156
+ : undefined,
157
+ );
158
+ }
159
+ }
160
+ export namespace ImportDictionary {
161
+ export interface IProps {
162
+ type: "default" | "element" | "asterisk";
163
+ file: string;
164
+ name: string;
165
+ alias?: string;
166
+ declaration: boolean;
167
+ }
168
+ }
169
+
170
+ interface ICompositeKey {
171
+ file: string;
172
+ declaration: boolean;
173
+ asterisk: string | null;
174
+ default: string | null;
175
+ }
176
+ interface ICompositeValue extends ICompositeKey {
177
+ elements: TreeMap<string, string | null>;
178
+ }
179
+
180
+ const NODE_MODULES = "node_modules/";
181
+ const SOURCE_EXTENSIONS: string[] = [
182
+ ".d.mts",
183
+ ".d.cts",
184
+ ".d.ts",
185
+ ".mts",
186
+ ".cts",
187
+ ".tsx",
188
+ ".ts",
189
+ ".mjs",
190
+ ".cjs",
191
+ ".jsx",
192
+ ".js",
193
+ ];
194
+
195
+ const normalize = (file: string): string => {
196
+ file = path.resolve(file);
197
+ if (file.includes(`node_modules${path.sep}`))
198
+ file =
199
+ "node_modules/" +
200
+ file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
201
+ return file;
202
+ };
203
+
204
+ const trimSourceExtension = (file: string): string => {
205
+ if (file.startsWith(`${NODE_MODULES}`)) return file;
206
+ for (const ext of SOURCE_EXTENSIONS)
207
+ if (file.endsWith(ext)) return file.substring(0, file.length - ext.length);
208
+ return file;
209
+ };