Open History to see the last commit
1import type { PackageManager } from './package-manager.js'
2import type { AddOn, Integration, Options } from './types.js'
3
4type TemplateRoute = NonNullable<AddOn['routes']>[number]
5
6export type TemplateRenderContext = {
7 [key: string]: unknown
8 packageManager: PackageManager | undefined
9 projectName: string | undefined
10 bundler: string
11 typescript: boolean | undefined
12 tailwind: boolean | undefined
13 blank: boolean | undefined
14 js: string | undefined
15 jsx: string | undefined
16 fileRouter: boolean | undefined
17 codeRouter: boolean | undefined
18 routerOnly: boolean | undefined
19 includeExamples: boolean | undefined
20 addOnEnabled: Record<string, boolean>
21 addOnOption: Record<string, Record<string, unknown>>
22 addOns: Array<AddOn>
23 integrations: Array<Integration>
24 routes: Array<TemplateRoute>
25 getPackageManagerAddScript: (packageName: string, isDev?: boolean) => string
26 getPackageManagerRunScript: (script: string) => string
27 getPackageManagerExecuteScript: (pkg: string, args?: Array<string>) => string
28 relativePath: (path: string, stripExtension?: boolean) => string
29 integrationImportContent: (integration: Integration) => string
30 integrationImportCode: (integration: Integration) => string | undefined
31 renderTemplate: (content: string) => string
32 ignoreFile: () => never
33}
34
35export type TemplateRenderer = (
36 template: string,
37 context: TemplateRenderContext,
38) => string | undefined
39
40const templateRenderers = new WeakMap<object, TemplateRenderer>()
41let defaultTemplateRenderer: TemplateRenderer | undefined
42
43export function setDefaultTemplateRenderer(renderer: TemplateRenderer) {
44 defaultTemplateRenderer = renderer
45}
46
47export function registerTemplateRenderer(
48 owner: object,
49 renderer: TemplateRenderer,
50) {
51 templateRenderers.set(owner, renderer)
52}
53
54function getTemplateRenderer(owner?: object): TemplateRenderer {
55 const renderer =
56 (owner ? templateRenderers.get(owner) : undefined) ??
57 defaultTemplateRenderer
58
59 if (!renderer) {
60 throw new Error(
61 'No template renderer has been registered for this manifest. Use @tanstack/create/worker with a manifest loader, or @tanstack/create/edge for the bundled manifest.',
62 )
63 }
64
65 return renderer
66}
67
68export function render(
69 template: string,
70 data?: Partial<TemplateRenderContext>,
71) {
72 return renderWithRenderer(getTemplateRenderer(), template, data)
73}
74
75export function renderForOptions(
76 options: Options,
77 template: string,
78 data?: Partial<TemplateRenderContext>,
79) {
80 return renderWithRenderer(
81 getTemplateRenderer(options.framework),
82 template,
83 data,
84 )
85}
86
87function renderWithRenderer(
88 renderer: TemplateRenderer,
89 template: string,
90 data?: Partial<TemplateRenderContext>,
91) {
92 return renderer(template, {
93 packageManager: undefined,
94 projectName: undefined,
95 bundler: 'vite',
96 typescript: undefined,
97 tailwind: undefined,
98 blank: undefined,
99 js: undefined,
100 jsx: undefined,
101 fileRouter: undefined,
102 codeRouter: undefined,
103 routerOnly: undefined,
104 includeExamples: undefined,
105 addOnEnabled: {},
106 addOnOption: {},
107 addOns: [],
108 integrations: [],
109 routes: [],
110 getPackageManagerAddScript: () => '',
111 getPackageManagerRunScript: () => '',
112 getPackageManagerExecuteScript: () => '',
113 relativePath: () => '',
114 integrationImportContent: () => '',
115 integrationImportCode: () => '',
116 renderTemplate: () => '',
117 ignoreFile: () => {
118 throw new Error('ignoreFile')
119 },
120 ...(data ?? {}),
121 }) ?? ''
122}