Is documentation of "Implement Plugin" is outdated?

[Phryxia]

Describe the bug

I came here from #3540 .

If you found bugs, or something is not working: Please create an issue at https://github.com/swc-project/swc/issues with reproducible repo

I was trying to make a rust based swc plugin with this tutorial, but I couldn't follow the instructions. I think something is missing or document is outdated.

1. Follow every instructions on tutorial page
2. run cargo test
3. See the error.

Input code

// lib.rs
use swc_plugin::{ast::*, plugin_transform, TransformPluginProgramMetadata};

pub struct TransformVisitor;

impl VisitMut for TransformVisitor {
    fn visit_mut_bin_expr(&mut self, e: &mut BinExpr) {
        e.visit_mut_children_with(self);

        if e.op == op!("===") {
            e.left = Ident::new("kdy1".into(), e.left.span()).into();
        }
    }
}

Config

No .swcrc was used.

Playground link

No response

Expected behavior

There is no specific description on the tutorial page. I think errors should not be happened.

Actual behavior

Following errors were generated.

   Compiling my-first-plugin v0.1.0 (/home/sekyukwon/dev/swc-plugin-next-link-prefetch)
error[E0433]: failed to resolve: could not find `utils` in `swc_plugin`
 --> src/lib.rs:2:17
  |
2 | use swc_plugin::utils::swc_common::Spanned;
  |                 ^^^^^ could not find `utils` in `swc_plugin`

error[E0432]: unresolved imports `swc_plugin::ast`, `swc_plugin::plugin_transform`, `swc_plugin::TransformPluginProgramMetadata`
 --> src/lib.rs:1:18
  |
1 | use swc_plugin::{ast::*, plugin_transform, TransformPluginProgramMetadata};
  |                  ^^^     ^^^^^^^^^^^^^^^^  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ no `TransformPluginProgramMetadata` in the root
  |                  |       |
  |                  |       no `plugin_transform` in the root
  |                  could not find `ast` in `swc_plugin`

error: cannot determine resolution for the attribute macro `plugin_transform`
  --> src/lib.rs:35:3
   |
35 | #[plugin_transform]
   |   ^^^^^^^^^^^^^^^^
   |
   = note: import resolution is stuck, try simplifying macro imports

error: cannot find macro `op` in this scope
  --> src/lib.rs:10:20
   |
10 |         if e.op == op!("===") {
   |   

(...etc)

Version

swc_cli: 0.89.0 (not @swc/cli)

Additional context

Run on WSL2 Ubuntu 20.04

Version

rustc: 1.62.1
rustup: 1.25.1
cargo 1.62.1

Reproducible Repository

https://github.com/Phryxia/swc-plugin-tutorial-seems-broken

[kwonoj]

Dupe #5412

[Phryxia]

@kwonoj

After fixing #5412 and update swc_cli, some of the errors were fixed, but still it doesn't work.
I think something in the documentation still out of dated. Is it on work in progress?

Edited code with least compile errors as I could

// lib.rs
use swc_core::{
    ast::*, // <--- should be changed after template generation
    common::Spanned, // <--- should be added. (In documentation, it uses swc_plugin)
    plugin::{plugin_transform, proxies::TransformPluginProgramMetadata},
    testing_transform::test,
    visit::{as_folder, FoldWith, VisitMut, VisitMutWith}, // <--- VisitMutWIth should be added 
};

impl VisitMut for TransformVisitor {
    fn visit_mut_bin_expr(&mut self, e: &mut BinExpr) {
        e.visit_mut_children_with(self);

        if e.op == op!("===") {
            e.left = Ident::new("kdy1".into(), e.left.span()).into();
        }
    }
}

Error

   Compiling swc-plugin-next-disable-prefetch v0.1.0 (/home/sekyukwon/study/rust/swc-plugin-next-disable-prefetch)
error[E0277]: the trait bound `Box<swc_core::ast::Expr>: From<swc_core::ast::Ident>` is not satisfied
  --> src/lib.rs:16:63
   |
16 |             e.left = Ident::new("kdy1".into(), e.left.span()).into();
   |                                                               ^^^^ the trait `From<swc_core::ast::Ident>` is not implemented for `Box<swc_core::ast::Expr>`
   |
   = help: the following other types implement trait `From<T>`:
             <Box<(dyn miette::protocol::Diagnostic + 'static)> as From<&str>>
             <Box<(dyn miette::protocol::Diagnostic + 'static)> as From<T>>
             <Box<(dyn miette::protocol::Diagnostic + 'static)> as From<miette::eyreish::Report>>
             <Box<(dyn miette::protocol::Diagnostic + 'static)> as From<std::string::String>>
             <Box<(dyn miette::protocol::Diagnostic + Send + 'static)> as From<T>>
             <Box<(dyn miette::protocol::Diagnostic + Send + Sync + 'a)> as From<&str>>
             <Box<(dyn miette::protocol::Diagnostic + Send + Sync + 'static)> as From<Box<(dyn std::error::Error + Send + Sync + 'static)>>>
             <Box<(dyn miette::protocol::Diagnostic + Send + Sync + 'static)> as From<T>>
           and 52 others
   = note: required because of the requirements on the impl of `Into<Box<swc_core::ast::Expr>>` for `swc_core::ast::Ident`

For more information about this error, try `rustc --explain E0277`.
error: could not compile `swc-plugin-next-disable-prefetch` due to previous error