move Rust's syntax::parser::Language API to root module (#453)

As it will contain APIs other than the parser in the future

.changeset/chilled-spies-reply.md

@@ -0,0 +1,5 @@
+---
+"changelog": minor
+---
+
+move Rust's `syntax::Parser::Language` API to root module

crates/solidity/outputs/cargo/build/build.rs

@@ -10,7 +10,7 @@ fn main() -> Result<()> {
 
         let output_dir = codegen
             .repo_root
-            .join("crates/solidity/outputs/cargo/crate/src/syntax/generated");
+            .join("crates/solidity/outputs/cargo/crate/src/generated");
 
         grammar.generate_rust_lib_sources(codegen, &output_dir);
         return Ok(());

crates/solidity/outputs/cargo/crate/src/lib.rs

@@ -1,4 +1,4 @@
-pub mod syntax;
+mod generated;
 
 mod _supress_binary_dependencies_ {
     // Below are dependencies used by the binary `main.rs`, but not here.
@@ -12,3 +12,26 @@ mod _supress_binary_dependencies_ {
     use solidity_cargo_build as _;
     use thiserror as _;
 }
+
+pub use public_api::*;
+
+mod public_api {
+    pub use crate::generated::language::Language;
+
+    pub mod syntax {
+        pub mod nodes {
+            pub use crate::generated::cst::Node;
+            pub use crate::generated::kinds::{RuleKind, TokenKind};
+        }
+
+        pub mod parser {
+            pub use crate::generated::language::{ParseOutput, ProductionKind};
+        }
+
+        pub mod visitors {
+            pub use crate::generated::cst_visitor::{
+                Visitable, Visitor, VisitorEntryResponse, VisitorExitResponse,
+            };
+        }
+    }
+}

crates/solidity/outputs/cargo/crate/src/main.rs

@@ -3,7 +3,7 @@ use std::{fs, path::PathBuf};
 use anyhow::Result;
 use clap::{Parser as ClapParser, Subcommand};
 use semver::Version;
-use slang_solidity::syntax::parser::{Language, ProductionKind};
+use slang_solidity::{syntax::parser::ProductionKind, Language};
 
 mod _supress_library_dependencies_ {
     // Below are dependencies used by the library `lib.rs`, but not here.

crates/solidity/outputs/cargo/tests/src/cst_output/runner.rs

@@ -3,7 +3,10 @@ use std::str::FromStr;
 use anyhow::Result;
 use codegen_utils::context::CodegenContext;
 use semver::Version;
-use slang_solidity::syntax::parser::{Language, ParseOutput, ProductionKind};
+use slang_solidity::{
+    syntax::parser::{ParseOutput, ProductionKind},
+    Language,
+};
 use solidity_testing_utils::cst_snapshots::ParseOutputTestSnapshotExtensions;
 
 use crate::cst_output::generated::VERSION_BREAKS;

crates/solidity/outputs/npm/build/build.rs

@@ -10,7 +10,7 @@ fn main() -> Result<()> {
 
         let output_dir = codegen
             .repo_root
-            .join("crates/solidity/outputs/npm/crate/src/syntax/generated");
+            .join("crates/solidity/outputs/npm/crate/src/generated");
 
         grammar.generate_typescript_lib_sources(codegen, &output_dir);
 

crates/solidity/outputs/npm/crate/src/lib.rs

@@ -4,4 +4,4 @@ extern crate napi_derive;
 #[cfg(test)]
 use solidity_npm_build as _;
 
-pub mod syntax;
+pub mod generated;

crates/solidity/testing/smoke/src/main.rs

@@ -7,7 +7,7 @@ use anyhow::Result;
 use codegen_schema::types::grammar::Grammar;
 use rayon::prelude::{IntoParallelRefIterator, ParallelIterator};
 use semver::Version;
-use slang_solidity::syntax::parser::{Language, ProductionKind};
+use slang_solidity::{syntax::parser::ProductionKind, Language};
 use solidity_schema::SolidityGrammarExtensions;
 use solidity_testing_utils::version_pragmas::extract_version_pragmas;
 

crates/solidity/testing/utils/src/node_extensions/tests.rs

@@ -1,6 +1,6 @@
 use anyhow::{Context, Result};
 use semver::Version;
-use slang_solidity::syntax::parser::{Language, ProductionKind};
+use slang_solidity::{syntax::parser::ProductionKind, Language};
 
 use crate::node_extensions::NodeExtensions;
 

crates/solidity/testing/utils/src/version_pragmas/mod.rs

@@ -5,10 +5,13 @@ use std::{ops::Range, rc::Rc, str::FromStr};
 
 use anyhow::{bail, Context, Error, Result};
 use semver::{Comparator, Op, Version};
-use slang_solidity::syntax::{
-    nodes::{Node, RuleKind},
-    parser::{Language, ProductionKind},
-    visitors::{Visitable, Visitor, VisitorEntryResponse},
+use slang_solidity::{
+    syntax::{
+        nodes::{Node, RuleKind},
+        parser::ProductionKind,
+        visitors::{Visitable, Visitor, VisitorEntryResponse},
+    },
+    Language,
 };
 
 use crate::node_extensions::NodeExtensions;