Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Implement SWC transformer for server and client graphs (#40603)
This is an initial implementation of the Server Components SWC transformer. For the server graph, it detects client entries via the `"client"` directive and transpile them into module reference code; for the client graph, it removes the directives. And for both graphs, it checks if there is any invalid imports for the given environment and shows proper errors. With that added, we can switch from `next-flight-client-loader` to directly use the SWC loader in one pass. Next step is to get rid of the `.client.` extension in other plugins. ## Bug - [ ] Related issues linked using `fixes #number` - [ ] Integration tests added - [ ] Errors have helpful link attached, see `contributing.md` ## Feature - [x] Implements an existing feature request or RFC. Make sure the feature request has been accepted for implementation before opening a PR. - [ ] Related issues linked using `fixes #number` - [x] Integration tests added - [ ] Documentation added - [ ] Telemetry added. In case of a feature if it's used or not. - [ ] Errors have helpful link attached, see `contributing.md` ## Documentation / Examples - [ ] Make sure the linting passes by running `pnpm lint` - [ ] The examples guidelines are followed from [our contributing doc](https://github.com/vercel/next.js/blob/canary/contributing.md#adding-examples)
- Loading branch information
Showing
89 changed files
with
924 additions
and
33 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
341 changes: 341 additions & 0 deletions
341
packages/next-swc/crates/core/src/react_server_components.rs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,341 @@ | ||
use serde::Deserialize; | ||
|
||
use swc_core::{ | ||
common::{ | ||
comments::{Comment, CommentKind, Comments}, | ||
errors::HANDLER, | ||
FileName, Span, DUMMY_SP, | ||
}, | ||
ecma::ast::*, | ||
ecma::atoms::{js_word, JsWord}, | ||
ecma::utils::{prepend_stmts, quote_ident, quote_str, ExprFactory}, | ||
ecma::visit::{as_folder, noop_visit_mut_type, Fold, VisitMut, VisitMutWith}, | ||
}; | ||
|
||
#[derive(Clone, Debug, Deserialize)] | ||
#[serde(untagged)] | ||
pub enum Config { | ||
All(bool), | ||
WithOptions(Options), | ||
} | ||
|
||
impl Config { | ||
pub fn truthy(&self) -> bool { | ||
match self { | ||
Config::All(b) => *b, | ||
Config::WithOptions(_) => true, | ||
} | ||
} | ||
} | ||
|
||
#[derive(Clone, Debug, Deserialize)] | ||
#[serde(rename_all = "camelCase")] | ||
pub struct Options { | ||
pub is_server: bool, | ||
} | ||
|
||
struct ReactServerComponents<C: Comments> { | ||
is_server: bool, | ||
filepath: String, | ||
comments: C, | ||
invalid_server_imports: Vec<JsWord>, | ||
invalid_client_imports: Vec<JsWord>, | ||
invalid_server_react_apis: Vec<JsWord>, | ||
invalid_server_react_dom_apis: Vec<JsWord>, | ||
} | ||
|
||
struct ModuleImports { | ||
source: (JsWord, Span), | ||
specifiers: Vec<(JsWord, Span)>, | ||
} | ||
|
||
impl<C: Comments> VisitMut for ReactServerComponents<C> { | ||
noop_visit_mut_type!(); | ||
|
||
fn visit_mut_module(&mut self, module: &mut Module) { | ||
let (is_client_entry, imports) = self.collect_top_level_directives_and_imports(module); | ||
|
||
if self.is_server { | ||
if !is_client_entry { | ||
self.assert_server_graph(&imports); | ||
} else { | ||
self.to_module_ref(module); | ||
return; | ||
} | ||
} else { | ||
self.assert_client_graph(&imports); | ||
} | ||
module.visit_mut_children_with(self) | ||
} | ||
} | ||
|
||
impl<C: Comments> ReactServerComponents<C> { | ||
// Collects top level directives and imports, then removes specific ones | ||
// from the AST. | ||
fn collect_top_level_directives_and_imports( | ||
&self, | ||
module: &mut Module, | ||
) -> (bool, Vec<ModuleImports>) { | ||
let mut imports: Vec<ModuleImports> = vec![]; | ||
let mut finished_directives = false; | ||
let mut is_client_entry = false; | ||
|
||
let _ = &module.body.retain(|item| { | ||
match item { | ||
ModuleItem::Stmt(stmt) => { | ||
if !finished_directives { | ||
if !stmt.is_expr() { | ||
// Not an expression. | ||
finished_directives = true; | ||
} | ||
|
||
match stmt.as_expr() { | ||
Some(expr_stmt) => { | ||
match &*expr_stmt.expr { | ||
Expr::Lit(Lit::Str(Str { value, .. })) => { | ||
if &**value == "client" { | ||
is_client_entry = true; | ||
|
||
// Remove the directive. | ||
return false; | ||
} | ||
} | ||
_ => { | ||
// Other expression types. | ||
finished_directives = true; | ||
} | ||
} | ||
} | ||
None => { | ||
// Not an expression. | ||
finished_directives = true; | ||
} | ||
} | ||
} | ||
} | ||
ModuleItem::ModuleDecl(ModuleDecl::Import(import)) => { | ||
let source = import.src.value.clone(); | ||
let specifiers = import | ||
.specifiers | ||
.iter() | ||
.map(|specifier| match specifier { | ||
ImportSpecifier::Named(named) => match &named.imported { | ||
Some(imported) => match &imported { | ||
ModuleExportName::Ident(i) => (i.to_id().0, i.span), | ||
ModuleExportName::Str(s) => (s.value.clone(), s.span), | ||
}, | ||
None => (named.local.to_id().0, named.local.span), | ||
}, | ||
ImportSpecifier::Default(d) => (js_word!(""), d.span), | ||
ImportSpecifier::Namespace(n) => ("*".into(), n.span), | ||
}) | ||
.collect(); | ||
|
||
imports.push(ModuleImports { | ||
source: (source, import.span), | ||
specifiers, | ||
}); | ||
|
||
finished_directives = true; | ||
} | ||
_ => { | ||
finished_directives = true; | ||
} | ||
} | ||
true | ||
}); | ||
|
||
(is_client_entry, imports) | ||
} | ||
|
||
// Convert the client module to the module reference code and add a special | ||
// comment to the top of the file. | ||
fn to_module_ref(&self, module: &mut Module) { | ||
// Clear all the statements and module declarations. | ||
module.body.clear(); | ||
|
||
let proxy_ident = quote_ident!("createProxy"); | ||
let filepath = quote_str!(&*self.filepath); | ||
|
||
prepend_stmts( | ||
&mut module.body, | ||
vec![ | ||
ModuleItem::Stmt(Stmt::Decl(Decl::Var(VarDecl { | ||
span: DUMMY_SP, | ||
kind: VarDeclKind::Const, | ||
decls: vec![VarDeclarator { | ||
span: DUMMY_SP, | ||
name: Pat::Object(ObjectPat { | ||
span: DUMMY_SP, | ||
props: vec![ObjectPatProp::Assign(AssignPatProp { | ||
span: DUMMY_SP, | ||
key: proxy_ident, | ||
value: None, | ||
})], | ||
optional: false, | ||
type_ann: None, | ||
}), | ||
init: Some(Box::new(Expr::Call(CallExpr { | ||
span: DUMMY_SP, | ||
callee: quote_ident!("require").as_callee(), | ||
args: vec![quote_str!("private-next-rsc-mod-ref-proxy").as_arg()], | ||
type_args: Default::default(), | ||
}))), | ||
definite: false, | ||
}], | ||
declare: false, | ||
}))), | ||
ModuleItem::Stmt(Stmt::Expr(ExprStmt { | ||
span: DUMMY_SP, | ||
expr: Box::new(Expr::Assign(AssignExpr { | ||
span: DUMMY_SP, | ||
left: PatOrExpr::Expr(Box::new(Expr::Member(MemberExpr { | ||
span: DUMMY_SP, | ||
obj: Box::new(Expr::Ident(quote_ident!("module"))), | ||
prop: MemberProp::Ident(quote_ident!("exports")), | ||
}))), | ||
op: op!("="), | ||
right: Box::new(Expr::Call(CallExpr { | ||
span: DUMMY_SP, | ||
callee: quote_ident!("createProxy").as_callee(), | ||
args: vec![filepath.as_arg()], | ||
type_args: Default::default(), | ||
})), | ||
})), | ||
})), | ||
] | ||
.into_iter(), | ||
); | ||
|
||
// Prepend a special comment to the top of the file. | ||
self.comments.add_leading( | ||
module.span.lo, | ||
Comment { | ||
span: DUMMY_SP, | ||
kind: CommentKind::Block, | ||
text: " __next_internal_client_entry_do_not_use__ ".into(), | ||
}, | ||
); | ||
} | ||
|
||
fn assert_server_graph(&self, imports: &Vec<ModuleImports>) { | ||
for import in imports { | ||
let source = import.source.0.clone(); | ||
if self.invalid_server_imports.contains(&source) { | ||
HANDLER.with(|handler| { | ||
handler | ||
.struct_span_err( | ||
import.source.1, | ||
format!( | ||
"Disallowed import of `{}` in the Server Components compilation.", | ||
source | ||
) | ||
.as_str(), | ||
) | ||
.emit() | ||
}) | ||
} | ||
if source == *"react" { | ||
for specifier in &import.specifiers { | ||
if self.invalid_server_react_apis.contains(&specifier.0) { | ||
HANDLER.with(|handler| { | ||
handler | ||
.struct_span_err( | ||
specifier.1, | ||
format!( | ||
"Disallowed React API `{}` in the Server Components \ | ||
compilation.", | ||
&specifier.0 | ||
) | ||
.as_str(), | ||
) | ||
.emit() | ||
}) | ||
} | ||
} | ||
} | ||
if source == *"react-dom" { | ||
for specifier in &import.specifiers { | ||
if self.invalid_server_react_dom_apis.contains(&specifier.0) { | ||
HANDLER.with(|handler| { | ||
handler | ||
.struct_span_err( | ||
specifier.1, | ||
format!( | ||
"Disallowed ReactDOM API `{}` in the Server Components \ | ||
compilation.", | ||
&specifier.0 | ||
) | ||
.as_str(), | ||
) | ||
.emit() | ||
}) | ||
} | ||
} | ||
} | ||
} | ||
} | ||
|
||
fn assert_client_graph(&self, imports: &Vec<ModuleImports>) { | ||
for import in imports { | ||
let source = import.source.0.clone(); | ||
if self.invalid_client_imports.contains(&source) { | ||
HANDLER.with(|handler| { | ||
handler | ||
.struct_span_err( | ||
import.source.1, | ||
format!( | ||
"Disallowed import of `{}` in the Client Components compilation.", | ||
source | ||
) | ||
.as_str(), | ||
) | ||
.emit() | ||
}) | ||
} | ||
} | ||
} | ||
} | ||
|
||
pub fn server_components<C: Comments>( | ||
filename: FileName, | ||
config: Config, | ||
comments: C, | ||
) -> impl Fold + VisitMut { | ||
let is_server: bool = match config { | ||
Config::WithOptions(x) => x.is_server, | ||
_ => true, | ||
}; | ||
as_folder(ReactServerComponents { | ||
is_server, | ||
comments, | ||
filepath: filename.to_string(), | ||
invalid_server_imports: vec![ | ||
JsWord::from("client-only"), | ||
JsWord::from("react-dom/client"), | ||
JsWord::from("react-dom/server"), | ||
], | ||
invalid_client_imports: vec![JsWord::from("server-only")], | ||
invalid_server_react_dom_apis: vec![ | ||
JsWord::from("findDOMNode"), | ||
JsWord::from("flushSync"), | ||
JsWord::from("unstable_batchedUpdates"), | ||
], | ||
invalid_server_react_apis: vec![ | ||
JsWord::from("Component"), | ||
JsWord::from("createContext"), | ||
JsWord::from("createFactory"), | ||
JsWord::from("PureComponent"), | ||
JsWord::from("useDeferredValue"), | ||
JsWord::from("useEffect"), | ||
JsWord::from("useImperativeHandle"), | ||
JsWord::from("useInsertionEffect"), | ||
JsWord::from("useLayoutEffect"), | ||
JsWord::from("useReducer"), | ||
JsWord::from("useRef"), | ||
JsWord::from("useState"), | ||
JsWord::from("useSyncExternalStore"), | ||
JsWord::from("useTransition"), | ||
], | ||
}) | ||
} |
Oops, something went wrong.