Open History to see the last commit
1import { cloneGeneratedNode } from '@tanstack/router-utils'
2import type {
3 StartCompilerImportTransform,
4 StartCompilerTransformContext,
5} from '@tanstack/start-plugin-core'
6β
7const TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split'
8const RSC_CSS_OPTIONS_KEY = '__tanstackStartRscCss'
9β
10type NativeExpression = ReturnType<
11 StartCompilerTransformContext['parseExpression']
12>
13β
14type RscCssTransformKind =
15 | 'renderServerComponent'
16 | 'createCompositeComponent'
17 | 'renderToReadableStream'
18β
19export function createRscCssCompilerTransforms(opts: {
20 loadCssExpression: string
21 serverFnProviderOnly?: boolean | undefined
22}): Array<StartCompilerImportTransform> {
23 let loadCssExpression: NativeExpression | undefined
24β
25 const getLoadCssExpression = (context: StartCompilerTransformContext) => {
26 loadCssExpression ??= context.parseExpression(opts.loadCssExpression)
27 return loadCssExpression
28 }
29β
30 return [
31 createRscCssCompilerTransform({
32 serverFnProviderOnly: opts.serverFnProviderOnly,
33 getLoadCssExpression,
34 kind: 'renderServerComponent',
35 name: 'react-rsc-render-server-component-css',
36 }),
37 createRscCssCompilerTransform({
38 serverFnProviderOnly: opts.serverFnProviderOnly,
39 getLoadCssExpression,
40 kind: 'createCompositeComponent',
41 name: 'react-rsc-create-composite-component-css',
42 }),
43 createRscCssCompilerTransform({
44 serverFnProviderOnly: opts.serverFnProviderOnly,
45 getLoadCssExpression,
46 kind: 'renderToReadableStream',
47 name: 'react-rsc-render-to-readable-stream-css',
48 }),
49 ]
50}
51β
52function createRscCssCompilerTransform(opts: {
53 name: string
54 kind: RscCssTransformKind
55 getLoadCssExpression: (
56 context: StartCompilerTransformContext,
57 ) => NativeExpression
58 serverFnProviderOnly?: boolean | undefined
59}): StartCompilerImportTransform {
60 return {
61 name: opts.name,
62 environment: 'server',
63 imports: [
64 {
65 libName: '@tanstack/react-start/rsc',
66 rootExport: opts.kind,
67 },
68 {
69 libName: '@tanstack/react-start-rsc',
70 rootExport: opts.kind,
71 },
72 ],
73 detect: new RegExp(`\\b${opts.kind}\\b`),
74 transform: (candidates, context) => {
75 if (
76 opts.serverFnProviderOnly &&
77 !context.id.includes(TSS_SERVERFN_SPLIT_PARAM)
78 ) {
79 return
80 }
81β
82 const loadCssExpression = opts.getLoadCssExpression(context)
83 const cloneLoadCssExpression = () => cloneGeneratedNode(loadCssExpression)
84β
85 for (const candidate of candidates) {
86 const args = candidate.node.arguments
87 if (args.length !== 1) {
88 continue
89 }
90β
91 if (opts.kind === 'renderToReadableStream') {
92 const firstArg = args[0]
93 if (!firstArg || firstArg.type === 'SpreadElement') {
94 continue
95 }
96 if (!isTopLevelJsx(firstArg)) {
97 continue
98 }
99β
100 args[0] = createCssFragment(
101 context,
102 firstArg,
103 cloneLoadCssExpression(),
104 ) as typeof firstArg
105 continue
106 }
107β
108 const options = context.parseExpression(
109 `{ ${RSC_CSS_OPTIONS_KEY}: null }`,
110 )
111 if (
112 options.type === 'ObjectExpression' &&
113 options.properties[0]?.type === 'Property'
114 ) {
115 options.properties[0].value = cloneLoadCssExpression()
116 args.push(options)
117 }
118 }
119 },
120 }
121}
122β
123function isTopLevelJsx(expr: NativeExpression): boolean {
124 const unwrapped = unwrapTransparentExpression(expr)
125 return unwrapped.type === 'JSXElement' || unwrapped.type === 'JSXFragment'
126}
127β
128function unwrapTransparentExpression(expr: NativeExpression): NativeExpression {
129 let current = expr
130 while (
131 current.type === 'ParenthesizedExpression' ||
132 current.type === 'TSAsExpression' ||
133 current.type === 'TSSatisfiesExpression' ||
134 current.type === 'TSTypeAssertion' ||
135 current.type === 'TSNonNullExpression'
136 ) {
137 current = current.expression
138 }
139 return current
140}
141β
142function createCssFragment(
143 context: StartCompilerTransformContext,
144 original: NativeExpression,
145 loadCssExpression: NativeExpression,
146) {
147 const fragment = context.parseExpression('<>{null}{null}</>')
148 if (
149 fragment.type !== 'JSXFragment' ||
150 fragment.children[0]?.type !== 'JSXExpressionContainer' ||
151 fragment.children[1]?.type !== 'JSXExpressionContainer'
152 ) {
153 throw new Error('Expected compiler fragment')
154 }
155 fragment.children[0].expression = loadCssExpression
156 const unwrapped = unwrapTransparentExpression(original)
157 if (unwrapped.type === 'JSXElement' || unwrapped.type === 'JSXFragment') {
158 fragment.children[1] = unwrapped
159 } else {
160 fragment.children[1].expression = original
161 }
162 return fragment
163}