// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license. use crate::swc_ecma_ast; use serde::Serialize; use super::params::ts_fn_param_to_param_def; use super::parser::DocParser; use super::ts_type::ts_entity_name_to_name; use super::ts_type::ts_type_ann_to_def; use super::ts_type::TsTypeDef; use super::ts_type_param::maybe_type_param_decl_to_type_param_defs; use super::ts_type_param::TsTypeParamDef; use super::Location; use super::ParamDef; #[derive(Debug, Serialize, Clone)] #[serde(rename_all = "camelCase")] pub struct InterfaceMethodDef { pub name: String, pub location: Location, pub js_doc: Option, pub optional: bool, pub params: Vec, pub return_type: Option, pub type_params: Vec, } #[derive(Debug, Serialize, Clone)] #[serde(rename_all = "camelCase")] pub struct InterfacePropertyDef { pub name: String, pub location: Location, pub js_doc: Option, pub params: Vec, pub computed: bool, pub optional: bool, pub ts_type: Option, pub type_params: Vec, } #[derive(Debug, Serialize, Clone)] #[serde(rename_all = "camelCase")] pub struct InterfaceCallSignatureDef { pub location: Location, pub js_doc: Option, pub params: Vec, pub ts_type: Option, pub type_params: Vec, } #[derive(Debug, Serialize, Clone)] #[serde(rename_all = "camelCase")] pub struct InterfaceDef { pub extends: Vec, pub methods: Vec, pub properties: Vec, pub call_signatures: Vec, pub type_params: Vec, } pub fn expr_to_name(expr: &swc_ecma_ast::Expr) -> String { use crate::swc_ecma_ast::Expr::*; use crate::swc_ecma_ast::ExprOrSuper::*; match expr { Ident(ident) => ident.sym.to_string(), Member(member_expr) => { let left = match &member_expr.obj { Super(_) => "super".to_string(), Expr(boxed_expr) => expr_to_name(&*boxed_expr), }; let right = expr_to_name(&*member_expr.prop); format!("[{}.{}]", left, right) } _ => "".to_string(), } } pub fn get_doc_for_ts_interface_decl( doc_parser: &DocParser, interface_decl: &swc_ecma_ast::TsInterfaceDecl, ) -> (String, InterfaceDef) { let interface_name = interface_decl.id.sym.to_string(); let mut methods = vec![]; let mut properties = vec![]; let mut call_signatures = vec![]; for type_element in &interface_decl.body.body { use crate::swc_ecma_ast::TsTypeElement::*; match &type_element { TsMethodSignature(ts_method_sig) => { let method_js_doc = doc_parser.js_doc_for_span(ts_method_sig.span); let mut params = vec![]; for param in &ts_method_sig.params { let param_def = ts_fn_param_to_param_def(param); params.push(param_def); } let name = expr_to_name(&*ts_method_sig.key); let maybe_return_type = ts_method_sig .type_ann .as_ref() .map(|rt| ts_type_ann_to_def(rt)); let type_params = maybe_type_param_decl_to_type_param_defs( ts_method_sig.type_params.as_ref(), ); let method_def = InterfaceMethodDef { name, js_doc: method_js_doc, location: doc_parser .ast_parser .get_span_location(ts_method_sig.span) .into(), optional: ts_method_sig.optional, params, return_type: maybe_return_type, type_params, }; methods.push(method_def); } TsPropertySignature(ts_prop_sig) => { let prop_js_doc = doc_parser.js_doc_for_span(ts_prop_sig.span); let name = expr_to_name(&*ts_prop_sig.key); let mut params = vec![]; for param in &ts_prop_sig.params { let param_def = ts_fn_param_to_param_def(param); params.push(param_def); } let ts_type = ts_prop_sig .type_ann .as_ref() .map(|rt| ts_type_ann_to_def(rt)); let type_params = maybe_type_param_decl_to_type_param_defs( ts_prop_sig.type_params.as_ref(), ); let prop_def = InterfacePropertyDef { name, js_doc: prop_js_doc, location: doc_parser .ast_parser .get_span_location(ts_prop_sig.span) .into(), params, ts_type, computed: ts_prop_sig.computed, optional: ts_prop_sig.optional, type_params, }; properties.push(prop_def); } TsCallSignatureDecl(ts_call_sig) => { let call_sig_js_doc = doc_parser.js_doc_for_span(ts_call_sig.span); let mut params = vec![]; for param in &ts_call_sig.params { let param_def = ts_fn_param_to_param_def(param); params.push(param_def); } let ts_type = ts_call_sig .type_ann .as_ref() .map(|rt| ts_type_ann_to_def(rt)); let type_params = maybe_type_param_decl_to_type_param_defs( ts_call_sig.type_params.as_ref(), ); let call_sig_def = InterfaceCallSignatureDef { js_doc: call_sig_js_doc, location: doc_parser .ast_parser .get_span_location(ts_call_sig.span) .into(), params, ts_type, type_params, }; call_signatures.push(call_sig_def); } // TODO: TsConstructSignatureDecl(_) => {} TsIndexSignature(_) => {} } } let type_params = maybe_type_param_decl_to_type_param_defs( interface_decl.type_params.as_ref(), ); let extends: Vec = interface_decl .extends .iter() .map(|expr| ts_entity_name_to_name(&expr.expr)) .collect(); let interface_def = InterfaceDef { extends, methods, properties, call_signatures, type_params, }; (interface_name, interface_def) }