feat: Add "deno doc" subcommand (#4500)

1 files changed, 77 insertions, 0 deletions

diff --git a/cli/doc/node.rs b/cli/doc/node.rs
new file mode 100644
index 000000000..da4b81c11
--- /dev/null
+++ b/cli/doc/node.rs
@@ -0,0 +1,77 @@
+// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
+use serde::Serialize;
+use swc_common;
+
+#[derive(Debug, PartialEq, Serialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub enum DocNodeKind {
+  Function,
+  Variable,
+  Class,
+  Enum,
+  Interface,
+  TypeAlias,
+  Namespace,
+}
+
+#[derive(Debug, Serialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub struct ParamDef {
+  pub name: String,
+  pub ts_type: Option<super::ts_type::TsTypeDef>,
+}
+
+#[derive(Debug, Serialize, Clone)]
+pub struct Location {
+  pub filename: String,
+  pub line: usize,
+  pub col: usize,
+}
+
+impl Into<Location> for swc_common::Loc {
+  fn into(self) -> Location {
+    use swc_common::FileName::*;
+
+    let filename = match &self.file.name {
+      Real(path_buf) => path_buf.to_string_lossy().to_string(),
+      Custom(str_) => str_.to_string(),
+      _ => panic!("invalid filename"),
+    };
+
+    Location {
+      filename,
+      line: self.line,
+      col: self.col_display,
+    }
+  }
+}
+
+#[derive(Debug, Serialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub struct DocNode {
+  pub kind: DocNodeKind,
+  pub name: String,
+  pub location: Location,
+  pub js_doc: Option<String>,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub function_def: Option<super::function::FunctionDef>,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub variable_def: Option<super::variable::VariableDef>,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub enum_def: Option<super::r#enum::EnumDef>,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub class_def: Option<super::class::ClassDef>,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub type_alias_def: Option<super::type_alias::TypeAliasDef>,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub namespace_def: Option<super::namespace::NamespaceDef>,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub interface_def: Option<super::interface::InterfaceDef>,
+}