feat(quote): implement jsquote! and jsquote_expr!

ref oxc-project/backlog#151

This commit introduces the `jsquote!` and `jsquote_expr!`
procedural macros, which utilize the auto-derivation
system to build a proto-AST when using them in order to
produce in-situ Rust invocations.

Inspired heavily by the infamous `quote` crate.

Author: Qix-

.github/generated/ast_changes_watch_list.yml

@@ -19,6 +19,7 @@ src:
   - 'crates/oxc_ast/src/generated/derive_get_span.rs'
   - 'crates/oxc_ast/src/generated/derive_get_span_mut.rs'
   - 'crates/oxc_ast/src/generated/derive_take_in.rs'
+  - 'crates/oxc_ast/src/generated/derive_to_rust.rs'
   - 'crates/oxc_ast/src/generated/get_id.rs'
   - 'crates/oxc_ast/src/serialize.rs'
   - 'crates/oxc_ast_macros/src/generated/mod.rs'
@@ -32,16 +33,19 @@ src:
   - 'crates/oxc_regular_expression/src/generated/derive_content_eq.rs'
   - 'crates/oxc_regular_expression/src/generated/derive_estree.rs'
   - 'crates/oxc_regular_expression/src/generated/derive_get_address.rs'
+  - 'crates/oxc_regular_expression/src/generated/derive_to_rust.rs'
   - 'crates/oxc_span/src/generated/assert_layouts.rs'
   - 'crates/oxc_span/src/generated/derive_dummy.rs'
   - 'crates/oxc_span/src/generated/derive_estree.rs'
+  - 'crates/oxc_span/src/generated/derive_to_rust.rs'
   - 'crates/oxc_span/src/source_type/mod.rs'
   - 'crates/oxc_span/src/span.rs'
   - 'crates/oxc_syntax/src/generated/assert_layouts.rs'
   - 'crates/oxc_syntax/src/generated/derive_clone_in.rs'
   - 'crates/oxc_syntax/src/generated/derive_content_eq.rs'
   - 'crates/oxc_syntax/src/generated/derive_dummy.rs'
   - 'crates/oxc_syntax/src/generated/derive_estree.rs'
+  - 'crates/oxc_syntax/src/generated/derive_to_rust.rs'
   - 'crates/oxc_syntax/src/lib.rs'
   - 'crates/oxc_syntax/src/module_record.rs'
   - 'crates/oxc_syntax/src/number.rs'

Cargo.lock

@@ -22,7 +22,7 @@ rust-version = "1.85.0"
 absolute_paths_not_starting_with_crate = "warn"
 non_ascii_idents = "warn"
 unit-bindings = "warn"
-unexpected_cfgs = { level = "warn", check-cfg = ['cfg(coverage)', 'cfg(coverage_nightly)'] }
+unexpected_cfgs = { level = "warn", check-cfg = ['cfg(coverage)', 'cfg(coverage_nightly)', 'cfg(oxc_quote_is_nightly)'] }
 tail_expr_drop_order = "warn"
 unsafe_op_in_unsafe_fn = "warn"
 unused_unsafe = "warn"
@@ -120,6 +120,9 @@ oxc_minifier = { version = "0.61.2", path = "crates/oxc_minifier" }
 oxc_napi = { version = "0.61.2", path = "crates/oxc_napi" }
 oxc_parser = { version = "0.61.2", path = "crates/oxc_parser", features = ["regular_expression"] }
 oxc_parser_napi = { version = "0.61.2", path = "napi/parser" }
+oxc_quote = { version = "0.61.2", path = "crates/oxc_quote" }
+oxc_quote_proc = { version = "0.61.2", path = "crates/oxc_quote_proc" }
+oxc_quote_types = { version = "0.61.2", path = "crates/oxc_quote_types" }
 oxc_regular_expression = { version = "0.61.2", path = "crates/oxc_regular_expression" }
 oxc_semantic = { version = "0.61.2", path = "crates/oxc_semantic" }
 oxc_span = { version = "0.61.2", path = "crates/oxc_span" }
@@ -208,6 +211,7 @@ project-root = "0.2.2"
 rayon = "1.10.0"
 ropey = "1.6.1"
 rust-lapper = "1.1.0"
+rustc_version = "0.4.1"
 ryu-js = "1.0.1"
 saphyr = "0.0.3"
 schemars = "0.8.21"

Cargo.toml

@@ -26,6 +26,7 @@ oxc_estree = { workspace = true }
 oxc_regular_expression = { workspace = true }
 oxc_span = { workspace = true }
 oxc_syntax = { workspace = true }
+oxc_quote_types = { workspace = true }
 
 bitflags = { workspace = true }
 cow-utils = { workspace = true }
@@ -38,4 +39,5 @@ serialize = [
   "oxc_span/serialize",
   "oxc_syntax/serialize",
   "oxc_estree/serialize",
+  "oxc_quote_types/serialize",
 ]

crates/oxc_ast/Cargo.toml

@@ -2,11 +2,12 @@
 use oxc_allocator::CloneIn;
 use oxc_ast_macros::ast;
 use oxc_estree::ESTree;
+use oxc_quote_types::ToRust;
 use oxc_span::{ContentEq, Span};
 
 /// Indicates a line or block comment.
 #[ast]
-#[generate_derive(CloneIn, ContentEq, ESTree)]
+#[generate_derive(CloneIn, ContentEq, ESTree, ToRust)]
 #[derive(Debug, Default, Clone, Copy, Eq, PartialEq)]
 #[estree(no_rename_variants, no_ts_def)]
 pub enum CommentKind {
@@ -19,7 +20,7 @@ pub enum CommentKind {
 
 /// Information about a comment's position relative to a token.
 #[ast]
-#[generate_derive(CloneIn, ContentEq)]
+#[generate_derive(CloneIn, ContentEq, ToRust)]
 #[derive(Debug, Default, Clone, Copy, Eq, PartialEq)]
 pub enum CommentPosition {
     /// Comments prior to a token until another token or trailing comment.
@@ -42,7 +43,7 @@ pub enum CommentPosition {
 
 /// Annotation comment that has special meaning.
 #[ast]
-#[generate_derive(CloneIn, ContentEq)]
+#[generate_derive(CloneIn, ContentEq, ToRust)]
 #[derive(Debug, Default, Clone, Copy, Eq, PartialEq)]
 pub enum CommentAnnotation {
     /// No Annotation
@@ -79,7 +80,7 @@ pub enum CommentAnnotation {
 
 /// A comment in source code.
 #[ast]
-#[generate_derive(CloneIn, ContentEq, ESTree)]
+#[generate_derive(CloneIn, ContentEq, ESTree, ToRust)]
 #[derive(Debug, Default, Clone, Copy, Eq, PartialEq)]
 #[estree(add_fields(value = CommentValue), field_order(kind, value, span), no_ts_def)]
 pub struct Comment {