Skip to content
Source
Sign inSign up
TanStack/router
Open History to see the last commit

rscCssTransform.ts

150 lines4.2 KB

1import type {
2 StartCompilerImportTransform,
3 StartCompilerTransformContext,
4} from '@tanstack/start-plugin-core'
5​
6const TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split'
7const RSC_CSS_OPTIONS_KEY = '__tanstackStartRscCss'
8​
9type BabelTypes = StartCompilerTransformContext['types']
10type BabelExpression = ReturnType<
11 StartCompilerTransformContext['parseExpression']
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: BabelExpression | 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 ]
51​
52function createRscCssCompilerTransform(opts: {
53 name: string
54 kind: RscCssTransformKind
55 getLoadCssExpression: (
56 context: StartCompilerTransformContext,
57 ) => BabelExpression
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 t = context.types
83 const loadCssExpression = opts.getLoadCssExpression(context)
84 const cloneLoadCssExpression = () => t.cloneNode(loadCssExpression)
85​
86 for (const candidate of candidates) {
87 const args = candidate.path.node.arguments
88 if (args.length !== 1) continue
89​
90 if (opts.kind === 'renderToReadableStream') {
91 const firstArg = args[0]
92 if (!firstArg || !t.isExpression(firstArg)) continue
93 if (!isTopLevelJsx(t, firstArg)) continue
94​
95 args[0] = createCssFragment(
96 t,
97 firstArg,
98 cloneLoadCssExpression(),
99 ) as typeof firstArg
100 continue
101 }
102​
103 args.push(
104 t.objectExpression([
105 t.objectProperty(
106 t.identifier(RSC_CSS_OPTIONS_KEY),
107 cloneLoadCssExpression(),
108 ),
109 ]),
110 )
111 }
112 },
113 }
115​
116function isTopLevelJsx(t: BabelTypes, expr: BabelExpression): boolean {
117 const unwrapped = unwrapTransparentExpression(t, expr)
118 return t.isJSXElement(unwrapped) || t.isJSXFragment(unwrapped)
120​
121function unwrapTransparentExpression(
122 t: BabelTypes,
123 expr: BabelExpression,
124): BabelExpression {
125 let current = expr
126 while (
127 t.isParenthesizedExpression(current) ||
128 t.isTSAsExpression(current) ||
129 t.isTSSatisfiesExpression(current) ||
130 t.isTSTypeAssertion(current) ||
131 t.isTSNonNullExpression(current)
132 ) {
133 current = current.expression
134 }
135 return current
137​
138function createCssFragment(
139 t: BabelTypes,
140 original: BabelExpression,
141 loadCssExpression: BabelExpression,
142) {
143 const unwrapped = unwrapTransparentExpression(t, original)
144 return t.jsxFragment(t.jsxOpeningFragment(), t.jsxClosingFragment(), [
145 t.jsxExpressionContainer(loadCssExpression),
146 t.isJSXElement(unwrapped) || t.isJSXFragment(unwrapped)
147 ? unwrapped
148 : t.jsxExpressionContainer(original),
149 ])