@kosmojs/lib 0.2.1 → 0.2.3

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.
package/pkg/index.js CHANGED
@@ -1,1303 +1,21 @@
1
- import { builtinModules } from "node:module";
2
- import { styleText } from "node:util";
3
- import crc from "crc/crc32";
4
- import flattener from "tfusion";
5
- import { ModuleResolutionKind, Project, SyntaxKind } from "ts-morph";
6
- import { RequestValidationTargets, defaults } from "@kosmojs/core";
7
- import { HTTPMethods } from "@kosmojs/core/api";
8
- import { mergeConfig } from "vite";
9
- import { access, constants, mkdir, readFile, stat, writeFile } from "node:fs/promises";
10
- import { basename, dirname, isAbsolute, join, parse, resolve } from "node:path";
11
- import handlebars from "handlebars";
12
- import picomatch from "picomatch";
13
- import { glob } from "tinyglobby";
14
- import { compile, parse as parse$1 } from "path-to-regexp";
15
- import { lookup } from "mrmime";
16
- import { Spinner } from "@topcli/spinner";
17
- //#region src/generic.ts
18
- var mergeConfigs = (...configs) => {
19
- return [{
20
- configFile: false,
21
- define: {
22
- KOSMO_PRODUCTION_BUILD: "false",
23
- KOSMO_SERVERSIDE_FETCH: "false"
24
- }
25
- }, ...configs].reduce((config, prev) => mergeConfig(config || {}, prev || {}), {});
26
- };
27
- var escapeTemplateLiterals = (origin) => {
28
- return [[/(?<!\\)`/g, "\\`"], [/(?<!\\)\$\{/g, "\\${"]].reduce((text, [a, b]) => text.replace(a, b), origin);
29
- };
30
- //#endregion
31
- //#region src/paths.ts
32
- var pathResolver = (sourceFolder) => {
33
- const createPath = (...a) => {
34
- return sourceFolder.root ? resolve(sourceFolder.root, join(...a)) : join(...a);
35
- };
36
- const createImport = {
37
- src(a, { origin }) {
38
- return origin === "src" ? join(defaults.srcPrefix, ...a) : join(defaults.appPrefix, defaults.srcDir, sourceFolder.name, ...a);
39
- },
40
- api(a, o) {
41
- return this.src([defaults.apiDir, ...a], o);
42
- },
43
- entry(a, o) {
44
- return this.src([defaults.entryDir, ...a], o);
45
- },
46
- pages(a, o) {
47
- return this.src([defaults.pagesDir, ...a], o);
48
- },
49
- lib(a, { origin }) {
50
- return origin === "src" ? join(defaults.libPrefix, ...a) : join(defaults.appPrefix, defaults.libDir, sourceFolder.name, ...a);
51
- },
52
- libCore(a, o) {
53
- return this.lib(["core", ...a], o);
54
- },
55
- libApi(a, o) {
56
- return this.lib([defaults.apiDir, ...a], o);
57
- },
58
- libEntry(a, o) {
59
- return this.lib([defaults.entryDir, ...a], o);
60
- }
61
- };
62
- return {
63
- createPath: {
64
- src(...a) {
65
- return createPath(defaults.srcDir, sourceFolder.name, ...a);
66
- },
67
- api(...a) {
68
- return this.src(defaults.apiDir, ...a);
69
- },
70
- pages(...a) {
71
- return this.src(defaults.pagesDir, ...a);
72
- },
73
- entry(...a) {
74
- return this.src(defaults.entryDir, ...a);
75
- },
76
- lib(...a) {
77
- return createPath(defaults.libDir, sourceFolder.name, ...a);
78
- },
79
- libCore(...a) {
80
- return this.lib("core", ...a);
81
- },
82
- libApi(...a) {
83
- return this.lib(defaults.apiDir, ...a);
84
- },
85
- libEntry(...a) {
86
- return this.lib(defaults.entryDir, ...a);
87
- },
88
- libPages(...a) {
89
- return this.lib(defaults.pagesDir, ...a);
90
- },
91
- distDir(...a) {
92
- return createPath(sourceFolder.distDir, sourceFolder.name, ...a);
93
- }
94
- },
95
- createImport,
96
- createImportHelpers(o) {
97
- if (!["src", "lib"].includes(o?.origin)) throw new Error(`createImportHelpers: required exactly one argument of shape { origin: "src|lib" }`);
98
- return { createImport(key, ...a) {
99
- return createImport[key](a.slice(0, -1), o);
100
- } };
101
- }
102
- };
103
- };
104
- var pathExists = async (path) => {
105
- try {
106
- await access(path, constants.F_OK);
107
- return true;
108
- } catch {
109
- return false;
110
- }
111
- };
112
- //#endregion
113
- //#region src/render.ts
114
- var render = (template, context, options) => {
115
- const { noEscape = true, renderer = handlebars } = { ...options };
116
- return renderer.compile(template, { noEscape })(context);
117
- };
118
- var renderToFile = async (file, template, context, options) => {
119
- const content = render(template, context, options);
120
- /**
121
- * Two fs calls (exists + read) are worth it to avoid touching the file
122
- * and triggering watchers unnecessarily.
123
- * */
124
- if (await pathExists(file)) {
125
- const { overwrite = true } = { ...options };
126
- if (overwrite === false) return;
127
- const fileContent = await readFile(file, "utf8");
128
- if (typeof overwrite === "function" && !overwrite(fileContent)) return;
129
- if (crc(content) === crc(fileContent)) return;
130
- }
131
- await mkdir(dirname(file), { recursive: true });
132
- await writeFile(file, content, "utf8");
133
- };
134
- var renderFactory = (options) => {
135
- const createRenderer = (selfOoptions) => {
136
- const renderer = handlebars.create();
137
- renderer.registerPartial({
138
- ...options?.partials,
139
- ...selfOoptions?.partials
140
- });
141
- renderer.registerHelper({
142
- ...options?.helpers,
143
- ...selfOoptions?.helpers
144
- });
145
- return renderer;
146
- };
147
- return {
148
- render(template, context, selfOoptions) {
149
- return render(template, context, {
150
- ...options,
151
- ...selfOoptions,
152
- renderer: createRenderer(selfOoptions)
153
- });
154
- },
155
- async renderToFile(file, template, context, selfOoptions) {
156
- return renderToFile(options?.outdir ? join(options.outdir, file) : file, template, context, {
157
- ...options,
158
- ...selfOoptions,
159
- renderer: createRenderer(selfOoptions)
160
- });
161
- }
162
- };
163
- };
164
- //#endregion
165
- //#region src/templates/resolved-types.hbs?raw
166
- var resolved_types_default = "{{#each resolvedTypes}}\nexport type {{name}} = {{text}};\n{{/each}}\n";
167
- //#endregion
168
- //#region src/templates/types.hbs?raw
169
- var types_default = "{{#each typeDeclarations}}{{text}}\n{{/each}}\n\nexport type {{params.id}} = {\n {{#each paramsSchema}}\n \"{{name}}\"{{#unless isRequired}}?{{/unless}}: {{#if refinement}}\n {{refinement.text}},\n {{else}}\n {{#if isSplat}}Array<string>{{else}}string{{/if}},\n {{/if}}\n {{/each}}\n};\n\n{{#each validationTypes}}export type {{id}} = {{text}};\n{{/each}}\n";
170
- //#endregion
171
- //#region src/ast.ts
172
- var astFactory = () => {
173
- const createProject = (opts) => new Project(opts);
174
- const resolveRouteSignature = async (route, opts) => {
175
- const { sourceFile = createProject().addSourceFileAtPath(route.fileFullpath) } = { ...opts };
176
- const [typeDeclarations, referencedFiles] = extractTypeDeclarations(sourceFile, opts);
177
- const defaultExport = extractDefaultExport(sourceFile);
178
- const paramsRefinements = defaultExport ? extractParamsRefinements(defaultExport) : void 0;
179
- const methods = defaultExport ? extractRouteMethods(route, defaultExport) : [];
180
- return {
181
- typeDeclarations,
182
- paramsRefinements,
183
- methods: methods.map((e) => e.method),
184
- validationDefinitions: methods.flatMap((e) => e.validationDefinitions),
185
- referencedFiles
186
- };
187
- };
188
- const extractDefaultExport = (sourceFile) => {
189
- const [defaultExport] = sourceFile.getExportAssignments().flatMap((exportAssignment) => {
190
- if (exportAssignment.isExportEquals()) return [];
191
- const callExpression = exportAssignment.getExpression();
192
- return callExpression.isKind(SyntaxKind.CallExpression) ? [callExpression] : [];
193
- });
194
- return defaultExport;
195
- };
196
- const extractParamsRefinements = (callExpression) => {
197
- const [_routeName, paramsGeneric] = extractGenerics(callExpression);
198
- if (!paramsGeneric?.isKind(SyntaxKind.TupleType)) return;
199
- return paramsGeneric.getElements().map((node, index) => {
200
- return {
201
- index,
202
- text: node.getText()
203
- };
204
- });
205
- };
206
- const extractRouteMethods = (route, callExpression) => {
207
- const funcDeclaration = callExpression.getFirstChildByKind(SyntaxKind.ArrowFunction) || callExpression.getFirstChildByKind(SyntaxKind.FunctionExpression);
208
- if (!funcDeclaration) return [];
209
- const arrayLiteralExpression = funcDeclaration.getFirstChildByKind(SyntaxKind.ArrayLiteralExpression);
210
- if (!arrayLiteralExpression) return [];
211
- const callExpressions = [];
212
- for (const e of arrayLiteralExpression.getChildrenOfKind(SyntaxKind.CallExpression)) {
213
- const name = e.getExpression().getText();
214
- if (HTTPMethods[name]) callExpressions.push([e, name]);
215
- }
216
- const methods = [];
217
- for (const [callExpression, method] of callExpressions) {
218
- const [vDefs, vOpts] = extractGenerics(callExpression);
219
- methods.push({
220
- method,
221
- validationDefinitions: extractValidationDefinitions(route, method, vDefs, vOpts)
222
- });
223
- }
224
- return methods;
225
- };
226
- /** Parse a boolean literal type node */
227
- const parseRuntimeValidation = (typeNode) => {
228
- if (typeNode.isKind(SyntaxKind.LiteralType)) {
229
- const literal = typeNode.getFirstChild();
230
- if (literal?.isKind(SyntaxKind.TrueKeyword)) return true;
231
- else if (literal?.isKind(SyntaxKind.FalseKeyword)) return false;
232
- }
233
- };
234
- const extractResponseVariant = (typeNode) => {
235
- if (!typeNode.isKind(SyntaxKind.TupleType)) return;
236
- let status = 200;
237
- let contentType;
238
- let body;
239
- const [statusNode, contentTypeNode, bodyNode] = typeNode.getElements();
240
- if (statusNode?.isKind(SyntaxKind.LiteralType)) {
241
- const literal = statusNode.getFirstChildByKind(SyntaxKind.NumericLiteral);
242
- if (literal) status = Number(literal.getText());
243
- }
244
- if (contentTypeNode) contentType = extractStringLiteral(contentTypeNode);
245
- if (bodyNode) {
246
- body = bodyNode.getText();
247
- if (["object"].includes(body)) body = "{}";
248
- }
249
- return {
250
- status,
251
- contentType,
252
- body
253
- };
254
- };
255
- /** Parse opts TypeLiteral into a map keyed by target */
256
- const parseValidationOptions = (typeNode) => {
257
- const opts = {};
258
- if (!typeNode?.isKind(SyntaxKind.TypeLiteral)) return opts;
259
- for (const prop of typeNode.getMembers()) {
260
- if (!prop.isKind(SyntaxKind.PropertySignature)) continue;
261
- const target = prop.getName();
262
- const typeNode = prop.getTypeNodeOrThrow();
263
- if (!typeNode.isKind(SyntaxKind.TypeLiteral)) continue;
264
- let contentType;
265
- let runtimeValidation;
266
- const customErrors = {};
267
- for (const member of typeNode.getMembers()) {
268
- if (!member.isKind(SyntaxKind.PropertySignature)) continue;
269
- const nameNode = member.getNameNode();
270
- const valueNode = member.getTypeNodeOrThrow();
271
- const name = nameNode.isKind(SyntaxKind.StringLiteral) ? nameNode.getLiteralText() : nameNode.getText();
272
- if (name === "contentType") contentType = extractStringLiteral(valueNode);
273
- else if (name === "runtimeValidation") runtimeValidation = parseRuntimeValidation(valueNode);
274
- else if (name.startsWith("error")) {
275
- const literal = extractStringLiteral(valueNode);
276
- if (literal) customErrors[name] = literal;
277
- }
278
- }
279
- opts[target] = {
280
- contentType,
281
- runtimeValidation,
282
- customErrors
283
- };
284
- }
285
- return opts;
286
- };
287
- const extractStringLiteral = (typeNode) => {
288
- const literal = typeNode.isKind(SyntaxKind.LiteralType) ? typeNode.getFirstChildByKind(SyntaxKind.StringLiteral) : void 0;
289
- return literal ? literal.getLiteralText() : void 0;
290
- };
291
- /**
292
- * Extract validation definitions from route handler generics.
293
- * Merges defs (schemas) and opts (validation options) into a flat array.
294
- * */
295
- const extractValidationDefinitions = (route, method, defsNode, optsNode) => {
296
- const definitions = [];
297
- if (!defsNode?.isKind(SyntaxKind.TypeLiteral)) return definitions;
298
- const optsMap = parseValidationOptions(optsNode);
299
- const createId = (target, hash) => {
300
- return [
301
- target.replace(/^./, (c) => c.toUpperCase()),
302
- "T",
303
- method,
304
- crc(route.id + hash)
305
- ].join("");
306
- };
307
- for (const prop of defsNode.getMembers()) {
308
- if (!prop.isKind(SyntaxKind.PropertySignature)) continue;
309
- const target = prop.getName();
310
- const typeNode = prop.getTypeNodeOrThrow();
311
- if (target === "response") {
312
- const variants = typeNode.isKind(SyntaxKind.UnionType) ? typeNode.getChildrenOfKind(SyntaxKind.TupleType) : [typeNode];
313
- definitions.push({
314
- ...optsMap[target],
315
- method,
316
- target,
317
- variants: variants.flatMap((e, i) => {
318
- const { status, contentType, body } = { ...extractResponseVariant(e) };
319
- if (!status) return [];
320
- if (contentType && typeof contentType !== "string") {
321
- console.warn(styleText(["bold", "red"], `✗ The second element of a response variant should specify the Response Content Type`));
322
- console.warn(styleText(["blue"], ` Example: [200, "json", Schema]`));
323
- console.warn(` Route: ${route.name}; Method: ${method}; Response Variant: #${i}`);
324
- console.warn();
325
- }
326
- return [{
327
- id: createId(target, JSON.stringify([
328
- status,
329
- contentType,
330
- body
331
- ])),
332
- status,
333
- contentType,
334
- body
335
- }];
336
- })
337
- });
338
- } else if (Object.keys(RequestValidationTargets).includes(target)) definitions.push({
339
- ...optsMap[target],
340
- method,
341
- target,
342
- schema: {
343
- id: createId(target),
344
- text: typeNode.getText()
345
- }
346
- });
347
- }
348
- return definitions;
349
- };
350
- const extractTypeDeclarations = (sourceFile, opts) => {
351
- const declarations = [];
352
- const referencedFiles = opts?.withReferencedFiles ? [] : void 0;
353
- for (const declaration of sourceFile.getImportDeclarations()) {
354
- const modulePath = declaration.getModuleSpecifierValue();
355
- const path = /^\.\.?\/?/.test(modulePath) ? opts?.relpathResolver ? opts.relpathResolver(modulePath) : modulePath : modulePath;
356
- const typeOnlyDeclaration = declaration.isTypeOnly();
357
- const defaultImport = typeOnlyDeclaration ? declaration.getDefaultImport() : void 0;
358
- if (defaultImport) {
359
- const name = defaultImport.getText();
360
- const text = `import type ${name} from "${path}";`;
361
- declarations.push({
362
- importDeclaration: {
363
- name,
364
- path
365
- },
366
- text
367
- });
368
- if (referencedFiles) referencedFiles.push(...getReferencedFiles(defaultImport));
369
- }
370
- const namespaceImport = typeOnlyDeclaration ? declaration.getNamespaceImport() : void 0;
371
- if (namespaceImport) {
372
- const name = namespaceImport.getText();
373
- const text = `import type * as ${name} from "${path}";`;
374
- declarations.push({
375
- importDeclaration: {
376
- name,
377
- path
378
- },
379
- text
380
- });
381
- if (referencedFiles) referencedFiles.push(...getReferencedFiles(namespaceImport));
382
- }
383
- for (const namedImport of declaration.getNamedImports()) if (namedImport.isTypeOnly() || typeOnlyDeclaration) {
384
- const nameNode = namedImport.getNameNode();
385
- const name = nameNode.getText();
386
- const alias = namedImport.getAliasNode()?.getText();
387
- const nameText = alias ? `${name} as ${alias}` : name;
388
- declarations.push({
389
- importDeclaration: {
390
- name,
391
- alias,
392
- path
393
- },
394
- text: `import type { ${nameText} } from "${path}";`
395
- });
396
- if (referencedFiles) {
397
- if (nameNode.isKind(SyntaxKind.Identifier)) referencedFiles.push(...getReferencedFiles(nameNode));
398
- }
399
- }
400
- }
401
- for (const declaration of sourceFile.getTypeAliases()) {
402
- const name = declaration.getName();
403
- const text = declaration.getFullText().trim();
404
- declarations.push({
405
- typeAliasDeclaration: { name },
406
- text
407
- });
408
- }
409
- for (const declaration of sourceFile.getInterfaces()) {
410
- const name = declaration.getName();
411
- const text = declaration.getFullText().trim();
412
- declarations.push({
413
- interfaceDeclaration: { name },
414
- text
415
- });
416
- }
417
- for (const declaration of sourceFile.getEnums()) {
418
- const name = declaration.getName();
419
- const text = declaration.getFullText().trim();
420
- declarations.push({
421
- enumDeclaration: { name },
422
- text
423
- });
424
- }
425
- for (const declaration of sourceFile.getExportDeclarations()) {
426
- const typeOnlyDeclaration = declaration.isTypeOnly();
427
- const modulePath = declaration.getModuleSpecifierValue();
428
- const path = modulePath ? /^\.\.?\/?/.test(modulePath) ? opts?.relpathResolver ? opts.relpathResolver(modulePath) : modulePath : modulePath : void 0;
429
- for (const namedExport of declaration.getNamedExports()) if (namedExport.isTypeOnly() || typeOnlyDeclaration) {
430
- const nameNode = namedExport.getNameNode();
431
- const name = nameNode.getText();
432
- const alias = namedExport.getAliasNode()?.getText();
433
- const nameText = alias ? `${name} as ${alias}` : name;
434
- declarations.push({
435
- exportDeclaration: {
436
- name,
437
- alias: alias ?? name,
438
- path
439
- },
440
- text: path ? `export type { ${nameText} } from "${path}";` : `export type { ${nameText} };`
441
- });
442
- if (referencedFiles) {
443
- if (nameNode.isKind(SyntaxKind.Identifier)) referencedFiles.push(...getReferencedFiles(nameNode));
444
- }
445
- }
446
- }
447
- return referencedFiles ? [declarations, [...new Set(referencedFiles)]] : [declarations];
448
- };
449
- const getReferencedFiles = (importIdentifier) => {
450
- return (importIdentifier?.getSymbol()?.getAliasedSymbol()?.getDeclarations() || []).flatMap((e) => {
451
- const sourceFile = e.getSourceFile();
452
- return sourceFile ? [sourceFile.getFilePath()] : [];
453
- });
454
- };
455
- const extractGenerics = (callExpression) => {
456
- return callExpression.getTypeArguments();
457
- };
458
- const typeResolverFactory = (sourceFolder) => {
459
- const { createPath } = pathResolver(sourceFolder);
460
- const project = createProject({ compilerOptions: {
461
- moduleResolution: ModuleResolutionKind.Bundler,
462
- types: [],
463
- noLib: true,
464
- skipLibCheck: true,
465
- paths: {
466
- [`${defaults.appPrefix}/*`]: [`${sourceFolder.root}/*`],
467
- [`${defaults.srcPrefix}/*`]: [createPath.src("*")],
468
- [`${defaults.libPrefix}/*`]: [createPath.lib("*")]
469
- }
470
- } });
471
- const withTypeboxSchema = (resolvedTypes) => {
472
- const materializedTypes = render(resolved_types_default, { resolvedTypes });
473
- const sourceFile = project.createSourceFile(`${crc(materializedTypes)}-${Date.now()}.ts`, materializedTypes, { overwrite: true });
474
- const types = resolvedTypes.map((type) => {
475
- const typeNode = sourceFile.getTypeAlias(type.name)?.getTypeNode();
476
- if (!typeNode) return type;
477
- const properties = type.properties ? type.properties.map((prop) => {
478
- const propNode = typeNode.isKind(SyntaxKind.TypeLiteral) ? typeNode.getProperty(prop.name)?.getTypeNode() : void 0;
479
- if (!propNode) return prop;
480
- return {
481
- ...prop,
482
- typeboxSchema: renderTypeboxSchema(propNode)
483
- };
484
- }) : void 0;
485
- return {
486
- ...type,
487
- ...properties ? { properties } : {},
488
- typeboxSchema: renderTypeboxSchema(typeNode)
489
- };
490
- });
491
- project.removeSourceFile(sourceFile);
492
- return types;
493
- };
494
- const literalTypesResolver = (literalTypes, options) => {
495
- const sourceFile = project.createSourceFile(`${crc(literalTypes)}-${Date.now()}.ts`, literalTypes, { overwrite: true });
496
- const resolvedTypes = flattener(project, sourceFile, {
497
- ...options,
498
- stripComments: true
499
- });
500
- project.removeSourceFile(sourceFile);
501
- return withTypeboxSchema(resolvedTypes);
502
- };
503
- return {
504
- getSourceFile: (fileFullpath) => {
505
- return project.getSourceFile(fileFullpath) || project.addSourceFileAtPath(fileFullpath);
506
- },
507
- refreshSourceFile: async (fileFullpath) => {
508
- const sourceFile = project.getSourceFile(fileFullpath);
509
- if (sourceFile) await sourceFile.refreshFromFileSystem();
510
- },
511
- literalTypesResolver
512
- };
513
- };
514
- return {
515
- createProject,
516
- extractDefaultExport,
517
- extractParamsRefinements,
518
- extractRouteMethods,
519
- extractTypeDeclarations,
520
- resolveRouteSignature,
521
- typeResolverFactory
522
- };
523
- };
524
- /**
525
- * Render a ts-morph TypeNode to TypeBox Script text, replacing every VRefine
526
- * occurrence (at any depth) with the infix `with` form.
527
- *
528
- * VRefine<string, { format: "email" }> -> (string with { format: "email" })
529
- * VRefine<string, { format: "email" }>[] -> (string with { format: "email" })[]
530
- * VRefine<Array<string>, { minItems: 1 }> -> (Array<string> with { minItems: 1 })
531
- * VRefine<Record<string, string>, { maxProperties: 20 }>
532
- * -> (Record<string, string> with { maxProperties: 20 })
533
- *
534
- * The parentheses matter: for an array element the `with` clause must bind to
535
- * the element, not the array, so a VRefine that is the element of an array is
536
- * wrapped. We wrap unconditionally - harmless when not nested, required when it
537
- * is.
538
- *
539
- * @param typeNode the node to render
540
- * @param refineTypeName the configured refine type name
541
- * */
542
- var renderTypeboxSchema = (typeNode, refineTypeName = defaults.refineTypeName) => {
543
- const traverse = (typeNode) => {
544
- if (typeNode.isKind(SyntaxKind.TypeReference) && typeNode.getTypeName().getText() === refineTypeName) {
545
- const [inner, opts] = typeNode.getTypeArguments();
546
- if (!inner || !opts) return typeNode.getText();
547
- return `(${traverse(inner)} with ${opts.getText()})`;
548
- }
549
- if (typeNode.isKind(SyntaxKind.ArrayType)) return `${traverse(typeNode.getElementTypeNode())}[]`;
550
- if (typeNode.isKind(SyntaxKind.TypeLiteral)) {
551
- const members = [];
552
- for (const member of typeNode.getMembers()) if (member.isKind(SyntaxKind.PropertySignature)) {
553
- const name = member.getName();
554
- const optional = member.hasQuestionToken() ? "?" : "";
555
- const t = member.getTypeNode();
556
- const rendered = t ? traverse(t) : "unknown";
557
- members.push(`${name}${optional}: ${rendered}`);
558
- } else members.push(member.getText());
559
- return `{ ${members.join(", ")} }`;
560
- }
561
- if (typeNode.isKind(SyntaxKind.TupleType)) return `[${typeNode.getElements().map((el) => traverse(el)).join(", ")}]`;
562
- if (typeNode.isKind(SyntaxKind.ParenthesizedType)) return `(${traverse(typeNode.getTypeNode())})`;
563
- if (typeNode.isKind(SyntaxKind.UnionType)) return typeNode.getTypeNodes().map((t) => traverse(t)).join(" | ");
564
- if (typeNode.isKind(SyntaxKind.IntersectionType)) return typeNode.getTypeNodes().map((t) => traverse(t)).join(" & ");
565
- if (typeNode.isKind(SyntaxKind.TypeReference)) {
566
- const args = typeNode.getTypeArguments();
567
- if (args.length === 0) return typeNode.getText();
568
- return `${typeNode.getTypeName().getText()}<${args.map((a) => traverse(a)).join(", ")}>`;
569
- }
570
- return typeNode.getText();
571
- };
572
- return escapeTemplateLiterals(traverse(typeNode));
573
- };
574
- //#endregion
575
- //#region src/generators.ts
576
- var defineGenerator = (f) => f;
577
- var defineGeneratorFactory = (f) => f;
578
- //#endregion
579
- //#region src/routes/paths.ts
580
- /**
581
- * Parse a filesystem route path into structured PathToken array.
582
- *
583
- * Uses path-to-regexp v8 AST for parsing, with directory-friendly syntax:
584
- * - [param] => required param - :param
585
- * - {param} => optional param - {:param}
586
- * - {...param} => splat - {*param}
587
- *
588
- * Direct :param syntax is prohibited outside {} to avoid ambiguity.
589
- * Inside {} it is treated as path-to-regexp power syntax and used as-is.
590
- *
591
- * Throw error if path can not be compiled into path-to-regexp pattern.
592
- *
593
- * Examples:
594
- * Required: [id], [name]
595
- * Optional: {name}, {format}
596
- * Splat: {...path}
597
- * Mixed segments: shop/[id]-{name}
598
- * Power syntax: {-v:version{-:pre}}, :name{@:version{.:min}}.js
599
- * */
600
- var pathTokensFactory = (path) => {
601
- /**
602
- * Recursively extract parts from path-to-regexp AST tokens.
603
- * A param inside a group is optional; top-level params are required.
604
- * Wildcard tokens are always splat.
605
- * Slash-only text nodes (restored for parsing) are skipped.
606
- * */
607
- const extractParts = (tokens, createConst, insideGroup = false) => {
608
- const parts = [];
609
- for (const token of tokens) switch (token.type) {
610
- case "text":
611
- if (token.value !== "/") parts.push({
612
- type: "static",
613
- value: token.value
614
- });
615
- break;
616
- case "param":
617
- parts.push({
618
- type: "param",
619
- kind: insideGroup ? "optional" : "required",
620
- name: token.name,
621
- const: createConst(token.name)
622
- });
623
- break;
624
- case "wildcard":
625
- parts.push({
626
- type: "param",
627
- kind: "splat",
628
- name: token.name,
629
- const: createConst(token.name)
630
- });
631
- break;
632
- case "group":
633
- parts.push(...extractParts(token.tokens, createConst, true));
634
- break;
635
- }
636
- return parts;
637
- };
638
- const patternTransforms = [
639
- (s) => s.replace(/\[(\w+)\]/g, ":$1"),
640
- (s) => s.replace(/\{(\w+)\}/g, "{:$1}"),
641
- (s) => s.replace(/\{\.\.\./g, "{*"),
642
- (s) => {
643
- return s.startsWith("{") ? s.replace(/^\{/, "{/") : s;
644
- }
645
- ];
646
- const detectBareParams = (s) => {
647
- let depth = 0;
648
- for (const [i, ch] of [...s].entries()) if (ch === "{") depth += 1;
649
- else if (ch === "}") depth -= 1;
650
- else if (ch === ":" && depth === 0) return s.slice(i + 1).match(/^\w+/)?.[0] || ":";
651
- };
652
- const tokens = path.replace(/^index\/?/, "").split("/").flatMap((orig) => {
653
- if (!orig.length) return [];
654
- const bareParam = detectBareParams(orig);
655
- if (bareParam === ":") throw new Error(`${path} contains colons outside braces, use : only within {}`);
656
- else if (bareParam) throw new Error(`${path} contains bare params, use [${bareParam}] instead of :${bareParam}`);
657
- const pattern = patternTransforms.reduce((src, fn) => fn(src), orig);
658
- const { tokens } = parse$1(pattern.replace(/\{[^}]*\}|(\+)/g, (m, p1) => p1 ? "\\+" : m));
659
- const parts = extractParts(tokens, (val) => {
660
- return /\W/.test(val) || /^\d/.test(val) ? [val.replace(/^\d+|\W/g, "_"), crc(orig)].join("_") : val;
661
- });
662
- const isStatic = parts.length === 1 ? parts[0].type === "static" : false;
663
- const isParam = parts.length === 1 ? parts[0].type === "param" : false;
664
- return [{
665
- kind: isStatic ? "static" : isParam ? "param" : "mixed",
666
- orig,
667
- pattern,
668
- parts
669
- }];
670
- });
671
- compile(tokens.map((e) => e.pattern).join("/"));
672
- return tokens;
673
- };
674
- var createPathPattern = (tokens) => {
675
- return tokens.map(({ pattern }, i) => {
676
- const next = tokens[i + 1];
677
- if (!next || next.pattern.includes("/")) return pattern;
678
- return tokens.slice(i + 1).some((e) => {
679
- return e.parts.some((e) => {
680
- return e.type === "static" || e.kind === "required";
681
- });
682
- }) ? `${pattern}/` : pattern;
683
- }).join("");
684
- };
685
- var createHonoPattern = (tokens) => {
686
- const paramValue = (p) => {
687
- if (p.kind === "splat") return `*`;
688
- if (p.kind === "optional") return `:${p.name}?`;
689
- return `:${p.name}`;
690
- };
691
- const escapeRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
692
- const tokensToRegex = (tokens) => {
693
- return tokens.flatMap((t) => {
694
- if (t.type === "text") return t.value === "/" ? [] : [escapeRegex(t.value)];
695
- if (t.type === "wildcard") return [".+"];
696
- if (t.type === "param") return ["[^/]+"];
697
- if (t.type === "group") return [`(?:${tokensToRegex(t.tokens)})?`];
698
- return [];
699
- }).join("");
700
- };
701
- return tokens.flatMap((token, i) => {
702
- if (token.kind === "static") return [token.parts[0].value];
703
- if (token.kind === "param") return [paramValue(token.parts[0])];
704
- const { tokens } = parse$1(token.pattern.replace(/\//g, ""));
705
- return [`:_${i}{${tokensToRegex(tokens)}}`];
706
- }).join("/");
707
- };
708
- //#endregion
709
- //#region src/routes/base.ts
710
- var API_INDEX_BASENAME = "index";
711
- var API_INDEX_PATTERN = `${API_INDEX_BASENAME}.ts`;
712
- var API_USE_BASENAME = "use";
713
- var API_USE_PATTERN = `use.ts`;
714
- var PAGE_INDEX_BASENAME = "index";
715
- var PAGE_INDEX_PATTERN = `${PAGE_INDEX_BASENAME}.{tsx,vue,svelte,mdx,md}`;
716
- var PAGE_LAYOUT_BASENAME = "layout";
717
- var PAGE_LAYOUT_PATTERN = `${PAGE_LAYOUT_BASENAME}.{tsx,vue,svelte,mdx}`;
718
- var ROUTE_FILE_PATTERNS = [
719
- `${defaults.apiDir}/**/${API_INDEX_PATTERN}`,
720
- `${defaults.apiDir}/**/${API_USE_PATTERN}`,
721
- `${defaults.pagesDir}/**/${PAGE_INDEX_PATTERN}`,
722
- `${defaults.pagesDir}/**/${PAGE_LAYOUT_PATTERN}`
723
- ];
724
- var scanRoutes = async (sourceFolder) => {
725
- const { createPath } = pathResolver(sourceFolder);
726
- return glob(ROUTE_FILE_PATTERNS, {
727
- cwd: createPath.src(),
728
- absolute: true,
729
- onlyFiles: true,
730
- followSymbolicLinks: false,
731
- ignore: [
732
- `${defaults.apiDir}/${API_INDEX_PATTERN}`,
733
- `${defaults.apiDir}/${API_USE_PATTERN}`,
734
- `${defaults.pagesDir}/${PAGE_INDEX_PATTERN}`,
735
- `${defaults.pagesDir}/${PAGE_LAYOUT_PATTERN}`
736
- ]
737
- });
738
- };
739
- var isRouteFile = (file, sourceFolder) => {
740
- const [_sourceFolder, _folder, ...rest] = resolve(sourceFolder.root, file).replace(`${sourceFolder.root}/${defaults.srcDir}/`, "").split("/");
741
- /**
742
- * Ensure the file:
743
- * - is under the correct source root
744
- * - belongs to a known route folder (`api/` or `pages/`)
745
- * - is nested at least one level deep (not a direct child of the folder)
746
- * */
747
- if (!_folder || _sourceFolder !== sourceFolder.name || rest.length < 2) return false;
748
- return picomatch.isMatch(join(_folder, ...rest), ROUTE_FILE_PATTERNS) ? [_folder, rest.join("/")] : false;
749
- };
750
- var isApiRoute = (file) => {
751
- return picomatch.matchBase(file, `**/${API_INDEX_PATTERN}`);
752
- };
753
- var isApiUse = (file) => {
754
- return picomatch.matchBase(file, `**/${API_USE_PATTERN}`);
755
- };
756
- var isPageRoute = (file) => {
757
- return picomatch.matchBase(file, `**/${PAGE_INDEX_PATTERN}`);
758
- };
759
- var isPageLayout = (file) => {
760
- return picomatch.matchBase(file, `**/${PAGE_LAYOUT_PATTERN}`);
761
- };
762
- var createRouteEntry = (fileFullpath, sourceFolder) => {
763
- const resolvedPaths = isRouteFile(fileFullpath, sourceFolder);
764
- if (!resolvedPaths) return;
765
- const [folder, file] = resolvedPaths;
766
- const id = `${file.replace(/\W+/g, "_")}_${crc(file)}`;
767
- const name = dirname(file);
768
- try {
769
- const pathTokens = pathTokensFactory(dirname(file));
770
- return {
771
- id,
772
- name,
773
- folder,
774
- file,
775
- fileFullpath,
776
- pathTokens,
777
- pathPattern: createPathPattern(pathTokens),
778
- honoPattern: createHonoPattern(pathTokens)
779
- };
780
- } catch (error) {
781
- console.error(`❗${styleText("red", "ERROR")}: Failed parsing path for "${styleText("cyan", file)}"`);
782
- console.error(error.message);
783
- return;
784
- }
785
- };
786
- /**
787
- * Weight of a single path segment.
788
- *
789
- * Fixed values per kind prevent complex mixed segments
790
- * from outscoring multiple statics.
791
- *
792
- * static: 4 (exact match, most specific)
793
- * mixed: 3+ (static + param parts; more statics = slightly higher)
794
- * required: 2 (matches any single segment)
795
- * optional: 1 (may or may not match)
796
- * splat: 0 (matches anything, least specific)
797
- * */
798
- var segmentWeight = (token) => {
799
- if (token.kind === "static") return 4;
800
- if (token.kind === "mixed") {
801
- let statics = 0;
802
- let optionals = 0;
803
- for (const part of token.parts) if (part.type === "static") statics += 1;
804
- else if (part.kind === "optional" || part.kind === "splat") optionals += 1;
805
- return 3 + statics * .01 - optionals * .005;
806
- }
807
- switch (token.parts[0].kind) {
808
- case "required": return 2;
809
- case "optional": return 1;
810
- case "splat": return 0;
811
- }
812
- };
813
- /**
814
- * Compare two route entries for registration order.
815
- *
816
- * More specific routes sort first (higher priority).
817
- * Segments are compared left-to-right; first difference wins.
818
- *
819
- * When one route is a prefix of the other, the trailing segment
820
- * determines order: a trailing splat loses (shorter sibling first),
821
- * anything else wins (longer route is more specific).
822
- *
823
- * At equal weight and length, lexicographic tiebreak ensures
824
- * deterministic ordering across JS engines.
825
- * */
826
- var sortRoutes = (a, b) => {
827
- const pairs = Array.from({ length: Math.max(a.pathTokens.length, b.pathTokens.length) }, (_, i) => [a.pathTokens[i], b.pathTokens[i]]);
828
- for (const [at, bt] of pairs) {
829
- if (!at || !bt) {
830
- const extra = at ?? bt;
831
- if (extra?.kind === "param" ? extra.parts[0].kind === "splat" : false) return at ? 1 : -1;
832
- return at ? -1 : 1;
833
- }
834
- const aw = segmentWeight(at);
835
- const bw = segmentWeight(bt);
836
- if (aw !== bw) return bw - aw;
837
- }
838
- return a.pathPattern.localeCompare(b.pathPattern);
839
- };
840
- //#endregion
841
- //#region src/routes/resolve.ts
842
- var resolverFactory = (sourceFolder, cacheFactory) => {
843
- const { generators = [], refineTypeName = defaults.refineTypeName } = sourceFolder.config;
844
- const { typeResolverFactory, resolveRouteSignature } = astFactory();
845
- const resolveTypes = generators.some(({ meta }) => meta.resolveTypes);
846
- const { literalTypesResolver, getSourceFile, refreshSourceFile } = typeResolverFactory(sourceFolder);
847
- return {
848
- pageLayoutResolver(entry) {
849
- const { name } = entry;
850
- const handler = async () => {
851
- return {
852
- kind: "pageLayout",
853
- entry
854
- };
855
- };
856
- return {
857
- name,
858
- handler
859
- };
860
- },
861
- pageRouteResolver(entry) {
862
- const { id, name, folder, file, fileFullpath, pathTokens, pathPattern, honoPattern } = entry;
863
- const handler = async () => {
864
- return {
865
- kind: "pageRoute",
866
- entry: {
867
- id,
868
- name,
869
- pathTokens,
870
- pathPattern,
871
- honoPattern,
872
- params: { schema: pathTokens.flatMap((e) => {
873
- return e.parts.filter((p) => p.type === "param");
874
- }) },
875
- folder,
876
- file,
877
- fileFullpath
878
- }
879
- };
880
- };
881
- return {
882
- name,
883
- handler
884
- };
885
- },
886
- apiUseResolver(entry) {
887
- const { name } = entry;
888
- const handler = async () => {
889
- return {
890
- kind: "apiUse",
891
- entry
892
- };
893
- };
894
- return {
895
- name,
896
- handler
897
- };
898
- },
899
- apiRouteResolver(entry) {
900
- const { id, name, file, folder, fileFullpath, pathTokens, pathPattern, honoPattern } = entry;
901
- const handler = async (updatedFile) => {
902
- const paramsSchema = pathTokens.flatMap((e) => {
903
- return e.parts.flatMap((p) => {
904
- return p.type === "param" ? [p] : [];
905
- });
906
- });
907
- const optionalParams = paramsSchema.length ? paramsSchema.filter((e) => e.kind === "required").length === 0 : true;
908
- const cacheStore = cacheFactory ? cacheFactory({
909
- id,
910
- file,
911
- fileFullpath
912
- }, sourceFolder, { resolveTypes }) : void 0;
913
- let cache = cacheStore ? await cacheStore.get({ validate: true }) : void 0;
914
- if (!cache) {
915
- if (updatedFile === fileFullpath) await refreshSourceFile(fileFullpath);
916
- const { typeDeclarations, paramsRefinements, methods, validationDefinitions, referencedFiles = [] } = await resolveRouteSignature({
917
- id,
918
- name,
919
- fileFullpath,
920
- optionalParams
921
- }, {
922
- withReferencedFiles: true,
923
- sourceFile: getSourceFile(fileFullpath),
924
- relpathResolver(path) {
925
- return join(defaults.srcPrefix, defaults.apiDir, dirname(file), path);
926
- }
927
- });
928
- const validationTypes = validationDefinitions.flatMap((def) => {
929
- return def.target === "response" ? def.variants.flatMap(({ id, body }) => {
930
- return body ? [{
931
- id,
932
- text: body
933
- }] : [];
934
- }) : [def.schema];
935
- });
936
- const numericParams = paramsRefinements ? paramsRefinements.flatMap(({ text, index }) => {
937
- if (text === "number") {
938
- const param = paramsSchema.at(index);
939
- return param ? [param.name] : [];
940
- }
941
- return [];
942
- }) : [];
943
- const typesFile = pathResolver(sourceFolder).createPath.libApi(dirname(file), "types.ts");
944
- const params = {
945
- id: ["ParamsT", crc(name)].join(""),
946
- schema: paramsSchema,
947
- resolvedType: void 0
948
- };
949
- const typesFileContent = render(types_default, {
950
- params,
951
- paramsSchema: paramsSchema.map((param, index) => {
952
- return {
953
- ...param,
954
- isRequired: param.kind === "required",
955
- isSplat: param.kind === "splat",
956
- refinement: paramsRefinements?.at(index)
957
- };
958
- }),
959
- typeDeclarations,
960
- validationTypes
961
- });
962
- const resolvedTypes = resolveTypes ? literalTypesResolver(typesFileContent, {
963
- stripComments: true,
964
- overrides: { [refineTypeName]: refineTypeName },
965
- withProperties: [params.id, ...validationTypes.flatMap(({ id }) => id)]
966
- }) : void 0;
967
- /**
968
- * Deploy types.ts file; required by core generators (like fetch).
969
- * If types resolved, write resolved types;
970
- * otherwise write original types extracted from API route.
971
- * */
972
- await renderToFile(typesFile, resolvedTypes ? resolved_types_default : typesFileContent, { resolvedTypes });
973
- params.resolvedType = resolvedTypes?.find((e) => e.name === params.id);
974
- cache = {
975
- hash: 0,
976
- referencedFiles: {},
977
- params,
978
- methods,
979
- typeDeclarations,
980
- numericParams,
981
- validationDefinitions: validationDefinitions.map((def) => {
982
- return {
983
- ...def,
984
- ...def.target === "response" ? { variants: def.variants.map((variant) => {
985
- return {
986
- ...variant,
987
- resolvedType: resolvedTypes?.find((e) => e.name === variant.id)
988
- };
989
- }) } : { schema: {
990
- ...def.schema,
991
- resolvedType: resolvedTypes?.find((e) => e.name === def.schema.id)
992
- } }
993
- };
994
- })
995
- };
996
- if (cacheStore) {
997
- const { referencedFiles: _void, ...rest } = cache;
998
- cache = await cacheStore.set({
999
- ...rest,
1000
- referencedFiles
1001
- });
1002
- }
1003
- }
1004
- const validationDefinitions = cache.validationDefinitions.flatMap((def) => {
1005
- let augmentedDef = def;
1006
- if (def.target === "response") augmentedDef = {
1007
- ...def,
1008
- variants: def.variants.flatMap((variant, i) => {
1009
- if (typeof variant.contentType !== "string") return [variant];
1010
- if (variant.contentType.includes("/")) return [variant];
1011
- const contentType = lookup(variant.contentType);
1012
- if (!contentType) {
1013
- console.warn(styleText(["bold", "red"], "✗ Failed resolving Response Content Type"));
1014
- console.warn(` Invalid value provided for mime-types lookup - ${variant.contentType}`);
1015
- console.warn(styleText(["cyan"], ` Response variant #${i} excluded from route schemas`));
1016
- console.warn(` Route: ${name}; Method: ${def.method}`);
1017
- console.warn();
1018
- return [];
1019
- }
1020
- return [{
1021
- ...variant,
1022
- contentType
1023
- }];
1024
- })
1025
- };
1026
- else if (def.contentType && !def.contentType.includes("/")) {
1027
- const contentType = lookup(def.contentType);
1028
- if (!contentType) {
1029
- console.warn(styleText(["bold", "red"], "✗ Failed resolving Response Content Type"));
1030
- console.warn(` Invalid value provided for mime-types lookup - ${def.contentType}`);
1031
- console.warn(` Route: ${name}; Method: ${def.method}`);
1032
- console.warn();
1033
- } else augmentedDef = {
1034
- ...def,
1035
- contentType
1036
- };
1037
- }
1038
- return augmentedDef ? [augmentedDef] : [];
1039
- });
1040
- return {
1041
- kind: "apiRoute",
1042
- entry: {
1043
- id,
1044
- name,
1045
- pathTokens,
1046
- pathPattern,
1047
- honoPattern,
1048
- params: cache.params,
1049
- numericParams: cache.numericParams,
1050
- optionalParams,
1051
- folder,
1052
- file,
1053
- fileFullpath,
1054
- methods: cache.methods,
1055
- typeDeclarations: cache.typeDeclarations,
1056
- validationDefinitions,
1057
- referencedFiles: Object.keys(cache.referencedFiles).map((e) => resolve(sourceFolder.root, e))
1058
- }
1059
- };
1060
- };
1061
- return {
1062
- name,
1063
- handler
1064
- };
1065
- }
1066
- };
1067
- };
1068
- //#endregion
1069
- //#region src/routes/nesting.ts
1070
- var nestedRoutesFactory = (routeEntries) => {
1071
- const entryStack = structuredClone(routeEntries).sort(sortRoutes);
1072
- /**
1073
- * Group entries by name (at the same level, both layout and index share same name).
1074
- *
1075
- * Handle 3 cases:
1076
- * - both index and layout exists
1077
- * - only index exists
1078
- * - only layout exists
1079
- *
1080
- * */
1081
- const transformEntries = (entries, parent) => {
1082
- return [...new Set(entries.map((e) => e.name))].flatMap((name) => {
1083
- const nameEntries = entryStack.flatMap(({ fileFullpath, ...entry }) => {
1084
- return entry.name === name ? [entry] : [];
1085
- });
1086
- const index = nameEntries.find((e) => basename(e.file).startsWith(PAGE_INDEX_BASENAME));
1087
- const layout = nameEntries.find((e) => basename(e.file).startsWith(PAGE_LAYOUT_BASENAME));
1088
- if (index || layout) return [{
1089
- index: index ? {
1090
- ...index,
1091
- pathTokens: index.pathTokens.slice(parent?.pathTokens.length || 0)
1092
- } : void 0,
1093
- layout: layout ? {
1094
- ...layout,
1095
- pathTokens: layout.pathTokens.slice(parent?.pathTokens.length || 0)
1096
- } : void 0,
1097
- parent: parent?.name,
1098
- children: transformEntries(findDescendantEntries(index || layout), index || layout)
1099
- }];
1100
- return [];
1101
- });
1102
- };
1103
- /**
1104
- * Recursively finds direct descendant routes.
1105
- *
1106
- * "Direct" means the next existing route in the path hierarchy,
1107
- * skipping intermediate path segments that don't have index/layout files.
1108
- *
1109
- * Example: blog/post/[slug]/index.tsx is a direct child of blog/index.tsx
1110
- * even though "post" segment exists (it has no index.tsx).
1111
- * */
1112
- const findDescendantEntries = ({ name, pathTokens }) => {
1113
- const potentialChildren = entryStack.filter((entry) => {
1114
- if (entry.pathTokens.length <= pathTokens.length) return false;
1115
- if (!entry.name.startsWith(`${name}/`)) return false;
1116
- return true;
1117
- });
1118
- return potentialChildren.filter((child) => {
1119
- return !potentialChildren.some((intermediate) => {
1120
- if (intermediate === child) return false;
1121
- if (intermediate.pathTokens.length <= pathTokens.length) return false;
1122
- if (intermediate.pathTokens.length >= child.pathTokens.length) return false;
1123
- return child.name.startsWith(`${intermediate.name}/`);
1124
- });
1125
- });
1126
- };
1127
- return transformEntries(entryStack.filter((entry) => {
1128
- return !entryStack.some((potential) => {
1129
- if (potential === entry) return false;
1130
- if (potential.pathTokens.length >= entry.pathTokens.length) return false;
1131
- return entry.name.startsWith(`${potential.name}/`);
1132
- });
1133
- }));
1134
- };
1135
- //#endregion
1136
- //#region src/routes/index.ts
1137
- var routesFactory = async (sourceFolder, cacheFactory) => {
1138
- const { apiRouteResolver, apiUseResolver, pageRouteResolver, pageLayoutResolver } = resolverFactory(sourceFolder, cacheFactory);
1139
- const resolversFactory = (routeFiles) => {
1140
- const resolvers = /* @__PURE__ */ new Map();
1141
- const entries = routeFiles.flatMap((file) => {
1142
- const entry = createRouteEntry(file, sourceFolder);
1143
- return entry ? [entry] : [];
1144
- });
1145
- for (const entry of entries) if (entry.folder === defaults.apiDir) {
1146
- if (isApiRoute(entry.file)) resolvers.set(entry.fileFullpath, apiRouteResolver(entry));
1147
- else if (isApiUse(entry.file)) resolvers.set(entry.fileFullpath, apiUseResolver(entry));
1148
- } else if (entry.folder === defaults.pagesDir) {
1149
- if (isPageRoute(entry.file)) resolvers.set(entry.fileFullpath, pageRouteResolver(entry));
1150
- else if (isPageLayout(entry.file)) resolvers.set(entry.fileFullpath, pageLayoutResolver(entry));
1151
- }
1152
- return resolvers;
1153
- };
1154
- return {
1155
- resolvers: resolversFactory(await scanRoutes(sourceFolder)),
1156
- resolversFactory
1157
- };
1158
- };
1159
- //#endregion
1160
- //#region src/spinner.ts
1161
- var spinnerFactory = (startText) => {
1162
- const spinner = new Spinner().start(startText);
1163
- let _text = startText;
1164
- return {
1165
- text(text) {
1166
- _text = text;
1167
- spinner.text = text;
1168
- },
1169
- append(text) {
1170
- spinner.text = `${_text} › ${text}`;
1171
- },
1172
- succeed(text) {
1173
- if (text) this.append(text);
1174
- else this.text(_text);
1175
- spinner.succeed();
1176
- },
1177
- failed(text) {
1178
- if (text) this.text([_text, text].join("\n"));
1179
- spinner.failed();
1180
- }
1181
- };
1182
- };
1183
- var withSpinner = (text, pipe, spinner) => pipe(spinner || spinnerFactory(text));
1184
- //#endregion
1185
- //#region src/vite.ts
1186
- /**
1187
- * Resolves Kosmo's generated import prefixes to absolute file paths.
1188
- *
1189
- * WHY THIS EXISTS
1190
- * ---------------
1191
- * Every source folder is scaffolded with three tsconfig `paths` prefixes
1192
- * that let generated and user code import across
1193
- * the folder's layout without long relative chains:
1194
- *
1195
- * appPrefix "@" -> the project root (<root>/*)
1196
- * srcPrefix "~" -> the folder's src dir (<root>/src/<name>/*)
1197
- * libPrefix "_" -> the folder's lib dir (<root>/lib/<name>/*)
1198
- *
1199
- * These are the backbone of the generated code: `defineRoute` and friends are
1200
- * emitted with `_/...` imports, pages import layouts and components via `~/...`,
1201
- * and `@/...` reaches shared app-level modules. If a bundler cannot resolve
1202
- * them, nothing the framework generates can be loaded.
1203
- *
1204
- * Historically Vite resolved these through its built-in `resolve.tsconfigPaths: true`,
1205
- * reading the `paths` straight from the generated tsconfig. That option
1206
- * regressed in Vite 8.1.0 (still broken as of 8.1.3): it stops resolving
1207
- * `paths` mappings, especially those defined in an extended / referenced base
1208
- * config - which is exactly Kosmo's structure, where a source folder's
1209
- * tsconfig `extends` `lib/<name>/tsconfig.base.json` and the paths use the
1210
- * TypeScript `${configDir}` variable. The failure surfaces as:
1211
- *
1212
- * [vite] Failed to resolve import "_/pageSamples/welcome.vue" from
1213
- * "src/<name>/pages/index/index.vue". Does the file exist?
1214
- *
1215
- * (Upstream: vitejs/vite #22139, #22047, #22371, #21889, #21856.)
1216
- *
1217
- * Rather than pin Vite to 8.0.x indefinitely, or depend on the general-purpose
1218
- * `vite-tsconfig-paths` plugin, this internal plugin resolves ONLY
1219
- * known prefixes against dirs derived from the source folder. That makes it:
1220
- *
1221
- * - Correct on 8.1.x, where native `tsconfigPaths` is broken.
1222
- * - Faster: no tsconfig discovery, no `extends` chain walking, no glob
1223
- * matching - just a prefix check and a handful of `stat` probes,
1224
- * cached by Vite per specifier.
1225
- * - Non-blocking: probes via async `fs/promises` `stat`, so `resolveId` never
1226
- * stalls the event loop.
1227
- * - `.vue` / `.mdx`-aware: `resolveId` sees every specifier regardless of the
1228
- * importer's type, so imports from non-JS files resolve without the
1229
- * `loose` / `allowJs` escape hatches `vite-tsconfig-paths` needs.
1230
- *
1231
- * A project with custom `paths` beyond these three prefixes should install
1232
- * `vite-tsconfig-paths`; this plugin is internal and intentionally narrow.
1233
- *
1234
- * The prefix -> dir bases come from `pathResolver`, the same source of truth the
1235
- * tsconfig generator uses, so alias resolution here can never drift from the
1236
- * paths that were written into the generated tsconfig.
1237
- * */
1238
- var tsconfigPaths = (sourceFolder) => {
1239
- /**
1240
- * Candidate extensions for an extensionless specifier, in resolution priority order.
1241
- * Mirrors the renderable file types the generators emit;
1242
- * a new page type (e.g. `.svelte`) must be added here or its aliased imports won't resolve.
1243
- * */
1244
- const EXTENSIONS = [
1245
- ".ts",
1246
- ".tsx",
1247
- ".js",
1248
- ".jsx",
1249
- ".mjs",
1250
- ".vue",
1251
- ".svelte",
1252
- ".md",
1253
- ".mdx",
1254
- ".json"
1255
- ];
1256
- const { createPath } = pathResolver(sourceFolder);
1257
- const table = [
1258
- [`${defaults.srcPrefix}/`, createPath.src()],
1259
- [`${defaults.libPrefix}/`, createPath.lib()],
1260
- [`${defaults.appPrefix}/`, sourceFolder.root]
1261
- ];
1262
- const resolveWithin = async (baseDir, rest) => {
1263
- const target = join(baseDir, rest);
1264
- const { ext } = parse(rest);
1265
- if (EXTENSIONS.includes(ext)) {
1266
- for (const candidate of [target, `${target}/index${ext}`]) if (await isFile(candidate)) return candidate;
1267
- return target;
1268
- }
1269
- for (const e of EXTENSIONS) for (const candidate of [`${target}${e}`, `${target}/index${e}`]) if (await isFile(candidate)) return candidate;
1270
- return target;
1271
- };
1272
- return {
1273
- name: "kosmo:tsconfigPaths",
1274
- enforce: "pre",
1275
- async resolveId(source) {
1276
- if (isAbsolute(source) || source.startsWith(".")) return;
1277
- for (const [prefix, baseDir] of table) if (source.startsWith(prefix)) return resolveWithin(baseDir, source.replace(prefix, ""));
1278
- }
1279
- };
1280
- };
1281
- var nodePrefix = () => {
1282
- return {
1283
- name: "kosmojs:node-prefix",
1284
- enforce: "pre",
1285
- resolveId(source) {
1286
- return builtinModules.includes(source) ? {
1287
- id: `node:${source}`,
1288
- external: true
1289
- } : void 0;
1290
- }
1291
- };
1292
- };
1293
- var vitePlugins = {
1294
- tsconfigPaths,
1295
- nodePrefix
1296
- };
1297
- var isFile = async (path) => {
1298
- return stat(path).then((e) => e.isFile()).catch(() => false);
1
+ import{builtinModules as e}from"node:module";import{styleText as t}from"node:util";import n from"crc/crc32";import r from"tfusion";import{ModuleResolutionKind as i,Project as a,SyntaxKind as o}from"ts-morph";import{RequestValidationTargets as s,defaults as c}from"@kosmojs/core";import{HTTPMethods as l}from"@kosmojs/core/api";import{mergeConfig as u}from"vite";import{access as d,constants as f,mkdir as p,readFile as m,stat as h,writeFile as g}from"node:fs/promises";import{basename as _,dirname as v,isAbsolute as y,join as b,parse as x,resolve as S}from"node:path";import C from"handlebars";import w from"picomatch";import{glob as T}from"tinyglobby";import{compile as E,parse as D}from"path-to-regexp";import{lookup as O}from"mrmime";import{Spinner as k}from"@topcli/spinner";var A=(...e)=>[{configFile:!1,define:{KOSMO_PRODUCTION_BUILD:`false`,KOSMO_SERVERSIDE_FETCH:`false`}},...e].reduce((e,t)=>u(e||{},t||{}),{}),j=e=>[[/(?<!\\)`/g,"\\`"],[/(?<!\\)\$\{/g,"\\${"]].reduce((e,[t,n])=>e.replace(t,n),e),M=e=>{let t=(...t)=>e.root?S(e.root,b(...t)):b(...t),n={src(t,{origin:n}){return n===`src`?b(c.srcPrefix,...t):b(c.appPrefix,c.srcDir,e.name,...t)},api(e,t){return this.src([c.apiDir,...e],t)},entry(e,t){return this.src([c.entryDir,...e],t)},pages(e,t){return this.src([c.pagesDir,...e],t)},lib(t,{origin:n}){return n===`src`?b(c.libPrefix,...t):b(c.appPrefix,c.libDir,e.name,...t)},libCore(e,t){return this.lib([`core`,...e],t)},libApi(e,t){return this.lib([c.apiDir,...e],t)},libEntry(e,t){return this.lib([c.entryDir,...e],t)}};return{createPath:{src(...n){return t(c.srcDir,e.name,...n)},api(...e){return this.src(c.apiDir,...e)},pages(...e){return this.src(c.pagesDir,...e)},entry(...e){return this.src(c.entryDir,...e)},lib(...n){return t(c.libDir,e.name,...n)},libCore(...e){return this.lib(`core`,...e)},libApi(...e){return this.lib(c.apiDir,...e)},libEntry(...e){return this.lib(c.entryDir,...e)},libPages(...e){return this.lib(c.pagesDir,...e)},distDir(...n){return t(e.distDir,e.name,...n)}},createImport:n,createImportHelpers(e){if(![`src`,`lib`].includes(e?.origin))throw Error(`createImportHelpers: required exactly one argument of shape { origin: "src|lib" }`);return{createImport(t,...r){return n[t](r.slice(0,-1),e)}}}}},N=async e=>{try{return await d(e,f.F_OK),!0}catch{return!1}},P=(e,t,n)=>{let{noEscape:r=!0,renderer:i=C}={...n};return i.compile(e,{noEscape:r})(t)},F=async(e,t,r,i)=>{let a=P(t,r,i);if(await N(e)){let{overwrite:t=!0}={...i};if(t===!1)return;let r=await m(e,`utf8`);if(typeof t==`function`&&!t(r)||n(a)===n(r))return}await p(v(e),{recursive:!0}),await g(e,a,`utf8`)},ee=e=>{let t=t=>{let n=C.create();return n.registerPartial({...e?.partials,...t?.partials}),n.registerHelper({...e?.helpers,...t?.helpers}),n};return{render(n,r,i){return P(n,r,{...e,...i,renderer:t(i)})},async renderToFile(n,r,i,a){return F(e?.outdir?b(e.outdir,n):n,r,i,{...e,...a,renderer:t(a)})}}},I=`{{#each resolvedTypes}}
2
+ export type {{name}} = {{text}};
3
+ {{/each}}
4
+ `,te=`{{#each typeDeclarations}}{{text}}
5
+ {{/each}}
6
+
7
+ export type {{params.id}} = {
8
+ {{#each paramsSchema}}
9
+ "{{name}}"{{#unless isRequired}}?{{/unless}}: {{#if refinement}}
10
+ {{refinement.text}},
11
+ {{else}}
12
+ {{#if isSplat}}Array<string>{{else}}string{{/if}},
13
+ {{/if}}
14
+ {{/each}}
1299
15
  };
1300
- //#endregion
1301
- export { API_INDEX_BASENAME, API_INDEX_PATTERN, API_USE_BASENAME, API_USE_PATTERN, PAGE_INDEX_BASENAME, PAGE_INDEX_PATTERN, PAGE_LAYOUT_BASENAME, PAGE_LAYOUT_PATTERN, astFactory, createHonoPattern, createPathPattern, createRouteEntry, defineGenerator, defineGeneratorFactory, escapeTemplateLiterals, isApiRoute, isApiUse, isPageLayout, isPageRoute, isRouteFile, mergeConfigs, nestedRoutesFactory, pathExists, pathResolver, pathTokensFactory, render, renderFactory, renderToFile, routesFactory, scanRoutes, sortRoutes, spinnerFactory, tsconfigPaths, vitePlugins, withSpinner };
1302
16
 
17
+ {{#each validationTypes}}export type {{id}} = {{text}};
18
+ {{/each}}
19
+ `,L=()=>{let e=e=>new a(e),u=async(t,n)=>{let{sourceFile:r=e().addSourceFileAtPath(t.fileFullpath)}={...n},[i,a]=y(r,n),o=d(r),s=o?f(o):void 0,c=o?p(t,o):[];return{typeDeclarations:i,paramsRefinements:s,methods:c.map(e=>e.method),validationDefinitions:c.flatMap(e=>e.validationDefinitions),referencedFiles:a}},d=e=>{let[t]=e.getExportAssignments().flatMap(e=>{if(e.isExportEquals())return[];let t=e.getExpression();return t.isKind(o.CallExpression)?[t]:[]});return t},f=e=>{let[t,n]=x(e);if(n?.isKind(o.TupleType))return n.getElements().map((e,t)=>({index:t,text:e.getText()}))},p=(e,t)=>{let n=t.getFirstChildByKind(o.ArrowFunction)||t.getFirstChildByKind(o.FunctionExpression);if(!n)return[];let r=n.getFirstChildByKind(o.ArrayLiteralExpression);if(!r)return[];let i=[];for(let e of r.getChildrenOfKind(o.CallExpression)){let t=e.getExpression().getText();l[t]&&i.push([e,t])}let a=[];for(let[t,n]of i){let[r,i]=x(t);a.push({method:n,validationDefinitions:v(e,n,r,i)})}return a},m=e=>{if(e.isKind(o.LiteralType)){let t=e.getFirstChild();if(t?.isKind(o.TrueKeyword))return!0;if(t?.isKind(o.FalseKeyword))return!1}},h=e=>{if(!e.isKind(o.TupleType))return;let t=200,n,r,[i,a,s]=e.getElements();if(i?.isKind(o.LiteralType)){let e=i.getFirstChildByKind(o.NumericLiteral);e&&(t=Number(e.getText()))}return a&&(n=_(a)),s&&(r=s.getText(),[`object`].includes(r)&&(r=`{}`)),{status:t,contentType:n,body:r}},g=e=>{let t={};if(!e?.isKind(o.TypeLiteral))return t;for(let n of e.getMembers()){if(!n.isKind(o.PropertySignature))continue;let e=n.getName(),r=n.getTypeNodeOrThrow();if(!r.isKind(o.TypeLiteral))continue;let i,a,s={};for(let e of r.getMembers()){if(!e.isKind(o.PropertySignature))continue;let t=e.getNameNode(),n=e.getTypeNodeOrThrow(),r=t.isKind(o.StringLiteral)?t.getLiteralText():t.getText();if(r===`contentType`)i=_(n);else if(r===`runtimeValidation`)a=m(n);else if(r.startsWith(`error`)){let e=_(n);e&&(s[r]=e)}}t[e]={contentType:i,runtimeValidation:a,customErrors:s}}return t},_=e=>{let t=e.isKind(o.LiteralType)?e.getFirstChildByKind(o.StringLiteral):void 0;return t?t.getLiteralText():void 0},v=(e,r,i,a)=>{let c=[];if(!i?.isKind(o.TypeLiteral))return c;let l=g(a),u=(t,i)=>[t.replace(/^./,e=>e.toUpperCase()),`T`,r,n(e.id+i)].join(``);for(let n of i.getMembers()){if(!n.isKind(o.PropertySignature))continue;let i=n.getName(),a=n.getTypeNodeOrThrow();if(i===`response`){let n=a.isKind(o.UnionType)?a.getChildrenOfKind(o.TupleType):[a];c.push({...l[i],method:r,target:i,variants:n.flatMap((n,a)=>{let{status:o,contentType:s,body:c}={...h(n)};return o?(s&&typeof s!=`string`&&(console.warn(t([`bold`,`red`],`✗ The second element of a response variant should specify the Response Content Type`)),console.warn(t([`blue`],` Example: [200, "json", Schema]`)),console.warn(` Route: ${e.name}; Method: ${r}; Response Variant: #${a}`),console.warn()),[{id:u(i,JSON.stringify([o,s,c])),status:o,contentType:s,body:c}]):[]})})}else Object.keys(s).includes(i)&&c.push({...l[i],method:r,target:i,schema:{id:u(i),text:a.getText()}})}return c},y=(e,t)=>{let n=[],r=t?.withReferencedFiles?[]:void 0;for(let i of e.getImportDeclarations()){let e=i.getModuleSpecifierValue(),a=/^\.\.?\/?/.test(e)&&t?.relpathResolver?t.relpathResolver(e):e,s=i.isTypeOnly(),c=s?i.getDefaultImport():void 0;if(c){let e=c.getText(),t=`import type ${e} from "${a}";`;n.push({importDeclaration:{name:e,path:a},text:t}),r&&r.push(...b(c))}let l=s?i.getNamespaceImport():void 0;if(l){let e=l.getText(),t=`import type * as ${e} from "${a}";`;n.push({importDeclaration:{name:e,path:a},text:t}),r&&r.push(...b(l))}for(let e of i.getNamedImports())if(e.isTypeOnly()||s){let t=e.getNameNode(),i=t.getText(),s=e.getAliasNode()?.getText(),c=s?`${i} as ${s}`:i;n.push({importDeclaration:{name:i,alias:s,path:a},text:`import type { ${c} } from "${a}";`}),r&&t.isKind(o.Identifier)&&r.push(...b(t))}}for(let t of e.getTypeAliases()){let e=t.getName(),r=t.getFullText().trim();n.push({typeAliasDeclaration:{name:e},text:r})}for(let t of e.getInterfaces()){let e=t.getName(),r=t.getFullText().trim();n.push({interfaceDeclaration:{name:e},text:r})}for(let t of e.getEnums()){let e=t.getName(),r=t.getFullText().trim();n.push({enumDeclaration:{name:e},text:r})}for(let i of e.getExportDeclarations()){let e=i.isTypeOnly(),a=i.getModuleSpecifierValue(),s=a?/^\.\.?\/?/.test(a)&&t?.relpathResolver?t.relpathResolver(a):a:void 0;for(let t of i.getNamedExports())if(t.isTypeOnly()||e){let e=t.getNameNode(),i=e.getText(),a=t.getAliasNode()?.getText(),c=a?`${i} as ${a}`:i;n.push({exportDeclaration:{name:i,alias:a??i,path:s},text:s?`export type { ${c} } from "${s}";`:`export type { ${c} };`}),r&&e.isKind(o.Identifier)&&r.push(...b(e))}}return r?[n,[...new Set(r)]]:[n]},b=e=>(e?.getSymbol()?.getAliasedSymbol()?.getDeclarations()||[]).flatMap(e=>{let t=e.getSourceFile();return t?[t.getFilePath()]:[]}),x=e=>e.getTypeArguments();return{createProject:e,extractDefaultExport:d,extractParamsRefinements:f,extractRouteMethods:p,extractTypeDeclarations:y,resolveRouteSignature:u,typeResolverFactory:t=>{let{createPath:a}=M(t),s=e({compilerOptions:{moduleResolution:i.Bundler,types:[],noLib:!0,skipLibCheck:!0,paths:{[`${c.appPrefix}/*`]:[`${t.root}/*`],[`${c.srcPrefix}/*`]:[a.src(`*`)],[`${c.libPrefix}/*`]:[a.lib(`*`)]}}}),l=e=>{let t=P(I,{resolvedTypes:e}),r=s.createSourceFile(`${n(t)}-${Date.now()}.ts`,t,{overwrite:!0}),i=e.map(e=>{let t=r.getTypeAlias(e.name)?.getTypeNode();if(!t)return e;let n=e.properties?e.properties.map(e=>{let n=t.isKind(o.TypeLiteral)?t.getProperty(e.name)?.getTypeNode():void 0;return n?{...e,typeboxSchema:ne(n)}:e}):void 0;return{...e,...n?{properties:n}:{},typeboxSchema:ne(t)}});return s.removeSourceFile(r),i};return{getSourceFile:e=>s.getSourceFile(e)||s.addSourceFileAtPath(e),refreshSourceFile:async e=>{let t=s.getSourceFile(e);t&&await t.refreshFromFileSystem()},literalTypesResolver:(e,t)=>{let i=s.createSourceFile(`${n(e)}-${Date.now()}.ts`,e,{overwrite:!0}),a=r(s,i,{...t,stripComments:!0});return s.removeSourceFile(i),l(a)}}}}},ne=(e,t=c.refineTypeName)=>{let n=e=>{if(e.isKind(o.TypeReference)&&e.getTypeName().getText()===t){let[t,r]=e.getTypeArguments();return!t||!r?e.getText():`(${n(t)} with ${r.getText()})`}if(e.isKind(o.ArrayType))return`${n(e.getElementTypeNode())}[]`;if(e.isKind(o.TypeLiteral)){let t=[];for(let r of e.getMembers())if(r.isKind(o.PropertySignature)){let e=r.getName(),i=r.hasQuestionToken()?`?`:``,a=r.getTypeNode(),o=a?n(a):`unknown`;t.push(`${e}${i}: ${o}`)}else t.push(r.getText());return`{ ${t.join(`, `)} }`}if(e.isKind(o.TupleType))return`[${e.getElements().map(e=>n(e)).join(`, `)}]`;if(e.isKind(o.ParenthesizedType))return`(${n(e.getTypeNode())})`;if(e.isKind(o.UnionType))return e.getTypeNodes().map(e=>n(e)).join(` | `);if(e.isKind(o.IntersectionType))return e.getTypeNodes().map(e=>n(e)).join(` & `);if(e.isKind(o.TypeReference)){let t=e.getTypeArguments();return t.length===0?e.getText():`${e.getTypeName().getText()}<${t.map(e=>n(e)).join(`, `)}>`}return e.getText()};return j(n(e))},re=e=>e,ie=e=>e,R=e=>{let t=(e,n,r=!1)=>{let i=[];for(let a of e)switch(a.type){case`text`:a.value!==`/`&&i.push({type:`static`,value:a.value});break;case`param`:i.push({type:`param`,kind:r?`optional`:`required`,name:a.name,const:n(a.name)});break;case`wildcard`:i.push({type:`param`,kind:`splat`,name:a.name,const:n(a.name)});break;case`group`:i.push(...t(a.tokens,n,!0))}return i},r=[e=>e.replace(/\[(\w+)\]/g,`:$1`),e=>e.replace(/\{(\w+)\}/g,`{:$1}`),e=>e.replace(/\{\.\.\./g,`{*`),e=>e.startsWith(`{`)?e.replace(/^\{/,`{/`):e],i=e=>{let t=0;for(let[n,r]of[...e].entries())if(r===`{`)t+=1;else if(r===`}`)--t;else if(r===`:`&&t===0)return e.slice(n+1).match(/^\w+/)?.[0]||`:`},a=e.replace(/^index\/?/,``).split(`/`).flatMap(a=>{if(!a.length)return[];let o=i(a);if(o===`:`)throw Error(`${e} contains colons outside braces, use : only within {}`);if(o)throw Error(`${e} contains bare params, use [${o}] instead of :${o}`);let s=r.reduce((e,t)=>t(e),a),{tokens:c}=D(s.replace(/\{[^}]*\}|(\+)/g,(e,t)=>t?`\\+`:e)),l=t(c,e=>/\W/.test(e)||/^\d/.test(e)?[e.replace(/^\d+|\W/g,`_`),n(a)].join(`_`):e),u=l.length===1&&l[0].type===`static`,d=l.length===1&&l[0].type===`param`;return[{kind:u?`static`:d?`param`:`mixed`,orig:a,pattern:s,parts:l}]});return E(a.map(e=>e.pattern).join(`/`)),a},z=e=>e.map(({pattern:t},n)=>{let r=e[n+1];return!r||r.pattern.includes(`/`)?t:e.slice(n+1).some(e=>e.parts.some(e=>e.type===`static`||e.kind===`required`))?`${t}/`:t}).join(``),B=e=>{let t=e=>e.kind===`splat`?`*`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`,n=e=>e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`),r=e=>e.flatMap(e=>e.type===`text`?e.value===`/`?[]:[n(e.value)]:e.type===`wildcard`?[`.+`]:e.type===`param`?[`[^/]+`]:e.type===`group`?[`(?:${r(e.tokens)})?`]:[]).join(``);return e.flatMap((e,n)=>{if(e.kind===`static`)return[e.parts[0].value];if(e.kind===`param`)return[t(e.parts[0])];let{tokens:i}=D(e.pattern.replace(/\//g,``));return[`:_${n}{${r(i)}}`]}).join(`/`)},V=`index`,H=`${V}.ts`,ae=`use`,U=`use.ts`,W=`index`,G=`${W}.{tsx,vue,svelte,mdx,md}`,K=`layout`,q=`${K}.{tsx,vue,svelte,mdx}`,J=[`${c.apiDir}/**/${H}`,`${c.apiDir}/**/${U}`,`${c.pagesDir}/**/${G}`,`${c.pagesDir}/**/${q}`],Y=async e=>{let{createPath:t}=M(e);return T(J,{cwd:t.src(),absolute:!0,onlyFiles:!0,followSymbolicLinks:!1,ignore:[`${c.apiDir}/${H}`,`${c.apiDir}/${U}`,`${c.pagesDir}/${G}`,`${c.pagesDir}/${q}`]})},X=(e,t)=>{let[n,r,...i]=S(t.root,e).replace(`${t.root}/${c.srcDir}/`,``).split(`/`);return!r||n!==t.name||i.length<2?!1:w.isMatch(b(r,...i),J)?[r,i.join(`/`)]:!1},Z=e=>w.matchBase(e,`**/${H}`),Q=e=>w.matchBase(e,`**/${U}`),oe=e=>w.matchBase(e,`**/${G}`),se=e=>w.matchBase(e,`**/${q}`),ce=(e,r)=>{let i=X(e,r);if(!i)return;let[a,o]=i,s=`${o.replace(/\W+/g,`_`)}_${n(o)}`,c=v(o);try{let t=R(v(o));return{id:s,name:c,folder:a,file:o,fileFullpath:e,pathTokens:t,pathPattern:z(t),honoPattern:B(t)}}catch(e){console.error(`❗${t(`red`,`ERROR`)}: Failed parsing path for "${t(`cyan`,o)}"`),console.error(e.message);return}},le=e=>{if(e.kind===`static`)return 4;if(e.kind===`mixed`){let t=0,n=0;for(let r of e.parts)r.type===`static`?t+=1:(r.kind===`optional`||r.kind===`splat`)&&(n+=1);return 3+t*.01-n*.005}switch(e.parts[0].kind){case`required`:return 2;case`optional`:return 1;case`splat`:return 0}},$=(e,t)=>{let n=Array.from({length:Math.max(e.pathTokens.length,t.pathTokens.length)},(n,r)=>[e.pathTokens[r],t.pathTokens[r]]);for(let[e,t]of n){if(!e||!t){let n=e??t;return n?.kind===`param`&&n.parts[0].kind===`splat`?e?1:-1:e?-1:1}let n=le(e),r=le(t);if(n!==r)return r-n}return e.pathPattern.localeCompare(t.pathPattern)},ue=(e,r)=>{let{generators:i=[],refineTypeName:a=c.refineTypeName}=e.config,{typeResolverFactory:o,resolveRouteSignature:s}=L(),l=i.some(({meta:e})=>e.resolveTypes),{literalTypesResolver:u,getSourceFile:d,refreshSourceFile:f}=o(e);return{pageLayoutResolver(e){let{name:t}=e;return{name:t,handler:async()=>({kind:`pageLayout`,entry:e})}},pageRouteResolver(e){let{id:t,name:n,folder:r,file:i,fileFullpath:a,pathTokens:o,pathPattern:s,honoPattern:c}=e;return{name:n,handler:async()=>({kind:`pageRoute`,entry:{id:t,name:n,pathTokens:o,pathPattern:s,honoPattern:c,params:{schema:o.flatMap(e=>e.parts.filter(e=>e.type===`param`))},folder:r,file:i,fileFullpath:a}})}},apiUseResolver(e){let{name:t}=e;return{name:t,handler:async()=>({kind:`apiUse`,entry:e})}},apiRouteResolver(i){let{id:o,name:p,file:m,folder:h,fileFullpath:g,pathTokens:_,pathPattern:y,honoPattern:x}=i;return{name:p,handler:async i=>{let C=_.flatMap(e=>e.parts.flatMap(e=>e.type===`param`?[e]:[])),w=!C.length||C.filter(e=>e.kind===`required`).length===0,T=r?r({id:o,file:m,fileFullpath:g},e,{resolveTypes:l}):void 0,E=T?await T.get({validate:!0}):void 0;if(!E){i===g&&await f(g);let{typeDeclarations:t,paramsRefinements:r,methods:h,validationDefinitions:_,referencedFiles:y=[]}=await s({id:o,name:p,fileFullpath:g,optionalParams:w},{withReferencedFiles:!0,sourceFile:d(g),relpathResolver(e){return b(c.srcPrefix,c.apiDir,v(m),e)}}),x=_.flatMap(e=>e.target===`response`?e.variants.flatMap(({id:e,body:t})=>t?[{id:e,text:t}]:[]):[e.schema]),S=r?r.flatMap(({text:e,index:t})=>{if(e===`number`){let e=C.at(t);return e?[e.name]:[]}return[]}):[],D=M(e).createPath.libApi(v(m),`types.ts`),O={id:[`ParamsT`,n(p)].join(``),schema:C,resolvedType:void 0},k=P(te,{params:O,paramsSchema:C.map((e,t)=>({...e,isRequired:e.kind===`required`,isSplat:e.kind===`splat`,refinement:r?.at(t)})),typeDeclarations:t,validationTypes:x}),A=l?u(k,{stripComments:!0,overrides:{[a]:a},withProperties:[O.id,...x.flatMap(({id:e})=>e)]}):void 0;if(await F(D,A?I:k,{resolvedTypes:A}),O.resolvedType=A?.find(e=>e.name===O.id),E={hash:0,referencedFiles:{},params:O,methods:h,typeDeclarations:t,numericParams:S,validationDefinitions:_.map(e=>({...e,...e.target===`response`?{variants:e.variants.map(e=>({...e,resolvedType:A?.find(t=>t.name===e.id)}))}:{schema:{...e.schema,resolvedType:A?.find(t=>t.name===e.schema.id)}}}))},T){let{referencedFiles:e,...t}=E;E=await T.set({...t,referencedFiles:y})}}let D=E.validationDefinitions.flatMap(e=>{let n=e;if(e.target===`response`)n={...e,variants:e.variants.flatMap((n,r)=>{if(typeof n.contentType!=`string`||n.contentType.includes(`/`))return[n];let i=O(n.contentType);return i?[{...n,contentType:i}]:(console.warn(t([`bold`,`red`],`✗ Failed resolving Response Content Type`)),console.warn(` Invalid value provided for mime-types lookup - ${n.contentType}`),console.warn(t([`cyan`],` Response variant #${r} excluded from route schemas`)),console.warn(` Route: ${p}; Method: ${e.method}`),console.warn(),[])})};else if(e.contentType&&!e.contentType.includes(`/`)){let r=O(e.contentType);r?n={...e,contentType:r}:(console.warn(t([`bold`,`red`],`✗ Failed resolving Response Content Type`)),console.warn(` Invalid value provided for mime-types lookup - ${e.contentType}`),console.warn(` Route: ${p}; Method: ${e.method}`),console.warn())}return n?[n]:[]});return{kind:`apiRoute`,entry:{id:o,name:p,pathTokens:_,pathPattern:y,honoPattern:x,params:E.params,numericParams:E.numericParams,optionalParams:w,folder:h,file:m,fileFullpath:g,methods:E.methods,typeDeclarations:E.typeDeclarations,validationDefinitions:D,referencedFiles:Object.keys(E.referencedFiles).map(t=>S(e.root,t))}}}}}}},de=e=>{let t=structuredClone(e).sort($),n=(e,i)=>[...new Set(e.map(e=>e.name))].flatMap(e=>{let a=t.flatMap(({fileFullpath:t,...n})=>n.name===e?[n]:[]),o=a.find(e=>_(e.file).startsWith(W)),s=a.find(e=>_(e.file).startsWith(K));return o||s?[{index:o?{...o,pathTokens:o.pathTokens.slice(i?.pathTokens.length||0)}:void 0,layout:s?{...s,pathTokens:s.pathTokens.slice(i?.pathTokens.length||0)}:void 0,parent:i?.name,children:n(r(o||s),o||s)}]:[]}),r=({name:e,pathTokens:n})=>{let r=t.filter(t=>!(t.pathTokens.length<=n.length||!t.name.startsWith(`${e}/`)));return r.filter(e=>!r.some(t=>t===e||t.pathTokens.length<=n.length||t.pathTokens.length>=e.pathTokens.length?!1:e.name.startsWith(`${t.name}/`)))};return n(t.filter(e=>!t.some(t=>t===e||t.pathTokens.length>=e.pathTokens.length?!1:e.name.startsWith(`${t.name}/`))))},fe=async(e,t)=>{let{apiRouteResolver:n,apiUseResolver:r,pageRouteResolver:i,pageLayoutResolver:a}=ue(e,t),o=t=>{let o=new Map,s=t.flatMap(t=>{let n=ce(t,e);return n?[n]:[]});for(let e of s)e.folder===c.apiDir?Z(e.file)?o.set(e.fileFullpath,n(e)):Q(e.file)&&o.set(e.fileFullpath,r(e)):e.folder===c.pagesDir&&(oe(e.file)?o.set(e.fileFullpath,i(e)):se(e.file)&&o.set(e.fileFullpath,a(e)));return o};return{resolvers:o(await Y(e)),resolversFactory:o}},pe=e=>{let t=new k().start(e),n=e;return{text(e){n=e,t.text=e},append(e){t.text=`${n} › ${e}`},succeed(e){e?this.append(e):this.text(n),t.succeed()},failed(e){e&&this.text([n,e].join(`
20
+ `)),t.failed()}}},me=(e,t,n)=>t(n||pe(e)),he=e=>{let t=[`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.vue`,`.svelte`,`.md`,`.mdx`,`.json`],{createPath:n}=M(e),r=[[`${c.srcPrefix}/`,n.src()],[`${c.libPrefix}/`,n.lib()],[`${c.appPrefix}/`,e.root]],i=async(e,n)=>{let r=b(e,n),{ext:i}=x(n);if(t.includes(i)){for(let e of[r,`${r}/index${i}`])if(await _e(e))return e;return r}for(let e of t)for(let t of[`${r}${e}`,`${r}/index${e}`])if(await _e(t))return t;return r};return{name:`kosmo:tsconfigPaths`,enforce:`pre`,async resolveId(e){if(!(y(e)||e.startsWith(`.`))){for(let[t,n]of r)if(e.startsWith(t))return i(n,e.replace(t,``))}}}},ge={tsconfigPaths:he,nodePrefix:()=>({name:`kosmojs:node-prefix`,enforce:`pre`,resolveId(t){return e.includes(t)?{id:`node:${t}`,external:!0}:void 0}})},_e=async e=>h(e).then(e=>e.isFile()).catch(()=>!1);export{V as API_INDEX_BASENAME,H as API_INDEX_PATTERN,ae as API_USE_BASENAME,U as API_USE_PATTERN,W as PAGE_INDEX_BASENAME,G as PAGE_INDEX_PATTERN,K as PAGE_LAYOUT_BASENAME,q as PAGE_LAYOUT_PATTERN,L as astFactory,B as createHonoPattern,z as createPathPattern,ce as createRouteEntry,re as defineGenerator,ie as defineGeneratorFactory,j as escapeTemplateLiterals,Z as isApiRoute,Q as isApiUse,se as isPageLayout,oe as isPageRoute,X as isRouteFile,A as mergeConfigs,de as nestedRoutesFactory,N as pathExists,M as pathResolver,R as pathTokensFactory,P as render,ee as renderFactory,F as renderToFile,fe as routesFactory,Y as scanRoutes,$ as sortRoutes,pe as spinnerFactory,he as tsconfigPaths,ge as vitePlugins,me as withSpinner};
1303
21
  //# sourceMappingURL=index.js.map